@zanfia/cli 0.3.63 → 0.4.0

package/dist/index.js

@@ -8343,6 +8343,9 @@ function createMockClient() {
     async cancelEmailCampaign() {
       throw new ApiError(501, "email campaigns are not available in mock mode");
     },
+    async sendEmailCampaignTest() {
+      throw new ApiError(501, "email campaigns are not available in mock mode");
+    },
     async resendEmailCampaign() {
       throw new ApiError(501, "email campaigns are not available in mock mode");
     },
@@ -9535,6 +9538,11 @@ function createHttpClient(config) {
       scheduledAt !== void 0 ? { scheduledAt } : {}
     ),
     cancelEmailCampaign: (id) => request("POST", `/campaigns/${encodeURIComponent(id)}/cancel`),
+    sendEmailCampaignTest: (id, recipients) => request(
+      "POST",
+      `/campaigns/${encodeURIComponent(id)}/test-sends`,
+      recipients && recipients.length > 0 ? { recipients } : {}
+    ),
     resendEmailCampaign: (id, target) => request("POST", `/campaigns/${encodeURIComponent(id)}/resend`, target ? { target } : {}),
     listCampaignRecipients: (id, options) => {
       const params = new URLSearchParams();
@@ -12299,6 +12307,9 @@ var RECIPIENT_STATUSES = [
   "complained",
   "clicked"
 ];
+function collectRepeatable(value, previous) {
+  return [...previous, value];
+}
 function parsePositiveInt2(value, flag) {
   const n = Number.parseInt(value, 10);
   if (!Number.isInteger(n) || n <= 0) {
@@ -12534,6 +12545,25 @@ function registerCampaignsCommands(program2) {
 `);
     });
   });
+  campaigns.command("test").description(
+    "Send a TEST of the saved campaign to up to 3 addresses (default: your own) \u2014 subject prefixed [Test], sample personalization values; never the audience"
+  ).argument("<id>", "campaign id").option(
+    "--to <email>",
+    "test recipient \u2014 repeatable or comma-separated, max 3 (default: your own address)",
+    collectRepeatable,
+    []
+  ).action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    const recipients = options.to.flatMap((entry) => entry.split(",")).map((email) => email.trim()).filter(Boolean);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.sendEmailCampaignTest(id, recipients);
+    emit(flags, result, () => {
+      process.stdout.write(
+        `Test of campaign ${id} queued \u2192 ${result.recipients.join(", ")} (subject prefixed [Test]). Nothing was sent to the audience.
+`
+      );
+    });
+  });
   campaigns.command("send").description(
     "\u26A0\uFE0F SENDS the campaign \u2014 REAL bulk email to the entire resolved audience, IRREVERSIBLY. Delivered mail cannot be recalled; `campaigns cancel` only stops remaining sends. Requires --confirm. Omit --at to send NOW; --at schedules (max 30 days out)."
   ).argument("<id>", "campaign id").option(
@@ -12543,7 +12573,7 @@ function registerCampaignsCommands(program2) {
     const flags = getGlobalFlags(command);
     if (!options.confirm) {
       throw new Error(
-        `Refusing to send without --confirm. \`campaigns send\` emails the ENTIRE resolved audience for real and cannot be undone once mail is delivered. Re-run with --confirm to proceed (check the draft first with \`campaigns get ${id}\`).`
+        `Refusing to send without --confirm. \`campaigns send\` emails the ENTIRE resolved audience for real and cannot be undone once mail is delivered. Re-run with --confirm to proceed (check the draft first with \`campaigns get ${id}\` and \`campaigns test ${id}\`).`
       );
     }
     if (options.at !== void 0 && Number.isNaN(Date.parse(options.at))) {
@@ -13567,7 +13597,7 @@ function parsePositiveInt4(value, flag) {
   }
   return n;
 }
-function collectRepeatable(value, previous) {
+function collectRepeatable2(value, previous) {
   return [...previous, value];
 }
 function parseCsv(raw) {
@@ -14051,7 +14081,7 @@ Next page: --cursor ${page.nextCursor}
   ).argument("<csvFile>", "path to the CSV file").option(
     "--tag <tagId>",
     "existing tag id applied to every imported row (repeat for several; unknown ids fail)",
-    collectRepeatable,
+    collectRepeatable2,
     []
   ).action(async (csvFile, options, command) => {
     const flags = getGlobalFlags(command);
@@ -15969,7 +15999,7 @@ function assertStatus(status) {
     throw new Error(`Invalid status "${status}". Use one of: ${LESSON_STATUSES.join(", ")}`);
   }
 }
-function collectRepeatable2(value, previous) {
+function collectRepeatable3(value, previous) {
   return [...previous, value];
 }
 function parseNonNegativeInt(value, flag) {
@@ -16577,7 +16607,7 @@ ${NOT_SAVED_NOTE} --moments=${options.out ?? "<file>"} --confirm\`.
   ).argument("<productId>", "course product id").argument("<lessonId>", "quiz lesson id").option("--type <type>", "single | multi | truefalse").option("--question <text>", "the question prompt").option("--explanation <text>", "explanation shown on the results screen").option("--points <n>", "points awarded (default 1)").option(
     "--option <text>",
     "an answer option (repeat for several; choice types only)",
-    collectRepeatable2,
+    collectRepeatable3,
     []
   ).option("--correct <indices>", "1-based, comma-separated indices of the correct option(s)").option("--correct-answer <bool>", "true/false questions: the correct answer").option("--json <fileOrJson>", "full QuizQuestionInput object as inline JSON or a .json path").action(
     async (productId, lessonId, options, command) => {
@@ -16593,7 +16623,7 @@ ${NOT_SAVED_NOTE} --moments=${options.out ?? "<file>"} --confirm\`.
   quiz.command("update").description("Replace a question in full (same flags as `quiz add`, or --json)").argument("<productId>", "course product id").argument("<lessonId>", "quiz lesson id").argument("<questionId>", "question id").option("--type <type>", "single | multi | truefalse").option("--question <text>", "the question prompt").option("--explanation <text>", "explanation shown on the results screen").option("--points <n>", "points awarded (default 1)").option(
     "--option <text>",
     "an answer option (repeat for several; choice types only)",
-    collectRepeatable2,
+    collectRepeatable3,
     []
   ).option("--correct <indices>", "1-based, comma-separated indices of the correct option(s)").option("--correct-answer <bool>", "true/false questions: the correct answer").option("--json <fileOrJson>", "full QuizQuestionInput object as inline JSON or a .json path").action(
     async (productId, lessonId, questionId, options, command) => {
@@ -16777,7 +16807,7 @@ function parseIsoDate(value, flag) {
   }
   return value;
 }
-function collectRepeatable3(value, previous) {
+function collectRepeatable4(value, previous) {
   return [...previous, value];
 }
 function registerDiscountsCommands(program2) {
@@ -16802,7 +16832,7 @@ function registerDiscountsCommands(program2) {
   discounts2.command("create").description("Create a discount code (exactly one of --percent-off / --amount-off)").requiredOption("--code <code>", "discount code (e.g. LAUNCH20)").option("--percent-off <pct>", "percentage discount (> 0, <= 100)").option("--amount-off <minorUnits>", "fixed discount in minor units (e.g. 1000 = 10.00)").option("--currency <currency>", "ISO currency code (required with --amount-off)").option(
     "--product <id>",
     "limit to a product (repeat the flag for several)",
-    collectRepeatable3,
+    collectRepeatable4,
     []
   ).option("--max-redemptions <n>", "maximum number of redemptions").option("--ends <isoDate>", "date the code stops working (ISO, e.g. 2026-12-31)").option("--starts <isoDate>", "date the code starts working (ISO, e.g. 2026-12-01)").option("--forever", "apply to every renewal of a subscription (default: first payment only)").option("--inactive", "create the code deactivated (default: active)").action(
     async (options, command) => {
@@ -16852,7 +16882,7 @@ function registerDiscountsCommands(program2) {
   discounts2.command("update").description("Update a discount code (value, products, limits, dates, active state)").argument("<discountId>", "discount id").option("--percent-off <pct>", "switch to a percentage discount (> 0, <= 100)").option("--amount-off <minorUnits>", "switch to a fixed discount in minor units").option("--currency <currency>", "ISO currency code for --amount-off").option(
     "--product <id>",
     "replace the product restriction (repeat the flag for several)",
-    collectRepeatable3,
+    collectRepeatable4,
     []
   ).option("--max-redemptions <n>", "maximum number of redemptions").option("--clear-max-redemptions", "remove the redemption limit").option("--ends <isoDate>", "date the code stops working (ISO, e.g. 2026-12-31)").option("--clear-ends", "remove the end date").option("--forever", "apply to every renewal of a subscription").option("--active", "activate the code").option("--inactive", "deactivate the code").action(
     async (discountId, options, command) => {
@@ -23043,7 +23073,7 @@ function parseJsonFileOrInline5(value, flag) {
     throw new Error(`Invalid JSON for ${flag}: ${error.message}`);
   }
 }
-function collectRepeatable4(value, previous) {
+function collectRepeatable5(value, previous) {
   return [...previous, value];
 }
 function registerNewslettersCommands(program2) {
@@ -23374,7 +23404,7 @@ Next: \`newsletters issues draft save ${productId} ${issue.id} --content <markdo
   ).option("--double-opt-in <mode>", `subscription confirmation (${DOUBLE_OPT_INS.join("|")})`).option(
     "--client-tag <tag>",
     "tag applied to new subscribers (repeat the flag; replaces the list)",
-    collectRepeatable4,
+    collectRepeatable5,
     []
   ).option(
     "--delivery <mode>",
@@ -25064,6 +25094,22 @@ import { readFile as readFile3 } from "fs/promises";
 import { basename as basename2 } from "path";
 var KB_TREE_CHANGED_ERROR = "tree-changed";
 var JSON_FLAG_HINT3 = "(write it as --json=<value> \u2014 a bare --json is the global JSON-output flag)";
+var PRODUCT_TYPE_INPUTS = [
+  "downloads",
+  "download",
+  "newsletter",
+  "course",
+  "mailing",
+  "community",
+  "membership",
+  "knowledge_base",
+  "one_time",
+  "custom",
+  "event",
+  "consultation",
+  "service",
+  "bundle"
+];
 function parseCoverRef(value) {
   const separator = value.indexOf(":");
   if (separator < 0) {
@@ -25174,7 +25220,7 @@ function parseJsonFileOrInline8(value, flag) {
     throw new Error(`Invalid JSON for ${flag}: ${error.message}`);
   }
 }
-function collectRepeatable5(value, previous) {
+function collectRepeatable6(value, previous) {
   return [...previous, value];
 }
 var HTTP_URL_PATTERN2 = /^https?:\/\//i;
@@ -25262,7 +25308,10 @@ function registerProductsCommands(program2) {
   });
   products2.command("create").description(
     "Create a new product. Community/newsletter types seed their full content (community: channels doc, built-in roles, owner member). Add --free or --amount to also seed a default offer \u2014 e.g. a paid community: --type community --amount 49.99 --currency usd --period monthly"
-  ).requiredOption("--name <name>", "product name").requiredOption("--type <type>", "product type (course, newsletter, community, ...)").option("--description <description>", "product description").option("--free", "seed a free default offer").option("--amount <amount>", "seed a paid default offer \u2014 price in MAJOR units (49.99)").option("--currency <currency>", "currency for --amount (pln, usd, eur, gbp)").option(
+  ).requiredOption("--name <name>", "product name").requiredOption(
+    "--type <type>",
+    `product type: ${PRODUCT_TYPE_INPUTS.join(", ")} (downloads/download are stored as one_time, newsletter as mailing)`
+  ).option("--description <description>", "product description").option("--free", "seed a free default offer").option("--amount <amount>", "seed a paid default offer \u2014 price in MAJOR units (49.99)").option("--currency <currency>", "currency for --amount (pln, usd, eur, gbp)").option(
     "--period <period>",
     "billing period for --amount: one_time, monthly or yearly (default one_time)"
   ).option("--description-file <path>", "read the product description from a file").option(
@@ -25271,7 +25320,7 @@ function registerProductsCommands(program2) {
   ).option(
     "--file <path>",
     "local file to upload and attach to the product (downloads products; repeat for several)",
-    collectRepeatable5,
+    collectRepeatable6,
     []
   ).action(
     async (options, command) => {
@@ -25606,7 +25655,7 @@ function registerProductsCommands(program2) {
   ).argument("<productId>", "appointment product id").option("--config <fileOrJson>", "full config object as inline JSON or a path to a .json file").option("--booking-method <method>", `consultation: ${BOOKING_METHODS.join("|")}`).option("--booking-url <url>", "consultation: external scheduler URL").option("--duration <minutes>", "consultation: session length in minutes").option("--location <text>", "consultation location / event join URL or address").option("--location-details <text>", "consultation: extra location details").option("--confirmation-message <text>", "consultation: post-booking confirmation message").option(
     "--deliverable <text>",
     "service: a deliverable line (repeat the flag; replaces the list)",
-    collectRepeatable5,
+    collectRepeatable6,
     []
   ).option("--delivery-time <n>", "service: delivery time value").option("--delivery-unit <unit>", `service: ${DELIVERY_UNITS.join("|")} (with --delivery-time)`).option("--revision-rounds <n|unlimited>", 'service: revision rounds count or "unlimited"').option("--brief-method <method>", `service: ${BRIEF_METHODS.join("|")}`).option("--brief-url <url>", "service: external brief/intake form URL").option("--event-mode <mode>", `event: ${EVENT_MODES3.join("|")}`).option("--starts <iso>", "event: start (ISO 8601)").option("--ends <iso>", "event: end (ISO 8601)").option("--capacity <n>", "event: attendee capacity").option("--show-on-success <on|off>", "show the post-purchase CTA on the success page").action(
     async (productId, options, command) => {
@@ -25802,7 +25851,7 @@ function registerProductsCommands(program2) {
   ).argument("<productId>", "product id").requiredOption(
     "--image <url>",
     "an image URL (repeat the flag for several; the set fully replaces the current images)",
-    collectRepeatable5,
+    collectRepeatable6,
     []
   ).action(async (productId, options, command) => {
     const flags = getGlobalFlags(command);
@@ -26531,7 +26580,7 @@ Failed deliveries (${result.failedDeliveries.length})
 // src/commands/segments/index.ts
 import { readFileSync as readFileSync24 } from "fs";
 var SUBSCRIPTION_STATUSES2 = ["pending", "subscribed", "unsubscribed"];
-function collectRepeatable6(value, previous) {
+function collectRepeatable7(value, previous) {
   return [...previous, value];
 }
 function parseMinorUnits(value, flag) {
@@ -26623,42 +26672,42 @@ function withConditionOptions(command) {
   return command.option(
     "--has-tag <tagId>",
     "client carries this tag (repeat for several \u2014 conditions are ANDed)",
-    collectRepeatable6,
+    collectRepeatable7,
     []
   ).option(
     "--without-tag <tagId>",
     "client does NOT carry this tag (repeatable)",
-    collectRepeatable6,
+    collectRepeatable7,
     []
   ).option(
     "--has-any-tag <tagId>",
     "client carries AT LEAST ONE of these tags (repeat the flag; one OR condition, max 10 ids) - one send to several tags without double-mailing",
-    collectRepeatable6,
+    collectRepeatable7,
     []
   ).option(
     "--has-none-tag <tagId>",
     "client carries NONE of these tags (repeat the flag; one condition, max 10 ids)",
-    collectRepeatable6,
+    collectRepeatable7,
     []
   ).option(
     "--owns <productId>",
     "client has ACTIVE access to this product - a direct grant OR through a bundle (repeatable)",
-    collectRepeatable6,
+    collectRepeatable7,
     []
   ).option(
     "--not-owns <productId>",
     "client has NO active access to this product, direct or through a bundle (repeatable)",
-    collectRepeatable6,
+    collectRepeatable7,
     []
   ).option(
     "--owns-direct <productId>",
     "client has an ACTIVE grant on this product itself (bought / granted by hand) - bundle access does not count; use to mail only the buyers of that one product (repeatable)",
-    collectRepeatable6,
+    collectRepeatable7,
     []
   ).option(
     "--not-owns-direct <productId>",
     "client has NO active direct grant on this product - bundle holders DO match (repeatable)",
-    collectRepeatable6,
+    collectRepeatable7,
     []
   ).option(
     "--spent-gte <minorUnits>",
@@ -29662,7 +29711,11 @@ function describeDelay(config) {
   switch (mode) {
     case void 0:
     case "duration":
-      return `wait ${typeof config.amount === "number" ? config.amount : "?"} ${optionalString(config.unit) ?? ""}`.trimEnd();
+      return `wait ${typeof config.amount === "number" ? config.amount : "?"} ${optionalString(config.unit) ?? ""}${optionalString(config.atTime) ? `, then at ${config.atTime}` : ""}`.trimEnd();
+    case "untilTime": {
+      const weekdays = Array.isArray(config.weekdays) ? config.weekdays.join(",") : "";
+      return `wait until the next ${optionalString(config.time) ?? "?"}${weekdays ? ` on weekdays ${weekdays}` : ""}${optionalString(config.timezone) ? ` (${config.timezone})` : ""}`;
+    }
     case "untilWeekday":
       return `wait until weekday ${typeof config.weekday === "number" ? config.weekday : "?"} at ${optionalString(config.time) ?? "?"}${optionalString(config.timezone) ? ` (${config.timezone})` : ""}`;
     case "untilDate":
@@ -29829,8 +29882,8 @@ function applyShortHelp(program2) {
 
 // src/program.ts
 function resolveCliVersion() {
-  if ("0.3.63".length > 0) {
-    return "0.3.63";
+  if ("0.4.0".length > 0) {
+    return "0.4.0";
   }
   try {
     const raw = readFileSync28(new URL("../package.json", import.meta.url), "utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zanfia/cli",
-  "version": "0.3.63",
+  "version": "0.4.0",
   "private": false,
   "description": "Zanfia CLI — thin HTTP client over the Zanfia Public API",
   "type": "module",