@salespark/toolkit 2.1.20 → 2.1.21

package/README.md

@@ -26,7 +26,7 @@ npm i @salespark/toolkit
 
 - **Array utilities**: chunk, uniqBy, deep equality, flatten, groupBy, etc.
 - **Object utilities**: pick, omit, clean objects, deep merge, etc.
-- **String utilities**: slugify, template fill, deburr, sanitize, capitalize words/sentences.
+- **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.
 - **Function utilities**: debounce, throttle, safeJSONParse, formatCurrency, parseName, currency conversions, etc.
 - **Defer utilities**: post-return microtask scheduling, non-critical timers, after-response hooks.
@@ -54,6 +54,7 @@ import {
   isBrowser,
   toBool,
   generatePassword,
+  smsLength,
   uuidv4,
 } from "@salespark/toolkit";
 
@@ -80,6 +81,9 @@ const bool = toBool("yes"); // true
 // Generate a password (sync by default)
 const recoveryToken = generatePassword(96, false);
 
+// SMS length and segmentation
+const sms = smsLength("hello");
+
 // Generate UUID v4
 const id = uuidv4();
 
@@ -361,6 +365,16 @@ sanitize("<script>alert('hack')</script>Hello World!", 20);
 // Result: "Hello World!"
 ```
 
+**`smsLength(text: string, singleOverrides?, multiOverrides?): SmsLengthResult`** — Calculates SMS encoding, length, and segmentation details (overrides are optional).
+
+```javascript
+const sms = smsLength("hello");
+// Result: { encoding: "GSM_7BIT", length: 5, messages: 1, remaining: 155, ... }
+
+const custom = smsLength("hello", { GSM_7BIT: 10 }, { GSM_7BIT: 5 });
+// Result: characterPerMessage uses overrides
+```
+
 ### 🔢 Number Utilities
 
 **`clamp(n: number, min: number, max: number): number`** — Restricts a number to be within the min and max bounds.
@@ -1093,5 +1107,5 @@ MIT © [SalesPark](https://salespark.io)
 
 ---
 
-_Document version: 17_  
+_Document version: 18_  
 _Last update: 14-03-2026_

package/dist/index.cjs

@@ -2620,6 +2620,62 @@ var generatePasswordWithOptions = (options) => {
   return requiresAsync ? generatePasswordAsync(options) : generatePasswordSync(options);
 };
 
+// src/utils/sms.ts
+var GSM_7BIT_REGEXP = /^[@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞÆæßÉ !"#¤%&'()*+,\-./0123456789:;<=>?¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijklmnopqrstuvwxyzäöñüà]*$/;
+var GSM_7BIT_EXT_REGEXP = /^[@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞÆæßÉ !"#¤%&'()*+,\-./0123456789:;<=>?¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijklmnopqrstuvwxyzäöñüà\^{}\\\[\]~|€]*$/;
+var GSM_7BIT_EXT_CHAR_REGEXP = /[\^{}\\\[\]~|€]/g;
+var messageLength = {
+  GSM_7BIT: 160,
+  GSM_7BIT_EXT: 160,
+  UTF16: 70
+};
+var multiMessageLength = {
+  GSM_7BIT: 153,
+  GSM_7BIT_EXT: 153,
+  UTF16: 67
+};
+var detectEncoding = (text) => {
+  if (GSM_7BIT_REGEXP.test(text)) {
+    return "GSM_7BIT";
+  }
+  if (GSM_7BIT_EXT_REGEXP.test(text)) {
+    return "GSM_7BIT_EXT";
+  }
+  return "UTF16";
+};
+var smsLength = (text, singleOverrides, multiOverrides) => {
+  const singleLengths = { ...messageLength, ...singleOverrides };
+  const multiLengths = { ...multiMessageLength, ...multiOverrides };
+  if (text.length === 0) {
+    return {
+      encoding: "GSM_7BIT",
+      length: 0,
+      characterPerMessage: singleLengths.GSM_7BIT,
+      inCurrentMessage: 0,
+      remaining: singleLengths.GSM_7BIT,
+      messages: 0
+    };
+  }
+  const encoding = detectEncoding(text);
+  const extCharCount = encoding === "GSM_7BIT_EXT" ? (text.match(GSM_7BIT_EXT_CHAR_REGEXP) ?? []).length : 0;
+  const length = text.length + extCharCount;
+  let characterPerMessage = singleLengths[encoding];
+  if (length > characterPerMessage) {
+    characterPerMessage = multiLengths[encoding];
+  }
+  const messages = Math.ceil(length / characterPerMessage);
+  const inCurrentMessage = length - characterPerMessage * (messages - 1);
+  const remaining = characterPerMessage * messages - length;
+  return {
+    encoding,
+    length,
+    characterPerMessage,
+    inCurrentMessage,
+    remaining,
+    messages
+  };
+};
+
 // src/index.ts
 var isBrowser = typeof globalThis !== "undefined" && typeof globalThis.document !== "undefined";
 var isNode = typeof process !== "undefined" && !!process.versions?.node;
@@ -2628,6 +2684,9 @@ Object.defineProperty(exports, "uuidv4", {
   enumerable: true,
   get: function () { return uuid.v4; }
 });
+exports.GSM_7BIT_EXT_CHAR_REGEXP = GSM_7BIT_EXT_CHAR_REGEXP;
+exports.GSM_7BIT_EXT_REGEXP = GSM_7BIT_EXT_REGEXP;
+exports.GSM_7BIT_REGEXP = GSM_7BIT_REGEXP;
 exports.addSpaceBetweenNumbers = addSpaceBetweenNumbers;
 exports.addThousandsSpace = addThousandsSpace;
 exports.areArraysDeepEqualUnordered = areArraysDeepEqualUnordered;
@@ -2721,6 +2780,7 @@ exports.sanitizeMarkdown = sanitizeMarkdown;
 exports.sentenceCase = sentenceCase;
 exports.shuffle = shuffle;
 exports.slugify = slugify;
+exports.smsLength = smsLength;
 exports.sortBy = sortBy;
 exports.stringSimilarity = stringSimilarity;
 exports.symbolToCurrency = symbolToCurrency;