@bernierllc/email-sender 3.0.3 → 3.1.0

package/dist/errors.js

@@ -0,0 +1,176 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutError = exports.NetworkError = exports.RateLimitError = exports.ProviderError = exports.EmailValidationError = exports.EmailSenderError = exports.EmailSenderErrorCode = void 0;
+/**
+ * Email sender error classes with ES2022 Error.cause support
+ *
+ * These errors follow the error propagation standard defined in:
+ * plans/standards/error-propagation-standard.md
+ */
+/**
+ * Error codes for programmatic error handling
+ */
+exports.EmailSenderErrorCode = {
+    // Provider errors
+    PROVIDER_ERROR: 'PROVIDER_ERROR',
+    PROVIDER_AUTH_ERROR: 'PROVIDER_AUTH_ERROR',
+    PROVIDER_RATE_LIMITED: 'PROVIDER_RATE_LIMITED',
+    PROVIDER_UNAVAILABLE: 'PROVIDER_UNAVAILABLE',
+    // Validation errors
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    INVALID_EMAIL: 'INVALID_EMAIL',
+    INVALID_TEMPLATE: 'INVALID_TEMPLATE',
+    // Template errors
+    TEMPLATE_NOT_FOUND: 'TEMPLATE_NOT_FOUND',
+    TEMPLATE_UNAUTHORIZED: 'TEMPLATE_UNAUTHORIZED',
+    TEMPLATE_CONFLICT: 'TEMPLATE_CONFLICT',
+    // Network errors
+    NETWORK_ERROR: 'NETWORK_ERROR',
+    TIMEOUT_ERROR: 'TIMEOUT_ERROR',
+    // General errors
+    SEND_ERROR: 'SEND_ERROR',
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR',
+};
+/**
+ * Base error class for all email sender errors
+ *
+ * Supports ES2022 Error.cause for error chaining.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await sendGridClient.send(email);
+ * } catch (error) {
+ *   throw new EmailSenderError('Failed to send email via SendGrid', {
+ *     cause: error,
+ *     code: 'PROVIDER_ERROR',
+ *     context: { provider: 'sendgrid', to: email.to }
+ *   });
+ * }
+ * ```
+ */
+class EmailSenderError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.name = 'EmailSenderError';
+        this.code = options?.code ?? exports.EmailSenderErrorCode.UNKNOWN_ERROR;
+        this.context = options?.context;
+        this.retryable = options?.retryable ?? false;
+        this.retryAfter = options?.retryAfter;
+        // Set cause using ES2022 pattern (works at runtime in Node 16.9+)
+        if (options?.cause) {
+            this.cause = options.cause;
+        }
+        // Maintains proper stack trace in V8 engines
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+    /**
+     * Check if the error or any error in its cause chain is retryable
+     */
+    isRetryable() {
+        if (this.retryable)
+            return true;
+        // Check cause chain
+        let current = this.cause;
+        while (current instanceof Error) {
+            if ('retryable' in current && current.retryable === true) {
+                return true;
+            }
+            current = current.cause;
+        }
+        return false;
+    }
+    /**
+     * Get retry timing from this error or its cause chain
+     */
+    getRetryAfter() {
+        if (this.retryAfter !== undefined)
+            return this.retryAfter;
+        // Check cause chain
+        let current = this.cause;
+        while (current instanceof Error) {
+            if ('retryAfter' in current && typeof current.retryAfter === 'number') {
+                return current.retryAfter;
+            }
+            current = current.cause;
+        }
+        return undefined;
+    }
+}
+exports.EmailSenderError = EmailSenderError;
+/**
+ * Error thrown when email validation fails
+ */
+class EmailValidationError extends EmailSenderError {
+    constructor(message, options) {
+        super(message, { ...options, code: exports.EmailSenderErrorCode.VALIDATION_ERROR });
+        this.name = 'EmailValidationError';
+    }
+}
+exports.EmailValidationError = EmailValidationError;
+/**
+ * Error thrown when a provider operation fails
+ */
+class ProviderError extends EmailSenderError {
+    constructor(message, options) {
+        super(message, { ...options, code: options?.code ?? exports.EmailSenderErrorCode.PROVIDER_ERROR });
+        this.name = 'ProviderError';
+        this.statusCode = options?.statusCode;
+        this.providerResponse = options?.providerResponse;
+    }
+}
+exports.ProviderError = ProviderError;
+/**
+ * Error thrown when rate limited by a provider
+ */
+class RateLimitError extends EmailSenderError {
+    constructor(message, options) {
+        const baseOptions = {
+            ...options,
+            code: exports.EmailSenderErrorCode.PROVIDER_RATE_LIMITED,
+            retryable: true,
+        };
+        if (options?.retryAfter !== undefined) {
+            baseOptions.retryAfter = options.retryAfter;
+        }
+        super(message, baseOptions);
+        this.name = 'RateLimitError';
+    }
+}
+exports.RateLimitError = RateLimitError;
+/**
+ * Error thrown when network communication fails
+ */
+class NetworkError extends EmailSenderError {
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            code: exports.EmailSenderErrorCode.NETWORK_ERROR,
+            retryable: true, // Network errors are generally retryable
+        });
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Error thrown when a request times out
+ */
+class TimeoutError extends EmailSenderError {
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            code: exports.EmailSenderErrorCode.TIMEOUT_ERROR,
+            retryable: true,
+        });
+        this.name = 'TimeoutError';
+    }
+}
+exports.TimeoutError = TimeoutError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -3,14 +3,18 @@
  * Main entry point for the email sending system
  */
 export * from './types';
