intor 2.4.17 → 2.5.0

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

@@ -1,42 +0,0 @@
-import path from 'node:path';
-import { collectFileEntries } from './collect-file-entries/collect-file-entries.js';
-import { parseFileEntries } from './parse-file-entries/parse-file-entries.js';
-
-/**
- * Read and assemble messages for a single locale from the file system.
- *
- * This function acts as a thin orchestration layer:
- * - Collects message file metadata for the locale
- * - Parses files into a single Messages object
- * - Wraps the result under the locale key
- *
- * It does not perform validation or transformation itself.
- */
-const readLocaleMessages = async ({ locale, namespaces, rootDir = "messages", limit, readers, loggerOptions, }) => {
-    // ---------------------------------------------------------------------------
-    // Collect message file entries for the locale
-    // ---------------------------------------------------------------------------
-    const fileEntries = await collectFileEntries({
-        namespaces,
-        rootDir: path.resolve(rootDir, locale),
-        limit,
-        exts: Object.keys(readers || {}),
-        loggerOptions,
-    });
-    // ---------------------------------------------------------------------------
-    // Parse collected files into a Messages object (single-locale)
-    // ---------------------------------------------------------------------------
-    const messages = await parseFileEntries({
-        fileEntries,
-        limit,
-        readers,
-        loggerOptions,
-    });
-    // ---------------------------------------------------------------------------
-    // Wrap parsed messages under the locale key
-    // ---------------------------------------------------------------------------
-    const localeMessages = { [locale]: messages };
-    return localeMessages;
-};
-
-export { readLocaleMessages };

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

@@ -1,78 +0,0 @@
-import '../../core/error/intor-error.js';
-import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
-import { getLogger } from '../../core/logger/get-logger.js';
-import { loadRemoteMessages } from '../../core/messages/load-remote-messages/load-remote-messages.js';
-import 'intor-translator';
-import { loadLocalMessages } from './load-local-messages/load-local-messages.js';
-
-/**
- * Load locale messages according to the resolved Intor loader configuration.
- *
- * This function is the top-level orchestration entry for message loading.
- * It is responsible for:
- *
- * - Resolving the active loader strategy (local or remote)
- * - Dispatching to the appropriate loader implementation
- * - Passing through cache and read-related options
- *
- * Message traversal, parsing, fallback resolution, and caching logic
- * are delegated to the selected loader.
- */
-const loadMessages = async ({ config, locale, readers, allowCacheWrite = false, fetch, }) => {
-    const baseLogger = getLogger(config.logger);
-    const logger = baseLogger.child({ scope: "load-messages" });
-    // ---------------------------------------------------------------------------
-    // Resolve loader configuration
-    // ---------------------------------------------------------------------------
-    const loader = resolveLoaderOptions(config);
-    if (!loader) {
-        logger.warn("No loader options have been configured in the current config.");
-        return;
-    }
-    const { mode, namespaces, concurrency } = loader;
-    const fallbackLocales = config.fallbackLocales[locale] || [];
-    logger.info(`Loading messages for locale "${locale}".`);
-    logger.trace("Starting to load messages with runtime context.", {
-        loaderMode: mode,
-        ...(mode === "local" ? { rootDir: loader.rootDir } : {}),
-        locale,
-        fallbackLocales: fallbackLocales.join(", "),
-        namespaces: namespaces && namespaces.length > 0 ? [...namespaces] : "*",
-    });
-    // ---------------------------------------------------------------------------
-    // Dispatch to loader implementation
-    // ---------------------------------------------------------------------------
-    let loadedMessages;
-    if (mode === "local") {
-        loadedMessages = await loadLocalMessages({
-            id: config.id,
-            locale,
-            fallbackLocales,
-            namespaces,
-            rootDir: loader.rootDir,
-            concurrency,
-            readers,
-            allowCacheWrite,
-            loggerOptions: config.logger,
-        });
-    }
-    else if (mode === "remote") {
-        loadedMessages = await loadRemoteMessages({
-            locale,
-            fallbackLocales,
-            namespaces,
-            concurrency,
-            fetch,
-            url: loader.url,
-            headers: loader.headers,
-            loggerOptions: config.logger,
-        });
-    }
-    // Final sanity check
-    if (!loadedMessages || Object.keys(loadedMessages).length === 0) {
-        logger.warn("No messages found.", { locale, fallbackLocales, namespaces });
-    }
-    return loadedMessages;
-};
-
-export { loadMessages };

