@koda-sl/baker-cli 0.34.1 → 0.34.3

package/dist/commands/ga4/query.js

@@ -0,0 +1,184 @@
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { buildQueryCacheKey, cacheGet, cacheSet, getQueryTtl } from "../ads/cache.js";
+import { toCsvRow, writeAdsOutput, writeJsonEnvelope } from "../ads/output.js";
+import { GA4_PRESETS } from "./presets.js";
+import { resolvePropertyId } from "./resolve.js";
+registerSchema({
+    command: "ga4.query",
+    description: "Run GA4 Data API reports. Use --preset for playbook-aligned queries (primary usage) or --dimensions/--metrics for free-form queries.",
+    args: {
+        "property-id": { type: "string", description: "GA4 property ID (auto-resolved if not provided)", required: false },
+        preset: {
+            type: "string",
+            description: "Named preset (tracking-health, lp-performance, traffic-quality, funnel-leakage, first-touch, traffic-overview)",
+            required: false,
+        },
+        dimensions: { type: "string", description: "Comma-separated dimension names (escape hatch)", required: false },
+        metrics: { type: "string", description: "Comma-separated metric names (escape hatch)", required: false },
+        days: { type: "string", description: "Lookback window in days (default: 30)", required: false },
+        "start-date": {
+            type: "string",
+            description: "Explicit start date (YYYY-MM-DD or GA4 relative like '30daysAgo')",
+            required: false,
+        },
+        "end-date": { type: "string", description: "Explicit end date (YYYY-MM-DD or 'yesterday')", required: false },
+        limit: { type: "string", description: "Max rows (default: 1000)", required: false },
+        "list-presets": { type: "boolean", description: "List available presets", required: false },
+        out: { type: "string", description: "Write data to file (.csv, .jsonl, .json)", required: false },
+        append: { type: "boolean", description: "Append to existing file", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+function extractFields(rows) {
+    const first = rows[0];
+    return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, append) {
+    const fields = extractFields(rows);
+    const ext = filePath.split(".").pop()?.toLowerCase();
+    if (ext === "csv") {
+        if (!append || !existsSync(filePath)) {
+            writeFileSync(filePath, `${toCsvRow(fields)}\n`, "utf-8");
+        }
+        const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+        appendFileSync(filePath, `${csvRows.join("\n")}\n`, "utf-8");
+    }
+    else if (ext === "jsonl") {
+        const lines = rows.map((row) => JSON.stringify(row));
+        const content = `${lines.join("\n")}\n`;
+        if (append && existsSync(filePath)) {
+            appendFileSync(filePath, content, "utf-8");
+        }
+        else {
+            writeFileSync(filePath, content, "utf-8");
+        }
+    }
+    else if (append && existsSync(filePath)) {
+        const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+        writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+    }
+    else {
+        writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+    }
+}
+function outputRows(rows, args, response, cached) {
+    if (args.out) {
+        const filePath = resolve(args.out);
+        writeRowsToFile(filePath, rows, !!args.append);
+        writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...(cached && { cached: true }) });
+        return;
+    }
+    const format = args.output || "json";
+    if (format !== "json") {
+        writeAdsOutput(rows, format);
+        return;
+    }
+    writeJsonEnvelope({ ...response, ...(cached && { cached: true }) });
+}
+function buildRequestBody(args, propertyId, useCache) {
+    const body = { propertyId };
+    if (args.preset)
+        body.preset = args.preset;
+    if (args.dimensions)
+        body.dimensions = args.dimensions.split(",").map((d) => d.trim());
+    if (args.metrics)
+        body.metrics = args.metrics.split(",").map((m) => m.trim());
+    if (args.days)
+        body.days = Number(args.days);
+    if (args["start-date"])
+        body.startDate = args["start-date"];
+    if (args["end-date"])
+        body.endDate = args["end-date"];
+    if (args.limit)
+        body.limit = Number(args.limit);
+    if (!useCache)
+        body.skipCache = true;
+    return body;
+}
+function handleError(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: err instanceof Error ? err.message : "Unexpected error" },
+    });
+    process.exit(1);
+}
+export const queryCommand = defineCommand({
+    meta: {
+        name: "query",
+        description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
+
+Presets (primary usage):
+  baker ga4 query --preset tracking-health
+  baker ga4 query --preset lp-performance --days 14
+  baker ga4 query --list-presets
+
+Free-form (escape hatch):
+  baker ga4 query --dimensions "date,sessionSourceMedium" --metrics "sessions,conversions"
+  baker ga4 query --metrics "eventCount" --dimensions "eventName" --days 7`,
+    },
+    args: {
+        "property-id": { type: "string", description: "GA4 property ID", required: false },
+        preset: { type: "string", description: "Named preset", required: false },
+        dimensions: { type: "string", description: "Comma-separated dimensions", required: false },
+        metrics: { type: "string", description: "Comma-separated metrics", required: false },
+        days: { type: "string", description: "Lookback days (default: 30)", required: false },
+        "start-date": { type: "string", description: "Start date override", required: false },
+        "end-date": { type: "string", description: "End date override", required: false },
+        limit: { type: "string", description: "Max rows (default: 1000)", required: false },
+        "list-presets": { type: "boolean", description: "List presets", required: false },
+        out: { type: "string", description: "Output file path", required: false },
+        append: { type: "boolean", description: "Append to file", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+    run: async ({ args }) => {
+        if (args["list-presets"]) {
+            writeJsonEnvelope({
+                ok: true,
+                data: GA4_PRESETS.map((p) => ({ name: p.name, description: p.description, playbook: p.playbook })),
+            });
+            return;
+        }
+        if (!args.preset && !args.metrics) {
+            writeJsonEnvelope({
+                ok: false,
+                error: {
+                    code: "VALIDATION_ERROR",
+                    message: "Provide --preset or --metrics. Run --list-presets to see options.",
+                },
+            });
+            process.exit(1);
+        }
+        const propertyId = await resolvePropertyId(args);
+        const useCache = !args["no-cache"];
+        const body = buildRequestBody(args, propertyId, useCache);
+        const cacheKey = buildQueryCacheKey(propertyId, JSON.stringify(body));
+        if (useCache) {
+            const cached = cacheGet("ga4-queries", cacheKey);
+            if (cached) {
+                outputRows(cached.data.data ?? [], args, cached.data, true);
+                return;
+            }
+        }
+        try {
+            const response = await apiPost("/api/ga4/query", body);
+            if (useCache) {
+                cacheSet("ga4-queries", cacheKey, response, getQueryTtl(JSON.stringify(body)));
+            }
+            outputRows(response.data ?? [], args, response, false);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    },
+});
+//# sourceMappingURL=query.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function resolvePropertyId(args: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/commands/ga4/resolve.ts"],"names":[],"mappings":"AAyBA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCtF"}

package/dist/commands/ga4/resolve.js

@@ -0,0 +1,57 @@
+import { apiGet } from "../../client.js";
+import { getEnv } from "../../env.js";
+import { cacheGet, cacheSet } from "../ads/cache.js";
+import { writeJsonEnvelope } from "../ads/output.js";
+async function fetchProperties(useCache = true) {
+    if (useCache) {
+        const cached = cacheGet("ga4-properties", "list");
+        if (cached)
+            return cached.data;
+    }
+    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);
+    }
+    return data;
+}
+import { handleConnectionError } from "../../error-handler.js";
+export async function resolvePropertyId(args) {
+    const fromArgs = args["property-id"];
+    const fromEnv = getEnv().BAKER_GA4_PROPERTY_ID;
+    const propertyId = fromArgs || fromEnv;
+    if (propertyId)
+        return propertyId;
+    const useCache = !args["no-cache"];
+    try {
+        const properties = await fetchProperties(useCache);
+        const [single] = properties;
+        if (properties.length === 1 && single) {
+            process.stderr.write(`Using property "${single.name}" (${single.externalId})\n`);
+            return single.externalId;
+        }
+        if (properties.length === 0) {
+            handleConnectionError("ga4");
+        }
+        const list = properties.map((p) => `  ${p.externalId}  ${p.name}`).join("\n");
+        writeJsonEnvelope({
+            ok: false,
+            error: {
+                code: "MULTIPLE_PROPERTIES",
+                message: `Multiple properties found. Pass --property-id or set BAKER_GA4_PROPERTY_ID:\n${list}`,
+            },
+        });
+        process.exit(1);
+    }
+    catch {
+        writeJsonEnvelope({
+            ok: false,
+            error: {
+                code: "RESOLUTION_ERROR",
+                message: "Could not auto-detect property. Pass --property-id or set BAKER_GA4_PROPERTY_ID.",
+            },
+        });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=resolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/commands/ga4/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,KAAK,UAAU,eAAe,CAAC,QAAQ,GAAG,IAAI;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,QAAQ,CAAgB,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACjE,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAgB,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACxE,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAA6B;IACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAuB,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,qBAAqB,CAAC;IAC/C,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,CAAC;IAEvC,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC;QAC5B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC;YACjF,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,iBAAiB,CAAC;YAChB,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,gFAAgF,IAAI,EAAE;aAChG;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB,CAAC;YAChB,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,kFAAkF;aAC5F;SACF,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

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

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

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

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

package/dist/commands/gsc/index.js

@@ -0,0 +1,26 @@
+import { defineCommand } from "citty";
+import { queryCommand } from "./query.js";
+import { sitemapsCommand } from "./sitemaps.js";
+import { sitesCommand } from "./sites.js";
+export const gscCommand = defineCommand({
+    meta: {
+        name: "gsc",
+        description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
+
+Start here:
+  baker gsc sites                         — list verified sites
+  baker gsc query --list-presets          — see available query presets
+
+Examples:
+  baker gsc query --preset cannibalization                          — find PPC-SEO overlap
+  baker gsc query --preset brand-halo --brand "Acme" --days 90      — brand search trends
+  baker gsc query --dimensions "query,page" --days 28               — free-form query
+  baker gsc sitemaps                                                — check sitemap health`,
+    },
+    subCommands: {
+        sites: sitesCommand,
+        query: queryCommand,
+        sitemaps: sitemapsCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/gsc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,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;;;;;;;;;;2FAU0E;KACxF;IACD,WAAW,EAAE;QACX,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE,eAAe;KAC1B;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+interface GscPreset {
+    name: string;
+    description: string;
+    playbook: string;
+    requiresBrand?: boolean;
+}
+export declare const GSC_PRESETS: GscPreset[];
+export {};
+//# sourceMappingURL=presets.d.ts.map

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

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

package/dist/commands/gsc/presets.js

@@ -0,0 +1,34 @@
+export const GSC_PRESETS = [
+    {
+        name: "cannibalization",
+        description: "PPC-SEO arbitrage — find queries ranking #1-2 organically where you also pay for ads",
+        playbook: "[05] PPC-SEO Arbitrage",
+    },
+    {
+        name: "missed-revenue",
+        description: "High-impression queries with no PPC coverage (position > 10)",
+        playbook: "[05] Opportunity Finder",
+    },
+    {
+        name: "brand-halo",
+        description: "Brand search volume trends — proves upper-funnel awareness lift",
+        playbook: "[21] YouTube/DG ROI",
+        requiresBrand: true,
+    },
+    {
+        name: "negative-keywords",
+        description: "Discover negative keyword candidates (login, support, cancel queries)",
+        playbook: "Negative Keyword Discovery",
+    },
+    {
+        name: "top-pages",
+        description: "Top performing pages by clicks",
+        playbook: "General",
+    },
+    {
+        name: "top-queries",
+        description: "Top search queries by clicks",
+        playbook: "General",
+    },
+];
+//# sourceMappingURL=presets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/commands/gsc/presets.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,sFAAsF;QACnG,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,iEAAiE;QAC9E,QAAQ,EAAE,qBAAqB;QAC/B,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,uEAAuE;QACpF,QAAQ,EAAE,4BAA4B;KACvC;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gCAAgC;QAC7C,QAAQ,EAAE,SAAS;KACpB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,SAAS;KACpB;CACF,CAAC"}

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

@@ -0,0 +1,79 @@
+export declare const queryCommand: import("citty").CommandDef<{
+    readonly "site-url": {
+        readonly type: "string";
+        readonly description: "Site URL";
+        readonly required: false;
+    };
+    readonly preset: {
+        readonly type: "string";
+        readonly description: "Named preset";
+        readonly required: false;
+    };
+    readonly brand: {
+        readonly type: "string";
+        readonly description: "Brand name for brand-halo preset";
+        readonly required: false;
+    };
+    readonly dimensions: {
+        readonly type: "string";
+        readonly description: "Comma-separated dimensions";
+        readonly required: false;
+    };
+    readonly days: {
+        readonly type: "string";
+        readonly description: "Lookback days (default: 28)";
+        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 "row-limit": {
+        readonly type: "string";
+        readonly description: "Max rows (default: 1000)";
+        readonly required: false;
+    };
+    readonly type: {
+        readonly type: "string";
+        readonly description: "Search type (default: web)";
+        readonly required: false;
+    };
+    readonly filter: {
+        readonly type: "string";
+        readonly description: "Filter JSON";
+        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/gsc/query.d.ts.map

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

package/dist/commands/gsc/query.js

@@ -0,0 +1,196 @@
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { buildQueryCacheKey, cacheGet, cacheSet, getQueryTtl } from "../ads/cache.js";
+import { toCsvRow, writeAdsOutput, writeJsonEnvelope } from "../ads/output.js";
+import { GSC_PRESETS } from "./presets.js";
+import { resolveSiteUrl } from "./resolve.js";
+registerSchema({
+    command: "gsc.query",
+    description: "Run GSC Search Analytics queries. Use --preset for playbook-aligned queries (primary usage) or --dimensions for free-form queries.",
+    args: {
+        "site-url": { type: "string", description: "Site URL (auto-resolved if not provided)", required: false },
+        preset: {
+            type: "string",
+            description: "Named preset (cannibalization, missed-revenue, brand-halo, negative-keywords, top-pages, top-queries)",
+            required: false,
+        },
+        brand: { type: "string", description: "Brand name (required for brand-halo preset)", required: false },
+        dimensions: {
+            type: "string",
+            description: "Comma-separated dimensions (escape hatch: query, page, country, device, date)",
+            required: false,
+        },
+        days: { type: "string", description: "Lookback window in days (default: 28)", required: false },
+        "start-date": { type: "string", description: "Explicit start date (YYYY-MM-DD)", required: false },
+        "end-date": { type: "string", description: "Explicit end date (YYYY-MM-DD)", required: false },
+        "row-limit": { type: "string", description: "Max rows (default: 1000, max: 25000)", required: false },
+        type: { type: "string", description: "Search type: web|image|video|news|discover (default: web)", required: false },
+        filter: { type: "string", description: "Dimension filter groups as JSON string", required: false },
+        "list-presets": { type: "boolean", description: "List available presets", required: false },
+        out: { type: "string", description: "Write data to file (.csv, .jsonl, .json)", required: false },
+        append: { type: "boolean", description: "Append to existing file", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+function extractFields(rows) {
+    const first = rows[0];
+    return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, append) {
+    const fields = extractFields(rows);
+    const ext = filePath.split(".").pop()?.toLowerCase();
+    if (ext === "csv") {
+        if (!append || !existsSync(filePath)) {
+            writeFileSync(filePath, `${toCsvRow(fields)}\n`, "utf-8");
+        }
+        const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+        appendFileSync(filePath, `${csvRows.join("\n")}\n`, "utf-8");
+    }
+    else if (ext === "jsonl") {
+        const content = `${rows.map((row) => JSON.stringify(row)).join("\n")}\n`;
+        if (append && existsSync(filePath)) {
+            appendFileSync(filePath, content, "utf-8");
+        }
+        else {
+            writeFileSync(filePath, content, "utf-8");
+        }
+    }
+    else if (append && existsSync(filePath)) {
+        const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+        writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+    }
+    else {
+        writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+    }
+}
+function outputRows(rows, args, response, cached) {
+    if (args.out) {
+        const filePath = resolve(args.out);
+        writeRowsToFile(filePath, rows, !!args.append);
+        writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...(cached && { cached: true }) });
+        return;
+    }
+    const format = args.output || "json";
+    if (format !== "json") {
+        writeAdsOutput(rows, format);
+        return;
+    }
+    writeJsonEnvelope({ ...response, ...(cached && { cached: true }) });
+}
+function buildRequestBody(args, siteUrl, useCache) {
+    const body = { siteUrl };
+    if (args.preset)
+        body.preset = args.preset;
+    if (args.brand)
+        body.brand = args.brand;
+    if (args.dimensions)
+        body.dimensions = args.dimensions.split(",").map((d) => d.trim());
+    if (args.days)
+        body.days = Number(args.days);
+    if (args["start-date"])
+        body.startDate = args["start-date"];
+    if (args["end-date"])
+        body.endDate = args["end-date"];
+    if (args["row-limit"])
+        body.rowLimit = Number(args["row-limit"]);
+    if (args.type)
+        body.type = args.type;
+    if (args.filter)
+        body.filter = args.filter;
+    if (!useCache)
+        body.skipCache = true;
+    return body;
+}
+function handleError(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: err instanceof Error ? err.message : "Unexpected error" },
+    });
+    process.exit(1);
+}
+export const queryCommand = defineCommand({
+    meta: {
+        name: "query",
+        description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
+
+Presets (primary usage):
+  baker gsc query --preset cannibalization
+  baker gsc query --preset brand-halo --brand "Acme" --days 90
+  baker gsc query --list-presets
+
+Free-form (escape hatch):
+  baker gsc query --dimensions "query,page" --days 28
+  baker gsc query --dimensions "query" --row-limit 25000 --out keywords.csv`,
+    },
+    args: {
+        "site-url": { type: "string", description: "Site URL", required: false },
+        preset: { type: "string", description: "Named preset", required: false },
+        brand: { type: "string", description: "Brand name for brand-halo preset", required: false },
+        dimensions: { type: "string", description: "Comma-separated dimensions", required: false },
+        days: { type: "string", description: "Lookback days (default: 28)", required: false },
+        "start-date": { type: "string", description: "Start date override", required: false },
+        "end-date": { type: "string", description: "End date override", required: false },
+        "row-limit": { type: "string", description: "Max rows (default: 1000)", required: false },
+        type: { type: "string", description: "Search type (default: web)", required: false },
+        filter: { type: "string", description: "Filter JSON", required: false },
+        "list-presets": { type: "boolean", description: "List presets", required: false },
+        out: { type: "string", description: "Output file path", required: false },
+        append: { type: "boolean", description: "Append to file", required: false },
+        output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+    run: async ({ args }) => {
+        if (args["list-presets"]) {
+            writeJsonEnvelope({
+                ok: true,
+                data: GSC_PRESETS.map((p) => ({
+                    name: p.name,
+                    description: p.description,
+                    playbook: p.playbook,
+                    ...(p.requiresBrand && { requiresBrand: true }),
+                })),
+            });
+            return;
+        }
+        if (!args.preset && !args.dimensions) {
+            writeJsonEnvelope({
+                ok: false,
+                error: {
+                    code: "VALIDATION_ERROR",
+                    message: "Provide --preset or --dimensions. Run --list-presets to see options.",
+                },
+            });
+            process.exit(1);
+        }
+        const siteUrl = await resolveSiteUrl(args);
+        const useCache = !args["no-cache"];
+        const body = buildRequestBody(args, siteUrl, useCache);
+        const cacheKey = buildQueryCacheKey(siteUrl, JSON.stringify(body));
+        if (useCache) {
+            const cached = cacheGet("gsc-queries", cacheKey);
+            if (cached) {
+                outputRows(cached.data.data ?? [], args, cached.data, true);
+                return;
+            }
+        }
+        try {
+            const response = await apiPost("/api/gsc/query", body);
+            if (useCache) {
+                cacheSet("gsc-queries", cacheKey, response, getQueryTtl(JSON.stringify(body)));
+            }
+            outputRows(response.data ?? [], args, response, false);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    },
+});
+//# sourceMappingURL=query.js.map