@blokjs/helper 0.2.0 → 0.4.0

package/dist/types/TriggerOpts.d.ts

@@ -1,41 +1,620 @@
 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>;
 }, "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;
+}, {
+    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;
+}>, {
+    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;
 }, {
-    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;
 }>;
-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>;
 }, "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;
 }, {
-    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;
+}>, {
+    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;
+}, {
+    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;
 }>;
-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 +625,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 +636,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;
@@ -100,27 +679,154 @@ export declare const PubSubTriggerOptsSchema: z.ZodObject<{
     deadLetterTopic?: string | undefined;
 }>;
 export type PubSubTriggerOpts = z.input<typeof PubSubTriggerOptsSchema>;
-export declare const WorkerTriggerOptsSchema: z.ZodObject<{
+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;
     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>;
 }, "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;
+    timeout?: number | 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;
+    concurrency?: number | undefined;
+    timeout?: number | undefined;
+    retries?: number | undefined;
+    priority?: number | 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;
     timeout?: number | undefined;
-    delay?: number | 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;
     concurrency?: number | undefined;
     timeout?: number | undefined;
     retries?: number | undefined;
     priority?: number | undefined;
-    delay?: number | undefined;
 }>;
 export type WorkerTriggerOpts = z.input<typeof WorkerTriggerOptsSchema>;
 export declare const CronTriggerOptsSchema: z.ZodObject<{
@@ -200,10 +906,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 +927,468 @@ 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>;
+    }, "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;
+    }, {
+        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;
+    }>, {
+        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;
+    }, {
+        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;
+    }>;
+    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.ZodEnum<["gcp", "aws", "azure"]>;
+        topic: z.ZodString;
+        subscription: z.ZodString;
+        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;
+        deadLetterTopic?: string | undefined;
+    }, {
+        provider: "gcp" | "aws" | "azure";
+        topic: string;
+        subscription: string;
+        filter?: string | undefined;
+        ack?: boolean | 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;
+        concurrency: z.ZodDefault<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        retries: z.ZodDefault<z.ZodNumber>;
+        priority: z.ZodDefault<z.ZodNumber>;
+    }, "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;
+        timeout?: number | 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;
+        concurrency?: number | undefined;
+        timeout?: number | undefined;
+        retries?: number | undefined;
+        priority?: number | 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;
+        timeout?: number | 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;
+        concurrency?: number | undefined;
+        timeout?: number | undefined;
+        retries?: number | undefined;
+        priority?: number | 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<{
+        source: z.ZodString;
+        events: z.ZodArray<z.ZodString, "many">;
+        secret: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        events: string[];
+        path?: string | undefined;
+        secret?: string | undefined;
+    }, {
+        source: string;
+        events: string[];
+        path?: string | undefined;
+        secret?: 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;