skills/plugins/document-navigator/docs/testkit/testing/testing-integration-surrealdb/README.md

@suaveplan/testing-integration-surrealdb - SurrealDB v3 testcontainers fixture for @suaveplan/testing-integration

Summary

SurrealDB v3 testcontainers fixture for @suaveplan/testing-integration.

Implements ServiceFixture<SurrealDBConfig> — manages a SurrealDB container lifecycle with env-bridge passthrough, HTTP health checks, and random password generation per run.

Documentation tree

• fixture — (no submodules)
  • surrealdb-fixture — (no submodules)

- [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — _(no submodules)_- [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — _(no submodules)_- [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — _(no submodules)_- [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — _(no submodules)_

Install

bun add -D @suaveplan/testing-integration-surrealdb

Quick Start

import { SurrealDBFixture } from "@suaveplan/testing-integration-surrealdb";

const fixture = new SurrealDBFixture();
const config = await fixture.start();
// config.url, config.username, config.password, config.namespace, config.database
await fixture.stop();

Env-bridge passthrough

Set all three env vars to skip container startup:

SURREALDB_URL=ws://localhost:8000
SURREALDB_USERNAME=root
SURREALDB_PASSWORD=yourpassword

Docs

• SurrealDBFixture