@withwiz/toolkit 0.4.1 → 0.5.1

package/dist/constants/index.js

@@ -1,3 +1,9 @@
+import {
+  GENERIC_CONFIRM_MESSAGES,
+  GENERIC_ERROR_MESSAGES,
+  GENERIC_INFO_MESSAGES,
+  GENERIC_SUCCESS_MESSAGES
+} from "../chunk-2TO7WUKK.js";
 import {
   DATE_RANGE,
   FILTER_OPTIONS,
@@ -38,12 +44,6 @@ import {
   getHttpStatus,
   getLogLevel
 } from "../chunk-SNTLJ646.js";
-import {
-  GENERIC_CONFIRM_MESSAGES,
-  GENERIC_ERROR_MESSAGES,
-  GENERIC_INFO_MESSAGES,
-  GENERIC_SUCCESS_MESSAGES
-} from "../chunk-2TO7WUKK.js";
 import "../chunk-ORMEWXMH.js";
 export {
   CSRF,

package/dist/initialize.d.ts

@@ -16,3 +16,5 @@ export interface ToolkitConfig {
 }
 export declare function initialize(config: ToolkitConfig): void;
 export type { AuthConfig, LoggerConfig, CacheConfigInput as CacheConfig, StorageConfig, GeolocationConfig, CorsConfig, };
+export { initConfig, config, resetConfig } from './config/registry';
+export type { ConfigRegistry } from './config/registry';

package/dist/initialize.js

@@ -7,6 +7,11 @@ import {
 import {
   initializeGeolocation
 } from "./chunk-3CBGGMIY.js";
+import {
+  config,
+  initConfig,
+  resetConfig
+} from "./chunk-6PGZTY4N.js";
 import {
   initializeAuth
 } from "./chunk-OZE5KUS3.js";
@@ -25,17 +30,20 @@ import "./chunk-57W32BFZ.js";
 import "./chunk-ORMEWXMH.js";
 
 // src/initialize.ts
-function initialize(config) {
-  initializeCommon({ nodeEnv: config.nodeEnv });
-  if (config.logger) {
-    initializeLogger(config.logger);
+function initialize(config2) {
+  initializeCommon({ nodeEnv: config2.nodeEnv });
+  if (config2.logger) {
+    initializeLogger(config2.logger);
   }
-  if (config.auth) initializeAuth(config.auth);
-  if (config.cache) initializeCache(config.cache);
-  if (config.storage) initializeStorage(config.storage);
-  if (config.geolocation) initializeGeolocation(config.geolocation);
-  if (config.cors) initializeCors(config.cors);
+  if (config2.auth) initializeAuth(config2.auth);
+  if (config2.cache) initializeCache(config2.cache);
+  if (config2.storage) initializeStorage(config2.storage);
+  if (config2.geolocation) initializeGeolocation(config2.geolocation);
+  if (config2.cors) initializeCors(config2.cors);
 }
 export {
-  initialize
+  config,
+  initConfig,
+  initialize,
+  resetConfig
 };

package/dist/middleware/auth.d.ts

@@ -87,4 +87,5 @@ export declare const optionalAuthMiddleware: TApiMiddleware;
  *   .use(adminMiddleware);
  * ```
  */
+export declare function createRoleMiddleware(...allowedRoles: string[]): TApiMiddleware;
 export declare const adminMiddleware: TApiMiddleware;

package/dist/middleware/auth.js

@@ -1,15 +1,16 @@
 import {
   adminMiddleware,
   authMiddleware,
+  createRoleMiddleware,
   initializeAuthMiddleware,
   optionalAuthMiddleware,
   setAccessTokenBlacklistChecker
-} from "../chunk-J5AISIJS.js";
+} from "../chunk-ZBXSEQ6W.js";
 import "../chunk-EOEMOXNT.js";
 import "../chunk-SNTLJ646.js";
 import "../chunk-OZE5KUS3.js";
 import "../chunk-3GAY2T2A.js";
-import "../chunk-N4D6OPPP.js";
+import "../chunk-LLVIA4JX.js";
 import "../chunk-AIH3F7JV.js";
 import "../chunk-GQVBWZLH.js";
 import "../chunk-OHBAELPZ.js";
@@ -20,6 +21,7 @@ import "../chunk-ORMEWXMH.js";
 export {
   adminMiddleware,
   authMiddleware,
+  createRoleMiddleware,
   initializeAuthMiddleware,
   optionalAuthMiddleware,
   setAccessTokenBlacklistChecker

package/dist/middleware/index.d.ts

@@ -6,7 +6,7 @@
 export type { IApiContext, IUser, TApiHandler, TApiMiddleware, IMiddlewareChainOptions, } from './types';
 export { MiddlewareChain } from './middleware-chain';
 export { initRequestMiddleware } from './init-request';
-export { authMiddleware, optionalAuthMiddleware, adminMiddleware, initializeAuthMiddleware, setAccessTokenBlacklistChecker } from './auth';
+export { authMiddleware, optionalAuthMiddleware, adminMiddleware, createRoleMiddleware, initializeAuthMiddleware, setAccessTokenBlacklistChecker } from './auth';
 export type { IAccessTokenBlacklistChecker } from './auth';
 export { rateLimitMiddleware, createRateLimitMiddleware, setRateLimitAdapter } from './rate-limit';
 export { errorHandlerMiddleware } from './error-handler';

package/dist/middleware/index.js

@@ -4,7 +4,10 @@ import {
   withCustomApi,
   withOptionalAuthApi,
   withPublicApi
-} from "../chunk-5WP57PJK.js";
+} from "../chunk-O3UR234Y.js";
+import {
+  initRequestMiddleware
+} from "../chunk-62Q7DN5G.js";
 import {
   MiddlewareChain
 } from "../chunk-FPESPW6P.js";
@@ -24,10 +27,11 @@ import {
 import {
   adminMiddleware,
   authMiddleware,
+  createRoleMiddleware,
   initializeAuthMiddleware,
   optionalAuthMiddleware,
   setAccessTokenBlacklistChecker
-} from "../chunk-J5AISIJS.js";
+} from "../chunk-ZBXSEQ6W.js";
 import {
   corsMiddleware,
   validateCorsConfiguration
@@ -35,9 +39,6 @@ import {
 import {
   errorHandlerMiddleware
 } from "../chunk-3YUKCYHI.js";
-import {
-  initRequestMiddleware
-} from "../chunk-62Q7DN5G.js";
 import "../chunk-XHZ5L4FO.js";
 import "../chunk-L6AU74EI.js";
 import "../chunk-EOEMOXNT.js";
@@ -48,7 +49,7 @@ import "../chunk-SNTLJ646.js";
 import "../chunk-GFWGLWTS.js";
 import "../chunk-OZE5KUS3.js";
 import "../chunk-3GAY2T2A.js";
-import "../chunk-N4D6OPPP.js";
+import "../chunk-LLVIA4JX.js";
 import "../chunk-AIH3F7JV.js";
 import "../chunk-GQVBWZLH.js";
 import "../chunk-OHBAELPZ.js";
@@ -62,6 +63,7 @@ export {
   authMiddleware,
   corsMiddleware,
   createRateLimitMiddleware,
+  createRoleMiddleware,
   errorHandlerMiddleware,
   initRequestMiddleware,
   initializeAuthMiddleware,

package/dist/middleware/rate-limit.d.ts

@@ -48,12 +48,8 @@ export declare function setRateLimitAdapter(adapter: IRateLimitAdapter): void;
 /**
  * 기본 Rate Limit 타입 (범용)
  */
-export type TRateLimitType = "api" | "auth" | "admin";
-/**
- * 확장 가능한 Rate Limit 타입
- * 도메인 특화 타입은 소비 프로젝트의 extension 영역에서 정의하세요.
- */
-export type TExtendedRateLimitType = TRateLimitType | string;
+export type TBuiltinRateLimitType = "api" | "auth" | "admin";
+export type TRateLimitType = TBuiltinRateLimitType | (string & {});
 /**
  * Rate Limit 미들웨어 팩토리
  *
@@ -65,7 +61,7 @@ export type TExtendedRateLimitType = TRateLimitType | string;
  *   .use(createRateLimitMiddleware('api'));
  * ```
  */
-export declare function createRateLimitMiddleware(type: TExtendedRateLimitType): TApiMiddleware;
+export declare function createRateLimitMiddleware(type: TRateLimitType): TApiMiddleware;
 /**
  * 사전 정의된 Rate Limit 미들웨어 (범용)
  *

package/dist/middleware/types.d.ts

@@ -10,7 +10,7 @@ export interface IUser {
     id: string;
     email: string;
     name?: string;
-    role: 'USER' | 'ADMIN';
+    role: string;
 }
 /**
  * API 컨텍스트

package/dist/middleware/wrappers.js

@@ -4,15 +4,15 @@ import {
   withCustomApi,
   withOptionalAuthApi,
   withPublicApi
-} from "../chunk-5WP57PJK.js";
+} from "../chunk-O3UR234Y.js";
+import "../chunk-62Q7DN5G.js";
 import "../chunk-FPESPW6P.js";
 import "../chunk-AQJAY5FA.js";
 import "../chunk-OIRAH57Y.js";
 import "../chunk-WMQE2YK7.js";
-import "../chunk-J5AISIJS.js";
+import "../chunk-ZBXSEQ6W.js";
 import "../chunk-KGHWGLED.js";
 import "../chunk-3YUKCYHI.js";
-import "../chunk-62Q7DN5G.js";
 import "../chunk-XHZ5L4FO.js";
 import "../chunk-L6AU74EI.js";
 import "../chunk-EOEMOXNT.js";
@@ -23,7 +23,7 @@ import "../chunk-SNTLJ646.js";
 import "../chunk-GFWGLWTS.js";
 import "../chunk-OZE5KUS3.js";
 import "../chunk-3GAY2T2A.js";
-import "../chunk-N4D6OPPP.js";
+import "../chunk-LLVIA4JX.js";
 import "../chunk-AIH3F7JV.js";
 import "../chunk-GQVBWZLH.js";
 import "../chunk-OHBAELPZ.js";

package/dist/types/geoip.d.ts

@@ -13,8 +13,8 @@ export interface IGeoIPConfig {
 export interface IGeoIPService {
     getGeoLocation(ip: string): Promise<IGeoLocationData | null>;
     getGeoLocationBatch(ips: string[]): Promise<Map<string, IGeoLocationData>>;
-    updateClickHistoryGeoLocation(linkId: string, ip: string): Promise<void>;
-    getGeographyAnalytics(linkId: string, days?: number): Promise<IGeographyAnalytics>;
+    updateGeoLocation(entityId: string, ip: string): Promise<void>;
+    getGeographyAnalytics(entityId: string, days?: number): Promise<IGeographyAnalytics>;
     getUserGeographyAnalytics(userId: string, days?: number): Promise<IGeographyAnalytics>;
     findOrCreateGeoLocation(ip: string): Promise<string | null>;
     isGeoLocationOutdated(validFrom: Date): boolean;
@@ -40,7 +40,7 @@ export interface IGeoIPServiceFactory {
 }
 export interface IGeoIPBatchProcessor {
     processMissingGeoIPData(): Promise<IBatchProcessResult>;
-    processLinkGeoIPData(linkId: string): Promise<IBatchProcessResult>;
+    processGeoIPData(entityId: string): Promise<IBatchProcessResult>;
     cleanupOldGeoIPData(daysOld?: number): Promise<number>;
     getGeoIPStats(): Promise<IGeoIPStats>;
     processUserGeoIPData(userId: string): Promise<IBatchProcessResult>;
@@ -78,7 +78,7 @@ export interface IGeoIPProvider {
     getTimeout(): number;
 }
 export interface IGeographyAnalytics {
-    totalClicks: number;
+    totalEvents: number;
     countries: Array<{
         country: string;
         countryName: string;

package/dist/types/qr-code.d.ts

@@ -10,7 +10,7 @@ export interface IQRCodeSettings {
 }
 export interface IQRCodeConfig {
     id: string;
-    linkId: string;
+    entityId: string;
     settings: IQRCodeSettings;
     isActive: boolean;
     createdAt: Date;
@@ -28,31 +28,31 @@ export interface IQRTemplate {
     updatedAt: Date;
 }
 export interface IQRCodeStats {
-    totalClicks: number;
-    qrClicks: number;
-    normalClicks: number;
-    clicks: number;
-    apiClicks: number;
-    qrUsageRate: number;
+    totalInteractions: number;
+    scanCount: number;
+    directInteractions: number;
+    interactions: number;
+    apiInteractions: number;
+    usageRate: number;
 }
 export interface IQRCodeAnalytics {
     dailyStats: Array<{
         date: string;
-        totalClicks: number;
-        qrClicks: number;
-        qrUsageRate: number;
+        totalInteractions: number;
+        scanCount: number;
+        usageRate: number;
     }>;
     deviceStats: Array<{
         deviceType: string;
-        totalClicks: number;
-        qrClicks: number;
-        qrUsageRate: number;
+        totalInteractions: number;
+        scanCount: number;
+        usageRate: number;
     }>;
     browserStats: Array<{
         browser: string;
-        totalClicks: number;
-        qrClicks: number;
-        qrUsageRate: number;
+        totalInteractions: number;
+        scanCount: number;
+        usageRate: number;
     }>;
 }
 export interface IQRCodeDownloadOptions {
@@ -85,8 +85,8 @@ export declare const QR_CODE_TEMPLATES: readonly [{
     readonly name: "브랜드";
     readonly description: "브랜드 컬러 적용";
     readonly settings: {
-        readonly color: "#3B82F6";
-        readonly bgColor: "#F8FAFC";
+        readonly color: "#4A90D9";
+        readonly bgColor: "#F5F5F5";
         readonly errorCorrectionLevel: "H";
         readonly size: number;
         readonly includeMargin: boolean;
@@ -113,8 +113,8 @@ export declare const QR_CODE_TEMPLATES: readonly [{
     readonly name: "컬러풀";
     readonly description: "화려한 컬러 스타일";
     readonly settings: {
-        readonly color: "#EF4444";
-        readonly bgColor: "#FEF3C7";
+        readonly color: "#D94A4A";
+        readonly bgColor: "#FFF8E1";
         readonly errorCorrectionLevel: "H";
         readonly size: number;
         readonly includeMargin: boolean;

package/dist/types/qr-code.js

@@ -34,8 +34,8 @@ var QR_CODE_TEMPLATES = [
     name: "\uBE0C\uB79C\uB4DC",
     description: "\uBE0C\uB79C\uB4DC \uCEEC\uB7EC \uC801\uC6A9",
     settings: __spreadProps(__spreadValues({}, DEFAULT_QR_SETTINGS), {
-      color: "#3B82F6",
-      bgColor: "#F8FAFC",
+      color: "#4A90D9",
+      bgColor: "#F5F5F5",
       errorCorrectionLevel: "H"
     })
   },
@@ -54,8 +54,8 @@ var QR_CODE_TEMPLATES = [
     name: "\uCEEC\uB7EC\uD480",
     description: "\uD654\uB824\uD55C \uCEEC\uB7EC \uC2A4\uD0C0\uC77C",
     settings: __spreadProps(__spreadValues({}, DEFAULT_QR_SETTINGS), {
-      color: "#EF4444",
-      bgColor: "#FEF3C7",
+      color: "#D94A4A",
+      bgColor: "#FFF8E1",
       errorCorrectionLevel: "H"
     })
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withwiz/toolkit",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Shared utility library for withwiz projects",
   "license": "MIT",
   "private": false,
@@ -16,6 +16,7 @@
   },
   "exports": {
     "./initialize": "./dist/initialize.js",
+    "./config": "./dist/config/registry.js",
     "./config/errors": "./dist/config/errors.js",
     "./config/common": "./dist/config/common.js",
     "./auth/config": "./dist/auth/config.js",
@@ -30,6 +31,10 @@
     "./auth/core/password": "./dist/auth/core/password/index.js",
     "./auth/core/password/client-helper": "./dist/auth/core/password/client-helper.js",
     "./auth/core/oauth": "./dist/auth/core/oauth/index.js",
+    "./auth/core/oauth/providers": "./dist/auth/core/oauth/providers/index.js",
+    "./auth/core/oauth/providers/google": "./dist/auth/core/oauth/providers/google.js",
+    "./auth/core/oauth/providers/github": "./dist/auth/core/oauth/providers/github.js",
+    "./auth/core/oauth/providers/kakao": "./dist/auth/core/oauth/providers/kakao.js",
     "./auth/adapters/prisma": "./dist/auth/adapters/prisma/index.js",
     "./cache": "./dist/cache/index.js",
     "./cache/cache": "./dist/cache/cache.js",

package/dist/chunk-V5K5FYU7.js

@@ -1,200 +0,0 @@
-import {
-  OAuthError
-} from "./chunk-AIH3F7JV.js";
-
-// src/auth/core/oauth/index.ts
-var OAuthManager = class {
-  constructor(config, logger) {
-    this.config = config;
-    this.logger = logger;
-  }
-  /**
-   * OAuth 로그인 URL 생성
-   */
-  getLoginUrl(provider, state) {
-    if (provider === "google" /* GOOGLE */) {
-      return this.getGoogleLoginUrl(state);
-    } else if (provider === "github" /* GITHUB */) {
-      return this.getGitHubLoginUrl(state);
-    }
-    throw new OAuthError(`Unsupported OAuth provider: ${provider}`, "UNSUPPORTED_PROVIDER");
-  }
-  /**
-   * Google OAuth 로그인 URL
-   */
-  getGoogleLoginUrl(state) {
-    if (!this.config.google) {
-      throw new OAuthError("Google OAuth not configured", "GOOGLE_NOT_CONFIGURED");
-    }
-    const params = new URLSearchParams({
-      client_id: this.config.google.clientId,
-      redirect_uri: this.config.google.redirectUri,
-      response_type: "code",
-      scope: "openid email profile",
-      state,
-      access_type: "offline",
-      prompt: "select_account consent"
-    });
-    return `https://accounts.google.com/o/oauth2/v2/auth?${params.toString()}`;
-  }
-  /**
-   * GitHub OAuth 로그인 URL
-   */
-  getGitHubLoginUrl(state) {
-    if (!this.config.github) {
-      throw new OAuthError("GitHub OAuth not configured", "GITHUB_NOT_CONFIGURED");
-    }
-    const params = new URLSearchParams({
-      client_id: this.config.github.clientId,
-      redirect_uri: this.config.github.redirectUri,
-      scope: "read:user user:email",
-      state
-    });
-    return `https://github.com/login/oauth/authorize?${params.toString()}`;
-  }
-  /**
-   * 인증 코드를 액세스 토큰으로 교환
-   */
-  async exchangeCodeForToken(provider, code) {
-    if (provider === "google" /* GOOGLE */) {
-      return this.exchangeGoogleCode(code);
-    } else if (provider === "github" /* GITHUB */) {
-      return this.exchangeGitHubCode(code);
-    }
-    throw new OAuthError(`Unsupported OAuth provider: ${provider}`, "UNSUPPORTED_PROVIDER");
-  }
-  /**
-   * Google 코드 교환
-   */
-  async exchangeGoogleCode(code) {
-    if (!this.config.google) {
-      throw new OAuthError("Google OAuth not configured", "GOOGLE_NOT_CONFIGURED");
-    }
-    try {
-      const response = await fetch("https://oauth2.googleapis.com/token", {
-        method: "POST",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
-        body: new URLSearchParams({
-          client_id: this.config.google.clientId,
-          client_secret: this.config.google.clientSecret,
-          code,
-          grant_type: "authorization_code",
-          redirect_uri: this.config.google.redirectUri
-        })
-      });
-      if (!response.ok) {
-        const errorData = await response.text();
-        this.logger.error("Google token exchange failed", { status: response.status, errorData });
-        throw new OAuthError("Failed to exchange Google code for token", "TOKEN_EXCHANGE_FAILED");
-      }
-      const data = await response.json();
-      this.logger.debug("Google token exchange successful");
-      return data.access_token;
-    } catch (error) {
-      this.logger.error("Google token exchange error", { error: error.message });
-      throw new OAuthError("Google token exchange failed", "TOKEN_EXCHANGE_FAILED");
-    }
-  }
-  /**
-   * GitHub 코드 교환
-   */
-  async exchangeGitHubCode(code) {
-    if (!this.config.github) {
-      throw new OAuthError("GitHub OAuth not configured", "GITHUB_NOT_CONFIGURED");
-    }
-    try {
-      const response = await fetch("https://github.com/login/oauth/access_token", {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Accept: "application/json"
-        },
-        body: JSON.stringify({
-          client_id: this.config.github.clientId,
-          client_secret: this.config.github.clientSecret,
-          code,
-          redirect_uri: this.config.github.redirectUri
-        })
-      });
-      if (!response.ok) {
-        const errorData = await response.text();
-        this.logger.error("GitHub token exchange failed", { status: response.status, errorData });
-        throw new OAuthError("Failed to exchange GitHub code for token", "TOKEN_EXCHANGE_FAILED");
-      }
-      const data = await response.json();
-      this.logger.debug("GitHub token exchange successful");
-      return data.access_token;
-    } catch (error) {
-      this.logger.error("GitHub token exchange error", { error: error.message });
-      throw new OAuthError("GitHub token exchange failed", "TOKEN_EXCHANGE_FAILED");
-    }
-  }
-  /**
-   * 사용자 정보 가져오기
-   */
-  async getUserInfo(provider, accessToken) {
-    if (provider === "google" /* GOOGLE */) {
-      return this.getGoogleUserInfo(accessToken);
-    } else if (provider === "github" /* GITHUB */) {
-      return this.getGitHubUserInfo(accessToken);
-    }
-    throw new OAuthError(`Unsupported OAuth provider: ${provider}`, "UNSUPPORTED_PROVIDER");
-  }
-  /**
-   * Google 사용자 정보
-   */
-  async getGoogleUserInfo(accessToken) {
-    try {
-      const response = await fetch("https://www.googleapis.com/oauth2/v2/userinfo", {
-        headers: { Authorization: `Bearer ${accessToken}` }
-      });
-      if (!response.ok) {
-        throw new OAuthError("Failed to get Google user info", "USER_INFO_FAILED");
-      }
-      const data = await response.json();
-      this.logger.debug("Google user info retrieved", { userId: data.id, email: data.email });
-      return {
-        id: data.id,
-        email: data.email,
-        name: data.name || null,
-        image: data.picture || null,
-        emailVerified: data.verified_email || false
-      };
-    } catch (error) {
-      this.logger.error("Google user info error", { error: error.message });
-      throw new OAuthError("Failed to retrieve Google user info", "USER_INFO_FAILED");
-    }
-  }
-  /**
-   * GitHub 사용자 정보
-   */
-  async getGitHubUserInfo(accessToken) {
-    try {
-      const response = await fetch("https://api.github.com/user", {
-        headers: {
-          Authorization: `Bearer ${accessToken}`,
-          "User-Agent": "Auth-Module"
-        }
-      });
-      if (!response.ok) {
-        throw new OAuthError("Failed to get GitHub user info", "USER_INFO_FAILED");
-      }
-      const data = await response.json();
-      this.logger.debug("GitHub user info retrieved", { userId: data.id, login: data.login });
-      return {
-        id: data.id.toString(),
-        email: data.email,
-        name: data.name || null,
-        image: data.avatar_url || null,
-        emailVerified: !!data.email
-      };
-    } catch (error) {
-      this.logger.error("GitHub user info error", { error: error.message });
-      throw new OAuthError("Failed to retrieve GitHub user info", "USER_INFO_FAILED");
-    }
-  }
-};
-
-export {
-  OAuthManager
-};