@endora-commerce/mod-dictionaries 0.100.0

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

@@ -0,0 +1,72 @@
+import { DictionaryReferenceError, } from '@endora-commerce/contracts';
+import { Country } from '../entities/country.entity.js';
+const TTL_MS = 60_000;
+export class DictionaryValidator {
+    emFactory;
+    currencies;
+    languages;
+    cache = new Map();
+    /**
+     * 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, currencies, languages) {
+        this.emFactory = emFactory;
+        this.currencies = currencies;
+        this.languages = languages;
+    }
+    async validateCountryCode(code, mode) {
+        await this.validate('country', code.toUpperCase(), mode);
+    }
+    async validateCurrencyCode(code, mode) {
+        await this.validate('currency', code.toUpperCase(), mode);
+    }
+    async validateLanguageCode(code, mode) {
+        await this.validate('language', code, mode);
+    }
+    invalidate() {
+        this.cache.clear();
+    }
+    async validate(entryType, entryCode, mode) {
+        const state = await this.getState(entryType, entryCode);
+        if (!state.exists) {
+            throw new DictionaryReferenceError({
+                code: 'DICTIONARY_ENTRY_NOT_FOUND',
+                entryType,
+                entryCode,
+            });
+        }
+        if (mode === 'create-or-change' && !state.isActive) {
+            throw new DictionaryReferenceError({
+                code: 'DICTIONARY_ENTRY_INACTIVE',
+                entryType,
+                entryCode,
+            });
+        }
+    }
+    async getState(entryType, entryCode) {
+        const key = `${entryType}:${entryCode}`;
+        const cached = this.cache.get(key);
+        if (cached && cached.expiresAt > Date.now())
+            return cached;
+        const row = entryType === 'country'
+            ? await this.emFactory().findOne(Country, { code: entryCode })
+            : entryType === 'currency'
+                ? await this.currencies.findByCode(entryCode)
+                : await this.languages.findByCode(entryCode);
+        const next = {
+            exists: Boolean(row),
+            isActive: row?.isActive ?? false,
+            expiresAt: Date.now() + TTL_MS,
+        };
+        this.cache.set(key, next);
+        return next;
+    }
+}
+//# sourceMappingURL=dictionary-validator.js.map

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

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

package/dist/backend/services/dispatch-validator-mode.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `dispatchValidatorMode` moved to `@endora-commerce/contracts` in feature 075's Phase P.
+ *
+ * It is published as a **function, not a port**, which contradicts
+ * `contracts/port-publication.md` §1.5 — that section names this file as the
+ * worked example of a helper that "reads state the module owns", and it reads
+ * nothing. Three comparisons over its two arguments: switching `dictionaries`
+ * off cannot change the answer, so a gated port would answer 503 to a question
+ * about two strings the caller already holds (FR-013).
+ *
+ * The five callers reach `dictionaryValidator` immediately afterwards, and
+ * that one *is* a port and *does* read this module's tables. Splitting the
+ * pure decision from the stateful validation is what lets the second fail
+ * closed without the first inventing a mode.
+ *
+ * Re-exported here for the length of Phase P, which cuts no consumer.
+ */
+export { dispatchValidatorMode } from '@endora-commerce/contracts';
+//# sourceMappingURL=dispatch-validator-mode.d.ts.map

package/dist/backend/services/dispatch-validator-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-validator-mode.d.ts","sourceRoot":"","sources":["../../../src/backend/services/dispatch-validator-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/dispatch-validator-mode.js

@@ -0,0 +1,19 @@
+/**
+ * `dispatchValidatorMode` moved to `@endora-commerce/contracts` in feature 075's Phase P.
+ *
+ * It is published as a **function, not a port**, which contradicts
+ * `contracts/port-publication.md` §1.5 — that section names this file as the
+ * worked example of a helper that "reads state the module owns", and it reads
+ * nothing. Three comparisons over its two arguments: switching `dictionaries`
+ * off cannot change the answer, so a gated port would answer 503 to a question
+ * about two strings the caller already holds (FR-013).
+ *
+ * The five callers reach `dictionaryValidator` immediately afterwards, and
+ * that one *is* a port and *does* read this module's tables. Splitting the
+ * pure decision from the stateful validation is what lets the second fail
+ * closed without the first inventing a mode.
+ *
+ * Re-exported here for the length of Phase P, which cuts no consumer.
+ */
+export { dispatchValidatorMode } from '@endora-commerce/contracts';
+//# sourceMappingURL=dispatch-validator-mode.js.map

package/dist/backend/services/dispatch-validator-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-validator-mode.js","sourceRoot":"","sources":["../../../src/backend/services/dispatch-validator-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/backend/services/label-resolver.d.ts

@@ -0,0 +1,57 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CurrencyReadPort, type DictionaryEntryType, type LanguageReadPort } from '@endora-commerce/contracts';
+export interface ResolveLabelArgs {
+    entryType: DictionaryEntryType;
+    entryCode: string;
+    locale?: string;
+}
+/** One entry to label, with the canonical label its own row already carries. */
+export interface LabelBatchEntry {
+    entryType: DictionaryEntryType;
+    entryCode: string;
+    canonicalLabel: string;
+}
+/** Key into the map {@link LabelResolver.resolveLabels} returns. */
+export declare function labelKey(entryType: DictionaryEntryType, entryCode: string): string;
+export declare class LabelResolver {
+    private readonly emFactory;
+    private readonly currencies;
+    private readonly languages;
+    /**
+     * Feature 075, Phase C — the fallback chain is walked in `languages`' table
+     * and a canonical currency or language label is read from its owner's, so
+     * both go through the published read ports. Issue #142's property is
+     * unchanged: `list()` is one statement, exactly as the `em.find(Language,
+     * {})` it replaces was, so the cold registry build stays at seven.
+     */
+    constructor(emFactory: () => EntityManager, currencies: CurrencyReadPort, languages: LanguageReadPort);
+    /**
+     * Labels for a whole batch, in a **constant** number of statements: one for
+     * the language table the fallback chain is walked in, one for every
+     * translation any entry in the batch could use.
+     *
+     * Issue #142 — the registry called {@link resolveLabel} once per entry, and
+     * each call re-read the canonical row, then the translation, then the
+     * fallback language, one statement at a time on one connection. Over the 72
+     * entries a seeded registry answers that was ~170 sequential round trips, and
+     * it grew with the dictionary. The fallback chain in particular depends only
+     * on the locale, so it was the same walk repeated once per entry.
+     *
+     * Callers already hold the rows, so the canonical label is passed in rather
+     * than read back; an entry with no translation in the chain keeps it.
+     */
+    resolveLabels(entries: readonly LabelBatchEntry[], locale?: string): Promise<Map<string, string>>;
+    resolveLabel(args: ResolveLabelArgs): Promise<string>;
+    /** The label the entry's own row carries, from whichever module owns it. */
+    private canonicalLabel;
+}
+/**
+ * The locale, then each `fallbackCode` after it — the same walk the per-entry
+ * resolver used to make one statement at a time. A locale no `Language` row
+ * knows ends the chain, and a cycle ends it too.
+ */
+export declare function buildFallbackChain(locale: string, languages: readonly {
+    code: string;
+    fallbackCode?: string | null;
+}[]): string[];
+//# sourceMappingURL=label-resolver.d.ts.map

