intor 2.1.0 → 2.2.1

package/dist/index.js

@@ -23,33 +23,6 @@ var DEFAULT_CACHE_OPTIONS = {
   // 1 hour
 };
 
-// src/shared/error/intor-error.ts
-var IntorError = class extends Error {
-  constructor({ message, code, id }) {
-    const fullMessage = id ? `[${id}] ${message}` : message;
-    super(fullMessage);
-    this.name = "IntorError";
-    this.id = id;
-    this.code = code;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-
-// src/modules/messages/load-local-messages/utils/read-message-record-file.ts
-var readMessageRecordFile = async (filePath, loggerOptions) => {
-  const fileName = path.basename(filePath, ".json");
-  const content = await fs.readFile(filePath, "utf-8");
-  const parsed = JSON.parse(content);
-  if (typeof parsed !== "object" || parsed === null) {
-    throw new IntorError({
-      id: loggerOptions.id,
-      code: "INTOR_INVALID_MESSAGE_FORMAT" /* INVALID_MESSAGE_FORMAT */,
-      message: "Invalid message format"
-    });
-  }
-  return { fileName, content: parsed };
-};
-
 // src/shared/logger/global-logger-pool.ts
 function getGlobalLoggerPool() {
   if (!globalThis.__INTOR_LOGGER_POOL__) {
@@ -83,13 +56,25 @@ function getLogger({
     });
     pool.set(id, logger);
     if (pool.size > 1e3) {
-      const keys = Array.from(pool.keys());
+      const keys = [...pool.keys()];
       for (const key of keys.slice(0, 200)) pool.delete(key);
     }
   }
   return logger;
 }
 
+// src/shared/error/intor-error.ts
+var IntorError = class extends Error {
+  constructor({ message, code, id }) {
+    const fullMessage = id ? `[${id}] ${message}` : message;
+    super(fullMessage);
+    this.name = "IntorError";
+    this.id = id;
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
 // src/modules/messages/load-local-messages/load-namespace-group/parse-message-file.ts
 var MAX_PATH_LENGTH = 260;
 var parseMessageFile = async (filePath, loggerOptions) => {
@@ -110,9 +95,17 @@ var parseMessageFile = async (filePath, loggerOptions) => {
     return null;
   }
   try {
-    const { content } = await readMessageRecordFile(trimmedPath, loggerOptions);
-    logger.trace(`Message file loaded.`, { filePath: trimmedPath });
-    return content;
+    const content = await fs.readFile(trimmedPath, "utf8");
+    const parsed = JSON.parse(content);
+    if (typeof parsed !== "object" || parsed === null) {
+      throw new IntorError({
+        id: loggerOptions.id,
+        code: "INTOR_INVALID_MESSAGE_FORMAT" /* INVALID_MESSAGE_FORMAT */,
+        message: "Invalid message format"
+      });
+    }
+    logger.trace("Message file loaded.", { filePath: trimmedPath });
+    return parsed;
   } catch (error) {
     logger.warn("Failed to parse message file.", {
       filePath: trimmedPath,
@@ -206,7 +199,7 @@ var addToNamespaceGroup = ({
   const filePathsSet = new Set(group.filePaths);
   if (!filePathsSet.has(filePath)) {
     filePathsSet.add(filePath);
-    group.filePaths = Array.from(filePathsSet);
+    group.filePaths = [...filePathsSet];
     namespaceGroups.set(nsKey, group);
   }
 };
@@ -216,14 +209,15 @@ var traverseDirectory = async ({
   options,
   currentDirPath,
   namespaceGroups,
-  namespacePathSegments
+  namespacePathSegments,
+  readdir = fs.readdir
 }) => {
   const { limit } = options;
   const loggerOptions = options.logger || { id: "default" };
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "traverse-directory" });
   try {
-    const dirents = await fs.readdir(currentDirPath, { withFileTypes: true });
+    const dirents = await readdir(currentDirPath, { withFileTypes: true });
     const dirPromises = dirents.map(
       (dirent) => limit(async () => {
         const filePath = path.join(currentDirPath, dirent.name);
@@ -239,7 +233,8 @@ var traverseDirectory = async ({
             namespaceGroups,
             currentDirPath: filePath,
             namespacePathSegments: [...namespacePathSegments, dirent.name],
-            options
+            options,
+            readdir
           });
         }
       }).catch((error) => {
@@ -314,7 +309,7 @@ var loadSingleLocale = async ({
     namespaceGroups: [...namespaceGroups.entries()].map(([ns, val]) => ({
       namespace: ns,
       isAtRoot: val.isAtRoot,
-      fileCounts: val.filePaths.length
+      fileCount: val.filePaths.length
     }))
   });
   const namespaceGroupTasks = [...namespaceGroups.entries()].filter(
@@ -345,8 +340,8 @@ var loadLocaleWithFallback = async ({
 }) => {
   const baseLogger = getLogger({ ...loggerOptions });
   const logger = baseLogger.child({ scope: "load-locale-with-fallback" });
-  const localesToTry = [targetLocale, ...fallbackLocales];
-  for (const locale of localesToTry) {
+  const candidateLocales = [targetLocale, ...fallbackLocales];
+  for (const locale of candidateLocales) {
     try {
       const validNamespaces = await loadSingleLocale({
         basePath,
@@ -365,7 +360,7 @@ var loadLocaleWithFallback = async ({
     }
   }
   logger.warn("All fallback locales failed.", {
-    attemptedLocales: localesToTry
+    attemptedLocales: candidateLocales
   });
   return;
 };
@@ -382,7 +377,7 @@ function clearMessagesPool() {
 
 // src/shared/utils/merge-messages.ts
 var mergeMessages = (staticMessages = {}, loadedMessages = {}) => {
-  const result = Object.keys(staticMessages).length ? { ...staticMessages } : {};
+  const result = Object.keys(staticMessages).length > 0 ? { ...staticMessages } : {};
   for (const locale in loadedMessages) {
     const loaded = loadedMessages[locale];
     if (!result[locale]) {
@@ -401,7 +396,7 @@ var mergeMessages = (staticMessages = {}, loadedMessages = {}) => {
 var CACHE_KEY_DELIMITER = "|";
 var sanitize = (k) => k.replaceAll(/[\u200B-\u200D\uFEFF]/g, "").replaceAll(/[\r\n]/g, "").trim();
 var normalizeCacheKey = (key, delimiter = CACHE_KEY_DELIMITER) => {
-  if (!key) return null;
+  if (key === null || key === void 0) return null;
   if (Array.isArray(key)) {
     if (key.length === 0) return null;
     const normalized = key.map((k) => {
@@ -425,56 +420,44 @@ var resolveNamespaces = ({
   pathname
 }) => {
   const { loader } = config;
-  const {
-    routeNamespaces = {},
-    namespaces: fallbackNamespaces
-  } = loader;
-  const { unprefixedPathname } = extractPathname({ config, pathname });
-  const standardizedPathname = standardizePathname({
-    config,
-    pathname: unprefixedPathname
-  });
+  const { routeNamespaces = {}, namespaces } = loader || {};
+  const standardizedPathname = standardizePathname({ config, pathname });
   const placeholderRemovedPathname = standardizedPathname.replace(
     `/${PREFIX_PLACEHOLDER}`,
     ""
   );
-  const defaultNamespaces = routeNamespaces.default ?? [];
-  const exactMatchNamespaces = routeNamespaces[standardizedPathname] ?? routeNamespaces[placeholderRemovedPathname];
-  if (exactMatchNamespaces) {
-    return [...defaultNamespaces, ...exactMatchNamespaces];
-  }
-  let bestMatch = "";
-  let bestNamespaces;
+  const collected = [
+    ...routeNamespaces.default || [],
+    // default
+    ...namespaces || [],
+    // default
+    ...routeNamespaces[standardizedPathname] || [],
+    // exact match
+    ...routeNamespaces[placeholderRemovedPathname] || []
+    // exact match
+  ];
   const prefixPatterns = Object.keys(routeNamespaces).filter(
     (pattern) => pattern.endsWith("/*")
   );
   for (const pattern of prefixPatterns) {
     const basePath = pattern.replace(/\/\*$/, "");
-    if (standardizedPathname.startsWith(basePath)) {
-      if (basePath.length > bestMatch.length) {
-        bestMatch = basePath;
-        bestNamespaces = routeNamespaces[pattern];
-      }
+    if (standardizedPathname.startsWith(basePath) || placeholderRemovedPathname.startsWith(basePath)) {
+      collected.push(...routeNamespaces[pattern] || []);
     }
   }
-  const matchedNamespaces = bestNamespaces ?? routeNamespaces["/*"] ?? fallbackNamespaces ?? [];
-  if (matchedNamespaces.length > 0) {
-    return [...defaultNamespaces, ...matchedNamespaces];
-  } else {
-    return [...defaultNamespaces];
-  }
+  return [...new Set(collected)];
 };
 
 // src/shared/utils/locale/normalize-locale.ts
+var toCanonical = (input) => {
+  try {
+    return Intl.getCanonicalLocales(input)[0]?.toLowerCase();
+  } catch {
+    return;
+  }
+};
 var normalizeLocale = (locale = "", supportedLocales = []) => {
   if (!locale || supportedLocales.length === 0) return;
-  const toCanonical = (input) => {
-    try {
-      return Intl.getCanonicalLocales(input)[0]?.toLowerCase();
-    } catch {
-      return;
-    }
-  };
   const canonicalLocale = toCanonical(locale);
   if (!canonicalLocale) return;
   const supportedCanonicalMap = /* @__PURE__ */ new Map();
@@ -505,12 +488,12 @@ var resolvePreferredLocale = (acceptLanguageHeader, supportedLocales) => {
   const supportedLocalesSet = new Set(supportedLocales);
   const preferred = acceptLanguageHeader.split(",").map((part) => {
     const [lang, qValue] = part.split(";");
-    const q = qValue ? parseFloat(qValue.split("=")[1]) : 1;
-    if (isNaN(q)) {
+    const q = qValue ? Number.parseFloat(qValue.split("=")[1]) : 1;
+    if (Number.isNaN(q)) {
       return { lang: lang.trim(), q: 0 };
     }
     return { lang: lang.trim(), q };
-  }).sort((a, b) => b.q - a.q).find(({ lang }) => supportedLocalesSet.has(lang))?.lang;
+  }).toSorted((a, b) => b.q - a.q).find(({ lang }) => supportedLocalesSet.has(lang))?.lang;
   return preferred;
 };
 
@@ -519,8 +502,8 @@ var normalizePathname = (rawPathname, options = {}) => {
   const length = rawPathname.length;
   let start = 0;
   let end = length - 1;
-  while (start <= end && rawPathname.charCodeAt(start) <= 32) start++;
-  while (end >= start && rawPathname.charCodeAt(end) <= 32) end--;
+  while (start <= end && (rawPathname.codePointAt(start) ?? 0) <= 32) start++;
+  while (end >= start && (rawPathname.codePointAt(end) ?? 0) <= 32) end--;
   if (start > end) return "/";
   let result = "";
   let hasSlash = false;
@@ -531,11 +514,7 @@ var normalizePathname = (rawPathname, options = {}) => {
         hasSlash = true;
       }
     } else {
-      if (hasSlash || result === "") {
-        result += "/" + char;
-      } else {
-        result += char;
-      }
+      result += hasSlash || result === "" ? "/" + char : char;
       hasSlash = false;
     }
   }
@@ -559,8 +538,8 @@ var extractPathname = ({
   } else if (basePath && normalizedPathname === basePath) {
     prefixedPathname = "/";
   }
-  const pathParts = prefixedPathname.split("/").filter(Boolean);
-  const maybeLocale = pathParts[0] || "";
+  const pathPart = prefixedPathname.split("/").find(Boolean);
+  const maybeLocale = pathPart || "";
   const isLocalePrefixed = config.supportedLocales?.includes(maybeLocale);
   let unprefixedPathname = prefixedPathname;
   if (prefix === "all") {
@@ -593,7 +572,7 @@ var standardizePathname = ({
     PREFIX_PLACEHOLDER,
     normalizePathname(pathname)
   ];
-  const standardizedPathname = parts.join("/").replace(/\/{2,}/g, "/");
+  const standardizedPathname = parts.join("/").replaceAll(/\/{2,}/g, "/");
   return normalizePathname(standardizedPathname);
 };
 
@@ -632,8 +611,8 @@ var loadLocalMessages = async ({
     loggerOptions.id,
     resolvedBasePath,
     locale,
-    [...fallbackLocales ?? []].sort().join(","),
-    [...namespaces ?? []].sort().join(",")
+    (fallbackLocales ?? []).toSorted().join(","),
+    (namespaces ?? []).toSorted().join(",")
   ]);
   if (cache.enabled && key) {
     const cached = await pool?.get(key);
@@ -778,8 +757,8 @@ var loadApiMessages = async ({
     loggerOptions.id,
     basePath,
     locale,
-    [...fallbackLocales ?? []].sort().join(","),
-    [...namespaces ?? []].sort().join(",")
+    (fallbackLocales ?? []).toSorted().join(","),
+    (namespaces ?? []).toSorted().join(",")
   ]);
   if (cache.enabled && key) {
     const cached = await pool?.get(key);
@@ -841,7 +820,7 @@ var loadMessages = async ({
     );
     return;
   }
-  const { loader } = config;
+  const { id, loader, cache } = config;
   const fallbackLocales = config.fallbackLocales[locale] || [];
   const namespaces = resolveNamespaces({ config, pathname });
   logger.debug("Namespaces ready for loading.", {
@@ -856,8 +835,8 @@ var loadMessages = async ({
       locale,
       fallbackLocales,
       namespaces,
-      cache: config.cache,
-      logger: { id: config.id }
+      cache,
+      logger: { id }
     });
   } else if (loader.type === "api") {
     loadedMessages = await loadApiMessages({
@@ -865,7 +844,7 @@ var loadMessages = async ({
       locale,
       fallbackLocales,
       namespaces,
-      logger: { id: config.id }
+      logger: { id }
     });
   }
   if (!loadedMessages || Object.keys(loadedMessages).length === 0) {
@@ -881,15 +860,10 @@ var intor = async (config, i18nContext) => {
   logger.info("Start Intor initialization.");
   const { messages, loader } = config;
   const isI18nContextFunction = typeof i18nContext === "function";
-  let context;
-  if (isI18nContextFunction) {
-    context = await i18nContext(config);
-  } else {
-    context = {
-      locale: i18nContext?.locale || config.defaultLocale,
-      pathname: i18nContext?.pathname || ""
-    };
-  }
+  const context = isI18nContextFunction ? await i18nContext(config) : {
+    locale: i18nContext?.locale || config.defaultLocale,
+    pathname: i18nContext?.pathname || ""
+  };
   const { locale, pathname } = context;
   const source = isI18nContextFunction ? "[function]" : "[static object]";
   logger.debug(`Context resolved via ${source}.`, context);
@@ -914,29 +888,23 @@ var intor = async (config, i18nContext) => {
   };
 };
 async function getTranslator(opts) {
-  const { config, locale, pathname = "", preKey } = opts;
+  const { config, locale, pathname = "", preKey, handlers } = opts;
   const messages = await loadMessages({ config, locale, pathname });
   const translator = new Translator({
     locale,
     messages,
     fallbackLocales: config.fallbackLocales,
     loadingMessage: config.translator?.loadingMessage,
-    placeholder: config.translator?.placeholder
+    placeholder: config.translator?.placeholder,
+    handlers
   });
-  const props = {
-    messages,
-    locale
+  const props = { messages, locale };
+  const scoped = translator.scoped(preKey);
+  return {
+    ...props,
+    hasKey: preKey ? scoped.hasKey : translator.hasKey,
+    t: preKey ? scoped.t : translator.t
   };
-  if (preKey) {
-    const scoped = translator.scoped(preKey);
-    return { ...props, ...scoped };
-  } else {
-    return {
-      ...props,
-      t: translator.t,
-      hasKey: translator.hasKey
-    };
-  }
 }
 
 export { PREFIX_PLACEHOLDER, clearLoggerPool, clearMessagesPool, extractPathname, getTranslator, intor, loadApiMessages, loadLocalMessages, loadMessages, mergeMessages, normalizeCacheKey, normalizeLocale, normalizePathname, resolveNamespaces, resolvePreferredLocale, standardizePathname };