@splendidlabz/utils 1.11.6 → 1.12.0

package/dist/cjs/lib/index.cjs

@@ -76,6 +76,7 @@ __export(lib_exports, {
   omitEmpty: () => omitEmpty,
   parseFullName: () => parseFullName,
   parseJSON: () => parseJSON,
+  parseQueryString: () => parseQueryString,
   parseSSE: () => parseSSE,
   pipe: () => pipe,
   pipeAsync: () => pipeAsync,
@@ -1062,6 +1063,33 @@ function toQueryString(object) {
   const searchParams = new URLSearchParams(object);
   return searchParams.toString();
 }
+function parseQueryString(string = "") {
+  const query = string.startsWith("?") ? string.slice(1) : string;
+  const result = {};
+  if (!query) return result;
+  const decode = (str) => decodeURIComponent(str.replace(/\+/g, " "));
+  const keyToPath = (key) => key.replace(/\]/g, "").split("[").map(decode);
+  for (const pair of query.split("&")) {
+    if (!pair) continue;
+    const eq = pair.indexOf("=");
+    const path = keyToPath(eq === -1 ? pair : pair.slice(0, eq));
+    const value = decode(eq === -1 ? "" : pair.slice(eq + 1));
+    let current = result;
+    path.forEach((key, i) => {
+      const index = Array.isArray(current) ? Number(key) : key;
+      if (i === path.length - 1) {
+        if (key === "") current.push(value);
+        else current[index] = value;
+        return;
+      }
+      const next = path[i + 1];
+      const childIsArray = next === "" || /^\d+$/.test(next);
+      if (current[index] == null) current[index] = childIsArray ? [] : {};
+      current = current[index];
+    });
+  }
+  return result;
+}
 function plural(count, noun, suffix = "s") {
   console.warn("plural is deprecated. Use pluralize instead");
   return `${count} ${noun}${count !== 1 ? suffix : ""}`;
@@ -1138,6 +1166,7 @@ function getSymbolValue(object, description) {
   omitEmpty,
   parseFullName,
   parseJSON,
+  parseQueryString,
   parseSSE,
   pipe,
   pipeAsync,

package/dist/cjs/lib/strings/index.cjs

@@ -31,6 +31,7 @@ var strings_exports = {};
 __export(strings_exports, {
   markdown: () => markdown,
   parseFullName: () => parseFullName,
+  parseQueryString: () => parseQueryString,
   plural: () => plural,
   pluralize: () => pluralize,
   stripNumbers: () => stripNumbers,
@@ -170,6 +171,33 @@ function toQueryString(object) {
   const searchParams = new URLSearchParams(object);
   return searchParams.toString();
 }
+function parseQueryString(string = "") {
+  const query = string.startsWith("?") ? string.slice(1) : string;
+  const result = {};
+  if (!query) return result;
+  const decode = (str) => decodeURIComponent(str.replace(/\+/g, " "));
+  const keyToPath = (key) => key.replace(/\]/g, "").split("[").map(decode);
+  for (const pair of query.split("&")) {
+    if (!pair) continue;
+    const eq = pair.indexOf("=");
+    const path = keyToPath(eq === -1 ? pair : pair.slice(0, eq));
+    const value = decode(eq === -1 ? "" : pair.slice(eq + 1));
+    let current = result;
+    path.forEach((key, i) => {
+      const index = Array.isArray(current) ? Number(key) : key;
+      if (i === path.length - 1) {
+        if (key === "") current.push(value);
+        else current[index] = value;
+        return;
+      }
+      const next = path[i + 1];
+      const childIsArray = next === "" || /^\d+$/.test(next);
+      if (current[index] == null) current[index] = childIsArray ? [] : {};
+      current = current[index];
+    });
+  }
+  return result;
+}
 function plural(count, noun, suffix = "s") {
   console.warn("plural is deprecated. Use pluralize instead");
   return `${count} ${noun}${count !== 1 ? suffix : ""}`;
@@ -181,6 +209,7 @@ function stripNumbers(string) {
 0 && (module.exports = {
   markdown,
   parseFullName,
+  parseQueryString,
   plural,
   pluralize,
   stripNumbers,

package/dist/cjs/lib/strings/query-string.cjs

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib/strings/query-string.js
 var query_string_exports = {};
 __export(query_string_exports, {
+  parseQueryString: () => parseQueryString,
   plural: () => plural,
   stripNumbers: () => stripNumbers,
   toQueryString: () => toQueryString
@@ -28,6 +29,33 @@ function toQueryString(object) {
   const searchParams = new URLSearchParams(object);
   return searchParams.toString();
 }
+function parseQueryString(string = "") {
+  const query = string.startsWith("?") ? string.slice(1) : string;
+  const result = {};
+  if (!query) return result;
+  const decode = (str) => decodeURIComponent(str.replace(/\+/g, " "));
+  const keyToPath = (key) => key.replace(/\]/g, "").split("[").map(decode);
+  for (const pair of query.split("&")) {
+    if (!pair) continue;
+    const eq = pair.indexOf("=");
+    const path = keyToPath(eq === -1 ? pair : pair.slice(0, eq));
+    const value = decode(eq === -1 ? "" : pair.slice(eq + 1));
+    let current = result;
+    path.forEach((key, i) => {
+      const index = Array.isArray(current) ? Number(key) : key;
+      if (i === path.length - 1) {
+        if (key === "") current.push(value);
+        else current[index] = value;
+        return;
+      }
+      const next = path[i + 1];
+      const childIsArray = next === "" || /^\d+$/.test(next);
+      if (current[index] == null) current[index] = childIsArray ? [] : {};
+      current = current[index];
+    });
+  }
+  return result;
+}
 function plural(count, noun, suffix = "s") {
   console.warn("plural is deprecated. Use pluralize instead");
   return `${count} ${noun}${count !== 1 ? suffix : ""}`;
@@ -37,6 +65,7 @@ function stripNumbers(string) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  parseQueryString,
   plural,
   stripNumbers,
   toQueryString

package/dist/esm/lib/strings/query-string.js

@@ -2,6 +2,33 @@ function toQueryString(object) {
   const searchParams = new URLSearchParams(object);
   return searchParams.toString();
 }
+function parseQueryString(string = "") {
+  const query = string.startsWith("?") ? string.slice(1) : string;
+  const result = {};
+  if (!query) return result;
+  const decode = (str) => decodeURIComponent(str.replace(/\+/g, " "));
+  const keyToPath = (key) => key.replace(/\]/g, "").split("[").map(decode);
+  for (const pair of query.split("&")) {
+    if (!pair) continue;
+    const eq = pair.indexOf("=");
+    const path = keyToPath(eq === -1 ? pair : pair.slice(0, eq));
+    const value = decode(eq === -1 ? "" : pair.slice(eq + 1));
+    let current = result;
+    path.forEach((key, i) => {
+      const index = Array.isArray(current) ? Number(key) : key;
+      if (i === path.length - 1) {
+        if (key === "") current.push(value);
+        else current[index] = value;
+        return;
+      }
+      const next = path[i + 1];
+      const childIsArray = next === "" || /^\d+$/.test(next);
+      if (current[index] == null) current[index] = childIsArray ? [] : {};
+      current = current[index];
+    });
+  }
+  return result;
+}
 function plural(count, noun, suffix = "s") {
   console.warn("plural is deprecated. Use pluralize instead");
   return `${count} ${noun}${count !== 1 ? suffix : ""}`;
@@ -10,6 +37,7 @@ function stripNumbers(string) {
   return string.replace(/\d*/, "");
 }
 export {
+  parseQueryString,
   plural,
   stripNumbers,
   toQueryString

package/dist/types/lib/index.d.cts

@@ -37,7 +37,7 @@ export { toCamel, toKebab, toLower, toPascal, toSentence, toSlug, toTitle, toUpp
 export { markdown, treatMarkdownWhitespace } from './strings/markdown.cjs';
 export { parseFullName } from './strings/name.cjs';
 export { pluralize } from './strings/pluralize.cjs';
-export { plural, stripNumbers, toQueryString } from './strings/query-string.cjs';
+export { parseQueryString, plural, stripNumbers, toQueryString } from './strings/query-string.cjs';
 export { toStyleString } from './style/index.cjs';
 export { getSymbol, getSymbolValue } from './symbols/symbols.cjs';
 export { toDegrees, toRadians } from './numbers/math.cjs';

package/dist/types/lib/strings/index.d.cts

@@ -2,4 +2,4 @@ export { toCamel, toKebab, toLower, toPascal, toSentence, toSlug, toTitle, toUpp
 export { markdown, treatMarkdownWhitespace } from './markdown.cjs';
 export { parseFullName } from './name.cjs';
 export { pluralize } from './pluralize.cjs';
-export { plural, stripNumbers, toQueryString } from './query-string.cjs';
+export { parseQueryString, plural, stripNumbers, toQueryString } from './query-string.cjs';

package/dist/types/lib/strings/query-string.d.cts

@@ -4,7 +4,16 @@
  * @returns
  */
 declare function toQueryString(object: any): string;
+/**
+ * Parses a query string into an object, expanding bracket-notation keys into
+ * nested objects and arrays (e.g. `order[charges][0][reference]=23`). Decodes
+ * percent-encoding and treats `+` as a space. Mirrors the subset of `qs.parse`
+ * needed for form-urlencoded webhook payloads.
+ * @param {string} [string]
+ * @returns {Object}
+ */
+declare function parseQueryString(string?: string): any;
 declare function plural(count: any, noun: any, suffix?: string): string;
 declare function stripNumbers(string: any): any;
 
-export { plural, stripNumbers, toQueryString };
+export { parseQueryString, plural, stripNumbers, toQueryString };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splendidlabz/utils",
-  "version": "1.11.6",
+  "version": "1.12.0",
   "description": "",
   "type": "module",
   "homepage": "https://splendidlabz.com/docs/utils",
@@ -69,7 +69,7 @@
     "statuses": "^2.0.2"
   },
   "devDependencies": {
-    "@splendidlabz/eslint-config": "2.1.4",
+    "@splendidlabz/eslint-config": "2.1.5",
     "jsdom": "^29.0.2",
     "np": "^11.1.0",
     "tsup": "^8.5.1",