intor 2.2.3 → 2.2.4

package/dist/index.cjs

@@ -456,7 +456,8 @@ var loadLocalMessages = async ({
     loggerOptions = { id: "default" },
     exts,
     messagesReader
-  } = {}
+  } = {},
+  allowCacheWrite = false
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-local-messages" });
@@ -503,7 +504,7 @@ var loadLocalMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = perf_hooks.performance.now();
@@ -587,7 +588,8 @@ var loadRemoteMessages = async ({
   extraOptions: {
     cacheOptions = DEFAULT_CACHE_OPTIONS,
     loggerOptions = { id: "default" }
-  } = {}
+  } = {},
+  allowCacheWrite
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-remote-messages" });
@@ -631,7 +633,7 @@ var loadRemoteMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = performance.now();
@@ -648,7 +650,8 @@ var loadMessages = async ({
   config,
   locale,
   pathname = "",
-  extraOptions: { exts, messagesReader } = {}
+  extraOptions: { exts, messagesReader } = {},
+  allowCacheWrite = false
 }) => {
   const baseLogger = getLogger({ id: config.id, ...config.logger });
   const logger = baseLogger.child({ scope: "load-messages" });
@@ -685,7 +688,8 @@ var loadMessages = async ({
         loggerOptions: { id: config.id, ...config.logger },
         exts,
         messagesReader
-      }
+      },
+      allowCacheWrite
     });
   } else if (type === "remote") {
     loadedMessages = await loadRemoteMessages({
@@ -730,7 +734,8 @@ var intor = async (config, i18nContext, loadMessagesOptions = {}) => {
       extraOptions: {
         exts: loadMessagesOptions.exts,
         messagesReader: loadMessagesOptions.messagesReader
-      }
+      },
+      allowCacheWrite: true
     });
   }
   const mergedMessages = mergeMessages(messages, loadedMessages);

package/dist/index.d.cts

@@ -212,6 +212,7 @@ type LoadMessagesOptions = {
         exts?: string[];
         messagesReader?: MessagesReader;
     };
+    allowCacheWrite?: boolean;
 };
 type LoadMessagesResult<C extends GenConfigKeys = "__default__"> = Promise<GenMessages<C> | undefined>;
 
@@ -223,7 +224,7 @@ type LoadMessagesResult<C extends GenConfigKeys = "__default__"> = Promise<GenMe
  * - Apply fallback locales if needed.
  * - Cache messages if enabled (handled by underlying loader, not this function directly).
  */
-declare const loadMessages: <C extends GenConfigKeys = "__default__">({ config, locale, pathname, extraOptions: { exts, messagesReader }, }: LoadMessagesOptions) => LoadMessagesResult<C>;
+declare const loadMessages: <C extends GenConfigKeys = "__default__">({ config, locale, pathname, extraOptions: { exts, messagesReader }, allowCacheWrite, }: LoadMessagesOptions) => LoadMessagesResult<C>;
 
 /**
  * Global messages pool (cross-module + hot-reload safe)
@@ -253,6 +254,7 @@ interface LoadLocalMessagesOptions {
         exts?: string[];
         messagesReader?: MessagesReader;
     };
+    allowCacheWrite?: boolean;
 }
 
 /**
@@ -263,7 +265,7 @@ interface LoadLocalMessagesOptions {
  * - Cache messages if enabled.
  * - Limit concurrent file reads for performance.
  */
-declare const loadLocalMessages: ({ pool, rootDir, locale, fallbackLocales, namespaces, extraOptions: { concurrency, cacheOptions, loggerOptions, exts, messagesReader, }, }: LoadLocalMessagesOptions) => Promise<LocaleMessages | undefined>;
+declare const loadLocalMessages: ({ pool, rootDir, locale, fallbackLocales, namespaces, extraOptions: { concurrency, cacheOptions, loggerOptions, exts, messagesReader, }, allowCacheWrite, }: LoadLocalMessagesOptions) => Promise<LocaleMessages | undefined>;
 
 interface LoadRemoteMessagesOptions {
     pool?: MessagesPool;
@@ -279,6 +281,7 @@ interface LoadRemoteMessagesOptions {
             id?: string;
         };
     };
+    allowCacheWrite?: boolean;
 }
 
 /**
@@ -287,7 +290,7 @@ interface LoadRemoteMessagesOptions {
  * - Fetch messages for a target locale with optional fallback locales.
  * - Cache messages if enabled.
  */
-declare const loadRemoteMessages: ({ pool, rootDir, remoteUrl, remoteHeaders, locale, fallbackLocales, namespaces, extraOptions: { cacheOptions, loggerOptions, }, }: LoadRemoteMessagesOptions) => Promise<LocaleMessages | undefined>;
+declare const loadRemoteMessages: ({ pool, rootDir, remoteUrl, remoteHeaders, locale, fallbackLocales, namespaces, extraOptions: { cacheOptions, loggerOptions, }, allowCacheWrite, }: LoadRemoteMessagesOptions) => Promise<LocaleMessages | undefined>;
 
 /**
  * Entry point for initializing Intor.

package/dist/index.d.ts

@@ -212,6 +212,7 @@ type LoadMessagesOptions = {
         exts?: string[];
         messagesReader?: MessagesReader;
     };
+    allowCacheWrite?: boolean;
 };
 type LoadMessagesResult<C extends GenConfigKeys = "__default__"> = Promise<GenMessages<C> | undefined>;
 
@@ -223,7 +224,7 @@ type LoadMessagesResult<C extends GenConfigKeys = "__default__"> = Promise<GenMe
  * - Apply fallback locales if needed.
  * - Cache messages if enabled (handled by underlying loader, not this function directly).
  */
