@blokjs/helper 0.2.1 → 0.6.0

package/dist/types/TriggerOpts.d.ts

@@ -1,41 +1,678 @@
 import { z } from "zod";
-export declare const HttpTriggerOptsSchema: z.ZodObject<{
-    method: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "ANY"]>;
+/**
+ * Reusable Zod field bag for per-key concurrency gating.
+ *
+ * Spread into a trigger's `z.object({...})` and pair with the
+ * {@link concurrencyRefinement} cross-field check to add concurrency-key
+ * support to a trigger schema.
+ *
+ * Authors set `concurrencyKey` (literal or `$`-proxy expression) plus an
+ * optional `concurrencyLimit` (defaults to 1, matching Trigger.dev's
+ * "named mutex per key" pattern). When omitted, the trigger has no
+ * concurrency gate (zero-overhead default).
+ */
+export declare const ConcurrencyOptsFields: {
+    readonly concurrencyKey: z.ZodOptional<z.ZodString>;
+    readonly concurrencyLimit: z.ZodOptional<z.ZodNumber>;
+    readonly concurrencyLeaseMs: z.ZodOptional<z.ZodNumber>;
+    readonly onLimit: z.ZodOptional<z.ZodEnum<["throw", "queue"]>>;
+    readonly concurrencyQueueTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    readonly concurrencyQueueRetry: z.ZodOptional<z.ZodObject<{
+        minBackoffMs: z.ZodOptional<z.ZodNumber>;
+        maxBackoffMs: z.ZodOptional<z.ZodNumber>;
+        factor: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }>>;
+};
+/**
+ * Cross-field refinement: `concurrencyLimit` / `concurrencyLeaseMs` / `onLimit`
+ * set without `concurrencyKey` are meaningless and rejected at validation time.
+ */
+export declare const concurrencyRefinement: (val: {
+    concurrencyKey?: string;
+    concurrencyLimit?: number;
+    concurrencyLeaseMs?: number;
+    onLimit?: "throw" | "queue";
+    concurrencyQueueTimeoutMs?: number;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number;
+        maxBackoffMs?: number;
+        factor?: number;
+    };
+}, ctx: z.RefinementCtx) => void;
+/**
+ * Standalone schema exposing just the concurrency fields. Useful for tests
+ * and tools that want to validate concurrency config in isolation. Real
+ * triggers spread {@link ConcurrencyOptsFields} into their own `z.object`
+ * and apply {@link concurrencyRefinement}.
+ */
+export declare const ConcurrencyOptsSchema: z.ZodEffects<z.ZodObject<{
+    readonly concurrencyKey: z.ZodOptional<z.ZodString>;
+    readonly concurrencyLimit: z.ZodOptional<z.ZodNumber>;
+    readonly concurrencyLeaseMs: z.ZodOptional<z.ZodNumber>;
+    readonly onLimit: z.ZodOptional<z.ZodEnum<["throw", "queue"]>>;
+    readonly concurrencyQueueTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    readonly concurrencyQueueRetry: z.ZodOptional<z.ZodObject<{
+        minBackoffMs: z.ZodOptional<z.ZodNumber>;
+        maxBackoffMs: z.ZodOptional<z.ZodNumber>;
+        factor: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+}, {
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+}>, {
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+}, {
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+}>;
+/** Inferred shape of the concurrency-options field bag. */
+export type ConcurrencyOpts = z.input<typeof ConcurrencyOptsSchema>;
+/**
+ * Duration value: a non-negative integer (interpreted as milliseconds) or a
+ * single-unit string (`"500ms"`, `"30s"`, `"5m"`, `"2h"`, `"1d"`). Validated
+ * at trigger-config parse time; converted to milliseconds at run-entry time
+ * by `parseDuration` (`@blokjs/helper`).
+ */
+/**
+ * Duration value: a non-negative integer (ms) or a single-unit string
+ * (`"500ms"`, `"30s"`, `"5m"`, `"2h"`, `"1d"`). Reused by Tier 2 #5+#7
+ * scheduling fields and the Tier 2 quick-wins `maxDuration` step field.
+ */
+export declare const DurationSchema: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+/**
+ * Per-key debounce configuration. When set, repeated triggers sharing the
+ * resolved `key` collapse into one delayed run. Modes:
+ *
+ * - `"trailing"` (default): each ping resets a `delay` ms timer; the run
+ *   fires after `delay` ms of silence. `maxDelay` (when set) bounds the
+ *   tail latency — even with continuous pings, the run fires after
+ *   `maxDelay` ms.
+ * - `"leading"`: the first ping in a window fires immediately; subsequent
+ *   pings within `delay` ms are dropped with status `"debounced"`. Window
+ *   resets when `delay` ms of silence pass.
+ *
+ * `key` is a literal string OR a `js/...` expression that evaluates to a
+ * string at run-entry time (typically derived from the request payload via
+ * a `$`-proxy expression like `$.req.body.userId`).
+ */
+export declare const DebounceOptsSchema: z.ZodEffects<z.ZodObject<{
+    key: z.ZodString;
+    mode: z.ZodDefault<z.ZodEnum<["leading", "trailing"]>>;
+    delay: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    maxDelay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    mode: "leading" | "trailing";
+    delay: string | number;
+    maxDelay?: string | number | undefined;
+}, {
+    key: string;
+    delay: string | number;
+    mode?: "leading" | "trailing" | undefined;
+    maxDelay?: string | number | undefined;
+}>, {
+    key: string;
+    mode: "leading" | "trailing";
+    delay: string | number;
+    maxDelay?: string | number | undefined;
+}, {
+    key: string;
+    delay: string | number;
+    mode?: "leading" | "trailing" | undefined;
+    maxDelay?: string | number | undefined;
+}>;
+/** Inferred type of the {@link DebounceOptsSchema}. */
+export type DebounceOpts = z.input<typeof DebounceOptsSchema>;
+/**
+ * Reusable Zod field bag for run-scheduling primitives. Spread into a
+ * trigger's `z.object({...})` and pair with {@link schedulingRefinement}
+ * for cross-field validation.
+ *
+ * - `delay`: defer the run by N (number = ms, or string = `"1h"`).
+ * - `ttl`: expire if not started within N. Auto-cancels with status
+ *   `"expired"`.
+ * - `debounce`: coalesce rapid same-key triggers into one delayed run.
+ *
+ * Zero-overhead default: when none of these fields are set, the trigger
+ * behaves exactly as before.
+ */
+export declare const SchedulingOptsFields: {
+    readonly delay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    readonly ttl: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    readonly debounce: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        key: z.ZodString;
+        mode: z.ZodDefault<z.ZodEnum<["leading", "trailing"]>>;
+        delay: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        maxDelay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>>;
+};
+/**
+ * Cross-field refinement for scheduling fields. Per-trigger callers pass
+ * the trigger kind so HTTP and Worker can have different rules for
+ * `ttl`-without-`delay`.
+ */
+export declare function makeSchedulingRefinement(triggerKind: "http" | "worker"): (val: {
+    delay?: number | string;
+    ttl?: number | string;
+    debounce?: DebounceOpts;
+}, ctx: z.RefinementCtx) => void;
+/**
+ * Standalone schema exposing just the scheduling fields. Useful for tests
+ * and tools. Real triggers spread {@link SchedulingOptsFields} into their
+ * own `z.object` and apply {@link makeSchedulingRefinement}.
+ */
+export declare const SchedulingOptsSchema: z.ZodObject<{
+    readonly delay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    readonly ttl: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    readonly debounce: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        key: z.ZodString;
+        mode: z.ZodDefault<z.ZodEnum<["leading", "trailing"]>>;
+        delay: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        maxDelay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+}, {
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+}>;
+/** Inferred shape of the scheduling-options field bag. */
+export type SchedulingOpts = z.input<typeof SchedulingOptsSchema>;
+/**
+ * Canonical HTTP method names.
+ *
+ * `"ANY"` is the wildcard. Legacy `"*"` (used by old JSON workflows) is
+ * accepted via {@link HttpMethodSchema} preprocessing and normalized to
+ * `"ANY"` with a one-time deprecation warning.
+ */
+export declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS", "ANY"];
+/**
+ * HTTP method schema — accepts the canonical names plus the legacy `"*"`
+ * (which is preprocessed to `"ANY"` with a one-time warning).
+ */
+export declare const HttpMethodSchema: z.ZodEffects<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS", "ANY"]>, "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY", unknown>;
+export type HttpMethod = z.infer<typeof HttpMethodSchema>;
+/** Validation schema for the HTTP trigger configuration. */
+export declare const HttpTriggerOptsSchema: z.ZodEffects<z.ZodObject<{
+    delay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    ttl: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    debounce: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        key: z.ZodString;
+        mode: z.ZodDefault<z.ZodEnum<["leading", "trailing"]>>;
+        delay: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        maxDelay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>>;
+    concurrencyKey: z.ZodOptional<z.ZodString>;
+    concurrencyLimit: z.ZodOptional<z.ZodNumber>;
+    concurrencyLeaseMs: z.ZodOptional<z.ZodNumber>;
+    onLimit: z.ZodOptional<z.ZodEnum<["throw", "queue"]>>;
+    concurrencyQueueTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    concurrencyQueueRetry: z.ZodOptional<z.ZodObject<{
+        minBackoffMs: z.ZodOptional<z.ZodNumber>;
+        maxBackoffMs: z.ZodOptional<z.ZodNumber>;
+        factor: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }>>;
+    method: z.ZodEffects<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS", "ANY"]>, "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY", unknown>;
     path: z.ZodOptional<z.ZodString>;
     accept: z.ZodDefault<z.ZodString>;
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    legacyKeyPrefix: z.ZodOptional<z.ZodBoolean>;
+    middleware: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    examples: z.ZodOptional<z.ZodObject<{
+        body: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        body?: unknown;
+    }, {
+        body?: unknown;
+    }>>;
+    recordSample: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "ANY";
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY";
     accept: string;
     path?: string | undefined;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    } | undefined;
     headers?: Record<string, any> | undefined;
+    legacyKeyPrefix?: boolean | undefined;
+    middleware?: string[] | undefined;
+    examples?: {
+        body?: unknown;
+    } | undefined;
+    recordSample?: boolean | undefined;
 }, {
-    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "ANY";
     path?: string | undefined;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    method?: unknown;
     accept?: string | undefined;
     headers?: Record<string, any> | undefined;
+    legacyKeyPrefix?: boolean | undefined;
+    middleware?: string[] | undefined;
+    examples?: {
+        body?: unknown;
+    } | undefined;
+    recordSample?: boolean | undefined;
+}>, {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY";
+    accept: string;
+    path?: string | undefined;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    headers?: Record<string, any> | undefined;
+    legacyKeyPrefix?: boolean | undefined;
+    middleware?: string[] | undefined;
+    examples?: {
+        body?: unknown;
+    } | undefined;
+    recordSample?: boolean | undefined;
+}, {
+    path?: string | undefined;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    method?: unknown;
+    accept?: string | undefined;
+    headers?: Record<string, any> | undefined;
+    legacyKeyPrefix?: boolean | undefined;
+    middleware?: string[] | undefined;
+    examples?: {
+        body?: unknown;
+    } | undefined;
+    recordSample?: boolean | undefined;
 }>;