package/dist/backend/services/label-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/label-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAQpC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,qBAAa,aAAa;IAStB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAV5B;;;;;;OAMG;gBAEgB,SAAS,EAAE,MAAM,aAAa,EAC9B,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,gBAAgB;IAG9C;;;;;;;;;;;;;;OAcG;IACG,aAAa,CACjB,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAiCzB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3D,4EAA4E;YAC9D,cAAc;CAY7B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GACnE,MAAM,EAAE,CAWV"}

package/dist/backend/services/label-resolver.js

@@ -0,0 +1,116 @@
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Country } from '../entities/country.entity.js';
+import { DictionaryTranslation } from '../entities/dictionary-translation.entity.js';
+/** Locale fallback chains never walk deeper than this, cycles included. */
+const MAX_FALLBACK_DEPTH = 10;
+/** Key into the map {@link LabelResolver.resolveLabels} returns. */
+export function labelKey(entryType, entryCode) {
+    return `${entryType}:${entryCode}`;
+}
+export class LabelResolver {
+    emFactory;
+    currencies;
+    languages;
+    /**
+     * Feature 075, Phase C — the fallback chain is walked in `languages`' table
+     * and a canonical currency or language label is read from its owner's, so
+     * both go through the published read ports. Issue #142's property is
+     * unchanged: `list()` is one statement, exactly as the `em.find(Language,
+     * {})` it replaces was, so the cold registry build stays at seven.
+     */
+    constructor(emFactory, currencies, languages) {
+        this.emFactory = emFactory;
+        this.currencies = currencies;
+        this.languages = languages;
+    }
+    /**
+     * Labels for a whole batch, in a **constant** number of statements: one for
+     * the language table the fallback chain is walked in, one for every
+     * translation any entry in the batch could use.
+     *
+     * Issue #142 — the registry called {@link resolveLabel} once per entry, and
+     * each call re-read the canonical row, then the translation, then the
+     * fallback language, one statement at a time on one connection. Over the 72
+     * entries a seeded registry answers that was ~170 sequential round trips, and
+     * it grew with the dictionary. The fallback chain in particular depends only
+     * on the locale, so it was the same walk repeated once per entry.
+     *
+     * Callers already hold the rows, so the canonical label is passed in rather
+     * than read back; an entry with no translation in the chain keeps it.
+     */
+    async resolveLabels(entries, locale) {
+        const labels = new Map();
+        for (const entry of entries) {
+            labels.set(labelKey(entry.entryType, entry.entryCode), entry.canonicalLabel);
+        }
+        if (!locale || entries.length === 0)
+            return labels;
+        const em = this.emFactory();
+        const chain = buildFallbackChain(locale, await this.languages.list());
+        const rows = await em.find(DictionaryTranslation, {
+            languageCode: { $in: chain },
+            entryType: { $in: [...new Set(entries.map((entry) => entry.entryType))] },
+            entryCode: { $in: [...new Set(entries.map((entry) => entry.entryCode))] },
+        });
+        // Earlier in the chain wins, which is what walking it in order used to mean.
+        const rank = new Map(chain.map((code, index) => [code, index]));
+        const bestRank = new Map();
+        for (const row of rows) {
+            const key = labelKey(row.entryType, row.entryCode);
+            // The `$in` filters are a cross product, so a row can match a code of one
+            // entry type under another's. Only keys the batch asked for are labelled.
+            if (!labels.has(key))
+                continue;
+            const candidate = rank.get(row.languageCode);
+            if (candidate === undefined)
+                continue;
+            const current = bestRank.get(key);
+            if (current !== undefined && current <= candidate)
+                continue;
+            bestRank.set(key, candidate);
+            labels.set(key, row.label);
+        }
+        return labels;
+    }
+    async resolveLabel(args) {
+        const canonical = await this.canonicalLabel(args.entryType, args.entryCode);
+        if (!canonical)
+            throw notFound(args.entryType, args.entryCode);
+        if (!args.locale)
+            return canonical;
+        const labels = await this.resolveLabels([{ entryType: args.entryType, entryCode: args.entryCode, canonicalLabel: canonical }], args.locale);
+        return labels.get(labelKey(args.entryType, args.entryCode)) ?? canonical;
+    }
+    /** The label the entry's own row carries, from whichever module owns it. */
+    async canonicalLabel(entryType, entryCode) {
+        if (entryType === 'country') {
+            return (await this.emFactory().findOne(Country, { code: entryCode }))?.label ?? null;
+        }
+        if (entryType === 'currency') {
+            return (await this.currencies.findByCode(entryCode))?.label ?? null;
+        }
+        return (await this.languages.findByCode(entryCode))?.label ?? null;
+    }
+}
+/**
+ * The locale, then each `fallbackCode` after it — the same walk the per-entry
+ * resolver used to make one statement at a time. A locale no `Language` row
+ * knows ends the chain, and a cycle ends it too.
+ */
+export function buildFallbackChain(locale, languages) {
+    const fallbackByCode = new Map(languages.map((row) => [row.code, row.fallbackCode ?? null]));
+    const chain = [];
+    const visited = new Set();
+    let current = locale;
+    for (let depth = 0; current && depth < MAX_FALLBACK_DEPTH && !visited.has(current); depth += 1) {
+        visited.add(current);
+        chain.push(current);
+        current = fallbackByCode.get(current) ?? null;
+    }
+    return chain;
+}
+function notFound(entryType, entryCode) {
+    return new HttpError(404, ERROR_CODES.DICTIONARY_ENTRY_NOT_FOUND, `Dictionary ${entryType} ${entryCode} not found.`);
+}
+//# sourceMappingURL=label-resolver.js.map

