@asteby/metacore-runtime-react 23.9.3 → 23.10.0

package/dist/license/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Licencia de instancia — el contrato de estado que el backend del host (ops
+ * vía kernel `LicenseService`) expone y que este módulo pinta. El SDK NO habla
+ * con el kernel ni impone su versión: el host resuelve el `LicenseState` con su
+ * propio transporte y se lo pasa a <LicenseGate>. Así el gate es un primitivo
+ * reutilizable e INDEPENDIENTE del release del kernel.
+ *
+ * División de responsabilidades del blindaje:
+ *   - kernel  → enforcement (qué está permitido; firma/verifica el estado).
+ *   - SDK     → UX (este módulo: gate, banner, badge).
+ *   - hub     → emisión (mintea el token Ed25519).
+ *   - hosts   → wiring (resuelven el estado y montan <LicenseGate> en 1 línea).
+ */
+/** El estado operativo de la licencia, tal como lo deriva el backend. */
+export type LicenseStatus = 'valid' | 'stale' | 'grace' | 'expired' | 'missing' | 'invalid';
+export interface LicenseState {
+    /** Licensing activo en esta instancia (LICENSING_ENFORCE). Si es false el
+     * gate es transparente: nunca bloquea ni degrada. */
+    enforced: boolean;
+    configured: boolean;
+    valid: boolean;
+    status: LicenseStatus;
+    reason?: string;
+    org_id?: string;
+    plan?: string;
+    preset?: string;
+    entitlements: string[];
+    wildcard: boolean;
+    /** Lease: la instancia falló su check-in obligatorio con el hub. */
+    stale: boolean;
+    max_offline_hours?: number;
+    issued_at?: string;
+    expires_at?: string;
+    in_grace: boolean;
+    grace_until?: string;
+    days_remaining: number;
+    last_checked_at?: string;
+}
+/** La licencia es OPERABLE cuando permite operar (aunque sea degradada):
+ * valid, la postura `stale` del lease, o dentro de la ventana de gracia.
+ * missing/invalid/expired no son operables. Sin enforcement → siempre operable.
+ * Espeja `State.Operable()` del backend. */
+export declare function isLicenseOperable(state: LicenseState | undefined): boolean;
+/** La instancia debe BLOQUEARSE tras el modal de activación cuando hay
+ * enforcement y la licencia es missing/invalid/expired (pasada la gracia).
+ * grace/stale degradan con banner en vez de bloquear. Espeja `State.Blocking()`.
+ * Mientras el estado aún carga (undefined) NO bloquea: fail-open en la UI para
+ * que un check lento/fallido nunca destelle un candado sobre la app. */
+export declare function isLicenseBlocking(state: LicenseState | undefined): boolean;
+/** Un preset/vertical está habilitado si la licencia otorga wildcard o lo lista
+ * explícitamente. Sin enforcement → todo habilitado. */
+export declare function isPresetEntitled(state: LicenseState | undefined, presetKey: string): boolean;
+/** Marca trial vencido: el copy del gate cambia a "tu prueba terminó". */
+export declare function isTrialExpired(state: LicenseState | undefined): boolean;
+/** Branding opcional para teñir el gate/banner. El host lo pasa desde su
+ * PlatformConfig del SDK (o cualquier fuente); sin él, fallback neutro. */
+export interface LicenseBranding {
+    /** Nombre de la plataforma/tenant, para el encabezado del gate. */
+    name?: string;
+    /** URL del logo (se embebe como <img>). */
+    logo?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/license/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,yEAAyE;AACzE,MAAM,MAAM,aAAa,GACnB,OAAO,GACP,OAAO,GACP,OAAO,GACP,SAAS,GACT,SAAS,GACT,SAAS,CAAA;AAEf,MAAM,WAAW,YAAY;IACzB;yDACqD;IACrD,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,EAAE,OAAO,CAAA;IACjB,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAA;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;4CAG4C;AAC5C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAG1E;AAED;;;;wEAIwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAG1E;AAED;wDACwD;AACxD,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,GAClB,OAAO,CAIT;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAEvE;AAED;2EAC2E;AAC3E,MAAM,WAAW,eAAe;IAC5B,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB"}

package/dist/license/types.js

@@ -0,0 +1,45 @@
+/**
+ * Licencia de instancia — el contrato de estado que el backend del host (ops
+ * vía kernel `LicenseService`) expone y que este módulo pinta. El SDK NO habla
+ * con el kernel ni impone su versión: el host resuelve el `LicenseState` con su
+ * propio transporte y se lo pasa a <LicenseGate>. Así el gate es un primitivo
+ * reutilizable e INDEPENDIENTE del release del kernel.
+ *
+ * División de responsabilidades del blindaje:
+ *   - kernel  → enforcement (qué está permitido; firma/verifica el estado).
+ *   - SDK     → UX (este módulo: gate, banner, badge).
+ *   - hub     → emisión (mintea el token Ed25519).
+ *   - hosts   → wiring (resuelven el estado y montan <LicenseGate> en 1 línea).
+ */
+/** La licencia es OPERABLE cuando permite operar (aunque sea degradada):
+ * valid, la postura `stale` del lease, o dentro de la ventana de gracia.
+ * missing/invalid/expired no son operables. Sin enforcement → siempre operable.
+ * Espeja `State.Operable()` del backend. */
+export function isLicenseOperable(state) {
+    if (!state || !state.enforced)
+        return true;
+    return state.valid || state.in_grace;
+}
+/** La instancia debe BLOQUEARSE tras el modal de activación cuando hay
+ * enforcement y la licencia es missing/invalid/expired (pasada la gracia).
+ * grace/stale degradan con banner en vez de bloquear. Espeja `State.Blocking()`.
+ * Mientras el estado aún carga (undefined) NO bloquea: fail-open en la UI para
+ * que un check lento/fallido nunca destelle un candado sobre la app. */
+export function isLicenseBlocking(state) {
+    if (!state || !state.enforced)
+        return false;
+    return !isLicenseOperable(state);
+}
+/** Un preset/vertical está habilitado si la licencia otorga wildcard o lo lista
+ * explícitamente. Sin enforcement → todo habilitado. */
+export function isPresetEntitled(state, presetKey) {
+    if (!state || !state.enforced)
+        return true;
+    if (state.wildcard)
+        return true;
+    return state.entitlements?.includes(presetKey) ?? false;
+}
+/** Marca trial vencido: el copy del gate cambia a "tu prueba terminó". */
+export function isTrialExpired(state) {
+    return !!state && state.plan === 'trial' && state.status === 'expired';
+}

package/dist/types.d.ts

@@ -495,6 +495,12 @@ export interface PaginationMeta {
     to: number;
     total: number;
 }
+/** One page of a multi-step (wizard) action. Mirrors the sdk's ActionStep. */
+export interface ActionStep {
+    title: string;
+    description?: string;
+    fields: ActionFieldDef[];
+}
 export interface ActionMetadata {
     key: string;
     label: string;
@@ -503,6 +509,8 @@ export interface ActionMetadata {
     confirm?: boolean;
     confirmMessage?: string;
     fields?: ActionFieldDef[];
+    /** Multi-step wizard form; when present the dispatcher renders a wizard. */
+    steps?: ActionStep[];
     requiresState?: string[];
     executable?: boolean;
     placement?: 'row' | 'table' | 'create';

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": "23.9.3",
+  "version": "23.10.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",

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

@@ -0,0 +1,242 @@
+// @vitest-environment happy-dom
+//
+// Contrato del blindaje de licencia (LicenseGate + banner + helpers):
+//   - Sin enforcement o estado operable → children, sin candado.
+//   - stale/grace → children + banner degradado (grace descartable, expired no).
+//   - enforcement && missing/invalid/expired → modal bloqueante con activación.
+//   - trial vencido → copy "tu prueba terminó".
+//   - onActivate: éxito desbloquea (el host refresca), error muestra el mensaje.
+//
+// Gotcha conocido (reference_radix_select_happydom_reset): nada de Radix Select
+// aquí — el gate usa un <Input> plano y el texto visible es el gate de los asserts.
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, render, screen, fireEvent, waitFor } from '@testing-library/react'
+
+vi.mock('react-i18next', () => ({
+    useTranslation: () => ({
+        t: (_k: string, opts?: Record<string, unknown>) => {
+            let s = (opts?.defaultValue as string) ?? _k
+            // interpolación mínima {{x}} para los mensajes del banner.
+            for (const [k, v] of Object.entries(opts ?? {})) {
+                if (k === 'defaultValue') continue
+                s = s.replace(new RegExp(`{{\\s*${k}\\s*}}`, 'g'), String(v))
+            }
+            return s
+        },
+    }),
+}))
+
+afterEach(() => {
+    cleanup()
+    localStorage.clear()
+})
+
+import {
+    LicenseGate,
+    LicenseExpiryBanner,
+    LicenseStatusBadge,
+    isLicenseBlocking,
+    isLicenseOperable,
+    isPresetEntitled,
+    isTrialExpired,
+    type LicenseState,
+} from '../license'
+
+function make(partial: Partial<LicenseState>): LicenseState {
+    return {
+        enforced: true,
+        configured: true,
+        valid: false,
+        status: 'missing',
+        entitlements: [],
+        wildcard: false,
+        stale: false,
+        in_grace: false,
+        days_remaining: 0,
+        ...partial,
+    }
+}
+
+const CHILD = <div>contenido protegido</div>
+
+describe('helpers de estado', () => {
+    it('operable/blocking espejan al backend', () => {
+        expect(isLicenseOperable(make({ status: 'valid', valid: true }))).toBe(true)
+        expect(isLicenseOperable(make({ status: 'grace', in_grace: true }))).toBe(true)
+        expect(isLicenseOperable(make({ status: 'missing' }))).toBe(false)
+        expect(isLicenseBlocking(make({ status: 'expired' }))).toBe(true)
+        // Sin enforcement nunca bloquea, aunque el status sea feo.
+        expect(isLicenseBlocking(make({ enforced: false, status: 'expired' }))).toBe(false)
+        // undefined (aún cargando) → fail-open.
+        expect(isLicenseBlocking(undefined)).toBe(false)
+    })
+
+    it('entitlement respeta wildcard y lista explícita', () => {
+        expect(isPresetEntitled(make({ wildcard: true }), 'pitsline')).toBe(true)
+        expect(isPresetEntitled(make({ entitlements: ['pitsline'] }), 'pitsline')).toBe(true)
+        expect(isPresetEntitled(make({ entitlements: ['otro'] }), 'pitsline')).toBe(false)
+        expect(isPresetEntitled(make({ enforced: false }), 'lo-que-sea')).toBe(true)
+    })
+
+    it('trial vencido se detecta', () => {
+        expect(isTrialExpired(make({ plan: 'trial', status: 'expired' }))).toBe(true)
+        expect(isTrialExpired(make({ plan: 'pro', status: 'expired' }))).toBe(false)
+    })
+})
+
+describe('LicenseGate', () => {
+    const noop = () => Promise.resolve()
+
+    it('renderiza children sin candado cuando la licencia es válida', () => {
+        render(
+            <LicenseGate state={make({ status: 'valid', valid: true })} onActivate={noop}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        expect(screen.getByText('contenido protegido')).toBeTruthy()
+        expect(screen.queryByRole('dialog')).toBeNull()
+    })
+
+    it('sin enforcement es transparente', () => {
+        render(
+            <LicenseGate state={make({ enforced: false, status: 'missing' })} onActivate={noop}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        expect(screen.getByText('contenido protegido')).toBeTruthy()
+        expect(screen.queryByRole('dialog')).toBeNull()
+    })
+
+    it('bloquea con modal cuando falta la licencia', () => {
+        render(
+            <LicenseGate state={make({ status: 'missing' })} onActivate={noop}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        expect(screen.getByRole('dialog')).toBeTruthy()
+        expect(screen.getByText('Activa tu licencia')).toBeTruthy()
+        // children siguen montados detrás del overlay (no reload).
+        expect(screen.getByText('contenido protegido')).toBeTruthy()
+    })
+
+    it('trial vencido muestra el copy de prueba terminada', () => {
+        render(
+            <LicenseGate state={make({ status: 'expired', plan: 'trial' })} onActivate={noop}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        expect(screen.getByText('Tu prueba gratuita terminó')).toBeTruthy()
+    })
+
+    it('activación exitosa llama onActivate con el código pegado', async () => {
+        const onActivate = vi.fn().mockResolvedValue(undefined)
+        render(
+            <LicenseGate state={make({ status: 'missing' })} onActivate={onActivate}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        fireEvent.change(screen.getByLabelText('Clave o token de licencia'), {
+            target: { value: '  lic_abc123  ' },
+        })
+        fireEvent.click(screen.getByText('Activar licencia'))
+        await waitFor(() => expect(onActivate).toHaveBeenCalledWith('lic_abc123'))
+    })
+
+    it('muestra el mensaje de error del backend al fallar', async () => {
+        const onActivate = vi.fn().mockRejectedValue(new Error('Token no corresponde a esta instancia'))
+        render(
+            <LicenseGate state={make({ status: 'invalid' })} onActivate={onActivate}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        fireEvent.change(screen.getByLabelText('Clave o token de licencia'), {
+            target: { value: 'lic_bad' },
+        })
+        fireEvent.click(screen.getByText('Activar licencia'))
+        await waitFor(() =>
+            expect(screen.getByText('Token no corresponde a esta instancia')).toBeTruthy(),
+        )
+    })
+
+    it('el botón activar está deshabilitado sin código', () => {
+        render(
+            <LicenseGate state={make({ status: 'missing' })} onActivate={noop}>
+                {CHILD}
+            </LicenseGate>,
+        )
+        const btn = screen.getByText('Activar licencia').closest('button')!
+        expect(btn.disabled).toBe(true)
+    })
+
+    it('grace degrada con banner en vez de bloquear', () => {
+        render(
+            <LicenseGate
+                state={make({ status: 'grace', in_grace: true, days_remaining: 5, grace_until: '2026-08-01' })}
+                onActivate={noop}
+            >
+                {CHILD}
+            </LicenseGate>,
+        )
+        expect(screen.queryByRole('dialog')).toBeNull()
+        expect(screen.getByText('contenido protegido')).toBeTruthy()
+        expect(screen.getByRole('alert')).toBeTruthy()
+    })
+})
+
+describe('LicenseExpiryBanner', () => {
+    it('silencioso sin enforcement', () => {
+        const { container } = render(
+            <LicenseExpiryBanner state={make({ enforced: false, status: 'expired' })} />,
+        )
+        expect(container.firstChild).toBeNull()
+    })
+
+    it('expired no es descartable (no hay botón cerrar)', () => {
+        render(<LicenseExpiryBanner state={make({ status: 'expired' })} />)
+        expect(screen.getByRole('alert')).toBeTruthy()
+        expect(screen.queryByTitle('Descartar')).toBeNull()
+    })
+
+    it('grace es descartable y persiste el descarte', () => {
+        const { rerender } = render(
+            <LicenseExpiryBanner state={make({ status: 'grace', in_grace: true, days_remaining: 3 })} />,
+        )
+        fireEvent.click(screen.getByTitle('Descartar'))
+        expect(screen.queryByRole('alert')).toBeNull()
+        // Re-render: sigue descartado por el TTL en localStorage.
+        rerender(
+            <LicenseExpiryBanner state={make({ status: 'grace', in_grace: true, days_remaining: 3 })} />,
+        )
+        expect(screen.queryByRole('alert')).toBeNull()
+    })
+
+    it('aviso de renovación próxima cuando quedan pocos días', () => {
+        render(
+            <LicenseExpiryBanner state={make({ status: 'valid', valid: true, days_remaining: 7 })} />,
+        )
+        expect(screen.getByText('Tu licencia vence en 7 días.')).toBeTruthy()
+    })
+
+    it('botón gestionar solo cuando el host pasa onManage', () => {
+        const onManage = vi.fn()
+        render(
+            <LicenseExpiryBanner
+                state={make({ status: 'expired' })}
+                onManage={onManage}
+            />,
+        )
+        fireEvent.click(screen.getByText('Gestionar licencia'))
+        expect(onManage).toHaveBeenCalled()
+    })
+})
+
+describe('LicenseStatusBadge', () => {
+    it('traduce cada status a etiqueta legible', () => {
+        const { rerender } = render(<LicenseStatusBadge status="valid" />)
+        expect(screen.getByText('Activa')).toBeTruthy()
+        rerender(<LicenseStatusBadge status="expired" />)
+        expect(screen.getByText('Vencida')).toBeTruthy()
+        rerender(<LicenseStatusBadge status="stale" />)
+        expect(screen.getByText('Sin verificar')).toBeTruthy()
+    })
+})

package/src/__tests__/wizard-action-modal.test.tsx

@@ -0,0 +1,121 @@
+// @vitest-environment happy-dom
+//
+// WizardActionModal contract (the third render-path of ActionModalDispatcher):
+// when an action declares `steps: [{title, fields[]}]`, the dispatcher renders a
+// multi-step wizard instead of the single-page GenericActionModal. It:
+//   - shows only the current step's fields,
+//   - gates advancing on the current step's required fields,
+//   - accumulates every step's values and POSTs all of them, once, on submit.
+//
+// happy-dom gotcha: Radix Select resets its value in this environment, so these
+// tests gate on visible text/behavior (which fields render, what POST body is
+// sent), never on a Select's value.
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, render, screen, fireEvent, waitFor } from '@testing-library/react'
+
+vi.mock('react-i18next', () => ({
+    useTranslation: () => ({ t: (k: string, o?: any) => o?.defaultValue ?? k }),
+}))
+
+import { ActionModalDispatcher } from '../action-modal-dispatcher'
+import { ApiProvider, type ApiClient } from '../api-context'
+import type { ActionMetadata } from '@asteby/metacore-sdk'
+
+afterEach(cleanup)
+
+function makeApi() {
+    const post = vi.fn().mockResolvedValue({ data: { success: true } })
+    const api = {
+        get: vi.fn().mockResolvedValue({ data: {} }),
+        post,
+    } as unknown as ApiClient
+    return { api, post }
+}
+
+const action: ActionMetadata = {
+    key: 'workshop_checklist',
+    label: 'Checklist de taller',
+    icon: 'wrench',
+    steps: [
+        {
+            title: 'Recepción',
+            fields: [
+                { key: 'plate', label: 'Placa', type: 'text', required: true },
+                { key: 'mileage', label: 'Kilometraje', type: 'number' },
+            ],
+        },
+        {
+            title: 'Diagnóstico',
+            fields: [{ key: 'notes', label: 'Notas', type: 'textarea', required: true }],
+        },
+    ],
+} as unknown as ActionMetadata
+
+function renderModal(api: ApiClient) {
+    return render(
+        <ApiProvider client={api}>
+            <ActionModalDispatcher
+                open
+                onOpenChange={() => {}}
+                action={action}
+                model="service_order"
+                record={{ id: '42' } as any}
+                endpoint="/data/service_order"
+                onSuccess={() => {}}
+            />
+        </ApiProvider>,
+    )
+}
+
+describe('WizardActionModal', () => {
+    it('renders only the first step initially and shows a progress indicator', () => {
+        const { api } = makeApi()
+        renderModal(api)
+        // First step fields present, later step field absent.
+        expect(screen.getByText('Placa')).toBeTruthy()
+        expect(screen.queryByText('Notas')).toBeNull()
+        // Progress label "Paso 1/2".
+        expect(screen.getByText(/1\/2/)).toBeTruthy()
+    })
+
+    it('blocks advancing when the current step has an unmet required field', () => {
+        const { api } = makeApi()
+        renderModal(api)
+        fireEvent.click(screen.getByText('Siguiente'))
+        // Still on step 1 (Notas not shown) because Placa is empty+required.
+        expect(screen.queryByText('Notas')).toBeNull()
+    })
+
+    it('advances to the next step once required fields pass', () => {
+        const { api } = makeApi()
+        renderModal(api)
+        fireEvent.change(document.getElementById('plate') as HTMLInputElement, {
+            target: { value: 'ABC-123' },
+        })
+        fireEvent.click(screen.getByText('Siguiente'))
+        expect(screen.getByText('Notas')).toBeTruthy()
+        // Back returns to step 1 with the value retained.
+        fireEvent.click(screen.getByText('Atrás'))
+        expect((document.getElementById('plate') as HTMLInputElement).value).toBe('ABC-123')
+    })
+
+    it('submits ALL accumulated fields once, to the record action endpoint', async () => {
+        const { api, post } = makeApi()
+        renderModal(api)
+        fireEvent.change(document.getElementById('plate') as HTMLInputElement, {
+            target: { value: 'ABC-123' },
+        })
+        fireEvent.click(screen.getByText('Siguiente'))
+        fireEvent.change(document.getElementById('notes') as HTMLTextAreaElement, {
+            target: { value: 'frenos' },
+        })
+        // Final step shows the action label as the submit button (the label also
+        // appears in the dialog title, so click the last match — the button).
+        const labels = screen.getAllByText('Checklist de taller')
+        fireEvent.click(labels[labels.length - 1])
+        await waitFor(() => expect(post).toHaveBeenCalledTimes(1))
+        const [url, body] = post.mock.calls[0]
+        expect(url).toBe('/data/service_order/42/action/workshop_checklist')
+        expect(body).toMatchObject({ plate: 'ABC-123', notes: 'frenos' })
+    })
+})