@dxos/util 0.8.4-main.ae835ea → 0.8.4-main.bc674ce

package/dist/lib/browser/index.mjs

@@ -97,16 +97,24 @@ var intersectBy = (arrays, selector) => {
     return lookups.every((lookup) => lookup.has(key));
   });
 };
+var coerceArray = (arr) => {
+  if (arr === void 0) {
+    return [];
+  }
+  return Array.isArray(arr) ? arr : [
+    arr
+  ];
+};
 
 // src/assume.ts
 function assumeType(value) {
 }
 
 // src/binder.ts
-import util from "@dxos/node-std/util";
+import { promisify } from "@dxos/node-std/util";
 var createBinder = (obj) => ({
   fn: (fn) => fn.bind(obj),
-  async: (fn) => util.promisify(fn.bind(obj))
+  async: (fn) => promisify(fn.bind(obj))
 });
 
 // src/bitfield.ts
@@ -596,11 +604,8 @@ var getDeep = (obj, path) => {
 // src/defer-function.ts
 var deferFunction = (fnProvider) => (...args) => fnProvider()(...args);
 
-// src/explicit-resource-management-polyfill.ts
-Symbol.dispose ??= Symbol("Symbol.dispose");
-Symbol.asyncDispose ??= Symbol("Symbol.asyncDispose");
-
 // src/defer.ts
+import "@hazae41/symbol-dispose-polyfill";
 var defer = (fn) => new DeferGuard(fn);
 var DeferGuard = class {
   _fn;
@@ -661,6 +666,12 @@ var MapEntry = class {
   }
 };
 
+// src/filename.ts
+var createFilename = ({ parts = [], ext, date = /* @__PURE__ */ new Date() }) => [
+  date.toISOString().replace(/[:.]/g, "-"),
+  ...parts
+].join("_") + (ext ? `.${ext}` : "");
+
 // src/for-each-async.ts
 var forEachAsync = (items, fn) => Promise.all(items.map(fn));
 
@@ -1356,7 +1367,18 @@ var omit = (obj, keys2) => {
 
 // src/platform.ts
 var isNode = () => typeof process !== "undefined" && process.versions != null && process.versions.node != null;
-var mobileAndTabletCheck = () => {
+var isBun = () => globalThis.Bun !== void 0;
+var isTauri = () => !!globalThis.__TAURI__;
+var isMobile = () => {
+  let check = false;
+  (function(a) {
+    if (/(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|iris|kindle|lge |maemo|midp|mmp|mobile.+firefox|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows ce|xda|xiino/i.test(a) || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(a.substr(0, 4))) {
+      check = true;
+    }
+  })(navigator.userAgent || navigator.vendor || window.opera);
+  return check;
+};
+var isMobileOrTablet = () => {
   let check = false;
   ((a) => {
     if (/(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|iris|kindle|lge |maemo|midp|mmp|mobile.+firefox|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows ce|xda|xiino|android|ipad|playbook|silk/i.test(a) || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(a.substr(0, 4))) {
@@ -1585,31 +1607,115 @@ var safeInstanceof = (tag) => (target) => {
 };
 
 // src/safe-parse.ts
-var safeParseInt = (value, defaultValue) => {
+function safeParseInt(str, defaultValue) {
   try {
-    const n = parseInt(value ?? "");
-    return isNaN(n) ? defaultValue : n;
+    const value = parseInt(str ?? "");
+    return isNaN(value) ? defaultValue : value;
   } catch {
     return defaultValue;
   }
-};
-var safeParseFloat = (str, defaultValue) => {
+}
+function safeParseFloat(str, defaultValue) {
   try {
-    return parseFloat(str);
+    const value = parseFloat(str ?? "");
+    return isNaN(value) ? defaultValue : value;
   } catch {
-    return defaultValue ?? 0;
+    return defaultValue;
   }
-};
-var safeParseJson = (data, defaultValue) => {
-  if (data && data.length > 0) {
+}
+var safeParseJson = (str, defaultValue) => {
+  if (str && str.length > 0) {
     try {
-      return JSON.parse(data);
+      return JSON.parse(str);
     } catch {
     }
   }
   return defaultValue;
 };
 
+// src/safe-stringify.ts
+var SKIP = Object.freeze({});
+function safeStringify(obj, filter = defaultFilter, indent = 2) {
+  const seen = /* @__PURE__ */ new WeakMap();
+  function replacer(key, value) {
+    try {
+      let path = key;
+      if (!key) {
+        path = "$";
+        return value;
+      } else if (this) {
+        const parentPath = seen.get(this);
+        path = parentPath ? `${parentPath}.${key}` : key;
+      }
+      if (value == null) {
+        return value;
+      }
+      if (typeof value === "function") {
+        return void 0;
+      }
+      if (typeof value === "object" && Object.getPrototypeOf(value) !== Object.prototype) {
+        return void 0;
+      }
+      if (typeof value === "object" && value !== null) {
+        const exists = seen.get(value);
+        if (exists) {
+          return `[${path} => ${exists}]`;
+        }
+        seen.set(value, path);
+      }
+      if (filter) {
+        const filteredValue = filter?.(key, value);
+        if (filteredValue !== void 0) {
+          return filteredValue === SKIP ? void 0 : filteredValue;
+        }
+      }
+      return value;
+    } catch (error) {
+      return `ERROR: ${error.message}`;
+    }
+  }
+  return JSON.stringify(obj, replacer, indent);
+}
+var createReplacer = ({ omit: omit2, parse, maxDepth, maxArrayLen, maxStringLen } = {}) => {
+  let currentDepth = 0;
+  const depthMap = /* @__PURE__ */ new WeakMap();
+  return function(key, value) {
+    if (key === "") {
+      currentDepth = 0;
+    } else if (this && typeof this === "object") {
+      const parentDepth = depthMap.get(this) ?? 0;
+      currentDepth = parentDepth + 1;
+    }
+    if (typeof value === "function") {
+      return SKIP;
+    }
+    if (value && typeof value === "object") {
+      depthMap.set(value, currentDepth);
+      if (maxDepth != null && currentDepth >= maxDepth) {
+        return Array.isArray(value) ? `[{ length: ${value.length} }]` : `{ keys: ${Object.keys(value).length} }`;
+      }
+    }
+    if (omit2?.includes(key)) {
+      return SKIP;
+    }
+    if (parse?.includes(key) && typeof value === "string") {
+      try {
+        return JSON.parse(value);
+      } catch {
+        return value;
+      }
+    }
+    if (maxArrayLen != null && Array.isArray(value) && value.length > maxArrayLen) {
+      return `[length: ${value.length}]`;
+    }
+    if (maxStringLen != null && typeof value === "string" && value.length > maxStringLen) {
+      return value.slice(0, maxStringLen) + "...";
+    }
+    return value;
+  };
+};
+var defaultFilter = createReplacer();
+
 // src/sliding-window-summary.ts
 import { invariant as invariant5 } from "@dxos/invariant";
 var __dxlog_file5 = "/__w/dxos/dxos/packages/common/util/src/sliding-window-summary.ts";
@@ -2045,69 +2151,112 @@ var arrayMove = (array, from, to) => {
   array.splice(to < 0 ? array.length + to : to, 0, array.splice(from, 1)[0]);
   return array;
 };
+function arraySwap(array, from, to) {
+  const current = array[from];
+  array[from] = array[to];
+  array[to] = current;
+  return array;
+}
 
 // src/unit.ts
-var Formatter = (unit) => {
-  return (n, precision = 2) => {
+var createFormat = (unit) => {
+  return (n, precision = unit.precision ?? 0) => {
     const value = n / unit.quotient;
-    return `${value.toFixed(precision)}${unit.symbol}`;
+    return {
+      unit,
+      value,
+      formattedValue: value.toFixed(precision),
+      toString: () => `${value.toFixed(precision)}${unit.symbol}`
+    };
   };
 };
+var MS_SECONDS = 1e3;
+var MS_MINUTES = 60 * MS_SECONDS;
+var MS_HOURS = 60 * MS_MINUTES;
 var Unit = {
-  // ms.
-  Hour: Formatter({
+  // General.
+  Percent: createFormat({
+    symbol: "%",
+    quotient: 1 / 100,
+    precision: 2
+  }),
+  Thousand: createFormat({
+    symbol: "k",
+    quotient: 1e3,
+    precision: 2
+  }),
+  // Bytes (note KB vs KiB).
+  Gigabyte: createFormat({
+    symbol: "GB",
+    quotient: 1e3 * 1e3 * 1e3,
+    precision: 2
+  }),
+  Megabyte: createFormat({
+    symbol: "MB",
+    quotient: 1e3 * 1e3,
+    precision: 2
+  }),
+  Kilobyte: createFormat({
+    symbol: "KB",
+    quotient: 1e3,
+    precision: 2
+  }),
+  Byte: createFormat({
+    symbol: "B",
+    quotient: 1
+  }),
+  // Time.
+  Hour: createFormat({
     symbol: "h",
-    quotient: 60 * 60 * 1e3
+    quotient: MS_HOURS
   }),
-  Minute: Formatter({
+  Minute: createFormat({
     symbol: "m",
-    quotient: 60 * 1e3
+    quotient: MS_MINUTES
   }),
-  Second: Formatter({
+  Second: createFormat({
     symbol: "s",
-    quotient: 1e3
+    quotient: MS_SECONDS,
+    precision: 1
   }),
-  Millisecond: Formatter({
+  Millisecond: createFormat({
     symbol: "ms",
     quotient: 1
   }),
   Duration: (n) => {
-    const hours = Math.floor(n / (60 * 60 * 1e3));
-    const minutes = Math.floor(n % (60 * 60 * 1e3) / (60 * 1e3));
+    const hours = Math.floor(n / MS_HOURS);
+    const minutes = Math.floor(n % MS_HOURS / MS_MINUTES);
     if (hours) {
-      return minutes ? `${hours}h ${minutes}m` : `${hours}h`;
+      const formattedValue = minutes ? `${hours}h ${minutes}m` : `${hours}h`;
+      return {
+        unit: {
+          symbol: "h",
+          quotient: MS_HOURS
+        },
+        value: hours,
+        formattedValue,
+        toString: () => formattedValue
+      };
     }
-    const seconds = Math.floor(n % (60 * 1e3) / 1e3);
     if (minutes) {
-      return seconds ? `${minutes}m ${seconds}s` : `${minutes}m`;
+      const seconds2 = (n - MS_MINUTES * minutes) / MS_SECONDS;
+      const formattedValue = seconds2 ? `${minutes}m ${seconds2}s` : `${minutes}m`;
+      return {
+        unit: {
+          symbol: "m",
+          quotient: MS_MINUTES
+        },
+        value: minutes,
+        formattedValue,
+        toString: () => formattedValue
+      };
     }
+    const seconds = n >= MS_SECONDS;
     if (seconds) {
-      return `${(n / 1e3).toFixed(1)}s`;
+      return Unit.Second(n);
     }
-    return `${n}ms`;
-  },
-  // bytes (note KB via KiB).
-  Gigabyte: Formatter({
-    symbol: "GB",
-    quotient: 1e3 * 1e3 * 1e3
-  }),
-  Megabyte: Formatter({
-    symbol: "MB",
-    quotient: 1e3 * 1e3
-  }),
-  Kilobyte: Formatter({
-    symbol: "KB",
-    quotient: 1e3
-  }),
-  // general.
-  Thousand: Formatter({
-    symbol: "k",
-    quotient: 1e3
-  }),
-  Percent: Formatter({
-    symbol: "%",
-    quotient: 1 / 100
-  })
+    return Unit.Millisecond(n);
+  }
 };
 
 // src/url.ts
@@ -2213,6 +2362,58 @@ var WeakDictionary = class {
     this._finalization.unregister(value);
   }
 };
+
+// src/error-format.ts
+var formatErrorWithCauses = (error) => {
+  const lines = [];
+  let current = error;
+  let level = 0;
+  while (current) {
+    const prefix = level === 0 ? "" : `Caused by: `;
+    lines.push(prefix + (current.stack ?? String(current)));
+    if (!(current.cause instanceof Error)) break;
+    current = current.cause;
+    level += 1;
+  }
+  return lines.join("\n\n");
+};
+
+// src/retry.ts
+var DEFAULT_RETRY_OPTIONS = {
+  count: 3,
+  delayMs: 100,
+  exponent: 2,
+  retryOnError: async () => true,
+  retryOnValue: async () => false
+};
+var retry = async (options, cb) => {
+  const fullOptions = {
+    ...DEFAULT_RETRY_OPTIONS,
+    ...options
+  };
+  let numRetries = 0, currentDelay = fullOptions.delayMs;
+  while (true) {
+    let result;
+    try {
+      result = await cb();
+    } catch (err) {
+      if (numRetries > fullOptions.count || !await fullOptions.retryOnError(err)) {
+        throw err;
+      }
+      await new Promise((resolve) => setTimeout(resolve, currentDelay));
+      currentDelay *= fullOptions.exponent;
+      numRetries++;
+      continue;
+    }
+    if (!await fullOptions.retryOnValue(result)) {
+      return result;
+    }
+    await new Promise((resolve) => setTimeout(resolve, currentDelay));
+    currentDelay *= fullOptions.exponent;
+    numRetries++;
+    continue;
+  }
+};
 export {
   BitField,
   Callback,
@@ -2222,12 +2423,14 @@ export {
   ComplexSet,
   HumanHasher,
   MapEntry,
+  SKIP,
   SlidingWindowSummary,
   Tracer,
   Unit,
   WeakDictionary,
   accessBy,
   arrayMove,
+  arraySwap,
   arrayToBuffer,
   arrayToHex,
   arrayToString,
@@ -2239,18 +2442,22 @@ export {
   chunkArray,
   clamp,
   clearUndefined,
+  coerceArray,
   compareMulti,
   compareObject,
   compareScalar,
   compareString,
   createBinder,
   createBucketReducer,
+  createFilename,
   createGroupReducer,
+  createReplacer,
   createSetDispatch,
   createUrl,
   decamelize,
   deepMapValues,
   deepMapValuesAsync,
+  defaultFilter,
   defaultMap,
   defer,
   deferAsync,
@@ -2262,6 +2469,7 @@ export {
   entry,
   exponentialBackoffInterval,
   forEachAsync,
+  formatErrorWithCauses,
   get,
   getAsyncProviderValue,
   getDate,
@@ -2282,8 +2490,12 @@ export {
   intersectBy,
   intersection,
   iosCheck,
+  isBun,
+  isMobile,
+  isMobileOrTablet,
   isNode,
   isNonNullable,
+  isTauri,
   isTruthy,
   joinTables,
   jsonKeyReplacer,
@@ -2299,7 +2511,6 @@ export {
   makeSet,
   mapValues,
   median,
-  mobileAndTabletCheck,
   numericalValues,
   omit,
   orderKeys,
@@ -2315,12 +2526,14 @@ export {
   removeBy,
   removeProperties,
   removeUndefinedProperties,
+  retry,
   safariCheck,
   safeAwaitAll,
   safeInstanceof,
   safeParseFloat,
   safeParseInt,
   safeParseJson,
+  safeStringify,
   set,
   setDeep,
   sortKeys,