@framedash/cli 0.1.0

package/dist/lib/config.js

@@ -0,0 +1,114 @@
+import { readFileSync } from "node:fs";
+import { assertSafeBaseUrl } from "@framedash/api-client";
+import { error } from "./logger.js";
+function resolveBaseAndFormat(values) {
+    const baseUrl = values["base-url"] ??
+        process.env.FRAMEDASH_BASE_URL ??
+        "https://app.framedash.dev";
+    // The API key is sent on every request; refuse a base URL that would expose
+    // it (http to a non-loopback host, or a poisoned --base-url / FRAMEDASH_BASE_URL).
+    try {
+        assertSafeBaseUrl(baseUrl);
+    }
+    catch (err) {
+        error(err instanceof Error ? err.message : `Invalid base URL: ${baseUrl}`);
+        process.exit(1);
+    }
+    const formatStr = values.format ?? process.env.FRAMEDASH_FORMAT ?? "json";
+    if (formatStr !== "json" && formatStr !== "table" && formatStr !== "csv") {
+        error(`Invalid format: ${formatStr}. Use json, table, or csv.`);
+        process.exit(1);
+    }
+    return { baseUrl, format: formatStr };
+}
+/**
+ * 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 function resolveApiKey(values) {
+    const flag = values["api-key"];
+    if (flag)
+        return flag;
+    const file = values["api-key-file"];
+    if (file) {
+        const label = file === "-" ? "stdin" : file;
+        // readFileSync(0) blocks forever on an interactive TTY; require piped input.
+        if (file === "-" && process.stdin.isTTY) {
+            error("Cannot read the API key from stdin: no piped input (stdin is a terminal)");
+            process.exit(1);
+        }
+        let raw;
+        try {
+            // fd 0 reads piped stdin synchronously (e.g. `... | framedash --api-key-file -`).
+            raw = file === "-" ? readFileSync(0, "utf8") : readFileSync(file, "utf8");
+        }
+        catch (err) {
+            error(`Failed to read --api-key-file (${label}): ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+        const key = raw.trim();
+        if (!key) {
+            error(`--api-key-file (${label}) is empty`);
+            process.exit(1);
+        }
+        return key;
+    }
+    return process.env.FRAMEDASH_API_KEY;
+}
+/** Resolve global CLI config from parsed flags and environment variables. */
+export function resolveConfig(values) {
+    const apiKey = resolveApiKey(values);
+    if (!apiKey) {
+        error("--api-key, --api-key-file, or FRAMEDASH_API_KEY env is required");
+        process.exit(1);
+    }
+    const projectId = values["project-id"] ?? process.env.FRAMEDASH_PROJECT_ID;
+    if (!projectId) {
+        error("--project-id or FRAMEDASH_PROJECT_ID env is required");
+        process.exit(1);
+    }
+    const { baseUrl, format } = resolveBaseAndFormat(values);
+    return { apiKey, projectId, baseUrl, format };
+}
+/** Resolve config for commands that don't require --project-id (e.g. auth). */
+export function resolveConfigWithoutProject(values) {
+    const apiKey = resolveApiKey(values);
+    if (!apiKey) {
+        error("--api-key, --api-key-file, or FRAMEDASH_API_KEY env is required");
+        process.exit(1);
+    }
+    const { baseUrl, format } = resolveBaseAndFormat(values);
+    return { apiKey, baseUrl, format };
+}
+/** Parse a string flag as a positive integer with a descriptive error. */
+export function parsePositiveInt(value, flagName) {
+    const num = Number(value);
+    if (!Number.isInteger(num) || num <= 0) {
+        error(`--${flagName} must be a positive integer, got: ${value}`);
+        process.exit(1);
+    }
+    return num;
+}
+/** Parse a string flag as a non-negative number with a descriptive error. */
+export function parseNumber(value, flagName) {
+    const num = Number(value);
+    if (Number.isNaN(num)) {
+        error(`--${flagName} must be a number, got: ${value}`);
+        process.exit(1);
+    }
+    return num;
+}
+/**
+ * Global parseArgs option definitions shared by all commands.
+ * Spread into each command's parseArgs call.
+ */
+export 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.js.map

package/dist/lib/config.js.map

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

package/dist/lib/create-client.d.ts

