@cosmo-frameworks/paywall-react 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+Todos los cambios reseñables de este paquete se documentan aquí.
+
+El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/)
+y el versionado es [SemVer](https://semver.org/lang/es/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-08-21
+
+Primera versión.
+
+### Añadido
+
+- `<PaywallProvider>`: consulta el estado de licencia contra la API y lo
+  comparte con el árbol de la aplicación.
+- `<PaywallGate>`: muestra avisos o suspende la aplicación según ese estado.
+  En `BLOCKED` **no renderiza los hijos**, para que tampoco corran sus efectos.
+- `useLicenseStatus()`: acceso al estado en crudo, para integraciones a medida
+  sin usar `<PaywallGate>`.
+- `clearLicenseCache()`: descarta el estado cacheado de una licencia.
+- Cuatro estados de servicio: `OK`, `WARNING` (aviso descartable), `GRACE`
+  (aviso fijo con cuenta atrás) y `BLOCKED` (pantalla de suspensión).
+- Escalada configurable por licencia desde el panel de administración, y
+  personalizable en el cliente vía `blockOn`.
+- Pantallas por defecto con estilos en línea, sustituibles con `renderBlocked`,
+  `renderWarning` y `renderGrace`.
+
+### Comportamiento ante fallos
+
+- **Fail-open**: sin respuesta del servidor se usa el último estado cacheado;
+  sin caché, la aplicación funciona con normalidad.
+- Caché en `localStorage` con respaldo en memoria si el navegador lo prohíbe
+  (modo privado de Safari, cookies bloqueadas), y descarte a los 7 días.
+- Lectura síncrona de la caché en el primer render: sin parpadeo al recargar.
+- Reintentos con espera creciente, deduplicación de peticiones en vuelo y
+  recomprobación al volver a la pestaña y al recuperar conexión.
+
+### Compatibilidad
+
+- React 18 y 19 como `peerDependency`.
+- Vite, Create React App y Next.js App Router (incluye la directiva
+  `"use client"`).
+- Seguro en renderizado de servidor: no consulta nada hasta hidratar.
+- Se distribuye en ESM y CJS con tipos TypeScript.
+
+### Notas
+
+- **Cero dependencias en tiempo de ejecución.** ~4 kB gzip.
+- La license key no es un secreto: viaja en el bundle del navegador por diseño.
+- Este paquete es la capa de aviso y de experiencia de usuario. El cumplimiento
+  real se consigue verificando en el servidor del cliente el token Ed25519 que
+  acompaña a cada respuesta.
+
+[Unreleased]: https://github.com/cosmo-frameworks/paywall-react/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/cosmo-frameworks/paywall-react/releases/tag/v0.1.0

package/README.md

@@ -0,0 +1,225 @@
+# @cosmo-frameworks/paywall-react
+
+Control remoto del estado de servicio para aplicaciones React. La aplicación
+consulta el estado de su licencia y muestra avisos, una cuenta atrás o una
+pantalla de suspensión según el estado de los pagos.
+
+- Sin dependencias (React es `peerDependency`). **~4 kB gzip.**
+- Estilos en línea: no importa CSS ni choca con Tailwind, MUI ni nada tuyo.
+- Compatible con Vite, CRA y Next.js App Router.
+- **Fail-open:** si el servidor de licencias no responde, la aplicación sigue
+  funcionando con el último estado conocido.
+
+---
+
+## Instalación
+
+```bash
+npm install @cosmo-frameworks/paywall-react
+```
+
+Sin `.npmrc`, sin tokens y sin configuración de registro: es un paquete público
+en npmjs.com.
+
+---
+
+## Uso
+
+Envuelve la raíz de la aplicación, lo más arriba posible:
+
+```tsx
+import { PaywallProvider, PaywallGate } from "@cosmo-frameworks/paywall-react";
+
+export const App = () => (
+  <PaywallProvider
+    config={{
+      licenseKey: import.meta.env.VITE_LICENSE_KEY,
+      productName: "Panel de Acme",
+      contactEmail: "facturacion@acme.com",
+    }}
+  >
+    <PaywallGate>
+      <Router />
+    </PaywallGate>
+  </PaywallProvider>
+);
+```
+
+Eso es todo. Comportamiento según el estado que devuelva el servidor:
+
+| Estado    | Qué ve el usuario                                              |
+| --------- | -------------------------------------------------------------- |
+| `OK`      | La aplicación, sin nada añadido.                                 |
+| `WARNING` | La aplicación con un aviso descartable arriba.                   |
+| `GRACE`   | La aplicación con un aviso fijo y cuenta atrás hasta el corte.   |
+| `BLOCKED` | Pantalla de suspensión. **La aplicación no se renderiza.**       |
+
+### Next.js (App Router)
+
+El paquete ya incluye la directiva `"use client"`, así que se importa
+directamente desde un layout:
+
+```tsx
+// app/layout.tsx
+import { PaywallProvider, PaywallGate } from "@cosmo-frameworks/paywall-react";
+
+export default function RootLayout({ children }) {
+  return (
+    <html lang="es">
+      <body>
+        <PaywallProvider config={{ licenseKey: process.env.NEXT_PUBLIC_LICENSE_KEY! }}>
+          <PaywallGate>{children}</PaywallGate>
+        </PaywallProvider>
+      </body>
+    </html>
+  );
+}
+```
+
+> La license key **no es un secreto**: viaja en el bundle del navegador por
+> diseño. Usa `VITE_`/`NEXT_PUBLIC_` sin problema. Lo que la key permite es
+> únicamente consultar el estado de servicio; no da acceso a ningún dato.
+
+---
+
+## Configuración
+
+```ts
+interface PaywallConfigI {
+  licenseKey: string;              // requerido
+  apiUrl?: string;                 // por defecto https://api.clients.ridel.dev
+  refreshIntervalMs?: number;      // por defecto 15 min (o lo que pida el servidor)
+  blockOn?: LicenseStateT[];       // por defecto ["BLOCKED"]
+  failOpen?: boolean;              // por defecto true
+  maxCacheAgeMs?: number;          // por defecto 7 días
+  storage?: "local" | "memory" | "none";
+  contactEmail?: string;
+  productName?: string;
+  debug?: boolean;
+  onStatusChange?: (status: LicenseStatusI) => void;
+  fetchImpl?: typeof fetch;
+}
+```
+
+### Personalizar las pantallas
+
+```tsx
+<PaywallGate
+  renderBlocked={(status) => <MiPantallaDeCorte mensaje={status.message} />}
+  renderWarning={(status) => <MiBanner mensaje={status.message} />}
+  showBanners
+>
+  <App />
+</PaywallGate>
+```
+
+### Modo headless
+
+Si prefieres controlarlo todo tú, usa el hook y olvídate de `<PaywallGate>`:
+
+```tsx
+import { useLicenseStatus } from "@cosmo-frameworks/paywall-react";
+
+const Cabecera = () => {
+  const { state, message, graceUntil, contactUrl, refresh } = useLicenseStatus();
+
+  if (state === "OK") return null;
+  return <aside>{message} <a href={contactUrl ?? "#"}>Regularizar</a></aside>;
+};
+```
+
+---
+
+## Comportamiento ante fallos
+
+| Situación                          | Qué ocurre                                          |
+| ---------------------------------- | --------------------------------------------------- |
+| El servidor no responde            | Se usa el último estado cacheado.                    |
+| No responde y no hay caché         | **Se deja pasar.** La aplicación funciona.           |
+| La caché tiene más de 7 días       | Se descarta y se deja pasar.                         |
+| `localStorage` bloqueado           | Se cae a memoria; la caché dura lo que la pestaña.   |
+| Licencia desconocida o revocada    | Revocada bloquea; desconocida deja pasar y avisa por consola. |
+| Renderizado en servidor (SSR)      | No se consulta nada; se resuelve al hidratar.        |
+
+Las peticiones concurrentes se deduplican, hay reintentos con espera creciente
+tras un fallo, y se recomprueba al volver a la pestaña y al recuperar conexión.
+
+---
+
+## Preguntas frecuentes
+
+**¿Puedo saltarme el bloqueo desde las herramientas de desarrollo?**
+En el navegador, sí: es JavaScript en tu máquina. Este paquete es la capa de
+aviso y de experiencia de usuario. El cumplimiento real se hace verificando en
+tu propio servidor el token firmado (Ed25519) que acompaña a cada respuesta.
+
+**¿Qué datos se envían?**
+Solo la license key. La respuesta no incluye importes ni datos personales salvo
+que la licencia lo autorice explícitamente.
+
+**¿Y si borro `localStorage`?**
+Se dispara una consulta nueva, que es más estricta, no menos.
+
+---
+
+## Desarrollo
+
+```bash
+npm install
+npm test          # Vitest
+npm run build     # ESM + CJS + tipos
+npm pack          # tarball para probar la integración en otro proyecto
+```
+
+## Publicación
+
+El código vive en `cosmo-frameworks/paywall-react` (repositorio privado) y el
+paquete se publica en **npmjs.com** bajo el scope `@cosmo-frameworks`.
+
+Se eligió npmjs y no GitHub Packages porque este último exige un token de
+acceso **incluso para paquetes públicos**, lo que obligaría a cada cliente a
+configurar un `.npmrc` con credenciales y a resolver la autenticación dentro de
+su Dockerfile. En npmjs un paquete público se instala sin nada.
+
+La publicación usa **trusted publishing (OIDC)**: el workflow obtiene una
+credencial efímera de npm y no hay ningún secreto guardado en el repositorio.
+Se eligió así porque los tokens de npm ya no son una opción sostenible — los
+classic fueron revocados en diciembre de 2025, los granulares de escritura
+caducan a los 90 días, y los de bypass-2FA pierden la capacidad de publicar en
+enero de 2027.
+
+Requisitos, una sola vez:
+
+- La organización `cosmo-frameworks` creada en npmjs.com (gratis para paquetes
+  públicos).
+- El **trusted publisher** configurado en los ajustes del paquete, apuntando a
+  este repositorio y a `.github/workflows/publish.yml`.
+- El primer `npm publish` hecho a mano desde tu máquina, porque el trusted
+  publisher se configura sobre un paquete que ya existe.
+
+La procedencia firmada se genera sola en este modo: no hace falta
+`--provenance`.
+
+> **No ejecutes `git init` aquí mientras la carpeta siga dentro del monorepo.**
+> Un repositorio anidado hace que el monorepo trate esta carpeta como repo
+> externo y deje de versionar su contenido **en silencio**: los commits pasan
+> sin error y el paquete no viaja. Si alguna herramienta gráfica (GitKraken y
+> similares crean un `.git` al detectar carpetas nuevas) lo ha creado, bórralo
+> con `rm -rf packages/paywall-react/.git` antes de commitear.
+
+El **repositorio es privado** y el **paquete es público**: el `src/` y el
+historial no se ven, y solo se distribuye lo que declara `files` — el bundle de
+`dist/` y este README, sin sourcemaps, que embeberían el TypeScript original.
+
+Primera publicación, ya con la carpeta **fuera** del monorepo:
+
+```bash
+cd paywall-react
+git init && git add . && git commit -m "chore: primera versión"
+git remote add origin git@github.com:cosmo-frameworks/paywall-react.git
+git push -u origin main
+git tag v0.1.0 && git push --tags   # dispara el workflow
+```
+
+A partir de ahí, ese repositorio es la fuente de verdad y esta carpeta puede
+eliminarse del monorepo.

package/dist/constants.d.ts

@@ -0,0 +1,14 @@
+export declare const DEFAULT_API_URL = "https://api.clients.ridel.dev";
+export declare const STATUS_PATH = "/api/public/license/v1/status";
+/** Cada cuánto se recomprueba si el servidor no dice otra cosa. */
+export declare const DEFAULT_REFRESH_INTERVAL_MS: number;
+/**
+ * Pasada esta antigüedad la caché se descarta y, sin red, se deja pasar.
+ * Es el límite de cuánto tiempo puede un cliente seguir bloqueado (o
+ * desbloqueado) sin contacto con el servidor.
+ */
+export declare const DEFAULT_MAX_CACHE_AGE_MS: number;
+export declare const CACHE_PREFIX = "cpl:state:";
+export declare const REQUEST_TIMEOUT_MS = 10000;
+export declare const BACKOFF_MIN_MS = 1000;
+export declare const BACKOFF_MAX_MS = 30000;

package/dist/core/cache.d.ts

@@ -0,0 +1,10 @@
+import { CachedEntryI, LicensePayloadI, PaywallConfigI } from '../types';
+type CacheOptionsT = Pick<PaywallConfigI, "storage" | "maxCacheAgeMs">;
+export declare const writeCache: (licenseKey: string, payload: LicensePayloadI, options: CacheOptionsT) => void;
+export declare const readCache: (licenseKey: string, options: CacheOptionsT) => CachedEntryI | null;
+/**
+ * Borra el estado cacheado de una licencia. Útil al cerrar sesión o para
+ * forzar una comprobación limpia; no desbloquea nada, solo provoca un fetch.
+ */
+export declare const clearLicenseCache: (licenseKey: string) => void;
+export {};

package/dist/core/fetchLicenseStatus.d.ts

@@ -0,0 +1,21 @@
+import { LicensePayloadI, LicenseSourceT, PaywallConfigI } from '../types';
+export interface LicenseFetchResultI {
+    payload: LicensePayloadI | null;
+    source: LicenseSourceT;
+    /** Antigüedad de la caché usada; irrelevante cuando `source` es `network`. */
+    isStale: boolean;
+    error: Error | null;
+}
+type FetchOptionsT = Pick<PaywallConfigI, "licenseKey" | "apiUrl" | "storage" | "maxCacheAgeMs" | "fetchImpl"> & {
+    signal?: AbortSignal;
+};
+/**
+ * Recupera el estado de licencia y decide qué mostrar si el servidor falla.
+ *
+ * Fail-open por diseño: si no hay respuesta se usa el último estado conocido y,
+ * a falta de él, se deja pasar. Una caída del servidor de licencias nunca puede
+ * tumbar la aplicación de un cliente que sí paga; el precio es que un moroso
+ * gana tiempo mientras el servidor esté caído.
+ */
+export declare const fetchLicenseStatus: (options: FetchOptionsT) => Promise<LicenseFetchResultI>;
+export {};

package/dist/core/isBrowser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Guarda de SSR. El paquete se importa desde Next.js App Router, donde el
+ * primer render ocurre en el servidor y `window` no existe.
+ */
+export declare const isBrowser: () => boolean;

package/dist/core/resolveGateDecision.d.ts

@@ -0,0 +1,10 @@
+import { GateDecisionT, LicenseStateT } from '../types';
+/**
+ * Traduce el estado del servidor a lo que hace el `<PaywallGate>`.
+ *
+ * Puro y sin dependencias para poder cubrir la matriz completa de estados en
+ * tests: es la única función capaz de tapar la aplicación de un cliente.
+ */
+export declare const resolveGateDecision: (state: LicenseStateT, config: {
+    blockOn?: LicenseStateT[];
+}) => GateDecisionT;

package/dist/index.cjs

@@ -0,0 +1 @@
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("react"),t=require("react/jsx-runtime");var n=`/api/public/license/v1/status`,r=`cpl:state:`,i=1e4,a=1e3,o=3e4,s=()=>typeof window<`u`&&window.document!==void 0,c=new Map,l=e=>`${r}${e.slice(0,12)}`,u=e=>(e.storage??`local`)===`local`&&s(),d=e=>{if(typeof e!=`object`||!e)return!1;let t=e;return t.version!==1||typeof t.receivedAt!=`number`?!1:typeof t.payload?.status==`string`},f=(e,t,n)=>{if((n.storage??`local`)===`none`)return;let r={version:1,payload:t,receivedAt:Date.now()},i=l(e);if(c.set(i,r),u(n))try{window.localStorage.setItem(i,JSON.stringify(r))}catch{}},p=(e,t)=>{if((t.storage??`local`)===`none`)return null;let n=l(e),r=c.get(n)??null;if(!r&&u(t))try{let e=window.localStorage.getItem(n);if(e){let t=JSON.parse(e);d(t)&&(r=t)}}catch{}if(!r)return null;let i=t.maxCacheAgeMs??6048e5;return Date.now()-r.receivedAt>i?(m(e),null):r},m=e=>{let t=l(e);if(c.delete(t),s())try{window.localStorage.removeItem(t)}catch{}},h=1,g=e=>{if(typeof e!=`object`||!e)return!1;let t=e;return t.v===h&&typeof t.status==`string`&&typeof t.licenseId==`string`},_=async e=>{let{licenseKey:t}=e;if(!t)return v(e,Error(`[paywall] Falta licenseKey en la configuración.`));let r=e.fetchImpl??globalThis.fetch;if(typeof r!=`function`)return v(e,Error(`[paywall] No hay implementación de fetch disponible.`));let a=`${(e.apiUrl??`https://api.clients.ridel.dev`).replace(/\/+$/,``)}${n}?key=${encodeURIComponent(t)}&t=${Date.now()}`,o=new AbortController,s=setTimeout(()=>o.abort(),i);try{let n=await r(a,{method:`GET`,credentials:`omit`,signal:e.signal??o.signal}),i=await n.json();if(!n.ok){let t=i?.error??`HTTP ${n.status}`;return v(e,Error(`[paywall] El servidor rechazó la licencia: ${t}`))}return g(i)?(f(t,i,e),{payload:i,source:`network`,isStale:!1,error:null}):v(e,Error(`[paywall] Respuesta con un formato que esta versión del SDK no entiende. Actualiza el paquete.`))}catch(t){return v(e,y(t))}finally{clearTimeout(s)}},v=(e,t)=>{let n=e.licenseKey?p(e.licenseKey,e):null;return n?{payload:n.payload,source:`cache`,isStale:Date.parse(n.payload.expiresAt)<Date.now(),error:t}:{payload:null,source:`none`,isStale:!1,error:t}},y=e=>e instanceof Error?e:Error(`[paywall] Fallo al consultar la licencia: ${String(e)}`),b=(0,e.createContext)(null),x=e=>e?new Date(e):null,S=new Map,C=(0,e.memo)(({config:n,children:r})=>{let[i,c]=(0,e.useState)(()=>{let e=s()?p(n.licenseKey,n):null;return{payload:e?.payload??null,source:e?`cache`:`none`,isStale:e?Date.parse(e.payload.expiresAt)<Date.now():!1,isLoading:!0,error:null}}),l=(0,e.useRef)(0),u=(0,e.useRef)(null),d=(0,e.useRef)(n.onStatusChange);d.current=n.onStatusChange;let f=(0,e.useCallback)(async()=>{if(!s())return;u.current?.abort();let e=new AbortController;u.current=e;let t=`${n.apiUrl??``}|${n.licenseKey}`,r=S.get(t),i=r??_({licenseKey:n.licenseKey,apiUrl:n.apiUrl,storage:n.storage,maxCacheAgeMs:n.maxCacheAgeMs,fetchImpl:n.fetchImpl,signal:e.signal});r||S.set(t,i);try{let t=await i;if(e.signal.aborted)return;l.current=t.source===`network`?0:l.current+1,c({payload:t.payload,source:t.source,isStale:t.isStale,isLoading:!1,error:t.error}),n.debug&&console.info(`[paywall]`,t.source,t.payload?.status,t.error)}finally{r||S.delete(t)}},[n.apiUrl,n.licenseKey,n.storage,n.maxCacheAgeMs,n.fetchImpl,n.debug]);(0,e.useEffect)(()=>{if(!s())return;f();let e=i.payload?.refreshAfterSeconds,t=n.refreshIntervalMs??9e5,r=Math.min(t,e?e*1e3:t),c=l.current>0?Math.min(o,a*2**Math.min(l.current,5)):r,d=setInterval(()=>void f(),c);return()=>{clearInterval(d),u.current?.abort()}},[f,n.refreshIntervalMs,i.payload]),(0,e.useEffect)(()=>{if(!s())return;let e=()=>{document.visibilityState===`visible`&&f()};return document.addEventListener(`visibilitychange`,e),window.addEventListener(`online`,e),()=>{document.removeEventListener(`visibilitychange`,e),window.removeEventListener(`online`,e)}},[f]);let m=(0,e.useMemo)(()=>{let e=i.payload;return{state:e?.status??`OK`,reason:e?.reason??`NONE`,isBlocked:e?.status===`BLOCKED`,isLoading:i.isLoading,isStale:i.isStale,source:i.source,graceUntil:x(e?.graceUntil),nextTransitionAt:x(e?.nextTransitionAt),message:e?.message??null,contactUrl:e?.contactUrl??null,payload:e,error:i.error,refresh:()=>void f()}},[i,f]);(0,e.useEffect)(()=>{d.current?.(m)},[m]);let h=(0,e.useMemo)(()=>({status:m,config:n}),[m,n]);return(0,t.jsx)(b.Provider,{value:h,children:r})});C.displayName=`PaywallProvider`;var w=[`BLOCKED`],T={OK:`allow`,WARNING:`warn`,GRACE:`grace`,BLOCKED:`grace`},E=(e,t)=>{let n=T[e]??`allow`;return e===`OK`?`allow`:(t.blockOn??w).includes(e)?`block`:n},D=`system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif`,O={position:`fixed`,inset:0,zIndex:2147483647,display:`flex`,alignItems:`center`,justifyContent:`center`,padding:`24px`,background:`rgba(9, 9, 11, 0.92)`,backdropFilter:`blur(6px)`,fontFamily:D,color:`#fafafa`,overflowY:`auto`},k={width:`100%`,maxWidth:`440px`,background:`#18181b`,border:`1px solid #27272a`,borderRadius:`16px`,padding:`32px`,boxShadow:`0 24px 48px rgba(0, 0, 0, 0.45)`,textAlign:`center`},A={display:`inline-flex`,alignItems:`center`,justifyContent:`center`,width:`48px`,height:`48px`,borderRadius:`50%`,background:`rgba(239, 68, 68, 0.14)`,color:`#f87171`,fontSize:`24px`,marginBottom:`20px`},j={margin:`0 0 12px`,fontSize:`20px`,fontWeight:600,lineHeight:1.3},M={margin:`0 0 24px`,fontSize:`15px`,lineHeight:1.55,color:`#a1a1aa`},N={display:`inline-block`,padding:`11px 22px`,borderRadius:`10px`,background:`#fafafa`,color:`#18181b`,fontSize:`14px`,fontWeight:600,textDecoration:`none`},P={margin:`20px 0 0`,fontSize:`12px`,color:`#71717a`},F={position:`sticky`,top:0,zIndex:2147483e3,display:`flex`,alignItems:`center`,gap:`12px`,padding:`10px 16px`,fontFamily:D,fontSize:`14px`,lineHeight:1.4,boxSizing:`border-box`},I={...F,background:`#fef3c7`,color:`#78350f`,borderBottom:`1px solid #fcd34d`},L={...F,background:`#fee2e2`,color:`#7f1d1d`,borderBottom:`1px solid #fca5a5`},R={color:`inherit`,fontWeight:600,textDecoration:`underline`,whiteSpace:`nowrap`},z={marginLeft:`auto`,padding:`2px 8px`,border:`none`,borderRadius:`6px`,background:`transparent`,color:`inherit`,fontSize:`18px`,lineHeight:1,cursor:`pointer`},B={flex:1,minWidth:0},V=`Este servicio está temporalmente suspendido. Ponte en contacto con el proveedor para restablecerlo.`,H=(0,e.memo)(({status:n,config:r})=>{let i=(0,e.useMemo)(()=>r.productName?`${r.productName} no está disponible`:`Servicio no disponible`,[r.productName]);return(0,t.jsx)(`div`,{style:O,role:`alertdialog`,"aria-modal":`true`,children:(0,t.jsxs)(`div`,{style:k,children:[(0,t.jsx)(`div`,{style:A,"aria-hidden":`true`,children:`⚠`}),(0,t.jsx)(`h1`,{style:j,children:i}),(0,t.jsx)(`p`,{style:M,children:n.message??V}),n.contactUrl?(0,t.jsx)(`a`,{style:N,href:n.contactUrl,target:`_blank`,rel:`noreferrer noopener`,children:`Resolver ahora`}):null,r.contactEmail?(0,t.jsxs)(`p`,{style:P,children:[`¿Dudas? Escribe a`,` `,(0,t.jsx)(`a`,{href:`mailto:${r.contactEmail}`,style:R,children:r.contactEmail})]}):null]})})});H.displayName=`BlockedOverlay`;var U=e=>{if(!e)return null;let t=e.getTime()-Date.now();if(t<=0)return null;let n=Math.floor(t/864e5);if(n>=1)return n===1?`1 día`:`${n} días`;let r=Math.max(1,Math.floor(t/36e5));return r===1?`1 hora`:`${r} horas`},W=(0,e.memo)(({status:n,variant:r})=>{let[i,a]=(0,e.useState)(!1),o=(0,e.useMemo)(()=>U(n.graceUntil),[n.graceUntil]);if(i)return null;let s=r===`grace`?L:I;return(0,t.jsxs)(`div`,{style:s,role:`status`,children:[(0,t.jsxs)(`span`,{style:B,children:[n.message,o?(0,t.jsxs)(`strong`,{children:[` El servicio se suspenderá en `,o,`.`]}):null]}),n.contactUrl?(0,t.jsx)(`a`,{style:R,href:n.contactUrl,target:`_blank`,rel:`noreferrer noopener`,children:`Resolver`}):null,r===`warning`?(0,t.jsx)(`button`,{type:`button`,style:z,onClick:()=>a(!0),"aria-label":`Descartar aviso`,children:`×`}):null]})});W.displayName=`StatusBanner`;var G=(0,e.memo)(({children:n,renderBlocked:r,renderWarning:i,renderGrace:a,showBanners:o=!0})=>{let s=(0,e.useContext)(b);if(!s)throw Error(`[paywall] <PaywallGate> debe usarse dentro de <PaywallProvider>.`);let{status:c,config:l}=s,u=(0,e.useMemo)(()=>E(c.state,l),[c.state,l]);if(u===`block`)return(0,t.jsx)(t.Fragment,{children:r?r(c):(0,t.jsx)(H,{status:c,config:l})});let d=o?u===`warn`?i?i(c):(0,t.jsx)(W,{status:c,variant:`warning`}):u===`grace`?a?a(c):(0,t.jsx)(W,{status:c,variant:`grace`}):null:null;return(0,t.jsxs)(t.Fragment,{children:[d,n]})});G.displayName=`PaywallGate`;var K=()=>{let t=(0,e.useContext)(b);if(!t)throw Error(`[paywall] useLicenseStatus debe usarse dentro de <PaywallProvider>.`);return t.status};exports.PaywallGate=G,exports.PaywallProvider=C,exports.clearLicenseCache=m,exports.useLicenseStatus=K;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { PaywallProvider } from './react/PaywallProvider';
+export { PaywallGate } from './react/PaywallGate';
+export { useLicenseStatus } from './react/useLicenseStatus';
+export { clearLicenseCache } from './core/cache';
+export type { PaywallConfigI, PaywallGatePropsI, LicenseStatusI, LicensePayloadI, LicenseStateT, LicenseReasonT, LicenseSourceT, GateDecisionT, } from './types';
+export type { PaywallProviderPropsI } from './react/PaywallProvider';

package/dist/index.js

@@ -0,0 +1,400 @@
+"use client";
+import { createContext as e, memo as t, useCallback as n, useContext as r, useEffect as i, useMemo as a, useRef as o, useState as s } from "react";
+import { Fragment as c, jsx as l, jsxs as u } from "react/jsx-runtime";
+var d = "/api/public/license/v1/status", f = "cpl:state:", p = 1e4, m = 1e3, h = 3e4, g = () => typeof window < "u" && window.document !== void 0, _ = /* @__PURE__ */ new Map(), v = (e) => `${f}${e.slice(0, 12)}`, y = (e) => (e.storage ?? "local") === "local" && g(), b = (e) => {
+	if (typeof e != "object" || !e) return !1;
+	let t = e;
+	return t.version !== 1 || typeof t.receivedAt != "number" ? !1 : typeof t.payload?.status == "string";
+}, x = (e, t, n) => {
+	if ((n.storage ?? "local") === "none") return;
+	let r = {
+		version: 1,
+		payload: t,
+		receivedAt: Date.now()
+	}, i = v(e);
+	if (_.set(i, r), y(n)) try {
+		window.localStorage.setItem(i, JSON.stringify(r));
+	} catch {}
+}, S = (e, t) => {
+	if ((t.storage ?? "local") === "none") return null;
+	let n = v(e), r = _.get(n) ?? null;
+	if (!r && y(t)) try {
+		let e = window.localStorage.getItem(n);
+		if (e) {
+			let t = JSON.parse(e);
+			b(t) && (r = t);
+		}
+	} catch {}
+	if (!r) return null;
+	let i = t.maxCacheAgeMs ?? 6048e5;
+	return Date.now() - r.receivedAt > i ? (C(e), null) : r;
+}, C = (e) => {
+	let t = v(e);
+	if (_.delete(t), g()) try {
+		window.localStorage.removeItem(t);
+	} catch {}
+}, w = 1, ee = (e) => {
+	if (typeof e != "object" || !e) return !1;
+	let t = e;
+	return t.v === w && typeof t.status == "string" && typeof t.licenseId == "string";
+}, T = async (e) => {
+	let { licenseKey: t } = e;
+	if (!t) return E(e, /* @__PURE__ */ Error("[paywall] Falta licenseKey en la configuración."));
+	let n = e.fetchImpl ?? globalThis.fetch;
+	if (typeof n != "function") return E(e, /* @__PURE__ */ Error("[paywall] No hay implementación de fetch disponible."));
+	let r = `${(e.apiUrl ?? "https://api.clients.ridel.dev").replace(/\/+$/, "")}${d}?key=${encodeURIComponent(t)}&t=${Date.now()}`, i = new AbortController(), a = setTimeout(() => i.abort(), p);
+	try {
+		let a = await n(r, {
+			method: "GET",
+			credentials: "omit",
+			signal: e.signal ?? i.signal
+		}), o = await a.json();
+		if (!a.ok) {
+			let t = o?.error ?? `HTTP ${a.status}`;
+			return E(e, /* @__PURE__ */ Error(`[paywall] El servidor rechazó la licencia: ${t}`));
+		}
+		return ee(o) ? (x(t, o, e), {
+			payload: o,
+			source: "network",
+			isStale: !1,
+			error: null
+		}) : E(e, /* @__PURE__ */ Error("[paywall] Respuesta con un formato que esta versión del SDK no entiende. Actualiza el paquete."));
+	} catch (t) {
+		return E(e, D(t));
+	} finally {
+		clearTimeout(a);
+	}
+}, E = (e, t) => {
+	let n = e.licenseKey ? S(e.licenseKey, e) : null;
+	return n ? {
+		payload: n.payload,
+		source: "cache",
+		isStale: Date.parse(n.payload.expiresAt) < Date.now(),
+		error: t
+	} : {
+		payload: null,
+		source: "none",
+		isStale: !1,
+		error: t
+	};
+}, D = (e) => e instanceof Error ? e : /* @__PURE__ */ Error(`[paywall] Fallo al consultar la licencia: ${String(e)}`), O = e(null), k = (e) => e ? new Date(e) : null, A = /* @__PURE__ */ new Map(), j = t(({ config: e, children: t }) => {
+	let [r, c] = s(() => {
+		let t = g() ? S(e.licenseKey, e) : null;
+		return {
+			payload: t?.payload ?? null,
+			source: t ? "cache" : "none",
+			isStale: t ? Date.parse(t.payload.expiresAt) < Date.now() : !1,
+			isLoading: !0,
+			error: null
+		};
+	}), u = o(0), d = o(null), f = o(e.onStatusChange);
+	f.current = e.onStatusChange;
+	let p = n(async () => {
+		if (!g()) return;
+		d.current?.abort();
+		let t = new AbortController();
+		d.current = t;
+		let n = `${e.apiUrl ?? ""}|${e.licenseKey}`, r = A.get(n), i = r ?? T({
+			licenseKey: e.licenseKey,
+			apiUrl: e.apiUrl,
+			storage: e.storage,
+			maxCacheAgeMs: e.maxCacheAgeMs,
+			fetchImpl: e.fetchImpl,
+			signal: t.signal
+		});
+		r || A.set(n, i);
+		try {
+			let n = await i;
+			if (t.signal.aborted) return;
+			u.current = n.source === "network" ? 0 : u.current + 1, c({
+				payload: n.payload,
+				source: n.source,
+				isStale: n.isStale,
+				isLoading: !1,
+				error: n.error
+			}), e.debug && console.info("[paywall]", n.source, n.payload?.status, n.error);
+		} finally {
+			r || A.delete(n);
+		}
+	}, [
+		e.apiUrl,
+		e.licenseKey,
+		e.storage,
+		e.maxCacheAgeMs,
+		e.fetchImpl,
+		e.debug
+	]);
+	i(() => {
+		if (!g()) return;
+		p();
+		let t = r.payload?.refreshAfterSeconds, n = e.refreshIntervalMs ?? 9e5, i = Math.min(n, t ? t * 1e3 : n), a = u.current > 0 ? Math.min(h, m * 2 ** Math.min(u.current, 5)) : i, o = setInterval(() => void p(), a);
+		return () => {
+			clearInterval(o), d.current?.abort();
+		};
+	}, [
+		p,
+		e.refreshIntervalMs,
+		r.payload
+	]), i(() => {
+		if (!g()) return;
+		let e = () => {
+			document.visibilityState === "visible" && p();
+		};
+		return document.addEventListener("visibilitychange", e), window.addEventListener("online", e), () => {
+			document.removeEventListener("visibilitychange", e), window.removeEventListener("online", e);
+		};
+	}, [p]);
+	let _ = a(() => {
+		let e = r.payload;
+		return {
+			state: e?.status ?? "OK",
+			reason: e?.reason ?? "NONE",
+			isBlocked: e?.status === "BLOCKED",
+			isLoading: r.isLoading,
+			isStale: r.isStale,
+			source: r.source,
+			graceUntil: k(e?.graceUntil),
+			nextTransitionAt: k(e?.nextTransitionAt),
+			message: e?.message ?? null,
+			contactUrl: e?.contactUrl ?? null,
+			payload: e,
+			error: r.error,
+			refresh: () => void p()
+		};
+	}, [r, p]);
+	i(() => {
+		f.current?.(_);
+	}, [_]);
+	let v = a(() => ({
+		status: _,
+		config: e
+	}), [_, e]);
+	return /* @__PURE__ */ l(O.Provider, {
+		value: v,
+		children: t
+	});
+});
+j.displayName = "PaywallProvider";
+//#endregion
+//#region src/core/resolveGateDecision.ts
+var M = ["BLOCKED"], N = {
+	OK: "allow",
+	WARNING: "warn",
+	GRACE: "grace",
+	BLOCKED: "grace"
+}, P = (e, t) => {
+	let n = N[e] ?? "allow";
+	return e === "OK" ? "allow" : (t.blockOn ?? M).includes(e) ? "block" : n;
+}, F = "system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif", I = {
+	position: "fixed",
+	inset: 0,
+	zIndex: 2147483647,
+	display: "flex",
+	alignItems: "center",
+	justifyContent: "center",
+	padding: "24px",
+	background: "rgba(9, 9, 11, 0.92)",
+	backdropFilter: "blur(6px)",
+	fontFamily: F,
+	color: "#fafafa",
+	overflowY: "auto"
+}, L = {
+	width: "100%",
+	maxWidth: "440px",
+	background: "#18181b",
+	border: "1px solid #27272a",
+	borderRadius: "16px",
+	padding: "32px",
+	boxShadow: "0 24px 48px rgba(0, 0, 0, 0.45)",
+	textAlign: "center"
+}, R = {
+	display: "inline-flex",
+	alignItems: "center",
+	justifyContent: "center",
+	width: "48px",
+	height: "48px",
+	borderRadius: "50%",
+	background: "rgba(239, 68, 68, 0.14)",
+	color: "#f87171",
+	fontSize: "24px",
+	marginBottom: "20px"
+}, z = {
+	margin: "0 0 12px",
+	fontSize: "20px",
+	fontWeight: 600,
+	lineHeight: 1.3
+}, B = {
+	margin: "0 0 24px",
+	fontSize: "15px",
+	lineHeight: 1.55,
+	color: "#a1a1aa"
+}, V = {
+	display: "inline-block",
+	padding: "11px 22px",
+	borderRadius: "10px",
+	background: "#fafafa",
+	color: "#18181b",
+	fontSize: "14px",
+	fontWeight: 600,
+	textDecoration: "none"
+}, H = {
+	margin: "20px 0 0",
+	fontSize: "12px",
+	color: "#71717a"
+}, U = {
+	position: "sticky",
+	top: 0,
+	zIndex: 2147483e3,
+	display: "flex",
+	alignItems: "center",
+	gap: "12px",
+	padding: "10px 16px",
+	fontFamily: F,
+	fontSize: "14px",
+	lineHeight: 1.4,
+	boxSizing: "border-box"
+}, W = {
+	...U,
+	background: "#fef3c7",
+	color: "#78350f",
+	borderBottom: "1px solid #fcd34d"
+}, G = {
+	...U,
+	background: "#fee2e2",
+	color: "#7f1d1d",
+	borderBottom: "1px solid #fca5a5"
+}, K = {
+	color: "inherit",
+	fontWeight: 600,
+	textDecoration: "underline",
+	whiteSpace: "nowrap"
+}, q = {
+	marginLeft: "auto",
+	padding: "2px 8px",
+	border: "none",
+	borderRadius: "6px",
+	background: "transparent",
+	color: "inherit",
+	fontSize: "18px",
+	lineHeight: 1,
+	cursor: "pointer"
+}, J = {
+	flex: 1,
+	minWidth: 0
+}, Y = "Este servicio está temporalmente suspendido. Ponte en contacto con el proveedor para restablecerlo.", X = t(({ status: e, config: t }) => {
+	let n = a(() => t.productName ? `${t.productName} no está disponible` : "Servicio no disponible", [t.productName]);
+	return /* @__PURE__ */ l("div", {
+		style: I,
+		role: "alertdialog",
+		"aria-modal": "true",
+		children: /* @__PURE__ */ u("div", {
+			style: L,
+			children: [
+				/* @__PURE__ */ l("div", {
+					style: R,
+					"aria-hidden": "true",
+					children: "⚠"
+				}),
+				/* @__PURE__ */ l("h1", {
+					style: z,
+					children: n
+				}),
+				/* @__PURE__ */ l("p", {
+					style: B,
+					children: e.message ?? Y
+				}),
+				e.contactUrl ? /* @__PURE__ */ l("a", {
+					style: V,
+					href: e.contactUrl,
+					target: "_blank",
+					rel: "noreferrer noopener",
+					children: "Resolver ahora"
+				}) : null,
+				t.contactEmail ? /* @__PURE__ */ u("p", {
+					style: H,
+					children: [
+						"¿Dudas? Escribe a",
+						" ",
+						/* @__PURE__ */ l("a", {
+							href: `mailto:${t.contactEmail}`,
+							style: K,
+							children: t.contactEmail
+						})
+					]
+				}) : null
+			]
+		})
+	});
+});
+X.displayName = "BlockedOverlay";
+//#endregion
+//#region src/react/ui/StatusBanner.tsx
+var Z = (e) => {
+	if (!e) return null;
+	let t = e.getTime() - Date.now();
+	if (t <= 0) return null;
+	let n = Math.floor(t / 864e5);
+	if (n >= 1) return n === 1 ? "1 día" : `${n} días`;
+	let r = Math.max(1, Math.floor(t / 36e5));
+	return r === 1 ? "1 hora" : `${r} horas`;
+}, Q = t(({ status: e, variant: t }) => {
+	let [n, r] = s(!1), i = a(() => Z(e.graceUntil), [e.graceUntil]);
+	return n ? null : /* @__PURE__ */ u("div", {
+		style: t === "grace" ? G : W,
+		role: "status",
+		children: [
+			/* @__PURE__ */ u("span", {
+				style: J,
+				children: [e.message, i ? /* @__PURE__ */ u("strong", { children: [
+					" El servicio se suspenderá en ",
+					i,
+					"."
+				] }) : null]
+			}),
+			e.contactUrl ? /* @__PURE__ */ l("a", {
+				style: K,
+				href: e.contactUrl,
+				target: "_blank",
+				rel: "noreferrer noopener",
+				children: "Resolver"
+			}) : null,
+			t === "warning" ? /* @__PURE__ */ l("button", {
+				type: "button",
+				style: q,
+				onClick: () => r(!0),
+				"aria-label": "Descartar aviso",
+				children: "×"
+			}) : null
+		]
+	});
+});
+Q.displayName = "StatusBanner";
+//#endregion
+//#region src/react/PaywallGate.tsx
+var $ = t(({ children: e, renderBlocked: t, renderWarning: n, renderGrace: i, showBanners: o = !0 }) => {
+	let s = r(O);
+	if (!s) throw Error("[paywall] <PaywallGate> debe usarse dentro de <PaywallProvider>.");
+	let { status: d, config: f } = s, p = a(() => P(d.state, f), [d.state, f]);
+	if (p === "block") return /* @__PURE__ */ l(c, { children: t ? t(d) : /* @__PURE__ */ l(X, {
+		status: d,
+		config: f
+	}) });
+	let m = o ? p === "warn" ? n ? n(d) : /* @__PURE__ */ l(Q, {
+		status: d,
+		variant: "warning"
+	}) : p === "grace" ? i ? i(d) : /* @__PURE__ */ l(Q, {
+		status: d,
+		variant: "grace"
+	}) : null : null;
+	return /* @__PURE__ */ u(c, { children: [m, e] });
+});
+$.displayName = "PaywallGate";
+//#endregion
+//#region src/react/useLicenseStatus.ts
+var te = () => {
+	let e = r(O);
+	if (!e) throw Error("[paywall] useLicenseStatus debe usarse dentro de <PaywallProvider>.");
+	return e.status;
+};
+//#endregion
+export { $ as PaywallGate, j as PaywallProvider, C as clearLicenseCache, te as useLicenseStatus };

package/dist/react/PaywallContext.d.ts

@@ -0,0 +1,6 @@
+import { LicenseStatusI, PaywallConfigI } from '../types';
+export interface PaywallContextValueI {
+    status: LicenseStatusI;
+    config: PaywallConfigI;
+}
+export declare const PaywallContext: import('react').Context<PaywallContextValueI | null>;

package/dist/react/PaywallGate.d.ts

@@ -0,0 +1,10 @@
+import { ReactElement } from 'react';
+import { PaywallGatePropsI } from '../types';
+/**
+ * Envuelve la aplicación y decide si se ve.
+ *
+ * Bloquear **no renderiza** los hijos en lugar de taparlos con CSS. Ocultar con
+ * `display:none` se deshace desde las herramientas de desarrollo en dos clics, y
+ * además dejaría corriendo los efectos y las peticiones de la aplicación.
+ */
+export declare const PaywallGate: import('react').MemoExoticComponent<({ children, renderBlocked, renderWarning, renderGrace, showBanners, }: PaywallGatePropsI) => ReactElement>;

package/dist/react/PaywallProvider.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+import { PaywallConfigI } from '../types';
+export interface PaywallProviderPropsI {
+    config: PaywallConfigI;
+    children: ReactNode;
+}
+export declare const PaywallProvider: import('react').MemoExoticComponent<({ config, children }: PaywallProviderPropsI) => import("react").JSX.Element>;

package/dist/react/ui/BlockedOverlay.d.ts

@@ -0,0 +1,6 @@
+import { LicenseStatusI, PaywallConfigI } from '../../types';
+export interface BlockedOverlayPropsI {
+    status: LicenseStatusI;
+    config: PaywallConfigI;
+}
+export declare const BlockedOverlay: import('react').MemoExoticComponent<({ status, config }: BlockedOverlayPropsI) => import("react").JSX.Element>;

package/dist/react/ui/StatusBanner.d.ts

@@ -0,0 +1,7 @@
+import { LicenseStatusI } from '../../types';
+export interface StatusBannerPropsI {
+    status: LicenseStatusI;
+    /** `grace` no se puede descartar: es el último aviso antes del corte. */
+    variant: "warning" | "grace";
+}
+export declare const StatusBanner: import('react').MemoExoticComponent<({ status, variant }: StatusBannerPropsI) => import("react").JSX.Element | null>;

package/dist/react/ui/styles.d.ts

@@ -0,0 +1,14 @@
+import { CSSProperties } from 'react';
+export declare const overlay: CSSProperties;
+export declare const card: CSSProperties;
+export declare const badge: CSSProperties;
+export declare const title: CSSProperties;
+export declare const body: CSSProperties;
+export declare const action: CSSProperties;
+export declare const footnote: CSSProperties;
+export declare const bannerBase: CSSProperties;
+export declare const bannerWarning: CSSProperties;
+export declare const bannerGrace: CSSProperties;
+export declare const bannerLink: CSSProperties;
+export declare const bannerDismiss: CSSProperties;
+export declare const bannerText: CSSProperties;

package/dist/react/useLicenseStatus.d.ts

@@ -0,0 +1,7 @@
+import { LicenseStatusI } from '../types';
+/**
+ * Estado de licencia en crudo, para pintar avisos a medida sin usar
+ * `<PaywallGate>`. Fuera de un `<PaywallProvider>` lanza: es un error de
+ * integración, no algo que deba degradarse en silencio.
+ */
+export declare const useLicenseStatus: () => LicenseStatusI;

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+export type LicenseStateT = "OK" | "WARNING" | "GRACE" | "BLOCKED";
+export type LicenseReasonT = "NONE" | "PAYMENT_OVERDUE" | "SUBSCRIPTION_INACTIVE" | "MANUAL_BLOCK" | "MANUAL_ALLOW" | "LICENSE_REVOKED";
+/** De dónde salió el estado que se está mostrando. */
+export type LicenseSourceT = "network" | "cache" | "none";
+/** Contrato público del servidor: `GET /api/public/license/v1/status`. */
+export interface LicensePayloadI {
+    v: number;
+    status: LicenseStateT;
+    reason: LicenseReasonT;
+    licenseId: string;
+    projectId: string;
+    graceUntil: string | null;
+    blockedAt: string | null;
+    nextTransitionAt: string | null;
+    checkedAt: string;
+    expiresAt: string;
+    refreshAfterSeconds: number;
+    message: string;
+    contactUrl: string;
+    warnings: string[];
+    token: string;
+    /** Solo si la licencia tiene `exposeDetails` activado. */
+    amountDue?: number;
+    overdueCount?: number;
+    daysOverdue?: number;
+    projectTitle?: string;
+}
+export interface PaywallConfigI {
+    /** Key `cpl_…` emitida desde el panel de administración. */
+    licenseKey: string;
+    apiUrl?: string;
+    refreshIntervalMs?: number;
+    /** Estados que tapan la aplicación. Por defecto solo `BLOCKED`. */
+    blockOn?: LicenseStateT[];
+    /**
+     * Qué hacer si el servidor no responde. Por defecto `true`: se deja pasar.
+     * Ponerlo a `false` significa que una caída del servidor de licencias tumba
+     * la aplicación del cliente.
+     */
+    failOpen?: boolean;
+    maxCacheAgeMs?: number;
+    storage?: "local" | "memory" | "none";
+    contactEmail?: string;
+    productName?: string;
+    debug?: boolean;
+    onStatusChange?: (status: LicenseStatusI) => void;
+    /** Inyectable para tests y entornos sin `fetch` global. */
+    fetchImpl?: typeof fetch;
+}
+export interface LicenseStatusI {
+    state: LicenseStateT;
+    reason: LicenseReasonT;
+    isBlocked: boolean;
+    isLoading: boolean;
+    /** El estado viene de caché caducada: se está usando a falta de algo mejor. */
+    isStale: boolean;
+    source: LicenseSourceT;
+    graceUntil: Date | null;
+    nextTransitionAt: Date | null;
+    message: string | null;
+    contactUrl: string | null;
+    payload: LicensePayloadI | null;
+    error: Error | null;
+    refresh: () => void;
+}
+export type GateDecisionT = "allow" | "warn" | "grace" | "block";
+export interface PaywallGatePropsI {
+    children: React.ReactNode;
+    renderBlocked?: (status: LicenseStatusI) => React.ReactNode;
+    renderWarning?: (status: LicenseStatusI) => React.ReactNode;
+    renderGrace?: (status: LicenseStatusI) => React.ReactNode;
+    showBanners?: boolean;
+}
+export interface CachedEntryI {
+    version: 1;
+    payload: LicensePayloadI;
+    receivedAt: number;
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@cosmo-frameworks/paywall-react",
+  "version": "0.1.0",
+  "description": "Bloqueo remoto de aplicaciones React por estado de pago.",
+  "type": "module",
+  "sideEffects": false,
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cosmo-frameworks/paywall-react.git"
+  },
+  "private": false,
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc --noEmit && vite build",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "dependencies": {},
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.14",
+    "@vitejs/plugin-react": "^6.0.1",
+    "happy-dom": "^20.9.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "~6.0.2",
+    "vite": "^8.0.4",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.1.5"
+  }
+}