@endora-commerce/mod-i18n 0.100.0

package/dist/backend/index.js

@@ -0,0 +1,134 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { registerI18nAdminRoutes } from './routes.admin.js';
+import { I18nService } from './services/i18n-service.js';
+import { reconcileBundles, } from './services/bundle-reconciler.js';
+import { TranslationBundle } from './entities/translation-bundle.entity.js';
+export function registerModule(ctx) {
+    ctx.di.providePort('adminI18nService', ctx
+        .asFunction(({ emFactory }) => new I18nService({ em: emFactory }))
+        .singleton());
+    ctx.di.providePort('adminI18nReconciler', ctx
+        .asFunction(() => {
+        // Feature 072 (D-38b) — `adminI18nService` is resolved per call, not
+        // captured in this factory. It is a `providePort` name, so it is a
+        // transient gate; awilix strict mode refuses a **singleton** that
+        // captures one, and it refuses it unconditionally — warm registry cache
+        // or cold. Destructuring it here therefore threw
+        // `AwilixResolutionError: … has a shorter lifetime than its ancestor:
+        // 'adminI18nReconciler$ungated$'` at every boot, which is the second
+        // half of why the backend would not start.
+        const i18n = lazyPort(ctx, 'adminI18nService');
+        return {
+            install: async ({ moduleId, modulePath, bundlesDir }) => {
+                const result = await i18n.installBundlesForModule(moduleId, modulePath, bundlesDir);
+                return { installed: result.installed };
+            },
+            remove: async (moduleId) => i18n.removeBundlesForModule(moduleId),
+            // Resolved per call for a second reason as well: `reloadAll` is
+            // reachable from the admin endpoint and the CLI at any time after
+            // boot, and the registry accessor answers `undefined` until
+            // `_lifecycle` is built.
+            reloadAll: async () => runReconcile(ctx),
+        };
+    })
+        .singleton());
+    ctx.routes(async (app) => {
+        // Plugin attach, not `onBoot` — see the note at the top of this file. This
+        // is the point in a composition where the lifecycle registry exists.
+        await runReconcile(ctx);
+        const { adminI18nService, requireAdmin, adminContextResolver } = ctx.cradle();
+        await registerI18nAdminRoutes(app, {
+            i18nService: adminI18nService,
+            // Feature 075, Phase C — one method of `admin_users`, resolved per call.
+            // The class this replaced brought creation, roles, deletion and
+            // impersonation across the boundary for a single language write.
+            adminUserPreference: lazyPort(ctx, 'adminUserPreferencePort'),
+            requireAdmin,
+            resolveAdminContext: adminContextResolver,
+            reload: () => runReconcile(ctx),
+        });
+    });
+}
+async function runReconcile(ctx) {
+    const { lifecycleManifestRegistry, adminI18nService } = ctx.cradle();
+    const registry = lifecycleManifestRegistry();
+    // Absent registry is a real state, not an error: a composition that never
+    // builds `_lifecycle` (several unit tests) still serves the read API, which
+    // reads `translation_bundles` directly.
+    if (!registry)
+        return { installed: 0, skipped: 0, failed: 0, failures: [] };
+    return reconcileBundles(registry.modules.values(), adminI18nService, {
+        // `reconcileBundles` takes a plain message logger; the kernel's is
+        // pino-shaped, so the message goes in the second position.
+        info: (msg) => ctx.log.info({}, msg),
+        warn: (msg) => ctx.log.warn({}, msg),
+    });
+}
+/**
+ * The module's own entity classes, as one array — 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.
+ *
+ * The class is **not** exported by name beside it (D-168): the ORM registers
+ * whichever copy this array carries, and a second, source-reached copy of a
+ * MikroORM entity is a lookup miss rather than a type error. A test that needs
+ * the runtime class takes it out of this array by name
+ * (`backend/test/helpers/package-entities.ts`).
+ */
+export const entities = [
+    TranslationBundle,
+];
+/**
+ * The rest of this module's published surface, and why each name is on it.
+ *
+ * Every one of these was reached relatively from `backend/` before the move,
+ * and a relative reach into a package's `src` is the defect
+ * `check:singleton-identity` refuses: the composed platform loads this
+ * package's `dist`, so a second evaluation of the same file is a second copy of
+ * everything module-scoped in it. Publishing the names is what gives those
+ * callers a spelling that lands on the copy the platform holds.
+ *
+ *   * `buildErrorTranslationTargets` and its shapes **stood here and are gone**
+ *     (`specs/117-instance-bring-up/` FR-030). The routing map is now
+ *     `@endora-commerce/platform`'s, at `kernel/i18n/error-translation.ts`,
+ *     beside `request-language.ts` — the producer of the other
+ *     `ErrorEnvelopeOptions` member a composition root injects.
+ *
+ *     The line it moved across is worth stating here as well as there, because
+ *     this is where a reader looks for it: *the routing is derived from
+ *     manifests, the translation is a service*. `I18nService.translate` — what
+ *     the envelope's `translateErrorMessage` closure calls — resolves a key
+ *     against a bundle and is `_i18n`'s. The derivation translated nothing; it
+ *     read `manifest.errorCodes` off the **resolved manifest set**, which is a
+ *     composition-root input, and it had no consumer inside this package at
+ *     all: this barrel re-exported it and nothing here called it. That is
+ *     T040b's criterion 8, the test `absolutizePublicUrl` moved out of `email`
+ *     under, met exactly.
+ *
+ *     `ERROR_TRANSLATION_KEYS` and `composeErrorTranslationTargets` stood here
+ *     too and were **deleted** in feature 090 Phase 4: the first was the prefix
+ *     chain's static table, the second the transitional composition that laid
+ *     the declarations over it so the migration could be delivered one module
+ *     per merge request. All eighteen owners have declared, so there is nothing
+ *     left to lay over.
+ *   * `I18nService` — the resolver the reconciler, the CLI commands and the
+ *     acceptance probe construct over an `EntityManager` of their own.
+ *   * `MissingKeyLogger` — the resolver's collaborator, constructed the same way.
+ *   * `loadModuleBundles` / `BundleLoadError` and their shapes — the filesystem
+ *     reader every module's bundles arrive through.
+ *   * `reconcileBundles` and its shapes — the boot pass itself, which the
+ *     acceptance probe runs against a live instance.
+ *   * `registerI18nAdminRoutes` / `I18nAdminDeps` — the HTTP surface, registered
+ *     against a bare Fastify instance by its own contract test.
+ */
+export { I18nService } from './services/i18n-service.js';
+export { MissingKeyLogger } from './services/missing-key-logger.js';
+export { BundleLoadError, loadModuleBundles, } from './services/bundle-loader.js';
+export { reconcileBundles, } from './services/bundle-reconciler.js';
+export { registerI18nAdminRoutes } from './routes.admin.js';
+//# 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.admin.d.ts

