@koda-sl/baker-cli 0.513.0 → 0.514.0

package/dist/audiences-CDDI5HR5.js

@@ -0,0 +1,86 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-B2POVFR2.js";
+import "./chunk-Y2JZX6JB.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/audiences.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  limit: { type: "string", description: "Max rows" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "Output format", default: "json" }
+};
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List custom audiences. Runs by default when no subcommand is given. Example: baker ads meta audiences --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/audiences", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var audiencesCommand = defineCommand({
+  meta: {
+    name: "audiences",
+    description: `List custom audiences, or stage writes (create/update/delete, members add|remove|replace). Write subcommands stage ops on this chat's draft.
+Includes lookalikes, website-pixel audiences, customer-file audiences. Meta hides exact size when count < 1000.
+
+Examples:
+  baker ads meta audiences --account-id act_123
+  baker ads meta audiences create --name "Site 30d" --subtype WEBSITE --file rule.json
+  baker ads meta audiences create --name "Past buyers" --subtype CUSTOM --file buyers.json   # {"members":[{"email":"\u2026"}]}
+  baker ads meta audiences create --name "Customers" --subtype CUSTOM --customer-file-source USER_PROVIDED_ONLY
+  baker ads meta audiences members add meta_temp_ab12 --file customers.csv --country ES
+  baker ads meta audiences saved --account-id act_123            \u2014 saved audiences (read-only)`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-OGVDWWBV.js").then((m) => m.audiencesCreateCommand),
+    update: () => import("./write-commands-OGVDWWBV.js").then((m) => m.audiencesUpdateCommand),
+    delete: () => import("./audience-writes-CDKQB3SM.js").then((m) => m.audiencesDeleteCommand),
+    members: () => import("./audience-writes-CDKQB3SM.js").then((m) => m.audiencesMembersCommand),
+    saved: () => import("./audience-writes-CDKQB3SM.js").then((m) => m.savedAudiencesCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  audiencesCommand
+};
+//# sourceMappingURL=audiences-CDDI5HR5.js.map

package/dist/audiences-M3A3QK52.js

@@ -0,0 +1,280 @@
+import {
+  csvArg,
+  failWriteValidation,
+  requireTarget,
+  requireTargets,
+  schemaArgs,
+  stageChatgptOp,
+  stageChatgptOps
+} from "./chunk-WFY7KSHB.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  CHATGPT_AUDIENCE_USES,
+  CHATGPT_MAX_STAGED_MEMBERS,
+  runChatgptListRead
+} from "./chunk-GW2WRZZA.js";
+import "./chunk-ZRP7Y2DM.js";
+import {
+  PEOPLE_PREVIEW_ROWS,
+  maskPersonValue
+} from "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/audiences.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/ads/chatgpt/audience-members.ts
+import { createHash } from "crypto";
+import { parse } from "csv-parse/sync";
+import { isSupportedCountry, parsePhoneNumberFromString } from "libphonenumber-js";
+function sha256(value) {
+  return createHash("sha256").update(value, "utf8").digest("hex");
+}
+function normalizedEmail(value) {
+  const email = value.trim().toLowerCase();
+  return /^[^@\s;,|]+@[^@\s;,|]+\.[^@\s;,|]+$/.test(email) ? email : void 0;
+}
+function normalizedPhone(value, defaultCountry) {
+  const country = defaultCountry && isSupportedCountry(defaultCountry) ? defaultCountry : void 0;
+  const phone = parsePhoneNumberFromString(value.trim(), country);
+  return phone?.isValid() ? phone.number : void 0;
+}
+function hashedMembers(input) {
+  const rejected = [];
+  const emails = /* @__PURE__ */ new Map();
+  const phones = /* @__PURE__ */ new Map();
+  for (const value of input.emails) {
+    const email = normalizedEmail(value);
+    email ? emails.set(sha256(email), maskPersonValue("email", email)) : rejected.push(value.trim());
+  }
+  for (const value of input.phones) {
+    const phone = normalizedPhone(value, input.defaultCountry);
+    phone ? phones.set(sha256(phone), maskPersonValue("phone", phone)) : rejected.push(value.trim());
+  }
+  return {
+    emailHashes: [...emails.keys()],
+    phoneHashes: [...phones.keys()],
+    // The review shows the first of them; the rest are counted.
+    previews: [...emails.values(), ...phones.values()].slice(0, PEOPLE_PREVIEW_ROWS),
+    rejected
+  };
+}
+function headerWords(cell) {
+  return cell.normalize("NFD").replace(new RegExp("\\p{Diacritic}", "gu"), "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
+}
+var EMAIL_HEADER = /\b(e ?mail|correo|mail)\b/;
+var PHONE_HEADER = /\b(phone|telefono|movil|mobile|tel|celular)\b/;
+function membersFromFile(content) {
+  const rows = parse(content, {
+    bom: true,
+    skip_empty_lines: true,
+    relax_column_count: true,
+    trim: true,
+    delimiter: [",", ";", "	"]
+  });
+  const header = (rows[0] ?? []).map(headerWords);
+  const emailColumn = header.findIndex((cell) => EMAIL_HEADER.test(cell));
+  const phoneColumn = header.findIndex((cell) => !EMAIL_HEADER.test(cell) && PHONE_HEADER.test(cell));
+  if (emailColumn >= 0 || phoneColumn >= 0) {
+    const cells = (column) => column < 0 ? [] : rows.slice(1).flatMap((row) => row[column] ? [row[column]] : []);
+    return { emails: cells(emailColumn), phones: cells(phoneColumn) };
+  }
+  const values = rows.flatMap((row) => row[0] ? [row[0]] : []);
+  return values.some((value) => value.includes("@")) ? { emails: values, phones: [] } : { emails: [], phones: values };
+}
+
+// src/commands/ads/chatgpt/audiences.ts
+var REFERENCE = CHATGPT_ADS_REFERENCE.audiences;
+var MEMBER_ARGS = {
+  emails: { type: "string", description: "Emails, comma-separated" },
+  phones: { type: "string", description: "Phones, comma-separated \u2014 E.164 (+34\u2026), or local with --country" },
+  file: {
+    type: "string",
+    description: "A CSV with an email and/or phone column, or one email or phone per line \u2014 the company's own customers"
+  },
+  country: { type: "string", description: "Country of phones written without a +code, e.g. ES" }
+};
+function membersFromArgs(args, readFile = (path) => readFileSync(path, "utf8")) {
+  const fromFile = typeof args.file === "string" && args.file ? membersFromFile(readFile(args.file)) : { emails: [], phones: [] };
+  const given = [...csvArg(args.emails) ?? [], ...fromFile.emails];
+  const givenPhones = [...csvArg(args.phones) ?? [], ...fromFile.phones];
+  const members = hashedMembers({
+    emails: given,
+    phones: givenPhones,
+    defaultCountry: typeof args.country === "string" ? args.country.toUpperCase() : void 0
+  });
+  const count = members.emailHashes.length + members.phoneHashes.length;
+  const offered = given.length + givenPhones.length + (typeof args.file === "string" && args.file ? 1 : 0);
+  const refusal = count > CHATGPT_MAX_STAGED_MEMBERS ? `${count} members \u2014 at most ${CHATGPT_MAX_STAGED_MEMBERS} per change; split the file` : count === 0 && offered > 0 ? "none of the values was an email or a valid phone \u2014 name the columns email and phone, and give phones a +country code or --country" : void 0;
+  return {
+    payload: {
+      ...members.emailHashes.length > 0 ? { emailHashes: members.emailHashes } : {},
+      ...members.phoneHashes.length > 0 ? { phoneHashes: members.phoneHashes } : {},
+      ...members.previews.length > 0 ? { memberPreviews: members.previews } : {}
+    },
+    rejected: members.rejected.length,
+    ...refusal ? { refusal } : {}
+  };
+}
+function rejectedHint(rejected) {
+  return rejected > 0 ? [
+    `${rejected} value(s) were neither an email nor a valid phone and were left out \u2014 phones need a +country code, or --country.`
+  ] : [];
+}
+var LIST_ARGS = {
+  "eligible-for": {
+    type: "string",
+    description: `Only audiences ChatGPT Ads lets serve this use: ${CHATGPT_AUDIENCE_USES.join("|")}`
+  }
+};
+registerSchema({
+  command: "ads.chatgpt.audiences.list",
+  description: "The account's custom audiences: status, and matched people as a privacy range (under_25k\u2026). `ready` is not eligibility \u2014 pass --eligible-for to list only those a use accepts.",
+  args: schemaArgs(LIST_ARGS)
+});
+var audiencesListCommand = defineCommand({
+  meta: { name: "list", description: "List the account's custom audiences." },
+  args: LIST_ARGS,
+  run: async ({ args }) => {
+    const use = typeof args["eligible-for"] === "string" ? args["eligible-for"] : void 0;
+    await runChatgptListRead(
+      REFERENCE,
+      "/api/ads/chatgpt/audiences",
+      use ? { eligible_for: use } : void 0,
+      (rows) => rows.length === 0 ? ["No audience. Stage one with `baker ads chatgpt audiences create --name \u2026 --file customers.csv`."] : [
+        "Including an audience needs about 25,000 matched people; excluding works at any size. Custom audiences do not work in campaigns serving the EEA or Switzerland."
+      ]
+    );
+  }
+});
+var CREATE_ARGS = {
+  name: { type: "string", description: "Audience name (3+ characters)", required: true },
+  description: { type: "string", description: "What the list is" },
+  ...MEMBER_ARGS
+};
+registerSchema({
+  command: "ads.chatgpt.audiences.create",
+  description: "Stage a custom audience from the company's own customers (emails and/or phones, hashed on this machine), or an empty one. Created when the chat is published; only first-party data the company may use for ads.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var audiencesCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a custom audience (applies when the chat is published). Members are hashed here; nothing raw is sent.
+
+Examples:
+  baker ads chatgpt audiences create --name "Customers 2026" --file customers.csv --country ES
+  baker ads chatgpt audiences create --name "Recent buyers"   # empty, fill it later with add`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    const { payload, rejected, refusal } = membersFromArgs(args);
+    if (refusal) {
+      failWriteValidation(refusal);
+    }
+    await stageChatgptOp(
+      {
+        kind: "audience.create",
+        payload: { name: args.name, ...args.description ? { description: args.description } : {}, ...payload }
+      },
+      REFERENCE,
+      (staged) => [
+        ...rejectedHint(rejected),
+        `Use it on a campaign after the publish, once \`audiences\` shows it ready: campaigns update <cmpn_id> --excluded-audience-ids <caud_id>. (${staged.ref} is its ref in this chat.)`
+      ]
+    );
+  }
+});
+function membersCommand(verb) {
+  const args = {
+    id: { type: "positional", description: "Audience id (caud_\u2026)", required: true },
+    ...MEMBER_ARGS
+  };
+  registerSchema({
+    command: `ads.chatgpt.audiences.${verb}`,
+    description: `Stage ${verb === "add" ? "adding" : "removing"} members ${verb === "add" ? "to" : "from"} a live custom audience, hashed on this machine. Applies when the chat is published.`,
+    args: schemaArgs(args)
+  });
+  return defineCommand({
+    meta: {
+      name: verb,
+      description: `Stage ${verb === "add" ? "adding" : "removing"} members.
+
+Example:
+  baker ads chatgpt audiences ${verb} caud_123 --emails ana@example.com,luis@example.com`
+    },
+    args,
+    run: async ({ args: parsed }) => {
+      const { payload, rejected, refusal } = membersFromArgs(parsed);
+      if (refusal) {
+        failWriteValidation(refusal);
+      }
+      if (!payload.emailHashes && !payload.phoneHashes) {
+        failWriteValidation("name at least one email or phone with --emails, --phones or --file");
+      }
+      await stageChatgptOp(
+        { kind: `audience.${verb}`, target: requireTarget(parsed, "id"), payload },
+        REFERENCE,
+        () => rejectedHint(rejected)
+      );
+    }
+  });
+}
+var ARCHIVE_ARGS = {
+  ids: { type: "positional", description: "Audience ids, comma-separated", required: true }
+};
+registerSchema({
+  command: "ads.chatgpt.audiences.archive",
+  description: "Stage archiving custom audiences \u2014 for good: ChatGPT Ads cannot bring one back. Pass every id in one call.",
+  args: schemaArgs(ARCHIVE_ARGS)
+});
+var audiencesArchiveCommand = defineCommand({
+  meta: {
+    name: "archive",
+    description: `Stage archiving audiences, for good.
+
+Example:
+  baker ads chatgpt audiences archive caud_123`
+  },
+  args: ARCHIVE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOps(
+      requireTargets(args, "ids").map((id) => ({ kind: "audience.archive", target: id, payload: {} })),
+      REFERENCE
+    );
+  }
+});
+var audiencesCommand = defineCommand({
+  meta: {
+    name: "audiences",
+    description: `Custom audiences \u2014 the company's own customer lists a campaign serves to or leaves out.
+
+Examples:
+  baker ads chatgpt audiences
+  baker ads chatgpt audiences create --name "Customers 2026" --file customers.csv --country ES
+  baker ads chatgpt audiences add caud_123 --emails ana@example.com`
+  },
+  subCommands: {
+    list: audiencesListCommand,
+    create: audiencesCreateCommand,
+    add: membersCommand("add"),
+    remove: membersCommand("remove"),
+    archive: audiencesArchiveCommand
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args: {},
+  default: "list"
+});
+export {
+  audiencesCommand,
+  membersFromArgs
+};
+//# sourceMappingURL=audiences-M3A3QK52.js.map

package/dist/audiences-M3A3QK52.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/audiences.ts","../src/commands/ads/chatgpt/audience-members.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { CHATGPT_AUDIENCE_USES, CHATGPT_MAX_STAGED_MEMBERS, type ChatgptAdsAudience } from \"@baker/api/ads-chatgpt\";\nimport { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { hashedMembers, membersFromFile } from \"./audience-members.ts\";\nimport { CHATGPT_ADS_REFERENCE, runChatgptListRead } from \"./shared.ts\";\nimport {\n  csvArg,\n  failWriteValidation,\n  requireTarget,\n  requireTargets,\n  schemaArgs,\n  stageChatgptOp,\n  stageChatgptOps,\n} from \"./write-shared.ts\";\n\n/**\n * Custom audiences: lists of the company's own customers a campaign serves to\n * or leaves out. Members are hashed on this machine before anything is sent —\n * Baker and ChatGPT Ads only ever see SHA-256 digests.\n */\n\nconst REFERENCE = CHATGPT_ADS_REFERENCE.audiences;\n\nconst MEMBER_ARGS = {\n  emails: { type: \"string\", description: \"Emails, comma-separated\" },\n  phones: { type: \"string\", description: \"Phones, comma-separated — E.164 (+34…), or local with --country\" },\n  file: {\n    type: \"string\",\n    description:\n      \"A CSV with an email and/or phone column, or one email or phone per line — the company's own customers\",\n  },\n  country: { type: \"string\", description: \"Country of phones written without a +code, e.g. ES\" },\n} as const;\n\ntype Args = Record<string, unknown>;\n\n/** The members the flags name, hashed — with the reason to refuse them when none is usable or there are too many. */\nexport function membersFromArgs(args: Args, readFile: (path: string) => string = (path) => readFileSync(path, \"utf8\")) {\n  const fromFile =\n    typeof args.file === \"string\" && args.file ? membersFromFile(readFile(args.file)) : { emails: [], phones: [] };\n  const given = [...(csvArg(args.emails) ?? []), ...fromFile.emails];\n  const givenPhones = [...(csvArg(args.phones) ?? []), ...fromFile.phones];\n  const members = hashedMembers({\n    emails: given,\n    phones: givenPhones,\n    defaultCountry: typeof args.country === \"string\" ? args.country.toUpperCase() : undefined,\n  });\n  const count = members.emailHashes.length + members.phoneHashes.length;\n  const offered = given.length + givenPhones.length + (typeof args.file === \"string\" && args.file ? 1 : 0);\n  const refusal =\n    count > CHATGPT_MAX_STAGED_MEMBERS\n      ? `${count} members — at most ${CHATGPT_MAX_STAGED_MEMBERS} per change; split the file`\n      : count === 0 && offered > 0\n        ? \"none of the values was an email or a valid phone — name the columns email and phone, and give phones a +country code or --country\"\n        : undefined;\n  return {\n    payload: {\n      ...(members.emailHashes.length > 0 ? { emailHashes: members.emailHashes } : {}),\n      ...(members.phoneHashes.length > 0 ? { phoneHashes: members.phoneHashes } : {}),\n      ...(members.previews.length > 0 ? { memberPreviews: members.previews } : {}),\n    },\n    rejected: members.rejected.length,\n    ...(refusal ? { refusal } : {}),\n  };\n}\n\nfunction rejectedHint(rejected: number): string[] {\n  return rejected > 0\n    ? [\n        `${rejected} value(s) were neither an email nor a valid phone and were left out — phones need a +country code, or --country.`,\n      ]\n    : [];\n}\n\nconst LIST_ARGS = {\n  \"eligible-for\": {\n    type: \"string\",\n    description: `Only audiences ChatGPT Ads lets serve this use: ${CHATGPT_AUDIENCE_USES.join(\"|\")}`,\n  },\n} as const;\n\nregisterSchema({\n  command: \"ads.chatgpt.audiences.list\",\n  description:\n    \"The account's custom audiences: status, and matched people as a privacy range (under_25k…). `ready` is not eligibility — pass --eligible-for to list only those a use accepts.\",\n  args: schemaArgs(LIST_ARGS),\n});\n\nconst audiencesListCommand = defineCommand({\n  meta: { name: \"list\", description: \"List the account's custom audiences.\" },\n  args: LIST_ARGS,\n  run: async ({ args }) => {\n    const use = typeof args[\"eligible-for\"] === \"string\" ? args[\"eligible-for\"] : undefined;\n    await runChatgptListRead<ChatgptAdsAudience[]>(\n      REFERENCE,\n      \"/api/ads/chatgpt/audiences\",\n      use ? { eligible_for: use } : undefined,\n      (rows) =>\n        rows.length === 0\n          ? [\"No audience. Stage one with `baker ads chatgpt audiences create --name … --file customers.csv`.\"]\n          : [\n              \"Including an audience needs about 25,000 matched people; excluding works at any size. Custom audiences do not work in campaigns serving the EEA or Switzerland.\",\n            ],\n    );\n  },\n});\n\nconst CREATE_ARGS = {\n  name: { type: \"string\", description: \"Audience name (3+ characters)\", required: true },\n  description: { type: \"string\", description: \"What the list is\" },\n  ...MEMBER_ARGS,\n} as const;\n\nregisterSchema({\n  command: \"ads.chatgpt.audiences.create\",\n  description:\n    \"Stage a custom audience from the company's own customers (emails and/or phones, hashed on this machine), or an empty one. Created when the chat is published; only first-party data the company may use for ads.\",\n  args: schemaArgs(CREATE_ARGS),\n});\n\nconst audiencesCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a custom audience (applies when the chat is published). Members are hashed here; nothing raw is sent.\n\nExamples:\n  baker ads chatgpt audiences create --name \"Customers 2026\" --file customers.csv --country ES\n  baker ads chatgpt audiences create --name \"Recent buyers\"   # empty, fill it later with add`,\n  },\n  args: CREATE_ARGS,\n  run: async ({ args }) => {\n    const { payload, rejected, refusal } = membersFromArgs(args);\n    if (refusal) {\n      failWriteValidation(refusal);\n    }\n    await stageChatgptOp(\n      {\n        kind: \"audience.create\",\n        payload: { name: args.name, ...(args.description ? { description: args.description } : {}), ...payload },\n      },\n      REFERENCE,\n      (staged) => [\n        ...rejectedHint(rejected),\n        `Use it on a campaign after the publish, once \\`audiences\\` shows it ready: campaigns update <cmpn_id> --excluded-audience-ids <caud_id>. (${staged.ref} is its ref in this chat.)`,\n      ],\n    );\n  },\n});\n\nfunction membersCommand(verb: \"add\" | \"remove\") {\n  const args = {\n    id: { type: \"positional\", description: \"Audience id (caud_…)\", required: true },\n    ...MEMBER_ARGS,\n  } as const;\n  registerSchema({\n    command: `ads.chatgpt.audiences.${verb}`,\n    description: `Stage ${verb === \"add\" ? \"adding\" : \"removing\"} members ${verb === \"add\" ? \"to\" : \"from\"} a live custom audience, hashed on this machine. Applies when the chat is published.`,\n    args: schemaArgs(args),\n  });\n  return defineCommand({\n    meta: {\n      name: verb,\n      description: `Stage ${verb === \"add\" ? \"adding\" : \"removing\"} members.\n\nExample:\n  baker ads chatgpt audiences ${verb} caud_123 --emails ana@example.com,luis@example.com`,\n    },\n    args,\n    run: async ({ args: parsed }) => {\n      const { payload, rejected, refusal } = membersFromArgs(parsed);\n      if (refusal) {\n        failWriteValidation(refusal);\n      }\n      if (!payload.emailHashes && !payload.phoneHashes) {\n        failWriteValidation(\"name at least one email or phone with --emails, --phones or --file\");\n      }\n      await stageChatgptOp({ kind: `audience.${verb}`, target: requireTarget(parsed, \"id\"), payload }, REFERENCE, () =>\n        rejectedHint(rejected),\n      );\n    },\n  });\n}\n\nconst ARCHIVE_ARGS = {\n  ids: { type: \"positional\", description: \"Audience ids, comma-separated\", required: true },\n} as const;\n\nregisterSchema({\n  command: \"ads.chatgpt.audiences.archive\",\n  description:\n    \"Stage archiving custom audiences — for good: ChatGPT Ads cannot bring one back. Pass every id in one call.\",\n  args: schemaArgs(ARCHIVE_ARGS),\n});\n\nconst audiencesArchiveCommand = defineCommand({\n  meta: {\n    name: \"archive\",\n    description: `Stage archiving audiences, for good.\n\nExample:\n  baker ads chatgpt audiences archive caud_123`,\n  },\n  args: ARCHIVE_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOps(\n      requireTargets(args, \"ids\").map((id) => ({ kind: \"audience.archive\", target: id, payload: {} })),\n      REFERENCE,\n    );\n  },\n});\n\nexport const audiencesCommand = defineCommand({\n  meta: {\n    name: \"audiences\",\n    description: `Custom audiences — the company's own customer lists a campaign serves to or leaves out.\n\nExamples:\n  baker ads chatgpt audiences\n  baker ads chatgpt audiences create --name \"Customers 2026\" --file customers.csv --country ES\n  baker ads chatgpt audiences add caud_123 --emails ana@example.com`,\n  },\n  subCommands: {\n    list: audiencesListCommand,\n    create: audiencesCreateCommand,\n    add: membersCommand(\"add\"),\n    remove: membersCommand(\"remove\"),\n    archive: audiencesArchiveCommand,\n  },\n  // A parent must never declare `run`: citty falls through to it after the matched subcommand.\n  args: {},\n  default: \"list\",\n});\n","import { createHash } from \"node:crypto\";\nimport { maskPersonValue, PEOPLE_PREVIEW_ROWS } from \"@baker/api/ads-common/people\";\nimport { parse } from \"csv-parse/sync\";\nimport { type CountryCode, isSupportedCountry, parsePhoneNumberFromString } from \"libphonenumber-js\";\n\n/**\n * An audience's members, hashed here — on the agent's machine — so no raw\n * email or phone ever reaches Baker or ChatGPT Ads. The normalization is\n * ChatGPT Ads' own: an email trimmed and lowercased (dots and plus tags kept),\n * a phone in E.164; each is SHA-256 hex. Beside the digests goes each\n * member masked (`a***@example.com`, `***001`) for the review in Baker.\n */\n\nfunction sha256(value: string): string {\n  return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n/**\n * One `@`, a dotted domain, and nothing that separates values — a cell holding\n * `ana@x.com;+34…` is two values run together, never an email to hash.\n */\nfunction normalizedEmail(value: string): string | undefined {\n  const email = value.trim().toLowerCase();\n  return /^[^@\\s;,|]+@[^@\\s;,|]+\\.[^@\\s;,|]+$/.test(email) ? email : undefined;\n}\n\nfunction normalizedPhone(value: string, defaultCountry: string | undefined): string | undefined {\n  const country = defaultCountry && isSupportedCountry(defaultCountry) ? (defaultCountry as CountryCode) : undefined;\n  const phone = parsePhoneNumberFromString(value.trim(), country);\n  return phone?.isValid() ? phone.number : undefined;\n}\n\nexport function hashedMembers(input: {\n  emails: readonly string[];\n  phones: readonly string[];\n  defaultCountry: string | undefined;\n}): { emailHashes: string[]; phoneHashes: string[]; previews: string[]; rejected: string[] } {\n  const rejected: string[] = [];\n  // Hash → masked copy, so a member given twice is reviewed once, as it is sent.\n  const emails = new Map<string, string>();\n  const phones = new Map<string, string>();\n  for (const value of input.emails) {\n    const email = normalizedEmail(value);\n    email ? emails.set(sha256(email), maskPersonValue(\"email\", email)) : rejected.push(value.trim());\n  }\n  for (const value of input.phones) {\n    const phone = normalizedPhone(value, input.defaultCountry);\n    phone ? phones.set(sha256(phone), maskPersonValue(\"phone\", phone)) : rejected.push(value.trim());\n  }\n  return {\n    emailHashes: [...emails.keys()],\n    phoneHashes: [...phones.keys()],\n    // The review shows the first of them; the rest are counted.\n    previews: [...emails.values(), ...phones.values()].slice(0, PEOPLE_PREVIEW_ROWS),\n    rejected,\n  };\n}\n\n/** A header as its words: lowercased, accents and separators gone — \"Teléfono móvil\" is \"telefono movil\". */\nfunction headerWords(cell: string): string {\n  return cell\n    .normalize(\"NFD\")\n    .replace(/\\p{Diacritic}/gu, \"\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \" \")\n    .trim();\n}\n\nconst EMAIL_HEADER = /\\b(e ?mail|correo|mail)\\b/;\nconst PHONE_HEADER = /\\b(phone|telefono|movil|mobile|tel|celular)\\b/;\n\n/**\n * A CSV with an email and/or phone column, or a plain list, one value per\n * line — whatever a marketer exported. A plain list is emails, or phones when\n * no line has an `@`.\n */\nexport function membersFromFile(content: string): { emails: string[]; phones: string[] } {\n  // Excel writes `;` where the decimal comma is taken, tabs come from a copied sheet.\n  const rows: string[][] = parse(content, {\n    bom: true,\n    skip_empty_lines: true,\n    relax_column_count: true,\n    trim: true,\n    delimiter: [\",\", \";\", \"\\t\"],\n  });\n  const header = (rows[0] ?? []).map(headerWords);\n  const emailColumn = header.findIndex((cell) => EMAIL_HEADER.test(cell));\n  const phoneColumn = header.findIndex((cell) => !EMAIL_HEADER.test(cell) && PHONE_HEADER.test(cell));\n  if (emailColumn >= 0 || phoneColumn >= 0) {\n    const cells = (column: number) =>\n      column < 0 ? [] : rows.slice(1).flatMap((row) => (row[column] ? [row[column]] : []));\n    return { emails: cells(emailColumn), phones: cells(phoneColumn) };\n  }\n  const values = rows.flatMap((row) => (row[0] ? [row[0]] : []));\n  return values.some((value) => value.includes(\"@\")) ? { emails: values, phones: [] } : { emails: [], phones: values };\n}\n"],"mappings":"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","names":[]}

