@koda-sl/baker-cli 0.25.0-dev.f89d9a60 → 0.25.1

package/dist/commands/ads/meta/insights.js

@@ -0,0 +1,260 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { composeFields, getIntent, listIntents } from "./presets.js";
+import { csvOrJson, getDateRange, handleMetaError } from "./shared.js";
+const POLL_INTERVAL_MS = 5_000;
+const POLL_MAX_MS = 10 * 60_000;
+/** Default attribution windows — only these still work as of Jan 2026 (1d_view + 28d_click also valid but rarely used). */
+const DEFAULT_ATTRIBUTION_WINDOWS = ["7d_click", "1d_view"];
+/** Default filter — strip rows that didn't deliver. Almost always what we want. */
+const DEFAULT_FILTERING = [{ field: "impressions", operator: "GREATER_THAN", value: 0 }];
+function commaSplit(input) {
+    if (!input)
+        return undefined;
+    return input
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function parseFiltering(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        handleMetaError(new Error("Invalid --filtering JSON"));
+    }
+}
+function pickIntent(name) {
+    if (!name)
+        return "baseline";
+    const found = getIntent(name);
+    if (!found) {
+        handleMetaError(new Error(`Unknown --intent: ${name}. Use --list-intents to see options.`));
+    }
+    return found.name;
+}
+function pickLevel(args) {
+    const raw = args.level;
+    if (!raw)
+        return "account";
+    if (raw !== "account" && raw !== "campaign" && raw !== "adset" && raw !== "ad") {
+        handleMetaError(new Error("--level must be one of: account|campaign|adset|ad"));
+    }
+    return raw;
+}
+/**
+ * Auto-async heuristic. Heavy queries that would time out as sync go async
+ * automatically — the user shouldn't have to think about it.
+ *
+ *   - level=ad with breakdowns
+ *   - >2 breakdowns at any level
+ *   - explicit time range > 90 days
+ *   - level=ad over an account-level object with a wide window
+ */
+function shouldAutoAsync(body) {
+    const breakdownCount = (body.breakdowns ?? []).length;
+    if (body.level === "ad" && breakdownCount > 0 && body.object.startsWith("act_")) {
+        return true;
+    }
+    if (breakdownCount > 2) {
+        return true;
+    }
+    if (body.since && body.until) {
+        const days = (Date.parse(body.until) - Date.parse(body.since)) / 86_400_000;
+        if (days > 90) {
+            return true;
+        }
+    }
+    return false;
+}
+function applyDateRange(body, args) {
+    const range = getDateRange(args);
+    if (range.datePreset)
+        body.datePreset = range.datePreset;
+    if (range.since)
+        body.since = range.since;
+    if (range.until)
+        body.until = range.until;
+    if (!body.datePreset && !(body.since && body.until)) {
+        body.datePreset = "last_7d";
+    }
+}
+function buildFiltering(args) {
+    const explicit = parseFiltering(args.filtering);
+    if (explicit)
+        return explicit;
+    if (args["include-undelivered"])
+        return undefined;
+    return DEFAULT_FILTERING;
+}
+function buildAttributionWindows(args) {
+    const explicit = commaSplit(args["attribution-windows"]);
+    if (explicit)
+        return explicit;
+    return DEFAULT_ATTRIBUTION_WINDOWS;
+}
+function buildBody(args) {
+    const intent = pickIntent(args.intent);
+    const level = pickLevel(args);
+    const intentDef = getIntent(intent);
+    const explicitFields = commaSplit(args.fields);
+    const fields = explicitFields ?? composeFields(intent, level);
+    const breakdowns = commaSplit(args.breakdowns);
+    const actionBreakdowns = commaSplit(args["action-breakdowns"]) ?? intentDef?.actionBreakdowns;
+    const body = {
+        object: args.object,
+        level,
+        fields,
+        timeIncrement: args["time-increment"],
+        breakdowns,
+        actionBreakdowns,
+        filtering: buildFiltering(args),
+        attributionWindows: buildAttributionWindows(args),
+        useAccountAttributionSetting: Boolean(args["use-account-attribution"]),
+        useUnifiedAttributionSetting: Boolean(args["use-unified-attribution"]),
+        limit: args.limit ? Number(args.limit) : 1000,
+        skipCache: Boolean(args["skip-cache"]),
+    };
+    applyDateRange(body, args);
+    return body;
+}
+async function pollAsync(reportRunId) {
+    const start = Date.now();
+    while (Date.now() - start < POLL_MAX_MS) {
+        const status = await apiPost(`/api/ads/meta/insights/async/status?report-run-id=${encodeURIComponent(reportRunId)}`, {});
+        if (status.async_status === "Job Completed")
+            return;
+        if (status.async_status === "Job Failed" || status.async_status === "Job Skipped") {
+            handleMetaError(new Error(`Async insights job ${status.async_status}`));
+        }
+        process.stderr.write(`Async insights ${status.async_status ?? "queued"} (${Math.round(status.async_percent_completion ?? 0)}%)…\n`);
+        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+    }
+    handleMetaError(new Error("Async insights polling timed out after 10 minutes"));
+}
+async function runAsync(body) {
+    const submit = await apiPost("/api/ads/meta/insights/async", body);
+    process.stderr.write(`Async insights job: ${submit.reportRunId}\n`);
+    await pollAsync(submit.reportRunId);
+    return apiPost("/api/ads/meta/insights/async/result", {
+        reportRunId: submit.reportRunId,
+        fields: body.fields,
+        limit: body.limit,
+    });
+}
+/** Insights rows have nested `actions[]` arrays. Sort by the named action_type's value descending. */
+function sortRowsBySpendDesc(rows) {
+    return [...rows].sort((a, b) => {
+        const sa = Number(a.spend ?? 0);
+        const sb = Number(b.spend ?? 0);
+        if (Number.isNaN(sa) || Number.isNaN(sb))
+            return 0;
+        return sb - sa;
+    });
+}
+export const insightsCommand = defineCommand({
+    meta: {
+        name: "insights",
+        description: `Performance reporting — the main Meta tool for AI agents.
+
+Smart defaults so the AI doesn't have to remember every flag:
+  --level account                       (set --level campaign|adset|ad to drill in)
+  --intent baseline                     (or revenue|funnel|ranking|video|identity)
+  --date-preset last_7d                 (override with --since/--until)
+  --attribution-windows 7d_click,1d_view  (the only ones still working post Jan 2026)
+  filter: impressions > 0               (skip undelivered rows; --include-undelivered to keep)
+  sort: spend descending                (when result fits in memory)
+  auto-async when query is heavy (level=ad + breakdowns, big date ranges, etc.)
+
+Identity fields (campaign_name, ad_name etc.) are appended automatically based on --level so rows
+are self-describing.
+
+Examples — common AI questions:
+  # "How is GreenLeaf doing this week?"
+  baker ads meta insights --object act_123
+
+  # "Which campaigns are profitable?"
+  baker ads meta insights --object act_123 --level campaign --intent revenue --date-preset last_28d
+
+  # "Which creatives need a refresh?"
+  baker ads meta insights --object act_123 --level ad --intent ranking --date-preset last_14d
+
+  # "Where do users drop off the funnel?"
+  baker ads meta insights --object act_123 --intent funnel
+
+  # "Should we shift budget to Instagram?"
+  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,platform_position
+
+  # Custom field set (escape hatch)
+  baker ads meta insights --object act_123 --fields impressions,spend,actions
+
+Async is automatic for heavy queries; pass --async to force it, or --no-async to refuse fallback.`,
+    },
+    args: {
+        object: {
+            type: "string",
+            description: "Object ID — act_<id> for account, or a campaign/adset/ad ID",
+        },
+        level: { type: "string", description: "account|campaign|adset|ad (default: account)" },
+        intent: { type: "string", description: "baseline|revenue|funnel|ranking|video|identity (default: baseline)" },
+        fields: { type: "string", description: "Comma-separated field list (overrides --intent bundle)" },
+        "list-intents": { type: "boolean", description: "Print available intents and exit" },
+        "date-preset": { type: "string", description: "Meta date preset (last_7d, last_28d, today, ...)" },
+        since: { type: "string", description: "Custom start date YYYY-MM-DD" },
+        until: { type: "string", description: "Custom end date YYYY-MM-DD" },
+        "time-increment": { type: "string", description: "1 (day) | monthly | all_days" },
+        breakdowns: { type: "string", description: "Comma-separated breakdowns (e.g. publisher_platform,age)" },
+        "action-breakdowns": {
+            type: "string",
+            description: "Slice the actions[] array (default: action_type for revenue/funnel)",
+        },
+        filtering: { type: "string", description: "Override default filter — JSON array of {field,operator,value}" },
+        "include-undelivered": { type: "boolean", description: "Keep rows where impressions=0 (off by default)" },
+        "attribution-windows": {
+            type: "string",
+            description: "Override default 7d_click,1d_view (only 1d_view, 1d_click, 7d_click, 28d_click work post Jan 2026)",
+        },
+        "use-account-attribution": { type: "boolean", description: "Use account-saved attribution setting" },
+        "use-unified-attribution": { type: "boolean", description: "Use ad-set unified attribution setting" },
+        limit: { type: "string", description: "Max rows (default 1000)" },
+        async: { type: "boolean", description: "Force async submit-and-poll path" },
+        "no-async": { type: "boolean", description: "Refuse the auto-async fallback for heavy queries" },
+        "no-sort": { type: "boolean", description: "Skip default spend-desc sort" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        if (args["list-intents"]) {
+            writeAdsJson({ ok: true, data: listIntents() });
+            return;
+        }
+        if (!args.object) {
+            writeAdsJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: "Missing required argument: --object" },
+            });
+            process.exit(1);
+        }
+        const body = buildBody(args);
+        const fmt = csvOrJson(args);
+        const wantAsync = Boolean(args.async) || (!args["no-async"] && shouldAutoAsync(body));
+        try {
+            const rows = wantAsync
+                ? await runAsync(body)
+                : await apiPost("/api/ads/meta/insights", body);
+            const sorted = args["no-sort"] ? rows : sortRowsBySpendDesc(rows);
+            if (fmt !== "json") {
+                writeAdsOutput(sorted, fmt, body.fields);
+                return;
+            }
+            writeAdsJson({ ok: true, data: sorted });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=insights.js.map

package/dist/commands/ads/meta/insights.js.map

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

package/dist/commands/ads/meta/pixels.d.ts

@@ -0,0 +1,33 @@
+export declare const pixelsCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID";
+    };
+    readonly "pixel-id": {
+        readonly type: "string";
+        readonly description: "Pixel ID for --stats";
+    };
+    readonly stats: {
+        readonly type: "boolean";
+        readonly description: "Fetch firing stats for the pixel";
+    };
+    readonly aggregation: {
+        readonly type: "string";
+        readonly description: "stats aggregation: event|browser_type|host|pixel_fire";
+        readonly default: "event";
+    };
+    readonly days: {
+        readonly type: "string";
+        readonly description: "Lookback days for --stats (default 7)";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Output format";
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=pixels.d.ts.map

package/dist/commands/ads/meta/pixels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixels.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/pixels.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCxB,CAAC"}

package/dist/commands/ads/meta/pixels.js

@@ -0,0 +1,76 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, daysAgoIso, handleMetaError, resolveAccountIdArg, todayIso } from "./shared.js";
+export const pixelsCommand = defineCommand({
+    meta: {
+        name: "pixels",
+        description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.
+
+Examples:
+  baker ads meta pixels --account-id act_123
+  baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        "pixel-id": { type: "string", description: "Pixel ID for --stats" },
+        stats: { type: "boolean", description: "Fetch firing stats for the pixel" },
+        aggregation: {
+            type: "string",
+            description: "stats aggregation: event|browser_type|host|pixel_fire",
+            default: "event",
+        },
+        days: { type: "string", description: "Lookback days for --stats (default 7)" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        try {
+            if (args.stats) {
+                await runStats(args);
+                return;
+            }
+            await runList(args);
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+async function runStats(args) {
+    const pixelId = args["pixel-id"];
+    if (!pixelId) {
+        handleMetaError(new Error("--pixel-id is required when --stats is set"));
+    }
+    const days = args.days ? Number(args.days) : 7;
+    if (!Number.isInteger(days) || days <= 0 || days > 90) {
+        handleMetaError(new Error("--days must be a positive integer ≤ 90"));
+    }
+    const params = {
+        "pixel-id": pixelId,
+        aggregation: args.aggregation ?? "event",
+        "start-time": daysAgoIso(days),
+        "end-time": todayIso(),
+    };
+    if (args["skip-cache"])
+        params["skip-cache"] = "true";
+    const data = await apiGet("/api/ads/meta/pixel-stats", params);
+    emit(data, args);
+}
+async function runList(args) {
+    const accountId = resolveAccountIdArg(args);
+    const params = { "account-id": accountId };
+    if (args["skip-cache"])
+        params["skip-cache"] = "true";
+    const data = await apiGet("/api/ads/meta/pixels", params);
+    emit(data, args);
+}
+function emit(data, args) {
+    const fmt = csvOrJson(args);
+    if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+    }
+    writeAdsJson({ ok: true, data });
+}
+//# sourceMappingURL=pixels.js.map

package/dist/commands/ads/meta/pixels.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * Insights field bundles. Picked for AI agent ergonomics: small, focused field
+ * lists that answer one specific question without forcing the AI to enumerate
+ * Meta's 500+ insights fields.
+ *
+ * Two-axis design:
+ *   --intent (field bundle, default: baseline)   — what data to ask for
+ *   --level  (object granularity, default: account) — at what granularity
+ *
+ * Intents are independent of level — pass `--intent ranking --level ad` to flag
+ * creatives, or `--intent revenue --level campaign` for ROAS by campaign.
+ *
+ * Identity fields (campaign_name etc.) are appended automatically based on
+ * level so the AI can read rows without joining.
+ */
+export type InsightsLevel = "account" | "campaign" | "adset" | "ad";
+export type InsightsIntent = "baseline" | "revenue" | "funnel" | "ranking" | "video" | "identity";
+interface IntentDefinition {
+    name: InsightsIntent;
+    description: string;
+    fields: string[];
+    /** Action breakdowns to slice the actions[] array — empty if not needed. */
+    actionBreakdowns?: string[];
+}
+/** Compose final field list: intent metrics + level-specific identity fields, deduplicated. */
+export declare function composeFields(intent: InsightsIntent, level: InsightsLevel): string[];
+export declare function getIntent(name: string): IntentDefinition | undefined;
+export declare function listIntents(): IntentDefinition[];
+export {};
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAElG,UAAU,gBAAgB;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAsDD,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAYpF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEpE;AAED,wBAAgB,WAAW,IAAI,gBAAgB,EAAE,CAEhD"}

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

@@ -0,0 +1,86 @@
+/**
+ * Insights field bundles. Picked for AI agent ergonomics: small, focused field
+ * lists that answer one specific question without forcing the AI to enumerate
+ * Meta's 500+ insights fields.
+ *
+ * Two-axis design:
+ *   --intent (field bundle, default: baseline)   — what data to ask for
+ *   --level  (object granularity, default: account) — at what granularity
+ *
+ * Intents are independent of level — pass `--intent ranking --level ad` to flag
+ * creatives, or `--intent revenue --level campaign` for ROAS by campaign.
+ *
+ * Identity fields (campaign_name etc.) are appended automatically based on
+ * level so the AI can read rows without joining.
+ */
+const INSIGHTS_INTENTS = {
+    baseline: {
+        name: "baseline",
+        description: "Spend, impressions, clicks, CTR, CPC, CPM. The default question: 'how is delivery?'",
+        fields: ["impressions", "reach", "frequency", "spend", "clicks", "ctr", "cpc", "cpm"],
+    },
+    revenue: {
+        name: "revenue",
+        description: "Spend, conversions, action_values, purchase_roas. 'How much money are we making?'",
+        fields: ["spend", "actions", "action_values", "conversions", "conversion_values", "purchase_roas"],
+        actionBreakdowns: ["action_type"],
+    },
+    funnel: {
+        name: "funnel",
+        description: "Impression → click → landing page → action. 'Where do users drop off?'",
+        fields: ["impressions", "clicks", "inline_link_clicks", "outbound_clicks", "actions", "spend"],
+        actionBreakdowns: ["action_type"],
+    },
+    ranking: {
+        name: "ranking",
+        description: "Quality, engagement, conversion-rate rankings. 'Which creatives need a refresh?'",
+        fields: ["impressions", "spend", "ctr", "quality_ranking", "engagement_rate_ranking", "conversion_rate_ranking"],
+    },
+    video: {
+        name: "video",
+        description: "Watch funnel, thruplay cost. 'How are video creatives holding attention?'",
+        fields: [
+            "impressions",
+            "spend",
+            "video_play_actions",
+            "video_p25_watched_actions",
+            "video_p50_watched_actions",
+            "video_p75_watched_actions",
+            "video_p100_watched_actions",
+            "video_thruplay_watched_actions",
+            "cost_per_thruplay",
+        ],
+    },
+    identity: {
+        name: "identity",
+        description: "Just the names + spend — for cheap roll-up summaries.",
+        fields: ["spend", "impressions"],
+    },
+};
+const IDENTITY_FIELDS_BY_LEVEL = {
+    account: ["account_id", "account_name", "account_currency"],
+    campaign: ["campaign_id", "campaign_name", "objective"],
+    adset: ["adset_id", "adset_name", "campaign_id", "campaign_name"],
+    ad: ["ad_id", "ad_name", "adset_id", "adset_name", "campaign_id", "campaign_name"],
+};
+/** Compose final field list: intent metrics + level-specific identity fields, deduplicated. */
+export function composeFields(intent, level) {
+    const intentFields = INSIGHTS_INTENTS[intent].fields;
+    const identity = IDENTITY_FIELDS_BY_LEVEL[level];
+    const seen = new Set();
+    const out = [];
+    for (const f of [...identity, ...intentFields]) {
+        if (!seen.has(f)) {
+            seen.add(f);
+            out.push(f);
+        }
+    }
+    return out;
+}
+export function getIntent(name) {
+    return INSIGHTS_INTENTS[name];
+}
+export function listIntents() {
+    return Object.values(INSIGHTS_INTENTS);
+}
+//# sourceMappingURL=presets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,MAAM,gBAAgB,GAA6C;IACjE,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,qFAAqF;QAClG,MAAM,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;KACtF;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,mFAAmF;QAChG,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,CAAC;QAClG,gBAAgB,EAAE,CAAC,aAAa,CAAC;KAClC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wEAAwE;QACrF,MAAM,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,CAAC;QAC9F,gBAAgB,EAAE,CAAC,aAAa,CAAC;KAClC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,kFAAkF;QAC/F,MAAM,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,yBAAyB,CAAC;KACjH;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,2EAA2E;QACxF,MAAM,EAAE;YACN,aAAa;YACb,OAAO;YACP,oBAAoB;YACpB,2BAA2B;YAC3B,2BAA2B;YAC3B,2BAA2B;YAC3B,4BAA4B;YAC5B,gCAAgC;YAChC,mBAAmB;SACpB;KACF;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,uDAAuD;QACpE,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;KACjC;CACF,CAAC;AAEF,MAAM,wBAAwB,GAAoC;IAChE,OAAO,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,kBAAkB,CAAC;IAC3D,QAAQ,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,WAAW,CAAC;IACvD,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,CAAC;IACjE,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,CAAC;CACnF,CAAC;AAEF,+FAA+F;AAC/F,MAAM,UAAU,aAAa,CAAC,MAAsB,EAAE,KAAoB;IACxE,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,gBAAgB,CAAC,IAAsB,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACzC,CAAC"}

package/dist/commands/ads/meta/preview.d.ts

@@ -0,0 +1,32 @@
+export declare const previewCommand: import("citty").CommandDef<{
+    readonly "creative-id": {
+        readonly type: "string";
+        readonly description: "Existing creative ID";
+    };
+    readonly "ad-id": {
+        readonly type: "string";
+        readonly description: "Existing ad ID";
+    };
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Required when previewing an unpublished --creative spec";
+    };
+    readonly creative: {
+        readonly type: "string";
+        readonly description: "JSON spec of an unpublished creative (e.g. object_story_spec)";
+    };
+    readonly "ad-format": {
+        readonly type: "string";
+        readonly description: "Meta ad_format enum value";
+        readonly required: true;
+    };
+    readonly "out-file": {
+        readonly type: "string";
+        readonly description: "Save iframe HTML to this path";
+    };
+    readonly "skip-cache": {
+        readonly type: "boolean";
+        readonly description: "Bypass server-side cache";
+    };
+}>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/commands/ads/meta/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/preview.ts"],"names":[],"mappings":"AAwCA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CzB,CAAC"}

package/dist/commands/ads/meta/preview.js

@@ -0,0 +1,90 @@
+import { writeFileSync } from "node:fs";
+import { defineCommand } from "citty";
+import { apiPost } from "../../../client.js";
+import { writeAdsJson } from "../output.js";
+import { handleMetaError } from "./shared.js";
+const VALID_AD_FORMATS = [
+    "DESKTOP_FEED_STANDARD",
+    "MOBILE_FEED_STANDARD",
+    "MOBILE_FEED_BASIC",
+    "RIGHT_COLUMN_STANDARD",
+    "MOBILE_FULLWIDTH",
+    "MOBILE_INTERSTITIAL",
+    "MOBILE_BANNER",
+    "MOBILE_MEDIUM_RECTANGLE",
+    "MOBILE_NATIVE",
+    "FACEBOOK_STORY_MOBILE",
+    "FACEBOOK_REELS_MOBILE",
+    "INSTAGRAM_STORY",
+    "INSTAGRAM_REELS",
+    "INSTAGRAM_REELS_OVERLAY",
+    "INSTAGRAM_STANDARD",
+    "INSTAGRAM_EXPLORE_CONTEXTUAL",
+    "INSTAGRAM_EXPLORE_GRID_HOME",
+    "INSTAGRAM_SHOP",
+    "INSTAGRAM_PROFILE_FEED",
+    "INSTREAM_VIDEO_DESKTOP",
+    "INSTREAM_VIDEO_MOBILE",
+    "FACEBOOK_REELS_BANNER",
+    "FACEBOOK_REELS_STICKER",
+    "MESSENGER_MOBILE_INBOX_MEDIA",
+    "MESSENGER_MOBILE_STORY_MEDIA",
+    "AUDIENCE_NETWORK_OUTSTREAM_VIDEO",
+    "AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE",
+    "AUDIENCE_NETWORK_REWARDED_VIDEO",
+    "INSTANT_ARTICLE_STANDARD",
+    "MARKETPLACE_MOBILE",
+    "BIZ_DISCO_FEED_MOBILE",
+];
+export const previewCommand = defineCommand({
+    meta: {
+        name: "preview",
+        description: `Generate a Meta-hosted preview iframe for a creative or ad. Returns iframe HTML which you
+can embed or save to a file. The iframe URL contains a short-lived access token — treat as secret.
+
+Examples:
+  baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD
+  baker ads meta preview --ad-id 9988 --ad-format INSTAGRAM_REELS --out-file /tmp/preview.html
+  baker ads meta preview --account-id act_123 --creative '{"object_story_spec":{...}}' --ad-format MOBILE_FEED_STANDARD`,
+    },
+    args: {
+        "creative-id": { type: "string", description: "Existing creative ID" },
+        "ad-id": { type: "string", description: "Existing ad ID" },
+        "account-id": { type: "string", description: "Required when previewing an unpublished --creative spec" },
+        creative: { type: "string", description: "JSON spec of an unpublished creative (e.g. object_story_spec)" },
+        "ad-format": { type: "string", description: "Meta ad_format enum value", required: true },
+        "out-file": { type: "string", description: "Save iframe HTML to this path" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+    },
+    run: async ({ args }) => {
+        const adFormat = args["ad-format"];
+        if (!VALID_AD_FORMATS.includes(adFormat)) {
+            handleMetaError(new Error(`Invalid --ad-format "${adFormat}". Run with --help to see supported values.`));
+        }
+        const body = { adFormat };
+        if (args["creative-id"])
+            body.creativeId = args["creative-id"];
+        if (args["ad-id"])
+            body.adId = args["ad-id"];
+        if (args["account-id"])
+            body.accountId = args["account-id"];
+        if (args.creative)
+            body.creative = args.creative;
+        if (args["skip-cache"])
+            body.skipCache = true;
+        try {
+            const data = await apiPost("/api/ads/meta/preview", body);
+            const html = data.map((d) => d.body).join("\n");
+            if (args["out-file"]) {
+                writeFileSync(args["out-file"], html, "utf-8");
+                writeAdsJson({ ok: true, data: { file: args["out-file"], rows: data.length } });
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=preview.js.map