@pikku/bun-server 0.12.1

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# @pikku/bun-server
+
+## 0.12.1
+
+### Patch Changes
+
+- d5c3c85: feat: bun first-class support — new `@pikku/bun-server` runtime and `@pikku/kysely-bun-sqlite` dialect, bun template, CI matrix with `package-manager: [yarn, bun]`, and bun verifier.
+- e443e94: feat(deploy): standalone provider can target the bun runtime
+
+  `pikku deploy plan|apply --provider standalone --runtime bun` now generates a
+  `@pikku/bun-server` entry (native `Bun.serve` WebSockets, no `ws` package) and
+  compiles the bundle into a single self-contained executable via
+  `bun build --compile` — no runtime needed on the target host. The default
+  remains `--runtime node`, which is unchanged (ships `bundle.js`, run with
+  `node bundle.js`).
+
+  `PikkuBunServer` now accepts an injectable `eventHub` in its options. Inject the
+  same `BunEventHubService` you pass to `createSingletonServices` so functions and
+  the WebSocket transport share one hub — otherwise a function's
+  `eventHub.publish(...)` targets a different hub than the one holding the live
+  sockets and broadcasts never reach connected clients. The standalone bun entry
+  and the `bun` template now wire this shared hub, fixing cross-connection /
+  cross-transport channel pub-sub on bun.
+
+  Also removes the unused `@yao-pkg/pkg` dependency and its stale type shim from
+  `@pikku/deploy-standalone` (the pkg-based binary path was dropped in #489).
+
+- Updated dependencies [92cd5b1]
+  - @pikku/core@0.12.38

package/dist/bun-event-hub-service.d.ts

@@ -0,0 +1,14 @@
+import type { ServerWebSocket, Server } from 'bun';
+type AnyServer = Server<unknown>;
+import type { EventHubService } from '@pikku/core/channel';
+export declare class BunEventHubService<Mappings extends Record<string, unknown> = {}> implements EventHubService<Mappings> {
+    private sockets;
+    private server;
+    setServer(server: AnyServer): void;
+    subscribe<T extends keyof Mappings>(topic: T, channelId: string): Promise<void>;
+    unsubscribe<T extends keyof Mappings>(topic: T, channelId: string): Promise<void>;
+    publish<T extends keyof Mappings>(topic: T, channelId: string | null, message: Mappings[T], isBinary?: boolean): Promise<void>;
+    onChannelOpened(channelId: string, ws: ServerWebSocket<unknown>): Promise<void>;
+    onChannelClosed(channelId: string): Promise<void>;
+}
+export {};

package/dist/bun-event-hub-service.js

@@ -0,0 +1,30 @@
+export class BunEventHubService {
+    sockets = new Map();
+    server = null;
+    setServer(server) {
+        this.server = server;
+    }
+    async subscribe(topic, channelId) {
+        this.sockets.get(channelId)?.subscribe(topic);
+    }
+    async unsubscribe(topic, channelId) {
+        this.sockets.get(channelId)?.unsubscribe(topic);
+    }
+    async publish(topic, channelId, message, isBinary) {
+        if (!this.server)
+            return;
+        if (isBinary) {
+            this.server.publish(topic, message, true);
+        }
+        else {
+            this.server.publish(topic, JSON.stringify(message), false);
+        }
+    }
+    async onChannelOpened(channelId, ws) {
+        this.sockets.set(channelId, ws);
+    }
+    async onChannelClosed(channelId) {
+        this.sockets.delete(channelId);
+    }
+}
+//# sourceMappingURL=bun-event-hub-service.js.map

package/dist/bun-event-hub-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-event-hub-service.js","sourceRoot":"","sources":["../src/bun-event-hub-service.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,kBAAkB;IAGrB,OAAO,GAA0C,IAAI,GAAG,EAAE,CAAA;IAC1D,MAAM,GAAqB,IAAI,CAAA;IAEhC,SAAS,CAAC,MAAiB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,SAAS,CACpB,KAAQ,EACR,SAAiB;QAEjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,KAAe,CAAC,CAAA;IACzD,CAAC;IAEM,KAAK,CAAC,WAAW,CACtB,KAAQ,EACR,SAAiB;QAEjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,KAAe,CAAC,CAAA;IAC3D,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,KAAQ,EACR,SAAwB,EACxB,OAAoB,EACpB,QAAkB;QAElB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QACxB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAe,EAAE,OAAc,EAAE,IAAI,CAAC,CAAA;QAC5D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAe,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAA;QACtE,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,eAAe,CAC1B,SAAiB,EACjB,EAA4B;QAE5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACjC,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,SAAiB;QAC5C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { PikkuBunServer } from './pikku-bun-server.js';
+export { BunEventHubService } from './bun-event-hub-service.js';
+export type { BunServerConfig, PikkuBunServerOptions, } from './pikku-bun-server.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { PikkuBunServer } from './pikku-bun-server.js';
+export { BunEventHubService } from './bun-event-hub-service.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/pikku-bun-server.d.ts

@@ -0,0 +1,24 @@
+import type { CoreConfig } from '@pikku/core';
+import type { Logger } from '@pikku/core/services';
+import { type RunHTTPWiringOptions } from '@pikku/core/http';
+import { BunEventHubService } from './bun-event-hub-service.js';
+export type BunServerConfig = CoreConfig & {
+    port: number;
+    hostname?: string;
+    healthCheckPath?: string;
+};
+export type PikkuBunServerOptions = RunHTTPWiringOptions & {
+    eventHub?: BunEventHubService;
+};
+export declare class PikkuBunServer {
+    private readonly config;
+    private readonly logger;
+    private server;
+    private readonly eventHub;
+    private readonly options;
+    constructor(config: BunServerConfig, logger: Logger, options?: PikkuBunServerOptions);
+    init(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    enableExitOnSignals(): void;
+}

package/dist/pikku-bun-server.js

@@ -0,0 +1,132 @@
+import { stopSingletonServices } from '@pikku/core';
+import { fetchData, PikkuFetchHTTPRequest, PikkuFetchHTTPResponse, logRoutes as logRegisterRoutes, } from '@pikku/core/http';
+import { logChannels } from '@pikku/core/channel';
+import { runLocalChannel } from '@pikku/core/channel/local';
+import { compileAllSchemas } from '@pikku/core/schema';
+import { BunEventHubService } from './bun-event-hub-service.js';
+const isSerializable = (data) => !(typeof data === 'string' ||
+    data instanceof ArrayBuffer ||
+    data instanceof Uint8Array ||
+    data instanceof Int8Array ||
+    data instanceof Uint16Array ||
+    data instanceof Int16Array ||
+    data instanceof Uint32Array ||
+    data instanceof Int32Array ||
+    data instanceof Float32Array ||
+    data instanceof Float64Array);
+export class PikkuBunServer {
+    config;
+    logger;
+    server = null;
+    eventHub;
+    options;
+    constructor(config, logger, options = {}) {
+        this.config = config;
+        this.logger = logger;
+        const { eventHub, ...httpOptions } = options;
+        this.eventHub = eventHub ?? new BunEventHubService();
+        this.options = httpOptions;
+    }
+    async init() {
+        compileAllSchemas(this.logger);
+        logRegisterRoutes(this.logger);
+        logChannels(this.logger);
+    }
+    async start() {
+        const { config, logger, options, eventHub } = this;
+        this.server = Bun.serve({
+            port: config.port,
+            hostname: config.hostname,
+            fetch: async (req, server) => {
+                if (req.headers.get('upgrade')?.toLowerCase() === 'websocket') {
+                    const pikkuReq = new PikkuFetchHTTPRequest(req);
+                    const pikkuRes = new PikkuFetchHTTPResponse();
+                    const channelHandler = await runLocalChannel({
+                        channelId: crypto.randomUUID(),
+                        request: pikkuReq,
+                        response: pikkuRes,
+                        route: new URL(req.url).pathname,
+                    });
+                    if (!channelHandler) {
+                        return new Response('Forbidden', { status: 403 });
+                    }
+                    const upgraded = server.upgrade(req, { data: { channelHandler } });
+                    if (upgraded)
+                        return undefined;
+                    return new Response('WebSocket upgrade failed', { status: 500 });
+                }
+                if (config.healthCheckPath &&
+                    new URL(req.url).pathname === config.healthCheckPath) {
+                    return new Response('{"ok":true}', {
+                        headers: { 'content-type': 'application/json' },
+                    });
+                }
+                const pikkuReq = new PikkuFetchHTTPRequest(req);
+                const pikkuRes = new PikkuFetchHTTPResponse();
+                await fetchData(pikkuReq, pikkuRes, {
+                    respondWith404: true,
+                    ...options,
+                });
+                return pikkuRes.toResponse();
+            },
+            websocket: {
+                open: (ws) => {
+                    const { channelHandler } = ws.data;
+                    channelHandler.registerOnSend((data) => {
+                        ws.send(isSerializable(data) ? JSON.stringify(data) : data);
+                    });
+                    channelHandler.registerOnSendBinary((data) => {
+                        ws.send(data, true);
+                    });
+                    channelHandler.registerOnClose(() => {
+                        ws.close();
+                    });
+                    eventHub.onChannelOpened(channelHandler.channelId, ws);
+                    channelHandler.open();
+                },
+                message: async (ws, message) => {
+                    const { channelHandler } = ws.data;
+                    if (typeof message === 'string') {
+                        const result = await channelHandler.message(message);
+                        if (result)
+                            ws.send(JSON.stringify(result));
+                    }
+                    else {
+                        const bytes = message instanceof ArrayBuffer
+                            ? new Uint8Array(message)
+                            : new Uint8Array(message.buffer, message.byteOffset, message.byteLength);
+                        const result = await channelHandler.binaryMessage(bytes);
+                        if (result)
+                            channelHandler.sendBinary(result);
+                    }
+                },
+                close: (ws) => {
+                    const { channelHandler } = ws.data;
+                    eventHub.onChannelClosed(channelHandler.channelId);
+                    channelHandler.close();
+                },
+            },
+        });
+        eventHub.setServer(this.server);
+        logger.info(`pikku-bun-server: listening on http://${config.hostname ?? 'localhost'}:${config.port}`);
+    }
+    async stop() {
+        await this.server?.stop();
+        this.server = null;
+    }
+    enableExitOnSignals() {
+        const shutdown = async (signal) => {
+            this.logger.info(`pikku-bun-server: ${signal} received, stopping`);
+            try {
+                await stopSingletonServices();
+                await this.stop();
+            }
+            finally {
+                process.exit(0);
+            }
+        };
+        process.once('SIGINT', () => shutdown('SIGINT'));
+        process.once('SIGTERM', () => shutdown('SIGTERM'));
+    }
+}
+//# sourceMappingURL=pikku-bun-server.js.map

package/dist/pikku-bun-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-bun-server.js","sourceRoot":"","sources":["../src/pikku-bun-server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@pikku/bun-server",
+  "version": "0.12.1",
+  "description": "Pikku server adapter for Bun (Bun.serve)",
+  "license": "MIT",
+  "author": "yasser.fadl@gmail.com",
+  "module": "dist/index.js",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "tsc": "tsc",
+    "build": "tsc -b",
+    "test": "bash run-tests.sh",
+    "test:watch": "bash run-tests.sh --watch",
+    "test:coverage": "bash run-tests.sh --coverage",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "@pikku/core": "^0.12.38"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}

package/run-tests.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+
+shopt -s nullglob
+
+watch_mode=false
+coverage_mode=false
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --watch)
+      watch_mode=true
+      shift
+      ;;
+    --coverage)
+      coverage_mode=true
+      shift
+      ;;
+    *)
+      echo "Unknown option: $1"
+      exit 1
+      ;;
+  esac
+done
+
+files=()
+while IFS= read -r -d '' file; do
+  files+=("$file")
+done < <(find src -type f -name "*.test.ts" -print0)
+
+if [ ${#files[@]} -eq 0 ]; then
+  echo "No test files found"
+  exit 0
+fi
+
+if [ "$coverage_mode" = true ]; then
+  # Bun writes coverage/lcov.info and instruments imported dist files too.
+  # Re-emit a package-root lcov.info containing only src/ records so the
+  # repo-wide unit-coverage merge — which expects <pkg>/lcov.info and prefixes
+  # its SF paths — maps them correctly, exactly like the node packages'
+  # --test-reporter=lcov output.
+  bun test --coverage --coverage-reporter=lcov "${files[@]}"
+  status=$?
+  awk '/^SF:/{keep=/^SF:src\//} keep' coverage/lcov.info > lcov.info 2>/dev/null || true
+  rm -rf coverage
+  exit $status
+fi
+
+bun_cmd="bun test"
+
+if [ "$watch_mode" = true ]; then
+  bun_cmd="$bun_cmd --watch"
+fi
+
+$bun_cmd "${files[@]}"

package/src/bun-event-hub-service.test.ts

@@ -0,0 +1,73 @@
+import { describe, test } from 'node:test'
+import assert from 'node:assert/strict'
+import { BunEventHubService } from './bun-event-hub-service.js'
+
+type FakeSocket = {
+  subscribe: (topic: string) => void
+  unsubscribe: (topic: string) => void
+  subscribed: string[]
+  unsubscribed: string[]
+}
+
+const makeSocket = (): FakeSocket => {
+  const socket: FakeSocket = {
+    subscribed: [],
+    unsubscribed: [],
+    subscribe: (topic) => socket.subscribed.push(topic),
+    unsubscribe: (topic) => socket.unsubscribed.push(topic),
+  }
+  return socket
+}
+
+describe('BunEventHubService', () => {
+  test('subscribe/unsubscribe proxy to the registered socket', async () => {
+    const hub = new BunEventHubService()
+    const socket = makeSocket()
+    await hub.onChannelOpened('c1', socket as any)
+
+    await hub.subscribe('news', 'c1')
+    await hub.unsubscribe('news', 'c1')
+
+    assert.deepEqual(socket.subscribed, ['news'])
+    assert.deepEqual(socket.unsubscribed, ['news'])
+  })
+
+  test('subscribe is a no-op for unknown channels', async () => {
+    const hub = new BunEventHubService()
+    await assert.doesNotReject(hub.subscribe('news', 'missing'))
+    await assert.doesNotReject(hub.unsubscribe('news', 'missing'))
+  })
+
+  test('publish does nothing before a server is set', async () => {
+    const hub = new BunEventHubService()
+    await assert.doesNotReject(hub.publish('news', null, { a: 1 }))
+  })
+
+  test('publish serializes JSON messages and forwards binary as-is', async () => {
+    const hub = new BunEventHubService()
+    const calls: Array<[string, unknown, boolean]> = []
+    hub.setServer({
+      publish: (topic: string, data: unknown, binary: boolean) =>
+        calls.push([topic, data, binary]),
+    } as any)
+
+    await hub.publish('news', null, { hello: 'world' })
+    const bin = new Uint8Array([1, 2, 3])
+    await hub.publish('bin', null, bin as any, true)
+
+    assert.deepEqual(calls[0], ['news', JSON.stringify({ hello: 'world' }), false])
+    assert.equal(calls[1][0], 'bin')
+    assert.equal(calls[1][1], bin)
+    assert.equal(calls[1][2], true)
+  })
+
+  test('onChannelClosed removes the socket so later subscribes are no-ops', async () => {
+    const hub = new BunEventHubService()
+    const socket = makeSocket()
+    await hub.onChannelOpened('c1', socket as any)
+    await hub.onChannelClosed('c1')
+
+    await hub.subscribe('news', 'c1')
+    assert.deepEqual(socket.subscribed, [])
+  })
+})

package/src/bun-event-hub-service.ts

@@ -0,0 +1,54 @@
+import type { ServerWebSocket, Server } from 'bun'
+
+type AnyServer = Server<unknown>
+import type { EventHubService } from '@pikku/core/channel'
+
+export class BunEventHubService<
+  Mappings extends Record<string, unknown> = {},
+> implements EventHubService<Mappings> {
+  private sockets: Map<string, ServerWebSocket<unknown>> = new Map()
+  private server: AnyServer | null = null
+
+  public setServer(server: AnyServer): void {
+    this.server = server
+  }
+
+  public async subscribe<T extends keyof Mappings>(
+    topic: T,
+    channelId: string
+  ): Promise<void> {
+    this.sockets.get(channelId)?.subscribe(topic as string)
+  }
+
+  public async unsubscribe<T extends keyof Mappings>(
+    topic: T,
+    channelId: string
+  ): Promise<void> {
+    this.sockets.get(channelId)?.unsubscribe(topic as string)
+  }
+
+  public async publish<T extends keyof Mappings>(
+    topic: T,
+    channelId: string | null,
+    message: Mappings[T],
+    isBinary?: boolean
+  ): Promise<void> {
+    if (!this.server) return
+    if (isBinary) {
+      this.server.publish(topic as string, message as any, true)
+    } else {
+      this.server.publish(topic as string, JSON.stringify(message), false)
+    }
+  }
+
+  public async onChannelOpened(
+    channelId: string,
+    ws: ServerWebSocket<unknown>
+  ): Promise<void> {
+    this.sockets.set(channelId, ws)
+  }
+
+  public async onChannelClosed(channelId: string): Promise<void> {
+    this.sockets.delete(channelId)
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+export { PikkuBunServer } from './pikku-bun-server.js'
+export { BunEventHubService } from './bun-event-hub-service.js'
+export type {
+  BunServerConfig,
+  PikkuBunServerOptions,
+} from './pikku-bun-server.js'

package/src/pikku-bun-server.test.ts

@@ -0,0 +1,62 @@
+import { describe, test, before, after } from 'node:test'
+import assert from 'node:assert/strict'
+import { setSingletonServices } from '@pikku/core'
+import { resetPikkuState } from '@pikku/core/internal'
+import type { Logger } from '@pikku/core/services'
+import { PikkuBunServer } from './pikku-bun-server.js'
+
+const PORT = 47817
+const HEALTH = '/__health'
+
+const noopLogger = {
+  info: () => {},
+  error: () => {},
+  warn: () => {},
+  debug: () => {},
+  trace: () => {},
+  setLevel: () => {},
+} as unknown as Logger
+
+describe('PikkuBunServer', () => {
+  let server: PikkuBunServer
+
+  before(async () => {
+    setSingletonServices({
+      logger: noopLogger,
+      schema: {
+        compileSchema: () => {},
+        getSchemaNames: () => new Set<string>(),
+      },
+    } as any)
+    server = new PikkuBunServer(
+      { port: PORT, hostname: 'localhost', healthCheckPath: HEALTH },
+      noopLogger
+    )
+    await server.init()
+    await server.start()
+  })
+
+  after(async () => {
+    await server.stop()
+    resetPikkuState()
+  })
+
+  test('serves the configured health-check path', async () => {
+    const res = await fetch(`http://localhost:${PORT}${HEALTH}`)
+    assert.equal(res.status, 200)
+    assert.equal(res.headers.get('content-type'), 'application/json')
+    assert.deepEqual(await res.json(), { ok: true })
+  })
+
+  test('returns 404 for unregistered routes', async () => {
+    const res = await fetch(`http://localhost:${PORT}/nothing/here`)
+    assert.equal(res.status, 404)
+  })
+
+  test('stop() is idempotent', async () => {
+    const extra = new PikkuBunServer({ port: PORT + 1 }, noopLogger)
+    await extra.start()
+    await extra.stop()
+    await assert.doesNotReject(extra.stop())
+  })
+})

package/src/pikku-bun-server.ts

@@ -0,0 +1,190 @@
+import type { Server as BunServer, ServerWebSocket } from 'bun'
+
+import type { CoreConfig } from '@pikku/core'
+import { stopSingletonServices } from '@pikku/core'
+import type { Logger } from '@pikku/core/services'
+import {
+  fetchData,
+  PikkuFetchHTTPRequest,
+  PikkuFetchHTTPResponse,
+  logRoutes as logRegisterRoutes,
+  type RunHTTPWiringOptions,
+} from '@pikku/core/http'
+import { logChannels } from '@pikku/core/channel'
+import type { PikkuLocalChannelHandler } from '@pikku/core/channel/local'
+import { runLocalChannel } from '@pikku/core/channel/local'
+import { compileAllSchemas } from '@pikku/core/schema'
+
+import { BunEventHubService } from './bun-event-hub-service.js'
+
+export type BunServerConfig = CoreConfig & {
+  port: number
+  hostname?: string
+  healthCheckPath?: string
+}
+
+export type PikkuBunServerOptions = RunHTTPWiringOptions & {
+  /**
+   * Event hub backing channel pub/sub. Inject the SAME instance passed to
+   * `createSingletonServices` so functions and the WebSocket transport share
+   * one hub — otherwise a function's `eventHub.publish(...)` goes to a
+   * different hub than the one holding the live sockets and never reaches
+   * connected clients. Defaults to a fresh `BunEventHubService`.
+   */
+  eventHub?: BunEventHubService
+}
+
+type WsData = { channelHandler: PikkuLocalChannelHandler }
+
+const isSerializable = (data: unknown): boolean =>
+  !(
+    typeof data === 'string' ||
+    data instanceof ArrayBuffer ||
+    data instanceof Uint8Array ||
+    data instanceof Int8Array ||
+    data instanceof Uint16Array ||
+    data instanceof Int16Array ||
+    data instanceof Uint32Array ||
+    data instanceof Int32Array ||
+    data instanceof Float32Array ||
+    data instanceof Float64Array
+  )
+
+/**
+ * Bun-native Pikku server built on Bun.serve.
+ *
+ * Handles HTTP via the fetch handler and WebSocket via Bun.serve's native
+ * websocket handler (which is backed by uWebSockets internally).
+ */
+export class PikkuBunServer {
+  private server: BunServer<WsData> | null = null
+  private readonly eventHub: BunEventHubService
+  private readonly options: RunHTTPWiringOptions
+
+  constructor(
+    private readonly config: BunServerConfig,
+    private readonly logger: Logger,
+    options: PikkuBunServerOptions = {}
+  ) {
+    const { eventHub, ...httpOptions } = options
+    this.eventHub = eventHub ?? new BunEventHubService()
+    this.options = httpOptions
+  }
+
+  public async init(): Promise<void> {
+    compileAllSchemas(this.logger)
+    logRegisterRoutes(this.logger)
+    logChannels(this.logger)
+  }
+
+  public async start(): Promise<void> {
+    const { config, logger, options, eventHub } = this
+
+    this.server = Bun.serve<WsData>({
+      port: config.port,
+      hostname: config.hostname,
+
+      fetch: async (req, server) => {
+        if (req.headers.get('upgrade')?.toLowerCase() === 'websocket') {
+          const pikkuReq = new PikkuFetchHTTPRequest(req)
+          const pikkuRes = new PikkuFetchHTTPResponse()
+          const channelHandler = await runLocalChannel({
+            channelId: crypto.randomUUID(),
+            request: pikkuReq,
+            response: pikkuRes,
+            route: new URL(req.url).pathname,
+          })
+          if (!channelHandler) {
+            return new Response('Forbidden', { status: 403 })
+          }
+          const upgraded = server.upgrade(req, { data: { channelHandler } })
+          if (upgraded) return undefined as unknown as Response
+          return new Response('WebSocket upgrade failed', { status: 500 })
+        }
+
+        if (
+          config.healthCheckPath &&
+          new URL(req.url).pathname === config.healthCheckPath
+        ) {
+          return new Response('{"ok":true}', {
+            headers: { 'content-type': 'application/json' },
+          })
+        }
+
+        const pikkuReq = new PikkuFetchHTTPRequest(req)
+        const pikkuRes = new PikkuFetchHTTPResponse()
+        await fetchData(pikkuReq, pikkuRes, {
+          respondWith404: true,
+          ...options,
+        })
+        return pikkuRes.toResponse()
+      },
+
+      websocket: {
+        open: (ws: ServerWebSocket<WsData>) => {
+          const { channelHandler } = ws.data
+          channelHandler.registerOnSend((data) => {
+            ws.send(isSerializable(data) ? JSON.stringify(data) : (data as any))
+          })
+          channelHandler.registerOnSendBinary((data) => {
+            ws.send(data, true)
+          })
+          channelHandler.registerOnClose(() => {
+            ws.close()
+          })
+          eventHub.onChannelOpened(channelHandler.channelId, ws)
+          channelHandler.open()
+        },
+
+        message: async (ws: ServerWebSocket<WsData>, message) => {
+          const { channelHandler } = ws.data
+          if (typeof message === 'string') {
+            const result = await channelHandler.message(message)
+            if (result) ws.send(JSON.stringify(result))
+          } else {
+            const bytes =
+              message instanceof ArrayBuffer
+                ? new Uint8Array(message)
+                : new Uint8Array(
+                    message.buffer,
+                    message.byteOffset,
+                    message.byteLength
+                  )
+            const result = await channelHandler.binaryMessage(bytes)
+            if (result) channelHandler.sendBinary(result)
+          }
+        },
+
+        close: (ws: ServerWebSocket<WsData>) => {
+          const { channelHandler } = ws.data
+          eventHub.onChannelClosed(channelHandler.channelId)
+          channelHandler.close()
+        },
+      },
+    })
+
+    eventHub.setServer(this.server as BunServer<unknown>)
+    logger.info(
+      `pikku-bun-server: listening on http://${config.hostname ?? 'localhost'}:${config.port}`
+    )
+  }
+
+  public async stop(): Promise<void> {
+    await this.server?.stop()
+    this.server = null
+  }
+
+  public enableExitOnSignals(): void {
+    const shutdown = async (signal: string) => {
+      this.logger.info(`pikku-bun-server: ${signal} received, stopping`)
+      try {
+        await stopSingletonServices()
+        await this.stop()
+      } finally {
+        process.exit(0)
+      }
+    }
+    process.once('SIGINT', () => shutdown('SIGINT'))
+    process.once('SIGTERM', () => shutdown('SIGTERM'))
+  }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "module": "Node18",
+    "outDir": "dist",
+    "target": "esnext",
+    "declaration": true,
+    "types": ["bun"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["**/*.test.ts", "node_modules", "dist"],
+  "references": [
+    {
+      "path": "../../core/tsconfig.json"
+    }
+  ]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/bun-event-hub-service.ts","./src/index.ts","./src/pikku-bun-server.ts"],"version":"5.9.3"}