typescript 7.1.0-dev.20260924.1 → 7.1.0-dev.20260926.1

package/dist/api/sync/api.js

@@ -21,7 +21,7 @@ import { TypePredicateKind } from "#enums/typePredicateKind";
 import { ModifierFlags, unescapeLeadingUnderscores, } from "../../ast/index.js";
 import { assertNever } from "../../internal/utils.js";
 import { encodeNode, uint8ArrayToBase64, } from "../node/encoder.js";
-import { decodeNode, getNodeId, parseNodeHandle, readParseOptionsKey, readSourceFileHash, RemoteSourceFile, } from "../node/node.js";
+import { decodeNode, getNodeId, parseNodeHandle, readParseOptionsKey, readSourceFileHash, readSourceFileLease, RemoteSourceFile, } from "../node/node.js";
 import { Wtf8Decoder } from "../node/wtf8.js";
 import { createGetCanonicalFileName, toPath, } from "../path.js";
 import { resolveFileName, toCreateSnapshotRequest, } from "../proto.js";
@@ -59,6 +59,8 @@ export class API {
     initialized = false;
     initializing;
     activeSnapshots = new Map();
+    activeBuildOrchestrators = new Set();
+    activeSourceFileLeases = new Map();
     printer;
     internal;
     constructor(options = {}) {
@@ -145,6 +147,34 @@ export class API {
     getNewLine() {
         return "\n";
     }
+    get createBuildOrchestrator() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "createBuildOrchestrator", function (rootNames, buildOrchestratorOptions) {
+            owner.ensureInitialized();
+            const orchestratorResponse = owner.client.apiRequest("createBuildOrchestrator", {
+                ...buildOrchestratorOptions,
+                ...buildOrchestratorOptions.overrideCompilerOptions,
+                rootNames,
+            });
+            const orchestrator = new BuildOrchestrator(owner.client, orchestratorResponse, () => {
+                owner.activeBuildOrchestrators.delete(orchestrator);
+            });
+            owner.activeBuildOrchestrators.add(orchestrator);
+            return orchestrator;
+        }, function* (rootNames, buildOrchestratorOptions) {
+            yield* owner.ensureInitialized.gen();
+            const orchestratorResponse = yield* apiRequest("createBuildOrchestrator", {
+                ...buildOrchestratorOptions,
+                ...buildOrchestratorOptions.overrideCompilerOptions,
+                rootNames,
+            });
+            const orchestrator = new BuildOrchestrator(owner.client, orchestratorResponse, () => {
+                owner.activeBuildOrchestrators.delete(orchestrator);
+            });
+            owner.activeBuildOrchestrators.add(orchestrator);
+            return orchestrator;
+        });
+    }
     get parseConfigFile() {
         const owner = this;
         return cacheGeneratorMethod(owner, "parseConfigFile", function (file) {
@@ -185,6 +215,10 @@ export class API {
             return yield* apiRequest("parseJsonConfigFileContent", { json, ...options });
         });
     }
+    /**
+     * Create and retain a source file independently of a program.
+     * Dispose the returned lease when the source file no longer needs to remain available remotely.
+     */
     get createSourceFile() {
         const owner = this;
         return cacheGeneratorMethod(owner, "createSourceFile", function (fileName, sourceText, options = {}) {
@@ -193,16 +227,20 @@ export class API {
             if (!data) {
                 throw new Error("createSourceFile returned no source file");
             }
-            return new RemoteSourceFile(data, owner.decoder, owner.client.getTimingCollector());
+            return owner.retainSourceFileResponse(data);
         }, function* (fileName, sourceText, options = {}) {
             yield* owner.ensureInitialized.gen();
             const data = sourceFileResponseToUint8Array(yield* apiRequest("createSourceFile", { fileName, sourceText, options }));
             if (!data) {
                 throw new Error("createSourceFile returned no source file");
             }
-            return new RemoteSourceFile(data, owner.decoder, owner.client.getTimingCollector());
+            return owner.retainSourceFileResponse(data);
         });
     }
+    /**
+     * Read, create, and retain a source file independently of a program.
+     * Dispose the returned lease when the source file no longer needs to remain available remotely.
+     */
     get createSourceFileFromFile() {
         const owner = this;
         return cacheGeneratorMethod(owner, "createSourceFileFromFile", function (file, options = {}) {
@@ -211,16 +249,37 @@ export class API {
             if (!data) {
                 throw new Error("createSourceFileFromFile returned no source file");
             }
-            return new RemoteSourceFile(data, owner.decoder, owner.client.getTimingCollector());
+            return owner.retainSourceFileResponse(data);
         }, function* (file, options = {}) {
             yield* owner.ensureInitialized.gen();
             const data = sourceFileResponseToUint8Array(yield* apiRequest("createSourceFileFromFile", { fileName: resolveFileName(file), options }));
             if (!data) {
                 throw new Error("createSourceFileFromFile returned no source file");
             }
-            return new RemoteSourceFile(data, owner.decoder, owner.client.getTimingCollector());
+            return owner.retainSourceFileResponse(data);
         });
     }
+    retainSourceFileResponse(data) {
+        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+        const lease = readSourceFileLease(view);
+        try {
+            const decoded = new RemoteSourceFile(data, this.decoder, this.client.getTimingCollector());
+            const sourceFile = this.sourceFileCache.setForLease(decoded.path, decoded, readParseOptionsKey(view), readSourceFileHash(view), lease);
+            const retained = new RetainedSourceFile(sourceFile, lease, this.client, () => {
+                this.activeSourceFileLeases.delete(lease);
+                this.sourceFileCache.releaseLease(lease);
+            });
+            this.activeSourceFileLeases.set(lease, retained);
+            return retained;
+        }
+        catch (error) {
+            try {
+                this.client.apiRequest("releaseSourceFile", { lease });
+            }
+            catch { }
+            throw error;
+        }
+    }
     get transpileModule() {
         const owner = this;
         return cacheGeneratorMethod(owner, "transpileModule", function (input, options = {}) {
@@ -420,26 +479,44 @@ export class API {
     get close() {
         const owner = this;
         return cacheGeneratorMethod(owner, "close", function () {
-            // Dispose all active snapshots
             try {
-                for (const snapshot of [...owner.activeSnapshots.values()]) {
-                    snapshot.dispose();
+                for (const retained of [...owner.activeSourceFileLeases.values()]) {
+                    retained.dispose();
                 }
-                owner.sourceFileCache.clear();
             }
             finally {
-                owner.client.close(); // always close the underlying connection
+                try {
+                    for (const orchestrator of [...owner.activeBuildOrchestrators]) {
+                        orchestrator.dispose();
+                    }
+                    for (const snapshot of [...owner.activeSnapshots.values()]) {
+                        snapshot.dispose();
+                    }
+                    owner.sourceFileCache.clear();
+                }
+                finally {
+                    owner.client.close(); // always close the underlying connection
+                }
             }
         }, function* () {
-            // Dispose all active snapshots
             try {
-                for (const snapshot of [...owner.activeSnapshots.values()]) {
-                    yield* snapshot.dispose.gen();
+                for (const retained of [...owner.activeSourceFileLeases.values()]) {
+                    yield* retained.dispose.gen();
                 }
-                owner.sourceFileCache.clear();
             }
             finally {
-                owner.client.close(); // always close the underlying connection
+                try {
+                    for (const orchestrator of [...owner.activeBuildOrchestrators]) {
+                        yield* orchestrator.dispose.gen();
+                    }
+                    for (const snapshot of [...owner.activeSnapshots.values()]) {
+                        yield* snapshot.dispose.gen();
+                    }
+                    owner.sourceFileCache.clear();
+                }
+                finally {
+                    owner.client.close(); // always close the underlying connection
+                }
             }
         });
     }
@@ -582,6 +659,56 @@ export class API {
         });
     }
 }
+/** An independently retained source file and its disposable remote-lifetime lease. */
+export class RetainedSourceFile {
+    sourceFile;
+    lease;
+    client;
+    onDispose;
+    disposed = false;
+    disposePromise;
+    constructor(sourceFile, lease, client, onDispose) {
+        this.sourceFile = sourceFile;
+        this.lease = lease;
+        this.client = client;
+        this.onDispose = onDispose;
+    }
+    [globalThis.Symbol.dispose]() {
+        this.dispose();
+    }
+    get dispose() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "dispose", function () {
+            return owner.disposePromise ??= owner.disposeWorker();
+        }, function* () {
+            return owner.disposePromise ??= yield* owner.disposeWorker.gen();
+        });
+    }
+    get disposeWorker() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "disposeWorker", function () {
+            if (owner.disposed)
+                return;
+            owner.disposed = true;
+            try {
+                owner.client.apiRequest("releaseSourceFile", { lease: owner.lease });
+            }
+            finally {
+                owner.onDispose();
+            }
+        }, function* () {
+            if (owner.disposed)
+                return;
+            owner.disposed = true;
+            try {
+                yield* apiRequest("releaseSourceFile", { lease: owner.lease });
+            }
+            finally {
+                owner.onDispose();
+            }
+        });
+    }
+}
 export class InternalAPI {
     client;
     ensureInitialized;
@@ -2243,6 +2370,137 @@ export class Program {
         return this.project;
     }
 }
+export class BuildOrchestrator {
+    client;
+    id;
+    disposed = false;
+    disposePromise;
+    onDispose;
+    constructor(client, orchestratorResponse, onDispose) {
+        this.client = client;
+        this.id = orchestratorResponse.buildOrchestratorID;
+        this.onDispose = onDispose;
+    }
+    [globalThis.Symbol.dispose]() {
+        void this.dispose();
+    }
+    get dispose() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "dispose", function () {
+            return owner.disposePromise ??= owner.disposeWorker();
+        }, function* () {
+            return owner.disposePromise ??= yield* owner.disposeWorker.gen();
+        });
+    }
+    get disposeWorker() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "disposeWorker", function () {
+            if (owner.disposed)
+                return;
+            owner.disposed = true;
+            try {
+                owner.client.apiRequest("disposeBuildOrchestrator", {
+                    buildOrchestratorID: owner.id,
+                });
+            }
+            finally {
+                owner.onDispose();
+            }
+        }, function* () {
+            if (owner.disposed)
+                return;
+            owner.disposed = true;
+            try {
+                yield* apiRequest("disposeBuildOrchestrator", {
+                    buildOrchestratorID: owner.id,
+                });
+            }
+            finally {
+                owner.onDispose();
+            }
+        });
+    }
+    get build() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "build", function (project) {
+            owner.ensureNotDisposed();
+            const response = owner.client.apiRequest("build", {
+                buildOrchestratorID: owner.id,
+                ...(project !== undefined ? { project } : {}),
+            });
+            return response;
+        }, function* (project) {
+            owner.ensureNotDisposed();
+            const response = yield* apiRequest("build", {
+                buildOrchestratorID: owner.id,
+                ...(project !== undefined ? { project } : {}),
+            });
+            return response;
+        });
+    }
+    get buildReferences() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "buildReferences", function (project) {
+            owner.ensureNotDisposed();
+            const response = owner.client.apiRequest("buildReferences", {
+                buildOrchestratorID: owner.id,
+                project,
+            });
+            return response;
+        }, function* (project) {
+            owner.ensureNotDisposed();
+            const response = yield* apiRequest("buildReferences", {
+                buildOrchestratorID: owner.id,
+                project,
+            });
+            return response;
+        });
+    }
+    get clean() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "clean", function (project) {
+            owner.ensureNotDisposed();
+            const response = owner.client.apiRequest("cleanBuild", {
+                buildOrchestratorID: owner.id,
+                ...(project !== undefined ? { project } : {}),
+            });
+            return response;
+        }, function* (project) {
+            owner.ensureNotDisposed();
+            const response = yield* apiRequest("cleanBuild", {
+                buildOrchestratorID: owner.id,
+                ...(project !== undefined ? { project } : {}),
+            });
+            return response;
+        });
+    }
+    get cleanReferences() {
+        const owner = this;
+        return cacheGeneratorMethod(owner, "cleanReferences", function (project) {
+            owner.ensureNotDisposed();
+            const response = owner.client.apiRequest("cleanReferences", {
+                buildOrchestratorID: owner.id,
+                ...(project !== undefined ? { project } : {}),
+            });
+            return response;
+        }, function* (project) {
+            owner.ensureNotDisposed();
+            const response = yield* apiRequest("cleanReferences", {
+                buildOrchestratorID: owner.id,
+                ...(project !== undefined ? { project } : {}),
+            });
+            return response;
+        });
+    }
+    isDisposed() {
+        return this.disposed;
+    }
+    ensureNotDisposed() {
+        if (this.disposed) {
+            throw new Error("Build orchestrator is disposed");
+        }
+    }
+}
 function toEmitOutput(response) {
     const outputFiles = new Map();
     for (const { fileName, ...outputFile } of response.outputFiles) {