@fiyuu/runtime 0.1.0 → 0.1.1

package/src/server-types.d.ts

@@ -1,167 +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 };
-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;
-    };
-}
-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;
-export interface RequestContext {
-    request: IncomingMessage;
-    route: string;
-    feature: FeatureRecord | null;
-    input?: Record<string, unknown>;
-}
-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>;
-}
-export interface QueryCacheEntry {
-    data: unknown;
-    expiresAt: number;
-}
-export interface SsgCacheEntry {
-    html: string;
-    etag: string;
-    expiresAt: number | null;
-    revalidateSeconds: number | null;
-}
-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[];
-}
-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;
-}
-export interface StatusPageInput {
-    statusCode: number;
-    title: string;
-    summary: string;
-    detail?: string;
-    route?: string;
-    method?: string;
-    requestId?: string;
-    hints?: string[];
-    diagnostics?: string[];
-}
-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-types.js

@@ -1,5 +0,0 @@
-/**
- * Shared types and interfaces for the Fiyuu runtime server.
- * All other server modules import from here — no implementation code.
- */
-export {};

package/src/server-utils.d.ts

@@ -1,15 +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 type { RuntimeState } from "./server-types.js";
-export declare function escapeHtml(value: unknown): string;
-export declare function serialize(value: unknown): string;
-export declare function createRequestId(): string;
-export declare function prefersHtmlResponse(request: IncomingMessage): boolean;
-export declare function sendJson(response: ServerResponse, statusCode: number, value: unknown): void;
-export declare function sendText(response: ServerResponse, statusCode: number, message: string): void;
-export declare function createWeakEtag(value: string): string;
-export declare function parseRequestBody(request: IncomingMessage): Promise<Record<string, unknown>>;
-export declare function pushServerEvent(state: RuntimeState, level: "info" | "warn" | "error", event: string, details?: string): void;

package/src/server-utils.js

@@ -1,97 +0,0 @@
-/**
- * Pure utility functions for the Fiyuu runtime server.
- * No dependencies on other server modules — safe to import anywhere.
- */
-import { createHash } from "node:crypto";
-// ── HTML escaping ─────────────────────────────────────────────────────────────
-export function escapeHtml(value) {
-    const text = value == null ? "" : String(value);
-    return text
-        .replaceAll("&", "&")
-        .replaceAll("<", "&lt;")
-        .replaceAll(">", "&gt;")
-        .replaceAll('"', "&quot;")
-        .replaceAll("'", "&#39;");
-}
-// ── Serialisation ─────────────────────────────────────────────────────────────
-export function serialize(value) {
-    return JSON.stringify(value ?? null).replaceAll("<", "\\u003c");
-}
-// ── Request ID ────────────────────────────────────────────────────────────────
-export function createRequestId() {
-    return `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
-}
-// ── Content negotiation ───────────────────────────────────────────────────────
-export function prefersHtmlResponse(request) {
-    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, statusCode, value) {
-    response.statusCode = statusCode;
-    response.setHeader("content-type", "application/json; charset=utf-8");
-    response.end(`${JSON.stringify(value, null, 2)}\n`);
-}
-export function sendText(response, statusCode, message) {
-    response.statusCode = statusCode;
-    response.setHeader("content-type", "text/plain; charset=utf-8");
-    response.end(message);
-}
-export function createWeakEtag(value) {
-    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) {
-    const chunks = [];
-    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;
-    }
-    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, level, event, details) {
-    state.serverEvents.unshift({
-        at: new Date().toISOString(),
-        level,
-        event,
-        details,
-    });
-    if (state.serverEvents.length > 120) {
-        state.serverEvents.length = 120;
-    }
-}

package/src/server-websocket.d.ts

@@ -1,7 +0,0 @@
-/**
- * WebSocket server attachment for the Fiyuu runtime.
- * Wires up a ws.WebSocketServer on the HTTP server's upgrade event.
- */
-import { createServer } from "node:http";
-import type { StartServerOptions } from "./server-types.js";
-export declare function attachWebsocketServer(server: ReturnType<typeof createServer>, options: StartServerOptions, websocketPath: string): Promise<string | undefined>;

package/src/server-websocket.js

@@ -1,55 +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 path from "node:path";
-import { WebSocketServer } from "ws";
-import { importModule } from "./server-loader.js";
-export async function attachWebsocketServer(server, options, websocketPath) {
-    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))
-        : 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();
-    server.on("upgrade", (request, 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}`;
-}

package/src/server.d.ts

@@ -1,68 +0,0 @@
-/**
- * Fiyuu runtime server — main orchestrator.
- *
- * This file wires together the modular pieces:
- *   server-types     → shared interfaces
- *   server-utils     → serialise, escapeHtml, sendJson/Text, parseBody, …
- *   server-router    → buildRouteIndex, matchRoute
- *   server-loader    → importModule, layout/meta loading, query cache, renderGeaComponent
- *   server-renderer  → renderDocument, renderStatusPage, serveClientAsset, …
- *   server-devtools  → renderUnifiedToolsScript (dev only)
- *   server-middleware→ runMiddleware
- *   server-websocket → attachWebsocketServer
- */
-import { type RenderMode } from "@fiyuu/core";
-export type { StartServerOptions, StartedServer } from "./server-types.js";
-import type { StartedServer, StartServerOptions } from "./server-types.js";
-declare global {
-    interface Window {
-        __FIYUU_DATA__?: unknown;
-        __FIYUU_ROUTE__?: string;
-        __FIYUU_INTENT__?: string;
-        __FIYUU_RENDER__?: RenderMode;
-        __FIYUU_WS_PATH__?: string;
-        __FIYUU_DEVTOOLS__?: unknown;
-        fiyuu?: {
-            theme: {
-                get(): "light" | "dark";
-                set(value: "light" | "dark"): void;
-                toggle(): void;
-                bindToggle(elementId: string): void;
-                onChange(fn: (theme: "light" | "dark") => void): void;
-            };
-            bind(elementId: string, value?: unknown, asHtml?: boolean): void;
-            partial(elementId: string, url: string, options?: {
-                loading?: string;
-            }): Promise<void>;
-            onError(callback: (event: {
-                message: string;
-                error: Error | null;
-                source: string | null;
-                line: number | null;
-            }) => void): void;
-            state<T>(key: string, initialValue: T): {
-                get(): T;
-                set(value: T): void;
-                bind(elementId: string): object;
-                onChange(fn: (value: T) => void): object;
-            };
-            router: {
-                navigate(url: string): Promise<void>;
-                on(event: "navigate" | "before", fn: (detail: {
-                    route: string;
-                    render?: string;
-                    title?: string;
-                }) => void | false): object;
-            };
-            ws(overridePath?: string): {
-                on(type: string, handler: (data: unknown) => void): object;
-                onOpen(handler: () => void): object;
-                onClose(handler: () => void): object;
-                onError(handler: () => void): object;
-                send(data: unknown): object;
-                status(): "connecting" | "connected" | "closed" | "unavailable";
-            };
-        };
-    }
-}
-export declare function startServer(options: StartServerOptions): Promise<StartedServer>;