intor 2.3.27 → 2.3.29

package/dist/core/src/core/messages/load-remote-messages/fetch-locale-messages/utils/build-search-params.js

@@ -1,25 +0,0 @@
-/**
- * Build URLSearchParams from an object.
- * Supports string or string[] values. Ignores undefined/null.
- */
-const buildSearchParams = (params) => {
-    const searchParams = new URLSearchParams();
-    const appendParam = (key, value) => {
-        if (value === undefined || value === null)
-            return;
-        if (Array.isArray(value) && value.length === 0)
-            return;
-        if (Array.isArray(value)) {
-            value.forEach((v) => v && searchParams.append(key, v));
-        }
-        else {
-            searchParams.append(key, value);
-        }
-    };
-    Object.entries(params).forEach(([key, value]) => {
-        appendParam(key, value);
-    });
-    return searchParams;
-};
-
-export { buildSearchParams };

package/dist/core/src/server/helpers/local-messages-from-url.js

@@ -1,53 +0,0 @@
-import { loadLocalMessages } from '../messages/load-local-messages/load-local-messages.js';
-
-/** Parse a multi-value query parameter into a normalized string array. */
-function parseMultiValueParam(values) {
-    if (!values || values.length === 0)
-        return undefined;
-    const result = values.flatMap((value) => value
-        .split(",")
-        .map((v) => v.trim())
-        .filter(Boolean));
-    return result.length > 0 ? result : undefined;
-}
-/**
- * Load locale messages from a URL-based query protocol.
- *
- * - This helper is intended for building custom HTTP endpoints
- *
- * @example
- * ```ts
- * const url = new URL(
- *   "https://example.com/messages" +
- *   "?locale=en-US" +
- *   "&rootDir=./messages" +
- *   "&namespaces=common" +
- *   "&namespaces=homepage" +
- *   "&fallbackLocales=zh-TW"
- * );
- *
- * const messages = await loadMessagesFromUrl(url);
- * ```
- */
-async function loadMessagesFromUrl(url, options) {
-    // Parse query parameters
-    const rootDir = url.searchParams.get("rootDir") ?? "";
-    const locale = url.searchParams.get("locale") ?? "en-US";
-    const namespaces = parseMultiValueParam(url.searchParams.getAll("namespaces"));
-    const fallbackLocales = parseMultiValueParam(url.searchParams.getAll("fallbackLocales"));
-    // Load local messages
-    return loadLocalMessages({
-        id: options?.id || "default",
-        rootDir,
-        locale,
-        namespaces,
-        fallbackLocales,
-        concurrency: options?.concurrency,
-        readers: options?.readers,
-        pool: options?.pool,
-        allowCacheWrite: options?.allowCacheWrite,
-        loggerOptions: options?.loggerOptions || { id: "default" },
-    });
-}
-
-export { loadMessagesFromUrl };

package/dist/core/src/server/runtime/create-intor-runtime.js

@@ -1,56 +0,0 @@
-import { IntorError, IntorErrorCode } from '../../core/error/intor-error.js';
-import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
-import 'logry';
-import { loadMessages } from '../messages/load-messages.js';
-import { createTranslator } from '../translator/create-translator.js';
-
-/**
- * Create a server-side Intor runtime.
- *
- * - The runtime represents a request-scoped execution context.
- * - It enforces a strict initialization protocol:
- * `ensureMessages(locale) → getTranslator(locale)`
- * - Messages may be empty, but the ensure step must be completed
- * before a translator snapshot can be created.
- */
-function createIntorRuntime(config, options) {
-    const loader = resolveLoaderOptions(config, "server");
-    // Locale that has completed the ensureMessages() phase
-    let ensuredLocale;
-    // Messages prepared during ensureMessages(); may be empty
-    let ensuredMessages;
-    return {
-        async ensureMessages(locale) {
-            let messages;
-            if (loader) {
-                messages = await loadMessages({
-                    config,
-                    locale,
-                    readers: options?.readers,
-                    allowCacheWrite: options?.allowCacheWrite || false,
-                });
-            }
-            ensuredLocale = locale;
-            ensuredMessages = messages || {};
-        },
-        translator(locale, options) {
-            // Guard: translator requires ensureMessages() to be completed for this locale
-            if (locale !== ensuredLocale) {
-                throw new IntorError({
-                    message: "translator() called before ensureMessages()",
-                    code: IntorErrorCode.RUNTIME_NOT_INITIALIZED,
-                });
-            }
-            return createTranslator({
-                config,
-                locale,
-                messages: ensuredMessages || {},
-                preKey: options?.preKey,
-                handlers: options?.handlers,
-                plugins: options?.plugins,
-            });
-        },
-    };
-}
-
-export { createIntorRuntime };

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

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

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

