libmodulor 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # CHANGELOG
 
+## v0.24.0 (2025-12-07)
+
+**Highlights**
+
+- Introduced `babel`, `vite` plugins and `webpack` loader => https://libmodulor.c100k.eu/docs/guides/bundle-target
+- Introduced the `node-stricli-cli` target using @bloomberg's `stricli` library
+- Introduced the `Playground` example, runnable locally, to play with all the features of `libmodulor` => https://libmodulor.c100k.eu/docs/examples/Playground
+- Improved apps testing by making sure non-english languages are fully translated
+- Improved apps testing performance by optimizing use cases testing using the `stream` transport
+- Introduced `de` 🇩🇪 and `es` 🇪🇸 locales (see them in action in the `Playground`)
+
+Some breaking changes but at the very low level. If your apps break, just follow the TypeScript errors and you should be good to go.
+
+Also bumped React versions for the infamous [React2Shell vulnerability](https://react.dev/blog/2025/12/03/critical-security-vulnerability-in-react-server-components).
+
+See all the changes here : https://github.com/c100k/libmodulor/compare/v0.23.0...master
+
 ## v0.23.0 (2025-11-11)
 
 See all the changes here : https://github.com/c100k/libmodulor/compare/v0.22.0...master

package/README.md

@@ -7,14 +7,166 @@ A TypeScript library to create platform-agnostic applications.
 
 ## 🚀 Getting Started
 
-If you're discovering `libmodulor`, we recommend reading the [📖 Documentation](https://libmodulor.c100k.eu/docs) first. You'll find everything you need to get started : Concepts, Examples and Guides.
+If you're discovering `libmodulor`, we recommend reading the [📖 Documentation](https://libmodulor.c100k.eu/docs) first.
+You'll find everything you need to get started : Concepts, Examples and Guides.
 
 When you're ready, [🚀 Create a project](https://libmodulor.c100k.eu/docs/guides/create-project) and build the awesome idea you have in mind.
 
+In the meantime, here is how to declare the four layers of `libmodulor`.
+
+_These snippets are extracted from the [`Basic`](https://libmodulor.c100k.eu/docs/examples/Basic) example (check out the full example to get the full picture)._
+
+### App
+
+```ts
+const appManifest = {
+    languageCodes: ['en', 'fr'],
+    name: 'Event',
+    ucReg: {
+        Register: {
+            action: 'Create',
+            icon: 'user',
+            name: 'Register',
+        },
+    },
+} satisfies AppManifest;
+
+const appI18n: AppI18n = {
+    en: {
+        ucif_email_label: 'Your email address',
+        ucif_firstname_label: 'Your firstname',
+        ucif_lastname_label: 'Your lastname',
+        ucof_id_label: 'Your registration #',
+        ucof_ticketNumber_label: 'Your ticket #',
+    },
+    fr: {
+        ucif_email_label: 'Votre adresse email',
+        ucif_firstname_label: 'Votre prénom',
+        ucif_lastname_label: 'Votre nom',
+        ucof_id_label: "Votre # d'inscription",
+        ucof_ticketNumber_label: 'Votre # de ticket',
+    },
+};
+```
+
+### Use Case
+
+```ts
+interface RegisterInput extends UCInput {
+    email: UCInputFieldValue<Email>;
+    firstname: UCInputFieldValue<PersonFirstname>;
+    lastname: UCInputFieldValue<PersonLastname>;
+}
+
+interface RegisterOPI0 extends AggregateOPI0 {
+    amount: Amount;
+    ticketNumber: TicketNumber;
+}
+
+@injectable()
+class RegisterClientMain implements UCMain<RegisterInput, RegisterOPI0> {
+    constructor(@inject('UCManager') private ucManager: UCManager) {}
+
+    public async exec({
+        uc,
+    }: UCMainInput<RegisterInput, RegisterOPI0>): Promise<
+        UCOutput<RegisterOPI0>
+    > {
+        const { aggregateId } = await this.ucManager.persist(uc);
+
+        const amount: Amount = 99.99; // Should come from some catalog in a real application
+        const ticketNumber: TicketNumber = 1; // Should come from a safely auto-generated sequence in a real application
+
+        return new UCOutputBuilder<RegisterOPI0>()
+            .add({
+                amount,
+                id: aggregateId,
+                ticketNumber,
+            })
+            .get();
+    }
+}
+
+const RegisterUCD: UCDef<RegisterInput, RegisterOPI0> = {
+    io: {
+        i: {
+            fields: {
+                email: {
+                    type: new TEmail(),
+                },
+                firstname: {
+                    type: new TPersonFirstname(),
+                },
+                lastname: {
+                    type: new TPersonLastname(),
+                },
+            },
+        },
+        o: {
+            parts: {
+                _0: {
+                    fields: {
+                        amount: {
+                            type: new TAmount('EUR'),
+                        },
+                        ticketNumber: {
+                            type: new TTicketNumber(),
+                        },
+                    },
+                    order: ['ticketNumber', 'amount', 'id'],
+                },
+            },
+        },
+    },
+    lifecycle: {
+        client: {
+            main: RegisterClientMain,
+            policy: EverybodyUCPolicy,
+        },
+    },
+    metadata: {
+        action: 'Create',
+        icon: 'user',
+        name: 'Register',
+    },
+};
+```
+
+### Product
+
+```ts
+const productManifest: ProductManifest = {
+    appReg: [{ name: 'Event' }],
+    name: 'Eventer',
+};
+
+const productI18n: ProductI18n = {
+    en: {
+        ...I18nEN,
+        ...appI18n.en,
+    },
+    fr: {
+        ...I18nFR,
+        ...appI18n.fr,
+    },
+};
+```
+
+### Target
+
+```ts
+const container = new Container(CONTAINER_OPTS);
+
+bindCommon(container);
+bindNodeCore(container);
+bindProduct(container, productManifest, productI18n);
+```
+
+
 ## 👨‍💻 Contribute
 
 If you think you can help in any way, feel free to contact me (cf. `author` in `package.json`). I'd love to chat.
 
 ## ⚖️ License
 
-[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.23.0/LICENSE)
+[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.24.0/LICENSE)

package/dist/esm/apps/Helper/src/lib/project.js

@@ -86,8 +86,8 @@ export const PACKAGE_JSON = (name) => `{
         "reflect-metadata": "^0.2.2"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.3.4",
-        "@types/node": "^24.10.0",
+        "@biomejs/biome": "^2.3.8",
+        "@types/node": "^24.10.1",
         "@vitest/coverage-v8": "^3.2.4",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
@@ -95,7 +95,7 @@ export const PACKAGE_JSON = (name) => `{
         "express-fileupload": "^1.5.2",
         "fast-check": "^4.3.0",
         "helmet": "^8.1.0",
-        "jose": "^6.1.0",
+        "jose": "^6.1.2",
         "typescript": "^5.9.3",
         "vite": "^6.4.1",
         "vitest": "^3.2.4"

package/dist/esm/apps/Helper/src/ucds/TestAppUCD.d.ts

@@ -1,8 +1,9 @@
 import type { AppName } from '../../../../app/index.js';
-import { type UCDef, type UCInputFieldValue } from '../../../../uc/index.js';
+import { type UCDef, type UCInputFieldValue, type UCName } from '../../../../uc/index.js';
 import { type AppInput } from '../lib/app.js';
 export interface TestAppInput extends AppInput {
     appName: UCInputFieldValue<AppName>;
+    only: UCInputFieldValue<UCName>;
     skipCoverage: UCInputFieldValue<boolean>;
     updateSnapshots: UCInputFieldValue<boolean>;
 }

package/dist/esm/apps/Helper/src/ucds/TestAppUCD.js

@@ -34,6 +34,7 @@ let TestAppClientMain = class TestAppClientMain {
     async exec({ uc }) {
         const appsPath = uc.reqVal0('appsPath');
         const appName = uc.reqVal0('appName');
+        const only = uc.rVal0('only');
         const skipCoverage = uc.reqVal0('skipCoverage');
         const updateSnapshots = uc.reqVal0('updateSnapshots');
         const appPath = this.fsManager.path(appsPath, appName);
@@ -42,6 +43,7 @@ let TestAppClientMain = class TestAppClientMain {
         }
         await this.appTestSuiteRunner.exec({
             appPath,
+            only,
             skipCoverage,
             updateSnapshots,
         });
@@ -84,6 +86,12 @@ export const TestAppUCD = {
                 appName: {
                     type: new TString().setExamples([APP_NAME_PLACEHOLDER]),
                 },
+                only: {
+                    cardinality: {
+                        min: 0,
+                    },
+                    type: new TString().setExamples(['CreatePost']),
+                },
                 skipCoverage: {
                     type: new TBoolean().setDefaultValue(false),
                 },

package/dist/esm/convention.d.ts

@@ -36,6 +36,9 @@ export declare const UC_DEF_TYPE: string;
 export declare const UC_INPUT_BASE: string;
 export declare const UC_INPUT_FIELD_PATTERN: string;
 export declare const UC_INPUT_SUFFIX: string;
+export declare const UC_LIFECYCLE_PROP_NAME: string;
+export declare const UC_LIFECYCLE_CLIENT_PROP_NAME: string;
+export declare const UC_LIFECYCLE_SERVER_PROP_NAME: string;
 export declare const UC_MAIN_SUFFIX: string;
 export declare const UC_MAIN_CLIENT_SUFFIX: string;
 export declare const UC_MAIN_SERVER_SUFFIX: string;

package/dist/esm/convention.js

@@ -46,6 +46,9 @@ export const UC_DEF_TYPE = 'UCDef';
 export const UC_INPUT_BASE = 'UCInput';
 export const UC_INPUT_FIELD_PATTERN = '^UCInputFieldValue<(.*)>$';
 export const UC_INPUT_SUFFIX = 'Input';
+export const UC_LIFECYCLE_PROP_NAME = 'lifecycle';
+export const UC_LIFECYCLE_CLIENT_PROP_NAME = 'client';
+export const UC_LIFECYCLE_SERVER_PROP_NAME = 'server';
 export const UC_MAIN_SUFFIX = 'Main';
 export const UC_MAIN_CLIENT_SUFFIX = `Client${UC_MAIN_SUFFIX}`;
 export const UC_MAIN_SERVER_SUFFIX = `Server${UC_MAIN_SUFFIX}`;

package/dist/esm/dt/DataTypes.d.ts

@@ -1,2 +1 @@
-import type { DataType } from './DataType.js';
-export declare const DataTypes: DataType[];
+export declare const DataTypes: readonly ["Address", "Amount", "ApiKey", "BarCode", "CSS", "Color", "ColorRGBA", "CompanyName", "CountryISO3166Alpha2", "CurrencyISO4217", "DateISO8601", "DateTimeFormat", "DirPath", "DomainName", "Email", "EmbeddedObject", "Emoji", "EncryptionKey", "ErrorMessage", "ExternalServiceId", "File", "FileExtension", "FileMimeType", "FileName", "FilePath", "FreeTextLong", "FreeTextShort", "Geolocation", "GitSSHURL", "HTML", "HTTPContentType", "HTTPMethod", "HTTPStatusNumber", "HostAddress", "HostPort", "IPv4", "IPv6", "JSONString", "JWT", "JavaScript", "JobTitle", "Markdown", "NumIndex", "Password", "Percentage", "PersonFirstname", "PersonFullname", "PersonInitials", "PersonLastname", "QRCode", "SQLQuery", "SSHPrivateKey", "SSHPublicKey", "SearchQuery", "SemVerVersion", "ShellCommand", "Slug", "Time", "Timestamp", "TransportType", "UIntDuration", "UIntQuantity", "URL", "URLPath", "UUID", "Username", "Year", "YesNo"];

package/dist/esm/dt/base/TObject.js

@@ -65,7 +65,7 @@ export class TObject extends TBase {
                     break;
                 }
                 default:
-                    ((_) => { })(strategy);
+                    strategy;
             }
         }
         return validation;

package/dist/esm/i18n/index.d.ts

@@ -1,3 +1,3 @@
 export { I18N_DEFAULT_LANG } from './consts.js';
-export type { I18n, I18nCoreKey, I18nCoreTranslations, I18nLanguageCode, I18nSource, I18nSourceSafe, I18nTranslation, I18nTranslationKey, } from './types.js';
+export type { I18n, I18nCoreKey, I18nCoreTranslations, I18nEntry, I18nLanguageCode, I18nSource, I18nSourceSafe, I18nTranslation, I18nTranslationKey, } from './types.js';
 export { WordingManager, type WordingManagerKey } from './WordingManager.js';

package/dist/esm/i18n/locales/de.d.ts

@@ -0,0 +1,2 @@
+import type { I18nCoreTranslations } from '../types.js';
+export declare const I18nDE: I18nCoreTranslations;

package/dist/esm/i18n/locales/de.js

@@ -0,0 +1,54 @@
+export const I18nDE = {
+    dt_YesNo_N_desc: '',
+    dt_YesNo_N_label: 'Nein',
+    dt_YesNo_Y_desc: '',
+    dt_YesNo_Y_label: 'Ja',
+    uc_client_confirm_cancel: 'Abbrechen',
+    uc_client_confirm_confirm: 'Ja',
+    uc_client_confirm_message: '',
+    uc_client_confirm_title: 'Sind Sie sicher?',
+    uc_i_submit_changing: 'Laden',
+    uc_i_submit_idle: 'Speichern',
+    uc_i_submit_initializing: 'Laden',
+    uc_i_submit_submitting: 'Speichern',
+    validation_fieldsOr: 'Mindestens eines dieser Felder muss ausgefüllt werden: {{expected}}',
+    validation_format_ColorRGBA: 'Muss eine gültige RGBA-Farbe sein',
+    validation_format_DateISO8601: 'Muss ein gültiges Datum im ISO8601-Format sein',
+    validation_format_DirPath: 'Muss ein gültiger Verzeichnispfad sein',
+    validation_format_DomainName: 'Muss ein gültiger Domainname sein',
+    validation_format_Email: 'Muss eine gültige E-Mail-Adresse sein',
+    validation_format_FilePath: 'Muss ein gültiger Dateipfad sein',
+    validation_format_GitSSHURL: 'Muss eine gültige Git-SSH-URL sein',
+    validation_format_IPv4: 'Muss eine gültige IPv4-Adresse sein',
+    validation_format_IPv6: 'Muss eine gültige IPv6-Adresse sein',
+    validation_format_JSON: 'Muss ein gültiger JSON-String sein',
+    validation_format_JWT: 'Muss ein gültiges JWT sein',
+    validation_format_PersonFirstname: 'Muss ein gültiger Vorname sein, beginnend mit einem Großbuchstaben',
+    validation_format_PersonFullname: 'Muss ein gültiger vollständiger Name sein, beginnend mit einem Großbuchstaben',
+    validation_format_PersonInitials: 'Muss gültige Initialen aus Großbuchstaben enthalten',
+    validation_format_PersonLastname: 'Muss ein gültiger Nachname sein, beginnend mit einem Großbuchstaben',
+    validation_format_QRCode: 'Muss ein gültiger QR-Code im Base64-Format sein',
+    validation_format_SemVerVersion: 'Muss eine gültige SemVer-Version sein (X.X.X)',
+    validation_format_Slug: 'Darf nur Kleinbuchstaben, Ziffern und Bindestriche (-) enthalten',
+    validation_format_SSHPrivateKey: 'Muss ein gültiger privater SSH-Schlüssel sein',
+    validation_format_SSHPublicKey: 'Muss ein gültiger öffentlicher SSH-Schlüssel sein',
+    validation_format_Time: 'Muss eine gültige Uhrzeit sein',
+    validation_format_URL: 'Muss eine gültige URL sein',
+    validation_format_UUID: 'Muss eine gültige UUID sein',
+    validation_mandatory: 'Muss ausgefüllt werden',
+    validation_max: 'Muss kleiner oder gleich {{expected}} sein',
+    validation_maxCount: 'Darf höchstens {{expected}} Element(e) enthalten',
+    validation_maxLength: 'Darf höchstens {{expected}} Zeichen enthalten',
+    validation_min: 'Muss größer oder gleich {{expected}} sein',
+    validation_minCount: 'Muss mindestens {{expected}} Element(e) enthalten',
+    validation_minLength: 'Muss mindestens {{expected}} Zeichen enthalten',
+    validation_oneOf: 'Muss eines der Elemente der Liste sein',
+    validation_shape: 'Muss der erwarteten Objektstruktur entsprechen',
+    validation_type_array: 'Muss ein Array sein',
+    validation_type_boolean: 'Muss ein Boolescher Wert sein',
+    validation_type_int: 'Muss eine ganze Zahl sein',
+    validation_type_number: 'Muss eine Zahl sein',
+    validation_type_object: 'Muss ein Objekt sein',
+    validation_type_scalar: 'Muss ein Skalar sein',
+    validation_type_string: 'Muss ein String sein',
+};

package/dist/esm/i18n/locales/es.d.ts

@@ -0,0 +1,2 @@
+import type { I18nCoreTranslations } from '../types.js';
+export declare const I18nES: I18nCoreTranslations;

package/dist/esm/i18n/locales/es.js

@@ -0,0 +1,54 @@
+export const I18nES = {
+    dt_YesNo_N_desc: '',
+    dt_YesNo_N_label: 'No',
+    dt_YesNo_Y_desc: '',
+    dt_YesNo_Y_label: 'Sí',
+    uc_client_confirm_cancel: 'Cancelar',
+    uc_client_confirm_confirm: 'Sí',
+    uc_client_confirm_message: '',
+    uc_client_confirm_title: '¿Estás seguro?',
+    uc_i_submit_changing: 'Cargando',
+    uc_i_submit_idle: 'Guardar',
+    uc_i_submit_initializing: 'Cargando',
+    uc_i_submit_submitting: 'Guardando',
+    validation_fieldsOr: 'Al menos uno de estos campos debe estar completado: {{expected}}',
+    validation_format_ColorRGBA: 'Debe ser un color RGBA válido',
+    validation_format_DateISO8601: 'Debe ser una fecha válida con formato ISO8601',
+    validation_format_DirPath: 'Debe ser una ruta de directorio válida',
+    validation_format_DomainName: 'Debe ser un nombre de dominio válido',
+    validation_format_Email: 'Debe ser una dirección de correo válida',
+    validation_format_FilePath: 'Debe ser una ruta de archivo válida',
+    validation_format_GitSSHURL: 'Debe ser una URL SSH de Git válida',
+    validation_format_IPv4: 'Debe ser una dirección IPv4 válida',
+    validation_format_IPv6: 'Debe ser una dirección IPv6 válida',
+    validation_format_JSON: 'Debe ser una cadena JSON válida',
+    validation_format_JWT: 'Debe ser un JWT válido',
+    validation_format_PersonFirstname: 'Debe ser un nombre válido comenzando con mayúscula',
+    validation_format_PersonFullname: 'Debe ser un nombre completo válido comenzando con mayúscula',
+    validation_format_PersonInitials: 'Debe contener iniciales válidas compuestas por letras mayúsculas',
+    validation_format_PersonLastname: 'Debe ser un apellido válido comenzando con mayúscula',
+    validation_format_QRCode: 'Debe ser un código QR válido en formato base64',
+    validation_format_SemVerVersion: 'Debe ser una versión SemVer válida (X.X.X)',
+    validation_format_Slug: 'Debe contener solo letras minúsculas, dígitos y guiones (-)',
+    validation_format_SSHPrivateKey: 'Debe ser una clave privada SSH válida',
+    validation_format_SSHPublicKey: 'Debe ser una clave pública SSH válida',
+    validation_format_Time: 'Debe ser una hora válida',
+    validation_format_URL: 'Debe ser una URL válida',
+    validation_format_UUID: 'Debe ser un UUID válido',
+    validation_mandatory: 'Debe completarse',
+    validation_max: 'Debe ser menor o igual que {{expected}}',
+    validation_maxCount: 'Debe contener como máximo {{expected}} elemento(s)',
+    validation_maxLength: 'Debe contener como máximo {{expected}} carácter(es)',
+    validation_min: 'Debe ser mayor o igual que {{expected}}',
+    validation_minCount: 'Debe contener al menos {{expected}} elemento(s)',
+    validation_minLength: 'Debe contener al menos {{expected}} carácter(es)',
+    validation_oneOf: 'Debe ser uno de los elementos de la lista',
+    validation_shape: 'Debe respetar la estructura esperada del objeto',
+    validation_type_array: 'Debe ser un array',
+    validation_type_boolean: 'Debe ser un valor booleano',
+    validation_type_int: 'Debe ser un número entero',
+    validation_type_number: 'Debe ser un número',
+    validation_type_object: 'Debe ser un objeto',
+    validation_type_scalar: 'Debe ser un escalar',
+    validation_type_string: 'Debe ser una cadena',
+};

package/dist/esm/i18n/types.d.ts

@@ -1,6 +1,6 @@
 import type { ViolationI18nable, YesNo } from '../dt/index.js';
 import type { UCClientConfirmConfig, UCExecState, UCWording } from '../uc/index.js';
-export type I18nLanguageCode = 'en' | 'fr';
+export type I18nLanguageCode = 'de' | 'en' | 'es' | 'fr';
 /**
  * A translation value
  *
@@ -14,6 +14,7 @@ export type I18nSource = any;
 export type I18nSourceSafe = {
     I18n: I18n;
 };
+export type I18nEntry = Record<I18nTranslationKey, I18nTranslation>;
 export type I18n = {
-    [key in I18nLanguageCode]?: Record<I18nTranslationKey, I18nTranslation>;
+    [key in I18nLanguageCode]?: I18nEntry;
 };

package/dist/esm/index.babel.d.ts

@@ -0,0 +1 @@
+export { Plugin } from './utils/bundling/babel/plugin.js';

package/dist/esm/index.babel.js

@@ -0,0 +1 @@
+export { Plugin } from './utils/bundling/babel/plugin.js';

package/dist/esm/index.node-stricli-cli.d.ts

@@ -0,0 +1,2 @@
+export { NodeStricliCLIManager } from './target/node-stricli-cli/NodeStricliCLIManager.js';
+export { bindNodeCLI } from './utils/ioc/bindNodeCLI.js';

package/dist/esm/index.node-stricli-cli.js

@@ -0,0 +1,2 @@
+export { NodeStricliCLIManager } from './target/node-stricli-cli/NodeStricliCLIManager.js';
+export { bindNodeCLI } from './utils/ioc/bindNodeCLI.js';

package/dist/esm/index.vite.d.ts

@@ -1 +1 @@
-export { StripUCDLifecycleServerPlugin } from './utils/bundling/vite/StripUCDLifecycleServerPlugin.js';
+export { Plugin } from './utils/bundling/vite/plugin.js';

package/dist/esm/index.vite.js

@@ -1 +1 @@
-export { StripUCDLifecycleServerPlugin } from './utils/bundling/vite/StripUCDLifecycleServerPlugin.js';
+export { Plugin } from './utils/bundling/vite/plugin.js';

package/dist/esm/index.webpack.d.ts

@@ -0,0 +1 @@
+export { default } from './utils/bundling/webpack/loader.js';

package/dist/esm/index.webpack.js

@@ -0,0 +1 @@
+export { default } from './utils/bundling/webpack/loader.js';

package/dist/esm/std/I18nManager.d.ts

@@ -16,6 +16,18 @@ export interface I18nManager extends Initializable {
      * @param value
      */
     add<K extends I18nTranslationKey>(key: K, value: string): Promise<void>;
+    /**
+     * Get the list of available languages
+     */
+    availableLangs(): I18nLanguageCode[];
+    /**
+     * Change the current language
+     *
+     * It might not work for all the implementations, depending on how langs are managed.
+     *
+     * @param lang
+     */
+    changeLang(lang: I18nLanguageCode): Promise<void>;
     /**
      * Get the current lang code
      */

package/dist/esm/std/impl/NodeFSManager.js

@@ -110,7 +110,7 @@ let NodeFSManager = class NodeFSManager {
             case 'library':
                 return [];
             default:
-                ((_) => { })(source);
+                source;
                 return [];
         }
     }

package/dist/esm/std/impl/SimpleMapI18nManager.d.ts

@@ -1,18 +1,23 @@
-import { type I18n, type I18nLanguageCode, type I18nTranslationKey } from '../../i18n/index.js';
+import type { I18n, I18nLanguageCode, I18nTranslationKey } from '../../i18n/index.js';
 import type { I18nManager, I18nManagerTOpts } from '../I18nManager.js';
 import type { Logger } from '../Logger.js';
 export declare class SimpleMapI18nManager implements I18nManager {
     private i18n;
     private logger;
     private static PLACEHOLDERS_REGEX;
+    private langs;
     private entries;
+    private currentLang;
     constructor(i18n: I18n, logger: Logger);
     add<K extends I18nTranslationKey>(key: K, value: string): Promise<void>;
+    availableLangs(): I18nLanguageCode[];
+    changeLang(lang: I18nLanguageCode): Promise<void>;
     init(): Promise<void>;
     initSync(): void;
     l(): I18nLanguageCode;
     t<K extends I18nTranslationKey>(key: K, opts?: I18nManagerTOpts): string;
     private initCommon;
     tOrNull<K extends I18nTranslationKey>(key: K, _opts?: I18nManagerTOpts): string | null;
+    private current;
     private replacePlaceholders;
 }

package/dist/esm/std/impl/SimpleMapI18nManager.js

@@ -12,20 +12,34 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 var SimpleMapI18nManager_1;
 import { inject, injectable } from 'inversify';
-import { I18N_DEFAULT_LANG, } from '../../i18n/index.js';
 let SimpleMapI18nManager = class SimpleMapI18nManager {
     static { SimpleMapI18nManager_1 = this; }
     i18n;
     logger;
     static PLACEHOLDERS_REGEX = /{{([A-Z-a-z0-9]+)}}/g; // Note the 'g' so it can be used with `matchAll`
+    langs;
     entries;
+    currentLang;
     constructor(i18n, logger) {
         this.i18n = i18n;
         this.logger = logger;
+        this.langs = Object.keys(i18n);
+        if (this.langs.length === 0) {
+            throw new Error('I18n must define at least one lang');
+        }
         this.entries = new Map();
+        // biome-ignore lint/style/noNonNullAssertion: we want it
+        this.currentLang = this.langs[0];
     }
     async add(key, value) {
-        this.entries.set(key, value);
+        this.current().set(key, value);
+    }
+    availableLangs() {
+        return this.langs;
+    }
+    async changeLang(lang) {
+        this.currentLang = lang;
+        this.initCommon();
     }
     async init() {
         this.initCommon();
@@ -34,10 +48,10 @@ let SimpleMapI18nManager = class SimpleMapI18nManager {
         this.initCommon();
     }
     l() {
-        return I18N_DEFAULT_LANG;
+        return this.currentLang;
     }
     t(key, opts) {
-        const v = this.entries.get(key);
+        const v = this.current().get(key);
         if (v) {
             return this.replacePlaceholders(v, opts);
         }
@@ -47,17 +61,32 @@ let SimpleMapI18nManager = class SimpleMapI18nManager {
         return key; // Mimic the behavior of some common libraries like i18next
     }
     initCommon() {
-        const translations = this.i18n[this.l()];
-        this.logger.trace('Initializing I18nManager', { translations });
-        if (!translations) {
-            return;
-        }
-        for (const [k, v] of Object.entries(translations)) {
-            this.entries.set(k, v);
+        for (const lang of this.langs) {
+            const translations = this.i18n[lang];
+            this.logger.trace('Initializing I18nManager', {
+                lang,
+                translations,
+            });
+            if (!translations) {
+                return;
+            }
+            if (!this.entries.has(lang)) {
+                this.entries.set(lang, new Map());
+            }
+            for (const [k, v] of Object.entries(translations)) {
+                this.entries.get(lang)?.set(k, v);
+            }
         }
     }
     tOrNull(key, _opts) {
-        return this.entries.get(key) || null;
+        return this.current().get(key) || null;
+    }
+    current() {
+        const entry = this.entries.get(this.currentLang);
+        if (!entry) {
+            throw new Error(`I18nManager must contain an entry for lang : ${this.currentLang}`);
+        }
+        return entry;
     }
     replacePlaceholders(v, opts) {
         // DO NOT USE THIS IN PRODUCTION

package/dist/esm/target/lib/server/AuthenticationChecker.js

@@ -80,7 +80,7 @@ let AuthenticationChecker = class AuthenticationChecker {
                     }
                     break;
                 default:
-                    ((_) => { })(authType);
+                    authType;
             }
             uc.auth = output.auth;
             const { allowed } = await policy.exec({ uc });

package/dist/esm/target/lib/server/PublicApiKeyChecker.js

@@ -39,7 +39,7 @@ let PublicApiKeyChecker = class PublicApiKeyChecker {
                 }
                 break;
             default:
-                ((_) => { })(checkType);
+                checkType;
         }
         if (!allowed) {
             throw new UnauthorizedError();

package/dist/esm/target/lib/server/ServerRequestHandler.js

@@ -127,7 +127,7 @@ let ServerRequestHandler = class ServerRequestHandler {
                 uc.fill((await req.bodyFromQueryParams()));
                 break;
             default:
-                ((_) => { })(envelope);
+                envelope;
         }
     }
     async applySideEffects(res, ucd, output) {
@@ -154,7 +154,7 @@ let ServerRequestHandler = class ServerRequestHandler {
                     await this.applySetAuthSideEffect(res, item);
                     break;
                 default:
-                    ((_) => { })(type);
+                    (type);
             }
         }
         return { status: undefined };