@endora-commerce/mod-i18n 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,52 @@
+<!-- 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-i18n
+
+Per-user Admin UI language preference and module-scoped translation bundles. English is the platform-wide fallback (FR-013 / FR-016).
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `_i18n` — 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-i18n` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-i18n/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-i18n/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
+- `zod` ^4
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-i18n
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/backend/cli/coverage.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `_i18n coverage` — the translation-coverage snapshot (feature 021), as a
+ * host-run command (feature 080, T042b / D-160.9).
+ *
+ * Prints the same payload the admin route returns. Useful for developers and
+ * for CI; in `--strict` mode it exits non-zero when any module in the filtered
+ * set has `missingCount > 0`.
+ *
+ * Flags:
+ *   --json                Emit JSON (default: human-readable table)
+ *   --strict              Exit 1 when any missingCount > 0 for the filtered set
+ *   --modules a,b,c       Filter by module id (repeatable as CSV)
+ *   --languages pl,en     Filter by supported admin language code (repeatable as CSV)
+ *   --include-keys all    Match the route's includeKeys=all
+ */
+import { type SupportedAdminLanguage } from '@endora-commerce/contracts';
+import type { ModuleCliCommandContext } from '@endora-commerce/contracts';
+import { type ModuleContext } from '@endora-commerce/platform/kernel';
+interface ParsedArgs {
+    json: boolean;
+    strict: boolean;
+    modules?: string[];
+    languages?: SupportedAdminLanguage[];
+    includeKeys?: 'all' | 'missing';
+}
+export declare function parseArgs(argv: readonly string[]): ParsedArgs;
+export declare function coverage({ ctx, argv, out, err, }: ModuleCliCommandContext<ModuleContext>): Promise<number>;
+export {};
+//# sourceMappingURL=coverage.d.ts.map

package/dist/backend/cli/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../../src/backend/cli/coverage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGhF,UAAU,UAAU;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACrC,WAAW,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CACjC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAsB7D;AA+BD,wBAAsB,QAAQ,CAAC,EAC7B,GAAG,EACH,IAAI,EACJ,GAAG,EACH,GAAG,GACJ,EAAE,uBAAuB,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B1D"}

package/dist/backend/cli/coverage.js

@@ -0,0 +1,84 @@
+/**
+ * `_i18n coverage` — the translation-coverage snapshot (feature 021), as a
+ * host-run command (feature 080, T042b / D-160.9).
+ *
+ * Prints the same payload the admin route returns. Useful for developers and
+ * for CI; in `--strict` mode it exits non-zero when any module in the filtered
+ * set has `missingCount > 0`.
+ *
+ * Flags:
+ *   --json                Emit JSON (default: human-readable table)
+ *   --strict              Exit 1 when any missingCount > 0 for the filtered set
+ *   --modules a,b,c       Filter by module id (repeatable as CSV)
+ *   --languages pl,en     Filter by supported admin language code (repeatable as CSV)
+ *   --include-keys all    Match the route's includeKeys=all
+ */
+import { SUPPORTED_LANGUAGES } from '@endora-commerce/contracts';
+import { lazyPort } from '@endora-commerce/platform/kernel';
+export function parseArgs(argv) {
+    const out = { json: false, strict: false };
+    for (let i = 0; i < argv.length; i += 1) {
+        const a = argv[i];
+        if (a === '--json')
+            out.json = true;
+        else if (a === '--strict')
+            out.strict = true;
+        else if (a === '--modules' || a === '--module') {
+            out.modules = (argv[i + 1] ?? '').split(',').filter(Boolean);
+            i += 1;
+        }
+        else if (a === '--languages' || a === '--language') {
+            const supported = new Set(SUPPORTED_LANGUAGES);
+            out.languages = (argv[i + 1] ?? '')
+                .split(',')
+                .filter((v) => supported.has(v));
+            i += 1;
+        }
+        else if (a === '--include-keys') {
+            const v = argv[i + 1];
+            if (v === 'all' || v === 'missing')
+                out.includeKeys = v;
+            i += 1;
+        }
+    }
+    return out;
+}
+function printTable(snapshot, out) {
+    out(`Coverage snapshot @ ${snapshot.capturedAt}`);
+    if (snapshot.modules.length === 0) {
+        out('  (no modules in the filtered set)');
+        return;
+    }
+    for (const m of snapshot.modules) {
+        out(`  ${m.moduleId}`);
+        for (const l of m.languages) {
+            out(`    ${l.languageCode}  missing=${String(l.missingCount).padStart(3, ' ')}  ` +
+                `fellBackToEn=${String(l.fellBackToEnCount).padStart(3, ' ')}`);
+        }
+    }
+}
+export async function coverage({ ctx, argv, out, err, }) {
+    const args = parseArgs(argv);
+    // This module's own port, resolved exactly as `backend.ts` resolves it — one
+    // `I18nService` for the composition rather than a second one built here.
+    const i18nService = lazyPort(ctx, 'adminI18nService');
+    const snapshot = await i18nService.getCoverageSnapshot({
+        ...(args.modules ? { moduleIds: args.modules } : {}),
+        ...(args.languages ? { languageCodes: args.languages } : {}),
+        ...(args.includeKeys ? { includeKeys: args.includeKeys } : {}),
+    });
+    if (args.json)
+        out(JSON.stringify({ data: snapshot }, null, 2));
+    else
+        printTable(snapshot, out);
+    if (args.strict) {
+        const violators = snapshot.modules.flatMap((m) => m.languages.filter((l) => l.missingCount > 0).map((l) => ({ m, l })));
+        if (violators.length > 0) {
+            err(`[i18n coverage] strict mode: ${violators.length} (module, language) pair(s) are ` +
+                `missing entries.`);
+            return 1;
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=coverage.js.map

package/dist/backend/cli/coverage.js.map

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

package/dist/backend/cli/reload.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `_i18n reload` — hot-reload translations (feature 080, T042b / D-160.9).
+ *
+ * Re-reads every module's on-disk i18n JSON bundles into the
+ * `translation_bundles` table, bumping each row's version. A running backend
+ * serves the new strings on its next read (the per-language cache rebuilds when
+ * it sees a newer `MAX(version)`), so no restart is needed — admins just refresh
+ * the page, or the Admin UI "Reload translations" button does it for them.
+ *
+ * Note: the storefront ships its UI strings compiled in-tree
+ * (`storefront/lib/i18n/messages.ts`); those are not DB-backed and require a
+ * storefront rebuild/redeploy. This command covers the admin bundles.
+ *
+ * ## What composing bought here
+ *
+ * This was `scripts/reload.ts`, and it imported `resolvedManifestEntries` from
+ * `_lifecycle` to get the module list — the single entry in this module's
+ * `check:module-boundary` shard, escalated rather than cut because *"a
+ * module-owned CLI entry point has no container and no `ModuleContext` … and
+ * what it needs is the deployment's module registry, which is a
+ * composition-root input by nature"*. Both halves of that sentence are answered
+ * by the host running the command: `resolvedModuleRegistry` is a
+ * `PLATFORM_OWNED_NAMES` entry any module may read off its cradle, and the
+ * `I18nService` is this module's own registration rather than a second instance
+ * built here.
+ *
+ * It is deliberately the **composition's** registry rather than a fresh
+ * `resolvedManifestEntries()` call, which is what makes the command's answer
+ * the same as the running platform's: core, this deployment's overlay modules
+ * and every installed package (feature 080, T032).
+ */
+import type { ModuleCliCommandContext } from '@endora-commerce/contracts';
+import { type ModuleContext } from '@endora-commerce/platform/kernel';
+export declare function reload({ ctx, out, err, }: ModuleCliCommandContext<ModuleContext>): Promise<number>;
+//# sourceMappingURL=reload.d.ts.map

package/dist/backend/cli/reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.d.ts","sourceRoot":"","sources":["../../../src/backend/cli/reload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAYhF,wBAAsB,MAAM,CAAC,EAC3B,GAAG,EACH,GAAG,EACH,GAAG,GACJ,EAAE,uBAAuB,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB1D"}

package/dist/backend/cli/reload.js

@@ -0,0 +1,18 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { reconcileBundles, } from '../services/bundle-reconciler.js';
+export async function reload({ ctx, out, err, }) {
+    const entries = ctx.cradle().resolvedModuleRegistry;
+    // This module's own port, resolved exactly as `backend.ts` resolves it.
+    const i18nService = lazyPort(ctx, 'adminI18nService');
+    const result = await reconcileBundles(entries, i18nService, {
+        info: (msg) => out(msg),
+        warn: (msg) => err(msg),
+    });
+    out(`[i18n reload] done — installed=${result.installed} skipped=${result.skipped} ` +
+        `failed=${result.failed}`);
+    for (const failure of result.failures) {
+        err(`[i18n reload] "${failure.moduleId}" (${failure.reason}) at ${failure.modulePath}`);
+    }
+    return result.failed > 0 ? 1 : 0;
+}
+//# sourceMappingURL=reload.js.map

package/dist/backend/cli/reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../../src/backend/cli/reload.ts"],"names":[],"mappings":"AAgCA,OAAO,EAAE,QAAQ,EAAsB,MAAM,kCAAkC,CAAC;AAChF,OAAO,EACL,gBAAgB,GAEjB,MAAM,kCAAkC,CAAC;AAQ1C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAC3B,GAAG,EACH,GAAG,EACH,GAAG,GACoC;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAoB,CAAC,sBAAsB,CAAC;IACtE,wEAAwE;IACxE,MAAM,WAAW,GAAG,QAAQ,CAAc,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE;QAC1D,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;QACvB,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;KACxB,CAAC,CAAC;IACH,GAAG,CACD,kCAAkC,MAAM,CAAC,SAAS,YAAY,MAAM,CAAC,OAAO,GAAG;QAC7E,UAAU,MAAM,CAAC,MAAM,EAAE,CAC5B,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,GAAG,CAAC,kBAAkB,OAAO,CAAC,QAAQ,MAAM,OAAO,CAAC,MAAM,QAAQ,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/backend/entities/translation-bundle.entity.d.ts

@@ -0,0 +1,23 @@
+import { OptionalProps } from '@mikro-orm/core';
+import type { SupportedAdminLanguage, TranslationBundleEntries } from '@endora-commerce/contracts';
+/**
+ * Translation Bundle — feature 019 / data-model.md §1.1.
+ *
+ * One row per `(module_id, language_code)`. JSONB `entries` carries the
+ * flat translation key → string map. `version` defaults to
+ * `nextval(translation_bundles_version_seq)` so every UPSERT bumps the
+ * vector and the in-process resolver cache invalidates on its next
+ * `MAX(version)` check (research §R9).
+ *
+ * No FK on `module_id` — see migration 040 for the rationale.
+ */
+export declare class TranslationBundle {
+    [OptionalProps]?: 'version' | 'installedAt' | 'updatedAt';
+    moduleId: string;
+    languageCode: SupportedAdminLanguage;
+    entries: TranslationBundleEntries;
+    version: number;
+    installedAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=translation-bundle.entity.d.ts.map

package/dist/backend/entities/translation-bundle.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-bundle.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/translation-bundle.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAErF,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEnG;;;;;;;;;;GAUG;AACH,qBAMa,iBAAiB;IAC5B,CAAC,aAAa,CAAC,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAG1D,QAAQ,EAAG,MAAM,CAAC;IAGlB,YAAY,EAAG,sBAAsB,CAAC;IAGtC,OAAO,EAAE,wBAAwB,CAAM;IAOvC,OAAO,EAAG,MAAM,CAAC;IAGjB,WAAW,EAAE,IAAI,CAAc;IAG/B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/translation-bundle.entity.js

@@ -0,0 +1,69 @@
+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, Index, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+/**
+ * Translation Bundle — feature 019 / data-model.md §1.1.
+ *
+ * One row per `(module_id, language_code)`. JSONB `entries` carries the
+ * flat translation key → string map. `version` defaults to
+ * `nextval(translation_bundles_version_seq)` so every UPSERT bumps the
+ * vector and the in-process resolver cache invalidates on its next
+ * `MAX(version)` check (research §R9).
+ *
+ * No FK on `module_id` — see migration 040 for the rationale.
+ */
+let TranslationBundle = class TranslationBundle {
+    [OptionalProps];
+    moduleId;
+    languageCode;
+    entries = {};
+    version;
+    installedAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'string', length: 64 }),
+    __metadata("design:type", String)
+], TranslationBundle.prototype, "moduleId", void 0);
+__decorate([
+    PrimaryKey({ type: 'string', length: 12 }),
+    __metadata("design:type", String)
+], TranslationBundle.prototype, "languageCode", void 0);
+__decorate([
+    Property({ type: 'json', columnType: 'jsonb' }),
+    __metadata("design:type", Object)
+], TranslationBundle.prototype, "entries", void 0);
+__decorate([
+    Property({
+        type: 'bigint',
+        columnType: 'bigint',
+        defaultRaw: "nextval('translation_bundles_version_seq')",
+    }),
+    __metadata("design:type", Number)
+], TranslationBundle.prototype, "version", void 0);
+__decorate([
+    Property({ type: 'Date' }),
+    __metadata("design:type", Date)
+], TranslationBundle.prototype, "installedAt", void 0);
+__decorate([
+    Property({ type: 'Date', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], TranslationBundle.prototype, "updatedAt", void 0);
+TranslationBundle = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'translation_bundles' }),
+    Index({
+        properties: ['languageCode'],
+        name: 'idx_translation_bundles_language_code',
+    })
+], TranslationBundle);
+export { TranslationBundle };
+//# sourceMappingURL=translation-bundle.entity.js.map

package/dist/backend/entities/translation-bundle.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-bundle.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/translation-bundle.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGjE;;;;;;;;;;GAUG;AAOI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,CAAC,aAAa,CAAC,CAA2C;IAG1D,QAAQ,CAAU;IAGlB,YAAY,CAA0B;IAGtC,OAAO,GAA6B,EAAE,CAAC;IAOvC,OAAO,CAAU;IAGjB,WAAW,GAAS,IAAI,IAAI,EAAE,CAAC;IAG/B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AApBC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;mDACzB;AAGlB;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;uDACL;AAGtC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;;kDACT;AAOvC;IALC,QAAQ,CAAC;QACR,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,4CAA4C;KACzD,CAAC;;kDACe;AAGjB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;8BACd,IAAI;sDAAc;AAG/B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAC5C,IAAI;oDAAc;AAvBlB,iBAAiB;IAN7B,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC;IAC5C,KAAK,CAAC;QACL,UAAU,EAAE,CAAC,cAAc,CAAC;QAC5B,IAAI,EAAE,uCAAuC;KAC9C,CAAC;GACW,iBAAiB,CAwB7B"}

package/dist/backend/index.d.ts

@@ -0,0 +1,164 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { FastifyRequest } from 'fastify';
+import { type ModuleContext } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { I18nService } from './services/i18n-service.js';
+import { type I18nReconcileEntry, type I18nReconcileResult } from './services/bundle-reconciler.js';
+import { TranslationBundle } from './entities/translation-bundle.entity.js';
+/**
+ * `_i18n` — the module whose boot-time work does not run in `ctx.onBoot`
+ * (feature 072, wave 1, T089).
+ *
+ * Seventeen conversions before this one put their boot-time work in
+ * `ctx.onBoot`. This one does not, and the reason is worth stating because the
+ * natural move is to make it uniform with the other seventeen.
+ *
+ * This module walks the lifecycle manifest registry to refresh every module's
+ * `translation_bundles` rows from disk. It reaches that registry through a lazy
+ * accessor, because `_lifecycle`'s orchestrator is constructed *after* it — the
+ * chicken-and-egg the original `registry?: T | (() => T | undefined)` option
+ * shape exists to break. The reconcile therefore runs from the `ctx.routes`
+ * callback, at **plugin attach**, which is the point at which every root has
+ * finished composing and the accessor is guaranteed to answer.
+ *
+ * D-45 made the boot phase the last thing a root does before it builds the
+ * server, so `ctx.onBoot` would find the registry today too. The reconcile stays
+ * where it is all the same: the two placements are not equivalent in general (a
+ * root that composes without building a server runs one and not the other), and
+ * the failure mode if the accessor ever answered `undefined` again is silent —
+ * the reconciler's documented behaviour for an absent registry is to return
+ * `{installed: 0, skipped: 0, failed: 0}`, i.e. success. Every module's
+ * translation bundles would quietly stop being refreshed, with no exception and
+ * no warning, and the first symptom would be screens rendering raw i18n keys
+ * some time after somebody edits a JSON bundle. Moving it therefore needs
+ * evidence, not tidiness. `test/unit/_i18n/reconcile-timing.test.ts` pins the
+ * placement, because the harness cannot: since issue #158 `setupBackendServer`
+ * does pass the resolved registry and this reconcile does run there, but a
+ * composed server can only observe that it happened — never that it happened at
+ * plugin attach rather than during registration or boot.
+ *
+ * **The third `AdminUserService` goes away.** `composition.ts` built one
+ * specially for this module — `new AdminUserService(em)`, with no audit writer
+ * — while `admin_users` built its own with one, and the harness a third.
+ * Nothing was being lost: the only method reached from here is
+ * `setPreferredLanguage`, which is explicitly marked `command-coverage-ignore`
+ * as a personal UI setting rather than an audited mutation. But it is the same
+ * shape this wave has now removed six times — an optional constructor argument,
+ * silently omitted, defaulting the unsafe way — and resolving the service from
+ * the container means there is one of it, and it is the audited one.
+ *
+ * `deps.orm` was in the option interface and read nowhere in the factory body.
+ * It does not reappear here.
+ */
+/**
+ * The slice of the lifecycle registry this module reads: every registered
+ * module's manifest and the path it was loaded from, which is all
+ * `reconcileBundles` needs to find `<module>/<bundlesDir>/<lang>.json`.
+ *
+ * Declared here rather than imported from `_lifecycle` (feature 075, Phase C).
+ * `lifecycleManifestRegistry` is a name a **composition root** supplies —
+ * which modules a deployment ships is a root's input, and `_lifecycle`'s own
+ * `LoadedManifestRegistry` additionally carries a dependency graph and each
+ * module's install hooks, none of which a bundle reconcile has any business
+ * seeing. Stating the demand is what keeps the two apart.
+ */
+export interface I18nManifestRegistryView {
+    readonly modules: {
+        values(): Iterable<I18nReconcileEntry>;
+    };
+}
+/** Reads the lifecycle registry lazily; `undefined` until `_lifecycle` exists. */
+export type LifecycleManifestRegistryAccessor = () => I18nManifestRegistryView | undefined;
+export interface AdminI18nCradle {
+    readonly emFactory: () => EntityManager;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly adminContextResolver: (req: FastifyRequest) => {
+        adminUserId: string;
+    };
+    readonly lifecycleManifestRegistry: LifecycleManifestRegistryAccessor;
+    readonly adminI18nService: I18nService;
+    readonly adminI18nReconciler: AdminI18nReconciler;
+}
+/** The lifecycle-orchestrator-shaped hook surface (feature 019 FR-016). */
+export interface AdminI18nReconciler {
+    install(args: {
+        moduleId: string;
+        modulePath: string;
+        bundlesDir: string;
+    }): Promise<{
+        installed: string[];
+    }>;
+    remove(moduleId: string): Promise<{
+        removed: number;
+    }>;
+    /** Re-read every module's on-disk bundles without a restart (`i18n:reload`). */
+    reloadAll(): Promise<I18nReconcileResult>;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * 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 declare const entities: (typeof 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, type BundleLoaderOptions, type LoadedBundles, } from './services/bundle-loader.js';
+export { reconcileBundles, type I18nReconcileFailure, } from './services/bundle-reconciler.js';
+export { registerI18nAdminRoutes, type I18nAdminDeps } from './routes.admin.js';
+export type { I18nReconcileEntry, I18nReconcileResult };
+//# 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,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,CAAC,CAAA;KAAE,CAAC;CAC9D;AAED,kFAAkF;AAClF,MAAM,MAAM,iCAAiC,GAAG,MAC5C,wBAAwB,GACxB,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,QAAQ,CAAC,yBAAyB,EAAE,iCAAiC,CAAC;IACtE,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CACnD;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,IAAI,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,gFAAgF;IAChF,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC3C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA6DvD;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,8BAEpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,gBAAgB,EAChB,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC"}