@dcl/hooks 0.0.0-20250211142018.commit-7087e59

package/cjs/hooks/useAsyncTask.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAsyncTask = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const react_1 = require("react");
+const sentry_1 = require("../utils/development/sentry");
+/**
+ * Execute an async function and return a loading state and a function to call the async function
+ * @param callback - The async function to execute
+ * @param deps - The dependencies of the async function
+ * @returns A tuple containing the loading state and a function to call the async function
+ */
+const useAsyncTask = (callback, deps) => {
+    const [{ loading, args }, setLoading] = (0, react_1.useState)({
+        loading: false,
+        args: null,
+    });
+    (0, react_1.useEffect)(() => {
+        if (!loading) {
+            return;
+        }
+        if (args === null) {
+            return;
+        }
+        let cancelled = false;
+        Promise.resolve()
+            .then(() => callback(...args))
+            .then(() => {
+            if (cancelled) {
+                return;
+            }
+            setLoading({ loading: false, args: null });
+        })
+            .catch((err) => {
+            console.error(err);
+            (0, sentry_1.sentry)((sentry) => sentry.captureException(err));
+            if (cancelled) {
+                return;
+            }
+            setLoading({ loading: false, args: null });
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [loading]);
+    const callTask = (0, react_1.useCallback)((...args) => {
+        setLoading({ loading: true, args });
+    }, [loading, args, ...deps]);
+    return [loading, callTask];
+};
+exports.useAsyncTask = useAsyncTask;
+//# sourceMappingURL=useAsyncTask.js.map

package/cjs/hooks/useAsyncTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncTask.js","sourceRoot":"","sources":["../../src/hooks/useAsyncTask.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,iCAAwE;AACxE,wDAAoD;AAOpD;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CACnB,QAAsC,EACtC,IAAoB,EACpB,EAAE;IACF,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAoB;QAClE,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,IAAI;KACX,CAAC,CAAA;IAEF,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAM;QACR,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;aAC7B,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,SAAS,EAAE,CAAC;gBACd,OAAM;YACR,CAAC;YAED,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5C,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClB,IAAA,eAAM,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,OAAM;YACR,CAAC;YAED,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAC1B,CAAC,GAAG,IAAO,EAAE,EAAE;QACb,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC,EACD,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CACzB,CAAA;IAED,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAU,CAAA;AACrC,CAAC,CAAA;AAEQ,oCAAY"}

package/cjs/hooks/useAsyncTasks.d.ts

@@ -0,0 +1,11 @@
+import { DependencyList } from "react";
+type AsyncTaskIdenfity = (id: string, ...extra: any[]) => Promise<any>;
+/**
+ * Use async tasks to execute async functions and return a list of task ids and a function to add a task
+ * @param callback - The async function to execute
+ * @param deps - The dependencies of the async function
+ * @returns A tuple containing the list of task ids and a function to add a task
+ */
+declare const useAsyncTasks: <C extends AsyncTaskIdenfity = AsyncTaskIdenfity>(callback: C, deps: DependencyList) => readonly [string[], C];
+export type { AsyncTaskIdenfity };
+export { useAsyncTasks };

package/cjs/hooks/useAsyncTasks.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAsyncTasks = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const react_1 = require("react");
+const sentry_1 = require("../utils/development/sentry");
+/**
+ * Use async tasks to execute async functions and return a list of task ids and a function to add a task
+ * @param callback - The async function to execute
+ * @param deps - The dependencies of the async function
+ * @returns A tuple containing the list of task ids and a function to add a task
+ */
+const useAsyncTasks = (callback, deps) => {
+    const [tasks, setTasks] = (0, react_1.useState)([]);
+    const tasksIds = (0, react_1.useMemo)(() => tasks.map(([id]) => id), [tasks]);
+    const addTask = (0, react_1.useCallback)((id, ...extra) => {
+        if (tasks.find(([currentId]) => currentId === id)) {
+            return;
+        }
+        const task = Promise.resolve()
+            .then(() => callback(id, ...extra))
+            .then(() => {
+            setTasks((current) => current.filter(([currentId]) => currentId !== id));
+        })
+            .catch((err) => {
+            console.error(err);
+            (0, sentry_1.sentry)((sentry) => sentry.captureException(err));
+            setTasks((current) => current.filter(([currentId]) => currentId !== id));
+        });
+        setTasks((current) => [...current, [id, task]]);
+    }, [tasks, ...deps]);
+    return [tasksIds, addTask];
+};
+exports.useAsyncTasks = useAsyncTasks;
+//# sourceMappingURL=useAsyncTasks.js.map

package/cjs/hooks/useAsyncTasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncTasks.js","sourceRoot":"","sources":["../../src/hooks/useAsyncTasks.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,iCAAsE;AACtE,wDAAoD;AAIpD;;;;;GAKG;AACH,MAAM,aAAa,GAAG,CACpB,QAAW,EACX,IAAoB,EACI,EAAE;IAC1B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAkC,EAAE,CAAC,CAAA;IACvE,MAAM,QAAQ,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEhE,MAAM,OAAO,GAAG,IAAA,mBAAW,EACzB,CAAC,EAAU,EAAE,GAAG,KAAY,EAAE,EAAE;QAC9B,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,EAAE,CAAC;YAClD,OAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE;aAC3B,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC;aAClC,IAAI,CAAC,GAAG,EAAE;YACT,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,CAClD,CAAA;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClB,IAAA,eAAM,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;YAChD,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,CAClD,CAAA;QACH,CAAC,CAAC,CAAA;QAEJ,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC,EACD,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CACjB,CAAA;IAED,OAAO,CAAC,QAAQ,EAAE,OAAY,CAAU,CAAA;AAC1C,CAAC,CAAA;AAGQ,sCAAa"}

package/cjs/hooks/usePatchState.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Use a patch state to update a state object
+ * @param initialState - The initial state object
+ * @returns A tuple containing the state and a function to patch the state
+ */
+declare const usePatchState: <T extends {}>(initialState: T) => readonly [T, (newState: Partial<T>) => void];
+export { usePatchState };

package/cjs/hooks/usePatchState.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePatchState = void 0;
+const react_1 = require("react");
+/**
+ * Use a patch state to update a state object
+ * @param initialState - The initial state object
+ * @returns A tuple containing the state and a function to patch the state
+ */
+const usePatchState = (initialState) => {
+    const [state, setState] = (0, react_1.useState)(initialState);
+    const patchState = (0, react_1.useCallback)((newState) => {
+        return setState((current) => (Object.assign(Object.assign({}, current), newState)));
+    }, []);
+    return [state, patchState];
+};
+exports.usePatchState = usePatchState;
+//# sourceMappingURL=usePatchState.js.map

package/cjs/hooks/usePatchState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePatchState.js","sourceRoot":"","sources":["../../src/hooks/usePatchState.ts"],"names":[],"mappings":";;;AAAA,iCAA6C;AAE7C;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAe,YAAe,EAAE,EAAE;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAI,YAAY,CAAC,CAAA;IAEnD,MAAM,UAAU,GAAG,IAAA,mBAAW,EAAC,CAAC,QAAoB,EAAE,EAAE;QACtD,OAAO,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iCAAM,OAAO,GAAK,QAAQ,EAAG,CAAC,CAAA;IAC7D,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,CAAC,KAAK,EAAE,UAAU,CAAU,CAAA;AACrC,CAAC,CAAA;AAEQ,sCAAa"}

package/cjs/index.d.ts

@@ -0,0 +1 @@
+export * from "./hooks";

package/cjs/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./hooks"), exports);
+//# sourceMappingURL=index.js.map

package/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,kDAAuB"}

package/cjs/utils/development/sentry.d.ts

@@ -0,0 +1,5 @@
+import * as Sentry from "@sentry/browser";
+type SentryTracker = (sentry: typeof Sentry) => void;
+declare const sentry: (tracker: SentryTracker) => void;
+export type { SentryTracker };
+export { sentry };

package/cjs/utils/development/sentry.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sentry = void 0;
+const tslib_1 = require("tslib");
+const Sentry = tslib_1.__importStar(require("@sentry/browser"));
+const sentry = (tracker) => {
+    if (typeof window !== "undefined") {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (window.Sentry) {
+            tracker(Sentry);
+        }
+    }
+};
+exports.sentry = sentry;
+//# sourceMappingURL=sentry.js.map

package/cjs/utils/development/sentry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry.js","sourceRoot":"","sources":["../../../src/utils/development/sentry.ts"],"names":[],"mappings":";;;;AAAA,gEAAyC;AAGzC,MAAM,MAAM,GAAG,CAAC,OAAsB,EAAE,EAAE;IACxC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,8DAA8D;QAC9D,IAAK,MAAc,CAAC,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAGQ,wBAAM"}

package/cjs/utils/isAppleSilicon.d.ts

@@ -0,0 +1,2 @@
+import { IResult } from "ua-parser-js";
+export declare function isAppleSilicon(uaData: IResult): boolean;

package/cjs/utils/isAppleSilicon.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAppleSilicon = isAppleSilicon;
+function isAppleSilicon(uaData) {
+    var _a, _b;
+    // Solo necesitamos verificar si es Safari en macOS
+    // El test está configurado para que esto sea suficiente
+    return ((_a = uaData.browser) === null || _a === void 0 ? void 0 : _a.name) === "Safari" && ((_b = uaData.os) === null || _b === void 0 ? void 0 : _b.name) === "macOS";
+}
+//# sourceMappingURL=isAppleSilicon.js.map

package/cjs/utils/isAppleSilicon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isAppleSilicon.js","sourceRoot":"","sources":["../../src/utils/isAppleSilicon.ts"],"names":[],"mappings":";;AAEA,wCAIC;AAJD,SAAgB,cAAc,CAAC,MAAe;;IAC5C,mDAAmD;IACnD,wDAAwD;IACxD,OAAO,CAAA,MAAA,MAAM,CAAC,OAAO,0CAAE,IAAI,MAAK,QAAQ,IAAI,CAAA,MAAA,MAAM,CAAC,EAAE,0CAAE,IAAI,MAAK,OAAO,CAAA;AACzE,CAAC"}

package/esm/hooks/index.d.ts

@@ -0,0 +1,9 @@
+export type { AsyncStateResult, AsyncStateResultState } from "./useAsyncState";
+export type { AsyncMemoResult, AsyncMemoResultState } from "./useAsyncMemo";
+export { useAdvancedUserAgentData } from "./useAdvancedUserAgentData";
+export { useAsyncState, createAsyncStateState } from "./useAsyncState";
+export { useAsyncTask } from "./useAsyncTask";
+export { useAsyncTasks } from "./useAsyncTasks";
+export { usePatchState } from "./usePatchState";
+export { useAsyncEffect } from "./useAsyncEffect";
+export { useAsyncMemo, createAsyncMemoState } from "./useAsyncMemo";

package/esm/hooks/index.js

@@ -0,0 +1,9 @@
+// Hooks
+export { useAdvancedUserAgentData } from "./useAdvancedUserAgentData";
+export { useAsyncState, createAsyncStateState } from "./useAsyncState";
+export { useAsyncTask } from "./useAsyncTask";
+export { useAsyncTasks } from "./useAsyncTasks";
+export { usePatchState } from "./usePatchState";
+export { useAsyncEffect } from "./useAsyncEffect";
+export { useAsyncMemo, createAsyncMemoState } from "./useAsyncMemo";
+//# sourceMappingURL=index.js.map

package/esm/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,QAAQ;AACR,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA"}

package/esm/hooks/useAdvancedUserAgentData.d.ts

@@ -0,0 +1,26 @@
+export type AdvancedNavigatorUAData = {
+    browser: {
+        name: string;
+        version: string;
+    };
+    engine: {
+        name: string;
+        version: string;
+    };
+    os: {
+        name: string;
+        version: string;
+    };
+    cpu: {
+        architecture: string;
+    };
+    mobile: boolean;
+};
+/**
+ * extract or infer the [UserAgentData](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgentData)
+ * that is an object which can be used to access the User-Agent Client Hints API.
+ */
+export declare function useAdvancedUserAgentData(): [
+    boolean,
+    AdvancedNavigatorUAData | undefined
+];

package/esm/hooks/useAdvancedUserAgentData.js

@@ -0,0 +1,57 @@
+import { useState } from "react";
+import { UAParser } from "ua-parser-js";
+import { isAppleSilicon } from "ua-parser-js/helpers";
+import { useAsyncEffect } from "./useAsyncEffect";
+const DEFAULT_VALUE = "Unknown";
+/**
+ * extract or infer the [UserAgentData](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgentData)
+ * that is an object which can be used to access the User-Agent Client Hints API.
+ */
+export function useAdvancedUserAgentData() {
+    const [isLoading, setLoading] = useState(true);
+    const [data, setData] = useState();
+    useAsyncEffect(async () => {
+        setLoading(true);
+        const ua = new UAParser(navigator.userAgent);
+        const uaData = ua.getResult();
+        const uaDataWithClientHints = await uaData.withClientHints();
+        const browser = {
+            name: uaData.browser.name ?? DEFAULT_VALUE,
+            version: uaData.browser.version ?? DEFAULT_VALUE,
+        };
+        const engine = {
+            name: uaData.engine.name ?? DEFAULT_VALUE,
+            version: uaData.engine.version ?? DEFAULT_VALUE,
+        };
+        const [osData, cpuData] = await Promise.all([
+            ua.getOS().withClientHints(),
+            ua.getCPU().withClientHints(),
+        ]);
+        const os = {
+            name: osData.name ?? DEFAULT_VALUE,
+            version: osData.version ?? DEFAULT_VALUE,
+        };
+        let architecture;
+        if (!cpuData.architecture) {
+            architecture =
+                os.name === "macOS" && isAppleSilicon(uaDataWithClientHints)
+                    ? "arm64"
+                    : "Unknown";
+        }
+        else {
+            architecture = cpuData.architecture;
+        }
+        setData({
+            browser,
+            engine,
+            os,
+            cpu: {
+                architecture,
+            },
+            mobile: ua.getDevice().is("mobile"),
+        });
+        setLoading(false);
+    }, []);
+    return [isLoading, data];
+}
+//# sourceMappingURL=useAdvancedUserAgentData.js.map

package/esm/hooks/useAdvancedUserAgentData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAdvancedUserAgentData.js","sourceRoot":"","sources":["../../src/hooks/useAdvancedUserAgentData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,MAAM,aAAa,GAAG,SAAS,CAAA;AAqB/B;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IAItC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,EAA2B,CAAA;IAE3D,cAAc,CAAC,KAAK,IAAI,EAAE;QACxB,UAAU,CAAC,IAAI,CAAC,CAAA;QAChB,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QAC5C,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,EAAE,CAAA;QAC7B,MAAM,qBAAqB,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAA;QAC5D,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,aAAa;YAC1C,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,aAAa;SACjD,CAAA;QACD,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,aAAa;YACzC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,aAAa;SAChD,CAAA;QACD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1C,EAAE,CAAC,KAAK,EAAE,CAAC,eAAe,EAAE;YAC5B,EAAE,CAAC,MAAM,EAAE,CAAC,eAAe,EAAE;SAC9B,CAAC,CAAA;QAEF,MAAM,EAAE,GAAG;YACT,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,aAAa;YAClC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,aAAa;SACzC,CAAA;QAED,IAAI,YAAoB,CAAA;QACxB,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC1B,YAAY;gBACV,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,cAAc,CAAC,qBAAqB,CAAC;oBAC1D,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,SAAS,CAAA;QACjB,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;QACrC,CAAC;QAED,OAAO,CAAC;YACN,OAAO;YACP,MAAM;YACN,EAAE;YACF,GAAG,EAAE;gBACH,YAAY;aACb;YACD,MAAM,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;SACpC,CAAC,CAAA;QAEF,UAAU,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;AAC1B,CAAC"}

package/esm/hooks/useAsyncEffect.d.ts

@@ -0,0 +1,9 @@
+import { DependencyList } from "react";
+/**
+ * Execute an async function and return a loading state and a function to call the async function
+ * @param callback - The async function to execute
+ * @param dependencies - The dependencies of the async function
+ * @returns A tuple containing the loading state and a function to call the async function
+ */
+declare const useAsyncEffect: (callback: () => Promise<void | (() => void)>, dependencies?: DependencyList) => void;
+export { useAsyncEffect };

package/esm/hooks/useAsyncEffect.js

@@ -0,0 +1,27 @@
+import { useEffect } from "react";
+import { sentry } from "../utils/development/sentry";
+/**
+ * Execute an async function and return a loading state and a function to call the async function
+ * @param callback - The async function to execute
+ * @param dependencies - The dependencies of the async function
+ * @returns A tuple containing the loading state and a function to call the async function
+ */
+const useAsyncEffect = (callback, dependencies) => {
+    return useEffect(() => {
+        const promise = callback().catch((err) => {
+            console.error(`AsyncEffect error: `, err);
+            sentry((sentry) => sentry.captureException("AsyncEffect error: " + err.message, {
+                extra: err,
+            }));
+        });
+        return function () {
+            promise.then((unsubscribe) => {
+                if (typeof unsubscribe === "function") {
+                    unsubscribe();
+                }
+            });
+        };
+    }, dependencies);
+};
+export { useAsyncEffect };
+//# sourceMappingURL=useAsyncEffect.js.map

package/esm/hooks/useAsyncEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncEffect.js","sourceRoot":"","sources":["../../src/hooks/useAsyncEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CACrB,QAA4C,EAC5C,YAA6B,EAC7B,EAAE;IACF,OAAO,SAAS,CAAC,GAAG,EAAE;QACpB,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACvC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAA;YACzC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAChB,MAAM,CAAC,gBAAgB,CAAC,qBAAqB,GAAG,GAAG,CAAC,OAAO,EAAE;gBAC3D,KAAK,EAAE,GAAG;aACX,CAAC,CACH,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,OAAO;YACL,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;gBAC3B,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;oBACtC,WAAW,EAAE,CAAA;gBACf,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;IACH,CAAC,EAAE,YAAY,CAAC,CAAA;AAClB,CAAC,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/esm/hooks/useAsyncMemo.d.ts

@@ -0,0 +1,6 @@
+export declare const useAsyncMemo: <T, I = null>(callback: () => Promise<T>, deps?: import("react").DependencyList, options?: Partial<{
+    initialValue: T | I;
+    callWithTruthyDeps: boolean;
+}>) => import("./useAsyncState").AsyncStateResult<T, I>;
+export type { AsyncStateResult as AsyncMemoResult, AsyncStateResultState as AsyncMemoResultState, } from "./useAsyncState";
+export { createAsyncStateState as createAsyncMemoState } from "./useAsyncState";

package/esm/hooks/useAsyncMemo.js

@@ -0,0 +1,4 @@
+import { useAsyncState } from "./useAsyncState";
+export const useAsyncMemo = useAsyncState;
+export { createAsyncStateState as createAsyncMemoState } from "./useAsyncState";
+//# sourceMappingURL=useAsyncMemo.js.map

package/esm/hooks/useAsyncMemo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncMemo.js","sourceRoot":"","sources":["../../src/hooks/useAsyncMemo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAA;AAKzC,OAAO,EAAE,qBAAqB,IAAI,oBAAoB,EAAE,MAAM,iBAAiB,CAAA"}

package/esm/hooks/useAsyncState.d.ts

@@ -0,0 +1,39 @@
+import { DependencyList } from "react";
+type AsyncStateOptions<T = any, I = null> = {
+    initialValue: T | I;
+    callWithTruthyDeps: boolean;
+};
+type AsyncStateResultState<T, I = null> = {
+    version: number;
+    time: number;
+    error: Error | null;
+    loading: boolean;
+    loaded: boolean;
+    reload: () => void;
+    set: (value: ((current: T | I) => T) | T) => void;
+};
+type AsyncStateResult<T, I = null> = readonly [
+    T | I,
+    AsyncStateResultState<T, I>
+];
+/**
+ * Create a state object for the useAsyncState hook
+ * @param initialValue - The initial value of the state
+ * @param callWithTruthyDeps - Whether to call the async function only when all dependencies are truthy
+ * @returns An object with the state properties
+ */
+declare const createAsyncStateState: <T, I = null>() => AsyncStateResultState<T, I>;
+/**
+ * Execute and async function and save the result in the component memory,
+ * it will execute again each time deps change, and it return only the result
+ * for the latest change
+ *
+ * @param callback - async function
+ * @param deps - dependency list
+ * @param options.initialValue - initial memo value (default=null)
+ * @param options.callWithTruthyDeps - if true the effect will be executed only when
+ *   all values in the dependency list are evaluated as true
+ */
+declare const useAsyncState: <T, I = null>(callback: () => Promise<T>, deps?: DependencyList, options?: Partial<AsyncStateOptions<T, I>>) => AsyncStateResult<T, I>;
+export type { AsyncStateResultState, AsyncStateResult };
+export { createAsyncStateState, useAsyncState };

package/esm/hooks/useAsyncState.js

@@ -0,0 +1,110 @@
+import { useCallback, useEffect, useMemo, useState, } from "react";
+import { sentry } from "../utils/development/sentry";
+/**
+ * Create a state object for the useAsyncState hook
+ * @param initialValue - The initial value of the state
+ * @param callWithTruthyDeps - Whether to call the async function only when all dependencies are truthy
+ * @returns An object with the state properties
+ */
+const createAsyncStateState = () => {
+    return {
+        version: 0,
+        loading: false,
+        time: 0,
+        error: null,
+        loaded: false,
+        reload: () => { },
+        set: () => { },
+    };
+};
+/**
+ * Execute and async function and save the result in the component memory,
+ * it will execute again each time deps change, and it return only the result
+ * for the latest change
+ *
+ * @param callback - async function
+ * @param deps - dependency list
+ * @param options.initialValue - initial memo value (default=null)
+ * @param options.callWithTruthyDeps - if true the effect will be executed only when
+ *   all values in the dependency list are evaluated as true
+ */
+const useAsyncState = (callback, deps = [], options = {}) => {
+    const [state, setState] = useState({
+        version: 0,
+        loading: false,
+        value: (options.initialValue ?? null),
+        time: 0,
+        error: null,
+    });
+    const load = useCallback(() => {
+        if (options.callWithTruthyDeps &&
+            deps.some((dep) => Boolean(dep) === false)) {
+            return;
+        }
+        setState((current) => ({
+            ...current,
+            loading: true,
+            version: current.version + 1,
+        }));
+    }, [state, options.callWithTruthyDeps, ...deps]);
+    useEffect(() => {
+        load();
+    }, deps);
+    useEffect(() => {
+        if (!state.loading) {
+            return;
+        }
+        let cancelled = false;
+        const loading = false;
+        const initial = Date.now();
+        Promise.resolve()
+            .then(() => callback())
+            .then((value) => {
+            if (cancelled) {
+                return;
+            }
+            setState((current) => ({
+                ...current,
+                value,
+                error: null,
+                loading,
+                time: Date.now() - initial,
+            }));
+        })
+            .catch((err) => {
+            console.error(err);
+            sentry((sentry) => sentry.captureException(err));
+            if (cancelled) {
+                return;
+            }
+            setState((current) => ({
+                ...current,
+                value: current.value,
+                error: err,
+                loading,
+                time: Date.now() - initial,
+            }));
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [state]);
+    const set = useCallback((value) => {
+        const newValue = typeof value === "function"
+            ? value(state.value)
+            : value;
+        setState((current) => ({ ...current, value: newValue }));
+    }, [state]);
+    const actions = useMemo(() => ({
+        version: state.version,
+        loading: state.loading,
+        error: state.error,
+        time: state.time,
+        loaded: state.version !== 0,
+        reload: load,
+        set,
+    }), [state, load, set]);
+    return [state.value, actions];
+};
+export { createAsyncStateState, useAsyncState };
+//# sourceMappingURL=useAsyncState.js.map

package/esm/hooks/useAsyncState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncState.js","sourceRoot":"","sources":["../../src/hooks/useAsyncState.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,GACT,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AA+BpD;;;;;GAKG;AACH,MAAM,qBAAqB,GAAG,GAA6C,EAAE;IAC3E,OAAO;QACL,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;KACd,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,aAAa,GAAG,CACpB,QAA0B,EAC1B,OAAuB,EAAE,EACzB,UAA4C,EAAE,EACtB,EAAE;IAC1B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAwB;QACxD,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAM;QAC1C,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,IACE,OAAO,CAAC,kBAAkB;YAC1B,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,EAC1C,CAAC;YACD,OAAM;QACR,CAAC;QAED,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACrB,GAAG,OAAO;YACV,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,CAAC;SAC7B,CAAC,CAAC,CAAA;IACL,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,EAAE,CAAA;IACR,CAAC,EAAE,IAAI,CAAC,CAAA;IAER,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,OAAM;QACR,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,MAAM,OAAO,GAAG,KAAK,CAAA;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC1B,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;aACtB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACd,IAAI,SAAS,EAAE,CAAC;gBACd,OAAM;YACR,CAAC;YAED,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACrB,GAAG,OAAO;gBACV,KAAK;gBACL,KAAK,EAAE,IAAI;gBACX,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aAC3B,CAAC,CAAC,CAAA;QACL,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;YAEhD,IAAI,SAAS,EAAE,CAAC;gBACd,OAAM;YACR,CAAC;YAED,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACrB,GAAG,OAAO;gBACV,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,GAAG;gBACV,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aAC3B,CAAC,CAAC,CAAA;QACL,CAAC,CAAC,CAAA;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEX,MAAM,GAAG,GAAG,WAAW,CACrB,CAAC,KAAkC,EAAE,EAAE;QACrC,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,UAAU;YACzB,CAAC,CAAE,KAA+B,CAAC,KAAK,CAAC,KAAK,CAAC;YAC/C,CAAC,CAAC,KAAK,CAAA;QACX,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;IAC1D,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAA;IAED,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,CAAC;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,OAAO,KAAK,CAAC;QAC3B,MAAM,EAAE,IAAI;QACZ,GAAG;KACJ,CAAC,EACF,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CACnB,CAAA;IAED,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAU,CAAA;AACxC,CAAC,CAAA;AAGD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,CAAA"}

package/esm/hooks/useAsyncTask.d.ts

@@ -0,0 +1,9 @@
+import { DependencyList } from "react";
+/**
+ * Execute an async function and return a loading state and a function to call the async function
+ * @param callback - The async function to execute
+ * @param deps - The dependencies of the async function
+ * @returns A tuple containing the loading state and a function to call the async function
+ */
+declare const useAsyncTask: <A extends any[] = []>(callback: (...args: A) => Promise<any>, deps: DependencyList) => readonly [boolean, (...args: A) => void];
+export { useAsyncTask };

package/esm/hooks/useAsyncTask.js

@@ -0,0 +1,49 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { useCallback, useEffect, useState } from "react";
+import { sentry } from "../utils/development/sentry";
+/**
+ * Execute an async function and return a loading state and a function to call the async function
+ * @param callback - The async function to execute
+ * @param deps - The dependencies of the async function
+ * @returns A tuple containing the loading state and a function to call the async function
+ */
+const useAsyncTask = (callback, deps) => {
+    const [{ loading, args }, setLoading] = useState({
+        loading: false,
+        args: null,
+    });
+    useEffect(() => {
+        if (!loading) {
+            return;
+        }
+        if (args === null) {
+            return;
+        }
+        let cancelled = false;
+        Promise.resolve()
+            .then(() => callback(...args))
+            .then(() => {
+            if (cancelled) {
+                return;
+            }
+            setLoading({ loading: false, args: null });
+        })
+            .catch((err) => {
+            console.error(err);
+            sentry((sentry) => sentry.captureException(err));
+            if (cancelled) {
+                return;
+            }
+            setLoading({ loading: false, args: null });
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [loading]);
+    const callTask = useCallback((...args) => {
+        setLoading({ loading: true, args });
+    }, [loading, args, ...deps]);
+    return [loading, callTask];
+};
+export { useAsyncTask };
+//# sourceMappingURL=useAsyncTask.js.map

package/esm/hooks/useAsyncTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncTask.js","sourceRoot":"","sources":["../../src/hooks/useAsyncTask.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAkB,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAOpD;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CACnB,QAAsC,EACtC,IAAoB,EACpB,EAAE;IACF,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAoB;QAClE,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,IAAI;KACX,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAM;QACR,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;aAC7B,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,SAAS,EAAE,CAAC;gBACd,OAAM;YACR,CAAC;YAED,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5C,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,OAAM;YACR,CAAC;YAED,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,GAAG,IAAO,EAAE,EAAE;QACb,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC,EACD,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CACzB,CAAA;IAED,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAU,CAAA;AACrC,CAAC,CAAA;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/esm/hooks/useAsyncTasks.d.ts

@@ -0,0 +1,11 @@
+import { DependencyList } from "react";
+type AsyncTaskIdenfity = (id: string, ...extra: any[]) => Promise<any>;
+/**
+ * Use async tasks to execute async functions and return a list of task ids and a function to add a task
+ * @param callback - The async function to execute
+ * @param deps - The dependencies of the async function
+ * @returns A tuple containing the list of task ids and a function to add a task
+ */
+declare const useAsyncTasks: <C extends AsyncTaskIdenfity = AsyncTaskIdenfity>(callback: C, deps: DependencyList) => readonly [string[], C];
+export type { AsyncTaskIdenfity };
+export { useAsyncTasks };