@k-msg/channel 0.1.0 → 0.1.2

package/dist/verification/number.verify.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Phone Number Verification System
+ * 발신번호 인증 및 검증 시스템
+ */
+import { EventEmitter } from "events";
+export interface PhoneVerificationRequest {
+    id: string;
+    senderNumberId: string;
+    phoneNumber: string;
+    verificationType: VerificationType;
+    verificationCode: string;
+    status: PhoneVerificationStatus;
+    attempts: VerificationAttempt[];
+    expiresAt: Date;
+    createdAt: Date;
+    completedAt?: Date;
+    metadata: {
+        userAgent?: string;
+        ipAddress?: string;
+        deviceId?: string;
+        smsProvider?: string;
+        callProvider?: string;
+    };
+}
+export interface VerificationAttempt {
+    attemptNumber: number;
+    attemptedAt: Date;
+    method: VerificationMethod;
+    status: "sent" | "delivered" | "failed" | "verified" | "expired";
+    failureReason?: string;
+    responseTime?: number;
+}
+export declare enum VerificationType {
+    SMS = "sms",
+    VOICE_CALL = "voice_call",
+    HYBRID = "hybrid"
+}
+export declare enum VerificationMethod {
+    SMS = "sms",
+    VOICE_CALL = "voice_call",
+    MISSED_CALL = "missed_call"
+}
+export declare enum PhoneVerificationStatus {
+    PENDING = "pending",
+    CODE_SENT = "code_sent",
+    VERIFIED = "verified",
+    FAILED = "failed",
+    EXPIRED = "expired",
+    BLOCKED = "blocked"
+}
+export interface NumberVerifierOptions {
+    codeLength: number;
+    codeExpiryMinutes: number;
+    maxAttempts: number;
+    maxDailyAttempts: number;
+    smsTemplate: string;
+    voiceTemplate: string;
+    rateLimitMinutes: number;
+    enableVoiceFallback: boolean;
+    enableMissedCallVerification: boolean;
+    blockedNumbers: string[];
+    allowedCountries: string[];
+    smsProvider?: SMSProvider;
+    voiceProvider?: VoiceProvider;
+}
+export interface SMSProvider {
+    id: string;
+    name: string;
+    sendSMS(phoneNumber: string, message: string, options?: any): Promise<SMSResult>;
+    getDeliveryStatus?(messageId: string): Promise<DeliveryStatus>;
+}
+export interface VoiceProvider {
+    id: string;
+    name: string;
+    makeCall(phoneNumber: string, message: string, options?: any): Promise<VoiceResult>;
+    makeMissedCall?(phoneNumber: string, options?: any): Promise<MissedCallResult>;
+}
+export interface SMSResult {
+    messageId: string;
+    status: "sent" | "failed";
+    cost?: number;
+    error?: string;
+}
+export interface VoiceResult {
+    callId: string;
+    status: "initiated" | "answered" | "failed" | "busy" | "no_answer";
+    duration?: number;
+    cost?: number;
+    error?: string;
+}
+export interface MissedCallResult {
+    callId: string;
+    status: "initiated" | "completed" | "failed";
+    missedCallNumber?: string;
+    error?: string;
+}
+export interface DeliveryStatus {
+    messageId: string;
+    status: "pending" | "delivered" | "failed" | "expired";
+    deliveredAt?: Date;
+    failureReason?: string;
+}
+export interface PhoneNumberInfo {
+    phoneNumber: string;
+    countryCode: string;
+    nationalNumber: string;
+    carrier?: string;
+    lineType?: "mobile" | "landline" | "voip" | "unknown";
+    isValid: boolean;
+    isPossible: boolean;
+    region?: string;
+}
+export declare class NumberVerifier extends EventEmitter {
+    private options;
+    private verificationRequests;
+    private phoneNumberCache;
+    private rateLimitTracker;
+    private dailyAttemptTracker;
+    private blockedNumbers;
+    private defaultOptions;
+    constructor(options?: Partial<NumberVerifierOptions>);
+    /**
+     * Start phone number verification process
+     */
+    startVerification(senderNumberId: string, phoneNumber: string, verificationType?: VerificationType, metadata?: PhoneVerificationRequest["metadata"]): Promise<PhoneVerificationRequest>;
+    /**
+     * Verify the provided code
+     */
+    verifyCode(requestId: string, providedCode: string): Promise<{
+        success: boolean;
+        status: PhoneVerificationStatus;
+        message: string;
+    }>;
+    /**
+     * Resend verification code
+     */
+    resendCode(requestId: string, method?: VerificationMethod): Promise<PhoneVerificationRequest>;
+    /**
+     * Get verification request status
+     */
+    getVerificationStatus(requestId: string): PhoneVerificationRequest | null;
+    /**
+     * Cancel verification request
+     */
+    cancelVerification(requestId: string): Promise<boolean>;
+    /**
+     * Block a phone number from verification
+     */
+    blockPhoneNumber(phoneNumber: string, reason?: string): void;
+    /**
+     * Unblock a phone number
+     */
+    unblockPhoneNumber(phoneNumber: string): void;
+    /**
+     * Get verification statistics
+     */
+    getVerificationStats(): {
+        total: number;
+        byStatus: Record<string, number>;
+        byMethod: Record<string, number>;
+        successRate: number;
+        averageCompletionTime: number;
+    };
+    /**
+     * Clean up expired verification requests
+     */
+    cleanup(): number;
+    private sendVerificationCode;
+    private sendVerificationByMethod;
+    private sendSMS;
+    private sendVoiceCall;
+    private sendMissedCall;
+    private getPhoneNumberInfo;
+    private parseKoreanPhoneNumber;
+    private isNumberBlocked;
+    private isRateLimited;
+    private isDailyLimitExceeded;
+    private updateRateLimit;
+    private updateDailyAttempts;
+    private validateCode;
+    private generateVerificationCode;
+    private generateRequestId;
+}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@k-msg/channel",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "packageManager": "bun@1.3.8",
   "description": "AlimTalk channel and sender number management",
   "type": "module",
   "main": "dist/index.js",
@@ -17,19 +18,23 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "bun run build:esm && bun run build:cjs && bun run build:types",
+    "build:esm": "bun build ./src/index.ts --outdir ./dist --format esm --minify --sourcemap --entry-naming '[name].mjs' --external 'bun:test'",
+    "build:cjs": "bun build ./src/index.ts --outdir ./dist --format cjs --minify --sourcemap --entry-naming '[name].js' --external 'bun:test'",
+    "build:types": "tsc",
     "dev": "tsc --watch",
     "test": "bun test",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "pack": "bun pm pack",
+    "publish": "bun publish --access public"
   },
   "dependencies": {
-    "zod": "catalog:"
+    "zod": "^4.0.14"
   },
   "devDependencies": {
-    "typescript": "catalog:",
-    "@types/bun": "catalog:",
-    "@types/node": "catalog:",
-    "tsup": "^8.5.0"
+    "typescript": "^5.7.2",
+    "@types/bun": "latest",
+    "@types/node": "^22.0.0"
   },
   "keywords": [
     "alimtalk",
@@ -44,12 +49,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/k-otp/k-message.git"
+    "url": "git+https://github.com/k-otp/k-msg.git"
   },
-  "homepage": "https://github.com/k-otp/k-message",
+  "homepage": "https://github.com/k-otp/k-msg",
   "bugs": {
-    "url": "https://github.com/k-otp/k-message/issues"
+    "url": "https://github.com/k-otp/k-msg/issues"
   },
   "author": "imjlk",
   "license": "MIT"
-}
+}