@@ -0,0 +1,3 @@
+import { ApiClient } from "@framedash/api-client";
+export declare function createClient(baseUrl: string, apiKey: string, projectId: string): ApiClient;
+//# sourceMappingURL=create-client.d.ts.map

package/dist/lib/create-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../../src/lib/create-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AAGjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAyB1F"}

package/dist/lib/create-client.js

@@ -0,0 +1,30 @@
+import { ApiClient } from "@framedash/api-client";
+import { error } from "./logger.js";
+export function createClient(baseUrl, apiKey, projectId) {
+    return new ApiClient({
+        baseUrl,
+        apiKey,
+        projectId,
+        onError(err) {
+            if (err.status === 429) {
+                const retryAfter = err.retryAfter;
+                if (retryAfter !== undefined) {
+                    error(`Rate limit exceeded (429). Retry after ${retryAfter}s.`);
+                }
+                else {
+                    const reset = err.headers.get("X-RateLimit-Reset");
+                    const resetNum = reset ? Number(reset) : Number.NaN;
+                    const resetStr = !Number.isNaN(resetNum) && resetNum > 0
+                        ? new Date(resetNum * 1000).toLocaleTimeString()
+                        : "unknown";
+                    error(`Rate limit exceeded (429). Resets at ${resetStr}.`);
+                }
+            }
+            else {
+                error(err.message);
+            }
+            process.exit(1);
+        },
+    });
+}
+//# sourceMappingURL=create-client.js.map

package/dist/lib/create-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.js","sourceRoot":"","sources":["../../src/lib/create-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAc,EAAE,SAAiB;IAC9E,OAAO,IAAI,SAAS,CAAC;QACpB,OAAO;QACP,MAAM;QACN,SAAS;QACT,OAAO,CAAC,GAAa;YACpB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACxB,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;gBAClC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC9B,KAAK,CAAC,0CAA0C,UAAU,IAAI,CAAC,CAAC;gBACjE,CAAC;qBAAM,CAAC;oBACP,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;oBACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACpD,MAAM,QAAQ,GACb,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;wBACtC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,kBAAkB,EAAE;wBAChD,CAAC,CAAC,SAAS,CAAC;oBACd,KAAK,CAAC,wCAAwC,QAAQ,GAAG,CAAC,CAAC;gBAC5D,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/formatters.d.ts

@@ -0,0 +1,4 @@
+import type { OutputFormat } from "./config.js";
+/** Format data for CLI output in the requested format. */
+export declare function formatOutput(data: unknown, format: OutputFormat): string;
+//# sourceMappingURL=formatters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/lib/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CASxE"}

package/dist/lib/formatters.js