@@ -1,55 +0,0 @@
-import { getLogger } from '../../../logger/get-logger.js';
-import { isValidMessages } from '../../utils/is-valid-messages.js';
-import { buildSearchParams } from './utils/build-search-params.js';
-
-/**
- * Fetches locale messages from a remote API.
- *
- * - Validates that the returned JSON matches the expected `NamespaceMessages` structure.
- * - Uses `fetch` with `no-store` cache to always get fresh data.
- */
-const fetchLocaleMessages = async ({ locale, namespaces, rootDir, url: rawUrl, headers: rawHeaders, signal, extraOptions: { loggerOptions }, }) => {
-    const baseLogger = getLogger(loggerOptions);
-    const logger = baseLogger.child({ scope: "fetch-locale-messages" });
-    const searchParams = buildSearchParams({ locale, rootDir, namespaces });
-    const url = `${rawUrl}?${searchParams.toString()}`;
-    try {
-        // Headers
-        const headers = {
-            "Content-Type": "application/json",
-            ...rawHeaders,
-        };
-        // Fetch
-        const response = await fetch(url, {
-            method: "GET",
-            headers: headers,
-            cache: "no-store",
-            signal,
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status} ${response.statusText}`);
-        }
-        // Parse JSON body
-        const data = (await response.json());
-        // Validate messages structure
-        if (!isValidMessages(data[locale])) {
-            throw new Error("JSON file does not match NamespaceMessages structure");
-        }
-        return data;
-    }
-    catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-            logger.debug("Fetching locale messages aborted.", { locale, url });
-            return;
-        }
-        logger.warn("Fetching locale messages failed.", {
-            locale,
-            url,
-            searchParams: decodeURIComponent(searchParams.toString()),
-            error,
-        });
-        return;
-    }
-};
-
-export { fetchLocaleMessages };

package/dist/express/src/core/messages/load-remote-messages/fetch-locale-messages/utils/build-search-params.js

@@ -1,25 +0,0 @@
-/**
- * Build URLSearchParams from an object.
- * Supports string or string[] values. Ignores undefined/null.
- */
-const buildSearchParams = (params) => {
-    const searchParams = new URLSearchParams();
-    const appendParam = (key, value) => {
-        if (value === undefined || value === null)
-            return;
-        if (Array.isArray(value) && value.length === 0)
-            return;
-        if (Array.isArray(value)) {
-            value.forEach((v) => v && searchParams.append(key, v));
-        }
-        else {
-            searchParams.append(key, value);
-        }
-    };
-    Object.entries(params).forEach(([key, value]) => {
-        appendParam(key, value);
-    });
-    return searchParams;
-};
-
-export { buildSearchParams };

package/dist/express/src/server/runtime/create-intor-runtime.js

@@ -1,56 +0,0 @@
-import { IntorError, IntorErrorCode } from '../../core/error/intor-error.js';
-import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
-import 'logry';
-import { loadMessages } from '../messages/load-messages.js';
-import { createTranslator } from '../translator/create-translator.js';
-
-/**
- * Create a server-side Intor runtime.
- *
- * - The runtime represents a request-scoped execution context.
- * - It enforces a strict initialization protocol:
- * `ensureMessages(locale) → getTranslator(locale)`
- * - Messages may be empty, but the ensure step must be completed
- * before a translator snapshot can be created.
- */
-function createIntorRuntime(config, options) {
-    const loader = resolveLoaderOptions(config);
-    // Locale that has completed the ensureMessages() phase
-    let ensuredLocale;
-    // Messages prepared during ensureMessages(); may be empty
-    let ensuredMessages;
-    return {
-        async ensureMessages(locale) {
-            let messages;
-            if (loader) {
-                messages = await loadMessages({
-                    config,
-                    locale,
-                    readers: options?.readers,
-                    allowCacheWrite: options?.allowCacheWrite || false,
-                });
-            }
-            ensuredLocale = locale;
-            ensuredMessages = messages || {};
-        },
-        translator(locale, options) {
-            // Guard: translator requires ensureMessages() to be completed for this locale
-            if (locale !== ensuredLocale) {
-                throw new IntorError({
-                    message: "translator() called before ensureMessages()",
-                    code: IntorErrorCode.RUNTIME_NOT_INITIALIZED,
-                });
-            }
-            return createTranslator({
-                config,
-                locale,
-                messages: ensuredMessages || {},
-                preKey: options?.preKey,
-                handlers: options?.handlers,
-                plugins: options?.plugins,
-            });
-        },
-    };
-}
-
-export { createIntorRuntime };

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

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

package/dist/next/src/core/messages/load-remote-messages/fetch-locale-messages/fetch-locale-messages.js

@@ -1,55 +0,0 @@
-import { getLogger } from '../../../logger/get-logger.js';
-import { isValidMessages } from '../../utils/is-valid-messages.js';
-import { buildSearchParams } from './utils/build-search-params.js';
-
-/**
- * Fetches locale messages from a remote API.
- *
- * - Validates that the returned JSON matches the expected `NamespaceMessages` structure.
- * - Uses `fetch` with `no-store` cache to always get fresh data.
- */
-const fetchLocaleMessages = async ({ locale, namespaces, rootDir, url: rawUrl, headers: rawHeaders, signal, extraOptions: { loggerOptions }, }) => {
-    const baseLogger = getLogger(loggerOptions);
-    const logger = baseLogger.child({ scope: "fetch-locale-messages" });
-    const searchParams = buildSearchParams({ locale, rootDir, namespaces });
-    const url = `${rawUrl}?${searchParams.toString()}`;
-    try {
-        // Headers
-        const headers = {
-            "Content-Type": "application/json",
-            ...rawHeaders,
-        };
-        // Fetch
-        const response = await fetch(url, {
-            method: "GET",
-            headers: headers,
-            cache: "no-store",
-            signal,
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status} ${response.statusText}`);
-        }
-        // Parse JSON body
-        const data = (await response.json());
-        // Validate messages structure
-        if (!isValidMessages(data[locale])) {
-            throw new Error("JSON file does not match NamespaceMessages structure");
-        }
-        return data;
-    }
-    catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-            logger.debug("Fetching locale messages aborted.", { locale, url });
-            return;
-        }
-        logger.warn("Fetching locale messages failed.", {
-            locale,
-            url,
-            searchParams: decodeURIComponent(searchParams.toString()),
-            error,
-        });
-        return;
-    }
-};
-
-export { fetchLocaleMessages };