@@ -0,0 +1,41 @@
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import { type AdminUserPreferencePort } from '@endora-commerce/contracts';
+import type { I18nService } from './services/i18n-service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+/**
+ * Admin UI i18n HTTP surface — feature 019 / contracts/admin-http.md.
+ *
+ *   GET  /api/v1/admin/i18n/bundles?language=…   (E-1)
+ *   PATCH /api/v1/admin/me/preferred-language    (E-2)
+ *
+ * Both endpoints sit behind the standard admin auth gate — any
+ * authenticated admin may call them; no per-permission grant is
+ * required (FR-004).
+ */
+export interface I18nAdminDeps {
+    i18nService: I18nService;
+    /**
+     * Owned by `admin_users` (feature 075, Phase C). One method, because the
+     * language override is the whole of what this surface writes to an admin
+     * row; the service class this used to name carried creation, roles, deletion
+     * and impersonation with it. When `admin_users` is off the PATCH answers 503
+     * `MODULE_DISABLED`, which is right: there is no admin to hold a preference.
+     */
+    adminUserPreference: AdminUserPreferencePort;
+    requireAdmin: RequireAdminFactory;
+    /** Resolves the calling admin's id; reads `request.actor` in production. */
+    resolveAdminContext: (req: FastifyRequest) => {
+        adminUserId: string;
+    };
+    /**
+     * Re-reads every module's on-disk i18n bundles into the DB without a
+     * restart. Optional — when absent the reload endpoint is not registered.
+     */
+    reload?: () => Promise<{
+        installed: number;
+        skipped: number;
+        failed: number;
+    }>;
+}
+export declare function registerI18nAdminRoutes(app: FastifyInstance, deps: I18nAdminDeps): Promise<void>;
+//# sourceMappingURL=routes.admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.admin.d.ts","sourceRoot":"","sources":["../../src/backend/routes.admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,EAML,KAAK,uBAAuB,EAI7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB;;;;;;OAMG;IACH,mBAAmB,EAAE,uBAAuB,CAAC;IAC7C,YAAY,EAAE,mBAAmB,CAAC;IAClC,4EAA4E;IAC5E,mBAAmB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CA+Ff"}

