@salespark/toolkit 2.1.22 → 2.1.26

package/README.md

@@ -1,3 +1,5 @@
+> **npm registry notice:** On **2 May 2026** (timezone **Europe/Lisbon**), this package will no longer be **publicly** installable from the npm registry and will become **restricted to the SalesPark npm organization**. Until then, already-published versions remain public. **No further public releases** or support for external consumers is planned — if you depend on this package, **fork** before that date.
+
 # SalesPark Toolkit v2 - Documentation
 
 ## @salespark/toolkit
@@ -28,6 +30,7 @@ npm i @salespark/toolkit
 - **Object utilities**: pick, omit, clean objects, deep merge, etc.
 - **String utilities**: slugify, template fill, deburr, sanitize, capitalize words/sentences, SMS length.
 - **Number utilities**: clamp, round, safe arithmetic/comparisons, safe parse (locale-aware), random digits, etc.
+- **Random utilities**: token generation helpers (non-crypto), random IDs, shuffle helpers
 - **Function utilities**: debounce, throttle, safeJSONParse, formatCurrency, parseName, currency conversions, etc.
 - **Defer utilities**: post-return microtask scheduling, non-critical timers, after-response hooks.
 - **Boolean utilities**: safe boolean conversion with common representations
@@ -482,6 +485,58 @@ formatDecimalNumber("invalid", 2); // "0.00"
 - **`parseToNumber`** → Use `safeParseFloat` instead
 - **`otp`** → Use `randomDigits` instead
 
+### 🎲 Random Utilities
+
+**`createToken(options?: { withUppercase?: boolean; withLowercase?: boolean; withNumbers?: boolean; withSymbols?: boolean; length?: number; alphabet?: string }): string`** — Generates a random token string using Math.random (non-crypto) and a configurable alphabet.
+
+```javascript
+createToken(); // 64-char token (letters + numbers)
+createToken({ length: 16, withSymbols: true });
+createToken({ alphabet: "ABCDEF0123456789", length: 24 }); // custom alphabet
+```
+
+**`random(): number`** — Returns a random float in the range [0, 1) using Math.random (non-crypto).
+
+```javascript
+random(); // 0.123456...
+```
+
+**`randFromArray<T>(array: T[]): T`** — Picks a random element from an array.
+
+```javascript
+randFromArray(["a", "b", "c"]); // random element
+```
+
+**`randIntFromInterval(min: number, max: number): number`** — Returns a random integer in [min, max).
+
+```javascript
+randIntFromInterval(10, 20); // 10..19
+```
+
+**`shuffleArray<T>(array: T[]): T[]`** — Returns a shuffled copy of the input array.
+
+```javascript
+shuffleArray([1, 2, 3]); // new shuffled array
+```
+
+**`shuffleArrayMutate<T>(array: T[]): T[]`** — Shuffles an array in place (mutates input).
+
+```javascript
+shuffleArrayMutate([1, 2, 3]); // same array instance, shuffled
+```
+
+**`shuffleString(str: string, delimiter?: string): string`** — Shuffles a string by splitting and rejoining.
+
+```javascript
+shuffleString("abc"); // "bca" (random order)
+```
+
+**`generateRandomId(): string`** — Generates a short id with prefix "id-" and a base36 segment.
+
+```javascript
+generateRandomId(); // "id-5gk9x1c2qz" (random)
+```
+
 ### ✅ Boolean Utilities
 
 **`toBool(value: unknown, def?: boolean): boolean`** — Converts a value to boolean, supporting common string/number representations.
@@ -1114,5 +1169,5 @@ MIT © [SalesPark](https://salespark.io)
 
 ---
 
-_Document version: 18_  
-_Last update: 14-03-2026_
+_Document version: 19_  
+_Last update: 04-04-2026_

package/dist/index.cjs

@@ -2677,6 +2677,43 @@ 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;
@@ -2701,6 +2738,7 @@ exports.chunk = chunk;
 exports.clamp = clamp;
 exports.cleanObject = cleanObject;
 exports.compact = compact;
+exports.createToken = createToken;
 exports.currencyToSymbol = currencyToSymbol;
 exports.debounce = debounce;
 exports.deburr = deburr;
@@ -2727,6 +2765,7 @@ exports.formatCurrencyPro = formatCurrencyPro;
 exports.formatDecimalNumber = formatDecimalNumber;
 exports.generatePassword = generatePassword;
 exports.generatePasswordWithOptions = generatePasswordWithOptions;
+exports.generateRandomId = generateRandomId;
 exports.getStringSimilarity = getStringSimilarity;
 exports.groupBy = groupBy;
 exports.hasNilOrEmpty = hasNilOrEmpty;
@@ -2766,6 +2805,9 @@ exports.parseToNumber = parseToNumber;
 exports.pick = pick;
 exports.pluck = pluck;
 exports.pushAll = pushAll;
+exports.randFromArray = randFromArray;
+exports.randIntFromInterval = randIntFromInterval;
+exports.random = random;
 exports.randomDigits = randomDigits;
 exports.removeDiacritics = removeDiacritics;
 exports.round = round;
@@ -2780,6 +2822,9 @@ exports.sanitize = sanitize;
 exports.sanitizeMarkdown = sanitizeMarkdown;
 exports.sentenceCase = sentenceCase;
 exports.shuffle = shuffle;
+exports.shuffleArray = shuffleArray;
+exports.shuffleArrayMutate = shuffleArrayMutate;
+exports.shuffleString = shuffleString;
 exports.slugify = slugify;
 exports.smsLength = smsLength;
 exports.sortBy = sortBy;