tigris-snapshots-forking

import { listBucketSnapshots } from "@tigrisdata/storage";
 
// List snapshots for default bucket
const result = await listBucketSnapshots();
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Snapshots:", result.data);
  // [
  //   {
  //     name: "backup-before-migration",
  //     version: "1751631910169675092",
  //     creationDate: Date("2025-01-15T08:30:00Z")
  //   }
  // ]
}
 
// List snapshots for specific bucket
const result = await listBucketSnapshots("my-bucket");

import { createBucket, createBucketSnapshot } from "@tigrisdata/storage";
 
// First, create a snapshot
const snapshot = await createBucketSnapshot("agent-seed", {
  name: "agent-seed-v1",
});
const snapshotVersion = snapshot.data?.snapshotVersion;
 
// Fork from snapshot
const agentBucketName = `agent-${Date.now()}`;
const forkResult = await createBucket(agentBucketName, {
  sourceBucketName: "agent-seed",
  sourceBucketSnapshot: snapshotVersion,
});
 
if (forkResult.error) {
  console.error("Error:", forkResult.error);
} else {
  console.log("Forked bucket created");
  // agent-${timestamp} has all data from agent-seed at snapshot time
  // Can modify/delete freely - agent-seed is unaffected
}

import { get, list } from "@tigrisdata/storage";
 
// Get object as it was at snapshot
const result = await get("config.json", "string", {
  snapshotVersion: "1751631910169675092",
});
 
// List objects as they were at snapshot
const result = await list({
  snapshotVersion: "1751631910169675092",
});

import { remove, get } from "@tigrisdata/storage";
 
// In forked bucket, delete everything
await remove("hello.txt", { config: { bucket: "agent-fork" } });
 
// Fork appears empty
const forkResult = await get("hello.txt", "string", {
  config: { bucket: "agent-fork" },
});
// forkResult.error === "Not found"
 
// But source bucket still has data
const sourceResult = await get("hello.txt", "string", {
  config: { bucket: "agent-seed" },
});
// sourceResult.data === "Hello, world!"

// Create snapshot of production data
await createBucketSnapshot("production", {
  name: "dev-sandbox-seed",
});
 
// Fork for each developer
const devBucket = await createBucket(`dev-${developerName}`, {
  sourceBucketName: "production",
  sourceBucketSnapshot: "...",
});
// Developer can test and modify freely

// Store agent dependencies in seed bucket
await put("model.bin", modelData);
await put("config.json", agentConfig);
 
// Snapshot the seed
const snapshot = await createBucketSnapshot("agent-seed", {
  name: "v1",
});
 
// Spin up new agent instance with fork
const agentBucket = `agent-${Date.now()}`;
await createBucket(agentBucket, {
  sourceBucketName: "agent-seed",
  sourceBucketSnapshot: snapshot.data?.snapshotVersion,
});
 
// Agent has everything and can modify freely
await startAgent(agentBucket);

// Before risky operation
await createBucketSnapshot("production", {
  name: "before-migration-v2",
});
 
// Run migration
// If disaster strikes, fork from snapshot to recover
const rollback = await createBucket("production-restored", {
  sourceBucketName: "production",
  sourceBucketSnapshot: "...",
});