package/dist/backend/routes.admin.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { GetBundlesResponseSchema, I18nCoverageQuerySchema, I18nCoverageResponseSchema, PatchPreferredLanguageBodySchema, SupportedAdminLanguageSchema, } from '@endora-commerce/contracts';
+export async function registerI18nAdminRoutes(app, deps) {
+    // --- E-1 GET bundles -----------------------------------------------------
+    // The Fastify Zod plugin validates the `language` query param against the
+    // supported allowlist; any non-matching value yields the standard 400
+    // VALIDATION_FAILED envelope (see http/error-envelope.ts).
+    const getBundlesQuerySchema = z.object({
+        language: SupportedAdminLanguageSchema,
+    });
+    app.get('/api/v1/admin/i18n/bundles', {
+        preHandler: deps.requireAdmin(),
+        schema: { querystring: getBundlesQuerySchema },
+    }, async (request) => {
+        const { language } = getBundlesQuerySchema.parse(request.query);
+        const merged = await deps.i18nService.getMergedBundleForLanguage(language);
+        const payload = {
+            language,
+            version: merged.version,
+            bundles: merged.bundles,
+        };
+        // Validate the outgoing shape too — cheap and catches schema drift.
+        return { data: GetBundlesResponseSchema.parse(payload) };
+    });
+    // --- E-4 POST reload bundles (hot-reload on-disk translations) -----------
+    // Re-reads every module's i18n JSON into `translation_bundles` (bumping
+    // versions) so edited translations appear without a backend restart. Any
+    // authenticated admin may trigger it, matching the other i18n endpoints.
+    if (deps.reload) {
+        const reload = deps.reload;
+        app.post('/api/v1/admin/i18n/reload', { preHandler: deps.requireAdmin() }, async () => {
+            const result = await reload();
+            return { data: result };
+        });
+    }
+    // --- E-2 PATCH self preferred-language ----------------------------------
+    app.patch('/api/v1/admin/me/preferred-language', {
+        preHandler: deps.requireAdmin(),
+        schema: { body: PatchPreferredLanguageBodySchema },
+    }, async (request) => {
+        const ctx = deps.resolveAdminContext(request);
+        const body = PatchPreferredLanguageBodySchema.parse(request.body);
+        const updated = await deps.adminUserPreference.setPreferredLanguage(ctx.adminUserId, body.preferredLanguage);
+        return {
+            data: {
+                preferredLanguage: updated.preferredLanguage ?? null,
+            },
+        };
+    });
+    // --- E-3 GET coverage diagnostic — feature 021 ---------------------------
+    app.get('/api/v1/admin/i18n/coverage', {
+        preHandler: deps.requireAdmin(),
+        schema: { querystring: I18nCoverageQuerySchema },
+    }, async (request) => {
+        const q = I18nCoverageQuerySchema.parse(request.query ?? {});
+        const moduleIds = q.module === undefined
+            ? undefined
+            : Array.isArray(q.module)
+                ? q.module
+                : [q.module];
+        const languageCodes = q.language === undefined
+            ? undefined
+            : Array.isArray(q.language)
+                ? q.language
+                : [q.language];
+        const snapshot = await deps.i18nService.getCoverageSnapshot({
+            ...(moduleIds !== undefined ? { moduleIds } : {}),
+            ...(languageCodes !== undefined ? { languageCodes } : {}),
+            ...(q.includeKeys !== undefined ? { includeKeys: q.includeKeys } : {}),
+        });
+        return { data: I18nCoverageResponseSchema.parse(snapshot) };
+    });
+}
+//# sourceMappingURL=routes.admin.js.map

