@koda-sl/baker-cli 0.34.1 → 0.34.3

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

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

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"}

package/dist/commands/images/upload.js

@@ -0,0 +1,159 @@
+import { readFile } from "node:fs/promises";
+import { extname } from "node:path";
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../client.js";
+import { writeJson } from "../../output.js";
+import { registerSchema } from "../../schemas.js";
+const MIME_MAP = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+    ".avif": "image/avif",
+};
+registerSchema({
+    command: "images.upload",
+    description: "Upload an image to the library — local file path or remote http(s) URL.",
+    args: {
+        file: { type: "string", description: "Local file path or remote http(s) URL", required: true },
+        source: { type: "string", description: "Source identifier (default: uploaded)", required: false },
+        "content-type": {
+            type: "string",
+            description: "MIME type (local files only — auto-detected from extension if omitted; ignored for URLs)",
+            required: false,
+        },
+        "external-id": {
+            type: "string",
+            description: "Provider asset id (URL mode only — enables per-source dedup before bytes are fetched)",
+            required: false,
+        },
+        "external-url": {
+            type: "string",
+            description: "Canonical page URL (URL mode only — parent page for scraped/Google hits, provider page for stock)",
+            required: false,
+        },
+        "dry-run": {
+            type: "boolean",
+            description: "Preview the operation without executing",
+            required: false,
+            default: false,
+        },
+        context: {
+            type: "string",
+            description: "Free-text hint passed to Gemini describe to bias the generated description and tags",
+            required: false,
+        },
+    },
+});
+function isRemoteUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+function detectContentType(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    const mime = MIME_MAP[ext];
+    if (!mime) {
+        throw new ApiError("VALIDATION_ERROR", `Cannot detect content type for extension "${ext}". Use --content-type.`);
+    }
+    return mime;
+}
+export const uploadCommand = defineCommand({
+    meta: {
+        name: "upload",
+        description: "Upload an image to the library — accepts a local file path OR a remote http(s) URL.\n\nLocal: reads bytes, sends to /api/images/upload, content-type auto-detected from extension.\nRemote: dispatches to /api/images/ingest with hash-dedup on bytes + externalId.\n\nExamples:\n  baker images upload ./logo.png --source uploaded\n  baker images upload ./cert.png --context 'ISO 27001 badge — enterprise tier'\n  baker images upload https://acme.com/hero.png --source firecrawl --context 'Acme competitor pricing hero'",
+    },
+    args: {
+        file: { type: "positional", description: "Local file path or remote http(s) URL", required: false },
+        source: { type: "string", description: "Source identifier", required: false },
+        "content-type": {
+            type: "string",
+            description: "MIME type (local only — auto-detected if omitted)",
+            required: false,
+        },
+        "external-id": { type: "string", description: "Provider asset id (URL mode only)", required: false },
+        "external-url": { type: "string", description: "Canonical page URL (URL mode only)", required: false },
+        "dry-run": { type: "boolean", description: "Preview without executing", required: false, default: false },
+        context: { type: "string", description: "Description context hint", required: false },
+    },
+    run: async ({ args }) => {
+        try {
+            const target = args.file;
+            if (!target) {
+                writeJson({
+                    ok: false,
+                    error: { code: "VALIDATION_ERROR", message: "File path or URL is required" },
+                });
+                process.exit(1);
+            }
+            if (isRemoteUrl(target)) {
+                await uploadRemote(target, args);
+            }
+            else {
+                await uploadLocal(target, args);
+            }
+        }
+        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);
+        }
+    },
+});
+async function uploadRemote(target, args) {
+    const source = args.source ?? "uploaded";
+    if (args["dry-run"]) {
+        writeJson({
+            ok: true,
+            dryRun: true,
+            operation: "images.upload (remote)",
+            params: {
+                url: target,
+                source,
+                externalId: args["external-id"] ?? null,
+                externalUrl: args["external-url"] ?? null,
+                descriptionContext: args.context ?? null,
+            },
+        });
+        return;
+    }
+    const body = { url: target, source };
+    if (args["external-id"])
+        body.externalId = args["external-id"];
+    if (args["external-url"])
+        body.externalUrl = args["external-url"];
+    if (args.context)
+        body.descriptionContext = args.context;
+    const data = await apiPost("/api/images/ingest", body);
+    writeJson({ ok: true, data });
+}
+async function uploadLocal(target, args) {
+    const contentType = args["content-type"] || detectContentType(target);
+    if (args["dry-run"]) {
+        writeJson({
+            ok: true,
+            dryRun: true,
+            operation: "images.upload (local)",
+            params: {
+                file: target,
+                contentType,
+                source: args.source ?? null,
+                descriptionContext: args.context ?? null,
+            },
+        });
+        return;
+    }
+    const fileBuffer = await readFile(target);
+    const base64 = fileBuffer.toString("base64");
+    const body = { base64, contentType };
+    if (args.source)
+        body.source = args.source;
+    if (args.context)
+        body.descriptionContext = args.context;
+    const data = await apiPost("/api/images/upload", body);
+    writeJson({ ok: true, data });
+}
+//# sourceMappingURL=upload.js.map

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

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

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

