@koda-sl/baker-cli 0.868.0-dev.009dcef7a → 0.868.0-dev.0975639e1

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 (78) hide show
  1. package/README.md +3 -2
  2. package/dist/{account-assets-L6BX4YUQ.js → account-assets-W2GJYDRE.js} +6 -6
  3. package/dist/{account-level-OX34JQ7C.js → account-level-N3QDHYOG.js} +4 -4
  4. package/dist/{ads-ZR5D7BZT.js → ads-7PLEAQ4Y.js} +10 -10
  5. package/dist/{ads-66KVUF35.js → ads-IWV53RNM.js} +3 -3
  6. package/dist/{adsets-3NIYL2GQ.js → adsets-KYF344OG.js} +9 -9
  7. package/dist/{asset-writes-5ZKZDPQ4.js → asset-writes-GNDDJZ55.js} +4 -4
  8. package/dist/{audience-writes-NL6NRLLY.js → audience-writes-IO4MHAWC.js} +4 -4
  9. package/dist/{audiences-DL267GNQ.js → audiences-WS4F3HBZ.js} +6 -6
  10. package/dist/{campaigns-RXDC5FSQ.js → campaigns-S5K2CCBC.js} +9 -9
  11. package/dist/{catalogs-QAZ7ZZ5R.js → catalogs-FAINI4WF.js} +3 -3
  12. package/dist/{chunk-3R62EYYX.js → chunk-47SIB7JD.js} +1 -1
  13. package/dist/{chunk-OMJ7DVFJ.js → chunk-6BMO6ZH6.js} +6 -5
  14. package/dist/{chunk-OMJ7DVFJ.js.map → chunk-6BMO6ZH6.js.map} +1 -1
  15. package/dist/{chunk-GED2RAQE.js → chunk-7BRLLCKC.js} +2 -2
  16. package/dist/{chunk-LJO3I2W2.js → chunk-BPIHAIWB.js} +11 -20
  17. package/dist/chunk-BPIHAIWB.js.map +1 -0
  18. package/dist/{chunk-UE5ZFTDL.js → chunk-FYVPXWLZ.js} +2 -2
  19. package/dist/{chunk-EGM42UKF.js → chunk-R7TJKILR.js} +2 -2
  20. package/dist/cli.js +1 -1
  21. package/dist/{copy-writes-QYN6PBU2.js → copy-writes-R3HYTK6I.js} +4 -4
  22. package/dist/{creatives-CPLH3KHQ.js → creatives-L2VSIFDC.js} +4 -4
  23. package/dist/{custom-conversions-CTJVAZKC.js → custom-conversions-NRK47O6Z.js} +4 -4
  24. package/dist/{draft-UU3F2VMJ.js → draft-H744DU5T.js} +203 -8
  25. package/dist/draft-H744DU5T.js.map +1 -0
  26. package/dist/{insights-QU5A4XBO.js → insights-54KZY55Q.js} +2 -2
  27. package/dist/{instant-experiences-EJWYFWDT.js → instant-experiences-Y2F6IWIY.js} +3 -3
  28. package/dist/{leads-FEEWX7OO.js → leads-ZVFKPQK2.js} +3 -3
  29. package/dist/{linkedin-OZGEZLN5.js → linkedin-EBOTX37R.js} +4 -8
  30. package/dist/{linkedin-OZGEZLN5.js.map → linkedin-EBOTX37R.js.map} +1 -1
  31. package/dist/{media-PUOLJUN3.js → media-UMSC6EET.js} +3 -3
  32. package/dist/{meta-C7VHIHDL.js → meta-G7EJ6Q4S.js} +32 -32
  33. package/dist/{page-photos-ZBMJLL5V.js → page-photos-56WZO7EN.js} +3 -3
  34. package/dist/preview-HD3QAR53.js +104 -0
  35. package/dist/preview-HD3QAR53.js.map +1 -0
  36. package/dist/{preview-25YWCQBJ.js → preview-LP3RV2F2.js} +48 -131
  37. package/dist/preview-LP3RV2F2.js.map +1 -0
  38. package/dist/{rule-writes-6XP7G35U.js → rule-writes-KB6RB5GF.js} +4 -4
  39. package/dist/{rules-BRULCGRV.js → rules-M6DKJW3S.js} +7 -7
  40. package/dist/{studies-357M2C2K.js → studies-MUMENEVH.js} +5 -5
  41. package/dist/{study-writes-HXUQRPIK.js → study-writes-5X4ZTRZD.js} +3 -3
  42. package/dist/{targeting-7T7XHBIX.js → targeting-TQ7RYWX2.js} +3 -3
  43. package/dist/{write-commands-4KI6T2NF.js → write-commands-HI3GEWWX.js} +5 -5
  44. package/package.json +1 -1
  45. package/dist/chunk-LJO3I2W2.js.map +0 -1
  46. package/dist/draft-UU3F2VMJ.js.map +0 -1
  47. package/dist/preview-25YWCQBJ.js.map +0 -1
  48. package/dist/preview-TTIHEWK6.js +0 -147
  49. package/dist/preview-TTIHEWK6.js.map +0 -1
  50. /package/dist/{account-assets-L6BX4YUQ.js.map → account-assets-W2GJYDRE.js.map} +0 -0
  51. /package/dist/{account-level-OX34JQ7C.js.map → account-level-N3QDHYOG.js.map} +0 -0
  52. /package/dist/{ads-ZR5D7BZT.js.map → ads-7PLEAQ4Y.js.map} +0 -0
  53. /package/dist/{ads-66KVUF35.js.map → ads-IWV53RNM.js.map} +0 -0
  54. /package/dist/{adsets-3NIYL2GQ.js.map → adsets-KYF344OG.js.map} +0 -0
  55. /package/dist/{asset-writes-5ZKZDPQ4.js.map → asset-writes-GNDDJZ55.js.map} +0 -0
  56. /package/dist/{audience-writes-NL6NRLLY.js.map → audience-writes-IO4MHAWC.js.map} +0 -0
  57. /package/dist/{audiences-DL267GNQ.js.map → audiences-WS4F3HBZ.js.map} +0 -0
  58. /package/dist/{campaigns-RXDC5FSQ.js.map → campaigns-S5K2CCBC.js.map} +0 -0
  59. /package/dist/{catalogs-QAZ7ZZ5R.js.map → catalogs-FAINI4WF.js.map} +0 -0
  60. /package/dist/{chunk-3R62EYYX.js.map → chunk-47SIB7JD.js.map} +0 -0
  61. /package/dist/{chunk-GED2RAQE.js.map → chunk-7BRLLCKC.js.map} +0 -0
  62. /package/dist/{chunk-UE5ZFTDL.js.map → chunk-FYVPXWLZ.js.map} +0 -0
  63. /package/dist/{chunk-EGM42UKF.js.map → chunk-R7TJKILR.js.map} +0 -0
  64. /package/dist/{copy-writes-QYN6PBU2.js.map → copy-writes-R3HYTK6I.js.map} +0 -0
  65. /package/dist/{creatives-CPLH3KHQ.js.map → creatives-L2VSIFDC.js.map} +0 -0
  66. /package/dist/{custom-conversions-CTJVAZKC.js.map → custom-conversions-NRK47O6Z.js.map} +0 -0
  67. /package/dist/{insights-QU5A4XBO.js.map → insights-54KZY55Q.js.map} +0 -0
  68. /package/dist/{instant-experiences-EJWYFWDT.js.map → instant-experiences-Y2F6IWIY.js.map} +0 -0
  69. /package/dist/{leads-FEEWX7OO.js.map → leads-ZVFKPQK2.js.map} +0 -0
  70. /package/dist/{media-PUOLJUN3.js.map → media-UMSC6EET.js.map} +0 -0
  71. /package/dist/{meta-C7VHIHDL.js.map → meta-G7EJ6Q4S.js.map} +0 -0
  72. /package/dist/{page-photos-ZBMJLL5V.js.map → page-photos-56WZO7EN.js.map} +0 -0
  73. /package/dist/{rule-writes-6XP7G35U.js.map → rule-writes-KB6RB5GF.js.map} +0 -0
  74. /package/dist/{rules-BRULCGRV.js.map → rules-M6DKJW3S.js.map} +0 -0
  75. /package/dist/{studies-357M2C2K.js.map → studies-MUMENEVH.js.map} +0 -0
  76. /package/dist/{study-writes-HXUQRPIK.js.map → study-writes-5X4ZTRZD.js.map} +0 -0
  77. /package/dist/{targeting-7T7XHBIX.js.map → targeting-TQ7RYWX2.js.map} +0 -0
  78. /package/dist/{write-commands-4KI6T2NF.js.map → write-commands-HI3GEWWX.js.map} +0 -0
