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

package/dist/backend/services/custom-field-definition-apply.d.ts

@@ -0,0 +1,63 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CreateCustomFieldDefinitionRequest, type CustomFieldOptionDto, type SupportedEntityType, type UpdateCustomFieldDefinitionRequest } from '@endora-commerce/contracts';
+import { CustomFieldDefinition } from '../entities/custom-field-definition.entity.js';
+import { CustomFieldOption } from '../entities/custom-field-option.entity.js';
+/**
+ * Transactional apply functions for custom-field definition/option writes
+ * (feature 061, contracts/custom-fields-product-host.md §3).
+ *
+ * Every function runs entirely on the CALLER-provided EntityManager and
+ * enforces the same invariants as the public CRUD (duplicate key, options
+ * rule, entity type known, value-type lock via the probe binding,
+ * option-in-use). They dispatch NO command, write NO audit entry, and publish
+ * NO cache invalidation — a host command audits its composite operation and
+ * calls `publishInvalidate` post-commit; the module's own definition commands
+ * share these bodies so there is a single write path (Principle XIII).
+ */
+/** Typed failures the routes map to HTTP status codes. */
+export declare class CustomFieldDefinitionError extends Error {
+    readonly code: 'not_found' | 'duplicate_key' | 'options_required' | 'options_forbidden' | 'entity_type_unknown' | 'value_type_locked' | 'option_in_use' | 'key_changed' | 'invalid_key';
+    constructor(code: 'not_found' | 'duplicate_key' | 'options_required' | 'options_forbidden' | 'entity_type_unknown' | 'value_type_locked' | 'option_in_use' | 'key_changed' | 'invalid_key', message: string);
+}
+/**
+ * Change-guard probes over the host's value storage (structurally satisfied by
+ * `CustomFieldValueService`). Optional: when absent, the corresponding guard
+ * is the caller's responsibility (e.g. a host running its own authoritative
+ * in-use checks first — research §R9).
+ */
+export interface DefinitionChangeProbes {
+    hasStoredValues(em: EntityManager, entityType: SupportedEntityType, key: string): Promise<boolean>;
+    isOptionInUse(em: EntityManager, entityType: SupportedEntityType, key: string, optionValue: string): Promise<boolean>;
+}
+/** Select fields require ≥ 1 option; non-select fields must not carry any. */
+export declare function assertOptionsRule(valueType: string, options: CustomFieldOptionDto[]): void;
+/** Create a definition (+ its options for select types) on the caller's EM. */
+export declare function applyCreateDefinition(em: EntityManager, input: CreateCustomFieldDefinitionRequest): Promise<CustomFieldDefinition>;
+/** Patch a definition's scalar/label/config fields on the caller's EM. */
+export declare function applyUpdateDefinition(em: EntityManager, id: string, patch: UpdateCustomFieldDefinitionRequest, probes?: DefinitionChangeProbes): Promise<CustomFieldDefinition>;
+/**
+ * Rename a definition's key on the caller's EM — the one path by which a key
+ * changes after create (`specs/134-paid-module-extraction/research.md` D12).
+ *
+ * Not an edit: `UpdateCustomFieldDefinitionRequest` omits `key` on purpose,
+ * because every host stores its values **under** the key and an ordinary rename
+ * would orphan them. The caller of this function is therefore one that renames
+ * the host's values in the same transaction — today a connector repairing keys
+ * it derived itself, with `catalog` moving the product values beside it.
+ *
+ * `expectedKey` is the key the caller planned from. A definition whose key has
+ * moved since is refused with `key_changed` rather than renamed from a state the
+ * caller never saw. Flushes before it returns, so a caller sequencing a
+ * two-phase rename (park, then move) gets its statements in the order it asked
+ * for them and a unique-index violation surfaces at the call that caused it.
+ */
+export declare function applyRenameDefinitionKey(em: EntityManager, id: string, expectedKey: string, newKey: string): Promise<CustomFieldDefinition>;
+/** Delete a definition on the caller's EM. Options cascade; host values stay dormant (FR-010). */
+export declare function applyDeleteDefinition(em: EntityManager, id: string): Promise<CustomFieldDefinition>;
+/** Add one option to a select/multiselect definition on the caller's EM. */
+export declare function applyCreateOption(em: EntityManager, definitionId: string, input: CustomFieldOptionDto): Promise<CustomFieldOption>;
+/** Patch one option's label/default/ordering on the caller's EM. */
+export declare function applyUpdateOption(em: EntityManager, definitionId: string, optionId: string, patch: Partial<Pick<CustomFieldOptionDto, 'label' | 'labelDefault' | 'isDefault' | 'sortOrder'>>): Promise<CustomFieldOption>;
+/** Delete one option on the caller's EM (in-use guard via the probe binding). */
+export declare function applyDeleteOption(em: EntityManager, definitionId: string, optionId: string, probes?: DefinitionChangeProbes): Promise<CustomFieldOption>;
+//# sourceMappingURL=custom-field-definition-apply.d.ts.map

