rightsize 0.4.0 → 0.6.0

package/dist/modules/redis.js

@@ -1,19 +1,27 @@
 import { GenericContainer } from "../core/generic-container.js";
 import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 const GUEST_PORT = 6379;
+const EXPECTED_REPOSITORY = "redis";
+const DEFAULT_IMAGE = "redis:latest";
 /**
  * A single-node Redis container. Readiness is anchored on Redis's own
  * "Ready to accept connections" log line rather than a TCP probe: on a loaded
  * host the port forwarder can accept and hold a connection in the window
  * between Redis binding its socket and actually serving, which a bare
  * listening-port check cannot see through.
+ *
+ * No-arg construction floats to `redis:latest`, so the version tracks
+ * upstream rather than this library's release cycle (verified against
+ * `redis:8.6-alpine`). `latest` is Debian-based, not Alpine — functionally
+ * equivalent, just a larger pull.
  */
 export class RedisContainer extends GenericContainer {
-    constructor(image = "redis:8.6-alpine") {
-        super(image);
+    constructor(image = DEFAULT_IMAGE) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
         this.withExposedPorts(GUEST_PORT).waitingFor(Wait.forLogMessage(".*Ready to accept connections.*", 1));
     }
-    static async start(image = "redis:8.6-alpine") {
+    static async start(image = DEFAULT_IMAGE) {
         return (await new RedisContainer(image).start());
     }
     /** A `redis://` connection URI for the running container. */

package/dist/modules/redis.js.map

@@ -1 +1 @@
-{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/modules/redis.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;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IAClD,YAAY,KAAK,GAAG,kBAAkB;QACpC,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;IACzG,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,kBAAkB;QACpD,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAmB,CAAC;IACrE,CAAC;IAED,6DAA6D;IAC7D,IAAI,GAAG;QACL,OAAO,WAAW,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IAClE,CAAC;CACF"}
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/modules/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,mBAAmB,GAAG,OAAO,CAAC;AACpC,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IAClD,YAAY,QAAkC,aAAa;QACzD,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,QAAkC,aAAa;QACzE,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAmB,CAAC;IACrE,CAAC;IAED,6DAA6D;IAC7D,IAAI,GAAG;QACL,OAAO,WAAW,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IAClE,CAAC;CACF"}

package/dist/modules/redpanda.d.ts

@@ -1,15 +1,24 @@
 import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 import type { ContainerSpec } from "../core/model.js";
 /**
  * A single-node Redpanda broker (Kafka API-compatible) with its schema
- * registry enabled. Pinned to a versioned tag rather than `:latest`:
- * `docker.redpanda.com` rate-limits anonymous pulls (seed it into the msb
- * image cache once with `docker save <img> | msb load` ahead of integration
- * runs), and a versioned tag makes that seed step reproducible.
+ * registry enabled.
+ *
+ * No-arg construction floats to `redpandadata/redpanda:latest`, so the
+ * version tracks upstream rather than this library's release cycle
+ * (verified against `redpandadata/redpanda:v24.2.4`). This module previously
+ * pinned a versioned tag instead of floating, reasoning that
+ * `docker.redpanda.com` rate-limits anonymous pulls and a versioned tag made
+ * a one-time image seed (`docker save <img> | msb load`, ahead of
+ * microsandbox runs) reproducible — that rate limit is a pull-frequency
+ * property, not a tag one, and applies to `:latest` exactly the same as any
+ * other tag; seed the image into the cache once regardless of which
+ * reference you use.
  */
 export declare class RedpandaContainer extends GenericContainer {
-    constructor(image?: string);
-    static start(image?: string): Promise<RedpandaContainer>;
+    constructor(image?: string | DockerImageName);
+    static start(image?: string | DockerImageName): Promise<RedpandaContainer>;
     /**
      * The advertised listener must carry the mapped host port, known only now
      * (ports were allocated before boot) — the reason this hook exists at

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

@@ -1 +1 @@
-{"version":3,"file":"redpanda.d.ts","sourceRoot":"","sources":["../../src/modules/redpanda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAUtD;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,KAAK,SAAkC;WAO7B,KAAK,CACzB,KAAK,SAAkC,GACtC,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;;;OAOG;cACgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,aAAa;IAkBvG,+FAA+F;IAC/F,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,6DAA6D;IAC7D,IAAI,iBAAiB,IAAI,MAAM,CAE9B;CACF"}
+{"version":3,"file":"redpanda.d.ts","sourceRoot":"","sources":["../../src/modules/redpanda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAYtD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,KAAK,GAAE,MAAM,GAAG,eAA+B;WAOrC,KAAK,CACzB,KAAK,GAAE,MAAM,GAAG,eAA+B,GAC9C,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;;;OAOG;cACgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,aAAa;IAkBvG,+FAA+F;IAC/F,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,6DAA6D;IAC7D,IAAI,iBAAiB,IAAI,MAAM,CAE9B;CACF"}

package/dist/modules/redpanda.js

@@ -1,24 +1,35 @@
 import { GenericContainer } from "../core/generic-container.js";
 import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 const EXTERNAL_PORT = 9092;
 const INTERNAL_PORT = 9093;
 const SCHEMA_REGISTRY_PORT = 8081;
+const EXPECTED_REPOSITORY = "redpandadata/redpanda";
+const DEFAULT_IMAGE = "redpandadata/redpanda:latest";
 // The alias siblings resolve INTERNAL through — native docker networks, or
 // the msb exec-tunnel alias emulation.
 const INTERNAL_ALIAS = "redpanda";
 /**
  * A single-node Redpanda broker (Kafka API-compatible) with its schema
- * registry enabled. Pinned to a versioned tag rather than `:latest`:
- * `docker.redpanda.com` rate-limits anonymous pulls (seed it into the msb
- * image cache once with `docker save <img> | msb load` ahead of integration
- * runs), and a versioned tag makes that seed step reproducible.
+ * registry enabled.
+ *
+ * No-arg construction floats to `redpandadata/redpanda:latest`, so the
+ * version tracks upstream rather than this library's release cycle
+ * (verified against `redpandadata/redpanda:v24.2.4`). This module previously
+ * pinned a versioned tag instead of floating, reasoning that
+ * `docker.redpanda.com` rate-limits anonymous pulls and a versioned tag made
+ * a one-time image seed (`docker save <img> | msb load`, ahead of
+ * microsandbox runs) reproducible — that rate limit is a pull-frequency
+ * property, not a tag one, and applies to `:latest` exactly the same as any
+ * other tag; seed the image into the cache once regardless of which
+ * reference you use.
  */
 export class RedpandaContainer extends GenericContainer {
-    constructor(image = "redpandadata/redpanda:v24.2.4") {
-        super(image);
+    constructor(image = DEFAULT_IMAGE) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
         this.withExposedPorts(EXTERNAL_PORT, INTERNAL_PORT, SCHEMA_REGISTRY_PORT).waitingFor(Wait.forLogMessage(".*Successfully started Redpanda.*"));
     }
-    static async start(image = "redpandadata/redpanda:v24.2.4") {
+    static async start(image = DEFAULT_IMAGE) {
         return (await new RedpandaContainer(image).start());
     }
     /**

package/dist/modules/redpanda.js.map

@@ -1 +1 @@
-{"version":3,"file":"redpanda.js","sourceRoot":"","sources":["../../src/modules/redpanda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGvC,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC,2EAA2E;AAC3E,uCAAuC;AACvC,MAAM,cAAc,GAAG,UAAU,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,KAAK,GAAG,+BAA+B;QACjD,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAC,UAAU,CAClF,IAAI,CAAC,aAAa,CAAC,mCAAmC,CAAC,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CACzB,KAAK,GAAG,+BAA+B;QAEvC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAsB,CAAC;IAC3E,CAAC;IAED;;;;;;;OAOG;IACgB,aAAa,CAAC,IAAmB,EAAE,MAAiC;QACrF,MAAM,OAAO,GAAG;YACd,UAAU;YACV,OAAO;YACP,QAAQ;YACR,eAAe;YACf,OAAO;YACP,GAAG;YACH,cAAc;YACd,sBAAsB,aAAa,uBAAuB,aAAa,EAAE;YACzE,wBAAwB;YACxB,wBAAwB,MAAM,CAAC,aAAa,CAAC,eAAe,cAAc,IAAI,aAAa,EAAE;YAC7F,wBAAwB;YACxB,WAAW,oBAAoB,EAAE;SAClC,CAAC;QACF,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,+FAA+F;IAC/F,IAAI,gBAAgB;QAClB,OAAO,eAAe,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,6DAA6D;IAC7D,IAAI,iBAAiB;QACnB,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE,CAAC;IAC3E,CAAC;CACF"}
+{"version":3,"file":"redpanda.js","sourceRoot":"","sources":["../../src/modules/redpanda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AACpD,MAAM,aAAa,GAAG,8BAA8B,CAAC;AAErD,2EAA2E;AAC3E,uCAAuC;AACvC,MAAM,cAAc,GAAG,UAAU,CAAC;AAElC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,QAAkC,aAAa;QACzD,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAC,UAAU,CAClF,IAAI,CAAC,aAAa,CAAC,mCAAmC,CAAC,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CACzB,QAAkC,aAAa;QAE/C,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAsB,CAAC;IAC3E,CAAC;IAED;;;;;;;OAOG;IACgB,aAAa,CAAC,IAAmB,EAAE,MAAiC;QACrF,MAAM,OAAO,GAAG;YACd,UAAU;YACV,OAAO;YACP,QAAQ;YACR,eAAe;YACf,OAAO;YACP,GAAG;YACH,cAAc;YACd,sBAAsB,aAAa,uBAAuB,aAAa,EAAE;YACzE,wBAAwB;YACxB,wBAAwB,MAAM,CAAC,aAAa,CAAC,eAAe,cAAc,IAAI,aAAa,EAAE;YAC7F,wBAAwB;YACxB,WAAW,oBAAoB,EAAE;SAClC,CAAC;QACF,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,+FAA+F;IAC/F,IAAI,gBAAgB;QAClB,OAAO,eAAe,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,6DAA6D;IAC7D,IAAI,iBAAiB;QACnB,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE,CAAC;IAC3E,CAAC;CACF"}

package/dist/modules/spring-cloud-config.d.ts

@@ -1,8 +1,13 @@
 import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 /**
  * A Spring Cloud Config Server container, ready-checked via its actuator
  * health endpoint.
  *
+ * No-arg construction floats to `hyness/spring-cloud-config-server:latest` —
+ * this module has always defaulted to the floating tag, so there is no
+ * pinned version its measurements below need to be re-attributed from.
+ *
  * Paketo's memory calculator sizes this JVM image's fixed regions
  * (measured ~704763K) above microsandbox's default microVM RAM (~450MB),
  * so `withMemoryLimit(1024)` is set by default here — without it, the
@@ -10,8 +15,8 @@ import { GenericContainer } from "../core/generic-container.js";
  * boot completes in roughly 19s.
  */
 export declare class SpringCloudConfigContainer extends GenericContainer {
-    constructor(image?: string);
-    static start(image?: string): Promise<SpringCloudConfigContainer>;
+    constructor(image?: string | DockerImageName);
+    static start(image?: string | DockerImageName): Promise<SpringCloudConfigContainer>;
     /** The config server's base URI for the running container. */
     get uri(): string;
 }

package/dist/modules/spring-cloud-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spring-cloud-config.d.ts","sourceRoot":"","sources":["../../src/modules/spring-cloud-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAKhE;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;gBAClD,KAAK,SAA6C;WAMxC,KAAK,CAAC,KAAK,SAA6C,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAIpH,8DAA8D;IAC9D,IAAI,GAAG,IAAI,MAAM,CAEhB;CACF"}
+{"version":3,"file":"spring-cloud-config.d.ts","sourceRoot":"","sources":["../../src/modules/spring-cloud-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAM/D;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;gBAClD,KAAK,GAAE,MAAM,GAAG,eAA+B;WAMrC,KAAK,CACzB,KAAK,GAAE,MAAM,GAAG,eAA+B,GAC9C,OAAO,CAAC,0BAA0B,CAAC;IAItC,8DAA8D;IAC9D,IAAI,GAAG,IAAI,MAAM,CAEhB;CACF"}

package/dist/modules/spring-cloud-config.js

@@ -1,10 +1,17 @@
 import { GenericContainer } from "../core/generic-container.js";
 import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 const GUEST_PORT = 8888;
+const EXPECTED_REPOSITORY = "hyness/spring-cloud-config-server";
+const DEFAULT_IMAGE = "hyness/spring-cloud-config-server:latest";
 /**
  * A Spring Cloud Config Server container, ready-checked via its actuator
  * health endpoint.
  *
+ * No-arg construction floats to `hyness/spring-cloud-config-server:latest` —
+ * this module has always defaulted to the floating tag, so there is no
+ * pinned version its measurements below need to be re-attributed from.
+ *
  * Paketo's memory calculator sizes this JVM image's fixed regions
  * (measured ~704763K) above microsandbox's default microVM RAM (~450MB),
  * so `withMemoryLimit(1024)` is set by default here — without it, the
@@ -12,12 +19,12 @@ const GUEST_PORT = 8888;
  * boot completes in roughly 19s.
  */
 export class SpringCloudConfigContainer extends GenericContainer {
-    constructor(image = "hyness/spring-cloud-config-server:latest") {
-        super(image);
+    constructor(image = DEFAULT_IMAGE) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
         this.withExposedPorts(GUEST_PORT).waitingFor(Wait.forHttp("/actuator/health").forPort(GUEST_PORT));
         this.withMemoryLimit(1024);
     }
-    static async start(image = "hyness/spring-cloud-config-server:latest") {
+    static async start(image = DEFAULT_IMAGE) {
         return (await new SpringCloudConfigContainer(image).start());
     }
     /** The config server's base URI for the running container. */

package/dist/modules/spring-cloud-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"spring-cloud-config.js","sourceRoot":"","sources":["../../src/modules/spring-cloud-config.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;;;;;;;;;GASG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,KAAK,GAAG,0CAA0C;QAC5D,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QACnG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,0CAA0C;QAC5E,OAAO,CAAC,MAAM,IAAI,0BAA0B,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAA+B,CAAC;IAC7F,CAAC;IAED,8DAA8D;IAC9D,IAAI,GAAG;QACL,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IACjE,CAAC;CACF"}
+{"version":3,"file":"spring-cloud-config.js","sourceRoot":"","sources":["../../src/modules/spring-cloud-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;AAChE,MAAM,aAAa,GAAG,0CAA0C,CAAC;AAEjE;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,QAAkC,aAAa;QACzD,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QACnG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CACzB,QAAkC,aAAa;QAE/C,OAAO,CAAC,MAAM,IAAI,0BAA0B,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAA+B,CAAC;IAC7F,CAAC;IAED,8DAA8D;IAC9D,IAAI,GAAG;QACL,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IACjE,CAAC;CACF"}

package/dist/modules/valkey.d.ts

@@ -0,0 +1,28 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.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.
+ *
+ * No-arg construction floats to `valkey/valkey:latest`, so the version
+ * tracks upstream rather than this library's release cycle (verified
+ * against `valkey/valkey:9.1-alpine`, including the no-memory-limit and PING
+ * facts below). `latest` is Debian-based rather than Alpine — functionally
+ * equivalent, larger to pull.
+ */
+export declare class ValkeyContainer extends GenericContainer {
+    constructor(image?: string | DockerImageName);
+    static start(image?: string | DockerImageName): 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;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAM/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,KAAK,GAAE,MAAM,GAAG,eAA+B;WAOrC,KAAK,CAAC,KAAK,GAAE,MAAM,GAAG,eAA+B,GAAG,OAAO,CAAC,eAAe,CAAC;IAItG,yGAAyG;IACzG,IAAI,GAAG,IAAI,MAAM,CAEhB;CACF"}

package/dist/modules/valkey.js

@@ -0,0 +1,41 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
+const GUEST_PORT = 6379;
+const EXPECTED_REPOSITORY = "valkey/valkey";
+const DEFAULT_IMAGE = "valkey/valkey:latest";
+/**
+ * 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.
+ *
+ * No-arg construction floats to `valkey/valkey:latest`, so the version
+ * tracks upstream rather than this library's release cycle (verified
+ * against `valkey/valkey:9.1-alpine`, including the no-memory-limit and PING
+ * facts below). `latest` is Debian-based rather than Alpine — functionally
+ * equivalent, larger to pull.
+ */
+export class ValkeyContainer extends GenericContainer {
+    constructor(image = DEFAULT_IMAGE) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
+        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 = DEFAULT_IMAGE) {
+        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;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAC5C,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IACnD,YAAY,QAAkC,aAAa;QACzD,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,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,QAAkC,aAAa;QACzE,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/dist/modules/wiremock.d.ts

@@ -1,4 +1,5 @@
 import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 /**
  * A single-node WireMock container — the TypeScript ecosystem has no
  * in-process WireMock equivalent (unlike the JVM, where WireMock runs
@@ -9,10 +10,14 @@ import { GenericContainer } from "../core/generic-container.js";
  * dependency-free readiness signal, so it's preferred over polling
  * `/__admin/mappings` (which would also return 200 once the admin API is
  * up, but reads as "list of stubs" rather than "am I healthy").
+ *
+ * No-arg construction floats to `wiremock/wiremock:latest`, so the version
+ * tracks upstream rather than this library's release cycle (verified
+ * against `wiremock/wiremock:3.13.2`).
  */
 export declare class WireMockContainer extends GenericContainer {
-    constructor(image?: string);
-    static start(image?: string): Promise<WireMockContainer>;
+    constructor(image?: string | DockerImageName);
+    static start(image?: string | DockerImageName): Promise<WireMockContainer>;
     /** The stubbed API's base URL (mock endpoints are served from here). */
     get baseUrl(): string;
     /** The admin API's base URL (`/__admin/...` — mapping management, health, requests). */

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

@@ -1 +1 @@
-{"version":3,"file":"wiremock.d.ts","sourceRoot":"","sources":["../../src/modules/wiremock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAKhE;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,KAAK,SAA6B;WAKxB,KAAK,CAAC,KAAK,SAA6B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI3F,wEAAwE;IACxE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,wFAAwF;IACxF,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF"}
+{"version":3,"file":"wiremock.d.ts","sourceRoot":"","sources":["../../src/modules/wiremock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAM/D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,KAAK,GAAE,MAAM,GAAG,eAA+B;WAKrC,KAAK,CAAC,KAAK,GAAE,MAAM,GAAG,eAA+B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIxG,wEAAwE;IACxE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,wFAAwF;IACxF,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF"}

package/dist/modules/wiremock.js

@@ -1,6 +1,9 @@
 import { GenericContainer } from "../core/generic-container.js";
 import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 const GUEST_PORT = 8080;
+const EXPECTED_REPOSITORY = "wiremock/wiremock";
+const DEFAULT_IMAGE = "wiremock/wiremock:latest";
 /**
  * A single-node WireMock container — the TypeScript ecosystem has no
  * in-process WireMock equivalent (unlike the JVM, where WireMock runs
@@ -11,13 +14,17 @@ const GUEST_PORT = 8080;
  * dependency-free readiness signal, so it's preferred over polling
  * `/__admin/mappings` (which would also return 200 once the admin API is
  * up, but reads as "list of stubs" rather than "am I healthy").
+ *
+ * No-arg construction floats to `wiremock/wiremock:latest`, so the version
+ * tracks upstream rather than this library's release cycle (verified
+ * against `wiremock/wiremock:3.13.2`).
  */
 export class WireMockContainer extends GenericContainer {
-    constructor(image = "wiremock/wiremock:3.13.2") {
-        super(image);
+    constructor(image = DEFAULT_IMAGE) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
         this.withExposedPorts(GUEST_PORT).waitingFor(Wait.forHttp("/__admin/health").forPort(GUEST_PORT));
     }
-    static async start(image = "wiremock/wiremock:3.13.2") {
+    static async start(image = DEFAULT_IMAGE) {
         return (await new WireMockContainer(image).start());
     }
     /** The stubbed API's base URL (mock endpoints are served from here). */

package/dist/modules/wiremock.js.map

@@ -1 +1 @@
-{"version":3,"file":"wiremock.js","sourceRoot":"","sources":["../../src/modules/wiremock.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;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,KAAK,GAAG,0BAA0B;QAC5C,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,0BAA0B;QAC5D,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAsB,CAAC;IAC3E,CAAC;IAED,wEAAwE;IACxE,IAAI,OAAO;QACT,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,wFAAwF;IACxF,IAAI,QAAQ;QACV,OAAO,GAAG,IAAI,CAAC,OAAO,UAAU,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"wiremock.js","sourceRoot":"","sources":["../../src/modules/wiremock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAChD,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,QAAkC,aAAa;QACzD,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,QAAkC,aAAa;QACzE,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAsB,CAAC;IAC3E,CAAC;IAED,wEAAwE;IACxE,IAAI,OAAO;QACT,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,wFAAwF;IACxF,IAAI,QAAQ;QACV,OAAO,GAAG,IAAI,CAAC,OAAO,UAAU,CAAC;IACnC,CAAC;CACF"}

package/package.json

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