@koda-sl/baker-cli 0.5.1 → 0.11.0

package/dist/commands/ads/output.js

@@ -0,0 +1,78 @@
+import { getEnv } from "../../env.js";
+export function writeAdsJson(envelope) {
+    process.stdout.write(`${JSON.stringify(envelope, null, 2)}\n`);
+}
+export function toCsvRow(values) {
+    return values
+        .map((v) => {
+        if (v.includes(",") || v.includes('"') || v.includes("\n")) {
+            return `"${v.replace(/"/g, '""')}"`;
+        }
+        return v;
+    })
+        .join(",");
+}
+function flattenRow(row) {
+    const flat = {};
+    for (const [key, val] of Object.entries(row)) {
+        flat[key] = typeof val === "object" && val !== null ? JSON.stringify(val) : String(val ?? "");
+    }
+    return flat;
+}
+function writeAdsCsv(data, fields) {
+    if (data.length === 0)
+        return;
+    const cols = fields ?? Object.keys(data[0] ?? {});
+    process.stdout.write(`${toCsvRow(cols)}\n`);
+    for (const row of data) {
+        const flat = flattenRow(row);
+        process.stdout.write(`${toCsvRow(cols.map((f) => flat[f] ?? ""))}\n`);
+    }
+}
+function writeAdsJsonl(data) {
+    for (const row of data) {
+        process.stdout.write(`${JSON.stringify(row)}\n`);
+    }
+}
+function writeAdsMd(data, fields) {
+    if (data.length === 0)
+        return;
+    const cols = fields ?? Object.keys(data[0] ?? {});
+    process.stdout.write(`| ${cols.join(" | ")} |\n`);
+    process.stdout.write(`| ${cols.map(() => "---").join(" | ")} |\n`);
+    for (const row of data) {
+        const flat = flattenRow(row);
+        process.stdout.write(`| ${cols.map((f) => flat[f] ?? "").join(" | ")} |\n`);
+    }
+}
+export function writeAdsOutput(data, format, fields) {
+    switch (format) {
+        case "csv":
+            writeAdsCsv(data, fields);
+            break;
+        case "jsonl":
+            writeAdsJsonl(data);
+            break;
+        case "md":
+            writeAdsMd(data, fields);
+            break;
+        default:
+            writeAdsJson({ ok: true, data });
+    }
+}
+export function resolveCustomerId(args) {
+    const fromArgs = args["customer-id"];
+    const customerId = fromArgs || getEnv().BAKER_GOOGLE_ADS_CUSTOMER_ID;
+    if (!customerId || !/^\d{10}$/.test(customerId)) {
+        writeAdsJson({
+            ok: false,
+            error: {
+                code: "INVALID_CUSTOMER_ID",
+                message: "Customer ID must be exactly 10 digits without dashes. Pass --customer-id or set BAKER_GOOGLE_ADS_CUSTOMER_ID.",
+            },
+        });
+        process.exit(1);
+    }
+    return customerId;
+}
+//# sourceMappingURL=output.js.map

package/dist/commands/ads/output.js.map

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

package/dist/commands/ads/output.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=output.test.d.ts.map

package/dist/commands/ads/output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.test.d.ts","sourceRoot":"","sources":["../../../src/commands/ads/output.test.ts"],"names":[],"mappings":""}

package/dist/commands/ads/output.test.js