package/dist/backend/services/custom-field-definition-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-definition-apply.d.ts","sourceRoot":"","sources":["../../../src/backend/services/custom-field-definition-apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,kCAAkC,EACvC,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kCAAkC,EACxC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAG9E;;;;;;;;;;;GAWG;AAEH,0DAA0D;AAC1D,qBAAa,0BAA2B,SAAQ,KAAK;IAEjD,QAAQ,CAAC,IAAI,EACT,WAAW,GACX,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,eAAe,GACf,aAAa,GACb,aAAa;gBATR,IAAI,EACT,WAAW,GACX,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,eAAe,GACf,aAAa,GACb,aAAa,EACjB,OAAO,EAAE,MAAM;CAKlB;AAID;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnG,aAAa,CACX,EAAE,EAAE,aAAa,EACjB,UAAU,EAAE,mBAAmB,EAC/B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAQ1F;AAED,+EAA+E;AAC/E,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAoChC;AAED,0EAA0E;AAC1E,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,aAAa,EACjB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kCAAkC,EACzC,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoBhC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,aAAa,EACjB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC,CA6BhC;AAED,kGAAkG;AAClG,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAWzG;AAED,4EAA4E;AAC5E,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,aAAa,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAO5B;AAED,oEAAoE;AACpE,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,aAAa,EACjB,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,CAU5B;AAED,iFAAiF;AACjF,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,aAAa,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAuB5B"}

package/dist/backend/services/custom-field-definition-apply.js

