@koda-sl/baker-cli 0.5.1 → 0.11.0

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

@@ -0,0 +1,30 @@
+import { defineCommand } from "citty";
+import { accountsCommand } from "./accounts.js";
+import { changesCommand } from "./changes.js";
+import { currencyCommand } from "./currency.js";
+import { keywordsCommand } from "./keywords/index.js";
+import { queryCommand } from "./query.js";
+export const googleCommand = defineCommand({
+    meta: {
+        name: "google",
+        description: `Google Ads commands. Query campaigns, keywords, search terms, and more via GAQL.
+
+Start here:
+  baker ads google accounts                    — list accessible accounts
+  baker ads google query --list-presets        — see available query templates
+
+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 currency --customer-id 1234567890
+  baker ads google keywords discover --customer-id 1234567890 --seeds "running shoes"`,
+    },
+    subCommands: {
+        accounts: accountsCommand,
+        currency: currencyCommand,
+        changes: changesCommand,
+        query: queryCommand,
+        keywords: keywordsCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/ads/google/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;;;;;;sFAUqE;KACnF;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE,eAAe;KAC1B;CACF,CAAC,CAAC"}

package/dist/commands/ads/google/keywords/discover.d.ts

@@ -0,0 +1,49 @@
+export declare const discoverCommand: import("citty").CommandDef<{
+    readonly "customer-id": {
+        readonly type: "string";
+        readonly description: "Google Ads customer ID";
+        readonly required: false;
+    };
+    readonly seeds: {
+        readonly type: "string";
+        readonly description: "Comma-separated seed keywords";
+        readonly required: false;
+    };
+    readonly url: {
+        readonly type: "string";
+        readonly description: "URL to extract ideas from";
+        readonly required: false;
+    };
+    readonly location: {
+        readonly type: "string";
+        readonly description: "Geo target ID (default 2840)";
+        readonly required: false;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language ID (default 1000)";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results (default 20)";
+        readonly required: false;
+    };
+    readonly cursor: {
+        readonly type: "string";
+        readonly description: "Pagination cursor from previous response";
+        readonly required: false;
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|jsonl|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/commands/ads/google/keywords/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/google/keywords/discover.ts"],"names":[],"mappings":"AAiGA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8D1B,CAAC"}

package/dist/commands/ads/google/keywords/discover.js

@@ -0,0 +1,139 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../../../client.js";
+import { registerSchema } from "../../../../schemas.js";
+import { buildQueryCacheKey, cacheGet, cacheSet, getManagerIdForCustomer } from "../../cache.js";
+import { resolveCustomerId, writeAdsJson, writeAdsOutput } from "../../output.js";
+registerSchema({
+    command: "ads.google.keywords.discover",
+    description: "Discover keyword ideas from seed keywords or URLs. Returns { keywords, total_results, next_page_token? } with snake_case fields matching the Google Ads API.",
+    args: {
+        "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,
+        },
+        seeds: { type: "string", description: "Comma-separated seed keywords (max 10)", required: false },
+        url: { type: "string", description: "URL to extract keyword ideas from", required: false },
+        location: { type: "string", description: "Geo target ID (default: 2840 for US)", required: false },
+        language: { type: "string", description: "Language ID (default: 1000 for English)", required: false },
+        limit: { type: "string", description: "Max keyword ideas (default: 20, max: 100)", required: false, default: 20 },
+        cursor: {
+            type: "string",
+            description: "Pagination cursor from previous response (next_page_token)",
+            required: false,
+        },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    },
+});
+const KEYWORD_IDEA_FIELDS = {
+    keyword: "Suggested keyword text",
+    avg_monthly_searches: "Average monthly search volume (string)",
+    competition: "Competition level: LOW, MEDIUM, HIGH",
+    competition_index: "Competition index 0-100 as string (higher = more competitive)",
+    low_top_of_page_bid_micros: "Low-range CPC bid in micros (÷ 1,000,000 for currency)",
+    high_top_of_page_bid_micros: "High-range CPC bid in micros (÷ 1,000,000 for currency)",
+    monthly_search_volumes: "Monthly search volume breakdown (array of {year, month, monthly_searches})",
+};
+function buildDiscoverBody(customerId, args) {
+    const body = {
+        customerId,
+        pageSize: args.limit ? Number(args.limit) : 20,
+    };
+    const managerId = getManagerIdForCustomer(customerId);
+    if (managerId)
+        body.managerId = managerId;
+    const seeds = args.seeds
+        ? args.seeds
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : undefined;
+    if (seeds)
+        body.seeds = seeds;
+    if (args.url)
+        body.url = args.url;
+    if (args.location)
+        body.locationIds = [args.location];
+    if (args.language)
+        body.languageId = args.language;
+    if (args.cursor)
+        body.pageToken = args.cursor;
+    return body;
+}
+function handleKeywordError(err) {
+    if (err instanceof ApiError) {
+        const envelope = {
+            ok: false,
+            error: {
+                code: err.code,
+                message: err.message,
+                fix: { action: "reject", explanation: err.message },
+                retryable: err.code === "RATE_LIMITED",
+            },
+        };
+        writeAdsJson(envelope);
+        process.exit(1);
+    }
+    writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+    process.exit(1);
+}
+export const discoverCommand = defineCommand({
+    meta: {
+        name: "discover",
+        description: `Discover new keyword ideas from seed keywords or competitor URLs.
+
+Examples:
+  baker ads google keywords discover --customer-id 1234567890 --seeds "running shoes,athletic footwear"
+  baker ads google keywords discover --customer-id 1234567890 --url "https://competitor.com"
+  baker ads google keywords discover --customer-id 1234567890 --seeds "seo tools" --location 2826 --limit 50`,
+    },
+    args: {
+        "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+        seeds: { type: "string", description: "Comma-separated seed keywords", required: false },
+        url: { type: "string", description: "URL to extract ideas from", required: false },
+        location: { type: "string", description: "Geo target ID (default 2840)", required: false },
+        language: { type: "string", description: "Language ID (default 1000)", required: false },
+        limit: { type: "string", description: "Max results (default 20)", required: false },
+        cursor: { type: "string", description: "Pagination cursor from previous response", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const customerId = resolveCustomerId(args);
+        if (!args.seeds && !args.url) {
+            writeAdsJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: "Provide --seeds or --url (at least one required)" },
+            });
+            process.exit(1);
+        }
+        const body = buildDiscoverBody(customerId, args);
+        const useCache = !args["no-cache"] && !args.cursor;
+        if (!useCache)
+            body.skipCache = true;
+        const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
+        if (useCache) {
+            const cached = cacheGet("keywords", cacheKey);
+            if (cached) {
+                writeAdsJson({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const data = await apiPost("/api/ads/google/keywords/discover", body);
+            if (useCache) {
+                cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data.keywords, format);
+                return;
+            }
+            writeAdsJson({ ok: true, data, fields: KEYWORD_IDEA_FIELDS });
+        }
+        catch (err) {
+            handleKeywordError(err);
+        }
+    },
+});
+//# sourceMappingURL=discover.js.map

package/dist/commands/ads/google/keywords/discover.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/google/keywords/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,qDAa1B,CAAC"}

package/dist/commands/ads/google/keywords/index.js

@@ -0,0 +1,18 @@
+import { defineCommand } from "citty";
+import { discoverCommand } from "./discover.js";
+import { metricsCommand } from "./metrics.js";
+export const keywordsCommand = defineCommand({
+    meta: {
+        name: "keywords",
+        description: `Keyword research tools. Subcommands: discover, metrics.
+
+Examples:
+  baker ads google keywords discover --customer-id 1234567890 --seeds "running shoes"
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "running shoes,nike shoes"`,
+    },
+    subCommands: {
+        discover: discoverCommand,
+        metrics: metricsCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/ads/google/keywords/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;mGAIkF;KAChG;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}

package/dist/commands/ads/google/keywords/metrics.d.ts

@@ -0,0 +1,34 @@
+export declare const metricsCommand: import("citty").CommandDef<{
+    readonly "customer-id": {
+        readonly type: "string";
+        readonly description: "Google Ads customer ID";
+        readonly required: false;
+    };
+    readonly keywords: {
+        readonly type: "string";
+        readonly description: "Comma-separated keywords";
+        readonly required: true;
+    };
+    readonly location: {
+        readonly type: "string";
+        readonly description: "Geo target ID (default 2840)";
+        readonly required: false;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language ID (default 1000)";
+        readonly required: false;
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|jsonl|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/commands/ads/google/keywords/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/google/keywords/metrics.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6FzB,CAAC"}

package/dist/commands/ads/google/keywords/metrics.js

@@ -0,0 +1,111 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../../../client.js";
+import { registerSchema } from "../../../../schemas.js";
+import { buildQueryCacheKey, cacheGet, cacheSet, getManagerIdForCustomer } from "../../cache.js";
+import { resolveCustomerId, writeAdsJson, writeAdsOutput } from "../../output.js";
+registerSchema({
+    command: "ads.google.keywords.metrics",
+    description: "Get historical metrics for specific keywords. Returns { historical_metrics: [...] } with snake_case fields matching the Google Ads API.",
+    args: {
+        "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,
+        },
+        keywords: { type: "string", description: "Comma-separated keywords to analyze (max 200)", required: true },
+        location: { type: "string", description: "Geo target ID (default: 2840 for US)", required: false },
+        language: { type: "string", description: "Language ID (default: 1000 for English)", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    },
+});
+export const metricsCommand = defineCommand({
+    meta: {
+        name: "metrics",
+        description: `Get historical search metrics for specific keywords.
+
+Examples:
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "running shoes,nike shoes,adidas shoes"
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "seo tools" --location 2826`,
+    },
+    args: {
+        "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+        keywords: { type: "string", description: "Comma-separated keywords", required: true },
+        location: { type: "string", description: "Geo target ID (default 2840)", required: false },
+        language: { type: "string", description: "Language ID (default 1000)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const customerId = resolveCustomerId(args);
+        const keywords = args.keywords
+            .split(",")
+            .map((k) => k.trim())
+            .filter(Boolean);
+        if (keywords.length === 0) {
+            writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "At least one keyword is required" } });
+            process.exit(1);
+        }
+        if (keywords.length > 200) {
+            writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Maximum 200 keywords per request" } });
+            process.exit(1);
+        }
+        const body = { customerId, keywords };
+        const managerId = getManagerIdForCustomer(customerId);
+        if (managerId)
+            body.managerId = managerId;
+        if (args.location)
+            body.locationIds = [args.location];
+        if (args.language)
+            body.languageId = args.language;
+        const useCache = !args["no-cache"];
+        if (!useCache)
+            body.skipCache = true;
+        const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
+        if (useCache) {
+            const cached = cacheGet("keywords", cacheKey);
+            if (cached) {
+                writeAdsJson({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const data = await apiPost("/api/ads/google/keywords/metrics", body);
+            if (useCache) {
+                cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data.historical_metrics, format);
+                return;
+            }
+            const fields = {
+                keyword: "The keyword analyzed",
+                avg_monthly_searches: "Average monthly search volume as string (last 12 months)",
+                competition: "Competition level: LOW, MEDIUM, HIGH",
+                competition_index: "Competition index 0-100 as string (higher = more competitive)",
+                low_top_of_page_bid_micros: "Low-range CPC bid in micros (÷ 1,000,000 for currency)",
+                high_top_of_page_bid_micros: "High-range CPC bid in micros (÷ 1,000,000 for currency)",
+                monthly_search_volumes: "Monthly search volume breakdown (array of {year, month, monthly_searches})",
+            };
+            writeAdsJson({ ok: true, data, fields });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                const envelope = {
+                    ok: false,
+                    error: {
+                        code: err.code,
+                        message: err.message,
+                        fix: { action: "reject", explanation: err.message },
+                        retryable: err.code === "RATE_LIMITED",
+                    },
+                };
+                writeAdsJson(envelope);
+                process.exit(1);
+            }
+            writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=metrics.js.map

package/dist/commands/ads/google/keywords/metrics.js.map

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

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

@@ -0,0 +1,3 @@
+import type { PreflightResult } from "../types.ts";
+export declare function validatePreflight(query: string, customerId: string, limit?: number): PreflightResult;
+//# sourceMappingURL=preflight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/google/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,aAAa,CAAC;AAkD/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAkFpG"}

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

@@ -0,0 +1,115 @@
+function buildCommand(query, customerId) {
+    return `baker ads google query "${query}" --customer-id ${customerId}`;
+}
+function applyAutoFixes(query, limit) {
+    let corrected = query;
+    const warnings = [];
+    // keyword.text → ad_group_criterion.keyword.text
+    if (/\bkeyword\.text\b/.test(corrected) && !/ad_group_criterion\.keyword\.text/.test(corrected)) {
+        corrected = corrected.replace(/\bkeyword\.text\b/g, "ad_group_criterion.keyword.text");
+        warnings.push({ code: "FIELD_RENAMED", message: "keyword.text → ad_group_criterion.keyword.text" });
+    }
+    // keyword.match_type → ad_group_criterion.keyword.match_type
+    if (/\bkeyword\.match_type\b/.test(corrected) && !/ad_group_criterion\.keyword\.match_type/.test(corrected)) {
+        corrected = corrected.replace(/\bkeyword\.match_type\b/g, "ad_group_criterion.keyword.match_type");
+        warnings.push({ code: "FIELD_RENAMED", message: "keyword.match_type → ad_group_criterion.keyword.match_type" });
+    }
+    // shopping_performance_view.product_* → segments.product_*
+    if (/shopping_performance_view\.product_\w+/.test(corrected)) {
+        corrected = corrected.replace(/shopping_performance_view\.product_(\w+)/g, "segments.product_$1");
+        warnings.push({ code: "FIELD_RENAMED", message: "shopping_performance_view.product_* → segments.product_*" });
+    }
+    // campaign.status = 'ACTIVE' → 'ENABLED'
+    if (/campaign\.status\s*=\s*'ACTIVE'/i.test(corrected)) {
+        corrected = corrected.replace(/campaign\.status\s*=\s*'ACTIVE'/gi, "campaign.status = 'ENABLED'");
+        warnings.push({ code: "ENUM_CORRECTED", message: "campaign.status ACTIVE → ENABLED" });
+    }
+    // ad_group.status = 'ACTIVE' → 'ENABLED'
+    if (/ad_group\.status\s*=\s*'ACTIVE'/i.test(corrected)) {
+        corrected = corrected.replace(/ad_group\.status\s*=\s*'ACTIVE'/gi, "ad_group.status = 'ENABLED'");
+        warnings.push({ code: "ENUM_CORRECTED", message: "ad_group.status ACTIVE → ENABLED" });
+    }
+    // Missing LIMIT
+    if (!/\bLIMIT\b/i.test(corrected)) {
+        const effectiveLimit = limit ?? 200;
+        corrected = `${corrected.trimEnd()} LIMIT ${effectiveLimit}`;
+        warnings.push({ code: "AUTO_LIMIT", message: `Added LIMIT ${effectiveLimit}. Use --limit to override.` });
+    }
+    return { query: corrected, warnings };
+}
+export function validatePreflight(query, customerId, limit) {
+    const warnings = [];
+    const corrected = query;
+    // REJECT: Non-SELECT queries
+    const firstWord = corrected.trim().split(/\s+/)[0]?.toUpperCase();
+    if (firstWord && firstWord !== "SELECT") {
+        return {
+            valid: false,
+            warnings: [],
+            error: {
+                ok: false,
+                error: {
+                    code: "READ_ONLY",
+                    message: `Only SELECT queries are allowed. Got: ${firstWord}`,
+                    fix: {
+                        action: "reject",
+                        explanation: "This CLI only supports GAQL SELECT queries for reading data",
+                    },
+                    retryable: false,
+                },
+            },
+        };
+    }
+    // REJECT: CONTAINS usage
+    const containsMatch = corrected.match(/CONTAINS\s*\(\s*([^,]+),\s*'([^']+)'\s*\)/i);
+    if (containsMatch) {
+        const field = containsMatch[1]?.trim();
+        const value = containsMatch[2] ?? "";
+        const fixed = corrected.replace(/CONTAINS\s*\(\s*[^,]+,\s*'[^']+'\s*\)/i, `${field} LIKE '%${value}%'`);
+        return {
+            valid: false,
+            warnings: [],
+            error: {
+                ok: false,
+                error: {
+                    code: "INVALID_OPERATOR",
+                    message: "GAQL does not support CONTAINS. Use LIKE with % wildcards.",
+                    fix: {
+                        action: "change_operator",
+                        correctedCommand: buildCommand(fixed, customerId),
+                        explanation: "GAQL uses LIKE '%value%' for substring matching, not CONTAINS()",
+                    },
+                    retryable: false,
+                },
+            },
+        };
+    }
+    // REJECT: Open-ended date range
+    const openDateMatch = corrected.match(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i);
+    if (openDateMatch && !/BETWEEN/i.test(corrected)) {
+        const startDate = openDateMatch[1] ?? "";
+        const today = new Date().toISOString().slice(0, 10);
+        const fixed = corrected.replace(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i, `segments.date BETWEEN '${startDate}' AND '${today}'`);
+        return {
+            valid: false,
+            warnings: [],
+            error: {
+                ok: false,
+                error: {
+                    code: "OPEN_ENDED_DATE",
+                    message: "Open-ended date ranges are not supported. Use BETWEEN or DURING.",
+                    fix: {
+                        action: "narrow_date_range",
+                        correctedCommand: buildCommand(fixed, customerId),
+                        explanation: "Use BETWEEN with explicit start and end dates",
+                    },
+                    retryable: false,
+                },
+            },
+        };
+    }
+    const { query: autoFixed, warnings: autoFixWarnings } = applyAutoFixes(corrected, limit);
+    warnings.push(...autoFixWarnings);
+    return { valid: true, correctedQuery: autoFixed, warnings };
+}
+//# sourceMappingURL=preflight.js.map

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

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