package/dist/backend/routes.admin.js.map

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

package/dist/backend/services/bundle-loader.d.ts

@@ -0,0 +1,49 @@
+import { type SupportedAdminLanguage, type TranslationBundleEntries } from '@endora-commerce/contracts';
+/**
+ * Filesystem reader for module-shipped translation bundles —
+ * feature 019 / data-model.md §6, contracts/translation-bundle-schema.md.
+ *
+ * Reads `<modulePath>/<bundlesDir>/<lang>.json` for every supported
+ * Admin UI language, validates each file with
+ * `TranslationBundleEntriesSchema`, and returns the bundles keyed by
+ * language code. Throws a `BundleLoadError` for any rule violation:
+ *
+ *   - filename does not match a supported language code,
+ *   - JSON does not parse,
+ *   - the parsed value does not satisfy the entries schema (e.g.
+ *     nested object, array, null, non-string value, empty key),
+ *   - the directory exists but no English bundle is present
+ *     (FR-016: English is the platform-wide fallback).
+ *
+ * Modules that do NOT ship a bundles directory are exempt and the
+ * loader returns an empty map for them.
+ */
+export declare class BundleLoadError extends Error {
+    readonly moduleId: string;
+    readonly reason: 'unsupported-language-file' | 'parse-failed' | 'invalid-shape' | 'missing-fallback-bundle';
+    readonly path?: string | undefined;
+    readonly issues?: unknown | undefined;
+    constructor(moduleId: string, reason: 'unsupported-language-file' | 'parse-failed' | 'invalid-shape' | 'missing-fallback-bundle', message: string, path?: string | undefined, issues?: unknown | undefined);
+}
+export interface LoadedBundles {
+    /**
+     * Per-language entries map. Only languages that have a bundle file on
+     * disk are present; missing languages are simply absent from the map.
+     */
+    byLanguage: Map<SupportedAdminLanguage, TranslationBundleEntries>;
+}
+export interface BundleLoaderOptions {
+    /** For tests: override the JSON-file reader (e.g. to point at fixtures). */
+    readFile?: (path: string) => string;
+    /** For tests: override directory listing. */
+    readDir?: (path: string) => string[];
+    /** For tests: override existence check. */
+    fileExists?: (path: string) => boolean;
+}
+/**
+ * Load every supported-language bundle for one module. Returns an empty
+ * map when the bundles directory does not exist (the module ships no
+ * translatable strings).
+ */
+export declare function loadModuleBundles(moduleId: string, modulePath: string, bundlesDir: string, opts?: BundleLoaderOptions): LoadedBundles;
+//# sourceMappingURL=bundle-loader.d.ts.map

package/dist/backend/services/bundle-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-loader.d.ts","sourceRoot":"","sources":["../../../src/backend/services/bundle-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAClB,2BAA2B,GAC3B,cAAc,GACd,eAAe,GACf,yBAAyB;aAEb,IAAI,CAAC,EAAE,MAAM;aACb,MAAM,CAAC,EAAE,OAAO;gBARhB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAClB,2BAA2B,GAC3B,cAAc,GACd,eAAe,GACf,yBAAyB,EAC7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,MAAM,CAAC,EAAE,OAAO,YAAA;CAKnC;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,UAAU,EAAE,GAAG,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACrC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAQD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,mBAAwB,GAC7B,aAAa,CA4Df"}

