@withwiz/toolkit 0.1.0

package/dist/auth/core/jwt/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Shared Auth - JWT Core Module
+ *
+ * JWT 토큰 생성 및 검증 모듈 (프레임워크 독립적)
+ * Next.js, Express, Fastify 등 어디서나 사용 가능
+ */
+import type { JWTConfig, JWTPayload, TokenPair, Logger } from "@withwiz/auth/types";
+export declare class JWTManager {
+    private config;
+    private logger;
+    private secretKey;
+    constructor(config: JWTConfig, logger: Logger);
+    /**
+     * Access JWT 토큰 생성
+     */
+    createAccessToken(payload: Omit<JWTPayload, "iat" | "exp">): Promise<string>;
+    /**
+     * Refresh 토큰 생성
+     */
+    createRefreshToken(userId: string): Promise<string>;
+    /**
+     * 토큰 쌍 생성 (Access + Refresh)
+     */
+    createTokenPair(user: {
+        id: string;
+        email: string;
+        role: string;
+        emailVerified?: Date | null;
+    }): Promise<TokenPair>;
+    /**
+     * Access JWT 토큰 검증
+     */
+    verifyAccessToken(token: string): Promise<JWTPayload>;
+    /**
+     * Refresh 토큰 검증
+     */
+    verifyRefreshToken(token: string): Promise<{
+        userId: string;
+        tokenType: string;
+    }>;
+    /**
+     * Authorization 헤더에서 토큰 추출
+     */
+    extractTokenFromHeader(authHeader: string | null): string | null;
+    /**
+     * 토큰 만료 여부 확인
+     */
+    isTokenExpired(payload: JWTPayload): boolean;
+    /**
+     * 토큰 남은 시간 (초)
+     */
+    getTokenRemainingTime(payload: JWTPayload): number;
+    /**
+     * 토큰에서 사용자 정보 추출
+     */
+    extractUserFromPayload(payload: JWTPayload): {
+        id: string;
+        email: string;
+        role: import("@withwiz/auth/types").UserRole;
+    };
+}
+/**
+ * JWTService는 JWTManager의 간단한 wrapper로, Logger 없이 사용 가능합니다.
+ * 테스트 및 간단한 사용 사례를 위한 클래스입니다.
+ */
+export declare class JWTService {
+    private manager;
+    constructor(config: JWTConfig);
+    /**
+     * Access 토큰 생성 (sign으로 alias)
+     */
+    sign(payload: Omit<JWTPayload, "iat" | "exp">): Promise<string>;
+    /**
+     * 토큰 검증
+     */
+    verify(token: string): Promise<JWTPayload>;
+    /**
+     * Refresh 토큰 생성
+     */
+    createRefreshToken(userId: string): Promise<string>;
+    /**
+     * Refresh 토큰 검증
+     */
+    verifyRefreshToken(token: string): Promise<{
+        userId: string;
+        tokenType: string;
+    }>;
+    /**
+     * 토큰 쌍 생성
+     */
+    createTokenPair(user: {
+        id: string;
+        email: string;
+        role: string;
+        emailVerified?: Date | null;
+    }): Promise<TokenPair>;
+    /**
+     * Access 토큰 생성
+     */
+    createAccessToken(payload: Omit<JWTPayload, "iat" | "exp">): Promise<string>;
+    /**
+     * Access 토큰 검증
+     */
+    verifyAccessToken(token: string): Promise<JWTPayload>;
+    /**
+     * Authorization 헤더에서 토큰 추출
+     */
+    extractTokenFromHeader(authHeader: string | undefined): string | null;
+}
+export type { JWTConfig, JWTPayload, TokenPair };

package/dist/auth/core/jwt/index.js

@@ -0,0 +1,10 @@
+import {
+  JWTManager,
+  JWTService
+} from "../../../chunk-T3LJYAMO.js";
+import "../../../chunk-AIH3F7JV.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  JWTManager,
+  JWTService
+};

