@k-msg/core 0.16.0 → 0.18.0

package/dist/persistence/repository.d.ts

@@ -0,0 +1,11 @@
+import type { KMsgError } from "../errors";
+import type { Result } from "../result";
+import type { SendInput, SendResult } from "../types/message";
+export type PersistenceStrategy = "none" | "log" | "queue" | "full";
+export interface MessageRepository {
+    save(input: SendInput, options?: {
+        strategy?: PersistenceStrategy;
+    }): Promise<Result<string, KMsgError>>;
+    update(messageId: string, result: Partial<SendResult>): Promise<Result<void, KMsgError>>;
+    find(messageId: string): Promise<Result<SendResult | null, KMsgError>>;
+}

package/dist/provider.d.ts

@@ -1,6 +1,6 @@
 import type { KMsgError } from "./errors";
 import type { Result } from "./result";
-import type { DeliveryStatusQuery, DeliveryStatusResult, KakaoChannel, KakaoChannelCategories, MessageType, ProviderOnboardingSpec, SendOptions, SendResult } from "./types/index";
+import type { BalanceQuery, BalanceResult, DeliveryStatusQuery, DeliveryStatusResult, KakaoChannel, KakaoChannelCategories, MessageType, ProviderOnboardingSpec, SendOptions, SendResult } from "./types/index";
 export interface Template {
     id: string;
     code: string;
@@ -64,6 +64,9 @@ export interface ProviderHealthStatus {
     latencyMs?: number;
     data?: Record<string, unknown>;
 }
+export interface BalanceProvider {
+    getBalance(query?: BalanceQuery): Promise<Result<BalanceResult, KMsgError>>;
+}
 export interface Provider {
     readonly id: string;
     readonly name: string;

package/dist/resilience/index.d.ts

@@ -1,7 +1,4 @@
 export { BulkOperationHandler, type BulkOperationOptions, } from "./bulk-operation";
 export { CircuitBreaker, type CircuitBreakerOptions } from "./circuit-breaker";
-export { ErrorRecovery } from "./error-recovery";
-export { GracefulDegradation } from "./graceful-degradation";
-export { HealthMonitor } from "./health-monitor";
 export { RateLimiter } from "./rate-limiter";
 export { RetryHandler, type RetryOptions } from "./retry-handler";

package/dist/runtime/env.d.ts

@@ -0,0 +1,11 @@
+export type RuntimeEnvRecord = Record<string, string | undefined>;
+/**
+ * Resolve environment variables in a runtime-neutral order.
+ *
+ * Priority:
+ * 1. globalThis.__K_MSG_ENV__
+ * 2. globalThis.__ENV__
+ * 3. globalThis.process?.env
+ */
+export declare function getRuntimeEnvSource(): RuntimeEnvRecord;
+export declare function readRuntimeEnv(key: string): string | undefined;

package/dist/types/index.d.ts

@@ -1,6 +1,5 @@
 export * from "./balance";
 export * from "./delivery-status";
-export * from "./history";
 export * from "./kakao-channel";
 export * from "./message";
 export * from "./onboarding";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-msg/core",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "packageManager": "bun@1.3.8",
   "description": "Core types and interfaces for K-Message platform",
   "type": "module",
@@ -38,8 +38,8 @@
     "zod": "^4.0.14"
   },
   "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.0.0"
+    "@types/bun": "^1.3.9",
+    "typescript": "^5.7.2"
   },
   "peerDependencies": {},
   "files": [

package/dist/config.d.ts

@@ -1,206 +0,0 @@
-import { z } from "zod";
-import { LogLevel } from "./logger";
-export declare const DatabaseConfigSchema: z.ZodObject<{
-    host: z.ZodDefault<z.ZodString>;
-    port: z.ZodDefault<z.ZodNumber>;
-    database: z.ZodString;
-    username: z.ZodString;
-    password: z.ZodString;
-    ssl: z.ZodDefault<z.ZodBoolean>;
-    maxConnections: z.ZodDefault<z.ZodNumber>;
-    connectionTimeout: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const RedisConfigSchema: z.ZodObject<{
-    host: z.ZodDefault<z.ZodString>;
-    port: z.ZodDefault<z.ZodNumber>;
-    password: z.ZodOptional<z.ZodString>;
-    db: z.ZodDefault<z.ZodNumber>;
-    keyPrefix: z.ZodDefault<z.ZodString>;
-    maxRetries: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const LoggerConfigSchema: z.ZodObject<{
-    level: z.ZodDefault<z.ZodEnum<typeof LogLevel>>;
-    enableConsole: z.ZodDefault<z.ZodBoolean>;
-    enableFile: z.ZodDefault<z.ZodBoolean>;
-    filePath: z.ZodOptional<z.ZodString>;
-    maxFileSize: z.ZodDefault<z.ZodNumber>;
-    maxFiles: z.ZodDefault<z.ZodNumber>;
-    enableJson: z.ZodDefault<z.ZodBoolean>;
-    enableColors: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-export declare const HealthConfigSchema: z.ZodObject<{
-    timeout: z.ZodDefault<z.ZodNumber>;
-    interval: z.ZodDefault<z.ZodNumber>;
-    retries: z.ZodDefault<z.ZodNumber>;
-    includeMetrics: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-export declare const IWINVConfigSchema: z.ZodObject<{
-    apiKey: z.ZodString;
-    timeout: z.ZodDefault<z.ZodNumber>;
-    retryAttempts: z.ZodDefault<z.ZodNumber>;
-    retryDelay: z.ZodDefault<z.ZodNumber>;
-    debug: z.ZodDefault<z.ZodBoolean>;
-    rateLimit: z.ZodDefault<z.ZodObject<{
-        requests: z.ZodDefault<z.ZodNumber>;
-        perSecond: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export declare const SMSConfigSchema: z.ZodObject<{
-    provider: z.ZodEnum<{
-        iwinv: "iwinv";
-        aligo: "aligo";
-        solapi: "solapi";
-        coolsms: "coolsms";
-    }>;
-    apiKey: z.ZodString;
-    apiSecret: z.ZodOptional<z.ZodString>;
-    senderId: z.ZodString;
-    defaultCountryCode: z.ZodDefault<z.ZodString>;
-    timeout: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const ServerConfigSchema: z.ZodObject<{
-    port: z.ZodDefault<z.ZodNumber>;
-    host: z.ZodDefault<z.ZodString>;
-    cors: z.ZodDefault<z.ZodObject<{
-        origins: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        credentials: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    maxRequestSize: z.ZodDefault<z.ZodNumber>;
-    requestTimeout: z.ZodDefault<z.ZodNumber>;
-    enableMetrics: z.ZodDefault<z.ZodBoolean>;
-    enableDocs: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-export declare const QueueConfigSchema: z.ZodObject<{
-    maxConcurrency: z.ZodDefault<z.ZodNumber>;
-    maxRetries: z.ZodDefault<z.ZodNumber>;
-    retryDelay: z.ZodDefault<z.ZodNumber>;
-    maxAge: z.ZodDefault<z.ZodNumber>;
-    batchSize: z.ZodDefault<z.ZodNumber>;
-    processingInterval: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const KMessageConfigSchema: z.ZodObject<{
-    environment: z.ZodDefault<z.ZodEnum<{
-        development: "development";
-        staging: "staging";
-        production: "production";
-    }>>;
-    server: z.ZodDefault<z.ZodObject<{
-        port: z.ZodDefault<z.ZodNumber>;
-        host: z.ZodDefault<z.ZodString>;
-        cors: z.ZodDefault<z.ZodObject<{
-            origins: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            credentials: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>;
-        maxRequestSize: z.ZodDefault<z.ZodNumber>;
-        requestTimeout: z.ZodDefault<z.ZodNumber>;
-        enableMetrics: z.ZodDefault<z.ZodBoolean>;
-        enableDocs: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    database: z.ZodOptional<z.ZodObject<{
-        host: z.ZodDefault<z.ZodString>;
-        port: z.ZodDefault<z.ZodNumber>;
-        database: z.ZodString;
-        username: z.ZodString;
-        password: z.ZodString;
-        ssl: z.ZodDefault<z.ZodBoolean>;
-        maxConnections: z.ZodDefault<z.ZodNumber>;
-        connectionTimeout: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    redis: z.ZodOptional<z.ZodObject<{
-        host: z.ZodDefault<z.ZodString>;
-        port: z.ZodDefault<z.ZodNumber>;
-        password: z.ZodOptional<z.ZodString>;
-        db: z.ZodDefault<z.ZodNumber>;
-        keyPrefix: z.ZodDefault<z.ZodString>;
-        maxRetries: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    logger: z.ZodDefault<z.ZodObject<{
-        level: z.ZodDefault<z.ZodEnum<typeof LogLevel>>;
-        enableConsole: z.ZodDefault<z.ZodBoolean>;
-        enableFile: z.ZodDefault<z.ZodBoolean>;
-        filePath: z.ZodOptional<z.ZodString>;
-        maxFileSize: z.ZodDefault<z.ZodNumber>;
-        maxFiles: z.ZodDefault<z.ZodNumber>;
-        enableJson: z.ZodDefault<z.ZodBoolean>;
-        enableColors: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    health: z.ZodDefault<z.ZodObject<{
-        timeout: z.ZodDefault<z.ZodNumber>;
-        interval: z.ZodDefault<z.ZodNumber>;
-        retries: z.ZodDefault<z.ZodNumber>;
-        includeMetrics: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    queue: z.ZodDefault<z.ZodObject<{
-        maxConcurrency: z.ZodDefault<z.ZodNumber>;
-        maxRetries: z.ZodDefault<z.ZodNumber>;
-        retryDelay: z.ZodDefault<z.ZodNumber>;
-        maxAge: z.ZodDefault<z.ZodNumber>;
-        batchSize: z.ZodDefault<z.ZodNumber>;
-        processingInterval: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    providers: z.ZodDefault<z.ZodObject<{
-        iwinv: z.ZodOptional<z.ZodObject<{
-            apiKey: z.ZodString;
-            timeout: z.ZodDefault<z.ZodNumber>;
-            retryAttempts: z.ZodDefault<z.ZodNumber>;
-            retryDelay: z.ZodDefault<z.ZodNumber>;
-            debug: z.ZodDefault<z.ZodBoolean>;
-            rateLimit: z.ZodDefault<z.ZodObject<{
-                requests: z.ZodDefault<z.ZodNumber>;
-                perSecond: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-        sms: z.ZodOptional<z.ZodObject<{
-            provider: z.ZodEnum<{
-                iwinv: "iwinv";
-                aligo: "aligo";
-                solapi: "solapi";
-                coolsms: "coolsms";
-            }>;
-            apiKey: z.ZodString;
-            apiSecret: z.ZodOptional<z.ZodString>;
-            senderId: z.ZodString;
-            defaultCountryCode: z.ZodDefault<z.ZodString>;
-            timeout: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    features: z.ZodDefault<z.ZodObject<{
-        enableBulkSending: z.ZodDefault<z.ZodBoolean>;
-        enableScheduling: z.ZodDefault<z.ZodBoolean>;
-        enableAnalytics: z.ZodDefault<z.ZodBoolean>;
-        enableWebhooks: z.ZodDefault<z.ZodBoolean>;
-        enableTemplateCache: z.ZodDefault<z.ZodBoolean>;
-        maxTemplatesPerProvider: z.ZodDefault<z.ZodNumber>;
-        maxRecipientsPerBatch: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    security: z.ZodDefault<z.ZodObject<{
-        apiKeyRequired: z.ZodDefault<z.ZodBoolean>;
-        rateLimitEnabled: z.ZodDefault<z.ZodBoolean>;
-        maxRequestsPerMinute: z.ZodDefault<z.ZodNumber>;
-        enableCors: z.ZodDefault<z.ZodBoolean>;
-        trustedProxies: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type DatabaseConfig = z.infer<typeof DatabaseConfigSchema>;
-export type RedisConfig = z.infer<typeof RedisConfigSchema>;
-export type ConfigLoggerConfig = z.infer<typeof LoggerConfigSchema>;
-export type HealthConfig = z.infer<typeof HealthConfigSchema>;
-export type IWINVConfig = z.infer<typeof IWINVConfigSchema>;
-export type SMSConfig = z.infer<typeof SMSConfigSchema>;
-export type ServerConfig = z.infer<typeof ServerConfigSchema>;
-export type QueueConfig = z.infer<typeof QueueConfigSchema>;
-export type KMessageConfig = z.infer<typeof KMessageConfigSchema>;
-export declare class ConfigLoader {
-    static loadFromEnv(): KMessageConfig;
-    static loadFromFile(filePath: string): Promise<KMessageConfig>;
-    static validate(config: unknown): KMessageConfig;
-    static getDefaults(): KMessageConfig;
-}
-type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-export declare const developmentConfig: DeepPartial<KMessageConfig>;
-export declare const productionConfig: DeepPartial<KMessageConfig>;
-export declare function mergeConfigs(base: KMessageConfig, override: Partial<KMessageConfig>): KMessageConfig;
-export declare function validateProviderConfig(provider: "iwinv" | "sms", config: unknown): IWINVConfig | SMSConfig;
-export {};

package/dist/health.d.ts

@@ -1,39 +0,0 @@
-export interface HealthStatus {
-    healthy: boolean;
-    timestamp: Date;
-    uptime: number;
-    version?: string;
-    services?: Record<string, ServiceHealth>;
-    metrics?: Record<string, any>;
-}
-export interface ServiceHealth {
-    healthy: boolean;
-    latency?: number;
-    error?: string;
-    lastCheck?: Date;
-}
-export interface HealthCheckConfig {
-    timeout?: number;
-    interval?: number;
-    retries?: number;
-    includeMetrics?: boolean;
-}
-export declare class HealthChecker {
-    private config;
-    private startTime;
-    private services;
-    private lastCheck;
-    constructor(config?: HealthCheckConfig);
-    registerService(name: string, checkFn: () => Promise<ServiceHealth>): void;
-    unregisterService(name: string): boolean;
-    clearServices(): void;
-    checkHealth(): Promise<HealthStatus>;
-    getLastKnownStatus(): HealthStatus;
-    private timeoutPromise;
-    private calculateAverageLatency;
-}
-export declare class SimpleHealthChecker {
-    static database(): () => Promise<ServiceHealth>;
-    static external(url: string, timeout?: number): () => Promise<ServiceHealth>;
-    static memory(maxUsageMB?: number): () => Promise<ServiceHealth>;
-}

package/dist/resilience/error-recovery.d.ts

@@ -1,20 +0,0 @@
-/**
- * Error recovery utilities - combines multiple recovery patterns
- */
-import { type CircuitBreakerOptions } from "./circuit-breaker";
-import { type RetryOptions } from "./retry-handler";
-export declare const ErrorRecovery: {
-    /**
-     * Create a resilient function that combines multiple recovery patterns
-     */
-    createResilientFunction<T extends any[], R>(func: (...args: T) => Promise<R>, options?: {
-        retryOptions?: Partial<RetryOptions>;
-        circuitBreaker?: CircuitBreakerOptions;
-        rateLimiter?: {
-            maxRequests: number;
-            windowMs: number;
-        };
-        timeout?: number;
-        fallback?: (...args: T) => Promise<R>;
-    }): (...args: T) => Promise<R>;
-};

package/dist/resilience/graceful-degradation.d.ts

@@ -1,12 +0,0 @@
-/**
- * Graceful degradation handler
- */
-import { type RetryOptions } from "./retry-handler";
-export declare class GracefulDegradation {
-    private fallbackStrategies;
-    registerFallback<T>(operationName: string, fallbackFunction: () => Promise<T>): void;
-    executeWithFallback<T>(operationName: string, primaryOperation: () => Promise<T>, options?: {
-        timeout?: number;
-        retryOptions?: Partial<RetryOptions>;
-    }): Promise<T>;
-}

package/dist/resilience/health-monitor.d.ts

@@ -1,20 +0,0 @@
-/**
- * Health check monitor with automatic recovery
- * Note: This is the resilience-layer health monitor.
- * For the main health check system, see ../health.ts
- */
-export declare class HealthMonitor {
-    private services;
-    private healthStatus;
-    private lastCheck;
-    private checkInterval;
-    private intervalId?;
-    constructor(services: Map<string, () => Promise<boolean>>, checkIntervalMs?: number);
-    start(): void;
-    stop(): void;
-    private checkAllServices;
-    getServiceHealth(serviceName: string): boolean | undefined;
-    getAllHealth(): Record<string, boolean>;
-    isServiceHealthy(serviceName: string): boolean;
-    getLastCheckTime(serviceName: string): number | undefined;
-}

package/dist/types/history.d.ts

@@ -1,40 +0,0 @@
-import type { MessageType } from "./message";
-export type HistoryChannel = MessageType;
-export interface HistoryQuery {
-    channel: HistoryChannel;
-    startDate: string | Date;
-    endDate: string | Date;
-    page?: number;
-    pageSize?: number;
-    /**
-     * Cursor key for providers that use cursor-based pagination (e.g. SOLAPI).
-     * When provided, it takes precedence over `page`.
-     */
-    startKey?: string;
-    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;
-    /**
-     * Cursor key for fetching the next page when provider supports cursor pagination.
-     */
-    nextKey?: string | null;
-    items: HistoryItem[];
-    raw?: unknown;
-}