@withwiz/toolkit 0.2.8 → 0.3.1

package/dist/auth/config.d.ts

@@ -0,0 +1,16 @@
+export interface AuthConfig {
+    jwtSecret: string;
+    accessTokenExpiry?: string;
+    refreshTokenExpiry?: string;
+}
+export interface ResolvedAuthConfig {
+    jwtSecret: string;
+    accessTokenExpiry: string;
+    refreshTokenExpiry: string;
+}
+declare global {
+    var __withwiz_auth_config: ResolvedAuthConfig | undefined;
+}
+export declare function initializeAuth(config: AuthConfig): void;
+export declare function getAuthConfig(): ResolvedAuthConfig;
+export declare function resetAuth(): void;

package/dist/auth/config.js

@@ -0,0 +1,13 @@
+import {
+  getAuthConfig,
+  initializeAuth,
+  resetAuth
+} from "../chunk-OZE5KUS3.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
+import "../chunk-ORMEWXMH.js";
+export {
+  getAuthConfig,
+  initializeAuth,
+  resetAuth
+};

package/dist/auth/index.js

@@ -1,24 +1,9 @@
-import {
-  OAuthManager
-} from "../chunk-V5K5FYU7.js";
-import {
-  DEFAULT_PASSWORD_CONFIG,
-  createPasswordHasher,
-  createPasswordSchema,
-  createPasswordValidator,
-  getPasswordStrength,
-  passwordValidator,
-  validatePassword
-} from "../chunk-G26T2PRQ.js";
-import {
-  PasswordHasher,
-  PasswordValidator,
-  defaultPasswordSchema,
-  strongPasswordSchema
-} from "../chunk-IHXRF3BH.js";
 import {
   TokenGenerator
 } from "../chunk-GDWEDUHO.js";
