@fiyuu/runtime 0.2.0 → 0.4.1

package/src/server-types.ts

@@ -1,198 +0,0 @@
-/**
- * Shared types and interfaces for the Fiyuu runtime server.
- * All other server modules import from here — no implementation code.
- */
-
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type { WebSocket } from "ws";
-import type { createProjectGraph, FeatureRecord, FiyuuConfig, MetaDefinition, RenderMode } from "@fiyuu/core";
-import type { FiyuuDB } from "@fiyuu/db";
-import type { FiyuuRealtime } from "@fiyuu/realtime";
-import type { ClientAsset } from "./bundler.js";
-import type { InsightsReport } from "./inspector.js";
-
-export type { IncomingMessage, ServerResponse };
-export type { FeatureRecord, FiyuuConfig, MetaDefinition, RenderMode };
-
-// ── Module shapes ─────────────────────────────────────────────────────────────
-
-export interface ModuleShape {
-  default?: unknown;
-  execute?: (context: any) => Promise<unknown> | unknown;
-  page?: { intent: string };
-  cache?: { ttl?: number; vary?: string[] };
-}
-
-export interface LayoutModule {
-  default?: unknown;
-}
-
-export interface GeaRenderable {
-  props?: Record<string, unknown>;
-  template?: (props?: Record<string, unknown>) => string;
-  toString: () => string;
-}
-
-export interface ApiRouteModule {
-  GET?: (context: RequestContext) => Promise<unknown> | unknown;
-  POST?: (context: RequestContext) => Promise<unknown> | unknown;
-  PUT?: (context: RequestContext) => Promise<unknown> | unknown;
-  PATCH?: (context: RequestContext) => Promise<unknown> | unknown;
-  DELETE?: (context: RequestContext) => Promise<unknown> | unknown;
-}
-
-export interface SocketModule {
-  registerSocketServer?: () => {
-    namespace?: string;
-    events?: string[];
-    onConnect?: (socket: WebSocket) => void;
-    onMessage?: (socket: WebSocket, message: string) => void;
-  };
-}
-
-// ── Middleware ────────────────────────────────────────────────────────────────
-
-export interface MiddlewareModule {
-  middleware?: MiddlewareHandler | MiddlewareHandler[];
-}
-
-export interface MiddlewareContext {
-  request: IncomingMessage;
-  url: URL;
-  responseHeaders: Record<string, string>;
-  requestId: string;
-  warnings: string[];
-}
-
-export interface MiddlewareResult {
-  headers?: Record<string, string>;
-  response?: {
-    status?: number;
-    json?: unknown;
-    body?: string;
-  };
-}
-
-export type MiddlewareNext = () => Promise<void>;
-export type MiddlewareHandler = (
-  context: MiddlewareContext,
-  next: MiddlewareNext,
-) => Promise<MiddlewareResult | void> | MiddlewareResult | void;
-
-// ── Request handling ──────────────────────────────────────────────────────────
-
-export interface RequestContext {
-  request: IncomingMessage;
-  route: string;
-  feature: FeatureRecord | null;
-  input?: Record<string, unknown>;
-}
-
-// ── Server options & result ───────────────────────────────────────────────────
-
-export interface StartServerOptions {
-  mode: "dev" | "start";
-  rootDirectory: string;
-  appDirectory: string;
-  config?: FiyuuConfig;
-  port?: number;
-  maxPort?: number;
-  clientOutputDirectory: string;
-  staticClientRoot: string;
-}
-
-export interface StartedServer {
-  port: number;
-  url: string;
-  websocketUrl?: string;
-  close: () => Promise<void>;
-}
-
-// ── Cache entries ─────────────────────────────────────────────────────────────
-
-export interface QueryCacheEntry {
-  data: unknown;
-  expiresAt: number;
-}
-
-export interface SsgCacheEntry {
-  html: string;
-  etag: string;
-  expiresAt: number | null;
-  revalidateSeconds: number | null;
-}
-
-// ── Runtime state ─────────────────────────────────────────────────────────────
-
-export interface RuntimeState {
-  graph: Awaited<ReturnType<typeof createProjectGraph>>;
-  features: FeatureRecord[];
-  routeIndex: RouteIndex;
-  assets: ClientAsset[];
-  assetsByRoute: Map<string, ClientAsset>;
-  insights: InsightsReport;
-  ssgCache: Map<string, SsgCacheEntry>;
-  queryCache: Map<string, QueryCacheEntry>;
-  queryInflight: Map<string, Promise<unknown>>;
-  queryCacheLastPruneAt: number;
-  layoutStackCache: Map<string, Array<{ component: unknown; meta: MetaDefinition }>>;
-  featureMetaCache: Map<string, MetaDefinition>;
-  mergedMetaCache: Map<string, MetaDefinition>;
-  serverEvents: Array<{ at: string; level: "info" | "warn" | "error"; event: string; details?: string }>;
-  version: number;
-  warnings: string[];
-  db: FiyuuDB;
-  realtime: FiyuuRealtime;
-  serviceNames: string[];
-}
-
-// ── Tiny internal router ──────────────────────────────────────────────────────
-
-export interface TinyRouteContext {
-  request: IncomingMessage;
-  response: ServerResponse;
-  url: URL;
-  state: RuntimeState;
-  options: StartServerOptions;
-  liveClients: Set<ServerResponse>;
-}
-
-export interface TinyRoute {
-  method: "GET" | "POST";
-  path: string;
-  type: "exact" | "prefix";
-  devOnly?: boolean;
-  handler: (context: TinyRouteContext) => Promise<void> | void;
-}
-
-// ── Status page ───────────────────────────────────────────────────────────────
-
-export interface StatusPageInput {
-  statusCode: number;
-  title: string;
-  summary: string;
-  detail?: string;
-  route?: string;
-  method?: string;
-  requestId?: string;
-  hints?: string[];
-  diagnostics?: string[];
-}
-
-// ── Route matching ────────────────────────────────────────────────────────────
-
-export interface RouteMatch {
-  feature: FeatureRecord;
-  params: Record<string, string>;
-}
-
-export interface DynamicRouteMatcher {
-  feature: FeatureRecord;
-  regex: RegExp;
-  paramNames: string[];
-}
-
-export interface RouteIndex {
-  exact: Map<string, FeatureRecord>;
-  dynamic: DynamicRouteMatcher[];
-}

