@framedash/cli 0.1.0

package/dist/commands/map-capture.js

@@ -0,0 +1,200 @@
+import { readdir, readFile, realpath, stat } from "node:fs/promises";
+import { extname, isAbsolute, join, relative, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { resolveApiKey } from "../lib/config.js";
+import { error, log, success } from "../lib/logger.js";
+import { mapCaptureMetadataSchema } from "../lib/metadata.js";
+import { uploadMapCapture } from "../lib/uploader.js";
+const ALLOWED_IMAGE_EXTS = new Set([".png", ".jpg", ".jpeg", ".webp"]);
+const MAP_CAPTURE_HELP = `Usage: framedash map-capture [options]
+
+Upload captured map images and metadata to Framedash SaaS.
+
+Reads JSON sidecar metadata files from --input-dir, validates them,
+and optionally uploads the associated images to the Framedash API.
+
+Required:
+  --input-dir <path>     Directory containing JSON metadata files and images
+
+Upload options (all required together):
+  --upload               Enable upload to Framedash API
+  --api-key <key>        Admin API key. Prefer FRAMEDASH_API_KEY env or
+                         --api-key-file: a key passed as --api-key is visible
+                         in the process list and shell history.
+  --api-key-file <path>  Read the admin API key from a file ('-' for stdin)
+  --project-id <uuid>    Target project ID, or set FRAMEDASH_PROJECT_ID env
+
+Optional:
+  --base-url <url>       API base URL (default: https://app.framedash.dev)
+  --dry-run              Validate files without uploading
+
+Examples:
+  # Validate metadata files only
+  framedash map-capture --input-dir ./captures --dry-run
+
+  # Upload to Framedash (key from env, not the command line)
+  FRAMEDASH_API_KEY=... FRAMEDASH_PROJECT_ID=... \\
+  framedash map-capture --input-dir ./captures --upload`;
+/** CLI entry point for map-capture — parses args then delegates to mapCapture(). */
+export async function mapCaptureCommand(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            "input-dir": { type: "string" },
+            "api-key": { type: "string" },
+            "api-key-file": { type: "string" },
+            "project-id": { type: "string" },
+            "base-url": { type: "string", default: "https://app.framedash.dev" },
+            upload: { type: "boolean", default: false },
+            "dry-run": { type: "boolean", default: false },
+            help: { type: "boolean", short: "h", default: false },
+        },
+        allowPositionals: false,
+    });
+    if (values.help) {
+        log(MAP_CAPTURE_HELP);
+        return;
+    }
+    // Resolve the API key only when an upload will actually run, so a validation
+    // dry run with --api-key-file - does not block on stdin (or fail on a missing
+    // file) for a key it never uses.
+    const willUpload = Boolean(values.upload) && !values["dry-run"];
+    const result = await mapCapture({
+        inputDir: values["input-dir"],
+        upload: values.upload,
+        dryRun: values["dry-run"],
+        apiKey: willUpload ? resolveApiKey(values) : undefined,
+        projectId: values["project-id"] ?? process.env.FRAMEDASH_PROJECT_ID,
+        baseUrl: values["base-url"] ?? "https://app.framedash.dev",
+    });
+    if (!result.ok) {
+        process.exit(1);
+    }
+}
+export async function mapCapture(opts) {
+    const fail = { ok: false, successCount: 0, errorCount: 0 };
+    if (!opts.inputDir) {
+        error("--input-dir is required");
+        return fail;
+    }
+    const upload = Boolean(opts.upload);
+    const dryRun = Boolean(opts.dryRun);
+    if (upload && !dryRun) {
+        if (!opts.apiKey) {
+            error("--api-key (or FRAMEDASH_API_KEY env) is required with --upload");
+            return fail;
+        }
+        if (!opts.projectId) {
+            error("--project-id (or FRAMEDASH_PROJECT_ID env) is required with --upload");
+            return fail;
+        }
+    }
+    const resolvedDir = resolve(opts.inputDir);
+    let dirStat;
+    try {
+        dirStat = await stat(resolvedDir);
+    }
+    catch {
+        error(`Input directory not found: ${resolvedDir}`);
+        return fail;
+    }
+    if (!dirStat.isDirectory()) {
+        error(`Not a directory: ${resolvedDir}`);
+        return fail;
+    }
+    const files = await readdir(resolvedDir);
+    const jsonFiles = files.filter((f) => f.endsWith(".json"));
+    if (jsonFiles.length === 0) {
+        error(`No JSON metadata files found in ${resolvedDir}`);
+        return fail;
+    }
+    log(`Found ${jsonFiles.length} metadata file(s) in ${resolvedDir}`);
+    const realInputDir = await realpath(resolvedDir);
+    let successCount = 0;
+    let errorCount = 0;
+    for (const jsonFile of jsonFiles) {
+        const jsonPath = join(resolvedDir, jsonFile);
+        try {
+            const raw = await readFile(jsonPath, "utf-8");
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                error(`${jsonFile}: Invalid JSON`);
+                errorCount++;
+                continue;
+            }
+            const result = mapCaptureMetadataSchema.safeParse(parsed);
+            if (!result.success) {
+                const issues = result.error.issues.map((i) => i.message).join("; ");
+                error(`${jsonFile}: Invalid metadata \u2014 ${issues}`);
+                errorCount++;
+                continue;
+            }
+            const metadata = result.data;
+            // Verify image file exists and is within input directory
+            if (isAbsolute(metadata.image_path)) {
+                error(`${jsonFile}: Absolute image paths are not allowed: ${metadata.image_path}`);
+                errorCount++;
+                continue;
+            }
+            const imagePath = await realpath(resolve(resolvedDir, metadata.image_path)).catch(() => null);
+            if (!imagePath) {
+                error(`${jsonFile}: Image not found: ${metadata.image_path}`);
+                errorCount++;
+                continue;
+            }
+            const rel = relative(realInputDir, imagePath);
+            if (rel.startsWith("..") || isAbsolute(rel)) {
+                error(`${jsonFile}: Image path escapes input directory: ${metadata.image_path}`);
+                errorCount++;
+                continue;
+            }
+            const imgStat = await stat(imagePath);
+            if (!imgStat.isFile()) {
+                error(`${jsonFile}: Image path is not a file: ${metadata.image_path}`);
+                errorCount++;
+                continue;
+            }
+            const imgExt = extname(imagePath).toLowerCase();
+            if (!ALLOWED_IMAGE_EXTS.has(imgExt)) {
+                error(`${jsonFile}: Unsupported image format: ${imgExt}`);
+                errorCount++;
+                continue;
+            }
+            if (dryRun) {
+                success(`${jsonFile}: map_id=${metadata.map_id}, ` +
+                    `image=${metadata.image_path}, ` +
+                    `bounds=[${metadata.world_bounds.min.x},${metadata.world_bounds.min.y}]` +
+                    `→[${metadata.world_bounds.max.x},${metadata.world_bounds.max.y}], ` +
+                    `size=${metadata.image_dimensions.width}x${metadata.image_dimensions.height}`);
+                successCount++;
+                continue;
+            }
+            if (upload) {
+                const uploadResult = await uploadMapCapture({
+                    metadata,
+                    imagePath,
+                    apiKey: opts.apiKey,
+                    projectId: opts.projectId,
+                    baseUrl: opts.baseUrl ?? "https://app.framedash.dev",
+                });
+                success(`${metadata.map_id}: ${uploadResult.action} ` +
+                    `(${metadata.image_dimensions.width}x${metadata.image_dimensions.height})`);
+            }
+            else {
+                success(`${jsonFile}: Valid (map_id=${metadata.map_id})`);
+            }
+            successCount++;
+        }
+        catch (err) {
+            error(`${jsonFile}: ${err instanceof Error ? err.message : String(err)}`);
+            errorCount++;
+        }
+    }
+    log("");
+    log(`Done: ${successCount} succeeded, ${errorCount} failed`);
+    return { ok: errorCount === 0, successCount, errorCount };
+}
+//# sourceMappingURL=map-capture.js.map

