@choksheak/ts-utils 0.3.3 → 0.3.5

package/README.md

@@ -1,8 +1,14 @@
 # @choksheak/ts-utils
 
-This package is a random bunch of Typescript utilities that I have needed in almost every project that I have worked in. Hence making an easy way to share this code and also for my own personal and professional use. Feel free to use it in your own projects without any restrictions.
-
-The code supports full tree-shaking. Therefore your code will only grow in size by whatever you use. Any code that you are not using will not contribute to your code size.
+This package is a time-tested collection of Typescript utilities that I have
+personally needed in almost every project that I have worked in. Making this an
+open source, public npm package allows me to share this code freely with others
+as well as using it for my own personal and professional projects. Feel free to
+use it in your own projects without any restrictions.
+
+The code supports full tree-shaking. Therefore your code will only grow in size
+by whatever you use. Any code that you are not using will not contribute to
+your code size.
 
 Source code: https://github.com/choksheak/ts-utils
 

package/asNumber.cjs

@@ -23,15 +23,15 @@ __export(asNumber_exports, {
   asNumber: () => asNumber
 });
 module.exports = __toCommonJS(asNumber_exports);
-function asNumber(u) {
+function asNumber(u, defaultValue = 0) {
+  if (typeof u === "number") {
+    return isFinite(u) ? u : defaultValue;
+  }
+  u = Number(u);
   if (typeof u === "number" && isFinite(u)) {
     return u;
   }
-  const n = Number(u);
-  if (typeof n === "number" && isFinite(n)) {
-    return n;
-  }
-  return 0;
+  return defaultValue;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/asNumber.d.mts

@@ -1,6 +1,6 @@
 /**
  * Coerce `u` into a number if possible, otherwise just return 0.
  */
-declare function asNumber(u: unknown): number;
+declare function asNumber(u: unknown, defaultValue?: number): number;
 
 export { asNumber };

package/asNumber.d.ts

@@ -1,6 +1,6 @@
 /**
  * Coerce `u` into a number if possible, otherwise just return 0.
  */
-declare function asNumber(u: unknown): number;
+declare function asNumber(u: unknown, defaultValue?: number): number;
 
 export { asNumber };

package/asNumber.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var i=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var m=(e,n)=>{for(var t in n)i(e,t,{get:n[t],enumerable:!0})},s=(e,n,t,u)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of b(n))!f.call(e,r)&&r!==t&&i(e,r,{get:()=>n[r],enumerable:!(u=o(n,r))||u.enumerable});return e};var p=e=>s(i({},"__esModule",{value:!0}),e);var y={};m(y,{asNumber:()=>c});module.exports=p(y);function c(e){if(typeof e=="number"&&isFinite(e))return e;let n=Number(e);return typeof n=="number"&&isFinite(n)?n:0}0&&(module.exports={asNumber});
+"use strict";var t=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var p=(n,r)=>{for(var i in r)t(n,i,{get:r[i],enumerable:!0})},s=(n,r,i,b)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of o(r))!f.call(n,e)&&e!==i&&t(n,e,{get:()=>r[e],enumerable:!(b=m(r,e))||b.enumerable});return n};var y=n=>s(t({},"__esModule",{value:!0}),n);var N={};p(N,{asNumber:()=>F});module.exports=y(N);function F(n,r=0){return typeof n=="number"?isFinite(n)?n:r:(n=Number(n),typeof n=="number"&&isFinite(n)?n:r)}0&&(module.exports={asNumber});
 //# sourceMappingURL=asNumber.min.cjs.map