@@ -0,0 +1,100 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { toCsvRow, writeAdsJson, writeAdsOutput } from "./output.js";
+describe("toCsvRow", () => {
+    it("joins simple values with commas", () => {
+        expect(toCsvRow(["a", "b", "c"])).toBe("a,b,c");
+    });
+    it("wraps values containing commas in double quotes", () => {
+        expect(toCsvRow(["hello, world", "plain"])).toBe('"hello, world",plain');
+    });
+    it("wraps values containing double quotes and escapes them", () => {
+        expect(toCsvRow(['say "hi"'])).toBe('"say ""hi"""');
+    });
+    it("wraps values containing newlines in double quotes", () => {
+        expect(toCsvRow(["line1\nline2"])).toBe('"line1\nline2"');
+    });
+    it("handles empty values", () => {
+        expect(toCsvRow(["", "a", ""])).toBe(",a,");
+    });
+    it("handles a single value", () => {
+        expect(toCsvRow(["only"])).toBe("only");
+    });
+    it("handles values with both commas and quotes", () => {
+        expect(toCsvRow(['value "with", special'])).toBe('"value ""with"", special"');
+    });
+});
+describe("writeAdsJson", () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, "write").mockReturnValue(true);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it("outputs JSON with trailing newline", () => {
+        writeAdsJson({ ok: true, data: { message: "test" } });
+        expect(writeSpy).toHaveBeenCalledTimes(1);
+        const output = writeSpy.mock.calls[0]?.[0];
+        expect(output.endsWith("\n")).toBe(true);
+        expect(JSON.parse(output)).toEqual({ ok: true, data: { message: "test" } });
+    });
+    it("pretty-prints with 2-space indentation", () => {
+        writeAdsJson({ ok: true, data: [1] });
+        const output = writeSpy.mock.calls[0]?.[0];
+        expect(output).toContain("  ");
+    });
+});
+describe("writeAdsOutput", () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, "write").mockReturnValue(true);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it("outputs CSV with header row and data rows", () => {
+        writeAdsOutput([{ name: "Campaign A", clicks: 100 }], "csv");
+        const output = writeSpy.mock.calls.map((c) => c[0]).join("");
+        const lines = output.trim().split("\n");
+        expect(lines[0]).toBe("name,clicks");
+        expect(lines[1]).toBe("Campaign A,100");
+    });
+    it("outputs CSV with specified field order", () => {
+        writeAdsOutput([{ name: "Campaign A", clicks: 100 }], "csv", ["clicks", "name"]);
+        const output = writeSpy.mock.calls.map((c) => c[0]).join("");
+        const lines = output.trim().split("\n");
+        expect(lines[0]).toBe("clicks,name");
+        expect(lines[1]).toBe("100,Campaign A");
+    });
+    it("outputs JSONL with one JSON object per line", () => {
+        writeAdsOutput([{ id: 1 }, { id: 2 }], "jsonl");
+        const output = writeSpy.mock.calls.map((c) => c[0]).join("");
+        const lines = output.trim().split("\n");
+        expect(JSON.parse(lines[0] ?? "")).toEqual({ id: 1 });
+        expect(JSON.parse(lines[1] ?? "")).toEqual({ id: 2 });
+    });
+    it("outputs markdown table format", () => {
+        writeAdsOutput([{ name: "Test", value: "42" }], "md");
+        const output = writeSpy.mock.calls.map((c) => c[0]).join("");
+        expect(output).toContain("| name | value |");
+        expect(output).toContain("| --- | --- |");
+        expect(output).toContain("| Test | 42 |");
+    });
+    it("falls back to JSON for unknown format", () => {
+        writeAdsOutput([{ id: 1 }], "unknown");
+        const output = writeSpy.mock.calls.map((c) => c[0]).join("");
+        const parsed = JSON.parse(output);
+        expect(parsed.ok).toBe(true);
+        expect(parsed.data).toEqual([{ id: 1 }]);
+    });
+    it("handles empty data arrays for CSV", () => {
+        writeAdsOutput([], "csv");
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+    it("flattens nested objects to JSON strings in CSV", () => {
+        writeAdsOutput([{ name: "A", details: { foo: "bar" } }], "csv");
+        const output = writeSpy.mock.calls.map((c) => c[0]).join("");
+        expect(output).toContain('"{""foo"":""bar""}"');
+    });
+});
+//# sourceMappingURL=output.test.js.map

package/dist/commands/ads/output.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.test.js","sourceRoot":"","sources":["../../../src/commands/ads/output.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,QAAQ,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,QAAqC,CAAC;IAE1C,UAAU,CAAC,GAAG,EAAE;QACd,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAEtD,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEtC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,QAAqC,CAAC;IAE1C,UAAU,CAAC,GAAG,EAAE;QACd,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAE7D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAEjF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAEvC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1B,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAEhE,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/ads/types.d.ts

