mymx 0.3.5 → 0.3.6

package/dist/zod-CyQz4zEa.cjs

@@ -1,384 +0,0 @@
-"use strict";
-const require_errors = require('./errors-DOkb_I6u.cjs');
-const zod = require_errors.__toESM(require("zod"));
-
-//#region src/zod.ts
-/** Pattern for valid webhook version (YYYY-MM-DD date format) */
-const VERSION_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
-/**
-* Schema for HTTPS URLs only.
-* Rejects http://, javascript:, data:, file://, etc.
-*/
-const httpsUrlSchema = zod.z.string().url().refine((url) => url.startsWith("https://"), { message: "URL must use HTTPS protocol" });
-/**
-* Schema for SHA-256 hash (64 lowercase hex characters).
-*/
-const sha256Schema = zod.z.string().regex(/^[a-f0-9]{64}$/i, { message: "Must be a valid SHA-256 hash (64 hex characters)" });
-const emailAddressSchema = zod.z.object({
-	address: zod.z.string(),
-	name: zod.z.string().nullable()
-});
-const webhookAttachmentSchema = zod.z.object({
-	filename: zod.z.string().nullable(),
-	content_type: zod.z.string(),
-	size_bytes: zod.z.number().int().nonnegative(),
-	sha256: sha256Schema,
-	part_index: zod.z.number().int().nonnegative(),
-	tar_path: zod.z.string()
-});
-const parsedErrorSchema = zod.z.object({
-	code: zod.z.enum(["PARSE_FAILED", "ATTACHMENT_EXTRACTION_FAILED"]),
-	message: zod.z.string(),
-	retryable: zod.z.boolean()
-});
-const parsedDataCompleteSchema = zod.z.object({
-	status: zod.z.literal("complete"),
-	error: zod.z.null(),
-	body_text: zod.z.string().nullable(),
-	body_html: zod.z.string().nullable(),
-	reply_to: zod.z.array(emailAddressSchema).nullable(),
-	cc: zod.z.array(emailAddressSchema).nullable(),
-	bcc: zod.z.array(emailAddressSchema).nullable(),
-	in_reply_to: zod.z.array(zod.z.string()).nullable(),
-	references: zod.z.array(zod.z.string()).nullable(),
-	attachments: zod.z.array(webhookAttachmentSchema),
-	attachments_download_url: httpsUrlSchema.nullable()
-});
-const parsedDataFailedSchema = zod.z.object({
-	status: zod.z.literal("failed"),
-	error: parsedErrorSchema,
-	body_text: zod.z.null(),
-	body_html: zod.z.null(),
-	reply_to: zod.z.null(),
-	cc: zod.z.null(),
-	bcc: zod.z.null(),
-	in_reply_to: zod.z.null(),
-	references: zod.z.null(),
-	attachments: zod.z.array(webhookAttachmentSchema),
-	attachments_download_url: zod.z.null()
-});
-const parsedDataSchema = zod.z.discriminatedUnion("status", [parsedDataCompleteSchema, parsedDataFailedSchema]);
-const rawContentInlineSchema = zod.z.object({
-	included: zod.z.literal(true),
-	encoding: zod.z.literal("base64"),
-	max_inline_bytes: zod.z.number().int().positive(),
-	size_bytes: zod.z.number().int().nonnegative(),
-	sha256: sha256Schema,
-	data: zod.z.string()
-});
-const rawContentDownloadOnlySchema = zod.z.object({
-	included: zod.z.literal(false),
-	reason_code: zod.z.literal("size_exceeded"),
-	max_inline_bytes: zod.z.number().int().positive(),
-	size_bytes: zod.z.number().int().nonnegative(),
-	sha256: sha256Schema
-});
-const rawContentSchema = zod.z.discriminatedUnion("included", [rawContentInlineSchema, rawContentDownloadOnlySchema]);
-const emailReceivedEventSchema = zod.z.object({
-	id: zod.z.string(),
-	event: zod.z.literal("email.received"),
-	version: zod.z.string().regex(VERSION_PATTERN, { message: "Version must be a date in YYYY-MM-DD format" }),
-	delivery: zod.z.object({
-		endpoint_id: zod.z.string(),
-		attempt: zod.z.number().int().positive(),
-		attempted_at: zod.z.string()
-	}),
-	email: zod.z.object({
-		id: zod.z.string(),
-		received_at: zod.z.string(),
-		smtp: zod.z.object({
-			helo: zod.z.string().nullable(),
-			mail_from: zod.z.string(),
-			rcpt_to: zod.z.array(zod.z.string()).min(1, "At least one recipient is required")
-		}),
-		headers: zod.z.object({
-			message_id: zod.z.string().nullable(),
-			subject: zod.z.string().nullable(),
-			from: zod.z.string(),
-			to: zod.z.string(),
-			date: zod.z.string().nullable()
-		}),
-		content: zod.z.object({
-			raw: rawContentSchema,
-			download: zod.z.object({
-				url: httpsUrlSchema,
-				expires_at: zod.z.string()
-			})
-		}),
-		parsed: parsedDataSchema,
-		analysis: zod.z.object({ spamassassin: zod.z.object({ score: zod.z.number() }) }).optional()
-	})
-});
-/**
-* Human-friendly field descriptions for error messages.
-* Maps field paths to readable descriptions.
-*/
-const FIELD_DESCRIPTIONS = {
-	id: "unique event identifier",
-	event: "event type",
-	version: "API version",
-	delivery: "delivery metadata",
-	"delivery.endpoint_id": "webhook endpoint ID",
-	"delivery.attempt": "delivery attempt number",
-	"delivery.attempted_at": "delivery timestamp",
-	email: "email data",
-	"email.id": "email identifier",
-	"email.received_at": "email received timestamp",
-	"email.smtp": "SMTP envelope data",
-	"email.smtp.helo": "HELO hostname",
-	"email.smtp.mail_from": "sender address (MAIL FROM)",
-	"email.smtp.rcpt_to": "recipient addresses (RCPT TO) - at least one required",
-	"email.headers": "email headers",
-	"email.headers.from": "From header",
-	"email.headers.to": "To header",
-	"email.headers.subject": "email subject",
-	"email.headers.message_id": "Message-ID header",
-	"email.headers.date": "Date header",
-	"email.content": "email content",
-	"email.content.raw": "raw email data",
-	"email.content.raw.data": "raw email content (base64)",
-	"email.content.raw.included": "whether raw content is inline",
-	"email.content.raw.encoding": "raw content encoding",
-	"email.content.raw.size_bytes": "raw email size",
-	"email.content.raw.sha256": "raw email hash",
-	"email.content.raw.max_inline_bytes": "inline size threshold",
-	"email.content.raw.reason_code": "exclusion reason",
-	"email.content.download": "download information",
-	"email.content.download.url": "download URL",
-	"email.content.download.expires_at": "download URL expiration",
-	"email.parsed": "parsed email content",
-	"email.parsed.status": "parsing status",
-	"email.parsed.error": "parsing error details",
-	"email.parsed.body_text": "plain text body",
-	"email.parsed.body_html": "HTML body",
-	"email.parsed.reply_to": "Reply-To addresses",
-	"email.parsed.cc": "CC addresses",
-	"email.parsed.bcc": "BCC addresses",
-	"email.parsed.in_reply_to": "In-Reply-To header",
-	"email.parsed.references": "References header",
-	"email.parsed.attachments": "attachment list",
-	"email.parsed.attachments_download_url": "attachments download URL",
-	"email.analysis": "email analysis results",
-	"email.analysis.spamassassin": "SpamAssassin analysis",
-	"email.analysis.spamassassin.score": "spam score",
-	"email.parsed.attachments.*.filename": "attachment filename",
-	"email.parsed.attachments.*.content_type": "attachment content type",
-	"email.parsed.attachments.*.size_bytes": "attachment size",
-	"email.parsed.attachments.*.sha256": "attachment hash",
-	"email.parsed.attachments.*.part_index": "attachment part index",
-	"email.parsed.attachments.*.tar_path": "attachment tar path",
-	"email.parsed.reply_to.*.address": "email address",
-	"email.parsed.reply_to.*.name": "display name",
-	"email.parsed.cc.*.address": "email address",
-	"email.parsed.cc.*.name": "display name",
-	"email.parsed.bcc.*.address": "email address",
-	"email.parsed.bcc.*.name": "display name",
-	"email.parsed.in_reply_to.*": "In-Reply-To message ID",
-	"email.parsed.references.*": "message reference ID",
-	"email.smtp.rcpt_to.*": "recipient address"
-};
-/**
-* Get field description, handling array indices.
-*/
-function getFieldDescription(path) {
-	if (FIELD_DESCRIPTIONS[path]) return FIELD_DESCRIPTIONS[path];
-	const wildcardPath = path.replace(/\.\d+\./g, ".*.");
-	if (FIELD_DESCRIPTIONS[wildcardPath]) return FIELD_DESCRIPTIONS[wildcardPath];
-	const parentPath = path.replace(/\.\d+$/, "");
-	if (FIELD_DESCRIPTIONS[parentPath]) return `element in ${FIELD_DESCRIPTIONS[parentPath]}`;
-	return void 0;
-}
-/**
-* Format a Zod error into a human-friendly message with actionable suggestion.
-*/
-function formatZodError(error) {
-	const issue = error.issues[0];
-	const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
-	const fieldDesc = getFieldDescription(path);
-	const fieldLabel = fieldDesc ? `${path} (${fieldDesc})` : path;
-	if (issue.path.length === 0 && issue.code === "invalid_type") return {
-		field: "(root)",
-		message: `Expected webhook payload object but received ${issue.received}`,
-		suggestion: issue.received === "undefined" ? "No payload was provided. Make sure you're passing the parsed JSON body." : issue.received === "null" ? "Received null instead of payload object. Did you forget to parse the JSON?" : `Received ${issue.received} instead of object. Webhook payloads must be objects.`
-	};
-	let message;
-	let suggestion;
-	switch (issue.code) {
-		case "invalid_type":
-			if (issue.received === "undefined") {
-				message = `Missing required field: ${fieldLabel}`;
-				suggestion = `The field "${path}" is required but was not provided.`;
-			} else {
-				message = `Invalid type for ${path}: expected ${issue.expected} but got ${issue.received}`;
-				suggestion = `Check that "${path}" is a ${issue.expected}, not a ${issue.received}.`;
-				if (issue.expected === "number" && issue.received === "string") suggestion += " Don't quote numeric values in JSON.";
-			}
-			break;
-		case "invalid_literal":
-			message = `Invalid value for ${path}: expected "${issue.expected}" but got "${issue.received}"`;
-			if (path === "event") suggestion = `This SDK handles "${issue.expected}" events. The webhook sent "${issue.received}" instead.`;
-			else suggestion = `Expected the literal value "${issue.expected}" for ${fieldLabel}.`;
-			break;
-		case "invalid_string":
-			if (path === "version") {
-				message = `Invalid version format: "${issue.received || "unknown"}"`;
-				suggestion = `Version must be a date in YYYY-MM-DD format (e.g., "${require_errors.WEBHOOK_VERSION}").`;
-			} else {
-				message = `Invalid string for ${path}: ${issue.message}`;
-				suggestion = `Check the format of "${path}".`;
-			}
-			break;
-		case "invalid_enum_value":
-			message = `Invalid value for ${path}: got "${issue.received}", expected one of: ${issue.options.join(", ")}`;
-			suggestion = `The ${fieldDesc || path} must be one of: ${issue.options.join(", ")}`;
-			break;
-		case "invalid_union":
-			message = `Invalid value for ${path}: doesn't match any expected format`;
-			suggestion = `Check the structure of "${path}" matches the expected schema.`;
-			break;
-		case "invalid_union_discriminator":
-			message = `Invalid discriminator value for ${path}`;
-			suggestion = "The field used to determine the type variant has an unexpected value. Check the schema documentation.";
-			break;
-		default:
-			message = `Validation failed for ${path}: ${issue.message}`;
-			suggestion = `Check the value of "${path}" in the webhook payload.`;
-	}
-	return {
-		field: path,
-		message,
-		suggestion
-	};
-}
-/**
-* Validate and parse a webhook payload as an EmailReceivedEvent.
-*
-* Uses Zod for comprehensive schema validation. Throws WebhookValidationError
-* with human-friendly messages if validation fails.
-*
-* NOTE: This is the strict validation version. For lightweight parsing without
-* full schema validation, use `parseWebhookEvent` from the main `mymx` export.
-*
-* @param input - The parsed JSON payload (use `JSON.parse(rawBody)`)
-* @returns The validated and typed event
-* @throws WebhookValidationError with actionable message if validation fails
-*
-* @example
-* ```typescript
-* import { validateEmailReceivedEvent, WebhookValidationError } from 'mymx/zod';
-*
-* try {
-*   const event = validateEmailReceivedEvent(JSON.parse(rawBody));
-*   // event is fully validated and typed
-* } catch (err) {
-*   if (err instanceof WebhookValidationError) {
-*     console.error(`[${err.code}] ${err.message}`);
-*     console.error(`Field: ${err.field}`);
-*     console.error(`Suggestion: ${err.suggestion}`);
-*   }
-* }
-* ```
-*/
-function validateEmailReceivedEvent(input) {
-	const result = emailReceivedEventSchema.safeParse(input);
-	if (!result.success) {
-		const { field, message, suggestion } = formatZodError(result.error);
-		throw new require_errors.WebhookValidationError(field, message, suggestion, result.error);
-	}
-	return result.data;
-}
-/**
-* Safely validate a webhook payload, returning a result object instead of throwing.
-*
-* @param input - The parsed JSON payload
-* @returns A Zod SafeParseResult with either the data or error
-*
-* @example
-* ```typescript
-* import { safeValidateEmailReceivedEvent } from 'mymx/zod';
-*
-* const result = safeValidateEmailReceivedEvent(payload);
-* if (result.success) {
-*   console.log('Valid event:', result.data.id);
-* } else {
-*   console.error('Validation failed:', result.error.issues);
-* }
-* ```
-*/
-function safeValidateEmailReceivedEvent(input) {
-	return emailReceivedEventSchema.safeParse(input);
-}
-
-//#endregion
-Object.defineProperty(exports, 'emailAddressSchema', {
-  enumerable: true,
-  get: function () {
-    return emailAddressSchema;
-  }
-});
-Object.defineProperty(exports, 'emailReceivedEventSchema', {
-  enumerable: true,
-  get: function () {
-    return emailReceivedEventSchema;
-  }
-});
-Object.defineProperty(exports, 'parsedDataCompleteSchema', {
-  enumerable: true,
-  get: function () {
-    return parsedDataCompleteSchema;
-  }
-});
-Object.defineProperty(exports, 'parsedDataFailedSchema', {
-  enumerable: true,
-  get: function () {
-    return parsedDataFailedSchema;
-  }
-});
-Object.defineProperty(exports, 'parsedDataSchema', {
-  enumerable: true,
-  get: function () {
-    return parsedDataSchema;
-  }
-});
-Object.defineProperty(exports, 'parsedErrorSchema', {
-  enumerable: true,
-  get: function () {
-    return parsedErrorSchema;
-  }
-});
-Object.defineProperty(exports, 'rawContentDownloadOnlySchema', {
-  enumerable: true,
-  get: function () {
-    return rawContentDownloadOnlySchema;
-  }
-});
-Object.defineProperty(exports, 'rawContentInlineSchema', {
-  enumerable: true,
-  get: function () {
-    return rawContentInlineSchema;
-  }
-});
-Object.defineProperty(exports, 'rawContentSchema', {
-  enumerable: true,
-  get: function () {
-    return rawContentSchema;
-  }
-});
-Object.defineProperty(exports, 'safeValidateEmailReceivedEvent', {
-  enumerable: true,
-  get: function () {
-    return safeValidateEmailReceivedEvent;
-  }
-});
-Object.defineProperty(exports, 'validateEmailReceivedEvent', {
-  enumerable: true,
-  get: function () {
-    return validateEmailReceivedEvent;
-  }
-});
-Object.defineProperty(exports, 'webhookAttachmentSchema', {
-  enumerable: true,
-  get: function () {
-    return webhookAttachmentSchema;
-  }
-});

package/dist/zod.cjs

@@ -1,16 +0,0 @@
-const require_errors = require('./errors-DOkb_I6u.cjs');
-const require_zod = require('./zod-CyQz4zEa.cjs');
-
-exports.WebhookValidationError = require_errors.WebhookValidationError
-exports.emailAddressSchema = require_zod.emailAddressSchema
-exports.emailReceivedEventSchema = require_zod.emailReceivedEventSchema
-exports.parsedDataCompleteSchema = require_zod.parsedDataCompleteSchema
-exports.parsedDataFailedSchema = require_zod.parsedDataFailedSchema
-exports.parsedDataSchema = require_zod.parsedDataSchema
-exports.parsedErrorSchema = require_zod.parsedErrorSchema
-exports.rawContentDownloadOnlySchema = require_zod.rawContentDownloadOnlySchema
-exports.rawContentInlineSchema = require_zod.rawContentInlineSchema
-exports.rawContentSchema = require_zod.rawContentSchema
-exports.safeValidateEmailReceivedEvent = require_zod.safeValidateEmailReceivedEvent
-exports.validateEmailReceivedEvent = require_zod.validateEmailReceivedEvent
-exports.webhookAttachmentSchema = require_zod.webhookAttachmentSchema