package/dist/backend/services/bundle-loader.js

@@ -0,0 +1,84 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { LANGUAGE_FALLBACK, SUPPORTED_LANGUAGES, SupportedAdminLanguageSchema, TranslationBundleEntriesSchema, } from '@endora-commerce/contracts';
+/**
+ * Filesystem reader for module-shipped translation bundles —
+ * feature 019 / data-model.md §6, contracts/translation-bundle-schema.md.
+ *
+ * Reads `<modulePath>/<bundlesDir>/<lang>.json` for every supported
+ * Admin UI language, validates each file with
+ * `TranslationBundleEntriesSchema`, and returns the bundles keyed by
+ * language code. Throws a `BundleLoadError` for any rule violation:
+ *
+ *   - filename does not match a supported language code,
+ *   - JSON does not parse,
+ *   - the parsed value does not satisfy the entries schema (e.g.
+ *     nested object, array, null, non-string value, empty key),
+ *   - the directory exists but no English bundle is present
+ *     (FR-016: English is the platform-wide fallback).
+ *
+ * Modules that do NOT ship a bundles directory are exempt and the
+ * loader returns an empty map for them.
+ */
+export class BundleLoadError extends Error {
+    moduleId;
+    reason;
+    path;
+    issues;
+    constructor(moduleId, reason, message, path, issues) {
+        super(message);
+        this.moduleId = moduleId;
+        this.reason = reason;
+        this.path = path;
+        this.issues = issues;
+        this.name = 'BundleLoadError';
+    }
+}
+const DEFAULT_OPTS = {
+    readFile: (p) => readFileSync(p, 'utf8'),
+    readDir: (p) => readdirSync(p),
+    fileExists: (p) => existsSync(p),
+};
+/**
+ * Load every supported-language bundle for one module. Returns an empty
+ * map when the bundles directory does not exist (the module ships no
+ * translatable strings).
+ */
+export function loadModuleBundles(moduleId, modulePath, bundlesDir, opts = {}) {
+    const o = { ...DEFAULT_OPTS, ...opts };
+    const dirPath = join(modulePath, bundlesDir);
+    if (!o.fileExists(dirPath)) {
+        return { byLanguage: new Map() };
+    }
+    const supported = new Set(SUPPORTED_LANGUAGES);
+    const files = o.readDir(dirPath).filter((f) => f.endsWith('.json'));
+    const byLanguage = new Map();
+    for (const file of files) {
+        const lang = file.replace(/\.json$/, '');
+        if (!supported.has(lang)) {
+            throw new BundleLoadError(moduleId, 'unsupported-language-file', `[i18n] module "${moduleId}" ships unsupported language bundle "${file}"; supported: ${[
+                ...supported,
+            ].join(', ')}`, join(dirPath, file));
+        }
+        const parsed = SupportedAdminLanguageSchema.parse(lang);
+        const filePath = join(dirPath, file);
+        let content;
+        try {
+            content = JSON.parse(o.readFile(filePath));
+        }
+        catch (err) {
+            throw new BundleLoadError(moduleId, 'parse-failed', `[i18n] module "${moduleId}" bundle "${file}" is not valid JSON: ${err.message}`, filePath);
+        }
+        const validated = TranslationBundleEntriesSchema.safeParse(content);
+        if (!validated.success) {
+            throw new BundleLoadError(moduleId, 'invalid-shape', `[i18n] module "${moduleId}" bundle "${file}" failed validation`, filePath, validated.error.issues);
+        }
+        byLanguage.set(parsed, validated.data);
+    }
+    // FR-016 — when the module ships any bundle at all, English MUST be present.
+    if (byLanguage.size > 0 && !byLanguage.has(LANGUAGE_FALLBACK)) {
+        throw new BundleLoadError(moduleId, 'missing-fallback-bundle', `[i18n] module "${moduleId}" ships translation bundles but is missing the "${LANGUAGE_FALLBACK}.json" fallback (FR-016).`, dirPath);
+    }
+    return { byLanguage };
+}
+//# sourceMappingURL=bundle-loader.js.map