@@ -0,0 +1,69 @@
+type FixAction = "retry_with_modified_query" | "retry_with_flag" | "use_different_resource" | "add_required_field" | "change_operator" | "narrow_date_range" | "split_query" | "authenticate" | "wait_and_retry" | "reject";
+export interface QueryFix {
+    action: FixAction;
+    correctedCommand?: string;
+    explanation: string;
+}
+export interface AdsWarning {
+    code: string;
+    message: string;
+}
+export interface AdsSuccessEnvelope<T> {
+    ok: true;
+    data: T;
+    fields?: Record<string, string>;
+    pagination?: {
+        hasMore: boolean;
+        cursor: string;
+    };
+    warnings?: AdsWarning[];
+    cached?: true;
+}
+export interface AdsErrorEnvelope {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        fix: QueryFix;
+        retryable: boolean;
+        retryAfterMs?: number;
+        gaqlExecuted?: string;
+    };
+}
+export interface AdsFileSummary {
+    ok: true;
+    fields: Record<string, string>;
+    file: string;
+    rows: number;
+    cached?: true;
+}
+export interface CorrectionContext {
+    originalQuery: string;
+    customerId: string;
+    apiErrorMessage?: string;
+}
+export interface CorrectionRule {
+    matchQuery?: RegExp;
+    matchApiError?: RegExp;
+    fix: (ctx: CorrectionContext) => QueryFix;
+}
+export interface PreflightResult {
+    valid: boolean;
+    error?: AdsErrorEnvelope;
+    correctedQuery?: string;
+    warnings: AdsWarning[];
+}
+export interface CacheEntry<T> {
+    expiresAt: number;
+    data: T;
+    fields?: Record<string, string>;
+}
+export interface PresetDefinition {
+    name: string;
+    description: string;
+    gaqlTemplate: string;
+    defaultDateRange: string;
+    defaultLimit: number;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/ads/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/ads/types.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GACV,2BAA2B,GAC3B,iBAAiB,GACjB,wBAAwB,GACxB,oBAAoB,GACpB,iBAAiB,GACjB,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,gBAAgB,GAChB,QAAQ,CAAC;AAEb,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,QAAQ,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,QAAQ,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/commands/ads/types.js

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

package/dist/commands/ads/types.js.map

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

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":"AA0CA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4C7B,CAAC"}

package/dist/commands/research/advertisers.js

@@ -0,0 +1,75 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.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.",
+    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. Default: us",
+            required: false,
+        },
+        language: {
+            type: "string",
+            description: "Language code or name (en, es, spanish...). Default: en",
+            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;
+        try {
+            const data = await apiPost("/api/research/advertisers", {
+                keyword,
+                location,
+                language,
+                limit,
+                skipCache,
+            });
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput(data, format);
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS, note: RESEARCH_DATA_NOTE });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=advertisers.js.map

package/dist/commands/research/advertisers.js.map

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

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

@@ -0,0 +1,2 @@
+export declare const countriesCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=countries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"countries.d.ts","sourceRoot":"","sources":["../../../src/commands/research/countries.ts"],"names":[],"mappings":"AA+DA,eAAO,MAAM,gBAAgB,qDAQ3B,CAAC"}

package/dist/commands/research/countries.js

