@koda-sl/baker-cli 0.513.0 → 0.514.0-dev.555f7007e

package/dist/performance-J3DLNI2W.js

@@ -0,0 +1,27 @@
+import {
+  definitionInsights,
+  parseDays,
+  performanceCommand,
+  withDefinitions
+} from "./chunk-5LJ6E4YU.js";
+import "./chunk-SAAXU7QR.js";
+import "./chunk-NZ34KM46.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  definitionInsights,
+  parseDays,
+  performanceCommand,
+  withDefinitions
+};
+//# sourceMappingURL=performance-J3DLNI2W.js.map

package/dist/pixels-THEGYRXT.js

@@ -0,0 +1,62 @@
+import {
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-3M45PYU7.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-EW7JSTRZ.js";
+import "./chunk-ZRP7Y2DM.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/pixels.ts
+import { defineCommand } from "citty";
+var CREATE_ARGS = {
+  name: { type: "string", description: "What the pixel is called in Ads Manager, e.g. withbaker.com", required: true }
+};
+function pixelCreateOp(args) {
+  return { kind: "pixel.create", payload: { name: typeof args.name === "string" ? args.name.trim() : args.name } };
+}
+registerSchema({
+  command: "ads.chatgpt.pixels.create",
+  description: "Stage a new website pixel for the account, applied when the chat is published. Read `conversions` first: an account usually needs one pixel, installed on every page, and a second splits the site's events.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var pixelsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new website pixel (applies when the chat is published).
+
+Example:
+  baker ads chatgpt pixels create --name "withbaker.com"`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(pixelCreateOp(args), CHATGPT_ADS_REFERENCE.conversions, (staged) => [
+      `Define what it counts with \`baker ads chatgpt conversions create --pixel ${staged.ref} --name \u2026 --event \u2026\`.`,
+      "After the publish, read its Pixel ID with `baker ads chatgpt conversions` and install it on the site's pages as a tracking tag."
+    ]);
+  }
+});
+var pixelsCommand = defineCommand({
+  meta: {
+    name: "pixels",
+    description: `Website pixels \u2014 what a site installs so ChatGPT Ads can count its conversions. Read them with \`baker ads chatgpt conversions\`.
+
+Example:
+  baker ads chatgpt pixels create --name "withbaker.com"`
+  },
+  subCommands: { create: pixelsCreateCommand }
+});
+export {
+  pixelCreateOp,
+  pixelsCommand
+};
+//# sourceMappingURL=pixels-THEGYRXT.js.map

package/dist/pixels-THEGYRXT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/pixels.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHATGPT_ADS_REFERENCE } from \"./shared.ts\";\nimport { schemaArgs, stageChatgptOp } from \"./write-shared.ts\";\n\n/**\n * A new website pixel, staged like every write. Its Pixel ID — what the site\n * installs — exists only after the chat publishes; a conversion staged beside it\n * counts from it by its ref.\n */\n\nconst CREATE_ARGS = {\n  name: { type: \"string\", description: \"What the pixel is called in Ads Manager, e.g. withbaker.com\", required: true },\n} as const;\n\nexport function pixelCreateOp(args: Record<string, unknown>): Record<string, unknown> {\n  return { kind: \"pixel.create\", payload: { name: typeof args.name === \"string\" ? args.name.trim() : args.name } };\n}\n\nregisterSchema({\n  command: \"ads.chatgpt.pixels.create\",\n  description:\n    \"Stage a new website pixel for the account, applied when the chat is published. Read `conversions` first: an account usually needs one pixel, installed on every page, and a second splits the site's events.\",\n  args: schemaArgs(CREATE_ARGS),\n});\n\nconst pixelsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a new website pixel (applies when the chat is published).\n\nExample:\n  baker ads chatgpt pixels create --name \"withbaker.com\"`,\n  },\n  args: CREATE_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOp(pixelCreateOp(args), CHATGPT_ADS_REFERENCE.conversions, (staged) => [\n      `Define what it counts with \\`baker ads chatgpt conversions create --pixel ${staged.ref} --name … --event …\\`.`,\n      \"After the publish, read its Pixel ID with `baker ads chatgpt conversions` and install it on the site's pages as a tracking tag.\",\n    ]);\n  },\n});\n\nexport const pixelsCommand = defineCommand({\n  meta: {\n    name: \"pixels\",\n    description: `Website pixels — what a site installs so ChatGPT Ads can count its conversions. Read them with \\`baker ads chatgpt conversions\\`.\n\nExample:\n  baker ads chatgpt pixels create --name \"withbaker.com\"`,\n  },\n  subCommands: { create: pixelsCreateCommand },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAW9B,IAAM,cAAc;AAAA,EAClB,MAAM,EAAE,MAAM,UAAU,aAAa,+DAA+D,UAAU,KAAK;AACrH;AAEO,SAAS,cAAc,MAAwD;AACpF,SAAO,EAAE,MAAM,gBAAgB,SAAS,EAAE,MAAM,OAAO,KAAK,SAAS,WAAW,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE;AACjH;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,WAAW,WAAW;AAC9B,CAAC;AAED,IAAM,sBAAsB,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,eAAe,cAAc,IAAI,GAAG,sBAAsB,aAAa,CAAC,WAAW;AAAA,MACvF,6EAA6E,OAAO,GAAG;AAAA,MACvF;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,aAAa,EAAE,QAAQ,oBAAoB;AAC7C,CAAC;","names":[]}

package/dist/plan-7UF76Q6U.js

