@zanfia/cli 0.23.0 → 0.25.0

package/README.md

@@ -1,68 +1,68 @@
-# @zanfia/cli (`zanfia`)
-
-Thin HTTP client over the Zanfia Public API.
-
-> **Status:** published to npm as `@zanfia/cli` (bin `zanfia`), talking to the production Workspace API by default (`ZANFIA_CLI_TARGET=prod` bakes the URLs at build time). Set `ZANFIA_API_URL` to target another environment; local `tsx` runs without baked defaults fall back to the in-memory mock.
-
-## Local usage
-
-```bash
-# from the monorepo root, after `pnpm install`
-pnpm --filter @zanfia/cli dev products list
-
-# or run a one-off
-pnpm --filter @zanfia/cli dev auth whoami
-
-# global flags (--json, --verbose, --api-key) must come BEFORE the subcommand:
-pnpm --filter @zanfia/cli dev --json products list
-```
-
-## System emails
-
-`zanfia emails` manages the customer-facing emails Zanfia sends in your name (Site → Emails):
-
-```bash
-zanfia emails list                                   # key, group, status, subject
-zanfia emails get purchase-confirmation              # subject/headline EN+PL, layout blocks, variables
-zanfia emails set purchase-confirmation --subject-pl "Dzięki za zakup {{productName}}"
-zanfia emails set access-ending-reminder --disable   # optional emails only
-zanfia emails set login-code --layout ./layout.json  # full EmailBlock[] (inline JSON or file)
-zanfia emails set login-code --reset                 # back to the stock email
-zanfia emails branding get
-zanfia emails branding set --accent-color "#2563eb" --reply-to none
-zanfia emails test purchase-confirmation --lang en   # queued to YOUR own address
-```
-
-Raw HTTP: `GET|PATCH /email-templates`, `POST /email-templates/{key}/test-sends`. Full reference for every
-command group: `.claude/skills/zanfia-cli/SKILL.md`.
-
-## Community member keys (read-only option)
-
-A member key acts as a creator's customer in their communities (Community API + the member MCP
-tools), never in a workspace. Three ways to get one:
-
-```bash
-zanfia login --address https://<creator-platform-url> [--read-only]   # browser consent on that platform
-zanfia join <handle> [--read-only]                                      # public community, emailed code
-zanfia auth set-key --api-url <api-community-url> <key>                 # key from the platform's settings
-```
-
-`--read-only` (or „Tylko odczyt” when generating a key under **Settings → AI agents** on the
-platform) grants `communities:read` only: the key reads and summarizes, and
-every write (post, comment, chat, ticket) gets a 403 / a refused MCP tool. `zanfia auth status` and
-`zanfia whoami` show the scope, e.g. `scope : communities:read (read-only)`.
-
-## Auth resolution order
-
-1. `--api-key` flag
-2. `ZANFIA_API_KEY` environment variable
-3. Stored key in `~/.config/zanfia/credentials.json`
-4. Prompt to run `zanfia auth set-key`
-
-## Environment
-
-| Variable          | Purpose                                          |
-| ----------------- | ------------------------------------------------ |
-| `ZANFIA_API_URL`  | Public API base URL. Unset → mock mode.          |
-| `ZANFIA_API_KEY`  | API key (overrides stored credentials).          |
-| `ZANFIA_CLI_MOCK` | Force mock mode even if `ZANFIA_API_URL` is set. |
+# @zanfia/cli (`zanfia`)
+
+Thin HTTP client over the Zanfia Public API.
+
+> **Status:** published to npm as `@zanfia/cli` (bin `zanfia`), talking to the production Workspace API by default (`ZANFIA_CLI_TARGET=prod` bakes the URLs at build time). Set `ZANFIA_API_URL` to target another environment; local `tsx` runs without baked defaults fall back to the in-memory mock.
+
+## Local usage
+
+```bash
+# from the monorepo root, after `pnpm install`
+pnpm --filter @zanfia/cli dev products list
+
+# or run a one-off
+pnpm --filter @zanfia/cli dev auth whoami
+
+# global flags (--json, --verbose, --api-key) must come BEFORE the subcommand:
+pnpm --filter @zanfia/cli dev --json products list
+```
+
+## System emails
+
+`zanfia emails` manages the customer-facing emails Zanfia sends in your name (Site → Emails):
+
+```bash
+zanfia emails list                                   # key, group, status, subject
+zanfia emails get purchase-confirmation              # subject/headline EN+PL, layout blocks, variables
+zanfia emails set purchase-confirmation --subject-pl "Dzięki za zakup {{productName}}"
+zanfia emails set access-ending-reminder --disable   # optional emails only
+zanfia emails set login-code --layout ./layout.json  # full EmailBlock[] (inline JSON or file)
+zanfia emails set login-code --reset                 # back to the stock email
+zanfia emails branding get
+zanfia emails branding set --accent-color "#2563eb" --reply-to none
+zanfia emails test purchase-confirmation --lang en   # queued to YOUR own address
+```
+
+Raw HTTP: `GET|PATCH /email-templates`, `POST /email-templates/{key}/test-sends`. Full reference for every
+command group: `.claude/skills/zanfia-cli/SKILL.md`.
+
+## Community member keys (read-only option)
+
+A member key acts as a creator's customer in their communities (Community API + the member MCP
+tools), never in a workspace. Three ways to get one:
+
+```bash
+zanfia login --address https://<creator-platform-url> [--read-only]   # browser consent on that platform
+zanfia join <handle> [--read-only]                                      # public community, emailed code
+zanfia auth set-key --api-url <api-community-url> <key>                 # key from the platform's settings
+```
+
+`--read-only` (or „Tylko odczyt” when generating a key under **Settings → AI agents** on the
+platform) grants `communities:read` only: the key reads and summarizes, and
+every write (post, comment, chat, ticket) gets a 403 / a refused MCP tool. `zanfia auth status` and
+`zanfia whoami` show the scope, e.g. `scope : communities:read (read-only)`.
+
+## Auth resolution order
+
+1. `--api-key` flag
+2. `ZANFIA_API_KEY` environment variable
+3. Stored key in `~/.config/zanfia/credentials.json`
+4. Prompt to run `zanfia auth set-key`
+
+## Environment
+
+| Variable          | Purpose                                          |
+| ----------------- | ------------------------------------------------ |
+| `ZANFIA_API_URL`  | Public API base URL. Unset → mock mode.          |
+| `ZANFIA_API_KEY`  | API key (overrides stored credentials).          |
+| `ZANFIA_CLI_MOCK` | Force mock mode even if `ZANFIA_API_URL` is set. |

package/dist/index.js

@@ -6901,7 +6901,7 @@ var {
 } = import_index.default;
 
 // src/program.ts
