@remix-run/assets 0.4.4 → 0.6.0

package/dist/lib/asset-server.js

@@ -1,19 +1,25 @@
 import * as path from 'node:path';
 import * as fs from 'node:fs';
-import { createAccessPolicy } from "./access.js";
-import { createAssetServerCompilationError, isAssetServerCompilationError, } from "./compilation-error.js";
-import { createFileCompiler, createResponseForFile } from "./files/compiler.js";
-import { normalizeFilesOptions, serializeAssetTransformInvocations } from "./files/config.js";
-import { getFingerprintRequestCacheControl, parseFingerprintSuffix } from "./fingerprint.js";
-import { getInjectedPackageRouteConfigs } from "./injected-packages.js";
-import { normalizeFilePath, normalizePathname } from "./paths.js";
-import { compileRoutes } from "./routes.js";
-import { createResponseForScript, createScriptCompiler } from "./scripts/compiler.js";
-import { supportedScriptExtensions } from "./scripts/resolve.js";
-import { createResponseForStyle, createStyleCompiler, isStyleFilePath } from "./styles/compiler.js";
-import { resolveScriptTarget, resolveStyleTarget } from "./target.js";
-import { createAssetServerWatcher } from "./watch.js";
+import { createAccessPolicy } from './access.js';
+import { createAssetServerCompilationError, isAssetServerCompilationError, } from './compilation-error.js';
+import { createFileCompiler, createResponseForFile } from './files/compiler.js';
+import { normalizeFilesOptions, serializeAssetTransformInvocations } from './files/config.js';
+import { getFingerprintRequestCacheControl, parseFingerprintSuffix } from './fingerprint.js';
+import { createHmrClientSource } from './hmr.js';
+import { getInjectedPackageMountConfigs } from './injected-packages.js';
+import { normalizeFilePath, normalizePathname } from './paths.js';
+import { compileRoutes } from './routes.js';
+import { createResponseForScript, createScriptCompiler } from './scripts/compiler.js';
+import { supportedScriptExtensions } from './scripts/resolve.js';
+import { createResponseForStyle, createStyleCompiler, isStyleFilePath } from './styles/compiler.js';
+import { resolveScriptTarget, resolveStyleTarget } from './target.js';
+import { createAssetServerWatcher } from './watch.js';
+import { createAssetInspector } from './inspection.js';
 const scriptExtensionSet = new Set(supportedScriptExtensions);
