@koda-sl/baker-cli 0.530.0 → 0.532.0

package/dist/activities-YH4K4JAI.js

@@ -0,0 +1,75 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-MUEJVDHI.js";
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-IQWFJEA3.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-LV7EU6HM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-NLW25WW3.js";
+import "./chunk-65Y3RCWP.js";
+import {
+  apiGet
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/activities.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  days: { type: "string", description: "Lookback days (default 7)" },
+  limit: { type: "string", description: "Max rows" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "activities",
+  "Account change log, as a table by default, one row per event: event_time, event_type, actor_name, object_type, object_name, object_id, and change ('old \u2192 new' when the change is a single value). Start here: baker ads meta activities --account-id act_123 --days 2. --fields event_time,object_name,extra_data or --full for the raw change payload; --output json returns the rows in the envelope.",
+  listArgs
+);
+var activitiesCommand = defineCommand({
+  meta: {
+    name: "activities",
+    description: `Audit log of recent ad-account changes (created, paused, edited). Default lookback 7 days,
+~90 day retention server-side.
+
+A table by default, one row per event: event_time, event_type, actor_name, object_type,
+object_name, object_id, and change ("old \u2192 new" when the change is a single value: status,
+name, budget, goal). --fields takes dotted paths (extra_data holds the raw change); --full returns
+every field Meta sent; --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta activities --account-id act_123 --days 14
+  baker ads meta activities --account-id act_123 --days 2 --output json
+  baker ads meta activities --account-id act_123 --fields event_time,object_name,extra_data`
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = await resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args.days) params.days = args.days;
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/activities", params);
+      const shaped = shapeMetaListRows("activities", data, args);
+      writeMetaListRows("activities", shaped, csvOrJson(args));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  activitiesCommand
+};
+//# sourceMappingURL=activities-YH4K4JAI.js.map

package/dist/ad-group-writes-7BGCZA3M.js

@@ -0,0 +1,172 @@
+import {
+  clearableArg,
+  compact,
+  failWriteValidation,
+  lowerArg,
+  microsFromArg,
+  productFiltersArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-PIAG4UJT.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-QKNPF6ZD.js";
+import "./chunk-LV7EU6HM.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ad-group-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.adGroups;
+var SHARED_ARGS = {
+  name: { type: "string", description: "Ad group name (3+ characters)" },
+  description: { type: "string", description: "Internal description" },
+  "context-hints": {
+    type: "string",
+    description: "When the ad would be useful, short phrases separated by commas \u2014 or by | when a phrase has a comma. ChatGPT's counterpart to keywords, written in the language of the campaign's countries, as people ask ChatGPT. On update it replaces the whole list; none clears it"
+  },
+  "bid-strategy": {
+    type: "string",
+    description: "fixed_bid (default, needs --max-bid) | maximize_clicks | maximize_conversions"
+  },
+  "max-bid": { type: "string", description: "Bid in account currency, e.g. 2.50 \u2014 fixed_bid only" },
+  "tracking-template": {
+    type: "string",
+    description: "Query string added to this ad group's landing pages, e.g. ad_group_id={ad_group_id} \u2014 none clears"
+  },
+  "audience-bids": {
+    type: "string",
+    description: "Raise or lower the fixed bid for people in an audience: audience=multiplier pairs, 0.1 to 10, e.g. caud_123=1.5,caud_456=0.8. Audiences of ~25,000 people only; not in the EEA or Switzerland. On update it replaces them; none clears"
+  },
+  "product-filters": {
+    type: "string",
+    description: "Catalog campaigns only: which products it shows \u2014 e.g. brand in Acme; price lte 5000 (preview with `catalogs products`). On update it replaces the set; none shows the whole catalog"
+  },
+  status: { type: "string", description: "paused (default) | active" }
+};
+var CREATE_ARGS = {
+  ...SHARED_ARGS,
+  "campaign-id": { type: "string", description: "cmpn_\u2026 or a staged chatgpt_temp_ ref", required: true },
+  name: { type: "string", description: "Ad group name (3+ characters)", required: true }
+};
+var UPDATE_ARGS = {
+  id: { type: "positional", description: "Ad group id (adgrp_\u2026) or a staged chatgpt_temp_ ref", required: true },
+  ...SHARED_ARGS
+};
+function contextHintsArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  if (value.trim().toLowerCase() === "none") {
+    return [];
+  }
+  const separator = value.includes("|") ? "|" : ",";
+  return value.split(separator).map((hint) => hint.trim()).filter(Boolean);
+}
+function audienceBidsArg(value) {
+  if (typeof value !== "string" || value.trim() === "") {
+    return void 0;
+  }
+  if (value.trim().toLowerCase() === "none") {
+    return [];
+  }
+  return value.split(",").map((pair) => pair.trim()).filter(Boolean).map((pair) => {
+    const [audienceId = "", multiplier = ""] = pair.split("=").map((part) => part.trim());
+    const times = Number(multiplier.replace(",", "."));
+    if (!audienceId || !Number.isFinite(times)) {
+      failWriteValidation(`"${pair}" is not an audience bid \u2014 write audience=multiplier, e.g. caud_123=1.5`);
+    }
+    return { audienceId, multiplierMicros: Math.round(times * 1e6) };
+  });
+}
+function productSetArg(value) {
+  const filters = productFiltersArg(value);
+  return filters === void 0 ? void 0 : { filters };
+}
+function sharedPayload(args) {
+  return {
+    name: args.name,
+    description: args.description,
+    contextHints: contextHintsArg(args["context-hints"]),
+    bidStrategy: lowerArg(args["bid-strategy"]),
+    maxBidMicros: microsFromArg(args["max-bid"], "--max-bid"),
+    trackingTemplate: clearableArg(args["tracking-template"]),
+    productSet: productSetArg(args["product-filters"]),
+    audienceBidMultipliers: audienceBidsArg(args["audience-bids"]),
+    status: lowerArg(args.status)
+  };
+}
+function adGroupCreateOp(args) {
+  return { kind: "adGroup.create", payload: compact({ ...sharedPayload(args), campaignId: args["campaign-id"] }) };
+}
+registerSchema({
+  command: "ads.chatgpt.ad-groups.create",
+  description: "Stage a new ad group under a live campaign (cmpn_\u2026) or one staged in this chat (its chatgpt_temp_ ref). Context hints decide where the ad shows; a fixed bid needs --max-bid.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var adGroupsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new ad group (applies when the chat is published).
+
+Examples:
+  baker ads chatgpt ad-groups create --campaign-id cmpn_123 --name "Rooftop owners" --context-hints "solar panels for my house,cut my electricity bill" --max-bid 2.50
+  baker ads chatgpt ad-groups create --campaign-id chatgpt_temp_ab12 --name "Auto" --bid-strategy maximize_clicks`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(adGroupCreateOp(args), REFERENCE, (staged) => [
+      adGroupNextHint(staged.ref, args["product-filters"] !== void 0)
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.ad-groups.update",
+  description: "Stage a change to an ad group \u2014 name, context hints, bid or status. --context-hints replaces the whole list: read the ad group first and pass every hint to keep.",
+  args: schemaArgs(UPDATE_ARGS)
+});
+var adGroupsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to an ad group. --context-hints replaces the whole list.
+
+Examples:
+  baker ads chatgpt ad-groups update adgrp_123 --max-bid 3
+  baker ads chatgpt ad-groups update adgrp_123 --context-hints "solar panels,home battery,cut my electricity bill"`
+  },
+  args: UPDATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(
+      { kind: "adGroup.update", target: requireTarget(args, "id"), payload: compact(sharedPayload(args)) },
+      REFERENCE
+    );
+  }
+});
+var adGroupsPauseCommand = statusCommand("adGroup", "pause", REFERENCE);
+var adGroupsResumeCommand = statusCommand("adGroup", "resume", REFERENCE);
+var adGroupsArchiveCommand = statusCommand("adGroup", "archive", REFERENCE);
+function adGroupNextHint(ref, productFilters) {
+  const productAd = `baker ads chatgpt ads create-product --ad-group-id ${ref} --name "\u2026"`;
+  return productFilters ? `Next, give it its product ad: ${productAd}` : `Next, give it a card: baker ads chatgpt ads create --ad-group-id ${ref} --name "\u2026" --title "\u2026" --body "\u2026" --target-url https://\u2026 --image-url https://\u2026 \u2014 under a catalog campaign, its product ad instead: ${productAd}`;
+}
+export {
+  adGroupCreateOp,
+  adGroupNextHint,
+  adGroupsArchiveCommand,
+  adGroupsCreateCommand,
+  adGroupsPauseCommand,
+  adGroupsResumeCommand,
+  adGroupsUpdateCommand,
+  audienceBidsArg,
+  contextHintsArg
+};
+//# sourceMappingURL=ad-group-writes-7BGCZA3M.js.map

