@endora-commerce/mod-languages 0.100.0

package/dist/backend/services/language-reference-registry.js

@@ -0,0 +1,54 @@
+/**
+ * In-process registry of "who still points at this language code" descriptors
+ * (feature 077, D-87 drain).
+ *
+ * Registered under `languageReferenceRegistry` and contributed to from other modules'
+ * boot hooks. This module consults it before deleting a language, and
+ * `dictionaries` consults it to build the orphan report.
+ *
+ * **Enumeration policy: honoured while the contributing module is absent.**
+ * D-39's default is to skip, and honouring needs a written reason: this is
+ * referential integrity, not a surface. A switched-off module still owns the
+ * rows that carry the code, so skipping its descriptor would let an operator
+ * delete a language that comes back as a dangling reference the moment the module
+ * is switched on again — data loss caused by an action Constitution XVII
+ * promises is non-destructive and reversible.
+ *
+ * `ownerModuleId` is recorded on every descriptor even though this registry
+ * does not filter on it, because the alternative is a registry that could not
+ * express the decision either way, and because it attributes a 409 to a module.
+ */
+export class LanguageReferenceRegistry {
+    descriptors = [];
+    register(descriptor) {
+        if (!this.descriptors.includes(descriptor)) {
+            this.descriptors.push(descriptor);
+        }
+    }
+    /** The contributing module of every registered descriptor, in registration order. */
+    owners() {
+        return this.descriptors.map((d) => d.ownerModuleId);
+    }
+    async countReferences(code) {
+        const counts = await Promise.all(this.descriptors.map(async (d) => ({ descriptor: d, count: await d.countReferences(code) })));
+        return counts
+            .filter((row) => row.count > 0)
+            .map(({ descriptor, count }) => describe(descriptor, code, count));
+    }
+    async usedCodes() {
+        const perDescriptor = await Promise.all(this.descriptors.map(async (d) => ({ descriptor: d, rows: await d.usedCodes() })));
+        return perDescriptor.flatMap(({ descriptor, rows }) => rows.map((row) => describe(descriptor, row.code, row.count)));
+    }
+}
+function describe(descriptor, code, count) {
+    return {
+        ownerModuleId: descriptor.ownerModuleId,
+        consumer: descriptor.consumer,
+        tableName: descriptor.tableName,
+        columnName: descriptor.columnName,
+        code,
+        count,
+        blocking: descriptor.blocking,
+    };
+}
+//# sourceMappingURL=language-reference-registry.js.map

package/dist/backend/services/language-reference-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-reference-registry.js","sourceRoot":"","sources":["../../../src/backend/services/language-reference-registry.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,yBAAyB;IACnB,WAAW,GAAoC,EAAE,CAAC;IAEnE,QAAQ,CAAC,UAAyC;QAChD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAC7F,CAAC;QACF,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;aAC9B,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAClF,CAAC;QACF,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CACpD,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAC7D,CAAC;IACJ,CAAC;CACF;AAED,SAAS,QAAQ,CACf,UAAyC,EACzC,IAAY,EACZ,KAAa;IAEb,OAAO;QACL,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { LanguageSeedPort } from '@endora-commerce/contracts';
+import type { EntityManager } from '@mikro-orm/postgresql';
+/**
+ * The seeding face of `languages` (feature 077, D-87 drain).
+ *
+ * One job: fill the empty `native_label` that migration 038 left behind on the
+ * two languages migration 012 created. `dictionaries` knows the labels — it
+ * ships the reference catalogue — and this module owns the table, so before
+ * this port the reconciler wrote it with an `update "languages" …` naming
+ * another module's table in a string no import-level check can see.
+ *
+ * The `and "native_label" = ''` predicate is the idempotency: once an operator
+ * (or an earlier boot) has set a label, a re-run matches no row and reverts
+ * nothing.
+ */
+export declare class LanguageSeedService implements LanguageSeedPort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    backfillNativeLabels(rows: readonly {
+        code: string;
+        nativeLabel: string;
+    }[]): Promise<number>;
+}
+//# sourceMappingURL=language-seed-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language-seed-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/language-seed-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,oBAAoB,CACxB,IAAI,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,GACrD,OAAO,CAAC,MAAM,CAAC;CAqBnB"}

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