+const defaultMounts = {
+    app: 'app',
+    npm: 'node_modules',
+};
 const chokidarWatcherByAssetServer = new WeakMap();
 const watcherByAssetServer = new WeakMap();
 export function getInternalChokidarWatcher(assetServer) {
@@ -26,7 +32,7 @@ export function getInternalWatchTargets(assetServer) {
  * Create an asset server instance
  *
  * Compiles TypeScript/JavaScript scripts and CSS styles on demand with optional
- * source-based URL fingerprinting, caching, and configurable file mapping.
+ * source-based URL fingerprinting, caching, and configurable directory mounts.
  *
  * @param options Server configuration
  * @returns A {@link AssetServer} with `fetch()`, `getHref()`, and `getPreloads()` methods
@@ -35,10 +41,9 @@ export function getInternalWatchTargets(assetServer) {
  * ```ts
  * let assetServer = createAssetServer({
  *   basePath: '/assets',
- *   fileMap: {
- *     '/app/*path': 'app/*path',
- *   },
- *   allow: ['app/**'],
+ *   allowFiles: ['app/routes.ts', 'app/**\/public/**'],
+ *   allowPackages: ['remix'],
+ *   denyFiles: ['app/**\/*.test.*'],
  * })
  *
  * route('/assets/*path', ({ request }) => assetServer.fetch(request))
@@ -47,18 +52,52 @@ export function getInternalWatchTargets(assetServer) {
 export function createAssetServer(options) {
     let resolvedOptions = resolveAssetServerOptions(options);
     let accessPolicy = createAccessPolicy({
-        allow: resolvedOptions.allow,
-        deny: resolvedOptions.deny,
+        allowFiles: resolvedOptions.allowFiles,
+        allowPackages: resolvedOptions.allowPackages,
+        denyFiles: resolvedOptions.denyFiles,
+        packageSearchRoots: hasPackages(resolvedOptions.allowPackages)
+            ? getPackageSearchRoots(resolvedOptions.mounts, resolvedOptions.rootDir)
+            : undefined,
         rootDir: resolvedOptions.rootDir,
     });
+    let assetInspector = createAssetInspector({
+        accessPolicy,
+        allowFiles: resolvedOptions.allowFiles,
+        fileExtensions: resolvedOptions.files.extensions,
+        rootDir: resolvedOptions.rootDir,
+        routes: resolvedOptions.routes,
+    });
     let watcher = null;
     let chokidarWatcher = null;
     let fileCompiler = null;
+    let closed = false;
+    let unsubscribeBrowserHmrFileEvents;
+    let browserHmrChannelPromise = createBrowserHmrChannel(resolvedOptions.hmr, handleBrowserHmrFileEvents, () => closed, (unsubscribe) => {
+        unsubscribeBrowserHmrFileEvents = unsubscribe;
+    });
+    void browserHmrChannelPromise.catch(() => {
+        // The HMR client request and close() both await this promise. Attach a
+        // rejection handler now so async factory failures do not surface first as
+        // unhandled rejections.
+    });
+    let sendHmrPayload = resolvedOptions.hmr ? createHmrPayloadSender() : null;
+    let hmrPathnames = getHmrPathnames(resolvedOptions.basePath);
     let scriptCompiler = createScriptCompiler({
         buildId: resolvedOptions.buildId,
         define: resolvedOptions.define,
         external: resolvedOptions.external,
         fingerprintAssets: resolvedOptions.fingerprintAssets,
+        loaders: resolvedOptions.loaders,
+        hmr: sendHmrPayload
+            ? {
+                clientPathname: hmrPathnames.client,
+                send(updates) {
+                    let payload = createScriptHmrPayload(updates);
+                    if (payload)
+                        sendHmrPayload(payload);
+                },
+            }
+            : undefined,
         isAllowed: accessPolicy.isAllowed,
         minify: resolvedOptions.minify,
         onWatchDirectoriesChange: (delta) => {
@@ -66,6 +105,9 @@ export function createAssetServer(options) {
                 return;
             watcher.updateWatchedDirectories(delta);
         },
+        onWatchFilesChange: (delta) => {
+            updateBrowserHmrWatchedFiles(delta);
+        },
         rootDir: resolvedOptions.rootDir,
         routes: resolvedOptions.routes,
         sourceMapSourcePaths: resolvedOptions.sourceMapSourcePaths,
@@ -88,6 +130,22 @@ export function createAssetServer(options) {
             }
             return fileCompiler.getHref(identityPath, { transform: options.transform });
         },
+        hmr: sendHmrPayload
+            ? {
+                send(pathname, timestamp) {
+                    sendHmrPayload({
+                        timestamp,
+                        type: 'browser:update',
+                        updates: [
+                            {
+                                path: pathname,
+                                type: 'css',
+                            },
+                        ],
+                    });
+                },
+            }
+            : undefined,
         isAllowed: accessPolicy.isAllowed,
         isServedFilePath(filePath) {
             return fileCompiler?.isServedFilePath(filePath) ?? false;
@@ -98,6 +156,9 @@ export function createAssetServer(options) {
                 return;
             watcher.updateWatchedDirectories(delta, { includeAncestors: false });
         },
+        onWatchFilesChange: (delta) => {
+            updateBrowserHmrWatchedFiles(delta);
+        },
         rootDir: resolvedOptions.rootDir,
         routes: resolvedOptions.routes,
         sourceMapSourcePaths: resolvedOptions.sourceMapSourcePaths,
@@ -128,6 +189,7 @@ export function createAssetServer(options) {
             onFileEvent: handleWatchEvent,
             rootDir: resolvedOptions.rootDir,
         });
+        watcher.updateWatchedDirectories({ add: accessPolicy.getPackageWatchDirectories(), remove: [] }, { includeAncestors: false });
     }
     async function responseForError(error) {
         try {
@@ -141,21 +203,71 @@ export function createAssetServer(options) {
     async function handleWatchEvent(filePath, event) {
         try {
             let normalizedFilePath = normalizeFilePath(filePath);
-            await scriptCompiler.handleFileEvent(normalizedFilePath, event);
-            await styleCompiler.handleFileEvent(normalizedFilePath, event);
+            accessPolicy.handleFileEvent(normalizedFilePath);
+            scriptCompiler.invalidateFileEvent(normalizedFilePath, event);
+            styleCompiler.invalidateFileEvent(normalizedFilePath, event);
             await fileCompiler?.handleFileEvent(normalizedFilePath, event);
         }
         catch (error) {
             console.error(`There was an error invalidating the asset server cache: ${error}`);
         }
     }
+    async function handleBrowserHmrFileEvents(events) {
+        let browserHmrEvents = [];
+        for (let event of events) {
+            let normalizedFilePath = normalizeFilePath(event.filePath);
+            let scriptUpdates = await scriptCompiler.classifyHmrFileEvent(normalizedFilePath, event.event);
+            let scriptPayload = createScriptHmrPayload(scriptUpdates);
+            if (scriptPayload) {
+                browserHmrEvents.push(createBrowserHmrEvent(scriptPayload, getScriptHmrUpdateFiles(scriptUpdates)));
+            }
+            let styleUpdates = await styleCompiler.classifyHmrFileEvent(normalizedFilePath, event.event);
+            for (let styleUpdate of styleUpdates) {
+                browserHmrEvents.push(createBrowserHmrEvent({
+                    timestamp: styleUpdate.timestamp,
+                    type: 'browser:update',
+                    updates: [
+                        {
+                            path: styleUpdate.path,
+                            type: 'css',
+                        },
+                    ],
+                }, [styleUpdate.filePath]));
+            }
+            await fileCompiler?.handleFileEvent(normalizedFilePath, event.event);
+        }
+        return browserHmrEvents;
+    }
+    function updateBrowserHmrWatchedFiles(delta) {
+        browserHmrChannelPromise
+            .then((channel) => {
+            channel?.updateWatchedFiles(delta);
+        })
+            .catch((error) => {
+            console.error(`There was an error updating browser HMR watched files: ${error}`);
+        });
+    }
     let assetServer = {
+        getAssetDetails(input) {
+            return assetInspector.getAssetDetails(input);
+        },
+        getAssets() {
+            return assetInspector.getAssets();
+        },
         async fetch(request) {
             if (request.method !== 'GET' && request.method !== 'HEAD')
                 return null;
+            let requestPathname = new URL(request.url).pathname;
+            if (resolvedOptions.hmr) {
+                if (requestPathname === hmrPathnames.client) {
+                    let browserHmrChannel = await browserHmrChannelPromise;
+                    assertBrowserEventUrl(browserHmrChannel?.url);
+                    return createHmrClientResponse(browserHmrChannel.url, request.method);
+                }
+            }
             let requestUrl = new URL(request.url);
             let requestedTransform = normalizeRequestedTransformQuery(requestUrl.searchParams);
-            let parsedRequestPathname = parseAssetRequestPathname(requestUrl.pathname, {
+            let parsedRequestPathname = parseAssetRequestPathname(requestPathname, {
                 fingerprintAssets: resolvedOptions.fingerprintAssets,
                 routes: resolvedOptions.routes,
             });
@@ -246,7 +358,7 @@ export function createAssetServer(options) {
                 });
             }
             catch (error) {
-                // A direct request can race with the filesystem or fail a deeper allow check while
+                // A direct request can race with the filesystem or fail a deeper allowFiles check while
                 // compiling imports. In this fetch context, both cases should fall through as "not
                 // handled here" so the outer router can continue to its own 404 behavior.
                 if (isAssetServerCompilationError(error) &&
@@ -341,7 +453,19 @@ export function createAssetServer(options) {
             return mergePreloadLayers(await Promise.all(preloadLayerGroupPromises));
         },
         async close() {
-            await watcher?.close();
+            if (closed)
+                return;
+            closed = true;
+            let unsubscribe = unsubscribeBrowserHmrFileEvents;
+            unsubscribeBrowserHmrFileEvents = undefined;
+            unsubscribe?.();
+            try {
+                let channel = await browserHmrChannelPromise;
+                channel?.close();
+            }
+            finally {
+                await watcher?.close();
+            }
         },
     };
     if (chokidarWatcher) {
@@ -377,6 +501,67 @@ function badRequest(message) {
         headers: { 'Content-Type': 'text/plain; charset=utf-8' },
     });
 }
+function getHmrPathnames(basePath) {
+    let hmrBase = `${basePath}/__remix_hmr`;
+    return {
+        client: `${hmrBase}/client.js`,
+        events: `${hmrBase}/events`,
+    };
+}
+function createHmrClientResponse(eventPathname, method) {
+    return new Response(method === 'HEAD' ? null : createHmrClientSource({ eventPathname }), {
+        headers: {
+            'Cache-Control': 'no-cache',
+            'Content-Type': 'application/javascript; charset=utf-8',
+        },
+    });
+}
+function assertBrowserEventUrl(url) {
+    if (url === undefined) {
+        throw new TypeError('hmr must be provided');
+    }
+}
+function createHmrPayloadSender() {
+    return () => { };
+}
+function createBrowserHmrEvent(payload, files) {
+    if (payload.type === 'browser:reload') {
+        return {
+            ...(files.length === 0 ? {} : { files: [...files] }),
+            type: 'reload',
+        };
+    }
+    return {
+        ...(files.length === 0 ? {} : { files: [...files] }),
+        timestamp: payload.timestamp,
+        type: 'update',
+        updates: payload.updates,
+    };
+}
+function getScriptHmrUpdateFiles(updates) {
+    return [...new Set(updates.map((update) => update.filePath))];
+}
+export function createScriptHmrPayload(updates) {
+    let timestamp = updates[0]?.timestamp ?? Date.now();
+    let rejectedUpdate = updates.find((update) => !update.accepted);
+    if (rejectedUpdate) {
+        return {
+            type: 'browser:reload',
+        };
+    }
+    let acceptedUpdates = updates.filter((update) => update.accepted);
+    if (acceptedUpdates.length === 0)
+        return null;
+    return {
+        timestamp,
+        type: 'browser:update',
+        updates: acceptedUpdates.map((update) => ({
+            ...(update.acceptedPath === update.path ? {} : { acceptedPath: update.acceptedPath }),
+            path: update.path,
+            type: 'js',
+        })),
+    };
+}
 function mergePreloadLayers(preloadLayersByRoot) {
     let urls = [];
     let seen = new Set();
@@ -422,32 +607,92 @@ function resolveAssetServerOptions(options) {
         fingerprint: options.fingerprint,
         watch: options.watch,
     });
+    let watchOptions = normalizeWatchOptions(options.watch);
+    let hmrFactory = normalizeHmrFactory(options.hmr);
+    let mounts = options.mounts ?? defaultMounts;
+    if (hmrFactory && watchOptions === null) {
+        throw new TypeError('hmr requires watch mode');
+    }
+    if (Object.keys(mounts).length === 0) {
+        throw new TypeError('mounts must include at least one entry');
+    }
     return {
-        allow: options.allow,
+        allowFiles: options.allowFiles,
+        allowPackages: options.allowPackages,
         basePath,
         buildId: fingerprintOptions.buildId,
         define: scriptOptions.define,
-        deny: options.deny,
+        denyFiles: options.denyFiles,
         external: scriptOptions.external ?? [],
         files: normalizeFilesOptions(options.files),
         fingerprintAssets: fingerprintOptions.enabled,
+        hmr: hmrFactory,
         minify: options.minify ?? false,
+        mounts,
+        loaders: scriptOptions.loaders ?? [],
         onError: options.onError ?? defaultErrorHandler,
         rootDir,
         routes: compileRoutes(basePath, [
             {
-                fileMap: options.fileMap,
+                mounts,
                 rootDir,
             },
-            ...getInjectedPackageRouteConfigs(),
+            ...getInjectedPackageMountConfigs(),
         ]),
         sourceMapSourcePaths: options.sourceMapSourcePaths ?? 'url',
         sourceMaps: options.sourceMaps,
         scriptsTarget: resolveScriptTarget(options.target),
         stylesTarget: resolveStyleTarget(options.target),
-        watchOptions: normalizeWatchOptions(options.watch),
+        watchOptions,
     };
 }
+function normalizeHmrFactory(factory) {
+    if (factory === undefined)
+        return null;
+    if (typeof factory !== 'function') {
+        throw new TypeError('hmr must be a function');
+    }
+    return factory;
+}
+function createBrowserHmrChannel(createChannel, handleFileEvents, isClosed, setUnsubscribe) {
+    if (!createChannel)
+        return Promise.resolve(null);
+    let channelOrPromise;
+    try {
+        channelOrPromise = createChannel();
+    }
+    catch (error) {
+        return Promise.reject(error);
+    }
+    return Promise.resolve(channelOrPromise).then((channel) => {
+        if (channel === undefined)
+            return null;
+        validateBrowserHmrChannel(channel);
+        if (isClosed()) {
+            channel.close();
+            return null;
+        }
+        setUnsubscribe(channel.onFileEvents(handleFileEvents));
+        return channel;
+    });
+}
+function validateBrowserHmrChannel(channel) {
+    if (channel === null || typeof channel !== 'object') {
+        throw new TypeError('hmr must create an object');
+    }
+    if (!('url' in channel) || typeof channel.url !== 'string') {
+        throw new TypeError('hmr must create a channel with a string url');
+    }
+    if (!('close' in channel) || typeof channel.close !== 'function') {
+        throw new TypeError('hmr must create a channel with a close function');
+    }
+    if (!('onFileEvents' in channel) || typeof channel.onFileEvents !== 'function') {
+        throw new TypeError('hmr must create a channel with an onFileEvents function');
+    }
+    if (!('updateWatchedFiles' in channel) || typeof channel.updateWatchedFiles !== 'function') {
+        throw new TypeError('hmr must create a channel with an updateWatchedFiles function');
+    }
+}
 function normalizeBasePath(basePath) {
     if (typeof basePath !== 'string') {
         throw new TypeError('basePath must be a string');
@@ -481,6 +726,12 @@ function normalizeWatchOptions(options) {
         return {};
     return options;
 }
+function hasPackages(packages) {
+    return packages !== undefined && packages.length > 0;
+}
+function getPackageSearchRoots(mounts, rootDir) {
+    return Object.values(mounts).map((fileRoot) => path.resolve(rootDir, fileRoot));
+}
 function parseAssetRequestPathname(pathname, options) {
     let isSourceMapRequest = pathname.endsWith('.map');
     let pathWithoutMap = isSourceMapRequest ? pathname.slice(0, -4) : pathname;

package/dist/lib/compilation-error.d.ts

@@ -1,4 +1,4 @@
-type AssetServerCompilationErrorCode = 'FILE_NOT_FOUND' | 'FILE_NOT_ALLOWED' | 'FILE_NOT_SUPPORTED' | 'FILE_OUTSIDE_FILE_MAP' | 'FILE_TRANSFORM_QUERY_INVALID' | 'FILE_TRANSFORM_NOT_SUPPORTED' | 'FILE_TRANSFORM_RESULT_INVALID' | 'FILE_TRANSFORM_FAILED' | 'COMMONJS_NOT_SUPPORTED' | 'TRANSFORM_FAILED' | 'EMIT_FAILED' | 'IMPORT_RESOLUTION_FAILED' | 'IMPORT_NOT_SUPPORTED' | 'IMPORT_NOT_ALLOWED' | 'IMPORT_OUTSIDE_FILE_MAP' | 'URL_RESOLUTION_FAILED' | 'URL_NOT_SUPPORTED' | 'URL_NOT_ALLOWED' | 'URL_OUTSIDE_FILE_MAP';
+type AssetServerCompilationErrorCode = 'FILE_NOT_FOUND' | 'FILE_NOT_ALLOWED' | 'FILE_NOT_SUPPORTED' | 'FILE_OUTSIDE_MOUNTS' | 'FILE_TRANSFORM_QUERY_INVALID' | 'FILE_TRANSFORM_NOT_SUPPORTED' | 'FILE_TRANSFORM_RESULT_INVALID' | 'FILE_TRANSFORM_FAILED' | 'COMMONJS_NOT_SUPPORTED' | 'TRANSFORM_FAILED' | 'LOADER_FAILED' | 'EMIT_FAILED' | 'IMPORT_RESOLUTION_FAILED' | 'IMPORT_NOT_SUPPORTED' | 'IMPORT_NOT_ALLOWED' | 'IMPORT_OUTSIDE_MOUNTS' | 'URL_RESOLUTION_FAILED' | 'URL_NOT_SUPPORTED' | 'URL_NOT_ALLOWED' | 'URL_OUTSIDE_MOUNTS';
 /**
  * Internal error used by the request-time asset compilation pipeline.
  */

package/dist/lib/compilation-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compilation-error.d.ts","sourceRoot":"","sources":["../../src/lib/compilation-error.ts"],"names":[],"mappings":"AAAA,KAAK,+BAA+B,GAChC,gBAAgB,GAChB,kBAAkB,GAClB,oBAAoB,GACpB,uBAAuB,GACvB,8BAA8B,GAC9B,8BAA8B,GAC9B,+BAA+B,GAC/B,uBAAuB,GACvB,wBAAwB,GACxB,kBAAkB,GAClB,aAAa,GACb,0BAA0B,GAC1B,sBAAsB,GACtB,oBAAoB,GACpB,yBAAyB,GACzB,uBAAuB,GACvB,mBAAmB,GACnB,iBAAiB,GACjB,sBAAsB,CAAA;AAE1B;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,IAAI,EAAE,+BAA+B,CAAA;IAErC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,IAAI,EAAE,+BAA+B,CAAA;KACtC,EAKF;CACF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,+BAA+B,CAAA;CACtC,GACA,2BAA2B,CAE7B"}
+{"version":3,"file":"compilation-error.d.ts","sourceRoot":"","sources":["../../src/lib/compilation-error.ts"],"names":[],"mappings":"AAAA,KAAK,+BAA+B,GAChC,gBAAgB,GAChB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,8BAA8B,GAC9B,8BAA8B,GAC9B,+BAA+B,GAC/B,uBAAuB,GACvB,wBAAwB,GACxB,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,0BAA0B,GAC1B,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,GACvB,uBAAuB,GACvB,mBAAmB,GACnB,iBAAiB,GACjB,oBAAoB,CAAA;AAExB;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,IAAI,EAAE,+BAA+B,CAAA;IAErC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,IAAI,EAAE,+BAA+B,CAAA;KACtC,EAKF;CACF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,+BAA+B,CAAA;CACtC,GACA,2BAA2B,CAE7B"}

package/dist/lib/file-matcher.js

@@ -1,6 +1,6 @@
 import * as fs from 'node:fs';
 import picomatch from 'picomatch';
-import { normalizeFilePath, resolveFilePath } from "./paths.js";
+import { normalizeFilePath, resolveFilePath } from './paths.js';
 export function createFileMatcher(pattern, rootDir, options = {}) {
     let resolvedPatternPath = resolveFilePath(rootDir, pattern);
     let allowDirectories = options.allowDirectories ?? true;

package/dist/lib/files/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/lib/files/compiler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAU1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAA;AAU7F,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,UAAU,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CAAA;AAID,KAAK,iBAAiB,GAAG,WAAW,CAAA;AAEpC,KAAK,aAAa,GACd;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,cAAc,CAAA;CACrB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAEL,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,KAAK,mBAAmB,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gBAAgB,EAAE,SAAS;QACzB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,SAAS,CACP,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE;YACP,SAAS,EAAE,MAAM,CAAA;YACjB,QAAQ,EAAE,MAAM,CAAA;SACjB,GAEC,MAAM,GACN,UAAU,GACV,wBAAwB,GACxB,IAAI,GACJ,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,wBAAwB,GAAG,IAAI,CAAC,CAAA;KACnE,EAAE,CAAA;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,oBAAoB,EAAE,MAAM,CAAA;IAC5B,UAAU,EAAE,gCAAgC,CAAA;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAC1E,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3C,sBAAsB,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CAChE,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC/B,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,MAAM,EAAE,cAAc,CAAA;CACvB,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAkBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAma7E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,YAAY,CAkC1F;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE;IACP,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf,GACA,QAAQ,CAYV;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAE3F"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/lib/files/compiler.ts"],"names":[],"mappings":"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"}

package/dist/lib/files/compiler.js

@@ -4,11 +4,11 @@ import * as path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { IfNoneMatch } from '@remix-run/headers/if-none-match';
 import { detectContentType } from '@remix-run/mime';
-import { createAssetServerCompilationError, isAssetServerCompilationError, } from "../compilation-error.js";
-import { formatFingerprintedPathname, generateFingerprint, hashContent } from "../fingerprint.js";
-import { normalizeFilePath, resolveFilePath } from "../paths.js";
-import { parseAssetTransformInvocations } from "./config.js";
-import { createSourceFileStore } from "./store.js";
+import { createAssetServerCompilationError, isAssetServerCompilationError, } from '../compilation-error.js';
+import { formatFingerprintedPathname, generateFingerprint, hashContent } from '../fingerprint.js';
+import { normalizeFilePath, resolveFilePath } from '../paths.js';
+import { parseAssetTransformInvocations } from './config.js';
+import { createSourceFileStore } from './store.js';
 export function createFileCompiler(options) {
     let resolvedOptions = {
         ...options,
@@ -327,14 +327,15 @@ export function resolveServedFileOrThrow(filePath, args) {
         });
     }
     if (!args.isAllowed(identityPath)) {
-        throw createAssetServerCompilationError(`File is not allowed: ${identityPath}`, {
+        throw createAssetServerCompilationError(`File "${identityPath}" is not allowed by the asset server access configuration. ` +
+            `Add a matching allowFiles or allowPackages rule, or remove a conflicting denyFiles rule.`, {
             code: 'FILE_NOT_ALLOWED',
         });
     }
     let stableUrlPathname = args.routes.toUrlPathname(identityPath);
     if (!stableUrlPathname) {
-        throw createAssetServerCompilationError(`File ${identityPath} is outside all configured fileMap entries.`, {
-            code: 'FILE_OUTSIDE_FILE_MAP',
+        throw createAssetServerCompilationError(`File ${identityPath} is outside all configured mounts.`, {
+            code: 'FILE_OUTSIDE_MOUNTS',
         });
     }
     return {

package/dist/lib/files/config.js

@@ -1,4 +1,4 @@
-import { supportedScriptExtensions } from "../scripts/resolve.js";
+import { supportedScriptExtensions } from '../scripts/resolve.js';
 export function defineFileTransform(transform) {
     return transform;
 }

package/dist/lib/hmr.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Messages consumed by the browser HMR client.
+ *
+ * Server runtimes use `server:update` to request reconciliation with freshly rendered server
+ * output. Asset tooling uses `browser:update` for updates accepted by JavaScript or CSS boundaries,
+ * and falls back to `browser:reload` when the page must reload.
+ */
+export type HmrPayload = {
+    /** Indicates that server-rendered output may have changed. */
+    type: 'server:update';
+} | {
+    /** JavaScript and CSS modules that the browser should update. */
+    updates: Array<{
+        /** Importing module whose dependency-accept handler accepts this update. */
+        acceptedPath?: string;
+        /** Public URL of the changed JavaScript module. */
+        path: string;
+        /** Identifies a JavaScript module update. */
+        type: 'js';
+    } | {
+        /** Public URL of the changed stylesheet. */
+        path: string;
+        /** Identifies a stylesheet update. */
+        type: 'css';
+    }>;
+    /** Update time used to bypass browser module and stylesheet caches. */
+    timestamp: number;
+    /** Indicates that the listed browser modules should update in place. */
+    type: 'browser:update';
+} | {
+    /** Indicates that no HMR boundary accepted the change and the page must reload. */
+    type: 'browser:reload';
+};
+export declare function createHmrClientSource(options: {
+    eventPathname: string;
+}): string;
+//# sourceMappingURL=hmr.d.ts.map

package/dist/lib/hmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../../src/lib/hmr.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,8DAA8D;IAC9D,IAAI,EAAE,eAAe,CAAA;CACtB,GACD;IACE,iEAAiE;IACjE,OAAO,EAAE,KAAK,CACV;QACE,4EAA4E;QAC5E,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,mDAAmD;QACnD,IAAI,EAAE,MAAM,CAAA;QACZ,6CAA6C;QAC7C,IAAI,EAAE,IAAI,CAAA;KACX,GACD;QACE,4CAA4C;QAC5C,IAAI,EAAE,MAAM,CAAA;QACZ,sCAAsC;QACtC,IAAI,EAAE,KAAK,CAAA;KACZ,CACJ,CAAA;IACD,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,IAAI,EAAE,gBAAgB,CAAA;CACvB,GACD;IACE,mFAAmF;IACnF,IAAI,EAAE,gBAAgB,CAAA;CACvB,CAAA;AAEL,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoWhF"}