@omni-commerce/cli 0.10.0 → 0.11.0

package/dist/index.js

@@ -50,7 +50,7 @@ function parseArgv(argv) {
         continue;
       }
       const next = argv[index + 1];
-      if (!next || next.startsWith("-") && next !== "-" || GLOBAL_TRUE_FLAGS.has(stripped)) {
+      if (next === void 0 || next.startsWith("-") && next !== "-" || GLOBAL_TRUE_FLAGS.has(stripped)) {
         flags[stripped] = true;
         continue;
       }
@@ -78,13 +78,13 @@ import { execFile } from "child_process";
 import { promisify } from "util";
 var executeFile = promisify(execFile);
 async function openBrowser(url) {
-  const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "rundll32.exe" : "xdg-open";
+  const command2 = process.platform === "darwin" ? "open" : process.platform === "win32" ? "rundll32.exe" : "xdg-open";
   const args = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url] : [url];
-  await executeFile(command, args, { timeout: 1e4 });
+  await executeFile(command2, args, { timeout: 1e4 });
 }
 
 // src/version.ts
-var CLI_VERSION = "0.10.0";
+var CLI_VERSION = "0.11.0";
 
 // src/browser-login.ts
 function loginOrigin(baseUrl) {
@@ -261,14 +261,14 @@ var UPLOAD_CONTENT_TYPES = {
   ".heic": "image/heic",
   ".heif": "image/heif"
 };
-async function uploadBody(filePath, fields) {
+async function uploadBody(filePath, fields2) {
   const form = new FormData();
   const type = UPLOAD_CONTENT_TYPES[extname(filePath).toLowerCase()] ?? "application/octet-stream";
   form.append(
     "file",
     new File([await readFile2(filePath)], basename(filePath), { type })
   );
-  for (const [key, value] of Object.entries(fields)) {
+  for (const [key, value] of Object.entries(fields2)) {
     if (value === void 0 || value === null) continue;
     form.append(
       key,
@@ -283,8 +283,8 @@ function stringValue(value, flag) {
   }
   return value;
 }
-async function executeCommand(client, command, request) {
-  if (command.resourcePath[0] === "jobs" && command.methodName === "wait") {
+async function executeCommand(client, command2, request) {
+  if (command2.resourcePath[0] === "jobs" && command2.methodName === "wait") {
     const jobId = stringValue(request.jobId, "job-id");
     const organizationId = typeof request.organizationId === "string" ? request.organizationId : void 0;
     return client.jobs.wait({ jobId, organizationId });
@@ -292,7 +292,8 @@ async function executeCommand(client, command, request) {
   const pathValues = {};
   const query = {};
   const consumed = /* @__PURE__ */ new Set();
-  for (const flag of command.flags) {
+  for (const flag of command2.flags) {
+    if (flag.source === "body") continue;
     const value = request[flag.name];
     if (value === void 0) continue;
     consumed.add(flag.name);
@@ -306,20 +307,20 @@ async function executeCommand(client, command, request) {
   for (const [key, value] of Object.entries(request)) {
     if (!consumed.has(key)) body[key] = value;
   }
-  if (command.acceptsFile) {
-    const { file, ...fields } = body;
+  if (command2.acceptsFile) {
+    const { file, ...fields2 } = body;
     return client.request({
-      method: command.httpMethod,
-      path: interpolatePath(command.path, pathValues),
+      method: command2.httpMethod,
+      path: interpolatePath(command2.path, pathValues),
       query: Object.keys(query).length > 0 ? query : void 0,
-      body: await uploadBody(stringValue(file, "file"), fields)
+      body: await uploadBody(stringValue(file, "file"), fields2)
     });
   }
   return client.request({
-    method: command.httpMethod,
-    path: interpolatePath(command.path, pathValues),
+    method: command2.httpMethod,
+    path: interpolatePath(command2.path, pathValues),
     query: Object.keys(query).length > 0 ? query : void 0,
-    body: command.acceptsJsonBody && Object.keys(body).length > 0 ? body : void 0
+    body: command2.acceptsJsonBody && Object.keys(body).length > 0 ? body : void 0
   });
 }
 
@@ -1408,6 +1409,18 @@ var COMMANDS = [
         required: false,
         source: "query"
       },
+      {
+        name: "marketplace",
+        flag: "marketplace",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "store",
+        flag: "store",
+        required: false,
+        source: "query"
+      },
       {
         name: "stage",
         flag: "stage",
@@ -1480,6 +1493,25 @@ var COMMANDS = [
     acceptsFile: false,
     bodyRequired: false
   },
+  {
+    trail: ["campaigns", "update"],
+    resourcePath: ["campaigns"],
+    methodName: "update",
+    httpMethod: "PATCH",
+    path: "/api/v1/campaigns/{campaignId}",
+    summary: "Change Campaign Details",
+    flags: [
+      {
+        name: "campaignId",
+        flag: "campaign-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
   {
     trail: ["campaigns", "replace"],
     resourcePath: ["campaigns"],
@@ -1518,6 +1550,148 @@ var COMMANDS = [
     acceptsFile: false,
     bodyRequired: true
   },
+  {
+    trail: ["campaigns", "get-analytics"],
+    resourcePath: ["campaigns"],
+    methodName: "getAnalytics",
+    httpMethod: "GET",
+    path: "/api/v1/campaigns/{campaignId}/analytics",
+    summary: "Get Campaign Analytics",
+    flags: [
+      {
+        name: "campaignId",
+        flag: "campaign-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "analyticsWindow",
+        flag: "analytics-window",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    acceptsFile: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["campaigns", "get-notifications"],
+    resourcePath: ["campaigns"],
+    methodName: "getNotifications",
+    httpMethod: "GET",
+    path: "/api/v1/campaigns/{campaignId}/notifications",
+    summary: "Get Campaign Notifications",
+    flags: [
+      {
+        name: "campaignId",
+        flag: "campaign-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    acceptsFile: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["campaigns", "set-notifications"],
+    resourcePath: ["campaigns"],
+    methodName: "setNotifications",
+    httpMethod: "PUT",
+    path: "/api/v1/campaigns/{campaignId}/notifications",
+    summary: "Set Campaign Notifications",
+    flags: [
+      {
+        name: "campaignId",
+        flag: "campaign-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
+  {
+    trail: ["campaigns", "list-offers"],
+    resourcePath: ["campaigns"],
+    methodName: "listOffers",
+    httpMethod: "GET",
+    path: "/api/v1/campaigns/{campaignId}/offers",
+    summary: "List Campaign Offers",
+    flags: [
+      {
+        name: "campaignId",
+        flag: "campaign-id",
+        required: true,
+        source: "path"
+      },
+      {
+        name: "kind",
+        flag: "kind",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "window",
+        flag: "window",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "review",
+        flag: "review",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "offset",
+        flag: "offset",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "limit",
+        flag: "limit",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    acceptsFile: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["campaigns", "act-batch"],
+    resourcePath: ["campaigns"],
+    methodName: "actBatch",
+    httpMethod: "POST",
+    path: "/api/v1/campaigns/actions",
+    summary: "Act on Campaigns",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
   {
     trail: ["campaigns", "archive"],
     resourcePath: ["campaigns"],
@@ -1542,6 +1716,18 @@ var COMMANDS = [
     acceptsFile: false,
     bodyRequired: true
   },
+  {
+    trail: ["campaigns", "import-briefs"],
+    resourcePath: ["campaigns"],
+    methodName: "importBriefs",
+    httpMethod: "POST",
+    path: "/api/v1/campaigns/import",
+    summary: "Import Campaign Workbooks",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
   {
     trail: ["campaigns", "get-options"],
     resourcePath: ["campaigns"],
@@ -1561,6 +1747,30 @@ var COMMANDS = [
     acceptsFile: false,
     bodyRequired: false
   },
+  {
+    trail: ["campaigns", "resolve-promotion-options"],
+    resourcePath: ["campaigns"],
+    methodName: "resolvePromotionOptions",
+    httpMethod: "POST",
+    path: "/api/v1/campaigns/promotion-options",
+    summary: "Resolve Campaign Promotion Selection",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
+  {
+    trail: ["campaigns", "validate"],
+    resourcePath: ["campaigns"],
+    methodName: "validate",
+    httpMethod: "POST",
+    path: "/api/v1/campaigns/validate",
+    summary: "Validate Campaigns",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
   {
     trail: ["catalog", "list-items"],
     resourcePath: ["catalog"],
@@ -2942,6 +3152,12 @@ var COMMANDS = [
         flag: "include-summary",
         required: false,
         source: "query"
+      },
+      {
+        name: "detail",
+        flag: "detail",
+        required: false,
+        source: "query"
       }
     ],
     acceptsJsonBody: false,
@@ -3407,6 +3623,12 @@ var COMMANDS = [
         required: false,
         source: "query"
       },
+      {
+        name: "campaign",
+        flag: "campaign",
+        required: false,
+        source: "query"
+      },
       {
         name: "q",
         flag: "q",
@@ -3547,6 +3769,25 @@ var COMMANDS = [
     acceptsFile: false,
     bodyRequired: true
   },
+  {
+    trail: ["promotions", "preview"],
+    resourcePath: ["promotions"],
+    methodName: "preview",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/{promotionId}/preview",
+    summary: "Preview Promotion Prices",
+    flags: [
+      {
+        name: "promotionId",
+        flag: "promotion-id",
+        required: true,
+        source: "path"
+      }
+    ],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
   {
     trail: ["promotions", "remove-products"],
     resourcePath: ["promotions"],
@@ -3647,6 +3888,122 @@ var COMMANDS = [
     acceptsFile: false,
     bodyRequired: true
   },
+  {
+    trail: ["promotions", "create-batch"],
+    resourcePath: ["promotions"],
+    methodName: "createBatch",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/batch",
+    summary: "Create Promotions with Products",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "get-campaign-options"],
+    resourcePath: ["promotions"],
+    methodName: "getCampaignOptions",
+    httpMethod: "GET",
+    path: "/api/v1/promotions/campaign-options",
+    summary: "Find Promotion Campaigns",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      },
+      {
+        name: "q",
+        flag: "q",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    acceptsFile: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["promotions", "get-capabilities"],
+    resourcePath: ["promotions"],
+    methodName: "getCapabilities",
+    httpMethod: "GET",
+    path: "/api/v1/promotions/capabilities",
+    summary: "Get Promotion Marketplace Capabilities",
+    flags: [
+      {
+        name: "organizationId",
+        flag: "organization-id",
+        required: false,
+        source: "query"
+      }
+    ],
+    acceptsJsonBody: false,
+    acceptsFile: false,
+    bodyRequired: false
+  },
+  {
+    trail: ["promotions", "delete-batch"],
+    resourcePath: ["promotions"],
+    methodName: "deleteBatch",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/delete",
+    summary: "Delete Promotions",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "get-delivery"],
+    resourcePath: ["promotions"],
+    methodName: "getDelivery",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/delivery",
+    summary: "Read Promotion Delivery",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "get-product-options"],
+    resourcePath: ["promotions"],
+    methodName: "getProductOptions",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/product-options",
+    summary: "Find Eligible Promotion Products",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "set-statuses"],
+    resourcePath: ["promotions"],
+    methodName: "setStatuses",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/status",
+    summary: "Set Promotion Statuses",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
+  {
+    trail: ["promotions", "validate"],
+    resourcePath: ["promotions"],
+    methodName: "validate",
+    httpMethod: "POST",
+    path: "/api/v1/promotions/validate",
+    summary: "Validate Promotions",
+    flags: [],
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: true
+  },
   {
     trail: ["returns", "list"],
     resourcePath: ["returns"],
@@ -4880,10 +5237,1064 @@ var COMMANDS = [
   }
 ];
 
+// src/generated/campaign-inputs.ts
+var CAMPAIGN_INPUTS = {
+  patch: {
+    type: "object",
+    properties: {
+      expectedRevision: {
+        type: "integer",
+        exclusiveMinimum: 0,
+        maximum: 9007199254740991
+      },
+      name: {
+        type: "string",
+        minLength: 2,
+        maxLength: 160
+      },
+      objective: {
+        type: "string",
+        maxLength: 8e3
+      },
+      brand: {
+        type: "string",
+        maxLength: 160
+      },
+      ownerId: {
+        type: "string",
+        minLength: 1,
+        maxLength: 160,
+        description: "Organization member ID or eligible oauth:<clientId> actor from campaign options."
+      },
+      approverId: {
+        type: "string",
+        minLength: 1,
+        maxLength: 160,
+        description: "Explicit named approver: organization member ID or eligible oauth:<clientId> actor from campaign options. Other users and API clients cannot approve on this actor's behalf."
+      },
+      timezone: {
+        type: "string"
+      },
+      stores: {
+        maxItems: 100,
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            marketplace: {
+              type: "string",
+              enum: [
+                "shopee",
+                "lazada",
+                "tiktok",
+                "shopify",
+                "whatsapp",
+                "zalora",
+                "amazon",
+                "ebay"
+              ]
+            },
+            country: {
+              type: "string",
+              minLength: 1,
+              maxLength: 80
+            },
+            storeId: {
+              type: "string",
+              minLength: 1,
+              maxLength: 160
+            }
+          },
+          required: ["marketplace", "country", "storeId"],
+          additionalProperties: false
+        }
+      },
+      serviceRequest: {
+        type: "string",
+        maxLength: 300
+      },
+      priority: {
+        type: "string",
+        enum: ["standard", "priority", "super_priority"]
+      },
+      documentIds: {
+        maxItems: 100,
+        type: "array",
+        items: {
+          type: "string",
+          minLength: 1,
+          maxLength: 160
+        }
+      },
+      reviewDueAt: {
+        anyOf: [
+          {
+            type: "string",
+            format: "date-time",
+            pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+          },
+          {
+            type: "null"
+          }
+        ]
+      },
+      sourceCurrency: {
+        type: "string",
+        pattern: "^[A-Z]{3}$"
+      },
+      sourceMarketplace: {
+        type: "string",
+        enum: [
+          "shopee",
+          "lazada",
+          "tiktok",
+          "shopify",
+          "whatsapp",
+          "zalora",
+          "amazon",
+          "ebay"
+        ]
+      },
+      sourceCountry: {
+        type: "string",
+        maxLength: 80
+      },
+      syncMode: {
+        type: "string",
+        enum: ["offer_windows", "campaign_start"]
+      },
+      cleanupNotes: {
+        type: "string",
+        maxLength: 8e3
+      },
+      offers: {
+        description: "Add or update promotions by stable offer id. Existing IDs patch only supplied fields; new IDs require windowId and promotion terms. Omitted offers stay unchanged.",
+        maxItems: 500,
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              minLength: 1,
+              maxLength: 160
+            },
+            windowId: {
+              type: "string",
+              minLength: 1,
+              maxLength: 160
+            },
+            promotionId: {
+              description: "Existing draft promotion attached to this window; the campaign controls its live dates.",
+              type: "string",
+              format: "uuid",
+              pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            },
+            productIds: {
+              maxItems: 200,
+              type: "array",
+              items: {
+                type: "string",
+                format: "uuid",
+                pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+              }
+            },
+            reviewNotes: {
+              type: "string",
+              maxLength: 8e3
+            },
+            excludedReason: {
+              type: "string",
+              maxLength: 2e3
+            },
+            name: {
+              type: "string",
+              minLength: 1,
+              maxLength: 200
+            },
+            description: {
+              anyOf: [
+                {
+                  type: "string",
+                  maxLength: 2e3
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            kind: {
+              description: "Canonical OmniCommerce promotion mechanic: product discount, flash sale, voucher, gift with purchase, Buy-X-Get-Y, bundle deal, or Lazada-only free shipping and early bird price.",
+              type: "string",
+              enum: [
+                "product_discount",
+                "flash_sale",
+                "voucher",
+                "gift_with_purchase",
+                "buy_x_get_y",
+                "bundle_deal",
+                "free_shipping",
+                "early_bird_price"
+              ]
+            },
+            salesChannels: {
+              minItems: 1,
+              type: "array",
+              items: {
+                type: "string",
+                enum: ["pdp", "live"]
+              }
+            },
+            discountType: {
+              type: "string",
+              enum: ["percentage", "fixed_amount"]
+            },
+            discountValue: {
+              type: "number",
+              minimum: 0
+            },
+            storeDiscounts: {
+              description: "Patch discount terms for exact target store keys; unnamed stores remain unchanged. Null discountValue restores shared campaign terms for that store.",
+              maxItems: 100,
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  storeKey: {
+                    type: "string",
+                    minLength: 1,
+                    maxLength: 255
+                  },
+                  discountType: {
+                    type: "string",
+                    enum: ["percentage", "fixed_amount"]
+                  },
+                  discountValue: {
+                    anyOf: [
+                      {
+                        type: "number",
+                        minimum: 0
+                      },
+                      {
+                        type: "null"
+                      }
+                    ]
+                  }
+                },
+                required: ["storeKey", "discountType", "discountValue"],
+                additionalProperties: false
+              }
+            },
+            targetStores: {
+              description: "Up to 100 connected stores for create (required) or update. Copy marketplace, country, and storeId from get_promotions targetStores or find_products marketplaceDetails. Do not concatenate a storeKeys string.",
+              minItems: 1,
+              maxItems: 100,
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  marketplace: {
+                    type: "string",
+                    enum: [
+                      "lazada",
+                      "shopee",
+                      "tiktok",
+                      "shopify",
+                      "amazon",
+                      "zalora",
+                      "ebay"
+                    ]
+                  },
+                  country: {
+                    type: "string",
+                    minLength: 1,
+                    maxLength: 80
+                  },
+                  storeId: {
+                    type: "string",
+                    minLength: 1,
+                    maxLength: 120
+                  }
+                },
+                required: ["marketplace", "country", "storeId"],
+                additionalProperties: false
+              }
+            },
+            minSalePrice: {
+              anyOf: [
+                {
+                  type: "number",
+                  minimum: 0
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            maxDiscountAmount: {
+              anyOf: [
+                {
+                  type: "number",
+                  minimum: 0
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            minSpend: {
+              anyOf: [
+                {
+                  type: "number",
+                  minimum: 0
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            voucherCode: {
+              anyOf: [
+                {
+                  type: "string",
+                  minLength: 1,
+                  maxLength: 100
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            claimStartsAt: {
+              anyOf: [
+                {
+                  type: "string",
+                  format: "date-time",
+                  pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            totalUsageLimit: {
+              anyOf: [
+                {
+                  type: "integer",
+                  exclusiveMinimum: 0,
+                  maximum: 9007199254740991
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            perBuyerLimit: {
+              anyOf: [
+                {
+                  type: "integer",
+                  exclusiveMinimum: 0,
+                  maximum: 9007199254740991
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            voucherType: {
+              description: "Voucher subtype from get_promotions capabilities.voucherTypes. Browser AOP types (delivery=browser_aop) are writable Seller Center vouchers. Omit browserAutomation.aopId to use the built-in marketplace AOP.",
+              anyOf: [
+                {
+                  type: "string",
+                  enum: [
+                    "shopee_shop",
+                    "shopee_product",
+                    "shopee_private",
+                    "shopee_live",
+                    "shopee_video",
+                    "shopee_new_buyer",
+                    "shopee_repeat_buyer",
+                    "shopee_campaign",
+                    "shopee_follow_prize",
+                    "shopee_exclusive_streamer",
+                    "shopee_welcome",
+                    "shopee_member_repeat_buyer",
+                    "shopee_exclusive",
+                    "shopee_redemption",
+                    "shopee_exclusive_creator",
+                    "lazada_store_follower",
+                    "lazada_regular",
+                    "lazada_store_new_buyer",
+                    "lazada_live",
+                    "lazada_offline",
+                    "lazada_co_funded",
+                    "lazada_welcome",
+                    "lazada_linked_member",
+                    "lazada_new_member",
+                    "lazada_member_exclusive",
+                    "lazada_points_redeemable",
+                    "tiktok_seller_coupon",
+                    "shopify_discount_code",
+                    "amazon_promotion_code",
+                    "zalora_seller_voucher",
+                    "ebay_coded_coupon"
+                  ]
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            voucherCampaign: {
+              description: "Campaign voucher targeting: exact campaignId/sessionId from Seller Center and termsAccepted only after the seller reviewed participation obligations. Required for shopee_campaign; nomination creates a draft awaiting marketplace review.",
+              type: "object",
+              properties: {
+                campaignId: {
+                  type: "string",
+                  pattern: "^[1-9]\\d{0,39}$"
+                },
+                sessionId: {
+                  type: "string",
+                  pattern: "^[1-9]\\d{0,39}$"
+                },
+                termsAccepted: {
+                  type: "boolean"
+                }
+              },
+              required: ["campaignId", "sessionId", "termsAccepted"],
+              additionalProperties: false
+            },
+            browserAutomation: {
+              anyOf: [
+                {
+                  type: "object",
+                  properties: {
+                    aopId: {
+                      type: "string",
+                      minLength: 1,
+                      maxLength: 160
+                    },
+                    variableValues: {
+                      type: "object",
+                      propertyNames: {
+                        type: "string",
+                        minLength: 1,
+                        maxLength: 160
+                      },
+                      additionalProperties: {
+                        type: "string",
+                        maxLength: 8e3
+                      }
+                    },
+                    instructions: {
+                      type: "string",
+                      maxLength: 8e3
+                    }
+                  },
+                  additionalProperties: false
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            voucherScope: {
+              description: "shop = all products, products = selected assigned products. Repeat Buyer defaults to shop.",
+              type: "string",
+              enum: ["products", "shop"]
+            },
+            voucherReward: {
+              description: "Seller Center reward type. coins_cashback is a percentage greater than 3 and does not reduce salePrice.",
+              type: "string",
+              enum: ["discount", "coins_cashback"]
+            },
+            voucherAudience: {
+              type: "string",
+              enum: ["general", "shop_follow"]
+            },
+            repeatPurchaseMinCount: {
+              description: "Shopee Repeat Buyer: minimum completed shop orders, 1 or 2. Required for shopee_repeat_buyer.",
+              type: "integer",
+              minimum: 1,
+              maximum: 999
+            },
+            repeatPurchaseLookbackDays: {
+              description: "Shopee Repeat Buyer: lookback window in days, one of 30, 90, 180 or 365. Required for shopee_repeat_buyer.",
+              type: "integer",
+              minimum: 1,
+              maximum: 365
+            },
+            smartVoucher: {
+              description: "Shopee Smart Voucher toggle. Used by New Buyer and similar portal types.",
+              type: "boolean"
+            },
+            followPrizeExpiryDays: {
+              description: "Shopee Follow Prize: days after claim until expiry. Seller Center is 7.",
+              type: "integer",
+              minimum: 1,
+              maximum: 30
+            },
+            videoDisplayMode: {
+              description: "Shopee Video display: shopee_video = all Shopee Video; creator_video = targeted creator videos only.",
+              type: "string",
+              enum: ["shopee_video", "creator_video"]
+            },
+            exclusiveCreatorUsernames: {
+              description: "Exclusive Creator Voucher: up to 15 Shopee usernames.",
+              maxItems: 15,
+              type: "array",
+              items: {
+                type: "string",
+                minLength: 1,
+                maxLength: 64
+              }
+            },
+            exclusiveStreamerUsernames: {
+              description: "Exclusive Streamer Voucher: up to 15 Shopee usernames.",
+              maxItems: 15,
+              type: "array",
+              items: {
+                type: "string",
+                minLength: 1,
+                maxLength: 64
+              }
+            },
+            voucherDisplayChannels: {
+              description: 'Shopee display setting. ["all"] = display on all pages; [] = hidden/share by code.',
+              maxItems: 4,
+              type: "array",
+              items: {
+                type: "string",
+                enum: [
+                  "all",
+                  "feed",
+                  "live",
+                  "order_page",
+                  "followers",
+                  "offline"
+                ]
+              }
+            },
+            bundlePriceType: {
+              type: "string",
+              enum: ["discount", "fixed_price"]
+            },
+            bundleTiers: {
+              maxItems: 2,
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  minimumQuantity: {
+                    type: "integer",
+                    minimum: 2,
+                    maximum: 3e3
+                  },
+                  discountValue: {
+                    type: "number",
+                    exclusiveMinimum: 0
+                  }
+                },
+                required: ["minimumQuantity", "discountValue"]
+              }
+            },
+            thresholdType: {
+              type: "string",
+              enum: ["item_quantity", "order_amount"]
+            },
+            thresholdValue: {
+              type: "number",
+              exclusiveMinimum: 0
+            },
+            giftType: {
+              type: "string",
+              enum: ["gift", "sample"]
+            },
+            giftQuantity: {
+              type: "integer",
+              exclusiveMinimum: 0,
+              maximum: 999
+            },
+            gifts: {
+              minItems: 1,
+              maxItems: 20,
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  productId: {
+                    type: "string",
+                    format: "uuid",
+                    pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                  },
+                  variantId: {
+                    anyOf: [
+                      {
+                        type: "string",
+                        format: "uuid",
+                        pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                      },
+                      {
+                        type: "null"
+                      }
+                    ]
+                  },
+                  totalClaimLimit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 99999
+                  }
+                },
+                required: ["productId", "totalClaimLimit"],
+                additionalProperties: false
+              }
+            },
+            buyQuantity: {
+              type: "integer",
+              exclusiveMinimum: 0,
+              maximum: 999
+            },
+            getQuantity: {
+              type: "integer",
+              exclusiveMinimum: 0,
+              maximum: 999
+            },
+            benefitProductIds: {
+              minItems: 1,
+              maxItems: 200,
+              type: "array",
+              items: {
+                type: "string",
+                format: "uuid",
+                pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+              }
+            },
+            benefitType: {
+              type: "string",
+              enum: ["free", "percentage", "fixed_amount"]
+            },
+            benefitValue: {
+              type: "number",
+              minimum: 0
+            },
+            maxApplicationsPerOrder: {
+              type: "integer",
+              exclusiveMinimum: 0,
+              maximum: 999
+            },
+            bundleMinimumQuantity: {
+              type: "integer",
+              minimum: 2,
+              maximum: 3e3
+            },
+            shippingDeliveryOption: {
+              description: "Free shipping delivery option. Lazada: STANDARD (default), ECONOMY, EXPRESS, SELLER_OWN_FLEET or P2P, as offered by the store.",
+              type: "string",
+              pattern: "^[A-Z0-9_]{1,40}$"
+            },
+            shippingBudget: {
+              description: "Free shipping: total shipping subsidy budget in the store currency. Omit for an unlimited budget.",
+              type: "number",
+              exclusiveMinimum: 0
+            }
+          },
+          required: ["id"],
+          additionalProperties: false
+        }
+      },
+      windows: {
+        description: "Add or update windows by stable id. Existing IDs patch only supplied fields; new IDs require name, startsAt and endsAt. Omitted windows stay unchanged.",
+        maxItems: 100,
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              minLength: 1,
+              maxLength: 160
+            },
+            name: {
+              type: "string",
+              minLength: 1,
+              maxLength: 160
+            },
+            startsAt: {
+              anyOf: [
+                {
+                  type: "string",
+                  format: "date-time",
+                  pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            endsAt: {
+              anyOf: [
+                {
+                  type: "string",
+                  format: "date-time",
+                  pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            preparesAt: {
+              anyOf: [
+                {
+                  type: "string",
+                  format: "date-time",
+                  pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+                },
+                {
+                  type: "null"
+                }
+              ]
+            },
+            reviewNotes: {
+              type: "string",
+              maxLength: 8e3
+            }
+          },
+          required: ["id"],
+          additionalProperties: false
+        }
+      },
+      removeWindowIds: {
+        description: "Delete these windows. Move or remove their promotions in the same call. Maximum 100 IDs.",
+        maxItems: 100,
+        type: "array",
+        items: {
+          type: "string",
+          minLength: 1,
+          maxLength: 160
+        }
+      },
+      removeOfferIds: {
+        description: "Delete these draft promotion offers. Maximum 500 IDs.",
+        maxItems: 500,
+        type: "array",
+        items: {
+          type: "string",
+          minLength: 1,
+          maxLength: 160
+        }
+      },
+      organizationId: {
+        description: "Required for session auth. Optional for an API key, which already identifies the organization.",
+        type: "string",
+        minLength: 1,
+        maxLength: 120
+      },
+      expectedPendingVersion: {
+        anyOf: [
+          {
+            type: "integer",
+            exclusiveMinimum: 0,
+            maximum: 9007199254740991
+          },
+          {
+            type: "null"
+          }
+        ]
+      }
+    },
+    required: ["expectedRevision"],
+    additionalProperties: false
+  },
+  action: {
+    type: "object",
+    properties: {
+      action: {
+        type: "string",
+        enum: [
+          "approve",
+          "run",
+          "approve_and_run",
+          "end",
+          "resume",
+          "retry",
+          "approve_change",
+          "discard_change"
+        ]
+      },
+      expectedRevision: {
+        type: "integer",
+        exclusiveMinimum: 0,
+        maximum: 9007199254740991
+      },
+      expectedPendingVersion: {
+        type: "integer",
+        exclusiveMinimum: 0,
+        maximum: 9007199254740991
+      },
+      organizationId: {
+        description: "Required for session auth. Optional for an API key, which already identifies the organization.",
+        type: "string",
+        minLength: 1,
+        maxLength: 120
+      }
+    },
+    required: ["action", "expectedRevision"],
+    additionalProperties: false
+  }
+};
+
+// src/body-flags.ts
+var kebab = (name) => name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+function nonNull(schema) {
+  return schema.anyOf?.find((item) => item.type !== "null") ?? schema;
+}
+function nullable(schema) {
+  return schema.type === "null" || Array.isArray(schema.type) && schema.type.includes("null") || Boolean(schema.anyOf?.some(nullable));
+}
+function bodyFlagNames(schema, prefix = "") {
+  schema = nonNull(schema);
+  if (schema.properties)
+    return Object.entries(schema.properties).flatMap(
+      ([name, child]) => bodyFlagNames(child, `${prefix ? `${prefix}.` : ""}${kebab(name)}`)
+    );
+  if (schema.items && nonNull(schema.items).properties)
+    return bodyFlagNames(schema.items, `${prefix}.<index>`);
+  if (typeof schema.additionalProperties === "object")
+    return bodyFlagNames(schema.additionalProperties, `${prefix}.<key>`);
+  return [prefix];
+}
+function scalar(value, schema, flag) {
+  if (value === "null" && nullable(schema)) return null;
+  schema = nonNull(schema);
+  const type = Array.isArray(schema.type) ? schema.type.find((item) => item !== "null") : schema.type;
+  let result = value;
+  if (type === "array" && schema.items) {
+    if (typeof value !== "string")
+      throw new Error(`--${flag} requires comma-separated values`);
+    result = value === "" ? [] : value.split(",").map((item) => scalar(item.trim(), schema.items, flag));
+    const count = result.length;
+    if (count < (schema.minItems ?? 0) || count > (schema.maxItems ?? Infinity))
+      throw new Error(`--${flag} has an invalid number of values`);
+  } else if (type === "boolean") {
+    if (![true, false, "true", "false"].includes(value))
+      throw new Error(`--${flag} requires true or false`);
+    result = value === true || value === "true";
+  } else if (type === "integer" || type === "number") {
+    const number = typeof value === "string" && value.trim() ? Number(value) : NaN;
+    if (!Number.isFinite(number) || type === "integer" && !Number.isSafeInteger(number) || number < (schema.minimum ?? -Infinity) || number > (schema.maximum ?? Infinity) || schema.exclusiveMinimum !== void 0 && number <= schema.exclusiveMinimum)
+      throw new Error(`--${flag} requires a valid ${type}`);
+    result = number;
+  } else if (typeof value !== "string" || type === "object") {
+    throw new Error(
+      `--${flag} requires a value; use dotted fields for objects`
+    );
+  }
+  if (schema.enum && !schema.enum.includes(result))
+    throw new Error(
+      `--${flag}${flag.endsWith(".marketplace") ? `: ${String(result)} is not supported for this store target; value` : ""} must be one of: ${schema.enum.join(", ")}`
+    );
+  if (typeof result === "string" && (result.length < (schema.minLength ?? 0) || result.length > (schema.maxLength ?? Infinity) || schema.pattern && !new RegExp(schema.pattern).test(result) || schema.format === "date-time" && (!/T.*(?:Z|[+-]\d{2}:\d{2})$/.test(result) || !Number.isFinite(Date.parse(result)))))
+    throw new Error(
+      `--${flag} has an invalid value${schema.format ? ` (${schema.format})` : ""}`
+    );
+  return result;
+}
+function assignFlag(target, schema, parts, value, flag) {
+  schema = nonNull(schema);
+  const [part, ...rest] = parts;
+  if (["__proto__", "constructor", "prototype"].includes(part))
+    throw new Error(`Unknown flag --${flag}`);
+  const key = schema.items ? /^(0|[1-9][0-9]*)$/.test(part) ? Number(part) : void 0 : Object.keys(schema.properties ?? {}).find(
+    (name) => kebab(name) === part
+  ) ?? (typeof schema.additionalProperties === "object" ? part : void 0);
+  const child = schema.items ?? (typeof key === "string" ? schema.properties?.[key] ?? schema.additionalProperties : void 0);
+  if (key === void 0 || !child || typeof child !== "object" || typeof key === "number" && key >= (schema.maxItems ?? 500))
+    throw new Error(`Unknown or out-of-bounds flag --${flag}`);
+  const object = target;
+  if (!rest.length) {
+    object[key] = scalar(value, child, flag);
+    return;
+  }
+  const shape = nonNull(child);
+  if (!shape.properties && !shape.items && typeof shape.additionalProperties !== "object")
+    throw new Error(`Unknown flag --${flag}`);
+  object[key] ??= shape.items ? [] : {};
+  if (typeof object[key] !== "object" || object[key] === null)
+    throw new Error(`Conflicting flag --${flag}`);
+  assignFlag(object[key], child, rest, value, flag);
+}
+function validateRequired(value, schema, prefix = "") {
+  if (value === null) return;
+  schema = nonNull(schema);
+  if (Array.isArray(value) && schema.items) {
+    for (let index = 0; index < value.length; index++) {
+      if (!(index in value))
+        throw new Error(`--${prefix} indices must be consecutive from 0`);
+      validateRequired(value[index], schema.items, `${prefix}.${index}`);
+    }
+  } else if (value && typeof value === "object") {
+    const object = value;
+    for (const key of schema.required ?? [])
+      if (object[key] === void 0)
+        throw new Error(
+          `Missing required flag --${prefix ? `${prefix}.` : ""}${kebab(key)}`
+        );
+    for (const [key, child] of Object.entries(schema.properties ?? {}))
+      if (object[key] !== void 0)
+        validateRequired(
+          object[key],
+          child,
+          `${prefix ? `${prefix}.` : ""}${kebab(key)}`
+        );
+  }
+}
+var GLOBAL_FLAGS = /* @__PURE__ */ new Set([
+  "api-key",
+  "base-url",
+  "timeout",
+  "format",
+  "version",
+  "v"
+]);
+function parseBodyFlags(flags, schema) {
+  const result = {};
+  for (const [flag, value] of Object.entries(flags)) {
+    if (GLOBAL_FLAGS.has(flag)) continue;
+    assignFlag(result, schema, flag.split("."), value, flag);
+  }
+  validateRequired(result, schema);
+  return result;
+}
+
+// src/campaign-commands.ts
+var patch = CAMPAIGN_INPUTS.patch;
+var fields = patch.properties;
+var guards = Object.fromEntries(
+  ["organizationId", "expectedRevision", "expectedPendingVersion"].map(
+    (key) => [key, fields[key]]
+  )
+);
+var scope = { campaignId: { type: "string" } };
+function command(name, summary, schema, options = {}) {
+  const inputSchema = {
+    ...schema,
+    properties: { ...scope, ...schema.properties },
+    required: ["campaignId", ...schema.required ?? []]
+  };
+  return {
+    trail: ["campaigns", name],
+    resourcePath: ["campaigns"],
+    methodName: name,
+    httpMethod: options.action ? "POST" : "PATCH",
+    path: `/api/v1/campaigns/{campaignId}${options.action ? "/actions" : ""}`,
+    summary,
+    flags: bodyFlagNames(inputSchema).map((flag) => ({
+      name: flag === "campaign-id" ? "campaignId" : flag,
+      flag,
+      required: inputSchema.required.some((key) => kebab(key) === flag),
+      source: flag === "campaign-id" ? "path" : "body"
+    })),
+    acceptsJsonBody: true,
+    acceptsFile: false,
+    bodyRequired: false,
+    inputSchema,
+    ...options
+  };
+}
+var CAMPAIGN_COMMANDS = [
+  command(
+    "update",
+    "Edit campaign fields, windows and offers. Omitted values stay unchanged; running edits are proposals.",
+    patch
+  ),
+  ...["offers", "windows"].flatMap((target) => {
+    const { id, ...properties } = fields[target].items.properties;
+    const ids = target === "offers" ? "offerIds" : "windowIds";
+    const selection = {
+      type: "array",
+      items: id,
+      minItems: 1,
+      maxItems: fields[target].maxItems
+    };
+    return [
+      command(
+        `update-${target}`,
+        `Add or update ${target} by stable IDs with shared changes. Running edits are proposals.`,
+        {
+          type: "object",
+          properties: { ...guards, [ids]: selection, ...properties },
+          required: ["expectedRevision", ids]
+        },
+        { target }
+      ),
+      command(
+        `remove-${target}`,
+        `Remove selected ${target}. Move or remove offers before removing their window. Running edits are proposals.`,
+        {
+          type: "object",
+          properties: { ...guards, [ids]: selection },
+          required: ["expectedRevision", ids]
+        },
+        { target: target === "offers" ? "removeOfferIds" : "removeWindowIds" }
+      )
+    ];
+  }),
+  ...["approve_change", "discard_change"].map(
+    (action) => command(
+      action.replaceAll("_", "-"),
+      action === "approve_change" ? "Approve the reviewed live proposal as its named approver and queue delivery." : "Discard the reviewed live proposal.",
+      {
+        type: "object",
+        properties: {
+          ...guards,
+          expectedPendingVersion: CAMPAIGN_INPUTS.action.properties.expectedPendingVersion
+        },
+        required: ["expectedRevision", "expectedPendingVersion"]
+      },
+      { action }
+    )
+  )
+];
+function isCampaignCommand(command2) {
+  return "inputSchema" in command2;
+}
+function campaignRequest(command2, flags) {
+  const input2 = parseBodyFlags(flags, command2.inputSchema);
+  if (command2.action) return { ...input2, action: command2.action };
+  if (!command2.target) {
+    if (!Object.keys(input2).some(
+      (key) => key !== "campaignId" && !(key in guards)
+    ))
+      throw new Error("Supply at least one field to change.");
+    return input2;
+  }
+  const {
+    campaignId,
+    organizationId,
+    expectedRevision,
+    expectedPendingVersion,
+    offerIds,
+    windowIds,
+    ...changes
+  } = input2;
+  const ids = [...new Set(offerIds ?? windowIds)];
+  const removing = command2.target === "removeOfferIds" || command2.target === "removeWindowIds";
+  if (!removing && !Object.keys(changes).length)
+    throw new Error("Supply at least one field to change.");
+  return {
+    campaignId,
+    organizationId,
+    expectedRevision,
+    expectedPendingVersion,
+    [command2.target]: removing ? ids : ids.map((id) => ({ id, ...changes }))
+  };
+}
+
 // src/help.ts
 function printRootHelp(commands) {
   const groups = [
-    ...new Set(commands.map((command) => command.trail[0]))
+    ...new Set(commands.map((command2) => command2.trail[0]))
   ].sort();
   return `OmniCommerce CLI
 
@@ -4923,33 +6334,42 @@ function printAuthHelp() {
   omni auth logout                     Remove saved credentials
 `;
 }
-function printCommandHelp(command) {
-  const flags = command.flags.map((flag) => {
+function printCommandHelp(command2) {
+  const flags = command2.flags.map((flag) => {
     const req = flag.required ? "required" : "optional";
     return `  --${flag.flag} <${flag.name}>  ${req} ${flag.source}`;
   }).join("\n");
-  const jsonLine = `${command.acceptsFile ? "  --file <path>  required file to upload\n" : ""}${command.acceptsJsonBody ? `  --json <object|->  ${command.bodyRequired && !command.acceptsFile ? "required" : "optional"} body
+  const jsonLine = `${command2.acceptsFile ? "  --file <path>  required file to upload\n" : ""}${command2.acceptsJsonBody && !isCampaignCommand(command2) ? `  --json <object|->  ${command2.bodyRequired && !command2.acceptsFile ? "required" : "optional"} body
 ` : ""}`;
-  return `omni ${command.trail.join(" ")}
+  return `omni ${command2.trail.join(" ")}
 
-${command.summary}
+${command2.summary}
 
-${command.httpMethod} ${command.path}
+${command2.httpMethod} ${command2.path}
 
 Flags:
 ${flags || "  (none)"}${jsonLine ? `
 ${jsonLine}` : ""}
+${isCampaignCommand(command2) ? "\nArrays use comma-separated values (empty string clears). Object arrays use .0., .1., ... in flag names. Nullable fields accept null. Times require ISO 8601 with an explicit offset. Use --schema for types and allowed values.\n" : ""}
 `;
 }
 function matchCommands(commands, trail) {
   const prefix = commands.filter(
-    (command) => trail.every((token, index) => command.trail[index] === token)
+    (command2) => trail.every((token, index) => command2.trail[index] === token)
   );
-  const exact = prefix.find((command) => command.trail.length === trail.length);
+  const exact = prefix.find((command2) => command2.trail.length === trail.length);
   return { exact, prefix };
 }
 
 // src/run.ts
+var CLI_COMMANDS = [
+  ...COMMANDS.filter(
+    (command2) => !CAMPAIGN_COMMANDS.some(
+      (custom) => custom.trail.join(" ") === command2.trail.join(" ")
+    )
+  ),
+  ...CAMPAIGN_COMMANDS
+];
 async function readStdin() {
   const chunks = [];
   for await (const chunk of input) {
@@ -4966,9 +6386,9 @@ async function parseJsonBody(raw) {
   }
   return parsed;
 }
-function buildRequest(command, flags, body) {
+function buildRequest(command2, flags, body) {
   const request = { ...body };
-  for (const flag of command.flags) {
+  for (const flag of command2.flags) {
     const value = flagString(flags, flag.flag);
     if (value === void 0) {
       if (flag.required) {
@@ -5037,19 +6457,19 @@ async function runCli(argv, options) {
     return handleAuth(parsed.trail, parsed.flags, options);
   }
   if (parsed.trail.length === 0) {
-    process.stdout.write(printRootHelp(COMMANDS));
+    process.stdout.write(printRootHelp(CLI_COMMANDS));
     return parsed.help ? 0 : 1;
   }
-  const matched = matchCommands(COMMANDS, parsed.trail);
+  const matched = matchCommands(CLI_COMMANDS, parsed.trail);
   if (parsed.help && !matched.exact) {
     if (matched.prefix.length === 0) {
       process.stderr.write(`Unknown command: ${parsed.trail.join(" ")}
 `);
-      process.stdout.write(printRootHelp(COMMANDS));
+      process.stdout.write(printRootHelp(CLI_COMMANDS));
       return 1;
     }
     const unique = [
-      ...new Set(matched.prefix.map((command2) => command2.trail.join(" ")))
+      ...new Set(matched.prefix.map((command3) => command3.trail.join(" ")))
     ];
     process.stdout.write(
       `omni ${parsed.trail.join(" ")}
@@ -5060,38 +6480,42 @@ ${unique.map((line) => `  omni ${line}`).join("\n")}
     );
     return 0;
   }
-  const command = matched.exact;
-  if (!command) {
+  const command2 = matched.exact;
+  if (!command2) {
     process.stderr.write(`Unknown command: ${parsed.trail.join(" ")}
 `);
-    process.stdout.write(printRootHelp(COMMANDS));
+    process.stdout.write(printRootHelp(CLI_COMMANDS));
     return 1;
   }
   if (parsed.help) {
-    process.stdout.write(printCommandHelp(command));
+    process.stdout.write(printCommandHelp(command2));
     return 0;
   }
   if (parsed.schema) {
-    process.stdout.write(`${JSON.stringify(command, null, 2)}
+    process.stdout.write(`${JSON.stringify(command2, null, 2)}
 `);
     return 0;
   }
   const body = await parseJsonBody(flagString(parsed.flags, "json"));
-  const filePath = command.acceptsFile ? flagString(parsed.flags, "file") : void 0;
-  if (command.acceptsFile && !filePath) {
-    throw new Error(`omni ${command.trail.join(" ")} requires --file <path>`);
+  const filePath = command2.acceptsFile ? flagString(parsed.flags, "file") : void 0;
+  if (command2.acceptsFile && !filePath) {
+    throw new Error(`omni ${command2.trail.join(" ")} requires --file <path>`);
   }
-  if (command.bodyRequired && !body && !filePath) {
-    throw new Error(`omni ${command.trail.join(" ")} requires --json`);
+  if (command2.bodyRequired && !body && !filePath) {
+    throw new Error(`omni ${command2.trail.join(" ")} requires --json`);
   }
-  const request = buildRequest(command, parsed.flags, body);
+  if (isCampaignCommand(command2) && body)
+    throw new Error(
+      "Use campaign field flags for this command; --json is available on campaigns replace and actions."
+    );
+  const request = isCampaignCommand(command2) ? campaignRequest(command2, parsed.flags) : buildRequest(command2, parsed.flags, body);
   if (filePath) request.file = filePath;
   if (parsed.dryRun) {
     process.stdout.write(
       `${JSON.stringify(
         {
-          method: command.httpMethod,
-          path: command.path,
+          method: command2.httpMethod,
+          path: command2.path,
           request
         },
         null,
@@ -5112,7 +6536,7 @@ ${unique.map((line) => `  omni ${line}`).join("\n")}
     return 1;
   }
   const timeoutRaw = flagString(parsed.flags, "timeout");
-  const timeoutInSeconds = timeoutRaw ? Number(timeoutRaw) : command.path === "/api/v1/agents/general/invoke" ? 780 : void 0;
+  const timeoutInSeconds = timeoutRaw ? Number(timeoutRaw) : command2.path === "/api/v1/agents/general/invoke" ? 780 : void 0;
   const client = new OmniClient({
     apiKey: credentials.apiKey,
     baseUrl: credentials.baseUrl,
@@ -5120,7 +6544,7 @@ ${unique.map((line) => `  omni ${line}`).join("\n")}
     fetch: options?.fetch
   });
   try {
-    const result = await executeCommand(client, command, request);
+    const result = await executeCommand(client, command2, request);
     const format = resolveFormat(
       flagString(parsed.flags, "format"),
       options?.stdoutIsTty ?? Boolean(process.stdout.isTTY)