@effectstream/node-sdk 0.200.1 → 0.200.4

package/README.md

@@ -64,6 +64,13 @@ instead of jumping to a new tip.
 The subpaths are thin re-exports - semantics are identical to importing
 from the underlying packages.
 
+The re-exported `db/start-pglite` handle uses a bounded, non-destructive
+`close()` by default and an explicit owner-only `close({ force: true })` mode.
+Default close defers PGlite cleanup until the last accepted client socket drains.
+Concurrent calls share the first cleanup promise and the first requested mode
+wins. See the `@effectstream/db` PgLite gateway lifecycle section for the full
+client-ownership, failure, and `0.104.0`→`0.200.1` migration contract.
+
 ## Inside EffectStream
 
 A namespace seam, not a runtime piece. Each subpath simply re-exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effectstream/node-sdk",
-  "version": "0.200.1",
+  "version": "0.200.4",
   "license": "(MIT OR Apache-2.0)",
   "homepage": "https://effectstream.github.io/docs/",
   "repository": {
@@ -83,18 +83,18 @@
     }
   },
   "dependencies": {
-    "@effectstream/runtime": "0.200.1",
-    "@effectstream/sm": "0.200.1",
-    "@effectstream/sync": "0.200.1",
-    "@effectstream/db": "0.200.1",
-    "@effectstream/db-emulator": "0.200.1",
-    "@effectstream/coroutine": "0.200.1",
-    "@effectstream/event-server": "0.200.1",
-    "@effectstream/config": "0.200.1",
-    "@effectstream/chain-types": "0.200.1",
-    "@effectstream/precompile": "0.200.1",
-    "@effectstream/utils": "0.200.1",
-    "@effectstream/concise": "0.200.1",
+    "@effectstream/runtime": "0.200.4",
+    "@effectstream/sm": "0.200.4",
+    "@effectstream/sync": "0.200.4",
+    "@effectstream/db": "0.200.4",
+    "@effectstream/db-emulator": "0.200.4",
+    "@effectstream/coroutine": "0.200.4",
+    "@effectstream/event-server": "0.200.4",
+    "@effectstream/config": "0.200.4",
+    "@effectstream/chain-types": "0.200.4",
+    "@effectstream/precompile": "0.200.4",
+    "@effectstream/utils": "0.200.4",
+    "@effectstream/concise": "0.200.4",
     "effection": "^3.5.0"
   },
   "description": "Main application node SDK for EffectStream"

package/src/single-file.ts

@@ -218,7 +218,7 @@ export async function runNode<
 
     task = run(function* () {
       yield* ensure(function* () {
-        yield* call(() => ownedDatabase.close());
+        yield* call(() => ownedDatabase.close({ force: true }));
       });
       yield* init();
       yield* withEffectstreamStaticConfig(staticConfig, function* () {
@@ -252,7 +252,7 @@ export async function runNode<
       process.off("SIGINT", signalHandler);
       process.off("SIGTERM", signalHandler);
     }
-    if (!task && database) await database.close();
+    if (!task && database) await database.close({ force: true });
     restoreEnvironment();
   }
 }

package/test/fixtures/single-file-sigterm.ts

@@ -0,0 +1,50 @@
+import pg from "../../../db/node_modules/pg";
+import net from "node:net";
+import {
+  midnightContract,
+  pglite,
+  runNode,
+} from "../../src/single-file.ts";
+
+const originalPoolEnd = pg.Pool.prototype.end;
+const originalServerClose = net.Server.prototype.close;
+pg.Pool.prototype.end = async function () {
+  console.info("SINGLE_FILE_POOL_END");
+  return await originalPoolEnd.call(this);
+};
+net.Server.prototype.close = function (...args: Parameters<net.Server["close"]>) {
+  const address = this.address();
+  if (address && typeof address !== "string") {
+    console.info(`SINGLE_FILE_SERVER_CLOSE:${address.port}`);
+  }
+  return originalServerClose.apply(this, args);
+};
+
+const initialSignalListeners = process.listenerCount("SIGTERM");
+const signalPoll = setInterval(() => {
+  if (process.listenerCount("SIGTERM") > initialSignalListeners) {
+    clearInterval(signalPoll);
+    console.info("SINGLE_FILE_SEND_SIGTERM");
+    process.kill(process.pid, "SIGTERM");
+  }
+}, 10);
+
+await runNode({
+  appName: "single-file-sigterm-fixture",
+  apiPort: 18999,
+  database: pglite({ port: 0 }),
+  sources: {
+    counter: midnightContract({
+      network: "preview",
+      address: "a".repeat(64),
+      startBlockHeight: 0,
+      ledger: { round: "uint128" },
+      indexer: "http://127.0.0.1:18998/graphql",
+    }),
+  },
+  transitions: {
+    counter: () => {},
+  },
+});
+
+console.info("SINGLE_FILE_EXIT_ZERO");

package/test/single-file-lifecycle.test.ts

@@ -0,0 +1,46 @@
+import { expect, test } from "bun:test";
+import net from "node:net";
+
+async function expectPortClosed(port: number): Promise<void> {
+  await expect(new Promise<void>((resolve, reject) => {
+    const socket = net.connect({ host: "127.0.0.1", port });
+    socket.once("connect", () => {
+      socket.destroy();
+      resolve();
+    });
+    socket.once("error", reject);
+  })).rejects.toMatchObject({ code: "ECONNREFUSED" });
+}
+
+test("single-file SIGTERM drains the runtime pool before explicit forced PGlite close", async () => {
+  const child = Bun.spawn([
+    process.execPath,
+    new URL("./fixtures/single-file-sigterm.ts", import.meta.url).pathname,
+  ], {
+    cwd: new URL("../../../..", import.meta.url).pathname,
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+
+  const [stdout, stderr, exitCode] = await Promise.all([
+    new Response(child.stdout).text(),
+    new Response(child.stderr).text(),
+    child.exited,
+  ]);
+  const output = `${stdout}\n${stderr}`;
+
+  expect(exitCode, output).toBe(0);
+  expect(output).toContain("SINGLE_FILE_SEND_SIGTERM");
+  expect(output).toContain("SINGLE_FILE_POOL_END");
+  expect(output).toContain("SINGLE_FILE_EXIT_ZERO");
+
+  const match = output.match(/database: server listening on port (\d+)/);
+  if (!match) throw new Error(`No reported PGlite port in output:\n${output}`);
+  const port = Number(match[1]);
+  const gatewayCloseMarker = `SINGLE_FILE_SERVER_CLOSE:${port}`;
+  expect(output).toContain(gatewayCloseMarker);
+  expect(output.indexOf("SINGLE_FILE_POOL_END")).toBeLessThan(
+    output.indexOf(gatewayCloseMarker),
+  );
+  await expectPortClosed(port);
+}, 30_000);