@k-msg/channel 0.28.0 → 0.29.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,14 +1,9 @@
1
1
  import { type SenderNumber, type SenderNumberCategory, type SenderNumberCreateRequest, SenderNumberStatus } from "../../types/channel.types";
2
2
  export declare class KakaoSenderNumberManager {
3
3
  private senderNumbers;
4
- private verificationCodes;
5
4
  addSenderNumber(channelId: string, request: SenderNumberCreateRequest): Promise<SenderNumber>;
6
5
  private validatePhoneNumber;
7
6
  private findSenderNumberByPhone;
8
- private initiateVerification;
9
- private sendVerificationSMS;
10
- verifySenderNumber(senderNumberId: string, code: string): Promise<boolean>;
11
- resendVerificationCode(senderNumberId: string): Promise<void>;
12
7
  getSenderNumber(senderNumberId: string): Promise<SenderNumber | null>;
13
8
  listSenderNumbers(filters?: {
14
9
  channelId?: string;
@@ -26,6 +21,4 @@ export declare class KakaoSenderNumberManager {
26
21
  errors: string[];
27
22
  }>;
28
23
  private generateSenderNumberId;
29
- private generateVerificationCode;
30
- cleanup(): void;
31
24
  }
@@ -1,4 +1,4 @@
1
- import type { ChannelConfig, ChannelVerificationResult } from "../../types/channel.types";
1
+ import type { ChannelConfig } from "../../types/channel.types";
2
2
  import { SenderNumberStatus } from "../../types/channel.types";
3
3
  export interface ServiceSenderNumber {
4
4
  phoneNumber: string;
@@ -16,7 +16,6 @@ export declare class ChannelService {
16
16
  updateChannel(channelId: string, updates: Partial<ChannelConfig>): Promise<ChannelConfig>;
17
17
  deleteChannel(channelId: string): Promise<void>;
18
18
  addSenderNumber(channelId: string, phoneNumber: string, name?: string): Promise<ServiceSenderNumber>;
19
- verifySenderNumber(phoneNumber: string): Promise<ChannelVerificationResult>;
20
19
  getSenderNumbers(channelId?: string): Promise<ServiceSenderNumber[]>;
21
20
  private generateChannelId;
22
21
  }
@@ -36,7 +36,6 @@ export interface SenderNumber {
36
36
  channelId?: string;
37
37
  phoneNumber: string;
38
38
  status: SenderNumberStatus;
39
- verificationCode?: string;
40
39
  verifiedAt?: Date;
41
40
  category: SenderNumberCategory;
42
41
  metadata: {
@@ -221,13 +220,7 @@ export interface ChannelConfig {
221
220
  type: "alimtalk" | "sms" | "lms" | "friendtalk";
222
221
  providerId: string;
223
222
  active: boolean;
224
- settings: Record<string, any>;
223
+ settings: Record<string, unknown>;
225
224
  createdAt: Date;
226
225
  updatedAt: Date;
227
226
  }
228
- export interface ChannelVerificationResult {
229
- success: boolean;
230
- status: string;
231
- verificationCode?: string;
232
- error?: string;
233
- }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@k-msg/channel",
3
- "version": "0.28.0",
3
+ "version": "0.29.0",
4
4
  "packageManager": "bun@1.3.8",
5
5
  "description": "AlimTalk channel and sender number management",
6
6
  "type": "module",
@@ -29,12 +29,14 @@
29
29
  "build:types": "tsc",
30
30
  "dev": "tsc --watch",
31
31
  "test": "bun test",
32
+ "test:unit": "bun test --testPathPattern='.*\\.test\\.(ts|js)$' --testTimeout=5000",
33
+ "typecheck": "tsc --noEmit",
32
34
  "clean": "rm -rf dist tsconfig.tsbuildinfo",
33
35
  "pack": "bun pm pack",
34
36
  "publish": "bun publish --access public"
35
37
  },
36
38
  "dependencies": {
37
- "@k-msg/core": "0.28.0",
39
+ "@k-msg/core": "0.29.0",
38
40
  "zod": "^4.0.14"
39
41
  },
40
42
  "devDependencies": {
@@ -1,189 +0,0 @@
1
- /**
2
- * Phone Number Verification System
3
- * 발신번호 인증 및 검증 시스템
4
- */
5
- import { EventEmitter } from "../shared/event-emitter";
6
- export interface PhoneVerificationRequest {
7
- id: string;
8
- senderNumberId: string;
9
- phoneNumber: string;
10
- verificationType: VerificationType;
11
- verificationCode: string;
12
- status: PhoneVerificationStatus;
13
- attempts: VerificationAttempt[];
14
- expiresAt: Date;
15
- createdAt: Date;
16
- completedAt?: Date;
17
- metadata: {
18
- userAgent?: string;
19
- ipAddress?: string;
20
- deviceId?: string;
21
- smsProvider?: string;
22
- callProvider?: string;
23
- };
24
- }
25
- export interface VerificationAttempt {
26
- /**
27
- * Distinguish provider/send attempts from user verification attempts.
28
- * This prevents send failures from consuming user attempt limits.
29
- */
30
- purpose?: "send" | "verify";
31
- attemptNumber: number;
32
- attemptedAt: Date;
33
- method: VerificationMethod;
34
- status: "sent" | "delivered" | "failed" | "verified" | "expired";
35
- failureReason?: string;
36
- responseTime?: number;
37
- }
38
- export declare enum VerificationType {
39
- SMS = "sms",
40
- VOICE_CALL = "voice_call",
41
- HYBRID = "hybrid"
42
- }
43
- export declare enum VerificationMethod {
44
- SMS = "sms",
45
- VOICE_CALL = "voice_call",
46
- MISSED_CALL = "missed_call"
47
- }
48
- export declare enum PhoneVerificationStatus {
49
- PENDING = "pending",
50
- CODE_SENT = "code_sent",
51
- VERIFIED = "verified",
52
- FAILED = "failed",
53
- EXPIRED = "expired",
54
- BLOCKED = "blocked"
55
- }
56
- export interface NumberVerifierOptions {
57
- codeLength: number;
58
- codeExpiryMinutes: number;
59
- maxAttempts: number;
60
- maxDailyAttempts: number;
61
- smsTemplate: string;
62
- voiceTemplate: string;
63
- rateLimitMinutes: number;
64
- enableVoiceFallback: boolean;
65
- enableMissedCallVerification: boolean;
66
- blockedNumbers: string[];
67
- allowedCountries: string[];
68
- smsProvider?: SMSProvider;
69
- voiceProvider?: VoiceProvider;
70
- }
71
- export interface SMSProvider {
72
- id: string;
73
- name: string;
74
- sendSMS(phoneNumber: string, message: string, options?: unknown): Promise<SMSResult>;
75
- getDeliveryStatus?(messageId: string): Promise<DeliveryStatus>;
76
- }
77
- export interface VoiceProvider {
78
- id: string;
79
- name: string;
80
- makeCall(phoneNumber: string, message: string, options?: unknown): Promise<VoiceResult>;
81
- makeMissedCall?(phoneNumber: string, options?: unknown): Promise<MissedCallResult>;
82
- }
83
- export interface SMSResult {
84
- messageId: string;
85
- status: "sent" | "failed";
86
- cost?: number;
87
- error?: string;
88
- }
89
- export interface VoiceResult {
90
- callId: string;
91
- status: "initiated" | "answered" | "failed" | "busy" | "no_answer";
92
- duration?: number;
93
- cost?: number;
94
- error?: string;
95
- }
96
- export interface MissedCallResult {
97
- callId: string;
98
- status: "initiated" | "completed" | "failed";
99
- missedCallNumber?: string;
100
- error?: string;
101
- }
102
- export interface DeliveryStatus {
103
- messageId: string;
104
- status: "pending" | "delivered" | "failed" | "expired";
105
- deliveredAt?: Date;
106
- failureReason?: string;
107
- }
108
- export interface PhoneNumberInfo {
109
- phoneNumber: string;
110
- countryCode: string;
111
- nationalNumber: string;
112
- carrier?: string;
113
- lineType?: "mobile" | "landline" | "voip" | "unknown";
114
- isValid: boolean;
115
- isPossible: boolean;
116
- region?: string;
117
- }
118
- export declare class NumberVerifier extends EventEmitter {
119
- private options;
120
- private verificationRequests;
121
- private phoneNumberCache;
122
- private rateLimitTracker;
123
- private dailyAttemptTracker;
124
- private blockedNumbers;
125
- private defaultOptions;
126
- constructor(options?: Partial<NumberVerifierOptions>);
127
- /**
128
- * Start phone number verification process
129
- */
130
- startVerification(senderNumberId: string, phoneNumber: string, verificationType?: VerificationType, metadata?: PhoneVerificationRequest["metadata"]): Promise<PhoneVerificationRequest>;
131
- /**
132
- * Verify the provided code
133
- */
134
- verifyCode(requestId: string, providedCode: string): Promise<{
135
- success: boolean;
136
- status: PhoneVerificationStatus;
137
- message: string;
138
- }>;
139
- /**
140
- * Resend verification code
141
- */
142
- resendCode(requestId: string, method?: VerificationMethod): Promise<PhoneVerificationRequest>;
143
- /**
144
- * Get verification request status
145
- */
146
- getVerificationStatus(requestId: string): PhoneVerificationRequest | null;
147
- /**
148
- * Cancel verification request
149
- */
150
- cancelVerification(requestId: string): Promise<boolean>;
151
- /**
152
- * Block a phone number from verification
153
- */
154
- blockPhoneNumber(phoneNumber: string, reason?: string): void;
155
- /**
156
- * Unblock a phone number
157
- */
158
- unblockPhoneNumber(phoneNumber: string): void;
159
- /**
160
- * Get verification statistics
161
- */
162
- getVerificationStats(): {
163
- total: number;
164
- byStatus: Record<string, number>;
165
- byMethod: Record<string, number>;
166
- successRate: number;
167
- averageCompletionTime: number;
168
- };
169
- /**
170
- * Clean up expired verification requests
171
- */
172
- cleanup(): number;
173
- private sendVerificationCode;
174
- private sendVerificationByMethod;
175
- private sendSMS;
176
- private sendVoiceCall;
177
- private sendMissedCall;
178
- private getPhoneNumberInfo;
179
- private parseKoreanPhoneNumber;
180
- private isNumberBlocked;
181
- private isRateLimited;
182
- private isDailyLimitExceeded;
183
- private updateRateLimit;
184
- private updateDailyAttempts;
185
- private normalizePhoneNumber;
186
- private validateCode;
187
- private generateVerificationCode;
188
- private generateRequestId;
189
- }