@dereekb/util 13.2.2 → 13.3.0

package/fetch/index.cjs.js

@@ -2205,6 +2205,22 @@ function iterateFetchPages(config) {
     }
     return searchParams;
 }
+/**
+ * Creates a URL query string from the input objects.
+ *
+ * Equivalent to `makeUrlSearchParams(...).toString()`, but respects the
+ * {@link MakeUrlSearchParamsOptions.usePercentEncoding} option to produce
+ * RFC 3986 percent-encoded output (`%20` for spaces) instead of the
+ * `application/x-www-form-urlencoded` default (`+` for spaces).
+ *
+ * @param input - objects to encode as query parameters
+ * @param options - encoding options
+ * @returns the encoded query string (without a leading `?`)
+ */ function makeUrlSearchParamsString(input, options) {
+    var params = makeUrlSearchParams(input, options);
+    var str = params.toString();
+    return (options === null || options === void 0 ? void 0 : options.useUrlSearchSpaceHandling) ? str.replace(/\+/g, '%20') : str;
+}
 /**
  * Merges an array of MakeUrlSearchParamsOptions into a single MakeUrlSearchParamsOptions value.
  */ function mergeMakeUrlSearchParamsOptions(options) {
@@ -2652,6 +2668,7 @@ exports.iterateFetchPagesByEachItem = iterateFetchPagesByEachItem;
 exports.iterateFetchPagesByItems = iterateFetchPagesByItems;
 exports.makeFileForFetch = makeFileForFetch;
 exports.makeUrlSearchParams = makeUrlSearchParams;
+exports.makeUrlSearchParamsString = makeUrlSearchParamsString;
 exports.mergeMakeUrlSearchParamsOptions = mergeMakeUrlSearchParamsOptions;
 exports.mergeRequestHeaders = mergeRequestHeaders;
 exports.mergeRequestInits = mergeRequestInits;

package/fetch/index.esm.js

@@ -2203,6 +2203,22 @@ function iterateFetchPages(config) {
     }
     return searchParams;
 }
+/**
+ * Creates a URL query string from the input objects.
+ *
+ * Equivalent to `makeUrlSearchParams(...).toString()`, but respects the
+ * {@link MakeUrlSearchParamsOptions.usePercentEncoding} option to produce
+ * RFC 3986 percent-encoded output (`%20` for spaces) instead of the
+ * `application/x-www-form-urlencoded` default (`+` for spaces).
+ *
+ * @param input - objects to encode as query parameters
+ * @param options - encoding options
+ * @returns the encoded query string (without a leading `?`)
+ */ function makeUrlSearchParamsString(input, options) {
+    var params = makeUrlSearchParams(input, options);
+    var str = params.toString();
+    return (options === null || options === void 0 ? void 0 : options.useUrlSearchSpaceHandling) ? str.replace(/\+/g, '%20') : str;
+}
 /**
  * Merges an array of MakeUrlSearchParamsOptions into a single MakeUrlSearchParamsOptions value.
  */ function mergeMakeUrlSearchParamsOptions(options) {
@@ -2616,4 +2632,4 @@ var fetchJsonRequestInit = fetchJsonRequestInitFunction();
     }
 });
 