package/src/server-utils.ts

@@ -1,137 +0,0 @@
-/**
- * Pure utility functions for the Fiyuu runtime server.
- * No dependencies on other server modules — safe to import anywhere.
- */
-
-import type { IncomingMessage, ServerResponse } from "node:http";
-import { createHash } from "node:crypto";
-import type { RuntimeState, StatusPageInput } from "./server-types.js";
-
-// ── HTML escaping ─────────────────────────────────────────────────────────────
-
-export function escapeHtml(value: unknown): string {
-  const text = value == null ? "" : String(value);
-  return text
-    .replaceAll("&", "&")
-    .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;")
-    .replaceAll('"', "&quot;")
-    .replaceAll("'", "&#39;");
-}
-
-// ── Serialisation ─────────────────────────────────────────────────────────────
-
-export function serialize(value: unknown): string {
-  return JSON.stringify(value ?? null).replaceAll("<", "\\u003c");
-}
-
-// ── Request ID ────────────────────────────────────────────────────────────────
-
-export function createRequestId(): string {
-  return `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
-}
-
-// ── Content negotiation ───────────────────────────────────────────────────────
-
-export function prefersHtmlResponse(request: IncomingMessage): boolean {
-  if ((request.url ?? "").startsWith("/api")) {
-    return false;
-  }
-  const accept = request.headers.accept ?? "";
-  if (accept.includes("application/json") && !accept.includes("text/html")) {
-    return false;
-  }
-  return true;
-}
-
-// ── Response helpers ──────────────────────────────────────────────────────────
-
-export function sendJson(response: ServerResponse, statusCode: number, value: unknown): void {
-  response.statusCode = statusCode;
-  response.setHeader("content-type", "application/json; charset=utf-8");
-  response.end(`${JSON.stringify(value, null, 2)}\n`);
-}
-
-export function sendText(response: ServerResponse, statusCode: number, message: string): void {
-  response.statusCode = statusCode;
-  response.setHeader("content-type", "text/plain; charset=utf-8");
-  response.end(message);
-}
-
-export function sendXml(response: ServerResponse, statusCode: number, xml: string): void {
-  response.statusCode = statusCode;
-  response.setHeader("content-type", "application/xml; charset=utf-8");
-  response.end(xml);
-}
-
-export function createWeakEtag(value: string): string {
-  const digest = createHash("sha1").update(value).digest("base64url");
-  return `W/\"${digest}\"`;
-}
-
-const MAX_BODY_BYTES = 1_048_576; // 1 MB
-
-export async function parseRequestBody(request: IncomingMessage): Promise<Record<string, unknown>> {
-  const chunks: Buffer[] = [];
-  let totalBytes = 0;
-
-  for await (const chunk of request) {
-    const buffer = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
-    totalBytes += buffer.byteLength;
-    if (totalBytes > MAX_BODY_BYTES) {
-      throw Object.assign(new Error("Request body too large (limit: 1 MB)."), { statusCode: 413 });
-    }
-    chunks.push(buffer);
-  }
-
-  const rawBody = Buffer.concat(chunks).toString("utf8").trim();
-  if (!rawBody) {
-    return {};
-  }
-
-  const contentType = request.headers["content-type"] ?? "";
-
-  if (contentType.includes("application/json")) {
-    const parsed = JSON.parse(rawBody);
-    // Reject prototype pollution attempts.
-    if (parsed !== null && typeof parsed === "object") {
-      const hasOwn = Object.prototype.hasOwnProperty;
-      if (
-        hasOwn.call(parsed, "__proto__") ||
-        hasOwn.call(parsed, "constructor") ||
-        hasOwn.call(parsed, "prototype")
-      ) {
-        throw Object.assign(new Error("Request body contains forbidden keys."), { statusCode: 400 });
-      }
-    }
-    return parsed as Record<string, unknown>;
-  }
-
-  if (contentType.includes("application/x-www-form-urlencoded")) {
-    const entries = [...new URLSearchParams(rawBody).entries()].filter(
-      ([key]) => key !== "__proto__" && key !== "constructor" && key !== "prototype",
-    );
-    return Object.fromEntries(entries);
-  }
-
-  return { raw: rawBody };
-}
-
-// ── Server event log ──────────────────────────────────────────────────────────
-
-export function pushServerEvent(
-  state: RuntimeState,
-  level: "info" | "warn" | "error",
-  event: string,
-  details?: string,
-): void {
-  state.serverEvents.unshift({
-    at: new Date().toISOString(),
-    level,
-    event,
-    details,
-  });
-  if (state.serverEvents.length > 120) {
-    state.serverEvents.length = 120;
-  }
-}

