@endora-commerce/mod-custom-fields 0.0.0-stage → 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @endora-commerce/mod-custom-fields
+
+Entity-agnostic runtime custom fields for core entities.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `custom_fields` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-custom-fields` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-custom-fields/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-custom-fields/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-custom-fields/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-custom-fields/ports` | type-only — the port interfaces other modules resolve this one through |
+| `@endora-commerce/mod-custom-fields/tailwind.css` | the Tailwind source declaration for the admin code above |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/admin-kit` — *optional*
+- `@endora-commerce/contracts`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `ioredis` ^5
+- `lucide-react` ^1 — *optional*
+- `react` ^19 — *optional*
+- `react-router-dom` ^7 — *optional*
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-custom-fields
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/api/custom-fields-client.d.ts

@@ -0,0 +1,10 @@
+import type { CreateCustomFieldDefinitionRequest, CustomFieldDefinitionDto, CustomFieldEntityTypeInfo, SupportedEntityType, UpdateCustomFieldDefinitionRequest } from '@endora-commerce/contracts';
+export declare const customFieldsClient: {
+    /** Supported host entity types + host-managed metadata (feature 061). */
+    listEntityTypes: () => Promise<CustomFieldEntityTypeInfo[]>;
+    list: (entityType?: SupportedEntityType) => Promise<CustomFieldDefinitionDto[]>;
+    create: (body: CreateCustomFieldDefinitionRequest) => Promise<CustomFieldDefinitionDto>;
+    update: (id: string, patch: UpdateCustomFieldDefinitionRequest) => Promise<CustomFieldDefinitionDto>;
+    remove: (id: string) => Promise<unknown>;
+};
+//# sourceMappingURL=custom-fields-client.d.ts.map

package/dist/admin/api/custom-fields-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-fields-client.d.ts","sourceRoot":"","sources":["../../../src/admin/api/custom-fields-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kCAAkC,EAClC,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,4BAA4B,CAAC;AAMpC,eAAO,MAAM,kBAAkB;IAC7B,yEAAyE;2BACpD,OAAO,CAAC,yBAAyB,EAAE,CAAC;wBAIrC,mBAAmB,KAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;mBAM9D,kCAAkC,KAAG,OAAO,CAAC,wBAAwB,CAAC;iBAExE,MAAM,SAAS,kCAAkC,KAAG,OAAO,CAAC,wBAAwB,CAAC;iBAErF,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;CAEvC,CAAC"}

package/dist/admin/api/custom-fields-client.js

@@ -0,0 +1,11 @@
+import { apiClient } from '@endora-commerce/admin-kit/lib';
+const unwrap = (p) => p.then((r) => r.data);
+export const customFieldsClient = {
+    /** Supported host entity types + host-managed metadata (feature 061). */
+    listEntityTypes: () => unwrap(apiClient.get('/api/v1/admin/custom-fields/entity-types')),
+    list: (entityType) => unwrap(apiClient.get(`/api/v1/admin/custom-fields/definitions${entityType ? `?entityType=${entityType}` : ''}`)),
+    create: (body) => unwrap(apiClient.post('/api/v1/admin/custom-fields/definitions', body)),
+    update: (id, patch) => unwrap(apiClient.patch(`/api/v1/admin/custom-fields/definitions/${id}`, patch)),
+    remove: (id) => apiClient.delete(`/api/v1/admin/custom-fields/definitions/${id}`),
+};
+//# sourceMappingURL=custom-fields-client.js.map

package/dist/admin/api/custom-fields-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-fields-client.js","sourceRoot":"","sources":["../../../src/admin/api/custom-fields-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAW3D,MAAM,MAAM,GAAG,CAAI,CAAmB,EAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,yEAAyE;IACzE,eAAe,EAAE,GAAyC,EAAE,CAC1D,MAAM,CACJ,SAAS,CAAC,GAAG,CAAoC,0CAA0C,CAAC,CAC7F;IACH,IAAI,EAAE,CAAC,UAAgC,EAAuC,EAAE,CAC9E,MAAM,CACJ,SAAS,CAAC,GAAG,CACX,0CAA0C,UAAU,CAAC,CAAC,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1F,CACF;IACH,MAAM,EAAE,CAAC,IAAwC,EAAqC,EAAE,CACtF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAiC,yCAAyC,EAAE,IAAI,CAAC,CAAC;IACzG,MAAM,EAAE,CAAC,EAAU,EAAE,KAAyC,EAAqC,EAAE,CACnG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAiC,2CAA2C,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACjH,MAAM,EAAE,CAAC,EAAU,EAAoB,EAAE,CACvC,SAAS,CAAC,MAAM,CAAC,2CAA2C,EAAE,EAAE,CAAC;CACpE,CAAC"}

package/dist/admin/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `custom_fields`' admin surface — one route and one sidebar entry
+ * (feature 091, Phase 4, batch 9;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-contribution.md`).
+ *
+ * **Its drain was four incoming reaches and it is zero**, and the reason is
+ * worth more than the count. `admin-registrations.ts` filed those four under
+ * *"reached as components by screens other modules own, which is FR-007's
+ * contribution-zone question"*; `admin-component-contribution.md` §9.1 read
+ * them instead of counting them and measured the opposite.
+ * `CustomFieldValuesPanel`'s props are `(entityType, values, save)` — data in,
+ * edited data back — so all four call sites hand it the **host's** own stored
+ * bag and the host's own writer, and this module's admin API serves definitions
+ * and no values at all. Nothing of the owner's crosses that seam, so it was
+ * never a zone contribution; P4e published it into
+ * `@endora-commerce/admin-kit/components` and the four consumers name the
+ * subpath directly.
+ *
+ * **The re-export shim P4e left at `admin/src/modules/custom_fields/` goes with
+ * this move.** Its own doc block kept it *"for the owner's own screens"*, and
+ * after this batch the owner has no screen under `admin/src` — a package screen
+ * cannot resolve a `@/` specifier at all. No file in the tree named it; the
+ * `admin-kit-identity.test.ts` case that proved it forwarded rather than copied
+ * is removed with the file it compared.
+ *
+ * **The palette action was already declared** (`open-custom-fields` in
+ * `manifest.ts`), which is what makes this module's advertisement the one
+ * surface the server's effective enabled-set already filtered. This batch adds
+ * none and changes none; the off-state test drives it.
+ *
+ * **`nonDeactivatable`, so the operator axis is the platform's** (`plan.md`
+ * Ruling 2). It is Principle XIV's extensibility mechanism — the answer the
+ * platform gives to "add a field" instead of a bespoke column — and switching
+ * it off would make the values already stored against every host entity
+ * unreachable. The permission axis is what this module still has and is what
+ * the off-state test drives; the missing axis is read off the manifest rather
+ * than skipped.
+ *
+ * **This entry exports data and nothing else** (R2); the component is a
+ * dynamic-import factory (R6).
+ */
+import type { AdminContributions } from '@endora-commerce/admin-kit/contributions';
+export declare const contributions: AdminContributions;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAiBnF,eAAO,MAAM,aAAa,EAAE,kBAoC3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,51 @@
+/** The module's only route: definitions per entity type, list and create. */
+const ROUTE_PATH = '/custom-fields';
+/**
+ * The code the definition reads enforce, and the one the manifest's
+ * `open-custom-fields` action already declares — so the palette entry, the
+ * sidebar entry and the route agree by construction rather than by three
+ * authors remembering.
+ *
+ * `custom_fields:write` gates the create and delete calls the same screen
+ * makes; it is deliberately not the surface gate, because an operator holding
+ * only the read code opens the screen and sees the write affordances refuse.
+ */
+const CUSTOM_FIELDS_READ_PERMISSION = 'custom_fields:read';
+export const contributions = {
+    routes: [
+        {
+            path: ROUTE_PATH,
+            component: () => import('./pages/CustomFieldsPage.js'),
+            requiredPermission: CUSTOM_FIELDS_READ_PERMISSION,
+            index: true,
+        },
+    ],
+    nav: [
+        {
+            to: ROUTE_PATH,
+            // Module-relative (R8), resolved in this module's own namespace out of
+            // `packages/modules/custom_fields/i18n/`. It was
+            // `appShell.nav.customFields` in the shared `_i18n` bundle, one of the
+            // four shared files a module author had to edit.
+            labelKey: 'nav.customFields.label',
+            // The glyph `AppShell.tsx` rendered by hand, and already on
+            // `KnownIconNameSchema` — this module's own palette action names it.
+            icon: 'Layers',
+            // Custom fields extend Organizations, Orders, Customers, Categories and
+            // more, so the entry belongs to *System* rather than to any one domain —
+            // the placement the host comment carried and this declaration keeps.
+            section: 'system',
+            // The hand-written position in *System* times a hundred, which is batch
+            // four's convention: `/custom-fields` was the fifth row of that section
+            // before the drain began, between `/catalog/bulk-operations` and
+            // `/audit-log`. The weights already declared there — `admin_users` 200,
+            // `admin_roles` 300, `audit_logs` 600, `api_keys` 700, `webhooks` 800 —
+            // leave 500 exactly where this row sat among them. *System* still holds
+            // host-declared entries, so `composeNav` appends every registry row after
+            // all of them whatever the weight says.
+            weight: 500,
+            requiredPermission: CUSTOM_FIELDS_READ_PERMISSION,
+        },
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AA2CA,6EAA6E;AAC7E,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AAE3D,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC;YACtD,kBAAkB,EAAE,6BAA6B;YACjD,KAAK,EAAE,IAAI;SACZ;KACF;IACD,GAAG,EAAE;QACH;YACE,EAAE,EAAE,UAAU;YACd,uEAAuE;YACvE,iDAAiD;YACjD,uEAAuE;YACvE,iDAAiD;YACjD,QAAQ,EAAE,wBAAwB;YAClC,4DAA4D;YAC5D,qEAAqE;YACrE,IAAI,EAAE,QAAQ;YACd,wEAAwE;YACxE,yEAAyE;YACzE,qEAAqE;YACrE,OAAO,EAAE,QAAQ;YACjB,wEAAwE;YACxE,wEAAwE;YACxE,iEAAiE;YACjE,wEAAwE;YACxE,wEAAwE;YACxE,wEAAwE;YACxE,0EAA0E;YAC1E,wCAAwC;YACxC,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,6BAA6B;SAClD;KACF;CACF,CAAC"}

package/dist/admin/pages/CustomFieldsPage.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from 'react';
+/** Custom-field definition management (feature 055). List + create per entity type. */
+export declare function CustomFieldsPage(): ReactNode;
+/**
+ * The registry loads a route component through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013). The named export stays: it is
+ * the spelling this module's own code and its tests use.
+ */
+export default CustomFieldsPage;
+//# sourceMappingURL=CustomFieldsPage.d.ts.map

package/dist/admin/pages/CustomFieldsPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomFieldsPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/CustomFieldsPage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA+BzE,uFAAuF;AACvF,wBAAgB,gBAAgB,IAAI,SAAS,CA+O5C;AAED;;;;GAIG;AACH,eAAe,gBAAgB,CAAC"}

package/dist/admin/pages/CustomFieldsPage.js

@@ -0,0 +1,118 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Link } from 'react-router-dom';
+import { Trash2 } from 'lucide-react';
+import { ApiError } from '@endora-commerce/admin-kit/lib';
+import { customFieldsClient } from '../api/custom-fields-client.js';
+import { Alert, AlertDescription, Badge, Button, Card, CardContent, CardHeader, CardTitle, Label, PageHeader, Select, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+/** Pre-API fallback so the page renders before the entity-types fetch resolves. */
+const FALLBACK_ENTITY_TYPES = ['category', 'order', 'organization', 'customer', 'quote_request'].map((entityType) => ({
+    entityType,
+    labelKey: `customFields.entity.${entityType === 'quote_request' ? 'quoteRequest' : entityType}`,
+}));
+const VALUE_TYPES = [
+    'text',
+    'number',
+    'boolean',
+    'date',
+    'select',
+    'multiselect',
+];
+const SELECT_TYPES = new Set(['select', 'multiselect']);
+/** Custom-field definition management (feature 055). List + create per entity type. */
+export function CustomFieldsPage() {
+    // One namespace, this module's own (feature 091, R8). The screen used to
+    // read `customFields.title` and `customFields.description` out of the shared
+    // `core` bundle beside four keys of its own; both were already written in
+    // this module's `i18n/{en,pl}.json`, so the `core` reader was a second copy
+    // of two strings and nothing else. `customFields.title` and
+    // `customFields.save` stay in `_i18n` because
+    // `@endora-commerce/admin-kit`'s `CustomFieldValuesPanel` renders them, and a
+    // kit component reads the shared namespace by construction.
+    const t = useTranslation('custom_fields');
+    const [entityTypes, setEntityTypes] = useState(FALLBACK_ENTITY_TYPES);
+    const [entityType, setEntityType] = useState('organization');
+    const [rows, setRows] = useState([]);
+    const [error, setError] = useState(null);
+    // Host-managed marker for the selected type (feature 061): definitions are
+    // rendered read-only with a link to the owning module's surface.
+    const managedBy = entityTypes.find((i) => i.entityType === entityType)?.managedBy;
+    // New-definition form state.
+    const [key, setKey] = useState('');
+    const [label, setLabel] = useState('');
+    const [valueType, setValueType] = useState('text');
+    const [required, setRequired] = useState(false);
+    const [options, setOptions] = useState('');
+    const refresh = useCallback(async () => {
+        setError(null);
+        try {
+            setRows(await customFieldsClient.list(entityType));
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : 'Failed to load.');
+        }
+    }, [entityType]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    useEffect(() => {
+        void (async () => {
+            try {
+                setEntityTypes(await customFieldsClient.listEntityTypes());
+            }
+            catch {
+                // Keep the static fallback; the definitions list still works.
+            }
+        })();
+    }, []);
+    const run = useCallback(async (fn) => {
+        setError(null);
+        try {
+            await fn();
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : 'Action failed.');
+        }
+    }, [refresh]);
+    const submit = () => {
+        const opts = SELECT_TYPES.has(valueType)
+            ? options
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean)
+                .map((value, i) => ({
+                value,
+                label: {},
+                labelDefault: value,
+                isDefault: false,
+                sortOrder: i,
+            }))
+            : [];
+        void run(async () => {
+            await customFieldsClient.create({
+                entityType,
+                key: key.trim(),
+                label: label.trim() ? { en: label.trim() } : {},
+                labelDefault: label.trim() || key.trim(),
+                valueType,
+                required,
+                sortOrder: rows.length,
+                config: {},
+                options: opts,
+            });
+            setKey('');
+            setLabel('');
+            setOptions('');
+        });
+    };
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(PageHeader, { title: t('customFields.title'), description: t('customFields.description') }), error && (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) })), _jsx("div", { className: "flex items-end gap-2", children: _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "entity", children: "Entity" }), _jsx(Select, { id: "entity", value: entityType, onChange: (e) => setEntityType(e.target.value), children: entityTypes.map((info) => (_jsx("option", { value: info.entityType, children: t(info.labelKey) }, info.entityType))) })] }) }), managedBy && (_jsx(Alert, { children: _jsxs(AlertDescription, { className: "flex flex-wrap items-center gap-2", children: [_jsx("span", { children: t('customFields.managedBy.notice') }), _jsx(Link, { to: managedBy.route, className: "font-medium underline underline-offset-4", children: t(managedBy.labelKey) })] }) })), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: "Fields" }) }), _jsxs(CardContent, { className: "space-y-3", children: [_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: "Key" }), _jsx(TableHead, { children: "Label" }), _jsx(TableHead, { children: "Type" }), _jsx(TableHead, { children: "Required" }), _jsx(TableHead, { children: "Options" }), _jsx(TableHead, {})] }) }), _jsx(TableBody, { children: rows.map((d) => (_jsxs(TableRow, { children: [_jsx(TableCell, { className: "font-mono text-xs", children: d.key }), _jsx(TableCell, { children: d.label['en'] ?? d.labelDefault }), _jsx(TableCell, { children: d.valueType }), _jsx(TableCell, { children: _jsx(Badge, { variant: d.required ? 'default' : 'secondary', children: d.required ? 'required' : 'optional' }) }), _jsx(TableCell, { className: "text-xs", children: d.options.map((o) => o.value).join(', ') || '—' }), _jsx(TableCell, { children: !managedBy && (_jsx(Button, { variant: "ghost", size: "sm", onClick: () => void run(() => customFieldsClient.remove(d.id)), children: _jsx(Trash2, { className: "size-4" }) })) })] }, d.id))) })] }), !managedBy && (_jsxs("div", { className: "flex flex-wrap items-end gap-2", children: [_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "key", children: "Key" }), _jsx("input", { id: "key", className: "h-9 rounded-md border border-input bg-background px-3 text-sm", value: key, onChange: (e) => setKey(e.target.value), placeholder: "po_number" })] }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "label", children: "Label (EN)" }), _jsx("input", { id: "label", className: "h-9 rounded-md border border-input bg-background px-3 text-sm", value: label, onChange: (e) => setLabel(e.target.value) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "vt", children: "Type" }), _jsx(Select, { id: "vt", value: valueType, onChange: (e) => setValueType(e.target.value), children: VALUE_TYPES.map((vt) => (_jsx("option", { value: vt, children: vt }, vt))) })] }), SELECT_TYPES.has(valueType) && (_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "opts", children: "Options (comma-separated)" }), _jsx("input", { id: "opts", className: "h-9 rounded-md border border-input bg-background px-3 text-sm", value: options, onChange: (e) => setOptions(e.target.value), placeholder: "gold, silver" })] })), _jsxs("label", { className: "flex items-center gap-1 text-sm", children: [_jsx("input", { type: "checkbox", checked: required, onChange: (e) => setRequired(e.target.checked) }), "Required"] }), _jsx(Button, { size: "sm", disabled: !key.trim(), onClick: submit, children: "Add field" })] }))] })] })] }));
+}
+/**
+ * The registry loads a route component through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013). The named export stays: it is
+ * the spelling this module's own code and its tests use.
+ */
+export default CustomFieldsPage;
+//# sourceMappingURL=CustomFieldsPage.js.map

