@specific.dev/spectest 0.77.0 → 0.78.0

package/dist/components/s3.d.ts

@@ -1,7 +1,5 @@
 import { type S3ClientLike } from "../s3.js";
 export interface S3Options {
-    /** HTTP port the S3 API is served on. Default `9090`. */
-    port?: number;
     /**
      * Buckets to create on first boot. The backing server's own `initialBuckets`
      * env is unreliable across versions, so the component creates them in `setup`
@@ -17,7 +15,7 @@ export interface S3Options {
     /**
      * Hostnames to additionally serve the store at over **HTTPS** (CA-trusted),
      * via the daemon's TLS-terminating reverse proxy. Optional — defaults to none;
-     * the store is always reachable at `http://<key>:<port>` regardless. Set this
+     * the store is always reachable at `http://<key>:9090` regardless. Set this
      * only when the app under test hardcodes a specific prod S3 endpoint it can't
      * be told to override (`https://<bucket>.s3.amazonaws.com`, a provider's
      * storage host): the daemon mints a cert for each host and proxies to the

package/dist/components/s3.js

@@ -3,6 +3,15 @@ import { S3Client } from "../s3.js";
 // is the current release; avoid exactly 5.0.0, which crashed at startup on
 // Java 25 (`NoClassDefFoundError: KotlinBuiltIns$2`) — fixed in 5.1.0.
 const S3_IMAGE = "adobe/s3mock:5.1.0";
+// Port the store listens on, fixed like the image and deliberately NOT an
+// option. The backing server's HTTP port is baked into the image, and nothing
+// the component returns can move it — so a `port` option could only relabel
+// the ready check, the declared ports and the client endpoint while the
+// container kept listening here. That is exactly what it did until 0.78.0: a
+// project that passed one got 60 s of refused probes and an environment that
+// never booted, with a healthy container beside it. A service reaches the
+// store at `http://<key>:9090`.
+const S3_PORT = 9090;
 /**
  * A ready-to-use, S3-compatible object store (backed by
  * [`adobe/s3mock`](https://github.com/adobe/S3Mock)), with an instrumented S3
@@ -35,7 +44,6 @@ const S3_IMAGE = "adobe/s3mock:5.1.0";
  * ```
  */
 export function s3(opts = {}) {
-    const port = opts.port ?? 9090;
     const buckets = opts.buckets ?? [];
     const defaultBucket = opts.bucket ?? buckets[0];
     const accessKeyId = opts.accessKeyId ?? "s3";
@@ -43,16 +51,16 @@ export function s3(opts = {}) {
     const region = opts.region ?? "us-east-1";
     return {
         image: { type: "registry", reference: S3_IMAGE },
-        ports: [port],
+        ports: [S3_PORT],
         ...(opts.env ? { env: opts.env } : {}),
         ...(opts.hosts
-            ? { tls: opts.hosts.map((hostname) => ({ hostname, port })) }
+            ? { tls: opts.hosts.map((hostname) => ({ hostname, port: S3_PORT })) }
             : {}),
         // GET / returns the ListBuckets XML with 200 once the store is up.
-        readyCheck: { type: "http", port, path: "/", timeoutSecs: 60 },
+        readyCheck: { type: "http", port: S3_PORT, path: "/", timeoutSecs: 60 },
         helpers: ({ name }) => ({
             client: new S3Client({
-                endpoint: `http://${name}:${port}`,
+                endpoint: `http://${name}:${S3_PORT}`,
                 region,
                 accessKeyId,
                 secretAccessKey,
@@ -67,7 +75,7 @@ export function s3(opts = {}) {
                         // CreateBucket is a plain `PUT` on the bucket root; the store
                         // returns 200 (or 409 if it already exists — idempotent enough to
                         // ignore).
-                        const res = await fetch(`http://${name}:${port}/${bucket}`, {
+                        const res = await fetch(`http://${name}:${S3_PORT}/${bucket}`, {
                             method: "PUT",
                         });
                         if (!res.ok && res.status !== 409) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specific.dev/spectest",
-  "version": "0.77.0",
+  "version": "0.78.0",
   "description": "Spectest SDK for defining test environments in TypeScript.",
   "type": "module",
   "main": "./dist/index.js",

package/src/components/s3.ts

@@ -2,8 +2,6 @@ import type { ServiceDefinition } from "../index.js";
 import { S3Client, type S3ClientLike } from "../s3.js";
 
 export interface S3Options {
-  /** HTTP port the S3 API is served on. Default `9090`. */
-  port?: number;
   /**
    * Buckets to create on first boot. The backing server's own `initialBuckets`
    * env is unreliable across versions, so the component creates them in `setup`
@@ -19,7 +17,7 @@ export interface S3Options {
   /**
    * Hostnames to additionally serve the store at over **HTTPS** (CA-trusted),
    * via the daemon's TLS-terminating reverse proxy. Optional — defaults to none;
-   * the store is always reachable at `http://<key>:<port>` regardless. Set this
+   * the store is always reachable at `http://<key>:9090` regardless. Set this
    * only when the app under test hardcodes a specific prod S3 endpoint it can't
    * be told to override (`https://<bucket>.s3.amazonaws.com`, a provider's
    * storage host): the daemon mints a cert for each host and proxies to the
@@ -51,6 +49,16 @@ export interface S3Helpers {
 // Java 25 (`NoClassDefFoundError: KotlinBuiltIns$2`) — fixed in 5.1.0.
 const S3_IMAGE = "adobe/s3mock:5.1.0";
 
+// Port the store listens on, fixed like the image and deliberately NOT an
+// option. The backing server's HTTP port is baked into the image, and nothing
+// the component returns can move it — so a `port` option could only relabel
+// the ready check, the declared ports and the client endpoint while the
+// container kept listening here. That is exactly what it did until 0.78.0: a
+// project that passed one got 60 s of refused probes and an environment that
+// never booted, with a healthy container beside it. A service reaches the
+// store at `http://<key>:9090`.
+const S3_PORT = 9090;
+
 /**
  * A ready-to-use, S3-compatible object store (backed by
  * [`adobe/s3mock`](https://github.com/adobe/S3Mock)), with an instrumented S3
@@ -83,7 +91,6 @@ const S3_IMAGE = "adobe/s3mock:5.1.0";
  * ```
  */
 export function s3(opts: S3Options = {}) {
-  const port = opts.port ?? 9090;
   const buckets = opts.buckets ?? [];
   const defaultBucket = opts.bucket ?? buckets[0];
   const accessKeyId = opts.accessKeyId ?? "s3";
@@ -92,16 +99,16 @@ export function s3(opts: S3Options = {}) {
 
   return {
     image: { type: "registry", reference: S3_IMAGE },
-    ports: [port],
+    ports: [S3_PORT],
     ...(opts.env ? { env: opts.env } : {}),
     ...(opts.hosts
-      ? { tls: opts.hosts.map((hostname) => ({ hostname, port })) }
+      ? { tls: opts.hosts.map((hostname) => ({ hostname, port: S3_PORT })) }
       : {}),
     // GET / returns the ListBuckets XML with 200 once the store is up.
-    readyCheck: { type: "http" as const, port, path: "/", timeoutSecs: 60 },
+    readyCheck: { type: "http" as const, port: S3_PORT, path: "/", timeoutSecs: 60 },
     helpers: ({ name }: { name: string }): S3Helpers => ({
       client: new S3Client({
-        endpoint: `http://${name}:${port}`,
+        endpoint: `http://${name}:${S3_PORT}`,
         region,
         accessKeyId,
         secretAccessKey,
@@ -116,7 +123,7 @@ export function s3(opts: S3Options = {}) {
               // CreateBucket is a plain `PUT` on the bucket root; the store
               // returns 200 (or 409 if it already exists — idempotent enough to
               // ignore).
-              const res = await fetch(`http://${name}:${port}/${bucket}`, {
+              const res = await fetch(`http://${name}:${S3_PORT}/${bucket}`, {
                 method: "PUT",
               });
               if (!res.ok && res.status !== 409) {