package/dist/next/src/core/messages/load-remote-messages/fetch-locale-messages/utils/build-search-params.js

@@ -1,25 +0,0 @@
-/**
- * Build URLSearchParams from an object.
- * Supports string or string[] values. Ignores undefined/null.
- */
-const buildSearchParams = (params) => {
-    const searchParams = new URLSearchParams();
-    const appendParam = (key, value) => {
-        if (value === undefined || value === null)
-            return;
-        if (Array.isArray(value) && value.length === 0)
-            return;
-        if (Array.isArray(value)) {
-            value.forEach((v) => v && searchParams.append(key, v));
-        }
-        else {
-            searchParams.append(key, value);
-        }
-    };
-    Object.entries(params).forEach(([key, value]) => {
-        appendParam(key, value);
-    });
-    return searchParams;
-};
-
-export { buildSearchParams };

package/dist/next/src/server/runtime/create-intor-runtime.js

@@ -1,56 +0,0 @@
-import { IntorError, IntorErrorCode } from '../../core/error/intor-error.js';
-import { resolveLoaderOptions } from '../../core/utils/resolve-loader-options.js';
-import 'logry';
-import { loadMessages } from '../messages/load-messages.js';
-import { createTranslator } from '../translator/create-translator.js';
-
-/**
- * Create a server-side Intor runtime.
- *
- * - The runtime represents a request-scoped execution context.
- * - It enforces a strict initialization protocol:
- * `ensureMessages(locale) → getTranslator(locale)`
- * - Messages may be empty, but the ensure step must be completed
- * before a translator snapshot can be created.
- */
-function createIntorRuntime(config, options) {
-    const loader = resolveLoaderOptions(config, "server");
-    // Locale that has completed the ensureMessages() phase
-    let ensuredLocale;
-    // Messages prepared during ensureMessages(); may be empty
-    let ensuredMessages;
-    return {
-        async ensureMessages(locale) {
-            let messages;
-            if (loader) {
-                messages = await loadMessages({
-                    config,
-                    locale,
-                    readers: options?.readers,
-                    allowCacheWrite: options?.allowCacheWrite || false,
-                });
-            }
-            ensuredLocale = locale;
-            ensuredMessages = messages || {};
-        },
-        translator(locale, options) {
-            // Guard: translator requires ensureMessages() to be completed for this locale
-            if (locale !== ensuredLocale) {
-                throw new IntorError({
-                    message: "translator() called before ensureMessages()",
-                    code: IntorErrorCode.RUNTIME_NOT_INITIALIZED,
-                });
-            }
-            return createTranslator({
-                config,
-                locale,
-                messages: ensuredMessages || {},
-                preKey: options?.preKey,
-                handlers: options?.handlers,
-                plugins: options?.plugins,
-            });
-        },
-    };
-}
-
-export { createIntorRuntime };

