@koda-sl/baker-cli 0.435.0 → 0.437.0

package/README.md

@@ -1183,7 +1183,8 @@ baker ads linkedin bid-pricing --account-id 503001492 \
 **`analytics`** — the 3-axis workhorse:
 - `--level account` (override: `campaign-group|campaign|creative`)
 - `--intent baseline` field bundle. Intents: `baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity`. List with `--list-intents`.
-- `--pivot none`. Pivots: `none | campaign | campaign-group | creative | company | account | conversion | job-title | job-function | seniority | industry | company-size | country | region | device | placement | serving-location | card-index | objective | conversation-node | conversation-node-button`. List with `--list-pivots`.
+- `--pivot none`. Pivots: `none | campaign | campaign-group | creative | company | account | conversion | job-title | job-function | seniority | industry | company-size | country | region | dma | device | placement | serving-location | card-index | objective | conversation-node | conversation-node-button`. List with `--list-pivots`.
+- `--pivot dma` — US Nielsen Designated Market Areas, with region names resolved. LinkedIn's terms: any report built from it writes "DMA®" each time and carries "DMA® is a registered service mark of The Nielsen Company." — the `DMA_ATTRIBUTION_REQUIRED` warning repeats this on every call.
 - `--granularity DAILY`. Auto-forced to `ALL` when pivoting on a `MEMBER_*` dim (LinkedIn rejects DAILY + demographic) — surfaced in stderr + `warnings`.
 - `--last-days 7` unless you pass `--start`/`--end`.
 - Sort: `costInUsd` descending. `--no-sort` to disable.
@@ -1289,6 +1290,8 @@ baker ads linkedin campaigns exclude-companies 123456 --segment urn:li:dmpSegmen
 # Conversions with playbook-default windows
 baker ads linkedin conversions create --name "Demo booked" --type LEAD --method INSIGHT_TAG \
   --post-click-window 30 --view-window 7
+# Windows are 1|7|30|90 days; 180 and 365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD,
+# SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION — refused at stage time otherwise
 
 # Safe duplication — stage-time read of the source → staged DRAFT create ("Duplicate ad", never "Link to original")
 baker ads linkedin campaigns duplicate 123456 --name "New variant"

package/dist/cli.js

@@ -23717,6 +23717,100 @@ var adContentSchema = z5.object({
   offer: adContentOfferSchema
 });
 var adContentResponseSchema = z5.object({ ad: adContentSchema });
+var adDnaColorSchema = z5.object({
+  hex: z5.string(),
+  share: z5.number().nullable()
+});
+var adDnaSceneSchema = z5.object({
+  start_s: z5.number(),
+  end_s: z5.number(),
+  role: z5.string().nullable(),
+  visual: z5.string(),
+  speech: z5.string().nullable(),
+  on_screen_text: z5.string().nullable(),
+  sound: z5.string().nullable()
+});
+var adDnaMomentSchema = z5.object({
+  kind: z5.enum(["hook_ends", "product", "price", "cta", "logo"]),
+  at_s: z5.number()
+});
+var adDnaStorySchema = z5.object({
+  duration_s: z5.number().nullable(),
+  summary: z5.string().nullable(),
+  hook: z5.string().nullable(),
+  scenes: z5.array(adDnaSceneSchema),
+  moments: z5.array(adDnaMomentSchema)
+});
+var adDnaCardSchema = z5.object({
+  index: z5.number(),
+  role: z5.string().nullable(),
+  layout: z5.string().nullable(),
+  colors: z5.array(adDnaColorSchema),
+  open_loop: z5.string().nullable(),
+  transition: z5.string().nullable()
+});
+var adDnaAgeReachSchema = z5.object({
+  age_range: z5.string(),
+  female: z5.number(),
+  male: z5.number(),
+  unknown: z5.number()
+});
+var adDnaReachSchema = z5.object({
+  total: z5.number().nullable(),
+  eu_total: z5.number().nullable(),
+  ages: z5.object({ min: z5.number(), max: z5.number() }).nullable(),
+  gender: z5.string().nullable(),
+  locations: z5.array(z5.string()),
+  excluded_locations: z5.array(z5.string()),
+  channels: z5.array(z5.string()),
+  by_age: z5.array(adDnaAgeReachSchema)
+});
+var adDnaTraitSchema = z5.object({
+  key: z5.string(),
+  value: z5.union([z5.string(), z5.number(), z5.boolean(), z5.array(z5.string())])
+});
+var adDnaTraitGroupKeySchema = z5.enum([
+  "audience",
+  "business",
+  "message",
+  "copy",
+  "look",
+  "cast",
+  "pacing",
+  "sound",
+  "on_screen_text",
+  "branding",
+  "subject",
+  "cta_visual",
+  "markers",
+  "carousel",
+  "offer",
+  "delivery"
+]);
+var adDnaTraitGroupSchema = z5.object({
+  key: adDnaTraitGroupKeySchema,
+  traits: z5.array(adDnaTraitSchema)
+});
+var adDnaDetailSchema = z5.object({
+  palette: z5.array(adDnaColorSchema),
+  background_hex: z5.string().nullable(),
+  button_hex: z5.string().nullable(),
+  story: adDnaStorySchema.nullable(),
+  cards: z5.array(adDnaCardSchema),
+  reach: adDnaReachSchema.nullable(),
+  groups: z5.array(adDnaTraitGroupSchema),
+  extracted_at: z5.string().nullable()
+});
+var adCardMediaSchema = z5.object({
+  index: z5.number(),
+  url: z5.string(),
+  kind: z5.enum(["image", "video"]).nullable()
+});
+var adDetailSchema = z5.object({
+  content: adContentSchema,
+  dna: adDnaDetailSchema,
+  card_media: z5.array(adCardMediaSchema)
+});
 
 // ../api/src/ads-linkedin/companies.ts
 import { z as z6 } from "zod";