@@ -0,0 +1,71 @@
+/** Format data for CLI output in the requested format. */
+export function formatOutput(data, format) {
+    switch (format) {
+        case "json":
+            return JSON.stringify(data, null, 2);
+        case "table":
+            return formatTable(data);
+        case "csv":
+            return formatCsv(data);
+    }
+}
+function formatTable(data) {
+    const rows = toRows(data);
+    if (rows.length === 0)
+        return "(no data)";
+    const firstRow = rows[0];
+    if (!firstRow)
+        return "(no data)";
+    const keys = Object.keys(firstRow);
+    const widths = keys.map((k) => Math.max(k.length, ...rows.map((r) => cellString(r[k]).length)));
+    const header = keys.map((k, i) => k.padEnd(widths[i] ?? k.length)).join("  ");
+    const separator = widths.map((w) => "-".repeat(w)).join("  ");
+    const body = rows
+        .map((row) => keys.map((k, i) => cellString(row[k]).padEnd(widths[i] ?? k.length)).join("  "))
+        .join("\n");
+    return `${header}\n${separator}\n${body}`;
+}
+function formatCsv(data) {
+    const rows = toRows(data);
+    if (rows.length === 0)
+        return "";
+    const firstRow = rows[0];
+    if (!firstRow)
+        return "";
+    const keys = Object.keys(firstRow);
+    const header = keys.map(escapeCsv).join(",");
+    const body = rows
+        .map((row) => keys.map((k) => escapeCsv(cellString(row[k]))).join(","))
+        .join("\n");
+    return `${header}\n${body}`;
+}
+/** Convert a cell value to a string for tabular output, JSON-encoding nested objects/arrays. */
+function cellString(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "object")
+        return JSON.stringify(value);
+    return String(value);
+}
+function escapeCsv(value) {
+    // Prevent CSV formula injection (OWASP) — also catch whitespace-prefixed formulas
+    const trimmed = value.trimStart();
+    if (trimmed.length > 0 && /^[=+\-@]/.test(trimmed)) {
+        value = `'${value}`;
+    }
+    if (value.includes(",") || value.includes('"') || value.includes("\n") || value.includes("\r")) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+function toRows(data) {
+    if (Array.isArray(data)) {
+        return data.map((item) => typeof item === "object" && item !== null
+            ? item
+            : { value: item });
+    }
+    if (typeof data === "object" && data !== null)
+        return [data];
+    return [{ value: data }];
+}
+//# sourceMappingURL=formatters.js.map

package/dist/lib/formatters.js.map

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

package/dist/lib/logger.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Simple logging helpers for CLI output.
+ * Data goes to stdout (log), status messages go to stderr (success/error).
+ * This lets users pipe structured output to jq/csvtool while still seeing messages.
+ */
+export declare function log(message: string): void;
+export declare function success(message: string): void;
+export declare function error(message: string): void;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C"}

package/dist/lib/logger.js

@@ -0,0 +1,15 @@
+/**
+ * Simple logging helpers for CLI output.
+ * Data goes to stdout (log), status messages go to stderr (success/error).
+ * This lets users pipe structured output to jq/csvtool while still seeing messages.
+ */
+export function log(message) {
+    process.stdout.write(`${message}\n`);
+}
+export function success(message) {
+    process.stderr.write(`  \u2713 ${message}\n`);
+}
+export function error(message) {
+    process.stderr.write(`  \u2717 ${message}\n`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,GAAG,CAAC,OAAe;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/metadata.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+/**
+ * Zod schema for the JSON sidecar metadata file produced by
+ * engine capture scripts (UE5 Commandlet / Unity EditorScript).
+ *
+ * Matches brief-tech.md Section 8.4 format.
+ */
+export declare const mapCaptureMetadataSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    map_id: z.ZodString;
+    image_path: z.ZodString;
+    image_dimensions: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>;
+    world_bounds: z.ZodObject<{
+        min: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            z: z.ZodNumber;
+        }, z.core.$strip>;
+        max: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            z: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    projection: z.ZodOptional<z.ZodString>;
+    capture_axis: z.ZodOptional<z.ZodString>;
+    coordinate_system: z.ZodOptional<z.ZodString>;
+    engine: z.ZodOptional<z.ZodString>;
+    build_id: z.ZodOptional<z.ZodString>;
+    captured_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MapCaptureMetadata = z.infer<typeof mapCaptureMetadataSchema>;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/lib/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/lib/metadata.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+// Canonical source: ingest-core/src/config.ts MAX_MAP_ID_LEN
+const MAX_MAP_ID_LEN = 128;
+const dimensionsSchema = z.object({
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+});
+const vector3Schema = z.object({
+    x: z.number().finite(),
+    y: z.number().finite(),
+    z: z.number().finite(),
+});
+const worldBoundsSchema = z
+    .object({
+    min: vector3Schema,
+    max: vector3Schema,
+})
+    .refine((b) => b.max.x > b.min.x && b.max.y > b.min.y, {
+    message: "World max bounds must be greater than min bounds",
+});
+/**
+ * Zod schema for the JSON sidecar metadata file produced by
+ * engine capture scripts (UE5 Commandlet / Unity EditorScript).
+ *
+ * Matches brief-tech.md Section 8.4 format.
+ */
+export const mapCaptureMetadataSchema = z.object({
+    version: z.literal("1.0"),
+    map_id: z.string().min(1).max(MAX_MAP_ID_LEN),
+    image_path: z.string().min(1),
+    image_dimensions: dimensionsSchema,
+    world_bounds: worldBoundsSchema,
+    projection: z.string().optional(),
+    capture_axis: z.string().optional(),
+    coordinate_system: z.string().optional(),
+    engine: z.string().optional(),
+    build_id: z.string().max(255).optional(),
+    captured_at: z.string().datetime().optional(),
+});
+//# sourceMappingURL=metadata.js.map

package/dist/lib/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/lib/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6DAA6D;AAC7D,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IACtB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IACtB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC;KACzB,MAAM,CAAC;IACP,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,aAAa;CAClB,CAAC;KACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE;IACtD,OAAO,EAAE,kDAAkD;CAC3D,CAAC,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB;IAClC,YAAY,EAAE,iBAAiB;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC"}

package/dist/lib/run-command.d.ts

@@ -0,0 +1,28 @@
+import { type ParseArgsConfig } from "node:util";
+import type { ApiClient } from "@framedash/api-client";
+import { type CliConfig } from "./config.js";
+export type CommandOptions = {
+    args: string[];
+    help: string;
+    options?: ParseArgsConfig["options"];
+    allowPositionals?: boolean;
+    noProject?: boolean;
+};
+export type CommandContext = {
+    config: CliConfig;
+    client: ApiClient;
+    values: Record<string, string | boolean | undefined>;
+    positionals: string[];
+};
+/**
+ * Shared command runner that handles parseArgs, help, config resolution,
+ * and client creation. Commands only need to supply their specific logic.
+ */
+export declare function runCommand(opts: CommandOptions, handler: (ctx: CommandContext) => Promise<void>): Promise<void>;
+export type SubcommandMap = Record<string, (args: string[]) => Promise<void>>;
+/**
+ * Create a subcommand dispatcher that handles help display and
+ * routes to the correct handler based on the first positional arg.
+ */
+export declare function withSubcommands(name: string, help: string, subcommands: SubcommandMap): (args: string[]) => Promise<void>;
+//# sourceMappingURL=run-command.d.ts.map

package/dist/lib/run-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/lib/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAa,MAAM,WAAW,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACN,KAAK,SAAS,EAId,MAAM,aAAa,CAAC;AAIrB,MAAM,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,aAAa,GACxB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAmBnC"}

package/dist/lib/run-command.js

@@ -0,0 +1,53 @@
+import { parseArgs } from "node:util";
+import { GLOBAL_OPTIONS, resolveConfig, resolveConfigWithoutProject, } from "./config.js";
+import { createClient } from "./create-client.js";
+import { error, log } from "./logger.js";
+/**
+ * Shared command runner that handles parseArgs, help, config resolution,
+ * and client creation. Commands only need to supply their specific logic.
+ */
+export async function runCommand(opts, handler) {
+    const { values, positionals } = parseArgs({
+        args: opts.args,
+        options: { ...GLOBAL_OPTIONS, ...opts.options },
+        allowPositionals: opts.allowPositionals ?? false,
+    });
+    if (values.help) {
+        log(opts.help);
+        return;
+    }
+    const typedValues = values;
+    if (opts.noProject) {
+        const baseConfig = resolveConfigWithoutProject(typedValues);
+        const config = { ...baseConfig, projectId: "" };
+        const client = createClient(config.baseUrl, config.apiKey, "");
+        await handler({ config, client, values: typedValues, positionals });
+    }
+    else {
+        const config = resolveConfig(typedValues);
+        const client = createClient(config.baseUrl, config.apiKey, config.projectId);
+        await handler({ config, client, values: typedValues, positionals });
+    }
+}
+/**
+ * Create a subcommand dispatcher that handles help display and
+ * routes to the correct handler based on the first positional arg.
+ */
+export function withSubcommands(name, help, subcommands) {
+    return async (args) => {
+        const subcommand = args[0];
+        if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+            log(help);
+            return;
+        }
+        if (!Object.hasOwn(subcommands, subcommand)) {
+            error(`Unknown ${name} subcommand: ${subcommand}`);
+            log(help);
+            process.exit(1);
+            return;
+        }
+        // biome-ignore lint/style/noNonNullAssertion: validated by Object.hasOwn above
+        await subcommands[subcommand](args.slice(1));
+    };
+}
+//# sourceMappingURL=run-command.js.map

package/dist/lib/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/lib/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,SAAS,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EAEN,cAAc,EACd,aAAa,EACb,2BAA2B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAiBzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,IAAoB,EACpB,OAA+C;IAE/C,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACzC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;QAC/C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,KAAK;KAChD,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,OAAO;IACR,CAAC;IAED,MAAM,WAAW,GAAG,MAAsD,CAAC;IAE3E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,2BAA2B,CAAC,WAAW,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAc,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACP,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7E,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;AACF,CAAC;AAID;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC9B,IAAY,EACZ,IAAY,EACZ,WAA0B;IAE1B,OAAO,KAAK,EAAE,IAAc,EAAiB,EAAE;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACnE,GAAG,CAAC,IAAI,CAAC,CAAC;YACV,OAAO;QACR,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;YAC7C,KAAK,CAAC,WAAW,IAAI,gBAAgB,UAAU,EAAE,CAAC,CAAC;YACnD,GAAG,CAAC,IAAI,CAAC,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO;QACR,CAAC;QAED,+EAA+E;QAC/E,MAAM,WAAW,CAAC,UAAU,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC;AACH,CAAC"}

package/dist/lib/uploader.d.ts

@@ -0,0 +1,19 @@
+import type { MapCaptureMetadata } from "./metadata.js";
+export type UploadOptions = {
+    metadata: MapCaptureMetadata;
+    imagePath: string;
+    apiKey: string;
+    projectId: string;
+    baseUrl: string;
+};
+export type UploadResult = {
+    success: boolean;
+    mapId: string;
+    action: "created" | "updated";
+};
+/**
+ * Upload a map image + metadata to the Framedash API.
+ * Sends multipart/form-data to POST /api/v1/maps/upload.
+ */
+export declare function uploadMapCapture(opts: UploadOptions): Promise<UploadResult>;
+//# sourceMappingURL=uploader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uploader.d.ts","sourceRoot":"","sources":["../../src/lib/uploader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAYxD,MAAM,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoDjF"}

package/dist/lib/uploader.js

@@ -0,0 +1,61 @@
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
+import { assertSafeBaseUrl } from "@framedash/api-client";
+/** Upload timeout: generous vs the JSON client since it streams an image blob. */
+const UPLOAD_TIMEOUT_MS = 120_000;
+const MIME_MAP = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+};
+/**
+ * Upload a map image + metadata to the Framedash API.
+ * Sends multipart/form-data to POST /api/v1/maps/upload.
+ */
+export async function uploadMapCapture(opts) {
+    assertSafeBaseUrl(opts.baseUrl);
+    const imageBuffer = await readFile(opts.imagePath);
+    const ext = extname(opts.imagePath).toLowerCase();
+    const mimeType = MIME_MAP[ext];
+    if (!mimeType) {
+        throw new Error(`Unsupported image format: ${ext}`);
+    }
+    const formData = new FormData();
+    formData.set("mapId", opts.metadata.map_id);
+    formData.set("name", opts.metadata.map_id);
+    formData.set("worldMinX", String(opts.metadata.world_bounds.min.x));
+    formData.set("worldMinY", String(opts.metadata.world_bounds.min.y));
+    formData.set("worldMaxX", String(opts.metadata.world_bounds.max.x));
+    formData.set("worldMaxY", String(opts.metadata.world_bounds.max.y));
+    formData.set("imageWidth", String(opts.metadata.image_dimensions.width));
+    formData.set("imageHeight", String(opts.metadata.image_dimensions.height));
+    const blob = new Blob([imageBuffer], { type: mimeType });
+    formData.set("image", blob, basename(opts.imagePath));
+    // Trim trailing slashes (as ApiClient does) so a base URL like
+    // "https://host/" does not produce "https://host//api/..." -- the app would
+    // 308-redirect the double slash, which redirect:"manual" below now rejects.
+    const base = opts.baseUrl.replace(/\/+$/, "");
+    const url = `${base}/api/v1/maps/upload`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "X-API-Key": opts.apiKey,
+            "X-Project-Id": opts.projectId,
+        },
+        body: formData,
+        redirect: "manual",
+        signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS),
+    });
+    // Do not follow a redirect: fetch would re-send the X-API-Key header to the
+    // redirect target (undici keeps custom headers across cross-origin redirects).
+    if (response.type === "opaqueredirect" || (response.status >= 300 && response.status < 400)) {
+        throw new Error(`Upload failed: unexpected redirect (status ${response.status || "opaque"}); refusing to resend credentials to the redirect target`);
+    }
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Upload failed (${response.status}): ${body}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=uploader.js.map

package/dist/lib/uploader.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@framedash/cli",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "framedash": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "zod": "^4.3.6",
+    "@framedash/api-client": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.0",
+    "@vitest/coverage-v8": "^3.2.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist"
+  }
+}