@zlikemario/helper 0.0.11 → 0.0.12

package/dist/react/index.d.ts

@@ -0,0 +1,3 @@
+export { default as useCatchError } from "./useCatchError";
+export { default as useLoadingEvent } from "./useLoadingEvent";
+export { default as useSyncedRef } from "./useSyncedRef";

package/dist/react/useCatchError.d.ts

@@ -0,0 +1,8 @@
+declare const useCatchError: <Args extends any[], R, IsThrowError extends boolean = false>(execute: (...args: Args) => MaybePromise<R>, options?: Partial<{
+    target: string;
+    timeout: number;
+    timeoutError: any;
+    isThrowError: IsThrowError;
+    onError: (error: unknown, target: MaybeUndefined<string>, ...args: Args) => any;
+}>) => (...args: Args) => Promise<R | (IsThrowError extends true ? never : undefined)>;
+export default useCatchError;

package/dist/react/useLoadingEvent.d.ts

@@ -0,0 +1,4 @@
+declare const useLoadingEvent: <Args extends any[], R extends any>(execute: (...args: Args) => Promise<R>, options?: Partial<{
+    isAllowMulticall: boolean;
+}>) => [(...args: Args) => Promise<R>, boolean];
+export default useLoadingEvent;

package/dist/react/useSyncedRef.d.ts

@@ -0,0 +1,4 @@
+declare const useSyncedRef: <T>(value: T) => Readonly<{
+    readonly current: T;
+}>;
+export default useSyncedRef;

package/dist/react.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react"),m=require("./utils.cjs"),a=n=>{const e=o.useRef(n);return e.current=n,o.useMemo(()=>Object.freeze({get current(){return e.current}}),[])},f=(n,e)=>{const u=e?.timeout??2e4,r=a({options:{timeout:u,timeoutError:e?.timeoutError?e?.timeoutError:new Error(`${e?.target?`${e?.target} `:""}Timeout of ${u}ms exceeded`),isThrowError:e?.isThrowError??!1,...e},execute:n});return o.useCallback(async(...s)=>{try{return await m.preventTimeout(Promise.resolve(r.current.execute(...s)),{timeout:r.current.options.timeout,timeoutError:r.current.options.timeoutError})}catch(t){if(r.current.options.onError?.(t,r.current.options.target,...s),r.current.options.isThrowError)throw t;return}},[])},E=(n,e)=>{const[u,r]=o.useState(!1),s=o.useRef(0),t=o.useRef(void 0),c=a({options:{isAllowMulticall:!1,...e},execute:n,isLoading:u}),l=i=>{c.current.isLoading=i,r(i)};return[o.useCallback(async(...i)=>{if(c.current.isLoading&&t.current&&!c.current.options.isAllowMulticall)return t.current;l(!0);const d=s.current+=1;return t.current=c.current.execute(...i).finally(()=>{d===s.current&&(t.current=void 0,l(!1))}),t.current},[]),u]};exports.useCatchError=f;exports.useLoadingEvent=E;exports.useSyncedRef=a;

package/dist/react.js

@@ -0,0 +1,67 @@
+import { useRef as i, useMemo as f, useCallback as m, useState as E } from "react";
+import { preventTimeout as g } from "./utils.js";
+const l = (o) => {
+  const r = i(o);
+  return r.current = o, f(
+    () => Object.freeze({
+      get current() {
+        return r.current;
+      }
+    }),
+    []
+  );
+}, v = (o, r) => {
+  const n = r?.timeout ?? 2e4, e = l({
+    options: {
+      timeout: n,
+      timeoutError: r?.timeoutError ? r?.timeoutError : new Error(`${r?.target ? `${r?.target} ` : ""}Timeout of ${n}ms exceeded`),
+      isThrowError: r?.isThrowError ?? !1,
+      ...r
+    },
+    execute: o
+  });
+  return m(async (...u) => {
+    try {
+      return await g(Promise.resolve(e.current.execute(...u)), {
+        timeout: e.current.options.timeout,
+        timeoutError: e.current.options.timeoutError
+      });
+    } catch (t) {
+      if (e.current.options.onError?.(t, e.current.options.target, ...u), e.current.options.isThrowError)
+        throw t;
+      return;
+    }
+  }, []);
+}, p = (o, r) => {
+  const [n, e] = E(!1), u = i(0), t = i(void 0), s = l({
+    options: {
+      /**
+       * 是否允许函数多次调用，默认: false
+       * false 情况下，如果再次执行 execute 会引用上一次的 promise 直接返回
+       */
+      isAllowMulticall: !1,
+      ...r
+    },
+    execute: o,
+    isLoading: n
+  }), a = (c) => {
+    s.current.isLoading = c, e(c);
+  };
+  return [
+    m(async (...c) => {
+      if (s.current.isLoading && t.current && !s.current.options.isAllowMulticall)
+        return t.current;
+      a(!0);
+      const d = u.current += 1;
+      return t.current = s.current.execute(...c).finally(() => {
+        d === u.current && (t.current = void 0, a(!1));
+      }), t.current;
+    }, []),
+    n
+  ];
+};
+export {
+  v as useCatchError,
+  p as useLoadingEvent,
+  l as useSyncedRef
+};

