refactor: use Docker mock server from GHCR instead of fetching spec

CI starts ghcr.io/nimbleway/sdk-mock-server (Prism + spec) as a
container, then runs tests against it. setup.ts detects if Prism is
already running (Docker case) or starts it locally (dev case with
fetched spec).

Author: omermorad

.github/workflows/ci.yml

@@ -125,11 +125,12 @@ jobs:
   contract-tests:
     timeout-minutes: 10
     name: contract tests
-    runs-on: ${{ github.repository == 'stainless-sdks/nimbleway-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ubuntu-latest
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     permissions:
       contents: read
       pull-requests: write
+      packages: read
     steps:
       - uses: actions/checkout@v6
 
@@ -149,8 +150,19 @@ jobs:
       - name: Build SDK
         run: ./scripts/build
 
-      - name: Fetch OpenAPI spec
-        run: pnpm --filter sdk-contract-tests run fetch-spec
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Start mock server
+        run: |
+          docker run -d --name prism-mock -p 4010:4010 \
+            ghcr.io/nimbleway/sdk-mock-server:latest
+          timeout 30 bash -c 'until curl -sf http://127.0.0.1:4010/ >/dev/null 2>&1; do sleep 1; done'
+          echo "Mock server ready"
 
       - name: Run contract tests
         id: tests
@@ -167,6 +179,10 @@ jobs:
           echo "total=$TOTAL" >> "$GITHUB_OUTPUT"
           echo "files=$FILES" >> "$GITHUB_OUTPUT"
 
+      - name: Stop mock server
+        if: always()
+        run: docker rm -f prism-mock 2>/dev/null || true
+
       - name: Generate coverage reports
         if: always() && steps.tests.outcome == 'success'
         run: |

contract-tests/src/setup.ts

@@ -10,6 +10,21 @@ const PRISM_BIN = resolve(CONTRACT_TESTS_ROOT, 'node_modules', '.bin', 'prism');
 const PRISM_PORT = process.env.PRISM_PORT || '4010';
 const SPEC_PATH = process.env.OPENAPI_SPEC_PATH || join(__dirname, '..', 'spec', 'openapi.yaml');
 
+function checkPrism(port: string): Promise<boolean> {
+  return new Promise((resolve) => {
+    const req = http.get(`http://127.0.0.1:${port}/`, (res) => {
+      res.resume();
+      resolve(true);
+    });
+    req.on('error', () => resolve(false));
+    req.setTimeout(1000, () => {
+      req.destroy();
+      resolve(false);
+    });
+    req.end();
+  });
+}
+
 function waitForPrism(port: string, timeoutMs = 30_000): Promise<void> {
   const start = Date.now();
   return new Promise((resolve, reject) => {
@@ -32,8 +47,16 @@ function waitForPrism(port: string, timeoutMs = 30_000): Promise<void> {
 }
 
 let prismProcess: ChildProcess | null = null;
+let managedByUs = false;
 
 export async function setup() {
+  const alreadyRunning = await checkPrism(PRISM_PORT);
+
+  if (alreadyRunning) {
+    console.log(`Prism mock server already running on port ${PRISM_PORT} (external/Docker)`);
+    return;
+  }
+
   console.log(`Starting Prism mock server on port ${PRISM_PORT}...`);
   console.log(`Spec: ${SPEC_PATH}`);
 
@@ -48,12 +71,15 @@ export async function setup() {
   );
 
   prismProcess.unref();
+  managedByUs = true;
 
   await waitForPrism(PRISM_PORT);
   console.log(`Prism mock server ready on http://127.0.0.1:${PRISM_PORT}`);
 }
 
 export async function teardown() {
+  if (!managedByUs) return;
+
   if (prismProcess?.pid) {
     try {
       process.kill(-prismProcess.pid, 'SIGTERM');