+import {
+  OAuthManager
+} from "../chunk-V5K5FYU7.js";
 import {
   JWTClientManager,
   clearStoredTokens,
@@ -35,6 +20,21 @@ import {
   isTokenExpiringSoon,
   storeTokens
 } from "../chunk-XRRPEBKB.js";
+import {
+  DEFAULT_PASSWORD_CONFIG,
+  createPasswordHasher,
+  createPasswordSchema,
+  createPasswordValidator,
+  getPasswordStrength,
+  passwordValidator,
+  validatePassword
+} from "../chunk-G26T2PRQ.js";
+import {
+  PasswordHasher,
+  PasswordValidator,
+  defaultPasswordSchema,
+  strongPasswordSchema
+} from "../chunk-IHXRF3BH.js";
 import {
   OAuthProvider,
   PasswordStrength,

package/dist/cache/cache-config.js

@@ -1,9 +1,12 @@
 import {
   getCacheConfig,
   getCacheTTL
-} from "../chunk-HCTNZM7D.js";
-import "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+} from "../chunk-O7CK3CKJ.js";
+import "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import "../chunk-IQQKKUAV.js";
 import "../chunk-ORMEWXMH.js";
 export {

package/dist/cache/cache-env.d.ts

@@ -1,11 +1,13 @@
-import type { ISharedEnvConfig, IRawEnv } from '@withwiz/types/env';
 /**
- * 기본 환경 설정 (fallback용)
- * process.env에서 직접 읽되, 타입 안전하게 처리
+ * Cache Environment Configuration
+ *
+ * 캐시 모듈의 환경 설정 관리
+ * - getResolvedCacheConfig()에서 설정을 읽어 ISharedEnvConfig 호환 레이어 제공
+ * - process.env 의존성 없음
  */
-export declare function getDefaultConfig(): ISharedEnvConfig;
+import type { ISharedEnvConfig, IRawEnv } from '@withwiz/types/env';
 /**
- * 현재 환경 설정 가져오기 (주입된 설정 또는 기본값)
+ * 현재 캐시 설정을 ISharedEnvConfig 형태로 반환 (하위 호환 레이어)
  */
 export declare function getConfig(): ISharedEnvConfig;
 export declare const getEnv: () => IRawEnv;
@@ -13,21 +15,6 @@ export declare const getENV: () => {
     REDIS: import("@withwiz/types/env").IRedisEnv;
     CACHE: import("@withwiz/types/env").ICacheEnv;
 };
-declare global {
-    var __cacheInitialized: boolean | undefined;
-}
-/**
- * 캐시 모듈 초기화 (외부에서 환경 설정 주입)
- *
- * @example
- * ```typescript
- * import { initializeCache } from '@withwiz/cache/cache';
- * import { env, ENV, isCacheEnabled, isRedisAvailable } from '<your-project>/env';
- *
- * initializeCache({ env, ENV, isCacheEnabled, isRedisAvailable });
- * ```
- */
-export declare function initializeCache(config: ISharedEnvConfig): void;
 export declare const isCacheEnabled: () => boolean;
 export declare function validateRedisEnvironment(): {
     isValid: boolean;
@@ -73,3 +60,7 @@ export interface CacheHealthConfig {
  * 캐시 건강상태 설정 가져오기
  */
 export declare function getCacheHealthConfig(): CacheHealthConfig;
+/**
+ * 캐시 리포트 설정 인터페이스 (CacheHealthConfig의 리포트 관련 항목)
+ */
+export type CacheReportConfig = Pick<CacheHealthConfig, 'reportHitRateThreshold' | 'reportResponseTimeThreshold' | 'reportInvalidationThreshold' | 'reportMinRequests'>;

package/dist/cache/cache-env.js

@@ -2,24 +2,23 @@ import {
   getCacheFallbackConfig,
   getCacheHealthConfig,
   getConfig,
-  getDefaultConfig,
   getENV,
   getEnv,
-  initializeCache,
   isCacheEnabled,
   validateRedisEnvironment
-} from "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+} from "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import "../chunk-IQQKKUAV.js";
 import "../chunk-ORMEWXMH.js";
 export {
   getCacheFallbackConfig,
   getCacheHealthConfig,
   getConfig,
-  getDefaultConfig,
   getENV,
   getEnv,
-  initializeCache,
   isCacheEnabled,
   validateRedisEnvironment
 };

package/dist/cache/cache-factory.js

@@ -3,19 +3,24 @@ import {
   geoCache,
   getCacheManager,
   getEffectiveCacheBackend
-} from "../chunk-YVF4RXOK.js";
-import "../chunk-R5OFGX3C.js";
-import "../chunk-Y6IHEA3Q.js";
-import "../chunk-SS56XFLI.js";
-import "../chunk-HOMWLK62.js";
-import "../chunk-XN4YP4XO.js";
-import "../chunk-HCTNZM7D.js";
+} from "../chunk-7IN4WRSO.js";
+import "../chunk-FDRIFPG6.js";
+import "../chunk-KZUBO2IL.js";
+import "../chunk-SV7X6HEN.js";
+import "../chunk-J4TTSXDN.js";
 import {
   getRedisGlobalStatus,
   isRedisGloballyDisabled
-} from "../chunk-I5PCM2JQ.js";
-import "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+} from "../chunk-AXCB7SKY.js";
+import "../chunk-GQVBWZLH.js";
+import "../chunk-SS56XFLI.js";
+import "../chunk-OHBAELPZ.js";
+import "../chunk-O7CK3CKJ.js";
+import "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import "../chunk-IQQKKUAV.js";
 import "../chunk-ORMEWXMH.js";
 export {

package/dist/cache/cache-invalidation.js

@@ -3,17 +3,22 @@ import {
   deletePatternFromCache,
   deletePatternFromMultipleCaches,
   invalidateCache
-} from "../chunk-LEWQBXN6.js";
-import "../chunk-YVF4RXOK.js";
-import "../chunk-R5OFGX3C.js";
-import "../chunk-Y6IHEA3Q.js";
+} from "../chunk-VF4EVAMV.js";
+import "../chunk-7IN4WRSO.js";
+import "../chunk-FDRIFPG6.js";
+import "../chunk-KZUBO2IL.js";
+import "../chunk-SV7X6HEN.js";
+import "../chunk-J4TTSXDN.js";
+import "../chunk-AXCB7SKY.js";
+import "../chunk-GQVBWZLH.js";
 import "../chunk-SS56XFLI.js";
-import "../chunk-HOMWLK62.js";
-import "../chunk-XN4YP4XO.js";
-import "../chunk-HCTNZM7D.js";
-import "../chunk-I5PCM2JQ.js";
-import "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+import "../chunk-OHBAELPZ.js";
+import "../chunk-O7CK3CKJ.js";
+import "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import "../chunk-IQQKKUAV.js";
 import "../chunk-ORMEWXMH.js";
 export {

package/dist/cache/cache-redis.js

@@ -7,9 +7,14 @@ import {
   logRedisInitialization,
   notifyRedisError,
   resetRedisGlobalState
-} from "../chunk-I5PCM2JQ.js";
-import "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+} from "../chunk-AXCB7SKY.js";
+import "../chunk-GQVBWZLH.js";
+import "../chunk-OHBAELPZ.js";
+import "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import "../chunk-IQQKKUAV.js";
 import "../chunk-ORMEWXMH.js";
 export {

package/dist/cache/cache-wrapper.js

@@ -2,17 +2,22 @@ import {
   cacheMetrics,
   getCacheBackendLabel,
   withCache
-} from "../chunk-YMIDD4YE.js";
-import "../chunk-YVF4RXOK.js";
-import "../chunk-R5OFGX3C.js";
-import "../chunk-Y6IHEA3Q.js";
+} from "../chunk-RWVGJUON.js";
+import "../chunk-7IN4WRSO.js";
+import "../chunk-FDRIFPG6.js";
+import "../chunk-KZUBO2IL.js";
+import "../chunk-SV7X6HEN.js";
+import "../chunk-J4TTSXDN.js";
+import "../chunk-AXCB7SKY.js";
+import "../chunk-GQVBWZLH.js";
 import "../chunk-SS56XFLI.js";
-import "../chunk-HOMWLK62.js";
-import "../chunk-XN4YP4XO.js";
-import "../chunk-HCTNZM7D.js";
-import "../chunk-I5PCM2JQ.js";
-import "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+import "../chunk-OHBAELPZ.js";
+import "../chunk-O7CK3CKJ.js";
+import "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import "../chunk-IQQKKUAV.js";
 import "../chunk-ORMEWXMH.js";
 export {

package/dist/cache/cache.js

@@ -1,37 +1,32 @@
-import "../chunk-EBUEBEJX.js";
+import "../chunk-QMCOX3DP.js";
+import {
+  cacheKeys
+} from "../chunk-JBCDEAMW.js";
 import {
   cacheMetrics,
   withCache
-} from "../chunk-YMIDD4YE.js";
+} from "../chunk-RWVGJUON.js";
 import {
   invalidateCache
-} from "../chunk-LEWQBXN6.js";
+} from "../chunk-VF4EVAMV.js";
 import {
   cache,
   geoCache,
   getCacheManager,
   getEffectiveCacheBackend
-} from "../chunk-YVF4RXOK.js";
-import {
-  HybridCacheManager
-} from "../chunk-R5OFGX3C.js";
-import {
-  InMemoryCacheManager
-} from "../chunk-Y6IHEA3Q.js";
-import "../chunk-SS56XFLI.js";
+} from "../chunk-7IN4WRSO.js";
 import {
   NoopCacheManager
-} from "../chunk-HOMWLK62.js";
+} from "../chunk-FDRIFPG6.js";
 import {
   RedisCacheManager
-} from "../chunk-XN4YP4XO.js";
+} from "../chunk-KZUBO2IL.js";
 import {
-  getCacheConfig,
-  getCacheTTL
-} from "../chunk-HCTNZM7D.js";
+  HybridCacheManager
+} from "../chunk-SV7X6HEN.js";
 import {
-  cacheKeys
-} from "../chunk-JBCDEAMW.js";
+  InMemoryCacheManager
+} from "../chunk-J4TTSXDN.js";
 import {
   checkRedisConnection,
   getRedisClient,
@@ -41,17 +36,29 @@ import {
   logRedisInitialization,
   notifyRedisError,
   resetRedisGlobalState
-} from "../chunk-I5PCM2JQ.js";
+} from "../chunk-AXCB7SKY.js";
+import "../chunk-GQVBWZLH.js";
+import "../chunk-SS56XFLI.js";
+import "../chunk-OHBAELPZ.js";
+import {
+  getCacheConfig,
+  getCacheTTL
+} from "../chunk-O7CK3CKJ.js";
 import {
   getConfig,
-  getDefaultConfig,
   getENV,
   getEnv,
-  initializeCache,
   isCacheEnabled,
   validateRedisEnvironment
-} from "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+} from "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import {
+  getResolvedCacheConfig,
+  initializeCache,
+  resetCache
+} from "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import {
   CACHE_DURATION_DEFAULTS,
   CACHE_ENV_VARS,