@@ -0,0 +1,69 @@
+import { defineCommand } from "citty";
+import { registerSchema } from "../../schemas.js";
+import { writeResearchJson } from "./output.js";
+registerSchema({
+    command: "research.countries",
+    description: "List all supported country codes for --location flag in research commands.",
+    args: {},
+});
+const COUNTRIES = [
+    { code: "us", name: "United States" },
+    { code: "uk", name: "United Kingdom" },
+    { code: "ca", name: "Canada" },
+    { code: "au", name: "Australia" },
+    { code: "de", name: "Germany" },
+    { code: "fr", name: "France" },
+    { code: "es", name: "Spain" },
+    { code: "it", name: "Italy" },
+    { code: "br", name: "Brazil" },
+    { code: "mx", name: "Mexico" },
+    { code: "nl", name: "Netherlands" },
+    { code: "be", name: "Belgium" },
+    { code: "at", name: "Austria" },
+    { code: "ch", name: "Switzerland" },
+    { code: "pt", name: "Portugal" },
+    { code: "se", name: "Sweden" },
+    { code: "no", name: "Norway" },
+    { code: "dk", name: "Denmark" },
+    { code: "fi", name: "Finland" },
+    { code: "ie", name: "Ireland" },
+    { code: "nz", name: "New Zealand" },
+    { code: "in", name: "India" },
+    { code: "jp", name: "Japan" },
+    { code: "kr", name: "South Korea" },
+    { code: "sg", name: "Singapore" },
+    { code: "ar", name: "Argentina" },
+    { code: "cl", name: "Chile" },
+    { code: "co", name: "Colombia" },
+    { code: "pe", name: "Peru" },
+    { code: "pl", name: "Poland" },
+    { code: "cz", name: "Czech Republic" },
+    { code: "ro", name: "Romania" },
+    { code: "hu", name: "Hungary" },
+    { code: "za", name: "South Africa" },
+    { code: "il", name: "Israel" },
+    { code: "ae", name: "United Arab Emirates" },
+    { code: "sa", name: "Saudi Arabia" },
+    { code: "tr", name: "Turkey" },
+    { code: "ph", name: "Philippines" },
+    { code: "th", name: "Thailand" },
+    { code: "my", name: "Malaysia" },
+    { code: "id", name: "Indonesia" },
+    { code: "vn", name: "Vietnam" },
+    { code: "tw", name: "Taiwan" },
+    { code: "hk", name: "Hong Kong" },
+];
+const FIELDS = {
+    code: "Country code to pass as --location",
+    name: "Country name",
+};
+export const countriesCommand = defineCommand({
+    meta: {
+        name: "countries",
+        description: "List all supported country codes for --location flag.",
+    },
+    run: () => {
+        writeResearchJson({ ok: true, data: COUNTRIES, fields: FIELDS });
+    },
+});
+//# sourceMappingURL=countries.js.map

package/dist/commands/research/countries.js.map

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

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

@@ -0,0 +1,2 @@
+export declare const researchCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/research/index.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,eAAe,qDA8B1B,CAAC"}

package/dist/commands/research/index.js

@@ -0,0 +1,40 @@
+import { defineCommand } from "citty";
+import { advertisersCommand } from "./advertisers.js";
+import { countriesCommand } from "./countries.js";
+import { intentCommand } from "./intent.js";
+import { keywordGapCommand } from "./keyword-gap.js";
+import { keywordsForSiteCommand } from "./keywords-for-site.js";
+import { languagesCommand } from "./languages.js";
+import { lighthouseCommand } from "./lighthouse.js";
+export const researchCommand = defineCommand({
+    meta: {
+        name: "research",
+        description: `Competitive intelligence commands powered by DataForSEO. Shows market/competitor data — who's bidding on keywords, search intent, competitor keyword lists, keyword gaps, and landing page performance.
+
+Commands:
+  advertisers        — Who's bidding on a keyword?
+  intent             — Google Search intent classification
+  keywords-for-site  — Keywords a domain bids on
+  keyword-gap        — Keywords they have that we don't
+  lighthouse         — Landing page performance audit
+  countries          — List supported country codes
+  languages          — List supported language codes
+
+Examples:
+  baker research advertisers "running shoes"
+  baker research intent "buy running shoes,best running shoes 2026"
+  baker research keywords-for-site "competitor.com"
+  baker research keyword-gap "them.com" "us.com"
+  baker research lighthouse "https://example.com/landing"`,
+    },
+    subCommands: {
+        advertisers: advertisersCommand,
+        countries: countriesCommand,
+        intent: intentCommand,
+        "keywords-for-site": keywordsForSiteCommand,
+        "keyword-gap": keywordGapCommand,
+        languages: languagesCommand,
+        lighthouse: lighthouseCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/commands/research/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/research/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;;;;;;;;;;0DAgByC;KACvD;IACD,WAAW,EAAE;QACX,WAAW,EAAE,kBAAkB;QAC/B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,mBAAmB,EAAE,sBAAsB;QAC3C,aAAa,EAAE,iBAAiB;QAChC,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,iBAAiB;KAC9B;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,24 @@
+export declare const intentCommand: import("citty").CommandDef<{
+    readonly keywords: {
+        readonly type: "positional";
+        readonly description: "Comma-separated keywords";
+        readonly required: true;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language code or name (default: en)";
+        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=intent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/commands/research/intent.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAkDxB,CAAC"}