package/dist/commands/map-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-capture.js","sourceRoot":"","sources":["../../src/commands/map-capture.ts"],"names":[],"mappings":"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"}

package/dist/commands/maps.d.ts

@@ -0,0 +1,2 @@
+export declare const maps: (args: string[]) => Promise<void>;
+//# sourceMappingURL=maps.d.ts.map

package/dist/commands/maps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps.d.ts","sourceRoot":"","sources":["../../src/commands/maps.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,IAAI,mCAGf,CAAC"}

package/dist/commands/maps.js

@@ -0,0 +1,38 @@
+import { formatOutput } from "../lib/formatters.js";
+import { error, log, success } from "../lib/logger.js";
+import { runCommand, withSubcommands } from "../lib/run-command.js";
+const HELP = `Usage: framedash maps <subcommand> [options]
+
+Manage maps.
+
+Subcommands:
+  list                   List maps
+  delete <map-id>        Delete a map
+
+Run 'framedash maps <subcommand> --help' for more info.`;
+export const maps = withSubcommands("maps", HELP, {
+    list: mapsList,
+    delete: mapsDelete,
+});
+async function mapsList(args) {
+    await runCommand({ args, help: "Usage: framedash maps list [--format json|table|csv] [global options]" }, async ({ client, config }) => {
+        const data = await client.get(client.projectPath("maps"));
+        log(formatOutput(data, config.format));
+    });
+}
+async function mapsDelete(args) {
+    await runCommand({
+        args,
+        help: "Usage: framedash maps delete <map-id> [global options]",
+        allowPositionals: true,
+    }, async ({ client, positionals }) => {
+        const mapId = positionals[0];
+        if (!mapId) {
+            error("Map ID is required: framedash maps delete <map-id>");
+            process.exit(1);
+        }
+        await client.delete(client.projectPath(`maps/${encodeURIComponent(mapId)}`));
+        success(`Map ${mapId} deleted`);
+    });
+}
+//# sourceMappingURL=maps.js.map

