@koda-sl/baker-cli 0.34.1 → 0.34.3

package/dist/commands/ads/google/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../../src/commands/ads/google/presets.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GACtB,oOAAoO,CAAC;AAEvO,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAuB;IACzC;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,iCAAiC;QAC9C,YAAY,EAAE,yWAAyW;QACvX,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,GAAG;KAClB;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,iDAAiD;QAC9D,YAAY,EAAE,+VAA+V;QAC7W,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,GAAG;KAClB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,yDAAyD;QACtE,YAAY,EAAE,6YAA6Y;QAC3Z,gBAAgB,EAAE,UAAU;QAC5B,YAAY,EAAE,GAAG;KAClB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,sDAAsD;QACnE,YAAY,EAAE,sUAAsU;QACpV,gBAAgB,EAAE,UAAU;QAC5B,YAAY,EAAE,GAAG;KAClB;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,2CAA2C;QACxD,YAAY,EAAE,4SAA4S;QAC1T,gBAAgB,EAAE,aAAa;QAC/B,YAAY,EAAE,GAAG;KAClB;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,2CAA2C;QACxD,YAAY,EAAE,iXAAiX;QAC/X,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,GAAG;KAClB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,0CAA0C;QACvD,YAAY,EAAE,kUAAkU;QAChV,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,GAAG;KAClB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,4CAA4C;QACzD,YAAY,EAAE,4UAA4U;QAC1V,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,GAAG;KAClB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,uCAAuC;QACpD,YAAY,EAAE,sNAAsN;QACpO,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,CAAC;KAChB;CACF,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAwB,EACxB,MAA8C;IAE9C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,gBAAgB,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC;IAElD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,KAAK,EAAE,EAAE;YACT,cAAc,EAAE,wBAAwB,SAAS,iGAAiG;SACnJ,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5G,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/commands/ads/google/presets.test.d.ts

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

package/dist/commands/ads/google/presets.test.d.ts.map

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

package/dist/commands/ads/google/presets.test.js

@@ -0,0 +1,79 @@
+import { describe, expect, it } from "vitest";
+import { expandPreset, getPreset, isValidDateRange } from "./presets.js";
+describe("getPreset", () => {
+    it("returns a known preset by name", () => {
+        const preset = getPreset("campaign-performance");
+        expect(preset).toBeDefined();
+        expect(preset?.name).toBe("campaign-performance");
+    });
+    it("returns undefined for an unknown preset", () => {
+        expect(getPreset("nonexistent-preset")).toBeUndefined();
+    });
+});
+describe("isValidDateRange", () => {
+    it("accepts GAQL date literals", () => {
+        for (const v of ["TODAY", "YESTERDAY", "LAST_7_DAYS", "LAST_30_DAYS", "LAST_90_DAYS", "THIS_MONTH", "ALL_TIME"]) {
+            expect(isValidDateRange(v)).toBe(true);
+        }
+    });
+    it("accepts BETWEEN with valid dates", () => {
+        expect(isValidDateRange("BETWEEN '2024-01-01' AND '2024-12-31'")).toBe(true);
+    });
+    it("is case-insensitive", () => {
+        expect(isValidDateRange("last_7_days")).toBe(true);
+        expect(isValidDateRange("between '2024-01-01' and '2024-06-01'")).toBe(true);
+    });
+    it("rejects arbitrary strings", () => {
+        expect(isValidDateRange("DROP TABLE; --")).toBe(false);
+        expect(isValidDateRange("LAST_7_DAYS; SELECT *")).toBe(false);
+        expect(isValidDateRange("")).toBe(false);
+    });
+});
+describe("expandPreset", () => {
+    const preset = {
+        name: "test-preset",
+        description: "A test preset",
+        gaqlTemplate: "SELECT * FROM campaign WHERE segments.date DURING {dateRange} LIMIT {limit}",
+        defaultDateRange: "LAST_30_DAYS",
+        defaultLimit: 100,
+    };
+    it("replaces {dateRange} and {limit} placeholders", () => {
+        const result = expandPreset(preset, { dateRange: "TODAY", limit: 50 });
+        expect(result.query).toBe("SELECT * FROM campaign WHERE segments.date DURING TODAY LIMIT 50");
+        expect(result.dateRangeError).toBeUndefined();
+    });
+    it("uses default dateRange when not provided", () => {
+        const result = expandPreset(preset, { limit: 10 });
+        expect(result.query).toContain("DURING LAST_30_DAYS");
+    });
+    it("uses default limit when not provided", () => {
+        const result = expandPreset(preset, { dateRange: "LAST_7_DAYS" });
+        expect(result.query).toContain("LIMIT 100");
+    });
+    it("uses all defaults when params are empty", () => {
+        const result = expandPreset(preset, {});
+        expect(result.query).toBe("SELECT * FROM campaign WHERE segments.date DURING LAST_30_DAYS LIMIT 100");
+    });
+    it("replaces multiple occurrences of the same placeholder", () => {
+        const multiPlaceholder = {
+            name: "multi",
+            description: "Multiple placeholders",
+            gaqlTemplate: "{dateRange} and {dateRange} LIMIT {limit}",
+            defaultDateRange: "LAST_30_DAYS",
+            defaultLimit: 50,
+        };
+        const result = expandPreset(multiPlaceholder, { dateRange: "TODAY" });
+        expect(result.query).toBe("TODAY and TODAY LIMIT 50");
+    });
+    it("returns dateRangeError for invalid date range", () => {
+        const result = expandPreset(preset, { dateRange: "DROP TABLE; --" });
+        expect(result.dateRangeError).toBeDefined();
+        expect(result.query).toBe("");
+    });
+    it("accepts BETWEEN date ranges", () => {
+        const result = expandPreset(preset, { dateRange: "BETWEEN '2024-01-01' AND '2024-06-30'" });
+        expect(result.dateRangeError).toBeUndefined();
+        expect(result.query).toContain("BETWEEN '2024-01-01' AND '2024-06-30'");
+    });
+});
+//# sourceMappingURL=presets.test.js.map

