@shivaedev/platform 0.2.3 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+## 0.3.0 - 2026-08-03
+
+### Added
+
+- Add a Node/Bun subscription signal that combines Web and procedure aborts
+  with request and socket close events for reliable long-lived response cleanup.
+
 ## 0.2.3 - 2026-08-03
 
 ### Fixed

package/README.md

@@ -23,6 +23,32 @@ The optional cache key keeps one runtime across development module reloads.
 The runtime also carries transaction- and request-scoped service overrides
 across promise boundaries.
 
+## Node HTTP
+
+Long-lived responses under Bun's `node:http` compatibility layer may not abort
+their Web request signal when the underlying socket disappears. Combine the
+available Web, procedure, request, and socket signals at the subscription
+boundary:
+
+```ts
+import { nodeSubscriptionSignal } from "@shivaedev/platform/node-http"
+
+const subscription = nodeSubscriptionSignal({
+  request,
+  nodeRequest,
+  signals: [procedureSignal],
+})
+
+try {
+  await consume(subscription.signal)
+} finally {
+  subscription.dispose()
+}
+```
+
+The node request may be supplied directly or carried by an srvx Web request.
+Applications still own subscription limits, event buses, and transport policy.
+
 ## Better Auth
 
 `effectPrismaAdapter` stores Better Auth data through the application's Effect

package/dist/node-http/subscription-signal.d.ts

@@ -0,0 +1,22 @@
+import type { IncomingMessage } from "node:http";
+export interface NodeSubscriptionSignalOptions {
+    /** A Web request, including its signal and an optional srvx node runtime. */
+    readonly request?: Request | undefined;
+    /** The node request when the transport exposes it directly. */
+    readonly nodeRequest?: IncomingMessage | undefined;
+    /** Additional transport or procedure signals to combine. */
+    readonly signals?: Iterable<AbortSignal | undefined>;
+}
+export interface NodeSubscriptionSignal {
+    /** Detach node listeners when the subscription ends. */
+    readonly dispose: () => void;
+    /** Aborts when any supplied signal or the underlying connection closes. */
+    readonly signal: AbortSignal;
+}
+/**
+ * Combine Web/procedure abort signals with node request and socket close events.
+ * The node events cover long-lived responses under Bun's node:http compatibility
+ * layer, where a Web request signal alone may not report an abandoned socket.
+ */
+export declare const nodeSubscriptionSignal: (options: NodeSubscriptionSignalOptions) => NodeSubscriptionSignal;
+//# sourceMappingURL=subscription-signal.d.ts.map

package/dist/node-http/subscription-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-signal.d.ts","sourceRoot":"","sources":["../../src/node-http/subscription-signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAUjD,MAAM,WAAW,6BAA6B;IAC7C,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACnD,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,sBAAsB;IACtC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC7B;AAOD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAClC,SAAS,6BAA6B,KACpC,sBAgCF,CAAC"}

package/dist/node-http/subscription-signal.js

@@ -0,0 +1,42 @@
+const nodeRequestFrom = (request) => request?.runtime?.node?.req;
+/**
+ * Combine Web/procedure abort signals with node request and socket close events.
+ * The node events cover long-lived responses under Bun's node:http compatibility
+ * layer, where a Web request signal alone may not report an abandoned socket.
+ */
+export const nodeSubscriptionSignal = (options) => {
+    const controller = new AbortController();
+    const signals = [controller.signal];
+    if (options.request !== undefined)
+        signals.push(options.request.signal);
+    for (const signal of options.signals ?? []) {
+        if (signal !== undefined)
+            signals.push(signal);
+    }
+    const nodeRequest = options.nodeRequest ?? nodeRequestFrom(options.request);
+    if (nodeRequest === undefined) {
+        return { dispose: () => { }, signal: AbortSignal.any(signals) };
+    }
+    const socket = nodeRequest.socket;
+    const onRequestClose = () => {
+        if (!nodeRequest.complete)
+            controller.abort();
+    };
+    const onSocketClose = () => controller.abort();
+    nodeRequest.once("close", onRequestClose);
+    socket.once("close", onSocketClose);
+    if (nodeRequest.destroyed || socket.destroyed)
+        controller.abort();
+    let disposed = false;
+    return {
+        dispose: () => {
+            if (disposed)
+                return;
+            disposed = true;
+            nodeRequest.removeListener("close", onRequestClose);
+            socket.removeListener("close", onSocketClose);
+        },
+        signal: AbortSignal.any(signals),
+    };
+};
+//# sourceMappingURL=subscription-signal.js.map

