add campaignState filter

Author: gmethvin

COMMANDS.md

@@ -144,6 +144,7 @@ Retrieve campaigns
 
 | Option | Type | Required | Description |
 |--------|------|----------|-------------|
+| `--campaignState` | enum[] | no | Filter campaigns by state. Can specify multiple states. Valid states: Draft, Ready, Scheduled, Running, Finished, Starting, Aborted, Recurring, Archived |
 | `--order` | `asc` \| `desc` | no | Sort direction (asc or desc) |
 | `--page` | number | no | Page number (starting at 1) |
 | `--pageSize` | number | no | Number of results to return per page (defaults to 20, maximum of 1000) |

package.json

@@ -59,14 +59,14 @@
     "update-commands": "node scripts/update-commands.js"
   },
   "dependencies": {
-    "@iterable/api": "0.9.1",
+    "@iterable/api": "0.10.0",
     "@primno/dpapi": "2.0.1",
     "boxen": "8.0.1",
     "chalk": "5.6.2",
     "cli-table3": "0.6.5",
     "inquirer": "13.3.2",
     "ora": "9.3.0",
-    "zod": "4.1.11",
+    "zod": "4.3.6",
     "zod-opts": "1.0.0"
   },
   "devDependencies": {

pnpm-lock.yaml

@@ -22,7 +22,27 @@ function getSchemaShape(schema: z.ZodType): Record<string, z.ZodType> {
   return {};
 }
 
-function canZodOptsHandle(fieldSchema: z.ZodType): boolean {
+/**
+ * zod-opts supports z.array(z.string()) and z.array(z.number()) but not
+ * z.array(z.enum([...])). For those, substitute z.array(z.string()) so
+ * the CLI accepts space-separated values. The final schema.parse() in
+ * parseCommand validates the enum values.
+ */
+function coerceForZodOpts(fieldSchema: z.ZodType): z.ZodType {
+  const inner = unwrapSchema(fieldSchema);
+  if (inner instanceof z.ZodArray) {
+    const element = unwrapSchema(inner.element as z.ZodType);
+    if (element instanceof z.ZodEnum) {
+      const coerced = z.array(z.string());
+      return fieldSchema instanceof z.ZodOptional
+        ? coerced.optional()
+        : coerced;
+    }
+  }
+  return fieldSchema;
+}
+
+function zodOptsProbe(fieldSchema: z.ZodType): boolean {
   try {
     parser()
       .options({ _probe: { type: fieldSchema.optional() } })
@@ -34,6 +54,12 @@ function canZodOptsHandle(fieldSchema: z.ZodType): boolean {
   }
 }
 
+function canZodOptsHandle(fieldSchema: z.ZodType): boolean {
+  if (zodOptsProbe(fieldSchema)) return true;
+  const coerced = coerceForZodOpts(fieldSchema);
+  return coerced !== fieldSchema && zodOptsProbe(coerced);
+}
+
 // Only return scalar defaults for display in --help and COMMANDS.md.
 // Complex defaults (objects, arrays) are omitted since those fields are
 // rendered as JSON fallback inputs where showing a default isn't useful.
@@ -218,7 +244,7 @@ export function buildParser(
     } else {
       const fieldSchema = shape[field.name];
       if (fieldSchema) {
-        options[field.name] = { type: fieldSchema };
+        options[field.name] = { type: coerceForZodOpts(fieldSchema) };
       }
     }
   }