@koda-sl/baker-cli 0.5.1 → 0.9.0

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

@@ -0,0 +1,71 @@
+const GAQL_DATE_RANGE_RE = /^(?:TODAY|YESTERDAY|LAST_7_DAYS|LAST_14_DAYS|LAST_30_DAYS|LAST_90_DAYS|THIS_MONTH|LAST_MONTH|THIS_QUARTER|LAST_QUARTER|THIS_YEAR|LAST_YEAR|ALL_TIME|BETWEEN\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}'\s+AND\s+'[0-9]{4}-[0-9]{2}-[0-9]{2}')$/i;
+export function isValidDateRange(value) {
+    return GAQL_DATE_RANGE_RE.test(value.trim());
+}
+export const PRESETS = [
+    {
+        name: "campaign-performance",
+        description: "Campaign-level metrics overview",
+        gaqlTemplate: `SELECT campaign.id, campaign.name, campaign.status, campaign.advertising_channel_type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.conversions_value, metrics.ctr, metrics.average_cpc FROM campaign WHERE segments.date DURING {dateRange} AND campaign.status != 'REMOVED' ORDER BY metrics.cost_micros DESC LIMIT {limit}`,
+        defaultDateRange: "LAST_30_DAYS",
+        defaultLimit: 200,
+    },
+    {
+        name: "keyword-analysis",
+        description: "Keyword performance with match type and quality",
+        gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group.name, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.ctr FROM keyword_view WHERE segments.date DURING {dateRange} AND campaign.status = 'ENABLED' ORDER BY metrics.impressions DESC LIMIT {limit}`,
+        defaultDateRange: "LAST_30_DAYS",
+        defaultLimit: 200,
+    },
+    {
+        name: "search-terms",
+        description: "Actual user search queries triggering ads",
+        gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group.name, search_term_view.search_term, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING {dateRange} AND campaign.status = 'ENABLED' ORDER BY metrics.impressions DESC LIMIT {limit}`,
+        defaultDateRange: "LAST_7_DAYS",
+        defaultLimit: 200,
+    },
+    {
+        name: "ad-copy-performance",
+        description: "Ad headline and description effectiveness",
+        gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group_ad.ad.responsive_search_ad.headlines, ad_group_ad.ad.responsive_search_ad.descriptions, ad_group_ad.ad.final_urls, metrics.impressions, metrics.clicks, metrics.conversions, metrics.ctr FROM ad_group_ad WHERE segments.date DURING {dateRange} AND ad_group_ad.status = 'ENABLED' ORDER BY metrics.impressions DESC LIMIT {limit}`,
+        defaultDateRange: "LAST_30_DAYS",
+        defaultLimit: 200,
+    },
+    {
+        name: "asset-performance",
+        description: "Performance Max asset performance labels",
+        gaqlTemplate: `SELECT campaign.id, campaign.name, asset_group.name, asset_group_asset.field_type, asset_group_asset.performance_label, asset.type, asset.text_asset.text, asset.image_asset.full_size.url FROM asset_group_asset WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX' AND segments.date DURING {dateRange} LIMIT {limit}`,
+        defaultDateRange: "LAST_30_DAYS",
+        defaultLimit: 200,
+    },
+    {
+        name: "shopping-products",
+        description: "Product-level shopping performance metrics",
+        gaqlTemplate: `SELECT campaign.id, campaign.name, segments.product_title, segments.product_item_id, segments.product_brand, segments.product_type_l1, metrics.clicks, metrics.impressions, metrics.cost_micros, metrics.conversions FROM shopping_performance_view WHERE segments.date DURING {dateRange} ORDER BY metrics.cost_micros DESC LIMIT {limit}`,
+        defaultDateRange: "LAST_30_DAYS",
+        defaultLimit: 200,
+    },
+    {
+        name: "account-summary",
+        description: "Account-level totals for a date range",
+        gaqlTemplate: `SELECT customer.id, customer.descriptive_name, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions, metrics.conversions_value FROM customer WHERE segments.date DURING {dateRange} LIMIT 1`,
+        defaultDateRange: "LAST_30_DAYS",
+        defaultLimit: 1,
+    },
+];
+export function getPreset(name) {
+    return PRESETS.find((p) => p.name === name);
+}
+export function expandPreset(preset, params) {
+    const dateRange = params.dateRange ?? preset.defaultDateRange;
+    const limit = params.limit ?? preset.defaultLimit;
+    if (!isValidDateRange(dateRange)) {
+        return {
+            query: "",
+            dateRangeError: `Invalid date range: "${dateRange}". Use a GAQL date literal (e.g. LAST_30_DAYS, TODAY) or BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'.`,
+        };
+    }
+    const query = preset.gaqlTemplate.replace(/\{dateRange\}/g, dateRange).replace(/\{limit\}/g, String(limit));
+    return { query };
+}
+//# sourceMappingURL=presets.js.map

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,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":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzE,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;YAChH,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,gBAAgB,CAAC,uCAAuC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,gBAAgB,CAAC,uCAAuC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,MAAM,MAAM,GAAqB;QAC/B,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE,6EAA6E;QAC3F,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,GAAG;KAClB,CAAC;IAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAC9F,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,aAAa,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;IACxG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,gBAAgB,GAAqB;YACzC,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,uBAAuB;YACpC,YAAY,EAAE,2CAA2C;YACzD,gBAAgB,EAAE,cAAc;YAChC,YAAY,EAAE,EAAE;SACjB,CAAC;QACF,MAAM,MAAM,GAAG,YAAY,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACtE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,uCAAuC,EAAE,CAAC,CAAC;QAC5F,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,69 @@
+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;
+    };
+    readonly "clear-cache": {
+        readonly type: "boolean";
+        readonly description: "Clear 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6DvB,CAAC"}

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

