@asteby/metacore-runtime-react 23.9.3 → 23.10.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @asteby/metacore-runtime-react
 
+## 23.10.0
+
+### Minor Changes
+
+- c94ec63: feat(license-gate): gate de licencia reutilizable — el negocio blindado en el SDK.
+
+  Nuevo primitivo `<LicenseGate>` (más `<LicenseExpiryBanner>`, `<LicenseStatusBadge>` y los helpers `isLicenseOperable`/`isLicenseBlocking`/`isPresetEntitled`/`isTrialExpired`) que ops y todos los verticales montan en una línea para blindar la app tras la licencia de instancia:
+  - Sin enforcement o estado operable (`valid`/`stale`/`grace`) → renderiza children; `stale`/`grace` montan un banner degradado (`expired` no descartable, el resto descartable con TTL en localStorage).
+  - Enforcement && `missing`/`invalid`/`expired` → modal bloqueante full-screen no descartable con formulario de activación (clave `lic_…` o token pegado); `plan === 'trial'` + `expired` muestra "Tu prueba gratuita terminó". La activación exitosa desbloquea sin recargar.
+  - Branding-aware (logo/nombre) con fallback neutro; i18n es-first con `t(key, { defaultValue })`.
+
+  Independiente del kernel: el host resuelve el `LicenseState` con su propio transporte y pasa `onActivate`. No requiere release del kernel.
+
 ## 23.9.3
 
 ### Patch Changes

package/README.md

