convex-cms 0.0.1

package/dist/component/webhookTrigger.d.ts

@@ -0,0 +1,770 @@
+/**
+ * Webhook Trigger Module
+ *
+ * Scheduled function to process content events and trigger configured webhooks.
+ * Supports retry logic with exponential backoff and delivery confirmation.
+ *
+ * Architecture:
+ * 1. Events are captured via the event emitter system (cmsEvents table)
+ * 2. A background processor polls for unprocessed events
+ * 3. For each event, matching webhook configurations are found
+ * 4. Delivery records are created and HTTP requests are dispatched
+ * 5. Success/failure is tracked with automatic retry for failures
+ *
+ * Security Features:
+ * - HMAC-SHA256 signature generation for payload verification
+ * - Configurable timeout to prevent hanging requests
+ * - Secret keys never exposed in API responses
+ *
+ * Retry Behavior:
+ * - Exponential backoff: 1min, 5min, 15min, 1hr, 4hr (configurable)
+ * - Automatic retry scheduling via Convex scheduler
+ * - Maximum retry limit per webhook configuration
+ *
+ * @module
+ */
+/**
+ * Webhook delivery status.
+ */
+export type WebhookDeliveryStatus = "pending" | "processing" | "delivered" | "failed" | "retrying";
+/**
+ * Configuration for the webhook processor.
+ */
+export interface WebhookProcessorConfig {
+    /**
+     * Maximum number of events to process in a single batch.
+     * @default 50
+     */
+    batchSize?: number;
+    /**
+     * Interval in milliseconds for the background polling job.
+     * @default 60000 (1 minute)
+     */
+    pollingIntervalMs?: number;
+    /**
+     * Default timeout for webhook requests in milliseconds.
+     * @default 30000 (30 seconds)
+     */
+    defaultTimeoutMs?: number;
+    /**
+     * Default maximum retry attempts.
+     * @default 5
+     */
+    defaultMaxRetries?: number;
+}
+/**
+ * Result of processing webhook events.
+ */
+export interface ProcessWebhooksResult {
+    /** Number of events processed */
+    eventsProcessed: number;
+    /** Number of deliveries queued */
+    deliveriesQueued: number;
+    /** Number of deliveries sent successfully */
+    deliveriesSucceeded: number;
+    /** Number of deliveries that failed (will retry or exhausted) */
+    deliveriesFailed: number;
+    /** Whether there are more events to process */
+    hasMore: boolean;
+    /** Errors encountered */
+    errors: Array<{
+        webhookId: string;
+        eventId: string;
+        error: string;
+    }>;
+}
+/**
+ * Webhook payload structure sent to endpoints.
+ */
+export interface WebhookPayload {
+    /** Unique delivery ID for idempotency */
+    deliveryId: string;
+    /** Event type (e.g., "contentEntry.published") */
+    eventType: string;
+    /** Resource type that triggered the event */
+    resourceType: string;
+    /** ID of the affected resource */
+    resourceId: string;
+    /** Action performed on the resource */
+    action: string;
+    /** Event-specific payload data */
+    data: unknown;
+    /** ISO timestamp when the event occurred */
+    timestamp: string;
+    /** User who triggered the event (if known) */
+    userId?: string;
+}
+/**
+ * Statistics about webhook deliveries.
+ */
+export interface WebhookStats {
+    /** Total webhooks configured */
+    totalWebhooks: number;
+    /** Active webhooks */
+    activeWebhooks: number;
+    /** Pending deliveries */
+    pendingDeliveries: number;
+    /** Deliveries awaiting retry */
+    retryingDeliveries: number;
+    /** Deliveries in the last 24 hours */
+    deliveriesLast24h: number;
+    /** Success rate in the last 24 hours */
+    successRateLast24h: number;
+}
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_WEBHOOK_CONFIG: {
+    batchSize: number;
+    pollingIntervalMs: number;
+    defaultTimeoutMs: number;
+    defaultMaxRetries: number;
+};
+/**
+ * Exponential backoff delays in milliseconds.
+ * Attempt 1: 1 minute
+ * Attempt 2: 5 minutes
+ * Attempt 3: 15 minutes
+ * Attempt 4: 1 hour
+ * Attempt 5: 4 hours
+ */
+export declare const RETRY_DELAYS_MS: number[];
+/**
+ * Validator for webhook delivery status.
+ */
+export declare const webhookDeliveryStatusValidator: import("convex/values").VUnion<"pending" | "processing" | "failed" | "delivered" | "retrying", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"processing", "required">, import("convex/values").VLiteral<"delivered", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"retrying", "required">], "required", never>;
+/**
+ * Validator for creating a webhook configuration.
+ */
+export declare const createWebhookArgs: import("convex/values").VObject<{
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    createdBy?: string | undefined;
+    secret?: string | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    enabled?: boolean | undefined;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    name: string;
+    url: string;
+    eventTypes: string[];
+}, {
+    /** Human-readable name for the webhook */
+    name: import("convex/values").VString<string, "required">;
+    /** Optional description */
+    description: import("convex/values").VString<string | undefined, "optional">;
+    /** Target URL (must be HTTPS in production) */
+    url: import("convex/values").VString<string, "required">;
+    /** Secret for HMAC signature (optional but recommended) */
+    secret: import("convex/values").VString<string | undefined, "optional">;
+    /** Event types to subscribe to (e.g., ["contentEntry.published"]) */
+    eventTypes: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    /** Filter by resource types (optional) */
+    resourceTypes: import("convex/values").VArray<("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined, import("convex/values").VUnion<"contentEntry" | "contentType" | "mediaAsset" | "mediaFolder", [import("convex/values").VLiteral<"contentEntry", "required">, import("convex/values").VLiteral<"contentType", "required">, import("convex/values").VLiteral<"mediaAsset", "required">, import("convex/values").VLiteral<"mediaFolder", "required">], "required", never>, "optional">;
+    /** Filter by content types (optional, for contentEntry events) */
+    contentTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    /** Additional HTTP headers */
+    headers: import("convex/values").VAny<any, "optional", string>;
+    /** Whether the webhook is enabled (default: true) */
+    enabled: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    /** Maximum retry attempts (default: 5) */
+    maxRetries: import("convex/values").VFloat64<number | undefined, "optional">;
+    /** Request timeout in ms (default: 30000) */
+    timeoutMs: import("convex/values").VFloat64<number | undefined, "optional">;
+    /** User creating the webhook */
+    createdBy: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "name" | "description" | "contentTypes" | "createdBy" | "url" | "secret" | "eventTypes" | "resourceTypes" | "headers" | "enabled" | "maxRetries" | "timeoutMs" | `headers.${string}`>;
+/**
+ * Validator for updating a webhook configuration.
+ */
+export declare const updateWebhookArgs: import("convex/values").VObject<{
+    name?: string | undefined;
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    updatedBy?: string | undefined;
+    url?: string | undefined;
+    secret?: string | undefined;
+    eventTypes?: string[] | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    enabled?: boolean | undefined;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    id: import("convex/values").GenericId<"webhookConfigs">;
+}, {
+    /** Webhook ID to update */
+    id: import("convex/values").VId<import("convex/values").GenericId<"webhookConfigs">, "required">;
+    /** New name */
+    name: import("convex/values").VString<string | undefined, "optional">;
+    /** New description */
+    description: import("convex/values").VString<string | undefined, "optional">;
+    /** New URL */
+    url: import("convex/values").VString<string | undefined, "optional">;
+    /** New secret (set to empty string to remove) */
+    secret: import("convex/values").VString<string | undefined, "optional">;
+    /** New event types filter */
+    eventTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    /** New resource types filter */
+    resourceTypes: import("convex/values").VArray<("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined, import("convex/values").VUnion<"contentEntry" | "contentType" | "mediaAsset" | "mediaFolder", [import("convex/values").VLiteral<"contentEntry", "required">, import("convex/values").VLiteral<"contentType", "required">, import("convex/values").VLiteral<"mediaAsset", "required">, import("convex/values").VLiteral<"mediaFolder", "required">], "required", never>, "optional">;
+    /** New content types filter */
+    contentTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    /** New headers */
+    headers: import("convex/values").VAny<any, "optional", string>;
+    /** Enable/disable the webhook */
+    enabled: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    /** New max retries */
+    maxRetries: import("convex/values").VFloat64<number | undefined, "optional">;
+    /** New timeout */
+    timeoutMs: import("convex/values").VFloat64<number | undefined, "optional">;
+    /** User performing the update */
+    updatedBy: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "id" | "name" | "description" | "contentTypes" | "updatedBy" | "url" | "secret" | "eventTypes" | "resourceTypes" | "headers" | "enabled" | "maxRetries" | "timeoutMs" | `headers.${string}`>;
+/**
+ * Validator for deleting a webhook configuration.
+ */
+export declare const deleteWebhookArgs: import("convex/values").VObject<{
+    hardDelete?: boolean | undefined;
+    deletedBy?: string | undefined;
+    id: import("convex/values").GenericId<"webhookConfigs">;
+}, {
+    /** Webhook ID to delete */
+    id: import("convex/values").VId<import("convex/values").GenericId<"webhookConfigs">, "required">;
+    /** Hard delete (true) or soft delete (false, default) */
+    hardDelete: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    /** User performing the deletion */
+    deletedBy: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "id" | "hardDelete" | "deletedBy">;
+/**
+ * Validator for webhook configuration document (return type).
+ */
+export declare const webhookConfigDoc: import("convex/values").VObject<{
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    deletedAt?: number | undefined;
+    createdBy?: string | undefined;
+    updatedBy?: string | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    name: string;
+    _creationTime: number;
+    url: string;
+    eventTypes: string[];
+    enabled: boolean;
+    _id: import("convex/values").GenericId<"webhookConfigs">;
+}, {
+    _id: import("convex/values").VId<import("convex/values").GenericId<"webhookConfigs">, "required">;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+    name: import("convex/values").VString<string, "required">;
+    description: import("convex/values").VString<string | undefined, "optional">;
+    url: import("convex/values").VString<string, "required">;
+    eventTypes: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    resourceTypes: import("convex/values").VArray<("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined, import("convex/values").VUnion<"contentEntry" | "contentType" | "mediaAsset" | "mediaFolder", [import("convex/values").VLiteral<"contentEntry", "required">, import("convex/values").VLiteral<"contentType", "required">, import("convex/values").VLiteral<"mediaAsset", "required">, import("convex/values").VLiteral<"mediaFolder", "required">], "required", never>, "optional">;
+    contentTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    headers: import("convex/values").VAny<any, "optional", string>;
+    enabled: import("convex/values").VBoolean<boolean, "required">;
+    maxRetries: import("convex/values").VFloat64<number | undefined, "optional">;
+    timeoutMs: import("convex/values").VFloat64<number | undefined, "optional">;
+    deletedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    createdBy: import("convex/values").VString<string | undefined, "optional">;
+    updatedBy: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "name" | "description" | "contentTypes" | "deletedAt" | "createdBy" | "updatedBy" | "_creationTime" | "url" | "eventTypes" | "resourceTypes" | "headers" | "enabled" | "maxRetries" | "timeoutMs" | `headers.${string}` | "_id">;
+/**
+ * Validator for webhook delivery document.
+ */
+export declare const webhookDeliveryDoc: import("convex/values").VObject<{
+    lastAttemptAt?: number | undefined;
+    nextRetryAt?: number | undefined;
+    lastStatusCode?: number | undefined;
+    lastError?: string | undefined;
+    lastResponseBody?: string | undefined;
+    lastDurationMs?: number | undefined;
+    deliveredAt?: number | undefined;
+    _creationTime: number;
+    status: "pending" | "processing" | "failed" | "delivered" | "retrying";
+    eventType: string;
+    payload: any;
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+    eventId: import("convex/values").GenericId<"cmsEvents">;
+    attemptCount: number;
+    maxAttempts: number;
+    _id: import("convex/values").GenericId<"webhookDeliveries">;
+}, {
+    _id: import("convex/values").VId<import("convex/values").GenericId<"webhookDeliveries">, "required">;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+    webhookId: import("convex/values").VId<import("convex/values").GenericId<"webhookConfigs">, "required">;
+    eventId: import("convex/values").VId<import("convex/values").GenericId<"cmsEvents">, "required">;
+    eventType: import("convex/values").VString<string, "required">;
+    status: import("convex/values").VUnion<"pending" | "processing" | "failed" | "delivered" | "retrying", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"processing", "required">, import("convex/values").VLiteral<"delivered", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"retrying", "required">], "required", never>;
+    attemptCount: import("convex/values").VFloat64<number, "required">;
+    maxAttempts: import("convex/values").VFloat64<number, "required">;
+    lastAttemptAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    nextRetryAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    lastStatusCode: import("convex/values").VFloat64<number | undefined, "optional">;
+    lastError: import("convex/values").VString<string | undefined, "optional">;
+    lastResponseBody: import("convex/values").VString<string | undefined, "optional">;
+    lastDurationMs: import("convex/values").VFloat64<number | undefined, "optional">;
+    payload: import("convex/values").VAny<any, "required", string>;
+    deliveredAt: import("convex/values").VFloat64<number | undefined, "optional">;
+}, "required", "_creationTime" | "status" | "eventType" | "payload" | `payload.${string}` | "webhookId" | "eventId" | "attemptCount" | "maxAttempts" | "lastAttemptAt" | "nextRetryAt" | "lastStatusCode" | "lastError" | "lastResponseBody" | "lastDurationMs" | "deliveredAt" | "_id">;
+/**
+ * Create a new webhook configuration.
+ *
+ * @example
+ * ```typescript
+ * const webhookId = await ctx.runMutation(api.webhookTrigger.createWebhook, {
+ *   name: "CDN Invalidation",
+ *   url: "https://api.example.com/webhooks/cms",
+ *   secret: "my-secret-key",
+ *   eventTypes: ["contentEntry.published", "contentEntry.deleted"],
+ * });
+ * ```
+ */
+export declare const createWebhook: import("convex/server").RegisteredMutation<"public", {
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    createdBy?: string | undefined;
+    secret?: string | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    enabled?: boolean | undefined;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    name: string;
+    url: string;
+    eventTypes: string[];
+}, Promise<import("convex/values").GenericId<"webhookConfigs">>>;
+/**
+ * Update an existing webhook configuration.
+ */
+export declare const updateWebhook: import("convex/server").RegisteredMutation<"public", {
+    name?: string | undefined;
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    updatedBy?: string | undefined;
+    url?: string | undefined;
+    secret?: string | undefined;
+    eventTypes?: string[] | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    enabled?: boolean | undefined;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    id: import("convex/values").GenericId<"webhookConfigs">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"webhookConfigs">;
+    _creationTime: number;
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    deletedAt?: number | undefined;
+    createdBy?: string | undefined;
+    updatedBy?: string | undefined;
+    secret?: string | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    name: string;
+    url: string;
+    eventTypes: string[];
+    enabled: boolean;
+}>>;
+/**
+ * Delete a webhook configuration.
+ */
+export declare const deleteWebhook: import("convex/server").RegisteredMutation<"public", {
+    hardDelete?: boolean | undefined;
+    deletedBy?: string | undefined;
+    id: import("convex/values").GenericId<"webhookConfigs">;
+}, Promise<{
+    success: boolean;
+    message: string;
+}>>;
+/**
+ * Restore a soft-deleted webhook.
+ */
+export declare const restoreWebhook: import("convex/server").RegisteredMutation<"public", {
+    restoredBy?: string | undefined;
+    id: import("convex/values").GenericId<"webhookConfigs">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"webhookConfigs">;
+    _creationTime: number;
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    deletedAt?: number | undefined;
+    createdBy?: string | undefined;
+    updatedBy?: string | undefined;
+    secret?: string | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    name: string;
+    url: string;
+    eventTypes: string[];
+    enabled: boolean;
+}>>;
+/**
+ * Get a single webhook configuration by ID.
+ * Note: Secret is not returned for security.
+ */
+export declare const getWebhook: import("convex/server").RegisteredQuery<"public", {
+    includeDeleted?: boolean | undefined;
+    id: import("convex/values").GenericId<"webhookConfigs">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"webhookConfigs">;
+    _creationTime: number;
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    deletedAt?: number | undefined;
+    createdBy?: string | undefined;
+    updatedBy?: string | undefined;
+    secret?: string | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    name: string;
+    url: string;
+    eventTypes: string[];
+    enabled: boolean;
+} | null>>;
+/**
+ * List all webhook configurations with optional filtering.
+ */
+export declare const listWebhooks: import("convex/server").RegisteredQuery<"public", {
+    enabled?: boolean | undefined;
+    includeDeleted?: boolean | undefined;
+    limit?: number | undefined;
+}, Promise<{
+    _id: import("convex/values").GenericId<"webhookConfigs">;
+    _creationTime: number;
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    deletedAt?: number | undefined;
+    createdBy?: string | undefined;
+    updatedBy?: string | undefined;
+    secret?: string | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    name: string;
+    url: string;
+    eventTypes: string[];
+    enabled: boolean;
+}[]>>;
+/**
+ * Internal query to get webhooks matching an event.
+ */
+export declare const getMatchingWebhooks: import("convex/server").RegisteredQuery<"internal", {
+    contentTypeName?: string | undefined;
+    eventType: string;
+    resourceType: "contentEntry" | "contentType" | "mediaAsset" | "mediaFolder";
+}, Promise<{
+    _id: import("convex/values").GenericId<"webhookConfigs">;
+    _creationTime: number;
+    description?: string | undefined;
+    contentTypes?: string[] | undefined;
+    deletedAt?: number | undefined;
+    createdBy?: string | undefined;
+    updatedBy?: string | undefined;
+    secret?: string | undefined;
+    resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+    headers?: any;
+    maxRetries?: number | undefined;
+    timeoutMs?: number | undefined;
+    name: string;
+    url: string;
+    eventTypes: string[];
+    enabled: boolean;
+}[]>>;
+/**
+ * Internal query to get unprocessed events for webhook delivery.
+ */
+export declare const getUnprocessedWebhookEvents: import("convex/server").RegisteredQuery<"internal", {
+    limit?: number | undefined;
+}, Promise<{
+    _id: import("convex/values").GenericId<"cmsEvents">;
+    _creationTime: number;
+    metadata?: any;
+    userId?: string | undefined;
+    processedAt?: number | undefined;
+    correlationId?: string | undefined;
+    eventType: string;
+    resourceType: "contentEntry" | "contentType" | "mediaAsset" | "mediaFolder";
+    resourceId: string;
+    action: "published" | "scheduled" | "created" | "updated" | "unpublished" | "deleted" | "restored" | "duplicated";
+    payload: any;
+    processed: boolean;
+}[]>>;
+/**
+ * Internal query to get pending or retrying deliveries.
+ */
+export declare const getPendingDeliveries: import("convex/server").RegisteredQuery<"internal", {
+    limit?: number | undefined;
+}, Promise<{
+    _id: import("convex/values").GenericId<"webhookDeliveries">;
+    _creationTime: number;
+    lastAttemptAt?: number | undefined;
+    nextRetryAt?: number | undefined;
+    lastStatusCode?: number | undefined;
+    lastError?: string | undefined;
+    lastResponseBody?: string | undefined;
+    lastDurationMs?: number | undefined;
+    deliveredAt?: number | undefined;
+    status: "pending" | "processing" | "failed" | "delivered" | "retrying";
+    eventType: string;
+    payload: any;
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+    eventId: import("convex/values").GenericId<"cmsEvents">;
+    attemptCount: number;
+    maxAttempts: number;
+}[]>>;
+/**
+ * Internal mutation to create a delivery record for an event-webhook pair.
+ */
+export declare const createDelivery: import("convex/server").RegisteredMutation<"internal", {
+    eventType: string;
+    payload: any;
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+    eventId: import("convex/values").GenericId<"cmsEvents">;
+    maxAttempts: number;
+}, Promise<import("convex/values").GenericId<"webhookDeliveries">>>;
+/**
+ * Internal mutation to update delivery status after an attempt.
+ */
+export declare const updateDeliveryStatus: import("convex/server").RegisteredMutation<"internal", {
+    nextRetryAt?: number | undefined;
+    error?: string | undefined;
+    statusCode?: number | undefined;
+    responseBody?: string | undefined;
+    durationMs?: number | undefined;
+    status: "pending" | "processing" | "failed" | "delivered" | "retrying";
+    deliveryId: import("convex/values").GenericId<"webhookDeliveries">;
+}, Promise<void>>;
+/**
+ * Internal mutation to mark delivery as processing.
+ */
+export declare const markDeliveryProcessing: import("convex/server").RegisteredMutation<"internal", {
+    deliveryId: import("convex/values").GenericId<"webhookDeliveries">;
+}, Promise<void>>;
+/**
+ * Internal action to send a webhook delivery.
+ * Actions are needed for HTTP requests to external services.
+ */
+export declare const sendWebhookDelivery: import("convex/server").RegisteredAction<"internal", {
+    deliveryId: import("convex/values").GenericId<"webhookDeliveries">;
+}, Promise<void>>;
+/**
+ * Internal query to get delivery with webhook info.
+ */
+export declare const getDeliveryWithWebhook: import("convex/server").RegisteredQuery<"internal", {
+    deliveryId: import("convex/values").GenericId<"webhookDeliveries">;
+}, Promise<{
+    webhook: {
+        _id: import("convex/values").GenericId<"webhookConfigs">;
+        _creationTime: number;
+        description?: string | undefined;
+        contentTypes?: string[] | undefined;
+        deletedAt?: number | undefined;
+        createdBy?: string | undefined;
+        updatedBy?: string | undefined;
+        secret?: string | undefined;
+        resourceTypes?: ("contentEntry" | "contentType" | "mediaAsset" | "mediaFolder")[] | undefined;
+        headers?: any;
+        maxRetries?: number | undefined;
+        timeoutMs?: number | undefined;
+        name: string;
+        url: string;
+        eventTypes: string[];
+        enabled: boolean;
+    };
+    _id: import("convex/values").GenericId<"webhookDeliveries">;
+    _creationTime: number;
+    lastAttemptAt?: number | undefined;
+    nextRetryAt?: number | undefined;
+    lastStatusCode?: number | undefined;
+    lastError?: string | undefined;
+    lastResponseBody?: string | undefined;
+    lastDurationMs?: number | undefined;
+    deliveredAt?: number | undefined;
+    status: "pending" | "processing" | "failed" | "delivered" | "retrying";
+    eventType: string;
+    payload: any;
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+    eventId: import("convex/values").GenericId<"cmsEvents">;
+    attemptCount: number;
+    maxAttempts: number;
+} | null>>;
+/**
+ * Process unprocessed events and create webhook deliveries.
+ *
+ * This mutation:
+ * 1. Gets unprocessed events from cmsEvents
+ * 2. For each event, finds matching webhook configurations
+ * 3. Creates delivery records for each event-webhook pair
+ *
+ * Call this periodically to queue new deliveries.
+ */
+export declare const processEventsForDelivery: import("convex/server").RegisteredMutation<"internal", {
+    batchSize?: number | undefined;
+}, Promise<{
+    eventsProcessed: number;
+    deliveriesCreated: number;
+    hasMore: boolean;
+}>>;
+/**
+ * Trigger webhook deliveries for pending/retrying items.
+ *
+ * This internal mutation schedules action calls for each pending delivery.
+ */
+export declare const triggerPendingDeliveries: import("convex/server").RegisteredMutation<"internal", {
+    batchSize?: number | undefined;
+}, Promise<{
+    deliveriesTriggered: number;
+    hasMore: boolean;
+}>>;
+/**
+ * Main scheduled function that processes events and triggers webhooks.
+ *
+ * This should be called periodically (e.g., every minute) to:
+ * 1. Create deliveries for new events
+ * 2. Trigger pending/retrying deliveries
+ */
+export declare const processWebhooks: import("convex/server").RegisteredMutation<"internal", {
+    config?: {
+        batchSize?: number | undefined;
+    } | undefined;
+}, Promise<{
+    eventsProcessed: number;
+    deliveriesCreated: number;
+    deliveriesTriggered: number;
+    hasMore: boolean;
+}>>;
+/**
+ * Schedule the next webhook processing run.
+ *
+ * Call this to set up recurring background processing.
+ *
+ * @param delayMs - Delay before next run in milliseconds
+ */
+export declare const scheduleNextWebhookRun: import("convex/server").RegisteredMutation<"public", {
+    delayMs?: number | undefined;
+}, Promise<{
+    scheduledAt: number;
+}>>;
+/**
+ * Internal mutation triggered by scheduler to process webhooks.
+ * This inlines the processWebhooks logic to avoid calling .handler() directly.
+ */
+export declare const triggerWebhookCheck: import("convex/server").RegisteredMutation<"internal", {}, Promise<{
+    eventsProcessed: number;
+    deliveriesCreated: number;
+    deliveriesTriggered: number;
+    hasMore: boolean;
+}>>;
+/**
+ * Get delivery statistics for a webhook.
+ */
+export declare const getWebhookDeliveryStats: import("convex/server").RegisteredQuery<"public", {
+    since?: number | undefined;
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+}, Promise<{
+    total: number;
+    pending: number;
+    processing: number;
+    delivered: number;
+    failed: number;
+    retrying: number;
+}>>;
+/**
+ * List recent deliveries for a webhook.
+ */
+export declare const listWebhookDeliveries: import("convex/server").RegisteredQuery<"public", {
+    status?: "pending" | "processing" | "failed" | "delivered" | "retrying" | undefined;
+    limit?: number | undefined;
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"webhookDeliveries">;
+    _creationTime: number;
+    lastAttemptAt?: number | undefined;
+    nextRetryAt?: number | undefined;
+    lastStatusCode?: number | undefined;
+    lastError?: string | undefined;
+    lastResponseBody?: string | undefined;
+    lastDurationMs?: number | undefined;
+    deliveredAt?: number | undefined;
+    status: "pending" | "processing" | "failed" | "delivered" | "retrying";
+    eventType: string;
+    payload: any;
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+    eventId: import("convex/values").GenericId<"cmsEvents">;
+    attemptCount: number;
+    maxAttempts: number;
+}[]>>;
+/**
+ * Get overall webhook statistics.
+ */
+export declare const getWebhookStats: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    totalWebhooks: number;
+    activeWebhooks: number;
+    pendingDeliveries: number;
+    retryingDeliveries: number;
+    deliveriesLast24h: number;
+    successRateLast24h: number;
+}>>;
+/**
+ * Get delivery details by ID.
+ */
+export declare const getDelivery: import("convex/server").RegisteredQuery<"public", {
+    deliveryId: import("convex/values").GenericId<"webhookDeliveries">;
+}, Promise<{
+    _id: import("convex/values").GenericId<"webhookDeliveries">;
+    _creationTime: number;
+    lastAttemptAt?: number | undefined;
+    nextRetryAt?: number | undefined;
+    lastStatusCode?: number | undefined;
+    lastError?: string | undefined;
+    lastResponseBody?: string | undefined;
+    lastDurationMs?: number | undefined;
+    deliveredAt?: number | undefined;
+    status: "pending" | "processing" | "failed" | "delivered" | "retrying";
+    eventType: string;
+    payload: any;
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+    eventId: import("convex/values").GenericId<"cmsEvents">;
+    attemptCount: number;
+    maxAttempts: number;
+} | null>>;
+/**
+ * Manually retry a failed delivery.
+ */
+export declare const retryDelivery: import("convex/server").RegisteredMutation<"public", {
+    deliveryId: import("convex/values").GenericId<"webhookDeliveries">;
+}, Promise<{
+    success: boolean;
+    message: string;
+}>>;
+/**
+ * Clean up old delivery records.
+ */
+export declare const cleanupOldDeliveries: import("convex/server").RegisteredMutation<"public", {
+    retentionDays?: number | undefined;
+}, Promise<{
+    deletedCount: number;
+}>>;
+/**
+ * Test a webhook by sending a test event.
+ * Useful for verifying webhook configuration before enabling.
+ */
+export declare const testWebhook: import("convex/server").RegisteredMutation<"public", {
+    webhookId: import("convex/values").GenericId<"webhookConfigs">;
+}, Promise<{
+    success: boolean;
+    message: string;
+    deliveryId: import("convex/values").GenericId<"webhookDeliveries">;
+}>>;
+//# sourceMappingURL=webhookTrigger.d.ts.map