@trigger.dev/sdk 3.3.14 → 3.3.16

package/dist/commonjs/imports/uncrypto-cjs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uncrypto-cjs.cjs","sourceRoot":"","sources":["../../../src/imports/uncrypto-cjs.cts"],"names":[],"mappings":";;AAAA,aAAa;AACb,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEvC,aAAa;AACb,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC"}

package/dist/commonjs/imports/uncrypto.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/imports/uncrypto.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-ignore
+const { subtle } = require("uncrypto");
+// @ts-ignore
+module.exports.subtle = subtle;
+//# sourceMappingURL=uncrypto-cjs.cjs.map

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

@@ -11,12 +11,12 @@ export * from "./idempotencyKeys.js";
 export * from "./tags.js";
 export * from "./metadata.js";
 export * from "./timeout.js";
-export * from "./waitUntil.js";
+export * from "./webhooks.js";
 export type { Context };
 import type { Context } from "./shared.js";
 import type { ApiClientConfiguration } from "@trigger.dev/core/v3";
 export type { ApiClientConfiguration };
-export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, logger, type LogLevel, } from "@trigger.dev/core/v3";
+export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, OutOfMemoryError, logger, type LogLevel, } from "@trigger.dev/core/v3";
 export { runs, type RunShape, type AnyRunShape, type TaskRunShape, type RealtimeRun, type AnyRealtimeRun, type RetrieveRunResult, type AnyRetrieveRunResult, } from "./runs.js";
 export * as schedules from "./schedules/index.js";
 export * as envvars from "./envvars.js";

package/dist/commonjs/v3/index.js

@@ -26,7 +26,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.auth = exports.configure = exports.envvars = exports.schedules = exports.runs = exports.logger = exports.AbortTaskRunError = exports.UnprocessableEntityError = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.ConflictError = exports.BadRequestError = exports.AuthenticationError = exports.ApiError = exports.queue = exports.retry = void 0;
+exports.auth = exports.configure = exports.envvars = exports.schedules = exports.runs = exports.logger = exports.OutOfMemoryError = exports.AbortTaskRunError = exports.UnprocessableEntityError = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.ConflictError = exports.BadRequestError = exports.AuthenticationError = exports.ApiError = exports.queue = exports.retry = void 0;
 __exportStar(require("./cache.js"), exports);
 __exportStar(require("./config.js"), exports);
 var retry_js_1 = require("./retry.js");
@@ -42,7 +42,7 @@ __exportStar(require("./idempotencyKeys.js"), exports);
 __exportStar(require("./tags.js"), exports);
 __exportStar(require("./metadata.js"), exports);
 __exportStar(require("./timeout.js"), exports);
-__exportStar(require("./waitUntil.js"), exports);
+__exportStar(require("./webhooks.js"), exports);
 var v3_1 = require("@trigger.dev/core/v3");
 Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return v3_1.ApiError; } });
 Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return v3_1.AuthenticationError; } });
@@ -54,6 +54,7 @@ Object.defineProperty(exports, "PermissionDeniedError", { enumerable: true, get:
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return v3_1.RateLimitError; } });
 Object.defineProperty(exports, "UnprocessableEntityError", { enumerable: true, get: function () { return v3_1.UnprocessableEntityError; } });
 Object.defineProperty(exports, "AbortTaskRunError", { enumerable: true, get: function () { return v3_1.AbortTaskRunError; } });
+Object.defineProperty(exports, "OutOfMemoryError", { enumerable: true, get: function () { return v3_1.OutOfMemoryError; } });
 Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return v3_1.logger; } });
 var runs_js_1 = require("./runs.js");
 Object.defineProperty(exports, "runs", { enumerable: true, get: function () { return runs_js_1.runs; } });

package/dist/commonjs/v3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,uCAAsD;AAA7C,iGAAA,KAAK,OAAA;AACd,yCAAoC;AAA3B,kGAAA,KAAK,OAAA;AACd,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,uDAAqC;AACrC,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,iDAA+B;AAS/B,2CAa8B;AAZ5B,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,mGAAA,aAAa,OAAA;AACb,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,2GAAA,qBAAqB,OAAA;AACrB,oGAAA,cAAc,OAAA;AACd,8GAAA,wBAAwB,OAAA;AACxB,uGAAA,iBAAiB,OAAA;AACjB,4FAAA,MAAM,OAAA;AAIR,qCASmB;AARjB,+FAAA,IAAI,OAAA;AASN,kEAAkD;AAClD,wDAAwC;AAGxC,qCAA4C;AAAnC,oGAAA,SAAS,OAAA;AAAE,+FAAA,IAAI,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,uCAAsD;AAA7C,iGAAA,KAAK,OAAA;AACd,yCAAoC;AAA3B,kGAAA,KAAK,OAAA;AACd,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,uDAAqC;AACrC,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAS9B,2CAc8B;AAb5B,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,mGAAA,aAAa,OAAA;AACb,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,2GAAA,qBAAqB,OAAA;AACrB,oGAAA,cAAc,OAAA;AACd,8GAAA,wBAAwB,OAAA;AACxB,uGAAA,iBAAiB,OAAA;AACjB,sGAAA,gBAAgB,OAAA;AAChB,4FAAA,MAAM,OAAA;AAIR,qCASmB;AARjB,+FAAA,IAAI,OAAA;AASN,kEAAkD;AAClD,wDAAwC;AAGxC,qCAA4C;AAAnC,oGAAA,SAAS,OAAA;AAAE,+FAAA,IAAI,OAAA"}

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

