@monetize.software/sdk 3.0.0-alpha.12 → 3.0.0-alpha.13

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./core.cjs"),r=require("./chunks/PaywallUI-CSgfmhHq.js");exports.ApiClient=e.ApiClient;exports.ApiGatewayClient=e.ApiGatewayClient;exports.AuthClient=e.AuthClient;exports.BillingClient=e.BillingClient;exports.EventTracker=e.EventTracker;exports.PaywallError=e.PaywallError;exports.QuotaExceededError=e.QuotaExceededError;exports.SDK_VERSION=e.SDK_VERSION;exports.STORAGE_KEYS=e.STORAGE_KEYS;exports.createStorage=e.createStorage;exports.ensureVisitorId=e.ensureVisitorId;exports.findApplicableOffer=e.findApplicableOffer;exports.generateVisitorId=e.generateVisitorId;exports.offerStartStorageKey=e.offerStartStorageKey;exports.readBrowserOfferStart=e.readBrowserOfferStart;exports.resolveOffer=e.resolveOffer;exports.PaywallUI=r.PaywallUI;exports.blockRegistry=r.blockRegistry;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./core.cjs"),r=require("./chunks/PaywallUI-DA8Kj9fJ.js");exports.ApiClient=e.ApiClient;exports.ApiGatewayClient=e.ApiGatewayClient;exports.AuthClient=e.AuthClient;exports.BillingClient=e.BillingClient;exports.EventTracker=e.EventTracker;exports.PaywallError=e.PaywallError;exports.QuotaExceededError=e.QuotaExceededError;exports.SDK_VERSION=e.SDK_VERSION;exports.STORAGE_KEYS=e.STORAGE_KEYS;exports.createStorage=e.createStorage;exports.ensureVisitorId=e.ensureVisitorId;exports.findApplicableOffer=e.findApplicableOffer;exports.generateVisitorId=e.generateVisitorId;exports.offerStartStorageKey=e.offerStartStorageKey;exports.readBrowserOfferStart=e.readBrowserOfferStart;exports.resolveOffer=e.resolveOffer;exports.PaywallUI=r.PaywallUI;exports.blockRegistry=r.blockRegistry;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -770,6 +770,17 @@ export declare class BillingClient {
         errorUrl?: string;
         shopUrl?: string;
         trialDays?: number;
+        /** Активный offer для этой цены — резолвится host'ом через
+         *  `paywall.getOfferForPrice(priceId)?.offer.id` или
+         *  `findApplicableOffer(client.getCachedOffers(), priceId)?.id`. Без
+         *  явной передачи бэк сделает auto-resolve по email — но только для
+         *  end_date-офферов. duration_minutes-офферы тикают в clientStorage и
+         *  сервер их не видит: для них offerId ОБЯЗАН прийти от клиента, иначе
+         *  скидка не применится на чекауте, хотя UI её показывал.
+         *
+         *  Передавать offer-id всегда безопасно — бэк сам проверит applicable
+         *  ли offer к этому юзеру (страна/email/режим) и игнорирует если нет. */
+        offerId?: string;
         /**
          * Stage 1 защиты от дубликатов покупок. Идемпотентный ключ запроса
          * (UUID). Повторный вызов с тем же ключом вернёт тот же checkout-URL
@@ -1469,12 +1480,25 @@ declare type PaywallStateListener = (state: PaywallStateSnapshot) => void;
  * один call onState; повторы (`useSyncExternalStore`-friendly).
  */
 export declare interface PaywallStateSnapshot {
-    /** Модалка отрендерена и видна. False — closed (или ещё не открывалась). */
+    /** Модалка отрендерена и видна. False — closed (или ещё не открывалась).
+     *  Может быть false при `processing=true` — direct-checkout (paywall.checkout)
+     *  делает bootstrap + createCheckout headless до того, как решит надо ли
+     *  монтировать модалку. */
     open: boolean;
     /** Что показывается в модалке. null когда `open=false`. */
     view: 'loading' | 'error' | 'layout' | 'auth' | 'support' | 'awaiting_payment' | 'popup_blocked' | 'purchased' | null;
     /** Заполнено только когда `view === 'error'`. */
     error: PaywallError | null;
+    /** SDK делает фоновую работу для `paywall.checkout(priceId)` — bootstrap,
+     *  visibility/trial-gates, createCheckout — до того, как реально нужна
+     *  UI-модалка. Хост на этой фазе может задизейблить свою кнопку и
+     *  показать спиннер прямо на ней, чтобы у юзера не было ощущения «клик
+     *  ничего не сделал». Сбрасывается в false сразу после mountAndShow
+     *  (модалка взяла на себя UI), либо после headless reject (already-paid,
+     *  ошибка createCheckout без модалки). Для `paywall.open()`-flow всегда
+     *  false: там модалка появляется мгновенно со своим LoadingView и
+     *  отдельный «processing» не нужен. */
+    processing: boolean;
 }
 
 export declare class PaywallUI {
@@ -1616,26 +1640,39 @@ export declare class PaywallUI {
      */
     openSignup(opts?: OpenOptions): void;
     /**
-     * Direct-checkout: открыть модалку и сразу перейти к /start-checkout по
-     * конкретной цене, минуя layout с тарифами. Полезно когда host-приложение
-     * рендерит pricing-карточки/таблицу собственным UI и хочет, чтобы клик по
-     * «Buy / Get this plan» вёл прямо в платёжного провайдера, без второго
-     * выбора плана в модалке SDK.
-     *
-     * Что переиспользуется из обычного `open()`-flow:
-     *  - `checkout_mode='preauth'` + managed-auth → auth-gate (форма signin'а),
-     *    после успеха auto-resume в createCheckout;
-     *  - popup_blocked / awaiting_payment / purchase_success views;
-     *  - UserWatcher polling после `checkout_started`;
-     *  - аналитика `checkout_started`/`purchase_completed`/`purchase_failed`.
-     *
-     * Что отличается от `open()`:
-     *  - layout с тарифами не показывается ни на один кадр (включая откат после
-     *    ошибки — модалка закрывается, эмитится `error`);
-     *  - already-paid сценарий (cached user, fresh bootstrap, preauth-resume,
-     *    409 hasActivePurchase от бэка) — НЕ показывает restored success-view,
-     *    эмитит `purchase_completed{restored:true}` и закрывает/не открывает
-     *    модалку. Host сам решает как сообщить юзеру.
+     * Direct-checkout: создать checkout-URL по конкретной цене и сразу открыть
+     * платёжного провайдера, минуя layout с тарифами. Полезно когда
+     * host-приложение рендерит pricing-карточки/таблицу собственным UI и
+     * хочет, чтобы клик по «Buy / Get this plan» вёл прямо в Stripe/Paddle.
+     *
+     * **Late-mount UX.** В отличие от `open()`, модалка не появляется во время
+     * фоновой работы (bootstrap + visibility/trial gates + createCheckout).
+     * Хост на этой фазе показывает busy-state прямо на своей кнопке (через
+     * `state.processing === true` из `paywall.getState()` — или автоматически
+     * через `<PaywallButton priceId>` в sdk-react). Модалка монтируется
+     * ТОЛЬКО когда реально нужна UI:
+     *  - `checkout_mode='preauth'` + managed-auth + не залогинен → auth-gate
+     *    (форма signin'а); после успеха auto-resume в createCheckout.
+     *  - popup провайдера заблокирован браузером → popup_blocked view с
+     *    retry-кнопкой под fresh user gesture.
+     *  - popup открылся успешно → awaiting_payment view (индикатор «оплати
+     *    в новой вкладке» + I've paid).
+     *
+     * Что эмитится без модалки:
+     *  - `purchase_completed{restored:true, priceId}` когда юзер уже подписан
+     *    (cached user, fresh bootstrap, или 409 hasActivePurchase от бэка) —
+     *    headless reject;
+     *  - `error` когда createCheckout упал или identity.email отсутствует;
+     *  - `visibility_blocked` / `trial_blocked` — стандартные gate-эвенты.
+     *
+     * Что эмитится одновременно с модалкой:
+     *  - `checkout_started{priceId, url, acquiring}` ровно когда headless URL
+     *    получен, ДО mount'а awaiting_payment/popup_blocked.
+     *
+     * Offer (countdown-скидка) автоматически резолвится из cached offers'ов
+     * через `getOfferForPrice(priceId)` и передаётся в createCheckout как
+     * `offerId` — чтобы duration_minutes-офферы тоже применились на бэке
+     * (для них нет server-side таймера, без явного offer-id скидка теряется).
      *
      * Требования:
      *  - `identity.email` должен быть выставлен (через `opts.identity`, либо
@@ -1644,12 +1681,23 @@ export declare class PaywallUI {
      *  - В `checkout_mode='preauth'` без managed-auth — backend требует
      *    email-юзера; убедись что `identity.email` явно задан.
      *
-     * Без модалки/полностью headless (когда host рендерит свой checkout-UI и
-     * хочет только URL) — используй `paywall.billing.createCheckout({priceId})`
-     * напрямую, но тогда auth-gate / popup_blocked / awaiting_payment придётся
-     * рисовать самостоятельно.
+     * Без модалки совсем (когда host рендерит свой awaiting-payment экран) —
+     * используй `paywall.billing.createCheckout({priceId, offerId})` напрямую,
+     * но тогда auth-gate / popup_blocked / awaiting_payment придётся рисовать
+     * самостоятельно.
      */
     checkout(priceId: string, opts?: OpenOptions): void;
+    /** Headless prep-work для `checkout(priceId, opts)`: bootstrap → gates →
+     *  preauth check → createCheckout → mount модалки с финальным view.
+     *  Вынесено отдельным методом ради чистого async/await flow вместо вложенных
+     *  then-chain'ов (5+ ветвей). Любая ошибка не пробрасывается наружу: эмитим
+     *  через `paywall.emit('error')` и выходим — host подписан на `error`-event. */
+    private runDirectCheckout;
+    /** Trial-check без mount'а (для late-mount direct-checkout). Возвращает
+     *  true если trial заблокировал — caller должен прекратить flow. На любой
+     *  storage-ошибке log+продолжаем (не блокируем продажу). */
+    private checkTrialBeforeCheckout;
+    private applyProcessing;
     /**
      * Headless anonymous signin без открытия модалки. Внутри:
      * idempotent (если уже анон — instant return) → resume через сохранённый

package/dist/index.js

@@ -1,5 +1,5 @@
 import { ApiClient as t, ApiGatewayClient as a, AuthClient as i, BillingClient as o, EventTracker as l, PaywallError as f, QuotaExceededError as n, SDK_VERSION as s, STORAGE_KEYS as S, createStorage as E, ensureVisitorId as d, findApplicableOffer as p, generateVisitorId as c, offerStartStorageKey as g, readBrowserOfferStart as y, resolveOffer as A } from "./core.js";
-import { P as w, b as C } from "./chunks/PaywallUI-pb7JpLr6.js";
+import { P as w, b as C } from "./chunks/PaywallUI-vv6Hw8su.js";
 export {
   t as ApiClient,
   a as ApiGatewayClient,

package/dist/ui.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/PaywallUI-CSgfmhHq.js");exports.PaywallUI=e.PaywallUI;exports.blockRegistry=e.blockRegistry;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/PaywallUI-DA8Kj9fJ.js");exports.PaywallUI=e.PaywallUI;exports.blockRegistry=e.blockRegistry;
 //# sourceMappingURL=ui.cjs.map

package/dist/ui.d.ts

@@ -756,6 +756,17 @@ declare class BillingClient {
         errorUrl?: string;
         shopUrl?: string;
         trialDays?: number;
+        /** Активный offer для этой цены — резолвится host'ом через
+         *  `paywall.getOfferForPrice(priceId)?.offer.id` или
+         *  `findApplicableOffer(client.getCachedOffers(), priceId)?.id`. Без
+         *  явной передачи бэк сделает auto-resolve по email — но только для
+         *  end_date-офферов. duration_minutes-офферы тикают в clientStorage и
+         *  сервер их не видит: для них offerId ОБЯЗАН прийти от клиента, иначе
+         *  скидка не применится на чекауте, хотя UI её показывал.
+         *
+         *  Передавать offer-id всегда безопасно — бэк сам проверит applicable
+         *  ли offer к этому юзеру (страна/email/режим) и игнорирует если нет. */
+        offerId?: string;
         /**
          * Stage 1 защиты от дубликатов покупок. Идемпотентный ключ запроса
          * (UUID). Повторный вызов с тем же ключом вернёт тот же checkout-URL
@@ -1398,12 +1409,25 @@ declare type PaywallStateListener = (state: PaywallStateSnapshot) => void;
  * один call onState; повторы (`useSyncExternalStore`-friendly).
  */
 export declare interface PaywallStateSnapshot {
-    /** Модалка отрендерена и видна. False — closed (или ещё не открывалась). */
+    /** Модалка отрендерена и видна. False — closed (или ещё не открывалась).
+     *  Может быть false при `processing=true` — direct-checkout (paywall.checkout)
+     *  делает bootstrap + createCheckout headless до того, как решит надо ли
+     *  монтировать модалку. */
     open: boolean;
     /** Что показывается в модалке. null когда `open=false`. */
     view: 'loading' | 'error' | 'layout' | 'auth' | 'support' | 'awaiting_payment' | 'popup_blocked' | 'purchased' | null;
     /** Заполнено только когда `view === 'error'`. */
     error: PaywallError | null;
+    /** SDK делает фоновую работу для `paywall.checkout(priceId)` — bootstrap,
+     *  visibility/trial-gates, createCheckout — до того, как реально нужна
+     *  UI-модалка. Хост на этой фазе может задизейблить свою кнопку и
+     *  показать спиннер прямо на ней, чтобы у юзера не было ощущения «клик
+     *  ничего не сделал». Сбрасывается в false сразу после mountAndShow
+     *  (модалка взяла на себя UI), либо после headless reject (already-paid,
+     *  ошибка createCheckout без модалки). Для `paywall.open()`-flow всегда
+     *  false: там модалка появляется мгновенно со своим LoadingView и
+     *  отдельный «processing» не нужен. */
+    processing: boolean;
 }
 
 export declare class PaywallUI {
@@ -1545,26 +1569,39 @@ export declare class PaywallUI {
      */
     openSignup(opts?: OpenOptions): void;
     /**
-     * Direct-checkout: открыть модалку и сразу перейти к /start-checkout по
-     * конкретной цене, минуя layout с тарифами. Полезно когда host-приложение
-     * рендерит pricing-карточки/таблицу собственным UI и хочет, чтобы клик по
-     * «Buy / Get this plan» вёл прямо в платёжного провайдера, без второго
-     * выбора плана в модалке SDK.
-     *
-     * Что переиспользуется из обычного `open()`-flow:
-     *  - `checkout_mode='preauth'` + managed-auth → auth-gate (форма signin'а),
-     *    после успеха auto-resume в createCheckout;
-     *  - popup_blocked / awaiting_payment / purchase_success views;
-     *  - UserWatcher polling после `checkout_started`;
-     *  - аналитика `checkout_started`/`purchase_completed`/`purchase_failed`.
-     *
-     * Что отличается от `open()`:
-     *  - layout с тарифами не показывается ни на один кадр (включая откат после
-     *    ошибки — модалка закрывается, эмитится `error`);
-     *  - already-paid сценарий (cached user, fresh bootstrap, preauth-resume,
-     *    409 hasActivePurchase от бэка) — НЕ показывает restored success-view,
-     *    эмитит `purchase_completed{restored:true}` и закрывает/не открывает
-     *    модалку. Host сам решает как сообщить юзеру.
+     * Direct-checkout: создать checkout-URL по конкретной цене и сразу открыть
+     * платёжного провайдера, минуя layout с тарифами. Полезно когда
+     * host-приложение рендерит pricing-карточки/таблицу собственным UI и
+     * хочет, чтобы клик по «Buy / Get this plan» вёл прямо в Stripe/Paddle.
+     *
+     * **Late-mount UX.** В отличие от `open()`, модалка не появляется во время
+     * фоновой работы (bootstrap + visibility/trial gates + createCheckout).
+     * Хост на этой фазе показывает busy-state прямо на своей кнопке (через
+     * `state.processing === true` из `paywall.getState()` — или автоматически
+     * через `<PaywallButton priceId>` в sdk-react). Модалка монтируется
+     * ТОЛЬКО когда реально нужна UI:
+     *  - `checkout_mode='preauth'` + managed-auth + не залогинен → auth-gate
+     *    (форма signin'а); после успеха auto-resume в createCheckout.
+     *  - popup провайдера заблокирован браузером → popup_blocked view с
+     *    retry-кнопкой под fresh user gesture.
+     *  - popup открылся успешно → awaiting_payment view (индикатор «оплати
+     *    в новой вкладке» + I've paid).
+     *
+     * Что эмитится без модалки:
+     *  - `purchase_completed{restored:true, priceId}` когда юзер уже подписан
+     *    (cached user, fresh bootstrap, или 409 hasActivePurchase от бэка) —
+     *    headless reject;
+     *  - `error` когда createCheckout упал или identity.email отсутствует;
+     *  - `visibility_blocked` / `trial_blocked` — стандартные gate-эвенты.
+     *
+     * Что эмитится одновременно с модалкой:
+     *  - `checkout_started{priceId, url, acquiring}` ровно когда headless URL
+     *    получен, ДО mount'а awaiting_payment/popup_blocked.
+     *
+     * Offer (countdown-скидка) автоматически резолвится из cached offers'ов
+     * через `getOfferForPrice(priceId)` и передаётся в createCheckout как
+     * `offerId` — чтобы duration_minutes-офферы тоже применились на бэке
+     * (для них нет server-side таймера, без явного offer-id скидка теряется).
      *
      * Требования:
      *  - `identity.email` должен быть выставлен (через `opts.identity`, либо
@@ -1573,12 +1610,23 @@ export declare class PaywallUI {
      *  - В `checkout_mode='preauth'` без managed-auth — backend требует
      *    email-юзера; убедись что `identity.email` явно задан.
      *
-     * Без модалки/полностью headless (когда host рендерит свой checkout-UI и
-     * хочет только URL) — используй `paywall.billing.createCheckout({priceId})`
-     * напрямую, но тогда auth-gate / popup_blocked / awaiting_payment придётся
-     * рисовать самостоятельно.
+     * Без модалки совсем (когда host рендерит свой awaiting-payment экран) —
+     * используй `paywall.billing.createCheckout({priceId, offerId})` напрямую,
+     * но тогда auth-gate / popup_blocked / awaiting_payment придётся рисовать
+     * самостоятельно.
      */
     checkout(priceId: string, opts?: OpenOptions): void;
+    /** Headless prep-work для `checkout(priceId, opts)`: bootstrap → gates →
+     *  preauth check → createCheckout → mount модалки с финальным view.
+     *  Вынесено отдельным методом ради чистого async/await flow вместо вложенных
+     *  then-chain'ов (5+ ветвей). Любая ошибка не пробрасывается наружу: эмитим
+     *  через `paywall.emit('error')` и выходим — host подписан на `error`-event. */
+    private runDirectCheckout;
+    /** Trial-check без mount'а (для late-mount direct-checkout). Возвращает
+     *  true если trial заблокировал — caller должен прекратить flow. На любой
+     *  storage-ошибке log+продолжаем (не блокируем продажу). */
+    private checkTrialBeforeCheckout;
+    private applyProcessing;
     /**
      * Headless anonymous signin без открытия модалки. Внутри:
      * idempotent (если уже анон — instant return) → resume через сохранённый

package/dist/ui.js

@@ -1,4 +1,4 @@
-import { P as o, b as r } from "./chunks/PaywallUI-pb7JpLr6.js";
+import { P as o, b as r } from "./chunks/PaywallUI-vv6Hw8su.js";
 export {
   o as PaywallUI,
   r as blockRegistry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monetize.software/sdk",
-  "version": "3.0.0-alpha.12",
+  "version": "3.0.0-alpha.13",
   "description": "Monetize SDK — bundled billing client and paywall render engine for web and Chrome extensions",
   "type": "module",
   "sideEffects": false,