@effectstream/db 0.100.15 → 0.100.17

package/README.md

@@ -5,6 +5,11 @@ connection pool, ships every pgtyped-generated SQL query the runtime
 needs, owns the snapshot loop, and provides a mutex needed for safe
 single-threaded PgLite access.
 
+- Pooled Postgres client plus every pgtyped query the runtime needs.
+- Snapshot loop (`runSnapshotLoop`) and `acquireDBMutex` / `releaseDBMutex` for PgLite.
+- Subpath scripts for in-memory PgLite, migrations, and version checks.
+- `getConnection()` is the dominant entry point, ~31 call sites across the repo.
+
 ## Install
 
 ```bash
@@ -44,7 +49,7 @@ try {
 
 For PgLite (in-memory) the package ships `./start-pglite`,
 `./apply-migrations`, `./db-wait`, `./pgtyped-update`, `./version` as
-small executable subpaths — used directly by the orchestrator.
+small executable subpaths - used directly by the orchestrator.
 
 > **PgLite caveat:** PgLite is single-writer. Wrap PgLite-bound code in
 > `acquireDBMutex(name)` / `releaseDBMutex(name)` so concurrent generators
@@ -62,35 +67,35 @@ can rejoin without re-syncing from genesis.
 
 Connection management (heavily used):
 
-- `getConnection(creds?)` — pooled `Pool` singleton. The dominant entry point (~31 cross-package call sites).
-- `acquireDBMutex(name, priority?)` / `releaseDBMutex(name)` — coordination for PgLite (~7 cross-package call sites each).
-- `waitUntilFree()` — companion to the mutex.
-- `getPersistentConnection(creds)` — a non-pooled `Client` for long-lived listeners.
+- `getConnection(creds?)`: pooled `Pool` singleton. Dominant entry point (~31 call sites across the repo).
+- `acquireDBMutex(name, priority?)` and `releaseDBMutex(name)` coordinate PgLite access; ~7 call sites each.
+- `waitUntilFree()` - companion to the mutex.
+- `getPersistentConnection(creds)` returns a non-pooled `Client` for long-lived listeners.
 
 Queries (pgtyped-generated, shipped under one umbrella):
 
-- `getBlockHeights`, `getBlockByHash`, `blockHeightDone`, `saveLastBlock`, `getLatestProcessedBlockHeight` — block bookkeeping.
-- `getAchievementProgress`, `setAchievementProgress` — achievements.
+- Block bookkeeping: `getBlockHeights`, `getBlockByHash`, `blockHeightDone`, `saveLastBlock`, `getLatestProcessedBlockHeight`.
+- Achievements: `getAchievementProgress`, `setAchievementProgress`.
 - Re-exports of `*.queries.ts` for statistics, nonces, rollup inputs, accounts, events, sync protocol pages, primitives, system, tables.
 
 Snapshots:
 
-- `runSnapshotLoop` — periodic `pg_dump` of synced state.
-- `createSnapshot` — single-shot snapshot helper.
-- `SnapshotConfig`, `SnapshotRetentionConfig` — config types.
+- `runSnapshotLoop` - periodic `pg_dump` of synced state.
+- `createSnapshot`: single-shot snapshot helper.
+- `SnapshotConfig`, `SnapshotRetentionConfig`: config types.
 
 Dynamic table / event helpers:
 
-- `createDynamicTables` — register tables a primitive wants to own.
-- `createIndexesForEvents`, `registerEventHandlers` — register pgtyped indexes for app events.
+- `createDynamicTables` registers tables a primitive wants to own.
+- `createIndexesForEvents` creates pgtyped indexes for app events; `registerEventTypes` records each event's topic/name in the database.
 
 Subpath entry points (executable scripts):
 
-- `@effectstream/db/start-pglite` — boot a PgLite instance.
-- `@effectstream/db/apply-migrations` — apply SQL migrations against the active DB.
-- `@effectstream/db/db-wait` — block until the DB accepts a connection.
-- `@effectstream/db/pgtyped-update` — regenerate pgtyped types.
-- `@effectstream/db/version` — print schema version.
+- `@effectstream/db/start-pglite`: boot a PgLite instance.
+- `@effectstream/db/apply-migrations` - apply SQL migrations against the active DB.
+- `@effectstream/db/db-wait`: block until the DB accepts a connection.
+- `@effectstream/db/pgtyped-update`: regenerate pgtyped types.
+- `@effectstream/db/version` - print schema version.
 
 ## Examples
 
@@ -100,4 +105,4 @@ Subpath entry points (executable scripts):
 ## Links
 
 - Docs: https://effectstream.github.io/docs/packages/node/db
-- Source: https://github.com/PaimaStudios/paima-engine/tree/main/packages/node-sdk/db
+- Source: https://github.com/effectstream/effectstream/tree/main/packages/node-sdk/db

package/migrations/system-version.ts

@@ -104,12 +104,15 @@ export function* getLastBlockHeight(
   dbConn: Client,
 ): Operation<number> {
   yield* acquireDBMutex("get-last-block-height");
-  const v = versionInfo.is_empty
-    ? 0
-    : (yield* until(getLatestProcessedBlockHeight.run(undefined, dbConn)))[0]
-      .block_height;
-  releaseDBMutex("get-last-block-height");
-  return v;
+  try {
+    if (versionInfo.is_empty) return 0;
+    const rows = yield* until(
+      getLatestProcessedBlockHeight.run(undefined, dbConn),
+    );
+    return rows[0]?.block_height ?? 0;
+  } finally {
+    releaseDBMutex("get-last-block-height");
+  }
 }
 
 export function* getVersionInfo(dbConn: Client): Operation<VersionInfo> {

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@effectstream/db",
-  "version": "0.100.15",
+  "version": "0.100.17",
   "license": "MIT",
   "homepage": "https://effectstream.github.io/docs/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/PaimaStudios/paima-engine",
+    "url": "https://github.com/effectstream/effectstream",
     "directory": "packages/node-sdk/db"
   },
   "bugs": {
-    "url": "https://github.com/PaimaStudios/paima-engine/issues"
+    "url": "https://github.com/effectstream/effectstream/issues"
   },
   "exports": {
     ".": "./src/mod.ts",
@@ -21,11 +21,11 @@
     "./version": "./migrations/system-version.ts"
   },
   "dependencies": {
-    "@effectstream/coroutine": "0.100.15",
-    "@effectstream/log": "0.100.15",
-    "@effectstream/runtime": "0.100.15",
-    "@effectstream/sync": "0.100.15",
-    "@effectstream/utils": "0.100.15",
+    "@effectstream/coroutine": "0.100.17",
+    "@effectstream/log": "0.100.17",
+    "@effectstream/runtime": "0.100.17",
+    "@effectstream/sync": "0.100.17",
+    "@effectstream/utils": "0.100.17",
     "@electric-sql/pglite": "^0.3.14",
     "@pgtyped/runtime": "2.4.2",
     "@pgtyped/parser": "2.4.2",