@@ -0,0 +1,221 @@
+import { customFieldDefinitionSchema, } from '@endora-commerce/contracts';
+import { CustomFieldDefinition } from '../entities/custom-field-definition.entity.js';
+import { CustomFieldOption } from '../entities/custom-field-option.entity.js';
+import { isSupportedEntityType } from './custom-field-registry.js';
+/**
+ * Transactional apply functions for custom-field definition/option writes
+ * (feature 061, contracts/custom-fields-product-host.md §3).
+ *
+ * Every function runs entirely on the CALLER-provided EntityManager and
+ * enforces the same invariants as the public CRUD (duplicate key, options
+ * rule, entity type known, value-type lock via the probe binding,
+ * option-in-use). They dispatch NO command, write NO audit entry, and publish
+ * NO cache invalidation — a host command audits its composite operation and
+ * calls `publishInvalidate` post-commit; the module's own definition commands
+ * share these bodies so there is a single write path (Principle XIII).
+ */
+/** Typed failures the routes map to HTTP status codes. */
+export class CustomFieldDefinitionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'CustomFieldDefinitionError';
+    }
+}
+const SELECT_TYPES = new Set(['select', 'multiselect']);
+/** Select fields require ≥ 1 option; non-select fields must not carry any. */
+export function assertOptionsRule(valueType, options) {
+    const isSelect = SELECT_TYPES.has(valueType);
+    if (isSelect && options.length === 0) {
+        throw new CustomFieldDefinitionError('options_required', 'Select fields require at least one option.');
+    }
+    if (!isSelect && options.length > 0) {
+        throw new CustomFieldDefinitionError('options_forbidden', 'Only select fields may carry options.');
+    }
+}
+/** Create a definition (+ its options for select types) on the caller's EM. */
+export async function applyCreateDefinition(em, input) {
+    // command-coverage-ignore: apply-seam primitive — mutates on the invoking Command's
+    // transactional EM; the caller (custom_fields definition command or a host command,
+    // e.g. catalog.attribute.*) records the single audit row co-transactionally.
+    // Contract: specs/061-attributes-on-custom-fields/contracts/custom-fields-product-host.md.
+    if (!isSupportedEntityType(input.entityType)) {
+        throw new CustomFieldDefinitionError('entity_type_unknown', `Unknown entity type "${input.entityType}".`);
+    }
+    assertOptionsRule(input.valueType, input.options);
+    const existing = await em.findOne(CustomFieldDefinition, {
+        entityType: input.entityType,
+        key: input.key,
+    });
+    if (existing) {
+        throw new CustomFieldDefinitionError('duplicate_key', `A field "${input.key}" already exists on ${input.entityType}.`);
+    }
+    const def = em.create(CustomFieldDefinition, {
+        entityType: input.entityType,
+        key: input.key,
+        label: input.label,
+        labelDefault: input.labelDefault,
+        valueType: input.valueType,
+        required: input.required,
+        sortOrder: input.sortOrder,
+        config: input.config,
+    });
+    if (SELECT_TYPES.has(input.valueType)) {
+        // Flush the definition first: options reference it by id (no ORM relation),
+        // so MikroORM cannot infer the insert order and would violate the FK.
+        await em.flush();
+        for (const opt of input.options)
+            createOptionEntity(em, def.id, opt);
+    }
+    return def;
+}
+/** Patch a definition's scalar/label/config fields on the caller's EM. */
+export async function applyUpdateDefinition(em, id, patch, probes) {
+    const def = await em.findOne(CustomFieldDefinition, { id });
+    if (!def)
+        throw new CustomFieldDefinitionError('not_found', `Custom field ${id} not found.`);
+    // FR-010: changing valueType while values exist is rejected (probe binding).
+    if (patch.valueType !== undefined && patch.valueType !== def.valueType && probes) {
+        const inUse = await probes.hasStoredValues(em, def.entityType, def.key);
+        if (inUse) {
+            throw new CustomFieldDefinitionError('value_type_locked', `Cannot change the value type of "${def.key}" while records hold values. Clear them first.`);
+        }
+    }
+    if (patch.label !== undefined)
+        def.label = patch.label;
+    if (patch.labelDefault !== undefined)
+        def.labelDefault = patch.labelDefault;
+    if (patch.valueType !== undefined)
+        def.valueType = patch.valueType;
+    if (patch.required !== undefined)
+        def.required = patch.required;
+    if (patch.sortOrder !== undefined)
+        def.sortOrder = patch.sortOrder;
+    if (patch.config !== undefined)
+        def.config = patch.config;
+    return def;
+}
+/**
+ * Rename a definition's key on the caller's EM — the one path by which a key
+ * changes after create (`specs/134-paid-module-extraction/research.md` D12).
+ *
+ * Not an edit: `UpdateCustomFieldDefinitionRequest` omits `key` on purpose,
+ * because every host stores its values **under** the key and an ordinary rename
+ * would orphan them. The caller of this function is therefore one that renames
+ * the host's values in the same transaction — today a connector repairing keys
+ * it derived itself, with `catalog` moving the product values beside it.
+ *
+ * `expectedKey` is the key the caller planned from. A definition whose key has
+ * moved since is refused with `key_changed` rather than renamed from a state the
+ * caller never saw. Flushes before it returns, so a caller sequencing a
+ * two-phase rename (park, then move) gets its statements in the order it asked
+ * for them and a unique-index violation surfaces at the call that caused it.
+ */
+export async function applyRenameDefinitionKey(em, id, expectedKey, newKey) {
+    // command-coverage-ignore: apply-seam primitive — mutates on the caller's
+    // transactional EM. Its one caller is a system-invariant repair with no
+    // operator and no actor (a connector re-keying the attributes it derived,
+    // committed atomically with the host's value rename and the connector's own
+    // repair checkpoint); an audit entry for it would have nobody to attribute.
+    // Contract: specs/134-paid-module-extraction/research.md D12.
+    const def = await em.findOne(CustomFieldDefinition, { id });
+    if (!def)
+        throw new CustomFieldDefinitionError('not_found', `Custom field ${id} not found.`);
+    if (def.key !== expectedKey) {
+        throw new CustomFieldDefinitionError('key_changed', `Custom field ${id} is keyed "${def.key}", not "${expectedKey}"; nothing was renamed.`);
+    }
+    if (!customFieldDefinitionSchema.shape.key.safeParse(newKey).success) {
+        throw new CustomFieldDefinitionError('invalid_key', `"${newKey}" is not a valid field key.`);
+    }
+    if (newKey === def.key)
+        return def;
+    const holder = await em.findOne(CustomFieldDefinition, { entityType: def.entityType, key: newKey });
+    if (holder) {
+        throw new CustomFieldDefinitionError('duplicate_key', `A field "${newKey}" already exists on ${def.entityType}.`);
+    }
+    def.key = newKey;
+    await em.flush();
+    return def;
+}
+/** Delete a definition on the caller's EM. Options cascade; host values stay dormant (FR-010). */
+export async function applyDeleteDefinition(em, id) {
+    // command-coverage-ignore: apply-seam primitive — mutates on the invoking Command's
+    // transactional EM; the caller (custom_fields definition command or a host command,
+    // e.g. catalog.attribute.*) records the single audit row co-transactionally.
+    // Contract: specs/061-attributes-on-custom-fields/contracts/custom-fields-product-host.md.
+    const def = await em.findOne(CustomFieldDefinition, { id });
+    if (!def)
+        throw new CustomFieldDefinitionError('not_found', `Custom field ${id} not found.`);
+    const options = await em.find(CustomFieldOption, { definitionId: id });
+    for (const o of options)
+        em.remove(o);
+    em.remove(def);
+    return def;
+}
+/** Add one option to a select/multiselect definition on the caller's EM. */
+export async function applyCreateOption(em, definitionId, input) {
+    const def = await em.findOne(CustomFieldDefinition, { id: definitionId });
+    if (!def)
+        throw new CustomFieldDefinitionError('not_found', `Custom field ${definitionId} not found.`);
+    if (!SELECT_TYPES.has(def.valueType)) {
+        throw new CustomFieldDefinitionError('options_forbidden', `Field "${def.key}" does not take options.`);
+    }
+    return createOptionEntity(em, definitionId, input);
+}
+/** Patch one option's label/default/ordering on the caller's EM. */
+export async function applyUpdateOption(em, definitionId, optionId, patch) {
+    const option = await em.findOne(CustomFieldOption, { id: optionId });
+    if (!option || option.definitionId !== definitionId) {
+        throw new CustomFieldDefinitionError('not_found', `Option ${optionId} not found.`);
+    }
+    if (patch.label !== undefined)
+        option.label = patch.label;
+    if (patch.labelDefault !== undefined)
+        option.labelDefault = patch.labelDefault;
+    if (patch.isDefault !== undefined)
+        option.isDefault = patch.isDefault;
+    if (patch.sortOrder !== undefined)
+        option.sortOrder = patch.sortOrder;
+    return option;
+}
+/** Delete one option on the caller's EM (in-use guard via the probe binding). */
+export async function applyDeleteOption(em, definitionId, optionId, probes) {
+    // command-coverage-ignore: apply-seam primitive — mutates on the invoking Command's
+    // transactional EM; the caller (custom_fields definition command or a host command,
+    // e.g. catalog.attribute.*) records the single audit row co-transactionally.
+    // Contract: specs/061-attributes-on-custom-fields/contracts/custom-fields-product-host.md.
+    const def = await em.findOne(CustomFieldDefinition, { id: definitionId });
+    if (!def)
+        throw new CustomFieldDefinitionError('not_found', `Custom field ${definitionId} not found.`);
+    const option = await em.findOne(CustomFieldOption, { id: optionId });
+    if (!option || option.definitionId !== definitionId) {
+        throw new CustomFieldDefinitionError('not_found', `Option ${optionId} not found.`);
+    }
+    // FR-010: an in-use option cannot be removed while records reference it.
+    if (probes) {
+        const inUse = await probes.isOptionInUse(em, def.entityType, def.key, option.value);
+        if (inUse) {
+            throw new CustomFieldDefinitionError('option_in_use', `Option "${option.value}" is in use and cannot be removed.`);
+        }
+    }
+    em.remove(option);
+    return option;
+}
+function createOptionEntity(em, definitionId, input) {
+    // command-coverage-ignore: apply-seam primitive, exactly like the two exported
+    // functions that call it — the `em.create` queues the row on the invoking
+    // Command's transactional EM and is flushed by that Command, which records the
+    // single audit row co-transactionally. The marker belongs here rather than only
+    // on the callers because this is the function that writes (D-89).
+    // Contract: specs/061-attributes-on-custom-fields/contracts/custom-fields-product-host.md.
+    return em.create(CustomFieldOption, {
+        definitionId,
+        value: input.value,
+        label: input.label,
+        labelDefault: input.labelDefault,
+        isDefault: input.isDefault,
+        sortOrder: input.sortOrder,
+    });
+}
+//# sourceMappingURL=custom-field-definition-apply.js.map