@@ -30,6 +30,49 @@ Peers: `react`, `react-dom`, `react-i18next`, `i18next`, `@tanstack/react-router
 | `useMetadataCache()` | Zustand store for table/modal metadata, persisted to LocalStorage. `prefetchAll(api)` warms it from `/metadata/all`. |
 | `defaultGetDynamicColumns` / `makeDefaultGetDynamicColumns(helpers)` | The factory `<DynamicTable>` uses to convert metadata into TanStack column defs. The default reads from `col.key` (matching the kernel contract). |
 | `DynamicIcon` | Lucide icon resolver by name. |
+| `<LicenseGate state={…} onActivate={…}>` | El blindaje del negocio: envuelve la app; bloquea con un modal full-screen no descartable cuando la licencia de instancia falta/venció, degrada con banner en `grace`/`stale`. Branding-aware. |
+| `<LicenseExpiryBanner state={…} />` / `<LicenseStatusBadge status={…} />` | Piezas sueltas del gate para Ajustes u otros lugares. |
+| `isLicenseOperable` / `isLicenseBlocking` / `isPresetEntitled` / `isTrialExpired` | Helpers puros sobre `LicenseState`, espejo de `State.Operable()/Blocking()` del backend. |
+
+## Blindaje de licencia (`LicenseGate`)
+
+El gate de licencia es un **primitivo del SDK**: ops y todos los verticales lo montan
+en una línea. Reparto de responsabilidades:
+
+- **kernel** → *enforcement* (qué está permitido; firma/verifica el estado).
+- **SDK** (este módulo) → *UX* (gate, banner, badge).
+- **hub** → *emisión* (mintea el token Ed25519).
+- **hosts** → *wiring* (resuelven el `LicenseState` con su propio transporte y montan el gate).
+
+Es **independiente del kernel**: no importa su cliente ni fija su versión. El host
+resuelve el estado (p. ej. `GET /admin/license`) y pasa una promesa `onActivate`.
+
+```tsx
+import { LicenseGate } from '@asteby/metacore-runtime-react'
+import { useLicenseState, useActivateLicense } from './features/license'
+
+export function Shell({ children }) {
+  const { data: state } = useLicenseState()          // GET /admin/license
+  const activate = useActivateLicense()              // POST /admin/license/activate
+
+  return (
+    <LicenseGate
+      state={state}
+      onActivate={(code) => activate.mutateAsync(code)}
+      branding={{ name: brand.name, logo: brand.logo }}
+      onManage={() => navigate('/settings/license')}
+    >
+      {children}
+    </LicenseGate>
+  )
+}
+```
+
+- Sin enforcement o estado operable (`valid`/`stale`/`grace`) → renderiza children.
+  `stale`/`grace` montan además el banner degradado (`expired` no es descartable, el resto sí con TTL en localStorage).
+- Enforcement && `missing`/`invalid`/`expired` → modal **bloqueante** con el formulario de activación.
+  `plan === 'trial'` + `expired` → copy *"Tu prueba gratuita terminó"*.
+- Activación exitosa desbloquea **sin recargar**: el host refresca el `state` y el gate se desmonta.
 
 ## Minimal usage
 

package/dist/action-modal-dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-modal-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-modal-dispatcher.tsx"],"names":[],"mappings":"AAgDA,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAExB,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AA0FhD,wBAAgB,qBAAqB,CAAC,EAClC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,EAAE,gBAAgB,sCAiDlB"}
+{"version":3,"file":"action-modal-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-modal-dispatcher.tsx"],"names":[],"mappings":"AAgDA,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAExB,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AA0FhD,wBAAgB,qBAAqB,CAAC,EAClC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,EAAE,gBAAgB,sCA+DlB"}

package/dist/action-modal-dispatcher.js

@@ -87,6 +87,9 @@ export function ActionModalDispatcher({ open, onOpenChange, action, model, recor
     if (CustomComponent) {
         return (_jsx(CustomComponent, { open: open, onOpenChange: onOpenChange, action: action, model: model, record: record, endpoint: endpoint, onSuccess: onSuccess }));
     }
+    if (action.steps && action.steps.length > 0) {
+        return (_jsx(WizardActionModal, { open: open, onOpenChange: onOpenChange, action: action, model: model, record: record, endpoint: endpoint, onSuccess: onSuccess }));
+    }
     if (action.fields && action.fields.length > 0) {
         return (_jsx(GenericActionModal, { open: open, onOpenChange: onOpenChange, action: action, model: model, record: record, endpoint: endpoint, onSuccess: onSuccess }));
     }
@@ -254,6 +257,125 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
                                 return (_jsxs(FieldCell, { fullWidth: fullWidth, children: [_jsx(FieldLabel, { htmlFor: field.key, required: field.required, children: tl(field.label) }), renderField(field, formData[field.key], (v) => updateField(field.key, v), formData)] }, field.key));
                             }), relations.length > 0 && (_jsx(FieldCell, { fullWidth: true, children: _jsx(DynamicRelations, { record: record, relations: relations }) }))] }) }), _jsxs(DialogFooter, { className: "shrink-0", children: [_jsx(Button, { variant: "outline", onClick: () => onOpenChange(false), disabled: executing, children: t('common.cancel') }), _jsxs(Button, { onClick: execute, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), tl(action.label)] })] })] }) }));
 }
+// buildFieldDefaults seeds formData for a set of action fields, honoring the
+// same line-items prefill spec + boolean/empty rules GenericActionModal uses, so
+// wizard steps and single-page forms initialize identically.
+function buildFieldDefaults(fields, record) {
+    const defaults = {};
+    for (const field of fields) {
+        if (isLineItemsField(field)) {
+            const dv = lineItemsDefault(field);
+            defaults[field.key] = isPrefillSpec(dv)
+                ? buildPrefillRows(dv, record)
+                : Array.isArray(dv)
+                    ? dv
+                    : [];
+            continue;
+        }
+        defaults[field.key] = field.defaultValue ?? (field.type === 'boolean' ? false : '');
+    }
+    return defaults;
+}
+// validateFields returns the first validation error for a set of required
+// fields, or null when they all pass. Shared by the wizard (per-step gate) and
+// mirrors GenericActionModal's inline checks. `tl` localizes the field label.
+function validateFields(fields, formData, tl) {
+    for (const field of fields) {
+        if (!field.required)
+            continue;
+        if (isLineItemsField(field)) {
+            const rows = formData[field.key];
+            if (!Array.isArray(rows) || rows.length === 0) {
+                return `${tl(field.label)} requiere al menos un renglón`;
+            }
+            continue;
+        }
+        if (!formData[field.key] && formData[field.key] !== false) {
+            return `${tl(field.label)} es requerido`;
+        }
+    }
+    return null;
+}
+// WizardActionModal — the third render-path: a multi-step form. It accumulates
+// every step's fields into ONE formData object and, on the final step, POSTs all
+// of them to the same endpoint GenericActionModal uses (buildActionUrl). Each
+// step is validated before "Siguiente" advances; a progress/step bar shows where
+// the user is. Widgets are rendered by the same renderField/resolveWidget path,
+// so line-items, dynamic_select, uploads and dates behave identically to a
+// single-page action form — no widget is duplicated.
+function WizardActionModal({ open, onOpenChange, action, model, record, endpoint, onSuccess }) {
+    const { t } = useTranslation();
+    const tl = (s) => t(s, { defaultValue: s });
+    const api = useApi();
+    const steps = action.steps ?? [];
+    const [stepIndex, setStepIndex] = useState(0);
+    const [formData, setFormData] = useState({});
+    const [executing, setExecuting] = useState(false);
+    // Reset to the first step and seed defaults for EVERY step's fields whenever
+    // the modal (re)opens, so accumulated values from a prior run don't leak.
+    useEffect(() => {
+        if (!open)
+            return;
+        const allFields = steps.flatMap((s) => s.fields ?? []);
+        setFormData(buildFieldDefaults(allFields, record));
+        setStepIndex(0);
+    }, [open, action.steps, record]);
+    const updateField = (key, value) => setFormData((prev) => ({ ...prev, [key]: value }));
+    const step = steps[stepIndex];
+    const isLast = stepIndex === steps.length - 1;
+    const stepFields = step?.fields ?? [];
+    const hasLineItems = useMemo(() => stepFields.some(isLineItemsField), [stepFields]);
+    const widthPx = hasLineItems ? '820px' : undefined;
+    const goNext = () => {
+        const err = validateFields(stepFields, formData, tl);
+        if (err) {
+            toast.error(err);
+            return;
+        }
+        setStepIndex((i) => Math.min(i + 1, steps.length - 1));
+    };
+    const goBack = () => setStepIndex((i) => Math.max(i - 1, 0));
+    const submit = async () => {
+        // Guard every step's required fields on final submit (a user could reach
+        // the last step with an untouched earlier line-items grid otherwise).
+        for (const s of steps) {
+            const err = validateFields(s.fields ?? [], formData, tl);
+            if (err) {
+                toast.error(err);
+                return;
+            }
+        }
+        setExecuting(true);
+        try {
+            const url = buildActionUrl(endpoint, model, record?.id, action.key);
+            const res = await api.post(url, formData);
+            if (res.data.success) {
+                toast.success(res.data.message ? t(res.data.message, { defaultValue: res.data.message }) : t('common.success'));
+                onOpenChange(false);
+                onSuccess();
+            }
+            else {
+                toast.error(res.data.message ? t(res.data.message, { defaultValue: res.data.message }) : t('common.error'));
+            }
+        }
+        catch (err) {
+            toast.error(err?.response?.data?.message || t('common.error'));
+        }
+        finally {
+            setExecuting(false);
+        }
+    };
+    if (steps.length === 0)
+        return null;
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: 'flex max-h-[90vh] flex-col overflow-hidden ' + (widthPx ? '' : 'sm:max-w-xl'), style: { maxHeight: '90vh', ...(widthPx ? { maxWidth: widthPx, width: '95vw' } : {}) }, children: [_jsxs(DialogHeader, { className: "shrink-0", children: [_jsxs(DialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), tl(action.label)] }), _jsxs("div", { className: "pt-2", children: [_jsx("div", { className: "flex items-center gap-1.5", role: "list", "aria-label": "progress", children: steps.map((s, i) => (_jsx("div", { role: "listitem", "aria-current": i === stepIndex ? 'step' : undefined, className: "h-1.5 flex-1 rounded-full", style: {
+                                            backgroundColor: i <= stepIndex ? (action.color || 'hsl(var(--primary))') : 'hsl(var(--muted))',
+                                        } }, i))) }), _jsxs(DialogDescription, { className: "pt-2", children: [t('common.step', { defaultValue: 'Paso' }), " ", stepIndex + 1, "/", steps.length, step?.title ? ` · ${tl(step.title)}` : ''] }), step?.description && (_jsx("p", { className: "pt-1 text-sm text-muted-foreground", children: tl(step.description) }))] })] }), _jsx("div", { className: "-mx-1 min-h-0 flex-1 overflow-y-auto px-1 py-4", children: _jsx(FieldGrid, { children: stepFields.map((field) => {
+                            const fullWidth = isLineItemsField(field) ||
+                                resolveWidget(field) === 'textarea' ||
+                                resolveWidget(field) === 'richtext';
+                            return (_jsxs(FieldCell, { fullWidth: fullWidth, children: [_jsx(FieldLabel, { htmlFor: field.key, required: field.required, children: tl(field.label) }), renderField(field, formData[field.key], (v) => updateField(field.key, v), formData)] }, field.key));
+                        }) }) }), _jsxs(DialogFooter, { className: "shrink-0", children: [stepIndex > 0 ? (_jsx(Button, { variant: "outline", onClick: goBack, disabled: executing, children: t('common.back', { defaultValue: 'Atrás' }) })) : (_jsx(Button, { variant: "outline", onClick: () => onOpenChange(false), disabled: executing, children: t('common.cancel') })), isLast ? (_jsxs(Button, { onClick: submit, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), tl(action.label)] })) : (_jsx(Button, { onClick: goNext, disabled: executing, style: action.color ? { backgroundColor: action.color, color: 'white' } : undefined, children: t('common.next', { defaultValue: 'Siguiente' }) }))] })] }) }));
+}
 function renderField(field, value, onChange, 
 // Full current form values — lets a line-items grid (and any cascading
 // header picker) resolve a `dependsOn` reference against sibling header

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types';
+export { LicenseGate, LicenseExpiryBanner, LicenseStatusBadge, isLicenseOperable, isLicenseBlocking, isPresetEntitled, isTrialExpired, type LicenseGateProps, type LicenseExpiryBannerProps, type LicenseStatusBadgeProps, type LicenseState, type LicenseStatus, type LicenseBranding, } from './license';
 export * from './options-context';
 export * from './dynamic-table';
 export { DynamicKanban, type DynamicKanbanProps, deriveStages, groupByStage, isTransitionAllowed, applyOptimisticMove, selectCardColumns, UNASSIGNED_LANE, } from './dynamic-kanban';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,6 +4,7 @@
 // duplicate-symbol conflict; consumers who want the canonical SDK type
 // should import from `@asteby/metacore-sdk` directly.
 export * from './types';
+export { LicenseGate, LicenseExpiryBanner, LicenseStatusBadge, isLicenseOperable, isLicenseBlocking, isPresetEntitled, isTrialExpired, } from './license';
 export * from './options-context';
 export * from './dynamic-table';
 export { DynamicKanban, deriveStages, groupByStage, isTransitionAllowed, applyOptimisticMove, selectCardColumns, UNASSIGNED_LANE, } from './dynamic-kanban';

package/dist/license/index.d.ts

@@ -0,0 +1,5 @@
+export { LicenseGate, type LicenseGateProps, } from './license-gate';
+export { LicenseExpiryBanner, type LicenseExpiryBannerProps, } from './license-expiry-banner';
+export { LicenseStatusBadge, type LicenseStatusBadgeProps, } from './license-status-badge';
+export { isLicenseOperable, isLicenseBlocking, isPresetEntitled, isTrialExpired, type LicenseState, type LicenseStatus, type LicenseBranding, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/license/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/license/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,WAAW,EACX,KAAK,gBAAgB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACH,mBAAmB,EACnB,KAAK,wBAAwB,GAChC,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACH,kBAAkB,EAClB,KAAK,uBAAuB,GAC/B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,GACvB,MAAM,SAAS,CAAA"}

package/dist/license/index.js

@@ -0,0 +1,4 @@
+export { LicenseGate, } from './license-gate';
+export { LicenseExpiryBanner, } from './license-expiry-banner';
+export { LicenseStatusBadge, } from './license-status-badge';
+export { isLicenseOperable, isLicenseBlocking, isPresetEntitled, isTrialExpired, } from './types';

package/dist/license/license-expiry-banner.d.ts

@@ -0,0 +1,16 @@
+import type { LicenseState } from './types';
+export interface LicenseExpiryBannerProps {
+    state: LicenseState | undefined;
+    /** Días de anticipación para el aviso de renovación. Default 15. */
+    upcomingThresholdDays?: number;
+    /** Clave localStorage para recordar el descarte. */
+    dismissStorageKey?: string;
+    /** Acción "Gestionar licencia" — el host enruta a sus Ajustes. Si se omite,
+     * no se muestra el botón (el gate no asume rutas del host). */
+    onManage?: () => void;
+    /** Etiqueta del botón de gestión (default localizado). */
+    manageLabel?: string;
+    className?: string;
+}
+export declare function LicenseExpiryBanner({ state, upcomingThresholdDays, dismissStorageKey, onManage, manageLabel, className, }: LicenseExpiryBannerProps): import("react").JSX.Element | null;
+//# sourceMappingURL=license-expiry-banner.d.ts.map

package/dist/license/license-expiry-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-expiry-banner.d.ts","sourceRoot":"","sources":["../../src/license/license-expiry-banner.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAU3C,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAA;IAC/B,oEAAoE;IACpE,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;mEAC+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,mBAAmB,CAAC,EAChC,KAAK,EACL,qBAA+C,EAC/C,iBAA+B,EAC/B,QAAQ,EACR,WAAW,EACX,SAAS,GACZ,EAAE,wBAAwB,sCAqG1B"}

package/dist/license/license-expiry-banner.js

@@ -0,0 +1,85 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Banner de vencimiento de licencia — la señal degradada que acompaña a las
+ * posturas que NO bloquean la app pero exigen atención:
+ *   - valid && days_remaining <= threshold  → aviso de renovación próxima
+ *   - stale                                  → check-in con el hub pendiente
+ *   - grace                                  → vencida, dentro de la gracia
+ *   - expired                                → vencida en duro (persistente)
+ *
+ * Silencioso sin enforcement o si el estado aún no cargó — nunca rompe el shell.
+ *
+ * Descartabilidad: todas las posturas son descartables con TTL en localStorage
+ * (re-aparecen pasado el TTL) MENOS `expired`, que se queda fijo como recordatorio
+ * porque el backend ya bloquea escrituras nuevas.
+ */
+import { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { AlertTriangle, Clock, CloudOff, X } from 'lucide-react';
+import { Button } from '@asteby/metacore-ui';
+const DISMISS_KEY = 'license_banner_dismissed_at';
+const DISMISS_TTL_MS = 12 * 60 * 60 * 1000; // re-mostrar cada 12h aunque se descarte
+const UPCOMING_THRESHOLD_DAYS = 15;
+function cx(...parts) {
+    return parts.filter(Boolean).join(' ');
+}
+export function LicenseExpiryBanner({ state, upcomingThresholdDays = UPCOMING_THRESHOLD_DAYS, dismissStorageKey = DISMISS_KEY, onManage, manageLabel, className, }) {
+    const { t } = useTranslation();
+    const [dismissed, setDismissed] = useState(() => {
+        if (typeof window === 'undefined')
+            return false;
+        const raw = window.localStorage.getItem(dismissStorageKey);
+        if (!raw)
+            return false;
+        return Date.now() - Number(raw) < DISMISS_TTL_MS;
+    });
+    if (!state || !state.enforced)
+        return null;
+    const isUpcoming = state.status === 'valid' && state.days_remaining <= upcomingThresholdDays;
+    const isStale = state.status === 'stale';
+    const isGrace = state.status === 'grace';
+    const isExpired = state.status === 'expired';
+    if (!isUpcoming && !isStale && !isGrace && !isExpired)
+        return null;
+    // Expired no es descartable — se queda como recordatorio constante.
+    if (dismissed && !isExpired)
+        return null;
+    const dismiss = () => {
+        setDismissed(true);
+        try {
+            window.localStorage.setItem(dismissStorageKey, String(Date.now()));
+        }
+        catch {
+            // cuota/entorno sin storage — el descarte solo dura la sesión.
+        }
+    };
+    const message = isExpired
+        ? t('license.banner.expired', {
+            defaultValue: 'Tu licencia venció. Algunas acciones pueden estar bloqueadas.',
+        })
+        : isStale
+            ? t('license.banner.stale', {
+                defaultValue: 'Esta instancia no ha podido verificar su licencia con el hub. Reconéctala para completar el check-in.',
+            })
+            : isGrace
+                ? t('license.banner.grace', {
+                    defaultValue: 'Tu licencia venció y está en periodo de gracia hasta {{date}} ({{days}} días restantes).',
+                    date: state.grace_until
+                        ? new Date(state.grace_until).toLocaleDateString()
+                        : '—',
+                    days: state.days_remaining,
+                })
+                : t('license.banner.upcoming', {
+                    defaultValue: 'Tu licencia vence en {{days}} días.',
+                    days: state.days_remaining,
+                });
+    const Icon = isExpired ? AlertTriangle : isStale ? CloudOff : Clock;
+    return (_jsxs("div", { role: "alert", "data-license-status": state.status, className: cx('flex items-center justify-between gap-3 border-b px-4 py-2.5 text-sm', isExpired
+            ? 'border-destructive/30 bg-destructive text-white'
+            : 'border-amber-500/30 bg-amber-500/10 text-foreground', className), children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx(Icon, { className: "h-4 w-4 shrink-0", "aria-hidden": true }), _jsx("span", { className: "truncate", children: message })] }), _jsxs("div", { className: "flex shrink-0 items-center gap-2", children: [onManage && (_jsx(Button, { size: "sm", variant: isExpired ? 'secondary' : 'outline', onClick: onManage, children: manageLabel ??
+                            t('license.banner.manage', {
+                                defaultValue: 'Gestionar licencia',
+                            }) })), !isExpired && (_jsx(Button, { size: "icon", variant: "ghost", className: "h-7 w-7", onClick: dismiss, title: t('license.banner.dismiss', {
+                            defaultValue: 'Descartar',
+                        }), children: _jsx(X, { className: "h-4 w-4" }) }))] })] }));
+}

package/dist/license/license-gate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * <LicenseGate> — el primitivo del blindaje. Un host lo monta en UNA línea
+ * envolviendo su app autenticada:
+ *
+ *   <LicenseGate state={state} onActivate={activate}>
+ *     <AppShell />
+ *   </LicenseGate>
+ *
+ * Comportamiento según el estado (resuelto por el backend del host):
+ *   - Sin enforcement, o estado operable (valid/stale/grace) → renderiza children.
+ *     stale/grace además montan el <LicenseExpiryBanner> degradado por encima.
+ *   - enforcement && missing/invalid/expired → modal BLOQUEANTE full-screen,
+ *     no descartable, con el formulario de activación. Al activar con éxito el
+ *     host refresca el estado y el gate se abre sin recargar.
+ *
+ * Es branding-aware si el host pasa `branding` (logo/nombre desde el
+ * PlatformConfig del SDK); si no, cae a un encabezado neutro.
+ *
+ * INDEPENDIENTE del kernel: no importa su cliente ni fija su versión. Solo
+ * consume `LicenseState` y una promesa `onActivate`.
+ */
+import { type ReactNode } from 'react';
+import { type LicenseState, type LicenseBranding } from './types';
+export interface LicenseGateProps {
+    /** Estado actual, resuelto por el backend del host. `undefined` mientras
+     * carga → fail-open (renderiza children, nunca destella el candado). */
+    state: LicenseState | undefined;
+    /** Activa una licencia con el código/token pegado. Resuelve → el host
+     * refresca `state` y el gate se abre. Rechaza con un Error cuyo `message`
+     * se muestra al usuario. */
+    onActivate: (code: string) => Promise<void>;
+    children: ReactNode;
+    /** Branding opcional (logo/nombre) para el encabezado del modal. */
+    branding?: LicenseBranding;
+    /** Acción "Gestionar licencia" del banner degradado (opcional). */
+    onManage?: () => void;
+    className?: string;
+}
+export declare function LicenseGate({ state, onActivate, children, branding, onManage, className, }: LicenseGateProps): import("react").JSX.Element;
+//# sourceMappingURL=license-gate.d.ts.map

package/dist/license/license-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-gate.d.ts","sourceRoot":"","sources":["../../src/license/license-gate.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIhD,OAAO,EAGH,KAAK,YAAY,EACjB,KAAK,eAAe,EACvB,MAAM,SAAS,CAAA;AAQhB,MAAM,WAAW,gBAAgB;IAC7B;4EACwE;IACxE,KAAK,EAAE,YAAY,GAAG,SAAS,CAAA;IAC/B;;gCAE4B;IAC5B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,QAAQ,EAAE,SAAS,CAAA;IACnB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,GACZ,EAAE,gBAAgB,+BAqBlB"}

package/dist/license/license-gate.js

@@ -0,0 +1,108 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * <LicenseGate> — el primitivo del blindaje. Un host lo monta en UNA línea
+ * envolviendo su app autenticada:
+ *
+ *   <LicenseGate state={state} onActivate={activate}>
+ *     <AppShell />
+ *   </LicenseGate>
+ *
+ * Comportamiento según el estado (resuelto por el backend del host):
+ *   - Sin enforcement, o estado operable (valid/stale/grace) → renderiza children.
+ *     stale/grace además montan el <LicenseExpiryBanner> degradado por encima.
+ *   - enforcement && missing/invalid/expired → modal BLOQUEANTE full-screen,
+ *     no descartable, con el formulario de activación. Al activar con éxito el
+ *     host refresca el estado y el gate se abre sin recargar.
+ *
+ * Es branding-aware si el host pasa `branding` (logo/nombre desde el
+ * PlatformConfig del SDK); si no, cae a un encabezado neutro.
+ *
+ * INDEPENDIENTE del kernel: no importa su cliente ni fija su versión. Solo
+ * consume `LicenseState` y una promesa `onActivate`.
+ */
+import { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { ShieldAlert, Clock, Loader2 } from 'lucide-react';
+import { Button, Input } from '@asteby/metacore-ui';
+import { isLicenseBlocking, isTrialExpired, } from './types';
+import { LicenseStatusBadge } from './license-status-badge';
+import { LicenseExpiryBanner } from './license-expiry-banner';
+function cx(...parts) {
+    return parts.filter(Boolean).join(' ');
+}
+export function LicenseGate({ state, onActivate, children, branding, onManage, className, }) {
+    const blocking = isLicenseBlocking(state);
+    return (_jsxs(_Fragment, { children: [!blocking && (_jsx(LicenseExpiryBanner, { state: state, onManage: onManage })), children, blocking && state && (_jsx(LicenseGateModal, { state: state, onActivate: onActivate, branding: branding, className: className }))] }));
+}
+function LicenseGateModal({ state, onActivate, branding, className, }) {
+    const { t } = useTranslation();
+    const [code, setCode] = useState('');
+    const [submitting, setSubmitting] = useState(false);
+    const [error, setError] = useState(null);
+    const trialExpired = isTrialExpired(state);
+    const title = trialExpired
+        ? t('license.gate.trial_title', {
+            defaultValue: 'Tu prueba gratuita terminó',
+        })
+        : t('license.gate.title', { defaultValue: 'Activa tu licencia' });
+    const description = trialExpired
+        ? t('license.gate.trial_description', {
+            defaultValue: 'Tu prueba gratuita terminó. Activa una licencia para continuar. Pega tu clave (lic_…) o el token firmado que te entregaron.',
+        })
+        : state.status === 'expired'
+            ? t('license.gate.expired_description', {
+                defaultValue: 'Tu licencia venció y el periodo de gracia terminó. Activa una licencia vigente para seguir operando. Pega tu clave (lic_…) o el token firmado.',
+            })
+            : state.status === 'invalid'
+                ? t('license.gate.invalid_description', {
+                    defaultValue: 'La licencia de esta instancia no es válida. Pega una clave (lic_…) o el token firmado que te entregó tu proveedor para reactivarla.',
+                })
+                : t('license.gate.missing_description', {
+                    defaultValue: 'Esta instancia necesita una licencia activa para operar. Pega tu clave (lic_…) o el token firmado para activarla.',
+                });
+    const canSubmit = code.trim().length > 0 && !submitting;
+    const submit = async () => {
+        if (!canSubmit)
+            return;
+        setSubmitting(true);
+        setError(null);
+        try {
+            await onActivate(code.trim());
+            // Éxito → el host refresca `state`; el gate se re-renderiza y este
+            // modal se desmonta solo. No recargamos.
+        }
+        catch (e) {
+            const message = e instanceof Error && e.message
+                ? e.message
+                : t('license.gate.activate_error', {
+                    defaultValue: 'No se pudo activar la licencia.',
+                });
+            setError(message);
+            setSubmitting(false);
+        }
+    };
+    return (_jsx("div", { role: "dialog", "aria-modal": "true", "aria-labelledby": "license-gate-title", "data-license-status": state.status, className: cx('fixed inset-0 z-[100] flex items-center justify-center bg-background/90 p-4 backdrop-blur-sm', className), children: _jsx("div", { className: "w-full max-w-lg overflow-hidden rounded-2xl border bg-card text-card-foreground shadow-2xl", children: _jsxs("div", { className: "flex flex-col gap-4 p-6", children: [_jsxs("div", { className: "flex items-start gap-3", children: [branding?.logo ? (_jsx("img", { src: branding.logo, alt: branding.name ?? '', className: "h-10 w-10 shrink-0 rounded-xl object-contain" })) : (_jsx("div", { className: cx('flex h-10 w-10 shrink-0 items-center justify-center rounded-xl', trialExpired
+                                    ? 'bg-primary/10 text-primary'
+                                    : 'bg-destructive/10 text-destructive'), children: trialExpired ? (_jsx(Clock, { className: "h-5 w-5", "aria-hidden": true })) : (_jsx(ShieldAlert, { className: "h-5 w-5", "aria-hidden": true })) })), _jsxs("div", { className: "flex min-w-0 flex-col gap-1", children: [_jsx("h2", { id: "license-gate-title", className: "text-lg leading-tight font-semibold", children: title }), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(LicenseStatusBadge, { status: state.status }), _jsx("span", { className: "text-muted-foreground text-xs", children: branding?.name
+                                                    ? branding.name
+                                                    : t('license.gate.instance', {
+                                                        defaultValue: 'Esta instancia',
+                                                    }) })] })] })] }), _jsx("p", { className: "text-muted-foreground text-sm", children: description }), state.reason && (_jsx("p", { className: "bg-muted/50 text-muted-foreground rounded-md px-3 py-2 text-xs", children: state.reason })), _jsxs("form", { className: "flex flex-col gap-2", onSubmit: (e) => {
+                            e.preventDefault();
+                            void submit();
+                        }, children: [_jsx("label", { htmlFor: "license-gate-code", className: "text-sm font-medium", children: t('license.gate.code_label', {
+                                    defaultValue: 'Clave o token de licencia',
+                                }) }), _jsx(Input, { id: "license-gate-code", autoFocus: true, autoComplete: "off", spellCheck: false, placeholder: t('license.gate.code_placeholder', {
+                                    defaultValue: 'lic_… o pega el token firmado',
+                                }), value: code, disabled: submitting, "aria-invalid": error ? true : undefined, onChange: (e) => {
+                                    setCode(e.target.value);
+                                    if (error)
+                                        setError(null);
+                                } }), error && (_jsx("p", { role: "alert", className: "text-destructive text-sm", children: error })), _jsxs(Button, { type: "submit", className: "mt-1 w-full", disabled: !canSubmit, children: [submitting && (_jsx(Loader2, { className: "h-4 w-4 animate-spin", "aria-hidden": true })), submitting
+                                        ? t('license.gate.activating', {
+                                            defaultValue: 'Activando…',
+                                        })
+                                        : t('license.gate.activate', {
+                                            defaultValue: 'Activar licencia',
+                                        })] })] })] }) }) }));
+}

package/dist/license/license-status-badge.d.ts

@@ -0,0 +1,7 @@
+import type { LicenseStatus } from './types';
+export interface LicenseStatusBadgeProps {
+    status: LicenseStatus;
+    className?: string;
+}
+export declare function LicenseStatusBadge({ status, className }: LicenseStatusBadgeProps): import("react").JSX.Element;
+//# sourceMappingURL=license-status-badge.d.ts.map

package/dist/license/license-status-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-status-badge.d.ts","sourceRoot":"","sources":["../../src/license/license-status-badge.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAuD5C,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,uBAAuB,+BAkBhF"}

package/dist/license/license-status-badge.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Insignia de estado de licencia — un chip que traduce el `LicenseStatus` a
+ * color + etiqueta legible. Reutilizable suelto (p. ej. en Ajustes de licencia)
+ * o embebido en el encabezado del <LicenseGate>.
+ */
+import { useTranslation } from 'react-i18next';
+import { ShieldCheck, ShieldAlert, ShieldQuestion, Clock, CloudOff, } from 'lucide-react';
+import { Badge } from '@asteby/metacore-ui';
+const STATUS_META = {
+    valid: {
+        variant: 'default',
+        Icon: ShieldCheck,
+        key: 'license.status.valid',
+        defaultValue: 'Activa',
+    },
+    stale: {
+        variant: 'outline',
+        Icon: CloudOff,
+        key: 'license.status.stale',
+        defaultValue: 'Sin verificar',
+        warn: true,
+    },
+    grace: {
+        variant: 'outline',
+        Icon: Clock,
+        key: 'license.status.grace',
+        defaultValue: 'En gracia',
+        warn: true,
+    },
+    expired: {
+        variant: 'destructive',
+        Icon: ShieldAlert,
+        key: 'license.status.expired',
+        defaultValue: 'Vencida',
+    },
+    missing: {
+        variant: 'secondary',
+        Icon: ShieldQuestion,
+        key: 'license.status.missing',
+        defaultValue: 'Sin licencia',
+    },
+    invalid: {
+        variant: 'destructive',
+        Icon: ShieldAlert,
+        key: 'license.status.invalid',
+        defaultValue: 'Inválida',
+    },
+};
+export function LicenseStatusBadge({ status, className }) {
+    const { t } = useTranslation();
+    const meta = STATUS_META[status] ?? STATUS_META.missing;
+    const { Icon } = meta;
+    return (_jsxs(Badge, { variant: meta.variant, className: (meta.warn
+            ? 'border-amber-500/40 bg-amber-500/10 text-amber-700 dark:text-amber-400 '
+            : '') + (className ?? ''), children: [_jsx(Icon, { "aria-hidden": true }), t(meta.key, { defaultValue: meta.defaultValue })] }));
+}