@asteby/metacore-runtime-react 13.5.1 → 13.6.0

package/dist/types.d.ts

@@ -12,6 +12,41 @@ export interface TableMetadata {
     canExport?: boolean;
     canImport?: boolean;
     canCreate?: boolean;
+    /**
+     * Child relations of this model, served by the kernel (>= v0.41.0). A
+     * generic detail page renders one `DynamicRelation` panel per entry via
+     * `<DynamicRelations>` to surface, e.g., a Customer's vehicles, addresses
+     * and attachments. Absent on hosts/older kernels — purely additive.
+     */
+    relations?: RelationMeta[];
+}
+/**
+ * Describes one child relation of a parent model, mirroring the kernel
+ * `RelationMeta` shape (>= v0.41.0). Drives the metadata-driven
+ * `<DynamicRelations>` panel list. All keys are snake_case as served by the
+ * kernel; the SDK reads them as-is.
+ */
+export interface RelationMeta {
+    /** Stable identifier for the relation (used as a React key / data attr). */
+    name: string;
+    /** Cardinality. The SDK maps this onto `DynamicRelation.kind`. */
+    kind: 'one_to_many' | 'many_to_many';
+    /**
+     * Child model key (the `through` model). For one_to_many this is the model
+     * whose rows are listed; for many_to_many it is the pivot table.
+     */
+    through: string;
+    /** Child column holding the FK back to the parent. */
+    foreign_key: string;
+    /**
+     * Static equality filters applied on top of the foreign-key scope. Used for
+     * polymorphic children (e.g. `{ "owner_model": "Customer" }`) so a shared
+     * attachments/addresses table is narrowed to this parent's rows. Each entry
+     * becomes a `f_<col>=eq:<val>` query param.
+     */
+    scope?: Record<string, string>;
+    /** Human-readable panel header. */
+    label?: string;
 }
 export interface FilterDefinition {
     key: string;
@@ -100,7 +135,7 @@ export interface FieldValidation {
     max?: number;
     custom?: string;
 }
-export type FieldWidget = 'text' | 'textarea' | 'richtext' | 'color' | 'number' | 'date' | 'select' | 'dynamic_select' | 'switch';
+export type FieldWidget = 'text' | 'textarea' | 'richtext' | 'color' | 'number' | 'date' | 'select' | 'dynamic_select' | 'switch' | 'upload';
 export interface ActionFieldDef {
     key: string;
     label: string;
@@ -146,6 +181,27 @@ export interface ActionFieldDef {
      * reconcile. Mirrors kernel v3 `ActionField.balance`.
      */
     balance?: FieldBalanceRule;
+    /**
+     * `upload` widget: comma-separated accept list forwarded to the file input
+     * `accept` attribute (e.g. `"image/*,.pdf"`). Tolerates the snake_case the
+     * kernel may serve. Optional — when absent any file type is allowed.
+     */
+    accept?: string;
+    /**
+     * `upload` widget: maximum file size in bytes. The renderer rejects larger
+     * files client-side before POSTing. Tolerates kernel snake_case `max_size`.
+     */
+    maxSize?: number;
+    /** snake_case alias served by the kernel manifest for `maxSize`. */
+    max_size?: number;
+    /**
+     * `upload` widget: server-side storage bucket/prefix the host writes the
+     * file under, forwarded to the upload endpoint as `storage_path`. Tolerates
+     * kernel snake_case `storage_path`.
+     */
+    storagePath?: string;
+    /** snake_case alias served by the kernel manifest for `storagePath`. */
+    storage_path?: string;
 }
 /**
  * Declarative reconciliation constraint on a line-items field: the summed value

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/dist/upload-field.d.ts

@@ -0,0 +1,15 @@
+import type { ActionFieldDef } from './types';
+export interface UploadFieldProps {
+    field: ActionFieldDef;
+    value: any;
+    onChange: (v: any) => void;
+}
+/**
+ * Pulls the stored file url/path out of an upload response envelope, tolerating
+ * the common key shapes a host might return. Pure — exported for tests.
+ */
+export declare function extractUploadedValue(payload: any): string;
+/** Short, human display name for an already-stored file value (a url/path). */
+export declare function uploadedDisplayName(value: unknown): string;
+export declare function UploadField({ field, value, onChange }: UploadFieldProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=upload-field.d.ts.map

package/dist/upload-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-field.d.ts","sourceRoot":"","sources":["../src/upload-field.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,cAAc,CAAA;IACrB,KAAK,EAAE,GAAG,CAAA;IACV,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;CAC7B;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAWzD;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK1D;AAED,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,gBAAgB,2CAkHvE"}

package/dist/upload-field.js

@@ -0,0 +1,109 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// UploadField — the `upload` widget renderer shared by DynamicForm's
+// FieldRenderer and the action-modal-dispatcher's renderField so the two stay
+// in lockstep. Renders a themed Button that proxies a hidden <input type=file>,
+// POSTs the picked file to the host upload endpoint as multipart/form-data, and
+// stores the returned file url/path as the field value.
+//
+// Endpoint assumption: `POST /uploads` (multipart) returning
+//   { success: true, data: { file_url?, url?, path?, file_path? } }
+// matching the kernel envelope. A field may override the path via
+// `field.searchEndpoint` (reused as the upload endpoint escape hatch) — kept
+// generic so this carries no host-specific route. Honors field.accept /
+// field.maxSize and forwards field.storagePath as `storage_path`.
+import { useCallback, useRef, useState } from 'react';
+import { Button } from '@asteby/metacore-ui/primitives';
+import { Loader2, Paperclip, X } from 'lucide-react';
+import { useApi } from './api-context';
+import { getUploadConfig } from './dynamic-form-schema';
+/** Default host upload endpoint. Overridable per-field via `searchEndpoint`. */
+const DEFAULT_UPLOAD_ENDPOINT = '/uploads';
+/**
+ * Pulls the stored file url/path out of an upload response envelope, tolerating
+ * the common key shapes a host might return. Pure — exported for tests.
+ */
+export function extractUploadedValue(payload) {
+    if (payload === null || payload === undefined)
+        return '';
+    if (typeof payload === 'string')
+        return payload;
+    const d = (payload && typeof payload === 'object' && 'data' in payload ? payload.data : payload) ?? payload;
+    if (typeof d === 'string')
+        return d;
+    if (d && typeof d === 'object') {
+        const candidate = d.file_url ?? d.fileUrl ?? d.url ?? d.file_path ?? d.filePath ?? d.path;
+        if (typeof candidate === 'string')
+            return candidate;
+    }
+    return '';
+}
+/** Short, human display name for an already-stored file value (a url/path). */
+export function uploadedDisplayName(value) {
+    if (typeof value !== 'string' || value === '')
+        return '';
+    const cleaned = value.split('?')[0];
+    const parts = cleaned.split('/');
+    return parts[parts.length - 1] || cleaned;
+}
+export function UploadField({ field, value, onChange }) {
+    const api = useApi();
+    const inputRef = useRef(null);
+    const [uploading, setUploading] = useState(false);
+    const [error, setError] = useState(null);
+    const { accept, maxSize, storagePath } = getUploadConfig(field);
+    const endpoint = field.searchEndpoint || DEFAULT_UPLOAD_ENDPOINT;
+    const handlePick = useCallback(() => {
+        if (uploading)
+            return;
+        inputRef.current?.click();
+    }, [uploading]);
+    const handleFile = useCallback(async (e) => {
+        const file = e.target.files?.[0];
+        // Reset the input so picking the same file again re-fires change.
+        if (inputRef.current)
+            inputRef.current.value = '';
+        if (!file)
+            return;
+        setError(null);
+        if (maxSize && file.size > maxSize) {
+            const mb = (maxSize / (1024 * 1024)).toFixed(1);
+            setError(`Archivo muy grande (máx. ${mb} MB).`);
+            return;
+        }
+        const form = new FormData();
+        form.append('file', file);
+        if (storagePath)
+            form.append('storage_path', storagePath);
+        setUploading(true);
+        try {
+            const res = await api.post(endpoint, form, {
+                headers: { 'Content-Type': 'multipart/form-data' },
+            });
+            const body = res?.data;
+            if (body && body.success === false) {
+                setError(body.message || 'No se pudo subir el archivo.');
+                return;
+            }
+            const stored = extractUploadedValue(body);
+            if (!stored) {
+                setError('Respuesta de subida inválida.');
+                return;
+            }
+            onChange(stored);
+        }
+        catch (err) {
+            setError(err?.response?.data?.message || 'No se pudo subir el archivo.');
+        }
+        finally {
+            setUploading(false);
+        }
+    }, [api, endpoint, maxSize, storagePath, onChange]);
+    const handleClear = useCallback(() => {
+        if (uploading)
+            return;
+        setError(null);
+        onChange('');
+    }, [uploading, onChange]);
+    const hasValue = typeof value === 'string' && value !== '';
+    return (_jsxs("div", { className: "grid gap-1.5", "data-widget": "upload", children: [_jsx("input", { ref: inputRef, id: field.key, type: "file", accept: accept, className: "sr-only", onChange: handleFile, tabIndex: -1, "aria-hidden": "true" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsxs(Button, { type: "button", variant: "outline", size: "sm", onClick: handlePick, disabled: uploading, children: [uploading ? (_jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" })) : (_jsx(Paperclip, { className: "mr-2 h-4 w-4" })), hasValue ? 'Reemplazar' : field.placeholder || 'Subir archivo'] }), hasValue && !uploading && (_jsxs("div", { className: "flex min-w-0 items-center gap-1 text-sm text-muted-foreground", children: [_jsx("span", { className: "truncate", title: String(value), children: uploadedDisplayName(value) }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", className: "h-6 w-6 p-0", onClick: handleClear, "aria-label": "Quitar archivo", children: _jsx(X, { className: "h-3.5 w-3.5" }) })] }))] }), error && (_jsx("span", { className: "text-sm text-destructive", role: "alert", children: error }))] }));
+}