@@ -0,0 +1,47 @@
+import { Webhook } from "@trigger.dev/core/v3";
+/**
+ * The type of error thrown when a webhook fails to parse or verify
+ */
+export declare class WebhookError extends Error {
+    constructor(message: string);
+}
+/**
+ * Options for constructing a webhook event
+ */
+type ConstructEventOptions = {
+    /** Raw payload as string or Buffer */
+    payload: string | Buffer;
+    /** Signature header as string, Buffer, or string array */
+    header: string | Buffer | Array<string>;
+};
+/**
+ * Interface describing the webhook utilities
+ */
+interface Webhooks {
+    /**
+     * Constructs and validates a webhook event from an incoming request
+     * @param request - Either a Request object or ConstructEventOptions containing the payload and signature
+     * @param secret - Secret key used to verify the webhook signature
+     * @returns Promise resolving to a validated AlertWebhook object
+     * @throws {WebhookError} If validation fails or payload can't be parsed
+     *
+     * @example
+     * // Using with Request object
+     * const event = await webhooks.constructEvent(request, "webhook_secret");
+     *
+     * @example
+     * // Using with manual options
+     * const event = await webhooks.constructEvent({
+     *   payload: rawBody,
+     *   header: signatureHeader
+     * }, "webhook_secret");
+     */
+    constructEvent(request: ConstructEventOptions | Request, secret: string): Promise<Webhook>;
+    /** Header name used for webhook signatures */
+    SIGNATURE_HEADER_NAME: string;
+}
+/**
+ * Webhook utilities for handling incoming webhook requests
+ */
+export declare const webhooks: Webhooks;
+export {};

package/dist/commonjs/v3/webhooks.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webhooks = exports.WebhookError = void 0;
+const v3_1 = require("@trigger.dev/core/v3");
+const uncrypto_js_1 = require("../imports/uncrypto.js");
+/**
+ * The type of error thrown when a webhook fails to parse or verify
+ */
+class WebhookError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebhookError";
+    }
+}
+exports.WebhookError = WebhookError;
+/** Header name used for webhook signatures */
+const SIGNATURE_HEADER_NAME = "x-trigger-signature-hmacsha256";
+/**
+ * Webhook utilities for handling incoming webhook requests
+ */
+exports.webhooks = {
+    constructEvent,
+    SIGNATURE_HEADER_NAME,
+};
+async function constructEvent(request, secret) {
+    let payload;
+    let signature;
+    if (request instanceof Request) {
+        if (!secret) {
+            throw new WebhookError("Secret is required when passing a Request object");
+        }
+        const signatureHeader = request.headers.get(SIGNATURE_HEADER_NAME);
+        if (!signatureHeader) {
+            throw new WebhookError("No signature header found");
+        }
+        signature = signatureHeader;
+        payload = await request.text();
+    }
+    else {
+        payload = request.payload.toString();
+        if (Array.isArray(request.header)) {
+            throw new WebhookError("Signature header cannot be an array");
+        }
+        signature = request.header.toString();
+    }
+    // Verify the signature
+    const isValid = await verifySignature(payload, signature, secret);
+    if (!isValid) {
+        throw new WebhookError("Invalid signature");
+    }
+    // Parse and validate the payload
+    try {
+        const jsonPayload = JSON.parse(payload);
+        const parsedPayload = v3_1.Webhook.parse(jsonPayload);
+        return parsedPayload;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new WebhookError(`Webhook parsing failed: ${error.message}`);
+        }
+        throw new WebhookError("Webhook parsing failed");
+    }
+}
+/**
+ * Verifies the signature of a webhook payload
+ * @param payload - Raw payload string to verify
+ * @param signature - Expected signature to check against
+ * @param secret - Secret key used to generate the signature
+ * @returns Promise resolving to boolean indicating if signature is valid
+ * @throws {WebhookError} If signature verification process fails
+ *
+ * @example
+ * const isValid = await verifySignature(
+ *   '{"event": "test"}',
+ *   "abc123signature",
+ *   "webhook_secret"
+ * );
+ */
+async function verifySignature(payload, signature, secret) {
+    try {
+        if (!secret) {
+            throw new WebhookError("Secret is required for signature verification");
+        }
+        // Convert the payload and secret to buffers
+        const hashPayload = Buffer.from(payload, "utf-8");
+        const hmacSecret = Buffer.from(secret, "utf-8");
+        // Import the secret key
+        const key = await uncrypto_js_1.subtle.importKey("raw", hmacSecret, { name: "HMAC", hash: "SHA-256" }, false, ["sign", "verify"]);
+        // Calculate the expected signature
+        const actualSignature = await uncrypto_js_1.subtle.sign("HMAC", key, hashPayload);
+        const actualSignatureHex = Buffer.from(actualSignature).toString("hex");
+        // Compare signatures using timing-safe comparison
+        return timingSafeEqual(signature, actualSignatureHex);
+    }
+    catch (error) {
+        throw new WebhookError("Signature verification failed");
+    }
+}
+// Timing-safe comparison to prevent timing attacks
+function timingSafeEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    let result = 0;
+    for (let i = 0; i < a.length; i++) {
+        result |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    }
+    return result === 0;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/commonjs/v3/webhooks.js.map

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