package/dist/backend/services/bundle-loader.js.map

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

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

@@ -0,0 +1,82 @@
+import type { I18nService } from './i18n-service.js';
+/** One module whose bundles could not be read, and where they were read from. */
+export interface I18nReconcileFailure {
+    moduleId: string;
+    /** `dirname(entry.filePath)` — the directory `bundlesDir` was joined to. */
+    modulePath: string;
+    /** The `BundleLoadError` reason, or `'unknown'` for anything else. */
+    reason: string;
+    message: string;
+}
+/** Aggregate outcome of a reconcile/reload pass over every module's bundles. */
+export interface I18nReconcileResult {
+    installed: number;
+    skipped: number;
+    failed: number;
+    /**
+     * One entry per module counted in {@link failed}.
+     *
+     * The counts alone were the whole diagnostic surface, and they were enough
+     * while every bundle in the platform came out of this repository: a core
+     * module's malformed bundle cannot ship, because
+     * `test/unit/_i18n/registered-bundles-shape.test.ts` walks the committed
+     * registry and fails the build. An **installed package's** bundle passes
+     * through no CI of ours, so this pass is the first and only thing that ever
+     * reads it — and `failed=1` names nobody.
+     */
+    failures: I18nReconcileFailure[];
+}
+/**
+ * Idempotent reconciler — for every module whose manifest declares an
+ * `i18n.bundlesDir`, refresh its `translation_bundles` rows from the
+ * JSON files on disk. Errors from the loader (malformed JSON, missing
+ * EN bundle, etc.) are logged but do NOT abort the boot — a single
+ * bad bundle should not take down the platform; the gap surfaces via
+ * FR-014's diagnostic surface and the platform keeps serving.
+ *
+ * ## Why log-and-skip is still right when the bundle is a stranger's
+ *
+ * Feature 080 (T032) put an **installed package's** bundles on this path, and
+ * that is a different question from the one this policy was written for: a
+ * malformed bundle used to be a mistake this repository made and CI refused
+ * before it shipped. A package's bundle is a mistake somebody else made, and
+ * it arrives on a running shop.
+ *
+ * The answer does not change, and the reason it does not is that this pass has
+ * **no caller to answer**. It runs at boot and on `i18n:reload`, where the only
+ * alternative to skipping is refusing to serve — so one vendor's nested JSON
+ * object would take a shop off the internet, over labels. That is the same
+ * trade `installed-packages.ts` already makes for a `package.json` it cannot
+ * parse ("one unreadable stranger must not stop a shop from booting"), and the
+ * blast radius here is smaller: the module's routes, permissions and gating are
+ * untouched, and its palette entries render raw keys.
+ *
+ * Where there **is** a caller, the answer is already the opposite one and stays
+ * that way: `module:install` reconciles through
+ * `orchestrator.ts`'s `i18nReconciler.install(...)`, outside this function,
+ * where a `BundleLoadError` bubbles out and aborts the install transaction
+ * (FR-016). An operator installing a package with an unreadable bundle is told
+ * at the moment they can still choose not to install it.
+ *
+ * What T032 changed is the part that was genuinely wrong for a stranger:
+ * the failure is now **attributable**. The warning names the directory the
+ * bundle was read from — for a package that is `node_modules/@vendor/…`, which
+ * is the only thing in the line that says whose mistake it is, since D-142
+ * makes the module id the platform's identity and not the vendor's — and the
+ * result carries {@link I18nReconcileFailure} entries rather than a count.
+ */
+/** One module's manifest + on-disk location, as the reconciler needs it. */
+export interface I18nReconcileEntry {
+    manifest: {
+        id: string;
+        i18n?: {
+            bundlesDir: string;
+        } | undefined;
+    };
+    filePath: string;
+}
+export declare function reconcileBundles(entries: Iterable<I18nReconcileEntry>, i18nService: I18nService, log: {
+    info(msg: string): void;
+    warn(msg: string): void;
+}): Promise<I18nReconcileResult>;
+//# sourceMappingURL=bundle-reconciler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-reconciler.d.ts","sourceRoot":"","sources":["../../../src/backend/services/bundle-reconciler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACrC,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE;IAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxD,OAAO,CAAC,mBAAmB,CAAC,CAyC9B"}

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

