veryfront 0.1.1238 → 0.1.1239

package/esm/src/transforms/esm/http-bundler.js

@@ -15,6 +15,7 @@ import { readHttpModuleText } from "../shared/http-module-response.js";
 import { sanitizeUrlForSpan } from "../../utils/logger/redact.js";
 import { snapshotThrowableDiagnostic } from "../../errors/safe-diagnostics.js";
 import { MAX_TIMER_DELAY_MS } from "../../utils/constants/limits.js";
+import { describeHtmlModuleResponse } from "./http-cache-helpers.js";
 const LOG_PREFIX = "[HTTP-HANDLER]";
 /**
  * User agent string for HTTP fetches.
@@ -141,11 +142,11 @@ export function createHTTPPlugin(options = {}) {
                         /<title>ESM[^<]*<\/title>/i.test(contents.slice(0, 500));
                     if (isHtmlContent) {
                         logger.warn(`${LOG_PREFIX} Received HTML instead of JS for ${safeUrl}`);
-                        return {
-                            errors: [{
-                                    text: `Received HTML instead of JavaScript from ${safeUrl}. Package may not exist or failed to build on esm.sh.`,
-                                }],
-                        };
+                        // Blaming esm.sh for every host that answers HTML sends the reader
+                        // to a registry that was never involved. The shared helper reports
+                        // the real cause, including an unresolved "@/" alias that fell
+                        // through to the site origin (VERYFRONT-SERVER-G).
+                        return { errors: [{ text: describeHtmlModuleResponse(safeUrl) }] };
                     }
                     return { contents, loader: "js" };
                 }

package/esm/src/transforms/esm/http-cache-helpers.d.ts

@@ -79,6 +79,15 @@ export declare function getEffectiveHttpCacheRequest<T extends HttpCacheIdentity
  * separate local files.
  */
 export declare function isCanonicalReactEsmUrl(rawUrl: string): boolean;
+/**
+ * Diagnostic for an HTTP module fetch that answered with HTML.
+ *
+ * Only esm.sh gets the "package failed to build" explanation. For any other
+ * host, direct the reader to verify that the import resolves to JavaScript.
+ * A path starting with "/@/" is the "@/" project alias in absolute form, so it
+ * gets a specific alias-resolution instruction.
+ */
+export declare function describeHtmlModuleResponse(rawUrl: string): string;
 export declare function isExternalScheme(specifier: string): boolean;
 export declare function isRelative(specifier: string): boolean;
 /**
@@ -101,6 +110,8 @@ export declare function isInternalBare(specifier: string): boolean;
 export declare const SERVER_ESM_TARGET = "node";
 export declare function normalizeEsmShUrl(url: URL): void;
 export declare function normalizeHttpUrl(raw: string): string;
+/** Build an opaque identity for correlating one exact HTTP module request. */
+export declare function fingerprintHttpModuleRequest(rawUrl: string): Promise<string>;
 export declare function resolveBareSpecifier(specifier: string, importMap: ImportMapConfig, reactVersion?: string): string;
 /**
  * Check if cached HTTP bundle code has file:// paths from a different environment.

package/esm/src/transforms/esm/http-cache-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-cache-helpers.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-cache-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http-cache-helpers.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-cache-helpers.ts"],"names":[],"mappings":"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"}

package/esm/src/transforms/esm/http-cache-helpers.js

@@ -182,6 +182,7 @@ function decodeEncodedCommas(value) {
     return decoded;
 }
 const HTTP_CACHE_REQUEST_IDENTITY_CONTEXT = Symbol("http-cache-request-identity-context");
+const HTTP_MODULE_REQUEST_FINGERPRINT_NAMESPACE = "veryfront:http-module-request:v1";
 function compareImportMapKeys(left, right) {
     return left[0] < right[0] ? -1 : left[0] > right[0] ? 1 : 0;
 }
@@ -358,6 +359,36 @@ export function getEffectiveHttpCacheRequest(rawUrl, options) {
 export function isCanonicalReactEsmUrl(rawUrl) {
     return getCanonicalReactEsmVersion(rawUrl) !== null;
 }
+/**
+ * Diagnostic for an HTTP module fetch that answered with HTML.
+ *
+ * Only esm.sh gets the "package failed to build" explanation. For any other
+ * host, direct the reader to verify that the import resolves to JavaScript.
+ * A path starting with "/@/" is the "@/" project alias in absolute form, so it
+ * gets a specific alias-resolution instruction.
+ */
+export function describeHtmlModuleResponse(rawUrl) {
+    let hostname = "";
+    let pathname = "";
+    try {
+        const url = new IntrinsicURL(rawUrl);
+        hostname = getURLHostname(url);
+        pathname = getURLPathname(url);
+    }
+    catch (_) {
+        /* expected: URL may be malformed */
+    }
+    const received = `Received HTML instead of JavaScript from ${rawUrl}.`;
+    if (hostname === "esm.sh") {
+        return `${received} The package may not exist or failed to build on esm.sh.`;
+    }
+    const resolutionInstruction = stringStartsWith(pathname, "/@/")
+        ? 'Verify that the "@/" alias import resolves to a project module and does not fall ' +
+            "through to the site origin."
+        : "Verify that the import resolves to a JavaScript module and does not fall through " +
+            "to the site origin.";
+    return `${received} ${resolutionInstruction}`;
+}
 export function isExternalScheme(specifier) {
     return stringStartsWith(specifier, "node:") ||
         stringStartsWith(specifier, "data:") ||
@@ -455,6 +486,10 @@ export function normalizeHttpUrl(raw) {
         return raw;
     }
 }
