@k-msg/provider 0.4.0 → 0.6.0

package/dist/iwinv/provider.d.ts

@@ -1,72 +1,40 @@
-import { type SendOptions, type StandardRequest, type StandardResult, UniversalProvider } from "@k-msg/core";
-import type { IWINVConfig, IWINVSmsHistoryItem } from "./types/iwinv";
-export type IWINVSmsHistoryParams = {
-    version?: string;
-    companyId?: string;
-    startDate: string | Date;
-    endDate: string | Date;
-    requestNo?: string;
-    pageNum?: number;
-    pageSize?: number;
-    phone?: string;
-};
-export declare class IWINVProvider extends UniversalProvider {
-    private static readonly directSmsTemplates;
-    private readonly iwinvConfig;
+import { KMsgError, type MessageType, type Provider, type ProviderHealthStatus, type Result, type SendOptions, type SendResult } from "@k-msg/core";
+import type { IWINVConfig } from "./types/iwinv";
+export declare class IWINVProvider implements Provider {
+    readonly id = "iwinv";
+    readonly name = "IWINV Messaging Provider";
+    readonly supportedTypes: readonly MessageType[];
+    private readonly config;
     constructor(config: IWINVConfig);
-    send(params: StandardRequest): Promise<StandardResult>;
-    send(params: SendOptions): Promise<unknown>;
-    /**
-     * SMS v2: 잔액(충전금) 조회
-     * - URL: POST https://sms.bizservice.iwinv.kr/api/charge/
-     * - Header: secret: base64(SMS_API_KEY&SMS_AUTH_KEY)
-     * - Body: { "version": "1.0" }
-     */
-    getSmsCharge(): Promise<number>;
-    /**
-     * SMS v2: 전송 내역 조회
-     * - URL: POST https://sms.bizservice.iwinv.kr/api/history/
-     * - 기간은 90일 이내만 허용
-     */
-    getSmsHistory(params: IWINVSmsHistoryParams): Promise<{
-        totalCount: number;
-        list: IWINVSmsHistoryItem[];
-        message: string;
-    }>;
-    private isStandardRequest;
-    private isSmsChannelRequest;
-    private resolveSmsBaseUrl;
-    private resolveSmsMessageType;
-    private extractMessageText;
-    private formatSmsReserveDate;
-    private formatSmsHistoryDate;
-    private assertSmsHistoryWindow;
-    private requestSmsApi;
+    healthCheck(): Promise<ProviderHealthStatus>;
+    send(options: SendOptions): Promise<Result<SendResult, KMsgError>>;
     private normalizePhoneNumber;
+    private toBase64;
+    private isHttpUrl;
+    private guessImageContentType;
+    private resolveImageInput;
+    private toImageBlob;
+    private getSendEndpoint;
+    private getAlimTalkHeaders;
+    private formatIWINVDate;
+    private sendAlimTalk;
+    private mapIwinvCodeToKMsgErrorCode;
+    private normalizeIwinvCode;
+    private resolveSmsBaseUrl;
+    private canSendSmsV2;
     private buildSmsSecretHeader;
-    private buildLmsTitle;
+    private formatSmsReserveDate;
+    private normalizeCode;
     private mapSmsResponseMessage;
     private mapSmsErrorCode;
-    private isSmsRetryableCode;
-    private normalizeCode;
-    private extractProviderCode;
-    private isIpRestrictionResult;
-    private getIpRetryCount;
-    private getIpRetryDelayMs;
-    private wait;
-    private emitIpRestrictionAlert;
-    private addIpRetryMetadata;
-    private sendWithIpRetry;
-    private sendSmsRequestOnce;
+    private buildLmsTitle;
+    private sendSmsV2Mms;
+    private sendSmsV2;
 }
 export declare const createIWINVProvider: (config: IWINVConfig) => IWINVProvider;
 export declare const createDefaultIWINVProvider: () => IWINVProvider;
 export declare class IWINVProviderFactory {
     static create(config: IWINVConfig): IWINVProvider;
     static createDefault(): IWINVProvider;
-    static getInstance(): {
-        createProvider: (config: IWINVConfig) => IWINVProvider;
-        initialize: () => void;
-    };
 }
 export declare function initializeIWINV(): void;

package/dist/iwinv/types/iwinv.d.ts

@@ -2,7 +2,6 @@
  * IWINV API TypeScript 타입 정의
  * IWINV 알림톡 REST API 규격서 기반
  */
-import type { ProviderConfig } from "@k-msg/core";
 export interface IWINVBaseResponse {
     code: number;
     message: string;
@@ -149,7 +148,16 @@ export interface IWINVSmsHistoryResponse {
     totalCount: number;
     list: IWINVSmsHistoryItem[];
 }
-export interface IWINVConfig extends ProviderConfig {
+export interface IWINVConfig {
+    /**
+     * IWINV AlimTalk API key (used for AUTH header).
+     */
+    apiKey: string;
+    /**
+     * IWINV AlimTalk base URL.
+     * Default: https://alimtalk.bizservice.iwinv.kr
+     */
+    baseUrl: string;
     smsApiKey?: string;
     smsAuthKey?: string;
     smsBaseUrl?: string;

package/dist/providers/mock/mock.provider.d.ts

@@ -1,10 +1,15 @@
-import { KMsgError, type Provider, type Result, type SendOptions, type SendResult, type Template, type TemplateProvider } from "@k-msg/core";
+import { KMsgError, type MessageType, type Provider, type Result, type SendOptions, type SendResult, type Template, type TemplateProvider } from "@k-msg/core";
 export declare class MockProvider implements Provider, TemplateProvider {
     readonly id = "mock";
     readonly name = "Mock Provider";
+    readonly supportedTypes: readonly MessageType[];
     calls: SendOptions[];
     private failureCount;
     private templates;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        issues: never[];
+    }>;
     send(params: SendOptions): Promise<Result<SendResult, KMsgError>>;
     mockSuccess(): void;
     mockFailure(count: number): void;

package/dist/solapi/provider.d.ts

@@ -1,11 +1,25 @@
-import { type StandardRequest, type StandardResult, UniversalProvider } from "@k-msg/core";
-import { type SolapiSdkClient } from "../adapters/solapi.adapter";
+import { KMsgError, type MessageType, type Provider, type ProviderHealthStatus, type Result, type SendOptions, type SendResult } from "@k-msg/core";
+import { SolapiMessageService } from "solapi";
 import type { SolapiConfig } from "./types/solapi";
-export declare class SolapiProvider extends UniversalProvider {
+export type SolapiSdkClient = Pick<SolapiMessageService, "sendOne" | "getMessages" | "getBalance" | "uploadFile">;
+export declare class SolapiProvider implements Provider {
+    readonly id = "solapi";
+    readonly name = "SOLAPI Messaging Provider";
+    readonly supportedTypes: readonly MessageType[];
+    private readonly config;
+    private readonly client;
     constructor(config: SolapiConfig, client?: SolapiSdkClient);
-    send(params: StandardRequest): Promise<StandardResult>;
-    send(params: unknown): Promise<unknown>;
-    getBalance(): Promise<number>;
+    healthCheck(): Promise<ProviderHealthStatus>;
+    send(options: SendOptions): Promise<Result<SendResult, KMsgError>>;
+    private adaptSendResult;
+    private mapError;
+    private normalizePhoneNumber;
+    private stringifyVariables;
+    private toKakaoButtons;
+    private resolveImageRef;
+    private extractFileId;
+    private toSolapiMessageType;
+    private buildSolapiSendOneMessage;
 }
 export declare const createSolapiProvider: (config: SolapiConfig) => SolapiProvider;
 export declare const createDefaultSolapiProvider: () => SolapiProvider;

package/dist/solapi/types/solapi.d.ts

@@ -1,5 +1,8 @@
-import type { ProviderConfig } from "@k-msg/core";
-export interface SolapiConfig extends ProviderConfig {
+export interface SolapiConfig {
+    /**
+     * SOLAPI API Key
+     */
+    apiKey: string;
     /**
      * SOLAPI API Secret
      */
@@ -28,4 +31,9 @@ export interface SolapiConfig extends ProviderConfig {
      * Default country code (e.g. "82"). Optional.
      */
     defaultCountry?: string;
+    /**
+     * Base URL for SOLAPI API.
+     */
+    baseUrl?: string;
+    debug?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-msg/provider",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "packageManager": "bun@1.3.8",
   "type": "module",
   "description": "Complete provider system with adapters and implementations for K-Message platform",
@@ -12,26 +12,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
-    },
-    "./interfaces": {
-      "types": "./dist/interfaces/index.d.ts",
-      "import": "./dist/interfaces/index.mjs",
-      "require": "./dist/interfaces/index.js"
-    },
-    "./registry": {
-      "types": "./dist/registry/index.d.ts",
-      "import": "./dist/registry/index.mjs",
-      "require": "./dist/registry/index.js"
-    },
-    "./middleware": {
-      "types": "./dist/middleware/index.d.ts",
-      "import": "./dist/middleware/index.mjs",
-      "require": "./dist/middleware/index.js"
-    },
-    "./utils": {
-      "types": "./dist/utils/index.d.ts",
-      "import": "./dist/utils/index.mjs",
-      "require": "./dist/utils/index.js"
     }
   },
   "publishConfig": {
@@ -55,7 +35,7 @@
     "publish": "bun publish --access public"
   },
   "dependencies": {
-    "@k-msg/core": "0.4.0",
+    "@k-msg/core": "0.6.0",
     "solapi": "^5.5.4",
     "zod": "^4.0.14"
   },

package/dist/abstract/provider.base.d.ts

@@ -1,108 +0,0 @@
-import type { ConfigurationSchema, DeliveryStatus } from "@k-msg/core";
-import type { AccountContract, AlimTalkProvider, AlimTalkRequest, AlimTalkResult, AnalyticsContract, ChannelContract, MessagingContract, ProviderCapabilities, ProviderConfiguration, TemplateContract } from "../contracts/provider.contract";
-export declare abstract class BaseAlimTalkProvider implements AlimTalkProvider {
-    abstract readonly id: string;
-    abstract readonly name: string;
-    readonly type: "messaging";
-    abstract readonly version: 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;
-    abstract send<T extends AlimTalkRequest = AlimTalkRequest, R extends AlimTalkResult = AlimTalkResult>(request: T): Promise<R>;
-    abstract getStatus(requestId: string): Promise<DeliveryStatus>;
-    abstract cancel?(requestId: string): Promise<boolean>;
-    abstract getSupportedFeatures(): string[];
-    abstract getConfigurationSchema(): ConfigurationSchema;
-    abstract getProviderConfiguration(): 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;
-    getCapabilities(): ProviderCapabilities;
-    /**
-     * 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>;
-}

package/dist/adapters/aligo.adapter.d.ts

@@ -1,50 +0,0 @@
-import { BaseProviderAdapter, KMsgError, type Provider, type Result, type SendOptions, type SendResult, type StandardError, type StandardRequest, type StandardResult, type Template, type TemplateProvider } from "@k-msg/core";
-import type { AligoConfig, AligoResponse } from "../types/aligo";
-export declare class AligoAdapter extends BaseProviderAdapter implements Provider, TemplateProvider {
-    protected readonly aligoConfig: AligoConfig;
-    private static readonly directTemplates;
-    readonly id = "aligo";
-    readonly name = "Aligo Smart SMS";
-    private readonly SMS_HOST;
-    private readonly ALIMTALK_HOST;
-    constructor(aligoConfig: AligoConfig);
-    send(params: SendOptions): Promise<Result<SendResult, KMsgError>>;
-    sendStandard(request: StandardRequest): Promise<StandardResult>;
-    adaptRequest(request: StandardRequest): any;
-    adaptResponse(response: AligoResponse): StandardResult;
-    mapError(error: any): StandardError;
-    private mapAligoError;
-    getAuthHeaders(): Record<string, string>;
-    getBaseUrl(): string;
-    getEndpoint(operation: string): string;
-    /**
-     * Aligo 특화 기능: 잔액 조회
-     */
-    getBalance(): Promise<number>;
-    createTemplate(template: Omit<Template, "id" | "status" | "createdAt" | "updatedAt">): Promise<Result<Template, KMsgError>>;
-    updateTemplate(_code: string, _template: Partial<Omit<Template, "id" | "code" | "status" | "createdAt" | "updatedAt">>): Promise<Result<Template, KMsgError>>;
-    deleteTemplate(code: string): Promise<Result<void, KMsgError>>;
-    getTemplate(code: string): Promise<Result<Template, KMsgError>>;
-    listTemplates(_params?: {
-        status?: string;
-        page?: number;
-        limit?: number;
-    }): Promise<Result<Template[], KMsgError>>;
-    private sendSMS;
-    private sendAlimTalk;
-    private sendFriendTalk;
-    private formatAligoDate;
-    private request;
-    private handleError;
-    private toProviderChannel;
-    private normalizeChannelLike;
-    private resolveStandardChannel;
-    private extractStandardMessage;
-    private buildSmsBodyFromStandard;
-    private isKakaoChannel;
-    private buildFriendTalkBody;
-    private buildAlimTalkBodyFromStandard;
-    private buildFriendTalkBodyFromStandard;
-    private interpolateMessage;
-    private mapTemplateStatus;
-}

package/dist/adapters/iwinv.adapter.d.ts

@@ -1,139 +0,0 @@
-/**
- * IWINV Provider Adapter
- * IWINV API를 표준 인터페이스로 변환하는 어댑터
- */
-import { type AdapterFactory, BaseProviderAdapter, KMsgError, type ProviderConfig, type ProviderMetadata, type Result, type StandardError, type StandardRequest, type StandardResult, type Template, type TemplateProvider } from "@k-msg/core";
-import type { IWINVConfig } from "../iwinv/types/iwinv";
-export type { IWINVConfig } from "../iwinv/types/iwinv";
-export interface IWINVError {
-    code: number;
-    message: string;
-    status?: number;
-    data?: unknown;
-}
-export interface IWINVRequest {
-    templateCode: string;
-    reserve?: "Y" | "N";
-    sendDate?: string;
-    reSend?: "Y" | "N";
-    resendCallback?: string;
-    resendType?: "Y" | "N";
-    resendTitle?: string;
-    resendContent?: string;
-    list: IWINVRecipient[];
-}
-export interface IWINVRecipient {
-    phone: string;
-    templateParam?: string[];
-}
-export interface IWINVResponse {
-    code: number;
-    message: string;
-    success?: number;
-    fail?: number;
-    seqNo?: number;
-}
-export interface IWINVBalanceResponse {
-    code: number;
-    charge: number;
-}
-export interface IWINVTemplate {
-    templateCode: string;
-    templateName: string;
-    templateContent: string;
-    status: "Y" | "I" | "R";
-    templateStatusMsg?: string;
-    templateStatusComments?: string;
-    createDate: string;
-    buttons: unknown[];
-}
-export interface IWINVTemplateListResponse extends IWINVResponse {
-    totalCount: number;
-    list: IWINVTemplate[];
-}
-export declare function isIWINVError(error: unknown): error is IWINVError;
-export declare function isIWINVResponse(response: unknown): response is IWINVResponse;
-export declare function isIWINVBalanceResponse(response: unknown): response is IWINVBalanceResponse;
-/**
- * IWINV API 어댑터 구현
- */
-export declare class IWINVAdapter extends BaseProviderAdapter implements TemplateProvider {
-    private static readonly directTemplates;
-    private readonly endpoints;
-    constructor(config: IWINVConfig);
-    adaptRequest(request: StandardRequest): IWINVRequest;
-    adaptResponse(response: IWINVResponse): StandardResult;
-    mapError(error: IWINVError | Error | unknown): StandardError;
-    getAuthHeaders(): Record<string, string>;
-    getBaseUrl(): string;
-    getEndpoint(operation: string): string;
-    getRequestConfig(): RequestInit;
-    createTemplate(template: Omit<Template, "id" | "status" | "createdAt" | "updatedAt">): Promise<Result<Template, KMsgError>>;
-    updateTemplate(code: string, template: Partial<Omit<Template, "id" | "code" | "status" | "createdAt" | "updatedAt">>): Promise<Result<Template, KMsgError>>;
-    deleteTemplate(code: string): Promise<Result<void, KMsgError>>;
-    getTemplate(code: string): Promise<Result<Template, KMsgError>>;
-    listTemplates(params?: {
-        status?: string;
-        page?: number;
-        limit?: number;
-    }): Promise<Result<Template[], KMsgError>>;
-    private mapIWINVTemplate;
-    private mapIWINVTemplateStatus;
-    isRetryableError(error: IWINVError | Error | unknown): boolean;
-    /**
-     * IWINV 날짜 형식으로 변환 (yyyy-MM-dd HH:mm:ss)
-     */
-    private formatIWINVDate;
-    /**
-     * IWINV 상태 코드를 표준 상태로 매핑
-     */
-    private mapIWINVStatus;
-    /**
-     * IWINV 특화 기능: 예약 발송 취소
-     */
-    cancelScheduledMessage(messageId: string): Promise<boolean>;
-    /**
-     * IWINV 특화 기능: 잔액 조회
-     */
-    getBalance(): Promise<number>;
-    /**
-     * IWINV SMS v2: 잔액 조회
-     * - URL: POST https://sms.bizservice.iwinv.kr/api/charge/
-     * - Header: secret: base64(SMS_API_KEY&SMS_AUTH_KEY)
-     * - Body: { "version": "1.0" }
-     */
-    getSmsCharge(): Promise<number>;
-    /**
-     * IWINV SMS v2: 전송 내역 조회
-     * - URL: POST https://sms.bizservice.iwinv.kr/api/history/
-     * - 기간은 90일 이내만 허용
-     */
-    getSmsHistory(params: {
-        companyId?: string;
-        startDate: string | Date;
-        endDate: string | Date;
-        requestNo?: string;
-        pageNum?: number;
-        pageSize?: number;
-        phone?: string;
-        version?: string;
-    }): Promise<{
-        totalCount: number;
-        list: unknown[];
-        message: string;
-    }>;
-    private resolveSmsBaseUrl;
-    private buildSmsSecretHeader;
-    private formatSmsHistoryDate;
-    private assertSmsHistoryWindow;
-    private requestSmsApi;
-}
-/**
- * IWINV 어댑터 팩토리
- */
-export declare class IWINVAdapterFactory implements AdapterFactory {
-    create(config: ProviderConfig): BaseProviderAdapter;
-    private isValidIWINVConfig;
-    supports(providerId: string): boolean;
-    getMetadata(): ProviderMetadata;
-}

package/dist/adapters/solapi.adapter.d.ts

@@ -1,48 +0,0 @@
-import type { HistoryQuery, StandardError, StandardRequest, StandardResult } from "@k-msg/core";
-import { BaseProviderAdapter } from "@k-msg/core";
-import { SolapiMessageService } from "solapi";
-import type { SolapiConfig } from "../solapi/types/solapi";
-export type SolapiSdkClient = Pick<SolapiMessageService, "sendOne" | "getMessages" | "getBalance" | "uploadFile">;
-export declare class SolapiAdapter extends BaseProviderAdapter {
-    private static readonly directTemplates;
-    private readonly solapiConfig;
-    private readonly client;
-    constructor(config: SolapiConfig, client?: SolapiSdkClient);
-    adaptRequest(request: StandardRequest): Record<string, unknown>;
-    adaptResponse(response: unknown): StandardResult;
-    mapError(error: unknown): StandardError;
-    getAuthHeaders(): Record<string, string>;
-    getBaseUrl(): string;
-    getEndpoint(_operation: string): string;
-    sendStandard(request: StandardRequest): Promise<StandardResult>;
-    getSmsCharge(): Promise<number>;
-    getBalance(): Promise<number>;
-    getSmsHistory(params: {
-        channel?: HistoryQuery["channel"];
-        startDate: string | Date;
-        endDate: string | Date;
-        requestNo?: string;
-        pageNum?: number;
-        pageSize?: number;
-        phone?: string;
-        startKey?: string;
-    }): Promise<{
-        totalCount: number;
-        list: unknown[];
-        message: string;
-        nextKey?: string | null;
-        raw?: unknown;
-    }>;
-    getHistory(query: HistoryQuery): Promise<unknown>;
-    private clampLimit;
-    private normalizePhoneNumber;
-    private toSolapiTypeFromChannel;
-    private stringifyVariables;
-    private extractText;
-    private extractSubject;
-    private resolveChannelLike;
-    private toSolapiMessageType;
-    private toKakaoButtons;
-    private toRcsButtons;
-    private buildSolapiSendOneMessage;
-}