package/dist/ad-groups-A6GU6EW5.js

@@ -0,0 +1,70 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-QKNPF6ZD.js";
+import "./chunk-LV7EU6HM.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ad-groups.ts
+import { defineCommand } from "citty";
+var args = {
+  "campaign-id": { type: "string", description: "Only this campaign's ad groups (cmpn_\u2026)", required: false },
+  full: { type: "boolean", description: "Return ChatGPT Ads' own ad group objects", required: false }
+};
+registerSchema({
+  command: "ads.chatgpt.ad-groups",
+  description: "Ad groups in the connected ChatGPT Ads account, or in one campaign: bid strategy, billing event, max bid (currency units), context hints (when the ad should show \u2014 ChatGPT's counterpart to keywords) and serving issues.",
+  args
+});
+var adGroupsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "ChatGPT Ads ad groups. Example: baker ads chatgpt ad-groups --campaign-id cmpn_123"
+  },
+  args,
+  run: async ({ args: input }) => {
+    const params = {};
+    if (input["campaign-id"]) {
+      params["campaign-id"] = input["campaign-id"];
+    }
+    if (input.full) {
+      params.full = "true";
+    }
+    await runChatgptListRead(CHATGPT_ADS_REFERENCE.adGroups, "/api/ads/chatgpt/ad-groups", params);
+  }
+});
+var adGroupsCommand = defineCommand({
+  meta: {
+    name: "ad-groups",
+    description: `ChatGPT Ads ad groups: how each one bids and the context hints that decide where it shows \u2014 or stage a change that applies when the chat is published.
+
+Examples:
+  baker ads chatgpt ad-groups --campaign-id cmpn_123
+  baker ads chatgpt ad-groups create --campaign-id cmpn_123 --name "Rooftop owners" --context-hints "solar panels for my house" --max-bid 2.50
+  baker ads chatgpt ad-groups update adgrp_123 --max-bid 3
+  baker ads chatgpt ad-groups pause adgrp_123`
+  },
+  subCommands: {
+    list: adGroupsListCommand,
+    create: () => import("./ad-group-writes-7BGCZA3M.js").then((m) => m.adGroupsCreateCommand),
+    update: () => import("./ad-group-writes-7BGCZA3M.js").then((m) => m.adGroupsUpdateCommand),
+    pause: () => import("./ad-group-writes-7BGCZA3M.js").then((m) => m.adGroupsPauseCommand),
+    resume: () => import("./ad-group-writes-7BGCZA3M.js").then((m) => m.adGroupsResumeCommand),
+    archive: () => import("./ad-group-writes-7BGCZA3M.js").then((m) => m.adGroupsArchiveCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args,
+  default: "list"
+});
+export {
+  adGroupsCommand
+};
+//# sourceMappingURL=ad-groups-A6GU6EW5.js.map

package/dist/ad-writes-CEMCUDU2.js

@@ -0,0 +1,176 @@
+import {
+  clearableArg,
+  compact,
+  cropArg,
+  lowerArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-PIAG4UJT.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-QKNPF6ZD.js";
+import "./chunk-LV7EU6HM.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ad-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.ads;
+var SHARED_ARGS = {
+  name: { type: "string", description: "Internal ad name (3+ characters)" },
+  title: { type: "string", description: "Card title, 3\u201350 characters" },
+  body: { type: "string", description: "Card text, up to 100 characters" },
+  "target-url": { type: "string", description: "Landing page, https://" },
+  "image-url": {
+    type: "string",
+    description: "Card image, https:// \u2014 PNG, JPEG, WebP or AVIF; square and 640 \xD7 640 px or larger reads best"
+  },
+  "image-crop": {
+    type: "string",
+    description: "The square of the image the card shows, as x,y,width,height shares from 0 to 1, e.g. 0.1,0,0.8,0.8 (default: chosen by ChatGPT Ads)"
+  },
+  "tracking-template": {
+    type: "string",
+    description: "Query string added to this card's landing page, e.g. ad_id={ad_id} \u2014 none clears"
+  },
+  status: { type: "string", description: "paused (default) | active" }
+};
+var CREATE_ARGS = {
+  ...SHARED_ARGS,
+  "ad-group-id": { type: "string", description: "adgrp_\u2026 or a staged chatgpt_temp_ ref", required: true },
+  name: { type: "string", description: "Internal ad name (3+ characters)", required: true },
+  title: { type: "string", description: "Card title, 3\u201350 characters", required: true },
+  body: { type: "string", description: "Card text, up to 100 characters", required: true },
+  "target-url": { type: "string", description: "Landing page, https://", required: true },
+  "image-url": { type: "string", description: "Card image, https://, at least 640 \xD7 640 px", required: true }
+};
+var UPDATE_ARGS = {
+  id: { type: "positional", description: "Ad id (ad_\u2026) or a staged chatgpt_temp_ ref", required: true },
+  ...SHARED_ARGS
+};
+function sharedPayload(args) {
+  return {
+    name: args.name,
+    title: args.title,
+    body: args.body,
+    targetUrl: args["target-url"],
+    imageUrl: args["image-url"],
+    imageCrop: cropArg(args["image-crop"], "--image-crop"),
+    trackingTemplate: clearableArg(args["tracking-template"]),
+    status: lowerArg(args.status)
+  };
+}
+function adCreateOp(args) {
+  return { kind: "ad.create", payload: compact({ ...sharedPayload(args), adGroupId: args["ad-group-id"] }) };
+}
+registerSchema({
+  command: "ads.chatgpt.ads.create",
+  description: "Stage a new chat card under a live ad group (adgrp_\u2026) or one staged in this chat. Every new card goes through ChatGPT Ads' review after publish before it serves.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var adsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new chat card (applies when the chat is published).
+
+Example:
+  baker ads chatgpt ads create --ad-group-id adgrp_123 --name "Card A" --title "Solar from 0 upfront" \\
+    --body "Get a quote in two minutes." --target-url https://example.com/solar --image-url https://example.com/card.png`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(adCreateOp(args), REFERENCE, () => [
+      "Review everything staged with `baker ads chatgpt draft`. It applies when the chat is published."
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.ads.update",
+  description: "Stage a change to a chat card \u2014 any of title, body, landing page, image, name or status; the rest is kept from the live card. Changing the card sends it back to review.",
+  args: schemaArgs(UPDATE_ARGS)
+});
+var adsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to a chat card; what you do not pass is kept.
+
+Examples:
+  baker ads chatgpt ads update ad_123 --title "Solar with no upfront cost"
+  baker ads chatgpt ads update ad_123 --target-url https://example.com/solar-v2`
+  },
+  args: UPDATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(
+      { kind: "ad.update", target: requireTarget(args, "id"), payload: compact(sharedPayload(args)) },
+      REFERENCE
+    );
+  }
+});
+var adsPauseCommand = statusCommand("ad", "pause", REFERENCE);
+var adsResumeCommand = statusCommand("ad", "resume", REFERENCE);
+var adsArchiveCommand = statusCommand("ad", "archive", REFERENCE);
+var PRODUCT_ARGS = {
+  "ad-group-id": {
+    type: "string",
+    description: "adgrp_\u2026 under a catalog campaign, or a staged chatgpt_temp_ ref",
+    required: true
+  },
+  name: { type: "string", description: "Internal ad name (3+ characters)", required: true },
+  title: {
+    type: "string",
+    description: "Title template (default {{product.title}}) \u2014 text with {{brand}}, {{product.title}}, {{product.body}}, {{product.price}}"
+  },
+  "tracking-template": { type: "string", description: "Query string added to each product's landing page" },
+  status: { type: "string", description: "paused (default) | active" }
+};
+function productAdCreateOp(args) {
+  return {
+    kind: "ad.create",
+    payload: compact({
+      format: "product_template",
+      adGroupId: args["ad-group-id"],
+      name: args.name,
+      title: args.title,
+      trackingTemplate: args["tracking-template"],
+      status: lowerArg(args.status)
+    })
+  };
+}
+registerSchema({
+  command: "ads.chatgpt.ads.create-product",
+  description: "Stage the product ad of a catalog ad group: one template each product fills with its own title, text, price, image and link. One per ad group.",
+  args: schemaArgs(PRODUCT_ARGS)
+});
+var adsCreateProductCommand = defineCommand({
+  meta: {
+    name: "create-product",
+    description: `Stage a product ad for a catalog ad group (applies when the chat is published).
+
+Example:
+  baker ads chatgpt ads create-product --ad-group-id adgrp_123 --name "Catalog ad" --title "{{brand}}: {{product.title}}"`
+  },
+  args: PRODUCT_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(productAdCreateOp(args), REFERENCE);
+  }
+});
+export {
+  adCreateOp,
+  adsArchiveCommand,
+  adsCreateCommand,
+  adsCreateProductCommand,
+  adsPauseCommand,
+  adsResumeCommand,
+  adsUpdateCommand,
+  productAdCreateOp
+};
+//# sourceMappingURL=ad-writes-CEMCUDU2.js.map

