@warp-drive/holodeck 0.1.0-alpha.63 → 0.1.0-alpha.65

package/dist/mock.js

@@ -1,153 +1,199 @@
-import { mock, getIsRecording } from './index.js';
+import { getIsRecording, mock } from "./index.js";
 
+//#region src/mock.ts
 /**
- * @public
- */
-
-/**
- * @public
- */
-
-/**
- * @public
- */
-
-/**
- * Sets up Mocking for a GET request on the mock server
- * for the supplied url.
- *
- * The response body is generated by the supplied response function.
- *
- * Available options:
- * - status: the status code to return (default: 200)
- * - headers: the headers to return (default: {})
- * - body: the body to match against for the request (default: null)
- * - RECORD: whether to record the request (default: false)
- *
- * @param url the url to mock, relative to the mock server host (e.g. `users/1`)
- * @param response a function which generates the response to return
- * @param options status, headers for the response, body to match against for the request, and whether to record the request
- * @return
- */
+* Sets up Mocking for a GET request on the mock server
+* for the supplied url.
+*
+* The response body is generated by the supplied response function.
+*
+* Available options:
+* - status: the status code to return (default: 200)
+* - headers: the headers to return (default: {})
+* - body: the body to match against for the request (default: null)
+* - RECORD: whether to record the request (default: false)
+*
+* @param url the url to mock, relative to the mock server host (e.g. `users/1`)
+* @param response a function which generates the response to return
+* @param options status, headers for the response, body to match against for the request, and whether to record the request
+* @return
+*/
 function GET(owner, url, response, options) {
-  return mock(owner, () => ({
-    status: options?.status ?? 200,
-    statusText: options?.statusText ?? 'OK',
-    headers: options?.headers ?? {},
-    body: options?.body ?? null,
-    method: 'GET',
-    url,
-    response: response()
-  }), getIsRecording() || (options?.RECORD ?? false));
+	return mock(owner, () => ({
+		status: options?.status ?? 200,
+		statusText: options?.statusText ?? "OK",
+		headers: options?.headers ?? {},
+		body: options?.body ?? null,
+		method: "GET",
+		url,
+		response: response()
+	}), getIsRecording() || (options?.RECORD ?? false));
 }