@@ -8,11 +8,11 @@ var metaMediaCommand = defineCommand({
8
8
  description: "Stage Baker library media uploads to Meta so creatives can reference them (upload), or take an image out of the account's image library (delete --image-hash). Upload publishes an ad-image hash or video id a creative binds via --image-ref/--video-ref."
9
9
  },
10
10
  subCommands: {
11
- upload: () => import("./write-commands-4KI6T2NF.js").then((m) => m.mediaUploadCommand),
12
- delete: () => import("./asset-writes-5ZKZDPQ4.js").then((m) => m.mediaDeleteCommand)
11
+ upload: () => import("./write-commands-HI3GEWWX.js").then((m) => m.mediaUploadCommand),
12
+ delete: () => import("./asset-writes-GNDDJZ55.js").then((m) => m.mediaDeleteCommand)
13
13
  }
14
14
  });
15
15
  export {
16
16
  metaMediaCommand
17
17
  };
18
- //# sourceMappingURL=media-PUOLJUN3.js.map
18
+ //# sourceMappingURL=media-UMSC6EET.js.map
@@ -110,43 +110,43 @@ Full guide: __tooling__/docs/tools/baker/ads-meta.md`
110
110
  account: () => import("./account-LHY6YM6L.js").then((m) => m.accountCommand),
111
111
  businesses: () => import("./businesses-RQ6P4DOS.js").then((m) => m.businessesCommand),
112
112
  pages: () => import("./pages-YZC44QR2.js").then((m) => m.pagesCommand),
113
- "lead-forms": () => import("./leads-FEEWX7OO.js").then((m) => m.leadFormsCommand),
114
- "instant-experiences": () => import("./instant-experiences-EJWYFWDT.js").then((m) => m.instantExperiencesCommand),
115
- leads: () => import("./leads-FEEWX7OO.js").then((m) => m.leadsCommand),
116
- campaigns: () => import("./campaigns-RXDC5FSQ.js").then((m) => m.campaignsCommand),
117
- adsets: () => import("./adsets-3NIYL2GQ.js").then((m) => m.adsetsCommand),
118
- ads: () => import("./ads-ZR5D7BZT.js").then((m) => m.adsListCommand),
119
- creatives: () => import("./creatives-CPLH3KHQ.js").then((m) => m.creativesCommand),
120
- audiences: () => import("./audiences-DL267GNQ.js").then((m) => m.audiencesCommand),
121
- "custom-conversions": () => import("./custom-conversions-CTJVAZKC.js").then((m) => m.customConversionsCommand),
113
+ "lead-forms": () => import("./leads-ZVFKPQK2.js").then((m) => m.leadFormsCommand),
114
+ "instant-experiences": () => import("./instant-experiences-Y2F6IWIY.js").then((m) => m.instantExperiencesCommand),
115
+ leads: () => import("./leads-ZVFKPQK2.js").then((m) => m.leadsCommand),
116
+ campaigns: () => import("./campaigns-S5K2CCBC.js").then((m) => m.campaignsCommand),
117
+ adsets: () => import("./adsets-KYF344OG.js").then((m) => m.adsetsCommand),
118
+ ads: () => import("./ads-7PLEAQ4Y.js").then((m) => m.adsListCommand),
119
+ creatives: () => import("./creatives-L2VSIFDC.js").then((m) => m.creativesCommand),
120
+ audiences: () => import("./audiences-WS4F3HBZ.js").then((m) => m.audiencesCommand),
121
+ "custom-conversions": () => import("./custom-conversions-NRK47O6Z.js").then((m) => m.customConversionsCommand),
122
122
  pixels: () => import("./pixels-EX6FHVHW.js").then((m) => m.pixelsCommand),
123
123
  activities: () => import("./activities-LC64DAAK.js").then((m) => m.activitiesCommand),
124
- insights: () => import("./insights-QU5A4XBO.js").then((m) => m.insightsCommand),
125
- preview: () => import("./preview-25YWCQBJ.js").then((m) => m.previewCommand),
124
+ insights: () => import("./insights-54KZY55Q.js").then((m) => m.insightsCommand),
125
+ preview: () => import("./preview-LP3RV2F2.js").then((m) => m.previewCommand),
126
126
  videos: () => import("./videos-TJG5CA7N.js").then((m) => m.videosCommand),
127
- targeting: () => import("./targeting-7T7XHBIX.js").then((m) => m.targetingCommand),
128
- "instagram-accounts": () => import("./account-assets-L6BX4YUQ.js").then((m) => m.instagramAccountsCommand),
129
- apps: () => import("./account-assets-L6BX4YUQ.js").then((m) => m.appsCommand),
130
- "dsa-recommendations": () => import("./account-assets-L6BX4YUQ.js").then((m) => m.dsaRecommendationsCommand),
131
- images: () => import("./account-assets-L6BX4YUQ.js").then((m) => m.imagesCommand),
132
- labels: () => import("./account-assets-L6BX4YUQ.js").then((m) => m.labelsCommand),
133
- studies: () => import("./studies-357M2C2K.js").then((m) => m.studiesCommand),
134
- catalogs: () => import("./catalogs-QAZ7ZZ5R.js").then((m) => m.catalogsCommand),
135
- "page-photos": () => import("./page-photos-ZBMJLL5V.js").then((m) => m.pagePhotosCommand),
136
- "page-posts": () => import("./account-level-OX34JQ7C.js").then((m) => m.pagePostsCommand),
137
- "instagram-media": () => import("./account-level-OX34JQ7C.js").then((m) => m.instagramMediaCommand),
138
- comments: () => import("./account-level-OX34JQ7C.js").then((m) => m.commentsCommand),
139
- "account-settings": () => import("./account-level-OX34JQ7C.js").then((m) => m.accountSettingsCommand),
140
- "account-details": () => import("./account-level-OX34JQ7C.js").then((m) => m.accountDetailsCommand),
141
- "block-lists": () => import("./account-level-OX34JQ7C.js").then((m) => m.blockListsCommand),
142
- "reach-frequency": () => import("./account-level-OX34JQ7C.js").then((m) => m.reachFrequencyCommand),
143
- "high-demand-periods": () => import("./account-assets-L6BX4YUQ.js").then((m) => m.highDemandPeriodsCommand),
144
- rules: () => import("./rules-BRULCGRV.js").then((m) => m.rulesCommand),
145
- media: () => import("./media-PUOLJUN3.js").then((m) => m.metaMediaCommand),
146
- draft: () => import("./draft-UU3F2VMJ.js").then((m) => m.metaDraftCommand)
127
+ targeting: () => import("./targeting-TQ7RYWX2.js").then((m) => m.targetingCommand),
128
+ "instagram-accounts": () => import("./account-assets-W2GJYDRE.js").then((m) => m.instagramAccountsCommand),
129
+ apps: () => import("./account-assets-W2GJYDRE.js").then((m) => m.appsCommand),
130
+ "dsa-recommendations": () => import("./account-assets-W2GJYDRE.js").then((m) => m.dsaRecommendationsCommand),
131
+ images: () => import("./account-assets-W2GJYDRE.js").then((m) => m.imagesCommand),
132
+ labels: () => import("./account-assets-W2GJYDRE.js").then((m) => m.labelsCommand),
133
+ studies: () => import("./studies-MUMENEVH.js").then((m) => m.studiesCommand),
134
+ catalogs: () => import("./catalogs-FAINI4WF.js").then((m) => m.catalogsCommand),
135
+ "page-photos": () => import("./page-photos-56WZO7EN.js").then((m) => m.pagePhotosCommand),
136
+ "page-posts": () => import("./account-level-N3QDHYOG.js").then((m) => m.pagePostsCommand),
137
+ "instagram-media": () => import("./account-level-N3QDHYOG.js").then((m) => m.instagramMediaCommand),
138
+ comments: () => import("./account-level-N3QDHYOG.js").then((m) => m.commentsCommand),
139
+ "account-settings": () => import("./account-level-N3QDHYOG.js").then((m) => m.accountSettingsCommand),
140
+ "account-details": () => import("./account-level-N3QDHYOG.js").then((m) => m.accountDetailsCommand),
141
+ "block-lists": () => import("./account-level-N3QDHYOG.js").then((m) => m.blockListsCommand),
142
+ "reach-frequency": () => import("./account-level-N3QDHYOG.js").then((m) => m.reachFrequencyCommand),
143
+ "high-demand-periods": () => import("./account-assets-W2GJYDRE.js").then((m) => m.highDemandPeriodsCommand),
144
+ rules: () => import("./rules-M6DKJW3S.js").then((m) => m.rulesCommand),
145
+ media: () => import("./media-UMSC6EET.js").then((m) => m.metaMediaCommand),
146
+ draft: () => import("./draft-H744DU5T.js").then((m) => m.metaDraftCommand)
147
147
  }
148
148
  });
149
149
  export {
150
150
  metaCommand
151
151
  };
152
- //# sourceMappingURL=meta-C7VHIHDL.js.map
152
+ //# sourceMappingURL=meta-G7EJ6Q4S.js.map
@@ -3,8 +3,8 @@ import {
3
3
  failWriteValidation,
4
4
  requireTarget,
5
5
  stageOp
6
- } from "./chunk-OMJ7DVFJ.js";
7
- import "./chunk-3R62EYYX.js";
6
+ } from "./chunk-6BMO6ZH6.js";
7
+ import "./chunk-47SIB7JD.js";
8
8
  import "./chunk-GDFJOCDO.js";
9
9
  import "./chunk-DP76WGDV.js";
10
10
  import "./chunk-XD7C5OE7.js";
@@ -119,4 +119,4 @@ var pagePhotosCommand = defineCommand({
119
119
  export {
120
120
  pagePhotosCommand
121
121
  };
122
- //# sourceMappingURL=page-photos-ZBMJLL5V.js.map
122
+ //# sourceMappingURL=page-photos-56WZO7EN.js.map
@@ -0,0 +1,104 @@
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-BPIHAIWB.js";
10
+ import "./chunk-VN3WDB4O.js";
11
+ import {
12
+ writeJsonEnvelope
13
+ } from "./chunk-NX4EB2TK.js";
14
+ import "./chunk-JGXB7NBP.js";
15
+ import "./chunk-RJHGIRU2.js";
16
+ import "./chunk-WCU362Z6.js";
17
+ import "./chunk-P7YPWBEV.js";
18
+ import "./chunk-GIWHHCD6.js";
19
+ import "./chunk-PNGXJPM5.js";
20
+ import "./chunk-SOPVIIUW.js";
21
+ import "./chunk-G4FG5EQO.js";
22
+ import "./chunk-CS4VA3GQ.js";
23
+ import "./chunk-CVAQZO4I.js";
24
+ import {
25
+ apiPost
26
+ } from "./chunk-EHEPW3O2.js";
27
+ import "./chunk-4OF7Q356.js";
28
+ import "./chunk-RNSC5JPH.js";
29
+ import "./chunk-2RTB2DDO.js";
30
+ import "./chunk-YQSBHWOI.js";
31
+
32
+ // src/commands/ads/linkedin/preview.ts
33
+ import { writeFileSync } from "fs";
34
+ import { defineCommand } from "citty";
35
+ var previewCommand = defineCommand({
36
+ meta: {
37
+ name: "preview",
38
+ description: `See an existing LinkedIn ad exactly as people see it in the feed \u2014 LinkedIn's own renderer,
39
+ for desktop and mobile. Returns shownText (the text displayed, in order) and a picture of each;
40
+ Read the picture only for what text cannot tell (words in the artwork, cropping, how it looks).
41
+
42
+ Start here before saying anything about how an ad LOOKS (which text shows, whether the headline
43
+ appears under the image, what the button says): the API fields say what is stored, the preview
44
+ shows what is displayed. Works for single image, carousel, video, event and job ads that already
45
+ exist on LinkedIn; staged (unpublished) ads have no preview yet.
46
+
47
+ Examples:
48
+ baker ads linkedin preview 1611562694 --account-id 503001492
49
+ baker ads linkedin preview 1611562694 --placement mobile
50
+ baker ads linkedin preview 1611562694 --out-dir /tmp/review`
51
+ },
52
+ args: {
53
+ id: { type: "positional", description: "Creative id or urn:li:sponsoredCreative:N", required: true },
54
+ "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
55
+ "account-urn": { type: "string", description: "Alias for --account-id" },
56
+ placement: { type: "string", description: "desktop|mobile|both (default: both)", default: "both" },
57
+ "out-dir": { type: "string", description: `Folder for the pictures (default: ${AD_PREVIEW_DIR_LABEL})` },
58
+ "html-file": { type: "string", description: "Also save LinkedIn's raw preview iframes to this file" }
59
+ },
60
+ run: async ({ args }) => {
61
+ const accountId = resolveAccountIdArg(args);
62
+ const placement = String(args.placement);
63
+ if (!["desktop", "mobile", "both"].includes(placement)) {
64
+ writeJsonEnvelope({
65
+ ok: false,
66
+ error: { code: "VALIDATION_ERROR", message: "--placement must be desktop, mobile or both" }
67
+ });
68
+ process.exit(1);
69
+ }
70
+ try {
71
+ const body = { accountId, creativeId: String(args.id) };
72
+ const data = await apiPost("/api/ads/linkedin/preview", body);
73
+ const wanted = data.previews.filter((p) => placement === "both" || p.placement === placement);
74
+ if (wanted.length === 0) {
75
+ writeJsonEnvelope({
76
+ ok: true,
77
+ data: { creativeId: data.creativeId, previews: [] },
78
+ hints: [
79
+ "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."
80
+ ]
81
+ });
82
+ return;
83
+ }
84
+ if (args["html-file"]) {
85
+ writeFileSync(String(args["html-file"]), wanted.map((p) => p.html).join("\n"), "utf-8");
86
+ }
87
+ const rendered = await renderAdPreviews(wanted, {
88
+ dir: args["out-dir"] ? String(args["out-dir"]) : AD_PREVIEW_DIR,
89
+ name: `linkedin-${data.creativeId}`
90
+ });
91
+ writeJsonEnvelope({
92
+ ok: true,
93
+ data: { creativeId: data.creativeId, previews: rendered.previews },
94
+ hints: rendered.hints
95
+ });
96
+ } catch (err) {
97
+ handleLinkedinError(err);
98
+ }
99
+ }
100
+ });
101
+ export {
102
+ previewCommand
103
+ };
104
+ //# sourceMappingURL=preview-HD3QAR53.js.map
@@ -0,0 +1 @@
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 { AD_PREVIEW_DIR, AD_PREVIEW_DIR_LABEL, renderAdPreviews } from \"../ad-preview-images.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\nexport const previewCommand = defineCommand({\n meta: {\n name: \"preview\",\n description: `See an existing LinkedIn ad exactly as people see it 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 --placement mobile\n baker ads linkedin preview 1611562694 --out-dir /tmp/review`,\n },\n args: {\n id: { type: \"positional\", description: \"Creative id or urn:li:sponsoredCreative:N\", required: true },\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 try {\n const body: LinkedinAdPreviewRequest = { accountId, creativeId: String(args.id) };\n const data = await apiPost<LinkedinAdPreviewResponse>(\"/api/ads/linkedin/preview\", body);\n const wanted = data.previews.filter((p) => placement === \"both\" || p.placement === placement);\n if (wanted.length === 0) {\n writeJsonEnvelope({\n ok: true,\n data: { creativeId: data.creativeId, 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 if (args[\"html-file\"]) {\n writeFileSync(String(args[\"html-file\"]), wanted.map((p) => p.html).join(\"\\n\"), \"utf-8\");\n }\n const rendered = await renderAdPreviews(wanted, {\n dir: args[\"out-dir\"] ? String(args[\"out-dir\"]) : AD_PREVIEW_DIR,\n name: `linkedin-${data.creativeId}`,\n });\n writeJsonEnvelope({\n ok: true,\n data: { creativeId: data.creativeId, previews: rendered.previews },\n hints: rendered.hints,\n });\n } catch (err) {\n handleLinkedinError(err);\n }\n },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAE9B,SAAS,qBAAqB;AAMvB,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaf;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,6CAA6C,UAAU,KAAK;AAAA,IACnG,cAAc,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,IAC/F,eAAe,EAAE,MAAM,UAAU,aAAa,yBAAyB;AAAA,IACvE,WAAW,EAAE,MAAM,UAAU,aAAa,uCAAuC,SAAS,OAAO;AAAA,IACjG,WAAW,EAAE,MAAM,UAAU,aAAa,qCAAqC,oBAAoB,IAAI;AAAA,IACvG,aAAa,EAAE,MAAM,UAAU,aAAa,wDAAwD;AAAA,EACtG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,UAAM,YAAY,OAAO,KAAK,SAAS;AACvC,QAAI,CAAC,CAAC,WAAW,UAAU,MAAM,EAAE,SAAS,SAAS,GAAG;AACtD,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,OAAO,EAAE,MAAM,oBAAoB,SAAS,8CAA8C;AAAA,MAC5F,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI;AACF,YAAM,OAAiC,EAAE,WAAW,YAAY,OAAO,KAAK,EAAE,EAAE;AAChF,YAAM,OAAO,MAAM,QAAmC,6BAA6B,IAAI;AACvF,YAAM,SAAS,KAAK,SAAS,OAAO,CAAC,MAAM,cAAc,UAAU,EAAE,cAAc,SAAS;AAC5F,UAAI,OAAO,WAAW,GAAG;AACvB,0BAAkB;AAAA,UAChB,IAAI;AAAA,UACJ,MAAM,EAAE,YAAY,KAAK,YAAY,UAAU,CAAC,EAAE;AAAA,UAClD,OAAO;AAAA,YACL;AAAA,UACF;AAAA,QACF,CAAC;AACD;AAAA,MACF;AACA,UAAI,KAAK,WAAW,GAAG;AACrB,sBAAc,OAAO,KAAK,WAAW,CAAC,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI,GAAG,OAAO;AAAA,MACxF;AACA,YAAM,WAAW,MAAM,iBAAiB,QAAQ;AAAA,QAC9C,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC,IAAI;AAAA,QACjD,MAAM,YAAY,KAAK,UAAU;AAAA,MACnC,CAAC;AACD,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,MAAM,EAAE,YAAY,KAAK,YAAY,UAAU,SAAS,SAAS;AAAA,QACjE,OAAO,SAAS;AAAA,MAClB,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}
@@ -2,23 +2,19 @@ import {
2
2
  AD_PREVIEW_DIR,
3
3
  AD_PREVIEW_DIR_LABEL,
4
4
  renderAdPreviews
5
- } from "./chunk-LJO3I2W2.js";
5
+ } from "./chunk-BPIHAIWB.js";
6
6
  import "./chunk-VN3WDB4O.js";
7
7
  import {
8
8
  FACEBOOK_PREVIEW_FORMATS,
9
9
  INSTAGRAM_PREVIEW_FORMATS,
10
10
  PLATFORM_SCOPED_POSITIONS,
11
11
  previewFormatForPosition
12
- } from "./chunk-3R62EYYX.js";
12
+ } from "./chunk-47SIB7JD.js";
13
13
  import "./chunk-GDFJOCDO.js";
14
14
  import {
15
15
  handleMetaError
16
16
  } from "./chunk-DP76WGDV.js";
17
17
  import "./chunk-QALAJNBG.js";
18
- import {
19
- apiFailure,
20
- eachTarget
21
- } from "./chunk-EMW6TSSB.js";
22
18
  import {
23
19
  NO_CACHE_ARG
24
20
  } from "./chunk-TBT6NWDX.js";
@@ -151,86 +147,10 @@ function previewFileName(target) {
151
147
  if (id) return `meta-${id}`;
152
148
  return `meta-draft-${createHash("sha256").update(target.creative ?? "").digest("hex").slice(0, 12)}`;
153
149
  }
154
- var MAX_PREVIEWS = 24;
155
- function listArg(value) {
156
- if (typeof value !== "string") return [];
157
- return [...new Set(value.split(",").map((item) => item.trim()))].filter(Boolean);
158
- }
159
- function previewSubjects(args) {
160
- const subjects = [
161
- ...listArg(args["creative-id"]).map((creativeId) => ({ creativeId })),
162
- ...listArg(args["ad-id"]).map((adId) => ({ adId }))
163
- ];
164
- if (subjects.length > 0) return subjects;
165
- const text = (value) => typeof value === "string" ? value : void 0;
166
- return [{ accountId: text(args["account-id"]), creative: text(args.creative) }];
167
- }
168
- function previewFormats(placements, args) {
169
- const formats = placements.length > 0 ? placements.map((p) => resolvePlacement(p, args.platform)) : listArg(args["ad-format"]);
170
- if (formats.length === 0) {
171
- failPreviewValidation("pass --ad-format or --placement (see --list-formats)");
172
- }
173
- const invalid = formats.find((adFormat) => !VALID_AD_FORMATS.includes(adFormat));
174
- if (invalid) {
175
- failPreviewValidation(
176
- `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.`
177
- );
178
- }
179
- return formats;
180
- }
181
- async function fetchPreviews(pairs, skipCache) {
182
- const refusals = [];
183
- const fetched = await eachTarget(
184
- pairs.map((_, i) => String(i)),
185
- (i) => {
186
- const { subject, adFormat } = pairs[Number(i)];
187
- return apiPost("/api/ads/meta/preview", {
188
- ...subject,
189
- adFormat,
190
- ...skipCache ? { skipCache: true } : {}
191
- });
192
- },
193
- (err) => {
194
- refusals.push(err);
195
- return apiFailure(err);
196
- }
197
- );
198
- if (refusals.length === pairs.length) {
199
- handleMetaError(refusals[0]);
200
- }
201
- return fetched;
202
- }
203
- function previewInputs(pairs, fetched, several) {
204
- const inputs = [];
205
- const owners = [];
206
- const refused = [];
207
- for (const [index, outcome] of fetched.entries()) {
208
- const { subject, adFormat } = pairs[index];
209
- const owner = several ? subjectId(subject) : {};
210
- if (!outcome.ok) {
211
- refused.push({ index: inputs.length, entry: { ...owner, placement: adFormat, error: outcome.error.message } });
212
- continue;
213
- }
214
- for (const [i, d] of outcome.data.entries()) {
215
- inputs.push({
216
- placement: outcome.data.length > 1 ? `${adFormat}-${i + 1}` : adFormat,
217
- html: d.body,
218
- name: previewFileName(subject)
219
- });
220
- owners.push(owner);
221
- }
222
- }
223
- return { inputs, owners, refused };
224
- }
225
- function subjectId(subject) {
226
- if ("creativeId" in subject) return { creativeId: subject.creativeId };
227
- if ("adId" in subject) return { adId: subject.adId };
228
- return {};
229
- }
230
150
  var previewCommand = defineCommand({
231
151
  meta: {
232
152
  name: "preview",
233
- description: `See creatives or ads as Meta renders them in one or more placements: shownText (the text people see, in order)
153
+ description: `See a creative or ad as Meta renders it in one placement: shownText (the text people see, in order)
234
154
  plus a picture to Read for what text cannot tell (words in the artwork, cropping, how it looks).
235
155
  --out-file also saves Meta's raw iframe HTML (its URL holds a short-lived access token \u2014 treat as secret).
236
156
 
@@ -239,31 +159,22 @@ image, the button). Start here too when you need to know what a creative looks l
239
159
  Meta's own renderer, so it settles "does my video show as a still image there?" without guessing.
240
160
  Pass the placement straight from an insights breakdown with --placement (a platform_position value),
241
161
  or a Meta ad_format with --ad-format. Run --list-formats to see both sets.
242
- To compare several creatives or placements, pass comma lists in ONE call \u2014 never loop the command:
243
- every creative \xD7 format pair comes back as its own preview, fetched and drawn in parallel (at most ${MAX_PREVIEWS}).
244
162
 
245
163
  Examples:
246
164
  baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD
247
- baker ads meta preview --creative-id 6123,6124 --ad-format MOBILE_FEED_STANDARD,INSTAGRAM_STORY,INSTAGRAM_REELS
248
165
  baker ads meta preview --creative-id 6123 --placement facebook_reels_overlay --platform facebook
249
166
  baker ads meta preview --ad-id 9988 --ad-format INSTAGRAM_REELS --out-dir /tmp/review
250
167
  baker ads meta preview --account-id act_123 --creative '{"object_story_spec":{...}}' --ad-format MOBILE_FEED_STANDARD`
