@k-msg/provider 0.3.0 → 0.5.0

package/dist/services/provider.manager.d.ts

@@ -1,24 +0,0 @@
-import type { BaseProvider, ProviderType, StandardRequest, StandardResult } from "@k-msg/core";
-import type { AlimTalkProvider, AlimTalkRequest, AlimTalkResult } from "../contracts/provider.contract";
-import type { SMSProvider, SMSRequest, SMSResult } from "../contracts/sms.contract";
-export declare class ProviderManager {
-    private providers;
-    private defaultProvider?;
-    registerProvider(provider: BaseProvider<StandardRequest, StandardResult>): void;
-    unregisterProvider(providerId: string): void;
-    getProvider(providerId?: string): BaseProvider<StandardRequest, StandardResult> | null;
-    getAlimTalkProvider(providerId?: string): AlimTalkProvider | null;
-    listProviders(): BaseProvider<StandardRequest, StandardResult>[];
-    listAlimTalkProviders(): AlimTalkProvider[];
-    setDefaultProvider(providerId: string): void;
-    healthCheckAll(): Promise<Record<string, boolean>>;
-    getProvidersForChannel(channel: string): BaseProvider<StandardRequest, StandardResult>[];
-    getProvidersByType(type: ProviderType): BaseProvider<StandardRequest, StandardResult>[];
-    getSMSProvider(providerId?: string): SMSProvider | null;
-    listSMSProviders(): SMSProvider[];
-    send<TRequest extends StandardRequest, TResult extends StandardResult>(providerId: string, request: TRequest): Promise<TResult>;
-    sendAlimTalk(providerId: string | undefined, request: AlimTalkRequest): Promise<AlimTalkResult>;
-    sendSMS(providerId: string | undefined, request: SMSRequest): Promise<SMSResult>;
-    private isAlimTalkProvider;
-    private isSMSProvider;
-}

package/dist/services/provider.service.d.ts

@@ -1,49 +0,0 @@
-import type { BaseProvider, StandardRequest, StandardResult } from "@k-msg/core";
-import type { AlimTalkProvider, AlimTalkRequest, AlimTalkResult } from "../contracts/provider.contract";
-/**
- * Manages the lifecycle and access to different messaging providers.
- */
-export declare class ProviderService {
-    private providers;
-    private defaultProviderId?;
-    /**
-     * @param defaultProviderId The ID of the provider to use when none is specified.
-     */
-    constructor(defaultProviderId?: string);
-    /**
-     * Registers a new provider instance.
-     * If no default provider is set, the first registered provider becomes the default.
-     * @param provider The provider instance to register.
-     */
-    register(provider: BaseProvider<StandardRequest, StandardResult>): void;
-    /**
-     * Retrieves a provider by its unique ID.
-     * @param providerId The ID of the provider.
-     * @returns The provider instance or undefined if not found.
-     */
-    get(providerId: string): BaseProvider<StandardRequest, StandardResult> | undefined;
-    /**
-     * Retrieves a typed AlimTalk provider by its unique ID.
-     * @param providerId The ID of the provider.
-     * @returns The AlimTalk provider instance or undefined if not found or not an AlimTalk provider.
-     */
-    getAlimTalk(providerId: string): AlimTalkProvider | undefined;
-    /**
-     * Retrieves the default provider.
-     * @returns The default provider instance or undefined if not set.
-     */
-    getDefault(): BaseProvider<StandardRequest, StandardResult> | undefined;
-    /**
-     * Lists all registered providers.
-     * @returns An array of all provider instances.
-     */
-    list(): BaseProvider<StandardRequest, StandardResult>[];
-    /**
-     * Lists all AlimTalk providers.
-     * @returns An array of AlimTalk provider instances.
-     */
-    listAlimTalk(): AlimTalkProvider[];
-    send<TRequest extends StandardRequest, TResult extends StandardResult>(providerId: string, request: TRequest): Promise<TResult>;
-    sendAlimTalk(providerId: string, request: AlimTalkRequest): Promise<AlimTalkResult>;
-    private isAlimTalkProvider;
-}

package/dist/test-helpers.d.ts

