first commit

docs/testkit/testing/testing-integration-surrealdb/README.md

@@ -0,0 +1,45 @@
+# @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.
+
+<!-- begin:auto-docs -->
+## Documentation tree
+
+- [fixture](./src/fixture/surrealdb-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
+  - [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
+<!-- end:auto-docs -->  - [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_- [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_- [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_- [surrealdb-fixture](./src/fixture/surrealdb-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_
+## Install
+
+```bash
+bun add -D @suaveplan/testing-integration-surrealdb
+```
+
+## Quick Start
+
+```typescript
+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:
+
+```text
+SURREALDB_URL=ws://localhost:8000
+SURREALDB_USERNAME=root
+SURREALDB_PASSWORD=yourpassword
+```
+
+## Docs
+
+- [SurrealDBFixture](src/fixture/surrealdb-fixture.md)
+