package/package.json

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

package/src/__tests__/action-visibility-by-state.test.ts

@@ -0,0 +1,51 @@
+import { describe, it, expect } from 'vitest'
+
+import { isActionAllowedForRowState } from '../dynamic-columns'
+
+describe('isActionAllowedForRowState', () => {
+    it('hides the action when row.status is NOT in requiresState', () => {
+        const action = { key: 'start', requiresState: ['reception'] }
+        const row = { id: 1, status: 'in_progress' }
+        expect(isActionAllowedForRowState(action, row)).toBe(false)
+    })
+
+    it('shows the action when row.status IS in requiresState', () => {
+        const action = { key: 'start', requiresState: ['reception'] }
+        const row = { id: 1, status: 'reception' }
+        expect(isActionAllowedForRowState(action, row)).toBe(true)
+    })
+
+    it('shows the action when row.status matches one of several requiresState entries', () => {
+        const action = { key: 'finish', requiresState: ['in_progress', 'paused'] }
+        expect(isActionAllowedForRowState(action, { status: 'paused' })).toBe(true)
+    })
+
+    it('always shows the action when requiresState is empty', () => {
+        const action = { key: 'view', requiresState: [] as string[] }
+        expect(isActionAllowedForRowState(action, { status: 'whatever' })).toBe(true)
+    })
+
+    it('always shows the action when requiresState is absent (no regression)', () => {
+        const action = { key: 'view' }
+        expect(isActionAllowedForRowState(action, { status: 'in_progress' })).toBe(true)
+    })
+
+    it('shows all actions when the row has no status field (no regression)', () => {
+        const action = { key: 'start', requiresState: ['reception'] }
+        expect(isActionAllowedForRowState(action, { id: 1 })).toBe(true)
+        expect(isActionAllowedForRowState(action, { id: 1, status: null })).toBe(true)
+        expect(isActionAllowedForRowState(action, { id: 1, status: '' })).toBe(true)
+    })
+
+    it('tolerates the snake_case requires_state served by the backend', () => {
+        const action = { key: 'start', requires_state: ['reception'] }
+        expect(isActionAllowedForRowState(action, { status: 'reception' })).toBe(true)
+        expect(isActionAllowedForRowState(action, { status: 'in_progress' })).toBe(false)
+    })
+
+    it('coerces numeric status / state values via String() comparison', () => {
+        const action = { key: 'advance', requiresState: [1, 2] as unknown as string[] }
+        expect(isActionAllowedForRowState(action, { status: 2 })).toBe(true)
+        expect(isActionAllowedForRowState(action, { status: '3' })).toBe(false)
+    })
+})

