@endora-commerce/mod-languages 0.100.0

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

@@ -0,0 +1,88 @@
+/**
+ * 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 class LocaleService {
+    languageService;
+    cachedDefaultCode = null;
+    cachedDefaultLoadedAt = 0;
+    cacheTtlMs = 60_000;
+    constructor(languageService) {
+        this.languageService = languageService;
+    }
+    pickLocalizedValue(record, requestedLocale, defaultLocale) {
+        if (!record)
+            return '';
+        if (record[requestedLocale])
+            return record[requestedLocale];
+        if (defaultLocale && record[defaultLocale])
+            return record[defaultLocale];
+        const values = Object.values(record);
+        return values[0] ?? '';
+    }
+    async getDefaultLocale() {
+        const now = Date.now();
+        if (this.cachedDefaultCode && now - this.cachedDefaultLoadedAt < this.cacheTtlMs) {
+            return this.cachedDefaultCode;
+        }
+        const row = await this.languageService.getDefault();
+        this.cachedDefaultCode = row?.code ?? 'en-US';
+        this.cachedDefaultLoadedAt = now;
+        return this.cachedDefaultCode;
+    }
+    invalidateDefault() {
+        this.cachedDefaultLoadedAt = 0;
+        this.cachedDefaultCode = null;
+    }
+    /**
+     * Resolve a single locale string from an Accept-Language header against
+     * the active language pool. Returns the configured default when nothing
+     * matches.
+     */
+    async resolveRequestLocale(acceptLanguageHeader, activeLocales) {
+        const def = await this.getDefaultLocale();
+        if (!acceptLanguageHeader)
+            return def;
+        const candidates = parseAcceptLanguage(acceptLanguageHeader);
+        for (const cand of candidates) {
+            const exact = activeLocales.find((l) => l.toLowerCase() === cand.toLowerCase());
+            if (exact)
+                return exact;
+            // Fall back to the language part only ("en" matches "en-US").
+            const langOnly = cand.split('-')[0].toLowerCase();
+            const broad = activeLocales.find((l) => l.split('-')[0].toLowerCase() === langOnly);
+            if (broad)
+                return broad;
+        }
+        return def;
+    }
+}
+function parseAcceptLanguage(header) {
+    return header
+        .split(',')
+        .map((part) => {
+        const [tag, ...params] = part.trim().split(';');
+        const q = params
+            .map((p) => p.trim())
+            .find((p) => p.startsWith('q='))
+            ?.slice(2);
+        return { tag: tag.trim(), q: q ? Number(q) : 1 };
+    })
+        .filter((c) => c.tag && !Number.isNaN(c.q))
+        .sort((a, b) => b.q - a.q)
+        .map((c) => c.tag);
+}
+//# sourceMappingURL=locale-service.js.map

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

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

