@react-fabric/utilities 1.0.0-beta.0

package/src/_debounce.ts

@@ -0,0 +1,42 @@
+/*
+ * React Fabric
+ * @version: 1.0.0
+ *
+ *
+ * The MIT License (MIT)
+ * Copyright (c) 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
+ * and associated documentation files (the "Software"), to deal in the Software without restriction,
+ * including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial
+ * portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+ * TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+/* istanbul ignore file */
+
+/**
+ * debounce callback
+ * @internal
+ */
+export const debounce = (fn: (...rest: any) => any, timeout = 500) => {
+  /** ***************** create debounce timer id using callback hash *******************/
+  let _timer: any;
+
+  /** ***************** return debounced function *******************/
+  const cb = (...args: any) => {
+    clearTimeout(_timer);
+    if (typeof window !== "undefined")
+      _timer = window.setTimeout(() => fn?.(...args), timeout);
+  };
+  cb.cancel = () => clearTimeout(_timer);
+  return cb;
+};

package/src/_dedupe.ts

@@ -0,0 +1,56 @@
+/*
+ * React Fabric
+ * @version: 1.0.0
+ *
+ *
+ * The MIT License (MIT)
+ * Copyright (c) 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
+ * and associated documentation files (the "Software"), to deal in the Software without restriction,
+ * including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial
+ * portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+ * TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+import { isEmpty } from "./_isType";
+
+export const dedupe = (list: any[], key?: string) => {
+  const filtered = list.filter((i) => !isEmpty(i));
+  if (!key) {
+    return Array.from(new Set(filtered).values());
+  }
+
+  return Array.from(
+    new Map(filtered.map((obj) => [obj[key] ?? obj, obj])).values(),
+  );
+};
+
+export const flatten = (list: any[]) => {
+  return list.flat(5).filter((i) => !isEmpty(i));
+};
+
+export const flattenAndDedupe = (list: any[] = [], key?: string) => {
+  return dedupe(flatten(list), key);
+};
+
+export const groupBy = <T extends KeyValue>(
+  list: T[],
+  prop: keyof T,
+  missingKey?: string,
+): KeyValue<T[]> => {
+  return list.reduce((r: AnyObject, i) => {
+    const key = i[prop] ?? missingKey;
+    if (!r[key]) r[key] = [];
+    r[key].push(i);
+    return r;
+  }, {});
+};

package/src/_fetch.ts

@@ -0,0 +1,109 @@
+/*
+ * React Fabric
+ * @version: 1.0.0
+ *
+ *
+ * The MIT License (MIT)
+ * Copyright (c) 2024 Adarsh Pastakia
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
+ * and associated documentation files (the "Software"), to deal in the Software without restriction,
+ * including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial
+ * portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+ * TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+/* istanbul ignore file */
+
+import { isString } from "./_isType";
+
+declare type METHODS = "get" | "post" | "put" | "delete";
+declare interface FetchOptions {
+  body?: KeyValue | FormData;
+  headers?: KeyValue;
+  signal?: string | AbortSignal;
+}
+
+const _signals = new Map<string, AbortController>();
+
+/**
+ * Fetch helper
+ * @param method
+ * @param url
+ * @param options.headers
+ * @param options.body
+ * @param options.signal
+ * @internal
+ */
+export const _fetch = async (
+  method: METHODS,
+  url: string,
+  { headers = {}, body, signal }: FetchOptions,
+) => {
+  const options: KeyValue = {
+    method,
+  };
+
+  headers.accept = "application/json";
+  if (method === "post" || method === "put") {
+    options.body = body;
+    /** ***************** set body to json when not FormData *******************/
+    if (!(body instanceof FormData)) {
+      headers["content-type"] = "application/json";
+      options.body = JSON.stringify(body);
+    }
+  }
+
+  /** ***************** reset abort signal *******************/
+  if (signal && isString(signal)) {
+    if (_signals.has(signal)) {
+      const _s = _signals.get(signal);
+      _s?.abort();
+      _signals.delete(signal);
+    }
+    const ac = new AbortController();
+    options.signal = ac.signal;
+    _signals.set(signal, ac);
+  } else if (signal instanceof AbortSignal) {
+    options.signal = signal;
+  }
+
+  return await fetch(url, { ...options, headers })
+    .then(async (resp) => {
+      if (resp.status >= 200 && resp.status < 300) {
+        return await resp.json();
+      }
+      // eslint-disable-next-line @typescript-eslint/no-throw-literal
+      throw { status: resp.status, code: -1, message: resp.statusText };
+    })
+    .then((resp) => {
+      /** ***************** check for possible error code propeties in response *******************/
+      const code = resp.error_code ?? resp.errorCode ?? resp.error;
+      const message = resp.error_message ?? resp.errorMessage ?? resp.message;
+      if (resp.status === "error" || code) {
+        // eslint-disable-next-line @typescript-eslint/no-throw-literal
+        throw { status: 500, code, message };
+      }
+      return resp;
+    });
+};
+
+/** ***************** attach isAborted helper to fetch method *******************/
+_fetch.isAborted = ({ name }: Error) => name === "AbortError";
+
+/** ***************** attach abort helper to fetch method *******************/
+_fetch.abort = (signal: string) => {
+  if (_signals.has(signal)) {
+    const _s = _signals.get(signal);
+    _s?.abort();
+    _signals.delete(signal);
+  }
+};