251
168
  },
252
169
  args: {
253
- "creative-id": {
254
- type: "string",
255
- description: "Existing creative ID, or several comma-separated: --creative-id 6123,6124"
256
- },
257
- "ad-id": { type: "string", description: "Existing ad ID, or several comma-separated: --ad-id 9988,9989" },
170
+ "creative-id": { type: "string", description: "Existing creative ID" },
171
+ "ad-id": { type: "string", description: "Existing ad ID" },
258
172
  "account-id": { type: "string", description: "Required when previewing an unpublished --creative spec" },
259
173
  creative: { type: "string", description: "JSON spec of an unpublished creative (e.g. object_story_spec)" },
260
- "ad-format": {
261
- type: "string",
262
- description: "Meta ad_format value, or several comma-separated: --ad-format MOBILE_FEED_STANDARD,INSTAGRAM_REELS (--list-formats to see them)"
263
- },
174
+ "ad-format": { type: "string", description: "Meta ad_format enum value (--list-formats to see them)" },
264
175
  placement: {
265
176
  type: "string",
266
- description: "platform_position from an insights breakdown (e.g. facebook_reels_overlay), or several comma-separated \u2014 each resolved to an ad_format"
177
+ description: "platform_position from an insights breakdown (e.g. facebook_reels_overlay) \u2014 resolved to an ad_format"
267
178
  },
268
179
  platform: { type: "string", description: "facebook|instagram \u2014 required for --placement feed, which both report" },
269
180
  "list-formats": { type: "boolean", description: "Print the ad_format values and placement mappings, then exit" },
@@ -282,48 +193,54 @@ Examples:
282
193
  });
