@cosmo-frameworks/paywall-react 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -7,6 +7,24 @@ y el versionado es [SemVer](https://semver.org/lang/es/).
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-08-22
+
+### Corregido
+
+- **Bucle de peticiones al montar.** El efecto que programaba la recarga tenía
+  el estado entre sus dependencias, así que cada respuesta lo reprogramaba y
+  disparaba otra petición, encadenando llamadas hasta agotar el rate limit del
+  servidor (HTTP 429). Ahora la cadencia vive en una referencia y el temporizador
+  se encadena con `setTimeout`, de modo que el efecto solo depende de la función
+  de carga. Con 429 el SDK caía además en fail-open, así que el bloqueo dejaba
+  de aplicarse: quien actualice desde 0.1.x debería hacerlo.
+
+## [0.1.1] - 2026-08-21
+
+### Añadido
+
+Cambiado el provider a npm
+
 ## [0.1.0] - 2026-08-21
 
 Primera versión.

package/README.md

@@ -158,68 +158,4 @@ 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.
+Se dispara una consulta nueva, que es más estricta, no menos.

package/dist/index.cjs

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

package/dist/index.js

@@ -1,48 +1,48 @@
 "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) => {
+var d = "/api/public/license/v1/status", f = 9e5, p = "cpl:state:", m = 1e4, h = 1e3, g = 3e4, _ = () => typeof window < "u" && window.document !== void 0, v = /* @__PURE__ */ new Map(), y = (e) => `${p}${e.slice(0, 12)}`, b = (e) => (e.storage ?? "local") === "local" && _(), x = (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) => {
+}, S = (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 {
+	}, i = y(e);
+	if (v.set(i, r), b(n)) try {
 		window.localStorage.setItem(i, JSON.stringify(r));
 	} catch {}
-}, S = (e, t) => {
+}, C = (e, t) => {
 	if ((t.storage ?? "local") === "none") return null;
-	let n = v(e), r = _.get(n) ?? null;
-	if (!r && y(t)) try {
+	let n = y(e), r = v.get(n) ?? null;
+	if (!r && b(t)) try {
 		let e = window.localStorage.getItem(n);
 		if (e) {
 			let t = JSON.parse(e);
-			b(t) && (r = t);
+			x(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 {
+	return Date.now() - r.receivedAt > i ? (w(e), null) : r;
+}, w = (e) => {
+	let t = y(e);
+	if (v.delete(t), _()) try {
 		window.localStorage.removeItem(t);
 	} catch {}
-}, w = 1, ee = (e) => {
+}, T = 1, E = (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) => {
+	return t.v === T && typeof t.status == "string" && typeof t.licenseId == "string";
+}, D = async (e) => {
 	let { licenseKey: t } = e;
-	if (!t) return E(e, /* @__PURE__ */ Error("[paywall] Falta licenseKey en la configuración."));
+	if (!t) return O(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);
+	if (typeof n != "function") return O(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(), m);
 	try {
 		let a = await n(r, {
 			method: "GET",
@@ -51,21 +51,21 @@ var d = "/api/public/license/v1/status", f = "cpl:state:", p = 1e4, m = 1e3, h =
 		}), 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 O(e, /* @__PURE__ */ Error(`[paywall] El servidor rechazó la licencia: ${t}`));
 		}
-		return ee(o) ? (x(t, o, e), {
+		return E(o) ? (S(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."));
+		}) : O(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));
+		return O(e, ee(t));
 	} finally {
 		clearTimeout(a);
 	}
-}, E = (e, t) => {
-	let n = e.licenseKey ? S(e.licenseKey, e) : null;
+}, O = (e, t) => {
+	let n = e.licenseKey ? C(e.licenseKey, e) : null;
 	return n ? {
 		payload: n.payload,
 		source: "cache",
@@ -77,9 +77,13 @@ var d = "/api/public/license/v1/status", f = "cpl:state:", p = 1e4, m = 1e3, h =
 		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 }) => {
+}, ee = (e) => e instanceof Error ? e : /* @__PURE__ */ Error(`[paywall] Fallo al consultar la licencia: ${String(e)}`), k = e(null), A = (e) => e ? new Date(e) : null, j = /* @__PURE__ */ new Map(), M = (e) => {
+	if (e.failures > 0) return Math.min(g, h * 2 ** Math.min(e.failures, 5));
+	let t = e.configuredMs ?? 9e5;
+	return e.serverHintSeconds ? Math.min(t, e.serverHintSeconds * 1e3) : t;
+}, N = t(({ config: e, children: t }) => {
 	let [r, c] = s(() => {
-		let t = g() ? S(e.licenseKey, e) : null;
+		let t = _() ? C(e.licenseKey, e) : null;
 		return {
 			payload: t?.payload ?? null,
 			source: t ? "cache" : "none",
@@ -87,14 +91,14 @@ var d = "/api/public/license/v1/status", f = "cpl:state:", p = 1e4, m = 1e3, h =
 			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;
+	}), u = o(0), d = o(null), p = o(f), m = o(e.onStatusChange);
+	m.current = e.onStatusChange;
+	let h = n(async () => {
+		if (!_()) return;
 		d.current?.abort();
 		let t = new AbortController();
 		d.current = t;
-		let n = `${e.apiUrl ?? ""}|${e.licenseKey}`, r = A.get(n), i = r ?? T({
+		let n = `${e.apiUrl ?? ""}|${e.licenseKey}`, r = j.get(n), i = r ?? D({
 			licenseKey: e.licenseKey,
 			apiUrl: e.apiUrl,
 			storage: e.storage,
@@ -102,11 +106,15 @@ var d = "/api/public/license/v1/status", f = "cpl:state:", p = 1e4, m = 1e3, h =
 			fetchImpl: e.fetchImpl,
 			signal: t.signal
 		});
-		r || A.set(n, i);
+		r || j.set(n, i);
 		try {
 			let n = await i;
 			if (t.signal.aborted) return;
-			u.current = n.source === "network" ? 0 : u.current + 1, c({
+			u.current = n.source === "network" ? 0 : u.current + 1, p.current = M({
+				failures: u.current,
+				serverHintSeconds: n.payload?.refreshAfterSeconds,
+				configuredMs: e.refreshIntervalMs
+			}), c({
 				payload: n.payload,
 				source: n.source,
 				isStale: n.isStale,
@@ -114,7 +122,7 @@ var d = "/api/public/license/v1/status", f = "cpl:state:", p = 1e4, m = 1e3, h =
 				error: n.error
 			}), e.debug && console.info("[paywall]", n.source, n.payload?.status, n.error);
 		} finally {
-			r || A.delete(n);
+			r || j.delete(n);
 		}
 	}, [
 		e.apiUrl,
@@ -122,29 +130,29 @@ var d = "/api/public/license/v1/status", f = "cpl:state:", p = 1e4, m = 1e3, h =
 		e.storage,
 		e.maxCacheAgeMs,
 		e.fetchImpl,
-		e.debug
+		e.debug,
+		e.refreshIntervalMs
 	]);
 	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();
+		if (!_()) return;
+		let e = !1, t, n = () => {
+			e || (t = setTimeout(() => {
+				h().then(n);
+			}, p.current));
 		};
-	}, [
-		p,
-		e.refreshIntervalMs,
-		r.payload
-	]), i(() => {
-		if (!g()) return;
+		return h().then(n), () => {
+			e = !0, t && clearTimeout(t), d.current?.abort();
+		};
+	}, [h]), i(() => {
+		if (!_()) return;
 		let e = () => {
-			document.visibilityState === "visible" && p();
+			document.visibilityState === "visible" && h();
 		};
 		return document.addEventListener("visibilitychange", e), window.addEventListener("online", e), () => {
 			document.removeEventListener("visibilitychange", e), window.removeEventListener("online", e);
 		};
-	}, [p]);
-	let _ = a(() => {
+	}, [h]);
+	let g = a(() => {
 		let e = r.payload;
 		return {
 			state: e?.status ?? "OK",
@@ -153,39 +161,39 @@ var d = "/api/public/license/v1/status", f = "cpl:state:", p = 1e4, m = 1e3, h =
 			isLoading: r.isLoading,
 			isStale: r.isStale,
 			source: r.source,
-			graceUntil: k(e?.graceUntil),
-			nextTransitionAt: k(e?.nextTransitionAt),
+			graceUntil: A(e?.graceUntil),
+			nextTransitionAt: A(e?.nextTransitionAt),
 			message: e?.message ?? null,
 			contactUrl: e?.contactUrl ?? null,
 			payload: e,
 			error: r.error,
-			refresh: () => void p()
+			refresh: () => void h()
 		};
-	}, [r, p]);
+	}, [r, h]);
 	i(() => {
-		f.current?.(_);
-	}, [_]);
+		m.current?.(g);
+	}, [g]);
 	let v = a(() => ({
-		status: _,
+		status: g,
 		config: e
-	}), [_, e]);
-	return /* @__PURE__ */ l(O.Provider, {
+	}), [g, e]);
+	return /* @__PURE__ */ l(k.Provider, {
 		value: v,
 		children: t
 	});
 });
-j.displayName = "PaywallProvider";
+N.displayName = "PaywallProvider";
 //#endregion
 //#region src/core/resolveGateDecision.ts
-var M = ["BLOCKED"], N = {
+var te = ["BLOCKED"], P = {
 	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 = {
+}, F = (e, t) => {
+	let n = P[e] ?? "allow";
+	return e === "OK" ? "allow" : (t.blockOn ?? te).includes(e) ? "block" : n;
+}, I = "system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif", L = {
 	position: "fixed",
 	inset: 0,
 	zIndex: 2147483647,
@@ -195,10 +203,10 @@ var M = ["BLOCKED"], N = {
 	padding: "24px",
 	background: "rgba(9, 9, 11, 0.92)",
 	backdropFilter: "blur(6px)",
-	fontFamily: F,
+	fontFamily: I,
 	color: "#fafafa",
 	overflowY: "auto"
-}, L = {
+}, R = {
 	width: "100%",
 	maxWidth: "440px",
 	background: "#18181b",
@@ -207,7 +215,7 @@ var M = ["BLOCKED"], N = {
 	padding: "32px",
 	boxShadow: "0 24px 48px rgba(0, 0, 0, 0.45)",
 	textAlign: "center"
-}, R = {
+}, z = {
 	display: "inline-flex",
 	alignItems: "center",
 	justifyContent: "center",
@@ -218,17 +226,17 @@ var M = ["BLOCKED"], N = {
 	color: "#f87171",
 	fontSize: "24px",
 	marginBottom: "20px"
-}, z = {
+}, B = {
 	margin: "0 0 12px",
 	fontSize: "20px",
 	fontWeight: 600,
 	lineHeight: 1.3
-}, B = {
+}, V = {
 	margin: "0 0 24px",
 	fontSize: "15px",
 	lineHeight: 1.55,
 	color: "#a1a1aa"
-}, V = {
+}, H = {
 	display: "inline-block",
 	padding: "11px 22px",
 	borderRadius: "10px",
@@ -237,11 +245,11 @@ var M = ["BLOCKED"], N = {
 	fontSize: "14px",
 	fontWeight: 600,
 	textDecoration: "none"
-}, H = {
+}, U = {
 	margin: "20px 0 0",
 	fontSize: "12px",
 	color: "#71717a"
-}, U = {
+}, W = {
 	position: "sticky",
 	top: 0,
 	zIndex: 2147483e3,
@@ -249,26 +257,26 @@ var M = ["BLOCKED"], N = {
 	alignItems: "center",
 	gap: "12px",
 	padding: "10px 16px",
-	fontFamily: F,
+	fontFamily: I,
 	fontSize: "14px",
 	lineHeight: 1.4,
 	boxSizing: "border-box"
-}, W = {
-	...U,
+}, G = {
+	...W,
 	background: "#fef3c7",
 	color: "#78350f",
 	borderBottom: "1px solid #fcd34d"
-}, G = {
-	...U,
+}, K = {
+	...W,
 	background: "#fee2e2",
 	color: "#7f1d1d",
 	borderBottom: "1px solid #fca5a5"
-}, K = {
+}, q = {
 	color: "inherit",
 	fontWeight: 600,
 	textDecoration: "underline",
 	whiteSpace: "nowrap"
-}, q = {
+}, J = {
 	marginLeft: "auto",
 	padding: "2px 8px",
 	border: "none",
@@ -278,46 +286,46 @@ var M = ["BLOCKED"], N = {
 	fontSize: "18px",
 	lineHeight: 1,
 	cursor: "pointer"
-}, J = {
+}, Y = {
 	flex: 1,
 	minWidth: 0
-}, Y = "Este servicio está temporalmente suspendido. Ponte en contacto con el proveedor para restablecerlo.", X = t(({ status: e, config: t }) => {
+}, X = "Este servicio está temporalmente suspendido. Ponte en contacto con el proveedor para restablecerlo.", Z = 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,
+		style: L,
 		role: "alertdialog",
 		"aria-modal": "true",
 		children: /* @__PURE__ */ u("div", {
-			style: L,
+			style: R,
 			children: [
 				/* @__PURE__ */ l("div", {
-					style: R,
+					style: z,
 					"aria-hidden": "true",
 					children: "⚠"
 				}),
 				/* @__PURE__ */ l("h1", {
-					style: z,
+					style: B,
 					children: n
 				}),
 				/* @__PURE__ */ l("p", {
-					style: B,
-					children: e.message ?? Y
+					style: V,
+					children: e.message ?? X
 				}),
 				e.contactUrl ? /* @__PURE__ */ l("a", {
-					style: V,
+					style: H,
 					href: e.contactUrl,
 					target: "_blank",
 					rel: "noreferrer noopener",
 					children: "Resolver ahora"
 				}) : null,
 				t.contactEmail ? /* @__PURE__ */ u("p", {
-					style: H,
+					style: U,
 					children: [
 						"¿Dudas? Escribe a",
 						" ",
 						/* @__PURE__ */ l("a", {
 							href: `mailto:${t.contactEmail}`,
-							style: K,
+							style: q,
 							children: t.contactEmail
 						})
 					]
@@ -326,10 +334,10 @@ var M = ["BLOCKED"], N = {
 		})
 	});
 });
-X.displayName = "BlockedOverlay";
+Z.displayName = "BlockedOverlay";
 //#endregion
 //#region src/react/ui/StatusBanner.tsx
-var Z = (e) => {
+var ne = (e) => {
 	if (!e) return null;
 	let t = e.getTime() - Date.now();
 	if (t <= 0) return null;
@@ -338,13 +346,13 @@ var Z = (e) => {
 	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]);
+	let [n, r] = s(!1), i = a(() => ne(e.graceUntil), [e.graceUntil]);
 	return n ? null : /* @__PURE__ */ u("div", {
-		style: t === "grace" ? G : W,
+		style: t === "grace" ? K : G,
 		role: "status",
 		children: [
 			/* @__PURE__ */ u("span", {
-				style: J,
+				style: Y,
 				children: [e.message, i ? /* @__PURE__ */ u("strong", { children: [
 					" El servicio se suspenderá en ",
 					i,
@@ -352,7 +360,7 @@ var Z = (e) => {
 				] }) : null]
 			}),
 			e.contactUrl ? /* @__PURE__ */ l("a", {
-				style: K,
+				style: q,
 				href: e.contactUrl,
 				target: "_blank",
 				rel: "noreferrer noopener",
@@ -360,7 +368,7 @@ var Z = (e) => {
 			}) : null,
 			t === "warning" ? /* @__PURE__ */ l("button", {
 				type: "button",
-				style: q,
+				style: J,
 				onClick: () => r(!0),
 				"aria-label": "Descartar aviso",
 				children: "×"
@@ -372,10 +380,10 @@ 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);
+	let s = r(k);
 	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, {
+	let { status: d, config: f } = s, p = a(() => F(d.state, f), [d.state, f]);
+	if (p === "block") return /* @__PURE__ */ l(c, { children: t ? t(d) : /* @__PURE__ */ l(Z, {
 		status: d,
 		config: f
 	}) });
@@ -391,10 +399,10 @@ var $ = t(({ children: e, renderBlocked: t, renderWarning: n, renderGrace: i, sh
 $.displayName = "PaywallGate";
 //#endregion
 //#region src/react/useLicenseStatus.ts
-var te = () => {
-	let e = r(O);
+var re = () => {
+	let e = r(k);
 	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 };
+export { $ as PaywallGate, N as PaywallProvider, w as clearLicenseCache, re as useLicenseStatus };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmo-frameworks/paywall-react",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Bloqueo remoto de aplicaciones React por estado de pago.",
   "type": "module",
   "sideEffects": false,