@k-msg/webhook 0.5.0 → 0.7.0

package/dist/security/security.manager.d.ts

@@ -10,15 +10,29 @@ export interface SecurityConfig {
  */
 export declare class SecurityManager {
     private config;
-    constructor(webhookConfig: WebhookConfig);
+    constructor(webhookConfig: Pick<WebhookConfig, "algorithm" | "signatureHeader" | "signaturePrefix">);
+    /**
+     * Canonical string to sign when a timestamp header is present.
+     * Format: `${timestamp}.${payload}`
+     */
+    createSignedPayload(payload: string, timestamp: string): string;
     /**
      * Webhook 페이로드에 대한 서명 생성
      */
     generateSignature(payload: string, secret: string): string;
+    /**
+     * Generate signature for a timestamped webhook.
+     * (Recommended when also validating `X-Webhook-Timestamp` to prevent replay.)
+     */
+    generateSignatureWithTimestamp(payload: string, timestamp: string, secret: string): string;
     /**
      * Webhook 서명 검증
      */
     verifySignature(payload: string, signature: string, secret: string): boolean;
+    /**
+     * Verify signature for a timestamped webhook.
+     */
+    verifySignatureWithTimestamp(payload: string, timestamp: string, signature: string, secret: string): boolean;
     /**
      * HTTP 헤더에서 서명 추출
      */

package/dist/services/webhook.dispatcher.d.ts

@@ -13,12 +13,14 @@ export declare class MockHttpClient implements HttpClient {
 export declare class WebhookDispatcher {
     private config;
     private httpClient;
+    private securityManager;
+    private retryManager;
     constructor(config: WebhookConfig, httpClient?: HttpClient);
     dispatch(event: WebhookEvent, endpoint: WebhookEndpoint): Promise<WebhookDelivery>;
     private executeDelivery;
+    private shouldRetryAttempt;
     private makeHttpRequest;
     private buildHeaders;
-    private generateSignature;
     private calculateRetryDelay;
     private sleep;
     private generateDeliveryId;

package/dist/services/webhook.service.d.ts

@@ -5,8 +5,6 @@ export declare class WebhookService {
     private config;
     private dispatcher;
     private registry;
-    private securityManager;
-    private retryManager;
     private eventQueue;
     private batchProcessor;
     constructor(config: WebhookConfig, httpClient?: HttpClient);

package/dist/types/webhook.types.d.ts

@@ -82,6 +82,11 @@ export interface WebhookDelivery {
     id: string;
     endpointId: string;
     eventId: string;
+    /**
+     * Optional event type for filtering/stats.
+     * (Helpful because `payload` is a JSON string and timestamps need revival when parsed.)
+     */
+    eventType?: WebhookEventType;
     url: string;
     httpMethod: "POST" | "PUT" | "PATCH";
     headers: Record<string, string>;
@@ -140,7 +145,7 @@ export interface WebhookTestResult {
 export declare const WebhookEventSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodString;
-    timestamp: z.ZodDate;
+    timestamp: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDate>;
     data: z.ZodAny;
     metadata: z.ZodObject<{
         providerId: z.ZodOptional<z.ZodString>;
@@ -187,6 +192,7 @@ export declare const WebhookDeliverySchema: z.ZodObject<{
     id: z.ZodString;
     endpointId: z.ZodString;
     eventId: z.ZodString;
+    eventType: z.ZodOptional<z.ZodString>;
     url: z.ZodString;
     httpMethod: z.ZodEnum<{
         POST: "POST";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k-msg/webhook",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "packageManager": "bun@1.3.8",
   "description": "Webhook system for real-time message event notifications",
   "type": "module",
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "zod": "^4.0.14",
-    "@k-msg/messaging": "0.5.0"
+    "@k-msg/messaging": "0.7.0"
   },
   "devDependencies": {
     "typescript": "^5.7.2",
@@ -47,7 +47,8 @@
   ],
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "README_ko.md"
   ],
   "repository": {
     "type": "git",