feat(utils): added util to parse query

packages/utils/src/index.ts

@@ -14,6 +14,10 @@ export * from './array/forEachParalell.js';
 export * from './string/formatWith.js';
 export * from './string/isDigit.js';
 
+export * from './url/stringifyQuery.js';
+export * from './url/parseQuery.js';
+export * from './url/queryTypes.js';
+
 export * from './assert.js';
 export * from './cachedGetter.js';
 export * from './cachedProp.js';
@@ -40,4 +44,3 @@ export * from './timeout.js';
 export * from './writable.js';
 export * from './promiseAll.js';
 export * from './getTopLevelDomain.js';
-export * from './stringifyQuery.js';

packages/utils/src/url/parseQuery.ts

@@ -0,0 +1,56 @@
+import { QueryParams, QueryParamsSimple } from './queryTypes.js';
+
+export function parseQuery(querystring: string | null | undefined): QueryParamsSimple;
+export function parseQuery(
+    querystring: string | null | undefined,
+    options: { multiple: false },
+): QueryParamsSimple;
+export function parseQuery(
+    querystring: string | null | undefined,
+    options: { multiple: true },
+): QueryParams;
+export function parseQuery(
+    querystring: string | null | undefined,
+    options?: { multiple: boolean },
+): QueryParams {
+    const query: QueryParams = {};
+    const multiple = options?.multiple || false;
+
+    if (!querystring) {
+        return query;
+    }
+
+    if (querystring.startsWith('?')) {
+        querystring = querystring.slice(1);
+    }
+
+    for (const item of querystring.split('&')) {
+        const [rawKey, rawValue] = item.split('=');
+        const key = decodeURIComponent(rawKey);
+        const value = decodeURIComponent(rawValue);
+
+        // Sometimes a query string can have multiple values
+        // for the same key, so to factor that case in, you
+        // could collect an array of values for the same key
+        let entry = query[key];
+
+        if (entry === undefined) {
+            query[key] = value;
+            continue;
+        }
+
+        if (!multiple) {
+            // Allows only for a single value per key
+            continue;
+        }
+
+        // If the value for this key was not previously an array, update it
+        if (!Array.isArray(entry)) {
+            query[key] = entry = [entry];
+        }
+
+        entry.push(value);
+    }
+
+    return query;
+}

packages/utils/src/url/queryTypes.ts

@@ -0,0 +1,4 @@
+type QueryParamValue = string | null;
+export type QueryParam = QueryParamValue | QueryParamValue[];
+export type QueryParams = Record<string, QueryParam | undefined>;
+export type QueryParamsSimple = Record<string, string | undefined | null>;

packages/utils/src/stringifyQuery.ts → packages/utils/src/url/stringifyQuery.ts

@@ -1,6 +1,4 @@
-type QueryParamValue = string | null;
-export type QueryParam = QueryParamValue | QueryParamValue[];
-export type QueryParams = Record<string, QueryParam | undefined>;
+import { QueryParams } from './queryTypes.js';
 
 export function stringifyQuery(params: QueryParams) {
     let qs = '';