@@ -0,0 +1,208 @@
+import {
+  funnelStepSchema
+} from "./chunk-LAL4PKNJ.js";
+import {
+  TAG_MANAGER_TIMEOUT_MS
+} from "./chunk-3GAR4AZK.js";
+import {
+  trackingPlanErrorEnvelope
+} from "./chunk-WLESMH4J.js";
+import {
+  ANALYTICS_EVENT_DOORS,
+  parseEventKey
+} from "./chunk-JOE42ZW6.js";
+import "./chunk-NKQWDEB7.js";
+import "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  getEnv
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/analytics/plan.ts
+import { readFileSync } from "fs";
+
+// ../api/src/analytics/trackingPlanWire.ts
+import { z as z2 } from "zod";
+
+// ../api/src/analytics/trackingPlan.ts
+import { z } from "zod";
+var text = z.string().trim().min(1).max(2e3);
+var key = z.string().trim().min(1).max(100);
+var webUrl = z.url().refine(
+  (value) => URL.canParse(value) && ["https:", "http:"].includes(new URL(value).protocol),
+  "Use a website address"
+);
+var trackingEventSchema = z.object({
+  eventKey: key.refine((value) => parseEventKey(value) !== null, "Use an existing Baker event key"),
+  name: text,
+  purpose: z.enum(["conversion", "progress", "diagnostic", "uncounted"]),
+  door: z.enum(ANALYTICS_EVENT_DOORS),
+  sourceEvent: key.optional(),
+  emitterEvidence: text.optional(),
+  status: z.enum(["prepared", "waiting", "published", "verified"]),
+  requirement: text.optional(),
+  owner: text.optional(),
+  verificationEvidence: text.optional()
+}).superRefine((event, ctx) => {
+  if (event.status === "waiting") {
+    if (!event.requirement || !event.owner)
+      ctx.addIssue({ code: "custom", message: "A waiting event needs its requirement and owner" });
+  } else if (!event.emitterEvidence) {
+    ctx.addIssue({ code: "custom", message: "A prepared event needs evidence that the source emits it" });
+  }
+  if (["published", "verified"].includes(event.status) && !event.verificationEvidence) {
+    ctx.addIssue({
+      code: "custom",
+      message: "Published or verified tracking needs evidence; a staged tag is only prepared"
+    });
+  }
+});
+var trackingJourneySchema = z.object({
+  key,
+  name: text,
+  entryUrls: z.array(webUrl).max(50),
+  destinationUrl: webUrl,
+  strategy: z.enum(["native", "embed", "api", "link"]),
+  status: z.enum(["supported", "waiting"]),
+  requiredFields: z.array(key).max(100),
+  attribution: text,
+  acceptanceEvidence: text.optional(),
+  continuationEvidence: text.optional(),
+  requirement: text.optional(),
+  owner: text.optional()
+}).superRefine((journey, ctx) => {
+  if (journey.strategy === "link" && journey.requiredFields.length > 0)
+    ctx.addIssue({
+      code: "custom",
+      message: "A link handoff must not capture details that the destination asks for again"
+    });
+  if (journey.status === "waiting" && (!journey.requirement || !journey.owner))
+    ctx.addIssue({ code: "custom", message: "A waiting journey needs its requirement and owner" });
+  if (journey.status === "supported" && journey.strategy === "api" && (!journey.acceptanceEvidence || !journey.continuationEvidence))
+    ctx.addIssue({
+      code: "custom",
+      message: "An API replacement needs accepted-submission and continuation evidence"
+    });
+});
+var trackingPlanSchema = z.object({
+  journeys: z.array(trackingJourneySchema).max(30),
+  events: z.array(trackingEventSchema).max(100)
+}).superRefine((plan, ctx) => {
+  for (const entries of [plan.journeys.map((journey) => journey.key), plan.events.map((event) => event.eventKey)]) {
+    if (new Set(entries).size !== entries.length)
+      ctx.addIssue({ code: "custom", message: "Each journey and event must appear once" });
+  }
+});
+
+// ../api/src/analytics/trackingPlanWire.ts
+var key2 = z2.string().trim().min(1).max(100);
+var variableName = z2.string().trim().min(1).max(200).refine((value) => !/[{}<>"'\\\r\n]/.test(value), "Use a plain container variable name");
+var trackingInstallationSchema = z2.object({
+  containerId: key2,
+  baseTagName: key2,
+  folderId: key2.optional(),
+  consent: z2.enum(["auto", "strict"]).default("auto"),
+  measure: z2.enum(["campaigns", "outcomes", "all"]).default("campaigns"),
+  events: z2.array(
+    z2.object({
+      eventKey: key2.refine((value) => parseEventKey(value) !== null, "Use an existing Baker event key"),
+      tagName: key2,
+      triggerId: key2,
+      properties: z2.record(key2, variableName).default({}),
+      eventIdVariable: variableName.optional()
+    })
+  ).max(50)
+});
+var trackingPlanRequestSchema = z2.object({
+  chatId: z2.string().optional(),
+  plan: trackingPlanSchema.optional(),
+  wireConversions: z2.boolean().default(false),
+  steps: z2.array(funnelStepSchema).max(30).optional(),
+  installation: trackingInstallationSchema.optional()
+}).superRefine((request, ctx) => {
+  if (!request.plan && (request.installation || request.wireConversions || request.steps))
+    ctx.addIssue({ code: "custom", message: "Preparation needs the agreed tracking plan" });
+});
+var trackingPlanResponseSchema = z2.object({
+  ok: z2.literal(true),
+  data: z2.object({ plan: trackingPlanSchema.nullable(), staged: z2.boolean() }),
+  hints: z2.array(z2.string()).optional()
+});
+
+// src/commands/analytics/plan.ts
+import { defineCommand } from "citty";
+var description = "Start here before building a replacement Form: read the agreed journeys, event names, purposes and readiness. --json @plan.json stages the complete plan, with optional wireConversions, funnel steps and a managed Tag Manager installation. Each event records its actual emitter or the missing change and owner. Prepared is not verified. See analytics.md for the contract. Repeating installation preparation replaces its own staged tags; applies only at Publish. --full includes evidence; the default keeps the decision inventory compact.";
+var args = {
+  json: {
+    type: "string",
+    description: "Preparation request as JSON or @path; omit to read the effective plan",
+    required: false
+  },
+  full: { type: "boolean", description: "Include all journey and verification evidence", required: false }
+};
+registerSchema({ command: "analytics.plan", description, args });
+var planCommand = defineCommand({
+  meta: { name: "plan", description },
+  args,
+  run: async ({ args: args2 }) => {
+    try {
+      const input = args2.json ? JSON.parse(args2.json.startsWith("@") ? readFileSync(args2.json.slice(1), "utf8") : args2.json) : {};
+      const parsed = trackingPlanRequestSchema.parse(input);
+      const body = { ...parsed, chatId: getEnv().BAKER_CHAT_ID };
+      const response = trackingPlanResponseSchema.parse(
+        // Preparing stages the Tag Manager install, which queues behind other companies' requests.
+        await apiPost("/api/analytics/plan", body, { timeoutMs: TAG_MANAGER_TIMEOUT_MS })
+      );
+      const plan = response.data.plan;
+      writeJsonEnvelope({
+        ...response,
+        data: {
+          ...response.data,
+          plan: args2.full || !plan ? plan : {
+            journeys: plan.journeys.map(
+              ({ key: key3, name, strategy, status, destinationUrl, requirement, owner }) => ({
+                key: key3,
+                name,
+                strategy,
+                status,
+                destinationUrl,
+                requirement,
+                owner
+              })
+            ),
+            events: plan.events.map(
+              ({ eventKey, name, purpose, door, sourceEvent, status, requirement, owner }) => ({
+                eventKey,
+                name,
+                purpose,
+                door,
+                sourceEvent,
+                status,
+                requirement,
+                owner
+              })
+            )
+          }
+        }
+      });
+    } catch (error) {
+      writeJsonEnvelope({ ok: false, error: trackingPlanErrorEnvelope(error) });
+      process.exitCode = 1;
+    }
+  }
+});
+export {
+  planCommand
+};
+//# sourceMappingURL=plan-7UF76Q6U.js.map

package/dist/plan-7UF76Q6U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/analytics/plan.ts","../../api/src/analytics/trackingPlanWire.ts","../../api/src/analytics/trackingPlan.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { trackingPlanRequestSchema, trackingPlanResponseSchema } from \"@baker/api/analytics/trackingPlanWire\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { getEnv } from \"../../env.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\nimport { TAG_MANAGER_TIMEOUT_MS } from \"../tag-manager/shared.ts\";\nimport { trackingPlanErrorEnvelope } from \"./errorEnvelope.ts\";\n\nconst description =\n  \"Start here before building a replacement Form: read the agreed journeys, event names, purposes and readiness. --json @plan.json stages the complete plan, with optional wireConversions, funnel steps and a managed Tag Manager installation. Each event records its actual emitter or the missing change and owner. Prepared is not verified. See analytics.md for the contract. Repeating installation preparation replaces its own staged tags; applies only at Publish. --full includes evidence; the default keeps the decision inventory compact.\";\nconst args = {\n  json: {\n    type: \"string\" as const,\n    description: \"Preparation request as JSON or @path; omit to read the effective plan\",\n    required: false,\n  },\n  full: { type: \"boolean\" as const, description: \"Include all journey and verification evidence\", required: false },\n};\nregisterSchema({ command: \"analytics.plan\", description, args });\n\nexport const planCommand = defineCommand({\n  meta: { name: \"plan\", description },\n  args,\n  run: async ({ args }) => {\n    try {\n      const input: unknown = args.json\n        ? JSON.parse(args.json.startsWith(\"@\") ? readFileSync(args.json.slice(1), \"utf8\") : args.json)\n        : {};\n      const parsed = trackingPlanRequestSchema.parse(input);\n      const body = { ...parsed, chatId: getEnv().BAKER_CHAT_ID };\n      const response = trackingPlanResponseSchema.parse(\n        // Preparing stages the Tag Manager install, which queues behind other companies' requests.\n        await apiPost(\"/api/analytics/plan\", body, { timeoutMs: TAG_MANAGER_TIMEOUT_MS }),\n      );\n      const plan = response.data.plan;\n      writeJsonEnvelope({\n        ...response,\n        data: {\n          ...response.data,\n          plan:\n            args.full || !plan\n              ? plan\n              : {\n                  journeys: plan.journeys.map(\n                    ({ key, name, strategy, status, destinationUrl, requirement, owner }) => ({\n                      key,\n                      name,\n                      strategy,\n                      status,\n                      destinationUrl,\n                      requirement,\n                      owner,\n                    }),\n                  ),\n                  events: plan.events.map(\n                    ({ eventKey, name, purpose, door, sourceEvent, status, requirement, owner }) => ({\n                      eventKey,\n                      name,\n                      purpose,\n                      door,\n                      sourceEvent,\n                      status,\n                      requirement,\n                      owner,\n                    }),\n                  ),\n                },\n        },\n      });\n    } catch (error) {\n      writeJsonEnvelope({ ok: false, error: trackingPlanErrorEnvelope(error) });\n      process.exitCode = 1;\n    }\n  },\n});\n","import { z } from \"zod\";\nimport { funnelStepSchema } from \"../funnel/wire\";\nimport { parseEventKey } from \"./eventKey\";\nimport { trackingPlanSchema } from \"./trackingPlan\";\n\nconst key = z.string().trim().min(1).max(100);\nconst variableName = z\n  .string()\n  .trim()\n  .min(1)\n  .max(200)\n  .refine((value) => !/[{}<>\"'\\\\\\r\\n]/.test(value), \"Use a plain container variable name\");\nexport const trackingInstallationSchema = z.object({\n  containerId: key,\n  baseTagName: key,\n  folderId: key.optional(),\n  consent: z.enum([\"auto\", \"strict\"]).default(\"auto\"),\n  measure: z.enum([\"campaigns\", \"outcomes\", \"all\"]).default(\"campaigns\"),\n  events: z\n    .array(\n      z.object({\n        eventKey: key.refine((value) => parseEventKey(value) !== null, \"Use an existing Baker event key\"),\n        tagName: key,\n        triggerId: key,\n        properties: z.record(key, variableName).default({}),\n        eventIdVariable: variableName.optional(),\n      }),\n    )\n    .max(50),\n});\nexport type TrackingInstallation = z.infer<typeof trackingInstallationSchema>;\nexport const trackingPlanRequestSchema = z\n  .object({\n    chatId: z.string().optional(),\n    plan: trackingPlanSchema.optional(),\n    wireConversions: z.boolean().default(false),\n    steps: z.array(funnelStepSchema).max(30).optional(),\n    installation: trackingInstallationSchema.optional(),\n  })\n  .superRefine((request, ctx) => {\n    if (!request.plan && (request.installation || request.wireConversions || request.steps))\n      ctx.addIssue({ code: \"custom\", message: \"Preparation needs the agreed tracking plan\" });\n  });\nexport const trackingPlanResponseSchema = z.object({\n  ok: z.literal(true),\n  data: z.object({ plan: trackingPlanSchema.nullable(), staged: z.boolean() }),\n  hints: z.array(z.string()).optional(),\n});\nexport type TrackingPlanResponse = z.infer<typeof trackingPlanResponseSchema>;\n","import { z } from \"zod\";\nimport { parseEventKey } from \"./eventKey\";\nimport { describeSendEvent } from \"./sends\";\nimport { ANALYTICS_EVENT_DOORS } from \"./wire\";\n\nconst text = z.string().trim().min(1).max(2000);\nconst key = z.string().trim().min(1).max(100);\nconst webUrl = z\n  .url()\n  .refine(\n    (value) => URL.canParse(value) && [\"https:\", \"http:\"].includes(new URL(value).protocol),\n    \"Use a website address\",\n  );\n\nconst trackingEventSchema = z\n  .object({\n    eventKey: key.refine((value) => parseEventKey(value) !== null, \"Use an existing Baker event key\"),\n    name: text,\n    purpose: z.enum([\"conversion\", \"progress\", \"diagnostic\", \"uncounted\"]),\n    door: z.enum(ANALYTICS_EVENT_DOORS),\n    sourceEvent: key.optional(),\n    emitterEvidence: text.optional(),\n    status: z.enum([\"prepared\", \"waiting\", \"published\", \"verified\"]),\n    requirement: text.optional(),\n    owner: text.optional(),\n    verificationEvidence: text.optional(),\n  })\n  .superRefine((event, ctx) => {\n    if (event.status === \"waiting\") {\n      if (!event.requirement || !event.owner)\n        ctx.addIssue({ code: \"custom\", message: \"A waiting event needs its requirement and owner\" });\n    } else if (!event.emitterEvidence) {\n      ctx.addIssue({ code: \"custom\", message: \"A prepared event needs evidence that the source emits it\" });\n    }\n    if ([\"published\", \"verified\"].includes(event.status) && !event.verificationEvidence) {\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Published or verified tracking needs evidence; a staged tag is only prepared\",\n      });\n    }\n  });\nexport type TrackingEvent = z.infer<typeof trackingEventSchema>;\n\nconst trackingJourneySchema = z\n  .object({\n    key,\n    name: text,\n    entryUrls: z.array(webUrl).max(50),\n    destinationUrl: webUrl,\n    strategy: z.enum([\"native\", \"embed\", \"api\", \"link\"]),\n    status: z.enum([\"supported\", \"waiting\"]),\n    requiredFields: z.array(key).max(100),\n    attribution: text,\n    acceptanceEvidence: text.optional(),\n    continuationEvidence: text.optional(),\n    requirement: text.optional(),\n    owner: text.optional(),\n  })\n  .superRefine((journey, ctx) => {\n    if (journey.strategy === \"link\" && journey.requiredFields.length > 0)\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"A link handoff must not capture details that the destination asks for again\",\n      });\n    if (journey.status === \"waiting\" && (!journey.requirement || !journey.owner))\n      ctx.addIssue({ code: \"custom\", message: \"A waiting journey needs its requirement and owner\" });\n    if (\n      journey.status === \"supported\" &&\n      journey.strategy === \"api\" &&\n      (!journey.acceptanceEvidence || !journey.continuationEvidence)\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"An API replacement needs accepted-submission and continuation evidence\",\n      });\n  });\n\nexport const trackingPlanSchema = z\n  .object({\n    journeys: z.array(trackingJourneySchema).max(30),\n    events: z.array(trackingEventSchema).max(100),\n  })\n  .superRefine((plan, ctx) => {\n    for (const entries of [plan.journeys.map((journey) => journey.key), plan.events.map((event) => event.eventKey)]) {\n      if (new Set(entries).size !== entries.length)\n        ctx.addIssue({ code: \"custom\", message: \"Each journey and event must appear once\" });\n    }\n  });\nexport type TrackingPlan = z.infer<typeof trackingPlanSchema>;\n\nexport const TRACKING_STATUS_LABEL = {\n  prepared: \"Prepared\",\n  waiting: \"Waiting for a change\",\n  published: \"Published\",\n  verified: \"Verified\",\n} as const;\n\nexport const TRACKING_PURPOSE_LABEL = {\n  conversion: \"Conversion\",\n  progress: \"Progress\",\n  diagnostic: \"Diagnostic\",\n  uncounted: \"Not counted\",\n} as const;\n\nexport const TRACKING_DOOR_LABEL = {\n  pages: \"Baker pages\",\n  website: \"Website pixel\",\n  server: \"Your server\",\n  integrations: \"Integration\",\n} as const;\n\n/** Review the journey, event mapping, requirements and supporting evidence. */\nexport function describeTrackingPlan(plan: TrackingPlan | null | undefined): string {\n  if (!plan) return \"No tracking plan\";\n  return (\n    [\n      ...plan.journeys.map((journey) =>\n        [\n          journey.name,\n          (\n            {\n              native: \"Existing platform form\",\n              embed: \"Embedded Form\",\n              api: \"Connected submission\",\n              link: \"Link to existing Form\",\n            } as const\n          )[journey.strategy],\n          journey.status === \"supported\" ? \"Supported\" : \"Waiting for a change\",\n          journey.entryUrls.join(\", \"),\n          `to ${journey.destinationUrl}`,\n          `Fields: ${journey.requiredFields.join(\", \") || \"none\"}`,\n          journey.attribution,\n          journey.acceptanceEvidence,\n          journey.continuationEvidence,\n          journey.requirement,\n          journey.owner,\n        ]\n          .filter(Boolean)\n          .join(\" · \"),\n      ),\n      ...plan.events.map((event) =>\n        [\n          event.name,\n          `${event.sourceEvent ? `App event: ${event.sourceEvent} → ` : \"\"}Report event: ${describeSendEvent(event.eventKey)}`,\n          TRACKING_PURPOSE_LABEL[event.purpose],\n          TRACKING_DOOR_LABEL[event.door],\n          TRACKING_STATUS_LABEL[event.status],\n          event.emitterEvidence,\n          event.requirement,\n          event.owner,\n          event.verificationEvidence,\n        ]\n          .filter(Boolean)\n          .join(\" · \"),\n      ),\n    ].join(\"\\n\") || \"No journeys or events\"\n  );\n}\n"],"mappings":"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","names":["z","key","z","args","key"]}

