@ontrails/vite 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,109 @@
+# @ontrails/vite
+
+## 0.2.0
+
+### Patch Changes
+
+- [`b3ddf91`](https://github.com/outfitter-dev/trails/commit/b3ddf918ada8211f44983512e2bbdfbc5b66d722): Prepare the first normal Trails release at `0.2.0` on `latest`, replacing the unpublished 1.0.0 source release. The target advances the original `0.1.0` source minor, which was never published under the current package names. Public packages remain in lockstep. Update consumer installation guidance and provide a temporary manifest bridge for old 1.0 beta sources. Published beta versions remain unchanged; minor 0.x releases may carry documented breaking changes.
+
+  The `1.0.0` section retained below records an unpublished preparation, not an npm release. Its accumulated changes are included in `0.2.0`; the section remains as source history alongside the published beta entries.
+
+## 1.0.0
+
+### Patch Changes
+
+- [`f5c6777`](https://github.com/outfitter-dev/trails/commit/f5c6777c39ea959d2123f17bb683151fe265386c): Move adapter package workspaces from `connectors/*` to `adapters/*` as part of
+  the package-boundary taxonomy cutover. Package names and public APIs are
+  unchanged.
+- [`ed5926b`](https://github.com/outfitter-dev/trails/commit/ed5926bddebed7be19a902d69be58f2d5e8b4c51): Add missing TSDoc for public adapter and sink boundary types.
+- [`b1fbe57`](https://github.com/outfitter-dev/trails/commit/b1fbe574e6f44d1fecb5e3a000270955c0a77b7b): Publish Bun-validated package tarballs through an npm trusted-publishing adapter
+  binding, add exact repository metadata for each public workspace package, and
+  correct the native Bun release descriptor to its pack-only runtime boundary.
+
+## 1.0.0-beta.50
+
+## 1.0.0-beta.49
+
+## 1.0.0-beta.48
+
+## 1.0.0-beta.47
+
+## 1.0.0-beta.46
+
+## 1.0.0-beta.45
+
+## 1.0.0-beta.44
+
+### Patch Changes
+
+- [`b1fbe57`](https://github.com/outfitter-dev/trails/commit/b1fbe574e6f44d1fecb5e3a000270955c0a77b7b): Publish Bun-validated package tarballs through an npm trusted-publishing adapter
+  binding, add exact repository metadata for each public workspace package, and
+  correct the native Bun release descriptor to its pack-only runtime boundary.
+
+## 1.0.0-beta.43
+
+## 1.0.0-beta.42
+
+## 1.0.0-beta.41
+
+## 1.0.0-beta.40
+
+## 1.0.0-beta.39
+
+## 1.0.0-beta.38
+
+## 1.0.0-beta.37
+
+## 1.0.0-beta.36
+
+## 1.0.0-beta.35
+
+## 1.0.0-beta.34
+
+## 1.0.0-beta.33
+
+## 1.0.0-beta.32
+
+## 1.0.0-beta.31
+
+## 1.0.0-beta.30
+
+## 1.0.0-beta.29
+
+## 1.0.0-beta.28
+
+## 1.0.0-beta.27
+
+## 1.0.0-beta.26
+
+## 1.0.0-beta.25
+
+## 1.0.0-beta.24
+
+## 1.0.0-beta.23
+
+## 1.0.0-beta.22
+
+## 1.0.0-beta.21
+
+## 1.0.0-beta.20
+
+## 1.0.0-beta.19
+
+### Patch Changes
+
+- ed5926b: Add missing TSDoc for public adapter and sink boundary types.
+
+## 1.0.0-beta.18
+
+## 1.0.0-beta.17
+
+## 1.0.0-beta.16
+
+### Patch Changes
+
+- f5c6777: Move adapter package workspaces from `connectors/*` to `adapters/*` as part of
+  the package-boundary taxonomy cutover. Package names and public APIs are
+  unchanged.
+
+## 1.0.0-beta.15

package/README.md

@@ -0,0 +1,24 @@
+# `@ontrails/vite`
+
+Bridge a fetch-based Trails HTTP surface into Vite's dev-server middleware stack.
+
+```ts
+import { createApp } from '@ontrails/hono';
+import { vite } from '@ontrails/vite';
+import { defineConfig } from 'vite';
+
+import { graph } from './src/app';
+
+export default defineConfig({
+  plugins: [
+    {
+      name: 'trails-surface',
+      configureServer(server) {
+        server.middlewares.use('/api', vite(createApp(graph)));
+      },
+    },
+  ],
+});
+```
+
+Mount the middleware under the path segment you want Vite to delegate to Trails.

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@ontrails/vite",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/outfitter-dev/trails.git",
+    "directory": "adapters/vite"
+  },
+  "files": [
+    "src/**/*.ts",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint ./src",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "devDependencies": {
+    "@ontrails/core": "^0.2.0",
+    "@ontrails/hono": "^0.2.0",
+    "zod": "^4.3.5"
+  }
+}

package/src/index.ts

@@ -0,0 +1,149 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import type { ReadableStream as NodeReadableStream } from 'node:stream/web';
+
+/**
+ * Fetch contract consumed by the Vite adapter when converting to middleware.
+ */
+export interface FetchSurface {
+  fetch(request: Request): Response | Promise<Response>;
+}
+
+/** Callback invoked when Connect middleware should continue execution. */
+export type ViteMiddlewareNext = (error?: unknown) => void;
+
+/** Connect-style middleware wrapper around a Trails fetch surface. */
+export type ViteMiddleware = (
+  req: IncomingMessage,
+  res: ServerResponse,
+  next: ViteMiddlewareNext
+) => void | Promise<void>;
+
+type CookieReadableHeaders = Headers & {
+  readonly getAll?: (name: string) => string[];
+  readonly getSetCookie?: () => string[];
+};
+
+const BODYLESS_METHODS = new Set(['GET', 'HEAD']);
+
+const appendHeader = (
+  headers: Headers,
+  name: string,
+  value: string | readonly string[]
+): void => {
+  if (typeof value === 'string') {
+    headers.append(name, value);
+    return;
+  }
+
+  for (const item of value) {
+    headers.append(name, item);
+  }
+};
+
+const toRequestHeaders = (req: IncomingMessage): Headers => {
+  const headers = new Headers();
+
+  for (const [name, value] of Object.entries(req.headers)) {
+    if (value === undefined) {
+      continue;
+    }
+
+    appendHeader(headers, name, value);
+  }
+
+  return headers;
+};
+
+const toRequestInit = (
+  req: IncomingMessage
+): RequestInit & { duplex?: 'half' } => {
+  const method = req.method ?? 'GET';
+  const headers = toRequestHeaders(req);
+
+  if (BODYLESS_METHODS.has(method)) {
+    return { headers, method };
+  }
+
+  return {
+    body: Readable.toWeb(req) as unknown as BodyInit,
+    duplex: 'half',
+    headers,
+    method,
+  };
+};
+
+const toRequest = (req: IncomingMessage): Request => {
+  const host = req.headers.host ?? 'localhost';
+  const url = new URL(req.url ?? '/', `http://${host}`);
+  return new Request(url, toRequestInit(req));
+};
+
+const readSetCookieHeaders = (headers: Headers): readonly string[] => {
+  const cookieHeaders = headers as CookieReadableHeaders;
+  if (typeof cookieHeaders.getSetCookie === 'function') {
+    return cookieHeaders.getSetCookie();
+  }
+  if (typeof cookieHeaders.getAll === 'function') {
+    return cookieHeaders.getAll('set-cookie');
+  }
+
+  const value = headers.get('set-cookie');
+  return value === null ? [] : [value];
+};
+
+const writeHeaders = (response: Response, res: ServerResponse): void => {
+  const setCookie = readSetCookieHeaders(response.headers);
+  if (setCookie.length > 0) {
+    res.setHeader('set-cookie', [...setCookie]);
+  }
+
+  for (const [name, value] of response.headers) {
+    if (name.toLowerCase() === 'set-cookie') {
+      continue;
+    }
+    res.setHeader(name, value);
+  }
+};
+
+const writeResponse = async (
+  req: IncomingMessage,
+  res: ServerResponse,
+  response: Response
+): Promise<void> => {
+  res.statusCode = response.status;
+  if (response.statusText.length > 0) {
+    res.statusMessage = response.statusText;
+  }
+  writeHeaders(response, res);
+
+  if (req.method === 'HEAD' || response.body === null) {
+    res.end();
+    return;
+  }
+
+  const body = Readable.fromWeb(
+    response.body as unknown as NodeReadableStream<Uint8Array>
+  );
+  await pipeline(body, res);
+};
+
+/**
+ * Convert a fetch-based HTTP surface into Vite/Connect middleware.
+ *
+ * Mount it under the path segment that should resolve through Trails:
+ *
+ * `server.middlewares.use('/api', vite(createApp(graph)))`
+ */
+export const vite =
+  (app: FetchSurface): ViteMiddleware =>
+  async (req, res, next) => {
+    try {
+      const response = await app.fetch(toRequest(req));
+      await writeResponse(req, res, response);
+    } catch (error: unknown) {
+      // oxlint-disable-next-line promise/prefer-await-to-callbacks -- Connect middleware reports errors through next(error)
+      next(error);
+    }
+  };