@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/pages-NBV35ECG.js

@@ -1,67 +0,0 @@
-import {
-  csvOrJson,
-  handleMetaError
-} from "./chunk-TCSPJQ2X.js";
-import {
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-6YWRJMGR.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-X7ZODEXJ.js";
-import {
-  apiGet
-} from "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import "./chunk-JIHG6K7N.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/pages.ts
-import { defineCommand } from "citty";
-function pageSelectionHints(data) {
-  if (data.length === 0) return [];
-  const accountHint = "Use a Page only with an ad account listed in its promotingAccountIds. hasPageAccessToken must be true to read instant forms; null means Meta could not check it. Form reads also require the company's lead-ads permissions.";
-  if (data.length > 1) {
-    return [
-      accountHint,
-      "MULTIPLE Pages can run ads from the selected Meta ad accounts \u2014 do NOT guess. Confirm with the user which Page an ad should run from before passing --page to `creatives create`; a wrong Page publishes the ad under the wrong brand identity and staging will not catch it."
-    ];
-  }
-  return [accountHint];
-}
-var pagesCommand = defineCommand({
-  meta: {
-    name: "pages",
-    description: `List the Facebook Pages that the selected Meta ad accounts can promote, showing which accounts can promote each Page. Every Meta ad publishes from a Page, so match its promotingAccountIds to the target account. hasPageAccessToken shows whether the connected person can also read that Page's instant forms. If more than one Page is listed, confirm the brand with the user.
-
-Examples:
-  baker ads meta pages`
-  },
-  args: {
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "Output format", default: "json" }
-  },
-  run: async ({ args }) => {
-    try {
-      const params = {};
-      if (args["no-cache"]) params["skip-cache"] = "true";
-      const data = await apiGet("/api/ads/meta/pages", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput(data, fmt);
-        return;
-      }
-      const hints = pageSelectionHints(data);
-      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-export {
-  pageSelectionHints,
-  pagesCommand
-};
-//# sourceMappingURL=pages-NBV35ECG.js.map

package/dist/pages-NBV35ECG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/meta/pages.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport { csvOrJson, handleMetaError } from \"./shared.ts\";\n\n/** Page Meta lists as promotable by a selected ad account. */\nexport interface MetaPage {\n  id: string;\n  name?: string;\n  category?: string;\n  promotingAccountIds: string[];\n  hasPageAccessToken: boolean | null;\n}\n\n/**\n * Guide the agent to the right Page and ad-account pairing.\n */\nexport function pageSelectionHints(data: MetaPage[]): string[] {\n  if (data.length === 0) return [];\n  const accountHint =\n    \"Use a Page only with an ad account listed in its promotingAccountIds. hasPageAccessToken must be true to read instant forms; null means Meta could not check it. Form reads also require the company's lead-ads permissions.\";\n  if (data.length > 1) {\n    return [\n      accountHint,\n      \"MULTIPLE Pages can run ads from the selected Meta ad accounts — do NOT guess. Confirm with the user which Page an ad should run from before passing --page to `creatives create`; a wrong Page publishes the ad under the wrong brand identity and staging will not catch it.\",\n    ];\n  }\n  return [accountHint];\n}\n\nexport const pagesCommand = defineCommand({\n  meta: {\n    name: \"pages\",\n    description: `List the Facebook Pages that the selected Meta ad accounts can promote, showing which accounts can promote each Page. Every Meta ad publishes from a Page, so match its promotingAccountIds to the target account. hasPageAccessToken shows whether the connected person can also read that Page's instant forms. If more than one Page is listed, confirm the brand with the user.\n\nExamples:\n  baker ads meta pages`,\n  },\n  args: {\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"Output format\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = {};\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<MetaPage[]>(\"/api/ads/meta/pages\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      const hints = pageSelectionHints(data);\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAkBvB,SAAS,mBAAmB,MAA4B;AAC7D,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAC/B,QAAM,cACJ;AACF,MAAI,KAAK,SAAS,GAAG;AACnB,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,SAAO,CAAC,WAAW;AACrB;AAEO,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,IACJ,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,iBAAiB,SAAS,OAAO;AAAA,EAC1E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,SAAiC,CAAC;AACxC,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,YAAM,OAAO,MAAM,OAAmB,uBAAuB,MAAM;AACnE,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,MAAmD,GAAG;AACrE;AAAA,MACF;AACA,YAAM,QAAQ,mBAAmB,IAAI;AACrC,wBAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACrF,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/performance-SOMZNPIG.js

@@ -1,25 +0,0 @@
-import {
-  definitionInsights,
-  parseDays,
-  performanceCommand,
-  withDefinitions
-} from "./chunk-CSADPKPC.js";
-import "./chunk-TQAXOBKJ.js";
-import "./chunk-MBKCUSMR.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
-import "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import "./chunk-JIHG6K7N.js";
-import "./chunk-YQSBHWOI.js";
-export {
-  definitionInsights,
-  parseDays,
-  performanceCommand,
-  withDefinitions
-};
-//# sourceMappingURL=performance-SOMZNPIG.js.map

package/dist/pinterest-KXAZTRDP.js

@@ -1,98 +0,0 @@
-import {
-  AUTO_INGEST_MAX,
-  parseAutoIngest
-} from "./chunk-KKJ4KJCW.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import {
-  writeJson
-} from "./chunk-O4AXPEOE.js";
-import {
-  registerSchema
-} from "./chunk-JIHG6K7N.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/images/pinterest.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "images.pinterest",
-  description: "Pinterest image search via ScrapeCreators. Reference-grade real-world photography, product styling, interiors, fashion, food, and aesthetic mood boards. Inspect before placing \u2014 Pinterest is unverified, trademark-bearing web content.",
-  args: {
-    query: { type: "string", description: "Search query", required: true },
-    limit: { type: "number", description: "Max results (1-20, default 5)", required: false, default: 5 },
-    "auto-ingest": {
-      type: "number",
-      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}, default 0) and return Baker-owned URLs on ingested hits`,
-      required: false,
-      default: 0
-    },
-    context: {
-      type: "string",
-      description: "Free-text hint applied to every auto-ingested hit (overrides the pin title)",
-      required: false
-    }
-  }
-});
-var pinterestCommand = defineCommand({
-  meta: {
-    name: "pinterest",
-    description: "Pinterest image search via ScrapeCreators ($0.00188/request). Best for photo-realistic reference imagery \u2014 lifestyle, interiors, fashion, food, product styling, and mood boards to brief AI generation against. \u26A0 Unverified, trademark-bearing web content \u2014 inspect and respect rights before placing on a customer page. Browse first; auto-ingest only the pins you commit to.\n\nExamples:\n  baker images pinterest 'scandinavian living room'\n  baker images pinterest 'minimalist skincare product photography' --limit 20\n  baker images pinterest 'cozy coffee shop interior' --auto-ingest 2 --context 'Mood reference for hero photography'"
-  },
-  args: {
-    query: { type: "positional", description: "Search query", required: false },
-    limit: { type: "string", description: "Max results (1-20)", required: false },
-    "auto-ingest": {
-      type: "string",
-      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}) and return Baker-owned URLs on ingested hits`,
-      required: false
-    },
-    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false }
-  },
-  run: async ({ args }) => {
-    try {
-      const query = args.query;
-      if (!query) {
-        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
-        process.exit(1);
-      }
-      const body = { query };
-      if (args.limit) body.limit = Number(args.limit);
-      if (args["auto-ingest"] !== void 0) {
-        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.pinterest);
-        if (!parsed.ok) {
-          writeJson({
-            ok: false,
-            error: {
-              code: "VALIDATION_ERROR",
-              message: parsed.message,
-              fix: {
-                action: "retry_with_changes",
-                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.pinterest}.`
-              }
-            }
-          });
-          process.exit(1);
-        }
-        body.autoIngest = parsed.value;
-      }
-      if (args.context) body.descriptionContext = args.context;
-      const data = await apiPost("/api/images/pinterest", body);
-      writeJson({ ok: true, data });
-    } catch (err) {
-      if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
-        process.exit(1);
-      }
-      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-      process.exit(1);
-    }
-  }
-});
-export {
-  pinterestCommand
-};
-//# sourceMappingURL=pinterest-KXAZTRDP.js.map

package/dist/pinterest-KXAZTRDP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/images/pinterest.ts"],"sourcesContent":["import type { ImagesPinterestRequest, ImagesPinterestResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { AUTO_INGEST_MAX, parseAutoIngest } from \"./autoIngest.ts\";\n\nregisterSchema({\n  command: \"images.pinterest\",\n  description:\n    \"Pinterest image search via ScrapeCreators. Reference-grade real-world photography, product styling, interiors, fashion, food, and aesthetic mood boards. Inspect before placing — Pinterest is unverified, trademark-bearing web content.\",\n  args: {\n    query: { type: \"string\", description: \"Search query\", required: true },\n    limit: { type: \"number\", description: \"Max results (1-20, default 5)\", required: false, default: 5 },\n    \"auto-ingest\": {\n      type: \"number\",\n      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}, default 0) and return Baker-owned URLs on ingested hits`,\n      required: false,\n      default: 0,\n    },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint applied to every auto-ingested hit (overrides the pin title)\",\n      required: false,\n    },\n  },\n});\n\nexport const pinterestCommand = defineCommand({\n  meta: {\n    name: \"pinterest\",\n    description:\n      \"Pinterest image search via ScrapeCreators ($0.00188/request). Best for photo-realistic reference imagery — lifestyle, interiors, fashion, food, product styling, and mood boards to brief AI generation against. ⚠ Unverified, trademark-bearing web content — inspect and respect rights before placing on a customer page. Browse first; auto-ingest only the pins you commit to.\\n\\nExamples:\\n  baker images pinterest 'scandinavian living room'\\n  baker images pinterest 'minimalist skincare product photography' --limit 20\\n  baker images pinterest 'cozy coffee shop interior' --auto-ingest 2 --context 'Mood reference for hero photography'\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query\", required: false },\n    limit: { type: \"string\", description: \"Max results (1-20)\", required: false },\n    \"auto-ingest\": {\n      type: \"string\",\n      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}) and return Baker-owned URLs on ingested hits`,\n      required: false,\n    },\n    context: { type: \"string\", description: \"Description context hint applied to auto-ingested hits\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Query is required\" } });\n        process.exit(1);\n      }\n      const body: ImagesPinterestRequest = { query };\n      if (args.limit) body.limit = Number(args.limit);\n      if (args[\"auto-ingest\"] !== undefined) {\n        const parsed = parseAutoIngest(args[\"auto-ingest\"], AUTO_INGEST_MAX.pinterest);\n        if (!parsed.ok) {\n          writeJson({\n            ok: false,\n            error: {\n              code: \"VALIDATION_ERROR\",\n              message: parsed.message,\n              fix: {\n                action: \"retry_with_changes\",\n                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.pinterest}.`,\n              },\n            },\n          });\n          process.exit(1);\n        }\n        body.autoIngest = parsed.value;\n      }\n      if (args.context) body.descriptionContext = args.context as string;\n\n      const data = await apiPost<ImagesPinterestResponse>(\"/api/images/pinterest\", body);\n      writeJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,UAAU,aAAa,gBAAgB,UAAU,KAAK;AAAA,IACrE,OAAO,EAAE,MAAM,UAAU,aAAa,iCAAiC,UAAU,OAAO,SAAS,EAAE;AAAA,IACnG,eAAe;AAAA,MACb,MAAM;AAAA,MACN,aAAa,wBAAwB,gBAAgB,SAAS;AAAA,MAC9D,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAEM,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,cAAc,aAAa,gBAAgB,UAAU,MAAM;AAAA,IAC1E,OAAO,EAAE,MAAM,UAAU,aAAa,sBAAsB,UAAU,MAAM;AAAA,IAC5E,eAAe;AAAA,MACb,MAAM;AAAA,MACN,aAAa,wBAAwB,gBAAgB,SAAS;AAAA,MAC9D,UAAU;AAAA,IACZ;AAAA,IACA,SAAS,EAAE,MAAM,UAAU,aAAa,0DAA0D,UAAU,MAAM;AAAA,EACpH;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,QAAQ,KAAK;AACnB,UAAI,CAAC,OAAO;AACV,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,oBAAoB,EAAE,CAAC;AAC1F,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,YAAM,OAA+B,EAAE,MAAM;AAC7C,UAAI,KAAK,MAAO,MAAK,QAAQ,OAAO,KAAK,KAAK;AAC9C,UAAI,KAAK,aAAa,MAAM,QAAW;AACrC,cAAM,SAAS,gBAAgB,KAAK,aAAa,GAAG,gBAAgB,SAAS;AAC7E,YAAI,CAAC,OAAO,IAAI;AACd,oBAAU;AAAA,YACR,IAAI;AAAA,YACJ,OAAO;AAAA,cACL,MAAM;AAAA,cACN,SAAS,OAAO;AAAA,cAChB,KAAK;AAAA,gBACH,QAAQ;AAAA,gBACR,aAAa,kCAAkC,gBAAgB,SAAS;AAAA,cAC1E;AAAA,YACF;AAAA,UACF,CAAC;AACD,kBAAQ,KAAK,CAAC;AAAA,QAChB;AACA,aAAK,aAAa,OAAO;AAAA,MAC3B;AACA,UAAI,KAAK,QAAS,MAAK,qBAAqB,KAAK;AAEjD,YAAM,OAAO,MAAM,QAAiC,yBAAyB,IAAI;AACjF,gBAAU,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IAC9B,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/pixels-DYWHXAJT.js

@@ -1,109 +0,0 @@
-import {
-  csvOrJson,
-  daysAgoIso,
-  handleMetaError,
-  resolveAccountIdArg,
-  todayIso
-} from "./chunk-TCSPJQ2X.js";
-import {
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-6YWRJMGR.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-X7ZODEXJ.js";
-import {
-  apiGet
-} from "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import "./chunk-JIHG6K7N.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/pixels.ts
-import { defineCommand } from "citty";
-var 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)" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "Output format", default: "json" }
-  },
-  run: async ({ args }) => {
-    try {
-      if (args.stats) {
-        await runStats(args);
-        return;
-      }
-      await runList(args);
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-async function runStats(args) {
-  const pixelId = args["pixel-id"];
-  if (!pixelId) {
-    handleMetaError(new Error("--pixel-id is required when --stats is set"));
-  }
-  const days = args.days ? Number(args.days) : 7;
-  if (!Number.isInteger(days) || days <= 0 || days > 90) {
-    handleMetaError(new Error("--days must be a positive integer \u2264 90"));
-  }
-  const params = {
-    "pixel-id": pixelId,
-    aggregation: args.aggregation ?? "event",
-    "start-time": daysAgoIso(days),
-    "end-time": todayIso()
-  };
-  if (args["no-cache"]) params["skip-cache"] = "true";
-  const data = await apiGet("/api/ads/meta/pixel-stats", params);
-  emit(data, args);
-}
-async function runList(args) {
-  const accountId = resolveAccountIdArg(args);
-  const params = { "account-id": accountId };
-  if (args["no-cache"]) params["skip-cache"] = "true";
-  const { pixels, restrictedFields } = await apiGet("/api/ads/meta/pixels", params);
-  emit(pixels, args, pixelWarnings(restrictedFields));
-}
-function pixelWarnings(restrictedFields) {
-  if (restrictedFields.length === 0) {
-    return [];
-  }
-  return [
-    {
-      code: "PIXEL_FIELDS_RESTRICTED",
-      message: `Meta withheld ${restrictedFields.join(", ")} for these pixels \u2014 the connected user holds no role in the Business that owns them. IDs, names, creation and last-fired times are complete; install code and setup details are not. To get them, the client assigns the pixel to the connected user in Meta Business settings \u2192 Data sources \u2192 Datasets.`
-    }
-  ];
-}
-function emit(data, args, warnings = []) {
-  const fmt = csvOrJson(args);
-  if (fmt !== "json") {
-    writeAdsOutput(data, fmt);
-    return;
-  }
-  writeAdsJson({ ok: true, data, ...warnings.length > 0 ? { warnings } : {} });
-}
-export {
-  pixelWarnings,
-  pixelsCommand
-};
-//# sourceMappingURL=pixels-DYWHXAJT.js.map

package/dist/pixels-DYWHXAJT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/meta/pixels.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport type { AdsWarning } from \"../types.ts\";\nimport { csvOrJson, daysAgoIso, handleMetaError, resolveAccountIdArg, todayIso } from \"./shared.ts\";\n\nexport const pixelsCommand = defineCommand({\n  meta: {\n    name: \"pixels\",\n    description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.\n\nExamples:\n  baker ads meta pixels --account-id act_123\n  baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n    \"pixel-id\": { type: \"string\", description: \"Pixel ID for --stats\" },\n    stats: { type: \"boolean\", description: \"Fetch firing stats for the pixel\" },\n    aggregation: {\n      type: \"string\",\n      description: \"stats aggregation: event|browser_type|host|pixel_fire\",\n      default: \"event\",\n    },\n    days: { type: \"string\", description: \"Lookback days for --stats (default 7)\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"Output format\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    try {\n      if (args.stats) {\n        await runStats(args);\n        return;\n      }\n      await runList(args);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nasync function runStats(args: Record<string, unknown>): Promise<void> {\n  const pixelId = args[\"pixel-id\"] as string | undefined;\n  if (!pixelId) {\n    handleMetaError(new Error(\"--pixel-id is required when --stats is set\"));\n  }\n  const days = args.days ? Number(args.days) : 7;\n  if (!Number.isInteger(days) || days <= 0 || days > 90) {\n    handleMetaError(new Error(\"--days must be a positive integer ≤ 90\"));\n  }\n  const params: Record<string, string> = {\n    \"pixel-id\": pixelId,\n    aggregation: (args.aggregation as string) ?? \"event\",\n    \"start-time\": daysAgoIso(days),\n    \"end-time\": todayIso(),\n  };\n  if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n  const data = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/pixel-stats\", params);\n  emit(data, args);\n}\n\nasync function runList(args: Record<string, unknown>): Promise<void> {\n  const accountId = resolveAccountIdArg(args);\n  const params: Record<string, string> = { \"account-id\": accountId };\n  if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n  const { pixels, restrictedFields } = await apiGet<{\n    pixels: Array<Record<string, unknown>>;\n    restrictedFields: string[];\n  }>(\"/api/ads/meta/pixels\", params);\n  emit(pixels, args, pixelWarnings(restrictedFields));\n}\n\n/**\n * A listing Meta trimmed is still a listing — IDs, names and firing times are\n * complete. Say which setup fields are missing and how to get them, so the gap\n * reads as a client-side access grant rather than as a pixel that isn't there.\n */\nexport function pixelWarnings(restrictedFields: string[]): AdsWarning[] {\n  if (restrictedFields.length === 0) {\n    return [];\n  }\n  return [\n    {\n      code: \"PIXEL_FIELDS_RESTRICTED\",\n      message:\n        `Meta withheld ${restrictedFields.join(\", \")} for these pixels — the connected user holds no role in the Business that owns them. ` +\n        \"IDs, names, creation and last-fired times are complete; install code and setup details are not. \" +\n        \"To get them, the client assigns the pixel to the connected user in Meta Business settings → Data sources → Datasets.\",\n    },\n  ];\n}\n\nfunction emit(data: Array<Record<string, unknown>>, args: Record<string, unknown>, warnings: AdsWarning[] = []): void {\n  const fmt = csvOrJson(args);\n  if (fmt !== \"json\") {\n    writeAdsOutput(data, fmt);\n    return;\n  }\n  writeAdsJson({ ok: true, data, ...(warnings.length > 0 ? { warnings } : {}) });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAOvB,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,qBAAqB;AAAA,IAClE,YAAY,EAAE,MAAM,UAAU,aAAa,uBAAuB;AAAA,IAClE,OAAO,EAAE,MAAM,WAAW,aAAa,mCAAmC;AAAA,IAC1E,aAAa;AAAA,MACX,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA,MAAM,EAAE,MAAM,UAAU,aAAa,wCAAwC;AAAA,IAC7E,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,iBAAiB,SAAS,OAAO;AAAA,EAC1E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,UAAI,KAAK,OAAO;AACd,cAAM,SAAS,IAAI;AACnB;AAAA,MACF;AACA,YAAM,QAAQ,IAAI;AAAA,IACpB,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAED,eAAe,SAAS,MAA8C;AACpE,QAAM,UAAU,KAAK,UAAU;AAC/B,MAAI,CAAC,SAAS;AACZ,oBAAgB,IAAI,MAAM,4CAA4C,CAAC;AAAA,EACzE;AACA,QAAM,OAAO,KAAK,OAAO,OAAO,KAAK,IAAI,IAAI;AAC7C,MAAI,CAAC,OAAO,UAAU,IAAI,KAAK,QAAQ,KAAK,OAAO,IAAI;AACrD,oBAAgB,IAAI,MAAM,6CAAwC,CAAC;AAAA,EACrE;AACA,QAAM,SAAiC;AAAA,IACrC,YAAY;AAAA,IACZ,aAAc,KAAK,eAA0B;AAAA,IAC7C,cAAc,WAAW,IAAI;AAAA,IAC7B,YAAY,SAAS;AAAA,EACvB;AACA,MAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,QAAM,OAAO,MAAM,OAAuC,6BAA6B,MAAM;AAC7F,OAAK,MAAM,IAAI;AACjB;AAEA,eAAe,QAAQ,MAA8C;AACnE,QAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,MAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,QAAM,EAAE,QAAQ,iBAAiB,IAAI,MAAM,OAGxC,wBAAwB,MAAM;AACjC,OAAK,QAAQ,MAAM,cAAc,gBAAgB,CAAC;AACpD;AAOO,SAAS,cAAc,kBAA0C;AACtE,MAAI,iBAAiB,WAAW,GAAG;AACjC,WAAO,CAAC;AAAA,EACV;AACA,SAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,SACE,iBAAiB,iBAAiB,KAAK,IAAI,CAAC;AAAA,IAGhD;AAAA,EACF;AACF;AAEA,SAAS,KAAK,MAAsC,MAA+B,WAAyB,CAAC,GAAS;AACpH,QAAM,MAAM,UAAU,IAAI;AAC1B,MAAI,QAAQ,QAAQ;AAClB,mBAAe,MAAM,GAAG;AACxB;AAAA,EACF;AACA,eAAa,EAAE,IAAI,MAAM,MAAM,GAAI,SAAS,SAAS,IAAI,EAAE,SAAS,IAAI,CAAC,EAAG,CAAC;AAC/E;","names":[]}

package/dist/pixels-UMS2QBUG.js

@@ -1,61 +0,0 @@
-import {
-  schemaArgs,
-  stageChatgptOp
-} from "./chunk-NGT6MARJ.js";
-import {
-  CHATGPT_ADS_REFERENCE
-} from "./chunk-4VKV3DNC.js";
-import "./chunk-6YWRJMGR.js";
-import "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import {
-  registerSchema
-} from "./chunk-JIHG6K7N.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-UMS2QBUG.js.map

package/dist/pixels-UMS2QBUG.js.map

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

@@ -1,170 +0,0 @@
-import {
-  FACEBOOK_PREVIEW_FORMATS,
-  INSTAGRAM_PREVIEW_FORMATS,
-  PLATFORM_SCOPED_POSITIONS,
-  previewFormatForPosition
-} from "./chunk-GOJXKIFQ.js";
-import {
-  handleMetaError
-} from "./chunk-TCSPJQ2X.js";
-import {
-  writeAdsJson,
-  writeJsonEnvelope
-} from "./chunk-6YWRJMGR.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-X7ZODEXJ.js";
-import {
-  apiPost
-} from "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import "./chunk-JIHG6K7N.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-C5FER5SU.js.map

package/dist/preview-C5FER5SU.js.map

@@ -1 +0,0 @@
-{"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\nconst VALID_AD_FORMATS = [\n  \"DESKTOP_FEED_STANDARD\",\n  \"MOBILE_FEED_STANDARD\",\n  \"MOBILE_FEED_BASIC\",\n  \"RIGHT_COLUMN_STANDARD\",\n  \"MOBILE_FULLWIDTH\",\n  \"MOBILE_INTERSTITIAL\",\n  \"MOBILE_BANNER\",\n  \"MOBILE_MEDIUM_RECTANGLE\",\n  \"MOBILE_NATIVE\",\n  \"FACEBOOK_STORY_MOBILE\",\n  \"FACEBOOK_REELS_MOBILE\",\n  \"INSTAGRAM_STORY\",\n  \"INSTAGRAM_REELS\",\n  \"INSTAGRAM_REELS_OVERLAY\",\n  \"INSTAGRAM_STANDARD\",\n  \"INSTAGRAM_EXPLORE_CONTEXTUAL\",\n  \"INSTAGRAM_EXPLORE_GRID_HOME\",\n  \"INSTAGRAM_SEARCH_CHAIN\",\n  \"INSTAGRAM_SHOP\",\n  \"INSTAGRAM_PROFILE_FEED\",\n  \"INSTREAM_VIDEO_DESKTOP\",\n  \"INSTREAM_VIDEO_MOBILE\",\n  \"FACEBOOK_REELS_BANNER\",\n  \"FACEBOOK_REELS_STICKER\",\n  \"MESSENGER_MOBILE_INBOX_MEDIA\",\n  \"MESSENGER_MOBILE_STORY_MEDIA\",\n  \"AUDIENCE_NETWORK_OUTSTREAM_VIDEO\",\n  \"AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE\",\n  \"AUDIENCE_NETWORK_REWARDED_VIDEO\",\n  \"INSTANT_ARTICLE_STANDARD\",\n  \"MARKETPLACE_MOBILE\",\n  \"BIZ_DISCO_FEED_MOBILE\",\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 and facebook_profile_feed 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 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.`,\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":[]}