@koda-sl/baker-cli 0.525.0 → 0.527.0

package/dist/chunk-FX3MXXYD.js

@@ -0,0 +1,91 @@
+import {
+  definitionPlatformOf,
+  parseDefinitionDelivery,
+  resolveDelivery,
+  resolveFormatList
+} from "./chunk-3N2KAOVM.js";
+import {
+  AD_PLACEMENTS
+} from "./chunk-MCJ5I5LR.js";
+import {
+  CAPABILITY_SURFACES
+} from "./chunk-NSBNIPIW.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+
+// src/commands/canvas/scaffold-delivery.ts
+var flagText = (value) => typeof value === "string" || typeof value === "number" ? String(value).trim() || void 0 : void 0;
+function deliveryInputOf(flags, definition, idea) {
+  const platformsFlag = flagText(flags.platforms);
+  const legacyPlatform = flagText(flags.platform);
+  const legacyPlacements = flagText(flags.placements);
+  const aspect = flagText(flags.aspect);
+  const formatsFlag = flagText(flags.formats);
+  const targetAdSet = flagText(flags["target-adset"]);
+  return {
+    ...platformsFlag ? { platformsFlag } : {},
+    ...legacyPlatform ? { legacyPlatform } : {},
+    ...legacyPlacements ? { legacyPlacements } : {},
+    ...aspect ? { aspect } : {},
+    ...formatsFlag ? { formatsFlag } : {},
+    ...idea && idea.length > 0 ? { idea } : {},
+    definition,
+    ...targetAdSet ? { targetAdSet } : {}
+  };
+}
+function namesDelivery(flags) {
+  return [flags.platforms, flags.platform, flags.placements, flags.formats].some((f) => flagText(f) !== void 0);
+}
+var SURFACE_PLATFORMS = {
+  "meta-ads": "meta",
+  "linkedin-ads": "linkedin",
+  "google-ads": "google_demandgen",
+  "x-ads": "x",
+  "chatgpt-ads": "chatgpt"
+};
+async function connectedAdPlatforms() {
+  try {
+    const response = await apiPost("/api/capabilities", {}, { timeoutMs: 15e3 });
+    return response.data.surfaces.filter((s) => s.connected && CAPABILITY_SURFACES.includes(s.surface)).flatMap((s) => SURFACE_PLATFORMS[s.surface] ? [SURFACE_PLATFORMS[s.surface]] : []);
+  } catch {
+    return [];
+  }
+}
+async function scaffoldDelivery(flags, definitionText, idea) {
+  const definition = definitionText === null ? null : parseDefinitionDelivery(definitionText);
+  const input = deliveryInputOf(flags, definition, idea);
+  const resolved = resolveDelivery(input);
+  if (resolved.ok || resolved.error.code !== "platform_required") return resolved;
+  return resolveDelivery({ ...input, connected: await connectedAdPlatforms() });
+}
+function deliveryDefinitionFields(delivery) {
+  const platforms = delivery.platforms.map((p) => p.trim());
+  return {
+    // The collection names whole platforms; a placement named alone records its platform.
+    platforms: [...new Set(platforms.map(platformOfName))],
+    platform: definitionPlatformOf(platforms[0] ?? ""),
+    formats: resolveFormatList(delivery.formats)
+  };
+}
+function platformOfName(name) {
+  return AD_PLACEMENTS.find((p) => p.id === name)?.platform ?? name;
+}
+function deliveryNote(delivery, renderRatio) {
+  const from = {
+    flag: "as asked",
+    idea: "from the idea",
+    definition: "from _definition.md",
+    legacy_definition: "from _definition.md's platform",
+    adset: "from its Meta ad set"
+  };
+  return `Made for ${delivery.platforms.join(", ")} (${from[delivery.source]}): delivers ${delivery.formats.join(", ")}, the ${delivery.lead} designed first (rendered at ${renderRatio}) and every other size re-laid out from it.`;
+}
+
+export {
+  namesDelivery,
+  scaffoldDelivery,
+  deliveryDefinitionFields,
+  deliveryNote
+};
+//# sourceMappingURL=chunk-FX3MXXYD.js.map

package/dist/chunk-GEFZVG4P.js

