@zlikemario/helper 0.0.9 → 0.0.11

package/dist/decorator-old.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("./utils.cjs");function m(s=0,i=(...a)=>a[0],c=!1){return function(a,r,o){const d=o.value,e=new Map;let f=Date.now();const g=Symbol(String(r)),h=()=>s>0&&f<Date.now();return o.value=function(...l){const n=(typeof i=="function"?i(...l):i)??g;if(!e.get(n)||h()){f=Date.now()+s;const t=d.apply(this,l);t instanceof Promise?(e.set(n,t),t.then(M=>{!c&&u.isUndefined(M)&&e.delete(n)})):(c||!u.isUndefined(t))&&e.set(n,t)}return e.get(n)},o}}exports.Memoize=m;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./utils.cjs");function x(l=0,u=(...h)=>h[0],a=!1){return function(h,y,o){const g=o.value,v=o.get,r=new WeakMap,M=Symbol(String(y)),d=e=>(r.has(e)||r.set(e,new Map),r.get(e)),p=e=>l>0&&e<Date.now(),m=(...e)=>(typeof u=="function"?u(...e):u)??M;return typeof g=="function"&&(o.value=function(...e){const t=d(this),n=m(...e),c=t.get(n);if(!c||p(c.expireTime)){const i=Date.now()+l,s=g.apply(this,e);s instanceof Promise?(t.set(n,{value:s,expireTime:i}),s.then(w=>{!a&&f.isUndefined(w)&&t.delete(n)})):(a||!f.isUndefined(s))&&t.set(n,{value:s,expireTime:i})}return t.get(n)?.value}),typeof v=="function"&&(o.get=function(){const e=d(this),t=m(),n=e.get(t);if(!n||p(n.expireTime)){const c=Date.now()+l,i=v.apply(this);i instanceof Promise?(e.set(t,{value:i,expireTime:c}),i.then(s=>{!a&&f.isUndefined(s)&&e.delete(t)})):(a||!f.isUndefined(i))&&e.set(t,{value:i,expireTime:c})}return e.get(t)?.value}),o}}exports.Memoize=x;

package/dist/decorator-old.d.ts

@@ -1 +1 @@
-export declare function Memoize<Args extends any[]>(duration?: number, computeKey?: ((...args: Args) => PropertyKey) | PropertyKey, isCacheVoid?: boolean): <T>(_: any, name: string, descriptor: TypedPropertyDescriptor<(...args: Args) => T>) => TypedPropertyDescriptor<(...args: Args) => T>;
+export declare function Memoize<Args extends any[]>(duration?: number, computeKey?: ((...args: Args) => PropertyKey) | PropertyKey, isCacheVoid?: boolean): (_: any, name: string | symbol, descriptor: TypedPropertyDescriptor<any>) => TypedPropertyDescriptor<any>;

package/dist/decorator-old.js

