@koda-sl/baker-cli 0.34.1 → 0.34.3

package/dist/commands/ads/google/correction-table.js

@@ -0,0 +1,352 @@
+function buildCommand(query, ctx) {
+    return `baker ads google query "${query}" --customer-id ${ctx.customerId}`;
+}
+export const CORRECTION_RULES = [
+    // 1. keyword.text → ad_group_criterion.keyword.text
+    {
+        matchQuery: /\bkeyword\.text\b/,
+        matchApiError: /keyword\.text/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/\bkeyword\.text\b/g, "ad_group_criterion.keyword.text");
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Use ad_group_criterion.keyword.text — keywords are accessed through the criterion resource",
+            };
+        },
+    },
+    // 2. keyword.match_type → ad_group_criterion.keyword.match_type
+    {
+        matchQuery: /\bkeyword\.match_type\b/,
+        matchApiError: /keyword\.match_type/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/\bkeyword\.match_type\b/g, "ad_group_criterion.keyword.match_type");
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Use ad_group_criterion.keyword.match_type for keyword match type",
+            };
+        },
+    },
+    // 3. campaign_budget.* queried FROM campaign
+    {
+        matchQuery: /campaign_budget\.\w+.*FROM\s+campaign\b/i,
+        matchApiError: /campaign_budget.*not.*valid.*campaign|cannot.*select.*campaign_budget/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/FROM\s+campaign\b/i, "FROM campaign_budget");
+            return {
+                action: "use_different_resource",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "campaign_budget fields must be queried FROM campaign_budget, not FROM campaign",
+            };
+        },
+    },
+    // 4. CONTAINS → LIKE
+    {
+        matchQuery: /CONTAINS\s*\(/i,
+        matchApiError: /CONTAINS.*not.*supported|invalid.*operator.*CONTAINS/i,
+        fix: (ctx) => {
+            const match = ctx.originalQuery.match(/CONTAINS\s*\(\s*([^,]+),\s*'([^']+)'\s*\)/i);
+            if (match) {
+                const field = match[1]?.trim();
+                const value = match[2] ?? "";
+                const corrected = ctx.originalQuery.replace(/CONTAINS\s*\(\s*[^,]+,\s*'[^']+'\s*\)/i, `${field} LIKE '%${value}%'`);
+                return {
+                    action: "change_operator",
+                    correctedCommand: buildCommand(corrected, ctx),
+                    explanation: "GAQL uses LIKE '%value%' for substring matching, not CONTAINS()",
+                };
+            }
+            return {
+                action: "change_operator",
+                explanation: "Replace CONTAINS(field, 'value') with field LIKE '%value%'",
+            };
+        },
+    },
+    // 5. ad_group_criterion query without negative filter — auto-add the field
+    {
+        matchQuery: /FROM\s+ad_group_criterion\b(?!.*ad_group_criterion\.negative)/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT ad_group_criterion.negative, ");
+            return {
+                action: "add_required_field",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Added ad_group_criterion.negative to distinguish positive (targeting) from negative (blocking) keywords. Filter with WHERE ad_group_criterion.negative = FALSE for positives only.",
+            };
+        },
+    },
+    // 6. Missing campaign.id in ad_group queries
+    {
+        matchQuery: /FROM\s+ad_group\b/i,
+        matchApiError: /campaign\.id.*required|must.*include.*campaign\.id/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT campaign.id, ");
+            return {
+                action: "add_required_field",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Ad group queries require campaign.id in SELECT for parent context",
+            };
+        },
+    },
+    // 6. Missing campaign.id in keyword_view queries
+    {
+        matchQuery: /FROM\s+keyword_view\b/i,
+        matchApiError: /campaign\.id.*required.*keyword/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT campaign.id, ");
+            return {
+                action: "add_required_field",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Keyword view queries require campaign.id in SELECT",
+            };
+        },
+    },
+    // 7. shopping_performance_view.product_* → segments.product_*
+    {
+        matchQuery: /shopping_performance_view\.product_\w+/,
+        matchApiError: /shopping_performance_view\.product/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/shopping_performance_view\.product_(\w+)/g, "segments.product_$1");
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Product fields are segments (segments.product_*), not fields on shopping_performance_view",
+            };
+        },
+    },
+    // 8. Open-ended date range
+    {
+        matchQuery: /segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i,
+        matchApiError: /date.*range.*must.*finite|open.*ended/i,
+        fix: (ctx) => {
+            const match = ctx.originalQuery.match(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i);
+            const startDate = match?.[1] ?? "2024-01-01";
+            const today = new Date().toISOString().slice(0, 10);
+            const corrected = ctx.originalQuery.replace(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i, `segments.date BETWEEN '${startDate}' AND '${today}'`);
+            return {
+                action: "narrow_date_range",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Use BETWEEN with explicit end date — open-ended ranges are not supported",
+            };
+        },
+    },
+    // 9. Missing LIMIT
+    {
+        matchQuery: /^(?!.*\bLIMIT\b)/is,
+        fix: (ctx) => {
+            const corrected = `${ctx.originalQuery.trimEnd()} LIMIT 200`;
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Added LIMIT 200 to prevent excessive data transfer",
+            };
+        },
+    },
+    // 10a. Customer not found (wrong customer ID)
+    {
+        matchApiError: /CUSTOMER_NOT_FOUND|not.*found.*customer/i,
+        fix: () => ({
+            action: "reject",
+            explanation: "Customer ID not found. Run 'baker ads google accounts' to list valid customer IDs, then retry with a valid --customer-id.",
+        }),
+    },
+    // 10b. Not accessible / login-customer-id required
+    {
+        matchApiError: /not.*accessible|login.customer.id/i,
+        fix: (ctx) => ({
+            action: "reject",
+            correctedCommand: buildCommand(ctx.originalQuery, ctx),
+            explanation: "Account not accessible — may need a manager (MCC) login-customer-id. Run 'baker ads google accounts' to refresh the accounts cache, then retry.",
+        }),
+    },
+    // 11. Campaign type by name matching
+    {
+        matchQuery: /campaign\.name\s*LIKE\s*'%\s*(shopping|pmax|search|display|video)\s*%'/i,
+        fix: (ctx) => {
+            const match = ctx.originalQuery.match(/campaign\.name\s*LIKE\s*'%\s*(shopping|pmax|search|display|video)\s*%'/i);
+            const typeMap = {
+                shopping: "SHOPPING",
+                pmax: "PERFORMANCE_MAX",
+                search: "SEARCH",
+                display: "DISPLAY",
+                video: "VIDEO",
+            };
+            const channelType = typeMap[match?.[1]?.toLowerCase() ?? ""] ?? "SEARCH";
+            const corrected = ctx.originalQuery.replace(/campaign\.name\s*LIKE\s*'%[^']*%'/i, `campaign.advertising_channel_type = '${channelType}'`);
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Filter by campaign.advertising_channel_type enum, not by name pattern",
+            };
+        },
+    },
+    // 12. Incompatible fields
+    {
+        matchApiError: /incompatible|mutually.*exclusive|cannot.*select.*together/i,
+        fix: () => ({
+            action: "split_query",
+            explanation: "These fields cannot be in the same query — split into separate queries and join client-side",
+        }),
+    },
+    // 13. campaign.status = 'ACTIVE' → 'ENABLED'
+    {
+        matchQuery: /campaign\.status\s*=\s*'ACTIVE'/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/campaign\.status\s*=\s*'ACTIVE'/gi, "campaign.status = 'ENABLED'");
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Campaign status uses ENABLED, not ACTIVE",
+            };
+        },
+    },
+    // 14. ad_group.status = 'ACTIVE' → 'ENABLED'
+    {
+        matchQuery: /ad_group\.status\s*=\s*'ACTIVE'/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/ad_group\.status\s*=\s*'ACTIVE'/gi, "ad_group.status = 'ENABLED'");
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Ad group status uses ENABLED, not ACTIVE",
+            };
+        },
+    },
+    // 15. ad.final_urls → ad_group_ad.ad.final_urls
+    {
+        matchQuery: /\bad\.final_urls\b(?!.*ad_group_ad)/,
+        matchApiError: /ad\.final_urls/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/\bad\.final_urls\b/g, "ad_group_ad.ad.final_urls");
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "Use the full path: ad_group_ad.ad.final_urls",
+            };
+        },
+    },
+    // 16. Rate limit / quota
+    {
+        matchApiError: /RESOURCE_EXHAUSTED|quota.*exceeded|rate.*limit/i,
+        fix: () => ({
+            action: "wait_and_retry",
+            explanation: "API quota exceeded — wait 30 seconds before retrying",
+        }),
+    },
+    // 17. WHERE on metrics
+    {
+        matchApiError: /cannot.*filter.*metric|WHERE.*metrics|prohibited.*where/i,
+        fix: () => ({
+            action: "reject",
+            explanation: "Cannot filter on metrics in WHERE clause — remove the metrics filter and filter results client-side",
+        }),
+    },
+    // 18. ORDER BY field not in SELECT
+    {
+        matchApiError: /order.*by.*field.*not.*selected|must.*select.*field.*order/i,
+        fix: (ctx) => {
+            const orderMatch = ctx.originalQuery.match(/ORDER\s+BY\s+([\w.]+)/i);
+            const field = orderMatch?.[1] ?? "field";
+            const corrected = ctx.originalQuery.replace(/SELECT\s+/i, `SELECT ${field}, `);
+            return {
+                action: "add_required_field",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: `Add ${field} to SELECT — ORDER BY fields must be selected`,
+            };
+        },
+    },
+    // 19. Results include REMOVED entities
+    {
+        matchApiError: /REMOVED.*entities|status.*filter/i,
+        fix: (ctx) => {
+            const resourceMatch = ctx.originalQuery.match(/FROM\s+(\w+)/i);
+            const resource = resourceMatch?.[1] ?? "campaign";
+            const hasWhere = /WHERE/i.test(ctx.originalQuery);
+            const suffix = hasWhere ? ` AND ${resource}.status != 'REMOVED'` : ` WHERE ${resource}.status != 'REMOVED'`;
+            const limitMatch = ctx.originalQuery.match(/(\s+LIMIT\s+\d+)/i);
+            let corrected;
+            if (limitMatch) {
+                corrected = ctx.originalQuery.replace(/(\s+LIMIT\s+\d+)/i, `${suffix}$1`);
+            }
+            else {
+                corrected = ctx.originalQuery.trimEnd() + suffix;
+            }
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: `Add status filter to exclude REMOVED ${resource}s`,
+            };
+        },
+    },
+    // 20. change_event without date constraint
+    {
+        matchQuery: /FROM\s+change_event\b(?!.*change_date_time)/i,
+        matchApiError: /change_event.*date|date.*required.*change/i,
+        fix: (ctx) => {
+            const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10);
+            const hasWhere = /WHERE/i.test(ctx.originalQuery);
+            const suffix = hasWhere
+                ? ` AND change_event.change_date_time >= '${sevenDaysAgo}'`
+                : ` WHERE change_event.change_date_time >= '${sevenDaysAgo}'`;
+            const corrected = ctx.originalQuery.trimEnd() + suffix;
+            return {
+                action: "add_required_field",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "change_event queries require a date constraint on change_date_time",
+            };
+        },
+    },
+    // 21. resource_name = 'customers/X/Y/Z' → resource.id = Z
+    {
+        matchQuery: /(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i,
+        fix: (ctx) => {
+            const match = ctx.originalQuery.match(/(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i);
+            const resource = match?.[1] ?? "campaign";
+            const id = match?.[2] ?? "ID";
+            const corrected = ctx.originalQuery.replace(/(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i, `${resource}.id = ${id}`);
+            return {
+                action: "retry_with_modified_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: `Simpler: use ${resource}.id = ${id} instead of resource_name path`,
+            };
+        },
+    },
+    // 22. segments.click_type incompatibility
+    {
+        matchApiError: /click_type.*incompatible|cannot.*click_type/i,
+        fix: (ctx) => {
+            const corrected = ctx.originalQuery.replace(/,?\s*segments\.click_type/g, "");
+            return {
+                action: "split_query",
+                correctedCommand: buildCommand(corrected, ctx),
+                explanation: "segments.click_type is incompatible with other segments — remove it or query separately",
+            };
+        },
+    },
+    // 23. Bare resource in SELECT
+    {
+        matchApiError: /cannot.*select.*bare.*resource|invalid.*field/i,
+        fix: () => ({
+            action: "retry_with_modified_query",
+            explanation: "Cannot SELECT a bare resource name — use resource.id, resource.name, or resource.resource_name",
+        }),
+    },
+    // 24. Authentication error
+    {
+        matchApiError: /unauthenticated|authentication.*required|invalid.*credentials/i,
+        fix: () => ({
+            action: "authenticate",
+            explanation: "Google Ads authentication failed — reconnect Google Ads in dashboard settings",
+        }),
+    },
+    // 25. Timeout / deadline exceeded
+    {
+        matchApiError: /timeout|deadline.*exceeded|DEADLINE_EXCEEDED/i,
+        fix: (ctx) => ({
+            action: "retry_with_modified_query",
+            correctedCommand: buildCommand(ctx.originalQuery, ctx),
+            explanation: "Query timed out — narrow the date range, add more WHERE filters, or reduce LIMIT",
+        }),
+    },
+];
+//# sourceMappingURL=correction-table.js.map

package/dist/commands/ads/google/correction-table.js.map

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

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

@@ -0,0 +1,13 @@
+export declare const currencyCommand: import("citty").CommandDef<{
+    readonly "customer-id": {
+        readonly type: "string";
+        readonly description: "Google Ads customer ID (10 digits)";
+        readonly required: false;
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=currency.d.ts.map

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

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

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

@@ -0,0 +1,68 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../../client.js";
+import { registerSchema } from "../../../schemas.js";
+import { cacheGet, cacheSet, getManagerIdForCustomer } from "../cache.js";
+import { resolveCustomerId, writeAdsJson } from "../output.js";
+import { parseApiError } from "./error-parser.js";
+registerSchema({
+    command: "ads.google.currency",
+    description: "Get the currency code for a Google Ads account. Returns currency_code, customer_id, account_name, and access_type. Call this before interpreting cost_micros values.",
+    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,
+        },
+    },
+});
+export const currencyCommand = defineCommand({
+    meta: {
+        name: "currency",
+        description: `Get account currency code. Use this to interpret metrics.cost_micros values.
+
+Examples:
+  baker ads google currency --customer-id 1234567890`,
+    },
+    args: {
+        "customer-id": { type: "string", description: "Google Ads customer ID (10 digits)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+    run: async ({ args }) => {
+        const customerId = await resolveCustomerId(args);
+        const useCache = !args["no-cache"];
+        const cacheKey = `currency:${customerId}`;
+        if (useCache) {
+            const cached = cacheGet("accounts", cacheKey);
+            if (cached) {
+                writeAdsJson({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = { "customer-id": customerId };
+            const managerId = getManagerIdForCustomer(customerId);
+            if (managerId)
+                params["manager-id"] = managerId;
+            if (!useCache)
+                params["skip-cache"] = "true";
+            const raw = await apiGet("/api/ads/google/currency", params);
+            const data = {
+                currency_code: raw.currencyCode,
+                customer_id: raw.customerId,
+            };
+            if (useCache) {
+                cacheSet("accounts", cacheKey, data, 24 * 60 * 60 * 1000);
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeAdsJson(parseApiError(err.message, "", customerId));
+                process.exit(1);
+            }
+            writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=currency.js.map

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

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

package/dist/commands/ads/google/error-parser.d.ts

@@ -0,0 +1,3 @@
+import type { AdsErrorEnvelope } from "../types.ts";
+export declare function parseApiError(errorMessage: string, originalQuery: string, customerId: string): AdsErrorEnvelope;
+//# sourceMappingURL=error-parser.d.ts.map

package/dist/commands/ads/google/error-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-parser.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/google/error-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,aAAa,CAAC;AA2BvE,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,CA0D/G"}

package/dist/commands/ads/google/error-parser.js

@@ -0,0 +1,91 @@
+import { CORRECTION_RULES } from "./correction-table.js";
+function mapErrorCode(message) {
+    if (/field.*not.*found|unrecognized.*field|not.*valid.*field/i.test(message))
+        return "FIELD_NOT_FOUND";
+    if (/not.*valid.*resource|cannot.*select.*from/i.test(message))
+        return "WRONG_RESOURCE";
+    if (/operator|CONTAINS|LIKE/i.test(message))
+        return "INVALID_OPERATOR";
+    if (/CUSTOMER_NOT_FOUND/i.test(message))
+        return "CUSTOMER_NOT_FOUND";
+    if (/login.customer.id|not.*accessible/i.test(message))
+        return "MISSING_MANAGER_ID";
+    if (/incompatible|mutually.*exclusive/i.test(message))
+        return "INCOMPATIBLE_FIELDS";
+    if (/unauthenticated|authentication/i.test(message))
+        return "AUTH_ERROR";
+    if (/permission/i.test(message))
+        return "PERMISSION_DENIED";
+    if (/RESOURCE_EXHAUSTED|quota|rate.*limit/i.test(message))
+        return "QUOTA_EXCEEDED";
+    if (/timeout|DEADLINE_EXCEEDED/i.test(message))
+        return "TIMEOUT";
+    return "API_ERROR";
+}
+function isRetryable(code) {
+    return code === "QUOTA_EXCEEDED" || code === "TIMEOUT";
+}
+function getRetryDelay(code) {
+    if (code === "QUOTA_EXCEEDED")
+        return 30000;
+    if (code === "TIMEOUT")
+        return 5000;
+    return undefined;
+}
+export function parseApiError(errorMessage, originalQuery, customerId) {
+    const ctx = {
+        originalQuery,
+        customerId,
+        apiErrorMessage: errorMessage,
+    };
+    // Try API error patterns first
+    for (const rule of CORRECTION_RULES) {
+        if (rule.matchApiError?.test(errorMessage)) {
+            const fix = rule.fix(ctx);
+            const code = mapErrorCode(errorMessage);
+            return {
+                ok: false,
+                error: {
+                    code,
+                    message: errorMessage,
+                    fix,
+                    retryable: isRetryable(code),
+                    retryAfterMs: getRetryDelay(code),
+                },
+            };
+        }
+    }
+    // Try query patterns (API might reject what preflight missed)
+    for (const rule of CORRECTION_RULES) {
+        if (rule.matchQuery?.test(originalQuery)) {
+            const fix = rule.fix(ctx);
+            const code = mapErrorCode(errorMessage);
+            return {
+                ok: false,
+                error: {
+                    code,
+                    message: errorMessage,
+                    fix,
+                    retryable: isRetryable(code),
+                    retryAfterMs: getRetryDelay(code),
+                },
+            };
+        }
+    }
+    // Fallback: unknown error
+    const code = mapErrorCode(errorMessage);
+    return {
+        ok: false,
+        error: {
+            code,
+            message: errorMessage,
+            fix: {
+                action: "reject",
+                explanation: "Unrecognized error — verify query syntax against Google Ads GAQL reference",
+            },
+            retryable: isRetryable(code),
+            retryAfterMs: getRetryDelay(code),
+        },
+    };
+}
+//# sourceMappingURL=error-parser.js.map

package/dist/commands/ads/google/error-parser.js.map

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

package/dist/commands/ads/google/error-parser.test.d.ts

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

package/dist/commands/ads/google/error-parser.test.d.ts.map

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

package/dist/commands/ads/google/error-parser.test.js

@@ -0,0 +1,48 @@
+import { describe, expect, it } from "vitest";
+import { parseApiError } from "./error-parser.js";
+const QUERY = "SELECT campaign.name FROM campaign LIMIT 10";
+const CID = "123-456-7890";
+describe("parseApiError", () => {
+    it("maps field-not-found errors to FIELD_NOT_FOUND", () => {
+        const result = parseApiError("field 'campaign.foo' not found in resource", QUERY, CID);
+        expect(result.ok).toBe(false);
+        expect(result.error.code).toBe("FIELD_NOT_FOUND");
+    });
+    it("maps authentication errors to AUTH_ERROR", () => {
+        const result = parseApiError("Request is unauthenticated", QUERY, CID);
+        expect(result.ok).toBe(false);
+        expect(result.error.code).toBe("AUTH_ERROR");
+    });
+    it("maps quota exceeded to QUOTA_EXCEEDED with retry", () => {
+        const result = parseApiError("RESOURCE_EXHAUSTED: quota exceeded for project", QUERY, CID);
+        expect(result.ok).toBe(false);
+        expect(result.error.code).toBe("QUOTA_EXCEEDED");
+        expect(result.error.retryable).toBe(true);
+        expect(result.error.retryAfterMs).toBe(30000);
+    });
+    it("maps timeout to TIMEOUT with retry", () => {
+        const result = parseApiError("DEADLINE_EXCEEDED: timeout after 60s", QUERY, CID);
+        expect(result.ok).toBe(false);
+        expect(result.error.code).toBe("TIMEOUT");
+        expect(result.error.retryable).toBe(true);
+        expect(result.error.retryAfterMs).toBe(5000);
+    });
+    it("maps unknown errors to API_ERROR with retryable false", () => {
+        const result = parseApiError("Something completely unexpected happened", QUERY, CID);
+        expect(result.ok).toBe(false);
+        expect(result.error.code).toBe("API_ERROR");
+        expect(result.error.retryable).toBe(false);
+    });
+    it("matches correction rules for keyword.text in error message", () => {
+        const query = "SELECT keyword.text FROM keyword_view LIMIT 10";
+        const result = parseApiError("keyword.text is not a valid field", query, CID);
+        expect(result.error.fix.action).toBe("retry_with_modified_query");
+        expect(result.error.fix.correctedCommand).toMatch(/ad_group_criterion\.keyword\.text/);
+    });
+    it("maps permission denied errors to PERMISSION_DENIED", () => {
+        const result = parseApiError("The caller does not have permission to access this resource", QUERY, CID);
+        expect(result.ok).toBe(false);
+        expect(result.error.code).toBe("PERMISSION_DENIED");
+    });
+});
+//# sourceMappingURL=error-parser.test.js.map

package/dist/commands/ads/google/error-parser.test.js.map

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

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

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

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

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