@lntvow/utils 5.0.4 → 5.1.1

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var we=Object.create;var Y=Object.defineProperty;var Oe=Object.getOwnPropertyDescriptor;var Ae=Object.getOwnPropertyNames;var Se=Object.getPrototypeOf,Re=Object.prototype.hasOwnProperty;var je=(e,t)=>{for(var r in t)Y(e,r,{get:t[r],enumerable:!0})},ae=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of Ae(t))!Re.call(e,i)&&i!==r&&Y(e,i,{get:()=>t[i],enumerable:!(n=Oe(t,i))||n.enumerable});return e};var B=(e,t,r)=>(r=e!=null?we(Se(e)):{},ae(t||!e||!e.__esModule?Y(r,"default",{value:e,enumerable:!0}):r,e)),Te=e=>ae(Y({},"__esModule",{value:!0}),e);var Tt={};je(Tt,{UtilsError:()=>W,base64Decode:()=>$e,base64Encode:()=>Ie,castArray:()=>A,compose:()=>Ce,composeRight:()=>Fe,debounce:()=>We,debugWarn:()=>ve,decimalToBinary:()=>Pe,deepClone:()=>T,deepMerge:()=>Le,generateRandomArray:()=>ut,generateRandomColor:()=>lt,generateRandomDate:()=>oe,generateRandomEmail:()=>Ot,generateRandomFloat:()=>At,generateRandomIdCard:()=>St,generateRandomMobilePhone:()=>Rt,generateRandomStringFromSource:()=>v,getRandomInt:()=>d,getRandomItem:()=>l,getRandomString:()=>h,getRandomUrl:()=>jt,hasChanged:()=>Ne,hasCircularReference:()=>Ge,isArguments:()=>J,isArray:()=>b,isBoolean:()=>U,isDate:()=>H,isDateString:()=>re,isDef:()=>ke,isEmail:()=>at,isEmptyString:()=>st,isFiniteNumber:()=>Me,isFloat:()=>Qe,isFunction:()=>F,isIdCard:()=>mt,isInteger:()=>rt,isMap:()=>z,isMobilePhone:()=>ct,isNegativeFloat:()=>et,isNegativeInteger:()=>ot,isNil:()=>ee,isNonNegativeFloat:()=>Ze,isNonNegativeInteger:()=>te,isNonPositiveFloat:()=>tt,isNonPositiveInteger:()=>it,isNull:()=>De,isNumber:()=>p,isObject:()=>E,isObjectLike:()=>C,isPlainObject:()=>y,isPositiveFloat:()=>Je,isPositiveInteger:()=>nt,isPromise:()=>Z,isRegExp:()=>Q,isSet:()=>G,isString:()=>j,isStringNumber:()=>ft,isSymbol:()=>V,isURL:()=>pt,isUndef:()=>M,isWeakMap:()=>X,isWeakSet:()=>q,log:()=>D,objectToString:()=>se,omit:()=>Xe,pick:()=>qe,qs:()=>pe,throttle:()=>Ke,throwError:()=>m,toTypeString:()=>x,toTypeValue:()=>Ee,withRetry:()=>Ue});module.exports=Te(Tt);function E(e){let t=typeof e;return e!==null&&(t==="object"||t==="function")}function C(e){return e!==null&&typeof e=="object"}var se=Object.prototype.toString,x=e=>se.call(e),Ee=e=>x(e).slice(8,-1),j=e=>typeof e=="string",p=e=>typeof e=="number",Me=e=>typeof e=="number"&&Number.isFinite(e),U=e=>typeof e=="boolean",De=e=>e===null,M=e=>e===void 0,V=e=>typeof e=="symbol",b=Array.isArray,F=e=>typeof e=="function",z=e=>x(e)==="[object Map]",G=e=>x(e)==="[object Set]",X=e=>x(e)==="[object WeakMap]",q=e=>x(e)==="[object WeakSet]",H=e=>x(e)==="[object Date]",Q=e=>x(e)==="[object RegExp]",J=e=>x(e)==="[object Arguments]",Z=e=>C(e)&&F(e?.then)&&F(e?.catch),ee=e=>e==null,ke=e=>e!=null,Ne=(e,t)=>e!==t;function y(e){return x(e)==="[object Object]"}function A(e){return b(e)?e:[e]}function Pe(e){let t=[],r,n="";for(;e>0;)r=Math.floor(e%2),t.push(r),e=Math.floor(e/2);for(;t.length>0;)n+=t.pop().toString();return n}var me="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";function Ie(e){let t="",r="";for(let i=0;i<e.length;i++)r+=e[i].charCodeAt(0).toString(2).padStart(8,"0");for(let i=0;i<r.length;i+=6)t+=me[Number.parseInt(r.slice(i,i+6).padEnd(6,"0"),2)];let n=t.length%4;return n!==0&&(t+="=".repeat(4-n)),t}function $e(e){let t="",r="";for(let n=0;n<e.length&&e[n]!=="=";n++)r+=me.indexOf(e[n]).toString(2).padStart(6,"0");for(let n=0;n<r.length;n+=8){let i=Number.parseInt(r.slice(n,n+8),2);i&&(t+=String.fromCharCode(i))}return t}function Ce(...e){return e.reduce((t,r)=>function(...n){return r(t(...n))})}function Fe(...e){return e.reduce((t,r)=>function(...n){return t(r(...n))})}function We(e,t=500){let r=null;return function(...n){r&&clearTimeout(r),r=setTimeout(()=>{e.apply(this,n)},t)}}function T(e){let t=new WeakMap,r=[{predicate:H,handler:u},{predicate:Q,handler:S},{predicate:z,handler:ye},{predicate:G,handler:he},{predicate:Z,handler:g},{predicate:X,handler:N},{predicate:q,handler:w},{predicate:o=>o instanceof Boolean||o instanceof Number||o instanceof String,handler:P},{predicate:o=>o instanceof Error,handler:R},{predicate:o=>typeof Node<"u"&&o instanceof Node,handler:O},{predicate:J,handler:L},{predicate:o=>o instanceof ArrayBuffer,handler:K},{predicate:o=>o instanceof DataView,handler:be},{predicate:o=>ArrayBuffer.isView(o),handler:xe}];function n(o){if(!C(o))return o;if(t.has(o))return t.get(o);for(let f of r)if(f.predicate(o))return f.handler(o);let s=b(o)?Object.setPrototypeOf([],Object.getPrototypeOf(o)):Object.create(Object.getPrototypeOf(o));return t.set(o,s),c(o,s),s}function i(o,s){let f=Object.getOwnPropertyDescriptors(o);for(let I of Reflect.ownKeys(f)){let $=f[I];$.get||$.set?Object.defineProperty(s,I,$):Object.defineProperty(s,I,{...$,value:n($.value)})}}function c(o,s){i(o,s),_e(o,s)}function u(o){let s=new Date(o);return t.set(o,s),c(o,s),s}function S(o){let s=new RegExp(o.source,o.flags);return s.lastIndex=o.lastIndex,t.set(o,s),c(o,s),s}function g(o){return o}function N(){return new WeakMap}function w(){return new WeakSet}function P(o){let s=o.valueOf(),f=new Object(s);return t.set(o,f),i(o,f),f}function R(o){let s=new o.constructor(o.message);return t.set(o,s),i(o,s),s}function O(o){return{}}function L(o){let s=Object.create(Object.getPrototypeOf(o));return t.set(o,s),c(o,s),s}function K(o){let s=new o.constructor(o.byteLength);return new Uint8Array(s).set(new Uint8Array(o)),t.set(o,s),s}function be(o){let s=n(o.buffer),f=new DataView(s,o.byteOffset,o.byteLength);return t.set(o,f),f}function xe(o){let s=new o.constructor(o);return t.set(o,s),s}function ye(o){let s=new Map;return t.set(o,s),o.forEach((f,I)=>s.set(n(I),n(f))),c(o,s),s}function he(o){let s=new Set;return t.set(o,s),o.forEach(f=>s.add(n(f))),c(o,s),s}return n(e)}function _e(e,t){Object.isFrozen(e)?Object.freeze(t):Object.isSealed(e)?Object.seal(t):Object.isExtensible(e)||Object.preventExtensions(t)}function Le(e,t,r={}){return fe(ce(e,r),ce(t,r),r)}function fe(e,t,r){return b(e)?Be(e,t,r):Ye(e,t,r)}function Ye(e,t,r){if(!y(t))return t;let n=Object.getOwnPropertyDescriptors(t);return Reflect.ownKeys(t).forEach(i=>{(y(e[i])||b(e[i]))&&(y(t[i])||b(t[i]))?e[i]=fe(e[i],t[i],r):Object.defineProperty(e,i,n[i])}),e}function Be(e,t,r){let{mergeStrategy:n="replace"}=r;if(b(t))switch(n){case"merge":return e.concat(t);case"replace":return t;default:return t}return t}function ce(e,t){let{deepClone:r=!0}=t;return r?T(e):e}var W=class extends Error{constructor(t,r="Utils"){super(t),this.name=r}};function m(e,t){throw new W(`[${e}] ${t}`)}function ve(e,t){let r=j(e)?new W(`[${e}] ${t}`,"UtilsWarn"):e;console.warn(r)}var _=(e,t,...r)=>{if(!t)return;let n=r.length===0?"":r.length===1?r[0]:r;console[e](`[Log] ${t}${r.length===0?"":":"}`,n)},D=(e,...t)=>{_("info",e,...t)};D.info=(e,...t)=>{_("info",e,...t)};D.warn=(e,...t)=>{_("warn",e,...t)};D.error=(e,...t)=>{_("error",e,...t)};typeof globalThis<"u"&&(globalThis.lntvowSetLogImpl=e=>_=e);var pe={stringify:e=>(E(e)||m("stringify","Input must be an object"),new URLSearchParams(e).toString()),parse:e=>(j(e)||m("parse","Input must be a string"),Object.fromEntries(new URLSearchParams(e).entries())),appendQueryString:(e,t)=>{let r=pe.stringify(t);return e.includes("?")?e.endsWith("?")||e.endsWith("&")?`${e}${r}`:`${e}&${r}`:`${e}?${r}`}};function Ke(e,t=500){let r=null;return function(...n){if(ee(r))return r=Date.now(),e.apply(this,n);let i=Date.now();if(i-r>=t)return r=i,e.apply(this,n)}}function Ue(e){Ve(e);let{fn:t,maxAttempts:r=3,retryDelay:n=1e3,enableExponentialBackoff:i=!1,signal:c}=e,u,S=c?new Promise((N,w)=>{let P=()=>w(ue());c.addEventListener("abort",P),u=()=>c.removeEventListener("abort",P)}):null;return new Promise((N,w)=>{(async()=>{for(let R=1;R<=r;R++){if(c?.aborted)return w(ue());try{let O=await Promise.race(S?[t(),S]:[t()]);return N(O)}catch(O){let L=i?n*2**(R-1):n;if(D("withRetry",`Attempt ${R}/${r} failed. Retrying in ${L}ms...`),O instanceof Error&&O.name==="AbortError"||R===r)return w(O);await new Promise(K=>setTimeout(K,L))}}})()}).finally(()=>u?.())}function Ve(e){y(e)||m("withRetry",'"Options" must be an object'),typeof e.fn!="function"&&m("withRetry",'"fn" must be a function that returns a Promise'),!M(e.maxAttempts)&&(!Number.isInteger(e.maxAttempts)||e.maxAttempts<1)&&m("withRetry",'"maxAttempts" must be a positive integer'),!M(e.retryDelay)&&(!p(e.retryDelay)||e.retryDelay<0)&&m("withRetry",'"retryDelay" must be a non-negative number'),!M(e.enableExponentialBackoff)&&!U(e.enableExponentialBackoff)&&m("withRetry",'"enableExponentialBackoff" must be a boolean'),!M(e.signal)&&typeof e.signal!="object"&&m("withRetry",'"signal" must be an AbortSignal')}var ze="The operation was aborted";function ue(e=ze){let t=new Error(e);return t.name="AbortError",t}function Ge(e){E(e)||m("hasCircularReference",'"obj" must be a object');let t=new Set;function r(n){if(E(n)){if(t.has(n))return!0;t.add(n);for(let i of Object.keys(n))if(r(n[i]))return!0;t.delete(n)}return!1}return r(e)}function Xe(e,t){if(!y(e))return{};let r=T(e),n=A(t);for(let i of n)Reflect.deleteProperty(r,i);return r}function qe(e,t,r={}){let{includeProto:n=!1,includeSymbols:i=!0,includeNonEnum:c=!1}=r,u={};return y(e)&&A(t).forEach(g=>{V(g)&&!i||!(n?g in e:Object.hasOwn(e,g))||!c&&(n?He(e,g):Object.getOwnPropertyDescriptor(e,g))?.enumerable===!1||(u[g]=T(e[g]))}),u}function He(e,t){let r=e;for(;r!==null;){let n=Object.getOwnPropertyDescriptor(r,t);if(n)return n;r=Object.getPrototypeOf(r)}}function Qe(e){return/^-?(?:0|[1-9]\d*)\.\d+$/.test(e)}function Je(e){return/^(?:0\.0*[1-9]\d*|[1-9]\d*\.\d+)$/.test(e)}function Ze(e){return/^(?:0|[1-9]\d*)\.\d+$/.test(e)}function et(e){return/^-(?:0\.0*[1-9]\d*|[1-9]\d*\.\d+)$/.test(e)}function tt(e){return/^-(?:0|[1-9]\d*)\.\d+$/.test(e)}function rt(e){return/^-?(?:0|[1-9]\d*)$/.test(e)}function nt(e){return/^[1-9]\d*$/.test(e)}function te(e){return/^(?:0|[1-9]\d*)$/.test(e)&&!Object.is(e,-0)}function ot(e){return/^-[1-9]\d*$/.test(e)}function it(e){return/^-(?:0|[1-9]\d*)$/.test(e)||Object.is(e,-0)}var le=B(require("dayjs"),1);function re(e,t="YYYY-MM-DD HH:mm:ss"){return(0,le.default)(e,t,!0).isValid()}function at(e){return/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(e)}function st(e){return e===""}var ne=B(require("dayjs"),1);function mt(e){if(!/^[1-9]\d{5}(?:18|19|20)\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])\d{3}[\dX]$/i.test(e))return!1;let r=e.slice(6,14);return re(r,"YYYYMMDD")&&(0,ne.default)(r,"YYYYMMDD").isBefore((0,ne.default)())}function ct(e){return/^1[3-9]\d{9}$/.test(e)}var ft=e=>{if(!j(e)||!/^-?\d+(?:\.\d+)?$/.test(e))return!1;let r=Number(e);return!(r>Number.MAX_SAFE_INTEGER||r<Number.MIN_SAFE_INTEGER)};function pt(e){return/^https?:\/\/\S+$/i.test(e)}function ut(e,t){return(!p(e)||!te(e.toString()))&&m("generateRandomArray","num must be greater than 0"),F(t)||m("generateRandomArray","cb must be a function"),Array.from({length:e},()=>t())}function lt(){return`#${Math.floor(Math.random()*16777215).toString(16).padStart(6,"0")}`}var k=B(require("dayjs"),1),ge=B(require("dayjs/plugin/customParseFormat.js"),1);function l(e){return e[Math.floor(Math.random()*e.length)]}function d(e={}){p(e)&&(e={max:e});let{min:t=1,max:r=l(gt())}=e;dt(t,r);let n=Math.ceil(t),i=Math.floor(r);return Math.floor(Math.random()*(i-n+1)+n)}function dt(e,t){let r=Math.ceil(e),n=Math.floor(t);Number.isSafeInteger(r)||m("getRandomInt",`The minimum value Math.ceil(${e}) should be a safe integer`),Number.isSafeInteger(n)||m("getRandomInt",`The maximum value Math.floor(${t}) should be a safe integer`),n<r&&(t>=e&&m("getRandomInt",`No integer value found between ${e} and ${t}`),m("getRandomInt",`The maximum value ${t} should be greater than the minimum value ${e}`))}function gt(){return Array.from({length:Number.MAX_SAFE_INTEGER.toString().length}).map((e,t)=>{let r=Number.MAX_SAFE_INTEGER.toString().slice(0,t+1);return Number(r)})}k.default.extend(ge.default);function oe(e={}){let{start:t="1800-01-01 00:00:00",end:r=(0,k.default)().format(de),format:n=de}=e,i=(0,k.default)(t),c=(0,k.default)(r);(!i.isValid()||!c.isValid())&&m("generateRandomDate","start and end parameters must be valid date format"),i.isAfter(c)&&m("generateRandomDate","start date must be before end date");let u=i.valueOf(),S=c.valueOf(),g=d({min:u,max:S});return(0,k.default)(g).format(n)}var de="YYYY-MM-DD HH:mm:ss";function h(e={}){let t=xt(e),r=yt(t);ht(r);let{length:n}=t;wt(n.min,n.max);let i=d(n),c=t.prefix||"";for(let u=0;u<i;u++)c+=r.charAt(Math.floor(Math.random()*r.length));return c+(t.suffix||"")}var bt=16,ie=1;function xt(e){let t=p(e);return{lowerCase:!0,upperCase:!0,number:!0,...t?{}:e,length:t?{max:e,min:e}:p(e.length)?{max:e.length,min:e.length}:{max:bt,min:ie,...e.length},extra:t?[]:[...new Set(A(e.extra||[]))]}}function yt(e){let t="";return e.lowerCase&&(t+="abcdefghijklmnopqrstuvwxyz"),e.upperCase&&(t+="ABCDEFGHIJKLMNOPQRSTUVWXYZ"),e.number&&(t+="0123456789"),t+=A(e.extra).join(""),t}function ht(e){e.length===0&&m("getRandomString","At least one character set (lowercase, uppercase, number) must be enabled or extra characters provided")}function wt(e,t){Number.isInteger(e)||m("getRandomString","min must be an integer"),Number.isInteger(t)||m("getRandomString","max must be an integer"),e<ie&&m("getRandomString",`Minimum length cannot be less than ${ie}`),t<e&&m("getRandomString","Maximum length cannot be less than minimum length")}function Ot(){let e=["gmail.com","outlook.com","yahoo.com","qq.com","163.com","hotmail.com"],t=d({min:5,max:10}),r=h({length:t,lowerCase:!0,upperCase:!1,number:!0}),n=l(e);return`${r}@${n}`}function At(e={}){p(e)&&(e={max:e});let{min:t=0,max:r=1,fractionDigits:n=2}=e;if((!p(t)||!p(r))&&m("generateRandomFloat",'"min" and "max" must be numbers'),(!Number.isInteger(n)||n<0)&&m("generateRandomFloat",'"fractionDigits" must be a non-negative integer'),t===r)return Number(t.toFixed(n));t>r&&m("generateRandomFloat",`"max" (${r}) must be greater than "min" (${t})`);let i=Math.random()*(r-t)+t;return Number(i.toFixed(n))}function v(e,t){(!p(e)||e<=0)&&m("generateRandomStringFromSource",'"num" must be greater than 0'),(!b(t)||t.length===0)&&m("generateRandomStringFromSource",'"source" must be a non-empty array');let r="";for(let n=0;n<e;n++)r+=l(t);return r}function St(){let e=d({min:1e5,max:999999}),t=[0,1,2,3,4,5,6,7,8,9];return[e,oe({format:"YYYYMMDD"}),v(3,t),v(1,[...t,"X","x"])].join("")}function Rt(){return l(["13","14","15","16","17","18","19"])+d(999999999).toString().padEnd(9,"0")}function jt(){let e=["http://","https://"],t=[".com",".net",".org",".cn",".top"],r=[`?name=${h({length:{min:4,max:8}})}`,`?id=${d()}`,`?page=${h({length:{min:2,max:4}})}`,`?query=${h({length:{min:5,max:6}})}`,`?search=${h({length:{min:1,max:4}})}`,`?token=${h({length:{min:16,max:16}})}`];return`${l(e)}${h({length:{min:5,max:25}})}${l(t)}${l(r)}`}0&&(module.exports={UtilsError,base64Decode,base64Encode,castArray,compose,composeRight,debounce,debugWarn,decimalToBinary,deepClone,deepMerge,generateRandomArray,generateRandomColor,generateRandomDate,generateRandomEmail,generateRandomFloat,generateRandomIdCard,generateRandomMobilePhone,generateRandomStringFromSource,getRandomInt,getRandomItem,getRandomString,getRandomUrl,hasChanged,hasCircularReference,isArguments,isArray,isBoolean,isDate,isDateString,isDef,isEmail,isEmptyString,isFiniteNumber,isFloat,isFunction,isIdCard,isInteger,isMap,isMobilePhone,isNegativeFloat,isNegativeInteger,isNil,isNonNegativeFloat,isNonNegativeInteger,isNonPositiveFloat,isNonPositiveInteger,isNull,isNumber,isObject,isObjectLike,isPlainObject,isPositiveFloat,isPositiveInteger,isPromise,isRegExp,isSet,isString,isStringNumber,isSymbol,isURL,isUndef,isWeakMap,isWeakSet,log,objectToString,omit,pick,qs,throttle,throwError,toTypeString,toTypeValue,withRetry});
+/* v8 ignore if  -- @preserve */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lntvow/utils",
-  "version": "5.0.4",
+  "version": "5.1.1",
   "type": "module",
   "description": "TypeScript utilities",
   "keywords": [
@@ -15,39 +15,41 @@
     "dist"
   ],
   "types": "dist/index.d.ts",