package/asNumber.min.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/asNumber.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // No transformation needed if u is already a number.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Try to make into a number if possible.\n  const n = Number(u);\n  if (typeof n === \"number\" && isFinite(n)) {\n    return n;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GAGO,SAASE,EAASE,EAAoB,CAE3C,GAAI,OAAOA,GAAM,UAAY,SAASA,CAAC,EACrC,OAAOA,EAIT,IAAM,EAAI,OAAOA,CAAC,EAClB,OAAI,OAAO,GAAM,UAAY,SAAS,CAAC,EAC9B,EAKF,CACT","names":["asNumber_exports","__export","asNumber","__toCommonJS","u"]}
+{"version":3,"sources":["../src/asNumber.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GAGO,SAASE,EAASE,EAAYC,EAAe,EAAW,CAE7D,OAAI,OAAOD,GAAM,SACR,SAASA,CAAC,EAAIA,EAAIC,GAI3BD,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKFC,EACT","names":["asNumber_exports","__export","asNumber","__toCommonJS","u","defaultValue"]}

package/asNumber.min.mjs

@@ -1,2 +1,2 @@
-function r(n){if(typeof n=="number"&&isFinite(n))return n;let e=Number(n);return typeof e=="number"&&isFinite(e)?e:0}export{r as asNumber};
+function e(n,r=0){return typeof n=="number"?isFinite(n)?n:r:(n=Number(n),typeof n=="number"&&isFinite(n)?n:r)}export{e as asNumber};
 //# sourceMappingURL=asNumber.min.mjs.map

package/asNumber.min.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/asNumber.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown): number {\n  // No transformation needed if u is already a number.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Try to make into a number if possible.\n  const n = Number(u);\n  if (typeof n === \"number\" && isFinite(n)) {\n    return n;\n  }\n\n  // Return 0 for everything else. This is usually ok if want to just ignore\n  // all other noise.\n  return 0;\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAoB,CAE3C,GAAI,OAAOA,GAAM,UAAY,SAASA,CAAC,EACrC,OAAOA,EAIT,IAAMC,EAAI,OAAOD,CAAC,EAClB,OAAI,OAAOC,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKF,CACT","names":["asNumber","u","n"]}
+{"version":3,"sources":["../src/asNumber.ts"],"sourcesContent":["/**\n * Coerce `u` into a number if possible, otherwise just return 0.\n */\nexport function asNumber(u: unknown, defaultValue = 0): number {\n  // If u is a valid number, return it.\n  if (typeof u === \"number\") {\n    return isFinite(u) ? u : defaultValue;\n  }\n\n  // Try to make into a number if not already a number.\n  u = Number(u);\n\n  // If u is a valid number, return it.\n  if (typeof u === \"number\" && isFinite(u)) {\n    return u;\n  }\n\n  // Return `defaultValue` for everything else. This is usually ok if want to\n  // just ignore all other noise.\n  return defaultValue;\n}\n"],"mappings":"AAGO,SAASA,EAASC,EAAYC,EAAe,EAAW,CAE7D,OAAI,OAAOD,GAAM,SACR,SAASA,CAAC,EAAIA,EAAIC,GAI3BD,EAAI,OAAOA,CAAC,EAGR,OAAOA,GAAM,UAAY,SAASA,CAAC,EAC9BA,EAKFC,EACT","names":["asNumber","u","defaultValue"]}

package/asNumber.mjs

@@ -1,13 +1,13 @@
 // src/asNumber.ts
-function asNumber(u) {
+function asNumber(u, defaultValue = 0) {
+  if (typeof u === "number") {
+    return isFinite(u) ? u : defaultValue;
+  }
+  u = Number(u);
   if (typeof u === "number" && isFinite(u)) {
     return u;
   }
-  const n = Number(u);
-  if (typeof n === "number" && isFinite(n)) {
-    return n;
-  }
-  return 0;
+  return defaultValue;
 }
 export {
   asNumber

package/capLength.cjs

@@ -0,0 +1,80 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/capLength.ts
+var capLength_exports = {};
+__export(capLength_exports, {
+  capLength: () => capLength
+});
+module.exports = __toCommonJS(capLength_exports);
+
+// src/toReadableString.ts
+function toReadableString(u, options) {
+  if (typeof u === "string") {
+    return u;
+  }
+  if (u instanceof Error) {
+    const error = u;
+    let result = "";
+    const errorName = error.name || "Error";
+    const errorMessage = error.message || "An error occurred with no message provided.";
+    result += `${errorName}: ${errorMessage}`;
+    if (options?.includeStack && error.stack) {
+      const stack = error.stack.replace(new RegExp(`^${errorName}:.*\\n?`), "").trim();
+      if (stack) {
+        result += `
+Stack Trace:
+${stack}`;
+      }
+    }
+    if (options?.includeErrorProps) {
+      const customProps = error;
+      const additionalInfo = Object.keys(customProps).filter(
+        (key) => key !== "name" && key !== "message" && key !== "stack" && typeof customProps[key] !== "function" && typeof customProps[key] !== "object"
+      ).map((key) => `
+- ${key}: ${customProps[key]}`);
+      if (additionalInfo.length > 0) {
+        result += `
+Additional Data:${additionalInfo.join("")}`;
+      }
+    }
+    return result;
+  }
+  if (u !== null && typeof u === "object" && u.toString !== Object.prototype.toString) {
+    return u.toString();
+  }
+  try {
+    return JSON.stringify(u);
+  } catch {
+    return String(u);
+  }
+}
+
+// src/capLength.ts
+function capLength(u, maxLength = 400) {
+  const s = toReadableString(u);
+  if (s.length <= maxLength) {
+    return s;
+  }
+  return s.slice(0, maxLength) + ` ... (${s.length - maxLength} more)`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  capLength
+});

package/capLength.d.mts

@@ -0,0 +1,3 @@
+declare function capLength(u: unknown, maxLength?: number): string;
+
+export { capLength };

package/capLength.d.ts

@@ -0,0 +1,3 @@
+declare function capLength(u: unknown, maxLength?: number): string;
+
+export { capLength };

package/capLength.min.cjs

@@ -0,0 +1,6 @@
+"use strict";var s=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var u=(r,t)=>{for(var n in t)s(r,n,{get:t[n],enumerable:!0})},m=(r,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of p(t))!d.call(r,e)&&e!==n&&s(r,e,{get:()=>t[e],enumerable:!(i=g(t,e))||i.enumerable});return r};var S=r=>m(s({},"__esModule",{value:!0}),r);var $={};u($,{capLength:()=>b});module.exports=S($);function f(r,t){if(typeof r=="string")return r;if(r instanceof Error){let n=r,i="",e=n.name||"Error",l=n.message||"An error occurred with no message provided.";if(i+=`${e}: ${l}`,t?.includeStack&&n.stack){let c=n.stack.replace(new RegExp(`^${e}:.*\\n?`),"").trim();c&&(i+=`
+Stack Trace:
+${c}`)}if(t?.includeErrorProps){let c=n,a=Object.keys(c).filter(o=>o!=="name"&&o!=="message"&&o!=="stack"&&typeof c[o]!="function"&&typeof c[o]!="object").map(o=>`
+- ${o}: ${c[o]}`);a.length>0&&(i+=`
+Additional Data:${a.join("")}`)}return i}if(r!==null&&typeof r=="object"&&r.toString!==Object.prototype.toString)return r.toString();try{return JSON.stringify(r)}catch{return String(r)}}function b(r,t=400){let n=f(r);return n.length<=t?n:n.slice(0,t)+` ... (${n.length-t} more)`}0&&(module.exports={capLength});
+//# sourceMappingURL=capLength.min.cjs.map

package/capLength.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/capLength.ts","../src/toReadableString.ts"],"sourcesContent":["import { toReadableString } from \"./toReadableString\";\n\nexport function capLength(u: unknown, maxLength = 400): string {\n  const s = toReadableString(u);\n\n  if (s.length <= maxLength) {\n    return s;\n  }\n\n  return s.slice(0, maxLength) + ` ... (${s.length - maxLength} more)`;\n}\n","/**\n * Make the given argument of unknown type into something human-readable.\n * For Error objects, you can specify options to make the string more verbose.\n */\nexport function toReadableString(\n  u: unknown,\n  options?: { includeStack?: boolean; includeErrorProps?: boolean },\n): string {\n  if (typeof u === \"string\") {\n    return u;\n  }\n\n  if (u instanceof Error) {\n    const error = u as Error;\n    let result = \"\";\n\n    // Always include the name and message\n    const errorName = error.name || \"Error\";\n    const errorMessage =\n      error.message || \"An error occurred with no message provided.\";\n\n    result += `${errorName}: ${errorMessage}`;\n\n    // Optionally include the stack trace\n    if (options?.includeStack && error.stack) {\n      // Clean up the stack trace to start on a new line,\n      // removing potential duplicate header lines if the browser adds them.\n      const stack = error.stack\n        // Remove the first line if it duplicates the name/message\n        .replace(new RegExp(`^${errorName}:.*\\\\n?`), \"\")\n        .trim();\n\n      if (stack) {\n        result += `\\nStack Trace:\\n${stack}`;\n      }\n    }\n\n    // Add any potential custom error properties (e.g., HTTP status code)\n    if (options?.includeErrorProps) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const customProps: { [key: string]: unknown } = error as any;\n\n      const additionalInfo = Object.keys(customProps)\n        .filter(\n          (key) =>\n            key !== \"name\" &&\n            key !== \"message\" &&\n            key !== \"stack\" &&\n            typeof customProps[key] !== \"function\" &&\n            typeof customProps[key] !== \"object\",\n        )\n        .map((key) => `\\n- ${key}: ${customProps[key]}`);\n\n      if (additionalInfo.length > 0) {\n        result += `\\nAdditional Data:${additionalInfo.join(\"\")}`;\n      }\n    }\n\n    return result;\n  }\n\n  // If the object has a custom toString(), then use it.\n  if (\n    u !== null &&\n    typeof u === \"object\" &&\n    u.toString !== Object.prototype.toString\n  ) {\n    return u.toString();\n  }\n\n  try {\n    // Attempt to JSON stringify the object for inspection.\n    return JSON.stringify(u);\n  } catch {\n    // Fallback if the object cannot be stringified (e.g., circular references).\n    return String(u);\n  }\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,eAAAE,IAAA,eAAAC,EAAAH,GCIO,SAASI,EACdC,EACAC,EACQ,CACR,GAAI,OAAOD,GAAM,SACf,OAAOA,EAGT,GAAIA,aAAa,MAAO,CACtB,IAAME,EAAQF,EACVG,EAAS,GAGPC,EAAYF,EAAM,MAAQ,QAC1BG,EACJH,EAAM,SAAW,8CAKnB,GAHAC,GAAU,GAAGC,CAAS,KAAKC,CAAY,GAGnCJ,GAAS,cAAgBC,EAAM,MAAO,CAGxC,IAAMI,EAAQJ,EAAM,MAEjB,QAAQ,IAAI,OAAO,IAAIE,CAAS,SAAS,EAAG,EAAE,EAC9C,KAAK,EAEJE,IACFH,GAAU;AAAA;AAAA,EAAmBG,CAAK,GAEtC,CAGA,GAAIL,GAAS,kBAAmB,CAE9B,IAAMM,EAA0CL,EAE1CM,EAAiB,OAAO,KAAKD,CAAW,EAC3C,OACEE,GACCA,IAAQ,QACRA,IAAQ,WACRA,IAAQ,SACR,OAAOF,EAAYE,CAAG,GAAM,YAC5B,OAAOF,EAAYE,CAAG,GAAM,QAChC,EACC,IAAKA,GAAQ;AAAA,IAAOA,CAAG,KAAKF,EAAYE,CAAG,CAAC,EAAE,EAE7CD,EAAe,OAAS,IAC1BL,GAAU;AAAA,kBAAqBK,EAAe,KAAK,EAAE,CAAC,GAE1D,CAEA,OAAOL,CACT,CAGA,GACEH,IAAM,MACN,OAAOA,GAAM,UACbA,EAAE,WAAa,OAAO,UAAU,SAEhC,OAAOA,EAAE,SAAS,EAGpB,GAAI,CAEF,OAAO,KAAK,UAAUA,CAAC,CACzB,MAAQ,CAEN,OAAO,OAAOA,CAAC,CACjB,CACF,CD3EO,SAASU,EAAUC,EAAYC,EAAY,IAAa,CAC7D,IAAMC,EAAIC,EAAiBH,CAAC,EAE5B,OAAIE,EAAE,QAAUD,EACPC,EAGFA,EAAE,MAAM,EAAGD,CAAS,EAAI,SAASC,EAAE,OAASD,CAAS,QAC9D","names":["capLength_exports","__export","capLength","__toCommonJS","toReadableString","u","options","error","result","errorName","errorMessage","stack","customProps","additionalInfo","key","capLength","u","maxLength","s","toReadableString"]}

