@k-msg/core 0.1.5 → 0.2.0

package/dist/platform.d.ts

@@ -1,4 +1,4 @@
-import type { BaseProvider, Config, KMsg, MessageSendOptions, MessageSendResult, PlatformHealthStatus, PlatformInfo } from "./types/index";
+import type { BalanceQuery, BalanceResult, BaseProvider, Config, HistoryQuery, HistoryResult, KMsg, MessageSendOptions, MessageSendResult, PlatformHealthStatus, PlatformInfo } from "./types/index";
 /**
  * Core AlimTalk Platform implementation
  */
@@ -33,31 +33,41 @@ export declare class AlimTalkPlatform implements KMsg {
     healthCheck(): Promise<PlatformHealthStatus>;
     get messages(): {
         send: (options: MessageSendOptions) => Promise<MessageSendResult>;
-        getStatus: (messageId: string) => Promise<string>;
+        getStatus: (_messageId: string) => Promise<string>;
     };
+    balance(providerId?: string): Promise<{
+        get: (query?: BalanceQuery) => Promise<BalanceResult>;
+    }>;
     /**
      * @deprecated Template operations are not yet migrated to the new provider interface.
      * Use the provider's adapter directly for template management.
      */
     templates(providerId?: string): Promise<{
         /** @deprecated Not yet implemented */
-        list: (_page?: number, _size?: number, _filters?: any) => Promise<never>;
+        list: (_page?: number, _size?: number, _filters?: Record<string, unknown>) => Promise<never>;
         /** @deprecated Not yet implemented */
-        create: (_name: string, _content: string, _category?: string, _variables?: any[], _buttons?: any[]) => Promise<never>;
+        create: (_name: string, _content: string, _category?: string, _variables?: unknown[], _buttons?: unknown[]) => Promise<never>;
         /** @deprecated Not yet implemented */
-        modify: (_templateCode: string, _name: string, _content: string, _buttons?: any[]) => Promise<never>;
+        modify: (_templateCode: string, _name: string, _content: string, _buttons?: unknown[]) => Promise<never>;
         /** @deprecated Not yet implemented */
         delete: (_templateCode: string) => Promise<never>;
     }>;
     /**
-     * @deprecated History operations are not yet migrated to the new provider interface.
-     * Use the provider's adapter directly for history queries.
+     * History operations (common API surface).
+     *
+     * Notes:
+     * - Not all providers implement history. This method will throw when unsupported.
+     * - For provider-specific, advanced fields, use provider adapter directly.
      */
     history(providerId?: string): Promise<{
-        /** @deprecated Not yet implemented */
-        list: (_page?: number, _size?: number, _filters?: any) => Promise<never>;
-        /** @deprecated Not yet implemented */
+        list: (queryOrPage?: HistoryQuery | number, pageSize?: number, filters?: Partial<Omit<HistoryQuery, "page" | "pageSize">> & {
+            channel?: HistoryQuery["channel"];
+        }) => Promise<HistoryResult>;
         cancelReservation: (_messageId: string) => Promise<never>;
     }>;
     providerHealth(providerId: string): Promise<import(".").ProviderHealthStatus>;
+    private getProviderAdapter;
+    private isSmsChannel;
+    private normalizeHistoryQuery;
+    private getFunction;
 }

package/dist/router/round-robin-router-provider.d.ts

@@ -0,0 +1,20 @@
+import type { BaseProvider, ProviderHealthStatus, StandardRequest, StandardResult } from "../types/index";
+/**
+ * Round-robin router provider that forwards requests to upstream providers.
+ * Useful for simple load distribution or provider rotation strategies.
+ */
+export declare class RoundRobinRouterProvider implements BaseProvider<StandardRequest, StandardResult> {
+    readonly id: string;
+    readonly name: string;
+    readonly type: "messaging";
+    readonly version = "1.0.0";
+    private readonly providers;
+    private idx;
+    constructor(params: {
+        id: string;
+        name?: string;
+        providers: BaseProvider<StandardRequest, StandardResult>[];
+    });
+    healthCheck(): Promise<ProviderHealthStatus>;
+    send<T extends StandardRequest = StandardRequest, R extends StandardResult = StandardResult>(request: T): Promise<R>;
+}

