@thingd/cli 0.80.0 → 0.81.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAeA,OAAO,EAYL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AASrB,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,KAAK,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,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,KAAK,EAAE,YAAY,CAAC;IACpB,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;IACf,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAqGF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA8EjB;AAiuCD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAgBf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CAuDxE;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":";AAeA,OAAO,EAYL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AASrB,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,KAAK,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,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,KAAK,EAAE,YAAY,CAAC;IACpB,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;IACf,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAuGF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA8EjB;AAwxCD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAgBf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CAuDxE;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

@@ -106,6 +106,8 @@ Usage:
   thingd cloud api-key create <project> <name>
   thingd db checkpoint [--path <path>]
   thingd db integrity [--path <path>]
+  thingd db backup --out <archive.tar> [--path <path>]
+  thingd db restore --in <archive.tar> --destination <path> [--replace]
   thingd db reencrypt --source <path> --destination <path> [--allow-plaintext-output]
 
 Options:
@@ -329,11 +331,19 @@ async function runCommand(context) {
             await runDbIntegrity(context);
             return;
         }
+        if (sub === "backup") {
+            await runDbNativeBackup(context);
+            return;
+        }
+        if (sub === "restore") {
+            await runDbNativeRestore(context);
+            return;
+        }
         if (sub === "reencrypt") {
             await runDbReencrypt(context);
             return;
         }
-        throw new Error(`Unknown db subcommand: ${sub}. Expected: checkpoint, integrity, reencrypt`);
+        throw new Error(`Unknown db subcommand: ${sub}. Expected: checkpoint, integrity, backup, restore, reencrypt`);
     }
     throw new Error(`Unknown command: ${command}`);
 }
@@ -427,6 +437,40 @@ async function runDbIntegrity(context) {
         }
     });
 }