@@ -1,110 +0,0 @@
-/**
- * Test Helpers and Utilities
- * 테스트 헬퍼 및 유틸리티 함수들
- */
-import type { StandardRequest } from "@k-msg/core";
-import type { IWINVConfig } from "./iwinv/types/iwinv";
-export declare const TEST_CONFIGS: {
-    development: IWINVConfig;
-    production: IWINVConfig;
-    invalid: IWINVConfig;
-};
-export declare const createTestRequests: () => {
-    alimtalk: {
-        welcome: StandardRequest;
-        otp: StandardRequest;
-        order: StandardRequest;
-    };
-    sms: {
-        short: StandardRequest;
-        long: StandardRequest;
-    };
-    invalid: {
-        emptyPhone: StandardRequest;
-        invalidPhone: StandardRequest;
-        emptyTemplate: StandardRequest;
-    };
-};
-export declare const createBulkTestData: (count?: number) => {
-    templateCode: string;
-    phoneNumber: string;
-    variables: {
-        index: string;
-        name: string;
-        message: string;
-    };
-    channel: "alimtalk" | "sms" | "auto";
-}[];
-export declare const createPerformanceTracker: () => {
-    start: () => void;
-    end: () => void;
-    record: (success: boolean) => void;
-    getMetrics: () => {
-        startTime: number;
-        endTime: number;
-        duration: number;
-        memoryUsage: {
-            start: number;
-            end: number;
-            peak: number;
-        };
-        requestCount: number;
-        successCount: number;
-        errorCount: number;
-    };
-    reset: () => void;
-};
-export declare const createMockHttpResponse: (options?: {
-    success?: boolean;
-    delay?: number;
-    statusCode?: number;
-    data?: any;
-}) => Promise<unknown>;
-export declare const createConcurrencyTester: () => {
-    runConcurrent: <T>(operations: (() => Promise<T>)[], maxConcurrency?: number) => Promise<Array<{
-        result: T | null;
-        error: Error | null;
-        duration: number;
-    }>>;
-    testRateLimit: <T>(operation: () => Promise<T>, requestsPerSecond: number, duration: number) => Promise<{
-        attempted: number;
-        successful: number;
-        failed: number;
-        actualRate: number;
-    }>;
-};
-export declare const createValidationHelpers: () => {
-    isValidPhoneNumber: (phone: string) => boolean;
-    isValidTemplateCode: (code: string) => boolean;
-    containsSensitiveData: (variables: Record<string, string>) => boolean;
-    getMessageType: (message: string) => "sms" | "lms" | "mms";
-};
-export declare const createTestStateTracker: () => {
-    recordTest: (name: string, passed: boolean, duration: number, error?: string) => void;
-    skip: (name: string) => void;
-    getStats: () => {
-        totalTests: number;
-        passedTests: number;
-        failedTests: number;
-        skippedTests: number;
-        duration: number;
-        errors: Array<{
-            test: string;
-            error: string;
-        }>;
-    };
-    getSummary: () => {
-        successRate: number;
-        averageDuration: number;
-        totalTests: number;
-        passedTests: number;
-        failedTests: number;
-        skippedTests: number;
-        duration: number;
-        errors: Array<{
-            test: string;
-            error: string;
-        }>;
-    };
-    reset: () => void;
-};

package/dist/types/base.d.ts