package/src/server-websocket.ts

@@ -1,71 +0,0 @@
-/**
- * WebSocket server attachment for the Fiyuu runtime.
- * Wires up a ws.WebSocketServer on the HTTP server's upgrade event.
- */
-
-import { existsSync } from "node:fs";
-import { createServer } from "node:http";
-import type { Socket } from "node:net";
-import path from "node:path";
-import { WebSocketServer } from "ws";
-import type { SocketModule, StartServerOptions } from "./server-types.js";
-import { importModule } from "./server-loader.js";
-
-export async function attachWebsocketServer(
-  server: ReturnType<typeof createServer>,
-  options: StartServerOptions,
-  websocketPath: string,
-): Promise<string | undefined> {
-  if (!options.config?.websocket?.enabled) {
-    return undefined;
-  }
-
-  const socketModulePath = path.join(options.rootDirectory, "server", "socket.ts");
-  const socketModule = existsSync(socketModulePath)
-    ? ((await importModule(socketModulePath, options.mode)) as SocketModule)
-    : null;
-  const registration = socketModule?.registerSocketServer?.() ?? {};
-
-  const wss = new WebSocketServer({
-    noServer: true,
-    maxPayload: options.config?.websocket?.maxPayloadBytes ?? 64 * 1024,
-  });
-
-  wss.on("connection", (socket) => {
-    socket.send(
-      JSON.stringify({
-        type: "fiyuu:ready",
-        namespace: registration.namespace ?? "app",
-        events: registration.events ?? [],
-      }),
-    );
-    registration.onConnect?.(socket);
-    socket.on("message", (message) => {
-      registration.onMessage?.(socket, message.toString());
-    });
-  });
-
-  const handledSockets = new WeakSet<Socket>();
-
-  server.on("upgrade", (request, socket: Socket, head) => {
-    if (handledSockets.has(socket)) return;
-    handledSockets.add(socket);
-
-    if (!request.url) {
-      socket.destroy();
-      return;
-    }
-    const url = new URL(request.url, "http://localhost");
-    if (url.pathname !== websocketPath) return;
-
-    try {
-      wss.handleUpgrade(request, socket, head, (client) => {
-        wss.emit("connection", client, request);
-      });
-    } catch {
-      // Another WebSocket handler already processed this socket
-    }
-  });
-
-  return `ws://localhost:${options.port ?? 4050}${websocketPath}`;
-}