@koda-sl/baker-cli 0.379.0 → 0.380.0

package/README.md

@@ -942,6 +942,8 @@ baker ads meta custom-conversions --account-id act_123 --full   # raw rule JSON,
 
 Meta writes mirror the Google/LinkedIn model: they **never hit the Graph API when you run them**. Each op is validated at stage time (field shapes, budget rules, page/Instagram identity ownership, CBO/ABO exclusivity, status-transition legality), shows in the dashboard chat as a pending Meta change, and applies only when the chat is published. Meta has no atomic batch mutate, so ops apply **sequentially** on publish — one failure skips its dependents but the publish completes.
 
+Staging also refuses what LinkedIn would reject at publish: a campaign group created `PAUSED` (only `DRAFT`/`ACTIVE`), a group `--total-budget` without `--end`, a `PAUSED` campaign in a `DRAFT` group, archiving a `DRAFT` ad, and a library image that is not JPG, PNG or GIF. Every campaign carries `--political-intent` (`NOT_DECLARED` by default; `NOT_POLITICAL` or `POLITICAL` are the advertiser's declaration). A write to an ad account LinkedIn has not enabled for Baker fails with a message saying so.
+
 **That publish reaches the real ad account for every company** — Meta writes are generally available, with no per-company flag. Discarding the chat before it completes is what undoes a staged change.
 
 Chain a full ad from scratch with `meta_temp_*` refs (each create returns one):
@@ -1107,7 +1109,7 @@ baker ads linkedin bid-pricing --account-id 503001492 \
 - URN normalization: every URN field becomes `{type, id, urn}` so rows are self-describing.
 - Wide windows (>180d) auto-segment into 30-day chunks and combine, since `q=analytics` caps at 15,000 rows with no pagination.
 
-**Listings** (`campaign-groups`/`campaigns`/`creatives`) default to `ACTIVE` only — pass `--all-statuses` to widen, or `--statuses ACTIVE,PAUSED` for a custom set.
+**Listings** (`campaign-groups`/`campaigns`/`creatives`) default to `ACTIVE` only — pass `--all-statuses` to widen, or `--statuses ACTIVE,PAUSED` for a custom set. Only campaigns can be `COMPLETED`; each listing's `--help` names the statuses it accepts, and any other value is refused with `INVALID_STATUS` and that list before LinkedIn is called.
 
 **`creatives` is compact by default** — `id`, `urn`, `campaign`, `intendedStatus`, `isServing`, `reviewStatus`, `format`, and the resolved destination. The destination is read out of the format-specific `content` block for you: direct-content ads (text, spotlight) report a `landingUrl`; post-based ads (image, video, carousel, document, article, event, TLA) report a `postUrn`, because their destination lives in the sponsored post and is not reachable through the ads API. Pass `--fields id,content.textAd.landingPage` for specific dotted paths, or `--full` for the complete raw records.
 
@@ -1168,7 +1170,7 @@ Write commands never call the LinkedIn API at stage time. Each stages an op on t
 
 ```bash
 # Chain creates via li_temp_* refs — group → campaign → creative in one chat
-baker ads linkedin campaign-groups create --name "Q3 ABM" --total-budget 5000 --currency EUR   # → li_temp_x1
+baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-08-01 --end 2026-10-31 --total-budget 5000 --currency EUR   # → li_temp_x1
 baker ads linkedin campaigns create --name "ABM Tier-1" --group li_temp_x1 \
   --objective WEBSITE_VISIT --type SPONSORED_UPDATES --cost-type CPC \
   --bid 8.50 --daily-budget 75 --currency EUR --locale en_US --targeting-file targeting.json   # → li_temp_x2

package/dist/cli.js

@@ -975,6 +975,9 @@ var OBJECTIVE_CAMPAIGN_TYPES = {
   ENGAGEMENT: ["SPONSORED_UPDATES", "DYNAMIC"]
 };
 var STAGEABLE_CREATE_STATUSES = ["DRAFT", "ACTIVE", "PAUSED"];
+var CAMPAIGN_GROUP_CREATE_STATUSES = ["DRAFT", "ACTIVE"];
+var CAMPAIGN_GROUP_STATUSES = ["ACTIVE", "PAUSED", "ARCHIVED", "CANCELED", "DRAFT"];
+var POLITICAL_INTENTS = ["NOT_DECLARED", "NOT_POLITICAL", "POLITICAL"];
 var CREATIVE_INTENDED_STATUSES = ["ACTIVE", "PAUSED", "DRAFT"];
 var CTA_TYPES = [
   "APPLY",
@@ -1105,17 +1108,26 @@ var entityStatusSchema = z3.enum(["ACTIVE", "PAUSED", "ARCHIVED", "CANCELED", "D
 function currencyMinimums(currencyCode) {
   return CURRENCY_MINIMUMS[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM;
 }
-var campaignGroupCreateSchema = z3.object({
+var campaignGroupFieldsSchema = z3.object({
   name: z3.string().min(1).max(LINKEDIN_LIMITS.campaignGroup.nameMax),
   runSchedule: runScheduleSchema,
   totalBudget: moneySchema.optional(),
-  status: stageableStatusSchema.default("DRAFT")
+  status: z3.enum(CAMPAIGN_GROUP_CREATE_STATUSES).default("DRAFT")
+});
+var campaignGroupCreateSchema = campaignGroupFieldsSchema.superRefine((p, ctx) => {
+  if (p.totalBudget && !p.runSchedule.end) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["runSchedule", "end"],
+      message: "a group with totalBudget needs runSchedule.end"
+    });
+  }
 });
 var campaignGroupUpdateSchema = z3.object({
   name: z3.string().min(1).max(LINKEDIN_LIMITS.campaignGroup.nameMax).optional(),
   runSchedule: runScheduleSchema.optional(),
   totalBudget: moneySchema.optional(),
-  status: entityStatusSchema.optional()
+  status: z3.enum(CAMPAIGN_GROUP_STATUSES).optional()
 }).refine((p) => Object.values(p).some((val) => val !== void 0), "update needs at least one field");
 var campaignFields = {
   name: z3.string().min(1).max(LINKEDIN_LIMITS.campaign.nameMax),
@@ -1134,6 +1146,7 @@ var campaignFields = {
   connectedTelevisionOnly: z3.boolean().default(false),
   creativeSelection: z3.enum(CREATIVE_SELECTIONS).optional(),
   associatedEntity: z3.string().regex(ORGANIZATION_URN_REGEX).optional(),
+  politicalIntent: z3.enum(POLITICAL_INTENTS).default("NOT_DECLARED"),
   status: stageableStatusSchema.default("DRAFT")
 };
 function validateCampaignBudgets(p, ctx, { requireBudget }) {
@@ -1191,6 +1204,7 @@ var campaignUpdateSchema = z3.object({
   offsiteDeliveryEnabled: z3.boolean().optional(),
   connectedTelevisionOnly: z3.boolean().optional(),
   creativeSelection: z3.enum(CREATIVE_SELECTIONS).optional(),
+  politicalIntent: z3.enum(POLITICAL_INTENTS).optional(),
   status: entityStatusSchema.optional(),
   // Create-only on LinkedIn — a live campaign can't change these in place.
   // Accepted here only so `draft amend` can carry them into a staged CREATE
@@ -1816,6 +1830,17 @@ var linkedinDraftOpInputSchema = z3.discriminatedUnion("kind", [
   updateOp("leadForm.update", leadFormUpdateSchema)
 ]);
 
+// ../api/src/ads-linkedin/search-statuses.ts
+var LINKEDIN_SEARCH_STATUSES = {
+  campaignGroups: ["ACTIVE", "PAUSED", "ARCHIVED", "CANCELED", "DRAFT", "PENDING_DELETION", "REMOVED"],
+  campaigns: ["ACTIVE", "PAUSED", "ARCHIVED", "COMPLETED", "CANCELED", "DRAFT", "PENDING_DELETION", "REMOVED"],
+  creatives: ["ACTIVE", "PAUSED", "ARCHIVED", "CANCELED", "DRAFT", "PENDING_DELETION", "REMOVED"]
+};
+function unsupportedLinkedinSearchStatuses(level, statuses) {
+  const accepted = LINKEDIN_SEARCH_STATUSES[level];
+  return statuses.filter((status) => !accepted.includes(status));
+}
+
 // ../api/src/ads-linkedin/wire.ts
 import { z as z7 } from "zod";
 
@@ -20066,10 +20091,6 @@ Full guide: __tooling__/docs/tools/baker/ads-google.md`
 // src/commands/ads/linkedin/index.ts
 import { defineCommand as defineCommand53 } from "citty";
 
-// src/commands/ads/linkedin/write-shared.ts
-import { createHash } from "crypto";
-import { readFileSync as readFileSync5 } from "fs";
-
 // src/commands/ads/linkedin/shared.ts
 var DAY_MS2 = 864e5;
 function handleLinkedinError(err) {
@@ -20162,18 +20183,48 @@ function daysAgoIso2(days) {
 function csvOrJson2(args5) {
   return args5.output ?? "json";
 }
-function resolveStatusFilter(args5) {
+function statusesArgDescription(level) {
+  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(",")})`;
+}
+function statusFilterError(level, statuses) {
+  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);
+  if (unsupported.length === 0) {
+    return null;
+  }
+  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(",");
+  return {
+    ok: false,
+    error: {
+      code: "INVALID_STATUS",
+      message: `LinkedIn does not accept status ${unsupported.join(", ")} for this listing.`,
+      fix: {
+        action: "retry_with_flag",
+        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`
+      },
+      retryable: false
+    }
+  };
+}
+function resolveStatusFilter(args5, level) {
   if (args5["all-statuses"]) {
     return void 0;
   }
   const explicit = args5.statuses;
-  if (explicit) {
-    return explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  if (!explicit) {
+    return ["ACTIVE"];
   }
-  return ["ACTIVE"];
+  const statuses = explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  const error = statusFilterError(level, statuses);
+  if (error) {
+    writeAdsJson(error);
+    process.exit(1);
+  }
+  return statuses;
 }
 
 // src/commands/ads/linkedin/write-shared.ts
+import { createHash } from "crypto";
+import { readFileSync as readFileSync5 } from "fs";
 var TOTAL_BUDGET_HELP = "Lifetime budget \u2014 on something already running it must exceed spend to date, or LinkedIn rejects it";
 function bareAccountId(args5) {
   const raw = resolveAccountIdArg2(args5);
@@ -20500,7 +20551,7 @@ registerSchema({
     "account-id": { type: "string", description: "Account ID", required: false },
     "account-urn": { type: "string", description: "Alias for --account-id", required: false },
     "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
-    statuses: { type: "string", description: "CSV of statuses", required: false },
+    statuses: { type: "string", description: statusesArgDescription("campaignGroups"), required: false },
     limit: { type: "string", description: "Max rows (default 500)", required: false },
     "no-cache": NO_CACHE_ARG,
     output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
@@ -20514,7 +20565,7 @@ registerSchema({
     "account-urn": { type: "string", description: "Alias", required: false },
     "campaign-group-id": { type: "string", description: "Filter by campaign group", required: false },
     "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
-    statuses: { type: "string", description: "CSV of statuses", required: false },
+    statuses: { type: "string", description: statusesArgDescription("campaigns"), required: false },
     limit: { type: "string", description: "Max rows", required: false },
     "no-cache": NO_CACHE_ARG,
     output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
@@ -20528,7 +20579,7 @@ registerSchema({
     "account-urn": { type: "string", description: "Alias", required: false },
     "campaign-id": { type: "string", description: "Filter by campaign", required: false },
     "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
-    statuses: { type: "string", description: "CSV of statuses", required: false },
+    statuses: { type: "string", description: statusesArgDescription("creatives"), required: false },
     fields: {
       type: "string",
       description: "CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage",
@@ -20801,7 +20852,11 @@ registerSchema({
       description: "3-letter currency code (defaults to the ad account currency)",
       required: false
     },
-    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
+    status: {
+      type: "string",
+      description: "DRAFT|ACTIVE (default DRAFT) \u2014 LinkedIn refuses a new group created PAUSED",
+      required: false
+    },
     file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
   }
 });
@@ -20859,7 +20914,16 @@ registerSchema({
     ctv: { type: "string", description: "Connected TV on|off (default off)", required: false },
     "creative-selection": { type: "string", description: "OPTIMIZED|ROUND_ROBIN", required: false },
     "associated-entity": { type: "string", description: "Organization URN", required: false },
-    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
+    "political-intent": {
+      type: "string",
+      description: "NOT_DECLARED (default)|NOT_POLITICAL|POLITICAL \u2014 the advertiser's declaration; NOT_POLITICAL only after the user confirms their ads are not political advertising",
+      required: false
+    },
+    status: {
+      type: "string",
+      description: "DRAFT|ACTIVE|PAUSED (default DRAFT) \u2014 PAUSED needs a group that is not DRAFT",
+      required: false
+    },
     file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
   }
 });
@@ -20887,6 +20951,11 @@ registerSchema({
     lan: { type: "string", description: "on|off", required: false },
     ctv: { type: "string", description: "on|off", required: false },
     "creative-selection": { type: "string", description: "OPTIMIZED|ROUND_ROBIN", required: false },
+    "political-intent": {
+      type: "string",
+      description: "NOT_DECLARED (default)|NOT_POLITICAL|POLITICAL \u2014 the advertiser's declaration; NOT_POLITICAL only after the user confirms their ads are not political advertising",
+      required: false
+    },
     status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED", required: false },
     file: { type: "string", description: "JSON file with fields to change", required: false }
   }
@@ -21282,7 +21351,8 @@ var campaignGroupsCreateCommand = defineCommand33({
   meta: {
     name: "create",
     description: `Stage a new campaign group. ${STAGED_NOTE}
-Example: baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-07-10 --total-budget 5000 --currency EUR`
+A group can't be created PAUSED, and a --total-budget needs an --end.
+Example: baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-07-10 --end 2026-09-30 --total-budget 5000 --currency EUR`
   },
   args: {
     ...accountArgs,
@@ -21291,7 +21361,10 @@ Example: baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-
     end: { type: "string", description: "Run schedule end" },
     "total-budget": { type: "string", description: TOTAL_BUDGET_HELP },
     currency: { type: "string", description: "3-letter currency code (defaults to the ad account currency)" },
-    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)" },
+    status: {
+      type: "string",
+      description: "DRAFT|ACTIVE (default DRAFT) \u2014 LinkedIn refuses a new group created PAUSED; pause it once it exists"
+    },
     file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
   },
   run: async ({ args: args5 }) => {
@@ -21357,9 +21430,11 @@ function campaignPayloadFromFlags(args5) {
     connectedTelevisionOnly: parseOnOffFlag(args5.ctv, "--ctv"),
     creativeSelection: args5["creative-selection"] ? String(args5["creative-selection"]).toUpperCase() : void 0,
     associatedEntity: args5["associated-entity"],
+    politicalIntent: args5["political-intent"] ? String(args5["political-intent"]).toUpperCase() : void 0,
     status: args5.status ? String(args5.status).toUpperCase() : void 0
   };
 }
+var POLITICAL_INTENT_HELP = `NOT_DECLARED (default)|NOT_POLITICAL|POLITICAL \u2014 the advertiser's own declaration. Pass NOT_POLITICAL only after the user confirms: "I confirm this is not political advertising. None of my ads qualify as political advertising under the law of the targeted countries, including EU law for ads targeted to the EU."`;
 var campaignFlagArgs = {
   ...accountArgs,
   name: { type: "string", description: "Campaign name (\u2264255 chars)" },
@@ -21380,7 +21455,8 @@ var campaignFlagArgs = {
   ctv: { type: "string", description: "Connected TV on|off" },
   "creative-selection": { type: "string", description: "OPTIMIZED|ROUND_ROBIN" },
   "associated-entity": { type: "string", description: "Organization URN" },
-  status: { type: "string", description: "DRAFT|ACTIVE|PAUSED" },
+  "political-intent": { type: "string", description: POLITICAL_INTENT_HELP },
+  status: { type: "string", description: "DRAFT|ACTIVE|PAUSED \u2014 PAUSED needs a group that is not DRAFT" },
   file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
 };
 var campaignsCreateCommand = defineCommand33({
@@ -22897,7 +22973,7 @@ var listArgs = {
   "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
   "account-urn": { type: "string", description: "Alias for --account-id" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
-  statuses: { type: "string", description: "CSV of statuses (ACTIVE,PAUSED,ARCHIVED,COMPLETED,DRAFT)" },
+  statuses: { type: "string", description: statusesArgDescription("campaignGroups") },
   limit: { type: "string", description: "Max rows (default: 500)" },
   "no-cache": NO_CACHE_ARG,
   output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
@@ -22912,7 +22988,7 @@ var campaignGroupsListCommand = defineCommand40({
     const accountId = resolveAccountIdArg2(args5);
     try {
       const params = { "account-id": accountId };
-      const statuses = resolveStatusFilter(args5);
+      const statuses = resolveStatusFilter(args5, "campaignGroups");
       if (statuses) params.statuses = statuses.join(",");
       if (args5.limit) params.limit = String(args5.limit);
       if (args5["no-cache"]) params["skip-cache"] = "true";
@@ -22963,7 +23039,7 @@ var listArgs2 = {
   "account-urn": { type: "string", description: "Alias for --account-id" },
   "campaign-group-id": { type: "string", description: "Filter by campaign group" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
-  statuses: { type: "string", description: "CSV of statuses" },
+  statuses: { type: "string", description: statusesArgDescription("campaigns") },
   limit: { type: "string", description: "Max rows (default: 500)" },
   "no-cache": NO_CACHE_ARG,
   output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
@@ -22978,7 +23054,7 @@ var campaignsListCommand = defineCommand41({
     const accountId = resolveAccountIdArg2(args5);
     try {
       const params = { "account-id": accountId };
-      const statuses = resolveStatusFilter(args5);
+      const statuses = resolveStatusFilter(args5, "campaigns");
       if (statuses) params.statuses = statuses.join(",");
       if (args5["campaign-group-id"]) params["campaign-group-id"] = String(args5["campaign-group-id"]);
       if (args5.limit) params.limit = String(args5.limit);
@@ -23328,7 +23404,7 @@ var listArgs3 = {
   "account-urn": { type: "string", description: "Alias for --account-id" },
   "campaign-id": { type: "string", description: "Filter by campaign ID" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
-  statuses: { type: "string", description: "CSV of intended statuses (ACTIVE,PAUSED,DRAFT,ARCHIVED)" },
+  statuses: { type: "string", description: statusesArgDescription("creatives") },
   fields: {
     type: "string",
     description: "CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage"
@@ -23348,7 +23424,7 @@ var creativesListCommand = defineCommand44({
     const accountId = resolveAccountIdArg2(args5);
     try {
       const params = { "account-id": accountId };
-      const statuses = resolveStatusFilter(args5);
+      const statuses = resolveStatusFilter(args5, "creatives");
       if (statuses) params.statuses = statuses.join(",");
       if (args5["campaign-id"]) params["campaign-id"] = String(args5["campaign-id"]);
       if (args5.limit) params.limit = String(args5.limit);