package/capLength.min.mjs

@@ -0,0 +1,6 @@
+function a(r,o){if(typeof r=="string")return r;if(r instanceof Error){let t=r,i="",c=t.name||"Error",f=t.message||"An error occurred with no message provided.";if(i+=`${c}: ${f}`,o?.includeStack&&t.stack){let e=t.stack.replace(new RegExp(`^${c}:.*\\n?`),"").trim();e&&(i+=`
+Stack Trace:
+${e}`)}if(o?.includeErrorProps){let e=t,s=Object.keys(e).filter(n=>n!=="name"&&n!=="message"&&n!=="stack"&&typeof e[n]!="function"&&typeof e[n]!="object").map(n=>`
+- ${n}: ${e[n]}`);s.length>0&&(i+=`
+Additional Data:${s.join("")}`)}return i}if(r!==null&&typeof r=="object"&&r.toString!==Object.prototype.toString)return r.toString();try{return JSON.stringify(r)}catch{return String(r)}}function p(r,o=400){let t=a(r);return t.length<=o?t:t.slice(0,o)+` ... (${t.length-o} more)`}export{p as capLength};
+//# sourceMappingURL=capLength.min.mjs.map

package/capLength.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toReadableString.ts","../src/capLength.ts"],"sourcesContent":["/**\n * Make the given argument of unknown type into something human-readable.\n * For Error objects, you can specify options to make the string more verbose.\n */\nexport function toReadableString(\n  u: unknown,\n  options?: { includeStack?: boolean; includeErrorProps?: boolean },\n): string {\n  if (typeof u === \"string\") {\n    return u;\n  }\n\n  if (u instanceof Error) {\n    const error = u as Error;\n    let result = \"\";\n\n    // Always include the name and message\n    const errorName = error.name || \"Error\";\n    const errorMessage =\n      error.message || \"An error occurred with no message provided.\";\n\n    result += `${errorName}: ${errorMessage}`;\n\n    // Optionally include the stack trace\n    if (options?.includeStack && error.stack) {\n      // Clean up the stack trace to start on a new line,\n      // removing potential duplicate header lines if the browser adds them.\n      const stack = error.stack\n        // Remove the first line if it duplicates the name/message\n        .replace(new RegExp(`^${errorName}:.*\\\\n?`), \"\")\n        .trim();\n\n      if (stack) {\n        result += `\\nStack Trace:\\n${stack}`;\n      }\n    }\n\n    // Add any potential custom error properties (e.g., HTTP status code)\n    if (options?.includeErrorProps) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const customProps: { [key: string]: unknown } = error as any;\n\n      const additionalInfo = Object.keys(customProps)\n        .filter(\n          (key) =>\n            key !== \"name\" &&\n            key !== \"message\" &&\n            key !== \"stack\" &&\n            typeof customProps[key] !== \"function\" &&\n            typeof customProps[key] !== \"object\",\n        )\n        .map((key) => `\\n- ${key}: ${customProps[key]}`);\n\n      if (additionalInfo.length > 0) {\n        result += `\\nAdditional Data:${additionalInfo.join(\"\")}`;\n      }\n    }\n\n    return result;\n  }\n\n  // If the object has a custom toString(), then use it.\n  if (\n    u !== null &&\n    typeof u === \"object\" &&\n    u.toString !== Object.prototype.toString\n  ) {\n    return u.toString();\n  }\n\n  try {\n    // Attempt to JSON stringify the object for inspection.\n    return JSON.stringify(u);\n  } catch {\n    // Fallback if the object cannot be stringified (e.g., circular references).\n    return String(u);\n  }\n}\n","import { toReadableString } from \"./toReadableString\";\n\nexport function capLength(u: unknown, maxLength = 400): string {\n  const s = toReadableString(u);\n\n  if (s.length <= maxLength) {\n    return s;\n  }\n\n  return s.slice(0, maxLength) + ` ... (${s.length - maxLength} more)`;\n}\n"],"mappings":"AAIO,SAASA,EACdC,EACAC,EACQ,CACR,GAAI,OAAOD,GAAM,SACf,OAAOA,EAGT,GAAIA,aAAa,MAAO,CACtB,IAAME,EAAQF,EACVG,EAAS,GAGPC,EAAYF,EAAM,MAAQ,QAC1BG,EACJH,EAAM,SAAW,8CAKnB,GAHAC,GAAU,GAAGC,CAAS,KAAKC,CAAY,GAGnCJ,GAAS,cAAgBC,EAAM,MAAO,CAGxC,IAAMI,EAAQJ,EAAM,MAEjB,QAAQ,IAAI,OAAO,IAAIE,CAAS,SAAS,EAAG,EAAE,EAC9C,KAAK,EAEJE,IACFH,GAAU;AAAA;AAAA,EAAmBG,CAAK,GAEtC,CAGA,GAAIL,GAAS,kBAAmB,CAE9B,IAAMM,EAA0CL,EAE1CM,EAAiB,OAAO,KAAKD,CAAW,EAC3C,OACEE,GACCA,IAAQ,QACRA,IAAQ,WACRA,IAAQ,SACR,OAAOF,EAAYE,CAAG,GAAM,YAC5B,OAAOF,EAAYE,CAAG,GAAM,QAChC,EACC,IAAKA,GAAQ;AAAA,IAAOA,CAAG,KAAKF,EAAYE,CAAG,CAAC,EAAE,EAE7CD,EAAe,OAAS,IAC1BL,GAAU;AAAA,kBAAqBK,EAAe,KAAK,EAAE,CAAC,GAE1D,CAEA,OAAOL,CACT,CAGA,GACEH,IAAM,MACN,OAAOA,GAAM,UACbA,EAAE,WAAa,OAAO,UAAU,SAEhC,OAAOA,EAAE,SAAS,EAGpB,GAAI,CAEF,OAAO,KAAK,UAAUA,CAAC,CACzB,MAAQ,CAEN,OAAO,OAAOA,CAAC,CACjB,CACF,CC3EO,SAASU,EAAUC,EAAYC,EAAY,IAAa,CAC7D,IAAMC,EAAIC,EAAiBH,CAAC,EAE5B,OAAIE,EAAE,QAAUD,EACPC,EAGFA,EAAE,MAAM,EAAGD,CAAS,EAAI,SAASC,EAAE,OAASD,CAAS,QAC9D","names":["toReadableString","u","options","error","result","errorName","errorMessage","stack","customProps","additionalInfo","key","capLength","u","maxLength","s","toReadableString"]}