package/dist/utils.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=(e=1500)=>new Promise(n=>setTimeout(n,e));function l(e,n=4,r=4,t="..."){return!e||e.length<=n+r?e:e.slice(0,n)+t+(r?e.slice(-r):"")}const i=e=>e===void 0,m=(...e)=>e.some(i),y=e=>!!e&&typeof e?.then=="function"&&typeof e?.catch=="function";function s(e){let n="";for(let r=0;r<e.length;r++)n+=String.fromCharCode(e[r]);return btoa(n)}function d(e){const n=atob(e),r=new Uint8Array(n.length);for(let t=0;t<n.length;t++)r[t]=n.charCodeAt(t);return r}function h(e){return s(new Uint8Array(e))}function o(e){if(typeof e!="string"||(e=e.toLowerCase(),!/^[0-9a-z.\-]+$/.test(e))||e.includes("--")||e.includes("-.")||e.includes(".-")||e.startsWith("-")||e.endsWith("-"))return!1;const n=e.split(".");return!(n.length<2||n.some(r=>!r.length)||n[n.length-1].length<2)}function g(e){const[n,...r]=e.toLowerCase().split("@");if(!n||!r.length||!/^[a-z0-9._-]+$/.test(n)||/^\.|\.$/.test(n)||/[.\-_]{2,}/.test(n)||/[.\-_](?![a-z0-9])/.test(n))return!1;for(const t of r)if(!o(t))return!1;return!0}const p=async(e,n)=>{try{return await e}catch(r){return n?.(r)}};async function T(e,n){const{errorMessage:r="Timeout",timeout:t=15e3}=n||{},a=typeof e=="function"?e():e,u=new Promise((A,f)=>setTimeout(()=>f(new Error(r)),t));return Promise.race([a,u])}const P=(e,n,r)=>e.some(i)?r:n(...e);exports.arrayBufferToBase64=h;exports.base64ToUint8Array=d;exports.computeWithDefinedParams=P;exports.encrypt=l;exports.isDomain=o;exports.isEmail=g;exports.isHasUndefined=m;exports.isPromise=y;exports.isUndefined=i;exports.preventTimeout=T;exports.sleep=c;exports.tryCatchAsync=p;exports.uint8ArrayToBase64=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=(e=1500)=>new Promise(n=>setTimeout(n,e));function m(e,n=4,r=4,t="..."){return!e||e.length<=n+r?e:e.slice(0,n)+t+(r?e.slice(-r):"")}const i=e=>e===void 0,y=(...e)=>e.some(i),d=e=>!!e&&typeof e?.then=="function"&&typeof e?.catch=="function";function s(e){let n="";for(let r=0;r<e.length;r++)n+=String.fromCharCode(e[r]);return btoa(n)}function h(e){const n=atob(e),r=new Uint8Array(n.length);for(let t=0;t<n.length;t++)r[t]=n.charCodeAt(t);return r}function g(e){return s(new Uint8Array(e))}function o(e){if(typeof e!="string"||(e=e.toLowerCase(),!/^[0-9a-z.\-]+$/.test(e))||e.includes("--")||e.includes("-.")||e.includes(".-")||e.startsWith("-")||e.endsWith("-"))return!1;const n=e.split(".");return!(n.length<2||n.some(r=>!r.length)||n[n.length-1].length<2)}function p(e){const[n,...r]=e.toLowerCase().split("@");if(!n||!r.length||!/^[a-z0-9._-]+$/.test(n)||/^\.|\.$/.test(n)||/[.\-_]{2,}/.test(n)||/[.\-_](?![a-z0-9])/.test(n))return!1;for(const t of r)if(!o(t))return!1;return!0}const T=async(e,n)=>{try{return await e}catch(r){return n?.(r)}};async function P(e,n){const{errorMessage:r="Timeout",timeoutError:t,timeout:a=15e3}=n||{},u=typeof e=="function"?e():e,f=new Promise((w,c)=>setTimeout(()=>c(t||new Error(r)),a));return Promise.race([u,f])}const A=(e,n,r)=>e.some(i)?r:n(...e);exports.arrayBufferToBase64=g;exports.base64ToUint8Array=h;exports.computeWithDefinedParams=A;exports.encrypt=m;exports.isDomain=o;exports.isEmail=p;exports.isHasUndefined=y;exports.isPromise=d;exports.isUndefined=i;exports.preventTimeout=P;exports.sleep=l;exports.tryCatchAsync=T;exports.uint8ArrayToBase64=s;