package/dist/preview-LRJOQ7LM.js

@@ -0,0 +1,218 @@
+import {
+  FACEBOOK_PREVIEW_FORMATS,
+  INSTAGRAM_PREVIEW_FORMATS,
+  PLATFORM_SCOPED_POSITIONS,
+  previewFormatForPosition
+} from "./chunk-Q3GSVLE5.js";
+import "./chunk-GDFJOCDO.js";
+import {
+  handleMetaError
+} from "./chunk-B2POVFR2.js";
+import "./chunk-Y2JZX6JB.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/preview.ts
+import { writeFileSync } from "fs";
+import { defineCommand } from "citty";
+var VALID_AD_FORMATS = [
+  "AUDIENCE_NETWORK_INSTREAM_VIDEO",
+  "AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE",
+  "AUDIENCE_NETWORK_OUTSTREAM_VIDEO",
+  "AUDIENCE_NETWORK_REWARDED_VIDEO",
+  "BIZ_DISCO_FEED_MOBILE",
+  "DESKTOP_FEED_STANDARD",
+  "FACEBOOK_IFU_REELS_MOBILE",
+  "FACEBOOK_PROFILE_FEED_DESKTOP",
+  "FACEBOOK_PROFILE_FEED_MOBILE",
+  "FACEBOOK_PROFILE_REELS_MOBILE",
+  "FACEBOOK_REELS_BANNER",
+  "FACEBOOK_REELS_BANNER_DESKTOP",
+  "FACEBOOK_REELS_BANNER_FEED_ANDROID",
+  "FACEBOOK_REELS_BANNER_FEED_ANDROID_LARGE",
+  "FACEBOOK_REELS_BANNER_FULLSCREEN_IOS",
+  "FACEBOOK_REELS_BANNER_FULLSCREEN_MOBILE",
+  "FACEBOOK_REELS_MOBILE",
+  "FACEBOOK_REELS_POSTLOOP",
+  "FACEBOOK_REELS_POSTLOOP_FEED",
+  "FACEBOOK_REELS_SIMILAR_PRODUCTS_MOBILE",
+  "FACEBOOK_REELS_STICKER",
+  "FACEBOOK_STORY_MOBILE",
+  "FACEBOOK_STORY_STICKER_MOBILE",
+  "INSTAGRAM_EXPLORE_CONTEXTUAL",
+  "INSTAGRAM_EXPLORE_GRID_HOME",
+  "INSTAGRAM_EXPLORE_IMMERSIVE",
+  "INSTAGRAM_FEED_WEB",
+  "INSTAGRAM_FEED_WEB_M_SITE",
+  "INSTAGRAM_LEAD_GEN_MULTI_SUBMIT_ADS",
+  "INSTAGRAM_PROFILE_FEED",
+  "INSTAGRAM_PROFILE_REELS",
+  "INSTAGRAM_REELS",
+  "INSTAGRAM_REELS_OVERLAY",
+  "INSTAGRAM_REELS_WEB",
+  "INSTAGRAM_REELS_WEB_M_SITE",
+  "INSTAGRAM_SEARCH_CHAIN",
+  "INSTAGRAM_SEARCH_GRID",
+  "INSTAGRAM_SHOP",
+  "INSTAGRAM_STANDARD",
+  "INSTAGRAM_STORY",
+  "INSTAGRAM_STORY_EFFECT_TRAY",
+  "INSTAGRAM_STORY_WEB",
+  "INSTAGRAM_STORY_WEB_M_SITE",
+  "INSTANT_ARTICLE_RECIRCULATION_AD",
+  "INSTANT_ARTICLE_STANDARD",
+  "INSTREAM_BANNER_DESKTOP",
+  "INSTREAM_BANNER_FEED_IOS",
+  "INSTREAM_BANNER_FULLSCREEN_IOS",
+  "INSTREAM_BANNER_FULLSCREEN_MOBILE",
+  "INSTREAM_BANNER_IMMERSIVE_MOBILE",
+  "INSTREAM_BANNER_MOBILE",
+  "INSTREAM_VIDEO_DESKTOP",
+  "INSTREAM_VIDEO_FULLSCREEN_IOS",
+  "INSTREAM_VIDEO_FULLSCREEN_MOBILE",
+  "INSTREAM_VIDEO_IMAGE",
+  "INSTREAM_VIDEO_IMMERSIVE_MOBILE",
+  "INSTREAM_VIDEO_MOBILE",
+  "JOB_BROWSER_DESKTOP",
+  "JOB_BROWSER_MOBILE",
+  "MARKETPLACE_MOBILE",
+  "MESSENGER_MOBILE_INBOX_MEDIA",
+  "MESSENGER_MOBILE_STORY_MEDIA",
+  "MOBILE_BANNER",
+  "MOBILE_FEED_BASIC",
+  "MOBILE_FEED_STANDARD",
+  "MOBILE_FULLWIDTH",
+  "MOBILE_INTERSTITIAL",
+  "MOBILE_MEDIUM_RECTANGLE",
+  "MOBILE_NATIVE",
+  "RIGHT_COLUMN_STANDARD",
+  "SUGGESTED_VIDEO_DESKTOP",
+  "SUGGESTED_VIDEO_FULLSCREEN_MOBILE",
+  "SUGGESTED_VIDEO_IMMERSIVE_MOBILE",
+  "SUGGESTED_VIDEO_MOBILE",
+  "WATCH_FEED_HOME",
+  "WATCH_FEED_MOBILE",
+  "WHATSAPP_STATUS_MEDIA"
+];
+function failPreviewValidation(message) {
+  writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function resolvePlacement(position, platform) {
+  const platformArg = typeof platform === "string" ? platform.toLowerCase() : void 0;
+  if (platformArg && platformArg !== "facebook" && platformArg !== "instagram") {
+    failPreviewValidation("--platform must be facebook or instagram");
+  }
+  const format = previewFormatForPosition(position, platformArg);
+  if (format) {
+    return format;
+  }
+  if (PLATFORM_SCOPED_POSITIONS.has(position) && !platformArg) {
+    failPreviewValidation(
+      `--placement ${position} names a different surface on Facebook and on Instagram \u2014 add --platform facebook or --platform instagram (the breakdown row's publisher_platform)`
+    );
+  }
+  failPreviewValidation(
+    `No Meta preview format is published for placement "${position}". Meta does not document one for every placement (facebook_notification among them), so this placement cannot be previewed \u2014 report it as unverified rather than inferring what it renders. Pass the platform_position exactly as the insights breakdown spelled it: targeting names a few surfaces differently (story, reels, explore_home) and those names never appear in a breakdown. Previewable placements: ${listPlacements()}`
+  );
+}
+function listPlacements() {
+  const facebook = Object.keys(FACEBOOK_PREVIEW_FORMATS).join(", ");
+  const instagram = Object.keys(INSTAGRAM_PREVIEW_FORMATS).join(", ");
+  return `facebook \u2014 ${facebook}; instagram \u2014 ${instagram}`;
+}
+var 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 \u2014 treat as secret.
+
+Start here when you need to know what a creative looks like in one specific placement \u2014 this is
+Meta's own renderer, so it settles "does my video show as a still image there?" without guessing.
+Pass the placement straight from an insights breakdown with --placement (a platform_position value),
+or a Meta ad_format with --ad-format. Run --list-formats to see both sets.
+
+Examples:
+  baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD
+  baker ads meta preview --creative-id 6123 --placement facebook_reels_overlay --platform facebook
+  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 (--list-formats to see them)" },
+    placement: {
+      type: "string",
+      description: "platform_position from an insights breakdown (e.g. facebook_reels_overlay) \u2014 resolved to an ad_format"
+    },
+    platform: { type: "string", description: "facebook|instagram \u2014 required for --placement feed, which both report" },
+    "list-formats": { type: "boolean", description: "Print the ad_format values and placement mappings, then exit" },
+    "out-file": { type: "string", description: "Save iframe HTML to this path" },
+    "no-cache": NO_CACHE_ARG
+  },
+  run: async ({ args }) => {
+    if (args["list-formats"]) {
+      writeAdsJson({
+        ok: true,
+        data: {
+          adFormats: VALID_AD_FORMATS,
+          placements: { facebook: FACEBOOK_PREVIEW_FORMATS, instagram: INSTAGRAM_PREVIEW_FORMATS }
+        }
+      });
+      return;
+    }
+    const placement = args.placement;
+    const adFormat = placement ? resolvePlacement(placement, args.platform) : args["ad-format"];
+    if (!adFormat) {
+      failPreviewValidation("pass --ad-format or --placement (see --list-formats)");
+    }
+    if (!VALID_AD_FORMATS.includes(adFormat)) {
+      failPreviewValidation(
+        `Invalid --ad-format "${adFormat}". Meta's ad_format values: ${VALID_AD_FORMATS.join(", ")}. To preview a placement you saw in an insights breakdown, pass --placement <platform_position> instead of guessing a format name.`
+      );
+    }
+    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["no-cache"]) body.skipCache = true;
+    try {
+      const data = await apiPost("/api/ads/meta/preview", body);
+      const html = data.map((d) => d.body).join("\n");
+      const hints = placement ? [
+        `Rendered ${placement} as ad_format ${adFormat}. Open the iframe to SEE it \u2014 Meta does not document what it renders for a creative a placement cannot take, so a preview you looked at is the evidence, and anything you did not look at stays unverified.`
+      ] : [];
+      if (args["out-file"]) {
+        const summary = { ok: true, data: { file: args["out-file"], rows: data.length, adFormat } };
+        writeFileSync(args["out-file"], html, "utf-8");
+        writeJsonEnvelope(hints.length > 0 ? { ...summary, hints } : summary);
+        return;
+      }
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  previewCommand
+};
+//# sourceMappingURL=preview-LRJOQ7LM.js.map

