@cripty2001/utils 0.0.27 → 0.0.29

package/dist/index.d.ts

@@ -29,3 +29,5 @@ export declare function parseQuery(query: string | Record<string, any> | URLSear
     left: URLSearchParams;
 };
 export declare function randBetween(min: number, max: number): number;
+import "dotenv/config";
+export declare function getEnv(key: string, defaultValue: string | undefined): string;

package/dist/index.js

@@ -13,6 +13,7 @@ exports.download = download;
 exports.stableLog = stableLog;
 exports.parseQuery = parseQuery;
 exports.randBetween = randBetween;
+exports.getEnv = getEnv;
 const lodash_1 = require("lodash");
 function getRandom(_alphabeth, length) {
     const alphabeth = _alphabeth.split("");
@@ -134,3 +135,10 @@ function parseQuery(query, fields) {
 function randBetween(min, max) {
     return Math.floor(Math.random() * (max - min + 1)) + min;
 }
+require("dotenv/config");
+function getEnv(key, defaultValue) {
+    const value = process.env[key] ?? defaultValue;
+    if (value === undefined)
+        throw new Error(`Environment variable ${key} is not defined and no default value was provided.`);
+    return value;
+}

package/dist/react-whispr.d.ts

@@ -25,6 +25,12 @@ export declare function useWhisprValue<I, O = I>(w: Whispr<I>, computer?: (data:
  * @remarks The returned whispr has already been ref-fed, so it can be directly used without worrying about react recreating it or similar bad things
  */
 export declare function useWhispr<T>(data: T | Whispr<T>): Whispr<T>;
+/**
+ * Subscribe a callback to a Whispr inside a react component, properly handling unsubscription on unmount.
+ * @param w The whispr to subscribe to
+ * @param cb The callback to call on value change
+ */
+export declare function useOnWhispr<T>(w: Whispr<T>, cb: (value: T) => void): void;
 export declare function useCurrentTimestamp(refresh?: number): number;
 export declare function useDebounced<T>(value: T): T;
 /**

package/dist/react-whispr.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useWhisprValue = useWhisprValue;
 exports.useWhispr = useWhispr;
+exports.useOnWhispr = useOnWhispr;
 exports.useCurrentTimestamp = useCurrentTimestamp;
 exports.useDebounced = useDebounced;
 exports.useAsync = useAsync;
@@ -54,6 +55,17 @@ function useWhispr(data) {
         return data;
     return w;
 }
+/**
+ * Subscribe a callback to a Whispr inside a react component, properly handling unsubscription on unmount.
+ * @param w The whispr to subscribe to
+ * @param cb The callback to call on value change
+ */
+function useOnWhispr(w, cb) {
+    (0, react_1.useEffect)(() => {
+        const unsub = w.subscribe(cb);
+        return () => unsub();
+    }, [w, cb]);
+}
 function useCurrentTimestamp(refresh = 1000) {
     const [currTs, setCurrTs] = (0, react_1.useState)(Date.now());
     (0, react_1.useEffect)(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cripty2001/utils",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "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,6 +22,7 @@
     "dist"
   ],
   "devDependencies": {
+    "@types/node": "^24.9.1",
     "@types/react": "^19",
     "react": "^19",
     "typescript": "^5.9.3"
@@ -29,6 +30,7 @@
   "dependencies": {
     "@cripty2001/whispr": "^0.1.0",
     "@types/lodash": "^4.17.20",
+    "dotenv": "^17.2.3",
     "lodash": "^4.17.21"
   },
   "peerDependencies": {