package/capLength.mjs

@@ -0,0 +1,53 @@
+// src/toReadableString.ts
+function toReadableString(u, options) {
+  if (typeof u === "string") {
+    return u;
+  }
+  if (u instanceof Error) {
+    const error = u;
+    let result = "";
+    const errorName = error.name || "Error";
+    const errorMessage = error.message || "An error occurred with no message provided.";
+    result += `${errorName}: ${errorMessage}`;
+    if (options?.includeStack && error.stack) {
+      const stack = error.stack.replace(new RegExp(`^${errorName}:.*\\n?`), "").trim();
+      if (stack) {
+        result += `
+Stack Trace:
+${stack}`;
+      }
+    }
+    if (options?.includeErrorProps) {
+      const customProps = error;
+      const additionalInfo = Object.keys(customProps).filter(
+        (key) => key !== "name" && key !== "message" && key !== "stack" && typeof customProps[key] !== "function" && typeof customProps[key] !== "object"
+      ).map((key) => `
+- ${key}: ${customProps[key]}`);
+      if (additionalInfo.length > 0) {
+        result += `
+Additional Data:${additionalInfo.join("")}`;
+      }
+    }
+    return result;
+  }
+  if (u !== null && typeof u === "object" && u.toString !== Object.prototype.toString) {
+    return u.toString();
+  }
+  try {
+    return JSON.stringify(u);
+  } catch {
+    return String(u);
+  }
+}
+
+// src/capLength.ts
+function capLength(u, maxLength = 400) {
+  const s = toReadableString(u);
+  if (s.length <= maxLength) {
+    return s;
+  }
+  return s.slice(0, maxLength) + ` ... (${s.length - maxLength} more)`;
+}
+export {
+  capLength
+};

