mymx 0.3.7 → 0.3.8

package/dist/contract.d.ts

@@ -1,4 +1,4 @@
-import { EmailAddress, EmailReceivedEvent, ParsedDataComplete, ParsedDataFailed, ParsedError, RawContentDownloadOnly, RawContentInline, WEBHOOK_VERSION$1 as WEBHOOK_VERSION, WebhookAttachment } from "./types-C8JlcpcT.js";
+import { EmailAddress, EmailAuth, EmailReceivedEvent, ParsedDataComplete, ParsedDataFailed, ParsedError, RawContentDownloadOnly, RawContentInline, WEBHOOK_VERSION$1 as WEBHOOK_VERSION, WebhookAttachment } from "./types-B5aR2RnG.js";
 import { SignResult, signWebhookPayload$1 as signWebhookPayload } from "./signing-Ecohrukk.js";
 
 //#region src/contract.d.ts
@@ -84,6 +84,8 @@ interface EmailReceivedEventInput {
   attachments_download_url: string | null;
   /** Parsed email content (optional, defaults to failed state) */
   parsed?: ParsedInput;
+  /** Email authentication results (SPF, DKIM, DMARC) */
+  auth: EmailAuth;
 }
 /**
  * Generate a stable event ID for webhook deduplication.
@@ -143,4 +145,4 @@ declare function buildEmailReceivedEvent(input: EmailReceivedEventInput, options
   /** Override attempted_at timestamp (for testing) */
   attempted_at?: string;
 }): EmailReceivedEvent; //#endregion
-export { EmailAddress, EmailReceivedEvent, EmailReceivedEventInput, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedInput, ParsedInputComplete, ParsedInputFailed, RAW_EMAIL_INLINE_THRESHOLD, RawContentDownloadOnly, RawContentInline, SignResult, WEBHOOK_VERSION, WebhookAttachment, buildEmailReceivedEvent, generateEventId, signWebhookPayload };
+export { EmailAddress, EmailAuth, EmailReceivedEvent, EmailReceivedEventInput, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedInput, ParsedInputComplete, ParsedInputFailed, RAW_EMAIL_INLINE_THRESHOLD, RawContentDownloadOnly, RawContentInline, SignResult, WEBHOOK_VERSION, WebhookAttachment, buildEmailReceivedEvent, generateEventId, signWebhookPayload };

package/dist/contract.js

@@ -174,7 +174,8 @@ function buildEmailReceivedEvent(input, options) {
 					expires_at: validateTimestamp(input.download_expires_at, "download_expires_at")
 				}
 			},
-			parsed: parsedData
+			parsed: parsedData,
+			auth: input.auth
 		}
 	};
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AuthConfidence, AuthVerdict, DkimSignature, DkimSignatureResult, DmarcPolicy, DmarcResult, EmailAddress, EmailAuth, EmailReceivedEvent, KnownWebhookEvent, ParsedData, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedStatus, RawContent, RawContentDownloadOnly, RawContentInline, SpfResult, UnknownEvent, ValidateEmailAuthResult, WEBHOOK_VERSION$1 as WEBHOOK_VERSION, WebhookAttachment, WebhookEvent } from "./types-C8JlcpcT.js";
+import { AuthConfidence, AuthVerdict, DkimSignature, DkimSignatureResult, DmarcPolicy, DmarcResult, EmailAddress, EmailAuth, EmailReceivedEvent, KnownWebhookEvent, ParsedData, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedStatus, RawContent, RawContentDownloadOnly, RawContentInline, SpfResult, UnknownEvent, ValidateEmailAuthResult, WEBHOOK_VERSION$1 as WEBHOOK_VERSION, WebhookAttachment, WebhookEvent } from "./types-B5aR2RnG.js";
 import { MYMX_CONFIRMED_HEADER$1 as MYMX_CONFIRMED_HEADER, MYMX_SIGNATURE_HEADER$1 as MYMX_SIGNATURE_HEADER, VerifyOptions, verifyWebhookSignature$1 as verifyWebhookSignature } from "./signing-Ecohrukk.js";
 import { MyMXWebhookError$1 as MyMXWebhookError, PAYLOAD_ERRORS$1 as PAYLOAD_ERRORS, RAW_EMAIL_ERRORS$1 as RAW_EMAIL_ERRORS, RawEmailDecodeError$1 as RawEmailDecodeError, RawEmailDecodeErrorCode, VERIFICATION_ERRORS$1 as VERIFICATION_ERRORS, WebhookErrorCode, WebhookPayloadError$1 as WebhookPayloadError, WebhookPayloadErrorCode, WebhookValidationError$1 as WebhookValidationError, WebhookValidationErrorCode, WebhookVerificationError$1 as WebhookVerificationError, WebhookVerificationErrorCode } from "./errors-CSPHzZB_.js";
 