@@ -1,22 +1,28 @@
-import { isUndefined as r } from "./utils.js";
-function g(f = 0, o = (...c) => c[0], a = !1) {
-  return function(c, u, i) {
-    const h = i.value, e = /* @__PURE__ */ new Map();
-    let s = Date.now();
-    const d = Symbol(String(u)), m = () => f > 0 && s < Date.now();
-    return i.value = function(...l) {
-      const n = (typeof o == "function" ? o(...l) : o) ?? d;
-      if (!e.get(n) || m()) {
-        s = Date.now() + f;
-        const t = h.apply(this, l);
-        t instanceof Promise ? (e.set(n, t), t.then((w) => {
-          !a && r(w) && e.delete(n);
-        })) : (a || !r(t)) && e.set(n, t);
+import { isUndefined as f } from "./utils.js";
+function T(l = 0, u = (...r) => r[0], a = !1) {
+  return function(r, x, c) {
+    const p = c.value, g = c.get, h = /* @__PURE__ */ new WeakMap(), w = Symbol(String(x)), v = (e) => (h.has(e) || h.set(e, /* @__PURE__ */ new Map()), h.get(e)), m = (e) => l > 0 && e < Date.now(), y = (...e) => (typeof u == "function" ? u(...e) : u) ?? w;
+    return typeof p == "function" && (c.value = function(...e) {
+      const t = v(this), n = y(...e), s = t.get(n);
+      if (!s || m(s.expireTime)) {
+        const i = Date.now() + l, o = p.apply(this, e);
+        o instanceof Promise ? (t.set(n, { value: o, expireTime: i }), o.then((D) => {
+          !a && f(D) && t.delete(n);
+        })) : (a || !f(o)) && t.set(n, { value: o, expireTime: i });
       }
-      return e.get(n);
-    }, i;
+      return t.get(n)?.value;
+    }), typeof g == "function" && (c.get = function() {
+      const e = v(this), t = y(), n = e.get(t);
+      if (!n || m(n.expireTime)) {
+        const s = Date.now() + l, i = g.apply(this);
+        i instanceof Promise ? (e.set(t, { value: i, expireTime: s }), i.then((o) => {
+          !a && f(o) && e.delete(t);
+        })) : (a || !f(i)) && e.set(t, { value: i, expireTime: s });
+      }
+      return e.get(t)?.value;
+    }), c;
   };
 }
 export {
-  g as Memoize
+  T as Memoize
 };

package/dist/decorator.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./utils.cjs");function p(c=0,i=(...o)=>o[0],s=!1){return function(o,l){const e=new Map;let f=Date.now();const d=Symbol(String(l.name)),u=()=>c>0&&f<Date.now();function m(...r){const t=(typeof i=="function"?i(...r):i)??d;if(!e.get(t)||u()){f=Date.now()+c;const n=o.apply(this,r);n instanceof Promise?(e.set(t,n),n.then(h=>{!s&&a.isUndefined(h)&&e.delete(t)})):(s||!a.isUndefined(n))&&e.set(t,n)}return e.get(t)}return m}}exports.Memoize=p;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./utils.cjs");function v(o=0,s=(...c)=>c[0],r=!1){return function(c,f){const h=Symbol(String(f.name)),p=e=>o>0&&e<Date.now(),m=new Map,a=new WeakMap,M=e=>(a.has(e)||a.set(e,new Map),a.get(e));function g(...e){const t=(typeof s=="function"?s(...e):s)??h,n=f.static?m:M(this),l=n.get(t);if(!l||p(l.expireTime)){const u=Date.now()+o,i=c.apply(this,e);i instanceof Promise?(n.set(t,{value:i,expireTime:u}),i.then(S=>{!r&&d.isUndefined(S)&&n.delete(t)})):(r||!d.isUndefined(i))&&n.set(t,{value:i,expireTime:u})}return n.get(t)?.value}return g}}exports.Memoize=v;

package/dist/decorator.js

@@ -1,23 +1,20 @@
-import { isUndefined as r } from "./utils.js";
-function w(c = 0, o = (...i) => i[0], f = !1) {
-  return function(i, l) {
-    const e = /* @__PURE__ */ new Map();
-    let s = Date.now();
-    const d = Symbol(String(l.name)), m = () => c > 0 && s < Date.now();
-    function p(...a) {
-      const t = (typeof o == "function" ? o(...a) : o) ?? d;
-      if (!e.get(t) || m()) {
-        s = Date.now() + c;
-        const n = i.apply(this, a);
-        n instanceof Promise ? (e.set(t, n), n.then((h) => {
-          !f && r(h) && e.delete(t);
-        })) : (f || !r(n)) && e.set(t, n);
+import { isUndefined as l } from "./utils.js";
+function S(o = 0, c = (...i) => i[0], r = !1) {
+  return function(i, f) {
+    const u = Symbol(String(f.name)), d = (e) => o > 0 && e < Date.now(), m = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new WeakMap(), w = (e) => (s.has(e) || s.set(e, /* @__PURE__ */ new Map()), s.get(e));
+    function M(...e) {
+      const t = (typeof c == "function" ? c(...e) : c) ?? u, n = f.static ? m : w(this), h = n.get(t);
+      if (!h || d(h.expireTime)) {
+        const p = Date.now() + o, a = i.apply(this, e);
+        a instanceof Promise ? (n.set(t, { value: a, expireTime: p }), a.then((g) => {
+          !r && l(g) && n.delete(t);
+        })) : (r || !l(a)) && n.set(t, { value: a, expireTime: p });
       }
-      return e.get(t);
+      return n.get(t)?.value;
     }
-    return p;
+    return M;
   };
 }
 export {
-  w as Memoize
+  S as Memoize
 };

package/dist/number.d.ts

@@ -52,7 +52,7 @@ export declare const readableNumber: (number: Numberish, decimals?: number) => s
  * @param data - 数字数组
  * @returns 求和结果字符串
  */
-export declare const sum: (data: Array<Numberish>) => string;
+export declare const sum: (data: Array<Numberish>) => NumberString;
 /**
  * 按 key 或函数求和
  * @param data - 对象数组

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",duration: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 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;

package/dist/utils.d.ts

@@ -1,92 +1,92 @@
 /**
- * Utility functions for common operations.
+ * 常用操作的工具函数集合
  */
 /**
- * Sleep for a specified interval (ms).
- * @param interval - Time in milliseconds to sleep. Default: 1500ms.
+ * 延迟指定的时间间隔（毫秒）
+ * @param interval - 延迟的毫秒数，默认 1500ms
  */
 export declare const sleep: (interval?: number) => Promise<void>;
 /**
- * Encrypts a string by masking the middle part.
- * @param text - The input string.
- * @param prefix - Number of characters to keep at the start.
- * @param suffix - Number of characters to keep at the end.
- * @param placeholder - Masking string. Default: '...'.
- * @returns Masked string.
+ * 通过遮罩中间部分来加密字符串
+ * @param text - 输入字符串
+ * @param prefix - 开头保留的字符数
+ * @param suffix - 结尾保留的字符数
+ * @param placeholder - 遮罩字符串，默认 '...'
+ * @returns 遮罩后的字符串
  */
 export declare function encrypt(text: string, prefix?: number, suffix?: number, placeholder?: string): string;
 /**
- * Checks if a value is undefined.
- * @param v - Value to check.
+ * 检查值是否为 undefined
+ * @param v - 要检查的值
  */
 export declare const isUndefined: (v: unknown) => v is undefined;
 /**
- * Checks if any of the provided values are undefined.
- * @param vs - Values to check.
+ * 检查提供的值中是否有任何一个为 undefined
+ * @param vs - 要检查的值
  */
 export declare const isHasUndefined: (...vs: unknown[]) => boolean;
 /**
- * Checks if a value is a Promise.
- * @param v - Value to check.
+ * 检查值是否为 Promise
+ * @param v - 要检查的值
  */
 export declare const isPromise: <T = any>(v: unknown) => v is Promise<T>;
 /**
- * Converts a Uint8Array to a Base64 string.
- * @param array - Uint8Array to convert.
+ * 将 Uint8Array 转换为 Base64 字符串
+ * @param array - 要转换的 Uint8Array
  */
 export declare function uint8ArrayToBase64(array: Uint8Array): string;
 /**
- * Converts a Base64 string to a Uint8Array.
- * @param base64 - Base64 string to convert.
+ * 将 Base64 字符串转换为 Uint8Array
+ * @param base64 - 要转换的 Base64 字符串
  */
 export declare function base64ToUint8Array(base64: string): Uint8Array;
 /**
- * Converts an ArrayBuffer to a Base64 string.
- * @param buffer - ArrayBuffer to convert.
+ * 将 ArrayBuffer 转换为 Base64 字符串
+ * @param buffer - 要转换的 ArrayBuffer
  */
 export declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
 /**
- * Validates a domain name.
- * Rules:
- * 1. Only numbers, letters, and hyphens allowed.
- * 2. Composed of one or more parts separated by dots.
- * 3. Last part must be at least two characters.
- * 4. Cannot start or end with a hyphen.
- * 5. No consecutive hyphens or hyphen-dot/dot-hyphen.
- * @param text - Domain string to validate.
+ * 验证域名
+ * 规则：
+ * 1. 只允许数字、字母和连字符
+ * 2. 由一个或多个用点分隔的部分组成
+ * 3. 最后一部分必须至少有两个字符
+ * 4. 不能以连字符开头或结尾
+ * 5. 不能有连续的连字符或连字符-点/点-连字符
+ * @param text - 要验证的域名字符串
  */
 export declare function isDomain(text: string): boolean;
 /**
- * Validates an email address.
- * Rules:
- * 1. Account part: letters, numbers, _, -, . allowed.
- * 2. No leading/trailing dot.
- * 3. No consecutive special characters.
- * 4. Special character must be followed by at least one letter/number.
- * 5. Domain part must be valid.
- * @param text - Email string to validate.
+ * 验证电子邮件地址
+ * 规则：
+ * 1. 账户部分：允许字母、数字、_、-、.
+ * 2. 不能以点开头或结尾
+ * 3. 不能有连续的特殊字符
+ * 4. 特殊字符后必须至少跟一个字母或数字
+ * 5. 域名部分必须有效
+ * @param text - 要验证的电子邮件字符串
  */
 export declare function isEmail(text: string): boolean;
 /**
- * Async try-catch wrapper.
- * @param p - Promise to execute.
- * @param catchFn - Optional error handler.
+ * 异步 try-catch 包装器
+ * @param p - 要执行的 Promise
+ * @param catchFn - 可选的错误处理函数
  */
 export declare const tryCatchAsync: <T, F extends ((error: unknown) => any) | undefined = undefined>(p: Promise<T>, catchFn?: F) => Promise<T | (F extends (...args: any) => any ? ReturnType<F> : undefined)>;
 /**
- * Executes a callback or promise and ensures it completes within a specified timeout duration.
- * If the operation does not finish in time, the returned promise is rejected with a timeout error.
+ * 执行回调函数或 Promise，并确保在指定的超时时间内完成
+ * 如果操作未能及时完成，返回的 Promise 将以超时错误被拒绝
  *
- * @template R The type of the resolved value.
- * @param callback - A function returning a promise or a promise to execute.
- * @param options - Optional settings for timeout behavior.
- * @param options.errorMessage - Custom error message for timeout rejection. Defaults to "Timeout".
- * @param options.duration - Timeout duration in milliseconds. Defaults to 15000 ms.
- * @returns A promise that resolves with the result of the callback or rejects if the timeout is reached.
+ * @template R 解析值的类型
+ * @param callback - 返回 Promise 的函数或要执行的 Promise
+ * @param options - 超时行为的可选设置
+ * @param options.errorMessage - 超时拒绝的自定义错误消息，默认为 "Timeout"
+ * @param options.duration - 超时时间（毫秒），默认为 15000 ms
+ * @returns 一个 Promise，解析为回调的结果或在达到超时时拒绝
  */
 export declare function preventTimeout<R>(callback: (() => Promise<R>) | Promise<R>, options?: {
     errorMessage?: string;
-    duration?: number;
+    timeout?: number;
 }): Promise<R>;
 export type ParamsWithMaybeUndefined<T extends readonly unknown[]> = {
     [K in keyof T]: T[K] | undefined;

package/dist/utils.js

@@ -3,7 +3,7 @@ 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 s = (e) => e === void 0, h = (...e) => e.some(s), y = (e) => !!e && typeof e?.then == "function" && typeof e?.catch == "function";
-function u(e) {
+function a(e) {
   let n = "";
   for (let r = 0; r < e.length; r++)
     n += String.fromCharCode(e[r]);
@@ -16,7 +16,7 @@ function d(e) {
   return r;
 }
 function g(e) {
-  return u(new Uint8Array(e));
+  return a(new Uint8Array(e));
 }
 function f(e) {
   if (typeof e != "string" || (e = e.toLowerCase(), !/^[0-9a-z.\-]+$/.test(e)) || e.includes("--") || e.includes("-.") || e.includes(".-") || e.startsWith("-") || e.endsWith("-"))
@@ -39,7 +39,7 @@ const w = async (e, n) => {
   }
 };
 async function P(e, n) {
-  const { errorMessage: r = "Timeout", duration: t = 15e3 } = n || {}, o = typeof e == "function" ? e() : e, i = new Promise((c, a) => setTimeout(() => a(new Error(r)), t));
+  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]);
 }
 const T = (e, n, r) => e.some(s) ? r : n(...e);
@@ -56,5 +56,5 @@ export {
   P as preventTimeout,
   l as sleep,
   w as tryCatchAsync,
-  u as uint8ArrayToBase64
+  a as uint8ArrayToBase64
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zlikemario/helper",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "A utility library with number operations and common helper functions",
   "keywords": [
     "utility",
@@ -75,4 +75,4 @@
     "bignumber.js": "*",
     "dayjs": "*"
   }
-}
+}