@veryfront/ext-bundler-esbuild 0.1.1234 → 0.1.1236

package/esm/_dnt.polyfills.d.ts

@@ -97,5 +97,10 @@ interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyf
 export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
 export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
 export declare let import_meta_ponyfill: ImportMetaPonyfill;
+declare global {
+    interface Error {
+        cause?: unknown;
+    }
+}
 export {};
 //# sourceMappingURL=_dnt.polyfills.d.ts.map

package/esm/_dnt.polyfills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC"}
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC;AACxB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CACF;AAED,OAAO,EAAE,CAAC"}

package/esm/esbuild-bundler.d.ts

@@ -1,4 +1,16 @@
 import type { BuildContext, BundleOptions, Bundler, BundleResult, TransformOptions, TransformResult } from "veryfront/extensions/bundler";
+import type { ChildProcess } from "node:child_process";
+/**
+ * Keep lifecycle tracking tolerant of Node-compatible child-process shims.
+ *
+ * Native Node represents an active child with `null` exit fields. Some
+ * compatible runtimes leave those fields undefined until the child exits.
+ */
+/** The ownership latch is module-wide; tests must clear it between cases. */
+export declare function __resetOwnershipErrorForTests(): void;
+/** Exercise the latch without starting a real esbuild service. */
+export declare function __recordOwnershipErrorForTests(cause?: unknown): Error;
+export declare function isLiveEsbuildServiceProcess(child: Pick<ChildProcess, "killed" | "exitCode" | "signalCode">): boolean;
 /**
  * esbuild-backed {@link Bundler} implementation.
  *

package/esm/esbuild-bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild-bundler.d.ts","sourceRoot":"","sources":["../src/esbuild-bundler.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,OAAO,EACP,YAAY,EAGZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AA0TtC;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,OAAO;IACtC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCrD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAa9D,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAqCtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiF5B"}
+{"version":3,"file":"esbuild-bundler.d.ts","sourceRoot":"","sources":["../src/esbuild-bundler.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,OAAO,EACP,YAAY,EAGZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgPvD;;;;;GAKG;AACH,6EAA6E;AAC7E,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,kEAAkE;AAClE,wBAAgB,8BAA8B,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAErE;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC,GAC9D,OAAO,CAIT;AA6HD;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,OAAO;IACtC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCrD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAa9D,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAqCtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiF5B"}

package/esm/esbuild-bundler.js

@@ -27,10 +27,53 @@ let activeOperationCount = 0;
 let activeOperationsIdle = Promise.resolve();
 let resolveActiveOperationsIdle = null;
 const operationScopes = new AsyncLocalStorage();
+const OWNERSHIP_ERROR_MESSAGE = "[ext-bundler-esbuild] Cannot own an esbuild service started outside the module-wide adapter; restart the process and use only the Bundler contract";
+const MAX_CAUSE_DETAIL_LENGTH = 200;
+/** Absolute POSIX and Windows paths, reduced to a basename below. */
+const ABSOLUTE_PATH_PATTERN = /(?:[A-Za-z]:)?(?:\/|\\\\)[^\s"']*/g;
+/**
+ * Reduce a cause to a single redacted line.
+ *
+ * The message is logged, so it must not carry a machine's filesystem layout:
+ * a compiled runtime resolves esbuild under a temp directory, and spawn errors
+ * quote that path verbatim. Keeping only the basename preserves what the reader
+ * needs -- which binary or module failed -- without the surrounding layout. The
+ * first line only, so a stack never reaches the message, and bounded so a large
+ * esbuild diagnostic cannot dominate the log line.
+ */
+function describeCause(cause) {
+    if (cause === undefined)
+        return "";
+    const raw = cause instanceof Error ? cause.message : String(cause);
+    const firstLine = raw.split("\n", 1)[0] ?? "";
+    const withoutPaths = firstLine.replace(ABSOLUTE_PATH_PATTERN, (match) => {
+        const parts = match.split(/[\/\\]/).filter(Boolean);
+        return parts.length > 0 ? parts[parts.length - 1] : match;
+    });
+    const detail = withoutPaths.trim().slice(0, MAX_CAUSE_DETAIL_LENGTH);
+    return detail ? ` (underlying failure: ${detail})` : "";
+}
+/**
+ * Latch the ownership failure, keeping whatever really went wrong.
+ *
+ * The latch is permanent, so the first call decides the error every later
+ * operation sees. That call is often made before the operation settles, when no
+ * cause is known yet; adopting the cause afterwards is what keeps the real
+ * failure visible instead of reporting a lifecycle problem that may not be the
+ * actual one. The cause is folded into the message because callers log
+ * `error.message` and would otherwise never print the chain.
+ */
 function recordOwnershipError(cause) {
-    const message = "[ext-bundler-esbuild] Cannot own an esbuild service started outside the module-wide adapter; restart the process and use only the Bundler contract";
-    esbuildOwnershipError ??= new Error(message, cause === undefined ? undefined : { cause });
-    return esbuildOwnershipError;
+    const existing = esbuildOwnershipError;
+    if (!existing) {
+        esbuildOwnershipError = new Error(`${OWNERSHIP_ERROR_MESSAGE}${describeCause(cause)}`, cause === undefined ? undefined : { cause });
+        return esbuildOwnershipError;
+    }
+    if (cause !== undefined && existing.cause === undefined) {
+        existing.cause = cause;
+        existing.message = `${OWNERSHIP_ERROR_MESSAGE}${describeCause(cause)}`;
+    }
+    return existing;
 }
 async function getEsbuild() {
     await ensureEsbuildBinary();
@@ -157,10 +200,27 @@ function isEsbuildServiceSpawn(spawnArgs) {
         args.some((arg) => typeof arg === "string" && arg.startsWith("--service=")) &&
         args.includes("--ping");
 }
+/**
+ * Keep lifecycle tracking tolerant of Node-compatible child-process shims.
+ *
+ * Native Node represents an active child with `null` exit fields. Some
+ * compatible runtimes leave those fields undefined until the child exits.
+ */
+/** The ownership latch is module-wide; tests must clear it between cases. */
+export function __resetOwnershipErrorForTests() {
+    esbuildOwnershipError = null;
+}
+/** Exercise the latch without starting a real esbuild service. */
+export function __recordOwnershipErrorForTests(cause) {
+    return recordOwnershipError(cause);
+}
+export function isLiveEsbuildServiceProcess(child) {
+    return !child.killed &&
+        (child.exitCode === null || child.exitCode === undefined) &&
+        (child.signalCode === null || child.signalCode === undefined);
+}
 function isLiveService(service) {
-    return !service.child.killed &&
-        service.child.exitCode === null &&
-        service.child.signalCode === null;
+    return isLiveEsbuildServiceProcess(service.child);
 }
 function invokeEsbuild(operation) {
     const originalSpawn = childProcess.spawn;
@@ -202,9 +262,14 @@ function invokeEsbuild(operation) {
     }
     const ownedService = capturedService ?? esbuildService;
     if (!ownedService || !isLiveService(ownedService)) {
-        const ownershipError = recordOwnershipError();
+        // Latch synchronously so a concurrent operation cannot pass the admission
+        // check in runBundlerOperation and drive esbuild while ownership is already
+        // known to be invalid. The rejection handler still supplies the cause: the
+        // latch is created without one here, and recordOwnershipError adopts the
+        // first cause offered afterwards.
+        recordOwnershipError();
         return result.then(() => {
-            throw ownershipError;
+            throw recordOwnershipError();
         }, (cause) => {
             throw recordOwnershipError(cause);
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veryfront/ext-bundler-esbuild",
-  "version": "0.1.1234",
+  "version": "0.1.1236",
   "description": "Veryfront first-party extension package for ext-bundler-esbuild",
   "keywords": [
     "veryfront",
@@ -50,7 +50,7 @@
     "esbuild": "0.28.1"
   },
   "peerDependencies": {
-    "veryfront": "^0.1.1234"
+    "veryfront": "^0.1.1236"
   },
   "type": "module",
   "types": "./esm/index.d.ts",