+/** Build an opaque identity for correlating one exact HTTP module request. */
+export function fingerprintHttpModuleRequest(rawUrl) {
+    return computeHash(`${HTTP_MODULE_REQUEST_FINGERPRINT_NAMESPACE}\0${normalizeHttpUrl(rawUrl)}`);
+}
 export function resolveBareSpecifier(specifier, importMap, reactVersion = DEFAULT_REACT_VERSION) {
     const reactMap = getReactImportMap(reactVersion);
     const reactMapped = reactMap[specifier];

package/esm/src/transforms/esm/http-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-cache.ts"],"names":[],"mappings":"AA8BA,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAW9B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAGL,KAAK,YAAY,EAMjB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAElB,gBAAgB,EAEhB,KAAK,OAAO,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,4BAA4B,CAAC;AAYxF,OAAO,EACL,0BAA0B,EAU3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EAKvB,MAAM,uBAAuB,CAAC;AAa/B,kFAAkF;AAClF,eAAO,MAAM,6BAA6B,QACT,CAAC;AAgOlC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,CAAC;AAGF,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAkWlC,wEAAwE;AACxE,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC,CA0CjC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErF;AAGD,eAAO,MAAM,wBAAwB,0BAAoB,CAAC"}
+{"version":3,"file":"http-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-cache.ts"],"names":[],"mappings":"AA8BA,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAW9B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAGL,KAAK,YAAY,EAQjB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAElB,gBAAgB,EAEhB,KAAK,OAAO,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,4BAA4B,CAAC;AAYxF,OAAO,EACL,0BAA0B,EAU3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EAKvB,MAAM,uBAAuB,CAAC;AAa/B,kFAAkF;AAClF,eAAO,MAAM,6BAA6B,QACT,CAAC;AAmPlC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,CAAC;AAGF,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAiWlC,wEAAwE;AACxE,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC,CA0CjC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErF;AAGD,eAAO,MAAM,wBAAwB,0BAAoB,CAAC"}

package/esm/src/transforms/esm/http-cache.js

@@ -29,7 +29,7 @@ import { guardedOutboundFetch, OutboundRequestBlockedError, } from "../../securi
 // Extracted modules
 import { embedSourceUrl, extractSourceUrl } from "./source-url-embed.js";
 import { isDegradedArtifact } from "./degraded-artifact.js";
-import { buildHttpCacheIdentity, buildHttpCacheIdentityMetadata, deriveHttpCacheRequestOptions, ensureAbsoluteDir, ensurePreparedHttpCacheRequestOptions, getEffectiveHttpCacheRequest, hashHttpCacheIdentity, hasIncompatibleFilePaths, isHttpUrl, normalizeHttpUrl, prepareHttpCacheRequestOptions, } from "./http-cache-helpers.js";
+import { buildHttpCacheIdentity, buildHttpCacheIdentityMetadata, deriveHttpCacheRequestOptions, describeHtmlModuleResponse, ensureAbsoluteDir, ensurePreparedHttpCacheRequestOptions, fingerprintHttpModuleRequest, getEffectiveHttpCacheRequest, hashHttpCacheIdentity, hasIncompatibleFilePaths, isHttpUrl, normalizeHttpUrl, prepareHttpCacheRequestOptions, } from "./http-cache-helpers.js";
 import { extractBundleDeps, validateBundleDepsExist } from "./bundle-deps-validator.js";
 import { bundleAccumulatorStorage, createBundleAccumulator, trackCachedBundleGraph, trackWrittenBundle, } from "./bundle-accumulator.js";
 import { isHttpBundleCodeWithinLimit, MAX_CACHED_HTTP_BUNDLE_BYTES, readCachedHttpBundleFile, } from "./http-bundle-file.js";
