@k-msg/provider 0.1.6 → 0.3.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

@@ -47,7 +47,7 @@ export interface Template {
     templateStatusMsg?: string;
     templateStatusComments?: string;
     createDate: string;
-    buttons: any[];
+    buttons: unknown[];
 }
 export interface TemplateListRequest {
     pageNum?: string;
@@ -114,10 +114,50 @@ export type CancelReservationResponse = IWINVBaseResponse;
 export interface BalanceResponse extends IWINVBaseResponse {
     charge: number;
 }
+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;

package/dist/solapi/provider.d.ts

@@ -0,0 +1,16 @@
+import { type StandardRequest, type StandardResult, UniversalProvider } from "@k-msg/core";
+import { type SolapiSdkClient } from "../adapters/solapi.adapter";
+import type { SolapiConfig } from "./types/solapi";
+export declare class SolapiProvider extends UniversalProvider {
+    constructor(config: SolapiConfig, client?: SolapiSdkClient);
+    send(params: StandardRequest): Promise<StandardResult>;
+    send(params: unknown): Promise<unknown>;
+    getBalance(): Promise<number>;
+}
+export declare const createSolapiProvider: (config: SolapiConfig) => SolapiProvider;
+export declare const createDefaultSolapiProvider: () => SolapiProvider;
+export declare class SolapiProviderFactory {
+    static create(config: SolapiConfig): SolapiProvider;
+    static createDefault(): SolapiProvider;
+}
+export declare function initializeSolapi(): void;

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

@@ -0,0 +1,27 @@
+import type { ProviderConfig } from "@k-msg/core";
+export interface SolapiConfig extends ProviderConfig {
+    /**
+     * SOLAPI API Secret
+     */
+    apiSecret: string;
+    /**
+     * Default sender number (SMS/LMS/MMS/RCS).
+     */
+    defaultFrom?: string;
+    /**
+     * Default Kakao PF ID (for ALIMTALK/FRIENDTALK).
+     */
+    kakaoPfId?: string;
+    /**
+     * Default RCS Brand ID.
+     */
+    rcsBrandId?: string;
+    /**
+     * Optional appId for Solapi send APIs.
+     */
+    appId?: string;
+    /**
+     * Default country code (e.g. "82"). Optional.
+     */
+    defaultCountry?: string;
+}

package/package.json

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