@wener/utils 1.1.48 → 1.1.50

package/lib/server/polyfill/polyfillWebSocket.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/server/polyfill/polyfillWebSocket.ts"],"sourcesContent":["import type { MaybePromise } from '../../asyncs/MaybePromise';\nimport { getGlobalThis } from '../../runtime/getGlobalThis';\n\nexport function polyfillWebSocket(ws: any): boolean;\nexport function polyfillWebSocket(ws?: undefined): Promise<boolean>;\nexport function polyfillWebSocket(ws?: any): MaybePromise<boolean> {\n  const globalThis = getGlobalThis();\n  if ('WebSocket' in globalThis) {\n    return false;\n  }\n  if (ws && 'then' in ws) {\n    return ws.then((v: any) => {\n      return polyfillWebSocket(v?.default || v);\n    });\n  }\n  if (ws) {\n    const { WebSocket } = ws;\n    Object.assign(globalThis, { WebSocket });\n  }\n  return import('ws').then((ws) => polyfillWebSocket(ws));\n}\n"],"names":["getGlobalThis","polyfillWebSocket","ws","globalThis","then","v","default","WebSocket","Object","assign"],"rangeMappings":";;;;;;;;;;;;;;;;;;","mappings":"AACA,SAASA,aAAa,QAAQ,8BAA8B;AAI5D,OAAO,SAASC,kBAAkBC,EAAQ;IACxC,MAAMC,aAAaH;IACnB,IAAI,eAAeG,YAAY;QAC7B,OAAO;IACT;IACA,IAAID,MAAM,UAAUA,IAAI;QACtB,OAAOA,GAAGE,IAAI,CAAC,CAACC;YACd,OAAOJ,kBAAkBI,GAAGC,WAAWD;QACzC;IACF;IACA,IAAIH,IAAI;QACN,MAAM,EAAEK,SAAS,EAAE,GAAGL;QACtBM,OAAOC,MAAM,CAACN,YAAY;YAAEI;QAAU;IACxC;IACA,OAAO,MAAM,CAAC,MAAMH,IAAI,CAAC,CAACF,KAAOD,kBAAkBC;AACrD"}
+{"version":3,"sources":["../../../src/server/polyfill/polyfillWebSocket.ts"],"sourcesContent":["import type { MaybePromise } from '../../asyncs/MaybePromise';\nimport { getGlobalThis } from '../../runtime/getGlobalThis';\n\nexport function polyfillWebSocket(ws: any): boolean;\nexport function polyfillWebSocket(ws?: undefined): Promise<boolean>;\nexport function polyfillWebSocket(ws?: any): MaybePromise<boolean> {\n  const globalThis = getGlobalThis();\n  if ('WebSocket' in globalThis) {\n    return false;\n  }\n  if (ws && 'then' in ws) {\n    return ws.then((v: any) => {\n      return polyfillWebSocket(v?.default || v);\n    });\n  }\n  if (ws) {\n    const { WebSocket } = ws;\n    Object.assign(globalThis, { WebSocket });\n  }\n  return import('ws').then((ws) => polyfillWebSocket(ws));\n}\n"],"names":["getGlobalThis","polyfillWebSocket","ws","globalThis","then","v","default","WebSocket","Object","assign"],"mappings":"AACA,SAASA,aAAa,QAAQ,8BAA8B;AAI5D,OAAO,SAASC,kBAAkBC,EAAQ;IACxC,MAAMC,aAAaH;IACnB,IAAI,eAAeG,YAAY;QAC7B,OAAO;IACT;IACA,IAAID,MAAM,UAAUA,IAAI;QACtB,OAAOA,GAAGE,IAAI,CAAC,CAACC;YACd,OAAOJ,kBAAkBI,GAAGC,WAAWD;QACzC;IACF;IACA,IAAIH,IAAI;QACN,MAAM,EAAEK,SAAS,EAAE,GAAGL;QACtBM,OAAOC,MAAM,CAACN,YAAY;YAAEI;QAAU;IACxC;IACA,OAAO,MAAM,CAAC,MAAMH,IAAI,CAAC,CAACF,KAAOD,kBAAkBC;AACrD"}

package/lib/server/ws.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/ws.ts"],"sourcesContent":["export * from './polyfill/polyfillWebSocket';\n"],"names":[],"rangeMappings":"","mappings":"AAAA,cAAc,+BAA+B"}
+{"version":3,"sources":["../../src/server/ws.ts"],"sourcesContent":["export * from './polyfill/polyfillWebSocket';\n"],"names":[],"mappings":"AAAA,cAAc,+BAA+B"}

