@koda-sl/baker-cli 0.34.1 → 0.34.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../../src/commands/ads/google/preflight.ts"],"names":[],"mappings":"AAEA,SAAS,YAAY,CAAC,KAAa,EAAE,UAAkB;IACrD,OAAO,2BAA2B,KAAK,mBAAmB,UAAU,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,KAAc;IACnD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,iDAAiD;IACjD,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAChG,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE,iCAAiC,CAAC,CAAC;QACvF,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,6DAA6D;IAC7D,IAAI,yBAAyB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,yCAAyC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5G,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,0BAA0B,EAAE,uCAAuC,CAAC,CAAC;QACnG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,4DAA4D,EAAE,CAAC,CAAC;IAClH,CAAC;IAED,2DAA2D;IAC3D,IAAI,wCAAwC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,2CAA2C,EAAE,qBAAqB,CAAC,CAAC;QAClG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,0DAA0D,EAAE,CAAC,CAAC;IAChH,CAAC;IAED,yCAAyC;IACzC,IAAI,kCAAkC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,mCAAmC,EAAE,6BAA6B,CAAC,CAAC;QAClG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,yCAAyC;IACzC,IAAI,kCAAkC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvD,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,mCAAmC,EAAE,6BAA6B,CAAC,CAAC;QAClG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,MAAM,cAAc,GAAG,KAAK,IAAI,GAAG,CAAC;QACpC,SAAS,GAAG,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,cAAc,EAAE,CAAC;QAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,cAAc,4BAA4B,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,UAAkB,EAAE,KAAc;IACjF,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,KAAK,CAAC;IAExB,6BAA6B;IAC7B,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IAClE,IAAI,SAAS,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,yCAAyC,SAAS,EAAE;oBAC7D,GAAG,EAAE;wBACH,MAAM,EAAE,QAAQ;wBAChB,WAAW,EAAE,6DAA6D;qBAC3E;oBACD,SAAS,EAAE,KAAK;iBACjB;aACF;SACF,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACpF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,wCAAwC,EAAE,GAAG,KAAK,WAAW,KAAK,IAAI,CAAC,CAAC;QACxG,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,4DAA4D;oBACrE,GAAG,EAAE;wBACH,MAAM,EAAE,iBAAiB;wBACzB,gBAAgB,EAAE,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC;wBACjD,WAAW,EAAE,iEAAiE;qBAC/E;oBACD,SAAS,EAAE,KAAK;iBACjB;aACF;SACF,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACtF,IAAI,aAAa,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAC7B,8CAA8C,EAC9C,0BAA0B,SAAS,UAAU,KAAK,GAAG,CACtD,CAAC;QACF,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,kEAAkE;oBAC3E,GAAG,EAAE;wBACH,MAAM,EAAE,mBAAmB;wBAC3B,gBAAgB,EAAE,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC;wBACjD,WAAW,EAAE,+CAA+C;qBAC7D;oBACD,SAAS,EAAE,KAAK;iBACjB;aACF;SACF,CAAC;IACJ,CAAC;IAED,0FAA0F;IAC1F,IAAI,8BAA8B,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvG,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EACL,iQAAiQ;SACpQ,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACzF,QAAQ,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;IAElC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC9D,CAAC"}

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

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

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

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

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

