@iterable/cli 0.1.0

package/dist/parser.js

@@ -0,0 +1,281 @@
+import { z } from "zod";
+import { parser } from "zod-opts";
+import { ValidationError } from "./errors.js";
+function unwrapSchema(schema) {
+    if (schema instanceof z.ZodOptional)
+        return unwrapSchema(schema.unwrap());
+    if (schema instanceof z.ZodNullable)
+        return unwrapSchema(schema.unwrap());
+    if (schema instanceof z.ZodDefault)
+        return unwrapSchema(schema.unwrap());
+    return schema;
+}
+function getSchemaShape(schema) {
+    const inner = unwrapSchema(schema);
+    if (inner instanceof z.ZodObject) {
+        return inner.shape;
+    }
+    return {};
+}
+function canZodOptsHandle(fieldSchema) {
+    try {
+        parser()
+            .options({ _probe: { type: fieldSchema.optional() } })
+            .parse([]);
+        return true;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return !msg.includes("Unsupported zod type");
+    }
+}
+// Only return scalar defaults for display in --help and COMMANDS.md.
+// Complex defaults (objects, arrays) are omitted since those fields are
+// rendered as JSON fallback inputs where showing a default isn't useful.
+function getDefaultValue(schema) {
+    if (schema instanceof z.ZodDefault) {
+        try {
+            const val = schema.parse(undefined);
+            if (typeof val === "string" ||
+                typeof val === "number" ||
+                typeof val === "boolean") {
+                return val;
+            }
+            return undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+function isOptionalField(schema) {
+    return (schema instanceof z.ZodOptional || getDefaultValue(schema) !== undefined);
+}
+function getZodTypeName(schema) {
+    const inner = unwrapSchema(schema);
+    if (inner instanceof z.ZodString)
+        return "string";
+    if (inner instanceof z.ZodNumber)
+        return "number";
+    if (inner instanceof z.ZodBoolean)
+        return "boolean";
+    if (inner instanceof z.ZodEnum)
+        return "enum";
+    if (inner instanceof z.ZodArray) {
+        return `${getZodTypeName(inner.element)}[]`;
+    }
+    if (inner instanceof z.ZodRecord)
+        return "json";
+    if (Object.keys(getSchemaShape(schema)).length > 0)
+        return "json";
+    return "string";
+}
+function getEnumValues(schema) {
+    const inner = unwrapSchema(schema);
+    if (inner instanceof z.ZodEnum)
+        return inner.options;
+    return undefined;
+}
+function getDescription(schema) {
+    return schema.description ?? "";
+}
+/** Describe all fields of a command — single source of truth for --help and COMMANDS.md. */
+export function describeCommand(cmd) {
+    const shape = getSchemaShape(cmd.schema);
+    const positionalFieldSet = new Set(cmd.positionalArgs ?? []);
+    const transformFieldSet = new Set(Object.keys(cmd.cliTransforms ?? {}));
+    const fields = [];
+    for (const [, transform] of Object.entries(cmd.cliTransforms ?? {})) {
+        for (const [cliName, cliType] of Object.entries(transform.cliFields)) {
+            fields.push({
+                name: cliName,
+                type: getZodTypeName(cliType),
+                required: !isOptionalField(cliType),
+                description: getDescription(cliType),
+                defaultValue: getDefaultValue(cliType),
+                isPositional: false,
+                isJsonFallback: false,
+                isTransform: true,
+                enumValues: getEnumValues(cliType),
+            });
+        }
+    }
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        if (transformFieldSet.has(key))
+            continue;
+        const nativeSupport = canZodOptsHandle(fieldSchema);
+        const desc = getDescription(fieldSchema);
+        const objectKeys = Object.keys(getSchemaShape(fieldSchema));
+        fields.push({
+            name: key,
+            type: getZodTypeName(fieldSchema),
+            required: !isOptionalField(fieldSchema),
+            description: !nativeSupport && objectKeys.length > 0
+                ? `${desc} (JSON: {${objectKeys.join(", ")}})`
+                : desc,
+            defaultValue: getDefaultValue(fieldSchema),
+            isPositional: positionalFieldSet.has(key),
+            isJsonFallback: !nativeSupport,
+            isTransform: false,
+            enumValues: getEnumValues(fieldSchema),
+            objectKeys: objectKeys.length > 0 ? objectKeys : undefined,
+        });
+    }
+    // Auto-detect positional: if no explicit positionalArgs and exactly one
+    // required non-json non-transform scalar field, mark it as positional
+    const hasExplicitPositional = (cmd.positionalArgs ?? []).length > 0;
+    if (!hasExplicitPositional) {
+        const requiredScalars = fields.filter((f) => f.required && !f.isTransform && !f.isJsonFallback && f.type !== "json");
+        if (requiredScalars.length === 1 && requiredScalars[0]) {
+            requiredScalars[0].isPositional = true;
+        }
+    }
+    // Sort: required first, then alphabetical
+    fields.sort((a, b) => {
+        if (a.required !== b.required)
+            return a.required ? -1 : 1;
+        return a.name.localeCompare(b.name);
+    });
+    return fields;
+}
+/** Build a zod-opts parser from describeCommand metadata. */
+export function buildParser(schema, commandName, positionalArgs, cliTransforms) {
+    const shape = getSchemaShape(schema);
+    const cmd = {
+        schema,
+        positionalArgs,
+        cliTransforms,
+    };
+    const fields = describeCommand(cmd);
+    const options = {};
+    const jsonFallbackFields = [];
+    for (const field of fields) {
+        if (field.isPositional)
+            continue;
+        if (field.isTransform) {
+            for (const transform of Object.values(cliTransforms ?? {})) {
+                if (field.name in transform.cliFields) {
+                    const cliType = transform.cliFields[field.name];
+                    if (cliType)
+                        options[field.name] = { type: cliType };
+                    break;
+                }
+            }
+        }
+        else if (field.isJsonFallback) {
+            options[field.name] = {
+                type: z
+                    .string()
+                    .optional()
+                    .describe(field.description || "JSON value"),
+            };
+            jsonFallbackFields.push(field.name);
+        }
+        else {
+            const fieldSchema = shape[field.name];
+            if (fieldSchema) {
+                options[field.name] = { type: fieldSchema };
+            }
+        }
+    }
+    options["json"] = {
+        type: z
+            .string()
+            .optional()
+            .describe("Raw JSON input — bypasses all other flags (use '-' for stdin)"),
+    };
+    let p = parser().name(commandName).options(options);
+    const positionalFields = fields.filter((f) => f.isPositional);
+    if (positionalFields.length > 0) {
+        const args = positionalFields.map((f) => ({
+            name: f.name,
+            type: shape[f.name] ?? z.string(),
+        }));
+        p = p.args(args);
+    }
+    return {
+        parse: (argv) => p.parse(argv),
+        showHelp: () => {
+            p.parse(["--help"]);
+        },
+        jsonFallbackFields,
+    };
+}
+async function readStdin() {
+    if (process.stdin.isTTY) {
+        console.error(
+        // eslint-disable-line no-console
+        "Reading JSON from stdin (press Ctrl+D when done, Ctrl+C to cancel)...");
+    }
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            reject(new Error("Timed out waiting for stdin input (30s)"));
+        }, 30000);
+        let data = "";
+        process.stdin.setEncoding("utf-8");
+        process.stdin.on("data", (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on("end", () => {
+            clearTimeout(timeout);
+            resolve(data);
+        });
+        process.stdin.on("error", (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        });
+    });
+}
+export async function parseCommand(schema, commandName, argv, positionalArgs, cliTransforms) {
+    const jsonIdx = argv.indexOf("--json");
+    if (jsonIdx !== -1) {
+        const jsonValue = argv[jsonIdx + 1];
+        if (!jsonValue || jsonValue.startsWith("--")) {
+            throw new ValidationError("--json requires a value (JSON string or '-' for stdin)");
+        }
+        const rawInput = jsonValue === "-" ? await readStdin() : jsonValue;
+        try {
+            return schema.parse(JSON.parse(rawInput));
+        }
+        catch (e) {
+            if (e instanceof SyntaxError) {
+                throw new ValidationError(`Invalid JSON: ${e.message}`);
+            }
+            throw e;
+        }
+    }
+    const built = buildParser(schema, commandName, positionalArgs, cliTransforms);
+    const result = built.parse(argv);
+    const { json: _json, ...rawParams } = result;
+    const params = {};
+    const mutableRawParams = { ...rawParams };
+    for (const [fieldName, transform] of Object.entries(cliTransforms ?? {})) {
+        const values = {};
+        for (const cliName of Object.keys(transform.cliFields)) {
+            values[cliName] = mutableRawParams[cliName];
+            delete mutableRawParams[cliName]; // eslint-disable-line @typescript-eslint/no-dynamic-delete
+        }
+        const transformed = transform.toParam(values);
+        if (transformed !== undefined) {
+            params[fieldName] = transformed;
+        }
+    }
+    for (const [key, value] of Object.entries(mutableRawParams)) {
+        if (value === undefined)
+            continue;
+        if (built.jsonFallbackFields.includes(key) && typeof value === "string") {
+            try {
+                params[key] = JSON.parse(value);
+            }
+            catch (e) {
+                throw new ValidationError(`Invalid JSON for --${key}: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        else {
+            params[key] = value;
+        }
+    }
+    return schema.parse(params);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,20 @@
+import { findCommand } from "./commands/registry.js";
+import { type OutputFormat } from "./output.js";
+export interface GlobalFlags {
+    help: boolean;
+    version: boolean;
+    output?: OutputFormat;
+    columns?: string[];
+}
+export interface ParsedArgs {
+    category: string | null;
+    action: string | null;
+    rest: string[];
+    globalFlags: GlobalFlags;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function showVersion(): void;
+export declare function showGlobalHelp(): Promise<void>;
+export declare function showCategoryHelp(category: string): void;
+export { findCommand };
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EAGZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAShE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4CpD;AAMD,wBAAgB,WAAW,IAAI,IAAI,CAElC;AA4BD,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAmFpD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CA6BvD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/router.js

@@ -0,0 +1,137 @@
+/* eslint-disable no-console */
+import { findCommand, getCategories, getCommandsByCategory, } from "./commands/registry.js";
+import { UsageError } from "./errors.js";
+import { OUTPUT_FORMATS } from "./output.js";
+import { isTestEnv } from "./utils/cli-env.js";
+import { COMMAND_NAME, KEYS_COMMAND_TABLE, PACKAGE_VERSION, } from "./utils/command-info.js";
+import { theme } from "./utils/theme.js";
+export function parseArgs(argv) {
+    const globalFlags = { help: false, version: false };
+    const remaining = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i] ?? "";
+        if (arg === "--help" || arg === "-h") {
+            globalFlags.help = true;
+        }
+        else if (arg === "--version" || arg === "-V") {
+            globalFlags.version = true;
+        }
+        else if (arg === "--output" && i + 1 < argv.length) {
+            i++;
+            const value = argv[i] ?? "";
+            if (value.startsWith("-")) {
+                console.error("--output requires a value (json, pretty, or table)");
+                process.exit(2);
+            }
+            if (!OUTPUT_FORMATS.includes(value)) {
+                console.error(`Invalid output format: ${value}. Use: ${OUTPUT_FORMATS.join(", ")}`);
+                process.exit(2);
+            }
+            globalFlags.output = value;
+        }
+        else if (arg === "--columns" && i + 1 < argv.length) {
+            i++;
+            const value = argv[i] ?? "";
+            if (value.startsWith("-")) {
+                console.error("--columns requires a value (comma-separated column names)");
+                process.exit(2);
+            }
+            globalFlags.columns = value.split(",").map((s) => s.trim());
+        }
+        else {
+            remaining.push(arg);
+        }
+    }
+    const category = remaining[0] ?? null;
+    const action = remaining[1] ?? null;
+    const rest = remaining.slice(2);
+    return { category, action, rest, globalFlags };
+}
+function getVersion() {
+    return PACKAGE_VERSION;
+}
+export function showVersion() {
+    console.log(`${COMMAND_NAME} ${getVersion()}`);
+}
+async function getKeyInfo() {
+    if (process.env.ITERABLE_API_KEY)
+        return { status: "env" };
+    if (isTestEnv())
+        return { status: "none" };
+    try {
+        const { getKeyManager } = await import("./key-manager.js");
+        const km = getKeyManager();
+        await km.initialize();
+        if (!(await km.hasKeys()))
+            return { status: "none" };
+        if (!(await km.hasActiveKey()))
+            return { status: "inactive" };
+        const meta = await km.getActiveKeyMetadata();
+        return {
+            status: "keymanager",
+            name: meta?.name,
+            endpoint: meta?.baseUrl.replace("https://", ""),
+        };
+    }
+    catch {
+        return { status: "none" };
+    }
+}
+export async function showGlobalHelp() {
+    const version = getVersion();
+    const categories = getCategories();
+    const keyInfo = await getKeyInfo();
+    const lines = [
+        "",
+        theme.bold(`${COMMAND_NAME} v${version}`) +
+            " - Command-line interface for the Iterable API",
+    ];
+    switch (keyInfo.status) {
+        case "env":
+            lines.push(theme.muted("  Using API key from ITERABLE_API_KEY environment variable"));
+            break;
+        case "keymanager":
+            lines.push(theme.muted(`  Using key "${keyInfo.name}"` +
+                (keyInfo.endpoint ? ` (${keyInfo.endpoint})` : "")));
+            break;
+        case "inactive":
+            lines.push(theme.key("  No active API key.") +
+                theme.muted(` Run ${theme.accent(`${COMMAND_NAME} keys activate <name>`)} to activate one.`));
+            break;
+        case "none":
+            lines.push(theme.key("  No API key configured.") +
+                theme.muted(` Run ${theme.accent(`${COMMAND_NAME} keys add`)} to add one.`));
+            break;
+    }
+    lines.push("", theme.bold("USAGE"), `  ${COMMAND_NAME} <category> <command> [options]`, "", theme.muted(`Run '${COMMAND_NAME} <category> --help' to see commands in a category.`), "", theme.bold("CATEGORIES"));
+    for (const cat of categories) {
+        const cmds = getCommandsByCategory(cat);
+        lines.push(`  ${theme.accent(cat.padEnd(16))} ${theme.muted(`${cmds.length} commands`)}`);
+    }
+    lines.push("", theme.bold("GLOBAL OPTIONS"), `  ${theme.accent("--help, -h")}        Show help`, `  ${theme.accent("--version, -V")}     Show version`, `  ${theme.accent("--output")} <fmt>    Output format: ${OUTPUT_FORMATS.join(", ")} (default: pretty)`, `  ${theme.accent("--columns")} <cols>  Columns to show in table output (comma-separated)`, `  ${theme.accent("--json")} <data>     Pass raw JSON — bypasses all other flags (use '-' for stdin)`, "", theme.bold("KEY MANAGEMENT"));
+    for (const [cmd, desc] of KEYS_COMMAND_TABLE) {
+        lines.push(`  ${theme.accent(cmd.padEnd(45))} ${theme.muted(desc)}`);
+    }
+    lines.push("");
+    console.log(lines.join("\n"));
+}
+export function showCategoryHelp(category) {
+    const commands = getCommandsByCategory(category);
+    if (commands.length === 0) {
+        throw new UsageError(`Unknown category: ${category}`);
+    }
+    const lines = [
+        "",
+        theme.bold(`${COMMAND_NAME} ${category}`) + " - Available commands",
+        "",
+    ];
+    const maxNameLen = Math.max(...commands.map((c) => c.name.length));
+    for (const cmd of commands) {
+        const alias = cmd.isAlias ? theme.muted(" (alias)") : "";
+        lines.push(`  ${theme.accent(cmd.name.padEnd(maxNameLen + 2))} ${cmd.description}${alias}`);
+    }
+    lines.push("", theme.muted(`Run '${COMMAND_NAME} ${category} <command> --help' for command details.`), "");
+    console.log(lines.join("\n"));
+}
+export { findCommand };
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/utils/cli-env.d.ts

@@ -0,0 +1,10 @@
+export declare function isTestEnv(): boolean;
+interface Spinner {
+    start: (msg?: string) => void;
+    stop: () => void;
+    succeed: (msg?: string) => void;
+    fail: (msg?: string) => void;
+}
+export declare function getSpinner(): Promise<Spinner>;
+export {};
+//# sourceMappingURL=cli-env.d.ts.map

package/dist/utils/cli-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-env.d.ts","sourceRoot":"","sources":["../../src/utils/cli-env.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,UAAU,OAAO;IACf,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAcnD"}

package/dist/utils/cli-env.js

@@ -0,0 +1,21 @@
+export function isTestEnv() {
+    return process.env.NODE_ENV === "test";
+}
+export async function getSpinner() {
+    const noop = {
+        start: () => { },
+        stop: () => { },
+        succeed: () => { },
+        fail: () => { },
+    };
+    if (isTestEnv())
+        return noop;
+    try {
+        const ora = (await import("ora")).default;
+        return ora();
+    }
+    catch {
+        return noop;
+    }
+}
+//# sourceMappingURL=cli-env.js.map

package/dist/utils/cli-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-env.js","sourceRoot":"","sources":["../../src/utils/cli-env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;AACzC,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,IAAI,GAAY;QACpB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;KACf,CAAC;IACF,IAAI,SAAS,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1C,OAAO,GAAG,EAAE,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/command-info.d.ts

@@ -0,0 +1,7 @@
+/** The command name as the user would invoke it */
+export declare const COMMAND_NAME: string;
+/** Package version from package.json */
+export declare const PACKAGE_VERSION: string;
+/** Keys subcommand help rows: [command, description] */
+export declare const KEYS_COMMAND_TABLE: ReadonlyArray<readonly [string, string]>;
+//# sourceMappingURL=command-info.d.ts.map

package/dist/utils/command-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-info.d.ts","sourceRoot":"","sources":["../../src/utils/command-info.ts"],"names":[],"mappings":"AAgCA,mDAAmD;AACnD,eAAO,MAAM,YAAY,EAAE,MAEF,CAAC;AAE1B,wCAAwC;AACxC,eAAO,MAAM,eAAe,EAAE,MAAoB,CAAC;AAEnD,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAU9D,CAAC"}

package/dist/utils/command-info.js

@@ -0,0 +1,36 @@
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+function loadPackageJson() {
+    try {
+        const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "../..", "package.json");
+        return JSON.parse(readFileSync(pkgPath, "utf-8"));
+    }
+    catch {
+        return { name: "@iterable/cli", version: "0.0.0" };
+    }
+}
+const pkg = loadPackageJson();
+const binName = pkg.bin ? Object.keys(pkg.bin)[0] : undefined;
+const isNpx = (process.argv[1]?.includes("npx") ||
+    process.env.npm_execpath?.includes("npx")) ??
+    false;
+/** The command name as the user would invoke it */
+export const COMMAND_NAME = isNpx
+    ? `npx ${pkg.name}`
+    : (binName ?? pkg.name);
+/** Package version from package.json */
+export const PACKAGE_VERSION = pkg.version;
+/** Keys subcommand help rows: [command, description] */
+export const KEYS_COMMAND_TABLE = [
+    [`${COMMAND_NAME} keys list`, "View all stored API keys"],
+    [`${COMMAND_NAME} keys add`, "Add a new API key"],
+    [
+        `${COMMAND_NAME} keys update <name-or-id>`,
+        "Update an existing key's settings",
+    ],
+    [`${COMMAND_NAME} keys activate <name-or-id>`, "Switch to a different key"],
+    [`${COMMAND_NAME} keys deactivate`, "Deactivate the current key"],
+    [`${COMMAND_NAME} keys delete <name-or-id>`, "Remove a key by ID or name"],
+];
+//# sourceMappingURL=command-info.js.map

package/dist/utils/command-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-info.js","sourceRoot":"","sources":["../../src/utils/command-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAQpC,SAAS,eAAe;IACtB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAClB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACvC,OAAO,EACP,cAAc,CACf,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAgB,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;AAE9B,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAE9D,MAAM,KAAK,GACT,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,KAAK,CAAC;AAER,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAW,KAAK;IACvC,CAAC,CAAC,OAAO,GAAG,CAAC,IAAI,EAAE;IACnB,CAAC,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;AAE1B,wCAAwC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAW,GAAG,CAAC,OAAO,CAAC;AAEnD,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC1E,CAAC,GAAG,YAAY,YAAY,EAAE,0BAA0B,CAAC;IACzD,CAAC,GAAG,YAAY,WAAW,EAAE,mBAAmB,CAAC;IACjD;QACE,GAAG,YAAY,2BAA2B;QAC1C,mCAAmC;KACpC;IACD,CAAC,GAAG,YAAY,6BAA6B,EAAE,2BAA2B,CAAC;IAC3E,CAAC,GAAG,YAAY,kBAAkB,EAAE,4BAA4B,CAAC;IACjE,CAAC,GAAG,YAAY,2BAA2B,EAAE,4BAA4B,CAAC;CAClE,CAAC"}

package/dist/utils/detect-background.d.ts

@@ -0,0 +1,3 @@
+export type BackgroundMode = "dark" | "light";
+export declare function detectBackground(): BackgroundMode;
+//# sourceMappingURL=detect-background.d.ts.map

package/dist/utils/detect-background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-background.d.ts","sourceRoot":"","sources":["../../src/utils/detect-background.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9C,wBAAgB,gBAAgB,IAAI,cAAc,CA8BjD"}

package/dist/utils/detect-background.js

@@ -0,0 +1,33 @@
+export function detectBackground() {
+    const override = (process.env.ITERABLE_UI_THEME ?? "").toLowerCase();
+    if (override === "dark")
+        return "dark";
+    if (override === "light")
+        return "light";
+    if (process.env.NO_COLOR)
+        return "light";
+    const cfg = process.env.COLORFGBG;
+    if (cfg) {
+        const parts = cfg.split(";");
+        const bg = parseInt(parts[parts.length - 1] ?? "", 10);
+        if (!Number.isNaN(bg))
+            return bg <= 7 ? "dark" : "light";
+    }
+    const term = (process.env.TERM_PROGRAM ?? "").toLowerCase();
+    if (term === "apple_terminal")
+        return "light";
+    if ([
+        "iterm.app",
+        "wezterm",
+        "ghostty",
+        "vscode",
+        "hyper",
+        "alacritty",
+        "kitty",
+    ].includes(term))
+        return "dark";
+    if (process.env.TERM?.includes("256color"))
+        return "dark";
+    return "light";
+}
+//# sourceMappingURL=detect-background.js.map

package/dist/utils/detect-background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-background.js","sourceRoot":"","sources":["../../src/utils/detect-background.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAClC,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAI,IAAI,KAAK,gBAAgB;QAAE,OAAO,OAAO,CAAC;IAC9C,IACE;QACE,WAAW;QACX,SAAS;QACT,SAAS;QACT,QAAQ;QACR,OAAO;QACP,WAAW;QACX,OAAO;KACR,CAAC,QAAQ,CAAC,IAAI,CAAC;QAEhB,OAAO,MAAM,CAAC;IAChB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,MAAM,CAAC;IAE1D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/endpoint-prompt.d.ts

@@ -0,0 +1,5 @@
+/** Prompt user to select Iterable region or provide a custom endpoint. */
+export declare function promptForIterableBaseUrl(options?: {
+    defaultBaseUrl?: string;
+}): Promise<string>;
+//# sourceMappingURL=endpoint-prompt.d.ts.map

package/dist/utils/endpoint-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-prompt.d.ts","sourceRoot":"","sources":["../../src/utils/endpoint-prompt.ts"],"names":[],"mappings":"AAQA,0EAA0E;AAC1E,wBAAsB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsGlB"}