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

package/dist/backend/services/custom-field-definitions-cache.d.ts

@@ -0,0 +1,46 @@
+import type { Redis } from 'ioredis';
+import type { CustomFieldDefinition } from '../entities/custom-field-definition.entity.js';
+import type { CustomFieldOption } from '../entities/custom-field-option.entity.js';
+/** Redis pub/sub channel that fans definition changes across processes (API + worker). */
+export declare const CUSTOM_FIELDS_CHANGED_CHANNEL = "b2b:custom_fields:definitions-changed";
+/** Degraded-mode fallback: drop cached entries after this age if pub/sub is unavailable. */
+export declare const CUSTOM_FIELDS_CACHE_TTL_MS = 5000;
+/** A definition with its options, as cached per entity type. */
+export interface CachedDefinition {
+    readonly definition: CustomFieldDefinition;
+    readonly options: CustomFieldOption[];
+}
+/**
+ * Per-`entityType` in-process cache of custom-field definitions (feature 055).
+ *
+ * The hot path — validating a host write and rendering the admin form — reads
+ * definitions frequently, so they are cached in memory and invalidated
+ * cross-process on the {@link CUSTOM_FIELDS_CHANGED_CHANNEL} Redis channel
+ * (registry-cache pattern). A definition/option Command publishes on commit;
+ * every process's subscriber drops the affected entity-type entry. If the
+ * subscription connection drops, entries expire after {@link CUSTOM_FIELDS_CACHE_TTL_MS}.
+ *
+ * `now()` is injectable so tests can advance time without a real clock.
+ */
+export declare class CustomFieldDefinitionsCache {
+    private readonly publisher?;
+    private readonly now;
+    private readonly entries;
+    private subscriber;
+    constructor(publisher?: Redis | undefined, now?: () => number);
+    /** Read cached definitions for an entity type, loading + caching on a miss or a stale entry. */
+    getForEntity(entityType: string, loader: () => Promise<CachedDefinition[]>): Promise<CachedDefinition[]>;
+    /** Drop the local cache for one entity type (or all when omitted). */
+    invalidateLocal(entityType?: string): void;
+    /**
+     * Invalidate locally AND fan the change out to other processes. Called by the
+     * definition service after a Command commits. Publish failures are swallowed —
+     * the TTL fallback keeps other processes eventually-consistent.
+     */
+    publishInvalidate(entityType: string): Promise<void>;
+    /** Arm the cross-process subscriber. Idempotent. */
+    start(redisSubscriber: Redis): Promise<void>;
+    /** Apply an invalidation message. Exposed for tests + a shared-subscriber wiring. */
+    handleMessage(message: string): void;
+}
+//# sourceMappingURL=custom-field-definitions-cache.d.ts.map

package/dist/backend/services/custom-field-definitions-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-definitions-cache.d.ts","sourceRoot":"","sources":["../../../src/backend/services/custom-field-definitions-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,0FAA0F;AAC1F,eAAO,MAAM,6BAA6B,0CAA0C,CAAC;AACrF,4FAA4F;AAC5F,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;CACvC;AAOD;;;;;;;;;;;GAWG;AACH,qBAAa,2BAA2B;IAKpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,UAAU,CAAsB;gBAGrB,SAAS,CAAC,EAAE,KAAK,YAAA,EACjB,GAAG,GAAE,MAAM,MAAyB;IAGvD,gGAAgG;IAC1F,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,GACxC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAU9B,sEAAsE;IACtE,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1C;;;;OAIG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1D,oDAAoD;IAC9C,KAAK,CAAC,eAAe,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD,qFAAqF;IACrF,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAQrC"}

package/dist/backend/services/custom-field-definitions-cache.js