@@ -0,0 +1,38 @@
+import { dirname } from 'node:path';
+import { BundleLoadError } from './bundle-loader.js';
+export async function reconcileBundles(entries, i18nService, log) {
+    let installed = 0;
+    let skipped = 0;
+    let failed = 0;
+    const failures = [];
+    for (const entry of entries) {
+        const i18n = entry.manifest.i18n;
+        if (!i18n) {
+            skipped += 1;
+            continue;
+        }
+        const moduleId = entry.manifest.id;
+        const modulePath = dirname(entry.filePath);
+        try {
+            const result = await i18nService.installBundlesForModule(moduleId, modulePath, i18n.bundlesDir);
+            if (result.installed.length > 0) {
+                installed += 1;
+            }
+        }
+        catch (err) {
+            failed += 1;
+            const isLoadError = err instanceof BundleLoadError;
+            const reason = isLoadError ? err.reason : 'unknown';
+            const message = err instanceof Error ? err.message : String(err);
+            failures.push({ moduleId, modulePath, reason, message });
+            // `modulePath` is in the line, not only in the structured failure: a
+            // module id says which module, and for an installed package it is
+            // precisely the thing that does NOT say whose module it is.
+            log.warn(`[i18n] reconcile: module "${moduleId}" bundle load failed (${reason}) ` +
+                `at ${modulePath}: ${message}`);
+        }
+    }
+    log.info(`[i18n] reconcile complete — installed=${installed} skipped=${skipped} failed=${failed}`);
+    return { installed, skipped, failed, failures };
+}
+//# sourceMappingURL=bundle-reconciler.js.map

