@koda-sl/baker-cli 0.384.0 → 0.385.0-dev.f7ef4c7e1

package/dist/active-entities-YB46ADQN.js

@@ -0,0 +1,103 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-FMGW2NZI.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson
+} from "./chunk-EIGXX6KI.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/active-entities.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.activeEntities",
+  description: "List entities (campaigns/line items) that had metric activity within a time range. Use this to narrow which entities to query for stats. Time range max 90 days. Times must be ISO 8601 hour-aligned.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET", required: true },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: true },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: true },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function parseCsv(v) {
+  if (typeof v !== "string" || v.length === 0) return void 0;
+  const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+var activeEntitiesCommand = defineCommand({
+  meta: {
+    name: "active-entities",
+    description: `List entities with metric activity in a time range.
+
+Examples:
+  baker ads x active-entities --account-id 18ce53xyz --entity LINE_ITEM \\
+    --start-time 2026-04-30T00:00:00Z --end-time 2026-05-07T00:00:00Z`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET", required: true },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: true },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: true },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const body = {
+      accountId,
+      entity: args.entity,
+      startTime: args["start-time"],
+      endTime: args["end-time"],
+      fundingInstrumentIds: parseCsv(args["funding-instrument-ids"]),
+      campaignIds: parseCsv(args["campaign-ids"]),
+      lineItemIds: parseCsv(args["line-item-ids"]),
+      skipCache: !useCache || void 0
+    };
+    const cacheKey = `active-entities:${JSON.stringify(body)}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const data = await apiPost("/api/ads/x/active-entities", body);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 5 * 60 * 1e3);
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  activeEntitiesCommand
+};
+//# sourceMappingURL=active-entities-YB46ADQN.js.map

package/dist/active-entities-YB46ADQN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/active-entities.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { cacheGet, cacheSet } from \"../cache.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport { parseXApiError } from \"./error-parser.ts\";\nimport { resolveXAccountId } from \"./output.ts\";\n\nregisterSchema({\n  command: \"ads.x.activeEntities\",\n  description:\n    \"List entities (campaigns/line items) that had metric activity within a time range. Use this to narrow which entities to query for stats. Time range max 90 days. Times must be ISO 8601 hour-aligned.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    entity: { type: \"string\", description: \"CAMPAIGN | LINE_ITEM | PROMOTED_TWEET\", required: true },\n    \"start-time\": { type: \"string\", description: \"ISO 8601 hour-aligned start\", required: true },\n    \"end-time\": { type: \"string\", description: \"ISO 8601 hour-aligned end\", required: true },\n    \"campaign-ids\": { type: \"string\", description: \"CSV of campaign IDs\", required: false },\n    \"line-item-ids\": { type: \"string\", description: \"CSV of line item IDs\", required: false },\n    \"funding-instrument-ids\": { type: \"string\", description: \"CSV of funding instrument IDs\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n  },\n});\n\nfunction parseCsv(v: unknown): string[] | undefined {\n  if (typeof v !== \"string\" || v.length === 0) return undefined;\n  const parts = v\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  return parts.length > 0 ? parts : undefined;\n}\n\nexport const activeEntitiesCommand = defineCommand({\n  meta: {\n    name: \"active-entities\",\n    description: `List entities with metric activity in a time range.\n\nExamples:\n  baker ads x active-entities --account-id 18ce53xyz --entity LINE_ITEM \\\\\n    --start-time 2026-04-30T00:00:00Z --end-time 2026-05-07T00:00:00Z`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    entity: { type: \"string\", description: \"CAMPAIGN | LINE_ITEM | PROMOTED_TWEET\", required: true },\n    \"start-time\": { type: \"string\", description: \"ISO 8601 hour-aligned start\", required: true },\n    \"end-time\": { type: \"string\", description: \"ISO 8601 hour-aligned end\", required: true },\n    \"campaign-ids\": { type: \"string\", description: \"CSV of campaign IDs\", required: false },\n    \"line-item-ids\": { type: \"string\", description: \"CSV of line item IDs\", required: false },\n    \"funding-instrument-ids\": { type: \"string\", description: \"CSV of funding instrument IDs\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n  },\n  run: async ({ args }) => {\n    const accountId = await resolveXAccountId(args);\n    const useCache = !args[\"no-cache\"];\n    const body = {\n      accountId,\n      entity: args.entity as string,\n      startTime: args[\"start-time\"] as string,\n      endTime: args[\"end-time\"] as string,\n      fundingInstrumentIds: parseCsv(args[\"funding-instrument-ids\"]),\n      campaignIds: parseCsv(args[\"campaign-ids\"]),\n      lineItemIds: parseCsv(args[\"line-item-ids\"]),\n      skipCache: !useCache || undefined,\n    };\n    const cacheKey = `active-entities:${JSON.stringify(body)}`;\n    if (useCache) {\n      const cached = cacheGet<unknown[]>(\"x-account-data\", cacheKey);\n      if (cached) {\n        writeAdsJson({ ok: true, data: cached.data, cached: true });\n        return;\n      }\n    }\n    try {\n      const data = await apiPost<unknown[]>(\"/api/ads/x/active-entities\", body);\n      if (useCache) {\n        cacheSet(\"x-account-data\", cacheKey, data, 5 * 60 * 1000);\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeAdsJson(parseXApiError(err.message, accountId));\n        process.exit(1);\n      }\n      writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/activities-DUAIQJLN.js

@@ -0,0 +1,74 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-B4S72KSS.js";
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-2UFRHW3T.js";
+import "./chunk-EIGXX6KI.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-ZNQRDLSS.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  apiGet
+} from "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import "./chunk-MYTDK3AL.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 = 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-DUAIQJLN.js.map

package/dist/activities-DUAIQJLN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/activities.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { META_LIST_SHAPE_ARGS, registerMetaListSchema, shapeMetaListRows, writeMetaListRows } from \"./list-rows.ts\";\nimport { csvOrJson, handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n  days: { type: \"string\", description: \"Lookback days (default 7)\" },\n  limit: { type: \"string\", description: \"Max rows\" },\n  \"no-cache\": NO_CACHE_ARG,\n  ...META_LIST_SHAPE_ARGS,\n} as const;\n\nregisterMetaListSchema(\n  \"activities\",\n  \"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 → 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.\",\n  listArgs,\n);\n\nexport const activitiesCommand = defineCommand({\n  meta: {\n    name: \"activities\",\n    description: `Audit log of recent ad-account changes (created, paused, edited). Default lookback 7 days,\n~90 day retention server-side.\n\nA table by default, one row per event: event_time, event_type, actor_name, object_type,\nobject_name, object_id, and change (\"old → new\" when the change is a single value: status,\nname, budget, goal). --fields takes dotted paths (extra_data holds the raw change); --full returns\nevery field Meta sent; --output json returns the rows as JSON.\n\nExamples:\n  baker ads meta activities --account-id act_123 --days 14\n  baker ads meta activities --account-id act_123 --days 2 --output json\n  baker ads meta activities --account-id act_123 --fields event_time,object_name,extra_data`,\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args.days) params.days = args.days as string;\n      if (args.limit) params.limit = args.limit as string;\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/activities\", params);\n      const shaped = shapeMetaListRows(\"activities\", data, args);\n      writeMetaListRows(\"activities\", shaped, csvOrJson(args));\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAM9B,IAAM,WAAW;AAAA,EACf,cAAc,EAAE,MAAM,UAAU,aAAa,qBAAqB;AAAA,EAClE,MAAM,EAAE,MAAM,UAAU,aAAa,4BAA4B;AAAA,EACjE,OAAO,EAAE,MAAM,UAAU,aAAa,WAAW;AAAA,EACjD,YAAY;AAAA,EACZ,GAAG;AACL;AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,KAAM,QAAO,OAAO,KAAK;AAClC,UAAI,KAAK,MAAO,QAAO,QAAQ,KAAK;AACpC,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,YAAM,OAAO,MAAM,OAAuC,4BAA4B,MAAM;AAC5F,YAAM,SAAS,kBAAkB,cAAc,MAAM,IAAI;AACzD,wBAAkB,cAAc,QAAQ,UAAU,IAAI,CAAC;AAAA,IACzD,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/ad-group-writes-HL3EZ3BT.js

@@ -0,0 +1,170 @@
+import {
+  clearableArg,
+  compact,
+  failWriteValidation,
+  lowerArg,
+  microsFromArg,
+  productFiltersArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-E3HYHT7C.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-MIJAGBEP.js";
+import "./chunk-EIGXX6KI.js";
+import "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.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-HL3EZ3BT.js.map

package/dist/ad-group-writes-HL3EZ3BT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/ad-group-writes.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHATGPT_ADS_REFERENCE } from \"./shared.ts\";\nimport {\n  clearableArg,\n  compact,\n  failWriteValidation,\n  lowerArg,\n  microsFromArg,\n  productFiltersArg,\n  requireTarget,\n  schemaArgs,\n  stageChatgptOp,\n  statusCommand,\n} from \"./write-shared.ts\";\n\n/**\n * Staged ad group writes. The billing event follows the campaign's objective and\n * is filled in by the backend; an update's bidding is completed from the live\n * ad group, so passing only --max-bid keeps the strategy.\n */\n\nconst REFERENCE = CHATGPT_ADS_REFERENCE.adGroups;\n\nconst SHARED_ARGS = {\n  name: { type: \"string\", description: \"Ad group name (3+ characters)\" },\n  description: { type: \"string\", description: \"Internal description\" },\n  \"context-hints\": {\n    type: \"string\",\n    description:\n      \"When the ad would be useful, short phrases separated by commas — 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\",\n  },\n  \"bid-strategy\": {\n    type: \"string\",\n    description: \"fixed_bid (default, needs --max-bid) | maximize_clicks | maximize_conversions\",\n  },\n  \"max-bid\": { type: \"string\", description: \"Bid in account currency, e.g. 2.50 — fixed_bid only\" },\n  \"tracking-template\": {\n    type: \"string\",\n    description: \"Query string added to this ad group's landing pages, e.g. ad_group_id={ad_group_id} — none clears\",\n  },\n  \"audience-bids\": {\n    type: \"string\",\n    description:\n      \"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\",\n  },\n  \"product-filters\": {\n    type: \"string\",\n    description:\n      \"Catalog campaigns only: which products it shows — e.g. brand in Acme; price lte 5000 (preview with `catalogs products`). On update it replaces the set; none shows the whole catalog\",\n  },\n  status: { type: \"string\", description: \"paused (default) | active\" },\n} as const;\n\nconst CREATE_ARGS = {\n  ...SHARED_ARGS,\n  \"campaign-id\": { type: \"string\", description: \"cmpn_… or a staged chatgpt_temp_ ref\", required: true },\n  name: { type: \"string\", description: \"Ad group name (3+ characters)\", required: true },\n} as const;\n\nconst UPDATE_ARGS = {\n  id: { type: \"positional\", description: \"Ad group id (adgrp_…) or a staged chatgpt_temp_ ref\", required: true },\n  ...SHARED_ARGS,\n} as const;\n\ntype Args = Record<string, unknown>;\n\n/**\n * Hints are plain phrases, which carry commas — so `|` splits them when it is\n * there, commas otherwise. `none` clears the list, which ChatGPT Ads takes as\n * an empty one.\n */\nexport function contextHintsArg(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.trim() === \"\") {\n    return undefined;\n  }\n  if (value.trim().toLowerCase() === \"none\") {\n    return [];\n  }\n  const separator = value.includes(\"|\") ? \"|\" : \",\";\n  return value\n    .split(separator)\n    .map((hint) => hint.trim())\n    .filter(Boolean);\n}\n\n/** `caud_1=1.5,caud_2=0.8` as micros; `none` clears the adjustments. */\nexport function audienceBidsArg(value: unknown): Array<{ audienceId: string; multiplierMicros: number }> | undefined {\n  if (typeof value !== \"string\" || value.trim() === \"\") {\n    return undefined;\n  }\n  if (value.trim().toLowerCase() === \"none\") {\n    return [];\n  }\n  return value\n    .split(\",\")\n    .map((pair) => pair.trim())\n    .filter(Boolean)\n    .map((pair) => {\n      const [audienceId = \"\", multiplier = \"\"] = pair.split(\"=\").map((part) => part.trim());\n      const times = Number(multiplier.replace(\",\", \".\"));\n      if (!audienceId || !Number.isFinite(times)) {\n        failWriteValidation(`\"${pair}\" is not an audience bid — write audience=multiplier, e.g. caud_123=1.5`);\n      }\n      return { audienceId, multiplierMicros: Math.round(times * 1_000_000) };\n    });\n}\n\nfunction productSetArg(value: unknown) {\n  const filters = productFiltersArg(value);\n  return filters === undefined ? undefined : { filters };\n}\n\nfunction sharedPayload(args: Args): Record<string, unknown> {\n  return {\n    name: args.name,\n    description: args.description,\n    contextHints: contextHintsArg(args[\"context-hints\"]),\n    bidStrategy: lowerArg(args[\"bid-strategy\"]),\n    maxBidMicros: microsFromArg(args[\"max-bid\"], \"--max-bid\"),\n    trackingTemplate: clearableArg(args[\"tracking-template\"]),\n    productSet: productSetArg(args[\"product-filters\"]),\n    audienceBidMultipliers: audienceBidsArg(args[\"audience-bids\"]),\n    status: lowerArg(args.status),\n  };\n}\n\nexport function adGroupCreateOp(args: Args): Record<string, unknown> {\n  return { kind: \"adGroup.create\", payload: compact({ ...sharedPayload(args), campaignId: args[\"campaign-id\"] }) };\n}\n\nregisterSchema({\n  command: \"ads.chatgpt.ad-groups.create\",\n  description:\n    \"Stage a new ad group under a live campaign (cmpn_…) or one staged in this chat (its chatgpt_temp_ ref). Context hints decide where the ad shows; a fixed bid needs --max-bid.\",\n  args: schemaArgs(CREATE_ARGS),\n});\n\nexport const adGroupsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a new ad group (applies when the chat is published).\n\nExamples:\n  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\n  baker ads chatgpt ad-groups create --campaign-id chatgpt_temp_ab12 --name \"Auto\" --bid-strategy maximize_clicks`,\n  },\n  args: CREATE_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOp(adGroupCreateOp(args), REFERENCE, (staged) => [\n      adGroupNextHint(staged.ref, args[\"product-filters\"] !== undefined),\n    ]);\n  },\n});\n\nregisterSchema({\n  command: \"ads.chatgpt.ad-groups.update\",\n  description:\n    \"Stage a change to an ad group — name, context hints, bid or status. --context-hints replaces the whole list: read the ad group first and pass every hint to keep.\",\n  args: schemaArgs(UPDATE_ARGS),\n});\n\nexport const adGroupsUpdateCommand = defineCommand({\n  meta: {\n    name: \"update\",\n    description: `Stage a change to an ad group. --context-hints replaces the whole list.\n\nExamples:\n  baker ads chatgpt ad-groups update adgrp_123 --max-bid 3\n  baker ads chatgpt ad-groups update adgrp_123 --context-hints \"solar panels,home battery,cut my electricity bill\"`,\n  },\n  args: UPDATE_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOp(\n      { kind: \"adGroup.update\", target: requireTarget(args, \"id\"), payload: compact(sharedPayload(args)) },\n      REFERENCE,\n    );\n  },\n});\n\nexport const adGroupsPauseCommand = statusCommand(\"adGroup\", \"pause\", REFERENCE);\nexport const adGroupsResumeCommand = statusCommand(\"adGroup\", \"resume\", REFERENCE);\nexport const adGroupsArchiveCommand = statusCommand(\"adGroup\", \"archive\", REFERENCE);\n\n/** What an ad group needs next: a card, or — under a catalog campaign — its one product ad. */\nexport function adGroupNextHint(ref: string, productFilters: boolean): string {\n  const productAd = `baker ads chatgpt ads create-product --ad-group-id ${ref} --name \"…\"`;\n  return productFilters\n    ? `Next, give it its product ad: ${productAd}`\n    : `Next, give it a card: baker ads chatgpt ads create --ad-group-id ${ref} --name \"…\" --title \"…\" --body \"…\" --target-url https://… --image-url https://… — under a catalog campaign, its product ad instead: ${productAd}`;\n}\n"],"mappings":"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","names":[]}

package/dist/ad-groups-FGS5JJGN.js

@@ -0,0 +1,68 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-MIJAGBEP.js";
+import "./chunk-EIGXX6KI.js";
+import "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.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-HL3EZ3BT.js").then((m) => m.adGroupsCreateCommand),
+    update: () => import("./ad-group-writes-HL3EZ3BT.js").then((m) => m.adGroupsUpdateCommand),
+    pause: () => import("./ad-group-writes-HL3EZ3BT.js").then((m) => m.adGroupsPauseCommand),
+    resume: () => import("./ad-group-writes-HL3EZ3BT.js").then((m) => m.adGroupsResumeCommand),
+    archive: () => import("./ad-group-writes-HL3EZ3BT.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-FGS5JJGN.js.map

package/dist/ad-groups-FGS5JJGN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/ad-groups.ts"],"sourcesContent":["import type { ChatgptAdsAdGroup } from \"@baker/api/ads-chatgpt\";\nimport { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHATGPT_ADS_REFERENCE, runChatgptListRead } from \"./shared.ts\";\n\nconst args = {\n  \"campaign-id\": { type: \"string\", description: \"Only this campaign's ad groups (cmpn_…)\", required: false },\n  full: { type: \"boolean\", description: \"Return ChatGPT Ads' own ad group objects\", required: false },\n} as const;\n\nregisterSchema({\n  command: \"ads.chatgpt.ad-groups\",\n  description:\n    \"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 — ChatGPT's counterpart to keywords) and serving issues.\",\n  args,\n});\n\nconst adGroupsListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description: \"ChatGPT Ads ad groups. Example: baker ads chatgpt ad-groups --campaign-id cmpn_123\",\n  },\n  args,\n  run: async ({ args: input }) => {\n    const params: Record<string, string> = {};\n    if (input[\"campaign-id\"]) {\n      params[\"campaign-id\"] = input[\"campaign-id\"];\n    }\n    if (input.full) {\n      params.full = \"true\";\n    }\n    await runChatgptListRead<ChatgptAdsAdGroup[]>(CHATGPT_ADS_REFERENCE.adGroups, \"/api/ads/chatgpt/ad-groups\", params);\n  },\n});\n\nexport const adGroupsCommand = defineCommand({\n  meta: {\n    name: \"ad-groups\",\n    description: `ChatGPT Ads ad groups: how each one bids and the context hints that decide where it shows — or stage a change that applies when the chat is published.\n\nExamples:\n  baker ads chatgpt ad-groups --campaign-id cmpn_123\n  baker ads chatgpt ad-groups create --campaign-id cmpn_123 --name \"Rooftop owners\" --context-hints \"solar panels for my house\" --max-bid 2.50\n  baker ads chatgpt ad-groups update adgrp_123 --max-bid 3\n  baker ads chatgpt ad-groups pause adgrp_123`,\n  },\n  subCommands: {\n    list: adGroupsListCommand,\n    create: () => import(\"./ad-group-writes.ts\").then((m) => m.adGroupsCreateCommand),\n    update: () => import(\"./ad-group-writes.ts\").then((m) => m.adGroupsUpdateCommand),\n    pause: () => import(\"./ad-group-writes.ts\").then((m) => m.adGroupsPauseCommand),\n    resume: () => import(\"./ad-group-writes.ts\").then((m) => m.adGroupsResumeCommand),\n    archive: () => import(\"./ad-group-writes.ts\").then((m) => m.adGroupsArchiveCommand),\n  },\n  // A parent must never declare `run`: citty falls through to it after the matched subcommand.\n  args,\n  default: \"list\",\n});\n"],"mappings":";;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAI9B,IAAM,OAAO;AAAA,EACX,eAAe,EAAE,MAAM,UAAU,aAAa,gDAA2C,UAAU,MAAM;AAAA,EACzG,MAAM,EAAE,MAAM,WAAW,aAAa,4CAA4C,UAAU,MAAM;AACpG;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF;AACF,CAAC;AAED,IAAM,sBAAsB,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,EACA,KAAK,OAAO,EAAE,MAAM,MAAM,MAAM;AAC9B,UAAM,SAAiC,CAAC;AACxC,QAAI,MAAM,aAAa,GAAG;AACxB,aAAO,aAAa,IAAI,MAAM,aAAa;AAAA,IAC7C;AACA,QAAI,MAAM,MAAM;AACd,aAAO,OAAO;AAAA,IAChB;AACA,UAAM,mBAAwC,sBAAsB,UAAU,8BAA8B,MAAM;AAAA,EACpH;AACF,CAAC;AAEM,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,QAAQ,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,IAChF,QAAQ,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,IAChF,OAAO,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,oBAAoB;AAAA,IAC9E,QAAQ,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,IAChF,SAAS,MAAM,OAAO,+BAAsB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,EACpF;AAAA;AAAA,EAEA;AAAA,EACA,SAAS;AACX,CAAC;","names":[]}

package/dist/ad-writes-LX4ACUHB.js

@@ -0,0 +1,174 @@
+import {
+  clearableArg,
+  compact,
+  cropArg,
+  lowerArg,
+  requireTarget,
+  schemaArgs,
+  stageChatgptOp,
+  statusCommand
+} from "./chunk-E3HYHT7C.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-MIJAGBEP.js";
+import "./chunk-EIGXX6KI.js";
+import "./chunk-CUL3VB4L.js";
+import "./chunk-6YYSUISH.js";
+import "./chunk-I4FTS5EE.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.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-LX4ACUHB.js.map