@koda-sl/baker-cli 0.34.1 → 0.34.3

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

@@ -0,0 +1,279 @@
+import { defineCommand } from "citty";
+import { apiGet, apiPost } from "../../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../../output.js";
+const listAdvertisers = defineCommand({
+    meta: {
+        name: "list-advertisers",
+        description: "List tracked Google advertisers and their accounts",
+    },
+    args: {
+        output: { type: "string", description: "Format: json|csv|md", default: "json" },
+    },
+    async run({ args }) {
+        const data = await apiGet("/api/ads/google/library/advertisers");
+        if (args.output !== "json") {
+            writeAdsOutput(data, args.output);
+        }
+        else {
+            writeAdsJson({ ok: true, data });
+        }
+    },
+});
+const syncStatus = defineCommand({
+    meta: {
+        name: "sync-status",
+        description: "Check the sync status and ad counts of a Google account",
+    },
+    args: {
+        accountId: {
+            type: "positional",
+            description: "Account ID to check",
+            required: true,
+        },
+        output: { type: "string", description: "Format: json", default: "json" },
+    },
+    async run({ args }) {
+        const data = await apiGet("/api/ads/google/library/account-status", {
+            accountId: args.accountId,
+        });
+        writeAdsJson({ ok: true, data });
+    },
+});
+const searchAds = defineCommand({
+    meta: {
+        name: "search-ads",
+        description: "Search and filter Google ads for an account",
+    },
+    args: {
+        accountId: {
+            type: "positional",
+            description: "Account ID to search in",
+            required: true,
+        },
+        search: {
+            type: "string",
+            description: "Search term for ad text",
+        },
+        isActive: {
+            type: "boolean",
+            description: "Filter by active ads only",
+        },
+        mediaType: {
+            type: "string",
+            description: "Filter by media type (image, video, text)",
+        },
+        sort: {
+            type: "string",
+            description: "Sort by newest or oldest",
+        },
+        limit: {
+            type: "string",
+            description: "Maximum number of ads to return (default 20)",
+        },
+        cursor: {
+            type: "string",
+            description: "Pagination cursor",
+        },
+        output: { type: "string", description: "Format: json|csv|md", default: "json" },
+    },
+    async run({ args }) {
+        const data = await apiPost("/api/ads/google/library/ads/search", {
+            accountId: args.accountId,
+            search: args.search,
+            isActive: args.isActive,
+            mediaType: args.mediaType,
+            sort: args.sort,
+            numItems: args.limit ? Number.parseInt(args.limit, 10) : undefined,
+            cursor: args.cursor,
+        });
+        if (args.output !== "json" && Array.isArray(data.page)) {
+            writeAdsOutput(data.page, args.output);
+        }
+        else {
+            writeAdsJson({ ok: true, data });
+        }
+    },
+});
+export function looksLikeDomain(query) {
+    return !query.includes(" ") && query.includes(".");
+}
+const searchAdvertiser = defineCommand({
+    meta: {
+        name: "search-advertiser",
+        description: "Search for an advertiser on the Google Ads Transparency Center",
+    },
+    args: {
+        query: {
+            type: "positional",
+            description: "Company name or domain to search for. Strongly recommended: use the domain running the ads (e.g. example.com) for more accurate results",
+            required: true,
+        },
+        output: { type: "string", description: "Format: json|csv|md", default: "json" },
+    },
+    async run({ args }) {
+        const data = await apiPost("/api/ads/google/library/search-advertiser", {
+            query: args.query,
+        });
+        const advertisers = data.advertisers ?? data.results ?? [];
+        const looksLikeDomain = !args.query.includes(" ") && args.query.includes(".");
+        if (advertisers.length === 0 && !looksLikeDomain) {
+            process.stderr.write(`No advertisers found for "${args.query}". Try searching with the domain they run ads from instead.\n`);
+        }
+        if (args.output !== "json" && advertisers.length > 0) {
+            writeAdsOutput(advertisers, args.output);
+        }
+        else {
+            writeAdsJson({ ok: true, data });
+        }
+    },
+});
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+const track = defineCommand({
+    meta: {
+        name: "track",
+        description: "Track a new Google advertiser (from search results). Waits for initial sync to complete before returning.",
+    },
+    args: {
+        id: {
+            type: "positional",
+            description: "Google Advertiser ID (e.g. AR123...)",
+            required: true,
+        },
+        name: {
+            type: "positional",
+            description: "Display name for the advertiser",
+            required: true,
+        },
+        json: {
+            type: "boolean",
+            description: "Output in JSON format",
+        },
+    },
+    async run({ args }) {
+        const data = await apiPost("/api/ads/google/library/track", {
+            id: args.id,
+            name: args.name,
+        });
+        process.stderr.write(`Tracking "${args.name}" (${args.id}). Syncing ads...\n`);
+        const deadline = Date.now() + 600_000;
+        while (Date.now() < deadline) {
+            await sleep(5_000);
+            const status = await apiGet("/api/ads/google/library/account-status", {
+                accountId: data.accountId,
+            });
+            if (!status.syncStatus) {
+                process.stderr.write(`Sync complete. ${status.totalAdCount ?? 0} ads (${status.activeAdCount ?? 0} active)\n`);
+                if (args.json) {
+                    writeAdsJson({ ok: true, data: { ...data, ...status } });
+                }
+                return;
+            }
+            if (status.syncStatus === "error") {
+                process.stderr.write("Sync failed.\n");
+                writeAdsJson({ ok: false, error: { code: "SYNC_ERROR", message: "Initial sync failed" } });
+                process.exit(1);
+            }
+            process.stderr.write(`  syncing...\n`);
+        }
+        process.stderr.write("Sync timed out after 10 minutes.\n");
+        writeAdsJson({
+            ok: false,
+            error: { code: "TIMEOUT", message: "Sync did not complete within 10 minutes" },
+        });
+        process.exit(1);
+    },
+});
+const sync = defineCommand({
+    meta: {
+        name: "sync",
+        description: "Trigger an immediate sync for a Google account. Waits for completion before returning.",
+    },
+    args: {
+        accountId: {
+            type: "positional",
+            description: "Account ID to sync",
+            required: true,
+        },
+        output: { type: "string", description: "Format: json", default: "json" },
+    },
+    async run({ args }) {
+        await apiPost("/api/ads/google/library/sync", {
+            accountId: args.accountId,
+        });
+        process.stderr.write("Sync started. Polling...\n");
+        const deadline = Date.now() + 600_000;
+        while (Date.now() < deadline) {
+            await sleep(5_000);
+            const status = await apiGet("/api/ads/google/library/account-status", {
+                accountId: args.accountId,
+            });
+            if (!status.syncStatus) {
+                process.stderr.write(`Sync complete. ${status.totalAdCount ?? 0} ads (${status.activeAdCount ?? 0} active)\n`);
+                if (args.output === "json") {
+                    writeAdsJson({ ok: true, data: status });
+                }
+                return;
+            }
+            if (status.syncStatus === "error") {
+                process.stderr.write("Sync failed.\n");
+                writeAdsJson({ ok: false, error: { code: "SYNC_ERROR", message: "Sync failed" } });
+                process.exit(1);
+            }
+            process.stderr.write("  syncing...\n");
+        }
+        process.stderr.write("Sync timed out after 10 minutes.\n");
+        writeAdsJson({ ok: false, error: { code: "TIMEOUT", message: "Sync did not complete within 10 minutes" } });
+        process.exit(1);
+    },
+});
+const searchCompetitors = defineCommand({
+    meta: {
+        name: "search-competitors",
+        description: "Search for competitors running Google ads for a keyword (DataForSEO)",
+    },
+    args: {
+        keyword: {
+            type: "positional",
+            description: "Keyword to search for",
+            required: true,
+        },
+        location: {
+            type: "string",
+            description: "Location (name or code)",
+        },
+        json: {
+            type: "boolean",
+            description: "Output in JSON format",
+        },
+    },
+    async run({ args }) {
+        const data = await apiPost("/api/research/advertisers", {
+            keyword: args.keyword,
+            location: args.location,
+        });
+        if (args.json) {
+            writeAdsJson({ ok: true, data });
+        }
+        else {
+            writeAdsOutput(data, "md");
+        }
+    },
+});
+export const library = defineCommand({
+    meta: {
+        name: "library",
+        description: "Manage and search the Google Ads Library",
+    },
+    subCommands: {
+        "list-advertisers": listAdvertisers,
+        "sync-status": syncStatus,
+        "search-ads": searchAds,
+        "search-advertiser": searchAdvertiser,
+        "search-competitors": searchCompetitors,
+        track: track,
+        sync: sync,
+    },
+});
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/ads/google/library/index.test.d.ts

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

