@endora-commerce/mod-dictionaries 0.100.0

package/dist/backend/services/country-service.js

@@ -0,0 +1,193 @@
+// CountryService — feature 017 / T025.
+//
+// Owns the platform-wide Country registry. Same invariants as the legacy
+// LanguageService / CurrencyService (default rotation, at-least-one-active,
+// default-cannot-be-deactivated, immutable code on update) plus FK
+// protection on hard-delete that scans every consumer table named in
+// data-model.md (addresses, taxes, warehouses, organizations registered
+// address JSONB) — through `countryReferenceRegistry` since feature 077's D-87
+// drain, where the scan used to be raw SQL naming those four tables directly.
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Country } from '../entities/country.entity.js';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+export class CountryService {
+    emFactory;
+    invalidateDictionaryCache;
+    auditLog;
+    referenceRegistry;
+    constructor(emFactory, invalidateDictionaryCache, auditLog, 
+    /**
+     * Resolved per call rather than captured: the registry is a singleton this
+     * module owns, but the accessor keeps the constructor honest for the tests
+     * that build the service without one.
+     */
+    referenceRegistry) {
+        this.emFactory = emFactory;
+        this.invalidateDictionaryCache = invalidateDictionaryCache;
+        this.auditLog = auditLog;
+        this.referenceRegistry = referenceRegistry;
+    }
+    #audit(em, action, objectId, stateBefore, stateAfter) {
+        if (this.auditLog) {
+            recordAuditFromContext(this.auditLog, em, {
+                action,
+                objectType: 'country',
+                objectId,
+                stateBefore,
+                stateAfter,
+            });
+        }
+    }
+    async list() {
+        const em = this.emFactory();
+        return em.find(Country, {}, { orderBy: { sortOrder: 'asc', label: 'asc' } });
+    }
+    async listActive() {
+        const em = this.emFactory();
+        return em.find(Country, { isActive: true }, { orderBy: { sortOrder: 'asc', label: 'asc' } });
+    }
+    async getDefault() {
+        const em = this.emFactory();
+        return em.findOne(Country, { isDefault: true });
+    }
+    async getByCode(code) {
+        const em = this.emFactory();
+        return em.findOne(Country, { code });
+    }
+    async create(input) {
+        const em = this.emFactory();
+        const existing = await em.findOne(Country, { code: input.code });
+        if (existing) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `Country ${input.code} already exists.`);
+        }
+        const row = em.create(Country, {
+            code: input.code,
+            alpha3Code: input.alpha3Code,
+            numericCode: input.numericCode,
+            label: input.label,
+            region: input.region,
+            ...(input.subregion !== undefined ? { subregion: input.subregion } : {}),
+            ...(input.dialCode !== undefined ? { dialCode: input.dialCode } : {}),
+            ...(input.isEuMember !== undefined ? { isEuMember: input.isEuMember } : {}),
+            ...(input.defaultCurrencyCode !== undefined
+                ? { defaultCurrencyCode: input.defaultCurrencyCode }
+                : {}),
+            ...(input.isActive !== undefined ? { isActive: input.isActive } : {}),
+            ...(input.sortOrder !== undefined ? { sortOrder: input.sortOrder } : {}),
+        });
+        em.persist(row);
+        this.#audit(em, 'country.create', row.code, null, { label: row.label });
+        await em.flush();
+        await this.invalidateDictionaryCache?.();
+        return row;
+    }
+    async update(code, input) {
+        const em = this.emFactory();
+        const existing = await em.findOne(Country, { code });
+        if (!existing) {
+            throw new HttpError(404, ERROR_CODES.DICTIONARY_ENTRY_NOT_FOUND, `Country ${code} not found.`);
+        }
+        // Default-cannot-be-deactivated invariant.
+        if (input.isActive === false && existing.isDefault) {
+            throw new HttpError(409, ERROR_CODES.DICTIONARY_DEFAULT_CANNOT_BE_DEACTIVATED, 'Cannot deactivate the default country. Promote a different country first.');
+        }
+        // At-least-one-active invariant — guard the deactivation path.
+        if (input.isActive === false && existing.isActive) {
+            const otherActive = await em.count(Country, { isActive: true, code: { $ne: code } });
+            if (otherActive === 0) {
+                throw new HttpError(409, ERROR_CODES.DICTIONARY_LAST_ACTIVE_ENTRY, 'At least one country must remain active.');
+            }
+        }
+        if (input.alpha3Code !== undefined)
+            existing.alpha3Code = input.alpha3Code;
+        if (input.numericCode !== undefined)
+            existing.numericCode = input.numericCode;
+        if (input.label !== undefined)
+            existing.label = input.label;
+        if (input.region !== undefined)
+            existing.region = input.region;
+        if (input.subregion !== undefined)
+            existing.subregion = input.subregion;
+        if (input.dialCode !== undefined)
+            existing.dialCode = input.dialCode;
+        if (input.isEuMember !== undefined)
+            existing.isEuMember = input.isEuMember;
+        if (input.defaultCurrencyCode !== undefined) {
+            existing.defaultCurrencyCode = input.defaultCurrencyCode;
+        }
+        if (input.isActive !== undefined)
+            existing.isActive = input.isActive;
+        if (input.sortOrder !== undefined)
+            existing.sortOrder = input.sortOrder;
+        this.#audit(em, 'country.update', existing.code, null, { label: existing.label, isActive: existing.isActive });
+        await em.flush();
+        await this.invalidateDictionaryCache?.();
+        return existing;
+    }
+    async setDefault(code) {
+        const em = this.emFactory();
+        const target = await em.findOne(Country, { code });
+        if (!target) {
+            throw new HttpError(404, ERROR_CODES.DICTIONARY_ENTRY_NOT_FOUND, `Country ${code} not found.`);
+        }
+        if (!target.isActive) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, 'Cannot mark an inactive country as default.');
+        }
+        if (target.isDefault)
+            return target;
+        // Demote-then-promote in two steps inside the EM's current scope
+        // (or its own implicit tx if not already in one). em.nativeUpdate is
+        // tx-aware — it honours an outer transaction when one is open.
+        await em.nativeUpdate(Country, { isDefault: true }, { isDefault: false });
+        await em.nativeUpdate(Country, { code }, { isDefault: true });
+        target.isDefault = true;
+        this.#audit(em, 'country.set_default', code, null, { isDefault: true });
+        await em.flush();
+        await this.invalidateDictionaryCache?.();
+        return target;
+    }
+    /**
+     * Every consumer reference to `code` (feature 077, D-87).
+     *
+     * Three hand-written `count(*)` statements over `addresses`, `taxes` and
+     * `organizations` used to live here, and a comment explaining that
+     * `warehouses` was skipped because its country sits inside a JSONB column and
+     * "covering that path requires a separate scan that v1 defers". The scan is
+     * `inventory`'s to write and it writes it: the descriptor it contributes
+     * answers the same question about its own table, so the gap closed as a side
+     * effect of moving the question to the module that can answer it.
+     */
+    async countDependents(code) {
+        const registry = this.referenceRegistry?.();
+        return registry ? registry.countReferences(code) : [];
+    }
+    async remove(code) {
+        const em = this.emFactory();
+        const row = await em.findOne(Country, { code });
+        if (!row) {
+            throw new HttpError(404, ERROR_CODES.DICTIONARY_ENTRY_NOT_FOUND, `Country ${code} not found.`);
+        }
+        if (row.isDefault) {
+            throw new HttpError(409, ERROR_CODES.DICTIONARY_DEFAULT_CANNOT_BE_DEACTIVATED, 'Cannot delete the default country. Promote a different country first.');
+        }
+        const dependents = await this.countDependents(code);
+        // Which references refuse the delete is the contributing module's call,
+        // carried on the descriptor.
+        const total = dependents
+            .filter((reference) => reference.blocking)
+            .reduce((sum, reference) => sum + reference.count, 0);
+        if (total > 0) {
+            throw new HttpError(409, ERROR_CODES.DICTIONARY_ENTRY_HAS_DEPENDENTS, `Country ${code} cannot be deleted because ${total} consumer reference(s) exist.`, [
+                {
+                    path: 'consumers',
+                    issue: JSON.stringify(dependents),
+                },
+            ]);
+        }
+        this.#audit(em, 'country.delete', row.code, { label: row.label }, null);
+        await em.removeAndFlush(row);
+        await this.invalidateDictionaryCache?.();
+    }
+}
+//# sourceMappingURL=country-service.js.map