package/dist/express/src/server/translator/init-translator.js

@@ -1,39 +0,0 @@
-import '../../core/error/intor-error.js';
-import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
-import 'logry';
-import 'p-limit';
-import { createTranslator } from '../../core/translator/create-translator.js';
-import 'intor-translator';
-import { loadMessages } from '../messages/load-messages.js';
-import 'node:path';
-import 'node:fs/promises';
-
-/**
- * Initialize a locale-bound Translator snapshot.
- *
- * - Resolves loader options and loads messages if configured
- * - Creates an immutable Translator instance for server usage
- */
-async function initTranslator(config, locale, options) {
-    const { loader, readers, allowCacheWrite = false, fetch, handlers, plugins, } = options;
-    const loaderOptions = resolveLoaderOptions(config);
-    // Load messages
-    let messages = {};
-    if (loaderOptions && !loader) {
-        const loaded = await loadMessages({
-            config,
-            locale,
-            readers,
-            allowCacheWrite,
-            fetch,
-        });
-        messages = loaded || {};
-    }
-    if (loader) {
-        messages = await loader(config, locale);
-    }
-    // Create immutable translator snapshot
-    return createTranslator({ config, locale, messages, handlers, plugins });
-}
-
-export { initTranslator };

package/dist/fastify/src/core/error/intor-error.js

@@ -1,9 +0,0 @@
-var IntorErrorCode;
-(function (IntorErrorCode) {
-    // config
-    IntorErrorCode["INVALID_CONFIG_ID"] = "INTOR_INVALID_CONFIG_ID";
-    IntorErrorCode["MISSING_SUPPORTED_LOCALES"] = "INTOR_MISSING_SUPPORTED_LOCALES";
-    IntorErrorCode["UNSUPPORTED_DEFAULT_LOCALE"] = "INTOR_UNSUPPORTED_DEFAULT_LOCALE";
-})(IntorErrorCode || (IntorErrorCode = {}));
-
-export { IntorErrorCode };

package/dist/fastify/src/core/logger/get-logger.js

@@ -1,39 +0,0 @@
-import { logry } from 'logry';
-import { getGlobalLoggerPool } from './global-logger-pool.js';
-
-const DEFAULT_FORMAT_CONFIG = {
-    timestamp: { withDate: false },
-};
-const DEFAULT_RENDER_CONFIG = {
-    timestamp: {},
-    id: { visible: true, prefix: "<", suffix: ">" },
-    meta: { lineBreaksAfter: 1 },
-};
-/**
- * Get a shared logger instance by id.
- * - Safe across hot reloads
- * - Prevents unbounded memory usage via soft LRU
- */
-function getLogger({ id = "default", formatConfig, renderConfig, preset, ...options }) {
-    const pool = getGlobalLoggerPool();
-    let logger = pool.get(id);
-    if (!logger) {
-        logger = logry({
-            id,
-            formatConfig: !formatConfig && !preset ? DEFAULT_FORMAT_CONFIG : formatConfig,
-            renderConfig: !renderConfig && !preset ? DEFAULT_RENDER_CONFIG : renderConfig,
-            preset,
-            ...options,
-        });
-        pool.set(id, logger);
-        // Soft LRU: keep pool size under control
-        if (pool.size > 1000) {
-            const keys = [...pool.keys()];
-            for (const key of keys.slice(0, 200))
-                pool.delete(key);
-        }
-    }
-    return logger;
-}
-
-export { getLogger };

package/dist/fastify/src/core/logger/global-logger-pool.js

@@ -1,8 +0,0 @@
-function getGlobalLoggerPool() {
-    if (!globalThis.__INTOR_LOGGER_POOL__) {
-        globalThis.__INTOR_LOGGER_POOL__ = new Map();
-    }
-    return globalThis.__INTOR_LOGGER_POOL__;
-}
-
-export { getGlobalLoggerPool };

package/dist/fastify/src/core/messages/load-remote-messages/collect-remote-resources.js

@@ -1,25 +0,0 @@
-/**
- * Collect remote message resources for a given locale.
- *
- * - Always includes the root `index.json`
- * - Optionally includes namespace-specific resources
- * - Produces semantic paths for later message nesting
- *
- * This function performs no I/O and does not validate resource existence.
- */
-function collectRemoteResources({ locale, baseUrl, namespaces, }) {
-    const basePath = `${baseUrl}/${locale}`;
-    // Root translation resource (always loaded)
-    const indexResource = { url: `${basePath}/index.json`, path: [] };
-    // When no namespaces are provided, the locale domain consists of index only
-    if (!namespaces || namespaces.length === 0)
-        return [indexResource];
-    // Namespace-specific resources are nested under their namespace key
-    const nsResources = namespaces.map((ns) => ({
-        url: `${basePath}/${ns}.json`,
-        path: [ns],
-    }));
-    return [indexResource, ...nsResources];
-}
-
-export { collectRemoteResources };