-const STATUS_TEXT_FOR = new Map([[200, 'OK'], [201, 'Created'], [202, 'Accepted'], [203, 'Non-Authoritative Information'], [204, 'No Content'], [205, 'Reset Content'], [206, 'Partial Content'], [207, 'Multi-Status'], [208, 'Already Reported'], [226, 'IM Used'], [300, 'Multiple Choices'], [301, 'Moved Permanently'], [302, 'Found'], [303, 'See Other'], [304, 'Not Modified'], [307, 'Temporary Redirect'], [308, 'Permanent Redirect'], [400, 'Bad Request'], [401, 'Unauthorized'], [402, 'Payment Required'], [403, 'Forbidden'], [404, 'Not Found'], [405, 'Method Not Allowed'], [406, 'Not Acceptable'], [407, 'Proxy Authentication Required'], [408, 'Request Timeout'], [409, 'Conflict'], [410, 'Gone'], [411, 'Length Required'], [412, 'Precondition Failed'], [413, 'Payload Too Large'], [414, 'URI Too Long'], [415, 'Unsupported Media Type'], [416, 'Range Not Satisfiable'], [417, 'Expectation Failed'], [419, 'Page Expired'], [420, 'Enhance Your Calm'], [421, 'Misdirected Request'], [422, 'Unprocessable Entity'], [423, 'Locked'], [424, 'Failed Dependency'], [425, 'Too Early'], [426, 'Upgrade Required'], [428, 'Precondition Required'], [429, 'Too Many Requests'], [430, 'Request Header Fields Too Large'], [431, 'Request Header Fields Too Large'], [450, 'Blocked By Windows Parental Controls'], [451, 'Unavailable For Legal Reasons'], [500, 'Internal Server Error'], [501, 'Not Implemented'], [502, 'Bad Gateway'], [503, 'Service Unavailable'], [504, 'Gateway Timeout'], [505, 'HTTP Version Not Supported'], [506, 'Variant Also Negotiates'], [507, 'Insufficient Storage'], [508, 'Loop Detected'], [509, 'Bandwidth Limit Exceeded'], [510, 'Not Extended'], [511, 'Network Authentication Required']]);
-
+const STATUS_TEXT_FOR = /* @__PURE__ */ new Map([
+	[200, "OK"],
+	[201, "Created"],
+	[202, "Accepted"],
+	[203, "Non-Authoritative Information"],
+	[204, "No Content"],
+	[205, "Reset Content"],
+	[206, "Partial Content"],
+	[207, "Multi-Status"],
+	[208, "Already Reported"],
+	[226, "IM Used"],
+	[300, "Multiple Choices"],
+	[301, "Moved Permanently"],
+	[302, "Found"],
+	[303, "See Other"],
+	[304, "Not Modified"],
+	[307, "Temporary Redirect"],
+	[308, "Permanent Redirect"],
+	[400, "Bad Request"],
+	[401, "Unauthorized"],
+	[402, "Payment Required"],
+	[403, "Forbidden"],
+	[404, "Not Found"],
+	[405, "Method Not Allowed"],
+	[406, "Not Acceptable"],
+	[407, "Proxy Authentication Required"],
+	[408, "Request Timeout"],
+	[409, "Conflict"],
+	[410, "Gone"],
+	[411, "Length Required"],
+	[412, "Precondition Failed"],
+	[413, "Payload Too Large"],
+	[414, "URI Too Long"],
+	[415, "Unsupported Media Type"],
+	[416, "Range Not Satisfiable"],
+	[417, "Expectation Failed"],
+	[419, "Page Expired"],
+	[420, "Enhance Your Calm"],
+	[421, "Misdirected Request"],
+	[422, "Unprocessable Entity"],
+	[423, "Locked"],
+	[424, "Failed Dependency"],
+	[425, "Too Early"],
+	[426, "Upgrade Required"],
+	[428, "Precondition Required"],
+	[429, "Too Many Requests"],
+	[430, "Request Header Fields Too Large"],
+	[431, "Request Header Fields Too Large"],
+	[450, "Blocked By Windows Parental Controls"],
+	[451, "Unavailable For Legal Reasons"],
+	[500, "Internal Server Error"],
+	[501, "Not Implemented"],
+	[502, "Bad Gateway"],
+	[503, "Service Unavailable"],
+	[504, "Gateway Timeout"],
+	[505, "HTTP Version Not Supported"],
+	[506, "Variant Also Negotiates"],
+	[507, "Insufficient Storage"],
+	[508, "Loop Detected"],
+	[509, "Bandwidth Limit Exceeded"],
+	[510, "Not Extended"],
+	[511, "Network Authentication Required"]
+]);
 /**
- * Mock a POST request
- */
+* Mock a POST request
+*/
 function POST(owner, url, response, options) {
-  return mock(owner, () => {
-    const body = response();
-    const status = options?.status ?? (body ? 201 : 204);
-    return {
-      status: status,
-      statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? '',
-      headers: options?.headers ?? {},
-      body: options?.body ?? null,
-      method: 'POST',
-      url,
-      response: body
-    };
-  }, getIsRecording() || (options?.RECORD ?? false));
+	return mock(owner, () => {
+		const body = response();
+		const status = options?.status ?? (body ? 201 : 204);
+		return {
+			status,
+			statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? "",
+			headers: options?.headers ?? {},
+			body: options?.body ?? null,
+			method: "POST",
+			url,
+			response: body
+		};
+	}, getIsRecording() || (options?.RECORD ?? false));
 }
