@fuzdev/fuz_app 0.133.0 → 0.134.0

package/dist/testing/app_server.js

@@ -16,7 +16,7 @@ import { create_realtime_closer } from '../actions/connection_closer.js';
 import { default_audit_factory } from '../server/app_backend.js';
 import { create_app_server } from '../server/app_server.js';
 import { generate_daemon_token, DAEMON_TOKEN_HEADER } from '../auth/daemon_token.js';
-import { create_pglite_factory } from './db.js';
+import { create_default_db_factory } from './db.js';
 import { token_scope_full } from '../auth/token_scope.js';
 /**
  * Fast password stub for tests that don't exercise login/password flows.
@@ -31,21 +31,22 @@ export const stub_password_deps = {
 };
 /** 64-hex-char test cookie secret — deterministic, never used in production. */
 export const TEST_COOKIE_SECRET = 'a'.repeat(64);
-// Module-level PGlite factory for create_test_app_server when no db is provided.
-// Shares the WASM instance cache from `testing/db.ts`, avoiding redundant cold starts
-// within one loaded copy of that module. Schema is reset on each create() call.
-const fallback_pglite_factory = create_pglite_factory(async (db) => {
+// Module-level default factory (pglet-wasm unless `set_default_db_factory` installed
+// another) for create_test_app_server when no db is provided. Shares the WASM instance
+// cache from `testing/db.ts`, avoiding redundant cold starts within one loaded copy of
+// that module. Schema is reset on each create() call.
+const fallback_db_factory = create_default_db_factory(async (db) => {
     await run_migrations(db, [auth_migration_ns]);
 });
-// Auto-created PGlite factories keyed by extra-namespace identity. Suites
+// Auto-created default factories keyed by extra-namespace identity. Suites
 // whose backend needs tables beyond auth (e.g. the cell layer) share one
 // factory per distinct namespace set — and the worker-cached WASM instance —
 // rather than each hand-building its own. The cell parity suite is the first
 // user.
 const fallback_factories_by_namespaces = new Map();
 /**
- * Resolve the no-`db` PGlite factory for the requested extra migration
- * namespaces. Empty / omitted → the shared auth-only `fallback_pglite_factory`;
+ * Resolve the no-`db` default factory for the requested extra migration
+ * namespaces. Empty / omitted → the shared auth-only `fallback_db_factory`;
  * otherwise a memoized factory whose `init` runs
  * `[auth_migration_ns, ...migration_namespaces]` on each reset. The
  * reset-on-`create` gives the same fresh-db-per-test isolation as the
@@ -54,12 +55,12 @@ const fallback_factories_by_namespaces = new Map();
  */
 const resolve_fallback_factory = (migration_namespaces) => {
     if (!migration_namespaces || migration_namespaces.length === 0) {
-        return fallback_pglite_factory;
+        return fallback_db_factory;
     }
     const key = migration_namespaces.map((ns) => ns.namespace).join(',');
     let factory = fallback_factories_by_namespaces.get(key);
     if (!factory) {
-        factory = create_pglite_factory(async (db) => {
+        factory = create_default_db_factory(async (db) => {
             await run_migrations(db, [auth_migration_ns, ...migration_namespaces]);
         });
         fallback_factories_by_namespaces.set(key, factory);
@@ -176,7 +177,7 @@ const default_test_fs_stubs = {
  * resets it to false before this runs).
  */
 const _build_test_backend = async (options) => {
-    const { db: existing_db, db_type = 'pglite-memory', password = stub_password_deps, audit_factory = default_audit_factory, fs_stubs = default_test_fs_stubs, migration_namespaces } = options;
+    const { db: existing_db, db_type = 'pglet-memory', password = stub_password_deps, audit_factory = default_audit_factory, fs_stubs = default_test_fs_stubs, migration_namespaces } = options;
     if (existing_db && migration_namespaces && migration_namespaces.length > 0) {
         throw new Error('test app setup: pass either `db` (caller owns migrations) or `migration_namespaces` ' +
             '(harness migrates), not both');
@@ -188,14 +189,14 @@ const _build_test_backend = async (options) => {
     let db;
     let db_name;
     if (existing_db) {
-        // Reset singleton config row from a previous test (harmless on fresh pglite).
+        // Reset singleton config row from a previous test (harmless on a fresh database).
         await existing_db.query('UPDATE app_settings SET open_signup = false, updated_at = NULL, updated_by = NULL WHERE open_signup = true OR updated_at IS NOT NULL');
         db = existing_db;
         db_name = 'test';
     }
     else {
-        // In-memory PGlite via cached factory — reuses the WASM instance from `testing/db.ts`
-        // instead of creating a new PGlite each time. Schema is reset and migrations re-run
+        // In-memory default driver via cached factory — reuses the WASM instance from
+        // `testing/db.ts` instead of creating a new instance each time. Schema is reset and migrations re-run
         // on each call, but the expensive WASM cold start only happens once per loaded
         // copy of `testing/db.ts` — under the `db` project's `isolate: false` +
         // `fileParallelism: false` that is once for the whole run.
@@ -205,11 +206,11 @@ const _build_test_backend = async (options) => {
     }
     const backend = {
         // a supplied `db` reports the caller's `db_type`; the auto-created one names
-        // PGlite unconditionally — a run that installs a substitute factory
-        // (`set_substitute_db_factory`) before this module loads gets that driver
+        // pglet unconditionally — a run that installs another default factory
+        // (`set_default_db_factory`) before this module loads gets that driver
         // here, and no caller reads this field to pick behavior: it is reported,
         // not dispatched on
-        db_type: existing_db ? db_type : 'pglite-memory',
+        db_type: existing_db ? db_type : 'pglet-memory',
         db_name,
         // the factory's init ran the migrations, for a supplied `db` and the auto-created one alike
         migration_results: [],
@@ -230,7 +231,7 @@ const _build_test_backend = async (options) => {
  * Create an app server with a bootstrapped account for testing.
  *
  * Sets up:
- * - Auth tables (via cached PGlite factory, or reuses existing `db`)
+ * - Auth tables (via the cached default factory, or reuses existing `db`)
  * - A keeper account with hashed password
  * - Role role_grants for each role in `options.roles`
  * - An API token for Bearer auth
@@ -310,7 +311,7 @@ const create_bearer_headers_builder = (api_token) => (extra) => ({
  *
  * A fresh Hono app is created each call — middleware closures bind to the
  * server's deps (db, keyring), so reuse across servers is unsafe.
- * The expensive resource (PGlite WASM) is cached separately in `testing/db.ts`.
+ * The expensive resource (the WASM database) is cached separately in `testing/db.ts`.
  *
  * @param options - test app configuration
  * @returns a `TestApp` ready for HTTP testing
@@ -408,7 +409,7 @@ export const create_test_app_for_bootstrap = async (options) => {
     const { session_options, bootstrap, bootstrap_token } = options;
     // Caller-supplied DB may carry lock state from a prior test — reset to false
     // before `_build_test_backend` runs (which doesn't touch the lock itself).
-    // Fresh pglite already starts at false (factory init).
+    // A fresh database already starts at false (factory init).
     if (options.db) {
         await options.db.query('UPDATE bootstrap_lock SET bootstrapped = false WHERE bootstrapped = true');
     }

package/dist/testing/cross_backend/default_backend_configs.d.ts

@@ -11,11 +11,11 @@ import '../assert_dev_env.js';
  *
  * Defaults baked in by family:
  *
- * - **TS** — `'memory://'` PGlite, 30s startup window. Its shape notes
+ * - **TS** — `'memory://'` (in-memory pglet), 30s startup window. Its shape notes
  *   (`ts_default_shape_notes`) record `trusted_proxy: false` /
  *   `login_rate_limit: false` — the TS canonical path leaves those limiters
  *   null in test mode.
- * - **Rust** — caller-supplied real Postgres URL (PGlite isn't reachable
+ * - **Rust** — caller-supplied real Postgres URL (an in-process WASM database isn't reachable
  *   from `tokio-postgres`), 120s startup window (cargo first-build cost), the
  *   `FUZ_TESTING_RESET_DB_ON_STARTUP=true` self-wipe gate, and shape notes
  *   (`rust_default_shape_notes`) recording `trusted_proxy: true` +
@@ -82,7 +82,7 @@ export interface MakeDefaultTsBackendConfigOptions {
     readonly port: number;
     /** argv passed to the spawn (first entry is the binary). */
     readonly start_command: ReadonlyArray<string>;
-    /** Defaults to `'memory://'` (in-memory PGlite). */
+    /** Defaults to `'memory://'` (in-memory pglet). */
     readonly database_url?: string;
     /** Merged on top of the generic env baseline; later keys win. */
     readonly extra_env?: Readonly<Record<string, string>>;
@@ -109,7 +109,7 @@ export interface MakeDefaultTsBackendConfigOptions {
 }
 /**
  * Shared builder for TS-family backends (Deno + Node). Owns the common
- * env baseline (NODE_ENV, HOST, PORT, in-memory PGlite, cookie keys,
+ * env baseline (NODE_ENV, HOST, PORT, in-memory pglet, cookie keys,
  * bootstrap token path) so per-backend factories only declare what
  * genuinely differs.
  */
@@ -122,7 +122,7 @@ export interface MakeDefaultRustBackendConfigOptions {
     /** argv passed to the spawn (first entry is the binary). */
     readonly start_command: ReadonlyArray<string>;
     /**
-     * Required — Rust needs real Postgres (PGlite isn't reachable from
+     * Required — Rust needs real Postgres (an in-process WASM database isn't reachable from
      * `tokio-postgres`). Consumers typically supply
      * `'postgres://localhost/{repo}_test_{name}'`.
      */

package/dist/testing/cross_backend/default_backend_configs.d.ts.map

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

package/dist/testing/cross_backend/default_backend_configs.js

@@ -131,7 +131,7 @@ const build_default_bootstrap = (paths, overrides) => ({
 });
 /**
  * Shared builder for TS-family backends (Deno + Node). Owns the common
- * env baseline (NODE_ENV, HOST, PORT, in-memory PGlite, cookie keys,
+ * env baseline (NODE_ENV, HOST, PORT, in-memory pglet, cookie keys,
  * bootstrap token path) so per-backend factories only declare what
  * genuinely differs.
  */

package/dist/testing/cross_backend/in_process_setup.d.ts

@@ -44,8 +44,8 @@ export interface InProcessSetupOptions extends CreateTestAppOptions {
  * `_testing_reset` cradle so suite bodies read
  * `fixture.extra_accounts[username]` uniformly regardless of transport.
  *
- * The describe-level `auth_integration_truncate_tables` / pglite WASM
- * cache lifecycle stays in `create_pglite_factory` / `create_describe_db`
+ * The describe-level `auth_integration_truncate_tables` / WASM database
+ * cache lifecycle stays in `create_default_db_factory` / `create_describe_db`
  * (`testing/db.ts`) — `default_in_process_setup` doesn't manage db state
  * beyond what `create_test_app` already does.
  */

package/dist/testing/cross_backend/in_process_setup.js

@@ -32,14 +32,14 @@ const in_process_fetch_transport = (app) => {
  * `_testing_reset` cradle so suite bodies read
  * `fixture.extra_accounts[username]` uniformly regardless of transport.
  *
- * The describe-level `auth_integration_truncate_tables` / pglite WASM
- * cache lifecycle stays in `create_pglite_factory` / `create_describe_db`
+ * The describe-level `auth_integration_truncate_tables` / WASM database
+ * cache lifecycle stays in `create_default_db_factory` / `create_describe_db`
  * (`testing/db.ts`) — `default_in_process_setup` doesn't manage db state
  * beyond what `create_test_app` already does.
  */
 export const default_in_process_setup = (options) => async () => {
     // Per-test fresh db. When `options.migration_namespaces` is set,
-    // `create_test_app` provisions an auth+extras PGlite (e.g. the cell
+    // `create_test_app` provisions an auth+extras database (e.g. the cell
     // layer); otherwise the auth-only default. Either way the factory
     // resets + re-migrates on each `create`, so the per-test keeper
     // bootstrap below lands on a clean DB.

package/dist/testing/cross_backend/test_cell_gated_create_authorize.js

@@ -18,7 +18,7 @@ import '../assert_dev_env.js';
  *   admits with the entry's `moderation_required` folded into the verdict. The
  *   root's `data` arrives in `input.root_data` (the handler read it in-tx), so
  *   the predicate is **pure** — no DB read of its own (which also dodges the
- *   single-connection PGlite deadlock a separate handle would hit).
+ *   single-connection in-memory deadlock a separate handle would hit — pglet, PGlite).
  *
  * @module
  */

package/dist/testing/cross_backend/testing_reset_actions.d.ts

@@ -482,8 +482,8 @@ export interface CreateTestingActionsOptions {
      * Consumer-supplied callback invoked after the auth-table reset, passed
      * the same transactional `Db` the auth wipes ran on. DB-domain consumers
      * (e.g. fuz_forge truncating its cell / fact / file tables) MUST use this
-     * `db` rather than a separately-pooled connection — under PGlite's single
-     * connection a second connection deadlocks against this still-open
+     * `db` rather than a separately-pooled connection — under the in-memory
+     * drivers' single connection (pglet, PGlite) a second connection deadlocks against this still-open
      * transaction. `testing_zzz_server` clears in-memory workspace registry +
      * terminals + scoped-FS scratch (ignores `db`); `testing_spine_stub` has
      * no domain layer and omits the option. Runs inside the same RPC dispatch

package/dist/testing/cross_backend/testing_reset_actions.js

@@ -527,7 +527,7 @@ export const create_testing_actions = (deps, options) => {
             //    fuz_forge cell/fact/file truncation, or no-op for spine_stub).
             //    Pass the transactional `ctx.db` so DB-domain truncation runs
             //    on the same connection — a separate pool connection deadlocks
-            //    against this open transaction under PGlite.
+            //    against this open transaction under the in-memory drivers.
             if (reset_state)
                 await reset_state(ctx.db);
             return { ...keeper, extra_accounts: extras, extra_actors };

package/dist/testing/cross_backend/ts_spine_backend_config.d.ts

@@ -7,7 +7,7 @@ import '../assert_dev_env.js';
  * these spawn fuz_app's own TS impl over real HTTP with no domain layer, so
  * the `cross_backend_ts_node` / `cross_backend_ts_deno` / `cross_backend_ts_bun`
  * self-test projects verify fuz_app's wire path in its own repo across all
- * three JS runtimes. All run against in-memory PGlite (`memory://`) — no
+ * three JS runtimes. All run against in-memory pglet (`memory://`) — no
  * external Postgres, unlike the Rust path.
  *
  * The binary writes its daemon token to `{FUZ_TESTING_TS_SPINE_DIR}/run/daemon_token`;
@@ -32,7 +32,7 @@ export declare const TS_SPINE_BUN_ENTRY = "src/test/cross_backend/testing_spine_
 export interface TsSpineBackendConfigOptions {
     /** Listening port. Defaults per runtime (`1178` Node, `1179` Deno, `1180` Bun). */
     readonly port?: number;
-    /** Database URL. Default `'memory://'` (in-memory PGlite). */
+    /** Database URL. Default `'memory://'` (in-memory pglet). */
     readonly database_url?: string;
     /**
      * Enable the per-IP + per-account login rate limiters on the spawned binary

package/dist/testing/cross_backend/ts_spine_backend_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ts_spine_backend_config.d.ts","sourceRoot":"../src/lib/","sources":["../../../src/lib/testing/cross_backend/ts_spine_backend_config.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAsDzD,6FAA6F;AAC7F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,gDAAgD;AAChD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,wDAAwD,CAAC;AAEzF,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,wDAAwD,CAAC;AAEzF,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,uDAAuD,CAAC;AAEvF,MAAM,WAAW,2BAA2B;IAC3C,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;;;OASG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACjD;AAWD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACxC,UAAS,2BAAgC,KACvC,aAoBF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACvC,UAAS,2BAAgC,KACvC,aAoBF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,GACxC,UAAS,2BAAgC,KACvC,aAiCF,CAAC"}
+{"version":3,"file":"ts_spine_backend_config.d.ts","sourceRoot":"../src/lib/","sources":["../../../src/lib/testing/cross_backend/ts_spine_backend_config.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAsDzD,6FAA6F;AAC7F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,gDAAgD;AAChD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,wDAAwD,CAAC;AAEzF,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,wDAAwD,CAAC;AAEzF,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,uDAAuD,CAAC;AAEvF,MAAM,WAAW,2BAA2B;IAC3C,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;;;OASG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACjD;AAWD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GACxC,UAAS,2BAAgC,KACvC,aAoBF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACvC,UAAS,2BAAgC,KACvC,aAoBF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,GACxC,UAAS,2BAAgC,KACvC,aAiCF,CAAC"}

package/dist/testing/db.d.ts

@@ -1,9 +1,5 @@
 import './assert_dev_env.js';
 import type { Db } from '../db/db.js';
-/**
- * CI detection — `CI=true` is set automatically by GitHub Actions, GitLab CI, etc.
- */
-export declare const IS_CI: boolean;
 /**
  * Factory interface for creating test database instances.
  */
@@ -15,75 +11,83 @@ export interface DbFactory {
     skip_reason?: string;
 }
 /**
- * Reset a test database to a clean state by dropping and recreating the public schema.
+ * Reset a test database to a clean slate by dropping and recreating the `public` schema.
  *
- * Removes all tables, sequences, indexes, types, and functions.
- * The database instance remains usable after reset. Despite the name it issues
- * plain SQL, so it also resets the other drivers the test factories hand out.
+ * `DROP SCHEMA public CASCADE; CREATE SCHEMA public` in plain SQL, so it resets
+ * every driver: the in-memory factories call it on each `create()`, and it is
+ * recommended at the start of `init_schema` callbacks for `create_pg_factory`,
+ * whose persistent databases accumulate stale DDL across fuz_app versions.
+ * Drift-proof — it wipes every table, type, and sequence regardless of
+ * namespace, so it needs no upkeep when the schema gains a table. The database
+ * instance remains usable after reset.
  *
  * @mutates db - drops the `public` schema and recreates it; all rows in all
  *   tables are gone after this returns.
  */
-export declare const reset_pglite: (db: Db) => Promise<void>;
+export declare const reset_public_schema: (db: Db) => Promise<void>;
 /**
- * Builds a `DbFactory` from a schema initializer — `create_pglite_factory`'s own shape.
+ * Builds a `DbFactory` from a schema initializer — the shape of every factory builder here.
  */
 export type DbFactoryBuilder = (init_schema: (db: Db) => Promise<void>) => DbFactory;
 /**
- * Options for `create_pglite_factory`.
+ * Create a PGlite (in-memory) database factory for tests.
+ *
+ * Always enabled — needs the optional `@electric-sql/pglite` peer installed.
+ * Shares one PGlite WASM instance across the PGlite factories this module
+ * builds; each `create()` resets the schema via `DROP SCHEMA public CASCADE`
+ * instead of paying the cold start again.
+ *
+ * @param init_schema - callback to initialize the database schema
  */
-export interface CreatePgliteFactoryOptions {
-    /**
-     * Whether an installed substitute (`set_substitute_db_factory`) may stand in
-     * for the PGlite factory at this call site. Defaults to `true`; pass `false`
-     * where PGlite itself is the subject under test.
-     */
-    substitutable?: boolean;
-}
+export declare const create_pglite_factory: DbFactoryBuilder;
 /**
- * Install a builder that stands in for `create_pglite_factory`, so suites
- * written against PGlite can run against another driver without being edited.
+ * Create a pglet-wasm (in-memory) database factory for tests.
+ *
+ * Always enabled — needs the optional `@fuzdev/pglet-wasm` peer installed.
+ * Shares one pglet instance across the pglet-wasm factories this module
+ * builds, created with fuz_app's value coercion (`PGLET_COERCION`); each
+ * `create()` resets the schema via `DROP SCHEMA public CASCADE`.
  *
- * Injected rather than selected here: the drivers a substitute wraps live in
- * test-side code this shipped module cannot import. A call site that passes
- * `{substitutable: false}` keeps PGlite regardless. Pass `null` to uninstall.
+ * @param init_schema - callback to initialize the database schema
+ */
+export declare const create_pglet_wasm_factory: DbFactoryBuilder;
+/**
+ * Install the builder `create_default_db_factory` uses, so suites written
+ * against the default run against another driver without being edited —
+ * `create_pglite_factory` to run them on PGlite. Pass `null` to restore
+ * pglet-wasm.
  *
  * The slot is read when a factory is built, not when it creates a database,
- * so install before the first `create_pglite_factory` call — a vitest
+ * so install before the first `create_default_db_factory` call — a vitest
  * `setupFiles` entry, which runs ahead of every test file's imports, is the
  * shape fuz_app's own `db` project uses. A factory built earlier (including
  * the module-level fallback in `testing/app_server.ts`) keeps the driver it
  * was built with, and uninstalling does not revert it.
  *
- * @param create_factory - the builder to install, or `null` to remove the installed one
+ * @param create_factory - the builder to install, or `null` to restore the default
+ * @returns the builder this replaced (`null` for pglet-wasm), so a caller can put it back
  */
-export declare const set_substitute_db_factory: (create_factory: DbFactoryBuilder | null) => void;
+export declare const set_default_db_factory: (create_factory: DbFactoryBuilder | null) => DbFactoryBuilder | null;
 /**
- * Create a pglite (in-memory) database factory for tests.
- *
- * Always enabled — no external dependencies required.
- * Shares a single PGlite WASM instance across the PGlite factories this module builds.
- * Subsequent `create()` calls reset the schema via `DROP SCHEMA public CASCADE`
- * instead of paying the WASM cold-start cost again.
+ * Create the default in-memory database factory for tests: pglet-wasm, or the
+ * builder `set_default_db_factory` installed.
  *
- * Returns the installed substitute's factory instead when one is installed and
- * `options.substitutable` is not `false` — see `set_substitute_db_factory`.
+ * The factory fuz_app's own test helpers fall back to when a suite passes none
+ * (`create_test_app_server`, `describe_rate_limiting_tests`,
+ * `describe_sse_route_tests`). Call `create_pglite_factory` or
+ * `create_pglet_wasm_factory` directly to pin a driver.
  *
  * @param init_schema - callback to initialize the database schema
- * @param options - `substitutable: false` pins this call site to PGlite
  */
-export declare const create_pglite_factory: (init_schema: (db: Db) => Promise<void>, options?: CreatePgliteFactoryOptions) => DbFactory;
+export declare const create_default_db_factory: DbFactoryBuilder;
 /**
  * Create a pg (PostgreSQL) database factory for tests.
  *
- * Skipped when `test_url` is not provided.
- * Drops `schema_version` before running `init_schema`, forcing migrations
- * to re-evaluate against the actual tables. Prevents stale tracker rows
- * from skipping migrations when DDL changes between test sessions.
- *
- * For full clean-slate behavior (recommended), call `drop_auth_schema(db)`
- * at the start of `init_schema` before running migrations. This handles
- * upstream schema changes that go beyond adding new tables/columns.
+ * Skipped when `test_url` is not provided. Each `create()` opens a pool,
+ * resets the `public` schema (`reset_public_schema`) and runs `init_schema` —
+ * the lifecycle every factory here shares, so a persistent test database never
+ * carries stale DDL or tracker rows from an earlier run or another suite's
+ * schema. Point `test_url` at a database used only for tests.
  *
  * @param init_schema - callback to initialize the database schema
  * @param test_url - PostgreSQL connection URL (e.g. from `TEST_DATABASE_URL`)
@@ -107,21 +111,6 @@ export declare const auth_truncate_tables: string[];
  * touch audit logging don't need to truncate it.
  */
 export declare const auth_integration_truncate_tables: string[];
-/**
- * Reset the entire `public` schema for a clean slate before re-migration.
- *
- * Recommended at the start of `init_schema` callbacks for `create_pg_factory`.
- * Persistent test databases accumulate stale DDL across fuz_app versions;
- * `DROP SCHEMA public CASCADE; CREATE SCHEMA public` wipes every table, type,
- * and sequence regardless of namespace, so migrations always run against a
- * truly empty database. Drift-proof — unlike a hand-maintained drop list it
- * needs no upkeep when the schema gains a table. Despite the historical name,
- * this resets the whole schema, not just auth tables (the only documented use
- * is clean-slate re-migration, which always wanted a full reset).
- *
- * @mutates db - drops and recreates the `public` schema; all tables gone.
- */
-export declare const drop_auth_schema: (db: Db) => Promise<void>;
 /**
  * Create a `describe_db` function bound to specific factories and truncate tables.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/db.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AA8B7B,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAMtC;;GAEG;AACH,eAAO,MAAM,KAAK,SAA4B,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAU,IAAI,EAAE,KAAG,OAAO,CAAC,IAAI,CAGvD,CAAC;AAQF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,GAAI,gBAAgB,gBAAgB,GAAG,IAAI,KAAG,IAEnF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GACjC,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EACtC,UAAU,0BAA0B,KAClC,SAyBF,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,GAC7B,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EACtC,WAAW,MAAM,KACf,SAgEF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,UAQhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,UAAyC,CAAC;AAEvF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAAU,IAAI,EAAE,KAAG,OAAO,CAAC,IAAI,CAG3D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAC9B,WAAW,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,EACvC,iBAAiB,KAAK,CAAC,MAAM,CAAC,KAC5B,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,IAAI,CAwBzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW,KAAK,CAAC,SAAS,CAAC,KAAG,IAQnE,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,GACrC,IAAI,EAAE,EACN,OAAO,MAAM,EACb,SAAS,aAAa,CAAC,MAAM,CAAC,KAC5B,OAAO,CAAC,IAAI,CAId,CAAC"}
+{"version":3,"file":"db.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/db.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AA8B7B,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAQtC;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAAU,IAAI,EAAE,KAAG,OAAO,CAAC,IAAI,CAG9D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AAgDrF;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBACqC,CAAC;AAE1E;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBACyC,CAAC;AAKlF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,GAClC,gBAAgB,gBAAgB,GAAG,IAAI,KACrC,gBAAgB,GAAG,IAIrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAC+B,CAAC;AAExE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAC7B,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EACtC,WAAW,MAAM,KACf,SA6DF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,UAQhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,UAAyC,CAAC;AAEvF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAC9B,WAAW,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,EACvC,iBAAiB,KAAK,CAAC,MAAM,CAAC,KAC5B,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,IAAI,CAwBzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW,KAAK,CAAC,SAAS,CAAC,KAAG,IAQnE,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,yBAAyB,GACrC,IAAI,EAAE,EACN,OAAO,MAAM,EACb,SAAS,aAAa,CAAC,MAAM,CAAC,KAC5B,OAAO,CAAC,IAAI,CAId,CAAC"}