@trigger.dev/core 4.7.4 → 4.8.0-webhooks.20261020092920

package/dist/commonjs/v3/webhooks/index.d.ts

@@ -1,4 +1,4 @@
-import type { WebhookAsymmetricConfig, WebhookHmacConfig } from "../schemas/webhookConfig.js";
+import type { WebhookAsymmetricConfig, WebhookHmacConfig, WebhookVerifierConfig } from "../schemas/webhookConfig.js";
 /**
  * Preset verifier-config builders: the single source of truth for how each supported provider signs.
  * The public SDK `webhooks.stripe()` producers wrap these (attaching provider + secretProvisioning +
@@ -24,10 +24,11 @@ export declare function discordVerifierConfig(opts?: {
 export declare const WEBHOOK_PRESET_IDS: readonly ["custom", "stripe", "github", "svix", "standard-webhooks", "square", "discord"];
 export type WebhookPresetId = (typeof WEBHOOK_PRESET_IDS)[number];
 /**
- * Per-provider verifier configs for providers whose signature is a plain HMAC variant that maps onto
- * the config primitives (a different header name / prefix / signing template than the shared presets,
- * but no new verifier capability). Each is round-trip tested in @internal/webhook-sources and wrapped
- * by a `webhooks.X()` SDK producer. Providers needing asymmetric verification, hex-decoded keys, or
+ * Per-provider verifier configs for providers whose signature maps onto the config primitives: a plain
+ * HMAC variant (a different header name / prefix / signing template than the shared presets, but no
+ * new verifier capability), a shared Svix or Standard Webhooks config under the provider's own name, or
+ * a shared secret. Each is round-trip tested in @internal/webhook-sources and wrapped by a
+ * `webhooks.X()` SDK producer. Providers needing asymmetric verification, hex-decoded keys, or
  * URL+param signing are NOT here (they ship sample-only until the verifier gains those).
  */
 export declare const webhookProviderConfigs: {
@@ -48,6 +49,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -61,6 +63,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -68,6 +71,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -111,6 +115,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -124,6 +129,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -131,6 +137,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -174,6 +181,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -187,6 +195,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -194,6 +203,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -237,6 +247,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -250,6 +261,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -257,6 +269,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -300,6 +313,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -313,6 +327,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -320,6 +335,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -363,6 +379,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -376,6 +393,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -383,6 +401,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -426,6 +445,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -439,6 +459,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -446,6 +467,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -489,6 +511,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -502,6 +525,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -509,6 +533,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -552,6 +577,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -565,6 +591,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -572,6 +599,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -615,6 +643,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -628,6 +657,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -635,6 +665,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -678,6 +709,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -691,6 +723,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -698,6 +731,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -741,6 +775,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -754,6 +789,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -761,6 +797,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -804,6 +841,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -817,6 +855,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -824,6 +863,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -867,6 +907,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -880,6 +921,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -887,6 +929,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -930,6 +973,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -943,6 +987,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -950,6 +995,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -993,6 +1039,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1006,6 +1053,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -1013,6 +1061,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1056,6 +1105,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1069,6 +1119,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -1076,6 +1127,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1119,6 +1171,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1132,6 +1185,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -1139,6 +1193,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1182,6 +1237,7 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1195,6 +1251,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -1202,6 +1259,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1229,6 +1287,348 @@ export declare const webhookProviderConfigs: {
         };
     };
     shopify: {
+        secretProvisioning: "provider";
+        config: () => {
+            scheme: "hmac";
+            algorithm: "sha1" | "sha256";
+            encoding: "base64" | "hex";
+            signatureHeader: string;
+            signature?: {
+                itemSeparator?: string | undefined;
+                fieldSeparator?: string | undefined;
+                field?: string | undefined;
+                trim?: boolean | undefined;
+            } | undefined;
+            timestamp?: {
+                source: {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                };
+                unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
+                toleranceSeconds?: number | undefined;
+            } | undefined;
+            signingString: "raw" | {
+                template: string;
+                vars?: Record<string, {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                }> | undefined;
+            };
+            secret?: {
+                encoding?: "base64" | "utf8" | undefined;
+                stripPrefix?: string | undefined;
+            } | undefined;
+            idempotencyField?: {
+                from: "body" | "header";
+                name: string;
+            } | undefined;
+            formPayload?: {
+                field: string;
+            } | undefined;
+        };
+    };
+    loops: {
+        secretProvisioning: "provider";
+        config: typeof standardWebhooksVerifierConfig;
+    };
+    granola: {
+        secretProvisioning: "provider";
+        config: typeof standardWebhooksVerifierConfig;
+    };
+    autumn: {
+        secretProvisioning: "provider";
+        config: typeof svixVerifierConfig;
+    };
+    metronome: {
+        secretProvisioning: "provider";
+        config: () => {
+            scheme: "hmac";
+            algorithm: "sha1" | "sha256";
+            encoding: "base64" | "hex";
+            signatureHeader: string;
+            signature?: {
+                itemSeparator?: string | undefined;
+                fieldSeparator?: string | undefined;
+                field?: string | undefined;
+                trim?: boolean | undefined;
+            } | undefined;
+            timestamp?: {
+                source: {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                };
+                unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
+                toleranceSeconds?: number | undefined;
+            } | undefined;
+            signingString: "raw" | {
+                template: string;
+                vars?: Record<string, {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                }> | undefined;
+            };
+            secret?: {
+                encoding?: "base64" | "utf8" | undefined;
+                stripPrefix?: string | undefined;
+            } | undefined;
+            idempotencyField?: {
+                from: "body" | "header";
+                name: string;
+            } | undefined;
+            formPayload?: {
+                field: string;
+            } | undefined;
+        };
+    };
+    mux: {
+        secretProvisioning: "provider";
+        config: () => {
+            scheme: "hmac";
+            algorithm: "sha1" | "sha256";
+            encoding: "base64" | "hex";
+            signatureHeader: string;
+            signature?: {
+                itemSeparator?: string | undefined;
+                fieldSeparator?: string | undefined;
+                field?: string | undefined;
+                trim?: boolean | undefined;
+            } | undefined;
+            timestamp?: {
+                source: {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                };
+                unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
+                toleranceSeconds?: number | undefined;
+            } | undefined;
+            signingString: "raw" | {
+                template: string;
+                vars?: Record<string, {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                }> | undefined;
+            };
+            secret?: {
+                encoding?: "base64" | "utf8" | undefined;
+                stripPrefix?: string | undefined;
+            } | undefined;
+            idempotencyField?: {
+                from: "body" | "header";
+                name: string;
+            } | undefined;
+            formPayload?: {
+                field: string;
+            } | undefined;
+        };
+    };
+    tailscale: {
+        secretProvisioning: "provider";
+        config: () => {
+            scheme: "hmac";
+            algorithm: "sha1" | "sha256";
+            encoding: "base64" | "hex";
+            signatureHeader: string;
+            signature?: {
+                itemSeparator?: string | undefined;
+                fieldSeparator?: string | undefined;
+                field?: string | undefined;
+                trim?: boolean | undefined;
+            } | undefined;
+            timestamp?: {
+                source: {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                };
+                unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
+                toleranceSeconds?: number | undefined;
+            } | undefined;
+            signingString: "raw" | {
+                template: string;
+                vars?: Record<string, {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                }> | undefined;
+            };
+            secret?: {
+                encoding?: "base64" | "utf8" | undefined;
+                stripPrefix?: string | undefined;
+            } | undefined;
+            idempotencyField?: {
+                from: "body" | "header";
+                name: string;
+            } | undefined;
+            formPayload?: {
+                field: string;
+            } | undefined;
+        };
+    };
+    langfuse: {
+        secretProvisioning: "provider";
+        config: () => {
+            scheme: "hmac";
+            algorithm: "sha1" | "sha256";
+            encoding: "base64" | "hex";
+            signatureHeader: string;
+            signature?: {
+                itemSeparator?: string | undefined;
+                fieldSeparator?: string | undefined;
+                field?: string | undefined;
+                trim?: boolean | undefined;
+            } | undefined;
+            timestamp?: {
+                source: {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                };
+                unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
+                toleranceSeconds?: number | undefined;
+            } | undefined;
+            signingString: "raw" | {
+                template: string;
+                vars?: Record<string, {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                }> | undefined;
+            };
+            secret?: {
+                encoding?: "base64" | "utf8" | undefined;
+                stripPrefix?: string | undefined;
+            } | undefined;
+            idempotencyField?: {
+                from: "body" | "header";
+                name: string;
+            } | undefined;
+            formPayload?: {
+                field: string;
+            } | undefined;
+        };
+    };
+    infisical: {
         secretProvisioning: "integrator";
         config: () => {
             scheme: "hmac";
@@ -1245,6 +1645,73 @@ export declare const webhookProviderConfigs: {
                 source: {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                };
+                unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
+                toleranceSeconds?: number | undefined;
+            } | undefined;
+            signingString: "raw" | {
+                template: string;
+                vars?: Record<string, {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                }> | undefined;
+            };
+            secret?: {
+                encoding?: "base64" | "utf8" | undefined;
+                stripPrefix?: string | undefined;
+            } | undefined;
+            idempotencyField?: {
+                from: "body" | "header";
+                name: string;
+            } | undefined;
+            formPayload?: {
+                field: string;
+            } | undefined;
+        };
+    };
+    planetscale: {
+        secretProvisioning: "provider";
+        config: () => {
+            scheme: "hmac";
+            algorithm: "sha1" | "sha256";
+            encoding: "base64" | "hex";
+            signatureHeader: string;
+            signature?: {
+                itemSeparator?: string | undefined;
+                fieldSeparator?: string | undefined;
+                field?: string | undefined;
+                trim?: boolean | undefined;
+            } | undefined;
+            timestamp?: {
+                source: {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1258,6 +1725,7 @@ export declare const webhookProviderConfigs: {
                     value: string;
                 };
                 unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
                 toleranceSeconds?: number | undefined;
             } | undefined;
             signingString: "raw" | {
@@ -1265,6 +1733,7 @@ export declare const webhookProviderConfigs: {
                 vars?: Record<string, {
                     from: "header";
                     name: string;
+                    fallback?: string[] | undefined;
                 } | {
                     from: "signatureField";
                     field: string;
@@ -1291,11 +1760,147 @@ export declare const webhookProviderConfigs: {
             } | undefined;
         };
     };
+    plain: {
+        secretProvisioning: "provider";
+        config: () => {
+            scheme: "hmac";
+            algorithm: "sha1" | "sha256";
+            encoding: "base64" | "hex";
+            signatureHeader: string;
+            signature?: {
+                itemSeparator?: string | undefined;
+                fieldSeparator?: string | undefined;
+                field?: string | undefined;
+                trim?: boolean | undefined;
+            } | undefined;
+            timestamp?: {
+                source: {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                };
+                unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
+                toleranceSeconds?: number | undefined;
+            } | undefined;
+            signingString: "raw" | {
+                template: string;
+                vars?: Record<string, {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                }> | undefined;
+            };
+            secret?: {
+                encoding?: "base64" | "utf8" | undefined;
+                stripPrefix?: string | undefined;
+            } | undefined;
+            idempotencyField?: {
+                from: "body" | "header";
+                name: string;
+            } | undefined;
+            formPayload?: {
+                field: string;
+            } | undefined;
+        };
+    };
+    firecrawl: {
+        secretProvisioning: "provider";
+        config: () => {
+            scheme: "hmac";
+            algorithm: "sha1" | "sha256";
+            encoding: "base64" | "hex";
+            signatureHeader: string;
+            signature?: {
+                itemSeparator?: string | undefined;
+                fieldSeparator?: string | undefined;
+                field?: string | undefined;
+                trim?: boolean | undefined;
+            } | undefined;
+            timestamp?: {
+                source: {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                };
+                unit?: "milliseconds" | "seconds" | undefined;
+                format?: "http-date" | "iso8601" | "unix" | undefined;
+                toleranceSeconds?: number | undefined;
+            } | undefined;
+            signingString: "raw" | {
+                template: string;
+                vars?: Record<string, {
+                    from: "header";
+                    name: string;
+                    fallback?: string[] | undefined;
+                } | {
+                    from: "signatureField";
+                    field: string;
+                } | {
+                    from: "body";
+                    path: string;
+                } | {
+                    from: "url";
+                } | {
+                    from: "constant";
+                    value: string;
+                }> | undefined;
+            };
+            secret?: {
+                encoding?: "base64" | "utf8" | undefined;
+                stripPrefix?: string | undefined;
+            } | undefined;
+            idempotencyField?: {
+                from: "body" | "header";
+                name: string;
+            } | undefined;
+            formPayload?: {
+                field: string;
+            } | undefined;
+        };
+    };
+    supabase: {
+        secretProvisioning: "integrator";
+        config: () => WebhookVerifierConfig;
+    };
 };
 export type WebhookProviderId = keyof typeof webhookProviderConfigs;
 /**
- * Setup instructions for an AI agent, per preset. SDK producers attach these as the source's
- * `setupPrompt`; the platform wraps them with the endpoint URL, subscribers and secret steps.
+ * Setup instructions for an AI agent, per preset or provider. SDK producers attach these as the
+ * source's `setupPrompt`; the platform wraps them with the endpoint URL, subscribers and secret steps.
  */
-export declare const webhookSetupPrompts: Partial<Record<WebhookPresetId, string>>;
+export declare const webhookSetupPrompts: Partial<Record<WebhookPresetId | WebhookProviderId, string>>;
 export * from "../schemas/webhookConfig.js";