@koda-sl/baker-cli 0.567.0 → 0.569.0-dev.1b455b3fe

package/dist/account-level-SHZBOMVV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/account-level.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet, apiPost } from \"../../../client.ts\";\nimport { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { dayPartingFromFlags } from \"./delivery-flags.ts\";\nimport { handleMetaError } from \"./shared.ts\";\nimport {\n  bareAccountId,\n  failWriteValidation,\n  loadJsonFileArg,\n  numberFlag,\n  requireTarget,\n  stageOp,\n} from \"./write-shared.ts\";\n\n/**\n * What belongs to the ad account itself rather than to a campaign: its own\n * settings (name, account spending limit), its publisher block lists, and its\n * reach-and-frequency quotes and reservations — plus the posts an ad can boost\n * and the comments on an ad's post. Changes stage on this chat's draft and are\n * made at publish; reads are live.\n */\n\ntype Row = Record<string, unknown>;\ntype Args = Record<string, unknown>;\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\nconst schemaAccount = { type: \"string\", description: \"Numeric account ID or act_N\", required: false };\n\nfunction emit(data: unknown, hints: string[] = []): void {\n  writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n}\n\nasync function readEdge(params: Record<string, string>): Promise<Row[]> {\n  return await apiGet<Row[]>(\"/api/ads/meta/account-edges\", params);\n}\n\n// --- Account settings ---\n\nregisterSchema({\n  command: \"ads.meta.account-settings\",\n  description:\n    \"Stage a change to the ad account's own settings: its name or its account spending limit (set, remove, or count again from zero). Made at publish.\",\n  args: {\n    \"account-id\": schemaAccount,\n    name: { type: \"string\", description: \"New account name\", required: false },\n    \"spending-limit\": {\n      type: \"string\",\n      description: \"Account spending limit, major units (e.g. 5000)\",\n      required: false,\n    },\n    \"remove-spending-limit\": { type: \"boolean\", description: \"Remove the spending limit\", required: false },\n    \"reset-spending-limit\": { type: \"boolean\", description: \"Count toward the limit again from zero\", required: false },\n    \"default-eu-advertiser\": {\n      type: \"string\",\n      description: \"Default EU (DSA) advertiser — who the ads are for — for new ad sets; pass with --default-eu-payer\",\n      required: false,\n    },\n    \"default-eu-payer\": {\n      type: \"string\",\n      description: \"Default EU (DSA) payer for new ad sets; pass with --default-eu-advertiser\",\n      required: false,\n    },\n    \"clear-default-eu\": {\n      type: \"boolean\",\n      description: \"Clear both the default EU advertiser and payer\",\n      required: false,\n    },\n  },\n});\n\nexport const accountSettingsCommand = defineCommand({\n  meta: {\n    name: \"account-settings\",\n    description: `Change the ad account's own settings — its name or its account spending limit. ${STAGED_NOTE}\nThe limit counts spend from the moment it is set (Meta starts the count again), and every campaign on the account stops when it is reached. Ask the user before touching it — it is account-wide.\nStart here: baker ads meta account --account-id act_123 (shows spend_cap and amount_spent, in minor units)\nExample: baker ads meta account-settings --account-id act_123 --spending-limit 5000\n         baker ads meta account-settings --account-id act_123 --remove-spending-limit\nThe EU (DSA) advertiser and payer new ad sets start with — both together, names from \\`baker ads meta dsa-recommendations\\` confirmed with the user:\n         baker ads meta account-settings --account-id act_123 --default-eu-advertiser \"Acme SL\" --default-eu-payer \"Acme SL\"`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N — the account itself\" },\n    name: { type: \"string\", description: \"New account name\" },\n    \"spending-limit\": { type: \"string\", description: \"Account spending limit in the account currency, e.g. 5000\" },\n    \"remove-spending-limit\": { type: \"boolean\", description: \"Take the account spending limit away\" },\n    \"reset-spending-limit\": { type: \"boolean\", description: \"Keep the limit and count spend toward it from zero\" },\n    \"default-eu-advertiser\": {\n      type: \"string\",\n      description: \"Default EU (DSA) advertiser for new ad sets — with --default-eu-payer (Meta keeps both or neither)\",\n    },\n    \"default-eu-payer\": { type: \"string\", description: \"Default EU (DSA) payer for new ad sets\" },\n    \"clear-default-eu\": { type: \"boolean\", description: \"Clear both the default EU advertiser and payer\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await bareAccountId(args as Args);\n    if (args[\"remove-spending-limit\"] && args[\"reset-spending-limit\"]) {\n      failWriteValidation(\"pass --remove-spending-limit OR --reset-spending-limit\");\n    }\n    const action = args[\"remove-spending-limit\"] ? \"remove\" : args[\"reset-spending-limit\"] ? \"reset\" : undefined;\n    await stageOp({\n      kind: \"adAccount.update\",\n      accountId,\n      target: accountId,\n      payload: {\n        name: args.name,\n        spendCap: args[\"spending-limit\"] ? { amount: String(args[\"spending-limit\"]) } : undefined,\n        spendCapAction: action,\n        defaultDsaBeneficiary: args[\"default-eu-advertiser\"],\n        defaultDsaPayor: args[\"default-eu-payer\"],\n        clearDefaultDsa: args[\"clear-default-eu\"] ? true : undefined,\n      },\n    });\n  },\n});\n\n// --- Block lists ---\n\nregisterSchema({\n  command: \"ads.meta.block-lists\",\n  description:\n    \"The ad account's publisher block lists — websites and apps its ads stay off (Audience Network, in-stream). --full lists each list's sites.\",\n  args: {\n    \"account-id\": schemaAccount,\n    full: { type: \"boolean\", description: \"Include each list's sites and apps\", required: false },\n  },\n});\n\nconst blockListsListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"Block lists on the ad account. Runs by default. Example: baker ads meta block-lists --account-id act_123 --full\",\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    full: { type: \"boolean\", description: \"Include each list's sites and apps\" },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = { edge: \"block-lists\", \"account-id\": await bareAccountId(args as Args) };\n      if (args.full) params.full = \"true\";\n      const rows = await readEdge(params);\n      emit(rows, [\n        \"Keep an ad set off a list with `adsets create|update --block-list <id>` (repeatable); add sites with `block-lists add <id> --url …`. Meta takes no site off a list and renames none — make a new list instead.\",\n      ]);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.block-lists.create\",\n  description: \"Stage a new publisher block list on the ad account, with its sites and apps. Made at publish.\",\n  args: {\n    \"account-id\": schemaAccount,\n    name: { type: \"string\", description: \"List name\", required: true },\n    url: { type: \"string\", description: \"A site (example.com) or app store address — repeatable\", required: false },\n    file: { type: \"string\", description: 'JSON file {\"urls\": [...]} for long lists', required: false },\n  },\n});\n\nfunction urlsFrom(args: Args, rawArgs: readonly string[]): string[] {\n  const file = loadJsonFileArg(args.file);\n  const fromFile = Array.isArray(file.urls) ? file.urls.filter((u): u is string => typeof u === \"string\") : [];\n  const urls = [...repeatedValues(rawArgs, \"url\", args.url), ...fromFile];\n  if (urls.length === 0) failWriteValidation('pass --url (repeatable) or --file with {\"urls\": [...]}');\n  return urls;\n}\n\nconst blockListsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Create a publisher block list. ${STAGED_NOTE}\nExample: baker ads meta block-lists create --account-id act_123 --name \"No gambling sites\" --url casino.example --url bets.example\nThen keep ad sets off it: baker ads meta adsets update <id> --block-list meta_temp_…`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    name: { type: \"string\", description: \"List name\", required: true },\n    url: { type: \"string\", description: \"A site (example.com) or app store address — repeatable\" },\n    file: { type: \"string\", description: 'JSON file {\"urls\": [...]} for a long list (up to 10,000)' },\n  },\n  run: async ({ args, rawArgs }) => {\n    await stageOp({\n      kind: \"publisherBlockList.create\",\n      accountId: await bareAccountId(args as Args),\n      payload: { name: args.name, urls: urlsFrom(args as Args, rawArgs) },\n    });\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.block-lists.add\",\n  description: \"Stage adding sites and apps to a block list. Meta takes none off a list.\",\n  args: {\n    id: { type: \"positional\", description: \"Block list id\", required: true },\n    \"account-id\": schemaAccount,\n    url: { type: \"string\", description: \"A site or app store address — repeatable\", required: false },\n    file: { type: \"string\", description: 'JSON file {\"urls\": [...]}', required: false },\n  },\n});\n\nconst blockListsAddCommand = defineCommand({\n  meta: {\n    name: \"add\",\n    description: `Add sites and apps to a block list. ${STAGED_NOTE}\nExample: baker ads meta block-lists add 120249500506120208 --account-id act_123 --url spam.example`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Block list id\", required: true },\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    url: { type: \"string\", description: \"A site or app store address — repeatable\" },\n    file: { type: \"string\", description: 'JSON file {\"urls\": [...]}' },\n  },\n  run: async ({ args, rawArgs }) => {\n    await stageOp({\n      kind: \"publisherBlockList.update\",\n      accountId: await bareAccountId(args as Args),\n      target: requireTarget(args as Args, \"block list\"),\n      payload: { addUrls: urlsFrom(args as Args, rawArgs) },\n    });\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.block-lists.delete\",\n  description: \"Stage deleting a block list. Ad sets that used it can show on its sites again.\",\n  args: { id: { type: \"positional\", description: \"Block list id\", required: true }, \"account-id\": schemaAccount },\n});\n\nconst blockListsDeleteCommand = defineCommand({\n  meta: {\n    name: \"delete\",\n    description: `Delete a block list — ad sets that used it can show on its sites and apps again. ${STAGED_NOTE}\nExample: baker ads meta block-lists delete 120249500506120208 --account-id act_123`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Block list 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: \"publisherBlockList.update\",\n      accountId: await bareAccountId(args as Args),\n      target: requireTarget(args as Args, \"block list\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\nexport const blockListsCommand = defineCommand({\n  meta: {\n    name: \"block-lists\",\n    description: `Publisher block lists — websites and apps the ad account's ads stay off (Audience Network, in-stream).\n  baker ads meta block-lists --account-id act_123 [--full]\n  baker ads meta block-lists create --name … --url … | add <id> --url … | delete <id>\nAn ad set uses a list with \\`adsets create|update --block-list <id>\\`; \\`--content-filter FEED_STRICT\\` and \\`--exclude-publisher-category gambling\\` set the rest of its brand safety.`,\n  },\n  subCommands: {\n    list: blockListsListCommand,\n    create: blockListsCreateCommand,\n    add: blockListsAddCommand,\n    delete: blockListsDeleteCommand,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    full: { type: \"boolean\", description: \"Include each list's sites and apps\" },\n  },\n  default: \"list\",\n});\n\n// --- Reach and frequency ---\n\nregisterSchema({\n  command: \"ads.meta.reach-frequency\",\n  description:\n    \"The ad account's reach-and-frequency quotes and reservations: reach, budget, dates, frequency cap, whether reserved and until when.\",\n  args: { \"account-id\": schemaAccount },\n});\n\nconst reachFrequencyListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"Reach-and-frequency quotes on the ad account (reservation_status 1 = reserved, until expiration_time). Runs by default. Example: baker ads meta reach-frequency --account-id act_123\",\n  },\n  args: { \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" } },\n  run: async ({ args }) => {\n    try {\n      const rows = await readEdge({ edge: \"reach-frequency\", \"account-id\": await bareAccountId(args as Args) });\n      emit(rows, [\n        \"Budgets here are in the account currency's minor units (cents). Reserve a quote with `reach-frequency reserve <id>`; a reserved campaign is `campaigns create --buying-type RESERVED` and its ad set `adsets create --reservation <reservation id>`.\",\n      ]);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.reach-frequency.predict\",\n  description:\n    \"Ask Meta for a reach-and-frequency quote: how many people a budget reaches (or what a reach costs) over fixed dates in one country, at a frequency cap. A forecast — holds nothing and spends nothing.\",\n  args: {\n    \"account-id\": schemaAccount,\n    \"page-id\": { type: \"string\", description: \"Facebook Page the ads run as\", required: true },\n    budget: { type: \"string\", description: \"Lifetime budget, major units (solves for reach)\", required: false },\n    reach: { type: \"string\", description: \"People to reach (solves for budget)\", required: false },\n    start: { type: \"string\", description: \"Start, ISO date-time\", required: true },\n    end: { type: \"string\", description: \"End, ISO date-time\", required: true },\n    \"frequency-cap\": {\n      type: \"string\",\n      description: \"Most times one person sees it per --frequency-days\",\n      required: false,\n    },\n    \"frequency-days\": { type: \"string\", description: \"Days the cap counts over (default 7)\", required: false },\n    objective: { type: \"string\", description: \"REACH (default) | BRAND_AWARENESS | VIDEO_VIEWS | …\", required: false },\n    \"optimization-goal\": { type: \"string\", description: \"Optional optimization goal\", required: false },\n    \"instagram-user\": { type: \"string\", description: \"Instagram account the ads run as\", required: false },\n    \"targeting-file\": { type: \"string\", description: \"Targeting JSON — ONE country\", required: true },\n    schedule: { type: \"string\", description: 'Hours to run in, repeatable: \"Mon-Fri 09-18\"', required: false },\n    \"target-frequency\": {\n      type: \"string\",\n      description: \"Balanced frequency: views per person per --target-frequency-days (OUTCOME_AWARENESS + REACH)\",\n      required: false,\n    },\n    \"target-frequency-days\": {\n      type: \"string\",\n      description: \"Days the target counts over (default 7)\",\n      required: false,\n    },\n    \"instream-package\": {\n      type: \"string\",\n      description: \"In-stream video packages, repeatable: NORMAL | PREMIUM | SPORTS | …\",\n      required: false,\n    },\n  },\n});\n\nfunction unixSeconds(value: unknown, flag: string): number {\n  const ms = typeof value === \"string\" ? Date.parse(value) : Number.NaN;\n  if (!Number.isFinite(ms)) failWriteValidation(`${flag} takes an ISO date-time, e.g. 2026-11-01T00:00:00Z`);\n  return Math.floor(ms / 1000);\n}\n\nconst reachFrequencyPredictCommand = defineCommand({\n  meta: {\n    name: \"predict\",\n    description: `Ask Meta what a reach-and-frequency buy would reach (or cost). A forecast: nothing is held or spent, and the quote expires on its own.\nStart here: baker ads meta account --account-id act_123 (the account needs CAN_USE_REACH_AND_FREQUENCY; Meta's floor is about 200,000 people per country)\nExample: baker ads meta reach-frequency predict --account-id act_123 --page-id 904238019441800 --budget 1000 --start 2026-11-01T00:00:00Z --end 2026-11-08T00:00:00Z --frequency-cap 2 --targeting-file t.json`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    \"page-id\": { type: \"string\", description: \"Facebook Page the ads run as — from `baker ads meta pages`\" },\n    \"instagram-user\": { type: \"string\", description: \"Instagram account the ads run as\" },\n    budget: { type: \"string\", description: \"Lifetime budget in the account currency (solves for reach)\" },\n    reach: { type: \"string\", description: \"People to reach (solves for budget)\" },\n    start: { type: \"string\", description: \"Start, ISO date-time\" },\n    end: { type: \"string\", description: \"End, ISO date-time (at most 90 days after the start)\" },\n    \"frequency-cap\": { type: \"string\", description: \"Most times one person sees the ads per --frequency-days\" },\n    \"frequency-days\": { type: \"string\", description: \"Days the cap counts over (default 7)\" },\n    objective: {\n      type: \"string\",\n      description:\n        \"REACH (default) | BRAND_AWARENESS | VIDEO_VIEWS | POST_ENGAGEMENT | LINK_CLICKS | OUTCOME_AWARENESS | OUTCOME_ENGAGEMENT\",\n    },\n    \"optimization-goal\": { type: \"string\", description: \"Optional optimization goal\" },\n    \"targeting-file\": { type: \"string\", description: \"Targeting JSON (as for adsets create) — ONE country\" },\n    schedule: {\n      type: \"string\",\n      description:\n        'Run only in these hours, repeatable: \"<days> <from>-<to>\", e.g. \"Mon-Fri 09-18\". Live, Meta stored day-parted quotes but answered status 18 (no reach) for them',\n    },\n    \"target-frequency\": {\n      type: \"string\",\n      description:\n        \"Balanced frequency: aim each person at this many views per --target-frequency-days (default 7) instead of a cap — needs --objective OUTCOME_AWARENESS and --optimization-goal REACH\",\n    },\n    \"target-frequency-days\": { type: \"string\", description: \"Days the target frequency counts over (default 7)\" },\n    \"instream-package\": {\n      type: \"string\",\n      description:\n        \"In-stream video packages the ads may run in, repeatable: NORMAL | PREMIUM | SPORTS | ENTERTAINMENT | …\",\n    },\n  },\n  run: async ({ args, rawArgs }) => {\n    if (!args[\"targeting-file\"]) failWriteValidation(\"pass --targeting-file (one country)\");\n    const reach = numberFlag(args.reach, \"--reach\");\n    const instreamPackages = repeatedValues(rawArgs, \"instream-package\", args[\"instream-package\"])\n      .flatMap((value) => value.split(\",\"))\n      .map((value) => value.trim().toUpperCase())\n      .filter(Boolean);\n    const body = {\n      accountId: await bareAccountId(args as Args),\n      solveFor: reach !== undefined ? \"budget\" : \"reach\",\n      budget: args.budget,\n      reach,\n      start_time: unixSeconds(args.start, \"--start\"),\n      end_time: unixSeconds(args.end, \"--end\"),\n      frequencyCap: numberFlag(args[\"frequency-cap\"], \"--frequency-cap\"),\n      frequencyCapDays: numberFlag(args[\"frequency-days\"], \"--frequency-days\"),\n      objective: args.objective,\n      optimization_goal: args[\"optimization-goal\"],\n      page_id: args[\"page-id\"],\n      instagram_user_id: args[\"instagram-user\"],\n      targeting: loadJsonFileArg(args[\"targeting-file\"]),\n      targetFrequency: numberFlag(args[\"target-frequency\"], \"--target-frequency\"),\n      targetFrequencyDays: numberFlag(args[\"target-frequency-days\"], \"--target-frequency-days\"),\n      day_parting_schedule: dayPartingFromFlags(args as Args, rawArgs),\n      instream_packages: instreamPackages.length > 0 ? instreamPackages : undefined,\n    };\n    try {\n      const quote = await apiPost<Row>(\"/api/ads/meta/reach-frequency/predict\", body);\n      const unanswered =\n        quote.status === 1\n          ? []\n          : [\n              `Meta did not quote this (status ${String(quote.status)}, reach 0) — nothing to reserve. Live, a run ending before 6 AM account time on its last day came back this way: move --end later in the day, or widen the audience (Meta's floor is about 200,000 people), and ask again.`,\n            ];\n      emit(quote, [\n        ...unanswered,\n        \"external_reach / external_impression are what Meta forecasts; external_budget and the min/max bounds are in minor units (cents). To hold this price, `reach-frequency reserve <id>` (staged, made at publish).\",\n      ]);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.reach-frequency.reserve\",\n  description:\n    \"Stage reserving a reach-and-frequency quote: Meta holds its price for about two weeks. Made at publish.\",\n  args: { id: { type: \"positional\", description: \"Quote id\", required: true }, \"account-id\": schemaAccount },\n});\n\nconst reachFrequencyReserveCommand = defineCommand({\n  meta: {\n    name: \"reserve\",\n    description: `Reserve a reach-and-frequency quote — Meta holds its price until the reservation expires. ${STAGED_NOTE}\nThen buy on it: campaigns create --buying-type RESERVED …, adsets create --reservation meta_temp_… (no budget — it comes from the quote).\nExample: baker ads meta reach-frequency reserve 120249500564540208 --account-id act_123`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Quote id (from `reach-frequency predict` or the list)\", required: true },\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n  },\n  run: async ({ args }) => {\n    await stageOp({\n      kind: \"reachFrequencyReservation.create\",\n      accountId: await bareAccountId(args as Args),\n      payload: { prediction_id: requireTarget(args as Args, \"quote\") },\n    });\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.reach-frequency.cancel\",\n  description: \"Stage cancelling a reach-and-frequency reservation, releasing its price. Made at publish.\",\n  args: { id: { type: \"positional\", description: \"Reservation id\", required: true }, \"account-id\": schemaAccount },\n});\n\nconst reachFrequencyCancelCommand = defineCommand({\n  meta: {\n    name: \"cancel\",\n    description: `Cancel a reach-and-frequency reservation. ${STAGED_NOTE}\nExample: baker ads meta reach-frequency cancel 120249500569290208 --account-id act_123`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Reservation 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: \"reachFrequencyReservation.update\",\n      accountId: await bareAccountId(args as Args),\n      target: requireTarget(args as Args, \"reservation\"),\n      payload: { status: \"CANCELLED\" },\n    });\n  },\n});\n\nexport const reachFrequencyCommand = defineCommand({\n  meta: {\n    name: \"reach-frequency\",\n    description: `Reach and frequency buying (Reservation): a fixed reach at a fixed price over fixed dates.\n  baker ads meta reach-frequency --account-id act_123                         — quotes and reservations\n  baker ads meta reach-frequency predict --budget 1000 --start … --end … --targeting-file t.json — a quote (holds nothing)\n  baker ads meta reach-frequency reserve <quote id>  |  cancel <reservation id>  — staged, made at publish`,\n  },\n  subCommands: {\n    list: reachFrequencyListCommand,\n    predict: reachFrequencyPredictCommand,\n    reserve: reachFrequencyReserveCommand,\n    cancel: reachFrequencyCancelCommand,\n  },\n  args: { \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" } },\n  default: \"list\",\n});\n\n// --- Posts an ad can boost, and comments on ads ---\n\nregisterSchema({\n  command: \"ads.meta.page-posts\",\n  description:\n    \"A Facebook Page's recent posts, with is_eligible_for_promotion — the posts a `creatives create --type existing_post --post-id` can boost.\",\n  args: { \"page-id\": { type: \"string\", description: \"Facebook Page id\", required: true } },\n});\n\nexport const pagePostsCommand = defineCommand({\n  meta: {\n    name: \"page-posts\",\n    description: `A Facebook Page's recent posts, for boosting one as an ad (keeps its likes and comments).\nExample: baker ads meta page-posts --page-id 904238019441800\nThen: baker ads meta creatives create --type existing_post --post-id <id> (only a post with is_eligible_for_promotion: true)`,\n  },\n  args: { \"page-id\": { type: \"string\", description: \"Facebook Page id — from `baker ads meta pages`\" } },\n  run: async ({ args }) => {\n    if (!args[\"page-id\"]) failWriteValidation(\"pass --page-id (from `baker ads meta pages`)\");\n    try {\n      const rows = await readEdge({ edge: \"page-posts\", \"page-id\": String(args[\"page-id\"]) });\n      emit(rows, [\n        \"Boost one with `creatives create --type existing_post --post-id <id>`; is_eligible_for_promotion false means Meta will not run it as an ad.\",\n      ]);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.instagram-media\",\n  description:\n    \"An Instagram account's posts, for boosting one as an ad (`creatives create --type existing_post --instagram-media-id`).\",\n  args: { \"instagram-user\": { type: \"string\", description: \"Instagram account id\", required: true } },\n});\n\nexport const instagramMediaCommand = defineCommand({\n  meta: {\n    name: \"instagram-media\",\n    description: `An Instagram account's posts, for boosting one as an ad.\nExample: baker ads meta instagram-media --instagram-user 17841478810711864\nThen: baker ads meta creatives create --type existing_post --instagram-media-id <id> --page <brand page> --instagram-user <id>`,\n  },\n  args: {\n    \"instagram-user\": {\n      type: \"string\",\n      description: \"Instagram account id — from `baker ads meta instagram-accounts`\",\n    },\n  },\n  run: async ({ args }) => {\n    if (!args[\"instagram-user\"])\n      failWriteValidation(\"pass --instagram-user (from `baker ads meta instagram-accounts`)\");\n    try {\n      emit(await readEdge({ edge: \"instagram-media\", \"instagram-user\": String(args[\"instagram-user\"]) }));\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.comments\",\n  description:\n    \"The comments on an ad's post (Facebook). Needs Meta permissions the connection may not hold — a refusal says so; moderation then happens in Meta Business Suite.\",\n  args: {\n    \"ad-id\": { type: \"string\", description: \"Ad id\", required: true },\n    full: { type: \"boolean\", description: \"Include who wrote each and its replies count\", required: false },\n  },\n});\n\nexport const commentsCommand = defineCommand({\n  meta: {\n    name: \"comments\",\n    description: `The comments people left on an ad's post.\nExample: baker ads meta comments --ad-id 120211234567890\nReading needs a Meta permission Baker's connection does not ask for yet; when Meta refuses, say moderation happens in Meta Business Suite and carry on.`,\n  },\n  args: {\n    \"ad-id\": { type: \"string\", description: \"Ad id — from `baker ads meta ads`\" },\n    full: { type: \"boolean\", description: \"Include who wrote each comment\" },\n  },\n  run: async ({ args }) => {\n    if (!args[\"ad-id\"]) failWriteValidation(\"pass --ad-id (from `baker ads meta ads`)\");\n    try {\n      const params: Record<string, string> = { \"ad-id\": String(args[\"ad-id\"]) };\n      if (args.full) params.full = \"true\";\n      emit(await apiGet<Row[]>(\"/api/ads/meta/ad-comments\", params));\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\n// --- What else hangs off the account (reads) ---\n\nconst ACCOUNT_DETAILS = {\n  recommendations: \"Meta's suggestions for the account (often empty)\",\n  users: \"the people on the account and their tasks (MANAGE, ADVERTISE, ANALYZE, DRAFT) — read only\",\n  \"account-controls\":\n    \"account-wide Advantage+ controls: the minimum age, locations and placements every Advantage+ campaign keeps to — read only\",\n  playables: \"playable ads (HTML) uploaded for app ads — read only\",\n  \"place-page-sets\": \"store-location page sets for local ads — read only\",\n} as const;\ntype AccountDetail = keyof typeof ACCOUNT_DETAILS;\n\nregisterSchema({\n  command: \"ads.meta.account-details\",\n  description: `What else belongs to the ad account, read live — --show one of: ${Object.entries(ACCOUNT_DETAILS)\n    .map(([name, what]) => `${name} (${what})`)\n    .join(\"; \")}.`,\n  args: {\n    \"account-id\": schemaAccount,\n    show: { type: \"string\", description: Object.keys(ACCOUNT_DETAILS).join(\"|\"), required: true },\n  },\n});\n\nexport const accountDetailsCommand = defineCommand({\n  meta: {\n    name: \"account-details\",\n    description: `What else belongs to the ad account, read live. Nothing here is changed by Baker.\nExample: baker ads meta account-details --account-id act_123 --show users\n--show ${Object.keys(ACCOUNT_DETAILS).join(\" | \")}`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    show: { type: \"string\", description: Object.keys(ACCOUNT_DETAILS).join(\" | \") },\n  },\n  run: async ({ args }) => {\n    const show = String(args.show ?? \"\");\n    if (!(show in ACCOUNT_DETAILS)) {\n      failWriteValidation(`--show takes ${Object.keys(ACCOUNT_DETAILS).join(\", \")}`);\n    }\n    try {\n      const rows = await readEdge({ edge: show as AccountDetail, \"account-id\": await bareAccountId(args as Args) });\n      emit(rows, rows.length === 0 ? [`No ${show} on this ad account.`] : []);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AA2B9B,IAAM,cAAc;AACpB,IAAM,gBAAgB,EAAE,MAAM,UAAU,aAAa,+BAA+B,UAAU,MAAM;AAEpG,SAAS,KAAK,MAAe,QAAkB,CAAC,GAAS;AACvD,oBAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,KAAK,CAAC;AACrF;AAEA,eAAe,SAAS,QAAgD;AACtE,SAAO,MAAM,OAAc,+BAA+B,MAAM;AAClE;AAIA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,cAAc;AAAA,IACd,MAAM,EAAE,MAAM,UAAU,aAAa,oBAAoB,UAAU,MAAM;AAAA,IACzE,kBAAkB;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,yBAAyB,EAAE,MAAM,WAAW,aAAa,6BAA6B,UAAU,MAAM;AAAA,IACtG,wBAAwB,EAAE,MAAM,WAAW,aAAa,0CAA0C,UAAU,MAAM;AAAA,IAClH,yBAAyB;AAAA,MACvB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,oBAAoB;AAAA,MAClB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,oBAAoB;AAAA,MAClB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAEM,IAAM,yBAAyB,cAAc;AAAA,EAClD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,uFAAkF,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5G;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,wDAAmD;AAAA,IAChG,MAAM,EAAE,MAAM,UAAU,aAAa,mBAAmB;AAAA,IACxD,kBAAkB,EAAE,MAAM,UAAU,aAAa,4DAA4D;AAAA,IAC7G,yBAAyB,EAAE,MAAM,WAAW,aAAa,uCAAuC;AAAA,IAChG,wBAAwB,EAAE,MAAM,WAAW,aAAa,qDAAqD;AAAA,IAC7G,yBAAyB;AAAA,MACvB,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,IACA,oBAAoB,EAAE,MAAM,UAAU,aAAa,yCAAyC;AAAA,IAC5F,oBAAoB,EAAE,MAAM,WAAW,aAAa,iDAAiD;AAAA,EACvG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,MAAM,cAAc,IAAY;AAClD,QAAI,KAAK,uBAAuB,KAAK,KAAK,sBAAsB,GAAG;AACjE,0BAAoB,wDAAwD;AAAA,IAC9E;AACA,UAAM,SAAS,KAAK,uBAAuB,IAAI,WAAW,KAAK,sBAAsB,IAAI,UAAU;AACnG,UAAM,QAAQ;AAAA,MACZ,MAAM;AAAA,MACN;AAAA,MACA,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,MAAM,KAAK;AAAA,QACX,UAAU,KAAK,gBAAgB,IAAI,EAAE,QAAQ,OAAO,KAAK,gBAAgB,CAAC,EAAE,IAAI;AAAA,QAChF,gBAAgB;AAAA,QAChB,uBAAuB,KAAK,uBAAuB;AAAA,QACnD,iBAAiB,KAAK,kBAAkB;AAAA,QACxC,iBAAiB,KAAK,kBAAkB,IAAI,OAAO;AAAA,MACrD;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;AAID,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,cAAc;AAAA,IACd,MAAM,EAAE,MAAM,WAAW,aAAa,sCAAsC,UAAU,MAAM;AAAA,EAC9F;AACF,CAAC;AAED,IAAM,wBAAwB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IAC3E,MAAM,EAAE,MAAM,WAAW,aAAa,qCAAqC;AAAA,EAC7E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,SAAiC,EAAE,MAAM,eAAe,cAAc,MAAM,cAAc,IAAY,EAAE;AAC9G,UAAI,KAAK,KAAM,QAAO,OAAO;AAC7B,YAAM,OAAO,MAAM,SAAS,MAAM;AAClC,WAAK,MAAM;AAAA,QACT;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,cAAc;AAAA,IACd,MAAM,EAAE,MAAM,UAAU,aAAa,aAAa,UAAU,KAAK;AAAA,IACjE,KAAK,EAAE,MAAM,UAAU,aAAa,+DAA0D,UAAU,MAAM;AAAA,IAC9G,MAAM,EAAE,MAAM,UAAU,aAAa,4CAA4C,UAAU,MAAM;AAAA,EACnG;AACF,CAAC;AAED,SAAS,SAAS,MAAY,SAAsC;AAClE,QAAM,OAAO,gBAAgB,KAAK,IAAI;AACtC,QAAM,WAAW,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,KAAK,OAAO,CAAC,MAAmB,OAAO,MAAM,QAAQ,IAAI,CAAC;AAC3G,QAAM,OAAO,CAAC,GAAG,eAAe,SAAS,OAAO,KAAK,GAAG,GAAG,GAAG,QAAQ;AACtE,MAAI,KAAK,WAAW,EAAG,qBAAoB,wDAAwD;AACnG,SAAO;AACT;AAEA,IAAM,0BAA0B,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,kCAAkC,WAAW;AAAA;AAAA;AAAA,EAG5D;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IAC3E,MAAM,EAAE,MAAM,UAAU,aAAa,aAAa,UAAU,KAAK;AAAA,IACjE,KAAK,EAAE,MAAM,UAAU,aAAa,8DAAyD;AAAA,IAC7F,MAAM,EAAE,MAAM,UAAU,aAAa,2DAA2D;AAAA,EAClG;AAAA,EACA,KAAK,OAAO,EAAE,MAAM,QAAQ,MAAM;AAChC,UAAM,QAAQ;AAAA,MACZ,MAAM;AAAA,MACN,WAAW,MAAM,cAAc,IAAY;AAAA,MAC3C,SAAS,EAAE,MAAM,KAAK,MAAM,MAAM,SAAS,MAAc,OAAO,EAAE;AAAA,IACpE,CAAC;AAAA,EACH;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;AAAA,IACd,KAAK,EAAE,MAAM,UAAU,aAAa,iDAA4C,UAAU,MAAM;AAAA,IAChG,MAAM,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,EACpF;AACF,CAAC;AAED,IAAM,uBAAuB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,uCAAuC,WAAW;AAAA;AAAA,EAEjE;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,iBAAiB,UAAU,KAAK;AAAA,IACvE,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IAC3E,KAAK,EAAE,MAAM,UAAU,aAAa,gDAA2C;AAAA,IAC/E,MAAM,EAAE,MAAM,UAAU,aAAa,4BAA4B;AAAA,EACnE;AAAA,EACA,KAAK,OAAO,EAAE,MAAM,QAAQ,MAAM;AAChC,UAAM,QAAQ;AAAA,MACZ,MAAM;AAAA,MACN,WAAW,MAAM,cAAc,IAAY;AAAA,MAC3C,QAAQ,cAAc,MAAc,YAAY;AAAA,MAChD,SAAS,EAAE,SAAS,SAAS,MAAc,OAAO,EAAE;AAAA,IACtD,CAAC;AAAA,EACH;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,aAAa,iBAAiB,UAAU,KAAK,GAAG,cAAc,cAAc;AAChH,CAAC;AAED,IAAM,0BAA0B,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,yFAAoF,WAAW;AAAA;AAAA,EAE9G;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;AAAA,EAIf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,KAAK;AAAA,IACL,QAAQ;AAAA,EACV;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IAC3E,MAAM,EAAE,MAAM,WAAW,aAAa,qCAAqC;AAAA,EAC7E;AAAA,EACA,SAAS;AACX,CAAC;AAID,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,EAAE,cAAc,cAAc;AACtC,CAAC;AAED,IAAM,4BAA4B,cAAc;AAAA,EAC9C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B,EAAE;AAAA,EACrF,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAO,MAAM,SAAS,EAAE,MAAM,mBAAmB,cAAc,MAAM,cAAc,IAAY,EAAE,CAAC;AACxG,WAAK,MAAM;AAAA,QACT;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,cAAc;AAAA,IACd,WAAW,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,KAAK;AAAA,IACzF,QAAQ,EAAE,MAAM,UAAU,aAAa,mDAAmD,UAAU,MAAM;AAAA,IAC1G,OAAO,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAC7F,OAAO,EAAE,MAAM,UAAU,aAAa,wBAAwB,UAAU,KAAK;AAAA,IAC7E,KAAK,EAAE,MAAM,UAAU,aAAa,sBAAsB,UAAU,KAAK;AAAA,IACzE,iBAAiB;AAAA,MACf,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,kBAAkB,EAAE,MAAM,UAAU,aAAa,wCAAwC,UAAU,MAAM;AAAA,IACzG,WAAW,EAAE,MAAM,UAAU,aAAa,4DAAuD,UAAU,MAAM;AAAA,IACjH,qBAAqB,EAAE,MAAM,UAAU,aAAa,8BAA8B,UAAU,MAAM;AAAA,IAClG,kBAAkB,EAAE,MAAM,UAAU,aAAa,oCAAoC,UAAU,MAAM;AAAA,IACrG,kBAAkB,EAAE,MAAM,UAAU,aAAa,qCAAgC,UAAU,KAAK;AAAA,IAChG,UAAU,EAAE,MAAM,UAAU,aAAa,gDAAgD,UAAU,MAAM;AAAA,IACzG,oBAAoB;AAAA,MAClB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,yBAAyB;AAAA,MACvB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,oBAAoB;AAAA,MAClB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAED,SAAS,YAAY,OAAgB,MAAsB;AACzD,QAAM,KAAK,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI,OAAO;AAClE,MAAI,CAAC,OAAO,SAAS,EAAE,EAAG,qBAAoB,GAAG,IAAI,oDAAoD;AACzG,SAAO,KAAK,MAAM,KAAK,GAAI;AAC7B;AAEA,IAAM,+BAA+B,cAAc;AAAA,EACjD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA,EAGf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IAC3E,WAAW,EAAE,MAAM,UAAU,aAAa,kEAA6D;AAAA,IACvG,kBAAkB,EAAE,MAAM,UAAU,aAAa,mCAAmC;AAAA,IACpF,QAAQ,EAAE,MAAM,UAAU,aAAa,6DAA6D;AAAA,IACpG,OAAO,EAAE,MAAM,UAAU,aAAa,sCAAsC;AAAA,IAC5E,OAAO,EAAE,MAAM,UAAU,aAAa,uBAAuB;AAAA,IAC7D,KAAK,EAAE,MAAM,UAAU,aAAa,uDAAuD;AAAA,IAC3F,iBAAiB,EAAE,MAAM,UAAU,aAAa,0DAA0D;AAAA,IAC1G,kBAAkB,EAAE,MAAM,UAAU,aAAa,uCAAuC;AAAA,IACxF,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,IACA,qBAAqB,EAAE,MAAM,UAAU,aAAa,6BAA6B;AAAA,IACjF,kBAAkB,EAAE,MAAM,UAAU,aAAa,2DAAsD;AAAA,IACvG,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,IACA,oBAAoB;AAAA,MAClB,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,IACA,yBAAyB,EAAE,MAAM,UAAU,aAAa,oDAAoD;AAAA,IAC5G,oBAAoB;AAAA,MAClB,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,MAAM,QAAQ,MAAM;AAChC,QAAI,CAAC,KAAK,gBAAgB,EAAG,qBAAoB,qCAAqC;AACtF,UAAM,QAAQ,WAAW,KAAK,OAAO,SAAS;AAC9C,UAAM,mBAAmB,eAAe,SAAS,oBAAoB,KAAK,kBAAkB,CAAC,EAC1F,QAAQ,CAAC,UAAU,MAAM,MAAM,GAAG,CAAC,EACnC,IAAI,CAAC,UAAU,MAAM,KAAK,EAAE,YAAY,CAAC,EACzC,OAAO,OAAO;AACjB,UAAM,OAAO;AAAA,MACX,WAAW,MAAM,cAAc,IAAY;AAAA,MAC3C,UAAU,UAAU,SAAY,WAAW;AAAA,MAC3C,QAAQ,KAAK;AAAA,MACb;AAAA,MACA,YAAY,YAAY,KAAK,OAAO,SAAS;AAAA,MAC7C,UAAU,YAAY,KAAK,KAAK,OAAO;AAAA,MACvC,cAAc,WAAW,KAAK,eAAe,GAAG,iBAAiB;AAAA,MACjE,kBAAkB,WAAW,KAAK,gBAAgB,GAAG,kBAAkB;AAAA,MACvE,WAAW,KAAK;AAAA,MAChB,mBAAmB,KAAK,mBAAmB;AAAA,MAC3C,SAAS,KAAK,SAAS;AAAA,MACvB,mBAAmB,KAAK,gBAAgB;AAAA,MACxC,WAAW,gBAAgB,KAAK,gBAAgB,CAAC;AAAA,MACjD,iBAAiB,WAAW,KAAK,kBAAkB,GAAG,oBAAoB;AAAA,MAC1E,qBAAqB,WAAW,KAAK,uBAAuB,GAAG,yBAAyB;AAAA,MACxF,sBAAsB,oBAAoB,MAAc,OAAO;AAAA,MAC/D,mBAAmB,iBAAiB,SAAS,IAAI,mBAAmB;AAAA,IACtE;AACA,QAAI;AACF,YAAM,QAAQ,MAAM,QAAa,yCAAyC,IAAI;AAC9E,YAAM,aACJ,MAAM,WAAW,IACb,CAAC,IACD;AAAA,QACE,mCAAmC,OAAO,MAAM,MAAM,CAAC;AAAA,MACzD;AACN,WAAK,OAAO;AAAA,QACV,GAAG;AAAA,QACH;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,aAAa,YAAY,UAAU,KAAK,GAAG,cAAc,cAAc;AAC3G,CAAC;AAED,IAAM,+BAA+B,cAAc;AAAA,EACjD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,kGAA6F,WAAW;AAAA;AAAA;AAAA,EAGvH;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,yDAAyD,UAAU,KAAK;AAAA,IAC/G,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,SAAS,EAAE,eAAe,cAAc,MAAc,OAAO,EAAE;AAAA,IACjE,CAAC;AAAA,EACH;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,aAAa,kBAAkB,UAAU,KAAK,GAAG,cAAc,cAAc;AACjH,CAAC;AAED,IAAM,8BAA8B,cAAc;AAAA,EAChD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,6CAA6C,WAAW;AAAA;AAAA,EAEvE;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,kBAAkB,UAAU,KAAK;AAAA,IACxE,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,aAAa;AAAA,MACjD,SAAS,EAAE,QAAQ,YAAY;AAAA,IACjC,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,wBAAwB,cAAc;AAAA,EACjD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS;AAAA,IACT,QAAQ;AAAA,EACV;AAAA,EACA,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B,EAAE;AAAA,EACrF,SAAS;AACX,CAAC;AAID,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,aAAa,oBAAoB,UAAU,KAAK,EAAE;AACzF,CAAC;AAEM,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA,EAGf;AAAA,EACA,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,aAAa,sDAAiD,EAAE;AAAA,EACrG,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI,CAAC,KAAK,SAAS,EAAG,qBAAoB,8CAA8C;AACxF,QAAI;AACF,YAAM,OAAO,MAAM,SAAS,EAAE,MAAM,cAAc,WAAW,OAAO,KAAK,SAAS,CAAC,EAAE,CAAC;AACtF,WAAK,MAAM;AAAA,QACT;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,EAAE,kBAAkB,EAAE,MAAM,UAAU,aAAa,wBAAwB,UAAU,KAAK,EAAE;AACpG,CAAC;AAEM,IAAM,wBAAwB,cAAc;AAAA,EACjD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA,EAGf;AAAA,EACA,MAAM;AAAA,IACJ,kBAAkB;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI,CAAC,KAAK,gBAAgB;AACxB,0BAAoB,kEAAkE;AACxF,QAAI;AACF,WAAK,MAAM,SAAS,EAAE,MAAM,mBAAmB,kBAAkB,OAAO,KAAK,gBAAgB,CAAC,EAAE,CAAC,CAAC;AAAA,IACpG,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,UAAU,aAAa,SAAS,UAAU,KAAK;AAAA,IAChE,MAAM,EAAE,MAAM,WAAW,aAAa,gDAAgD,UAAU,MAAM;AAAA,EACxG;AACF,CAAC;AAEM,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA,EAGf;AAAA,EACA,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,UAAU,aAAa,yCAAoC;AAAA,IAC5E,MAAM,EAAE,MAAM,WAAW,aAAa,iCAAiC;AAAA,EACzE;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI,CAAC,KAAK,OAAO,EAAG,qBAAoB,0CAA0C;AAClF,QAAI;AACF,YAAM,SAAiC,EAAE,SAAS,OAAO,KAAK,OAAO,CAAC,EAAE;AACxE,UAAI,KAAK,KAAM,QAAO,OAAO;AAC7B,WAAK,MAAM,OAAc,6BAA6B,MAAM,CAAC;AAAA,IAC/D,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAID,IAAM,kBAAkB;AAAA,EACtB,iBAAiB;AAAA,EACjB,OAAO;AAAA,EACP,oBACE;AAAA,EACF,WAAW;AAAA,EACX,mBAAmB;AACrB;AAGA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa,wEAAmE,OAAO,QAAQ,eAAe,EAC3G,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,EACzC,KAAK,IAAI,CAAC;AAAA,EACb,MAAM;AAAA,IACJ,cAAc;AAAA,IACd,MAAM,EAAE,MAAM,UAAU,aAAa,OAAO,KAAK,eAAe,EAAE,KAAK,GAAG,GAAG,UAAU,KAAK;AAAA,EAC9F;AACF,CAAC;AAEM,IAAM,wBAAwB,cAAc;AAAA,EACjD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA,SAER,OAAO,KAAK,eAAe,EAAE,KAAK,KAAK,CAAC;AAAA,EAC/C;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IAC3E,MAAM,EAAE,MAAM,UAAU,aAAa,OAAO,KAAK,eAAe,EAAE,KAAK,KAAK,EAAE;AAAA,EAChF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,OAAO,OAAO,KAAK,QAAQ,EAAE;AACnC,QAAI,EAAE,QAAQ,kBAAkB;AAC9B,0BAAoB,gBAAgB,OAAO,KAAK,eAAe,EAAE,KAAK,IAAI,CAAC,EAAE;AAAA,IAC/E;AACA,QAAI;AACF,YAAM,OAAO,MAAM,SAAS,EAAE,MAAM,MAAuB,cAAc,MAAM,cAAc,IAAY,EAAE,CAAC;AAC5G,WAAK,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,IAAI,sBAAsB,IAAI,CAAC,CAAC;AAAA,IACxE,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/account-reads-GF3T25HX.js

@@ -0,0 +1,220 @@
+import {
+  exitWithServiceReadError
+} from "./chunk-4PAGS7QH.js";
+import {
+  failWriteValidation,
+  listFlag,
+  requireCustomerId
+} from "./chunk-5I6XOSNI.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-LZR7LSYO.js";
+import "./chunk-55AX6DOP.js";
+import "./chunk-MX5NQAK6.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-4H6XLX7E.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-WZXMZFVB.js";
+import {
+  getManagerIdForCustomer,
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/account-reads.ts
+import { defineCommand } from "citty";
+function register(command, description, args) {
+  registerSchema({
+    command,
+    description,
+    args: Object.fromEntries(
+      Object.entries(args).map(([name, arg]) => [
+        name,
+        { type: arg.type, description: arg.description, required: false }
+      ])
+    )
+  });
+}
+async function serviceRead(path, customerId, body) {
+  const managerId = getManagerIdForCustomer(customerId);
+  const { data } = await apiPost(path, {
+    customerId,
+    ...managerId ? { managerId } : {},
+    ...body
+  });
+  return data;
+}
+var CUSTOMER_ARG = {
+  "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)" }
+};
+var INVOICE_ARGS = {
+  ...CUSTOMER_ARG,
+  month: { type: "string", description: "Issue month, YYYY-MM (default: last month)" }
+};
+register(
+  "ads.google.invoices",
+  "List the invoices Google issued in one month (accounts on monthly invoicing only): id, dates, service period, subtotal/tax/total in micros, PDF link. Start here: `baker ads google invoices --customer-id 1234567890 --month 2026-09`. An account that pays automatically has no invoices \u2014 the error's fix says where its receipts are; carry on.",
+  INVOICE_ARGS
+);
+var invoicesCommand = defineCommand({
+  meta: {
+    name: "invoices",
+    description: `List one month's invoices (monthly-invoicing accounts only). Read-only.
+
+Example:
+  baker ads google invoices --customer-id 1234567890 --month 2026-09`
+  },
+  args: INVOICE_ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    try {
+      const data = await serviceRead("/api/ads/google/invoices", customerId, {
+        ...args.month ? { month: args.month } : {}
+      });
+      const hints = data.invoices.length === 0 ? [`No invoice was issued in ${data.month}. Try the month before with --month.`] : [
+        "Amounts are micros in each invoice's currency_code (divide by 1,000,000). pdf_url needs the user's Google sign-in."
+      ];
+      writeJsonEnvelope({ ok: true, data, hints });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+register(
+  "ads.google.identity-verification",
+  "Advertiser identity verification status: each program's status (PENDING_USER_ACTION, PENDING_REVIEW, SUCCESS, FAILURE), deadlines and the link where the user completes it. Start here: `baker ads google identity-verification --customer-id 1234567890`. Google only answers for accounts on monthly invoicing \u2014 otherwise the error's fix says where the user reads it; carry on.",
+  CUSTOMER_ARG
+);
+var identityVerificationCommand = defineCommand({
+  meta: {
+    name: "identity-verification",
+    description: `Advertiser identity verification status and deadlines. Read-only.
+
+Example:
+  baker ads google identity-verification --customer-id 1234567890`
+  },
+  args: CUSTOMER_ARG,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    try {
+      const data = await serviceRead(
+        "/api/ads/google/identity-verification",
+        customerId,
+        {}
+      );
+      const pending = data.programs.filter((program) => program.status === "PENDING_USER_ACTION");
+      const hints = pending.length > 0 ? [
+        `Verification is waiting on the advertiser${pending[0]?.completion_deadline ? ` (deadline ${pending[0].completion_deadline})` : ""}: give the user the action_url \u2014 ads stop serving if it lapses.`
+      ] : [];
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+var PREVIEW_ARGS = {
+  ...CUSTOMER_ARG,
+  ads: {
+    type: "string",
+    description: "Comma-separated video ads of Video campaigns as {adGroupId}~{adId} (from `ads list`) \u2014 previewed live on YouTube"
+  },
+  "asset-groups": {
+    type: "string",
+    description: "Comma-separated Performance Max asset group ids (from `asset-groups list`) \u2014 previewed on Google's preview page"
+  }
+};
+register(
+  "ads.google.previews",
+  "Shareable preview links for Performance Max asset groups (Google's preview page) and video ads (live on YouTube) that already exist in the account \u2014 a link the user can open or forward. Start here: `baker ads google previews --customer-id 1234567890 --asset-groups 6743268912`. Returns { previews: [{ target, url, youtube_tv_url, expires_at }] }. Only video ads of Video campaigns can be previewed by ad (search, display and Demand Gen ads have no shareable preview); staged (unpublished) changes cannot be previewed.",
+  PREVIEW_ARGS
+);
+var previewsCommand = defineCommand({
+  meta: {
+    name: "previews",
+    description: `Shareable preview links for existing Performance Max asset groups and video ads. Read-only.
+
+Examples:
+  baker ads google previews --customer-id 1234567890 --asset-groups 6743268912
+  baker ads google previews --customer-id 1234567890 --ads 195752489650~826812181091   # a video ad, live on YouTube`
+  },
+  args: PREVIEW_ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    const ads = listFlag(args.ads);
+    const assetGroups = listFlag(args["asset-groups"]);
+    if (!ads?.length && !assetGroups?.length) failWriteValidation("pass --ads and/or --asset-groups");
+    try {
+      const data = await serviceRead("/api/ads/google/previews", customerId, {
+        ...ads ? { ads } : {},
+        ...assetGroups ? { assetGroups } : {}
+      });
+      writeJsonEnvelope({
+        ok: true,
+        data,
+        hints: [
+          "Each link expires (expires_at). It shows what is live in the account now, not anything staged in this chat."
+        ]
+      });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+var BRAND_ARGS = {
+  ...CUSTOMER_ARG,
+  prefix: { type: "string", description: "The start of the brand's name (at least 2 letters)" }
+};
+register(
+  "ads.google.brands",
+  "Find a brand's Google entity id \u2014 what a BRANDS list member names (`keyword-lists add --brand /g/\u2026`). Start here: `baker ads google brands --customer-id 1234567890 --prefix nike`. Several brands can share a name: pick by the URL. Read-only.",
+  BRAND_ARGS
+);
+var brandsCommand = defineCommand({
+  meta: {
+    name: "brands",
+    description: `Find brand entity ids for a brand list (BRANDS). Read-only.
+
+Example:
+  baker ads google brands --customer-id 1234567890 --prefix nike`
+  },
+  args: BRAND_ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    if (typeof args.prefix !== "string" || args.prefix.trim().length < 2) {
+      failWriteValidation("--prefix needs at least the first 2 letters of the brand");
+    }
+    try {
+      const data = await serviceRead("/api/ads/google/brands", customerId, {
+        prefix: args.prefix
+      });
+      const hints = data.brands.length > 0 ? [
+        "Several brands can share a name \u2014 pick the one whose URL is the brand you mean, then `keyword-lists add --list-ref <BRANDS list> --brand <entity_id>`."
+      ] : ["No brand starts with that \u2014 try a shorter or different prefix."];
+      writeJsonEnvelope({ ok: true, data, hints });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+export {
+  brandsCommand,
+  identityVerificationCommand,
+  invoicesCommand,
+  previewsCommand
+};
+//# sourceMappingURL=account-reads-GF3T25HX.js.map

package/dist/account-reads-GF3T25HX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/account-reads.ts"],"sourcesContent":["/**\n * `baker ads google invoices | identity-verification | previews` — read-only service calls that\n * are not GAQL. A refusal that is the account's situation degrades with an `error.fix` (see\n * `service-read-errors.ts`) instead of failing the job.\n */\nimport type {\n  GoogleBrandSuggestionsResponse,\n  GoogleIdentityVerificationResponse,\n  GoogleInvoicesResponse,\n  GoogleShareablePreviewsResponse,\n} from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { getManagerIdForCustomer } from \"../cache.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { exitWithServiceReadError } from \"./service-read-errors.ts\";\nimport { failWriteValidation, listFlag, requireCustomerId } from \"./write-shared.ts\";\n\ntype ArgDefs = Record<string, { type: \"string\" | \"boolean\"; description: string }>;\n\nfunction register(command: string, description: string, args: ArgDefs): void {\n  registerSchema({\n    command,\n    description,\n    args: Object.fromEntries(\n      Object.entries(args).map(([name, arg]) => [\n        name,\n        { type: arg.type, description: arg.description, required: false },\n      ]),\n    ),\n  });\n}\n\nasync function serviceRead<T>(path: string, customerId: string, body: Record<string, unknown>): Promise<T> {\n  const managerId = getManagerIdForCustomer(customerId);\n  const { data } = await apiPost<{ ok: true; data: T }>(path, {\n    customerId,\n    ...(managerId ? { managerId } : {}),\n    ...body,\n  });\n  return data;\n}\n\nconst CUSTOMER_ARG = {\n  \"customer-id\": { type: \"string\", description: \"Google Ads customer ID (10 digits, no dashes)\" },\n} as const;\n\nconst INVOICE_ARGS = {\n  ...CUSTOMER_ARG,\n  month: { type: \"string\", description: \"Issue month, YYYY-MM (default: last month)\" },\n} as const;\n\nregister(\n  \"ads.google.invoices\",\n  \"List the invoices Google issued in one month (accounts on monthly invoicing only): id, dates, service period, subtotal/tax/total in micros, PDF link. Start here: `baker ads google invoices --customer-id 1234567890 --month 2026-09`. An account that pays automatically has no invoices — the error's fix says where its receipts are; carry on.\",\n  INVOICE_ARGS,\n);\n\nexport const invoicesCommand = defineCommand({\n  meta: {\n    name: \"invoices\",\n    description: `List one month's invoices (monthly-invoicing accounts only). Read-only.\n\nExample:\n  baker ads google invoices --customer-id 1234567890 --month 2026-09`,\n  },\n  args: INVOICE_ARGS,\n  run: async ({ args }) => {\n    const customerId = requireCustomerId(args);\n    try {\n      const data = await serviceRead<GoogleInvoicesResponse>(\"/api/ads/google/invoices\", customerId, {\n        ...(args.month ? { month: args.month } : {}),\n      });\n      const hints =\n        data.invoices.length === 0\n          ? [`No invoice was issued in ${data.month}. Try the month before with --month.`]\n          : [\n              \"Amounts are micros in each invoice's currency_code (divide by 1,000,000). pdf_url needs the user's Google sign-in.\",\n            ];\n      writeJsonEnvelope({ ok: true, data, hints });\n    } catch (err) {\n      exitWithServiceReadError(err);\n    }\n  },\n});\n\nregister(\n  \"ads.google.identity-verification\",\n  \"Advertiser identity verification status: each program's status (PENDING_USER_ACTION, PENDING_REVIEW, SUCCESS, FAILURE), deadlines and the link where the user completes it. Start here: `baker ads google identity-verification --customer-id 1234567890`. Google only answers for accounts on monthly invoicing — otherwise the error's fix says where the user reads it; carry on.\",\n  CUSTOMER_ARG,\n);\n\nexport const identityVerificationCommand = defineCommand({\n  meta: {\n    name: \"identity-verification\",\n    description: `Advertiser identity verification status and deadlines. Read-only.\n\nExample:\n  baker ads google identity-verification --customer-id 1234567890`,\n  },\n  args: CUSTOMER_ARG,\n  run: async ({ args }) => {\n    const customerId = requireCustomerId(args);\n    try {\n      const data = await serviceRead<GoogleIdentityVerificationResponse>(\n        \"/api/ads/google/identity-verification\",\n        customerId,\n        {},\n      );\n      const pending = data.programs.filter((program) => program.status === \"PENDING_USER_ACTION\");\n      const hints =\n        pending.length > 0\n          ? [\n              `Verification is waiting on the advertiser${pending[0]?.completion_deadline ? ` (deadline ${pending[0].completion_deadline})` : \"\"}: give the user the action_url — ads stop serving if it lapses.`,\n            ]\n          : [];\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      exitWithServiceReadError(err);\n    }\n  },\n});\n\nconst PREVIEW_ARGS = {\n  ...CUSTOMER_ARG,\n  ads: {\n    type: \"string\",\n    description:\n      \"Comma-separated video ads of Video campaigns as {adGroupId}~{adId} (from `ads list`) — previewed live on YouTube\",\n  },\n  \"asset-groups\": {\n    type: \"string\",\n    description:\n      \"Comma-separated Performance Max asset group ids (from `asset-groups list`) — previewed on Google's preview page\",\n  },\n} as const;\n\nregister(\n  \"ads.google.previews\",\n  \"Shareable preview links for Performance Max asset groups (Google's preview page) and video ads (live on YouTube) that already exist in the account — a link the user can open or forward. Start here: `baker ads google previews --customer-id 1234567890 --asset-groups 6743268912`. Returns { previews: [{ target, url, youtube_tv_url, expires_at }] }. Only video ads of Video campaigns can be previewed by ad (search, display and Demand Gen ads have no shareable preview); staged (unpublished) changes cannot be previewed.\",\n  PREVIEW_ARGS,\n);\n\nexport const previewsCommand = defineCommand({\n  meta: {\n    name: \"previews\",\n    description: `Shareable preview links for existing Performance Max asset groups and video ads. Read-only.\n\nExamples:\n  baker ads google previews --customer-id 1234567890 --asset-groups 6743268912\n  baker ads google previews --customer-id 1234567890 --ads 195752489650~826812181091   # a video ad, live on YouTube`,\n  },\n  args: PREVIEW_ARGS,\n  run: async ({ args }) => {\n    const customerId = requireCustomerId(args);\n    const ads = listFlag(args.ads);\n    const assetGroups = listFlag(args[\"asset-groups\"]);\n    if (!ads?.length && !assetGroups?.length) failWriteValidation(\"pass --ads and/or --asset-groups\");\n    try {\n      const data = await serviceRead<GoogleShareablePreviewsResponse>(\"/api/ads/google/previews\", customerId, {\n        ...(ads ? { ads } : {}),\n        ...(assetGroups ? { assetGroups } : {}),\n      });\n      writeJsonEnvelope({\n        ok: true,\n        data,\n        hints: [\n          \"Each link expires (expires_at). It shows what is live in the account now, not anything staged in this chat.\",\n        ],\n      });\n    } catch (err) {\n      exitWithServiceReadError(err);\n    }\n  },\n});\n\nconst BRAND_ARGS = {\n  ...CUSTOMER_ARG,\n  prefix: { type: \"string\", description: \"The start of the brand's name (at least 2 letters)\" },\n} as const;\n\nregister(\n  \"ads.google.brands\",\n  \"Find a brand's Google entity id — what a BRANDS list member names (`keyword-lists add --brand /g/…`). Start here: `baker ads google brands --customer-id 1234567890 --prefix nike`. Several brands can share a name: pick by the URL. Read-only.\",\n  BRAND_ARGS,\n);\n\nexport const brandsCommand = defineCommand({\n  meta: {\n    name: \"brands\",\n    description: `Find brand entity ids for a brand list (BRANDS). Read-only.\n\nExample:\n  baker ads google brands --customer-id 1234567890 --prefix nike`,\n  },\n  args: BRAND_ARGS,\n  run: async ({ args }) => {\n    const customerId = requireCustomerId(args);\n    if (typeof args.prefix !== \"string\" || args.prefix.trim().length < 2) {\n      failWriteValidation(\"--prefix needs at least the first 2 letters of the brand\");\n    }\n    try {\n      const data = await serviceRead<GoogleBrandSuggestionsResponse>(\"/api/ads/google/brands\", customerId, {\n        prefix: args.prefix,\n      });\n      const hints =\n        data.brands.length > 0\n          ? [\n              \"Several brands can share a name — pick the one whose URL is the brand you mean, then `keyword-lists add --list-ref <BRANDS list> --brand <entity_id>`.\",\n            ]\n          : [\"No brand starts with that — try a shorter or different prefix.\"];\n      writeJsonEnvelope({ ok: true, data, hints });\n    } catch (err) {\n      exitWithServiceReadError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,SAAS,qBAAqB;AAU9B,SAAS,SAAS,SAAiB,aAAqB,MAAqB;AAC3E,iBAAe;AAAA,IACb;AAAA,IACA;AAAA,IACA,MAAM,OAAO;AAAA,MACX,OAAO,QAAQ,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM;AAAA,QACxC;AAAA,QACA,EAAE,MAAM,IAAI,MAAM,aAAa,IAAI,aAAa,UAAU,MAAM;AAAA,MAClE,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACH;AAEA,eAAe,YAAe,MAAc,YAAoB,MAA2C;AACzG,QAAM,YAAY,wBAAwB,UAAU;AACpD,QAAM,EAAE,KAAK,IAAI,MAAM,QAA+B,MAAM;AAAA,IAC1D;AAAA,IACA,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,IACjC,GAAG;AAAA,EACL,CAAC;AACD,SAAO;AACT;AAEA,IAAM,eAAe;AAAA,EACnB,eAAe,EAAE,MAAM,UAAU,aAAa,gDAAgD;AAChG;AAEA,IAAM,eAAe;AAAA,EACnB,GAAG;AAAA,EACH,OAAO,EAAE,MAAM,UAAU,aAAa,6CAA6C;AACrF;AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,aAAa,kBAAkB,IAAI;AACzC,QAAI;AACF,YAAM,OAAO,MAAM,YAAoC,4BAA4B,YAAY;AAAA,QAC7F,GAAI,KAAK,QAAQ,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;AAAA,MAC5C,CAAC;AACD,YAAM,QACJ,KAAK,SAAS,WAAW,IACrB,CAAC,4BAA4B,KAAK,KAAK,sCAAsC,IAC7E;AAAA,QACE;AAAA,MACF;AACN,wBAAkB,EAAE,IAAI,MAAM,MAAM,MAAM,CAAC;AAAA,IAC7C,SAAS,KAAK;AACZ,+BAAyB,GAAG;AAAA,IAC9B;AAAA,EACF;AACF,CAAC;AAED;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,8BAA8B,cAAc;AAAA,EACvD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,aAAa,kBAAkB,IAAI;AACzC,QAAI;AACF,YAAM,OAAO,MAAM;AAAA,QACjB;AAAA,QACA;AAAA,QACA,CAAC;AAAA,MACH;AACA,YAAM,UAAU,KAAK,SAAS,OAAO,CAAC,YAAY,QAAQ,WAAW,qBAAqB;AAC1F,YAAM,QACJ,QAAQ,SAAS,IACb;AAAA,QACE,4CAA4C,QAAQ,CAAC,GAAG,sBAAsB,cAAc,QAAQ,CAAC,EAAE,mBAAmB,MAAM,EAAE;AAAA,MACpI,IACA,CAAC;AACP,wBAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACrF,SAAS,KAAK;AACZ,+BAAyB,GAAG;AAAA,IAC9B;AAAA,EACF;AACF,CAAC;AAED,IAAM,eAAe;AAAA,EACnB,GAAG;AAAA,EACH,KAAK;AAAA,IACH,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,gBAAgB;AAAA,IACd,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AACF;AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,aAAa,kBAAkB,IAAI;AACzC,UAAM,MAAM,SAAS,KAAK,GAAG;AAC7B,UAAM,cAAc,SAAS,KAAK,cAAc,CAAC;AACjD,QAAI,CAAC,KAAK,UAAU,CAAC,aAAa,OAAQ,qBAAoB,kCAAkC;AAChG,QAAI;AACF,YAAM,OAAO,MAAM,YAA6C,4BAA4B,YAAY;AAAA,QACtG,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;AAAA,QACrB,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;AAAA,MACvC,CAAC;AACD,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,QACA,OAAO;AAAA,UACL;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,+BAAyB,GAAG;AAAA,IAC9B;AAAA,EACF;AACF,CAAC;AAED,IAAM,aAAa;AAAA,EACjB,GAAG;AAAA,EACH,QAAQ,EAAE,MAAM,UAAU,aAAa,qDAAqD;AAC9F;AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,aAAa,kBAAkB,IAAI;AACzC,QAAI,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,KAAK,EAAE,SAAS,GAAG;AACpE,0BAAoB,0DAA0D;AAAA,IAChF;AACA,QAAI;AACF,YAAM,OAAO,MAAM,YAA4C,0BAA0B,YAAY;AAAA,QACnG,QAAQ,KAAK;AAAA,MACf,CAAC;AACD,YAAM,QACJ,KAAK,OAAO,SAAS,IACjB;AAAA,QACE;AAAA,MACF,IACA,CAAC,qEAAgE;AACvE,wBAAkB,EAAE,IAAI,MAAM,MAAM,MAAM,CAAC;AAAA,IAC7C,SAAS,KAAK;AACZ,+BAAyB,GAAG;AAAA,IAC9B;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/account-users-7NKBUVYA.js

@@ -0,0 +1,65 @@
+import {
+  bareAccountId
+} from "./chunk-7YMQEAGA.js";
+import {
+  handleLinkedinError
+} from "./chunk-34MZGC2Y.js";
+import "./chunk-LZR7LSYO.js";
+import "./chunk-55AX6DOP.js";
+import "./chunk-MX5NQAK6.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-4H6XLX7E.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-YOHGEF2N.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/account-users.ts
+import { defineCommand } from "citty";
+var accountUsersCommand = defineCommand({
+  meta: {
+    name: "account-users",
+    description: `Who works on the ad account and their Campaign Manager role (Billing admin, Account manager, Campaign manager, Creative manager, Viewer); \`connectedLinkedin: true\` marks the person whose connection Baker publishes with.
+Start here when: a conversation or message ad needs a sender (\`creatives create --format conversation --sender <person>\` \u2014 the default is the connected person), or a publish was refused for want of a role (a Viewer or Creative manager can't change campaigns).
+LinkedIn only gives this app each person's id, not their name.
+Example: baker ads linkedin account-users --account-id 513852526`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/account-users", {
+        "account-id": bareAccountId(args)
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  accountUsersCommand
+};
+//# sourceMappingURL=account-users-7NKBUVYA.js.map

package/dist/account-users-7NKBUVYA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/account-users.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleLinkedinError } from \"./shared.ts\";\nimport { bareAccountId } from \"./write-shared.ts\";\n\nexport const accountUsersCommand = defineCommand({\n  meta: {\n    name: \"account-users\",\n    description: `Who works on the ad account and their Campaign Manager role (Billing admin, Account manager, Campaign manager, Creative manager, Viewer); \\`connectedLinkedin: true\\` marks the person whose connection Baker publishes with.\nStart here when: a conversation or message ad needs a sender (\\`creatives create --format conversation --sender <person>\\` — the default is the connected person), or a publish was refused for want of a role (a Viewer or Creative manager can't change campaigns).\nLinkedIn only gives this app each person's id, not their name.\nExample: baker ads linkedin account-users --account-id 513852526`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n  },\n  run: async ({ args }) => {\n    try {\n      const data = await apiGet<unknown[]>(\"/api/ads/linkedin/account-users\", {\n        \"account-id\": bareAccountId(args as Record<string, unknown>),\n      });\n      writeJsonEnvelope({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAMvB,IAAM,sBAAsB,cAAc;AAAA,EAC/C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,IAC/F,eAAe,EAAE,MAAM,UAAU,aAAa,yBAAyB;AAAA,EACzE;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAO,MAAM,OAAkB,mCAAmC;AAAA,QACtE,cAAc,cAAc,IAA+B;AAAA,MAC7D,CAAC;AACD,wBAAkB,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACtC,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/account-writes-IUIXIVRC.js

@@ -0,0 +1,68 @@
+import {
+  compact,
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-BPDIY5CF.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  chatgptFailure
+} from "./chunk-3JOGDGGP.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/account-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.account;
+var UPDATE_ARGS = {
+  name: { type: "string", description: "The advertiser name shown on every card" },
+  "favicon-url": { type: "string", description: "https:// square icon, at least 128 \xD7 128 px" }
+};
+registerSchema({
+  command: "ads.chatgpt.account.update",
+  description: "Stage a change to the advertiser's brand name or icon. It applies when the chat is published and starts a new brand review; nothing in the account serves until it is approved.",
+  args: schemaArgs(UPDATE_ARGS)
+});
+var accountUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to the brand name or icon (applies when the chat is published).
+
+Examples:
+  baker ads chatgpt account update --favicon-url https://example.com/icon.png
+  baker ads chatgpt account update --name "GreenLeaf Energy"`
+  },
+  args: UPDATE_ARGS,
+  run: async ({ args }) => {
+    let account;
+    try {
+      account = await apiGet("/api/ads/chatgpt/account");
+    } catch (err) {
+      writeJsonEnvelope({ ...chatgptFailure(err, REFERENCE) });
+      process.exit(1);
+    }
+    await stageChatgptOp(
+      {
+        kind: "account.update",
+        target: account.id,
+        payload: compact({ name: args.name, faviconUrl: args["favicon-url"] })
+      },
+      REFERENCE
+    );
+  }
+});
+export {
+  accountUpdateCommand
+};
+//# sourceMappingURL=account-writes-IUIXIVRC.js.map

package/dist/accounts-4YRDRLHX.js

@@ -0,0 +1,80 @@
+import {
+  csvOrJson,
+  handleLinkedinError
+} from "./chunk-34MZGC2Y.js";
+import {
+  connectedResourceHints
+} from "./chunk-P4NSJS54.js";
+import {
+  AVAILABLE_ARG,
+  writeAvailableAccounts
+} from "./chunk-A4O3JL6D.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-MK4HCMEA.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-YOHGEF2N.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/accounts.ts
+import { defineCommand } from "citty";
+function accountHints(accounts) {
+  return connectedResourceHints({
+    plural: "LinkedIn ad accounts",
+    singular: "LinkedIn ad account",
+    flag: "--account-id",
+    resources: accounts.map((account) => ({ id: account.externalId, label: account.name }))
+  });
+}
+var accountsCommand = defineCommand({
+  meta: {
+    name: "accounts",
+    description: `List LinkedIn ad accounts in this company's connected scope.
+
+Examples:
+  baker ads linkedin accounts
+  baker ads linkedin accounts --output csv
+  baker ads linkedin accounts --available   # every account the login reaches, selected or not`
+  },
+  args: {
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "Output format: json|csv|jsonl|md", default: "json" },
+    available: AVAILABLE_ARG
+  },
+  run: async ({ args }) => {
+    if (args.available) return writeAvailableAccounts("linkedin", handleLinkedinError);
+    try {
+      const params = {};
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/accounts", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data, hints: accountHints(data) });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  accountsCommand
+};
+//# sourceMappingURL=accounts-4YRDRLHX.js.map