@nicknisi/pi-relay 0.3.2 → 0.3.4

package/README.md

@@ -101,6 +101,7 @@ The directory is created `0700` and every file `0600` — other users on the mac
 ## Caveats
 
 - **Mailbox semantics support Linux and macOS only.** Relay rejects user-controlled symlinks in configured-root components, permits protected root-owned system aliases such as macOS `/var`, pins root, mailbox, and durable-claim descriptors for each operation, and uses descriptor-relative `openat`/`renameat`/`unlinkat` calls, atomic renames, descriptor polling for watches, and `0600`/`0700` permission bits. Windows is unsupported.
+- **Bun <= 1.3.14 refused.** Those Bun versions abort the process when koffi's GC finalizer releases an N-API reference ([oven-sh/bun#39263](https://github.com/oven-sh/bun/issues/39263), fixed upstream after 1.3.14), so relay fails load with a clear error on them instead. Node.js and newer Bun load normally.
 - **One machine.** Delivery is a file landing in a directory; two sessions reach each other exactly when they share a filesystem. A container and its host cannot.
 - **Presence is heartbeat-accurate**, not instantaneous (within ~45s).
 - Delivery injects with `deliverAs: "steer"` (lands between tool calls) and `triggerTurn: true` (wakes an idle session).

package/dist/filesystem.js

@@ -1,11 +1,22 @@
 /** Descriptor-relative, symlink-safe filesystem operations for the relay store. Pi-free. */
 import { randomBytes } from 'node:crypto';
 import * as fs from 'node:fs';
+import { createRequire } from 'node:module';
 import * as path from 'node:path';
-import koffi from 'koffi';
 if (process.platform !== 'darwin' && process.platform !== 'linux') {
     throw new Error(`Relay filesystem operations are unsupported on ${process.platform}`);
 }
+// Bun <= 1.3.14 aborts the whole process when koffi's GC finalizer releases
+// an N-API reference (oven-sh/bun#39263, fixed after 1.3.14). Fail extension
+// load cleanly on those versions instead.
+const bunVersion = globalThis.Bun?.version;
+if (bunVersion !== undefined) {
+    const [major = 0, minor = 0, patch = 0] = bunVersion.split('-')[0].split('.').map(Number);
+    if (major < 1 || (major === 1 && (minor < 3 || (minor === 3 && patch <= 14)))) {
+        throw new Error(`Relay requires Node.js or Bun > 1.3.14: koffi crashes Bun ${bunVersion} (oven-sh/bun#39263)`);
+    }
+}
+const koffi = createRequire(import.meta.url)('koffi');
 const NOFOLLOW = fs.constants.O_NOFOLLOW ?? 0;
 const DIRECTORY = fs.constants.O_DIRECTORY ?? 0;
 const CLOEXEC = process.platform === 'darwin' ? 0x01000000 : 0x00080000;

package/filesystem.ts

@@ -1,13 +1,26 @@
 /** Descriptor-relative, symlink-safe filesystem operations for the relay store. Pi-free. */
 import { randomBytes } from 'node:crypto';
 import * as fs from 'node:fs';
+import { createRequire } from 'node:module';
 import * as path from 'node:path';
-import koffi from 'koffi';
 
 if (process.platform !== 'darwin' && process.platform !== 'linux') {
   throw new Error(`Relay filesystem operations are unsupported on ${process.platform}`);
 }
 
+// Bun <= 1.3.14 aborts the whole process when koffi's GC finalizer releases
+// an N-API reference (oven-sh/bun#39263, fixed after 1.3.14). Fail extension
+// load cleanly on those versions instead.
+const bunVersion = (globalThis as { Bun?: { version?: string } }).Bun?.version;
+if (bunVersion !== undefined) {
+  const [major = 0, minor = 0, patch = 0] = bunVersion.split('-')[0]!.split('.').map(Number);
+  if (major < 1 || (major === 1 && (minor < 3 || (minor === 3 && patch <= 14)))) {
+    throw new Error(`Relay requires Node.js or Bun > 1.3.14: koffi crashes Bun ${bunVersion} (oven-sh/bun#39263)`);
+  }
+}
+
+const koffi = createRequire(import.meta.url)('koffi') as typeof import('koffi');
+
 const NOFOLLOW = fs.constants.O_NOFOLLOW ?? 0;
 const DIRECTORY = fs.constants.O_DIRECTORY ?? 0;
 const CLOEXEC = process.platform === 'darwin' ? 0x01000000 : 0x00080000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicknisi/pi-relay",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Brokerless session-to-session messaging for pi — a file mailbox that outlives the process, with ask/reply coordination. Formerly @nicknisi/pi-intercom.",
   "keywords": [
     "pi",