@salespark/toolkit 2.1.16 → 2.1.18

package/dist/index.d.cts

@@ -538,6 +538,14 @@ declare const isNilText: (value: unknown) => boolean;
  * 18-10-2025: Trim before checking empty
  ****************************************************/
 declare const isNilOrEmpty: (value: unknown) => boolean;
+/******************************************************
+ * ##: Nil, Empty String, or Empty Object Check
+ * Checks if value is nil, an empty string, or an empty plain object (no own keys).
+ * @param {unknown} value - Value to check
+ * History:
+ * 06-02-2026: Created
+ ****************************************************/
+declare const isNilEmptyOrEmptyObject: (value: unknown) => boolean;
 /******************************************************
  * ##: Array Nil or Empty Element Check
  * Checks if any element in array is nil or empty (""). Returns true if input is not an array.
@@ -854,36 +862,6 @@ declare const assessSecurityRisks: (risks: SecurityRisk[]) => {
  * Lightweight XOR scrambling for strings and JSON-serializable objects.
  * Notes: This is reversible obfuscation and NOT cryptographic security.
  ******************************************************************/
-/******************************************************************
- * ##: Scramble a string by XOR-ing each character with a repeating secret key
- * Applies an XOR operation between each character code and a repeating key character code.
- * The XOR result is then Base64-encoded for transport as a printable string.
- *
- * TL;DR: Obfuscate a string by XOR-ing it with a repeating secret and Base64-encoding the result.
- * Use only for reversible scrambling, not cryptographic protection.
- * @param {string} value - Plain string to scramble (typically a Base64-encoded JSON payload).
- * @param {string} secret - Secret key used as the repeating XOR mask.
- * @returns {SalesParkContract<any>} - Return a SalesPark Contract object
- * History:
- * 28-01-2026: Created
- * 04-02-2026: Refactored + return SalesPark Contract object
- ******************************************************************/
-declare const scrambleString: (value: string, secret: string) => SalesParkContract<any>;
-/******************************************************************
- * ##: Descramble a Base64 string by reversing XOR with a repeating secret key
- * Base64-decodes the scrambled input to a binary string, then XORs each character with the key.
- * This reverses the scramble operation as long as the same secret key is used.
- *
- * TL;DR: Reverse the XOR-based scrambling using the same secret key.
- * It Base64-decodes, then XORs again to recover the original string.
- * @param {string} value - Base64-encoded scrambled input produced by the scrambler.
- * @param {string} secret - Secret key used as the repeating XOR mask (must match the encoding key).
- * @returns {SalesParkContract<any>} - Return a SalesPark Contract object
- * History:
- * 28-01-2026: Created
- * 04-02-2026: Refactored + return SalesPark Contract object
- ******************************************************************/
-declare const descrambleString: (value: string, secret: string) => SalesParkContract<any>;
 /******************************************************************
  * ##: Encode object into scrambled Base64 string using a secret key
  * Serializes an input object to JSON, Base64-encodes it, and scrambles the result using a secret key.
@@ -900,6 +878,19 @@ declare const descrambleString: (value: string, secret: string) => SalesParkCont
  * 04-02-2026: Refactored + return SalesPark Contract object
  ******************************************************************/
 declare const encodeObject: (input: object, secret: string) => SalesParkContract<any>;
+/******************************************************************
+ * ##: Encode string into scrambled Base64 string using a secret key
+ * Base64-encodes an input string and scrambles it using a secret key.
+ * This is intended for lightweight obfuscation, not for cryptographic security.
+ *
+ * TL;DR: Turn a string into a scrambled Base64 payload using a secret key.
+ * @param {string} input - Plain string to encode.
+ * @param {string} secret - Secret key used to scramble the Base64 payload.
+ * @returns {SalesParkContract<any>} - Return a SalesPark Contract object
+ * History:
+ * 06-02-2026: Created
+ ******************************************************************/
+declare const encodeString: (input: string, secret: string) => SalesParkContract<any>;
 /******************************************************************
  * ##: Decode scrambled string back into an object using a secret key
  * Descrambles an encoded string with the provided secret, Base64-decodes it, and parses it as JSON.
@@ -915,6 +906,19 @@ declare const encodeObject: (input: object, secret: string) => SalesParkContract
  * 04-02-2026: Refactored + return SalesPark Contract object
  ******************************************************************/
 declare const decodeObject: (encoded: string, secret: string) => SalesParkContract<any>;
