@monetize.software/sdk 3.0.0-alpha.0 → 3.0.0-alpha.2

package/README.md

@@ -1,24 +1,24 @@
 # @monetize.software/sdk
 
-SDK 3.0 — bundled billing client и render engine пейвола. Встраивается в расширения Chrome
-и веб-сайты через npm / CDN, без iframe и без remote code.
+SDK 3.0 — bundled billing client and paywall render engine. Embeds into Chrome
+extensions and websites via npm / CDN, with no iframe and no remote code.
 
-Статус: **alpha, WIP**. См. [TODO.md](../TODO.md).
+Status: **alpha, WIP**. See [TODO.md](../TODO.md).
 
-## Три entrypoint'а
+## Three entrypoints
 
 ```ts
-// server / headless billing — только API, без UI
+// server / headless billing — API only, no UI
 import { BillingClient } from '@monetize.software/sdk/core';
 
-// host сам показывает UI, но нужна наша модалка
+// host renders its own UI but needs our modal
 import { PaywallUI } from '@monetize.software/sdk/ui';
 
-// все в одном — auth-слой подгружается лениво
+// all in one — auth layer is loaded lazily
 import { PaywallUI } from '@monetize.software/sdk';
 ```
 
-## Быстрый старт
+## Quick start
 
 ```ts
 import { PaywallUI } from '@monetize.software/sdk';
@@ -35,32 +35,32 @@ paywall.on('checkout_started', ({ url }) => {
 document.getElementById('upgrade').onclick = () => paywall.open();
 ```
 
-## Скрипты
+## Scripts
 
 ```bash
 pnpm install
-pnpm dev          # локальная демка на http://localhost:5060/demo/
-pnpm build        # ESM + CJS + .d.ts в dist/
+pnpm dev          # local demo at http://localhost:5060/demo/
+pnpm build        # ESM + CJS + .d.ts into dist/
 pnpm typecheck
 pnpm size         # bundle-size gate
 pnpm test
 ```
 
-## Архитектура (коротко)
+## Architecture (in brief)
 
-- **Preact** (не React) — 3KB вместо 45KB. Critical для bundle-бюджета.
-- **Shadow DOM** (`{ mode: 'closed' }`) — изоляция стилей.
-- **Tailwind v4**, скомпилированный в CSS-строку и инжектированный в shadow root.
-- **Server-driven layout** — JSON-схема блоков (`heading`, `price_grid`, `cta_button`, ...).
-  SDK умеет рендерить блоки; server управляет порядком, текстами, visibility.
-- **Server-driven checkout** — SDK не знает провайдеров (Stripe/Paddle/Chargebee),
-  просто открывает `checkout_url`, который вернул сервер.
+- **Preact** (not React) — 3KB instead of 45KB. Critical for the bundle budget.
+- **Shadow DOM** (`{ mode: 'closed' }`) — style isolation.
+- **Tailwind v4**, compiled into a CSS string and injected into the shadow root.
+- **Server-driven layout** — JSON schema of blocks (`heading`, `price_grid`, `cta_button`, ...).
+  SDK knows how to render blocks; the server controls order, copy, and visibility.
+- **Server-driven checkout** — SDK is provider-agnostic (Stripe/Paddle/Chargebee),
+  it just opens the `checkout_url` returned by the server.
 
-## Метированный AI-прокси (`ApiGatewayClient`)
+## Metered AI proxy (`ApiGatewayClient`)
 