package/dist/manifest.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Languages module — manifest backfill (Module Lifecycle, feature 018).
+ *
+ * Predates the lifecycle system; this manifest is the static record
+ * required so the module participates in the registry. No install /
+ * uninstall hook today — the module's schema is owned by earlier
+ * platform-wide migrations.
+ */
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BnB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,40 @@
+import { defineModuleManifest } from '@endora-commerce/contracts';
+/**
+ * Languages module — manifest backfill (Module Lifecycle, feature 018).
+ *
+ * Predates the lifecycle system; this manifest is the static record
+ * required so the module participates in the registry. No install /
+ * uninstall hook today — the module's schema is owned by earlier
+ * platform-wide migrations.
+ */
+export const manifest = defineModuleManifest({
+    id: 'languages',
+    docs: { dir: 'docs' },
+    name: 'Languages',
+    description: 'Storefront/admin language catalog and per-channel locale routing.',
+    version: '1.0.0',
+    // `auth` owns the `requireAdmin` port the admin routes are gated by;
+    // `currencies` owns `currencyReadPort`. Feature 072 made both container
+    // resolutions.
+    //
+    // The `currencies` edge narrowed on 2026-08-29 and did not go away: the four
+    // `/api/v1/admin/currencies*` routes this module served, and the
+    // `currencyAdminPort` behind them, moved to their owner. What still reaches
+    // across is `GET /api/v1/i18n/config`, which answers with both catalogues and
+    // both defaults in one public payload — composition rather than ownership,
+    // and one read rather than a write surface.
+    dependencies: ['auth', 'currencies'],
+    // Feature 074 (Constitution XVII), test C3 — platform primitive. The flag
+    // used to rest on a two-hop walk of somebody else's `dependencies`
+    // (`organizations` → `dictionaries` → here); ruling 2 removes that as a
+    // ground entirely. This module's own is that it owns the locale scope: every
+    // localized surface, every translation bundle and every per-channel routing
+    // decision resolves against the language catalogue, so its absence is not a
+    // reduced platform but an unresolvable one.
+    activation: {
+        nonDeactivatable: true,
+        reason: 'The locale scope every localized surface and every translation bundle resolves ' +
+            'against.',
+    },
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;IAC3C,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;IACrB,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,mEAAmE;IACrE,OAAO,EAAE,OAAO;IAChB,qEAAqE;IACrE,wEAAwE;IACxE,eAAe;IACf,EAAE;IACF,6EAA6E;IAC7E,iEAAiE;IACjE,4EAA4E;IAC5E,8EAA8E;IAC9E,2EAA2E;IAC3E,4CAA4C;IAC5C,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;IACpC,0EAA0E;IAC1E,mEAAmE;IACnE,wEAAwE;IACxE,6EAA6E;IAC7E,4EAA4E;IAC5E,4EAA4E;IAC5E,4CAA4C;IAC5C,UAAU,EAAE;QACV,gBAAgB,EAAE,IAAI;QACtB,MAAM,EACJ,iFAAiF;YACjF,UAAU;KACb;CACF,CAAC,CAAC"}

package/dist/migrations/20260425T161557_languages_currencies_init.d.ts

@@ -0,0 +1,13 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Languages + currencies init (T238 / FR-105). Two configuration tables
+ * with a partial unique index pinning at most one default row each.
+ *
+ * Co-located in the `languages` module folder to keep the migration
+ * sequence numerical without inventing a third placeholder module.
+ */
+export declare class Migration20260425T161557LanguagesCurrenciesInit extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260425T161557_languages_currencies_init.d.ts.map

package/dist/migrations/20260425T161557_languages_currencies_init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260425T161557_languages_currencies_init.d.ts","sourceRoot":"","sources":["../../src/migrations/20260425T161557_languages_currencies_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;GAMG;AACH,qBAAa,+CAAgD,SAAQ,SAAS;IAC7D,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAwDnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAIrC"}

package/dist/migrations/20260425T161557_languages_currencies_init.js

@@ -0,0 +1,60 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Languages + currencies init (T238 / FR-105). Two configuration tables
+ * with a partial unique index pinning at most one default row each.
+ *
+ * Co-located in the `languages` module folder to keep the migration
+ * sequence numerical without inventing a third placeholder module.
+ */
+export class Migration20260425T161557LanguagesCurrenciesInit extends Migration {
+    async up() {
+        this.addSql(`
+      create table "languages" (
+        "code" varchar(12) not null,
+        "label" varchar(64) not null,
+        "is_default" boolean not null default false,
+        "is_active" boolean not null default true,
+        "sort_order" int not null default 0,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "languages_pkey" primary key ("code")
+      );
+    `);
+        this.addSql('create unique index "uniq_languages_one_default" on "languages" ("is_default") where "is_default" = true;');
+        this.addSql('create index "languages_is_active_index" on "languages" ("is_active");');
+        this.addSql(`
+      create table "currencies" (
+        "code" varchar(3) not null,
+        "label" varchar(64) not null,
+        "symbol" varchar(8) not null,
+        "is_default" boolean not null default false,
+        "is_active" boolean not null default true,
+        "sort_order" int not null default 0,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "currencies_pkey" primary key ("code")
+      );
+    `);
+        this.addSql('create unique index "uniq_currencies_one_default" on "currencies" ("is_default") where "is_default" = true;');
+        this.addSql('create index "currencies_is_active_index" on "currencies" ("is_active");');
+        // Bootstrap with the project defaults so quickstart works without an
+        // additional admin step. en-US + PLN match the existing seed data.
+        // Customer-facing label / symbol values use Postgres U&'…' Unicode
+        // literals so the source file stays ASCII-only (Principle VIII's
+        // engineering-artifact constraint), while the runtime row reflects
+        // exactly what the storefront should render.
+        this.addSql(`insert into "languages" ("code", "label", "is_default", "is_active", "sort_order", "created_at", "updated_at")
+       values
+         ('en-US', 'English (US)', true, true, 0, now(), now()),
+         ('pl-PL', 'Polski', false, true, 1, now(), now());`);
+        this.addSql(`insert into "currencies" ("code", "label", "symbol", "is_default", "is_active", "sort_order", "created_at", "updated_at")
+       values
+         ('PLN', 'Polish zloty', U&'z\\0142', true, true, 0, now(), now()),
+         ('EUR', 'Euro', U&'\\20AC', false, true, 1, now(), now());`);
+    }
+    async down() {
+        this.addSql('drop table if exists "currencies" cascade;');
+        this.addSql('drop table if exists "languages" cascade;');
+    }
+}
+//# sourceMappingURL=20260425T161557_languages_currencies_init.js.map

package/dist/migrations/20260425T161557_languages_currencies_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260425T161557_languages_currencies_init.js","sourceRoot":"","sources":["../../src/migrations/20260425T161557_languages_currencies_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,OAAO,+CAAgD,SAAQ,SAAS;IACnE,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;KAWX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,2GAA2G,CAC5G,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,wEAAwE,CAAC,CAAC;QAEtF,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;KAYX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,6GAA6G,CAC9G,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,0EAA0E,CAAC,CAAC;QAExF,qEAAqE;QACrE,mEAAmE;QACnE,mEAAmE;QACnE,iEAAiE;QACjE,mEAAmE;QACnE,6CAA6C;QAC7C,IAAI,CAAC,MAAM,CACT;;;4DAGsD,CACvD,CAAC;QACF,IAAI,CAAC,MAAM,CACT;;;oEAG8D,CAC/D,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * **One class.** It creates the `languages` table and the `currencies` table
+ * together — the two shipped as one migration long before either module was a
+ * package — so `currencies` owns rows this file creates and ships no migration
+ * of its own. That is a fact about history, not an ordering rule: a timestamp
+ * orders this module's own migrations and nothing else (feature 081), and where
+ * this block sits relative to every other module's is decided by the manifest
+ * `dependencies` graph.
+ *
+ * The **named** export stays beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports the class by name
+ * from this specifier, and a migration class name is contract in a way an
+ * entity class name is not: `mikro_orm_migrations` persists it, so it is a
+ * string every already-migrated database holds.
+ */
+import { Migration20260425T161557LanguagesCurrenciesInit } from './20260425T161557_languages_currencies_init.js';
+export declare const migrations: (typeof Migration20260425T161557LanguagesCurrenciesInit)[];
+export { Migration20260425T161557LanguagesCurrenciesInit };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,+CAA+C,EAAE,MAAM,gDAAgD,CAAC;AAEjH,eAAO,MAAM,UAAU,4DAAoD,CAAC;AAE5E,OAAO,EAAE,+CAA+C,EAAE,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,27 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * **One class.** It creates the `languages` table and the `currencies` table
+ * together — the two shipped as one migration long before either module was a
+ * package — so `currencies` owns rows this file creates and ships no migration
+ * of its own. That is a fact about history, not an ordering rule: a timestamp
+ * orders this module's own migrations and nothing else (feature 081), and where
+ * this block sits relative to every other module's is decided by the manifest
+ * `dependencies` graph.
+ *
+ * The **named** export stays beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports the class by name
+ * from this specifier, and a migration class name is contract in a way an
+ * entity class name is not: `mikro_orm_migrations` persists it, so it is a
+ * string every already-migrated database holds.
+ */
+import { Migration20260425T161557LanguagesCurrenciesInit } from './20260425T161557_languages_currencies_init.js';
+export const migrations = [Migration20260425T161557LanguagesCurrenciesInit];
+export { Migration20260425T161557LanguagesCurrenciesInit };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,+CAA+C,EAAE,MAAM,gDAAgD,CAAC;AAEjH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,+CAA+C,CAAC,CAAC;AAE5E,OAAO,EAAE,+CAA+C,EAAE,CAAC"}

package/docs/languages.md

@@ -0,0 +1,88 @@
+---
+title: languages
+description: Pool of supported BCP-47 language tags + translation-fallback helper
+---
+
+# `languages`
+
+The installation-wide pool of supported BCP-47 language tags. Owns the
+public `i18n/config` read path that storefront + admin consume to render
+their language pickers, plus a small `LocaleService` that implements the
+translation-fallback rule.
+
+## Public surface
+
+| Verb + Path | Audience | Purpose |
+| --- | --- | --- |
+| `GET /api/v1/i18n/config` | storefront / admin | Active languages + currencies + the configured defaults |
+| `GET /api/v1/admin/languages` | admin | Full list, including inactive rows |
+| `PUT /api/v1/admin/languages/:code` | admin | Upsert |
+| `POST /api/v1/admin/languages/:code/default` | admin | Promote to default (atomically demotes the prior default) |
+| `DELETE /api/v1/admin/languages/:code` | admin | Remove (rejected for the default) |
+
+The currency catalogue has the same shape under `/api/v1/admin/currencies`, and
+those routes are **`currencies`'** — see [currencies](./currencies.md). They were
+registered here until 2026-08-29, on `catalog:write`, serving another module's
+table for no caller in this repository. What this module still composes is
+`GET /api/v1/i18n/config`, which answers with both catalogues and both defaults
+in one public payload and reads the currency half over `currencyReadPort`.
+
+The four admin language routes above enforce `catalog:write`. That is a
+neighbourhood claim of the same kind and has not been repaired.
+
+## Defaults
+
+Exactly zero or one row in `languages` has `is_default = true`,
+enforced by a partial unique index on `(is_default) WHERE is_default =
+true`. Setting a new default runs the demote-then-promote pair inside one
+MikroORM transaction so the partial unique index is never violated
+mid-flight.
+
+The `LanguageService.setDefault()` rejects rows where `isActive=false`
+(`409 VALIDATION_FAILED`), and the `remove()` path refuses to delete a
+row that is currently the default.
+
+## Bootstrap
+
+Migration 012 inserts two rows so quickstart works without an admin step:
+- `en-US` — default, active
+- `pl-PL` — active
+
+The customer-facing `label` and `symbol` (currencies) values are written
+with Postgres `U&'…'` Unicode literals so the migration source file stays
+ASCII-only (engineering artifacts stay English-only and ASCII-only;
+the runtime row reflects what the storefront should render).
+
+## Translation-fallback (`LocaleService`)
+
+`LocaleService.pickLocalizedValue(record, requestedLocale, defaultLocale?)`
+implements the lookup chain:
+
+1. requested locale, if present in the record.
+2. configured default locale, if supplied and present.
+3. first present value in the record.
+4. empty string.
+
+`resolveRequestLocale(acceptLanguageHeader, activeLocales)` parses an
+`Accept-Language` header (q-weighted) and returns the highest-priority
+match from the active language pool, with a language-only fallback so
+`en-GB` matches `en-US`. Falls back to the configured default when nothing
+matches.
+
+The default-locale lookup is cached for 60 seconds; admin mutations call
+`invalidateDefault()` so the cache flushes immediately after a change.
+
+## Entities
+
+`Language` — natural primary key on the BCP-47 code; `label`,
+`isDefault`, `isActive`, `sortOrder`.
+
+## Extension points
+
+- **Per-Sales-Channel default** — when a Sales Channel ships its own
+  language, hook the resolver before
+  `LocaleService.resolveRequestLocale()` and use the channel's default
+  instead of the global one.
+- **Translation pull/push** — emit a domain event when a localized field
+  changes and let an integration consume it for an external translation
+  workflow.

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@endora-commerce/mod-languages",
+  "version": "0.100.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Storefront/admin language catalog and per-channel locale routing.",
+  "license": "MIT",
+  "endora": {
+    "type": "module",
+    "id": "languages"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/modules/languages"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/index.d.ts",
+      "default": "./dist/backend/index.js"
+    },
+    "./migrations": {
+      "types": "./dist/migrations/index.d.ts",
+      "default": "./dist/migrations/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "docs"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "peerDependencies": {
+    "@mikro-orm/core": "^6",
+    "@mikro-orm/migrations": "^6",
+    "@mikro-orm/postgresql": "^6",
+    "fastify": "^5",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "devDependencies": {
+    "@fastify/type-provider-zod": "^1.0.0",
+    "@mikro-orm/core": "^6.6.13",
+    "@mikro-orm/migrations": "^6.6.13",
+    "@mikro-orm/postgresql": "^6.6.13",
+    "@types/node": "^22.9.0",
+    "fastify": "^5.12.5",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}