@k-msg/messaging 0.4.0 → 0.6.0

package/dist/k-msg.d.ts

@@ -1,8 +1,63 @@
-import { KMsgError, type Provider, type Result, type SendOptions, type SendResult } from "@k-msg/core";
+import { KMsgError, type MessageType, type Provider, type ProviderHealthStatus, type Result, type SendInput, type SendResult } from "@k-msg/core";
 import type { KMsgHooks } from "./hooks";
+export type RoutingStrategy = "first" | "round_robin";
+export interface KMsgRoutingConfig {
+    byType?: Partial<Record<MessageType, string | string[]>>;
+    defaultProviderId?: string;
+    strategy?: RoutingStrategy;
+}
+export interface KMsgDefaultsConfig {
+    from?: string;
+    sms?: {
+        /**
+         * If type is omitted (SMS default input), upgrade to LMS when estimated bytes exceed this value.
+         * Default: 90
+         */
+        autoLmsBytes?: number;
+    };
+    kakao?: {
+        profileId?: string;
+    };
+    naver?: {
+        talkId?: string;
+    };
+    rcs?: {
+        brandId?: string;
+    };
+}
+export interface KMsgConfig {
+    providers: Provider[];
+    routing?: KMsgRoutingConfig;
+    defaults?: KMsgDefaultsConfig;
+    hooks?: KMsgHooks;
+}
 export declare class KMsg {
-    private readonly provider;
+    private readonly providers;
+    private readonly providersById;
     private readonly hooks;
-    constructor(provider: Provider, hooks?: KMsgHooks);
-    send(options: SendOptions): Promise<Result<SendResult, KMsgError>>;
+    private readonly routing;
+    private readonly defaults;
+    private readonly rrIndexByKey;
+    constructor(config: KMsgConfig);
+    healthCheck(): Promise<{
+        healthy: boolean;
+        providers: Record<string, ProviderHealthStatus>;
+        issues: string[];
+    }>;
+    send(input: SendInput): Promise<Result<SendResult, KMsgError>>;
+    sendOrThrow(input: SendInput): Promise<SendResult>;
+    sendMany(inputs: SendInput[], options?: {
+        concurrency?: number;
+        stopOnFailure?: boolean;
+    }): Promise<Array<Result<SendResult, KMsgError>>>;
+    private toKMsgError;
+    private selectProvider;
+    private pickRoundRobin;
+    private normalizeInput;
+    private applyDefaults;
+    private coerceVariables;
+    private interpolateText;
+    private interpolateTextOptions;
+    private stringifyVariables;
+    private estimateBytes;
 }

package/dist/queue/retry.handler.d.ts

@@ -1,7 +1,7 @@
 /**
  * Retry handler for failed message deliveries
  */
-import { EventEmitter } from "events";
+import { EventEmitter } from "node:events";
 import { type DeliveryReport, MessageStatus } from "../types/message.types";
 export interface RetryPolicy {
     maxAttempts: number;
@@ -18,9 +18,9 @@ export interface RetryAttempt {
     attemptNumber: number;
     scheduledAt: Date;
     provider: string;
-    templateId: string;
-    variables: Record<string, any>;
-    metadata: Record<string, any>;
+    templateCode: string;
+    variables: Record<string, unknown>;
+    metadata: Record<string, unknown>;
 }
 export interface RetryQueueItem {
     id: string;
@@ -39,7 +39,7 @@ export interface RetryHandlerOptions {
     maxQueueSize: number;
     enablePersistence: boolean;
     onRetryExhausted?: (item: RetryQueueItem) => Promise<void>;
-    onRetrySuccess?: (item: RetryQueueItem, result: any) => Promise<void>;
+    onRetrySuccess?: (item: RetryQueueItem, result: unknown) => Promise<void>;
     onRetryFailed?: (item: RetryQueueItem, error: Error) => Promise<void>;
 }
 export interface RetryHandlerMetrics {

package/dist/sender/bulk.sender.d.ts

@@ -7,7 +7,8 @@ export declare class BulkMessageSender {
     sendBulk(request: BulkMessageRequest): Promise<BulkMessageResult>;
     private processBatchesAsync;
     private processBatch;
-    private processRecipient;
+    private sendManyWithRetry;
+    private toRecipientResult;
     private createBatches;
     private delay;
     private generateRequestId;

package/dist/types/message.types.d.ts

@@ -1,7 +1,7 @@
 import type { RetryOptions } from "@k-msg/core";
 import { z } from "zod";
 export interface MessageRequest {
-    templateId: string;
+    templateCode: string;
     recipients: Recipient[];
     variables: VariableMap;
     scheduling?: SchedulingOptions;
@@ -10,7 +10,7 @@ export interface MessageRequest {
 export interface Recipient {
     phoneNumber: string;
     variables?: VariableMap;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 export interface VariableMap {
     [key: string]: string | number | Date;
@@ -49,7 +49,7 @@ export interface MessageResult {
     metadata: {
         createdAt: Date;
         provider: string;
-        templateId: string;
+        templateCode: string;
     };
 }
 export interface RecipientResult {
@@ -57,7 +57,7 @@ export interface RecipientResult {
     messageId?: string;
     status: MessageStatus;
     error?: MessageError;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 export declare enum MessageStatus {
     QUEUED = "QUEUED",// 큐에 대기 중
@@ -71,7 +71,7 @@ export declare enum MessageStatus {
 export interface MessageError {
     code: string;
     message: string;
-    details?: Record<string, any>;
+    details?: Record<string, unknown>;
 }
 export interface DeliveryReport {
     messageId: string;
@@ -83,7 +83,7 @@ export interface DeliveryReport {
     failedAt?: Date;
     error?: MessageError;
     attempts: DeliveryAttempt[];
-    metadata: Record<string, any>;
+    metadata: Record<string, unknown>;
 }
 export interface DeliveryAttempt {
     attemptNumber: number;
@@ -92,8 +92,14 @@ export interface DeliveryAttempt {
     error?: MessageError;
     provider: string;
 }
+export type BulkMessageType = "ALIMTALK" | "NSA" | "RCS_TPL" | "RCS_ITPL" | "RCS_LTPL";
 export interface BulkMessageRequest {
-    templateId: string;
+    /**
+     * BulkMessageSender currently targets template-based channels.
+     * Default: "ALIMTALK"
+     */
+    type?: BulkMessageType;
+    templateCode: string;
     recipients: BulkRecipient[];
     commonVariables?: VariableMap;
     options?: BulkSendingOptions;
@@ -101,9 +107,17 @@ export interface BulkMessageRequest {
 export interface BulkRecipient {
     phoneNumber: string;
     variables: VariableMap;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 export interface BulkSendingOptions extends SendingOptions {
+    /**
+     * Sender number / id for bulk sends (optional if KMsg defaults cover it).
+     */
+    from?: string;
+    /**
+     * Back-compat alias for legacy callers.
+     */
+    senderNumber?: string;
     batchSize?: number;
     batchDelay?: number;
     maxConcurrency?: number;
@@ -149,7 +163,7 @@ export declare enum MessageEventType {
     QUOTA_EXCEEDED = "system.quota_exceeded",
     PROVIDER_ERROR = "system.provider_error"
 }
-export interface MessageEvent<T = any> {
+export interface MessageEvent<T = unknown> {
     id: string;
     type: MessageEventType;
     timestamp: Date;
@@ -197,7 +211,7 @@ export declare const SendingOptionsSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const MessageRequestSchema: z.ZodObject<{
-    templateId: z.ZodString;
+    templateCode: z.ZodString;
     recipients: z.ZodArray<z.ZodObject<{
         phoneNumber: z.ZodString;
         variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate]>>>;
@@ -272,7 +286,7 @@ export declare const MessageResultSchema: z.ZodObject<{
     metadata: z.ZodObject<{
         createdAt: z.ZodDate;
         provider: z.ZodString;
-        templateId: z.ZodString;
+        templateCode: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type MessageRequestType = z.infer<typeof MessageRequestSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-msg/messaging",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "packageManager": "bun@1.3.8",
   "description": "AlimTalk messaging core for sending, queuing, and tracking messages",
   "type": "module",
@@ -30,9 +30,9 @@
   },
   "dependencies": {
     "zod": "^4.0.14",
-    "@k-msg/core": "0.4.0",
-    "@k-msg/provider": "0.4.0",
-    "@k-msg/template": "0.4.0"
+    "@k-msg/core": "0.6.0",
+    "@k-msg/provider": "0.6.0",
+    "@k-msg/template": "0.6.0"
   },
   "devDependencies": {
     "typescript": "^5.7.2",