@thingd/cli 0.31.0

package/dist/doctor.js

@@ -0,0 +1,109 @@
+import { NativeThingStore } from "@thingd/node";
+import pc from "picocolors";
+import { resolveConnection } from "./index.js";
+export async function runDoctor(context) {
+    context.stderr.write(`\n${pc.bold("thingd doctor")}\n`);
+    context.stderr.write(`${pc.dim("Running system diagnostics and connectivity tests...")}\n\n`);
+    let healthy = true;
+    // 1. Check Node version
+    const nodeVersion = process.version;
+    const majorVersion = Number.parseInt(nodeVersion.slice(1).split(".")[0] ?? "0", 10);
+    if (majorVersion >= 20) {
+        context.stderr.write(`  ${pc.green("✓")} Node version:   ${pc.cyan(nodeVersion)} (OK)\n`);
+    }
+    else {
+        healthy = false;
+        context.stderr.write(`  ${pc.red("×")} Node version:   ${pc.yellow(nodeVersion)} (Requires >= v20.x)\n`);
+    }
+    // 2. Resolve connection options
+    const connection = resolveConnection(context);
+    // 3. Native Driver Checks
+    if (connection.driver === "native") {
+        try {
+            const hasNative = await NativeThingStore.isAvailable();
+            if (hasNative) {
+                const loadedPath = (await NativeThingStore.getLoadedPath()) ?? "unknown";
+                const buildType = loadedPath.includes("prebuilds")
+                    ? pc.cyan("Loaded prebuilt driver")
+                    : pc.cyan("Loaded local development build");
+                context.stderr.write(`  ${pc.green("✓")} Native Addon:    ${buildType} (${pc.dim(loadedPath)})\n`);
+            }
+            else {
+                healthy = false;
+                context.stderr.write(`  ${pc.red("×")} Native Addon:    ${pc.yellow('Not found. Run "pnpm --filter thingd-native build" or configure THINGD_NATIVE_PATH.')}\n`);
+            }
+        }
+        catch (error) {
+            healthy = false;
+            context.stderr.write(`  ${pc.red("×")} Native Addon:    ${pc.yellow(`Failed to load native addon: ${error instanceof Error ? error.message : String(error)}`)}\n`);
+        }
+    }
+    else {
+        context.stderr.write(`  ${pc.dim("○")} Native Addon:    Skipped (Using driver: "${connection.driver ?? "memory"}")\n`);
+    }
+    // 4. Remote Sidecar Reachability & Auth Checks
+    if (connection.cloud) {
+        const rawUrl = connection.path;
+        const isLocal = rawUrl.includes("localhost") || rawUrl.includes("127.0.0.1");
+        if (!connection.authToken && !isLocal) {
+            context.stderr.write(`  ${pc.yellow("⚠")} Auth Token:     ${pc.yellow("Missing THINGD_AUTH_TOKEN for remote server (might fail)")}\n`);
+        }
+        else if (connection.authToken) {
+            context.stderr.write(`  ${pc.green("✓")} Auth Token:     ${pc.cyan("Configured")}\n`);
+        }
+        else {
+            context.stderr.write(`  ${pc.green("✓")} Auth Token:     ${pc.dim("Not required for local sidecar")}\n`);
+        }
+        try {
+            const normalizeUrl = (val) => val.startsWith("thingd://") ? `http://${val.slice("thingd://".length)}` : val;
+            const targetUrl = new URL(normalizeUrl(rawUrl));
+            if (targetUrl.pathname === "/mcp" || targetUrl.pathname === "") {
+                targetUrl.pathname = "/healthz";
+            }
+            else {
+                targetUrl.pathname = `${targetUrl.pathname.replace(/\/mcp$/, "")}/healthz`;
+            }
+            context.stderr.write(`  ${pc.dim("○")} Connectivity:   Checking reachability to ${pc.cyan(targetUrl.toString())}...\n`);
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 3000);
+            const headers = {};
+            if (connection.authToken) {
+                headers.Authorization = `Bearer ${connection.authToken}`;
+            }
+            try {
+                const response = await fetch(targetUrl, {
+                    signal: controller.signal,
+                    headers,
+                });
+                clearTimeout(timeoutId);
+                if (response.ok) {
+                    context.stderr.write(`  ${pc.green("✓")} Connectivity:   ${pc.cyan("Connected successfully!")} (${pc.dim(`HTTP ${response.status}`)})\n`);
+                }
+                else {
+                    healthy = false;
+                    context.stderr.write(`  ${pc.red("×")} Connectivity:   ${pc.yellow(`Server responded with non-2xx status`)} (${pc.dim(`HTTP ${response.status}`)})\n`);
+                }
+            }
+            catch (fetchError) {
+                clearTimeout(timeoutId);
+                healthy = false;
+                context.stderr.write(`  ${pc.red("×")} Connectivity:   ${pc.yellow(`Failed to connect. Connection refused or timed out.`)} (${pc.dim(fetchError instanceof Error ? fetchError.message : String(fetchError))})\n`);
+            }
+        }
+        catch (urlError) {
+            healthy = false;
+            context.stderr.write(`  ${pc.red("×")} Connectivity:   ${pc.yellow(`Invalid URL structure: ${urlError instanceof Error ? urlError.message : String(urlError)}`)}\n`);
+        }
+    }
+    else {
+        context.stderr.write(`  ${pc.green("✓")} Connectivity:   ${pc.cyan("Local SQLite Store")} (${pc.dim(connection.path)})\n`);
+    }
+    // Final Summary Report
+    context.stderr.write("\n");
+    if (healthy) {
+        context.stderr.write(`  ${pc.bold(pc.green("Diagnosis: Everything looks healthy!"))}\n\n`);
+    }
+    else {
+        context.stderr.write(`  ${pc.bold(pc.yellow("Diagnosis: Some items require attention (see errors above)."))}\n\n`);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { ThingD, type ThingDDriver } from "@thingd/node";
+type CliEnv = Record<string, string | undefined>;
+type WritableLike = {
+    write(chunk: string): void;
+};
+export type RunCliOptions = {
+    env?: CliEnv;
+    stdout?: WritableLike;
+    stderr?: WritableLike;
+};
+export type ParsedArgs = {
+    tokens: string[];
+    flags: Map<string, string[]>;
+    booleans: Set<string>;
+};
+export type CliContext = {
+    parsed: ParsedArgs;
+    env: CliEnv;
+    stdout: WritableLike;
+    stderr: WritableLike;
+    pretty: boolean;
+};
+export type ConnectionOptions = {
+    path: string;
+    driver?: ThingDDriver;
+    authToken?: string;
+    cloud: boolean;
+};
+export declare function runCli(args?: string[], options?: RunCliOptions): Promise<number>;
+export declare function withDb(context: CliContext, callback: (db: ThingD) => Promise<void>): Promise<void>;
+export declare function resolveConnection(context: CliContext): ConnectionOptions;
+export declare function hasFlag(parsed: ParsedArgs, name: string): boolean;
+export declare function stringFlag(parsed: ParsedArgs, name: string): string | undefined;
+export declare function stringFlags(parsed: ParsedArgs, name: string): string[] | undefined;
+export declare function requiredFlag(parsed: ParsedArgs, name: string): string;
+export declare function optionalToken(parsed: ParsedArgs, index: number): string | undefined;
+export declare function requiredToken(parsed: ParsedArgs, index: number, name: string): string;
+export declare function writeJson(target: WritableLike, data: unknown, pretty: boolean): void;
+export declare function writeText(target: WritableLike, text: string): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAQA,OAAO,EASL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAOtB,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"}