package/dist/backend/services/custom-field-definition-apply.js.map

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

package/dist/backend/services/custom-field-definition.service.d.ts

@@ -0,0 +1,68 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CreateCustomFieldDefinitionRequest, CustomFieldDefinitionRecord, CustomFieldOptionDto, CustomFieldOptionRecord, SupportedEntityType, UpdateCustomFieldDefinitionRequest } from '@endora-commerce/contracts';
+import type { CommandBus } 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 { CustomFieldDefinitionsCache, CachedDefinition } from './custom-field-definitions-cache.js';
+import { CustomFieldDefinitionError } from './custom-field-definition-apply.js';
+import type { CustomFieldValueService } from './custom-field-value.service.js';
+import type { DefinitionSource } from './custom-field-value.service.js';
+import type { CustomFieldDefinitionApplyApi } from '../../ports/index.js';
+export { CustomFieldDefinitionError };
+/**
+ * CustomFieldDefinitionService (feature 055) — CRUD over definitions and options.
+ *
+ * All mutations run through the Command Bus (Principle XIII); the bus writes the
+ * audit entry, so this service never calls the audit writer by hand. Reads are
+ * served from the per-`entityType` cache and every committed mutation publishes a
+ * cross-process invalidation. Implements {@link DefinitionSource} so the value
+ * service can validate host writes against the live definitions, and
+ * {@link CustomFieldDefinitionApplyApi} so host modules can mutate definitions
+ * co-transactionally with their own data (feature 061).
+ */
+export declare class CustomFieldDefinitionService implements DefinitionSource, CustomFieldDefinitionApplyApi {
+    private readonly emFactory;
+    private readonly cache;
+    private readonly commandBus;
+    /** Set post-construction to break the definition⇄value service cycle (used by change guards). */
+    private valueService?;
+    constructor(emFactory: () => EntityManager, cache: CustomFieldDefinitionsCache, commandBus: CommandBus);
+    setValueService(v: CustomFieldValueService): void;
+    /** Live definitions (with options) for one entity type, cached per type. */
+    listForEntity(entityType: SupportedEntityType): Promise<CachedDefinition[]>;
+    /**
+     * The same list, past the cache, and every other process's cache with it
+     * (D-97.1).
+     *
+     * A consumer that composes its own rows against these definitions is the only
+     * party that can *detect* a stale entry — it knows what its rows say — and
+     * this module is the only one that may *resolve* it, because the cache is its
+     * own. The invalidation is the same fan-out a committed definition Command
+     * publishes, so the reload converges every process rather than only this one.
+     *
+     * This is what `catalog` used to do by calling `publishInvalidate` through an
+     * optional widening of the read port, which the `lazyPort` proxy made
+     * always-truthy and therefore always wrong when the real provider lacked it.
+     */
+    listForEntityFresh(entityType: SupportedEntityType): Promise<CachedDefinition[]>;
+    private loadForEntity;
+    /** All definitions across every (or one) entity type, options embedded. */
+    listAll(entityType?: SupportedEntityType): Promise<CachedDefinition[]>;
+    getById(id: string): Promise<CachedDefinition | null>;
+    create(input: CreateCustomFieldDefinitionRequest): Promise<CustomFieldDefinition>;
+    update(id: string, patch: UpdateCustomFieldDefinitionRequest): Promise<CustomFieldDefinition>;
+    delete(id: string): Promise<void>;
+    createOption(definitionId: string, input: CustomFieldOptionDto): Promise<CustomFieldOption>;
+    updateOption(definitionId: string, optionId: string, patch: Partial<Pick<CustomFieldOptionDto, 'label' | 'labelDefault' | 'isDefault' | 'sortOrder'>>): Promise<CustomFieldOption>;
+    deleteOption(definitionId: string, optionId: string): Promise<void>;
+    applyCreate(em: EntityManager, input: CreateCustomFieldDefinitionRequest): Promise<CustomFieldDefinitionRecord>;
+    applyUpdate(em: EntityManager, id: string, patch: UpdateCustomFieldDefinitionRequest): Promise<CustomFieldDefinitionRecord>;
+    applyRenameKey(em: EntityManager, id: string, expectedKey: string, newKey: string): Promise<CustomFieldDefinitionRecord>;
+    applyDelete(em: EntityManager, id: string): Promise<void>;
+    applyCreateOption(em: EntityManager, definitionId: string, input: CustomFieldOptionDto): Promise<CustomFieldOptionRecord>;
+    applyUpdateOption(em: EntityManager, definitionId: string, optionId: string, patch: Partial<Pick<CustomFieldOptionDto, 'label' | 'labelDefault' | 'isDefault' | 'sortOrder'>>): Promise<CustomFieldOptionRecord>;
+    applyDeleteOption(em: EntityManager, definitionId: string, optionId: string): Promise<void>;
+    /** Post-commit cache fan-out for apply-seam callers (also used internally after every command). */
+    publishInvalidate(entityType: SupportedEntityType): Promise<void>;
+}
+//# sourceMappingURL=custom-field-definition.service.d.ts.map