package/dist/types/balance.d.ts

@@ -0,0 +1,12 @@
+import type { MessageType } from "./message";
+export type BalanceChannel = MessageType;
+export interface BalanceQuery {
+    channel?: BalanceChannel;
+}
+export interface BalanceResult {
+    providerId: string;
+    channel?: BalanceChannel;
+    amount: number;
+    currency?: string;
+    raw?: unknown;
+}

package/dist/types/history.d.ts

@@ -0,0 +1,31 @@
+import type { MessageType } from "./message";
+export type HistoryChannel = MessageType;
+export interface HistoryQuery {
+    channel: HistoryChannel;
+    startDate: string | Date;
+    endDate: string | Date;
+    page?: number;
+    pageSize?: number;
+    phone?: string;
+    requestNo?: string;
+    companyId?: string;
+}
+export interface HistoryItem {
+    providerId: string;
+    channel: HistoryChannel;
+    messageId: string;
+    to?: string;
+    from?: string;
+    status?: string;
+    statusCode?: string;
+    statusMessage?: string;
+    sentAt?: Date;
+    raw: unknown;
+}
+export interface HistoryResult {
+    providerId: string;
+    channel: HistoryChannel;
+    totalCount: number;
+    items: HistoryItem[];
+    raw?: unknown;
+}

package/dist/types/index.d.ts

@@ -1,3 +1,5 @@
+export * from "./balance";
+export * from "./history";
 export * from "./message";
 export * from "./platform";
 export * from "./provider";

package/dist/types/platform.d.ts

@@ -1,4 +1,7 @@
+import type { BalanceQuery, BalanceResult } from "./balance";
+import type { HistoryQuery, HistoryResult } from "./history";
 import type { Button, MessageType } from "./message";
+import type { BaseProvider } from "./provider";
 export interface PlatformHealthStatus {
     healthy: boolean;
     providers: Record<string, boolean>;
@@ -13,20 +16,20 @@ export interface LegacyMessageSendOptions {
     templateId: string;
     recipients: {
         phoneNumber: string;
-        variables?: Record<string, any>;
+        variables?: Record<string, unknown>;
     }[];
-    variables: Record<string, any>;
+    variables: Record<string, unknown>;
 }
 export interface UnifiedMessageRecipient {
     phoneNumber: string;
-    variables?: Record<string, any>;
+    variables?: Record<string, unknown>;
 }
 export interface UnifiedMessageSendOptions {
     channel: MessageType;
     recipients: Array<string | UnifiedMessageRecipient>;
     providerId?: string;
     templateCode?: string;
-    variables?: Record<string, any>;
+    variables?: Record<string, unknown>;
     text?: string;
     subject?: string;
     imageUrl?: string;
@@ -35,7 +38,7 @@ export interface UnifiedMessageSendOptions {
         scheduledAt?: Date;
         senderNumber?: string;
         subject?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 export type MessageSendOptions = LegacyMessageSendOptions | UnifiedMessageSendOptions;
@@ -56,10 +59,19 @@ export interface MessageSendResult {
 }
 export interface KMsg {
     getInfo(): PlatformInfo;
-    registerProvider(provider: any): void;
-    getProvider(providerId: string): any | null;
+    registerProvider(provider: BaseProvider): void;
+    getProvider(providerId: string): BaseProvider | null;
     listProviders(): string[];
     healthCheck(): Promise<PlatformHealthStatus>;
+    balance(providerId?: string): Promise<{
+        get(query?: BalanceQuery): Promise<BalanceResult>;
+    }>;
+    history(providerId?: string): Promise<{
+        list(query: HistoryQuery): Promise<HistoryResult>;
+        list(page?: number, pageSize?: number, filters?: Partial<Omit<HistoryQuery, "page" | "pageSize">> & {
+            channel?: HistoryQuery["channel"];
+        }): Promise<HistoryResult>;
+    }>;
     messages: {
         send(options: MessageSendOptions): Promise<MessageSendResult>;
         getStatus(messageId: string): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-msg/core",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "packageManager": "bun@1.3.8",
   "description": "Core types and interfaces for K-Message platform",
   "type": "module",