@k-msg/core 0.1.1 → 0.1.3

package/dist/types/provider.d.ts

@@ -0,0 +1,76 @@
+import type { DeliveryStatus, StandardRequest, StandardResult } from "./standard";
+export type ProviderType = "messaging" | "sms" | "email" | "push" | "voice";
+export interface ProviderConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeout?: number;
+    retries?: number;
+    debug?: boolean;
+    [key: string]: any;
+}
+export interface ConfigurationSchema {
+    required: ConfigField[];
+    optional: ConfigField[];
+}
+export interface ConfigField {
+    key: string;
+    type: "string" | "number" | "boolean" | "url" | "secret";
+    description: string;
+    validation?: {
+        pattern?: string;
+        min?: number;
+        max?: number;
+        enum?: string[];
+    };
+}
+export interface ProviderHealthStatus {
+    healthy: boolean;
+    issues: string[];
+    latency?: number;
+    data?: Record<string, unknown>;
+}
+export interface ProviderMetadata {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    supportedFeatures: string[];
+    capabilities: Record<string, any>;
+    endpoints: Record<string, string>;
+    authType?: string;
+    responseFormat?: string;
+}
+export interface ProviderFactoryConfig {
+    providers: Record<string, ProviderConfig>;
+}
+export declare abstract class BaseProviderAdapter {
+    protected config: ProviderConfig;
+    constructor(config: ProviderConfig);
+    abstract adaptRequest(request: StandardRequest): any;
+    abstract adaptResponse(response: any): StandardResult;
+    abstract mapError(error: any): import("./standard").StandardError;
+    abstract getAuthHeaders(): Record<string, string>;
+    abstract getBaseUrl(): string;
+    abstract getEndpoint(operation: string): string;
+    getRequestConfig(): RequestInit;
+    validateResponse(response: Response): boolean;
+    protected generateMessageId(): string;
+    protected log(message: string, data?: any): void;
+    isRetryableError(error: any): boolean;
+}
+export interface BaseProvider<TRequest = StandardRequest, TResult = StandardResult> {
+    readonly id: string;
+    readonly name: string;
+    readonly type: string;
+    readonly version: string;
+    healthCheck(): Promise<ProviderHealthStatus>;
+    send<T extends TRequest = TRequest, R extends TResult = TResult>(request: T): Promise<R>;
+    getStatus?(requestId: string): Promise<DeliveryStatus>;
+    cancel?(requestId: string): Promise<boolean>;
+    destroy?(): void;
+}
+export interface AdapterFactory {
+    create(config: ProviderConfig): any;
+    supports(providerId: string): boolean;
+    getMetadata(): ProviderMetadata;
+}

package/dist/types/standard.d.ts

@@ -0,0 +1,62 @@
+import type { Button, MessageType } from "./message";
+export interface DeliveryStatus {
+    status: "pending" | "sent" | "delivered" | "failed" | "cancelled";
+    timestamp: Date;
+    details?: Record<string, unknown>;
+}
+export declare enum StandardStatus {
+    PENDING = "PENDING",
+    SENT = "SENT",
+    DELIVERED = "DELIVERED",
+    FAILED = "FAILED",
+    CANCELLED = "CANCELLED"
+}
+export declare enum StandardErrorCode {
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    INVALID_REQUEST = "INVALID_REQUEST",
+    AUTHENTICATION_FAILED = "AUTHENTICATION_FAILED",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    TEMPLATE_NOT_FOUND = "TEMPLATE_NOT_FOUND",
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    PROVIDER_ERROR = "PROVIDER_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR"
+}
+export interface StandardError {
+    code: StandardErrorCode;
+    message: string;
+    retryable: boolean;
+    details?: Record<string, any>;
+}
+export interface StandardRequest {
+    channel?: MessageType;
+    templateCode: string;
+    phoneNumber: string;
+    variables: Record<string, any>;
+    text?: string;
+    imageUrl?: string;
+    buttons?: Button[];
+    options?: {
+        scheduledAt?: Date;
+        senderNumber?: string;
+        subject?: string;
+        [key: string]: any;
+    };
+}
+export interface StandardResult {
+    messageId: string;
+    status: StandardStatus;
+    provider: string;
+    timestamp: Date;
+    phoneNumber: string;
+    error?: StandardError;
+    metadata?: Record<string, any>;
+}
+export declare enum TemplateCategory {
+    AUTHENTICATION = "AUTHENTICATION",
+    NOTIFICATION = "NOTIFICATION",
+    PROMOTION = "PROMOTION",
+    INFORMATION = "INFORMATION",
+    RESERVATION = "RESERVATION",
+    SHIPPING = "SHIPPING",
+    PAYMENT = "PAYMENT"
+}

