@asteby/metacore-runtime-react 23.10.0 → 23.11.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @asteby/metacore-runtime-react
 
+## 23.11.0
+
+### Minor Changes
+
+- 023dc28: feat(license-gate): gateo por rol del formulario de activación.
+
+  `<LicenseGate>` acepta dos props nuevas (backward-compatible):
+  - `canActivate?: boolean` (default `true`): cuando es `false`, el modal bloqueante se muestra SIN el formulario de activación.
+  - `readOnlyMessage?: string`: mensaje mostrado en ese caso (default: "Contacta al administrador de la plataforma para activar la licencia.").
+
+  Aplica a todas las variantes del modal (missing/invalid/expired, incluido el copy de trial vencido). Permite que solo el Platform Root/superadmin active la licencia mientras el resto de usuarios ve el bloqueo con la indicación de a quién contactar.
+
 ## 23.10.0
 
 ### Minor Changes

package/README.md

@@ -73,6 +73,7 @@ export function Shell({ children }) {
 - 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.
+- **Gateo por rol** con `canActivate` (default `true`): cuando es `false`, el modal bloqueante se muestra **sin formulario** de activación y en su lugar aparece `readOnlyMessage` (default: *"Contacta al administrador de la plataforma para activar la licencia."*). Así solo el Platform Root/superadmin activa; los demás usuarios ven el bloqueo con la indicación de a quién contactar.
 
 ## Minimal usage
 

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

@@ -34,7 +34,14 @@ export interface LicenseGateProps {
     branding?: LicenseBranding;
     /** Acción "Gestionar licencia" del banner degradado (opcional). */
     onManage?: () => void;
+    /** Si el usuario actual puede activar la licencia (p. ej. Platform Root /
+     * superadmin). Default true — backward-compatible. Cuando es false, el modal
+     * bloqueante se muestra SIN el formulario de activación y en su lugar
+     * aparece `readOnlyMessage`. */
+    canActivate?: boolean;
+    /** Mensaje mostrado en el modal bloqueante cuando `canActivate` es false. */
+    readOnlyMessage?: string;
     className?: string;
 }
-export declare function LicenseGate({ state, onActivate, children, branding, onManage, className, }: LicenseGateProps): import("react").JSX.Element;
+export declare function LicenseGate({ state, onActivate, children, branding, onManage, canActivate, readOnlyMessage, className, }: LicenseGateProps): import("react").JSX.Element;
 //# sourceMappingURL=license-gate.d.ts.map

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

@@ -1 +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"}
+{"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;;;oCAGgC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAkB,EAClB,eAAe,EACf,SAAS,GACZ,EAAE,gBAAgB,+BAuBlB"}

package/dist/license/license-gate.js

@@ -30,11 +30,11 @@ import { LicenseExpiryBanner } from './license-expiry-banner';
 function cx(...parts) {
     return parts.filter(Boolean).join(' ');
 }
-export function LicenseGate({ state, onActivate, children, branding, onManage, className, }) {
+export function LicenseGate({ state, onActivate, children, branding, onManage, canActivate = true, readOnlyMessage, 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 }))] }));
+    return (_jsxs(_Fragment, { children: [!blocking && (_jsx(LicenseExpiryBanner, { state: state, onManage: onManage })), children, blocking && state && (_jsx(LicenseGateModal, { state: state, onActivate: onActivate, branding: branding, canActivate: canActivate, readOnlyMessage: readOnlyMessage, className: className }))] }));
 }
-function LicenseGateModal({ state, onActivate, branding, className, }) {
+function LicenseGateModal({ state, onActivate, branding, canActivate, readOnlyMessage, className, }) {
     const { t } = useTranslation();
     const [code, setCode] = useState('');
     const [submitting, setSubmitting] = useState(false);
@@ -87,7 +87,10 @@ function LicenseGateModal({ state, onActivate, branding, className, }) {
                                                     ? 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) => {
+                                                    }) })] })] })] }), _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 })), !canActivate ? (_jsx("p", { role: "note", className: "border-border bg-muted/40 text-muted-foreground rounded-md border px-3 py-3 text-sm", children: readOnlyMessage ??
+                            t('license.gate.read_only', {
+                                defaultValue: 'Contacta al administrador de la plataforma para activar la licencia.',
+                            }) })) : (_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', {
@@ -104,5 +107,5 @@ function LicenseGateModal({ state, onActivate, branding, className, }) {
                                         })
                                         : t('license.gate.activate', {
                                             defaultValue: 'Activar licencia',
-                                        })] })] })] }) }) }));
+                                        })] })] }))] }) }) }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "23.10.0",
+  "version": "23.11.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",

