@dereekb/nestjs 13.31.0 → 13.32.0

package/mailgun/index.esm.js

@@ -5,15 +5,15 @@ import Mailgun from 'mailgun.js';
 import FormData from 'form-data';
 import { ConfigService, ConfigModule } from '@nestjs/config';
 
-function _array_like_to_array$1(arr, len) {
+function _array_like_to_array$2(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes(arr) {
+function _array_with_holes$1(arr) {
     if (Array.isArray(arr)) return arr;
 }
-function _define_property$4(obj, key, value) {
+function _define_property$5(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -34,7 +34,7 @@ function _instanceof(left, right) {
         return left instanceof right;
     }
 }
-function _iterable_to_array_limit(arr, i) {
+function _iterable_to_array_limit$1(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -58,10 +58,10 @@ function _iterable_to_array_limit(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest() {
+function _non_iterable_rest$1() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _object_spread$2(target) {
+function _object_spread$3(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -71,7 +71,7 @@ function _object_spread$2(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$4(target, key, source[key]);
+            _define_property$5(target, key, source[key]);
         });
     }
     return target;
@@ -95,20 +95,20 @@ function _object_spread_props$1(target, source) {
     }
     return target;
 }
-function _sliced_to_array(arr, i) {
-    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array$1(arr, i) || _non_iterable_rest();
+function _sliced_to_array$1(arr, i) {
+    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$2(arr, i) || _non_iterable_rest$1();
 }
 function _type_of$1(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _unsupported_iterable_to_array$1(o, minLen) {
+function _unsupported_iterable_to_array$2(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$2(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
 }
 var DEFAULT_RECIPIENT_VARIABLE_PREFIX = 'recipient-';
 var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
@@ -134,7 +134,7 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
     var allowBatchSending = (_request_batchSend = request.batchSend) !== null && _request_batchSend !== void 0 ? _request_batchSend : true;
     var mergeRecipientVariablesIntoGlobalVariable = !allowBatchSending;
     function mapEmailToLowercase(x) {
-        return _object_spread_props$1(_object_spread$2({}, x), {
+        return _object_spread_props$1(_object_spread$3({}, x), {
             email: x.email.toLowerCase()
         });
     }
@@ -152,7 +152,7 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
     if (allowBatchSending && to.length > MAX_BATCH_SEND_RECIPIENTS) {
         throw new Error("convertMailgunTemplateEmailRequestToMailgunMessageData(): Can only batch send to a maximum of ".concat(MAX_BATCH_SEND_RECIPIENTS, " recipients."));
     }
-    var data = _object_spread$2({
+    var data = _object_spread$3({
         from: from,
         to: to,
         cc: cc,
@@ -169,7 +169,7 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
     if (request.templateVariables) {
         forEachKeyValue(request.templateVariables, {
             forEach: function forEach(x) {
-                var _x = _sliced_to_array(x, 2), key = _x[0], value = _x[1];
+                var _x = _sliced_to_array$1(x, 2), key = _x[0], value = _x[1];
                 var encodedValue = encodeMailgunTemplateVariableValue(value);
                 if (encodedValue != null) {
                     data["v:".concat(key)] = encodedValue;
@@ -198,7 +198,7 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
             var decoded = JSON.parse(data['recipient-variables']);
             forEachKeyValue(decoded, {
                 forEach: function forEach(x) {
-                    var _x = _sliced_to_array(x, 2), recipientEmail = _x[0], userVariables = _x[1];
+                    var _x = _sliced_to_array$1(x, 2), recipientEmail = _x[0], userVariables = _x[1];
                     var email = recipientEmail.toLowerCase();
                     if (email in recipientVariables) {
                         overrideInObject(recipientVariables[email], {
@@ -226,10 +226,10 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
             // iterate all recipient variables and merge them into the global variables
             forEachKeyValue(recipientVariables, {
                 forEach: function forEach(x) {
-                    var _x = _sliced_to_array(x, 2); _x[0]; var userVariables = _x[1];
+                    var _x = _sliced_to_array$1(x, 2); _x[0]; var userVariables = _x[1];
                     forEachKeyValue(userVariables, {
                         forEach: function forEach(y) {
-                            var _y = _sliced_to_array(y, 2), key = _y[0], value = _y[1];
+                            var _y = _sliced_to_array$1(y, 2), key = _y[0], value = _y[1];
                             var encodedValue = encodeMailgunTemplateVariableValue(value);
                             if (encodedValue != null) {
                                 if (addRecipientPrefixVariable) {
@@ -373,7 +373,7 @@ function _create_class$2(Constructor, protoProps, staticProps) {
     if (staticProps) _defineProperties$2(Constructor, staticProps);
     return Constructor;
 }
-function _define_property$3(obj, key, value) {
+function _define_property$4(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -390,19 +390,19 @@ var MailgunServiceConfig = /*#__PURE__*/ function() {
     function MailgunServiceConfig() {
         _class_call_check$3(this, MailgunServiceConfig);
         // Mailgun Config
-        _define_property$3(this, "mailgun", void 0);
+        _define_property$4(this, "mailgun", void 0);
         /**
      * Base URL to the client.
-     */ _define_property$3(this, "clientUrl", void 0);
+     */ _define_property$4(this, "clientUrl", void 0);
         /**
      * Main domain to send emails from.
-     */ _define_property$3(this, "domain", void 0);
+     */ _define_property$4(this, "domain", void 0);
         /**
      * Mailgun sender string.
-     */ _define_property$3(this, "sender", void 0);
+     */ _define_property$4(this, "sender", void 0);
         /**
      * Additional messages config
-     */ _define_property$3(this, "messages", void 0);
+     */ _define_property$4(this, "messages", void 0);
     }
     _create_class$2(MailgunServiceConfig, null, [
         {
@@ -444,7 +444,7 @@ function _create_class$1(Constructor, protoProps, staticProps) {
     if (protoProps) _defineProperties$1(Constructor.prototype, protoProps);
     return Constructor;
 }
-function _define_property$2(obj, key, value) {
+function _define_property$3(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -457,7 +457,7 @@ function _define_property$2(obj, key, value) {
     }
     return obj;
 }
-function _object_spread$1(target) {
+function _object_spread$2(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -467,7 +467,7 @@ function _object_spread$1(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$2(target, key, source[key]);
+            _define_property$3(target, key, source[key]);
         });
     }
     return target;
@@ -475,10 +475,10 @@ function _object_spread$1(target) {
 var MailgunApi = /*#__PURE__*/ function() {
     function MailgunApi(config) {
         _class_call_check$2(this, MailgunApi);
-        _define_property$2(this, "config", void 0);
-        _define_property$2(this, "client", void 0);
+        _define_property$3(this, "config", void 0);
+        _define_property$3(this, "client", void 0);
         this.config = config;
-        this.client = new Mailgun(FormData).client(_object_spread$1({}, config.mailgun));
+        this.client = new Mailgun(FormData).client(_object_spread$2({}, config.mailgun));
     }
     _create_class$1(MailgunApi, [
         {
@@ -487,6 +487,50 @@ var MailgunApi = /*#__PURE__*/ function() {
                 return this.client.messages;
             }
         },
+        {
+            key: "suppressions",
+            get: /**
+     * The domain's suppression lists (bounces, spam complaints, unsubscribes, whitelists).
+     *
+     * An address on the bounce or complaint list is silently dropped by Mailgun on every subsequent send,
+     * which makes this the first thing to check when diagnosing "this recipient stopped receiving email".
+     *
+     * @returns The suppressions client.
+     */ function get() {
+                return this.client.suppressions;
+            }
+        },
+        {
+            key: "events",
+            get: /**
+     * The domain's event log, used to inspect what actually happened to sent messages
+     * (accepted/delivered/failed/rejected/complained/unsubscribed).
+     *
+     * @returns The events client.
+     */ function get() {
+                return this.client.events;
+            }
+        },
+        {
+            key: "validate",
+            get: /**
+     * Single-address validation.
+     *
+     * @returns The validation client.
+     */ function get() {
+                return this.client.validate;
+            }
+        },
+        {
+            key: "domains",
+            get: /**
+     * Domain administration, used to read the sending domain's verification state.
+     *
+     * @returns The domains client.
+     */ function get() {
+                return this.client.domains;
+            }
+        },
         {
             key: "clientUrl",
             get: function get() {
@@ -513,6 +557,604 @@ MailgunApi = __decorate([
     __param(0, Inject(MailgunServiceConfig))
 ], MailgunApi);
 
+function _array_like_to_array$1(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator$1(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep$1(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _define_property$2(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _object_spread$1(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property$2(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array$1(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array$1(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
+}
+function _ts_generator$1(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+/**
+ * The default number of events to read back when inspecting a recipient's recent activity.
+ */ var DEFAULT_MAILGUN_RECENT_EVENTS_LIMIT = 25;
+/**
+ * The default window of history to inspect when reading a recipient's recent events.
+ */ var DEFAULT_MAILGUN_RECENT_EVENTS_WINDOW_DAYS = 30;
+/**
+ * Mailgun event names relevant to delivery diagnosis.
+ *
+ * Mailgun returns these as free-form strings; this enum names the ones that carry
+ * delivery meaning. Unknown values are passed through untouched.
+ */ var MailgunEventName;
+(function(MailgunEventName) {
+    MailgunEventName["ACCEPTED"] = "accepted";
+    MailgunEventName["DELIVERED"] = "delivered";
+    MailgunEventName["FAILED"] = "failed";
+    MailgunEventName["REJECTED"] = "rejected";
+    MailgunEventName["COMPLAINED"] = "complained";
+    MailgunEventName["UNSUBSCRIBED"] = "unsubscribed";
+    MailgunEventName["OPENED"] = "opened";
+    MailgunEventName["CLICKED"] = "clicked";
+    MailgunEventName["STORED"] = "stored";
+})(MailgunEventName || (MailgunEventName = {}));
+/**
+ * Mailgun failure severities. A `permanent` failure will never succeed on retry;
+ * a `temporary` one may.
+ */ var MailgunEventSeverity;
+(function(MailgunEventSeverity) {
+    MailgunEventSeverity["PERMANENT"] = "permanent";
+    MailgunEventSeverity["TEMPORARY"] = "temporary";
+})(MailgunEventSeverity || (MailgunEventSeverity = {}));
+/**
+ * True if any suppression record was found for the address.
+ *
+ * @param suppressions - The suppression records to check.
+ * @returns True if the address appears on any of the domain's suppression lists.
+ */ function hasAnyMailgunRecipientSuppression(suppressions) {
+    return suppressions.bounce != null || suppressions.complaint != null || suppressions.unsubscribe != null;
+}
+/**
+ * Reads a single suppression entry, treating "not found" as an absent value.
+ *
+ * The Mailgun API responds 404 when the address is not on the requested list, which is the common case
+ * and not an error condition here.
+ *
+ * @param read - Performs the suppression lookup.
+ * @returns The suppression record, or undefined if the address is not on the list or the lookup failed.
+ */ function readSuppression(read) {
+    return _async_to_generator$1(function() {
+        var result;
+        return _ts_generator$1(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    _state.trys.push([
+                        0,
+                        2,
+                        ,
+                        3
+                    ]);
+                    return [
+                        4,
+                        read()
+                    ];
+                case 1:
+                    result = _state.sent();
+                    return [
+                        3,
+                        3
+                    ];
+                case 2:
+                    _state.sent();
+                    result = undefined;
+                    return [
+                        3,
+                        3
+                    ];
+                case 3:
+                    return [
+                        2,
+                        result
+                    ];
+            }
+        });
+    })();
+}
+/**
+ * Looks up an address across the domain's bounce, complaint, and unsubscribe lists.
+ *
+ * @param api - The Mailgun API.
+ * @param email - The address to look up.
+ * @returns The suppression records found for the address. Absent fields mean the address is not on that list.
+ *
+ * @example
+ * ```ts
+ * const suppressions = await mailgunSuppressionsForRecipient(api, 'user@example.com');
+ *
+ * if (suppressions.bounce) {
+ *   console.log(`suppressed by bounce: ${suppressions.bounce.error}`);
+ * }
+ * ```
+ */ function mailgunSuppressionsForRecipient(api, email) {
+    return _async_to_generator$1(function() {
+        var domain, suppressions, _ref, bounce, complaint, unsubscribe;
+        return _ts_generator$1(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    domain = api.domain, suppressions = api.suppressions;
+                    return [
+                        4,
+                        Promise.all([
+                            //
+                            readSuppression(function() {
+                                return suppressions.get(domain, 'bounces', email);
+                            }),
+                            readSuppression(function() {
+                                return suppressions.get(domain, 'complaints', email);
+                            }),
+                            readSuppression(function() {
+                                return suppressions.get(domain, 'unsubscribes', email);
+                            })
+                        ])
+                    ];
+                case 1:
+                    _ref = _sliced_to_array.apply(void 0, [
+                        _state.sent(),
+                        3
+                    ]), bounce = _ref[0], complaint = _ref[1], unsubscribe = _ref[2];
+                    return [
+                        2,
+                        {
+                            bounce: bounce,
+                            complaint: complaint,
+                            unsubscribe: unsubscribe
+                        }
+                    ];
+            }
+        });
+    })();
+}
+/**
+ * Reads the most recent Mailgun events for a recipient address, newest first.
+ *
+ * @param api - The Mailgun API.
+ * @param email - The recipient address to filter on.
+ * @param config - Optional limit/window/event filters.
+ * @returns The matching events, newest first. Empty if there is no recent activity or the lookup failed.
+ *
+ * @example
+ * ```ts
+ * const events = await mailgunRecentEventsForRecipient(api, 'user@example.com', { limit: 10 });
+ * const lastDelivered = events.find((x) => x.event === MailgunEventName.DELIVERED);
+ * ```
+ */ function mailgunRecentEventsForRecipient(api, email, config) {
+    return _async_to_generator$1(function() {
+        var _ref, _ref1, limit, begin, query;
+        return _ts_generator$1(this, function(_state) {
+            limit = (_ref = config === null || config === void 0 ? void 0 : config.limit) !== null && _ref !== void 0 ? _ref : DEFAULT_MAILGUN_RECENT_EVENTS_LIMIT;
+            begin = (_ref1 = config === null || config === void 0 ? void 0 : config.begin) !== null && _ref1 !== void 0 ? _ref1 : new Date(Date.now() - DEFAULT_MAILGUN_RECENT_EVENTS_WINDOW_DAYS * 24 * 60 * 60 * 1000);
+            query = {
+                recipient: email,
+                begin: begin.toUTCString(),
+                ascending: 'no',
+                limit: limit
+            };
+            if (config === null || config === void 0 ? void 0 : config.event) {
+                query.event = config.event;
+            }
+            return [
+                2,
+                mailgunEventsForQuery(api, query)
+            ];
+        });
+    })();
+}
+/**
+ * Strips the angle brackets Mailgun's send response wraps a message id in.
+ *
+ * `messages.create()` returns an id shaped like `<20240101120000.1.abc@domain>`, while the
+ * Events API `message-id` filter expects the bare `20240101120000.1.abc@domain`. Passing the
+ * bracketed form matches nothing.
+ *
+ * @param messageId - A message id in either form.
+ * @returns The message id without surrounding angle brackets.
+ */ function bareMailgunMessageId(messageId) {
+    return messageId.replaceAll(/^<|>$/g, '');
+}
+/**
+ * Reads all Mailgun events recorded for a specific message id.
+ *
+ * Used to resolve the outcome of a message that was already sent — the Events API lags the
+ * send by seconds to minutes, so an empty result means "not known yet", not "not delivered".
+ *
+ * @param api - The Mailgun API.
+ * @param messageId - The message id, with or without angle brackets.
+ * @param config - Optional additional filters (e.g. `recipient` to scope the lookup).
+ * @returns The events recorded for the message. Empty if none are recorded yet or the lookup failed.
+ */ function mailgunEventsForMessageId(api, messageId, config) {
+    return _async_to_generator$1(function() {
+        var query;
+        return _ts_generator$1(this, function(_state) {
+            query = _object_spread$1({
+                'message-id': bareMailgunMessageId(messageId),
+                ascending: 'no'
+            }, config);
+            return [
+                2,
+                mailgunEventsForQuery(api, query)
+            ];
+        });
+    })();
+}
+/**
+ * Runs an arbitrary Events API query, returning an empty list if the lookup fails.
+ *
+ * @param api - The Mailgun API.
+ * @param query - The events query.
+ * @returns The matching events, or an empty array on failure.
+ */ function mailgunEventsForQuery(api, query) {
+    return _async_to_generator$1(function() {
+        var events, _result_items, result;
+        return _ts_generator$1(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    _state.trys.push([
+                        0,
+                        2,
+                        ,
+                        3
+                    ]);
+                    return [
+                        4,
+                        api.events.get(api.domain, query)
+                    ];
+                case 1:
+                    result = _state.sent();
+                    events = (_result_items = result.items) !== null && _result_items !== void 0 ? _result_items : [];
+                    return [
+                        3,
+                        3
+                    ];
+                case 2:
+                    _state.sent();
+                    events = [];
+                    return [
+                        3,
+                        3
+                    ];
+                case 3:
+                    return [
+                        2,
+                        events
+                    ];
+            }
+        });
+    })();
+}
+/**
+ * Reads the sending domain's state.
+ *
+ * A domain that is not `active` will fail to deliver regardless of recipient configuration,
+ * so this distinguishes a system-wide outage from a per-recipient problem.
+ *
+ * @param api - The Mailgun API.
+ * @returns The domain's state, with `unknown` set if it could not be read.
+ */ function mailgunDomainState(api) {
+    return _async_to_generator$1(function() {
+        var domain, state, result;
+        return _ts_generator$1(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    domain = api.domain;
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    return [
+                        4,
+                        api.domains.get(domain)
+                    ];
+                case 2:
+                    result = _state.sent();
+                    state = {
+                        domain: domain,
+                        state: result === null || result === void 0 ? void 0 : result.state,
+                        disabled: result === null || result === void 0 ? void 0 : result.is_disabled
+                    };
+                    return [
+                        3,
+                        4
+                    ];
+                case 3:
+                    _state.sent();
+                    state = {
+                        domain: domain,
+                        unknown: true
+                    };
+                    return [
+                        3,
+                        4
+                    ];
+                case 4:
+                    return [
+                        2,
+                        state
+                    ];
+            }
+        });
+    })();
+}
+/**
+ * Validates a single email address via the Mailgun Validation API.
+ *
+ * Note that validation consumes Mailgun validation quota, so callers should treat this as
+ * an opt-in check rather than something to run on every request.
+ *
+ * @param api - The Mailgun API.
+ * @param email - The address to validate.
+ * @returns The validation result, or undefined if validation is unavailable or failed.
+ */ function mailgunValidateEmail(api, email) {
+    return _async_to_generator$1(function() {
+        var result;
+        return _ts_generator$1(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    _state.trys.push([
+                        0,
+                        2,
+                        ,
+                        3
+                    ]);
+                    return [
+                        4,
+                        api.validate.get(email)
+                    ];
+                case 1:
+                    result = _state.sent();
+                    return [
+                        3,
+                        3
+                    ];
+                case 2:
+                    _state.sent();
+                    result = undefined;
+                    return [
+                        3,
+                        3
+                    ];
+                case 3:
+                    return [
+                        2,
+                        result
+                    ];
+            }
+        });
+    })();
+}
+/**
+ * Converts a Mailgun event's unix-seconds timestamp to a Date.
+ *
+ * @param event - The event.
+ * @returns The event's timestamp as a Date.
+ */ function mailgunDomainEventDate(event) {
+    return new Date(event.timestamp * 1000);
+}
+/**
+ * The age of a Mailgun event in milliseconds relative to `now`.
+ *
+ * @param event - The event.
+ * @param now - The reference time. Defaults to the current time.
+ * @returns The event's age in milliseconds.
+ */ function mailgunDomainEventAge(event) {
+    var now = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : new Date();
+    return now.getTime() - mailgunDomainEventDate(event).getTime();
+}
+/**
+ * Extracts the most useful human-readable reason from a failed/rejected Mailgun event.
+ *
+ * Mailgun spreads the explanation across `reason`, `delivery-status.description`, and
+ * `delivery-status.message` depending on how the failure occurred, and any of them may be
+ * empty.
+ *
+ * @param event - The event.
+ * @returns The best available description, or undefined if the event carries none.
+ */ function mailgunDomainEventFailureReason(event) {
+    var _ref;
+    var deliveryStatus = event['delivery-status'];
+    var description = (deliveryStatus === null || deliveryStatus === void 0 ? void 0 : deliveryStatus.description) || undefined;
+    var message = (deliveryStatus === null || deliveryStatus === void 0 ? void 0 : deliveryStatus.message) || undefined;
+    var reason = event.reason || undefined;
+    return (_ref = description !== null && description !== void 0 ? description : message) !== null && _ref !== void 0 ? _ref : reason;
+}
+
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
         var info = gen[key](arg);
@@ -1131,4 +1773,4 @@ function _unsupported_iterable_to_array(o, minLen) {
     };
 }
 
-export { DEFAULT_RECIPIENT_VARIABLE_PREFIX, MAILGUN_BATCH_SEND_RECIPIENT_SUBJECT_TEMPLATE, MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY, MAX_BATCH_SEND_RECIPIENTS, MailgunApi, MailgunService, MailgunServiceModule, convertMailgunRecipientToString, convertMailgunRecipientsToStrings, convertMailgunTemplateEmailRequestToMailgunMessageData, encodeMailgunTemplateVariableValue, expandMailgunRecipientBatchSendTargetRequestFactory, mailgunRecipientBatchSendTargetEntityKeyRecipientLookup, mailgunRecipientBatchSendTargetFromReplyToBatchGroupKey, mailgunServiceConfigFactory };
+export { DEFAULT_MAILGUN_RECENT_EVENTS_LIMIT, DEFAULT_MAILGUN_RECENT_EVENTS_WINDOW_DAYS, DEFAULT_RECIPIENT_VARIABLE_PREFIX, MAILGUN_BATCH_SEND_RECIPIENT_SUBJECT_TEMPLATE, MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY, MAX_BATCH_SEND_RECIPIENTS, MailgunApi, MailgunEventName, MailgunEventSeverity, MailgunService, MailgunServiceModule, bareMailgunMessageId, convertMailgunRecipientToString, convertMailgunRecipientsToStrings, convertMailgunTemplateEmailRequestToMailgunMessageData, encodeMailgunTemplateVariableValue, expandMailgunRecipientBatchSendTargetRequestFactory, hasAnyMailgunRecipientSuppression, mailgunDomainEventAge, mailgunDomainEventDate, mailgunDomainEventFailureReason, mailgunDomainState, mailgunEventsForMessageId, mailgunEventsForQuery, mailgunRecentEventsForRecipient, mailgunRecipientBatchSendTargetEntityKeyRecipientLookup, mailgunRecipientBatchSendTargetFromReplyToBatchGroupKey, mailgunServiceConfigFactory, mailgunSuppressionsForRecipient, mailgunValidateEmail };