rightsize 0.1.0

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

@@ -0,0 +1,18 @@
+import { GenericContainer } from "../core/generic-container.js";
+/**
+ * A Spring Cloud Config Server container, ready-checked via its actuator
+ * health endpoint.
+ *
+ * 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
+ * container never becomes ready on msb (times out around 180s); with it,
+ * boot completes in roughly 19s.
+ */
+export declare class SpringCloudConfigContainer extends GenericContainer {
+    constructor(image?: string);
+    static start(image?: string): Promise<SpringCloudConfigContainer>;
+    /** The config server's base URI for the running container. */
+    get uri(): string;
+}
+//# sourceMappingURL=spring-cloud-config.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,28 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { Wait } from "../core/wait.js";
+const GUEST_PORT = 8888;
+/**
+ * A Spring Cloud Config Server container, ready-checked via its actuator
+ * health endpoint.
+ *
+ * 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
+ * container never becomes ready on msb (times out around 180s); with it,
+ * boot completes in roughly 19s.
+ */
+export class SpringCloudConfigContainer extends GenericContainer {
+    constructor(image = "hyness/spring-cloud-config-server:latest") {
+        super(image);
+        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") {
+        return (await new SpringCloudConfigContainer(image).start());
+    }
+    /** The config server's base URI for the running container. */
+    get uri() {
+        return `http://${this.host}:${this.getMappedPort(GUEST_PORT)}`;
+    }
+}
+//# sourceMappingURL=spring-cloud-config.js.map

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

@@ -0,0 +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"}

package/dist/modules/wiremock.d.ts

@@ -0,0 +1,21 @@
+import { GenericContainer } from "../core/generic-container.js";
+/**
+ * A single-node WireMock container — the TypeScript ecosystem has no
+ * in-process WireMock equivalent (unlike the JVM, where WireMock runs
+ * embedded in the test process); this module is the closest thing:
+ * a real WireMock server, isolated per test run, reachable over HTTP.
+ *
+ * `/__admin/health` ships in 3.x (verified against 3.13.2) and is a small,
+ * 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").
+ */
+export declare class WireMockContainer extends GenericContainer {
+    constructor(image?: string);
+    static start(image?: string): 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). */
+    get adminUrl(): string;
+}
+//# sourceMappingURL=wiremock.d.ts.map

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

@@ -0,0 +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"}

package/dist/modules/wiremock.js

@@ -0,0 +1,32 @@
+import { GenericContainer } from "../core/generic-container.js";
+import { Wait } from "../core/wait.js";
+const GUEST_PORT = 8080;
+/**
+ * A single-node WireMock container — the TypeScript ecosystem has no
+ * in-process WireMock equivalent (unlike the JVM, where WireMock runs
+ * embedded in the test process); this module is the closest thing:
+ * a real WireMock server, isolated per test run, reachable over HTTP.
+ *
+ * `/__admin/health` ships in 3.x (verified against 3.13.2) and is a small,
+ * 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").
+ */
+export class WireMockContainer extends GenericContainer {
+    constructor(image = "wiremock/wiremock:3.13.2") {
+        super(image);
+        this.withExposedPorts(GUEST_PORT).waitingFor(Wait.forHttp("/__admin/health").forPort(GUEST_PORT));
+    }
+    static async start(image = "wiremock/wiremock:3.13.2") {
+        return (await new WireMockContainer(image).start());
+    }
+    /** The stubbed API's base URL (mock endpoints are served from here). */
+    get baseUrl() {
+        return `http://${this.host}:${this.getMappedPort(GUEST_PORT)}`;
+    }
+    /** The admin API's base URL (`/__admin/...` — mapping management, health, requests). */
+    get adminUrl() {
+        return `${this.baseUrl}/__admin`;
+    }
+}
+//# sourceMappingURL=wiremock.js.map