package/dist/preview-LRJOQ7LM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/preview.ts"],"sourcesContent":["import { writeFileSync } from \"node:fs\";\nimport {\n  FACEBOOK_PREVIEW_FORMATS,\n  INSTAGRAM_PREVIEW_FORMATS,\n  PLATFORM_SCOPED_POSITIONS,\n  previewFormatForPosition,\n} from \"@baker/api/ads-meta\";\nimport { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson, writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError } from \"./shared.ts\";\n\n/**\n * The `ad_format` enum of `generatepreviews` as Meta's reference lists it (every value rendered live on v26.0, 2026-10-15)\n * (read 2026-10-14), plus INSTAGRAM_SHOP — dropped from that list yet still\n * rendered live the same day, so a format an older answer named keeps working.\n */\nconst VALID_AD_FORMATS = [\n  \"AUDIENCE_NETWORK_INSTREAM_VIDEO\",\n  \"AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE\",\n  \"AUDIENCE_NETWORK_OUTSTREAM_VIDEO\",\n  \"AUDIENCE_NETWORK_REWARDED_VIDEO\",\n  \"BIZ_DISCO_FEED_MOBILE\",\n  \"DESKTOP_FEED_STANDARD\",\n  \"FACEBOOK_IFU_REELS_MOBILE\",\n  \"FACEBOOK_PROFILE_FEED_DESKTOP\",\n  \"FACEBOOK_PROFILE_FEED_MOBILE\",\n  \"FACEBOOK_PROFILE_REELS_MOBILE\",\n  \"FACEBOOK_REELS_BANNER\",\n  \"FACEBOOK_REELS_BANNER_DESKTOP\",\n  \"FACEBOOK_REELS_BANNER_FEED_ANDROID\",\n  \"FACEBOOK_REELS_BANNER_FEED_ANDROID_LARGE\",\n  \"FACEBOOK_REELS_BANNER_FULLSCREEN_IOS\",\n  \"FACEBOOK_REELS_BANNER_FULLSCREEN_MOBILE\",\n  \"FACEBOOK_REELS_MOBILE\",\n  \"FACEBOOK_REELS_POSTLOOP\",\n  \"FACEBOOK_REELS_POSTLOOP_FEED\",\n  \"FACEBOOK_REELS_SIMILAR_PRODUCTS_MOBILE\",\n  \"FACEBOOK_REELS_STICKER\",\n  \"FACEBOOK_STORY_MOBILE\",\n  \"FACEBOOK_STORY_STICKER_MOBILE\",\n  \"INSTAGRAM_EXPLORE_CONTEXTUAL\",\n  \"INSTAGRAM_EXPLORE_GRID_HOME\",\n  \"INSTAGRAM_EXPLORE_IMMERSIVE\",\n  \"INSTAGRAM_FEED_WEB\",\n  \"INSTAGRAM_FEED_WEB_M_SITE\",\n  \"INSTAGRAM_LEAD_GEN_MULTI_SUBMIT_ADS\",\n  \"INSTAGRAM_PROFILE_FEED\",\n  \"INSTAGRAM_PROFILE_REELS\",\n  \"INSTAGRAM_REELS\",\n  \"INSTAGRAM_REELS_OVERLAY\",\n  \"INSTAGRAM_REELS_WEB\",\n  \"INSTAGRAM_REELS_WEB_M_SITE\",\n  \"INSTAGRAM_SEARCH_CHAIN\",\n  \"INSTAGRAM_SEARCH_GRID\",\n  \"INSTAGRAM_SHOP\",\n  \"INSTAGRAM_STANDARD\",\n  \"INSTAGRAM_STORY\",\n  \"INSTAGRAM_STORY_EFFECT_TRAY\",\n  \"INSTAGRAM_STORY_WEB\",\n  \"INSTAGRAM_STORY_WEB_M_SITE\",\n  \"INSTANT_ARTICLE_RECIRCULATION_AD\",\n  \"INSTANT_ARTICLE_STANDARD\",\n  \"INSTREAM_BANNER_DESKTOP\",\n  \"INSTREAM_BANNER_FEED_IOS\",\n  \"INSTREAM_BANNER_FULLSCREEN_IOS\",\n  \"INSTREAM_BANNER_FULLSCREEN_MOBILE\",\n  \"INSTREAM_BANNER_IMMERSIVE_MOBILE\",\n  \"INSTREAM_BANNER_MOBILE\",\n  \"INSTREAM_VIDEO_DESKTOP\",\n  \"INSTREAM_VIDEO_FULLSCREEN_IOS\",\n  \"INSTREAM_VIDEO_FULLSCREEN_MOBILE\",\n  \"INSTREAM_VIDEO_IMAGE\",\n  \"INSTREAM_VIDEO_IMMERSIVE_MOBILE\",\n  \"INSTREAM_VIDEO_MOBILE\",\n  \"JOB_BROWSER_DESKTOP\",\n  \"JOB_BROWSER_MOBILE\",\n  \"MARKETPLACE_MOBILE\",\n  \"MESSENGER_MOBILE_INBOX_MEDIA\",\n  \"MESSENGER_MOBILE_STORY_MEDIA\",\n  \"MOBILE_BANNER\",\n  \"MOBILE_FEED_BASIC\",\n  \"MOBILE_FEED_STANDARD\",\n  \"MOBILE_FULLWIDTH\",\n  \"MOBILE_INTERSTITIAL\",\n  \"MOBILE_MEDIUM_RECTANGLE\",\n  \"MOBILE_NATIVE\",\n  \"RIGHT_COLUMN_STANDARD\",\n  \"SUGGESTED_VIDEO_DESKTOP\",\n  \"SUGGESTED_VIDEO_FULLSCREEN_MOBILE\",\n  \"SUGGESTED_VIDEO_IMMERSIVE_MOBILE\",\n  \"SUGGESTED_VIDEO_MOBILE\",\n  \"WATCH_FEED_HOME\",\n  \"WATCH_FEED_MOBILE\",\n  \"WHATSAPP_STATUS_MEDIA\",\n];\n\n/** A bad flag is not a network failure — mislabelling it invites a retry of the same doomed call. */\nfunction failPreviewValidation(message: string): never {\n  writeAdsJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\n/**\n * Preview is the free way to see what Meta actually renders for a creative in a\n * given surface — the check that turns \"this placement must be showing a still\"\n * from a claim into an observation. It was being used by guessing format names,\n * so both doors are open now: the Meta `ad_format` enum via `--ad-format`, and\n * the `platform_position` an insights breakdown reports via `--placement`.\n */\nfunction resolvePlacement(position: string, platform: unknown): string {\n  const platformArg = typeof platform === \"string\" ? platform.toLowerCase() : undefined;\n  if (platformArg && platformArg !== \"facebook\" && platformArg !== \"instagram\") {\n    failPreviewValidation(\"--platform must be facebook or instagram\");\n  }\n  const format = previewFormatForPosition(position, platformArg);\n  if (format) {\n    return format;\n  }\n  if (PLATFORM_SCOPED_POSITIONS.has(position) && !platformArg) {\n    failPreviewValidation(\n      `--placement ${position} names a different surface on Facebook and on Instagram — add --platform facebook or --platform instagram (the breakdown row's publisher_platform)`,\n    );\n  }\n  failPreviewValidation(\n    `No Meta preview format is published for placement \"${position}\". Meta does not document one for every placement (facebook_notification among them), so this placement cannot be previewed — report it as unverified rather than inferring what it renders. Pass the platform_position exactly as the insights breakdown spelled it: targeting names a few surfaces differently (story, reels, explore_home) and those names never appear in a breakdown. Previewable placements: ${listPlacements()}`,\n  );\n}\n\nfunction listPlacements(): string {\n  const facebook = Object.keys(FACEBOOK_PREVIEW_FORMATS).join(\", \");\n  const instagram = Object.keys(INSTAGRAM_PREVIEW_FORMATS).join(\", \");\n  return `facebook — ${facebook}; instagram — ${instagram}`;\n}\n\nexport const previewCommand = defineCommand({\n  meta: {\n    name: \"preview\",\n    description: `Generate a Meta-hosted preview iframe for a creative or ad. Returns iframe HTML which you\ncan embed or save to a file. The iframe URL contains a short-lived access token — treat as secret.\n\nStart here when you need to know what a creative looks like in one specific placement — this is\nMeta's own renderer, so it settles \"does my video show as a still image there?\" without guessing.\nPass the placement straight from an insights breakdown with --placement (a platform_position value),\nor a Meta ad_format with --ad-format. Run --list-formats to see both sets.\n\nExamples:\n  baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD\n  baker ads meta preview --creative-id 6123 --placement facebook_reels_overlay --platform facebook\n  baker ads meta preview --ad-id 9988 --ad-format INSTAGRAM_REELS --out-file /tmp/preview.html\n  baker ads meta preview --account-id act_123 --creative '{\"object_story_spec\":{...}}' --ad-format MOBILE_FEED_STANDARD`,\n  },\n  args: {\n    \"creative-id\": { type: \"string\", description: \"Existing creative ID\" },\n    \"ad-id\": { type: \"string\", description: \"Existing ad ID\" },\n    \"account-id\": { type: \"string\", description: \"Required when previewing an unpublished --creative spec\" },\n    creative: { type: \"string\", description: \"JSON spec of an unpublished creative (e.g. object_story_spec)\" },\n    \"ad-format\": { type: \"string\", description: \"Meta ad_format enum value (--list-formats to see them)\" },\n    placement: {\n      type: \"string\",\n      description:\n        \"platform_position from an insights breakdown (e.g. facebook_reels_overlay) — resolved to an ad_format\",\n    },\n    platform: { type: \"string\", description: \"facebook|instagram — required for --placement feed, which both report\" },\n    \"list-formats\": { type: \"boolean\", description: \"Print the ad_format values and placement mappings, then exit\" },\n    \"out-file\": { type: \"string\", description: \"Save iframe HTML to this path\" },\n    \"no-cache\": NO_CACHE_ARG,\n  },\n  run: async ({ args }) => {\n    if (args[\"list-formats\"]) {\n      writeAdsJson({\n        ok: true,\n        data: {\n          adFormats: VALID_AD_FORMATS,\n          placements: { facebook: FACEBOOK_PREVIEW_FORMATS, instagram: INSTAGRAM_PREVIEW_FORMATS },\n        },\n      });\n      return;\n    }\n\n    const placement = args.placement as string | undefined;\n    const adFormat = placement ? resolvePlacement(placement, args.platform) : (args[\"ad-format\"] as string);\n    if (!adFormat) {\n      failPreviewValidation(\"pass --ad-format or --placement (see --list-formats)\");\n    }\n    if (!VALID_AD_FORMATS.includes(adFormat)) {\n      failPreviewValidation(\n        `Invalid --ad-format \"${adFormat}\". Meta's ad_format values: ${VALID_AD_FORMATS.join(\", \")}. To preview a placement you saw in an insights breakdown, pass --placement <platform_position> instead of guessing a format name.`,\n      );\n    }\n    const body: Record<string, unknown> = { adFormat };\n    if (args[\"creative-id\"]) body.creativeId = args[\"creative-id\"];\n    if (args[\"ad-id\"]) body.adId = args[\"ad-id\"];\n    if (args[\"account-id\"]) body.accountId = args[\"account-id\"];\n    if (args.creative) body.creative = args.creative;\n    if (args[\"no-cache\"]) body.skipCache = true;\n\n    try {\n      const data = await apiPost<Array<{ body: string }>>(\"/api/ads/meta/preview\", body);\n      const html = data.map((d) => d.body).join(\"\\n\");\n      const hints = placement\n        ? [\n            `Rendered ${placement} as ad_format ${adFormat}. Open the iframe to SEE it — Meta does not document what it renders for a creative a placement cannot take, so a preview you looked at is the evidence, and anything you did not look at stays unverified.`,\n          ]\n        : [];\n      if (args[\"out-file\"]) {\n        const summary = { ok: true as const, data: { file: args[\"out-file\"], rows: data.length, adFormat } };\n        writeFileSync(args[\"out-file\"] as string, html, \"utf-8\");\n        writeJsonEnvelope(hints.length > 0 ? { ...summary, hints } : summary);\n        return;\n      }\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}