veryfront 0.1.758 → 0.1.761

package/esm/src/extensions/loader.js

@@ -3,10 +3,13 @@
  *
  * @module extensions/loader
  */
-import { CIRCULAR_DEPENDENCY_ERROR, EXTENSION_CONFLICT_ERROR, EXTENSION_VALIDATION_ERROR, } from "./errors.js";
+import * as dntShim from "../../_dnt.shims.js";
+import { CIRCULAR_DEPENDENCY_ERROR, EXTENSION_CONFLICT_ERROR, EXTENSION_SETUP_TIMEOUT_ERROR, EXTENSION_VALIDATION_ERROR, } from "./errors.js";
 import { register, reset, resolve as resolveContract, tryResolve } from "./contracts.js";
 import { auditCapabilities } from "./capabilities.js";
 import { detectConflicts, selectContractProviders, validateExtension } from "./validation.js";
+const DEFAULT_SETUP_TIMEOUT_MS = 30_000;
+const SETUP_TIMEOUT_SENTINEL = Symbol("extension-setup-timeout");
 /** Implement extension loader. */
 export class ExtensionLoader {
     logger;
@@ -128,7 +131,10 @@ export class ExtensionLoader {
      * Run the full setup lifecycle for all extensions.
      * If called while extensions are already loaded, tears them down first.
      */
-    async setupAll(extensions, projectConfig) {
+    async setupAll(extensions, projectConfig, options) {
+        const timeoutMs = options?.setupTimeoutMs === 0
+            ? 0
+            : (options?.setupTimeoutMs ?? DEFAULT_SETUP_TIMEOUT_MS);
         // Idempotent: teardownAll clears setupOrder and resets the contract
         // registry even when nothing is loaded yet.
         await this.teardownAll();
@@ -168,10 +174,18 @@ export class ExtensionLoader {
                 }
             }
             if (ext.setup) {
+                // Once setup fails (notably on timeout, where the losing promise may
+                // resume later), the context must stop mutating the contract registry,
+                // or a late provide() would poison state after teardownAll() rollback.
+                let ctxRevoked = false;
                 const ctx = {
                     get: (contract) => tryResolve(contract),
                     require: (contract) => resolveContract(contract),
                     provide: (contract, impl) => {
+                        if (ctxRevoked) {
+                            this.logger.warn(`Ignoring provide("${contract}") from "${ext.name}": its setup() already failed or timed out`);
+                            return;
+                        }
                         const winner = contractWinner.get(contract);
                         if (!winner || winner === resolved) {
                             register(contract, impl);
@@ -181,9 +195,30 @@ export class ExtensionLoader {
                     logger: this.logger,
                 };
                 try {
-                    await ext.setup(ctx);
+                    if (timeoutMs > 0) {
+                        let timerId;
+                        const timeoutPromise = new Promise((_, reject) => {
+                            timerId = dntShim.setTimeout(() => reject(SETUP_TIMEOUT_SENTINEL), timeoutMs);
+                        });
+                        try {
+                            await Promise.race([ext.setup(ctx), timeoutPromise]);
+                        }
+                        finally {
+                            clearTimeout(timerId);
+                        }
+                    }
+                    else {
+                        await ext.setup(ctx);
+                    }
                 }
                 catch (err) {
+                    ctxRevoked = true;
+                    const normalized = err === SETUP_TIMEOUT_SENTINEL
+                        ? EXTENSION_SETUP_TIMEOUT_ERROR.create({
+                            message: `Extension "${ext.name}" setup() timed out after ${timeoutMs}ms`,
+                            detail: `Extension "${ext.name}" setup() did not complete within ${timeoutMs}ms`,
+                        })
+                        : err;
                     // Best-effort teardown of the partially-initialized extension so
                     // any resources it opened before throwing get a chance to close.
                     if (ext.teardown) {
@@ -196,7 +231,7 @@ export class ExtensionLoader {
                     }
                     // Roll back everything loaded so far and clear the registry.
                     await this.teardownAll();
-                    throw err;
+                    throw normalized;
                 }
             }
             this.setupOrder.push(resolved);

package/esm/src/extensions/orchestrate.d.ts

@@ -29,6 +29,9 @@ export interface OrchestrateOptions {
      *  project, package, or config extension with the same name overrides them.
      *  Users can disable them via `{ name: "ext-llm-anthropic", enabled: false }`. */
     builtinExtensions?: ResolvedExtension[];
+    /** Per-extension setup() timeout in milliseconds. Defaults to 30 000 ms.
+     *  Pass `0` to disable. */
+    setupTimeoutMs?: number;
     /** @internal Override discovery functions in tests. */
     discovery?: {
         discoverPackageExtensions: typeof defaultDiscovery.discoverPackageExtensions;

package/esm/src/extensions/orchestrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,gBAAgB,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAEf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,eAAe,CAAC;IACxB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC;;sFAEkF;IAClF,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACV,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,uBAAuB,EAAE,OAAO,gBAAgB,CAAC,uBAAuB,CAAC;QACzE,eAAe,EAAE,OAAO,gBAAgB,CAAC,eAAe,CAAC;KAC1D,CAAC;IACF,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,kBAAkB,CAAC;CACzC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAgF1B"}
+{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,gBAAgB,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAEf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,eAAe,CAAC;IACxB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC;;sFAEkF;IAClF,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC;+BAC2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACV,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,uBAAuB,EAAE,OAAO,gBAAgB,CAAC,uBAAuB,CAAC;QACzE,eAAe,EAAE,OAAO,gBAAgB,CAAC,eAAe,CAAC;KAC1D,CAAC;IACF,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,kBAAkB,CAAC;CACzC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAkF1B"}

package/esm/src/extensions/orchestrate.js

@@ -107,7 +107,9 @@ export async function orchestrateExtensions(options) {
     if (options.primeContracts) {
         loader.primeContracts(options.primeContracts);
     }
-    await loader.setupAll(merged, config);
+    await loader.setupAll(merged, config, {
+        setupTimeoutMs: options.setupTimeoutMs,
+    });
     return loader;
 }
 async function loadAllFactories(paths, source, loadFactory) {

package/esm/src/integrations/_data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_data.d.ts","sourceRoot":"","sources":["../../../src/src/integrations/_data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,UAAU,EAAE,iBAAiB,EA66XzC,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+ExC,CAAC"}
+{"version":3,"file":"_data.d.ts","sourceRoot":"","sources":["../../../src/src/integrations/_data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,UAAU,EAAE,iBAAiB,EAs+mCzC,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2QxC,CAAC"}