@crvouga/mockingbird-adapter-bun 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @crvouga/mockingbird-adapter-bun
+
+Serve any Mockingbird `FetchAPI` (a provider mock such as `StripeAPI`, or your own) as a real HTTP
+server with `Bun.serve`. Use it on Bun when the code under test needs a URL rather than an injected
+`fetch`. On Node, use `@crvouga/mockingbird-adapter-node` instead.
+
+## Install
+
+```bash
+npm install @crvouga/mockingbird-adapter-bun
+```
+
+Bun >=1.2 only: the runtime code calls the global `Bun.serve`. ESM only.
+
+The shipped `.d.ts` references `Bun` types, so TypeScript projects also need `@types/bun` (declared
+as an optional peer dependency) and `"types": ["bun"]` if your tsconfig restricts `types`:
+
+```bash
+npm install -D @types/bun
+```
+
+## Usage
+
+```ts
+import { serve } from "@crvouga/mockingbird-adapter-bun"
+import type { FetchAPI } from "@crvouga/mockingbird-core"
+
+// Any FetchAPI works, e.g. `new StripeAPI()` from @crvouga/mockingbird-service-stripe.
+const api: FetchAPI = {
+  fetch: async (request) => Response.json({ method: request.method, url: request.url }),
+}
+
+// Port defaults to 0: the OS picks a free port. `serve` is synchronous.
+const server = serve(api, { hostname: "127.0.0.1" })
+const baseUrl = `http://127.0.0.1:${server.port}`
+
+const response = await fetch(`${baseUrl}/v1/customers`)
+console.log(await response.json())
+
+server.stop() // e.g. in afterAll
+```
+
+## API
+
+| Export | Signature | Description |
+| --- | --- | --- |
+| `serve` | `(api: FetchAPI, options?: BunServeOptions) => BunAdapterServer` | Start `Bun.serve` with `fetch: (request) => api.fetch(request)`. |
+
+Types:
+
+- `BunServeOptions`: `{ port?: number; hostname?: string }`. `port` defaults to `0` (ephemeral; read
+  it from `server.port`); `hostname` is only passed when set.
+- `BunAdapterServer`: `ReturnType<typeof Bun.serve>`, the Bun `Server` (`port`, `url`, `stop()`).
+
+Requests and responses pass through unchanged (Bun is Fetch-native), so streaming bodies work.
+
+## Related
+
+- `@crvouga/mockingbird-core`: the `FetchAPI` contract.
+- `@crvouga/mockingbird-adapter-node`: the same adapter for `node:http`.
+
+Part of [mockingbird](https://github.com/crvouga/mockingbird) — agent integration guide: [`@crvouga/mockingbird`](https://github.com/crvouga/mockingbird/tree/main/packages/facade#readme).

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { FetchAPI } from "@crvouga/mockingbird-core";
+/** Options for {@link serve}. */
+export type BunServeOptions = {
+    port?: number;
+    hostname?: string;
+};
+export type BunAdapterServer = ReturnType<typeof Bun.serve>;
+/**
+ * Serve any Mockingbird {@link FetchAPI} over `Bun.serve`.
+ * Port defaults to `0`, so the OS assigns an ephemeral port (read from `server.port`).
+ */
+export declare const serve: (api: FetchAPI, options?: BunServeOptions) => BunAdapterServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAEzD,iCAAiC;AACjC,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAA;AAE3D;;;GAGG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,QAAQ,EAAE,UAAS,eAAoB,KAAG,gBAMpE,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Serve any Mockingbird {@link FetchAPI} over `Bun.serve`.
+ * Port defaults to `0`, so the OS assigns an ephemeral port (read from `server.port`).
+ */
+export const serve = (api, options = {}) => {
+    return Bun.serve({
+        port: options.port ?? 0,
+        ...(options.hostname !== undefined ? { hostname: options.hostname } : {}),
+        fetch: (request) => api.fetch(request),
+    });
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAa,EAAE,UAA2B,EAAE,EAAoB,EAAE;IACtF,OAAO,GAAG,CAAC,KAAK,CAAC;QACf,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;KACvC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@crvouga/mockingbird-adapter-bun",
+  "version": "0.1.0",
+  "description": "Serve any Mockingbird FetchAPI with Bun.serve.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/crvouga/mockingbird.git",
+    "directory": "packages/adapters/bun"
+  },
+  "homepage": "https://github.com/crvouga/mockingbird/tree/main/packages/adapters/bun#readme",
+  "keywords": [
+    "mockingbird",
+    "adapter",
+    "bun"
+  ],
+  "mockingbird": {
+    "runtime": "bun",
+    "layer": "adapter"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "biome check .",
+    "test": "bun test",
+    "portability": "bun ../../../scripts/portability.ts",
+    "pack:check": "bun ../../../scripts/pack-check.ts"
+  },
+  "dependencies": {
+    "@crvouga/mockingbird-core": "0.0.0-development"
+  },
+  "devDependencies": {
+    "fast-check": "4.9.0",
+    "@crvouga/mockingbird-testing": "0.1.0"
+  },
+  "peerDependencies": {
+    "@types/bun": ">=1.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/bun": {
+      "optional": true
+    }
+  }
+}