package/src/__tests__/dynamic-relation.test.ts

@@ -25,6 +25,34 @@ describe('buildRelationFilterParams', () => {
         })
     })
 
+    it('agrega filtros de scope extra como f_<col>=eq:<val> (caso polimórfico)', () => {
+        expect(
+            buildRelationFilterParams('owner_id', 'cust_1', { owner_model: 'Customer' }),
+        ).toEqual({
+            f_owner_id: 'eq:cust_1',
+            f_owner_model: 'eq:Customer',
+        })
+    })
+
+    it('el foreign-key gana sobre un scope redundante con el mismo key', () => {
+        expect(
+            buildRelationFilterParams('owner_id', 'cust_1', { owner_id: 'evil', tier: 'gold' }),
+        ).toEqual({
+            f_owner_id: 'eq:cust_1',
+            f_tier: 'eq:gold',
+        })
+    })
+
+    it('ignora scope null/undefined sin romper', () => {
+        expect(
+            // @ts-expect-error testing runtime tolerance
+            buildRelationFilterParams('owner_id', 'c1', { a: null, b: undefined, c: 'ok' }),
+        ).toEqual({ f_owner_id: 'eq:c1', f_c: 'eq:ok' })
+        expect(buildRelationFilterParams('owner_id', 'c1', null)).toEqual({
+            f_owner_id: 'eq:c1',
+        })
+    })
+
     it('rechaza foreignKey vacío', () => {
         expect(() => buildRelationFilterParams('', 'x')).toThrow(/foreignKey/)
     })

