@koda-sl/baker-cli 0.869.0-dev.0631d8a3c → 0.869.0-dev.620009099
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.
- package/README.md +1 -3
- package/dist/{account-LHY6YM6L.js → account-5VOZ4R2X.js} +2 -2
- package/dist/{account-assets-L6BX4YUQ.js → account-assets-DOHOKM2L.js} +54 -46
- package/dist/account-assets-DOHOKM2L.js.map +1 -0
- package/dist/{account-level-OX34JQ7C.js → account-level-HLSTNJHR.js} +4 -4
- package/dist/{accounts-LNFU27BU.js → accounts-SNH3LJ2H.js} +2 -2
- package/dist/{activities-LC64DAAK.js → activities-QHDGHXMI.js} +21 -12
- package/dist/activities-QHDGHXMI.js.map +1 -0
- package/dist/{ads-VSU53JN3.js → ads-MYACXO5A.js} +3 -3
- package/dist/{ads-ZR5D7BZT.js → ads-ZDSRE7D6.js} +27 -19
- package/dist/ads-ZDSRE7D6.js.map +1 -0
- package/dist/{adsets-3NIYL2GQ.js → adsets-CZQMTJ2T.js} +48 -30
- package/dist/adsets-CZQMTJ2T.js.map +1 -0
- package/dist/{asset-writes-5ZKZDPQ4.js → asset-writes-TXYCARXJ.js} +4 -4
- package/dist/{audience-writes-NL6NRLLY.js → audience-writes-DJG7XTFA.js} +29 -15
- package/dist/audience-writes-DJG7XTFA.js.map +1 -0
- package/dist/{audiences-DL267GNQ.js → audiences-QHM26I5Y.js} +27 -15
- package/dist/audiences-QHM26I5Y.js.map +1 -0
- package/dist/{businesses-RQ6P4DOS.js → businesses-ALNQZFB4.js} +2 -2
- package/dist/{campaigns-RXDC5FSQ.js → campaigns-55VLNVCE.js} +29 -18
- package/dist/campaigns-55VLNVCE.js.map +1 -0
- package/dist/{catalogs-QAZ7ZZ5R.js → catalogs-B24HAEXZ.js} +3 -3
- package/dist/{chunk-OMJ7DVFJ.js → chunk-2WHALQOJ.js} +2 -2
- package/dist/{chunk-XFTN3ARP.js → chunk-BPIHAIWB.js} +13 -22
- package/dist/chunk-BPIHAIWB.js.map +1 -0
- package/dist/{chunk-EGM42UKF.js → chunk-EJ6B5OS5.js} +2 -2
- package/dist/{chunk-WKRVHRWY.js → chunk-VBIKO56A.js} +14 -3
- package/dist/chunk-VBIKO56A.js.map +1 -0
- package/dist/{chunk-UE5ZFTDL.js → chunk-VUJPKIJN.js} +2 -2
- package/dist/{chunk-DP76WGDV.js → chunk-YF57BX3S.js} +87 -8
- package/dist/chunk-YF57BX3S.js.map +1 -0
- package/dist/cli.js +1 -1
- package/dist/{copy-writes-QYN6PBU2.js → copy-writes-S4X5XUSK.js} +4 -4
- package/dist/{creatives-CPLH3KHQ.js → creatives-BCTG6PV4.js} +32 -19
- package/dist/creatives-BCTG6PV4.js.map +1 -0
- package/dist/{custom-conversions-CTJVAZKC.js → custom-conversions-56VXFOWV.js} +27 -15
- package/dist/custom-conversions-56VXFOWV.js.map +1 -0
- package/dist/{draft-UU3F2VMJ.js → draft-OMGA2NYG.js} +2 -2
- package/dist/{insights-QU5A4XBO.js → insights-3SQWIU4E.js} +2 -2
- package/dist/{instant-experiences-EJWYFWDT.js → instant-experiences-HSRGMQ5T.js} +3 -3
- package/dist/{leads-FEEWX7OO.js → leads-LWWPMZRY.js} +3 -3
- package/dist/{linkedin-RMZMQ2ZA.js → linkedin-EBOTX37R.js} +4 -8
- package/dist/{linkedin-RMZMQ2ZA.js.map → linkedin-EBOTX37R.js.map} +1 -1
- package/dist/{media-PUOLJUN3.js → media-UODVM47L.js} +3 -3
- package/dist/{meta-HOFABFAK.js → meta-4IOVQSFF.js} +40 -40
- package/dist/{page-photos-ZBMJLL5V.js → page-photos-BCEDWPGX.js} +3 -3
- package/dist/{pages-YZC44QR2.js → pages-TZBFJXNR.js} +2 -2
- package/dist/{pixels-EX6FHVHW.js → pixels-2BG3XMZP.js} +25 -12
- package/dist/pixels-2BG3XMZP.js.map +1 -0
- package/dist/preview-HD3QAR53.js +104 -0
- package/dist/preview-HD3QAR53.js.map +1 -0
- package/dist/{preview-XXQ5AHXP.js → preview-WHUVS5JJ.js} +43 -135
- package/dist/preview-WHUVS5JJ.js.map +1 -0
- package/dist/{rule-writes-6XP7G35U.js → rule-writes-Q5NLSBF5.js} +3 -3
- package/dist/{rules-BRULCGRV.js → rules-Z7MMVOZ2.js} +41 -24
- package/dist/rules-Z7MMVOZ2.js.map +1 -0
- package/dist/{shared-64RE42DL.js → shared-AXONQS3M.js} +16 -4
- package/dist/{studies-357M2C2K.js → studies-HUINRZHD.js} +33 -16
- package/dist/studies-HUINRZHD.js.map +1 -0
- package/dist/{study-writes-HXUQRPIK.js → study-writes-SI5QXY7F.js} +3 -3
- package/dist/{targeting-7T7XHBIX.js → targeting-3XK4OLPG.js} +3 -3
- package/dist/{videos-TJG5CA7N.js → videos-C5OCSAIF.js} +2 -2
- package/dist/{write-commands-4KI6T2NF.js → write-commands-T46SVSQ7.js} +7 -7
- package/package.json +1 -1
- package/dist/account-assets-L6BX4YUQ.js.map +0 -1
- package/dist/activities-LC64DAAK.js.map +0 -1
- package/dist/ads-ZR5D7BZT.js.map +0 -1
- package/dist/adsets-3NIYL2GQ.js.map +0 -1
- package/dist/audience-writes-NL6NRLLY.js.map +0 -1
- package/dist/audiences-DL267GNQ.js.map +0 -1
- package/dist/campaigns-RXDC5FSQ.js.map +0 -1
- package/dist/chunk-DP76WGDV.js.map +0 -1
- package/dist/chunk-WKRVHRWY.js.map +0 -1
- package/dist/chunk-XFTN3ARP.js.map +0 -1
- package/dist/creatives-CPLH3KHQ.js.map +0 -1
- package/dist/custom-conversions-CTJVAZKC.js.map +0 -1
- package/dist/pixels-EX6FHVHW.js.map +0 -1
- package/dist/preview-4DDR337D.js +0 -151
- package/dist/preview-4DDR337D.js.map +0 -1
- package/dist/preview-XXQ5AHXP.js.map +0 -1
- package/dist/rules-BRULCGRV.js.map +0 -1
- package/dist/studies-357M2C2K.js.map +0 -1
- /package/dist/{account-LHY6YM6L.js.map → account-5VOZ4R2X.js.map} +0 -0
- /package/dist/{account-level-OX34JQ7C.js.map → account-level-HLSTNJHR.js.map} +0 -0
- /package/dist/{accounts-LNFU27BU.js.map → accounts-SNH3LJ2H.js.map} +0 -0
- /package/dist/{ads-VSU53JN3.js.map → ads-MYACXO5A.js.map} +0 -0
- /package/dist/{asset-writes-5ZKZDPQ4.js.map → asset-writes-TXYCARXJ.js.map} +0 -0
- /package/dist/{businesses-RQ6P4DOS.js.map → businesses-ALNQZFB4.js.map} +0 -0
- /package/dist/{catalogs-QAZ7ZZ5R.js.map → catalogs-B24HAEXZ.js.map} +0 -0
- /package/dist/{chunk-OMJ7DVFJ.js.map → chunk-2WHALQOJ.js.map} +0 -0
- /package/dist/{chunk-EGM42UKF.js.map → chunk-EJ6B5OS5.js.map} +0 -0
- /package/dist/{chunk-UE5ZFTDL.js.map → chunk-VUJPKIJN.js.map} +0 -0
- /package/dist/{copy-writes-QYN6PBU2.js.map → copy-writes-S4X5XUSK.js.map} +0 -0
- /package/dist/{draft-UU3F2VMJ.js.map → draft-OMGA2NYG.js.map} +0 -0
- /package/dist/{insights-QU5A4XBO.js.map → insights-3SQWIU4E.js.map} +0 -0
- /package/dist/{instant-experiences-EJWYFWDT.js.map → instant-experiences-HSRGMQ5T.js.map} +0 -0
- /package/dist/{leads-FEEWX7OO.js.map → leads-LWWPMZRY.js.map} +0 -0
- /package/dist/{media-PUOLJUN3.js.map → media-UODVM47L.js.map} +0 -0
- /package/dist/{meta-HOFABFAK.js.map → meta-4IOVQSFF.js.map} +0 -0
- /package/dist/{page-photos-ZBMJLL5V.js.map → page-photos-BCEDWPGX.js.map} +0 -0
- /package/dist/{pages-YZC44QR2.js.map → pages-TZBFJXNR.js.map} +0 -0
- /package/dist/{rule-writes-6XP7G35U.js.map → rule-writes-Q5NLSBF5.js.map} +0 -0
- /package/dist/{shared-64RE42DL.js.map → shared-AXONQS3M.js.map} +0 -0
- /package/dist/{study-writes-HXUQRPIK.js.map → study-writes-SI5QXY7F.js.map} +0 -0
- /package/dist/{targeting-7T7XHBIX.js.map → targeting-3XK4OLPG.js.map} +0 -0
- /package/dist/{videos-TJG5CA7N.js.map → videos-C5OCSAIF.js.map} +0 -0
- /package/dist/{write-commands-4KI6T2NF.js.map → write-commands-T46SVSQ7.js.map} +0 -0
|
@@ -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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAO9B,SAAS,qBAAqB;AAa9B,IAAM,mBAAmB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,SAAS,sBAAsB,SAAwB;AACrD,eAAa,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,QAAQ,EAAE,CAAC;AACxE,UAAQ,KAAK,CAAC;AAChB;AASA,SAAS,iBAAiB,UAAkB,UAA2B;AACrE,QAAM,cAAc,OAAO,aAAa,WAAW,SAAS,YAAY,IAAI;AAC5E,MAAI,eAAe,gBAAgB,cAAc,gBAAgB,aAAa;AAC5E,0BAAsB,0CAA0C;AAAA,EAClE;AACA,QAAM,SAAS,yBAAyB,UAAU,WAAW;AAC7D,MAAI,QAAQ;AACV,WAAO;AAAA,EACT;AACA,MAAI,0BAA0B,IAAI,QAAQ,KAAK,CAAC,aAAa;AAC3D;AAAA,MACE,eAAe,QAAQ;AAAA,IACzB;AAAA,EACF;AACA;AAAA,IACE,sDAAsD,QAAQ,2ZAAsZ,eAAe,CAAC;AAAA,EACte;AACF;AAEA,SAAS,iBAAyB;AAChC,QAAM,WAAW,OAAO,KAAK,wBAAwB,EAAE,KAAK,IAAI;AAChE,QAAM,YAAY,OAAO,KAAK,yBAAyB,EAAE,KAAK,IAAI;AAClE,SAAO,mBAAc,QAAQ,sBAAiB,SAAS;AACzD;AAGO,SAAS,gBAAgB,QAA2E;AACzG,QAAM,KAAK,OAAO,QAAQ,OAAO;AACjC,MAAI,GAAI,QAAO,QAAQ,EAAE;AACzB,SAAO,cAAc,WAAW,QAAQ,EACrC,OAAO,OAAO,YAAY,EAAE,EAC5B,OAAO,KAAK,EACZ,MAAM,GAAG,EAAE,CAAC;AACjB;AAGA,IAAM,eAAe;AAGrB,SAAS,QAAQ,OAA0B;AACzC,MAAI,OAAO,UAAU,SAAU,QAAO,CAAC;AACvC,SAAO,CAAC,GAAG,IAAI,IAAI,MAAM,MAAM,GAAG,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,OAAO;AACjF;AAKA,SAAS,gBAAgB,MAAiD;AACxE,QAAM,WAA6B;AAAA,IACjC,GAAG,QAAQ,KAAK,aAAa,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,EAAE;AAAA,IACpE,GAAG,QAAQ,KAAK,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE;AAAA,EACpD;AACA,MAAI,SAAS,SAAS,EAAG,QAAO;AAChC,QAAM,OAAO,CAAC,UAAoB,OAAO,UAAU,WAAW,QAAQ;AACtE,SAAO,CAAC,EAAE,WAAW,KAAK,KAAK,YAAY,CAAC,GAAG,UAAU,KAAK,KAAK,QAAQ,EAAE,CAAC;AAChF;AAGA,SAAS,eAAe,YAAsB,MAAyC;AACrF,QAAM,UACJ,WAAW,SAAS,IAAI,WAAW,IAAI,CAAC,MAAM,iBAAiB,GAAG,KAAK,QAAQ,CAAC,IAAI,QAAQ,KAAK,WAAW,CAAC;AAC/G,MAAI,QAAQ,WAAW,GAAG;AACxB,0BAAsB,sDAAsD;AAAA,EAC9E;AACA,QAAM,UAAU,QAAQ,KAAK,CAAC,aAAa,CAAC,iBAAiB,SAAS,QAAQ,CAAC;AAC/E,MAAI,SAAS;AACX;AAAA,MACE,wBAAwB,OAAO,+BAA+B,iBAAiB,KAAK,IAAI,CAAC;AAAA,IAC3F;AAAA,EACF;AACA,SAAO;AACT;AAQA,eAAe,cAAc,OAAsB,WAAoB;AACrE,QAAM,WAAsB,CAAC;AAC7B,QAAM,UAAU,MAAM;AAAA,IACpB,MAAM,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC;AAAA,IAC7B,CAAC,MAAM;AACL,YAAM,EAAE,SAAS,SAAS,IAAI,MAAM,OAAO,CAAC,CAAC;AAC7C,aAAO,QAAiC,yBAAyB;AAAA,QAC/D,GAAG;AAAA,QACH;AAAA,QACA,GAAI,YAAY,EAAE,WAAW,KAAK,IAAI,CAAC;AAAA,MACzC,CAAC;AAAA,IACH;AAAA,IACA,CAAC,QAAQ;AACP,eAAS,KAAK,GAAG;AACjB,aAAO,WAAW,GAAG;AAAA,IACvB;AAAA,EACF;AACA,MAAI,SAAS,WAAW,MAAM,QAAQ;AACpC,oBAAgB,SAAS,CAAC,CAAC;AAAA,EAC7B;AACA,SAAO;AACT;AAGA,SAAS,cAAc,OAAsB,SAAoD,SAAkB;AACjH,QAAM,SAA2B,CAAC;AAClC,QAAM,SAAwC,CAAC;AAC/C,QAAM,UAAoE,CAAC;AAC3E,aAAW,CAAC,OAAO,OAAO,KAAK,QAAQ,QAAQ,GAAG;AAChD,UAAM,EAAE,SAAS,SAAS,IAAI,MAAM,KAAK;AACzC,UAAM,QAAQ,UAAU,UAAU,OAAO,IAAI,CAAC;AAC9C,QAAI,CAAC,QAAQ,IAAI;AACf,cAAQ,KAAK,EAAE,OAAO,OAAO,QAAQ,OAAO,EAAE,GAAG,OAAO,WAAW,UAAU,OAAO,QAAQ,MAAM,QAAQ,EAAE,CAAC;AAC7G;AAAA,IACF;AACA,QAAI,QAAQ,KAAK,WAAW,GAAG;AAC7B,cAAQ,KAAK;AAAA,QACX,OAAO,OAAO;AAAA,QACd,OAAO,EAAE,GAAG,OAAO,WAAW,UAAU,OAAO,8CAA8C;AAAA,MAC/F,CAAC;AACD;AAAA,IACF;AACA,eAAW,CAAC,GAAG,CAAC,KAAK,QAAQ,KAAK,QAAQ,GAAG;AAC3C,aAAO,KAAK;AAAA,QACV,WAAW,QAAQ,KAAK,SAAS,IAAI,GAAG,QAAQ,IAAI,IAAI,CAAC,KAAK;AAAA,QAC9D,MAAM,EAAE;AAAA,QACR,MAAM,gBAAgB,OAAO;AAAA,MAC/B,CAAC;AACD,aAAO,KAAK,KAAK;AAAA,IACnB;AAAA,EACF;AACA,SAAO,EAAE,QAAQ,QAAQ,QAAQ;AACnC;AAGA,SAAS,UAAU,SAAiD;AAClE,MAAI,gBAAgB,QAAS,QAAO,EAAE,YAAY,QAAQ,WAAW;AACrE,MAAI,UAAU,QAAS,QAAO,EAAE,MAAM,QAAQ,KAAK;AACnD,SAAO,CAAC;AACV;AAEO,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wGAUoF,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ/G;AAAA,EACA,MAAM;AAAA,IACJ,eAAe;AAAA,MACb,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,IACA,SAAS,EAAE,MAAM,UAAU,aAAa,gEAAgE;AAAA,IACxG,cAAc,EAAE,MAAM,UAAU,aAAa,0DAA0D;AAAA,IACvG,UAAU,EAAE,MAAM,UAAU,aAAa,gEAAgE;AAAA,IACzG,aAAa;AAAA,MACX,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,IACA,UAAU,EAAE,MAAM,UAAU,aAAa,6EAAwE;AAAA,IACjH,gBAAgB,EAAE,MAAM,WAAW,aAAa,+DAA+D;AAAA,IAC/G,YAAY,EAAE,MAAM,UAAU,aAAa,4CAA4C;AAAA,IACvF,WAAW,EAAE,MAAM,UAAU,aAAa,oCAAoC,oBAAoB,IAAI;AAAA,IACtG,YAAY;AAAA,EACd;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI,KAAK,cAAc,GAAG;AACxB,mBAAa;AAAA,QACX,IAAI;AAAA,QACJ,MAAM;AAAA,UACJ,WAAW;AAAA,UACX,YAAY,EAAE,UAAU,0BAA0B,WAAW,0BAA0B;AAAA,QACzF;AAAA,MACF,CAAC;AACD;AAAA,IACF;AAEA,UAAM,aAAa,QAAQ,KAAK,SAAS;AACzC,UAAM,UAAU,eAAe,YAAY,IAAI;AAC/C,UAAM,WAAW,gBAAgB,IAAI;AACrC,UAAM,QAAQ,SAAS,QAAQ,CAAC,YAAY,QAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,SAAS,EAAE,CAAC;AAC9F,QAAI,MAAM,SAAS,cAAc;AAC/B;AAAA,QACE,GAAG,SAAS,MAAM,IAAI,SAAS,WAAW,IAAI,aAAa,kBAAkB,SAAM,QAAQ,MAAM,eAAe,MAAM,MAAM,qCAAqC,YAAY;AAAA,MAC/K;AAAA,IACF;AACA,UAAM,UAAU,MAAM,cAAc,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC;AAEpE,UAAM,EAAE,QAAQ,QAAQ,QAAQ,IAAI,cAAc,OAAO,SAAS,SAAS,SAAS,CAAC;AACrF,QAAI;AACJ,QAAI;AACF,UAAI,KAAK,UAAU,GAAG;AACpB,sBAAc,KAAK,UAAU,GAAa,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI,GAAG,OAAO;AAAA,MACzF;AACA,iBAAW,MAAM,iBAAiB,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC,IAAI,cAAc;AAAA,IACtG,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AACA,UAAM,WAA2C,SAAS,SAAS,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,EAAE,EAAE;AACzG,eAAW,EAAE,OAAO,MAAM,KAAK,QAAQ,QAAQ,EAAG,UAAS,OAAO,OAAO,GAAG,KAAK;AAEjF,UAAM,QAAQ;AAAA,MACZ,GAAG,WAAW;AAAA,QACZ,CAAC,GAAG,MACF,YAAY,CAAC,iBAAiB,QAAQ,CAAC,CAAC;AAAA,MAC5C;AAAA,MACA,GAAG,SAAS;AAAA,MACZ,GAAI,QAAQ,SAAS,IACjB;AAAA,QACE;AAAA,MACF,IACA,CAAC;AAAA,IACP;AACA,sBAAkB;AAAA,MAChB,IAAI;AAAA,MACJ,MAAM;AAAA,QACJ,GAAI,QAAQ,WAAW,IAAI,EAAE,UAAU,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,QAAQ;AAAA,QAC3E;AAAA,QACA,GAAI,KAAK,UAAU,IAAI,EAAE,MAAM,KAAK,UAAU,EAAE,IAAI,CAAC;AAAA,MACvD;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/commands/ads/meta/rules.ts"],"sourcesContent":["import type { MetaAdRuleHistoryRow, MetaAdRuleRow } from \"@baker/api/ads-meta/adRules\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\n/**\n * Meta automated rules — reads. A rule is Meta's own automation: it runs on\n * Meta, on Meta's schedule, with no Baker involvement once created. Writes\n * (create / update / enable / disable / delete) stage like every Meta change\n * and live in `rule-writes.ts`.\n */\n\n/** What an agent needs to pick a rule and know what it does. Specs sit behind --full. */\nexport function compactRule(row: MetaAdRuleRow): Record<string, unknown> {\n return {\n id: row.id,\n name: row.name,\n status: row.status,\n does: row.description,\n ...(row.disable_error_code ? { disable_error_code: row.disable_error_code } : {}),\n updated_time: row.updated_time,\n };\n}\n\nexport function ruleListHints(rows: readonly MetaAdRuleRow[]): string[] {\n const hints: string[] = [];\n if (rows.length === 0) {\n hints.push(\n 'No automated rules on this account. Stage one with `baker ads meta rules create --name … --apply-to ad --when \"cost_per_result>20\" --action pause`.',\n );\n }\n const issues = rows.filter((row) => row.status === \"HAS_ISSUES\");\n if (issues.length > 0) {\n hints.push(\n `${issues.map((row) => row.name ?? row.id).join(\", \")} ${issues.length === 1 ? \"has\" : \"have\"} been stopped by Meta (HAS_ISSUES) — read it with --rule-id and fix the spec with \\`rules update\\`.`,\n );\n }\n if (rows.length > 0) {\n hints.push(\n \"`rules history --rule-id <id>` shows what a rule did and when; `rules preview <id>` what it would act on now.\",\n );\n }\n return hints;\n}\n\nregisterSchema({\n command: \"ads.meta.rules\",\n description:\n \"List the automated rules on a Meta ad account (Ads Manager → Automated rules): each rule's status and what it does, in words. --rule-id reads one; --full adds its evaluation_spec, execution_spec and schedule_spec in the shape `rules update --file` takes (money in major units of the account currency).\",\n args: {\n \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\", required: false },\n \"rule-id\": { type: \"string\", description: \"Read one rule\", required: false },\n full: { type: \"boolean\", description: \"Include the specs and timestamps\", required: false },\n },\n});\n\nconst listCommand = defineCommand({\n meta: {\n name: \"list\",\n description:\n \"List automated rules. Runs by default. Example: baker ads meta rules --account-id act_123 · one rule in full: baker ads meta rules --rule-id 1132635173044914 --full\",\n },\n args: {\n \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n \"rule-id\": { type: \"string\", description: \"Read one rule\" },\n full: { type: \"boolean\", description: \"Include the specs and timestamps\" },\n },\n run: async ({ args }) => {\n const accountId = await resolveAccountIdArg(args);\n try {\n const params: Record<string, string> = { \"account-id\": accountId };\n if (args[\"rule-id\"]) params[\"rule-id\"] = String(args[\"rule-id\"]);\n const rows = await apiGet<MetaAdRuleRow[]>(\"/api/ads/meta/rules\", params);\n const full = Boolean(args.full) || Boolean(args[\"rule-id\"]);\n writeJsonEnvelope({ ok: true, data: full ? rows : rows.map(compactRule), hints: ruleListHints(rows) });\n } catch (err) {\n handleMetaError(err);\n }\n },\n});\n\n/** A run in a line an agent can read: when, which rule, and what it changed. */\nexport function compactHistory(row: MetaAdRuleHistoryRow): Record<string, unknown> {\n const changes = (row.results ?? []).flatMap((result) =>\n (result.actions ?? []).map((action) => ({\n object_id: result.object_id,\n action: action.action,\n ...(action.field ? { field: action.field } : {}),\n ...(action.old_value !== undefined ? { from: action.old_value } : {}),\n ...(action.new_value !== undefined ? { to: action.new_value } : {}),\n })),\n );\n return {\n timestamp: row.timestamp,\n rule_id: row.rule_id,\n ...(row.is_manual ? { manual: true } : {}),\n changes,\n ...(row.exception_message ? { error: row.exception_message } : {}),\n };\n}\n\nregisterSchema({\n command: \"ads.meta.rules.history\",\n description:\n \"What automated rules did and when: each run with the objects it changed (PAUSED, CHANGED_BUDGET, …, old → new value). Without --rule-id, every rule on the account, newest first.\",\n args: {\n \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\", required: false },\n \"rule-id\": { type: \"string\", description: \"One rule's runs\", required: false },\n \"object-id\": { type: \"string\", description: \"Only runs that touched this ad, ad set or campaign\", required: false },\n action: { type: \"string\", description: \"Only this action, e.g. PAUSED, CHANGED_BUDGET\", required: false },\n \"hide-no-changes\": { type: \"boolean\", description: \"Drop runs that changed nothing\", required: false },\n limit: { type: \"string\", description: \"Max runs (default 50)\", required: false },\n full: { type: \"boolean\", description: \"Include the rule's specs at each run\", required: false },\n },\n});\n\nconst historyCommand = defineCommand({\n meta: {\n name: \"history\",\n description:\n \"What rules did and when. Example: baker ads meta rules history --rule-id 1132635173044914 --hide-no-changes · every rule: baker ads meta rules history --account-id act_123\",\n },\n args: {\n \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n \"rule-id\": { type: \"string\", description: \"One rule's runs\" },\n \"object-id\": { type: \"string\", description: \"Only runs that touched this object\" },\n action: { type: \"string\", description: \"Only this action (PAUSED, CHANGED_BUDGET, …)\" },\n \"hide-no-changes\": { type: \"boolean\", description: \"Drop runs that changed nothing\" },\n limit: { type: \"string\", description: \"Max runs (default 50)\" },\n full: { type: \"boolean\", description: \"Include the rule's specs at each run\" },\n },\n run: async ({ args }) => {\n const accountId = await resolveAccountIdArg(args);\n try {\n const params: Record<string, string> = { \"account-id\": accountId };\n for (const key of [\"rule-id\", \"object-id\", \"action\", \"limit\"] as const) {\n if (args[key]) params[key] = String(args[key]);\n }\n if (args[\"hide-no-changes\"]) params[\"hide-no-changes\"] = \"true\";\n const rows = await apiGet<MetaAdRuleHistoryRow[]>(\"/api/ads/meta/rules/history\", params);\n const hints =\n rows.length === 0\n ? [\n \"No runs recorded. A daily rule first runs just after midnight in the ad account's time zone; a switched-off rule never runs.\",\n ]\n : [];\n writeJsonEnvelope({ ok: true, data: args.full ? rows : rows.map(compactHistory), hints });\n } catch (err) {\n handleMetaError(err);\n }\n },\n});\n\nregisterSchema({\n command: \"ads.meta.rules.preview\",\n description:\n \"Which ads, ad sets or campaigns a live schedule rule would act on right now, by Meta's own evaluation. Changes nothing.\",\n args: {\n id: { type: \"positional\", description: \"Rule id\", required: true },\n \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\", required: false },\n },\n});\n\nconst previewCommand = defineCommand({\n meta: {\n name: \"preview\",\n description:\n \"What a rule would act on right now (changes nothing). Example: baker ads meta rules preview 1132635173044914\",\n },\n args: {\n id: { type: \"positional\", description: \"Rule id\", required: true },\n \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n },\n run: async ({ args }) => {\n const accountId = await resolveAccountIdArg(args);\n try {\n const data = await apiGet<{ ruleId: string; matched: unknown[] }>(\"/api/ads/meta/rules/preview\", {\n \"account-id\": accountId,\n \"rule-id\": String(args.id),\n });\n const hints =\n data.matched.length === 0 ? [\"Nothing matches right now — the rule would change nothing if it ran now.\"] : [];\n writeJsonEnvelope({ ok: true, data, hints });\n } catch (err) {\n handleMetaError(err);\n }\n },\n});\n\nexport const rulesCommand = defineCommand({\n meta: {\n name: \"rules\",\n description: `Meta automated rules — Meta's own automation, which runs on Meta with no Baker involvement once created.\nUse one for a standing \"if this metric crosses that line, do X\" that needs no judgement; use a Baker scheduled agent when the call needs reasoning.\n\nExamples:\n baker ads meta rules --account-id act_123 # every rule, what it does\n baker ads meta rules --rule-id 1132635173044914 # one rule with its specs\n baker ads meta rules history --rule-id 1132635173044914 --hide-no-changes # what it did\n baker ads meta rules preview 1132635173044914 # what it would act on now\n baker ads meta rules create --name \"Stop expensive ads\" --apply-to ad --when \"cost_per_result>20\" --action pause\n baker ads meta rules update 1132635173044914 --name \"Stop very expensive ads\"\n baker ads meta rules disable|enable|delete 1132635173044914\n baker ads meta rules run 1132635173044914 # run it once, at publish`,\n },\n subCommands: {\n list: listCommand,\n history: historyCommand,\n preview: previewCommand,\n create: () => import(\"./rule-writes.ts\").then((m) => m.rulesCreateCommand),\n update: () => import(\"./rule-writes.ts\").then((m) => m.rulesUpdateCommand),\n enable: () => import(\"./rule-writes.ts\").then((m) => m.rulesEnableCommand),\n disable: () => import(\"./rule-writes.ts\").then((m) => m.rulesDisableCommand),\n delete: () => import(\"./rule-writes.ts\").then((m) => m.rulesDeleteCommand),\n run: () => import(\"./rule-writes.ts\").then((m) => m.rulesRunCommand),\n },\n args: {\n \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n \"rule-id\": { type: \"string\", description: \"Read one rule\" },\n full: { type: \"boolean\", description: \"Include the specs and timestamps\" },\n },\n default: \"list\",\n});\n"],"mappings":"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","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../api/src/ads-meta/adStudyDescription.ts","../src/commands/ads/meta/studies.ts"],"sourcesContent":["/**\n * A Meta A/B test in words — the one reading shared by the staged summary, the\n * draft review rows and the CLI, so all three say the same thing: what each\n * version runs and how much of the audience it gets, what decides the winner,\n * for how long, and how sure Meta has to be.\n */\nimport type { AdStudyCell, AdStudyObjective } from \"./adStudies\";\n\nexport interface AdStudyWordsInput {\n type?: string;\n start_time?: number;\n end_time?: number;\n confidence_level?: number;\n cells?: readonly Pick<\n AdStudyCell,\n \"name\" | \"treatment_percentage\" | \"control_percentage\" | \"adsets\" | \"campaigns\" | \"ads\"\n >[];\n objectives?: readonly AdStudyObjective[];\n}\n\nexport interface AdStudyWords {\n sentence: string;\n versions?: string;\n measuring: string;\n /** The measures besides the primary one, by name. */\n alsoMeasured?: string;\n schedule?: string;\n confidence?: string;\n}\n\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function adStudyTime(seconds: number): string {\n const date = new Date(seconds * 1000);\n const hh = String(date.getUTCHours()).padStart(2, \"0\");\n const mm = String(date.getUTCMinutes()).padStart(2, \"0\");\n return `${date.getUTCDate()} ${MONTHS[date.getUTCMonth()]} ${date.getUTCFullYear()}, ${hh}:${mm} UTC`;\n}\n\nfunction daysLabel(seconds: number): string {\n const days = Math.round((seconds / 86_400) * 10) / 10;\n return `${days} ${days === 1 ? \"day\" : \"days\"}`;\n}\n\nfunction quoted(id: string, names: Record<string, string>): string {\n const name = names[id];\n return name ? `\"${name}\"` : id;\n}\n\nfunction cellWords(\n cell: Pick<AdStudyCell, \"name\" | \"treatment_percentage\" | \"control_percentage\" | \"adsets\" | \"campaigns\" | \"ads\">,\n names: Record<string, string>,\n): string {\n const [noun, ids] = cell.ads\n ? [\"ad\", cell.ads]\n : cell.adsets\n ? [\"ad set\", cell.adsets]\n : [\"campaign\", cell.campaigns ?? []];\n const plural = ids.length > 1 ? `${noun}s` : noun;\n const runs = ids.length > 0 ? ` (${plural} ${ids.map((id) => quoted(id, names)).join(\", \")})` : \"\";\n const share =\n cell.control_percentage === undefined\n ? `${cell.treatment_percentage}%`\n : `${cell.treatment_percentage}% see the ads, ${cell.control_percentage}% held out`;\n return `${cell.name}${runs} ${share}`;\n}\n\nconst STUDY_KIND: Record<string, string> = {\n SPLIT_TEST: \"Split test\",\n LIFT: \"Lift study\",\n SPLIT_TEST_V2: \"Creative test\",\n};\n\nfunction primaryObjective(objectives: readonly AdStudyObjective[] | undefined): AdStudyObjective | undefined {\n if (!objectives || objectives.length === 0) {\n return undefined;\n }\n return objectives.find((objective) => objective.is_primary === true) ?? objectives[0];\n}\n\nconst SOURCE_NOUN: Record<\"adspixels\" | \"applications\" | \"offsite_datasets\", string> = {\n adspixels: \"pixel\",\n applications: \"app\",\n offsite_datasets: \"dataset\",\n};\n\n/** \"Lead on pixel \"Site\"\", one per event source. */\nfunction sourceWords(objective: AdStudyObjective, names: Record<string, string>): string[] {\n const words: string[] = [];\n for (const key of [\"adspixels\", \"applications\", \"offsite_datasets\"] as const) {\n for (const source of objective[key] ?? []) {\n const events = source.event_names?.join(\" or \") ?? \"any event\";\n words.push(`${events} on ${SOURCE_NOUN[key]} ${quoted(source.id, names)}`);\n }\n }\n for (const source of objective.customconversions ?? []) {\n words.push(`custom conversion ${quoted(source.id, names)}`);\n }\n return words;\n}\n\n/** What decides the winner. Meta's split test compares cost per result of the primary measure. */\nfunction measuringWords(objectives: readonly AdStudyObjective[] | undefined, names: Record<string, string>): string {\n const primary = primaryObjective(objectives);\n if (!primary) {\n return \"cost per result on the campaigns' objective\";\n }\n const sources = sourceWords(primary, names);\n return `cost per \"${primary.name}\"${sources.length > 0 ? ` (${sources.join(\", \")})` : \"\"}`;\n}\n\n/** What the sentence says the study measures: a lift study reads the lift, a test the cost per result. */\nfunction measuringPhrase(type: string | undefined, primary: AdStudyObjective | undefined, measuring: string): string {\n if (type === \"LIFT\") return `measuring the lift in ${primary ? `\"${primary.name}\"` : \"results\"}`;\n return `measuring ${primary ? `cost per \"${primary.name}\"` : measuring}`;\n}\n\nexport function describeAdStudy(\n study: AdStudyWordsInput,\n { names = {} }: { names?: Record<string, string> } = {},\n): AdStudyWords {\n const versions =\n study.cells && study.cells.length > 0 ? study.cells.map((cell) => cellWords(cell, names)).join(\" vs \") : undefined;\n const measuring = measuringWords(study.objectives, names);\n const primary = primaryObjective(study.objectives);\n const others = (study.objectives ?? []).filter((objective) => objective !== primary);\n const alsoMeasured = others.length > 0 ? others.map((objective) => `\"${objective.name}\"`).join(\", \") : undefined;\n const hasSchedule = study.start_time !== undefined && study.end_time !== undefined;\n const length = hasSchedule ? daysLabel((study.end_time ?? 0) - (study.start_time ?? 0)) : undefined;\n const schedule = hasSchedule\n ? `${adStudyTime(study.start_time ?? 0)} → ${adStudyTime(study.end_time ?? 0)} · ${length}`\n : undefined;\n const confidence = study.confidence_level !== undefined ? `${Math.round(study.confidence_level * 100)}%` : undefined;\n const parts = [\n versions,\n measuringPhrase(study.type, primary, measuring),\n length,\n confidence ? `${confidence} confidence` : undefined,\n ].filter((part): part is string => part !== undefined);\n const kind = STUDY_KIND[study.type ?? \"SPLIT_TEST\"] ?? \"Split test\";\n return { sentence: `${kind}: ${parts.join(\", \")}`, versions, measuring, alsoMeasured, schedule, confidence };\n}\n","import { adStudyFromWire, cellObjects, unixSeconds } from \"@baker/api/ads-meta/adStudies\";\nimport { adStudyTime, describeAdStudy } from \"@baker/api/ads-meta/adStudyDescription\";\nimport { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\n/**\n * Meta A/B tests (ad studies) — reads. A test splits one audience between\n * versions (ad sets, campaigns, or a creative test's ads) so each person sees one, and Meta calls the\n * winner. Writes (create / update / end / delete) stage like every Meta change\n * and live in `study-writes.ts`.\n */\n\ntype Row = Record<string, unknown>;\n\nexport type StudyState = \"scheduled\" | \"running\" | \"ended\" | \"cancelled\";\n\nexport function studyState(row: Row, nowSeconds: number): StudyState {\n if (row.canceled_time) return \"cancelled\";\n const start = unixSeconds(row.start_time) ?? 0;\n const end = unixSeconds(row.end_time) ?? Number.POSITIVE_INFINITY;\n if (nowSeconds < start) return \"scheduled\";\n return nowSeconds < end ? \"running\" : \"ended\";\n}\n\n/** What an agent needs to pick a test and know what it compares. The raw node sits behind --full. */\nexport function compactStudy(row: Row, nowSeconds: number): Row {\n const study = adStudyFromWire(row);\n const words = describeAdStudy(study, { names: study.names });\n return {\n id: study.id,\n name: study.name,\n state: studyState(row, nowSeconds),\n compares: words.versions,\n ...(study.start_time !== undefined ? { starts: adStudyTime(study.start_time) } : {}),\n ...(study.end_time !== undefined ? { ends: adStudyTime(study.end_time) } : {}),\n ...(row.results_first_available_date ? { results_from: row.results_first_available_date } : {}),\n };\n}\n\n/** One test in full: each version with its cell id (what `studies update --split` names), each measure with Meta's results. */\nexport function studyDetail(row: Row, nowSeconds: number): Row {\n const study = adStudyFromWire(row);\n const measures = ((row.objectives as { data?: Row[] } | undefined)?.data ?? []).map((objective) => ({\n id: objective.id,\n name: objective.name,\n primary: objective.is_primary === true,\n ...(objective.results !== undefined ? { results: objective.results } : {}),\n }));\n return {\n ...compactStudy(row, nowSeconds),\n ...(study.description ? { description: study.description } : {}),\n versions: study.cells.map((cell) => ({\n cell_id: cell.id,\n name: cell.name,\n share: `${cell.treatment_percentage}%`,\n runs: cellObjects(cell).map((id) => ({ id, name: study.names[id] })),\n level: cell.ads ? \"ad\" : cell.adsets ? \"ad set\" : \"campaign\",\n })),\n measures,\n };\n}\n\nexport function studyHints(detail: Row): string[] {\n const state = detail.state as StudyState;\n if (state === \"scheduled\") {\n return [\n \"Not started: it can still be re-timed, re-split (`studies update --split <cell_id>=60 …`) or deleted. Results appear once it runs.\",\n ];\n }\n const measures = (detail.measures as Row[] | undefined) ?? [];\n const hasResults = measures.some((measure) => measure.results !== undefined);\n return [\n hasResults\n ? \"Meta's verdict is in each measure's results, with its confidence. Report a winner only when Meta names one at the test's confidence level; otherwise say the versions performed alike.\"\n : \"No results yet — Meta publishes them once the test has gathered enough. Compare per-version delivery meanwhile with `baker ads meta insights --object <ad set or campaign id>`, and do not call a winner from it.\",\n state === \"running\"\n ? \"Running: its split and start are fixed; it can be renamed, its end moved, ended now (`studies end`) or deleted (results and all).\"\n : \"Over. Read the per-version numbers with `baker ads meta insights --object <id>` for the period it ran.\",\n ];\n}\n\nregisterSchema({\n command: \"ads.meta.studies\",\n description:\n \"Meta A/B tests (ad studies) whose versions run in an ad account — what each compares, when it runs and its state (scheduled, running, ended). --study-id reads one: every version with its cell id and share, and each measure with Meta's results. --business-id lists every test on a Business. Stage new ones with `studies create`.\",\n args: {\n \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\", required: false },\n \"business-id\": { type: \"string\", description: \"List every test on this Business instead\", required: false },\n \"study-id\": { type: \"string\", description: \"One test: its versions and results\", required: false },\n full: { type: \"boolean\", description: \"The tests as Meta returns them\", required: false },\n \"no-cache\": { type: \"boolean\", description: \"Bypass the cache\", required: false },\n },\n});\n\nconst listArgs = {\n \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n \"business-id\": { type: \"string\", description: \"List every test on this Business instead\" },\n \"study-id\": { type: \"string\", description: \"Read one test: versions, cell ids, results\" },\n full: { type: \"boolean\", description: \"The tests as Meta returns them\" },\n \"no-cache\": NO_CACHE_ARG,\n} as const;\n\nasync function read<T>(path: string, params: Record<string, string>, noCache: unknown): Promise<T> {\n if (noCache) params[\"skip-cache\"] = \"true\";\n return await apiGet<T>(path, params);\n}\n\nconst listCommand = defineCommand({\n meta: {\n name: \"list\",\n description:\n \"List A/B tests. Runs by default. Example: baker ads meta studies --account-id act_123 · one test: baker ads meta studies --study-id 6123\",\n },\n args: listArgs,\n run: async ({ args }) => {\n const now = Math.floor(Date.now() / 1000);\n try {\n if (args[\"study-id\"]) {\n const row = await read<Row>(\n \"/api/ads/meta/study-results\",\n { \"study-id\": String(args[\"study-id\"]) },\n args[\"no-cache\"],\n );\n const detail = studyDetail(row, now);\n writeJsonEnvelope({ ok: true, data: args.full ? row : detail, hints: studyHints(detail) });\n return;\n }\n const params: Record<string, string> = args[\"business-id\"]\n ? { \"business-id\": String(args[\"business-id\"]) }\n : { \"account-id\": await resolveAccountIdArg(args) };\n const rows = await read<Row[]>(\"/api/ads/meta/studies\", params, args[\"no-cache\"]);\n const hints =\n rows.length === 0\n ? [\n \"No A/B tests. To set one up: duplicate the ad set (`adsets duplicate`), change ONE thing on the copy, then `studies create --adsets <original>,<copy>`.\",\n ]\n : [\"`studies --study-id <id>` reads one test's versions and results.\"];\n writeJsonEnvelope({ ok: true, data: args.full ? rows : rows.map((row) => compactStudy(row, now)), hints });\n } catch (err) {\n handleMetaError(err);\n }\n },\n});\n\nexport const studiesCommand = defineCommand({\n meta: {\n name: \"studies\",\n description: `Meta A/B tests (ad studies): Meta splits one audience between versions — ad sets or campaigns — so each person sees one, and calls the winner.\nNot Baker's own page experiments (\\`baker experiment\\`), which test landing pages.\n\nExamples:\n baker ads meta studies --account-id act_123 # tests on this account and their state\n baker ads meta studies --study-id 6123 # versions, cell ids, Meta's results\n baker ads meta studies create --name \"Broad vs lookalike\" --adsets 6123,6124 --start 2026-10-20T08:00Z --days 14 --confidence 90\n baker ads meta studies update 6123 --end 2026-11-10T08:00Z\n baker ads meta studies end 6123 | delete 6123`,\n },\n subCommands: {\n list: listCommand,\n create: () => import(\"./study-writes.ts\").then((m) => m.studiesCreateCommand),\n update: () => import(\"./study-writes.ts\").then((m) => m.studiesUpdateCommand),\n end: () => import(\"./study-writes.ts\").then((m) => m.studiesEndCommand),\n delete: () => import(\"./study-writes.ts\").then((m) => m.studiesDeleteCommand),\n },\n args: listArgs,\n default: \"list\",\n});\n"],"mappings":"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","names":[]}
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|