@k-msg/provider 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -1,1425 +0,0 @@
-import { EventEmitter } from 'events';
-import { BaseProvider as BaseProvider$1 } from '@k-msg/core';
-
-/**
- * 공통 프로바이더 인터페이스와 타입 정의
- * 모든 K-Message 프로바이더가 구현해야 하는 기본 인터페이스
- * 알림톡, 친구톡, SMS, LMS 등 다양한 메시징 채널 지원
- */
-declare enum MessageChannel {
-    ALIMTALK = "alimtalk",// 카카오 알림톡
-    FRIENDTALK = "friendtalk",// 카카오 친구톡
-    SMS = "sms",// 단문 메시지
-    LMS = "lms",// 장문 메시지
-    MMS = "mms",// 멀티미디어 메시지
-    PUSH = "push",// 푸시 알림
-    EMAIL = "email"
-}
-declare enum MessageType {
-    TEXT = "text",// 텍스트만
-    RICH = "rich",// 리치 메시지 (버튼, 이미지 등)
-    TEMPLATE = "template",// 템플릿 기반
-    CUSTOM = "custom"
-}
-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>;
-}
-interface MediaAttachment {
-    type: 'image' | 'video' | 'audio' | 'document';
-    url: string;
-    filename?: string;
-    size?: number;
-    mimeType?: string;
-}
-interface TemplateFilters$1 {
-    templateCode?: string;
-    templateName?: string;
-    templateStatus?: string;
-    [key: string]: any;
-}
-interface HistoryFilters {
-    reserve?: 'Y' | 'N' | boolean;
-    startDate?: string | Date;
-    endDate?: string | Date;
-    messageId?: number | string;
-    phone?: string;
-    [key: string]: any;
-}
-interface HealthCheckResult {
-    healthy: boolean;
-    issues: string[];
-    data?: {
-        balance?: number;
-        status: string;
-        code?: number;
-        message?: string;
-    } | null;
-}
-interface SendResult {
-    success: boolean;
-    messageId: string | null;
-    status: string;
-    error: string | null;
-}
-interface TemplateResult {
-    success: boolean;
-    templateCode: string | null;
-    status: string;
-    error: string | null;
-}
-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$1): Promise<TemplateResult>;
-    getTemplates?(pageNum?: number, pageSize?: number, filters?: TemplateFilters$1): Promise<any>;
-    modifyTemplate?(templateCode: string, template: TemplateUpdateRequest$1): 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$1[]>;
-    verifySenderNumber?(phoneNumber: string): Promise<SenderVerificationResult>;
-    getChannelInfo?(channel: MessageChannel): Promise<ChannelInfo>;
-}
-interface MessageContent {
-    channel?: MessageChannel;
-    type?: MessageType;
-    text: string;
-    title?: string;
-    templateId?: string;
-    variables?: Record<string, any>;
-    buttons?: MessageButton[];
-    attachments?: MediaAttachment[];
-}
-interface MessageButton {
-    type: 'web' | 'app' | 'phone' | 'delivery';
-    text: string;
-    url?: string;
-    scheme?: string;
-    phoneNumber?: string;
-}
-interface TemplateCreateRequest$1 {
-    name: string;
-    content: string;
-    channel: MessageChannel;
-    category?: string;
-    buttons?: MessageButton[];
-    variables?: string[];
-    description?: string;
-}
-interface TemplateUpdateRequest$1 {
-    name?: string;
-    content?: string;
-    buttons?: MessageButton[];
-    description?: string;
-}
-interface SenderNumber$1 {
-    phoneNumber: string;
-    name?: string;
-    verified: boolean;
-    verifiedAt?: Date;
-    status: 'active' | 'pending' | 'rejected' | 'blocked';
-}
-interface SenderVerificationResult {
-    success: boolean;
-    phoneNumber: string;
-    status: string;
-    verificationCode?: string;
-    error?: string;
-}
-interface ChannelInfo {
-    channel: MessageChannel;
-    available: boolean;
-    limits: {
-        maxLength?: number;
-        maxAttachments?: number;
-        maxAttachmentSize?: number;
-    };
-    features: {
-        supportsButtons: boolean;
-        supportsAttachments: boolean;
-        supportsTemplates: boolean;
-        supportsScheduling: boolean;
-    };
-}
-interface BaseProviderConfig {
-    apiKey: string;
-    baseUrl?: string;
-    debug?: boolean;
-    timeout?: number;
-    retries?: number;
-}
-
-interface MessagingService {
-    sendMessage(params: SendMessageParams): Promise<SendMessageResult>;
-    sendBulk(params: BulkMessageParams): Promise<BulkMessageResult>;
-    getDeliveryStatus?(messageId: string): Promise<DeliveryStatus>;
-}
-interface SchedulingService {
-    schedule(params: ScheduleMessageParams): Promise<ScheduleResult$1>;
-    cancelSchedule(params: CancelScheduleParams): Promise<void>;
-    modifySchedule?(params: ModifyScheduleParams): Promise<ScheduleResult$1>;
-}
-interface TemplatingService {
-    createTemplate(params: TemplateParams): Promise<Template$1>;
-    updateTemplate(templateId: string, params: TemplateParams): Promise<Template$1>;
-    deleteTemplate(templateId: string): Promise<void>;
-    getTemplate(templateId: string): Promise<Template$1>;
-    listTemplates(params?: ListTemplatesParams): Promise<TemplateList>;
-    validateTemplate(params: TemplateParams): Promise<ValidationResult>;
-}
-interface AnalyticsService {
-    getStats(params: AnalyticsParams): Promise<AnalyticsData>;
-    getDeliveryReport(messageId: string): Promise<DeliveryReport$1>;
-}
-interface WebhookService {
-    registerWebhook(params: WebhookParams): Promise<WebhookRegistration>;
-    updateWebhook(webhookId: string, params: WebhookParams): Promise<WebhookRegistration>;
-    deleteWebhook(webhookId: string): Promise<void>;
-    listWebhooks(): Promise<WebhookRegistration[]>;
-}
-interface BalanceService {
-    getBalance(): Promise<BalanceInfo>;
-    getRate?(): Promise<RateInfo>;
-}
-interface HistoryService {
-    getHistory(params: HistoryParams): Promise<HistoryList>;
-    getMessageDetail(messageId: string): Promise<MessageDetail>;
-}
-interface SendMessageParams {
-    to: string;
-    templateId?: string;
-    message?: string;
-    variables?: Record<string, string>;
-    resend?: ResendConfig;
-}
-interface BulkMessageParams {
-    templateId: string;
-    messages: Array<{
-        to: string;
-        variables?: Record<string, string>;
-    }>;
-    resend?: ResendConfig;
-}
-interface ResendConfig {
-    from: string;
-    content?: string;
-    title?: string;
-}
-interface SendMessageResult {
-    messageId: string;
-    status: 'SUCCESS' | 'FAILED' | 'PENDING';
-    statusCode?: string;
-    remainingBalance?: number;
-    creditsUsed?: number;
-}
-interface BulkMessageResult {
-    messageIds: string[];
-    successCount: number;
-    failureCount: number;
-    results: Array<{
-        status: 'SUCCESS' | 'FAILED';
-        statusCode?: string;
-        messageId?: string;
-    }>;
-    remainingBalance?: number;
-    creditsUsed?: number;
-}
-interface ScheduleMessageParams {
-    templateId: string;
-    messages: Array<{
-        to: string;
-        variables?: Record<string, string>;
-    }>;
-    scheduledAt: Date;
-    resend?: ResendConfig;
-}
-interface ScheduleResult$1 {
-    scheduleId: string;
-    scheduledAt: Date;
-    messageCount: number;
-}
-interface CancelScheduleParams {
-    scheduleId: string;
-}
-interface ModifyScheduleParams {
-    scheduleId: string;
-    scheduledAt?: Date;
-    messages?: Array<{
-        to: string;
-        variables?: Record<string, string>;
-    }>;
-}
-interface TemplateParams {
-    name: string;
-    content: string;
-    variables?: string[];
-    buttons?: TemplateButton[];
-}
-interface TemplateButton {
-    type: string;
-    name: string;
-    linkMobile?: string;
-    linkPc?: string;
-    linkIos?: string;
-    linkAndroid?: string;
-}
-interface Template$1 {
-    id: string;
-    name: string;
-    content: string;
-    status: 'ACTIVE' | 'PENDING' | 'REJECTED';
-    variables: string[];
-    buttons?: TemplateButton[];
-    createdAt: Date;
-    updatedAt: Date;
-}
-interface ListTemplatesParams {
-    page?: number;
-    pageSize?: number;
-    templateCode?: string;
-    templateName?: string;
-    status?: string;
-}
-interface TemplateList {
-    items: Template$1[];
-    totalCount: number;
-    currentPage: number;
-    totalPages: number;
-}
-interface ValidationResult {
-    valid: boolean;
-    errors?: string[];
-}
-interface DeliveryStatus {
-    messageId: string;
-    status: 'PENDING' | 'SENT' | 'DELIVERED' | 'FAILED' | 'EXPIRED';
-    sentAt?: Date;
-    deliveredAt?: Date;
-    failureReason?: string;
-}
-interface AnalyticsParams {
-    startDate: Date;
-    endDate: Date;
-    templateIds?: string[];
-    metrics?: string[];
-}
-interface AnalyticsData {
-    sent: number;
-    delivered: number;
-    failed: number;
-    deliveryRate: number;
-    templateStats?: Record<string, any>;
-}
-interface DeliveryReport$1 {
-    messageId: string;
-    templateId?: string;
-    recipient: string;
-    status: string;
-    sentAt: Date;
-    deliveredAt?: Date;
-    events: Array<{
-        timestamp: Date;
-        event: string;
-        description?: string;
-    }>;
-}
-interface WebhookParams {
-    url: string;
-    events: string[];
-    secretKey?: string;
-}
-interface WebhookRegistration {
-    id: string;
-    url: string;
-    events: string[];
-    isActive: boolean;
-    createdAt: Date;
-}
-interface BalanceInfo {
-    amount: number;
-    currency: string;
-    lastUpdated: Date;
-}
-interface RateInfo {
-    messageRate: number;
-    currency: string;
-    unit: string;
-}
-interface HistoryParams {
-    startDate?: Date;
-    endDate?: Date;
-    phoneNumber?: string;
-    templateId?: string;
-    status?: string;
-    page?: number;
-    pageSize?: number;
-}
-interface HistoryList {
-    items: MessageDetail[];
-    totalCount: number;
-    currentPage: number;
-    totalPages: number;
-}
-interface MessageDetail {
-    messageId: string;
-    phoneNumber: string;
-    templateId?: string;
-    content: string;
-    status: string;
-    sentAt: Date;
-    deliveredAt?: Date;
-    failureReason?: string;
-    creditsUsed: number;
-}
-
-interface ProviderPlugin {
-    readonly metadata: ProviderMetadata;
-    readonly capabilities: ProviderCapabilities$1;
-    initialize(context: PluginContext): Promise<void>;
-    destroy(): Promise<void>;
-    middleware?: ProviderMiddleware[];
-    getImplementation(): ProviderImplementation;
-}
-interface ProviderMetadata {
-    name: string;
-    version: string;
-    author: string;
-    description: string;
-    homepage?: string;
-    repository?: string;
-}
-interface ProviderCapabilities$1 {
-    messaging: {
-        single: boolean;
-        bulk: boolean;
-        maxBulkSize?: number;
-        maxMessageLength?: number;
-        variableSupport?: boolean;
-        maxVariables?: number;
-    };
-    scheduling?: {
-        supported: boolean;
-        maxAdvanceDays?: number;
-        minAdvanceMinutes?: number;
-        modifiable?: boolean;
-        cancellable?: boolean;
-    };
-    templating?: {
-        supported: boolean;
-        crud: boolean;
-        validation: boolean;
-        buttonTypes?: string[];
-        maxButtons?: number;
-        reviewRequired?: boolean;
-        reviewTime?: string;
-    };
-    resending?: {
-        supported: boolean;
-        fallbackTypes?: string[];
-        customContent?: boolean;
-    };
-    webhooks?: {
-        delivery: boolean;
-        status: boolean;
-    };
-    rateLimit?: {
-        messagesPerSecond?: number;
-        messagesPerMinute?: number;
-        messagesPerHour?: number;
-        messagesPerDay?: number;
-    };
-}
-interface PluginContext {
-    config: ProviderConfig;
-    logger: Logger;
-    metrics: MetricsCollector;
-    storage: PluginStorage;
-    eventBus: EventEmitter;
-}
-interface ProviderConfig {
-    apiUrl: string;
-    apiKey?: string;
-    secretKey?: string;
-    userId?: string;
-    senderKey?: string;
-    plusFriendId?: string;
-    headers?: Record<string, string>;
-    customFields?: Record<string, any>;
-    timeout?: number;
-    retryConfig?: RetryConfig;
-    logLevel?: string;
-}
-interface RetryConfig {
-    maxRetries: number;
-    retryDelay: number;
-    retryableErrors?: string[];
-    retryableStatusCodes?: number[];
-}
-interface Logger {
-    info(message: string, ...args: any[]): void;
-    error(message: string, error?: any): void;
-    debug(message: string, ...args: any[]): void;
-    warn(message: string, ...args: any[]): void;
-}
-interface MetricsCollector {
-    increment(metric: string, labels?: Record<string, string>): void;
-    histogram(metric: string, value: number, labels?: Record<string, string>): void;
-    gauge(metric: string, value: number, labels?: Record<string, string>): void;
-}
-interface PluginStorage {
-    get(key: string): Promise<any>;
-    set(key: string, value: any, ttl?: number): Promise<void>;
-    delete(key: string): Promise<void>;
-}
-
-interface ProviderImplementation {
-    messaging: MessagingService;
-    scheduling?: SchedulingService;
-    templating?: TemplatingService;
-    analytics?: AnalyticsService;
-    webhooks?: WebhookService;
-    balance?: BalanceService;
-    history?: HistoryService;
-}
-interface ProviderMiddleware {
-    name: string;
-    pre?: (context: MiddlewareContext) => Promise<void>;
-    post?: (context: MiddlewareContext) => Promise<void>;
-    error?: (error: Error, context: MiddlewareContext) => Promise<void>;
-}
-interface MiddlewareContext {
-    request: any;
-    response?: any;
-    metadata: Record<string, any>;
-    startTime: number;
-}
-
-interface NotificationRequest {
-    phoneNumber: string;
-    message: string;
-    templateCode?: string;
-    variables?: Record<string, string>;
-}
-interface NotificationResponse {
-    success: boolean;
-    messageId?: string;
-    error?: string;
-    code?: string;
-}
-
-declare class PluginRegistry {
-    private plugins;
-    private instances;
-    register(plugin: ProviderPlugin): void;
-    create(pluginId: string, config: ProviderConfig, options?: {
-        logger?: Logger;
-        metrics?: MetricsCollector;
-        storage?: PluginStorage;
-    }): Promise<ProviderPlugin>;
-    loadAndCreate(pluginId: string, config: ProviderConfig, options?: any): Promise<ProviderPlugin>;
-    getSupportedTypes(): string[];
-    validateProviderConfig(type: string, config: ProviderConfig): boolean;
-    destroyAll(): Promise<void>;
-}
-
-declare function createRetryMiddleware(options: {
-    maxRetries: number;
-    retryDelay: number;
-    retryableErrors?: string[];
-    retryableStatusCodes?: number[];
-}): ProviderMiddleware;
-declare function createRateLimitMiddleware(options: {
-    messagesPerSecond?: number;
-    messagesPerMinute?: number;
-    messagesPerHour?: number;
-    messagesPerDay?: number;
-    strategy?: 'sliding-window' | 'fixed-window';
-}): ProviderMiddleware;
-declare function createLoggingMiddleware(options: {
-    logger: any;
-    logLevel?: string;
-}): ProviderMiddleware;
-declare function createMetricsMiddleware(options: {
-    collector: any;
-    labels?: Record<string, string>;
-}): ProviderMiddleware;
-declare function createCircuitBreakerMiddleware(options: {
-    threshold: number;
-    timeout: number;
-    resetTimeout: number;
-}): ProviderMiddleware;
-
-declare abstract class BasePlugin implements ProviderPlugin {
-    abstract readonly metadata: ProviderMetadata;
-    abstract readonly capabilities: ProviderCapabilities$1;
-    protected context: PluginContext;
-    middleware: ProviderMiddleware[];
-    initialize(context: PluginContext): Promise<void>;
-    destroy(): Promise<void>;
-    abstract getImplementation(): ProviderImplementation;
-    protected executeMiddleware(phase: 'pre' | 'post' | 'error', context: any, error?: Error): Promise<void>;
-    protected createMiddlewareContext(request: any, metadata?: Record<string, any>): {
-        request: any;
-        response: any;
-        metadata: {
-            pluginName: string;
-            pluginVersion: string;
-        };
-        startTime: number;
-    };
-    protected validateConfig(config: any, required: string[]): void;
-    protected makeRequest(url: string, options: RequestInit, metadata?: Record<string, any>): Promise<Response>;
-    /**
-     * Make HTTP request and parse JSON response
-     * Subclasses should use their specific response adapters to transform the result
-     */
-    protected makeJSONRequest<T = any>(url: string, options: RequestInit, metadata?: Record<string, any>): Promise<T>;
-    /**
-     * Helper method for logging provider-specific operations
-     */
-    protected logOperation(operation: string, data?: any): void;
-    /**
-     * Helper method for logging provider-specific errors
-     */
-    protected logError(operation: string, error: any, data?: any): void;
-}
-
-declare function normalizePhoneNumber(phone: string): string;
-declare function validatePhoneNumber(phone: string): boolean;
-declare function formatDateTime(date: Date): string;
-declare function parseTemplate(template: string, variables: Record<string, string>): string;
-declare function extractVariables(template: string): string[];
-declare function delay(ms: number): Promise<void>;
-declare function retry<T>(fn: () => Promise<T>, options: {
-    maxRetries: number;
-    delay: number;
-    backoff?: 'linear' | 'exponential';
-}): Promise<T>;
-
-interface Channel {
-    id: string;
-    name: string;
-    profileKey: string;
-    status: 'active' | 'inactive' | 'pending' | 'blocked';
-    createdAt: Date;
-    updatedAt: Date;
-}
-interface SenderNumber {
-    id: string;
-    channelId: string;
-    phoneNumber: string;
-    isVerified: boolean;
-    verifiedAt?: Date;
-    createdAt: Date;
-}
-interface AlimTalkProvider {
-    readonly id: string;
-    readonly name: string;
-    readonly capabilities: ProviderCapabilities;
-    templates: TemplateContract;
-    channels: ChannelContract;
-    messaging: MessagingContract;
-    analytics: AnalyticsContract;
-    account: AccountContract;
-}
-interface ProviderCapabilities {
-    templates: {
-        maxLength: number;
-        maxVariables: number;
-        maxButtons: number;
-        supportedButtonTypes: string[];
-        requiresApproval: boolean;
-        approvalTime: string;
-    };
-    messaging: {
-        maxRecipientsPerRequest: number;
-        maxRequestsPerSecond: number;
-        supportsBulk: boolean;
-        supportsScheduling: boolean;
-        maxScheduleDays: number;
-        supportsFallback: boolean;
-    };
-    channels: {
-        requiresBusinessVerification: boolean;
-        maxSenderNumbers: number;
-        supportsMultipleChannels: boolean;
-    };
-}
-interface TemplateContract {
-    create(template: TemplateCreateRequest): Promise<TemplateCreateResult>;
-    update(templateId: string, template: TemplateUpdateRequest): Promise<TemplateUpdateResult>;
-    delete(templateId: string): Promise<void>;
-    get(templateId: string): Promise<ProviderTemplate>;
-    list(filters?: TemplateFilters): Promise<ProviderTemplate[]>;
-    sync(): Promise<SyncResult>;
-}
-interface TemplateCreateRequest {
-    name: string;
-    content: string;
-    variables: TemplateVariableDefinition[];
-    buttons?: TemplateButtonDefinition[];
-    category: string;
-}
-interface TemplateUpdateRequest {
-    name?: string;
-    content?: string;
-    variables?: TemplateVariableDefinition[];
-    buttons?: TemplateButtonDefinition[];
-}
-interface TemplateCreateResult {
-    templateId: string;
-    providerTemplateCode: string;
-    status: TemplateStatus;
-    message?: string;
-}
-interface TemplateUpdateResult {
-    templateId: string;
-    status: TemplateStatus;
-    message?: string;
-}
-interface ProviderTemplate {
-    id: string;
-    code: string;
-    name: string;
-    content: string;
-    status: TemplateStatus;
-    createdAt: Date;
-    updatedAt: Date;
-    approvedAt?: Date;
-    rejectedAt?: Date;
-    rejectionReason?: string;
-}
-declare enum TemplateStatus {
-    DRAFT = "DRAFT",
-    PENDING = "PENDING",
-    APPROVED = "APPROVED",
-    REJECTED = "REJECTED",
-    DISABLED = "DISABLED"
-}
-interface TemplateVariableDefinition {
-    name: string;
-    type: string;
-    required: boolean;
-    maxLength?: number;
-    format?: string;
-}
-interface TemplateButtonDefinition {
-    type: string;
-    name: string;
-    linkMobile?: string;
-    linkPc?: string;
-    linkIos?: string;
-    linkAndroid?: string;
-    schemeIos?: string;
-    schemeAndroid?: string;
-}
-interface TemplateFilters {
-    status?: TemplateStatus;
-    category?: string;
-    createdAfter?: Date;
-    createdBefore?: Date;
-}
-interface SyncResult {
-    synced: number;
-    created: number;
-    updated: number;
-    deleted: number;
-    errors: SyncError[];
-}
-interface SyncError {
-    templateId: string;
-    error: string;
-}
-interface ChannelContract {
-    register(channel: ChannelRequest): Promise<Channel>;
-    list(): Promise<Channel[]>;
-    addSenderNumber(channelId: string, number: string): Promise<SenderNumber>;
-    verifySenderNumber(number: string, verificationCode: string): Promise<boolean>;
-}
-interface ChannelRequest {
-    name: string;
-    profileKey: string;
-    businessInfo?: BusinessInfo;
-}
-interface BusinessInfo {
-    name: string;
-    registrationNumber: string;
-    category: string;
-    contactPerson: string;
-    contactEmail: string;
-    contactPhone: string;
-}
-interface MessagingContract {
-    send(message: ProviderMessageRequest): Promise<ProviderMessageResult>;
-    sendBulk(messages: ProviderMessageRequest[]): Promise<ProviderBulkResult>;
-    schedule(message: ProviderMessageRequest, scheduledAt: Date): Promise<ScheduleResult>;
-    cancel(messageId: string): Promise<void>;
-    getStatus(messageId: string): Promise<MessageStatus>;
-}
-interface ProviderMessageRequest {
-    templateCode: string;
-    phoneNumber: string;
-    variables: Record<string, unknown>;
-    senderNumber?: string;
-    options?: MessageOptions;
-}
-interface MessageOptions {
-    priority?: 'high' | 'normal' | 'low';
-    ttl?: number;
-    tracking?: boolean;
-    webhookUrl?: string;
-    scheduledAt?: Date;
-}
-interface ProviderMessageResult {
-    messageId: string;
-    status: MessageStatus;
-    sentAt?: Date;
-    error?: ProviderError;
-}
-interface ProviderBulkResult {
-    requestId: string;
-    results: ProviderMessageResult[];
-    summary: {
-        total: number;
-        sent: number;
-        failed: number;
-    };
-}
-interface ScheduleResult {
-    scheduleId: string;
-    messageId: string;
-    scheduledAt: Date;
-    status: 'scheduled' | 'cancelled';
-}
-declare enum MessageStatus {
-    QUEUED = "QUEUED",
-    SENDING = "SENDING",
-    SENT = "SENT",
-    DELIVERED = "DELIVERED",
-    FAILED = "FAILED",
-    CANCELLED = "CANCELLED"
-}
-interface ProviderError {
-    code: string;
-    message: string;
-    details?: Record<string, unknown>;
-}
-interface AnalyticsContract {
-    getUsage(period: DateRange): Promise<UsageStats>;
-    getTemplateStats(templateId: string, period: DateRange): Promise<TemplateStats>;
-    getDeliveryReport(messageId: string): Promise<DeliveryReport>;
-}
-interface DateRange {
-    from: Date;
-    to: Date;
-}
-interface UsageStats {
-    period: DateRange;
-    totalMessages: number;
-    sentMessages: number;
-    deliveredMessages: number;
-    failedMessages: number;
-    deliveryRate: number;
-    failureRate: number;
-    breakdown: {
-        byTemplate: Record<string, number>;
-        byDay: Record<string, number>;
-        byHour: Record<string, number>;
-    };
-}
-interface TemplateStats {
-    templateId: string;
-    period: DateRange;
-    totalSent: number;
-    delivered: number;
-    failed: number;
-    clickRate?: number;
-    deliveryRate: number;
-    averageDeliveryTime: number;
-}
-interface DeliveryReport {
-    messageId: string;
-    phoneNumber: string;
-    templateCode: string;
-    status: MessageStatus;
-    sentAt?: Date;
-    deliveredAt?: Date;
-    failedAt?: Date;
-    clickedAt?: Date;
-    error?: ProviderError;
-    attempts: DeliveryAttempt[];
-}
-interface DeliveryAttempt {
-    attemptNumber: number;
-    attemptedAt: Date;
-    status: MessageStatus;
-    error?: ProviderError;
-}
-interface AccountContract {
-    getBalance(): Promise<Balance>;
-    getProfile(): Promise<AccountProfile>;
-}
-interface Balance {
-    current: number;
-    currency: string;
-    lastUpdated: Date;
-    threshold?: number;
-}
-interface AccountProfile {
-    accountId: string;
-    name: string;
-    email: string;
-    phone: string;
-    status: 'active' | 'suspended' | 'blocked';
-    tier: 'basic' | 'standard' | 'premium' | 'enterprise';
-    features: string[];
-    limits: {
-        dailyMessageLimit: number;
-        monthlyMessageLimit: number;
-        rateLimit: number;
-    };
-}
-interface ProviderConfiguration {
-    required: ConfigurationField[];
-    optional: ConfigurationField[];
-}
-interface ConfigurationField {
-    key: string;
-    name: string;
-    type: 'string' | 'number' | 'boolean' | 'password' | 'url';
-    description: string;
-    required: boolean;
-    default?: unknown;
-    validation?: {
-        pattern?: string;
-        min?: number;
-        max?: number;
-    };
-}
-
-declare abstract class BaseAlimTalkProvider implements AlimTalkProvider {
-    abstract readonly id: string;
-    abstract readonly name: string;
-    abstract readonly capabilities: ProviderCapabilities;
-    protected config: Record<string, unknown>;
-    protected isConfigured: boolean;
-    abstract templates: TemplateContract;
-    abstract channels: ChannelContract;
-    abstract messaging: MessagingContract;
-    abstract analytics: AnalyticsContract;
-    abstract account: AccountContract;
-    constructor(config?: Record<string, unknown>);
-    /**
-     * Configure the provider with necessary credentials and settings
-     */
-    configure(config: Record<string, unknown>): void;
-    /**
-     * Get the configuration schema for this provider
-     */
-    abstract getConfigurationSchema(): ProviderConfiguration;
-    /**
-     * Validate the provided configuration
-     */
-    protected validateConfiguration(config: Record<string, unknown>): void;
-    private validateFieldValue;
-    /**
-     * Called after configuration is set
-     */
-    protected onConfigured(): void;
-    /**
-     * Check if the provider is properly configured
-     */
-    isReady(): boolean;
-    /**
-     * Get configuration value
-     */
-    protected getConfig<T = unknown>(key: string): T;
-    /**
-     * Check if a configuration key exists
-     */
-    protected hasConfig(key: string): boolean;
-    /**
-     * Perform health check on the provider
-     */
-    healthCheck(): Promise<{
-        healthy: boolean;
-        issues: string[];
-        latency?: number;
-    }>;
-    /**
-     * Test basic connectivity to the provider
-     */
-    protected abstract testConnectivity(): Promise<void>;
-    /**
-     * Test authentication with the provider
-     */
-    protected abstract testAuthentication(): Promise<void>;
-    /**
-     * Get provider information
-     */
-    getInfo(): {
-        id: string;
-        name: string;
-        version: string;
-        capabilities: ProviderCapabilities;
-        configured: boolean;
-    };
-    /**
-     * Get provider version
-     */
-    protected abstract getVersion(): string;
-    /**
-     * Cleanup resources when provider is destroyed
-     */
-    destroy(): void;
-    /**
-     * Called when provider is being destroyed
-     */
-    protected onDestroy(): void;
-    /**
-     * Create standardized error
-     */
-    protected createError(code: string, message: string, details?: Record<string, unknown>): Error;
-    /**
-     * Log provider activity
-     */
-    protected log(level: 'info' | 'warn' | 'error', message: string, data?: unknown): void;
-    /**
-     * Handle rate limiting
-     */
-    protected handleRateLimit(operation: string): Promise<void>;
-    /**
-     * Retry mechanism for failed operations
-     */
-    protected withRetry<T>(operation: () => Promise<T>, options?: {
-        maxRetries?: number;
-        initialDelay?: number;
-        maxDelay?: number;
-        backoffFactor?: number;
-    }): Promise<T>;
-}
-
-/**
- * Base request adapter for transforming platform requests to provider-specific format
- */
-declare abstract class BaseRequestAdapter {
-    /**
-     * Transform a generic message request to provider-specific format
-     */
-    abstract transformMessageRequest(request: ProviderMessageRequest): unknown;
-    /**
-     * Transform a generic template request to provider-specific format
-     */
-    abstract transformTemplateRequest(request: TemplateCreateRequest): unknown;
-    /**
-     * Common transformation utilities
-     */
-    protected formatPhoneNumber(phoneNumber: string, countryCode?: string): string;
-    protected formatVariables(variables: Record<string, unknown>): Record<string, string>;
-    protected validateRequiredFields(data: unknown, requiredFields: string[]): void;
-}
-/**
- * Request adapter for IWINV provider
- */
-declare class IWINVRequestAdapter extends BaseRequestAdapter {
-    transformMessageRequest(request: ProviderMessageRequest): unknown;
-    transformTemplateRequest(request: TemplateCreateRequest): unknown;
-    private getProfileKey;
-    private mapCategory;
-}
-/**
- * Request adapter for Aligo provider
- */
-declare class AligoRequestAdapter extends BaseRequestAdapter {
-    transformMessageRequest(request: ProviderMessageRequest): unknown;
-    transformTemplateRequest(request: TemplateCreateRequest): unknown;
-    private getApiKey;
-    private getUserId;
-    private getSenderKey;
-    private buildMessage;
-    private formatDateTime;
-    private extractEmphasis;
-    private buildTemplateExtra;
-    private isPromotional;
-}
-/**
- * Request adapter for Kakao provider (direct API)
- */
-declare class KakaoRequestAdapter extends BaseRequestAdapter {
-    transformMessageRequest(request: ProviderMessageRequest): unknown;
-    transformTemplateRequest(request: TemplateCreateRequest): unknown;
-    private buildTemplateText;
-    private buildTemplateLink;
-    private mapCategoryCode;
-    private extractEmphasisType;
-    private buildTemplateButtons;
-}
-declare class RequestAdapterFactory {
-    private static adapters;
-    static create(providerId: string): BaseRequestAdapter;
-    static register(providerId: string, adapterClass: new () => BaseRequestAdapter): void;
-}
-
-/**
- * Base response adapter for transforming provider responses to platform format
- */
-declare abstract class BaseResponseAdapter {
-    /**
-     * Transform provider message response to standard format
-     */
-    abstract transformMessageResponse(providerResponse: unknown): ProviderMessageResult;
-    /**
-     * Transform provider template response to standard format
-     */
-    abstract transformTemplateResponse(providerResponse: unknown): TemplateCreateResult;
-    /**
-     * Common error transformation
-     */
-    protected transformError(providerError: unknown): ProviderError;
-    protected abstract extractErrorCode(providerError: unknown): string;
-    protected abstract extractErrorMessage(providerError: unknown): string;
-    protected abstract extractErrorDetails(providerError: unknown): Record<string, unknown>;
-    /**
-     * Common status mapping utilities
-     */
-    protected mapMessageStatus(providerStatus: string): MessageStatus;
-    protected mapTemplateStatus(providerStatus: string): TemplateStatus;
-    protected parseDate(dateString: string): Date | undefined;
-}
-/**
- * Response adapter for IWINV provider
- */
-declare class IWINVResponseAdapter extends BaseResponseAdapter {
-    transformMessageResponse(providerResponse: unknown): ProviderMessageResult;
-    transformTemplateResponse(providerResponse: unknown): TemplateCreateResult;
-    private mapIWINVMessageStatus;
-    private mapIWINVTemplateStatus;
-    protected extractErrorCode(providerError: unknown): string;
-    protected extractErrorMessage(providerError: unknown): string;
-    protected extractErrorDetails(providerError: unknown): Record<string, unknown>;
-}
-/**
- * Response adapter for Aligo provider
- */
-declare class AligoResponseAdapter extends BaseResponseAdapter {
-    transformMessageResponse(providerResponse: unknown): ProviderMessageResult;
-    transformTemplateResponse(providerResponse: unknown): TemplateCreateResult;
-    private mapAligoMessageStatus;
-    private mapAligoTemplateStatus;
-    protected extractErrorCode(providerError: unknown): string;
-    protected extractErrorMessage(providerError: unknown): string;
-    protected extractErrorDetails(providerError: unknown): Record<string, unknown>;
-}
-/**
- * Response adapter for Kakao provider (direct API)
- */
-declare class KakaoResponseAdapter extends BaseResponseAdapter {
-    transformMessageResponse(providerResponse: unknown): ProviderMessageResult;
-    transformTemplateResponse(providerResponse: unknown): TemplateCreateResult;
-    private mapKakaoMessageStatus;
-    private mapKakaoTemplateStatus;
-    protected extractErrorCode(providerError: unknown): string;
-    protected extractErrorMessage(providerError: unknown): string;
-    protected extractErrorDetails(providerError: unknown): Record<string, unknown>;
-}
-/**
- * Response adapter for NHN provider
- */
-declare class NHNResponseAdapter extends BaseResponseAdapter {
-    transformMessageResponse(providerResponse: unknown): ProviderMessageResult;
-    transformTemplateResponse(providerResponse: unknown): TemplateCreateResult;
-    private mapNHNMessageStatus;
-    private mapNHNTemplateStatus;
-    protected extractErrorCode(providerError: unknown): string;
-    protected extractErrorMessage(providerError: unknown): string;
-    protected extractErrorDetails(providerError: unknown): Record<string, unknown>;
-}
-/**
- * Factory for creating response adapters
- */
-declare class ResponseAdapterFactory {
-    private static adapters;
-    static create(providerId: string): BaseResponseAdapter;
-    static register(providerId: string, adapterClass: new () => BaseResponseAdapter): void;
-}
-
-declare class ProviderManager {
-    private providers;
-    private defaultProvider?;
-    registerProvider(provider: BaseProvider$1): void;
-    unregisterProvider(providerId: string): void;
-    getProvider(providerId?: string): BaseProvider$1 | null;
-    listProviders(): BaseProvider$1[];
-    setDefaultProvider(providerId: string): void;
-    healthCheckAll(): Promise<Record<string, boolean>>;
-    getProvidersForChannel(channel: string): BaseProvider$1[];
-}
-
-/**
- * IWINV API TypeScript 타입 정의
- * IWINV 알림톡 REST API 규격서 기반
- */
-interface IWINVBaseResponse {
-    code: number;
-    message: string;
-}
-interface SendMessageRequest {
-    templateCode: string;
-    reserve?: 'Y' | 'N';
-    sendDate?: string;
-    reSend?: 'Y' | 'N';
-    resendCallback?: string;
-    resendType?: 'Y' | 'N';
-    resendTitle?: string;
-    resendContent?: string;
-    list: SendRecipient[];
-}
-interface SendRecipient {
-    phone: string;
-    templateParam?: string[];
-}
-interface SendMessageResponse extends IWINVBaseResponse {
-    success: number;
-    fail: number;
-}
-interface CreateTemplateRequest {
-    templateName: string;
-    templateContent: string;
-    buttons?: CreateTemplateButton[];
-}
-interface CreateTemplateButton {
-    type: 'WL' | 'AL' | 'DB' | 'BK' | 'MD';
-    name: string;
-    linkMo?: string;
-    linkPc?: string;
-    linkIos?: string;
-    linkAnd?: string;
-}
-interface Template {
-    templateCode: string;
-    templateName: string;
-    templateContent: string;
-    status: 'Y' | 'I' | 'R';
-    templateStatusMsg?: string;
-    templateStatusComments?: string;
-    createDate: string;
-    buttons: any[];
-}
-interface TemplateListRequest {
-    pageNum?: string;
-    pageSize?: string;
-    templateCode?: string;
-    templateName?: string;
-    templateStatus?: 'Y' | 'I' | 'R';
-}
-interface TemplateListResponse extends IWINVBaseResponse {
-    totalCount: number;
-    list: Template[];
-}
-interface ModifyTemplateRequest {
-    templateCode: string;
-    templateName: string;
-    templateContent: string;
-    buttons?: CreateTemplateButton[];
-}
-interface DeleteTemplateRequest {
-    templateCode: string;
-}
-type CreateTemplateResponse = IWINVBaseResponse;
-type ModifyTemplateResponse = IWINVBaseResponse;
-type DeleteTemplateResponse = IWINVBaseResponse;
-interface HistoryRequest {
-    pageNum?: number;
-    pageSize?: number;
-    reserve?: 'Y' | 'N';
-    startDate?: string;
-    endDate?: string;
-    seqNo?: number;
-    phone?: string;
-}
-interface MessageHistory {
-    seqNo: number;
-    phone: string;
-    callback: string;
-    templateCode: string;
-    sendMessage: string;
-    reserve: 'Y' | 'N';
-    requestDate: string;
-    sendDate: string;
-    receiveDate: string;
-    statusCode: string;
-    statusCodeName: string;
-    resendStatus: string | null;
-    resendStatusName: string | null;
-    buttons: {
-        link1: string | null;
-        link2: string | null;
-        link3: string | null;
-        link4: string | null;
-        link5: string | null;
-    };
-}
-interface HistoryResponse extends IWINVBaseResponse {
-    totalCount: number;
-    list: MessageHistory[];
-}
-interface CancelReservationRequest {
-    seqNo: number;
-}
-type CancelReservationResponse = IWINVBaseResponse;
-interface BalanceResponse extends IWINVBaseResponse {
-    charge: number;
-}
-interface IWINVConfig {
-    apiKey: string;
-    baseUrl?: string;
-    debug?: boolean;
-    [key: string]: unknown;
-}
-declare const IWINV_STATUS_CODES: {
-    readonly SUCCESS: 200;
-    readonly AUTH_FAILED: 201;
-    readonly BAD_REQUEST: 400;
-    readonly UNAUTHORIZED: 401;
-    readonly FORBIDDEN: 403;
-    readonly NOT_FOUND: 404;
-    readonly TOO_MANY_REQUESTS: 429;
-    readonly INTERNAL_SERVER_ERROR: 500;
-};
-
-/**
- * IWINV Messaging Contract Implementation
- */
-
-declare class IWINVMessagingContract implements MessagingContract {
-    private config;
-    constructor(config: IWINVConfig);
-    send(message: ProviderMessageRequest): Promise<ProviderMessageResult>;
-    sendBulk(messages: ProviderMessageRequest[]): Promise<ProviderBulkResult>;
-    schedule(message: ProviderMessageRequest, scheduledAt: Date): Promise<ScheduleResult>;
-    cancel(messageId: string): Promise<void>;
-    getStatus(messageId: string): Promise<MessageStatus>;
-}
-
-/**
- * IWINV Template Contract Implementation
- */
-
-declare class IWINVTemplateContract implements TemplateContract {
-    private config;
-    constructor(config: IWINVConfig);
-    create(template: TemplateCreateRequest): Promise<TemplateCreateResult>;
-    update(templateId: string, template: TemplateUpdateRequest): Promise<TemplateUpdateResult>;
-    delete(templateId: string): Promise<void>;
-    get(templateId: string): Promise<ProviderTemplate>;
-    list(filters?: TemplateFilters): Promise<ProviderTemplate[]>;
-    sync(): Promise<SyncResult>;
-    private mapIWINVStatus;
-}
-
-/**
- * IWINV Channel Contract Implementation
- */
-
-declare class IWINVChannelContract implements ChannelContract {
-    private config;
-    constructor(config: IWINVConfig);
-    register(channel: ChannelRequest): Promise<Channel>;
-    list(): Promise<Channel[]>;
-    addSenderNumber(channelId: string, number: string): Promise<SenderNumber>;
-    verifySenderNumber(number: string, verificationCode: string): Promise<boolean>;
-}
-
-/**
- * IWINV Analytics Contract Implementation
- */
-
-declare class IWINVAnalyticsContract implements AnalyticsContract {
-    private config;
-    constructor(config: IWINVConfig);
-    getUsage(period: DateRange): Promise<UsageStats>;
-    getTemplateStats(templateId: string, period: DateRange): Promise<TemplateStats>;
-    getDeliveryReport(messageId: string): Promise<DeliveryReport>;
-    private groupByTemplate;
-    private groupByDay;
-    private groupByHour;
-    private mapStatus;
-}
-
-/**
- * IWINV Account Contract Implementation
- */
-
-declare class IWINVAccountContract implements AccountContract {
-    private config;
-    constructor(config: IWINVConfig);
-    getBalance(): Promise<Balance>;
-    getProfile(): Promise<AccountProfile>;
-}
-
-declare class IWINVProvider extends BaseAlimTalkProvider {
-    readonly id = "iwinv";
-    readonly name = "IWINV AlimTalk Provider";
-    readonly capabilities: ProviderCapabilities;
-    templates: IWINVTemplateContract;
-    channels: IWINVChannelContract;
-    messaging: IWINVMessagingContract;
-    analytics: IWINVAnalyticsContract;
-    account: IWINVAccountContract;
-    constructor(config?: IWINVConfig);
-    getConfigurationSchema(): ProviderConfiguration;
-    protected testConnectivity(): Promise<void>;
-    protected testAuthentication(): Promise<void>;
-    protected getVersion(): string;
-    /**
-     * Get IWINV-specific configuration
-     */
-    private getIWINVConfig;
-    /**
-     * IWINV-specific methods for backward compatibility
-     */
-    /**
-     * Send AlimTalk message (legacy method)
-     */
-    sendMessage(options: {
-        templateCode: string;
-        phoneNumber: string;
-        variables: Record<string, any>;
-        senderNumber?: string;
-    }): Promise<ProviderMessageResult>;
-    /**
-     * Get account balance (legacy method)
-     */
-    getBalance(): Promise<Balance>;
-    /**
-     * List templates (legacy method)
-     */
-    listTemplates(filters?: any): Promise<ProviderTemplate[]>;
-}
-
-export { type AccountContract, AligoRequestAdapter, AligoResponseAdapter, type AnalyticsContract, type BalanceResponse, BaseAlimTalkProvider, BasePlugin, type BaseProvider, type BaseProviderConfig, BaseRequestAdapter, BaseResponseAdapter, type CancelReservationRequest, type CancelReservationResponse, type ChannelContract, type ChannelInfo, type ConfigurationField, type CreateTemplateButton, type CreateTemplateRequest, type CreateTemplateResponse, type DeleteTemplateRequest, type DeleteTemplateResponse, type HealthCheckResult, type HistoryFilters, type HistoryRequest, type HistoryResponse, type IWINVBaseResponse, type IWINVConfig, IWINVProvider, IWINVRequestAdapter, IWINVResponseAdapter, IWINV_STATUS_CODES, KakaoRequestAdapter, KakaoResponseAdapter, type Logger, type MediaAttachment, type MessageButton, MessageChannel, type MessageContent, type MessageHistory, MessageType, type MessagingContract, type MetricsCollector, type MiddlewareContext, type ModifyTemplateRequest, type ModifyTemplateResponse, NHNResponseAdapter, type NotificationRequest, type NotificationResponse, type PluginContext, PluginRegistry, type PluginStorage, type ProviderCapabilities, type ProviderConfig, type ProviderConfiguration, type ProviderImplementation, ProviderManager, type ProviderMetadata, type ProviderMiddleware, type ProviderPlugin, RequestAdapterFactory, ResponseAdapterFactory, type RetryConfig, type ScheduleResult, type SendMessageRequest, type SendMessageResponse, type SendOptions, type SendRecipient, type SendResult, type SenderNumber$1 as SenderNumber, type SenderVerificationResult, type Template, type TemplateContract, type TemplateCreateRequest$1 as TemplateCreateRequest, type TemplateFilters$1 as TemplateFilters, type TemplateListRequest, type TemplateListResponse, type TemplateResult, type TemplateUpdateRequest$1 as TemplateUpdateRequest, createCircuitBreakerMiddleware, createLoggingMiddleware, createMetricsMiddleware, createRateLimitMiddleware, createRetryMiddleware, delay, extractVariables, formatDateTime, normalizePhoneNumber, parseTemplate, retry, validatePhoneNumber };