@@ -0,0 +1,40 @@
+/**
+ * The seeding face of `languages` (feature 077, D-87 drain).
+ *
+ * One job: fill the empty `native_label` that migration 038 left behind on the
+ * two languages migration 012 created. `dictionaries` knows the labels — it
+ * ships the reference catalogue — and this module owns the table, so before
+ * this port the reconciler wrote it with an `update "languages" …` naming
+ * another module's table in a string no import-level check can see.
+ *
+ * The `and "native_label" = ''` predicate is the idempotency: once an operator
+ * (or an earlier boot) has set a label, a re-run matches no row and reverts
+ * nothing.
+ */
+export class LanguageSeedService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async backfillNativeLabels(rows) {
+        const em = this.emFactory();
+        let filled = 0;
+        for (const row of rows) {
+            const before = (await em.execute('select "native_label" from "languages" where "code" = ?', [
+                row.code,
+            ]));
+            if (before.length === 0)
+                continue;
+            if (before[0]?.native_label !== '')
+                continue;
+            // command-coverage-ignore: idempotent lifecycle reconciler/seed — a system-
+            // owned backfill of a column the migration left empty, with no actor behind
+            // it. The `= ''` predicate means it can only ever fill a blank, never
+            // overwrite an operator's label, so there is nothing to audit or undo.
+            await em.execute(`update "languages" set "native_label" = ? where "code" = ? and "native_label" = ''`, [row.nativeLabel, row.code]);
+            filled += 1;
+        }
+        return filled;
+    }
+}
+//# sourceMappingURL=language-seed-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language-seed-service.js","sourceRoot":"","sources":["../../../src/backend/services/language-seed-service.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,SAA8B;QAA9B,cAAS,GAAT,SAAS,CAAqB;IAAG,CAAC;IAE/D,KAAK,CAAC,oBAAoB,CACxB,IAAsD;QAEtD,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,yDAAyD,EAAE;gBAC1F,GAAG,CAAC,IAAI;aACT,CAAC,CAAoC,CAAC;YACvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAClC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,KAAK,EAAE;gBAAE,SAAS;YAC7C,4EAA4E;YAC5E,4EAA4E;YAC5E,sEAAsE;YACtE,uEAAuE;YACvE,MAAM,EAAE,CAAC,OAAO,CACd,oFAAoF,EACpF,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,CAC5B,CAAC;YACF,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,99 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type DictionaryReference, type DictionaryReferenceRegistryPort } from '@endora-commerce/contracts';
+import { Language } from '../entities/language.entity.js';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+/**
+ * LanguageService — admin CRUD over the languages pool.
+ *
+ * Originally introduced by feature 004 (T238 / FR-105) for the minimal
+ * languages table. Extended by feature 017 to cover the new columns
+ * (`nativeLabel`, `isRtl`, `fallbackCode`) and the spec invariants:
+ *
+ *   - exactly one default at a time (partial unique index, transactional
+ *     promote+demote).
+ *   - at-least-one-active (the only active row cannot be deactivated).
+ *   - default-cannot-be-deactivated.
+ *   - fallback-cycle guard (the `code → fallback_code → ...` chain must
+ *     terminate without revisiting any node).
+ *   - FK-protected hard-delete: refused while any consumer references the
+ *     language (sales channels' default_language + languages JSONB,
+ *     megamenu bindings, blog post / category languages, CMS page
+ *     languages).
+ */
+export declare class LanguageService {
+    #private;
+    private readonly emFactory;
+    private readonly invalidateDictionaryCache?;
+    private readonly 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.
+     */
+    private readonly referenceRegistry?;
+    constructor(emFactory: () => EntityManager, invalidateDictionaryCache?: (() => Promise<void>) | undefined, auditLog?: AuditPort | undefined, 
+    /**
+     * 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?: (() => DictionaryReferenceRegistryPort) | undefined);
+    list(): Promise<Language[]>;
+    listActive(): Promise<Language[]>;
+    getDefault(): Promise<Language | null>;
+    getByCode(code: string): Promise<Language | null>;
+    create(input: {
+        code: string;
+        label: string;
+        nativeLabel: string;
+        isRtl?: boolean;
+        fallbackCode?: string | null;
+        isActive?: boolean;
+        sortOrder?: number;
+    }): Promise<Language>;
+    /**
+     * Legacy upsert kept for the existing `/api/v1/admin/languages/:code`
+     * endpoint. Sets only the legacy fields. The dictionary admin surface
+     * uses `update()` for the extended fields.
+     */
+    upsert(input: {
+        code: string;
+        label: string;
+        isActive?: boolean;
+        sortOrder?: number;
+    }): Promise<Language>;
+    /**
+     * Extended update used by the Dictionary admin surface (feature 017).
+     * Supports every column on the Language entity and enforces the spec
+     * invariants (default-cannot-be-deactivated, at-least-one-active,
+     * fallback-cycle).
+     */
+    update(code: string, input: {
+        label?: string;
+        nativeLabel?: string;
+        isRtl?: boolean;
+        fallbackCode?: string | null;
+        isActive?: boolean;
+        sortOrder?: number;
+    }): Promise<Language>;
+    setDefault(code: string): Promise<Language>;
+    /**
+     * Every consumer reference to `code`, across the platform (feature 077, D-87).
+     *
+     * This used to be six hand-written `count(*)` statements naming
+     * `sales_channels`, `megamenu_bindings`, `blog_post_languages`,
+     * `blog_category_languages` and `cms_pages` — five tables this module does not
+     * own, in strings no import-level boundary check can see. Four of them are
+     * contributed descriptors now (`languageReferenceRegistry`); the fifth is the
+     * kernel's channel table, which this module may read through the ORM because
+     * the kernel is not a module (D-32).
+     *
+     * Channels are counted in memory rather than in SQL: a deployment has tens of
+     * them, both questions are about the same rows, and `languages` is a JSON
+     * array whose containment test was the reason the statement existed at all.
+     */
+    countDependents(code: string): Promise<DictionaryReference[]>;
+    remove(code: string): Promise<void>;
+    private assertNoCycle;
+}
+//# sourceMappingURL=language-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/language-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,+BAA+B,EACrC,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBARlB,SAAS,EAAE,MAAM,aAAa,EAC9B,yBAAyB,CAAC,GAAE,MAAM,OAAO,CAAC,IAAI,CAAC,aAAA,EAC/C,QAAQ,CAAC,EAAE,SAAS,YAAA;IACrC;;;;OAIG;IACc,iBAAiB,CAAC,GAAE,MAAM,+BAA+B,aAAA;IAqBtE,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK3B,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOjC,UAAU,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAKtC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAKjD,MAAM,CAAC,KAAK,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoCrB;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8CrB;;;;;OAKG;IACG,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,QAAQ,CAAC;IAwDd,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4BjD;;;;;;;;;;;;;;OAcG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAmC7D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YA+B3B,aAAa;CA0B5B"}

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

@@ -0,0 +1,299 @@
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Language } from '../entities/language.entity.js';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+/**
+ * LanguageService — admin CRUD over the languages pool.
+ *
+ * Originally introduced by feature 004 (T238 / FR-105) for the minimal
+ * languages table. Extended by feature 017 to cover the new columns
+ * (`nativeLabel`, `isRtl`, `fallbackCode`) and the spec invariants:
+ *
+ *   - exactly one default at a time (partial unique index, transactional
+ *     promote+demote).
+ *   - at-least-one-active (the only active row cannot be deactivated).
+ *   - default-cannot-be-deactivated.
+ *   - fallback-cycle guard (the `code → fallback_code → ...` chain must
+ *     terminate without revisiting any node).
+ *   - FK-protected hard-delete: refused while any consumer references the
+ *     language (sales channels' default_language + languages JSONB,
+ *     megamenu bindings, blog post / category languages, CMS page
+ *     languages).
+ */
+export class LanguageService {
+    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: 'language',
+                objectId,
+                stateBefore,
+                stateAfter,
+            });
+        }
+    }
+    async list() {
+        const em = this.emFactory();
+        return em.find(Language, {}, { orderBy: { sortOrder: 'asc', code: 'asc' } });
+    }
+    async listActive() {
+        const em = this.emFactory();
+        // `code` tiebreak keeps the order deterministic when several languages
+        // share a sortOrder (e.g. the seed default 0) — matches list() above.
+        return em.find(Language, { isActive: true }, { orderBy: { sortOrder: 'asc', code: 'asc' } });
+    }
+    async getDefault() {
+        const em = this.emFactory();
+        return em.findOne(Language, { isDefault: true });
+    }
+    async getByCode(code) {
+        const em = this.emFactory();
+        return em.findOne(Language, { code });
+    }
+    async create(input) {
+        const em = this.emFactory();
+        const existing = await em.findOne(Language, { code: input.code });
+        if (existing) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `Language ${input.code} already exists.`);
+        }
+        if (input.fallbackCode !== undefined && input.fallbackCode !== null) {
+            if (input.fallbackCode === input.code) {
+                throw new HttpError(409, ERROR_CODES.DICTIONARY_FALLBACK_CYCLE, 'A language cannot fall back to itself.');
+            }
+            await this.assertNoCycle(em, input.code, input.fallbackCode);
+        }
+        const row = em.create(Language, {
+            code: input.code,
+            label: input.label,
+            nativeLabel: input.nativeLabel,
+            ...(input.isRtl !== undefined ? { isRtl: input.isRtl } : {}),
+            ...(input.fallbackCode !== undefined ? { fallbackCode: input.fallbackCode } : {}),
+            ...(input.isActive !== undefined ? { isActive: input.isActive } : {}),
+            ...(input.sortOrder !== undefined ? { sortOrder: input.sortOrder } : {}),
+        });
+        em.persist(row);
+        this.#audit(em, 'language.create', row.code, null, { label: row.label });
+        await em.flush();
+        await this.invalidateDictionaryCache?.();
+        return row;
+    }
+    /**
+     * Legacy upsert kept for the existing `/api/v1/admin/languages/:code`
+     * endpoint. Sets only the legacy fields. The dictionary admin surface
+     * uses `update()` for the extended fields.
+     */
+    async upsert(input) {
+        const em = this.emFactory();
+        const existing = await em.findOne(Language, { code: input.code });
+        if (existing) {
+            // 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 language. Promote a different language first.');
+            }
+            if (input.isActive === false && existing.isActive) {
+                const otherActive = await em.count(Language, {
+                    isActive: true,
+                    code: { $ne: input.code },
+                });
+                if (otherActive === 0) {
+                    throw new HttpError(409, ERROR_CODES.DICTIONARY_LAST_ACTIVE_ENTRY, 'At least one language must remain active.');
+                }
+            }
+            existing.label = input.label;
+            if (input.isActive !== undefined)
+                existing.isActive = input.isActive;
+            if (input.sortOrder !== undefined)
+                existing.sortOrder = input.sortOrder;
+            this.#audit(em, 'language.upsert', existing.code, null, { label: existing.label });
+            await em.flush();
+            await this.invalidateDictionaryCache?.();
+            return existing;
+        }
+        const row = em.create(Language, {
+            code: input.code,
+            label: input.label,
+            ...(input.isActive !== undefined ? { isActive: input.isActive } : {}),
+            ...(input.sortOrder !== undefined ? { sortOrder: input.sortOrder } : {}),
+        });
+        em.persist(row);
+        this.#audit(em, 'language.upsert', row.code, null, { label: row.label });
+        await em.flush();
+        await this.invalidateDictionaryCache?.();
+        return row;
+    }
+    /**
+     * Extended update used by the Dictionary admin surface (feature 017).
+     * Supports every column on the Language entity and enforces the spec
+     * invariants (default-cannot-be-deactivated, at-least-one-active,
+     * fallback-cycle).
+     */
+    async update(code, input) {
+        const em = this.emFactory();
+        const existing = await em.findOne(Language, { code });
+        if (!existing) {
+            throw new HttpError(404, ERROR_CODES.DICTIONARY_ENTRY_NOT_FOUND, `Language ${code} not found.`);
+        }
+        if (input.isActive === false && existing.isDefault) {
+            throw new HttpError(409, ERROR_CODES.DICTIONARY_DEFAULT_CANNOT_BE_DEACTIVATED, 'Cannot deactivate the default language. Promote a different language first.');
+        }
+        if (input.isActive === false && existing.isActive) {
+            const otherActive = await em.count(Language, {
+                isActive: true,
+                code: { $ne: code },
+            });
+            if (otherActive === 0) {
+                throw new HttpError(409, ERROR_CODES.DICTIONARY_LAST_ACTIVE_ENTRY, 'At least one language must remain active.');
+            }
+        }
+        if (input.fallbackCode !== undefined && input.fallbackCode !== null) {
+            if (input.fallbackCode === code) {
+                throw new HttpError(409, ERROR_CODES.DICTIONARY_FALLBACK_CYCLE, 'A language cannot fall back to itself.');
+            }
+            await this.assertNoCycle(em, code, input.fallbackCode);
+        }
+        if (input.label !== undefined)
+            existing.label = input.label;
+        if (input.nativeLabel !== undefined)
+            existing.nativeLabel = input.nativeLabel;
+        if (input.isRtl !== undefined)
+            existing.isRtl = input.isRtl;
+        if (input.fallbackCode !== undefined)
+            existing.fallbackCode = input.fallbackCode;
+        if (input.isActive !== undefined)
+            existing.isActive = input.isActive;
+        if (input.sortOrder !== undefined)
+            existing.sortOrder = input.sortOrder;
+        this.#audit(em, 'language.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(Language, { code });
+        if (!target) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Language ${code} not found.`);
+        }
+        if (!target.isActive) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, 'Cannot mark an inactive language as default.');
+        }
+        if (target.isDefault)
+            return target;
+        // Demote-then-promote inside the EM's current tx scope (em.transactional
+        // would fork into a separate tx that commits independently — breaks the
+        // test fork+rollback pattern and the cross-module composition root's
+        // outer-tx semantics).
+        await em.nativeUpdate(Language, { isDefault: true }, { isDefault: false });
+        await em.nativeUpdate(Language, { code }, { isDefault: true });
+        target.isDefault = true;
+        this.#audit(em, 'language.set_default', code, null, { isDefault: true });
+        await em.flush();
+        await this.invalidateDictionaryCache?.();
+        return target;
+    }
+    /**
+     * Every consumer reference to `code`, across the platform (feature 077, D-87).
+     *
+     * This used to be six hand-written `count(*)` statements naming
+     * `sales_channels`, `megamenu_bindings`, `blog_post_languages`,
+     * `blog_category_languages` and `cms_pages` — five tables this module does not
+     * own, in strings no import-level boundary check can see. Four of them are
+     * contributed descriptors now (`languageReferenceRegistry`); the fifth is the
+     * kernel's channel table, which this module may read through the ORM because
+     * the kernel is not a module (D-32).
+     *
+     * Channels are counted in memory rather than in SQL: a deployment has tens of
+     * them, both questions are about the same rows, and `languages` is a JSON
+     * array whose containment test was the reason the statement existed at all.
+     */
+    async countDependents(code) {
+        const channels = await this.emFactory().find(SalesChannel, {});
+        const references = [];
+        const asDefault = channels.filter((channel) => channel.defaultLanguage === code).length;
+        if (asDefault > 0) {
+            references.push({
+                ownerModuleId: 'sales_channels',
+                consumer: 'sales_channels',
+                tableName: 'sales_channels',
+                columnName: 'default_language',
+                code,
+                count: asDefault,
+                blocking: true,
+            });
+        }
+        const listed = channels.filter((channel) => channel.languages.includes(code)).length;
+        if (listed > 0) {
+            references.push({
+                ownerModuleId: 'sales_channels',
+                consumer: 'sales_channels',
+                tableName: 'sales_channels',
+                columnName: 'languages[]',
+                code,
+                count: listed,
+                blocking: true,
+            });
+        }
+        const registry = this.referenceRegistry?.();
+        if (registry)
+            references.push(...(await registry.countReferences(code)));
+        return references;
+    }
+    async remove(code) {
+        const em = this.emFactory();
+        const row = await em.findOne(Language, { code });
+        if (!row)
+            return;
+        if (row.isDefault) {
+            throw new HttpError(409, ERROR_CODES.DICTIONARY_DEFAULT_CANNOT_BE_DEACTIVATED, 'Cannot remove the default language.');
+        }
+        const dependents = await this.countDependents(code);
+        // Which references refuse the delete is the contributing module's call,
+        // carried on the descriptor: a column its own foreign key blanks on delete
+        // is reported but does not block.
+        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, `Language ${code} cannot be deleted because ${total} consumer reference(s) exist.`, [{ path: 'consumers', issue: JSON.stringify(dependents) }]);
+        }
+        this.#audit(em, 'language.delete', row.code, { label: row.label }, null);
+        await em.removeAndFlush(row);
+        await this.invalidateDictionaryCache?.();
+    }
+    async assertNoCycle(em, startCode, proposedFallback) {
+        // Walk the existing graph from `proposedFallback` and ensure we never
+        // arrive back at `startCode`. Bound the walk by the registry size so a
+        // pathological dataset cannot loop.
+        const visited = new Set([startCode]);
+        let cursor = proposedFallback;
+        let steps = 0;
+        const maxSteps = 32;
+        while (cursor && steps < maxSteps) {
+            if (visited.has(cursor)) {
+                throw new HttpError(409, ERROR_CODES.DICTIONARY_FALLBACK_CYCLE, `Setting fallback_code to ${proposedFallback} would create a cycle through ${cursor}.`);
+            }
+            visited.add(cursor);
+            const next = await em.findOne(Language, { code: cursor });
+            cursor = next?.fallbackCode ?? null;
+            steps += 1;
+        }
+    }
+}
+//# sourceMappingURL=language-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language-service.js","sourceRoot":"","sources":["../../../src/backend/services/language-service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,GAGZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAG5E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,eAAe;IAEP;IACA;IACA;IAMA;IATnB,YACmB,SAA8B,EAC9B,yBAA+C,EAC/C,QAAoB;IACrC;;;;OAIG;IACc,iBAAyD;QARzD,cAAS,GAAT,SAAS,CAAqB;QAC9B,8BAAyB,GAAzB,yBAAyB,CAAsB;QAC/C,aAAQ,GAAR,QAAQ,CAAY;QAMpB,sBAAiB,GAAjB,iBAAiB,CAAwC;IACzE,CAAC;IAEJ,MAAM,CACJ,EAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,WAA2C,EAC3C,UAA0C;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE;gBACxC,MAAM;gBACN,UAAU,EAAE,UAAU;gBACtB,QAAQ;gBACR,WAAW;gBACX,UAAU;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,uEAAuE;QACvE,sEAAsE;QACtE,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAQZ;QACC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,iBAAiB,EAC7B,YAAY,KAAK,CAAC,IAAI,kBAAkB,CACzC,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACpE,IAAI,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;gBACtC,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,yBAAyB,EACrC,wCAAwC,CACzC,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC,CAAC;QACH,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,KAKZ;QACC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,IAAI,QAAQ,EAAE,CAAC;YACb,2CAA2C;YAC3C,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACnD,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,wCAAwC,EACpD,6EAA6E,CAC9E,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAClD,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;oBAC3C,QAAQ,EAAE,IAAI;oBACd,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE;iBAC1B,CAAC,CAAC;gBACH,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;oBACtB,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,4BAA4B,EACxC,2CAA2C,CAC5C,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC7B,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;gBAAE,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YACrE,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;gBAAE,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YACxE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YACnF,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;YACzC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC,CAAC;QACH,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,IAAY,EACZ,KAOC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,0BAA0B,EACtC,YAAY,IAAI,aAAa,CAC9B,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACnD,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,wCAAwC,EACpD,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAClD,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;gBAC3C,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;aACpB,CAAC,CAAC;YACH,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,4BAA4B,EACxC,2CAA2C,CAC5C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACpE,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBAChC,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,yBAAyB,EACrC,wCAAwC,CACzC,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC5D,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;YAAE,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAC9E,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC5D,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;YAAE,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;QACjF,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,QAAQ,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACrE,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAExE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChH,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE,YAAY,IAAI,aAAa,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,iBAAiB,EAC7B,8CAA8C,CAC/C,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC;QAEpC,yEAAyE;QACzE,wEAAwE;QACxE,qEAAqE;QACrE,uBAAuB;QACvB,MAAM,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,UAAU,GAA0B,EAAE,CAAC;QAE7C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;QACxF,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC;gBACd,aAAa,EAAE,gBAAgB;gBAC/B,QAAQ,EAAE,gBAAgB;gBAC1B,SAAS,EAAE,gBAAgB;gBAC3B,UAAU,EAAE,kBAAkB;gBAC9B,IAAI;gBACJ,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACrF,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,UAAU,CAAC,IAAI,CAAC;gBACd,aAAa,EAAE,gBAAgB;gBAC/B,QAAQ,EAAE,gBAAgB;gBAC1B,SAAS,EAAE,gBAAgB;gBAC3B,UAAU,EAAE,aAAa;gBACzB,IAAI;gBACJ,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC5C,IAAI,QAAQ;YAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,wCAAwC,EACpD,qCAAqC,CACtC,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACpD,wEAAwE;QACxE,2EAA2E;QAC3E,kCAAkC;QAClC,MAAM,KAAK,GAAG,UAAU;aACrB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC;aACzC,MAAM,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACxD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,+BAA+B,EAC3C,YAAY,IAAI,8BAA8B,KAAK,+BAA+B,EAClF,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,CAAC,yBAAyB,EAAE,EAAE,CAAC;IAC3C,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,EAAiB,EACjB,SAAiB,EACjB,gBAAwB;QAExB,sEAAsE;QACtE,uEAAuE;QACvE,oCAAoC;QACpC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7C,IAAI,MAAM,GAAkB,gBAAgB,CAAC;QAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,QAAQ,GAAG,EAAE,CAAC;QACpB,OAAO,MAAM,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,yBAAyB,EACrC,4BAA4B,gBAAgB,iCAAiC,MAAM,GAAG,CACvF,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,MAAM,IAAI,GAAoB,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3E,MAAM,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;YACpC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/backend/services/locale-service.d.ts

@@ -0,0 +1,35 @@
+import type { LanguageService } from './language-service.js';
+/**
+ * LocaleService — the small chunk of behaviour FR-105 calls
+ * "translation-fallback middleware".
+ *
+ * Two responsibilities:
+ *   1. `pickLocalizedValue(record, requestedLocale, defaultLocale?)` — given a
+ *      `Record<localeCode, string>` (the multilingual JSONB shape used by
+ *      Product / Category / CMS), return the best available string. Order:
+ *      requested → default → first present → empty string.
+ *   2. `resolveRequestLocale(acceptLanguageHeader)` — pick a supported
+ *      locale for the current request, with the admin-configured default
+ *      as the last-resort fallback.
+ *
+ * The default locale is read once per resolver and cached for the lifetime
+ * of the service instance to avoid hitting the DB on every request; it is
+ * refreshed on `invalidateDefault()` after admin mutations.
+ */
+export declare class LocaleService {
+    private readonly languageService;
+    private cachedDefaultCode;
+    private cachedDefaultLoadedAt;
+    private readonly cacheTtlMs;
+    constructor(languageService: LanguageService);
+    pickLocalizedValue(record: Record<string, string> | null | undefined, requestedLocale: string, defaultLocale?: string): string;
+    getDefaultLocale(): Promise<string>;
+    invalidateDefault(): void;
+    /**
+     * Resolve a single locale string from an Accept-Language header against
+     * the active language pool. Returns the configured default when nothing
+     * matches.
+     */
+    resolveRequestLocale(acceptLanguageHeader: string | undefined, activeLocales: string[]): Promise<string>;
+}
+//# sourceMappingURL=locale-service.d.ts.map

package/dist/backend/services/locale-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/locale-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJ5C,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAER,eAAe,EAAE,eAAe;IAE7D,kBAAkB,CAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACjD,eAAe,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM;IAQH,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAWzC,iBAAiB,IAAI,IAAI;IAKzB;;;;OAIG;IACG,oBAAoB,CACxB,oBAAoB,EAAE,MAAM,GAAG,SAAS,EACxC,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC;CAiBnB"}