@dereekb/nestjs 13.11.13 → 13.11.15

package/index.esm.js

@@ -146,6 +146,9 @@ function _ts_generator$2(thisArg, body) {
  * The ref's {@link AssetLocalPathRef.path} is resolved relative
  * to the configured {@link NodeJsLocalAssetLoaderConfig.basePath}.
  *
+ * @param config - Filesystem configuration with base path.
+ * @returns An {@link AssetLoader} backed by the local filesystem.
+ *
  * @example
  * ```ts
  * const loader = nodeJsLocalAssetLoader({ basePath: './assets' });
@@ -153,9 +156,6 @@ function _ts_generator$2(thisArg, body) {
  *   // reads from ./assets/data/districts.json
  * });
  * ```
- *
- * @param config - Filesystem configuration with base path.
- * @returns An {@link AssetLoader} backed by the local filesystem.
  */ function nodeJsLocalAssetLoader(config) {
     var basePath = config.basePath;
     var getFn = function getFn(ref) {
@@ -190,16 +190,17 @@ function _ts_generator$2(thisArg, body) {
  * Local assets are loaded from the filesystem. Remote assets (which always
  * have absolute URLs) are loaded via `fetch`.
  *
- * @example
- * ```ts
- * @Module(appAssetLoaderModuleMetadata({
+ * @param config - Local filesystem config and optional remote fetch config.
+ * @returns NestJS {@link ModuleMetadata} that provides an {@link AssetLoader}.
+ *
+ * @Module (appAssetLoaderModuleMetadata({
  *   local: { basePath: './assets' }
  * }))
  * export class AppAssetLoaderModule {}
  * ```
  *
- * @param config - Local filesystem config and optional remote fetch config.
- * @returns NestJS {@link ModuleMetadata} that provides an {@link AssetLoader}.
+ * @example
+ * ```ts
  */ function appAssetLoaderModuleMetadata(config) {
     var local = nodeJsLocalAssetLoader(config.local);
     var remote = fetchAssetLoader(config.remote);
@@ -231,8 +232,8 @@ function _ts_generator$2(thisArg, body) {
  *
  * Checks for both http://localhost and https://localhost origins.
  *
- * @param context - the NestJS execution context containing the HTTP request
- * @returns true if the request origin is localhost
+ * @param context - The NestJS execution context containing the HTTP request.
+ * @returns True if the request origin is localhost.
  */ function isLocalhost(context) {
     var _req_headers_origin;
     var req = context.switchToHttp().getRequest();
@@ -383,26 +384,17 @@ function _ts_generator$1(thisArg, body) {
  */ var rawBodyLogger = new Logger('RawBody');
 var ParseRawBody = createParamDecorator(function(_, context) {
     return _async_to_generator$1(function() {
-        var req, body;
+        var req;
         return _ts_generator$1(this, function(_state) {
-            switch(_state.label){
-                case 0:
-                    req = context.switchToHttp().getRequest();
-                    if (!req.readable) {
-                        rawBodyLogger.error('RawBody request was not readable. This is generally due to bad configuration.');
-                        throw new BadRequestException('Invalid body');
-                    }
-                    return [
-                        4,
-                        rawbody(req)
-                    ];
-                case 1:
-                    body = _state.sent();
-                    return [
-                        2,
-                        body
-                    ];
+            req = context.switchToHttp().getRequest();
+            if (!req.readable) {
+                rawBodyLogger.error('RawBody request was not readable. This is generally due to bad configuration.');
+                throw new BadRequestException('Invalid body');
             }
+            return [
+                2,
+                rawbody(req)
+            ];
         });
     })();
 });
@@ -460,9 +452,9 @@ var ParseRawBody = createParamDecorator(function(_, context) {
 /**
  * Parses a raw body buffer as JSON.
  *
- * @param rawBody - The raw body buffer to parse
- * @returns The parsed JSON object
- * @throws {SyntaxError} When the body is not valid JSON
+ * @param rawBody - The raw body buffer to parse.
+ * @returns The parsed JSON object.
+ * @throws {SyntaxError} When the body is not valid JSON.
  *
  * @example
  * ```typescript
@@ -475,8 +467,8 @@ var ParseRawBody = createParamDecorator(function(_, context) {
 /**
  * Parses a raw body buffer as a URL-encoded query string.
  *
- * @param rawBody - The raw body buffer to parse
- * @returns The parsed query parameters
+ * @param rawBody - The raw body buffer to parse.
+ * @returns The parsed query parameters.
  *
  * @example
  * ```typescript
@@ -489,8 +481,8 @@ var ParseRawBody = createParamDecorator(function(_, context) {
 /**
  * Converts a raw body buffer to a trimmed UTF-8 string.
  *
- * @param rawBody - The raw body buffer to convert
- * @returns The decoded and trimmed string content
+ * @param rawBody - The raw body buffer to convert.
+ * @returns The decoded and trimmed string content.
  *
  * @example
  * ```typescript
@@ -777,9 +769,9 @@ function _type_of(obj) {
 /**
  * Merges two module metadata entries together.
  *
- * @param base - the base module metadata
- * @param additional - additional metadata to merge in
- * @returns the merged module metadata
+ * @param base - The base module metadata.
+ * @param additional - Additional metadata to merge in.
+ * @returns The merged module metadata.
  */ function mergeModuleMetadata(base) {
     var additional = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
     return {
@@ -806,8 +798,8 @@ function _type_of(obj) {
  *
  * For class providers, returns the class itself; for object providers, returns the provide token.
  *
- * @param providers - the providers to extract tokens from
- * @returns an array of injection tokens
+ * @param providers - Providers to extract tokens from.
+ * @returns Injection tokens collected from each provider.
  */ function injectionTokensFromProviders(providers) {
     return asArray(providers).map(function(x) {
         return (typeof x === "undefined" ? "undefined" : _type_of(x)) === 'object' ? x.provide : x;
@@ -864,8 +856,8 @@ function _define_property$3(obj, key, value) {
             value: /**
      * Validates that the configuration contains a non-empty client web app URL.
      *
-     * @param config - The configuration to validate
-     * @throws {Error} When `clientWebAppUrl` is not specified
+     * @param config - The configuration to validate.
+     * @throws {Error} When `clientWebAppUrl` is not specified.
      */ function assertValidConfig(config) {
                 if (!config.client.clientWebAppUrl) {
                     throw new Error('No client app url specified.');
@@ -953,8 +945,9 @@ function _class_call_check$2(instance, Constructor) {
  *
  * Reads the client web app URL from the CLIENT_WEB_APP_URL environment variable.
  *
- * @param configService - NestJS config service for reading environment variables
- * @returns a validated ClientAppServiceConfig
+ * @param configService - NestJS config service for reading environment variables.
+ * @returns A validated ClientAppServiceConfig.
+ *
  * @__NO_SIDE_EFFECTS__
  */ function clientAppConfigFactory(configService) {
     var config = {
@@ -1018,8 +1011,8 @@ function _class_call_check$1(instance, Constructor) {
  *
  * Use this to register a server environment configuration instance with the NestJS dependency injection container.
  *
- * @param env - the server environment config to provide
- * @returns a NestJS Provider that supplies the config under SERVER_ENV_TOKEN
+ * @param env - The server environment config to provide.
+ * @returns A NestJS Provider that supplies the config under SERVER_ENV_TOKEN.
  */ function serverEnvTokenProvider(env) {
     return {
         provide: SERVER_ENV_TOKEN,
@@ -1030,7 +1023,7 @@ function _class_call_check$1(instance, Constructor) {
 /**
  * Checks process.env.NODE_ENV for "test".
  *
- * @returns true if the current Node environment is "test", false otherwise
+ * @returns True if the current Node environment is "test", false otherwise.
  */ function isTestNodeEnv() {
     return process.env['NODE_ENV'] === 'test';
 }
@@ -1157,7 +1150,7 @@ ServerEnvironmentService = __decorate([
  * @param input.dirPath - Absolute path to the parent directory; created (recursively) when missing.
  * @param input.data - Value to serialize as JSON (pretty-printed with two-space indentation).
  * @param input.mode - Optional numeric file mode (e.g. `0o600`) applied via `chmod` after the write.
- * @returns A promise that resolves once the JSON has been written and the optional `chmod` has completed.
+ * @returns Resolves once the JSON has been written and the optional `chmod` has completed.
  */ function writeJsonFile(input) {
     mkdirSync(input.dirPath, {
         recursive: true
@@ -1168,16 +1161,14 @@ ServerEnvironmentService = __decorate([
         }, function(err) {
             if (err) {
                 reject(err);
-                return;
-            }
-            if (input.mode == null) {
+            } else if (input.mode == null) {
                 resolve();
-                return;
+            } else {
+                chmod(input.filePath, input.mode, function(chmodErr) {
+                    if (chmodErr) reject(chmodErr);
+                    else resolve();
+                });
             }
-            chmod(input.filePath, input.mode, function(chmodErr) {
-                if (chmodErr) reject(chmodErr);
-                else resolve();
-            });
         });
     });
 }
@@ -1189,7 +1180,7 @@ ServerEnvironmentService = __decorate([
  * swallowing them masks real failures and makes operations appear to have succeeded.
  *
  * @param filePath - Absolute path to the file to remove.
- * @returns A promise that resolves once the file is removed (or was already absent).
+ * @returns Resolves once the file is removed (or was already absent).
  */ function removeFile(filePath) {
     return rm(filePath, {
         force: true
@@ -1446,7 +1437,7 @@ function _ts_generator(thisArg, body) {
     return {
         load: function load() {
             return _async_to_generator(function() {
-                var raw;
+                var raw, result;
                 return _ts_generator(this, function(_state) {
                     switch(_state.label){
                         case 0:
@@ -1457,14 +1448,13 @@ function _ts_generator(thisArg, body) {
                         case 1:
                             raw = _state.sent();
                             if (raw == null) {
-                                return [
-                                    2,
-                                    undefined
-                                ];
+                                result = undefined;
+                            } else {
+                                result = reviver == null ? raw : reviver(raw);
                             }
                             return [
                                 2,
-                                reviver == null ? raw : reviver(raw)
+                                result
                             ];
                     }
                 });
@@ -1560,38 +1550,32 @@ function _ts_generator(thisArg, body) {
                     case 1:
                         raw = _state.sent();
                         if (raw == null) {
-                            return [
-                                2,
-                                {}
-                            ];
-                        }
-                        if (reviver == null) {
-                            return [
-                                2,
-                                raw
-                            ];
-                        }
-                        result = {};
-                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-                        try {
-                            for(_iterator = Object.keys(raw)[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                                key = _step.value;
-                                revived = reviver(raw[key]);
-                                if (revived != null) {
-                                    result[key] = revived;
-                                }
-                            }
-                        } catch (err) {
-                            _didIteratorError = true;
-                            _iteratorError = err;
-                        } finally{
+                            result = {};
+                        } else if (reviver == null) {
+                            result = raw;
+                        } else {
+                            result = {};
+                            _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
                             try {
-                                if (!_iteratorNormalCompletion && _iterator.return != null) {
-                                    _iterator.return();
+                                for(_iterator = Object.keys(raw)[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                    key = _step.value;
+                                    revived = reviver(raw[key]);
+                                    if (revived != null) {
+                                        result[key] = revived;
+                                    }
                                 }
+                            } catch (err) {
+                                _didIteratorError = true;
+                                _iteratorError = err;
                             } finally{
-                                if (_didIteratorError) {
-                                    throw _iteratorError;
+                                try {
+                                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                        _iterator.return();
+                                    }
+                                } finally{
+                                    if (_didIteratorError) {
+                                        throw _iteratorError;
+                                    }
                                 }
                             }
                         }
@@ -1764,8 +1748,8 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
 /**
  * Validates that the given secret is a 64-character hexadecimal string (32 bytes for AES-256).
  *
- * @param secret - the hex-encoded secret key string to validate
- * @returns true if the secret is exactly 64 valid hex characters, false otherwise
+ * @param secret - The hex-encoded secret key string to validate.
+ * @returns True if the secret is exactly 64 valid hex characters, false otherwise.
  *
  * @example
  * ```typescript
@@ -1782,15 +1766,15 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
  * The getter is called immediately and the key is validated on creation. The returned
  * function provides the resolved Buffer without re-resolving or re-validating.
  *
+ * @param source - The secret source configuration.
+ * @returns A getter that returns the resolved 32-byte Buffer for AES-256 encryption.
+ * @throws {Error} When the resolved key is not 64 hex characters.
+ *
  * @example
  * ```typescript
  * const getKey = resolveEncryptionKey('a'.repeat(64));
  * const key: Buffer = getKey();
  * ```
- *
- * @param source - The secret source configuration.
- * @returns A getter that returns the resolved 32-byte Buffer for AES-256 encryption.
- * @throws Error if the resolved key is not 64 hex characters.
  */ function resolveEncryptionKey(source) {
     var hex = getValueFromGetter(source);
     if (!isValidAES256GCMEncryptionSecret(hex)) {
@@ -1804,6 +1788,10 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
 /**
  * Creates an `AES256GCMEncryption` instance that captures the resolved key in a closure.
  *
+ * @param source - The hex-encoded secret or getter for the AES-256 key.
+ * @returns An `AES256GCMEncryption` instance.
+ * @throws {Error} When the resolved key is not 64 hex characters.
+ *
  * @example
  * ```typescript
  * const encryption = createAES256GCMEncryption('a'.repeat(64));
@@ -1816,9 +1804,6 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
  * // decryptedStr === 'hello'
  * ```
  *
- * @param source - The hex-encoded secret or getter for the AES-256 key.
- * @returns An `AES256GCMEncryption` instance.
- * @throws Error if the resolved key is not 64 hex characters.
  * @__NO_SIDE_EFFECTS__
  */ function createAES256GCMEncryption(source) {
     var getKey = resolveEncryptionKey(source);
@@ -1870,16 +1855,16 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
  *
  * Format: base64(IV (12 bytes) + ciphertext + authTag (16 bytes))
  *
+ * @param value - The value to encrypt (must be JSON-serializable).
+ * @param key - The 32-byte encryption key from `resolveEncryptionKey()`.
+ * @returns The encrypted value as a base64 string.
+ *
  * @example
  * ```typescript
  * const getKey = resolveEncryptionKey(mySecret);
  * const encrypted = encryptValue({ sensitive: 'data' }, getKey());
  * const decrypted = decryptValue<{ sensitive: string }>(encrypted, getKey());
  * ```
- *
- * @param value - The value to encrypt (must be JSON-serializable).
- * @param key - The 32-byte encryption key from `resolveEncryptionKey()`.
- * @returns The encrypted value as a base64 string.
  */ function encryptValue(value, key) {
     var iv = randomBytes(ENCRYPTED_FIELD_IV_LENGTH);
     var cipher = createCipheriv(ENCRYPTED_FIELD_ALGORITHM, key, iv);
@@ -1922,6 +1907,10 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
  * The key is resolved and validated eagerly at creation time. The provider encrypts/decrypts
  * raw strings (no JSON serialization) — suitable for use with `selectiveFieldEncryptor`.
  *
+ * @param source - The hex-encoded secret or getter for the AES-256 key.
+ * @returns A `StringEncryptionProvider` that encrypts/decrypts strings via AES-256-GCM.
+ * @throws {Error} When the resolved key is not 64 hex characters.
+ *
  * @example
  * ```typescript
  * const provider = createAesStringEncryptionProvider('a'.repeat(64));
@@ -1930,9 +1919,6 @@ var ENCRYPTED_FIELD_KEY_LENGTH = 32;
  * // decrypted === 'sensitive data'
  * ```
  *
- * @param source - The hex-encoded secret or getter for the AES-256 key.
- * @returns A `StringEncryptionProvider` that encrypts/decrypts strings via AES-256-GCM.
- * @throws Error if the resolved key is not 64 hex characters.
  * @__NO_SIDE_EFFECTS__
  */ function createAesStringEncryptionProvider(source) {
     var encryption = createAES256GCMEncryption(source);
@@ -2075,6 +2061,9 @@ function _templateObject() {
  * Lives in `@dereekb/nestjs` (rather than `@dereekb/util`) because it uses Node's
  * built-in `node:crypto` module, which isn't available in the browser.
  *
+ * @param buffer - PDF file contents.
+ * @returns The encryption status of the PDF.
+ *
  * @example
  * ```ts
  * const status = detectPdfEncryption(buffer);
@@ -2086,9 +2075,6 @@ function _templateObject() {
  *   // Safe to read, but not to mutate without the owner password.
  * }
  * ```
- *
- * @param buffer - PDF file contents.
- * @returns The encryption status of the PDF.
  */ function detectPdfEncryption(buffer) {
     var result = 'unknown_encrypted';
     var encryptIndex = findEncryptKeywordIndex(buffer);
@@ -2428,7 +2414,7 @@ function readPdfTokenOrRefValue(buffer, start) {
     var token = buffer.toString('latin1', start, tokenEnd);
     var referenceEnd = readIndirectReferenceEnd(buffer, tokenEnd);
     var result;
-    if (referenceEnd !== null) {
+    if (referenceEnd != null) {
         result = {
             entry: {
                 type: 'ref',

package/mailgun/index.cjs.js

@@ -123,6 +123,7 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
  *
  * @param config - The conversion configuration containing the email request, default sender, and recipient variable settings.
  * @returns The constructed {@link MailgunMessageData} ready to be sent via the Mailgun API.
+ * @throws {Error} When `batchSend` is enabled with `cc`/`bcc` set, when the recipient list exceeds {@link MAX_BATCH_SEND_RECIPIENTS}, or when attachments are supplied via both `messageData` and `request.attachments`.
  */ function convertMailgunTemplateEmailRequestToMailgunMessageData(config) {
     var _ref, _ref1, _ref2, _ref3, _request_finalizeRecipientVariables, _request_batchSend;
     var request = config.request, defaultSender = config.defaultSender, testEnvironment = config.isTestingEnvironment, tmp = config.recipientVariablePrefix, inputRecipientVariablePrefix = tmp === void 0 ? DEFAULT_RECIPIENT_VARIABLE_PREFIX : tmp, tmp1 = config.addRecipientVariablePrefixToAllMergedGlobalVariables, inputAddRecipientVariablePrefixToAllMergedGlobalVariables = tmp1 === void 0 ? true : tmp1, tmp2 = config.addCopyOfMergedRecipientVariablesWithoutPrefixToGlobalVariables, inputAddCopyOfMergedRecipientVariablesWithoutPrefixToGlobalVariables = tmp2 === void 0 ? false : tmp2, tmp3 = config.addCopyOfTemplateVariablesWithRecipientVariablePrefix, inputAddCopyOfTemplateVariablesWithRecipientVariablePrefix = tmp3 === void 0 ? false : tmp3;
@@ -279,8 +280,8 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
  *
  * Each recipient is formatted as "Name <email>" when a name is present, or just the email address.
  *
- * @param recipients - the recipients to convert
- * @returns an array of formatted email address strings
+ * @param recipients - Recipients to convert.
+ * @returns Formatted email address strings.
  */ function convertMailgunRecipientsToStrings(recipients) {
     return recipients.map(function(x) {
         return convertMailgunRecipientToString(x);
@@ -291,8 +292,8 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
  *
  * Returns "Name <email>" when a name is present, or just the email address otherwise.
  *
- * @param recipient - the recipient to convert
- * @returns a formatted email participant string
+ * @param recipient - The recipient to convert.
+ * @returns A formatted email participant string.
  */ function convertMailgunRecipientToString(recipient) {
     var address = recipient.email;
     if (recipient.name) {
@@ -303,8 +304,9 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
 /**
  * Encodes a value to a string for use as a Mailgun template variable. Throws an error if the value is not supported.
  *
- * @param value The value to encode.
+ * @param value - The value to encode.
  * @returns The encoded value, or undefined if the value is null or undefined.
+ * @throws {Error} When `value` has an unsupported runtime type.
  */ function encodeMailgunTemplateVariableValue(value) {
     var encodedValue;
     switch(typeof value === "undefined" ? "undefined" : _type_of$1(value)){
@@ -780,9 +782,10 @@ var mailgunLogger = new common.Logger('MailgunServiceModule');
  *
  * Automatically switches to sandbox credentials when USE_MAILGUN_SANDBOX is true or the environment is a test environment.
  *
- * @param configService - NestJS config service for reading environment variables
- * @param serverEnvironmentService - service indicating the current server environment
- * @returns a validated MailgunServiceConfig
+ * @param configService - NestJS config service for reading environment variables.
+ * @param serverEnvironmentService - Service indicating the current server environment.
+ * @returns A validated MailgunServiceConfig.
+ * @throws {Error} When sandbox mode is requested without sandbox credentials, or when `MAILGUN_SENDER_EMAIL` / `MAILGUN_API_KEY` / `MAILGUN_DOMAIN` are missing.
  */ function mailgunServiceConfigFactory(configService, serverEnvironmentService) {
     var _configService_get, _configService_get1, _configService_get2;
     var isTestingEnv = serverEnvironmentService.isTestingEnv;
@@ -945,8 +948,8 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * Creates a composite key from the from/replyTo email addresses used to group MailgunRecipientBatchSendTarget values.
  *
- * @param recipient - the batch send target whose from/replyTo addresses are used as the grouping key
- * @returns a string key in the form "f:{fromEmail}|r:{replyToEmail}" used to group recipients into batches
+ * @param recipient - Batch send target whose from/replyTo addresses are used as the grouping key.
+ * @returns Composite key in the form "f:{fromEmail}|r:{replyToEmail}" used to group recipients into batches.
  */ function mailgunRecipientBatchSendTargetFromReplyToBatchGroupKey(recipient) {
     var _ref, _ref1;
     var _recipient_from, _recipient_replyTo;
@@ -957,8 +960,9 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * Creates a ExpandMailgunRecipientBatchSendTargetRequestFactory from the input config.
  *
- * @param config
- * @returns
+ * @param config - Factory configuration providing the base request, recipient lookup, and per-recipient variable handling.
+ * @returns A factory that expands `MailgunRecipientBatchSendTarget` lists into individual `MailgunTemplateEmailRequest` objects.
+ * @throws {Error} When no subject is configured and `useSubjectFromRecipientUserVariables` is false.
  */ function expandMailgunRecipientBatchSendTargetRequestFactory(config) {
     var _inputBaseRequest_from, _inputBaseRequest_replyTo;
     var inputBaseRequest = config.request, useSubjectFromRecipientUserVariables = config.useSubjectFromRecipientUserVariables, allowSingleRecipientBatchSendRequests = config.allowSingleRecipientBatchSendRequests, recipientVariablesConfig = config.recipientVariablesConfig, mailgunRecipientBatchSendTargetEntityKeyRecipientLookup = config.mailgunRecipientBatchSendTargetEntityKeyRecipientLookup, overrideCarbonCopyVariablesWithCarbonCopyKeyRecipients = config.overrideCarbonCopyVariablesWithCarbonCopyKeyRecipients;
@@ -1097,7 +1101,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * Creates a MailgunRecipientBatchSendTargetEntityKeyRecipientLookup given the input configuration.
  *
- * @param config The configuration for the lookup.
+ * @param config - The configuration for the lookup.
  * @returns The lookup.
  */ function mailgunRecipientBatchSendTargetEntityKeyRecipientLookup(config) {
     var recipientsMap = config.recipientsMap;

package/mailgun/index.esm.js

@@ -121,6 +121,7 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
  *
  * @param config - The conversion configuration containing the email request, default sender, and recipient variable settings.
  * @returns The constructed {@link MailgunMessageData} ready to be sent via the Mailgun API.
+ * @throws {Error} When `batchSend` is enabled with `cc`/`bcc` set, when the recipient list exceeds {@link MAX_BATCH_SEND_RECIPIENTS}, or when attachments are supplied via both `messageData` and `request.attachments`.
  */ function convertMailgunTemplateEmailRequestToMailgunMessageData(config) {
     var _ref, _ref1, _ref2, _ref3, _request_finalizeRecipientVariables, _request_batchSend;
     var request = config.request, defaultSender = config.defaultSender, testEnvironment = config.isTestingEnvironment, tmp = config.recipientVariablePrefix, inputRecipientVariablePrefix = tmp === void 0 ? DEFAULT_RECIPIENT_VARIABLE_PREFIX : tmp, tmp1 = config.addRecipientVariablePrefixToAllMergedGlobalVariables, inputAddRecipientVariablePrefixToAllMergedGlobalVariables = tmp1 === void 0 ? true : tmp1, tmp2 = config.addCopyOfMergedRecipientVariablesWithoutPrefixToGlobalVariables, inputAddCopyOfMergedRecipientVariablesWithoutPrefixToGlobalVariables = tmp2 === void 0 ? false : tmp2, tmp3 = config.addCopyOfTemplateVariablesWithRecipientVariablePrefix, inputAddCopyOfTemplateVariablesWithRecipientVariablePrefix = tmp3 === void 0 ? false : tmp3;
@@ -277,8 +278,8 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
  *
  * Each recipient is formatted as "Name <email>" when a name is present, or just the email address.
  *
- * @param recipients - the recipients to convert
- * @returns an array of formatted email address strings
+ * @param recipients - Recipients to convert.
+ * @returns Formatted email address strings.
  */ function convertMailgunRecipientsToStrings(recipients) {
     return recipients.map(function(x) {
         return convertMailgunRecipientToString(x);
@@ -289,8 +290,8 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
  *
  * Returns "Name <email>" when a name is present, or just the email address otherwise.
  *
- * @param recipient - the recipient to convert
- * @returns a formatted email participant string
+ * @param recipient - The recipient to convert.
+ * @returns A formatted email participant string.
  */ function convertMailgunRecipientToString(recipient) {
     var address = recipient.email;
     if (recipient.name) {
@@ -301,8 +302,9 @@ var MAILGUN_REPLY_TO_EMAIL_HEADER_DATA_VARIABLE_KEY = "h:Reply-To";
 /**
  * Encodes a value to a string for use as a Mailgun template variable. Throws an error if the value is not supported.
  *
- * @param value The value to encode.
+ * @param value - The value to encode.
  * @returns The encoded value, or undefined if the value is null or undefined.
+ * @throws {Error} When `value` has an unsupported runtime type.
  */ function encodeMailgunTemplateVariableValue(value) {
     var encodedValue;
     switch(typeof value === "undefined" ? "undefined" : _type_of$1(value)){
@@ -778,9 +780,10 @@ var mailgunLogger = new Logger('MailgunServiceModule');
  *
  * Automatically switches to sandbox credentials when USE_MAILGUN_SANDBOX is true or the environment is a test environment.
  *
- * @param configService - NestJS config service for reading environment variables
- * @param serverEnvironmentService - service indicating the current server environment
- * @returns a validated MailgunServiceConfig
+ * @param configService - NestJS config service for reading environment variables.
+ * @param serverEnvironmentService - Service indicating the current server environment.
+ * @returns A validated MailgunServiceConfig.
+ * @throws {Error} When sandbox mode is requested without sandbox credentials, or when `MAILGUN_SENDER_EMAIL` / `MAILGUN_API_KEY` / `MAILGUN_DOMAIN` are missing.
  */ function mailgunServiceConfigFactory(configService, serverEnvironmentService) {
     var _configService_get, _configService_get1, _configService_get2;
     var isTestingEnv = serverEnvironmentService.isTestingEnv;
@@ -943,8 +946,8 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * Creates a composite key from the from/replyTo email addresses used to group MailgunRecipientBatchSendTarget values.
  *
- * @param recipient - the batch send target whose from/replyTo addresses are used as the grouping key
- * @returns a string key in the form "f:{fromEmail}|r:{replyToEmail}" used to group recipients into batches
+ * @param recipient - Batch send target whose from/replyTo addresses are used as the grouping key.
+ * @returns Composite key in the form "f:{fromEmail}|r:{replyToEmail}" used to group recipients into batches.
  */ function mailgunRecipientBatchSendTargetFromReplyToBatchGroupKey(recipient) {
     var _ref, _ref1;
     var _recipient_from, _recipient_replyTo;
@@ -955,8 +958,9 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * Creates a ExpandMailgunRecipientBatchSendTargetRequestFactory from the input config.
  *
- * @param config
- * @returns
+ * @param config - Factory configuration providing the base request, recipient lookup, and per-recipient variable handling.
+ * @returns A factory that expands `MailgunRecipientBatchSendTarget` lists into individual `MailgunTemplateEmailRequest` objects.
+ * @throws {Error} When no subject is configured and `useSubjectFromRecipientUserVariables` is false.
  */ function expandMailgunRecipientBatchSendTargetRequestFactory(config) {
     var _inputBaseRequest_from, _inputBaseRequest_replyTo;
     var inputBaseRequest = config.request, useSubjectFromRecipientUserVariables = config.useSubjectFromRecipientUserVariables, allowSingleRecipientBatchSendRequests = config.allowSingleRecipientBatchSendRequests, recipientVariablesConfig = config.recipientVariablesConfig, mailgunRecipientBatchSendTargetEntityKeyRecipientLookup = config.mailgunRecipientBatchSendTargetEntityKeyRecipientLookup, overrideCarbonCopyVariablesWithCarbonCopyKeyRecipients = config.overrideCarbonCopyVariablesWithCarbonCopyKeyRecipients;
@@ -1095,7 +1099,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * Creates a MailgunRecipientBatchSendTargetEntityKeyRecipientLookup given the input configuration.
  *
- * @param config The configuration for the lookup.
+ * @param config - The configuration for the lookup.
  * @returns The lookup.
  */ function mailgunRecipientBatchSendTargetEntityKeyRecipientLookup(config) {
     var recipientsMap = config.recipientsMap;

package/mailgun/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/nestjs/mailgun",
-  "version": "13.11.13",
+  "version": "13.11.15",
   "peerDependencies": {
-    "@dereekb/date": "13.11.13",
-    "@dereekb/model": "13.11.13",
-    "@dereekb/nestjs": "13.11.13",
-    "@dereekb/rxjs": "13.11.13",
-    "@dereekb/util": "13.11.13",
+    "@dereekb/date": "13.11.15",
+    "@dereekb/model": "13.11.15",
+    "@dereekb/nestjs": "13.11.15",
+    "@dereekb/rxjs": "13.11.15",
+    "@dereekb/util": "13.11.15",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "form-data": "^4.0.5",