@koda-sl/baker-cli 0.525.0 → 0.527.0

package/dist/instant-experiences-6F6GXZ67.js

@@ -0,0 +1,260 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  loadJsonFileArg,
+  mergePayload,
+  requireTarget,
+  stageOp
+} from "./chunk-4XXA4WCS.js";
+import "./chunk-GC5P4KWY.js";
+import "./chunk-GDFJOCDO.js";
+import {
+  csvOrJson,
+  handleMetaError
+} from "./chunk-BN4TDL5L.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-WPAW6EVY.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-FBG3JDET.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-HPDGVK6R.js";
+import "./chunk-V2XEX2YR.js";
+import "./chunk-O37YK4P6.js";
+import "./chunk-6B4KNOJZ.js";
+import "./chunk-ZVXKWLLE.js";
+import "./chunk-EHIISZYD.js";
+import "./chunk-SWNCS2OD.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import {
+  apiGet
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/instant-experiences.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+var ELEMENT_FLAGS = ["text", "button", "photo-id", "video-id", "video-ref", "product-set-id", "footer"];
+function linkPair(flag, value) {
+  const [text, ...rest] = value.split("=>");
+  const url = rest.join("=>").trim();
+  if (!text?.trim() || !url) {
+    failWriteValidation(`--${flag} takes "Button text => https://\u2026" \u2014 got "${value}"`);
+  }
+  return { text: text.trim(), url };
+}
+function elementFor(flag, value) {
+  switch (flag) {
+    case "text":
+      return { type: "text", text: value };
+    case "button":
+      return { type: "button", ...linkPair(flag, value) };
+    case "footer":
+      return { type: "footer", ...linkPair(flag, value) };
+    case "photo-id":
+      return { type: "photo", photo_id: value };
+    case "video-id":
+      return { type: "video", video_id: value };
+    case "video-ref":
+      return { type: "video", videoRef: value };
+    default:
+      return { type: "product_set", product_set_id: value };
+  }
+}
+function elementFlagOf(arg) {
+  if (!arg.startsWith("--")) return void 0;
+  const eq = arg.indexOf("=");
+  const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
+  const flag = ELEMENT_FLAGS.find((candidate) => candidate === name);
+  if (!flag) return void 0;
+  return eq === -1 ? { flag } : { flag, inline: arg.slice(eq + 1) };
+}
+function canvasElementsFromRawArgs(rawArgs) {
+  const elements = [];
+  const end = rawArgs.indexOf("--");
+  const args = end === -1 ? rawArgs : rawArgs.slice(0, end);
+  for (let i = 0; i < args.length; i++) {
+    const found = elementFlagOf(args[i] ?? "");
+    if (!found) continue;
+    const value = found.inline ?? args[++i];
+    if (value === void 0 || value.startsWith("--")) failWriteValidation(`--${found.flag} needs a value`);
+    elements.push(elementFor(found.flag, value));
+  }
+  return elements;
+}
+registerSchema({
+  command: "ads.meta.instant-experiences",
+  description: "A Facebook Page's Instant Experiences \u2014 the full-screen pages an ad can open (creatives create --type instant_experience --canvas-id). Shows whether each is published: an ad opens only a published one.",
+  args: {
+    "page-id": { type: "string", description: "Facebook Page id (baker ads meta pages)", required: true },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "A Page's Instant Experiences, published or not. Runs by default. Example: baker ads meta instant-experiences --page-id 904238019441800"
+  },
+  args: {
+    "page-id": { type: "string", description: "Facebook Page id \u2014 from `baker ads meta pages`" },
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    if (!args["page-id"]) failWriteValidation("pass --page-id (from `baker ads meta pages`)");
+    try {
+      const rows = await apiGet("/api/ads/meta/instant-experiences", {
+        "page-id": String(args["page-id"])
+      });
+      const hints = rows.length === 0 ? ["This Page has no Instant Experiences. Stage one with `baker ads meta instant-experiences create`."] : [
+        "An ad opens only a published experience (is_published true): `creatives create --type instant_experience --canvas-id <id>`. A published one cannot be changed or deleted."
+      ];
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(rows, fmt, void 0, hints);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data: rows, hints });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.instant-experiences.create",
+  description: "Stage a new Instant Experience on a Page \u2014 its elements in command-line order \u2014 made (and published, unless --unpublished) when the chat publishes. Meta deletes no experience, so it is only ever made at publish.",
+  args: {
+    "account-id": { type: "string", description: "Ad account the change is staged under", required: false },
+    "page-id": { type: "string", description: "The Facebook Page it belongs to", required: true },
+    name: { type: "string", description: "Name in the Page's Instant Experience library", required: true },
+    text: { type: "string", description: "A paragraph, repeatable", required: false },
+    button: { type: "string", description: '"Text => https://\u2026", repeatable', required: false },
+    "photo-id": {
+      type: "string",
+      description: "A photo on the Page, or meta_temp_* of a staged `page-photos upload`, repeatable",
+      required: false
+    },
+    "video-id": { type: "string", description: "A video of the ad account, repeatable", required: false },
+    "video-ref": { type: "string", description: "meta_temp_* of a staged video upload, repeatable", required: false },
+    "product-set-id": { type: "string", description: "Products of a catalog's product set", required: false },
+    footer: { type: "string", description: '"Text => https://\u2026" pinned at the bottom (last)', required: false },
+    background: { type: "string", description: "Background colour, six hex digits", required: false },
+    unpublished: { type: "boolean", description: "Leave it unpublished (no ad can open it yet)", required: false },
+    file: { type: "string", description: "JSON file with the whole payload", required: false }
+  }
+});
+var instantExperiencesCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new Instant Experience (the full-screen page an ad opens). ${STAGED_NOTE}
+Elements appear in the order of their flags; every element flag repeats. Published at publish unless --unpublished \u2014 an ad opens only a published one, a published one cannot be changed, and Meta deletes none.
+Pictures are Page photos (--photo-id: one on the Page, or the ref of a staged \`page-photos upload\`; a collection's photo experience takes four); videos come from the ad account (--video-id, or --video-ref of a staged \`media upload --kind video\`).
+Example: baker ads meta instant-experiences create --account-id act_123 --page-id 904238019441800 --name "Spring" --video-id 1508023623826870 --text "Our spring range" --button "Shop now => https://shop.example/spring"
+Then: baker ads meta creatives create --type instant_experience --canvas-id meta_temp_\u2026 --page 904238019441800 --message "Tap to explore" --image-hash \u2026`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or act_N (the account the ads run from)" },
+    "page-id": { type: "string", description: "The Facebook Page it belongs to \u2014 from `baker ads meta pages`" },
+    name: { type: "string", description: "Name in the Page's Instant Experience library" },
+    text: { type: "string", description: "A paragraph of text (repeatable)" },
+    button: { type: "string", description: '"Button text => https://\u2026" (repeatable)' },
+    "photo-id": {
+      type: "string",
+      description: "A photo on the Page, or meta_temp_* of a staged `page-photos upload` (repeatable)"
+    },
+    "video-id": { type: "string", description: "A video of the ad account (repeatable)" },
+    "video-ref": {
+      type: "string",
+      description: "meta_temp_* ref of a staged `media upload --kind video` (repeatable)"
+    },
+    "product-set-id": {
+      type: "string",
+      description: "Products from a catalog's product set, also shown under the ad (collection) \u2014 repeatable"
+    },
+    footer: { type: "string", description: '"Button text => https://\u2026" pinned at the bottom; must be last' },
+    background: { type: "string", description: "Background colour, six hex digits (e.g. FFFFFF)" },
+    unpublished: {
+      type: "boolean",
+      description: "Leave it unpublished \u2014 it can be changed, but no ad can open it yet"
+    },
+    file: { type: "string", description: "JSON file with the whole payload (page_id, name, elements[], publish)" }
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = await bareAccountId(args);
+    const elements = canvasElementsFromRawArgs(rawArgs);
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      page_id: args["page-id"] === void 0 ? void 0 : String(args["page-id"]),
+      name: args.name,
+      background_color: args.background,
+      elements: elements.length > 0 ? elements : void 0,
+      publish: args.unpublished === true ? false : void 0
+    });
+    await stageOp({ kind: "canvas.create", accountId, payload }, [
+      "An ad opens it with `creatives create --type instant_experience --canvas-id <ref>`."
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.meta.instant-experiences.update",
+  description: "Rename or publish an UNPUBLISHED Instant Experience at publish. Meta changes nothing on a published one.",
+  args: {
+    id: { type: "positional", description: "Instant Experience id or meta_temp_* ref", required: true },
+    "account-id": { type: "string", description: "Ad account the change is staged under", required: false },
+    name: { type: "string", description: "New name", required: false },
+    publish: { type: "boolean", description: "Publish it so ads can open it", required: false }
+  }
+});
+var instantExperiencesUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Rename or publish an unpublished Instant Experience. ${STAGED_NOTE}
+Example: baker ads meta instant-experiences update 1788652952402490 --account-id act_123 --publish`
+  },
+  args: {
+    id: { type: "positional", description: "Instant Experience id or meta_temp_* ref", required: true },
+    "account-id": { type: "string", description: "Numeric account ID or act_N" },
+    name: { type: "string", description: "New name" },
+    publish: { type: "boolean", description: "Publish it, so ads can open it \u2014 it is then fixed" }
+  },
+  run: async ({ args }) => {
+    const accountId = await bareAccountId(args);
+    await stageOp({
+      kind: "canvas.update",
+      accountId,
+      target: requireTarget(args, "Instant Experience"),
+      payload: { name: args.name, publish: args.publish === true ? true : void 0 }
+    });
+  }
+});
+var instantExperiencesCommand = defineCommand({
+  meta: {
+    name: "instant-experiences",
+    description: `Instant Experiences \u2014 the full-screen page an ad opens on the phone (also behind collection ads).
+  baker ads meta instant-experiences --page-id 904238019441800        \u2014 list, with whether each is published
+  baker ads meta instant-experiences create --page-id \u2026 --name \u2026 --text \u2026 --button "Shop => https://\u2026"
+  baker ads meta instant-experiences update <id> --publish`
+  },
+  subCommands: {
+    list: listCommand,
+    create: instantExperiencesCreateCommand,
+    update: instantExperiencesUpdateCommand
+  },
+  args: { "page-id": { type: "string", description: "Facebook Page id" }, output: { type: "string", default: "json" } },
+  default: "list"
+});
+export {
+  canvasElementsFromRawArgs,
+  instantExperiencesCommand,
+  instantExperiencesCreateCommand,
+  instantExperiencesUpdateCommand
+};
+//# sourceMappingURL=instant-experiences-6F6GXZ67.js.map

package/dist/instant-experiences-6F6GXZ67.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/instant-experiences.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport { csvOrJson, handleMetaError } from \"./shared.ts\";\nimport {\n  bareAccountId,\n  failWriteValidation,\n  loadJsonFileArg,\n  mergePayload,\n  requireTarget,\n  stageOp,\n} from \"./write-shared.ts\";\n\n/**\n * Instant Experiences — the full-screen page an ad opens on the phone (Meta's\n * API calls them canvases). Reading lists a Page's experiences; creating and\n * publishing stage on this chat's draft and happen at publish. Meta deletes\n * none and changes only an unpublished one, so a published experience stays\n * in the Page's library as it was made.\n */\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\n\ntype Args = Record<string, unknown>;\n\n/** The element flags, in the order they appear on the command line — that order is the experience's. */\nconst ELEMENT_FLAGS = [\"text\", \"button\", \"photo-id\", \"video-id\", \"video-ref\", \"product-set-id\", \"footer\"] as const;\n\nfunction linkPair(flag: string, value: string): { text: string; url: string } {\n  const [text, ...rest] = value.split(\"=>\");\n  const url = rest.join(\"=>\").trim();\n  if (!text?.trim() || !url) {\n    failWriteValidation(`--${flag} takes \"Button text => https://…\" — got \"${value}\"`);\n  }\n  return { text: text.trim(), url };\n}\n\nfunction elementFor(flag: (typeof ELEMENT_FLAGS)[number], value: string): Record<string, unknown> {\n  switch (flag) {\n    case \"text\":\n      return { type: \"text\", text: value };\n    case \"button\":\n      return { type: \"button\", ...linkPair(flag, value) };\n    case \"footer\":\n      return { type: \"footer\", ...linkPair(flag, value) };\n    case \"photo-id\":\n      return { type: \"photo\", photo_id: value };\n    case \"video-id\":\n      return { type: \"video\", video_id: value };\n    case \"video-ref\":\n      return { type: \"video\", videoRef: value };\n    default:\n      return { type: \"product_set\", product_set_id: value };\n  }\n}\n\n/** A command-line token as an element flag and its inline value (`--text=Hello`), if it is one. */\nfunction elementFlagOf(arg: string): { flag: (typeof ELEMENT_FLAGS)[number]; inline?: string } | undefined {\n  if (!arg.startsWith(\"--\")) return undefined;\n  const eq = arg.indexOf(\"=\");\n  const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);\n  const flag = ELEMENT_FLAGS.find((candidate) => candidate === name);\n  if (!flag) return undefined;\n  return eq === -1 ? { flag } : { flag, inline: arg.slice(eq + 1) };\n}\n\n/** Every element flag, repeatable, read from the command line in order (citty keeps only a flag's last value). */\nexport function canvasElementsFromRawArgs(rawArgs: readonly string[]): Record<string, unknown>[] {\n  const elements: Record<string, unknown>[] = [];\n  const end = rawArgs.indexOf(\"--\");\n  const args = end === -1 ? rawArgs : rawArgs.slice(0, end);\n  for (let i = 0; i < args.length; i++) {\n    const found = elementFlagOf(args[i] ?? \"\");\n    if (!found) continue;\n    const value = found.inline ?? args[++i];\n    if (value === undefined || value.startsWith(\"--\")) failWriteValidation(`--${found.flag} needs a value`);\n    elements.push(elementFor(found.flag, value));\n  }\n  return elements;\n}\n\n// --- List ---\n\nregisterSchema({\n  command: \"ads.meta.instant-experiences\",\n  description:\n    \"A Facebook Page's Instant Experiences — the full-screen pages an ad can open (creatives create --type instant_experience --canvas-id). Shows whether each is published: an ad opens only a published one.\",\n  args: {\n    \"page-id\": { type: \"string\", description: \"Facebook Page id (baker ads meta pages)\", required: true },\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", required: false, default: \"json\" },\n  },\n});\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"A Page's Instant Experiences, published or not. Runs by default. Example: baker ads meta instant-experiences --page-id 904238019441800\",\n  },\n  args: {\n    \"page-id\": { type: \"string\", description: \"Facebook Page id — from `baker ads meta pages`\" },\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    if (!args[\"page-id\"]) failWriteValidation(\"pass --page-id (from `baker ads meta pages`)\");\n    try {\n      const rows = await apiGet<Record<string, unknown>[]>(\"/api/ads/meta/instant-experiences\", {\n        \"page-id\": String(args[\"page-id\"]),\n      });\n      const hints =\n        rows.length === 0\n          ? [\"This Page has no Instant Experiences. Stage one with `baker ads meta instant-experiences create`.\"]\n          : [\n              \"An ad opens only a published experience (is_published true): `creatives create --type instant_experience --canvas-id <id>`. A published one cannot be changed or deleted.\",\n            ];\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(rows, fmt, undefined, hints);\n        return;\n      }\n      writeJsonEnvelope({ ok: true, data: rows, hints });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\n// --- Create ---\n\nregisterSchema({\n  command: \"ads.meta.instant-experiences.create\",\n  description:\n    \"Stage a new Instant Experience on a Page — its elements in command-line order — made (and published, unless --unpublished) when the chat publishes. Meta deletes no experience, so it is only ever made at publish.\",\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 it belongs to\", required: true },\n    name: { type: \"string\", description: \"Name in the Page's Instant Experience library\", required: true },\n    text: { type: \"string\", description: \"A paragraph, repeatable\", required: false },\n    button: { type: \"string\", description: '\"Text => https://…\", repeatable', required: false },\n    \"photo-id\": {\n      type: \"string\",\n      description: \"A photo on the Page, or meta_temp_* of a staged `page-photos upload`, repeatable\",\n      required: false,\n    },\n    \"video-id\": { type: \"string\", description: \"A video of the ad account, repeatable\", required: false },\n    \"video-ref\": { type: \"string\", description: \"meta_temp_* of a staged video upload, repeatable\", required: false },\n    \"product-set-id\": { type: \"string\", description: \"Products of a catalog's product set\", required: false },\n    footer: { type: \"string\", description: '\"Text => https://…\" pinned at the bottom (last)', required: false },\n    background: { type: \"string\", description: \"Background colour, six hex digits\", required: false },\n    unpublished: { type: \"boolean\", description: \"Leave it unpublished (no ad can open it yet)\", required: false },\n    file: { type: \"string\", description: \"JSON file with the whole payload\", required: false },\n  },\n});\n\nexport const instantExperiencesCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a new Instant Experience (the full-screen page an ad opens). ${STAGED_NOTE}\nElements appear in the order of their flags; every element flag repeats. Published at publish unless --unpublished — an ad opens only a published one, a published one cannot be changed, and Meta deletes none.\nPictures are Page photos (--photo-id: one on the Page, or the ref of a staged \\`page-photos upload\\`; a collection's photo experience takes four); videos come from the ad account (--video-id, or --video-ref of a staged \\`media upload --kind video\\`).\nExample: baker ads meta instant-experiences create --account-id act_123 --page-id 904238019441800 --name \"Spring\" --video-id 1508023623826870 --text \"Our spring range\" --button \"Shop now => https://shop.example/spring\"\nThen: baker ads meta creatives create --type instant_experience --canvas-id meta_temp_… --page 904238019441800 --message \"Tap to explore\" --image-hash …`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N (the account the ads run from)\" },\n    \"page-id\": { type: \"string\", description: \"The Facebook Page it belongs to — from `baker ads meta pages`\" },\n    name: { type: \"string\", description: \"Name in the Page's Instant Experience library\" },\n    text: { type: \"string\", description: \"A paragraph of text (repeatable)\" },\n    button: { type: \"string\", description: '\"Button text => https://…\" (repeatable)' },\n    \"photo-id\": {\n      type: \"string\",\n      description: \"A photo on the Page, or meta_temp_* of a staged `page-photos upload` (repeatable)\",\n    },\n    \"video-id\": { type: \"string\", description: \"A video of the ad account (repeatable)\" },\n    \"video-ref\": {\n      type: \"string\",\n      description: \"meta_temp_* ref of a staged `media upload --kind video` (repeatable)\",\n    },\n    \"product-set-id\": {\n      type: \"string\",\n      description: \"Products from a catalog's product set, also shown under the ad (collection) — repeatable\",\n    },\n    footer: { type: \"string\", description: '\"Button text => https://…\" pinned at the bottom; must be last' },\n    background: { type: \"string\", description: \"Background colour, six hex digits (e.g. FFFFFF)\" },\n    unpublished: {\n      type: \"boolean\",\n      description: \"Leave it unpublished — it can be changed, but no ad can open it yet\",\n    },\n    file: { type: \"string\", description: \"JSON file with the whole payload (page_id, name, elements[], publish)\" },\n  },\n  run: async ({ args, rawArgs }) => {\n    const accountId = await bareAccountId(args as Args);\n    const elements = canvasElementsFromRawArgs(rawArgs);\n    const payload = mergePayload(loadJsonFileArg(args.file), {\n      page_id: args[\"page-id\"] === undefined ? undefined : String(args[\"page-id\"]),\n      name: args.name,\n      background_color: args.background,\n      elements: elements.length > 0 ? elements : undefined,\n      publish: args.unpublished === true ? false : undefined,\n    });\n    await stageOp({ kind: \"canvas.create\", accountId, payload }, [\n      \"An ad opens it with `creatives create --type instant_experience --canvas-id <ref>`.\",\n    ]);\n  },\n});\n\n// --- Update ---\n\nregisterSchema({\n  command: \"ads.meta.instant-experiences.update\",\n  description:\n    \"Rename or publish an UNPUBLISHED Instant Experience at publish. Meta changes nothing on a published one.\",\n  args: {\n    id: { type: \"positional\", description: \"Instant Experience id or meta_temp_* ref\", required: true },\n    \"account-id\": { type: \"string\", description: \"Ad account the change is staged under\", required: false },\n    name: { type: \"string\", description: \"New name\", required: false },\n    publish: { type: \"boolean\", description: \"Publish it so ads can open it\", required: false },\n  },\n});\n\nexport const instantExperiencesUpdateCommand = defineCommand({\n  meta: {\n    name: \"update\",\n    description: `Rename or publish an unpublished Instant Experience. ${STAGED_NOTE}\nExample: baker ads meta instant-experiences update 1788652952402490 --account-id act_123 --publish`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Instant Experience id or meta_temp_* ref\", required: true },\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    name: { type: \"string\", description: \"New name\" },\n    publish: { type: \"boolean\", description: \"Publish it, so ads can open it — it is then fixed\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await bareAccountId(args as Args);\n    await stageOp({\n      kind: \"canvas.update\",\n      accountId,\n      target: requireTarget(args as Args, \"Instant Experience\"),\n      payload: { name: args.name, publish: args.publish === true ? true : undefined },\n    });\n  },\n});\n\nexport const instantExperiencesCommand = defineCommand({\n  meta: {\n    name: \"instant-experiences\",\n    description: `Instant Experiences — the full-screen page an ad opens on the phone (also behind collection ads).\n  baker ads meta instant-experiences --page-id 904238019441800        — list, with whether each is published\n  baker ads meta instant-experiences create --page-id … --name … --text … --button \"Shop => https://…\"\n  baker ads meta instant-experiences update <id> --publish`,\n  },\n  subCommands: {\n    list: listCommand,\n    create: instantExperiencesCreateCommand,\n    update: instantExperiencesUpdateCommand,\n  },\n  args: { \"page-id\": { type: \"string\", description: \"Facebook Page id\" }, output: { type: \"string\", default: \"json\" } },\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}

