@k-msg/webhook 0.1.0 → 0.1.2

package/README.md

@@ -415,4 +415,4 @@ MIT License - [LICENSE](../../LICENSE) 파일을 참조하세요.
 
 **K-Message** - 한국형 멀티채널 메시징 플랫폼
 
-🌟 [GitHub](https://github.com/imjlk/k-message) | 📖 [Documentation](https://k-message.dev) | 💬 [Discord](https://discord.gg/k-message)
+🌟 [GitHub](https://github.com/imjlk/k-msg) | 📖 [Documentation](https://k-msg.dev) | 💬 [Discord](https://discord.gg/k-msg)

package/dist/dispatcher/batch.dispatcher.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Batch Webhook Dispatcher
+ * 대량 웹훅 요청을 효율적으로 처리하는 배치 디스패처
+ */
+import { EventEmitter } from "events";
+import type { WebhookBatch } from "../types/webhook.types";
+import type { BatchConfig, DispatchJob } from "./types";
+export declare class BatchDispatcher extends EventEmitter {
+    private config;
+    private pendingJobs;
+    private activeBatches;
+    private batchProcessor;
+    private defaultConfig;
+    constructor(config?: Partial<BatchConfig>);
+    /**
+     * 배치 작업 추가
+     */
+    addJob(job: DispatchJob): Promise<void>;
+    /**
+     * 특정 엔드포인트의 배치 처리
+     */
+    processBatchForEndpoint(endpointId: string): Promise<WebhookBatch | null>;
+    /**
+     * 모든 대기 중인 배치 처리
+     */
+    processAllBatches(): Promise<WebhookBatch[]>;
+    /**
+     * 배치 통계 조회
+     */
+    getBatchStats(): {
+        pendingJobsCount: number;
+        activeBatchesCount: number;
+        endpointsWithPendingJobs: number;
+        averageQueueSize: number;
+    };
+    /**
+     * 특정 엔드포인트의 대기 중인 작업 수 조회
+     */
+    getPendingJobCount(endpointId: string): number;
+    /**
+     * 배치 처리기 시작
+     */
+    private startBatchProcessor;
+    /**
+     * 우선순위 기반 작업 삽입
+     */
+    private insertJobByPriority;
+    /**
+     * 배치 생성
+     */
+    private createBatch;
+    /**
+     * 배치 실행
+     */
+    private executeBatch;
+    /**
+     * 개별 작업 실행 (실제로는 WebhookDispatcher 사용)
+     */
+    private executeJob;
+    /**
+     * 실패한 작업들을 다시 큐에 추가
+     */
+    private requeueFailedJobs;
+    /**
+     * 배치 처리기 정지
+     */
+    shutdown(): Promise<void>;
+}

package/dist/dispatcher/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Webhook Dispatcher Components
+ * 웹훅 전송 및 배치 처리 관련 컴포넌트들
+ */
+export { WebhookDispatcher } from "../services/webhook.dispatcher";
+export { BatchDispatcher } from "./batch.dispatcher";
+export { LoadBalancer } from "./load-balancer";
+export { QueueManager } from "./queue.manager";
+export type { BatchConfig, DispatchConfig, LoadBalancerConfig, QueueConfig, } from "./types";

package/dist/dispatcher/load-balancer.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Load Balancer
+ * 웹훅 엔드포인트 간의 부하 분산 관리
+ */
+import { EventEmitter } from "events";
+import type { WebhookEndpoint } from "../types/webhook.types";
+import type { LoadBalancerConfig } from "./types";
+interface EndpointHealth {
+    endpointId: string;
+    isHealthy: boolean;
+    consecutiveFailures: number;
+    lastHealthCheckAt: Date;
+    averageResponseTime: number;
+    activeConnections: number;
+}
+export declare class LoadBalancer extends EventEmitter {
+    private config;
+    private endpointHealth;
+    private circuitBreakers;
+    private connectionCounts;
+    private roundRobinIndex;
+    private healthCheckInterval;
+    private defaultConfig;
+    constructor(config?: Partial<LoadBalancerConfig>);
+    /**
+     * 엔드포인트 등록
+     */
+    registerEndpoint(endpoint: WebhookEndpoint): Promise<void>;
+    /**
+     * 엔드포인트 등록 해제
+     */
+    unregisterEndpoint(endpointId: string): Promise<void>;
+    /**
+     * 로드 밸런싱을 통한 엔드포인트 선택
+     */
+    selectEndpoint(endpoints: WebhookEndpoint[]): Promise<WebhookEndpoint | null>;
+    /**
+     * 요청 완료 시 호출 (연결 수 감소 및 통계 업데이트)
+     */
+    onRequestComplete(endpointId: string, success: boolean, responseTime: number): Promise<void>;
+    /**
+     * 엔드포인트 건강 상태 조회
+     */
+    getEndpointHealth(endpointId: string): EndpointHealth | null;
+    /**
+     * 모든 엔드포인트 건강 상태 조회
+     */
+    getAllEndpointHealth(): EndpointHealth[];
+    /**
+     * 로드 밸런서 통계 조회
+     */
+    getStats(): {
+        totalEndpoints: number;
+        healthyEndpoints: number;
+        activeConnections: number;
+        circuitBreakersOpen: number;
+        averageResponseTime: number;
+    };
+    /**
+     * Round Robin 전략
+     */
+    private selectRoundRobin;
+    /**
+     * Least Connections 전략
+     */
+    private selectLeastConnections;
+    /**
+     * Weighted 전략
+     */
+    private selectWeighted;
+    /**
+     * Random 전략
+     */
+    private selectRandom;
+    /**
+     * Half-open Circuit Breaker 엔드포인트 시도
+     */
+    private tryHalfOpenEndpoint;
+    /**
+     * Circuit Breaker 상태 업데이트
+     */
+    private updateCircuitBreaker;
+    /**
+     * 연결 수 증가
+     */
+    private incrementConnections;
+    /**
+     * 연결 수 감소
+     */
+    private decrementConnections;
+    /**
+     * 엔드포인트 건강 상태 확인
+     */
+    private checkEndpointHealth;
+    /**
+     * 건강 상태 확인 시작
+     */
+    private startHealthChecks;
+    /**
+     * 로드 밸런서 종료
+     */
+    shutdown(): Promise<void>;
+}
+export {};

package/dist/dispatcher/queue.manager.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Queue Manager
+ * 웹훅 작업 큐 관리 시스템
+ */
+import { EventEmitter } from "events";
+import type { DispatchJob, QueueConfig } from "./types";
+export declare class QueueManager extends EventEmitter {
+    private config;
+    private queues;
+    private highPriorityQueue;
+    private mediumPriorityQueue;
+    private lowPriorityQueue;
+    private delayedJobs;
+    private totalJobs;
+    private defaultConfig;
+    constructor(config?: Partial<QueueConfig>);
+    /**
+     * 작업을 큐에 추가
+     */
+    enqueue(job: DispatchJob): Promise<boolean>;
+    /**
+     * 우선순위에 따라 작업 추출
+     */
+    dequeue(): Promise<DispatchJob | null>;
+    /**
+     * 특정 우선순위 큐에서 작업 추출
+     */
+    dequeueFromPriority(priority: number): Promise<DispatchJob | null>;
+    /**
+     * 작업 상태 확인
+     */
+    peek(): DispatchJob | null;
+    /**
+     * 특정 작업 제거
+     */
+    removeJob(jobId: string): Promise<boolean>;
+    /**
+     * 큐 통계 조회
+     */
+    getStats(): {
+        totalJobs: number;
+        highPriorityJobs: number;
+        mediumPriorityJobs: number;
+        lowPriorityJobs: number;
+        delayedJobs: number;
+        queueUtilization: number;
+    };
+    /**
+     * 큐 비우기
+     */
+    clear(): Promise<void>;
+    /**
+     * 만료된 작업 정리
+     */
+    cleanupExpiredJobs(): Promise<number>;
+    /**
+     * 우선순위 숫자를 큐 이름으로 변환
+     */
+    private getQueueName;
+    /**
+     * 지연된 작업 스케줄링
+     */
+    private scheduleDelayedJob;
+    /**
+     * TTL 정리 작업 시작
+     */
+    private startTTLCleanup;
+    /**
+     * 디스크에 큐 상태 저장
+     */
+    private saveToDisk;
+    /**
+     * 디스크에서 큐 상태 로드
+     */
+    private loadFromDisk;
+    /**
+     * 큐 관리자 종료
+     */
+    shutdown(): Promise<void>;
+}

package/dist/dispatcher/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Dispatcher Type Definitions
+ */
+import type { WebhookEndpoint, WebhookEvent } from "../types/webhook.types";
+export interface DispatchConfig {
+    maxConcurrentRequests: number;
+    requestTimeoutMs: number;
+    defaultRetries: number;
+    circuitBreakerThreshold: number;
+    circuitBreakerTimeoutMs: number;
+}
+export interface BatchConfig {
+    maxBatchSize: number;
+    batchTimeoutMs: number;
+    maxConcurrentBatches: number;
+    enablePrioritization: boolean;
+    priorityLevels: number;
+}
+export interface QueueConfig {
+    maxQueueSize: number;
+    persistToDisk: boolean;
+    diskPath?: string;
+    compressionEnabled: boolean;
+    ttlMs: number;
+}
+export interface LoadBalancerConfig {
+    strategy: "round-robin" | "least-connections" | "weighted" | "random";
+    healthCheckInterval: number;
+    healthCheckTimeoutMs: number;
+    weights?: Record<string, number>;
+}
+export interface DispatchJob {
+    id: string;
+    event: WebhookEvent;
+    endpoint: WebhookEndpoint;
+    priority: number;
+    createdAt: Date;
+    scheduledAt: Date;
+    attempts: number;
+    maxAttempts: number;
+    nextRetryAt?: Date;
+}
+export interface CircuitBreakerState {
+    endpointId: string;
+    state: "closed" | "open" | "half-open";
+    failureCount: number;
+    lastFailureTime?: Date;
+    nextRetryTime?: Date;
+}