-export { EmailSender } from './core/email-sender';
+export { EmailSender, EmailSenderConfig } from './core/email-sender';
+export { EmailSafetyManager } from './core/email-safety-manager';
 export { EmailProvider } from './providers/base';
 export { SmtpProvider } from './providers/smtp';
 export { SendGridProvider } from './providers/sendgrid';
 export { SesProvider } from './providers/ses';
 export { MailgunProvider } from './providers/mailgun';
 export { PostmarkProvider } from './providers/postmark';
-export type { EmailMessage, SendResult, DeliveryStatus, WebhookEvent, EmailProviderConfig, EmailProviderCapabilities, EmailValidationResult, EmailAttachment, BatchEmailOptions, EmailTemplate } from './types';
+export type { EmailMessage, SendResult, DeliveryStatus, WebhookEvent, EmailProviderConfig, EmailProviderCapabilities, EmailValidationResult, EmailAttachment, BatchEmailOptions, EmailTemplate, StagingSafetyConfig, EmailSafetyResult } from './types';
+export { EmailSenderError, EmailSenderErrorCode, EmailValidationError, ProviderError, RateLimitError, NetworkError, TimeoutError, } from './errors';
+export type { EmailSenderErrorOptions, EmailSenderErrorCodeType, } from './errors';
 export type { VerifiedSender, SenderValidationResult, Template, ProviderTemplate, TemplateVersion, SyncResult, TemplateAnalytics, SendGridAdvancedConfig } from './providers/sendgrid/types';