package/dist/backend/services/label-resolver.js.map

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

package/dist/backend/services/language-country-service.d.ts

@@ -0,0 +1,26 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type LanguageReadPort } from '@endora-commerce/contracts';
+import { LanguageCountry } from '../entities/language-country.entity.js';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+export declare class LanguageCountryService {
+    #private;
+    private readonly emFactory;
+    private readonly languages;
+    private readonly invalidateDictionaryCache?;
+    private readonly auditLog?;
+    /**
+     * Feature 075, Phase C — the link row is this module's, the country is this
+     * module's, the language is `languages`'. Only the last one crosses a
+     * boundary and it does so through the published read port.
+     */
+    constructor(emFactory: () => EntityManager, languages: LanguageReadPort, invalidateDictionaryCache?: (() => Promise<void>) | undefined, auditLog?: AuditPort | undefined);
+    listForLanguage(languageCode: string): Promise<LanguageCountry[]>;
+    listForCountry(countryCode: string): Promise<LanguageCountry[]>;
+    upsert(input: {
+        languageCode: string;
+        countryCode: string;
+        isPrimary?: boolean;
+    }): Promise<LanguageCountry>;
+    remove(languageCode: string, countryCode: string): Promise<void>;
+}
+//# sourceMappingURL=language-country-service.d.ts.map

