mymx 0.3.5 → 0.3.7

package/dist/errors-DOkb_I6u.cjs

@@ -1,318 +0,0 @@
-"use strict";
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-
-//#region src/version.ts
-/**
-* Webhook API Version
-*
-* Single source of truth for the webhook version.
-* Update this file when bumping the API version.
-*/
-/**
-* The current webhook API version this SDK is built for.
-* Webhooks may be sent with different versions - the SDK accepts any valid
-* YYYY-MM-DD formatted version string. Compare against this constant if you
-* need to handle version-specific behavior.
-*/
-const WEBHOOK_VERSION = "2025-12-14";
-
-//#endregion
-//#region src/errors.ts
-/**
-* Verification error definitions.
-* Use these for documentation, dashboards, and i18n.
-*/
-const VERIFICATION_ERRORS = {
-	INVALID_SIGNATURE_HEADER: {
-		message: "Missing or malformed MyMX-Signature header",
-		suggestion: "Check that you're reading the correct header (MyMX-Signature) and it's being passed correctly from your web framework."
-	},
-	TIMESTAMP_OUT_OF_RANGE: {
-		message: "Timestamp is too old (possible replay attack)",
-		suggestion: "This could indicate a replay attack, network delay, or server clock drift. Check your server's time is synced."
-	},
-	SIGNATURE_MISMATCH: {
-		message: "Signature doesn't match expected value",
-		suggestion: "Verify the webhook secret matches and you're using the raw request body (not re-serialized JSON)."
-	},
-	MISSING_SECRET: {
-		message: "No webhook secret was provided",
-		suggestion: "Pass your webhook secret from the MyMX dashboard. Check that the environment variable is set."
-	}
-};
-/**
-* Payload parsing error definitions.
-* Use these for documentation, dashboards, and i18n.
-*/
-const PAYLOAD_ERRORS = {
-	PAYLOAD_NULL: {
-		message: "Webhook payload is null",
-		suggestion: "Ensure you're passing the parsed JSON body, not null. Check your framework's body parsing middleware."
-	},
-	PAYLOAD_UNDEFINED: {
-		message: "Webhook payload is undefined",
-		suggestion: "The payload was not provided. Make sure you're passing the request body to the handler."
-	},
-	PAYLOAD_WRONG_TYPE: {
-		message: "Webhook payload must be an object",
-		suggestion: "The payload should be a parsed JSON object. Check that you're not passing a string or other primitive."
-	},
-	PAYLOAD_IS_ARRAY: {
-		message: "Webhook payload is an array, expected object",
-		suggestion: "MyMX webhooks are single event objects, not arrays. Check the payload structure."
-	},
-	PAYLOAD_MISSING_EVENT: {
-		message: "Webhook payload missing 'event' field",
-		suggestion: "All webhook payloads must have an 'event' field. This may not be a valid MyMX webhook."
-	},
-	PAYLOAD_UNKNOWN_EVENT: {
-		message: "Unknown webhook event type",
-		suggestion: "This event type is not recognized. You may need to update your SDK or handle unknown events gracefully."
-	},
-	PAYLOAD_EMPTY_BODY: {
-		message: "Request body is empty",
-		suggestion: "The request body was empty. Ensure the webhook is sending data and your framework is parsing it correctly."
-	},
-	JSON_PARSE_FAILED: {
-		message: "Failed to parse JSON body",
-		suggestion: "The request body is not valid JSON. Check the raw body content and Content-Type header."
-	},
-	INVALID_ENCODING: {
-		message: "Invalid body encoding",
-		suggestion: "The request body encoding is not supported. MyMX webhooks use UTF-8 encoded JSON."
-	}
-};
-/**
-* Raw email decode error definitions.
-* Use these for documentation, dashboards, and i18n.
-*/
-const RAW_EMAIL_ERRORS = {
-	NOT_INCLUDED: {
-		message: "Raw email content not included inline",
-		suggestion: "Use the download URL at event.email.content.download.url to fetch the raw email."
-	},
-	HASH_MISMATCH: {
-		message: "SHA-256 hash verification failed",
-		suggestion: "The raw email data may be corrupted. Try downloading from the URL instead."
-	}
-};
-/**
-* Base class for all MyMX webhook errors.
-*
-* Catch this to handle any error from the SDK in a single catch block.
-*
-* @example
-* ```typescript
-* import { handleWebhook, MyMXWebhookError } from 'mymx';
-*
-* try {
-*   const event = handleWebhook({ body, signature, secret });
-* } catch (err) {
-*   if (err instanceof MyMXWebhookError) {
-*     console.error(`[${err.code}] ${err.message}`);
-*     return res.status(400).json({ error: err.code });
-*   }
-*   throw err;
-* }
-* ```
-*/
-var MyMXWebhookError = class extends Error {
-	/**
-	* Formats the error for logging/display.
-	*/
-	toString() {
-		return `${this.name} [${this.code}]: ${this.message}\n\nSuggestion: ${this.suggestion}`;
-	}
-	/**
-	* Serializes cleanly for structured logging (Datadog, CloudWatch, etc.)
-	*/
-	toJSON() {
-		return {
-			name: this.name,
-			code: this.code,
-			message: this.message,
-			suggestion: this.suggestion
-		};
-	}
-};
-/**
-* Error thrown when webhook signature verification fails.
-*
-* Use the `code` property to programmatically handle specific error cases.
-*/
-var WebhookVerificationError = class extends MyMXWebhookError {
-	code;
-	suggestion;
-	constructor(code, message, suggestion) {
-		super(message ?? VERIFICATION_ERRORS[code].message);
-		this.name = "WebhookVerificationError";
-		this.code = code;
-		this.suggestion = suggestion ?? VERIFICATION_ERRORS[code].suggestion;
-	}
-};
-/**
-* Error thrown when webhook payload parsing fails (lightweight parser).
-*
-* Use the `code` property for programmatic handling and monitoring.
-* The `suggestion` property contains actionable guidance for fixing the issue.
-*/
-var WebhookPayloadError = class extends MyMXWebhookError {
-	code;
-	suggestion;
-	/** Original error if this wraps another error (e.g., JSON.parse failure) */
-	cause;
-	constructor(code, message, suggestion, cause) {
-		super(message ?? PAYLOAD_ERRORS[code].message);
-		this.name = "WebhookPayloadError";
-		this.code = code;
-		this.suggestion = suggestion ?? PAYLOAD_ERRORS[code].suggestion;
-		this.cause = cause;
-	}
-};
-/**
-* Error thrown when Zod schema validation fails.
-*
-* Wraps ZodError with human-friendly messages and actionable suggestions.
-*/
-var WebhookValidationError = class extends MyMXWebhookError {
-	code = "SCHEMA_VALIDATION_FAILED";
-	suggestion;
-	/** The specific field path that failed (e.g., "email.headers.from") */
-	field;
-	/** Original Zod error for advanced debugging */
-	zodError;
-	/** Number of additional validation errors beyond the first */
-	additionalErrorCount;
-	constructor(field, message, suggestion, zodError) {
-		super(message);
-		this.name = "WebhookValidationError";
-		this.field = field;
-		this.suggestion = suggestion;
-		this.zodError = zodError;
-		this.additionalErrorCount = Math.max(0, zodError.issues.length - 1);
-	}
-	/**
-	* Formats the error for logging/display.
-	* Includes error count and suggestion.
-	*/
-	toString() {
-		let output = `${this.name} [${this.code}]: ${this.message}`;
-		if (this.additionalErrorCount > 0) output += ` (and ${this.additionalErrorCount} more validation error${this.additionalErrorCount > 1 ? "s" : ""})`;
-		output += `\n\nSuggestion: ${this.suggestion}`;
-		return output;
-	}
-	/**
-	* Serializes cleanly for structured logging (Datadog, CloudWatch, etc.)
-	*/
-	toJSON() {
-		return {
-			name: this.name,
-			code: this.code,
-			field: this.field,
-			message: this.message,
-			suggestion: this.suggestion,
-			additionalErrorCount: this.additionalErrorCount
-		};
-	}
-};
-/**
-* Error thrown when raw email decoding or verification fails.
-*
-* Use the `code` property to determine the failure reason:
-* - `NOT_INCLUDED`: Raw email not inline, must download from URL
-* - `HASH_MISMATCH`: SHA-256 verification failed, content may be corrupted
-*/
-var RawEmailDecodeError = class extends MyMXWebhookError {
-	code;
-	suggestion;
-	constructor(code, message) {
-		super(message ?? RAW_EMAIL_ERRORS[code].message);
-		this.name = "RawEmailDecodeError";
-		this.code = code;
-		this.suggestion = RAW_EMAIL_ERRORS[code].suggestion;
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'MyMXWebhookError', {
-  enumerable: true,
-  get: function () {
-    return MyMXWebhookError;
-  }
-});
-Object.defineProperty(exports, 'PAYLOAD_ERRORS', {
-  enumerable: true,
-  get: function () {
-    return PAYLOAD_ERRORS;
-  }
-});
-Object.defineProperty(exports, 'RAW_EMAIL_ERRORS', {
-  enumerable: true,
-  get: function () {
-    return RAW_EMAIL_ERRORS;
-  }
-});
-Object.defineProperty(exports, 'RawEmailDecodeError', {
-  enumerable: true,
-  get: function () {
-    return RawEmailDecodeError;
-  }
-});
-Object.defineProperty(exports, 'VERIFICATION_ERRORS', {
-  enumerable: true,
-  get: function () {
-    return VERIFICATION_ERRORS;
-  }
-});
-Object.defineProperty(exports, 'WEBHOOK_VERSION', {
-  enumerable: true,
-  get: function () {
-    return WEBHOOK_VERSION;
-  }
-});
-Object.defineProperty(exports, 'WebhookPayloadError', {
-  enumerable: true,
-  get: function () {
-    return WebhookPayloadError;
-  }
-});
-Object.defineProperty(exports, 'WebhookValidationError', {
-  enumerable: true,
-  get: function () {
-    return WebhookValidationError;
-  }
-});
-Object.defineProperty(exports, 'WebhookVerificationError', {
-  enumerable: true,
-  get: function () {
-    return WebhookVerificationError;
-  }
-});
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});