@carno.js/live 1.8.0

package/dist/transport/sse-routes.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSseRoutes = createSseRoutes;
+const runtime_1 = require("../runtime");
+const LiveGateway_1 = require("./LiveGateway");
+// Captured at load so a later happy-dom register cannot replace the
+// constructor Bun.serve requires of a route handler.
+const NativeResponse = Response;
+const SSE_HEADERS = {
+    'Content-Type': 'text/event-stream',
+    'Cache-Control': 'no-cache, no-transform',
+    Connection: 'keep-alive',
+    // Nginx buffers proxied responses by default, which turns a live stream
+    // into a stream that arrives all at once, at the end.
+    'X-Accel-Buffering': 'no'
+};
+/**
+ * The two halves of the SSE transport, as HTTP.
+ *
+ * `GET streamPath` opens the downstream and names the connection; every
+ * client message goes up through `POST controlPath` and into the same
+ * `handleMessage` the WebSocket gateway uses. There is no second protocol
+ * here, and there must never be one.
+ *
+ * Handlers registered through `Carno.route()` receive a Bun `Request`, not a
+ * `Context` -- the docstring on that method says otherwise, the runtime does
+ * not.
+ */
+function createSseRoutes(options) {
+    const { transport, streamPath, controlPath } = options;
+    const stream = (request) => {
+        // Unguessable on purpose: the id is a bearer for this connection, and
+        // whoever holds it can subscribe as it.
+        const connectionId = `sse:${crypto.randomUUID()}`;
+        try {
+            const body = transport.open(connectionId);
+            const runtime = (0, runtime_1.getLiveRuntime)();
+            // Until a `hello` arrives, the connection is its own principal:
+            // safe, shares nothing. Same rule as the gateway's onOpen.
+            runtime.scopes.set(connectionId, { principal: connectionId });
+            runtime.handshakes.delete(connectionId);
+            // Cancelling the client reader does not always reach the stream's
+            // `cancel`; aborting the request does, and is what a closed
+            // EventSource looks like on the wire.
+            request.signal.addEventListener('abort', () => {
+                transport.close(connectionId);
+                try {
+                    (0, LiveGateway_1.dropLiveConnection)(connectionId);
+                }
+                catch {
+                    // closeLiveRuntime nulls the runtime before dispose.
+                }
+            });
+            return new NativeResponse(body, { status: 200, headers: SSE_HEADERS });
+        }
+        catch (error) {
+            return new NativeResponse(error.message, { status: 503 });
+        }
+    };
+    const control = async (request) => {
+        let payload;
+        try {
+            payload = await request.json();
+        }
+        catch {
+            return new NativeResponse('malformed body', { status: 400 });
+        }
+        if (typeof payload.cid !== 'string' || !payload.message) {
+            return new NativeResponse('cid and message are required', { status: 400 });
+        }
+        if (!transport.owns(payload.cid)) {
+            return new NativeResponse('unknown connection', { status: 404 });
+        }
+        await (0, LiveGateway_1.handleMessage)(payload.cid, JSON.stringify(payload.message));
+        return new NativeResponse(null, { status: 204 });
+    };
+    return { streamPath, controlPath, stream, control };
+}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@carno.js/live",
+  "version": "1.8.0",
+  "description": "Server-owned reactive state for Carno.js: live resources, dependency-graph invalidation, and framework-native client stores",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/core.d.ts",
+      "require": "./dist/client/core.js",
+      "default": "./dist/client/core.js"
+    },
+    "./react": {
+      "types": "./dist/client/react.d.ts",
+      "require": "./dist/client/react.js",
+      "default": "./dist/client/react.js"
+    },
+    "./vanilla": {
+      "types": "./dist/client/vanilla.d.ts",
+      "require": "./dist/client/vanilla.js",
+      "default": "./dist/client/vanilla.js"
+    },
+    "./angular": {
+      "types": "./dist/client/angular.d.ts",
+      "require": "./dist/client/angular.js",
+      "default": "./dist/client/angular.js"
+    },
+    "./vue": {
+      "types": "./dist/client/vue.d.ts",
+      "require": "./dist/client/vue.js",
+      "default": "./dist/client/vue.js"
+    }
+  },
+  "scripts": {
+    "compile": "rm -rf ./dist tsconfig.tsbuildinfo && tsc --build --force",
+    "build": "tsc --build --force",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=18.0.0",
+    "@carno.js/core": "^1.7.0",
+    "@carno.js/orm": "^1.7.0",
+    "@carno.js/websocket": "^1.7.0",
+    "react": ">=18.0.0",
+    "vue": ">=3.4.0"
+  },
+  "peerDependenciesMeta": {
+    "@carno.js/orm": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/core": "^18.2.0",
+    "@happy-dom/global-registrator": "^20.0.0",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "vue": "^3.5.0"
+  },
+  "keywords": [
+    "carno",
+    "carno.js",
+    "live",
+    "realtime",
+    "reactive",
+    "websocket"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "4eacc5852543c296787a2f8b92795a1775de44fa"
+}