rightsize 0.4.0 → 0.6.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrG,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,8BAA8B,EAC9B,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrG,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -5,14 +5,17 @@
  * (the builder + async-dispose lifecycle guard), `Network`, the `Wait`
  * strategies, `FreePorts`, `RunId`, `Checkpoints` (rediscovering named
  * checkpoints across processes), the `SandboxBackend`/`BackendProvider`
- * 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.
+ * contracts plus the `registerBackend` registry, `DockerImageName` (image-
+ * reference parsing plus the Testcontainers-style compatibility check), 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 twenty-three preconfigured containers built
+ * on top of this surface.
  *
  * @packageDocumentation
  */
-export { UnsupportedByBackendError, PortBindConflictError, ContainerLaunchError, BackendError, ProvisionError, ReuseWithNetworkError, IsolationRequiredError, CheckpointUnsupportedError, CheckpointBackendMismatchError, ReuseFromCheckpointError, RelativeContainerPathError, InvalidCheckpointNameError, CheckpointArtifactMissingError, MalformedCheckpointArchiveError, } from "./core/errors.js";
+export { UnsupportedByBackendError, PortBindConflictError, ContainerLaunchError, BackendError, ProvisionError, ReuseWithNetworkError, IsolationRequiredError, CheckpointUnsupportedError, CheckpointBackendMismatchError, ReuseFromCheckpointError, RelativeContainerPathError, InvalidCheckpointNameError, CheckpointArtifactMissingError, MalformedCheckpointArchiveError, IncompatibleImageError, } from "./core/errors.js";
+export { DockerImageName } from "./core/docker-image-name.js";
 export { registerBackend, Backends } from "./core/backends.js";
 export { FreePorts } from "./core/free-ports.js";
 export { Wait, HttpWaitStrategy } from "./core/wait.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,8BAA8B,EAC9B,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAW9D,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/modules/arango.d.ts

@@ -1,10 +1,18 @@
 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 ArangoDB container. Auth is disabled by default; see `withRootPassword` to enable it. */