@@ -0,0 +1,82 @@
+/** Redis pub/sub channel that fans definition changes across processes (API + worker). */
+export const CUSTOM_FIELDS_CHANGED_CHANNEL = 'b2b:custom_fields:definitions-changed';
+/** Degraded-mode fallback: drop cached entries after this age if pub/sub is unavailable. */
+export const CUSTOM_FIELDS_CACHE_TTL_MS = 5_000;
+/**
+ * Per-`entityType` in-process cache of custom-field definitions (feature 055).
+ *
+ * The hot path — validating a host write and rendering the admin form — reads
+ * definitions frequently, so they are cached in memory and invalidated
+ * cross-process on the {@link CUSTOM_FIELDS_CHANGED_CHANNEL} Redis channel
+ * (registry-cache pattern). A definition/option Command publishes on commit;
+ * every process's subscriber drops the affected entity-type entry. If the
+ * subscription connection drops, entries expire after {@link CUSTOM_FIELDS_CACHE_TTL_MS}.
+ *
+ * `now()` is injectable so tests can advance time without a real clock.
+ */
+export class CustomFieldDefinitionsCache {
+    publisher;
+    now;
+    entries = new Map();
+    subscriber = null;
+    constructor(publisher, now = () => Date.now()) {
+        this.publisher = publisher;
+        this.now = now;
+    }
+    /** Read cached definitions for an entity type, loading + caching on a miss or a stale entry. */
+    async getForEntity(entityType, loader) {
+        const hit = this.entries.get(entityType);
+        if (hit && this.now() - hit.loadedAt < CUSTOM_FIELDS_CACHE_TTL_MS) {
+            return hit.value;
+        }
+        const value = await loader();
+        this.entries.set(entityType, { value, loadedAt: this.now() });
+        return value;
+    }
+    /** Drop the local cache for one entity type (or all when omitted). */
+    invalidateLocal(entityType) {
+        if (entityType === undefined)
+            this.entries.clear();
+        else
+            this.entries.delete(entityType);
+    }
+    /**
+     * Invalidate locally AND fan the change out to other processes. Called by the
+     * definition service after a Command commits. Publish failures are swallowed —
+     * the TTL fallback keeps other processes eventually-consistent.
+     */
+    async publishInvalidate(entityType) {
+        this.invalidateLocal(entityType);
+        if (!this.publisher)
+            return;
+        try {
+            await this.publisher.publish(CUSTOM_FIELDS_CHANGED_CHANNEL, JSON.stringify({ entityType }));
+        }
+        catch {
+            // Degraded: rely on the TTL fallback.
+        }
+    }
+    /** Arm the cross-process subscriber. Idempotent. */
+    async start(redisSubscriber) {
+        if (this.subscriber)
+            return;
+        this.subscriber = redisSubscriber;
+        await this.subscriber.subscribe(CUSTOM_FIELDS_CHANGED_CHANNEL);
+        this.subscriber.on('message', (channel, message) => {
+            if (channel !== CUSTOM_FIELDS_CHANGED_CHANNEL)
+                return;
+            this.handleMessage(message);
+        });
+    }
+    /** Apply an invalidation message. Exposed for tests + a shared-subscriber wiring. */
+    handleMessage(message) {
+        try {
+            const parsed = JSON.parse(message);
+            this.invalidateLocal(parsed.entityType);
+        }
+        catch {
+            this.invalidateLocal();
+        }
+    }
+}
+//# sourceMappingURL=custom-field-definitions-cache.js.map

package/dist/backend/services/custom-field-definitions-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-definitions-cache.js","sourceRoot":"","sources":["../../../src/backend/services/custom-field-definitions-cache.ts"],"names":[],"mappings":"AAIA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,6BAA6B,GAAG,uCAAuC,CAAC;AACrF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAahD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,2BAA2B;IAKnB;IACA;IALF,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACjD,UAAU,GAAiB,IAAI,CAAC;IAExC,YACmB,SAAiB,EACjB,MAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QADpC,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAiC;IACpD,CAAC;IAEJ,gGAAgG;IAChG,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,MAAyC;QAEzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,QAAQ,GAAG,0BAA0B,EAAE,CAAC;YAClE,OAAO,GAAG,CAAC,KAAK,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sEAAsE;IACtE,eAAe,CAAC,UAAmB;QACjC,IAAI,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;;YAC9C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,UAAkB;QACxC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,6BAA6B,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QAC9F,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,KAAK,CAAC,eAAsB;QAChC,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,eAAe,CAAC;QAClC,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;YACjD,IAAI,OAAO,KAAK,6BAA6B;gBAAE,OAAO;YACtD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qFAAqF;IACrF,aAAa,CAAC,OAAe;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;YAC9D,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/backend/services/custom-field-read-port.d.ts

