@salespark/toolkit 2.1.22 → 2.1.23

package/dist/index.d.cts

@@ -1102,8 +1102,95 @@ type SmsLengthResult = {
  ****************************************************/
 declare const smsLength: (text: string, singleOverrides?: Partial<Record<SmsEncoding, number>>, multiOverrides?: Partial<Record<SmsEncoding, number>>) => SmsLengthResult;
 
+/******************************************************************
+ * ##: Generate Random Number (non-crypto)
+ * Returns a floating-point value in the range [0, 1) using Math.random().
+ * @returns {number} - Random float between 0 (inclusive) and 1 (exclusive)
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const random: () => number;
+/******************************************************************
+ * ##: Pick Random Array Item
+ * Selects a random element from the provided array using Math.random().
+ * @param {unknown[]} array - Source array to pick from
+ * @returns {unknown} - Random element (undefined if array is empty)
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const randFromArray: (array: unknown[]) => unknown;
+/******************************************************************
+ * ##: Random Integer From Interval
+ * Generates an integer in the range [min, max) using Math.random().
+ * @param {number} min - Inclusive lower bound
+ * @param {number} max - Exclusive upper bound
+ * @returns {number} - Random integer within the interval
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const randIntFromInterval: (min: number, max: number) => number;
+/******************************************************************
+ * ##: Shuffle Array In Place
+ * Applies the Durstenfeld shuffle to randomize the array order in place.
+ * @param {T[]} array - Array to shuffle (mutated)
+ * @returns {T[]} - The same array instance, shuffled
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare function shuffleArrayMutate<T>(array: T[]): T[];
+/******************************************************************
+ * ##: Shuffle Array Copy
+ * Returns a shuffled copy of the input array without mutating the original.
+ * @param {T[]} array - Array to shuffle (not mutated)
+ * @returns {T[]} - New array with randomized order
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const shuffleArray: <T>(array: T[]) => T[];
+/******************************************************************
+ * ##: Shuffle String Parts
+ * Shuffles a string by splitting on a delimiter and rejoining after shuffle.
+ * @param {string} str - Input string to shuffle
+ * @param {string} delimiter - Split/join delimiter (default: empty string)
+ * @returns {string} - Shuffled string
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const shuffleString: (str: string, delimiter?: string) => string;
+/******************************************************************
+ * ##: Create Random Token (non-crypto)
+ * Builds a token string from a configurable alphabet and shuffles it.
+ * Notes: This uses Math.random() and is NOT cryptographically secure.
+ * @param {object} options - Token generation options
+ * @param {boolean} options.withUppercase - Include A-Z (default: true)
+ * @param {boolean} options.withLowercase - Include a-z (default: true)
+ * @param {boolean} options.withNumbers - Include 0-9 (default: true)
+ * @param {boolean} options.withSymbols - Include symbols (default: false)
+ * @param {number} options.length - Token length (default: 64)
+ * @param {string} options.alphabet - Custom alphabet (overrides flags)
+ * @returns {string} - Generated token
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare function createToken({ withUppercase, withLowercase, withNumbers, withSymbols, length, alphabet, }?: {
+    withUppercase?: boolean;
+    withLowercase?: boolean;
+    withNumbers?: boolean;
+    withSymbols?: boolean;
+    length?: number;
+    alphabet?: string;
+}): string;
+/******************************************************************
+ * ##: Generate Random ID String
+ * Builds a short id with a base36 random segment prefixed by "id-".
+ * @returns {string} - Random id string
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const generateRandomId: () => string;
+
 /** Environment helpers (runtime-agnostic checks) */
 declare const isBrowser: boolean;
 declare const isNode: boolean;
 
-export { type CapitalizeFirstOptions, type CapitalizeWordsOptions, type DeferFn, type EncodeDecodeConfig, type FormatCurrencyProOptions, GSM_7BIT_EXT_CHAR_REGEXP, GSM_7BIT_EXT_REGEXP, GSM_7BIT_REGEXP, type GenerateOptions, type HttpResponseLike, type SecurityCheckResult, type SecurityRisk, type SentenceCaseOptions, type SmsEncoding, type SmsLengthResult, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, decodeBase36Code, decodeObject, decodeString, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, difference, encodeBase36Code, encodeObject, encodeString, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, generatePassword, generatePasswordWithOptions, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrEmptyObject, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, numbersEqual, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeAdd, safeDivide, safeJSONParse, safeMultiply, safeParseFloat, safeParseInt, safeSubtract, sanitize, sanitizeMarkdown, sentenceCase, shuffle, slugify, smsLength, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { type CapitalizeFirstOptions, type CapitalizeWordsOptions, type DeferFn, type EncodeDecodeConfig, type FormatCurrencyProOptions, GSM_7BIT_EXT_CHAR_REGEXP, GSM_7BIT_EXT_REGEXP, GSM_7BIT_REGEXP, type GenerateOptions, type HttpResponseLike, type SecurityCheckResult, type SecurityRisk, type SentenceCaseOptions, type SmsEncoding, type SmsLengthResult, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, createToken, currencyToSymbol, debounce, deburr, decodeBase36Code, decodeObject, decodeString, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, difference, encodeBase36Code, encodeObject, encodeString, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, generatePassword, generatePasswordWithOptions, generateRandomId, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrEmptyObject, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, numbersEqual, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randFromArray, randIntFromInterval, random, randomDigits, removeDiacritics, round, safeAdd, safeDivide, safeJSONParse, safeMultiply, safeParseFloat, safeParseInt, safeSubtract, sanitize, sanitizeMarkdown, sentenceCase, shuffle, shuffleArray, shuffleArrayMutate, shuffleString, slugify, smsLength, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };

package/dist/index.d.ts

@@ -1102,8 +1102,95 @@ type SmsLengthResult = {
  ****************************************************/
 declare const smsLength: (text: string, singleOverrides?: Partial<Record<SmsEncoding, number>>, multiOverrides?: Partial<Record<SmsEncoding, number>>) => SmsLengthResult;
 
+/******************************************************************
+ * ##: Generate Random Number (non-crypto)
+ * Returns a floating-point value in the range [0, 1) using Math.random().
+ * @returns {number} - Random float between 0 (inclusive) and 1 (exclusive)
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const random: () => number;
+/******************************************************************
+ * ##: Pick Random Array Item
+ * Selects a random element from the provided array using Math.random().
+ * @param {unknown[]} array - Source array to pick from
+ * @returns {unknown} - Random element (undefined if array is empty)
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const randFromArray: (array: unknown[]) => unknown;
+/******************************************************************
+ * ##: Random Integer From Interval
+ * Generates an integer in the range [min, max) using Math.random().
+ * @param {number} min - Inclusive lower bound
+ * @param {number} max - Exclusive upper bound
+ * @returns {number} - Random integer within the interval
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const randIntFromInterval: (min: number, max: number) => number;
+/******************************************************************
+ * ##: Shuffle Array In Place
+ * Applies the Durstenfeld shuffle to randomize the array order in place.
+ * @param {T[]} array - Array to shuffle (mutated)
+ * @returns {T[]} - The same array instance, shuffled
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare function shuffleArrayMutate<T>(array: T[]): T[];
+/******************************************************************
+ * ##: Shuffle Array Copy
+ * Returns a shuffled copy of the input array without mutating the original.
+ * @param {T[]} array - Array to shuffle (not mutated)
+ * @returns {T[]} - New array with randomized order
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const shuffleArray: <T>(array: T[]) => T[];
+/******************************************************************
+ * ##: Shuffle String Parts
+ * Shuffles a string by splitting on a delimiter and rejoining after shuffle.
+ * @param {string} str - Input string to shuffle
+ * @param {string} delimiter - Split/join delimiter (default: empty string)
+ * @returns {string} - Shuffled string
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const shuffleString: (str: string, delimiter?: string) => string;
+/******************************************************************
+ * ##: Create Random Token (non-crypto)
+ * Builds a token string from a configurable alphabet and shuffles it.
+ * Notes: This uses Math.random() and is NOT cryptographically secure.
+ * @param {object} options - Token generation options
+ * @param {boolean} options.withUppercase - Include A-Z (default: true)
+ * @param {boolean} options.withLowercase - Include a-z (default: true)
+ * @param {boolean} options.withNumbers - Include 0-9 (default: true)
+ * @param {boolean} options.withSymbols - Include symbols (default: false)
+ * @param {number} options.length - Token length (default: 64)
+ * @param {string} options.alphabet - Custom alphabet (overrides flags)
+ * @returns {string} - Generated token
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare function createToken({ withUppercase, withLowercase, withNumbers, withSymbols, length, alphabet, }?: {
+    withUppercase?: boolean;
+    withLowercase?: boolean;
+    withNumbers?: boolean;
+    withSymbols?: boolean;
+    length?: number;
+    alphabet?: string;
+}): string;
+/******************************************************************
+ * ##: Generate Random ID String
+ * Builds a short id with a base36 random segment prefixed by "id-".
+ * @returns {string} - Random id string
+ * History:
+ * 28-03-2026: Created
+ ******************************************************************/
+declare const generateRandomId: () => string;
+
 /** Environment helpers (runtime-agnostic checks) */
 declare const isBrowser: boolean;
 declare const isNode: boolean;
 
-export { type CapitalizeFirstOptions, type CapitalizeWordsOptions, type DeferFn, type EncodeDecodeConfig, type FormatCurrencyProOptions, GSM_7BIT_EXT_CHAR_REGEXP, GSM_7BIT_EXT_REGEXP, GSM_7BIT_REGEXP, type GenerateOptions, type HttpResponseLike, type SecurityCheckResult, type SecurityRisk, type SentenceCaseOptions, type SmsEncoding, type SmsLengthResult, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, decodeBase36Code, decodeObject, decodeString, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, difference, encodeBase36Code, encodeObject, encodeString, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, generatePassword, generatePasswordWithOptions, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrEmptyObject, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, numbersEqual, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeAdd, safeDivide, safeJSONParse, safeMultiply, safeParseFloat, safeParseInt, safeSubtract, sanitize, sanitizeMarkdown, sentenceCase, shuffle, slugify, smsLength, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { type CapitalizeFirstOptions, type CapitalizeWordsOptions, type DeferFn, type EncodeDecodeConfig, type FormatCurrencyProOptions, GSM_7BIT_EXT_CHAR_REGEXP, GSM_7BIT_EXT_REGEXP, GSM_7BIT_REGEXP, type GenerateOptions, type HttpResponseLike, type SecurityCheckResult, type SecurityRisk, type SentenceCaseOptions, type SmsEncoding, type SmsLengthResult, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, createToken, currencyToSymbol, debounce, deburr, decodeBase36Code, decodeObject, decodeString, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, difference, encodeBase36Code, encodeObject, encodeString, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, generatePassword, generatePasswordWithOptions, generateRandomId, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrEmptyObject, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, numbersEqual, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randFromArray, randIntFromInterval, random, randomDigits, removeDiacritics, round, safeAdd, safeDivide, safeJSONParse, safeMultiply, safeParseFloat, safeParseInt, safeSubtract, sanitize, sanitizeMarkdown, sentenceCase, shuffle, shuffleArray, shuffleArrayMutate, shuffleString, slugify, smsLength, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };

package/dist/index.js

@@ -2675,10 +2675,47 @@ var smsLength = (text, singleOverrides, multiOverrides) => {
   };
 };
 
+// src/utils/random.ts
+var random = () => Math.random();
+var randFromArray = (array) => array[Math.floor(random() * array.length)];
+var randIntFromInterval = (min, max) => Math.floor(random() * (max - min) + min);
+function shuffleArrayMutate(array) {
+  for (let i = array.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [array[i], array[j]] = [array[j], array[i]];
+  }
+  return array;
+}
+var shuffleArray = (array) => shuffleArrayMutate([...array]);
+var shuffleString = (str, delimiter = "") => shuffleArrayMutate(str.split(delimiter)).join(delimiter);
+function createToken({
+  withUppercase = true,
+  withLowercase = true,
+  withNumbers = true,
+  withSymbols = false,
+  length = 64,
+  alphabet
+} = {}) {
+  const allAlphabet = alphabet ?? [
+    withUppercase ? "ABCDEFGHIJKLMOPQRSTUVWXYZ" : "",
+    withLowercase ? "abcdefghijklmopqrstuvwxyz" : "",
+    withNumbers ? "0123456789" : "",
+    withSymbols ? `.,;:!?./-"'#{([-|\\@)]=}*+` : ""
+  ].join("");
+  const safeLength = Number.isFinite(length) ? Math.max(0, Math.floor(length)) : 0;
+  if (!allAlphabet || safeLength === 0) return "";
+  let token = "";
+  for (let i = 0; i < safeLength; i++) {
+    token += allAlphabet[Math.floor(random() * allAlphabet.length)];
+  }
+  return token;
+}
+var generateRandomId = () => `id-${random().toString(36).substring(2, 12)}`;
+
 // src/index.ts
 var isBrowser = typeof globalThis !== "undefined" && typeof globalThis.document !== "undefined";
 var isNode = typeof process !== "undefined" && !!process.versions?.node;
 
-export { GSM_7BIT_EXT_CHAR_REGEXP, GSM_7BIT_EXT_REGEXP, GSM_7BIT_REGEXP, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, decodeBase36Code, decodeObject, decodeString, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, difference, encodeBase36Code, encodeObject, encodeString, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, generatePassword, generatePasswordWithOptions, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrEmptyObject, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, numbersEqual, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeAdd, safeDivide, safeJSONParse, safeMultiply, safeParseFloat, safeParseInt, safeSubtract, sanitize, sanitizeMarkdown, sentenceCase, shuffle, slugify, smsLength, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { GSM_7BIT_EXT_CHAR_REGEXP, GSM_7BIT_EXT_REGEXP, GSM_7BIT_REGEXP, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, createToken, currencyToSymbol, debounce, deburr, decodeBase36Code, decodeObject, decodeString, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, difference, encodeBase36Code, encodeObject, encodeString, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, generatePassword, generatePasswordWithOptions, generateRandomId, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrEmptyObject, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, numbersEqual, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randFromArray, randIntFromInterval, random, randomDigits, removeDiacritics, round, safeAdd, safeDivide, safeJSONParse, safeMultiply, safeParseFloat, safeParseInt, safeSubtract, sanitize, sanitizeMarkdown, sentenceCase, shuffle, shuffleArray, shuffleArrayMutate, shuffleString, slugify, smsLength, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map