testing/cross_backend/create_cross_backend_global_setup.ts

Generic vitest globalSetup factory for cross-backend integration suites.

Pairs with make_cross_backend_project: each cross-backend vitest project sets its own test.name, and this factory derives the backend name from that project name (vitest 4 passes the TestProject to globalSetup), picks the matching BackendConfig, spawns + bootstraps it via bootstrap_backend, and provides a serializable handle that *.cross.test.ts files inject and rebuild with reconstruct_bootstrapped_handle.

A consumer's global_setup.ts collapses to:

import {create_cross_backend_global_setup} from
  '@fuzdev/fuz_app/testing/cross_backend/create_cross_backend_global_setup.ts';
import {deno_backend_config, rust_backend_config} from './my_backend_config.js';
import './cross_test_types.js'; // augments inject('backend_handle')

export default create_cross_backend_global_setup({
  configs: {deno: deno_backend_config, rust: rust_backend_config},
});

vitest 4's provide hard-rejects non-serializable values, so the live child / teardown / keeper_transport are stripped via serialize_bootstrapped_handle; the teardown closure stays in the globalSetup process and is returned for vitest to fire after the suite.

view source

Declarations
#

2 declarations

create_cross_backend_global_setup
#

testing/cross_backend/create_cross_backend_global_setup.ts view source

({ configs, derive_name, provide_key, }: CrossBackendGlobalSetupOptions): (project: TestProject) => Promise<() => Promise<void>>

import {create_cross_backend_global_setup} from '@fuzdev/fuz_app/testing/cross_backend/create_cross_backend_global_setup.js';

Build a vitest globalSetup default export. Returns the (project) => teardown function vitest 4 expects.

`__0`

type CrossBackendGlobalSetupOptions

returns

(project: TestProject) => Promise<() => Promise<void>>

CrossBackendGlobalSetupOptions
#

testing/cross_backend/create_cross_backend_global_setup.ts view source

CrossBackendGlobalSetupOptions

import type {CrossBackendGlobalSetupOptions} from '@fuzdev/fuz_app/testing/cross_backend/create_cross_backend_global_setup.js';

`configs`

Map of derived backend name → BackendConfig factory. The derived name (see derive_name) selects the factory; unknown names throw with the full supported list so a misnamed project surfaces clearly.

type Readonly<Record<string, () => BackendConfig>>

readonly

`derive_name?`

Derive the backend name from the vitest project name. Default strips cross_backend_(ts_)?.

type (project_name: string) => string

readonly

`provide_key?`

Key passed to project.provide (and read by inject in test files). Default 'backend_handle'. Augment vitest's ProvidedContext for it.

type string

readonly