package/dist/commonjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = "3.3.14";
+exports.VERSION = "3.3.16";
 //# sourceMappingURL=version.js.map

package/dist/esm/imports/uncrypto.d.ts

@@ -0,0 +1,2 @@
+import { subtle } from "uncrypto";
+export { subtle };

package/dist/esm/imports/uncrypto.js

@@ -0,0 +1,5 @@
+// @ts-ignore
+import { subtle } from "uncrypto";
+// @ts-ignore
+export { subtle };
+//# sourceMappingURL=uncrypto.js.map

package/dist/esm/imports/uncrypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uncrypto.js","sourceRoot":"","sources":["../../../src/imports/uncrypto.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,aAAa;AACb,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/esm/v3/index.d.ts

@@ -11,12 +11,12 @@ export * from "./idempotencyKeys.js";
 export * from "./tags.js";
 export * from "./metadata.js";
 export * from "./timeout.js";
-export * from "./waitUntil.js";
+export * from "./webhooks.js";
 export type { Context };
 import type { Context } from "./shared.js";
 import type { ApiClientConfiguration } from "@trigger.dev/core/v3";
 export type { ApiClientConfiguration };
-export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, logger, type LogLevel, } from "@trigger.dev/core/v3";
+export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, OutOfMemoryError, logger, type LogLevel, } from "@trigger.dev/core/v3";
 export { runs, type RunShape, type AnyRunShape, type TaskRunShape, type RealtimeRun, type AnyRealtimeRun, type RetrieveRunResult, type AnyRetrieveRunResult, } from "./runs.js";
 export * as schedules from "./schedules/index.js";
 export * as envvars from "./envvars.js";

package/dist/esm/v3/index.js

@@ -11,8 +11,8 @@ export * from "./idempotencyKeys.js";
 export * from "./tags.js";
 export * from "./metadata.js";
 export * from "./timeout.js";
-export * from "./waitUntil.js";
-export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, logger, } from "@trigger.dev/core/v3";
+export * from "./webhooks.js";
+export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, OutOfMemoryError, logger, } from "@trigger.dev/core/v3";
 export { runs, } from "./runs.js";
 export * as schedules from "./schedules/index.js";
 export * as envvars from "./envvars.js";

package/dist/esm/v3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAS/B,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,MAAM,GAEP,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,IAAI,GAQL,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAS9B,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,GAEP,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,IAAI,GAQL,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/v3/webhooks.d.ts

@@ -0,0 +1,47 @@
+import { Webhook } from "@trigger.dev/core/v3";
+/**
+ * The type of error thrown when a webhook fails to parse or verify
+ */
+export declare class WebhookError extends Error {
+    constructor(message: string);
+}
+/**
+ * Options for constructing a webhook event
+ */
+type ConstructEventOptions = {
+    /** Raw payload as string or Buffer */
+    payload: string | Buffer;
+    /** Signature header as string, Buffer, or string array */
+    header: string | Buffer | Array<string>;
+};
+/**
+ * Interface describing the webhook utilities
+ */
+interface Webhooks {
+    /**
+     * Constructs and validates a webhook event from an incoming request
+     * @param request - Either a Request object or ConstructEventOptions containing the payload and signature
+     * @param secret - Secret key used to verify the webhook signature
+     * @returns Promise resolving to a validated AlertWebhook object
+     * @throws {WebhookError} If validation fails or payload can't be parsed
+     *
+     * @example
+     * // Using with Request object
+     * const event = await webhooks.constructEvent(request, "webhook_secret");
+     *
+     * @example
+     * // Using with manual options
+     * const event = await webhooks.constructEvent({
+     *   payload: rawBody,
+     *   header: signatureHeader
+     * }, "webhook_secret");
+     */
+    constructEvent(request: ConstructEventOptions | Request, secret: string): Promise<Webhook>;
+    /** Header name used for webhook signatures */
+    SIGNATURE_HEADER_NAME: string;
+}
+/**
+ * Webhook utilities for handling incoming webhook requests
+ */
+export declare const webhooks: Webhooks;
+export {};

