@k-msg/provider 0.1.5 → 0.2.0

package/dist/iwinv/provider-sms.d.ts

@@ -17,7 +17,7 @@ export declare class IWINVSMSProvider extends IWINVProvider {
         senderNumber?: string;
         scheduledAt?: Date;
         priority?: "high" | "normal" | "low";
-    }): Promise<any>;
+    }): Promise<import("@k-msg/core").StandardResult>;
     /**
      * LMS 전송 (긴 문자 메시지)
      */
@@ -25,7 +25,7 @@ export declare class IWINVSMSProvider extends IWINVProvider {
         senderNumber?: string;
         scheduledAt?: Date;
         priority?: "high" | "normal" | "low";
-    }): Promise<any>;
+    }): Promise<import("@k-msg/core").StandardResult>;
     /**
      * 대량 SMS 전송
      */
@@ -37,7 +37,7 @@ export declare class IWINVSMSProvider extends IWINVProvider {
         senderNumber?: string;
         scheduledAt?: Date;
         batchSize?: number;
-    }): Promise<(PromiseRejectedResult | PromiseFulfilledResult<any>)[]>;
+    }): Promise<(PromiseRejectedResult | PromiseFulfilledResult<import("@k-msg/core").StandardResult>)[]>;
     /**
      * SMS/LMS 자동 판별 전송
      */
@@ -46,7 +46,7 @@ export declare class IWINVSMSProvider extends IWINVProvider {
         scheduledAt?: Date;
         subject?: string;
         priority?: "high" | "normal" | "low";
-    }): Promise<any>;
+    }): Promise<import("@k-msg/core").StandardResult>;
 }
 /**
  * SMS Provider 팩토리 함수들

package/dist/iwinv/provider.d.ts

@@ -1,17 +1,47 @@
-import { type SendOptions, type StandardRequest, UniversalProvider } from "@k-msg/core";
-import type { IWINVConfig } from "./types/iwinv";
+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;
     constructor(config: IWINVConfig);
-    send(params: SendOptions | StandardRequest | any): Promise<any>;
+    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 isLongMessage;
     private resolveSmsMessageType;
     private extractMessageText;
     private formatSmsReserveDate;
+    private formatSmsHistoryDate;
+    private assertSmsHistoryWindow;
+    private requestSmsApi;
     private normalizePhoneNumber;
     private buildSmsSecretHeader;
     private buildLmsTitle;

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

@@ -2,6 +2,7 @@
  * IWINV API TypeScript 타입 정의
  * IWINV 알림톡 REST API 규격서 기반
  */
+import type { ProviderConfig } from "@k-msg/core";
 export interface IWINVBaseResponse {
     code: number;
     message: string;
@@ -46,7 +47,7 @@ export interface Template {
     templateStatusMsg?: string;
     templateStatusComments?: string;
     createDate: string;
-    buttons: any[];
+    buttons: unknown[];
 }
 export interface TemplateListRequest {
     pageNum?: string;
@@ -113,21 +114,68 @@ export type CancelReservationResponse = IWINVBaseResponse;
 export interface BalanceResponse extends IWINVBaseResponse {
     charge: number;
 }
-export interface IWINVConfig {
-    apiKey: string;
-    baseUrl: string;
+export interface IWINVSmsChargeRequest {
+    version: string;
+}
+export interface IWINVSmsChargeResponse {
+    code: number;
+    message: string;
+    charge: number;
+}
+export interface IWINVSmsHistoryRequest {
+    version: string;
+    companyid: string;
+    startDate: string;
+    endDate: string;
+    requestNo?: string;
+    pageNum?: number;
+    pageSize?: number;
+    phone?: string;
+}
+export interface IWINVSmsHistoryItem {
+    requestNo: string | number;
+    companyid: string;
+    msgType: string;
+    phone: string;
+    callback: string;
+    sendStatus?: string;
+    sendStatusCode?: string;
+    sendStatusMsg?: string;
+    sendDate: string;
+}
+export interface IWINVSmsHistoryResponse {
+    resultCode: number;
+    message: string;
+    totalCount: number;
+    list: IWINVSmsHistoryItem[];
+}
+export interface IWINVConfig extends ProviderConfig {
     smsApiKey?: string;
     smsAuthKey?: string;
     smsBaseUrl?: string;
+    /**
+     * SMS v2 전송 내역 조회시 필요한 조직(업체) 발송 아이디.
+     * (API 문서의 `companyid`)
+     */
+    smsCompanyId?: string;
     senderNumber?: string;
     smsSenderNumber?: string;
     sendEndpoint?: string;
+    /**
+     * Optional proxy/IP override header for IP-restricted IWINV endpoints.
+     * Intended for testing or controlled environments; production should whitelist real egress IPs.
+     */
+    xForwardedFor?: string;
+    /**
+     * Extra HTTP headers merged into outgoing requests.
+     * Use with care: overriding AUTH/secret can break requests.
+     */
+    extraHeaders?: Record<string, string>;
     ipRetryCount?: number;
     ipRetryDelayMs?: number;
     ipAlertWebhookUrl?: string;
     onIpRestrictionAlert?: (payload: IWINVIPRestrictionAlert) => void | Promise<void>;
     debug?: boolean;
-    [key: string]: unknown;
 }
 export interface IWINVIPRestrictionAlert {
     provider: "iwinv";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-msg/provider",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "packageManager": "bun@1.3.8",
   "type": "module",
   "description": "Complete provider system with adapters and implementations for K-Message platform",
@@ -55,7 +55,7 @@
     "publish": "bun publish --access public"
   },
   "dependencies": {
-    "@k-msg/core": "0.1.5",
+    "@k-msg/core": "0.2.0",
     "zod": "^4.0.14"
   },
   "devDependencies": {