package/dist/backend/services/country-service.js.map

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

package/dist/backend/services/dictionary-cache.d.ts

@@ -0,0 +1,27 @@
+import type { Redis } from 'ioredis';
+export declare const DICTIONARY_CACHE_KEY_PREFIX = "dictionary:";
+export declare const DICTIONARY_CACHE_DEFAULT_TTL_SECONDS: number;
+/**
+ * The channel segment of a **platform-wide** registry key (issue #101), the
+ * same reserved segment the settings cache uses. A uuid can never spell it, so
+ * it cannot collide with a real channel — which the literal `'default'` it
+ * replaces could and did, because that is also a channel code.
+ */
+export declare const GLOBAL_CACHE_KEY_SEGMENT = "__global__";
+export interface DictionaryCacheOptions {
+    ttlSeconds?: number;
+    enabled?: boolean;
+}
+export declare class DictionaryCache {
+    private readonly redis;
+    private readonly ttlSeconds;
+    private readonly enabled;
+    constructor(redis: Redis, options?: DictionaryCacheOptions);
+    /** `channelKey` is a channel **id**, or {@link GLOBAL_CACHE_KEY_SEGMENT}. */
+    static registryKey(channelKey: string, locale: string): string;
+    static byCodeKey(entryType: string, entryCode: string, locale: string): string;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, payload: T): Promise<void>;
+    invalidateAll(): Promise<void>;
+}
+//# sourceMappingURL=dictionary-cache.d.ts.map

