@craft-ts/log-server 0.7.0-beta.15

package/README.md

@@ -0,0 +1,44 @@
+# Local log server
+
+Receives logs from the demo application over HTTP and appends them to a local
+JSONL file. It does nothing else — reading the logs back is the job of
+[`@craft-ts/log-mcp`](../../packages/log-mcp/README.md).
+
+```sh
+npm run logs:server
+```
+
+## Endpoints
+
+| Method   | Path      | Description                                        |
+| -------- | --------- | -------------------------------------------------- |
+| `POST`   | `/logs`   | Ingest a batch. Answers `202 {"accepted": n}`.      |
+| `DELETE` | `/logs`   | Delete the active and rotated files.                |
+| `GET`    | `/health` | Target file and its current size.                   |
+
+`POST /logs` accepts three body shapes: a `{ clientId, entries: [...] }`
+envelope (what the demo sends), a bare array of entries, or a single entry.
+Entries missing a known `level` are dropped individually — one bad entry never
+rejects the whole batch. CORS is wide open: this is a loopback dev tool.
+
+## Storage
+
+One JSON object per line in `.logs/app.jsonl`, oldest first. Each stored entry
+keeps the browser `timestamp` and adds a server-side `receivedAt` plus an
+incrementing `seq`. Once the active file exceeds `LOG_SERVER_MAX_FILE_SIZE` it
+is rotated to `app.jsonl.1`, existing rotated files shift down one slot, and
+anything past `LOG_SERVER_MAX_FILES` is dropped.
+
+## Environment
+
+| Variable                   | Default     | Description                       |
+| -------------------------- | ----------- | --------------------------------- |
+| `LOG_SERVER_HOST`          | `127.0.0.1` | Listen address                    |
+| `LOG_SERVER_PORT`          | `4319`      | Listen port                       |
+| `LOG_SERVER_DIR`           | `./.logs`   | Storage directory                 |
+| `LOG_SERVER_MAX_FILE_SIZE` | `5242880`   | Rotation threshold, in bytes      |
+| `LOG_SERVER_MAX_FILES`     | `5`         | Rotated files kept                |
+| `LOG_SERVER_QUIET`         | unset       | Set to `1` to silence ingest echo |
+
+`LOG_SERVER_DIR` and `LOG_SERVER_MAX_FILES` must match what the MCP server uses,
+otherwise it reads a different set of files.

package/dist/http-server.d.ts

@@ -0,0 +1,12 @@
+import { type Server } from 'node:http';
+import type { LogStore } from './log-store.js';
+export type LogHttpServerOptions = {
+    readonly store: LogStore;
+    readonly host?: string;
+    readonly port?: number;
+    /** Reject bodies larger than this, in bytes. */
+    readonly maxBodySize?: number;
+    /** Called after every accepted batch; used for console echo. */
+    readonly onIngest?: (count: number) => void;
+};
+export declare function createLogHttpServer(options: LogHttpServerOptions): Server;

package/dist/http-server.js