@@ -0,0 +1,61 @@
+import type { CustomFieldDefinitionReadPort, CustomFieldDefinitionRecord, CustomFieldDefinitionWithOptions, CustomFieldOptionRecord, SupportedEntityType } from '@endora-commerce/contracts';
+import type { CustomFieldDefinition } from '../entities/custom-field-definition.entity.js';
+import type { CustomFieldOption } from '../entities/custom-field-option.entity.js';
+import type { CachedDefinition } from './custom-field-definitions-cache.js';
+import type { DefinitionSource } from './custom-field-value.service.js';
+/**
+ * What the read port needs beyond {@link DefinitionSource}: the cache-bypassing
+ * read D-97.1 publishes. `CustomFieldDefinitionService` satisfies both; the
+ * interface stays here so this adapter has no concrete dependency on it.
+ */
+export interface FreshDefinitionSource extends DefinitionSource {
+    listForEntityFresh(entityType: SupportedEntityType): Promise<CachedDefinition[]>;
+    /**
+     * Feature 080, T053(b) — the single-definition read the apply seam used to
+     * answer for `catalog`. It returns `CachedDefinition`, which carries the two
+     * ORM entities, which is precisely what the adapter below maps away.
+     */
+    getById(id: string): Promise<CachedDefinition | null>;
+}
+/**
+ * The published face of `custom_fields`' definition read model (feature 075,
+ * Phase P).
+ *
+ * `DefinitionSource` already had the right *shape* — one question, taken as an
+ * interface so the value service has no concrete dependency on the definition
+ * service. What it did not have was a published one: `CachedDefinition` holds
+ * the two ORM entities, so a consumer typing itself against it imports both
+ * classes, which is what seven modules do today.
+ *
+ * The mapping is per definition rather than per read: the underlying call
+ * rides the per-entity in-process cache, so the entities are already in
+ * memory, and copying twenty fields off them costs nothing measurable against
+ * the query it replaces in each consumer.
+ */
+export declare class CustomFieldDefinitionReadService implements CustomFieldDefinitionReadPort {
+    private readonly source;
+    constructor(source: FreshDefinitionSource);
+    listForEntity(entityType: SupportedEntityType): Promise<CustomFieldDefinitionWithOptions[]>;
+    /**
+     * D-97.1 — the freshness guarantee, expressed as a read.
+     *
+     * The cache, its local drop and its cross-process fan-out never leave this
+     * module: a consumer asks for definitions it can trust, not for somebody
+     * else's cache to be flushed.
+     */
+    listForEntityFresh(entityType: SupportedEntityType): Promise<CustomFieldDefinitionWithOptions[]>;
+    /**
+     * Feature 080, T053(b) — the committed-state read of one definition.
+     *
+     * `catalog`'s attribute Commands took this off the apply seam until now, and
+     * the seam handed back the managed entities: a record-shaped type over
+     * `CustomFieldDefinition` and `CustomFieldOption`, which are structurally
+     * assignable to the published records, so nothing complained. The mapping
+     * below is what makes the published type true.
+     */
+    getById(id: string): Promise<CustomFieldDefinitionWithOptions | null>;
+}
+export declare function toDefinitionWithOptions(cached: CachedDefinition): CustomFieldDefinitionWithOptions;
+export declare function toCustomFieldDefinitionRecord(definition: CustomFieldDefinition): CustomFieldDefinitionRecord;
+export declare function toCustomFieldOptionRecord(option: CustomFieldOption): CustomFieldOptionRecord;
+//# sourceMappingURL=custom-field-read-port.d.ts.map

package/dist/backend/services/custom-field-read-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-read-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/custom-field-read-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAChC,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACjF;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACvD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gCAAiC,YAAW,6BAA6B;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,qBAAqB;IAEpD,aAAa,CACjB,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAAC,gCAAgC,EAAE,CAAC;IAI9C;;;;;;OAMG;IACG,kBAAkB,CACtB,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAAC,gCAAgC,EAAE,CAAC;IAI9C;;;;;;;;OAQG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC;CAI5E;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,GACvB,gCAAgC,CAKlC;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,qBAAqB,GAChC,2BAA2B,CAc7B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,uBAAuB,CAY5F"}

