@ontrails/vite 1.0.0-beta.15

package/.turbo/turbo-build.log

@@ -0,0 +1 @@
+$ tsc -b

package/.turbo/turbo-lint.log

@@ -0,0 +1,3 @@
+$ oxlint ./src
+Found 0 warnings and 0 errors.
+Finished in 77ms on 2 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,3 @@
+# @ontrails/vite
+
+## 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/dist/index.d.ts

@@ -0,0 +1,15 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export interface FetchSurface {
+    fetch(request: Request): Response | Promise<Response>;
+}
+export type ViteMiddlewareNext = (error?: unknown) => void;
+export type ViteMiddleware = (req: IncomingMessage, res: ServerResponse, next: ViteMiddlewareNext) => void | Promise<void>;
+/**
+ * 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 declare const vite: (app: FetchSurface) => ViteMiddleware;
+//# 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,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKjE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvD;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,kBAAkB,KACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA+G1B;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GACd,KAAK,YAAY,KAAG,cASpB,CAAC"}

package/dist/index.js

@@ -0,0 +1,94 @@
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+const BODYLESS_METHODS = new Set(['GET', 'HEAD']);
+const appendHeader = (headers, name, value) => {
+    if (typeof value === 'string') {
+        headers.append(name, value);
+        return;
+    }
+    for (const item of value) {
+        headers.append(name, item);
+    }
+};
+const toRequestHeaders = (req) => {
+    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) => {
+    const method = req.method ?? 'GET';
+    const headers = toRequestHeaders(req);
+    if (BODYLESS_METHODS.has(method)) {
+        return { headers, method };
+    }
+    return {
+        body: Readable.toWeb(req),
+        duplex: 'half',
+        headers,
+        method,
+    };
+};
+const toRequest = (req) => {
+    const host = req.headers.host ?? 'localhost';
+    const url = new URL(req.url ?? '/', `http://${host}`);
+    return new Request(url, toRequestInit(req));
+};
+const readSetCookieHeaders = (headers) => {
+    const cookieHeaders = headers;
+    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, res) => {
+    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, res, response) => {
+    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);
+    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) => async (req, res, next) => {
+    try {
+        const response = await app.fetch(toRequest(req));
+        await writeResponse(req, res, response);
+    }
+    catch (error) {
+        // oxlint-disable-next-line promise/prefer-await-to-callbacks -- Connect middleware reports errors through next(error)
+        next(error);
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@ontrails/vite",
+  "version": "1.0.0-beta.15",
+  "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": "^1.0.0-beta.14",
+    "@ontrails/hono": "^1.0.0-beta.14",
+    "zod": "^4.3.5"
+  }
+}

package/src/__tests__/surface.test.ts

@@ -0,0 +1,115 @@
+import { describe, expect, test } from 'bun:test';
+import { once } from 'node:events';
+import { createServer } from 'node:http';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { AddressInfo } from 'node:net';
+
+import { Result, trail, topo } from '@ontrails/core';
+import { createApp } from '@ontrails/hono';
+import { z } from 'zod';
+
+import { vite } from '../index.js';
+import type { ViteMiddleware } from '../index.js';
+
+const echoTrail = trail('echo', {
+  blaze: (input) => Result.ok({ reply: input.message }),
+  input: z.object({ message: z.string() }),
+  intent: 'read',
+  output: z.object({ reply: z.string() }),
+});
+
+const submitTrail = trail('submit', {
+  blaze: (input) => Result.ok({ accepted: input.message }),
+  input: z.object({ message: z.string() }),
+  output: z.object({ accepted: z.string() }),
+});
+
+const graph = topo('vite-adapter', { echoTrail, submitTrail });
+
+const handleMiddleware = async (
+  middleware: ViteMiddleware,
+  req: IncomingMessage,
+  res: ServerResponse
+): Promise<void> => {
+  const completion = Promise.withResolvers<undefined>();
+
+  // oxlint-disable-next-line promise/prefer-await-to-callbacks -- Connect middleware completes through next(error?)
+  const middlewarePromise = middleware(req, res, (error) => {
+    if (error !== undefined) {
+      completion.reject(error);
+      return;
+    }
+
+    completion.resolve();
+  });
+
+  try {
+    await Promise.race([middlewarePromise, completion.promise]);
+  } catch (error) {
+    res.statusCode = 500;
+    res.end(error instanceof Error ? error.message : String(error));
+  }
+};
+
+const startServer = async (
+  middleware: ViteMiddleware
+): Promise<{ readonly close: () => Promise<void>; readonly url: string }> => {
+  const server = createServer(async (req, res) => {
+    try {
+      await handleMiddleware(middleware, req, res);
+    } catch (error: unknown) {
+      res.statusCode = 500;
+      res.end(error instanceof Error ? error.message : String(error));
+    }
+  });
+
+  server.listen(0, '127.0.0.1');
+  await once(server, 'listening');
+
+  const address = server.address();
+  if (address === null || typeof address === 'string') {
+    throw new Error('Expected an ephemeral TCP address for the test server');
+  }
+
+  return {
+    close: async () => {
+      server.close();
+      await once(server, 'close');
+    },
+    url: `http://127.0.0.1:${(address as AddressInfo).port}`,
+  };
+};
+
+describe('Vite runtime adapter', () => {
+  test('vite(createApp(graph)) serves read trails through query params', async () => {
+    const handle = await startServer(vite(createApp(graph)));
+
+    try {
+      const response = await fetch(new URL('/echo?message=hello', handle.url));
+
+      expect(response.status).toBe(200);
+      expect(await response.json()).toEqual({ data: { reply: 'hello' } });
+    } finally {
+      await handle.close();
+    }
+  });
+
+  test('forwards JSON request bodies to write trails', async () => {
+    const handle = await startServer(vite(createApp(graph)));
+
+    try {
+      const response = await fetch(new URL('/submit', handle.url), {
+        body: JSON.stringify({ message: 'saved' }),
+        headers: { 'content-type': 'application/json' },
+        method: 'POST',
+      });
+
+      expect(response.status).toBe(200);
+      expect(await response.json()).toEqual({
+        data: { accepted: 'saved' },
+      });
+    } finally {
+      await handle.close();
+    }
+  });
+});

package/src/index.ts

@@ -0,0 +1,144 @@
+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';
+
+export interface FetchSurface {
+  fetch(request: Request): Response | Promise<Response>;
+}
+
+export type ViteMiddlewareNext = (error?: unknown) => void;
+
+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);
+    }
+  };

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["**/__tests__/**", "**/*.test.ts", "dist"]
+}

package/tsconfig.tests.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "rootDir": "./src",
+    "types": ["bun"]
+  },
+  "include": ["src/**/*.test.ts", "src/__tests__/**/*.ts"],
+  "exclude": []
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts"],"version":"5.9.3"}