first commit

docs/testkit/testing/testing-integration-garage-s3/README.md

@@ -0,0 +1,47 @@
+# @suaveplan/testing-integration-garage-s3 - Garage S3 v2.0.0 testcontainers fixture for @suaveplan/testing-integration
+
+## Summary
+
+Garage S3 v2.0.0 testcontainers fixture for `@suaveplan/testing-integration`.
+
+Implements `ServiceFixture<GarageS3Config>` — manages a Garage container lifecycle including the 7-step init sequence (status, layout assign, layout apply, bucket create, key create, bucket allow, key info). Returns a plain S3 config; consumers bring their own `@aws-sdk/client-s3`.
+
+<!-- begin:auto-docs -->
+## Documentation tree
+
+- [fixture](./src/fixture/garage-s3-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
+  - [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_ <!-- end:auto-docs -->
+<!-- end:auto-docs -->  - [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_- [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_- [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_- [garage-s3-fixture](./src/fixture/garage-s3-fixture.md) — <!-- begin:auto-docs --> _(no submodules)_
+## Install
+
+```bash
+bun add -D @suaveplan/testing-integration-garage-s3
+```
+
+## Quick Start
+
+```typescript
+import { GarageS3Fixture } from "@suaveplan/testing-integration-garage-s3";
+
+const fixture = new GarageS3Fixture();
+const config = await fixture.start();
+// config.endpoint, config.adminEndpoint, config.region, config.bucket
+// config.accessKeyId, config.secretAccessKey
+await fixture.stop();
+```
+
+## Env-bridge passthrough
+
+Set all 4 env vars to skip container startup:
+
+```text
+GARAGE_S3_ENDPOINT=http://localhost:3900
+GARAGE_S3_ADMIN_ENDPOINT=http://localhost:3902
+GARAGE_S3_ACCESS_KEY_ID=your-key-id
+GARAGE_S3_SECRET_ACCESS_KEY=your-secret
+```
+
+## Docs
+
+- [GarageS3Fixture](src/fixture/garage-s3-fixture.md)
+