package/dist/admin/pages/CustomFieldsPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomFieldsPage.js","sourceRoot":"","sources":["../../../src/admin/pages/CustomFieldsPage.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3N,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAQjE,mFAAmF;AACnF,MAAM,qBAAqB,GACzB,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,CAClE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACrB,UAAU;IACV,QAAQ,EAAE,uBAAuB,UAAU,KAAK,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,EAAE;CAChG,CAAC,CAAC,CAAC;AACJ,MAAM,WAAW,GAA2B;IAC1C,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,QAAQ;IACR,aAAa;CACd,CAAC;AACF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAuB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;AAE9E,uFAAuF;AACvF,MAAM,UAAU,gBAAgB;IAC9B,yEAAyE;IACzE,6EAA6E;IAC7E,0EAA0E;IAC1E,4EAA4E;IAC5E,4DAA4D;IAC5D,8CAA8C;IAC9C,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,CAAC,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;IAC1C,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAC5C,qBAAqB,CACtB,CAAC;IACF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAsB,cAAc,CAAC,CAAC;IAClF,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAA6B,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,2EAA2E;IAC3E,iEAAiE;IACjE,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,EAAE,SAAS,CAAC;IAElF,6BAA6B;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAuB,MAAM,CAAC,CAAC;IACzE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QACpD,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACrF,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,OAAO,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,cAAc,CAAC,MAAM,kBAAkB,CAAC,eAAe,EAAE,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;YAChE,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,GAAG,GAAG,WAAW,CACrB,KAAK,EAAE,EAA0B,EAAiB,EAAE;QAClD,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,CAAC;YACX,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACpF,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,OAAO;iBACJ,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,MAAM,CAAC,OAAO,CAAC;iBACf,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClB,KAAK;gBACL,KAAK,EAAE,EAAE;gBACT,YAAY,EAAE,KAAK;gBACnB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,CAAC;aACb,CAAC,CAAC;YACP,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;YAClB,MAAM,kBAAkB,CAAC,MAAM,CAAC;gBAC9B,UAAU;gBACV,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE;gBACf,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;gBAC/C,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE;gBACxC,SAAS;gBACT,QAAQ;gBACR,SAAS,EAAE,IAAI,CAAC,MAAM;gBACtB,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,CAAC;YACX,QAAQ,CAAC,EAAE,CAAC,CAAC;YACb,UAAU,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,CACL,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,UAAU,IAAC,KAAK,EAAE,CAAC,CAAC,oBAAoB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,0BAA0B,CAAC,GAAI,EACzF,KAAK,IAAI,CACR,KAAC,KAAK,IAAC,OAAO,EAAC,aAAa,YAC1B,KAAC,gBAAgB,cAAE,KAAK,GAAoB,GACtC,CACT,EAED,cAAK,SAAS,EAAC,sBAAsB,YACnC,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,QAAQ,uBAAe,EACtC,KAAC,MAAM,IACL,EAAE,EAAC,QAAQ,EACX,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,KAA4B,CAAC,YAEpE,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACzB,iBAA8B,KAAK,EAAE,IAAI,CAAC,UAAU,YACjD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IADN,IAAI,CAAC,UAAU,CAEnB,CACV,CAAC,GACK,IACL,GACF,EAEL,SAAS,IAAI,CACZ,KAAC,KAAK,cACJ,MAAC,gBAAgB,IAAC,SAAS,EAAC,mCAAmC,aAC7D,yBAAO,CAAC,CAAC,+BAA+B,CAAC,GAAQ,EACjD,KAAC,IAAI,IAAC,EAAE,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,EAAC,0CAA0C,YAC5E,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,GACjB,IACU,GACb,CACT,EAED,MAAC,IAAI,eACH,KAAC,UAAU,cACT,KAAC,SAAS,yBAAmB,GAClB,EACb,MAAC,WAAW,IAAC,SAAS,EAAC,WAAW,aAChC,MAAC,KAAK,eACJ,KAAC,WAAW,cACV,MAAC,QAAQ,eACP,KAAC,SAAS,sBAAgB,EAC1B,KAAC,SAAS,wBAAkB,EAC5B,KAAC,SAAS,uBAAiB,EAC3B,KAAC,SAAS,2BAAqB,EAC/B,KAAC,SAAS,0BAAoB,EAC9B,KAAC,SAAS,KAAG,IACJ,GACC,EACd,KAAC,SAAS,cACP,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACf,MAAC,QAAQ,eACP,KAAC,SAAS,IAAC,SAAS,EAAC,mBAAmB,YAAE,CAAC,CAAC,GAAG,GAAa,EAC5D,KAAC,SAAS,cAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,GAAa,EACxD,KAAC,SAAS,cAAE,CAAC,CAAC,SAAS,GAAa,EACpC,KAAC,SAAS,cACR,KAAC,KAAK,IAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,YACjD,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,GAC/B,GACE,EACZ,KAAC,SAAS,IAAC,SAAS,EAAC,SAAS,YAC3B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,GACtC,EACZ,KAAC,SAAS,cACP,CAAC,SAAS,IAAI,CACb,KAAC,MAAM,IACL,OAAO,EAAC,OAAO,EACf,IAAI,EAAC,IAAI,EACT,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,YAE9D,KAAC,MAAM,IAAC,SAAS,EAAC,QAAQ,GAAG,GACtB,CACV,GACS,KAtBC,CAAC,CAAC,EAAE,CAuBR,CACZ,CAAC,GACQ,IACN,EAEP,CAAC,SAAS,IAAI,CACf,eAAK,SAAS,EAAC,gCAAgC,aAC7C,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,KAAK,oBAAY,EAChC,gBACE,EAAE,EAAC,KAAK,EACR,SAAS,EAAC,+DAA+D,EACzE,KAAK,EAAE,GAAG,EACV,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACvC,WAAW,EAAC,WAAW,GACvB,IACE,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,OAAO,2BAAmB,EACzC,gBACE,EAAE,EAAC,OAAO,EACV,SAAS,EAAC,+DAA+D,EACzE,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GACzC,IACE,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,IAAI,qBAAa,EAChC,KAAC,MAAM,IACL,EAAE,EAAC,IAAI,EACP,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,KAA6B,CAAC,YAEpE,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CACvB,iBAAiB,KAAK,EAAE,EAAE,YACvB,EAAE,IADQ,EAAE,CAEN,CACV,CAAC,GACK,IACL,EACL,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAC9B,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,MAAM,0CAAkC,EACvD,gBACE,EAAE,EAAC,MAAM,EACT,SAAS,EAAC,+DAA+D,EACzE,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAC3C,WAAW,EAAC,cAAc,GAC1B,IACE,CACP,EACD,iBAAO,SAAS,EAAC,iCAAiC,aAChD,gBAAO,IAAI,EAAC,UAAU,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAI,gBAEtF,EACR,KAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,0BAE/C,IACL,CACL,IACW,IACT,IACH,CACP,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,eAAe,gBAAgB,CAAC"}