package/dist/commands/ads/google/presets.test.js.map

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

package/dist/commands/ads/google/query.d.ts

@@ -0,0 +1,64 @@
+export declare const queryCommand: import("citty").CommandDef<{
+    readonly query: {
+        readonly type: "positional";
+        readonly description: "GAQL query string";
+        readonly required: false;
+    };
+    readonly "customer-id": {
+        readonly type: "string";
+        readonly description: "Google Ads customer ID (10 digits, no dashes)";
+        readonly required: false;
+    };
+    readonly preset: {
+        readonly type: "string";
+        readonly description: "Named query preset";
+        readonly required: false;
+    };
+    readonly "date-range": {
+        readonly type: "string";
+        readonly description: "Date range override for presets";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows (default 200)";
+        readonly required: false;
+    };
+    readonly "list-presets": {
+        readonly type: "boolean";
+        readonly description: "List available presets";
+        readonly required: false;
+    };
+    readonly cursor: {
+        readonly type: "string";
+        readonly description: "Pagination cursor";
+        readonly required: false;
+    };
+    readonly all: {
+        readonly type: "boolean";
+        readonly description: "Auto-paginate all results";
+        readonly required: false;
+    };
+    readonly out: {
+        readonly type: "string";
+        readonly description: "File path for output";
+        readonly required: false;
+    };
+    readonly append: {
+        readonly type: "boolean";
+        readonly description: "Append to file";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|jsonl|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/ads/google/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/google/query.ts"],"names":[],"mappings":"AAySA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DvB,CAAC"}

package/dist/commands/ads/google/query.js

@@ -0,0 +1,304 @@
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../../client.js";
+import { registerSchema } from "../../../schemas.js";
+import { buildQueryCacheKey, cacheGet, cacheSet, getManagerIdForCustomer, getQueryTtl } from "../cache.js";
+import { getFieldDescriptions } from "../field-descriptions.js";
+import { resolveCustomerId, toCsvRow, writeAdsJson } from "../output.js";
+import { parseApiError } from "./error-parser.js";
+import { validatePreflight } from "./preflight.js";
+import { expandPreset, getPreset, PRESETS } from "./presets.js";
+registerSchema({
+    command: "ads.google.query",
+    description: "Run a GAQL (Google Ads Query Language) query. The most powerful command — supports any valid SELECT statement. Use --preset for common queries without writing GAQL.",
+    args: {
+        query: { type: "string", description: "GAQL SELECT query string", required: false },
+        "customer-id": {
+            type: "string",
+            description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+            required: false,
+        },
+        preset: {
+            type: "string",
+            description: "Named query preset (campaign-performance, keyword-analysis, search-terms, ad-copy-performance, asset-performance, shopping-products, account-summary)",
+            required: false,
+        },
+        "date-range": {
+            type: "string",
+            description: "Date range for presets (LAST_7_DAYS, LAST_30_DAYS, LAST_90_DAYS, or BETWEEN 'X' AND 'Y')",
+            required: false,
+        },
+        limit: { type: "number", description: "Max rows (default 200)", required: false, default: 200 },
+        "list-presets": { type: "boolean", description: "List all available query presets", required: false },
+        cursor: { type: "string", description: "Pagination cursor from previous response", required: false },
+        all: {
+            type: "boolean",
+            description: "Auto-paginate all results (use with --out for large datasets)",
+            required: false,
+        },
+        out: {
+            type: "string",
+            description: "Write data to file (format from extension: .csv, .jsonl, .json)",
+            required: false,
+        },
+        append: { type: "boolean", description: "Append to existing file (skip CSV headers)", required: false },
+        output: {
+            type: "string",
+            description: "Output format: json|csv|jsonl|md",
+            required: false,
+            default: "json",
+            enum: ["json", "csv", "jsonl", "md"],
+        },
+        "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
+    },
+});
+function extractFields(rows) {
+    if (rows.length === 0)
+        return [];
+    const first = rows[0];
+    return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, fields, append) {
+    const ext = filePath.split(".").pop()?.toLowerCase();
+    if (ext === "csv") {
+        if (!append || !existsSync(filePath)) {
+            writeFileSync(filePath, `${toCsvRow(fields)}\n`, "utf-8");
+        }
+        const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+        appendFileSync(filePath, `${csvRows.join("\n")}\n`, "utf-8");
+    }
+    else if (ext === "jsonl") {
+        const lines = rows.map((row) => JSON.stringify(row));
+        if (append && existsSync(filePath)) {
+            appendFileSync(filePath, `${lines.join("\n")}\n`, "utf-8");
+        }
+        else {
+            writeFileSync(filePath, `${lines.join("\n")}\n`, "utf-8");
+        }
+    }
+    else if (append && existsSync(filePath)) {
+        const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+        writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+    }
+    else {
+        writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+    }
+}
+function outputResults(rows, fieldDescs, warnings, args, cached, nextCursor) {
+    const format = args.output || "json";
+    const fields = Object.keys(rows[0] ?? {});
+    if (format === "csv") {
+        process.stdout.write(`${toCsvRow(fields)}\n`);
+        for (const row of rows) {
+            process.stdout.write(`${toCsvRow(fields.map((f) => String(row[f] ?? "")))}\n`);
+        }
+        return;
+    }
+    if (format === "jsonl") {
+        for (const row of rows) {
+            process.stdout.write(`${JSON.stringify(row)}\n`);
+        }
+        return;
+    }
+    if (format === "md") {
+        process.stdout.write(`| ${fields.join(" | ")} |\n`);
+        process.stdout.write(`| ${fields.map(() => "---").join(" | ")} |\n`);
+        for (const row of rows) {
+            process.stdout.write(`| ${fields.map((f) => String(row[f] ?? "")).join(" | ")} |\n`);
+        }
+        return;
+    }
+    const envelope = { ok: true, data: rows, fields: fieldDescs };
+    if (nextCursor) {
+        envelope.pagination = { hasMore: true, cursor: nextCursor };
+    }
+    if (warnings.length > 0) {
+        envelope.warnings = warnings;
+    }
+    if (cached) {
+        envelope.cached = true;
+    }
+    writeAdsJson(envelope);
+}
+function resolveGaql(args, limit) {
+    if (args.preset) {
+        const preset = getPreset(args.preset);
+        if (!preset) {
+            const available = PRESETS.map((p) => p.name).join(", ");
+            writeAdsJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: `Unknown preset: "${args.preset}". Available: ${available}` },
+            });
+            return null;
+        }
+        const expanded = expandPreset(preset, { dateRange: args["date-range"], limit });
+        if (expanded.dateRangeError) {
+            writeAdsJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: expanded.dateRangeError },
+            });
+            return null;
+        }
+        return expanded.query;
+    }
+    const gaql = args.query ?? "";
+    if (!gaql) {
+        writeAdsJson({
+            ok: false,
+            error: {
+                code: "VALIDATION_ERROR",
+                message: "Provide a GAQL query or use --preset. Run --list-presets to see options.",
+            },
+        });
+        return null;
+    }
+    return gaql;
+}
+async function fetchAllPages(body, args) {
+    let allRows = [];
+    let pageToken = args.cursor;
+    let totalRowsWritten = 0;
+    do {
+        const requestBody = { ...body };
+        if (pageToken)
+            requestBody.pageToken = pageToken;
+        const response = await apiPost("/api/ads/google/query", requestBody);
+        const rows = response.rows ?? [];
+        pageToken = response.pageToken;
+        if (args.out) {
+            const filePath = resolve(args.out);
+            const shouldAppend = args.append || totalRowsWritten > 0;
+            writeRowsToFile(filePath, rows, extractFields(rows), shouldAppend);
+            totalRowsWritten += rows.length;
+        }
+        else {
+            allRows = allRows.concat(rows);
+        }
+        if (!args.all)
+            break;
+    } while (pageToken);
+    return { allRows, lastPageToken: pageToken, totalRowsWritten };
+}
+async function executeQuery(finalQuery, args, customerId, limit, warnings, useCache, cacheKey) {
+    const body = { customerId, query: finalQuery, pageSize: limit };
+    const managerId = getManagerIdForCustomer(customerId);
+    if (managerId)
+        body.managerId = managerId;
+    if (args.cursor)
+        body.pageToken = args.cursor;
+    if (!useCache)
+        body.skipCache = true;
+    const { allRows, lastPageToken, totalRowsWritten } = await fetchAllPages(body, args);
+    if (args.out) {
+        const summary = { ok: true, fields: {}, file: resolve(args.out), rows: totalRowsWritten };
+        writeAdsJson(summary);
+        return;
+    }
+    if (useCache && allRows.length > 0) {
+        const fields = extractFields(allRows);
+        cacheSet("queries", cacheKey, allRows, getQueryTtl(finalQuery), getFieldDescriptions(fields));
+    }
+    const fields = extractFields(allRows);
+    outputResults(allRows, getFieldDescriptions(fields), warnings, args, false, lastPageToken);
+}
+async function validateArgs(args) {
+    const customerId = await resolveCustomerId(args);
+    const limit = args.limit ? Number(args.limit) : 200;
+    const gaql = resolveGaql(args, limit);
+    if (!gaql) {
+        process.exit(1);
+    }
+    const preflight = validatePreflight(gaql, customerId, limit);
+    if (!preflight.valid && preflight.error) {
+        writeAdsJson(preflight.error);
+        process.exit(1);
+    }
+    const finalQuery = preflight.correctedQuery ?? gaql;
+    return {
+        customerId,
+        limit,
+        finalQuery,
+        warnings: preflight.warnings,
+        useCache: !args["no-cache"],
+        cacheKey: buildQueryCacheKey(customerId, finalQuery),
+    };
+}
+function handleQueryError(err, finalQuery, customerId) {
+    if (err instanceof ApiError) {
+        const envelope = parseApiError(err.message, finalQuery, customerId);
+        envelope.error.gaqlExecuted = finalQuery;
+        writeAdsJson(envelope);
+        process.exit(1);
+    }
+    writeAdsJson({
+        ok: false,
+        error: {
+            code: "NETWORK_ERROR",
+            message: err instanceof Error ? err.message : "Unexpected error",
+            fix: { action: "wait_and_retry", explanation: "Network error — check connectivity and retry" },
+            retryable: true,
+            gaqlExecuted: finalQuery,
+        },
+    });
+    process.exit(1);
+}
+export const queryCommand = defineCommand({
+    meta: {
+        name: "query",
+        description: `Run GAQL queries against Google Ads. Supports raw GAQL, presets, pagination, file export, and caching.
+
+Examples:
+  baker ads google query "SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS" --customer-id 1234567890
+  baker ads google query --preset campaign-performance --customer-id 1234567890
+  baker ads google query --preset search-terms --customer-id 1234567890 --date-range LAST_7_DAYS --out results.csv
+  baker ads google query --list-presets`,
+    },
+    args: {
+        query: { type: "positional", description: "GAQL query string", required: false },
+        "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)", required: false },
+        preset: { type: "string", description: "Named query preset", required: false },
+        "date-range": { type: "string", description: "Date range override for presets", required: false },
+        limit: { type: "string", description: "Max rows (default 200)", required: false },
+        "list-presets": { type: "boolean", description: "List available presets", required: false },
+        cursor: { type: "string", description: "Pagination cursor", required: false },
+        all: { type: "boolean", description: "Auto-paginate all results", required: false },
+        out: { type: "string", description: "File path for output", required: false },
+        append: { type: "boolean", description: "Append to file", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+    run: async ({ args }) => {
+        if (args["list-presets"]) {
+            writeAdsJson({
+                ok: true,
+                data: PRESETS.map((p) => ({
+                    name: p.name,
+                    description: p.description,
+                    defaultDateRange: p.defaultDateRange,
+                    gaql: p.gaqlTemplate,
+                })),
+            });
+            return;
+        }
+        const validated = await validateArgs(args);
+        if (!validated)
+            return;
+        const { customerId, limit, finalQuery, warnings, useCache, cacheKey } = validated;
+        if (useCache) {
+            const cached = cacheGet("queries", cacheKey);
+            if (cached) {
+                const fields = extractFields(cached.data);
+                outputResults(cached.data, cached.fields ?? getFieldDescriptions(fields), warnings, args, true);
+                return;
+            }
+        }
+        try {
+            await executeQuery(finalQuery, args, customerId, limit, warnings, useCache, cacheKey);
+        }
+        catch (err) {
+            handleQueryError(err, finalQuery, customerId);
+        }
+    },
+});
+//# sourceMappingURL=query.js.map

package/dist/commands/ads/google/query.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ads/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,UAAU,qDA2BrB,CAAC"}

package/dist/commands/ads/index.js

@@ -0,0 +1,34 @@
+import { defineCommand } from "citty";
+import { googleCommand } from "./google/index.js";
+import { linkedinCommand } from "./linkedin/index.js";
+import { metaCommand } from "./meta/index.js";
+import { xCommand } from "./x/index.js";
+export const adsCommand = defineCommand({
+    meta: {
+        name: "ads",
+        description: `Ad platform commands. Each platform exposes its own native command surface — no forced parity.
+
+Platforms:
+  google    — Google Ads (GAQL queries, keywords, accounts, ad library)
+  meta      — Meta Ads (campaigns, adsets, ads, insights, previews)
+  linkedin  — LinkedIn Ads (firmographic analytics — job-title × company × industry × seniority pivots)
+  x         — X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)
+
+Examples:
+  baker ads google accounts
+  baker ads google query --preset campaign-performance --customer-id 1234567890
+  baker ads meta accounts
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
+  baker ads meta insights --object act_123 --level ad --date-preset last_7d --fields impressions,spend,ctr
+  baker ads linkedin accounts
+  baker ads x accounts
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def`,
+    },
+    subCommands: {
+        google: googleCommand,
+        meta: metaCommand,
+        linkedin: linkedinCommand,
+        x: xCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/ads/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACtC,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;;;;;;;;;;8EAgB6D;KAC3E;IACD,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,eAAe;QACzB,CAAC,EAAE,QAAQ;KACZ;CACF,CAAC,CAAC"}

package/dist/commands/ads/linkedin/account.d.ts

@@ -0,0 +1,20 @@
+export declare const accountCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Numeric account ID or urn:li:sponsoredAccount:N";
+    };
+    readonly "account-urn": {
+        readonly type: "string";
+        readonly description: "Alias for --account-id";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "json|csv|jsonl|md";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=account.d.ts.map

package/dist/commands/ads/linkedin/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/account.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EA+BzB,CAAC"}

package/dist/commands/ads/linkedin/account.js

@@ -0,0 +1,39 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleLinkedinError, resolveAccountIdArg } from "./shared.js";
+export const accountCommand = defineCommand({
+    meta: {
+        name: "account",
+        description: `Single LinkedIn ad account detail (currency, status, type).
+
+Examples:
+  baker ads linkedin account --account-id 503001492
+  baker ads linkedin account --account-urn urn:li:sponsoredAccount:503001492 --output md`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+        "account-urn": { type: "string", description: "Alias for --account-id" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "json|csv|jsonl|md", default: "json" },
+    },
+    run: async ({ args }) => {
+        const accountId = resolveAccountIdArg(args);
+        try {
+            const params = { "account-id": accountId };
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/linkedin/account", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput([data], fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+//# sourceMappingURL=account.js.map

package/dist/commands/ads/linkedin/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAYlF,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE;;;;yFAIwE;KACtF;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;QAChG,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE;KAC9E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAsB,2BAA2B,EAAE,MAAM,CAAC,CAAC;YACpF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,CAAC,IAAI,CAA8C,EAAE,GAAG,CAAC,CAAC;gBACzE,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/ads/linkedin/accounts.d.ts

@@ -0,0 +1,20 @@
+export declare const accountsCommand: import("citty").CommandDef<{
+    readonly "include-all": {
+        readonly type: "boolean";
+        readonly description: "List all accessible accounts, ignoring picker scope";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip CLI-side cache";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache (force re-fetch)";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format: json|csv|jsonl|md";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/commands/ads/linkedin/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/accounts.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EA6C1B,CAAC"}