@ambitiondev/dynamic-url 0.0.4 → 0.0.5-0

package/dist/src/url.d.ts

@@ -1,4 +1,4 @@
-import type { TParamsObject } from "../types";
+import type { TParamsObject, IStringifyQueryOptions } from "../types";
 export declare class DynamicURL {
     private url;
     constructor(url: string);
@@ -6,6 +6,12 @@ export declare class DynamicURL {
      * Takes a query object and appends it to the URL as a query string.
      *
      * @param query - An object representing the query parameters.
+     * @param options - Options for stringifying the query parameters.
+     * @param options.prefix - Prefix for the query parameters (default: "").
+     * @param options.maxDepth - Maximum depth for nested objects (default: 5).
+     * @param options.separator - Separator for the query parameters (default: "&").
+     * @param options.skipNulls - Whether to skip null or undefined values (default: true).
+     * @see {@link IStringifyQueryOptions}
      * @returns {DynamicURL}
      *
      * @example
@@ -15,7 +21,7 @@ export declare class DynamicURL {
      * console.log(url.resolve()); // "https://example.com?citizen=robespierre&hero=ironman"
      * ```
      */
-    setQueryParams(query: Record<string, any>): this;
+    setQueryParams(query: Record<string, any>, options?: IStringifyQueryOptions): this;
     /**
      * Replaces route parameters in the URL with the provided values.
      *

package/dist/src/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/url.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IAIvB;;;;;;;;;;;;OAYG;IAEH,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAazC;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM;IAiBnD;;;;;;;;;;;;;OAaG;IACH,OAAO;CAGR"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAoEtE,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IAIvB;;;;;;;;;;;;;;;;;;OAkBG;IAEH,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAU3E;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM;IAiBnD;;;;;;;;;;;;;OAaG;IACH,OAAO;CAGR"}

package/dist/src/url.js

@@ -1,5 +1,50 @@
-// Vendor
-import qs from "qs";
+// Defaults
+const MAX_DEPTH_DEFAULT = 5;
+const SEPARATOR_DEFAULT = "&";
+const PREFIX_DEFAULT = "";
+const SKIP_NULLS_DEFAULT = true;
+function stringify(
+/* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+obj, options) {
+    const { maxDepth = MAX_DEPTH_DEFAULT, prefix = PREFIX_DEFAULT, separator = SEPARATOR_DEFAULT, skipNulls = SKIP_NULLS_DEFAULT, } = options || {};
+    const stringifyRecursive = (
+    /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+    obj, prefix, depth = 1) => {
+        const result = Object.entries(obj).reduce((queryString, [key, value]) => {
+            // Handle skipNulls option
+            if (skipNulls && (value === null || value === undefined)) {
+                return queryString;
+            }
+            // Build the unencoded key path first
+            const keyPath = prefix ? `${prefix}[${key}]` : key;
+            // Check if value is an object and we haven't exceeded max depth
+            if (typeof value === "object" && value !== null && depth < maxDepth) {
+                // Pass unencoded keyPath as prefix to prevent double encoding in recursive calls
+                const nestedQuery = stringifyRecursive(value, keyPath, depth + 1);
+                // Only append if nestedQuery has content
+                if (!nestedQuery) {
+                    return queryString;
+                }
+                return queryString
+                    ? `${queryString}${separator}${nestedQuery}`
+                    : nestedQuery;
+            }
+            else {
+                // Encode only once at the leaf level
+                const encodedKey = encodeURIComponent(keyPath);
+                const encodedValue = typeof value === "object" && value !== null
+                    ? ""
+                    : encodeURIComponent(value);
+                const keyValueString = `${encodedKey}=${encodedValue}`;
+                return queryString
+                    ? `${queryString}${separator}${keyValueString}`
+                    : keyValueString;
+            }
+        }, "");
+        return result;
+    };
+    return stringifyRecursive(obj, prefix);
+}
 export class DynamicURL {
     constructor(url) {
         this.url = url;
@@ -8,6 +53,12 @@ export class DynamicURL {
      * Takes a query object and appends it to the URL as a query string.
      *
      * @param query - An object representing the query parameters.
+     * @param options - Options for stringifying the query parameters.
+     * @param options.prefix - Prefix for the query parameters (default: "").
+     * @param options.maxDepth - Maximum depth for nested objects (default: 5).
+     * @param options.separator - Separator for the query parameters (default: "&").
+     * @param options.skipNulls - Whether to skip null or undefined values (default: true).
+     * @see {@link IStringifyQueryOptions}
      * @returns {DynamicURL}
      *
      * @example
@@ -18,11 +69,8 @@ export class DynamicURL {
      * ```
      */
     /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
-    setQueryParams(query) {
-        const queryString = qs.stringify(query, {
-            skipNulls: true,
-            encode: true,
-        });
+    setQueryParams(query, options) {
+        const queryString = stringify(query, options);
         if (queryString) {
             this.url = `${this.url}?${queryString}`;
         }

package/dist/types/index.d.ts

@@ -1,2 +1,24 @@
 export type TParamsObject = Record<string, string | number | boolean>;
+export interface IStringifyQueryOptions {
+    /**
+     * Prefix for the query parameters.
+     * @default ""
+     */
+    prefix?: string;
+    /**
+     * Separator for the query parameters.
+     * @default "&"
+     */
+    separator?: string;
+    /**
+     * Whether to skip null or undefined values.
+     * @default true
+     */
+    skipNulls?: boolean;
+    /**
+     * Maximum depth for nested objects.
+     * @default 5
+     */
+    maxDepth?: number;
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ambitiondev/dynamic-url",
   "description": "lightweight util for creating dynamic endpoint strings",
-  "version": "0.0.4",
+  "version": "0.0.5-0",
   "main": "./dist/src/url.js",
   "types": "./dist/src/url.d.ts",
   "repository": "https://github.com/ambitiondev/dynamic-url",
@@ -31,9 +31,6 @@
     "typescript-eslint": "^8.53.0",
     "vitest": "^4.0.17"
   },
-  "dependencies": {
-    "qs": "^6.14.1"
-  },
   "scripts": {
     "--- 🎣 Hooks ---": "",
     "prepare": "husky",