@meterapp/car-image 1.0.0

package/dist/commands/login.js

@@ -0,0 +1,64 @@
+import { flagString } from "../args.js";
+import { openBrowser } from "../browser.js";
+import { maskKey, updateConfig } from "../config.js";
+import { runDeviceLogin } from "../device-login.js";
+import { keyValues, ok, paint, printJson } from "../output.js";
+import { simpleEvent } from "../telemetry.js";
+export const loginCommand = {
+    name: "login",
+    summary: "Sign in through the browser (device flow) and store a key with mode 0600",
+    usage: "car-image login [--no-browser] [--client-name <name>]",
+    async run(ctx) {
+        const { io, clientContext } = ctx;
+        const openInBrowser = ctx.args.flags.browser !== false;
+        const clientName = flagString(ctx.args.flags, "client-name") ?? `car-image CLI (${process.platform})`;
+        const result = await runDeviceLogin({
+            start: () => clientContext.client.startDeviceLogin({ clientName }),
+            poll: (deviceCode) => clientContext.client.pollDeviceLogin(deviceCode),
+            sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+            now: () => Date.now(),
+            onCode(info) {
+                io.stderr(`\nApprove this CLI in your browser:\n  ${paint(io, "underline", info.verification_uri_complete)}\n\nCode: ${paint(io, "bold", info.user_code)}\n`);
+                if (openInBrowser) {
+                    const opened = openBrowser(info.verification_uri_complete);
+                    io.stderr(opened ? "Opening your browser… (use --no-browser to skip)\n" : "Open the link above in a browser.\n");
+                }
+                io.stderr(`Waiting for approval (expires in ${Math.round(info.expires_in / 60)} min)…\n`);
+            },
+        });
+        await updateConfig({ apiKey: result.accessToken, baseUrl: clientContext.baseUrl }, ctx.configPath);
+        if (ctx.telemetry.enabled && ctx.telemetry.anonymousId) {
+            ctx.emit(simpleEvent(ctx.telemetry.anonymousId, "cli_login"));
+        }
+        const scopes = result.scope ? result.scope.split(/[\s,]+/).filter(Boolean) : [];
+        if (io.json) {
+            printJson(io, { ok: true, api_key: result.accessToken, key_prefix: maskKey(result.accessToken), scopes, config_path: ctx.configPath, base_url: clientContext.baseUrl });
+            return 0;
+        }
+        io.stdout(`\n${ok(io, "Signed in.")}\n`);
+        io.stdout(`${keyValues(io, [
+            ["API key", `${result.accessToken}  ${paint(io, "dim", "(shown once; stored below)")}`],
+            ["Saved to", `${ctx.configPath} (mode 0600)`],
+            ["Scopes", scopes.join(", ") || "images:read account:read billing:write"],
+            ["Base URL", clientContext.baseUrl],
+        ])}\n`);
+        io.stdout(`\nFor agents: export CAR_IMAGE_API_KEY=${maskKey(result.accessToken)} (full key above) or run \`car-image agent-config\`.\nNext: car-image whoami · car-image get --make Porsche --model 911 --year 2024 · car-image doctor\n`);
+        return 0;
+    },
+};
+export const logoutCommand = {
+    name: "logout",
+    summary: "Remove the stored key from the config file",
+    usage: "car-image logout",
+    async run(ctx) {
+        const hadKey = Boolean(ctx.config.apiKey);
+        await updateConfig({ apiKey: undefined }, ctx.configPath);
+        if (ctx.io.json) {
+            printJson(ctx.io, { ok: true, removed: hadKey, config_path: ctx.configPath });
+            return 0;
+        }
+        ctx.io.stdout(hadKey ? `${ok(ctx.io, `Signed out; key removed from ${ctx.configPath}.`)}\nIf the key may have leaked, revoke it in the dashboard: ${ctx.clientContext.baseUrl}/dashboard/keys\n` : `No stored key in ${ctx.configPath}.\n`);
+        return 0;
+    },
+};
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

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

package/dist/commands/maintenance.js