-export { SendGridApiError, TemplateNotFoundError, UnauthorizedTemplateAccessError, TemplateConflictError, RateLimitError } from './providers/sendgrid/errors';
+export { SendGridApiError, TemplateNotFoundError, UnauthorizedTemplateAccessError, TemplateConflictError, SendGridRateLimitError, SendGridErrorCode, } from './providers/sendgrid/errors';
+export type { SendGridErrorCodeType } from './providers/sendgrid/errors';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACd,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,cAAc,EACf,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -21,7 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RateLimitError = exports.TemplateConflictError = exports.UnauthorizedTemplateAccessError = exports.TemplateNotFoundError = exports.SendGridApiError = exports.PostmarkProvider = exports.MailgunProvider = exports.SesProvider = exports.SendGridProvider = exports.SmtpProvider = exports.EmailProvider = exports.EmailSender = void 0;
+exports.SendGridErrorCode = exports.SendGridRateLimitError = exports.TemplateConflictError = exports.UnauthorizedTemplateAccessError = exports.TemplateNotFoundError = exports.SendGridApiError = exports.TimeoutError = exports.NetworkError = exports.RateLimitError = exports.ProviderError = exports.EmailValidationError = exports.EmailSenderErrorCode = exports.EmailSenderError = exports.PostmarkProvider = exports.MailgunProvider = exports.SesProvider = exports.SendGridProvider = exports.SmtpProvider = exports.EmailProvider = exports.EmailSafetyManager = exports.EmailSender = void 0;
 /**
  * Email Sender - Core Library
  * Main entry point for the email sending system
@@ -31,6 +31,8 @@ __exportStar(require("./types"), exports);
 // Core classes
 var email_sender_1 = require("./core/email-sender");
 Object.defineProperty(exports, "EmailSender", { enumerable: true, get: function () { return email_sender_1.EmailSender; } });
+var email_safety_manager_1 = require("./core/email-safety-manager");
+Object.defineProperty(exports, "EmailSafetyManager", { enumerable: true, get: function () { return email_safety_manager_1.EmailSafetyManager; } });
 // Provider classes
 var base_1 = require("./providers/base");
 Object.defineProperty(exports, "EmailProvider", { enumerable: true, get: function () { return base_1.EmailProvider; } });
@@ -44,10 +46,21 @@ var mailgun_1 = require("./providers/mailgun");
 Object.defineProperty(exports, "MailgunProvider", { enumerable: true, get: function () { return mailgun_1.MailgunProvider; } });
 var postmark_1 = require("./providers/postmark");
 Object.defineProperty(exports, "PostmarkProvider", { enumerable: true, get: function () { return postmark_1.PostmarkProvider; } });
-var errors_1 = require("./providers/sendgrid/errors");
-Object.defineProperty(exports, "SendGridApiError", { enumerable: true, get: function () { return errors_1.SendGridApiError; } });
-Object.defineProperty(exports, "TemplateNotFoundError", { enumerable: true, get: function () { return errors_1.TemplateNotFoundError; } });
-Object.defineProperty(exports, "UnauthorizedTemplateAccessError", { enumerable: true, get: function () { return errors_1.UnauthorizedTemplateAccessError; } });
-Object.defineProperty(exports, "TemplateConflictError", { enumerable: true, get: function () { return errors_1.TemplateConflictError; } });
+// Error classes and types (v3.1.0 - Error propagation standard)
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "EmailSenderError", { enumerable: true, get: function () { return errors_1.EmailSenderError; } });
+Object.defineProperty(exports, "EmailSenderErrorCode", { enumerable: true, get: function () { return errors_1.EmailSenderErrorCode; } });
+Object.defineProperty(exports, "EmailValidationError", { enumerable: true, get: function () { return errors_1.EmailValidationError; } });
+Object.defineProperty(exports, "ProviderError", { enumerable: true, get: function () { return errors_1.ProviderError; } });
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+// SendGrid-specific errors
+var errors_2 = require("./providers/sendgrid/errors");
+Object.defineProperty(exports, "SendGridApiError", { enumerable: true, get: function () { return errors_2.SendGridApiError; } });
+Object.defineProperty(exports, "TemplateNotFoundError", { enumerable: true, get: function () { return errors_2.TemplateNotFoundError; } });
+Object.defineProperty(exports, "UnauthorizedTemplateAccessError", { enumerable: true, get: function () { return errors_2.UnauthorizedTemplateAccessError; } });
+Object.defineProperty(exports, "TemplateConflictError", { enumerable: true, get: function () { return errors_2.TemplateConflictError; } });
+Object.defineProperty(exports, "SendGridRateLimitError", { enumerable: true, get: function () { return errors_2.SendGridRateLimitError; } });
+Object.defineProperty(exports, "SendGridErrorCode", { enumerable: true, get: function () { return errors_2.SendGridErrorCode; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;;;;;;;;;;;;;;;AAEF;;;GAGG;AAEH,aAAa;AACb,0CAAwB;AAExB,eAAe;AACf,oDAAkD;AAAzC,2GAAA,WAAW,OAAA;AAEpB,mBAAmB;AACnB,yCAAiD;AAAxC,qGAAA,aAAa,OAAA;AACtB,yCAAgD;AAAvC,oGAAA,YAAY,OAAA;AACrB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,uCAA8C;AAArC,kGAAA,WAAW,OAAA;AACpB,+CAAsD;AAA7C,0GAAA,eAAe,OAAA;AACxB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AA4BzB,sDAMqC;AALnC,0GAAA,gBAAgB,OAAA;AAChB,+GAAA,qBAAqB,OAAA;AACrB,yHAAA,+BAA+B,OAAA;AAC/B,+GAAA,qBAAqB,OAAA;AACrB,wGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;;;;;;;;;;;;;;;AAEF;;;GAGG;AAEH,aAAa;AACb,0CAAwB;AAExB,eAAe;AACf,oDAAqE;AAA5D,2GAAA,WAAW,OAAA;AACpB,oEAAiE;AAAxD,0HAAA,kBAAkB,OAAA;AAE3B,mBAAmB;AACnB,yCAAiD;AAAxC,qGAAA,aAAa,OAAA;AACtB,yCAAgD;AAAvC,oGAAA,YAAY,OAAA;AACrB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,uCAA8C;AAArC,kGAAA,WAAW,OAAA;AACpB,+CAAsD;AAA7C,0GAAA,eAAe,OAAA;AACxB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AAkBzB,gEAAgE;AAChE,mCAQkB;AAPhB,0GAAA,gBAAgB,OAAA;AAChB,8GAAA,oBAAoB,OAAA;AACpB,8GAAA,oBAAoB,OAAA;AACpB,uGAAA,aAAa,OAAA;AACb,wGAAA,cAAc,OAAA;AACd,sGAAA,YAAY,OAAA;AACZ,sGAAA,YAAY,OAAA;AAmBd,2BAA2B;AAC3B,sDAOqC;AANnC,0GAAA,gBAAgB,OAAA;AAChB,+GAAA,qBAAqB,OAAA;AACrB,yHAAA,+BAA+B,OAAA;AAC/B,+GAAA,qBAAqB,OAAA;AACrB,gHAAA,sBAAsB,OAAA;AACtB,2GAAA,iBAAiB,OAAA"}

package/dist/providers/sendgrid/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/sendgrid/client.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KACjC,GAAG,SAAS,CAAC;CACf;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAgC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;gBAE7C,MAAM,EAAE,oBAAoB;IAMlC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IA6CjF,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAIjD,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,GAAG,CAAC;CAO/C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/sendgrid/client.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KACjC,GAAG,SAAS,CAAC;CACf;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAgC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;gBAE7C,MAAM,EAAE,oBAAoB;IAMlC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IA+CjF,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAIjD,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,GAAG,CAAC;CAW/C"}

package/dist/providers/sendgrid/client.js

@@ -47,7 +47,9 @@ class SendGridClient {
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'Unknown error';
             this.logger?.error(`SendGrid API error: ${errorMessage}`);
-            throw new errors_1.SendGridApiError(`API request failed: ${errorMessage}`, undefined, error);
+            throw new errors_1.SendGridApiError(`API request failed: ${errorMessage}`, {
+                cause: error instanceof Error ? error : new Error(String(error)),
+            });
         }
         finally {
             if (this.rateLimiter) {
@@ -62,8 +64,12 @@ class SendGridClient {
         try {
             return JSON.parse(response.body);
         }
-        catch (_error) {
-            throw new errors_1.SendGridApiError('Failed to parse response body', response.statusCode, response.body);
+        catch (parseError) {
+            throw new errors_1.SendGridApiError('Failed to parse response body', {
+                statusCode: response.statusCode,
+                response: response.body,
+                cause: parseError instanceof Error ? parseError : new Error(String(parseError)),
+            });
         }
     }
 }

package/dist/providers/sendgrid/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/providers/sendgrid/client.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAQF,qCAA4C;AAa5C,MAAa,cAAc;IAMzB,YAAY,MAA4B;QAFvB,YAAO,GAAG,6BAA6B,CAAC;QAGvD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAA0B;QACxD,oCAAoC;QACpC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;YAEzC,MAAM,WAAW,GAAgB;gBAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;oBACxC,cAAc,EAAE,kBAAkB;oBAClC,GAAG,OAAO,CAAC,OAAO;iBACnB;aACF,CAAC;YAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAClC,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAE/C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,oCAAoC;YACpC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,gBAAgB,OAAO,CAAC,MAAM,IAAI,QAAQ,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAErF,OAAO;gBACL,UAAU,EAAE,QAAQ,CAAC,MAAM;gBAC3B,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACvD,IAAI;aACL,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC9E,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;YAC1D,MAAM,IAAI,yBAAgB,CAAC,uBAAuB,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACtF,CAAC;gBAAS,CAAC;YACT,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,QAAqB;QACrC,OAAO,QAAQ,CAAC,UAAU,IAAI,GAAG,IAAI,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC;IACjE,CAAC;IAED,iBAAiB,CAAI,QAAqB;QACxC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAM,CAAC;QACxC,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,yBAAgB,CAAC,+BAA+B,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;CACF;AApED,wCAoEC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/providers/sendgrid/client.ts"],"names":[],"mappings":"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"}

package/dist/providers/sendgrid/errors.d.ts

@@ -1,23 +1,66 @@
 /**
- * SendGrid-specific error classes
- * Merged from @bernierllc/email-sendgrid-plugin v1.0.1
+ * SendGrid-specific error classes with ES2022 Error.cause support
+ *
+ * These errors follow the error propagation standard defined in:
+ * plans/standards/error-propagation-standard.md
  */