package/dist/backend/services/custom-field-read-port.js

@@ -0,0 +1,82 @@
+/**
+ * The published face of `custom_fields`' definition read model (feature 075,
+ * Phase P).
+ *
+ * `DefinitionSource` already had the right *shape* — one question, taken as an
+ * interface so the value service has no concrete dependency on the definition
+ * service. What it did not have was a published one: `CachedDefinition` holds
+ * the two ORM entities, so a consumer typing itself against it imports both
+ * classes, which is what seven modules do today.
+ *
+ * The mapping is per definition rather than per read: the underlying call
+ * rides the per-entity in-process cache, so the entities are already in
+ * memory, and copying twenty fields off them costs nothing measurable against
+ * the query it replaces in each consumer.
+ */
+export class CustomFieldDefinitionReadService {
+    source;
+    constructor(source) {
+        this.source = source;
+    }
+    async listForEntity(entityType) {
+        return (await this.source.listForEntity(entityType)).map(toDefinitionWithOptions);
+    }
+    /**
+     * D-97.1 — the freshness guarantee, expressed as a read.
+     *
+     * The cache, its local drop and its cross-process fan-out never leave this
+     * module: a consumer asks for definitions it can trust, not for somebody
+     * else's cache to be flushed.
+     */
+    async listForEntityFresh(entityType) {
+        return (await this.source.listForEntityFresh(entityType)).map(toDefinitionWithOptions);
+    }
+    /**
+     * Feature 080, T053(b) — the committed-state read of one definition.
+     *
+     * `catalog`'s attribute Commands took this off the apply seam until now, and
+     * the seam handed back the managed entities: a record-shaped type over
+     * `CustomFieldDefinition` and `CustomFieldOption`, which are structurally
+     * assignable to the published records, so nothing complained. The mapping
+     * below is what makes the published type true.
+     */
+    async getById(id) {
+        const cached = await this.source.getById(id);
+        return cached ? toDefinitionWithOptions(cached) : null;
+    }
+}
+export function toDefinitionWithOptions(cached) {
+    return {
+        definition: toCustomFieldDefinitionRecord(cached.definition),
+        options: cached.options.map(toCustomFieldOptionRecord),
+    };
+}
+export function toCustomFieldDefinitionRecord(definition) {
+    return {
+        id: definition.id,
+        entityType: definition.entityType,
+        key: definition.key,
+        label: definition.label ?? {},
+        labelDefault: definition.labelDefault,
+        valueType: definition.valueType,
+        required: definition.required,
+        sortOrder: definition.sortOrder,
+        config: definition.config ?? {},
+        createdAt: definition.createdAt,
+        updatedAt: definition.updatedAt,
+    };
+}
+export function toCustomFieldOptionRecord(option) {
+    return {
+        id: option.id,
+        definitionId: option.definitionId,
+        value: option.value,
+        label: option.label ?? {},
+        labelDefault: option.labelDefault,
+        isDefault: option.isDefault,
+        sortOrder: option.sortOrder,
+        createdAt: option.createdAt,
+        updatedAt: option.updatedAt,
+    };
+}
+//# sourceMappingURL=custom-field-read-port.js.map

package/dist/backend/services/custom-field-read-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-read-port.js","sourceRoot":"","sources":["../../../src/backend/services/custom-field-read-port.ts"],"names":[],"mappings":"AA2BA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,gCAAgC;IACd;IAA7B,YAA6B,MAA6B;QAA7B,WAAM,GAAN,MAAM,CAAuB;IAAG,CAAC;IAE9D,KAAK,CAAC,aAAa,CACjB,UAA+B;QAE/B,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,kBAAkB,CACtB,UAA+B;QAE/B,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAwB;IAExB,OAAO;QACL,UAAU,EAAE,6BAA6B,CAAC,MAAM,CAAC,UAAU,CAAC;QAC5D,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,UAAiC;IAEjC,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE;QAC7B,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;QAC/B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,SAAS,EAAE,UAAU,CAAC,SAAS;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAyB;IACjE,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC"}