-import { readFileSync as readFileSync29 } from "fs";
+import { readFileSync as readFileSync31 } from "fs";
 
 // src/utils/config.ts
 import { mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
@@ -8621,6 +8621,9 @@ function createMockClient() {
     async previewAudienceSegment() {
       throw new ApiError(501, "audience segments are not available in mock mode");
     },
+    async checkEmailConditions() {
+      throw new ApiError(501, "e-mail conditions are not available in mock mode");
+    },
     async importClients() {
       throw new ApiError(501, "client import is not available in mock mode");
     },
@@ -8990,6 +8993,18 @@ function createMockClient() {
     async revokeLiveRoomStudioGuestInvite() {
       throw new ApiError(501, "webinars are not available in mock mode");
     },
+    async listLiveRoomStudioOutputs() {
+      throw new ApiError(501, "webinars are not available in mock mode");
+    },
+    async createLiveRoomStudioOutput() {
+      throw new ApiError(501, "webinars are not available in mock mode");
+    },
+    async updateLiveRoomStudioOutput() {
+      throw new ApiError(501, "webinars are not available in mock mode");
+    },
+    async deleteLiveRoomStudioOutput() {
+      throw new ApiError(501, "webinars are not available in mock mode");
+    },
     async call(method, pathTemplate) {
       throw new ApiError(501, `${method} ${pathTemplate} is not available in mock mode`);
     },
@@ -9122,6 +9137,9 @@ function createMockClient() {
     async getSiteSettings() {
       throw new ApiError(501, "site settings are not available in mock mode");
     },
+    async getSiteCustomScripts() {
+      throw new ApiError(501, "site settings are not available in mock mode");
+    },
     async updateSiteGeneral() {
       throw new ApiError(501, "site settings are not available in mock mode");
     },
@@ -9985,6 +10003,7 @@ function createHttpClient(config) {
       ...options.requireSendable ? { requireSendable: true } : {},
       ...options.requireSmsSendable ? { requireSmsSendable: true } : {}
     }),
+    checkEmailConditions: (input) => request("POST", "/automations/check-email-conditions", input),
     importClients: (input) => request("POST", "/clients/import", input),
     getClientMergePreview: (survivorClientId, duplicateClientId) => {
       const params = new URLSearchParams();
@@ -10343,6 +10362,17 @@ function createHttpClient(config) {
       "DELETE",
       `/live-rooms/${encodeURIComponent(roomId)}/studio/guests/${encodeURIComponent(guestId)}`
     ),
+    listLiveRoomStudioOutputs: (roomId) => request("GET", `/live-rooms/${encodeURIComponent(roomId)}/studio/outputs`),
+    createLiveRoomStudioOutput: (roomId, input) => request("POST", `/live-rooms/${encodeURIComponent(roomId)}/studio/outputs`, input),
+    updateLiveRoomStudioOutput: (roomId, outputId, input) => request(
+      "PATCH",
+      `/live-rooms/${encodeURIComponent(roomId)}/studio/outputs/${encodeURIComponent(outputId)}`,
+      input
+    ),
+    deleteLiveRoomStudioOutput: (roomId, outputId) => request(
+      "DELETE",
+      `/live-rooms/${encodeURIComponent(roomId)}/studio/outputs/${encodeURIComponent(outputId)}`
+    ),
     getLiveRoomAttendance: (roomId, session) => request(
       "GET",
       `/live-rooms/${encodeURIComponent(roomId)}/attendance${session !== void 0 ? `?session=${encodeURIComponent(session)}` : ""}`
@@ -10412,6 +10442,7 @@ function createHttpClient(config) {
     deleteOtoOffer: (id) => request("DELETE", `/oto-offers/${encodeURIComponent(id)}`),
     // Site (platform settings / storefront / legal documents) lives on the Workspace API (api-v1).
     getSiteSettings: () => request("GET", "/site/settings"),
+    getSiteCustomScripts: () => request("GET", "/site/custom-scripts"),
     updateSiteGeneral: (input) => request("PATCH", "/site/settings/general", input),
     updateSiteTheme: (input) => request("PATCH", "/site/settings/theme", input),
     updateSiteBranding: (input) => request("PATCH", "/site/settings/branding", input),
@@ -11183,7 +11214,7 @@ function registerBlogCommands(program2) {
     "Schedules a DRAFT (or reschedules a scheduled post) to be published at `scheduledAt`: status `scheduled`, not public anywhere (list, feed, sitemap, its URL) until then, then published exactly like publish-blog-post. Needs a non-empty body (400); a published post answers 409 (unpublish it first). `scheduledAt: null` unschedules (back to draft); publishing it now is publish-blog-post. Returns the full post with `scheduledAt`."
   ).argument("<id>", "Blog post id (`post_\u2026`) from list-blog-posts.").requiredOption(
     "--at <value>",
-    'When the post goes live: Polish time without an offset ("2026-10-26T08:00", read in Europe/Warsaw with the offset of that date, also across a clock change) or an ISO 8601 date-time with an offset / Z (2026-10-26T08:00:00+01:00). At least a minute and at most a year ahead. null = unschedule (back to draft).'
+    `When the post goes live: the workspace's local time without an offset ("2026-10-26T08:00", read in the workspace time zone: its own zone from Ustawienia \u2192 Workspace, else Europe/Warsaw for a Polish workspace (PL invoice / pl site), else the owner's account zone, else Europe/Warsaw; with the offset of that date, also across a clock change) or an ISO 8601 date-time with an offset / Z (2026-10-26T08:00:00+01:00). At least a minute and at most a year ahead. null = unschedule (back to draft).`
   ).action(async (id, options, command) => {
     const flags = getGlobalFlags(command);
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
@@ -11311,7 +11342,7 @@ function registerSiteRedirectsCommands(program2) {
     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."
+    "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 `to` that is another line (`chain`) or the line itself (`loop`), `/*` 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."
@@ -12306,6 +12337,186 @@ function registerTaxCommands(program2) {
   });
 }
 
+// src/commands/_generated/social.ts
+function registerSocialCommands(program2) {
+  const social = program2.commands.find((command) => command.name() === "social") ?? program2.command("social", { hidden: true });
+  if (!social.description()) {
+    social.description("Automatic messages after an Instagram comment (keyword \u2192 private message)");
+  }
+  const socialCommentDm = social.command("comment-dm", { hidden: true });
+  socialCommentDm.description(
+    "Automatic messages after an Instagram comment (keyword \u2192 private message)"
+  );
+  socialCommentDm.command("list", { hidden: true }).summary("List the automatic messages after a comment").description(
+    "The workspace\u2019s \u201EAutomatyczna wiadomo\u015B\u0107 po komentarzu\u201D rules on Instagram, newest first: the account, the post (or every post of the account), the keywords, the message, the link as sent (`taggedLink`, with UTM tags), the public reply, `status` (active / paused), `ended`, and the results so far in `counts` (matched comments, `sent` and `failed` private messages) with the latest failure. Read-only. 403 `feature_not_available` while the workspace has no early access."
+  ).option(
+    "--account <value>",
+    "Only this Instagram account's rules: its id or its target from list-social-accounts. Omitted = every account."
+  ).action(async (options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {};
+    const payload = {
+      accountId: options.account
+    };
+    const result = await client.call(
+      "GET",
+      "/social/instagram/comment-dm-rules",
+      params,
+      payload,
+      void 0
+    );
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  socialCommentDm.command("create", { hidden: true }).summary("Create an automatic message after a comment").description(
+    "Creates a \u201EAutomatyczna wiadomo\u015B\u0107 po komentarzu\u201D rule on Instagram: when someone comments one of the keywords under the post (or any post of the account), Instagram sends them ONE private message with the text and the link (UTM-tagged), optionally with a public reply under the comment. Each person gets it once per rule; comments older than 7 days get nothing. Same rules as the panel: 400 `invalid` (with `problem`), 404 `not_connected`, 409 `reconnect_required` (the account lacks the messages / comments permission), 409 `too_many_rules` (50 per workspace), 403 `feature_not_available` without the early access. `commentsSubscribed: false` = saved but Instagram refused the comment notifications (reconnect the account). Pause it with pause-instagram-comment-dm-rule."
+  ).option(
+    "--account <value>",
+    "The Instagram account: its id (`accountId` of a rule), or the `target` of an Instagram account from list-social-accounts (`instagram` = the main account, `instagram:{id}`). Omitted = the main connected Instagram account."
+  ).addOption(
+    new Option(
+      "--scope <post|account>",
+      "`post` = comments under one post (send `mediaId` of a published post from list-instagram-media, or `socialPostId` of a composer post not published yet); `account` = comments under any post of the account."
+    ).choices(["post", "account"]).makeOptionMandatory()
+  ).option("--media-id <value>", "`post` scope: the published post\u2019s media id.").option(
+    "--social-post-id <value>",
+    "`post` scope: a composer post not live yet; the rule waits for its publishing."
+  ).option("--media-permalink <value>", "The post\u2019s Instagram link, shown on the rule.").option("--media-caption <value>", "The post\u2019s caption, shown on the rule.").requiredOption(
+    "--keywords <a,b,...>",
+    "Words or short phrases that trigger the message (1-10, each up to 40 characters). A comment matches when it contains one as whole words; case and Polish letters do not matter (\u201EPobierz!\u201D and \u201Epobierz\u201D match `pobierz`).",
+    parseCommaList("--keywords")
+  ).requiredOption(
+    "--text <value>",
+    "The private message sent once to each person who comments a keyword. With the link it must fit Instagram\u2019s 1000 bytes."
+  ).option(
+    "--link <value>",
+    "Optional full http(s) link added to the message; Zanfia adds UTM tags (utm_source=instagram, utm_medium=comment_dm, utm_campaign=<first keyword>). null removes it."
+  ).option(
+    "--public-reply <json|file>",
+    "Optional public reply under the matching comment; off when omitted.",
+    parseJsonObjectFileOrInline("--public-reply")
+  ).addOption(
+    new Option(
+      "--status <active|paused>",
+      "Omitted = `active` (answers comments at once)."
+    ).choices(["active", "paused"])
+  ).option(
+    "--ends-at <value>",
+    "Optional ISO 8601 time after which the rule answers nothing; null = no end."
+  ).action(async (options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {};
+    const payload = {
+      accountId: options.account,
+      scope: options.scope,
+      mediaId: options.mediaId,
+      socialPostId: options.socialPostId,
+      mediaPermalink: options.mediaPermalink,
+      mediaCaption: options.mediaCaption,
+      keywords: options.keywords,
+      dmText: options.text,
+      link: options.link,
+      publicReply: options.publicReply,
+      status: options.status,
+      endsAt: options.endsAt
+    };
+    const result = await client.call(
+      "POST",
+      "/social/instagram/comment-dm-rules",
+      params,
+      void 0,
+      payload
+    );
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  socialCommentDm.command("update", { hidden: true }).summary("Change or resume an automatic message after a comment").description(
+    "Changes a \u201EAutomatyczna wiadomo\u015B\u0107 po komentarzu\u201D rule like the panel\u2019s edit: only the fields sent change (keywords, message, link, public reply, end date) and `status` pauses (`paused`) or resumes (`active`) it. The account and the post never change: a new post is a new rule. People who already got the message do not get it again. Same validation as a create (400 `invalid` with `problem`); 404 `rule_not_found`. Reversible: change it again."
+  ).argument("<id>", "The rule id (`id` from list-instagram-comment-dm-rules).").option(
+    "--keywords <a,b,...>",
+    "The full new keyword list (replaces the old one).",
+    parseCommaList("--keywords")
+  ).option(
+    "--text <value>",
+    "The private message sent once to each person who comments a keyword. With the link it must fit Instagram\u2019s 1000 bytes."
+  ).option(
+    "--link <value>",
+    "Optional full http(s) link added to the message; Zanfia adds UTM tags (utm_source=instagram, utm_medium=comment_dm, utm_campaign=<first keyword>). null removes it."
+  ).option(
+    "--public-reply <json|file>",
+    "Optional public reply under the matching comment; off when omitted.",
+    parseJsonObjectFileOrInline("--public-reply")
+  ).addOption(
+    new Option(
+      "--status <active|paused>",
+      "`active` resumes the rule, `paused` pauses it."
+    ).choices(["active", "paused"])
+  ).option(
+    "--ends-at <value>",
+    "Optional ISO 8601 time after which the rule answers nothing; null = no end."
+  ).action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      ruleId: id
+    };
+    const payload = {
+      keywords: options.keywords,
+      dmText: options.text,
+      link: options.link,
+      publicReply: options.publicReply,
+      status: options.status,
+      endsAt: options.endsAt
+    };
+    const result = await client.call(
+      "PATCH",
+      "/social/instagram/comment-dm-rules/:ruleId",
+      params,
+      void 0,
+      payload
+    );
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  socialCommentDm.command("pause", { hidden: true }).summary("Pause an automatic message after a comment").description(
+    "Pauses a \u201EAutomatyczna wiadomo\u015B\u0107 po komentarzu\u201D rule (the panel\u2019s \u201EWstrzymaj\u201D): it answers no new comment until resumed (update-instagram-comment-dm-rule with `status: active`). Its settings and results stay. 404 `rule_not_found`."
+  ).argument("<id>", "The rule id (`id` from list-instagram-comment-dm-rules).").action(async (id, _options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      ruleId: id
+    };
+    const result = await client.call(
+      "POST",
+      "/social/instagram/comment-dm-rules/:ruleId/pause",
+      params,
+      void 0,
+      void 0
+    );
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+  socialCommentDm.command("delete", { hidden: true }).summary("Delete an automatic message after a comment").description(
+    "Deletes a \u201EAutomatyczna wiadomo\u015B\u0107 po komentarzu\u201D rule for good, with its results and the list of people who got the message. No undo: prefer pause-instagram-comment-dm-rule. 404 `rule_not_found`."
+  ).argument("<id>", "The rule id (`id` from list-instagram-comment-dm-rules).").option(
+    "--confirm",
+    "required \u2014 acknowledge that you want to delete the rule and its results for good"
+  ).action(async (id, options, command) => {
+    const flags = getGlobalFlags(command);
+    requireConfirm(options.confirm, "delete the rule and its results for good");
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const params = {
+      ruleId: id
+    };
+    const result = await client.call(
+      "DELETE",
+      "/social/instagram/comment-dm-rules/:ruleId",
+      params,
+      void 0,
+      void 0
+    );
+    emit(flags, result ?? {}, () => printJson(result ?? {}));
+  });
+}
+
 // src/commands/_generated/index.ts
 function registerGeneratedCommands(program2) {
   registerCertificatesCommands(program2);
@@ -12319,6 +12530,7 @@ function registerGeneratedCommands(program2) {
   registerChatsCommands(program2);
   registerOrdersCommands(program2);
   registerTaxCommands(program2);
+  registerSocialCommands(program2);
 }
 
 // src/commands/ads/index.ts
@@ -15170,6 +15382,13 @@ var AIImageQuality = /* @__PURE__ */ ((AIImageQuality2) => {
   AIImageQuality2["Ultra"] = "4K";
   return AIImageQuality2;
 })(AIImageQuality || {});
+var STUDIO_OUTPUT_PLATFORMS = [
+  "facebook",
+  "linkedin",
+  "twitch",
+  "kick",
+  "other"
+];
 var MANAGED_CONVERSION_TRACKING_CLIENTS = [
   "googleAnalytics",
   "googleTagManager",
@@ -17787,7 +18006,7 @@ Next page: --cursor ${result.nextCursor}
     });
   });
   settings.command("update").description(
-    "Patch community settings \u2014 via toggle flags and/or a JSON patch. Allowed patch keys: uploadVideo, membersDisplay, viewStyle, displayName, icon, hiddenWhenUnavailable, voiceMessages, enableMemberApiAccess, publicAccess, publicAccessTermsUrl, contentVisibleFromJoinDate, eventsEnabled, eventAnnouncements, directMessagesEnabled, gamification, moderation, assistant, digest. Nested blocks in the JSON patch replace their whole sub-object; the --gamification / --auto-hide-after-reports flags merge into the existing block instead."
+    "Patch community settings \u2014 via toggle flags and/or a JSON patch. Allowed patch keys: uploadVideo, membersDisplay, viewStyle, displayName, icon, hiddenWhenUnavailable, voiceMessages, enableMemberApiAccess, publicAccess, publicAccessTermsUrl, contentVisibleFromJoinDate, eventsEnabled, eventAnnouncements, directMessagesEnabled, gamification (incl. xpRules: XP per activity, only the activities listed change, and xpTemplate: a preset for the whole table, with xpRules = the preset with those rows changed; send gamification.enabled with them), moderation, assistant, digest. Nested blocks in the JSON patch merge into the stored block field by field (lists such as joinQuestions are replaced whole); gamification.enabled and a moderation threshold can also be set with the --gamification / --auto-hide-after-reports flags."
   ).argument("<communityId>", "community id").option("--patch <fileOrJson>", "the settings patch as inline JSON or a path to a .json file").option("--events-enabled <on|off>", "show / hide the Calendar (events) section for members").option(
     "--event-announcements <on|off>",
     "bell + e-mail to members when a new event is published (default on)"
@@ -17823,8 +18042,11 @@ Next page: --cursor ${result.nextCursor}
       const needsCurrent = options.gamification !== void 0 || options.autoHideAfterReports !== void 0;
       const current = needsCurrent ? (await client.getCommunitySettings(communityId)).settings ?? {} : {};
       if (options.gamification !== void 0) {
+        const { xpRules, xpTemplate, courseXp, ...storedBlock } = current.gamification ?? {
+          enabled: false
+        };
         patch.gamification = {
-          ...patch.gamification ?? current.gamification ?? {},
+          ...patch.gamification ?? storedBlock,
           enabled: parseOnOff(options.gamification, "--gamification")
         };
       }
@@ -21480,7 +21702,7 @@ function registerFunnelsCommands(program2) {
       const result = await client.addFunnelOfferPage(id, input);
       emit(flags, result, () => {
         process.stdout.write(
-          `Added the DRAFT offer page /${result.slug} (page ${result.pageId}, step ${result.stepId}) after step ${result.afterStepId}. The body copy and the crossed-out price are template samples (the button and price spans show the checkout's real price): edit the copy, then publish it.
+          `Added the DRAFT offer page /${result.slug} (page ${result.pageId}, step ${result.stepId}) after step ${result.afterStepId}. It names the checkout's product at its price (crossed-out only when the price has a compare-at amount), no sample claims: add what the buyer gets, then publish it.
 `
         );
       });
@@ -22754,6 +22976,33 @@ to refresh it.
   });
 }
 
+// src/commands/liveRooms/streamKeyInput.ts
+import { readFileSync as readFileSync17 } from "fs";
+var streamKeyIo = {
+  readStdin: () => readFileSync17(0, "utf8"),
+  stdinIsTty: () => process.stdin.isTTY === true,
+  promptHidden: (question) => promptHidden(question)
+};
+async function readStreamKey(options) {
+  const { readStdin, stdinIsTty, promptHidden: ask } = streamKeyIo;
+  let key;
+  if (stdinIsTty()) {
+    key = (await ask("Stream key (hidden): ")).trim();
+  } else if (options.keyStdin) {
+    key = readStdin().trim();
+  } else {
+    throw new Error(
+      "No terminal to ask for the stream key: pipe it on stdin with --key-stdin (the key is never a command-line argument)."
+    );
+  }
+  if (!key) throw new Error("No stream key was given.");
+  return key;
+}
+var MASK = "\u2022\u2022\u2022\u2022";
+function maskedStreamKey(value) {
+  return value.startsWith(MASK) && value.length <= MASK.length + 4 ? value : MASK;
+}
+
 // src/commands/liveRooms/index.ts
 var STUDIO_SCENE_LAYOUTS = ["solo", "presentation", "grid"];
 function parseSceneLayout(value) {
@@ -22761,6 +23010,29 @@ function parseSceneLayout(value) {
   if (!layout) throw new Error(`--layout must be one of ${STUDIO_SCENE_LAYOUTS.join(", ")}`);
   return layout;
 }
+function parseOutputPlatform(value) {
+  const platform2 = STUDIO_OUTPUT_PLATFORMS.find((candidate) => candidate === value.toLowerCase());
+  if (!platform2) {
+    throw new Error(`--platform must be one of ${STUDIO_OUTPUT_PLATFORMS.join(", ")}`);
+  }
+  return platform2;
+}
+var safeOutput = (output) => ({
+  ...output,
+  streamKey: maskedStreamKey(output.streamKey)
+});
+var outputRow = (output) => ({
+  id: output.id,
+  platform: output.platform,
+  label: output.label ?? "",
+  url: output.url,
+  key: maskedStreamKey(output.streamKey),
+  enabled: output.enabled ? "on" : "off",
+  state: output.state,
+  message: output.message ?? ""
+});
+var OUTPUT_COLUMNS = ["id", "platform", "label", "url", "key", "enabled", "state", "message"];
+var SENT_NOTE = '\n"sent" = the stream leaves for the platform, which does not say whether it took the key: check the live preview there.\n';
 function parseOnOff4(value) {
   if (value === "on") return true;
   if (value === "off") return false;
@@ -22963,6 +23235,84 @@ Next: zanfia funnels from-template webinar --live-room ${result.room.id} --lang
       });
     }
   );
+  liveRooms.command("outputs").description(
+    "A studio webinar's extra streams (Facebook, LinkedIn, Twitch, Kick, other RTMP): state and errors; the stream key shows masked"
+  ).argument("<roomId>", "studio webinar id (from live-rooms list)").action(async (roomId, _options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.listLiveRoomStudioOutputs(roomId);
+    const safe = { ...result, outputs: result.outputs.map(safeOutput) };
+    emit(flags, safe, () => {
+      printTable(safe.outputs.map(outputRow), OUTPUT_COLUMNS);
+      process.stdout.write(
+        `
+${safe.outputs.length} of ${safe.maxOutputs} outputs.` + (safe.simulcastAvailable ? "" : " This webinar streams to YouTube, which does not run through Cloudflare here: extra streams need the Zanfia player as the destination.") + "\n"
+      );
+      if (safe.outputs.some((output) => output.state === "sent")) {
+        process.stdout.write(SENT_NOTE);
+      }
+    });
+  });
+  liveRooms.command("output-add").description(
+    "Add an extra stream to a studio webinar (early access). The stream key is asked for hidden, or read from stdin with --key-stdin; it is never an argument and never shown again. Refused (409) on a YouTube webinar that cannot run through Cloudflare"
+  ).argument("<roomId>", "studio webinar id (from live-rooms list)").requiredOption("--platform <platform>", STUDIO_OUTPUT_PLATFORMS.join(" | ")).option(
+    "--url <url>",
+    "rtmp:// or rtmps:// ingest address (prefilled for facebook, twitch, kick; required otherwise)"
+  ).option("--label <label>", 'your own name for it (e.g. "Company page")').option("--off", "add it switched off").option("--key-stdin", "read the stream key from stdin (e.g. from a password manager)").action(
+    async (roomId, options, command) => {
+      const flags = getGlobalFlags(command);
+      const platform2 = parseOutputPlatform(options.platform);
+      const streamKey = await readStreamKey({ keyStdin: options.keyStdin });
+      const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+      const result = await client.createLiveRoomStudioOutput(roomId, {
+        platform: platform2,
+        ...options.url !== void 0 ? { url: options.url } : {},
+        ...options.label !== void 0 ? { label: options.label } : {},
+        ...options.off ? { enabled: false } : {},
+        streamKey
+      });
+      const output = safeOutput(result.output);
+      emit(flags, { output }, () => printTable([outputRow(output)], OUTPUT_COLUMNS));
+    }
+  );
+  liveRooms.command("output-update").description(
+    "Change an extra stream: address, name, on / off, or a NEW stream key (replace only: the stored key is never read back). Only the options you pass change"
+  ).argument("<roomId>", "studio webinar id (from live-rooms list)").argument("<outputId>", "output id (from live-rooms outputs)").option("--url <url>", "new rtmp:// or rtmps:// ingest address").option("--label <label>", "your own name for it").option("--no-label", "remove your name (the platform's name shows)").option("--enabled <on|off>", "switch it on or off (works while on air)").option("--new-key", "replace the stream key: asked for hidden").option("--key-stdin", "replace the stream key with the one read from stdin").action(
+    async (roomId, outputId, options, command) => {
+      const flags = getGlobalFlags(command);
+      const input = {
+        ...options.url !== void 0 ? { url: options.url } : {},
+        ...options.label === false ? { label: null } : options.label !== void 0 ? { label: options.label } : {},
+        ...options.enabled !== void 0 ? { enabled: parseOnOff4(options.enabled) } : {}
+      };
+      if (options.newKey || options.keyStdin) {
+        input.streamKey = await readStreamKey({ keyStdin: options.keyStdin });
+      }
+      if (Object.keys(input).length === 0) {
+        throw new Error("pass at least one option (e.g. --enabled off or --new-key)");
+      }
+      const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+      const result = await client.updateLiveRoomStudioOutput(roomId, outputId, input);
+      const output = safeOutput(result.output);
+      emit(flags, { output }, () => printTable([outputRow(output)], OUTPUT_COLUMNS));
+    }
+  );
+  liveRooms.command("output-remove").description(
+    "Remove an extra stream and delete its stored stream key (stops it at once when on air). Requires --confirm"
+  ).argument("<roomId>", "studio webinar id (from live-rooms list)").argument("<outputId>", "output id (from live-rooms outputs)").option("--confirm", "confirm the removal").action(
+    async (roomId, outputId, options, command) => {
+      if (!options.confirm) {
+        throw new Error("Refusing to remove the output without --confirm.");
+      }
+      const flags = getGlobalFlags(command);
+      const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+      const result = await client.deleteLiveRoomStudioOutput(roomId, outputId);
+      emit(flags, result, () => {
+        process.stdout.write(`Removed output ${outputId} and its stream key.
+`);
+      });
+    }
+  );
   liveRooms.command("attendance").description("A webinar's attendance per session; --session adds that session's viewers").argument("<roomId>", "webinar 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 });
@@ -23025,7 +23375,7 @@ Viewers of ${options.session}:
 }
 
 // src/commands/media/index.ts
-import { existsSync, readFileSync as readFileSync17, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync, readFileSync as readFileSync18, writeFileSync as writeFileSync4 } from "fs";
 import { readFile as readFile3, stat as stat5 } from "fs/promises";
 import { basename } from "path";
 
@@ -26197,7 +26547,7 @@ function requireConfirm10(confirm, what) {
   }
 }
 function resolveTextOrFile(value) {
-  const text = existsSync(value) ? readFileSync17(value, "utf8") : value;
+  const text = existsSync(value) ? readFileSync18(value, "utf8") : value;
   if (!text.trim()) throw new Error("The text (or the file it points to) is empty.");
   return text.trim();
 }
@@ -26462,7 +26812,7 @@ function registerMediaCommands(program2) {
       const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
       const result = await client.uploadMediaCaption(mediaId, {
         srclang: options.lang,
-        content: readFileSync17(options.file, "utf8"),
+        content: readFileSync18(options.file, "utf8"),
         ...options.label ? { label: options.label } : {}
       });
       emit(flags, result, () => {
@@ -26676,13 +27026,13 @@ function registerMediaCommands(program2) {
 }
 
 // src/commands/newsletters/index.ts
-import { existsSync as existsSync2, readFileSync as readFileSync18 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync19 } from "fs";
 var ISSUE_STATUSES = ["public", "hidden"];
 var ISSUE_VISIBILITIES = ["public", "hidden", "locked"];
 var ISSUE_RENDER_MODES = ["snapshot", "article"];
 var THUMBNAIL_NONE = "none";
 function resolveMarkdownOrFile(value) {
-  return existsSync2(value) ? readFileSync18(value, "utf8") : value;
+  return existsSync2(value) ? readFileSync19(value, "utf8") : value;
 }
 function parseIdList2(value, flag) {
   const ids = value.split(",").map((id) => id.trim()).filter(Boolean);
@@ -26724,7 +27074,7 @@ function parseBool2(value, flag) {
 }
 function parseJsonFileOrInline5(value, flag) {
   const trimmed = value.trim();
-  const raw = trimmed.startsWith("{") || trimmed.startsWith("[") ? trimmed : readFileSync18(value, "utf8");
+  const raw = trimmed.startsWith("{") || trimmed.startsWith("[") ? trimmed : readFileSync19(value, "utf8");
   try {
     return JSON.parse(raw);
   } catch (error) {
@@ -27146,7 +27496,7 @@ Next: \`newsletters issues draft save ${productId} ${issue.id} --content <markdo
 }
 
 // src/commands/offers/index.ts
-import { readFileSync as readFileSync19 } from "fs";
+import { readFileSync as readFileSync20 } from "fs";
 var PRICE_BILLING_TYPES = ["one_time", "recurring", "installments"];
 var PRICE_INTERVALS = ["day", "week", "month", "year"];
 var SALE_START_DISPLAYS = ["hidden", "countdown"];
@@ -27183,7 +27533,7 @@ function parseBool3(value, flag) {
 }
 function parseJsonFileOrInline6(value, flag) {
   const trimmed = value.trim();
-  const raw = trimmed.startsWith("{") || trimmed.startsWith("[") ? trimmed : readFileSync19(value, "utf8");
+  const raw = trimmed.startsWith("{") || trimmed.startsWith("[") ? trimmed : readFileSync20(value, "utf8");
   try {
     return JSON.parse(raw);
   } catch (error) {
@@ -28028,6 +28378,48 @@ function parsePositiveInt13(value, flag) {
 function formatAmount3(amountCents, currency) {
   return `${(amountCents / 100).toFixed(2)} ${currency}`;
 }
+function formatProducts(order) {
+  const others = (order.productIds ?? []).filter((id) => id !== order.productId).length;
+  return others > 0 ? `${order.productId} +${others}` : order.productId;
+}
+function formatLine(line) {
+  const variant = line.variantLabel ? ` (${line.variantLabel})` : "";
+  const discount = line.discountCents > 0 ? ` (\u2212${formatAmount3(line.discountCents, line.currency)})` : "";
+  return `    - ${line.productName}${variant} (${line.productId}) \u2014 ${line.quantity} \xD7 ${formatAmount3(line.unitAmountCents, line.currency)} = ${formatAmount3(line.amountCents, line.currency)}${discount}
+`;
+}
+function writeOrderLines(order) {
+  const lines = order.lineItems ?? [];
+  if (lines.length > 1 || order.origin === "shopCart") {
+    process.stdout.write(`  Lines:
+`);
+    for (const line of lines) process.stdout.write(formatLine(line));
+  } else if (order.additionalProducts.length > 0) {
+    process.stdout.write(`  Order bumps:
+`);
+    for (const bump of order.additionalProducts) {
+      const quantity = bump.quantity > 1 ? `${bump.quantity} \xD7 ` : "";
+      process.stdout.write(
+        `    - ${bump.productName} (${bump.productId}) \u2014 ${quantity}${formatAmount3(bump.amountCents, bump.currency)}
+`
+      );
+    }
+  }
+  if (order.shipping) {
+    const { shipping } = order;
+    const destination = shipping.lockerPointId ? `locker ${shipping.lockerPointId}` : shipping.address ? `${shipping.address.street}, ${shipping.address.postalCode} ${shipping.address.city}` : "";
+    process.stdout.write(
+      `  Delivery: ${shipping.methodLabel} \u2014 ${formatAmount3(shipping.amountCents, shipping.currency)}${destination ? `, ${destination}` : ""} (${shipping.recipientName})
+`
+    );
+  }
+  if (order.fulfillment) {
+    const { fulfillment } = order;
+    const tracking = fulfillment.trackingNumber ? `, tracking ${fulfillment.trackingNumber}` : "";
+    process.stdout.write(`  Fulfilment: ${fulfillment.status}${tracking}
+`);
+  }
+}
 function requireConfirm11(confirm, what) {
   if (!confirm) {
     throw new Error(`Refusing to ${what} without --confirm. Re-run with --confirm to proceed.`);
@@ -28037,7 +28429,7 @@ function registerOrdersCommands2(program2) {
   const orders2 = program2.command("orders").description(
     "Browse orders; approve or reject manual (wire-transfer) payments; mark test / refunded orders"
   );
-  orders2.command("list").description("List orders (newest first), with optional filters").option("--product <id>", "only orders of this product").option(
+  orders2.command("list").description("List orders (newest first), with optional filters").option("--product <id>", "only orders that sold this product (on any line)").option(
     "--status <status>",
     "filter by status (paid, pending, refunded, failed) \u2014 manual wire-transfer orders awaiting approval are `pending`"
   ).option("--from <date>", "only orders created on/after this ISO date").option("--to <date>", "only orders created on/before this ISO date").option("--search <query>", "match client email / name").option("--include-test", "include simulated test purchases (excluded by default)").option("--limit <n>", "page size (max 100)").option("--cursor <cursor>", "keyset cursor from a previous page").action(
@@ -28058,7 +28450,7 @@ function registerOrdersCommands2(program2) {
         printTable(
           page.items.map((o) => ({
             id: o.id,
-            product: o.productId,
+            product: formatProducts(o),
             client: o.clientEmail,
             amount: formatAmount3(o.amountCents, o.currency),
             status: o.status,
@@ -28074,7 +28466,7 @@ Next page: --cursor ${page.nextCursor}
       });
     }
   );
-  orders2.command("get").description("Show a single order (payment, refund, order bumps, invoice)").argument("<orderId>", "order id").action(async (orderId, _, command) => {
+  orders2.command("get").description("Show a single order (payment, refund, lines or order bumps, delivery, invoice)").argument("<orderId>", "order id").action(async (orderId, _, command) => {
     const flags = getGlobalFlags(command);
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const order = await client.getOrder(orderId);
@@ -28109,17 +28501,7 @@ Next page: --cursor ${page.nextCursor}
 `
         );
       }
-      if (order.additionalProducts.length > 0) {
-        process.stdout.write(`  Order bumps:
-`);
-        for (const bump of order.additionalProducts) {
-          const quantity = bump.quantity > 1 ? `${bump.quantity} \xD7 ` : "";
-          process.stdout.write(
-            `    - ${bump.productName} (${bump.productId}) \u2014 ${quantity}${formatAmount3(bump.amountCents, bump.currency)}
-`
-          );
-        }
-      }
+      writeOrderLines(order);
       if (order.invoiceUrl) process.stdout.write(`  Invoice: ${order.invoiceUrl}
 `);
     });
@@ -28220,7 +28602,7 @@ Next page: --cursor ${page.nextCursor}
   );
   orders2.command("export").description(
     "Export orders as CSV to a file. The --from/--to window is required; same filters as `orders list`."
-  ).requiredOption("--from <date>", "inclusive ISO date lower bound on createdAt (required)").requiredOption("--to <date>", "inclusive ISO date upper bound on createdAt (required)").option("--product <id>", "only orders of this product").option("--status <status>", "filter by status (paid, pending, refunded, failed)").option("--search <query>", "match client email / name").option("--include-test", "include simulated test purchases (excluded by default)").option("--max-rows <n>", "row cap (server default 10000, max 20000)").option("--out <file>", "output file path", "zanfia-orders.csv").action(
+  ).requiredOption("--from <date>", "inclusive ISO date lower bound on createdAt (required)").requiredOption("--to <date>", "inclusive ISO date upper bound on createdAt (required)").option("--product <id>", "only orders that sold this product (on any line)").option("--status <status>", "filter by status (paid, pending, refunded, failed)").option("--search <query>", "match client email / name").option("--include-test", "include simulated test purchases (excluded by default)").option("--max-rows <n>", "row cap (server default 10000, max 20000)").option("--out <file>", "output file path", "zanfia-orders.csv").action(
     async (options, command) => {
       const flags = getGlobalFlags(command);
       for (const [flag, value] of [
@@ -28260,12 +28642,12 @@ Next page: --cursor ${page.nextCursor}
 }
 
 // src/commands/oto/index.ts
-import { readFileSync as readFileSync20 } from "fs";
+import { readFileSync as readFileSync21 } from "fs";
 var MIN_TIMER_MINUTES = 1;
 var MAX_TIMER_MINUTES = 120;
 function parseJsonFileOrInline7(value, flag) {
   const trimmed = value.trim();
-  const raw = trimmed.startsWith("{") || trimmed.startsWith("[") ? trimmed : readFileSync20(value, "utf8");
+  const raw = trimmed.startsWith("{") || trimmed.startsWith("[") ? trimmed : readFileSync21(value, "utf8");
   try {
     return JSON.parse(raw);
   } catch (error) {
@@ -28453,7 +28835,7 @@ function registerOtoCommands(program2) {
 }
 
 // src/commands/pages/index.ts
-import { existsSync as existsSync3, readFileSync as readFileSync21 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync22 } from "fs";
 import { readFile as readFile4 } from "fs/promises";
 var CLEAR_VALUE = "none";
 var FAMILY_STEPS = ["follow-ups", "thank-you-page", "room-page"];
@@ -28532,13 +28914,13 @@ function parseCsv4(value) {
   ];
 }
 function resolveTextOrFile2(value) {
-  const text = existsSync3(value) ? readFileSync21(value, "utf8") : value;
+  const text = existsSync3(value) ? readFileSync22(value, "utf8") : value;
   if (!text.trim()) throw new Error("The text (or the file it points to) is empty.");
   return text;
 }
 function parseJsonObjectFileOrInline3(value, flag) {
   const trimmed = value.trim();
-  const raw = trimmed.startsWith("{") ? trimmed : readFileSync21(value, "utf8");
+  const raw = trimmed.startsWith("{") ? trimmed : readFileSync22(value, "utf8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -28903,7 +29285,7 @@ function registerPagesCommands(program2) {
     });
   });
   pages.command("restore").description(
-    "Roll a page's HTML back to a revision. The current HTML is snapshotted first (source `restore`), so a restore is itself undoable. On a published page a revision with a buy button that leads nowhere is refused (409, nothing restored). Requires --confirm."
+    'Roll a page\'s HTML back to a revision. The current HTML is snapshotted first (source `restore`), so a restore is itself undoable. On a published page a revision with a buy button that leads nowhere, or with placeholder text the live page does not show ([UZUPE\u0141NIJ: \u2026], a <span class="todo"> note, LINK: \u2026), is refused (409, nothing restored). Requires --confirm.'
   ).argument("<pageId>", "page id").argument("<revisionId>", "revision id from `pages revisions`").option("--confirm", "required \u2014 acknowledge that the current HTML will be replaced").action(
     async (pageId, revisionId, options, command) => {
       const flags = getGlobalFlags(command);
@@ -28964,7 +29346,7 @@ function registerPagesCommands(program2) {
 }
 
 // src/commands/products/index.ts
-import { readFileSync as readFileSync22 } from "fs";
+import { readFileSync as readFileSync23 } from "fs";
 import { readFile as readFile5 } from "fs/promises";
 import { basename as basename2 } from "path";
 function parseBuyerFiles(value) {
@@ -29093,7 +29475,7 @@ function assertOneOf4(value, allowed, flag) {
 }
 function parseJsonFileOrInline8(value, flag) {
   const trimmed = value.trim();
-  const raw = trimmed.startsWith("{") || trimmed.startsWith("[") ? trimmed : readFileSync22(value, "utf8");
+  const raw = trimmed.startsWith("{") || trimmed.startsWith("[") ? trimmed : readFileSync23(value, "utf8");
   try {
     return JSON.parse(raw);
   } catch (error) {
@@ -29225,7 +29607,7 @@ function registerProductsCommands2(program2) {
       if (options.description !== void 0 && options.descriptionFile !== void 0) {
         throw new Error("Use either --description or --description-file, not both.");
       }
-      const description = options.descriptionFile !== void 0 ? readFileSync22(options.descriptionFile, "utf8") : options.description;
+      const description = options.descriptionFile !== void 0 ? readFileSync23(options.descriptionFile, "utf8") : options.description;
       const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
       const product = await client.createProduct({
         name: options.name,
@@ -29848,7 +30230,7 @@ function registerProductsCommands2(program2) {
       if (options.content !== void 0 && options.contentFile !== void 0) {
         throw new Error("Use either --content or --content-file, not both.");
       }
-      const editorContent = options.contentFile !== void 0 ? readFileSync22(options.contentFile, "utf8") : options.content;
+      const editorContent = options.contentFile !== void 0 ? readFileSync23(options.contentFile, "utf8") : options.content;
       if (editorContent === void 0) {
         throw new Error("Pass the description via --content or --content-file.");
       }
@@ -29954,7 +30336,7 @@ function registerProductsCommands2(program2) {
     if (options.content !== void 0 && options.contentFile !== void 0) {
       throw new Error("Use either --content or --content-file, not both.");
     }
-    return options.contentFile !== void 0 ? readFileSync22(options.contentFile, "utf8") : options.content;
+    return options.contentFile !== void 0 ? readFileSync23(options.contentFile, "utf8") : options.content;
   };
   kb.command("get").description(
     "Show the knowledge base: categories (tree keys = the --category ids) + all articles (drafts and unavailable included \u2014 the creator view)"
@@ -30174,7 +30556,7 @@ function registerProductsCommands2(program2) {
 }
 
 // src/commands/referrals/index.ts
-import { readFileSync as readFileSync23 } from "fs";
+import { readFileSync as readFileSync24 } from "fs";
 var PROGRAM_KINDS = ["referral", "affiliate"];
 var WRITABLE_STATUSES = ["active", "inactive"];
 var ENROLLMENT_MODES = ["open", "inviteOnly", "closed"];
@@ -30203,7 +30585,7 @@ function parseIdList3(value, flag) {
 }
 function parseJsonObjectFileOrInline4(value, flag) {
   const trimmed = value.trim();
-  const raw = trimmed.startsWith("{") ? trimmed : readFileSync23(value, "utf8");
+  const raw = trimmed.startsWith("{") ? trimmed : readFileSync24(value, "utf8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -30570,7 +30952,7 @@ Failed deliveries (${result.failedDeliveries.length})
 }
 
 // src/commands/segments/index.ts
-import { readFileSync as readFileSync24 } from "fs";
+import { readFileSync as readFileSync25 } from "fs";
 var SUBSCRIPTION_STATUSES2 = ["pending", "subscribed", "unsubscribed"];
 function collectRepeatable7(value, previous) {
   return [...previous, value];
@@ -30589,7 +30971,7 @@ function resolveConditions(options) {
     if (hasFlagConditions) {
       throw new Error("Use either condition flags or --json-file, not both.");
     }
-    const raw = readFileSync24(options.jsonFile, "utf8");
+    const raw = readFileSync25(options.jsonFile, "utf8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -30888,7 +31270,7 @@ function registerSegmentsCommands(program2) {
 }
 
 // src/commands/site/index.ts
-import { existsSync as existsSync4, readFileSync as readFileSync25 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync26 } from "fs";
 
 // src/commands/site/librarySections.ts
 var NO_SECTION = "none";
@@ -31070,7 +31452,7 @@ function requireConfirm14(confirm, what) {
 }
 function parseJsonObjectFileOrInline5(value, flag) {
   const trimmed = value.trim();
-  const raw = trimmed.startsWith("{") ? trimmed : readFileSync25(value, "utf8");
+  const raw = trimmed.startsWith("{") ? trimmed : readFileSync26(value, "utf8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -31122,7 +31504,7 @@ function parseDomainList(value, what) {
   return items;
 }
 function readMarkdownOrFile(value) {
-  return existsSync4(value) ? readFileSync25(value, "utf8") : value;
+  return existsSync4(value) ? readFileSync26(value, "utf8") : value;
 }
 function assertNonEmptyBody(body, hint) {
   if (Object.keys(body).length === 0) {
@@ -31311,6 +31693,26 @@ function registerSiteCommands2(program2) {
     const result = await client.getSiteSettings();
     emit(flags, result, () => printSiteSummary(result.settings, result.communication));
   });
+  site.command("scripts").description(
+    "The site's own scripts (head / end of body of every page-editor page), read only: change them in the dashboard (Site \u2192 Settings \u2192 Custom scripts)"
+  ).action(async (_options, command) => {
+    const flags = getGlobalFlags(command);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.getSiteCustomScripts();
+    emit(flags, result, () => {
+      if (!result.available) {
+        process.stdout.write("Custom scripts are not available for this workspace.\n");
+        return;
+      }
+      process.stdout.write(`head:
+${result.head || "(empty)"}
+
+`);
+      process.stdout.write(`body end:
+${result.bodyEnd || "(empty)"}
+`);
+    });
+  });
   const update = site.command("update").description(
     "Update ONE section of the site settings atomically. Every section accepts --json=<file|inline> (write it with `=` \u2014 a bare --json is the global JSON-output flag); typed flags override keys from --json"
   );
@@ -31793,13 +32195,15 @@ function printStorefront(config) {
 }
 
 // src/commands/smsCampaigns/index.ts
-import { readFileSync as readFileSync26 } from "fs";
+import { readFileSync as readFileSync27 } from "fs";
 var SMS_PROVIDERS2 = ["twilio", "smsapi"];
 var RECIPIENT_STATUSES2 = [
   "pending",
   "sent",
   "failed",
-  "skipped-invalid-number"
+  "skipped-invalid-number",
+  "skipped-duplicate-number",
+  "skipped-opted-out-number"
 ];
 var SCHEDULER_UNAVAILABLE_STATUS4 = 503;
 function parsePositiveInt15(value, flag) {
@@ -31826,7 +32230,7 @@ function resolveBody(options) {
   if (options.body !== void 0 && options.bodyFile !== void 0) {
     throw new Error("Use either --body or --body-file, not both.");
   }
-  return options.bodyFile !== void 0 ? readFileSync26(options.bodyFile, "utf8") : options.body;
+  return options.bodyFile !== void 0 ? readFileSync27(options.bodyFile, "utf8") : options.body;
 }
 function resolveAudience2(options) {
   if (options.segment !== void 0 && options.allSubscribed) {
@@ -31892,7 +32296,7 @@ function printCampaignDetail2(campaign) {
 `);
   const { stats } = campaign;
   process.stdout.write(
-    `  Stats: sent ${stats.sent}, failed ${stats.failed}, skipped (invalid number) ${stats.skippedInvalidNumber}, billed parts ${stats.segments}
+    `  Stats: sent ${stats.sent}, failed ${stats.failed}, skipped (invalid number) ${stats.skippedInvalidNumber}, skipped (duplicate number) ${stats.skippedDuplicateNumber ?? 0}, skipped (opted-out number) ${stats.skippedOptedOutNumber ?? 0}, billed parts ${stats.segments}
 `
   );
   process.stdout.write(`  Opt-out line: ${campaign.optOutHint ?? "(none)"}
@@ -32401,11 +32805,13 @@ function composeInput(options) {
     ...options.publish ? { publish: true } : {}
   };
 }
-function registerSocialCommands(program2) {
+function registerSocialCommands2(program2) {
   const social = program2.command("social").description(
     "Social media \u2014 connected accounts, posts (drafts, scheduling, publishing) and the stats of the connected accounts (youtube / instagram / threads / snapshot)"
   );
-  social.command("accounts").description("List connected social accounts (the values to pass as --targets)").action(async (_, command) => {
+  social.command("accounts").description(
+    "List connected social accounts (the values to pass as --targets; a bare network name such as `instagram` goes to the account marked default)"
+  ).action(async (_, command) => {
     const flags = getGlobalFlags(command);
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const response = await client.listSocialAccounts();
@@ -32415,11 +32821,12 @@ function registerSocialCommands(program2) {
           target: a.target,
           network: a.network,
           label: a.label,
+          default: a.isDefault ? "yes" : "no",
           schedule: a.supportsScheduling ? "yes" : "no",
           publishNow: a.supportsImmediatePublish ? "yes" : "no",
           firstComment: a.firstCommentNeedsReconnect ? "reconnect" : ""
         })),
-        ["target", "network", "label", "schedule", "publishNow", "firstComment"]
+        ["target", "network", "label", "default", "schedule", "publishNow", "firstComment"]
       );
     });
   });
@@ -32966,7 +33373,7 @@ ${integration.name}: ${integration.healthExplanation}
 }
 
 // src/commands/studio/drafts.ts
-import { readFileSync as readFileSync27 } from "fs";
+import { readFileSync as readFileSync28 } from "fs";
 var TEXT_PREVIEW_LENGTH = 60;
 function parseWeakReason(value) {
   const reason = STUDIO_SOCIAL_DRAFT_WEAK_REASONS.find(
@@ -33088,7 +33495,7 @@ function registerStudioDraftsCommands(program2) {
       if (options.text !== void 0 && options.textFile !== void 0) {
         throw new Error("Use either --text or --text-file, not both.");
       }
-      const text = options.textFile !== void 0 ? readFileSync27(options.textFile, "utf8") : options.text;
+      const text = options.textFile !== void 0 ? readFileSync28(options.textFile, "utf8") : options.text;
       requireConfirm(options.confirm, `create a draft social post from ${draftId}`);
       const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
       const result = await client.sendStudioSocialDraftToComposer(draftId, {
@@ -33736,7 +34143,7 @@ Next page: --cursor ${page.nextCursor}
 }
 
 // src/commands/workflows/index.ts
-import { readFileSync as readFileSync28 } from "fs";
+import { readFileSync as readFileSync30 } from "fs";
 
 // src/commands/workflows/authoring.ts
 import { writeFileSync as writeFileSync6 } from "fs";
@@ -33904,6 +34311,89 @@ function registerWorkflowAuthoringCommands(workflows) {
   });
 }
 
+// src/commands/workflows/emailConditions.ts
+import { readFileSync as readFileSync29 } from "fs";
+function collectRepeatable8(value, previous) {
+  return [...previous, value];
+}
+function parseCustomValues(pairs) {
+  const values = {};
+  for (const pair of pairs) {
+    const at = pair.indexOf("=");
+    const key = at > 0 ? pair.slice(0, at).trim().replace(/^custom\./, "") : "";
+    if (!key) throw new Error(`Invalid --custom ${pair} (expected <key>=<value>)`);
+    values[key] = pair.slice(at + 1);
+  }
+  return values;
+}
+function buildInput(options) {
+  if (options.body !== void 0 && options.bodyFile !== void 0) {
+    throw new Error("Pass either --body or --body-file, not both.");
+  }
+  const body = options.bodyFile !== void 0 ? readFileSync29(options.bodyFile, "utf8") : options.body;
+  if (options.subject === void 0 && options.preheader === void 0 && body === void 0) {
+    throw new Error("Pass at least one of --subject, --preheader, --body or --body-file.");
+  }
+  const custom = parseCustomValues(options.custom);
+  const withContact = options.firstName !== void 0 || Object.keys(custom).length > 0;
+  return {
+    ...options.subject !== void 0 ? { subject: options.subject } : {},
+    ...options.preheader !== void 0 ? { preheader: options.preheader } : {},
+    ...body !== void 0 ? { body } : {},
+    ...withContact ? {
+      exampleContact: {
+        ...options.firstName !== void 0 ? { firstName: options.firstName } : {},
+        ...Object.keys(custom).length > 0 ? { custom } : {}
+      }
+    } : {}
+  };
+}
+function printResult(result) {
+  const lines = [];
+  if (!result.hasConditions) {
+    lines.push("No {% %} conditions in these texts.");
+  } else if (result.valid) {
+    lines.push("Every condition tag parses.");
+  } else {
+    lines.push(`${result.warnings.length} problem(s); the send would use the safe text:`);
+    for (const warning of result.warnings) {
+      lines.push(`  [${warning.field}] ${warning.tag} (${warning.code}): ${warning.detail}`);
+    }
+  }
+  if (result.customFieldKeys.length > 0) {
+    lines.push(`Custom fields read: ${result.customFieldKeys.join(", ")}`);
+  }
+  if (result.exampleResult) {
+    lines.push("For the example contact:");
+    for (const field of ["subject", "preheader", "body"]) {
+      const text = result.exampleResult[field];
+      if (text !== void 0) lines.push(`  ${field}: ${text}`);
+    }
+  }
+  if (result.evaluatedForWorkspace) {
+    lines.push("Conditions are evaluated in this workspace (workflow and library e-mails).");
+  }
+  if (result.note) lines.push(result.note);
+  process.stdout.write(`${lines.join("\n")}
+`);
+}
+function registerEmailConditionsCommand(workflows) {
+  workflows.command("check-email-conditions").description(
+    "Check {% if %} / {% case %} conditional content in a workflow or library e-mail before saving it (read-only; not for e-mail campaigns, which send the default version)"
+  ).option("--subject <text>", "e-mail subject, as it will be saved").option("--preheader <text>", "inbox preview line").option("--body <markdown>", "e-mail body (markdown)").option("--body-file <path>", "read the body (markdown) from a file").option("--first-name <name>", "example contact: first name").option(
+    "--custom <key=value>",
+    "example contact: a custom field value as the e-mail prints it (a select = its option label; repeatable)",
+    collectRepeatable8,
+    []
+  ).action(async (options, command) => {
+    const flags = getGlobalFlags(command);
+    const input = buildInput(options);
+    const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
+    const result = await client.checkEmailConditions(input);
+    emit(flags, result, () => printResult(result));
+  });
+}
+
 // src/commands/workflows/index.ts
 function parsePositiveInt18(value, flag) {
   const n = Number.parseInt(value, 10);
@@ -33919,7 +34409,7 @@ function requireConfirm17(confirm, what) {
 }
 function parseTriggerContext(value) {
   const trimmed = value.trim();
-  const raw = trimmed.startsWith("{") ? trimmed : readFileSync28(value, "utf8");
+  const raw = trimmed.startsWith("{") ? trimmed : readFileSync30(value, "utf8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -34124,6 +34614,7 @@ Follow it with: zanfia workflows runs ${automationId}
     }
   );
   registerWorkflowAuthoringCommands(workflows);
+  registerEmailConditionsCommand(workflows);
 }
 function formatProductScope(workflow) {
   return workflow.productIds.length > 0 ? String(workflow.productIds.length) : "all";
@@ -34699,11 +35190,11 @@ function applyShortHelp(program2) {
 
 // src/program.ts
 function resolveCliVersion() {
-  if ("0.23.0".length > 0) {
-    return "0.23.0";
+  if ("0.25.0".length > 0) {
+    return "0.25.0";
   }
   try {
-    const raw = readFileSync29(new URL("../package.json", import.meta.url), "utf8");
+    const raw = readFileSync31(new URL("../package.json", import.meta.url), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed === "object" && parsed !== null && "version" in parsed) {
       const { version: version2 } = parsed;
@@ -34776,7 +35267,7 @@ Signing in \u2014 two roles, two consent pages:
   registerWorkspaceCommands(program2);
   registerFunnelsCommands(program2);
   registerPagesCommands(program2);
-  registerSocialCommands(program2);
+  registerSocialCommands2(program2);
   registerMediaCommands(program2);
   registerFilesCommands(program2);
   registerStudioDraftsCommands(program2);

package/package.json

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