283
194
  return;
284
195
  }
285
- const placements = listArg(args.placement);
286
- const formats = previewFormats(placements, args);
287
- const subjects = previewSubjects(args);
288
- const pairs = subjects.flatMap((subject) => formats.map((adFormat) => ({ subject, adFormat })));
289
- if (pairs.length > MAX_PREVIEWS) {
196
+ const placement = args.placement;
197
+ const adFormat = placement ? resolvePlacement(placement, args.platform) : args["ad-format"];
198
+ if (!adFormat) {
199
+ failPreviewValidation("pass --ad-format or --placement (see --list-formats)");
200
+ }
201
+ if (!VALID_AD_FORMATS.includes(adFormat)) {
290
202
  failPreviewValidation(
291
- `${subjects.length} ${subjects.length === 1 ? "creative" : "creatives or ads"} \xD7 ${formats.length} formats is ${pairs.length} previews; one call draws at most ${MAX_PREVIEWS}. Split the list.`
203
+ `Invalid --ad-format "${adFormat}". Meta's ad_format values: ${VALID_AD_FORMATS.join(", ")}. To preview a placement you saw in an insights breakdown, pass --placement <platform_position> instead of guessing a format name.`
292
204
  );
293
205
  }
294
- const fetched = await fetchPreviews(pairs, Boolean(args["no-cache"]));
295
- const { inputs, owners, refused } = previewInputs(pairs, fetched, subjects.length > 1);
296
- if (args["out-file"]) {
297
- writeFileSync(args["out-file"], inputs.map((d) => d.html).join("\n"), "utf-8");
206
+ const body = { adFormat };
207
+ if (args["creative-id"]) body.creativeId = args["creative-id"];
208
+ if (args["ad-id"]) body.adId = args["ad-id"];
209
+ if (args["account-id"]) body.accountId = args["account-id"];
210
+ if (args.creative) body.creative = args.creative;
211
+ if (args["no-cache"]) body.skipCache = true;
212
+ try {
213
+ const data = await apiPost("/api/ads/meta/preview", body);
214
+ if (args["out-file"]) {
215
+ writeFileSync(args["out-file"], data.map((d) => d.body).join("\n"), "utf-8");
216
+ }
217
+ const rendered = await renderAdPreviews(
218
+ data.map((d, i) => ({ placement: data.length > 1 ? `${adFormat}-${i + 1}` : adFormat, html: d.body })),
219
+ {
220
+ dir: args["out-dir"] ? String(args["out-dir"]) : AD_PREVIEW_DIR,
221
+ name: previewFileName({
222
+ adId: args["ad-id"],
223
+ creativeId: args["creative-id"],
224
+ creative: args.creative
225
+ })
226
+ }
227
+ );
228
+ const hints = placement ? [
229
+ `Rendered ${placement} as ad_format ${adFormat}. Meta does not document what it renders for a creative a placement cannot take, so the picture is the evidence.`,
230
+ ...rendered.hints
231
+ ] : rendered.hints;
232
+ writeJsonEnvelope({
233
+ ok: true,
234
+ data: { adFormat, previews: rendered.previews, ...args["out-file"] ? { file: args["out-file"] } : {} },
235
+ hints
236
+ });
237
+ } catch (err) {
238
+ handleMetaError(err);
298
239
  }
299
- const rendered = await renderAdPreviews(inputs, {
300
- dir: args["out-dir"] ? String(args["out-dir"]) : AD_PREVIEW_DIR,
301
- name: "meta"
302
- });
303
- const previews = rendered.previews.map((p, i) => ({ ...owners[i], ...p }));
304
- for (const { index, entry } of refused.reverse()) previews.splice(index, 0, entry);
305
- const hints = [
306
- ...placements.map(
307
- (p, i) => `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.`
308
- ),
309
- ...rendered.hints,
310
- ...refused.length > 0 ? [
311
- "Meta refused some previews (each says why in its error). Say those could not be checked; the rest are real."
312
- ] : []
313
- ];
314
- writeJsonEnvelope({
315
- ok: true,
316
- data: {
317
- ...formats.length === 1 ? { adFormat: formats[0] } : { adFormats: formats },
318
- previews,
319
- ...args["out-file"] ? { file: args["out-file"] } : {}
320
- },
321
- hints
322
- });
323
240
  }
324
241
  });