+/******************************************************************
+ * ##: Decode scrambled Base64 string back into a string using a secret key
+ * Descrambles the encoded input with the provided secret and Base64-decodes it.
+ * This reverses the encode flow and returns the original string if inputs are valid.
+ *
+ * TL;DR: Convert a scrambled string back into the original string using the same key.
+ * @param {string} encoded - Scrambled Base64 string produced by the encoder/scrambler.
+ * @param {string} secret - Secret key used to descramble the payload.
+ * @returns {SalesParkContract<any>} - Return a SalesPark Contract object
+ * History:
+ * 06-02-2026: Created
+ ******************************************************************/
+declare const decodeString: (encoded: string, secret: string) => SalesParkContract<any>;
 
 type DeferFn = () => void | Promise<void>;
 /******************************************************************
@@ -977,8 +981,52 @@ declare const deferAfterResponse: (res: HttpResponseLike, fn: DeferFn) => void;
  ******************************************************************/
 declare const deferAfterResponseNonCritical: (res: HttpResponseLike, fn: DeferFn) => void;
 
+/******************************************************
+ * ##: Reversible Base36 Code Encoder/Decoder (No Deps)
+ * Encodes a base36 identifier into a lower-case base36 code using a secret key.
+ * Decodes back with the same secret and configuration.
+ * History:
+ * 16-02-2026: Created
+ ****************************************************/
+type EncodeDecodeConfig = {
+    secret: string;
+    bitSize?: number;
+    rotateBits?: number;
+    addConstant?: string;
+};
+/******************************************************************
+ * ##: Encode Base36 Identifier
+ * Obfuscates a base36 identifier into a reversible lowercase base36 code using XOR mixing, constant addition, and rotation.
+ *
+ * TL;DR: Encodes a base36 identifier into a reversible base36 code.
+ * Uses a secret-derived key and fixed-width math to keep outputs bounded and reversible.
+ * @param {string} identifier - Source identifier in base36 format
+ * @param {EncodeDecodeConfig} config - Encoding configuration including secret and optional parameters
+ * @returns {SalesParkContract<{ code: string }>} - Return a SalesPark Contract object.
+ * History:
+ * 16-02-2026: Created
+ ******************************************************************/
+declare const encodeBase36Code: (identifier: string, config: EncodeDecodeConfig) => SalesParkContract<{
+    code: string;
+}>;
+/******************************************************************
+ * ##: Decode Base36 Code
+ * Reverses the obfuscation steps to restore the original identifier using the same secret and configuration parameters.
+ *
+ * TL;DR: Decodes a base36 code back into the original identifier.
+ * Requires the same secret and config to reliably reverse XOR, add, and rotation.
+ * @param {string} code - Encoded base36 code to decode
+ * @param {EncodeDecodeConfig} config - Decoding configuration including secret and optional parameters
+ * @returns {SalesParkContract<{ identifier: string }>} - Return a SalesPark Contract object.
+ * History:
+ * 16-02-2026: Created
+ ******************************************************************/
+declare const decodeBase36Code: (code: string, config: EncodeDecodeConfig) => SalesParkContract<{
+    identifier: string;
+}>;
+
 /** Environment helpers (runtime-agnostic checks) */
 declare const isBrowser: boolean;
 declare const isNode: boolean;
 