package/dist/commands/maps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps.js","sourceRoot":"","sources":["../../src/commands/maps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,IAAI,GAAG;;;;;;;;wDAQ2C,CAAC;AAEzD,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE;IACjD,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,UAAU;CAClB,CAAC,CAAC;AAEH,KAAK,UAAU,QAAQ,CAAC,IAAc;IACrC,MAAM,UAAU,CACf,EAAE,IAAI,EAAE,IAAI,EAAE,uEAAuE,EAAE,EACvF,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC,CACD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAc;IACvC,MAAM,UAAU,CACf;QACC,IAAI;QACJ,IAAI,EAAE,wDAAwD;QAC9D,gBAAgB,EAAE,IAAI;KACtB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,KAAK,CAAC,oDAAoD,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC;IACjC,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/commands/query.d.ts

@@ -0,0 +1,2 @@
+export declare function query(args: string[]): Promise<void>;
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAMA,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CzD"}

package/dist/commands/query.js

@@ -0,0 +1,70 @@
+import { readFile } from "node:fs/promises";
+import { parsePositiveInt } from "../lib/config.js";
+import { formatOutput } from "../lib/formatters.js";
+import { error, log } from "../lib/logger.js";
+import { runCommand } from "../lib/run-command.js";
+export async function query(args) {
+    await runCommand({
+        args,
+        help: HELP,
+        options: {
+            limit: { type: "string" },
+            file: { type: "string", short: "f" },
+        },
+        allowPositionals: true,
+    }, async ({ client, config, values, positionals }) => {
+        if (values.file && positionals.length > 0) {
+            error("Cannot use both --file and a positional SQL argument. Provide one or the other.");
+            process.exit(1);
+        }
+        let sql;
+        if (values.file) {
+            try {
+                sql = await readFile(values.file, "utf-8");
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : "unknown error";
+                error(`Failed to read SQL file: ${values.file} (${msg})`);
+                process.exit(1);
+            }
+        }
+        else if (positionals.length > 0) {
+            sql = positionals.join(" ");
+        }
+        else {
+            error("SQL query is required. Provide as argument or use --file.");
+            process.exit(1);
+        }
+        const body = {
+            sql,
+            project_id: config.projectId,
+        };
+        if (values.limit) {
+            body.limit = parsePositiveInt(values.limit, "limit");
+        }
+        const data = await client.post("/api/v1/query", body);
+        log(formatOutput(data, config.format));
+    });
+}
+const HELP = `Usage: framedash query <sql> [options]
+       framedash query --file query.sql [options]
+
+Execute a read-only ClickHouse query.
+
+Arguments:
+  <sql>                  SQL query string
+
+Options:
+  -f, --file <path>      Read SQL from file
+  --limit <n>            Max rows (default: 1000)
+  --api-key <key>        API key (or FRAMEDASH_API_KEY env)
+  --project-id <uuid>    Project ID (or FRAMEDASH_PROJECT_ID env)
+  --base-url <url>       API base URL (default: https://app.framedash.dev)
+  --format <fmt>         Output format: json, table, csv (default: json)
+  -h, --help             Show help
+
+Examples:
+  framedash query "SELECT count() FROM events"
+  framedash query "SELECT event_name, count() FROM events GROUP BY event_name" --format table
+  framedash query --file complex-query.sql --limit 100`;
+//# sourceMappingURL=query.js.map