-declare const loadMessages: <C extends GenConfigKeys = "__default__">({ config, locale, pathname, extraOptions: { exts, messagesReader }, }: LoadMessagesOptions) => LoadMessagesResult<C>;
+declare const loadMessages: <C extends GenConfigKeys = "__default__">({ config, locale, pathname, extraOptions: { exts, messagesReader }, allowCacheWrite, }: LoadMessagesOptions) => LoadMessagesResult<C>;
 
 /**
  * Global messages pool (cross-module + hot-reload safe)
@@ -253,6 +254,7 @@ interface LoadLocalMessagesOptions {
         exts?: string[];
         messagesReader?: MessagesReader;
     };
+    allowCacheWrite?: boolean;
 }
 
 /**
@@ -263,7 +265,7 @@ interface LoadLocalMessagesOptions {
  * - Cache messages if enabled.
  * - Limit concurrent file reads for performance.
  */
-declare const loadLocalMessages: ({ pool, rootDir, locale, fallbackLocales, namespaces, extraOptions: { concurrency, cacheOptions, loggerOptions, exts, messagesReader, }, }: LoadLocalMessagesOptions) => Promise<LocaleMessages | undefined>;
+declare const loadLocalMessages: ({ pool, rootDir, locale, fallbackLocales, namespaces, extraOptions: { concurrency, cacheOptions, loggerOptions, exts, messagesReader, }, allowCacheWrite, }: LoadLocalMessagesOptions) => Promise<LocaleMessages | undefined>;
 
 interface LoadRemoteMessagesOptions {
     pool?: MessagesPool;
@@ -279,6 +281,7 @@ interface LoadRemoteMessagesOptions {
             id?: string;
         };
     };
+    allowCacheWrite?: boolean;
 }
 
 /**
@@ -287,7 +290,7 @@ interface LoadRemoteMessagesOptions {
  * - Fetch messages for a target locale with optional fallback locales.
  * - Cache messages if enabled.
  */
-declare const loadRemoteMessages: ({ pool, rootDir, remoteUrl, remoteHeaders, locale, fallbackLocales, namespaces, extraOptions: { cacheOptions, loggerOptions, }, }: LoadRemoteMessagesOptions) => Promise<LocaleMessages | undefined>;
+declare const loadRemoteMessages: ({ pool, rootDir, remoteUrl, remoteHeaders, locale, fallbackLocales, namespaces, extraOptions: { cacheOptions, loggerOptions, }, allowCacheWrite, }: LoadRemoteMessagesOptions) => Promise<LocaleMessages | undefined>;
 
 /**
  * Entry point for initializing Intor.

package/dist/index.js

@@ -447,7 +447,8 @@ var loadLocalMessages = async ({
     loggerOptions = { id: "default" },
     exts,
     messagesReader
-  } = {}
+  } = {},
+  allowCacheWrite = false
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-local-messages" });
@@ -494,7 +495,7 @@ var loadLocalMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = performance$1.now();
@@ -578,7 +579,8 @@ var loadRemoteMessages = async ({
   extraOptions: {
     cacheOptions = DEFAULT_CACHE_OPTIONS,
     loggerOptions = { id: "default" }
-  } = {}
+  } = {},
+  allowCacheWrite
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-remote-messages" });
@@ -622,7 +624,7 @@ var loadRemoteMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = performance.now();
@@ -639,7 +641,8 @@ var loadMessages = async ({
   config,
   locale,
   pathname = "",
-  extraOptions: { exts, messagesReader } = {}
+  extraOptions: { exts, messagesReader } = {},
+  allowCacheWrite = false
 }) => {
   const baseLogger = getLogger({ id: config.id, ...config.logger });
   const logger = baseLogger.child({ scope: "load-messages" });
@@ -676,7 +679,8 @@ var loadMessages = async ({
         loggerOptions: { id: config.id, ...config.logger },
         exts,
         messagesReader
-      }
+      },
+      allowCacheWrite
     });
   } else if (type === "remote") {
     loadedMessages = await loadRemoteMessages({
@@ -721,7 +725,8 @@ var intor = async (config, i18nContext, loadMessagesOptions = {}) => {
       extraOptions: {
         exts: loadMessagesOptions.exts,
         messagesReader: loadMessagesOptions.messagesReader
-      }
+      },
+      allowCacheWrite: true
     });
   }
   const mergedMessages = mergeMessages(messages, loadedMessages);

package/dist/next/index.cjs

@@ -385,7 +385,8 @@ var loadRemoteMessages = async ({
   extraOptions: {
     cacheOptions = DEFAULT_CACHE_OPTIONS,
     loggerOptions = { id: "default" }
-  } = {}
+  } = {},
+  allowCacheWrite
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-remote-messages" });
@@ -429,7 +430,7 @@ var loadRemoteMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = performance.now();

package/dist/next/index.js

@@ -358,7 +358,8 @@ var loadRemoteMessages = async ({
   extraOptions: {
     cacheOptions = DEFAULT_CACHE_OPTIONS,
     loggerOptions = { id: "default" }
-  } = {}
+  } = {},
+  allowCacheWrite
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-remote-messages" });
@@ -402,7 +403,7 @@ var loadRemoteMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = performance.now();

package/dist/next/server/index.cjs

@@ -434,7 +434,8 @@ var loadLocalMessages = async ({
     loggerOptions = { id: "default" },
     exts,
     messagesReader
-  } = {}
+  } = {},
+  allowCacheWrite = false
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-local-messages" });
@@ -481,7 +482,7 @@ var loadLocalMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = perf_hooks.performance.now();
@@ -565,7 +566,8 @@ var loadRemoteMessages = async ({
   extraOptions: {
     cacheOptions = DEFAULT_CACHE_OPTIONS,
     loggerOptions = { id: "default" }
-  } = {}
+  } = {},
+  allowCacheWrite
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-remote-messages" });
@@ -609,7 +611,7 @@ var loadRemoteMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = performance.now();
@@ -626,7 +628,8 @@ var loadMessages = async ({
   config,
   locale,
   pathname = "",
-  extraOptions: { exts, messagesReader } = {}
+  extraOptions: { exts, messagesReader } = {},
+  allowCacheWrite = false
 }) => {
   const baseLogger = getLogger({ id: config.id, ...config.logger });
   const logger = baseLogger.child({ scope: "load-messages" });
@@ -663,7 +666,8 @@ var loadMessages = async ({
         loggerOptions: { id: config.id, ...config.logger },
         exts,
         messagesReader
-      }
+      },
+      allowCacheWrite
     });
   } else if (type === "remote") {
     loadedMessages = await loadRemoteMessages({

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

@@ -160,7 +160,7 @@ interface I18nContext {
  *
  * Next.js adapter implementation: uses `next/headers` and `next/cookies`.
  */