package/dist/commands/ads/google/library/index.test.d.ts.map

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

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

@@ -0,0 +1,26 @@
+import { describe, expect, it } from "vitest";
+import { looksLikeDomain } from "./index.js";
+describe("looksLikeDomain", () => {
+    it("returns true for a bare domain", () => {
+        expect(looksLikeDomain("example.com")).toBe(true);
+    });
+    it("returns true for a subdomain", () => {
+        expect(looksLikeDomain("ads.example.com")).toBe(true);
+    });
+    it("returns false for a plain company name", () => {
+        expect(looksLikeDomain("upload-post")).toBe(false);
+    });
+    it("returns false for a brand name with dots and spaces", () => {
+        expect(looksLikeDomain("Dr. Pepper")).toBe(false);
+    });
+    it("returns false for a brand name like U.S. Army", () => {
+        expect(looksLikeDomain("U.S. Army")).toBe(false);
+    });
+    it("returns false for a domain-like name with Inc suffix", () => {
+        expect(looksLikeDomain("Amazon.com, Inc.")).toBe(false);
+    });
+    it("returns false for a name without dots", () => {
+        expect(looksLikeDomain("Nike")).toBe(false);
+    });
+});
+//# sourceMappingURL=index.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../../../src/commands/ads/google/library/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

@@ -0,0 +1,122 @@
+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,
+                },
+            },
+        };
+    }
+    // WARN: ad_group_criterion without negative field — positives and negatives will be mixed
+    if (/FROM\s+ad_group_criterion\b/i.test(corrected) && !/ad_group_criterion\.negative/i.test(corrected)) {
+        warnings.push({
+            code: "NEGATIVE_FIELD_MISSING",
+            message: "ad_group_criterion returns BOTH positive and negative keywords. Add ad_group_criterion.negative to SELECT or filter with WHERE ad_group_criterion.negative = FALSE (positives) / TRUE (negatives). Use --preset positive-keywords or negative-keywords instead.",
+        });
+    }
+    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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"}

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