@endora-commerce/mod-i18n 0.100.0

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

@@ -0,0 +1,323 @@
+import { LANGUAGE_FALLBACK, SUPPORTED_LANGUAGES, } from '@endora-commerce/contracts';
+import { TranslationBundle } from '../entities/translation-bundle.entity.js';
+import { loadModuleBundles } from './bundle-loader.js';
+import { MissingKeyLogger } from './missing-key-logger.js';
+export class I18nService {
+    em;
+    missingKeyLogger;
+    cache = new Map();
+    constructor(deps) {
+        this.em = deps.em;
+        this.missingKeyLogger = deps.missingKeyLogger ?? new MissingKeyLogger();
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle hook surface — driven by feature 018's orchestrator.
+    // -------------------------------------------------------------------------
+    /**
+     * 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.
+     */
+    async installBundlesForModule(moduleId, modulePath, bundlesDir, em) {
+        const loaded = loadModuleBundles(moduleId, modulePath, bundlesDir);
+        const targetEm = em ?? this.em();
+        const installed = [];
+        for (const [language, entries] of loaded.byLanguage) {
+            // Single-statement UPSERT — INSERT bumps `version` via the column
+            // default (nextval); the conflict UPDATE bumps it explicitly so
+            // every successful install advances the sequence regardless of
+            // whether the row existed (research §R9).
+            //
+            // Through `targetEm.execute`, not `targetEm.getKnex().raw`: the knex
+            // instance is connection-level and carries no transaction context, so a
+            // caller that passes a transactional `em` — as the signature invites, and
+            // as the install path's revert semantics assume — got rows that outlived
+            // its rollback (issue #200).
+            await targetEm.execute(`insert into "translation_bundles" ("module_id", "language_code", "entries", "installed_at", "updated_at") ` +
+                `values (?, ?, ?::jsonb, now(), now()) ` +
+                `on conflict ("module_id", "language_code") do update set ` +
+                `"entries" = excluded."entries", ` +
+                `"version" = nextval('translation_bundles_version_seq'), ` +
+                `"updated_at" = now()`, [moduleId, language, JSON.stringify(entries)]);
+            installed.push(language);
+        }
+        // Force the next read for any affected language to rebuild from DB.
+        for (const language of installed) {
+            this.cache.delete(language);
+        }
+        return { installed };
+    }
+    /** Hard-uninstall — soft-uninstall is a no-op (data-model §3). */
+    async removeBundlesForModule(moduleId, em) {
+        // command-coverage-ignore: idempotent lifecycle reconciler/seed — a system-
+        // invariant repair, not an operator-initiated audited write.
+        const targetEm = em ?? this.em();
+        const removed = await targetEm.nativeDelete(TranslationBundle, { moduleId });
+        // Affected languages are unknown without a SELECT-then-DELETE; clear all.
+        this.cache.clear();
+        // Feature 021: drop accumulator entries so the diagnostic stops reporting
+        // the now-uninstalled module.
+        this.missingKeyLogger.pruneModule(moduleId);
+        return { removed };
+    }
+    // -------------------------------------------------------------------------
+    // Coverage diagnostic — feature 021.
+    // -------------------------------------------------------------------------
+    /**
+     * 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).
+     */
+    async getCoverageSnapshot(filter = {}, em) {
+        const targetEm = em ?? this.em();
+        const moduleFilter = filter.moduleIds && filter.moduleIds.length > 0
+            ? new Set(filter.moduleIds)
+            : null;
+        const langFilter = filter.languageCodes && filter.languageCodes.length > 0
+            ? new Set(filter.languageCodes)
+            : null;
+        // Load every bundle from the DB. The bundles table is small (one row per
+        // module-language pair); a full scan is fine for a diagnostic that runs
+        // at admin-review cadence.
+        const rows = await targetEm.find(TranslationBundle, {});
+        const byModule = new Map();
+        for (const row of rows) {
+            const exposedId = exposedBundleNamespace(row.moduleId);
+            if (moduleFilter && !moduleFilter.has(exposedId))
+                continue;
+            const langs = byModule.get(exposedId) ?? new Map();
+            langs.set(row.languageCode, row.entries);
+            byModule.set(exposedId, langs);
+        }
+        // Index the accumulator by (moduleId, languageCode) → Set<key>.
+        const runtimeMissing = new Map();
+        const runtimeFellBackToEn = new Map();
+        for (const entry of this.missingKeyLogger.snapshot()) {
+            if (moduleFilter && !moduleFilter.has(entry.moduleId))
+                continue;
+            const lang = entry.languageCode;
+            if (langFilter && !langFilter.has(lang))
+                continue;
+            const missingMap = runtimeMissing.get(entry.moduleId) ?? new Map();
+            const missingSet = missingMap.get(lang) ?? new Set();
+            missingSet.add(entry.key);
+            missingMap.set(lang, missingSet);
+            runtimeMissing.set(entry.moduleId, missingMap);
+            if (entry.fellBackTo === 'en') {
+                const fbMap = runtimeFellBackToEn.get(entry.moduleId) ?? new Map();
+                const fbSet = fbMap.get(lang) ?? new Set();
+                fbSet.add(entry.key);
+                fbMap.set(lang, fbSet);
+                runtimeFellBackToEn.set(entry.moduleId, fbMap);
+            }
+        }
+        const allModuleIds = new Set([
+            ...byModule.keys(),
+            ...runtimeMissing.keys(),
+        ]);
+        const modules = [];
+        for (const moduleId of Array.from(allModuleIds).sort()) {
+            const langs = byModule.get(moduleId) ?? new Map();
+            const languages = [];
+            for (const lang of SUPPORTED_LANGUAGES) {
+                if (langFilter && !langFilter.has(lang))
+                    continue;
+                const entries = langs.get(lang) ?? {};
+                const otherEntries = lang === LANGUAGE_FALLBACK
+                    ? (Array.from(langs.entries()).find(([k]) => k !== LANGUAGE_FALLBACK)?.[1] ?? {})
+                    : (langs.get(LANGUAGE_FALLBACK) ?? {});
+                // Static-scan missing: keys present in any other language but absent
+                // in this one.
+                const staticMissing = new Set();
+                for (const k of Object.keys(otherEntries)) {
+                    if (!(k in entries))
+                        staticMissing.add(k);
+                }
+                // Union with the runtime accumulator's missing set.
+                const runtimeSet = runtimeMissing.get(moduleId)?.get(lang) ?? new Set();
+                for (const k of runtimeSet)
+                    staticMissing.add(k);
+                const missingKeys = Array.from(staticMissing).sort();
+                const fbSet = runtimeFellBackToEn.get(moduleId)?.get(lang) ?? new Set();
+                languages.push({
+                    languageCode: lang,
+                    totalKeysSeen: Object.keys(entries).length + (filter.includeKeys === 'all' ? 0 : 0),
+                    missingCount: missingKeys.length,
+                    missingKeys,
+                    fellBackToEnCount: fbSet.size,
+                    fellBackToEnKeys: Array.from(fbSet).sort(),
+                });
+            }
+            modules.push({ moduleId, languages });
+        }
+        return {
+            capturedAt: new Date().toISOString(),
+            modules,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Read surface — driven by the GET /api/v1/admin/i18n/bundles endpoint.
+    // -------------------------------------------------------------------------
+    async getMergedBundleForLanguage(language, em) {
+        const targetEm = em ?? this.em();
+        // `targetEm.execute`, not `targetEm.getKnex()`: the rows below are read
+        // through `targetEm`, so a caller holding a transaction open would have had
+        // the freshness probe answer from outside it and the row read from inside —
+        // one method, two views of the same table (issue #200).
+        const maxRows = (await targetEm.execute(`select max("version") as max from "translation_bundles" where "language_code" = ?`, [language]));
+        const liveMax = maxRows[0]?.max == null ? 0 : Number(maxRows[0].max);
+        const cached = this.cache.get(language);
+        if (cached && cached.version >= liveMax) {
+            return { version: cached.version, bundles: cached.merged };
+        }
+        const rows = await targetEm.find(TranslationBundle, { languageCode: language });
+        const merged = {};
+        let highest = 0;
+        for (const row of rows) {
+            // The `_i18n` module ships its own bundle as the synthetic `core`
+            // namespace that owns admin-chrome strings (AppShell, login,
+            // profile). DB rows stay keyed by `_i18n` so they line up with
+            // `module_registrations`; the rename happens at the resolver
+            // boundary so consumers (Admin SPA + backend `translate(...)`
+            // calls) look it up under `core`. See data-model.md §3 / §4 and
+            // research.md §R7.
+            const exposedId = exposedBundleNamespace(row.moduleId);
+            merged[exposedId] = row.entries;
+            if (Number(row.version) > highest)
+                highest = Number(row.version);
+        }
+        this.cache.set(language, { version: highest, merged });
+        return { version: highest, bundles: merged };
+    }
+    // -------------------------------------------------------------------------
+    // Resolver — backend-side string lookup for emitted messages
+    // (audit-log labels, validation messages, notifications, etc.).
+    // -------------------------------------------------------------------------
+    async translate(moduleId, key, language, params, em) {
+        // The alias, applied on the **read** side — feature 090, Phase 3
+        // (`specs/090-module-owned-error-codes/core-block-home.md` §4(c)).
+        //
+        // This module's bundle is exposed to clients under the synthetic namespace
+        // `core`, for the reason `getMergedBundleForLanguage` gives above: the
+        // admin SPA has called it that since feature 019 and does so in 132 places.
+        // Every caller therefore asked for `core` — until this module declared the
+        // platform's 100 error codes in its own manifest, which made the composed
+        // routing map answer `_i18n` and `translate('_i18n', 'errors.INTERNAL', …)`
+        // return the placeholder. Both composition roots turn a placeholder back
+        // into the raiser's untranslated English, silently, so the symptom would
+        // have been 41 codes losing their sentences in both shipped languages with
+        // no log and no failing check. `backend/test/integration/_i18n/
+        // platform-error-sentences.test.ts` is the assertion that refuses it.
+        //
+        // The alternative was to publish the bundle under both keys in the merged
+        // map, and it was refused: that map is the payload
+        // `GET /api/v1/admin/i18n/bundles` serves, so it would change the wire
+        // shape and duplicate the largest bundle on every admin boot.
+        //
+        // **A module with no legacy namespace needs nothing equivalent.** This is
+        // one fact about one repository's history, not a pattern to copy: a
+        // stranger's module is looked up under the id it registers. The remaining
+        // three copies of the identity live in
+        // `backend/scripts/check-error-translations.ts`, which still reads the
+        // prefix chain and so still sees the string `core`; they go with the chain,
+        // in the merge request that deletes it.
+        const bundleId = exposedBundleNamespace(moduleId);
+        const merged = await this.getMergedBundleForLanguage(language, em);
+        const requested = merged.bundles[bundleId]?.[key];
+        if (requested != null) {
+            return interpolate(requested, params);
+        }
+        if (language !== LANGUAGE_FALLBACK) {
+            const fallback = await this.getMergedBundleForLanguage(LANGUAGE_FALLBACK, em);
+            const englishValue = fallback.bundles[bundleId]?.[key];
+            if (englishValue != null) {
+                // The **exposed** id, not the caller's: `getCoverageSnapshot` keys its
+                // bundle side by the exposed id too, so logging `_i18n` here would
+                // report a second module with no bundle and 0% coverage beside `core`.
+                this.missingKeyLogger.logFallback({
+                    moduleId: bundleId,
+                    languageCode: language,
+                    key,
+                    fellBackTo: 'en',
+                });
+                return interpolate(englishValue, params);
+            }
+        }
+        this.missingKeyLogger.logFallback({
+            moduleId: bundleId,
+            languageCode: language,
+            key,
+            fellBackTo: 'placeholder',
+        });
+        // The **caller's** id, and this one may not be normalised: both composition
+        // roots recognise a miss by comparing the answer to `${moduleId}.${key}`
+        // with the id they passed in, and answer the raiser's own message when it
+        // matches. Returning `core.errors.INTERNAL` to a caller that asked about
+        // `_i18n` would defeat that comparison and put the placeholder itself in
+        // front of a client.
+        return `${moduleId}.${key}`;
+    }
+}
+// `SUPPORTED_LANGUAGES` and `BundleLoadError` were re-exported here "for tests /
+// consumers", and the line went with T040b's packaging. Neither had a consumer:
+// `SUPPORTED_LANGUAGES` is `@endora-commerce/contracts`', which every caller
+// already imports from there, and `BundleLoadError` is published by this
+// package's own `./backend` barrel beside `loadModuleBundles`. What made the
+// line a defect rather than dead weight is that it is a bare `export { … }`
+// over two *imported* bindings, so `readBackendSurface` — which follows the
+// barrel's re-exports to decide whether a package publishes an entity class by
+// name (D-168) — reached a specifier it cannot resolve and reported
+// `unresolvable-reexport`. That verdict is right: a re-export it cannot read is
+// the one case where a silent pass would mean "not looking".
+/** Manifest id of the platform-internal i18n module (= the chrome bundle owner). */
+const I18N_CHROME_MODULE_ID = '_i18n';
+/** Synthetic namespace exposed to clients for the `_i18n` module's bundle. */
+const CORE_NAMESPACE = 'core';
+/**
+ * `_i18n` -> `core`, written once — and this is now the **only** statement of it
+ * in the tree (D-185, feature 090 Phase 4).
+ *
+ * It was eight applications over four files from four independently declared
+ * constants. Six of them read the prefix chain — three in
+ * `backend/scripts/check-error-translations.ts` and three in two of its tests —
+ * and went with it when Phase 4 deleted the chain; the two here had already been
+ * collapsed into this one function by the platform-block migration. Reaching one
+ * copy was therefore done by deleting, never by rewriting.
+ *
+ * **A module with a legacy client-facing namespace is what needs this, and there
+ * is exactly one.** `_i18n`'s bundle has answered to `core` since feature 019
+ * and the admin SPA calls it that at 132 sites in 81 files, so the module id the
+ * routing map carries and the namespace a client asks for are two different
+ * words for one bundle. **A module written today has no such history and needs
+ * nothing equivalent** — its id *is* its namespace, and copying this function
+ * into another module would invent a second name for a bundle that has one.
+ *
+ * It is deliberately on the **read** side. The merged bundle map is the payload
+ * `GET /api/v1/admin/i18n/bundles` serves, so aliasing it would change the wire
+ * shape and duplicate the largest bundle for every admin boot; and the
+ * placeholder `translate` returns is not aliased either, because both
+ * composition roots recognise a miss by comparing that placeholder to the id
+ * they passed in.
+ *
+ * Without it, 41 codes lose their sentences in **both** shipped languages,
+ * silently: `translate('_i18n', …)` would return the raw key and the roots would
+ * map a placeholder-equal result back to the raiser's untranslated English, with
+ * no log and no finding.
+ * `backend/test/integration/_i18n/platform-error-sentences.test.ts` is the
+ * assertion, and it is a Polish one on purpose — the degradation is English.
+ */
+function exposedBundleNamespace(moduleId) {
+    return moduleId === I18N_CHROME_MODULE_ID ? CORE_NAMESPACE : moduleId;
+}
+/** Substitute `{name}` placeholders. Missing params are left as-is. */
+function interpolate(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{(\w+)\}/g, (_, name) => params[name] != null ? String(params[name]) : `{${name}}`);
+}
+//# sourceMappingURL=i18n-service.js.map

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

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

package/dist/backend/services/missing-key-logger.d.ts

@@ -0,0 +1,52 @@
+import type { ModuleLifecycleLogger } from '@endora-commerce/contracts';
+/**
+ * Diagnostic surface for the resolver's fallback path — feature 019 /
+ * spec FR-014, research §R8.
+ *
+ * Every time the resolver falls back from the user's preferred language
+ * to English, or from English to the literal `${scope}.${key}` placeholder,
+ * a structured log line is emitted so the gap is observable without
+ * changing user-facing behaviour.
+ *
+ * Shape stays stable across callsites — operators run
+ * `grep '"event":"i18n.fallback"'` against the platform's existing log
+ * tail. The shape is exercised by `test/unit/_i18n/missing-key-logger.unit.test.ts`.
+ */
+export interface FallbackLogEntry {
+    event: 'i18n.fallback';
+    moduleId: string;
+    languageCode: string;
+    key: string;
+    fellBackTo: 'en' | 'placeholder';
+}
+export interface MissingKeyLoggerOptions {
+    /** Optional logger override; falls back to the project's standard console-style sink. */
+    logger?: Pick<ModuleLifecycleLogger, 'info'> & {
+        info(msg: string): void;
+    };
+}
+export interface MissingKeyEntry {
+    moduleId: string;
+    languageCode: string;
+    key: string;
+    fellBackTo: 'en' | 'placeholder';
+}
+export declare class MissingKeyLogger {
+    private readonly logger;
+    /**
+     * Feature 021: in-process accumulator backing the coverage diagnostic.
+     * Keyed by `${moduleId}:${languageCode}:${key}` so repeated resolutions
+     * of the same missing entry don't inflate the count.
+     */
+    private readonly entries;
+    constructor(opts?: MissingKeyLoggerOptions);
+    logFallback(entry: Omit<FallbackLogEntry, 'event'>): void;
+    /** Coverage diagnostic — return a defensive copy of the accumulator. */
+    snapshot(): MissingKeyEntry[];
+    /**
+     * Drop every accumulator entry owned by `moduleId`. Called on module
+     * hard-uninstall so the diagnostic doesn't report a phantom module.
+     */
+    pruneModule(moduleId: string): void;
+}
+//# sourceMappingURL=missing-key-logger.d.ts.map

package/dist/backend/services/missing-key-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-key-logger.d.ts","sourceRoot":"","sources":["../../../src/backend/services/missing-key-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,IAAI,GAAG,aAAa,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,yFAAyF;IACzF,MAAM,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC5E;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,IAAI,GAAG,aAAa,CAAC;CAClC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;gBAElD,IAAI,GAAE,uBAA4B;IAQ9C,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG,IAAI;IAOzD,wEAAwE;IACxE,QAAQ,IAAI,eAAe,EAAE;IAI7B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAKpC"}

package/dist/backend/services/missing-key-logger.js

@@ -0,0 +1,37 @@
+export class MissingKeyLogger {
+    logger;
+    /**
+     * Feature 021: in-process accumulator backing the coverage diagnostic.
+     * Keyed by `${moduleId}:${languageCode}:${key}` so repeated resolutions
+     * of the same missing entry don't inflate the count.
+     */
+    entries = new Map();
+    constructor(opts = {}) {
+        // Default sink uses `console.warn` so it surfaces under the project's
+        // lint policy (which restricts `console.info`). The structured payload
+        // already carries `event:'i18n.fallback'`, so consumers grep on event
+        // rather than log level — the level is operationally diagnostic only.
+        this.logger = opts.logger ?? { info: (msg) => console.warn(msg) };
+    }
+    logFallback(entry) {
+        const payload = { event: 'i18n.fallback', ...entry };
+        this.logger.info(JSON.stringify(payload));
+        const k = `${entry.moduleId}:${entry.languageCode}:${entry.key}`;
+        this.entries.set(k, { ...entry });
+    }
+    /** Coverage diagnostic — return a defensive copy of the accumulator. */
+    snapshot() {
+        return Array.from(this.entries.values());
+    }
+    /**
+     * Drop every accumulator entry owned by `moduleId`. Called on module
+     * hard-uninstall so the diagnostic doesn't report a phantom module.
+     */
+    pruneModule(moduleId) {
+        for (const k of Array.from(this.entries.keys())) {
+            if (k.startsWith(`${moduleId}:`))
+                this.entries.delete(k);
+        }
+    }
+}
+//# sourceMappingURL=missing-key-logger.js.map

package/dist/backend/services/missing-key-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-key-logger.js","sourceRoot":"","sources":["../../../src/backend/services/missing-key-logger.ts"],"names":[],"mappings":"AAoCA,MAAM,OAAO,gBAAgB;IACV,MAAM,CAA8B;IACrD;;;;OAIG;IACc,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE9D,YAAY,OAAgC,EAAE;QAC5C,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,sEAAsE;QACtE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,WAAW,CAAC,KAAsC;QAChD,MAAM,OAAO,GAAqB,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,KAAK,EAAE,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACjE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,wEAAwE;IACxE,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,QAAgB;QAC1B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;CACF"}

package/dist/manifest.d.ts

@@ -0,0 +1,214 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type ModuleCliCommand, type ModuleLifecycleParticipant } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+/**
+ * Admin UI i18n subsystem — feature 019.
+ *
+ * Platform-internal module (underscore-prefixed exemption per Constitution
+ * Principle VI, alongside `auth` / `example` / `_lifecycle`). Owns the
+ * `translation_bundles` table, the per-language merged-bundle resolver,
+ * the read API consumed by the admin SPA at boot, and the `core`
+ * namespace that holds admin-chrome strings (AppShell, navigation,
+ * login, profile).
+ *
+ * Depends on `_lifecycle` because every module's bundle install / hard-
+ * uninstall is driven by the lifecycle orchestrator's hook surface.
+ */
+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" | "uuid" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "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;
+};
+/**
+ * `translation_bundles` follows the manifest set — feature 080, T036a / D-159.
+ *
+ * Not an install hook: an install hook fires for *its own* module, and this has
+ * to run whenever **any** module is installed, because this module's table is a
+ * projection of every other module's `manifest.i18n` declaration. Not a port
+ * either: the lifecycle orchestrator also serves the five `module:*` commands,
+ * and a platform command composes no container to resolve one from (D-157.2 /
+ * D-157.4) — which is exactly how a terminal install came to write no bundle at
+ * all while the same install from `/platform/modules` wrote them.
+ *
+ * The service is imported at call time, not at module load. This file is
+ * imported by the generated manifest index, which is in turn imported by every
+ * static check script and by `src/db/configured-migrations.ts`; a static import
+ * of `I18nService` would pull an ORM-dependent graph into all of them.
+ *
+ * A fresh `I18nService` per call is correct and not a lost cache:
+ * `getMergedBundleForLanguage` revalidates against `MAX(version)` in the table
+ * on every read, so the running server picks the new rows up on its next
+ * request without having been the instance that wrote them.
+ */
+export declare const lifecycleParticipant: ModuleLifecycleParticipant<EntityManager>;
+/**
+ * The two operator commands this module declares — feature 080, T042b /
+ * D-160.9.
+ *
+ * They were `scripts/reload.ts` and `scripts/coverage.ts`, each opening its own
+ * ORM and building its own `I18nService`. The host composes now and hands the
+ * body this module's `ModuleContext`, which is what retired this module's one
+ * `check:module-boundary` key: `reload` needed the deployment's module registry,
+ * and the registry is a root-supplied name any module may read off its cradle.
+ *
+ * The bodies are `await import()`ed for the reason the participant above gives:
+ * this file is imported by the generated manifest index, and through it by every
+ * static check script and by `src/db/configured-migrations.ts`.
+ */
+export declare const cliCommands: ReadonlyArray<ModuleCliCommand<ModuleContext>>;
+//# 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":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyKnB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,EAAE,0BAA0B,CAAC,aAAa,CAqB1E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAWtE,CAAC"}