package/dist/backend/services/dictionary-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary-cache.d.ts","sourceRoot":"","sources":["../../../src/backend/services/dictionary-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,eAAO,MAAM,2BAA2B,gBAAgB,CAAC;AACzD,eAAO,MAAM,oCAAoC,QAAU,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEL,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,sBAA2B;IAK/E,6EAA6E;IAC7E,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9D,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAIxE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAYtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAerC"}

package/dist/backend/services/dictionary-cache.js

@@ -0,0 +1,57 @@
+export const DICTIONARY_CACHE_KEY_PREFIX = 'dictionary:';
+export const DICTIONARY_CACHE_DEFAULT_TTL_SECONDS = 60 * 60;
+/**
+ * The channel segment of a **platform-wide** registry key (issue #101), the
+ * same reserved segment the settings cache uses. A uuid can never spell it, so
+ * it cannot collide with a real channel — which the literal `'default'` it
+ * replaces could and did, because that is also a channel code.
+ */
+export const GLOBAL_CACHE_KEY_SEGMENT = '__global__';
+export class DictionaryCache {
+    redis;
+    ttlSeconds;
+    enabled;
+    constructor(redis, options = {}) {
+        this.redis = redis;
+        this.ttlSeconds = options.ttlSeconds ?? DICTIONARY_CACHE_DEFAULT_TTL_SECONDS;
+        this.enabled = (options.enabled ?? true) && this.ttlSeconds > 0;
+    }
+    /** `channelKey` is a channel **id**, or {@link GLOBAL_CACHE_KEY_SEGMENT}. */
+    static registryKey(channelKey, locale) {
+        return `${DICTIONARY_CACHE_KEY_PREFIX}registry:v1:${channelKey}:${locale}`;
+    }
+    static byCodeKey(entryType, entryCode, locale) {
+        return `${DICTIONARY_CACHE_KEY_PREFIX}by-code:v1:${entryType}:${entryCode}:${locale}`;
+    }
+    async get(key) {
+        if (!this.enabled)
+            return null;
+        const raw = await this.redis.get(key);
+        if (raw === null)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            await this.redis.del(key);
+            return null;
+        }
+    }
+    async set(key, payload) {
+        if (!this.enabled)
+            return;
+        await this.redis.set(key, JSON.stringify(payload), 'EX', this.ttlSeconds);
+    }
+    async invalidateAll() {
+        if (!this.enabled)
+            return;
+        let cursor = '0';
+        do {
+            const [next, keys] = await this.redis.scan(cursor, 'MATCH', `${DICTIONARY_CACHE_KEY_PREFIX}*:v1:*`, 'COUNT', 200);
+            cursor = next;
+            if (keys.length > 0)
+                await this.redis.del(...keys);
+        } while (cursor !== '0');
+    }
+}
+//# sourceMappingURL=dictionary-cache.js.map