@@ -173,10 +173,10 @@ declare const emailReceivedEventJsonSchema: {
             };
             readonly auth: {
               readonly $ref: "#/definitions/EmailAuth";
-              readonly description: "Email authentication results (SPF, DKIM, DMARC). May be absent if authentication was not performed.";
+              readonly description: "Email authentication results (SPF, DKIM, DMARC).";
             };
           };
-          readonly required: ["id", "received_at", "smtp", "headers", "content", "parsed"];
+          readonly required: ["id", "received_at", "smtp", "headers", "content", "parsed", "auth"];
           readonly additionalProperties: false;
           readonly description: "The email that triggered this event.";
         };

package/dist/index.js

@@ -1,6 +1,6 @@
 import { MyMXWebhookError, PAYLOAD_ERRORS, RAW_EMAIL_ERRORS, RawEmailDecodeError, VERIFICATION_ERRORS, WEBHOOK_VERSION, WebhookPayloadError, WebhookValidationError, WebhookVerificationError } from "./errors-2CwICC_t.js";
 import { MYMX_CONFIRMED_HEADER, MYMX_SIGNATURE_HEADER, bufferToString, verifyWebhookSignature } from "./signing-kfnmqAcK.js";
-import { validateEmailReceivedEvent } from "./zod-CalKEwR4.js";
+import { validateEmailReceivedEvent } from "./zod-Df95bIDs.js";
 import { createHash } from "node:crypto";
 
 //#region src/schema.generated.ts
@@ -170,7 +170,7 @@ const emailReceivedEventJsonSchema = {
 						},
 						"auth": {
 							"$ref": "#/definitions/EmailAuth",
-							"description": "Email authentication results (SPF, DKIM, DMARC). May be absent if authentication was not performed."
+							"description": "Email authentication results (SPF, DKIM, DMARC)."
 						}
 					},
 					"required": [
@@ -179,7 +179,8 @@ const emailReceivedEventJsonSchema = {
 						"smtp",
 						"headers",
 						"content",
-						"parsed"
+						"parsed",
+						"auth"
 					],
 					"additionalProperties": false,
 					"description": "The email that triggered this event."

package/dist/{types-C8JlcpcT.d.ts → types-B5aR2RnG.d.ts}

@@ -468,9 +468,8 @@ interface EmailReceivedEvent {
     };
     /**
      * Email authentication results (SPF, DKIM, DMARC).
-     * May be absent if authentication was not performed.
      */
-    auth?: EmailAuth;
+    auth: EmailAuth;
   };
 }
 /**
@@ -548,12 +547,10 @@ interface DkimSignature {
  * import { handleWebhook, validateEmailAuth } from 'mymx';
  *
  * const event = handleWebhook({ body, headers, secret });
+ * const result = validateEmailAuth(event.email.auth);
  *
- * if (event.email.auth) {
- *   const result = validateEmailAuth(event.email.auth);
- *   if (result.verdict === 'legit') {
- *     // Email passed authentication
- *   }
+ * if (result.verdict === 'legit') {
+ *   // Email passed authentication
  * }
  * ```
  */

package/dist/{zod-CalKEwR4.js → zod-Df95bIDs.js}

@@ -152,7 +152,7 @@ const emailReceivedEventSchema = z.object({
 		}),
 		parsed: parsedDataSchema,
 		analysis: z.object({ spamassassin: z.object({ score: z.number() }) }).optional(),