@@ -0,0 +1,305 @@
+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 },
+        "clear-cache": { type: "boolean", description: "Clear cached data", 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;
+    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);
+}
+function validateArgs(args) {
+    const customerId = 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 },
+        "clear-cache": { type: "boolean", description: "Clear 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 })),
+            });
+            return;
+        }
+        if (args["clear-cache"]) {
+            const { cacheClear } = await import("../cache.js");
+            cacheClear();
+            writeAdsJson({ ok: true, data: { message: "Cache cleared" } });
+            return;
+        }
+        const validated = 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":"AAGA,eAAO,MAAM,UAAU,qDAerB,CAAC"}

package/dist/commands/ads/index.js

@@ -0,0 +1,19 @@
+import { defineCommand } from "citty";
+import { googleCommand } from "./google/index.js";
+export const adsCommand = defineCommand({
+    meta: {
+        name: "ads",
+        description: `Ad platform commands. Currently supports Google Ads. More platforms coming soon.
+
+Platforms:
+  google  — Google Ads (GAQL queries, keywords, accounts)
+
+Examples:
+  baker ads google accounts
+  baker ads google query --preset campaign-performance --customer-id 1234567890`,
+    },
+    subCommands: {
+        google: googleCommand,
+    },
+});
+//# 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;AAElD,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACtC,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;gFAO+D;KAC7E;IACD,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;KACtB;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { AdsErrorEnvelope, AdsFileSummary, AdsSuccessEnvelope } from "./types.ts";
+type AdsOutput = AdsSuccessEnvelope<unknown> | AdsErrorEnvelope | AdsFileSummary | {
+    ok: true;
+    data: unknown;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export declare function writeAdsJson(envelope: AdsOutput): void;
+export declare function toCsvRow(values: string[]): string;
+export declare function writeAdsOutput(data: Array<Record<string, unknown>>, format: string, fields?: string[]): void;
+export declare function resolveCustomerId(args: Record<string, unknown>): string;
+export {};
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/commands/ads/output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvF,KAAK,SAAS,GACV,kBAAkB,CAAC,OAAO,CAAC,GAC3B,gBAAgB,GAChB,cAAc,GACd;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE5D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAEtD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CASjD;AAqCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAc5G;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAevE"}