@koda-sl/baker-cli 0.452.0 → 0.453.0-dev.914a088e4

package/dist/plan-4QP2G7GV.js

@@ -1,207 +0,0 @@
-import {
-  TAG_MANAGER_TIMEOUT_MS
-} from "./chunk-DTD2IRDA.js";
-import {
-  funnelStepSchema
-} from "./chunk-237WE5LX.js";
-import {
-  trackingPlanErrorEnvelope
-} from "./chunk-HTW7FTP4.js";
-import "./chunk-D5FY4FAK.js";
-import {
-  ANALYTICS_EVENT_DOORS,
-  parseEventKey
-} from "./chunk-SSJK7FEV.js";
-import "./chunk-EDLZGTGN.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import {
-  getEnv
-} from "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.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-4QP2G7GV.js.map

package/dist/plan-4QP2G7GV.js.map

@@ -1 +0,0 @@
-{"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-AD4GKYIA.js

@@ -1,169 +0,0 @@
-import {
-  FACEBOOK_PREVIEW_FORMATS,
-  INSTAGRAM_PREVIEW_FORMATS,
-  PLATFORM_SCOPED_POSITIONS,
-  previewFormatForPosition
-} from "./chunk-GOJXKIFQ.js";
-import {
-  handleMetaError
-} from "./chunk-KLNKEVIY.js";
-import {
-  writeAdsJson,
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-X7ZODEXJ.js";
-import {
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import "./chunk-NU7JSWVA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/preview.ts
-import { writeFileSync } from "fs";
-import { defineCommand } from "citty";
-var 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_SEARCH_CHAIN",
-  "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"
-];
-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 and facebook_profile_feed 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 publishes no complete ad_format enum, so this is the set we know: ${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-AD4GKYIA.js.map

package/dist/promoted-tweet-writes-QP37NMQC.js

@@ -1,180 +0,0 @@
-import {
-  csvArg,
-  requireTargets,
-  stageAccountId,
-  stageXOp,
-  stageXOps
-} from "./chunk-MM22NUA6.js";
-import "./chunk-M6UNISGO.js";
-import "./chunk-C6U6UDHJ.js";
-import "./chunk-VFIOJD5M.js";
-import {
-  TARGETING_OPERATORS,
-  TARGETING_TYPES
-} from "./chunk-EUFCY63X.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
-import "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/x/promoted-tweet-writes.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "ads.x.promotedTweets.create",
-  description: "Stage promoting one or more existing posts in an X ad group. Takes post (tweet) ids \u2014 the numeric id from the post's URL, not a base36 ads id.",
-  args: {
-    "account-id": { type: "string", description: "X Ads account ID", required: false },
-    "line-item-id": {
-      type: "string",
-      description: "Ad group id, or an x_temp_* ref staged in this draft",
-      required: true
-    },
-    "tweet-ids": { type: "string", description: "CSV of post ids", required: true }
-  }
-});
-var promotedTweetsCreateCommand = defineCommand({
-  meta: {
-    name: "create",
-    description: `Stage promoting posts in an ad group (applies when the chat is published).
-
-Example:
-  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285`
-  },
-  args: {
-    "account-id": { type: "string", description: "X Ads account ID" },
-    "line-item-id": { type: "string", description: "Ad group id or x_temp_* ref", required: true },
-    "tweet-ids": { type: "string", description: "CSV of post ids", required: true }
-  },
-  run: async ({ args }) => {
-    const accountId = await stageAccountId(args);
-    await stageXOp({
-      kind: "promotedTweet.create",
-      accountId,
-      payload: { lineItemId: args["line-item-id"], tweetIds: csvArg(args["tweet-ids"]) ?? [] }
-    });
-  }
-});
-registerSchema({
-  command: "ads.x.promotedTweets.remove",
-  description: "Stage removing one or more promoted posts. X has no pause for these \u2014 removal is the only way to stop one serving, and it cannot be undone (re-promoting creates a new association).",
-  args: {
-    ids: { type: "string", description: "Promoted-post ids, comma-separated", required: true },
-    "account-id": { type: "string", description: "X Ads account ID", required: false }
-  }
-});
-var promotedTweetsRemoveCommand = defineCommand({
-  meta: {
-    name: "remove",
-    description: `Stage removing promoted posts. Cannot be undone.
-
-Example:
-  baker ads x promoted-tweets remove ayyorn,ayyoro`
-  },
-  args: {
-    ids: { type: "positional", description: "Promoted-post ids, comma-separated", required: true },
-    "account-id": { type: "string", description: "X Ads account ID" }
-  },
-  run: async ({ args }) => {
-    const accountId = await stageAccountId(args);
-    await stageXOps(
-      requireTargets(args, "ids").map((id) => ({
-        kind: "promotedTweet.remove",
-        accountId,
-        target: id,
-        payload: {}
-      }))
-    );
-  }
-});
-registerSchema({
-  command: "ads.x.targetingCriteria.create",
-  description: `Stage one targeting criterion on an X ad group. One op per value, because X stores each criterion as its own entity. Look values up first with \`baker ads x targeting-constants\`.
-Types: ${TARGETING_TYPES.join(", ")}. Operators: ${TARGETING_OPERATORS.join(" (include) | ")} (exclude).`,
-  args: {
-    "account-id": { type: "string", description: "X Ads account ID", required: false },
-    "line-item-id": { type: "string", description: "Ad group id, or an x_temp_* ref", required: true },
-    type: { type: "string", description: TARGETING_TYPES.join(" | "), required: true },
-    value: {
-      type: "string",
-      description: "Targeting value \u2014 from `targeting-constants` for the lookup types",
-      required: true
-    },
-    operator: { type: "string", description: "EQ to include (default), NE to exclude", required: false }
-  }
-});
-var targetingCriteriaCreateCommand = defineCommand({
-  meta: {
-    name: "create",
-    description: `Stage one targeting criterion on an ad group.
-
-Examples:
-  baker ads x targeting-criteria create --line-item-id wiee9 --type LOCATION --value 96683cc9126741d1
-  baker ads x targeting-criteria create --line-item-id wiee9 --type INTEREST --value 25 --operator NE`
-  },
-  args: {
-    "account-id": { type: "string", description: "X Ads account ID" },
-    "line-item-id": { type: "string", description: "Ad group id or x_temp_* ref", required: true },
-    type: { type: "string", description: TARGETING_TYPES.join(" | "), required: true },
-    value: { type: "string", description: "Targeting value", required: true },
-    operator: { type: "string", description: "EQ (include) | NE (exclude)" }
-  },
-  run: async ({ args }) => {
-    const accountId = await stageAccountId(args);
-    await stageXOp({
-      kind: "targetingCriteria.create",
-      accountId,
-      payload: {
-        lineItemId: args["line-item-id"],
-        targetingType: args.type,
-        targetingValue: args.value,
-        ...args.operator ? { operatorType: args.operator } : {}
-      }
-    });
-  }
-});
-registerSchema({
-  command: "ads.x.targetingCriteria.remove",
-  description: "Stage removing one or more targeting criteria from an X ad group.",
-  args: {
-    ids: { type: "string", description: "Targeting criterion ids, comma-separated", required: true },
-    "account-id": { type: "string", description: "X Ads account ID", required: false }
-  }
-});
-var targetingCriteriaRemoveCommand = defineCommand({
-  meta: {
-    name: "remove",
-    description: `Stage removing targeting criteria.
-
-Example:
-  baker ads x targeting-criteria remove 1dmtken`
-  },
-  args: {
-    ids: { type: "positional", description: "Targeting criterion ids, comma-separated", required: true },
-    "account-id": { type: "string", description: "X Ads account ID" }
-  },
-  run: async ({ args }) => {
-    const accountId = await stageAccountId(args);
-    await stageXOps(
-      requireTargets(args, "ids").map((id) => ({
-        kind: "targetingCriteria.remove",
-        accountId,
-        target: id,
-        payload: {}
-      }))
-    );
-  }
-});
-export {
-  promotedTweetsCreateCommand,
-  promotedTweetsRemoveCommand,
-  targetingCriteriaCreateCommand,
-  targetingCriteriaRemoveCommand
-};
-//# sourceMappingURL=promoted-tweet-writes-QP37NMQC.js.map