@warp-drive/holodeck 0.0.0-alpha.12 → 0.0.0-alpha.120

package/README.md

@@ -40,16 +40,21 @@
 
 ## Installation
 
-> ⚠️ Private
-
-This package may currently only be used within EmberData. A public version is coming soon 💜
 
 ```json
-"devDependencies": {
-  "@warp-drive/holodeck": "workspace:*"
-}
+pnpm install @warp-drive/holodeck
 ```
 
+**Tagged Releases**
+
+- ![NPM Canary Version](https://img.shields.io/npm/v/%40warp-drive/holodeck/canary?label=%40canary&color=FFBF00)
+- ![NPM Beta Version](https://img.shields.io/npm/v/%40warp-drive/holodeck/beta?label=%40beta&color=ff00ff)
+- ![NPM Stable Version](https://img.shields.io/npm/v/%40warp-drive/holodeck/latest?label=%40latest&color=90EE90)
+- ![NPM LTS Version](https://img.shields.io/npm/v/%40warp-drive/holodeck/lts?label=%40lts&color=0096FF)
+- ![NPM LTS 4.12 Version](https://img.shields.io/npm/v/%40warp-drive/holodeck/lts-4-12?label=%40lts-4-12&color=bbbbbb)
+
+
+
 ## Usage
 #### Mocking from Within a Test
 
@@ -89,6 +94,152 @@ and `brotli` minification in a way that can be replayed over and over again.
 
 Basically, pay the cost when you write the test. Forever after skip the cost until you need to edit the test again.
 
+## Setup
+
+### Use with WarpDrive
+
+First, you will need to add the holodeck handler to the request manager chain prior to `Fetch` (or any equivalent handler that proceeds to network).
+
+For instance:
+
+```ts
+import RequestManager from '@ember-data/request';
+import Fetch from '@ember-data/request/fetch';
+import { MockServerHandler } from '@warp-drive/holodeck';
+
+const manager = new RequestManager()
+  .use([new MockServerHandler(testContext), Fetch]);
+```
+
+From within a test this might look like:
+
+```ts
+import RequestManager from '@ember-data/request';
+import Fetch from '@ember-data/request/fetch';
+import { MockServerHandler } from '@warp-drive/holodeck';
+import { module, test } from 'qunit';
+
+module('my module', function() {
+  test('my test', async function() {
+    const manager = new RequestManager()
+      .use([new MockServerHandler(this), Fetch]);
+  });
+});
+```
+
+Next, you will need to configure holodeck to understand your tests contexts. For qunit and diagnostic
+in a project using Ember this is typically done in `tests/test-helper.js`
+
+#### With Diagnostic
+
+```ts
+import { setupGlobalHooks } from '@warp-drive/diagnostic';
+import { setConfig, setTestId } from '@warp-drive/holodeck';
+
+// if not proxying the port / set port to the correct value here
+const MockHost = `https://${window.location.hostname}:${Number(window.location.port) + 1}`;
+
+setConfig({ host: MockHost });
+
+setupGlobalHooks((hooks) => {
+  hooks.beforeEach(function (assert) {
+    setTestId(this, assert.test.testId);
+  });
+  hooks.afterEach(function () {
+    setTestId(this, null);
+  });
+});
+```
+
+#### With QUnit
+
+```ts
+import * as QUnit from 'qunit';
+import { setConfig, setTestId } from '@warp-drive/holodeck';
+
+// if not proxying the port / set port to the correct value here
+const MockHost = `https://${window.location.hostname}:${Number(window.location.port) + 1}`;
+
+setConfig({ host: MockHost });
+
+QUnit.hooks.beforeEach(function (assert) {
+  setTestId(assert.test.testId);
+});
+QUnit.hooks.afterEach(function (assert) {
+  setTestId(null);
+});
+```
+
+### Testem
+
+You can integrate holodeck with Testem using testem's [async config capability](https://github.com/testem/testem/blob/master/docs/config_file.md#returning-a-promise-from-testemjs):
+
+```ts
+module.exports = async function () {
+  const holodeck = (await import('@warp-drive/holodeck')).default;
+  await holodeck.launchProgram({
+    port: 7373,
+  });
+
+  process.on('beforeExit', async () => {
+    await holodeck.endProgram();
+  });
+
+  return {
+    // ... testem config
+  };
+};
+```
+
+If you need the API mock to run on the same port as the test suite, you can use Testem's [API Proxy](https://github.com/testem/testem/tree/master?tab=readme-ov-file#api-proxy)
+
+```ts
+module.exports = async function () {
+  const holodeck = (await import('@warp-drive/holodeck')).default;
+  await holodeck.launchProgram({
+    port: 7373,
+  });
+
+  process.on('beforeExit', async () => {
+    await holodeck.endProgram();
+  });
+
+  return {
+    "proxies": {
+      "/api": {
+        // holodeck always runs on https
+        // the proxy is transparent so this means /api/v1 will route to https://localhost:7373/api/v1
+        "target": "https://localhost:7373",
+        // "onlyContentTypes": ["xml", "json"],
+        // if test suite is on http, set this to false
+        // "secure": false,
+      },
+    }
+  };
+};
+```
+
+### Diagnostic
+
+holodeck can be launched and cleaned up using the lifecycle hooks in the launch config
+for diagnostic in `diagnostic.js`:
+
+```ts
+import launch from '@warp-drive/diagnostic/server/default-setup.js';
+import holodeck from '@warp-drive/holodeck';
+
+await launch({
+  async setup(options) {
+    await holodeck.launchProgram({
+      port: options.port + 1,
+    });
+  },
+  async cleanup() {
+    await holodeck.endProgram();
+  },
+});
+```
+
 ### ♥️ Credits
 
  <details>

package/dist/index.js

@@ -1,4 +1,10 @@
 const TEST_IDS = new WeakMap();
+let HOST = 'https://localhost:1135/';
+function setConfig({
+  host
+}) {
+  HOST = host.endsWith('/') ? host : `${host}/`;
+}
 function setTestId(context, str) {
   if (str && TEST_IDS.has(context)) {
     throw new Error(`MockServerHandler is already configured with a testId.`);
@@ -38,7 +44,9 @@ class MockServerHandler {
     request.credentials = 'omit';
     request.referrerPolicy = '';
     try {
-      return await next(request);
+      const future = next(request);
+      context.setStream(future.getStream());
+      return await future;
     } catch (e) {
       if (e instanceof Error && !(e instanceof DOMException)) {
         e.message = e.message.replace(queryForTest, '');
@@ -54,7 +62,7 @@ async function mock(owner, generate, isRecording) {
   }
   const testMockNum = test.mock++;
   if (getIsRecording() || isRecording) {
-    const url = `https://localhost:1135/__record?__xTestId=${test.id}&__xTestRequestNumber=${testMockNum}`;
+    const url = `${HOST}__record?__xTestId=${test.id}&__xTestRequestNumber=${testMockNum}`;
     await fetch(url, {
       method: 'POST',
       body: JSON.stringify(generate()),
@@ -65,5 +73,5 @@ async function mock(owner, generate, isRecording) {
   }
 }
 
-export { MockServerHandler, getIsRecording, mock, setIsRecording, setTestId };
+export { MockServerHandler, getIsRecording, mock, setConfig, setIsRecording, setTestId };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../client/index.ts"],"sourcesContent":["import type { Handler, NextFn, RequestContext, RequestInfo, StructuredDataDocument } from '@ember-data/request';\n\nimport type { ScaffoldGenerator } from './mock';\n\nconst TEST_IDS = new WeakMap<object, { id: string; request: number; mock: number }>();\n\nexport function setTestId(context: object, str: string | null) {\n  if (str && TEST_IDS.has(context)) {\n    throw new Error(`MockServerHandler is already configured with a testId.`);\n  }\n  if (str) {\n    TEST_IDS.set(context, { id: str, request: 0, mock: 0 });\n  } else {\n    TEST_IDS.delete(context);\n  }\n}\n\nlet IS_RECORDING = false;\nexport function setIsRecording(value: boolean) {\n  IS_RECORDING = Boolean(value);\n}\nexport function getIsRecording() {\n  return IS_RECORDING;\n}\n\nexport class MockServerHandler implements Handler {\n  declare owner: object;\n  constructor(owner: object) {\n    this.owner = owner;\n  }\n  async request<T>(context: RequestContext, next: NextFn<T>): Promise<StructuredDataDocument<T>> {\n    const test = TEST_IDS.get(this.owner);\n    if (!test) {\n      throw new Error(\n        `MockServerHandler is not configured with a testId. Use setTestId to set the testId for each test`\n      );\n    }\n\n    const request: RequestInfo = Object.assign({}, context.request);\n    const isRecording = request.url!.endsWith('/__record');\n    const firstChar = request.url!.includes('?') ? '&' : '?';\n    const queryForTest = `${firstChar}__xTestId=${test.id}&__xTestRequestNumber=${\n      isRecording ? test.mock++ : test.request++\n    }`;\n    request.url = request.url + queryForTest;\n\n    request.mode = 'cors';\n    request.credentials = 'omit';\n    request.referrerPolicy = '';\n\n    try {\n      return await next(request);\n    } catch (e) {\n      if (e instanceof Error && !(e instanceof DOMException)) {\n        e.message = e.message.replace(queryForTest, '');\n      }\n      throw e;\n    }\n  }\n}\n\nexport async function mock(owner: object, generate: ScaffoldGenerator, isRecording?: boolean) {\n  const test = TEST_IDS.get(owner);\n  if (!test) {\n    throw new Error(`Cannot call \"mock\" before configuring a testId. Use setTestId to set the testId for each test`);\n  }\n  const testMockNum = test.mock++;\n  if (getIsRecording() || isRecording) {\n    const url = `https://localhost:1135/__record?__xTestId=${test.id}&__xTestRequestNumber=${testMockNum}`;\n    await fetch(url, {\n      method: 'POST',\n      body: JSON.stringify(generate()),\n      mode: 'cors',\n      credentials: 'omit',\n      referrerPolicy: '',\n    });\n  }\n}\n"],"names":["TEST_IDS","WeakMap","setTestId","context","str","has","Error","set","id","request","mock","delete","IS_RECORDING","setIsRecording","value","Boolean","getIsRecording","MockServerHandler","constructor","owner","next","test","get","Object","assign","isRecording","url","endsWith","firstChar","includes","queryForTest","mode","credentials","referrerPolicy","e","DOMException","message","replace","generate","testMockNum","fetch","method","body","JSON","stringify"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import type { Handler, NextFn, RequestContext, RequestInfo, StructuredDataDocument } from '@ember-data/request';\n\nimport type { ScaffoldGenerator } from './mock';\n\nconst TEST_IDS = new WeakMap<object, { id: string; request: number; mock: number }>();\n\nlet HOST = 'https://localhost:1135/';\nexport function setConfig({ host }: { host: string }) {\n  HOST = host.endsWith('/') ? host : `${host}/`;\n}\n\nexport function setTestId(context: object, str: string | null) {\n  if (str && TEST_IDS.has(context)) {\n    throw new Error(`MockServerHandler is already configured with a testId.`);\n  }\n  if (str) {\n    TEST_IDS.set(context, { id: str, request: 0, mock: 0 });\n  } else {\n    TEST_IDS.delete(context);\n  }\n}\n\nlet IS_RECORDING = false;\nexport function setIsRecording(value: boolean) {\n  IS_RECORDING = Boolean(value);\n}\nexport function getIsRecording() {\n  return IS_RECORDING;\n}\n\nexport class MockServerHandler implements Handler {\n  declare owner: object;\n  constructor(owner: object) {\n    this.owner = owner;\n  }\n  async request<T>(context: RequestContext, next: NextFn<T>): Promise<StructuredDataDocument<T>> {\n    const test = TEST_IDS.get(this.owner);\n    if (!test) {\n      throw new Error(\n        `MockServerHandler is not configured with a testId. Use setTestId to set the testId for each test`\n      );\n    }\n\n    const request: RequestInfo = Object.assign({}, context.request);\n    const isRecording = request.url!.endsWith('/__record');\n    const firstChar = request.url!.includes('?') ? '&' : '?';\n    const queryForTest = `${firstChar}__xTestId=${test.id}&__xTestRequestNumber=${\n      isRecording ? test.mock++ : test.request++\n    }`;\n    request.url = request.url + queryForTest;\n\n    request.mode = 'cors';\n    request.credentials = 'omit';\n    request.referrerPolicy = '';\n\n    try {\n      const future = next(request);\n      context.setStream(future.getStream());\n      return await future;\n    } catch (e) {\n      if (e instanceof Error && !(e instanceof DOMException)) {\n        e.message = e.message.replace(queryForTest, '');\n      }\n      throw e;\n    }\n  }\n}\n\nexport async function mock(owner: object, generate: ScaffoldGenerator, isRecording?: boolean) {\n  const test = TEST_IDS.get(owner);\n  if (!test) {\n    throw new Error(`Cannot call \"mock\" before configuring a testId. Use setTestId to set the testId for each test`);\n  }\n  const testMockNum = test.mock++;\n  if (getIsRecording() || isRecording) {\n    const port = window.location.port ? `:${window.location.port}` : '';\n    const url = `${HOST}__record?__xTestId=${test.id}&__xTestRequestNumber=${testMockNum}`;\n    await fetch(url, {\n      method: 'POST',\n      body: JSON.stringify(generate()),\n      mode: 'cors',\n      credentials: 'omit',\n      referrerPolicy: '',\n    });\n  }\n}\n"],"names":["TEST_IDS","WeakMap","HOST","setConfig","host","endsWith","setTestId","context","str","has","Error","set","id","request","mock","delete","IS_RECORDING","setIsRecording","value","Boolean","getIsRecording","MockServerHandler","constructor","owner","next","test","get","Object","assign","isRecording","url","firstChar","includes","queryForTest","mode","credentials","referrerPolicy","future","setStream","getStream","e","DOMException","message","replace","generate","testMockNum","fetch","method","body","JSON","stringify"],"mappings":"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"}

package/dist/mock.js.map

@@ -1 +1 @@
-{"version":3,"file":"mock.js","sources":["../client/mock.ts"],"sourcesContent":["import { getIsRecording, mock } from '.';\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\nexport type ScaffoldGenerator = () => Scaffold;\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}\nexport function POST() {}\nexport function PUT() {}\nexport function PATCH() {}\nexport function DELETE() {}\nexport function QUERY() {}\n"],"names":["GET","owner","url","response","options","mock","status","statusText","headers","body","method","getIsRecording","RECORD","POST","PUT","PATCH","DELETE","QUERY"],"mappings":";;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,GAAGA,CACjBC,KAAa,EACbC,GAAW,EACXC,QAA2B,EAC3BC,OAAuF,EACxE;AACf,EAAA,OAAOC,IAAI,CACTJ,KAAK,EACL,OAAO;AACLK,IAAAA,MAAM,EAAEF,OAAO,EAAEE,MAAM,IAAI,GAAG;AAC9BC,IAAAA,UAAU,EAAEH,OAAO,EAAEG,UAAU,IAAI,IAAI;AACvCC,IAAAA,OAAO,EAAEJ,OAAO,EAAEI,OAAO,IAAI,EAAE;AAC/BC,IAAAA,IAAI,EAAEL,OAAO,EAAEK,IAAI,IAAI,IAAI;AAC3BC,IAAAA,MAAM,EAAE,KAAK;IACbR,GAAG;IACHC,QAAQ,EAAEA,QAAQ,EAAC;AACrB,GAAC,CAAC,EACFQ,cAAc,EAAE,KAAKP,OAAO,EAAEQ,MAAM,IAAI,KAAK,CAC/C,CAAC,CAAA;AACH,CAAA;AACO,SAASC,IAAIA,GAAG,EAAC;AACjB,SAASC,GAAGA,GAAG,EAAC;AAChB,SAASC,KAAKA,GAAG,EAAC;AAClB,SAASC,MAAMA,GAAG,EAAC;AACnB,SAASC,KAAKA,GAAG;;;;"}
+{"version":3,"file":"mock.js","sources":["../src/mock.ts"],"sourcesContent":["import { getIsRecording, mock } from '.';\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\nexport type ScaffoldGenerator = () => Scaffold;\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}\nexport function POST() {}\nexport function PUT() {}\nexport function PATCH() {}\nexport function DELETE() {}\nexport function QUERY() {}\n"],"names":["GET","owner","url","response","options","mock","status","statusText","headers","body","method","getIsRecording","RECORD","POST","PUT","PATCH","DELETE","QUERY"],"mappings":";;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,GAAGA,CACjBC,KAAa,EACbC,GAAW,EACXC,QAA2B,EAC3BC,OAAuF,EACxE;AACf,EAAA,OAAOC,IAAI,CACTJ,KAAK,EACL,OAAO;AACLK,IAAAA,MAAM,EAAEF,OAAO,EAAEE,MAAM,IAAI,GAAG;AAC9BC,IAAAA,UAAU,EAAEH,OAAO,EAAEG,UAAU,IAAI,IAAI;AACvCC,IAAAA,OAAO,EAAEJ,OAAO,EAAEI,OAAO,IAAI,EAAE;AAC/BC,IAAAA,IAAI,EAAEL,OAAO,EAAEK,IAAI,IAAI,IAAI;AAC3BC,IAAAA,MAAM,EAAE,KAAK;IACbR,GAAG;IACHC,QAAQ,EAAEA,QAAQ,EAAC;AACrB,GAAC,CAAC,EACFQ,cAAc,EAAE,KAAKP,OAAO,EAAEQ,MAAM,IAAI,KAAK,CAC/C,CAAC,CAAA;AACH,CAAA;AACO,SAASC,IAAIA,GAAG,EAAC;AACjB,SAASC,GAAGA,GAAG,EAAC;AAChB,SAASC,KAAKA,GAAG,EAAC;AAClB,SAASC,MAAMA,GAAG,EAAC;AACnB,SAASC,KAAKA,GAAG;;;;"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@warp-drive/holodeck",
   "description": "⚡️ Simple, Fast HTTP Mocking for Tests",
-  "version": "0.0.0-alpha.12",
+  "version": "0.0.0-alpha.120",
   "license": "MIT",
   "author": "Chris Thoburn <runspired@users.noreply.github.com>",
   "repository": {
@@ -12,7 +12,7 @@
   "homepage": "https://github.com/emberjs/data",
   "bugs": "https://github.com/emberjs/data/issues",
   "engines": {
-    "node": ">= 18.19.1"
+    "node": ">= 18.20.4"
   },
   "keywords": [
     "http-mock"
@@ -21,12 +21,11 @@
     "extends": "../../package.json"
   },
   "dependencies": {
-    "@hono/node-server": "^1.3.3",
-    "chalk": "^4.1.2",
-    "hono": "^3.11.3",
-    "pm2": "^5.3.1",
-    "pnpm-sync-dependencies-meta-injected": "0.0.10"
+    "@hono/node-server": "^1.11.1",
+    "chalk": "^5.3.0",
+    "hono": "^4.6.5"
   },
+  "type": "module",
   "files": [
     "bin",
     "dist",
@@ -37,29 +36,25 @@
     "NCC-1701-a-blue.svg"
   ],
   "bin": {
-    "holodeck": "./bin/holodeck.js"
+    "ensure-cert": "./server/ensure-cert.js"
   },
   "peerDependencies": {
-    "@ember-data/request": "5.4.0-alpha.26"
+    "@ember-data/request": "5.4.0-alpha.134",
+    "@warp-drive/core-types": "5.4.0-alpha.134"
   },
   "devDependencies": {
-    "@babel/cli": "^7.23.9",
-    "@babel/core": "^7.23.9",
-    "@babel/plugin-transform-typescript": "^7.23.6",
-    "@babel/preset-env": "^7.23.9",
-    "@babel/preset-typescript": "^7.23.3",
-    "@babel/runtime": "^7.23.9",
-    "@ember-data/request": "5.4.0-alpha.26",
-    "@embroider/addon-dev": "^4.1.2",
-    "@rollup/plugin-babel": "^6.0.4",
-    "@rollup/plugin-node-resolve": "^15.2.3",
-    "@warp-drive/core-types": "0.0.0-alpha.12",
-    "@warp-drive/internal-config": "5.4.0-alpha.26",
-    "rollup": "^4.9.6",
-    "typescript": "^5.3.3",
-    "walk-sync": "^3.0.0"
+    "@babel/core": "^7.24.5",
+    "@babel/plugin-transform-typescript": "^7.24.5",
+    "@babel/preset-env": "^7.24.5",
+    "@babel/preset-typescript": "^7.24.1",
+    "@babel/runtime": "^7.24.5",
+    "@ember-data/request": "5.4.0-alpha.134",
+    "@warp-drive/core-types": "5.4.0-alpha.134",
+    "@warp-drive/internal-config": "5.4.0-alpha.134",
+    "pnpm-sync-dependencies-meta-injected": "0.0.14",
+    "typescript": "^5.7.2",
+    "vite": "^5.2.11"
   },
-  "type": "module",
   "exports": {
     ".": {
       "node": "./server/index.js",
@@ -86,10 +81,8 @@
     }
   },
   "scripts": {
-    "build:types": "echo \"Types are private\" && exit 0",
-    "build:client": "rollup --config",
-    "_build": "bun run build:client && bun run build:types",
-    "start": "rollup --config --watch",
-    "_syncPnpm": "bun run sync-dependencies-meta-injected"
+    "check:pkg-types": "tsc --noEmit",
+    "build:pkg": "vite build;",
+    "sync-hardlinks": "bun run sync-dependencies-meta-injected"
   }
 }

package/server/ensure-cert.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import { homedir, userInfo } from 'os';
+import path from 'path';
+
+function getShellConfigFilePath() {
+  const shell = userInfo().shell;
+  switch (shell) {
+    case '/bin/zsh':
+      return path.join(homedir(), '.zshrc');
+    case '/bin/bash':
+      return path.join(homedir(), '.bashrc');
+    default:
+      throw Error(
+        `Unable to determine configuration file for shell: ${shell}. Manual SSL Cert Setup Required for Holodeck.`
+      );
+  }
+}
+
+function main() {
+  let CERT_PATH = process.env.HOLODECK_SSL_CERT_PATH;
+  let KEY_PATH = process.env.HOLODECK_SSL_KEY_PATH;
+  const configFilePath = getShellConfigFilePath();
+
+  if (!CERT_PATH || !KEY_PATH) {
+    console.log(`Environment variables not found, updating the environment config file...\n`);
+
+    if (!CERT_PATH) {
+      CERT_PATH = path.join(homedir(), 'holodeck-localhost.pem');
+      process.env.HOLODECK_SSL_CERT_PATH = CERT_PATH;
+      execSync(`echo '\nexport HOLODECK_SSL_CERT_PATH="${CERT_PATH}"' >> ${configFilePath}`);
+      console.log(`Added HOLODECK_SSL_CERT_PATH to ${configFilePath}`);
+    }
+
+    if (!KEY_PATH) {
+      KEY_PATH = path.join(homedir(), 'holodeck-localhost-key.pem');
+      process.env.HOLODECK_SSL_KEY_PATH = KEY_PATH;
+      execSync(`echo '\nexport HOLODECK_SSL_KEY_PATH="${KEY_PATH}"' >> ${configFilePath}`);
+      console.log(`Added HOLODECK_SSL_KEY_PATH to ${configFilePath}`);
+    }
+
+    console.log(
+      `\n*** Please restart your terminal session to apply the changes or run \`source ${configFilePath}\`. ***\n`
+    );
+  }
+
+  if (!fs.existsSync(CERT_PATH) || !fs.existsSync(KEY_PATH)) {
+    console.log('SSL certificate or key not found, generating new ones...');
+
+    execSync(`mkcert -install`);
+    execSync(`mkcert -key-file ${KEY_PATH} -cert-file ${CERT_PATH} localhost`);
+
+    console.log('SSL certificate and key generated.');
+  } else {
+    console.log('SSL certificate and key found, using existing.');
+  }
+
+  console.log(`Certificate path: ${CERT_PATH}`);
+  console.log(`Key path: ${KEY_PATH}`);
+}
+
+main();

package/server/index.js

@@ -1,16 +1,55 @@
+/* global Bun */
 import { serve } from '@hono/node-server';
+import chalk from 'chalk';
 import { Hono } from 'hono';
 import { cors } from 'hono/cors';
+import { HTTPException } from 'hono/http-exception';
 import { logger } from 'hono/logger';
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import http2 from 'node:http2';
-import { dirname } from 'node:path';
 import zlib from 'node:zlib';
-import { fileURLToPath } from 'url';
-import { HTTPException } from 'hono/http-exception';
+import { homedir } from 'os';
+import path from 'path';
+
+/** @type {import('bun-types')} */
+const isBun = typeof Bun !== 'undefined';
+const DEBUG = process.env.DEBUG?.includes('holodeck') || process.env.DEBUG === '*';
+const CURRENT_FILE = new URL(import.meta.url).pathname;
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
+function getCertInfo() {
+  let CERT_PATH = process.env.HOLODECK_SSL_CERT_PATH;
+  let KEY_PATH = process.env.HOLODECK_SSL_KEY_PATH;
+
+  if (!CERT_PATH) {
+    CERT_PATH = path.join(homedir(), 'holodeck-localhost.pem');
+    process.env.HOLODECK_SSL_CERT_PATH = CERT_PATH;
+
+    console.log(
+      `HOLODECK_SSL_CERT_PATH was not found in the current environment. Setting it to default value of ${CERT_PATH}`
+    );
+  }
+
+  if (!KEY_PATH) {
+    KEY_PATH = path.join(homedir(), 'holodeck-localhost-key.pem');
+    process.env.HOLODECK_SSL_KEY_PATH = KEY_PATH;
+
+    console.log(
+      `HOLODECK_SSL_KEY_PATH was not found in the current environment. Setting it to default value of ${KEY_PATH}`
+    );
+  }
+
+  if (!fs.existsSync(CERT_PATH) || !fs.existsSync(KEY_PATH)) {
+    throw new Error('SSL certificate or key not found, you may need to run `pnpx @warp-drive/holodeck ensure-cert`');
+  }
+
+  return {
+    CERT_PATH,
+    KEY_PATH,
+    CERT: fs.readFileSync(CERT_PATH),
+    KEY: fs.readFileSync(KEY_PATH),
+  };
+}
 
 const DEFAULT_PORT = 1135;
 const BROTLI_OPTIONS = {
@@ -96,96 +135,116 @@ function replayRequest(context, cacheKey) {
 
 function createTestHandler(projectRoot) {
   const TestHandler = async (context) => {
-    const { req } = context;
+    try {
+      const { req } = context;
 
-    const testId = req.query('__xTestId');
-    const testRequestNumber = req.query('__xTestRequestNumber');
-    const niceUrl = getNiceUrl(req.url);
+      const testId = req.query('__xTestId');
+      const testRequestNumber = req.query('__xTestRequestNumber');
+      const niceUrl = getNiceUrl(req.url);
 
-    if (!testId) {
-      context.header('Content-Type', 'application/vnd.api+json');
-      context.status(400);
-      return context.body(
-        JSON.stringify({
-          errors: [
-            {
-              status: '400',
-              code: 'MISSING_X_TEST_ID_HEADER',
-              title: 'Request to the http mock server is missing the `X-Test-Id` header',
-              detail:
-                "The `X-Test-Id` header is used to identify the test that is making the request to the mock server. This is used to ensure that the mock server is only used for the test that is currently running. If using @ember-data/request add import { MockServerHandler } from '@warp-drive/holodeck'; to your request handlers.",
-              source: { header: 'X-Test-Id' },
-            },
-          ],
-        })
-      );
-    }
+      if (!testId) {
+        context.header('Content-Type', 'application/vnd.api+json');
+        context.status(400);
+        return context.body(
+          JSON.stringify({
+            errors: [
+              {
+                status: '400',
+                code: 'MISSING_X_TEST_ID_HEADER',
+                title: 'Request to the http mock server is missing the `X-Test-Id` header',
+                detail:
+                  "The `X-Test-Id` header is used to identify the test that is making the request to the mock server. This is used to ensure that the mock server is only used for the test that is currently running. If using @ember-data/request add import { MockServerHandler } from '@warp-drive/holodeck'; to your request handlers.",
+                source: { header: 'X-Test-Id' },
+              },
+            ],
+          })
+        );
+      }
+
+      if (!testRequestNumber) {
+        context.header('Content-Type', 'application/vnd.api+json');
+        context.status(400);
+        return context.body(
+          JSON.stringify({
+            errors: [
+              {
+                status: '400',
+                code: 'MISSING_X_TEST_REQUEST_NUMBER_HEADER',
+                title: 'Request to the http mock server is missing the `X-Test-Request-Number` header',
+                detail:
+                  "The `X-Test-Request-Number` header is used to identify the request number for the current test. This is used to ensure that the mock server response is deterministic for the test that is currently running. If using @ember-data/request add import { MockServerHandler } from '@warp-drive/holodeck'; to your request handlers.",
+                source: { header: 'X-Test-Request-Number' },
+              },
+            ],
+          })
+        );
+      }
+
+      if (req.method === 'POST' || niceUrl === '__record') {
+        const payload = await req.json();
+        const { url, headers, method, status, statusText, body, response } = payload;
+        const cacheKey = generateFilepath({
+          projectRoot,
+          testId,
+          url,
+          method,
+          body: body ? JSON.stringify(body) : null,
+          testRequestNumber,
+        });
+        // allow Content-Type to be overridden
+        headers['Content-Type'] = headers['Content-Type'] || 'application/vnd.api+json';
+        // We always compress and chunk the response
+        headers['Content-Encoding'] = 'br';
+        // we don't cache since tests will often reuse similar urls for different payload
+        headers['Cache-Control'] = 'no-store';
+
+        const cacheDir = generateFileDir({
+          projectRoot,
+          testId,
+          url,
+          method,
+          testRequestNumber,
+        });
 
-    if (!testRequestNumber) {
+        fs.mkdirSync(cacheDir, { recursive: true });
+        fs.writeFileSync(
+          `${cacheKey}.meta.json`,
+          JSON.stringify({ url, status, statusText, headers, method, requestBody: body }, null, 2)
+        );
+        fs.writeFileSync(`${cacheKey}.body.br`, compress(JSON.stringify(response)));
+        context.status(204);
+        return context.body(null);
+      } else {
+        const body = await req.text();
+        const cacheKey = generateFilepath({
+          projectRoot,
+          testId,
+          url: niceUrl,
+          method: req.method,
+          body,
+          testRequestNumber,
+        });
+        return replayRequest(context, cacheKey);
+      }
+    } catch (e) {
+      if (e instanceof HTTPException) {
+        throw e;
+      }
       context.header('Content-Type', 'application/vnd.api+json');
-      context.status(400);
+      context.status(500);
       return context.body(
         JSON.stringify({
           errors: [
             {
-              status: '400',
-              code: 'MISSING_X_TEST_REQUEST_NUMBER_HEADER',
-              title: 'Request to the http mock server is missing the `X-Test-Request-Number` header',
-              detail:
-                "The `X-Test-Request-Number` header is used to identify the request number for the current test. This is used to ensure that the mock server response is deterministic for the test that is currently running. If using @ember-data/request add import { MockServerHandler } from '@warp-drive/holodeck'; to your request handlers.",
-              source: { header: 'X-Test-Request-Number' },
+              status: '500',
+              code: 'MOCK_SERVER_ERROR',
+              title: 'Mock Server Error during Request',
+              detail: e.message,
             },
           ],
         })
       );
     }
-
-    if (req.method === 'POST' || niceUrl === '__record') {
-      const payload = await req.json();
-      const { url, headers, method, status, statusText, body, response } = payload;
-      const cacheKey = generateFilepath({
-        projectRoot,
-        testId,
-        url,
-        method,
-        body: body ? JSON.stringify(body) : null,
-        testRequestNumber,
-      });
-      // allow Content-Type to be overridden
-      headers['Content-Type'] = headers['Content-Type'] || 'application/vnd.api+json';
-      // We always compress and chunk the response
-      headers['Content-Encoding'] = 'br';
-      // we don't cache since tests will often reuse similar urls for different payload
-      headers['Cache-Control'] = 'no-store';
-
-      const cacheDir = generateFileDir({
-        projectRoot,
-        testId,
-        url,
-        method,
-        testRequestNumber,
-      });
-
-      fs.mkdirSync(cacheDir, { recursive: true });
-      fs.writeFileSync(
-        `${cacheKey}.meta.json`,
-        JSON.stringify({ url, status, statusText, headers, method, requestBody: body }, null, 2)
-      );
-      fs.writeFileSync(`${cacheKey}.body.br`, compress(JSON.stringify(response)));
-      context.status(204);
-      return context.body(null);
-    } else {
-      const body = await req.text();
-      const cacheKey = generateFilepath({
-        projectRoot,
-        testId,
-        url: niceUrl,
-        method: req.method,
-        body,
-        testRequestNumber,
-      });
-      return replayRequest(context, cacheKey);
-    }
   };
 
   return TestHandler;
@@ -196,7 +255,9 @@ function createTestHandler(projectRoot) {
 */
 export function createServer(options) {
   const app = new Hono();
-  app.use('*', logger());
+  if (DEBUG) {
+    app.use('*', logger());
+  }
   app.use(
     '*',
     cors({
@@ -211,18 +272,112 @@ export function createServer(options) {
   );
   app.all('*', createTestHandler(options.projectRoot));
 
+  const { CERT, KEY } = getCertInfo();
+
   serve({
     fetch: app.fetch,
     createServer: (_, requestListener) => {
-      return http2.createSecureServer(
-        {
-          key: fs.readFileSync(`${__dirname}/localhost-key.pem`),
-          cert: fs.readFileSync(`${__dirname}/localhost.pem`),
-        },
-        requestListener
-      );
+      try {
+        return http2.createSecureServer(
+          {
+            key: KEY,
+            cert: CERT,
+          },
+          requestListener
+        );
+      } catch (e) {
+        console.log(chalk.yellow(`Failed to create secure server, falling back to http server. Error: ${e.message}`));
+        return http2.createServer(requestListener);
+      }
     },
     port: options.port ?? DEFAULT_PORT,
     hostname: 'localhost',
+    // bun uses TLS options
+    // tls: {
+    //   key: Bun.file(KEY_PATH),
+    //   cert: Bun.file(CERT_PATH),
+    // },
   });
+
+  console.log(
+    `\tMock server running at ${chalk.magenta('https://localhost:') + chalk.yellow(options.port ?? DEFAULT_PORT)}`
+  );
+}
+
+const servers = new Map();
+
+export default {
+  async launchProgram(config = {}) {
+    const projectRoot = process.cwd();
+    const name = await import(path.join(projectRoot, 'package.json'), { with: { type: 'json' } }).then(
+      (pkg) => pkg.name
+    );
+    const options = { name, projectRoot, ...config };
+    console.log(
+      chalk.grey(
+        `\n\t@${chalk.greenBright('warp-drive')}/${chalk.magentaBright(
+          'holodeck'
+        )} 🌅\n\t=================================\n`
+      ) +
+        chalk.grey(
+          `\n\tHolodeck Access Granted\n\t\tprogram: ${chalk.magenta(name)}\n\t\tsettings: ${chalk.green(JSON.stringify(config).split('\n').join(' '))}\n\t\tdirectory: ${chalk.cyan(projectRoot)}\n\t\tengine: ${chalk.cyan(
+            isBun ? 'bun@' + Bun.version : 'node'
+          )}`
+        )
+    );
+    console.log(chalk.grey(`\n\tStarting Subroutines (mode:${chalk.cyan(isBun ? 'bun' : 'node')})`));
+
+    if (isBun) {
+      const serverProcess = Bun.spawn(
+        ['node', '--experimental-default-type=module', CURRENT_FILE, JSON.stringify(options)],
+        {
+          env: process.env,
+          cwd: process.cwd(),
+          stdout: 'inherit',
+          stderr: 'inherit',
+        }
+      );
+      servers.set(projectRoot, serverProcess);
+      return;
+    }
+
+    if (servers.has(projectRoot)) {
+      throw new Error(`Holodeck is already running for project '${name}' at '${projectRoot}'`);
+    }
+
+    servers.set(projectRoot, createServer(options));
+  },
+  async endProgram() {
+    console.log(chalk.grey(`\n\tEnding Subroutines (mode:${chalk.cyan(isBun ? 'bun' : 'node')})`));
+    const projectRoot = process.cwd();
+
+    if (!servers.has(projectRoot)) {
+      const name = await import(path.join(projectRoot, 'package.json'), { with: { type: 'json' } }).then(
+        (pkg) => pkg.name
+      );
+      throw new Error(`Holodeck was not running for project '${name}' at '${projectRoot}'`);
+    }
+
+    if (isBun) {
+      const serverProcess = servers.get(projectRoot);
+      serverProcess.kill();
+      return;
+    }
+
+    servers.get(projectRoot).close();
+    servers.delete(projectRoot);
+  },
+};
+
+function main() {
+  const args = process.argv.slice();
+  if (!isBun && args.length) {
+    if (args[1] !== CURRENT_FILE) {
+      return;
+    }
+    const options = JSON.parse(args[2]);
+    createServer(options);
+  }
 }
+
+main();

package/bin/cmd/_start.js

@@ -1,3 +0,0 @@
-import pm2 from './pm2.js';
-
-await pm2('start', process.argv.slice(2));

package/bin/cmd/_stop.js

@@ -1,3 +0,0 @@
-import pm2 from './pm2.js';
-
-await pm2('stop', process.argv.slice(2));

package/bin/cmd/pm2.js

@@ -1,38 +0,0 @@
-/* eslint-disable no-console */
-/* global Bun, globalThis */
-const { process } = globalThis;
-import pm2 from 'pm2';
-import fs from 'fs';
-
-export default async function pm2Delegate(cmd, _args) {
-  const pkg = JSON.parse(fs.readFileSync('./package.json'), 'utf8');
-
-  return new Promise((resolve, reject) => {
-    pm2.connect((err) => {
-      if (err) {
-        console.log('not able to connect to pm2');
-        console.error(err);
-        process.exit(2);
-      }
-
-      const options = {
-        script: './holodeck.mjs',
-        name: pkg.name + '::holodeck',
-        cwd: process.cwd(),
-        args: cmd === 'start' ? '-f' : '',
-      };
-
-      pm2[cmd](cmd === 'start' ? options : options.name, (err, apps) => {
-        pm2.disconnect(); // Disconnects from PM2
-        if (err) {
-          console.log(`not able to ${cmd} pm2 for ${options.name}`);
-          console.error(err);
-          reject(err);
-        } else {
-          console.log(`pm2 ${cmd} successful for ${options.name}`);
-          resolve();
-        }
-      });
-    });
-  });
-}

package/bin/cmd/run.js

@@ -1,50 +0,0 @@
-/* eslint-disable no-console */
-/* global Bun, globalThis */
-const isBun = typeof Bun !== 'undefined';
-const { process } = globalThis;
-import { spawn } from './spawn.js';
-import fs from 'fs';
-
-export default async function run(args) {
-  const pkg = JSON.parse(fs.readFileSync('./package.json'), 'utf8');
-  const cmd = args[0];
-  const isPkgScript = pkg.scripts[cmd];
-
-  if (isBun) {
-    await spawn(['bun', 'run', 'holodeck:start-program']);
-
-    let exitCode = 0;
-    try {
-      await spawn(['bun', 'run', ...args]);
-    } catch (e) {
-      exitCode = e;
-    }
-    await spawn(['bun', 'run', 'holodeck:end-program']);
-    if (exitCode !== 0) {
-      process.exit(exitCode);
-    }
-    return;
-  } else {
-    await spawn(['pnpm', 'run', 'holodeck:start-program']);
-
-    let exitCode = 0;
-    try {
-      if (isPkgScript) {
-        const cmdArgs = pkg.scripts[cmd].split(' ');
-        if (args.length > 1) {
-          cmdArgs.push(...args.slice(1));
-        }
-        console.log({ cmdArgs });
-        await spawn(cmdArgs);
-      } else {
-        await spawn(['pnpm', 'exec', ...args]);
-      }
-    } catch (e) {
-      exitCode = e;
-    }
-    await spawn(['pnpm', 'run', 'holodeck:end-program']);
-    if (exitCode !== 0) {
-      process.exit(exitCode);
-    }
-  }
-}

package/bin/cmd/spawn.js

@@ -1,40 +0,0 @@
-/* eslint-disable no-console */
-/* global Bun, globalThis */
-const isBun = typeof Bun !== 'undefined';
-
-export async function spawn(args, options) {
-  if (isBun) {
-    const proc = Bun.spawn(args, {
-      env: process.env,
-      cwd: process.cwd(),
-      stdout: 'inherit',
-      stderr: 'inherit',
-    });
-    await proc.exited;
-    if (proc.exitCode !== 0) {
-      throw proc.exitCode;
-    }
-    return;
-  }
-
-  const { spawn } = await import('node:child_process');
-
-  // eslint-disable-next-line no-inner-declarations
-  function pSpawn(cmd, args, opts) {
-    return new Promise((resolve, reject) => {
-      const proc = spawn(cmd, args, opts);
-      proc.on('exit', (code) => {
-        if (code === 0) {
-          resolve();
-        } else {
-          reject(code);
-        }
-      });
-    });
-  }
-
-  await pSpawn(args.shift(), args, {
-    stdio: 'inherit',
-    shell: true,
-  });
-}

package/bin/holodeck.js

@@ -1,63 +0,0 @@
-#!/bin/sh -
-':'; /*-
-test1=$(bun --version 2>&1) && exec bun "$0" "$@"
-test2=$(node --version 2>&1) && exec node "$0" "$@"
-exec printf '%s\n' "$test1" "$test2" 1>&2
-*/
-/* eslint-disable no-console */
-/* global Bun, globalThis */
-
-import chalk from 'chalk';
-import { spawn } from './cmd/spawn.js';
-
-const isBun = typeof Bun !== 'undefined';
-const { process } = globalThis;
-
-const args = isBun ? Bun.argv.slice(2) : process.argv.slice(2);
-const command = args.shift();
-
-const BUN_SUPPORTS_PM2 = false;
-const BUN_SUPPORTS_HTTP2 = false;
-
-if (command === 'run') {
-  console.log(
-    chalk.grey(
-      `\n\t@${chalk.greenBright('warp-drive')}/${chalk.magentaBright(
-        'holodeck'
-      )} 🌅\n\t=================================}\n`
-    ) +
-      chalk.grey(
-        `\n\tHolodeck Access Granted\n\t\tprogram: ${chalk.green(args.join(' '))}\n\t\tengine: ${chalk.cyan(
-          isBun ? 'bun@' + Bun.version : 'node'
-        )}`
-      )
-  );
-  const run = await import('./cmd/run.js');
-  await run.default(args);
-} else if (command === 'start') {
-  console.log(chalk.grey(`\n\tStarting Subroutines (mode:${chalk.cyan(isBun ? 'bun' : 'node')})`));
-
-  if (!isBun || (BUN_SUPPORTS_HTTP2 && BUN_SUPPORTS_PM2)) {
-    const pm2 = await import('./cmd/pm2.js');
-    await pm2.default('start', args);
-  } else {
-    console.log(`Downgrading to node to run pm2 due lack of http/2 or pm2 support in Bun`);
-    const __dirname = import.meta.dir;
-    const programPath = __dirname + '/cmd/_start.js';
-    await spawn(['node', programPath, ...args]);
-  }
-} else if (command === 'end') {
-  console.log(chalk.grey(`\n\tEnding Subroutines (mode:${chalk.cyan(isBun ? 'bun' : 'node')})`));
-
-  if (!isBun || (BUN_SUPPORTS_HTTP2 && BUN_SUPPORTS_PM2)) {
-    const pm2 = await import('./cmd/pm2.js');
-    await pm2.default('stop', args);
-  } else {
-    console.log(`Downgrading to node to run pm2 due lack of http/2 or pm2 support in Bun`);
-    const __dirname = import.meta.dir;
-    const programPath = __dirname + '/cmd/_stop.js';
-    await spawn(['node', programPath, ...args]);
-  }
-
-  console.log(`\n\t${chalk.grey('The Computer has ended the program')}\n`);
-}

package/dist/index.d.ts

@@ -1,12 +0,0 @@
-import type { Handler, NextFn, RequestContext, StructuredDataDocument } from '@ember-data/request';
-import type { ScaffoldGenerator } from './mock';
-export declare function setTestId(context: object, str: string | null): void;
-export declare function setIsRecording(value: boolean): void;
-export declare function getIsRecording(): boolean;
-export declare class MockServerHandler implements Handler {
-    owner: object;
-    constructor(owner: object);
-    request<T>(context: RequestContext, next: NextFn<T>): Promise<StructuredDataDocument<T>>;
-}
-export declare function mock(owner: object, generate: ScaffoldGenerator, isRecording?: boolean): Promise<void>;
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAe,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAIhD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,QAS5D;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,QAE5C;AACD,wBAAgB,cAAc,YAE7B;AAED,qBAAa,iBAAkB,YAAW,OAAO;IACvC,KAAK,EAAE,MAAM,CAAC;gBACV,KAAK,EAAE,MAAM;IAGnB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;CA6B/F;AAED,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,OAAO,iBAgB3F"}

package/dist/mock.d.ts

@@ -1,37 +0,0 @@
-export interface Scaffold {
-    status: number;
-    statusText?: string;
-    headers: Record<string, string>;
-    body: Record<string, string> | string | null;
-    method: string;
-    url: string;
-    response: Record<string, unknown>;
-}
-export type ScaffoldGenerator = () => Scaffold;
-export type ResponseGenerator = () => Record<string, unknown>;
-/**
- * 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
- */
-export declare function GET(owner: object, url: string, response: ResponseGenerator, options?: Partial<Omit<Scaffold, 'response' | 'url' | 'method'>> & {
-    RECORD?: boolean;
-}): Promise<void>;
-export declare function POST(): void;
-export declare function PUT(): void;
-export declare function PATCH(): void;
-export declare function DELETE(): void;
-export declare function QUERY(): void;
-//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../client/mock.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CAAC;AAC/C,MAAM,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,GAAG,CACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACtF,OAAO,CAAC,IAAI,CAAC,CAcf;AACD,wBAAgB,IAAI,SAAK;AACzB,wBAAgB,GAAG,SAAK;AACxB,wBAAgB,KAAK,SAAK;AAC1B,wBAAgB,MAAM,SAAK;AAC3B,wBAAgB,KAAK,SAAK"}

package/server/CERT.md

@@ -1,3 +0,0 @@
-Generated with `mkcert`
-
-It will expire on 9 January 2026 🗓

package/server/localhost-key.pem

@@ -1,28 +0,0 @@
------BEGIN PRIVATE KEY-----
-MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCz8yulPBPYYZH+
-M+kBVOCSj4EmN7Texxd/DXjOJTTpDI8aophZhfaXZSnTFhLxTEuAUVboU7yGR/JJ
-JzL1nTVujR/gjJFrc4PVDeLzWMTJsTQcagdtku9suKC6M74/GlTI4yQC5p+IKRuv
-ZisQhacyjpj5s4RoBR2n2aOscIncYtuKTJ570CIt9SFxEaV/WW3PlAG5LGEuqqJR
-MwFTXz10IaKOVc/sxV2sYVS1tARydAx27IHKf23FilAu30nnc0ipGZNqFvHNvNed
-Ggye+aaCh0WtX99HXs+JKPTfvV4sCDb7KIZq3WjRk7PAaSr6e999kvHuhZpXDUJL
-Ynu0FYBZAgMBAAECggEBAJXcluWWAeT7ZO0x6AOe3yPPdTwRuoSpg4zg+FGdtNG9
-DtScwooTwchVjJ5pzL69zkb/9oOncOLXuhRoG81m7l+yEfEcv+KfohPl67LDo6dg
-90gOmT8M1m5R2DEZ9H9y+1cNqyjrTcLEkXTifkzVMegtz4JsmYFTeV4XJ3LtijJJ
-j0b8X4d22DiNtQrx2zrcUF64UJSAxdRHW3nYlnjVxiXjUCO6TcrZvA+rqYNhX+QJ
-lX9EwyVOdBtGsNMMECviFgrr4DPxkh77WptO6suIZ1X//UOAYEQp7rOsAf6sXRkp
-seVp/TvhbjDk/XuRiv8zLaf0W4pFwt90XsCmkEzsH10CgYEA6beK8o2r5CA+mTJO
-fb4MyqKhv6v5RXfG69IXf01gvARcXwjOMD5cV38UsI7YEw9RCXGRXzeH3MvW28aD
-ADJYd+516vb0VwZwFYrUVKuBcjvvShPCk9HtOCqCEbRPBPJE7/mODHmL8u+61Rq/
-l1n6GmYGLmJy2HaVDDnWi9jb0I8CgYEAxRtOKrkkdt36iUYlQ7wkWtDcN1gYVpuB
-e2G/6BmDwIBTX/WoVlJrL9S3hFTjFc+0UJBpmmfFGFtp0tZFtjY7SaTj2whK4ZU7
-VI90CUgExdsjf7yw+OeCgqdkiuRoFn39tL0h/pM4UcAKz9UB9yxvrfQRCXD3O6w2
-TzbEv3VAxJcCgYBlnHvXeoqqEu7EUh/YAWG0U8K4/37PmgStEFlQ6oZNGCRE2SIz
-zVj+XWzUWjZNCxKzZWHLoOv7rc/LG2JnGnxmIBG6RwXyNAVVCFfKPAp6bN5bOX4W
-IGXfTnPgWKEmSGJ6ZuhAOjQDOgDjl86GcgMPqR202u6Nd/jTKO5DPNRMtwKBgHNu
-JjzG6B/kp5A00CX2zKOSpSSUJsyxjQagnC5kos/dVvZfexHyemsse7y3qbVgSgzU
-RcPy+W3mOvcKHRE0eUwLkJT5KkEpj/FZgW7eCk2EpClua4WYrsmtFihw0rQ5XJa4
-HGxl8xmNCcfkyp3iHBUXVdLdoSwFElkZjedB14hJAoGAeeX+Rg4Y5a9/GNgxgsBU
-o9MM/6qmjAJAb4iln9jHaEYZBd7EyogYuzqiKlASutIovGHj+P0RH3kvVlmVt1g/
-45zmwVVrobCi5dqGQ1oPYvZpGCi85aYciTlfuH0mJqouXEkcO8kZQbc8ylR7WZS/
-U9Mf1mB0yw8kupDasZ+uJ5c=
------END PRIVATE KEY-----

package/server/localhost.pem

@@ -1,27 +0,0 @@
------BEGIN CERTIFICATE-----
-MIIEfzCCAuegAwIBAgIQWxpBRFaerCiZ6Gh6L9VAqjANBgkqhkiG9w0BAQsFADCB
-qzEeMBwGA1UEChMVbWtjZXJ0IGRldmVsb3BtZW50IENBMUAwPgYDVQQLDDdjdGhv
-YnVybkBDaHJpcy1UaG9idXJuLUs1MFEzMEQ3NjEubG9jYWwgKENocmlzIFRob2J1
-cm4pMUcwRQYDVQQDDD5ta2NlcnQgY3Rob2J1cm5AQ2hyaXMtVGhvYnVybi1LNTBR
-MzBENzYxLmxvY2FsIChDaHJpcyBUaG9idXJuKTAeFw0yMzEwMDkwOTE1MDZaFw0y
-NjAxMDkxMDE1MDZaMGsxJzAlBgNVBAoTHm1rY2VydCBkZXZlbG9wbWVudCBjZXJ0
-aWZpY2F0ZTFAMD4GA1UECww3Y3Rob2J1cm5AQ2hyaXMtVGhvYnVybi1LNTBRMzBE
-NzYxLmxvY2FsIChDaHJpcyBUaG9idXJuKTCCASIwDQYJKoZIhvcNAQEBBQADggEP
-ADCCAQoCggEBALPzK6U8E9hhkf4z6QFU4JKPgSY3tN7HF38NeM4lNOkMjxqimFmF
-9pdlKdMWEvFMS4BRVuhTvIZH8kknMvWdNW6NH+CMkWtzg9UN4vNYxMmxNBxqB22S
-72y4oLozvj8aVMjjJALmn4gpG69mKxCFpzKOmPmzhGgFHafZo6xwidxi24pMnnvQ
-Ii31IXERpX9Zbc+UAbksYS6qolEzAVNfPXQhoo5Vz+zFXaxhVLW0BHJ0DHbsgcp/
-bcWKUC7fSedzSKkZk2oW8c28150aDJ75poKHRa1f30dez4ko9N+9XiwINvsohmrd
-aNGTs8BpKvp7332S8e6FmlcNQktie7QVgFkCAwEAAaNeMFwwDgYDVR0PAQH/BAQD
-AgWgMBMGA1UdJQQMMAoGCCsGAQUFBwMBMB8GA1UdIwQYMBaAFPvg1+9/Kqq1KAXH
-lhQsaJhmqOd1MBQGA1UdEQQNMAuCCWxvY2FsaG9zdDANBgkqhkiG9w0BAQsFAAOC
-AYEAx2seTuq9JRa2sdio17IJO+9ns35zl8TymSIV9U6YGgiW3m/bsfmZic6Kzn9R
-+lj6rBAGIefrQEmfF3RGL3n7FOW0gwSXSeKmG1r7TBXYrkKF9i41C/VRUZ8iKZfl
-ja5P9BFXWUeMQDLv6p3X/ynZMsw1HOIy2r5OJoxLjfN4NvnAnQxbMtVSsCHMesj1
-U44mT09CeGTLTsbqFNZ7TX/Gm1I4ic7z8PGFpWDgliNARNH5Yf6Quh/ryY+jXc4F
-yoC3JwhmRfi4vNCP6wmUzpLmS+psJkCjU1SnUmzjX219F22Y5vFUJrWhQq+qs/yx
-t9PPlf+dt2MfoPsNIE096E9z8yBWcyggCQvyH0kv+a7HKOOHORtd8SuCNGtTEl4Q
-Q8eheMGoIa4dsiMyJeWUOtxdInPkZNBxjQLkC2wCqSuN5+3iTuFfniRSoamqSVYo
-/TtgXWM5tTUOHHisy+u9HR6fZpSlvplYIjVcmK5bObIlRx7MCOFiyXjJf7Xjv1ji
-6JQn
------END CERTIFICATE-----