package/dist/audit-FLPJ7GTE.js

@@ -0,0 +1,154 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-IRM273C7.js";
+import {
+  writeAdsJson
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-PC3FJEZH.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.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-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/audit.ts
+import { defineCommand } from "citty";
+var SEVERITY_RANK = {
+  critical: 0,
+  high: 1,
+  medium: 2,
+  low: 3
+};
+var STATUS_RANK = {
+  fail: 0,
+  warn: 1,
+  partial: 2,
+  pass: 3,
+  n_a: 4
+};
+function filterFindings(findings, severity, area) {
+  return findings.filter((f) => {
+    if (severity && !severity.includes(f.severity)) return false;
+    if (area && !area.includes(f.area)) return false;
+    return true;
+  });
+}
+function sortFindings(findings) {
+  return [...findings].sort((a, b) => {
+    const sa = STATUS_RANK[a.status] - STATUS_RANK[b.status];
+    if (sa !== 0) return sa;
+    return SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];
+  });
+}
+function renderMarkdown(result) {
+  const lines = [];
+  lines.push(`# LinkedIn Ads Audit \u2014 ${result.account.name} (${result.account.id})`);
+  lines.push("");
+  lines.push(
+    `**Scope:** ${result.scope.campaigns} campaigns, ${result.scope.creatives} creatives, last ${result.scope.windowDays}d`
+  );
+  lines.push("");
+  lines.push(
+    `**Summary:** ${result.summary.pass} pass \u2022 ${result.summary.critical} critical \u2022 ${result.summary.high} high \u2022 ${result.summary.medium} medium \u2022 ${result.summary.low} low \u2022 ${result.summary.n_a} n/a (${result.summary.totalChecks} total)`
+  );
+  lines.push("");
+  lines.push("| # | Area | Check | Status | Severity | Notes |");
+  lines.push("|---|------|-------|--------|----------|-------|");
+  result.findings.forEach((f, idx) => {
+    const note = noteOf(f);
+    lines.push(
+      `| ${idx + 1} | ${f.area} | ${escapeMd(f.check)} | ${f.status.toUpperCase()} | ${f.severity} | ${escapeMd(note)} |`
+    );
+  });
+  return lines.join("\n");
+}
+function escapeMd(text) {
+  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+}
+function noteOf(f) {
+  if (f.status === "pass") return "";
+  const ev = f.evidence ? JSON.stringify(f.evidence) : "";
+  const fix = f.fix?.explanation ?? "";
+  return [fix, ev].filter(Boolean).join(" \u2014 ");
+}
+var auditCommand = defineCommand({
+  meta: {
+    name: "audit",
+    description: `Run a LinkedIn Ads playbook audit \u2014 30+ checks across Settings, Tracking,
+Audience, Campaigns, Creative, Performance, Bidding, and Compliance.
+
+Each finding has {id, area, check, status, severity, evidence, fix} fields with
+playbook citations. The default JSON output is agent-friendly; --format md
+renders a deliverable-ready table that mirrors the google-ads-playbook
+10-audit-summary.md style.
+
+Exit code 0 always. Use the JSON 'summary' counts to decide if action is needed.
+
+Examples:
+  baker ads linkedin audit --account-id 503001492
+  baker ads linkedin audit --account-id 503001492 --campaign-id 1234        # narrow scope
+  baker ads linkedin audit --account-id 503001492 --window-days 90
+  baker ads linkedin audit --account-id 503001492 --severity critical,high
+  baker ads linkedin audit --account-id 503001492 --area Settings,Tracking
+  baker ads linkedin audit --account-id 503001492 --format md`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "campaign-id": { type: "string", description: "Narrow scope to a single campaign" },
+    "window-days": { type: "string", description: "Lookback window for performance checks (default: 30)" },
+    severity: { type: "string", description: "CSV severity filter: critical,high,medium,low" },
+    area: {
+      type: "string",
+      description: "CSV area filter: Settings,Tracking,Audience,Campaigns,Creative,Performance,Bidding,Compliance,Hygiene"
+    },
+    format: { type: "string", description: "Output format: json | md (default: json)" },
+    "no-cache": NO_CACHE_ARG
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const windowDays = args["window-days"] ? Number(args["window-days"]) : 30;
+    if (!Number.isFinite(windowDays) || windowDays < 1 || windowDays > 365) {
+      handleLinkedinError(new Error("--window-days must be 1..365"));
+    }
+    try {
+      const data = await apiPost("/api/ads/linkedin/audit", {
+        accountId,
+        campaignId: args["campaign-id"] ? String(args["campaign-id"]) : void 0,
+        windowDays,
+        skipCache: Boolean(args["no-cache"])
+      });
+      const severityFilter = args.severity?.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+      const areaFilter = args.area?.split(",").map((s) => s.trim()).filter(Boolean);
+      const filtered = filterFindings(data.findings, severityFilter, areaFilter);
+      const sorted = sortFindings(filtered);
+      const result = { ...data, findings: sorted };
+      const fmt = args.format ?? "json";
+      if (fmt === "md") {
+        process.stdout.write(`${renderMarkdown(result)}
+`);
+        return;
+      }
+      writeAdsJson({ ok: true, data: result });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  auditCommand
+};
+//# sourceMappingURL=audit-FLPJ7GTE.js.map

package/dist/audit-FLPJ7GTE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/audit.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport { handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\ninterface AuditFinding {\n  id: string;\n  area: string;\n  check: string;\n  status: \"pass\" | \"fail\" | \"partial\" | \"warn\" | \"n_a\";\n  severity: \"critical\" | \"high\" | \"medium\" | \"low\";\n  evidence?: Record<string, unknown>;\n  fix?: { explanation: string; playbookRef?: string; correctedCommand?: string };\n}\n\ninterface AuditResult {\n  account: { urn: string; id: string; name: string };\n  scope: { campaigns: number; creatives: number; windowDays: number };\n  summary: {\n    critical: number;\n    high: number;\n    medium: number;\n    low: number;\n    pass: number;\n    n_a: number;\n    totalChecks: number;\n  };\n  findings: AuditFinding[];\n}\n\nconst SEVERITY_RANK: Record<AuditFinding[\"severity\"], number> = {\n  critical: 0,\n  high: 1,\n  medium: 2,\n  low: 3,\n};\n\nconst STATUS_RANK: Record<AuditFinding[\"status\"], number> = {\n  fail: 0,\n  warn: 1,\n  partial: 2,\n  pass: 3,\n  n_a: 4,\n};\n\nfunction filterFindings(\n  findings: AuditFinding[],\n  severity: string[] | undefined,\n  area: string[] | undefined,\n): AuditFinding[] {\n  return findings.filter((f) => {\n    if (severity && !severity.includes(f.severity)) return false;\n    if (area && !area.includes(f.area)) return false;\n    return true;\n  });\n}\n\nfunction sortFindings(findings: AuditFinding[]): AuditFinding[] {\n  return [...findings].sort((a, b) => {\n    const sa = STATUS_RANK[a.status] - STATUS_RANK[b.status];\n    if (sa !== 0) return sa;\n    return SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];\n  });\n}\n\n/**\n * Render the audit as a markdown table that mirrors\n * google-ads-playbook/10-audit-summary.md so the agent can drop it into a\n * client deliverable as-is.\n */\nfunction renderMarkdown(result: AuditResult): string {\n  const lines: string[] = [];\n  lines.push(`# LinkedIn Ads Audit — ${result.account.name} (${result.account.id})`);\n  lines.push(\"\");\n  lines.push(\n    `**Scope:** ${result.scope.campaigns} campaigns, ${result.scope.creatives} creatives, last ${result.scope.windowDays}d`,\n  );\n  lines.push(\"\");\n  lines.push(\n    `**Summary:** ${result.summary.pass} pass • ${result.summary.critical} critical • ${result.summary.high} high • ${result.summary.medium} medium • ${result.summary.low} low • ${result.summary.n_a} n/a (${result.summary.totalChecks} total)`,\n  );\n  lines.push(\"\");\n  lines.push(\"| # | Area | Check | Status | Severity | Notes |\");\n  lines.push(\"|---|------|-------|--------|----------|-------|\");\n  result.findings.forEach((f, idx) => {\n    const note = noteOf(f);\n    lines.push(\n      `| ${idx + 1} | ${f.area} | ${escapeMd(f.check)} | ${f.status.toUpperCase()} | ${f.severity} | ${escapeMd(note)} |`,\n    );\n  });\n  return lines.join(\"\\n\");\n}\n\nfunction escapeMd(text: string): string {\n  return text.replace(/\\|/g, \"\\\\|\").replace(/\\n/g, \" \");\n}\n\nfunction noteOf(f: AuditFinding): string {\n  if (f.status === \"pass\") return \"\";\n  const ev = f.evidence ? JSON.stringify(f.evidence) : \"\";\n  const fix = f.fix?.explanation ?? \"\";\n  return [fix, ev].filter(Boolean).join(\" — \");\n}\n\nexport const auditCommand = defineCommand({\n  meta: {\n    name: \"audit\",\n    description: `Run a LinkedIn Ads playbook audit — 30+ checks across Settings, Tracking,\nAudience, Campaigns, Creative, Performance, Bidding, and Compliance.\n\nEach finding has {id, area, check, status, severity, evidence, fix} fields with\nplaybook citations. The default JSON output is agent-friendly; --format md\nrenders a deliverable-ready table that mirrors the google-ads-playbook\n10-audit-summary.md style.\n\nExit code 0 always. Use the JSON 'summary' counts to decide if action is needed.\n\nExamples:\n  baker ads linkedin audit --account-id 503001492\n  baker ads linkedin audit --account-id 503001492 --campaign-id 1234        # narrow scope\n  baker ads linkedin audit --account-id 503001492 --window-days 90\n  baker ads linkedin audit --account-id 503001492 --severity critical,high\n  baker ads linkedin audit --account-id 503001492 --area Settings,Tracking\n  baker ads linkedin audit --account-id 503001492 --format md`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    \"campaign-id\": { type: \"string\", description: \"Narrow scope to a single campaign\" },\n    \"window-days\": { type: \"string\", description: \"Lookback window for performance checks (default: 30)\" },\n    severity: { type: \"string\", description: \"CSV severity filter: critical,high,medium,low\" },\n    area: {\n      type: \"string\",\n      description:\n        \"CSV area filter: Settings,Tracking,Audience,Campaigns,Creative,Performance,Bidding,Compliance,Hygiene\",\n    },\n    format: { type: \"string\", description: \"Output format: json | md (default: json)\" },\n    \"no-cache\": NO_CACHE_ARG,\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    const windowDays = args[\"window-days\"] ? Number(args[\"window-days\"]) : 30;\n    if (!Number.isFinite(windowDays) || windowDays < 1 || windowDays > 365) {\n      handleLinkedinError(new Error(\"--window-days must be 1..365\"));\n    }\n    try {\n      const data = await apiPost<AuditResult>(\"/api/ads/linkedin/audit\", {\n        accountId,\n        campaignId: args[\"campaign-id\"] ? String(args[\"campaign-id\"]) : undefined,\n        windowDays,\n        skipCache: Boolean(args[\"no-cache\"]),\n      });\n\n      const severityFilter = (args.severity as string | undefined)\n        ?.split(\",\")\n        .map((s) => s.trim().toLowerCase())\n        .filter(Boolean);\n      const areaFilter = (args.area as string | undefined)\n        ?.split(\",\")\n        .map((s) => s.trim())\n        .filter(Boolean);\n      const filtered = filterFindings(data.findings, severityFilter, areaFilter);\n      const sorted = sortFindings(filtered);\n      const result: AuditResult = { ...data, findings: sorted };\n\n      const fmt = (args.format as string | undefined) ?? \"json\";\n      if (fmt === \"md\") {\n        process.stdout.write(`${renderMarkdown(result)}\\n`);\n        return;\n      }\n      writeAdsJson({ ok: true, data: result });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}