-
 /**
- * mock a PUT request
- */
+* mock a PUT request
+*/
 function PUT(owner, url, response, options) {
-  return mock(owner, () => {
-    const body = response();
-    const status = options?.status ?? (body ? 200 : 204);
-    return {
-      status: status,
-      statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? '',
-      headers: options?.headers ?? {},
-      body: options?.body ?? null,
-      method: 'PUT',
-      url,
-      response: body
-    };
-  }, getIsRecording() || (options?.RECORD ?? false));
+	return mock(owner, () => {
+		const body = response();
+		const status = options?.status ?? (body ? 200 : 204);
+		return {
+			status,
+			statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? "",
+			headers: options?.headers ?? {},
+			body: options?.body ?? null,
+			method: "PUT",
+			url,
+			response: body
+		};
+	}, getIsRecording() || (options?.RECORD ?? false));
 }
 /**
- * mock a PATCH request
- *
- */
+* mock a PATCH request
+*
+*/
 function PATCH(owner, url, response, options) {
-  return mock(owner, () => {
-    const body = response();
-    const status = options?.status ?? (body ? 200 : 204);
-    return {
-      status: status,
-      statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? '',
-      headers: options?.headers ?? {},
-      body: options?.body ?? null,
-      method: 'PATCH',
-      url,
-      response: body
-    };
-  }, getIsRecording() || (options?.RECORD ?? false));
+	return mock(owner, () => {
+		const body = response();
+		const status = options?.status ?? (body ? 200 : 204);
+		return {
+			status,
+			statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? "",
+			headers: options?.headers ?? {},
+			body: options?.body ?? null,
+			method: "PATCH",
+			url,
+			response: body
+		};
+	}, getIsRecording() || (options?.RECORD ?? false));
 }
 /**
- * mock a DELETE request
- */
+* mock a DELETE request
+*/
 function DELETE(owner, url, response, options) {
-  return mock(owner, () => {
-    const body = response();
-    const status = options?.status ?? (body ? 200 : 204);
-    return {
-      status: status,
-      statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? '',
-      headers: options?.headers ?? {},
-      body: options?.body ?? null,
-      method: 'DELETE',
-      url,
-      response: body
-    };
-  }, getIsRecording() || (options?.RECORD ?? false));
+	return mock(owner, () => {
+		const body = response();
+		const status = options?.status ?? (body ? 200 : 204);
+		return {
+			status,
+			statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? "",
+			headers: options?.headers ?? {},
+			body: options?.body ?? null,
+			method: "DELETE",
+			url,
+			response: body
+		};
+	}, getIsRecording() || (options?.RECORD ?? false));
 }