@@ -0,0 +1,156 @@
+import { AUTO_UPDATE_MODES, CONFIG_KEYS, readConfig, updateCachePath, updateConfig } from "../config.js";
+import { CliError } from "../errors.js";
+import { keyValues, ok, printJson, warn } from "../output.js";
+import { TELEMETRY_DISCLOSURE, telemetryEnabled } from "../telemetry.js";
+import { checkForUpdate, detectPackageManager, installCommand, isNewer, isNpxInvocation, performUpdate } from "../update.js";
+import { CLI_VERSION, PACKAGE_NAME } from "../version.js";
+export const updateCommand = {
+    name: "update",
+    summary: "Update the CLI to the latest npm version (or just check with --check)",
+    usage: "car-image update [--check] [--json]",
+    async run(ctx) {
+        const { io } = ctx;
+        const { latest } = await checkForUpdate({ cachePath: updateCachePath(ctx.env), force: true });
+        const newer = isNewer(latest, CLI_VERSION);
+        const viaNpx = isNpxInvocation(ctx.env);
+        const manager = detectPackageManager(ctx.env);
+        const install = installCommand(manager);
+        if (ctx.args.flags.check === true || !newer) {
+            if (io.json) {
+                printJson(io, { current: CLI_VERSION, latest, update_available: newer, via_npx: viaNpx, install: `${install.command} ${install.args.join(" ")}` });
+                return 0;
+            }
+            if (latest === null)
+                io.stdout(`${warn(io, `Could not reach the npm registry; running ${CLI_VERSION}.`)}\n`);
+            else if (newer)
+                io.stdout(`Update available: ${CLI_VERSION} → ${latest}. Run: ${viaNpx ? `npx ${PACKAGE_NAME}@latest` : `car-image update`}\n`);
+            else
+                io.stdout(`${ok(io, `car-image ${CLI_VERSION} is up to date.`)}\n`);
+            return 0;
+        }
+        if (viaNpx) {
+            io.stdout(`You are running through npx; the next \`npx ${PACKAGE_NAME}@latest\` call uses ${latest} automatically.\n`);
+            return 0;
+        }
+        io.stderr(`Updating ${CLI_VERSION} → ${latest} with ${manager}…\n`);
+        const code = await performUpdate(manager, (line) => io.stderr(line));
+        if (code !== 0) {
+            throw new CliError(`Update failed (exit ${code}).`, 1, `Run manually: ${install.command} ${install.args.join(" ")} (add sudo only if your global prefix requires it, or switch to a user-writable prefix).`);
+        }
+        io.stdout(`${ok(io, `Updated to ${latest}.`)}\n`);
+        return 0;
+    },
+};
+function parseConfigValue(key, raw) {
+    switch (key) {
+        case "autoUpdate": {
+            const value = raw.trim().toLowerCase();
+            if (!AUTO_UPDATE_MODES.includes(value))
+                throw new CliError(`autoUpdate must be one of: ${AUTO_UPDATE_MODES.join(", ")}`, 2);
+            return { autoUpdate: value };
+        }
+        case "telemetry": {
+            const value = raw.trim().toLowerCase();
+            if (["on", "true", "1", "yes"].includes(value))
+                return { telemetry: true };
+            if (["off", "false", "0", "no"].includes(value))
+                return { telemetry: false };
+            throw new CliError("telemetry must be on or off", 2);
+        }
+        case "baseUrl": {
+            try {
+                const url = new URL(raw.trim());
+                if (!/^https?:$/.test(url.protocol))
+                    throw new Error("protocol");
+                return { baseUrl: url.origin + url.pathname.replace(/\/+$/, "") };
+            }
+            catch {
+                throw new CliError("baseUrl must be an http(s) URL", 2);
+            }
+        }
+        default:
+            throw new CliError(`Unknown config key ${String(key)}`, 2);
+    }
+}
+export const configCommand = {
+    name: "config",
+    summary: "Read or change settings: autoUpdate (ask|always|never), telemetry (on|off), baseUrl; `config path`",
+    usage: "car-image config path\ncar-image config get <autoUpdate|telemetry|baseUrl>\ncar-image config set <autoUpdate|telemetry|baseUrl> <value>\ncar-image config list",
+    async run(ctx) {
+        const [action, rawKey, value] = ctx.args.positionals;
+        const { io } = ctx;
+        if (!action || action === "list") {
+            const config = await readConfig(ctx.configPath);
+            const view = {
+                path: ctx.configPath,
+                autoUpdate: config.autoUpdate ?? "ask",
+                telemetry: telemetryEnabled(config, ctx.env) ? "on" : "off",
+                baseUrl: config.baseUrl ?? "(default)",
+                apiKey: config.apiKey ? "(stored)" : "(none)",
+            };
+            if (io.json)
+                printJson(io, view);
+            else
+                io.stdout(`${keyValues(io, Object.entries(view))}\n`);
+            return 0;
+        }
+        if (action === "path") {
+            io.stdout(`${ctx.configPath}\n`);
+            return 0;
+        }
+        if (!rawKey || !CONFIG_KEYS.includes(rawKey)) {
+            throw new CliError(`Usage: car-image config ${action} <${CONFIG_KEYS.join("|")}>`, 2);
+        }
+        const key = rawKey;
+        if (action === "get") {
+            const config = await readConfig(ctx.configPath);
+            const current = key === "telemetry" ? (telemetryEnabled(config, ctx.env) ? "on" : "off") : key === "autoUpdate" ? (config.autoUpdate ?? "ask") : (config.baseUrl ?? "");
+            if (io.json)
+                printJson(io, { [key]: current });
+            else
+                io.stdout(`${current}\n`);
+            return 0;
+        }
+        if (action === "set") {
+            if (value === undefined)
+                throw new CliError(`Usage: car-image config set ${key} <value>`, 2);
+            const patch = parseConfigValue(key, value);
+            await updateConfig(patch, ctx.configPath);
+            if (io.json)
+                printJson(io, { ok: true, ...patch });
+            else
+                io.stdout(`${ok(io, `${key} = ${String(Object.values(patch)[0])}`)}\n`);
+            return 0;
+        }
+        throw new CliError(`Unknown config action "${action}"`, 2, "Use: path, get, set, list");
+    },
+};
+export const telemetryCommand = {
+    name: "telemetry",
+    summary: "Turn anonymous usage events on or off, or show the current state",
+    usage: "car-image telemetry on|off|status",
+    async run(ctx) {
+        const action = (ctx.args.positionals[0] ?? "status").toLowerCase();
+        const { io } = ctx;
+        if (action === "on" || action === "off") {
+            const config = await updateConfig({ telemetry: action === "on" }, ctx.configPath);
+            const effective = telemetryEnabled(config, ctx.env);
+            if (io.json)
+                printJson(io, { telemetry: action === "on", effective });
+            else
+                io.stdout(`${ok(io, `Telemetry ${action}.`)}${action === "on" && !effective ? " (CAR_IMAGE_TELEMETRY in the environment still disables it)" : ""}\n`);
+            return 0;
+        }
+        if (action !== "status")
+            throw new CliError("Usage: car-image telemetry on|off|status", 2);
+        const config = await readConfig(ctx.configPath);
+        const enabled = telemetryEnabled(config, ctx.env);
+        if (io.json) {
+            printJson(io, { enabled, anonymous_id: config.anonymousId ?? null, env_override: ctx.env.CAR_IMAGE_TELEMETRY ?? null });
+            return 0;
+        }
+        io.stdout(`Telemetry is ${enabled ? "on" : "off"}${ctx.env.CAR_IMAGE_TELEMETRY !== undefined ? ` (CAR_IMAGE_TELEMETRY=${ctx.env.CAR_IMAGE_TELEMETRY})` : ""}.\n${TELEMETRY_DISCLOSURE}\n`);
+        return 0;
+    },
+};
+//# sourceMappingURL=maintenance.js.map