-declare const getI18nContext: <CK extends string = "__default__">(config: IntorResolvedConfig) => Promise<I18nContext>;
+declare const getI18nContext: <CK extends GenConfigKeys = "__default__">(config: IntorResolvedConfig) => Promise<I18nContext>;
 
 /** Base properties shared by all translator instances. */
 interface TranslatorBaseProps<M = unknown> {

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

@@ -160,7 +160,7 @@ interface I18nContext {
  *
  * Next.js adapter implementation: uses `next/headers` and `next/cookies`.
  */
-declare const getI18nContext: <CK extends string = "__default__">(config: IntorResolvedConfig) => Promise<I18nContext>;
+declare const getI18nContext: <CK extends GenConfigKeys = "__default__">(config: IntorResolvedConfig) => Promise<I18nContext>;
 
 /** Base properties shared by all translator instances. */
 interface TranslatorBaseProps<M = unknown> {

package/dist/next/server/index.js

@@ -424,7 +424,8 @@ var loadLocalMessages = async ({
     loggerOptions = { id: "default" },
     exts,
     messagesReader
-  } = {}
+  } = {},
+  allowCacheWrite = false
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-local-messages" });
@@ -471,7 +472,7 @@ var loadLocalMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = performance$1.now();
@@ -555,7 +556,8 @@ var loadRemoteMessages = async ({
   extraOptions: {
     cacheOptions = DEFAULT_CACHE_OPTIONS,
     loggerOptions = { id: "default" }
-  } = {}
+  } = {},
+  allowCacheWrite
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-remote-messages" });
@@ -599,7 +601,7 @@ var loadRemoteMessages = async ({
       });
     }
   }
-  if (cacheOptions.enabled && key && messages) {
+  if (allowCacheWrite && cacheOptions.enabled && key && messages) {
     await pool?.set(key, messages, cacheOptions.ttl);
   }
   const end = performance.now();
@@ -616,7 +618,8 @@ var loadMessages = async ({
   config,
   locale,
   pathname = "",
-  extraOptions: { exts, messagesReader } = {}
+  extraOptions: { exts, messagesReader } = {},
+  allowCacheWrite = false
 }) => {
   const baseLogger = getLogger({ id: config.id, ...config.logger });
   const logger = baseLogger.child({ scope: "load-messages" });
@@ -653,7 +656,8 @@ var loadMessages = async ({
         loggerOptions: { id: config.id, ...config.logger },
         exts,
         messagesReader
-      }
+      },
+      allowCacheWrite
     });
   } else if (type === "remote") {
     loadedMessages = await loadRemoteMessages({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intor",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "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",
@@ -77,6 +77,7 @@
     "p-limit": "^6.2.0"
   },
   "devDependencies": {
+    "@intor/cli": "../@intor:cli",
     "@types/lodash.merge": "^4.6.9",
     "@types/node": "^24.10.1",
     "@types/react": "^19.1.4",