@endora-commerce/mod-languages 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-languages
+
+Storefront/admin language catalog and per-channel locale routing.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `languages` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-languages` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-languages/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-languages/migrations` | the module’s own schema migrations, in the order the platform runs them |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/contracts`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-languages
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/backend/entities/language.entity.d.ts

@@ -0,0 +1,23 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Language — installation-wide pool of supported BCP-47 language tags
+ * (T238 / FR-105). Exactly zero or one row has `isDefault=true`, enforced
+ * by a partial unique index in the migration.
+ */
+export declare class Language {
+    [OptionalProps]?: 'createdAt' | 'updatedAt' | 'isDefault' | 'isActive' | 'sortOrder' | 'nativeLabel' | 'isRtl' | 'fallbackCode';
+    /** BCP-47 tag: `en-US`, `pl-PL`, `de`, …. Acts as the natural primary key. */
+    code: string;
+    label: string;
+    /** The language's name in itself (e.g. `Polski`, `Deutsch`). Added by feature 017. */
+    nativeLabel: string;
+    isRtl: boolean;
+    /** Optional fallback code for missing translations. Self-FK; cycles forbidden at the service layer. */
+    fallbackCode?: string | null;
+    isDefault: boolean;
+    isActive: boolean;
+    sortOrder: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=language.entity.d.ts.map

package/dist/backend/entities/language.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/language.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAG9E;;;;GAIG;AACH,qBAEa,QAAQ;IACnB,CAAC,aAAa,CAAC,CAAC,EACZ,WAAW,GACX,WAAW,GACX,WAAW,GACX,UAAU,GACV,WAAW,GACX,aAAa,GACb,OAAO,GACP,cAAc,CAAC;IAEnB,8EAA8E;IAE9E,IAAI,EAAG,MAAM,CAAC;IAGd,KAAK,EAAG,MAAM,CAAC;IAEf,sFAAsF;IAEtF,WAAW,EAAE,MAAM,CAAM;IAGzB,KAAK,EAAE,OAAO,CAAS;IAEvB,uGAAuG;IAEvG,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,SAAS,EAAE,OAAO,CAAS;IAG3B,QAAQ,EAAE,OAAO,CAAQ;IAGzB,SAAS,EAAE,MAAM,CAAK;IAGtB,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/language.entity.js

@@ -0,0 +1,78 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+/**
+ * Language — installation-wide pool of supported BCP-47 language tags
+ * (T238 / FR-105). Exactly zero or one row has `isDefault=true`, enforced
+ * by a partial unique index in the migration.
+ */
+let Language = class Language {
+    [OptionalProps];
+    /** BCP-47 tag: `en-US`, `pl-PL`, `de`, …. Acts as the natural primary key. */
+    code;
+    label;
+    /** The language's name in itself (e.g. `Polski`, `Deutsch`). Added by feature 017. */
+    nativeLabel = '';
+    isRtl = false;
+    /** Optional fallback code for missing translations. Self-FK; cycles forbidden at the service layer. */
+    fallbackCode;
+    isDefault = false;
+    isActive = true;
+    sortOrder = 0;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'string', length: 12 }),
+    __metadata("design:type", String)
+], Language.prototype, "code", void 0);
+__decorate([
+    Property({ type: 'string', length: 64 }),
+    __metadata("design:type", String)
+], Language.prototype, "label", void 0);
+__decorate([
+    Property({ type: 'string', length: 64 }),
+    __metadata("design:type", String)
+], Language.prototype, "nativeLabel", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    __metadata("design:type", Boolean)
+], Language.prototype, "isRtl", void 0);
+__decorate([
+    Property({ type: 'string', length: 12, nullable: true }),
+    __metadata("design:type", Object)
+], Language.prototype, "fallbackCode", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    __metadata("design:type", Boolean)
+], Language.prototype, "isDefault", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    __metadata("design:type", Boolean)
+], Language.prototype, "isActive", void 0);
+__decorate([
+    Property({ type: 'integer' }),
+    __metadata("design:type", Number)
+], Language.prototype, "sortOrder", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], Language.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], Language.prototype, "updatedAt", void 0);
+Language = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'languages' })
+], Language);
+export { Language };
+//# sourceMappingURL=language.entity.js.map

package/dist/backend/entities/language.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/language.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE;;;;GAIG;AAGI,IAAM,QAAQ,GAAd,MAAM,QAAQ;IACnB,CAAC,aAAa,CAAC,CAQI;IAEnB,8EAA8E;IAE9E,IAAI,CAAU;IAGd,KAAK,CAAU;IAEf,sFAAsF;IAEtF,WAAW,GAAW,EAAE,CAAC;IAGzB,KAAK,GAAY,KAAK,CAAC;IAEvB,uGAAuG;IAEvG,YAAY,CAAiB;IAG7B,SAAS,GAAY,KAAK,CAAC;IAG3B,QAAQ,GAAY,IAAI,CAAC;IAGzB,SAAS,GAAW,CAAC,CAAC;IAGtB,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AA9BC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;sCAC7B;AAGd;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;uCAC1B;AAIf;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;6CAChB;AAGzB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;uCACP;AAIvB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CAC5B;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;2CACH;AAG3B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;0CACL;AAGzB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;2CACR;AAGtB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;2CAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;2CAAc;AA1ClB,QAAQ;IAFpB,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;GACtB,QAAQ,CA2CpB"}

package/dist/backend/index.d.ts

@@ -0,0 +1,63 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import { type DictionaryReferenceRegistryPort } from '@endora-commerce/contracts';
+import { type ModuleContext } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { LanguageService } from './services/language-service.js';
+import { LocaleService } from './services/locale-service.js';
+import { Language } from './entities/language.entity.js';
+/**
+ * `languages` — the stale-accept `currencies` already fixed, still live here
+ * (feature 072, wave 2, T105).
+ *
+ * `LanguageService`'s second constructor argument is a dictionary-cache
+ * invalidator, and the factory passed a hard-coded `undefined`:
+ *
+ *     new LanguageService(options.emFactory, undefined, options.auditLog)
+ *
+ * So deactivating or deleting a language through this module's admin surface
+ * dropped nothing. `DictionaryValidator` caches existence and active-state
+ * in-process for 60 s (`TTL_MS`), and the Redis `DictionaryCache` holds
+ * dictionary reads for an hour by default — so a removed language kept
+ * validating for up to a minute in each process and kept being served for up to
+ * an hour. Meanwhile `currencies` announces its changes and both caches drop
+ * immediately. One validator, one platform, two behaviours.
+ *
+ * Wave 1 fixed the currency half (`f3bacb52`, "one CurrencyService, and the
+ * stale-accept it was caching") and left this half because `languages` was not
+ * yet converted. This closes it the same way, and the way matters: the module
+ * **announces** rather than calling the dictionary cache. Declaring that call as
+ * a dependency produces a real cycle — `dictionaries` reads `Language`, so
+ * `languages` calling into `dictionaries` would close a loop — and the cycle is
+ * the design saying a language must not know a dictionary cache exists. The
+ * root listens and invalidates, exactly as it already does for currencies.
+ *
+ * `auditLog` stops being optional while we are here: language writes are
+ * audited or they are not, and "not" should not be reachable by omission.
+ */
+export interface LanguagesCradle {
+    readonly emFactory: () => EntityManager;
+    readonly auditLogService: AuditPort;
+    /** Narrowed the same way `currencies` narrows it: announce, do not type. */
+    readonly eventBus: {
+        emit: (event: string, payload: unknown) => void;
+    };
+    readonly requireAdmin: RequireAdminFactory;
+    readonly languageService: LanguageService;
+    readonly localeService: LocaleService;
+    readonly languageReferenceRegistry: DictionaryReferenceRegistryPort;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export declare const entities: (typeof Language)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAGL,KAAK,+BAA+B,EAIrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAIjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,yBAAyB,EAAE,+BAA+B,CAAC;CACrE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmHvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,qBAEpB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,114 @@
+import { LANGUAGE_CHANGED_EVENT, } from '@endora-commerce/contracts';
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { LanguageService } from './services/language-service.js';
+import { LanguageReadService, createLanguageAdminPort } from './services/language-ports.js';
+import { LanguageReferenceRegistry } from './services/language-reference-registry.js';
+import { LanguageSeedService } from './services/language-seed-service.js';
+import { LocaleService } from './services/locale-service.js';
+import { registerI18nRoutes } from './routes.js';
+import { Language } from './entities/language.entity.js';
+export function registerModule(ctx) {
+    ctx.di.providePort('languageService', ctx
+        .asFunction(({ emFactory, auditLogService }) => {
+        const announce = async () => {
+            ctx.cradle().eventBus.emit(LANGUAGE_CHANGED_EVENT, {});
+        };
+        return new LanguageService(emFactory, announce, auditLogService, () => ctx.cradle().languageReferenceRegistry);
+    })
+        .singleton());
+    // ---------------------------------------------------------------------------
+    // Feature 075, Phase P — the published surface.
+    //
+    // `languageService` above hands out the class; ten of the sixteen inbound
+    // sites do not want a service at all, they read the `Language` **entity**
+    // to resolve a label, validate a code or walk a fallback chain. These two
+    // ports are what both halves rewire to, and neither lets the entity across.
+    //
+    // The write side crosses a boundary by design rather than by accident:
+    // `dictionaries` hosts the admin screen for this table. The invariants —
+    // exactly one default, a default may not be deactivated, a fallback chain
+    // may not cycle — stay on this side of the port, where they already were.
+    // ---------------------------------------------------------------------------
+    ctx.di.providePort('languageReadPort', ctx
+        .asFunction(({ emFactory }) => new LanguageReadService(emFactory))
+        .singleton());
+    ctx.di.providePort('languageAdminPort', ctx
+        .asFunction(() => createLanguageAdminPort(() => ctx.cradle().languageService))
+        .singleton());
+    // ---------------------------------------------------------------------------
+    // Feature 077 (D-87 drain) — who still points at a language?
+    //
+    // `LanguageService.remove` used to answer that with six hand-written counts
+    // over `megamenu`, `blog` (twice), `cms` and the kernel's channels. Four of
+    // the five named another module's table in a string, which no import-level
+    // boundary check can see. Contributors push a descriptor from their own boot
+    // hook now, and this module asks the registry instead.
+    //
+    // A plain `ctx.di.register`, not a port: a contributor resolves it from a boot
+    // hook, and a boot hook that resolved a transient gate would stop the backend
+    // from starting the moment this module was switched off. The descriptor is
+    // inert; `languageService`, which reads and writes languages, is the port and
+    // does fail closed. Enumeration policy is stated at the class.
+    ctx.di.register({
+        languageReferenceRegistry: ctx
+            .asFunction(() => new LanguageReferenceRegistry())
+            .singleton(),
+    });
+    /**
+     * The one write `dictionaries` needs against this table: filling the empty
+     * `native_label` migration 038 left behind. It used to run it as raw SQL from
+     * its own reconciler.
+     */
+    ctx.di.providePort('languageSeedPort', ctx
+        .asFunction(({ emFactory }) => new LanguageSeedService(emFactory))
+        .singleton());
+    ctx.di.register({
+        // `LocaleService` caches the default locale for 60 s and exposes
+        // `invalidateDefault()`, so it has to be a singleton — and a singleton may
+        // not capture `languageService`, which is a transient port gate. Awilix's
+        // strict mode refuses that outright, and it is right to: a captured port
+        // keeps answering after its module is switched off. The delegate resolves
+        // per call instead.
+        localeService: ctx
+            .asFunction(() => new LocaleService({
+            getDefault: () => ctx.cradle().languageService.getDefault(),
+        }))
+            .singleton(),
+    });
+    ctx.routes(async (app) => {
+        const { languageService, localeService, requireAdmin } = ctx.cradle();
+        await registerI18nRoutes(app, {
+            languageService,
+            // Feature 075, Phase C — `GET /api/v1/i18n/config` answers with both
+            // catalogues, and `currencies` owns one of them. Its half arrives over
+            // the port `currencies` publishes rather than over its service class, so
+            // this module names no file of theirs, and the endpoint answers 503
+            // `MODULE_DISABLED` if `currencies` ever stops being present. The proxy
+            // resolves per call: a port captured in a singleton keeps answering after
+            // its owner is switched off.
+            //
+            // `currencyAdminPort` went with the four `/api/v1/admin/currencies*`
+            // routes on 2026-08-29 — that was this module hosting another module's
+            // write surface, on the catalogue's permission code, for callers that do
+            // not exist. What is left is one composed read.
+            currencyRead: lazyPort(ctx, 'currencyReadPort'),
+            requireAdmin,
+            onConfigChange: () => localeService.invalidateDefault(),
+        });
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export const entities = [
+    Language,
+];
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

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

package/dist/backend/routes.d.ts

@@ -0,0 +1,28 @@
+import type { FastifyInstance } from 'fastify';
+import { type CurrencyReadPort } from '@endora-commerce/contracts';
+import type { LanguageService } from './services/language-service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export interface I18nRoutesDeps {
+    languageService: LanguageService;
+    /**
+     * Owned by `currencies` (feature 075, Phase C), and read by exactly one route
+     * here: `GET /api/v1/i18n/config`, which answers with both catalogues and
+     * their defaults in one public payload.
+     *
+     * The four `/api/v1/admin/currencies*` routes this module also served moved to
+     * `currencies` on 2026-08-29, and with them the `currencyAdminPort`
+     * resolution. That was a write surface for another module's table, gated on
+     * `catalog:write`, reached by nothing in this repository — the admin currency
+     * screen is `dictionaries`'. What is left is a read this endpoint composes,
+     * which is what a public aggregate is for. When `currencies` is off the port
+     * fails closed and this route answers 503 `MODULE_DISABLED`: a config payload
+     * that guesses a currency is worse than one that refuses, and `currencies` is
+     * non-deactivatable in any case.
+     */
+    currencyRead: CurrencyReadPort;
+    requireAdmin: RequireAdminFactory;
+    /** Called after any mutation so cached defaults get invalidated. */
+    onConfigChange?: () => void;
+}
+export declare function registerI18nRoutes(app: FastifyInstance, deps: I18nRoutesDeps): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/backend/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC;;;;;;;;;;;;;;OAcG;IACH,YAAY,EAAE,gBAAgB,CAAC;IAC/B,YAAY,EAAE,mBAAmB,CAAC;IAClC,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAqEf"}

package/dist/backend/routes.js

@@ -0,0 +1,74 @@
+import { upsertLanguageRequestSchema, } from '@endora-commerce/contracts';
+export async function registerI18nRoutes(app, deps) {
+    const { languageService, currencyRead, requireAdmin, onConfigChange } = deps;
+    // ---- Public (storefront + admin) i18n config ----
+    app.get('/api/v1/i18n/config', async () => {
+        const [languages, currencies, defaultLanguage, defaultCurrency] = await Promise.all([
+            languageService.listActive(),
+            currencyRead.listActive(),
+            languageService.getDefault(),
+            currencyRead.getDefault(),
+        ]);
+        return {
+            data: {
+                languages: languages.map(serializeLanguage),
+                currencies: currencies.map(serializeCurrency),
+                defaultLanguageCode: defaultLanguage?.code ?? null,
+                defaultCurrencyCode: defaultCurrency?.code ?? null,
+            },
+        };
+    });
+    // ---- Admin: languages ----
+    app.get('/api/v1/admin/languages', { preHandler: requireAdmin('catalog:write') }, async () => {
+        const rows = await languageService.list();
+        return { data: rows.map(serializeLanguage) };
+    });
+    app.put('/api/v1/admin/languages/:code', {
+        preHandler: requireAdmin('catalog:write'),
+        schema: { body: upsertLanguageRequestSchema },
+    }, async (request) => {
+        const body = upsertLanguageRequestSchema.parse(request.body);
+        const row = await languageService.upsert({
+            code: request.params.code,
+            label: body.label,
+            ...(body.isActive !== undefined ? { isActive: body.isActive } : {}),
+            ...(body.sortOrder !== undefined ? { sortOrder: body.sortOrder } : {}),
+        });
+        onConfigChange?.();
+        return { data: serializeLanguage(row) };
+    });
+    app.post('/api/v1/admin/languages/:code/default', { preHandler: requireAdmin('catalog:write') }, async (request) => {
+        const row = await languageService.setDefault(request.params.code);
+        onConfigChange?.();
+        return { data: serializeLanguage(row) };
+    });
+    app.delete('/api/v1/admin/languages/:code', { preHandler: requireAdmin('catalog:write') }, async (request, reply) => {
+        await languageService.remove(request.params.code);
+        onConfigChange?.();
+        return reply.status(204).send();
+    });
+}
+function serializeLanguage(l) {
+    return {
+        code: l.code,
+        label: l.label,
+        isDefault: l.isDefault,
+        isActive: l.isActive,
+        sortOrder: l.sortOrder,
+        createdAt: l.createdAt.toISOString(),
+        updatedAt: l.updatedAt.toISOString(),
+    };
+}
+function serializeCurrency(c) {
+    return {
+        code: c.code,
+        label: c.label,
+        symbol: c.symbol,
+        isDefault: c.isDefault,
+        isActive: c.isActive,
+        sortOrder: c.sortOrder,
+        createdAt: c.createdAt.toISOString(),
+        updatedAt: c.updatedAt.toISOString(),
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/backend/routes.js.map

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

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

@@ -0,0 +1,33 @@
+import type { LanguageAdminPort, LanguageReadPort, LanguageRecord } from '@endora-commerce/contracts';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { Language } from '../entities/language.entity.js';
+import type { LanguageService } from './language-service.js';
+/**
+ * The published face of `languages` (feature 075, Phase P).
+ *
+ * Sixteen inbound sites, and they split the way the module does: ten are
+ * `dictionaries` reading the `Language` **entity** to resolve a label,
+ * validate a code or walk a fallback chain, and six type themselves against
+ * `LanguageService` to call `listActive`.
+ *
+ * The read port answers both, and neither hands the entity over. `findByCode`
+ * is the one method with no direct predecessor: `dictionaries` looks a
+ * language up by code in four places with `em.findOne(Language, { code })`,
+ * which is the read this replaces.
+ */
+export declare class LanguageReadService implements LanguageReadPort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    list(): Promise<LanguageRecord[]>;
+    listActive(): Promise<LanguageRecord[]>;
+    getDefault(): Promise<LanguageRecord | null>;
+    findByCode(code: string): Promise<LanguageRecord | null>;
+}
+/**
+ * The write side, adapting `LanguageService`. The service arrives as a getter
+ * so the adapter resolves it per call rather than capturing this module's own
+ * gated port into a singleton.
+ */
+export declare function createLanguageAdminPort(getService: () => LanguageService): LanguageAdminPort;
+export declare function toLanguageRecord(language: Language): LanguageRecord;
+//# sourceMappingURL=language-ports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language-ports.d.ts","sourceRoot":"","sources":["../../../src/backend/services/language-ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IASjC,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IASvC,UAAU,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAI/D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,eAAe,GAAG,iBAAiB,CAa5F;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAanE"}

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

@@ -0,0 +1,70 @@
+import { Language } from '../entities/language.entity.js';
+/**
+ * The published face of `languages` (feature 075, Phase P).
+ *
+ * Sixteen inbound sites, and they split the way the module does: ten are
+ * `dictionaries` reading the `Language` **entity** to resolve a label,
+ * validate a code or walk a fallback chain, and six type themselves against
+ * `LanguageService` to call `listActive`.
+ *
+ * The read port answers both, and neither hands the entity over. `findByCode`
+ * is the one method with no direct predecessor: `dictionaries` looks a
+ * language up by code in four places with `em.findOne(Language, { code })`,
+ * which is the read this replaces.
+ */
+export class LanguageReadService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async list() {
+        const rows = await this.emFactory().find(Language, {}, { orderBy: { sortOrder: 'asc', code: 'asc' } });
+        return rows.map(toLanguageRecord);
+    }
+    async listActive() {
+        const rows = await this.emFactory().find(Language, { isActive: true }, { orderBy: { sortOrder: 'asc', code: 'asc' } });
+        return rows.map(toLanguageRecord);
+    }
+    async getDefault() {
+        const row = await this.emFactory().findOne(Language, { isDefault: true });
+        return row ? toLanguageRecord(row) : null;
+    }
+    async findByCode(code) {
+        const row = await this.emFactory().findOne(Language, { code });
+        return row ? toLanguageRecord(row) : null;
+    }
+}
+/**
+ * The write side, adapting `LanguageService`. The service arrives as a getter
+ * so the adapter resolves it per call rather than capturing this module's own
+ * gated port into a singleton.
+ */
+export function createLanguageAdminPort(getService) {
+    return {
+        async create(input) {
+            return toLanguageRecord(await getService().create(input));
+        },
+        async update(code, input) {
+            return toLanguageRecord(await getService().update(code, input));
+        },
+        async setDefault(code) {
+            return toLanguageRecord(await getService().setDefault(code));
+        },
+        remove: (code) => getService().remove(code),
+    };
+}
+export function toLanguageRecord(language) {
+    return {
+        code: language.code,
+        label: language.label,
+        nativeLabel: language.nativeLabel,
+        isRtl: language.isRtl,
+        fallbackCode: language.fallbackCode ?? null,
+        isDefault: language.isDefault,
+        isActive: language.isActive,
+        sortOrder: language.sortOrder,
+        createdAt: language.createdAt,
+        updatedAt: language.updatedAt,
+    };
+}
+//# sourceMappingURL=language-ports.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language-ports.js","sourceRoot":"","sources":["../../../src/backend/services/language-ports.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG1D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,SAA8B;QAA9B,cAAS,GAAT,SAAS,CAAqB;IAAG,CAAC;IAE/D,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CACtC,QAAQ,EACR,EAAE,EACF,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAC/C,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CACtC,QAAQ,EACR,EAAE,QAAQ,EAAE,IAAI,EAAE,EAClB,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAC/C,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,OAAO,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAiC;IACvE,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,OAAO,gBAAgB,CAAC,MAAM,UAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK;YACtB,OAAO,gBAAgB,CAAC,MAAM,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,IAAI;YACnB,OAAO,gBAAgB,CAAC,MAAM,UAAU,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,IAAI;QAC3C,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC"}

package/dist/backend/services/language-reference-registry.d.ts

@@ -0,0 +1,30 @@
+import type { DictionaryReference, DictionaryReferenceDescriptor, DictionaryReferenceRegistryPort } from '@endora-commerce/contracts';
+/**
+ * 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 declare class LanguageReferenceRegistry implements DictionaryReferenceRegistryPort {
+    private readonly descriptors;
+    register(descriptor: DictionaryReferenceDescriptor): void;
+    /** The contributing module of every registered descriptor, in registration order. */
+    owners(): readonly string[];
+    countReferences(code: string): Promise<DictionaryReference[]>;
+    usedCodes(): Promise<DictionaryReference[]>;
+}
+//# sourceMappingURL=language-reference-registry.d.ts.map

package/dist/backend/services/language-reference-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-reference-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/language-reference-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,+BAA+B,EAChC,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,yBAA0B,YAAW,+BAA+B;IAC/E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAEnE,QAAQ,CAAC,UAAU,EAAE,6BAA6B,GAAG,IAAI;IAMzD,qFAAqF;IACrF,MAAM,IAAI,SAAS,MAAM,EAAE;IAIrB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAS7D,SAAS,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAQlD"}