@@ -0,0 +1,219 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  numberFlag,
+  requireTarget,
+  stageOp,
+  stageOps
+} from "./chunk-4XXA4WCS.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+
+// src/commands/ads/meta/asset-writes.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+var accountArg = { type: "string", description: "Meta ad account ID (act_123)" };
+var schemaId = (what) => ({ type: "positional", description: what, required: true });
+function command(input) {
+  registerSchema({
+    command: input.schema,
+    description: input.schemaDescription,
+    args: Object.fromEntries(
+      Object.entries(input.args).map(([key, arg]) => [
+        key,
+        { type: arg.type, description: arg.description, required: arg.required === true }
+      ])
+    )
+  });
+  return defineCommand({
+    meta: { name: input.name, description: `${input.description} ${STAGED_NOTE}` },
+    args: input.args,
+    run: async ({ args, rawArgs }) => {
+      await input.run(args, rawArgs);
+    }
+  });
+}
+var creativesDeleteCommand = command({
+  schema: "ads.meta.creatives.delete",
+  name: "delete",
+  description: "Stage deleting an ad creative. Meta deletes only a creative no ad runs \u2014 repoint or delete the ad first. Permanent.",
+  schemaDescription: "Stage deleting a Meta ad creative (status DELETED) \u2014 applied at publish, permanent. Meta refuses a creative an ad still runs.",
+  args: { id: { type: "positional", description: "Creative id", required: true }, "account-id": accountArg },
+  run: async (args) => {
+    await stageOp({
+      kind: "adCreative.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "creative"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var mediaDeleteCommand = command({
+  schema: "ads.meta.media.delete",
+  name: "delete",
+  description: "Stage taking an image out of the ad account's image library, by its hash (`baker ads meta images`), or one of its videos by id (`--video-id`, from `baker ads meta media`). Meta refuses an image a creative still uses.",
+  schemaDescription: "Stage deleting an image from a Meta ad account's image library by hash, or a video from its video library by id \u2014 applied at publish. Meta refuses an image a creative uses.",
+  args: {
+    "account-id": accountArg,
+    "image-hash": { type: "string", description: "The image's hash" },
+    "video-id": { type: "string", description: "Or a video of the ad account, by id" }
+  },
+  run: async (args) => {
+    const imageHash = typeof args["image-hash"] === "string" ? args["image-hash"] : void 0;
+    const videoId = typeof args["video-id"] === "string" ? args["video-id"] : void 0;
+    if (imageHash === void 0 === (videoId === void 0)) {
+      failWriteValidation("pass --image-hash (from `baker ads meta images`) or --video-id \u2014 one of them");
+    }
+    await stageOp({ kind: "media.delete", accountId: await bareAccountId(args), payload: { imageHash, videoId } });
+  }
+});
+var customConversionsUpdateCommand = command({
+  schema: "ads.meta.custom-conversions.update",
+  name: "update",
+  description: "Stage renaming a Custom Conversion, its description or its value per conversion. Meta keeps a conversion's rule and event category for good \u2014 a conversion that counts something else is a new one.",
+  schemaDescription: "Stage a change to a Meta Custom Conversion: --name, --description, --value (value per conversion, account currency). The rule and event category cannot change (Meta accepts and ignores them).",
+  args: {
+    id: { type: "positional", description: "Custom conversion id", required: true },
+    "account-id": accountArg,
+    name: { type: "string", description: "New name" },
+    description: { type: "string", description: "New description" },
+    value: { type: "string", description: "Value of one conversion, in the account currency" }
+  },
+  run: async (args) => {
+    const payload = Object.fromEntries(
+      Object.entries({
+        name: args.name,
+        description: args.description,
+        default_conversion_value: numberFlag(args.value, "--value")
+      }).filter(([, value]) => value !== void 0)
+    );
+    await stageOp({
+      kind: "customConversion.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "custom conversion"),
+      payload
+    });
+  }
+});
+var customConversionsDeleteCommand = command({
+  schema: "ads.meta.custom-conversions.delete",
+  name: "delete",
+  description: "Stage deleting a Custom Conversion. Meta archives it: it stops counting and leaves the active list, and still uses one of the account's slots. Ad sets optimizing toward it stop finding conversions.",
+  schemaDescription: "Stage deleting (archiving) a Meta Custom Conversion \u2014 applied at publish. Not reversible; it keeps its slot in the account's cap.",
+  args: { id: schemaId("Custom conversion id"), "account-id": accountArg },
+  run: async (args) => {
+    await stageOp({
+      kind: "customConversion.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "custom conversion"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var labelsCreateCommand = command({
+  schema: "ads.meta.labels.create",
+  name: "create",
+  description: 'Stage a new ad label. File things under it with `labels attach <ref> --campaigns \u2026` in the same chat. Example: baker ads meta labels create --name "Q4 launch"',
+  schemaDescription: "Stage a new Meta ad label (created at publish). Returns a meta_temp_* ref `labels attach` takes.",
+  args: { "account-id": accountArg, name: { type: "string", description: "Label name" } },
+  run: async (args) => {
+    await stageOp({ kind: "adLabel.create", accountId: await bareAccountId(args), payload: { name: args.name } });
+  }
+});
+var labelsRenameCommand = command({
+  schema: "ads.meta.labels.rename",
+  name: "rename",
+  description: "Stage renaming an ad label.",
+  schemaDescription: "Stage renaming a Meta ad label.",
+  args: { id: schemaId("Label id"), "account-id": accountArg, name: { type: "string", description: "New name" } },
+  run: async (args) => {
+    await stageOp({
+      kind: "adLabel.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "label"),
+      payload: { name: args.name }
+    });
+  }
+});
+var labelsDeleteCommand = command({
+  schema: "ads.meta.labels.delete",
+  name: "delete",
+  description: "Stage deleting an ad label. Everything filed under it keeps running, unlabelled.",
+  schemaDescription: "Stage deleting a Meta ad label \u2014 applied at publish; labelled objects keep running.",
+  args: { id: schemaId("Label id"), "account-id": accountArg },
+  run: async (args) => {
+    await stageOp({
+      kind: "adLabel.update",
+      accountId: await bareAccountId(args),
+      target: requireTarget(args, "label"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var LABELLED = [
+  ["campaigns", "campaign.update"],
+  ["adsets", "adSet.update"],
+  ["ads", "ad.update"],
+  ["creatives", "adCreative.update"]
+];
+var targetArgs = {
+  campaigns: { type: "string", description: "Campaign ids (comma-separated or repeated)" },
+  adsets: { type: "string", description: "Ad set ids" },
+  ads: { type: "string", description: "Ad ids" },
+  creatives: {
+    type: "string",
+    description: "Creative ids (live ones \u2014 a creative created in this chat is labelled later)"
+  }
+};
+function idsOf(rawArgs, flag, parsed) {
+  return repeatedValues(rawArgs, flag, parsed).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean);
+}
+async function stageLabelChange(verb, args, rawArgs) {
+  const accountId = await bareAccountId(args);
+  const label = requireTarget(args, "label");
+  const targets = LABELLED.flatMap(([flag, kind]) => idsOf(rawArgs, flag, args[flag]).map((id) => ({ kind, id })));
+  if (targets.length === 0) {
+    failWriteValidation("name what to label: --campaigns, --adsets, --ads or --creatives");
+  }
+  await stageOps(
+    targets.map((target) => ({ kind: target.kind, accountId, target: target.id, payload: { [verb]: [label] } }))
+  );
+}
+var labelsAttachCommand = command({
+  schema: "ads.meta.labels.attach",
+  name: "attach",
+  description: "Stage filing campaigns, ad sets, ads or creatives under a label (a label id, or a meta_temp_* ref from `labels create`). Their other labels stay. Example: baker ads meta labels attach 120249 --campaigns 6123,6124",
+  schemaDescription: "Stage adding a Meta ad label to campaigns/ad sets/ads/creatives (--campaigns, --adsets, --ads, --creatives; comma-separated). One staged change per object; other labels kept.",
+  args: { id: schemaId("Label id or meta_temp_* ref"), "account-id": accountArg, ...targetArgs },
+  run: async (args, rawArgs) => {
+    await stageLabelChange("addLabels", args, rawArgs);
+  }
+});
+var labelsDetachCommand = command({
+  schema: "ads.meta.labels.detach",
+  name: "detach",
+  description: "Stage taking a label off campaigns, ad sets, ads or creatives. Their other labels stay.",
+  schemaDescription: "Stage removing a Meta ad label from campaigns/ad sets/ads/creatives (--campaigns, --adsets, --ads, --creatives). Other labels kept.",
+  args: { id: schemaId("Label id"), "account-id": accountArg, ...targetArgs },
+  run: async (args, rawArgs) => {
+    await stageLabelChange("removeLabels", args, rawArgs);
+  }
+});
+
+export {
+  command,
+  creativesDeleteCommand,
+  mediaDeleteCommand,
+  customConversionsUpdateCommand,
+  customConversionsDeleteCommand,
+  labelsCreateCommand,
+  labelsRenameCommand,
+  labelsDeleteCommand,
+  labelsAttachCommand,
+  labelsDetachCommand
+};
+//# sourceMappingURL=chunk-GEFZVG4P.js.map

package/dist/chunk-GEFZVG4P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/asset-writes.ts"],"sourcesContent":["import { type ArgsDef, type CommandDef, defineCommand } from \"citty\";\nimport { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { bareAccountId, failWriteValidation, numberFlag, requireTarget, stageOp, stageOps } from \"./write-shared.ts\";\n\n/**\n * Staged writes on the account's own assets: deleting a creative or an image,\n * changing or deleting a Custom Conversion, and ad labels — creating, renaming,\n * deleting them, and filing campaigns, ad sets, ads and creatives under them.\n * Nothing reaches Meta until the chat publishes.\n */\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\nconst accountArg = { type: \"string\", description: \"Meta ad account ID (act_123)\" } as const;\nconst schemaId = (what: string) => ({ type: \"positional\", description: what, required: true });\n\nexport function command(input: {\n  schema: string;\n  name: string;\n  description: string;\n  schemaDescription: string;\n  args: Record<string, { type: string; description: string; required?: boolean }>;\n  run: (args: Record<string, unknown>, rawArgs: readonly string[] | undefined) => Promise<void>;\n}): CommandDef<ArgsDef> {\n  registerSchema({\n    command: input.schema,\n    description: input.schemaDescription,\n    args: Object.fromEntries(\n      Object.entries(input.args).map(([key, arg]) => [\n        key,\n        { type: arg.type, description: arg.description, required: arg.required === true },\n      ]),\n    ),\n  });\n  return defineCommand<ArgsDef>({\n    meta: { name: input.name, description: `${input.description} ${STAGED_NOTE}` },\n    args: input.args as ArgsDef,\n    run: async ({ args, rawArgs }) => {\n      await input.run(args as Record<string, unknown>, rawArgs);\n    },\n  });\n}\n\n// --- Creatives ---\n\nexport const creativesDeleteCommand = command({\n  schema: \"ads.meta.creatives.delete\",\n  name: \"delete\",\n  description:\n    \"Stage deleting an ad creative. Meta deletes only a creative no ad runs — repoint or delete the ad first. Permanent.\",\n  schemaDescription:\n    \"Stage deleting a Meta ad creative (status DELETED) — applied at publish, permanent. Meta refuses a creative an ad still runs.\",\n  args: { id: { type: \"positional\", description: \"Creative id\", required: true }, \"account-id\": accountArg },\n  run: async (args) => {\n    await stageOp({\n      kind: \"adCreative.update\",\n      accountId: await bareAccountId(args),\n      target: requireTarget(args, \"creative\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\n// --- Images ---\n\nexport const mediaDeleteCommand = command({\n  schema: \"ads.meta.media.delete\",\n  name: \"delete\",\n  description:\n    \"Stage taking an image out of the ad account's image library, by its hash (`baker ads meta images`), or one of its videos by id (`--video-id`, from `baker ads meta media`). Meta refuses an image a creative still uses.\",\n  schemaDescription:\n    \"Stage deleting an image from a Meta ad account's image library by hash, or a video from its video library by id — applied at publish. Meta refuses an image a creative uses.\",\n  args: {\n    \"account-id\": accountArg,\n    \"image-hash\": { type: \"string\", description: \"The image's hash\" },\n    \"video-id\": { type: \"string\", description: \"Or a video of the ad account, by id\" },\n  },\n  run: async (args) => {\n    const imageHash = typeof args[\"image-hash\"] === \"string\" ? args[\"image-hash\"] : undefined;\n    const videoId = typeof args[\"video-id\"] === \"string\" ? args[\"video-id\"] : undefined;\n    if ((imageHash === undefined) === (videoId === undefined)) {\n      failWriteValidation(\"pass --image-hash (from `baker ads meta images`) or --video-id — one of them\");\n    }\n    await stageOp({ kind: \"media.delete\", accountId: await bareAccountId(args), payload: { imageHash, videoId } });\n  },\n});\n\n// --- Custom conversions ---\n\nexport const customConversionsUpdateCommand = command({\n  schema: \"ads.meta.custom-conversions.update\",\n  name: \"update\",\n  description:\n    \"Stage renaming a Custom Conversion, its description or its value per conversion. Meta keeps a conversion's rule and event category for good — a conversion that counts something else is a new one.\",\n  schemaDescription:\n    \"Stage a change to a Meta Custom Conversion: --name, --description, --value (value per conversion, account currency). The rule and event category cannot change (Meta accepts and ignores them).\",\n  args: {\n    id: { type: \"positional\", description: \"Custom conversion id\", required: true },\n    \"account-id\": accountArg,\n    name: { type: \"string\", description: \"New name\" },\n    description: { type: \"string\", description: \"New description\" },\n    value: { type: \"string\", description: \"Value of one conversion, in the account currency\" },\n  },\n  run: async (args) => {\n    const payload = Object.fromEntries(\n      Object.entries({\n        name: args.name,\n        description: args.description,\n        default_conversion_value: numberFlag(args.value, \"--value\"),\n      }).filter(([, value]) => value !== undefined),\n    );\n    await stageOp({\n      kind: \"customConversion.update\",\n      accountId: await bareAccountId(args),\n      target: requireTarget(args, \"custom conversion\"),\n      payload,\n    });\n  },\n});\n\nexport const customConversionsDeleteCommand = command({\n  schema: \"ads.meta.custom-conversions.delete\",\n  name: \"delete\",\n  description:\n    \"Stage deleting a Custom Conversion. Meta archives it: it stops counting and leaves the active list, and still uses one of the account's slots. Ad sets optimizing toward it stop finding conversions.\",\n  schemaDescription:\n    \"Stage deleting (archiving) a Meta Custom Conversion — applied at publish. Not reversible; it keeps its slot in the account's cap.\",\n  args: { id: schemaId(\"Custom conversion id\"), \"account-id\": accountArg },\n  run: async (args) => {\n    await stageOp({\n      kind: \"customConversion.update\",\n      accountId: await bareAccountId(args),\n      target: requireTarget(args, \"custom conversion\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\n// --- Labels ---\n\nexport const labelsCreateCommand = command({\n  schema: \"ads.meta.labels.create\",\n  name: \"create\",\n  description:\n    'Stage a new ad label. File things under it with `labels attach <ref> --campaigns …` in the same chat. Example: baker ads meta labels create --name \"Q4 launch\"',\n  schemaDescription: \"Stage a new Meta ad label (created at publish). Returns a meta_temp_* ref `labels attach` takes.\",\n  args: { \"account-id\": accountArg, name: { type: \"string\", description: \"Label name\" } },\n  run: async (args) => {\n    await stageOp({ kind: \"adLabel.create\", accountId: await bareAccountId(args), payload: { name: args.name } });\n  },\n});\n\nexport const labelsRenameCommand = command({\n  schema: \"ads.meta.labels.rename\",\n  name: \"rename\",\n  description: \"Stage renaming an ad label.\",\n  schemaDescription: \"Stage renaming a Meta ad label.\",\n  args: { id: schemaId(\"Label id\"), \"account-id\": accountArg, name: { type: \"string\", description: \"New name\" } },\n  run: async (args) => {\n    await stageOp({\n      kind: \"adLabel.update\",\n      accountId: await bareAccountId(args),\n      target: requireTarget(args, \"label\"),\n      payload: { name: args.name },\n    });\n  },\n});\n\nexport const labelsDeleteCommand = command({\n  schema: \"ads.meta.labels.delete\",\n  name: \"delete\",\n  description: \"Stage deleting an ad label. Everything filed under it keeps running, unlabelled.\",\n  schemaDescription: \"Stage deleting a Meta ad label — applied at publish; labelled objects keep running.\",\n  args: { id: schemaId(\"Label id\"), \"account-id\": accountArg },\n  run: async (args) => {\n    await stageOp({\n      kind: \"adLabel.update\",\n      accountId: await bareAccountId(args),\n      target: requireTarget(args, \"label\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\nconst LABELLED = [\n  [\"campaigns\", \"campaign.update\"],\n  [\"adsets\", \"adSet.update\"],\n  [\"ads\", \"ad.update\"],\n  [\"creatives\", \"adCreative.update\"],\n] as const;\n\nconst targetArgs = {\n  campaigns: { type: \"string\", description: \"Campaign ids (comma-separated or repeated)\" },\n  adsets: { type: \"string\", description: \"Ad set ids\" },\n  ads: { type: \"string\", description: \"Ad ids\" },\n  creatives: {\n    type: \"string\",\n    description: \"Creative ids (live ones — a creative created in this chat is labelled later)\",\n  },\n} as const;\n\nfunction idsOf(rawArgs: readonly string[] | undefined, flag: string, parsed: unknown): string[] {\n  return repeatedValues(rawArgs, flag, parsed)\n    .flatMap((value) => value.split(\",\"))\n    .map((value) => value.trim())\n    .filter(Boolean);\n}\n\n/**\n * One staged update per object. Each names only the label to add or take\n * away; staging reads the labels the object has now and stages the whole set,\n * because Meta replaces an object's labels with the set it is sent.\n */\nasync function stageLabelChange(\n  verb: \"addLabels\" | \"removeLabels\",\n  args: Record<string, unknown>,\n  rawArgs: readonly string[] | undefined,\n): Promise<void> {\n  const accountId = await bareAccountId(args);\n  const label = requireTarget(args, \"label\");\n  const targets = LABELLED.flatMap(([flag, kind]) => idsOf(rawArgs, flag, args[flag]).map((id) => ({ kind, id })));\n  if (targets.length === 0) {\n    failWriteValidation(\"name what to label: --campaigns, --adsets, --ads or --creatives\");\n  }\n  await stageOps(\n    targets.map((target) => ({ kind: target.kind, accountId, target: target.id, payload: { [verb]: [label] } })),\n  );\n}\n\nexport const labelsAttachCommand = command({\n  schema: \"ads.meta.labels.attach\",\n  name: \"attach\",\n  description:\n    \"Stage filing campaigns, ad sets, ads or creatives under a label (a label id, or a meta_temp_* ref from `labels create`). Their other labels stay. Example: baker ads meta labels attach 120249 --campaigns 6123,6124\",\n  schemaDescription:\n    \"Stage adding a Meta ad label to campaigns/ad sets/ads/creatives (--campaigns, --adsets, --ads, --creatives; comma-separated). One staged change per object; other labels kept.\",\n  args: { id: schemaId(\"Label id or meta_temp_* ref\"), \"account-id\": accountArg, ...targetArgs },\n  run: async (args, rawArgs) => {\n    await stageLabelChange(\"addLabels\", args, rawArgs);\n  },\n});\n\nexport const labelsDetachCommand = command({\n  schema: \"ads.meta.labels.detach\",\n  name: \"detach\",\n  description: \"Stage taking a label off campaigns, ad sets, ads or creatives. Their other labels stay.\",\n  schemaDescription:\n    \"Stage removing a Meta ad label from campaigns/ad sets/ads/creatives (--campaigns, --adsets, --ads, --creatives). Other labels kept.\",\n  args: { id: schemaId(\"Label id\"), \"account-id\": accountArg, ...targetArgs },\n  run: async (args, rawArgs) => {\n    await stageLabelChange(\"removeLabels\", args, rawArgs);\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-GLCHD54W.js

@@ -0,0 +1,74 @@
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  needsConnectionFix,
+  writeJsonEnvelope
+} from "./chunk-HPDGVK6R.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-B4UVJCJ4.js";
+import {
+  getEnv
+} from "./chunk-52IYZCRS.js";
+
+// src/commands/gsc/resolve.ts
+async function fetchSites(useCache = true) {
+  if (useCache) {
+    const cached = cacheGet("gsc-sites", "list");
+    if (cached) return cached.data;
+  }
+  const params = !useCache ? { "skip-cache": "true" } : void 0;
+  const data = await apiGet("/api/gsc/sites", params);
+  if (useCache) {
+    cacheSet("gsc-sites", "list", data, 60 * 60 * 1e3);
+  }
+  return data;
+}
+async function resolveSiteUrl(args) {
+  const fromArgs = args["site-url"];
+  const fromEnv = getEnv().BAKER_GSC_SITE_URL;
+  const siteUrl = fromArgs || fromEnv;
+  if (siteUrl) return siteUrl;
+  const useCache = !args["no-cache"];
+  try {
+    const sites = await fetchSites(useCache);
+    const [single] = sites;
+    if (sites.length === 1 && single) {
+      process.stderr.write(`Using site "${single.siteUrl}"
+`);
+      return single.siteUrl;
+    }
+    if (sites.length === 0) {
+      handleConnectionError("gsc");
+    }
+    const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join("\n");
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "MULTIPLE_SITES",
+        message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:
+${list}`
+      }
+    });
+    process.exit(1);
+  } catch (err) {
+    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("gsc", err.message);
+    }
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "RESOLUTION_ERROR",
+        message: "Could not auto-detect site. Pass --site-url or set BAKER_GSC_SITE_URL."
+      }
+    });
+    process.exit(1);
+  }
+}
+
+export {
+  resolveSiteUrl
+};
+//# sourceMappingURL=chunk-GLCHD54W.js.map

package/dist/chunk-GT77XMOG.js

@@ -0,0 +1,23 @@
+import {
+  creativesRunResponseSchema
+} from "./chunk-HVJJEQDQ.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+
+// src/commands/canvas/run-history.ts
+async function fetchRunRecord(runId, post = apiPost) {
+  try {
+    const response = await post("/api/creatives/run", { runId });
+    return creativesRunResponseSchema.parse(response).data;
+  } catch (e) {
+    if (e instanceof ApiError && e.code === "NOT_FOUND") return null;
+    throw e;
+  }
+}
+
+export {
+  fetchRunRecord
+};
+//# sourceMappingURL=chunk-GT77XMOG.js.map

package/dist/chunk-GXPZJ2QN.js

@@ -0,0 +1,225 @@
+import {
+  BRAND_DIR,
+  inkLuma,
+  logoArtwork
+} from "./chunk-T6PTG6VM.js";
+import {
+  fetchExternalBytes
+} from "./chunk-SWNCS2OD.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+
+// src/commands/canvas/clientLogo.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import * as cheerio from "cheerio";
+import path from "path";
+function decideClientLogo(domain, lookup) {
+  if (!domain) return { use: false, reason: "no_domain" };
+  const verdict = lookup?.brandMatch?.verdict;
+  if (verdict === "mismatch") {
+    return { use: false, reason: "mismatch", ...lookup?.brandMatch?.name ? { wrongBrand: lookup.brandMatch.name } : {} };
+  }
+  if (verdict !== "confirmed") return { use: false, reason: "unverified" };
+  const url = lookup?.hits?.map((hit) => hit.imageUrl ?? hit.sourceUrl).find((candidate) => Boolean(candidate));
+  return url ? { use: true, url } : { use: false, reason: "no_hits" };
+}
+function clientLogoMissNote(decision, domain) {
+  switch (decision.reason) {
+    case "no_domain":
+      return "Baker has no website on record for this company, so their mark could not be looked up.";
+    case "mismatch":
+      return `The mark found for \`${domain}\` belongs to ${decision.wrongBrand ?? "a different company"}, not to this client, so it was not used.`;
+    default:
+      return `No brand mark could be confirmed for \`${domain}\`, so nothing was placed.`;
+  }
+}
+function hostOf(site) {
+  try {
+    return new URL(/^https?:\/\//i.test(site) ? site : `https://${site}`).hostname.replace(/^www\./i, "").toLowerCase();
+  } catch {
+    return null;
+  }
+}
+var NOT_THE_LOGO = /favicon|apple-touch|sprite|(?:^|[/_.-])icons?(?:[/_.-]|$)|client|customer|partner|testimonial|trust|badge|award/i;
+function sayings(hit, url) {
+  const meta = hit.providerMeta ?? {};
+  const given = ["alt", "class", "id", "title"].map((key) => typeof meta[key] === "string" ? meta[key] : "");
+  return [new URL(url).pathname, hit.name ?? "", hit.description ?? "", ...given].join(" ");
+}
+function logoFromExtract(hits, domain) {
+  const own = hostOf(domain);
+  if (!own) return null;
+  const candidates = hits.flatMap((hit) => {
+    const url = hit.url ?? hit.imageUrl ?? hit.sourceUrl;
+    const host = url ? hostOf(url) : null;
+    if (!url || !host || host !== own && !host.endsWith(`.${own}`)) return [];
+    const said = sayings(hit, url);
+    if (!/logo/i.test(said) || NOT_THE_LOGO.test(said)) return [];
+    return [{ url, score: (/\.svg(?:\?|$)/i.test(url) ? 2 : 0) + (/logo/i.test(new URL(url).pathname) ? 1 : 0) }];
+  });
+  candidates.sort((a, b) => b.score - a.score || a.url.length - b.url.length);
+  return candidates[0]?.url ?? null;
+}
+var MAX_INLINE_SVG = 3e5;
+var BRAND_PLACES = "header, nav, [role=banner]";
+var IMAGE_ADDRESS = ["src", "data-src", "data-lazy-src", "data-original"];
+function logoFromPage(html, pageUrl, domain) {
+  const own = hostOf(domain);
+  if (!own) return null;
+  const $ = cheerio.load(html);
+  for (const el of $(`${BRAND_PLACES}`).find("img, svg").toArray()) {
+    const node = $(el);
+    const said = [node, node.closest("a")].flatMap((n) => ["class", "id", "alt", "aria-label", "title"].map((k) => n.attr(k) ?? "")).join(" ");
+    if (!/logo/i.test(said) || NOT_THE_LOGO.test(said)) continue;
+    if (el.tagName === "svg") {
+      const svg = standaloneSvg($, node);
+      if (svg) return { kind: "svg", svg };
+      continue;
+    }
+    const url = IMAGE_ADDRESS.map((k) => node.attr(k)?.trim() ?? "").filter((a) => a !== "" && !a.startsWith("data:")).map((a) => absolute(a, pageUrl)).find((a) => a !== null);
+    const host = url ? hostOf(url) : null;
+    if (url && host && (host === own || host.endsWith(`.${own}`))) return { kind: "url", url };
+  }
+  return null;
+}
+function absolute(address, base) {
+  try {
+    const url = new URL(address, base);
+    return /^https?:$/.test(url.protocol) ? url.href : null;
+  } catch {
+    return null;
+  }
+}
+function standaloneSvg($, node) {
+  const draws = node.find("path, circle, rect, polygon, polyline, ellipse, line, text").length > 0;
+  if (!draws || node.find("use").length > 0) return null;
+  const copy = node.clone();
+  if (!copy.attr("xmlns")) copy.attr("xmlns", "http://www.w3.org/2000/svg");
+  const svg = $.html(copy);
+  return svg.length <= MAX_INLINE_SVG ? svg : null;
+}
+function logoTone(inkLuma2) {
+  return inkLuma2 !== null && inkLuma2 > 170 ? "dark" : "light";
+}
+function withLogoRegistered(tokensJson, logo) {
+  if (tokensJson === null) return null;
+  let tokens;
+  try {
+    tokens = JSON.parse(tokensJson);
+  } catch {
+    return null;
+  }
+  if (!tokens || typeof tokens !== "object" || Array.isArray(tokens)) return null;
+  const doc = tokens;
+  const logos = Array.isArray(doc.logos) ? doc.logos : [];
+  if (logos.some((l) => l?.path === logo.path)) return null;
+  const next = { ...doc, logos: [...logos, { variant: "logo", background: logo.background, path: logo.path }] };
+  return `${JSON.stringify(next, null, 2)}
+`;
+}
+function logoMissingHint(company, domain) {
+  return `No logo on file for ${company}: add it on the Brand page${domain ? ` (we could not find it on ${domain})` : ""}.`;
+}
+function extensionOf(url) {
+  return /\.(svg|png|jpg|jpeg|webp)(?:\?|$)/i.exec(url)?.[1]?.toLowerCase() ?? "svg";
+}
+var MAX_LOGO_BYTES = 3e6;
+async function downloaded(url) {
+  try {
+    const { buffer } = await fetchExternalBytes(url, { maxBytes: MAX_LOGO_BYTES });
+    return buffer.byteLength > 0 ? { bytes: buffer, extension: extensionOf(url) } : null;
+  } catch {
+    return null;
+  }
+}
+async function logoOnSite(domain) {
+  const host = hostOf(domain);
+  if (!host) return null;
+  const page = `https://${host}/`;
+  try {
+    const { buffer } = await fetchExternalBytes(page, { maxBytes: MAX_LOGO_BYTES });
+    const found = logoFromPage(buffer.toString("utf8"), page, domain);
+    if (found?.kind === "svg") return { bytes: Buffer.from(found.svg, "utf8"), extension: "svg" };
+    const file = found ? await downloaded(found.url) : null;
+    if (file) return file;
+  } catch {
+  }
+  try {
+    const listed = await apiPost("/api/images/extract", { url: page, limit: 50 });
+    const url = logoFromExtract(listed.hits ?? [], domain);
+    return url ? await downloaded(url) : null;
+  } catch {
+    return null;
+  }
+}
+async function logoSource(domain) {
+  let lookup = null;
+  if (domain) {
+    try {
+      lookup = await apiPost("/api/images/logo", { domain, variant: "logo", autoIngest: 1 });
+    } catch {
+      lookup = null;
+    }
+  }
+  const decision = decideClientLogo(domain, lookup);
+  if (decision.use) {
+    const file = await downloaded(decision.url);
+    if (file) return file;
+  }
+  if (domain && !(decision.use === false && decision.reason === "mismatch")) {
+    const file = await logoOnSite(domain);
+    if (file) return file;
+  }
+  return { note: clientLogoMissNote(decision.use ? { use: false, reason: "no_hits" } : decision, domain) };
+}
+async function inkOf(bytes) {
+  try {
+    return inkLuma((await logoArtwork(bytes)).data);
+  } catch {
+    return null;
+  }
+}
+async function fetchClientLogo(root = ".") {
+  let domain;
+  let company;
+  try {
+    const found = await apiGet("/api/company");
+    domain = found.data.domain?.trim() || void 0;
+    company = found.data.name;
+  } catch {
+    domain = void 0;
+  }
+  const named = { ...domain ? { domain } : {}, ...company ? { company } : {} };
+  const source = await logoSource(domain);
+  if ("note" in source) return { ok: false, reason: source.note, ...named };
+  try {
+    const tone = logoTone(await inkOf(source.bytes));
+    const dir = path.join(root, BRAND_DIR, "logos");
+    await mkdir(dir, { recursive: true });
+    const file = path.join(dir, `logo-${tone}.${source.extension}`);
+    await writeFile(file, source.bytes);
+    await registerLogo(root, path.join(BRAND_DIR, "logos", path.basename(file)), tone);
+    return { ok: true, path: file, ...named };
+  } catch {
+    return { ok: false, reason: clientLogoMissNote({ use: false, reason: "no_hits" }, domain), ...named };
+  }
+}
+async function registerLogo(root, relative, background) {
+  const tokensPath = path.join(root, BRAND_DIR, "tokens.json");
+  const next = withLogoRegistered(await readFile(tokensPath, "utf8").catch(() => null), { path: relative, background });
+  if (next !== null) await writeFile(tokensPath, next, "utf8").catch(() => void 0);
+}
+async function withClientLogo(root, kit, reread, fetch = fetchClientLogo) {
+  if (kit.logo) return { kit };
+  const fetched = await fetch(root).catch(() => null);
+  if (fetched?.ok) return { kit: await reread() };
+  return { kit, hint: logoMissingHint(fetched?.company ?? "your company", fetched?.domain) };
+}
+
+export {
+  fetchClientLogo,
+  withClientLogo
+};
+//# sourceMappingURL=chunk-GXPZJ2QN.js.map