package/dist/backend/commands/definition-commands.d.ts

@@ -0,0 +1,22 @@
+import type { CreateCustomFieldDefinitionRequest, CustomFieldOptionDto, UpdateCustomFieldDefinitionRequest } from '@endora-commerce/contracts';
+import type { Command } from '@endora-commerce/platform/commands';
+import { CustomFieldDefinition } from '../entities/custom-field-definition.entity.js';
+import { CustomFieldOption } from '../entities/custom-field-option.entity.js';
+import { type DefinitionChangeProbes } from '../services/custom-field-definition-apply.js';
+/** Create a definition (+ its options for select types). */
+export declare function createDefinitionCommand(input: CreateCustomFieldDefinitionRequest): Command<CustomFieldDefinition>;
+/** Patch a definition's scalar/label/config fields. Options are managed via option sub-commands. */
+export declare function updateDefinitionCommand(id: string, patch: UpdateCustomFieldDefinitionRequest, probes?: DefinitionChangeProbes): Command<CustomFieldDefinition>;
+/** Delete a definition. Options cascade; host values are retained dormant (FR-010). */
+export declare function deleteDefinitionCommand(id: string): Command<{
+    id: string;
+}>;
+/** Add one option to a select/multiselect definition. */
+export declare function createOptionCommand(definitionId: string, input: CustomFieldOptionDto): Command<CustomFieldOption>;
+/** Patch one option's label/default/ordering. */
+export declare function updateOptionCommand(definitionId: string, optionId: string, patch: Partial<Pick<CustomFieldOptionDto, 'label' | 'labelDefault' | 'isDefault' | 'sortOrder'>>): Command<CustomFieldOption>;
+/** Delete one option (the in-use guard also runs in the service before dispatch). */
+export declare function deleteOptionCommand(definitionId: string, optionId: string, probes?: DefinitionChangeProbes): Command<{
+    id: string;
+}>;
+//# sourceMappingURL=definition-commands.d.ts.map

