@fuzdev/fuz_app 0.83.0 → 0.84.0

package/dist/testing/schema_ready_fixture.js

@@ -0,0 +1,48 @@
+import './assert_dev_env.js';
+/**
+ * Gen-time helper for the `/ready` schema-drift probe's committed fixture.
+ *
+ * A consumer commits an `expected_schema.json` (the column map a fresh full
+ * migration-chain bootstrap produces) and serves it through
+ * `create_ready_route_spec`. This helper keeps the regenerate-and-verify test
+ * that guards that fixture to ~10 lines: it introspects a freshly-bootstrapped
+ * DB, writes the fixture when an update flag is set, and reads it back so the
+ * caller can assert the committed copy equals a fresh bootstrap — the assertion
+ * that fails when the fixture drifts from the DDLs, so the runtime expectation
+ * can't silently fall behind.
+ *
+ * @module
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { query_public_columns } from '../db/schema_ready.js';
+/**
+ * Introspect the live (bootstrapped) DB's columns, write them to the committed
+ * fixture when `update`, then read the committed fixture back. The caller
+ * asserts `deepEqual(live, committed)`:
+ *
+ * ```ts
+ * const {live, committed} = await sync_expected_schema_fixture({
+ *   db,
+ *   fixture_url: new URL('../../lib/server/expected_schema.json', import.meta.url),
+ *   update: process.env.UPDATE_SCHEMA_READY === '1',
+ * });
+ * assert.deepEqual(live, committed);
+ * ```
+ *
+ * When `update` writes the fixture it emits raw `JSON.stringify` (one array
+ * element per line); Prettier collapses short arrays inline, so run `gro format`
+ * after `UPDATE_SCHEMA_READY=1` before committing or the format check will flag
+ * the regenerated file. (The content is identical either way — the regen test
+ * compares values, not formatting.)
+ *
+ * @returns the live column map and the committed map (post-write when `update`)
+ */
+export const sync_expected_schema_fixture = async (options) => {
+    const { db, fixture_url, update } = options;
+    const live = await query_public_columns(db);
+    if (update) {
+        writeFileSync(fixture_url, JSON.stringify(live, null, '\t') + '\n');
+    }
+    const committed = JSON.parse(readFileSync(fixture_url, 'utf8'));
+    return { live, committed };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_app",
-  "version": "0.83.0",
+  "version": "0.84.0",
   "description": "fullstack app library",
   "glyph": "🗝",
   "logo": "logo.svg",
@@ -14,8 +14,8 @@
     "build": "gro build",
     "check": "gro check",
     "test": "gro test",
-    "test:cross": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_ts_node --project cross_backend_ts_deno --project cross_backend_ts_bun",
-    "test:cross:spine-stub": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_spine_stub",
+    "test:cross:ts": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_ts_node --project cross_backend_ts_deno --project cross_backend_ts_bun",
+    "test:cross:rust-spine-stub": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_rust_spine_stub",
     "test:cross:schema-parity": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_schema_parity",
     "benchmark:cross-impl": "gro run src/benchmarks/cross_impl.bench.ts",
     "preview": "vite preview",
@@ -146,6 +146,10 @@
       "types": "./dist/*.svelte.d.ts",
       "svelte": "./dist/*.svelte",
       "default": "./dist/*.svelte"
+    },
+    "./*.json": {
+      "types": "./dist/*.json.d.ts",
+      "default": "./dist/*.json"
     }
   }
 }

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

@@ -1,66 +0,0 @@
-import '../assert_dev_env.js';
-/**
- * Cross-process `BackendConfig` preset for the non-domain spine consumer,
- * `testing_spine_stub` — a Rust binary that mounts only the spine surface
- * (auth / account / admin / audit / role-grant offers) with no domain
- * layer. fuz_app drives it from `src/test/cross_backend/*.cross.test.ts`
- * to verify its TS spec against the Rust spine end-to-end with no domain
- * implementation in the loop — drift becomes a fuz_app failure rather than
- * a downstream consumer's failure with mixed signals.
- *
- * **Binary discovery — env-supplied, never hardcoded.** The binary lives
- * in a sibling Rust workspace, not in fuz_app, so the preset never bakes a
- * path in. `FUZ_TESTING_SPINE_STUB_BIN` (or the `binary_path` option) must
- * point at a prebuilt binary; the preset throws a clear error when neither
- * is set rather than guessing. Build once with
- * `cargo build -p testing_spine_stub --release` and point the env var at
- * the resulting `target/release/testing_spine_stub`; operators / CI cache
- * the binary across runs for fast spawns.
- *
- * **Operator setup** — the target Postgres database must exist before the
- * harness runs (the harness never issues `CREATE DATABASE`, to avoid
- * forcing a `CREATEDB` grant on the test role):
- *
- * ```bash
- * createdb fuz_app_test_spine_stub 2>/dev/null || true
- * ```
- *
- * The binary self-wipes the auth-namespace schema on every boot
- * (`FUZ_TESTING_RESET_DB_ON_STARTUP=true`, set by the Rust-family builder),
- * so no manual `DROP TABLE` between sessions is needed; per-test reset is
- * the orthogonal `_testing_reset` RPC action `default_cross_process_setup`
- * fires.
- *
- * @module
- */
-import type { BackendConfig } from './backend_config.js';
-/** Env var naming the prebuilt `testing_spine_stub` binary. Required when `binary_path` is omitted. */
-export declare const SPINE_STUB_BIN_ENV = "FUZ_TESTING_SPINE_STUB_BIN";
-/** Default listening port — slots beside zzz's 1175/1176; matches the binary's `DEFAULT_PORT`. */
-export declare const SPINE_STUB_DEFAULT_PORT = 1177;
-/** Default Postgres database — real PG (PGlite isn't reachable from `tokio-postgres`). */
-export declare const SPINE_STUB_DEFAULT_DATABASE_URL = "postgres://localhost/fuz_app_test_spine_stub";
-export interface SpineStubBackendConfigOptions {
-    /** Listening port. Default `SPINE_STUB_DEFAULT_PORT`. */
-    readonly port?: number;
-    /** Postgres connection URL. Default `SPINE_STUB_DEFAULT_DATABASE_URL`. */
-    readonly database_url?: string;
-    /**
-     * Prebuilt binary path. Overrides the `FUZ_TESTING_SPINE_STUB_BIN` env
-     * var. When neither is set the preset throws.
-     */
-    readonly binary_path?: string;
-}
-/**
- * Build the `BackendConfig` for `testing_spine_stub`. Resolves the binary
- * from `options.binary_path` or `FUZ_TESTING_SPINE_STUB_BIN`; throws when
- * neither is set so a missing build surfaces as a clear error rather than
- * a confusing spawn failure. Reconciles the binary's env contract: port
- * via `--port` (and `FUZ_SPINE_STUB_PORT`), daemon-token dir via
- * `FUZ_SPINE_STUB_DIR` (anchored to `paths.root` so the written
- * `{dir}/run/daemon_token` matches the path `spawn_backend` reads).
- *
- * @throws Error when no binary path is available.
- */
-export declare const spine_stub_backend_config: (options?: SpineStubBackendConfigOptions) => BackendConfig;
-//# sourceMappingURL=spine_stub_backend_config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"spine_stub_backend_config.d.ts","sourceRoot":"../src/lib/","sources":["../../../src/lib/testing/cross_backend/spine_stub_backend_config.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAOvD,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,+BAA+B,CAAC;AAE/D,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,0FAA0F;AAC1F,eAAO,MAAM,+BAA+B,iDAAiD,CAAC;AAE9F,MAAM,WAAW,6BAA6B;IAC7C,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,GACrC,UAAS,6BAAkC,KACzC,aAsCF,CAAC"}

