@hua-labs/i18n-loaders 1.0.0 → 1.1.0-alpha.0.1

package/src/preload.ts

@@ -1,64 +1,64 @@
-import { PreloadOptions, TranslationLoader } from './types';
-
-const defaultLogger = console;
-
-export async function preloadNamespaces(
-  language: string,
-  namespaces: string[],
-  loader: TranslationLoader,
-  options: PreloadOptions = {}
-) {
-  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 is PromiseFulfilledResult<string> =>
-      result.status === 'fulfilled'
-  );
-  const rejected = results.filter(
-    (result): result is PromiseRejectedResult => 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)
-  };
-}
-
-export async function warmFallbackLanguages(
-  currentLanguage: string,
-  languages: string[],
-  namespaces: string[],
-  loader: TranslationLoader,
-  options: PreloadOptions = {}
-) {
-  const targets = languages.filter((language) => language !== currentLanguage);
-  if (targets.length === 0) {
-    return [];
-  }
-
-  return Promise.all(
-    targets.map((language) =>
-      preloadNamespaces(language, namespaces, loader, options)
-    )
-  );
-}
-
+import { PreloadOptions, TranslationLoader } from './types';
+
+const defaultLogger = console;
+
+export async function preloadNamespaces(
+  language: string,
+  namespaces: string[],
+  loader: TranslationLoader,
+  options: PreloadOptions = {}
+) {
+  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 is PromiseFulfilledResult<string> =>
+      result.status === 'fulfilled'
+  );
+  const rejected = results.filter(
+    (result): result is PromiseRejectedResult => 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)
+  };
+}
+
+export async function warmFallbackLanguages(
+  currentLanguage: string,
+  languages: string[],
+  namespaces: string[],
+  loader: TranslationLoader,
+  options: PreloadOptions = {}
+) {
+  const targets = languages.filter((language) => language !== currentLanguage);
+  if (targets.length === 0) {
+    return [];
+  }
+
+  return Promise.all(
+    targets.map((language) =>
+      preloadNamespaces(language, namespaces, loader, options)
+    )
+  );
+}
+

package/src/types.ts

@@ -1,34 +1,56 @@
-export type TranslationRecord = Record<string, unknown>;
-
-export type TranslationLoader = (
-  language: string,
-  namespace: string
-) => Promise<TranslationRecord>;
-
-export 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;
-}
-
-export interface PreloadOptions {
-  logger?: Pick<typeof console, 'log' | 'warn'>;
-  suppressErrors?: boolean;
-}
-
-export type DefaultTranslations = Record<
-  string,
-  Record<string, TranslationRecord>
->;
-
+export type TranslationRecord = Record<string, unknown>;
+
+export type TranslationLoader = (
+  language: string,
+  namespace: string
+) => Promise<TranslationRecord>;
+
+/**
+ * 캐시 무효화 함수 타입
+ */
+export interface CacheInvalidation {
+  /**
+   * 특정 언어/네임스페이스의 캐시 무효화
+   * @param language - 언어 코드 (선택적, 없으면 모든 언어)
+   * @param namespace - 네임스페이스 (선택적, 없으면 모든 네임스페이스)
+   */
+  invalidate?: (language?: string, namespace?: string) => void;
+  /**
+   * 전체 캐시 클리어
+   */
+  clear?: () => void;
+}
+
+export 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;
+}
+
+export interface PreloadOptions {
+  logger?: Pick<typeof console, 'log' | 'warn'>;
+  suppressErrors?: boolean;
+}
+
+export type DefaultTranslations = Record<
+  string,
+  Record<string, TranslationRecord>
+>;
+