-export { DEFAULT_FETCH_HANDLER, DEFAULT_FETCH_REQUEST_FACTORY, FETCH_PAGE_FACTORY_DEFAULT_MAX_PAGE, FetchPageLimitReachedError, FetchPageNoNextPageError, FetchRequestFactoryError, FetchResponseError, FetchTimeoutError, JsonResponseParseError, configureFetch, fetchApiFetchService, fetchFileFromUrl, fetchJsonBodyString, fetchJsonFunction, fetchJsonRequestInit, fetchJsonRequestInitFunction, fetchOk, fetchPageFactory, fetchRequestFactory, fetchService, fetchTimeout, fetchURL, fetchURLQueryKeyValueStringTuples, fetchURLSearchParamsObjectToURLSearchParams, fetchUploadFile, headersToHeadersTuple, isFetchRequest, isURL, isURLSearchParams, iterateFetchPages, iterateFetchPagesByEachItem, iterateFetchPagesByItems, makeFileForFetch, makeUrlSearchParams, mergeMakeUrlSearchParamsOptions, mergeRequestHeaders, mergeRequestInits, parseFetchFileResponse, queryParamsToSearchParams, rateLimitedFetchHandler, requireOkResponse, returnNullHandleFetchJsonParseErrorFunction, throwJsonResponseParseErrorFunction };
+export { DEFAULT_FETCH_HANDLER, DEFAULT_FETCH_REQUEST_FACTORY, FETCH_PAGE_FACTORY_DEFAULT_MAX_PAGE, FetchPageLimitReachedError, FetchPageNoNextPageError, FetchRequestFactoryError, FetchResponseError, FetchTimeoutError, JsonResponseParseError, configureFetch, fetchApiFetchService, fetchFileFromUrl, fetchJsonBodyString, fetchJsonFunction, fetchJsonRequestInit, fetchJsonRequestInitFunction, fetchOk, fetchPageFactory, fetchRequestFactory, fetchService, fetchTimeout, fetchURL, fetchURLQueryKeyValueStringTuples, fetchURLSearchParamsObjectToURLSearchParams, fetchUploadFile, headersToHeadersTuple, isFetchRequest, isURL, isURLSearchParams, iterateFetchPages, iterateFetchPagesByEachItem, iterateFetchPagesByItems, makeFileForFetch, makeUrlSearchParams, makeUrlSearchParamsString, mergeMakeUrlSearchParamsOptions, mergeRequestHeaders, mergeRequestInits, parseFetchFileResponse, queryParamsToSearchParams, rateLimitedFetchHandler, requireOkResponse, returnNullHandleFetchJsonParseErrorFunction, throwJsonResponseParseErrorFunction };

package/fetch/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "13.2.2",
+  "version": "13.3.0",
   "peerDependencies": {
-    "@dereekb/util": "13.2.2",
+    "@dereekb/util": "13.3.0",
     "make-error": "^1.3.0",
     "fast-content-type-parse": "^3.0.0"
   },

package/fetch/src/lib/fetch.url.d.ts

@@ -13,6 +13,23 @@ export interface MakeUrlSearchParamsOptions {
      * Defaults to true.
      */
     readonly filterEmptyValues?: boolean;
+    /**
+     * Whether to encode spaces as `%20` instead of `+` in the output string.
+     *
+     * `URLSearchParams.toString()` uses `application/x-www-form-urlencoded` encoding,
+     * which represents spaces as `+`. However, `URL.search` and `decodeURIComponent()`
+     * encode spaces as `%20`. This mismatch means that consumers like Angular's router
+     * that use `decodeURIComponent()` will not decode `+` back to a space, corrupting
+     * values (e.g., `"openid profile"` becomes `"openid+profile"`).
+     *
+     * Set to `true` when building redirect URLs or any URL that will be decoded with
+     * `decodeURIComponent()` rather than form-data parsing.
+     *
+     * Defaults to false.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams#interaction_with_url.searchparams | MDN: Interaction with URL.searchParams}
+     */
+    readonly useUrlSearchSpaceHandling?: boolean;
 }
 /**
  * Creates URLSearchParams from the input objects. The input objects are merged together.
@@ -22,6 +39,19 @@ export interface MakeUrlSearchParamsOptions {
  * @returns
  */
 export declare function makeUrlSearchParams(input: Maybe<ArrayOrValue<Maybe<object | Record<string, string | number>>>>, options?: Maybe<MakeUrlSearchParamsOptions>): URLSearchParams;
+/**
+ * Creates a URL query string from the input objects.
+ *
+ * Equivalent to `makeUrlSearchParams(...).toString()`, but respects the
+ * {@link MakeUrlSearchParamsOptions.usePercentEncoding} option to produce
+ * RFC 3986 percent-encoded output (`%20` for spaces) instead of the
+ * `application/x-www-form-urlencoded` default (`+` for spaces).
+ *
+ * @param input - objects to encode as query parameters
+ * @param options - encoding options
+ * @returns the encoded query string (without a leading `?`)
+ */
+export declare function makeUrlSearchParamsString(input: Maybe<ArrayOrValue<Maybe<object | Record<string, string | number>>>>, options?: Maybe<MakeUrlSearchParamsOptions>): string;
 /**
  * Merges an array of MakeUrlSearchParamsOptions into a single MakeUrlSearchParamsOptions value.
  */

package/index.cjs.js

@@ -4024,6 +4024,62 @@ var DOLLAR_AMOUNT_STRING_REGEX = /^\$?([0-9]+)\.?([0-9][0-9])$/;
     return chainMapSameFunctions(transformFunctions);
 }
 