-export declare class SendGridApiError extends Error {
-    statusCode?: number | undefined;
-    response?: unknown | undefined;
-    constructor(message: string, statusCode?: number | undefined, response?: unknown | undefined);
+import { ProviderError, EmailSenderError, EmailSenderErrorCode, type EmailSenderErrorOptions } from '../../errors';
+export { EmailSenderError, EmailSenderErrorCode };
+/**
+ * Error codes specific to SendGrid operations
+ */
+export declare const SendGridErrorCode: {
+    readonly API_ERROR: "SENDGRID_API_ERROR";
+    readonly TEMPLATE_NOT_FOUND: "SENDGRID_TEMPLATE_NOT_FOUND";
+    readonly TEMPLATE_UNAUTHORIZED: "SENDGRID_TEMPLATE_UNAUTHORIZED";
+    readonly TEMPLATE_CONFLICT: "SENDGRID_TEMPLATE_CONFLICT";
+    readonly RATE_LIMITED: "SENDGRID_RATE_LIMITED";
+    readonly INVALID_SENDER: "SENDGRID_INVALID_SENDER";
+};
+export type SendGridErrorCodeType = typeof SendGridErrorCode[keyof typeof SendGridErrorCode];
+/**
+ * SendGrid API error with status code and response details
+ */
+export declare class SendGridApiError extends ProviderError {
+    readonly sendGridErrors: Array<{
+        message: string;
+        field?: string;
+    }>;
+    constructor(message: string, options?: EmailSenderErrorOptions & {
+        statusCode?: number;
+        response?: unknown;
+    });
+    private extractErrors;
 }
-export declare class TemplateNotFoundError extends Error {
-    constructor(templateId: string);
+/**
+ * Error thrown when a SendGrid template is not found
+ */
+export declare class TemplateNotFoundError extends EmailSenderError {
+    readonly templateId: string;
+    constructor(templateId: string, options?: Omit<EmailSenderErrorOptions, 'code'>);
 }
-export declare class UnauthorizedTemplateAccessError extends Error {
-    constructor(templateId: string);
+/**
+ * Error thrown when access to a template is unauthorized
+ */
+export declare class UnauthorizedTemplateAccessError extends EmailSenderError {
+    readonly templateId: string;
+    constructor(templateId: string, options?: Omit<EmailSenderErrorOptions, 'code'>);
 }
-export declare class TemplateConflictError extends Error {
-    conflicts: string[];
-    constructor(templateId: string, conflicts: string[]);
+/**
+ * Error thrown when template operations conflict
+ */
+export declare class TemplateConflictError extends EmailSenderError {
+    readonly templateId: string;
+    readonly conflicts: string[];
+    constructor(templateId: string, conflicts: string[], options?: Omit<EmailSenderErrorOptions, 'code'>);
 }
-export declare class RateLimitError extends Error {
-    constructor(message: string);
+/**
+ * Error thrown when SendGrid rate limits are exceeded
+ */
+export declare class SendGridRateLimitError extends EmailSenderError {
+    constructor(message: string, options?: Omit<EmailSenderErrorOptions, 'code' | 'retryable'> & {
+        retryAfter?: number;
+    });
 }
+export { SendGridRateLimitError as RateLimitError };
 //# sourceMappingURL=errors.d.ts.map

package/dist/providers/sendgrid/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/providers/sendgrid/errors.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;IAGhC,UAAU,CAAC,EAAE,MAAM;IACnB,QAAQ,CAAC,EAAE,OAAO;gBAFzB,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,OAAO,YAAA;CAK5B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,+BAAgC,SAAQ,KAAK;gBAC5C,UAAU,EAAE,MAAM;CAI/B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAGrC,SAAS,EAAE,MAAM,EAAE;gBAD1B,UAAU,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EAAE;CAK7B;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/providers/sendgrid/errors.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE7F;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAGlE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,uBAAuB,GAAG;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;IAqBH,OAAO,CAAC,aAAa;CAyBtB;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAahF;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,gBAAgB;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAahF;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;gBAG3B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAgBlD;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;gBAExD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG;QAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CAiBJ;AAGD,OAAO,EAAE,sBAAsB,IAAI,cAAc,EAAE,CAAC"}

package/dist/providers/sendgrid/errors.js

@@ -7,47 +7,154 @@ The client may use and modify this code *only within the scope of the project it
 Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RateLimitError = exports.TemplateConflictError = exports.UnauthorizedTemplateAccessError = exports.TemplateNotFoundError = exports.SendGridApiError = void 0;
+exports.RateLimitError = exports.SendGridRateLimitError = exports.TemplateConflictError = exports.UnauthorizedTemplateAccessError = exports.TemplateNotFoundError = exports.SendGridApiError = exports.SendGridErrorCode = exports.EmailSenderErrorCode = exports.EmailSenderError = void 0;
 /**
- * SendGrid-specific error classes
- * Merged from @bernierllc/email-sendgrid-plugin v1.0.1
+ * SendGrid-specific error classes with ES2022 Error.cause support
+ *
+ * These errors follow the error propagation standard defined in:
+ * plans/standards/error-propagation-standard.md
  */
-class SendGridApiError extends Error {
-    constructor(message, statusCode, response) {
-        super(message);
-        this.statusCode = statusCode;
-        this.response = response;
+const errors_1 = require("../../errors");
+Object.defineProperty(exports, "EmailSenderError", { enumerable: true, get: function () { return errors_1.EmailSenderError; } });
+Object.defineProperty(exports, "EmailSenderErrorCode", { enumerable: true, get: function () { return errors_1.EmailSenderErrorCode; } });
+/**
+ * Error codes specific to SendGrid operations
+ */
+exports.SendGridErrorCode = {
+    API_ERROR: 'SENDGRID_API_ERROR',
+    TEMPLATE_NOT_FOUND: 'SENDGRID_TEMPLATE_NOT_FOUND',
+    TEMPLATE_UNAUTHORIZED: 'SENDGRID_TEMPLATE_UNAUTHORIZED',
+    TEMPLATE_CONFLICT: 'SENDGRID_TEMPLATE_CONFLICT',
+    RATE_LIMITED: 'SENDGRID_RATE_LIMITED',
+    INVALID_SENDER: 'SENDGRID_INVALID_SENDER',
+};
+/**
+ * SendGrid API error with status code and response details
+ */
+class SendGridApiError extends errors_1.ProviderError {
+    constructor(message, options) {
+        // Determine if retryable based on status code
+        const retryable = options?.statusCode !== undefined &&
+            (options.statusCode >= 500 || options.statusCode === 429);
+        super(message, {
+            ...options,
+            code: errors_1.EmailSenderErrorCode.PROVIDER_ERROR,
+            retryable,
+            providerResponse: options?.response,
+            context: {
+                ...options?.context,
+                provider: 'sendgrid',
+            },
+        });
         this.name = 'SendGridApiError';
+        this.sendGridErrors = this.extractErrors(options?.response);
+    }
+    extractErrors(response) {
+        if (!response || typeof response !== 'object')
+            return [];
+        const resp = response;
+        const errors = resp['errors'];
+        if (Array.isArray(errors)) {
+            return errors.map((e) => {
+                if (typeof e === 'object' && e !== null) {
+                    const err = e;
+                    const msg = err['message'];
+                    const fld = err['field'];
+                    const result = {
+                        message: typeof msg === 'string' ? msg : 'Unknown error',
+                    };
+                    if (typeof fld === 'string') {
+                        result.field = fld;
+                    }
+                    return result;
+                }
+                return { message: 'Unknown error' };
+            });
+        }
+        return [];
     }
 }
 exports.SendGridApiError = SendGridApiError;
-class TemplateNotFoundError extends Error {
-    constructor(templateId) {
-        super(`Template not found: ${templateId}`);
+/**
+ * Error thrown when a SendGrid template is not found
+ */
+class TemplateNotFoundError extends errors_1.EmailSenderError {
+    constructor(templateId, options) {
+        super(`Template not found: ${templateId}`, {
+            ...options,
+            code: errors_1.EmailSenderErrorCode.TEMPLATE_NOT_FOUND,
+            context: {
+                ...options?.context,
+                templateId,
+                provider: 'sendgrid',
+            },
+        });
         this.name = 'TemplateNotFoundError';
+        this.templateId = templateId;
     }
 }
 exports.TemplateNotFoundError = TemplateNotFoundError;
-class UnauthorizedTemplateAccessError extends Error {
-    constructor(templateId) {
-        super(`Unauthorized access to template: ${templateId}`);
+/**
+ * Error thrown when access to a template is unauthorized
+ */
+class UnauthorizedTemplateAccessError extends errors_1.EmailSenderError {
+    constructor(templateId, options) {
+        super(`Unauthorized access to template: ${templateId}`, {
+            ...options,
+            code: errors_1.EmailSenderErrorCode.TEMPLATE_UNAUTHORIZED,
+            context: {
+                ...options?.context,
+                templateId,
+                provider: 'sendgrid',
+            },
+        });
         this.name = 'UnauthorizedTemplateAccessError';
+        this.templateId = templateId;
     }
 }
 exports.UnauthorizedTemplateAccessError = UnauthorizedTemplateAccessError;
-class TemplateConflictError extends Error {
-    constructor(templateId, conflicts) {
-        super(`Template conflict detected for ${templateId}: ${conflicts.join(', ')}`);
-        this.conflicts = conflicts;
+/**
+ * Error thrown when template operations conflict
+ */
+class TemplateConflictError extends errors_1.EmailSenderError {
+    constructor(templateId, conflicts, options) {
+        super(`Template conflict detected for ${templateId}: ${conflicts.join(', ')}`, {
+            ...options,
+            code: errors_1.EmailSenderErrorCode.TEMPLATE_CONFLICT,
+            context: {
+                ...options?.context,
+                templateId,
+                conflicts,
+                provider: 'sendgrid',
+            },
+        });
         this.name = 'TemplateConflictError';
+        this.templateId = templateId;
+        this.conflicts = conflicts;
     }
 }
 exports.TemplateConflictError = TemplateConflictError;
-class RateLimitError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'RateLimitError';
+/**
+ * Error thrown when SendGrid rate limits are exceeded
+ */
+class SendGridRateLimitError extends errors_1.EmailSenderError {
+    constructor(message, options) {
+        const baseOptions = {
+            ...options,
+            code: errors_1.EmailSenderErrorCode.PROVIDER_RATE_LIMITED,
+            retryable: true,
+            context: {
+                ...options?.context,
+                provider: 'sendgrid',
+            },
+        };
+        if (options?.retryAfter !== undefined) {
+            baseOptions.retryAfter = options.retryAfter;
+        }
+        super(message, baseOptions);
+        this.name = 'SendGridRateLimitError';
     }
 }
-exports.RateLimitError = RateLimitError;
+exports.SendGridRateLimitError = SendGridRateLimitError;
+exports.RateLimitError = SendGridRateLimitError;
 //# sourceMappingURL=errors.js.map

package/dist/providers/sendgrid/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/providers/sendgrid/errors.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF;;;GAGG;AAEH,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YACE,OAAe,EACR,UAAmB,EACnB,QAAkB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAU;QAGzB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AATD,4CASC;AAED,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,UAAkB;QAC5B,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC;AAED,MAAa,+BAAgC,SAAQ,KAAK;IACxD,YAAY,UAAkB;QAC5B,KAAK,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AALD,0EAKC;AAED,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YACE,UAAkB,EACX,SAAmB;QAE1B,KAAK,CAAC,kCAAkC,UAAU,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAFxE,cAAS,GAAT,SAAS,CAAU;QAG1B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AARD,sDAQC;AAED,MAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/providers/sendgrid/errors.ts"],"names":[],"mappings":"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"}

package/dist/providers/sendgrid/sender-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sender-manager.d.ts","sourceRoot":"","sources":["../../../src/providers/sendgrid/sender-manager.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,sBAAsB,EAEvB,MAAM,SAAS,CAAC;AAEjB,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAP1B,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAGhB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,eAAe,EAC1B,MAAM,CAAC,EAAE;QACxB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,YAAA;IAGG,kBAAkB,CAAC,QAAQ,UAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoC9D,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA8C9D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA0BzE,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,oBAAoB;CAsB7B"}
+{"version":3,"file":"sender-manager.d.ts","sourceRoot":"","sources":["../../../src/providers/sendgrid/sender-manager.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,sBAAsB,EAEvB,MAAM,SAAS,CAAC;AAEjB,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAP1B,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAGhB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,eAAe,EAC1B,MAAM,CAAC,EAAE;QACxB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,YAAA;IAGG,kBAAkB,CAAC,QAAQ,UAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmC9D,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA8C9D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA0BzE,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,oBAAoB;CAsB7B"}

package/dist/providers/sendgrid/sender-manager.js

@@ -29,7 +29,10 @@ class SenderManager {
             method: 'GET'
         });
         if (!this.client.isSuccessResponse(response)) {
-            throw new errors_1.SendGridApiError('Failed to fetch verified senders', response.statusCode, response.body);
+            throw new errors_1.SendGridApiError('Failed to fetch verified senders', {
+                statusCode: response.statusCode,
+                response: response.body,
+            });
         }
         const data = this.client.parseResponseBody(response);
         const senders = data.results.map(sender => this.converter.convertToVerifiedSender(sender));