@monetize.software/sdk 3.0.0-alpha.1 → 3.0.0-alpha.3

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-Dr-6q-HL.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.generateVisitorId=e.generateVisitorId;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-BWU_1hsh.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.generateVisitorId=e.generateVisitorId;exports.PaywallUI=r.PaywallUI;exports.blockRegistry=r.blockRegistry;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -514,6 +514,8 @@ export declare class BillingClient {
     private balancesStorageUnwatch;
     private inflightBalances;
     private balanceListeners;
+    private readonly previewMode;
+    private previewVersionCounter;
     constructor(opts: BillingClientOptions);
     /**
      * Stable visitor_id (UUID v4). Первый вызов awaitит первичный резолв из
@@ -546,6 +548,24 @@ export declare class BillingClient {
      * unsubscribe.
      */
     onBootstrapChange(cb: (b: PaywallBootstrap) => void): () => void;
+    /**
+     * Заменить cachedBootstrap частичными или полными данными и эмитнуть всем
+     * подписчикам. Используется host'ом в preview-mode (редактор админки) для
+     * live-обновления открытой модалки без сетевого revalidate'а.
+     *
+     * Поведение:
+     *  - Без `cachedBootstrap` ожидаются как минимум `settings` + `prices` —
+     *    иначе PaywallRoot не сможет отрендерить тарифы и упадёт.
+     *  - С существующим кешем партиал мёрджится поверх: `settings` глубокий мёрдж
+     *    на 1 уровень (поля настроек), массивы `prices`/`offers` перезаписываются.
+     *  - Каждый вызов бампит `version` ("preview:<n>"), чтобы applyBootstrap'овая
+     *    проверка `versionChanged` всегда срабатывала и listener'ы дёргались.
+     *  - Persist в storage НЕ делаем — preview не должен утекать в другие вкладки.
+     *
+     * В non-preview режиме метод доступен, но это редкий путь (например, для
+     * тестов host'а) — production-код должен полагаться на bootstrap() + revalidate.
+     */
+    setBootstrap(partial: Partial<PaywallBootstrap>): void;
     private fetchBootstrap;
     private revalidateBootstrap;
     private applyBootstrap;
@@ -817,6 +837,16 @@ export declare interface BillingClientOptions {
      * через `setIdentity`, Bearer не отправляется.
      */
     auth?: AuthClient;
+    /**
+     * Preview/editor-mode. Когда true:
+     *  - `bootstrap()` НЕ ходит в сеть — отдаёт только `cachedBootstrap`, заданный
+     *    через `setBootstrap()`. Без seed'а throw'ает (caller обязан засидить до open).
+     *  - Storage.watch / persist отключены (preview редактора локален для текущей вкладки).
+     *  - `setBootstrap(partial)` доступен как публичный setter — host'у разрешено
+     *    мутировать кеш для live-обновления модалки в редакторе админки.
+     * Дефолт false — обычный production-режим.
+     */
+    preview?: boolean;
 }
 
 export declare type BlockComponent<B extends LayoutBlock = LayoutBlock> = ComponentType<BlockProps<B>>;
@@ -1305,6 +1335,8 @@ export declare class PaywallUI {
     private lastVisibility;
     /** Поведение open() при холодном bootstrap'е. См. PaywallUIOptions.mountThenLoad. */
     private mountThenLoad;
+    /** Inline-режим (live-preview редактора). См. PaywallUIOptions.inline. */
+    private inline;
     /** Текущий snapshot UI state-machine. Обновляется PaywallRoot'ом через
      *  `onState` prop; при close сбрасывается обратно в CLOSED_STATE. */
     private currentState;
@@ -1327,6 +1359,17 @@ export declare class PaywallUI {
      * last-known user из кеша синхронно через microtask, если он есть.
      */
     onUserChange(handler: PaywallEventHandler<'userChange'>): () => void;
+    /**
+     * Заменить cachedBootstrap живыми данными — для preview-режима в редакторе
+     * админки. Если модалка открыта, PaywallRoot подписан на onBootstrapChange
+     * и перерендерится мгновенно. До open() — затравка для bootstrap()-effect'а.
+     *
+     * См. {@link BillingClientOptions.preview} — обычно эту опцию ставят на
+     * клиент, чтобы заодно отключить сетевой revalidate. setBootstrap технически
+     * работает и в production-режиме, но конкуренция с revalidate'ом из сети
+     * почти всегда нежелательна.
+     */
+    setBootstrap(partial: Partial<PaywallBootstrap>): void;
     on<E extends PaywallEvent>(event: E, handler: PaywallEventHandler<E>): () => void;
     off<E extends PaywallEvent>(event: E, handler: PaywallEventHandler<E>): void;
     private emit;
@@ -1518,6 +1561,14 @@ export declare interface PaywallUIOptions extends Omit<BillingClientOptions, 'au
      * флеш на blocked-странах/устройствах хуже воспринимаемой латентности.
      */
     mountThenLoad?: boolean;
+    /**
+     * Inline-режим для live-preview редактора админки. Host позиционируется
+     * `absolute inset:0` внутри родителя (вместо fixed-viewport'а), overlay
+     * Modal'а тоже становится absolute, body-scroll не лочится. ОБЯЗАТЕЛЬНО
+     * передавать `host` (HTMLElement) с positioned parent'ом — иначе absolute
+     * уйдёт к ближайшему positioned ancestor'у или к html. По умолчанию false.
+     */
+    inline?: boolean;
 }
 
 export declare interface PaywallUser {

package/dist/index.js

@@ -1,5 +1,5 @@
 import { ApiClient as t, ApiGatewayClient as a, AuthClient as i, BillingClient as l, EventTracker as o, PaywallError as n, QuotaExceededError as E, SDK_VERSION as s, STORAGE_KEYS as S, createStorage as c, ensureVisitorId as d, generateVisitorId as g } from "./core.js";
-import { P as y, b as A } from "./chunks/PaywallUI-BHp9afFC.js";
+import { P as y, b as A } from "./chunks/PaywallUI-C3W0eKDo.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-Dr-6q-HL.js");exports.PaywallUI=e.PaywallUI;exports.blockRegistry=e.blockRegistry;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/PaywallUI-BWU_1hsh.js");exports.PaywallUI=e.PaywallUI;exports.blockRegistry=e.blockRegistry;
 //# sourceMappingURL=ui.cjs.map

package/dist/ui.d.ts

@@ -500,6 +500,8 @@ declare class BillingClient {
     private balancesStorageUnwatch;
     private inflightBalances;
     private balanceListeners;
+    private readonly previewMode;
+    private previewVersionCounter;
     constructor(opts: BillingClientOptions);
     /**
      * Stable visitor_id (UUID v4). Первый вызов awaitит первичный резолв из
@@ -532,6 +534,24 @@ declare class BillingClient {
      * unsubscribe.
      */
     onBootstrapChange(cb: (b: PaywallBootstrap) => void): () => void;
+    /**
+     * Заменить cachedBootstrap частичными или полными данными и эмитнуть всем
+     * подписчикам. Используется host'ом в preview-mode (редактор админки) для
+     * live-обновления открытой модалки без сетевого revalidate'а.
+     *
+     * Поведение:
+     *  - Без `cachedBootstrap` ожидаются как минимум `settings` + `prices` —
+     *    иначе PaywallRoot не сможет отрендерить тарифы и упадёт.
+     *  - С существующим кешем партиал мёрджится поверх: `settings` глубокий мёрдж
+     *    на 1 уровень (поля настроек), массивы `prices`/`offers` перезаписываются.
+     *  - Каждый вызов бампит `version` ("preview:<n>"), чтобы applyBootstrap'овая
+     *    проверка `versionChanged` всегда срабатывала и listener'ы дёргались.
+     *  - Persist в storage НЕ делаем — preview не должен утекать в другие вкладки.
+     *
+     * В non-preview режиме метод доступен, но это редкий путь (например, для
+     * тестов host'а) — production-код должен полагаться на bootstrap() + revalidate.
+     */
+    setBootstrap(partial: Partial<PaywallBootstrap>): void;
     private fetchBootstrap;
     private revalidateBootstrap;
     private applyBootstrap;
@@ -803,6 +823,16 @@ declare interface BillingClientOptions {
      * через `setIdentity`, Bearer не отправляется.
      */
     auth?: AuthClient;
+    /**
+     * Preview/editor-mode. Когда true:
+     *  - `bootstrap()` НЕ ходит в сеть — отдаёт только `cachedBootstrap`, заданный
+     *    через `setBootstrap()`. Без seed'а throw'ает (caller обязан засидить до open).
+     *  - Storage.watch / persist отключены (preview редактора локален для текущей вкладки).
+     *  - `setBootstrap(partial)` доступен как публичный setter — host'у разрешено
+     *    мутировать кеш для live-обновления модалки в редакторе админки.
+     * Дефолт false — обычный production-режим.
+     */
+    preview?: boolean;
 }
 
 export declare type BlockComponent<B extends LayoutBlock = LayoutBlock> = ComponentType<BlockProps<B>>;
@@ -1244,6 +1274,8 @@ export declare class PaywallUI {
     private lastVisibility;
     /** Поведение open() при холодном bootstrap'е. См. PaywallUIOptions.mountThenLoad. */
     private mountThenLoad;
+    /** Inline-режим (live-preview редактора). См. PaywallUIOptions.inline. */
+    private inline;
     /** Текущий snapshot UI state-machine. Обновляется PaywallRoot'ом через
      *  `onState` prop; при close сбрасывается обратно в CLOSED_STATE. */
     private currentState;
@@ -1266,6 +1298,17 @@ export declare class PaywallUI {
      * last-known user из кеша синхронно через microtask, если он есть.
      */
     onUserChange(handler: PaywallEventHandler<'userChange'>): () => void;
+    /**
+     * Заменить cachedBootstrap живыми данными — для preview-режима в редакторе
+     * админки. Если модалка открыта, PaywallRoot подписан на onBootstrapChange
+     * и перерендерится мгновенно. До open() — затравка для bootstrap()-effect'а.
+     *
+     * См. {@link BillingClientOptions.preview} — обычно эту опцию ставят на
+     * клиент, чтобы заодно отключить сетевой revalidate. setBootstrap технически
+     * работает и в production-режиме, но конкуренция с revalidate'ом из сети
+     * почти всегда нежелательна.
+     */
+    setBootstrap(partial: Partial<PaywallBootstrap>): void;
     on<E extends PaywallEvent>(event: E, handler: PaywallEventHandler<E>): () => void;
     off<E extends PaywallEvent>(event: E, handler: PaywallEventHandler<E>): void;
     private emit;
@@ -1457,6 +1500,14 @@ export declare interface PaywallUIOptions extends Omit<BillingClientOptions, 'au
      * флеш на blocked-странах/устройствах хуже воспринимаемой латентности.
      */
     mountThenLoad?: boolean;
+    /**
+     * Inline-режим для live-preview редактора админки. Host позиционируется
+     * `absolute inset:0` внутри родителя (вместо fixed-viewport'а), overlay
+     * Modal'а тоже становится absolute, body-scroll не лочится. ОБЯЗАТЕЛЬНО
+     * передавать `host` (HTMLElement) с positioned parent'ом — иначе absolute
+     * уйдёт к ближайшему positioned ancestor'у или к html. По умолчанию false.
+     */
+    inline?: boolean;
 }
 
 declare interface PaywallUser {

package/dist/ui.js

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

package/package.json

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