@zanfia/cli 0.9.0 → 0.10.0

package/dist/index.js

@@ -7380,7 +7380,8 @@ var mockBackend = {
       status: "draft",
       isFree: false,
       createdAt: now(),
-      clientCount: 0
+      clientCount: 0,
+      language: input.language ?? null
     };
     products.push(product);
     return toSummary(product);
@@ -7390,6 +7391,7 @@ var mockBackend = {
     if (!product) return null;
     if (input.name !== void 0) product.name = input.name;
     if (input.description !== void 0) product.description = input.description;
+    if (input.language !== void 0) product.language = input.language;
     return { productId: id };
   },
   archiveProduct(id) {
@@ -7897,6 +7899,9 @@ function createMockClient() {
     async listClientTags() {
       return { count: 0, tags: [] };
     },
+    async listClientCustomFields() {
+      return { count: 0, fields: [] };
+    },
     async createClientTag() {
       throw new ApiError(501, "client tag writes are not available in mock mode");
     },
@@ -8119,6 +8124,7 @@ function createMockClient() {
           przelewy24: false,
           paypal: false,
           dodo: false,
+          tubapay: false,
           manual: null
         },
         sms: { defaultProvider: null, twilio: null, smsapi: null }
@@ -9248,6 +9254,7 @@ function createHttpClient(config) {
     ),
     changeClientEmail: (id, newEmail) => request("POST", `/clients/${encodeURIComponent(id)}/change-email`, { newEmail }),
     listClientTags: () => request("GET", "/clients/tags"),
+    listClientCustomFields: (includeArchived) => request("GET", `/clients/custom-fields${includeArchived ? "?includeArchived=true" : ""}`),
     createClientTag: (input) => request("POST", "/clients/tags", input),
     updateClientTag: (tagId, input) => request("PATCH", `/clients/tags/${encodeURIComponent(tagId)}`, input),
     deleteClientTag: (tagId) => request("DELETE", `/clients/tags/${encodeURIComponent(tagId)}`),
@@ -10157,6 +10164,27 @@ function parseStorefrontVisibility(value) {
   }
   return visibility;
 }
+var PRODUCT_LANGUAGES = ["pl", "en"];
+var PRODUCT_LANGUAGE_NONE = "none";
+function parseProductLanguage(value) {
+  const language = PRODUCT_LANGUAGES.find((candidate) => candidate === value.trim().toLowerCase());
+  if (language === void 0) {
+    throw new Error(
+      `Invalid --language: ${value} (expected one of: ${PRODUCT_LANGUAGES.join(", ")})`
+    );
+  }
+  return language;
+}
+function parseProductLanguageOrNone(value) {
+  if (value.trim().toLowerCase() === PRODUCT_LANGUAGE_NONE) return PRODUCT_LANGUAGE_NONE;
+  const language = PRODUCT_LANGUAGES.find((candidate) => candidate === value.trim().toLowerCase());
+  if (language === void 0) {
+    throw new Error(
+      `Invalid --language: ${value} (expected one of: ${PRODUCT_LANGUAGES.join(", ")}, ${PRODUCT_LANGUAGE_NONE})`
+    );
+  }
+  return language;
+}
 function parseCommaList(flag) {
   return (value) => {
     const items = [
@@ -10327,18 +10355,19 @@ function registerCertificatesCommands(program2) {
     "Course-completion and event-participation certificates \u2014 issue for course or event clients, revoke/reinstate, resend the email, and manage designer templates (`certificates templates \u2026`)"
   );
   certificates.command("list").summary("List certificates").description(
-    "Issued certificates of the workspace (course completion and event participation), newest first, optionally filtered to one product (`productId`); `limit` caps the rows (service default applies). Each row is the credential: public `certificateId` (`cert_\u2026`, the id every certificate write takes), `productType` (`course` / `event`), recipient name/email, product (`courseName`) and issuer names, completion/issued dates, `issuedBy` (manual vs automatic), template id/version, PDF and verification URLs, `status` (active/revoked), `expiresAt` and delivery/engagement signals (email status, views, downloads, LinkedIn add). Also the polling endpoint after issue-certificates \u2014 a newly enqueued client shows up here once its PDF has been rendered."
+    "Issued certificates of the workspace (course completion and event participation), newest first, optionally filtered to one product (`productId`); `limit` caps the rows per page (service default applies) and `nextCursor` (pass it back as `cursor`) continues the list. Each row is the credential: public `certificateId` (`cert_\u2026`, the id every certificate write takes), `productType` (`course` / `event`), recipient name/email, product (`courseName`) and issuer names, completion/issued dates, `issuedBy` (manual vs automatic), template id/version, PDF and verification URLs, `status` (active/revoked), `expiresAt` and delivery/engagement signals (email status, views, downloads, LinkedIn add). Also the polling endpoint after issue-certificates \u2014 a newly enqueued client shows up here once its PDF has been rendered."
   ).option("--product <value>", "Course or event product id \u2014 omit for all products.").option(
     "--limit <n>",
-    "Max rows, newest first (max 500; the service default applies when omitted).",
+    "Max rows per page, newest first (max 500; the service default applies when omitted).",
     parseNumberOption("--limit", NumberFormat.Integer)
-  ).action(async (options, command) => {
+  ).option("--cursor <value>", "`nextCursor` of the previous page; omit for the first page.").action(async (options, command) => {
     const flags = getGlobalFlags(command);
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const params = {};
     const payload = {
       productId: options.product,
-      limit: options.limit
+      limit: options.limit,
+      cursor: options.cursor
     };
     const result = await client.call("GET", "/certificates", params, payload, void 0);
     const rows = tableRowsOf(result, "certificates");
@@ -10699,10 +10728,270 @@ function registerBlogCommands(program2) {
   });
 }
 
+// src/commands/_generated/site-redirects.ts
+var listSiteRedirectsColumns = ["from", "to", "kind"];
+function registerSiteRedirectsCommands(program2) {
+  const siteRedirects = program2.command("site-redirects");
+  siteRedirects.description(
+    "The site's 301 redirect map (Your site \u2192 Redirects): old addresses and where they go; checked by the same rules as the dashboard"
+  );
+  siteRedirects.command("list").summary("List site redirects").description(
+    "The site's 301 redirect map (dashboard: Your site \u2192 Redirects): old addresses of a site moved to Zanfia and where they go now, in map order, plus `max` (the cap). A line fires only when nothing on the site answers the address. `kind` = `exact` (one address) or `folder` (`/news/*`, every address under it). The `from` of a line is its id for update-site-redirect and delete-site-redirect."
+  ).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", "/site/redirects", params, void 0, void 0);
+    const rows = tableRowsOf(result, "redirects");
+    emit(flags, result ?? {}, () => printTable(rows, listSiteRedirectsColumns));
+  });
+  siteRedirects.command("create").summary("Add a site redirect").description(
+    "Adds one line at the end of the site's 301 map; live at once. Refused (400 `site-redirects-refused`, `issues[]` = index, from, to, issue) exactly like the dashboard save: a malformed address (`invalid-from` / `invalid-to`), the home page or an address Zanfia owns (`/blog`, `/p/\u2026`, `/app`: `reserved-from`), the member area (`portal-from`), a published page (`page-exists`), a `from` the map already has (`duplicate`), a chain or a loop (`chain`), `/*` in `to` without a folder `from` (`rest-without-folder`), over 500 lines (`too-many-entries`). Returns the line as stored."
+  ).argument(
+    "<from>",
+    "The old address on the site: a path (`/o-nas`), a full address on the site (`https://example.com/o-nas/`, stored as its path) or a folder ending with `/*` (`/news/*`, every address under it). Query string and `#\u2026` are dropped; case is kept."
+  ).argument(
+    "<to>",
+    "Where it goes: a path on the site (`/o-mnie`; a folder line may end with `/*` to keep the rest of the old address: `/news/*` \u2192 `/blog/*`) or an absolute `https://` address."
+  ).action(async (from, to, _options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {};
+    const payload = {
+      from,
+      to
+    };
+    const result = await client.call("POST", "/site/redirects", params, void 0, payload);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  siteRedirects.command("update").summary("Change a site redirect").description(
+    "Changes one line of the 301 map, picked by its current `from`: `newFrom`, `to` or both; a field not given keeps its value and the line keeps its place. Live at once. 404 `site-redirect-not-found` when no line has that `from`; refused like create-site-redirect (400 `site-redirects-refused` with `issues[]`). Returns the line as stored."
+  ).argument(
+    "<from>",
+    "The line to change, by its current `from` (as list-site-redirects shows it; `/o-nas/` or a full address on the site also match)."
+  ).option(
+    "--new-from <value>",
+    "The old address on the site: a path (`/o-nas`), a full address on the site (`https://example.com/o-nas/`, stored as its path) or a folder ending with `/*` (`/news/*`, every address under it). Query string and `#\u2026` are dropped; case is kept."
+  ).option(
+    "--to <value>",
+    "Where it goes: a path on the site (`/o-mnie`; a folder line may end with `/*` to keep the rest of the old address: `/news/*` \u2192 `/blog/*`) or an absolute `https://` address."
+  ).action(async (from, options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {};
+    const payload = {
+      from,
+      newFrom: options.newFrom,
+      to: options.to
+    };
+    const result = await client.call("PATCH", "/site/redirects", params, void 0, payload);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  siteRedirects.command("delete").summary("Remove a site redirect").description(
+    "Removes one line of the 301 map, picked by its `from` (sent in the JSON body). The old address answers 404 again at once (links to it in search results and old posts break). 404 `site-redirect-not-found` when no line has that `from`. Returns the removed line."
+  ).argument(
+    "<from>",
+    "The line to change, by its current `from` (as list-site-redirects shows it; `/o-nas/` or a full address on the site also match)."
+  ).option(
+    "--confirm",
+    "required \u2014 acknowledge that you want to the old address answers 404 again"
+  ).action(async (from, options, command) => {
+    const flags = getGlobalFlags(command);
+    requireConfirm(options.confirm, "the old address answers 404 again");
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {};
+    const payload = {
+      from
+    };
+    const result = await client.call("DELETE", "/site/redirects", params, void 0, payload);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+}
+
+// src/commands/_generated/popups.ts
+var listPopupsColumns = ["id", "name", "status", "priority", "updatedAt"];
+function registerPopupsCommands(program2) {
+  const popups = program2.command("popups");
+  popups.description(
+    "Pop-ups on the workspace site (Your site \u2192 Pop-ups): a signup form shown on entry or after scrolling, after the cookie decision, never again after a signup"
+  );
+  popups.command("list").summary("List pop-ups").description(
+    "Every pop-up of the workspace site (drafts, active, paused) in priority order: copy, form content, triggers per device, targeting, frequency and schedule. The id source for every other pop-up 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", "/popups", params, void 0, void 0);
+    const rows = tableRowsOf(result, "popups");
+    emit(flags, result ?? {}, () => printTable(rows, listPopupsColumns));
+  });
+  popups.command("create").summary("Create a pop-up").description(
+    "Creates a pop-up as a DRAFT holding a signup form. Without `content.formId` a new standalone signup form named after the pop-up is created (visible in Forms). Defaults: desktop after 10 s on the page, phones after 40 % scroll as a bottom sheet, again after 7 days, all hosted pages except thank-you / download / member pages, hidden for subscribers. Activate it with set-popup-status once it has a title and a button text. Requires the pop-ups feature on the plan (403 otherwise)."
+  ).requiredOption(
+    "--name <value>",
+    "Internal name (panel only); also the name of a provisioned form."
+  ).option(
+    "--priority <n>",
+    "Lower shows first when several pop-ups match a page; default = after the others.",
+    parseNumberOption("--priority", NumberFormat.Integer)
+  ).addOption(
+    new Option(
+      "--language <pl|en|default>",
+      "Built-in labels (close, errors): `pl`, `en` or `default` (= the page language)."
+    ).choices(["pl", "en", "default"])
+  ).option(
+    "--copy <json|file>",
+    "Headline, text, button and image.",
+    parseJsonObjectFileOrInline("--copy")
+  ).option(
+    "--content <json|file>",
+    "What the pop-up holds: a signup form.",
+    parseJsonObjectFileOrInline("--content")
+  ).option("--design <json|file>", "design", parseJsonObjectFileOrInline("--design")).option(
+    "--trigger <json|file>",
+    "When it opens, per device.",
+    parseJsonObjectFileOrInline("--trigger")
+  ).option(
+    "--targeting <json|file>",
+    "Where and for whom.",
+    parseJsonObjectFileOrInline("--targeting")
+  ).option(
+    "--frequency <json|file>",
+    "How often one visitor sees it; never again after a signup. Default every 7 days.",
+    parseJsonObjectFileOrInline("--frequency")
+  ).option(
+    "--schedule <json|file>",
+    "From / to (applied within a few minutes).",
+    parseJsonObjectFileOrInline("--schedule")
+  ).action(async (options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {};
+    const payload = {
+      name: options.name,
+      priority: options.priority,
+      language: options.language,
+      copy: options.copy,
+      content: options.content,
+      design: options.design,
+      trigger: options.trigger,
+      targeting: options.targeting,
+      frequency: options.frequency,
+      schedule: options.schedule
+    };
+    const result = await client.call("POST", "/popups", params, void 0, payload);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  popups.command("get").summary("Pop-up detail").description(
+    "One pop-up in full: status, copy, form content, triggers, targeting, frequency, schedule."
+  ).argument("<id>", "Pop-up id (`popup_\u2026`) from list-popups.").action(async (id, _options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      popupId: id
+    };
+    const result = await client.call("GET", "/popups/:popupId", params, void 0, void 0);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  popups.command("update").summary("Update a pop-up").description(
+    "Partial update of a pop-up: each section sent merges into the current one (copy, content, design, targeting, schedule field by field; a trigger rule, the page list and the frequency are replaced whole). An active pop-up must keep its title, button and form (400 popup-incomplete). Live sites pick changes up within a few minutes."
+  ).argument("<id>", "Pop-up id (`popup_\u2026`) from list-popups.").option("--name <value>", "Internal name (panel only).").option(
+    "--priority <n>",
+    "Lower shows first when several pop-ups match a page; default = after the others.",
+    parseNumberOption("--priority", NumberFormat.Integer)
+  ).addOption(
+    new Option(
+      "--language <pl|en|default>",
+      "Built-in labels (close, errors): `pl`, `en` or `default` (= the page language)."
+    ).choices(["pl", "en", "default"])
+  ).option(
+    "--copy <json|file>",
+    "Headline, text, button and image.",
+    parseJsonObjectFileOrInline("--copy")
+  ).option(
+    "--content <json|file>",
+    "What the pop-up holds: a signup form.",
+    parseJsonObjectFileOrInline("--content")
+  ).option("--design <json|file>", "design", parseJsonObjectFileOrInline("--design")).option(
+    "--trigger <json|file>",
+    "When it opens, per device.",
+    parseJsonObjectFileOrInline("--trigger")
+  ).option(
+    "--targeting <json|file>",
+    "Where and for whom.",
+    parseJsonObjectFileOrInline("--targeting")
+  ).option(
+    "--frequency <json|file>",
+    "How often one visitor sees it; never again after a signup. Default every 7 days.",
+    parseJsonObjectFileOrInline("--frequency")
+  ).option(
+    "--schedule <json|file>",
+    "From / to (applied within a few minutes).",
+    parseJsonObjectFileOrInline("--schedule")
+  ).action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      popupId: id
+    };
+    const payload = {
+      name: options.name,
+      priority: options.priority,
+      language: options.language,
+      copy: options.copy,
+      content: options.content,
+      design: options.design,
+      trigger: options.trigger,
+      targeting: options.targeting,
+      frequency: options.frequency,
+      schedule: options.schedule
+    };
+    const result = await client.call("PATCH", "/popups/:popupId", params, void 0, payload);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  popups.command("status").summary("Activate or pause a pop-up").description(
+    "Activates or pauses a pop-up. Activation needs a title, a button text and an existing signup form (400 popup-incomplete / 404 form-not-found), the pop-ups feature on the plan (403) and a free slot: at most 20 active pop-ups (409 too-many-active-popups). Visitors see it after their cookie decision, by its trigger, once per page view."
+  ).argument("<id>", "Pop-up id (`popup_\u2026`) from list-popups.").argument(
+    "<status>",
+    "`active` shows it on the site (within a few minutes), `paused` takes it off."
+  ).action(async (id, status, _options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      popupId: id
+    };
+    const payload = {
+      status
+    };
+    const result = await client.call(
+      "POST",
+      "/popups/:popupId/status",
+      params,
+      void 0,
+      payload
+    );
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  popups.command("delete").summary("Delete a pop-up").description(
+    "Deletes a pop-up for good; an active one leaves the site within a few minutes. Its form and the signups stay. No undo - prefer pausing."
+  ).argument("<id>", "Pop-up id (`popup_\u2026`) from list-popups.").option("--confirm", "required \u2014 acknowledge that you want to deletes the pop-up for good").action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    requireConfirm(options.confirm, "deletes the pop-up for good");
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      popupId: id
+    };
+    const result = await client.call("DELETE", "/popups/:popupId", params, void 0, void 0);
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+}
+
 // src/commands/_generated/index.ts
 function registerGeneratedCommands(program2) {
   registerCertificatesCommands(program2);
   registerBlogCommands(program2);
+  registerSiteRedirectsCommands(program2);
+  registerPopupsCommands(program2);
 }
 
 // src/commands/ads/index.ts
@@ -13305,7 +13594,8 @@ var CREDENTIAL_PAYMENT_GATEWAYS = [
   "przelewy24",
   "paynow",
   "paypal",
-  "dodo"
+  "dodo",
+  "tubapay"
 ];
 var COMMUNITY_EVENT_LOCATION_TYPES = [
   "online",
@@ -14176,6 +14466,33 @@ Next page: --cursor ${page.nextCursor}
         process.stdout.write(`  Previous emails: ${detail.previousEmails.join(", ")}
 `);
       }
+      const customFields = Object.entries(detail.customFields ?? {});
+      if (customFields.length > 0) {
+        process.stdout.write("  Custom fields:\n");
+        for (const [key, value] of customFields) {
+          process.stdout.write(`    ${key}: ${String(value)}
+`);
+        }
+      }
+    });
+  });
+  clients2.command("fields").description(
+    "List the custom contact fields (key, name, type, options); set values with `clients update --field key=value`"
+  ).option("--include-archived", "also list archived fields (their values are read-only)").action(async (options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.listClientCustomFields(options.includeArchived === true);
+    emit(flags, result, () => {
+      printTable(
+        result.fields.map((field) => ({
+          key: field.key,
+          name: field.name,
+          type: field.type,
+          options: field.options.filter((option) => !option.archived).map((option) => `${option.key}=${option.label}`).join(", "),
+          archived: field.archived ? "yes" : ""
+        })),
+        ["key", "name", "type", "options", "archived"]
+      );
     });
   });
   registerClientTagsCommands(clients2);
@@ -14289,12 +14606,27 @@ Next page: --cursor ${page.nextCursor}
 `);
     });
   });
-  clients2.command("update").description("Update a client's profile (name, phone, language)").argument("<id>", "workspace client id (wcid)").option("--first-name <name>", "new first name").option("--last-name <name>", "new last name").option("--phone <number>", "new phone number").option("--language <code>", "new preferred language code (e.g. en, pl)").action(
+  clients2.command("update").description("Update a client's profile (name, phone, language) and custom field values").argument("<id>", "workspace client id (wcid)").option("--first-name <name>", "new first name").option("--last-name <name>", "new last name").option("--phone <number>", "new phone number").option("--language <code>", "new preferred language code (e.g. en, pl)").option(
+    "--field <key=value>",
+    "set a custom field value (repeatable; keys from `clients fields`, e.g. --field plan=premium)",
+    collectRepeatable2,
+    []
+  ).option("--clear-field <key>", "clear a custom field value (repeatable)", collectRepeatable2, []).action(
     async (id, options, command) => {
       const flags = getGlobalFlags(command);
-      if (options.firstName === void 0 && options.lastName === void 0 && options.phone === void 0 && options.language === void 0) {
+      const customFields = {};
+      for (const entry of options.field) {
+        const separator = entry.indexOf("=");
+        if (separator <= 0) {
+          throw new Error(`Invalid --field "${entry}": use key=value.`);
+        }
+        customFields[entry.slice(0, separator).trim()] = entry.slice(separator + 1);
+      }
+      for (const key of options.clearField) customFields[key.trim()] = null;
+      const hasCustomFields = Object.keys(customFields).length > 0;
+      if (options.firstName === void 0 && options.lastName === void 0 && options.phone === void 0 && options.language === void 0 && !hasCustomFields) {
         throw new Error(
-          "Nothing to update \u2014 pass at least one of --first-name, --last-name, --phone, --language."
+          "Nothing to update \u2014 pass at least one of --first-name, --last-name, --phone, --language, --field, --clear-field."
         );
       }
       const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
@@ -14302,7 +14634,8 @@ Next page: --cursor ${page.nextCursor}
         firstName: options.firstName,
         lastName: options.lastName,
         phoneNumber: options.phone,
-        language: options.language
+        language: options.language,
+        ...hasCustomFields ? { customFields } : {}
       });
       emit(flags, result, () => {
         process.stdout.write(`Updated client ${result.clientId}.
@@ -18670,7 +19003,7 @@ function printOverview(overview) {
   const p = overview.payments;
   const on = (value) => value ? "on" : "off";
   process.stdout.write(
-    `Payments: stripe=${on(p.stripe)} payU=${on(p.payU)} tpay=${on(p.tpay)} payNow=${on(p.payNow)} przelewy24=${on(p.przelewy24)} paypal=${on(p.paypal)} dodo=${on(p.dodo)} manual=${p.manual ? `on (${p.manual.name})` : "off"}
+    `Payments: stripe=${on(p.stripe)} payU=${on(p.payU)} tpay=${on(p.tpay)} payNow=${on(p.payNow)} przelewy24=${on(p.przelewy24)} paypal=${on(p.paypal)} dodo=${on(p.dodo)} tubapay=${on(p.tubapay)} manual=${p.manual ? `on (${p.manual.name})` : "off"}
 `
   );
 }
@@ -18945,7 +19278,7 @@ function readSecret2(label, value, fromStdin, fromEnv) {
 function printPayments(payments) {
   const on = (value) => value ? "on" : "off";
   process.stdout.write(
-    `Payments: stripe=${on(payments.stripe)} payu=${on(payments.payU)} tpay=${on(payments.tpay)} paynow=${on(payments.payNow)} przelewy24=${on(payments.przelewy24)} paypal=${on(payments.paypal)} dodo=${on(payments.dodo)} manual=${payments.manual ? "on" : "off"}
+    `Payments: stripe=${on(payments.stripe)} payu=${on(payments.payU)} tpay=${on(payments.tpay)} paynow=${on(payments.payNow)} przelewy24=${on(payments.przelewy24)} paypal=${on(payments.paypal)} dodo=${on(payments.dodo)} tubapay=${on(payments.tubapay)} manual=${payments.manual ? "on" : "off"}
 `
   );
 }
@@ -19024,6 +19357,11 @@ function buildGatewayInput(gateway, o) {
     case "dodo":
       input.apiKey = secret(o.apiKey, "--api-key");
       break;
+    case "tubapay":
+      input.clientId = need(o.clientId, "--client-id");
+      input.clientSecret = secret(o.clientSecret, "--client-secret");
+      input.callbackSecret = secret(o.callbackSecret, "--callback-secret");
+      break;
   }
   return input;
 }
@@ -19064,11 +19402,11 @@ function registerIntegrationProviderCommands(integrations) {
     }
   );
   const payments = integrations.command("payments").description(
-    "Credential payment gateways: payu, tpay, przelewy24 (p24), paynow, paypal, dodo. Stripe connects in the dashboard (OAuth); the transfer method is `integrations manual-payment`."
+    "Credential payment gateways: payu, tpay, przelewy24 (p24), paynow, paypal, dodo, tubapay. Stripe connects in the dashboard (OAuth); the transfer method is `integrations manual-payment`."
   );
   payments.command("connect <gateway>").description(
     "Connect a gateway \u2014 credentials are verified with the gateway first. With --secrets-env every secret flag takes an environment variable NAME instead of the value."
-  ).requiredOption("--name <name>", "creator-facing label").option("--pos-id <id>", "payu / tpay / przelewy24").option("--client-id <id>", "payu / tpay / paypal").option("--client-secret <secret>", "payu / tpay / paypal").option("--second-key <key>", "payu: the second (MD5) key").option("--safety-key <key>", "tpay: the security key").option("--api-key <key>", "przelewy24 / paynow / dodo").option("--signature-key <key>", "paynow").option("--merchant-id <id>", "przelewy24").option("--crc-key <key>", "przelewy24").option("--secrets-env", "treat every secret flag value as an environment variable name").action(async (gatewayArg, options, command) => {
+  ).requiredOption("--name <name>", "creator-facing label").option("--pos-id <id>", "payu / tpay / przelewy24").option("--client-id <id>", "payu / tpay / paypal; tubapay: the Partner ID").option("--client-secret <secret>", "payu / tpay / paypal / tubapay").option("--second-key <key>", "payu: the second (MD5) key").option("--safety-key <key>", "tpay: the security key").option("--api-key <key>", "przelewy24 / paynow / dodo").option("--signature-key <key>", "paynow").option("--merchant-id <id>", "przelewy24").option("--crc-key <key>", "przelewy24").option("--callback-secret <key>", "tubapay: the key TubaPay signs its notifications with").option("--secrets-env", "treat every secret flag value as an environment variable name").action(async (gatewayArg, options, command) => {
     const flags = getGlobalFlags(command);
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const status = await client.connectPaymentGateway(
@@ -19646,15 +19984,28 @@ 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)}%` : "-";
+var countOrDash = (value) => value === null || value === void 0 ? "-" : String(value);
 var WEEKDAYS = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"];
+function describeExclusions(schedule) {
+  const parts = [];
+  if (schedule.kind !== "daily" && schedule.nightWindow) {
+    parts.push(`none ${schedule.nightWindow.from}-${schedule.nightWindow.to}`);
+  }
+  if (schedule.blackoutDates && schedule.blackoutDates.length > 0) {
+    const days = schedule.blackoutDates.map((range) => range.from === range.to ? range.from : `${range.from}..${range.to}`).join(", ");
+    parts.push(`none on ${days}`);
+  }
+  return parts.length > 0 ? `; ${parts.join("; ")}` : "";
+}
 function describeSchedule(room) {
   if (!room.schedule) return "fixed";
   const until = room.schedule.until ? ` until ${room.schedule.until}` : "";
+  const exclusions = describeExclusions(room.schedule);
   if (room.schedule.kind === "daily") {
     const days = room.schedule.weekdays ? room.schedule.weekdays.map((day) => WEEKDAYS[day - 1] ?? String(day)).join(", ") : "daily";
-    return `${days} at ${room.schedule.times.join(", ")} (${room.timezone})${until}`;
+    return `${days} at ${room.schedule.times.join(", ")} (${room.timezone})${until}${exclusions}`;
   }
-  return `every ${room.schedule.everyMinutes} min${until}`;
+  return `every ${room.schedule.everyMinutes} min${until}${exclusions}`;
 }
 function registerLiveRoomsCommands(program2) {
   const liveRooms = program2.command("live-rooms").description(
@@ -19687,6 +20038,7 @@ function registerLiveRoomsCommands(program2) {
       printTable(
         result.sessions.map((session) => ({
           session: session.sessionStartAt,
+          registered: countOrDash(session.registered),
           attendees: session.attendees,
           identified: session.identified,
           avgWatched: `${minutes(session.averageWatchedSeconds)} (${percent(
@@ -19695,10 +20047,29 @@ function registerLiveRoomsCommands(program2) {
           )})`,
           toEnd: `${session.watchedToEnd} (${percent(session.watchedToEnd, session.attendees)})`,
           sawOffer: session.sawOffer,
-          clickedOffer: session.clickedOffer
+          clickedOffer: session.clickedOffer,
+          bought: countOrDash(session.purchased)
         })),
-        ["session", "attendees", "identified", "avgWatched", "toEnd", "sawOffer", "clickedOffer"]
+        [
+          "session",
+          "registered",
+          "attendees",
+          "identified",
+          "avgWatched",
+          "toEnd",
+          "sawOffer",
+          "clickedOffer",
+          "bought"
+        ]
       );
+      const totals = result.totals;
+      if (totals) {
+        process.stdout.write(
+          `
+Room total (${totals.sessions} started sessions): registered ${countOrDash(totals.registered)} \u2192 attended ${totals.attendees} \u2192 saw the offer ${totals.sawOffer} \u2192 clicked ${totals.clickedOffer} \u2192 bought ${countOrDash(totals.purchased)}${totals.capped ? " (at least: a read hit its cap)" : ""}
+`
+        );
+      }
       if (options.session !== void 0) {
         process.stdout.write(`
 Viewers of ${options.session}:
@@ -25676,6 +26047,10 @@ function registerProductsCommands(program2) {
 `);
       if (product.storefrontVisibility) {
         process.stdout.write(`  Visibility: ${product.storefrontVisibility}
+`);
+      }
+      if (product.language !== void 0) {
+        process.stdout.write(`  Language: ${product.language ?? "none (platform language)"}
 `);
       }
       process.stdout.write(`  Clients: ${product.clientCount}
@@ -25695,6 +26070,10 @@ function registerProductsCommands(program2) {
     "--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(
+    "--language <pl|en>",
+    "the product's language (buyer-facing pages and e-mails; omitted = the platform's language). Also picks the --amount currency when --currency is omitted (pl \u2192 pln, else usd)",
+    parseProductLanguage
+  ).option(
     "--cover <pathOrUrl>",
     "cover image: a local file (uploaded to the media library first) or an https URL"
   ).option(
@@ -25715,7 +26094,8 @@ function registerProductsCommands(program2) {
         name: options.name,
         productType: options.type,
         description,
-        offer
+        offer,
+        language: options.language
       });
       const outcome = {};
       try {
@@ -25764,21 +26144,28 @@ function registerProductsCommands(program2) {
       });
     }
   );
-  products2.command("update").description("Update a product's name, description and/or storefront visibility").argument("<id>", "product id").option("--name <name>", "new product name").option("--description <description>", "new product description").option(
+  products2.command("update").description("Update a product's name, description, storefront visibility and/or language").argument("<id>", "product id").option("--name <name>", "new product name").option("--description <description>", "new product description").option(
     "--visibility <public|unlisted|private>",
     "where buyers find it once published: public (store + product page), unlisted (product page by link only), private (checkout links only)",
     parseStorefrontVisibility
+  ).option(
+    "--language <pl|en|none>",
+    "the product's language (buyer-facing pages and e-mails); none clears it (the platform's language applies)",
+    parseProductLanguageOrNone
   ).action(
     async (id, options, command) => {
-      if (options.name === void 0 && options.description === void 0 && options.visibility === void 0) {
-        throw new Error("Nothing to update: pass --name, --description and/or --visibility.");
+      if (options.name === void 0 && options.description === void 0 && options.visibility === void 0 && options.language === void 0) {
+        throw new Error(
+          "Nothing to update: pass --name, --description, --visibility and/or --language."
+        );
       }
       const flags = getGlobalFlags(command);
       const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
       const result = await client.updateProduct(id, {
         name: options.name,
         description: options.description,
-        storefrontVisibility: options.visibility
+        storefrontVisibility: options.visibility,
+        language: options.language === PRODUCT_LANGUAGE_NONE ? null : options.language
       });
       emit(flags, result, () => {
         process.stdout.write(`Updated product ${result.productId}
@@ -26788,7 +27175,7 @@ function buildUpdateInput2(options) {
 }
 function registerReferralsCommands(program2) {
   const referrals = program2.command("referrals").description(
-    "Referral / affiliate programs \u2014 create reward ladders over your products, enroll clients, approve or reject earned rewards, and retry failed reward deliveries"
+    'Referral programs: "Nagrody za polecenia" (kind referral, reward ladders for your customers) and "Program partnerski" (kind affiliate, partner commission), both from the Growth plan. Create programs over your products, enroll clients, approve or reject earned rewards, and retry failed reward deliveries'
   );
   referrals.command("list").description("List referral programs (kind, status, products, headline stats)").action(async (_, command) => {
     const flags = getGlobalFlags(command);
@@ -26887,7 +27274,7 @@ Failed deliveries (${result.failedDeliveries.length})
     });
   });
   referrals.command("create").description(
-    "Create a program over one or more products. Deep config (milestones, commission, attribution) goes in --json; flat flags win over --json keys."
+    "Create a program over one or more products (both kinds need the Growth plan). Deep config (milestones, commission, attribution) goes in --json; flat flags win over --json keys."
   ).requiredOption("--kind <kind>", `program kind (${PROGRAM_KINDS.join(" | ")})`).requiredOption("--name <name>", "program name").requiredOption("--product <ids>", "comma-separated product ids whose purchases count").option("--enrollment <mode>", `how participants join (${ENROLLMENT_MODES.join(" | ")})`).option("--status <status>", `initial status (${WRITABLE_STATUSES.join(" | ")})`).option(
     "--json <fileOrJson>",
     "inline JSON object or .json path with `milestones`, `commission` and/or `attribution` (write it as --json=<value> \u2014 a bare --json is the global JSON-output flag)"
@@ -26902,7 +27289,7 @@ Failed deliveries (${result.failedDeliveries.length})
     });
   });
   referrals.command("update").description(
-    "Update a program. --product and --json `milestones` are FULL replaces (read the program first); flat flags win over --json keys. Use `referrals archive` to archive."
+    "Update a program. --product and --json `milestones` are FULL replaces (read the program first); flat flags win over --json keys. Activating (--status active) needs the Growth plan. Use `referrals archive` to archive."
   ).argument("<programId>", "program id").option("--name <name>", "program name").option("--status <status>", `status (${WRITABLE_STATUSES.join(" | ")})`).option("--product <ids>", "comma-separated product ids (full replace)").option("--enrollment <mode>", `how participants join (${ENROLLMENT_MODES.join(" | ")})`).option(
     "--json <fileOrJson>",
     "inline JSON object or .json path with `milestones`, `commission` and/or `attribution` (write it as --json=<value> \u2014 a bare --json is the global JSON-output flag)"
@@ -26930,7 +27317,7 @@ Failed deliveries (${result.failedDeliveries.length})
     });
   });
   referrals.command("enroll").description(
-    "Enroll one client as a participant (idempotent \u2014 re-enrolling reports `alreadyEnrolled`). Prints the ref code the client shares."
+    "Enroll one client as a participant (idempotent \u2014 re-enrolling reports `alreadyEnrolled`). Prints the ref code the client shares. Needs the Growth plan."
   ).argument("<programId>", "program id").requiredOption("--client <clientId>", "workspace client id (wcid)").requiredOption("--email <email>", "the client's email").option("--first-name <name>", "first name (optional)").option("--last-name <name>", "last name (optional)").action(async (programId, options, command) => {
     const flags = getGlobalFlags(command);
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
@@ -26949,7 +27336,7 @@ Failed deliveries (${result.failedDeliveries.length})
     });
   });
   referrals.command("enroll-all").description(
-    "Enroll EVERY client with access to one of the program products. Requires --confirm. Reports enrolled / alreadyEnrolled / skippedWithoutAccount counts."
+    'Enroll EVERY client with access to one of the program products ("Nagrody za polecenia" only: a "Program partnerski" is refused, partners join by invite link). Needs the Growth plan. Requires --confirm. Reports enrolled / alreadyEnrolled / skippedWithoutAccount counts.'
   ).argument("<programId>", "program id").option("--confirm", "required \u2014 acknowledge the bulk enrollment").action(async (programId, options, command) => {
     const flags = getGlobalFlags(command);
     requireConfirm13(options.confirm, `enroll all clients in program ${programId}`);
@@ -30376,8 +30763,8 @@ function applyShortHelp(program2) {
 
 // src/program.ts
 function resolveCliVersion() {
-  if ("0.9.0".length > 0) {
-    return "0.9.0";
+  if ("0.10.0".length > 0) {
+    return "0.10.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.9.0",
+  "version": "0.10.0",
   "private": false,
   "description": "Zanfia CLI — thin HTTP client over the Zanfia Public API",
   "type": "module",