@webda/content-mapper 0.0.0-stage → 4.0.0-beta.5

package/lib/schema/worker.d.ts

@@ -0,0 +1,81 @@
+import type { JSONSchema7 } from "./types.ts";
+/** A single schema request. */
+export interface SchemaRequest {
+    /** Caller-chosen key, echoed in the response. */
+    id: string;
+    /**
+     * What to generate. `topLevel` needs no class and answers with a map;
+     * `module` needs no class and answers with the whole `webda.module.json`
+     * as `{ module, namingViolations, errors }`.
+     */
+    kind: "service" | "model" | "topLevel" | "module" | "emit";
+    /** Absolute path of the file declaring the class. */
+    file: string;
+    /** Class to generate for. */
+    className: string;
+    /** Add the free-form `openapi` property; moddas and beans only. */
+    addOpenApi?: boolean;
+    /** Base type the parameters derive from; `DeployerResources` for deployers. */
+    parametersBase?: string;
+    /** Source root, for a `topLevel` or `module` request. */
+    rootDir?: string;
+    /** Output root, for a `topLevel` or `module` request. */
+    outDir?: string;
+    /** Namespace prefix, for a `topLevel` or `module` request. */
+    namespace?: string;
+    /** Top-level `capabilities`, for a `module` request; defaults to package.json `webda.capabilities`. */
+    capabilities?: Record<string, string>;
+}
+/** A batch of requests against one project. */
+export interface WorkerRequest {
+    /** Project root, or an explicit tsconfig path. */
+    project: string;
+    /** Requests to answer. */
+    requests: SchemaRequest[];
+}
+/** The worker's reply. */
+export interface WorkerResponse {
+    /** Successful results, keyed by request id. */
+    results: Record<string, JSONSchema7>;
+    /** Failures, keyed by request id. */
+    errors: Record<string, string>;
+}
+/**
+ * Answer a batch of requests.
+ *
+ * One session, and therefore one `Program`, is built per batch — the caller
+ * batches precisely so that cost is paid once.
+ * @param request - the batch
+ * @returns results and per-request errors
+ */
+export declare function handle(request: WorkerRequest): WorkerResponse;
+/** What an `emit` request reports. */
+export interface EmitReport {
+    /** Pass-2 diagnostics, formatted as `tsc` would print them. */
+    diagnostics: string;
+    /** Number of diagnostics; nothing is written unless it is zero. */
+    diagnosticCount: number;
+    /** Files written. */
+    written: number;
+    /** Edits per generator, for the build log. */
+    editCounts: Record<string, number>;
+}
+/**
+ * Build a project through the two-pass tsgo pipeline and write its output.
+ *
+ * Replaces `tsProgram.emit` with the four `@webda/ts-plugin` transformers.
+ * Pass 1 plans the generated code over the authored sources; pass 2 type-
+ * checks and emits the rewritten text, so what ships is exactly what was
+ * checked. If pass 2 reports anything, nothing is written — the old emit
+ * wrote files even when `getPreEmitDiagnostics` failed.
+ * @param configFile - absolute tsconfig path
+ * @param rootDir - source root
+ * @returns diagnostics and what was written
+ */
+export declare function emitProject(configFile: string, rootDir: string): EmitReport;
+/**
+ * Read one request from stdin and write one response to stdout.
+ * @returns a promise resolving when the response is written
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=worker.d.ts.map

package/lib/schema/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/schema/worker.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3D,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAuE7D;AAYD,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAmB3E;AAuBD;;;GAGG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1C"}

package/lib/schema/worker.js

@@ -0,0 +1,186 @@
+/**
+ * Out-of-process schema generation on the TypeScript 7.1 checker.
+ *
+ * `@webda/compiler` drives this as a subprocess rather than importing it.
+ * That is not indirection for its own sake: the compiler still runs on
+ * TypeScript 6 and this package needs 7.1, a package can declare only one
+ * `typescript`, and a process boundary is the only thing that lets the two
+ * coexist until the atomic switch.
+ *
+ * It began as a way to diff against `@webda/schema`, which generated these
+ * schemas before and has since been deleted; the protocol shape is
+ * unchanged from that comparison, which is why it names things rather than
+ * passing them.
+ *
+ * Protocol: one JSON request on stdin, one JSON response on stdout.
+ *
+ * ```
+ * { "project": "/abs/path", "requests": [
+ *     { "id": "Webda/Store", "kind": "service", "file": "/abs/f.ts",
+ *       "className": "Store", "addOpenApi": true }
+ * ]}
+ * -> { "results": { "Webda/Store": { } }, "errors": { } }
+ * ```
+ *
+ * `{ "id": "m", "kind": "module" }` answers with
+ * `{ module, namingViolations, errors }` — see `../module.ts`.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { formatDiagnostics } from "typescript/unstable/sync";
+import { runTwoPass } from "../twopass.js";
+import { ModifierFlags } from "typescript/unstable/ast";
+import * as is from "typescript/unstable/ast/is";
+import { openSession } from "../context.js";
+import { generateWebdaModule } from "../module.js";
+import { generateModelSchemas } from "./model.js";
+import { generateTopLevelSchemas, namespaceOf } from "./project.js";
+import { generateServiceSchema } from "./service.js";
+/**
+ * Answer a batch of requests.
+ *
+ * One session, and therefore one `Program`, is built per batch — the caller
+ * batches precisely so that cost is paid once.
+ * @param request - the batch
+ * @returns results and per-request errors
+ */
+export function handle(request) {
+    const response = { results: {}, errors: {} };
+    const configFile = request.project.endsWith(".json") ? request.project : join(request.project, "tsconfig.json");
+    const session = openSession(configFile, request.project);
+    try {
+        for (const item of request.requests) {
+            try {
+                if (item.kind === "topLevel") {
+                    // Answers with the whole map: these entries record no provenance,
+                    // so the caller cannot name them one at a time.
+                    response.results[item.id] = generateTopLevelSchemas(session.ctx, {
+                        appPath: request.project,
+                        rootDir: item.rootDir ?? join(request.project, "src"),
+                        outDir: item.outDir ?? join(request.project, "lib"),
+                        namespace: item.namespace ?? namespaceOf(request.project)
+                    });
+                    continue;
+                }
+                if (item.kind === "emit") {
+                    response.results[item.id] = emitProject(configFile, item.rootDir ?? join(request.project, "src"));
+                    continue;
+                }
+                if (item.kind === "module") {
+                    // The whole module in one answer; naming violations and errors
+                    // travel with it so the caller decides how to report them.
+                    response.results[item.id] = generateWebdaModule(session.ctx, {
+                        appPath: request.project,
+                        rootDir: item.rootDir ?? join(request.project, "src"),
+                        outDir: item.outDir ?? join(request.project, "lib"),
+                        namespace: item.namespace ?? namespaceOf(request.project),
+                        capabilities: item.capabilities
+                    });
+                    continue;
+                }
+                const declaration = findClass(session.ctx.program, item.file, item.className);
+                if (!declaration) {
+                    response.errors[item.id] = `class ${item.className} not found in ${item.file}`;
+                    continue;
+                }
+                if (item.kind === "model") {
+                    response.results[item.id] = generateModelSchemas(declaration, {
+                        project: session.ctx.project,
+                        checker: session.ctx.checker
+                    });
+                    continue;
+                }
+                const schema = generateServiceSchema(declaration, {
+                    project: session.ctx.project,
+                    checker: session.ctx.checker,
+                    addOpenApi: item.addOpenApi,
+                    parametersBase: item.parametersBase,
+                    // The declaration's own name, not the requested one: a default
+                    // export is requested as `"default"` but titled after the class.
+                    title: declaration.name?.text ?? item.className
+                });
+                if (!schema) {
+                    response.errors[item.id] = `no parameters type found on ${item.className}`;
+                    continue;
+                }
+                response.results[item.id] = schema;
+            }
+            catch (error) {
+                // Per-request isolation, so one unconvertible type does not hide the
+                // rest of the batch. The converter still refuses to emit for it.
+                response.errors[item.id] = error instanceof Error ? error.message : String(error);
+            }
+        }
+    }
+    finally {
+        session.dispose();
+    }
+    return response;
+}
+/**
+ * Build a project through the two-pass tsgo pipeline and write its output.
+ *
+ * Replaces `tsProgram.emit` with the four `@webda/ts-plugin` transformers.
+ * Pass 1 plans the generated code over the authored sources; pass 2 type-
+ * checks and emits the rewritten text, so what ships is exactly what was
+ * checked. If pass 2 reports anything, nothing is written — the old emit
+ * wrote files even when `getPreEmitDiagnostics` failed.
+ * @param configFile - absolute tsconfig path
+ * @param rootDir - source root
+ * @returns diagnostics and what was written
+ */
+export function emitProject(configFile, rootDir) {
+    const result = runTwoPass({ configFile, rootDir, emit: true });
+    const conflicts = result.conflicts.map(c => `${c.fileName}: overlapping edits from ${c.a.source} and ${c.b.source}`);
+    const diagnostics = formatDiagnostics(result.diagnostics, {
+        getCanonicalFileName: name => name,
+        getCurrentDirectory: () => dirname(configFile),
+        getNewLine: () => "\n"
+    }) + conflicts.join("\n");
+    const diagnosticCount = result.diagnostics.length + conflicts.length;
+    let written = 0;
+    if (diagnosticCount === 0) {
+        for (const [path, text] of result.emitted) {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, text);
+            written++;
+        }
+    }
+    return { diagnostics, diagnosticCount, written, editCounts: result.editCounts };
+}
+/**
+ * Find a class declaration by file and name.
+ * @param program - the program to search
+ * @param file - absolute file path
+ * @param className - class name
+ * @returns the declaration, when found
+ */
+function findClass(program, file, className) {
+    const sourceFile = program.getSourceFile(file);
+    if (!sourceFile)
+        return undefined;
+    for (const statement of sourceFile.statements) {
+        const node = statement;
+        if (!is.isClassDeclaration(node))
+            continue;
+        if (node.name?.text === className)
+            return node;
+        // `webda.module.json` records a default export as `:default`, so there is
+        // no name to match on — the modifier is the only handle.
+        if (className === "default" && (node.modifierFlags & ModifierFlags.Default) !== 0)
+            return node;
+    }
+    return undefined;
+}
+/**
+ * Read one request from stdin and write one response to stdout.
+ * @returns a promise resolving when the response is written
+ */
+export async function main() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    const request = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+    process.stdout.write(JSON.stringify(handle(request)));
+}
+//# sourceMappingURL=worker.js.map