+/**
+ * Encodes a number as a radix-36 string.
+ *
+ * Uses digits 0-9 and lowercase letters a-z, producing compact representations
+ * that are useful for URL-safe identifiers and short codes.
+ *
+ * @param number - The number to encode. Should be a non-negative integer for consistent results.
+ * @returns The radix-36 encoded string representation.
+ *
+ * @example
+ * ```ts
+ * encodeRadix36Number(0);   // '0'
+ * encodeRadix36Number(35);  // 'z'
+ * encodeRadix36Number(100); // '2s'
+ * ```
+ */ function encodeRadix36Number(number) {
+    return number.toString(36);
+}
+/**
+ * Decodes a radix-36 encoded string back to a number.
+ *
+ * Parses a string containing digits 0-9 and letters a-z (case-insensitive)
+ * as a base-36 number.
+ *
+ * @param encoded - The radix-36 encoded string to decode.
+ * @returns The decoded numeric value. Returns `NaN` if the input is not a valid radix-36 string.
+ *
+ * @example
+ * ```ts
+ * decodeRadix36Number('0');  // 0
+ * decodeRadix36Number('z');  // 35
+ * decodeRadix36Number('2s'); // 100
+ * ```
+ */ function decodeRadix36Number(encoded) {
+    return parseInt(encoded, 36);
+}
+/**
+ * Pattern that matches strings containing only hexadecimal characters (0-9, a-f, A-F).
+ */ var HEX_PATTERN = /^[0-9a-fA-F]+$/;
+/**
+ * Checks whether the input string contains only valid hexadecimal characters.
+ *
+ * @example
+ * ```ts
+ * isHex('a1b2c3'); // true
+ * isHex('FF00AA'); // true
+ * isHex('hello');  // false
+ * isHex('');       // false
+ * ```
+ *
+ * @param value - The string to check.
+ * @returns True if the string is non-empty and contains only hex characters.
+ */ function isHex(value) {
+    return HEX_PATTERN.test(value);
+}
+
 /**
  * Reduces an array of numbers to its maximum value.
  *
@@ -5277,9 +5333,9 @@ function arrayToObject(values, keyFn) {
 /**
  * Default comma joiner character used by comma-related string functions.
  */ var COMMA_JOINER = ',';