-
 /**
- * Sets up Mocking for a HEAD request on the mock server
- * for the supplied url.
- *
- * The response body is generated by the supplied response function.
- *
- * Available options:
- * - status: the status code to return (default: 200)
- * - headers: the headers to return (default: {})
- * - body: the body to match against for the request (default: null)
- * - RECORD: whether to record the request (default: false)
- *
- * @param url the url to mock, relative to the mock server host (e.g. `users/1`)
- * @param response a function which generates the response to return
- * @param options status, headers for the response, body to match against for the request, and whether to record the request
- * @return
- */
-function HEAD(owner, url, response,
-// TODO: should we omit the `body` as well?
-// It does _seem_ possible for HEAD requests to have a body, but it should be ignored.
-// From MDN: Warning: If a response to a HEAD request has a body, the response body must be ignored.
-options) {
-  return mock(owner, () => ({
-    status: options?.status ?? 200,
-    statusText: options?.statusText ?? 'OK',
-    headers: options?.headers ?? {},
-    body: options?.body ?? null,
-    method: 'HEAD',
-    url,
-    response: response()
-  }), getIsRecording() || (options?.RECORD ?? false));
+* Sets up Mocking for a HEAD request on the mock server
+* for the supplied url.
+*
+* The response body is generated by the supplied response function.
+*
+* Available options:
+* - status: the status code to return (default: 200)
+* - headers: the headers to return (default: {})
+* - body: the body to match against for the request (default: null)
+* - RECORD: whether to record the request (default: false)
+*
+* @param url the url to mock, relative to the mock server host (e.g. `users/1`)
+* @param response a function which generates the response to return
+* @param options status, headers for the response, body to match against for the request, and whether to record the request
+* @return
+*/
+function HEAD(owner, url, response, options) {
+	return mock(owner, () => ({
+		status: options?.status ?? 200,
+		statusText: options?.statusText ?? "OK",
+		headers: options?.headers ?? {},
+		body: options?.body ?? null,
+		method: "HEAD",
+		url,
+		response: response()
+	}), getIsRecording() || (options?.RECORD ?? false));
 }
 
+//#endregion
 export { DELETE, GET, HEAD, PATCH, POST, PUT };
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","names":[],"sources":["../src/mock.ts"],"sourcesContent":["import { getIsRecording, mock } from '.';\n\n/**\n * @public\n */\nexport interface Scaffold {\n  status: number;\n  statusText?: string;\n  headers: Record<string, string>;\n  body: Record<string, string> | string | null;\n  method: string;\n  url: string;\n  response: Record<string, unknown>;\n}\n\n/**\n * @public\n */\nexport type ScaffoldGenerator = () => Scaffold;\n\n/**\n * @public\n */\nexport type ResponseGenerator = () => Record<string, unknown>;\n\n/**\n * Sets up Mocking for a GET request on the mock server\n * for the supplied url.\n *\n * The response body is generated by the supplied response function.\n *\n * Available options:\n * - status: the status code to return (default: 200)\n * - headers: the headers to return (default: {})\n * - body: the body to match against for the request (default: null)\n * - RECORD: whether to record the request (default: false)\n *\n * @param url the url to mock, relative to the mock server host (e.g. `users/1`)\n * @param response a function which generates the response to return\n * @param options status, headers for the response, body to match against for the request, and whether to record the request\n * @return\n */\nexport function GET(\n  owner: object,\n  url: string,\n  response: ResponseGenerator,\n  options?: Partial<Omit<Scaffold, 'response' | 'url' | 'method'>> & { RECORD?: boolean }\n): Promise<void> {\n  return mock(\n    owner,\n    () => ({\n      status: options?.status ?? 200,\n      statusText: options?.statusText ?? 'OK',\n      headers: options?.headers ?? {},\n      body: options?.body ?? null,\n      method: 'GET',\n      url,\n      response: response(),\n    }),\n    getIsRecording() || (options?.RECORD ?? false)\n  );\n}\n\nconst STATUS_TEXT_FOR = new Map([\n  [200, 'OK'],\n  [201, 'Created'],\n  [202, 'Accepted'],\n  [203, 'Non-Authoritative Information'],\n  [204, 'No Content'],\n  [205, 'Reset Content'],\n  [206, 'Partial Content'],\n  [207, 'Multi-Status'],\n  [208, 'Already Reported'],\n  [226, 'IM Used'],\n  [300, 'Multiple Choices'],\n  [301, 'Moved Permanently'],\n  [302, 'Found'],\n  [303, 'See Other'],\n  [304, 'Not Modified'],\n  [307, 'Temporary Redirect'],\n  [308, 'Permanent Redirect'],\n  [400, 'Bad Request'],\n  [401, 'Unauthorized'],\n  [402, 'Payment Required'],\n  [403, 'Forbidden'],\n  [404, 'Not Found'],\n  [405, 'Method Not Allowed'],\n  [406, 'Not Acceptable'],\n  [407, 'Proxy Authentication Required'],\n  [408, 'Request Timeout'],\n  [409, 'Conflict'],\n  [410, 'Gone'],\n  [411, 'Length Required'],\n  [412, 'Precondition Failed'],\n  [413, 'Payload Too Large'],\n  [414, 'URI Too Long'],\n  [415, 'Unsupported Media Type'],\n  [416, 'Range Not Satisfiable'],\n  [417, 'Expectation Failed'],\n  [419, 'Page Expired'],\n  [420, 'Enhance Your Calm'],\n  [421, 'Misdirected Request'],\n  [422, 'Unprocessable Entity'],\n  [423, 'Locked'],\n  [424, 'Failed Dependency'],\n  [425, 'Too Early'],\n  [426, 'Upgrade Required'],\n  [428, 'Precondition Required'],\n  [429, 'Too Many Requests'],\n  [430, 'Request Header Fields Too Large'],\n  [431, 'Request Header Fields Too Large'],\n  [450, 'Blocked By Windows Parental Controls'],\n  [451, 'Unavailable For Legal Reasons'],\n  [500, 'Internal Server Error'],\n  [501, 'Not Implemented'],\n  [502, 'Bad Gateway'],\n  [503, 'Service Unavailable'],\n  [504, 'Gateway Timeout'],\n  [505, 'HTTP Version Not Supported'],\n  [506, 'Variant Also Negotiates'],\n  [507, 'Insufficient Storage'],\n  [508, 'Loop Detected'],\n  [509, 'Bandwidth Limit Exceeded'],\n  [510, 'Not Extended'],\n  [511, 'Network Authentication Required'],\n]);\n\n/**\n * Mock a POST request\n */\nexport function POST(\n  owner: object,\n  url: string,\n  response: ResponseGenerator,\n  options?: Partial<Omit<Scaffold, 'response' | 'url' | 'method'>> & { RECORD?: boolean }\n): Promise<void> {\n  return mock(\n    owner,\n    () => {\n      const body = response();\n      const status = options?.status ?? (body ? 201 : 204);\n\n      return {\n        status: status,\n        statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? '',\n        headers: options?.headers ?? {},\n        body: options?.body ?? null,\n        method: 'POST',\n        url,\n        response: body,\n      };\n    },\n    getIsRecording() || (options?.RECORD ?? false)\n  );\n}\n\n/**\n * mock a PUT request\n */\nexport function PUT(\n  owner: object,\n  url: string,\n  response: ResponseGenerator,\n  options?: Partial<Omit<Scaffold, 'response' | 'url' | 'method'>> & { RECORD?: boolean }\n): Promise<void> {\n  return mock(\n    owner,\n    () => {\n      const body = response();\n      const status = options?.status ?? (body ? 200 : 204);\n\n      return {\n        status: status,\n        statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? '',\n        headers: options?.headers ?? {},\n        body: options?.body ?? null,\n        method: 'PUT',\n        url,\n        response: body,\n      };\n    },\n    getIsRecording() || (options?.RECORD ?? false)\n  );\n}\n/**\n * mock a PATCH request\n *\n */\nexport function PATCH(\n  owner: object,\n  url: string,\n  response: ResponseGenerator,\n  options?: Partial<Omit<Scaffold, 'response' | 'url' | 'method'>> & { RECORD?: boolean }\n): Promise<void> {\n  return mock(\n    owner,\n    () => {\n      const body = response();\n      const status = options?.status ?? (body ? 200 : 204);\n\n      return {\n        status: status,\n        statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? '',\n        headers: options?.headers ?? {},\n        body: options?.body ?? null,\n        method: 'PATCH',\n        url,\n        response: body,\n      };\n    },\n    getIsRecording() || (options?.RECORD ?? false)\n  );\n}\n/**\n * mock a DELETE request\n */\nexport function DELETE(\n  owner: object,\n  url: string,\n  response: ResponseGenerator,\n  options?: Partial<Omit<Scaffold, 'response' | 'url' | 'method'>> & { RECORD?: boolean }\n): Promise<void> {\n  return mock(\n    owner,\n    () => {\n      const body = response();\n      const status = options?.status ?? (body ? 200 : 204);\n\n      return {\n        status: status,\n        statusText: options?.statusText ?? STATUS_TEXT_FOR.get(status) ?? '',\n        headers: options?.headers ?? {},\n        body: options?.body ?? null,\n        method: 'DELETE',\n        url,\n        response: body,\n      };\n    },\n    getIsRecording() || (options?.RECORD ?? false)\n  );\n}\n\n/**\n * Sets up Mocking for a HEAD request on the mock server\n * for the supplied url.\n *\n * The response body is generated by the supplied response function.\n *\n * Available options:\n * - status: the status code to return (default: 200)\n * - headers: the headers to return (default: {})\n * - body: the body to match against for the request (default: null)\n * - RECORD: whether to record the request (default: false)\n *\n * @param url the url to mock, relative to the mock server host (e.g. `users/1`)\n * @param response a function which generates the response to return\n * @param options status, headers for the response, body to match against for the request, and whether to record the request\n * @return\n */\nexport function HEAD(\n  owner: object,\n  url: string,\n  response: ResponseGenerator,\n  // TODO: should we omit the `body` as well?\n  // It does _seem_ possible for HEAD requests to have a body, but it should be ignored.\n  // From MDN: Warning: If a response to a HEAD request has a body, the response body must be ignored.\n  options?: Partial<Omit<Scaffold, 'response' | 'url' | 'method'>> & { RECORD?: boolean }\n): Promise<void> {\n  return mock(\n    owner,\n    () => ({\n      status: options?.status ?? 200,\n      statusText: options?.statusText ?? 'OK',\n      headers: options?.headers ?? {},\n      body: options?.body ?? null,\n      method: 'HEAD',\n      url,\n      response: response(),\n    }),\n    getIsRecording() || (options?.RECORD ?? false)\n  );\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@warp-drive/holodeck",
   "description": "⚡️ Simple, Fast HTTP Mocking for Tests",
-  "version": "0.1.0-alpha.63",
+  "version": "0.1.0-alpha.65",
   "license": "MIT",
   "author": "Chris Thoburn <runspired@users.noreply.github.com>",
   "repository": {
@@ -32,16 +32,15 @@
     "README.md",
     "LICENSE.md",
     "server",
-    "declarations",
     "logos"
   ],
   "bin": {
     "ensure-cert": "./server/ensure-cert.js"
   },
   "peerDependencies": {
-    "@warp-drive/utilities": "5.9.0-alpha.20",
-    "@warp-drive/legacy": "5.9.0-alpha.20",
-    "@warp-drive/core": "5.9.0-alpha.20"
+    "@warp-drive/utilities": "5.9.0-alpha.22",
+    "@warp-drive/legacy": "5.9.0-alpha.22",
+    "@warp-drive/core": "5.9.0-alpha.22"
   },
   "peerDependenciesMeta": {
     "@warp-drive/utilities": {
@@ -57,11 +56,11 @@
     "@babel/preset-env": "^7.28.3",
     "@babel/preset-typescript": "^7.27.1",
     "@babel/runtime": "^7.28.3",
-    "@warp-drive/utilities": "5.9.0-alpha.20",
-    "@warp-drive/legacy": "5.9.0-alpha.20",
-    "@warp-drive/core": "5.9.0-alpha.20",
-    "@warp-drive/internal-config": "5.9.0-alpha.20",
-    "vite": "^7.3.1"
+    "@warp-drive/utilities": "5.9.0-alpha.22",
+    "@warp-drive/legacy": "5.9.0-alpha.22",
+    "@warp-drive/core": "5.9.0-alpha.22",
+    "@warp-drive/internal-config": "5.9.0-alpha.22",
+    "tsdown": "^0.22.14"
   },
   "exports": {
     ".": {
@@ -69,25 +68,25 @@
       "bun": "./server/index.js",
       "deno": "./server/index.js",
       "browser": {
-        "types": "./declarations/index.d.ts",
+        "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       },
       "import": {
-        "types": "./declarations/index.d.ts",
+        "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       },
       "default": "./server/index.js"
     },
     "./mock": {
-      "types": "./declarations/mock.d.ts",
+      "types": "./dist/mock.d.ts",
       "default": "./dist/mock.js"
     }
   },
   "scripts": {
-    "check:pkg-types": "tsc --noEmit",
-    "build:pkg": "vite build",
+    "check:types": "tsc --noEmit",
+    "build:pkg": "node node_modules/tsdown/dist/run.mjs",
     "sync": "echo \"syncing\"",
     "_temporarily_deactivated_lint": "eslint . --quiet --cache --cache-strategy=content",
-    "start": "vite"
+    "start": "node node_modules/tsdown/dist/run.mjs --watch"
   }
 }

package/server/bun.js

@@ -8,6 +8,7 @@ import fs from 'node:fs';
 import path from 'path';
 import { Worker, threadId, parentPort } from 'node:worker_threads';
 import {
+  bindWithRetry,
   compress,
   createCloseHandler,
   DEFAULT_PORT,
@@ -307,15 +308,17 @@ async function _createServer(options) {
     hostname: options.hostname ?? 'localhost',
   };
 
-  const server = Bun.serve({
-    fetch: app.fetch,
-    tls: {
-      key: KEY,
-      cert: CERT,
-    },
-    port: location.port,
-    hostname: location.hostname,
-  });
+  const server = await bindWithRetry(() =>
+    Bun.serve({
+      fetch: app.fetch,
+      tls: {
+        key: KEY,
+        cert: CERT,
+      },
+      port: location.port,
+      hostname: location.hostname,
+    })
+  );
 
   console.log(
     `\tServing Holodeck HTTP Mocks from ${chalk.yellow('https://') + chalk.magenta(location.hostname + ':') + chalk.yellow(location.port)}\n`

package/server/node.js

@@ -9,6 +9,7 @@ import fs from 'node:fs';
 import path from 'path';
 import { Worker, threadId, parentPort } from 'node:worker_threads';
 import {
+  bindWithRetry,
   compress,
   createCloseHandler,
   DEFAULT_PORT,
@@ -308,23 +309,25 @@ async function _createServer(options) {
     hostname: options.hostname ?? 'localhost',
   };
 
-  const server = serve({
-    overrideGlobalObjects: true,
-    fetch: app.fetch,
-    serverOptions: {
-      key: KEY,
-      cert: CERT,
-      // rejectUnauthorized: false,
-      // enableTrace: true,
-      // Allow HTTP/1.1 fallback for ALPN negotiation
-      // allowHTTP1: true,
-      // ALPNProtocols: ['h2', 'http/1.1', 'http/1.0'],
-      // origins: ['*'],
-    },
-    createServer: createSecureServer,
-    port: location.port,
-    hostname: location.hostname,
-  });
+  const server = await bindWithRetry(() =>
+    serve({
+      overrideGlobalObjects: true,
+      fetch: app.fetch,
+      serverOptions: {
+        key: KEY,
+        cert: CERT,
+        // rejectUnauthorized: false,
+        // enableTrace: true,
+        // Allow HTTP/1.1 fallback for ALPN negotiation
+        // allowHTTP1: true,
+        // ALPNProtocols: ['h2', 'http/1.1', 'http/1.0'],
+        // origins: ['*'],
+      },
+      createServer: createSecureServer,
+      port: location.port,
+      hostname: location.hostname,
+    })
+  );
 
   console.log(
     `\tServing Holodeck HTTP Mocks from ${chalk.yellow('https://') + chalk.magenta(location.hostname + ':') + chalk.yellow(location.port)}\n`

package/server/utils.js

@@ -127,3 +127,58 @@ export function createCloseHandler(cb) {
     cb();
   };
 }
+
+/**
+ * Binds a server created by `createServerFn()`, retrying on the same port if
+ * it's already in use.
+ *
+ * Holodeck's port is never renegotiated on conflict -- every test app's
+ * client-side test-helper derives holodeck's URL as `window.location.port +
+ * 1` (the diagnostic server's own port, plus one), so holodeck must bind
+ * exactly the port it was asked for or the browser can never find it.
+ * Instead, this retries the *same* port a few times with a short delay, to
+ * ride out the narrow window where a concurrently-starting sibling process's
+ * diagnostic server hasn't released this exact port yet (see
+ * packages/diagnostic/server/utils/port-lock.js for the reservation scheme
+ * that's supposed to prevent that from happening at all -- this is a
+ * defense-in-depth fallback for anything outside that convention).
+ *
+ * `createServerFn` must synchronously create the server and start binding,
+ * returning the server instance. Some implementations (Bun.serve) throw
+ * synchronously on a bind failure; others (Node's http/http2 `.listen()`,
+ * which is what @hono/node-server uses under the hood) bind asynchronously
+ * and emit an 'error' event on the returned server instead of throwing. This
+ * handles both.
+ */
+export async function bindWithRetry(createServerFn, { maxAttempts = 5, retryDelayMs = 150 } = {}) {
+  for (let attempt = 1; ; attempt++) {
+    try {
+      const server = createServerFn();
+      if (typeof server?.on !== 'function') {
+        // no event emitter to observe an async bind failure on -- the
+        // synchronous creation above already succeeded, so assume the bind
+        // did too (this is the Bun.serve path, which throws synchronously
+        // instead)
+        return server;
+      }
+      const bindError = await new Promise((resolve) => {
+        const onError = (e) => resolve(e);
+        server.once('error', onError);
+        setTimeout(() => {
+          server.off('error', onError);
+          resolve(null);
+        }, retryDelayMs);
+      });
+      if (!bindError) {
+        return server;
+      }
+      throw bindError;
+    } catch (e) {
+      if (e?.code !== 'EADDRINUSE' || attempt >= maxAttempts) {
+        throw e;
+      }
+      console.log(`\tPort in use, retrying bind (attempt ${attempt}/${maxAttempts})...`);
+      await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
+    }
+  }
+}

package/declarations/index.d.ts

@@ -1,52 +0,0 @@
-import type { Handler, NextFn } from "@warp-drive/core/request";
-import type { RequestContext, StructuredDataDocument } from "@warp-drive/core/types/request";
-import type { Store } from "@warp-drive/legacy/store";
-import type { ScaffoldGenerator } from "./mock.js";
-/**
-* @public
-*/
-export declare function setConfig({ host }: {
-	host: string;
-}): void;
-/**
-* @public
-*/
-export declare function setTestId(context: object, str: string | null): void;
-/**
-* @public
-*/
-export declare function setIsRecording(value: boolean): void;
-/**
-* @public
-*/
-export declare function getIsRecording(): boolean;
-/**
-* A request handler that intercepts requests and routes them through
-* the Holodeck mock server.
-*
-* This handler modifies the request URL to include test identifiers
-* and manages request counts for accurate mocking.
-*
-* Requires that the test context be configured with a testId using `setTestId`.
-*
-* @param owner - the test context object used to retrieve the test ID.
-*/
-export declare class MockServerHandler implements Handler {
-	owner: object;
-	constructor(owner: object);
-	request<T>(context: RequestContext, next: NextFn<T>): Promise<StructuredDataDocument<T>>;
-}
-/**
-* Creates an adapterFor function that wraps the provided adapterFor function
-* to override the adapter's _fetchRequest method to route requests through
-* the Holodeck mock server.
-*
-* @param owner - The test context object used to retrieve the test ID.
-*/
-export declare function installAdapterFor(owner: object, store: Store): void;
-/**
-* Mock a request by sending the scaffold to the mock server.
-*
-* @public
-*/
-export declare function mock(owner: object, generate: ScaffoldGenerator, isRecording?: boolean): Promise<void>;