@koda-sl/baker-cli 0.23.0 → 0.24.0-dev.55a07065

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

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"AAqHA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2F1B,CAAC"}

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

@@ -0,0 +1,178 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { getPreset, listPresets } from "./presets.js";
+import { csvOrJson, getDateRange, handleMetaError } from "./shared.js";
+const POLL_INTERVAL_MS = 5_000;
+const POLL_MAX_MS = 10 * 60_000;
+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 pickLevel(args, preset) {
+    const level = args.level ?? preset?.level;
+    if (!level) {
+        handleMetaError(new Error("--level is required (account|campaign|adset|ad)"));
+    }
+    return level;
+}
+function pickFields(fieldsArg, preset) {
+    const fields = fieldsArg ?? preset?.fields;
+    if (!fields || fields.length === 0) {
+        handleMetaError(new Error("--fields is required (comma-separated, e.g. impressions,spend,ctr)"));
+    }
+    return fields;
+}
+function applyDateRange(body, args, preset) {
+    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 = preset?.defaultDatePreset ?? "last_7d";
+    }
+}
+function buildBodyFromArgs(args, preset) {
+    const fieldsArg = commaSplit(args.fields);
+    const breakdowns = commaSplit(args.breakdowns);
+    const actionBreakdowns = commaSplit(args["action-breakdowns"]);
+    const attributionWindows = commaSplit(args["attribution-windows"]);
+    const body = {
+        object: args.object,
+        level: pickLevel(args, preset),
+        fields: pickFields(fieldsArg, preset),
+        timeIncrement: args["time-increment"],
+        breakdowns: breakdowns ?? preset?.breakdowns,
+        actionBreakdowns: actionBreakdowns ?? preset?.actionBreakdowns,
+        filtering: parseFiltering(args.filtering),
+        attributionWindows: attributionWindows ?? preset?.attributionWindows,
+        useAccountAttributionSetting: Boolean(args["use-account-attribution"]),
+        useUnifiedAttributionSetting: Boolean(args["use-unified-attribution"]),
+        limit: args.limit ? Number(args.limit) : preset?.defaultLimit,
+        skipCache: Boolean(args["skip-cache"]),
+    };
+    applyDateRange(body, args, preset);
+    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"));
+}
+export const insightsCommand = defineCommand({
+    meta: {
+        name: "insights",
+        description: `Run Meta Marketing API insights queries.
+
+Synchronous unless --async is set, or auto-fallback if Meta returns a "too large" error.
+Use presets for the marketing team's standard reports.
+
+Presets (run with --preset <name>):
+${listPresets()
+            .map((p) => `  ${p.name}  — ${p.description}`)
+            .join("\n")}
+
+Examples:
+  baker ads meta insights --object act_123 --level ad --fields impressions,spend --date-preset last_7d
+  baker ads meta insights --object 6123456 --preset campaign-performance
+  baker ads meta insights --object act_123 --preset placement-breakdown --since 2026-01-01 --until 2026-03-31 --async
+  baker ads meta insights --object act_123 --level ad --fields ad_id,impressions \\
+    --filtering '[{"field":"spend","operator":"GREATER_THAN","value":0}]'`,
+    },
+    args: {
+        object: {
+            type: "string",
+            description: "Object ID — act_<id> for account, or campaign/adset/ad ID",
+            required: true,
+        },
+        level: { type: "string", description: "account|campaign|adset|ad" },
+        fields: { type: "string", description: "Comma-separated fields list" },
+        preset: { type: "string", description: "Insights preset name" },
+        "list-presets": { type: "boolean", description: "List available presets 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" },
+        "action-breakdowns": { type: "string", description: "Comma-separated action_breakdowns" },
+        filtering: { type: "string", description: "JSON array of {field,operator,value}" },
+        "attribution-windows": {
+            type: "string",
+            description: "Comma-separated. Only 1d_view, 1d_click, 7d_click, 28d_click work as of 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 per preset)" },
+        async: { type: "boolean", description: "Submit as async job, poll, then dump results" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", default: "json" },
+    },
+    run: async ({ args }) => {
+        if (args["list-presets"]) {
+            writeAdsJson({ ok: true, data: listPresets() });
+            return;
+        }
+        const presetName = args.preset;
+        const preset = presetName ? getPreset(presetName) : undefined;
+        if (presetName && !preset) {
+            handleMetaError(new Error(`Unknown preset: ${presetName}. Use --list-presets.`));
+        }
+        const body = buildBodyFromArgs(args, preset);
+        try {
+            if (args.async) {
+                const submit = await apiPost("/api/ads/meta/insights/async", body);
+                process.stderr.write(`Submitted async insights job: ${submit.reportRunId}\n`);
+                await pollAsync(submit.reportRunId);
+                const result = await apiPost("/api/ads/meta/insights/async/result", {
+                    reportRunId: submit.reportRunId,
+                    fields: body.fields,
+                    limit: body.limit,
+                });
+                const fmt = csvOrJson(args);
+                if (fmt !== "json") {
+                    writeAdsOutput(result, fmt, body.fields);
+                    return;
+                }
+                writeAdsJson({ ok: true, data: result });
+                return;
+            }
+            const data = await apiPost("/api/ads/meta/insights", body);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt, body.fields);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        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/labels.d.ts

@@ -0,0 +1,16 @@
+export declare const labelsCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "Meta ad account ID";
+    };
+    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=labels.d.ts.map

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

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

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

@@ -0,0 +1,34 @@
+import { defineCommand } from "citty";
+import { apiGet } from "../../../client.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+export const labelsCommand = defineCommand({
+    meta: {
+        name: "labels",
+        description: `List ad labels for a Meta ad account.`,
+    },
+    args: {
+        "account-id": { type: "string", description: "Meta ad account ID" },
+        "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
+        output: { type: "string", description: "Output format", 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/meta/labels", params);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# sourceMappingURL=labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/labels.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,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uCAAuC;KACrD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;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,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DxB,CAAC"}

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

@@ -0,0 +1,69 @@
+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) {
+                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;
+                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);
+                const fmt = csvOrJson(args);
+                if (fmt !== "json") {
+                    writeAdsOutput(data, fmt);
+                    return;
+                }
+                writeAdsJson({ ok: true, data });
+                return;
+            }
+            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);
+            const fmt = csvOrJson(args);
+            if (fmt !== "json") {
+                writeAdsOutput(data, fmt);
+                return;
+            }
+            writeAdsJson({ ok: true, data });
+        }
+        catch (err) {
+            handleMetaError(err);
+        }
+    },
+});
+//# 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,18 @@
+/**
+ * Meta-native insights presets. Names + fields chosen for our marketing team's
+ * review workflows — not parity-aligned with the Google Ads presets.
+ */
+export interface MetaInsightsPreset {
+    name: string;
+    description: string;
+    level: "account" | "campaign" | "adset" | "ad";
+    fields: string[];
+    breakdowns?: string[];
+    actionBreakdowns?: string[];
+    attributionWindows?: string[];
+    defaultDatePreset: string;
+    defaultLimit: number;
+}
+export declare function getPreset(name: string): MetaInsightsPreset | undefined;
+export declare function listPresets(): MetaInsightsPreset[];
+//# 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;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAsGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtE;AAED,wBAAgB,WAAW,IAAI,kBAAkB,EAAE,CAElD"}

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