package/dist/auth/core/jwt/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * JWT Types
+ *
+ * JWT 모듈 전용 타입 정의
+ */
+export * from '@withwiz/auth/types';

package/dist/auth/core/jwt/types.js

@@ -0,0 +1,13 @@
+import {
+  OAuthProvider,
+  PasswordStrength,
+  TokenType,
+  UserRole
+} from "../../../chunk-6D3HHYER.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  OAuthProvider,
+  PasswordStrength,
+  TokenType,
+  UserRole
+};

package/dist/auth/core/oauth/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Shared Auth - OAuth Module
+ *
+ * OAuth 2.0 인증 모듈 (프레임워크 독립적)
+ * Google, GitHub 지원
+ */
+import type { OAuthConfig, OAuthUserInfo, Logger } from '@withwiz/auth/types';
+import { OAuthProvider } from '@withwiz/auth/types';
+export { OAuthProvider };
+export declare class OAuthManager {
+    private config;
+    private logger;
+    constructor(config: OAuthConfig, logger: Logger);
+    /**
+     * OAuth 로그인 URL 생성
+     */
+    getLoginUrl(provider: OAuthProvider, state: string): string;
+    /**
+     * Google OAuth 로그인 URL
+     */
+    private getGoogleLoginUrl;
+    /**
+     * GitHub OAuth 로그인 URL
+     */
+    private getGitHubLoginUrl;
+    /**
+     * 인증 코드를 액세스 토큰으로 교환
+     */
+    exchangeCodeForToken(provider: OAuthProvider, code: string): Promise<string>;
+    /**
+     * Google 코드 교환
+     */
+    private exchangeGoogleCode;
+    /**
+     * GitHub 코드 교환
+     */
+    private exchangeGitHubCode;
+    /**
+     * 사용자 정보 가져오기
+     */
+    getUserInfo(provider: OAuthProvider, accessToken: string): Promise<OAuthUserInfo>;
+    /**
+     * Google 사용자 정보
+     */
+    private getGoogleUserInfo;
+    /**
+     * GitHub 사용자 정보
+     */
+    private getGitHubUserInfo;
+}
+export type { OAuthConfig, OAuthUserInfo, OAuthTokenResponse } from '@withwiz/auth/types';

package/dist/auth/core/oauth/index.js

@@ -0,0 +1,12 @@
+import {
+  OAuthManager
+} from "../../../chunk-V5K5FYU7.js";
+import {
+  OAuthProvider
+} from "../../../chunk-6D3HHYER.js";
+import "../../../chunk-AIH3F7JV.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  OAuthManager,
+  OAuthProvider
+};

package/dist/auth/core/password/client-helper.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared Auth - Password Client Helper
+ *
+ * 클라이언트 사이드용 비밀번호 검증 헬퍼 (프레임워크 독립적)
+ */
+import { PasswordValidator, PasswordHasher } from './index';
+import type { PasswordConfig } from '@withwiz/auth/types';
+import type { z } from 'zod';
+/**
+ * 기본 비밀번호 설정
+ */
+export declare const DEFAULT_PASSWORD_CONFIG: PasswordConfig;
+/**
+ * 클라이언트용 비밀번호 검증기 인스턴스 생성
+ */
+export declare function createPasswordValidator(config?: Partial<PasswordConfig>): PasswordValidator;
+/**
+ * 비밀번호 검증 헬퍼 함수 (간편 사용)
+ */
+export declare function validatePassword(password: string, config?: Partial<PasswordConfig>): import("./index").PasswordValidationResult;
+/**
+ * 비밀번호 강도 계산 헬퍼 함수
+ */
+export declare function getPasswordStrength(password: string, config?: Partial<PasswordConfig>): import("@withwiz/auth/types").PasswordStrength;
+/**
+ * Zod 스키마 생성 헬퍼 함수
+ */
+export declare function createPasswordSchema(config?: Partial<PasswordConfig>): z.ZodString;
+/**
+ * 기본 Zod 스키마 (기존 defaultPasswordSchema와 호환)
+ */
+export declare const defaultPasswordSchema: z.ZodString;
+/**
+ * 싱글톤 인스턴스 (기존 PasswordValidator 정적 메서드 대체)
+ */
+export declare const passwordValidator: PasswordValidator;
+/**
+ * 비밀번호 해싱 인스턴스 (브라우저에서는 사용하지 말 것!)
+ * ⚠️ WARNING: 해싱은 서버 사이드에서만 수행해야 합니다.
+ */
+export declare function createPasswordHasher(rounds?: number): PasswordHasher;
+export { PasswordValidator, PasswordHasher } from './index';
+export type { PasswordValidationResult } from './index';
+export type { PasswordConfig, PasswordStrength } from '@withwiz/auth/types';

