ts-workflow-engine-lite 2.1.0

package/dist/src/api/ErrorHandler.d.ts

@@ -0,0 +1,52 @@
+import type { NextFunction, Request, Response } from "express";
+export declare enum ErrorCode {
+    UNKNOWN_ERROR = 100,
+    INTERNAL_SERVER_ERROR = 101,
+    CONFIGURATION_ERROR = 102,
+    SERVICE_UNAVAILABLE = 103,
+    WORKFLOW_NOT_FOUND = 201,
+    INVALID_WORKFLOW_DEFINITION = 202,
+    WORKFLOW_EXECUTION_ERROR = 203,
+    WORKFLOW_TIMEOUT = 204,
+    INSTANCE_NOT_FOUND = 205,
+    INVALID_STATE_TRANSITION = 206,
+    INVALID_REQUEST = 301,
+    INVALID_PARAMETERS = 302,
+    MISSING_REQUIRED_PARAMETER = 303,
+    RESOURCE_NOT_FOUND = 304,
+    METHOD_NOT_ALLOWED = 305,
+    RATE_LIMIT_EXCEEDED = 306,
+    STORAGE_ERROR = 401,
+    DATA_NOT_FOUND = 402,
+    DATABASE_CONNECTION_ERROR = 403,
+    SERIALIZATION_ERROR = 404,
+    WEBHOOK_REGISTRATION_FAILED = 501,
+    WEBHOOK_DELIVERY_FAILED = 502,
+    WEBHOOK_NOT_FOUND = 503,
+    WEBHOOK_VALIDATION_FAILED = 504
+}
+export declare class ApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode: ErrorCode;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, statusCode?: number, errorCode?: ErrorCode, context?: Record<string, unknown>);
+    toResponse(): import("./response.js").StandardErrorResponse;
+    static badRequest(message: string, errorCode?: ErrorCode, context?: Record<string, unknown>): ApiError;
+    static notFound(message: string, errorCode?: ErrorCode, context?: Record<string, unknown>): ApiError;
+    static unauthorized(message?: string, context?: Record<string, unknown>): ApiError;
+    static serverError(message?: string, errorCode?: ErrorCode, context?: Record<string, unknown>): ApiError;
+}
+export declare function errorHandler(err: Error | ApiError, req: Request, res: Response, _next: NextFunction): void;
+export declare function asyncHandler(fn: (req: Request, res: Response, next: NextFunction) => Promise<unknown>): (req: Request, res: Response, next: NextFunction) => void;
+interface RequestSchemaValidationError {
+    details: Array<{
+        message: string;
+    }>;
+}
+interface RequestSchema {
+    validate(value: unknown): {
+        error?: RequestSchemaValidationError;
+    };
+}
+export declare function validateRequest(schema: RequestSchema): (req: Request, _res: Response, next: NextFunction) => void;
+export {};

package/dist/src/api/ErrorHandler.js

