@asteby/metacore-runtime-react 44.0.0 → 45.2.0

package/dist/types.d.ts

@@ -597,6 +597,15 @@ export interface FieldOptionsConfig {
     /** Optional column projected into `option.image`. */
     image?: string;
 }
+/** An optional addon an action needs before it can run. */
+export interface RequiresAddon {
+    /** Addon key, e.g. "connector_whatsapp". */
+    key: string;
+    /** Localized display name, e.g. "Conector WhatsApp". Falls back to `key`. */
+    name?: string;
+    /** Why the action needs it (literal or i18n key). */
+    reason?: string;
+}
 export interface ActionDefinition {
     key: string;
     name: string;
@@ -623,6 +632,13 @@ export interface ActionDefinition {
      *   "create"        — toolbar button that replaces the generic create button.
      */
     placement?: 'row' | 'table' | 'create';
+    /**
+     * Optional addon this action depends on, stamped by the host only while it
+     * is NOT installed (served as `requires_addon`; read through
+     * resolveRequiresAddon). The action stays visible but locked: a click opens
+     * the "requires addon" dialog instead of executing.
+     */
+    requiresAddon?: RequiresAddon;
 }
 export interface ApiResponse<T> {
     success: boolean;
@@ -660,5 +676,12 @@ export interface ActionMetadata {
     /** Federated modal slug "<addon_key>.<action_key>"; see ActionModalDispatcher. */
     modal?: string;
     placement?: 'row' | 'table' | 'create';
+    /**
+     * Optional addon this action depends on, stamped by the host only while it
+     * is NOT installed (served as `requires_addon`; read through
+     * resolveRequiresAddon). The action stays visible but locked: a click opens
+     * the "requires addon" dialog instead of executing.
+     */
+    requiresAddon?: RequiresAddon;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "44.0.0",
+  "version": "45.2.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
     "zod": "^4.3.0"
   },
   "peerDependencies": {
-    "@asteby/metacore-sdk": "^3.10.0",
+    "@asteby/metacore-sdk": "^3.11.0",
     "@asteby/metacore-ui": "^2.23.0",
     "@tanstack/react-query": ">=5",
     "@tanstack/react-router": ">=1.100",
@@ -50,7 +50,7 @@
     }
   },
   "devDependencies": {
-    "@asteby/metacore-sdk": "3.10.0",
+    "@asteby/metacore-sdk": "3.11.0",
     "@asteby/metacore-ui": "2.23.0",
     "@tanstack/react-query": "^5.95.0",
     "@tanstack/react-router": "^1.168.0",

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

@@ -0,0 +1,134 @@
+// @vitest-environment happy-dom
+//
+// ApprovalGate: inline PIN grants + parked-request approval, and the capability
+// bypass that lets a supervisor skip their own prompt.
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'
+
+vi.mock('react-i18next', () => ({
+    useTranslation: () => ({
+        t: (_k: string, opts?: { defaultValue?: string }) => opts?.defaultValue ?? _k,
+    }),
+}))
+vi.mock('sonner', () => ({ toast: Object.assign(vi.fn(), { info: vi.fn(), success: vi.fn(), error: vi.fn() }) }))
+
+import { ApiProvider, type ApiClient } from '../api-context'
+import { PermissionsProvider } from '../permissions-context'
+import {
+    ApprovalGateProvider,
+    useApprovalGate,
+    approvalRequiredInfo,
+    APPROVAL_PARKED_EVENT,
+    type ApprovalGrant,
+} from '../approval-gate'
+import { toastServerError } from '../server-error'
+import { toast } from 'sonner'
+
+afterEach(() => {
+    cleanup()
+    vi.clearAllMocks()
+})
+
+function makeApi(post: ApiClient['post']): ApiClient {
+    return { get: vi.fn(), post, put: vi.fn(), delete: vi.fn() } as unknown as ApiClient
+}
+
+let lastGrant: ApprovalGrant | null | undefined
+function Probe({ policy }: { policy: string }) {
+    const gate = useApprovalGate()
+    return (
+        <button
+            onClick={async () => {
+                lastGrant = await gate.requestApproval({ policy, label: 'Venta sin existencias', context: { qty: 3 } })
+            }}
+        >
+            ask
+        </button>
+    )
+}
+
+function mount(post: ApiClient['post'], caps: string[] = [], isAdmin = false) {
+    lastGrant = undefined
+    return render(
+        <ApiProvider client={makeApi(post)}>
+            <PermissionsProvider permissions={caps} isAdmin={isAdmin}>
+                <ApprovalGateProvider>
+                    <Probe policy="oversell" />
+                </ApprovalGateProvider>
+            </PermissionsProvider>
+        </ApiProvider>,
+    )
+}
+
+function fill(reason: string, pin: string) {
+    fireEvent.change(screen.getByLabelText('Motivo'), { target: { value: reason } })
+    fireEvent.change(screen.getByLabelText('PIN del supervisor'), { target: { value: pin } })
+}
+
+describe('ApprovalGate', () => {
+    it('a holder of general.approve_<policy> passes without a prompt', async () => {
+        const post = vi.fn()
+        mount(post, ['general.approve_oversell'])
+        await act(async () => fireEvent.click(screen.getByText('ask')))
+        expect(lastGrant).toEqual({ id: null, policy: 'oversell', bypassed: true })
+        expect(post).not.toHaveBeenCalled()
+        expect(screen.queryByLabelText('PIN del supervisor')).toBeNull()
+    })
+
+    it('posts pin-grant with reason + context and resolves the audit id', async () => {
+        const post = vi.fn().mockResolvedValue({ data: { success: true, data: { id: 'audit-1' } } })
+        mount(post)
+        await act(async () => fireEvent.click(screen.getByText('ask')))
+        const submit = screen.getByText('Autorizar').closest('button')!
+        expect(submit.hasAttribute('disabled')).toBe(true) // reason + PIN required
+        fill('cliente esperando', '4321')
+        await act(async () => fireEvent.click(submit))
+        await waitFor(() => expect(lastGrant).toBeDefined())
+        expect(post).toHaveBeenCalledWith(
+            '/approvals/pin-grant',
+            expect.objectContaining({ policy: 'oversell', pin: '4321', reason: 'cliente esperando', context: { qty: 3 } }),
+        )
+        expect(lastGrant).toMatchObject({ id: 'audit-1', bypassed: false })
+    })
+
+    it('a wrong PIN keeps the dialog open with an inline message and nothing resolves', async () => {
+        const post = vi.fn().mockRejectedValue({ response: { data: { error: { code: 'approval_pin_invalid' } } } })
+        mount(post)
+        await act(async () => fireEvent.click(screen.getByText('ask')))
+        fill('r', '0000')
+        await act(async () => fireEvent.click(screen.getByText('Autorizar').closest('button')!))
+        expect(await screen.findByRole('alert')).toBeTruthy()
+        expect(lastGrant).toBeUndefined()
+    })
+
+    it('cancelling resolves null (fail closed)', async () => {
+        mount(vi.fn())
+        await act(async () => fireEvent.click(screen.getByText('ask')))
+        await act(async () => fireEvent.click(screen.getByText('Cancelar')))
+        await waitFor(() => expect(lastGrant).toBeNull())
+    })
+
+    it('a parked approval_required toast offers the PIN and approves through approve-pin', async () => {
+        const post = vi.fn().mockResolvedValue({ data: { success: true } })
+        mount(post)
+        const err = {
+            response: {
+                data: { success: false, error: { code: 'approval_required' }, meta: { approval_request_id: 'req-9', approval_label: 'Precio bajo el piso', approval_roles: ['gerente'] } },
+            },
+        }
+        expect(approvalRequiredInfo(err)).toMatchObject({ requestId: 'req-9', roles: ['gerente'] })
+        toastServerError(err)
+        const opts = (toast.info as unknown as ReturnType<typeof vi.fn>).mock.calls[0][1]
+        expect(toast.error).not.toHaveBeenCalled()
+        await act(async () => opts.action.onClick())
+        fill('autorizado', '1234')
+        await act(async () => fireEvent.click(screen.getByText('Autorizar').closest('button')!))
+        await waitFor(() => expect(post).toHaveBeenCalledWith('/approvals/req-9/approve-pin', { pin: '1234', reason: 'autorizado' }))
+    })
+
+    it('without a gate mounted the parked toast has no PIN action and the event is inert', () => {
+        toastServerError({ response: { data: { error: { code: 'approval_required' }, meta: { approval_request_id: 'x' } } } })
+        expect((toast.info as unknown as ReturnType<typeof vi.fn>).mock.calls[0][1].action).toBeUndefined()
+        window.dispatchEvent(new CustomEvent(APPROVAL_PARKED_EVENT, { detail: { requestId: 'x', roles: [] } }))
+    })
+})

package/src/__tests__/requires-addon.test.tsx

@@ -0,0 +1,201 @@
+// @vitest-environment happy-dom
+//
+// requiresAddon: an action gated by a missing optional addon stays visible but
+// locked. A click must NOT reach the dispatcher / federated modal / backend; it
+// opens the "requires addon" dialog whose "Instalar" hands the key to the host
+// handler, or routes to /marketplace/<key> through the SDK router.
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, fireEvent, render, renderHook, screen } from '@testing-library/react'
+
+const I18N_T = (_k: string, opts?: { defaultValue?: string; [k: string]: unknown }) =>
+    (opts?.defaultValue ?? _k).replace(/\{\{(\w+)\}\}/g, (_: string, v: string) => String(opts?.[v] ?? ''))
+const USE_TRANSLATION = { t: I18N_T, i18n: { language: 'es' } }
+vi.mock('react-i18next', () => ({
+    useTranslation: () => USE_TRANSLATION,
+}))
+
+const navigate = vi.fn()
+vi.mock('@tanstack/react-router', () => ({
+    useNavigate: () => navigate,
+}))
+
+// The dispatcher must never mount for a gated action.
+const dispatcherSpy = vi.fn()
+vi.mock('../action-modal-dispatcher', () => ({
+    ActionModalDispatcher: (props: unknown) => {
+        dispatcherSpy(props)
+        return <div data-testid="dispatcher" />
+    },
+}))
+
+import { useDynamicRowActions } from '../dynamic-row-actions'
+import { ModelActionToolbar } from '../model-action-toolbar'
+import { RowActionMenuItem } from '../dynamic-columns'
+import { ApiProvider } from '../api-context'
+import { resolveRequiresAddon, setAddonInstallHandler } from '../requires-addon'
+import type { ActionDefinition, TableMetadata } from '../types'
+import { DropdownMenu, DropdownMenuContent } from '@asteby/metacore-ui/primitives'
+
+const post = vi.fn(async () => ({ data: { success: true } }))
+const api = {
+    get: async () => ({ data: { data: {} } }),
+    post,
+    put: async () => ({ data: { success: true } }),
+    delete: async () => ({ data: { success: true } }),
+} as never
+
+const WIRE_REQUIREMENT = {
+    key: 'connector_whatsapp',
+    name: 'Conector WhatsApp',
+    reason: 'Necesitas el conector para vincular un número.',
+}
+
+// Exactly as ops serves it: snake_case, plus a federated modal + executable so
+// that, without the gate, the click would open the dispatcher.
+const gatedRowAction = {
+    key: 'connect_device',
+    name: 'connect_device',
+    label: 'Conectar WhatsApp',
+    icon: 'QrCode',
+    class: '',
+    type: 'custom',
+    modal: 'link_inbox.connect_device',
+    executable: true,
+    requires_addon: WIRE_REQUIREMENT,
+} as unknown as ActionDefinition
+
+const metadata = { title: 'Devices', actions: [gatedRowAction] } as unknown as TableMetadata
+
+function Wrapper({ children }: { children: React.ReactNode }) {
+    return <ApiProvider client={api}>{children}</ApiProvider>
+}
+
+beforeEach(() => {
+    post.mockClear()
+    navigate.mockClear()
+    dispatcherSpy.mockClear()
+    setAddonInstallHandler(null)
+})
+afterEach(cleanup)
+
+describe('resolveRequiresAddon', () => {
+    it('normalizes the snake_case requires_addon served by the host', () => {
+        expect(resolveRequiresAddon({ requires_addon: WIRE_REQUIREMENT })).toEqual(WIRE_REQUIREMENT)
+    })
+    it('reads camelCase requiresAddon', () => {
+        expect(resolveRequiresAddon({ requiresAddon: { key: 'x' } })).toEqual({ key: 'x' })
+    })
+    it('treats absent / keyless requirements as runnable', () => {
+        expect(resolveRequiresAddon({ key: 'a' })).toBeNull()
+        expect(resolveRequiresAddon({ requires_addon: { name: 'Sin key' } })).toBeNull()
+        expect(resolveRequiresAddon(undefined)).toBeNull()
+    })
+})
+
+function RowHarness() {
+    const { handleInternalAction, dialogs } = useDynamicRowActions({
+        model: 'Device',
+        metadata,
+        onRefresh: () => {},
+    })
+    return (
+        <>
+            <button onClick={() => handleInternalAction('connect_device', { id: 'r1' })}>run</button>
+            {dialogs}
+        </>
+    )
+}
+
+describe('row actions (table / kanban shared handler)', () => {
+    it('does not dispatch nor post; opens the requires-addon dialog', async () => {
+        const onAction = vi.fn()
+        const { result } = renderHook(
+            () => useDynamicRowActions({ model: 'Device', metadata, onAction, onRefresh: () => {} }),
+            { wrapper: Wrapper },
+        )
+        await act(() => result.current.handleInternalAction('connect_device', { id: 'r1' }))
+        expect(onAction).not.toHaveBeenCalled()
+
+        render(<RowHarness />, { wrapper: Wrapper })
+        await act(async () => fireEvent.click(screen.getByText('run')))
+
+        expect(screen.getByText('Esta acción requiere «Conector WhatsApp»')).toBeTruthy()
+        expect(screen.getByText(WIRE_REQUIREMENT.reason)).toBeTruthy()
+        expect(screen.queryByTestId('dispatcher')).toBeNull()
+        expect(dispatcherSpy).not.toHaveBeenCalled()
+        expect(post).not.toHaveBeenCalled()
+    })
+
+    it('Instalar invokes the host handler with the addon key', async () => {
+        const handler = vi.fn()
+        setAddonInstallHandler(handler)
+        render(<RowHarness />, { wrapper: Wrapper })
+        await act(async () => fireEvent.click(screen.getByText('run')))
+        await act(async () => fireEvent.click(screen.getByText('Instalar «Conector WhatsApp»')))
+        expect(handler).toHaveBeenCalledWith('connector_whatsapp')
+        expect(navigate).not.toHaveBeenCalled()
+    })
+
+    it('without a handler navigates through the router to /marketplace/<key>', async () => {
+        render(<RowHarness />, { wrapper: Wrapper })
+        await act(async () => fireEvent.click(screen.getByText('run')))
+        await act(async () => fireEvent.click(screen.getByText('Instalar «Conector WhatsApp»')))
+        expect(navigate).toHaveBeenCalledWith({ to: '/marketplace/connector_whatsapp' })
+    })
+
+    it('menu entry stays visible with a lock and the addon name as tooltip', () => {
+        render(
+            <DropdownMenu open>
+                <DropdownMenuContent>
+                    <RowActionMenuItem action={gatedRowAction} label="Conectar WhatsApp" onSelect={() => {}} />
+                </DropdownMenuContent>
+            </DropdownMenu>,
+        )
+        const item = screen.getByText('Conectar WhatsApp').closest('[data-requires-addon]')
+        expect(item?.getAttribute('data-requires-addon')).toBe('connector_whatsapp')
+        expect(item?.getAttribute('title')).toBe('Requiere «Conector WhatsApp»')
+    })
+})
+
+describe('ModelActionToolbar', () => {
+    const toolbarAction = {
+        ...gatedRowAction,
+        placement: 'table',
+        requires_addon: undefined,
+        requiresAddon: { key: 'connector_whatsapp', name: 'Conector WhatsApp' },
+    } as unknown as ActionDefinition
+
+    it('renders the action locked and opens the dialog instead of the dispatcher', async () => {
+        const intent = vi.fn()
+        render(
+            <Wrapper>
+                <ModelActionToolbar model="Device" actions={[toolbarAction]} onActionIntent={intent} />
+            </Wrapper>,
+        )
+        const button = screen.getByText('Conectar WhatsApp').closest('button')!
+        expect(button.getAttribute('title')).toBe('Requiere «Conector WhatsApp»')
+        expect(button.querySelector('[data-requires-addon="connector_whatsapp"]')).toBeTruthy()
+
+        await act(async () => fireEvent.click(button))
+        expect(screen.getByText('Esta acción requiere «Conector WhatsApp»')).toBeTruthy()
+        // No reason from the host → generic copy.
+        expect(screen.getByText('Instala «Conector WhatsApp» para habilitar esta acción.')).toBeTruthy()
+        expect(dispatcherSpy).not.toHaveBeenCalled()
+        expect(intent).not.toHaveBeenCalled()
+        expect(post).not.toHaveBeenCalled()
+
+        await act(async () => fireEvent.click(screen.getByText('Instalar «Conector WhatsApp»')))
+        expect(navigate).toHaveBeenCalledWith({ to: '/marketplace/connector_whatsapp' })
+    })
+
+    it('an ungated action still opens the dispatcher', async () => {
+        const plain = { ...toolbarAction, key: 'other', label: 'Otra', requiresAddon: undefined } as ActionDefinition
+        render(
+            <Wrapper>
+                <ModelActionToolbar model="Device" actions={[plain]} />
+            </Wrapper>,
+        )
+        await act(async () => fireEvent.click(screen.getByText('Otra')))
+        expect(dispatcherSpy).toHaveBeenCalled()
+    })
+})

package/src/approval-events.ts

@@ -0,0 +1,39 @@
+// approval-events — dependency-free glue between server-error.ts (which sees a
+// parked `approval_required` write) and <ApprovalGateProvider> (which owns the
+// PIN dialog). Kept apart so the error toaster never imports React/UI code.
+
+/** Window event toastServerError fires for a parked `approval_required` write. */
+export const APPROVAL_PARKED_EVENT = 'metacore:approval-parked'
+/** Fired after a parked request was approved (and replayed) with a PIN. */
+export const APPROVAL_DECIDED_EVENT = 'metacore:approval-decided'
+
+let gateMounted = 0
+/** @internal provider bookkeeping. */
+export function gateMountedDelta(d: number): void {
+    gateMounted += d
+}
+
+/** True while an <ApprovalGateProvider> is mounted (toastServerError offers the PIN action only then). */
+export function approvalGateAvailable(): boolean {
+    return gateMounted > 0
+}
+
+export interface ApprovalRequiredInfo {
+    requestId: string
+    label?: string
+    roles: string[]
+}
+
+/** Extracts the parked-request info from an axios error / response body, or null. */
+export function approvalRequiredInfo(err: unknown): ApprovalRequiredInfo | null {
+    const data = ((err as { response?: { data?: unknown } })?.response?.data ?? err) as
+        | { error?: { code?: string }; meta?: { approval_request_id?: string; approval_label?: string; approval_roles?: string[] } }
+        | undefined
+    if (data?.error?.code !== 'approval_required') return null
+    return {
+        requestId: data.meta?.approval_request_id ?? '',
+        label: data.meta?.approval_label,
+        roles: data.meta?.approval_roles ?? [],
+    }
+}
+

package/src/approval-gate.tsx

@@ -0,0 +1,180 @@
+// ApprovalGate — one place for "this needs a supervisor" in hosts that mount an
+// ApiProvider. It answers two situations with the same PIN dialog:
+//
+//   1. INLINE policy (POS oversell, discount over the cap, refund…): the client
+//      calls `requestApproval({policy, …})`. A user who already holds the policy's
+//      `general.approve_<policy>` capability passes straight through (`bypassed`);
+//      everyone else gets the dialog, which posts `/approvals/pin-grant`.
+//   2. PARKED request: a write answered 422 `approval_required`. toastServerError
+//      shows "Enviado a aprobación" with an "Aprobar con PIN" action that opens the
+//      dialog against `/approvals/:id/approve-pin` (kernel approvals_pin.go).
+//
+// Federated addons with their own HTTP client use <ApprovalPinDialog> directly
+// (approval-pin-dialog.tsx) and post to the same endpoints.
+import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react'
+import { useTranslation } from 'react-i18next'
+import { toast } from 'sonner'
+import { useApi } from './api-context'
+import { useCan } from './permissions-context'
+import { ApprovalPinDialog, type ApprovalPinSubmit } from './approval-pin-dialog'
+import {
+    APPROVAL_DECIDED_EVENT,
+    APPROVAL_PARKED_EVENT,
+    gateMountedDelta,
+    type ApprovalRequiredInfo,
+} from './approval-events'
+
+export {
+    APPROVAL_DECIDED_EVENT,
+    APPROVAL_PARKED_EVENT,
+    approvalGateAvailable,
+    approvalRequiredInfo,
+    type ApprovalRequiredInfo,
+} from './approval-events'
+
+/** Capability that authorizes `policy` (and lets its holder skip the prompt). */
+export function approvalCapability(policy: string): string {
+    return `general.approve_${policy}`
+}
+
+export interface ApprovalGrant {
+    /** Audit row id (ApprovalRequest.kind=pin); null when the caller bypassed. */
+    id: string | null
+    policy: string
+    bypassed: boolean
+    reason?: string
+}
+
+export interface RequestApprovalOptions {
+    /** Policy key: oversell | discount | price_below_min | refund | cancel_cfdi | inventory_adjust | <addon-declared>. */
+    policy: string
+    label: string
+    description?: React.ReactNode
+    /** Free-form audit data stored with the grant (product, qty, before → after…). */
+    context?: Record<string, unknown>
+    model?: string
+    recordId?: string
+    addonKey?: string
+}
+
+export interface ApprovalGateValue {
+    /** Resolves the grant, or null when the operator cancelled. */
+    requestApproval: (opts: RequestApprovalOptions) => Promise<ApprovalGrant | null>
+    /** True when the current user may do `policy` without asking anyone. */
+    canSelfApprove: (policy: string) => boolean
+}
+
+const ApprovalGateContext = createContext<ApprovalGateValue | null>(null)
+
+type Pending =
+    | { kind: 'inline'; opts: RequestApprovalOptions; resolve: (g: ApprovalGrant | null) => void }
+    | { kind: 'parked'; info: ApprovalRequiredInfo }
+
+export function ApprovalGateProvider({ children }: { children: React.ReactNode }) {
+    const { t } = useTranslation()
+    const api = useApi()
+    const can = useCan()
+    const [pending, setPending] = useState<Pending | null>(null)
+    const pendingRef = useRef<Pending | null>(null)
+    pendingRef.current = pending
+
+    useEffect(() => {
+        gateMountedDelta(1)
+        const onParked = (e: Event) => {
+            const info = (e as CustomEvent<ApprovalRequiredInfo>).detail
+            if (info?.requestId) setPending({ kind: 'parked', info })
+        }
+        window.addEventListener(APPROVAL_PARKED_EVENT, onParked)
+        return () => {
+            gateMountedDelta(-1)
+            window.removeEventListener(APPROVAL_PARKED_EVENT, onParked)
+        }
+    }, [])
+
+    const canSelfApprove = useCallback((policy: string) => can(approvalCapability(policy)), [can])
+
+    const requestApproval = useCallback(
+        (opts: RequestApprovalOptions) => {
+            if (can(approvalCapability(opts.policy))) {
+                return Promise.resolve<ApprovalGrant>({ id: null, policy: opts.policy, bypassed: true })
+            }
+            return new Promise<ApprovalGrant | null>((resolve) => {
+                pendingRef.current?.kind === 'inline' && pendingRef.current.resolve(null)
+                setPending({ kind: 'inline', opts, resolve })
+            })
+        },
+        [can],
+    )
+
+    const close = () => {
+        const p = pendingRef.current
+        if (p?.kind === 'inline') p.resolve(null)
+        setPending(null)
+    }
+
+    const submit = async ({ pin, reason }: ApprovalPinSubmit) => {
+        const p = pendingRef.current
+        if (!p) return
+        if (p.kind === 'inline') {
+            const res = await api.post('/approvals/pin-grant', {
+                policy: p.opts.policy,
+                label: p.opts.label,
+                pin,
+                reason,
+                context: p.opts.context,
+                model: p.opts.model,
+                record_id: p.opts.recordId,
+                addon_key: p.opts.addonKey,
+            })
+            const row = res.data?.data
+            p.resolve({ id: row?.id ?? null, policy: p.opts.policy, bypassed: false, reason })
+        } else {
+            await api.post(`/approvals/${p.info.requestId}/approve-pin`, { pin, reason })
+            toast.success(t('approvals.approved_applied', { defaultValue: 'Aprobado y aplicado' }))
+            window.dispatchEvent(new CustomEvent(APPROVAL_DECIDED_EVENT, { detail: p.info }))
+        }
+        setPending(null)
+    }
+
+    const value = useMemo<ApprovalGateValue>(() => ({ requestApproval, canSelfApprove }), [requestApproval, canSelfApprove])
+
+    const title =
+        pending?.kind === 'inline'
+            ? pending.opts.label
+            : pending?.kind === 'parked'
+              ? pending.info.label || t('approvals.parked_title', { defaultValue: 'Requiere aprobación' })
+              : ''
+
+    return (
+        <ApprovalGateContext.Provider value={value}>
+            {children}
+            <ApprovalPinDialog
+                open={pending !== null}
+                title={title}
+                description={pending?.kind === 'inline' ? pending.opts.description : undefined}
+                onSubmit={submit}
+                onCancel={close}
+            />
+        </ApprovalGateContext.Provider>
+    )
+}
+
+/**
+ * Access the gate. Without a provider the gate fails CLOSED for inline requests
+ * (resolves null) — never silently authorizes — but honours the capability
+ * bypass, and `canSelfApprove` follows `useCan()` (always-true with no
+ * <PermissionsProvider>, i.e. legacy hosts keep today's behaviour).
+ */
+export function useApprovalGate(): ApprovalGateValue {
+    const ctx = useContext(ApprovalGateContext)
+    const can = useCan()
+    return useMemo<ApprovalGateValue>(
+        () =>
+            ctx ?? {
+                canSelfApprove: (policy) => can(approvalCapability(policy)),
+                requestApproval: async (opts) =>
+                    can(approvalCapability(opts.policy)) ? { id: null, policy: opts.policy, bypassed: true } : null,
+            },
+        [ctx, can],
+    )
+}