@cripty2001/utils 0.0.14 → 0.0.16

package/dist/react-whispr.d.ts

@@ -1,4 +1,5 @@
 import { Whispr } from "@cripty2001/whispr";
+import { Dispatcher } from "./Dispatcher";
 /**
  * Convert a Whispr value into a reactive react value, usable in function components with the standard react reactive system.
  * If the value is not a Whispr, it is returned as is, thus allowing for progressive migration and adoption
@@ -26,3 +27,16 @@ export declare function useWhisprValue<I, O = I>(w: Whispr<I>, computer?: (data:
 export declare function useWhispr<T>(data: T | Whispr<T>): Whispr<T>;
 export declare function useCurrentTimestamp(): number;
 export declare function useDebounced<T>(value: T): T;
+/**
+ *
+ * Wraps an async function into a reactable data.
+ *
+ * @param f The async function to call. It should return a promise that resolves to the data. It is not reactive
+ * @param data The data to give to f. It must be stable, as anything in the dependency array of the useEffect and similars in the react ecosystem.
+ * @param debouce Debounce time in ms. Default to 200ms. The async function will not be called if this time has not passed since the useAsync first invocation or value change. If another change happens during the wait, the first function call is never executed
+ * @returns  The dispatcher
+ *
+ * @type I Input for the async function.
+ * @type O Output for the async function
+ */
+export declare function useAsync<I, O>(f: (input: I, setProgress: (p: number) => void, signal: AbortSignal) => Promise<O>, data: I, debouce?: number): Dispatcher<I, O>;

package/dist/react-whispr.js

@@ -4,9 +4,11 @@ exports.useWhisprValue = useWhisprValue;
 exports.useWhispr = useWhispr;
 exports.useCurrentTimestamp = useCurrentTimestamp;
 exports.useDebounced = useDebounced;
+exports.useAsync = useAsync;
 const whispr_1 = require("@cripty2001/whispr");
 const react_1 = require("react");
 const lodash_1 = require("lodash");
+const Dispatcher_1 = require("./Dispatcher");
 /**
  * Convert a Whispr value into a reactive react value, usable in function components with the standard react reactive system.
  * If the value is not a Whispr, it is returned as is, thus allowing for progressive migration and adoption
@@ -71,3 +73,26 @@ function useDebounced(value) {
     }, [value]);
     return debounced;
 }
+/**
+ *
+ * Wraps an async function into a reactable data.
+ *
+ * @param f The async function to call. It should return a promise that resolves to the data. It is not reactive
+ * @param data The data to give to f. It must be stable, as anything in the dependency array of the useEffect and similars in the react ecosystem.
+ * @param debouce Debounce time in ms. Default to 200ms. The async function will not be called if this time has not passed since the useAsync first invocation or value change. If another change happens during the wait, the first function call is never executed
+ * @returns  The dispatcher
+ *
+ * @type I Input for the async function.
+ * @type O Output for the async function
+ */
+function useAsync(f, data, debouce = 200) {
+    // Initing reactive input
+    const [input, setInput] = whispr_1.Whispr.create(data);
+    (0, react_1.useEffect)(() => {
+        setInput(data);
+    }, [data, setInput]);
+    // Initing dispatcher
+    const dispatcher = (0, react_1.useRef)(new Dispatcher_1.Dispatcher(input, f, debouce)).current;
+    // Returning dispatcher
+    return dispatcher;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cripty2001/utils",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "Internal Set of utils. If you need them use them, otherwise go to the next package ;)",
   "homepage": "https://github.com/cripty2001/utils#readme",
   "bugs": {
@@ -22,8 +22,8 @@
     "dist"
   ],
   "devDependencies": {
-    "@types/react": "^19.1.8",
-    "react": "^19.1.8",
+    "@types/react": "^19",
+    "react": "^19",
     "typescript": "^5.9.3"
   },
   "dependencies": {
@@ -32,7 +32,7 @@
     "lodash": "^4.17.21"
   },
   "peerDependencies": {
-    "react": "^19.1.8"
+    "react": "^19"
   },
   "peerDependenciesMeta": {
     "react": {