-  "main": "dist/index.js",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
   "unpkg": "dist/index.global.js",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.cjs"
     }
   },
   "dependencies": {
-    "dayjs": "^1.11.19"
+    "dayjs": "^1.11.20"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.4.2",
-    "@commitlint/config-conventional": "^20.4.2",
-    "@lntvow/eslint-config": "^10.1.1",
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@lntvow/eslint-config": "^10.1.5",
     "@types/node": "^20.19.20",
-    "@types/qs": "^6.14.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "@vitest/ui": "^4.0.18",
-    "bumpp": "^10.4.1",
+    "@types/qs": "^6.15.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/ui": "^4.1.0",
+    "bumpp": "^11.0.1",
     "commitizen": "^4.3.1",
     "cz-conventional-changelog": "^3.3.0",
-    "eslint": "^10.0.2",
-    "jsdom": "^28.1.0",
-    "lint-staged": "^16.2.7",
+    "eslint": "^10.0.3",
+    "jsdom": "^29.0.0",
+    "lint-staged": "^16.4.0",
     "npm-run-all": "^4.1.5",
     "prettier": "^3.8.1",
     "qs": "^6.15.0",
     "simple-git-hooks": "^2.13.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   },
   "scripts": {
     "rimraf": "rimraf ./node_modules/",