@@ -0,0 +1,23 @@
+export declare const useCommand: import("citty").CommandDef<{
+    readonly url: {
+        readonly type: "positional";
+        readonly description: "Image URL";
+        readonly required: false;
+    };
+    readonly source: {
+        readonly type: "string";
+        readonly description: "Source enum";
+        readonly required: false;
+    };
+    readonly "max-wait": {
+        readonly type: "string";
+        readonly description: "Max wait ms (default 30000)";
+        readonly required: false;
+    };
+    readonly context: {
+        readonly type: "string";
+        readonly description: "Description context hint";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=use.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../src/commands/images/use.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;EA8CrB,CAAC"}

package/dist/commands/images/use.js

@@ -0,0 +1,66 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet, apiPost } from "../../client.js";
+import { writeJson } from "../../output.js";
+import { registerSchema } from "../../schemas.js";
+registerSchema({
+    command: "images.use",
+    description: "Ingest a URL and wait for the library record to be ready.",
+    args: {
+        url: { type: "string", description: "Image URL", required: true },
+        source: { type: "string", description: "Image source enum", required: false, default: "uploaded" },
+        "max-wait": { type: "number", description: "Max wait ms", required: false, default: 30000 },
+        context: {
+            type: "string",
+            description: "Free-text hint passed to Gemini describe to bias the generated description and tags",
+            required: false,
+        },
+    },
+});
+const POLL_INTERVAL_MS = 1500;
+export const useCommand = defineCommand({
+    meta: {
+        name: "use",
+        description: "Sugar over `ingest`: download → store → wait until describe + embed complete → return ready library record.\n\nExample: baker images use https://cdn.example.com/hero.png --source uploaded",
+    },
+    args: {
+        url: { type: "positional", description: "Image URL", required: false },
+        source: { type: "string", description: "Source enum", required: false },
+        "max-wait": { type: "string", description: "Max wait ms (default 30000)", required: false },
+        context: { type: "string", description: "Description context hint", required: false },
+    },
+    run: async ({ args }) => {
+        try {
+            const url = args.url;
+            if (!url) {
+                writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "URL is required" } });
+                process.exit(1);
+            }
+            const source = args.source ?? "uploaded";
+            const maxWait = args["max-wait"] ? Number(args["max-wait"]) : 30000;
+            const ingestBody = { url, source };
+            if (args.context)
+                ingestBody.descriptionContext = args.context;
+            const ingestResult = await apiPost("/api/images/ingest", ingestBody);
+            const start = Date.now();
+            while (Date.now() - start < maxWait) {
+                const doc = await apiGet("/api/images/get", { id: ingestResult.imageId });
+                if (doc.status === "ready" || doc.status === "error") {
+                    writeJson({ ok: true, data: { ...ingestResult, image: doc } });
+                    return;
+                }
+                await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+            }
+            writeJson({ ok: false, error: { code: "TIMEOUT", message: `Image not ready within ${maxWait}ms` } });
+            process.exit(1);
+        }
+        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=use.js.map

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

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

package/dist/commands/research/advertisers.d.ts

@@ -0,0 +1,34 @@
+export declare const advertisersCommand: import("citty").CommandDef<{
+    readonly keyword: {
+        readonly type: "positional";
+        readonly description: "Keyword to search";
+        readonly required: true;
+    };
+    readonly location: {
+        readonly type: "string";
+        readonly description: "Country code or location code (default: us)";
+        readonly required: false;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language code or name (default: en)";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results (default: 20, max: 100)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md|jsonl";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip server cache, hit API directly";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=advertisers.d.ts.map

package/dist/commands/research/advertisers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advertisers.d.ts","sourceRoot":"","sources":["../../../src/commands/research/advertisers.ts"],"names":[],"mappings":"AA6CA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8C7B,CAAC"}

package/dist/commands/research/advertisers.js

@@ -0,0 +1,78 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.js";
+import { buildResearchQueryContext, warnDefaults } from "../../geo-context.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, RESEARCH_DATA_NOTE, writeResearchJson, writeResearchOutput } from "./output.js";
+registerSchema({
+    command: "research.advertisers",
+    description: "Find domains competing for a keyword in Google SERPs. Shows who's competing for the same search term with their visibility and estimated traffic. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
+    args: {
+        keyword: { type: "string", description: "Keyword to search (positional)", required: true },
+        location: {
+            type: "string",
+            description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted — always set this for non-US markets",
+            required: false,
+        },
+        language: {
+            type: "string",
+            description: "Language code or name (en, es, spanish...). DEFAULTS TO en (English) if omitted — always set this for non-English markets",
+            required: false,
+        },
+        limit: { type: "string", description: "Max results (default: 20, max: 100)", required: false },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    domain: "Competing domain",
+    avg_position: "Average SERP position (1 = top)",
+    rating: "Domain relevance rating (0-100)",
+    etv: "Estimated traffic value (USD)",
+    visibility: "SERP visibility score (0-1)",
+};
+export const advertisersCommand = defineCommand({
+    meta: {
+        name: "advertisers",
+        description: `Find domains competing for a keyword in Google SERPs.
+
+Examples:
+  baker research advertisers "running shoes"
+  baker research advertisers "crm software" --location uk --limit 10
+  baker research advertisers "zapatos" --location es --language spanish`,
+    },
+    args: {
+        keyword: { type: "positional", description: "Keyword to search", required: true },
+        location: { type: "string", description: "Country code or location code (default: us)", required: false },
+        language: { type: "string", description: "Language code or name (default: en)", required: false },
+        limit: { type: "string", description: "Max results (default: 20, max: 100)", required: false },
+        output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+    run: async ({ args }) => {
+        const keyword = args.keyword;
+        const location = args.location || undefined;
+        const language = args.language || undefined;
+        const limit = args.limit ? Number(args.limit) : undefined;
+        const skipCache = args["no-cache"] ? true : undefined;
+        const queryContext = buildResearchQueryContext(location, language);
+        try {
+            const data = await apiPost("/api/research/advertisers", {
+                keyword,
+                location,
+                language,
+                limit,
+                skipCache,
+            });
+            warnDefaults(queryContext);
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput(data, format);
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS, note: RESEARCH_DATA_NOTE, query_context: queryContext });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=advertisers.js.map