package/dist/node-http/subscription-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-signal.js","sourceRoot":"","sources":["../../src/node-http/subscription-signal.ts"],"names":[],"mappings":"AA0BA,MAAM,eAAe,GAAG,CACvB,OAA4B,EACE,EAAE,CAC/B,OAAsD,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACrC,OAAsC,EACb,EAAE;IAC3B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAkB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC5C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAClC,MAAM,cAAc,GAAG,GAAG,EAAE;QAC3B,IAAI,CAAC,WAAW,CAAC,QAAQ;YAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IAC/C,CAAC,CAAC;IACF,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC/C,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACpC,IAAI,WAAW,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS;QAAE,UAAU,CAAC,KAAK,EAAE,CAAC;IAElE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACN,OAAO,EAAE,GAAG,EAAE;YACb,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,WAAW,CAAC,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACpD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC;KAChC,CAAC;AACH,CAAC,CAAC"}

package/dist/node-http.d.ts

@@ -0,0 +1,2 @@
+export { type NodeSubscriptionSignal, type NodeSubscriptionSignalOptions, nodeSubscriptionSignal, } from "./node-http/subscription-signal.js";
+//# sourceMappingURL=node-http.d.ts.map

package/dist/node-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http.d.ts","sourceRoot":"","sources":["../src/node-http.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,sBAAsB,GACtB,MAAM,oCAAoC,CAAC"}

package/dist/node-http.js

@@ -0,0 +1,2 @@
+export { nodeSubscriptionSignal, } from "./node-http/subscription-signal.js";
+//# sourceMappingURL=node-http.js.map

package/dist/node-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http.js","sourceRoot":"","sources":["../src/node-http.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,sBAAsB,GACtB,MAAM,oCAAoC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/platform",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Opinionated Effect application infrastructure for ShivaeDev services",
   "type": "module",
   "license": "MIT",
@@ -36,6 +36,12 @@
       "import": "./dist/runtime.js",
       "default": "./dist/runtime.js"
     },
+    "./node-http": {
+      "types": "./dist/node-http.d.ts",
+      "source": "./src/node-http.ts",
+      "import": "./dist/node-http.js",
+      "default": "./dist/node-http.js"
+    },
     "./testing": {
       "types": "./dist/testing.d.ts",
       "source": "./src/testing.ts",

package/src/node-http/subscription-signal.ts

@@ -0,0 +1,71 @@
+import type { IncomingMessage } from "node:http";
+
+interface NodeRequestCarrier {
+	readonly runtime?: {
+		readonly node?: {
+			readonly req?: IncomingMessage;
+		};
+	};
+}
+
+export interface NodeSubscriptionSignalOptions {
+	/** A Web request, including its signal and an optional srvx node runtime. */
+	readonly request?: Request | undefined;
+	/** The node request when the transport exposes it directly. */
+	readonly nodeRequest?: IncomingMessage | undefined;
+	/** Additional transport or procedure signals to combine. */
+	readonly signals?: Iterable<AbortSignal | undefined>;
+}
+
+export interface NodeSubscriptionSignal {
+	/** Detach node listeners when the subscription ends. */
+	readonly dispose: () => void;
+	/** Aborts when any supplied signal or the underlying connection closes. */
+	readonly signal: AbortSignal;
+}
+
+const nodeRequestFrom = (
+	request: Request | undefined,
+): IncomingMessage | undefined =>
+	(request as (Request & NodeRequestCarrier) | undefined)?.runtime?.node?.req;
+
+/**
+ * Combine Web/procedure abort signals with node request and socket close events.
+ * The node events cover long-lived responses under Bun's node:http compatibility
+ * layer, where a Web request signal alone may not report an abandoned socket.
+ */
+export const nodeSubscriptionSignal = (
+	options: NodeSubscriptionSignalOptions,
+): NodeSubscriptionSignal => {
+	const controller = new AbortController();
+	const signals: AbortSignal[] = [controller.signal];
+	if (options.request !== undefined) signals.push(options.request.signal);
+	for (const signal of options.signals ?? []) {
+		if (signal !== undefined) signals.push(signal);
+	}
+
+	const nodeRequest = options.nodeRequest ?? nodeRequestFrom(options.request);
+	if (nodeRequest === undefined) {
+		return { dispose: () => {}, signal: AbortSignal.any(signals) };
+	}
+
+	const socket = nodeRequest.socket;
+	const onRequestClose = () => {
+		if (!nodeRequest.complete) controller.abort();
+	};
+	const onSocketClose = () => controller.abort();
+	nodeRequest.once("close", onRequestClose);
+	socket.once("close", onSocketClose);
+	if (nodeRequest.destroyed || socket.destroyed) controller.abort();
+
+	let disposed = false;
+	return {
+		dispose: () => {
+			if (disposed) return;
+			disposed = true;
+			nodeRequest.removeListener("close", onRequestClose);
+			socket.removeListener("close", onSocketClose);
+		},
+		signal: AbortSignal.any(signals),
+	};
+};

package/src/node-http.ts

@@ -0,0 +1,5 @@
+export {
+	type NodeSubscriptionSignal,
+	type NodeSubscriptionSignalOptions,
+	nodeSubscriptionSignal,
+} from "./node-http/subscription-signal.js";