package/dist/backend/commands/definition-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-commands.d.ts","sourceRoot":"","sources":["../../../src/backend/commands/definition-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kCAAkC,EAClC,oBAAoB,EACpB,kCAAkC,EACnC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAOL,KAAK,sBAAsB,EAC5B,MAAM,8CAA8C,CAAC;AA2BtD,4DAA4D;AAC5D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED,oGAAoG;AACpG,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kCAAkC,EACzC,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAc3E;AAED,yDAAyD;AACzD,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,cAAc,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,GAC/F,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAczB"}

package/dist/backend/commands/definition-commands.js

@@ -0,0 +1,115 @@
+import { CustomFieldDefinition } from '../entities/custom-field-definition.entity.js';
+import { CustomFieldOption } from '../entities/custom-field-option.entity.js';
+import { applyCreateDefinition, applyCreateOption, applyDeleteDefinition, applyDeleteOption, applyUpdateDefinition, applyUpdateOption, } from '../services/custom-field-definition-apply.js';
+/**
+ * Command factories for custom-field definition/option mutations (feature 055,
+ * Principle XIII). Each returns a named {@link Command} the {@link CommandBus}
+ * runs co-transactionally — the bus writes exactly one audit entry, so the
+ * module never calls the audit writer by hand.
+ *
+ * The command bodies delegate the entity writes + invariants to the shared
+ * apply functions (feature 061) so the public CRUD and the host apply seam are
+ * a single write path.
+ */
+function snapshotDefinition(def) {
+    return {
+        id: def.id,
+        entityType: def.entityType,
+        key: def.key,
+        label: def.label,
+        labelDefault: def.labelDefault,
+        valueType: def.valueType,
+        required: def.required,
+        sortOrder: def.sortOrder,
+        config: def.config,
+    };
+}
+/** Create a definition (+ its options for select types). */
+export function createDefinitionCommand(input) {
+    return {
+        action: 'custom_fields.definition.created',
+        objectType: 'custom_field_definition',
+        objectId: 'new',
+        run: async ({ em }) => {
+            const def = await applyCreateDefinition(em, input);
+            return { result: def, after: snapshotDefinition(def) };
+        },
+    };
+}
+/** Patch a definition's scalar/label/config fields. Options are managed via option sub-commands. */
+export function updateDefinitionCommand(id, patch, probes) {
+    return {
+        action: 'custom_fields.definition.updated',
+        objectType: 'custom_field_definition',
+        objectId: id,
+        capture: async ({ em }) => {
+            const def = await em.findOne(CustomFieldDefinition, { id });
+            return def ? snapshotDefinition(def) : null;
+        },
+        run: async ({ em }) => {
+            const def = await applyUpdateDefinition(em, id, patch, probes);
+            return { result: def, after: snapshotDefinition(def) };
+        },
+    };
+}
+/** Delete a definition. Options cascade; host values are retained dormant (FR-010). */
+export function deleteDefinitionCommand(id) {
+    return {
+        action: 'custom_fields.definition.deleted',
+        objectType: 'custom_field_definition',
+        objectId: id,
+        capture: async ({ em }) => {
+            const def = await em.findOne(CustomFieldDefinition, { id });
+            return def ? snapshotDefinition(def) : null;
+        },
+        run: async ({ em }) => {
+            await applyDeleteDefinition(em, id);
+            return { result: { id }, after: null };
+        },
+    };
+}
+/** Add one option to a select/multiselect definition. */
+export function createOptionCommand(definitionId, input) {
+    return {
+        action: 'custom_fields.option.created',
+        objectType: 'custom_field_option',
+        objectId: 'new',
+        run: async ({ em }) => {
+            const opt = await applyCreateOption(em, definitionId, input);
+            return { result: opt, after: { id: opt.id, definitionId, value: opt.value } };
+        },
+    };
+}
+/** Patch one option's label/default/ordering. */
+export function updateOptionCommand(definitionId, optionId, patch) {
+    return {
+        action: 'custom_fields.option.updated',
+        objectType: 'custom_field_option',
+        objectId: optionId,
+        capture: async ({ em }) => {
+            const o = await em.findOne(CustomFieldOption, { id: optionId });
+            return o ? { id: o.id, value: o.value, labelDefault: o.labelDefault } : null;
+        },
+        run: async ({ em }) => {
+            const o = await applyUpdateOption(em, definitionId, optionId, patch);
+            return { result: o, after: { id: o.id, value: o.value, labelDefault: o.labelDefault } };
+        },
+    };
+}
+/** Delete one option (the in-use guard also runs in the service before dispatch). */
+export function deleteOptionCommand(definitionId, optionId, probes) {
+    return {
+        action: 'custom_fields.option.deleted',
+        objectType: 'custom_field_option',
+        objectId: optionId,
+        capture: async ({ em }) => {
+            const o = await em.findOne(CustomFieldOption, { id: optionId });
+            return o ? { id: o.id, value: o.value } : null;
+        },
+        run: async ({ em }) => {
+            await applyDeleteOption(em, definitionId, optionId, probes);
+            return { result: { id: optionId }, after: null };
+        },
+    };
+}
+//# sourceMappingURL=definition-commands.js.map