package/dist/auth/core/password/client-helper.js

@@ -0,0 +1,28 @@
+import {
+  DEFAULT_PASSWORD_CONFIG,
+  createPasswordHasher,
+  createPasswordSchema,
+  createPasswordValidator,
+  defaultPasswordSchema,
+  getPasswordStrength,
+  passwordValidator,
+  validatePassword
+} from "../../../chunk-G26T2PRQ.js";
+import {
+  PasswordHasher,
+  PasswordValidator
+} from "../../../chunk-IHXRF3BH.js";
+import "../../../chunk-6D3HHYER.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  DEFAULT_PASSWORD_CONFIG,
+  PasswordHasher,
+  PasswordValidator,
+  createPasswordHasher,
+  createPasswordSchema,
+  createPasswordValidator,
+  defaultPasswordSchema,
+  getPasswordStrength,
+  passwordValidator,
+  validatePassword
+};

package/dist/auth/core/password/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Shared Auth - Password Module
+ *
+ * 비밀번호 검증 및 강도 측정 모듈 (프레임워크 독립적)
+ */
+import { z } from 'zod';
+import type { PasswordConfig } from '@withwiz/auth/types';
+import { PasswordStrength, type PasswordValidationResult as BasePasswordValidationResult } from '@withwiz/auth/types';
+export interface PasswordValidationResult extends BasePasswordValidationResult {
+    score: number;
+}
+export declare class PasswordValidator {
+    private config;
+    private static readonly SPECIAL_CHARS;
+    constructor(config: PasswordConfig);
+    /**
+     * 비밀번호 유효성 검사
+     */
+    validate(password: string): PasswordValidationResult;
+    /**
+     * 비밀번호 확인 검증
+     */
+    validateConfirmation(password: string, confirmPassword: string): PasswordValidationResult;
+    /**
+     * 비밀번호 강도 계산
+     */
+    calculateStrength(password: string): PasswordStrength;
+    /**
+     * 비밀번호 점수 계산 (0-100)
+     */
+    private calculateScore;
+    /**
+     * Zod 스키마 생성
+     */
+    createZodSchema(): z.ZodString;
+    /**
+     * 비밀번호 힌트 생성
+     */
+    generateHint(password: string): string[];
+    /**
+     * 비밀번호 강도 메시지 반환
+     */
+    static getStrengthMessage(strength: PasswordStrength): string;
+    /**
+     * 비밀번호 강도 색상 반환 (Tailwind CSS)
+     */
+    static getStrengthColor(strength: PasswordStrength): string;
+}
+export declare class PasswordHasher {
+    private rounds;
+    constructor(rounds?: number);
+    /**
+     * 비밀번호 해싱
+     */
+    hash(password: string): Promise<string>;
+    /**
+     * 비밀번호 검증
+     */
+    verify(password: string, hash: string): Promise<boolean>;
+}
+/**
+ * 기본 비밀번호 스키마 (기존 코드 호환성)
+ * 최소 8자, 숫자 포함
+ */
+export declare const defaultPasswordSchema: z.ZodString;
+/**
+ * 강력한 비밀번호 스키마 (기존 코드 호환성)
+ * 최소 12자, 대소문자, 숫자, 특수문자 포함
+ */
+export declare const strongPasswordSchema: z.ZodString;
+export type { PasswordConfig, PasswordStrength } from '@withwiz/auth/types';