package/dist/backend/services/custom-field-registry.d.ts

@@ -0,0 +1,41 @@
+import type { SupportedEntityType } from '@endora-commerce/contracts';
+/**
+ * Supported-entity registry (feature 055, FR-001/FR-006).
+ *
+ * The single, extensible list of host entity types custom fields may attach to.
+ * The admin definition editor and the value validator both consult this map;
+ * adding an entity is one entry here plus wiring the host's read/write path
+ * (see specs/055-custom-fields-layer/quickstart.md). The generic core stays
+ * entity-agnostic — this map carries no host-specific capability logic.
+ *
+ * `orgOwned` is informational (it drives cross-tenant test selection). Actual
+ * tenant isolation is enforced by each host ENTITY's own scope decorator
+ * (Principle XI), because a custom-field value is a JSONB column ON the host
+ * row — never by this flag.
+ */
+export interface SupportedEntityMeta {
+    /** i18n key for the operator-facing entity-type label. */
+    readonly labelKey: string;
+    /** True when the host entity is tenant-scoped (org/customer). Category & Organization are global. */
+    readonly orgOwned: boolean;
+    /**
+     * Optional host-managed marker (feature 061). When present, definitions of
+     * this entity type are created/edited/deleted ONLY by the named host
+     * module's own surface; the generic admin mutation routes refuse writes with
+     * 409 `host_managed` and the generic UI renders the type read-only with a
+     * link to `route`. Service-level `apply*` calls are NOT affected — they are
+     * the host's path. Generic: any future host may claim it; consumers check
+     * only for the marker's presence, never which module manages.
+     */
+    readonly managedBy?: {
+        readonly moduleId: string;
+        readonly labelKey: string;
+        readonly route: string;
+    };
+}
+export declare const SUPPORTED_ENTITIES: Record<SupportedEntityType, SupportedEntityMeta>;
+/** All registered entity-type codes. */
+export declare const SUPPORTED_ENTITY_TYPES: SupportedEntityType[];
+/** True when `value` is a registered, live entity type. Definitions for unlisted types are inert. */
+export declare function isSupportedEntityType(value: string): value is SupportedEntityType;
+//# sourceMappingURL=custom-field-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/custom-field-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qGAAqG;IACrG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAgB/E,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,sBAAsB,EAAsC,mBAAmB,EAAE,CAAC;AAE/F,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,mBAAmB,CAEjF"}

package/dist/backend/services/custom-field-registry.js

@@ -0,0 +1,24 @@
+export const SUPPORTED_ENTITIES = {
+    category: { labelKey: 'customFields.entity.category', orgOwned: false },
+    order: { labelKey: 'customFields.entity.order', orgOwned: true },
+    organization: { labelKey: 'customFields.entity.organization', orgOwned: false },
+    customer: { labelKey: 'customFields.entity.customer', orgOwned: true },
+    quote_request: { labelKey: 'customFields.entity.quoteRequest', orgOwned: true },
+    product: {
+        labelKey: 'customFields.entity.product',
+        // Definitions are platform-global; product rows are catalog data, not org-tenant rows.
+        orgOwned: false,
+        managedBy: {
+            moduleId: 'catalog',
+            labelKey: 'customFields.managedBy.catalogAttributes',
+            route: '/catalog/attributes',
+        },
+    },
+};
+/** All registered entity-type codes. */
+export const SUPPORTED_ENTITY_TYPES = Object.keys(SUPPORTED_ENTITIES);
+/** True when `value` is a registered, live entity type. Definitions for unlisted types are inert. */
+export function isSupportedEntityType(value) {
+    return Object.prototype.hasOwnProperty.call(SUPPORTED_ENTITIES, value);
+}
+//# sourceMappingURL=custom-field-registry.js.map