package/dist/commands/maintenance.js.map

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

package/dist/commands/onboard.js

@@ -0,0 +1,42 @@
+import { paint } from "../output.js";
+import { runDoctorCommand } from "./doctor.js";
+/**
+ * `car-image` with no arguments on a TTY: login if needed, show the account,
+ * run a quick (free) health check and print the next steps.
+ */
+export const onboardCommand = {
+    name: "onboard",
+    summary: "Interactive setup: login → account → quick check → next steps (default with no arguments)",
+    usage: "car-image [onboard]",
+    async run(ctx) {
+        const { io } = ctx;
+        io.stdout(`${paint(io, "bold", "Car Image API")} — studio-quality vehicle renders for agents, apps and browsers.\n1 credit per image · $1 = 1,000 credits · 100 free credits · no subscription\n\n`);
+        if (!ctx.clientContext.apiKey) {
+            io.stdout(`${paint(io, "bold", "Step 1/3")} Sign in\n`);
+            const code = await ctx.runCommand("login", []);
+            if (code !== 0)
+                return code;
+            io.stdout("\n");
+        }
+        else {
+            io.stdout(`${paint(io, "bold", "Step 1/3")} Signed in (${ctx.clientContext.keySource} key).\n\n`);
+        }
+        io.stdout(`${paint(io, "bold", "Step 2/3")} Account\n`);
+        const whoami = await ctx.runCommand("whoami", []);
+        if (whoami !== 0)
+            return whoami;
+        io.stdout(`\n${paint(io, "bold", "Step 3/3")} Quick check (free)\n`);
+        const doctor = await runDoctorCommand({ ...ctx, args: { ...ctx.args, flags: { ...ctx.args.flags, image: false } } }, { quick: true });
+        io.stdout(`\n${paint(io, "bold", "Next steps")}\n`);
+        io.stdout([
+            "  car-image get --make Porsche --model 911 --year 2024 --view side --color red --out porsche.png",
+            "  car-image url --make BMW --model M3 --year 2022 --ttl 86400        # signed URL for a web page",
+            "  car-image resolve red 2024 porsche 911 side view                    # free text → parameters",
+            "  car-image agent-config --host claude-code                           # MCP setup for agents",
+            "  car-image describe                                                  # the REST API, explained",
+            "  Docs: https://car-imgs.vercel.app/docs · Agents: https://car-imgs.vercel.app/agents.md",
+        ].join("\n") + "\n");
+        return doctor;
+    },
+};
+//# sourceMappingURL=onboard.js.map