package/dist/utils.d.ts

@@ -86,6 +86,7 @@ export declare const tryCatchAsync: <T, F extends ((error: unknown) => any) | un
  */
 export declare function preventTimeout<R>(callback: (() => Promise<R>) | Promise<R>, options?: {
     errorMessage?: string;
+    timeoutError?: any;
     timeout?: number;
 }): Promise<R>;
 export type ParamsWithMaybeUndefined<T extends readonly unknown[]> = {

package/dist/utils.js

@@ -1,60 +1,62 @@
-const l = (e = 1500) => new Promise((n) => setTimeout(n, e));
-function m(e, n = 4, r = 4, t = "...") {
+const m = (e = 1500) => new Promise((n) => setTimeout(n, e));
+function h(e, n = 4, r = 4, t = "...") {
   return !e || e.length <= n + r ? e : e.slice(0, n) + t + (r ? e.slice(-r) : "");
 }
-const s = (e) => e === void 0, h = (...e) => e.some(s), y = (e) => !!e && typeof e?.then == "function" && typeof e?.catch == "function";
-function a(e) {
+const o = (e) => e === void 0, y = (...e) => e.some(o), d = (e) => !!e && typeof e?.then == "function" && typeof e?.catch == "function";
+function f(e) {
   let n = "";
   for (let r = 0; r < e.length; r++)
     n += String.fromCharCode(e[r]);
   return btoa(n);
 }
-function d(e) {
+function g(e) {
   const n = atob(e), r = new Uint8Array(n.length);
   for (let t = 0; t < n.length; t++)
     r[t] = n.charCodeAt(t);
   return r;
 }
-function g(e) {
-  return a(new Uint8Array(e));
+function p(e) {
+  return f(new Uint8Array(e));
 }
-function f(e) {
+function c(e) {
   if (typeof e != "string" || (e = e.toLowerCase(), !/^[0-9a-z.\-]+$/.test(e)) || e.includes("--") || e.includes("-.") || e.includes(".-") || e.startsWith("-") || e.endsWith("-"))
     return !1;
   const n = e.split(".");
   return !(n.length < 2 || n.some((r) => !r.length) || n[n.length - 1].length < 2);
 }
-function p(e) {
+function w(e) {
   const [n, ...r] = e.toLowerCase().split("@");
   if (!n || !r.length || !/^[a-z0-9._-]+$/.test(n) || /^\.|\.$/.test(n) || /[.\-_]{2,}/.test(n) || /[.\-_](?![a-z0-9])/.test(n)) return !1;
   for (const t of r)
-    if (!f(t)) return !1;
+    if (!c(t)) return !1;
   return !0;
 }
-const w = async (e, n) => {
+const P = async (e, n) => {
   try {
     return await e;
   } catch (r) {
     return n?.(r);
   }
 };
-async function P(e, n) {
-  const { errorMessage: r = "Timeout", timeout: t = 15e3 } = n || {}, o = typeof e == "function" ? e() : e, i = new Promise((c, u) => setTimeout(() => u(new Error(r)), t));
-  return Promise.race([o, i]);
+async function T(e, n) {
+  const { errorMessage: r = "Timeout", timeoutError: t, timeout: s = 15e3 } = n || {}, i = typeof e == "function" ? e() : e, u = new Promise(
+    (l, a) => setTimeout(() => a(t || new Error(r)), s)
+  );
+  return Promise.race([i, u]);
 }
-const T = (e, n, r) => e.some(s) ? r : n(...e);
+const A = (e, n, r) => e.some(o) ? r : n(...e);
 export {
-  g as arrayBufferToBase64,
-  d as base64ToUint8Array,
-  T as computeWithDefinedParams,
-  m as encrypt,
-  f as isDomain,
-  p as isEmail,
-  h as isHasUndefined,
-  y as isPromise,
-  s as isUndefined,
-  P as preventTimeout,
-  l as sleep,
-  w as tryCatchAsync,
-  a as uint8ArrayToBase64
+  p as arrayBufferToBase64,
+  g as base64ToUint8Array,
+  A as computeWithDefinedParams,
+  h as encrypt,
+  c as isDomain,
+  w as isEmail,
+  y as isHasUndefined,
+  d as isPromise,
+  o as isUndefined,
+  T as preventTimeout,
+  m as sleep,
+  P as tryCatchAsync,
+  f as uint8ArrayToBase64
 };

package/dist/vue/index.d.ts

@@ -0,0 +1,2 @@
+export { default as useCatchError } from "./useCatchError";
+export { default as useLoadingEvent } from "./useLoadingEvent";

package/dist/vue/useCatchError.d.ts

@@ -0,0 +1,8 @@
+declare const useCatchError: <Args extends any[], R, IsThrowError extends boolean = false>(execute: (...args: Args) => MaybePromise<R>, options?: Partial<{
+    target: string;
+    timeout: number;
+    timeoutError: any;
+    isThrowError: IsThrowError;
+    onError: (error: unknown, target: MaybeUndefined<string>, ...args: Args) => any;
+}>) => (...args: Args) => Promise<IsThrowError extends true ? R : MaybeUndefined<R>>;
+export default useCatchError;

package/dist/vue/useLoadingEvent.d.ts

@@ -0,0 +1,5 @@
+import { type ComputedRef } from "vue";
+declare const useLoadingEvent: <Args extends any[], R extends any>(execute: (...args: Args) => Promise<R>, options?: Partial<{
+    isAllowMulticall: boolean;
+}>) => [(...args: Args) => Promise<R>, ComputedRef<boolean>];
+export default useLoadingEvent;

package/dist/vue.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./utils.cjs"),s=require("vue"),c=(i,e)=>{const u=e?.timeout??2e4,r={timeout:u,timeoutError:e?.timeoutError?e?.timeoutError:new Error(`${e?.target?`${e?.target} `:""}Timeout of ${u}ms exceeded`),isThrowError:e?.isThrowError??!1,...e};return(async(...o)=>{try{return await n.preventTimeout(Promise.resolve(i(...o)),{timeout:r.timeout,timeoutError:r.timeoutError})}catch(t){if(r.onError?.(t,r.target,...o),r.isThrowError)throw t;return}})},m=(i,e)=>{const u={isAllowMulticall:!1,...e},r=s.ref(!1);let o=0,t;return[async(...l)=>{if(r.value&&t&&!u.isAllowMulticall)return t;r.value=!0;const a=o+=1;return t=i(...l).finally(()=>{a===o&&(t=void 0,r.value=!1)}),t},s.computed(()=>r.value)]};exports.useCatchError=c;exports.useLoadingEvent=m;

package/dist/vue.js

@@ -0,0 +1,47 @@
+import { preventTimeout as a } from "./utils.js";
+import { ref as m, computed as c } from "vue";
+const v = (u, e) => {
+  const i = e?.timeout ?? 2e4, r = {
+    timeout: i,
+    timeoutError: e?.timeoutError ? e?.timeoutError : new Error(`${e?.target ? `${e?.target} ` : ""}Timeout of ${i}ms exceeded`),
+    isThrowError: e?.isThrowError ?? !1,
+    ...e
+  };
+  return (async (...o) => {
+    try {
+      return await a(Promise.resolve(u(...o)), {
+        timeout: r.timeout,
+        timeoutError: r.timeoutError
+      });
+    } catch (t) {
+      if (r.onError?.(t, r.target, ...o), r.isThrowError)
+        throw t;
+      return;
+    }
+  });
+}, d = (u, e) => {
+  const i = {
+    /**
+     * 是否允许函数多次调用，默认: false
+     * false 情况下，如果再次执行 execute 会引用上一次的 promise 直接返回
+     */
+    isAllowMulticall: !1,
+    ...e
+  }, r = m(!1);
+  let o = 0, t;
+  return [
+    async (...s) => {
+      if (r.value && t && !i.isAllowMulticall) return t;
+      r.value = !0;
+      const l = o += 1;
+      return t = u(...s).finally(() => {
+        l === o && (t = void 0, r.value = !1);
+      }), t;
+    },
+    c(() => r.value)
+  ];
+};
+export {
+  v as useCatchError,
+  d as useLoadingEvent
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zlikemario/helper",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "A utility library with number operations and common helper functions",
   "keywords": [
     "utility",
@@ -32,13 +32,16 @@
   },
   "devDependencies": {
     "@types/node": "^24",
+    "@types/react": "^19",
     "bignumber.js": "^9.3.1",
     "dayjs": "^1.11.18",
     "node": "^24.8.0",
+    "react": "^19.2.3",
     "typescript": "~5.8.3",
     "vite": "^7.1.2",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "vue": "^3.5.27"
   },
   "main": "./dist/number.js",
   "module": "./dist/number.js",
@@ -68,6 +71,16 @@
       "types": "./dist/decorator-old.d.ts",
       "import": "./dist/decorator-old.js",
       "require": "./dist/decorator-old.cjs"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.js",
+      "require": "./dist/vue.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
     }
   },
   "packageManager": "yarn@4.9.4+sha512.7b1cb0b62abba6a537b3a2ce00811a843bea02bcf53138581a6ae5b1bf563f734872bd47de49ce32a9ca9dcaff995aa789577ffb16811da7c603dcf69e73750b",