@thingd/cli 0.55.0 → 0.56.0

package/dist/interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AA+/EA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0FvD"}
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AAu8FA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0FvD"}

package/dist/interactive.js

@@ -69,6 +69,7 @@ let collections = [];
 let streams = [];
 let queues = [];
 let objectsByCollection = new Map();
+const collectionOptions = new Map();
 const expandedSet = new Set(["cat:collections", "cat:streams", "cat:queues"]);
 let cursorIndex = 0;
 let maintenanceCursor = 0;
@@ -244,7 +245,21 @@ async function fetchResourcesFallback() {
     objectsByCollection.clear();
     await Promise.all(collections.map(async (col) => {
         try {
-            const list = await db.listObjects(col);
+            const opts = collectionOptions.get(col);
+            const listOpts = {};
+            if (opts?.sortBy) {
+                listOpts.sortBy = { field: opts.sortBy, direction: opts.sortDir ?? "asc" };
+            }
+            if (opts?.limit) {
+                listOpts.limit = opts.limit;
+            }
+            if (opts?.offset) {
+                listOpts.offset = opts.offset;
+            }
+            if (opts?.filter) {
+                listOpts.filter = opts.filter;
+            }
+            const list = await db.listObjects(col, Object.keys(listOpts).length > 0 ? listOpts : undefined);
             objectsByCollection.set(col, list.map((o) => o.id));
         }
         catch {
@@ -289,7 +304,21 @@ async function fetchResources() {
     objectsByCollection.clear();
     for (const col of collections) {
         try {
-            const list = await db.listObjects(col);
+            const opts = collectionOptions.get(col);
+            const listOpts = {};
+            if (opts?.sortBy) {
+                listOpts.sortBy = { field: opts.sortBy, direction: opts.sortDir ?? "asc" };
+            }
+            if (opts?.limit) {
+                listOpts.limit = opts.limit;
+            }
+            if (opts?.offset) {
+                listOpts.offset = opts.offset;
+            }
+            if (opts?.filter) {
+                listOpts.filter = opts.filter;
+            }
+            const list = await db.listObjects(col, Object.keys(listOpts).length > 0 ? listOpts : undefined);
             objectsByCollection.set(col, list.map((o) => o.id));
         }
         catch {
@@ -758,6 +787,27 @@ async function loadContent(node) {
             const ref = node.ref;
             const objs = objectsByCollection.get(ref.name) ?? [];
             let res = `${pc.bold(ref.name)} ${pc.dim(`(${objs.length} objects)`)}\n\n`;
+            // Schema info
+            try {
+                const schemas = await db.schema(ref.name);
+                if (schemas.length > 0) {
+                    const fields = schemas[0]?.fields ?? [];
+                    if (fields.length > 0) {
+                        res += `${pc.bold("Fields")}\n`;
+                        for (const f of fields) {
+                            const icon = f.nullable ? pc.dim("⊙") : pc.cyan("◎");
+                            const sample = f.sampleValues.length > 0
+                                ? pc.dim(` e.g. ${String(f.sampleValues[0]).slice(0, 20)}`)
+                                : "";
+                            res += ` ${icon} ${f.name}: ${f.type}${sample}\n`;
+                        }
+                        res += "\n";
+                    }
+                }
+            }
+            catch {
+                // Schema not available for this store
+            }
             if (objs.length === 0) {
                 res += pc.dim("No objects in this collection.");
             }
@@ -1041,7 +1091,7 @@ function draw() {
         help = ` ${pc.dim("↑↓")} nav  ${pc.dim("enter")} connect  ${pc.dim("q")} quit `;
     }
     else {
-        help = ` ${pc.dim("↑↓")} nav  ${pc.dim("←→")} toggle  ${pc.dim("c")} create  ${pc.dim("e")} edit  ${pc.dim("d")} delete  ${pc.dim("/")} search  ${pc.dim("n")} neighbors  ${pc.dim("i")} info  ${pc.dim("r")} refresh  ${pc.dim("s")} switch  ${pc.dim("l")} logout  ${pc.dim("q")} quit `;
+        help = ` ${pc.dim("↑↓")} nav  ${pc.dim("←→")} toggle  ${pc.dim("c")} create  ${pc.dim("e")} edit  ${pc.dim("d")} delete  ${pc.dim("/")} search  ${pc.dim("n")} neighbors  ${pc.dim("N")} nlq  ${pc.dim("a")} agg  ${pc.dim("t")} ts  ${pc.dim("o")} options  ${pc.dim("b")} batch  ${pc.dim("i")} info  ${pc.dim("r")} refresh  ${pc.dim("s")} switch  ${pc.dim("l")} logout  ${pc.dim("q")} quit `;
     }
     buf += `${pc.dim("─".repeat(W))}\n`;
     buf += padToWidth(help, W);
@@ -1661,6 +1711,316 @@ async function handleNeighbors(selected) {
         draw();
     });
 }
+async function handleAggregate(selected) {
+    const defaultCol = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    openForm("Aggregate", [
+        {
+            id: "function",
+            label: "Function",
+            value: "count",
+            options: ["count", "sum", "avg", "min", "max"],
+        },
+        {
+            id: "collection",
+            label: "Collection",
+            value: defaultCol,
+            options: collections,
+            allowCustom: true,
+        },
+        { id: "field", label: "Field (for sum/avg/min/max)", placeholder: "field name" },
+        { id: "groupBy", label: "Group By (optional field)", placeholder: "field name" },
+        { id: "filter", label: "Filter (optional JSON)", placeholder: '{"status":"active"}' },
+    ], async (vals) => {
+        const func = vals.function || "count";
+        const collection = (vals.collection || "").trim();
+        if (!collection) {
+            throw new Error("Collection is required.");
+        }
+        const field = (vals.field || "").trim() || undefined;
+        const groupBy = (vals.groupBy || "").trim() || undefined;
+        const filter = vals.filter?.trim() ? JSON.parse(vals.filter.trim()) : undefined;
+        const options = { groupBy, filter };
+        const a = db.aggregate;
+        const result = func === "count"
+            ? await a.count(collection, options)
+            : func === "sum"
+                ? await a.sum(collection, field, options)
+                : func === "avg"
+                    ? await a.avg(collection, field, options)
+                    : func === "min"
+                        ? await a.min(collection, field, options)
+                        : await a.max(collection, field, options);
+        const lines = [
+            ` ${pc.bold("Aggregate")}  ${pc.cyan(func)} ${pc.dim(`on ${collection}`)}`,
+            "",
+            ` ${pc.dim("Total:")} ${pc.bold(String(result.total))}`,
+            "",
+        ];
+        if (result.groups && result.groups.length > 0) {
+            lines.push(` ${pc.bold("Groups")}`);
+            const maxVal = Math.max(...result.groups.map((g) => g.value));
+            for (const g of result.groups) {
+                const barLen = Math.max(1, Math.round((g.value / maxVal) * 20));
+                const bar = pc.cyan("█".repeat(barLen));
+                lines.push(` ${g.key}: ${bar} ${pc.dim(String(g.value))}`);
+            }
+        }
+        viewerLines = lines;
+        loadedItemId = "aggregate_result";
+        draw();
+    });
+}
+async function handleTimeseries(selected) {
+    const defaultCol = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    openForm("Time Series", [
+        {
+            id: "function",
+            label: "Function",
+            value: "count",
+            options: ["count", "sum", "avg", "min", "max"],
+        },
+        {
+            id: "collection",
+            label: "Collection",
+            value: defaultCol,
+            options: collections,
+            allowCustom: true,
+        },
+        { id: "field", label: "Field (optional)", placeholder: "field name" },
+        {
+            id: "bucket",
+            label: "Bucket",
+            value: "day",
+            options: ["hour", "day", "week", "month"],
+        },
+        { id: "from", label: "From (ISO date, optional)", placeholder: "2024-01-01" },
+        { id: "to", label: "To (ISO date, optional)", placeholder: "2024-12-31" },
+        { id: "filter", label: "Filter (optional JSON)", placeholder: '{"status":"active"}' },
+    ], async (vals) => {
+        const func = vals.function || "count";
+        const collection = (vals.collection || "").trim();
+        if (!collection) {
+            throw new Error("Collection is required.");
+        }
+        const field = (vals.field || "").trim() || undefined;
+        const bucket = (vals.bucket || "day");
+        const from = (vals.from || "").trim() || undefined;
+        const to = (vals.to || "").trim() || undefined;
+        const filter = vals.filter?.trim() ? JSON.parse(vals.filter.trim()) : undefined;
+        const result = await db.timeseries(collection, {
+            function: func,
+            field,
+            bucket,
+            from,
+            to,
+            filter,
+        });
+        const lines = [
+            ` ${pc.bold("Time Series")}  ${pc.cyan(func)} ${pc.dim(`on ${collection}, ${bucket}ly`)}`,
+            "",
+        ];
+        if (result.buckets.length === 0) {
+            lines.push(pc.dim("No data for the selected range."));
+        }
+        else {
+            const maxVal = Math.max(...result.buckets.map((b) => b.value));
+            for (const b of result.buckets) {
+                const barLen = Math.max(1, Math.round((b.value / maxVal) * 20));
+                const bar = pc.green("█".repeat(barLen));
+                lines.push(` ${b.label}: ${bar} ${pc.dim(String(b.value))}`);
+            }
+        }
+        viewerLines = lines;
+        loadedItemId = "timeseries_result";
+        draw();
+    });
+}
+async function handleNlq(selected) {
+    const defaultCol = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    openForm("Natural Language Query", [
+        { id: "question", label: "Question", placeholder: "How many active users?" },
+        {
+            id: "collection",
+            label: "Collection (optional)",
+            value: defaultCol,
+            options: collections,
+            allowCustom: true,
+        },
+    ], async (vals) => {
+        const question = (vals.question || "").trim();
+        if (!question) {
+            throw new Error("Question is required.");
+        }
+        const collection = (vals.collection || "").trim() || undefined;
+        const result = await db.nlq.query(question, {
+            collection,
+        });
+        const intent = result.intent;
+        const lines = [
+            ` ${pc.bold("NLQ Result")}`,
+            ` ${pc.dim(`Question: ${question}`)}`,
+            "",
+            ` ${result.answer}`,
+            "",
+        ];
+        if (intent) {
+            lines.push(` ${pc.dim("Interpreted as:")} ${intent.action} ${pc.dim("on")} ${pc.cyan(intent.collection)}`);
+            if (intent.function) {
+                lines.push(` ${pc.dim("Function:")} ${intent.function}`);
+            }
+            if (intent.field) {
+                lines.push(` ${pc.dim("Field:")} ${intent.field}`);
+            }
+            if (intent.query) {
+                lines.push(` ${pc.dim("Query:")} ${intent.query}`);
+            }
+        }
+        if (result.data !== undefined && result.data !== null) {
+            lines.push("", highlightJson(result.data));
+        }
+        viewerLines = lines;
+        loadedItemId = "nlq_result";
+        draw();
+    });
+}
+async function handleCollectionOptions(selected) {
+    const colName = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    if (!colName) {
+        viewerLines = [pc.yellow("Select a collection first, then press [o] to set listing options.")];
+        loadedItemId = "options_info";
+        draw();
+        return;
+    }
+    const current = collectionOptions.get(colName) ?? {};
+    openForm(`Listing Options: ${colName}`, [
+        {
+            id: "sortBy",
+            label: "Sort By",
+            value: current.sortBy ?? "",
+            options: ["", "id", "created_at", "updated_at", "version"],
+            allowCustom: true,
+        },
+        {
+            id: "sortDir",
+            label: "Sort Direction",
+            value: current.sortDir ?? "asc",
+            options: ["asc", "desc"],
+        },
+        { id: "limit", label: "Limit", value: String(current.limit ?? ""), placeholder: "50" },
+        { id: "offset", label: "Offset", value: String(current.offset ?? ""), placeholder: "0" },
+        {
+            id: "filter",
+            label: "Filter (JSON)",
+            value: current.filter ? JSON.stringify(current.filter) : "",
+            placeholder: '{"status":"active"}',
+        },
+    ], async (vals) => {
+        const opts = {};
+        if (vals.sortBy) {
+            opts.sortBy = vals.sortBy;
+            opts.sortDir = vals.sortDir || "asc";
+        }
+        if (vals.limit) {
+            opts.limit = parseInt(vals.limit, 10) || 50;
+        }
+        if (vals.offset) {
+            opts.offset = parseInt(vals.offset, 10) || 0;
+        }
+        if (vals.filter?.trim()) {
+            opts.filter = JSON.parse(vals.filter.trim());
+        }
+        if (Object.keys(opts).length > 0) {
+            collectionOptions.set(colName, opts);
+        }
+        else {
+            collectionOptions.delete(colName);
+        }
+        await fetchResources();
+        const tree = buildTree();
+        const idx = tree.findIndex((n) => n.id === `col:${colName}`);
+        if (idx !== -1) {
+            cursorIndex = idx;
+        }
+        const n = tree[cursorIndex];
+        if (n) {
+            scheduleLoad(n);
+        }
+    });
+}
+async function handleBatchOps(selected) {
+    const colName = selected?.type === "collection"
+        ? (selected.ref?.name ?? "")
+        : selected?.type === "object"
+            ? (selected.ref?.collection ?? "")
+            : "";
+    if (!colName) {
+        viewerLines = [pc.yellow("Select a collection first, then press [b] for batch operations.")];
+        loadedItemId = "batch_info";
+        draw();
+        return;
+    }
+    openForm(`Batch Ops: ${colName}`, [
+        {
+            id: "action",
+            label: "Action",
+            value: "put",
+            options: ["put", "delete"],
+        },
+        {
+            id: "input",
+            label: "JSON File Path or IDs (comma-sep for delete)",
+            placeholder: "/path/to/file.json or id1,id2,id3",
+        },
+    ], async (vals) => {
+        const action = vals.action || "";
+        const input = (vals.input || "").trim();
+        if (!input) {
+            throw new Error("Input is required.");
+        }
+        if (action === "put") {
+            const data = JSON.parse(await fs.promises.readFile(input, "utf-8"));
+            const objects = Array.isArray(data) ? data : (data.objects ?? [data]);
+            const result = await db.putBatch(colName, objects);
+            viewerLines = [
+                ` ${pc.bold("Batch Put Complete")}`,
+                ` ${pc.dim(`Collection: ${colName}`)}`,
+                ` ${pc.dim(`Objects: ${result.length}`)}`,
+            ];
+            loadedItemId = "batch_result";
+            draw();
+        }
+        else if (action === "delete") {
+            const ids = input
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean);
+            const count = await db.deleteBatch(colName, ids);
+            viewerLines = [
+                ` ${pc.bold("Batch Delete Complete")}`,
+                ` ${pc.dim(`Collection: ${colName}`)}`,
+                ` ${pc.dim(`Deleted: ${count} objects`)}`,
+            ];
+            loadedItemId = "batch_result";
+            draw();
+        }
+    });
+}
 async function handleMaintenance() {
     // Cycle through maintenance operations with each press of 'm'
     const operations = ["health", "checkpoint", "backup"];
@@ -1956,9 +2316,24 @@ function setupKeypress() {
             else if (str === "i" || str === "I") {
                 await handleInfo();
             }
-            else if (str === "n" || str === "N") {
+            else if (str === "n") {
                 await handleNeighbors(tree[cursorIndex]);
             }
+            else if (str === "N") {
+                await handleNlq(tree[cursorIndex]);
+            }
+            else if (str === "a" || str === "A") {
+                await handleAggregate(tree[cursorIndex]);
+            }
+            else if (str === "t" || str === "T") {
+                await handleTimeseries(tree[cursorIndex]);
+            }
+            else if (str === "o" || str === "O") {
+                await handleCollectionOptions(tree[cursorIndex]);
+            }
+            else if (str === "b" || str === "B") {
+                await handleBatchOps(tree[cursorIndex]);
+            }
             else if (str === "m" || str === "M") {
                 await handleMaintenance();
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thingd/cli",
-  "version": "0.55.0",
+  "version": "0.56.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",
@@ -45,7 +45,7 @@
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
     "zod": "^4.4.3",
-    "@thingd/sdk": "0.55.0"
+    "@thingd/sdk": "0.56.0"
   },
   "engines": {
     "node": ">=24.0.0"