@adecore/utils 0.0.1 → 0.54.1

package/README.md

@@ -1,6 +1,6 @@
 # @adecore/utils
 
-Small helpers without dependencies: atomic file writes, path containment, the order of async work and reading a thrown value. Each lives at its own subpath; `async`, `errors` and `record` run in a page, `fs` and `path` need Node or Bun.
+Small helpers without dependencies: atomic file writes, path containment, the order of async work and reading a thrown value. Each lives at its own subpath; `async`, `errors`, `record` and `text` run in a page, `fs` and `path` need Node or Bun.
 
 ```sh
 bun add @adecore/utils

package/dist/async.js

@@ -7,11 +7,20 @@ export { SingleFlight } from './single-flight.js';
  */
 export function wait(ms, signal) {
     return new Promise((resolve) => {
-        const timer = setTimeout(resolve, ms);
-        signal?.addEventListener('abort', () => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const onAbort = () => {
             clearTimeout(timer);
             resolve();
-        }, { once: true });
+        };
+        // A long-lived signal outlives many waits, so each one takes its listener back.
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
     });
 }
 const SYSTEM_TIMER = {

package/dist/record.js

@@ -1,4 +1,4 @@
-/* A plain object read off the wire or a file, whose fields are still unchecked; an array is not one. */
+/* Any object but an array, such as one read off the wire or a file whose fields are still unchecked. A Date or a class instance passes too. */
 export function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/package.json

@@ -1,65 +1,65 @@
 {
-    "name": "@adecore/utils",
-    "version": "0.0.1",
-    "description": "Small helpers without dependencies: atomic file writes, path containment, async ordering and error reading.",
-    "license": "FSL-1.1-MIT",
-    "author": "Bas Milius",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/basmilius/adecore.git",
-        "directory": "packages/utils"
+  "name": "@adecore/utils",
+  "version": "0.54.1",
+  "description": "Small helpers without dependencies: atomic file writes, path containment, async ordering and error reading.",
+  "license": "FSL-1.1-MIT",
+  "author": "Bas Milius",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/basmilius/adecore.git",
+    "directory": "packages/utils"
+  },
+  "bugs": {
+    "url": "https://github.com/basmilius/adecore/issues"
+  },
+  "homepage": "https://adecore.dev/utils/",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts"
+  ],
+  "exports": {
+    "./async": {
+      "source": "./src/async.ts",
+      "types": "./dist/async.d.ts",
+      "default": "./dist/async.js"
     },
-    "bugs": {
-        "url": "https://github.com/basmilius/adecore/issues"
+    "./errors": {
+      "source": "./src/errors.ts",
+      "types": "./dist/errors.d.ts",
+      "default": "./dist/errors.js"
     },
-    "homepage": "https://adecore.dev/utils/",
-    "type": "module",
-    "sideEffects": false,
-    "files": [
-        "dist",
-        "src",
-        "!src/**/*.test.ts"
-    ],
-    "exports": {
-        "./async": {
-            "source": "./src/async.ts",
-            "types": "./dist/async.d.ts",
-            "default": "./dist/async.js"
-        },
-        "./errors": {
-            "source": "./src/errors.ts",
-            "types": "./dist/errors.d.ts",
-            "default": "./dist/errors.js"
-        },
-        "./fs": {
-            "source": "./src/fs.ts",
-            "types": "./dist/fs.d.ts",
-            "default": "./dist/fs.js"
-        },
-        "./path": {
-            "source": "./src/path.ts",
-            "types": "./dist/path.d.ts",
-            "default": "./dist/path.js"
-        },
-        "./record": {
-            "source": "./src/record.ts",
-            "types": "./dist/record.d.ts",
-            "default": "./dist/record.js"
-        },
-        "./text": {
-            "source": "./src/text.ts",
-            "types": "./dist/text.d.ts",
-            "default": "./dist/text.js"
-        }
+    "./fs": {
+      "source": "./src/fs.ts",
+      "types": "./dist/fs.d.ts",
+      "default": "./dist/fs.js"
     },
-    "scripts": {
-        "build": "bun scripts/build.ts",
-        "typecheck": "bun check --no-script",
-        "test": "bun test --conditions=source"
+    "./path": {
+      "source": "./src/path.ts",
+      "types": "./dist/path.d.ts",
+      "default": "./dist/path.js"
     },
-    "devDependencies": {
-        "@types/bun": "^1.4.4",
-        "@types/node": "^26.6.6",
-        "typescript": "^7.0.2"
+    "./record": {
+      "source": "./src/record.ts",
+      "types": "./dist/record.d.ts",
+      "default": "./dist/record.js"
+    },
+    "./text": {
+      "source": "./src/text.ts",
+      "types": "./dist/text.d.ts",
+      "default": "./dist/text.js"
     }
+  },
+  "scripts": {
+    "build": "bun scripts/build.ts",
+    "typecheck": "bun check --no-script",
+    "test": "bun test --conditions=source"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.4",
+    "@types/node": "^26.6.6",
+    "typescript": "^7.0.2"
+  }
 }

package/src/async.ts

@@ -9,16 +9,24 @@ export { SingleFlight } from './single-flight.ts';
  */
 export function wait(ms: number, signal?: AbortSignal): Promise<void> {
     return new Promise((resolve) => {
-        const timer = setTimeout(resolve, ms);
+        if (signal?.aborted) {
+            resolve();
 
-        signal?.addEventListener(
-            'abort',
-            () => {
-                clearTimeout(timer);
-                resolve();
-            },
-            { once: true }
-        );
+            return;
+        }
+
+        const onAbort = (): void => {
+            clearTimeout(timer);
+            resolve();
+        };
+
+        // A long-lived signal outlives many waits, so each one takes its listener back.
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+
+        signal?.addEventListener('abort', onAbort, { once: true });
     });
 }
 

package/src/record.ts

@@ -1,4 +1,4 @@
-/* A plain object read off the wire or a file, whose fields are still unchecked; an array is not one. */
+/* Any object but an array, such as one read off the wire or a file whose fields are still unchecked. A Date or a class instance passes too. */
 export function isRecord(value: unknown): value is Record<string, unknown> {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }