@framedash/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Crane Valley LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @framedash/cli
+
+Framedash CLI tool for CI/CD pipelines, analytics queries, and coding agent integration.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `framedash auth` | Authenticate with API key |
+| `framedash query` | Run SQL analytics queries against ClickHouse |
+| `framedash dashboard` | Fetch dashboard KPI summary |
+| `framedash retention` | Fetch retention cohort data |
+| `framedash funnel` | Fetch funnel conversion data |
+| `framedash alerts` | Manage alert rules and channels |
+| `framedash maps` | List and manage map overlays |
+| `framedash content` | Manage content registry entries |
+| `framedash status` | Check project ingestion status |
+| `framedash map-capture` | Upload captured map images |
+
+## Environment
+
+API commands require an API key from `--api-key-file` (which supports `-` for
+piped stdin), `--api-key`, or `FRAMEDASH_API_KEY`. Prefer files or piped stdin
+over `--api-key` for local runs so raw keys do not appear in shell history.
+
+Project-scoped commands such as `dashboard` also require a project ID from
+`--project-id` or `FRAMEDASH_PROJECT_ID`. The `auth` command only requires an
+API key.
+
+For the local examples below, keep the API key in `../../framedash.key` and set
+`FRAMEDASH_PROJECT_ID` to the target project UUID before running project-scoped
+commands.
+
+```bash
+export FRAMEDASH_PROJECT_ID="<project-uuid>"
+```
+
+## Usage
+
+Build the CLI workspace and its dependencies from the repository root:
+
+```bash
+pnpm --filter @framedash/cli... build
+```
+
+After completing the Environment setup, run these commands from `packages/cli`:
+
+```bash
+cd packages/cli
+
+node . --help
+node . auth --api-key-file ../../framedash.key
+cat ../../framedash.key | node . auth --api-key-file -
+node . dashboard --api-key-file ../../framedash.key --format json
+node . dashboard --api-key-file ../../framedash.key --format table
+node . dashboard --api-key-file ../../framedash.key --format csv
+```
+
+## Development
+
+Run these commands from `packages/cli`:
+
+```bash
+pnpm build      # Compile TypeScript
+pnpm test       # Run tests
+pnpm type-check # Type check
+```

package/dist/commands/alerts.d.ts

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

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

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

package/dist/commands/alerts.js

@@ -0,0 +1,171 @@
+import { parseNumber, parsePositiveInt } from "../lib/config.js";
+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 alerts <subcommand> [options]
+
+Manage alert rules.
+
+Subcommands:
+  list                   List alert rules
+  create                 Create a new alert rule
+  update <id>            Update an alert rule
+  delete <id>            Delete an alert rule
+
+Run 'framedash alerts <subcommand> --help' for more info.`;
+const CREATE_HELP = `Usage: framedash alerts create [options]
+
+Create a new alert rule.
+
+Required:
+  --name <name>                    Alert rule name
+  --map-id <uuid>                  Map ID
+  --threshold-profile-id <uuid>    Threshold profile ID
+  --metric <metric>                Metric name
+  --threshold-level <level>        Threshold level
+  --fail-percentage <n>            Failure percentage (0-100)
+  --evaluation-days <n>            Evaluation period in days
+  --cell-size <n>                  Cell size
+  --cooldown-minutes <n>           Cooldown period in minutes
+
+Optional:
+  --channel-ids <id1,id2,...>      Notification channel IDs (comma-separated)`;
+export const alerts = withSubcommands("alerts", HELP, {
+    list: alertsList,
+    create: alertsCreate,
+    update: alertsUpdate,
+    delete: alertsDelete,
+});
+async function alertsList(args) {
+    await runCommand({ args, help: "Usage: framedash alerts list [--format json|table|csv] [global options]" }, async ({ client, config }) => {
+        const data = await client.get(client.projectPath("alerts"));
+        log(formatOutput(data, config.format));
+    });
+}
+async function alertsCreate(args) {
+    await runCommand({
+        args,
+        help: CREATE_HELP,
+        options: {
+            name: { type: "string" },
+            "map-id": { type: "string" },
+            "threshold-profile-id": { type: "string" },
+            metric: { type: "string" },
+            "threshold-level": { type: "string" },
+            "fail-percentage": { type: "string" },
+            "evaluation-days": { type: "string" },
+            "cell-size": { type: "string" },
+            "cooldown-minutes": { type: "string" },
+            "channel-ids": { type: "string" },
+        },
+    }, async ({ client, config, values }) => {
+        const required = [
+            "name",
+            "map-id",
+            "threshold-profile-id",
+            "metric",
+            "threshold-level",
+            "fail-percentage",
+            "evaluation-days",
+            "cell-size",
+            "cooldown-minutes",
+        ];
+        for (const flag of required) {
+            if (!values[flag]) {
+                error(`--${flag} is required`);
+                process.exit(1);
+            }
+        }
+        const body = {
+            name: values.name,
+            mapId: values["map-id"],
+            thresholdProfileId: values["threshold-profile-id"],
+            metric: values.metric,
+            thresholdLevel: values["threshold-level"],
+            failPercentage: parseNumber(values["fail-percentage"], "fail-percentage"),
+            evaluationDays: parsePositiveInt(values["evaluation-days"], "evaluation-days"),
+            cellSize: parsePositiveInt(values["cell-size"], "cell-size"),
+            cooldownMinutes: parsePositiveInt(values["cooldown-minutes"], "cooldown-minutes"),
+        };
+        if (values["channel-ids"]) {
+            body.channelIds = parseChannelIds(values["channel-ids"]);
+        }
+        const data = await client.post(client.projectPath("alerts"), body);
+        success("Alert rule created");
+        log(formatOutput(data, config.format));
+    });
+}
+async function alertsUpdate(args) {
+    await runCommand({
+        args,
+        help: "Usage: framedash alerts update <alert-id> [--name ...] [--is-active true|false] [--channel-ids id1,id2]",
+        options: {
+            name: { type: "string" },
+            "is-active": { type: "string" },
+            "channel-ids": { type: "string" },
+            "fail-percentage": { type: "string" },
+            "evaluation-days": { type: "string" },
+            "cooldown-minutes": { type: "string" },
+        },
+        allowPositionals: true,
+    }, async ({ client, config, values, positionals }) => {
+        const alertId = positionals[0];
+        if (!alertId) {
+            error("Alert ID is required: framedash alerts update <alert-id>");
+            process.exit(1);
+        }
+        const body = {};
+        if (values.name)
+            body.name = values.name;
+        if (values["is-active"]) {
+            const v = values["is-active"];
+            if (v !== "true" && v !== "false") {
+                error(`--is-active must be "true" or "false", got: ${v}`);
+                process.exit(1);
+            }
+            body.isActive = v === "true";
+        }
+        if (values["channel-ids"])
+            body.channelIds = parseChannelIds(values["channel-ids"]);
+        if (values["fail-percentage"])
+            body.failPercentage = parseNumber(values["fail-percentage"], "fail-percentage");
+        if (values["evaluation-days"])
+            body.evaluationDays = parsePositiveInt(values["evaluation-days"], "evaluation-days");
+        if (values["cooldown-minutes"])
+            body.cooldownMinutes = parsePositiveInt(values["cooldown-minutes"], "cooldown-minutes");
+        if (Object.keys(body).length === 0) {
+            error("At least one field to update is required");
+            process.exit(1);
+        }
+        const data = await client.patch(client.projectPath(`alerts/${encodeURIComponent(alertId)}`), body);
+        success("Alert rule updated");
+        log(formatOutput(data, config.format));
+    });
+}
+async function alertsDelete(args) {
+    await runCommand({
+        args,
+        help: "Usage: framedash alerts delete <alert-id> [global options]",
+        allowPositionals: true,
+    }, async ({ client, positionals }) => {
+        const alertId = positionals[0];
+        if (!alertId) {
+            error("Alert ID is required: framedash alerts delete <alert-id>");
+            process.exit(1);
+        }
+        await client.delete(client.projectPath(`alerts/${encodeURIComponent(alertId)}`));
+        success(`Alert rule ${alertId} deleted`);
+    });
+}
+function parseChannelIds(raw) {
+    const ids = raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (ids.length === 0) {
+        error("--channel-ids must contain at least one ID");
+        process.exit(1);
+    }
+    return ids;
+}
+//# sourceMappingURL=alerts.js.map

package/dist/commands/alerts.js.map

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

package/dist/commands/auth.d.ts

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

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

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

package/dist/commands/auth.js

@@ -0,0 +1,20 @@
+import { formatOutput } from "../lib/formatters.js";
+import { log, success } from "../lib/logger.js";
+import { runCommand } from "../lib/run-command.js";
+export async function auth(args) {
+    await runCommand({ args, help: HELP, noProject: true }, async ({ client, config }) => {
+        const projects = await client.get("/api/v1/projects");
+        success("API key is valid");
+        log(formatOutput(projects, config.format));
+    });
+}
+const HELP = `Usage: framedash auth [options]
+
+Verify your API key and show the project bound to it.
+
+Options:
+  --api-key <key>        API key (or FRAMEDASH_API_KEY 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=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACxC,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QACpF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAiC,kBAAkB,CAAC,CAAC;QACtF,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC5B,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;mCAQsB,CAAC"}

package/dist/commands/content.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/commands/content.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,OAAO,mCAIlB,CAAC"}

package/dist/commands/content.js

@@ -0,0 +1,104 @@
+import { readFile } from "node:fs/promises";
+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 content <subcommand> [options]
+
+Manage content registry entries.
+
+Subcommands:
+  list                   List content entries
+  import <file.json>     Import content entries from JSON
+  delete <id>            Delete by UUID, or use --type + --content-id
+
+Run 'framedash content <subcommand> --help' for more info.`;
+const DELETE_HELP = `Usage: framedash content delete <uuid> [global options]
+       framedash content delete --type <type> --content-id <id> [global options]
+
+Delete a content entry by UUID or by type + content ID pair.`;
+export const content = withSubcommands("content", HELP, {
+    list: contentList,
+    import: contentImport,
+    delete: contentDelete,
+});
+async function contentList(args) {
+    await runCommand({
+        args,
+        help: "Usage: framedash content list [--type <content-type>] [--format json|table|csv] [global options]",
+        options: { type: { type: "string" } },
+    }, async ({ client, config, values }) => {
+        const params = values.type ? `?${new URLSearchParams({ type: values.type })}` : "";
+        const data = await client.get(`/api/v1/content${params}`);
+        log(formatOutput(data, config.format));
+    });
+}
+async function contentImport(args) {
+    await runCommand({
+        args,
+        help: "Usage: framedash content import <file.json> [global options]",
+        allowPositionals: true,
+    }, async ({ client, config, positionals }) => {
+        const filePath = positionals[0];
+        if (!filePath) {
+            error("JSON file path is required: framedash content import <file.json>");
+            process.exit(1);
+        }
+        let raw;
+        try {
+            raw = await readFile(filePath, "utf-8");
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : "unknown error";
+            error(`Failed to read file: ${filePath} (${msg})`);
+            process.exit(1);
+        }
+        let entries;
+        try {
+            entries = JSON.parse(raw);
+        }
+        catch {
+            error("Invalid JSON file");
+            process.exit(1);
+        }
+        // Accept both { entries: [...] } and plain [...]
+        const payload = Array.isArray(entries) ? { entries } : entries;
+        const data = await client.post("/api/v1/content", payload);
+        success("Content imported");
+        log(formatOutput(data, config.format));
+    });
+}
+async function contentDelete(args) {
+    await runCommand({
+        args,
+        help: DELETE_HELP,
+        options: {
+            type: { type: "string" },
+            "content-id": { type: "string" },
+        },
+        allowPositionals: true,
+    }, async ({ client, values, positionals }) => {
+        const id = positionals[0];
+        if (id && (values.type || values["content-id"])) {
+            error("Cannot combine <uuid> with --type/--content-id. Choose one mode.");
+            process.exit(1);
+        }
+        if (id) {
+            const params = new URLSearchParams({ id });
+            await client.delete(`/api/v1/content?${params}`);
+            success(`Content entry ${id} deleted`);
+        }
+        else if (values.type && values["content-id"]) {
+            const params = new URLSearchParams({
+                contentType: values.type,
+                contentId: values["content-id"],
+            });
+            await client.delete(`/api/v1/content?${params}`);
+            success("Content entry deleted");
+        }
+        else {
+            error("Provide <uuid> or both --type and --content-id");
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=content.js.map

package/dist/commands/content.js.map

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

package/dist/commands/dashboard.d.ts

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

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

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

package/dist/commands/dashboard.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 dashboard(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(`dashboard?${params}`));
+        log(formatOutput(data, config.format));
+    });
+}
+const HELP = `Usage: framedash dashboard [options]
+
+Show project dashboard metrics.
+
+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=dashboard.js.map

package/dist/commands/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/commands/dashboard.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/funnel.d.ts

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

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

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

package/dist/commands/funnel.js

@@ -0,0 +1,43 @@
+import { formatOutput } from "../lib/formatters.js";
+import { error, log } from "../lib/logger.js";
+import { runCommand } from "../lib/run-command.js";
+export async function funnel(args) {
+    await runCommand({
+        args,
+        help: HELP,
+        options: {
+            steps: { type: "string" },
+            days: { type: "string" },
+            window: { type: "string" },
+        },
+    }, async ({ client, config, values }) => {
+        if (!values.steps) {
+            error('--steps is required (comma-separated event names, e.g. "login,tutorial,purchase")');
+            process.exit(1);
+        }
+        const params = new URLSearchParams();
+        params.set("steps", values.steps);
+        if (values.days)
+            params.set("days", values.days);
+        if (values.window)
+            params.set("window", values.window);
+        const data = await client.get(client.projectPath(`funnels?${params}`));
+        log(formatOutput(data, config.format));
+    });
+}
+const HELP = `Usage: framedash funnel [options]
+
+Analyze event funnels.
+
+Required:
+  --steps <events>       Comma-separated event names (2-8 steps)
+
+Options:
+  --days <n>             Time period in days: 1, 7, 14, 30 (default: 30)
+  --window <seconds>     Conversion window: 3600, 21600, 86400, 604800 (default: 86400)
+  --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=funnel.js.map

package/dist/commands/funnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.js","sourceRoot":"","sources":["../../src/commands/funnel.ts"],"names":[],"mappings":"AAAA,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,MAAM,CAAC,IAAc;IAC1C,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;YACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;KACD,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;QACpC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACnB,KAAK,CAAC,mFAAmF,CAAC,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAe,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAc,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAgB,CAAC,CAAC;QAEjE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC,CACD,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;;;;;;mCAcsB,CAAC"}

package/dist/commands/map-capture.d.ts

@@ -0,0 +1,17 @@
+/** CLI entry point for map-capture — parses args then delegates to mapCapture(). */
+export declare function mapCaptureCommand(args: string[]): Promise<void>;
+export type MapCaptureOptions = {
+    inputDir: string | undefined;
+    upload: boolean | undefined;
+    dryRun: boolean | undefined;
+    apiKey: string | undefined;
+    projectId: string | undefined;
+    baseUrl: string | undefined;
+};
+export type MapCaptureResult = {
+    ok: boolean;
+    successCount: number;
+    errorCount: number;
+};
+export declare function mapCapture(opts: MapCaptureOptions): Promise<MapCaptureResult>;
+//# sourceMappingURL=map-capture.d.ts.map

package/dist/commands/map-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-capture.d.ts","sourceRoot":"","sources":["../../src/commands/map-capture.ts"],"names":[],"mappings":"AAyCA,oFAAoF;AACpF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCrE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+InF"}