325
242
  export {
326
243
  previewCommand,
327
244
  previewFileName
328
245
  };
329
- //# sourceMappingURL=preview-25YWCQBJ.js.map
246
+ //# sourceMappingURL=preview-LP3RV2F2.js.map
@@ -0,0 +1 @@
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 { AD_PREVIEW_DIR, AD_PREVIEW_DIR_LABEL, 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\nexport const previewCommand = defineCommand({\n meta: {\n name: \"preview\",\n description: `See a creative or ad as Meta renders it in one placement: 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.\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-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\": { 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: \"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 placement = args.placement as string | undefined;\n const adFormat = placement ? resolvePlacement(placement, args.platform) : (args[\"ad-format\"] as string);\n if (!adFormat) {\n failPreviewValidation(\"pass --ad-format or --placement (see --list-formats)\");\n }\n if (!VALID_AD_FORMATS.includes(adFormat)) {\n failPreviewValidation(\n `Invalid --ad-format \"${adFormat}\". Meta's ad_format values: ${VALID_AD_FORMATS.join(\", \")}. To preview a placement you saw in an insights breakdown, pass --placement <platform_position> instead of guessing a format name.`,\n );\n }\n const body: Record<string, unknown> = { adFormat };\n if (args[\"creative-id\"]) body.creativeId = args[\"creative-id\"];\n if (args[\"ad-id\"]) body.adId = args[\"ad-id\"];\n if (args[\"account-id\"]) body.accountId = args[\"account-id\"];\n if (args.creative) body.creative = args.creative;\n if (args[\"no-cache\"]) body.skipCache = true;\n\n try {\n const data = await apiPost<Array<{ body: string }>>(\"/api/ads/meta/preview\", body);\n if (args[\"out-file\"]) {\n writeFileSync(args[\"out-file\"] as string, data.map((d) => d.body).join(\"\\n\"), \"utf-8\");\n }\n const rendered = await renderAdPreviews(\n data.map((d, i) => ({ placement: data.length > 1 ? `${adFormat}-${i + 1}` : adFormat, html: d.body })),\n {\n dir: args[\"out-dir\"] ? String(args[\"out-dir\"]) : AD_PREVIEW_DIR,\n name: previewFileName({\n adId: args[\"ad-id\"] as string | undefined,\n creativeId: args[\"creative-id\"] as string | undefined,\n creative: args.creative as string | undefined,\n }),\n },\n );\n const hints = placement\n ? [\n `Rendered ${placement} as ad_format ${adFormat}. Meta does not document what it renders for a creative a placement cannot take, so the picture is the evidence.`,\n ...rendered.hints,\n ]\n : rendered.hints;\n writeJsonEnvelope({\n ok: true,\n data: { adFormat, previews: rendered.previews, ...(args[\"out-file\"] ? { file: args[\"out-file\"] } : {}) },\n hints,\n });\n } catch (err) {\n handleMetaError(err);\n }\n },\n});\n"],"mappings":"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","names":[]}
@@ -1,14 +1,14 @@
1
1
  import {
2
2
  decimalMarkShown
3
- } from "./chunk-GED2RAQE.js";
3
+ } from "./chunk-7BRLLCKC.js";
4
4
  import {
5
5
  bareAccountId,
6
6
  failWriteValidation,
7
7
  fileArg,
8
8
  requireTarget,
9
9
  stageOp
10
- } from "./chunk-OMJ7DVFJ.js";
11
- import "./chunk-3R62EYYX.js";
10
+ } from "./chunk-6BMO6ZH6.js";
11
+ import "./chunk-47SIB7JD.js";
12
12
  import "./chunk-GDFJOCDO.js";