package/dist/commands/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,2FAA2F;IACpG,KAAK,EAAE,qBAAqB;IAC5B,KAAK,CAAC,GAAG,CAAC,GAAmB;QAC3B,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC;QACnB,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,oJAAoJ,CAAC,CAAC;QAErM,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC9B,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5B,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,eAAe,GAAG,CAAC,aAAa,CAAC,SAAS,YAAY,CAAC,CAAC;QACpG,CAAC;QAED,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAEhC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtI,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QACpD,EAAE,CAAC,MAAM,CACP;YACE,kGAAkG;YAClG,kGAAkG;YAClG,gGAAgG;YAChG,8FAA8F;YAC9F,iGAAiG;YACjG,0FAA0F;SAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CACpB,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/commands/whoami.js

@@ -0,0 +1,41 @@
+import { maskKey } from "../config.js";
+import { CliError } from "../errors.js";
+import { creditsToUsd, formatInteger, keyValues, printJson } from "../output.js";
+export const whoamiCommand = {
+    name: "whoami",
+    aliases: ["status"],
+    summary: "Show credits, usage, key and base URL for the current account",
+    usage: "car-image whoami [--json]",
+    async run(ctx) {
+        const { io, clientContext } = ctx;
+        if (!clientContext.apiKey) {
+            throw new CliError("Not signed in.", 1, "Run `car-image login` or set CAR_IMAGE_API_KEY.");
+        }
+        const account = await clientContext.client.account();
+        if (io.json) {
+            printJson(io, { ...account, key_source: clientContext.keySource, base_url: clientContext.baseUrl });
+            return 0;
+        }
+        const data = account.data;
+        const perDollar = data.pricing?.credits_per_dollar ?? 1000;
+        const usage = data.usage_30d;
+        const rows = [
+            ["Credits", `${formatInteger(data.credits)}  (≈ ${creditsToUsd(data.credits, perDollar)}; ${formatInteger(data.pricing?.credits_per_image ?? 1)} credit per image)`],
+            ["Auto-reload", data.auto_reload ? "on" : "off"],
+            ["Payment method", data.has_payment_method ? "on file" : "none"],
+        ];
+        if (usage) {
+            const hitRate = Number.isFinite(usage.cache_hit_rate) ? `${Math.round(usage.cache_hit_rate * (usage.cache_hit_rate <= 1 ? 100 : 1))}% cache hits` : "";
+            rows.push(["Usage (30d)", `${formatInteger(usage.requests)} requests, ${formatInteger(usage.images)} images${hitRate ? `, ${hitRate}` : ""}`]);
+        }
+        rows.push(["Key", `${data.key?.prefix ? `${data.key.prefix}…` : maskKey(clientContext.apiKey)}  (${clientContext.keySource ?? "unknown"} · scopes: ${(data.key?.scopes ?? []).join(", ") || "—"})`]);
+        rows.push(["Base URL", clientContext.baseUrl]);
+        rows.push(["Config", ctx.configPath]);
+        io.stdout(`${keyValues(io, rows)}\n`);
+        if (data.credits < 10) {
+            io.stdout(`\nLow balance. Buy credits: car-image billing --credits 5000 (${account.links?.billing ?? `${clientContext.baseUrl}/billing`})\n`);
+        }
+        return 0;
+    },
+};
+//# sourceMappingURL=whoami.js.map

