@rift-vs/rift-embedded 0.12.1-snapshot.104.g9a93306

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/worker.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Embedded transport worker (issue #8) — a THIN worker_threads wrapper. All correctness logic
+ * (sentinel detection, decode-then-free, per-call last-error reads) lives in `native-call.ts`'s
+ * `handleCall`, unit-tested there against a fake binding; this file only owns:
+ *
+ *   - building the real `NativeBinding` from koffi at init (via `ffi.ts`, which is where the
+ *     dynamic `import('koffi')` actually happens),
+ *   - holding the one piece of state `handleCall` doesn't manage itself — the `RiftHandle*` from
+ *     `rift_start` — and prepending it to every dispatched call's args,
+ *   - the message-loop plumbing and graceful/forced shutdown.
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/worker.js

@@ -0,0 +1,86 @@
+/**
+ * Embedded transport worker (issue #8) — a THIN worker_threads wrapper. All correctness logic
+ * (sentinel detection, decode-then-free, per-call last-error reads) lives in `native-call.ts`'s
+ * `handleCall`, unit-tested there against a fake binding; this file only owns:
+ *
+ *   - building the real `NativeBinding` from koffi at init (via `ffi.ts`, which is where the
+ *     dynamic `import('koffi')` actually happens),
+ *   - holding the one piece of state `handleCall` doesn't manage itself — the `RiftHandle*` from
+ *     `rift_start` — and prepending it to every dispatched call's args,
+ *   - the message-loop plumbing and graceful/forced shutdown.
+ */
+import { parentPort } from 'worker_threads';
+import { loadNativeBinding } from './ffi.js';
+import { handleCallMessage, readBuildInfo, readLastErrorMessage } from './native-call.js';
+import { traceFfi } from './debug-trace.js';
+traceFfi('worker:module-load');
+if (!parentPort) {
+    throw new Error('src/embedded/worker.js must be run inside a worker_threads Worker');
+}
+const port = parentPort;
+function post(msg) {
+    port.postMessage(msg);
+}
+let native = null;
+async function handleInit(libPath) {
+    try {
+        traceFfi('worker:handleInit');
+        const { binding, decode } = await loadNativeBinding(libPath);
+        traceFfi('rift_build_info');
+        const buildInfo = readBuildInfo(binding, decode);
+        traceFfi('rift_start');
+        const handle = binding.rift_start();
+        if (handle === null) {
+            const { message } = readLastErrorMessage(binding, decode, 'rift_start');
+            post({ type: 'init-error', message });
+            return;
+        }
+        // Diagnostic hook (#53): `RIFT_FFI_DEBUG_NO_DECODE` neuters the PER-CALL decode only — leaving
+        // init's build_info/last-error decode intact so init still succeeds — to isolate whether the
+        // strlen SIGSEGV is in koffi.decode(char*) of a call RESULT vs argument marshalling. If the crash
+        // disappears with this set, it is the result-decode path. Inert unless the env var is set.
+        const callDecode = process.env.RIFT_FFI_DEBUG_NO_DECODE ? () => '' : decode;
+        native = { binding, decode: callDecode, handle };
+        post({ type: 'ready', buildInfo });
+    }
+    catch (err) {
+        post({ type: 'init-error', message: err instanceof Error ? err.message : String(err) });
+    }
+}
+function handleShutdown() {
+    if (native) {
+        try {
+            native.binding.rift_stop(native.handle);
+        }
+        catch {
+            // Best-effort: the process is exiting either way, and a failing rift_stop must not block
+            // the worker from ever tearing down (that would defeat the facade's shutdown timeout).
+        }
+    }
+    post({ type: 'shutdown-ack' });
+    process.exit(0);
+}
+port.on('message', (raw) => {
+    const msg = raw;
+    switch (msg.type) {
+        case 'init':
+            void handleInit(msg.libPath);
+            return;
+        case 'call': {
+            // handleCallMessage rejects pre-init calls, prepends the worker-local handle, and converts any
+            // throw into an error result — so a bad call never escapes this handler and hangs the caller.
+            traceFfi(msg.fn);
+            const response = handleCallMessage(native, { id: msg.id, fn: msg.fn, args: msg.args });
+            post({ type: 'result', ...response });
+            return;
+        }
+        case 'shutdown':
+            handleShutdown();
+            return;
+        default: {
+            const exhaustive = msg;
+            throw new Error(`embedded worker: unhandled message ${JSON.stringify(exhaustive)}`);
+        }
+    }
+});
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@rift-vs/rift-embedded",
+  "version": "0.12.1-snapshot.104.g9a93306",
+  "description": "Embedded (in-process) engine transport for @rift-vs/rift — koffi FFI binding to librift_ffi. Installing this package is what opts a project into rift.embedded().",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "node --experimental-vm-modules ../../node_modules/jest/bin/jest.js",
+    "lint": "eslint src test --ext .ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "koffi": "^2.9.0"
+  },
+  "peerDependencies": {
+    "@rift-vs/rift": "*"
+  },
+  "devDependencies": {
+    "@rift-vs/rift": "*",
+    "typescript": "^5.3.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.10.0",
+    "eslint": "^8.56.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "minEngineVersion": "0.12.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EtaCassiopeia/rift-node.git",
+    "directory": "packages/rift-embedded"
+  }
+}