13
13
  import "./chunk-DP76WGDV.js";
14
14
  import "./chunk-XD7C5OE7.js";
@@ -531,4 +531,4 @@ export {
531
531
  rulesRunCommand,
532
532
  rulesUpdateCommand
533
533
  };
534
- //# sourceMappingURL=rule-writes-6XP7G35U.js.map
534
+ //# sourceMappingURL=rule-writes-KB6RB5GF.js.map
@@ -194,12 +194,12 @@ Examples:
194
194
  list: listCommand,
195
195
  history: historyCommand,
196
196
  preview: previewCommand,
197
- create: () => import("./rule-writes-6XP7G35U.js").then((m) => m.rulesCreateCommand),
198
- update: () => import("./rule-writes-6XP7G35U.js").then((m) => m.rulesUpdateCommand),
199
- enable: () => import("./rule-writes-6XP7G35U.js").then((m) => m.rulesEnableCommand),
200
- disable: () => import("./rule-writes-6XP7G35U.js").then((m) => m.rulesDisableCommand),
201
- delete: () => import("./rule-writes-6XP7G35U.js").then((m) => m.rulesDeleteCommand),
202
- run: () => import("./rule-writes-6XP7G35U.js").then((m) => m.rulesRunCommand)
197
+ create: () => import("./rule-writes-KB6RB5GF.js").then((m) => m.rulesCreateCommand),
198
+ update: () => import("./rule-writes-KB6RB5GF.js").then((m) => m.rulesUpdateCommand),
199
+ enable: () => import("./rule-writes-KB6RB5GF.js").then((m) => m.rulesEnableCommand),
200
+ disable: () => import("./rule-writes-KB6RB5GF.js").then((m) => m.rulesDisableCommand),
201
+ delete: () => import("./rule-writes-KB6RB5GF.js").then((m) => m.rulesDeleteCommand),
202
+ run: () => import("./rule-writes-KB6RB5GF.js").then((m) => m.rulesRunCommand)
203
203
  },