+/**
+ * A single-node ArangoDB container. Auth is disabled by default; see
+ * `withRootPassword` to enable it.
+ *
+ * No-arg construction floats to `arangodb:latest`, so the version tracks
+ * upstream rather than this library's release cycle (verified against
+ * `arangodb:3.11`).
+ */
 export declare class ArangoContainer extends GenericContainer {
     private rootPassword;
-    constructor(image?: string);
-    static start(image?: string): Promise<ArangoContainer>;
+    constructor(image?: string | DockerImageName);
+    static start(image?: string | DockerImageName): Promise<ArangoContainer>;
     /** Enables auth with the given root password, instead of the default no-auth setup. */
     withRootPassword(password: string): this;
     protected customizeSpec(spec: ContainerSpec, _mapped: (guest: number) => number): ContainerSpec;

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

@@ -1 +1 @@
-{"version":3,"file":"arango.d.ts","sourceRoot":"","sources":["../../src/modules/arango.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,0GAA0G;AAC1G,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,OAAO,CAAC,YAAY,CAAqB;gBAE7B,KAAK,SAAkB;WAOb,KAAK,CAAC,KAAK,SAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI9E,uFAAuF;IACvF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;cAUrB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,aAAa;IAOxG,uDAAuD;IACvD,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF"}
+{"version":3,"file":"arango.d.ts","sourceRoot":"","sources":["../../src/modules/arango.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;AAMtD;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,OAAO,CAAC,YAAY,CAAqB;gBAE7B,KAAK,GAAE,MAAM,GAAG,eAA+B;WAOrC,KAAK,CAAC,KAAK,GAAE,MAAM,GAAG,eAA+B,GAAG,OAAO,CAAC,eAAe,CAAC;IAItG,uFAAuF;IACvF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;cAUrB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,aAAa;IAOxG,uDAAuD;IACvD,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF"}

package/dist/modules/arango.js

@@ -1,16 +1,26 @@
 import { GenericContainer } from "../core/generic-container.js";
 import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 const GUEST_PORT = 8529;
-/** A single-node ArangoDB container. Auth is disabled by default; see `withRootPassword` to enable it. */
+const EXPECTED_REPOSITORY = "arangodb";
+const DEFAULT_IMAGE = "arangodb:latest";
+/**
+ * A single-node ArangoDB container. Auth is disabled by default; see
+ * `withRootPassword` to enable it.
+ *
+ * No-arg construction floats to `arangodb:latest`, so the version tracks
+ * upstream rather than this library's release cycle (verified against
+ * `arangodb:3.11`).
+ */
 export class ArangoContainer extends GenericContainer {
     rootPassword;
-    constructor(image = "arangodb:3.11") {
-        super(image);
+    constructor(image = DEFAULT_IMAGE) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
         this.withExposedPorts(GUEST_PORT)
             .withEnv("ARANGO_NO_AUTH", "1")
             .waitingFor(Wait.forHttp("/_api/version").forPort(GUEST_PORT).forStatusCode(200));
     }
-    static async start(image = "arangodb:3.11") {
+    static async start(image = DEFAULT_IMAGE) {
         return (await new ArangoContainer(image).start());
     }
     /** Enables auth with the given root password, instead of the default no-auth setup. */

package/dist/modules/arango.js.map

@@ -1 +1 @@
-{"version":3,"file":"arango.js","sourceRoot":"","sources":["../../src/modules/arango.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGvC,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,0GAA0G;AAC1G,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IAC3C,YAAY,CAAqB;IAEzC,YAAY,KAAK,GAAG,eAAe;QACjC,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;aAC9B,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;aAC9B,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,eAAe;QACjD,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAoB,CAAC;IACvE,CAAC;IAED,uFAAuF;IACvF,gBAAgB,CAAC,QAAgB;QAC/B,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,wEAAwE;IACxE,qEAAqE;IACrE,wEAAwE;IACxE,qEAAqE;IACrE,yDAAyD;IACtC,aAAa,CAAC,IAAmB,EAAE,OAAkC;QACtF,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,gBAAgB,CAAC,EAAE,CAAC;IAChF,CAAC;IAED,uDAAuD;IACvD,IAAI,QAAQ;QACV,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IACjE,CAAC;CACF"}
+{"version":3,"file":"arango.js","sourceRoot":"","sources":["../../src/modules/arango.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,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,mBAAmB,GAAG,UAAU,CAAC;AACvC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,OAAO,eAAgB,SAAQ,gBAAgB;IAC3C,YAAY,CAAqB;IAEzC,YAAY,QAAkC,aAAa;QACzD,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;aAC9B,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;aAC9B,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,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,uFAAuF;IACvF,gBAAgB,CAAC,QAAgB;QAC/B,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,wEAAwE;IACxE,qEAAqE;IACrE,wEAAwE;IACxE,qEAAqE;IACrE,yDAAyD;IACtC,aAAa,CAAC,IAAmB,EAAE,OAAkC;QACtF,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,gBAAgB,CAAC,EAAE,CAAC;IAChF,CAAC;IAED,uDAAuD;IACvD,IAAI,QAAQ;QACV,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IACjE,CAAC;CACF"}

package/dist/modules/cassandra.d.ts

@@ -0,0 +1,57 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.js";
+/**
+ * A single-node Cassandra container.
+ *
+ * No-arg construction floats to `cassandra:latest`, so the version tracks
+ * upstream rather than this library's release cycle (verified against
+ * `cassandra:5.0.8`, including every fact below — the `GPG_KEYS` override
+ * stays unconditional regardless of which version ends up running, since
+ * it's a no-op against a build that never baked the problem tab and required
+ * against one that does).
+ *
+ * ### `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 | DockerImageName);
+    static start(image?: string | DockerImageName): 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;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAO/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,KAAK,GAAE,MAAM,GAAG,eAA+B;WAarC,KAAK,CAAC,KAAK,GAAE,MAAM,GAAG,eAA+B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIzG,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,79 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
+const CQL_PORT = 9042;
+const STARTUP_TIMEOUT_MS = 300_000;
+const EXPECTED_REPOSITORY = "cassandra";
+const DEFAULT_IMAGE = "cassandra:latest";
+/**
+ * A single-node Cassandra container.
+ *
+ * No-arg construction floats to `cassandra:latest`, so the version tracks
+ * upstream rather than this library's release cycle (verified against
+ * `cassandra:5.0.8`, including every fact below — the `GPG_KEYS` override
+ * stays unconditional regardless of which version ends up running, since
+ * it's a no-op against a build that never baked the problem tab and required
+ * against one that does).
+ *
+ * ### `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 = DEFAULT_IMAGE) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
+        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 = DEFAULT_IMAGE) {
+        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;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AACxC,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,QAAkC,aAAa;QACzD,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,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,QAAkC,aAAa;QACzE,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/clickhouse.d.ts

@@ -1,4 +1,5 @@
 import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 /**
  * A single-node ClickHouse container, ready-checked via `/ping` (returns
  * the literal body `Ok.` on 200 — `Wait.forHttp`'s status-code check is all
@@ -12,13 +13,18 @@ import { GenericContainer } from "../core/generic-container.js";
  * entirely — once set, the unauthenticated `default` user's usual
  * passwordless access is gone, and every query needs the configured
  * credentials.
+ *
+ * No-arg construction floats to `clickhouse/clickhouse-server:latest`, so
+ * the version tracks upstream rather than this library's release cycle
+ * (verified against `clickhouse/clickhouse-server:25.8`, including the
+ * memory and startup-timeout facts below).
  */
 export declare class ClickHouseContainer extends GenericContainer {
     private usernameState;
     private passwordState;
     private databaseState;
-    constructor(image?: string);
-    static start(image?: string): Promise<ClickHouseContainer>;
+    constructor(image?: string | DockerImageName);
+    static start(image?: string | DockerImageName): Promise<ClickHouseContainer>;
     /** Overrides `CLICKHOUSE_USER` (default `test`). */
     withUsername(username: string): this;
     /** Overrides `CLICKHOUSE_PASSWORD` (default `test`). */

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

@@ -1 +1 @@
-{"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../src/modules/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMhE;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,aAAa,CAAU;gBAEnB,KAAK,SAAsC;WAejC,KAAK,CAAC,KAAK,SAAsC,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAItG,oDAAoD;IACpD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,wDAAwD;IACxD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,kDAAkD;IAClD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,gDAAgD;IAChD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,qDAAqD;IACrD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,+DAA+D;IAC/D,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}
+{"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../src/modules/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAO/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,aAAa,CAAU;gBAEnB,KAAK,GAAE,MAAM,GAAG,eAA+B;WAerC,KAAK,CAAC,KAAK,GAAE,MAAM,GAAG,eAA+B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI1G,oDAAoD;IACpD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,wDAAwD;IACxD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,kDAAkD;IAClD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,gDAAgD;IAChD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,qDAAqD;IACrD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,+DAA+D;IAC/D,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}

package/dist/modules/clickhouse.js

@@ -1,7 +1,10 @@
 import { GenericContainer } from "../core/generic-container.js";
 import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 const HTTP_PORT = 8123;
 const NATIVE_PORT = 9000;
+const EXPECTED_REPOSITORY = "clickhouse/clickhouse-server";
+const DEFAULT_IMAGE = "clickhouse/clickhouse-server:latest";
 /**
  * A single-node ClickHouse container, ready-checked via `/ping` (returns
  * the literal body `Ok.` on 200 — `Wait.forHttp`'s status-code check is all
@@ -15,13 +18,18 @@ const NATIVE_PORT = 9000;
  * entirely — once set, the unauthenticated `default` user's usual
  * passwordless access is gone, and every query needs the configured
  * credentials.
+ *
+ * No-arg construction floats to `clickhouse/clickhouse-server:latest`, so
+ * the version tracks upstream rather than this library's release cycle
+ * (verified against `clickhouse/clickhouse-server:25.8`, including the
+ * memory and startup-timeout facts below).
  */
 export class ClickHouseContainer extends GenericContainer {
     usernameState = "test";
     passwordState = "test";
     databaseState = "test";
-    constructor(image = "clickhouse/clickhouse-server:25.8") {
-        super(image);
+    constructor(image = DEFAULT_IMAGE) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
         this.withExposedPorts(HTTP_PORT, NATIVE_PORT)
             .withEnv("CLICKHOUSE_USER", this.usernameState)
             .withEnv("CLICKHOUSE_PASSWORD", this.passwordState)
@@ -34,7 +42,7 @@ export class ClickHouseContainer extends GenericContainer {
         // under msb's default ~450MB-and-up microVM sizing headroom in
         // practice (verified booting and answering /ping on msb's default).
     }
-    static async start(image = "clickhouse/clickhouse-server:25.8") {
+    static async start(image = DEFAULT_IMAGE) {
         return (await new ClickHouseContainer(image).start());
     }
     /** Overrides `CLICKHOUSE_USER` (default `test`). */

package/dist/modules/clickhouse.js.map

@@ -1 +1 @@
-{"version":3,"file":"clickhouse.js","sourceRoot":"","sources":["../../src/modules/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IAC/C,aAAa,GAAG,MAAM,CAAC;IACvB,aAAa,GAAG,MAAM,CAAC;IACvB,aAAa,GAAG,MAAM,CAAC;IAE/B,YAAY,KAAK,GAAG,mCAAmC;QACrD,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC;aAC1C,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,aAAa,CAAC;aAC9C,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC,aAAa,CAAC;aAClD,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC;YAC7C,kEAAkE;YAClE,mEAAmE;YACnE,gEAAgE;aAC/D,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;QACpF,qEAAqE;QACrE,+DAA+D;QAC/D,oEAAoE;IACtE,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,mCAAmC;QACrE,OAAO,CAAC,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAwB,CAAC;IAC/E,CAAC;IAED,oDAAoD;IACpD,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,wDAAwD;IACxD,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,kDAAkD;IAClD,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,4CAA4C;IAC5C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,gDAAgD;IAChD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,qDAAqD;IACrD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,+DAA+D;IAC/D,IAAI,OAAO;QACT,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;IAChE,CAAC;CACF"}
+{"version":3,"file":"clickhouse.js","sourceRoot":"","sources":["../../src/modules/clickhouse.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,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAC3D,MAAM,aAAa,GAAG,qCAAqC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IAC/C,aAAa,GAAG,MAAM,CAAC;IACvB,aAAa,GAAG,MAAM,CAAC;IACvB,aAAa,GAAG,MAAM,CAAC;IAE/B,YAAY,QAAkC,aAAa;QACzD,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC;aAC1C,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,aAAa,CAAC;aAC9C,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC,aAAa,CAAC;aAClD,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC;YAC7C,kEAAkE;YAClE,mEAAmE;YACnE,gEAAgE;aAC/D,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;QACpF,qEAAqE;QACrE,+DAA+D;QAC/D,oEAAoE;IACtE,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,QAAkC,aAAa;QACzE,OAAO,CAAC,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAwB,CAAC;IAC/E,CAAC;IAED,oDAAoD;IACpD,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,wDAAwD;IACxD,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,kDAAkD;IAClD,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,4CAA4C;IAC5C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,gDAAgD;IAChD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,qDAAqD;IACrD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,+DAA+D;IAC/D,IAAI,OAAO;QACT,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;IAChE,CAAC;CACF"}

package/dist/modules/elasticsearch.d.ts

@@ -0,0 +1,49 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.js";
+/**
+ * A single-node Elasticsearch container.
+ *
+ * ### No no-arg constructor — Elastic publishes no floating tag
+ *
+ * Every other module in this library floats to the image's own `:latest`
+ * (or an equivalent) when no image is given, so the version tracks upstream
+ * rather than this library's release cycle. Elasticsearch has no such tag to
+ * float to: `elasticsearch:latest`, `elasticsearch:9`, and `elasticsearch:8`
+ * are all 404 on Docker Hub — Elastic publishes only full version tags
+ * (verified against `elasticsearch:9.4.4`, arm64). An explicit image is
+ * therefore required on both the constructor and `start()`; there is no
+ * default to fall back to.
+ *
+ * ### Single-node config
+ *
+ * `discovery.type=single-node` skips the cluster-formation bootstrap
+ * checks a multi-node deployment would otherwise wait on;
+ * `xpack.security.enabled=false` disables TLS/auth so the REST API answers
+ * plain HTTP with no client-side certificate or credential setup;
+ * `ES_JAVA_OPTS=-Xms512m -Xmx512m` sizes the JVM heap down for a test boot.
+ *
+ * Exposes both the REST API (9200, what `restUrl` wraps) and the transport
+ * port (9300, published but not wrapped by any helper here).
+ *
+ * ### Memory and readiness
+ *
+ * `withMemoryLimit(2560)` — measured ~1.1 GB resident in a 2.48 GB guest at
+ * rest. Readiness is a plain HTTP 200 on `/`, reached in 27s on a quiet
+ * local machine; 300s absorbs a loaded CI runner without masking a real
+ * hang.
+ *
+ * **Cluster health never reaches `green` on a single node** — replica
+ * shards (Elasticsearch's own default is one replica per index) have
+ * nowhere to be assigned, so `/_cluster/health` reports `yellow`
+ * indefinitely. A readiness check that waited for `green` would hang until
+ * its own timeout; this module deliberately waits on the plain HTTP probe
+ * above instead.
+ */
+export declare class ElasticsearchContainer extends GenericContainer {
+    constructor(image: string | DockerImageName);
+    /** No default image — see the class doc for why Elasticsearch has no floating tag to fall back to. */
+    static start(image: string | DockerImageName): Promise<ElasticsearchContainer>;
+    /** The REST API's base URL for the running container. */
+    get restUrl(): string;
+}
+//# sourceMappingURL=elasticsearch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elasticsearch.d.ts","sourceRoot":"","sources":["../../src/modules/elasticsearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAO/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;gBAC9C,KAAK,EAAE,MAAM,GAAG,eAAe;IAU3C,sGAAsG;WAChF,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI7F,yDAAyD;IACzD,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}

package/dist/modules/elasticsearch.js

@@ -0,0 +1,66 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { Wait } from "../core/wait.js";
+import { DockerImageName } from "../core/docker-image-name.js";
+const REST_PORT = 9200;
+const TRANSPORT_PORT = 9300;
+const STARTUP_TIMEOUT_MS = 300_000;
+const EXPECTED_REPOSITORY = "elasticsearch";
+/**
+ * A single-node Elasticsearch container.
+ *
+ * ### No no-arg constructor — Elastic publishes no floating tag
+ *
+ * Every other module in this library floats to the image's own `:latest`
+ * (or an equivalent) when no image is given, so the version tracks upstream
+ * rather than this library's release cycle. Elasticsearch has no such tag to
+ * float to: `elasticsearch:latest`, `elasticsearch:9`, and `elasticsearch:8`
+ * are all 404 on Docker Hub — Elastic publishes only full version tags
+ * (verified against `elasticsearch:9.4.4`, arm64). An explicit image is
+ * therefore required on both the constructor and `start()`; there is no
+ * default to fall back to.
+ *
+ * ### Single-node config
+ *
+ * `discovery.type=single-node` skips the cluster-formation bootstrap
+ * checks a multi-node deployment would otherwise wait on;
+ * `xpack.security.enabled=false` disables TLS/auth so the REST API answers
+ * plain HTTP with no client-side certificate or credential setup;
+ * `ES_JAVA_OPTS=-Xms512m -Xmx512m` sizes the JVM heap down for a test boot.
+ *
+ * Exposes both the REST API (9200, what `restUrl` wraps) and the transport
+ * port (9300, published but not wrapped by any helper here).
+ *
+ * ### Memory and readiness
+ *
+ * `withMemoryLimit(2560)` — measured ~1.1 GB resident in a 2.48 GB guest at
+ * rest. Readiness is a plain HTTP 200 on `/`, reached in 27s on a quiet
+ * local machine; 300s absorbs a loaded CI runner without masking a real
+ * hang.
+ *
+ * **Cluster health never reaches `green` on a single node** — replica
+ * shards (Elasticsearch's own default is one replica per index) have
+ * nowhere to be assigned, so `/_cluster/health` reports `yellow`
+ * indefinitely. A readiness check that waited for `green` would hang until
+ * its own timeout; this module deliberately waits on the plain HTTP probe
+ * above instead.
+ */
+export class ElasticsearchContainer extends GenericContainer {
+    constructor(image) {
+        super(DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY));
+        this.withExposedPorts(REST_PORT, TRANSPORT_PORT)
+            .withEnv("discovery.type", "single-node")
+            .withEnv("xpack.security.enabled", "false")
+            .withEnv("ES_JAVA_OPTS", "-Xms512m -Xmx512m")
+            .withMemoryLimit(2560)
+            .waitingFor(Wait.forHttp("/").forPort(REST_PORT).withStartupTimeout(STARTUP_TIMEOUT_MS));
+    }
+    /** No default image — see the class doc for why Elasticsearch has no floating tag to fall back to. */
+    static async start(image) {
+        return (await new ElasticsearchContainer(image).start());
+    }
+    /** The REST API's base URL for the running container. */
+    get restUrl() {
+        return `http://${this.host}:${this.getMappedPort(REST_PORT)}`;
+    }
+}
+//# sourceMappingURL=elasticsearch.js.map

package/dist/modules/elasticsearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elasticsearch.js","sourceRoot":"","sources":["../../src/modules/elasticsearch.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,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IAC1D,YAAY,KAA+B;QACzC,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,CAAC;aAC7C,OAAO,CAAC,gBAAgB,EAAE,aAAa,CAAC;aACxC,OAAO,CAAC,wBAAwB,EAAE,OAAO,CAAC;aAC1C,OAAO,CAAC,cAAc,EAAE,mBAAmB,CAAC;aAC5C,eAAe,CAAC,IAAI,CAAC;aACrB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED,sGAAsG;IACtG,MAAM,CAAU,KAAK,CAAC,KAAK,CAAC,KAA+B;QACzD,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAA2B,CAAC;IACrF,CAAC;IAED,yDAAyD;IACzD,IAAI,OAAO;QACT,OAAO,UAAU,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;IAChE,CAAC;CACF"}

package/dist/modules/flink.d.ts

@@ -1,9 +1,15 @@
 import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 import type { SandboxBackend } from "../core/backend.js";
 /**
  * A Flink JobManager container (REST 8081, RPC 6123), with an optional
  * companion TaskManager on Docker only — see `withTaskManager()`.
  *
+ * No-arg construction floats to `flink:latest`, so the version tracks
+ * upstream rather than this library's release cycle (verified against
+ * `flink:1.20.5`, including the `nc`/busybox absence this class doc relies
+ * on below).
+ *
  * `FLINK_PROPERTIES` must set `jobmanager.rpc.address` on the JobManager
  * itself (not just the TaskManager): the JobManager's own Pekko/Akka actor
  * system binds its external address from this property too, and the image's
@@ -38,8 +44,8 @@ export declare class FlinkContainer extends GenericContainer {
     private taskManagerContainer;
     private taskManagerNetwork;
     private ownedNetwork;
-    constructor(image?: string);
-    static start(image?: string): Promise<FlinkContainer>;
+    constructor(image?: string | DockerImageName);
+    static start(image?: string | DockerImageName): Promise<FlinkContainer>;
     /**
      * Requests a companion TaskManager, started on a shared `Network` once
      * the JobManager is ready. Docker only — see the class doc for why msb

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

@@ -1 +1 @@
-{"version":3,"file":"flink.d.ts","sourceRoot":"","sources":["../../src/modules/flink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAIhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,oBAAoB,CAA+B;IAC3D,OAAO,CAAC,kBAAkB,CAAsB;IAChD,OAAO,CAAC,YAAY,CAAsB;gBAE9B,KAAK,SAAiB;WAWZ,KAAK,CAAC,KAAK,SAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI5E;;;;;;OAMG;IACH,eAAe,IAAI,IAAI;IASvB;;;;;;;OAOG;cACsB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;cAU3D,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYpC,oDAAoD;IACpD,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}
+{"version":3,"file":"flink.d.ts","sourceRoot":"","sources":["../../src/modules/flink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAIhE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,oBAAoB,CAA+B;IAC3D,OAAO,CAAC,kBAAkB,CAAsB;IAChD,OAAO,CAAC,YAAY,CAAsB;gBAE9B,KAAK,GAAE,MAAM,GAAG,eAA+B;WAYrC,KAAK,CAAC,KAAK,GAAE,MAAM,GAAG,eAA+B,GAAG,OAAO,CAAC,cAAc,CAAC;IAIrG;;;;;;OAMG;IACH,eAAe,IAAI,IAAI;IASvB;;;;;;;OAOG;cACsB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;cAU3D,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYpC,oDAAoD;IACpD,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}

package/dist/modules/flink.js

@@ -2,15 +2,23 @@ import { GenericContainer } from "../core/generic-container.js";
 import { Network } from "../core/network.js";
 import { Wait } from "../core/wait.js";
 import { UnsupportedByBackendError } from "../core/errors.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 const RPC_PORT = 6123;
 const REST_PORT = 8081;
 const JOBMANAGER_MEMORY_MB = 1024;
 const TASKMANAGER_MEMORY_MB = 1024;
 const JOBMANAGER_ALIAS = "flink-jobmanager";
+const EXPECTED_REPOSITORY = "flink";
+const DEFAULT_IMAGE = "flink:latest";
 /**
  * A Flink JobManager container (REST 8081, RPC 6123), with an optional
  * companion TaskManager on Docker only — see `withTaskManager()`.
  *
+ * No-arg construction floats to `flink:latest`, so the version tracks
+ * upstream rather than this library's release cycle (verified against
+ * `flink:1.20.5`, including the `nc`/busybox absence this class doc relies
+ * on below).
+ *
  * `FLINK_PROPERTIES` must set `jobmanager.rpc.address` on the JobManager
  * itself (not just the TaskManager): the JobManager's own Pekko/Akka actor
  * system binds its external address from this property too, and the image's
@@ -45,9 +53,10 @@ export class FlinkContainer extends GenericContainer {
     taskManagerContainer;
     taskManagerNetwork;
     ownedNetwork;
-    constructor(image = "flink:1.20.5") {
-        super(image);
-        this.imageTag = image;
+    constructor(image = DEFAULT_IMAGE) {
+        const resolvedImage = DockerImageName.requireCompatible(image, EXPECTED_REPOSITORY);
+        super(resolvedImage);
+        this.imageTag = resolvedImage;
         this.withExposedPorts(RPC_PORT, REST_PORT)
             .withEnv("FLINK_PROPERTIES", `jobmanager.rpc.address: ${JOBMANAGER_ALIAS}`)
             .withCommand("jobmanager")
@@ -55,7 +64,7 @@ export class FlinkContainer extends GenericContainer {
             .withNetworkAliases(JOBMANAGER_ALIAS)
             .waitingFor(Wait.forHttp("/overview").forPort(REST_PORT).withStartupTimeout(120_000));
     }
-    static async start(image = "flink:1.20.5") {
+    static async start(image = DEFAULT_IMAGE) {
         return (await new FlinkContainer(image).start());
     }
     /**

package/dist/modules/flink.js.map

@@ -1 +1 @@
-{"version":3,"file":"flink.js","sourceRoot":"","sources":["../../src/modules/flink.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flink.js","sourceRoot":"","sources":["../../src/modules/flink.ts"],"names":[],"mappings":"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"}

package/dist/modules/floci.d.ts

@@ -1,4 +1,5 @@
 import { GenericContainer } from "../core/generic-container.js";
+import { DockerImageName } from "../core/docker-image-name.js";
 /**
  * A [floci.io](https://floci.io) cloud emulator — one native Quarkus image
  * per cloud provider, each speaking that provider's REST APIs against an
@@ -17,6 +18,17 @@ import { GenericContainer } from "../core/generic-container.js";
  * `floci/floci-az:0.8.0`, and `floci/floci-gcp:0.4.0`) — pinned as the one
  * wait path that works across all three; no log-wait fallback was needed.
  *
+ * ### No-arg factories float, each to its own repository's `latest`
+ *
+ * `aws()`, `azure()`, and `gcp()` each default to that provider's
+ * `floci/floci*:latest`, so the version tracks upstream rather than this
+ * library's release cycle — verified against `floci/floci:1.5.30`,
+ * `floci/floci-az:0.8.0`, and `floci/floci-gcp:0.4.0` respectively, the same
+ * boots every other fact on this page cites. Each factory checks its own
+ * repository (`floci/floci`, `floci/floci-az`, `floci/floci-gcp`) — an image
+ * meant for one variant is rejected by another's factory with
+ * `IncompatibleImageError` before any backend call.
+ *
  * ### No signing needed — verified against the AWS variant's S3 surface
  *
  * The AWS variant's S3-shaped REST endpoints accept unsigned requests with
@@ -34,12 +46,24 @@ import { GenericContainer } from "../core/generic-container.js";
 export declare class FlociContainer extends GenericContainer {
     private readonly guestPort;
     private constructor();
-    /** The AWS emulator (`floci/floci:1.5.30`), guest port 4566 — S3, DynamoDB, SQS, etc. */
-    static aws(image?: string): FlociContainer;
-    /** The Azure emulator (`floci/floci-az:0.8.0`), guest port 4577. */
-    static azure(image?: string): FlociContainer;
-    /** The GCP emulator (`floci/floci-gcp:0.4.0`), guest port 4588. */
-    static gcp(image?: string): FlociContainer;
+    /**
+     * The AWS emulator, guest port 4566 — S3, DynamoDB, SQS, etc. Floats to
+     * `floci/floci:latest` (verified against `floci/floci:1.5.30`); only
+     * accepts images whose repository is `floci/floci`.
+     */
+    static aws(image?: string | DockerImageName): FlociContainer;
+    /**
+     * The Azure emulator, guest port 4577. Floats to
+     * `floci/floci-az:latest` (verified against `floci/floci-az:0.8.0`); only
+     * accepts images whose repository is `floci/floci-az`.
+     */
+    static azure(image?: string | DockerImageName): FlociContainer;
+    /**
+     * The GCP emulator, guest port 4588. Floats to
+     * `floci/floci-gcp:latest` (verified against `floci/floci-gcp:0.4.0`);
+     * only accepts images whose repository is `floci/floci-gcp`.
+     */
+    static gcp(image?: string | DockerImageName): FlociContainer;
     /** This variant's REST endpoint — the base URL for every emulated API call. */
     get endpointUrl(): string;
 }