@koda-sl/baker-cli 0.34.1 → 0.34.3

package/dist/commands/ads/x/targeting-constants.js

@@ -0,0 +1,80 @@
+import { defineCommand } from "citty";
+import { registerSchema } from "../../../schemas.js";
+import { writeAdsJson } from "../output.js";
+import { runListCommand } from "./run-list.js";
+const ALLOWED_CONSTANTS = [
+    "locations",
+    "interests",
+    "events",
+    "platforms",
+    "platform_versions",
+    "devices",
+    "app_store_categories",
+    "network_operators",
+    "tv_markets",
+    "tv_shows",
+];
+registerSchema({
+    command: "ads.x.targetingConstants",
+    description: "Lookup X Ads targeting constants (locations, interests, events, platforms, devices, etc.). Cached 7 days. For locations: --q to filter by name, --country-code to scope.",
+    args: {
+        constant: {
+            type: "string",
+            description: `One of: ${ALLOWED_CONSTANTS.join(", ")}`,
+            required: true,
+        },
+        q: { type: "string", description: "Search query (locations only)", required: false },
+        "country-code": { type: "string", description: "ISO country code filter", required: false },
+        "location-type": { type: "string", description: "COUNTRY|REGION|CITY|... (locations only)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+export const targetingConstantsCommand = defineCommand({
+    meta: {
+        name: "targeting-constants",
+        description: `Lookup X Ads targeting constants.
+
+Examples:
+  baker ads x targeting-constants --constant locations --q Madrid --country-code ES
+  baker ads x targeting-constants --constant interests
+  baker ads x targeting-constants --constant devices`,
+    },
+    args: {
+        constant: { type: "string", description: "Targeting constant name", required: true },
+        q: { type: "string", description: "Search query", required: false },
+        "country-code": { type: "string", description: "Country filter", required: false },
+        "location-type": { type: "string", description: "Location type filter", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const constant = args.constant;
+        if (!ALLOWED_CONSTANTS.includes(constant)) {
+            writeAdsJson({
+                ok: false,
+                error: {
+                    code: "INVALID_PARAMETER",
+                    message: `Unsupported constant '${constant}'. Allowed: ${ALLOWED_CONSTANTS.join(", ")}`,
+                },
+            });
+            process.exit(1);
+        }
+        const useCache = !args["no-cache"];
+        const cacheKey = `targeting-constants:${constant}:${args.q ?? ""}:${args["country-code"] ?? ""}:${args["location-type"] ?? ""}`;
+        await runListCommand({
+            path: "/api/ads/x/targeting-constants",
+            cacheCategory: "x-targeting-constants",
+            cacheKey,
+            cacheTtlMs: 7 * 24 * 60 * 60 * 1000,
+            params: {
+                constant,
+                q: args.q,
+                "country-code": args["country-code"],
+                "location-type": args["location-type"],
+            },
+            format: args.output || "json",
+            useCache,
+        });
+    },
+});
+//# sourceMappingURL=targeting-constants.js.map

package/dist/commands/ads/x/targeting-constants.js.map

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

package/dist/commands/ads/x/targeting-criteria.d.ts

@@ -0,0 +1,24 @@
+export declare const targetingCriteriaCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "X Ads account ID";
+        readonly required: false;
+    };
+    readonly "line-item-ids": {
+        readonly type: "string";
+        readonly description: "CSV of line item IDs";
+        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|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=targeting-criteria.d.ts.map

package/dist/commands/ads/x/targeting-criteria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeting-criteria.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/x/targeting-criteria.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;EAiDnC,CAAC"}

package/dist/commands/ads/x/targeting-criteria.js

@@ -0,0 +1,69 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../../client.js";
+import { registerSchema } from "../../../schemas.js";
+import { cacheGet, cacheSet } from "../cache.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { parseXApiError } from "./error-parser.js";
+import { resolveXAccountId } from "./output.js";
+registerSchema({
+    command: "ads.x.targetingCriteria",
+    description: "List targeting criteria attached to line items in an X Ads account. Returns targeting_type, targeting_value, name, operator_type per criterion. Filter by line-item-ids.",
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+export const targetingCriteriaCommand = defineCommand({
+    meta: {
+        name: "targeting-criteria",
+        description: `List targeting criteria attached to line items.
+
+Examples:
+  baker ads x targeting-criteria --account-id 18ce53xyz --line-item-ids abc`,
+    },
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const accountId = await resolveXAccountId(args);
+        const useCache = !args["no-cache"];
+        const cacheKey = `targeting-criteria:${accountId}:${args["line-item-ids"] ?? ""}`;
+        if (useCache) {
+            const cached = cacheGet("x-account-data", cacheKey);
+            if (cached) {
+                writeAdsJson({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = { "account-id": accountId };
+            if (args["line-item-ids"])
+                params["line-item-ids"] = args["line-item-ids"];
+            if (!useCache)
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/x/targeting-criteria", params);
+            if (useCache) {
+                cacheSet("x-account-data", cacheKey, data, 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data, format);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeAdsJson(parseXApiError(err.message, accountId));
+                process.exit(1);
+            }
+            writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=targeting-criteria.js.map

package/dist/commands/ads/x/targeting-criteria.js.map

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

package/dist/commands/ga4/audit.d.ts

@@ -0,0 +1,13 @@
+export declare const auditCommand: import("citty").CommandDef<{
+    readonly "property-id": {
+        readonly type: "string";
+        readonly description: "GA4 property ID";
+        readonly required: false;
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=audit.d.ts.map

package/dist/commands/ga4/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/commands/ga4/audit.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,YAAY;;;;;;;;;;;EAmDvB,CAAC"}

package/dist/commands/ga4/audit.js

@@ -0,0 +1,67 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { cacheGet, cacheSet } from "../ads/cache.js";
+import { writeJsonEnvelope } from "../ads/output.js";
+import { resolvePropertyId } from "./resolve.js";
+registerSchema({
+    command: "ga4.audit",
+    description: "Run all GA4 admin health checks at once. Checks data retention, Google Ads linkage, phantom conversions, audience defaults, data streams, and attribution settings. Returns raw data plus playbook-aligned warnings.",
+    args: {
+        "property-id": { type: "string", description: "GA4 property ID (auto-resolved if not provided)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
+    },
+});
+export const auditCommand = defineCommand({
+    meta: {
+        name: "audit",
+        description: `Run all GA4 admin health checks. Returns property config with playbook warnings.
+
+Checks:
+  - Data retention (should be FOURTEEN_MONTHS)
+  - Google Ads linkage (must match audited account)
+  - Phantom conversions (page_view, scroll as conversions)
+  - Audience membership defaults (30-day B2B traps)
+  - Data streams and filters
+  - Attribution settings
+
+Examples:
+  baker ga4 audit
+  baker ga4 audit --property-id properties/123456789`,
+    },
+    args: {
+        "property-id": { type: "string", description: "GA4 property ID", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+    run: async ({ args }) => {
+        const propertyId = await resolvePropertyId(args);
+        const useCache = !args["no-cache"];
+        const cacheKey = `audit:${propertyId}`;
+        if (useCache) {
+            const cached = cacheGet("ga4-audit", cacheKey);
+            if (cached) {
+                writeJsonEnvelope({ ...cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const body = { propertyId };
+            if (!useCache)
+                body.skipCache = true;
+            const data = await apiPost("/api/ga4/audit", body);
+            if (useCache) {
+                cacheSet("ga4-audit", cacheKey, data, 6 * 60 * 60 * 1000);
+            }
+            writeJsonEnvelope(data);
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=audit.js.map

package/dist/commands/ga4/audit.js.map

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

package/dist/commands/ga4/index.d.ts

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

package/dist/commands/ga4/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ga4/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,UAAU,qDAoBrB,CAAC"}

package/dist/commands/ga4/index.js

@@ -0,0 +1,26 @@
+import { defineCommand } from "citty";
+import { auditCommand } from "./audit.js";
+import { propertiesCommand } from "./properties.js";
+import { queryCommand } from "./query.js";
+export const ga4Command = defineCommand({
+    meta: {
+        name: "ga4",
+        description: `Google Analytics 4 commands. Audit property config, run playbook-aligned reports.
+
+Start here:
+  baker ga4 properties                    — list accessible properties
+  baker ga4 query --list-presets          — see available report presets
+
+Examples:
+  baker ga4 audit                                                    — full property health check
+  baker ga4 query --preset tracking-health                           — compare GA4 vs GAds data
+  baker ga4 query --preset lp-performance --days 14                  — landing page UX audit
+  baker ga4 query --dimensions "date" --metrics "sessions" --days 7  — free-form query`,
+    },
+    subCommands: {
+        properties: propertiesCommand,
+        audit: auditCommand,
+        query: queryCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/commands/ga4/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/ga4/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACtC,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;;;;uFAUsE;KACpF;IACD,WAAW,EAAE;QACX,UAAU,EAAE,iBAAiB;QAC7B,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;KACpB;CACF,CAAC,CAAC"}

package/dist/commands/ga4/presets.d.ts

@@ -0,0 +1,8 @@
+interface Ga4Preset {
+    name: string;
+    description: string;
+    playbook: string;
+}
+export declare const GA4_PRESETS: Ga4Preset[];
+export {};
+//# sourceMappingURL=presets.d.ts.map

package/dist/commands/ga4/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/commands/ga4/presets.ts"],"names":[],"mappings":"AAAA,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,WAAW,EAAE,SAAS,EA+BlC,CAAC"}

package/dist/commands/ga4/presets.js

@@ -0,0 +1,33 @@
+export const GA4_PRESETS = [
+    {
+        name: "tracking-health",
+        description: "Compare GA4 sessions to GAds clicks — flag >20% discrepancy",
+        playbook: "[07] Discrepancy Check",
+    },
+    {
+        name: "lp-performance",
+        description: "Landing page UX diagnostic — flag duration <10s as message mismatch",
+        playbook: "[06] LP Diagnostic",
+    },
+    {
+        name: "traffic-quality",
+        description: "Warm traffic trap — flag >40% returning user conversions",
+        playbook: "[06] Warm Traffic Trap",
+    },
+    {
+        name: "funnel-leakage",
+        description: "Funnel drop-off analysis between form events",
+        playbook: "[06] Funnel Analysis",
+    },
+    {
+        name: "first-touch",
+        description: "First-touch attribution — true acquisition value of channels",
+        playbook: "First-Touch Attribution",
+    },
+    {
+        name: "traffic-overview",
+        description: "General traffic trends by date and source",
+        playbook: "General",
+    },
+];
+//# sourceMappingURL=presets.js.map

package/dist/commands/ga4/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/commands/ga4/presets.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,qEAAqE;QAClF,QAAQ,EAAE,oBAAoB;KAC/B;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,0DAA0D;QACvE,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,8CAA8C;QAC3D,QAAQ,EAAE,sBAAsB;KACjC;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,2CAA2C;QACxD,QAAQ,EAAE,SAAS;KACpB;CACF,CAAC"}

package/dist/commands/ga4/properties.d.ts

@@ -0,0 +1,14 @@
+export declare const propertiesCommand: import("citty").CommandDef<{
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=properties.d.ts.map

package/dist/commands/ga4/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../src/commands/ga4/properties.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EA+C5B,CAAC"}

package/dist/commands/ga4/properties.js

@@ -0,0 +1,61 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { cacheGet, cacheSet } from "../ads/cache.js";
+import { writeAdsOutput, writeJsonEnvelope } from "../ads/output.js";
+registerSchema({
+    command: "ga4.properties",
+    description: "List all accessible GA4 properties. Returns property IDs needed for query and audit commands. Run this first to find property IDs.",
+    args: {
+        "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
+    },
+});
+import { handleConnectionError } from "../../error-handler.js";
+export const propertiesCommand = defineCommand({
+    meta: {
+        name: "properties",
+        description: `List accessible GA4 properties.
+
+Examples:
+  baker ga4 properties`,
+    },
+    args: {
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const useCache = !args["no-cache"];
+        if (useCache) {
+            const cached = cacheGet("ga4-properties", "list");
+            if (cached) {
+                writeJsonEnvelope({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = !useCache ? { "skip-cache": "true" } : undefined;
+            const data = await apiGet("/api/ga4/properties", params);
+            if (useCache) {
+                cacheSet("ga4-properties", "list", data, 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data, format);
+                return;
+            }
+            writeJsonEnvelope({ ok: true, data });
+        }
+        catch (err) {
+            if (err instanceof ApiError) {
+                if (err.code === "UNAUTHORIZED" || err.code === "NOT_FOUND") {
+                    handleConnectionError("ga4", err.message);
+                }
+                writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+                process.exit(1);
+            }
+            writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=properties.js.map

package/dist/commands/ga4/properties.js.map

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

package/dist/commands/ga4/query.d.ts

@@ -0,0 +1,69 @@
+export declare const queryCommand: import("citty").CommandDef<{
+    readonly "property-id": {
+        readonly type: "string";
+        readonly description: "GA4 property ID";
+        readonly required: false;
+    };
+    readonly preset: {
+        readonly type: "string";
+        readonly description: "Named preset";
+        readonly required: false;
+    };
+    readonly dimensions: {
+        readonly type: "string";
+        readonly description: "Comma-separated dimensions";
+        readonly required: false;
+    };
+    readonly metrics: {
+        readonly type: "string";
+        readonly description: "Comma-separated metrics";
+        readonly required: false;
+    };
+    readonly days: {
+        readonly type: "string";
+        readonly description: "Lookback days (default: 30)";
+        readonly required: false;
+    };
+    readonly "start-date": {
+        readonly type: "string";
+        readonly description: "Start date override";
+        readonly required: false;
+    };
+    readonly "end-date": {
+        readonly type: "string";
+        readonly description: "End date override";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows (default: 1000)";
+        readonly required: false;
+    };
+    readonly "list-presets": {
+        readonly type: "boolean";
+        readonly description: "List presets";
+        readonly required: false;
+    };
+    readonly out: {
+        readonly type: "string";
+        readonly description: "Output file path";
+        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/ga4/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/commands/ga4/query.ts"],"names":[],"mappings":"AAgIA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwEvB,CAAC"}