package/dist/backend/services/custom-field-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-registry.js","sourceRoot":"","sources":["../../../src/backend/services/custom-field-registry.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAC,MAAM,kBAAkB,GAAqD;IAClF,QAAQ,EAAE,EAAE,QAAQ,EAAE,8BAA8B,EAAE,QAAQ,EAAE,KAAK,EAAE;IACvE,KAAK,EAAE,EAAE,QAAQ,EAAE,2BAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE;IAChE,YAAY,EAAE,EAAE,QAAQ,EAAE,kCAAkC,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC/E,QAAQ,EAAE,EAAE,QAAQ,EAAE,8BAA8B,EAAE,QAAQ,EAAE,IAAI,EAAE;IACtE,aAAa,EAAE,EAAE,QAAQ,EAAE,kCAAkC,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC/E,OAAO,EAAE;QACP,QAAQ,EAAE,6BAA6B;QACvC,uFAAuF;QACvF,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE;YACT,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,0CAA0C;YACpD,KAAK,EAAE,qBAAqB;SAC7B;KACF;CACF,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAA0B,CAAC;AAE/F,qGAAqG;AACrG,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AACzE,CAAC"}

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

@@ -0,0 +1,56 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CustomFieldValidationError as CustomFieldValidationErrorDto, SupportedEntityType } from '@endora-commerce/contracts';
+import type { CachedDefinition } from './custom-field-definitions-cache.js';
+/**
+ * Provides the live definitions (with options) for an entity type. Implemented
+ * by `CustomFieldDefinitionService`; taken as an interface here so the value
+ * service has no concrete dependency on the definition service (and is trivially
+ * unit-testable with a stub).
+ */
+export interface DefinitionSource {
+    listForEntity(entityType: SupportedEntityType): Promise<CachedDefinition[]>;
+}
+/** Thrown by {@link CustomFieldValueService.validateAndMerge}; serialized as HTTP 422 (FR-004). */
+export declare class CustomFieldValidationError extends Error {
+    readonly errors: CustomFieldValidationErrorDto[];
+    constructor(errors: CustomFieldValidationErrorDto[]);
+}
+/**
+ * CustomFieldValueService (feature 055) — validates a host record's custom-field
+ * bag against its definitions and strips dormant keys on read.
+ *
+ * It performs NO database write and NO audit: the host persists its own record
+ * and (per Principle XIII) audits its own write. This service only validates the
+ * incoming values and returns the merged bag — keeping module boundaries intact
+ * (Principle I) and avoiding double-audit (Principle XIII / XIV).
+ */
+export declare class CustomFieldValueService {
+    private readonly definitions;
+    constructor(definitions: DefinitionSource);
+    /**
+     * Validate an incoming patch against the entity's definitions and return the
+     * merged bag to persist. Throws {@link CustomFieldValidationError} with
+     * per-field errors on any violation (FR-004). Unknown patch keys (no matching
+     * definition) are ignored. Dormant keys already in the bag are retained (FR-010).
+     */
+    validateAndMerge(entityType: SupportedEntityType, currentBag: Record<string, unknown>, patch: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Strip keys whose definition no longer exists (dormant values, FR-010 / US2
+     * scenario 4). Hosts call this before returning `customFieldValues` on read.
+     */
+    project(entityType: SupportedEntityType, bag: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Existence probe for definition-change guards (FR-010): is there any host row
+     * with a stored value at `key`? Read-only JSONB introspection on the host table.
+     */
+    hasStoredValues(em: EntityManager, entityType: SupportedEntityType, key: string): Promise<boolean>;
+    /**
+     * Is a specific option value in use for a `select`/`multiselect` field?
+     * (option-removal guard). Known limitation: the flat `->>key` probe does not
+     * see through nested per-language value shapes — a host whose storage nests
+     * values under the key runs its own authoritative in-use checks first; this
+     * probe is defense-in-depth for the flat shapes (feature 061, research §R9).
+     */
+    isOptionInUse(em: EntityManager, entityType: SupportedEntityType, key: string, optionValue: string): Promise<boolean>;
+}
+//# sourceMappingURL=custom-field-value.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"custom-field-value.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/custom-field-value.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,IAAI,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CAC7E;AAED,mGAAmG;AACnG,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,6BAA6B,EAAE;gBAAvC,MAAM,EAAE,6BAA6B,EAAE;CAI7D;AAmBD;;;;;;;;GAQG;AACH,qBAAa,uBAAuB;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,gBAAgB;IAE1D;;;;;OAKG;IACG,gBAAgB,CACpB,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IA+BnC;;;OAGG;IACG,OAAO,CACX,UAAU,EAAE,mBAAmB,EAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUnC;;;OAGG;IACG,eAAe,CACnB,EAAE,EAAE,aAAa,EACjB,UAAU,EAAE,mBAAmB,EAC/B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC;IASnB;;;;;;OAMG;IACG,aAAa,CACjB,EAAE,EAAE,aAAa,EACjB,UAAU,EAAE,mBAAmB,EAC/B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;CAWpB"}

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

@@ -0,0 +1,175 @@
+/** Thrown by {@link CustomFieldValueService.validateAndMerge}; serialized as HTTP 422 (FR-004). */
+export class CustomFieldValidationError extends Error {
+    errors;
+    constructor(errors) {
+        super(`Custom field validation failed (${errors.length} error(s)).`);
+        this.errors = errors;
+        this.name = 'CustomFieldValidationError';
+    }
+}
+/**
+ * Host-table binding for the change-guard probes (read-only introspection,
+ * feature 055; generalized to a per-host `{table, column}` pair by feature 061
+ * — the `product` host stores its value bag in `products.attribute_values`).
+ * Purely a storage binding: no host logic lives here.
+ */
+const HOST_TABLE_BY_ENTITY = {
+    category: { table: 'categories', column: 'custom_field_values' },
+    order: { table: 'orders', column: 'custom_field_values' },
+    organization: { table: 'organizations', column: 'custom_field_values' },
+    customer: { table: 'customer_accounts', column: 'custom_field_values' },
+    quote_request: { table: 'quote_requests', column: 'custom_field_values' },
+    product: { table: 'products', column: 'attribute_values' },
+};
+const DEFAULT_TEXT_MAX = 10_000;
+/**
+ * CustomFieldValueService (feature 055) — validates a host record's custom-field
+ * bag against its definitions and strips dormant keys on read.
+ *
+ * It performs NO database write and NO audit: the host persists its own record
+ * and (per Principle XIII) audits its own write. This service only validates the
+ * incoming values and returns the merged bag — keeping module boundaries intact
+ * (Principle I) and avoiding double-audit (Principle XIII / XIV).
+ */
+export class CustomFieldValueService {
+    definitions;
+    constructor(definitions) {
+        this.definitions = definitions;
+    }
+    /**
+     * Validate an incoming patch against the entity's definitions and return the
+     * merged bag to persist. Throws {@link CustomFieldValidationError} with
+     * per-field errors on any violation (FR-004). Unknown patch keys (no matching
+     * definition) are ignored. Dormant keys already in the bag are retained (FR-010).
+     */
+    async validateAndMerge(entityType, currentBag, patch) {
+        const defs = await this.definitions.listForEntity(entityType);
+        const merged = { ...currentBag };
+        const errors = [];
+        for (const { definition, options } of defs) {
+            const key = definition.key;
+            const inPatch = Object.prototype.hasOwnProperty.call(patch, key);
+            const raw = inPatch ? patch[key] : currentBag[key];
+            if (isEmpty(raw)) {
+                if (definition.required) {
+                    errors.push({ field: key, code: 'missing_required', message: `Field "${key}" is required.` });
+                }
+                else {
+                    delete merged[key];
+                }
+                continue;
+            }
+            const result = coerce(definition.valueType, raw, options);
+            if ('code' in result) {
+                errors.push({ field: key, code: result.code, message: result.message });
+            }
+            else {
+                merged[key] = result.value;
+            }
+        }
+        if (errors.length > 0)
+            throw new CustomFieldValidationError(errors);
+        return merged;
+    }
+    /**
+     * Strip keys whose definition no longer exists (dormant values, FR-010 / US2
+     * scenario 4). Hosts call this before returning `customFieldValues` on read.
+     */
+    async project(entityType, bag) {
+        const defs = await this.definitions.listForEntity(entityType);
+        const live = new Set(defs.map((d) => d.definition.key));
+        const out = {};
+        for (const [k, v] of Object.entries(bag)) {
+            if (live.has(k))
+                out[k] = v;
+        }
+        return out;
+    }
+    /**
+     * Existence probe for definition-change guards (FR-010): is there any host row
+     * with a stored value at `key`? Read-only JSONB introspection on the host table.
+     */
+    async hasStoredValues(em, entityType, key) {
+        const { table, column } = HOST_TABLE_BY_ENTITY[entityType];
+        const rows = await em.getConnection().execute(`select 1 as one from "${table}" where jsonb_exists("${column}", ?) limit 1`, [key]);
+        return rows.length > 0;
+    }
+    /**
+     * Is a specific option value in use for a `select`/`multiselect` field?
+     * (option-removal guard). Known limitation: the flat `->>key` probe does not
+     * see through nested per-language value shapes — a host whose storage nests
+     * values under the key runs its own authoritative in-use checks first; this
+     * probe is defense-in-depth for the flat shapes (feature 061, research §R9).
+     */
+    async isOptionInUse(em, entityType, key, optionValue) {
+        const { table, column } = HOST_TABLE_BY_ENTITY[entityType];
+        const rows = await em.getConnection().execute(`select 1 as one from "${table}" ` +
+            `where "${column}"->>? = ? ` +
+            `or (jsonb_typeof("${column}"->?) = 'array' and "${column}"->? @> to_jsonb(?::text)) ` +
+            `limit 1`, [key, optionValue, key, key, optionValue]);
+        return rows.length > 0;
+    }
+}
+/** A value is "empty" (⇒ absent) when undefined, null, '', or an empty array. */
+function isEmpty(v) {
+    return v === undefined || v === null || v === '' || (Array.isArray(v) && v.length === 0);
+}
+/** Validate + coerce one value by its declared type. Returns the stored value or a typed error. */
+function coerce(valueType, raw, options) {
+    switch (valueType) {
+        case 'text': {
+            if (typeof raw !== 'string')
+                return { code: 'wrong_type', message: 'Expected a text value.' };
+            if (raw.length > DEFAULT_TEXT_MAX)
+                return { code: 'out_of_range', message: 'Text value is too long.' };
+            return { value: raw };
+        }
+        case 'number': {
+            const n = typeof raw === 'number' ? raw : typeof raw === 'string' ? Number(raw) : NaN;
+            if (!Number.isFinite(n))
+                return { code: 'wrong_type', message: 'Expected a number.' };
+            return { value: n };
+        }
+        case 'boolean': {
+            if (typeof raw === 'boolean')
+                return { value: raw };
+            if (raw === 'true')
+                return { value: true };
+            if (raw === 'false')
+                return { value: false };
+            return { code: 'wrong_type', message: 'Expected a boolean.' };
+        }
+        case 'date': {
+            if (typeof raw !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(raw) || Number.isNaN(Date.parse(raw))) {
+                return { code: 'wrong_type', message: 'Expected an ISO date (YYYY-MM-DD).' };
+            }
+            return { value: raw };
+        }
+        case 'select': {
+            if (typeof raw !== 'string')
+                return { code: 'wrong_type', message: 'Expected a single option value.' };
+            if (!options.some((o) => o.value === raw)) {
+                return { code: 'unknown_option', message: `Unknown option "${raw}".` };
+            }
+            return { value: raw };
+        }
+        case 'multiselect': {
+            if (!Array.isArray(raw) || !raw.every((v) => typeof v === 'string')) {
+                return { code: 'wrong_type', message: 'Expected an array of option values.' };
+            }
+            const seen = new Set();
+            for (const v of raw) {
+                if (seen.has(v))
+                    return { code: 'duplicate_option', message: `Duplicate option "${v}".` };
+                seen.add(v);
+                if (!options.some((o) => o.value === v)) {
+                    return { code: 'unknown_option', message: `Unknown option "${v}".` };
+                }
+            }
+            return { value: [...raw] };
+        }
+        default:
+            return { code: 'wrong_type', message: `Unsupported value type "${valueType}".` };
+    }
+}
+//# sourceMappingURL=custom-field-value.service.js.map

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

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