package/dist/intent-3GDLPKKN.js

@@ -0,0 +1,95 @@
+import {
+  handleResearchError,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-3KMYOPBI.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-SG2TDQEE.js";
+import "./chunk-44ZRCSR7.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/intent.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.intent",
+  description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
+  args: {
+    keywords: {
+      type: "string",
+      description: "Comma-separated keywords (min 3 chars each, max 1000 keywords)",
+      required: true
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English keywords",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  keyword: "The keyword analyzed",
+  intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
+  probability: "Confidence score 0.0-1.0"
+};
+var intentCommand = defineCommand({
+  meta: {
+    name: "intent",
+    description: `Classify Google Search intent for keywords. Returns intent type and confidence.
+
+Examples:
+  baker research intent "buy running shoes,best running shoes 2026,how to tie running shoes"
+  baker research intent "crm software" --language spanish`
+  },
+  args: {
+    keywords: { type: "positional", description: "Comma-separated keywords", required: true },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const rawKeywords = args.keywords;
+    const keywords = rawKeywords.split(",").map((k) => k.trim()).filter((k) => k.length >= 3);
+    if (keywords.length === 0) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword (min 3 chars each)" }
+      });
+      process.exit(1);
+    }
+    const language = args.language || void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(void 0, language, { skipLocation: true });
+    try {
+      const data = await apiPost("/api/research/intent", {
+        keywords,
+        language,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS, query_context: queryContext });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  intentCommand
+};
+//# sourceMappingURL=intent-3GDLPKKN.js.map

package/dist/job-2JJNKUHT.js

@@ -0,0 +1,202 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-UPDIBQUC.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson
+} from "./chunk-HPDGVK6R.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/stats/job.ts
+import { gunzipSync } from "zlib";
+import { defineCommand } from "citty";
+var POLL_INTERVAL_MS = 1e4;
+var DEADLINE_MS = 12 * 60 * 1e3;
+var RESULT_CACHE_TTL_MS = 6 * 60 * 60 * 1e3;
+registerSchema({
+  command: "ads.x.statsJob",
+  description: "Asynchronous X Ads stats job, fully synchronous from the CLI's perspective. Creates the job, polls every 10s, downloads + decompresses the gzip result, returns inline JSON. Hard deadline 12 min \u2014 must run in the background. Use this for ranges >7 days, segmented stats, or any query that hits sync limits. For fine-grained control, use `stats job-create` + `stats job-status` separately.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...", required: true },
+    "entity-ids": { type: "string", description: "CSV of entity IDs (max 20)", required: true },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: true },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: true },
+    granularity: { type: "string", description: "TOTAL | DAY | HOUR", required: false },
+    "metric-groups": { type: "string", description: "CSV of metric groups", required: true },
+    placement: { type: "string", description: "ALL_ON_TWITTER | PUBLISHER_NETWORK", required: false },
+    "segmentation-type": { type: "string", description: "Segmentation (e.g. AGE, GENDER, LOCATIONS)", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false },
+    "no-cache": { type: "boolean", description: "Skip result cache (still does the live job)", required: false }
+  }
+});
+function parseCsv(v) {
+  if (typeof v !== "string" || v.length === 0) return void 0;
+  const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function downloadAndDecompress(url) {
+  const res = await fetch(url, { signal: AbortSignal.timeout(6e4) });
+  if (!res.ok) {
+    throw new ApiError("INTERNAL_ERROR", `Stats job download failed (${res.status})`);
+  }
+  const buf = Buffer.from(await res.arrayBuffer());
+  const decompressed = gunzipSync(buf);
+  return JSON.parse(decompressed.toString("utf-8"));
+}
+async function pollUntilDone(accountId, jobId) {
+  const deadline = Date.now() + DEADLINE_MS;
+  let lastLog = 0;
+  while (Date.now() < deadline) {
+    await sleep(POLL_INTERVAL_MS);
+    const jobs = await apiGet("/api/ads/x/stats/jobs", {
+      "account-id": accountId,
+      "job-id": jobId
+    });
+    const job = jobs[0];
+    if (!job) {
+      throw new ApiError("NOT_FOUND", `Stats job ${jobId} not found`);
+    }
+    if (job.status === "SUCCESS") {
+      return job;
+    }
+    if (job.status === "FAILED" || job.status === "CANCELLED") {
+      throw new ApiError("INTERNAL_ERROR", `Stats job ${jobId} ended in status ${job.status}`);
+    }
+    const elapsed = DEADLINE_MS - (deadline - Date.now());
+    if (elapsed - lastLog > 3e4) {
+      process.stderr.write(`  polling... (${job.status}, ${Math.round(elapsed / 1e3)}s elapsed)
+`);
+      lastLog = elapsed;
+    }
+  }
+  throw new ApiError("TIMEOUT", `Stats job ${jobId} did not complete within ${DEADLINE_MS / 6e4} minutes`);
+}
+function buildCacheKey(body) {
+  return `stats-job:${JSON.stringify(body)}`;
+}
+var statsJobCommand = defineCommand({
+  meta: {
+    name: "job",
+    description: `Async X Ads stats job, sync from the CLI's perspective. Creates \u2192 polls \u2192 downloads \u2192 returns.
+
+Must run in the background (the harness enforces this).
+
+Use this when:
+  \u2022 Date range > 7 days
+  \u2022 Need segmentation (AGE, GENDER, LOCATIONS, ...)
+  \u2022 Sync stats hit a limit
+
+Examples:
+  baker ads x stats job --account-id 18ce53xyz --entity CAMPAIGN \\
+    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING
+
+  baker ads x stats job --account-id 18ce53xyz --entity LINE_ITEM \\
+    --entity-ids abc --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT \\
+    --segmentation-type LOCATIONS
+
+For fine-grained control (don't wait, poll yourself), use:
+  baker ads x stats job-create   \u2014 create + return job ID immediately
+  baker ads x stats job-status   \u2014 poll job status / get download URL`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "Entity type", required: true },
+    "entity-ids": { type: "string", description: "CSV of entity IDs", required: true },
+    "start-time": { type: "string", description: "ISO start", required: true },
+    "end-time": { type: "string", description: "ISO end", required: true },
+    granularity: { type: "string", description: "Granularity", required: false },
+    "metric-groups": { type: "string", description: "Metric groups CSV", required: true },
+    placement: { type: "string", description: "Placement", required: false },
+    "segmentation-type": { type: "string", description: "Segmentation type", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false },
+    "no-cache": { type: "boolean", description: "Skip result cache", required: false }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const entityIds = parseCsv(args["entity-ids"]);
+    const metricGroups = parseCsv(args["metric-groups"]);
+    if (!entityIds || !metricGroups) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "MISSING_PARAMETER", message: "entity-ids and metric-groups are required" }
+      });
+      process.exit(1);
+    }
+    const body = {
+      accountId,
+      entity: args.entity,
+      entityIds,
+      startTime: args["start-time"],
+      endTime: args["end-time"],
+      granularity: args.granularity ?? "DAY",
+      metricGroups,
+      placement: args.placement ?? "ALL_ON_TWITTER",
+      segmentationType: args["segmentation-type"],
+      country: args.country,
+      platform: args.platform
+    };
+    const useCache = !args["no-cache"];
+    const cacheKey = buildCacheKey(body);
+    if (useCache) {
+      const cached = cacheGet("x-stats", cacheKey);
+      if (cached) {
+        process.stderr.write("Result served from cache.\n");
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      process.stderr.write(`Creating X Ads stats job for entity=${body.entity}, ${entityIds.length} IDs...
+`);
+      const job = await apiPost("/api/ads/x/stats/jobs", body);
+      process.stderr.write(`Job ${job.id} queued. Polling every ${POLL_INTERVAL_MS / 1e3}s...
+`);
+      const finished = await pollUntilDone(accountId, job.id);
+      if (!finished.url) {
+        throw new ApiError("INTERNAL_ERROR", `Stats job ${job.id} succeeded but returned no download URL`);
+      }
+      process.stderr.write("Job complete. Downloading + decompressing results...\n");
+      const data = await downloadAndDecompress(finished.url);
+      if (useCache) {
+        cacheSet("x-stats", cacheKey, data, RESULT_CACHE_TTL_MS);
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({
+        ok: false,
+        error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+export {
+  statsJobCommand
+};
+//# sourceMappingURL=job-2JJNKUHT.js.map