package/lib/strings/camelCase.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/strings/camelCase.ts"],"sourcesContent":["// https://github.com/sindresorhus/camelcase/blob/master/index.js\n\nfunction preserveCamelCase(string: string) {\n  let isLastCharLower = false;\n  let isLastCharUpper = false;\n  let isLastLastCharUpper = false;\n\n  for (let i = 0; i < string.length; i++) {\n    const character = string[i];\n\n    if (isLastCharLower && /[a-zA-Z]/.test(character) && character.toUpperCase() === character) {\n      string = string.slice(0, i) + '-' + string.slice(i);\n      isLastCharLower = false;\n      isLastLastCharUpper = isLastCharUpper;\n      isLastCharUpper = true;\n      i++;\n    } else if (\n      isLastCharUpper &&\n      isLastLastCharUpper &&\n      /[a-zA-Z]/.test(character) &&\n      character.toLowerCase() === character\n    ) {\n      string = string.slice(0, i - 1) + '-' + string.slice(i - 1);\n      isLastLastCharUpper = isLastCharUpper;\n      isLastCharUpper = false;\n      isLastCharLower = true;\n    } else {\n      isLastCharLower = character.toLowerCase() === character && character.toUpperCase() !== character;\n      isLastLastCharUpper = isLastCharUpper;\n      isLastCharUpper = character.toUpperCase() === character && character.toLowerCase() !== character;\n    }\n  }\n\n  return string;\n}\n\nexport function pascalCase(input: string | string[]) {\n  return camelCase(input, { pascalCase: true });\n}\n\nexport function camelCase(\n  input: string | string[],\n  options: { pascalCase: boolean } = {\n    pascalCase: false,\n  },\n) {\n  if (!(typeof input === 'string' || Array.isArray(input))) {\n    throw new TypeError('Expected the input to be `string | string[]`');\n  }\n\n  const postProcess = (x: string) => (options.pascalCase ? x.charAt(0).toUpperCase() + x.slice(1) : x);\n\n  if (Array.isArray(input)) {\n    input = input\n      .map((x) => x.trim())\n      .filter((x) => x.length)\n      .join('-');\n  } else {\n    input = input.trim();\n  }\n\n  if (input.length === 0) {\n    return '';\n  }\n\n  if (input.length === 1) {\n    return options.pascalCase ? input.toUpperCase() : input.toLowerCase();\n  }\n\n  const hasUpperCase = input !== input.toLowerCase();\n\n  if (hasUpperCase) {\n    input = preserveCamelCase(input);\n  }\n\n  input = input\n    .replace(/^[_.\\- ]+/, '')\n    .toLowerCase()\n    .replace(/[_.\\- ]+(\\w|$)/g, (_, p1) => p1.toUpperCase())\n    .replace(/\\d+(\\w|$)/g, (m) => m.toUpperCase());\n\n  return postProcess(input);\n}\n"],"names":["preserveCamelCase","string","isLastCharLower","isLastCharUpper","isLastLastCharUpper","i","length","character","test","toUpperCase","slice","toLowerCase","pascalCase","input","camelCase","options","Array","isArray","TypeError","postProcess","x","charAt","map","trim","filter","join","hasUpperCase","replace","_","p1","m"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,iEAAiE;AAEjE,SAASA,kBAAkBC,MAAc;IACvC,IAAIC,kBAAkB;IACtB,IAAIC,kBAAkB;IACtB,IAAIC,sBAAsB;IAE1B,IAAK,IAAIC,IAAI,GAAGA,IAAIJ,OAAOK,MAAM,EAAED,IAAK;QACtC,MAAME,YAAYN,MAAM,CAACI,EAAE;QAE3B,IAAIH,mBAAmB,WAAWM,IAAI,CAACD,cAAcA,UAAUE,WAAW,OAAOF,WAAW;YAC1FN,SAASA,OAAOS,KAAK,CAAC,GAAGL,KAAK,MAAMJ,OAAOS,KAAK,CAACL;YACjDH,kBAAkB;YAClBE,sBAAsBD;YACtBA,kBAAkB;YAClBE;QACF,OAAO,IACLF,mBACAC,uBACA,WAAWI,IAAI,CAACD,cAChBA,UAAUI,WAAW,OAAOJ,WAC5B;YACAN,SAASA,OAAOS,KAAK,CAAC,GAAGL,IAAI,KAAK,MAAMJ,OAAOS,KAAK,CAACL,IAAI;YACzDD,sBAAsBD;YACtBA,kBAAkB;YAClBD,kBAAkB;QACpB,OAAO;YACLA,kBAAkBK,UAAUI,WAAW,OAAOJ,aAAaA,UAAUE,WAAW,OAAOF;YACvFH,sBAAsBD;YACtBA,kBAAkBI,UAAUE,WAAW,OAAOF,aAAaA,UAAUI,WAAW,OAAOJ;QACzF;IACF;IAEA,OAAON;AACT;AAEA,OAAO,SAASW,WAAWC,KAAwB;IACjD,OAAOC,UAAUD,OAAO;QAAED,YAAY;IAAK;AAC7C;AAEA,OAAO,SAASE,UACdD,KAAwB,EACxBE,UAAmC;IACjCH,YAAY;AACd,CAAC;IAED,IAAI,CAAE,CAAA,OAAOC,UAAU,YAAYG,MAAMC,OAAO,CAACJ,MAAK,GAAI;QACxD,MAAM,IAAIK,UAAU;IACtB;IAEA,MAAMC,cAAc,CAACC,IAAeL,QAAQH,UAAU,GAAGQ,EAAEC,MAAM,CAAC,GAAGZ,WAAW,KAAKW,EAAEV,KAAK,CAAC,KAAKU;IAElG,IAAIJ,MAAMC,OAAO,CAACJ,QAAQ;QACxBA,QAAQA,MACLS,GAAG,CAAC,CAACF,IAAMA,EAAEG,IAAI,IACjBC,MAAM,CAAC,CAACJ,IAAMA,EAAEd,MAAM,EACtBmB,IAAI,CAAC;IACV,OAAO;QACLZ,QAAQA,MAAMU,IAAI;IACpB;IAEA,IAAIV,MAAMP,MAAM,KAAK,GAAG;QACtB,OAAO;IACT;IAEA,IAAIO,MAAMP,MAAM,KAAK,GAAG;QACtB,OAAOS,QAAQH,UAAU,GAAGC,MAAMJ,WAAW,KAAKI,MAAMF,WAAW;IACrE;IAEA,MAAMe,eAAeb,UAAUA,MAAMF,WAAW;IAEhD,IAAIe,cAAc;QAChBb,QAAQb,kBAAkBa;IAC5B;IAEAA,QAAQA,MACLc,OAAO,CAAC,aAAa,IACrBhB,WAAW,GACXgB,OAAO,CAAC,mBAAmB,CAACC,GAAGC,KAAOA,GAAGpB,WAAW,IACpDkB,OAAO,CAAC,cAAc,CAACG,IAAMA,EAAErB,WAAW;IAE7C,OAAOU,YAAYN;AACrB"}
+{"version":3,"sources":["../../src/strings/camelCase.ts"],"sourcesContent":["// https://github.com/sindresorhus/camelcase/blob/master/index.js\n\nfunction preserveCamelCase(string: string) {\n  let isLastCharLower = false;\n  let isLastCharUpper = false;\n  let isLastLastCharUpper = false;\n\n  for (let i = 0; i < string.length; i++) {\n    const character = string[i];\n\n    if (isLastCharLower && /[a-zA-Z]/.test(character) && character.toUpperCase() === character) {\n      string = string.slice(0, i) + '-' + string.slice(i);\n      isLastCharLower = false;\n      isLastLastCharUpper = isLastCharUpper;\n      isLastCharUpper = true;\n      i++;\n    } else if (\n      isLastCharUpper &&\n      isLastLastCharUpper &&\n      /[a-zA-Z]/.test(character) &&\n      character.toLowerCase() === character\n    ) {\n      string = string.slice(0, i - 1) + '-' + string.slice(i - 1);\n      isLastLastCharUpper = isLastCharUpper;\n      isLastCharUpper = false;\n      isLastCharLower = true;\n    } else {\n      isLastCharLower = character.toLowerCase() === character && character.toUpperCase() !== character;\n      isLastLastCharUpper = isLastCharUpper;\n      isLastCharUpper = character.toUpperCase() === character && character.toLowerCase() !== character;\n    }\n  }\n\n  return string;\n}\n\nexport function pascalCase(input: string | string[]) {\n  return camelCase(input, { pascalCase: true });\n}\n\nexport function camelCase(\n  input: string | string[],\n  options: { pascalCase: boolean } = {\n    pascalCase: false,\n  },\n) {\n  if (!(typeof input === 'string' || Array.isArray(input))) {\n    throw new TypeError('Expected the input to be `string | string[]`');\n  }\n\n  const postProcess = (x: string) => (options.pascalCase ? x.charAt(0).toUpperCase() + x.slice(1) : x);\n\n  if (Array.isArray(input)) {\n    input = input\n      .map((x) => x.trim())\n      .filter((x) => x.length)\n      .join('-');\n  } else {\n    input = input.trim();\n  }\n\n  if (input.length === 0) {\n    return '';\n  }\n\n  if (input.length === 1) {\n    return options.pascalCase ? input.toUpperCase() : input.toLowerCase();\n  }\n\n  const hasUpperCase = input !== input.toLowerCase();\n\n  if (hasUpperCase) {\n    input = preserveCamelCase(input);\n  }\n\n  input = input\n    .replace(/^[_.\\- ]+/, '')\n    .toLowerCase()\n    .replace(/[_.\\- ]+(\\w|$)/g, (_, p1) => p1.toUpperCase())\n    .replace(/\\d+(\\w|$)/g, (m) => m.toUpperCase());\n\n  return postProcess(input);\n}\n"],"names":["preserveCamelCase","string","isLastCharLower","isLastCharUpper","isLastLastCharUpper","i","length","character","test","toUpperCase","slice","toLowerCase","pascalCase","input","camelCase","options","Array","isArray","TypeError","postProcess","x","charAt","map","trim","filter","join","hasUpperCase","replace","_","p1","m"],"mappings":"AAAA,iEAAiE;AAEjE,SAASA,kBAAkBC,MAAc;IACvC,IAAIC,kBAAkB;IACtB,IAAIC,kBAAkB;IACtB,IAAIC,sBAAsB;IAE1B,IAAK,IAAIC,IAAI,GAAGA,IAAIJ,OAAOK,MAAM,EAAED,IAAK;QACtC,MAAME,YAAYN,MAAM,CAACI,EAAE;QAE3B,IAAIH,mBAAmB,WAAWM,IAAI,CAACD,cAAcA,UAAUE,WAAW,OAAOF,WAAW;YAC1FN,SAASA,OAAOS,KAAK,CAAC,GAAGL,KAAK,MAAMJ,OAAOS,KAAK,CAACL;YACjDH,kBAAkB;YAClBE,sBAAsBD;YACtBA,kBAAkB;YAClBE;QACF,OAAO,IACLF,mBACAC,uBACA,WAAWI,IAAI,CAACD,cAChBA,UAAUI,WAAW,OAAOJ,WAC5B;YACAN,SAASA,OAAOS,KAAK,CAAC,GAAGL,IAAI,KAAK,MAAMJ,OAAOS,KAAK,CAACL,IAAI;YACzDD,sBAAsBD;YACtBA,kBAAkB;YAClBD,kBAAkB;QACpB,OAAO;YACLA,kBAAkBK,UAAUI,WAAW,OAAOJ,aAAaA,UAAUE,WAAW,OAAOF;YACvFH,sBAAsBD;YACtBA,kBAAkBI,UAAUE,WAAW,OAAOF,aAAaA,UAAUI,WAAW,OAAOJ;QACzF;IACF;IAEA,OAAON;AACT;AAEA,OAAO,SAASW,WAAWC,KAAwB;IACjD,OAAOC,UAAUD,OAAO;QAAED,YAAY;IAAK;AAC7C;AAEA,OAAO,SAASE,UACdD,KAAwB,EACxBE,UAAmC;IACjCH,YAAY;AACd,CAAC;IAED,IAAI,CAAE,CAAA,OAAOC,UAAU,YAAYG,MAAMC,OAAO,CAACJ,MAAK,GAAI;QACxD,MAAM,IAAIK,UAAU;IACtB;IAEA,MAAMC,cAAc,CAACC,IAAeL,QAAQH,UAAU,GAAGQ,EAAEC,MAAM,CAAC,GAAGZ,WAAW,KAAKW,EAAEV,KAAK,CAAC,KAAKU;IAElG,IAAIJ,MAAMC,OAAO,CAACJ,QAAQ;QACxBA,QAAQA,MACLS,GAAG,CAAC,CAACF,IAAMA,EAAEG,IAAI,IACjBC,MAAM,CAAC,CAACJ,IAAMA,EAAEd,MAAM,EACtBmB,IAAI,CAAC;IACV,OAAO;QACLZ,QAAQA,MAAMU,IAAI;IACpB;IAEA,IAAIV,MAAMP,MAAM,KAAK,GAAG;QACtB,OAAO;IACT;IAEA,IAAIO,MAAMP,MAAM,KAAK,GAAG;QACtB,OAAOS,QAAQH,UAAU,GAAGC,MAAMJ,WAAW,KAAKI,MAAMF,WAAW;IACrE;IAEA,MAAMe,eAAeb,UAAUA,MAAMF,WAAW;IAEhD,IAAIe,cAAc;QAChBb,QAAQb,kBAAkBa;IAC5B;IAEAA,QAAQA,MACLc,OAAO,CAAC,aAAa,IACrBhB,WAAW,GACXgB,OAAO,CAAC,mBAAmB,CAACC,GAAGC,KAAOA,GAAGpB,WAAW,IACpDkB,OAAO,CAAC,cAAc,CAACG,IAAMA,EAAErB,WAAW;IAE7C,OAAOU,YAAYN;AACrB"}

