parasor 0.1.0

package/server/debug/agent-status-recorder.js

@@ -0,0 +1,209 @@
+import { promises as fsp, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+const DEFAULT_MAX_FILE_BYTES = 5 * 1024 * 1024;
+const DEFAULT_MAX_EVENT_BYTES = 64 * 1024;
+const MAX_PAYLOAD_STRING_CHARS = 4096;
+const MAX_PAYLOAD_ARRAY_ITEMS = 20;
+const MAX_PAYLOAD_OBJECT_KEYS = 50;
+const MAX_PAYLOAD_DEPTH = 4;
+export class AgentStatusRecorder {
+    events = [];
+    maxEvents;
+    now;
+    logPath;
+    maxFileBytes;
+    maxEventBytes;
+    seq = 0;
+    writeQueue = [];
+    writing = false;
+    writtenBytes = 0;
+    constructor(options) {
+        this.maxEvents = options?.maxEvents ?? 1000;
+        this.now = options?.now ?? (() => Date.now());
+        this.logPath = options?.logPath;
+        this.maxFileBytes = options?.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;
+        this.maxEventBytes = options?.maxEventBytes ?? DEFAULT_MAX_EVENT_BYTES;
+        if (this.logPath) {
+            try {
+                mkdirSync(dirname(this.logPath), { recursive: true });
+            }
+            catch {
+                // Disk errors must never break startup -- debug log is best-effort.
+            }
+        }
+    }
+    record(type, payload, sessionId) {
+        const event = this.boundEvent({
+            seq: ++this.seq,
+            timestamp: this.now(),
+            type,
+            sessionId,
+            payload: sanitizePayloadObject(payload),
+        });
+        this.events.push(event);
+        if (this.events.length > this.maxEvents) {
+            this.events.splice(0, this.events.length - this.maxEvents);
+        }
+        this.enqueueWrite(event);
+    }
+    recordState(state) {
+        this.record("detector-state", {
+            lifecycle: state.lifecycle,
+            source: state.source,
+            confidence: state.confidence,
+            detectedAt: state.detectedAt,
+        }, state.sessionId);
+    }
+    list() {
+        return [...this.events];
+    }
+    /**
+     * Return events with `seq > since`. Cheap linear scan because the buffer
+     * is capped at {@link maxEvents}. Used by the debug HTTP endpoint so
+     * clients can poll without reshipping the whole history.
+     */
+    listSince(since) {
+        if (!Number.isFinite(since))
+            return this.list();
+        return this.events.filter((event) => event.seq > since);
+    }
+    clear() {
+        this.events.length = 0;
+    }
+    async clearPersistedLog() {
+        if (!this.logPath)
+            return;
+        this.writeQueue.length = 0;
+        await this.flush();
+        try {
+            await fsp.rm(this.logPath, { force: true });
+            await fsp.rm(`${this.logPath}.1`, { force: true });
+            this.writtenBytes = 0;
+        }
+        catch {
+            // Best-effort debug cleanup. The in-memory clear has already happened.
+        }
+    }
+    /**
+     * Flush queued JSONL writes. Returns a promise that resolves when the
+     * current drain completes. Best-effort: disk failures swallow silently.
+     */
+    async flush() {
+        while (this.writing || this.writeQueue.length > 0) {
+            await new Promise((resolve) => setImmediate(resolve));
+        }
+    }
+    enqueueWrite(event) {
+        if (!this.logPath)
+            return;
+        const line = this.stringifyEvent(event);
+        if (!line)
+            return;
+        this.writeQueue.push(`${line}\n`);
+        if (!this.writing)
+            void this.drain();
+    }
+    async drain() {
+        if (!this.logPath)
+            return;
+        this.writing = true;
+        try {
+            while (this.writeQueue.length > 0) {
+                const batch = this.writeQueue.splice(0, this.writeQueue.length);
+                const data = batch.join("");
+                try {
+                    await fsp.appendFile(this.logPath, data, "utf8");
+                    this.writtenBytes += Buffer.byteLength(data, "utf8");
+                    if (this.writtenBytes >= this.maxFileBytes) {
+                        await this.rotate();
+                    }
+                }
+                catch {
+                    // Disk-write failure must never throw into the recorder caller.
+                }
+            }
+        }
+        finally {
+            this.writing = false;
+        }
+    }
+    async rotate() {
+        if (!this.logPath)
+            return;
+        const archived = `${this.logPath}.1`;
+        try {
+            await fsp.rm(archived, { force: true });
+            await fsp.rename(this.logPath, archived);
+        }
+        catch {
+            // If rotation fails, fall through -- next write will just keep
+            // appending past the soft cap rather than silently dropping events.
+        }
+        this.writtenBytes = 0;
+    }
+    boundEvent(event) {
+        const serialized = this.stringifyEvent(event);
+        if (!serialized) {
+            return {
+                ...event,
+                payload: {
+                    truncated: true,
+                    reason: "unserializable payload",
+                },
+            };
+        }
+        const bytes = Buffer.byteLength(serialized, "utf8");
+        if (bytes <= this.maxEventBytes)
+            return event;
+        return {
+            ...event,
+            payload: {
+                truncated: true,
+                originalBytes: bytes,
+                keys: Object.keys(event.payload).slice(0, 20),
+            },
+        };
+    }
+    stringifyEvent(event) {
+        try {
+            return JSON.stringify(event);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function sanitizePayloadObject(payload) {
+    return sanitizePayloadValue(payload, 0, new WeakSet());
+}
+function sanitizePayloadValue(value, depth, seen) {
+    if (typeof value === "string") {
+        if (value.length <= MAX_PAYLOAD_STRING_CHARS)
+            return value;
+        return `${value.slice(0, MAX_PAYLOAD_STRING_CHARS)}…`;
+    }
+    if (value === null ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (depth >= MAX_PAYLOAD_DEPTH)
+        return "[truncated-depth]";
+    if (Array.isArray(value)) {
+        return value
+            .slice(0, MAX_PAYLOAD_ARRAY_ITEMS)
+            .map((item) => sanitizePayloadValue(item, depth + 1, seen));
+    }
+    if (typeof value === "object") {
+        if (seen.has(value))
+            return "[circular]";
+        seen.add(value);
+        const out = {};
+        for (const [key, entry] of Object.entries(value).slice(0, MAX_PAYLOAD_OBJECT_KEYS)) {
+            out[key] = sanitizePayloadValue(entry, depth + 1, seen);
+        }
+        return out;
+    }
+    return String(value);
+}
+//# sourceMappingURL=agent-status-recorder.js.map

package/server/debug/agent-status-recorder.js.map

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

package/server/debug/terminal-trace-recorder.d.ts

@@ -0,0 +1,41 @@
+export type TerminalTraceEventType = "session-create-request" | "session-create-complete" | "session-create-failed" | "session-delete-request" | "session-delete-complete" | "session-delete-failed" | "ws-setup" | "ws-cleanup" | "ws-cleanup-skip" | "ws-message" | "ws-init" | "ws-init-ack" | "ws-replay" | "ws-output" | "ws-close" | "pty-attach-start" | "pty-attach-complete" | "pty-attach-failed" | "pty-attach-abandoned" | "pty-write" | "pty-resize" | "pty-refresh" | "pty-flow" | "malformed-frame" | "client-event" | "client-diagnostic" | "probe-start" | "probe-finish";
+export interface TerminalTraceEvent {
+    seq: number;
+    timestamp: number;
+    type: TerminalTraceEventType;
+    sessionId?: string;
+    clientId?: string;
+    payload: Record<string, unknown>;
+}
+interface TerminalTraceRecorderOptions {
+    enabled?: boolean;
+    maxEvents?: number;
+    now?: () => number;
+}
+export declare class TerminalTraceRecorder {
+    private readonly events;
+    private readonly maxEvents;
+    private readonly now;
+    private seq;
+    private enabled;
+    private start;
+    private count;
+    constructor(options?: TerminalTraceRecorderOptions);
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+    record(type: TerminalTraceEventType, payload?: Record<string, unknown>, ids?: {
+        sessionId?: string;
+        clientId?: string;
+    }): void;
+    recordLazy(type: TerminalTraceEventType, payload: () => Record<string, unknown>, ids?: {
+        sessionId?: string;
+        clientId?: string;
+    }): void;
+    private push;
+    list(): TerminalTraceEvent[];
+    listSince(since: number): TerminalTraceEvent[];
+    clear(): void;
+    summary(): Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=terminal-trace-recorder.d.ts.map

package/server/debug/terminal-trace-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-trace-recorder.d.ts","sourceRoot":"","sources":["../../src/debug/terminal-trace-recorder.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,wBAAwB,GACxB,yBAAyB,GACzB,uBAAuB,GACvB,wBAAwB,GACxB,yBAAyB,GACzB,uBAAuB,GACvB,UAAU,GACV,YAAY,GACZ,iBAAiB,GACjB,YAAY,GACZ,SAAS,GACT,aAAa,GACb,WAAW,GACX,WAAW,GACX,UAAU,GACV,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,sBAAsB,GACtB,WAAW,GACX,YAAY,GACZ,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,cAAc,GACd,mBAAmB,GACnB,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,UAAU,4BAA4B;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAMD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;gBAEN,OAAO,CAAC,EAAE,4BAA4B;IAOlD,SAAS,IAAI,OAAO;IAIpB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,MAAM,CACJ,IAAI,EAAE,sBAAsB,EAC5B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,GAAG,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAClD,IAAI;IAWP,UAAU,CACR,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,GAAG,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAClD,IAAI;IAKP,OAAO,CAAC,IAAI;IAUZ,IAAI,IAAI,kBAAkB,EAAE;IAQ5B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAK9C,KAAK,IAAI,IAAI;IAKb,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAenC"}

package/server/debug/terminal-trace-recorder.js

@@ -0,0 +1,112 @@
+const DEFAULT_MAX_EVENTS = 2000;
+const MAX_PAYLOAD_KEYS = 40;
+const MAX_PAYLOAD_DEPTH = 7;
+export class TerminalTraceRecorder {
+    events;
+    maxEvents;
+    now;
+    seq = 0;
+    enabled;
+    start = 0;
+    count = 0;
+    constructor(options) {
+        this.enabled = options?.enabled ?? false;
+        this.maxEvents = options?.maxEvents ?? DEFAULT_MAX_EVENTS;
+        this.events = new Array(this.maxEvents);
+        this.now = options?.now ?? (() => Date.now());
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    record(type, payload = {}, ids = {}) {
+        if (!this.enabled)
+            return;
+        this.push({
+            seq: ++this.seq,
+            timestamp: this.now(),
+            type,
+            ...ids,
+            payload: sanitizePayloadObject(payload),
+        });
+    }
+    recordLazy(type, payload, ids = {}) {
+        if (!this.enabled)
+            return;
+        this.record(type, payload(), ids);
+    }
+    push(event) {
+        if (this.count < this.maxEvents) {
+            this.events[(this.start + this.count) % this.maxEvents] = event;
+            this.count += 1;
+            return;
+        }
+        this.events[this.start] = event;
+        this.start = (this.start + 1) % this.maxEvents;
+    }
+    list() {
+        const out = [];
+        for (let i = 0; i < this.count; i++) {
+            out.push(this.events[(this.start + i) % this.maxEvents]);
+        }
+        return out;
+    }
+    listSince(since) {
+        if (!Number.isFinite(since))
+            return this.list();
+        return this.list().filter((event) => event.seq > since);
+    }
+    clear() {
+        this.start = 0;
+        this.count = 0;
+    }
+    summary() {
+        const byType = {};
+        const events = this.list();
+        for (const event of events) {
+            byType[event.type] = (byType[event.type] ?? 0) + 1;
+        }
+        return {
+            enabled: this.enabled,
+            maxEvents: this.maxEvents,
+            eventCount: this.count,
+            firstSeq: events[0]?.seq ?? null,
+            lastSeq: events.at(-1)?.seq ?? null,
+            byType,
+        };
+    }
+}
+function sanitizePayloadObject(payload) {
+    return sanitizePayloadValue(payload, 0, new WeakSet());
+}
+function sanitizePayloadValue(value, depth, seen) {
+    if (value === null ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "string") {
+        return value.length <= 200 ? value : `${value.slice(0, 200)}...`;
+    }
+    if (depth >= MAX_PAYLOAD_DEPTH)
+        return "[truncated-depth]";
+    if (Array.isArray(value)) {
+        return value
+            .slice(0, 20)
+            .map((item) => sanitizePayloadValue(item, depth + 1, seen));
+    }
+    if (typeof value === "object") {
+        if (seen.has(value))
+            return "[circular]";
+        seen.add(value);
+        const out = {};
+        for (const [key, entry] of Object.entries(value).slice(0, MAX_PAYLOAD_KEYS)) {
+            out[key] = sanitizePayloadValue(entry, depth + 1, seen);
+        }
+        return out;
+    }
+    return String(value);
+}
+//# sourceMappingURL=terminal-trace-recorder.js.map

package/server/debug/terminal-trace-recorder.js.map

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

package/server/fonts/catalog.d.ts

@@ -0,0 +1,35 @@
+export interface FontPreset {
+    id: string;
+    /** Display name for UI. */
+    name: string;
+    /** Category controls the UI grouping (2:1 CJK vs. Latin-only). */
+    category: "asian" | "latin";
+    /** CSS font-family value the `@font-face` rule will declare. */
+    family: string;
+    /** Direct GitHub release asset URL. */
+    zipUrl: string;
+    /** Substring used to locate the Regular-weight TTF inside the zip. */
+    regularMatch: string;
+    /**
+     * Rough zip download size in MB, shown in the UI so the user can make an
+     * informed choice before a large download starts.
+     */
+    zipSizeMb: number;
+    /**
+     * Short description highlighting why a user might pick this preset.
+     */
+    description: string;
+}
+export declare const FONT_PRESETS: readonly FontPreset[];
+export declare function findPreset(id: string): FontPreset | undefined;
+export declare function isValidPresetId(id: unknown): id is string;
+export interface PublicFontPreset {
+    id: string;
+    name: string;
+    category: "asian" | "latin";
+    family: string;
+    zipSizeMb: number;
+    description: string;
+}
+export declare function toPublicPreset(preset: FontPreset): PublicFontPreset;
+//# sourceMappingURL=catalog.d.ts.map

package/server/fonts/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/fonts/catalog.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAwDpC,CAAC;AAEX,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7D;AASD,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAEzD;AAQD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CASnE"}

package/server/fonts/catalog.js

@@ -0,0 +1,76 @@
+export const FONT_PRESETS = [
+    {
+        id: "udev-gothic",
+        name: "UDEV Gothic",
+        category: "asian",
+        family: "UDEV Gothic",
+        zipUrl: "https://github.com/yuru7/udev-gothic/releases/download/v2.2.0/UDEVGothic_v2.2.0.zip",
+        regularMatch: "UDEVGothic-Regular",
+        zipSizeMb: 59,
+        description: "JetBrains Mono + BIZ UDGothic. Japanese, 2:1 CJK alignment.",
+    },
+    {
+        id: "d2-coding",
+        name: "D2 Coding",
+        category: "asian",
+        family: "D2 Coding",
+        zipUrl: "https://github.com/naver/d2codingfont/releases/download/VER1.3.2/D2Coding-Ver1.3.2-20180524.zip",
+        regularMatch: "D2Coding/D2Coding-Ver",
+        zipSizeMb: 20,
+        description: "Naver D2 Coding. Korean coding font with Hangul support.",
+    },
+    {
+        id: "maple-mono-cn",
+        name: "Maple Mono CN",
+        category: "asian",
+        family: "Maple Mono CN",
+        zipUrl: "https://github.com/subframe7536/maple-font/releases/download/v7.9/MapleMono-CN.zip",
+        regularMatch: "MapleMono-CN-Regular",
+        zipSizeMb: 134,
+        description: "Maple Mono with Simplified Chinese coverage.",
+    },
+    {
+        id: "jetbrains-mono",
+        name: "JetBrains Mono",
+        category: "latin",
+        family: "JetBrains Mono",
+        zipUrl: "https://github.com/JetBrains/JetBrainsMono/releases/download/v2.304/JetBrainsMono-2.304.zip",
+        regularMatch: "JetBrainsMono-Regular",
+        zipSizeMb: 5,
+        description: "Popular coding font with ligatures and clear punctuation.",
+    },
+    {
+        id: "fira-code",
+        name: "Fira Code",
+        category: "latin",
+        family: "Fira Code",
+        zipUrl: "https://github.com/tonsky/FiraCode/releases/download/6.2/Fira_Code_v6.2.zip",
+        regularMatch: "FiraCode-Regular",
+        zipSizeMb: 3,
+        description: "Monospace font with programming ligatures.",
+    },
+];
+export function findPreset(id) {
+    return FONT_PRESETS.find((preset) => preset.id === id);
+}
+/*
+ * Guard for URL path segments that get joined with the cache directory. An
+ * id that contains `..`, `/`, or `\` would allow an attacker-controlled
+ * install request to write outside the cache root, so the id must match the
+ * whitelist exactly. Defense-in-depth on top of findPreset -- the id also
+ * has to exist in the preset table.
+ */
+export function isValidPresetId(id) {
+    return typeof id === "string" && FONT_PRESETS.some((p) => p.id === id);
+}
+export function toPublicPreset(preset) {
+    return {
+        id: preset.id,
+        name: preset.name,
+        category: preset.category,
+        family: preset.family,
+        zipSizeMb: preset.zipSizeMb,
+        description: preset.description,
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/server/fonts/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/fonts/catalog.ts"],"names":[],"mappings":"AAuCA,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,aAAa;QACrB,MAAM,EACJ,qFAAqF;QACvF,YAAY,EAAE,oBAAoB;QAClC,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,6DAA6D;KAC3E;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,WAAW;QACnB,MAAM,EACJ,iGAAiG;QACnG,YAAY,EAAE,uBAAuB;QACrC,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,0DAA0D;KACxE;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,eAAe;QACvB,MAAM,EACJ,oFAAoF;QACtF,YAAY,EAAE,sBAAsB;QACpC,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,8CAA8C;KAC5D;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,gBAAgB;QACxB,MAAM,EACJ,6FAA6F;QAC/F,YAAY,EAAE,uBAAuB;QACrC,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,2DAA2D;KACzE;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,WAAW;QACnB,MAAM,EACJ,6EAA6E;QAC/E,YAAY,EAAE,kBAAkB;QAChC,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,4CAA4C;KAC1D;CACO,CAAC;AAEX,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,EAAW;IACzC,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACzE,CAAC;AAiBD,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;AACJ,CAAC"}

package/server/fonts/installer.d.ts

@@ -0,0 +1,45 @@
+import type { FontPreset } from "./catalog.js";
+export interface InstallResult {
+    id: string;
+    family: string;
+    filename: string;
+    /** Absolute path of the cached TTF on disk. */
+    filePath: string;
+}
+export declare class FontInstallError extends Error {
+    readonly kind: "download_failed" | "asset_not_found" | "extract_failed" | "io_failed";
+    constructor(message: string, kind: "download_failed" | "asset_not_found" | "extract_failed" | "io_failed");
+}
+export interface InstallerOptions {
+    /** Override for tests so they can stub the download. */
+    fetchImpl?: typeof fetch;
+    /** Override cache root -- defaults to ~/.cache/parasor/fonts. */
+    cacheDir?: string;
+}
+export declare function defaultCacheDir(): string;
+export declare class FontInstaller {
+    private readonly cacheDir;
+    private readonly fetchImpl;
+    private readonly inflight;
+    constructor(opts?: InstallerOptions);
+    getCacheDir(): string;
+    /**
+     * Path of the cached TTF if already installed, otherwise null. Used by the
+     * static serving route to short-circuit without touching the installer.
+     */
+    resolveInstalled(id: string): Promise<{
+        filePath: string;
+        family: string;
+    } | null>;
+    listInstalled(): Promise<string[]>;
+    /**
+     * Install a preset. Concurrent calls for the same id share a single
+     * download -- the second caller awaits the first rather than kicking off a
+     * duplicate 700MB fetch.
+     */
+    install(preset: FontPreset): Promise<InstallResult>;
+    private doInstall;
+    private downloadTo;
+    private extractRegularTtf;
+}
+//# sourceMappingURL=installer.d.ts.map

package/server/fonts/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/fonts/installer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAqB/C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,IAAI,EACT,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,WAAW;gBALf,OAAO,EAAE,MAAM,EACN,IAAI,EACT,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,WAAW;CAIlB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;gBAE1D,IAAI,GAAE,gBAAqB;IAKvC,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACG,gBAAgB,CACpB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAoBjD,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBxC;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;YAU3C,SAAS;YAqCT,UAAU;IAgCxB,OAAO,CAAC,iBAAiB;CAmF1B"}