package/src/__tests__/dynamic-relations.test.ts

@@ -0,0 +1,60 @@
+import { describe, it, expect } from 'vitest'
+import { resolveParentId, buildRelationFilters } from '../dynamic-relations'
+import type { RelationMeta } from '../types'
+
+describe('resolveParentId', () => {
+    it('lee record.id por defecto', () => {
+        expect(resolveParentId({ id: 'c_1' })).toBe('c_1')
+        expect(resolveParentId({ id: 7 })).toBe(7)
+    })
+
+    it('respeta un parentIdKey custom', () => {
+        expect(resolveParentId({ uuid: 'u_1' }, 'uuid')).toBe('u_1')
+    })
+
+    it('devuelve undefined cuando falta / es vacío / no es escalar', () => {
+        expect(resolveParentId(null)).toBeUndefined()
+        expect(resolveParentId(undefined)).toBeUndefined()
+        expect(resolveParentId({})).toBeUndefined()
+        expect(resolveParentId({ id: '' })).toBeUndefined()
+        expect(resolveParentId({ id: null })).toBeUndefined()
+        expect(resolveParentId({ id: { nested: true } })).toBeUndefined()
+    })
+})
+
+describe('buildRelationFilters', () => {
+    it('mergea scope estático + foreign_key=parentId (caso polimórfico)', () => {
+        const rel: Pick<RelationMeta, 'foreign_key' | 'scope'> = {
+            foreign_key: 'owner_id',
+            scope: { owner_model: 'Customer' },
+        }
+        expect(buildRelationFilters(rel, 'c_1')).toEqual({
+            owner_model: 'Customer',
+            owner_id: 'c_1',
+        })
+    })
+
+    it('funciona sin scope (one_to_many simple)', () => {
+        expect(buildRelationFilters({ foreign_key: 'customer_id' }, 42)).toEqual({
+            customer_id: '42',
+        })
+    })
+
+    it('coerce parentId y valores de scope a string', () => {
+        const rel: Pick<RelationMeta, 'foreign_key' | 'scope'> = {
+            foreign_key: 'owner_id',
+            // @ts-expect-error testing runtime coercion of non-string scope value
+            scope: { kind: 5 },
+        }
+        expect(buildRelationFilters(rel, 9)).toEqual({ kind: '5', owner_id: '9' })
+    })
+
+    it('omite entradas de scope null/undefined', () => {
+        const rel: Pick<RelationMeta, 'foreign_key' | 'scope'> = {
+            foreign_key: 'owner_id',
+            // @ts-expect-error testing runtime tolerance
+            scope: { a: null, b: undefined, c: 'ok' },
+        }
+        expect(buildRelationFilters(rel, 'c_1')).toEqual({ c: 'ok', owner_id: 'c_1' })
+    })
+})