package/dist/backend/commands/definition-commands.js.map

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

package/dist/backend/entities/custom-field-definition.entity.d.ts

@@ -0,0 +1,37 @@
+import { OptionalProps } from '@mikro-orm/core';
+import type { CustomFieldValueType, SupportedEntityType } from '@endora-commerce/contracts';
+/**
+ * CustomFieldDefinition — an operator-defined field for one host entity type
+ * (feature 055, FR-001/FR-002).
+ *
+ * Entity-agnostic by construction (FR-006): it carries a `key`, a per-locale
+ * `label` + `labelDefault`, a `valueType`, a `required` flag, ordering, and an
+ * opaque `config` JSONB for host-capability opt-in that the generic core stores
+ * but never interprets. It deliberately omits the catalog-only capability flags
+ * that made the product-attribute registry un-reusable — those stay behind host
+ * extension points. Platform-global (`@GlobalEntity`), like the product-attribute
+ * registry; the VALUES live on the host row's JSONB column and inherit that
+ * host's tenant scope.
+ *
+ * Unique on `(entity_type, key)` so a key is a clean identifier within an
+ * entity type. Options for `select` / `multiselect` live on
+ * `custom_field_options` (FK ON DELETE CASCADE).
+ */
+export declare class CustomFieldDefinition {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'required' | 'sortOrder' | 'label' | 'config';
+    id: string;
+    entityType: SupportedEntityType;
+    key: string;
+    /** Per-locale label map (BCP-47-keyed). Empty `{}` is allowed when only `labelDefault` is filled. */
+    label: Record<string, string>;
+    /** Fallback label used when the active locale is missing from `label` (US1 scenario 4). */
+    labelDefault: string;
+    valueType: CustomFieldValueType;
+    required: boolean;
+    sortOrder: number;
+    /** Opaque host-capability flags (FR-006). The core stores but never reads this for meaning. */
+    config: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=custom-field-definition.entity.d.ts.map

package/dist/backend/entities/custom-field-definition.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-definition.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/custom-field-definition.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAG7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE5F;;;;;;;;;;;;;;;;GAgBG;AACH,qBAGa,qBAAqB;IAChC,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,WAAW,GACX,WAAW,GACX,UAAU,GACV,WAAW,GACX,OAAO,GACP,QAAQ,CAAC;IAGb,EAAE,EAAE,MAAM,CAAgB;IAI1B,UAAU,EAAG,mBAAmB,CAAC;IAGjC,GAAG,EAAG,MAAM,CAAC;IAEb,qGAAqG;IAErG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAEnC,2FAA2F;IAE3F,YAAY,EAAG,MAAM,CAAC;IAGtB,SAAS,EAAG,oBAAoB,CAAC;IAGjC,QAAQ,EAAE,OAAO,CAAS;IAG1B,SAAS,EAAE,MAAM,CAAK;IAEtB,+FAA+F;IAE/F,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAGrC,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}