package/dist/backend/services/dictionary-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary-cache.js","sourceRoot":"","sources":["../../../src/backend/services/dictionary-cache.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,2BAA2B,GAAG,aAAa,CAAC;AACzD,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAE,GAAG,EAAE,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC;AAOrD,MAAM,OAAO,eAAe;IAIG;IAHZ,UAAU,CAAS;IACnB,OAAO,CAAU;IAElC,YAA6B,KAAY,EAAE,UAAkC,EAAE;QAAlD,UAAK,GAAL,KAAK,CAAO;QACvC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,oCAAoC,CAAC;QAC7E,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,WAAW,CAAC,UAAkB,EAAE,MAAc;QACnD,OAAO,GAAG,2BAA2B,eAAe,UAAU,IAAI,MAAM,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,SAAiB,EAAE,SAAiB,EAAE,MAAc;QACnE,OAAO,GAAG,2BAA2B,cAAc,SAAS,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,OAAU;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACF,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CACxC,MAAM,EACN,OAAO,EACP,GAAG,2BAA2B,QAAQ,EACtC,OAAO,EACP,GAAG,CACJ,CAAC;YACF,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACrD,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAC3B,CAAC;CACF"}

package/dist/backend/services/dictionary-read-service.d.ts

@@ -0,0 +1,36 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CurrencyReadPort, type DictionaryByCodeResponse, type DictionaryEntryType, type DictionaryRegistryResponse, type LanguageReadPort } from '@endora-commerce/contracts';
+import { DictionaryCache } from './dictionary-cache.js';
+import { LabelResolver } from './label-resolver.js';
+export interface DictionaryRegistryArgs {
+    channelCode?: string;
+    locale?: string;
+}
+export interface DictionaryByCodeArgs {
+    entryType: DictionaryEntryType;
+    entryCode: string;
+    locale?: string;
+}
+export declare class DictionaryReadService {
+    private readonly emFactory;
+    private readonly currencies;
+    private readonly languages;
+    private readonly cache?;
+    private readonly labelResolver;
+    /**
+     * Feature 075, Phase C — the registry is assembled from three tables, and
+     * only `countries` is this module's. The currency and language rows come
+     * from their owners' read ports instead of `em.find(Currency, …)` /
+     * `em.find(Language, …)`, which kept answering out of modules an operator had
+     * switched off, because deactivation drops no tables.
+     *
+     * Each port call is one statement, exactly like the query it replaces, so the
+     * cold-build ceiling issue #142 pinned at seven is unchanged.
+     */
+    constructor(emFactory: () => EntityManager, currencies: CurrencyReadPort, languages: LanguageReadPort, cache?: DictionaryCache | undefined, labelResolver?: LabelResolver);
+    getRegistry(args?: DictionaryRegistryArgs): Promise<DictionaryRegistryResponse>;
+    getByCode(args: DictionaryByCodeArgs): Promise<DictionaryByCodeResponse>;
+    private resolveContext;
+    private resolveDefaultLocale;
+}
+//# sourceMappingURL=dictionary-read-service.d.ts.map

