@zanfia/cli 0.6.4 → 0.9.0

package/dist/index.js

@@ -5249,9 +5249,9 @@ var require_lodash7 = __commonJS({
   }
 });
 
-// ../../node_modules/combine-errors/node_modules/lodash.uniqby/index.js
+// ../../node_modules/lodash.uniqby/index.js
 var require_lodash8 = __commonJS({
-  "../../node_modules/combine-errors/node_modules/lodash.uniqby/index.js"(exports, module) {
+  "../../node_modules/lodash.uniqby/index.js"(exports, module) {
     "use strict";
     var baseIteratee = require_lodash4();
     var baseUniq = require_lodash7();
@@ -10324,11 +10324,11 @@ var listCertificateTemplatesColumns = ["id", "name", "version", "isDefault", "up
 function registerCertificatesCommands(program2) {
   const certificates = program2.command("certificates");
   certificates.description(
-    "Course-completion certificates \u2014 issue for course clients, revoke/reinstate, resend the email, and manage designer templates (`certificates templates \u2026`)"
+    "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 course-completion certificates of the workspace, newest first, optionally filtered to one course product (`productId`); `limit` caps the rows (service default applies). Each row is the credential: public `certificateId` (`cert_\u2026`, the id every certificate write takes), recipient name/email, course 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 product id \u2014 omit for all courses.").option(
+    "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."
+  ).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).",
     parseNumberOption("--limit", NumberFormat.Integer)
@@ -10345,17 +10345,17 @@ function registerCertificatesCommands(program2) {
     emit(flags, result ?? {}, () => printTable(rows, listCertificatesColumns));
   });
   certificates.command("issue").summary("Issue certificates (async)").description(
-    'Issues course-completion certificates to the listed clients of ONE course product. The call validates the batch (404 unknown product or `templateId`, 400 when the product is not a course), skips clients who already hold a certificate for it (one certificate per client per course, ever) and enqueues one issuance task per remaining client \u2014 PDF rendering and the "certificate issued" email happen asynchronously, so the response is 202 with `enqueued` / `skippedExistingCertificate` counts, not the certificates. Poll list-certificates (`productId` filter) a little later for the issued rows. A single issuance is this call with one `clientId`. With `onlyCompleted: true` a client only gets a certificate if their course progress is completed (checked per client at issuance time). `clientIds` is capped at 1000 and de-duplicated. Every issuance EMAILS the student \u2014 the emails cannot be recalled.'
-  ).argument("<productId>", "Course product id (must be a course).").requiredOption(
+    'Issues certificates to the listed clients of ONE product: a course (completion certificate) or an event \u2014 webinar, workshop, also one held outside Zanfia (participation certificate, "for taking part in", no attendance check). The call validates the batch (404 unknown product or `templateId`, 400 when the product is neither a course nor an event), skips clients who already hold a certificate for it (one certificate per client per product, ever) and enqueues one issuance task per remaining client \u2014 PDF rendering and the "certificate issued" email happen asynchronously, so the response is 202 with `enqueued` / `skippedExistingCertificate` counts, not the certificates. Poll list-certificates (`productId` filter) a little later for the issued rows. A single issuance is this call with one `clientId`. With `onlyCompleted: true` a client only gets a certificate if their course progress is completed (checked per client at issuance time; courses only, 400 for an event). `clientIds` is capped at 1000 and de-duplicated. Every issuance EMAILS the student \u2014 the emails cannot be recalled.'
+  ).argument("<productId>", "Course or event product id (other product types answer 400).").requiredOption(
     "--client <a,b,...>",
     "Workspace client ids; one id = single issuance. Max 1000, de-duplicated.",
     parseCommaList("--client")
   ).option(
     "--only-completed",
-    "Skip clients who have not completed the course (checked per client at issuance time). Default false = issue to everyone listed."
+    "Course products only (400 for an event): skip clients who have not completed the course (checked per client at issuance time). Default false = issue to everyone listed."
   ).option("--no-only-completed", "Send `onlyCompleted: false` explicitly.").option(
     "--template <value>",
-    "Explicit template id; omitted = the course template, else the workspace default."
+    "Explicit template id; omitted = the product template, else the workspace default."
   ).option(
     "--reissue-revoked",
     "Re-issue clients whose current certificate is REVOKED (new document in the current template, new number and verification link, the revoked one stays revoked). ACTIVE certificates are still skipped. Default false = any existing certificate skips the client."
@@ -10593,7 +10593,10 @@ function registerBlogCommands(program2) {
   ).option("--content <value>", "The body as Markdown (headings, lists, links, images by URL).").option(
     "--excerpt <value>",
     "Short plain-text summary (list, RSS, meta description); derived from the body on publish when empty."
-  ).option("--cover <value>", "Cover image URL (Media Library).").option("--tags <a,b,...>", "Lowercase labels, at most 10.", parseCommaList("--tags")).option("--seo <json|file>", "seo", parseJsonObjectFileOrInline("--seo")).option("--publish", "Publish right away (needs a non-empty body); default false = draft.").option("--no-publish", "Send `publish: false` explicitly.").action(async (options, command) => {
+  ).option("--cover <value>", "Cover image URL (Media Library).").option("--tags <a,b,...>", "Lowercase labels, at most 10.", parseCommaList("--tags")).option("--seo <json|file>", "seo", parseJsonObjectFileOrInline("--seo")).option("--publish", "Publish right away (needs a non-empty body); default false = draft.").option("--no-publish", "Send `publish: false` explicitly.").option(
+    "--published-at <value>",
+    "The post's date, ISO 8601 date (2025-10-16) or date-time, not in the future - e.g. the original date of an imported post. Omitted = the moment of the first publication."
+  ).action(async (options, command) => {
     const flags = getGlobalFlags(command);
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const params = {};
@@ -10605,7 +10608,8 @@ function registerBlogCommands(program2) {
       coverImageUrl: options.cover,
       tags: options.tags,
       seo: options.seo,
-      publish: options.publish
+      publish: options.publish,
+      publishedAt: options.publishedAt
     };
     const result = await client.call("POST", "/blog-posts", params, void 0, payload);
     emit(flags, result ?? {}, () => printJson(result ?? {}));
@@ -10633,6 +10637,9 @@ function registerBlogCommands(program2) {
     "--seo <json|file>",
     "Replaces the whole SEO section.",
     parseJsonObjectFileOrInline("--seo")
+  ).option(
+    "--published-at <value>",
+    "The post's date (ISO 8601, not in the future); null clears it on a draft - a published post keeps one."
   ).action(async (id, options, command) => {
     const flags = getGlobalFlags(command);
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
@@ -10646,7 +10653,8 @@ function registerBlogCommands(program2) {
       excerpt: options.excerpt,
       coverImageUrl: options.cover,
       tags: options.tags,
-      seo: options.seo
+      seo: options.seo,
+      publishedAt: options.publishedAt
     };
     const result = await client.call("PATCH", "/blog-posts/:postId", params, void 0, payload);
     emit(flags, result ?? {}, () => printJson(result ?? {}));
@@ -13248,6 +13256,11 @@ function buildConsentInput(options) {
 import { readFileSync as readFileSync7, writeFileSync as writeFileSync2 } from "fs";
 
 // src/client/types.ts
+var GRANT_PAYMENT_METHODS = [
+  "bankTransfer",
+  "cash",
+  "other"
+];
 var AIImageAspectRatio = /* @__PURE__ */ ((AIImageAspectRatio2) => {
   AIImageAspectRatio2["Square"] = "1:1";
   AIImageAspectRatio2["Portrait"] = "4:5";
@@ -13776,6 +13789,40 @@ function registerClientTagsCommands(clients2) {
 var IMPORT_CHUNK_SIZE = 100;
 var SCHEDULER_UNAVAILABLE_STATUS = 503;
 var MAX_BULK_FILTERED_PRODUCTS = 10;
+function parseGrantPayment(options) {
+  const { paid, currency, paidAt, paymentMethod, paymentNote } = options;
+  if (paid === void 0) {
+    if (currency || paidAt || paymentMethod || paymentNote) {
+      throw new Error("--currency, --paid-at, --payment-method and --payment-note need --paid.");
+    }
+    return void 0;
+  }
+  if (!/^\d+([.,]\d{1,2})?$/.test(paid)) {
+    throw new Error(`Invalid --paid amount: ${paid} (expected e.g. 99 or 99.50)`);
+  }
+  const amountCents = Math.round(Number(paid.replace(",", ".")) * 100);
+  if (amountCents <= 0) {
+    throw new Error("--paid must be above 0.");
+  }
+  if (!currency) {
+    throw new Error("--paid needs --currency (pln, eur, usd or gbp).");
+  }
+  if (paidAt !== void 0 && Number.isNaN(Date.parse(paidAt))) {
+    throw new Error(`Invalid --paid-at date: ${paidAt} (expected ISO, e.g. 2026-10-14)`);
+  }
+  if (paymentMethod !== void 0 && !GRANT_PAYMENT_METHODS.includes(paymentMethod)) {
+    throw new Error(
+      `Invalid --payment-method: ${paymentMethod} (one of ${GRANT_PAYMENT_METHODS.join(", ")})`
+    );
+  }
+  return {
+    amountCents,
+    currency: currency.toLowerCase(),
+    ...paidAt !== void 0 ? { paidAt: new Date(paidAt).toISOString() } : {},
+    ...paymentMethod !== void 0 ? { method: paymentMethod } : {},
+    ...paymentNote !== void 0 ? { note: paymentNote } : {}
+  };
+}
 function requireConfirm4(confirm, what) {
   if (!confirm) {
     throw new Error(`Refusing to ${what} without --confirm. Re-run with --confirm to proceed.`);
@@ -14263,7 +14310,13 @@ Next page: --cursor ${page.nextCursor}
       });
     }
   );
-  clients2.command("grant").description("Grant a client access to a product without a purchase").argument("<productId>", "product id").requiredOption("--email <email>", "client email").option("--first-name <name>", "client first name").option("--last-name <name>", "client last name").option("--price <priceId>", "enroll under an existing price without billing").option("--plan <planId>", "plan to enroll in (multi-plan products)").option("--until <date>", "ISO date the access ends (free grants only); omit for lifetime").option("--welcome-email", "send the welcome/sign-in email (default: grant silently)").action(
+  clients2.command("grant").description("Grant a client access to a product without a purchase").argument("<productId>", "product id").requiredOption("--email <email>", "client email").option("--first-name <name>", "client first name").option("--last-name <name>", "client last name").option("--price <priceId>", "enroll under an existing price without billing").option("--plan <planId>", "plan to enroll in (multi-plan products)").option("--until <date>", "ISO date the access ends (free grants only); omit for lifetime").option("--welcome-email", "send the welcome/sign-in email (default: grant silently)").option(
+    "--run-purchase-automations",
+    "also run the product's purchase automations, marked as a grant (default: off)"
+  ).option(
+    "--paid <amount>",
+    "the client already paid outside Zanfia (e.g. 99.50): records one paid order"
+  ).option("--currency <code>", "currency of --paid: pln, eur, usd or gbp").option("--paid-at <date>", "ISO date the client paid (default: now; not in the future)").option("--payment-method <method>", `how they paid: ${GRANT_PAYMENT_METHODS.join(" | ")}`).option("--payment-note <text>", "note on the payment, e.g. the proforma number (max 300)").action(
     async (productId, options, command) => {
       const flags = getGlobalFlags(command);
       if (options.until !== void 0 && Number.isNaN(Date.parse(options.until))) {
@@ -14272,6 +14325,7 @@ Next page: --cursor ${page.nextCursor}
       if (options.until !== void 0 && options.price !== void 0) {
         throw new Error("--until applies to free grants only \u2014 omit --price.");
       }
+      const payment = parseGrantPayment(options);
       const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
       const result = await client.grantClientAccess(productId, {
         email: options.email,
@@ -14280,13 +14334,14 @@ Next page: --cursor ${page.nextCursor}
         priceId: options.price,
         planId: options.plan,
         accessUntil: options.until,
-        sendWelcomeEmail: options.welcomeEmail
+        sendWelcomeEmail: options.welcomeEmail,
+        runPurchaseAutomations: options.runPurchaseAutomations,
+        ...payment ? { payment } : {}
       });
       emit(flags, result, () => {
         const kind = result.isFree ? "free" : "paid";
         process.stdout.write(
-          `Granted ${options.email} ${kind} access to product ${productId}.
-`
+          `Granted ${options.email} ${kind} access to product ${productId}` + (payment ? " and recorded the payment as a paid order" : "") + ".\n"
         );
       });
     }
@@ -19905,7 +19960,7 @@ var NoopUrlStorage = /* @__PURE__ */ (function() {
   }]);
 })();
 
-// ../../node_modules/tus-js-client/node_modules/js-base64/base64.mjs
+// ../../node_modules/js-base64/base64.mjs
 var version = "3.7.8";
 var VERSION = version;
 var _hasBuffer = typeof Buffer === "function";
@@ -25028,6 +25083,7 @@ var PAGE_INTENTS = [
 var SOURCE_SITE_MODES = ["rebuild", "inspired"];
 var EVENT_MODES2 = ["live", "on_demand"];
 var OPT_IN_MODES2 = ["single", "double"];
+var TRACKING_MODES = ["inherit", "selected", "none"];
 var SCHEDULER_UNAVAILABLE_STATUS3 = 503;
 function parseChoice5(value, allowed, flag) {
   const match = allowed.find((candidate) => candidate === value);
@@ -25164,6 +25220,11 @@ function registerPagesCommands(program2) {
 `);
       process.stdout.write(`  Cookie banner: ${page.hideCookieBanner ? "hidden" : "shown"}
 `);
+      const trackingIds = page.tracking?.integrationIds ?? [];
+      process.stdout.write(
+        `  Tracking: ${page.tracking?.mode ?? "inherit"}${trackingIds.length > 0 ? ` (${trackingIds.join(", ")})` : ""}
+`
+      );
     });
   });
   pages.command("create").description("Create a hosted page from an HTML file or inline HTML").requiredOption("--slug <slug>", "public URL slug (served at /page/<slug>)").requiredOption("--title <title>", "page title").option("--file <path>", "path to an .html file to host").option("--html <html>", "inline HTML body (alternative to --file)").option("--publish", "publish immediately instead of saving as draft").action(async (options, command) => {
@@ -25185,17 +25246,33 @@ function registerPagesCommands(program2) {
 `);
     });
   });
-  pages.command("update").description("Update a page (slug, title, HTML body, or cookie-banner visibility)").argument("<id>", "page id").option("--slug <slug>", "new slug").option("--title <title>", "new title").option("--file <path>", "path to a new .html file").option("--html <html>", "new inline HTML body").option("--cookie-banner", "show the workspace cookie banner on this page again").option(
+  pages.command("update").description(
+    "Update a page (slug, title, HTML body, cookie-banner visibility, or its tracking tools)"
+  ).argument("<id>", "page id").option("--slug <slug>", "new slug").option("--title <title>", "new title").option("--file <path>", "path to a new .html file").option("--html <html>", "new inline HTML body").option("--cookie-banner", "show the workspace cookie banner on this page again").option(
     "--no-cookie-banner",
     "hide the workspace cookie banner on this page (pixels still wait for consent given elsewhere)"
+  ).option(
+    "--tracking <mode>",
+    "tracking tools on this page: inherit (workspace defaults), selected (--tracking-integrations) or none"
+  ).option(
+    "--tracking-integrations <ids>",
+    "comma-separated tracking integration ids for --tracking selected (one per platform)"
   ).action(async (id, options, command) => {
     const flags = getGlobalFlags(command);
     const html = await resolveHtml2(options);
+    const trackingIds = options.trackingIntegrations?.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
+    const trackingMode = options.tracking !== void 0 ? parseChoice5(options.tracking, TRACKING_MODES, "--tracking") : trackingIds !== void 0 ? "selected" : void 0;
     const input = {
       slug: options.slug,
       title: options.title,
       html,
-      ...options.cookieBanner !== void 0 ? { hideCookieBanner: !options.cookieBanner } : {}
+      ...options.cookieBanner !== void 0 ? { hideCookieBanner: !options.cookieBanner } : {},
+      ...trackingMode !== void 0 ? {
+        tracking: {
+          mode: trackingMode,
+          ...trackingIds !== void 0 ? { integrationIds: trackingIds } : {}
+        }
+      } : {}
     };
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const result = await client.updatePage(id, input);
@@ -28365,7 +28442,8 @@ var CONVERSION_EVENT_STATUSES = [
   "sent",
   "delivered",
   "failed",
-  "consent_blocked"
+  "consent_blocked",
+  "test_skipped"
 ];
 var CONVERSION_TRACKING_CLIENTS = [
   "metaConversionApi",
@@ -28468,12 +28546,12 @@ function registerStatsCommands(program2) {
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const report = await client.statsSales(range);
     emit(flags, report, () => {
-      const c = report.primaryCurrency;
+      const c = report.currency;
       process.stdout.write(
         `Sales (${report.period.from} \u2192 ${report.period.to}), currency ${c}
-  Net revenue: ${money(report.primaryNetRevenueCents)} ${c}
+  Net revenue: ${money(report.totalRevenueCents)} ${c}
   Transactions: ${report.transactions}  Refunds: ${report.refunds}
-  AOV: ${money(report.aovCents)} ${c}  New subscribers: ${report.totalNewSubscribers}
+  AOV: ${money(report.averageOrderValueCents)} ${c}  New subscribers: ${report.newSubscribers}
 
 `
       );
@@ -28483,7 +28561,7 @@ function registerStatsCommands(program2) {
           report.perProduct.map((r) => ({
             id: r.id,
             name: r.name,
-            revenue: money(r.primaryRevenueCents),
+            revenue: money(r.revenueCents),
             transactions: r.transactions,
             refunds: r.refunds
           })),
@@ -28497,11 +28575,11 @@ function registerStatsCommands(program2) {
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const report = await client.statsRecurring(options.currency);
     emit(flags, report, () => {
-      const c = report.primaryCurrency;
+      const c = report.currency;
       process.stdout.write(
         `Recurring revenue (currency ${c})
-  MRR: ${money(report.primaryMrrCents)} ${c}  ARR: ${money(report.primaryArrCents)} ${c}
-  Active subscriptions: ${report.activeRecurringSubscriptions}  Ending soon: ${report.endingSoonCount}
+  MRR: ${money(report.mrrCents)} ${c}  ARR: ${money(report.arrCents)} ${c}
+  Active subscriptions: ${report.activeSubscriptions}  Ending soon: ${report.endingSoonCount}
 
 `
       );
@@ -28510,8 +28588,8 @@ function registerStatsCommands(program2) {
           report.perProduct.map((r) => ({
             id: r.productId,
             name: r.productName,
-            mrr: money(r.primaryMrrCents),
-            subs: r.activeRecurringSubscriptions
+            mrr: money(r.mrrCents),
+            subs: r.activeSubscriptions
           })),
           ["id", "name", "mrr", "subs"]
         );
@@ -28526,13 +28604,13 @@ function registerStatsCommands(program2) {
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const report = await client.statsMrrHistory(range);
     emit(flags, report, () => {
-      process.stdout.write(`MRR history (currency ${report.primaryCurrency})
+      process.stdout.write(`MRR history (currency ${report.currency})
 `);
       printTable(
         report.points.map((p) => ({
           date: p.date,
           mrr: money(p.mrrCents),
-          subs: p.activeRecurringSubscriptions,
+          subs: p.activeSubscriptions,
           new: money(p.newMrrCents),
           churned: money(p.churnedMrrCents),
           churnRate: `${(p.churnRate * 100).toFixed(1)}%`
@@ -28612,11 +28690,23 @@ function registerStatsCommands(program2) {
           checkout: s.checkoutId,
           stage: s.furthestStage,
           status: s.status,
-          visitor: s.visitorLabel,
-          source: s.source ?? "",
+          converted: s.converted ? "yes" : "",
+          source: s.source.utmSource ?? s.source.referrer ?? "",
+          country: s.country ?? "",
+          declined: s.paymentFailure?.reason ?? "",
           startedAt: s.startedAt
         })),
-        ["id", "checkout", "stage", "status", "visitor", "source", "startedAt"]
+        [
+          "id",
+          "checkout",
+          "stage",
+          "status",
+          "converted",
+          "source",
+          "country",
+          "declined",
+          "startedAt"
+        ]
       );
     });
   });
@@ -28625,7 +28715,7 @@ function registerStatsCommands(program2) {
     const client = createApiClient({ apiKey: flags.apiKey, verbose: flags.verbose });
     const report = await client.statsProduct(productId, options.currency);
     emit(flags, report, () => {
-      const c = report.primaryCurrency;
+      const c = report.currency;
       process.stdout.write(
         `Product ${report.productId} (${report.window.startDate} \u2192 ${report.window.endDate}), currency ${c}
   Revenue: ${money(report.revenue.totalCents)} ${c} (prev ${money(report.revenue.previousTotalCents)} ${c})
@@ -30286,8 +30376,8 @@ function applyShortHelp(program2) {
 
 // src/program.ts
 function resolveCliVersion() {
-  if ("0.6.4".length > 0) {
-    return "0.6.4";
+  if ("0.9.0".length > 0) {
+    return "0.9.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.6.4",
+  "version": "0.9.0",
   "private": false,
   "description": "Zanfia CLI — thin HTTP client over the Zanfia Public API",
   "type": "module",