-function caseInsensitiveString(input) {
-    return input === null || input === void 0 ? void 0 : input.toLocaleLowerCase();
-}
+/**
+ * Default space joiner character used by space-related string functions.
+ */ var SPACE_JOINER = ' ';
 function joinStrings(input) {
     var joiner = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : COMMA_JOINER, trim = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : false;
     if (input == null) {
@@ -5293,26 +5349,103 @@ function joinStrings(input) {
     }
     return array.filter(Boolean).join(joiner);
 }
-function joinStringsWithCommas(input) {
-    var trim = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
-    return joinStrings(input, COMMA_JOINER, trim);
+/**
+ * Splits a string like {@link String.prototype.split}, but joins overflow segments back together
+ * instead of discarding them. Useful when you only want to split on the first N-1 occurrences.
+ *
+ * @param input - string to split
+ * @param separator - delimiter to split on
+ * @param limit - maximum number of resulting segments; overflow segments are rejoined with the separator
+ * @returns array of string segments, with length at most equal to limit
+ */ function splitJoinRemainder(input, separator, limit) {
+    var split = input.split(separator);
+    var components = [];
+    if (split.length > 1) {
+        var hasItemsToMerge = split.length > limit;
+        var stopIndex = hasItemsToMerge ? limit - 1 : split.length;
+        for(var i = 0; i < stopIndex; i += 1){
+            components.push(split[i]);
+        }
+        if (hasItemsToMerge) {
+            components.push(split.slice(stopIndex).join(separator));
+        }
+    } else {
+        components.push(split[0]);
+    }
+    return components;
 }
-function splitCommaSeparatedString(input) {
-    var mapFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : function(x) {
-        return x;
+/**
+ * Creates a {@link JoinStringsInstance} that joins arrays of strings using the configured delimiter.
+ *
+ * @example
+ * ```ts
+ * const joinWithPipe = joinStringsInstance({ joiner: '|' });
+ * joinWithPipe(['a', 'b']); // 'a|b'
+ * joinWithPipe(null); // null
+ * ```
+ *
+ * @param config - configuration for the delimiter and default trim behavior
+ * @returns a new callable {@link JoinStringsInstance}
+ */ function joinStringsInstance(config) {
+    var joiner = config.joiner, _config_trimByDefault = config.trimByDefault, trimByDefault = _config_trimByDefault === void 0 ? false : _config_trimByDefault;
+    var fn = function fn(input) {
+        var trim = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : trimByDefault;
+        return joinStrings(input, joiner, trim);
     };
-    var splits = input.split(COMMA_JOINER);
-    return splits.map(function(x) {
-        return mapFn(x.trim());
-    });
+    fn.joiner = joiner;
+    fn.trimByDefault = trimByDefault;
+    return fn;
 }
 /**
- * Splits a comma-separated string into a Set of unique trimmed string values.
+ * Creates a {@link StringSplitJoinInstance} that splits and joins strings using the configured delimiter.
  *
- * @param input - comma-separated string to split, or null/undefined
- * @returns a Set of unique string values; empty Set if input is null/undefined
- */ function splitCommaSeparatedStringToSet(input) {
-    return new Set(input != null ? splitCommaSeparatedString(input) : []);
+ * @example
+ * ```ts
+ * const pipeSplitJoin = stringSplitJoinInstance({ joiner: '|' });
+ * pipeSplitJoin.joinStrings(['a', 'b']); // 'a|b'
+ * pipeSplitJoin.splitStrings('a|b'); // ['a', 'b']
+ * ```
+ *
+ * @param config - configuration for the delimiter and default trim behavior
+ * @returns a new {@link StringSplitJoinInstance}
+ */ function stringSplitJoinInstance(config) {
+    var joiner = config.joiner;
+    var joinStrings = joinStringsInstance(config);
+    var splitStrings = function splitStrings(input) {
+        var mapFn = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : function(x) {
+            return x;
+        };
+        var splits = input.split(joiner);
+        return splits.map(function(x) {
+            return mapFn(x.trim());
+        });
+    };
+    return {
+        joiner: joiner,
+        trimByDefault: joinStrings.trimByDefault,
+        joinStrings: joinStrings,
+        splitStrings: splitStrings,
+        splitStringsToSet: function splitStringsToSet(input) {
+            return new Set(input != null ? splitStrings(input) : []);
+        },
+        splitJoinRemainder: function splitJoinRemainder1(input, limit) {
+            return splitJoinRemainder(input, joiner, limit);
+        }
+    };
+}
+/**
+ * Global {@link StringSplitJoinInstance} that uses commas as the delimiter.
+ */ var COMMA_STRING_SPLIT_JOIN = stringSplitJoinInstance({
+    joiner: COMMA_JOINER
+});
+/**
+ * Global {@link StringSplitJoinInstance} that uses spaces as the delimiter, with trimming enabled by default.
+ */ var SPACE_STRING_SPLIT_JOIN = stringSplitJoinInstance({
+    joiner: SPACE_JOINER,
+    trimByDefault: true
+});
+function caseInsensitiveString(input) {
+    return input === null || input === void 0 ? void 0 : input.toLocaleLowerCase();
 }
 /**
  * Adds a plus prefix to the input value and converts it to a string. If the value is negative or 0, no prefix is added.
@@ -5346,34 +5479,6 @@ function splitCommaSeparatedString(input) {
  */ function lowercaseFirstLetter(value) {
     return value.charAt(0).toLowerCase() + value.slice(1);
 }
-/**
- * Splits a string like {@link String.prototype.split}, but joins overflow segments back together
- * instead of discarding them. Useful when you only want to split on the first N-1 occurrences.
- *
- * @param input - string to split
- * @param separator - delimiter to split on
- * @param limit - maximum number of resulting segments; overflow segments are rejoined with the separator
- * @returns array of string segments, with length at most equal to limit
- */ function splitJoinRemainder(input, separator, limit) {
-    var split = input.split(separator);
-    var components = [];
-    if (split.length > 1) {
-        var hasItemsToMerge = split.length > limit;
-        var stopIndex = hasItemsToMerge ? limit - 1 : split.length;
-        for(var i = 0; i < stopIndex; i += 1){
-            components.push(split[i]);
-        }
-        if (hasItemsToMerge) {
-            components.push(split.slice(stopIndex).join(separator));
-        }
-    } else {
-        components.push(split[0]);
-    }
-    return components;
-}
-/**
- * Default space joiner character used by space-related string functions.
- */ var SPACE_JOINER = ' ';
 /**
  * Splits the input string into a first name and last name tuple using a space as the delimiter.
  * If the name contains more than one space, the remainder is treated as the last name.
@@ -5381,10 +5486,7 @@ function splitCommaSeparatedString(input) {
  * @param input - full name string to split
  * @returns a tuple of [firstName, lastName], where lastName includes all text after the first space
  */ function splitJoinNameString(input) {
-    return splitJoinRemainder(input, SPACE_JOINER, 2);
-}
-function joinStringsWithSpaces(input) {
-    return joinStrings(input, SPACE_JOINER, true);
+    return SPACE_STRING_SPLIT_JOIN.splitJoinRemainder(input, 2);
 }
 /**
  * Creates a string that repeats the given string a specified number of times.
@@ -5455,6 +5557,41 @@ function joinStringsWithSpaces(input) {
  */ function simplifyWhitespace(input) {
     return input.split(/\r?\n/).filter(Boolean).map(flattenWhitespace).join('\n');
 }
+// MARK: Compat
+/**
+ * Joins an array of strings into a single string using commas. Does not trim empty values by default.
+ *
+ * Delegates to {@link COMMA_STRING_SPLIT_JOIN}.
+ *
+ * @param input string or array of strings
+ * @param trim whether or not to trim the strings before joining. Defaults to false.
+ * @returns joined string, or null/undefined if the input is null/undefined
+ */ var joinStringsWithCommas = COMMA_STRING_SPLIT_JOIN.joinStrings;
+/**
+ * Splits a comma-separated string into an array of strings.
+ *
+ * Delegates to {@link COMMA_STRING_SPLIT_JOIN}.
+ *
+ * @param input string to split
+ * @param mapFn function to map each split string to a value
+ * @returns array of strings
+ */ var splitCommaSeparatedString = COMMA_STRING_SPLIT_JOIN.splitStrings;
+/**
+ * Splits a comma-separated string into a Set of unique trimmed string values.
+ *
+ * Delegates to {@link COMMA_STRING_SPLIT_JOIN}.
+ *
+ * @param input - comma-separated string to split, or null/undefined
+ * @returns a Set of unique string values; empty Set if input is null/undefined
+ */ var splitCommaSeparatedStringToSet = COMMA_STRING_SPLIT_JOIN.splitStringsToSet;
+/**
+ * Joins one or more strings together with spaces. Extra spaces are trimmed from the values.
+ *
+ * Delegates to {@link SPACE_STRING_SPLIT_JOIN}.
+ *
+ * @param input string or array of strings
+ * @returns joined string, or null/undefined if the input is null/undefined
+ */ var joinStringsWithSpaces = SPACE_STRING_SPLIT_JOIN.joinStrings;
 
 /**
  * Maps each value in an iterable through a function and returns the results as an array.
@@ -8980,10 +9117,13 @@ function _unsupported_iterable_to_array$f(o, minLen) {
  * @param input - The string to analyze as a URL.
  * @returns An object containing parsed URL components and validation flags.
  */ function websiteUrlDetails(input) {
+    var _readPortNumber;
     var noHttp = removeHttpFromUrl(input);
     var splitPair = websiteDomainAndPathPairFromWebsiteUrl(noHttp);
     var domain = splitPair.domain, websitePath = splitPair.path;
     var pathHasWebsiteDomain = hasWebsiteDomain(domain);
+    var inputHasPortNumber = hasPortNumber(input);
+    var portNumber = inputHasPortNumber ? (_readPortNumber = readPortNumber(input)) !== null && _readPortNumber !== void 0 ? _readPortNumber : undefined : undefined;
     var _splitStringAtFirstCharacterOccurence = _sliced_to_array$c(splitStringAtFirstCharacterOccurence(splitPair.path, '?'), 2), path = _splitStringAtFirstCharacterOccurence[0], query = _splitStringAtFirstCharacterOccurence[1]; // everything after the query is ignored
     var isWebsiteUrl = pathHasWebsiteDomain && isSlashPathFolder(path + '/');
     var inputHasHttpPrefix = hasHttpPrefix(input);
@@ -8992,6 +9132,8 @@ function _unsupported_iterable_to_array$f(o, minLen) {
         isWebsiteUrl: isWebsiteUrl,
         hasWebsiteDomain: pathHasWebsiteDomain,
         hasHttpPrefix: inputHasHttpPrefix,
+        hasPortNumber: inputHasPortNumber,
+        portNumber: portNumber,
         splitPair: splitPair,
         domain: domain,
         websitePath: websitePath,
@@ -9028,6 +9170,9 @@ function _unsupported_iterable_to_array$f(o, minLen) {
  */ function websiteUrlFromPaths(basePath, paths, defaultProtocol) {
     var _readWebsiteProtocol;
     var protocol = (_readWebsiteProtocol = readWebsiteProtocol(basePath)) !== null && _readWebsiteProtocol !== void 0 ? _readWebsiteProtocol : defaultProtocol;
+    if (!basePath) {
+        return mergeSlashPaths(asArray(paths));
+    }
     var baseWebUrl = removeWebProtocolPrefix(baseWebsiteUrl(basePath)); // remove prefix to prevent issues with slash paths
     var webUrl = mergeSlashPaths([
         baseWebUrl
@@ -9706,6 +9851,23 @@ function toReadableError(inputError) {
     return ((typeof input === "undefined" ? "undefined" : _type_of$9(input)) === 'object' ? input.message : input) || input;
 }
 
+/**
+ * Returns true if the buffer appears to have the markings of a valid PDF.
+ *
+ * Checks for two structural markers defined by the PDF specification (ISO 32000):
+ * - `%PDF-` header at the start of the buffer, which identifies the file as a PDF document.
+ * - `%%EOF` marker somewhere in the buffer, which signals the end of a PDF file.
+ *
+ * This is a lightweight heuristic check, not a full validation. A buffer that passes
+ * this check is not guaranteed to be a well-formed or uncorrupted PDF — it only confirms
+ * the expected start/end markers are present.
+ *
+ * @param buffer - Buffer-like object to check. Only requires the `lastIndexOf` method.
+ * @returns true if both PDF markers are found in the expected positions.
+ */ function bufferHasValidPdfMarkings(buffer) {
+    return buffer.lastIndexOf('%PDF-') === 0 && buffer.lastIndexOf('%%EOF') > -1;
+}
+
 function _array_like_to_array$e(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];
@@ -12218,6 +12380,9 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
 /**
  * Number of minutes in an hour.
  */ var MINUTES_IN_HOUR = 60;
+/**
+ * Number of seconds in an hour.
+ */ var SECONDS_IN_HOUR = MINUTES_IN_HOUR * SECONDS_IN_MINUTE;
 /**
  * Number of milliseconds in a second.
  */ var MS_IN_SECOND = 1000;
@@ -19644,6 +19809,108 @@ function _ts_generator(thisArg, body) {
     return root;
 }
 
+// MARK: Mapped Types
+/**
+ * Default prefix used for encrypted field names.
+ */ var DEFAULT_ENCRYPTED_FIELD_PREFIX = '$';
+// MARK: Factory
+/**
+ * Creates a selective field encryptor that encrypts/decrypts specific fields on an object.
+ *
+ * Each encrypted field's value is JSON.stringified before encryption and JSON.parsed after
+ * decryption, so fields can hold any JSON-serializable value (not just strings).
+ *
+ * @example
+ * ```ts
+ * const encryptor = selectiveFieldEncryptor({
+ *   provider: myEncryptionProvider,
+ *   fields: ['client_secret'] as const
+ * });
+ *
+ * const encrypted = encryptor.encrypt({ client_id: 'abc', client_secret: 's3cret' });
+ * // encrypted => { client_id: 'abc', $client_secret: '<ciphertext>' }
+ *
+ * const decrypted = encryptor.decrypt(encrypted);
+ * // decrypted => { client_id: 'abc', client_secret: 's3cret' }
+ * ```
+ *
+ * @param config - Encryption configuration specifying provider, fields, and optional prefix.
+ * @returns A selective field encryptor instance.
+ */ function selectiveFieldEncryptor(config) {
+    var provider = config.provider, fields = config.fields, prefixInput = config.prefix;
+    var prefix = prefixInput !== null && prefixInput !== void 0 ? prefixInput : DEFAULT_ENCRYPTED_FIELD_PREFIX;
+    var fieldSet = new Set(fields);
+    var result = {
+        encrypt: function encrypt(input) {
+            var output = {};
+            var inputRecord = input;
+            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+            try {
+                for(var _iterator = Object.keys(inputRecord)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                    var key = _step.value;
+                    if (fieldSet.has(key)) {
+                        var json = JSON.stringify(inputRecord[key]);
+                        output["".concat(prefix).concat(key)] = provider.encrypt(json);
+                    } else {
+                        output[key] = inputRecord[key];
+                    }
+                }
+            } catch (err) {
+                _didIteratorError = true;
+                _iteratorError = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                        _iterator.return();
+                    }
+                } finally{
+                    if (_didIteratorError) {
+                        throw _iteratorError;
+                    }
+                }
+            }
+            return output;
+        },
+        decrypt: function decrypt(input) {
+            var output = {};
+            var inputRecord = input;
+            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+            try {
+                for(var _iterator = Object.keys(inputRecord)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                    var key = _step.value;
+                    var handled = false;
+                    if (key.startsWith(prefix)) {
+                        var originalKey = key.slice(prefix.length);
+                        if (fieldSet.has(originalKey)) {
+                            var decrypted = provider.decrypt(inputRecord[key]);
+                            output[originalKey] = JSON.parse(decrypted);
+                            handled = true;
+                        }
+                    }
+                    if (!handled) {
+                        output[key] = inputRecord[key];
+                    }
+                }
+            } catch (err) {
+                _didIteratorError = true;
+                _iteratorError = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                        _iterator.return();
+                    }
+                } finally{
+                    if (_didIteratorError) {
+                        throw _iteratorError;
+                    }
+                }
+            }
+            return output;
+        }
+    };
+    return result;
+}
+
 exports.ALL_DOUBLE_SLASHES_REGEX = ALL_DOUBLE_SLASHES_REGEX;
 exports.ALL_SLASHES_REGEX = ALL_SLASHES_REGEX;
 exports.ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX = ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX;
@@ -19666,12 +19933,14 @@ exports.AssertionIssueHandler = AssertionIssueHandler;
 exports.BooleanStringKeyArrayUtility = BooleanStringKeyArrayUtility;
 exports.CATCH_ALL_HANDLE_RESULT_KEY = CATCH_ALL_HANDLE_RESULT_KEY;
 exports.COMMA_JOINER = COMMA_JOINER;
+exports.COMMA_STRING_SPLIT_JOIN = COMMA_STRING_SPLIT_JOIN;
 exports.CSV_MIME_TYPE = CSV_MIME_TYPE;
 exports.CUT_VALUE_TO_ZERO_PRECISION = CUT_VALUE_TO_ZERO_PRECISION;
 exports.DASH_CHARACTER_PREFIX_INSTANCE = DASH_CHARACTER_PREFIX_INSTANCE;
 exports.DATE_NOW_VALUE = DATE_NOW_VALUE;
 exports.DAYS_IN_YEAR = DAYS_IN_YEAR;
 exports.DEFAULT_CUT_STRING_END_TEXT = DEFAULT_CUT_STRING_END_TEXT;
+exports.DEFAULT_ENCRYPTED_FIELD_PREFIX = DEFAULT_ENCRYPTED_FIELD_PREFIX;
 exports.DEFAULT_LAT_LNG_STRING_VALUE = DEFAULT_LAT_LNG_STRING_VALUE;
 exports.DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG = DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG;
 exports.DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG = DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG;
@@ -19701,6 +19970,7 @@ exports.GIF_MIME_TYPE = GIF_MIME_TYPE;
 exports.HAS_PORT_NUMBER_REGEX = HAS_PORT_NUMBER_REGEX;
 exports.HAS_WEBSITE_DOMAIN_NAME_REGEX = HAS_WEBSITE_DOMAIN_NAME_REGEX;
 exports.HEIF_MIME_TYPE = HEIF_MIME_TYPE;
+exports.HEX_PATTERN = HEX_PATTERN;
 exports.HOURS_IN_DAY = HOURS_IN_DAY;
 exports.HTML_MIME_TYPE = HTML_MIME_TYPE;
 exports.HTTP_OR_HTTPS_REGEX = HTTP_OR_HTTPS_REGEX;
@@ -19756,6 +20026,7 @@ exports.RAW_MIME_TYPE = RAW_MIME_TYPE;
 exports.REGEX_SPECIAL_CHARACTERS = REGEX_SPECIAL_CHARACTERS;
 exports.REGEX_SPECIAL_CHARACTERS_SET = REGEX_SPECIAL_CHARACTERS_SET;
 exports.RelationChange = RelationChange;
+exports.SECONDS_IN_HOUR = SECONDS_IN_HOUR;
 exports.SECONDS_IN_MINUTE = SECONDS_IN_MINUTE;
 exports.SHARED_MEMORY_STORAGE = SHARED_MEMORY_STORAGE;
 exports.SLASH_PATH_FILE_TYPE_SEPARATOR = SLASH_PATH_FILE_TYPE_SEPARATOR;
@@ -19764,6 +20035,7 @@ exports.SORT_VALUE_EQUAL = SORT_VALUE_EQUAL;
 exports.SORT_VALUE_GREATER_THAN = SORT_VALUE_GREATER_THAN;
 exports.SORT_VALUE_LESS_THAN = SORT_VALUE_LESS_THAN;
 exports.SPACE_JOINER = SPACE_JOINER;
+exports.SPACE_STRING_SPLIT_JOIN = SPACE_STRING_SPLIT_JOIN;
 exports.SPLIT_STRING_TREE_NODE_ROOT_VALUE = SPLIT_STRING_TREE_NODE_ROOT_VALUE;
 exports.SVG_MIME_TYPE = SVG_MIME_TYPE;
 exports.ServerErrorResponse = ServerErrorResponse;
@@ -19866,6 +20138,7 @@ exports.boundNumber = boundNumber;
 exports.boundNumberFunction = boundNumberFunction;
 exports.boundToRectangle = boundToRectangle;
 exports.breadthFirstExploreTreeTraversalFactoryFunction = breadthFirstExploreTreeTraversalFactoryFunction;
+exports.bufferHasValidPdfMarkings = bufferHasValidPdfMarkings;
 exports.build = build;
 exports.cachedGetter = cachedGetter;
 exports.calculateExpirationDate = calculateExpirationDate;
@@ -19936,6 +20209,7 @@ exports.decisionFunction = decisionFunction;
 exports.decodeHashedValues = decodeHashedValues;
 exports.decodeHashedValuesWithDecodeMap = decodeHashedValuesWithDecodeMap;
 exports.decodeModelKeyTypePair = decodeModelKeyTypePair;
+exports.decodeRadix36Number = decodeRadix36Number;
 exports.defaultFilterFromPOJOFunctionNoCopy = defaultFilterFromPOJOFunctionNoCopy;
 exports.defaultForwardFunctionFactory = defaultForwardFunctionFactory;
 exports.defaultLatLngPoint = defaultLatLngPoint;
@@ -19952,6 +20226,7 @@ exports.e164PhoneNumberFromE164PhoneNumberExtensionPair = e164PhoneNumberFromE16
 exports.enabledDaysFromDaysOfWeek = enabledDaysFromDaysOfWeek;
 exports.encodeBitwiseSet = encodeBitwiseSet;
 exports.encodeModelKeyTypePair = encodeModelKeyTypePair;
+exports.encodeRadix36Number = encodeRadix36Number;
 exports.errorMessageContainsString = errorMessageContainsString;
 exports.errorMessageContainsStringFunction = errorMessageContainsStringFunction;
 exports.escapeStringCharactersFunction = escapeStringCharactersFunction;
@@ -20118,6 +20393,7 @@ exports.isEvenNumber = isEvenNumber;
 exports.isFalseBooleanKeyArray = isFalseBooleanKeyArray;
 exports.isFinalPage = isFinalPage;
 exports.isGetter = isGetter;
+exports.isHex = isHex;
 exports.isISO8601DateString = isISO8601DateString;
 exports.isISO8601DayString = isISO8601DayString;
 exports.isISO8601DayStringStart = isISO8601DayStringStart;
@@ -20191,6 +20467,7 @@ exports.iterate = iterate;
 exports.iterateFilteredPages = iterateFilteredPages;
 exports.joinHostAndPort = joinHostAndPort;
 exports.joinStrings = joinStrings;
+exports.joinStringsInstance = joinStringsInstance;
 exports.joinStringsWithCommas = joinStringsWithCommas;
 exports.joinStringsWithSpaces = joinStringsWithSpaces;
 exports.keepCharactersAfterFirstCharacterOccurence = keepCharactersAfterFirstCharacterOccurence;
@@ -20450,6 +20727,7 @@ exports.safeEqualityComparatorFunction = safeEqualityComparatorFunction;
 exports.safeFindBestIndexMatch = safeFindBestIndexMatch;
 exports.searchStringFilterFunction = searchStringFilterFunction;
 exports.secondsToMinutesAndSeconds = secondsToMinutesAndSeconds;
+exports.selectiveFieldEncryptor = selectiveFieldEncryptor;
 exports.separateValues = separateValues;
 exports.separateValuesToSets = separateValuesToSets;
 exports.sequentialIncrementingNumberStringModelIdFactory = sequentialIncrementingNumberStringModelIdFactory;
@@ -20513,6 +20791,7 @@ exports.stringContains = stringContains;
 exports.stringFactoryFromFactory = stringFactoryFromFactory;
 exports.stringFromDateFactory = stringFromDateFactory;
 exports.stringFromTimeFactory = stringFromTimeFactory;
+exports.stringSplitJoinInstance = stringSplitJoinInstance;
 exports.stringToBoolean = stringToBoolean;
 exports.stringToLowercaseFunction = stringToLowercaseFunction;
 exports.stringToUppercaseFunction = stringToUppercaseFunction;