-		auth: emailAuthSchema.optional()
+		auth: emailAuthSchema
 	})
 });
 /**

package/dist/zod.d.ts

@@ -1,4 +1,4 @@
-import { EmailReceivedEvent } from "./types-C8JlcpcT.js";
+import { EmailReceivedEvent } from "./types-B5aR2RnG.js";
 import { WebhookValidationError$1 as WebhookValidationError, WebhookValidationErrorCode } from "./errors-CSPHzZB_.js";
 import { z } from "zod";
 
@@ -1006,7 +1006,7 @@ declare const emailReceivedEventSchema: z.ZodObject<{
         score: number;
       };
     }>>;
-    auth: z.ZodOptional<z.ZodObject<{
+    auth: z.ZodObject<{
       spf: z.ZodEnum<["pass", "fail", "softfail", "neutral", "none", "temperror", "permerror"]>;
       dmarc: z.ZodEnum<["pass", "fail", "none", "temperror", "permerror"]>;
       dmarcPolicy: z.ZodNullable<z.ZodEnum<["reject", "quarantine", "none"]>>;
@@ -1071,7 +1071,7 @@ declare const emailReceivedEventSchema: z.ZodObject<{
         keyBits: number | null;
         algo: string;
       }[];
-    }>>;
+    }>;
   }, "strip", z.ZodTypeAny, {
     id: string;
     received_at: string;
@@ -1159,12 +1159,7 @@ declare const emailReceivedEventSchema: z.ZodObject<{
       }[];
       attachments_download_url: null;
     };
-    analysis?: {
-      spamassassin: {
-        score: number;
-      };
-    } | undefined;
-    auth?: {
+    auth: {
       spf: "pass" | "fail" | "softfail" | "neutral" | "none" | "temperror" | "permerror";
       dmarc: "pass" | "fail" | "none" | "temperror" | "permerror";
       dmarcPolicy: "none" | "reject" | "quarantine" | null;
@@ -1181,6 +1176,11 @@ declare const emailReceivedEventSchema: z.ZodObject<{
         keyBits: number | null;
         algo: string;
       }[];
+    };
+    analysis?: {
+      spamassassin: {
+        score: number;
+      };
     } | undefined;
   }, {
     id: string;
@@ -1269,12 +1269,7 @@ declare const emailReceivedEventSchema: z.ZodObject<{
       }[];
       attachments_download_url: null;
     };
-    analysis?: {
-      spamassassin: {
-        score: number;
-      };
-    } | undefined;
-    auth?: {
+    auth: {
       spf: "pass" | "fail" | "softfail" | "neutral" | "none" | "temperror" | "permerror";
       dmarc: "pass" | "fail" | "none" | "temperror" | "permerror";
       dmarcPolicy: "none" | "reject" | "quarantine" | null;
@@ -1291,6 +1286,11 @@ declare const emailReceivedEventSchema: z.ZodObject<{
         keyBits: number | null;
         algo: string;
       }[];
+    };
+    analysis?: {
+      spamassassin: {
+        score: number;
+      };
     } | undefined;
   }>;
 }, "strip", z.ZodTypeAny, {
@@ -1389,12 +1389,7 @@ declare const emailReceivedEventSchema: z.ZodObject<{
       }[];
       attachments_download_url: null;
     };
-    analysis?: {
-      spamassassin: {
-        score: number;
-      };
-    } | undefined;
-    auth?: {
+    auth: {
       spf: "pass" | "fail" | "softfail" | "neutral" | "none" | "temperror" | "permerror";
       dmarc: "pass" | "fail" | "none" | "temperror" | "permerror";
       dmarcPolicy: "none" | "reject" | "quarantine" | null;
@@ -1411,6 +1406,11 @@ declare const emailReceivedEventSchema: z.ZodObject<{
         keyBits: number | null;
         algo: string;
       }[];
+    };
+    analysis?: {
+      spamassassin: {
+        score: number;
+      };
     } | undefined;
   };
 }, {
@@ -1509,12 +1509,7 @@ declare const emailReceivedEventSchema: z.ZodObject<{
       }[];
       attachments_download_url: null;
     };
-    analysis?: {
-      spamassassin: {
-        score: number;
-      };
-    } | undefined;
-    auth?: {
+    auth: {
       spf: "pass" | "fail" | "softfail" | "neutral" | "none" | "temperror" | "permerror";
       dmarc: "pass" | "fail" | "none" | "temperror" | "permerror";
       dmarcPolicy: "none" | "reject" | "quarantine" | null;
@@ -1531,6 +1526,11 @@ declare const emailReceivedEventSchema: z.ZodObject<{
         keyBits: number | null;
         algo: string;
       }[];
+    };
+    analysis?: {
+      spamassassin: {
+        score: number;
+      };
     } | undefined;
   };
 }>;

package/dist/zod.js

@@ -1,4 +1,4 @@
 import { WebhookValidationError } from "./errors-2CwICC_t.js";
-import { dkimSignatureResultSchema, dkimSignatureSchema, dmarcPolicySchema, dmarcResultSchema, emailAddressSchema, emailAuthSchema, emailReceivedEventSchema, parsedDataCompleteSchema, parsedDataFailedSchema, parsedDataSchema, parsedErrorSchema, rawContentDownloadOnlySchema, rawContentInlineSchema, rawContentSchema, safeValidateEmailReceivedEvent, spfResultSchema, validateEmailReceivedEvent, webhookAttachmentSchema } from "./zod-CalKEwR4.js";
+import { dkimSignatureResultSchema, dkimSignatureSchema, dmarcPolicySchema, dmarcResultSchema, emailAddressSchema, emailAuthSchema, emailReceivedEventSchema, parsedDataCompleteSchema, parsedDataFailedSchema, parsedDataSchema, parsedErrorSchema, rawContentDownloadOnlySchema, rawContentInlineSchema, rawContentSchema, safeValidateEmailReceivedEvent, spfResultSchema, validateEmailReceivedEvent, webhookAttachmentSchema } from "./zod-Df95bIDs.js";
 
 export { WebhookValidationError, dkimSignatureResultSchema, dkimSignatureSchema, dmarcPolicySchema, dmarcResultSchema, emailAddressSchema, emailAuthSchema, emailReceivedEventSchema, parsedDataCompleteSchema, parsedDataFailedSchema, parsedDataSchema, parsedErrorSchema, rawContentDownloadOnlySchema, rawContentInlineSchema, rawContentSchema, safeValidateEmailReceivedEvent, spfResultSchema, validateEmailReceivedEvent, webhookAttachmentSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mymx",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Official MyMX Node.js SDK for webhook signature verification",
   "type": "module",
   "module": "./dist/index.js",