@@ -0,0 +1,50 @@
+import { describe, expect, it } from "vitest";
+import { validatePreflight } from "./preflight.js";
+const CID = "123-456-7890";
+describe("validatePreflight", () => {
+    it("rejects non-SELECT queries with READ_ONLY error", () => {
+        const result = validatePreflight("INSERT INTO campaign VALUES ('test')", CID);
+        expect(result.valid).toBe(false);
+        expect(result.error?.error.code).toBe("READ_ONLY");
+    });
+    it("rejects CONTAINS with INVALID_OPERATOR and suggests LIKE", () => {
+        const result = validatePreflight("SELECT campaign.name FROM campaign WHERE CONTAINS(campaign.name, 'test')", CID);
+        expect(result.valid).toBe(false);
+        expect(result.error?.error.code).toBe("INVALID_OPERATOR");
+        expect(result.error?.error.fix.explanation).toMatch(/LIKE/);
+    });
+    it("rejects open-ended date ranges with OPEN_ENDED_DATE and suggests BETWEEN", () => {
+        const result = validatePreflight("SELECT campaign.name FROM campaign WHERE segments.date >= '2024-01-01'", CID);
+        expect(result.valid).toBe(false);
+        expect(result.error?.error.code).toBe("OPEN_ENDED_DATE");
+        expect(result.error?.error.fix.correctedCommand).toMatch(/BETWEEN/);
+    });
+    it("auto-fixes keyword.text to ad_group_criterion.keyword.text", () => {
+        const result = validatePreflight("SELECT keyword.text FROM keyword_view", CID);
+        expect(result.valid).toBe(true);
+        expect(result.correctedQuery).toMatch(/ad_group_criterion\.keyword\.text/);
+        const renamed = result.warnings.find((w) => w.code === "FIELD_RENAMED");
+        expect(renamed).toBeDefined();
+    });
+    it("auto-fixes ACTIVE to ENABLED for campaign status", () => {
+        const result = validatePreflight("SELECT campaign.name FROM campaign WHERE campaign.status = 'ACTIVE'", CID);
+        expect(result.valid).toBe(true);
+        expect(result.correctedQuery).toMatch(/ENABLED/);
+        const corrected = result.warnings.find((w) => w.code === "ENUM_CORRECTED");
+        expect(corrected).toBeDefined();
+    });
+    it("adds LIMIT when missing", () => {
+        const result = validatePreflight("SELECT campaign.name FROM campaign", CID);
+        expect(result.valid).toBe(true);
+        expect(result.correctedQuery).toMatch(/LIMIT/);
+        const autoLimit = result.warnings.find((w) => w.code === "AUTO_LIMIT");
+        expect(autoLimit).toBeDefined();
+    });
+    it("passes through a valid query with no errors", () => {
+        const result = validatePreflight("SELECT campaign.name FROM campaign LIMIT 10", CID);
+        expect(result.valid).toBe(true);
+        expect(result.error).toBeUndefined();
+        expect(result.warnings).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=preflight.test.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { PresetDefinition } from "../types.ts";
+export declare function isValidDateRange(value: string): boolean;
+export declare const PRESETS: PresetDefinition[];
+export declare function getPreset(name: string): PresetDefinition | undefined;
+export declare function expandPreset(preset: PresetDefinition, params: {
+    dateRange?: string;
+    limit?: number;
+}): {
+    query: string;
+    dateRangeError?: string;
+};
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/google/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,eAAO,MAAM,OAAO,EAAE,gBAAgB,EAgErC,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEpE;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAa5C"}

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

@@ -0,0 +1,85 @@
+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: "positive-keywords",
+        description: "Positive (targeting) keywords only — excludes negatives",
+        gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group.name, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, ad_group_criterion.status, ad_group_criterion.negative FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.negative = FALSE AND campaign.status != 'REMOVED' AND ad_group_criterion.status != 'REMOVED' ORDER BY campaign.name LIMIT {limit}`,
+        defaultDateRange: "ALL_TIME",
+        defaultLimit: 500,
+    },
+    {
+        name: "negative-keywords",
+        description: "Negative keywords only — campaign and ad group level",
+        gaqlTemplate: `SELECT campaign.id, campaign.name, ad_group.name, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type, ad_group_criterion.negative FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.negative = TRUE AND campaign.status != 'REMOVED' ORDER BY campaign.name LIMIT {limit}`,
+        defaultDateRange: "ALL_TIME",
+        defaultLimit: 500,
+    },
+    {
+        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,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