package/dist/backend/services/custom-field-definition.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-definition.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/custom-field-definition.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,kCAAkC,EAClC,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAE9E,OAAO,KAAK,EACV,2BAA2B,EAC3B,gBAAgB,EACjB,MAAM,qCAAqC,CAAC;AAS7C,OAAO,EASL,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAK5C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAOxE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAI1E,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAItC;;;;;;;;;;GAUG;AACH,qBAAa,4BAA6B,YAAW,gBAAgB,EAAE,6BAA6B;IAKhG,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN7B,iGAAiG;IACjG,OAAO,CAAC,YAAY,CAAC,CAA0B;gBAG5B,SAAS,EAAE,MAAM,aAAa,EAC9B,KAAK,EAAE,2BAA2B,EAClC,UAAU,EAAE,UAAU;IAGzC,eAAe,CAAC,CAAC,EAAE,uBAAuB,GAAG,IAAI;IAMjD,4EAA4E;IACtE,aAAa,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKjF;;;;;;;;;;;;;OAaG;IACG,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAMxE,aAAa;IAyB3B,2EAA2E;IACrE,OAAO,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAkBtE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAcrD,MAAM,CAAC,KAAK,EAAE,kCAAkC,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiBjF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kCAAkC,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAmB7F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjC,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAW3F,YAAY,CAChB,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;IAQvB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BnE,WAAW,CACf,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,2BAA2B,CAAC;IAIjC,WAAW,CACf,EAAE,EAAE,aAAa,EACjB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,2BAA2B,CAAC;IAMjC,cAAc,CAClB,EAAE,EAAE,aAAa,EACjB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,2BAA2B,CAAC;IAMjC,WAAW,CAAC,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,iBAAiB,CACrB,EAAE,EAAE,aAAa,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,uBAAuB,CAAC;IAI7B,iBAAiB,CACrB,EAAE,EAAE,aAAa,EACjB,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,uBAAuB,CAAC;IAI7B,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjG,mGAAmG;IAC7F,iBAAiB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxE"}

