@koda-sl/baker-cli 0.25.1 → 0.27.0

package/dist/commands/ads/linkedin/leads.js

@@ -0,0 +1,75 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleLinkedinError, resolveAccountIdArg } from "./shared.js";
+const DAY_MS = 86_400_000;
+export const leadsCommand = defineCommand({
+    meta: {
+        name: "leads",
+        description: `List Lead Gen Form responses (playbook §07).
+
+LinkedIn retains LGF responses for 90 days only — sync to your CRM via this
+endpoint or you'll lose them.
+
+Examples:
+  baker ads linkedin leads --account-id 503001492
+  baker ads linkedin leads --account-id 503001492 --campaign-id 1234
+  baker ads linkedin leads --account-id 503001492 --form-id 5678 --since-days 7
+  baker ads linkedin leads --account-id 503001492 --output csv`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+        "account-urn": { type: "string", description: "Alias for --account-id" },
+        "form-id": { type: "string", description: "Filter by Lead Gen Form ID" },
+        "campaign-id": { type: "string", description: "Filter by campaign ID" },
+        "since-days": { type: "string", description: "Only responses submitted in the last N days" },
+        "since-ms": {
+            type: "string",
+            description: "Only responses submitted at or after this epoch ms (alternative to --since-days)",
+        },
+        limit: { type: "string", description: "Max rows (default: 500)" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "json|csv|jsonl|md", default: "json" },
+    },
+    run: async ({ args }) => {
+        const accountId = resolveAccountIdArg(args);
+        try {
+            const params = { "account-id": accountId };
+            if (args["form-id"])
+                params["form-id"] = String(args["form-id"]);
+            if (args["campaign-id"])
+                params["campaign-id"] = String(args["campaign-id"]);
+            const sinceDays = args["since-days"] ? Number(args["since-days"]) : undefined;
+            const sinceMs = args["since-ms"]
+                ? Number(args["since-ms"])
+                : sinceDays
+                    ? Date.now() - sinceDays * DAY_MS
+                    : undefined;
+            if (sinceMs)
+                params["since-ms"] = String(sinceMs);
+            if (args.limit)
+                params.limit = String(args.limit);
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/linkedin/leads", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                // Flatten the answers array for CSV/MD output.
+                const flat = data.map((r) => ({
+                    id: r.id,
+                    formId: r.formId,
+                    campaignUrn: r.campaignUrn,
+                    submittedAt: r.submittedAt ? new Date(r.submittedAt).toISOString() : "",
+                    answers: (r.answers ?? []).map((a) => `${a.question}: ${a.answer}`).join(" | "),
+                }));
+                writeAdsOutput(flat, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+//# sourceMappingURL=leads.js.map

package/dist/commands/ads/linkedin/leads.js.map

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

package/dist/commands/ads/linkedin/presets.d.ts

@@ -0,0 +1,40 @@
+/**
+ * LinkedIn analytics field bundles. Three-axis design:
+ *   --intent  → metric bundle (baseline | revenue | funnel | engagement | video |
+ *                lead-gen | inmail | document | ranking | identity)
+ *   --level   → object scope (account | campaign-group | campaign | creative)
+ *   --pivot   → demographic / firmographic breakdown
+ *               (none | job-title | company | industry | seniority | function |
+ *                company-size | country | region | device | placement | …)
+ *
+ * Backend recomputes the field list itself (single source of truth in
+ * `packages/backend/convex/ads/linkedin/constants.ts`). The CLI keeps a
+ * mirror copy so `--list-intents` / `--list-pivots` work offline.
+ */
+export type IntentName = "baseline" | "revenue" | "funnel" | "engagement" | "video" | "lead-gen" | "inmail" | "document" | "ranking" | "identity";
+export type LevelName = "account" | "campaign-group" | "campaign" | "creative";
+export type PivotSlug = "none" | "campaign" | "campaign-group" | "creative" | "company" | "account" | "conversion" | "job-title" | "job-function" | "seniority" | "industry" | "company-size" | "country" | "region" | "device" | "placement" | "serving-location" | "card-index" | "objective" | "conversation-node" | "conversation-node-button";
+interface IntentDefinition {
+    name: IntentName;
+    description: string;
+    metrics: string[];
+    /** Derived (CLI-side) metrics this bundle materializes. Documentation only. */
+    derived?: string[];
+}
+export declare const INTENTS: Record<IntentName, IntentDefinition>;
+/** Pivots that LinkedIn rejects with DAILY granularity — CLI auto-forces ALL. */
+export declare const MEMBER_PIVOTS: Set<PivotSlug>;
+export declare const ALL_PIVOTS: PivotSlug[];
+export declare const ALL_LEVELS: LevelName[];
+export declare function getIntent(name: string): IntentDefinition | undefined;
+export declare function listIntents(): IntentDefinition[];
+export declare function isPivot(slug: string): slug is PivotSlug;
+export declare function isLevel(slug: string): slug is LevelName;
+/**
+ * Compose final field list — intent bundle + identity columns + pivotValues +
+ * dateRange. Backend re-validates and recomposes; this is just for offline
+ * preview (`baker ads linkedin analytics --list-intents`).
+ */
+export declare function composeFields(intent: IntentName, _level: LevelName, metricsOverride?: string[]): string[];
+export {};
+//# sourceMappingURL=presets.d.ts.map

package/dist/commands/ads/linkedin/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,SAAS,GACT,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/E,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,UAAU,GACV,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,SAAS,GACT,YAAY,GACZ,WAAW,GACX,cAAc,GACd,WAAW,GACX,UAAU,GACV,cAAc,GACd,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,WAAW,GACX,mBAAmB,GACnB,0BAA0B,CAAC;AAE/B,UAAU,gBAAgB;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAmHxD,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,aAAa,gBASxB,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,SAAS,EAsBjC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,SAAS,EAA0D,CAAC;AAE7F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEpE;AAED,wBAAgB,WAAW,IAAI,gBAAgB,EAAE,CAEhD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAEvD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAWzG"}

package/dist/commands/ads/linkedin/presets.js

@@ -0,0 +1,193 @@
+/**
+ * LinkedIn analytics field bundles. Three-axis design:
+ *   --intent  → metric bundle (baseline | revenue | funnel | engagement | video |
+ *                lead-gen | inmail | document | ranking | identity)
+ *   --level   → object scope (account | campaign-group | campaign | creative)
+ *   --pivot   → demographic / firmographic breakdown
+ *               (none | job-title | company | industry | seniority | function |
+ *                company-size | country | region | device | placement | …)
+ *
+ * Backend recomputes the field list itself (single source of truth in
+ * `packages/backend/convex/ads/linkedin/constants.ts`). The CLI keeps a
+ * mirror copy so `--list-intents` / `--list-pivots` work offline.
+ */
+export const INTENTS = {
+    baseline: {
+        name: "baseline",
+        description: "Spend, impressions, clicks. The default 'how is delivery?' question. Derives CTR, CPC, CPM.",
+        metrics: ["impressions", "clicks", "costInUsd", "costInLocalCurrency", "approximateUniqueImpressions"],
+        derived: ["ctr", "cpc", "cpm", "frequency"],
+    },
+    revenue: {
+        name: "revenue",
+        description: "Spend, conversions, conversion value. 'How much money are we making?'",
+        metrics: [
+            "costInUsd",
+            "externalWebsiteConversions",
+            "externalWebsitePostClickConversions",
+            "externalWebsitePostViewConversions",
+            "conversionValueInLocalCurrency",
+            "oneClickLeads",
+        ],
+    },
+    funnel: {
+        name: "funnel",
+        description: "Impression → click → landing → form open → lead → conversion. 'Where do users drop off?'",
+        metrics: [
+            "impressions",
+            "clicks",
+            "landingPageClicks",
+            "oneClickLeadFormOpens",
+            "oneClickLeads",
+            "externalWebsiteConversions",
+            "costInUsd",
+        ],
+        derived: ["ctr", "leadCompletionRate"],
+    },
+    engagement: {
+        name: "engagement",
+        description: "Likes, comments, shares, follows + viral spillover. TLA-aware — measures organic reach effect.",
+        metrics: [
+            "impressions",
+            "likes",
+            "comments",
+            "shares",
+            "reactions",
+            "follows",
+            "totalEngagements",
+            "viralImpressions",
+            "viralLikes",
+            "viralShares",
+            "viralOneClickLeads",
+            "costInUsd",
+        ],
+    },
+    video: {
+        name: "video",
+        description: "Video watch quartiles + cost. 'How are video creatives holding attention?'",
+        metrics: [
+            "videoStarts",
+            "videoFirstQuartileCompletions",
+            "videoMidpointCompletions",
+            "videoThirdQuartileCompletions",
+            "videoCompletions",
+            "videoViews",
+            "fullScreenPlays",
+            "costInUsd",
+            "impressions",
+        ],
+    },
+    "lead-gen": {
+        name: "lead-gen",
+        description: "Lead Gen Form opens + completions. CLI derives form-completion-rate.",
+        metrics: [
+            "oneClickLeadFormOpens",
+            "oneClickLeads",
+            "viralOneClickLeads",
+            "viralOneClickLeadFormOpens",
+            "costInUsd",
+        ],
+        derived: ["leadCompletionRate"],
+    },
+    inmail: {
+        name: "inmail",
+        description: "Sponsored Message / Conversation Ads — sends, opens, clicks, lead-gen taps.",
+        metrics: [
+            "sends",
+            "opens",
+            "clicks",
+            "costInUsd",
+            "leadGenerationMailContactInfoShares",
+            "leadGenerationMailInterestedClicks",
+        ],
+    },
+    document: {
+        name: "document",
+        description: "Document Ads — quartile read-through, completion, downloads.",
+        metrics: [
+            "documentFirstQuartileCompletions",
+            "documentMidpointCompletions",
+            "documentThirdQuartileCompletions",
+            "documentCompletions",
+            "downloadClicks",
+            "costInUsd",
+            "impressions",
+        ],
+    },
+    ranking: {
+        name: "ranking",
+        description: "Frequency + reach metrics for fatigue detection. CLI derives frequency = impressions/uniqueImpressions.",
+        metrics: ["impressions", "clicks", "costInUsd", "approximateUniqueImpressions"],
+        derived: ["frequency", "ctr"],
+    },
+    identity: {
+        name: "identity",
+        description: "Just spend + impressions. Cheap roll-up.",
+        metrics: ["costInUsd", "impressions"],
+    },
+};
+/** Pivots that LinkedIn rejects with DAILY granularity — CLI auto-forces ALL. */
+export const MEMBER_PIVOTS = new Set([
+    "company",
+    "job-title",
+    "job-function",
+    "seniority",
+    "industry",
+    "company-size",
+    "country",
+    "region",
+]);
+export const ALL_PIVOTS = [
+    "none",
+    "campaign",
+    "campaign-group",
+    "creative",
+    "company",
+    "account",
+    "conversion",
+    "job-title",
+    "job-function",
+    "seniority",
+    "industry",
+    "company-size",
+    "country",
+    "region",
+    "device",
+    "placement",
+    "serving-location",
+    "card-index",
+    "objective",
+    "conversation-node",
+    "conversation-node-button",
+];
+export const ALL_LEVELS = ["account", "campaign-group", "campaign", "creative"];
+export function getIntent(name) {
+    return INTENTS[name];
+}
+export function listIntents() {
+    return Object.values(INTENTS);
+}
+export function isPivot(slug) {
+    return ALL_PIVOTS.includes(slug);
+}
+export function isLevel(slug) {
+    return ALL_LEVELS.includes(slug);
+}
+/**
+ * Compose final field list — intent bundle + identity columns + pivotValues +
+ * dateRange. Backend re-validates and recomposes; this is just for offline
+ * preview (`baker ads linkedin analytics --list-intents`).
+ */
+export function composeFields(intent, _level, metricsOverride) {
+    const base = metricsOverride && metricsOverride.length > 0 ? metricsOverride : INTENTS[intent].metrics;
+    const seen = new Set();
+    const out = [];
+    for (const f of ["pivotValues", "dateRange", ...base]) {
+        if (!seen.has(f)) {
+            seen.add(f);
+            out.push(f);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=presets.js.map

package/dist/commands/ads/linkedin/presets.js.map

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

package/dist/commands/ads/linkedin/presets.test.d.ts

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

package/dist/commands/ads/linkedin/presets.test.d.ts.map

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

package/dist/commands/ads/linkedin/presets.test.js

@@ -0,0 +1,98 @@
+import { describe, expect, it } from "vitest";
+import { ALL_LEVELS, ALL_PIVOTS, composeFields, getIntent, INTENTS, isLevel, isPivot, listIntents, MEMBER_PIVOTS, } from "./presets.js";
+describe("INTENTS", () => {
+    it("defines a metric bundle for every intent", () => {
+        for (const def of Object.values(INTENTS)) {
+            expect(def.metrics.length).toBeGreaterThan(0);
+            expect(def.description.length).toBeGreaterThan(10);
+        }
+    });
+    it("exposes the canonical 10-intent set", () => {
+        expect(Object.keys(INTENTS).sort()).toEqual([
+            "baseline",
+            "document",
+            "engagement",
+            "funnel",
+            "identity",
+            "inmail",
+            "lead-gen",
+            "ranking",
+            "revenue",
+            "video",
+        ].sort());
+    });
+    it("baseline derives ctr/cpc/cpm/frequency", () => {
+        const baseline = getIntent("baseline");
+        expect(baseline?.derived).toEqual(["ctr", "cpc", "cpm", "frequency"]);
+    });
+    it("lead-gen includes oneClickLeadFormOpens — required for completion-rate derivation", () => {
+        const lg = getIntent("lead-gen");
+        expect(lg?.metrics).toContain("oneClickLeadFormOpens");
+        expect(lg?.metrics).toContain("oneClickLeads");
+        expect(lg?.derived).toContain("leadCompletionRate");
+    });
+    it("listIntents returns all definitions", () => {
+        expect(listIntents()).toHaveLength(10);
+    });
+});
+describe("composeFields", () => {
+    it("always prepends pivotValues + dateRange", () => {
+        const fields = composeFields("baseline", "campaign");
+        expect(fields[0]).toBe("pivotValues");
+        expect(fields[1]).toBe("dateRange");
+    });
+    it("includes the intent's metrics deduplicated", () => {
+        const fields = composeFields("baseline", "campaign");
+        expect(fields).toContain("impressions");
+        expect(fields).toContain("clicks");
+        expect(fields).toContain("costInUsd");
+        // No duplicates.
+        expect(new Set(fields).size).toBe(fields.length);
+    });
+    it("respects metrics override (escape hatch)", () => {
+        const fields = composeFields("baseline", "account", ["impressions", "clicks", "oneClickLeads"]);
+        expect(fields).toEqual(["pivotValues", "dateRange", "impressions", "clicks", "oneClickLeads"]);
+    });
+    it("treats empty override as 'use the intent default'", () => {
+        const fields = composeFields("identity", "account", []);
+        expect(fields).toContain("costInUsd");
+    });
+});
+describe("MEMBER_PIVOTS", () => {
+    it("includes the firmographic dims that LinkedIn rejects with DAILY", () => {
+        for (const p of [
+            "company",
+            "job-title",
+            "job-function",
+            "seniority",
+            "industry",
+            "company-size",
+            "country",
+            "region",
+        ]) {
+            expect(MEMBER_PIVOTS.has(p)).toBe(true);
+        }
+    });
+    it("does NOT include device/placement/none", () => {
+        expect(MEMBER_PIVOTS.has("device")).toBe(false);
+        expect(MEMBER_PIVOTS.has("placement")).toBe(false);
+        expect(MEMBER_PIVOTS.has("none")).toBe(false);
+    });
+});
+describe("type guards", () => {
+    it("isPivot recognizes all known slugs", () => {
+        for (const p of ALL_PIVOTS) {
+            expect(isPivot(p)).toBe(true);
+        }
+    });
+    it("isPivot rejects unknown slugs", () => {
+        expect(isPivot("foo")).toBe(false);
+    });
+    it("isLevel recognizes the 4 canonical levels", () => {
+        for (const l of ALL_LEVELS) {
+            expect(isLevel(l)).toBe(true);
+        }
+        expect(isLevel("ad")).toBe(false);
+    });
+});
+//# sourceMappingURL=presets.test.js.map

package/dist/commands/ads/linkedin/presets.test.js.map

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

package/dist/commands/ads/linkedin/schemas.d.ts

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

package/dist/commands/ads/linkedin/schemas.d.ts.map

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