@ribbon-studios/js-utils 1.4.3 → 1.5.1

package/README.md

@@ -11,7 +11,7 @@
 
 # JS Utils 🔧
 
-Collection of generic javascript utilities curated by the Rainbow Cafe~
+Collection of generic javascript utilities curated by the Ribbon Studios Team~
 
 - [Promises](#promises)
   - [`delay`](#delay)
@@ -28,6 +28,7 @@ Collection of generic javascript utilities curated by the Rainbow Cafe~
     - [`rfetch.patch`](#rfetchpatch)
     - [`rfetch.remove`](#rfetchremove)
     - [`rfetch.interceptors`](#rfetchinterceptors)
+    - [`rfetch.delimiters`](#rfetchdelimiters)
 
 ## Promises
 
@@ -221,6 +222,33 @@ rfetch.interceptors.remove(interceptor); // Remove the interceptor
 rfetch.interceptors.clear(); // Clear all interceptors
 ```
 
+### `rfetch.delimiters`
+
+Specifies which delimiters should be used.
+
+```tsx
+import { rfetch, DelimiterType } from '@ribbon-studios/js-utils';
+
+rfetch.delimiters(DelimiterType.DUPLICATE); // Use duplicate query params
+
+// This is the default functionality
+// https://ribbonstudios.com?hello=world&hello=welt
+await rfetch.get('https://ribbonstudios.com', {
+  params: {
+    hello: ['world', 'welt'],
+  },
+});
+
+rfetch.delimiters(DelimiterType.COMMA); // Use comma separators
+
+// https://ribbonstudios.com?hello=world,welt
+await rfetch.get('https://ribbonstudios.com', {
+  params: {
+    hello: ['world', 'welt'],
+  },
+});
+```
+
 [_**Want to Contribute?**_](/CONTRIBUTING.md)
 
 [npm-version-image]: https://img.shields.io/npm/v/@ribbon-studios/js-utils.svg

package/dist/index.cjs

@@ -41,7 +41,13 @@ async function retry(fn, n) {
     }
   }
 }
+var DelimiterType = /* @__PURE__ */ ((DelimiterType2) => {
+  DelimiterType2[DelimiterType2["COMMA"] = 0] = "COMMA";
+  DelimiterType2[DelimiterType2["DUPLICATE"] = 1] = "DUPLICATE";
+  return DelimiterType2;
+})(DelimiterType || {});
 let fetchInterceptors = [];
+let delimiter = 1;
 async function rfetch(url, { params, body, ...options } = {}) {
   var _a, _b;
   const requestInit = {
@@ -50,13 +56,18 @@ async function rfetch(url, { params, body, ...options } = {}) {
   };
   const internalURL = url instanceof URL ? url : new URL(url, url.startsWith("/") ? location.origin : void 0);
   if (params) {
-    for (const [key, values] of Object.entries(params)) {
-      if (Array.isArray(values)) {
-        for (const value of values) {
-          internalURL.searchParams.append(key, value.toString());
-        }
-      } else {
-        internalURL.searchParams.append(key, values.toString());
+    for (const [key, value] of Object.entries(params)) {
+      let values = Array.isArray(value) ? value : [value];
+      values = values.filter((value2) => ![void 0, null].includes(value2));
+      switch (delimiter) {
+        case 0:
+          internalURL.searchParams.set(key, values.map((value2) => value2.toString()).join(","));
+          break;
+        case 1:
+          values.forEach((value2) => {
+            internalURL.searchParams.append(key, value2.toString());
+          });
+          break;
       }
     }
   }
@@ -130,6 +141,10 @@ async function rfetch(url, { params, body, ...options } = {}) {
     });
   }
   rfetch2.remove = remove;
+  async function delimiters(type) {
+    delimiter = type;
+  }
+  rfetch2.delimiters = delimiters;
   rfetch2.interceptors = {
     add(interceptor) {
       fetchInterceptors.push(interceptor);
@@ -144,6 +159,7 @@ async function rfetch(url, { params, body, ...options } = {}) {
     }
   };
 })(rfetch || (rfetch = {}));
+exports.DelimiterType = DelimiterType;
 exports.assert = assert;
 exports.delay = delay;
 exports.never = never;

package/dist/index.js

@@ -39,7 +39,13 @@ async function retry(fn, n) {
     }
   }
 }
+var DelimiterType = /* @__PURE__ */ ((DelimiterType2) => {
+  DelimiterType2[DelimiterType2["COMMA"] = 0] = "COMMA";
+  DelimiterType2[DelimiterType2["DUPLICATE"] = 1] = "DUPLICATE";
+  return DelimiterType2;
+})(DelimiterType || {});
 let fetchInterceptors = [];
+let delimiter = 1;
 async function rfetch(url, { params, body, ...options } = {}) {
   var _a, _b;
   const requestInit = {
@@ -48,13 +54,18 @@ async function rfetch(url, { params, body, ...options } = {}) {
   };
   const internalURL = url instanceof URL ? url : new URL(url, url.startsWith("/") ? location.origin : void 0);
   if (params) {
-    for (const [key, values] of Object.entries(params)) {
-      if (Array.isArray(values)) {
-        for (const value of values) {
-          internalURL.searchParams.append(key, value.toString());
-        }
-      } else {
-        internalURL.searchParams.append(key, values.toString());
+    for (const [key, value] of Object.entries(params)) {
+      let values = Array.isArray(value) ? value : [value];
+      values = values.filter((value2) => ![void 0, null].includes(value2));
+      switch (delimiter) {
+        case 0:
+          internalURL.searchParams.set(key, values.map((value2) => value2.toString()).join(","));
+          break;
+        case 1:
+          values.forEach((value2) => {
+            internalURL.searchParams.append(key, value2.toString());
+          });
+          break;
       }
     }
   }
@@ -128,6 +139,10 @@ async function rfetch(url, { params, body, ...options } = {}) {
     });
   }
   rfetch2.remove = remove;
+  async function delimiters(type) {
+    delimiter = type;
+  }
+  rfetch2.delimiters = delimiters;
   rfetch2.interceptors = {
     add(interceptor) {
       fetchInterceptors.push(interceptor);
@@ -143,6 +158,7 @@ async function rfetch(url, { params, body, ...options } = {}) {
   };
 })(rfetch || (rfetch = {}));
 export {
+  DelimiterType,
   assert,
   delay,
   never,

package/dist/rfetch.d.ts

@@ -11,6 +11,10 @@ export type RibbonFetchError<R> = {
     content: R;
 };
 export type RibbonFetchInterceptor = (url: URL, options: RequestInit) => RequestInit | Promise<RequestInit>;
+export declare enum DelimiterType {
+    COMMA = 0,
+    DUPLICATE = 1
+}
 /**
  * A lightweight wrapper around fetch to simplify its usage.
  *
@@ -61,6 +65,7 @@ export declare namespace rfetch {
      * @note This is named `remove` purely because `delete` is a reserved key
      */
     function remove<T>(url: string | URL, options?: RibbonFetchBodyOptions): Promise<T>;
+    function delimiters(type: DelimiterType): Promise<void>;
     const interceptors: {
         add(interceptor: RibbonFetchInterceptor): void;
         remove(interceptor: RibbonFetchInterceptor): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ribbon-studios/js-utils",
-  "version": "1.4.3",
+  "version": "1.5.1",
   "description": "Collection of generic javascript utilities curated by the Rainbow Cafe~",
   "type": "module",
   "source": "src/*.ts",