package/dist/commands/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc;IACzC,MAAM,UAAU,CACf;QACC,IAAI;QACJ,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACR,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;SACpC;QACD,gBAAgB,EAAE,IAAI;KACtB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;QACjD,IAAI,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,iFAAiF,CAAC,CAAC;YACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,GAAW,CAAC;QAChB,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC;gBACJ,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAc,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBACjE,KAAK,CAAC,4BAA4B,MAAM,CAAC,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC;gBAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC;QACF,CAAC;aAAM,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,KAAK,CAAC,2DAA2D,CAAC,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,IAAI,GAA4B;YACrC,GAAG;YACH,UAAU,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;QACF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAe,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QACtD,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC,CACD,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;uDAoB0C,CAAC"}

package/dist/commands/retention.d.ts

@@ -0,0 +1,2 @@
+export declare function retention(args: string[]): Promise<void>;
+//# sourceMappingURL=retention.d.ts.map

package/dist/commands/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/commands/retention.ts"],"names":[],"mappings":"AAIA,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7D"}

package/dist/commands/retention.js

@@ -0,0 +1,22 @@
+import { formatOutput } from "../lib/formatters.js";
+import { log } from "../lib/logger.js";
+import { runCommand } from "../lib/run-command.js";
+export async function retention(args) {
+    await runCommand({ args, help: HELP, options: { days: { type: "string" } } }, async ({ client, config, values }) => {
+        const params = new URLSearchParams({ days: values.days ?? "30" });
+        const data = await client.get(client.projectPath(`retention?${params}`));
+        log(formatOutput(data, config.format));
+    });
+}
+const HELP = `Usage: framedash retention [options]
+
+Show player retention cohorts.
+
+Options:
+  --days <n>             Time period in days: 1, 7, 14, 30 (default: 30)
+  --api-key <key>        API key (or FRAMEDASH_API_KEY env)
+  --project-id <uuid>    Project ID (or FRAMEDASH_PROJECT_ID env)
+  --base-url <url>       API base URL (default: https://app.framedash.dev)
+  --format <fmt>         Output format: json, table, csv (default: json)
+  -h, --help             Show help`;
+//# sourceMappingURL=retention.js.map

package/dist/commands/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../src/commands/retention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc;IAC7C,MAAM,UAAU,CACf,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAC3D,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAG,MAAM,CAAC,IAAe,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC,CAAC;QACzE,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC,CACD,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;;mCAUsB,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+export declare function status(args: string[]): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAIA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1D"}

package/dist/commands/status.js