package/dist/backend/services/custom-field-definition.service.js

@@ -0,0 +1,205 @@
+import { CustomFieldDefinition } from '../entities/custom-field-definition.entity.js';
+import { CustomFieldOption } from '../entities/custom-field-option.entity.js';
+import { isSupportedEntityType } from './custom-field-registry.js';
+import { createDefinitionCommand, createOptionCommand, deleteDefinitionCommand, deleteOptionCommand, updateDefinitionCommand, updateOptionCommand, } from '../commands/definition-commands.js';
+import { applyCreateDefinition, applyCreateOption, applyDeleteDefinition, applyDeleteOption, applyRenameDefinitionKey, applyUpdateDefinition, applyUpdateOption, assertOptionsRule, CustomFieldDefinitionError, } from './custom-field-definition-apply.js';
+import { toCustomFieldDefinitionRecord, toCustomFieldOptionRecord, } from './custom-field-read-port.js';
+// Feature 061 — the error class moved next to the shared apply functions;
+// re-exported here so existing imports keep working.
+export { CustomFieldDefinitionError };
+const SELECT_TYPES = new Set(['select', 'multiselect']);
+/**
+ * CustomFieldDefinitionService (feature 055) — CRUD over definitions and options.
+ *
+ * All mutations run through the Command Bus (Principle XIII); the bus writes the
+ * audit entry, so this service never calls the audit writer by hand. Reads are
+ * served from the per-`entityType` cache and every committed mutation publishes a
+ * cross-process invalidation. Implements {@link DefinitionSource} so the value
+ * service can validate host writes against the live definitions, and
+ * {@link CustomFieldDefinitionApplyApi} so host modules can mutate definitions
+ * co-transactionally with their own data (feature 061).
+ */
+export class CustomFieldDefinitionService {
+    emFactory;
+    cache;
+    commandBus;
+    /** Set post-construction to break the definition⇄value service cycle (used by change guards). */
+    valueService;
+    constructor(emFactory, cache, commandBus) {
+        this.emFactory = emFactory;
+        this.cache = cache;
+        this.commandBus = commandBus;
+    }
+    setValueService(v) {
+        this.valueService = v;
+    }
+    // ---- Reads --------------------------------------------------------------
+    /** Live definitions (with options) for one entity type, cached per type. */
+    async listForEntity(entityType) {
+        if (!isSupportedEntityType(entityType))
+            return [];
+        return this.cache.getForEntity(entityType, () => this.loadForEntity(entityType));
+    }
+    /**
+     * The same list, past the cache, and every other process's cache with it
+     * (D-97.1).
+     *
+     * A consumer that composes its own rows against these definitions is the only
+     * party that can *detect* a stale entry — it knows what its rows say — and
+     * this module is the only one that may *resolve* it, because the cache is its
+     * own. The invalidation is the same fan-out a committed definition Command
+     * publishes, so the reload converges every process rather than only this one.
+     *
+     * This is what `catalog` used to do by calling `publishInvalidate` through an
+     * optional widening of the read port, which the `lazyPort` proxy made
+     * always-truthy and therefore always wrong when the real provider lacked it.
+     */
+    async listForEntityFresh(entityType) {
+        if (!isSupportedEntityType(entityType))
+            return [];
+        await this.cache.publishInvalidate(entityType);
+        return this.listForEntity(entityType);
+    }
+    async loadForEntity(entityType) {
+        const em = this.emFactory();
+        const definitions = await em.find(CustomFieldDefinition, { entityType }, { orderBy: { sortOrder: 'asc', key: 'asc' } });
+        if (definitions.length === 0)
+            return [];
+        const options = await em.find(CustomFieldOption, { definitionId: { $in: definitions.map((d) => d.id) } }, { orderBy: { sortOrder: 'asc' } });
+        const byDef = new Map();
+        for (const o of options) {
+            const list = byDef.get(o.definitionId) ?? [];
+            list.push(o);
+            byDef.set(o.definitionId, list);
+        }
+        return definitions.map((definition) => ({
+            definition,
+            options: byDef.get(definition.id) ?? [],
+        }));
+    }
+    /** All definitions across every (or one) entity type, options embedded. */
+    async listAll(entityType) {
+        if (entityType)
+            return this.listForEntity(entityType);
+        const em = this.emFactory();
+        const definitions = await em.find(CustomFieldDefinition, {}, { orderBy: { entityType: 'asc', sortOrder: 'asc', key: 'asc' } });
+        const options = await em.find(CustomFieldOption, {}, { orderBy: { sortOrder: 'asc' } });
+        const byDef = new Map();
+        for (const o of options) {
+            const list = byDef.get(o.definitionId) ?? [];
+            list.push(o);
+            byDef.set(o.definitionId, list);
+        }
+        return definitions.map((definition) => ({ definition, options: byDef.get(definition.id) ?? [] }));
+    }
+    async getById(id) {
+        const em = this.emFactory();
+        const definition = await em.findOne(CustomFieldDefinition, { id });
+        if (!definition)
+            return null;
+        const options = await em.find(CustomFieldOption, { definitionId: id }, { orderBy: { sortOrder: 'asc' } });
+        return { definition, options };
+    }
+    // ---- Mutations (via Command Bus) ----------------------------------------
+    async create(input) {
+        if (!isSupportedEntityType(input.entityType)) {
+            throw new CustomFieldDefinitionError('entity_type_unknown', `Unknown entity type "${input.entityType}".`);
+        }
+        assertOptionsRule(input.valueType, input.options);
+        const existing = await this.emFactory().findOne(CustomFieldDefinition, {
+            entityType: input.entityType,
+            key: input.key,
+        });
+        if (existing) {
+            throw new CustomFieldDefinitionError('duplicate_key', `A field "${input.key}" already exists on ${input.entityType}.`);
+        }
+        const def = await this.commandBus.run(createDefinitionCommand(input));
+        await this.cache.publishInvalidate(input.entityType);
+        return def;
+    }
+    async update(id, patch) {
+        const current = await this.emFactory().findOne(CustomFieldDefinition, { id });
+        if (!current)
+            throw new CustomFieldDefinitionError('not_found', `Custom field ${id} not found.`);
+        // FR-010: changing valueType while values exist is rejected.
+        if (patch.valueType !== undefined && patch.valueType !== current.valueType && this.valueService) {
+            const inUse = await this.valueService.hasStoredValues(this.emFactory(), current.entityType, current.key);
+            if (inUse) {
+                throw new CustomFieldDefinitionError('value_type_locked', `Cannot change the value type of "${current.key}" while records hold values. Clear them first.`);
+            }
+        }
+        const def = await this.commandBus.run(updateDefinitionCommand(id, patch, this.valueService));
+        await this.cache.publishInvalidate(current.entityType);
+        return def;
+    }
+    async delete(id) {
+        const current = await this.emFactory().findOne(CustomFieldDefinition, { id });
+        if (!current)
+            throw new CustomFieldDefinitionError('not_found', `Custom field ${id} not found.`);
+        await this.commandBus.run(deleteDefinitionCommand(id));
+        await this.cache.publishInvalidate(current.entityType);
+    }
+    async createOption(definitionId, input) {
+        const def = await this.emFactory().findOne(CustomFieldDefinition, { id: definitionId });
+        if (!def)
+            throw new CustomFieldDefinitionError('not_found', `Custom field ${definitionId} not found.`);
+        if (!SELECT_TYPES.has(def.valueType)) {
+            throw new CustomFieldDefinitionError('options_forbidden', `Field "${def.key}" does not take options.`);
+        }
+        const opt = await this.commandBus.run(createOptionCommand(definitionId, input));
+        await this.cache.publishInvalidate(def.entityType);
+        return opt;
+    }
+    async updateOption(definitionId, optionId, patch) {
+        const def = await this.emFactory().findOne(CustomFieldDefinition, { id: definitionId });
+        if (!def)
+            throw new CustomFieldDefinitionError('not_found', `Custom field ${definitionId} not found.`);
+        const opt = await this.commandBus.run(updateOptionCommand(definitionId, optionId, patch));
+        await this.cache.publishInvalidate(def.entityType);
+        return opt;
+    }
+    async deleteOption(definitionId, optionId) {
+        const def = await this.emFactory().findOne(CustomFieldDefinition, { id: definitionId });
+        if (!def)
+            throw new CustomFieldDefinitionError('not_found', `Custom field ${definitionId} not found.`);
+        const option = await this.emFactory().findOne(CustomFieldOption, { id: optionId });
+        if (!option)
+            throw new CustomFieldDefinitionError('not_found', `Option ${optionId} not found.`);
+        // FR-010: an in-use option cannot be removed while records reference it.
+        if (this.valueService) {
+            const inUse = await this.valueService.isOptionInUse(this.emFactory(), def.entityType, def.key, option.value);
+            if (inUse) {
+                throw new CustomFieldDefinitionError('option_in_use', `Option "${option.value}" is in use and cannot be removed.`);
+            }
+        }
+        await this.commandBus.run(deleteOptionCommand(definitionId, optionId, this.valueService));
+        await this.cache.publishInvalidate(def.entityType);
+    }
+    // ---- Transactional apply seam (feature 061, CustomFieldDefinitionApplyApi)
+    async applyCreate(em, input) {
+        return toCustomFieldDefinitionRecord(await applyCreateDefinition(em, input));
+    }
+    async applyUpdate(em, id, patch) {
+        return toCustomFieldDefinitionRecord(await applyUpdateDefinition(em, id, patch, this.valueService));
+    }
+    async applyRenameKey(em, id, expectedKey, newKey) {
+        return toCustomFieldDefinitionRecord(await applyRenameDefinitionKey(em, id, expectedKey, newKey));
+    }
+    async applyDelete(em, id) {
+        await applyDeleteDefinition(em, id);
+    }
+    async applyCreateOption(em, definitionId, input) {
+        return toCustomFieldOptionRecord(await applyCreateOption(em, definitionId, input));
+    }
+    async applyUpdateOption(em, definitionId, optionId, patch) {
+        return toCustomFieldOptionRecord(await applyUpdateOption(em, definitionId, optionId, patch));
+    }
+    async applyDeleteOption(em, definitionId, optionId) {
+        await applyDeleteOption(em, definitionId, optionId, this.valueService);
+    }
+    /** Post-commit cache fan-out for apply-seam callers (also used internally after every command). */
+    async publishInvalidate(entityType) {
+        await this.cache.publishInvalidate(entityType);
+    }
+}
+//# sourceMappingURL=custom-field-definition.service.js.map

package/dist/backend/services/custom-field-definition.service.js.map

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