@@ -23868,11 +23962,11 @@ var LINKEDIN_LIMITS = {
   },
   conversion: {
     nameMax: 255,
-    // 365 is accepted only for the types in
-    // `CONVERSION_TYPES_ALLOWING_365_DAY_WINDOW`; enforced cross-field in
+    // 180 and 365 are accepted only for the types in
+    // `CONVERSION_TYPES_ALLOWING_LONG_WINDOWS`; enforced cross-field in
     // `conversionCreateSchema`, since the enum alone cannot express it.
-    postClickWindows: [1, 7, 30, 90, 365],
-    viewThroughWindows: [1, 7, 30, 90, 365]
+    postClickWindows: [1, 7, 30, 90, 180, 365],
+    viewThroughWindows: [1, 7, 30, 90, 180, 365]
   },
   leadForm: {
     nameMax: 256,
@@ -24006,12 +24100,14 @@ var CONVERSION_TYPES = [
   "VIEW_CONTENT",
   "VIEW_VIDEO"
 ];
-var CONVERSION_TYPES_ALLOWING_365_DAY_WINDOW = [
+var CONVERSION_TYPES_ALLOWING_LONG_WINDOWS = [
   "SUBMIT_APPLICATION",
   "PURCHASE",
   "ADD_TO_CART",
   "QUALIFIED_LEAD",
-  "LEAD"
+  "LEAD",
+  "MARKETING_QUALIFIED_LEAD",
+  "SALES_QUALIFIED_LEAD"
 ];
 var CONVERSION_METHODS = ["INSIGHT_TAG", "CONVERSIONS_API"];
 var ATTRIBUTION_TYPES = ["LAST_TOUCH_BY_CAMPAIGN", "LAST_TOUCH_BY_CONVERSION"];
@@ -24610,13 +24706,14 @@ var conversionCreateSchema = z7.object({
   urlMatchRuleExpression: z7.array(z7.array(z7.record(z7.string(), z7.string()))).optional(),
   associateAllCampaigns: z7.boolean().optional()
 }).superRefine((p, ctx) => {
-  const allowed365 = CONVERSION_TYPES_ALLOWING_365_DAY_WINDOW.includes(p.type);
+  const allowsLong = CONVERSION_TYPES_ALLOWING_LONG_WINDOWS.includes(p.type);
   for (const field of ["postClickAttributionWindowSize", "viewThroughAttributionWindowSize"]) {
-    if (p[field] === 365 && !allowed365) {
+    const days = p[field];
+    if (days !== void 0 && days > 90 && !allowsLong) {
       ctx.addIssue({
         code: "custom",
         path: [field],
-        message: `a 365-day window is only available for ${CONVERSION_TYPES_ALLOWING_365_DAY_WINDOW.join(", ")} \u2014 ${p.type} caps at 90`
+        message: `a ${days}-day window is only available for ${CONVERSION_TYPES_ALLOWING_LONG_WINDOWS.join(", ")} \u2014 ${p.type} caps at 90`
       });
     }
   }
@@ -51212,6 +51309,7 @@ registerSchema({
         "company-size",
         "country",
         "region",
+        "dma",
         "device",
         "placement",
         "serving-location",
@@ -51853,8 +51951,16 @@ registerSchema({
       required: true
     },
     method: { type: "string", description: "INSIGHT_TAG|CONVERSIONS_API", required: true },
-    "post-click-window": { type: "string", description: "1|7|30|90 days", required: false },
-    "view-window": { type: "string", description: "1|7|30 days", required: false },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
     "attribution-type": {
       type: "string",
       description: "LAST_TOUCH_BY_CAMPAIGN|LAST_TOUCH_BY_CONVERSION",
@@ -51875,8 +51981,16 @@ registerSchema({
     id: { type: "positional", description: "Conversion rule id or URN", required: true },
     ...writeAccountArgs,
     name: { type: "string", description: "New name", required: false },
-    "post-click-window": { type: "string", description: "1|7|30|90 days", required: false },
-    "view-window": { type: "string", description: "1|7|30 days", required: false },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION",
+      required: false
+    },
     "attribution-type": { type: "string", description: "New attribution type", required: false },
     enabled: { type: "string", description: "on|off", required: false },
     file: { type: "string", description: "JSON file with fields to change", required: false }
@@ -52721,8 +52835,14 @@ Example: baker ads linkedin conversions create --name "Demo booked" --type LEAD
       description: "Conversion type. Common: LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, SIGN_UP, DOWNLOAD, PURCHASE, KEY_PAGE_VIEW, ADD_TO_CART, BOOK_APPOINTMENT, SUBMIT_APPLICATION, OTHER \u2014 `baker schema ads.linkedin.conversions.create` lists all 34"
     },
     method: { type: "string", description: "INSIGHT_TAG|CONVERSIONS_API" },
-    "post-click-window": { type: "string", description: "1|7|30|90 days (playbook default 30)" },
-    "view-window": { type: "string", description: "1|7|30 days (playbook default 7)" },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days (playbook default 30); 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION"
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days (playbook default 7); 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION"
+    },
     "attribution-type": { type: "string", description: "LAST_TOUCH_BY_CAMPAIGN|LAST_TOUCH_BY_CONVERSION" },
     "associate-all-campaigns": { type: "boolean", description: "Auto-associate with active campaigns" },
     file: { type: "string", description: "JSON file with the full payload (e.g. urlMatchRuleExpression)" }
@@ -52751,8 +52871,14 @@ Example: baker ads linkedin conversions update 104988516 --post-click-window 30
     id: { type: "positional", description: "Conversion rule id or URN", required: true },
     ...accountArgs,
     name: { type: "string", description: "New name" },
-    "post-click-window": { type: "string", description: "1|7|30|90 days" },
-    "view-window": { type: "string", description: "1|7|30 days" },
+    "post-click-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION"
+    },
+    "view-window": {
+      type: "string",
+      description: "1|7|30|90 days; 180|365 only for LEAD, QUALIFIED_LEAD, MARKETING_QUALIFIED_LEAD, SALES_QUALIFIED_LEAD, PURCHASE, ADD_TO_CART, SUBMIT_APPLICATION"
+    },
     "attribution-type": { type: "string", description: "LAST_TOUCH_BY_CAMPAIGN|LAST_TOUCH_BY_CONVERSION" },
     enabled: { type: "string", description: "on|off" },
     file: { type: "string", description: "JSON file with fields to change" }
@@ -53098,7 +53224,8 @@ var MEMBER_PIVOTS = /* @__PURE__ */ new Set([
   "industry",
   "company-size",
   "country",
-  "region"
+  "region",
+  "dma"
 ]);
 var ALL_PIVOTS = [
   "none",
@@ -53115,6 +53242,7 @@ var ALL_PIVOTS = [
   "company-size",
   "country",
   "region",
+  "dma",
   "device",
   "placement",
   "serving-location",
@@ -53252,7 +53380,7 @@ var analyticsCommand = defineCommand62({
 Three-axis design (LinkedIn's superpower over Meta/Google):
   --level   account | campaign-group | campaign | creative
   --intent  baseline | revenue | funnel | engagement | video | lead-gen | inmail | document | ranking | identity
-  --pivot   none | job-title | company | industry | seniority | function | company-size | country | region
+  --pivot   none | job-title | company | industry | seniority | function | company-size | country | region | dma
             | device | placement | serving-location | card-index | objective
             | conversation-node | conversation-node-button
 
@@ -53260,6 +53388,8 @@ Smart defaults:
   --level account, --intent baseline, --pivot none, --granularity DAILY, last 7 days
   Pivot on a MEMBER_* dim \u2192 granularity auto-forced to ALL (LinkedIn rejects DAILY+demographic)
   Demographic data delayed 12-24h with \u22653-event privacy floor \u2014 the CLI flags this in warnings.
+  --pivot dma \u2192 US Nielsen DMA\xAE regions, names resolved. Any report built from it must write "DMA\xAE"
+  and carry Nielsen's notice (returned as the DMA_ATTRIBUTION_REQUIRED warning).
   Derived metrics injected client-side: ctr, cpc, cpm, frequency, leadCompletionRate
 
 Examples \u2014 common AI questions: