@k-msg/messaging 0.4.0 → 0.5.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

@@ -18,7 +18,7 @@ export interface RetryAttempt {
     attemptNumber: number;
     scheduledAt: Date;
     provider: string;
-    templateId: string;
+    templateCode: string;
     variables: Record<string, any>;
     metadata: Record<string, any>;
 }

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;
@@ -49,7 +49,7 @@ export interface MessageResult {
     metadata: {
         createdAt: Date;
         provider: string;
-        templateId: string;
+        templateCode: string;
     };
 }
 export interface RecipientResult {
@@ -93,7 +93,7 @@ export interface DeliveryAttempt {
     provider: string;
 }
 export interface BulkMessageRequest {
-    templateId: string;
+    templateCode: string;
     recipients: BulkRecipient[];
     commonVariables?: VariableMap;
     options?: BulkSendingOptions;
@@ -197,7 +197,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 +272,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.5.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.5.0",
+    "@k-msg/provider": "0.5.0",
+    "@k-msg/template": "0.5.0"
   },
   "devDependencies": {
     "typescript": "^5.7.2",