@koda-sl/baker-cli 0.34.1 → 0.34.3

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

@@ -0,0 +1,102 @@
+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;
+function healthOf(rules) {
+    const enabled = rules.filter((r) => r.enabled !== false);
+    const capi = enabled.filter((r) => r.conversionMethod === "CONVERSIONS_API");
+    const pixel = enabled.filter((r) => r.conversionMethod === "PIXEL");
+    const staleCapi = capi.filter((r) => !r.lastConversionReportedAt || Date.now() - r.lastConversionReportedAt > 7 * DAY_MS);
+    const longView = enabled.filter((r) => r.viewThroughAttributionWindowSize !== undefined && r.viewThroughAttributionWindowSize > 7);
+    const leads = enabled.filter((r) => r.type === "LEAD");
+    const wrongDedup = leads.filter((r) => r.countingMethod && r.countingMethod !== "ONE_TIME_EACH_MEMBER");
+    return {
+        totalRules: rules.length,
+        enabledRules: enabled.length,
+        capiRules: capi.length,
+        pixelRules: pixel.length,
+        hasLeadEvent: leads.length > 0,
+        hasPurchaseEvent: enabled.some((r) => r.type === "PURCHASE"),
+        staleCapiRules: staleCapi,
+        longViewWindow: longView,
+        wrongLeadDedup: wrongDedup,
+    };
+}
+const listCmd = defineCommand({
+    meta: {
+        name: "list",
+        description: `List conversion rules on the account.`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+        "account-urn": { type: "string", description: "Alias for --account-id" },
+        "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["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/linkedin/conversions", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+const healthCmd = defineCommand({
+    meta: {
+        name: "health",
+        description: `5-point Insight Tag / CAPI health check (playbook §07).
+
+Surfaces:
+  - Are rules enabled?
+  - Do we have at least one LEAD or PURCHASE event?
+  - Do CAPI rules show recent activity (≤7 days)?
+  - Is the view-through window ≤7 days?
+  - Do LEAD rules use ONE_TIME_EACH_MEMBER de-dup?`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+        "account-urn": { type: "string", description: "Alias for --account-id" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "json", default: "json" },
+    },
+    run: async ({ args }) => {
+        const accountId = resolveAccountIdArg(args);
+        try {
+            const params = { "account-id": accountId };
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/linkedin/conversions", params);
+            writeAdsJson({ ok: true, data: healthOf(data) });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+export const conversionsCommand = defineCommand({
+    meta: {
+        name: "conversions",
+        description: `Conversion rules — Insight Tag and Conversions API.
+
+Subcommands:
+  list                — every rule on the account
+  health              — playbook §07 5-point health check`,
+    },
+    subCommands: {
+        list: listCmd,
+        health: healthCmd,
+    },
+});
+//# sourceMappingURL=conversions.js.map

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

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

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

@@ -0,0 +1,36 @@
+export declare const creativesCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Numeric account ID or urn:li:sponsoredAccount:N";
+    };
+    readonly "account-urn": {
+        readonly type: "string";
+        readonly description: "Alias for --account-id";
+    };
+    readonly "campaign-id": {
+        readonly type: "string";
+        readonly description: "Filter by campaign ID";
+    };
+    readonly "all-statuses": {
+        readonly type: "boolean";
+        readonly description: "Drop the default ACTIVE filter";
+    };
+    readonly statuses: {
+        readonly type: "string";
+        readonly description: "CSV of intended statuses (ACTIVE,PAUSED,DRAFT,ARCHIVED)";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max rows (default: 500)";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "json|csv|jsonl|md";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=creatives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creatives.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/creatives.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+C3B,CAAC"}

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

@@ -0,0 +1,57 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleLinkedinError, resolveAccountIdArg, resolveStatusFilter } from "./shared.js";
+export const creativesCommand = defineCommand({
+    meta: {
+        name: "creatives",
+        description: `List LinkedIn creatives (ads).
+
+Defaults to ACTIVE intended-status. Pass --all-statuses or --statuses ACTIVE,PAUSED to widen.
+
+The 'content' block is opaque (varies by creative type — image, video, document,
+spotlight, conversation, dynamic). Use 'reviewStatus' to spot rejected/pending
+creatives during an audit.
+
+Examples:
+  baker ads linkedin creatives --account-id 503001492
+  baker ads linkedin creatives --account-id 503001492 --campaign-id 1234
+  baker ads linkedin creatives --account-id 503001492 --all-statuses --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" },
+        "campaign-id": { type: "string", description: "Filter by campaign ID" },
+        "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+        statuses: { type: "string", description: "CSV of intended statuses (ACTIVE,PAUSED,DRAFT,ARCHIVED)" },
+        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 };
+            const statuses = resolveStatusFilter(args);
+            if (statuses)
+                params.statuses = statuses.join(",");
+            if (args["campaign-id"])
+                params["campaign-id"] = String(args["campaign-id"]);
+            if (args.limit)
+                params.limit = String(args.limit);
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/linkedin/creatives", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+//# sourceMappingURL=creatives.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creatives.js","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/creatives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAevG,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;;;;;kFAWiE;KAC/E;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;QAChG,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;QACvE,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;QAClF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;QACpG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE;KAC9E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,QAAQ;gBAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,aAAa,CAAC;gBAAE,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;YAC7E,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YAEtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAwB,6BAA6B,EAAE,MAAM,CAAC,CAAC;YACxF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAiD,EAAE,GAAG,CAAC,CAAC;gBACvE,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,40 @@
+export declare const demographicsCommand: import("citty").CommandDef<{
+    readonly "campaign-id": {
+        readonly type: "string";
+        readonly description: "Comma-separated campaign IDs (required)";
+    };
+    readonly pivots: {
+        readonly type: "string";
+        readonly description: `CSV of pivots (default: ${string})`;
+    };
+    readonly "top-n": {
+        readonly type: "string";
+        readonly description: "Top rows per pivot (default: 10)";
+    };
+    readonly intent: {
+        readonly type: "string";
+        readonly description: "baseline | revenue | funnel | engagement | lead-gen (default: baseline)";
+    };
+    readonly start: {
+        readonly type: "string";
+        readonly description: "Start date YYYY-MM-DD";
+    };
+    readonly end: {
+        readonly type: "string";
+        readonly description: "End date YYYY-MM-DD";
+    };
+    readonly "last-days": {
+        readonly type: "string";
+        readonly description: "Window relative to today (default: 30)";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "json";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=demographics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"demographics.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/demographics.ts"],"names":[],"mappings":"AA6CA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0F9B,CAAC"}

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

@@ -0,0 +1,117 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../../client.js";
+import { writeAdsJson } from "../output.js";
+import { csvOrJson, daysAgoIso, handleLinkedinError, todayIso } from "./shared.js";
+const DEFAULT_PIVOTS = ["job-title", "company", "industry", "seniority", "job-function", "company-size"];
+function numberOf(v) {
+    if (typeof v === "number")
+        return Number.isFinite(v) ? v : 0;
+    if (typeof v === "string") {
+        const n = Number(v);
+        return Number.isFinite(n) ? n : 0;
+    }
+    return 0;
+}
+function topByImpressions(rows, limit) {
+    return [...rows].sort((a, b) => numberOf(b.impressions) - numberOf(a.impressions)).slice(0, limit);
+}
+export const demographicsCommand = defineCommand({
+    meta: {
+        name: "demographics",
+        description: `Sweep all firmographic pivots in one command — LinkedIn's superpower.
+
+Default pivots:
+  job-title, company, industry, seniority, job-function, company-size
+
+Use --pivots to narrow the sweep. Output is one section per pivot, each with
+top-N rows by impressions (configurable via --top-n).
+
+Demographic data is delayed 12-24h with a ≥3-event privacy floor — small
+buckets are silently dropped. The CLI surfaces this in 'warnings' when the
+result set comes back unexpectedly empty.
+
+Examples:
+  baker ads linkedin demographics --campaign-id 1234
+  baker ads linkedin demographics --campaign-id 1234 --pivots job-title,company
+  baker ads linkedin demographics --campaign-id 1234 --last-days 30 --top-n 25`,
+    },
+    args: {
+        "campaign-id": { type: "string", description: "Comma-separated campaign IDs (required)" },
+        pivots: { type: "string", description: `CSV of pivots (default: ${DEFAULT_PIVOTS.join(",")})` },
+        "top-n": { type: "string", description: "Top rows per pivot (default: 10)" },
+        intent: { type: "string", description: "baseline | revenue | funnel | engagement | lead-gen (default: baseline)" },
+        start: { type: "string", description: "Start date YYYY-MM-DD" },
+        end: { type: "string", description: "End date YYYY-MM-DD" },
+        "last-days": { type: "string", description: "Window relative to today (default: 30)" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "json", default: "json" },
+    },
+    run: async ({ args }) => {
+        const fmt = csvOrJson(args);
+        if (fmt !== "json") {
+            writeAdsJson({
+                ok: false,
+                error: {
+                    code: "UNSUPPORTED_FORMAT",
+                    message: "demographics returns a structured per-pivot report — only --output json supported.",
+                },
+            });
+            process.exit(1);
+        }
+        const campaignIdsRaw = args["campaign-id"];
+        if (!campaignIdsRaw) {
+            handleLinkedinError(new Error("--campaign-id is required (CSV for multi)."));
+        }
+        const ids = campaignIdsRaw
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
+        const pivotsRaw = args.pivots?.split(",").map((s) => s.trim().toLowerCase());
+        const pivots = (pivotsRaw && pivotsRaw.length > 0 ? pivotsRaw : DEFAULT_PIVOTS);
+        const topN = args["top-n"] ? Number(args["top-n"]) : 10;
+        const intent = args.intent ?? "baseline";
+        const { start, end } = resolveRange(args);
+        try {
+            const results = [];
+            for (const pivot of pivots) {
+                const data = await apiPost("/api/ads/linkedin/analytics", {
+                    request: {
+                        level: "campaign",
+                        ids,
+                        intent,
+                        pivot,
+                        start,
+                        end,
+                        granularity: "ALL",
+                        limit: 500,
+                    },
+                    skipCache: Boolean(args["skip-cache"]),
+                });
+                results.push({ pivot, rows: topByImpressions(data.rows, topN), warnings: data.warnings });
+            }
+            writeAdsJson({
+                ok: true,
+                data: {
+                    query: { campaigns: ids, start, end, intent, topN },
+                    pivots: results,
+                },
+            });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+function resolveRange(args) {
+    const start = args.start;
+    const end = args.end;
+    if (start) {
+        return { start, end };
+    }
+    const days = args["last-days"] ? Number(args["last-days"]) : 30;
+    if (!Number.isFinite(days) || days < 1) {
+        handleLinkedinError(new Error("Invalid --last-days; must be a positive integer."));
+    }
+    return { start: daysAgoIso(days), end: todayIso() };
+}
+//# sourceMappingURL=demographics.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"facets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/facets.ts"],"names":[],"mappings":"AA4FA,eAAO,MAAM,aAAa,qDAcxB,CAAC"}

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

@@ -0,0 +1,95 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleLinkedinError } from "./shared.js";
+const listCmd = defineCommand({
+    meta: {
+        name: "list",
+        description: `List every targeting facet LinkedIn supports.
+
+Cached 7 days. Use this to discover what dimensions you can target on (industries,
+seniorities, titles, employers, growthRate, companyCategory, skills, etc.).`,
+    },
+    args: {
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "json|csv|jsonl|md", default: "json" },
+    },
+    run: async ({ args }) => {
+        try {
+            const params = {};
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/linkedin/facets", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+const valuesCmd = defineCommand({
+    meta: {
+        name: "values",
+        description: `Look up entity values for a single facet — full list or typeahead search.
+
+Examples:
+  baker ads linkedin facets values --facet seniorities                          — all seniority URNs
+  baker ads linkedin facets values --facet titles --query "marketing director"  — typeahead
+  baker ads linkedin facets values --facet industries --output csv
+
+The --facet flag accepts the bare name (industries, seniorities, titles, etc.)
+or the full URN (urn:li:adTargetingFacet:industries).`,
+    },
+    args: {
+        facet: { type: "string", description: "Facet name (e.g. industries) or URN", required: true },
+        query: { type: "string", description: "Typeahead query (auto-switches finder to typeahead)" },
+        finder: { type: "string", description: "adTargetingFacet | typeahead | similarEntities (default: auto)" },
+        locale: { type: "string", description: "Locale (default: en_US)" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "json|csv|jsonl|md", default: "json" },
+    },
+    run: async ({ args }) => {
+        try {
+            const params = { facet: String(args.facet) };
+            const finder = args.finder ?? (args.query ? "typeahead" : "adTargetingFacet");
+            params.finder = finder;
+            if (args.query)
+                params.query = String(args.query);
+            if (args.locale)
+                params.locale = String(args.locale);
+            if (args["skip-cache"])
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/linkedin/facets/entities", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+export const facetsCommand = defineCommand({
+    meta: {
+        name: "facets",
+        description: `LinkedIn targeting facets and entity lookup.
+
+Subcommands:
+  list                          — every facet (industries, seniorities, titles, employers, …)
+  values --facet titles         — entity URNs for one facet
+  values --facet titles --query "marketing director"  — typeahead`,
+    },
+    subCommands: {
+        list: listCmd,
+        values: valuesCmd,
+    },
+});
+//# sourceMappingURL=facets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facets.js","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/facets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAiB7D,MAAM,OAAO,GAAG,aAAa,CAAC;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;4EAG2D;KACzE;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE;KAC9E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAkB,0BAA0B,EAAE,MAAM,CAAC,CAAC;YAC/E,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAiD,EAAE,GAAG,CAAC,CAAC;gBACvE,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,aAAa,CAAC;IAC9B,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;;;;sDAQqC;KACnD;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;QAC7F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE;QACzG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QAClE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE;KAC9E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACrE,MAAM,MAAM,GAAI,IAAI,CAAC,MAA6B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;YACtG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YACvB,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YAEtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAwB,mCAAmC,EAAE,MAAM,CAAC,CAAC;YAC9F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAiD,EAAE,GAAG,CAAC,CAAC;gBACvE,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;kEAKiD;KAC/D;IACD,WAAW,EAAE;QACX,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,SAAS;KAClB;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,50 @@
+export declare const forecastCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Numeric account ID or urn:li:sponsoredAccount:N";
+    };
+    readonly "account-urn": {
+        readonly type: "string";
+        readonly description: "Alias for --account-id";
+    };
+    readonly objective: {
+        readonly type: "string";
+        readonly description: "Objective type";
+        readonly required: true;
+    };
+    readonly "cost-type": {
+        readonly type: "string";
+        readonly description: "CPC | CPM | CPV | CPS";
+        readonly required: true;
+    };
+    readonly "daily-budget": {
+        readonly type: "string";
+        readonly description: "e.g. '200 USD' or '200'";
+    };
+    readonly "total-budget": {
+        readonly type: "string";
+        readonly description: "e.g. '6000 USD'";
+    };
+    readonly bid: {
+        readonly type: "string";
+        readonly description: "Bid e.g. '8 USD'";
+    };
+    readonly targeting: {
+        readonly type: "string";
+        readonly description: "Inline JSON targetingCriteria";
+    };
+    readonly "targeting-file": {
+        readonly type: "string";
+        readonly description: "Path to JSON file with targetingCriteria";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "json";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=forecast.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/forecast.ts"],"names":[],"mappings":"AA+CA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4C1B,CAAC"}

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

@@ -0,0 +1,83 @@
+import { readFileSync } from "node:fs";
+import { defineCommand } from "citty";
+import { apiPost } from "../../../client.js";
+import { writeAdsJson } from "../output.js";
+import { handleLinkedinError, resolveAccountIdArg } from "./shared.js";
+function loadTargeting(args) {
+    const inline = args.targeting;
+    if (inline) {
+        try {
+            return JSON.parse(inline);
+        }
+        catch {
+            handleLinkedinError(new Error("--targeting must be valid JSON."));
+        }
+    }
+    const file = args["targeting-file"];
+    if (file) {
+        try {
+            return JSON.parse(readFileSync(file, "utf-8"));
+        }
+        catch (e) {
+            handleLinkedinError(new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`));
+        }
+    }
+    handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
+}
+function parseMoney(raw) {
+    if (!raw)
+        return undefined;
+    // Accept either "100 USD" or just "100" (defaults to USD).
+    const m = /^(\d+(?:\.\d+)?)(?:\s+([A-Z]{3}))?$/.exec(raw.trim());
+    if (!m) {
+        handleLinkedinError(new Error(`Invalid money "${raw}". Use "100" or "100 EUR".`));
+    }
+    return { amount: m[1] ?? "0", currencyCode: m[2] ?? "USD" };
+}
+export const forecastCommand = defineCommand({
+    meta: {
+        name: "forecast",
+        description: `Forecast reach + impressions + clicks + spend for a hypothetical campaign.
+
+Wraps /rest/adSupplyForecasts. Useful for greenfield (§14) — answers
+"if we launch with this budget + targeting + objective, what's the expected delivery?"
+
+Examples:
+  baker ads linkedin forecast --account-id 503001492 --objective LEAD_GENERATION --cost-type CPC \\
+    --daily-budget "200 USD" --bid "8 USD" --targeting-file targeting.json`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+        "account-urn": { type: "string", description: "Alias for --account-id" },
+        objective: { type: "string", description: "Objective type", required: true },
+        "cost-type": { type: "string", description: "CPC | CPM | CPV | CPS", required: true },
+        "daily-budget": { type: "string", description: "e.g. '200 USD' or '200'" },
+        "total-budget": { type: "string", description: "e.g. '6000 USD'" },
+        bid: { type: "string", description: "Bid e.g. '8 USD'" },
+        targeting: { type: "string", description: "Inline JSON targetingCriteria" },
+        "targeting-file": { type: "string", description: "Path to JSON file with targetingCriteria" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "json", default: "json" },
+    },
+    run: async ({ args }) => {
+        const accountId = resolveAccountIdArg(args);
+        const targetingCriteria = loadTargeting(args);
+        try {
+            const data = await apiPost("/api/ads/linkedin/forecast", {
+                accountId,
+                objectiveType: String(args.objective),
+                costType: String(args["cost-type"]).toUpperCase(),
+                targetingCriteria,
+                dailyBudget: parseMoney(args["daily-budget"]),
+                totalBudget: parseMoney(args["total-budget"]),
+                bid: parseMoney(args.bid),
+                skipCache: Boolean(args["skip-cache"]),
+            });
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleLinkedinError(err);
+        }
+    },
+});
+//# sourceMappingURL=forecast.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.js","sourceRoot":"","sources":["../../../../src/commands/ads/linkedin/forecast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAWvE,SAAS,aAAa,CAAC,IAA6B;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,SAA+B,CAAC;IACpD,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAuB,CAAC;IAC1D,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,mBAAmB,CACjB,IAAI,KAAK,CAAC,oCAAoC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAC9F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,mBAAmB,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,UAAU,CAAC,GAAuB;IACzC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,2DAA2D;IAC3D,MAAM,CAAC,GAAG,qCAAqC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,mBAAmB,CAAC,IAAI,KAAK,CAAC,kBAAkB,GAAG,4BAA4B,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;2EAO0D;KACxE;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;QAChG,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE;QACrF,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QAC1E,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;QAClE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;QACxD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;QAC3E,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;QAC7F,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;KACjE;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAiB,4BAA4B,EAAE;gBACvE,SAAS;gBACT,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;gBACrC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE;gBACjD,iBAAiB;gBACjB,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,cAAc,CAAuB,CAAC;gBACnE,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,cAAc,CAAuB,CAAC;gBACnE,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,GAAyB,CAAC;gBAC/C,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;aACvC,CAAC,CAAC;YACH,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}