intor 2.3.13 → 2.3.15

package/dist/express/src/adapters/express/middleware/create-intor.js

@@ -2,7 +2,6 @@ import { INTOR_HEADERS } from '../../../core/constants/headers.js';
 import '../../../core/error/intor-error.js';
 import { normalizeQuery } from '../../../core/utils/normalizers/normalize-query.js';
 import 'logry';
-import 'keyv';
 import { resolveInbound } from '../../../routing/inbound/resolve-inbound.js';
 import { getLocaleFromAcceptLanguage } from '../../../routing/locale/get-locale-from-accept-language.js';
 import 'node:path';
@@ -25,7 +24,7 @@ function createIntor(config, options) {
     return async function intorMiddleware(req, _res, next) {
         // locale from accept-language header
         const acceptLanguage = req.headers["accept-language"];
-        const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(config, acceptLanguage);
+        const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(acceptLanguage, config.supportedLocales);
         // ----------------------------------------------------------
         // Resolve inbound routing decision (pure computation)
         // ----------------------------------------------------------
@@ -44,19 +43,20 @@ function createIntor(config, options) {
         // --------------------------------------------------
         // Bind inbound routing context
         // --------------------------------------------------
-        const { t, hasKey } = (await getTranslator(config, {
+        const { hasKey, t, tRaw } = (await getTranslator(config, {
             locale,
             handlers: options?.handlers,
             plugins: options?.plugins,
-            readOptions: options?.readOptions,
+            readers: options?.readers,
             allowCacheWrite: true,
         }));
         req.intor = { locale, localeSource };
         // DX shortcuts (optional)
         req.locale = locale;
         req.localeSource = localeSource;
-        req.t = t;
         req.hasKey = hasKey;
+        req.t = t;
+        req.tRaw = tRaw;
         return next();
     };
 }

package/dist/express/src/core/messages/global-messages-pool.js

@@ -1,8 +1,14 @@
-import Keyv from 'keyv';
-
+/**
+ * Get the global messages pool.
+ *
+ * Lazily initialized to ensure:
+ * - Cross-module sharing
+ * - Dev / HMR safety
+ */
 function getGlobalMessagesPool() {
     if (!globalThis.__INTOR_MESSAGES_POOL__) {
-        globalThis.__INTOR_MESSAGES_POOL__ = new Keyv();
+        const pool = new Map();
+        globalThis.__INTOR_MESSAGES_POOL__ = pool;
     }
     return globalThis.__INTOR_MESSAGES_POOL__;
 }

package/dist/express/src/core/messages/load-remote-messages/load-remote-messages.js

@@ -1,5 +1,4 @@
 import { getLogger } from '../../logger/get-logger.js';
-import { normalizeCacheKey } from '../../utils/normalizers/normalize-cache-key.js';
 import { fetchLocaleMessages } from './fetch-locale-messages/fetch-locale-messages.js';
 
 /**
@@ -9,12 +8,11 @@ import { fetchLocaleMessages } from './fetch-locale-messages/fetch-locale-messag
  * It coordinates:
  *
  * - Locale resolution with fallbacks
- * - Cache read / write behavior
  * - Respecting abort signals across the entire async flow
  *
  * Network fetching and data validation are delegated to lower-level utilities.
  */
-const loadRemoteMessages = async ({ id, locale, fallbackLocales, namespaces, rootDir, url, headers, signal, pool, cacheOptions, allowCacheWrite = false, loggerOptions, }) => {
+const loadRemoteMessages = async ({ locale, fallbackLocales, namespaces, rootDir, url, headers, signal, loggerOptions, }) => {
     const baseLogger = getLogger(loggerOptions);
     const logger = baseLogger.child({ scope: "load-remote-messages" });
     // Abort early if the request has already been cancelled
@@ -25,31 +23,6 @@ const loadRemoteMessages = async ({ id, locale, fallbackLocales, namespaces, roo
     const start = performance.now();
     logger.debug("Loading remote messages.", { url });
     // ---------------------------------------------------------------------------
-    // Cache key resolution
-    // ---------------------------------------------------------------------------
-    const cacheKey = normalizeCacheKey([
-        id,
-        "loaderType:remote",
-        rootDir,
-        locale,
-        (fallbackLocales || []).toSorted().join(","),
-        (namespaces || []).toSorted().join(","),
-    ]);
-    // ---------------------------------------------------------------------------
-    // Cache read
-    // ---------------------------------------------------------------------------
-    if (cacheOptions.enabled && cacheKey) {
-        const cached = await pool?.get(cacheKey);
-        if (signal?.aborted) {
-            logger.debug("Remote message loading aborted after cache read.");
-            return;
-        }
-        if (cached) {
-            logger.debug("Messages cache hit.", { key: cacheKey });
-            return cached;
-        }
-    }
-    // ---------------------------------------------------------------------------
     // Resolve locale messages with ordered fallback strategy
     // ---------------------------------------------------------------------------
     const candidateLocales = [locale, ...(fallbackLocales || [])];
@@ -93,18 +66,6 @@ const loadRemoteMessages = async ({ id, locale, fallbackLocales, namespaces, roo
             });
         }
     }
-    // ---------------------------------------------------------------------------
-    // Cache write (explicitly permitted)
-    // ---------------------------------------------------------------------------
-    if (cacheOptions.enabled && allowCacheWrite) {
-        if (signal?.aborted) {
-            logger.debug("Remote message loading aborted before cache write.");
-            return;
-        }
-        if (cacheKey && messages) {
-            await pool?.set(cacheKey, messages, cacheOptions.ttl);
-        }
-    }
     // Final success log with resolved locale and timing
     if (messages) {
         logger.trace("Finished loading remote messages.", {

package/dist/express/src/core/messages/utils/is-valid-messages.js

@@ -3,15 +3,10 @@ function isPlainObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
- * Check if a value is a valid **Messages** object.
+ * Check if a value is a valid MessageObject.
  *
- * - Uses an iterative approach to avoid stack overflow with deeply nested objects.
- *
- * @example
- * ```ts
- * isValidMessages({ en: { hello: "Hello" } }) // true
- * isValidMessages({ en: { count: 5 } }) // false
- * ```
+ * - Supports all MessageValue variants (primitive, array, object).
+ * - Uses an iterative approach to avoid stack overflow.
  */
 function isValidMessages(value) {
     if (!isPlainObject(value))
@@ -19,16 +14,29 @@ function isValidMessages(value) {
     const stack = [value];
     while (stack.length > 0) {
         const current = stack.pop();
-        for (const v of Object.values(current)) {
-            if (typeof v === "string")
-                continue;
-            if (isPlainObject(v)) {
-                stack.push(v);
+        // primitives are always valid
+        if (current === null ||
+            typeof current === "string" ||
+            typeof current === "number" ||
+            typeof current === "boolean") {
+            continue;
+        }
+        // array → validate each item
+        if (Array.isArray(current)) {
+            for (const item of current) {
+                stack.push(item);
             }
-            else {
-                return false;
+            continue;
+        }
+        // object → validate each value
+        if (isPlainObject(current)) {
+            for (const v of Object.values(current)) {
+                stack.push(v);
             }
+            continue;
         }
+        // everything else is invalid
+        return false;
     }
     return true;
 }

package/dist/express/src/routing/inbound/resolve-inbound.js

@@ -1,6 +1,3 @@
-import '../../core/error/intor-error.js';
-import 'logry';
-import 'keyv';
 import { getLocaleFromPathname } from '../locale/get-locale-from-pathname.js';
 import { getLocaleFromHost } from '../locale/get-locale-from-host.js';
 import { getLocaleFromQuery } from '../locale/get-locale-from-query.js';
@@ -21,11 +18,13 @@ async function resolveInbound(config, rawPathname, hasRedirected, localeInputs)
     // ------------------------------------------------------
     // Resolve locale from inbound inputs
     // ------------------------------------------------------
-    const pathLocale = getLocaleFromPathname(config, rawPathname);
+    const pathLocale = getLocaleFromPathname(rawPathname, config);
     const { locale, localeSource } = resolveLocale(config, {
         path: { locale: pathLocale },
-        host: { locale: getLocaleFromHost(config, host) },
-        query: { locale: getLocaleFromQuery(config, query) },
+        host: { locale: getLocaleFromHost(host) },
+        query: {
+            locale: getLocaleFromQuery(query, config.routing.inbound.queryKey),
+        },
         cookie: { locale: cookie },
         detected: { locale: detected },
     });

package/dist/express/src/routing/inbound/resolve-locale/resolve-locale.js

@@ -1,23 +1,30 @@
+import '../../../core/error/intor-error.js';
+import { normalizeLocale } from '../../../core/utils/normalizers/normalize-locale.js';
+import 'logry';
+
 /**
- * Resolves the active locale from inbound routing configuration.
+ * Resolve the active locale from inbound routing configuration.
  *
- * The first matching locale from the configured sources is used,
- * with the detected locale as a guaranteed fallback.
+ * Iterates through configured locale sources and returns the first
+ * normalized, supported locale. Falls back to the detected locale
+ * or the default locale if none match.
  */
 function resolveLocale(config, context) {
     const { localeSources } = config.routing.inbound;
     for (const source of localeSources) {
         const locale = context[source]?.locale;
-        if (!locale)
+        const normalized = normalizeLocale(locale, config.supportedLocales);
+        if (!normalized)
             continue;
         return {
-            locale,
+            locale: normalized,
             localeSource: source,
         };
     }
     // Fallback: detected is always available
     return {
-        locale: context.detected.locale,
+        locale: normalizeLocale(context.detected.locale, config.supportedLocales) ||
+            config.defaultLocale,
         localeSource: "detected",
     };
 }

package/dist/express/src/routing/locale/get-locale-from-accept-language.js

@@ -1,30 +1,20 @@
-import '../../core/error/intor-error.js';
-import { normalizeLocale } from '../../core/utils/normalizers/normalize-locale.js';
-import 'logry';
-import 'keyv';
-
 /**
- * Resolve locale from the `Accept-Language` header.
- *
- * - Parses language priorities (`q` values) from the header.
- * - Selects the highest-priority language supported by the application.
- * - Normalizes the matched locale against `supportedLocales`.
+ * Get locale candidate from the `Accept-Language` header.
  *
- * If no supported locale can be resolved, `undefined` is returned.
+ * Parses language priorities and returns the highest-priority
+ * language present in `supportedLocales`, without normalization.
  *
  * @example
  * ```ts
  * getLocaleFromAcceptLanguage("en-US,en;q=0.8,zh-TW;q=0.9", ["en-US", "zh-TW"])
  * // => "en-US"
+ *
  * getLocaleFromAcceptLanguage("fr,ja;q=0.9", ["en", "zh-TW"])
  * // => undefined
  * ```
  */
-const getLocaleFromAcceptLanguage = (config, acceptLanguageHeader) => {
-    const { supportedLocales } = config;
-    if (!acceptLanguageHeader ||
-        !supportedLocales ||
-        supportedLocales.length === 0) {
+const getLocaleFromAcceptLanguage = (acceptLanguageHeader, supportedLocales) => {
+    if (!acceptLanguageHeader || supportedLocales.length === 0) {
         return;
     }
     const supportedLocalesSet = new Set(supportedLocales);
@@ -42,7 +32,7 @@ const getLocaleFromAcceptLanguage = (config, acceptLanguageHeader) => {
     const sortedByPriority = parsedLanguages.toSorted((a, b) => b.q - a.q);
     // 3. Pick the first language explicitly supported
     const preferred = sortedByPriority.find(({ lang }) => supportedLocalesSet.has(lang))?.lang;
-    return normalizeLocale(preferred, supportedLocales);
+    return preferred;
 };
 
 export { getLocaleFromAcceptLanguage };

package/dist/express/src/routing/locale/get-locale-from-host.js

@@ -1,34 +1,32 @@
-import '../../core/error/intor-error.js';
-import { normalizeLocale } from '../../core/utils/normalizers/normalize-locale.js';
-import 'logry';
-import 'keyv';
-
 /**
- * Extract locale from hostname.
+ * Get locale candidate from hostname.
  *
- * Only the left-most subdomain is considered as a locale candidate, if present.
+ * Returns the left-most hostname label, without validation or normalization.
  *
  * @example
  * ```ts
- * getLocaleFromHost(config, "en.example.com")
+ * getLocaleFromHost("en.example.com")
  * // => "en"
- * getLocaleFromHost(config, "example.com")
- * // => undefined
- * getLocaleFromHost(config, "api.jp.example.com")
+ *
+ * getLocaleFromHost("example.com")
+ * // => "example"
+ *
+ * getLocaleFromHost("api.jp.example.com")
+ * // => "api"
+ *
+ * getLocaleFromHost("localhost")
  * // => undefined
  * ```
  */
-function getLocaleFromHost(config, host) {
+function getLocaleFromHost(host) {
     if (!host)
         return;
-    const { supportedLocales } = config;
     // Remove port (e.g. localhost:3000)
     const hostname = host.split(":")[0];
     const parts = hostname.split(".");
     if (parts.length < 2)
         return;
-    const candidate = parts[0];
-    return normalizeLocale(candidate, supportedLocales);
+    return parts[0];
 }
 
 export { getLocaleFromHost };

package/dist/express/src/routing/locale/get-locale-from-pathname.js

@@ -1,22 +1,12 @@
 import '../../core/error/intor-error.js';
 import { normalizePathname } from '../../core/utils/normalizers/normalize-pathname.js';
 import 'logry';
-import 'keyv';
 
 /**
- * Extracts the locale from a pathname, if present.
+ * Get locale from pathname.
  *
- * - Normalizes the raw pathname.
- * - Strips the configured basePath.
- * - Inspects the first path segment to determine whether
- *   it matches a supported locale.
- *
- * If no locale segment is found, `undefined` is returned.
- *
- * Note:
- * - The pathname is treated as a canonical source.
- * - Only exact matches against `supportedLocales` are accepted.
- * - ___Locale normalization is intentionally not applied here.___
+ * Extracts the first pathname segment (after basePath) as a locale
+ * if it exactly matches one of the supported locales.
  *
  * @example
  * ```ts
@@ -32,7 +22,7 @@ import 'keyv';
  * // => "en"
  * ```
  */
-function getLocaleFromPathname(config, pathname) {
+function getLocaleFromPathname(pathname, config) {
     const { routing, supportedLocales } = config;
     const { basePath } = routing;
     // 1. Normalize pathname

package/dist/express/src/routing/locale/get-locale-from-query.js

@@ -1,36 +1,29 @@
-import '../../core/error/intor-error.js';
-import { normalizeLocale } from '../../core/utils/normalizers/normalize-locale.js';
-import 'logry';
-import 'keyv';
-
 /**
- * Extracts locale from URL query parameters.
- *
- * - Reads the configured locale query key.
- * - Normalizes the value against supported locales.
+ * Get locale candidate from URL query parameters.
  *
- * If no valid locale is found, `undefined` is returned.
+ * Extracts the value of the configured query key, without
+ * validation or normalization.
  *
  * @example
  * ```ts
- * getLocaleFromQuery(config, { locale: "en" })
+ * getLocaleFromQuery({ locale: "en" }, "locale")
  * // => "en"
- * getLocaleFromQuery(config, {})
+ *
+ * getLocaleFromQuery({}, "locale")
  * // => undefined
- * getLocaleFromQuery(config, { locale: ["zh-TW"] })
+ *
+ * getLocaleFromQuery({ locale: ["zh-TW"] }, "locale")
  * // => "zh-TW"
  * ```
  */
-function getLocaleFromQuery(config, query) {
+function getLocaleFromQuery(query, queryKey) {
     if (!query)
         return;
-    const { supportedLocales, routing } = config;
-    const { queryKey } = routing.inbound;
     const raw = query[queryKey];
     if (!raw)
         return;
     const value = Array.isArray(raw) ? raw[0] : raw;
-    return normalizeLocale(value, supportedLocales);
+    return value;
 }
 
 export { getLocaleFromQuery };

package/dist/express/src/routing/pathname/get-unprefixed-pathname.js

@@ -1,7 +1,6 @@
 import '../../core/error/intor-error.js';
 import { normalizePathname } from '../../core/utils/normalizers/normalize-pathname.js';
 import 'logry';
-import 'keyv';
 
 /**
  * Returns a canonical, locale-agnostic pathname.

package/dist/express/src/routing/pathname/locale-prefix-pathname.js

@@ -2,7 +2,6 @@ import { PREFIX_PLACEHOLDER } from '../../core/constants/prefix-placeholder.js';
 import '../../core/error/intor-error.js';
 import { normalizePathname } from '../../core/utils/normalizers/normalize-pathname.js';
 import 'logry';
-import 'keyv';
 
 /**
  * Applies the configured locale prefix behavior to a standardized pathname.

package/dist/express/src/routing/pathname/standardize-pathname.js

@@ -2,7 +2,6 @@ import { PREFIX_PLACEHOLDER } from '../../core/constants/prefix-placeholder.js';
 import '../../core/error/intor-error.js';
 import { normalizePathname } from '../../core/utils/normalizers/normalize-pathname.js';
 import 'logry';
-import 'keyv';
 
 /**
  * Standardizes a canonical pathname by applying the base path

package/dist/express/src/server/helpers/get-translator.js

@@ -2,11 +2,11 @@ import { createIntorRuntime } from '../runtime/create-intor-runtime.js';
 
 // Implementation
 async function getTranslator(config, params) {
-    const { readOptions, allowCacheWrite, preKey, handlers, plugins } = params;
+    const { readers, allowCacheWrite, preKey, handlers, plugins } = params;
     const locale = params.locale;
     // Create runtime (request-scoped, no cache write)
     const runtime = createIntorRuntime(config, {
-        readOptions,
+        readers,
         allowCacheWrite,
     });
     // Ensure messages & create translator snapshot
@@ -21,6 +21,7 @@ async function getTranslator(config, params) {
         locale,
         hasKey: translator.hasKey,
         t: translator.t,
+        tRaw: translator.tRaw,
     };
 }
 

package/dist/express/src/server/messages/load-local-messages/load-local-messages.js

@@ -13,16 +13,15 @@ import { readLocaleMessages } from './read-locale-messages/read-locale-messages.
  * It coordinates:
  *
  * - Locale resolution with fallbacks
- * - Process-level memoization (read by default, write by ownership)
  * - Concurrency control for file system access
+ * - Process-level memoization (read by default, write by ownership)
  *
  * Local messages are cached for the lifetime of the process.
  * Cache writes are restricted to the primary initialization flow.
  *
  * File traversal, parsing, and validation are delegated to lower-level utilities.
  */
-const loadLocalMessages = async ({ id, locale, fallbackLocales, namespaces, rootDir = "messages", concurrency = 10, readOptions, pool = getGlobalMessagesPool(), allowCacheWrite = false, loggerOptions, }) => {
-    const isProd = process.env.NODE_ENV === "production";
+const loadLocalMessages = async ({ id, locale, fallbackLocales, namespaces, rootDir = "messages", concurrency = 10, readers, pool = getGlobalMessagesPool(), allowCacheWrite = false, loggerOptions, }) => {
     const baseLogger = getLogger(loggerOptions);
     const logger = baseLogger.child({ scope: "load-local-messages" });
     const start = performance.now();
@@ -38,14 +37,14 @@ const loadLocalMessages = async ({ id, locale, fallbackLocales, namespaces, root
         "loaderType:local",
         rootDir,
         locale,
-        (fallbackLocales || []).toSorted().join(","),
-        (namespaces || []).toSorted().join(","),
-    ]);
+        fallbackLocales?.toSorted().join(","),
+        namespaces?.toSorted().join(","),
+    ].filter(Boolean));
     // ---------------------------------------------------------------------------
     // Cache read
     // ---------------------------------------------------------------------------
     if (cacheKey) {
-        const cached = await pool?.get(cacheKey);
+        const cached = pool.get(cacheKey);
         if (cached) {
             logger.debug("Messages cache hit.", { key: cacheKey });
             return cached;
@@ -66,7 +65,7 @@ const loadLocalMessages = async ({ id, locale, fallbackLocales, namespaces, root
                 namespaces,
                 rootDir,
                 limit,
-                readOptions,
+                readers,
                 loggerOptions,
             });
             // Stop at the first locale that yields non-empty messages
@@ -90,10 +89,10 @@ const loadLocalMessages = async ({ id, locale, fallbackLocales, namespaces, root
     // ---------------------------------------------------------------------------
     // Cache write (explicitly permitted)
     // ---------------------------------------------------------------------------
-    if (allowCacheWrite && isProd) {
-        if (cacheKey && messages) {
-            await pool?.set(cacheKey, messages);
-        }
+    const isProd = process.env.NODE_ENV === "production";
+    const canWriteCache = isProd && allowCacheWrite;
+    if (canWriteCache && cacheKey && messages) {
+        pool.set(cacheKey, messages);
     }
     // Final success log with resolved locale and timing
     if (messages) {

package/dist/express/src/server/messages/load-local-messages/read-locale-messages/collect-file-entries/collect-file-entries.js

@@ -2,7 +2,6 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import '../../../../../core/error/intor-error.js';
 import { getLogger } from '../../../../../core/logger/get-logger.js';
-import 'keyv';
 
 /**
  * Recursively collects message file metadata under a given locale root.
@@ -21,9 +20,10 @@ import 'keyv';
  * }, ... ];
  * ```
  */
-async function collectFileEntries({ readdir = fs.readdir, namespaces, rootDir, limit, exts = [".json"], loggerOptions, }) {
+async function collectFileEntries({ readdir = fs.readdir, namespaces, rootDir, limit, exts = ["json"], loggerOptions, }) {
     const baseLogger = getLogger(loggerOptions);
     const logger = baseLogger.child({ scope: "collect-file-entries" });
+    const supportedExts = new Set(["json", ...exts]);
     const fileEntries = [];
     // Recursive directory walk
     const walk = async (currentDir) => {
@@ -51,14 +51,14 @@ async function collectFileEntries({ readdir = fs.readdir, namespaces, rootDir, l
                 return;
             }
             // Skip unsupported file extensions
-            if (!exts.some((ext) => entry.name.endsWith(ext)))
+            const ext = path.extname(entry.name).slice(1); // "json", "yaml"
+            if (!ext || !supportedExts.has(ext))
                 return;
             // ---------------------------------------------------------------------
             // Resolve file entry
             // ---------------------------------------------------------------------
             const relativePath = path.relative(rootDir, fullPath);
-            const ext = path.extname(relativePath);
-            const withoutExt = relativePath.slice(0, -ext.length);
+            const withoutExt = relativePath.slice(0, relativePath.length - (ext.length + 1));
             const segments = withoutExt.split(path.sep).filter(Boolean);
             const namespace = segments.at(0);
             if (!namespace)
@@ -73,7 +73,7 @@ async function collectFileEntries({ readdir = fs.readdir, namespaces, rootDir, l
                 fullPath,
                 relativePath,
                 segments,
-                basename: path.basename(entry.name, ext),
+                basename: path.basename(entry.name, `.${ext}`),
             });
         }));
         await Promise.all(tasks);

package/dist/express/src/server/messages/load-local-messages/read-locale-messages/parse-file-entries/parse-file-entries.js

@@ -3,7 +3,6 @@ import '../../../../../core/error/intor-error.js';
 import { deepMerge } from '../../../../../core/utils/deep-merge.js';
 import { getLogger } from '../../../../../core/logger/get-logger.js';
 import { isValidMessages } from '../../../../../core/messages/utils/is-valid-messages.js';
-import 'keyv';
 import { jsonReader } from './utils/json-reader.js';
 import { nestObjectFromPath } from './utils/nest-object-from-path.js';
 
@@ -36,7 +35,7 @@ import { nestObjectFromPath } from './utils/nest-object-from-path.js';
  * }
  * ```
  */
-async function parseFileEntries({ fileEntries, limit, messagesReader, loggerOptions, }) {
+async function parseFileEntries({ fileEntries, limit, readers, loggerOptions, }) {
     const baseLogger = getLogger(loggerOptions);
     const logger = baseLogger.child({ scope: "parse-file-entries" });
     // Read and parse all file entries
@@ -46,10 +45,19 @@ async function parseFileEntries({ fileEntries, limit, messagesReader, loggerOpti
             // -------------------------------------------------------------------
             // Read and validate file content
             // -------------------------------------------------------------------
-            const ext = path.extname(fullPath);
-            const raw = ext !== ".json" && messagesReader
-                ? await messagesReader(fullPath)
-                : await jsonReader(fullPath);
+            const ext = path.extname(fullPath).slice(1); // remove dot
+            let raw;
+            if (ext === "json") {
+                raw = await jsonReader(fullPath);
+            }
+            else {
+                const reader = readers?.[ext];
+                if (!reader) {
+                    throw new Error(`No message reader registered for .${ext} files. ` +
+                        `Please register a reader for the "${ext}" extension.`);
+                }
+                raw = await reader(fullPath);
+            }
             // Validate messages structure
             if (!isValidMessages(raw)) {
                 throw new Error("Parsed content does not match expected Messages structure");

package/dist/express/src/server/messages/load-local-messages/read-locale-messages/read-locale-messages.js

@@ -12,7 +12,7 @@ import { parseFileEntries } from './parse-file-entries/parse-file-entries.js';
  *
  * It does not perform validation or transformation itself.
  */
-const readLocaleMessages = async ({ locale, namespaces, rootDir = "messages", limit, readOptions: { exts, messagesReader } = {}, loggerOptions, }) => {
+const readLocaleMessages = async ({ locale, namespaces, rootDir = "messages", limit, readers, loggerOptions, }) => {
     // ---------------------------------------------------------------------------
     // Collect message file entries for the locale
     // ---------------------------------------------------------------------------
@@ -20,7 +20,7 @@ const readLocaleMessages = async ({ locale, namespaces, rootDir = "messages", li
         namespaces,
         rootDir: path.resolve(rootDir, locale),
         limit,
-        exts,
+        exts: Object.keys(readers || {}),
         loggerOptions,
     });
     // ---------------------------------------------------------------------------
@@ -29,7 +29,7 @@ const readLocaleMessages = async ({ locale, namespaces, rootDir = "messages", li
     const messages = await parseFileEntries({
         fileEntries,
         limit,
-        messagesReader,
+        readers,
         loggerOptions,
     });
     // ---------------------------------------------------------------------------