package/dist/backend/services/dictionary-read-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary-read-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/dictionary-read-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EAAE,eAAe,EAA4B,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAkC,MAAM,qBAAqB,CAAC;AAEpF,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,qBAAqB;IAY9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAfhC;;;;;;;;;OASG;gBAEgB,SAAS,EAAE,MAAM,aAAa,EAC9B,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,CAAC,EAAE,eAAe,YAAA,EACvB,aAAa,GAAE,aAI/B;IAGG,WAAW,CAAC,IAAI,GAAE,sBAA2B,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA4EnF,SAAS,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,wBAAwB,CAAC;YAuFhE,cAAc;YA+Bd,oBAAoB;CAInC"}

package/dist/backend/services/dictionary-read-service.js

@@ -0,0 +1,232 @@
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { Country } from '../entities/country.entity.js';
+import { LanguageCountry } from '../entities/language-country.entity.js';
+import { DictionaryCache, GLOBAL_CACHE_KEY_SEGMENT } from './dictionary-cache.js';
+import { LabelResolver, labelKey } from './label-resolver.js';
+export class DictionaryReadService {
+    emFactory;
+    currencies;
+    languages;
+    cache;
+    labelResolver;
+    /**
+     * Feature 075, Phase C — the registry is assembled from three tables, and
+     * only `countries` is this module's. The currency and language rows come
+     * from their owners' read ports instead of `em.find(Currency, …)` /
+     * `em.find(Language, …)`, which kept answering out of modules an operator had
+     * switched off, because deactivation drops no tables.
+     *
+     * Each port call is one statement, exactly like the query it replaces, so the
+     * cold-build ceiling issue #142 pinned at seven is unchanged.
+     */
+    constructor(emFactory, currencies, languages, cache, labelResolver = new LabelResolver(emFactory, currencies, languages)) {
+        this.emFactory = emFactory;
+        this.currencies = currencies;
+        this.languages = languages;
+        this.cache = cache;
+        this.labelResolver = labelResolver;
+    }
+    async getRegistry(args = {}) {
+        const ctx = await this.resolveContext(args);
+        const cacheKey = DictionaryCache.registryKey(ctx.cacheChannelKey, ctx.locale);
+        const cached = await this.cache?.get(cacheKey);
+        if (cached)
+            return cached;
+        const em = this.emFactory();
+        const [countries, currencies, languages, links] = await Promise.all([
+            em.find(Country, { isActive: true }, { orderBy: { sortOrder: 'asc', label: 'asc' } }),
+            this.currencies.listActive(),
+            this.languages.listActive(),
+            em.find(LanguageCountry, {}),
+        ]);
+        const scopedCurrencies = ctx.channel
+            ? currencies.filter((row) => ctx.channel?.currencies.includes(row.code))
+            : currencies;
+        const scopedLanguages = ctx.channel
+            ? languages.filter((row) => ctx.channel?.languages.includes(row.code))
+            : languages;
+        const countryLinks = groupCountryLinks(links);
+        // Issue #142 — one batch, not one resolution per entry. The rows above
+        // already carry their canonical labels, so the only thing left to read is
+        // the translation each entry may have in the locale's fallback chain, and
+        // that is one statement for the whole registry however large it grows.
+        const labels = await this.labelResolver.resolveLabels([
+            ...countries.map((row) => canonical('country', row.code, row.label)),
+            ...scopedCurrencies.map((row) => canonical('currency', row.code, row.label)),
+            ...scopedLanguages.map((row) => canonical('language', row.code, row.label)),
+        ], ctx.locale);
+        const payload = {
+            data: {
+                countries: countries.map((row) => ({
+                    code: row.code,
+                    label: labels.get(labelKey('country', row.code)) ?? row.label,
+                    alpha3Code: row.alpha3Code,
+                    numericCode: row.numericCode,
+                    region: row.region,
+                    subregion: row.subregion ?? null,
+                    dialCode: row.dialCode ?? null,
+                    isEuMember: row.isEuMember,
+                    defaultCurrencyCode: row.defaultCurrencyCode ?? null,
+                    sortOrder: row.sortOrder,
+                })),
+                currencies: scopedCurrencies.map((row) => ({
+                    code: row.code,
+                    label: labels.get(labelKey('currency', row.code)) ?? row.label,
+                    symbol: row.symbol,
+                    symbolPosition: row.symbolPosition,
+                    decimalPlaces: row.decimalPlaces,
+                    sortOrder: row.sortOrder,
+                })),
+                languages: scopedLanguages.map((row) => ({
+                    code: row.code,
+                    label: labels.get(labelKey('language', row.code)) ?? row.label,
+                    nativeLabel: row.nativeLabel || row.label,
+                    isRtl: row.isRtl,
+                    fallbackCode: row.fallbackCode ?? null,
+                    countries: countryLinks.get(row.code) ?? [],
+                    sortOrder: row.sortOrder,
+                })),
+                defaults: {
+                    country: countries.find((row) => row.isDefault)?.code ?? null,
+                    currency: ctx.channel?.defaultCurrency ?? scopedCurrencies.find((row) => row.isDefault)?.code ?? null,
+                    language: ctx.channel?.defaultLanguage ?? scopedLanguages.find((row) => row.isDefault)?.code ?? null,
+                },
+            },
+        };
+        await this.cache?.set(cacheKey, payload);
+        return payload;
+    }
+    async getByCode(args) {
+        const locale = args.locale ?? (await this.resolveDefaultLocale());
+        const cacheKey = DictionaryCache.byCodeKey(args.entryType, args.entryCode, locale);
+        const cached = await this.cache?.get(cacheKey);
+        if (cached)
+            return cached;
+        const em = this.emFactory();
+        if (args.entryType === 'country') {
+            const row = await em.findOne(Country, { code: args.entryCode });
+            if (!row)
+                throw notFound('country', args.entryCode);
+            const payload = {
+                data: {
+                    entryType: 'country',
+                    entry: {
+                        code: row.code,
+                        label: await this.labelResolver.resolveLabel({
+                            entryType: 'country',
+                            entryCode: row.code,
+                            locale,
+                        }),
+                        alpha3Code: row.alpha3Code,
+                        numericCode: row.numericCode,
+                        region: row.region,
+                        subregion: row.subregion ?? null,
+                        dialCode: row.dialCode ?? null,
+                        isEuMember: row.isEuMember,
+                        defaultCurrencyCode: row.defaultCurrencyCode ?? null,
+                        sortOrder: row.sortOrder,
+                        isActive: row.isActive,
+                    },
+                },
+            };
+            await this.cache?.set(cacheKey, payload);
+            return payload;
+        }
+        if (args.entryType === 'currency') {
+            const row = await this.currencies.findByCode(args.entryCode);
+            if (!row)
+                throw notFound('currency', args.entryCode);
+            const payload = {
+                data: {
+                    entryType: 'currency',
+                    entry: {
+                        code: row.code,
+                        label: await this.labelResolver.resolveLabel({
+                            entryType: 'currency',
+                            entryCode: row.code,
+                            locale,
+                        }),
+                        symbol: row.symbol,
+                        symbolPosition: row.symbolPosition,
+                        decimalPlaces: row.decimalPlaces,
+                        sortOrder: row.sortOrder,
+                        isActive: row.isActive,
+                    },
+                },
+            };
+            await this.cache?.set(cacheKey, payload);
+            return payload;
+        }
+        const row = await this.languages.findByCode(args.entryCode);
+        if (!row)
+            throw notFound('language', args.entryCode);
+        const links = await em.find(LanguageCountry, { languageCode: row.code });
+        const payload = {
+            data: {
+                entryType: 'language',
+                entry: {
+                    code: row.code,
+                    label: await this.labelResolver.resolveLabel({
+                        entryType: 'language',
+                        entryCode: row.code,
+                        locale,
+                    }),
+                    nativeLabel: row.nativeLabel || row.label,
+                    isRtl: row.isRtl,
+                    fallbackCode: row.fallbackCode ?? null,
+                    countries: links.map((link) => link.countryCode),
+                    sortOrder: row.sortOrder,
+                    isActive: row.isActive,
+                },
+            },
+        };
+        await this.cache?.set(cacheKey, payload);
+        return payload;
+    }
+    async resolveContext(args) {
+        const em = this.emFactory();
+        const channel = args.channelCode
+            ? await em.findOne(SalesChannel, { code: args.channelCode })
+            : await em.findOne(SalesChannel, { systemDefault: true });
+        if (args.channelCode && !channel) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Sales channel ${args.channelCode} not found.`);
+        }
+        const locale = args.locale ?? channel?.defaultLanguage ?? (await this.resolveDefaultLocale());
+        return {
+            channel: channel ?? null,
+            locale,
+            // Issue #101 — the key is the channel this read actually resolved, not
+            // the literal `'default'` it used to be. A code is not an identity: the
+            // flag moves (D-51), so an entry keyed `'default'` outlived the channel
+            // it was built from and served the previous default's languages and
+            // currencies under the new one's name. `__global__` is the reserved
+            // segment for the platform-wide tier, the same one the settings cache
+            // uses; a uuid can never spell it, so it cannot collide with a channel.
+            cacheChannelKey: channel?.id ?? GLOBAL_CACHE_KEY_SEGMENT,
+        };
+    }
+    async resolveDefaultLocale() {
+        const language = await this.languages.getDefault();
+        return language?.code ?? 'en-US';
+    }
+}
+function canonical(entryType, entryCode, canonicalLabel) {
+    return { entryType, entryCode, canonicalLabel };
+}
+function groupCountryLinks(links) {
+    const out = new Map();
+    for (const link of links) {
+        const list = out.get(link.languageCode) ?? [];
+        list.push(link.countryCode);
+        out.set(link.languageCode, list);
+    }
+    for (const list of out.values())
+        list.sort();
+    return out;
+}
+function notFound(entryType, entryCode) {
+    return new HttpError(404, ERROR_CODES.DICTIONARY_ENTRY_NOT_FOUND, `Dictionary ${entryType} ${entryCode} not found.`);
+}
+//# sourceMappingURL=dictionary-read-service.js.map

package/dist/backend/services/dictionary-read-service.js.map

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

package/dist/backend/services/dictionary-validator.d.ts

@@ -0,0 +1,26 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CurrencyReadPort, type DictionaryValidator as DictionaryValidatorPort, type DictionaryWriteMode, type LanguageReadPort } from '@endora-commerce/contracts';
+export declare class DictionaryValidator implements DictionaryValidatorPort {
+    private readonly emFactory;
+    private readonly currencies;
+    private readonly languages;
+    private readonly cache;
+    /**
+     * Feature 075, Phase C — `country` is this module's own table and stays an
+     * `em.findOne`; `currency` and `language` are not, and go through their
+     * owners' read ports. The reads used to be `em.findOne(Currency, …)` /
+     * `em.findOne(Language, …)` against tables deactivation does not drop, so a
+     * write validated against a switched-off `currencies` was accepted as valid.
+     * Fail-closed is the right answer for a validator: an unvalidated code
+     * written into an order or a tax rule is worse than a refused write, and both
+     * owners are binding `dependencies` of this manifest.
+     */
+    constructor(emFactory: () => EntityManager, currencies: CurrencyReadPort, languages: LanguageReadPort);
+    validateCountryCode(code: string, mode: DictionaryWriteMode): Promise<void>;
+    validateCurrencyCode(code: string, mode: DictionaryWriteMode): Promise<void>;
+    validateLanguageCode(code: string, mode: DictionaryWriteMode): Promise<void>;
+    invalidate(): void;
+    private validate;
+    private getState;
+}
+//# sourceMappingURL=dictionary-validator.d.ts.map

package/dist/backend/services/dictionary-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary-validator.d.ts","sourceRoot":"","sources":["../../../src/backend/services/dictionary-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,mBAAmB,IAAI,uBAAuB,EACnD,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAWpC,qBAAa,mBAAoB,YAAW,uBAAuB;IAc/D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAf5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEvD;;;;;;;;;OASG;gBAEgB,SAAS,EAAE,MAAM,aAAa,EAC9B,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,gBAAgB;IAGxC,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,UAAU,IAAI,IAAI;YAIJ,QAAQ;YAsBR,QAAQ;CAmBvB"}