package/dist/backend/services/language-country-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-country-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/language-country-service.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,qBAAa,sBAAsB;;IAO/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAT5B;;;;OAIG;gBAEgB,SAAS,EAAE,MAAM,aAAa,EAC9B,SAAS,EAAE,gBAAgB,EAC3B,yBAAyB,CAAC,GAAE,MAAM,OAAO,CAAC,IAAI,CAAC,aAAA,EAC/C,QAAQ,CAAC,EAAE,SAAS,YAAA;IAoBjC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAKjE,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAK/D,MAAM,CAAC,KAAK,EAAE;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+DtB,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQvE"}

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

@@ -0,0 +1,108 @@
+// LanguageCountryService — feature 017 / T028.
+//
+// Manages the M2M between Languages and Countries plus the at-most-one-
+// primary-language-per-Country invariant. The invariant is hard-enforced
+// at the database via a partial unique index
+// `uniq_language_countries_primary_per_country` (see migration
+// `038_dictionary_init.ts`); this service implements the transactional
+// promote+demote pattern so set-primary operations never violate the
+// index mid-flight.
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { LanguageCountry } from '../entities/language-country.entity.js';
+import { Country } from '../entities/country.entity.js';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+export class LanguageCountryService {
+    emFactory;
+    languages;
+    invalidateDictionaryCache;
+    auditLog;
+    /**
+     * Feature 075, Phase C — the link row is this module's, the country is this
+     * module's, the language is `languages`'. Only the last one crosses a
+     * boundary and it does so through the published read port.
+     */
+    constructor(emFactory, languages, invalidateDictionaryCache, auditLog) {
+        this.emFactory = emFactory;
+        this.languages = languages;
+        this.invalidateDictionaryCache = invalidateDictionaryCache;
+        this.auditLog = auditLog;
+    }
+    #audit(em, action, objectId, stateAfter) {
+        if (this.auditLog) {
+            recordAuditFromContext(this.auditLog, em, {
+                action,
+                objectType: 'language_country',
+                objectId,
+                stateBefore: null,
+                stateAfter,
+            });
+        }
+    }
+    async listForLanguage(languageCode) {
+        const em = this.emFactory();
+        return em.find(LanguageCountry, { languageCode });
+    }
+    async listForCountry(countryCode) {
+        const em = this.emFactory();
+        return em.find(LanguageCountry, { countryCode });
+    }
+    async upsert(input) {
+        const em = this.emFactory();
+        // Validate parent rows exist — the FK enforces this too, but a clear
+        // error message at the service layer is more operator-friendly.
+        const [lang, country] = await Promise.all([
+            this.languages.findByCode(input.languageCode),
+            em.findOne(Country, { code: input.countryCode }),
+        ]);
+        if (!lang) {
+            throw new HttpError(404, ERROR_CODES.DICTIONARY_ENTRY_NOT_FOUND, `Language ${input.languageCode} not found.`);
+        }
+        if (!country) {
+            throw new HttpError(404, ERROR_CODES.DICTIONARY_ENTRY_NOT_FOUND, `Country ${input.countryCode} not found.`);
+        }
+        const wantsPrimary = input.isPrimary === true;
+        // Promote-with-demote inside the EM's current tx scope (no inner
+        // transactional — see CountryService.setDefault for rationale).
+        if (wantsPrimary) {
+            await em.nativeUpdate(LanguageCountry, {
+                countryCode: input.countryCode,
+                isPrimary: true,
+                languageCode: { $ne: input.languageCode },
+            }, { isPrimary: false });
+        }
+        const existing = await em.findOne(LanguageCountry, {
+            languageCode: input.languageCode,
+            countryCode: input.countryCode,
+        });
+        const objId = `${input.languageCode}:${input.countryCode}`;
+        if (existing) {
+            if (input.isPrimary !== undefined)
+                existing.isPrimary = wantsPrimary;
+            this.#audit(em, 'language_country.upsert', objId, { isPrimary: existing.isPrimary });
+            await em.flush();
+            await this.invalidateDictionaryCache?.();
+            return existing;
+        }
+        const row = em.create(LanguageCountry, {
+            languageCode: input.languageCode,
+            countryCode: input.countryCode,
+            ...(input.isPrimary !== undefined ? { isPrimary: wantsPrimary } : {}),
+        });
+        em.persist(row);
+        this.#audit(em, 'language_country.upsert', objId, { isPrimary: row.isPrimary });
+        await em.flush();
+        await this.invalidateDictionaryCache?.();
+        return row;
+    }
+    async remove(languageCode, countryCode) {
+        const em = this.emFactory();
+        const row = await em.findOne(LanguageCountry, { languageCode, countryCode });
+        if (!row)
+            return;
+        this.#audit(em, 'language_country.delete', `${languageCode}:${countryCode}`, null);
+        await em.removeAndFlush(row);
+        await this.invalidateDictionaryCache?.();
+    }
+}
+//# sourceMappingURL=language-country-service.js.map

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

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