package/src/__tests__/upload-field.test.ts

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest'
+import { extractUploadedValue, uploadedDisplayName } from '../upload-field'
+import { resolveWidget, getUploadConfig } from '../dynamic-form-schema'
+import type { ActionFieldDef } from '../types'
+
+describe('resolveWidget upload', () => {
+    it('infiere upload desde type', () => {
+        expect(resolveWidget({ key: 'f', label: 'F', type: 'upload' })).toBe('upload')
+    })
+    it('respeta widget explícito upload sobre cualquier type', () => {
+        expect(resolveWidget({ key: 'f', label: 'F', type: 'string', widget: 'upload' })).toBe('upload')
+    })
+})
+
+describe('getUploadConfig', () => {
+    it('lee la forma camelCase autorada', () => {
+        const field: ActionFieldDef = {
+            key: 'logo', label: 'Logo', type: 'upload',
+            accept: 'image/*', maxSize: 1024, storagePath: 'brand/',
+        }
+        expect(getUploadConfig(field)).toEqual({ accept: 'image/*', maxSize: 1024, storagePath: 'brand/' })
+    })
+
+    it('tolera la forma snake_case del kernel', () => {
+        const field = {
+            key: 'doc', label: 'Doc', type: 'upload',
+            accept: '.pdf', max_size: 2048, storage_path: 'docs/',
+        } as ActionFieldDef
+        expect(getUploadConfig(field)).toEqual({ accept: '.pdf', maxSize: 2048, storagePath: 'docs/' })
+    })
+
+    it('descarta maxSize inválido / no positivo y campos vacíos', () => {
+        expect(getUploadConfig({ key: 'f', label: 'F', type: 'upload', maxSize: 0 })).toEqual({
+            accept: undefined, maxSize: undefined, storagePath: undefined,
+        })
+        expect(getUploadConfig({ key: 'f', label: 'F', type: 'upload', max_size: -5 } as ActionFieldDef).maxSize).toBeUndefined()
+    })
+})
+
+describe('extractUploadedValue', () => {
+    it('extrae del envelope {success,data:{file_url}}', () => {
+        expect(extractUploadedValue({ success: true, data: { file_url: '/u/a.png' } })).toBe('/u/a.png')
+    })
+    it('soporta url / path / file_path / camelCase', () => {
+        expect(extractUploadedValue({ data: { url: '/u/b' } })).toBe('/u/b')
+        expect(extractUploadedValue({ data: { path: '/u/c' } })).toBe('/u/c')
+        expect(extractUploadedValue({ data: { file_path: '/u/d' } })).toBe('/u/d')
+        expect(extractUploadedValue({ data: { fileUrl: '/u/e' } })).toBe('/u/e')
+    })
+    it('soporta respuesta data como string plano', () => {
+        expect(extractUploadedValue({ data: '/u/flat' })).toBe('/u/flat')
+        expect(extractUploadedValue('/u/raw')).toBe('/u/raw')
+    })
+    it('devuelve "" cuando no hay nada usable', () => {
+        expect(extractUploadedValue(null)).toBe('')
+        expect(extractUploadedValue(undefined)).toBe('')
+        expect(extractUploadedValue({ data: { foo: 'bar' } })).toBe('')
+    })
+})
+
+describe('uploadedDisplayName', () => {
+    it('toma el último segmento del path', () => {
+        expect(uploadedDisplayName('/uploads/2026/a.png')).toBe('a.png')
+        expect(uploadedDisplayName('a.png')).toBe('a.png')
+    })
+    it('descarta el querystring', () => {
+        expect(uploadedDisplayName('/u/a.png?sig=xyz')).toBe('a.png')
+    })
+    it('devuelve "" para valores no-string o vacíos', () => {
+        expect(uploadedDisplayName('')).toBe('')
+        expect(uploadedDisplayName(null)).toBe('')
+        expect(uploadedDisplayName(42)).toBe('')
+    })
+})