package/src/__tests__/license-gate.test.tsx

@@ -168,6 +168,46 @@ describe('LicenseGate', () => {
         expect(btn.disabled).toBe(true)
     })
 
+    it('sin canActivate oculta el form y muestra el mensaje read-only por defecto', () => {
+        render(
+            <LicenseGate state={make({ status: 'missing' })} onActivate={noop} canActivate={false}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        expect(screen.getByRole('dialog')).toBeTruthy()
+        expect(screen.queryByLabelText('Clave o token de licencia')).toBeNull()
+        expect(screen.queryByText('Activar licencia')).toBeNull()
+        expect(
+            screen.getByText('Contacta al administrador de la plataforma para activar la licencia.'),
+        ).toBeTruthy()
+    })
+
+    it('sin canActivate respeta el readOnlyMessage custom, incl. trial vencido', () => {
+        render(
+            <LicenseGate
+                state={make({ status: 'expired', plan: 'trial' })}
+                onActivate={noop}
+                canActivate={false}
+                readOnlyMessage="Pídele a Ana que active la licencia."
+            >
+                {CHILD}
+            </LicenseGate>,
+        )
+        expect(screen.getByText('Tu prueba gratuita terminó')).toBeTruthy()
+        expect(screen.queryByLabelText('Clave o token de licencia')).toBeNull()
+        expect(screen.getByText('Pídele a Ana que active la licencia.')).toBeTruthy()
+    })
+
+    it('canActivate true (default) mantiene el form de activación', () => {
+        render(
+            <LicenseGate state={make({ status: 'invalid' })} onActivate={noop}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        expect(screen.getByLabelText('Clave o token de licencia')).toBeTruthy()
+        expect(screen.getByText('Activar licencia')).toBeTruthy()
+    })
+
     it('grace degrada con banner en vez de bloquear', () => {
         render(
             <LicenseGate

package/src/license/license-gate.tsx

@@ -49,6 +49,13 @@ export interface LicenseGateProps {
     branding?: LicenseBranding
     /** Acción "Gestionar licencia" del banner degradado (opcional). */
     onManage?: () => void
+    /** Si el usuario actual puede activar la licencia (p. ej. Platform Root /
+     * superadmin). Default true — backward-compatible. Cuando es false, el modal
+     * bloqueante se muestra SIN el formulario de activación y en su lugar
+     * aparece `readOnlyMessage`. */
+    canActivate?: boolean
+    /** Mensaje mostrado en el modal bloqueante cuando `canActivate` es false. */
+    readOnlyMessage?: string
     className?: string
 }
 
@@ -58,6 +65,8 @@ export function LicenseGate({
     children,
     branding,
     onManage,
+    canActivate = true,
+    readOnlyMessage,
     className,
 }: LicenseGateProps) {
     const blocking = isLicenseBlocking(state)
@@ -75,6 +84,8 @@ export function LicenseGate({
                     state={state}
                     onActivate={onActivate}
                     branding={branding}
+                    canActivate={canActivate}
+                    readOnlyMessage={readOnlyMessage}
                     className={className}
                 />
             )}
@@ -86,6 +97,8 @@ interface LicenseGateModalProps {
     state: LicenseState
     onActivate: (code: string) => Promise<void>
     branding?: LicenseBranding
+    canActivate: boolean
+    readOnlyMessage?: string
     className?: string
 }
 
@@ -93,6 +106,8 @@ function LicenseGateModal({
     state,
     onActivate,
     branding,
+    canActivate,
+    readOnlyMessage,
     className,
 }: LicenseGateModalProps) {
     const { t } = useTranslation()
@@ -214,6 +229,18 @@ function LicenseGateModal({
                         </p>
                     )}
 
+                    {!canActivate ? (
+                        <p
+                            role="note"
+                            className="border-border bg-muted/40 text-muted-foreground rounded-md border px-3 py-3 text-sm"
+                        >
+                            {readOnlyMessage ??
+                                t('license.gate.read_only', {
+                                    defaultValue:
+                                        'Contacta al administrador de la plataforma para activar la licencia.',
+                                })}
+                        </p>
+                    ) : (
                     <form
                         className="flex flex-col gap-2"
                         onSubmit={(e) => {
@@ -270,6 +297,7 @@ function LicenseGateModal({
                                   })}
                         </Button>
                     </form>
+                    )}
                 </div>
             </div>
         </div>