rightsize 0.4.0 → 0.5.0

package/README.md

@@ -62,7 +62,7 @@ import "rightsize/backend-msb";
 import "rightsize/backend-docker";
 ```
 
-Drive any image directly with `GenericContainer`, or use one of eighteen
+Drive any image directly with `GenericContainer`, or use one of twenty-one
 preconfigured modules:
 
 ```ts
@@ -88,6 +88,7 @@ a `GenericContainer` subclass, so the fluent builders (`withEnv`,
 | Module | Helpers |
 |---|---|
 | `RedisContainer` | `uri` |
+| `ValkeyContainer` | `uri` (`redis://` scheme — Valkey speaks the Redis wire protocol) |
 | `MemcachedContainer` | `address` |
 | `ArangoContainer` | `endpoint`; `withRootPassword(...)` to enable auth (default: no-auth) |
 | `MongoDBContainer` | `connectionString`, `replicaSetUrl` (alias) — single-node replica set, auto-initiated |
@@ -105,11 +106,14 @@ a `GenericContainer` subclass, so the fluent builders (`withEnv`,
 | `Neo4jContainer` | `httpUrl`, `boltUrl`, `username`, `password`; `withPassword(...)` — HTTP Cypher endpoint (username fixed at `neo4j`) |
 | `FlociContainer` | `FlociContainer.aws()`/`.azure()`/`.gcp()` factories, `endpointUrl` — [floci.io](https://floci.io) cloud emulators (unsigned REST, no SDK needed) |
 | `FlinkContainer` | `restUrl`; `withTaskManager()` for a full session cluster — **Docker only**¹ |
+| `MinIOContainer` | `endpointUrl`, `rootUser`, `rootPassword`; `withRootUser`/`withRootPassword(...)` — S3-compatible object store |
+| `CassandraContainer` | `contactPoint`, `cqlPort`, `localDatacenter` |
 
 Some modules raise a memory floor for their image (`withMemoryLimit`):
 heavyweight JVM images - Spring Cloud Config, Keycloak, Neo4j, Flink
-(1024 MB) - and Pinot's multi-JVM QuickStart cluster (4096 MB) - need more
-than the microVM default. That's baked into the module; you don't set it.
+(1024 MB), Cassandra (2560 MB) - and Pinot's multi-JVM QuickStart cluster
+(4096 MB) - need more than the microVM default. That's baked into the
+module; you don't set it.
 Every module's page under [`docs/modules/`](https://ngriaznov.github.io/rightsize-node/modules/)
 documents its exact image tag, wait strategy, and the measured reasoning
 behind these choices.

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  * contracts plus the `registerBackend` registry, and the typed error
  * classes. This module depends on no backend — import `rightsize/backend-msb`
  * and/or `rightsize/backend-docker` to register one, or `rightsize/modules`
- * for the eighteen preconfigured containers built on top of this surface.
+ * for the twenty-one preconfigured containers built on top of this surface.
  *
  * @packageDocumentation
  */

package/dist/index.js

@@ -8,7 +8,7 @@
  * contracts plus the `registerBackend` registry, and the typed error
  * classes. This module depends on no backend — import `rightsize/backend-msb`
  * and/or `rightsize/backend-docker` to register one, or `rightsize/modules`
- * for the eighteen preconfigured containers built on top of this surface.
+ * for the twenty-one preconfigured containers built on top of this surface.
  *
  * @packageDocumentation
  */

package/dist/modules/cassandra.d.ts

@@ -0,0 +1,49 @@
+import { GenericContainer } from "../core/generic-container.js";
+/**
+ * A single-node Cassandra container.
+ *
+ * ### `GPG_KEYS` must be overridden — this is the difference between booting and aborting
+ *
+ * `cassandra:5.0.8`'s baked-in `GPG_KEYS` build arg contains a literal TAB
+ * character, and msb 0.6.6 panics on any image whose baked env contains one
+ * — before the guest even boots:
+ *
+ * ```
+ * sandbox process exited (signal: 6 (SIGABRT)) before agent relay became available
+ * ```
+ *
+ * with `msb logs --source system` showing:
+ *
+ * ```
+ * panicked at msb_krun_vmm-0.1.25/src/builder.rs:1154: ... Err value: InvalidAscii
+ * ```
+ *
+ * `GPG_KEYS` is consumed only at image-build time (verifying the signing
+ * keys baked into that layer) — it has no effect on the running container,
+ * so overriding it to an empty, tab-free string here is safe and required.
+ * Without this override, `start()` never gets far enough to run its own
+ * wait strategy at all.
+ *
+ * ### Heap sized down, memory ceiling measured
+ *
+ * `MAX_HEAP_SIZE=512M`/`HEAP_NEWSIZE=128M` keep the JVM small; `2560` MB is
+ * the verified memory ceiling at that heap size.
+ *
+ * ### Readiness
+ *
+ * Anchored on the CQL native-transport log line (`Starting listening for
+ * CQL clients`), observed at 58s on a quiet local machine. 300s absorbs a
+ * loaded-host boot without masking a real hang — Cassandra is heavier than
+ * either Keycloak or MySQL, both of which carry 180s in this library.
+ */
+export declare class CassandraContainer extends GenericContainer {
+    constructor(image?: string);
+    static start(image?: string): Promise<CassandraContainer>;
+    /** `<host>:<port>` for the running container — the shape most CQL drivers want for a contact point. */
+    get contactPoint(): string;
+    /** The mapped CQL native-transport port. */
+    get cqlPort(): number;
+    /** This single node's local datacenter name — required by drivers (e.g. the DataStax Node driver) that insist on an explicit value at connect time. */
+    get localDatacenter(): string;
+}
+//# sourceMappingURL=cassandra.d.ts.map

package/dist/modules/cassandra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cassandra.d.ts","sourceRoot":"","sources":["../../src/modules/cassandra.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,KAAK,SAAoB;WAaf,KAAK,CAAC,KAAK,SAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAInF,uGAAuG;IACvG,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,4CAA4C;IAC5C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,uJAAuJ;IACvJ,IAAI,eAAe,IAAI,MAAM,CAE5B;CACF"}

package/dist/modules/cassandra.js

@@ -0,0 +1,69 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { Wait } from "../core/wait.js";
+const CQL_PORT = 9042;
+const STARTUP_TIMEOUT_MS = 300_000;
+/**
+ * A single-node Cassandra container.
+ *
+ * ### `GPG_KEYS` must be overridden — this is the difference between booting and aborting
+ *
+ * `cassandra:5.0.8`'s baked-in `GPG_KEYS` build arg contains a literal TAB
+ * character, and msb 0.6.6 panics on any image whose baked env contains one
+ * — before the guest even boots:
+ *
+ * ```
+ * sandbox process exited (signal: 6 (SIGABRT)) before agent relay became available
+ * ```
+ *
+ * with `msb logs --source system` showing:
+ *
+ * ```
+ * panicked at msb_krun_vmm-0.1.25/src/builder.rs:1154: ... Err value: InvalidAscii
+ * ```
+ *
+ * `GPG_KEYS` is consumed only at image-build time (verifying the signing
+ * keys baked into that layer) — it has no effect on the running container,
+ * so overriding it to an empty, tab-free string here is safe and required.
+ * Without this override, `start()` never gets far enough to run its own
+ * wait strategy at all.
+ *
+ * ### Heap sized down, memory ceiling measured
+ *
+ * `MAX_HEAP_SIZE=512M`/`HEAP_NEWSIZE=128M` keep the JVM small; `2560` MB is
+ * the verified memory ceiling at that heap size.
+ *
+ * ### Readiness
+ *
+ * Anchored on the CQL native-transport log line (`Starting listening for
+ * CQL clients`), observed at 58s on a quiet local machine. 300s absorbs a
+ * loaded-host boot without masking a real hang — Cassandra is heavier than
+ * either Keycloak or MySQL, both of which carry 180s in this library.
+ */
+export class CassandraContainer extends GenericContainer {
+    constructor(image = "cassandra:5.0.8") {
+        super(image);
+        this.withExposedPorts(CQL_PORT)
+            // Required — see the class doc for the exact panic this avoids.
+            .withEnv("GPG_KEYS", "")
+            .withEnv("MAX_HEAP_SIZE", "512M")
+            .withEnv("HEAP_NEWSIZE", "128M")
+            .withMemoryLimit(2560)
+            .waitingFor(Wait.forLogMessage(".*Starting listening for CQL clients.*", 1).withStartupTimeout(STARTUP_TIMEOUT_MS));
+    }
+    static async start(image = "cassandra:5.0.8") {
+        return (await new CassandraContainer(image).start());
+    }
+    /** `<host>:<port>` for the running container — the shape most CQL drivers want for a contact point. */
+    get contactPoint() {
+        return `${this.host}:${this.getMappedPort(CQL_PORT)}`;
+    }
+    /** The mapped CQL native-transport port. */
+    get cqlPort() {
+        return this.getMappedPort(CQL_PORT);
+    }
+    /** This single node's local datacenter name — required by drivers (e.g. the DataStax Node driver) that insist on an explicit value at connect time. */
+    get localDatacenter() {
+        return "datacenter1";
+    }
+}
+//# sourceMappingURL=cassandra.js.map

package/dist/modules/cassandra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cassandra.js","sourceRoot":"","sources":["../../src/modules/cassandra.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,KAAK,GAAG,iBAAiB;QACnC,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YAC7B,gEAAgE;aAC/D,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACvB,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC;aAChC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;aAC/B,eAAe,CAAC,IAAI,CAAC;aACrB,UAAU,CACT,IAAI,CAAC,aAAa,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CACvG,CAAC;IACN,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,iBAAiB;QACnD,OAAO,CAAC,MAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAuB,CAAC;IAC7E,CAAC;IAED,uGAAuG;IACvG,IAAI,YAAY;QACd,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,4CAA4C;IAC5C,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,uJAAuJ;IACvJ,IAAI,eAAe;QACjB,OAAO,aAAa,CAAC;IACvB,CAAC;CACF"}

package/dist/modules/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * `rightsize/modules` — eighteen preconfigured containers.
+ * `rightsize/modules` — twenty-one preconfigured containers.
  *
  * Each module is a `GenericContainer` subclass with sensible defaults (image
  * tag, exposed ports, wait strategy, and any memory floor its image needs)
@@ -11,6 +11,7 @@
  * @packageDocumentation
  */
 export { RedisContainer } from "./redis.js";
+export { ValkeyContainer } from "./valkey.js";
 export { MemcachedContainer, MemcachedRespondsStrategy } from "./memcached.js";
 export { ArangoContainer } from "./arango.js";
 export { MongoDBContainer } from "./mongodb.js";
@@ -28,4 +29,6 @@ export { KeycloakContainer } from "./keycloak.js";
 export { ClickHouseContainer } from "./clickhouse.js";
 export { Neo4jContainer } from "./neo4j.js";
 export { FlociContainer } from "./floci.js";
+export { MinIOContainer } from "./minio.js";
+export { CassandraContainer } from "./cassandra.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/modules/index.js

@@ -1,5 +1,5 @@
 /**
- * `rightsize/modules` — eighteen preconfigured containers.
+ * `rightsize/modules` — twenty-one preconfigured containers.
  *
  * Each module is a `GenericContainer` subclass with sensible defaults (image
  * tag, exposed ports, wait strategy, and any memory floor its image needs)
@@ -11,6 +11,7 @@
  * @packageDocumentation
  */
 export { RedisContainer } from "./redis.js";
+export { ValkeyContainer } from "./valkey.js";
 export { MemcachedContainer, MemcachedRespondsStrategy } from "./memcached.js";
 export { ArangoContainer } from "./arango.js";
 export { MongoDBContainer } from "./mongodb.js";
@@ -28,4 +29,6 @@ export { KeycloakContainer } from "./keycloak.js";
 export { ClickHouseContainer } from "./clickhouse.js";
 export { Neo4jContainer } from "./neo4j.js";
 export { FlociContainer } from "./floci.js";
+export { MinIOContainer } from "./minio.js";
+export { CassandraContainer } from "./cassandra.js";
 //# sourceMappingURL=index.js.map

package/dist/modules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/modules/minio.d.ts

@@ -0,0 +1,35 @@
+import { GenericContainer } from "../core/generic-container.js";
+/**
+ * A single-node MinIO container — an S3-compatible object store. Requires
+ * an explicit command: the image's default ENTRYPOINT alone does not serve,
+ * so this module always runs `server /data --console-address :9001`.
+ *
+ * `MINIO_ROOT_USER`/`MINIO_ROOT_PASSWORD` default to `testuser`/
+ * `testpassword`, not this library's usual `test`/`test` pair — MinIO
+ * itself rejects a root password shorter than 8 characters, so `test` (4
+ * characters) is a non-starter here.
+ *
+ * Exposes both the S3 API (9000, what `endpointUrl` wraps) and the web
+ * console (9001, published for anyone who wants to open it directly; no
+ * helper wraps it).
+ *
+ * Readiness is a protocol-aware HTTP check against `/minio/health/live` on
+ * the API port — verified answering 200 on the very first poll after boot.
+ */
+export declare class MinIOContainer extends GenericContainer {
+    private rootUserState;
+    private rootPasswordState;
+    constructor(image?: string);
+    static start(image?: string): Promise<MinIOContainer>;
+    /** Overrides `MINIO_ROOT_USER` (default `testuser`). */
+    withRootUser(user: string): this;
+    /** Overrides `MINIO_ROOT_PASSWORD` (default `testpassword`). MinIO rejects anything shorter than 8 characters. */
+    withRootPassword(password: string): this;
+    /** The configured root user (default `testuser`). */
+    get rootUser(): string;
+    /** The configured root password (default `testpassword`). */
+    get rootPassword(): string;
+    /** The S3 API's base URL for the running container. */
+    get endpointUrl(): string;
+}
+//# sourceMappingURL=minio.d.ts.map

package/dist/modules/minio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minio.d.ts","sourceRoot":"","sources":["../../src/modules/minio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMhE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,iBAAiB,CAAkB;gBAE/B,KAAK,SAA6C;WAcxC,KAAK,CAAC,KAAK,SAA6C,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxG,wDAAwD;IACxD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKhC,kHAAkH;IAClH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKxC,qDAAqD;IACrD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,6DAA6D;IAC7D,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,uDAAuD;IACvD,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}

package/dist/modules/minio.js

@@ -0,0 +1,64 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { Wait } from "../core/wait.js";
+const API_PORT = 9000;
+const CONSOLE_PORT = 9001;
+/**
+ * A single-node MinIO container — an S3-compatible object store. Requires
+ * an explicit command: the image's default ENTRYPOINT alone does not serve,
+ * so this module always runs `server /data --console-address :9001`.
+ *
+ * `MINIO_ROOT_USER`/`MINIO_ROOT_PASSWORD` default to `testuser`/
+ * `testpassword`, not this library's usual `test`/`test` pair — MinIO
+ * itself rejects a root password shorter than 8 characters, so `test` (4
+ * characters) is a non-starter here.
+ *
+ * Exposes both the S3 API (9000, what `endpointUrl` wraps) and the web
+ * console (9001, published for anyone who wants to open it directly; no
+ * helper wraps it).
+ *
+ * Readiness is a protocol-aware HTTP check against `/minio/health/live` on
+ * the API port — verified answering 200 on the very first poll after boot.
+ */
+export class MinIOContainer extends GenericContainer {
+    rootUserState = "testuser";
+    rootPasswordState = "testpassword";
+    constructor(image = "minio/minio:RELEASE.2025-09-07T16-13-09Z") {
+        super(image);
+        this.withExposedPorts(API_PORT, CONSOLE_PORT)
+            .withCommand("server", "/data", "--console-address", ":9001")
+            .withEnv("MINIO_ROOT_USER", this.rootUserState)
+            .withEnv("MINIO_ROOT_PASSWORD", this.rootPasswordState)
+            .waitingFor(Wait.forHttp("/minio/health/live").forPort(API_PORT));
+        // No withMemoryLimit override: the round-trip that verified this module
+        // ran at 1024 MB, but whether MinIO actually needs more than msb's
+        // default microVM sizing was never isolated in that pass — a floor
+        // belongs here once that's measured on its own, not assumed from a
+        // number that included the whole round-trip's overhead.
+    }
+    static async start(image = "minio/minio:RELEASE.2025-09-07T16-13-09Z") {
+        return (await new MinIOContainer(image).start());
+    }
+    /** Overrides `MINIO_ROOT_USER` (default `testuser`). */
+    withRootUser(user) {
+        this.rootUserState = user;
+        return this.withEnv("MINIO_ROOT_USER", user);
+    }
+    /** Overrides `MINIO_ROOT_PASSWORD` (default `testpassword`). MinIO rejects anything shorter than 8 characters. */
+    withRootPassword(password) {
+        this.rootPasswordState = password;
+        return this.withEnv("MINIO_ROOT_PASSWORD", password);
+    }
+    /** The configured root user (default `testuser`). */
+    get rootUser() {
+        return this.rootUserState;
+    }
+    /** The configured root password (default `testpassword`). */
+    get rootPassword() {
+        return this.rootPasswordState;
+    }
+    /** The S3 API's base URL for the running container. */
+    get endpointUrl() {
+        return `http://${this.host}:${this.getMappedPort(API_PORT)}`;
+    }
+}
+//# sourceMappingURL=minio.js.map

package/dist/modules/minio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minio.js","sourceRoot":"","sources":["../../src/modules/minio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IAC1C,aAAa,GAAG,UAAU,CAAC;IAC3B,iBAAiB,GAAG,cAAc,CAAC;IAE3C,YAAY,KAAK,GAAG,0CAA0C;QAC5D,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC;aAC1C,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC;aAC5D,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,aAAa,CAAC;aAC9C,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC,iBAAiB,CAAC;aACtD,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpE,wEAAwE;QACxE,mEAAmE;QACnE,mEAAmE;QACnE,mEAAmE;QACnE,wDAAwD;IAC1D,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,0CAA0C;QAC5E,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAmB,CAAC;IACrE,CAAC;IAED,wDAAwD;IACxD,YAAY,CAAC,IAAY;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,kHAAkH;IAClH,gBAAgB,CAAC,QAAgB;QAC/B,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,qDAAqD;IACrD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,6DAA6D;IAC7D,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,uDAAuD;IACvD,IAAI,WAAW;QACb,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC/D,CAAC;CACF"}

package/dist/modules/valkey.d.ts

@@ -0,0 +1,21 @@
+import { GenericContainer } from "../core/generic-container.js";
+/**
+ * A single-node Valkey container — the Redis-protocol-compatible fork,
+ * following `RedisContainer`'s shape exactly. Readiness is anchored on the
+ * same `Ready to accept connections tcp` log line Redis prints, for the
+ * same reason: on a loaded host, msb's loopback forwarder can accept and
+ * hold a TCP connection before the guest process is actually listening, so
+ * a bare port probe risks returning before the server serves.
+ *
+ * `uri` deliberately uses the `redis://` scheme, not `valkey://`: every
+ * client this library's tests and its users reach for — lettuce,
+ * node-redis, or raw RESP over TCP — parses `redis://`, and Valkey speaks
+ * that same wire protocol. This is not a copy-paste mistake.
+ */
+export declare class ValkeyContainer extends GenericContainer {
+    constructor(image?: string);
+    static start(image?: string): Promise<ValkeyContainer>;
+    /** A `redis://` connection URI for the running container (see the class doc for why not `valkey://`). */
+    get uri(): string;
+}
+//# sourceMappingURL=valkey.d.ts.map

package/dist/modules/valkey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valkey.d.ts","sourceRoot":"","sources":["../../src/modules/valkey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAKhE;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,KAAK,SAA6B;WAOxB,KAAK,CAAC,KAAK,SAA6B,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzF,yGAAyG;IACzG,IAAI,GAAG,IAAI,MAAM,CAEhB;CACF"}

package/dist/modules/valkey.js

@@ -0,0 +1,32 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { Wait } from "../core/wait.js";
+const GUEST_PORT = 6379;
+/**
+ * A single-node Valkey container — the Redis-protocol-compatible fork,
+ * following `RedisContainer`'s shape exactly. Readiness is anchored on the
+ * same `Ready to accept connections tcp` log line Redis prints, for the
+ * same reason: on a loaded host, msb's loopback forwarder can accept and
+ * hold a TCP connection before the guest process is actually listening, so
+ * a bare port probe risks returning before the server serves.
+ *
+ * `uri` deliberately uses the `redis://` scheme, not `valkey://`: every
+ * client this library's tests and its users reach for — lettuce,
+ * node-redis, or raw RESP over TCP — parses `redis://`, and Valkey speaks
+ * that same wire protocol. This is not a copy-paste mistake.
+ */
+export class ValkeyContainer extends GenericContainer {
+    constructor(image = "valkey/valkey:9.1-alpine") {
+        super(image);
+        this.withExposedPorts(GUEST_PORT).waitingFor(Wait.forLogMessage(".*Ready to accept connections.*", 1));
+        // No withMemoryLimit override: verified booting and answering PING with
+        // no limit set beyond msb's default, well under 512 MB.
+    }
+    static async start(image = "valkey/valkey:9.1-alpine") {
+        return (await new ValkeyContainer(image).start());
+    }
+    /** A `redis://` connection URI for the running container (see the class doc for why not `valkey://`). */
+    get uri() {
+        return `redis://${this.host}:${this.getMappedPort(GUEST_PORT)}`;
+    }
+}
+//# sourceMappingURL=valkey.js.map

package/dist/modules/valkey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valkey.js","sourceRoot":"","sources":["../../src/modules/valkey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD,YAAY,KAAK,GAAG,0BAA0B;QAC5C,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvG,wEAAwE;QACxE,wDAAwD;IAC1D,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,0BAA0B;QAC5D,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAoB,CAAC;IACvE,CAAC;IAED,yGAAyG;IACzG,IAAI,GAAG;QACL,OAAO,WAAW,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IAClE,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rightsize",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Testcontainers-style integration testing on microsandbox microVMs, with a Docker fallback and an await-using lifecycle. No Docker required.",
   "keywords": [
     "testcontainers",