@@ -93,12 +100,12 @@ export {
   getCacheManager,
   getCacheTTL,
   getConfig,
-  getDefaultConfig,
   getENV,
   getEffectiveCacheBackend,
   getEnv,
   getRedisClient,
   getRedisGlobalStatus,
+  getResolvedCacheConfig,
   initializeCache,
   invalidateCache,
   isCacheEnabled,
@@ -106,6 +113,7 @@ export {
   isRedisGloballyDisabled,
   logRedisInitialization,
   notifyRedisError,
+  resetCache,
   resetRedisGlobalState,
   validateRedisEnvironment,
   withCache

package/dist/cache/config.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Cache Config
+ *
+ * 코드 기반 캐시 설정 초기화 모듈 (process.env 의존성 제거)
+ */
+export interface CacheConfigInput {
+    enabled?: boolean;
+    redis?: {
+        url: string;
+        token: string;
+        enabled?: boolean;
+    };
+    inmemory?: {
+        enabled?: boolean;
+        maxSize?: number;
+        maxMb?: number;
+        eviction?: 'lru' | 'fifo' | 'ttl';
+        cleanupInterval?: number;
+    };
+    ttl?: Partial<{
+        DEFAULT: number;
+        SHORT: number;
+        LONG: number;
+        GEOIP: number;
+        SETTINGS: number;
+        ANALYTICS: number;
+        USER: number;
+        LINK: number;
+        ALIAS: number;
+        COMMUNITY: number;
+        RESERVED_WORDS: number;
+    }>;
+    categories?: Partial<Record<string, {
+        enabled?: boolean;
+        duration?: number;
+    }>>;
+    fallback?: {
+        redisErrorThresholdGlobal?: number;
+        redisErrorThresholdLocal?: number;
+        redisReconnectInterval?: number;
+        fallbackOnRedisError?: boolean;
+        writeToMemory?: boolean;
+    };
+    health?: {
+        errorRateThreshold?: number;
+        hitRateThreshold?: number;
+        reportHitRateThreshold?: number;
+        reportResponseTimeThreshold?: number;
+        reportInvalidationThreshold?: number;
+        reportMinRequests?: number;
+    };
+}
+export interface ResolvedCacheConfig {
+    enabled: boolean;
+    redis?: {
+        url: string;
+        token: string;
+        enabled: boolean;
+    };
+    inmemory: {
+        enabled: boolean;
+        maxSize: number;
+        maxMb: number;
+        eviction: 'lru' | 'fifo' | 'ttl';
+        cleanupInterval: number;
+    };
+    ttl: {
+        DEFAULT: number;
+        SHORT: number;
+        LONG: number;
+        GEOIP: number;
+        SETTINGS: number;
+        ANALYTICS: number;
+        USER: number;
+        LINK: number;
+        ALIAS: number;
+        COMMUNITY: number;
+        RESERVED_WORDS: number;
+    };
+    categories: Record<string, {
+        enabled: boolean;
+        duration: number;
+    }>;
+    fallback: {
+        redisErrorThresholdGlobal: number;
+        redisErrorThresholdLocal: number;
+        redisReconnectInterval: number;
+        fallbackOnRedisError: boolean;
+        writeToMemory: boolean;
+    };
+    health: {
+        errorRateThreshold: number;
+        hitRateThreshold: number;
+        reportHitRateThreshold: number;
+        reportResponseTimeThreshold: number;
+        reportInvalidationThreshold: number;
+        reportMinRequests: number;
+    };
+}
+declare global {
+    var __withwiz_cache_config: ResolvedCacheConfig | undefined;
+}
+/**
+ * 캐시 설정을 초기화합니다.
+ * redis가 제공된 경우 url과 token 유효성을 검사합니다.
+ */
+export declare function initializeCache(input: CacheConfigInput): void;
+/**
+ * 초기화된 캐시 설정을 반환합니다.
+ * initializeCache를 먼저 호출하지 않으면 ConfigurationError를 던집니다.
+ */
+export declare function getResolvedCacheConfig(): ResolvedCacheConfig;
+/**
+ * 캐시 설정을 초기화 전 상태로 리셋합니다. (테스트용)
+ */
+export declare function resetCache(): void;

package/dist/cache/config.js

@@ -0,0 +1,13 @@
+import {
+  getResolvedCacheConfig,
+  initializeCache,
+  resetCache
+} from "../chunk-TFD3DSM2.js";
+import "../chunk-2QH66EVQ.js";
+import "../chunk-IQQKKUAV.js";
+import "../chunk-ORMEWXMH.js";
+export {
+  getResolvedCacheConfig,
+  initializeCache,
+  resetCache
+};

package/dist/cache/hybrid-cache-manager.js

@@ -1,11 +1,16 @@
 import {
   HybridCacheManager
-} from "../chunk-R5OFGX3C.js";
-import "../chunk-Y6IHEA3Q.js";
+} from "../chunk-SV7X6HEN.js";
+import "../chunk-J4TTSXDN.js";
+import "../chunk-AXCB7SKY.js";
+import "../chunk-GQVBWZLH.js";
 import "../chunk-SS56XFLI.js";
-import "../chunk-I5PCM2JQ.js";
-import "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+import "../chunk-OHBAELPZ.js";
+import "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import "../chunk-IQQKKUAV.js";
 import "../chunk-ORMEWXMH.js";
 export {

package/dist/cache/index.d.ts

@@ -4,7 +4,8 @@
  * 캐시 모듈의 통합 진입점
  * - 모든 캐시 관련 기능을 re-export
  */
-export { initializeCache, isCacheEnabled, getEnv, getENV, getConfig, getDefaultConfig, validateRedisEnvironment, } from './cache-env';
+export { isCacheEnabled, getEnv, getENV, getConfig, validateRedisEnvironment, } from './cache-env';
+export { initializeCache, getResolvedCacheConfig, resetCache } from './config';
 export { checkRedisConnection, isRedisAvailableNow, getRedisClient, logRedisInitialization, isRedisGloballyDisabled, notifyRedisError, resetRedisGlobalState, getRedisGlobalStatus, } from './cache-redis';
 export type { CacheMetrics, RedisConnectionStatus } from './cache-redis';
 export { getCacheConfig, getCacheTTL } from './cache-config';

package/dist/cache/index.js

@@ -1,37 +1,32 @@
-import "../chunk-EBUEBEJX.js";
+import "../chunk-QMCOX3DP.js";
+import {
+  cacheKeys
+} from "../chunk-JBCDEAMW.js";
 import {
   cacheMetrics,
   withCache
-} from "../chunk-YMIDD4YE.js";
+} from "../chunk-RWVGJUON.js";
 import {
   invalidateCache
-} from "../chunk-LEWQBXN6.js";
+} from "../chunk-VF4EVAMV.js";
 import {
   cache,
   geoCache,
   getCacheManager,
   getEffectiveCacheBackend
-} from "../chunk-YVF4RXOK.js";
-import {
-  HybridCacheManager
-} from "../chunk-R5OFGX3C.js";
-import {
-  InMemoryCacheManager
-} from "../chunk-Y6IHEA3Q.js";
-import "../chunk-SS56XFLI.js";
+} from "../chunk-7IN4WRSO.js";
 import {
   NoopCacheManager
-} from "../chunk-HOMWLK62.js";
+} from "../chunk-FDRIFPG6.js";
 import {
   RedisCacheManager
-} from "../chunk-XN4YP4XO.js";
+} from "../chunk-KZUBO2IL.js";
 import {
-  getCacheConfig,
-  getCacheTTL
-} from "../chunk-HCTNZM7D.js";
+  HybridCacheManager
+} from "../chunk-SV7X6HEN.js";
 import {
-  cacheKeys
-} from "../chunk-JBCDEAMW.js";
+  InMemoryCacheManager
+} from "../chunk-J4TTSXDN.js";
 import {
   checkRedisConnection,
   getRedisClient,
@@ -41,17 +36,29 @@ import {
   logRedisInitialization,
   notifyRedisError,
   resetRedisGlobalState
-} from "../chunk-I5PCM2JQ.js";
+} from "../chunk-AXCB7SKY.js";
+import "../chunk-GQVBWZLH.js";
+import "../chunk-SS56XFLI.js";
+import "../chunk-OHBAELPZ.js";
+import {
+  getCacheConfig,
+  getCacheTTL
+} from "../chunk-O7CK3CKJ.js";
 import {
   getConfig,
-  getDefaultConfig,
   getENV,
   getEnv,
-  initializeCache,
   isCacheEnabled,
   validateRedisEnvironment
-} from "../chunk-N4XYQB2G.js";
-import "../chunk-5A2L6TXD.js";
+} from "../chunk-XI4MRH5P.js";
+import "../chunk-SFPMFVSD.js";
+import {
+  getResolvedCacheConfig,
+  initializeCache,
+  resetCache
+} from "../chunk-TFD3DSM2.js";
+import "../chunk-K25ICPU4.js";
+import "../chunk-2QH66EVQ.js";
 import {
   CACHE_DURATION_DEFAULTS,
   CACHE_ENV_VARS,
@@ -93,12 +100,12 @@ export {
   getCacheManager,
   getCacheTTL,
   getConfig,
-  getDefaultConfig,
   getENV,
   getEffectiveCacheBackend,
   getEnv,
   getRedisClient,
   getRedisGlobalStatus,
+  getResolvedCacheConfig,
   initializeCache,
   invalidateCache,
   isCacheEnabled,
@@ -106,6 +113,7 @@ export {
   isRedisGloballyDisabled,
   logRedisInitialization,
   notifyRedisError,
+  resetCache,
   resetRedisGlobalState,
   validateRedisEnvironment,
   withCache