package/dist/commands/whoami.js.map

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

package/dist/config.js

@@ -0,0 +1,84 @@
+import { chmod, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export const AUTO_UPDATE_MODES = ["ask", "always", "never"];
+export const CONFIG_KEYS = ["autoUpdate", "telemetry", "baseUrl"];
+/** `$CAR_IMAGE_CONFIG`, else `$XDG_CONFIG_HOME/car-image-api/config.json`, else `~/.config/...`. */
+export function configPath(env = process.env) {
+    const explicit = env.CAR_IMAGE_CONFIG?.trim();
+    if (explicit)
+        return explicit;
+    const root = env.XDG_CONFIG_HOME?.trim() || join(env.HOME?.trim() || homedir(), ".config");
+    return join(root, "car-image-api", "config.json");
+}
+/** 24-hour update-check cache, next to the config file. */
+export function updateCachePath(env = process.env) {
+    return join(dirname(configPath(env)), "update-check.json");
+}
+export async function readJsonFile(path) {
+    try {
+        const raw = await readFile(path, "utf8");
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Atomic write (temp file + rename) with a private mode; parent directory is 0700. */
+export async function writeJsonFile(path, value, mode = 0o600) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const temp = `${path}.${process.pid}.tmp`;
+    await writeFile(temp, `${JSON.stringify(value, null, 2)}\n`, { mode });
+    await chmod(temp, mode);
+    await rename(temp, path);
+    await chmod(path, mode);
+}
+export async function readConfig(path = configPath()) {
+    const raw = await readJsonFile(path);
+    if (!raw)
+        return {};
+    const config = {};
+    if (typeof raw.apiKey === "string" && raw.apiKey)
+        config.apiKey = raw.apiKey;
+    if (typeof raw.baseUrl === "string" && raw.baseUrl)
+        config.baseUrl = raw.baseUrl;
+    if (raw.autoUpdate === "ask" || raw.autoUpdate === "always" || raw.autoUpdate === "never")
+        config.autoUpdate = raw.autoUpdate;
+    if (typeof raw.telemetry === "boolean")
+        config.telemetry = raw.telemetry;
+    if (typeof raw.anonymousId === "string" && raw.anonymousId)
+        config.anonymousId = raw.anonymousId;
+    if (typeof raw.telemetryDisclosed === "boolean")
+        config.telemetryDisclosed = raw.telemetryDisclosed;
+    return config;
+}
+export async function writeConfig(config, path = configPath()) {
+    const clean = {};
+    for (const [key, value] of Object.entries(config)) {
+        if (value !== undefined && value !== null && value !== "")
+            clean[key] = value;
+    }
+    await writeJsonFile(path, clean, 0o600);
+}
+export async function updateConfig(patch, path = configPath()) {
+    const current = await readConfig(path);
+    const next = { ...current };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === undefined)
+            delete next[key];
+        else
+            next[key] = value;
+    }
+    await writeConfig(next, path);
+    return next;
+}
+/** Display form such as `cimg_A1b2…9zY`; the full key is never printed after login. */
+export function maskKey(key) {
+    if (!key)
+        return "(none)";
+    if (key.length <= 12)
+        return `${key.slice(0, 4)}…`;
+    return `${key.slice(0, 9)}…${key.slice(-3)}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":""}