@@ -1,172 +0,0 @@
-/**
- * 공통 프로바이더 인터페이스와 타입 정의
- * 모든 K-Message 프로바이더가 구현해야 하는 기본 인터페이스
- * 알림톡, 친구톡, SMS, LMS 등 다양한 메시징 채널 지원
- */
-export declare enum MessageChannel {
-    ALIMTALK = "alimtalk",// 카카오 알림톡
-    FRIENDTALK = "friendtalk",// 카카오 친구톡
-    SMS = "sms",// 단문 메시지
-    LMS = "lms",// 장문 메시지
-    MMS = "mms",// 멀티미디어 메시지
-    PUSH = "push",// 푸시 알림
-    EMAIL = "email"
-}
-export declare enum MessageType {
-    TEXT = "text",// 텍스트만
-    RICH = "rich",// 리치 메시지 (버튼, 이미지 등)
-    TEMPLATE = "template",// 템플릿 기반
-    CUSTOM = "custom"
-}
-export interface SendOptions {
-    channel?: MessageChannel;
-    messageType?: MessageType;
-    reserve?: boolean;
-    sendDate?: Date | string;
-    timezone?: string;
-    senderKey?: string;
-    senderNumber?: string;
-    senderName?: string;
-    enableFallback?: boolean;
-    fallbackChannel?: MessageChannel;
-    fallbackContent?: string;
-    fallbackTitle?: string;
-    title?: string;
-    subject?: string;
-    priority?: "high" | "normal" | "low";
-    trackingId?: string;
-    campaignId?: string;
-    tags?: string[];
-    attachments?: MediaAttachment[];
-    metadata?: Record<string, any>;
-}
-export interface MediaAttachment {
-    type: "image" | "video" | "audio" | "document";
-    url: string;
-    filename?: string;
-    size?: number;
-    mimeType?: string;
-}
-export interface TemplateFilters {
-    templateCode?: string;
-    templateName?: string;
-    templateStatus?: string;
-    [key: string]: any;
-}
-export interface HistoryFilters {
-    reserve?: "Y" | "N" | boolean;
-    startDate?: string | Date;
-    endDate?: string | Date;
-    messageId?: number | string;
-    phone?: string;
-    [key: string]: any;
-}
-export interface HealthCheckResult {
-    healthy: boolean;
-    issues: string[];
-    data?: {
-        balance?: number;
-        status: string;
-        code?: number;
-        message?: string;
-    } | null;
-}
-export interface SendResult {
-    success: boolean;
-    messageId: string | null;
-    status: string;
-    error: string | null;
-}
-export interface TemplateResult {
-    success: boolean;
-    templateCode: string | null;
-    status: string;
-    error: string | null;
-}
-export interface BaseProvider<TConfig = any> {
-    readonly id: string;
-    readonly name: string;
-    readonly supportedChannels: MessageChannel[];
-    readonly supportedTypes: MessageType[];
-    healthCheck(): Promise<HealthCheckResult>;
-    sendMessage?(recipient: string, // 수신자 (전화번호 또는 이메일)
-    content: MessageContent, options?: SendOptions): Promise<SendResult>;
-    sendTemplateMessage?(templateCode: string, phoneNumber: string, variables: Record<string, any>, options?: SendOptions): Promise<SendResult>;
-    createTemplate?(template: TemplateCreateRequest): Promise<TemplateResult>;
-    getTemplates?(pageNum?: number, pageSize?: number, filters?: TemplateFilters): Promise<any>;
-    modifyTemplate?(templateCode: string, template: TemplateUpdateRequest): Promise<TemplateResult>;
-    deleteTemplate?(templateCode: string): Promise<any>;
-    getHistory?(pageNum?: number, pageSize?: number, filters?: HistoryFilters): Promise<any>;
-    cancelReservation?(messageId: number | string): Promise<any>;
-    getSenderNumbers?(): Promise<SenderNumber[]>;
-    verifySenderNumber?(phoneNumber: string): Promise<SenderVerificationResult>;
-    getChannelInfo?(channel: MessageChannel): Promise<ChannelInfo>;
-}
-export interface MessageContent {
-    channel?: MessageChannel;
-    type?: MessageType;
-    text: string;
-    title?: string;
-    templateId?: string;
-    variables?: Record<string, any>;
-    buttons?: MessageButton[];
-    attachments?: MediaAttachment[];
-}
-export interface MessageButton {
-    type: "web" | "app" | "phone" | "delivery";
-    text: string;
-    url?: string;
-    scheme?: string;
-    phoneNumber?: string;
-}
-export interface TemplateCreateRequest {
-    name: string;
-    content: string;
-    channel: MessageChannel;
-    category?: string;
-    buttons?: MessageButton[];
-    variables?: string[];
-    description?: string;
-}
-export interface TemplateUpdateRequest {
-    name?: string;
-    content?: string;
-    buttons?: MessageButton[];
-    description?: string;
-}
-export interface SenderNumber {
-    phoneNumber: string;
-    name?: string;
-    verified: boolean;
-    verifiedAt?: Date;
-    status: "active" | "pending" | "rejected" | "blocked";
-}
-export interface SenderVerificationResult {
-    success: boolean;
-    phoneNumber: string;
-    status: string;
-    verificationCode?: string;
-    error?: string;
-}
-export interface ChannelInfo {
-    channel: MessageChannel;
-    available: boolean;
-    limits: {
-        maxLength?: number;
-        maxAttachments?: number;
-        maxAttachmentSize?: number;
-    };
-    features: {
-        supportsButtons: boolean;
-        supportsAttachments: boolean;
-        supportsTemplates: boolean;
-        supportsScheduling: boolean;
-    };
-}
-export interface BaseProviderConfig {
-    apiKey: string;
-    baseUrl?: string;
-    debug?: boolean;
-    timeout?: number;
-    retries?: number;
-}