package/dist/testing/cross_backend/spine_stub_backend_config.js

@@ -1,53 +0,0 @@
-import '../assert_dev_env.js';
-import { build_test_backend_paths } from './build_test_backend_paths.js';
-import { make_default_rust_backend_config, rust_default_capabilities, } from './default_backend_configs.js';
-/** Env var naming the prebuilt `testing_spine_stub` binary. Required when `binary_path` is omitted. */
-export const SPINE_STUB_BIN_ENV = 'FUZ_TESTING_SPINE_STUB_BIN';
-/** Default listening port — slots beside zzz's 1175/1176; matches the binary's `DEFAULT_PORT`. */
-export const SPINE_STUB_DEFAULT_PORT = 1177;
-/** Default Postgres database — real PG (PGlite isn't reachable from `tokio-postgres`). */
-export const SPINE_STUB_DEFAULT_DATABASE_URL = 'postgres://localhost/fuz_app_test_spine_stub';
-/**
- * Build the `BackendConfig` for `testing_spine_stub`. Resolves the binary
- * from `options.binary_path` or `FUZ_TESTING_SPINE_STUB_BIN`; throws when
- * neither is set so a missing build surfaces as a clear error rather than
- * a confusing spawn failure. Reconciles the binary's env contract: port
- * via `--port` (and `FUZ_SPINE_STUB_PORT`), daemon-token dir via
- * `FUZ_SPINE_STUB_DIR` (anchored to `paths.root` so the written
- * `{dir}/run/daemon_token` matches the path `spawn_backend` reads).
- *
- * @throws Error when no binary path is available.
- */
-export const spine_stub_backend_config = (options = {}) => {
-    const { port = SPINE_STUB_DEFAULT_PORT, database_url = SPINE_STUB_DEFAULT_DATABASE_URL, binary_path = process.env[SPINE_STUB_BIN_ENV], } = options;
-    if (!binary_path) {
-        throw new Error(`spine_stub_backend_config: no binary path — set ${SPINE_STUB_BIN_ENV} to a prebuilt ` +
-            '`testing_spine_stub` binary (build it with `cargo build -p testing_spine_stub --release`) ' +
-            'or pass `binary_path`.');
-    }
-    const name = 'spine_stub';
-    const paths = build_test_backend_paths(name);
-    return make_default_rust_backend_config({
-        name,
-        port,
-        // `--port` is the binary's authoritative port input; the
-        // `FUZ_SPINE_STUB_PORT` env the builder also sets (via `port_env_var`)
-        // is the lower-precedence fallback — both carry the same value.
-        start_command: [binary_path, '--port', String(port)],
-        database_url,
-        // The stub now serves `GET /api/admin/audit/stream` (the spine
-        // `fuz_realtime::SseRegistry` + audit listener), so it advertises `sse`
-        // like the TS spines — the cross-process SSE suite's three cases run.
-        capabilities: { ...rust_default_capabilities, sse: true },
-        port_env_var: 'FUZ_SPINE_STUB_PORT',
-        rust_log: 'info,testing_spine_stub=info',
-        paths,
-        extra_env: {
-            // The binary writes its daemon-token JSON to
-            // `{FUZ_SPINE_STUB_DIR}/run/daemon_token`; anchoring the dir to
-            // `paths.root` makes that equal `paths.daemon_token_path`, which
-            // `spawn_backend` reads after the health probe.
-            FUZ_SPINE_STUB_DIR: paths.root,
-        },
-    });
-};