@koda-sl/baker-cli 0.526.0 → 0.528.0

package/dist/{meta-H3KBPU33.js → meta-MOSJVYIE.js}

@@ -77,46 +77,46 @@ Audit & review:
 Full guide: __tooling__/docs/tools/baker/ads-meta.md`
   },
   subCommands: {
-    accounts: () => import("./accounts-VIAQC3PA.js").then((m) => m.accountsCommand),
-    account: () => import("./account-APMJVG2F.js").then((m) => m.accountCommand),
-    businesses: () => import("./businesses-CW4RB36R.js").then((m) => m.businessesCommand),
-    pages: () => import("./pages-XJF3FBOJ.js").then((m) => m.pagesCommand),
-    "lead-forms": () => import("./leads-QBWR7FKT.js").then((m) => m.leadFormsCommand),
-    "instant-experiences": () => import("./instant-experiences-NMJUWNP3.js").then((m) => m.instantExperiencesCommand),
-    leads: () => import("./leads-QBWR7FKT.js").then((m) => m.leadsCommand),
-    campaigns: () => import("./campaigns-IQYYYD2S.js").then((m) => m.campaignsCommand),
-    adsets: () => import("./adsets-VO5C7PDM.js").then((m) => m.adsetsCommand),
-    ads: () => import("./ads-NNKUR4HG.js").then((m) => m.adsListCommand),
-    creatives: () => import("./creatives-GTRQAZSB.js").then((m) => m.creativesCommand),
-    audiences: () => import("./audiences-TQ5ZEWIR.js").then((m) => m.audiencesCommand),
-    "custom-conversions": () => import("./custom-conversions-VQ3LBWYV.js").then((m) => m.customConversionsCommand),
-    pixels: () => import("./pixels-AZCIWWXK.js").then((m) => m.pixelsCommand),
-    activities: () => import("./activities-MJMAV3SI.js").then((m) => m.activitiesCommand),
-    insights: () => import("./insights-INIFHYR7.js").then((m) => m.insightsCommand),
-    preview: () => import("./preview-BIEVHIDJ.js").then((m) => m.previewCommand),
-    targeting: () => import("./targeting-YBIWD27C.js").then((m) => m.targetingCommand),
-    "instagram-accounts": () => import("./account-assets-TAUEBCY5.js").then((m) => m.instagramAccountsCommand),
-    apps: () => import("./account-assets-TAUEBCY5.js").then((m) => m.appsCommand),
-    "dsa-recommendations": () => import("./account-assets-TAUEBCY5.js").then((m) => m.dsaRecommendationsCommand),
-    images: () => import("./account-assets-TAUEBCY5.js").then((m) => m.imagesCommand),
-    labels: () => import("./account-assets-TAUEBCY5.js").then((m) => m.labelsCommand),
-    studies: () => import("./studies-Z2ZIWLTO.js").then((m) => m.studiesCommand),
-    catalogs: () => import("./catalogs-PLBY32BE.js").then((m) => m.catalogsCommand),
-    "page-photos": () => import("./page-photos-SHIGXDYE.js").then((m) => m.pagePhotosCommand),
-    "page-posts": () => import("./account-level-2MYDHOID.js").then((m) => m.pagePostsCommand),
-    "instagram-media": () => import("./account-level-2MYDHOID.js").then((m) => m.instagramMediaCommand),
-    comments: () => import("./account-level-2MYDHOID.js").then((m) => m.commentsCommand),
-    "account-settings": () => import("./account-level-2MYDHOID.js").then((m) => m.accountSettingsCommand),
-    "account-details": () => import("./account-level-2MYDHOID.js").then((m) => m.accountDetailsCommand),
-    "block-lists": () => import("./account-level-2MYDHOID.js").then((m) => m.blockListsCommand),
-    "reach-frequency": () => import("./account-level-2MYDHOID.js").then((m) => m.reachFrequencyCommand),
-    "high-demand-periods": () => import("./account-assets-TAUEBCY5.js").then((m) => m.highDemandPeriodsCommand),
-    rules: () => import("./rules-FJHYG4SJ.js").then((m) => m.rulesCommand),
-    media: () => import("./media-23IW442U.js").then((m) => m.metaMediaCommand),
-    draft: () => import("./draft-ME4TNPO7.js").then((m) => m.metaDraftCommand)
+    accounts: () => import("./accounts-KRW3JNCW.js").then((m) => m.accountsCommand),
+    account: () => import("./account-CQJFUII3.js").then((m) => m.accountCommand),
+    businesses: () => import("./businesses-DXRDQIFP.js").then((m) => m.businessesCommand),
+    pages: () => import("./pages-BAUS7LQM.js").then((m) => m.pagesCommand),
+    "lead-forms": () => import("./leads-CJKRKB2Q.js").then((m) => m.leadFormsCommand),
+    "instant-experiences": () => import("./instant-experiences-6F6GXZ67.js").then((m) => m.instantExperiencesCommand),
+    leads: () => import("./leads-CJKRKB2Q.js").then((m) => m.leadsCommand),
+    campaigns: () => import("./campaigns-GQWFSKGC.js").then((m) => m.campaignsCommand),
+    adsets: () => import("./adsets-FN5ZWSYF.js").then((m) => m.adsetsCommand),
+    ads: () => import("./ads-JVBLNTBF.js").then((m) => m.adsListCommand),
+    creatives: () => import("./creatives-6VJDUHEY.js").then((m) => m.creativesCommand),
+    audiences: () => import("./audiences-JAVNJ5NC.js").then((m) => m.audiencesCommand),
+    "custom-conversions": () => import("./custom-conversions-NDY5RHSM.js").then((m) => m.customConversionsCommand),
+    pixels: () => import("./pixels-QOSEYXCP.js").then((m) => m.pixelsCommand),
+    activities: () => import("./activities-2RAJXP3J.js").then((m) => m.activitiesCommand),
+    insights: () => import("./insights-IVW6W5CP.js").then((m) => m.insightsCommand),
+    preview: () => import("./preview-X6EJGPAY.js").then((m) => m.previewCommand),
+    targeting: () => import("./targeting-7HXKBXWY.js").then((m) => m.targetingCommand),
+    "instagram-accounts": () => import("./account-assets-IDVG4DGK.js").then((m) => m.instagramAccountsCommand),
+    apps: () => import("./account-assets-IDVG4DGK.js").then((m) => m.appsCommand),
+    "dsa-recommendations": () => import("./account-assets-IDVG4DGK.js").then((m) => m.dsaRecommendationsCommand),
+    images: () => import("./account-assets-IDVG4DGK.js").then((m) => m.imagesCommand),
+    labels: () => import("./account-assets-IDVG4DGK.js").then((m) => m.labelsCommand),
+    studies: () => import("./studies-IGOCWM7F.js").then((m) => m.studiesCommand),
+    catalogs: () => import("./catalogs-TBRONC2D.js").then((m) => m.catalogsCommand),
+    "page-photos": () => import("./page-photos-4JTIKXAW.js").then((m) => m.pagePhotosCommand),
+    "page-posts": () => import("./account-level-GK7M2MMQ.js").then((m) => m.pagePostsCommand),
+    "instagram-media": () => import("./account-level-GK7M2MMQ.js").then((m) => m.instagramMediaCommand),
+    comments: () => import("./account-level-GK7M2MMQ.js").then((m) => m.commentsCommand),
+    "account-settings": () => import("./account-level-GK7M2MMQ.js").then((m) => m.accountSettingsCommand),
+    "account-details": () => import("./account-level-GK7M2MMQ.js").then((m) => m.accountDetailsCommand),
+    "block-lists": () => import("./account-level-GK7M2MMQ.js").then((m) => m.blockListsCommand),
+    "reach-frequency": () => import("./account-level-GK7M2MMQ.js").then((m) => m.reachFrequencyCommand),
+    "high-demand-periods": () => import("./account-assets-IDVG4DGK.js").then((m) => m.highDemandPeriodsCommand),
+    rules: () => import("./rules-HLREXY2M.js").then((m) => m.rulesCommand),
+    media: () => import("./media-HDHZULQ7.js").then((m) => m.metaMediaCommand),
+    draft: () => import("./draft-G432FJ7N.js").then((m) => m.metaDraftCommand)
   }
 });
 export {
   metaCommand
 };
-//# sourceMappingURL=meta-H3KBPU33.js.map
+//# sourceMappingURL=meta-MOSJVYIE.js.map

package/dist/{page-photos-SHIGXDYE.js → page-photos-4JTIKXAW.js}

@@ -3,10 +3,10 @@ import {
   failWriteValidation,
   requireTarget,
   stageOp
-} from "./chunk-OEJNZSJG.js";
+} from "./chunk-4XXA4WCS.js";
 import "./chunk-GC5P4KWY.js";
 import "./chunk-GDFJOCDO.js";
-import "./chunk-HPAGYPAF.js";
+import "./chunk-BN4TDL5L.js";
 import "./chunk-ERSX3MKH.js";
 import "./chunk-WPAW6EVY.js";
 import "./chunk-4NZ47VXO.js";
@@ -64,7 +64,7 @@ Then: baker ads meta instant-experiences create --page-id 904238019441800 --phot
     await stageOp(
       {
         kind: "pagePhoto.create",
-        accountId: bareAccountId(args),
+        accountId: await bareAccountId(args),
         payload: {
           page_id: args["page-id"],
           bakerImageId: args["image-id"],
@@ -97,7 +97,7 @@ Example: baker ads meta page-photos delete 122142489045161003 --account-id act_1
   run: async ({ args }) => {
     await stageOp({
       kind: "pagePhoto.update",
-      accountId: bareAccountId(args),
+      accountId: await bareAccountId(args),
       target: requireTarget(args, "Page photo"),
       payload: { status: "DELETED" }
     });
@@ -115,4 +115,4 @@ var pagePhotosCommand = defineCommand({
 export {
   pagePhotosCommand
 };
-//# sourceMappingURL=page-photos-SHIGXDYE.js.map
+//# sourceMappingURL=page-photos-4JTIKXAW.js.map

package/dist/page-photos-4JTIKXAW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/page-photos.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { bareAccountId, failWriteValidation, requireTarget, stageOp } from \"./write-shared.ts\";\n\n/**\n * Photos put on a Facebook Page without posting them — what an Instant\n * Experience's photo element takes, and what a collection ad's four-photo\n * experience is built from. Needs the Page posts permission for Meta.\n */\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\ntype Args = Record<string, unknown>;\n\nregisterSchema({\n  command: \"ads.meta.page-photos.upload\",\n  description:\n    \"Stage a photo upload to a Facebook Page, NOT posted to its timeline, made at publish — for Instant Experience photo elements (`instant-experiences create --photo-id <ref>`). Needs the Page posts permission for Meta.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"Ad account the change is staged under\", required: false },\n    \"page-id\": { type: \"string\", description: \"The Facebook Page\", required: true },\n    \"image-id\": { type: \"string\", description: \"Baker library image id\", required: false },\n    url: { type: \"string\", description: \"Or a public https picture address\", required: false },\n    caption: { type: \"string\", description: \"Caption kept with the photo (never posted)\", required: false },\n  },\n});\n\nconst uploadCommand = defineCommand({\n  meta: {\n    name: \"upload\",\n    description: `Put a photo on a Facebook Page without posting it. ${STAGED_NOTE}\nExample: baker ads meta page-photos upload --account-id act_123 --page-id 904238019441800 --image-id <library image id>\nThen: baker ads meta instant-experiences create --page-id 904238019441800 --photo-id meta_temp_… …`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    \"page-id\": { type: \"string\", description: \"The Facebook Page — from `baker ads meta pages`\" },\n    \"image-id\": { type: \"string\", description: \"Baker library image id (`baker images library …`)\" },\n    url: { type: \"string\", description: \"Or a public https picture address Meta can fetch\" },\n    caption: { type: \"string\", description: \"Caption kept with the photo; it is never posted\" },\n  },\n  run: async ({ args }) => {\n    if (!args[\"image-id\"] && !args.url) failWriteValidation(\"pass --image-id (a library image) or --url\");\n    await stageOp(\n      {\n        kind: \"pagePhoto.create\",\n        accountId: await bareAccountId(args as Args),\n        payload: {\n          page_id: args[\"page-id\"],\n          bakerImageId: args[\"image-id\"],\n          url: args.url,\n          caption: args.caption,\n        },\n      },\n      [\"Use it in an Instant Experience with `instant-experiences create --photo-id <ref>`.\"],\n    );\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.page-photos.delete\",\n  description: \"Stage deleting a photo from a Facebook Page. An Instant Experience already made with it keeps it.\",\n  args: {\n    id: { type: \"positional\", description: \"Page photo id\", required: true },\n    \"account-id\": { type: \"string\", description: \"Ad account the change is staged under\", required: false },\n  },\n});\n\nconst deleteCommand = defineCommand({\n  meta: {\n    name: \"delete\",\n    description: `Delete a photo from its Facebook Page. ${STAGED_NOTE}\nExample: baker ads meta page-photos delete 122142489045161003 --account-id act_123`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Page photo id\", required: true },\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n  },\n  run: async ({ args }) => {\n    await stageOp({\n      kind: \"pagePhoto.update\",\n      accountId: await bareAccountId(args as Args),\n      target: requireTarget(args as Args, \"Page photo\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\nexport const pagePhotosCommand = defineCommand({\n  meta: {\n    name: \"page-photos\",\n    description: `Photos on a Facebook Page that are never posted — for Instant Experiences and collection ads. Needs the Page posts permission for Meta.\n  baker ads meta page-photos upload --page-id <id> --image-id <library id>\n  baker ads meta page-photos delete <photo id>`,\n  },\n  subCommands: { upload: uploadCommand, delete: deleteCommand },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAU9B,IAAM,cAAc;AAGpB,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,IACtG,WAAW,EAAE,MAAM,UAAU,aAAa,qBAAqB,UAAU,KAAK;AAAA,IAC9E,YAAY,EAAE,MAAM,UAAU,aAAa,0BAA0B,UAAU,MAAM;AAAA,IACrF,KAAK,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,IACzF,SAAS,EAAE,MAAM,UAAU,aAAa,8CAA8C,UAAU,MAAM;AAAA,EACxG;AACF,CAAC;AAED,IAAM,gBAAgB,cAAc;AAAA,EAClC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,sDAAsD,WAAW;AAAA;AAAA;AAAA,EAGhF;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IAC3E,WAAW,EAAE,MAAM,UAAU,aAAa,uDAAkD;AAAA,IAC5F,YAAY,EAAE,MAAM,UAAU,aAAa,yDAAoD;AAAA,IAC/F,KAAK,EAAE,MAAM,UAAU,aAAa,mDAAmD;AAAA,IACvF,SAAS,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,EAC5F;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI,CAAC,KAAK,UAAU,KAAK,CAAC,KAAK,IAAK,qBAAoB,4CAA4C;AACpG,UAAM;AAAA,MACJ;AAAA,QACE,MAAM;AAAA,QACN,WAAW,MAAM,cAAc,IAAY;AAAA,QAC3C,SAAS;AAAA,UACP,SAAS,KAAK,SAAS;AAAA,UACvB,cAAc,KAAK,UAAU;AAAA,UAC7B,KAAK,KAAK;AAAA,UACV,SAAS,KAAK;AAAA,QAChB;AAAA,MACF;AAAA,MACA,CAAC,qFAAqF;AAAA,IACxF;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,iBAAiB,UAAU,KAAK;AAAA,IACvE,cAAc,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,EACxG;AACF,CAAC;AAED,IAAM,gBAAgB,cAAc;AAAA,EAClC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,0CAA0C,WAAW;AAAA;AAAA,EAEpE;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,iBAAiB,UAAU,KAAK;AAAA,IACvE,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,EAC7E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,QAAQ;AAAA,MACZ,MAAM;AAAA,MACN,WAAW,MAAM,cAAc,IAAY;AAAA,MAC3C,QAAQ,cAAc,MAAc,YAAY;AAAA,MAChD,SAAS,EAAE,QAAQ,UAAU;AAAA,IAC/B,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA,EAGf;AAAA,EACA,aAAa,EAAE,QAAQ,eAAe,QAAQ,cAAc;AAC9D,CAAC;","names":[]}

package/dist/{pages-XJF3FBOJ.js → pages-BAUS7LQM.js}

@@ -1,7 +1,7 @@
 import {
   csvOrJson,
   handleMetaError
-} from "./chunk-HPAGYPAF.js";
+} from "./chunk-BN4TDL5L.js";
 import "./chunk-QALAJNBG.js";
 import {
   writeAdsOutput,
@@ -64,4 +64,4 @@ export {
   pageSelectionHints,
   pagesCommand
 };
-//# sourceMappingURL=pages-XJF3FBOJ.js.map
+//# sourceMappingURL=pages-BAUS7LQM.js.map

package/dist/{performance-L3Q57H4H.js → performance-6XFKDJGY.js}

@@ -2257,6 +2257,7 @@ function compactEntityRow(row) {
       budgetDaily: row.budgetDaily === null ? null : roundNumber(row.budgetDaily),
       budgetLifetime: row.budgetLifetime === null ? null : roundNumber(row.budgetLifetime)
     }),
+    ...compactServing(row.serving),
     metrics: compactMetrics(row.metrics),
     ratios: compactRatios(row.ratios),
     ...entityPath(row) ? { path: entityPath(row) } : {},
@@ -2267,6 +2268,14 @@ function compactEntityRow(row) {
     ...compactSearchParts(row)
   };
 }
+function compactServing(serving) {
+  if (!serving) return {};
+  const { children } = serving;
+  return {
+    serving: serving.state,
+    ...children ? { below: { level: children.level, total: children.total, on: children.active, live: children.live } } : {}
+  };
+}
 function compactSearchParts(row) {
   return {
     ...dropEmpty({ campaignKind: row.campaignKind, segment: row.segment }),
@@ -5302,7 +5311,7 @@ var overviewCommand = report({
 var entitiesCommand = report({
   name: "entities",
   schemaName: "entities",
-  schemaDescription: `Campaigns, ad groups / ad sets, ads or keywords across platforms, ranked (default by spend), with metrics, budget, first delivery (beforeHistory: it ran before the stored history starts) and peer shares against its parent. Paged with --limit/--offset; totalRows counts every match. ${STORE_NOTE}`,
+  schemaDescription: `Campaigns, ad groups / ad sets, ads or keywords across platforms, ranked (default by spend), with metrics, budget, first delivery (beforeHistory: it ran before the stored history starts) and peer shares against its parent. status is its own switch; serving says whether it really delivers given its parents and children (campaign_off, ad_group_off, off, no_children, children_off) and below counts a campaign's or ad set's children (on, live). Paged with --limit/--offset; totalRows counts every match. ${STORE_NOTE}`,
   help: "Campaigns, ad groups, ads or keywords ranked. Example: baker ads performance entities --level ad --sort cost_per_result --order asc",
   path: "entities",
   args: ENTITIES_ARGS,
@@ -5553,4 +5562,4 @@ Full guide: __tooling__/docs/tools/baker/ads-performance.md`
 export {
   performanceCommand
 };
-//# sourceMappingURL=performance-L3Q57H4H.js.map
+//# sourceMappingURL=performance-6XFKDJGY.js.map