@@ -0,0 +1,110 @@
+/**
+ * Meta-native insights presets. Names + fields chosen for our marketing team's
+ * review workflows — not parity-aligned with the Google Ads presets.
+ */
+const META_INSIGHTS_PRESETS = {
+    "campaign-performance": {
+        name: "campaign-performance",
+        description: "Per-campaign spend, ROAS, and purchase metrics over the last 7 days.",
+        level: "campaign",
+        fields: [
+            "campaign_id",
+            "campaign_name",
+            "objective",
+            "impressions",
+            "spend",
+            "clicks",
+            "ctr",
+            "cpc",
+            "actions",
+            "action_values",
+            "purchase_roas",
+        ],
+        actionBreakdowns: ["action_type"],
+        defaultDatePreset: "last_7d",
+        defaultLimit: 1000,
+    },
+    "creative-performance": {
+        name: "creative-performance",
+        description: "Per-ad ranking + delivery quality. Use to flag creatives for refresh.",
+        level: "ad",
+        fields: [
+            "ad_id",
+            "ad_name",
+            "campaign_name",
+            "adset_name",
+            "impressions",
+            "spend",
+            "ctr",
+            "cpc",
+            "quality_ranking",
+            "engagement_rate_ranking",
+            "conversion_rate_ranking",
+        ],
+        defaultDatePreset: "last_7d",
+        defaultLimit: 2000,
+    },
+    "placement-breakdown": {
+        name: "placement-breakdown",
+        description: "Spend & CPM by Facebook/Instagram placement and device.",
+        level: "adset",
+        fields: ["adset_id", "adset_name", "impressions", "spend", "ctr", "cpm", "actions"],
+        breakdowns: ["publisher_platform", "platform_position", "impression_device"],
+        defaultDatePreset: "last_14d",
+        defaultLimit: 5000,
+    },
+    "device-breakdown": {
+        name: "device-breakdown",
+        description: "Conversion performance by device + OS.",
+        level: "ad",
+        fields: ["ad_id", "ad_name", "impressions", "clicks", "spend", "actions", "purchase_roas"],
+        breakdowns: ["device_platform", "impression_device"],
+        defaultDatePreset: "last_7d",
+        defaultLimit: 5000,
+    },
+    "audience-breakdown": {
+        name: "audience-breakdown",
+        description: "Demographic split (age/gender/country) at adset level.",
+        level: "adset",
+        fields: ["adset_id", "adset_name", "impressions", "spend", "actions"],
+        breakdowns: ["age", "gender", "country"],
+        defaultDatePreset: "last_28d",
+        defaultLimit: 10000,
+    },
+    funnel: {
+        name: "funnel",
+        description: "Impression → click → landing page view → lead/purchase funnel.",
+        level: "ad",
+        fields: ["ad_id", "ad_name", "impressions", "clicks", "inline_link_clicks", "actions", "action_values", "spend"],
+        actionBreakdowns: ["action_type"],
+        defaultDatePreset: "last_7d",
+        defaultLimit: 2000,
+    },
+    "video-performance": {
+        name: "video-performance",
+        description: "Video watch funnel and per-thruplay cost.",
+        level: "ad",
+        fields: [
+            "ad_id",
+            "ad_name",
+            "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",
+        ],
+        defaultDatePreset: "last_14d",
+        defaultLimit: 2000,
+    },
+};
+export function getPreset(name) {
+    return META_INSIGHTS_PRESETS[name];
+}
+export function listPresets() {
+    return Object.values(META_INSIGHTS_PRESETS);
+}
+//# 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":"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"}

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)) {
+            process.stderr.write(`Warning: ad-format "${adFormat}" not in known list — Meta may reject it\n`);
+        }
+        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

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

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