@primitivedotdev/sdk 1.7.0 → 1.9.0

package/dist/{index-iZWfb98V.d.ts → index-BDnY9HH-.d.ts}

@@ -1,5 +1,5 @@
-import { I as WebhookEvent, P as ValidateEmailAuthResult, d as EmailAuth, f as EmailReceivedEvent } from "./types-QT2ss9ho.js";
-import { m as ReceivedEmail, u as WebhookValidationError } from "./errors-DyuAXctD.js";
+import { I as WebhookEvent, P as ValidateEmailAuthResult, d as EmailAuth, f as EmailReceivedEvent } from "./types-BjnIxPED.js";
+import { m as ReceivedEmail, u as WebhookValidationError } from "./errors-bXUNXAlf.js";
 
 //#region src/validation.d.ts
 interface ValidationSuccess<T> {
@@ -1454,20 +1454,7 @@ declare const WEBHOOK_VERSION = "2025-12-14";
  * }
  * ```
  */
-declare function parseWebhookEvent(input: unknown): WebhookEvent;
-/**
- * Type guard to check if a webhook event is an EmailReceivedEvent.
- *
- * @example
- * ```typescript
- * const event = parseWebhookEvent(payload);
- * if (isEmailReceivedEvent(event)) {
- *   // TypeScript knows event is EmailReceivedEvent
- *   console.log(event.email.headers.subject);
- * }
- * ```
- */
-declare function isEmailReceivedEvent(event: WebhookEvent | unknown): event is EmailReceivedEvent;
+declare function parseWebhookEvent(input: unknown, eventType?: string | null): WebhookEvent;
 /**
  * Request headers in any common format.
  *
@@ -1505,44 +1492,39 @@ interface HandleWebhookOptions {
   toleranceSeconds?: number;
 }
 /**
- * Verify, parse, and validate a webhook in one call.
+ * The header that names the webhook event for ALL event families
+ * (`email.*`, `payment.*`, `interaction.*`). It is the primary discriminator
+ * the parser keys on, because the stored body is sent verbatim with no envelope.
+ */
+declare const WEBHOOK_EVENT_HEADER = "X-Webhook-Event";
+/**
+ * Read the `X-Webhook-Event` header value (case-insensitive). Returns null when
+ * the header is absent.
+ */
+declare function getEventHeader(headers: WebhookHeaders): string | null;
+/**
+ * Verify, then parse any webhook event into a typed value.
  *
- * This is the recommended way to handle Primitive webhooks. It:
- * 1. Verifies the signature to ensure the webhook is authentic
- * 2. Parses the JSON body
- * 3. Validates the payload against the canonical JSON schema
- * 4. Returns a fully typed EmailReceivedEvent
+ * Unlike {@link handleWebhook}, this returns the full {@link WebhookEvent}
+ * union, so it handles `payment.*` and `interaction.x402.*` events in addition
+ * to `email.*`. The flow is:
  *
- * @param options - The webhook data and secret
- * @returns A validated EmailReceivedEvent
- * @throws {WebhookVerificationError} If signature verification fails
- * @throws {WebhookPayloadError} If JSON parsing fails
- * @throws {WebhookValidationError} If schema validation fails
+ * 1. Verify the signature over the RAW body (works for every event family).
+ * 2. Parse the JSON body.
+ * 3. Classify on the `X-Webhook-Event` HEADER (the primary discriminator),
+ *    returning a typed event for known types and an UnknownEvent for the rest.
  *
  * @example
  * ```typescript
