@koda-sl/baker-cli 0.869.0-dev.0631d8a3c → 0.869.0-dev.49bba5255

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +2 -3
  2. package/dist/{ads-VSU53JN3.js → ads-CEF5MSJ6.js} +5 -5
  3. package/dist/{analytics-EM4NNEG5.js → analytics-3IS4CCFL.js} +26 -14
  4. package/dist/analytics-3IS4CCFL.js.map +1 -0
  5. package/dist/{chunk-7YHMZVKM.js → chunk-6SMIAFH2.js} +2 -2
  6. package/dist/{chunk-T7GAC2WG.js → chunk-7JM5OH6I.js} +32 -3
  7. package/dist/chunk-7JM5OH6I.js.map +1 -0
  8. package/dist/{chunk-XFTN3ARP.js → chunk-BPIHAIWB.js} +13 -22
  9. package/dist/chunk-BPIHAIWB.js.map +1 -0
  10. package/dist/{chunk-4YQ46MM4.js → chunk-E5US4SNS.js} +2 -2
  11. package/dist/{chunk-HORX3JLB.js → chunk-KFFAH3TX.js} +2 -2
  12. package/dist/{chunk-LMVSHRIS.js → chunk-VMZ2XBU7.js} +2 -2
  13. package/dist/{chunk-EVNRBJML.js → chunk-VT4GYO3E.js} +3 -3
  14. package/dist/cli.js +3 -3
  15. package/dist/{funnel-BFVSY5A6.js → funnel-G4JVDQUE.js} +3 -3
  16. package/dist/{google-HHKFDH7I.js → google-ZFRRYSFZ.js} +2 -2
  17. package/dist/{linkedin-RMZMQ2ZA.js → linkedin-EBOTX37R.js} +4 -8
  18. package/dist/{linkedin-RMZMQ2ZA.js.map → linkedin-EBOTX37R.js.map} +1 -1
  19. package/dist/{lookup-NWIDMQ5B.js → lookup-P5NID3LV.js} +4 -4
  20. package/dist/{meta-HOFABFAK.js → meta-SPPSYRMC.js} +2 -2
  21. package/dist/{performance-Y2S5FDGI.js → performance-L44CGNTO.js} +2 -2
  22. package/dist/{plan-F3LGGPUT.js → plan-OTRYXYVC.js} +3 -3
  23. package/dist/{preview-XXQ5AHXP.js → preview-4GUQGDBD.js} +42 -134
  24. package/dist/preview-4GUQGDBD.js.map +1 -0
  25. package/dist/preview-HD3QAR53.js +104 -0
  26. package/dist/preview-HD3QAR53.js.map +1 -0
  27. package/dist/{questionnaire-XRQKZDTC.js → questionnaire-AFTRG3QM.js} +3 -3
  28. package/dist/{sends-KAFVQSQQ.js → sends-V4MRXQSO.js} +3 -3
  29. package/dist/{sources-FPWA4AJN.js → sources-OTOVMOJ5.js} +4 -4
  30. package/dist/{unstage-FLZFPQ36.js → unstage-E32YHRML.js} +3 -3
  31. package/dist/{url-options-BANFHIHH.js → url-options-ETN75DT5.js} +2 -2
  32. package/package.json +1 -1
  33. package/dist/analytics-EM4NNEG5.js.map +0 -1
  34. package/dist/chunk-T7GAC2WG.js.map +0 -1
  35. package/dist/chunk-XFTN3ARP.js.map +0 -1
  36. package/dist/preview-4DDR337D.js +0 -151
  37. package/dist/preview-4DDR337D.js.map +0 -1
  38. package/dist/preview-XXQ5AHXP.js.map +0 -1
  39. /package/dist/{ads-VSU53JN3.js.map → ads-CEF5MSJ6.js.map} +0 -0
  40. /package/dist/{chunk-7YHMZVKM.js.map → chunk-6SMIAFH2.js.map} +0 -0
  41. /package/dist/{chunk-4YQ46MM4.js.map → chunk-E5US4SNS.js.map} +0 -0
  42. /package/dist/{chunk-HORX3JLB.js.map → chunk-KFFAH3TX.js.map} +0 -0
  43. /package/dist/{chunk-LMVSHRIS.js.map → chunk-VMZ2XBU7.js.map} +0 -0
  44. /package/dist/{chunk-EVNRBJML.js.map → chunk-VT4GYO3E.js.map} +0 -0
  45. /package/dist/{funnel-BFVSY5A6.js.map → funnel-G4JVDQUE.js.map} +0 -0
  46. /package/dist/{google-HHKFDH7I.js.map → google-ZFRRYSFZ.js.map} +0 -0
  47. /package/dist/{lookup-NWIDMQ5B.js.map → lookup-P5NID3LV.js.map} +0 -0
  48. /package/dist/{meta-HOFABFAK.js.map → meta-SPPSYRMC.js.map} +0 -0
  49. /package/dist/{performance-Y2S5FDGI.js.map → performance-L44CGNTO.js.map} +0 -0
  50. /package/dist/{plan-F3LGGPUT.js.map → plan-OTRYXYVC.js.map} +0 -0
  51. /package/dist/{questionnaire-XRQKZDTC.js.map → questionnaire-AFTRG3QM.js.map} +0 -0
  52. /package/dist/{sends-KAFVQSQQ.js.map → sends-V4MRXQSO.js.map} +0 -0
  53. /package/dist/{sources-FPWA4AJN.js.map → sources-OTOVMOJ5.js.map} +0 -0
  54. /package/dist/{unstage-FLZFPQ36.js.map → unstage-E32YHRML.js.map} +0 -0
  55. /package/dist/{url-options-BANFHIHH.js.map → url-options-ETN75DT5.js.map} +0 -0
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/ads/ad-preview-images.ts"],"sourcesContent":["import { mkdirSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { launchBrowser } from \"../../engine/landing-library/browser.ts\";\n\n/**\n * Opens a platform's preview iframe and returns what it displays: the text\n * people read (`shownText`) and a picture for questions text cannot answer.\n *\n * The API's fields say what is stored, not what shows. A Session paused seven\n * live ads because a stored headline read like an internal code, with no way to\n * check whether the feed showed it. The rendered text settles that; the picture\n * covers what is not text — words drawn into the artwork, cropping, layout.\n */\n\nexport interface AdPreviewInput {\n placement: string;\n /** Where the platform shows it (LinkedIn FEED, …) when one placement renders on several surfaces. */\n surface?: string;\n html: string;\n /** The picture's file-name prefix: the ad it shows (`meta-6123`, `linkedin-5`). */\n name: string;\n}\n\ntype AdPreviewWhere = { placement: string; surface?: string };\nexport type AdPreviewResult =\n | (AdPreviewWhere & { shownText: string[]; image: string })\n | (AdPreviewWhere & { error: string });\n\n/** Render `html` (a platform iframe): save a PNG at `file`, return the text it displays. */\nexport type DrawPreview = (html: string, file: string) => Promise<{ text: string }>;\n\nexport const AD_PREVIEW_DIR = join(tmpdir(), \"baker-ad-previews\");\n\n/**\n * The same folder as a sentence, for an arg description.\n *\n * `AD_PREVIEW_DIR` itself must never reach one: it is `tmpdir()` RESOLVED, which is\n * `/tmp/baker-ad-previews` on Linux and `/var/folders/<random>/T/baker-ad-previews` on a Mac — so\n * `catalog:export` wrote whichever machine ran it into `cli-catalog/families/ads-meta.json`, and\n * `catalog.test.ts` then failed for everyone else. The catalog is committed, so a description in it\n * has to be the same on every machine.\n */\nexport const AD_PREVIEW_DIR_LABEL = \"your system temp folder, under baker-ad-previews\";\n\n/** Pictures drawn at once. Each opens its own Chromium, so a long list must not open one per preview. */\nconst DRAW_CONCURRENCY = 4;\n\nexport async function renderAdPreviews(\n inputs: readonly AdPreviewInput[],\n dir: string,\n draw: DrawPreview = drawPreviewInChromium,\n): Promise<{ previews: AdPreviewResult[]; hints: string[] }> {\n mkdirSync(dir, { recursive: true });\n const taken = new Map<string, number>();\n const jobs = inputs.map((input) => {\n const where: AdPreviewWhere = input.surface\n ? { placement: input.placement, surface: input.surface }\n : { placement: input.placement };\n // One file per rendering: a shared name would leave two results pointing at the last picture drawn.\n const base = [input.name, input.placement, input.surface?.toLowerCase()].filter(Boolean).join(\"-\");\n const seen = (taken.get(base) ?? 0) + 1;\n taken.set(base, seen);\n return { where, html: input.html, file: join(dir, `${seen > 1 ? `${base}-${seen}` : base}.png`) };\n });\n const previews: AdPreviewResult[] = new Array(jobs.length);\n let next = 0;\n const worker = async (): Promise<void> => {\n while (next < jobs.length) {\n const index = next++;\n const { where, html, file } = jobs[index] as (typeof jobs)[number];\n try {\n const { text } = await draw(html, file);\n previews[index] = { ...where, shownText: shownLines(text), image: file };\n } catch (err) {\n previews[index] = { ...where, error: err instanceof Error ? err.message : String(err) };\n }\n }\n };\n await Promise.all(Array.from({ length: Math.min(DRAW_CONCURRENCY, jobs.length) }, worker));\n return { previews, hints: previewHints(previews) };\n}\n\nfunction shownLines(text: string): string[] {\n return text\n .split(\"\\n\")\n .map((line) => line.replace(/\\s+/g, \" \").trim())\n .filter(Boolean);\n}\n\nfunction previewHints(previews: readonly AdPreviewResult[]): string[] {\n const hints: string[] = [];\n if (previews.some((p) => \"image\" in p)) {\n hints.push(\n \"shownText is what people see on the ad, in order — rendered by the platform itself, so it settles which text is displayed (headline under the image, button, cut-off intro). The API fields only say what is stored. Words drawn into the artwork are not in shownText: Read the image for those, and for cropping or how the ad looks.\",\n );\n }\n if (previews.some((p) => \"error\" in p)) {\n hints.push(\n \"Some previews could not be drawn. Do not describe how those look — say they could not be checked, and carry on with the rest.\",\n );\n }\n return hints;\n}\n\n/**\n * The platforms' iframes have a fixed window (Meta's 335×450) and scroll the rest,\n * which cuts the headline and button off a picture. The frame is grown to its\n * content's height first, so the picture holds the whole ad.\n */\nexport async function drawPreviewInChromium(html: string, file: string): Promise<{ text: string }> {\n const browser = await launchBrowser();\n try {\n const context = await browser.newContext({ viewport: { width: 900, height: 1200 }, deviceScaleFactor: 2 });\n const page = await context.newPage();\n await page.setContent(`<!doctype html><body style=\"margin:0;background:#fff\">${html}</body>`, {\n waitUntil: \"load\",\n timeout: 30_000,\n });\n await page.waitForLoadState(\"networkidle\", { timeout: 15_000 }).catch(() => undefined);\n const iframe = await page.$(\"iframe\");\n if (!iframe) throw new Error(\"the platform returned no preview frame\");\n const frame = await iframe.contentFrame();\n if (frame) {\n const height = await frame.evaluate(() =>\n Math.max(document.documentElement.scrollHeight, document.body?.scrollHeight ?? 0),\n );\n if (height > 0) {\n await iframe.evaluate((node, h) => {\n node.removeAttribute(\"height\");\n (node as HTMLElement).style.height = `${h}px`;\n }, height);\n await frame.waitForLoadState(\"networkidle\", { timeout: 10_000 }).catch(() => undefined);\n }\n }\n await iframe.screenshot({ path: file });\n // innerText follows the layout: hidden elements drop out, line breaks stay.\n const text = frame ? await frame.evaluate(() => document.body?.innerText ?? \"\") : \"\";\n return { text };\n } finally {\n await browser.close();\n }\n}\n"],"mappings":"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","names":[]}
@@ -1,151 +0,0 @@
1
- import {
2
- handleLinkedinError,
3
- resolveAccountIdArg
4
- } from "./chunk-SBID6GZZ.js";
5
- import {
6
- AD_PREVIEW_DIR,
7
- AD_PREVIEW_DIR_LABEL,
8
- renderAdPreviews
9
- } from "./chunk-XFTN3ARP.js";
10
- import "./chunk-VN3WDB4O.js";
11
- import {
12
- apiFailure,
13
- eachTarget,
14
- positionalTargets
15
- } from "./chunk-EMW6TSSB.js";
16
- import {
17
- writeJsonEnvelope
18
- } from "./chunk-NX4EB2TK.js";
19
- import "./chunk-JGXB7NBP.js";
20
- import "./chunk-RJHGIRU2.js";
21
- import "./chunk-WCU362Z6.js";
22
- import "./chunk-P7YPWBEV.js";
23
- import "./chunk-GIWHHCD6.js";
24
- import "./chunk-PNGXJPM5.js";
25
- import "./chunk-SOPVIIUW.js";
26
- import "./chunk-G4FG5EQO.js";
27
- import "./chunk-CS4VA3GQ.js";
28
- import "./chunk-CVAQZO4I.js";
29
- import {
30
- apiPost
31
- } from "./chunk-EHEPW3O2.js";
32
- import "./chunk-4OF7Q356.js";
33
- import "./chunk-RNSC5JPH.js";
34
- import "./chunk-2RTB2DDO.js";
35
- import "./chunk-YQSBHWOI.js";
36
-
37
- // src/commands/ads/linkedin/preview.ts
38
- import { writeFileSync } from "fs";
39
- import { defineCommand } from "citty";
40
- async function saveAndRender(inputs, args) {
41
- try {
42
- if (args["html-file"]) {
43
- writeFileSync(String(args["html-file"]), inputs.map((p) => p.html).join("\n"), "utf-8");
44
- }
45
- return await renderAdPreviews(inputs, args["out-dir"] ? String(args["out-dir"]) : AD_PREVIEW_DIR);
46
- } catch (err) {
47
- handleLinkedinError(err);
48
- }
49
- }
50
- var previewCommand = defineCommand({
51
- meta: {
52
- name: "preview",
53
- description: `See existing LinkedIn ads exactly as people see them in the feed \u2014 LinkedIn's own renderer,
54
- for desktop and mobile. Returns shownText (the text displayed, in order) and a picture of each;
55
- Read the picture only for what text cannot tell (words in the artwork, cropping, how it looks).
56
-
57
- Start here before saying anything about how an ad LOOKS (which text shows, whether the headline
58
- appears under the image, what the button says): the API fields say what is stored, the preview
59
- shows what is displayed. Works for single image, carousel, video, event and job ads that already
60
- exist on LinkedIn; staged (unpublished) ads have no preview yet.
61
-
62
- Examples:
63
- baker ads linkedin preview 1611562694 --account-id 503001492
64
- baker ads linkedin preview 1611562694 1611562695 --placement mobile # several ads in one call \u2014 never loop
65
- baker ads linkedin preview 1611562694 --placement mobile
66
- baker ads linkedin preview 1611562694 --out-dir /tmp/review`
67
- },
68
- args: {
69
- id: {
70
- type: "positional",
71
- description: "Creative id or urn:li:sponsoredCreative:N \u2014 several, space- or comma-separated, in one call",
72
- required: true
73
- },
74
- "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
75
- "account-urn": { type: "string", description: "Alias for --account-id" },
76
- placement: { type: "string", description: "desktop|mobile|both (default: both)", default: "both" },
77
- "out-dir": { type: "string", description: `Folder for the pictures (default: ${AD_PREVIEW_DIR_LABEL})` },
78
- "html-file": { type: "string", description: "Also save LinkedIn's raw preview iframes to this file" }
79
- },
80
- run: async ({ args }) => {
81
- const accountId = resolveAccountIdArg(args);
82
- const placement = String(args.placement);
83
- if (!["desktop", "mobile", "both"].includes(placement)) {
84
- writeJsonEnvelope({
85
- ok: false,
86
- error: { code: "VALIDATION_ERROR", message: "--placement must be desktop, mobile or both" }
87
- });
88
- process.exit(1);
89
- }
90
- const creativeIds = [...new Set(positionalTargets(args, args.id).flatMap((id) => id.split(",")))].map((id) => id.trim()).filter(Boolean);
91
- const refusals = [];
92
- const fetched = await eachTarget(
93
- creativeIds,
94
- (creativeId) => {
95
- const body = { accountId, creativeId };
96
- return apiPost("/api/ads/linkedin/preview", body);
97
- },
98
- (err) => {
99
- refusals.push(err);
100
- return apiFailure(err);
101
- }
102
- );
103
- if (refusals.length === creativeIds.length) {
104
- handleLinkedinError(refusals[0]);
105
- }
106
- const several = creativeIds.length > 1;
107
- const inputs = [];
108
- const owners = [];
109
- const unchecked = [];
110
- for (const outcome of fetched) {
111
- if (!outcome.ok) {
112
- unchecked.push({ creativeId: outcome.target, error: outcome.error.message });
113
- continue;
114
- }
115
- const wanted = outcome.data.previews.filter((p) => placement === "both" || p.placement === placement);
116
- if (wanted.length === 0) {
117
- unchecked.push({ creativeId: outcome.data.creativeId, error: "LinkedIn returned no preview for this ad" });
118
- }
119
- for (const p of wanted) {
120
- inputs.push({ ...p, name: `linkedin-${outcome.data.creativeId}` });
121
- owners.push(outcome.data.creativeId);
122
- }
123
- }
124
- if (inputs.length === 0 && !several) {
125
- writeJsonEnvelope({
126
- ok: true,
127
- data: { creativeId: creativeIds[0], previews: [] },
128
- hints: [
129
- "LinkedIn returned no preview for this ad (its format may not support one). Say its look could not be checked; do not describe it from the API fields."
130
- ]
131
- });
132
- return;
133
- }
134
- const rendered = await saveAndRender(inputs, args);
135
- const previews = rendered.previews.map((p, i) => several ? { creativeId: owners[i], ...p } : p);
136
- writeJsonEnvelope({
137
- ok: true,
138
- data: several ? { previews: [...previews, ...unchecked] } : { creativeId: owners[0], previews },
139
- hints: [
140
- ...rendered.hints,
141
- ...unchecked.length > 0 ? [
142
- "Some ads have no preview (each says why in its error). Say their look could not be checked; do not describe them from the API fields."
143
- ] : []
144
- ]
145
- });
146
- }
147
- });
148
- export {
149
- previewCommand
150
- };
151
- //# sourceMappingURL=preview-4DDR337D.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/ads/linkedin/preview.ts"],"sourcesContent":["import { writeFileSync } from \"node:fs\";\nimport type { LinkedinAdPreviewRequest, LinkedinAdPreviewResponse } from \"@baker/api/ads-linkedin/preview\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { apiFailure, eachTarget, positionalTargets } from \"../../../lib/batchTargets.ts\";\nimport { AD_PREVIEW_DIR, AD_PREVIEW_DIR_LABEL, type AdPreviewInput, renderAdPreviews } from \"../ad-preview-images.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\n/** Save the raw iframes when asked and draw each preview; a folder or file that cannot be written fails as an envelope. */\nasync function saveAndRender(inputs: AdPreviewInput[], args: { \"html-file\"?: string; \"out-dir\"?: string }) {\n try {\n if (args[\"html-file\"]) {\n writeFileSync(String(args[\"html-file\"]), inputs.map((p) => p.html).join(\"\\n\"), \"utf-8\");\n }\n return await renderAdPreviews(inputs, args[\"out-dir\"] ? String(args[\"out-dir\"]) : AD_PREVIEW_DIR);\n } catch (err) {\n handleLinkedinError(err);\n }\n}\n\nexport const previewCommand = defineCommand({\n meta: {\n name: \"preview\",\n description: `See existing LinkedIn ads exactly as people see them in the feed — LinkedIn's own renderer,\nfor desktop and mobile. Returns shownText (the text displayed, in order) and a picture of each;\nRead the picture only for what text cannot tell (words in the artwork, cropping, how it looks).\n\nStart here before saying anything about how an ad LOOKS (which text shows, whether the headline\nappears under the image, what the button says): the API fields say what is stored, the preview\nshows what is displayed. Works for single image, carousel, video, event and job ads that already\nexist on LinkedIn; staged (unpublished) ads have no preview yet.\n\nExamples:\n baker ads linkedin preview 1611562694 --account-id 503001492\n baker ads linkedin preview 1611562694 1611562695 --placement mobile # several ads in one call — never loop\n baker ads linkedin preview 1611562694 --placement mobile\n baker ads linkedin preview 1611562694 --out-dir /tmp/review`,\n },\n args: {\n id: {\n type: \"positional\",\n description: \"Creative id or urn:li:sponsoredCreative:N — several, space- or comma-separated, in one call\",\n required: true,\n },\n \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n placement: { type: \"string\", description: \"desktop|mobile|both (default: both)\", default: \"both\" },\n \"out-dir\": { type: \"string\", description: `Folder for the pictures (default: ${AD_PREVIEW_DIR_LABEL})` },\n \"html-file\": { type: \"string\", description: \"Also save LinkedIn's raw preview iframes to this file\" },\n },\n run: async ({ args }) => {\n const accountId = resolveAccountIdArg(args);\n const placement = String(args.placement);\n if (![\"desktop\", \"mobile\", \"both\"].includes(placement)) {\n writeJsonEnvelope({\n ok: false,\n error: { code: \"VALIDATION_ERROR\", message: \"--placement must be desktop, mobile or both\" },\n });\n process.exit(1);\n }\n const creativeIds = [...new Set(positionalTargets(args, args.id).flatMap((id) => id.split(\",\")))]\n .map((id) => id.trim())\n .filter(Boolean);\n const refusals: unknown[] = [];\n const fetched = await eachTarget(\n creativeIds,\n (creativeId) => {\n const body: LinkedinAdPreviewRequest = { accountId, creativeId };\n return apiPost<LinkedinAdPreviewResponse>(\"/api/ads/linkedin/preview\", body);\n },\n (err) => {\n refusals.push(err);\n return apiFailure(err);\n },\n );\n if (refusals.length === creativeIds.length) {\n handleLinkedinError(refusals[0]);\n }\n const several = creativeIds.length > 1;\n const inputs: AdPreviewInput[] = [];\n const owners: string[] = [];\n const unchecked: Array<Record<string, unknown>> = [];\n for (const outcome of fetched) {\n if (!outcome.ok) {\n unchecked.push({ creativeId: outcome.target, error: outcome.error.message });\n continue;\n }\n const wanted = outcome.data.previews.filter((p) => placement === \"both\" || p.placement === placement);\n if (wanted.length === 0) {\n unchecked.push({ creativeId: outcome.data.creativeId, error: \"LinkedIn returned no preview for this ad\" });\n }\n for (const p of wanted) {\n inputs.push({ ...p, name: `linkedin-${outcome.data.creativeId}` });\n owners.push(outcome.data.creativeId);\n }\n }\n if (inputs.length === 0 && !several) {\n writeJsonEnvelope({\n ok: true,\n data: { creativeId: creativeIds[0], previews: [] },\n hints: [\n \"LinkedIn returned no preview for this ad (its format may not support one). Say its look could not be checked; do not describe it from the API fields.\",\n ],\n });\n return;\n }\n const rendered = await saveAndRender(inputs, args);\n const previews = rendered.previews.map((p, i) => (several ? { creativeId: owners[i], ...p } : p));\n writeJsonEnvelope({\n ok: true,\n data: several ? { previews: [...previews, ...unchecked] } : { creativeId: owners[0], previews },\n hints: [\n ...rendered.hints,\n ...(unchecked.length > 0\n ? [\n \"Some ads have no preview (each says why in its error). Say their look could not be checked; do not describe them from the API fields.\",\n ]\n : []),\n ],\n });\n },\n});\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/ads/meta/preview.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { 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 { apiFailure, eachTarget } from \"../../../lib/batchTargets.ts\";\nimport { AD_PREVIEW_DIR, AD_PREVIEW_DIR_LABEL, type AdPreviewInput, renderAdPreviews } from \"../ad-preview-images.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\n/** File name for a preview's picture. An unpublished spec has no id, so its content names it. */\nexport function previewFileName(target: { adId?: string; creativeId?: string; creative?: string }): string {\n const id = target.adId ?? target.creativeId;\n if (id) return `meta-${id}`;\n return `meta-draft-${createHash(\"sha256\")\n .update(target.creative ?? \"\")\n .digest(\"hex\")\n .slice(0, 12)}`;\n}\n\n/** Previews one call draws: a creative check across every feed and vertical placement, without a runaway grid. */\nconst MAX_PREVIEWS = 24;\n\n/** A flag's comma list, trimmed, without repeats. */\nfunction listArg(value: unknown): string[] {\n if (typeof value !== \"string\") return [];\n return [...new Set(value.split(\",\").map((item) => item.trim()))].filter(Boolean);\n}\n\ntype PreviewSubject = { creativeId: string } | { adId: string } | { accountId?: string; creative?: string };\n\n/** What to preview: every --creative-id and --ad-id, or else the one unpublished --creative spec. */\nfunction previewSubjects(args: Record<string, unknown>): PreviewSubject[] {\n const subjects: PreviewSubject[] = [\n ...listArg(args[\"creative-id\"]).map((creativeId) => ({ creativeId })),\n ...listArg(args[\"ad-id\"]).map((adId) => ({ adId })),\n ];\n if (subjects.length > 0) return subjects;\n const text = (value: unknown) => (typeof value === \"string\" ? value : undefined);\n return [{ accountId: text(args[\"account-id\"]), creative: text(args.creative) }];\n}\n\n/** The ad_format of every --placement (resolved) or --ad-format asked for, each one Meta publishes. */\nfunction previewFormats(placements: string[], args: Record<string, unknown>): string[] {\n const formats =\n placements.length > 0 ? placements.map((p) => resolvePlacement(p, args.platform)) : listArg(args[\"ad-format\"]);\n if (formats.length === 0) {\n failPreviewValidation(\"pass --ad-format or --placement (see --list-formats)\");\n }\n const invalid = formats.find((adFormat) => !VALID_AD_FORMATS.includes(adFormat));\n if (invalid) {\n failPreviewValidation(\n `Invalid --ad-format \"${invalid}\". 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 return formats;\n}\n\ntype PreviewPair = { subject: PreviewSubject; adFormat: string };\n\n/**\n * Meta's preview for every pair, in parallel. One refusal costs only its own preview;\n * when Meta refuses every one, the command fails the way a single preview always has.\n */\nasync function fetchPreviews(pairs: PreviewPair[], skipCache: boolean) {\n const refusals: unknown[] = [];\n const fetched = await eachTarget(\n pairs.map((_, i) => String(i)),\n (i) => {\n const { subject, adFormat } = pairs[Number(i)] as PreviewPair;\n return apiPost<Array<{ body: string }>>(\"/api/ads/meta/preview\", {\n ...subject,\n adFormat,\n ...(skipCache ? { skipCache: true } : {}),\n });\n },\n (err) => {\n refusals.push(err);\n return apiFailure(err);\n },\n );\n if (refusals.length === pairs.length) {\n handleMetaError(refusals[0]);\n }\n return fetched;\n}\n\n/** What to draw for each pair Meta answered, who it belongs to, and where each refused pair sits among them. */\nfunction previewInputs(pairs: PreviewPair[], fetched: Awaited<ReturnType<typeof fetchPreviews>>, several: boolean) {\n const inputs: AdPreviewInput[] = [];\n const owners: Array<Record<string, string>> = [];\n const refused: Array<{ index: number; entry: Record<string, unknown> }> = [];\n for (const [index, outcome] of fetched.entries()) {\n const { subject, adFormat } = pairs[index] as PreviewPair;\n const owner = several ? subjectId(subject) : {};\n if (!outcome.ok) {\n refused.push({ index: inputs.length, entry: { ...owner, placement: adFormat, error: outcome.error.message } });\n continue;\n }\n if (outcome.data.length === 0) {\n refused.push({\n index: inputs.length,\n entry: { ...owner, placement: adFormat, error: \"Meta returned no preview for this placement\" },\n });\n continue;\n }\n for (const [i, d] of outcome.data.entries()) {\n inputs.push({\n placement: outcome.data.length > 1 ? `${adFormat}-${i + 1}` : adFormat,\n html: d.body,\n name: previewFileName(subject),\n });\n owners.push(owner);\n }\n }\n return { inputs, owners, refused };\n}\n\n/** Which creative or ad a preview shows, when one call previews several. */\nfunction subjectId(subject: PreviewSubject): Record<string, string> {\n if (\"creativeId\" in subject) return { creativeId: subject.creativeId };\n if (\"adId\" in subject) return { adId: subject.adId };\n return {};\n}\n\nexport const previewCommand = defineCommand({\n meta: {\n name: \"preview\",\n description: `See creatives or ads as Meta renders them in one or more placements: shownText (the text people see, in order)\nplus a picture to Read for what text cannot tell (words in the artwork, cropping, how it looks).\n--out-file also saves Meta's raw iframe HTML (its URL holds a short-lived access token — treat as secret).\n\nStart here before saying anything about how an ad LOOKS (which text shows, the headline under the\nimage, the button). Start here too 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.\nTo compare several creatives or placements, pass comma lists in ONE call — never loop the command:\nevery creative × format pair comes back as its own preview, fetched and drawn in parallel (at most ${MAX_PREVIEWS}).\n\nExamples:\n baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD\n baker ads meta preview --creative-id 6123,6124 --ad-format MOBILE_FEED_STANDARD,INSTAGRAM_STORY,INSTAGRAM_REELS\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-dir /tmp/review\n baker ads meta preview --account-id act_123 --creative '{\"object_story_spec\":{...}}' --ad-format MOBILE_FEED_STANDARD`,\n },\n args: {\n \"creative-id\": {\n type: \"string\",\n description: \"Existing creative ID, or several comma-separated: --creative-id 6123,6124\",\n },\n \"ad-id\": { type: \"string\", description: \"Existing ad ID, or several comma-separated: --ad-id 9988,9989\" },\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\": {\n type: \"string\",\n description:\n \"Meta ad_format value, or several comma-separated: --ad-format MOBILE_FEED_STANDARD,INSTAGRAM_REELS (--list-formats to see them)\",\n },\n placement: {\n type: \"string\",\n description:\n \"platform_position from an insights breakdown (e.g. facebook_reels_overlay), or several comma-separated — each 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: \"Also save Meta's iframe HTML to this path\" },\n \"out-dir\": { type: \"string\", description: `Folder for the picture (default: ${AD_PREVIEW_DIR_LABEL})` },\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 placements = listArg(args.placement);\n const formats = previewFormats(placements, args);\n const subjects = previewSubjects(args);\n const pairs = subjects.flatMap((subject) => formats.map((adFormat) => ({ subject, adFormat })));\n if (pairs.length > MAX_PREVIEWS) {\n failPreviewValidation(\n `${subjects.length} ${subjects.length === 1 ? \"creative\" : \"creatives or ads\"} × ${formats.length} formats is ${pairs.length} previews; one call draws at most ${MAX_PREVIEWS}. Split the list.`,\n );\n }\n const fetched = await fetchPreviews(pairs, Boolean(args[\"no-cache\"]));\n\n const { inputs, owners, refused } = previewInputs(pairs, fetched, subjects.length > 1);\n let rendered: Awaited<ReturnType<typeof renderAdPreviews>>;\n try {\n if (args[\"out-file\"]) {\n writeFileSync(args[\"out-file\"] as string, inputs.map((d) => d.html).join(\"\\n\"), \"utf-8\");\n }\n rendered = await renderAdPreviews(inputs, args[\"out-dir\"] ? String(args[\"out-dir\"]) : AD_PREVIEW_DIR);\n } catch (err) {\n handleMetaError(err);\n }\n const previews: Array<Record<string, unknown>> = rendered.previews.map((p, i) => ({ ...owners[i], ...p }));\n for (const { index, entry } of refused.reverse()) previews.splice(index, 0, entry);\n\n const hints = [\n ...placements.map(\n (p, i) =>\n `Rendered ${p} as ad_format ${formats[i]}. Meta does not document what it renders for a creative a placement cannot take, so the picture is the evidence.`,\n ),\n ...rendered.hints,\n ...(refused.length > 0\n ? [\n \"Meta refused or returned nothing for some previews (each says why in its error). Say those could not be checked; the rest are real.\",\n ]\n : []),\n ];\n writeJsonEnvelope({\n ok: true,\n data: {\n ...(formats.length === 1 ? { adFormat: formats[0] } : { adFormats: formats }),\n previews,\n ...(args[\"out-file\"] ? { file: args[\"out-file\"] } : {}),\n },\n hints,\n });\n },\n});\n"],"mappings":"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","names":[]}