package/dist/universal-provider.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Universal Provider Implementation
+ * 어댑터 패턴을 사용한 범용 프로바이더
+ */
+import { type BaseProvider, type BaseProviderAdapter, type ConfigurationSchema, type DeliveryStatus, type ProviderHealthStatus, type StandardRequest, type StandardResult } from "./types/index";
+/**
+ * 어댑터 기반 범용 프로바이더
+ * 모든 프로바이더가 이 클래스를 사용하여 표준 인터페이스 구현
+ */
+export declare class UniversalProvider implements BaseProvider<StandardRequest, StandardResult> {
+    readonly id: string;
+    readonly name: string;
+    readonly type: "messaging";
+    readonly version: string;
+    private adapter;
+    private config;
+    private isConfigured;
+    constructor(adapter: BaseProviderAdapter, metadata: {
+        id: string;
+        name: string;
+        version: string;
+    });
+    configure(config: Record<string, unknown>): void;
+    isReady(): boolean;
+    healthCheck(): Promise<ProviderHealthStatus>;
+    destroy(): void;
+    send<T extends StandardRequest = StandardRequest, R extends StandardResult = StandardResult>(request: T): Promise<R>;
+    getStatus(requestId: string): Promise<DeliveryStatus>;
+    cancel(requestId: string): Promise<boolean>;
+    getCapabilities(): any;
+    getSupportedFeatures(): string[];
+    getConfigurationSchema(): ConfigurationSchema;
+    /**
+     * HTTP 요청 실행
+     */
+    private makeHttpRequest;
+    /**
+     * 표준 상태를 DeliveryStatus로 변환
+     */
+    private mapStandardStatusToDeliveryStatus;
+    /**
+     * 어댑터 인스턴스 반환 (고급 사용자용)
+     */
+    getAdapter(): BaseProviderAdapter;
+    /**
+     * 프로바이더 메타데이터 반환
+     */
+    getMetadata(): {
+        id: string;
+        name: string;
+        version: string;
+        type: "messaging";
+        adapter: string;
+    };
+}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@k-msg/core",
-  "version": "0.1.1",
+  "version": "0.1.3",
+  "packageManager": "bun@1.3.8",
   "description": "Core types and interfaces for K-Message platform",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,15 +18,27 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "bun run build:esm && bun run build:cjs && bun run build:types",
+    "build:esm": "bun build ./src/index.ts --outdir ./dist --format esm --minify --sourcemap --entry-naming '[name].mjs' --external 'bun:test'",
+    "build:cjs": "bun build ./src/index.ts --outdir ./dist --format cjs --minify --sourcemap --entry-naming '[name].js' --external 'bun:test'",
+    "build:types": "tsc",
     "dev": "tsc --watch",
-    "test": "bun test",
-    "clean": "rm -rf dist"
+    "test": "bun run test:unit",
+    "test:unit": "bun test --testPathPattern='.*\\.test\\.(ts|js)$' --testTimeout=5000",
+    "test:integration": "bun test --testPathPattern='.*\\.integration\\.(ts|js)$' --testTimeout=10000",
+    "test:e2e": "bun test --testPathPattern='.*\\.e2e\\.(ts|js)$' --testTimeout=30000",
+    "test:coverage": "bun test --coverage",
+    "test:watch": "bun test --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "pack": "bun pm pack",
+    "publish": "bun publish --access public"
+  },
+  "dependencies": {
+    "zod": "^4.0.14"
   },
-  "dependencies": {},
   "devDependencies": {
     "@types/bun": "latest",
-    "tsup": "^8.5.0",
     "typescript": "^5.0.0"
   },
   "peerDependencies": {},
@@ -42,12 +55,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/k-otp/k-message.git"
+    "url": "git+https://github.com/k-otp/k-msg.git"
   },
-  "homepage": "https://github.com/k-otp/k-message",
+  "homepage": "https://github.com/k-otp/k-msg",
   "bugs": {
-    "url": "https://github.com/k-otp/k-message/issues"
+    "url": "https://github.com/k-otp/k-msg/issues"
   },
   "author": "imjlk",
   "license": "MIT"
-}
+}