- * import { handleWebhook, PrimitiveWebhookError } from '@primitivedotdev/sdk';
- *
- * app.post('/webhooks/email', express.raw({ type: 'application/json' }), (req, res) => {
- *   try {
- *     const event = handleWebhook({
- *       body: req.body,
- *       headers: req.headers,
- *       secret: process.env.PRIMITIVE_WEBHOOK_SECRET,
- *     });
- *
- *     console.log('Email from:', event.email.headers.from);
- *     res.json({ received: true });
- *   } catch (err) {
- *     if (err instanceof PrimitiveWebhookError) {
- *       console.error(`[${err.code}] ${err.message}`);
- *       return res.status(400).json({ error: err.code });
- *     }
- *     throw err;
- *   }
- * });
+ * const event = handleWebhookEvent({ body, headers, secret });
+ * if (isPaymentSettledEvent(event)) {
+ *   // typed PaymentSettledEvent
+ * } else if (isInteractionX402Event(event)) {
+ *   // typed interaction.x402.* event
+ * }
  * ```
  */
+declare function handleWebhookEvent(options: HandleWebhookOptions): WebhookEvent;
 declare function handleWebhook(options: HandleWebhookOptions): EmailReceivedEvent;
 interface ReceiveRequestOptions {
   secret: string;
@@ -1706,4 +1688,4 @@ declare function decodeRawEmail(event: EmailReceivedEvent, options?: DecodeRawEm
  */
 declare function verifyRawEmailDownload(downloaded: Buffer | ArrayBuffer | Uint8Array, event: EmailReceivedEvent): Buffer;
 //#endregion
-export { VerifyOptions as A, signStandardWebhooksPayload as C, PRIMITIVE_CONFIRMED_HEADER as D, LEGACY_SIGNATURE_HEADER as E, VerifyDownloadTokenResult as F, generateDownloadToken as I, verifyDownloadToken as L, verifyWebhookSignature as M, GenerateDownloadTokenOptions as N, PRIMITIVE_SIGNATURE_HEADER as O, VerifyDownloadTokenOptions as P, safeValidateEmailReceivedEvent as R, StandardWebhooksVerifyOptions as S, LEGACY_CONFIRMED_HEADER as T, emailReceivedEventJsonSchema as _, confirmedHeaders as a, STANDARD_WEBHOOK_TIMESTAMP_HEADER as b, handleWebhook as c, isRawIncluded as d, parseWebhookEvent as f, validateEmailAuth as g, WEBHOOK_VERSION as h, WebhookHeaders as i, signWebhookPayload as j, SignResult as k, isDownloadExpired as l, verifyRawEmailDownload as m, HandleWebhookOptions as n, decodeRawEmail as o, receive as p, ReceiveRequestOptions as r, getDownloadTimeRemaining as s, DecodeRawEmailOptions as t, isEmailReceivedEvent as u, STANDARD_WEBHOOK_ID_HEADER as v, verifyStandardWebhooksSignature as w, StandardWebhooksSignResult as x, STANDARD_WEBHOOK_SIGNATURE_HEADER as y, validateEmailReceivedEvent as z };
+export { PRIMITIVE_SIGNATURE_HEADER as A, safeValidateEmailReceivedEvent as B, StandardWebhooksSignResult as C, LEGACY_CONFIRMED_HEADER as D, verifyStandardWebhooksSignature as E, GenerateDownloadTokenOptions as F, VerifyDownloadTokenOptions as I, VerifyDownloadTokenResult as L, VerifyOptions as M, signWebhookPayload as N, LEGACY_SIGNATURE_HEADER as O, verifyWebhookSignature as P, generateDownloadToken as R, STANDARD_WEBHOOK_TIMESTAMP_HEADER as S, signStandardWebhooksPayload as T, validateEmailReceivedEvent as V, WEBHOOK_VERSION as _, WebhookHeaders as a, STANDARD_WEBHOOK_ID_HEADER as b, getDownloadTimeRemaining as c, handleWebhookEvent as d, isDownloadExpired as f, verifyRawEmailDownload as g, receive as h, WEBHOOK_EVENT_HEADER as i, SignResult as j, PRIMITIVE_CONFIRMED_HEADER as k, getEventHeader as l, parseWebhookEvent as m, HandleWebhookOptions as n, confirmedHeaders as o, isRawIncluded as p, ReceiveRequestOptions as r, decodeRawEmail as s, DecodeRawEmailOptions as t, handleWebhook as u, validateEmailAuth as v, StandardWebhooksVerifyOptions as w, STANDARD_WEBHOOK_SIGNATURE_HEADER as x, emailReceivedEventJsonSchema as y, verifyDownloadToken as z };