package/dist/fastify/src/core/messages/load-remote-messages/fetch-remote-resource.js

@@ -1,47 +0,0 @@
-import { getLogger } from '../../logger/get-logger.js';
-import { isValidMessages } from '../utils/is-valid-messages.js';
-
-/**
- * Fetch a single remote messages resource.
- *
- * This function performs a single HTTP request to retrieve
- * a remote translation messages payload.
- *
- * It is responsible for:
- * - Issuing the network request
- * - Validating the returned message structure
- * - Handling abort and network errors
- */
-async function fetchRemoteResource({ fetch, url, headers, signal, loggerOptions, }) {
-    const baseLogger = getLogger(loggerOptions);
-    const logger = baseLogger.child({ scope: "fetch-locale-messages" });
-    try {
-        // Fetch
-        const response = await fetch(url, {
-            method: "GET",
-            headers: { "Content-Type": "application/json", ...headers },
-            cache: "no-store",
-            signal,
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status} ${response.statusText}`);
-        }
-        // Parse JSON body
-        const data = await response.json();
-        // Validate messages structure
-        if (!isValidMessages(data)) {
-            throw new Error("Invalid messages structure");
-        }
-        return data;
-    }
-    catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-            logger.debug("Remote fetch aborted.", { url });
-            return;
-        }
-        logger.warn("Failed to fetch remote messages.", { url, error });
-        return;
-    }
-}
-
-export { fetchRemoteResource };

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

@@ -1,93 +0,0 @@
-import pLimit from 'p-limit';
-import { getLogger } from '../../logger/get-logger.js';
-import { collectRemoteResources } from './collect-remote-resources.js';
-import { fetchRemoteResource } from './fetch-remote-resource.js';
-import { resolveRemoteResources } from './resolve-remote-resources.js';
-
-/**
- * Load locale messages from a remote source.
- *
- * This function serves as the orchestration layer for remote message loading.
- * It coordinates:
- *
- * - Locale resolution with fallbacks
- * - Concurrency control for network requests
- * - Remote resource fetching and message merging
- *
- * Remote messages are fetched on demand and are not memoized at the process level.
- *
- * Network requests and response validation are delegated to lower-level utilities.
- */
-const loadRemoteMessages = async ({ locale, fallbackLocales, namespaces, concurrency, fetch, url: baseUrl, headers, signal, loggerOptions, }) => {
-    const baseLogger = getLogger(loggerOptions);
-    const logger = baseLogger.child({ scope: "load-remote-messages" });
-    // Abort early if the request has already been cancelled
-    if (signal?.aborted) {
-        logger.debug("Remote message loading aborted before fetch.");
-        return;
-    }
-    const start = performance.now();
-    logger.debug("Loading remote messages.", { baseUrl });
-    // ----------------------------------------------------------------
-    // Resolve locale messages with ordered fallback strategy
-    // ----------------------------------------------------------------
-    const limit = concurrency ? pLimit(concurrency) : undefined;
-    const candidateLocales = [locale, ...(fallbackLocales || [])];
-    let messages;
-    for (let i = 0; i < candidateLocales.length; i++) {
-        const candidateLocale = candidateLocales[i];
-        const isLast = i === candidateLocales.length - 1;
-        try {
-            // -----------------------------------------------------------------
-            // Collect remote message resources for the locale
-            // -----------------------------------------------------------------
-            const resources = collectRemoteResources({
-                locale: candidateLocale,
-                baseUrl,
-                namespaces,
-            });
-            // -----------------------------------------------------------------
-            // Fetch all message chunks in parallel
-            // -----------------------------------------------------------------
-            const fetchUrl = (url) => fetchRemoteResource({ url, headers, signal, loggerOptions, fetch });
-            const results = await Promise.all(resources.map(({ url }) => limit ? limit(() => fetchUrl(url)) : fetchUrl(url)));
-            // Guard: no valid remote resources
-            if (!results.some(Boolean))
-                continue;
-            // -----------------------------------------------------------------
-            // Resolve and merge remote message resources
-            // -----------------------------------------------------------------
-            const resolved = resolveRemoteResources(resources.map((res, i) => ({ path: res.path, data: results[i] })));
-            // -----------------------------------------------------------------
-            // Wrap resolved messages into locale-scoped LocaleMessages
-            // -----------------------------------------------------------------
-            messages = { [candidateLocale]: resolved };
-            break;
-        }
-        catch {
-            if (signal?.aborted) {
-                logger.debug("Remote message loading aborted.");
-                return;
-            }
-            if (isLast) {
-                logger.warn("Failed to load messages for all candidate locales.", {
-                    locale,
-                    fallbackLocales,
-                });
-            }
-            else {
-                logger.warn(`Failed to load locale messages for "${candidateLocale}", trying next fallback.`);
-            }
-        }
-    }
-    // Final success log with resolved locale and timing
-    if (messages) {
-        logger.trace("Finished loading remote messages.", {
-            loadedLocale: Object.keys(messages)[0],
-            duration: `${Math.round(performance.now() - start)} ms`,
-        });
-    }
-    return messages;
-};
-
-export { loadRemoteMessages };

package/dist/fastify/src/core/messages/load-remote-messages/resolve-remote-resources.js

@@ -1,24 +0,0 @@
-import { deepMerge } from '../../utils/deep-merge.js';
-import { nestObjectFromPath } from '../utils/nest-object-from-path.js';
-
-/**
- * Resolve remote message resources into a single MessageObject.
- *
- * - Applies semantic nesting based on resource path
- * - Merges all resolved message chunks
- *
- * Always returns a MessageObject.
- * An empty object represents an empty translation domain.
- */
-function resolveRemoteResources(resources) {
-    let result = {};
-    for (const { path, data } of resources) {
-        if (!data)
-            continue;
-        const resolved = path.length > 0 ? nestObjectFromPath(path, data) : data;
-        result = deepMerge(result, resolved);
-    }
-    return result;
-}
-
-export { resolveRemoteResources };

package/dist/fastify/src/core/messages/merge-messages.js

@@ -1,33 +0,0 @@
-import { getLogger } from '../logger/get-logger.js';
-import { deepMerge } from '../utils/deep-merge.js';
-
-/**
- * Merge locale-specific messages with runtime overrides.
- *
- * - Only merges messages under the given locale
- * - Emits debug logs for add / override events
- */
-function mergeMessages(a, b, { config, locale, onEvent }) {
-    const baseLogger = getLogger({ ...config.logger, id: config.id });
-    const logger = baseLogger.child({ scope: "merge-messages" });
-    // Merge messages for the active locale only
-    const merged = deepMerge(a?.[locale] ?? {}, b?.[locale] ?? {}, {
-        onOverride: (event) => {
-            if (onEvent) {
-                onEvent(event);
-                return;
-            }
-            const { kind, path, next, prev } = event;
-            if (kind === "add")
-                return;
-            logger.debug(`Override | ${locale}: "${path}"`, { prev, next });
-        },
-    });
-    // Preserve other locales, update only the target one
-    return {
-        ...a,
-        [locale]: merged,
-    };
-}
-
-export { mergeMessages };

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

@@ -1,44 +0,0 @@
-/** Check if a value is a plain object (not null, not array) */
-function isPlainObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Check if a value is a valid MessageObject.
- *
- * - Supports all MessageValue variants (primitive, array, object).
- * - Uses an iterative approach to avoid stack overflow.
- */
-function isValidMessages(value) {
-    if (!isPlainObject(value))
-        return false;
-    const stack = [value];
-    while (stack.length > 0) {
-        const current = stack.pop();
-        // 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);
-            }
-            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;
-}
-
-export { isPlainObject, isValidMessages };

package/dist/fastify/src/core/messages/utils/nest-object-from-path.js

@@ -1,21 +0,0 @@
-/**
- * Wraps a value inside nested objects according to a given path.
- *
- * @example
- * ```ts
- * const value = { a: "A" };
- *
- * nestObjectFromPath(["auth", "verify"], value); // → { auth: { verify: { a: "A" } } }
- *
- * nestObjectFromPath([], value); // →  { a: "A" }
- * ```
- */
-function nestObjectFromPath(path, value) {
-    let obj = value;
-    for (let i = path.length - 1; i >= 0; i--) {
-        obj = { [path[i]]: obj };
-    }
-    return obj;
-}
-
-export { nestObjectFromPath };

package/dist/fastify/src/core/render/create-html-renderer.js

@@ -1,44 +0,0 @@
-import { escapeHtml } from './utils/escape-html.js';
-import { renderAttributes } from './utils/render-attributes.js';
-
-/**
- * Create an HTML string renderer for semantic rich messages.
- *
- * - Transforms semantic rich AST nodes into escaped HTML strings.
- * - Can be used in any HTML-based environment.
- *
- * This renderer is intentionally minimal and stateless.
- */
-const createHtmlRenderer = (tagRenderers) => {
-    return {
-        /** Render plain text nodes */
-        text(value) {
-            return escapeHtml(value);
-        },
-        /** Render semantic tag nodes */
-        tag(name, attributes, children) {
-            const tagRenderer = tagRenderers?.[name];
-            if (tagRenderer) {
-                return typeof tagRenderer === "function"
-                    ? tagRenderer(children)
-                    : tagRenderer;
-            }
-            // Default behavior: render as native HTML tag
-            return `<${name}${renderAttributes(attributes)}>${children.join("")}</${name}>`;
-        },
-        /** Render raw (non-tokenized) message values as escaped HTML strings */
-        raw(value) {
-            if (value == null)
-                return "";
-            if (typeof value === "string" || typeof value === "number") {
-                return escapeHtml(String(value));
-            }
-            if (Array.isArray(value)) {
-                return value.map((v) => escapeHtml(String(v))).join("");
-            }
-            throw new Error("[intor] HTML renderer cannot render raw non-primitive values.");
-        },
-    };
-};
-
-export { createHtmlRenderer };

package/dist/fastify/src/core/render/utils/escape-html.js

@@ -1,10 +0,0 @@
-function escapeHtml(value) {
-    return value
-        .replaceAll("&", "&")
-        .replaceAll("<", "&lt;")
-        .replaceAll(">", "&gt;")
-        .replaceAll('"', "&quot;")
-        .replaceAll("'", "&#39;");
-}
-
-export { escapeHtml };

package/dist/fastify/src/core/render/utils/render-attributes.js

@@ -1,17 +0,0 @@
-import { escapeHtml } from './escape-html.js';
-
-function renderAttributes(attributes) {
-    if (!attributes)
-        return "";
-    return Object.entries(attributes)
-        .map(([key, value]) => {
-        if (value === true)
-            return ` ${key}`;
-        if (value == null)
-            return "";
-        return ` ${key}="${escapeHtml(String(value))}"`;
-    })
-        .join("");
-}
-
-export { renderAttributes };

package/dist/fastify/src/core/translator/create-t-rich.js

@@ -1,22 +0,0 @@
-import { renderRichMessage } from 'intor-translator';
-import { createHtmlRenderer } from '../render/create-html-renderer.js';
-
-/**
- * Create an HTML-string rich translation function.
- *
- * - Resolves translated messages via `translator.t`
- * - Renders semantic rich tags into escaped HTML strings
- * - Supports optional scoped keys via `preKey`
- *
- * Can be used in any HTML-based environment (Astro, Svelte, SSR, etc.).
- */
-const createTRich = (t) => {
-    return (key, tagRenderers, replacements) => {
-        const message = t(key, replacements);
-        const renderer = createHtmlRenderer(tagRenderers);
-        const nodes = renderRichMessage(message, renderer);
-        return nodes.join("");
-    };
-};
-
-export { createTRich };

package/dist/fastify/src/core/translator/create-translator.js

@@ -1,30 +0,0 @@
-import { Translator } from 'intor-translator';
-import { mergeMessages } from '../messages/merge-messages.js';
-
-/**
- * Create a server-side Translator instance for a fixed locale.
- *
- * - Merges static config messages with runtime-loaded messages
- * - Initializes a Translator bound to a specific locale
- * - Injects fallback rules, handlers, and plugins from config
- */
-function createTranslator(params) {
-    const { config, locale, messages, handlers, plugins } = params;
-    // Merge static config messages with runtime-loaded messages
-    const finalMessages = mergeMessages(config.messages, messages, {
-        config,
-        locale,
-    });
-    const translator = new Translator({
-        locale,
-        messages: finalMessages,
-        fallbackLocales: config.fallbackLocales,
-        loadingMessage: config.translator?.loadingMessage,
-        missingMessage: config.translator?.missingMessage,
-        handlers,
-        plugins,
-    });
-    return translator;
-}
-
-export { createTranslator };