@@ -0,0 +1,102 @@
+import { createServer } from 'node:http';
+import { parseBatch } from './log-entry.js';
+const DEFAULT_MAX_BODY_SIZE = 2 * 1024 * 1024;
+// Dev-only server bound to the loopback interface: any local origin (the demo
+// dev server, storybook, an e2e run) is allowed to post.
+const CORS_HEADERS = {
+    'access-control-allow-origin': '*',
+    'access-control-allow-methods': 'POST, GET, DELETE, OPTIONS',
+    'access-control-allow-headers': 'content-type',
+    'access-control-max-age': '86400',
+};
+export function createLogHttpServer(options) {
+    const maxBodySize = options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE;
+    return createServer((request, response) => {
+        void handleRequest(request, response, options, maxBodySize).catch((error) => {
+            sendJson(response, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        });
+    });
+}
+async function handleRequest(request, response, options, maxBodySize) {
+    const url = new URL(request.url ?? '/', 'http://localhost');
+    if (request.method === 'OPTIONS') {
+        response.writeHead(204, CORS_HEADERS);
+        response.end();
+        return;
+    }
+    if (request.method === 'GET' && url.pathname === '/health') {
+        sendJson(response, 200, {
+            status: 'ok',
+            file: options.store.filePath,
+            size: options.store.size(),
+        });
+        return;
+    }
+    if (request.method === 'DELETE' && url.pathname === '/logs') {
+        options.store.clear();
+        sendJson(response, 200, { cleared: true });
+        return;
+    }
+    if (request.method === 'POST' && url.pathname === '/logs') {
+        let body;
+        try {
+            body = await readBody(request, maxBodySize);
+        }
+        catch (error) {
+            sendJson(response, 413, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(body);
+        }
+        catch {
+            sendJson(response, 400, { error: 'Invalid JSON body' });
+            return;
+        }
+        const entries = parseBatch(payload);
+        options.store.append(entries);
+        options.onIngest?.(entries.length);
+        sendJson(response, 202, { accepted: entries.length });
+        return;
+    }
+    sendJson(response, 404, { error: 'Not found' });
+}
+function readBody(request, maxBodySize) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        let overflowed = false;
+        request.on('data', (chunk) => {
+            if (overflowed)
+                return;
+            size += chunk.length;
+            if (size > maxBodySize) {
+                overflowed = true;
+                chunks.length = 0;
+                // Keep draining instead of destroying the socket, otherwise the client
+                // sees a connection reset instead of the 413.
+                request.resume();
+                reject(new Error(`Body exceeds ${maxBodySize} bytes`));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        request.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        request.on('error', reject);
+    });
+}
+function sendJson(response, status, body) {
+    if (response.writableEnded)
+        return;
+    response.writeHead(status, {
+        ...CORS_HEADERS,
+        'content-type': 'application/json',
+    });
+    response.end(JSON.stringify(body));
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

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

package/dist/log-entry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Wire format shared by the browser forwarder, the ingestion server and the
+ * MCP reader. Everything except `level` and `timestamp` is optional: the
+ * forwarder ships whatever the craft `Console.*` boundary produced.
+ */
+export type LogLevel = 'debug' | 'info' | 'log' | 'warn' | 'error';
+export declare const LOG_LEVELS: readonly LogLevel[];
+export type IncomingLogEntry = {
+    readonly level: LogLevel;
+    /** Human readable rendering of the console arguments. */
+    readonly message: string;
+    /** Original console arguments, JSON-safe. */
+    readonly args?: readonly unknown[];
+    /** Craft host tag ancestry, e.g. `['App', 'UserCard']`. */
+    readonly from?: readonly string[];
+    readonly tags?: readonly unknown[];
+    readonly trace?: string;
+    readonly correlationId?: unknown;
+    /** ISO or UTC string produced in the browser. */
+    readonly timestamp?: string;
+    readonly route?: string;
+    readonly browser?: unknown;
+    readonly clientId?: string;
+};
+export type StoredLogEntry = IncomingLogEntry & {
+    readonly timestamp: string;
+    /** Server-side receive time, always ISO 8601. */
+    readonly receivedAt: string;
+    readonly seq: number;
+};
+export type LogBatch = {
+    readonly clientId?: string;
+    readonly entries: readonly IncomingLogEntry[];
+};
+/**
+ * Validates and normalises one wire entry. Returns `undefined` when the payload
+ * is unusable so a single bad entry never rejects a whole batch.
+ */
+export declare function normalizeEntry(value: unknown, fallbackClientId?: string): IncomingLogEntry | undefined;
+export declare function parseBatch(payload: unknown): readonly IncomingLogEntry[];

package/dist/log-entry.js

@@ -0,0 +1,58 @@
+export const LOG_LEVELS = [
+    'debug',
+    'info',
+    'log',
+    'warn',
+    'error',
+];
+function isLogLevel(value) {
+    return (typeof value === 'string' && LOG_LEVELS.includes(value));
+}
+/**
+ * Validates and normalises one wire entry. Returns `undefined` when the payload
+ * is unusable so a single bad entry never rejects a whole batch.
+ */
+export function normalizeEntry(value, fallbackClientId) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const raw = value;
+    if (!isLogLevel(raw['level']))
+        return undefined;
+    const message = typeof raw['message'] === 'string'
+        ? raw['message']
+        : JSON.stringify(raw['message'] ?? '');
+    return {
+        level: raw['level'],
+        message,
+        args: Array.isArray(raw['args']) ? raw['args'] : undefined,
+        from: Array.isArray(raw['from'])
+            ? raw['from'].map(String)
+            : undefined,
+        tags: Array.isArray(raw['tags']) ? raw['tags'] : undefined,
+        trace: typeof raw['trace'] === 'string' ? raw['trace'] : undefined,
+        correlationId: raw['correlationId'],
+        timestamp: typeof raw['timestamp'] === 'string' ? raw['timestamp'] : undefined,
+        route: typeof raw['route'] === 'string' ? raw['route'] : undefined,
+        browser: raw['browser'],
+        clientId: typeof raw['clientId'] === 'string' ? raw['clientId'] : fallbackClientId,
+    };
+}
+export function parseBatch(payload) {
+    if (Array.isArray(payload)) {
+        return payload
+            .map((entry) => normalizeEntry(entry))
+            .filter((entry) => entry !== undefined);
+    }
+    if (typeof payload !== 'object' || payload === null)
+        return [];
+    const batch = payload;
+    const clientId = typeof batch['clientId'] === 'string' ? batch['clientId'] : undefined;
+    if (Array.isArray(batch['entries'])) {
+        return batch['entries']
+            .map((entry) => normalizeEntry(entry, clientId))
+            .filter((entry) => entry !== undefined);
+    }
+    const single = normalizeEntry(payload, clientId);
+    return single ? [single] : [];
+}
+//# sourceMappingURL=log-entry.js.map

package/dist/log-entry.js.map

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

package/dist/log-store.d.ts

@@ -0,0 +1,28 @@
+import type { IncomingLogEntry, StoredLogEntry } from './log-entry.js';
+export type LogStoreOptions = {
+    /** Directory holding `app.jsonl` and its rotated siblings. */
+    readonly directory: string;
+    readonly fileName?: string;
+    /** Rotate once the active file exceeds this size, in bytes. */
+    readonly maxFileSize?: number;
+    /** Number of rotated files kept next to the active one. */
+    readonly maxFiles?: number;
+};
+/**
+ * Append-only JSONL store. One JSON object per line, newest last, so the MCP
+ * reader can stream lines without parsing the whole file.
+ */
+export declare class LogStore {
+    readonly directory: string;
+    readonly fileName: string;
+    readonly maxFileSize: number;
+    readonly maxFiles: number;
+    private seq;
+    constructor(options: LogStoreOptions);
+    get filePath(): string;
+    rotatedPath(index: number): string;
+    append(entries: readonly IncomingLogEntry[]): readonly StoredLogEntry[];
+    clear(): void;
+    size(): number;
+    private rotateIfNeeded;
+}

package/dist/log-store.js

@@ -0,0 +1,73 @@
+import { appendFileSync, mkdirSync, renameSync, statSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_FILE_NAME = 'app.jsonl';
+const DEFAULT_MAX_FILE_SIZE = 5 * 1024 * 1024;
+const DEFAULT_MAX_FILES = 5;
+/**
+ * Append-only JSONL store. One JSON object per line, newest last, so the MCP
+ * reader can stream lines without parsing the whole file.
+ */
+export class LogStore {
+    directory;
+    fileName;
+    maxFileSize;
+    maxFiles;
+    seq = 0;
+    constructor(options) {
+        this.directory = options.directory;
+        this.fileName = options.fileName ?? DEFAULT_FILE_NAME;
+        this.maxFileSize = options.maxFileSize ?? DEFAULT_MAX_FILE_SIZE;
+        this.maxFiles = options.maxFiles ?? DEFAULT_MAX_FILES;
+        mkdirSync(this.directory, { recursive: true });
+    }
+    get filePath() {
+        return join(this.directory, this.fileName);
+    }
+    rotatedPath(index) {
+        return join(this.directory, `${this.fileName}.${index}`);
+    }
+    append(entries) {
+        if (entries.length === 0)
+            return [];
+        const receivedAt = new Date().toISOString();
+        const stored = entries.map((entry) => ({
+            ...entry,
+            timestamp: entry.timestamp ?? receivedAt,
+            receivedAt,
+            seq: ++this.seq,
+        }));
+        this.rotateIfNeeded();
+        appendFileSync(this.filePath, stored.map((entry) => `${JSON.stringify(entry)}\n`).join(''), 'utf8');
+        return stored;
+    }
+    clear() {
+        rmSync(this.filePath, { force: true });
+        for (let index = 1; index <= this.maxFiles; index++) {
+            rmSync(this.rotatedPath(index), { force: true });
+        }
+    }
+    size() {
+        try {
+            return statSync(this.filePath).size;
+        }
+        catch {
+            return 0;
+        }
+    }
+    rotateIfNeeded() {
+        if (this.size() < this.maxFileSize)
+            return;
+        // Drop the oldest, then shift every rotated file one slot down.
+        rmSync(this.rotatedPath(this.maxFiles), { force: true });
+        for (let index = this.maxFiles - 1; index >= 1; index--) {
+            try {
+                renameSync(this.rotatedPath(index), this.rotatedPath(index + 1));
+            }
+            catch {
+                // Slot is empty; nothing to shift.
+            }
+        }
+        renameSync(this.filePath, this.rotatedPath(1));
+    }
+}
+//# sourceMappingURL=log-store.js.map

package/dist/log-store.js.map

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

package/dist/main.d.ts

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

package/dist/main.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { resolve } from 'node:path';
+import { createLogHttpServer } from './http-server.js';
+import { LogStore } from './log-store.js';
+const host = process.env['LOG_SERVER_HOST'] ?? '127.0.0.1';
+const port = Number(process.env['LOG_SERVER_PORT'] ?? '4319');
+const directory = resolve(process.env['LOG_SERVER_DIR'] ?? resolve(process.cwd(), '.logs'));
+const maxFileSize = Number(process.env['LOG_SERVER_MAX_FILE_SIZE'] ?? String(5 * 1024 * 1024));
+const maxFiles = Number(process.env['LOG_SERVER_MAX_FILES'] ?? '5');
+const quiet = process.env['LOG_SERVER_QUIET'] === '1';
+const store = new LogStore({ directory, maxFileSize, maxFiles });
+const server = createLogHttpServer({
+    store,
+    onIngest: (count) => {
+        if (!quiet && count > 0) {
+            console.log(`[log-server] +${count} entries -> ${store.filePath}`);
+        }
+    },
+});
+server.listen(port, host, () => {
+    console.log(`[log-server] listening on http://${host}:${port}`);
+    console.log(`[log-server] writing to ${store.filePath}`);
+});
+const shutdown = () => {
+    server.close(() => process.exit(0));
+};
+process.once('SIGINT', shutdown);
+process.once('SIGTERM', shutdown);
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,WAAW,CAAC;AAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,CAAC;AAC9D,MAAM,SAAS,GAAG,OAAO,CACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CACjE,CAAC;AACF,MAAM,WAAW,GAAG,MAAM,CACxB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CACnE,CAAC;AACF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,GAAG,CAAC,CAAC;AACpE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,GAAG,CAAC;AAEtD,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;AACjE,MAAM,MAAM,GAAG,mBAAmB,CAAC;IACjC,KAAK;IACL,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QAClB,IAAI,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,eAAe,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;IAC7B,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,GAAS,EAAE;IAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@craft-ts/log-server",
+  "version": "0.7.0-beta.15",
+  "description": "Local JSONL log ingestion server for CraftTS development",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "!dist/**/*.spec.js",
+    "!dist/**/*.spec.d.ts",
+    "!dist/**/*.spec.js.map"
+  ],
+  "bin": {
+    "craft-ts-log-server": "dist/main.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "npm run build && node dist/main.js",
+    "test": "vitest run --config vitest.config.mts"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.9",
+    "typescript": "6.0.3",
+    "vitest": "^4.0.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}