-export { type CapitalizeFirstOptions, type CapitalizeWordsOptions, type DeferFn, type FormatCurrencyProOptions, type HttpResponseLike, type SecurityCheckResult, type SecurityRisk, type SentenceCaseOptions, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, decodeObject, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, descrambleString, difference, encodeObject, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, 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, scrambleString, sentenceCase, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { type CapitalizeFirstOptions, type CapitalizeWordsOptions, type DeferFn, type EncodeDecodeConfig, type FormatCurrencyProOptions, type HttpResponseLike, type SecurityCheckResult, type SecurityRisk, type SentenceCaseOptions, 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, 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, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };

package/dist/index.d.ts

@@ -538,6 +538,14 @@ declare const isNilText: (value: unknown) => boolean;
  * 18-10-2025: Trim before checking empty
  ****************************************************/
 declare const isNilOrEmpty: (value: unknown) => boolean;
+/******************************************************
+ * ##: Nil, Empty String, or Empty Object Check
+ * Checks if value is nil, an empty string, or an empty plain object (no own keys).
+ * @param {unknown} value - Value to check
+ * History:
+ * 06-02-2026: Created
+ ****************************************************/
+declare const isNilEmptyOrEmptyObject: (value: unknown) => boolean;
 /******************************************************
  * ##: Array Nil or Empty Element Check
  * Checks if any element in array is nil or empty (""). Returns true if input is not an array.
@@ -854,36 +862,6 @@ declare const assessSecurityRisks: (risks: SecurityRisk[]) => {
  * Lightweight XOR scrambling for strings and JSON-serializable objects.
  * Notes: This is reversible obfuscation and NOT cryptographic security.
  ******************************************************************/
-/******************************************************************
- * ##: Scramble a string by XOR-ing each character with a repeating secret key
- * Applies an XOR operation between each character code and a repeating key character code.
- * The XOR result is then Base64-encoded for transport as a printable string.
- *
- * TL;DR: Obfuscate a string by XOR-ing it with a repeating secret and Base64-encoding the result.
- * Use only for reversible scrambling, not cryptographic protection.
- * @param {string} value - Plain string to scramble (typically a Base64-encoded JSON payload).
- * @param {string} secret - Secret key used as the repeating XOR mask.
- * @returns {SalesParkContract<any>} - Return a SalesPark Contract object
- * History:
- * 28-01-2026: Created
- * 04-02-2026: Refactored + return SalesPark Contract object
- ******************************************************************/
-declare const scrambleString: (value: string, secret: string) => SalesParkContract<any>;
-/******************************************************************
- * ##: Descramble a Base64 string by reversing XOR with a repeating secret key
- * Base64-decodes the scrambled input to a binary string, then XORs each character with the key.
- * This reverses the scramble operation as long as the same secret key is used.
- *
- * TL;DR: Reverse the XOR-based scrambling using the same secret key.
- * It Base64-decodes, then XORs again to recover the original string.
- * @param {string} value - Base64-encoded scrambled input produced by the scrambler.
- * @param {string} secret - Secret key used as the repeating XOR mask (must match the encoding key).
- * @returns {SalesParkContract<any>} - Return a SalesPark Contract object
- * History:
- * 28-01-2026: Created
- * 04-02-2026: Refactored + return SalesPark Contract object
- ******************************************************************/
-declare const descrambleString: (value: string, secret: string) => SalesParkContract<any>;
 /******************************************************************
  * ##: Encode object into scrambled Base64 string using a secret key
  * Serializes an input object to JSON, Base64-encodes it, and scrambles the result using a secret key.
@@ -900,6 +878,19 @@ declare const descrambleString: (value: string, secret: string) => SalesParkCont
  * 04-02-2026: Refactored + return SalesPark Contract object
  ******************************************************************/
 declare const encodeObject: (input: object, secret: string) => SalesParkContract<any>;
+/******************************************************************
+ * ##: Encode string into scrambled Base64 string using a secret key
+ * Base64-encodes an input string and scrambles it using a secret key.
+ * This is intended for lightweight obfuscation, not for cryptographic security.
+ *
+ * TL;DR: Turn a string into a scrambled Base64 payload using a secret key.
+ * @param {string} input - Plain string to encode.
+ * @param {string} secret - Secret key used to scramble the Base64 payload.
+ * @returns {SalesParkContract<any>} - Return a SalesPark Contract object
+ * History:
+ * 06-02-2026: Created
+ ******************************************************************/
+declare const encodeString: (input: string, secret: string) => SalesParkContract<any>;
 /******************************************************************
  * ##: Decode scrambled string back into an object using a secret key
  * Descrambles an encoded string with the provided secret, Base64-decodes it, and parses it as JSON.
@@ -915,6 +906,19 @@ declare const encodeObject: (input: object, secret: string) => SalesParkContract
  * 04-02-2026: Refactored + return SalesPark Contract object
  ******************************************************************/
 declare const decodeObject: (encoded: string, secret: string) => SalesParkContract<any>;
+/******************************************************************
+ * ##: Decode scrambled Base64 string back into a string using a secret key
+ * Descrambles the encoded input with the provided secret and Base64-decodes it.
+ * This reverses the encode flow and returns the original string if inputs are valid.
+ *
+ * TL;DR: Convert a scrambled string back into the original string using the same key.
+ * @param {string} encoded - Scrambled Base64 string produced by the encoder/scrambler.
+ * @param {string} secret - Secret key used to descramble the payload.
+ * @returns {SalesParkContract<any>} - Return a SalesPark Contract object
+ * History:
+ * 06-02-2026: Created
+ ******************************************************************/
+declare const decodeString: (encoded: string, secret: string) => SalesParkContract<any>;
 
 type DeferFn = () => void | Promise<void>;
 /******************************************************************
@@ -977,8 +981,52 @@ declare const deferAfterResponse: (res: HttpResponseLike, fn: DeferFn) => void;
  ******************************************************************/
 declare const deferAfterResponseNonCritical: (res: HttpResponseLike, fn: DeferFn) => void;
 
+/******************************************************
+ * ##: Reversible Base36 Code Encoder/Decoder (No Deps)
+ * Encodes a base36 identifier into a lower-case base36 code using a secret key.
+ * Decodes back with the same secret and configuration.
+ * History:
+ * 16-02-2026: Created
+ ****************************************************/
+type EncodeDecodeConfig = {
+    secret: string;
+    bitSize?: number;
+    rotateBits?: number;
+    addConstant?: string;
+};
+/******************************************************************
+ * ##: Encode Base36 Identifier
+ * Obfuscates a base36 identifier into a reversible lowercase base36 code using XOR mixing, constant addition, and rotation.
+ *
+ * TL;DR: Encodes a base36 identifier into a reversible base36 code.
+ * Uses a secret-derived key and fixed-width math to keep outputs bounded and reversible.
+ * @param {string} identifier - Source identifier in base36 format
+ * @param {EncodeDecodeConfig} config - Encoding configuration including secret and optional parameters
+ * @returns {SalesParkContract<{ code: string }>} - Return a SalesPark Contract object.
+ * History:
+ * 16-02-2026: Created
+ ******************************************************************/
+declare const encodeBase36Code: (identifier: string, config: EncodeDecodeConfig) => SalesParkContract<{
+    code: string;
+}>;
+/******************************************************************
+ * ##: Decode Base36 Code
+ * Reverses the obfuscation steps to restore the original identifier using the same secret and configuration parameters.
+ *
+ * TL;DR: Decodes a base36 code back into the original identifier.
+ * Requires the same secret and config to reliably reverse XOR, add, and rotation.
+ * @param {string} code - Encoded base36 code to decode
+ * @param {EncodeDecodeConfig} config - Decoding configuration including secret and optional parameters
+ * @returns {SalesParkContract<{ identifier: string }>} - Return a SalesPark Contract object.
+ * History:
+ * 16-02-2026: Created
+ ******************************************************************/
+declare const decodeBase36Code: (code: string, config: EncodeDecodeConfig) => SalesParkContract<{
+    identifier: string;
+}>;
+
 /** Environment helpers (runtime-agnostic checks) */
 declare const isBrowser: boolean;
 declare const isNode: boolean;
 
-export { type CapitalizeFirstOptions, type CapitalizeWordsOptions, type DeferFn, type FormatCurrencyProOptions, type HttpResponseLike, type SecurityCheckResult, type SecurityRisk, type SentenceCaseOptions, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, decodeObject, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, descrambleString, difference, encodeObject, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, 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, scrambleString, sentenceCase, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { type CapitalizeFirstOptions, type CapitalizeWordsOptions, type DeferFn, type EncodeDecodeConfig, type FormatCurrencyProOptions, type HttpResponseLike, type SecurityCheckResult, type SecurityRisk, type SentenceCaseOptions, 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, 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, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };

package/dist/index.js

@@ -504,6 +504,17 @@ var isNilOrEmpty = (value) => {
     return true;
   }
 };
+var isNilEmptyOrEmptyObject = (value) => {
+  try {
+    if (isNilOrEmpty(value)) return true;
+    if (typeof value === "object" && value !== null && !Array.isArray(value) && Object.keys(value).length === 0) {
+      return true;
+    }
+    return false;
+  } catch {
+    return true;
+  }
+};
 var hasNilOrEmpty = (array) => {
   try {
     if (!Array.isArray(array)) return true;
@@ -1879,6 +1890,24 @@ var encodeObject = (input, secret) => {
     return { status: false, data: error };
   }
 };
+var encodeString = (input, secret) => {
+  try {
+    if (typeof input !== "string") {
+      return { status: false, data: "Input must be a string" };
+    }
+    if (!secret || typeof secret !== "string") {
+      return { status: false, data: "Secret must be a non-empty string" };
+    }
+    const base64 = toBase64(input);
+    const scrambledResponse = scrambleString(base64, secret);
+    if (!scrambledResponse.status) {
+      return { status: false, data: "Scrambling failed" };
+    }
+    return { status: true, data: scrambledResponse.data };
+  } catch (error) {
+    return { status: false, data: error };
+  }
+};
 var decodeObject = (encoded, secret) => {
   try {
     if (typeof encoded !== "string") {
@@ -1897,6 +1926,24 @@ var decodeObject = (encoded, secret) => {
     return { status: false, data: error };
   }
 };
+var decodeString = (encoded, secret) => {
+  try {
+    if (typeof encoded !== "string") {
+      return { status: false, data: "Encoded value must be a string" };
+    }
+    if (!secret || typeof secret !== "string") {
+      return { status: false, data: "Secret must be a non-empty string" };
+    }
+    const descrambledResponse = descrambleString(encoded, secret);
+    if (!descrambledResponse.status) {
+      return { status: false, data: "Descrambling failed" };
+    }
+    const value = fromBase64(descrambledResponse.data);
+    return { status: true, data: value };
+  } catch (error) {
+    return { status: false, data: error };
+  }
+};
 
 // src/utils/defer.ts
 var swallow = (p) => p.catch(() => {
@@ -1982,10 +2029,199 @@ var deferAfterResponseNonCritical = (res, fn) => {
   }
 };
 
+// src/utils/base36.ts
+var DEFAULTS = {
+  bitSize: 80,
+  rotateBits: 17,
+  addConstant: "0x1fd0a5b7c3"
+};
+var isValidBase36 = (value) => /^[a-z0-9]+$/i.test(value);
+var normalizeInput = (value) => (value || "").trim();
+var assertSecret = (secret) => {
+  if (typeof secret !== "string" || secret.trim().length < 12) {
+    return { status: false, data: { message: "Missing or weak secret" } };
+  }
+  return { status: true, data: true };
+};
+var parseBase36BigInt = (value) => {
+  try {
+    const normalizedValue = normalizeInput(value);
+    if (!normalizedValue) {
+      return { status: false, data: { message: "Empty input" } };
+    }
+    if (!isValidBase36(normalizedValue)) {
+      return { status: false, data: { message: "Invalid base36 input" } };
+    }
+    const safeValue = normalizedValue.toLowerCase();
+    let output = 0n;
+    for (let i = 0; i < safeValue.length; i++) {
+      const char = safeValue[i];
+      const digit = char >= "0" && char <= "9" ? BigInt(char.charCodeAt(0) - 48) : BigInt(char.charCodeAt(0) - 87);
+      output = output * 36n + digit;
+    }
+    return { status: true, data: output };
+  } catch (error) {
+    return {
+      status: false,
+      data: { message: "Failed to parse base36 input", error }
+    };
+  }
+};
+var toBase36Lower = (value) => {
+  try {
+    if (value < 0n) {
+      return {
+        status: false,
+        data: { message: "Negative values are not supported" }
+      };
+    }
+    return { status: true, data: value.toString(36) };
+  } catch (error) {
+    return {
+      status: false,
+      data: { message: "Failed to convert to base36", error }
+    };
+  }
+};
+var getParams = (config) => {
+  try {
+    const bitSizeRaw = BigInt(config.bitSize ?? DEFAULTS.bitSize);
+    if (bitSizeRaw <= 0n) {
+      return {
+        status: false,
+        data: { message: "bitSize must be greater than 0" }
+      };
+    }
+    const rotateRaw = BigInt(config.rotateBits ?? DEFAULTS.rotateBits);
+    const rotateBits = (rotateRaw % bitSizeRaw + bitSizeRaw) % bitSizeRaw;
+    const addConstant = BigInt(config.addConstant ?? DEFAULTS.addConstant);
+    const mask = (1n << bitSizeRaw) - 1n;
+    return {
+      status: true,
+      data: { bitSize: bitSizeRaw, rotateBits, addConstant, mask }
+    };
+  } catch (error) {
+    return { status: false, data: { message: "Invalid configuration", error } };
+  }
+};
+var secretToKey = (secret, mask) => {
+  let key = 0n;
+  const safeSecret = secret.trim();
+  for (let i = 0; i < safeSecret.length; i++) {
+    key = key * 131n + BigInt(safeSecret.charCodeAt(i)) & mask;
+  }
+  return key;
+};
+var rotl = (x, r, bitSize, mask) => {
+  if (r === 0n) return x & mask;
+  return (x << r | x >> bitSize - r) & mask;
+};
+var rotr = (x, r, bitSize, mask) => {
+  if (r === 0n) return x & mask;
+  return (x >> r | x << bitSize - r) & mask;
+};
+var encodeBase36Code = (identifier, config) => {
+  try {
+    const secretCheck = assertSecret(config?.secret);
+    if (!secretCheck.status) {
+      return { status: false, data: secretCheck.data };
+    }
+    const input = normalizeInput(identifier);
+    if (!input) {
+      return { status: false, data: { message: "Identifier is required" } };
+    }
+    if (!isValidBase36(input)) {
+      return {
+        status: false,
+        data: { message: "Identifier must be base36 (0-9, A-Z)" }
+      };
+    }
+    const parsed = parseBase36BigInt(input);
+    if (!parsed.status) {
+      return { status: false, data: parsed.data };
+    }
+    const params = getParams(config);
+    if (!params.status) {
+      return { status: false, data: params.data };
+    }
+    const {
+      bitSize,
+      rotateBits,
+      addConstant,
+      mask
+    } = params.data;
+    const key = secretToKey(config.secret, mask);
+    let value = parsed.data & mask;
+    value = value ^ key;
+    value = value + addConstant & mask;
+    value = rotl(value, rotateBits, bitSize, mask);
+    const codeResult = toBase36Lower(value);
+    if (!codeResult.status) {
+      return { status: false, data: codeResult.data };
+    }
+    return { status: true, data: { code: codeResult.data } };
+  } catch (error) {
+    return {
+      status: false,
+      data: { message: "Failed to encode code", error }
+    };
+  }
+};
+var decodeBase36Code = (code, config) => {
+  try {
+    const secretCheck = assertSecret(config?.secret);
+    if (!secretCheck.status) {
+      return { status: false, data: secretCheck.data };
+    }
+    const input = normalizeInput(code);
+    if (!input) {
+      return { status: false, data: { message: "Code is required" } };
+    }
+    if (!isValidBase36(input)) {
+      return {
+        status: false,
+        data: { message: "Code must be base36 (0-9, a-z)" }
+      };
+    }
+    const parsed = parseBase36BigInt(input);
+    if (!parsed.status) {
+      return { status: false, data: parsed.data };
+    }
+    const params = getParams(config);
+    if (!params.status) {
+      return { status: false, data: params.data };
+    }
+    const {
+      bitSize,
+      rotateBits,
+      addConstant,
+      mask
+    } = params.data;
+    const key = secretToKey(config.secret, mask);
+    let value = parsed.data & mask;
+    value = rotr(value, rotateBits, bitSize, mask);
+    value = value - addConstant & mask;
+    value = value ^ key;
+    const identifierResult = toBase36Lower(value);
+    if (!identifierResult.status) {
+      return { status: false, data: identifierResult.data };
+    }
+    return {
+      status: true,
+      data: { identifier: identifierResult.data.toUpperCase() }
+    };
+  } catch (error) {
+    return {
+      status: false,
+      data: { message: "Failed to decode code", error }
+    };
+  }
+};
+
 // src/index.ts
 var isBrowser = typeof globalThis !== "undefined" && typeof globalThis.document !== "undefined";
 var isNode = typeof process !== "undefined" && !!process.versions?.node;
 
-export { addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, capitalizeFirst, capitalizeWords, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, decodeObject, deferAfterResponse, deferAfterResponseNonCritical, deferNonCritical, deferPostReturn, delay, descrambleString, difference, encodeObject, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatCurrencyPro, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, 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, scrambleString, sentenceCase, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { 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, 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, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map