package/lib/schema/worker.js.map

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

package/lib/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/lib/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/lib/server.js

@@ -0,0 +1,133 @@
+/**
+ * The content mapper process.
+ *
+ * Speaks the TypeScript 7.1 content mapper protocol over stdio (JSON-RPC with
+ * LSP-style `Content-Length` framing). TypeScript drives every exchange:
+ * `initialize` -> `openProject` -> `transform`* -> `closeProject`. Mappers never
+ * send requests.
+ *
+ * All the interesting work is in {@link WarmSession}; this file is transport,
+ * project bookkeeping and timing instrumentation.
+ *
+ * Diagnostics go to a log file rather than stderr, because stderr is consumed by
+ * the compiler as mapper log output.
+ */
+import { appendFileSync } from "node:fs";
+import { WarmSession } from "./session.js";
+const LOG = process.env.WEBDA_MAPPER_LOG;
+/**
+ * Append a line to the debug log, if one is configured.
+ * @param parts - message parts
+ */
+function log(...parts) {
+    if (!LOG)
+        return;
+    appendFileSync(LOG, parts.map(p => (typeof p === "string" ? p : JSON.stringify(p))).join(" ") + "\n");
+}
+const projects = new Map();
+/**
+ * Write a JSON-RPC message with `Content-Length` framing.
+ * @param message - the message
+ */
+function send(message) {
+    const body = JSON.stringify(message);
+    process.stdout.write(`Content-Length: ${Buffer.byteLength(body, "utf8")}\r\n\r\n${body}`);
+}
+/**
+ * Handle one request and reply.
+ * @param message - the decoded request
+ */
+function handle(message) {
+    const { id, method, params } = message;
+    try {
+        let result;
+        switch (method) {
+            case "initialize":
+                // UTF-16 matches JavaScript string offsets exactly, so no re-encoding.
+                result = {
+                    positionEncoding: params.positionEncodings.includes("utf-16") ? "utf-16" : params.positionEncodings[0],
+                    diagnosticSource: "webda"
+                };
+                break;
+            case "openProject": {
+                const session = new WarmSession({
+                    configFile: params.configFileName,
+                    cwd: params.configFileName.replace(/[/\\][^/\\]+$/, ""),
+                    storageModule: params.options?.storageModule ?? "@webda/models",
+                    qlModule: params.options?.qlModule,
+                    accessorsForAll: !!params.options?.accessorsForAll
+                });
+                projects.set(params.projectHandle, { session, transforms: 0, timings: [] });
+                log("openProject", params.configFileName, `startup=${session.startupMs.toFixed(0)}ms`, `files=${session.fileCount}`);
+                result = {};
+                break;
+            }
+            case "transform": {
+                const entry = projects.get(params.projectHandle);
+                if (!entry)
+                    throw new Error(`unknown projectHandle ${params.projectHandle}`);
+                const outcome = entry.session.transform(params.fileName, params.content);
+                entry.transforms++;
+                entry.timings.push(outcome.timing);
+                const t = outcome.timing;
+                log("transform", params.fileName.replace(/^.*\//, ""), `edits=${outcome.editCount}`, `spans=${outcome.mappings.length}`, `total=${t.totalMs.toFixed(1)}ms`, `(snapshot=${t.snapshotMs.toFixed(1)} analyze=${t.analyzeMs.toFixed(1)} splice=${t.spliceMs.toFixed(2)})`, t.changed ? "changed" : "cached");
+                // `diagnostics` reports problems against the *authored* file, which is
+                // how a generator surfaces something it cannot fix by rewriting.
+                result = {
+                    text: outcome.text,
+                    extension: ".ts",
+                    mappings: outcome.mappings,
+                    ...(outcome.diagnostics.length ? { diagnostics: outcome.diagnostics } : {})
+                };
+                break;
+            }
+            case "closeProject": {
+                const entry = projects.get(params.projectHandle);
+                if (entry) {
+                    entry.session.dispose();
+                    projects.delete(params.projectHandle);
+                    log("closeProject", `transforms=${entry.transforms}`);
+                }
+                result = {};
+                break;
+            }
+            default:
+                send({ jsonrpc: "2.0", id, error: { code: -32601, message: `unknown method ${method}` } });
+                return;
+        }
+        if (id !== undefined)
+            send({ jsonrpc: "2.0", id, result });
+    }
+    catch (error) {
+        log("ERROR", method, error?.stack ?? String(error));
+        if (id !== undefined)
+            send({ jsonrpc: "2.0", id, error: { code: -32603, message: String(error?.message ?? error) } });
+    }
+}
+let buffer = Buffer.alloc(0);
+process.stdin.on("data", (chunk) => {
+    buffer = Buffer.concat([buffer, chunk]);
+    for (;;) {
+        const headerEnd = buffer.indexOf("\r\n\r\n");
+        if (headerEnd < 0)
+            return;
+        const header = buffer.subarray(0, headerEnd).toString("ascii");
+        const match = /Content-Length:\s*(\d+)/i.exec(header);
+        if (!match) {
+            log("malformed header", header);
+            process.exit(1);
+        }
+        const length = Number(match[1]);
+        if (buffer.length < headerEnd + 4 + length)
+            return;
+        const body = buffer.subarray(headerEnd + 4, headerEnd + 4 + length).toString("utf8");
+        buffer = buffer.subarray(headerEnd + 4 + length);
+        handle(JSON.parse(body));
+    }
+});
+process.on("exit", () => {
+    for (const entry of projects.values())
+        entry.session.dispose();
+});
+log("mapper started", process.argv.join(" "));
+//# sourceMappingURL=server.js.map

package/lib/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,WAAW,EAAwB,MAAM,cAAc,CAAC;AAEjE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAEzC;;;GAGG;AACH,SAAS,GAAG,CAAC,GAAG,KAAgB;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AACxG,CAAC;AASD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEjD;;;GAGG;AACH,SAAS,IAAI,CAAC,OAAgB;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM,CAAC,OAAY;IAC1B,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACvC,IAAI,CAAC;QACH,IAAI,MAAe,CAAC;QACpB,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,YAAY;gBACf,uEAAuE;gBACvE,MAAM,GAAG;oBACP,gBAAgB,EAAE,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;oBACtG,gBAAgB,EAAE,OAAO;iBAC1B,CAAC;gBACF,MAAM;YAER,KAAK,aAAa,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;oBAC9B,UAAU,EAAE,MAAM,CAAC,cAAc;oBACjC,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;oBACvD,aAAa,EAAG,MAAM,CAAC,OAAO,EAAE,aAAwB,IAAI,eAAe;oBAC3E,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,QAAkB;oBAC5C,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe;iBACnD,CAAC,CAAC;gBACH,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC5E,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,WAAW,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;gBACrH,MAAM,GAAG,EAAE,CAAC;gBACZ,MAAM;YACR,CAAC;YAED,KAAK,WAAW,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBACjD,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;gBAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBACzE,KAAK,CAAC,UAAU,EAAE,CAAC;gBACnB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;gBACzB,GAAG,CACD,WAAW,EACX,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EACpC,SAAS,OAAO,CAAC,SAAS,EAAE,EAC5B,SAAS,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,EAClC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EACjC,aAAa,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EACzG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CACjC,CAAC;gBACF,uEAAuE;gBACvE,iEAAiE;gBACjE,MAAM,GAAG;oBACP,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,SAAS,EAAE,KAAK;oBAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5E,CAAC;gBACF,MAAM;YACR,CAAC;YAED,KAAK,cAAc,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBACjD,IAAI,KAAK,EAAE,CAAC;oBACV,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBACxB,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;oBACtC,GAAG,CAAC,cAAc,EAAE,cAAc,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;gBACxD,CAAC;gBACD,MAAM,GAAG,EAAE,CAAC;gBACZ,MAAM;YACR,CAAC;YAED;gBACE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC3F,OAAO;QACX,CAAC;QACD,IAAI,EAAE,KAAK,SAAS;YAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,IAAI,EAAE,KAAK,SAAS;YAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACxH,CAAC;AACH,CAAC;AAED,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;IACzC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACxC,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,SAAS,GAAG,CAAC;YAAE,OAAO;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,GAAG,CAAC,GAAG,MAAM;YAAE,OAAO;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrF,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;IACtB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;AACjE,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/lib/session.d.ts

@@ -0,0 +1,84 @@
+import { type GeneratedDiagnostic, type Generator } from "./plan.ts";
+import { type MappedText } from "./spans.ts";
+/** How to open the resident program. */
+export interface WarmSessionOptions {
+    /** Absolute tsconfig path, as supplied by `openProject`. */
+    configFile: string;
+    /** Working directory for the resident API. */
+    cwd: string;
+    /** Module specifier providing `WEBDA_STORAGE`. */
+    storageModule?: string;
+    /** Treat every class as eligible, not just models. */
+    accessorsForAll?: boolean;
+    /** Module specifier providing the WebdaQL `escape` helper. */
+    qlModule?: string;
+    /** Override the generator set (tests). */
+    generators?: Generator[];
+}
+/** Per-request cost breakdown, in milliseconds. */
+export interface TransformTiming {
+    /** Refreshing the resident snapshot after a buffer change. */
+    snapshotMs: number;
+    /** Running the generators, i.e. the checker queries. */
+    analyzeMs: number;
+    /** Splicing edits and building the span map. */
+    spliceMs: number;
+    totalMs: number;
+    /** False when the buffer was unchanged and the snapshot was reused. */
+    changed: boolean;
+}
+/** A transform result plus what it cost. */
+export interface TransformOutcome extends MappedText {
+    timing: TransformTiming;
+    editCount: number;
+    /** Generator diagnostics, for `TransformResult.diagnostics`. */
+    diagnostics: GeneratedDiagnostic[];
+}
+/**
+ * A resident `Program` + `Checker` that answers `transform` requests.
+ */
+export declare class WarmSession {
+    private readonly api;
+    private readonly options;
+    private readonly generators;
+    /** Live buffer text per file, served to the resident program. */
+    private readonly overlay;
+    private snapshot;
+    /** Cost of the initial program construction. */
+    readonly startupMs: number;
+    /**
+     * Open the resident program for a project.
+     * @param options - how to open it
+     */
+    constructor(options: WarmSessionOptions);
+    /**
+     * Files in the resident program, for benchmarking.
+     * @returns the source file count
+     */
+    get fileCount(): number;
+    /**
+     * The single project held by the current snapshot.
+     * @returns the project
+     */
+    private project;
+    /**
+     * Build an analysis context restricted to a single file.
+     *
+     * Restricting `sourceFiles` is what makes re-analysis incremental: the
+     * generators only walk the file that changed, while the checker still resolves
+     * types across the whole program.
+     * @param fileName - the file to analyse
+     * @returns a context the generators accept
+     */
+    private contextFor;
+    /**
+     * Transform one file, refreshing the resident program only if its text moved.
+     * @param fileName - absolute path of the file being transformed
+     * @param content - the editor's current buffer text
+     * @returns generated text, span map and timings
+     */
+    transform(fileName: string, content: string): TransformOutcome;
+    /** Shut down the resident server process. */
+    dispose(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/lib/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAwB,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9D,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAID;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAM;IACtB,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,YAAY,OAAO,EAAE,kBAAkB,EAYtC;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,OAAO,CAAC,OAAO;IAIf;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IASlB;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA0C7D;IAED,6CAA6C;IAC7C,OAAO,IAAI,IAAI,CAMd;CACF"}

package/lib/session.js

@@ -0,0 +1,141 @@
+/**
+ * A warm analysis session for the content mapper.
+ *
+ * This is the part `transform` cannot do on its own. The protocol hands the
+ * mapper one file's text and nothing else — no `Program`, no `Checker` — but
+ * Webda's dominant coercions (`ManyToOne<T>` -> `ModelLink`, `OneToMany<T>` ->
+ * `ModelRelated`, `@WebdaAutoSetter` set-methods) all need type resolution. So
+ * the mapper runs *its own* TypeScript program over the original sources and
+ * keeps it warm across requests: pass 1 of the two-pass design, resident.
+ *
+ * Two details make it work:
+ *
+ * - **The live buffer is served through `fs.readFile`.** The editor's unsaved
+ *   text is put in an overlay, so the resident program analyses exactly what the
+ *   user sees rather than what is on disk.
+ * - **`.model.ts` degrades to plain TypeScript.** The mapper opens the project's
+ *   own tsconfig without `runExternalCode`, so content mappers are inert there
+ *   and no recursion is possible; the files are simply read as authored.
+ */
+import { API } from "typescript/unstable/sync";
+import { createFileSystemLayer } from "typescript/unstable/fs";
+import { baseNames, textOf, triviaOf } from "./context.js";
+import { defaultGenerators } from "./defaults.js";
+import { mergePlan } from "./plan.js";
+import { buildMappedText } from "./spans.js";
+const ms = (from) => Number(process.hrtime.bigint() - from) / 1e6;
+/**
+ * A resident `Program` + `Checker` that answers `transform` requests.
+ */
+export class WarmSession {
+    api;
+    options;
+    generators;
+    /** Live buffer text per file, served to the resident program. */
+    overlay = new Map();
+    snapshot;
+    /** Cost of the initial program construction. */
+    startupMs;
+    /**
+     * Open the resident program for a project.
+     * @param options - how to open it
+     */
+    constructor(options) {
+        this.options = options;
+        this.generators = options.generators ?? defaultGenerators(options);
+        const t0 = process.hrtime.bigint();
+        this.api = new API({ cwd: options.cwd });
+        this.snapshot = this.api.createSnapshot({ openProjects: [options.configFile] });
+        if (!this.snapshot.getProjects()[0]) {
+            this.api.close();
+            throw new Error(`No project loaded for ${options.configFile}`);
+        }
+        this.startupMs = ms(t0);
+    }
+    /**
+     * Files in the resident program, for benchmarking.
+     * @returns the source file count
+     */
+    get fileCount() {
+        return this.project().program.getSourceFileNames().length;
+    }
+    /**
+     * The single project held by the current snapshot.
+     * @returns the project
+     */
+    project() {
+        return this.snapshot.getProjects()[0];
+    }
+    /**
+     * Build an analysis context restricted to a single file.
+     *
+     * Restricting `sourceFiles` is what makes re-analysis incremental: the
+     * generators only walk the file that changed, while the checker still resolves
+     * types across the whole program.
+     * @param fileName - the file to analyse
+     * @returns a context the generators accept
+     */
+    contextFor(fileName) {
+        const project = this.project();
+        const program = project.program;
+        const checker = project.checker;
+        const sf = program.getSourceFile(fileName);
+        const sourceFiles = sf ? [sf] : [];
+        return { project, program, checker, sourceFiles, textOf, triviaOf, baseNames };
+    }
+    /**
+     * Transform one file, refreshing the resident program only if its text moved.
+     * @param fileName - absolute path of the file being transformed
+     * @param content - the editor's current buffer text
+     * @returns generated text, span map and timings
+     */
+    transform(fileName, content) {
+        const t0 = process.hrtime.bigint();
+        const changed = this.overlay.get(fileName) !== content;
+        if (changed) {
+            this.overlay.set(fileName, content);
+            const previous = this.snapshot;
+            // Two things are load-bearing here, and both were found the hard way:
+            //
+            // - a filesystem *layer* is consulted ahead of the host filesystem, which
+            //   is how unsaved buffer text reaches the resident program. The
+            //   spawn-time `APIOptions.fs` callback is not enough, because source
+            //   files are cached and a later edit to the same path is never re-read.
+            // - `ensurePrograms` is required. Programs update lazily, so without it
+            //   the new snapshot still hands back the previous program and every
+            //   transform silently analyses stale text.
+            this.snapshot = this.snapshot.update({
+                fileSystem: createFileSystemLayer([...this.overlay]),
+                ensurePrograms: true
+            });
+            previous.dispose();
+        }
+        const snapshotMs = ms(t0);
+        const t1 = process.hrtime.bigint();
+        const ctx = this.contextFor(fileName);
+        const produced = ctx.sourceFiles.length ? this.generators.flatMap(g => g.analyze(ctx)) : [];
+        const { plan } = mergePlan(produced);
+        const edits = plan.get(fileName) ?? [];
+        const diagnostics = produced.filter(f => f.fileName === fileName).flatMap(f => f.diagnostics ?? []);
+        const analyzeMs = ms(t1);
+        const t2 = process.hrtime.bigint();
+        const mapped = buildMappedText(content, edits);
+        const spliceMs = ms(t2);
+        return {
+            ...mapped,
+            diagnostics,
+            editCount: edits.length,
+            timing: { snapshotMs, analyzeMs, spliceMs, totalMs: ms(t0), changed }
+        };
+    }
+    /** Shut down the resident server process. */
+    dispose() {
+        try {
+            this.snapshot?.dispose();
+        }
+        finally {
+            this.api.close();
+        }
+    }
+}
+//# sourceMappingURL=session.js.map