+async function runDbNativeBackup(context) {
+    const output = stringFlag(context.parsed, "out");
+    if (!output) {
+        throw new Error("db backup requires --out <archive.tar>");
+    }
+    const connection = resolveConnection(context);
+    if (connection.cloud || connection.driver !== "native") {
+        throw new Error("db backup requires a local native database; logical snapshots support remote stores");
+    }
+    const db = await ThingD.open({
+        path: connection.path,
+        driver: "native",
+        encryption: connection.encryptionKey ? { key: connection.encryptionKey } : undefined,
+    });
+    try {
+        db.walCheckpoint();
+    }
+    finally {
+        await db.close();
+    }
+    const { createNativeArchive } = await import("./native-archive.js");
+    await createNativeArchive(connection.path, output);
+    writeJson(context.stdout, { ok: true, out: resolve(output), format: "thingd-native-tar" }, context.pretty);
+}
+async function runDbNativeRestore(context) {
+    const input = stringFlag(context.parsed, "in");
+    const destination = stringFlag(context.parsed, "destination");
+    if (!input || !destination) {
+        throw new Error("db restore requires --in <archive.tar> and --destination <path>");
+    }
+    const { restoreNativeArchive } = await import("./native-archive.js");
+    await restoreNativeArchive(input, destination, hasFlag(context.parsed, "replace"));
+    writeJson(context.stdout, { ok: true, destination: resolve(destination), format: "thingd-native-tar" }, context.pretty);
+}
 async function runCompletions(context) {
     const shell = optionalToken(context.parsed, 1) ?? "bash";
     const cmds = [

package/dist/native-archive.d.ts

@@ -0,0 +1,3 @@
+export declare function createNativeArchive(sourcePath: string, outputPath: string): Promise<void>;
+export declare function restoreNativeArchive(archivePath: string, destinationPath: string, replace: boolean): Promise<void>;
+//# sourceMappingURL=native-archive.d.ts.map

package/dist/native-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-archive.d.ts","sourceRoot":"","sources":["../src/native-archive.ts"],"names":[],"mappings":"AA0DA,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC/F;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAkEf"}

package/dist/native-archive.js

@@ -0,0 +1,134 @@
+import { execFile, execFileSync } from "node:child_process";
+import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const METADATA_NAME = "thingd-backup.json";
+async function runTar(args) {
+    try {
+        await execFileAsync("tar", args, { maxBuffer: 16 * 1024 * 1024 });
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`tar operation failed: ${detail}`);
+    }
+}
+function assertDirectory(path, label) {
+    if (!existsSync(path) || !lstatSync(path).isDirectory()) {
+        throw new Error(`${label} must be an existing directory: ${path}`);
+    }
+}
+function assertArchivePathSafe(path) {
+    if (path.startsWith("/") || path.startsWith("\\") || /^[A-Za-z]:[\\/]/.test(path)) {
+        throw new Error(`Unsafe archive path: ${path}`);
+    }
+    const normalized = path.replaceAll("\\", "/");
+    if (normalized.split("/").includes("..")) {
+        throw new Error(`Unsafe archive path: ${path}`);
+    }
+}
+function archiveEntries(archive) {
+    const result = execFileSync("tar", ["-tf", archive], {
+        encoding: "utf8",
+        maxBuffer: 16 * 1024 * 1024,
+    });
+    return result.split(/\r?\n/).filter(Boolean);
+}
+export async function createNativeArchive(sourcePath, outputPath) {
+    const source = resolve(sourcePath);
+    const output = resolve(outputPath);
+    assertDirectory(source, "Native database");
+    const outputRelative = relative(source, output);
+    if (outputRelative && !outputRelative.startsWith("..") && !isAbsolute(outputRelative)) {
+        throw new Error("Backup archive must be outside the source database directory");
+    }
+    if (existsSync(output)) {
+        throw new Error(`Backup destination already exists: ${output}`);
+    }
+    mkdirSync(dirname(output), { recursive: true });
+    const staging = mkdtempSync(join(tmpdir(), "thingd-backup-"));
+    const metadata = {
+        format: "thingd-native-tar",
+        version: 1,
+        sourceName: basename(source),
+        createdAt: new Date().toISOString(),
+    };
+    const metadataPath = join(staging, METADATA_NAME);
+    writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`, "utf8");
+    try {
+        await runTar([
+            "-cf",
+            output,
+            "-C",
+            dirname(source),
+            basename(source),
+            "-C",
+            staging,
+            METADATA_NAME,
+        ]);
+    }
+    finally {
+        rmSync(staging, { recursive: true, force: true });
+    }
+}
+export async function restoreNativeArchive(archivePath, destinationPath, replace) {
+    const archive = resolve(archivePath);
+    const destination = resolve(destinationPath);
+    if (!existsSync(archive) || !lstatSync(archive).isFile()) {
+        throw new Error(`Backup archive not found: ${archive}`);
+    }
+    if (existsSync(destination) && !replace) {
+        throw new Error(`Restore destination already exists: ${destination}; pass --replace to replace it`);
+    }
+    mkdirSync(dirname(destination), { recursive: true });
+    const entries = archiveEntries(archive);
+    for (const entry of entries) {
+        assertArchivePathSafe(entry);
+    }
+    if (!entries.includes(METADATA_NAME)) {
+        throw new Error(`Invalid Thingd archive: missing ${METADATA_NAME}`);
+    }
+    const roots = new Set(entries
+        .filter((entry) => entry !== METADATA_NAME)
+        .map((entry) => entry.split("/")[0])
+        .filter(Boolean));
+    if (roots.size !== 1) {
+        throw new Error("Invalid Thingd archive: expected exactly one database directory");
+    }
+    const stagingParent = mkdtempSync(join(dirname(destination), ".thingd-restore-"));
+    const root = [...roots][0];
+    if (!root) {
+        throw new Error("Invalid Thingd archive: missing database directory");
+    }
+    const staging = join(stagingParent, root);
+    let previous;
+    try {
+        await runTar(["-xf", archive, "-C", stagingParent]);
+        const metadata = JSON.parse(readFileSync(join(stagingParent, METADATA_NAME), "utf8"));
+        if (metadata.format !== "thingd-native-tar" || metadata.version !== 1) {
+            throw new Error("Invalid Thingd archive metadata");
+        }
+        assertDirectory(staging, "Restored native database");
+        if (!existsSync(join(staging, "lock")) || !existsSync(join(staging, "keyspaces"))) {
+            throw new Error("Invalid Thingd archive: missing lock or keyspaces directory");
+        }
+        if (replace && existsSync(destination)) {
+            previous = `${destination}.previous-${Date.now()}`;
+            renameSync(destination, previous);
+        }
+        renameSync(staging, destination);
+        if (previous) {
+            rmSync(previous, { recursive: true, force: true });
+        }
+    }
+    catch (error) {
+        if (previous && !existsSync(destination) && existsSync(previous)) {
+            renameSync(previous, destination);
+        }
+        throw error;
+    }
+    finally {
+        rmSync(stagingParent, { recursive: true, force: true });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thingd/cli",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "description": "CLI, Interactive TUI Dashboard, and MCP server for thingd — a fast object-first data engine for applications and AI agents.",
   "type": "module",
   "homepage": "https://engine.thingd.cloud",
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@thingd/sdk": "^0.80.0",
+    "@thingd/sdk": "^0.81.0",
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
     "zod": "^4.4.3"