fritzkit 0.0.0-stage → 0.1.1

package/dist/server/events.js

@@ -0,0 +1,134 @@
+/**
+ * Server-sent events for `GET /api/parts/:slug/events`. One fs.watch per part folder
+ * (recursive, so assets/ is covered even when it is created later), shared by every
+ * subscriber and closed with the last one. Events are debounced per kind:
+ *
+ *   event: changed
+ *   data: {"kind":"part","hash":"<sha1 of part.json>"}     part.json changed
+ *   data: {"kind":"assets"}                                 something under assets/ changed
+ *
+ * The hash lets the app ignore the echo of its own save. build/ and *.fzpz writes are
+ * ignored: they are output, never input.
+ */
+import { createHash } from "node:crypto";
+import { watch } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ASSETS_DIR, PART_FILE } from "../core/workspace.js";
+/** sha1 hex of a string (the app compares it with the hash of what it saved). */
+export function textHash(text) {
+    return createHash("sha1").update(text, "utf8").digest("hex");
+}
+/** Classify a watcher filename relative to the part folder; undefined = ignore. */
+export function classifyChange(filename) {
+    if (!filename)
+        return "part";
+    const f = filename.replace(/\\/g, "/");
+    if (f === PART_FILE)
+        return "part";
+    if (f === ASSETS_DIR || f.startsWith(`${ASSETS_DIR}/`)) {
+        // writeFileAtomic's temp file; the rename that follows reports the real name.
+        if (/\.tmp-\d+$/.test(f))
+            return undefined;
+        return "assets";
+    }
+    return undefined;
+}
+/** Format one SSE frame. */
+export function sseFrame(event, data) {
+    return `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+}
+export class EventHub {
+    debounceMs;
+    channels = new Map();
+    constructor(debounceMs = 200) {
+        this.debounceMs = debounceMs;
+    }
+    /** Subscribe an SSE response to changes in `dir` (keyed by `slug`). */
+    subscribe(slug, dir, res) {
+        let ch = this.channels.get(slug);
+        if (!ch) {
+            ch = { clients: new Set(), timers: new Map() };
+            this.channels.set(slug, ch);
+            const channel = ch;
+            try {
+                channel.watcher = watch(dir, { recursive: true }, (_type, filename) => {
+                    const kind = classifyChange(filename);
+                    if (kind)
+                        this.schedule(slug, dir, channel, kind);
+                });
+                channel.watcher.on("error", () => undefined);
+            }
+            catch {
+                // The folder vanished; subscribers still get the hello and keep-alives.
+            }
+        }
+        ch.clients.add(res);
+        res.writeHead(200, {
+            "content-type": "text/event-stream; charset=utf-8",
+            "cache-control": "no-store",
+            connection: "keep-alive",
+        });
+        res.write(sseFrame("hello", { slug }));
+        const channel = ch;
+        res.on("close", () => {
+            channel.clients.delete(res);
+            if (channel.clients.size === 0)
+                this.drop(slug);
+        });
+    }
+    schedule(slug, dir, ch, kind) {
+        const old = ch.timers.get(kind);
+        if (old)
+            clearTimeout(old);
+        ch.timers.set(kind, setTimeout(() => {
+            ch.timers.delete(kind);
+            void this.fire(dir, ch, kind);
+        }, this.debounceMs));
+    }
+    async fire(dir, ch, kind) {
+        const ev = { kind };
+        if (kind === "part") {
+            try {
+                ev.hash = textHash(await readFile(join(dir, PART_FILE), "utf8"));
+            }
+            catch {
+                // deleted or mid-rename: send the event without a hash
+            }
+        }
+        const frame = sseFrame("changed", ev);
+        for (const c of ch.clients)
+            c.write(frame);
+    }
+    /** Send a comment line to every client (keeps proxies and the browser from timing out). */
+    ping() {
+        for (const ch of this.channels.values())
+            for (const c of ch.clients)
+                c.write(": ping\n\n");
+    }
+    /** Number of open subscriptions (tests). */
+    get size() {
+        let n = 0;
+        for (const ch of this.channels.values())
+            n += ch.clients.size;
+        return n;
+    }
+    drop(slug) {
+        const ch = this.channels.get(slug);
+        if (!ch)
+            return;
+        for (const t of ch.timers.values())
+            clearTimeout(t);
+        ch.watcher?.close();
+        this.channels.delete(slug);
+    }
+    /** End every stream and close every watcher. */
+    close() {
+        for (const [slug, ch] of [...this.channels]) {
+            for (const c of ch.clients)
+                c.end();
+            this.drop(slug);
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/server/events.js.map

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

package/dist/server/http.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Small HTTP helpers for the fritzkit ui server (plain node:http, no framework): JSON
+ * responses, bounded body reading, an error type that carries a status code, and the
+ * loopback-only Host/Origin guard.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+/** An error the API turns into `{ error, ...extra }` with this HTTP status. */
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly extra: Record<string, unknown>;
+    constructor(status: number, message: string, extra?: Record<string, unknown>);
+}
+/** Write a JSON response (2-space, trailing newline, no caching). */
+export declare function sendJson(res: ServerResponse, status: number, body: unknown): void;
+/** Write a text/binary response. */
+export declare function sendBody(res: ServerResponse, status: number, contentType: string, body: string | Uint8Array, cache?: string, extra?: Record<string, string>): void;
+/** Read the whole request body; 413 past `limit` bytes. */
+export declare function readBody(req: IncomingMessage, limit: number): Promise<Buffer>;
+/** Read and parse a JSON body; 400 on bad JSON. An empty body parses as `{}`. */
+export declare function readJson(req: IncomingMessage, limit: number): Promise<unknown>;
+/**
+ * Headers for content derived from user files or user-controlled spec strings (assets,
+ * compiled SVG previews): no MIME sniffing, and a sandboxed CSP so an SVG or HTML opened
+ * directly cannot run script on the app's origin.
+ */
+export declare const UNTRUSTED_HEADERS: Record<string, string>;
+/** Hostname of a Host header or Origin URL ("127.0.0.1:5173" -> "127.0.0.1"). */
+export declare function hostnameOf(value: string): string;
+/**
+ * Loopback guard against DNS rebinding and cross-site requests: the Host header must
+ * name a loopback host and, when the browser sends an Origin, so must the Origin (an
+ * http: URL). With `localPort` (the port the request arrived on) both must also name
+ * that port, so a page served by another program on another loopback port cannot send
+ * "simple" (no preflight) POSTs to this server.
+ */
+export declare function isLoopbackRequest(headers: IncomingMessage["headers"], localPort?: number): boolean;

package/dist/server/http.js

@@ -0,0 +1,127 @@
+/** An error the API turns into `{ error, ...extra }` with this HTTP status. */
+export class HttpError extends Error {
+    status;
+    extra;
+    constructor(status, message, extra = {}) {
+        super(message);
+        this.status = status;
+        this.extra = extra;
+        this.name = "HttpError";
+    }
+}
+/** Write a JSON response (2-space, trailing newline, no caching). */
+export function sendJson(res, status, body) {
+    const text = JSON.stringify(body, null, 2) + "\n";
+    res.writeHead(status, {
+        "content-type": "application/json; charset=utf-8",
+        "cache-control": "no-store",
+        "content-length": Buffer.byteLength(text),
+    });
+    res.end(text);
+}
+/** Write a text/binary response. */
+export function sendBody(res, status, contentType, body, cache = "no-store", extra = {}) {
+    const buf = typeof body === "string" ? Buffer.from(body, "utf8") : Buffer.from(body);
+    res.writeHead(status, {
+        ...extra,
+        "content-type": contentType,
+        "cache-control": cache,
+        "content-length": buf.length,
+    });
+    res.end(buf);
+}
+/** Read the whole request body; 413 past `limit` bytes. */
+export async function readBody(req, limit) {
+    const declared = Number(req.headers["content-length"] ?? "0");
+    if (declared > limit)
+        throw new HttpError(413, `request body is larger than ${limit} bytes`);
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const b = chunk;
+        size += b.length;
+        if (size > limit)
+            throw new HttpError(413, `request body is larger than ${limit} bytes`);
+        chunks.push(b);
+    }
+    return Buffer.concat(chunks);
+}
+/** Read and parse a JSON body; 400 on bad JSON. An empty body parses as `{}`. */
+export async function readJson(req, limit) {
+    const buf = await readBody(req, limit);
+    const text = buf.toString("utf8").replace(/^\uFEFF/u, "");
+    if (text.trim() === "")
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch (e) {
+        throw new HttpError(400, `body is not valid JSON: ${e instanceof Error ? e.message : e}`);
+    }
+}
+/**
+ * Headers for content derived from user files or user-controlled spec strings (assets,
+ * compiled SVG previews): no MIME sniffing, and a sandboxed CSP so an SVG or HTML opened
+ * directly cannot run script on the app's origin.
+ */
+export const UNTRUSTED_HEADERS = {
+    "x-content-type-options": "nosniff",
+    "content-security-policy": "sandbox; default-src 'none'; img-src data:; style-src 'unsafe-inline'",
+};
+const LOOPBACK = new Set(["127.0.0.1", "localhost", "[::1]", "::1"]);
+/** Hostname of a Host header or Origin URL ("127.0.0.1:5173" -> "127.0.0.1"). */
+export function hostnameOf(value) {
+    const v = value.trim().toLowerCase();
+    if (v.includes("://")) {
+        try {
+            return new URL(v).hostname;
+        }
+        catch {
+            return v;
+        }
+    }
+    if (v.startsWith("["))
+        return v.slice(0, v.indexOf("]") + 1);
+    const colon = v.lastIndexOf(":");
+    return colon >= 0 ? v.slice(0, colon) : v;
+}
+/** Port of a Host header ("127.0.0.1:5173" -> 5173; no port -> 80). */
+function hostPortOf(value) {
+    const v = value.trim();
+    const close = v.lastIndexOf("]");
+    const colon = v.lastIndexOf(":");
+    if (colon < 0 || colon < close)
+        return 80;
+    const n = Number(v.slice(colon + 1));
+    return Number.isInteger(n) ? n : -1;
+}
+/**
+ * Loopback guard against DNS rebinding and cross-site requests: the Host header must
+ * name a loopback host and, when the browser sends an Origin, so must the Origin (an
+ * http: URL). With `localPort` (the port the request arrived on) both must also name
+ * that port, so a page served by another program on another loopback port cannot send
+ * "simple" (no preflight) POSTs to this server.
+ */
+export function isLoopbackRequest(headers, localPort) {
+    const host = headers.host;
+    if (host === undefined || !LOOPBACK.has(hostnameOf(host)))
+        return false;
+    if (localPort !== undefined && hostPortOf(host) !== localPort)
+        return false;
+    const origin = headers.origin;
+    if (origin === undefined)
+        return true;
+    let url;
+    try {
+        url = new URL(origin);
+    }
+    catch {
+        return false;
+    }
+    if (url.protocol !== "http:" || !LOOPBACK.has(url.hostname))
+        return false;
+    if (localPort !== undefined && Number(url.port || "80") !== localPort)
+        return false;
+    return true;
+}
+//# sourceMappingURL=http.js.map

package/dist/server/http.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,65 @@
+import { type IncomingMessage, type Server } from "node:http";
+import type { ServerResponse } from "node:http";
+import { type CommandContext } from "../cli/context.js";
+export { HttpError } from "./http.js";
+export { EventHub, classifyChange, sseFrame, textHash } from "./events.js";
+export { apiHandler, assetMimeOf, assetPath, isSafeAssetName, listAssets, mimeOf, partPayload, preparePut, withExplain, } from "./api.js";
+export declare const DEFAULT_PORT = 5173;
+export declare const HOST = "127.0.0.1";
+/** How many ports after the default to try before giving up. */
+export declare const PORT_SCAN = 50;
+export interface ServerOptions {
+    ctx: CommandContext;
+    /** Workspace folder (default: workspaceOf(ctx)). */
+    workspace?: string;
+    /** Built app folder holding index.html (default: dist/ui next to this package). */
+    uiDir?: string;
+    /** SSE keep-alive interval (ms). */
+    pingMs?: number;
+    /** fs.watch debounce (ms). */
+    debounceMs?: number;
+}
+export interface UiServer {
+    workspace: string;
+    uiDir: string;
+    /** Handle one request (the Vite dev server mounts this for /api). */
+    handle: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    /** The node:http server (not listening until listen()). */
+    server: Server;
+    /** Listen on HOST:port; port 0 picks a free port. Resolves to the bound port. */
+    listen: (port: number) => Promise<number>;
+    /** Stop listening, end SSE streams, close watchers. */
+    close: () => Promise<void>;
+}
+/** dist/ui of this package: "../../dist/ui" works from both src/server and dist/server. */
+export declare function defaultUiDir(): string;
+/** True when `dir` holds a built app. */
+export declare function hasBuiltUi(dir: string): boolean;
+/** Build the server (not yet listening). */
+export declare function createServer(opts: ServerOptions): Promise<UiServer>;
+/**
+ * Listen on `start`, or (unless strict) the next free port up to PORT_SCAN above it.
+ * Throws the last error (EADDRINUSE) when none is free.
+ */
+export declare function listenFrom(ui: UiServer, start: number, strict: boolean): Promise<number>;
+/** The command that opens `url` in the default browser (no shell involved). */
+export declare function openCommand(url: string, platform?: NodeJS.Platform): {
+    cmd: string;
+    args: string[];
+};
+/** Fire and forget: open the browser; failures are ignored (the URL is printed anyway). */
+export declare function openBrowser(url: string, platform?: NodeJS.Platform): void;
+/** App URL for the server, optionally deep-linked to a part. */
+export declare function appUrl(port: number, slug?: string): string;
+export interface StartOptions extends ServerOptions {
+    /** Port to try first (default 5173). */
+    port?: number;
+    /** Fail instead of trying the next port when `port` is taken. */
+    strictPort?: boolean;
+}
+/** createServer + listen; the server is tracked so stopAll() can close it (tests). */
+export declare function startUi(opts: StartOptions): Promise<UiServer & {
+    port: number;
+}>;
+/** Close every server startUi started. */
+export declare function stopAll(): Promise<void>;

package/dist/server/index.js

@@ -0,0 +1,193 @@
+/**
+ * The fritzkit ui server (spec D15/D16): a loopback-only node:http server that serves the
+ * built app from dist/ui and the JSON API under /api (see api.ts and docs/ui.md).
+ *
+ * createServer({ workspace, ctx }) takes the same injectable CommandContext as the CLI,
+ * so tests fix the date, fake `isRunning` and point the Fritzing folders at a temp dir.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { readFile, stat } from "node:fs/promises";
+import { createServer as createHttpServer } from "node:http";
+import { join, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { workspaceOf } from "../cli/context.js";
+import { apiHandler, mimeOf } from "./api.js";
+import { EventHub } from "./events.js";
+import { HttpError, isLoopbackRequest, sendBody, sendJson } from "./http.js";
+export { HttpError } from "./http.js";
+export { EventHub, classifyChange, sseFrame, textHash } from "./events.js";
+export { apiHandler, assetMimeOf, assetPath, isSafeAssetName, listAssets, mimeOf, partPayload, preparePut, withExplain, } from "./api.js";
+export const DEFAULT_PORT = 5173;
+export const HOST = "127.0.0.1";
+/** How many ports after the default to try before giving up. */
+export const PORT_SCAN = 50;
+/** dist/ui of this package: "../../dist/ui" works from both src/server and dist/server. */
+export function defaultUiDir() {
+    return fileURLToPath(new URL("../../dist/ui", import.meta.url));
+}
+/** True when `dir` holds a built app. */
+export function hasBuiltUi(dir) {
+    return existsSync(join(dir, "index.html"));
+}
+async function serveStatic(uiDir, pathname, res) {
+    let rel;
+    try {
+        rel = decodeURIComponent(pathname);
+    }
+    catch {
+        throw new HttpError(400, "bad percent-encoding in the path");
+    }
+    if (rel.includes("\0"))
+        throw new HttpError(400, "bad path");
+    const root = resolve(uiDir);
+    let abs = resolve(root, `.${rel}`);
+    if (abs !== root && !abs.startsWith(root + sep))
+        throw new HttpError(403, "outside the app");
+    let isFile;
+    try {
+        isFile = (await stat(abs)).isFile();
+    }
+    catch {
+        isFile = false;
+    }
+    if (!isFile) {
+        // Client-side routes fall back to the app; missing files with an extension are 404.
+        if (/\.[A-Za-z0-9]+$/.test(rel))
+            throw new HttpError(404, `no such file ${rel}`);
+        abs = join(root, "index.html");
+    }
+    let data;
+    try {
+        data = await readFile(abs);
+    }
+    catch {
+        throw new HttpError(404, `the app is not built in ${root}: run npm run ui:build`);
+    }
+    const immutable = abs.includes(`${sep}assets${sep}`);
+    sendBody(res, 200, mimeOf(abs), data, immutable ? "public, max-age=31536000, immutable" : "no-cache");
+}
+/** Build the server (not yet listening). */
+export async function createServer(opts) {
+    const workspace = resolve(opts.workspace ?? workspaceOf(opts.ctx));
+    const uiDir = resolve(opts.uiDir ?? defaultUiDir());
+    const hub = new EventHub(opts.debounceMs ?? 200);
+    const api = apiHandler({ workspace, ctx: opts.ctx, hub });
+    const handle = async (req, res) => {
+        try {
+            if (!isLoopbackRequest(req.headers, req.socket.localPort)) {
+                throw new HttpError(403, "fritzkit ui only answers loopback requests from its own pages");
+            }
+            const url = new URL(req.url ?? "/", "http://127.0.0.1");
+            if (url.pathname === "/api" || url.pathname.startsWith("/api/")) {
+                await api(req, res);
+                return;
+            }
+            if (req.method !== "GET" && req.method !== "HEAD") {
+                throw new HttpError(405, `${req.method} is not allowed on ${url.pathname}`);
+            }
+            await serveStatic(uiDir, url.pathname, res);
+        }
+        catch (e) {
+            if (res.headersSent) {
+                res.end();
+                return;
+            }
+            if (e instanceof HttpError)
+                sendJson(res, e.status, { error: e.message });
+            else
+                sendJson(res, 500, { error: e instanceof Error ? e.message : String(e) });
+        }
+    };
+    const server = createHttpServer((req, res) => void handle(req, res));
+    const ping = setInterval(() => hub.ping(), opts.pingMs ?? 25000);
+    ping.unref();
+    const listen = (port) => new Promise((ok, fail) => {
+        const onError = (e) => {
+            server.off("listening", onListening);
+            fail(e);
+        };
+        const onListening = () => {
+            server.off("error", onError);
+            ok(server.address().port);
+        };
+        server.once("error", onError);
+        server.once("listening", onListening);
+        server.listen(port, HOST);
+    });
+    const close = async () => {
+        clearInterval(ping);
+        hub.close();
+        if (!server.listening)
+            return;
+        await new Promise((ok) => {
+            server.close(() => ok());
+            server.closeAllConnections();
+        });
+    };
+    return { workspace, uiDir, handle, server, listen, close };
+}
+/**
+ * Listen on `start`, or (unless strict) the next free port up to PORT_SCAN above it.
+ * Throws the last error (EADDRINUSE) when none is free.
+ */
+export async function listenFrom(ui, start, strict) {
+    const last = strict || start === 0 ? start : Math.min(65535, start + PORT_SCAN);
+    let err;
+    for (let p = start; p <= last; p++) {
+        try {
+            return await ui.listen(p);
+        }
+        catch (e) {
+            err = e;
+            if (e.code !== "EADDRINUSE")
+                throw e;
+        }
+    }
+    throw err;
+}
+/** The command that opens `url` in the default browser (no shell involved). */
+export function openCommand(url, platform = process.platform) {
+    if (platform === "win32")
+        return { cmd: "rundll32", args: ["url.dll,FileProtocolHandler", url] };
+    if (platform === "darwin")
+        return { cmd: "open", args: [url] };
+    return { cmd: "xdg-open", args: [url] };
+}
+/** Fire and forget: open the browser; failures are ignored (the URL is printed anyway). */
+export function openBrowser(url, platform = process.platform) {
+    const { cmd, args } = openCommand(url, platform);
+    try {
+        const child = spawn(cmd, args, { stdio: "ignore", detached: true, shell: false });
+        child.on("error", () => undefined);
+        child.unref();
+    }
+    catch {
+        // no browser launcher: the caller prints the URL
+    }
+}
+/** App URL for the server, optionally deep-linked to a part. */
+export function appUrl(port, slug) {
+    return `http://${HOST}:${port}/${slug ? `#/${encodeURIComponent(slug)}` : ""}`;
+}
+const running = new Set();
+/** createServer + listen; the server is tracked so stopAll() can close it (tests). */
+export async function startUi(opts) {
+    const ui = await createServer(opts);
+    try {
+        const port = await listenFrom(ui, opts.port ?? DEFAULT_PORT, opts.strictPort ?? false);
+        running.add(ui);
+        return { ...ui, port };
+    }
+    catch (e) {
+        await ui.close();
+        throw e;
+    }
+}
+/** Close every server startUi started. */
+export async function stopAll() {
+    const all = [...running];
+    running.clear();
+    await Promise.all(all.map((s) => s.close()));
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

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