-export declare const TriggerOptsSchema: z.ZodObject<{
-    method: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "ANY"]>;
+/** Configuration for an HTTP trigger. Use with `addTrigger("http", ...)`. */
+export type HttpTriggerOpts = z.input<typeof HttpTriggerOptsSchema>;
+/**
+ * Legacy alias for {@link HttpTriggerOptsSchema}. Prefer the explicit name.
+ *
+ * @deprecated Use {@link HttpTriggerOptsSchema} directly. Will be removed in
+ * the next minor version.
+ */
+export declare const TriggerOptsSchema: z.ZodEffects<z.ZodObject<{
+    delay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    ttl: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    debounce: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        key: z.ZodString;
+        mode: z.ZodDefault<z.ZodEnum<["leading", "trailing"]>>;
+        delay: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        maxDelay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>>;
+    concurrencyKey: z.ZodOptional<z.ZodString>;
+    concurrencyLimit: z.ZodOptional<z.ZodNumber>;
+    concurrencyLeaseMs: z.ZodOptional<z.ZodNumber>;
+    onLimit: z.ZodOptional<z.ZodEnum<["throw", "queue"]>>;
+    concurrencyQueueTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    concurrencyQueueRetry: z.ZodOptional<z.ZodObject<{
+        minBackoffMs: z.ZodOptional<z.ZodNumber>;
+        maxBackoffMs: z.ZodOptional<z.ZodNumber>;
+        factor: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }>>;
+    method: z.ZodEffects<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS", "ANY"]>, "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY", unknown>;
     path: z.ZodOptional<z.ZodString>;
     accept: z.ZodDefault<z.ZodString>;
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    legacyKeyPrefix: z.ZodOptional<z.ZodBoolean>;
+    middleware: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    examples: z.ZodOptional<z.ZodObject<{
+        body: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        body?: unknown;
+    }, {
+        body?: unknown;
+    }>>;
+    recordSample: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "ANY";
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY";
+    accept: string;
+    path?: string | undefined;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    headers?: Record<string, any> | undefined;
+    legacyKeyPrefix?: boolean | undefined;
+    middleware?: string[] | undefined;
+    examples?: {
+        body?: unknown;
+    } | undefined;
+    recordSample?: boolean | undefined;
+}, {
+    path?: string | undefined;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    method?: unknown;
+    accept?: string | undefined;
+    headers?: Record<string, any> | undefined;
+    legacyKeyPrefix?: boolean | undefined;
+    middleware?: string[] | undefined;
+    examples?: {
+        body?: unknown;
+    } | undefined;
+    recordSample?: boolean | undefined;
+}>, {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY";
     accept: string;
     path?: string | undefined;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    } | undefined;
     headers?: Record<string, any> | undefined;