package/dist/backend/services/bundle-reconciler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-reconciler.js","sourceRoot":"","sources":["../../../src/backend/services/bundle-reconciler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA6ErD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAqC,EACrC,WAAwB,EACxB,GAAyD;IAEzD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,uBAAuB,CACtD,QAAQ,EACR,UAAU,EACV,IAAI,CAAC,UAAU,CAChB,CAAC;YACF,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,SAAS,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,CAAC;YACZ,MAAM,WAAW,GAAG,GAAG,YAAY,eAAe,CAAC;YACnD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YACpD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,qEAAqE;YACrE,kEAAkE;YAClE,4DAA4D;YAC5D,GAAG,CAAC,IAAI,CACN,6BAA6B,QAAQ,yBAAyB,MAAM,IAAI;gBACtE,MAAM,UAAU,KAAK,OAAO,EAAE,CACjC,CAAC;QACJ,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CACN,yCAAyC,SAAS,YAAY,OAAO,WAAW,MAAM,EAAE,CACzF,CAAC;IACF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,67 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type I18nCoverageResponse, type SupportedAdminLanguage, type TranslationBundleEntries } from '@endora-commerce/contracts';
+import { MissingKeyLogger } from './missing-key-logger.js';
+/**
+ * Admin UI i18n resolver and bundle store — feature 019 /
+ * data-model.md §8, research §R7 / R9.
+ *
+ * Public surface (every method is exercised by a test in
+ * specs/019-admin-i18n/research.md §R12):
+ *
+ *   - `installBundlesForModule(moduleId, modulePath, bundlesDir)` —
+ *      called by the lifecycle install hook for any module that declares
+ *      `manifest.i18n`. UPSERTs one row per language into
+ *      `translation_bundles`; the row's `version` defaults via the
+ *      `translation_bundles_version_seq` sequence.
+ *   - `removeBundlesForModule(moduleId)` — hard-uninstall path. DELETEs
+ *      every row owned by the module. Soft-uninstall is a no-op
+ *      (data-model §3).
+ *   - `getMergedBundleForLanguage(language)` — returns the merged
+ *      `{ moduleId: entries }` object served to the admin SPA at boot,
+ *      together with the `version` vector consumed by the SPA's cache.
+ *   - `translate(moduleId, key, language, params?)` — backend-side lookup
+ *      with the (requested → en → placeholder) fallback chain.
+ */
+export interface I18nServiceDeps {
+    em: () => EntityManager;
+    missingKeyLogger?: MissingKeyLogger;
+}
+export declare class I18nService {
+    private readonly em;
+    private readonly missingKeyLogger;
+    private readonly cache;
+    constructor(deps: I18nServiceDeps);
+    /**
+     * Install (or update) every supported-language bundle for one module
+     * by reading the JSON files at `<modulePath>/<bundlesDir>/<lang>.json`.
+     * The loader rejects malformed input via `BundleLoadError`; the
+     * lifecycle orchestrator surfaces that error as the install failure.
+     */
+    installBundlesForModule(moduleId: string, modulePath: string, bundlesDir: string, em?: EntityManager): Promise<{
+        installed: SupportedAdminLanguage[];
+    }>;
+    /** Hard-uninstall — soft-uninstall is a no-op (data-model §3). */
+    removeBundlesForModule(moduleId: string, em?: EntityManager): Promise<{
+        removed: number;
+    }>;
+    /**
+     * Build a `(moduleId, languageCode)` coverage snapshot combining:
+     *   - the `MissingKeyLogger` accumulator (runtime fallback events), and
+     *   - a static comparison of the shipped bundle entries per language.
+     *
+     * Modules and languages can be filtered before serialisation. `includeKeys`
+     * defaults to `'missing'`; set `'all'` to return every key the runtime has
+     * seen (large; intended for deep inspection).
+     */
+    getCoverageSnapshot(filter?: {
+        moduleIds?: string[];
+        languageCodes?: SupportedAdminLanguage[];
+        includeKeys?: 'missing' | 'all';
+    }, em?: EntityManager): Promise<I18nCoverageResponse>;
+    getMergedBundleForLanguage(language: SupportedAdminLanguage, em?: EntityManager): Promise<{
+        version: number;
+        bundles: Record<string, TranslationBundleEntries>;
+    }>;
+    translate(moduleId: string, key: string, language: SupportedAdminLanguage, params?: Record<string, string | number>, em?: EntityManager): Promise<string>;
+}
+//# sourceMappingURL=i18n-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/i18n-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,aAAa,CAAC;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AASD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqD;gBAE/D,IAAI,EAAE,eAAe;IASjC;;;;;OAKG;IACG,uBAAuB,CAC3B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,aAAa,GACjB,OAAO,CAAC;QAAE,SAAS,EAAE,sBAAsB,EAAE,CAAA;KAAE,CAAC;IAiCnD,kEAAkE;IAC5D,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,aAAa,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB/B;;;;;;;;OAQG;IACG,mBAAmB,CACvB,MAAM,GAAE;QACN,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;QACzC,WAAW,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;KAC5B,EACN,EAAE,CAAC,EAAE,aAAa,GACjB,OAAO,CAAC,oBAAoB,CAAC;IA2F1B,0BAA0B,CAC9B,QAAQ,EAAE,sBAAsB,EAChC,EAAE,CAAC,EAAE,aAAa,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;KAAE,CAAC;IAyC5E,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,sBAAsB,EAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACxC,EAAE,CAAC,EAAE,aAAa,GACjB,OAAO,CAAC,MAAM,CAAC;CAoEnB"}