@koda-sl/baker-cli 0.34.1 → 0.34.2

package/dist/commands/images/search.d.ts

@@ -0,0 +1,45 @@
+export declare const searchCommand: import("citty").CommandDef<{
+    readonly query: {
+        readonly type: "positional";
+        readonly description: "Search query text";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results (default 5)";
+        readonly required: false;
+    };
+    readonly "min-score": {
+        readonly type: "string";
+        readonly description: "Minimum relevance score (0-1)";
+        readonly required: false;
+    };
+    readonly "aspect-ratio": {
+        readonly type: "string";
+        readonly description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)";
+        readonly required: false;
+    };
+    readonly tags: {
+        readonly type: "string";
+        readonly description: "Comma-separated tags to filter by";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format: json|files|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly fields: {
+        readonly type: "string";
+        readonly description: "Comma-separated field names to include";
+        readonly required: false;
+    };
+    readonly full: {
+        readonly type: "boolean";
+        readonly description: "Include full metadata";
+        readonly required: false;
+        readonly default: false;
+    };
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/images/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/commands/images/search.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DxB,CAAC"}

package/dist/commands/images/search.js

@@ -0,0 +1,74 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../client.js";
+import { writeJson, writeOutput } from "../../output.js";
+import { registerSchema } from "../../schemas.js";
+registerSchema({
+    command: "images.search",
+    description: "Search images by text query. Only returns ready images.",
+    args: {
+        query: { type: "string", description: "Search query text", required: true },
+        limit: { type: "number", description: "Maximum results to return", required: false, default: 5 },
+        "min-score": { type: "number", description: "Minimum relevance score (0-1)", required: false },
+        "aspect-ratio": {
+            type: "string",
+            description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)",
+            required: false,
+        },
+        tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+    },
+});
+export const searchCommand = defineCommand({
+    meta: {
+        name: "search",
+        description: "Semantic search images by text query. Uses hybrid BM25 + vector + reranking. Example: baker images search 'hero banner' --aspect-ratio 16:9 --tags logo",
+    },
+    args: {
+        query: { type: "positional", description: "Search query text", required: false },
+        limit: { type: "string", description: "Max results (default 5)", required: false },
+        "min-score": { type: "string", description: "Minimum relevance score (0-1)", required: false },
+        "aspect-ratio": {
+            type: "string",
+            description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)",
+            required: false,
+        },
+        tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+        output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+        fields: { type: "string", description: "Comma-separated field names to include", required: false },
+        full: { type: "boolean", description: "Include full metadata", required: false, default: false },
+    },
+    run: async ({ args }) => {
+        process.stderr.write("[deprecated] `baker images search` → use `baker images library` (removed in next minor).\n");
+        try {
+            const query = args.query;
+            if (!query) {
+                writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+                process.exit(1);
+            }
+            const body = { query };
+            if (args.limit) {
+                body.limit = Number(args.limit);
+            }
+            if (args["aspect-ratio"]) {
+                body.aspectRatio = args["aspect-ratio"];
+            }
+            if (args.tags) {
+                body.tags = args.tags.split(",").filter(Boolean);
+            }
+            let data = await apiPost("/api/images/search", body);
+            const minScore = args["min-score"] ? Number(args["min-score"]) : undefined;
+            if (minScore !== undefined) {
+                data = data.filter((r) => typeof r.score === "number" && r.score >= minScore);
+            }
+            writeOutput({ ok: true, data }, args.output || "json", args.fields ? args.fields.split(",") : undefined, args.full);
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeJson({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=search.js.map

package/dist/commands/images/search.js.map

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

package/dist/commands/images/sticker.d.ts

@@ -0,0 +1,38 @@
+export declare const stickerCommand: import("citty").CommandDef<{
+    readonly query: {
+        readonly type: "positional";
+        readonly description: "Search query (omit with --trending)";
+        readonly required: false;
+    };
+    readonly trending: {
+        readonly type: "boolean";
+        readonly description: "Trending feed";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results";
+        readonly required: false;
+    };
+    readonly rating: {
+        readonly type: "string";
+        readonly description: "Content rating";
+        readonly required: false;
+    };
+    readonly lang: {
+        readonly type: "string";
+        readonly description: "Language code";
+        readonly required: false;
+    };
+    readonly "auto-ingest": {
+        readonly type: "string";
+        readonly description: "Auto-ingest top N";
+        readonly required: false;
+    };
+    readonly context: {
+        readonly type: "string";
+        readonly description: "Description context hint applied to ingested stickers";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=sticker.d.ts.map

package/dist/commands/images/sticker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticker.d.ts","sourceRoot":"","sources":["../../../src/commands/images/sticker.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8CzB,CAAC"}

package/dist/commands/images/sticker.js

@@ -0,0 +1,89 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../client.js";
+import { writeJson } from "../../output.js";
+import { registerSchema } from "../../schemas.js";
+registerSchema({
+    command: "images.sticker",
+    description: "Search Giphy stickers — transparent-background overlays for ad creative.",
+    args: {
+        query: { type: "string", description: "Search query (omit when --trending)", required: false },
+        trending: {
+            type: "boolean",
+            description: "Return the trending stickers feed instead of running a query",
+            required: false,
+            default: false,
+        },
+        limit: { type: "number", description: "Max results (default 20, max 50)", required: false, default: 20 },
+        rating: {
+            type: "string",
+            description: "Content rating: g | pg | pg-13 | r (default pg)",
+            required: false,
+        },
+        lang: { type: "string", description: "ISO 639-1 language code, e.g. en, es", required: false },
+        "auto-ingest": {
+            type: "number",
+            description: "Auto-ingest top N hits (default 0 — browse-style)",
+            required: false,
+            default: 0,
+        },
+        context: {
+            type: "string",
+            description: "Free-text hint applied to ingested stickers (overrides Giphy title/alt)",
+            required: false,
+        },
+    },
+});
+export const stickerCommand = defineCommand({
+    meta: {
+        name: "sticker",
+        description: "Search Giphy's sticker corpus — transparent-background WebPs / GIFs ideal for overlaying on ad creative (Meta, TikTok, Stories). Same Giphy free API as `baker images gif`; results carry WebP + GIF + MP4 URLs in providerMeta.\n\nExample: baker images sticker 'thumbs up' --limit 10\nExample: baker images sticker celebration --rating g --auto-ingest 3\nExample: baker images sticker --trending --limit 25",
+    },
+    args: {
+        query: { type: "positional", description: "Search query (omit with --trending)", required: false },
+        trending: { type: "boolean", description: "Trending feed", required: false },
+        limit: { type: "string", description: "Max results", required: false },
+        rating: { type: "string", description: "Content rating", required: false },
+        lang: { type: "string", description: "Language code", required: false },
+        "auto-ingest": { type: "string", description: "Auto-ingest top N", required: false },
+        context: { type: "string", description: "Description context hint applied to ingested stickers", required: false },
+    },
+    run: async ({ args }) => {
+        try {
+            const query = args.query;
+            const trending = args.trending === true;
+            if (!query && !trending) {
+                writeJson({
+                    ok: false,
+                    error: { code: "VALIDATION_ERROR", message: "Query is required unless --trending is set" },
+                });
+                process.exit(1);
+            }
+            const body = {};
+            if (query)
+                body.query = query;
+            if (trending)
+                body.trending = true;
+            if (args.limit)
+                body.limit = Number(args.limit);
+            if (args.rating)
+                body.rating = args.rating;
+            if (args.lang)
+                body.lang = args.lang;
+            if (args["auto-ingest"])
+                body.autoIngest = Number(args["auto-ingest"]);
+            if (args.context)
+                body.descriptionContext = args.context;
+            const data = await apiPost("/api/images/sticker", body);
+            writeJson({ ok: true, data });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeJson({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=sticker.js.map

package/dist/commands/images/sticker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticker.js","sourceRoot":"","sources":["../../../src/commands/images/sticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,cAAc,CAAC;IACb,OAAO,EAAE,gBAAgB;IACzB,WAAW,EAAE,0EAA0E;IACvF,IAAI,EAAE;QACJ,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC9F,QAAQ,EAAE;YACR,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,8DAA8D;YAC3E,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACf;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;QACxG,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iDAAiD;YAC9D,QAAQ,EAAE,KAAK;SAChB;QACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC9F,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD;YAChE,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,CAAC;SACX;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yEAAyE;YACtF,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EACT,qZAAqZ;KACxZ;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAClG,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC5E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;QACtE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC1E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;QACvE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAE;QACpF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE,QAAQ,EAAE,KAAK,EAAE;KACnH;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAA2B,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;YACxC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACxB,SAAS,CAAC;oBACR,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,4CAA4C,EAAE;iBAC3F,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,IAAI,KAAK;gBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YAC9B,IAAI,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACnC,IAAI,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3C,IAAI,IAAI,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACrC,IAAI,IAAI,CAAC,aAAa,CAAC;gBAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YACvE,IAAI,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC;YAEzD,MAAM,IAAI,GAAG,MAAM,OAAO,CAA0B,qBAAqB,EAAE,IAAI,CAAC,CAAC;YACjF,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;gBAC5B,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;YACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/images/stock.d.ts

@@ -0,0 +1,63 @@
+export declare const stockCommand: import("citty").CommandDef<{
+    readonly query: {
+        readonly type: "positional";
+        readonly description: "Search query";
+        readonly required: false;
+    };
+    readonly type: {
+        readonly type: "string";
+        readonly description: "photo|vector|psd";
+        readonly required: false;
+    };
+    readonly orientation: {
+        readonly type: "string";
+        readonly description: "Orientation filter";
+        readonly required: false;
+    };
+    readonly license: {
+        readonly type: "string";
+        readonly description: "freemium|premium";
+        readonly required: false;
+    };
+    readonly color: {
+        readonly type: "string";
+        readonly description: "Hex color filter";
+        readonly required: false;
+    };
+    readonly ai: {
+        readonly type: "string";
+        readonly description: "exclude|only";
+        readonly required: false;
+    };
+    readonly people: {
+        readonly type: "string";
+        readonly description: "include|exclude|only";
+        readonly required: false;
+    };
+    readonly order: {
+        readonly type: "string";
+        readonly description: "relevance|recent";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results (1-50)";
+        readonly required: false;
+    };
+    readonly page: {
+        readonly type: "string";
+        readonly description: "Page number";
+        readonly required: false;
+    };
+    readonly "auto-ingest": {
+        readonly type: "string";
+        readonly description: "Auto-ingest top N";
+        readonly required: false;
+    };
+    readonly context: {
+        readonly type: "string";
+        readonly description: "Description context hint applied to auto-ingested hits";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=stock.d.ts.map

package/dist/commands/images/stock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stock.d.ts","sourceRoot":"","sources":["../../../src/commands/images/stock.ts"],"names":[],"mappings":"AA+DA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDvB,CAAC"}

package/dist/commands/images/stock.js

@@ -0,0 +1,124 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../client.js";
+import { writeJson } from "../../output.js";
+import { registerSchema } from "../../schemas.js";
+registerSchema({
+    command: "images.stock",
+    description: "Stock photo, vector illustration, icon-set, and PSD search via Magnific (Freepik's developer API).",
+    args: {
+        query: { type: "string", description: "Search query", required: true },
+        type: {
+            type: "string",
+            description: "Content type: photo | vector | psd",
+            required: false,
+            enum: ["photo", "vector", "psd"],
+        },
+        orientation: {
+            type: "string",
+            description: "landscape | portrait | square | panoramic",
+            required: false,
+            enum: ["landscape", "portrait", "square", "panoramic"],
+        },
+        license: {
+            type: "string",
+            description: "freemium (free with attribution) | premium (paid)",
+            required: false,
+            enum: ["freemium", "premium"],
+        },
+        color: { type: "string", description: "Hex color filter (e.g. '#0a0a0a' or '0a0a0a')", required: false },
+        ai: {
+            type: "string",
+            description: "AI-generated filter: exclude | only (default: no filter)",
+            required: false,
+            enum: ["exclude", "only"],
+        },
+        people: {
+            type: "string",
+            description: "People-in-image filter: include | exclude | only",
+            required: false,
+            enum: ["include", "exclude", "only"],
+        },
+        order: {
+            type: "string",
+            description: "relevance (default) | recent",
+            required: false,
+            enum: ["relevance", "recent"],
+        },
+        limit: { type: "number", description: "Max results (1-50, default 10)", required: false, default: 10 },
+        page: { type: "number", description: "Page number for pagination", required: false },
+        "auto-ingest": {
+            type: "number",
+            description: "Auto-ingest top N hits (0-20, default 0)",
+            required: false,
+            default: 0,
+        },
+        context: {
+            type: "string",
+            description: "Free-text hint applied to every auto-ingested hit (overrides Magnific title)",
+            required: false,
+        },
+    },
+});
+export const stockCommand = defineCommand({
+    meta: {
+        name: "stock",
+        description: "Stock search via Magnific — Freepik's developer API (~250M assets: photos, vectors, illustrations, icons, PSDs). $0.002/req.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'flat office workers' --type vector\n  baker images stock 'hero photo of a kitchen' --type photo --orientation landscape --ai exclude\n  baker images stock 'brand pattern' --color '#0a0a0a' --license freemium --auto-ingest 2",
+    },
+    args: {
+        query: { type: "positional", description: "Search query", required: false },
+        type: { type: "string", description: "photo|vector|psd", required: false },
+        orientation: { type: "string", description: "Orientation filter", required: false },
+        license: { type: "string", description: "freemium|premium", required: false },
+        color: { type: "string", description: "Hex color filter", required: false },
+        ai: { type: "string", description: "exclude|only", required: false },
+        people: { type: "string", description: "include|exclude|only", required: false },
+        order: { type: "string", description: "relevance|recent", required: false },
+        limit: { type: "string", description: "Max results (1-50)", required: false },
+        page: { type: "string", description: "Page number", required: false },
+        "auto-ingest": { type: "string", description: "Auto-ingest top N", required: false },
+        context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false },
+    },
+    run: async ({ args }) => {
+        try {
+            const query = args.query;
+            if (!query) {
+                writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
+                process.exit(1);
+            }
+            const body = { query };
+            if (args.type)
+                body.contentType = args.type;
+            if (args.orientation)
+                body.orientation = args.orientation;
+            if (args.license)
+                body.license = args.license;
+            if (args.color)
+                body.color = args.color;
+            if (args.ai)
+                body.aiGenerated = args.ai;
+            if (args.people)
+                body.people = args.people;
+            if (args.order)
+                body.order = args.order;
+            if (args.limit)
+                body.limit = Number(args.limit);
+            if (args.page)
+                body.page = Number(args.page);
+            if (args["auto-ingest"])
+                body.autoIngest = Number(args["auto-ingest"]);
+            if (args.context)
+                body.descriptionContext = args.context;
+            const data = await apiPost("/api/images/stock", body);
+            writeJson({ ok: true, data });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeJson({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=stock.js.map

package/dist/commands/images/stock.js.map

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

package/dist/commands/images/upload.d.ts

@@ -0,0 +1,39 @@
+export declare const uploadCommand: import("citty").CommandDef<{
+    readonly file: {
+        readonly type: "positional";
+        readonly description: "Local file path or remote http(s) URL";
+        readonly required: false;
+    };
+    readonly source: {
+        readonly type: "string";
+        readonly description: "Source identifier";
+        readonly required: false;
+    };
+    readonly "content-type": {
+        readonly type: "string";
+        readonly description: "MIME type (local only — auto-detected if omitted)";
+        readonly required: false;
+    };
+    readonly "external-id": {
+        readonly type: "string";
+        readonly description: "Provider asset id (URL mode only)";
+        readonly required: false;
+    };
+    readonly "external-url": {
+        readonly type: "string";
+        readonly description: "Canonical page URL (URL mode only)";
+        readonly required: false;
+    };
+    readonly "dry-run": {
+        readonly type: "boolean";
+        readonly description: "Preview without executing";
+        readonly required: false;
+        readonly default: false;
+    };
+    readonly context: {
+        readonly type: "string";
+        readonly description: "Description context hint";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/commands/images/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/commands/images/upload.ts"],"names":[],"mappings":"AAiEA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CxB,CAAC"}