@@ -0,0 +1,20 @@
+import { formatOutput } from "../lib/formatters.js";
+import { log } from "../lib/logger.js";
+import { runCommand } from "../lib/run-command.js";
+export async function status(args) {
+    await runCommand({ args, help: HELP }, async ({ client, config }) => {
+        const data = await client.get(client.projectPath("status"));
+        log(formatOutput(data, config.format));
+    });
+}
+const HELP = `Usage: framedash status [options]
+
+Show project status and key metrics.
+
+Options:
+  --api-key <key>        API key (or FRAMEDASH_API_KEY env)
+  --project-id <uuid>    Project ID (or FRAMEDASH_PROJECT_ID env)
+  --base-url <url>       API base URL (default: https://app.framedash.dev)
+  --format <fmt>         Output format: json, table, csv (default: json)
+  -h, --help             Show help`;
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IAC1C,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QACnE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5D,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;mCASsB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { error, log } from "./lib/logger.js";
+const VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"))
+    .version;
+const HELP = `Usage: framedash <command> [options]
+
+Commands:
+  auth           Verify API key and list projects
+  status         Show project status and key metrics
+  dashboard      Show dashboard metrics
+  retention      Show player retention cohorts
+  funnel         Analyze event funnels
+  query          Execute a read-only ClickHouse query
+  alerts         Manage alert rules (list, create, update, delete)
+  maps           Manage maps (list, delete)
+  content        Manage content registry (list, import, delete)
+  map-capture    Upload captured map images
+
+Global Options:
+  --api-key <key>        API key. Prefer FRAMEDASH_API_KEY env or --api-key-file:
+                         a key passed as --api-key is visible in the process
+                         list and shell history.
+  --api-key-file <path>  Read the API key from a file ('-' for stdin)
+  --project-id <uuid>    Project ID (or FRAMEDASH_PROJECT_ID env)
+  --base-url <url>       API base URL (default: https://app.framedash.dev)
+  --format <fmt>         Output format: json, table, csv (default: json)
+  -h, --help             Show help
+  -v, --version          Show version
+
+Run 'framedash <command> --help' for command-specific options.`;
+/** Type-safe command registry — typos in export names become build-time errors. */
+const COMMANDS = {
+    auth: () => import("./commands/auth.js").then((m) => m.auth),
+    status: () => import("./commands/status.js").then((m) => m.status),
+    dashboard: () => import("./commands/dashboard.js").then((m) => m.dashboard),
+    retention: () => import("./commands/retention.js").then((m) => m.retention),
+    funnel: () => import("./commands/funnel.js").then((m) => m.funnel),
+    query: () => import("./commands/query.js").then((m) => m.query),
+    alerts: () => import("./commands/alerts.js").then((m) => m.alerts),
+    maps: () => import("./commands/maps.js").then((m) => m.maps),
+    content: () => import("./commands/content.js").then((m) => m.content),
+    "map-capture": () => import("./commands/map-capture.js").then((m) => m.mapCaptureCommand),
+};
+const command = process.argv[2];
+const commandArgs = process.argv.slice(3);
+if (command === "-v" || command === "--version") {
+    log(`framedash v${VERSION}`);
+    process.exit(0);
+}
+if (!command || command === "-h" || command === "--help") {
+    log(HELP);
+    process.exit(0);
+}
+try {
+    if (!Object.hasOwn(COMMANDS, command)) {
+        error(`Unknown command: ${command}`);
+        log(HELP);
+        process.exit(1);
+    }
+    // biome-ignore lint/style/noNonNullAssertion: validated by Object.hasOwn above
+    const fn = await COMMANDS[command]();
+    await fn(commandArgs);
+}
+catch (err) {
+    if (err instanceof Error && "code" in err && err.code === "ERR_PARSE_ARGS_UNKNOWN_OPTION") {
+        error(err.message);
+        process.exit(1);
+    }
+    error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/config.d.ts

@@ -0,0 +1,47 @@
+export type OutputFormat = "json" | "table" | "csv";
+export type CliConfig = {
+    apiKey: string;
+    projectId: string;
+    baseUrl: string;
+    format: OutputFormat;
+};
+/**
+ * Resolve the API key, preferring sources that keep it out of the process
+ * argument list: --api-key flag, then --api-key-file (a path, or "-" for stdin),
+ * then the FRAMEDASH_API_KEY env var. Returns undefined if none is set.
+ */
+export declare function resolveApiKey(values: Record<string, unknown>): string | undefined;
+/** Resolve global CLI config from parsed flags and environment variables. */
+export declare function resolveConfig(values: Record<string, unknown>): CliConfig;
+/** Resolve config for commands that don't require --project-id (e.g. auth). */
+export declare function resolveConfigWithoutProject(values: Record<string, unknown>): Omit<CliConfig, "projectId">;
+/** Parse a string flag as a positive integer with a descriptive error. */
+export declare function parsePositiveInt(value: string, flagName: string): number;
+/** Parse a string flag as a non-negative number with a descriptive error. */
+export declare function parseNumber(value: string, flagName: string): number;
+/**
+ * Global parseArgs option definitions shared by all commands.
+ * Spread into each command's parseArgs call.
+ */
+export declare const GLOBAL_OPTIONS: {
+    "api-key": {
+        type: "string";
+    };
+    "api-key-file": {
+        type: "string";
+    };
+    "project-id": {
+        type: "string";
+    };
+    "base-url": {
+        type: "string";
+    };
+    format: {
+        type: "string";
+    };
+    help: {
+        type: "boolean";
+        short: "h";
+    };
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;CACrB,CAAC;AA6BF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CA+BjF;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAgBxE;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAS9B;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOxE;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;CAO1B,CAAC"}