package/src/action-modal-dispatcher.tsx

@@ -41,6 +41,7 @@ import { DynamicIcon } from './dynamic-icon'
 import { DynamicLineItems } from './dynamic-line-items'
 import { DynamicSelectField } from './dynamic-select-field'
 import { DynamicDateField } from './dynamic-date-field'
+import { UploadField } from './upload-field'
 import { isLineItemsField, resolveWidget } from './dynamic-form-schema'
 import type { ActionFieldDef } from './types'
 // Canonical registry lives in @asteby/metacore-sdk
@@ -322,6 +323,11 @@ function renderField(
     if (widget === 'dynamic_select') {
         return <DynamicSelectField field={field} value={value} onChange={onChange} />
     }
+    // File upload → themed picker that POSTs the file to the host upload
+    // endpoint and stores the returned url/path. Kept in sync with DynamicForm.
+    if (widget === 'upload') {
+        return <UploadField field={field} value={value} onChange={onChange} />
+    }
     switch (widget) {
         case 'textarea':
             return <Textarea id={field.key} value={value || ''} onChange={(e: React.ChangeEvent<HTMLTextAreaElement>) => onChange(e.target.value)} placeholder={field.placeholder} />

package/src/dynamic-columns.tsx

@@ -62,6 +62,26 @@ const defaultGetImageUrl = (path: string) => path
 const getNestedValue = (obj: any, path: string) =>
     path.split('.').reduce((acc, part) => acc && acc[part], obj)
 
+/**
+ * State-machine gate for per-row actions.
+ *
+ * An action that declares a non-empty `requiresState` (camelCase) / `requires_state`
+ * (snake_case, as served by some backends) is only surfaced for rows whose `status`
+ * field value is contained in that array. This hides e.g. an "Iniciar trabajo"
+ * action (requiresState: ['reception']) on an order already in `in_progress`.
+ *
+ * Null-safe & non-regressive:
+ *   - action without requiresState (or empty array)  → always shown.
+ *   - row with no `status` field                      → all actions shown.
+ */
+export const isActionAllowedForRowState = (action: any, row: any): boolean => {
+    const requires: unknown = action?.requiresState ?? action?.requires_state
+    if (!Array.isArray(requires) || requires.length === 0) return true
+    const status = row?.status
+    if (status === undefined || status === null || status === '') return true
+    return requires.map(String).includes(String(status))
+}
+
 const lowerFirst = (value?: string) => {
     if (!value) return value
     return value.charAt(0).toLowerCase() + value.slice(1)
@@ -519,6 +539,7 @@ export function makeDefaultGetDynamicColumns(
                             </DropdownMenuTrigger>
                             <DropdownMenuContent align="end">
                                 {resolvedActions
+                                    .filter((action) => isActionAllowedForRowState(action, row.original))
                                     .filter((action) => {
                                         if (!action.condition) return true
                                         const { field, operator, value } = action.condition

package/src/dynamic-form-schema.ts

@@ -216,6 +216,33 @@ export function resolveWidget(field: ActionFieldDef): string {
         case 'boolean': return 'switch'
         case 'number': return 'number'
         case 'date': return 'date'
+        // File upload: POSTs to the host upload endpoint and stores the returned
+        // file url/path as the field value. Rendered by `UploadField`.
+        case 'upload': return 'upload'
         default: return 'text'
     }
 }
+
+/**
+ * Normalizes an upload field's config, tolerating both the camelCase authored
+ * SDK shape and the snake_case the kernel serves (`max_size`, `storage_path`).
+ * Pure — shared by both field renderers and unit tests.
+ */
+export function getUploadConfig(field: ActionFieldDef): {
+    accept?: string
+    maxSize?: number
+    storagePath?: string
+} {
+    const accept = field.accept
+    const maxSizeRaw = field.maxSize ?? field.max_size
+    const maxSize =
+        typeof maxSizeRaw === 'number' && Number.isFinite(maxSizeRaw) && maxSizeRaw > 0
+            ? maxSizeRaw
+            : undefined
+    const storagePath = field.storagePath ?? field.storage_path
+    return {
+        accept: accept || undefined,
+        maxSize,
+        storagePath: storagePath || undefined,
+    }
+}

package/src/dynamic-form.tsx

@@ -25,11 +25,13 @@ import { useOptionsResolver, type ResolvedOption } from './use-options-resolver'
 import { DynamicLineItems } from './dynamic-line-items'
 import { DynamicSelectField } from './dynamic-select-field'
 import { DynamicDateField } from './dynamic-date-field'
+import { UploadField } from './upload-field'
 
 export { buildZodSchema, resolveWidget }
 export { DynamicLineItems } from './dynamic-line-items'
 export { DynamicSelectField } from './dynamic-select-field'
 export { DynamicDateField } from './dynamic-date-field'
+export { UploadField } from './upload-field'
 
 export interface DynamicFormProps {
     fields: ActionFieldDef[]
@@ -168,6 +170,11 @@ function FieldRenderer({ field, value, onChange }: FieldRendererProps) {
     if (widget === 'dynamic_select') {
         return <DynamicSelectField field={field} value={value} onChange={onChange} />
     }
+    // File upload → themed picker that POSTs to the host upload endpoint and
+    // stores the returned file url/path as the field value.
+    if (widget === 'upload') {
+        return <UploadField field={field} value={value} onChange={onChange} />
+    }
     // Ref-driven select: hook into useOptionsResolver so the canonical
     // /api/options/<ref>?field=id endpoint feeds the dropdown. This is
     // the path the kernel auto-derives for FK columns; legacy callers

package/src/dynamic-relation-helpers.ts

@@ -24,12 +24,26 @@ export interface TargetRowLike {
 export function buildRelationFilterParams(
     foreignKey: string,
     parentId: string | number,
+    extraFilters?: Record<string, string> | null,
 ): Record<string, string> {
     if (!foreignKey) throw new Error('foreignKey requerido')
     if (parentId === undefined || parentId === null || parentId === '') {
         throw new Error('parentId requerido')
     }
-    return { [`f_${foreignKey}`]: `eq:${String(parentId)}` }
+    const params: Record<string, string> = {
+        [`f_${foreignKey}`]: `eq:${String(parentId)}`,
+    }
+    // Additional static-equality scope columns (polymorphic case: the FK plus
+    // e.g. owner_model=Customer). Each becomes its own `f_<col>=eq:<val>` param.
+    // The foreign-key entry above wins if a caller redundantly repeats it.
+    if (extraFilters) {
+        for (const [col, val] of Object.entries(extraFilters)) {
+            if (!col || col === foreignKey) continue
+            if (val === undefined || val === null) continue
+            params[`f_${col}`] = `eq:${String(val)}`
+        }
+    }
+    return params
 }
 
 /**