package/{iterators.cjs → concatIterators.cjs}

@@ -17,12 +17,12 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/iterators.ts
-var iterators_exports = {};
-__export(iterators_exports, {
+// src/concatIterators.ts
+var concatIterators_exports = {};
+__export(concatIterators_exports, {
   concatIterators: () => concatIterators
 });
-module.exports = __toCommonJS(iterators_exports);
+module.exports = __toCommonJS(concatIterators_exports);
 function* concatIterators(...iterators) {
   for (const iterator of iterators) {
     yield* iterator;

package/{iterators.min.cjs → concatIterators.min.cjs}

@@ -1,2 +1,2 @@
 "use strict";var n=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var i=Object.prototype.hasOwnProperty;var s=(t,o)=>{for(var e in o)n(t,e,{get:o[e],enumerable:!0})},T=(t,o,e,a)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of f(o))!i.call(t,r)&&r!==e&&n(t,r,{get:()=>o[r],enumerable:!(a=c(o,r))||a.enumerable});return t};var d=t=>T(n({},"__esModule",{value:!0}),t);var p={};s(p,{concatIterators:()=>l});module.exports=d(p);function*l(...t){for(let o of t)yield*o}0&&(module.exports={concatIterators});
-//# sourceMappingURL=iterators.min.cjs.map
+//# sourceMappingURL=concatIterators.min.cjs.map

package/concatIterators.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/concatIterators.ts"],"sourcesContent":["/** Memory-efficient way to concat two or more iterators. */\nexport function* concatIterators<T>(...iterators: Generator<T>[]) {\n  for (const iterator of iterators) {\n    yield* iterator;\n  }\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,qBAAAE,IAAA,eAAAC,EAAAH,GACO,SAAUE,KAAsBE,EAA2B,CAChE,QAAWC,KAAYD,EACrB,MAAOC,CAEX","names":["concatIterators_exports","__export","concatIterators","__toCommonJS","iterators","iterator"]}

package/{iterators.min.mjs → concatIterators.min.mjs}

@@ -1,2 +1,2 @@
 function*r(...o){for(let t of o)yield*t}export{r as concatIterators};
-//# sourceMappingURL=iterators.min.mjs.map
+//# sourceMappingURL=concatIterators.min.mjs.map

package/concatIterators.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/concatIterators.ts"],"sourcesContent":["/** Memory-efficient way to concat two or more iterators. */\nexport function* concatIterators<T>(...iterators: Generator<T>[]) {\n  for (const iterator of iterators) {\n    yield* iterator;\n  }\n}\n"],"mappings":"AACO,SAAUA,KAAsBC,EAA2B,CAChE,QAAWC,KAAYD,EACrB,MAAOC,CAEX","names":["concatIterators","iterators","iterator"]}

package/{iterators.mjs → concatIterators.mjs}

@@ -1,4 +1,4 @@
-// src/iterators.ts
+// src/concatIterators.ts
 function* concatIterators(...iterators) {
   for (const iterator of iterators) {
     yield* iterator;

package/duration.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var c=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var P=(o,n)=>{for(var t in n)c(o,t,{get:n[t],enumerable:!0})},T=(o,n,t,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of y(n))!g.call(o,r)&&r!==t&&c(o,r,{get:()=>n[r],enumerable:!(e=R(n,r))||e.enumerable});return o};var U=o=>T(c({},"__esModule",{value:!0}),o);var H={};P(H,{DURATION_STYLE_SUFFIX_MAP:()=>D,DURATION_TYPE_SEQUENCE:()=>S,durationOrMsToMs:()=>w,durationToMs:()=>x,elapsed:()=>C,formatDuration:()=>M,msToDuration:()=>m,readableDuration:()=>d});module.exports=U(H);var S=["days","hours","minutes","seconds","milliseconds"],D={days:{short:"day",shorts:"days",long:"day",longs:"days",narrow:"d"},hours:{short:"hr",shorts:"hrs",long:"hour",longs:"hours",narrow:"h"},minutes:{short:"min",shorts:"mins",long:"minute",longs:"minutes",narrow:"m"},seconds:{short:"sec",shorts:"secs",long:"second",longs:"seconds",narrow:"s"},milliseconds:{short:"ms",shorts:"ms",long:"millisecond",longs:"milliseconds",narrow:"ms"}};function b(o){return o=="short"?"shorts":o==="long"?"longs":o}function I(o){return o==="narrow"?"":" "}function A(o){return o==="narrow"?" ":", "}function m(o,n){if(o===0)return n=n??"milliseconds",{[n]:0};let t={};for(let e=0;e<1;e++){let r=Math.floor(o/1e3),u=o-r*1e3;if(u>0&&(t.milliseconds=u),r===0)break;let i=Math.floor(r/60);if(r-=i*60,r>0&&(t.seconds=r),i===0)break;let s=Math.floor(i/60);if(i-=s*60,i>0&&(t.minutes=i),s===0)break;let a=Math.floor(s/24);s-=a*24,s>0&&(t.hours=s),a>0&&(t.days=a)}return t}function x(o){let n=(o.days??0)*864e5,t=(o.hours??0)*36e5,e=(o.minutes??0)*6e4,r=(o.seconds??0)*1e3,u=o.milliseconds??0;return n+t+e+r+u}function w(o){return typeof o=="number"?o:x(o)}function M(o,n){n=n??"short";let t=b(n),e=I(n),r=[];for(let i of S){let s=o[i];if(s===void 0)continue;let a=D[i],h=s===1?a[n]:a[t];r.push(s+e+h)}let u=A(n);return r.join(u)}function d(o,n){let t=m(o,n?.durationTypeForZero);return M(t,n?.style)}function C(o){return o>6e4?d(o):o>100?`${(o/1e3).toFixed(3)}s`:o+"ms"}0&&(module.exports={DURATION_STYLE_SUFFIX_MAP,DURATION_TYPE_SEQUENCE,durationOrMsToMs,durationToMs,elapsed,formatDuration,msToDuration,readableDuration});
+"use strict";var l=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var x=(o,n)=>{for(var r in n)l(o,r,{get:n[r],enumerable:!0})},_=(o,n,r,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of S(n))!M.call(o,t)&&t!==r&&l(o,t,{get:()=>n[t],enumerable:!(e=g(n,t))||e.enumerable});return o};var T=o=>_(l({},"__esModule",{value:!0}),o);var I={};x(I,{DURATION_STYLE_SUFFIX_MAP:()=>p,DURATION_TYPE_SEQUENCE:()=>f,durationOrMsToMs:()=>O,durationToMs:()=>D,elapsed:()=>A,formatDuration:()=>d,msToDuration:()=>m,readableDuration:()=>h});module.exports=T(I);var f=["days","hours","minutes","seconds","milliseconds"],p={days:{short:"day",shorts:"days",long:"day",longs:"days",narrow:"d"},hours:{short:"hr",shorts:"hrs",long:"hour",longs:"hours",narrow:"h"},minutes:{short:"min",shorts:"mins",long:"minute",longs:"minutes",narrow:"m"},seconds:{short:"sec",shorts:"secs",long:"second",longs:"seconds",narrow:"s"},milliseconds:{short:"ms",shorts:"ms",long:"millisecond",longs:"milliseconds",narrow:"ms"}};function U(o){return o=="short"?"shorts":o==="long"?"longs":o}function w(o){return o==="narrow"?"":" "}function N(o){return o==="narrow"?" ":", "}function m(o,n){if(o===0)return n=n??"milliseconds",{[n]:0};let r={};for(let e=0;e<1;e++){let t=Math.floor(o/1e3),u=o-t*1e3;if(u>0&&(r.milliseconds=u),t===0)break;let i=Math.floor(t/60);if(t-=i*60,t>0&&(r.seconds=t),i===0)break;let s=Math.floor(i/60);if(i-=s*60,i>0&&(r.minutes=i),s===0)break;let a=Math.floor(s/24);s-=a*24,s>0&&(r.hours=s),a>0&&(r.days=a)}return r}function D(o){let n=(o.days??0)*864e5,r=(o.hours??0)*36e5,e=(o.minutes??0)*6e4,t=(o.seconds??0)*1e3,u=o.milliseconds??0;return n+r+e+t+u}function O(o){return typeof o=="number"?o:D(o)}function d(o,n){n=n??"short";let r=U(n),e=w(n),t=[];for(let i of f){let s=o[i];if(s===void 0)continue;let a=p[i],y=s===1?a[n]:a[r];t.push(s+e+y)}let u=N(n);return t.join(u)}function h(o,n){let r=m(o,n?.durationTypeForZero);return d(r,n?.style)}function A(o){return o>6e4?h(o):o>100?`${(o/1e3).toFixed(3)}s`:o+"ms"}0&&(module.exports={DURATION_STYLE_SUFFIX_MAP,DURATION_TYPE_SEQUENCE,durationOrMsToMs,durationToMs,elapsed,formatDuration,msToDuration,readableDuration});
 //# sourceMappingURL=duration.min.cjs.map

package/duration.min.mjs

@@ -1,2 +1,2 @@
-var m=["days","hours","minutes","seconds","milliseconds"],x={days:{short:"day",shorts:"days",long:"day",longs:"days",narrow:"d"},hours:{short:"hr",shorts:"hrs",long:"hour",longs:"hours",narrow:"h"},minutes:{short:"min",shorts:"mins",long:"minute",longs:"minutes",narrow:"m"},seconds:{short:"sec",shorts:"secs",long:"second",longs:"seconds",narrow:"s"},milliseconds:{short:"ms",shorts:"ms",long:"millisecond",longs:"milliseconds",narrow:"ms"}};function M(o){return o=="short"?"shorts":o==="long"?"longs":o}function d(o){return o==="narrow"?"":" "}function h(o){return o==="narrow"?" ":", "}function R(o,n){if(o===0)return n=n??"milliseconds",{[n]:0};let t={};for(let i=0;i<1;i++){let r=Math.floor(o/1e3),u=o-r*1e3;if(u>0&&(t.milliseconds=u),r===0)break;let e=Math.floor(r/60);if(r-=e*60,r>0&&(t.seconds=r),e===0)break;let s=Math.floor(e/60);if(e-=s*60,e>0&&(t.minutes=e),s===0)break;let a=Math.floor(s/24);s-=a*24,s>0&&(t.hours=s),a>0&&(t.days=a)}return t}function y(o){let n=(o.days??0)*864e5,t=(o.hours??0)*36e5,i=(o.minutes??0)*6e4,r=(o.seconds??0)*1e3,u=o.milliseconds??0;return n+t+i+r+u}function N(o){return typeof o=="number"?o:y(o)}function g(o,n){n=n??"short";let t=M(n),i=d(n),r=[];for(let e of m){let s=o[e];if(s===void 0)continue;let a=x[e],f=s===1?a[n]:a[t];r.push(s+i+f)}let u=h(n);return r.join(u)}function P(o,n){let t=R(o,n?.durationTypeForZero);return g(t,n?.style)}function O(o){return o>6e4?P(o):o>100?`${(o/1e3).toFixed(3)}s`:o+"ms"}export{x as DURATION_STYLE_SUFFIX_MAP,m as DURATION_TYPE_SEQUENCE,N as durationOrMsToMs,y as durationToMs,O as elapsed,g as formatDuration,R as msToDuration,P as readableDuration};
+var d=["days","hours","minutes","seconds","milliseconds"],h={days:{short:"day",shorts:"days",long:"day",longs:"days",narrow:"d"},hours:{short:"hr",shorts:"hrs",long:"hour",longs:"hours",narrow:"h"},minutes:{short:"min",shorts:"mins",long:"minute",longs:"minutes",narrow:"m"},seconds:{short:"sec",shorts:"secs",long:"second",longs:"seconds",narrow:"s"},milliseconds:{short:"ms",shorts:"ms",long:"millisecond",longs:"milliseconds",narrow:"ms"}};function y(o){return o=="short"?"shorts":o==="long"?"longs":o}function g(o){return o==="narrow"?"":" "}function S(o){return o==="narrow"?" ":", "}function M(o,n){if(o===0)return n=n??"milliseconds",{[n]:0};let r={};for(let i=0;i<1;i++){let t=Math.floor(o/1e3),u=o-t*1e3;if(u>0&&(r.milliseconds=u),t===0)break;let e=Math.floor(t/60);if(t-=e*60,t>0&&(r.seconds=t),e===0)break;let s=Math.floor(e/60);if(e-=s*60,e>0&&(r.minutes=e),s===0)break;let a=Math.floor(s/24);s-=a*24,s>0&&(r.hours=s),a>0&&(r.days=a)}return r}function x(o){let n=(o.days??0)*864e5,r=(o.hours??0)*36e5,i=(o.minutes??0)*6e4,t=(o.seconds??0)*1e3,u=o.milliseconds??0;return n+r+i+t+u}function R(o){return typeof o=="number"?o:x(o)}function _(o,n){n=n??"short";let r=y(n),i=g(n),t=[];for(let e of d){let s=o[e];if(s===void 0)continue;let a=h[e],c=s===1?a[n]:a[r];t.push(s+i+c)}let u=S(n);return t.join(u)}function T(o,n){let r=M(o,n?.durationTypeForZero);return _(r,n?.style)}function P(o){return o>6e4?T(o):o>100?`${(o/1e3).toFixed(3)}s`:o+"ms"}export{h as DURATION_STYLE_SUFFIX_MAP,d as DURATION_TYPE_SEQUENCE,R as durationOrMsToMs,x as durationToMs,P as elapsed,_ as formatDuration,M as msToDuration,T as readableDuration};
 //# sourceMappingURL=duration.min.mjs.map