@@ -0,0 +1,115 @@
+import { Logger } from "../utils/Logger.js";
+import { createErrorResponse } from "./response.js";
+import { ServiceError } from "./services/WorkflowApplicationService.js";
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode[ErrorCode["UNKNOWN_ERROR"] = 100] = "UNKNOWN_ERROR";
+    ErrorCode[ErrorCode["INTERNAL_SERVER_ERROR"] = 101] = "INTERNAL_SERVER_ERROR";
+    ErrorCode[ErrorCode["CONFIGURATION_ERROR"] = 102] = "CONFIGURATION_ERROR";
+    ErrorCode[ErrorCode["SERVICE_UNAVAILABLE"] = 103] = "SERVICE_UNAVAILABLE";
+    ErrorCode[ErrorCode["WORKFLOW_NOT_FOUND"] = 201] = "WORKFLOW_NOT_FOUND";
+    ErrorCode[ErrorCode["INVALID_WORKFLOW_DEFINITION"] = 202] = "INVALID_WORKFLOW_DEFINITION";
+    ErrorCode[ErrorCode["WORKFLOW_EXECUTION_ERROR"] = 203] = "WORKFLOW_EXECUTION_ERROR";
+    ErrorCode[ErrorCode["WORKFLOW_TIMEOUT"] = 204] = "WORKFLOW_TIMEOUT";
+    ErrorCode[ErrorCode["INSTANCE_NOT_FOUND"] = 205] = "INSTANCE_NOT_FOUND";
+    ErrorCode[ErrorCode["INVALID_STATE_TRANSITION"] = 206] = "INVALID_STATE_TRANSITION";
+    ErrorCode[ErrorCode["INVALID_REQUEST"] = 301] = "INVALID_REQUEST";
+    ErrorCode[ErrorCode["INVALID_PARAMETERS"] = 302] = "INVALID_PARAMETERS";
+    ErrorCode[ErrorCode["MISSING_REQUIRED_PARAMETER"] = 303] = "MISSING_REQUIRED_PARAMETER";
+    ErrorCode[ErrorCode["RESOURCE_NOT_FOUND"] = 304] = "RESOURCE_NOT_FOUND";
+    ErrorCode[ErrorCode["METHOD_NOT_ALLOWED"] = 305] = "METHOD_NOT_ALLOWED";
+    ErrorCode[ErrorCode["RATE_LIMIT_EXCEEDED"] = 306] = "RATE_LIMIT_EXCEEDED";
+    ErrorCode[ErrorCode["STORAGE_ERROR"] = 401] = "STORAGE_ERROR";
+    ErrorCode[ErrorCode["DATA_NOT_FOUND"] = 402] = "DATA_NOT_FOUND";
+    ErrorCode[ErrorCode["DATABASE_CONNECTION_ERROR"] = 403] = "DATABASE_CONNECTION_ERROR";
+    ErrorCode[ErrorCode["SERIALIZATION_ERROR"] = 404] = "SERIALIZATION_ERROR";
+    ErrorCode[ErrorCode["WEBHOOK_REGISTRATION_FAILED"] = 501] = "WEBHOOK_REGISTRATION_FAILED";
+    ErrorCode[ErrorCode["WEBHOOK_DELIVERY_FAILED"] = 502] = "WEBHOOK_DELIVERY_FAILED";
+    ErrorCode[ErrorCode["WEBHOOK_NOT_FOUND"] = 503] = "WEBHOOK_NOT_FOUND";
+    ErrorCode[ErrorCode["WEBHOOK_VALIDATION_FAILED"] = 504] = "WEBHOOK_VALIDATION_FAILED";
+})(ErrorCode || (ErrorCode = {}));
+export class ApiError extends Error {
+    statusCode;
+    errorCode;
+    context;
+    constructor(message, statusCode = 500, errorCode = ErrorCode.UNKNOWN_ERROR, context) {
+        super(message);
+        this.name = this.constructor.name;
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.context = context;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toResponse() {
+        return createErrorResponse(this.errorCode, this.message, {
+            code: this.errorCode,
+            message: this.message,
+            ...(this.context ? { context: this.context } : {}),
+        });
+    }
+    static badRequest(message, errorCode = ErrorCode.INVALID_REQUEST, context) {
+        return new ApiError(message, 400, errorCode, context);
+    }
+    static notFound(message, errorCode = ErrorCode.RESOURCE_NOT_FOUND, context) {
+        return new ApiError(message, 404, errorCode, context);
+    }
+    static unauthorized(message = "未授权访问", context) {
+        return new ApiError(message, 401, ErrorCode.INVALID_REQUEST, context);
+    }
+    static serverError(message = "服务器内部错误", errorCode = ErrorCode.INTERNAL_SERVER_ERROR, context) {
+        return new ApiError(message, 500, errorCode, context);
+    }
+}
+export function errorHandler(err, req, res, _next) {
+    const isApiError = err instanceof ApiError;
+    const isServiceError = err instanceof ServiceError;
+    const statusCode = isApiError
+        ? err.statusCode
+        : isServiceError
+            ? err.statusCode
+            : 500;
+    const errorCode = isApiError
+        ? err.errorCode
+        : isServiceError
+            ? err.code
+            : ErrorCode.UNKNOWN_ERROR;
+    const message = isApiError || isServiceError
+        ? err.message
+        : process.env.NODE_ENV === "production"
+            ? "服务器内部错误"
+            : err.message || "未知错误";
+    const logLevel = statusCode >= 500 ? "error" : "warn";
+    Logger[logLevel]("api", "error", `[${req.method}] ${req.path} - ${statusCode} - Code: ${errorCode} - ${message}`);
+    if (statusCode >= 500) {
+        Logger.error("api", "stack", err.stack || "无堆栈信息");
+    }
+    res.status(statusCode).json(createErrorResponse(errorCode, message, {
+        code: errorCode,
+        message,
+        path: req.path,
+        ...(isApiError && err.context ? { context: err.context } : {}),
+        ...(isServiceError && err.details !== undefined
+            ? { details: err.details }
+            : {}),
+    }));
+}
+export function asyncHandler(fn) {
+    return (req, res, next) => {
+        Promise.resolve(fn(req, res, next)).catch(next);
+    };
+}
+export function validateRequest(schema) {
+    return (req, _res, next) => {
+        try {
+            const { error } = schema.validate(req.body);
+            if (error) {
+                throw ApiError.badRequest(`请求数据验证失败: ${error.details.map((x) => x.message).join(", ")}`, ErrorCode.INVALID_PARAMETERS);
+            }
+            next();
+        }
+        catch (err) {
+            next(err);
+        }
+    };
+}
+//# sourceMappingURL=ErrorHandler.js.map

package/dist/src/api/ErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../../../src/api/ErrorHandler.ts"],"names":[],"mappings":"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"}

package/dist/src/api/EventHistory.d.ts

@@ -0,0 +1,73 @@
+import type { StorageProvider } from "../storage/StorageProvider.js";
+export interface EventRecord {
+    id: string;
+    event: string;
+    data: any;
+    timestamp: Date;
+    instanceId?: string;
+    webhookDeliveries?: {
+        webhookId: string;
+        status: "success" | "failed";
+        statusCode?: number;
+        responseTime?: number;
+        errorMessage?: string;
+    }[];
+    source: "api" | "system" | "webhook";
+}
+export interface EventQueryParams {
+    instanceId?: string;
+    eventType?: string;
+    startTime?: number;
+    endTime?: number;
+    page?: number;
+    pageSize?: number;
+    sortBy?: "timestamp" | "eventType";
+    sortOrder?: "asc" | "desc";
+}
+export interface PaginationMetadata {
+    page: number;
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+}
+export interface EventQueryResponse {
+    events: EventRecord[];
+    pagination: PaginationMetadata;
+}
+export interface EventAggregateParams {
+    groupBy: "eventType" | "instanceId" | "workflowId";
+    startTime?: number;
+    endTime?: number;
+}
+export interface EventAggregateGroup {
+    key: string;
+    count: number;
+    firstSeen: number;
+    lastSeen: number;
+}
+export interface EventAggregateResponse {
+    groups: EventAggregateGroup[];
+}
+export declare class EventHistoryManager {
+    private storage;
+    private readonly MAX_EVENTS;
+    private readonly FETCH_ALL_PAGE_SIZE;
+    private readonly TRIM_INTERVAL;
+    private writesSinceTrim;
+    constructor(storage?: StorageProvider);
+    private toStorageRecord;
+    private fromStorageRecord;
+    recordEvent(event: string, data: any, source?: "api" | "system" | "webhook", instanceId?: string): Promise<string>;
+    recordWebhookDelivery(eventId: string, webhookId: string, status: "success" | "failed", details?: {
+        statusCode?: number;
+        responseTime?: number;
+        errorMessage?: string;
+    }): Promise<void>;
+    getEvents(limit?: number, offset?: number): Promise<EventRecord[]>;
+    getEventsByType(eventType: string, limit?: number, offset?: number): Promise<EventRecord[]>;
+    getEventsByInstance(instanceId: string, limit?: number, offset?: number): Promise<EventRecord[]>;
+    getEvent(id: string): Promise<EventRecord | null>;
+    queryEvents(params: EventQueryParams): Promise<EventQueryResponse>;
+    aggregateEvents(params: EventAggregateParams): Promise<EventAggregateResponse>;
+    private trimEventHistory;
+}

package/dist/src/api/EventHistory.js

@@ -0,0 +1,309 @@
+import { v4 as uuidv4 } from "uuid";
+import { Logger } from "../utils/Logger.js";
+export class EventHistoryManager {
+    storage = null;
+    MAX_EVENTS = 1000;
+    FETCH_ALL_PAGE_SIZE = 10_000;
+    TRIM_INTERVAL = 100;
+    writesSinceTrim = 0;
+    constructor(storage) {
+        if (storage) {
+            this.storage = storage;
+        }
+    }
+    toStorageRecord(record) {
+        return {
+            id: record.id,
+            instanceId: record.instanceId ?? "",
+            workflowId: "",
+            eventType: record.event,
+            payload: record.data,
+            timestamp: record.timestamp.getTime(),
+            metadata: {
+                source: record.source,
+                webhookDeliveries: record.webhookDeliveries,
+            },
+        };
+    }
+    fromStorageRecord(stored) {
+        return {
+            id: stored.id,
+            event: stored.eventType,
+            data: stored.payload,
+            timestamp: new Date(stored.timestamp),
+            instanceId: stored.instanceId || undefined,
+            source: stored.metadata?.source ??
+                "system",
+            webhookDeliveries: stored.metadata?.webhookDeliveries,
+        };
+    }
+    async recordEvent(event, data, source = "system", instanceId) {
+        const id = uuidv4();
+        const timestamp = new Date();
+        const eventRecord = {
+            id,
+            event,
+            data,
+            timestamp,
+            instanceId,
+            source,
+        };
+        Logger.debug("event-history", "record", `Recording event ${event} with ID ${id}`);
+        if (this.storage) {
+            try {
+                await this.storage.saveEvent(this.toStorageRecord(eventRecord));
+                await this.trimEventHistory();
+            }
+            catch (error) {
+                Logger.error("event-history", "storage", `Failed to save event record: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return id;
+    }
+    async recordWebhookDelivery(eventId, webhookId, status, details = {}) {
+        if (!this.storage)
+            return;
+        try {
+            const stored = await this.storage.loadEvent(eventId);
+            if (!stored) {
+                Logger.warn("event-history", "webhook", `Event ${eventId} not found for webhook delivery recording`);
+                return;
+            }
+            const record = this.fromStorageRecord(stored);
+            record.webhookDeliveries ??= [];
+            record.webhookDeliveries.push({
+                webhookId,
+                status,
+                statusCode: details.statusCode,
+                responseTime: details.responseTime,
+                errorMessage: details.errorMessage,
+            });
+            await this.storage.saveEvent(this.toStorageRecord(record));
+        }
+        catch (error) {
+            Logger.error("event-history", "webhook", `Failed to record webhook delivery: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async getEvents(limit = 20, offset = 0) {
+        if (!this.storage)
+            return [];
+        try {
+            const { events } = await this.storage.queryEvents({
+                page: 1,
+                pageSize: this.FETCH_ALL_PAGE_SIZE,
+            });
+            return events
+                .slice()
+                .sort((a, b) => b.timestamp - a.timestamp)
+                .slice(offset, offset + limit)
+                .map((e) => this.fromStorageRecord(e));
+        }
+        catch (error) {
+            Logger.error("event-history", "query", `Failed to get events: ${error instanceof Error ? error.message : String(error)}`);
+            return [];
+        }
+    }
+    async getEventsByType(eventType, limit = 20, offset = 0) {
+        if (!this.storage)
+            return [];
+        try {
+            const { events } = await this.storage.queryEvents({
+                eventType,
+                page: 1,
+                pageSize: this.FETCH_ALL_PAGE_SIZE,
+            });
+            return events
+                .slice()
+                .sort((a, b) => b.timestamp - a.timestamp)
+                .slice(offset, offset + limit)
+                .map((e) => this.fromStorageRecord(e));
+        }
+        catch (error) {
+            Logger.error("event-history", "query", `Failed to get events by type: ${error instanceof Error ? error.message : String(error)}`);
+            return [];
+        }
+    }
+    async getEventsByInstance(instanceId, limit = 20, offset = 0) {
+        if (!this.storage)
+            return [];
+        try {
+            const { events } = await this.storage.queryEvents({
+                instanceId,
+                page: 1,
+                pageSize: this.FETCH_ALL_PAGE_SIZE,
+            });
+            return events
+                .slice()
+                .sort((a, b) => b.timestamp - a.timestamp)
+                .slice(offset, offset + limit)
+                .map((e) => this.fromStorageRecord(e));
+        }
+        catch (error) {
+            Logger.error("event-history", "query", `Failed to get events by instance: ${error instanceof Error ? error.message : String(error)}`);
+            return [];
+        }
+    }
+    async getEvent(id) {
+        if (!this.storage)
+            return null;
+        try {
+            const stored = await this.storage.loadEvent(id);
+            return stored ? this.fromStorageRecord(stored) : null;
+        }
+        catch (error) {
+            Logger.error("event-history", "query", `Failed to get event ${id}: ${error instanceof Error ? error.message : String(error)}`);
+            return null;
+        }
+    }
+    async queryEvents(params) {
+        if (!this.storage) {
+            return {
+                events: [],
+                pagination: {
+                    page: params.page ?? 1,
+                    pageSize: params.pageSize ?? 20,
+                    totalCount: 0,
+                    totalPages: 0,
+                },
+            };
+        }
+        try {
+            const page = params.page ?? 1;
+            const pageSize = Math.min(params.pageSize ?? 20, 1000);
+            const sortOrder = params.sortOrder ?? "desc";
+            let endTime = params.endTime;
+            if (params.startTime && endTime) {
+                const rangeMs = endTime - params.startTime;
+                const maxRangeMs = 30 * 24 * 60 * 60 * 1000;
+                if (rangeMs > maxRangeMs) {
+                    Logger.warn("event-history", "query", `Time range ${Math.round(rangeMs / (24 * 60 * 60 * 1000))} days exceeds max 30 days, clamping`);
+                    endTime = params.startTime + maxRangeMs;
+                }
+            }
+            const { events: stored } = await this.storage.queryEvents({
+                instanceId: params.instanceId,
+                eventType: params.eventType,
+                startTime: params.startTime,
+                endTime,
+                page: 1,
+                pageSize: this.FETCH_ALL_PAGE_SIZE,
+            });
+            const sorted = stored
+                .slice()
+                .sort((a, b) => sortOrder === "desc"
+                ? b.timestamp - a.timestamp
+                : a.timestamp - b.timestamp);
+            const totalCount = sorted.length;
+            const totalPages = Math.ceil(totalCount / pageSize);
+            const start = (page - 1) * pageSize;
+            const end = start + pageSize;
+            const events = sorted
+                .slice(start, end)
+                .map((e) => this.fromStorageRecord(e));
+            return {
+                events,
+                pagination: {
+                    page,
+                    pageSize,
+                    totalCount,
+                    totalPages,
+                },
+            };
+        }
+        catch (error) {
+            Logger.error("event-history", "query", `Failed to query events: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                events: [],
+                pagination: {
+                    page: params.page ?? 1,
+                    pageSize: params.pageSize ?? 20,
+                    totalCount: 0,
+                    totalPages: 0,
+                },
+            };
+        }
+    }
+    async aggregateEvents(params) {
+        if (!this.storage) {
+            return { groups: [] };
+        }
+        try {
+            const { events: stored } = await this.storage.queryEvents({
+                startTime: params.startTime,
+                endTime: params.endTime,
+                page: 1,
+                pageSize: this.FETCH_ALL_PAGE_SIZE,
+            });
+            const groups = new Map();
+            for (const record of stored) {
+                let key;
+                if (params.groupBy === "eventType") {
+                    key = record.eventType;
+                }
+                else if (params.groupBy === "instanceId") {
+                    key = record.instanceId || "unknown";
+                }
+                else {
+                    key = record.workflowId || "unknown";
+                }
+                const existing = groups.get(key);
+                if (existing) {
+                    existing.count++;
+                    existing.firstSeen = Math.min(existing.firstSeen, record.timestamp);
+                    existing.lastSeen = Math.max(existing.lastSeen, record.timestamp);
+                }
+                else {
+                    groups.set(key, {
+                        count: 1,
+                        firstSeen: record.timestamp,
+                        lastSeen: record.timestamp,
+                    });
+                }
+            }
+            const result = [];
+            for (const [key, value] of groups.entries()) {
+                result.push({
+                    key,
+                    count: value.count,
+                    firstSeen: value.firstSeen,
+                    lastSeen: value.lastSeen,
+                });
+            }
+            result.sort((a, b) => b.count - a.count);
+            return { groups: result };
+        }
+        catch (error) {
+            Logger.error("event-history", "aggregate", `Failed to aggregate events: ${error instanceof Error ? error.message : String(error)}`);
+            return { groups: [] };
+        }
+    }
+    async trimEventHistory() {
+        if (!this.storage)
+            return;
+        this.writesSinceTrim++;
+        if (this.writesSinceTrim < this.TRIM_INTERVAL)
+            return;
+        this.writesSinceTrim = 0;
+        try {
+            const { events: stored, total } = await this.storage.queryEvents({
+                page: 1,
+                pageSize: this.FETCH_ALL_PAGE_SIZE,
+            });
+            if (total > this.MAX_EVENTS) {
+                const toRemoveCount = total - this.MAX_EVENTS;
+                const oldest = stored
+                    .slice()
+                    .sort((a, b) => a.timestamp - b.timestamp)
+                    .slice(0, toRemoveCount);
+                for (const event of oldest) {
+                    await this.storage.deleteEvent(event.id);
+                }
+                Logger.debug("event-history", "cleanup", `Removed ${oldest.length} old events to maintain history limit`);
+            }
+        }
+        catch (error) {
+            Logger.error("event-history", "cleanup", `Failed to trim event history: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=EventHistory.js.map

package/dist/src/api/EventHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventHistory.js","sourceRoot":"","sources":["../../../src/api/EventHistory.ts"],"names":[],"mappings":"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"}

package/dist/src/api/WebhookManager.d.ts

@@ -0,0 +1,67 @@
+import type { HookPayload } from "../event/HookManager.js";
+import type { StorageProvider } from "../storage/StorageProvider.js";
+import type { Webhook, WebhookDelivery, WebhookDeliveryCleanupStatus } from "./types.js";
+interface DeliveryQuery {
+    webhookId?: string;
+    event?: string;
+    workflowId?: string;
+    instanceId?: string;
+    status?: WebhookDelivery["status"];
+    limit?: number;
+    offset?: number;
+}
+export declare class WebhookManager {
+    private webhooks;
+    private deliveries;
+    private deliveryTimers;
+    private cleanupTimer;
+    private cleanupInProgress;
+    private storage;
+    private eventHistory;
+    private lastCleanupStatus;
+    private readonly MAX_DELIVERY_ATTEMPTS;
+    private readonly REQUEST_TIMEOUT_MS;
+    private readonly MAX_RETRY_DELAY_MS;
+    private readonly DELIVERY_RETENTION_DAYS;
+    private readonly CLEANUP_INTERVAL_MS;
+    private readonly CLEANUP_LEADER_ONLY;
+    constructor(storage?: StorageProvider);
+    private loadStateFromStorage;
+    private loadWebhooksFromStorage;
+    private normalizeDelivery;
+    private loadDeliveriesFromStorage;
+    private resumePendingDeliveries;
+    private saveWebhookToStorage;
+    private removeWebhookFromStorage;
+    private saveDelivery;
+    private isTerminalDeliveryStatus;
+    private deleteDelivery;
+    cleanupExpiredDeliveries(): Promise<number>;
+    getCleanupStatus(): WebhookDeliveryCleanupStatus;
+    startCleanupScheduler(): void;
+    stopCleanupScheduler(): void;
+    private runScheduledCleanup;
+    private shouldSkipCleanupOnFollower;
+    createWebhook(webhookData: Omit<Webhook, "id" | "createdAt" | "updatedAt" | "isActive">): Promise<Webhook>;
+    updateWebhook(id: string, data: Partial<Webhook>): Promise<Webhook | null>;
+    deleteWebhook(id: string): Promise<boolean>;
+    getAllWebhooks(): Webhook[];
+    getWebhook(id: string): Webhook | undefined;
+    listDeliveries(query?: DeliveryQuery): {
+        deliveries: WebhookDelivery[];
+        total: number;
+    };
+    getDelivery(id: string): WebhookDelivery | undefined;
+    retryDelivery(id: string): Promise<WebhookDelivery>;
+    retryDeliveries(query?: Omit<DeliveryQuery, "limit" | "offset">): Promise<WebhookDelivery[]>;
+    triggerEvent(event: string, data: Record<string, unknown>): Promise<void>;
+    triggerHook(payload: HookPayload, source?: "api" | "system" | "webhook"): Promise<void>;
+    private enqueueDelivery;
+    private scheduleDelivery;
+    private computeRetryDelay;
+    private processDelivery;
+    private createSignature;
+    testWebhook(id: string): Promise<boolean>;
+    destroy(): void;
+}
+export {};