package/dist/types/typed-templates.d.ts

@@ -1,199 +0,0 @@
-/**
- * Typed Template System
- * 템플릿별 강타입 시스템
- */
-import type { StandardRequest, StandardResult } from "@k-msg/core";
-export type MessageChannel = "alimtalk" | "sms" | "mms";
-export interface VariableType {
-    string: string;
-    number: number;
-    boolean: boolean;
-    date: string;
-    phoneNumber: string;
-    url: string;
-    email: string;
-}
-export interface VariableDefinition<T extends keyof VariableType = keyof VariableType> {
-    type: T;
-    required: boolean;
-    description?: string;
-    validation?: {
-        pattern?: RegExp;
-        minLength?: number;
-        maxLength?: number;
-        min?: number;
-        max?: number;
-    };
-    defaultValue?: VariableType[T];
-}
-export interface TemplateSchema<V extends Record<string, VariableDefinition> = Record<string, VariableDefinition>> {
-    templateCode: string;
-    name: string;
-    description?: string;
-    channels: MessageChannel[];
-    variables: V;
-    metadata?: {
-        category?: string;
-        version?: string;
-        author?: string;
-        createdAt?: string;
-        updatedAt?: string;
-    };
-}
-export interface TemplateRegistry {
-    WELCOME_001: TemplateSchema<{
-        name: VariableDefinition<"string">;
-        service: VariableDefinition<"string">;
-        date: VariableDefinition<"date">;
-    }>;
-    OTP_AUTH_001: TemplateSchema<{
-        code: VariableDefinition<"string">;
-        expiry: VariableDefinition<"string">;
-        serviceName: VariableDefinition<"string">;
-    }>;
-    ORDER_CONFIRM_001: TemplateSchema<{
-        orderNumber: VariableDefinition<"string">;
-        productName: VariableDefinition<"string">;
-        amount: VariableDefinition<"string">;
-        deliveryDate: VariableDefinition<"date">;
-        customerName: VariableDefinition<"string">;
-    }>;
-    PAYMENT_COMPLETE_001: TemplateSchema<{
-        amount: VariableDefinition<"string">;
-        paymentMethod: VariableDefinition<"string">;
-        transactionId: VariableDefinition<"string">;
-        customerName: VariableDefinition<"string">;
-    }>;
-    SMS_DIRECT: TemplateSchema<{
-        message: VariableDefinition<"string">;
-    }>;
-    LMS_DIRECT: TemplateSchema<{
-        subject: VariableDefinition<"string">;
-        message: VariableDefinition<"string">;
-    }>;
-    EMERGENCY_NOTIFICATION: TemplateSchema<{
-        alertType: VariableDefinition<"string">;
-        message: VariableDefinition<"string">;
-        contactInfo: VariableDefinition<"string">;
-        urgencyLevel: VariableDefinition<"string">;
-    }>;
-}
-export type TemplateCode = keyof TemplateRegistry;
-export type ExtractVariables<T extends TemplateCode> = {
-    [K in keyof TemplateRegistry[T]["variables"]]: TemplateRegistry[T]["variables"][K] extends VariableDefinition<infer VT> ? VariableType[VT] : never;
-};
-export type ExtractRequiredVariables<T extends TemplateCode> = {
-    [K in keyof TemplateRegistry[T]["variables"] as TemplateRegistry[T]["variables"][K] extends {
-        required: true;
-    } ? K : never]: TemplateRegistry[T]["variables"][K] extends VariableDefinition<infer VT> ? VariableType[VT] : never;
-};
-export type ExtractOptionalVariables<T extends TemplateCode> = {
-    [K in keyof TemplateRegistry[T]["variables"] as TemplateRegistry[T]["variables"][K] extends {
-        required: false;
-    } ? K : never]?: TemplateRegistry[T]["variables"][K] extends VariableDefinition<infer VT> ? VariableType[VT] : never;
-};
-export type TemplateVariables<T extends TemplateCode> = ExtractRequiredVariables<T> & ExtractOptionalVariables<T>;
-export type ExtractChannels<T extends TemplateCode> = TemplateRegistry[T]["channels"][number];
-export interface TypedRequest<T extends TemplateCode> {
-    templateCode: T;
-    phoneNumber: string;
-    variables: TemplateVariables<T>;
-    options?: {
-        senderNumber?: string;
-        scheduledAt?: Date;
-        priority?: "high" | "normal" | "low";
-        channel?: ExtractChannels<T>;
-        subject?: string;
-    };
-}
-export interface TypedResult<T extends TemplateCode> {
-    messageId: string;
-    templateCode: T;
-    phoneNumber: string;
-    channel: ExtractChannels<T>;
-    status: "sent" | "pending" | "failed";
-    timestamp: Date;
-    variables: TemplateVariables<T>;
-    error?: {
-        code: string;
-        message: string;
-        retryable: boolean;
-    };
-}
-/**
- * TypedRequest를 StandardRequest로 변환하는 유틸리티 타입
- */
-export type ToStandardRequest<T extends TemplateCode> = StandardRequest & {
-    templateCode: T;
-    variables: Record<string, string>;
-};
-/**
- * StandardResult를 TypedResult로 변환하는 유틸리티 타입
- */
-export type ToTypedResult<T extends TemplateCode> = Omit<TypedResult<T>, "templateCode" | "channel"> & {
-    templateCode: T;
-    channel: ExtractChannels<T>;
-};
-/**
- * 타입 안전한 템플릿 변환 함수들
- */
-export declare class TemplateTypeConverter {
-    /**
-     * TypedRequest를 StandardRequest로 변환
-     */
-    static toStandardRequest<T extends TemplateCode>(typedRequest: TypedRequest<T>): StandardRequest;
-    /**
-     * StandardResult를 TypedResult로 변환
-     */
-    static toTypedResult<T extends TemplateCode>(standardResult: StandardResult, templateCode: T, originalVariables: TemplateVariables<T>): TypedResult<T>;
-    /**
-     * 템플릿 코드로부터 채널 추론
-     */
-    private static inferChannel;
-    /**
-     * StandardStatus를 TypedResult 상태로 매핑
-     */
-    private static mapStandardStatus;
-}
-/**
- * 타입 안전한 Provider 래퍼
- * 기존 Provider를 감싸서 타입 안전성을 제공
- */
-export declare class TypedProvider {
-    private provider;
-    constructor(provider: import("@k-msg/core").BaseProvider);
-    /**
-     * 타입 안전한 메시지 전송
-     */
-    send<T extends TemplateCode>(request: TypedRequest<T>): Promise<TypedResult<T>>;
-    /**
-     * 대량 전송 (타입 안전)
-     */
-    sendBulk<T extends TemplateCode>(requests: TypedRequest<T>[], options?: {
-        batchSize?: number;
-        concurrency?: number;
-        failFast?: boolean;
-    }): Promise<TypedResult<T>[]>;
-    /**
-     * 상태 조회 (타입 안전하지 않은 부분 - messageId만 필요)
-     */
-    getStatus(messageId: string): Promise<import("@k-msg/core").DeliveryStatus>;
-    /**
-     * 기본 Provider 접근 (고급 사용자용)
-     */
-    getUnderlyingProvider(): import("@k-msg/core").BaseProvider<StandardRequest, StandardResult>;
-}
-export declare const TEMPLATE_REGISTRY: TemplateRegistry;
-export declare class TemplateValidator {
-    static validateVariables<T extends TemplateCode>(templateCode: T, variables: Record<string, any>): ValidationResult<TemplateVariables<T>>;
-    static validateChannel<T extends TemplateCode>(templateCode: T, channel: string): boolean;
-    private static validateType;
-    private static validateValue;
-    private static applyDefaults;
-}
-export interface ValidationResult<T> {
-    isValid: boolean;
-    errors: string[];
-    warnings: string[];
-    validatedVariables: T;
-}