package/lib/strings/formatBytes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/strings/formatBytes.ts"],"sourcesContent":["/**\n * Format bytes as human-readable text.\n *\n * @param bytes Number of bytes.\n * @param si True to use metric (SI) units, aka powers of 1000. False to use\n *           binary (IEC), aka powers of 1024.\n * @param dp Number of decimal places to display.\n *\n * @return Formatted string.\n */\nexport function formatBytes(bytes: number, si = false, dp = 1) {\n  const thresh = si ? 1000 : 1024;\n\n  if (Math.abs(bytes) < thresh) {\n    return `${bytes} B`;\n  }\n\n  const units = si\n    ? ['kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']\n    : ['KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];\n  let u = -1;\n  const r = 10 ** dp;\n\n  do {\n    bytes /= thresh;\n    ++u;\n  } while (Math.round(Math.abs(bytes) * r) / r >= thresh && u < units.length - 1);\n\n  return bytes.toFixed(dp) + ' ' + units[u];\n}\n"],"names":["formatBytes","bytes","si","dp","thresh","Math","abs","units","u","r","round","length","toFixed"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA;;;;;;;;;CASC,GACD,OAAO,SAASA,YAAYC,KAAa,EAAEC,KAAK,KAAK,EAAEC,KAAK,CAAC;IAC3D,MAAMC,SAASF,KAAK,OAAO;IAE3B,IAAIG,KAAKC,GAAG,CAACL,SAASG,QAAQ;QAC5B,OAAO,CAAC,EAAEH,MAAM,EAAE,CAAC;IACrB;IAEA,MAAMM,QAAQL,KACV;QAAC;QAAM;QAAM;QAAM;QAAM;QAAM;QAAM;QAAM;KAAK,GAChD;QAAC;QAAO;QAAO;QAAO;QAAO;QAAO;QAAO;QAAO;KAAM;IAC5D,IAAIM,IAAI,CAAC;IACT,MAAMC,IAAI,MAAMN;IAEhB,GAAG;QACDF,SAASG;QACT,EAAEI;IACJ,QAASH,KAAKK,KAAK,CAACL,KAAKC,GAAG,CAACL,SAASQ,KAAKA,KAAKL,UAAUI,IAAID,MAAMI,MAAM,GAAG,EAAG;IAEhF,OAAOV,MAAMW,OAAO,CAACT,MAAM,MAAMI,KAAK,CAACC,EAAE;AAC3C"}
+{"version":3,"sources":["../../src/strings/formatBytes.ts"],"sourcesContent":["/**\n * Format bytes as human-readable text.\n *\n * @param bytes Number of bytes.\n * @param si True to use metric (SI) units, aka powers of 1000. False to use\n *           binary (IEC), aka powers of 1024.\n * @param dp Number of decimal places to display.\n *\n * @return Formatted string.\n */\nexport function formatBytes(bytes: number, si = false, dp = 1) {\n  const thresh = si ? 1000 : 1024;\n\n  if (Math.abs(bytes) < thresh) {\n    return `${bytes} B`;\n  }\n\n  const units = si\n    ? ['kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']\n    : ['KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'];\n  let u = -1;\n  const r = 10 ** dp;\n\n  do {\n    bytes /= thresh;\n    ++u;\n  } while (Math.round(Math.abs(bytes) * r) / r >= thresh && u < units.length - 1);\n\n  return bytes.toFixed(dp) + ' ' + units[u];\n}\n"],"names":["formatBytes","bytes","si","dp","thresh","Math","abs","units","u","r","round","length","toFixed"],"mappings":"AAAA;;;;;;;;;CASC,GACD,OAAO,SAASA,YAAYC,KAAa,EAAEC,KAAK,KAAK,EAAEC,KAAK,CAAC;IAC3D,MAAMC,SAASF,KAAK,OAAO;IAE3B,IAAIG,KAAKC,GAAG,CAACL,SAASG,QAAQ;QAC5B,OAAO,GAAGH,MAAM,EAAE,CAAC;IACrB;IAEA,MAAMM,QAAQL,KACV;QAAC;QAAM;QAAM;QAAM;QAAM;QAAM;QAAM;QAAM;KAAK,GAChD;QAAC;QAAO;QAAO;QAAO;QAAO;QAAO;QAAO;QAAO;KAAM;IAC5D,IAAIM,IAAI,CAAC;IACT,MAAMC,IAAI,MAAMN;IAEhB,GAAG;QACDF,SAASG;QACT,EAAEI;IACJ,QAASH,KAAKK,KAAK,CAACL,KAAKC,GAAG,CAACL,SAASQ,KAAKA,KAAKL,UAAUI,IAAID,MAAMI,MAAM,GAAG,EAAG;IAEhF,OAAOV,MAAMW,OAAO,CAACT,MAAM,MAAMI,KAAK,CAACC,EAAE;AAC3C"}

package/lib/strings/renderTemplate.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/strings/renderTemplate.ts"],"sourcesContent":["import { get } from '../objects/get';\n\n/**\n * render template like js template string\n *\n * @example\n * renderTemplate('My name is ${name}',{name:'wener'})\n * // 'My name is wener'\n *\n * @param match `js` for `${name}`, common for `{{name}}`\n */\nexport function renderTemplate(\n  template: string,\n  data: ((v: string) => any) | object | undefined,\n  match: 'js' | 'common' | RegExp = 'js',\n) {\n  let getter: Function;\n  if (!data) {\n    // todo warning in dev\n    getter = () => '';\n  } else if (typeof data === 'function') {\n    getter = data;\n  } else {\n    getter = (v: string) => get(data, v);\n  }\n  if (typeof match === 'string') {\n    match = Matches[match] || Matches.js;\n  }\n  return template.replace(match, (_, g) => {\n    return getter(g.trim());\n  });\n}\n\nconst Matches: Record<string, RegExp> = {\n  js: /\\${(.*?)}/g,\n  common: /{{(.*?)}}/g,\n};\n"],"names":["get","renderTemplate","template","data","match","getter","v","Matches","js","replace","_","g","trim","common"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,SAASA,GAAG,QAAQ,iBAAiB;AAErC;;;;;;;;CAQC,GACD,OAAO,SAASC,eACdC,QAAgB,EAChBC,IAA+C,EAC/CC,QAAkC,IAAI;IAEtC,IAAIC;IACJ,IAAI,CAACF,MAAM;QACT,sBAAsB;QACtBE,SAAS,IAAM;IACjB,OAAO,IAAI,OAAOF,SAAS,YAAY;QACrCE,SAASF;IACX,OAAO;QACLE,SAAS,CAACC,IAAcN,IAAIG,MAAMG;IACpC;IACA,IAAI,OAAOF,UAAU,UAAU;QAC7BA,QAAQG,OAAO,CAACH,MAAM,IAAIG,QAAQC,EAAE;IACtC;IACA,OAAON,SAASO,OAAO,CAACL,OAAO,CAACM,GAAGC;QACjC,OAAON,OAAOM,EAAEC,IAAI;IACtB;AACF;AAEA,MAAML,UAAkC;IACtCC,IAAI;IACJK,QAAQ;AACV"}
+{"version":3,"sources":["../../src/strings/renderTemplate.ts"],"sourcesContent":["import { get } from '../objects/get';\n\n/**\n * render template like js template string\n *\n * @example\n * renderTemplate('My name is ${name}',{name:'wener'})\n * // 'My name is wener'\n *\n * @param match `js` for `${name}`, common for `{{name}}`\n */\nexport function renderTemplate(\n  template: string,\n  data: ((v: string) => any) | object | undefined,\n  match: 'js' | 'common' | RegExp = 'js',\n) {\n  let getter: Function;\n  if (!data) {\n    // todo warning in dev\n    getter = () => '';\n  } else if (typeof data === 'function') {\n    getter = data;\n  } else {\n    getter = (v: string) => get(data, v);\n  }\n  if (typeof match === 'string') {\n    match = Matches[match] || Matches.js;\n  }\n  return template.replace(match, (_, g) => {\n    return getter(g.trim());\n  });\n}\n\nconst Matches: Record<string, RegExp> = {\n  js: /\\${(.*?)}/g,\n  common: /{{(.*?)}}/g,\n};\n"],"names":["get","renderTemplate","template","data","match","getter","v","Matches","js","replace","_","g","trim","common"],"mappings":"AAAA,SAASA,GAAG,QAAQ,iBAAiB;AAErC;;;;;;;;CAQC,GACD,OAAO,SAASC,eACdC,QAAgB,EAChBC,IAA+C,EAC/CC,QAAkC,IAAI;IAEtC,IAAIC;IACJ,IAAI,CAACF,MAAM;QACT,sBAAsB;QACtBE,SAAS,IAAM;IACjB,OAAO,IAAI,OAAOF,SAAS,YAAY;QACrCE,SAASF;IACX,OAAO;QACLE,SAAS,CAACC,IAAcN,IAAIG,MAAMG;IACpC;IACA,IAAI,OAAOF,UAAU,UAAU;QAC7BA,QAAQG,OAAO,CAACH,MAAM,IAAIG,QAAQC,EAAE;IACtC;IACA,OAAON,SAASO,OAAO,CAACL,OAAO,CAACM,GAAGC;QACjC,OAAON,OAAOM,EAAEC,IAAI;IACtB;AACF;AAEA,MAAML,UAAkC;IACtCC,IAAI;IACJK,QAAQ;AACV"}

package/lib/typedoc.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/typedoc.ts"],"sourcesContent":["export * from './index';\n// fixme md5 conflict\n// export * from './server';\n"],"names":[],"rangeMappings":";","mappings":"AAAA,cAAc,UAAU,CACxB,qBAAqB;CACrB,4BAA4B"}
+{"version":3,"sources":["../src/typedoc.ts"],"sourcesContent":["export * from './index';\n// fixme md5 conflict\n// export * from './server';\n"],"names":[],"mappings":"AAAA,cAAc,UAAU,CACxB,qBAAqB;CACrB,4BAA4B"}

package/lib/types.d.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.d.ts"],"sourcesContent":["declare var __DEV__: boolean;\n\nnamespace NodeJS {\n  interface Process {\n    // webpack check\n    readonly browser?: boolean;\n  }\n  interface ProcessEnv {\n    readonly NODE_ENV: 'development' | 'production' | 'test';\n  }\n}\n\nexport type AbstractConstructor<T = {}> = abstract new (...args: any[]) => T;\nexport type Constructor<T = {}> = new (...args: any[]) => T;\nexport type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\nexport type PartialRequired<T, K extends keyof T> = Partial<Omit<T, K>> & Required<Pick<T, K>>;\n\n/*\nhttps://github.com/total-typescript/ts-reset/blob/main/src/entrypoints/filter-boolean.d.ts\nhttps://github.com/sindresorhus/type-fest\n */\n"],"names":[],"rangeMappings":";;;","mappings":"AAeA,WAA+F,CAE/F;;;CAGC"}
+{"version":3,"sources":["../src/types.d.ts"],"sourcesContent":["declare var __DEV__: boolean;\n\nnamespace NodeJS {\n  interface Process {\n    // webpack check\n    readonly browser?: boolean;\n  }\n  interface ProcessEnv {\n    readonly NODE_ENV: 'development' | 'production' | 'test';\n  }\n}\n\nexport type AbstractConstructor<T = {}> = abstract new (...args: any[]) => T;\nexport type Constructor<T = {}> = new (...args: any[]) => T;\nexport type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;\nexport type PartialRequired<T, K extends keyof T> = Partial<Omit<T, K>> & Required<Pick<T, K>>;\n\n/*\nhttps://github.com/total-typescript/ts-reset/blob/main/src/entrypoints/filter-boolean.d.ts\nhttps://github.com/sindresorhus/type-fest\n */\n"],"names":[],"mappings":"AAeA,WAA+F,CAE/F;;;CAGC"}

package/lib/validations/asserts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/validations/asserts.ts"],"sourcesContent":["export function assert(condition: any, msg?: string): asserts condition {\n  // if (!condition) {\n  //   throw new AssertionError(msg);\n  // }\n  console.assert(!condition, msg);\n}\n\nexport function assertIsDefined<T>(val: T): asserts val is NonNullable<T> {\n  // if (val === undefined || val === null) {\n  //   throw new AssertionError(`Expected 'val' to be defined, but received ${val}`);\n  // }\n  console.assert(val === undefined || val === null, 'Expected defined');\n}\n"],"names":["assert","condition","msg","console","assertIsDefined","val","undefined"],"rangeMappings":";;;;;;;;;;;","mappings":"AAAA,OAAO,SAASA,OAAOC,SAAc,EAAEC,GAAY;IACjD,oBAAoB;IACpB,mCAAmC;IACnC,IAAI;IACJC,QAAQH,MAAM,CAAC,CAACC,WAAWC;AAC7B;AAEA,OAAO,SAASE,gBAAmBC,GAAM;IACvC,2CAA2C;IAC3C,mFAAmF;IACnF,IAAI;IACJF,QAAQH,MAAM,CAACK,QAAQC,aAAaD,QAAQ,MAAM;AACpD"}
+{"version":3,"sources":["../../src/validations/asserts.ts"],"sourcesContent":["export function assert(condition: any, msg?: string): asserts condition {\n  // if (!condition) {\n  //   throw new AssertionError(msg);\n  // }\n  console.assert(!condition, msg);\n}\n\nexport function assertIsDefined<T>(val: T): asserts val is NonNullable<T> {\n  // if (val === undefined || val === null) {\n  //   throw new AssertionError(`Expected 'val' to be defined, but received ${val}`);\n  // }\n  console.assert(val === undefined || val === null, 'Expected defined');\n}\n"],"names":["assert","condition","msg","console","assertIsDefined","val","undefined"],"mappings":"AAAA,OAAO,SAASA,OAAOC,SAAc,EAAEC,GAAY;IACjD,oBAAoB;IACpB,mCAAmC;IACnC,IAAI;IACJC,QAAQH,MAAM,CAAC,CAACC,WAAWC;AAC7B;AAEA,OAAO,SAASE,gBAAmBC,GAAM;IACvC,2CAA2C;IAC3C,mFAAmF;IACnF,IAAI;IACJF,QAAQH,MAAM,CAACK,QAAQC,aAAaD,QAAQ,MAAM;AACpD"}

package/lib/validations/isUUID.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/validations/isUUID.ts"],"sourcesContent":["export function isUUID(str: string | undefined | null) {\n  return Boolean(str) && /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(String(str));\n}\n"],"names":["isUUID","str","Boolean","test","String"],"rangeMappings":";;","mappings":"AAAA,OAAO,SAASA,OAAOC,GAA8B;IACnD,OAAOC,QAAQD,QAAQ,yEAAyEE,IAAI,CAACC,OAAOH;AAC9G"}
+{"version":3,"sources":["../../src/validations/isUUID.ts"],"sourcesContent":["export function isUUID(str: string | undefined | null) {\n  return Boolean(str) && /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(String(str));\n}\n"],"names":["isUUID","str","Boolean","test","String"],"mappings":"AAAA,OAAO,SAASA,OAAOC,GAA8B;IACnD,OAAOC,QAAQD,QAAQ,yEAAyEE,IAAI,CAACC,OAAOH;AAC9G"}

package/lib/validations/parseTimestamp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/validations/parseTimestamp.ts"],"sourcesContent":["export function parseTimestamp(raw?: string | number | Date): Date | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  if (raw instanceof Date) {\n    return raw;\n  }\n\n  if (typeof raw === 'string' && /^[0-9.]+$/.test(raw)) {\n    let n = parseFloat(raw);\n    const len = Math.floor(n).toString().length;\n    /*\n    最常见的是 10 位和 13 位\n    9999999999 - 10*9 - 1970-04-26\n    99999999999 - 11*9 - 1973\n    999999999999 - 12*9 - 2001\n     */\n    if (len <= 11) {\n      n *= 1000;\n    }\n    return new Date(n);\n  } else if (typeof raw === 'string') {\n    const date = new Date(raw);\n    if (!isNaN(+date)) {\n      return date;\n    }\n  }\n  throw new Error(`parseTimestamp: invalid \"${raw}\"`);\n}\n"],"names":["parseTimestamp","raw","undefined","Date","test","n","parseFloat","len","Math","floor","toString","length","date","isNaN","Error"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA,OAAO,SAASA,eAAeC,GAA4B;IACzD,IAAI,CAACA,KAAK;QACR,OAAOC;IACT;IACA,IAAID,eAAeE,MAAM;QACvB,OAAOF;IACT;IAEA,IAAI,OAAOA,QAAQ,YAAY,YAAYG,IAAI,CAACH,MAAM;QACpD,IAAII,IAAIC,WAAWL;QACnB,MAAMM,MAAMC,KAAKC,KAAK,CAACJ,GAAGK,QAAQ,GAAGC,MAAM;QAC3C;;;;;KAKC,GACD,IAAIJ,OAAO,IAAI;YACbF,KAAK;QACP;QACA,OAAO,IAAIF,KAAKE;IAClB,OAAO,IAAI,OAAOJ,QAAQ,UAAU;QAClC,MAAMW,OAAO,IAAIT,KAAKF;QACtB,IAAI,CAACY,MAAM,CAACD,OAAO;YACjB,OAAOA;QACT;IACF;IACA,MAAM,IAAIE,MAAM,CAAC,yBAAyB,EAAEb,IAAI,CAAC,CAAC;AACpD"}
+{"version":3,"sources":["../../src/validations/parseTimestamp.ts"],"sourcesContent":["export function parseTimestamp(raw?: string | number | Date): Date | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  if (raw instanceof Date) {\n    return raw;\n  }\n\n  if (typeof raw === 'string' && /^[0-9.]+$/.test(raw)) {\n    let n = parseFloat(raw);\n    const len = Math.floor(n).toString().length;\n    /*\n    最常见的是 10 位和 13 位\n    9999999999 - 10*9 - 1970-04-26\n    99999999999 - 11*9 - 1973\n    999999999999 - 12*9 - 2001\n     */\n    if (len <= 11) {\n      n *= 1000;\n    }\n    return new Date(n);\n  } else if (typeof raw === 'string') {\n    const date = new Date(raw);\n    if (!isNaN(+date)) {\n      return date;\n    }\n  }\n  throw new Error(`parseTimestamp: invalid \"${raw}\"`);\n}\n"],"names":["parseTimestamp","raw","undefined","Date","test","n","parseFloat","len","Math","floor","toString","length","date","isNaN","Error"],"mappings":"AAAA,OAAO,SAASA,eAAeC,GAA4B;IACzD,IAAI,CAACA,KAAK;QACR,OAAOC;IACT;IACA,IAAID,eAAeE,MAAM;QACvB,OAAOF;IACT;IAEA,IAAI,OAAOA,QAAQ,YAAY,YAAYG,IAAI,CAACH,MAAM;QACpD,IAAII,IAAIC,WAAWL;QACnB,MAAMM,MAAMC,KAAKC,KAAK,CAACJ,GAAGK,QAAQ,GAAGC,MAAM;QAC3C;;;;;KAKC,GACD,IAAIJ,OAAO,IAAI;YACbF,KAAK;QACP;QACA,OAAO,IAAIF,KAAKE;IAClB,OAAO,IAAI,OAAOJ,QAAQ,UAAU;QAClC,MAAMW,OAAO,IAAIT,KAAKF;QACtB,IAAI,CAACY,MAAM,CAACD,OAAO;YACjB,OAAOA;QACT;IACF;IACA,MAAM,IAAIE,MAAM,CAAC,yBAAyB,EAAEb,IAAI,CAAC,CAAC;AACpD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wener/utils",
-  "version": "1.1.48",
+  "version": "1.1.50",
   "type": "module",
   "description": "Utils for daily use",
   "repository": {
@@ -70,14 +70,14 @@
     "lodash"
   ],
   "devDependencies": {
-    "@sinclair/typebox": "^0.32.35",
-    "@types/lodash": "^4.17.7",
+    "@sinclair/typebox": "^0.33.15",
+    "@types/lodash": "^4.17.10",
     "@types/ws": "^8.5.12",
     "@wener/utils": "link:",
     "https-proxy-agent": "^7.0.5",
     "lodash": "^4.17.21",
     "node-fetch": "^3.3.2",
-    "undici": "^6.19.5",
+    "undici": "^6.20.0",
     "zod": "^3.23.8"
   },
   "publishConfig": {

package/src/asyncs/Promises.ts

@@ -40,8 +40,18 @@ export class Promises {
    * Returns `true` if the given value is a Promise.
    * @param v The value to check.
    */
-  static isPromise<T>(v: any): v is Promise<T> {
-    return v && (v instanceof Promise || (v.then && v.catch));
+  static isPromise<T>(v: any): v is PromiseLike<T> {
+    return v && (v instanceof Promise || typeof v.then === 'function');
+  }
+
+  /**
+   * Returns a Promise that resolves when the given signal is aborted.
+   */
+  static aborted(signal: AbortSignal): Promise<void> {
+    // https://nodejs.org/api/util.html#utilabortedsignal-resource
+    return new Promise((_, reject) => {
+      signal.addEventListener('abort', () => reject(new DOMException('Aborted', 'AbortError')));
+    });
   }
 }
 

package/src/asyncs/createLazyPromise.test.ts

@@ -1,18 +1,56 @@
-import { expect, test } from 'vitest';
+import { describe, expect, test } from 'vitest';
 import { createLazyPromise } from './createLazyPromise';
 
-test('basic', async () => {
-  const promise = createLazyPromise();
-  let r = 0;
-  void promise.then((v) => (r = v));
-  expect(r).toBe(0);
-  const { resolve, reject } = promise;
-  expect(resolve).toBeTruthy();
-  expect(reject).toBeTruthy();
-  resolve(1);
-  expect(r).toBe(0);
-  await promise;
-  expect(r).toBe(1);
+describe('basic', async () => {
+  test('no executor', async () => {
+    const promise = createLazyPromise();
+    let r = 0;
+    void promise.then((v) => (r = v));
+    expect(r).toBe(0);
+    const { resolve, reject } = promise;
+    expect(resolve).toBeTruthy();
+    expect(reject).toBeTruthy();
+
+    // peek
+    expect(promise.value).toBeUndefined();
+    expect(promise.status).toBe('pending');
+    resolve(1);
+    expect(promise.value).toBe(1);
+    expect(promise.status).toBe('resolved');
+
+    expect(r).toBe(0);
+
+    await promise;
+
+    expect(r).toBe(1);
+  });
+
+  test('can resolve to lazy', async () => {
+    const a = createLazyPromise(() => {
+      return createLazyPromise(() => {
+        return 10;
+      });
+    });
+
+    expect(a.value).toBeUndefined();
+    expect(a.status).toBe('pending');
+    expect(await a).toBe(10);
+    expect(a.status).toBe('resolved');
+    expect(a.value).toBe(10);
+  });
+
+  test('can resolve to async lazy', async () => {
+    const a = createLazyPromise(async () => {
+      return createLazyPromise(async () => {
+        return 10;
+      });
+    });
+    expect(a.value).toBeUndefined();
+    expect(a.status).toBe('pending');
+    expect(await a).toBe(10);
+    expect(a.status).toBe('resolved');
+    expect(a.value).toBe(10);
+  });
 });
 
 test('manual resolve skip exec', async () => {
@@ -21,6 +59,7 @@ test('manual resolve skip exec', async () => {
   });
   promise.resolve(-1);
   expect(await promise).toBe(-1);
+  expect(String(promise)).toBe('[object LazyPromise]');
 });
 
 test('lazy exec resolve by manual', async () => {

package/src/asyncs/createLazyPromise.ts

@@ -1,9 +1,13 @@
 import { isPromise } from './isPromise';
 import type { MaybePromise } from './MaybePromise';
+import { Promises } from './Promises';
 
 export type LazyPromise<T> = Promise<T> & {
   reject(reason?: any): void;
   resolve(v?: MaybePromise<T>): void;
+  readonly status: 'pending' | 'resolved' | 'rejected';
+  readonly value: T | undefined;
+  readonly error: any;
 };
 
 /**
@@ -11,77 +15,78 @@ export type LazyPromise<T> = Promise<T> & {
  * if you pass a function to it, it will be executed when the promise try to resolve.
  */
 export function createLazyPromise<T = any>(
-  executor?:
-    | ((resolve: LazyPromise<T>['resolve'], reject: LazyPromise<T>['reject']) => void)
-    | ((resolve: LazyPromise<T>['resolve'], reject: LazyPromise<T>['reject']) => MaybePromise<T>),
+  executor?: (resolve: LazyPromise<T>['resolve'], reject: LazyPromise<T>['reject']) => MaybePromise<T> | void,
 ): LazyPromise<T> {
-  if (!executor && 'withResolvers' in Promise) {
-    const { promise, resolve, reject } = (Promise as any).withResolvers();
-    return Object.assign(promise, {
-      resolve,
-      reject,
-    }) as LazyPromise<T>;
-  }
+  const { promise, resolve, reject } = Promises.withResolvers();
+  const lazy = Object.assign(promise, {
+    resolve,
+    reject,
+  }) as LazyPromise<T>;
 
-  const holder = {
-    resolve(_: any): void {
-      throw new Error('pending resolve');
-    },
-    reject(_: any): void {
-      throw new Error('pending reject');
-    },
+  let executed = false;
+  let pending = true;
+  let status: 'pending' | 'resolved' | 'rejected' = 'pending';
+  let value: T | undefined;
+  let error: any;
+
+  const _resolve = (v: T) => {
+    resolve(v);
+    if (!pending) return;
+    pending = false;
+    // do not delay this for sync status peek
+    status = 'resolved';
+    value = v;
+  };
+  const _reject = (v: any) => {
+    reject(v);
+    if (!pending) return;
+    pending = false;
+    status = 'rejected';
+    error = v;
   };
-  const future = Object.assign(
-    new Promise<T>((resolve, reject) => {
-      holder.reject = reject;
-      holder.resolve = resolve;
-    }),
+
+  const like = Object.assign(
     {
-      resolve(v: any) {
-        holder.resolve(v);
+      get status() {
+        return status;
       },
-      reject(v: any) {
-        holder.resolve(v);
+      get value() {
+        return value;
+      },
+      get error() {
+        return error;
       },
     },
-  );
-  if (executor) {
-    const r = holder.resolve;
-    let shouldExec = true;
-    holder.resolve = (v: any) => {
-      shouldExec = false;
-      r(v);
-    };
-    const then = future.then.bind(future);
-    future.then = (...args) => {
-      if (shouldExec) {
-        shouldExec = false;
-        try {
-          // kind of bad
-          const result = executor(holder.resolve, holder.reject);
-          // ensure resolve/reject is called
-          if (isPromise(result)) {
-            result.then(holder.resolve, holder.reject);
-          } else if (result !== undefined) {
-            holder.resolve(result);
+    {
+      cache: lazy.catch.bind(lazy),
+      finally: lazy.finally?.bind(lazy),
+      resolve: _resolve,
+      reject: _reject,
+      then: (...args: any[]) => {
+        if (executor && !executed) {
+          executed = true;
+          try {
+            const result = executor(_resolve, _reject);
+            // ensure resolve/reject is called
+            if (isPromise(result)) {
+              result.then(_resolve, _reject);
+            } else if (result !== undefined) {
+              _resolve(result);
+            }
+          } catch (e) {
+            _reject(e);
           }
-        } catch (e) {
-          holder.reject(e);
         }
-      }
-      return then(...args);
-    };
-    const like = holder as LazyPromise<T>;
-    like.then = future.then;
-    like.catch = future.catch.bind(future);
-    if (future.finally) like.finally = future.finally;
-
-    void Object.defineProperty(like, Symbol.species, {
-      get() {
-        return Promise;
+        return lazy.then(...args);
       },
+    },
+  ) as any as LazyPromise<T>;
+
+  if ('toStringTag' in Symbol) {
+    Object.defineProperty(like, Symbol.toStringTag, {
+      value: 'LazyPromise',
     });
-    return like;
   }
-  return future;
+
+  return like;
 }

package/src/asyncs/firstOfAsyncIterator.ts

@@ -1,5 +1,5 @@
 import { isPromise } from './isPromise';
-import { MaybePromise } from './MaybePromise';
+import type { MaybePromise } from './MaybePromise';
 import { nextOfAsyncIterator } from './nextOfAsyncIterator';
 
 export function firstOfAsyncIterator<T>(it: MaybePromise<AsyncIterator<T> | Iterator<T> | T>): MaybePromise<T> {

package/src/asyncs/nextOfAsyncIterator.ts

@@ -1,6 +1,6 @@
 import { isIterator } from './isIterator';
 import { isPromise } from './isPromise';
-import { MaybePromise } from './MaybePromise';
+import type { MaybePromise } from './MaybePromise';
 
 type IteratorLike<T> = Iterable<T> | Iterator<T>;
 type AsyncIteratorLike<T> = AsyncIterable<T> | AsyncIterator<T> | AsyncIterableIterator<T> | IteratorLike<T>;

package/src/asyncs/timeout.ts

@@ -1,17 +1,17 @@
 export function timeout<T = any>(
-  v: Promise<T> | ((args: { signal: AbortSignal }) => Promise<T>),
+  pending: Promise<T> | ((args: { signal: AbortSignal }) => Promise<T>),
   ms: number,
 ): Promise<T> {
   const error = new TimeoutError();
   let timeout: any;
   let ac: AbortController | undefined;
-  if (typeof v === 'function') {
+  if (typeof pending === 'function') {
     ac = new AbortController();
-    v = v({ signal: ac.signal });
+    pending = pending({ signal: ac.signal });
   }
 
   return Promise.race<T>([
-    v,
+    pending,
     new Promise((_resolve, reject) => {
       timeout = setTimeout(() => {
         ac?.abort(error);

package/src/cn/types.ts

@@ -0,0 +1,11 @@
+export interface StringFormat<GenerateOptions, ParsedObject> {
+  regex?: RegExp;
+  validate: (s: string) => boolean;
+  generate: (opts?: GenerateOptions) => ParsedObject;
+  parse: (s: string) => ParsedObject | undefined;
+}
+
+export interface StringChecksum {
+  validate: (s: string) => boolean;
+  generate: (s: string) => string;
+}

package/src/crypto/getNodeCrypto.ts

@@ -1,3 +1,4 @@
+// import type * as NodeCrypto from 'node:crypto';
 import { getGlobalThis } from '../runtime/getGlobalThis';
 
 let nodeCrypto;

package/src/errors/Errors.ts

@@ -152,26 +152,47 @@ export interface ErrorDetail {
   check<T>(v: T | undefined | null, o?: Partial<ErrorDetailInit> | string): asserts v is NonNullable<T>;
 }
 
-export class Errors {
-  static BadRequest: ErrorDetail = this.with({ status: 400 });
-  static Unauthorized: ErrorDetail = this.with({ status: 403 });
-  static Forbidden: ErrorDetail = this.with({ status: 403 });
-  static NotFound: ErrorDetail = this.with({ status: 404 });
-  static InternalServerError: ErrorDetail = this.with({ status: 500 });
-  static NotImplemented: ErrorDetail = this.with({ status: 501 });
-  static ServiceUnavailable: ErrorDetail = this.with({ status: 503 });
-
-  static resolvers: ((e: any) => ErrorDetail | void)[] = [];
-
-  static with(init: ErrorDetailInit): ErrorDetail {
+export namespace Errors {
+  /*
+https://github.com/tc39/proposal-error-cause
+https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/cause
+Stage 3
+Chrome 93, Safari 15, Node 16.9
+
+https://www.npmjs.com/package/pony-cause
+   */
+
+  export const BadRequest: ErrorDetail = create({ status: 400 });
+  export const Unauthorized: ErrorDetail = create({ status: 403 });
+  export const Forbidden: ErrorDetail = create({ status: 403 });
+  export const NotFound: ErrorDetail = create({ status: 404 });
+  export const InternalServerError: ErrorDetail = create({ status: 500 });
+  export const NotImplemented: ErrorDetail = create({ status: 501 });
+  export const ServiceUnavailable: ErrorDetail = create({ status: 503 });
+
+  // known errors
+  // TypeError  when an operation could not be performed, typically (but not exclusively) when a value is not of the expected type.
+  // RangeError  when a number is not within the correct range allowed.
+  // AggregateError  when multiple errors need to be reported by an operation, for example by Promise.all().
+  //  例如 Promise.any() 会返回一个 AggregateError，其中包含所有 rejected 的 Promise 的错误。
+  // EvalError  when an error occurs during the evaluation of JavaScript code.
+  // ReferenceError  when a non-existent variable is referenced.
+  // SyntaxError  when a syntax error occurs while parsing code in eval().
+  // URIError  when encodeURI() or decodeURI() are passed invalid parameters.
+  // InternalError  when an internal error in the JavaScript engine is thrown. E.g. "too much recursion".
+  // DOMException  when an error occurs in the DOM.
+
+  export const resolvers: ((e: any) => ErrorDetail | void)[] = [];
+
+  export function create(init: ErrorDetailInit): ErrorDetail {
     return new DetailHolder(init);
   }
 
-  static ok(res: Response, o?: Partial<ErrorDetailInit>) {
+  export function ok(res: Response, o?: Partial<ErrorDetailInit>) {
     if (res.ok) {
       return res;
     }
-    throw this.with({
+    throw create({
       description: res.statusText,
       status: res.status,
       ...o,
@@ -182,7 +203,7 @@ export class Errors {
     }).asError();
   }
 
-  static resolve(e: any): ErrorDetail {
+  export function resolve(e: any): ErrorDetail {
     if (e instanceof DetailHolder) {
       return e;
     }
@@ -191,7 +212,7 @@ export class Errors {
       return e.detail;
     }
 
-    for (const resolver of this.resolvers) {
+    for (const resolver of resolvers) {
       const r = resolver(e);
       if (r) {
         return r;

package/src/fetch/createFetchWith.ts

@@ -1,4 +1,4 @@
-import { MaybePromise } from '../asyncs/MaybePromise';
+import type { MaybePromise } from '../asyncs/MaybePromise';
 import { getGlobalThis } from '../runtime/getGlobalThis';
 import { type FetchLike } from './types';
 

package/src/fetch/createFetchWithRetry.ts

@@ -1,5 +1,5 @@
 import { getGlobalThis } from '../runtime/getGlobalThis';
-import { FetchLike } from './types';
+import type { FetchLike } from './types';
 
 type RequestDelayFunction = (attempt: number, error: Error | null, response: Response | null) => number;
 type RequestRetryOnFunction = (

package/src/index.ts

@@ -47,6 +47,8 @@ export { maybeFunction, type MaybeFunction } from './langs/MaybeFunction';
 export { memoize } from './langs/memoize';
 export { mixin } from './langs/mixin';
 export type { MixinFunction, MixinInstance, MixinReturnValue } from './langs/mixin';
+export { getObjectId } from './langs/getObjectId';
+export { getGlobalStates, setGlobalStates } from './langs/getGlobalStates';
 
 export { AsyncCloser } from './runtime/AsyncCloser';
 export { Closer } from './runtime/Closer';

package/src/io/ArrayBuffers.base64.test.ts

@@ -84,3 +84,10 @@ test('toBase64', () => {
   const buf = ArrayBuffers.from(text, 'utf8', Uint8Array);
   expect(ArrayBuffers.toBase64(buf)).toEqual('YW9ldQ==');
 });
+
+test('base64: utf8 string', () => {
+  const text = '你好';
+  // latin1 only
+  expect(() => btoa(text)).toThrow('Invalid character');
+  expect(ArrayBuffers.toBase64(text)).toEqual('5L2g5aW9');
+});