@hua-labs/i18n-loaders 2.0.5 → 2.1.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@hua-labs/i18n-loaders",
-  "version": "2.0.5",
+  "version": "2.1.0",
   "description": "Production-ready loaders, caching, and preloading helpers for @hua-labs/i18n-core.",
-  "main": "./dist/index.js",
+  "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "files": [
@@ -13,7 +13,7 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "default": "./dist/index.mjs"
     }
   },
   "sideEffects": false,
@@ -21,15 +21,15 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@hua-labs/i18n-core": "latest"
+    "@hua-labs/i18n-core": "2.1.0"
   },
   "peerDependencies": {
     "react": ">=19.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.2.0",
+    "@types/node": "^25.3.0",
     "@types/react": "^19.2.14",
-    "eslint": "^10.0.0",
+    "eslint": "^10.0.1",
     "react": "^19.2.4",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",

package/dist/index.d.ts

@@ -1,80 +0,0 @@
-type TranslationRecord = Record<string, unknown>;
-type TranslationLoader = (language: string, namespace: string) => Promise<TranslationRecord>;
-/**
- * 캐시 무효화 함수 타입
- */
-interface CacheInvalidation {
-    /**
-     * 특정 언어/네임스페이스의 캐시 무효화
-     * @param language - 언어 코드 (선택적, 없으면 모든 언어)
-     * @param namespace - 네임스페이스 (선택적, 없으면 모든 네임스페이스)
-     */
-    invalidate?: (language?: string, namespace?: string) => void;
-    /**
-     * 전체 캐시 클리어
-     */
-    clear?: () => void;
-}
-interface ApiLoaderOptions {
-    translationApiPath?: string;
-    baseUrl?: string;
-    localFallbackBaseUrl?: string;
-    cacheTtlMs?: number;
-    disableCache?: boolean;
-    requestInit?: RequestInit | ((language: string, namespace: string) => RequestInit | undefined);
-    fetcher?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
-    logger?: Pick<typeof console, 'log' | 'warn' | 'error'>;
-    /** 재시도 횟수 (기본값: 0, 재시도 안 함) */
-    retryCount?: number;
-    /** 재시도 지연 시간 (밀리초, 기본값: 1000) */
-    retryDelay?: number;
-    /**
-     * 개발 모드에서 자동 캐시 무효화
-     * 기본값: true (개발 모드에서만)
-     * 개발 중 번역 파일 변경 시 캐시를 자동으로 무효화하여 최신 번역을 즉시 반영
-     */
-    autoInvalidateInDev?: boolean;
-}
-interface PreloadOptions {
-    logger?: Pick<typeof console, 'log' | 'warn'>;
-    suppressErrors?: boolean;
-}
-type DefaultTranslations = Record<string, Record<string, TranslationRecord>>;
-
-/**
- * API 기반 번역 로더 생성
- *
- * @param options - 로더 옵션
- * @returns 번역 로더 및 캐시 무효화 함수
- *
- * @example
- * ```typescript
- * const { loader, invalidate, clear } = createApiTranslationLoader({
- *   translationApiPath: '/api/translations',
- *   autoInvalidateInDev: true
- * });
- *
- * // 특정 언어/네임스페이스 무효화
- * invalidate('ko', 'common');
- *
- * // 전체 캐시 클리어
- * clear();
- * ```
- */
-declare function createApiTranslationLoader(options?: ApiLoaderOptions): TranslationLoader & {
-    invalidate: (language?: string, namespace?: string) => void;
-    clear: () => void;
-};
-
-declare function preloadNamespaces(language: string, namespaces: string[], loader: TranslationLoader, options?: PreloadOptions): Promise<{
-    fulfilled: string[];
-    rejected: any[];
-}>;
-declare function warmFallbackLanguages(currentLanguage: string, languages: string[], namespaces: string[], loader: TranslationLoader, options?: PreloadOptions): Promise<{
-    fulfilled: string[];
-    rejected: any[];
-}[]>;
-
-declare function withDefaultTranslations(loader: TranslationLoader, defaults: DefaultTranslations): TranslationLoader;
-
-export { type ApiLoaderOptions, type CacheInvalidation, type DefaultTranslations, type PreloadOptions, type TranslationLoader, type TranslationRecord, createApiTranslationLoader, preloadNamespaces, warmFallbackLanguages, withDefaultTranslations };

package/dist/index.js

@@ -1,272 +0,0 @@
-'use strict';
-
-// src/api-loader.ts
-var FIVE_MINUTES = 5 * 60 * 1e3;
-var defaultFetcher = (input, init) => fetch(input, init);
-function isRetryableError(error) {
-  if (error instanceof TypeError) {
-    return true;
-  }
-  if (error instanceof Error) {
-    const message = error.message.toLowerCase();
-    if (message.includes("failed to fetch") || message.includes("networkerror") || message.includes("network request failed")) {
-      return true;
-    }
-  }
-  if (error && typeof error === "object" && "status" in error) {
-    const status = error.status;
-    if (status >= 500 && status < 600) {
-      return true;
-    }
-    if (status === 408) {
-      return true;
-    }
-  }
-  return false;
-}
-function createApiTranslationLoader(options = {}) {
-  const translationApiPath = options.translationApiPath ?? "/api/translations";
-  const cacheTtlMs = options.cacheTtlMs ?? FIVE_MINUTES;
-  const fetcher = options.fetcher ?? defaultFetcher;
-  const logger = options.logger ?? console;
-  const retryCount = options.retryCount ?? 0;
-  const retryDelay = options.retryDelay ?? 1e3;
-  const autoInvalidateInDev = options.autoInvalidateInDev ?? (typeof process !== "undefined" && process.env.NODE_ENV === "development");
-  const localCache = /* @__PURE__ */ new Map();
-  const inFlightRequests = /* @__PURE__ */ new Map();
-  const buildUrl = (language, namespace) => {
-    const safeNamespace = namespace.replace(/[^a-zA-Z0-9-_]/g, "");
-    const path = `${translationApiPath}/${language}/${safeNamespace}`;
-    if (typeof window !== "undefined") {
-      return path;
-    }
-    if (options.baseUrl) {
-      return `${options.baseUrl}${path}`;
-    }
-    if (process.env.NEXT_PUBLIC_SITE_URL) {
-      return `${process.env.NEXT_PUBLIC_SITE_URL}${path}`;
-    }
-    if (process.env.VERCEL_URL) {
-      const vercelUrl = process.env.VERCEL_URL.startsWith("http") ? process.env.VERCEL_URL : `https://${process.env.VERCEL_URL}`;
-      return `${vercelUrl}${path}`;
-    }
-    const fallbackBase = options.localFallbackBaseUrl ?? "http://localhost:3000";
-    return `${fallbackBase}${path}`;
-  };
-  const getRequestInit = (language, namespace) => {
-    if (typeof options.requestInit === "function") {
-      return options.requestInit(language, namespace) ?? {};
-    }
-    return options.requestInit ?? {};
-  };
-  const getCached = (cacheKey) => {
-    if (options.disableCache) {
-      return null;
-    }
-    const entry = localCache.get(cacheKey);
-    if (!entry) {
-      return null;
-    }
-    if (entry.expiresAt < Date.now()) {
-      localCache.delete(cacheKey);
-      return null;
-    }
-    return entry.data;
-  };
-  const setCached = (cacheKey, data) => {
-    if (options.disableCache) {
-      return;
-    }
-    localCache.set(cacheKey, {
-      data,
-      expiresAt: Date.now() + cacheTtlMs
-    });
-  };
-  const loadTranslations = async (language, namespace) => {
-    const cacheKey = `${language}:${namespace}`;
-    const cached = getCached(cacheKey);
-    if (cached) {
-      return cached;
-    }
-    const inFlight = inFlightRequests.get(cacheKey);
-    if (inFlight) {
-      return inFlight;
-    }
-    const url = buildUrl(language, namespace);
-    const requestInit = getRequestInit(language, namespace);
-    const performRequest = async (attempt) => {
-      try {
-        const response = await fetcher(url, {
-          cache: "no-store",
-          ...requestInit
-        });
-        if (!response.ok) {
-          throw new Error(
-            `[i18n-loaders] Failed to load ${language}/${namespace} (${response.status})`
-          );
-        }
-        const data = await response.json();
-        setCached(cacheKey, data);
-        return data;
-      } catch (error) {
-        const isRetryable = isRetryableError(error);
-        if (isRetryable && attempt < retryCount) {
-          logger.warn?.(
-            `[i18n-loaders] Translation fetch failed (attempt ${attempt + 1}/${retryCount + 1}), retrying...`,
-            language,
-            namespace,
-            error
-          );
-          const delay = retryDelay * Math.pow(2, attempt);
-          await new Promise((resolve) => setTimeout(resolve, delay));
-          return performRequest(attempt + 1);
-        }
-        logger.warn?.(
-          "[i18n-loaders] translation fetch failed",
-          language,
-          namespace,
-          error
-        );
-        throw error;
-      }
-    };
-    const requestPromise = performRequest(0).finally(() => {
-      inFlightRequests.delete(cacheKey);
-    });
-    inFlightRequests.set(cacheKey, requestPromise);
-    return requestPromise;
-  };
-  const invalidate = (language, namespace) => {
-    if (language && namespace) {
-      const cacheKey = `${language}:${namespace}`;
-      localCache.delete(cacheKey);
-      logger.log?.("[i18n-loaders] Cache invalidated:", cacheKey);
-    } else if (language) {
-      const prefix = `${language}:`;
-      for (const key of localCache.keys()) {
-        if (key.startsWith(prefix)) {
-          localCache.delete(key);
-        }
-      }
-      logger.log?.("[i18n-loaders] Cache invalidated for language:", language);
-    } else if (namespace) {
-      const suffix = `:${namespace}`;
-      for (const key of localCache.keys()) {
-        if (key.endsWith(suffix)) {
-          localCache.delete(key);
-        }
-      }
-      logger.log?.("[i18n-loaders] Cache invalidated for namespace:", namespace);
-    } else {
-      clear();
-    }
-  };
-  const clear = () => {
-    localCache.clear();
-    logger.log?.("[i18n-loaders] Cache cleared");
-  };
-  if (autoInvalidateInDev && typeof window !== "undefined") {
-    window.addEventListener("focus", () => {
-      if (process.env.NODE_ENV === "development") {
-        logger.log?.("[i18n-loaders] Development mode: Auto-invalidating cache on focus");
-        clear();
-      }
-    });
-  }
-  const loader = loadTranslations;
-  loader.invalidate = invalidate;
-  loader.clear = clear;
-  return loader;
-}
-
-// src/preload.ts
-var defaultLogger = console;
-async function preloadNamespaces(language, namespaces, loader, options = {}) {
-  const logger = options.logger ?? defaultLogger;
-  const results = await Promise.allSettled(
-    namespaces.map(async (namespace) => {
-      await loader(language, namespace);
-      return namespace;
-    })
-  );
-  const fulfilled = results.filter(
-    (result) => result.status === "fulfilled"
-  );
-  const rejected = results.filter(
-    (result) => result.status === "rejected"
-  );
-  if (fulfilled.length > 0) {
-    logger.log?.(
-      `[i18n-loaders] Preloaded ${fulfilled.length}/${namespaces.length} namespaces for ${language}`
-    );
-  }
-  if (rejected.length > 0 && !options.suppressErrors) {
-    logger.warn?.(
-      `[i18n-loaders] Failed to preload ${rejected.length} namespaces for ${language}`
-    );
-  }
-  return {
-    fulfilled: fulfilled.map((result) => result.value),
-    rejected: rejected.map((result) => result.reason)
-  };
-}
-async function warmFallbackLanguages(currentLanguage, languages, namespaces, loader, options = {}) {
-  const targets = languages.filter((language) => language !== currentLanguage);
-  if (targets.length === 0) {
-    return [];
-  }
-  return Promise.all(
-    targets.map(
-      (language) => preloadNamespaces(language, namespaces, loader, options)
-    )
-  );
-}
-
-// src/defaults.ts
-function withDefaultTranslations(loader, defaults) {
-  return async (language, namespace) => {
-    const fallback = defaults[language]?.[namespace];
-    try {
-      const remote = await loader(language, namespace);
-      if (!remote || typeof remote === "object" && Object.keys(remote).length === 0) {
-        if (fallback) {
-          return fallback;
-        }
-        return remote || {};
-      }
-      if (!fallback) {
-        return remote;
-      }
-      return mergeTranslations(fallback, remote);
-    } catch (error) {
-      if (fallback) {
-        return fallback;
-      }
-      throw error;
-    }
-  };
-}
-function mergeTranslations(base, override) {
-  const result = { ...base };
-  for (const [key, value] of Object.entries(override)) {
-    if (isPlainObject(value) && isPlainObject(result[key])) {
-      result[key] = mergeTranslations(
-        result[key],
-        value
-      );
-      continue;
-    }
-    result[key] = value;
-  }
-  return result;
-}
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-exports.createApiTranslationLoader = createApiTranslationLoader;
-exports.preloadNamespaces = preloadNamespaces;
-exports.warmFallbackLanguages = warmFallbackLanguages;
-exports.withDefaultTranslations = withDefaultTranslations;
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/api-loader.ts","../src/preload.ts","../src/defaults.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { ApiLoaderOptions, TranslationLoader, TranslationRecord } from './types';\n\ninterface CacheEntry {\n  data: TranslationRecord;\n  expiresAt: number;\n}\n\nconst FIVE_MINUTES = 5 * 60 * 1000;\n\nconst defaultFetcher = (input: RequestInfo | URL, init?: RequestInit) =>\n  fetch(input, init);\n\n/**\n * 재시도 가능한 에러인지 확인\n */\nfunction isRetryableError(error: unknown): boolean {\n  // 네트워크 에러 (TypeError)\n  if (error instanceof TypeError) {\n    return true;\n  }\n\n  // Fetch API 에러 메시지 확인\n  if (error instanceof Error) {\n    const message = error.message.toLowerCase();\n    if (\n      message.includes('failed to fetch') ||\n      message.includes('networkerror') ||\n      message.includes('network request failed')\n    ) {\n      return true;\n    }\n  }\n\n  // Response 객체가 있는 경우 HTTP 상태 코드 확인\n  if (error && typeof error === 'object' && 'status' in error) {\n    const status = (error as { status: number }).status;\n    // 5xx 서버 에러는 재시도 가능\n    if (status >= 500 && status < 600) {\n      return true;\n    }\n    // 408 Request Timeout도 재시도 가능\n    if (status === 408) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * API 기반 번역 로더 생성\n * \n * @param options - 로더 옵션\n * @returns 번역 로더 및 캐시 무효화 함수\n * \n * @example\n * ```typescript\n * const { loader, invalidate, clear } = createApiTranslationLoader({\n *   translationApiPath: '/api/translations',\n *   autoInvalidateInDev: true\n * });\n * \n * // 특정 언어/네임스페이스 무효화\n * invalidate('ko', 'common');\n * \n * // 전체 캐시 클리어\n * clear();\n * ```\n */\nexport function createApiTranslationLoader(\n  options: ApiLoaderOptions = {}\n): TranslationLoader & { invalidate: (language?: string, namespace?: string) => void; clear: () => void } {\n  const translationApiPath = options.translationApiPath ?? '/api/translations';\n  const cacheTtlMs = options.cacheTtlMs ?? FIVE_MINUTES;\n  const fetcher = options.fetcher ?? defaultFetcher;\n  const logger = options.logger ?? console;\n  const retryCount = options.retryCount ?? 0;\n  const retryDelay = options.retryDelay ?? 1000;\n  const autoInvalidateInDev = options.autoInvalidateInDev ?? (typeof process !== 'undefined' && process.env.NODE_ENV === 'development');\n  const localCache = new Map<string, CacheEntry>();\n  const inFlightRequests = new Map<string, Promise<TranslationRecord>>();\n\n  const buildUrl = (language: string, namespace: string) => {\n    const safeNamespace = namespace.replace(/[^a-zA-Z0-9-_]/g, '');\n    const path = `${translationApiPath}/${language}/${safeNamespace}`;\n\n    if (typeof window !== 'undefined') {\n      return path;\n    }\n\n    if (options.baseUrl) {\n      return `${options.baseUrl}${path}`;\n    }\n\n    if (process.env.NEXT_PUBLIC_SITE_URL) {\n      return `${process.env.NEXT_PUBLIC_SITE_URL}${path}`;\n    }\n\n    if (process.env.VERCEL_URL) {\n      const vercelUrl = process.env.VERCEL_URL.startsWith('http')\n        ? process.env.VERCEL_URL\n        : `https://${process.env.VERCEL_URL}`;\n      return `${vercelUrl}${path}`;\n    }\n\n    const fallbackBase = options.localFallbackBaseUrl ?? 'http://localhost:3000';\n    return `${fallbackBase}${path}`;\n  };\n\n  const getRequestInit = (language: string, namespace: string): RequestInit => {\n    if (typeof options.requestInit === 'function') {\n      return options.requestInit(language, namespace) ?? {};\n    }\n\n    return options.requestInit ?? {};\n  };\n\n  const getCached = (cacheKey: string) => {\n    if (options.disableCache) {\n      return null;\n    }\n\n    const entry = localCache.get(cacheKey);\n    if (!entry) {\n      return null;\n    }\n\n    if (entry.expiresAt < Date.now()) {\n      localCache.delete(cacheKey);\n      return null;\n    }\n\n    return entry.data;\n  };\n\n  const setCached = (cacheKey: string, data: TranslationRecord) => {\n    if (options.disableCache) {\n      return;\n    }\n\n    localCache.set(cacheKey, {\n      data,\n      expiresAt: Date.now() + cacheTtlMs\n    });\n  };\n\n  const loadTranslations: TranslationLoader = async (language, namespace) => {\n    const cacheKey = `${language}:${namespace}`;\n    const cached = getCached(cacheKey);\n\n    if (cached) {\n      return cached;\n    }\n\n    const inFlight = inFlightRequests.get(cacheKey);\n    if (inFlight) {\n      return inFlight;\n    }\n\n    const url = buildUrl(language, namespace);\n    const requestInit = getRequestInit(language, namespace);\n\n    const performRequest = async (attempt: number): Promise<TranslationRecord> => {\n      try {\n        const response = await fetcher(url, {\n          cache: 'no-store',\n          ...requestInit\n        });\n\n        if (!response.ok) {\n          throw new Error(\n            `[i18n-loaders] Failed to load ${language}/${namespace} (${response.status})`\n          );\n        }\n\n        const data = (await response.json()) as TranslationRecord;\n        setCached(cacheKey, data);\n        return data;\n      } catch (error) {\n        // 재시도 가능한 에러인지 확인\n        const isRetryable = isRetryableError(error);\n\n        if (isRetryable && attempt < retryCount) {\n          logger.warn?.(\n            `[i18n-loaders] Translation fetch failed (attempt ${attempt + 1}/${retryCount + 1}), retrying...`,\n            language,\n            namespace,\n            error\n          );\n          \n          // 지수 백오프: 각 재시도마다 지연 시간 증가\n          const delay = retryDelay * Math.pow(2, attempt);\n          await new Promise(resolve => setTimeout(resolve, delay));\n          \n          return performRequest(attempt + 1);\n        }\n\n        // 재시도 불가능하거나 재시도 횟수 초과\n        logger.warn?.(\n          '[i18n-loaders] translation fetch failed',\n          language,\n          namespace,\n          error\n        );\n        throw error;\n      }\n    };\n\n    const requestPromise = performRequest(0)\n      .finally(() => {\n        inFlightRequests.delete(cacheKey);\n      });\n\n    inFlightRequests.set(cacheKey, requestPromise);\n    return requestPromise;\n  };\n\n  /**\n   * 특정 언어/네임스페이스의 캐시 무효화\n   */\n  const invalidate = (language?: string, namespace?: string) => {\n    if (language && namespace) {\n      // 특정 언어/네임스페이스만 무효화\n      const cacheKey = `${language}:${namespace}`;\n      localCache.delete(cacheKey);\n      logger.log?.('[i18n-loaders] Cache invalidated:', cacheKey);\n    } else if (language) {\n      // 특정 언어의 모든 네임스페이스 무효화\n      const prefix = `${language}:`;\n      for (const key of localCache.keys()) {\n        if (key.startsWith(prefix)) {\n          localCache.delete(key);\n        }\n      }\n      logger.log?.('[i18n-loaders] Cache invalidated for language:', language);\n    } else if (namespace) {\n      // 특정 네임스페이스의 모든 언어 무효화\n      const suffix = `:${namespace}`;\n      for (const key of localCache.keys()) {\n        if (key.endsWith(suffix)) {\n          localCache.delete(key);\n        }\n      }\n      logger.log?.('[i18n-loaders] Cache invalidated for namespace:', namespace);\n    } else {\n      // 전체 캐시 무효화\n      clear();\n    }\n  };\n\n  /**\n   * 전체 캐시 클리어\n   */\n  const clear = () => {\n    localCache.clear();\n    logger.log?.('[i18n-loaders] Cache cleared');\n  };\n\n  // 개발 모드에서 자동 무효화 설정\n  if (autoInvalidateInDev && typeof window !== 'undefined') {\n    // 개발 모드에서 페이지 포커스 시 캐시 무효화 (번역 파일 변경 감지)\n    window.addEventListener('focus', () => {\n      if (process.env.NODE_ENV === 'development') {\n        logger.log?.('[i18n-loaders] Development mode: Auto-invalidating cache on focus');\n        clear();\n      }\n    });\n  }\n\n  // loadTranslations 함수에 invalidate와 clear 메서드 추가\n  const loader = loadTranslations as TranslationLoader & {\n    invalidate: (language?: string, namespace?: string) => void;\n    clear: () => void;\n  };\n  \n  loader.invalidate = invalidate;\n  loader.clear = clear;\n\n  return loader;\n}\n\n","import { PreloadOptions, TranslationLoader } from './types';\n\nconst defaultLogger = console;\n\nexport async function preloadNamespaces(\n  language: string,\n  namespaces: string[],\n  loader: TranslationLoader,\n  options: PreloadOptions = {}\n) {\n  const logger = options.logger ?? defaultLogger;\n\n  const results = await Promise.allSettled(\n    namespaces.map(async (namespace) => {\n      await loader(language, namespace);\n      return namespace;\n    })\n  );\n\n  const fulfilled = results.filter(\n    (result): result is PromiseFulfilledResult<string> =>\n      result.status === 'fulfilled'\n  );\n  const rejected = results.filter(\n    (result): result is PromiseRejectedResult => result.status === 'rejected'\n  );\n\n  if (fulfilled.length > 0) {\n    logger.log?.(\n      `[i18n-loaders] Preloaded ${fulfilled.length}/${namespaces.length} namespaces for ${language}`\n    );\n  }\n\n  if (rejected.length > 0 && !options.suppressErrors) {\n    logger.warn?.(\n      `[i18n-loaders] Failed to preload ${rejected.length} namespaces for ${language}`\n    );\n  }\n\n  return {\n    fulfilled: fulfilled.map((result) => result.value),\n    rejected: rejected.map((result) => result.reason)\n  };\n}\n\nexport async function warmFallbackLanguages(\n  currentLanguage: string,\n  languages: string[],\n  namespaces: string[],\n  loader: TranslationLoader,\n  options: PreloadOptions = {}\n) {\n  const targets = languages.filter((language) => language !== currentLanguage);\n  if (targets.length === 0) {\n    return [];\n  }\n\n  return Promise.all(\n    targets.map((language) =>\n      preloadNamespaces(language, namespaces, loader, options)\n    )\n  );\n}\n\n","import {\n  DefaultTranslations,\n  TranslationLoader,\n  TranslationRecord\n} from './types';\n\nexport function withDefaultTranslations(\n  loader: TranslationLoader,\n  defaults: DefaultTranslations\n): TranslationLoader {\n  return async (language, namespace) => {\n    const fallback = defaults[language]?.[namespace];\n\n    try {\n      const remote = await loader(language, namespace);\n      \n      // API 응답이 빈 객체이거나 null/undefined인 경우 fallback 반환\n      if (!remote || (typeof remote === 'object' && Object.keys(remote).length === 0)) {\n        if (fallback) {\n          return fallback;\n        }\n        return remote || {};\n      }\n      \n      if (!fallback) {\n        return remote;\n      }\n\n      return mergeTranslations(fallback, remote);\n    } catch (error) {\n      if (fallback) {\n        return fallback;\n      }\n      throw error;\n    }\n  };\n}\n\nfunction mergeTranslations(\n  base: TranslationRecord,\n  override: TranslationRecord\n): TranslationRecord {\n  const result: TranslationRecord = { ...base };\n\n  for (const [key, value] of Object.entries(override)) {\n    if (isPlainObject(value) && isPlainObject(result[key])) {\n      result[key] = mergeTranslations(\n        result[key] as TranslationRecord,\n        value as TranslationRecord\n      );\n      continue;\n    }\n\n    result[key] = value;\n  }\n\n  return result;\n}\n\nfunction isPlainObject(value: unknown): value is TranslationRecord {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n"]}