@atolljs/node 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Justin Henry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,10 +1,14 @@
 # @atolljs/node
 
+[![CI](https://github.com/jwhenry3/atolljs/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/jwhenry3/atolljs/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/jwhenry3/atolljs/graph/badge.svg?branch=main)](https://codecov.io/gh/jwhenry3/atolljs)
+[![Socket Badge](https://badge.socket.dev/npm/package/@atolljs/node)](https://badge.socket.dev/npm/package/@atolljs/node)
+
 `node:worker_threads` runtime adapter for `@atolljs/core` — lets `WorkerPool`
 and `connectWorker` run on Node's `Worker` (an `EventEmitter`) instead of the
 DOM surface they expect. No framework required.
 
-**[Atoll — package documentation](https://jwhenry3.github.io/atolljs/consumer/#/quickstart)**
+**[Atoll — package documentation](https://jwhenry3.github.io/atolljs/consumer/quickstart/)**
 
 ## Install
 
@@ -93,8 +97,8 @@ export const counterWorker = defineWorker({
 
 ## Documentation
 
-- [Atoll — package documentation](https://jwhenry3.github.io/atolljs/consumer/#/quickstart)
-- [Node backends — Express, Fastify, Hono, Koa](https://jwhenry3.github.io/atolljs/consumer/#/fw-node)
-- [Worker HTTP servers — clustering & gateway](https://jwhenry3.github.io/atolljs/consumer/#/fw-node/clustering)
-- [Worker pool & tasks](https://jwhenry3.github.io/atolljs/consumer/#/tasks)
-- [NestJS guide](https://jwhenry3.github.io/atolljs/consumer/#/fw-nestjs)
+- [Atoll — package documentation](https://jwhenry3.github.io/atolljs/consumer/quickstart/)
+- [Node backends — Express, Fastify, Hono, Koa](https://jwhenry3.github.io/atolljs/consumer/fw-node/)
+- [Worker HTTP servers — clustering & gateway](https://jwhenry3.github.io/atolljs/consumer/fw-node/clustering/)
+- [Worker pool & tasks](https://jwhenry3.github.io/atolljs/consumer/tasks/)
+- [NestJS guide](https://jwhenry3.github.io/atolljs/consumer/fw-nestjs/)

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@atolljs/node",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Node runtime adapter — node:worker_threads pools, no framework",
-  "homepage": "https://jwhenry3.github.io/atolljs/consumer/#/quickstart",
+  "homepage": "https://jwhenry3.github.io/atolljs/consumer/quickstart/",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
@@ -18,7 +18,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "peerDependencies": {
-    "@atolljs/core": "0.1.1"
+    "@atolljs/core": "0.1.3"
   },
   "repository": {
     "type": "git",
@@ -27,5 +27,6 @@
   },
   "bugs": {
     "url": "https://github.com/jwhenry3/atolljs/issues"
-  }
+  },
+  "license": "MIT"
 }

package/src/redis.ts

@@ -205,6 +205,9 @@ export function persistSharedMemory<S extends SharedSpec>(
             }
           });
         }
+        // stop() may have run before ready resolved — don't start a poll
+        // loop that nothing will ever clear.
+        if (stopped) return;
         timer = setInterval(() => {
           flushing = flushing.then(flush).catch((e) => {
             log.warn('flush failed', e);
@@ -228,9 +231,13 @@ export function persistSharedMemory<S extends SharedSpec>(
       await subscriber?.unsubscribe?.(channel);
       await flushing.catch(() => 0);
       // One last flush — durability on shutdown — bypass the stopped guard.
+      // A Redis outage here must not reject stop(): teardown is done either
+      // way, the flush is best-effort persistence.
       stopped = false;
       try {
         await flush();
+      } catch (e) {
+        log.warn('final flush failed', e);
       } finally {
         stopped = true;
       }

package/src/sharedBuffer.ts

@@ -58,19 +58,22 @@ export function bindSharedBuffer(timeoutMs = 10_000): Promise<SharedArrayBuffer>
   }
   const port = parentPort;
   return new Promise((resolve, reject) => {
-    const timer = setTimeout(
-      () => reject(new Error(`bindSharedBuffer(): no shared buffer arrived within ${timeoutMs}ms`)),
-      timeoutMs,
-    );
-    port.on('message', (msg: { type?: string; buffer?: SharedArrayBuffer }) => {
+    const onMessage = (msg: { type?: string; buffer?: SharedArrayBuffer }) => {
       if (msg?.type !== SHARED_BUFFER) return;
       clearTimeout(timer);
+      port.off('message', onMessage);
       if (!msg.buffer) {
         reject(new Error('bindSharedBuffer(): the producing side sent an empty buffer'));
         return;
       }
       bindSharedMemories(msg.buffer);
       resolve(msg.buffer);
-    });
+    };
+    const timer = setTimeout(() => {
+      // Detach — a late SHARED_BUFFER must not bind after the rejection.
+      port.off('message', onMessage);
+      reject(new Error(`bindSharedBuffer(): no shared buffer arrived within ${timeoutMs}ms`));
+    }, timeoutMs);
+    port.on('message', onMessage);
   });
 }