@zanfia/cli 0.3.52 → 0.4.0

package/dist/index.js

@@ -8343,6 +8343,12 @@ 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");
+    },
     async listCampaignRecipients() {
       throw new ApiError(501, "email campaigns are not available in mock mode");
     },
@@ -8538,6 +8544,15 @@ function createMockClient() {
     async copyNewsletterIssues() {
       throw new ApiError(501, "newsletter content is not available in mock mode");
     },
+    async sendNewsletterIssue() {
+      throw new ApiError(501, "newsletter content is not available in mock mode");
+    },
+    async cancelNewsletterIssueSend() {
+      throw new ApiError(501, "newsletter content is not available in mock mode");
+    },
+    async getNewsletterIssueSendReport() {
+      throw new ApiError(501, "newsletter content is not available in mock mode");
+    },
     async getKbContent() {
       throw new ApiError(501, "knowledge-base content is not available in mock mode");
     },
@@ -8577,6 +8592,21 @@ function createMockClient() {
     async getMediaTranscript() {
       throw new ApiError(501, "media transcripts are not available in mock mode");
     },
+    async listMediaCaptions() {
+      throw new ApiError(501, "video captions are not available in mock mode");
+    },
+    async uploadMediaCaption() {
+      throw new ApiError(501, "video captions are not available in mock mode");
+    },
+    async getMediaCaption() {
+      throw new ApiError(501, "video captions are not available in mock mode");
+    },
+    async deleteMediaCaption() {
+      throw new ApiError(501, "video captions are not available in mock mode");
+    },
+    async regenerateMediaCaption() {
+      throw new ApiError(501, "video captions are not available in mock mode");
+    },
     async generateAIImage() {
       throw new ApiError(501, "AI image generation is not available in mock mode");
     },
@@ -8706,6 +8736,12 @@ function createMockClient() {
     async listSignupFormSubmissions() {
       return { submissions: [] };
     },
+    async listLiveRooms() {
+      return { rooms: [] };
+    },
+    async getLiveRoomAttendance() {
+      throw new ApiError(501, "live rooms are not available in mock mode");
+    },
     async call(method, pathTemplate) {
       throw new ApiError(501, `${method} ${pathTemplate} is not available in mock mode`);
     },
@@ -9502,6 +9538,12 @@ 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();
       if (options?.status) params.set("status", options.status);
@@ -9661,6 +9703,19 @@ function createHttpClient(config) {
       `/products/${encodeURIComponent(productId)}/newsletter/issues/${encodeURIComponent(issueId)}/draft`
     ),
     copyNewsletterIssues: (productId, input) => request("POST", `/products/${encodeURIComponent(productId)}/newsletter/issues/copy`, input),
+    sendNewsletterIssue: (productId, issueId, input) => request(
+      "POST",
+      `/products/${encodeURIComponent(productId)}/newsletter/issues/${encodeURIComponent(issueId)}/send`,
+      input
+    ),
+    cancelNewsletterIssueSend: (productId, issueId) => request(
+      "POST",
+      `/products/${encodeURIComponent(productId)}/newsletter/issues/${encodeURIComponent(issueId)}/send/cancel`
+    ),
+    getNewsletterIssueSendReport: (productId, issueId) => request(
+      "GET",
+      `/products/${encodeURIComponent(productId)}/newsletter/issues/${encodeURIComponent(issueId)}/send/report`
+    ),
     // Knowledge-base product content (addressed by product id).
     getKbContent: (productId) => request("GET", `/products/${encodeURIComponent(productId)}/kb`),
     getKbArticle: (productId, articleId) => request(
@@ -9701,6 +9756,17 @@ function createHttpClient(config) {
       "GET",
       `/media/${encodeURIComponent(mediaId)}/transcript${includeWords ? "?includeWords=true" : ""}`
     ),
+    listMediaCaptions: (mediaId) => request("GET", `/media/${encodeURIComponent(mediaId)}/captions`),
+    uploadMediaCaption: (mediaId, input) => request("POST", `/media/${encodeURIComponent(mediaId)}/captions`, input),
+    getMediaCaption: (mediaId, srclang) => request(
+      "GET",
+      `/media/${encodeURIComponent(mediaId)}/captions/${encodeURIComponent(srclang)}`
+    ),
+    deleteMediaCaption: (mediaId, srclang) => request(
+      "DELETE",
+      `/media/${encodeURIComponent(mediaId)}/captions/${encodeURIComponent(srclang)}`
+    ),
+    regenerateMediaCaption: (mediaId) => request("POST", `/media/${encodeURIComponent(mediaId)}/captions/regenerate`, {}),
     // AI image generation + on-demand transcription (both spend credits / minutes).
     generateAIImage: (input) => request("POST", "/media/ai-images", input),
     transcribeMedia: (mediaId, input) => request("POST", `/media/${encodeURIComponent(mediaId)}/transcribe`, input),
@@ -9840,6 +9906,12 @@ function createHttpClient(config) {
       "GET",
       `/forms/${encodeURIComponent(id)}/submissions${limit !== void 0 ? `?limit=${limit}` : ""}`
     ),
+    // Live rooms live on the Workspace API (api-v1), read only.
+    listLiveRooms: () => request("GET", "/live-rooms"),
+    getLiveRoomAttendance: (roomId, session) => request(
+      "GET",
+      `/live-rooms/${encodeURIComponent(roomId)}/attendance${session !== void 0 ? `?session=${encodeURIComponent(session)}` : ""}`
+    ),
     // Descriptor-generated commands (certificates, …) — Workspace API (api-v1).
     call: (method, pathTemplate, params, query, body) => request(method, `${fillPathTemplate(pathTemplate, params)}${toQuery(query)}`, body),
     // Referral / affiliate programs live on the Workspace API (api-v1).
@@ -9946,6 +10018,14 @@ function parseNumberOption(flag, format) {
     return n;
   };
 }
+var WORKFLOW_KINDS = ["transactional", "marketing"];
+function parseWorkflowKind(value) {
+  const kind = value.trim().toLowerCase();
+  if (!WORKFLOW_KINDS.includes(kind)) {
+    throw new Error(`Invalid --kind: ${value} (expected ${WORKFLOW_KINDS.join(" or ")})`);
+  }
+  return kind;
+}
 function parseCommaList(flag) {
   return (value) => {
     const items = [
@@ -10349,9 +10429,133 @@ function registerCertificatesCommands(program2) {
   });
 }
 
+// src/commands/_generated/blog.ts
+var listBlogPostsColumns = ["id", "slug", "title", "status", "publishedAt", "updatedAt"];
+function registerBlogCommands(program2) {
+  const blog = program2.command("blog");
+  blog.description(
+    "The workspace blog (Your site \u2192 Blog): Markdown posts served at /blog on the store host; drafts are visible to the team only"
+  );
+  blog.command("list").summary("List blog posts").description(
+    "Every post of the workspace blog (drafts and published), newest change first: id, slug (`/blog/{slug}` on the store host), title, excerpt, cover, tags, status and dates. No body - use get-blog-post for the Markdown. The id source for every other blog tool."
+  ).action(async (_options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {};
+    const result = await client.call("GET", "/blog-posts", params, void 0, void 0);
+    const rows = tableRowsOf(result, "posts");
+    emit(flags, result ?? {}, () => printTable(rows, listBlogPostsColumns));
+  });
+  blog.command("create").summary("Create a blog post").description(
+    "Creates a blog post as a DRAFT (or published with `publish: true` when it has a body). The body is Markdown. A slug the caller sets must be free (409) and not `feed`; a slug derived from the title takes the next free numeric suffix. Returns the full post. Requires the blog early access on the workspace (403 otherwise)."
+  ).requiredOption("--title <value>", "Post title (max 200 characters).").option(
+    "--slug <value>",
+    "Derived from the title when omitted; a taken derived slug gets a numeric suffix."
+  ).option("--content <value>", "The body as Markdown (headings, lists, links, images by URL).").option(
+    "--excerpt <value>",
+    "Short plain-text summary (list, RSS, meta description); derived from the body on publish when empty."
+  ).option("--cover <value>", "Cover image URL (Media Library).").option("--tags <a,b,...>", "Lowercase labels, at most 10.", parseCommaList("--tags")).option("--seo <json|file>", "seo", parseJsonObjectFileOrInline("--seo")).option("--publish", "Publish right away (needs a non-empty body); default false = draft.").option("--no-publish", "Send `publish: false` explicitly.").action(async (options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {};
+    const payload = {
+      title: options.title,
+      slug: options.slug,
+      content: options.content,
+      excerpt: options.excerpt,
+      coverImageUrl: options.cover,
+      tags: options.tags,
+      seo: options.seo,
+      publish: options.publish
+    };
+    const result = await client.call("POST", "/blog-posts", params, void 0, payload);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  blog.command("get").summary("Blog post detail").description(
+    "One blog post with its Markdown body and SEO overrides (title, description, noindex). 404 when unknown."
+  ).argument("<id>", "Blog post id (`post_\u2026`) from list-blog-posts.").action(async (id, _options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      postId: id
+    };
+    const result = await client.call("GET", "/blog-posts/:postId", params, void 0, void 0);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  blog.command("update").summary("Update a blog post").description(
+    "Partial update of a blog post: title, slug (must be free, 409), Markdown body, excerpt, cover (null removes it), tags, SEO (whole section replaced). A published post keeps serving the new content at once. Returns the full post."
+  ).argument("<id>", "Blog post id (`post_\u2026`) from list-blog-posts.").option("--title <value>", "title").option(
+    "--slug <value>",
+    "Public path segment (`/blog/{slug}`): lowercase letters, digits and hyphens."
+  ).option("--content <value>", "The body as Markdown (headings, lists, links, images by URL).").option(
+    "--excerpt <value>",
+    "Short plain-text summary (list, RSS, meta description); derived from the body on publish when empty."
+  ).option("--cover <value>", "Cover image URL; null removes the cover.").option("--tags <a,b,...>", "Lowercase labels, at most 10.", parseCommaList("--tags")).option(
+    "--seo <json|file>",
+    "Replaces the whole SEO section.",
+    parseJsonObjectFileOrInline("--seo")
+  ).action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      postId: id
+    };
+    const payload = {
+      title: options.title,
+      slug: options.slug,
+      content: options.content,
+      excerpt: options.excerpt,
+      coverImageUrl: options.cover,
+      tags: options.tags,
+      seo: options.seo
+    };
+    const result = await client.call("PATCH", "/blog-posts/:postId", params, void 0, payload);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  blog.command("publish").summary("Publish or unpublish a blog post").description(
+    "Publishes a post at `/blog/{slug}` (needs a non-empty body, 400 otherwise; the excerpt is derived from the body when empty) or takes it back to draft. The first publication date is the post's date and survives unpublish / republish. Reversible. Returns the full post."
+  ).argument("<id>", "Blog post id (`post_\u2026`) from list-blog-posts.").option("--publish", "true = publish, false = back to draft.").action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      postId: id
+    };
+    const payload = {
+      publish: options.publish
+    };
+    const result = await client.call(
+      "POST",
+      "/blog-posts/:postId/publish",
+      params,
+      void 0,
+      payload
+    );
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  blog.command("delete").summary("Delete a blog post").description(
+    "Deletes a blog post for good; a published one disappears from `/blog` at once. No undo - prefer unpublishing."
+  ).argument("<id>", "Blog post id (`post_\u2026`) from list-blog-posts.").option("--confirm", "required \u2014 acknowledge that you want to deletes the post for good").action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    requireConfirm(options.confirm, "deletes the post for good");
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      postId: id
+    };
+    const result = await client.call(
+      "DELETE",
+      "/blog-posts/:postId",
+      params,
+      void 0,
+      void 0
+    );
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+}
+
 // src/commands/_generated/index.ts
 function registerGeneratedCommands(program2) {
   registerCertificatesCommands(program2);
+  registerBlogCommands(program2);
 }
 
 // src/commands/ads/index.ts
@@ -12103,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) {
@@ -12140,13 +12347,15 @@ function resolveSender(options) {
   };
 }
 function resolveTheme(options) {
-  if (options.backgroundColor === void 0 && options.contentBackgroundColor === void 0 && options.linkColor === void 0) {
+  if (options.backgroundColor === void 0 && options.contentBackgroundColor === void 0 && options.linkColor === void 0 && options.buttonColor === void 0 && options.buttonTextColor === void 0) {
     return void 0;
   }
   return {
     ...options.backgroundColor !== void 0 ? { backgroundColor: options.backgroundColor } : {},
     ...options.contentBackgroundColor !== void 0 ? { contentBackgroundColor: options.contentBackgroundColor } : {},
-    ...options.linkColor !== void 0 ? { linkColor: options.linkColor } : {}
+    ...options.linkColor !== void 0 ? { linkColor: options.linkColor } : {},
+    ...options.buttonColor !== void 0 ? { buttonColor: options.buttonColor } : {},
+    ...options.buttonTextColor !== void 0 ? { buttonTextColor: options.buttonTextColor } : {}
   };
 }
 function resolveAudience(options) {
@@ -12259,7 +12468,10 @@ function registerCampaignsCommands(program2) {
   ).option("--template-id <id>", "look template the Markdown body renders into").option("--from-name <name>", "From display name").option("--reply-to <email>", "Reply-To address (requires --from-name)").option(
     "--from-email <email>",
     "custom From on the workspace's verified sending domain (requires --from-name); omit for the platform sender"
-  ).option("--segment <segmentId>", "send to a saved audience segment (re-resolved at send time)").option("--all-subscribed", "send to every subscribed client (the default audience)").option("--background-color <hex>", "theme: page background behind the content column").option("--content-background-color <hex>", "theme: content column (card) background").option("--link-color <hex>", "theme: link color inside the content column").action(
+  ).option("--segment <segmentId>", "send to a saved audience segment (re-resolved at send time)").option("--all-subscribed", "send to every subscribed client (the default audience)").option("--background-color <hex>", "theme: page background behind the content column").option("--content-background-color <hex>", "theme: content column (card) background").option("--link-color <hex>", "theme: link color inside the content column").option(
+    "--button-color <hex>",
+    "theme: background of buttons without their own color (wins over the look default)"
+  ).option("--button-text-color <hex>", "theme: text color of buttons without their own color").action(
     async (options, command) => {
       const flags = getGlobalFlags(command);
       const contentMarkdown = resolveContent(options);
@@ -12287,7 +12499,10 @@ function registerCampaignsCommands(program2) {
       });
     }
   );
-  campaigns.command("update").description("Update a DRAFT campaign (campaigns past draft are immutable except cancel)").argument("<id>", "campaign id").option("--name <name>", "new internal label").option("--subject <subject>", "new email subject line").option("--preheader <text>", "new preview text").option("--content <markdown>", "new campaign body as Markdown (replaces the whole body)").option("--content-file <path>", "read the new campaign body (Markdown) from a file").option("--html-file <path>", "read the new HTML document of a designed e-mail from a file").option("--template-id <id>", "look template for the body (`none` = the default shell)").option("--from-name <name>", "new From display name").option("--reply-to <email>", "new Reply-To address (requires --from-name)").option("--from-email <email>", "new custom From address (requires --from-name)").option("--segment <segmentId>", "switch the audience to a saved segment").option("--all-subscribed", "switch the audience to every subscribed client").option("--background-color <hex>", "theme: page background behind the content column").option("--content-background-color <hex>", "theme: content column (card) background").option("--link-color <hex>", "theme: link color inside the content column").action(
+  campaigns.command("update").description("Update a DRAFT campaign (campaigns past draft are immutable except cancel)").argument("<id>", "campaign id").option("--name <name>", "new internal label").option("--subject <subject>", "new email subject line").option("--preheader <text>", "new preview text").option("--content <markdown>", "new campaign body as Markdown (replaces the whole body)").option("--content-file <path>", "read the new campaign body (Markdown) from a file").option("--html-file <path>", "read the new HTML document of a designed e-mail from a file").option("--template-id <id>", "look template for the body (`none` = the default shell)").option("--from-name <name>", "new From display name").option("--reply-to <email>", "new Reply-To address (requires --from-name)").option("--from-email <email>", "new custom From address (requires --from-name)").option("--segment <segmentId>", "switch the audience to a saved segment").option("--all-subscribed", "switch the audience to every subscribed client").option("--background-color <hex>", "theme: page background behind the content column").option("--content-background-color <hex>", "theme: content column (card) background").option("--link-color <hex>", "theme: link color inside the content column").option(
+    "--button-color <hex>",
+    "theme: background of buttons without their own color (wins over the look default)"
+  ).option("--button-text-color <hex>", "theme: text color of buttons without their own color").action(
     async (id, options, command) => {
       const flags = getGlobalFlags(command);
       const input = {};
@@ -12330,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(
@@ -12339,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))) {
@@ -12374,6 +12608,28 @@ function registerCampaignsCommands(program2) {
       const { stats } = result.campaign;
       process.stdout.write(
         `Cancelled campaign ${result.campaign.id} \u2014 ${stats.sent} recipient${stats.sent === 1 ? " was" : "s were"} already sent to before the cancel.
+`
+      );
+    });
+  });
+  campaigns.command("resend").description(
+    "Follow up a SENT campaign: builds a segment over its non-openers (or non-clickers) and creates a DRAFT copy aimed at it - nothing is sent; review and `campaigns send` the draft"
+  ).argument("<id>", "campaign id (must be sent)").option("--target <target>", "not-opened (default) | not-clicked").action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    let target;
+    if (options.target !== void 0) {
+      if (options.target !== "not-opened" && options.target !== "not-clicked") {
+        process.stderr.write("--target must be not-opened or not-clicked\n");
+        process.exitCode = 1;
+        return;
+      }
+      target = options.target;
+    }
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.resendEmailCampaign(id, target);
+    emit(flags, result, () => {
+      process.stdout.write(
+        `Draft ${result.campaign.id} "${result.campaign.name}" created for segment "${result.segment.name}" (${result.segment.id}${result.segmentReused ? ", reused" : ""}). Nothing was sent - review it, then \`campaigns send <id> --confirm\`.
 `
       );
     });
@@ -13341,7 +13597,7 @@ function parsePositiveInt4(value, flag) {
   }
   return n;
 }
-function collectRepeatable(value, previous) {
+function collectRepeatable2(value, previous) {
   return [...previous, value];
 }
 function parseCsv(raw) {
@@ -13825,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);
@@ -13836,6 +14092,7 @@ Next page: --cursor ${page.nextCursor}
     let created = 0;
     let existing = 0;
     let invalid = 0;
+    let overLimit = 0;
     for (let offset = 0; offset < contacts.length; offset += IMPORT_CHUNK_SIZE) {
       const chunk2 = contacts.slice(offset, offset + IMPORT_CHUNK_SIZE);
       if (!flags.json && contacts.length > IMPORT_CHUNK_SIZE) {
@@ -13849,13 +14106,18 @@ Next page: --cursor ${page.nextCursor}
       created += page.created;
       existing += page.existing;
       invalid += page.invalid;
+      overLimit += page.overLimit ?? 0;
     }
-    const summary = { results, created, existing, invalid };
+    const summary = { results, created, existing, invalid, overLimit };
     emit(flags, summary, () => {
       process.stdout.write(
-        `Imported ${contacts.length} row${contacts.length === 1 ? "" : "s"} from ${csvFile}: ${created} created, ${existing} already existed, ${invalid} invalid.
-`
+        `Imported ${contacts.length} row${contacts.length === 1 ? "" : "s"} from ${csvFile}: ${created} created, ${existing} already existed, ${invalid} invalid` + (overLimit > 0 ? `, ${overLimit} over the plan's contacts limit` : "") + ".\n"
       );
+      if (overLimit > 0) {
+        process.stdout.write(
+          "The plan's contacts limit is reached \u2014 upgrade the plan to import the remaining rows.\n"
+        );
+      }
       const problems = results.filter((r) => r.status !== "created" && r.status !== "exists");
       if (problems.length > 0) {
         process.stdout.write("\nRows that were not imported:\n");
@@ -14945,11 +15207,11 @@ Next page: --cursor ${result.nextCursor}
   member.command("mute").description("Mute (timeout) a member for N minutes (1..40320 = 28 days)").argument("<communityId>", "community id").argument("<memberId>", "member id (wcid)").requiredOption("--minutes <n>", "mute duration in minutes (1..40320)").action(
     async (communityId, memberId, options, command) => {
       const flags = getGlobalFlags(command);
-      const minutes = Number.parseInt(options.minutes, 10);
-      if (!Number.isInteger(minutes) || minutes < 1 || minutes > 40320) {
+      const minutes2 = Number.parseInt(options.minutes, 10);
+      if (!Number.isInteger(minutes2) || minutes2 < 1 || minutes2 > 40320) {
         throw new Error(`Invalid --minutes: ${options.minutes} (expected an integer 1..40320).`);
       }
-      const result = await clientFor(flags).muteCommunityMember(communityId, memberId, minutes);
+      const result = await clientFor(flags).muteCommunityMember(communityId, memberId, minutes2);
       emit(flags, result, () => {
         process.stdout.write(`Muted member ${memberId} until ${result.mutedUntil}.
 `);
@@ -15737,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) {
@@ -16345,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) => {
@@ -16361,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) => {
@@ -16545,7 +16807,7 @@ function parseIsoDate(value, flag) {
   }
   return value;
 }
-function collectRepeatable3(value, previous) {
+function collectRepeatable4(value, previous) {
   return [...previous, value];
 }
 function registerDiscountsCommands(program2) {
@@ -16570,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) => {
@@ -16620,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) => {
@@ -17285,6 +17547,10 @@ function printSignupFormDetail(form) {
 `);
   process.stdout.write(`  Redirect: ${form.redirectUrl ?? "(success state on the form)"}
 `);
+  process.stdout.write(
+    `  After confirmation: ${form.confirmationRedirectUrl ?? "(platform confirmation page)"}
+`
+  );
   if (form.confirmationEmail) {
     process.stdout.write(
       `  Confirmation email overrides: subject ${form.confirmationEmail.subject ?? "(default)"}, intro ${form.confirmationEmail.intro ?? "(default)"}
@@ -17342,6 +17608,9 @@ async function buildFormUpdateInput(client, formId, options) {
     input.optInMode = parseChoice2(options.optIn, OPT_IN_MODES, "--opt-in");
   }
   if (options.redirect !== void 0) input.redirectUrl = orNull3(options.redirect);
+  if (options.confirmationRedirect !== void 0) {
+    input.confirmationRedirectUrl = orNull3(options.confirmationRedirect);
+  }
   let current;
   const fetchCurrent = async () => {
     current ??= await client.getSignupForm(formId);
@@ -17404,7 +17673,10 @@ function registerFormsCommands(program2) {
   });
   forms.command("create").description(
     "Create a standalone signup form (double opt-in unless --opt-in single). The full confirmation-email copy is set with `forms update --json`"
-  ).requiredOption("--name <name>", "internal form name").option("--tags <ids>", "comma-separated client-tag ids applied on (confirmed) submission").option("--opt-in <mode>", `opt-in mode (${OPT_IN_MODES.join(" | ")}; default double)`).option("--redirect <url>", "thank-you redirect after a successful submit").option("--header <text>", "config: header text shown above the form").option("--description <text>", "config: description under the header").option("--button-text <text>", "config: submit button label").option("--success-message <text>", "config: message shown after a successful submit").option("--variant <variant>", `config: layout variant (${FORM_VARIANTS.join(" | ")})`).option("--phone <mode>", `config: phone number field (${PHONE_FIELD_MODES.join(" | ")})`).option(
+  ).requiredOption("--name <name>", "internal form name").option("--tags <ids>", "comma-separated client-tag ids applied on (confirmed) submission").option("--opt-in <mode>", `opt-in mode (${OPT_IN_MODES.join(" | ")}; default double)`).option("--redirect <url>", "thank-you redirect after a successful submit").option(
+    "--confirmation-redirect <url>",
+    "where the confirmation e-mail click lands (double opt-in): lead magnet, OTO, calendar"
+  ).option("--header <text>", "config: header text shown above the form").option("--description <text>", "config: description under the header").option("--button-text <text>", "config: submit button label").option("--success-message <text>", "config: message shown after a successful submit").option("--variant <variant>", `config: layout variant (${FORM_VARIANTS.join(" | ")})`).option("--phone <mode>", `config: phone number field (${PHONE_FIELD_MODES.join(" | ")})`).option(
     "--sms-consent <on|off>",
     "config: marketing-SMS consent checkbox (needs the phone field)"
   ).option(
@@ -17422,7 +17694,8 @@ function registerFormsCommands(program2) {
         tagIds: options.tags !== void 0 ? parseCsv2(options.tags) : void 0,
         config,
         ...optInMode !== void 0 ? { optInMode } : {},
-        ...options.redirect !== void 0 ? { redirectUrl: options.redirect } : {}
+        ...options.redirect !== void 0 ? { redirectUrl: options.redirect } : {},
+        ...options.confirmationRedirect !== void 0 ? { confirmationRedirectUrl: options.confirmationRedirect } : {}
       });
       emit(flags, result, () => {
         process.stdout.write(
@@ -17434,7 +17707,10 @@ function registerFormsCommands(program2) {
   );
   forms.command("update").description(
     "Update a standalone form. The embed config is REPLACED IN FULL by the API \u2014 flat config flags are merged over the current config for you; a --json `config` object is sent as the full replacement (flat flags still win). `none` clears nullable fields."
-  ).argument("<id>", "form id").option("--name <name>", "internal form name").option("--tags <ids>", "comma-separated client-tag ids (full replace; empty string clears)").option("--opt-in <mode>", `opt-in mode (${OPT_IN_MODES.join(" | ")})`).option("--redirect <url|none>", "thank-you redirect after submit; `none` clears it").option("--confirmation-subject <text>", "double-opt-in confirmation email subject override").option("--confirmation-intro <text>", "double-opt-in confirmation email intro override").option("--clear-confirmation-email", "restore the workspace default confirmation copy").option("--header <text>", "config: header text shown above the form").option("--description <text>", "config: description under the header").option("--button-text <text>", "config: submit button label").option("--success-message <text>", "config: message shown after a successful submit").option("--variant <variant>", `config: layout variant (${FORM_VARIANTS.join(" | ")})`).option("--phone <mode>", `config: phone number field (${PHONE_FIELD_MODES.join(" | ")})`).option(
+  ).argument("<id>", "form id").option("--name <name>", "internal form name").option("--tags <ids>", "comma-separated client-tag ids (full replace; empty string clears)").option("--opt-in <mode>", `opt-in mode (${OPT_IN_MODES.join(" | ")})`).option("--redirect <url|none>", "thank-you redirect after submit; `none` clears it").option(
+    "--confirmation-redirect <url|none>",
+    "where the confirmation e-mail click lands (double opt-in); `none` restores the platform page"
+  ).option("--confirmation-subject <text>", "double-opt-in confirmation email subject override").option("--confirmation-intro <text>", "double-opt-in confirmation email intro override").option("--clear-confirmation-email", "restore the workspace default confirmation copy").option("--header <text>", "config: header text shown above the form").option("--description <text>", "config: description under the header").option("--button-text <text>", "config: submit button label").option("--success-message <text>", "config: message shown after a successful submit").option("--variant <variant>", `config: layout variant (${FORM_VARIANTS.join(" | ")})`).option("--phone <mode>", `config: phone number field (${PHONE_FIELD_MODES.join(" | ")})`).option(
     "--sms-consent <on|off>",
     "config: marketing-SMS consent checkbox (needs the phone field)"
   ).option(
@@ -19018,6 +19294,78 @@ join again to refresh it.
   });
 }
 
+// src/commands/liveRooms/index.ts
+var minutes = (seconds) => `${Math.round(seconds / 60)} min`;
+var percent = (part, whole) => whole > 0 ? `${Math.round(part / whole * 100)}%` : "-";
+function describeSchedule(room) {
+  if (!room.schedule) return "fixed";
+  const until = room.schedule.until ? ` until ${room.schedule.until}` : "";
+  return `every ${room.schedule.everyMinutes} min${until}`;
+}
+function registerLiveRoomsCommands(program2) {
+  const liveRooms = program2.command("live-rooms").description(
+    "Live rooms (webinar rooms, incl. rolling autowebinar sessions) \u2014 list and attendance; rooms are managed in the dashboard"
+  );
+  liveRooms.command("list").description("List live rooms (latest start first)").action(async (_, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.listLiveRooms();
+    emit(flags, result, () => {
+      printTable(
+        result.rooms.map((room) => ({
+          id: room.id,
+          title: room.title,
+          source: room.source,
+          status: room.endedAt ? "ended" : room.status,
+          startAt: room.startAt,
+          schedule: describeSchedule(room),
+          access: room.access.everyone ? "everyone" : "restricted"
+        })),
+        ["id", "title", "source", "status", "startAt", "schedule", "access"]
+      );
+    });
+  });
+  liveRooms.command("attendance").description("A room's attendance per session; --session adds that session's viewers").argument("<roomId>", "live room id (from live-rooms list)").option("--session <iso>", "ISO start of one session to list its attendees").action(async (roomId, options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.getLiveRoomAttendance(roomId, options.session);
+    emit(flags, result, () => {
+      printTable(
+        result.sessions.map((session) => ({
+          session: session.sessionStartAt,
+          attendees: session.attendees,
+          identified: session.identified,
+          avgWatched: `${minutes(session.averageWatchedSeconds)} (${percent(
+            session.averageWatchedSeconds,
+            session.durationSeconds
+          )})`,
+          toEnd: `${session.watchedToEnd} (${percent(session.watchedToEnd, session.attendees)})`,
+          sawOffer: session.sawOffer,
+          clickedOffer: session.clickedOffer
+        })),
+        ["session", "attendees", "identified", "avgWatched", "toEnd", "sawOffer", "clickedOffer"]
+      );
+      if (options.session !== void 0) {
+        process.stdout.write(`
+Viewers of ${options.session}:
+`);
+        printTable(
+          result.attendees.map((attendee) => ({
+            who: attendee.displayName ?? attendee.email ?? attendee.attendee,
+            email: attendee.email ?? "",
+            clientId: attendee.clientId ?? "",
+            watched: minutes(attendee.watchedSeconds),
+            reached: minutes(attendee.maxPositionSeconds),
+            firstSeenAt: attendee.firstSeenAt,
+            offer: attendee.purchasedAt ? "bought" : attendee.offerClickedAt ? "clicked" : attendee.offerSeenAt ? "saw" : ""
+          })),
+          ["who", "email", "clientId", "watched", "reached", "firstSeenAt", "offer"]
+        );
+      }
+    });
+  });
+}
+
 // src/commands/media/index.ts
 import { existsSync, readFileSync as readFileSync17, writeFileSync as writeFileSync4 } from "fs";
 import { readFile, stat as stat3 } from "fs/promises";
@@ -22419,6 +22767,100 @@ function registerMediaCommands(program2) {
       });
     }
   );
+  const captions = media.command("captions").description("Caption (subtitle) tracks of a video - one per language");
+  captions.command("list").description("List a video's caption tracks (language, source, status)").argument("<mediaId>", "video media item id").action(async (mediaId, _options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.listMediaCaptions(mediaId);
+    emit(flags, result, () => {
+      if (result.tracks.length === 0) {
+        process.stdout.write(`No caption tracks on ${mediaId}.
+`);
+        return;
+      }
+      printTable(
+        result.tracks.map((track) => ({
+          lang: track.srclang,
+          label: track.label,
+          source: track.source,
+          status: track.recorded ? track.status : "not recorded",
+          updated: track.updatedAt ?? ""
+        })),
+        ["lang", "label", "source", "status", "updated"]
+      );
+    });
+  });
+  captions.command("upload").description(
+    "Add or replace the subtitles in one language from a .vtt or .srt file (UTF-8, up to 2 MB). The transcript's own language is refused - edit the transcript instead."
+  ).argument("<mediaId>", "video media item id").requiredOption("--lang <code>", "language code of the track, e.g. en, de, pt-br").requiredOption("--file <path>", ".vtt or .srt file").option("--label <label>", "track name in the player's menu (default: the language name)").action(
+    async (mediaId, options, command) => {
+      const flags = getGlobalFlags(command);
+      if (!existsSync(options.file)) {
+        process.stderr.write(`File not found: ${options.file}
+`);
+        process.exitCode = 1;
+        return;
+      }
+      const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+      const result = await client.uploadMediaCaption(mediaId, {
+        srclang: options.lang,
+        content: readFileSync17(options.file, "utf8"),
+        ...options.label ? { label: options.label } : {}
+      });
+      emit(flags, result, () => {
+        process.stdout.write(
+          result.track.status === "failed" ? `Stored the ${result.track.srclang} file, but the player refused it - run the same command again in a moment.
+` : `Captions ${result.track.srclang} (${result.track.label}) are live on ${mediaId}.
+`
+        );
+      });
+    }
+  );
+  captions.command("download").description("Print (or save) one caption track as WebVTT").argument("<mediaId>", "video media item id").requiredOption("--lang <code>", "language code of the track").option("--out <file>", "write the .vtt to a file instead of stdout").action(async (mediaId, options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.getMediaCaption(mediaId, options.lang);
+    if (options.out) {
+      writeFileSync4(options.out, result.content, "utf8");
+      emit(flags, { mediaId, srclang: result.srclang, out: options.out }, () => {
+        process.stdout.write(`Wrote the ${result.srclang} captions to ${options.out}.
+`);
+      });
+      return;
+    }
+    emit(flags, result, () => {
+      process.stdout.write(result.content);
+    });
+  });
+  captions.command("delete").description("Remove an uploaded caption track (it disappears from the player)").argument("<mediaId>", "video media item id").requiredOption("--lang <code>", "language code of the track").option("--confirm", "required: removes the track from the live player").action(
+    async (mediaId, options, command) => {
+      const flags = getGlobalFlags(command);
+      if (!options.confirm) {
+        process.stderr.write(
+          "Refusing to delete without --confirm (the track disappears from the player).\n"
+        );
+        process.exitCode = 1;
+        return;
+      }
+      const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+      const result = await client.deleteMediaCaption(mediaId, options.lang);
+      emit(flags, result, () => {
+        process.stdout.write(`Removed the ${result.srclang} captions from ${mediaId}.
+`);
+      });
+    }
+  );
+  captions.command("regenerate").description("Push the transcript's caption track to the player again").argument("<mediaId>", "video media item id").action(async (mediaId, _options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.regenerateMediaCaption(mediaId);
+    emit(flags, result, () => {
+      process.stdout.write(
+        result.track.status === "failed" ? "The player refused the transcript captions - try again in a moment.\n" : `Transcript captions (${result.track.srclang}) pushed to the player.
+`
+      );
+    });
+  });
   media.command("transcript").description(
     "Print a video transcript (plain text, or full JSON with --words / --json). Videos without a transcript yet report so; non-video media is a 404."
   ).argument("<mediaId>", "video media item id").option("--words", "include word-level timings (large payload; implies JSON output)").option("--out <file>", "write the transcript to a file instead of stdout").action(
@@ -22595,6 +23037,7 @@ var ACCESS_STRATEGIES = [
   "from_subscribe_date"
 ];
 var DOUBLE_OPT_INS = ["none", "external"];
+var DELIVERIES = ["zanfia", "integration"];
 function assertOneOf2(value, allowed, flag) {
   if (!allowed.includes(value)) {
     throw new Error(`Invalid ${flag}: ${value}. Use one of: ${allowed.join(", ")}`);
@@ -22630,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) {
@@ -22652,9 +23095,10 @@ function registerNewslettersCommands(program2) {
             slug: issue.slug,
             status: issue.status,
             landing: issue.landingPageVisibility ?? "",
+            send: issue.sendStatus ?? "",
             createdAt: issue.createdAt
           })),
-          ["id", "subject", "slug", "status", "landing", "createdAt"]
+          ["id", "subject", "slug", "status", "landing", "send", "createdAt"]
         );
         if (page.nextCursor) {
           process.stdout.write(`
@@ -22838,6 +23282,90 @@ Next: \`newsletters issues draft save ${productId} ${issue.id} --content <markdo
       });
     }
   );
+  issues.command("send").description(
+    "\u26A0\uFE0F SENDS the issue from Zanfia to every subscriber of the newsletter product \u2014 REAL bulk e-mail, IRREVERSIBLE once delivered (`issues cancel` only stops the remaining sends). Sending is publishing: a staged draft is promoted first. The newsletter must send from Zanfia (`settings update --delivery zanfia`). Requires --confirm. Omit --at to send NOW; --at schedules (max 30 days out)."
+  ).argument("<productId>", "newsletter product id").argument("<issueId>", "issue id").option(
+    "--at <isoTimestamp>",
+    "schedule the send (ISO, max 30 days out) instead of sending now"
+  ).option("--confirm", "required \u2014 acknowledge this e-mails the subscribers for real").action(
+    async (productId, issueId, options, command) => {
+      const flags = getGlobalFlags(command);
+      if (!options.confirm) {
+        throw new Error(
+          `Refusing to send without --confirm. \`newsletters issues send\` e-mails EVERY subscriber of the newsletter for real and cannot be undone once mail is delivered. Re-run with --confirm to proceed (check the issue first with \`newsletters issues list --product ${productId}\`).`
+        );
+      }
+      if (options.at !== void 0 && Number.isNaN(Date.parse(options.at))) {
+        throw new Error(
+          `Invalid --at timestamp: ${options.at} (expected ISO, e.g. 2026-07-15T09:00:00Z)`
+        );
+      }
+      const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+      const result = await client.sendNewsletterIssue(productId, issueId, {
+        ...options.at !== void 0 ? { scheduledAt: options.at } : {}
+      });
+      emit(flags, result, () => {
+        const { send } = result;
+        if (send.scheduledAt) {
+          process.stdout.write(
+            `Issue ${result.issueId} scheduled for ${send.scheduledAt} \u2014 stop it before then with \`newsletters issues cancel ${productId} ${issueId} --confirm\`.
+`
+          );
+        } else {
+          process.stdout.write(
+            `Issue ${result.issueId} is sending now (status: ${send.status}). \`newsletters issues cancel\` can only stop the remaining sends.
+`
+          );
+        }
+      });
+    }
+  );
+  issues.command("cancel").description(
+    "Cancel a scheduled or in-flight issue send \u2014 remaining sends stop; delivered mail is out. Requires --confirm."
+  ).argument("<productId>", "newsletter product id").argument("<issueId>", "issue id").option("--confirm", "required \u2014 acknowledge the send is stopped").action(
+    async (productId, issueId, options, command) => {
+      const flags = getGlobalFlags(command);
+      if (!options.confirm) {
+        throw new Error(
+          "Refusing to cancel without --confirm. Re-run with --confirm to un-queue the scheduled send or stop the one in flight."
+        );
+      }
+      const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+      const result = await client.cancelNewsletterIssueSend(productId, issueId);
+      emit(flags, result, () => {
+        process.stdout.write(
+          result.send ? `Stopped the send of issue ${result.issueId} (status: ${result.send.status}).
+` : `Un-queued the send of issue ${result.issueId}; it is a draft again.
+`
+        );
+      });
+    }
+  );
+  issues.command("report").description("Progress and delivery / engagement stats of an issue\u2019s native send").argument("<productId>", "newsletter product id").argument("<issueId>", "issue id").action(async (productId, issueId, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.getNewsletterIssueSendReport(productId, issueId);
+    emit(flags, result, () => {
+      if (!result.send) {
+        process.stdout.write(`Issue ${result.issueId} was never sent from Zanfia.
+`);
+        return;
+      }
+      const { send, report } = result;
+      process.stdout.write(
+        `Issue ${result.issueId}: ${send.status}` + (send.scheduledAt ? ` (scheduled for ${send.scheduledAt})` : "") + (send.recipientCount !== null ? `, ${send.recipientCount} recipients` : "") + "\n"
+      );
+      if (report) {
+        printTable(
+          Object.entries(report.stats).map(([stat4, value]) => ({
+            stat: stat4,
+            value: String(value ?? "")
+          })),
+          ["stat", "value"]
+        );
+      }
+    });
+  });
   issues.command("delete").description(
     "\u26A0\uFE0F PERMANENTLY delete an archived issue \u2014 a HARD delete with no undo. Requires --confirm."
   ).argument("<issueId>", "archived issue id").requiredOption("--product <id>", "newsletter product id").option("--confirm", "required \u2014 acknowledge the issue is removed permanently").action(
@@ -22856,9 +23384,11 @@ Next: \`newsletters issues draft save ${productId} ${issue.id} --content <markdo
       });
     }
   );
-  const settings = newsletters.command("settings").description("Edit newsletter settings (archive, archive inbox, double opt-in, client tags)");
+  const settings = newsletters.command("settings").description(
+    "Edit newsletter settings (archive, archive inbox, double opt-in, client tags, delivery, sender)"
+  );
   settings.command("update").description(
-    "Patch newsletter settings. Archive flags merge per-field; --archive-inbox, --double-opt-in and --client-tag replace their whole block. At least one change is required."
+    "Patch newsletter settings. Archive and sender flags merge per-field; --archive-inbox, --double-opt-in and --client-tag replace their whole block. At least one change is required."
   ).requiredOption("--product <id>", "newsletter product id").option("--archive-enabled <on|off>", "archive: enable/disable the public archive").option("--archive-access <strategy>", `archive: ${ACCESS_STRATEGIES.join("|")}`).option(
     "--publication-delay <days|none>",
     'archive: days before a new issue goes public; "none" = immediately'
@@ -22874,11 +23404,20 @@ 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,
     []
-  ).action(
+  ).option(
+    "--delivery <mode>",
+    `who sends the issues: ${DELIVERIES.join("|")} (zanfia = native sending from the product)`
+  ).option(
+    "--from-name <name>",
+    'sender: From display name of native sends ("" = workspace default)'
+  ).option("--reply-to <email>", 'sender: Reply-To of native sends ("" = workspace default)').option("--clear-sender", "sender: drop both defaults (workspace defaults apply)").action(
     async (options, command) => {
       const flags = getGlobalFlags(command);
+      if (options.clearSender && (options.fromName !== void 0 || options.replyTo !== void 0)) {
+        throw new Error("Use either --clear-sender or --from-name/--reply-to, not both.");
+      }
       const archive = {};
       if (options.archiveEnabled !== void 0) {
         archive.enabled = parseBool2(options.archiveEnabled, "--archive-enabled");
@@ -22922,6 +23461,17 @@ Next: \`newsletters issues draft save ${productId} ${issue.id} --content <markdo
         input.doubleOptIn = assertOneOf2(options.doubleOptIn, DOUBLE_OPT_INS, "--double-opt-in");
       }
       if (options.clientTag.length > 0) input.clientTags = options.clientTag;
+      if (options.delivery !== void 0) {
+        input.delivery = assertOneOf2(options.delivery, DELIVERIES, "--delivery");
+      }
+      if (options.clearSender) {
+        input.sender = null;
+      } else if (options.fromName !== void 0 || options.replyTo !== void 0) {
+        input.sender = {
+          ...options.fromName !== void 0 ? { fromName: options.fromName || null } : {},
+          ...options.replyTo !== void 0 ? { replyTo: options.replyTo || null } : {}
+        };
+      }
       if (Object.keys(input).length === 0) {
         throw new Error(
           "Nothing to update \u2014 pass at least one settings flag (see `newsletters settings update --help`)."
@@ -24544,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) {
@@ -24654,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;
@@ -24742,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(
@@ -24751,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) => {
@@ -25086,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) => {
@@ -25282,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);
@@ -26011,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) {
@@ -26091,48 +26660,54 @@ function resolveConditions(options) {
     }
     conditions.push({ field: "emailSubscription", operator: "is", status });
   }
+  if (options.notOpened !== void 0) {
+    conditions.push({ field: "campaign", operator: "not-opened", campaignId: options.notOpened });
+  }
+  if (options.notClicked !== void 0) {
+    conditions.push({ field: "campaign", operator: "not-clicked", campaignId: options.notClicked });
+  }
   return conditions;
 }
 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>",
@@ -26140,6 +26715,12 @@ function withConditionOptions(command) {
   ).option("--spent-lte <minorUnits>", "lifetime spend at most this (minor units)").option(
     "--subscription <status>",
     `marketing-email subscription state is (${SUBSCRIPTION_STATUSES2.join(" | ")})`
+  ).option(
+    "--not-opened <campaignId>",
+    "received this SENT campaign and never opened it (the resend-to-non-openers audience)"
+  ).option(
+    "--not-clicked <campaignId>",
+    "received this SENT campaign and never clicked a link in it"
   ).option(
     "--json-file <path>",
     "read the conditions as a JSON array from a file instead of flags"
@@ -26166,6 +26747,8 @@ function describeCondition(condition) {
       return `sms consent is ${condition.status}`;
     case "phoneNumber":
       return condition.operator === "has" ? "has a phone number" : "has no phone number";
+    case "campaign":
+      return `${condition.operator.replace("-", " ")} campaign ${condition.campaignId}`;
   }
 }
 function registerSegmentsCommands(program2) {
@@ -28474,6 +29057,10 @@ function registerWorkflowAuthoringCommands(workflows) {
   ).option(
     "--trigger <eventType>",
     "business event that starts it, e.g. product.ProductPurchased (see `workflows list` for examples)"
+  ).option(
+    "--kind <kind>",
+    "transactional (default for purchase/access triggers: no unsubscribe link, reaches everyone) or marketing (unsubscribe link + headers, e-mail/SMS steps skipped for unsubscribed contacts); omitted = derived from the triggers at publish",
+    parseWorkflowKind
   ).action(
     async (options, command) => {
       const flags = getGlobalFlags(command);
@@ -28481,6 +29068,7 @@ function registerWorkflowAuthoringCommands(workflows) {
       if (options.description !== void 0) input.description = options.description;
       if (options.product !== void 0) input.productIds = options.product;
       if (options.trigger !== void 0) input.triggerEventType = options.trigger;
+      if (options.kind !== void 0) input.kind = options.kind;
       const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
       const result = await client.createAutomation(input);
       emit(flags, result, () => {
@@ -28535,6 +29123,10 @@ function registerWorkflowAuthoringCommands(workflows) {
     "--product <ids>",
     "also replace the product scope (comma-separated ids)",
     parseCommaList("--product")
+  ).option(
+    "--kind <kind>",
+    "also set the kind: transactional or marketing (see `workflows create --help`)",
+    parseWorkflowKind
   ).action(
     async (automationId, options, command) => {
       const flags = getGlobalFlags(command);
@@ -28543,7 +29135,8 @@ function registerWorkflowAuthoringCommands(workflows) {
         draft: options.json,
         ...options.name !== void 0 ? { name: options.name } : {},
         ...options.description !== void 0 ? { description: options.description } : {},
-        ...options.product !== void 0 ? { productIds: options.product } : {}
+        ...options.product !== void 0 ? { productIds: options.product } : {},
+        ...options.kind !== void 0 ? { kind: options.kind } : {}
       }).catch(withGraphHint);
       emit(flags, result, () => {
         if (result.issues.length > 0) {
@@ -28656,12 +29249,13 @@ function registerWorkflowsCommands(program2) {
           id: w.id,
           name: w.name,
           status: w.status,
+          kind: w.kind,
           triggers: w.triggers.join(", "),
           products: formatProductScope(w),
           runsThisMonth: w.runsThisMonth,
           lastRun: w.lastRunAt ?? ""
         })),
-        ["id", "name", "status", "triggers", "products", "runsThisMonth", "lastRun"]
+        ["id", "name", "status", "kind", "triggers", "products", "runsThisMonth", "lastRun"]
       );
     });
   });
@@ -28797,6 +29391,8 @@ function printWorkflowSummary(workflow) {
   if (workflow.description) process.stdout.write(`  Description: ${workflow.description}
 `);
   process.stdout.write(`  Status: ${workflow.status}
+`);
+  process.stdout.write(`  Kind: ${workflow.kind}
 `);
   process.stdout.write(`  Triggers: ${workflow.triggers.join(", ")}
 `);
@@ -28833,6 +29429,7 @@ var GRAPH_ACTION_LABELS = {
   createCommunityPost: "Create community post",
   updateClientTags: "Update client tags",
   setEmailSubscription: "Set email subscription",
+  openClientDeadline: "Open deadline window",
   requestTestimonial: "Request testimonial"
 };
 var GRAPH_NODE_KINDS = /* @__PURE__ */ new Set([
@@ -29069,6 +29666,12 @@ function describeAction(node, templateNames) {
       const sub = isRecord2(node.config.emailSubscription) ? node.config.emailSubscription : {};
       return `${label} \u2014 ${optionalString(sub.status) ?? "?"}`;
     }
+    case "openClientDeadline": {
+      const deadline = isRecord2(node.config.clientDeadline) ? node.config.clientDeadline : {};
+      const amount = typeof deadline.amount === "number" ? String(deadline.amount) : "?";
+      const endTime = optionalString(deadline.endTime);
+      return `${label} \u2014 ${optionalString(deadline.key) ?? "?"} for ${amount} ${optionalString(deadline.unit) ?? "?"}${endTime ? `, closes at ${endTime}` : ""}`;
+    }
     case "requestTestimonial":
       return label;
   }
@@ -29108,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":
@@ -29275,8 +29882,8 @@ function applyShortHelp(program2) {
 
 // src/program.ts
 function resolveCliVersion() {
-  if ("0.3.52".length > 0) {
-    return "0.3.52";
+  if ("0.4.0".length > 0) {
+    return "0.4.0";
   }
   try {
     const raw = readFileSync28(new URL("../package.json", import.meta.url), "utf8");
@@ -29337,6 +29944,7 @@ Signing in \u2014 two roles, two consent pages:
   registerSmsCampaignsCommands(program2);
   registerSegmentsCommands(program2);
   registerFormsCommands(program2);
+  registerLiveRoomsCommands(program2);
   registerTestimonialsCommands(program2);
   registerBrandCommands(program2);
   registerTeamCommands(program2);

package/package.json

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