@@ -97,6 +97,12 @@ async function publishHttpBundleGeneration(cacheKey, cachePath, code, fs, abortS
         }
     }
 }
+function terminalHttpModuleFetchError(detail, context = {}) {
+    return BUILD_FAILED.create({
+        detail,
+        context: { phase: "http-module-fetch", ...context },
+    });
+}
 class HttpModuleResponseError extends Error {
     status;
     constructor(status) {
@@ -198,17 +204,17 @@ async function fetchHttpModule(url, abortSignal) {
     }
     catch (error) {
         if (error instanceof HttpModuleResponseError) {
-            throw BUILD_FAILED.create({ detail: `Failed to fetch ${safeUrl}: ${error.status}` });
+            throw terminalHttpModuleFetchError(`Failed to fetch ${safeUrl}: ${error.status}`, {
+                httpStatus: error.status,
+                httpModuleUrl: safeUrl,
+                httpModuleRequestFingerprint: await fingerprintHttpModuleRequest(url),
+            });
         }
         if (error instanceof HttpModuleRequestError) {
-            throw BUILD_FAILED.create({
-                detail: `Failed to fetch ${safeUrl}: ${error.requestErrorType}`,
-            });
+            throw terminalHttpModuleFetchError(`Failed to fetch ${safeUrl}: ${error.requestErrorType}`);
         }
         if (error instanceof HttpModuleBodyError) {
-            throw BUILD_FAILED.create({
-                detail: `Failed to fetch ${safeUrl}: ${error.message}`,
-            });
+            throw terminalHttpModuleFetchError(`Failed to fetch ${safeUrl}: ${error.message}`);
         }
         if (error instanceof OutboundRequestBlockedError) {
             // Preserve the policy-denial type so downstream specifier resolution can
@@ -396,12 +402,12 @@ async function cacheHttpModuleInternal(url, options) {
         const contentType = fetchedModule.contentType;
         const isHtmlContent = contentType.includes("text/html") || looksLikeHtmlNotJs(code);
         if (isHtmlContent) {
-            logger.error("[HTTP-CACHE] Received HTML instead of JavaScript, likely an esm.sh error page", {
+            logger.error("[HTTP-CACHE] Received HTML instead of JavaScript", {
                 url: safeUrl,
                 contentType,
             });
             throw BUNDLE_ERROR.create({
-                detail: `Received HTML instead of JavaScript from ${safeUrl}. The package may not exist or failed to build on esm.sh.`,
+                detail: describeHtmlModuleResponse(safeUrl),
             });
         }
         reportProgress({

package/esm/src/transforms/esm/specifier-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specifier-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/specifier-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EACL,KAAK,YAAY,EAQlB,MAAM,yBAAyB,CAAC;AAcjC,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AA0I/F,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAoChC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,eAAe,CAAC,CAY1B"}
+{"version":3,"file":"specifier-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/specifier-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,OAAO,EACL,KAAK,YAAY,EAWlB,MAAM,yBAAyB,CAAC;AAgDjC,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAoM/F,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAoChC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,eAAe,CAAC,CAY1B"}

package/esm/src/transforms/esm/specifier-resolver.js

@@ -7,24 +7,53 @@
  * @module transforms/esm/specifier-resolver
  */
 import { basename } from "../../platform/compat/path/index.js";
+import { BUILD_FAILED } from "../../errors/index.js";
+import { snapshotVeryfrontError } from "../../errors/types.js";
 import { resolveImport } from "../../modules/import-map/resolver.js";
 import { OutboundRequestBlockedError } from "../../security/http/outbound-fetch.js";
-import { appendSameOriginSSRDependencyPinningKey } from "../import-rewriter/url-builder.js";
+import { appendSameOriginSSRDependencyPinningKey, normalizeExtension, } from "../import-rewriter/url-builder.js";
+import { splitSpecifierSuffix } from "../shared/specifier-suffix.js";
 import { parseBarePackageSpecifier } from "../shared/package-specifier.js";
 import { isServerOnlyPackage } from "../shared/server-only-packages.js";
 import { parseImports, replaceSpecifiers } from "./lexer.js";
-import { isCanonicalReactEsmUrl, isExternalScheme, isHttpUrl, isInternalBare, isParentHttpModule, isRelative, resolveBareSpecifier, } from "./http-cache-helpers.js";
+import { fingerprintHttpModuleRequest, getEffectiveHttpCacheRequest, isCanonicalReactEsmUrl, isExternalScheme, isHttpUrl, isInternalBare, isParentHttpModule, isRelative, normalizeHttpUrl, resolveBareSpecifier, } from "./http-cache-helpers.js";
 const ReflectApply = Reflect.apply;
+const RegExpTest = RegExp.prototype.test;
 const StringSlice = String.prototype.slice;
 const StringStartsWith = String.prototype.startsWith;
+function regexpTest(pattern, value) {
+    return ReflectApply(RegExpTest, pattern, [value]);
+}
 function stringSlice(value, start, end) {
     return ReflectApply(StringSlice, value, end === undefined ? [start] : [start, end]);
 }
 function stringStartsWith(value, search) {
     return ReflectApply(StringStartsWith, value, [search]);
 }
+function classifyAuthoredPackageFetchError(error, requestedPackageFingerprint) {
+    const snapshot = snapshotVeryfrontError(error);
+    const context = snapshot?.context;
+    if (snapshot?.slug !== BUILD_FAILED.slug ||
+        typeof context !== "object" || context === null ||
+        typeof requestedPackageFingerprint !== "string" ||
+        context.httpStatus !== 404 ||
+        context.httpModuleRequestFingerprint !==
+            requestedPackageFingerprint) {
+        return error;
+    }
+    return BUILD_FAILED.create({
+        message: snapshot.message,
+        detail: snapshot.detail,
+        cause: error,
+        context: {
+            httpStatus: 404,
+            httpModuleRequestFingerprint: requestedPackageFingerprint,
+            tenantBuildFailure: true,
+        },
+    });
+}
 function parseHttpBase(value) {
-    if (!value || !/^https?:\/\//i.test(value))
+    if (!value || !regexpTest(/^https?:\/\//i, value))
         return undefined;
     try {
         return new URL(value);
@@ -34,7 +63,7 @@ function parseHttpBase(value) {
     }
 }
 function canonicalizeHttpSpecifier(specifier, baseUrl, moduleServerOrigin) {
-    if (/^https?:\/\//i.test(specifier))
+    if (regexpTest(/^https?:\/\//i, specifier))
         return new URL(specifier).toString();
     if (!stringStartsWith(specifier, "//"))
         return specifier;
@@ -67,13 +96,41 @@ async function resolveSpecifier(specifier, baseUrl, options, cacheHttpModule) {
     specifier = canonicalizeHttpSpecifier(specifier, baseUrl, options.moduleServerOrigin);
     if (isExternalScheme(specifier))
         return null;
+    // The "@/" project alias always denotes the project's own module transport.
+    // An alias that escaped every upstream rewrite must land there too: treating
+    // it as a bare specifier would route it to esm.sh as a bogus scoped package,
+    // and a project import map that maps "@/" to a relative prefix would resolve
+    // it against the page's public origin, which answers with HTML
+    // (VERYFRONT-SERVER-G).
+    //
+    // The URL shape is not invented here. It reproduces `AliasStrategy.rewrite`
+    // (transforms/import-rewriter/strategies/alias-strategy.ts), the framework's
+    // canonical "@/" rewriter, which emits this same shape for both its `ssr` and
+    // its browser target: `normalizeExtension`, then append `.js` unless the
+    // result already ends in a JS-like or CSS extension. A different shape here
+    // would resolve one specifier to two different module URLs.
+    if (stringStartsWith(specifier, "@/")) {
+        const mappedAlias = resolveImport(specifier, options.importMap);
+        if (mappedAlias !== specifier && isLocalMappedSpecifier(mappedAlias))
+            return mappedAlias;
+        const { path: pathOnly, suffix } = splitSpecifierSuffix(stringSlice(specifier, 2));
+        const normalizedPath = normalizeExtension(pathOnly);
+        const jsPath = regexpTest(/\.(js|mjs|cjs|css)$/, normalizedPath)
+            ? normalizedPath
+            : `${normalizedPath}.js`;
+        const projectModulePath = `/_vf_modules/${jsPath}${suffix}`;
+        const moduleServerOrigin = parseHttpBase(options.moduleServerOrigin);
+        if (!moduleServerOrigin)
+            return projectModulePath;
+        return resolveSpecifier(new URL(projectModulePath, moduleServerOrigin).toString(), baseUrl, options, cacheHttpModule);
+    }
     // Server-only packages (`redis`, `pg`, …), including their explicit `npm:`
     // form, must never be routed through esm.sh. esm.sh either 500s building them
     // or emits a browser bundle with Node built-ins stubbed that can never
     // connect. The framework's adapters only `import()` them behind a lazy,
     // configured code path, so leaving the specifier external lets the runtime
     // resolve the real package (node_modules on Node, npm: on Deno) if and when
-    // the backend is actually used — and costs nothing when it is not.
+    // the backend is actually used, and costs nothing when it is not.
     const serverOnlyCandidate = stringStartsWith(specifier, "npm:")
         ? stringSlice(specifier, 4)
         : specifier;
@@ -90,7 +147,16 @@ async function resolveSpecifier(specifier, baseUrl, options, cacheHttpModule) {
     }
     if (stringStartsWith(specifier, "npm:")) {
         const bareSpecifier = stringSlice(specifier, 4);
-        const cached = await cacheHttpModule(`https://esm.sh/${bareSpecifier}`, options);
+        const requestedPackageUrl = `https://esm.sh/${bareSpecifier}`;
+        let cached;
+        try {
+            cached = await cacheHttpModule(requestedPackageUrl, options);
+        }
+        catch (error) {
+            const effective = getEffectiveHttpCacheRequest(requestedPackageUrl, options);
+            const requestedPackageFingerprint = await fingerprintHttpModuleRequest(normalizeHttpUrl(effective.url));
+            throw classifyAuthoredPackageFetchError(error, requestedPackageFingerprint);
+        }
         if (!cached)
             return bareSpecifier;
         if (isParentHttpModule(baseUrl)) {
@@ -136,7 +202,21 @@ async function resolveSpecifier(specifier, baseUrl, options, cacheHttpModule) {
         return null;
     if (isLocalMappedSpecifier(mapped))
         return mapped;
-    return resolveSpecifier(mapped, baseUrl, options, cacheHttpModule);
+    let requestedPackageUrl;
+    const cacheAuthoredPackage = async (url, cacheOptions) => {
+        const effective = getEffectiveHttpCacheRequest(url, cacheOptions);
+        requestedPackageUrl ??= normalizeHttpUrl(effective.url);
+        return await cacheHttpModule(url, cacheOptions);
+    };
+    try {
+        return await resolveSpecifier(mapped, baseUrl, options, cacheAuthoredPackage);
+    }
+    catch (error) {
+        const requestedPackageFingerprint = requestedPackageUrl === undefined
+            ? undefined
+            : await fingerprintHttpModuleRequest(requestedPackageUrl);
+        throw classifyAuthoredPackageFetchError(error, requestedPackageFingerprint);
+    }
 }
 /**
  * Build a map of specifier replacements by resolving all imports in the code.

package/esm/src/transforms/import-rewriter/strategies/alias-strategy.d.ts

@@ -1,4 +1,6 @@
 import type { ImportRewriteStrategy, ImportSpecifierInfo, RewriteContext, RewriteResult } from "../types.js";
+/** Rewrite a project alias through the canonical SSR module-path rule. */
+export declare function rewriteSsrProjectAliasSpecifier(specifier: string): string | null;
 export declare class AliasStrategy implements ImportRewriteStrategy {
     readonly name = "alias";
     readonly priority = 1;

package/esm/src/transforms/import-rewriter/strategies/alias-strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alias-strategy.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/alias-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB,qBAAa,aAAc,YAAW,qBAAqB;IACzD,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,QAAQ,KAAK;IAEtB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAIzD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;CAmDvE;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}
+{"version":3,"file":"alias-strategy.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/alias-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB,0EAA0E;AAC1E,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOhF;AAED,qBAAa,aAAc,YAAW,qBAAqB;IACzD,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,QAAQ,KAAK;IAEtB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAIzD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;CA8CvE;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/esm/src/transforms/import-rewriter/strategies/alias-strategy.js

@@ -1,5 +1,15 @@
 import { appendDependencyPinningPathKey, normalizeExtension } from "../url-builder.js";
 import { getProjectRelativePath } from "../project-paths.js";
+/** Rewrite a project alias through the canonical SSR module-path rule. */
+export function rewriteSsrProjectAliasSpecifier(specifier) {
+    if (!specifier.startsWith("@/"))
+        return null;
+    let normalizedPath = normalizeExtension(specifier.slice(2));
+    if (!/\.(tsx?|jsx?|mjs|cjs|mdx|css)$/.test(normalizedPath)) {
+        normalizedPath = `${normalizedPath}.js`;
+    }
+    return `/_vf_modules/${normalizedPath}`;
+}
 export class AliasStrategy {
     name = "alias";
     priority = 1;
@@ -10,15 +20,10 @@ export class AliasStrategy {
         const path = info.specifier.slice(2);
         // SSR uses /_vf_modules/ paths for HTTP module resolution
         if (ctx.target === "ssr") {
-            let normalizedPath = normalizeExtension(path);
-            // Add .js if no extension present
-            if (!/\.(tsx?|jsx?|mjs|cjs|mdx|css)$/.test(normalizedPath)) {
-                normalizedPath = `${normalizedPath}.js`;
-            }
             // The SSR adapter adds `ssr`, routing, cache-buster, and dependency
             // snapshot params together after this strategy runs. Keeping this URL
             // query-free ensures its `.js` matcher still sees the edge.
-            return { specifier: `/_vf_modules/${normalizedPath}` };
+            return { specifier: rewriteSsrProjectAliasSpecifier(info.specifier) ?? info.specifier };
         }
         // Browser: Use /_vf_modules/ absolute paths when moduleServerUrl is configured.
         // This avoids relative path calculation issues when the file index path structure

package/esm/src/transforms/md/compiler/md-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"md-compiler.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/md/compiler/md-compiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EAExB,MAAM,sCAAsC,CAAC;AAM9C,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,GAAE,iBAA4B,EACpC,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAsClC"}
+{"version":3,"file":"md-compiler.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/md/compiler/md-compiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EAExB,MAAM,sCAAsC,CAAC;AAW9C,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,GAAE,iBAA4B,EACpC,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAwClC"}

package/esm/src/transforms/md/compiler/md-compiler.js

@@ -1,8 +1,12 @@
 import { rendererLogger } from "../../../utils/index.js";
 import { resolve as resolveContract } from "../../../extensions/contracts.js";
-import { createError, toError } from "../../../errors/index.js";
+import { MARKDOWN_COMPILE_ERROR, VeryfrontError } from "../../../errors/index.js";
 import { withSpan } from "../../../observability/tracing/otlp-setup.js";
+import { isFrontmatterSyntaxError } from "../../mdx/compiler/frontmatter-extractor.js";
 const logger = rendererLogger.component("md-compiler");
+function isMarkdownSourceCompileError(error) {
+    return isFrontmatterSyntaxError(error);
+}
 export function compileMarkdownRuntime(mode, projectDir, content, frontmatter, filePath, target = "server", baseUrl, studioEmbed) {
     return withSpan("transforms.compileMarkdownRuntime", async () => {
         try {
@@ -25,10 +29,13 @@ export function compileMarkdownRuntime(mode, projectDir, content, frontmatter, f
                 error: err.message,
                 stack: err.stack,
             });
-            throw toError(createError({
-                type: "build",
-                message: `Markdown compilation error: ${err.message} | file: ${filePath ?? "<memory>"}`,
-            }));
+            if (err instanceof VeryfrontError || !isMarkdownSourceCompileError(err)) {
+                throw err;
+            }
+            throw MARKDOWN_COMPILE_ERROR.create({
+                detail: `Markdown compilation error: ${err.message} | file: ${filePath ?? "<memory>"}`,
+                cause: err,
+            });
         }
     }, {
         "md.filePath": filePath ?? "memory",

package/esm/src/transforms/mdx/compiler/frontmatter-extractor.d.ts

@@ -2,5 +2,7 @@ export interface FrontmatterExtractionResult {
     body: string;
     frontmatter: Record<string, unknown>;
 }
+/** Return true when an error came from MDX or Markdown YAML frontmatter parsing. */
+export declare function isFrontmatterSyntaxError(error: unknown): error is SyntaxError;
 export declare function extractFrontmatter(content: string, providedFrontmatter?: Record<string, unknown>): FrontmatterExtractionResult;
 //# sourceMappingURL=frontmatter-extractor.d.ts.map

package/esm/src/transforms/mdx/compiler/frontmatter-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter-extractor.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/compiler/frontmatter-extractor.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AA0CD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5C,2BAA2B,CAc7B"}
+{"version":3,"file":"frontmatter-extractor.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/compiler/frontmatter-extractor.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAQD,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAU7E;AAsDD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5C,2BAA2B,CAc7B"}

package/esm/src/transforms/mdx/compiler/frontmatter-extractor.js

@@ -1,9 +1,41 @@
 import { rendererLogger as logger } from "../../../utils/logger/logger.js";
 import { extract } from "../../../platform/compat/std/front-matter-yaml.js";
+const FRONTMATTER_SYNTAX_ERROR = Symbol.for("veryfront.transforms.mdx.frontmatter-syntax-error");
+const ObjectDefineProperty = Object.defineProperty;
+const ObjectPrototypeHasOwnProperty = Object.prototype.hasOwnProperty;
+const ReflectApply = Reflect.apply;
+const ReflectGetOwnPropertyDescriptor = Reflect.getOwnPropertyDescriptor;
+/** Return true when an error came from MDX or Markdown YAML frontmatter parsing. */
+export function isFrontmatterSyntaxError(error) {
+    try {
+        if (!(error instanceof SyntaxError))
+            return false;
+        const descriptor = ReflectGetOwnPropertyDescriptor(error, FRONTMATTER_SYNTAX_ERROR);
+        return descriptor !== undefined &&
+            ReflectApply(ObjectPrototypeHasOwnProperty, descriptor, ["value"]) === true &&
+            descriptor.value === true;
+    }
+    catch {
+        return false;
+    }
+}
+function createFrontmatterSyntaxError(cause) {
+    const error = new SyntaxError(`Invalid YAML frontmatter: ${cause.message}`, { cause });
+    ObjectDefineProperty(error, FRONTMATTER_SYNTAX_ERROR, { value: true });
+    return error;
+}
 function extractYamlFrontmatter(content) {
     if (!content.trim().startsWith("---"))
         return { body: content, frontmatter: {} };
-    const extracted = extract(content);
+    let extracted;
+    try {
+        extracted = extract(content);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            throw createFrontmatterSyntaxError(error);
+        throw error;
+    }
     return {
         body: extracted.body,
         frontmatter: extracted.attrs,

package/esm/src/transforms/mdx/compiler/mdx-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdx-compiler.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/compiler/mdx-compiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EAExB,MAAM,sCAAsC,CAAC;AAM9C,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,GAAE,iBAA4B,EACpC,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAuClC"}
+{"version":3,"file":"mdx-compiler.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/compiler/mdx-compiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EAExB,MAAM,sCAAsC,CAAC;AA4C9C,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,GAAE,iBAA4B,EACpC,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAwClC"}

package/esm/src/transforms/mdx/compiler/mdx-compiler.js

@@ -1,8 +1,43 @@
 import { rendererLogger } from "../../../utils/index.js";
 import { resolve as resolveContract } from "../../../extensions/contracts.js";
-import { createError, toError } from "../../../errors/index.js";
+import { MDX_COMPILE_ERROR, VeryfrontError } from "../../../errors/index.js";
 import { withSpan } from "../../../observability/tracing/otlp-setup.js";
+import { isFrontmatterSyntaxError } from "./frontmatter-extractor.js";
 const logger = rendererLogger.component("mdx-compiler");
+const ObjectPrototypeHasOwnProperty = Object.prototype.hasOwnProperty;
+const ReflectApply = Reflect.apply;
+const ReflectGetOwnPropertyDescriptor = Reflect.getOwnPropertyDescriptor;
+function readOwnDataProperty(value, key) {
+    try {
+        const descriptor = ReflectGetOwnPropertyDescriptor(value, key);
+        if (descriptor !== undefined &&
+            ReflectApply(ObjectPrototypeHasOwnProperty, descriptor, ["value"]) === true) {
+            return descriptor.value;
+        }
+    }
+    catch {
+        // A hostile proxy cannot provide trusted source-diagnostic evidence.
+    }
+    return undefined;
+}
+function isMdxSourceCompileError(error) {
+    const source = readOwnDataProperty(error, "source");
+    const ruleId = readOwnDataProperty(error, "ruleId");
+    const line = readOwnDataProperty(error, "line");
+    const column = readOwnDataProperty(error, "column");
+    const isMdxParserError = typeof source === "string" &&
+        /(?:^|-)mdx(?:-|$)|micromark|remark|recma|rehype/.test(source) &&
+        typeof ruleId === "string" &&
+        Number.isSafeInteger(line) &&
+        Number.isSafeInteger(column);
+    // Frontmatter failures are identified by the symbol `extractFrontmatter`
+    // stamps at the throw site, not by matching stack-frame paths: `extract()` is
+    // the only frontmatter path and it tags every SyntaxError it raises. A
+    // stack-path heuristic would only add false positives (any SyntaxError whose
+    // stack happened to pass through the YAML shim) and does not survive
+    // `deno compile` anyway.
+    return isMdxParserError || isFrontmatterSyntaxError(error);
+}
 export function compileMDXRuntime(mode, projectDir, content, frontmatter, filePath, target = "server", baseUrl, studioEmbed) {
     return withSpan("transforms.compileMDXRuntime", async () => {
         try {
@@ -19,15 +54,19 @@ export function compileMDXRuntime(mode, projectDir, content, frontmatter, filePa
             });
         }
         catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
             logger.error("Compilation failed:", {
                 filePath,
-                error: error instanceof Error ? error.message : String(error),
-                stack: error instanceof Error ? error.stack : undefined,
+                error: err.message,
+                stack: err.stack,
+            });
+            if (err instanceof VeryfrontError || !isMdxSourceCompileError(err)) {
+                throw err;
+            }
+            throw MDX_COMPILE_ERROR.create({
+                detail: `MDX compilation error: ${err.message} | file: ${filePath ?? "<memory>"}`,
+                cause: err,
             });
-            throw toError(createError({
-                type: "build",
-                message: `MDX compilation error: ${error instanceof Error ? error.message : String(error)} | file: ${filePath ?? "<memory>"}`,
-            }));
         }
     }, {
         "mdx.filePath": filePath ?? "memory",

package/esm/src/transforms/mdx/esm-module-loader/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAW5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAK9D,eAAO,MAAM,kBAAkB,wBAE7B,CAAC;AAgIH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAOvF;AAUD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1F;AAqBD,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBvF;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAQD,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAuBD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CA0ElE;AA+ED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAaT;AAED,wBAAsB,mCAAmC,CACvD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,EACpC,SAAS,GAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAiD,EAChF,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAOD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD;AAoBD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EAMnB,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAChE,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CA+J5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAe5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAK9D,eAAO,MAAM,kBAAkB,wBAE7B,CAAC;AAgIH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAOvF;AAUD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1F;AAqBD,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBvF;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAQD,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAuBD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CA+ElE;AA+ED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAaT;AAED,wBAAsB,mCAAmC,CACvD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,EACpC,SAAS,GAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAiD,EAChF,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAOD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD;AAoBD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EAMnB,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAChE,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CA+J5B"}

package/esm/src/transforms/mdx/esm-module-loader/cache/index.js

@@ -14,7 +14,7 @@ import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { LRUCache } from "../../../../utils/lru-wrapper.js";
 import { registerCache } from "../../../../utils/memory/index.js";
 import { hashCodeHex } from "../../../../utils/hash-utils.js";
-import { buildMdxEsmPathCacheKey, MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE } from "../cache-format.js";
+import { buildMdxEsmPathCacheKey, MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE, UNRESOLVED_IMPORTS_SIDECAR_SUFFIX, } from "../cache-format.js";
 import { ensureMdxModuleDependencies } from "../module-fetcher/dependency-recovery.js";
 import { findStaticImportFromSpans } from "../utils/source-spans.js";
 import { formatCacheVersionSegment, isCacheVersionSegment, } from "../../../../utils/cache-version.js";
@@ -299,7 +299,7 @@ export function invalidateModulePaths(changedPaths) {
                 });
             }
         }
-        // Delete stale .mjs files from disk
+        // Delete stale modules and their tenant-attribution evidence from disk.
         for (const mjsPath of staleMjsFiles) {
             try {
                 await localFs.remove(mjsPath);
@@ -308,6 +308,12 @@ export function invalidateModulePaths(changedPaths) {
             catch (_) {
                 /* expected: file may already be gone */
             }
+            try {
+                await localFs.remove(`${mjsPath}${UNRESOLVED_IMPORTS_SIDECAR_SUFFIX}`);
+            }
+            catch (_) {
+                /* expected: most modules have no unresolved-import evidence */
+            }
         }
     };
     _pendingDiskCleanup = _pendingDiskCleanup.then(cleanup, cleanup).catch((error) => {

package/esm/src/transforms/mdx/esm-module-loader/cache-format.d.ts

@@ -1,3 +1,4 @@
+export declare const UNRESOLVED_IMPORTS_SIDECAR_SUFFIX = ".unresolved-imports.json";
 export declare const MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE: string;
 export declare const MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE: string;
 export declare const MDX_ESM_CACHE_NAMESPACE: string;