204
204
  args: {
205
205
  "account-id": { type: "string", description: "Meta ad account ID" },
@@ -214,4 +214,4 @@ export {
214
214
  ruleListHints,
215
215
  rulesCommand
216
216
  };
217
- //# sourceMappingURL=rules-BRULCGRV.js.map
217
+ //# sourceMappingURL=rules-M6DKJW3S.js.map
@@ -232,10 +232,10 @@ Examples:
232
232
  },
233
233
  subCommands: {
234
234
  list: listCommand,
235
- create: () => import("./study-writes-HXUQRPIK.js").then((m) => m.studiesCreateCommand),
236
- update: () => import("./study-writes-HXUQRPIK.js").then((m) => m.studiesUpdateCommand),
237
- end: () => import("./study-writes-HXUQRPIK.js").then((m) => m.studiesEndCommand),
238
- delete: () => import("./study-writes-HXUQRPIK.js").then((m) => m.studiesDeleteCommand)
235
+ create: () => import("./study-writes-5X4ZTRZD.js").then((m) => m.studiesCreateCommand),
236
+ update: () => import("./study-writes-5X4ZTRZD.js").then((m) => m.studiesUpdateCommand),
237
+ end: () => import("./study-writes-5X4ZTRZD.js").then((m) => m.studiesEndCommand),
238
+ delete: () => import("./study-writes-5X4ZTRZD.js").then((m) => m.studiesDeleteCommand)
239
239
  },
