intor 2.2.6 → 2.2.7

package/dist/next/server/index.cjs

@@ -690,16 +690,21 @@ var loadMessages = async ({
 };
 
 // src/server/translator/get-translator.ts
-async function getTranslator(opts) {
-  const { config, locale, pathname = "", preKey, handlers } = opts;
-  const messages = await loadMessages({ config, locale, pathname });
+async function getTranslator(options) {
+  const { config, locale, pathname = "", preKey } = options;
+  const messages = await loadMessages({
+    config,
+    locale,
+    pathname,
+    extraOptions: options.extraOptions
+  });
   const translator = new intorTranslator.Translator({
     locale,
     messages,
     fallbackLocales: config.fallbackLocales,
     loadingMessage: config.translator?.loadingMessage,
     placeholder: config.translator?.placeholder,
-    handlers
+    handlers: options.handlers
   });
   const props = { messages, locale };
   const scoped = translator.scoped(preKey);
@@ -711,12 +716,15 @@ async function getTranslator(opts) {
 }
 
 // src/adapters/next/server/get-translator.ts
-async function getTranslator2(config, preKey) {
+async function getTranslator2(options) {
+  const { config, preKey, handlers, extraOptions } = options;
   const { locale, pathname } = await getI18nContext(config);
   const translatorInstance = getTranslator({
     config,
     locale,
     pathname,
+    handlers,
+    extraOptions,
     preKey
   });
   return translatorInstance;

package/dist/next/server/index.d.cts

@@ -1,5 +1,7 @@
 import { Level, NormalizerConfig, FormatterConfig, LoggerPreset } from 'logry/edge';
-import { Locale, LocaleMessages, FallbackLocalesMap, ScopedLeafKeys, LocalizedLeafKeys, Replacement, LocalizedNodeKeys } from 'intor-translator';
+import { Locale, LocaleMessages, FallbackLocalesMap, NestedMessage, ScopedLeafKeys, LocalizedLeafKeys, Replacement, TranslateHandlers, LocalizedNodeKeys } from 'intor-translator';
+import Keyv from 'keyv';
+import { Logger } from 'logry';
 
 type CookieRawOptions = {
     /** Completely disable cookie usage (no read, no write, no lookup by name) - default: false */
@@ -162,6 +164,53 @@ interface I18nContext {
  */
 declare const getI18nContext: <CK extends GenConfigKeys = "__default__">(config: IntorResolvedConfig) => Promise<I18nContext>;
 
+/**
+ * Represents a collection of localized messages.
+ *
+ * - Each key is a namespace or message identifier, and the value is a
+ * `NestedMessage` object that can contain nested message structures.
+ *
+ * @example
+ * ```ts
+ * const messages: Messages = {
+ *   ui: {
+ *     greeting: "Hello",
+ *     farewell: "Goodbye"
+ *   },
+ *   errors: {
+ *     network: "Network error occurred"
+ *   }
+ * };
+ * ```
+ */
+type Messages = Record<string, NestedMessage>;
+/**
+ * A function that reads messages from a given file path.
+ *
+ * - This function is expected to return a `Promise` that resolves to a `Messages` object.
+ * - It can be implemented to support different file formats such as JSON, YAML, or others.
+ *
+ * @param filePath - The path to the message file to read.
+ * @returns A Promise that resolves to a `Messages` object.
+ *
+ * @example
+ * ```ts
+ * const reader: MessagesReader = async (filePath) => {
+ *   const content = await fs.promises.readFile(filePath, "utf-8");
+ *   return JSON.parse(content) as Messages;
+ * };
+ * ```
+ */
+type MessagesReader = (filePath: string) => Promise<Messages>;
+
+/**
+ * Global messages pool (cross-module + hot-reload safe)
+ */
+type MessagesPool = Keyv<LocaleMessages>;
+declare global {
+    var __INTOR_MESSAGES_POOL__: MessagesPool | undefined;
+}
+
 /** Base properties shared by all translator instances. */
 interface TranslatorBaseProps<M = unknown> {
     /** `messages`: The message object containing all translations. */
@@ -193,16 +242,38 @@ type TranslatorInstance<M, PK extends string | undefined = undefined> = {
     t: <Result = string>(key?: Key<M, PK>, replacements?: Replacement) => Result;
 } & TranslatorBaseProps<M> & TranslatorClientProps<M>;
 
+/**
+ * Global logger pool (cross-module + hot-reload safe)
+ */
+type LoggerPool = Map<string, Logger>;
+declare global {
+    var __INTOR_LOGGER_POOL__: LoggerPool | undefined;
+}
+
 /**
  * Create a translator instance ready for the current Next.js SSR environment.
  *
- * - Automatically resolves the current locale and pathname using the Next.js adapter.
- * - Loads all corresponding messages for the resolved locale and pathname.
- * - Returns a translator object containing `t`, `hasKey`, `messages`, and other helpers.
- * - Supports optional `preKey` to create a scoped translator for nested translation keys.
- * - Allows passing additional `TranslateConfig` options to the underlying translator.
+ * - **Automatically resolves the current locale and pathname using the Next.js adapter.**
+ * - Loads messages using the provided config, locale, and pathname.
+ * - Initializes a translator with `t`, `hasKey`, and optional scoped methods.
+ * - Supports optional `preKey` to create a scoped translator for nested keys.
  */
-declare function getTranslator<CK extends GenConfigKeys = "__default__">(config: IntorResolvedConfig): Promise<TranslatorInstance<GenMessages<CK>>>;
-declare function getTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(config: IntorResolvedConfig, preKey: IfGen<PK, string>): Promise<TranslatorInstance<GenMessages<CK>, PK>>;
+declare function getTranslator<CK extends GenConfigKeys = "__default__">(options: {
+    config: IntorResolvedConfig;
+    handlers?: TranslateHandlers;
+    extraOptions?: {
+        exts?: string[];
+        messagesReader?: MessagesReader;
+    };
+}): Promise<TranslatorInstance<GenMessages<CK>>>;
+declare function getTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(options: {
+    config: IntorResolvedConfig;
+    handlers?: TranslateHandlers;
+    extraOptions?: {
+        exts?: string[];
+        messagesReader?: MessagesReader;
+    };
+    preKey: IfGen<PK, string>;
+}): Promise<TranslatorInstance<GenMessages<CK>, PK>>;
 
 export { getI18nContext, getTranslator };

package/dist/next/server/index.d.ts

@@ -1,5 +1,7 @@
 import { Level, NormalizerConfig, FormatterConfig, LoggerPreset } from 'logry/edge';
-import { Locale, LocaleMessages, FallbackLocalesMap, ScopedLeafKeys, LocalizedLeafKeys, Replacement, LocalizedNodeKeys } from 'intor-translator';
+import { Locale, LocaleMessages, FallbackLocalesMap, NestedMessage, ScopedLeafKeys, LocalizedLeafKeys, Replacement, TranslateHandlers, LocalizedNodeKeys } from 'intor-translator';
+import Keyv from 'keyv';
+import { Logger } from 'logry';
 
 type CookieRawOptions = {
     /** Completely disable cookie usage (no read, no write, no lookup by name) - default: false */
@@ -162,6 +164,53 @@ interface I18nContext {
  */
 declare const getI18nContext: <CK extends GenConfigKeys = "__default__">(config: IntorResolvedConfig) => Promise<I18nContext>;
 
+/**
+ * Represents a collection of localized messages.
+ *
+ * - Each key is a namespace or message identifier, and the value is a
+ * `NestedMessage` object that can contain nested message structures.
+ *
+ * @example
+ * ```ts
+ * const messages: Messages = {
+ *   ui: {
+ *     greeting: "Hello",
+ *     farewell: "Goodbye"
+ *   },
+ *   errors: {
+ *     network: "Network error occurred"
+ *   }
+ * };
+ * ```
+ */
+type Messages = Record<string, NestedMessage>;
+/**
+ * A function that reads messages from a given file path.
+ *
+ * - This function is expected to return a `Promise` that resolves to a `Messages` object.
+ * - It can be implemented to support different file formats such as JSON, YAML, or others.
+ *
+ * @param filePath - The path to the message file to read.
+ * @returns A Promise that resolves to a `Messages` object.
+ *
+ * @example
+ * ```ts
+ * const reader: MessagesReader = async (filePath) => {
+ *   const content = await fs.promises.readFile(filePath, "utf-8");
+ *   return JSON.parse(content) as Messages;
+ * };
+ * ```
+ */
+type MessagesReader = (filePath: string) => Promise<Messages>;
+
+/**
+ * Global messages pool (cross-module + hot-reload safe)
+ */
+type MessagesPool = Keyv<LocaleMessages>;
+declare global {
+    var __INTOR_MESSAGES_POOL__: MessagesPool | undefined;
+}
+
 /** Base properties shared by all translator instances. */
 interface TranslatorBaseProps<M = unknown> {
     /** `messages`: The message object containing all translations. */
@@ -193,16 +242,38 @@ type TranslatorInstance<M, PK extends string | undefined = undefined> = {
     t: <Result = string>(key?: Key<M, PK>, replacements?: Replacement) => Result;
 } & TranslatorBaseProps<M> & TranslatorClientProps<M>;
 
+/**
+ * Global logger pool (cross-module + hot-reload safe)
+ */
+type LoggerPool = Map<string, Logger>;
+declare global {
+    var __INTOR_LOGGER_POOL__: LoggerPool | undefined;
+}
+
 /**
  * Create a translator instance ready for the current Next.js SSR environment.
  *
- * - Automatically resolves the current locale and pathname using the Next.js adapter.
- * - Loads all corresponding messages for the resolved locale and pathname.
- * - Returns a translator object containing `t`, `hasKey`, `messages`, and other helpers.
- * - Supports optional `preKey` to create a scoped translator for nested translation keys.
- * - Allows passing additional `TranslateConfig` options to the underlying translator.
+ * - **Automatically resolves the current locale and pathname using the Next.js adapter.**
+ * - Loads messages using the provided config, locale, and pathname.
+ * - Initializes a translator with `t`, `hasKey`, and optional scoped methods.
+ * - Supports optional `preKey` to create a scoped translator for nested keys.
  */
-declare function getTranslator<CK extends GenConfigKeys = "__default__">(config: IntorResolvedConfig): Promise<TranslatorInstance<GenMessages<CK>>>;
-declare function getTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(config: IntorResolvedConfig, preKey: IfGen<PK, string>): Promise<TranslatorInstance<GenMessages<CK>, PK>>;
+declare function getTranslator<CK extends GenConfigKeys = "__default__">(options: {
+    config: IntorResolvedConfig;
+    handlers?: TranslateHandlers;
+    extraOptions?: {
+        exts?: string[];
+        messagesReader?: MessagesReader;
+    };
+}): Promise<TranslatorInstance<GenMessages<CK>>>;
+declare function getTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(options: {
+    config: IntorResolvedConfig;
+    handlers?: TranslateHandlers;
+    extraOptions?: {
+        exts?: string[];
+        messagesReader?: MessagesReader;
+    };
+    preKey: IfGen<PK, string>;
+}): Promise<TranslatorInstance<GenMessages<CK>, PK>>;
 
 export { getI18nContext, getTranslator };

package/dist/next/server/index.js

@@ -680,16 +680,21 @@ var loadMessages = async ({
 };
 
 // src/server/translator/get-translator.ts
-async function getTranslator(opts) {
-  const { config, locale, pathname = "", preKey, handlers } = opts;
-  const messages = await loadMessages({ config, locale, pathname });
+async function getTranslator(options) {
+  const { config, locale, pathname = "", preKey } = options;
+  const messages = await loadMessages({
+    config,
+    locale,
+    pathname,
+    extraOptions: options.extraOptions
+  });
   const translator = new Translator({
     locale,
     messages,
     fallbackLocales: config.fallbackLocales,
     loadingMessage: config.translator?.loadingMessage,
     placeholder: config.translator?.placeholder,
-    handlers
+    handlers: options.handlers
   });
   const props = { messages, locale };
   const scoped = translator.scoped(preKey);
@@ -701,12 +706,15 @@ async function getTranslator(opts) {
 }
 
 // src/adapters/next/server/get-translator.ts
-async function getTranslator2(config, preKey) {
+async function getTranslator2(options) {
+  const { config, preKey, handlers, extraOptions } = options;
   const { locale, pathname } = await getI18nContext(config);
   const translatorInstance = getTranslator({
     config,
     locale,
     pathname,
+    handlers,
+    extraOptions,
     preKey
   });
   return translatorInstance;

package/dist/server/index.cjs

@@ -669,16 +669,21 @@ var intor = async (config, i18nContext, loadMessagesOptions = {}) => {
     messages: mergedMessages
   };
 };
-async function getTranslator(opts) {
-  const { config, locale, pathname = "", preKey, handlers } = opts;
-  const messages = await loadMessages({ config, locale, pathname });
+async function getTranslator(options) {
+  const { config, locale, pathname = "", preKey } = options;
+  const messages = await loadMessages({
+    config,
+    locale,
+    pathname,
+    extraOptions: options.extraOptions
+  });
   const translator = new intorTranslator.Translator({
     locale,
     messages,
     fallbackLocales: config.fallbackLocales,
     loadingMessage: config.translator?.loadingMessage,
     placeholder: config.translator?.placeholder,
-    handlers
+    handlers: options.handlers
   });
   const props = { messages, locale };
   const scoped = translator.scoped(preKey);

package/dist/server/index.d.cts

@@ -340,19 +340,26 @@ type TranslatorInstance<M, PK extends string | undefined = undefined> = {
  * - Loads messages using the provided config, locale, and pathname.
  * - Initializes a translator with `t`, `hasKey`, and optional scoped methods.
  * - Supports optional `preKey` to create a scoped translator for nested keys.
- * - Passes additional options to the underlying `Translator`.
  */
-declare function getTranslator<CK extends GenConfigKeys = "__default__">(opts: {
+declare function getTranslator<CK extends GenConfigKeys = "__default__">(options: {
     config: IntorResolvedConfig;
     locale: GenLocale;
     pathname?: string;
     handlers?: TranslateHandlers;
+    extraOptions?: {
+        exts?: string[];
+        messagesReader?: MessagesReader;
+    };
 }): Promise<TranslatorInstance<GenMessages<CK>>>;
-declare function getTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(opts: {
+declare function getTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(options: {
     config: IntorResolvedConfig;
     locale: GenLocale;
     pathname?: string;
     handlers?: TranslateHandlers;
+    extraOptions?: {
+        exts?: string[];
+        messagesReader?: MessagesReader;
+    };
     preKey?: PK;
 }): Promise<TranslatorInstance<GenMessages<CK>, PK>>;
 

package/dist/server/index.d.ts

@@ -340,19 +340,26 @@ type TranslatorInstance<M, PK extends string | undefined = undefined> = {
  * - Loads messages using the provided config, locale, and pathname.
  * - Initializes a translator with `t`, `hasKey`, and optional scoped methods.
  * - Supports optional `preKey` to create a scoped translator for nested keys.
- * - Passes additional options to the underlying `Translator`.
  */
-declare function getTranslator<CK extends GenConfigKeys = "__default__">(opts: {
+declare function getTranslator<CK extends GenConfigKeys = "__default__">(options: {
     config: IntorResolvedConfig;
     locale: GenLocale;
     pathname?: string;
     handlers?: TranslateHandlers;
+    extraOptions?: {
+        exts?: string[];
+        messagesReader?: MessagesReader;
+    };
 }): Promise<TranslatorInstance<GenMessages<CK>>>;
-declare function getTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(opts: {
+declare function getTranslator<CK extends GenConfigKeys = "__default__", PK extends string = LocalizedNodeKeys<GenMessages<CK>>>(options: {
     config: IntorResolvedConfig;
     locale: GenLocale;
     pathname?: string;
     handlers?: TranslateHandlers;
+    extraOptions?: {
+        exts?: string[];
+        messagesReader?: MessagesReader;
+    };
     preKey?: PK;
 }): Promise<TranslatorInstance<GenMessages<CK>, PK>>;
 

package/dist/server/index.js

@@ -659,16 +659,21 @@ var intor = async (config, i18nContext, loadMessagesOptions = {}) => {
     messages: mergedMessages
   };
 };
-async function getTranslator(opts) {
-  const { config, locale, pathname = "", preKey, handlers } = opts;
-  const messages = await loadMessages({ config, locale, pathname });
+async function getTranslator(options) {
+  const { config, locale, pathname = "", preKey } = options;
+  const messages = await loadMessages({
+    config,
+    locale,
+    pathname,
+    extraOptions: options.extraOptions
+  });
   const translator = new Translator({
     locale,
     messages,
     fallbackLocales: config.fallbackLocales,
     loadingMessage: config.translator?.loadingMessage,
     placeholder: config.translator?.placeholder,
-    handlers
+    handlers: options.handlers
   });
   const props = { messages, locale };
   const scoped = translator.scoped(preKey);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intor",
-  "version": "2.2.6",
+  "version": "2.2.7",
   "description": "A modular and extensible i18n core designed for TypeScript and JavaScript projects. Intor enables custom translation logic with support for both frontend and backend environments, featuring runtime configuration, caching, adapters, and message loaders.",
   "author": "Yiming Liao",
   "license": "MIT",