package/dist/backend/services/seed-reconciler.d.ts

@@ -0,0 +1,22 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CurrencyReadPort, CurrencySeedPort, LanguageReadPort, LanguageSeedPort } from '@endora-commerce/contracts';
+export interface SeedReconcilerSummary {
+    countriesInserted: number;
+    currenciesInserted: number;
+    languagesBackfilled: number;
+    translationsInserted: number;
+    languageCountriesInserted: number;
+}
+/**
+ * The two tables this reconciler seeds that it does not own, and the read side
+ * of both. Every one of them is a published port of the owning module — the
+ * seam D-87's drain put where four raw statements used to be.
+ */
+export interface SeedReconcilerPorts {
+    readonly currencySeed: CurrencySeedPort;
+    readonly currencyRead: CurrencyReadPort;
+    readonly languageSeed: LanguageSeedPort;
+    readonly languageRead: LanguageReadPort;
+}
+export declare function runDictionarySeedReconciler(emFactory: () => EntityManager, ports: SeedReconcilerPorts): Promise<SeedReconcilerSummary>;
+//# sourceMappingURL=seed-reconciler.d.ts.map

package/dist/backend/services/seed-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-reconciler.d.ts","sourceRoot":"","sources":["../../../src/backend/services/seed-reconciler.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAMpC,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAeD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;CACzC;AAED,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,aAAa,EAC9B,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAmGhC"}

