@plebeiantech/lat.md 0.12.3-fork.14 → 0.12.3-fork.15

package/dist/src/view/server.d.ts

@@ -1,5 +1,5 @@
 import { type Server } from 'node:http';
-import { type LatServerApp } from '@lat.md/server';
+import { type LatServerApp } from '../../vendor/lat.md-server/index.js';
 import { type CmdContext } from '../context.js';
 import { type ViewSearch } from './search.js';
 import { type ViewStore } from './store.js';

package/dist/src/view/server.js

@@ -2,7 +2,7 @@ import { readFile } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
 import { extname, join, relative, resolve, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { createLatServerApp, listenLatServer, } from '@lat.md/server';
+import { createLatServerApp, listenLatServer, } from '../../vendor/lat.md-server/index.js';
 import { plainStyler } from '../context.js';
 import { sectionCommand } from '../cli/section.js';
 import { DEFAULT_VIEW_LOGO_TEXT, } from './protocol.js';

package/dist/vendor/lat.md-server/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/vendor/lat.md-server/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { runLatServer } from './index.js';
+const entry = process.argv[2];
+if (!entry)
+    throw new Error('Usage: lat-ui-server <app-module>');
+const module = (await import(pathToFileURL(resolve(entry)).href));
+if (typeof module.default !== 'function') {
+    throw new Error(`${entry} must default-export an Express app`);
+}
+await runLatServer(module.default, { close: module.close });

package/dist/vendor/lat.md-server/index.d.ts

@@ -0,0 +1,38 @@
+import { type IncomingMessage, type RequestListener, type Server, type ServerResponse } from 'node:http';
+import { type Express } from 'express';
+export declare const LAT_UI_CONTENT_SECURITY_POLICY = "default-src 'self'; connect-src 'self' https://tiles.openfreemap.org; font-src 'self' data:; img-src 'self' data: https://github.githubassets.com; style-src 'self' 'unsafe-inline'; worker-src 'self' blob:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'";
+export type LatServerAppOptions = {
+    /** Handle dynamic routes before immutable files and fallback handlers. */
+    handle?: LatServerRequestHandler;
+    /** Serve a completed Lat UI export after dynamic routes. */
+    publicDir?: string;
+};
+export type LatServerApp = RequestListener;
+export type LatServerRequestHandler = (req: IncomingMessage, res: ServerResponse, next: (error?: unknown) => void) => void | Promise<void>;
+export type ListenLatServerOptions = {
+    host: string;
+    port: number;
+    /** Advance through occupied ports. Explicit user ports should leave this off. */
+    findAvailablePort?: boolean;
+};
+export type RunningLatServer = {
+    server: Server;
+    host: string;
+    port: number;
+    url: string;
+    close: () => Promise<void>;
+};
+/** Create the common Express stack used by live and exported Lat UI servers. */
+export declare function createLatServerApp(options?: LatServerAppOptions, app?: Express): LatServerApp;
+/** Listen with the same strict-or-next-port behavior in every Lat UI host. */
+export declare function listenLatServer(app: LatServerApp, options: ListenLatServerOptions): Promise<RunningLatServer>;
+export type RunLatServerOptions = {
+    host?: string;
+    port?: number;
+    close?: () => void | Promise<void>;
+    log?: (message: string) => void;
+};
+/** Run an exported Express app until the standalone process is terminated. */
+export declare function runLatServer(app: LatServerApp, options?: RunLatServerOptions): Promise<RunningLatServer>;
+/** Read this published package's exact version for generated artifacts. */
+export declare function getLatServerVersion(): string;

package/dist/vendor/lat.md-server/index.js

@@ -0,0 +1,128 @@
+import { createServer, } from 'node:http';
+import { readFileSync } from 'node:fs';
+import express from 'express';
+export const LAT_UI_CONTENT_SECURITY_POLICY = "default-src 'self'; connect-src 'self' https://tiles.openfreemap.org; font-src 'self' data:; img-src 'self' data: https://github.githubassets.com; style-src 'self' 'unsafe-inline'; worker-src 'self' blob:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'";
+function setSecurityHeaders(res) {
+    res.setHeader('Content-Security-Policy', LAT_UI_CONTENT_SECURITY_POLICY);
+    res.setHeader('Referrer-Policy', 'no-referrer');
+    res.setHeader('X-Content-Type-Options', 'nosniff');
+}
+function isImmutablePublicFile(path) {
+    const parts = path.split(/[/\\]/);
+    if (parts.includes('assets'))
+        return true;
+    return /[/\\]data[/\\][^/\\]+[/\\][a-f0-9]{20}\.json$/.test(path);
+}
+/** Create the common Express stack used by live and exported Lat UI servers. */
+export function createLatServerApp(options = {}, app = express()) {
+    app.disable('x-powered-by');
+    app.use((_req, res, next) => {
+        setSecurityHeaders(res);
+        next();
+    });
+    if (options.handle) {
+        app.use((req, res, next) => {
+            try {
+                void Promise.resolve(options.handle(req, res, next)).catch(next);
+            }
+            catch (error) {
+                next(error);
+            }
+        });
+    }
+    if (options.publicDir) {
+        app.use(express.static(options.publicDir, {
+            setHeaders(res, path) {
+                res.setHeader('Cache-Control', isImmutablePublicFile(path)
+                    ? 'public, max-age=31536000, immutable'
+                    : 'no-cache');
+            },
+        }));
+    }
+    app.use((_req, res) => {
+        res.status(404).type('text/plain').send('Not found');
+    });
+    app.use((error, _req, res, _next) => {
+        console.error(error);
+        res.status(500).json({ error: 'Internal server error' });
+    });
+    return app;
+}
+function listen(server, host, port) {
+    return new Promise((resolveListen, reject) => {
+        const onError = (error) => {
+            server.off('listening', onListening);
+            reject(error);
+        };
+        const onListening = () => {
+            server.off('error', onError);
+            resolveListen();
+        };
+        server.once('error', onError);
+        server.once('listening', onListening);
+        server.listen(port, host);
+    });
+}
+function closeServer(server) {
+    return new Promise((resolveClose, reject) => {
+        server.close((error) => (error ? reject(error) : resolveClose()));
+    });
+}
+/** Listen with the same strict-or-next-port behavior in every Lat UI host. */
+export async function listenLatServer(app, options) {
+    const server = createServer(app);
+    let port = options.port;
+    while (true) {
+        try {
+            await listen(server, options.host, port);
+            break;
+        }
+        catch (error) {
+            if (!options.findAvailablePort ||
+                error.code !== 'EADDRINUSE' ||
+                port === 65_535) {
+                throw error;
+            }
+            port++;
+        }
+    }
+    const address = server.address();
+    if (!address) {
+        await closeServer(server);
+        throw new Error('Could not determine Lat UI server address');
+    }
+    return {
+        server,
+        host: options.host,
+        port: address.port,
+        url: `http://${options.host}:${address.port}/`,
+        close: () => closeServer(server),
+    };
+}
+/** Run an exported Express app until the standalone process is terminated. */
+export async function runLatServer(app, options = {}) {
+    const host = options.host ?? process.env.HOST ?? '0.0.0.0';
+    const rawPort = options.port ?? Number(process.env.PORT ?? 3000);
+    if (!Number.isInteger(rawPort) || rawPort < 1 || rawPort > 65_535) {
+        throw new Error('PORT must be an integer from 1 to 65535');
+    }
+    const running = await listenLatServer(app, { host, port: rawPort });
+    (options.log ?? console.log)(`Lat UI listening on ${running.url}`);
+    let closing = false;
+    const shutdown = () => {
+        if (closing)
+            return;
+        closing = true;
+        void Promise.all([running.close(), options.close?.()]).catch((error) => {
+            console.error(error);
+            process.exitCode = 1;
+        });
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+    return running;
+}
+/** Read this published package's exact version for generated artifacts. */
+export function getLatServerVersion() {
+    return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plebeiantech/lat.md",
-  "version": "0.12.3-fork.14",
+  "version": "0.12.3-fork.15",
   "description": "A knowledge graph for your codebase, written in markdown",
   "type": "module",
   "license": "MIT",
@@ -24,6 +24,7 @@
   },
   "files": [
     "dist/src",
+    "dist/vendor",
     "templates",
     "plugins"
   ],
@@ -64,7 +65,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",
     "vite": "^7.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "@lat.md/server": "0.1.0"
   },
   "dependencies": {
     "@asciidoctor/core": "4.0.6",
@@ -74,6 +76,7 @@
     "@repomix/tree-sitter-wasms": "^0.1.17",
     "commander": "^14.0.3",
     "diff": "^8.0.4",
+    "express": "^5.2.1",
     "github-slugger": "^2.0.0",
     "ignore-walk": "^8.0.0",
     "mdast-util-gfm-autolink-literal": "^2.0.1",
@@ -103,12 +106,11 @@
     "web-tree-sitter": "^0.26.6",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lat.md/embed": "0.2.0",
-    "@lat.md/server": "0.1.0",
-    "@lat.md/embed-minilm-fp16": "0.1.0"
+    "@lat.md/embed-minilm-fp16": "0.1.0",
+    "@lat.md/embed": "0.2.0"
   },
   "scripts": {
-    "build": "tsc && pnpm build:view",
+    "build": "tsc && tsx scripts/fork-vendor-ui-server.ts && pnpm build:view",
     "build:view": "vite build --config view/vite.config.ts && vite build --config view/highlight.vite.config.ts",
     "buildall": "pnpm build:packages && pnpm build",
     "setup:rust": "pnpm --filter @lat.md/embed setup:rust",