240
240
  args: listArgs,
241
241
  default: "list"
@@ -247,4 +247,4 @@ export {
247
247
  studyHints,
248
248
  studyState
249
249
  };
250
- //# sourceMappingURL=studies-357M2C2K.js.map
250
+ //# sourceMappingURL=studies-MUMENEVH.js.map
@@ -5,8 +5,8 @@ import {
5
5
  loadJsonFileArg,
6
6
  requireTarget,
7
7
  stageOp
8
- } from "./chunk-OMJ7DVFJ.js";
9
- import "./chunk-3R62EYYX.js";
8
+ } from "./chunk-6BMO6ZH6.js";
9
+ import "./chunk-47SIB7JD.js";
10
10
  import "./chunk-GDFJOCDO.js";
11
11
  import "./chunk-DP76WGDV.js";
12
12
  import "./chunk-XD7C5OE7.js";
@@ -472,4 +472,4 @@ export {
472
472
  studiesUpdateCommand,
473
473
  studyFlagsFromArgs
474
474
  };
475
- //# sourceMappingURL=study-writes-HXUQRPIK.js.map
475
+ //# sourceMappingURL=study-writes-5X4ZTRZD.js.map
@@ -4,10 +4,10 @@ import {
4
4
  } from "./chunk-PRPSV4VB.js";
5
5
  import {
6
6
  loadJsonFileArg
7
- } from "./chunk-OMJ7DVFJ.js";
7
+ } from "./chunk-6BMO6ZH6.js";
8
8
  import {
9
9
  metaTargetingSchema
10
- } from "./chunk-3R62EYYX.js";
10
+ } from "./chunk-47SIB7JD.js";
11
11
  import "./chunk-GDFJOCDO.js";
12
12
  import {
13
13
  csvOrJson,
@@ -774,4 +774,4 @@ Start here before writing interests, behaviors, places or languages into an ad s
774
774
  export {
775
775
  targetingCommand
776
776
  };
777
- //# sourceMappingURL=targeting-7T7XHBIX.js.map
777
+ //# sourceMappingURL=targeting-TQ7RYWX2.js.map