package/dist/backend/services/seed-reconciler.js

@@ -0,0 +1,149 @@
+// Boot-time seed reconciler for the Dictionary module
+// (feature 017 / R6 / T011).
+//
+// Responsibilities (idempotent — safe to run on every backend boot):
+//
+//   1. Insert any currency from CURRENCY_SEED whose `code` is missing —
+//      through `currencySeedPort`, because the table belongs to `currencies`
+//      (feature 077, D-87: this step used to be a raw `insert into
+//      "currencies"`, a write into another module's table that named no import
+//      specifier and so crossed the boundary invisibly).
+//      Currencies that already exist are NEVER updated by the reconciler;
+//      the migration's defaults stand and operators may edit any field
+//      via Admin UI without fear of being overwritten on the next boot.
+//   2. Insert any country from COUNTRY_SEED whose `code` is missing.
+//   3. Backfill `languages.native_label` ONLY when it is still the empty
+//      string left by migration 038 — through `languageSeedPort`, for the same
+//      reason step 1 goes through `currencySeedPort`. Once an operator (or this
+//      reconciler) sets it to a non-empty value, future boots leave it alone.
+//   4. Insert seeded translations for every (entry_type, entry_code,
+//      language_code) row that doesn't already exist. Existing rows are
+//      preserved verbatim (operators may edit; the reconciler will not
+//      revert their changes).
+//   5. Insert seeded language↔country associations for every
+//      (language_code, country_code) row that doesn't already exist.
+//
+// All inserts are gated by an existence check that runs in the same
+// EntityManager — there is no race condition because the reconciler is
+// expected to run during plugin registration, before HTTP traffic.
+import { COUNTRY_SEED } from '../seed/countries.js';
+import { CURRENCY_SEED } from '../seed/currencies.js';
+import { POLISH_TRANSLATION_SEED } from '../seed/translations.pl-PL.js';
+import { LANGUAGE_COUNTRY_SEED } from '../seed/language-countries.js';
+export async function runDictionarySeedReconciler(emFactory, ports) {
+    const em = emFactory();
+    const conn = em.getConnection();
+    const summary = {
+        countriesInserted: 0,
+        currenciesInserted: 0,
+        languagesBackfilled: 0,
+        translationsInserted: 0,
+        languageCountriesInserted: 0,
+    };
+    // 1) Currencies — insert missing rows, then read the table back. The order
+    // matters and is why the two are not one call: step 2 only sets a country's
+    // `default_currency_code` when the currency is really there.
+    summary.currenciesInserted = await ports.currencySeed.ensureSeeded(CURRENCY_SEED);
+    const present = await loadPresentCodes(conn, ports);
+    // 2) Countries — insert missing rows.
+    for (const c of COUNTRY_SEED) {
+        if (present.countries.has(c.code))
+            continue;
+        // Defensive: only set defaultCurrencyCode if the currency exists.
+        const defaultCurrency = c.defaultCurrencyCode && present.currencies.has(c.defaultCurrencyCode)
+            ? c.defaultCurrencyCode
+            : null;
+        await conn.execute(`insert into "countries"
+         ("code","alpha3_code","numeric_code","label","region","subregion",
+          "dial_code","is_eu_member","default_currency_code",
+          "is_active","is_default","sort_order","created_at","updated_at")
+       values (?,?,?,?,?,?,?,?,?,?,?,?,now(),now())`, [
+            c.code,
+            c.alpha3Code,
+            c.numericCode,
+            c.label,
+            c.region,
+            c.subregion ?? null,
+            c.dialCode ?? null,
+            c.isEuMember ?? false,
+            defaultCurrency,
+            c.isActive ?? true,
+            c.isDefault ?? false,
+            c.sortOrder ?? 0,
+        ]);
+        present.countries.add(c.code);
+        summary.countriesInserted += 1;
+    }
+    // 3) Languages — backfill `native_label` ONLY when still the empty
+    // string left by the migration. The seed only knows the two languages
+    // already created by migration 012.
+    summary.languagesBackfilled = await ports.languageSeed.backfillNativeLabels([
+        { code: 'en-US', nativeLabel: 'English (US)' },
+        { code: 'pl-PL', nativeLabel: 'Polski' },
+    ]);
+    // 4) Translations + 5) language↔country — load the existing keysets,
+    // then insert only what's missing.
+    const presentRels = await loadPresentTranslations(conn);
+    for (const t of POLISH_TRANSLATION_SEED) {
+        const parentSet = t.entryType === 'country'
+            ? present.countries
+            : t.entryType === 'currency'
+                ? present.currencies
+                : present.languages;
+        if (!parentSet.has(t.entryCode))
+            continue;
+        if (!present.languages.has(t.languageCode))
+            continue;
+        const key = `${t.entryType}|${t.entryCode}|${t.languageCode}`;
+        if (presentRels.translations.has(key))
+            continue;
+        await conn.execute(`insert into "dictionary_translations"
+         ("entry_type","entry_code","language_code","label","created_at","updated_at")
+       values (?,?,?,?,now(),now())`, [t.entryType, t.entryCode, t.languageCode, t.label]);
+        presentRels.translations.add(key);
+        summary.translationsInserted += 1;
+    }
+    for (const lc of LANGUAGE_COUNTRY_SEED) {
+        if (!present.languages.has(lc.languageCode))
+            continue;
+        if (!present.countries.has(lc.countryCode))
+            continue;
+        const key = `${lc.languageCode}|${lc.countryCode}`;
+        if (presentRels.languageCountries.has(key))
+            continue;
+        await conn.execute(`insert into "language_countries"
+         ("language_code","country_code","is_primary","created_at")
+       values (?,?,?,now())`, [lc.languageCode, lc.countryCode, lc.isPrimary]);
+        presentRels.languageCountries.add(key);
+        summary.languageCountriesInserted += 1;
+    }
+    return summary;
+}
+/**
+ * `countries` is this module's own table and is read in SQL; the other two are
+ * read through their owners' published read ports, which is what retires the
+ * `select "code" from "currencies"` / `"languages"` pair D-87 seeded.
+ */
+async function loadPresentCodes(conn, ports) {
+    const [countries, currencies, languages] = await Promise.all([
+        conn.execute(`select "code" from "countries"`),
+        ports.currencyRead.list(),
+        ports.languageRead.list(),
+    ]);
+    return {
+        countries: new Set(countries.map((r) => r.code)),
+        currencies: new Set(currencies.map((r) => r.code)),
+        languages: new Set(languages.map((r) => r.code)),
+    };
+}
+async function loadPresentTranslations(conn) {
+    const [translations, languageCountries] = await Promise.all([
+        conn.execute(`select "entry_type","entry_code","language_code" from "dictionary_translations"`),
+        conn.execute(`select "language_code","country_code" from "language_countries"`),
+    ]);
+    return {
+        translations: new Set(translations.map((r) => `${r.entry_type}|${r.entry_code}|${r.language_code}`)),
+        languageCountries: new Set(languageCountries.map((r) => `${r.language_code}|${r.country_code}`)),
+    };
+}
+//# sourceMappingURL=seed-reconciler.js.map