+    legacyKeyPrefix?: boolean | undefined;
+    middleware?: string[] | undefined;
+    examples?: {
+        body?: unknown;
+    } | undefined;
+    recordSample?: boolean | undefined;
 }, {
-    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "ANY";
     path?: string | undefined;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    method?: unknown;
     accept?: string | undefined;
     headers?: Record<string, any> | undefined;
+    legacyKeyPrefix?: boolean | undefined;
+    middleware?: string[] | undefined;
+    examples?: {
+        body?: unknown;
+    } | undefined;
+    recordSample?: boolean | undefined;
 }>;
-export type TriggerOpts = z.input<typeof TriggerOptsSchema>;
-export declare const QueueProviderSchema: z.ZodEnum<["kafka", "rabbitmq", "sqs", "redis", "beanstalk"]>;
+/**
+ * Legacy alias for {@link HttpTriggerOpts}. Prefer the explicit name.
+ *
+ * @deprecated Use {@link HttpTriggerOpts} directly. Will be removed in the
+ * next minor version.
+ */
+export type TriggerOpts = HttpTriggerOpts;
+export declare const QueueProviderSchema: z.ZodEnum<["kafka", "rabbitmq", "sqs", "redis", "beanstalk", "nats"]>;
 export type QueueProvider = z.infer<typeof QueueProviderSchema>;
 export declare const QueueTriggerOptsSchema: z.ZodObject<{
-    provider: z.ZodEnum<["kafka", "rabbitmq", "sqs", "redis", "beanstalk"]>;
+    provider: z.ZodEnum<["kafka", "rabbitmq", "sqs", "redis", "beanstalk", "nats"]>;
     topic: z.ZodString;
     subscription: z.ZodOptional<z.ZodString>;
     consumerGroup: z.ZodOptional<z.ZodString>;
@@ -46,7 +683,7 @@ export declare const QueueTriggerOptsSchema: z.ZodObject<{
     batchSize: z.ZodDefault<z.ZodNumber>;
     concurrency: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    provider: "kafka" | "rabbitmq" | "sqs" | "redis" | "beanstalk";
+    provider: "kafka" | "rabbitmq" | "sqs" | "redis" | "beanstalk" | "nats";
     topic: string;
     ack: boolean;
     maxRetries: number;
@@ -57,7 +694,7 @@ export declare const QueueTriggerOptsSchema: z.ZodObject<{
     consumerGroup?: string | undefined;
     deadLetterQueue?: string | undefined;
 }, {
-    provider: "kafka" | "rabbitmq" | "sqs" | "redis" | "beanstalk";
+    provider: "kafka" | "rabbitmq" | "sqs" | "redis" | "beanstalk" | "nats";
     topic: string;
     subscription?: string | undefined;
     consumerGroup?: string | undefined;
@@ -69,58 +706,268 @@ export declare const QueueTriggerOptsSchema: z.ZodObject<{
     concurrency?: number | undefined;
 }>;
 export type QueueTriggerOpts = z.input<typeof QueueTriggerOptsSchema>;
-export declare const PubSubProviderSchema: z.ZodEnum<["gcp", "aws", "azure"]>;
+/**
+ * v0.7 PR 6 — supported pub/sub adapter providers.
+ *
+ * Pub/Sub is distinct from Worker: pub/sub is **1:N fan-out by default**
+ * (every subscriber sees every message). When `consumerGroup` is set,
+ * semantics shift to **competing-consumer** (1 of N within group). This
+ * single field disambiguates the two semantics — matching NestJS's
+ * `@MessagePattern` vs `@EventPattern` distinction.
+ *
+ * `nats` and `redis-streams` and `kafka` appear in both Worker and
+ * Pub/Sub provider lists because the underlying brokers support both
+ * semantics — the same broker connection serves both adapter kinds
+ * via different code paths.
+ *
+ * `BLOK_PUBSUB_ADAPTER` env var sets the default when `provider` is
+ * omitted on the workflow.
+ */
+export declare const PubSubProviderSchema: z.ZodEnum<["nats", "redis-streams", "kafka", "gcp", "aws", "azure"]>;
 export type PubSubProvider = z.infer<typeof PubSubProviderSchema>;
 export declare const PubSubTriggerOptsSchema: z.ZodObject<{
-    provider: z.ZodEnum<["gcp", "aws", "azure"]>;
+    provider: z.ZodOptional<z.ZodEnum<["nats", "redis-streams", "kafka", "gcp", "aws", "azure"]>>;
     topic: z.ZodString;
-    subscription: z.ZodString;
+    subscription: z.ZodOptional<z.ZodString>;
+    consumerGroup: z.ZodOptional<z.ZodString>;
+    durable: z.ZodOptional<z.ZodBoolean>;
+    startFrom: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"earliest">, z.ZodLiteral<"latest">, z.ZodObject<{
+        seq: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        seq: number;
+    }, {
+        seq: number;
+    }>, z.ZodObject<{
+        timestamp: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: number;
+    }, {
+        timestamp: number;
+    }>]>>;
     ack: z.ZodDefault<z.ZodBoolean>;
     maxMessages: z.ZodDefault<z.ZodNumber>;
     ackDeadline: z.ZodDefault<z.ZodNumber>;
     deadLetterTopic: z.ZodOptional<z.ZodString>;
     filter: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    provider: "gcp" | "aws" | "azure";
     topic: string;
-    subscription: string;
     ack: boolean;
     maxMessages: number;
     ackDeadline: number;
     filter?: string | undefined;
+    provider?: "kafka" | "nats" | "redis-streams" | "gcp" | "aws" | "azure" | undefined;
+    subscription?: string | undefined;
+    consumerGroup?: string | undefined;
+    durable?: boolean | undefined;
+    startFrom?: "earliest" | "latest" | {
+        seq: number;
+    } | {
+        timestamp: number;
+    } | undefined;
     deadLetterTopic?: string | undefined;
 }, {
-    provider: "gcp" | "aws" | "azure";
     topic: string;
-    subscription: string;
     filter?: string | undefined;
+    provider?: "kafka" | "nats" | "redis-streams" | "gcp" | "aws" | "azure" | undefined;
+    subscription?: string | undefined;
+    consumerGroup?: string | undefined;
     ack?: boolean | undefined;
+    durable?: boolean | undefined;
+    startFrom?: "earliest" | "latest" | {
+        seq: number;
+    } | {
+        timestamp: number;
+    } | undefined;
     maxMessages?: number | undefined;
     ackDeadline?: number | undefined;
     deadLetterTopic?: string | undefined;
 }>;
 export type PubSubTriggerOpts = z.input<typeof PubSubTriggerOptsSchema>;
-export declare const WorkerTriggerOptsSchema: z.ZodObject<{
+/**
+ * v0.7 — supported worker adapter providers. `BLOK_WORKER_ADAPTER`
+ * env var sets the default when `provider` is omitted on the workflow
+ * (per Q7 resolution). `in-memory` is the dev/test fallback.
+ *
+ * `nats` and `bullmq` shipped pre-v0.7. The other five (kafka,
+ * rabbitmq, sqs, redis, pg-boss) are new in PR 5 — each ships behind a
+ * peer-dependency so workflows that don't use that provider don't
+ * pay the install cost.
+ */
+export declare const WorkerProviderSchema: z.ZodEnum<["in-memory", "nats", "bullmq", "kafka", "rabbitmq", "sqs", "redis", "pg-boss"]>;
+export type WorkerProvider = z.infer<typeof WorkerProviderSchema>;
+export declare const WorkerTriggerOptsSchema: z.ZodEffects<z.ZodObject<{
+    delay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    ttl: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    debounce: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        key: z.ZodString;
+        mode: z.ZodDefault<z.ZodEnum<["leading", "trailing"]>>;
+        delay: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        maxDelay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>, {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    }, {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    }>>;
+    concurrencyKey: z.ZodOptional<z.ZodString>;
+    concurrencyLimit: z.ZodOptional<z.ZodNumber>;
+    concurrencyLeaseMs: z.ZodOptional<z.ZodNumber>;
+    onLimit: z.ZodOptional<z.ZodEnum<["throw", "queue"]>>;
+    concurrencyQueueTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    concurrencyQueueRetry: z.ZodOptional<z.ZodObject<{
+        minBackoffMs: z.ZodOptional<z.ZodNumber>;
+        maxBackoffMs: z.ZodOptional<z.ZodNumber>;
+        factor: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }, {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    }>>;
     queue: z.ZodString;
+    provider: z.ZodOptional<z.ZodEnum<["in-memory", "nats", "bullmq", "kafka", "rabbitmq", "sqs", "redis", "pg-boss"]>>;
     concurrency: z.ZodDefault<z.ZodNumber>;
     timeout: z.ZodOptional<z.ZodNumber>;
     retries: z.ZodDefault<z.ZodNumber>;
     priority: z.ZodDefault<z.ZodNumber>;
-    delay: z.ZodOptional<z.ZodNumber>;
+    consumerGroup: z.ZodOptional<z.ZodString>;
+    ack: z.ZodOptional<z.ZodBoolean>;
+    deadLetterQueue: z.ZodOptional<z.ZodString>;
+    fromBeginning: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    queue: string;
     concurrency: number;
+    retries: number;
+    priority: number;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    provider?: "kafka" | "rabbitmq" | "sqs" | "redis" | "nats" | "in-memory" | "bullmq" | "pg-boss" | undefined;
+    consumerGroup?: string | undefined;
+    ack?: boolean | undefined;
+    deadLetterQueue?: string | undefined;
+    timeout?: number | undefined;
+    fromBeginning?: boolean | undefined;
+}, {
     queue: string;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    provider?: "kafka" | "rabbitmq" | "sqs" | "redis" | "nats" | "in-memory" | "bullmq" | "pg-boss" | undefined;
+    consumerGroup?: string | undefined;
+    ack?: boolean | undefined;
+    deadLetterQueue?: string | undefined;
+    concurrency?: number | undefined;
+    timeout?: number | undefined;
+    retries?: number | undefined;
+    priority?: number | undefined;
+    fromBeginning?: boolean | undefined;
+}>, {
+    queue: string;
+    concurrency: number;
     retries: number;
     priority: number;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        mode: "leading" | "trailing";
+        delay: string | number;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    provider?: "kafka" | "rabbitmq" | "sqs" | "redis" | "nats" | "in-memory" | "bullmq" | "pg-boss" | undefined;
+    consumerGroup?: string | undefined;
+    ack?: boolean | undefined;
+    deadLetterQueue?: string | undefined;
     timeout?: number | undefined;
-    delay?: number | undefined;
+    fromBeginning?: boolean | undefined;
 }, {
     queue: string;
+    concurrencyKey?: string | undefined;
+    concurrencyLimit?: number | undefined;
+    concurrencyLeaseMs?: number | undefined;
+    onLimit?: "throw" | "queue" | undefined;
+    concurrencyQueueTimeoutMs?: number | undefined;
+    concurrencyQueueRetry?: {
+        minBackoffMs?: number | undefined;
+        maxBackoffMs?: number | undefined;
+        factor?: number | undefined;
+    } | undefined;
+    delay?: string | number | undefined;
+    ttl?: string | number | undefined;
+    debounce?: {
+        key: string;
+        delay: string | number;
+        mode?: "leading" | "trailing" | undefined;
+        maxDelay?: string | number | undefined;
+    } | undefined;
+    provider?: "kafka" | "rabbitmq" | "sqs" | "redis" | "nats" | "in-memory" | "bullmq" | "pg-boss" | undefined;
+    consumerGroup?: string | undefined;
+    ack?: boolean | undefined;
+    deadLetterQueue?: string | undefined;
     concurrency?: number | undefined;
     timeout?: number | undefined;
     retries?: number | undefined;
     priority?: number | undefined;
-    delay?: number | undefined;
+    fromBeginning?: boolean | undefined;
 }>;
 export type WorkerTriggerOpts = z.input<typeof WorkerTriggerOptsSchema>;
 export declare const CronTriggerOptsSchema: z.ZodObject<{
@@ -137,21 +984,135 @@ export declare const CronTriggerOptsSchema: z.ZodObject<{
     overlap?: boolean | undefined;
 }>;
 export type CronTriggerOpts = z.input<typeof CronTriggerOptsSchema>;
+/**
+ * v0.7 — custom signature scheme for unknown webhook providers.
+ *
+ * Authors who use a webhook source NOT in the built-in `provider`
+ * allowlist (github / stripe / slack / shopify / svix) supply this
+ * config; the trigger does HMAC verification using these fields.
+ *
+ * The `format` template names the layout of the signature payload —
+ * `{hex}` is substituted with the hex digest at verify time. Supports
+ * common shapes:
+ *   - GitHub-style: `sha256={hex}`
+ *   - Plain hex:    `{hex}`
+ *   - Base64:       `{base64}` (encoded variant)
+ *
+ * When `timestampHeader` is set, the verifier mixes the header value
+ * into the signed string as `{timestamp}.{rawBody}` (Stripe pattern)
+ * and rejects deliveries whose timestamp drifted by more than
+ * `tolerance` seconds (default 300s / 5min).
+ */
+export declare const WebhookCustomSignatureSchema: z.ZodObject<{
+    scheme: z.ZodDefault<z.ZodEnum<["hmac-sha256", "hmac-sha1", "hmac-sha512"]>>;
+    header: z.ZodString;
+    format: z.ZodDefault<z.ZodString>;
+    secretEnv: z.ZodString;
+    tolerance: z.ZodDefault<z.ZodNumber>;
+    timestampHeader: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scheme: "hmac-sha256" | "hmac-sha1" | "hmac-sha512";
+    header: string;
+    format: string;
+    secretEnv: string;
+    tolerance: number;
+    timestampHeader?: string | undefined;
+}, {
+    header: string;
+    secretEnv: string;
+    scheme?: "hmac-sha256" | "hmac-sha1" | "hmac-sha512" | undefined;
+    format?: string | undefined;
+    tolerance?: number | undefined;
+    timestampHeader?: string | undefined;
+}>;
+export type WebhookCustomSignature = z.input<typeof WebhookCustomSignatureSchema>;
+/**
+ * v0.7 webhook trigger config. See the v0.7 additional-triggers plan
+ * for the full design.
+ *
+ * **`provider`** selects a built-in verifier (GitHub, Stripe, Slack,
+ * Shopify, Standard Webhooks via Svix). For unknown providers, omit
+ * `provider` and supply `signature` instead.
+ *
+ * **`namespace`** (combined with a polymorphic `subworkflow` step in
+ * the workflow body) lets one trigger workflow dispatch to many
+ * per-event handler workflows by name. Example: webhook fires with
+ * `body.type === "invoice.paid"` and namespace `"stripe"` resolves
+ * to sub-workflow `"stripe.invoice.paid"`.
+ *
+ * **`secretEnv`** is the env var name to read the shared secret from
+ * — the verifier never sees the secret value at config time, and
+ * workflow JSON files never contain it.
+ *
+ * **`events`** (allowlist) skips verifier-validated deliveries that
+ * are NOT in the list — returns 200 with `{status: "ignored"}` so
+ * the sender doesn't retry. Absent allowlist = accept all events.
+ */
 export declare const WebhookTriggerOptsSchema: z.ZodObject<{
-    source: z.ZodString;
-    events: z.ZodArray<z.ZodString, "many">;
-    secret: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodEnum<["github", "stripe", "slack", "shopify", "svix"]>>;
     path: z.ZodOptional<z.ZodString>;
+    events: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    secretEnv: z.ZodOptional<z.ZodString>;
+    signature: z.ZodOptional<z.ZodObject<{
+        scheme: z.ZodDefault<z.ZodEnum<["hmac-sha256", "hmac-sha1", "hmac-sha512"]>>;
+        header: z.ZodString;
+        format: z.ZodDefault<z.ZodString>;
+        secretEnv: z.ZodString;
+        tolerance: z.ZodDefault<z.ZodNumber>;
+        timestampHeader: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        scheme: "hmac-sha256" | "hmac-sha1" | "hmac-sha512";
+        header: string;
+        format: string;
+        secretEnv: string;
+        tolerance: number;
+        timestampHeader?: string | undefined;
+    }, {
+        header: string;
+        secretEnv: string;
+        scheme?: "hmac-sha256" | "hmac-sha1" | "hmac-sha512" | undefined;
+        format?: string | undefined;
+        tolerance?: number | undefined;
+        timestampHeader?: string | undefined;
+    }>>;
+    tolerance: z.ZodOptional<z.ZodNumber>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    middleware: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    source: string;
-    events: string[];
     path?: string | undefined;
-    secret?: string | undefined;
+    middleware?: string[] | undefined;
+    provider?: "github" | "stripe" | "slack" | "shopify" | "svix" | undefined;
+    secretEnv?: string | undefined;
+    tolerance?: number | undefined;
+    events?: string[] | undefined;
+    signature?: {
+        scheme: "hmac-sha256" | "hmac-sha1" | "hmac-sha512";
+        header: string;
+        format: string;
+        secretEnv: string;
+        tolerance: number;
+        timestampHeader?: string | undefined;
+    } | undefined;
+    idempotencyKey?: string | undefined;
+    namespace?: string | undefined;
 }, {
-    source: string;
-    events: string[];
     path?: string | undefined;
-    secret?: string | undefined;
+    middleware?: string[] | undefined;
+    provider?: "github" | "stripe" | "slack" | "shopify" | "svix" | undefined;
+    secretEnv?: string | undefined;
+    tolerance?: number | undefined;
+    events?: string[] | undefined;
+    signature?: {
+        header: string;
+        secretEnv: string;
+        scheme?: "hmac-sha256" | "hmac-sha1" | "hmac-sha512" | undefined;
+        format?: string | undefined;
+        tolerance?: number | undefined;
+        timestampHeader?: string | undefined;
+    } | undefined;
+    idempotencyKey?: string | undefined;
+    namespace?: string | undefined;
 }>;
 export type WebhookTriggerOpts = z.input<typeof WebhookTriggerOptsSchema>;
 export declare const WebSocketTriggerOptsSchema: z.ZodObject<{
@@ -200,10 +1161,17 @@ export declare const SSETriggerOptsSchema: z.ZodObject<{
     retryInterval?: number | undefined;
 }>;
 export type SSETriggerOpts = z.input<typeof SSETriggerOptsSchema>;
+/** All trigger names supported by Blok. */
 export declare const TriggersSchema: z.ZodEnum<["http", "grpc", "manual", "cron", "queue", "pubsub", "worker", "webhook", "sse", "websocket"]>;
 export type TriggersEnum = z.infer<typeof TriggersSchema>;
+/**
+ * Map of trigger name → its config type.
+ *
+ * Used by {@link Trigger.addTrigger} overloads to constrain the `config`
+ * argument's shape for each trigger kind.
+ */
 export type TriggerConfigMap = {
-    http: TriggerOpts;
+    http: HttpTriggerOpts;
     grpc: Record<string, unknown>;
     manual: Record<string, unknown>;
     cron: CronTriggerOpts;
@@ -214,4 +1182,601 @@ export type TriggerConfigMap = {
     sse: SSETriggerOpts;
     websocket: WebSocketTriggerOpts;
 };
-export type AnyTriggerOpts = TriggerOpts | QueueTriggerOpts | PubSubTriggerOpts | WorkerTriggerOpts | CronTriggerOpts | WebhookTriggerOpts | WebSocketTriggerOpts | SSETriggerOpts | Record<string, unknown>;
+/**
+ * Map of trigger name → validation schema. `null` means the trigger does not
+ * have a required configuration shape (currently `grpc` and `manual`).
+ *
+ * Single source of truth for runtime trigger-config validation. Used by
+ * {@link validateTriggerConfig}.
+ */
+export declare const TRIGGER_SCHEMAS: {
+    readonly http: z.ZodEffects<z.ZodObject<{
+        delay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        ttl: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        debounce: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            key: z.ZodString;
+            mode: z.ZodDefault<z.ZodEnum<["leading", "trailing"]>>;
+            delay: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            maxDelay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            mode: "leading" | "trailing";
+            delay: string | number;
+            maxDelay?: string | number | undefined;
+        }, {
+            key: string;
+            delay: string | number;
+            mode?: "leading" | "trailing" | undefined;
+            maxDelay?: string | number | undefined;
+        }>, {
+            key: string;
+            mode: "leading" | "trailing";
+            delay: string | number;
+            maxDelay?: string | number | undefined;
+        }, {
+            key: string;
+            delay: string | number;
+            mode?: "leading" | "trailing" | undefined;
+            maxDelay?: string | number | undefined;
+        }>>;
+        concurrencyKey: z.ZodOptional<z.ZodString>;
+        concurrencyLimit: z.ZodOptional<z.ZodNumber>;
+        concurrencyLeaseMs: z.ZodOptional<z.ZodNumber>;
+        onLimit: z.ZodOptional<z.ZodEnum<["throw", "queue"]>>;
+        concurrencyQueueTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        concurrencyQueueRetry: z.ZodOptional<z.ZodObject<{
+            minBackoffMs: z.ZodOptional<z.ZodNumber>;
+            maxBackoffMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        method: z.ZodEffects<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS", "ANY"]>, "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY", unknown>;
+        path: z.ZodOptional<z.ZodString>;
+        accept: z.ZodDefault<z.ZodString>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        legacyKeyPrefix: z.ZodOptional<z.ZodBoolean>;
+        middleware: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        examples: z.ZodOptional<z.ZodObject<{
+            body: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            body?: unknown;
+        }, {
+            body?: unknown;
+        }>>;
+        recordSample: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY";
+        accept: string;
+        path?: string | undefined;
+        concurrencyKey?: string | undefined;
+        concurrencyLimit?: number | undefined;
+        concurrencyLeaseMs?: number | undefined;
+        onLimit?: "throw" | "queue" | undefined;
+        concurrencyQueueTimeoutMs?: number | undefined;
+        concurrencyQueueRetry?: {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        } | undefined;
+        delay?: string | number | undefined;
+        ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            mode: "leading" | "trailing";
+            delay: string | number;
+            maxDelay?: string | number | undefined;
+        } | undefined;
+        headers?: Record<string, any> | undefined;
+        legacyKeyPrefix?: boolean | undefined;
+        middleware?: string[] | undefined;
+        examples?: {
+            body?: unknown;
+        } | undefined;
+        recordSample?: boolean | undefined;
+    }, {
+        path?: string | undefined;
+        concurrencyKey?: string | undefined;
+        concurrencyLimit?: number | undefined;
+        concurrencyLeaseMs?: number | undefined;
+        onLimit?: "throw" | "queue" | undefined;
+        concurrencyQueueTimeoutMs?: number | undefined;
+        concurrencyQueueRetry?: {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        } | undefined;
+        delay?: string | number | undefined;
+        ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string | number;
+            mode?: "leading" | "trailing" | undefined;
+            maxDelay?: string | number | undefined;
+        } | undefined;
+        method?: unknown;
+        accept?: string | undefined;
+        headers?: Record<string, any> | undefined;
+        legacyKeyPrefix?: boolean | undefined;
+        middleware?: string[] | undefined;
+        examples?: {
+            body?: unknown;
+        } | undefined;
+        recordSample?: boolean | undefined;
+    }>, {
+        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "ANY";
+        accept: string;
+        path?: string | undefined;
+        concurrencyKey?: string | undefined;
+        concurrencyLimit?: number | undefined;
+        concurrencyLeaseMs?: number | undefined;
+        onLimit?: "throw" | "queue" | undefined;
+        concurrencyQueueTimeoutMs?: number | undefined;
+        concurrencyQueueRetry?: {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        } | undefined;
+        delay?: string | number | undefined;
+        ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            mode: "leading" | "trailing";
+            delay: string | number;
+            maxDelay?: string | number | undefined;
+        } | undefined;
+        headers?: Record<string, any> | undefined;
+        legacyKeyPrefix?: boolean | undefined;
+        middleware?: string[] | undefined;
+        examples?: {
+            body?: unknown;
+        } | undefined;
+        recordSample?: boolean | undefined;
+    }, {
+        path?: string | undefined;
+        concurrencyKey?: string | undefined;
+        concurrencyLimit?: number | undefined;
+        concurrencyLeaseMs?: number | undefined;
+        onLimit?: "throw" | "queue" | undefined;
+        concurrencyQueueTimeoutMs?: number | undefined;
+        concurrencyQueueRetry?: {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        } | undefined;
+        delay?: string | number | undefined;
+        ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string | number;
+            mode?: "leading" | "trailing" | undefined;
+            maxDelay?: string | number | undefined;
+        } | undefined;
+        method?: unknown;
+        accept?: string | undefined;
+        headers?: Record<string, any> | undefined;
+        legacyKeyPrefix?: boolean | undefined;
+        middleware?: string[] | undefined;
+        examples?: {
+            body?: unknown;
+        } | undefined;
+        recordSample?: boolean | undefined;
+    }>;
+    readonly queue: z.ZodObject<{
+        provider: z.ZodEnum<["kafka", "rabbitmq", "sqs", "redis", "beanstalk", "nats"]>;
+        topic: z.ZodString;
+        subscription: z.ZodOptional<z.ZodString>;
+        consumerGroup: z.ZodOptional<z.ZodString>;
+        ack: z.ZodDefault<z.ZodBoolean>;
+        deadLetterQueue: z.ZodOptional<z.ZodString>;
+        maxRetries: z.ZodDefault<z.ZodNumber>;
+        retryDelay: z.ZodDefault<z.ZodNumber>;
+        batchSize: z.ZodDefault<z.ZodNumber>;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "kafka" | "rabbitmq" | "sqs" | "redis" | "beanstalk" | "nats";
+        topic: string;
+        ack: boolean;
+        maxRetries: number;
+        retryDelay: number;
+        batchSize: number;
+        concurrency: number;
+        subscription?: string | undefined;
+        consumerGroup?: string | undefined;
+        deadLetterQueue?: string | undefined;
+    }, {
+        provider: "kafka" | "rabbitmq" | "sqs" | "redis" | "beanstalk" | "nats";
+        topic: string;
+        subscription?: string | undefined;
+        consumerGroup?: string | undefined;
+        ack?: boolean | undefined;
+        deadLetterQueue?: string | undefined;
+        maxRetries?: number | undefined;
+        retryDelay?: number | undefined;
+        batchSize?: number | undefined;
+        concurrency?: number | undefined;
+    }>;
+    readonly pubsub: z.ZodObject<{
+        provider: z.ZodOptional<z.ZodEnum<["nats", "redis-streams", "kafka", "gcp", "aws", "azure"]>>;
+        topic: z.ZodString;
+        subscription: z.ZodOptional<z.ZodString>;
+        consumerGroup: z.ZodOptional<z.ZodString>;
+        durable: z.ZodOptional<z.ZodBoolean>;
+        startFrom: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"earliest">, z.ZodLiteral<"latest">, z.ZodObject<{
+            seq: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            seq: number;
+        }, {
+            seq: number;
+        }>, z.ZodObject<{
+            timestamp: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            timestamp: number;
+        }, {
+            timestamp: number;
+        }>]>>;
+        ack: z.ZodDefault<z.ZodBoolean>;
+        maxMessages: z.ZodDefault<z.ZodNumber>;
+        ackDeadline: z.ZodDefault<z.ZodNumber>;
+        deadLetterTopic: z.ZodOptional<z.ZodString>;
+        filter: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        topic: string;
+        ack: boolean;
+        maxMessages: number;
+        ackDeadline: number;
+        filter?: string | undefined;
+        provider?: "kafka" | "nats" | "redis-streams" | "gcp" | "aws" | "azure" | undefined;
+        subscription?: string | undefined;
+        consumerGroup?: string | undefined;
+        durable?: boolean | undefined;
+        startFrom?: "earliest" | "latest" | {
+            seq: number;
+        } | {
+            timestamp: number;
+        } | undefined;
+        deadLetterTopic?: string | undefined;
+    }, {
+        topic: string;
+        filter?: string | undefined;
+        provider?: "kafka" | "nats" | "redis-streams" | "gcp" | "aws" | "azure" | undefined;
+        subscription?: string | undefined;
+        consumerGroup?: string | undefined;
+        ack?: boolean | undefined;
+        durable?: boolean | undefined;
+        startFrom?: "earliest" | "latest" | {
+            seq: number;
+        } | {
+            timestamp: number;
+        } | undefined;
+        maxMessages?: number | undefined;
+        ackDeadline?: number | undefined;
+        deadLetterTopic?: string | undefined;
+    }>;
+    readonly worker: z.ZodEffects<z.ZodObject<{
+        delay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        ttl: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        debounce: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            key: z.ZodString;
+            mode: z.ZodDefault<z.ZodEnum<["leading", "trailing"]>>;
+            delay: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            maxDelay: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            mode: "leading" | "trailing";
+            delay: string | number;
+            maxDelay?: string | number | undefined;
+        }, {
+            key: string;
+            delay: string | number;
+            mode?: "leading" | "trailing" | undefined;
+            maxDelay?: string | number | undefined;
+        }>, {
+            key: string;
+            mode: "leading" | "trailing";
+            delay: string | number;
+            maxDelay?: string | number | undefined;
+        }, {
+            key: string;
+            delay: string | number;
+            mode?: "leading" | "trailing" | undefined;
+            maxDelay?: string | number | undefined;
+        }>>;
+        concurrencyKey: z.ZodOptional<z.ZodString>;
+        concurrencyLimit: z.ZodOptional<z.ZodNumber>;
+        concurrencyLeaseMs: z.ZodOptional<z.ZodNumber>;
+        onLimit: z.ZodOptional<z.ZodEnum<["throw", "queue"]>>;
+        concurrencyQueueTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        concurrencyQueueRetry: z.ZodOptional<z.ZodObject<{
+            minBackoffMs: z.ZodOptional<z.ZodNumber>;
+            maxBackoffMs: z.ZodOptional<z.ZodNumber>;
+            factor: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        }, {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        }>>;
+        queue: z.ZodString;
+        provider: z.ZodOptional<z.ZodEnum<["in-memory", "nats", "bullmq", "kafka", "rabbitmq", "sqs", "redis", "pg-boss"]>>;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        retries: z.ZodDefault<z.ZodNumber>;
+        priority: z.ZodDefault<z.ZodNumber>;
+        consumerGroup: z.ZodOptional<z.ZodString>;
+        ack: z.ZodOptional<z.ZodBoolean>;
+        deadLetterQueue: z.ZodOptional<z.ZodString>;
+        fromBeginning: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        queue: string;
+        concurrency: number;
+        retries: number;
+        priority: number;
+        concurrencyKey?: string | undefined;
+        concurrencyLimit?: number | undefined;
+        concurrencyLeaseMs?: number | undefined;
+        onLimit?: "throw" | "queue" | undefined;
+        concurrencyQueueTimeoutMs?: number | undefined;
+        concurrencyQueueRetry?: {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        } | undefined;
+        delay?: string | number | undefined;
+        ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            mode: "leading" | "trailing";
+            delay: string | number;
+            maxDelay?: string | number | undefined;
+        } | undefined;
+        provider?: "kafka" | "rabbitmq" | "sqs" | "redis" | "nats" | "in-memory" | "bullmq" | "pg-boss" | undefined;
+        consumerGroup?: string | undefined;
+        ack?: boolean | undefined;
+        deadLetterQueue?: string | undefined;
+        timeout?: number | undefined;
+        fromBeginning?: boolean | undefined;
+    }, {
+        queue: string;
+        concurrencyKey?: string | undefined;
+        concurrencyLimit?: number | undefined;
+        concurrencyLeaseMs?: number | undefined;
+        onLimit?: "throw" | "queue" | undefined;
+        concurrencyQueueTimeoutMs?: number | undefined;
+        concurrencyQueueRetry?: {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        } | undefined;
+        delay?: string | number | undefined;
+        ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string | number;
+            mode?: "leading" | "trailing" | undefined;
+            maxDelay?: string | number | undefined;
+        } | undefined;
+        provider?: "kafka" | "rabbitmq" | "sqs" | "redis" | "nats" | "in-memory" | "bullmq" | "pg-boss" | undefined;
+        consumerGroup?: string | undefined;
+        ack?: boolean | undefined;
+        deadLetterQueue?: string | undefined;
+        concurrency?: number | undefined;
+        timeout?: number | undefined;
+        retries?: number | undefined;
+        priority?: number | undefined;
+        fromBeginning?: boolean | undefined;
+    }>, {
+        queue: string;
+        concurrency: number;
+        retries: number;
+        priority: number;
+        concurrencyKey?: string | undefined;
+        concurrencyLimit?: number | undefined;
+        concurrencyLeaseMs?: number | undefined;
+        onLimit?: "throw" | "queue" | undefined;
+        concurrencyQueueTimeoutMs?: number | undefined;
+        concurrencyQueueRetry?: {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        } | undefined;
+        delay?: string | number | undefined;
+        ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            mode: "leading" | "trailing";
+            delay: string | number;
+            maxDelay?: string | number | undefined;
+        } | undefined;
+        provider?: "kafka" | "rabbitmq" | "sqs" | "redis" | "nats" | "in-memory" | "bullmq" | "pg-boss" | undefined;
+        consumerGroup?: string | undefined;
+        ack?: boolean | undefined;
+        deadLetterQueue?: string | undefined;
+        timeout?: number | undefined;
+        fromBeginning?: boolean | undefined;
+    }, {
+        queue: string;
+        concurrencyKey?: string | undefined;
+        concurrencyLimit?: number | undefined;
+        concurrencyLeaseMs?: number | undefined;
+        onLimit?: "throw" | "queue" | undefined;
+        concurrencyQueueTimeoutMs?: number | undefined;
+        concurrencyQueueRetry?: {
+            minBackoffMs?: number | undefined;
+            maxBackoffMs?: number | undefined;
+            factor?: number | undefined;
+        } | undefined;
+        delay?: string | number | undefined;
+        ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string | number;
+            mode?: "leading" | "trailing" | undefined;
+            maxDelay?: string | number | undefined;
+        } | undefined;
+        provider?: "kafka" | "rabbitmq" | "sqs" | "redis" | "nats" | "in-memory" | "bullmq" | "pg-boss" | undefined;
+        consumerGroup?: string | undefined;
+        ack?: boolean | undefined;
+        deadLetterQueue?: string | undefined;
+        concurrency?: number | undefined;
+        timeout?: number | undefined;
+        retries?: number | undefined;
+        priority?: number | undefined;
+        fromBeginning?: boolean | undefined;
+    }>;
+    readonly cron: z.ZodObject<{
+        schedule: z.ZodString;
+        timezone: z.ZodDefault<z.ZodString>;
+        overlap: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        schedule: string;
+        timezone: string;
+        overlap: boolean;
+    }, {
+        schedule: string;
+        timezone?: string | undefined;
+        overlap?: boolean | undefined;
+    }>;
+    readonly webhook: z.ZodObject<{
+        provider: z.ZodOptional<z.ZodEnum<["github", "stripe", "slack", "shopify", "svix"]>>;
+        path: z.ZodOptional<z.ZodString>;
+        events: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        secretEnv: z.ZodOptional<z.ZodString>;
+        signature: z.ZodOptional<z.ZodObject<{
+            scheme: z.ZodDefault<z.ZodEnum<["hmac-sha256", "hmac-sha1", "hmac-sha512"]>>;
+            header: z.ZodString;
+            format: z.ZodDefault<z.ZodString>;
+            secretEnv: z.ZodString;
+            tolerance: z.ZodDefault<z.ZodNumber>;
+            timestampHeader: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            scheme: "hmac-sha256" | "hmac-sha1" | "hmac-sha512";
+            header: string;
+            format: string;
+            secretEnv: string;
+            tolerance: number;
+            timestampHeader?: string | undefined;
+        }, {
+            header: string;
+            secretEnv: string;
+            scheme?: "hmac-sha256" | "hmac-sha1" | "hmac-sha512" | undefined;
+            format?: string | undefined;
+            tolerance?: number | undefined;
+            timestampHeader?: string | undefined;
+        }>>;
+        tolerance: z.ZodOptional<z.ZodNumber>;
+        idempotencyKey: z.ZodOptional<z.ZodString>;
+        namespace: z.ZodOptional<z.ZodString>;
+        middleware: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        path?: string | undefined;
+        middleware?: string[] | undefined;
+        provider?: "github" | "stripe" | "slack" | "shopify" | "svix" | undefined;
+        secretEnv?: string | undefined;
+        tolerance?: number | undefined;
+        events?: string[] | undefined;
+        signature?: {
+            scheme: "hmac-sha256" | "hmac-sha1" | "hmac-sha512";
+            header: string;
+            format: string;
+            secretEnv: string;
+            tolerance: number;
+            timestampHeader?: string | undefined;
+        } | undefined;
+        idempotencyKey?: string | undefined;
+        namespace?: string | undefined;
+    }, {
+        path?: string | undefined;
+        middleware?: string[] | undefined;
+        provider?: "github" | "stripe" | "slack" | "shopify" | "svix" | undefined;
+        secretEnv?: string | undefined;
+        tolerance?: number | undefined;
+        events?: string[] | undefined;
+        signature?: {
+            header: string;
+            secretEnv: string;
+            scheme?: "hmac-sha256" | "hmac-sha1" | "hmac-sha512" | undefined;
+            format?: string | undefined;
+            tolerance?: number | undefined;
+            timestampHeader?: string | undefined;
+        } | undefined;
+        idempotencyKey?: string | undefined;
+        namespace?: string | undefined;
+    }>;
+    readonly sse: z.ZodObject<{
+        events: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        channels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        path: z.ZodOptional<z.ZodString>;
+        maxConnections: z.ZodDefault<z.ZodNumber>;
+        heartbeatInterval: z.ZodDefault<z.ZodNumber>;
+        retryInterval: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        events: string[];
+        maxConnections: number;
+        heartbeatInterval: number;
+        retryInterval: number;
+        path?: string | undefined;
+        channels?: string[] | undefined;
+    }, {
+        path?: string | undefined;
+        events?: string[] | undefined;
+        maxConnections?: number | undefined;
+        heartbeatInterval?: number | undefined;
+        channels?: string[] | undefined;
+        retryInterval?: number | undefined;
+    }>;
+    readonly websocket: z.ZodObject<{
+        events: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        rooms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        path: z.ZodOptional<z.ZodString>;
+        maxConnections: z.ZodDefault<z.ZodNumber>;
+        heartbeatInterval: z.ZodDefault<z.ZodNumber>;
+        messageRateLimit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        events: string[];
+        maxConnections: number;
+        heartbeatInterval: number;
+        messageRateLimit: number;
+        path?: string | undefined;
+        rooms?: string[] | undefined;
+    }, {
+        path?: string | undefined;
+        events?: string[] | undefined;
+        rooms?: string[] | undefined;
+        maxConnections?: number | undefined;
+        heartbeatInterval?: number | undefined;
+        messageRateLimit?: number | undefined;
+    }>;
+    readonly grpc: null;
+    readonly manual: null;
+};
+/** Union of every valid trigger configuration (typed). */
+export type AnyTriggerOpts = HttpTriggerOpts | QueueTriggerOpts | PubSubTriggerOpts | WorkerTriggerOpts | CronTriggerOpts | WebhookTriggerOpts | WebSocketTriggerOpts | SSETriggerOpts | Record<string, unknown>;
+/**
+ * Validate a trigger configuration against the schema for the given trigger
+ * kind. When the trigger has a schema, returns the parsed config (with
+ * defaults applied). When the trigger has no schema (`grpc`, `manual`),
+ * returns the input config (or an empty object when `undefined`).
+ *
+ * Throws when the trigger requires a schema and the config is missing or
+ * invalid. The thrown error is either a `ZodError` (for shape violations) or
+ * a regular `Error` (when config is missing entirely).
+ *
+ * @example
+ *   const cfg = validateTriggerConfig("cron", { schedule: "0 * * * *" });
+ *   // cfg.timezone === "UTC" (default applied)
+ *
+ * @example
+ *   validateTriggerConfig("cron", undefined);
+ *   // throws: 'Trigger "cron" requires a configuration object.'
+ */
+export declare function validateTriggerConfig(name: TriggersEnum, config: unknown): unknown;