package/dist/esm/v3/webhooks.js

@@ -0,0 +1,106 @@
+import { Webhook } from "@trigger.dev/core/v3";
+import { subtle } from "../imports/uncrypto.js";
+/**
+ * The type of error thrown when a webhook fails to parse or verify
+ */
+export class WebhookError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebhookError";
+    }
+}
+/** Header name used for webhook signatures */
+const SIGNATURE_HEADER_NAME = "x-trigger-signature-hmacsha256";
+/**
+ * Webhook utilities for handling incoming webhook requests
+ */
+export const webhooks = {
+    constructEvent,
+    SIGNATURE_HEADER_NAME,
+};
+async function constructEvent(request, secret) {
+    let payload;
+    let signature;
+    if (request instanceof Request) {
+        if (!secret) {
+            throw new WebhookError("Secret is required when passing a Request object");
+        }
+        const signatureHeader = request.headers.get(SIGNATURE_HEADER_NAME);
+        if (!signatureHeader) {
+            throw new WebhookError("No signature header found");
+        }
+        signature = signatureHeader;
+        payload = await request.text();
+    }
+    else {
+        payload = request.payload.toString();
+        if (Array.isArray(request.header)) {
+            throw new WebhookError("Signature header cannot be an array");
+        }
+        signature = request.header.toString();
+    }
+    // Verify the signature
+    const isValid = await verifySignature(payload, signature, secret);
+    if (!isValid) {
+        throw new WebhookError("Invalid signature");
+    }
+    // Parse and validate the payload
+    try {
+        const jsonPayload = JSON.parse(payload);
+        const parsedPayload = Webhook.parse(jsonPayload);
+        return parsedPayload;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new WebhookError(`Webhook parsing failed: ${error.message}`);
+        }
+        throw new WebhookError("Webhook parsing failed");
+    }
+}
+/**
+ * Verifies the signature of a webhook payload
+ * @param payload - Raw payload string to verify
+ * @param signature - Expected signature to check against
+ * @param secret - Secret key used to generate the signature
+ * @returns Promise resolving to boolean indicating if signature is valid
+ * @throws {WebhookError} If signature verification process fails
+ *
+ * @example
+ * const isValid = await verifySignature(
+ *   '{"event": "test"}',
+ *   "abc123signature",
+ *   "webhook_secret"
+ * );
+ */
+async function verifySignature(payload, signature, secret) {
+    try {
+        if (!secret) {
+            throw new WebhookError("Secret is required for signature verification");
+        }
+        // Convert the payload and secret to buffers
+        const hashPayload = Buffer.from(payload, "utf-8");
+        const hmacSecret = Buffer.from(secret, "utf-8");
+        // Import the secret key
+        const key = await subtle.importKey("raw", hmacSecret, { name: "HMAC", hash: "SHA-256" }, false, ["sign", "verify"]);
+        // Calculate the expected signature
+        const actualSignature = await subtle.sign("HMAC", key, hashPayload);
+        const actualSignatureHex = Buffer.from(actualSignature).toString("hex");
+        // Compare signatures using timing-safe comparison
+        return timingSafeEqual(signature, actualSignatureHex);
+    }
+    catch (error) {
+        throw new WebhookError("Signature verification failed");
+    }
+}
+// Timing-safe comparison to prevent timing attacks
+function timingSafeEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    let result = 0;
+    for (let i = 0; i < a.length; i++) {
+        result |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    }
+    return result === 0;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/esm/v3/webhooks.js.map

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

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "3.3.14";
+export const VERSION = "3.3.16";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trigger.dev/sdk",
-  "version": "3.3.14",
+  "version": "3.3.16",
   "description": "trigger.dev Node.JS SDK",
   "license": "MIT",
   "publishConfig": {
@@ -40,7 +40,7 @@
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/api-logs": "0.52.1",
     "@opentelemetry/semantic-conventions": "1.25.1",
-    "@trigger.dev/core": "3.3.14",
+    "@trigger.dev/core": "3.3.16",
     "chalk": "^5.2.0",
     "cronstrue": "^2.21.0",
     "debug": "^4.3.4",
@@ -48,6 +48,7 @@
     "slug": "^6.0.0",
     "terminal-link": "^3.0.0",
     "ulid": "^2.3.0",
+    "uncrypto": "^0.1.3",
     "uuid": "^9.0.0",
     "ws": "^8.11.0"
   },