package/dist/add-2L2VQ5MU.js

@@ -0,0 +1,80 @@
+import {
+  nextStepHints,
+  reportError,
+  validationError
+} from "./chunk-ULW4EWAA.js";
+import {
+  postsAddRequestSchema
+} from "./chunk-WCU362Z6.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/posts/add.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "posts.add",
+  description: "Add one post by its link \u2014 the way in for a private profile's posts (many people's LinkedIn profiles are), or for a post by someone the company doesn't follow. Any link to the post works; the embed link isn't needed. Reads the post's text, author and numbers, works out whether it can run as an ad, and imports its images and videos into the libraries (not a YouTube video: the hint says how). Applies immediately and shows on the chat as an already-applied change. Costs one read.",
+  args: {
+    url: { type: "string", description: "The post's link", required: true },
+    media: {
+      type: "boolean",
+      description: "Import its images and videos into the libraries (default); --no-media records the post only",
+      required: false
+    }
+  }
+});
+function youtubeVideoId(url) {
+  return url.match(/(?:[?&]v=|\/shorts\/|youtu\.be\/)([\w-]{11})/)?.[1];
+}
+function addHints(data, link) {
+  const hints = nextStepHints(data.post);
+  if (data.media && data.media.failed > 0) {
+    hints.push(
+      `${data.media.failed} of its files couldn't be fetched, so they aren't in the libraries; the post itself is saved.`
+    );
+  }
+  const videoId = data.post.platform === "youtube" ? youtubeVideoId(link) : void 0;
+  if (videoId) {
+    hints.push(
+      `To put the video itself in the video library: \`baker videos ingest ${link} --source youtube --external-id youtube:${videoId}\`.`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Add a post by its link, with its images and videos.\n\nExamples:\n  baker posts add https://www.linkedin.com/posts/jane-doe_we-closed-activity-7477679889043750912-K2pu\n  baker posts add https://www.instagram.com/p/Dek_RAKjMDJ/ --no-media"
+  },
+  args: {
+    url: { type: "positional", description: "The post's link", required: true },
+    media: {
+      type: "boolean",
+      description: "Import its images and videos into the libraries (default); --no-media records the post only",
+      default: true
+    }
+  },
+  run: async ({ args }) => {
+    const parsed = postsAddRequestSchema.safeParse({ url: String(args.url ?? ""), media: args.media !== false });
+    if (!parsed.success) validationError(parsed.error.issues[0]?.message ?? "Pass the post's link");
+    try {
+      const data = await apiPost("/api/posts/add", parsed.data, { timeoutMs: 12e4 });
+      writeJson({ ok: true, data, hints: addHints(data, parsed.data.url) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addHints
+};
+//# sourceMappingURL=add-2L2VQ5MU.js.map

package/dist/add-DRTKSLEQ.js

@@ -0,0 +1,107 @@
+import {
+  compactSource,
+  reportError,
+  reportInvalid
+} from "./chunk-QTLIXCVN.js";
+import {
+  testimonialSourceRefreshIntervalSchema,
+  testimonialSourceTypeSchema,
+  testimonialSourcesAddRequestSchema
+} from "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/add.ts
+import { defineCommand } from "citty";
+var SITES = testimonialSourceTypeSchema.options.join("|");
+registerSchema({
+  command: "testimonials.sources.add",
+  description: "Add a review page as a testimonial source \u2014 Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store or Google Play. Pass the page's link (it names its own site), or a business name for Google Maps. Its reviews (up to 700) are imported, tagged and made searchable in the background over the next minutes. Each imported review costs a little, so add only the client's own listings the user asked for. Applies immediately and shows on the chat as an already-applied change. Adding a listing that is already a source is a no-op that starts a fresh import.",
+  args: {
+    input: {
+      type: "string",
+      description: "The review page's link, or a business name (Google Maps only)",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: `Only to force a site: ${SITES}. A bare domain with trustpilot is that company's Trustpilot page.`,
+      required: false
+    },
+    every: {
+      type: "string",
+      description: `Auto-sync cadence: ${testimonialSourceRefreshIntervalSchema.options.join("|")} (default never)`,
+      required: false
+    }
+  }
+});
+function addSourceHints(input, { created, source }) {
+  const hints = [
+    created ? `Added ${source.label} on ${source.platformLabel}. Its reviews are importing in the background \u2014 they become searchable with \`baker testimonials search\` as each one is analysed, usually within a few minutes. Don't wait on them in this turn; check with \`baker testimonials sources list\`.` : `${source.label} on ${source.platformLabel} was already a source; a fresh import was started if one wasn't running.`
+  ];
+  if (created && source.platform === "google" && !/^https?:\/\/|\.[a-z]{2,}\//i.test(input.trim())) {
+    hints.push(
+      `Matched the name to ${source.label} on Google Maps (${source.pageUrl ?? "no link"}). If that is not the client's business, run \`baker testimonials sources remove ${source.id}\` at once and add the listing's Google Maps link instead.`
+    );
+  }
+  if (source.refreshInterval === "never") {
+    hints.push(
+      `Auto-sync is off. If the user wants new reviews to keep arriving: \`baker testimonials sources schedule ${source.id} --every monthly\`.`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: `Add a review page as a testimonial source. Start here with the page's link; for Google Maps a business name also works.
+
+Examples:
+  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid
+  baker testimonials sources add https://www.g2.com/products/acme --every monthly
+  baker testimonials sources add "Acme Bakery Madrid"          # Google Maps, found by name
+  baker testimonials sources add acme.com --platform trustpilot`
+  },
+  args: {
+    input: { type: "positional", description: "Review page link, or a business name for Google Maps", required: true },
+    platform: { type: "string", description: `Force a site: ${SITES}`, required: false },
+    every: { type: "string", description: "Auto-sync: never|daily|weekly|monthly", required: false }
+  },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesAddRequestSchema.safeParse({
+      input: String(args.input ?? ""),
+      platform: args.platform ? String(args.platform).toLowerCase().replace(/[\s-]/g, "_") : void 0,
+      every: args.every ? String(args.every).toLowerCase() : void 0
+    });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/add", parsed.data, {
+        timeoutMs: 12e4
+      });
+      const hints = addSourceHints(parsed.data.input, data);
+      writeJson({ ok: true, data: { created: data.created, source: compactSource(data.source) }, hints });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addSourceHints
+};
+//# sourceMappingURL=add-DRTKSLEQ.js.map