-Платформа поддерживает прокси-вызовы к OpenAI/Anthropic/любому HTTP-API с
-посчётом токенов из `paywall_balances`. SDK даёт тонкий клиент к этому прокси
-и хранит локальное состояние балансов.
+The platform supports proxying calls to OpenAI/Anthropic/any HTTP API with
+token accounting against `paywall_balances`. The SDK ships a thin client to
+this proxy and maintains local balance state.
 
 ```ts
 import { BillingClient, AuthClient, QuotaExceededError } from '@monetize.software/sdk/core';
@@ -70,11 +70,11 @@ const billing = new BillingClient({ paywallId: 'pw_abc', auth });
 const gateway = billing.createApiGatewayClient();
 
 billing.onBalanceChange((balances) => {
-  // Рисуем счётчик квот в UI
+  // Render quota counter in UI
 });
 
 try {
-  // SSE-стрим: возвращается голый Response, без своего парсера.
+  // SSE stream: returns a raw Response, no built-in parser.
   const res = await gateway.call({
     providerId: 'prov_openai',
     path: '',
@@ -86,21 +86,21 @@ try {
   }
 } catch (e) {
   if (e instanceof QuotaExceededError) {
-    paywall.open(); // upgrade-prompt
+    paywall.open(); // upgrade prompt
   } else throw e;
 }
 ```
 
-- `BillingClient.createApiGatewayClient()` подключает Bearer из `AuthClient`,
-  оптимистично декрементит `cachedBalances` на success, ре-фетчит `/balances`
-  на 402.
-- `gateway.call()` отдаёт сырой `Response`. Caller сам решает: `.json()`,
-  `.body.getReader()`, или async-iter — всё работает из коробки `fetch`.
-- На 402 бросается `QuotaExceededError` с `balances`/`queryType`/`currentBalance`.
+- `BillingClient.createApiGatewayClient()` wires the Bearer from `AuthClient`,
+  optimistically decrements `cachedBalances` on success, and refetches `/balances`
+  on 402.
+- `gateway.call()` returns the raw `Response`. Caller decides: `.json()`,
+  `.body.getReader()`, or async-iter — anything that works on a `fetch` Response.
+- On 402, `QuotaExceededError` is thrown with `balances` / `queryType` / `currentBalance`.
 
-## Нет в этой версии (alpha)
+## Not in this version (alpha)
 
-- Auth-слой (Google/Apple/Email) — будет после hybrid-бета.
-- Трейлы с таймером, A/B-варианты, локализация.
+- Auth layer (Google / Apple / Email) — coming after the hybrid beta.
+- Timer-based trials, A/B variants, localization.
 - Framework adapters (`@monetize/react`).
 - Tests.

package/dist/chunks/{PaywallUI-BHp9afFC.js → PaywallUI-CRTEPjJm.js}

@@ -1197,6 +1197,13 @@ function Zt({
     if (e.auth)
       return e.auth.onAuthChange((h) => m(h));
   }, [e.auth]), M(() => {
+    if (typeof e.onBootstrapChange == "function")
+      return e.onBootstrapChange((h) => {
+        p(
+          (u) => u.status === "ready" ? { status: "ready", data: h } : u
+        );
+      });
+  }, [e]), M(() => {
     if (!t || c.status === "ready" || c.status === "loading") return;
     let h = !1;
     return p({ status: "loading" }), e.bootstrap().then((u) => {
@@ -1727,6 +1734,19 @@ class he {
   onUserChange(t) {
     return this.on("userChange", t);
   }
+  /**
+   * Заменить cachedBootstrap живыми данными — для preview-режима в редакторе
+   * админки. Если модалка открыта, PaywallRoot подписан на onBootstrapChange
+   * и перерендерится мгновенно. До open() — затравка для bootstrap()-effect'а.
+   *
+   * См. {@link BillingClientOptions.preview} — обычно эту опцию ставят на
+   * клиент, чтобы заодно отключить сетевой revalidate. setBootstrap технически
+   * работает и в production-режиме, но конкуренция с revalidate'ом из сети
+   * почти всегда нежелательна.
+   */
+  setBootstrap(t) {
+    this.billing.setBootstrap(t);
+  }
   on(t, i) {
     let n = this.listeners.get(t);
     return n || (n = /* @__PURE__ */ new Set(), this.listeners.set(t, n)), n.add(i), () => n.delete(i);
@@ -2206,4 +2226,4 @@ export {
   he as P,
   $t as b
 };
-//# sourceMappingURL=PaywallUI-BHp9afFC.js.map
+//# sourceMappingURL=PaywallUI-CRTEPjJm.js.map