package/dist/auth/core/password/index.js

@@ -0,0 +1,14 @@
+import {
+  PasswordHasher,
+  PasswordValidator,
+  defaultPasswordSchema,
+  strongPasswordSchema
+} from "../../../chunk-IHXRF3BH.js";
+import "../../../chunk-6D3HHYER.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  PasswordHasher,
+  PasswordValidator,
+  defaultPasswordSchema,
+  strongPasswordSchema
+};

package/dist/auth/errors/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared Auth Errors
+ *
+ * 프레임워크 독립적인 인증 에러 클래스
+ */
+export declare class AuthError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+export declare class JWTError extends AuthError {
+    constructor(message: string, code?: string);
+}
+export declare class OAuthError extends AuthError {
+    constructor(message: string, code?: string);
+}
+export declare class EmailError extends AuthError {
+    constructor(message: string, code?: string);
+}
+export declare class PasswordError extends AuthError {
+    constructor(message: string, code?: string);
+}
+export declare const AUTH_ERROR_CODES: {
+    readonly TOKEN_EXPIRED: "TOKEN_EXPIRED";
+    readonly TOKEN_INVALID: "TOKEN_INVALID";
+    readonly TOKEN_CREATION_FAILED: "TOKEN_CREATION_FAILED";
+    readonly TOKEN_VERIFICATION_FAILED: "TOKEN_VERIFICATION_FAILED";
+    readonly REFRESH_TOKEN_EXPIRED: "REFRESH_TOKEN_EXPIRED";
+    readonly INVALID_PAYLOAD: "INVALID_PAYLOAD";
+    readonly OAUTH_PROVIDER_NOT_CONFIGURED: "OAUTH_PROVIDER_NOT_CONFIGURED";
+    readonly OAUTH_TOKEN_EXCHANGE_FAILED: "OAUTH_TOKEN_EXCHANGE_FAILED";
+    readonly OAUTH_USER_INFO_FAILED: "OAUTH_USER_INFO_FAILED";
+    readonly PASSWORD_TOO_SHORT: "PASSWORD_TOO_SHORT";
+    readonly PASSWORD_TOO_LONG: "PASSWORD_TOO_LONG";
+    readonly PASSWORD_MISSING_NUMBER: "PASSWORD_MISSING_NUMBER";
+    readonly PASSWORD_MISSING_UPPERCASE: "PASSWORD_MISSING_UPPERCASE";
+    readonly PASSWORD_MISSING_LOWERCASE: "PASSWORD_MISSING_LOWERCASE";
+    readonly PASSWORD_MISSING_SPECIAL_CHAR: "PASSWORD_MISSING_SPECIAL_CHAR";
+    readonly PASSWORD_HASH_FAILED: "PASSWORD_HASH_FAILED";
+    readonly PASSWORD_VERIFY_FAILED: "PASSWORD_VERIFY_FAILED";
+    readonly EMAIL_SEND_FAILED: "EMAIL_SEND_FAILED";
+    readonly EMAIL_TOKEN_INVALID: "EMAIL_TOKEN_INVALID";
+    readonly EMAIL_TOKEN_EXPIRED: "EMAIL_TOKEN_EXPIRED";
+    readonly INVALID_CREDENTIALS: "INVALID_CREDENTIALS";
+    readonly USER_NOT_FOUND: "USER_NOT_FOUND";
+    readonly EMAIL_ALREADY_EXISTS: "EMAIL_ALREADY_EXISTS";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+};
+export type AuthErrorCode = typeof AUTH_ERROR_CODES[keyof typeof AUTH_ERROR_CODES];

package/dist/auth/errors/index.js

@@ -0,0 +1,17 @@
+import {
+  AUTH_ERROR_CODES,
+  AuthError,
+  EmailError,
+  JWTError,
+  OAuthError,
+  PasswordError
+} from "../../chunk-AIH3F7JV.js";
+import "../../chunk-ORMEWXMH.js";
+export {
+  AUTH_ERROR_CODES,
+  AuthError,
+  EmailError,
+  JWTError,
+  OAuthError,
+  PasswordError
+};

