@agent-native/core 0.131.7 → 0.132.0

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
+    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
-    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,10 +77,10 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
+    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
-    error?: undefined;
 }>>;
 //# sourceMappingURL=awareness.d.ts.map

package/dist/collab/awareness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgB3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,GAAG,SAAS,GAChC,IAAI,CAON;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,cAAc,GACrB,IAAI,CAgBN;AAoBD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAmB,GAC7B,IAAI,CAON;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1E;AAiBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAkCD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;kBAwDa,MAAM;eAAS,MAAM;;;GAoB1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;kBAYM,MAAM;kBAAY,MAAM;;;GAMvD,CAAC"}
+{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../src/collab/awareness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgB3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,GAAG,SAAS,GAChC,IAAI,CAON;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,KAAK,CAAC,EAAE,cAAc,GACrB,IAAI,CAgBN;AAoBD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAmB,GAC7B,IAAI,CAON;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1E;AAiBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAO1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAOnE;AAkCD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;kBAwDa,MAAM;eAAS,MAAM;;GAoB1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;kBAYM,MAAM;kBAAY,MAAM;;GAMvD,CAAC"}

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/db/client.d.ts

@@ -174,20 +174,28 @@ export declare function withDbTimeout<T>(op: string, run: () => Promise<T>, ms?:
  */
 export declare function isServerlessRuntime(): boolean;
 /**
- * postgres.js pool options tuned per runtime. A serverless instance handles
- * one request at a time, so a single connection is enough. Keeping the
- * foreground pool at 1 is important because each instance can also open an
- * app and Better Auth pool; a max of 2 on each pool still exhausted Neon
- * under a burst of warm instances. idle_timeout is shortened on
+ * postgres.js pool options tuned per runtime. idle_timeout is shortened on
  * serverless so a thawed-but-idle instance releases its connections quickly.
- * Long-lived Node servers keep the normal pool for throughput.
+ * Long-lived Node servers keep the larger pool for throughput.
+ *
+ * The cap assumes {@link sharedDbPool}: one pool per URL for the whole
+ * process, not one per consumer. See {@link neonPoolMax} for why the cap must
+ * leave room for concurrency.
  */
 export declare function pgPoolOptions(url: string): Record<string, unknown>;
 /**
- * Connection cap for the @neondatabase/serverless `Pool`. Same instance
- * accumulation risk as postgres.js — one connection is enough for a
- * foreground serverless invocation and keeps the aggregate app/framework/auth
- * budget bounded.
+ * Connection cap for the @neondatabase/serverless `Pool`.
+ *
+ * TRAP: this number is the ceiling on how many statements one request can have
+ * in flight at once. It used to be 1 on serverless, which made every
+ * `Promise.all([...reads])` in a request serialize behind the single slot —
+ * against a remote endpoint that is ~83ms of pure wait per query, so ten
+ * "concurrent" reads took ~880ms instead of ~86ms. The cap was 1 only because
+ * every consumer built its OWN pool (the DbExec singleton, Better Auth, and one
+ * per `createGetDb()` schema module), so the real per-instance connection count
+ * was that number multiplied by ~6. {@link sharedDbPool} collapses those into
+ * one pool per URL, so the same aggregate budget buys in-request concurrency.
+ * Keep pools shared if you raise this.
  */
 export declare function neonPoolMax(): number;
 /**
@@ -205,6 +213,44 @@ export declare function isBackgroundFunctionPoolContext(): boolean;
  */
 export declare function describeDbError(err: unknown): string;
 export declare function attachNeonPoolErrorLogger(pool: unknown, label?: string): void;
+interface ClosablePool {
+    end(): Promise<unknown>;
+}
+/**
+ * One connection pool per (driver, URL) for the whole process.
+ *
+ * Opening a connection to a remote database costs a full TCP + TLS + auth
+ * round-trip chain (~300-800ms measured against Neon in-region), and it used
+ * to be paid once per CONSUMER: the `getDbExec` singleton, Better Auth, and one
+ * more for every `createGetDb()` schema module (four in core alone, plus each
+ * app's). Their `max` values also multiplied against the provider's connection
+ * cap, which forced each pool down to a size too small to run a request's reads
+ * concurrently.
+ *
+ * TRAP: only consumers that live as long as the process may share. Anything
+ * handed a `close()` — `createDbExec()`, the migration exec on the direct
+ * endpoint — must keep a private pool, or closing it takes the whole process's
+ * database access down with it.
+ */
+export declare function sharedDbPool<T extends ClosablePool>(driver: string, url: string, create: () => T): T;
+/**
+ * Swap the pool registered for a key, for the postgres.js recycle path that
+ * replaces a pool whose query timed out. Without this the registry would keep
+ * handing out the discarded pool.
+ */
+export declare function replaceSharedDbPool<T extends ClosablePool>(driver: string, url: string, previous: T, next: T): void;
+/**
+ * Run `hook` when one shared pool is replaced, so derived consumers rebuild
+ * their handles instead of continuing to use the timed-out pool.
+ */
+export declare function onSharedDbPoolReplaced(driver: string, url: string, hook: () => void): void;
+/**
+ * Run `hook` when the shared pools are closed, so consumers holding a derived
+ * handle (a Drizzle instance bound to the pool, the Better Auth adapter) drop
+ * it instead of issuing queries on a closed pool.
+ */
+export declare function onSharedDbPoolsClosed(hook: () => void): void;
+export declare function closeSharedDbPools(): Promise<void>;
 export declare function createDbExec(config?: DbExecConfig): Promise<DbExec>;
 /**
  * Get the singleton database client. Returns a `DbExec` whose first
@@ -225,4 +271,5 @@ export declare function annotateMissingTable(err: unknown, sql: unknown): unknow
 export declare function getDbExec(): DbExec;
 /** Close the database connection (for scripts that need cleanup). */
 export declare function closeDbExec(): Promise<void>;
+export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/db/client.d.ts.map

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

package/dist/db/client.js

@@ -766,19 +766,19 @@ export function isServerlessRuntime() {
         !!process.env.CF_PAGES);
 }
 /**
- * postgres.js pool options tuned per runtime. A serverless instance handles
- * one request at a time, so a single connection is enough. Keeping the
- * foreground pool at 1 is important because each instance can also open an
- * app and Better Auth pool; a max of 2 on each pool still exhausted Neon
- * under a burst of warm instances. idle_timeout is shortened on
+ * postgres.js pool options tuned per runtime. idle_timeout is shortened on
  * serverless so a thawed-but-idle instance releases its connections quickly.
- * Long-lived Node servers keep the normal pool for throughput.
+ * Long-lived Node servers keep the larger pool for throughput.
+ *
+ * The cap assumes {@link sharedDbPool}: one pool per URL for the whole
+ * process, not one per consumer. See {@link neonPoolMax} for why the cap must
+ * leave room for concurrency.
  */
 export function pgPoolOptions(url) {
     const serverless = isServerlessRuntime();
     return {
         onnotice: () => { },
-        max: serverless ? 1 : 10,
+        max: serverless ? 4 : 20,
         idle_timeout: serverless ? 20 : 240,
         max_lifetime: 60 * 30,
         connect_timeout: 10,
@@ -788,14 +788,22 @@ export function pgPoolOptions(url) {
     };
 }
 /**
- * Connection cap for the @neondatabase/serverless `Pool`. Same instance
- * accumulation risk as postgres.js — one connection is enough for a
- * foreground serverless invocation and keeps the aggregate app/framework/auth
- * budget bounded.
+ * Connection cap for the @neondatabase/serverless `Pool`.
+ *
+ * TRAP: this number is the ceiling on how many statements one request can have
+ * in flight at once. It used to be 1 on serverless, which made every
+ * `Promise.all([...reads])` in a request serialize behind the single slot —
+ * against a remote endpoint that is ~83ms of pure wait per query, so ten
+ * "concurrent" reads took ~880ms instead of ~86ms. The cap was 1 only because
+ * every consumer built its OWN pool (the DbExec singleton, Better Auth, and one
+ * per `createGetDb()` schema module), so the real per-instance connection count
+ * was that number multiplied by ~6. {@link sharedDbPool} collapses those into
+ * one pool per URL, so the same aggregate budget buys in-request concurrency.
+ * Keep pools shared if you raise this.
  */
 export function neonPoolMax() {
     if (!isServerlessRuntime())
-        return 10;
+        return 20;
     // The durable background-function worker is a SINGLE process per run (unlike
     // the many warm request-instances the foreground serverless has), so it can
     // safely hold a larger pool without risking Neon's connection cap. The agent's
@@ -809,7 +817,7 @@ export function neonPoolMax() {
     // connections reached" across many warm instances.
     if (isBackgroundFunctionPoolContext())
         return 8;
-    return 1;
+    return 4;
 }
 /**
  * Inline mirror of `isInBackgroundFunctionRuntime()`
@@ -903,6 +911,86 @@ export function attachNeonPoolErrorLogger(pool, label = "db/neon") {
         });
     });
 }
+const _sharedDbPools = new Map();
+const _sharedDbPoolCloseHooks = new Set();
+const _sharedDbPoolReplacementHooks = new Map();
+/**
+ * One connection pool per (driver, URL) for the whole process.
+ *
+ * Opening a connection to a remote database costs a full TCP + TLS + auth
+ * round-trip chain (~300-800ms measured against Neon in-region), and it used
+ * to be paid once per CONSUMER: the `getDbExec` singleton, Better Auth, and one
+ * more for every `createGetDb()` schema module (four in core alone, plus each
+ * app's). Their `max` values also multiplied against the provider's connection
+ * cap, which forced each pool down to a size too small to run a request's reads
+ * concurrently.
+ *
+ * TRAP: only consumers that live as long as the process may share. Anything
+ * handed a `close()` — `createDbExec()`, the migration exec on the direct
+ * endpoint — must keep a private pool, or closing it takes the whole process's
+ * database access down with it.
+ */
+export function sharedDbPool(driver, url, create) {
+    const key = `${driver}${url}`;
+    const existing = _sharedDbPools.get(key);
+    if (existing)
+        return existing;
+    const created = create();
+    _sharedDbPools.set(key, created);
+    return created;
+}
+/**
+ * Swap the pool registered for a key, for the postgres.js recycle path that
+ * replaces a pool whose query timed out. Without this the registry would keep
+ * handing out the discarded pool.
+ */
+export function replaceSharedDbPool(driver, url, previous, next) {
+    const key = `${driver}${url}`;
+    if (_sharedDbPools.get(key) !== previous)
+        return;
+    _sharedDbPools.set(key, next);
+    for (const hook of _sharedDbPoolReplacementHooks.get(key) ?? []) {
+        try {
+            hook();
+        }
+        catch {
+            // A consumer's reset must not block the replacement from being used.
+        }
+    }
+}
+/**
+ * Run `hook` when one shared pool is replaced, so derived consumers rebuild
+ * their handles instead of continuing to use the timed-out pool.
+ */
+export function onSharedDbPoolReplaced(driver, url, hook) {
+    const key = `${driver}${String.fromCharCode(0)}${url}`;
+    const hooks = _sharedDbPoolReplacementHooks.get(key) ?? new Set();
+    hooks.add(hook);
+    _sharedDbPoolReplacementHooks.set(key, hooks);
+}
+/**
+ * Run `hook` when the shared pools are closed, so consumers holding a derived
+ * handle (a Drizzle instance bound to the pool, the Better Auth adapter) drop
+ * it instead of issuing queries on a closed pool.
+ */
+export function onSharedDbPoolsClosed(hook) {
+    _sharedDbPoolCloseHooks.add(hook);
+}
+export async function closeSharedDbPools() {
+    const pools = [..._sharedDbPools.values()];
+    _sharedDbPools.clear();
+    for (const hook of _sharedDbPoolCloseHooks) {
+        try {
+            hook();
+        }
+        catch {
+            // A consumer's reset must not block the rest from being released.
+        }
+    }
+    await Promise.all(pools.map((pool) => Promise.resolve(pool.end()).catch(() => {
+        // Already closed (process exiting, provider hung up) — nothing to do.
+    })));
+}
 function disposePostgresPoolEventually(pool, label) {
     if (!pool || typeof pool !== "object")
         return;
@@ -917,8 +1005,6 @@ function disposePostgresPoolEventually(pool, label) {
 // Singleton client — lazy-initialized on first execute() call
 // ---------------------------------------------------------------------------
 let _exec;
-let _pgPool;
-let _neonPool;
 let _sqlite;
 let _initPromise;
 async function executePglite(client, sql) {
@@ -999,10 +1085,13 @@ async function createDbExecInternal(config = {}, trackSingletonResources = false
             // connections, so its direct executions use stateless Neon HTTP instead.
             // The foreground and transaction surface keep the WebSocket pool.
             const bgHttp = isBackgroundFunctionPoolContext();
-            const pool = new Pool({ connectionString: url, max: neonPoolMax() });
+            const makePool = () => new Pool({ connectionString: url, max: neonPoolMax() });
+            // The singleton exec shares the process pool; `createDbExec()` callers own
+            // a `close()` and so must not be handed it.
+            const pool = trackSingletonResources
+                ? sharedDbPool("neon", url, makePool)
+                : makePool();
             attachNeonPoolErrorLogger(pool);
-            if (trackSingletonResources)
-                _neonPool = pool;
             const httpSql = bgHttp ? neon(url, { fullResults: true }) : null;
             async function queryNeonClient(client, sql, timeoutOverrideMs) {
                 const { rawSql, args } = sqlAndArgs(sql);
@@ -1168,6 +1257,8 @@ async function createDbExecInternal(config = {}, trackSingletonResources = false
                     }, 1);
                 },
                 async close() {
+                    if (trackSingletonResources)
+                        return closeSharedDbPools();
                     await pool.end();
                 },
             };
@@ -1247,14 +1338,17 @@ async function createDbExecInternal(config = {}, trackSingletonResources = false
             // idle_timeout also closes idle connections before Neon's ~5min
             // server-side timeout, avoiding ECONNRESET when the server hangs up.
             const createPool = () => postgres(url, pgPoolOptions(url));
-            let pool = createPool();
-            if (trackSingletonResources)
-                _pgPool = pool;
+            // Same rule as the Neon path: the singleton exec shares the process pool,
+            // `createDbExec()` callers own a `close()` and get a private one.
+            let pool = trackSingletonResources
+                ? sharedDbPool("postgres-js", url, createPool)
+                : createPool();
             const recyclePool = (timedOutPool) => {
                 if (pool === timedOutPool) {
                     pool = createPool();
-                    if (trackSingletonResources)
-                        _pgPool = pool;
+                    if (trackSingletonResources) {
+                        replaceSharedDbPool("postgres-js", url, timedOutPool, pool);
+                    }
                 }
                 disposePostgresPoolEventually(timedOutPool, "timed-out pooled query");
             };
@@ -1292,6 +1386,8 @@ async function createDbExecInternal(config = {}, trackSingletonResources = false
                     return result;
                 },
                 async close() {
+                    if (trackSingletonResources)
+                        return closeSharedDbPools();
                     await pool.end();
                 },
             };
@@ -1527,14 +1623,9 @@ export function getDbExec() {
 }
 /** Close the database connection (for scripts that need cleanup). */
 export async function closeDbExec() {
-    if (_pgPool) {
-        await _pgPool.end();
-        _pgPool = undefined;
-    }
-    if (_neonPool) {
-        await _neonPool.end();
-        _neonPool = undefined;
-    }
+    // Both Postgres pools live in the shared registry, which also notifies the
+    // Drizzle / Better Auth consumers bound to them.
+    await closeSharedDbPools();
     if (_sqlite) {
         _sqlite.close();
         _sqlite = undefined;