package/dist/modules/wiremock.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "rightsize",
+  "version": "0.1.0",
+  "description": "Testcontainers-style integration testing on microsandbox microVMs, with a Docker fallback and an await-using lifecycle. No Docker required.",
+  "keywords": [
+    "testcontainers",
+    "microvm",
+    "microsandbox",
+    "docker",
+    "testing",
+    "integration-testing",
+    "containers"
+  ],
+  "homepage": "https://github.com/ngriaznov/rightsize-node#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ngriaznov/rightsize-node.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ngriaznov/rightsize-node/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "Mykyta Hriaznov (https://github.com/ngriaznov)",
+  "type": "module",
+  "engines": {
+    "node": ">=22.11"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./modules": {
+      "types": "./dist/modules/index.d.ts",
+      "import": "./dist/modules/index.js"
+    },
+    "./backend-msb": {
+      "types": "./dist/backend-msb/index.d.ts",
+      "import": "./dist/backend-msb/index.js"
+    },
+    "./backend-docker": {
+      "types": "./dist/backend-docker/index.d.ts",
+      "import": "./dist/backend-docker/index.js"
+    }
+  },
+  "sideEffects": [
+    "./dist/backend-msb/index.js",
+    "./dist/backend-docker/index.js"
+  ],
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "prepublishOnly": "npm run build && npm run typecheck && npm run test:node",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pretest:node": "tsc -p tsconfig.test.json && npm run copy-test-fixtures",
+    "test:node": "node --test 'dist-test/**/*.test.js'",
+    "test:node:it": "npm run pretest:node && cross-env RIGHTSIZE_IT=1 node --test --test-concurrency=1 --test-timeout=300000 'dist-test/**/*.test.js'",
+    "test:bun": "bun test --path-ignore-patterns='dist-test/**' --path-ignore-patterns='examples/**'",
+    "test:bun:it": "cross-env RIGHTSIZE_IT=1 bun test --path-ignore-patterns='dist-test/**' --path-ignore-patterns='examples/**' --timeout=300000",
+    "test": "npm run test:node && npm run test:bun",
+    "verify-async-dispose": "npm run pretest:node && node --test dist-test/src/core/async-dispose-verifier.test.js && bun test dist-test/src/core/async-dispose-verifier.test.js",
+    "copy-test-fixtures": "node scripts/copy-test-fixtures.mjs",
+    "precoverage": "tsc -p tsconfig.test.json && npm run copy-test-fixtures",
+    "coverage": "node --test --experimental-test-coverage 'dist-test/**/*.test.js'",
+    "precoverage:core": "tsc -p tsconfig.test.json && npm run copy-test-fixtures",
+    "coverage:core": "node --test --experimental-test-coverage --test-coverage-include='dist-test/src/core/**' --test-coverage-lines=80 'dist-test/**/*.test.js'",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "predocs:verify": "npm run build",
+    "docs:verify": "node scripts/verify-docs.mjs",
+    "docs:verify:run": "npm run build && cross-env RIGHTSIZE_DOCS_RUN=1 node scripts/verify-docs.mjs",
+    "docs:api-check": "typedoc --emit none",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "preexamples:build": "npm run build",
+    "examples:build": "node scripts/link-self.mjs && tsc -p tsconfig.examples.json",
+    "example:redis": "npm run examples:build && node dist-examples/redis-quickstart.js",
+    "example:network": "npm run examples:build && node dist-examples/network-alias.js",
+    "example:test": "npm run examples:build && node --test dist-examples/redis.test.js",
+    "examples:run": "npm run examples:build && node dist-examples/redis-quickstart.js && node dist-examples/network-alias.js && node --test dist-examples/redis.test.js"
+  },
+  "devDependencies": {
+    "@types/amqplib": "^0.10.8",
+    "@types/node": "^22.10.5",
+    "@types/pg": "^8.20.0",
+    "amqplib": "^2.0.1",
+    "bun-types": "^1.1.38",
+    "cross-env": "^10.1.0",
+    "kafkajs": "^2.2.4",
+    "mongodb": "^7.4.0",
+    "mysql2": "^3.22.5",
+    "pg": "^8.22.0",
+    "redis": "^6.1.0",
+    "typedoc": "^0.28.19",
+    "typescript": "^5.7.3",
+    "vitepress": "^1.5.0"
+  },
+  "dependencies": {
+    "tslib": "^2.8.1"
+  }
+}