@thingd/cli 0.33.2 → 0.35.0

package/dist/data-movement.d.ts

@@ -2,4 +2,5 @@ import { type CliContext } from "./index.js";
 export declare function runExport(context: CliContext): Promise<void>;
 export declare function runImport(context: CliContext): Promise<void>;
 export declare function runSnapshot(context: CliContext): Promise<void>;
+export declare function runBackup(context: CliContext): Promise<void>;
 //# sourceMappingURL=data-movement.d.ts.map

package/dist/data-movement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-movement.d.ts","sourceRoot":"","sources":["../src/data-movement.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,UAAU,EAAwD,MAAM,YAAY,CAAC;AA+DnG,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAyClE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuElE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGpE"}
+{"version":3,"file":"data-movement.d.ts","sourceRoot":"","sources":["../src/data-movement.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,UAAU,EAAwD,MAAM,YAAY,CAAC;AA+DnG,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAyClE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuElE;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiHpE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlE"}

package/dist/data-movement.js

@@ -201,57 +201,81 @@ export async function runSnapshot(context) {
         if (snapshot.version !== "1.0.0") {
             throw new Error(`Unsupported snapshot version: ${snapshot.version}`);
         }
+        console.error("Restoring snapshot... (consider 'thingd backup --out pre-restore.db' first)");
         await withDb(context, async (db) => {
-            // 1. Restore Collections (clear existing first for true restore)
-            if (snapshot.collections) {
-                for (const [colName, objects] of Object.entries(snapshot.collections)) {
-                    const currentObjs = await db.listObjects(colName);
-                    for (const obj of currentObjs) {
-                        await db.delete(colName, obj.id);
+            try {
+                // 1. Restore Collections (clear existing first for true restore)
+                if (snapshot.collections) {
+                    for (const [colName, objects] of Object.entries(snapshot.collections)) {
+                        const currentObjs = await db.listObjects(colName);
+                        for (const obj of currentObjs) {
+                            await db.delete(colName, obj.id);
+                        }
+                        for (const obj of objects) {
+                            const cleanObj = { ...obj };
+                            delete cleanObj.collection;
+                            delete cleanObj.createdAt;
+                            delete cleanObj.updatedAt;
+                            delete cleanObj.version;
+                            await db.put(colName, cleanObj);
+                        }
                     }
-                    for (const obj of objects) {
-                        const cleanObj = { ...obj };
-                        delete cleanObj.collection;
-                        delete cleanObj.createdAt;
-                        delete cleanObj.updatedAt;
-                        delete cleanObj.version;
-                        await db.put(colName, cleanObj);
-                    }
-                }
-            }
-            // 2. Restore Events
-            if (snapshot.events) {
-                for (const ev of snapshot.events) {
-                    const cleanEv = { ...ev };
-                    delete cleanEv.id;
-                    delete cleanEv.createdAt;
-                    delete cleanEv.stream;
-                    await db.events.append(ev.stream, cleanEv);
                 }
-            }
-            // 3. Restore Queues
-            if (snapshot.queues) {
-                for (const [qName, jobsData] of Object.entries(snapshot.queues)) {
-                    const queue = db.queue(qName);
-                    const { active, dead } = jobsData;
-                    for (const job of active) {
-                        await queue.push(job.payload, {
-                            idempotencyKey: job.id,
-                            maxAttempts: job.maxAttempts,
-                        });
+                // 2. Restore Events
+                if (snapshot.events) {
+                    for (const ev of snapshot.events) {
+                        const cleanEv = { ...ev };
+                        delete cleanEv.id;
+                        delete cleanEv.createdAt;
+                        delete cleanEv.stream;
+                        await db.events.append(ev.stream, cleanEv);
                     }
-                    for (const job of dead) {
-                        await queue.push(job.payload, {
-                            idempotencyKey: job.id,
-                            maxAttempts: job.maxAttempts,
-                        });
+                }
+                // 3. Restore Queues
+                if (snapshot.queues) {
+                    for (const [qName, jobsData] of Object.entries(snapshot.queues)) {
+                        const queue = db.queue(qName);
+                        const { active, dead } = jobsData;
+                        for (const job of active) {
+                            await queue.push(job.payload, {
+                                idempotencyKey: job.id,
+                                maxAttempts: job.maxAttempts,
+                            });
+                        }
+                        for (const job of dead) {
+                            await queue.push(job.payload, {
+                                idempotencyKey: job.id,
+                                maxAttempts: job.maxAttempts,
+                            });
+                        }
                     }
                 }
+                writeJson(context.stdout, { success: true, in: inPath }, context.pretty);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                // Restore failed — recommend using backup for atomic recovery
+                console.error(`Restore failed: ${message}. Data may be partially restored.\n` +
+                    `For atomic restore, use 'thingd backup --out backup.db' before making changes\n` +
+                    `and copy the backup file to restore.`);
+                throw err;
             }
-            writeJson(context.stdout, { success: true, in: inPath }, context.pretty);
         });
     }
     else {
         throw new Error(`Unknown snapshot command: ${subCommand}. Expected 'create' or 'restore'.`);
     }
 }
+export async function runBackup(context) {
+    const outPath = requiredFlag(context.parsed, "out");
+    await withDb(context, async (db) => {
+        if (db.path === ":memory:") {
+            throw new Error("Cannot backup an in-memory database. Use a file-based SQLite database.");
+        }
+        db.backupTo(outPath);
+        const { statSync } = await import("node:fs");
+        const stats = statSync(outPath);
+        const sizeMb = (stats.size / (1024 * 1024)).toFixed(2);
+        console.log(`Backup created: ${outPath} (${sizeMb} MB)`);
+    });
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAQA,OAAO,EASL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAOrB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAsCF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAmEF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6EjB;AAkxBD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CA2BxE;AAiDD,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAGlF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrF;AAyFD,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAEpF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAQA,OAAO,EASL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAOrB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAsCF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAoEF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6EjB;AAwxBD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CA2BxE;AAiDD,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAGlF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrF;AAyFD,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAEpF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElE"}

package/dist/index.js

@@ -75,6 +75,7 @@ Usage:
   thingd import --collection <name> --in <path>
   thingd snapshot create --out <path>
   thingd snapshot restore --in <path>
+  thingd backup --out <path>
 
 Options:
   --url <url>          remote thingd URL. Defaults to THINGD_URL
@@ -240,6 +241,11 @@ async function runCommand(context) {
         await runSnapshot(context);
         return;
     }
+    if (command === "backup") {
+        const { runBackup } = await import("./data-movement.js");
+        await runBackup(context);
+        return;
+    }
     throw new Error(`Unknown command: ${command}`);
 }
 async function runBench(context) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thingd/cli",
-  "version": "0.33.2",
+  "version": "0.35.0",
   "description": "CLI, Interactive TUI Dashboard, and MCP server for thingd — a fast object-first data engine for applications and AI agents.",
   "type": "module",
   "author": "Sayan Mohsin",
@@ -44,7 +44,7 @@
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
     "zod": "^4.4.3",
-    "@thingd/sdk": "0.33.2"
+    "@thingd/sdk": "0.35.0"
   },
   "engines": {
     "node": ">=24.0.0"