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

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-CbbcfXXZ.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-Bu51__PT.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

@@ -60,7 +60,9 @@ export declare class ApiGatewayClient {
 
 export declare interface ApiGatewayClientOptions {
     paywallId: string;
-    apiOrigin?: string;
+    /** Origin серверного API SDK — обязательное поле, тот же `custom_domain`, что
+     *  у BillingClient/AuthClient. См. {@link BillingClientOptions.apiOrigin}. */
+    apiOrigin: string;
     /** AuthClient — Bearer добавляется автоматически. На 401 от gateway клиент
      *  не делает refresh: AuthClient уже сделал lazy-refresh в getAccessToken. */
     auth?: AuthClient;
@@ -80,7 +82,28 @@ export declare interface ApiGatewayClientOptions {
     onQuotaExceeded?: (err: QuotaExceededError) => void;
 }
 
-export declare type AuthChangeListener = (session: AuthSession | null) => void;
+/** Дискриминатор для `onAuthChange`. Позволяет listener'у отличать первый
+ *  callback (восстановление сессии из storage / синтетический snapshot для
+ *  свежей подписки) от реальных переходов. Конвенция Supabase, минус события,
+ *  которых у нас нет (MFA, EMAIL_VERIFIED).
+ *
+ *  - INITIAL_SESSION — единственный гарантированный первый callback на каждую
+ *    подписку. Дёргается через microtask после resolve hydrated-promise, даже
+ *    если session=null. Listener'ы по этому event'у НЕ должны делать побочные
+ *    эффекты типа force-refetch — это просто доставка стартового state'а.
+ *  - SIGNED_IN — свежий вход: email/OAuth/anon, или появление session в этом
+ *    инстансе из другого контекста (storage.watch), когда раньше был null.
+ *  - SIGNED_OUT — signOut, revokeAllSessions, 401 на refresh, удаление session
+ *    из другого контекста.
+ *  - TOKEN_REFRESHED — тот же user, обновлённые токены: refresh(), либо
+ *    storage.watch когда содержимое сменилось но user.id остался.
+ *  - USER_UPDATED — изменился user.email / user.user_metadata (updatePassword,
+ *    upgradeAnonymousToEmail) при том же user.id.
+ *  - PASSWORD_RECOVERY — verifyOtp(type='recovery'). Listener знает, что надо
+ *    показать «set new password» UI вместо обычного post-login flow'а. */
+declare type AuthChangeEvent = 'INITIAL_SESSION' | 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED' | 'USER_UPDATED' | 'PASSWORD_RECOVERY';
+
+export declare type AuthChangeListener = (event: AuthChangeEvent, session: AuthSession | null) => void;
 
 export declare class AuthClient {
     readonly paywallId: string;
@@ -399,8 +422,19 @@ export declare class AuthClient {
     }): Promise<void>;
     /**
      * Подписка на изменения session: signin/signup/refresh/signOut/expired-401.
-     * Колбек вызывается с текущим snapshot через microtask (если session есть)
-     * + на каждое реальное изменение. Возвращает unsubscribe.
+     *
+     * Гарантированный контракт: ПЕРВЫЙ callback каждому subscriber'у — всегда
+     * `event = 'INITIAL_SESSION'`, дёргается асинхронно после resolve hydrate'а
+     * (даже если session=null — listener получает explicit «нет сессии», а не
+     * молчание). Все последующие callback'и — реальные переходы с конкретным
+     * event'ом (SIGNED_IN / SIGNED_OUT / TOKEN_REFRESHED / USER_UPDATED /
+     * PASSWORD_RECOVERY).
+     *
+     * Это позволяет listener'у безопасно делать «only on real signin» побочные
+     * эффекты (force refetch balances и т.п.) через `event === 'SIGNED_IN'`,
+     * не путая их с восстановлением из storage.
+     *
+     * Возвращает unsubscribe.
      */
     onAuthChange(cb: AuthChangeListener): () => void;
     private isFresh;
@@ -438,7 +472,9 @@ export declare class AuthClient {
 
 export declare interface AuthClientOptions {
     paywallId: string;
-    apiOrigin?: string;
+    /** Origin серверного API SDK — обязательное поле, тот же `custom_domain`, что
+     *  у BillingClient. См. {@link BillingClientOptions.apiOrigin}. */
+    apiOrigin: string;
     storage?: StorageAdapter;
     fetch?: typeof fetch;
     openPopup?: (url: string, name: string) => Window | null;
@@ -816,7 +852,15 @@ export declare class BillingClient {
 
 export declare interface BillingClientOptions {
     paywallId: string;
-    apiOrigin?: string;
+    /**
+     * Origin серверного API SDK — обязательное поле. Должно совпадать с
+     * `custom_domain`, заданным для пейвола в платформе (модерация привязывает
+     * домен к paywall_id). SDK сверяет это значение с `bootstrap.settings.custom_domain`
+     * на первом ответе и кидает `invalid_config` при расхождении — защита от
+     * опечаток интегратора. Промежуточный `appbox.space` в новом SDK НЕ
+     * используется (это только для legacy v2).
+     */
+    apiOrigin: string;
     identity?: Identity;
     storage?: StorageAdapter;
     capabilities?: string[];
@@ -1008,6 +1052,19 @@ export declare type LayoutBlock = {
         desc: string;
         count: number;
     }>;
+} | {
+    /** Money-back guarantee badge под cta_button: иконка + жирный заголовок +
+     *  пояснение мелким шрифтом + bottom divider, который визуально стыкуется
+     *  с current_session ниже. v2-аналог inline-блока в `PaywallPricing`. */
+    type: 'guarantee_badge';
+    /** Заголовок жирным. По умолчанию "100% Money-Back Guarantee". */
+    title?: string;
+    /** Подзаголовок мелким серым. По умолчанию
+     *  "Not satisfied? We'll refund you — no questions asked.". */
+    subtitle?: string;
+    /** Иконка слева от заголовка. По умолчанию `dollar_shield` —
+     *  зелёный shield с долларом (legacy-вид). `none` — без иконки. */
+    icon?: 'dollar_shield' | 'none';
 };
 
 /** Локализационные оверрайды для одного языка. Накатываются поверх дефолтного
@@ -1167,9 +1224,19 @@ declare interface PaywallEventPayloads {
     /** User-state изменился (bootstrap snapshot, getUser refresh, watcher tick).
      *  Дёргается также сразу с last-known user после первой подписки. */
     userChange: PaywallUser;
-    /** Auth-session изменилась (signin / signup / refresh / signout / 401-revoke).
-     *  null = разлогинен. Дёргается сразу с last-known session после первой подписки. */
-    authChange: AuthSession | null;
+    /** Auth-session изменилась. Payload содержит `event` (см. AuthChangeEvent —
+     *  INITIAL_SESSION / SIGNED_IN / SIGNED_OUT / TOKEN_REFRESHED / USER_UPDATED /
+     *  PASSWORD_RECOVERY) и `session` (null = разлогинен).
+     *
+     *  Гарантированный контракт: первый callback каждому subscriber'у — всегда
+     *  INITIAL_SESSION с восстановленной из storage сессией (или null если нет).
+     *  Дальше — реальные переходы. Listener'у с побочными эффектами вроде
+     *  force-refetch balances ловить SIGNED_IN, а не любой truthy session,
+     *  иначе reload страницы будет триггерить лишний запрос. */
+    authChange: {
+        event: AuthChangeEvent;
+        session: AuthSession | null;
+    };
     /** Триал заблокировал показ модалки. payload содержит свежий статус (после
      *  recordBlock). Для `mode: 'time'` — startedAt/expiresAt/remainingMs;
      *  для `mode: 'opens'` — remainingActions/totalActions. Хост может
@@ -1239,6 +1306,14 @@ export declare interface PaywallSettings {
     brand_color?: string | null;
     custom_css?: string | null;
     locale_default?: string | null;
+    /** Origin, на котором живёт бэк пейвола (тот же, что мерчант передаёт в
+     *  `BillingClientOptions.apiOrigin` при инициализации SDK). Бэк присылает
+     *  его на каждом bootstrap'е, SDK сверяет с init.apiOrigin — расхождение
+     *  даёт `invalid_config` (защита от опечатки интегратора). Без схемы:
+     *  "pay.your-domain.com" или "https://pay.your-domain.com" — оба валидны.
+     *  Для новых пейволов поле всегда заполнено (модерация требует custom_domain);
+     *  для legacy v2 может быть null/undefined. */
+    custom_domain?: string | null;
     runtime_mode?: 'client' | 'hybrid' | 'server' | 'client-native' | 'hybrid-native';
     /** true, если эквайринг пейвола в test-mode — SDK рисует TEST MODE бейдж. */
     is_test_mode?: boolean;
@@ -1335,6 +1410,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;
@@ -1559,6 +1636,7 @@ export declare interface PaywallUIOptions extends Omit<BillingClientOptions, 'au
      * флеш на blocked-странах/устройствах хуже воспринимаемой латентности.
      */
     mountThenLoad?: boolean;
+    /* Excluded from this release type: inline */
 }
 
 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-CRTEPjJm.js";
+import { P as y, b as A } from "./chunks/PaywallUI-2bwf2scV.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-CbbcfXXZ.js");exports.PaywallUI=e.PaywallUI;exports.blockRegistry=e.blockRegistry;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/PaywallUI-Bu51__PT.js");exports.PaywallUI=e.PaywallUI;exports.blockRegistry=e.blockRegistry;
 //# sourceMappingURL=ui.cjs.map

package/dist/ui.d.ts

@@ -46,7 +46,9 @@ declare class ApiGatewayClient {
 
 declare interface ApiGatewayClientOptions {
     paywallId: string;
-    apiOrigin?: string;
+    /** Origin серверного API SDK — обязательное поле, тот же `custom_domain`, что
+     *  у BillingClient/AuthClient. См. {@link BillingClientOptions.apiOrigin}. */
+    apiOrigin: string;
     /** AuthClient — Bearer добавляется автоматически. На 401 от gateway клиент
      *  не делает refresh: AuthClient уже сделал lazy-refresh в getAccessToken. */
     auth?: AuthClient;
@@ -66,7 +68,28 @@ declare interface ApiGatewayClientOptions {
     onQuotaExceeded?: (err: QuotaExceededError) => void;
 }
 
-declare type AuthChangeListener = (session: AuthSession | null) => void;
+/** Дискриминатор для `onAuthChange`. Позволяет listener'у отличать первый
+ *  callback (восстановление сессии из storage / синтетический snapshot для
+ *  свежей подписки) от реальных переходов. Конвенция Supabase, минус события,
+ *  которых у нас нет (MFA, EMAIL_VERIFIED).
+ *
+ *  - INITIAL_SESSION — единственный гарантированный первый callback на каждую
+ *    подписку. Дёргается через microtask после resolve hydrated-promise, даже
+ *    если session=null. Listener'ы по этому event'у НЕ должны делать побочные
+ *    эффекты типа force-refetch — это просто доставка стартового state'а.
+ *  - SIGNED_IN — свежий вход: email/OAuth/anon, или появление session в этом
+ *    инстансе из другого контекста (storage.watch), когда раньше был null.
+ *  - SIGNED_OUT — signOut, revokeAllSessions, 401 на refresh, удаление session
+ *    из другого контекста.
+ *  - TOKEN_REFRESHED — тот же user, обновлённые токены: refresh(), либо
+ *    storage.watch когда содержимое сменилось но user.id остался.
+ *  - USER_UPDATED — изменился user.email / user.user_metadata (updatePassword,
+ *    upgradeAnonymousToEmail) при том же user.id.
+ *  - PASSWORD_RECOVERY — verifyOtp(type='recovery'). Listener знает, что надо
+ *    показать «set new password» UI вместо обычного post-login flow'а. */
+declare type AuthChangeEvent = 'INITIAL_SESSION' | 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED' | 'USER_UPDATED' | 'PASSWORD_RECOVERY';
+
+declare type AuthChangeListener = (event: AuthChangeEvent, session: AuthSession | null) => void;
 
 declare class AuthClient {
     readonly paywallId: string;
@@ -385,8 +408,19 @@ declare class AuthClient {
     }): Promise<void>;
     /**
      * Подписка на изменения session: signin/signup/refresh/signOut/expired-401.
-     * Колбек вызывается с текущим snapshot через microtask (если session есть)
-     * + на каждое реальное изменение. Возвращает unsubscribe.
+     *
+     * Гарантированный контракт: ПЕРВЫЙ callback каждому subscriber'у — всегда
+     * `event = 'INITIAL_SESSION'`, дёргается асинхронно после resolve hydrate'а
+     * (даже если session=null — listener получает explicit «нет сессии», а не
+     * молчание). Все последующие callback'и — реальные переходы с конкретным
+     * event'ом (SIGNED_IN / SIGNED_OUT / TOKEN_REFRESHED / USER_UPDATED /
+     * PASSWORD_RECOVERY).
+     *
+     * Это позволяет listener'у безопасно делать «only on real signin» побочные
+     * эффекты (force refetch balances и т.п.) через `event === 'SIGNED_IN'`,
+     * не путая их с восстановлением из storage.
+     *
+     * Возвращает unsubscribe.
      */
     onAuthChange(cb: AuthChangeListener): () => void;
     private isFresh;
@@ -424,7 +458,9 @@ declare class AuthClient {
 
 declare interface AuthClientOptions {
     paywallId: string;
-    apiOrigin?: string;
+    /** Origin серверного API SDK — обязательное поле, тот же `custom_domain`, что
+     *  у BillingClient. См. {@link BillingClientOptions.apiOrigin}. */
+    apiOrigin: string;
     storage?: StorageAdapter;
     fetch?: typeof fetch;
     openPopup?: (url: string, name: string) => Window | null;
@@ -802,7 +838,15 @@ declare class BillingClient {
 
 declare interface BillingClientOptions {
     paywallId: string;
-    apiOrigin?: string;
+    /**
+     * Origin серверного API SDK — обязательное поле. Должно совпадать с
+     * `custom_domain`, заданным для пейвола в платформе (модерация привязывает
+     * домен к paywall_id). SDK сверяет это значение с `bootstrap.settings.custom_domain`
+     * на первом ответе и кидает `invalid_config` при расхождении — защита от
+     * опечаток интегратора. Промежуточный `appbox.space` в новом SDK НЕ
+     * используется (это только для legacy v2).
+     */
+    apiOrigin: string;
     identity?: Identity;
     storage?: StorageAdapter;
     capabilities?: string[];
@@ -947,6 +991,19 @@ declare type LayoutBlock = {
         desc: string;
         count: number;
     }>;
+} | {
+    /** Money-back guarantee badge под cta_button: иконка + жирный заголовок +
+     *  пояснение мелким шрифтом + bottom divider, который визуально стыкуется
+     *  с current_session ниже. v2-аналог inline-блока в `PaywallPricing`. */
+    type: 'guarantee_badge';
+    /** Заголовок жирным. По умолчанию "100% Money-Back Guarantee". */
+    title?: string;
+    /** Подзаголовок мелким серым. По умолчанию
+     *  "Not satisfied? We'll refund you — no questions asked.". */
+    subtitle?: string;
+    /** Иконка слева от заголовка. По умолчанию `dollar_shield` —
+     *  зелёный shield с долларом (legacy-вид). `none` — без иконки. */
+    icon?: 'dollar_shield' | 'none';
 };
 
 /** Локализационные оверрайды для одного языка. Накатываются поверх дефолтного
@@ -1106,9 +1163,19 @@ declare interface PaywallEventPayloads {
     /** User-state изменился (bootstrap snapshot, getUser refresh, watcher tick).
      *  Дёргается также сразу с last-known user после первой подписки. */
     userChange: PaywallUser;
-    /** Auth-session изменилась (signin / signup / refresh / signout / 401-revoke).
-     *  null = разлогинен. Дёргается сразу с last-known session после первой подписки. */
-    authChange: AuthSession | null;
+    /** Auth-session изменилась. Payload содержит `event` (см. AuthChangeEvent —
+     *  INITIAL_SESSION / SIGNED_IN / SIGNED_OUT / TOKEN_REFRESHED / USER_UPDATED /
+     *  PASSWORD_RECOVERY) и `session` (null = разлогинен).
+     *
+     *  Гарантированный контракт: первый callback каждому subscriber'у — всегда
+     *  INITIAL_SESSION с восстановленной из storage сессией (или null если нет).
+     *  Дальше — реальные переходы. Listener'у с побочными эффектами вроде
+     *  force-refetch balances ловить SIGNED_IN, а не любой truthy session,
+     *  иначе reload страницы будет триггерить лишний запрос. */
+    authChange: {
+        event: AuthChangeEvent;
+        session: AuthSession | null;
+    };
     /** Триал заблокировал показ модалки. payload содержит свежий статус (после
      *  recordBlock). Для `mode: 'time'` — startedAt/expiresAt/remainingMs;
      *  для `mode: 'opens'` — remainingActions/totalActions. Хост может
@@ -1178,6 +1245,14 @@ declare interface PaywallSettings {
     brand_color?: string | null;
     custom_css?: string | null;
     locale_default?: string | null;
+    /** Origin, на котором живёт бэк пейвола (тот же, что мерчант передаёт в
+     *  `BillingClientOptions.apiOrigin` при инициализации SDK). Бэк присылает
+     *  его на каждом bootstrap'е, SDK сверяет с init.apiOrigin — расхождение
+     *  даёт `invalid_config` (защита от опечатки интегратора). Без схемы:
+     *  "pay.your-domain.com" или "https://pay.your-domain.com" — оба валидны.
+     *  Для новых пейволов поле всегда заполнено (модерация требует custom_domain);
+     *  для legacy v2 может быть null/undefined. */
+    custom_domain?: string | null;
     runtime_mode?: 'client' | 'hybrid' | 'server' | 'client-native' | 'hybrid-native';
     /** true, если эквайринг пейвола в test-mode — SDK рисует TEST MODE бейдж. */
     is_test_mode?: boolean;
@@ -1274,6 +1349,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;
@@ -1498,6 +1575,7 @@ export declare interface PaywallUIOptions extends Omit<BillingClientOptions, 'au
      * флеш на blocked-странах/устройствах хуже воспринимаемой латентности.
      */
     mountThenLoad?: boolean;
+    /* Excluded from this release type: inline */
 }
 
 declare interface PaywallUser {

package/dist/ui.js

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

package/package.json

@@ -1,18 +1,19 @@
 {
   "name": "@monetize.software/sdk",
-  "version": "3.0.0-alpha.2",
+  "version": "3.0.0-alpha.4",
   "description": "Monetize SDK — bundled billing client and paywall render engine for web and Chrome extensions",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/monetize-software/sdk.git"
+    "url": "git+https://github.com/monetize-software/sdk.git",
+    "directory": "sdk-packages/sdk"
   },
   "bugs": {
     "url": "https://github.com/monetize-software/sdk/issues"
   },
-  "homepage": "https://github.com/monetize-software/sdk#readme",
+  "homepage": "https://github.com/monetize-software/sdk/tree/main/sdk-packages/sdk#readme",
   "files": [
     "dist"
   ],
@@ -33,32 +34,6 @@
       "require": "./dist/ui.cjs"
     }
   },
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:e2e": "pnpm ext:build && playwright test --project=extension",
-    "test:e2e:demo": "playwright test --project=demo-stripe --project=demo-paddle --project=demo-freemius",
-    "test:e2e:demo:stripe": "playwright test --project=demo-stripe",
-    "test:e2e:demo:paddle": "playwright test --project=demo-paddle",
-    "test:e2e:demo:freemius": "playwright test --project=demo-freemius",
-    "test:e2e:checkout": "playwright test --project=checkout-stripe --project=checkout-paddle --project=checkout-freemius",
-    "test:e2e:checkout:stripe": "playwright test --project=checkout-stripe",
-    "test:e2e:checkout:paddle": "playwright test --project=checkout-paddle",
-    "test:e2e:checkout:freemius": "playwright test --project=checkout-freemius",
-    "test:e2e:all": "pnpm ext:build && playwright test",
-    "ext:build": "vite build --config playgrounds/extension/vite.config.ts",
-    "size": "size-limit",
-    "prepublishOnly": "pnpm typecheck && pnpm build",
-    "version:alpha": "npm version prerelease --preid=alpha --no-git-tag-version",
-    "version:patch": "npm version patch --no-git-tag-version",
-    "version:minor": "npm version minor --no-git-tag-version",
-    "version:major": "npm version major --no-git-tag-version",
-    "release:alpha": "npm publish --access public --tag alpha",
-    "release:latest": "npm publish --access public"
-  },
   "dependencies": {
     "preact": "^10.24.0"
   },
@@ -92,5 +67,31 @@
       "path": "dist/index.js",
       "limit": "70 KB"
     }
-  ]
-}
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "build:watch": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "pnpm ext:build && playwright test --project=extension",
+    "test:e2e:demo": "playwright test --project=demo-stripe --project=demo-paddle --project=demo-freemius",
+    "test:e2e:demo:stripe": "playwright test --project=demo-stripe",
+    "test:e2e:demo:paddle": "playwright test --project=demo-paddle",
+    "test:e2e:demo:freemius": "playwright test --project=demo-freemius",
+    "test:e2e:checkout": "playwright test --project=checkout-stripe --project=checkout-paddle --project=checkout-freemius",
+    "test:e2e:checkout:stripe": "playwright test --project=checkout-stripe",
+    "test:e2e:checkout:paddle": "playwright test --project=checkout-paddle",
+    "test:e2e:checkout:freemius": "playwright test --project=checkout-freemius",
+    "test:e2e:all": "pnpm ext:build && playwright test",
+    "ext:build": "vite build --config playgrounds/extension/vite.config.ts",
+    "size": "size-limit",
+    "version:alpha": "npm version prerelease --preid=alpha --no-git-tag-version",
+    "version:patch": "npm version patch --no-git-tag-version",
+    "version:minor": "npm version minor --no-git-tag-version",
+    "version:major": "npm version major --no-git-tag-version",
+    "release:alpha": "npm publish --access public --tag alpha",
+    "release:latest": "npm publish --access public"
+  }
+}