package/dist/react/src/core/messages/load-remote-messages/fetch-locale-messages/fetch-locale-messages.js

@@ -1,55 +0,0 @@
-import { getLogger } from '../../../logger/get-logger.js';
-import { isValidMessages } from '../../utils/is-valid-messages.js';
-import { buildSearchParams } from './utils/build-search-params.js';
-
-/**
- * Fetches locale messages from a remote API.
- *
- * - Validates that the returned JSON matches the expected `NamespaceMessages` structure.
- * - Uses `fetch` with `no-store` cache to always get fresh data.
- */
-const fetchLocaleMessages = async ({ locale, namespaces, rootDir, url: rawUrl, headers: rawHeaders, signal, extraOptions: { loggerOptions }, }) => {
-    const baseLogger = getLogger(loggerOptions);
-    const logger = baseLogger.child({ scope: "fetch-locale-messages" });
-    const searchParams = buildSearchParams({ locale, rootDir, namespaces });
-    const url = `${rawUrl}?${searchParams.toString()}`;
-    try {
-        // Headers
-        const headers = {
-            "Content-Type": "application/json",
-            ...rawHeaders,
-        };
-        // Fetch
-        const response = await fetch(url, {
-            method: "GET",
-            headers: headers,
-            cache: "no-store",
-            signal,
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status} ${response.statusText}`);
-        }
-        // Parse JSON body
-        const data = (await response.json());
-        // Validate messages structure
-        if (!isValidMessages(data[locale])) {
-            throw new Error("JSON file does not match NamespaceMessages structure");
-        }
-        return data;
-    }
-    catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-            logger.debug("Fetching locale messages aborted.", { locale, url });
-            return;
-        }
-        logger.warn("Fetching locale messages failed.", {
-            locale,
-            url,
-            searchParams: decodeURIComponent(searchParams.toString()),
-            error,
-        });
-        return;
-    }
-};
-
-export { fetchLocaleMessages };

package/dist/react/src/core/messages/load-remote-messages/fetch-locale-messages/utils/build-search-params.js

@@ -1,25 +0,0 @@
-/**
- * Build URLSearchParams from an object.
- * Supports string or string[] values. Ignores undefined/null.
- */
-const buildSearchParams = (params) => {
-    const searchParams = new URLSearchParams();
-    const appendParam = (key, value) => {
-        if (value === undefined || value === null)
-            return;
-        if (Array.isArray(value) && value.length === 0)
-            return;
-        if (Array.isArray(value)) {
-            value.forEach((v) => v && searchParams.append(key, v));
-        }
-        else {
-            searchParams.append(key, value);
-        }
-    };
-    Object.entries(params).forEach(([key, value]) => {
-        appendParam(key, value);
-    });
-    return searchParams;
-};
-
-export { buildSearchParams };

package/dist/react/src/policies/should-persist.js

@@ -1,8 +0,0 @@
-/**
- * Determine whether locale persistence is enabled.
- */
-function shouldPersist(cookie) {
-    return cookie.enabled && cookie.persist;
-}
-
-export { shouldPersist };

package/dist/svelte/src/core/messages/load-remote-messages/fetch-locale-messages/fetch-locale-messages.js

@@ -1,55 +0,0 @@
-import { getLogger } from '../../../logger/get-logger.js';
-import { isValidMessages } from '../../utils/is-valid-messages.js';
-import { buildSearchParams } from './utils/build-search-params.js';
-
-/**
- * Fetches locale messages from a remote API.
- *
- * - Validates that the returned JSON matches the expected `NamespaceMessages` structure.
- * - Uses `fetch` with `no-store` cache to always get fresh data.
- */
-const fetchLocaleMessages = async ({ locale, namespaces, rootDir, url: rawUrl, headers: rawHeaders, signal, extraOptions: { loggerOptions }, }) => {
-    const baseLogger = getLogger(loggerOptions);
-    const logger = baseLogger.child({ scope: "fetch-locale-messages" });
-    const searchParams = buildSearchParams({ locale, rootDir, namespaces });
-    const url = `${rawUrl}?${searchParams.toString()}`;
-    try {
-        // Headers
-        const headers = {
-            "Content-Type": "application/json",
-            ...rawHeaders,
-        };
-        // Fetch
-        const response = await fetch(url, {
-            method: "GET",
-            headers: headers,
-            cache: "no-store",
-            signal,
-        });
-        if (!response.ok) {
-            throw new Error(`HTTP error ${response.status} ${response.statusText}`);
-        }
-        // Parse JSON body
-        const data = (await response.json());
-        // Validate messages structure
-        if (!isValidMessages(data[locale])) {
-            throw new Error("JSON file does not match NamespaceMessages structure");
-        }
-        return data;
-    }
-    catch (error) {
-        if (error instanceof Error && error.name === "AbortError") {
-            logger.debug("Fetching locale messages aborted.", { locale, url });
-            return;
-        }
-        logger.warn("Fetching locale messages failed.", {
-            locale,
-            url,
-            searchParams: decodeURIComponent(searchParams.toString()),
-            error,
-        });
-        return;
-    }
-};
-
-export { fetchLocaleMessages };

package/dist/svelte/src/core/messages/load-remote-messages/fetch-locale-messages/utils/build-search-params.js

@@ -1,25 +0,0 @@
-/**
- * Build URLSearchParams from an object.
- * Supports string or string[] values. Ignores undefined/null.
- */
-const buildSearchParams = (params) => {
-    const searchParams = new URLSearchParams();
-    const appendParam = (key, value) => {
-        if (value === undefined || value === null)
-            return;
-        if (Array.isArray(value) && value.length === 0)
-            return;
-        if (Array.isArray(value)) {
-            value.forEach((v) => v && searchParams.append(key, v));
-        }
-        else {
-            searchParams.append(key, value);
-        }
-    };
-    Object.entries(params).forEach(([key, value]) => {
-        appendParam(key, value);
-    });
-    return searchParams;
-};
-
-export { buildSearchParams };

package/dist/svelte/src/policies/should-persist.js

@@ -1,8 +0,0 @@
-/**
- * Determine whether locale persistence is enabled.
- */
-function shouldPersist(cookie) {
-    return cookie.enabled && cookie.persist;
-}
-
-export { shouldPersist };

package/dist/types/src/core/messages/global-messages-pool.d.ts

@@ -1,25 +0,0 @@
-import type { LocaleMessages } from "intor-translator";
-/**
- * Global messages pool (process-level, hot-reload safe).
- *
- * This pool is intentionally minimal:
- * - No TTL
- * - No eviction
- * - No external backends
- *
- * Messages are treated as immutable within a process lifecycle.
- */
-export type MessagesPool = Map<string, LocaleMessages>;
-declare global {
-    var __INTOR_MESSAGES_POOL__: MessagesPool | undefined;
-}
-/**
- * Get the global messages pool.
- *
- * Lazily initialized to ensure:
- * - Cross-module sharing
- * - Dev / HMR safety
- */
-export declare function getGlobalMessagesPool(): MessagesPool;
-/** Clear all cached messages. */
-export declare function clearMessagesPool(): void;

package/dist/types/src/core/messages/load-remote-messages/fetch-locale-messages/fetch-locale-messages.d.ts

@@ -1,9 +0,0 @@
-import type { FetcherOptions } from "./types";
-import type { LocaleMessages } from "intor-translator";
-/**
- * Fetches locale messages from a remote API.
- *
- * - Validates that the returned JSON matches the expected `NamespaceMessages` structure.
- * - Uses `fetch` with `no-store` cache to always get fresh data.
- */
-export declare const fetchLocaleMessages: ({ locale, namespaces, rootDir, url: rawUrl, headers: rawHeaders, signal, extraOptions: { loggerOptions }, }: FetcherOptions) => Promise<LocaleMessages | undefined>;

package/dist/types/src/core/messages/load-remote-messages/fetch-locale-messages/index.d.ts

@@ -1 +0,0 @@
-export { fetchLocaleMessages } from "./fetch-locale-messages";