package/dist/auth/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared Auth Module
+ *
+ * 프레임워크 독립적인 인증 라이브러리
+ * Next.js, Express, Fastify, NestJS 등 어디서나 사용 가능
+ *
+ * @version 1.0.0
+ * @description 범용 공유 라이브러리 - Tier 3
+ */
+export * from './types';
+export * from './errors';
+export { JWTManager, JWTService } from './core/jwt';
+export type { JWTConfig, JWTPayload, TokenPair } from './types';
+export { JWTClientManager, getStoredTokens, storeTokens, clearStoredTokens, clearTokens, decodeJWTPayload, isTokenExpired, getTokenRemainingTime, extractUserFromToken, createAuthHeader, createApiHeaders, isTokenExpiringSoon, getTokenExpirationString, getTokenIssuedAtString, } from './core/jwt/client';
+export { PasswordValidator, PasswordHasher, defaultPasswordSchema, strongPasswordSchema, } from './core/password';
+export type { PasswordValidationResult, PasswordConfig } from './core/password';
+export { DEFAULT_PASSWORD_CONFIG, createPasswordValidator, validatePassword, getPasswordStrength, createPasswordSchema, passwordValidator, createPasswordHasher, } from './core/password/client-helper';
+export { OAuthManager } from './core/oauth';
+export type { OAuthConfig, OAuthUserInfo, OAuthTokenResponse } from './core/oauth';
+export { TokenGenerator } from './core/email/token-generator';
+export { UserRole, PasswordStrength, OAuthProvider, TokenType } from './types';

package/dist/auth/index.js

@@ -0,0 +1,97 @@
+import {
+  OAuthManager
+} from "../chunk-V5K5FYU7.js";
+import {
+  TokenGenerator
+} from "../chunk-GDWEDUHO.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 {
+  JWTClientManager,
+  clearStoredTokens,
+  clearTokens,
+  createApiHeaders,
+  createAuthHeader,
+  decodeJWTPayload,
+  extractUserFromToken,
+  getStoredTokens,
+  getTokenExpirationString,
+  getTokenIssuedAtString,
+  getTokenRemainingTime,
+  isTokenExpired,
+  isTokenExpiringSoon,
+  storeTokens
+} from "../chunk-XRRPEBKB.js";
+import {
+  OAuthProvider,
+  PasswordStrength,
+  TokenType,
+  UserRole
+} from "../chunk-6D3HHYER.js";
+import {
+  JWTManager,
+  JWTService
+} from "../chunk-T3LJYAMO.js";
+import {
+  AUTH_ERROR_CODES,
+  AuthError,
+  EmailError,
+  JWTError,
+  OAuthError,
+  PasswordError
+} from "../chunk-AIH3F7JV.js";
+import "../chunk-ORMEWXMH.js";
+export {
+  AUTH_ERROR_CODES,
+  AuthError,
+  DEFAULT_PASSWORD_CONFIG,
+  EmailError,
+  JWTClientManager,
+  JWTError,
+  JWTManager,
+  JWTService,
+  OAuthError,
+  OAuthManager,
+  OAuthProvider,
+  PasswordError,
+  PasswordHasher,
+  PasswordStrength,
+  PasswordValidator,
+  TokenGenerator,
+  TokenType,
+  UserRole,
+  clearStoredTokens,
+  clearTokens,
+  createApiHeaders,
+  createAuthHeader,
+  createPasswordHasher,
+  createPasswordSchema,
+  createPasswordValidator,
+  decodeJWTPayload,
+  defaultPasswordSchema,
+  extractUserFromToken,
+  getPasswordStrength,
+  getStoredTokens,
+  getTokenExpirationString,
+  getTokenIssuedAtString,
+  getTokenRemainingTime,
+  isTokenExpired,
+  isTokenExpiringSoon,
+  passwordValidator,
+  storeTokens,
+  strongPasswordSchema,
+  validatePassword
+};