@remix-run/assets 0.5.0 → 0.7.0

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

@@ -1 +1 @@
-{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/lib/fingerprint.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAIhG;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;CAC9C,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlB;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACxD,QAAQ,EAAE,MAAM,CAAA;IAChB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAyBA;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAahG;AAED,wBAAgB,iCAAiC,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE7F"}
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/lib/fingerprint.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAIhG;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACxD,QAAQ,EAAE,MAAM,CAAA;IAChB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAyBA;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAahG;AAED,wBAAgB,iCAAiC,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE7F"}

package/dist/lib/fingerprint.js

@@ -5,10 +5,6 @@ export async function hashContent(content) {
     let hashBuffer = await crypto.subtle.digest('SHA-256', bytes);
     return Buffer.from(hashBuffer).toString('base64url').slice(0, 6);
 }
-export async function generateFingerprint(args) {
-    let content = typeof args.content === 'string' ? args.content : Buffer.from(args.content).toString('base64');
-    return hashContent(JSON.stringify([content, args.buildId]));
-}
 export function parseFingerprintSuffix(pathname) {
     let lastSlashIndex = pathname.lastIndexOf('/');
     let directory = lastSlashIndex >= 0 ? pathname.slice(0, lastSlashIndex + 1) : '';

package/dist/lib/hmr.d.ts

@@ -13,6 +13,11 @@ export type HmrPayload = {
     updates: Array<{
         /** Importing module whose dependency-accept handler accepts this update. */
         acceptedPath?: string;
+        /** Import map entries required before this update can be evaluated. */
+        importMap?: {
+            imports: Record<string, string>;
+            scopes?: Record<string, Record<string, string>>;
+        };
         /** Public URL of the changed JavaScript module. */
         path: string;
         /** Identifies a JavaScript module update. */
@@ -32,6 +37,8 @@ export type HmrPayload = {
     type: 'browser:reload';
 };
 export declare function createHmrClientSource(options: {
+    dataKey: string;
     eventPathname: string;
+    moduleImporter: string | null;
 }): string;
 //# sourceMappingURL=hmr.d.ts.map

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

@@ -1 +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"}
+{"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,uEAAuE;QACvE,SAAS,CAAC,EAAE;YACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;SAChD,CAAA;QACD,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;IAC7C,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,GAAG,MAAM,CAmhBT"}

package/dist/lib/hmr.js

@@ -1,5 +1,9 @@
 export function createHmrClientSource(options) {
     return `
+${options.moduleImporter
+        ? `import { importModule as __remixImport } from ${JSON.stringify(options.moduleImporter)}`
+        : 'const __remixImport = (specifier) => import(specifier)'}
+
 const contexts = new Map()
 const dataByPath = new Map()
 
@@ -71,6 +75,13 @@ let reconnectPending = false
 let pageReloadTimer
 let failedJavaScriptUpdates = new Map()
 let stylesheetUpdatePromise = Promise.resolve()
+let installedImportMap = { imports: new Map(), scopes: new Map() }
+let processedScripts = new WeakSet()
+
+let observer = new MutationObserver(processMutations)
+observer.observe(document, { childList: true })
+observer.observe(document.head, { childList: true })
+processImportMaps()
 
 let events = new EventSource(${JSON.stringify(options.eventPathname)})
 
@@ -96,11 +107,18 @@ events.onerror = () => {
 
 events.onmessage = (event) => {
   let payload = JSON.parse(event.data)
+  if (payload.type === 'browser:update') {
+    let update = payload.data?.[${JSON.stringify(options.dataKey)}]
+    if (!update) return
+    handleBrowserUpdate(update).catch((error) => {
+      console.error('[remix] HMR update failed', error)
+      if (update.updates.some((entry) => entry.type !== 'js')) reloadPage()
+    })
+    return
+  }
   handlePayload(payload).catch((error) => {
     console.error('[remix] HMR update failed', error)
-    if (payload.type !== 'browser:update' || payload.updates.some((update) => update.type !== 'js')) {
-      reloadPage()
-    }
+    reloadPage()
   })
 }
 
@@ -115,27 +133,28 @@ async function handlePayload(payload) {
     await dispatchCustomEvent(payload.type, payload)
     return
   }
+}
 
-  if (payload.type === 'browser:update') {
-    for (let update of payload.updates) {
-      if (update.type === 'css') {
-        let updated = await queueStylesheetUpdate(update.path, payload.timestamp)
-        if (updated) console.debug('[remix] HMR updated stylesheet', update.path)
-        continue
-      }
+async function handleBrowserUpdate(payload) {
+  for (let update of payload.updates) {
+    if (update.type === 'css') {
+      let updated = await queueStylesheetUpdate(update.path, payload.timestamp)
+      if (updated) console.debug('[remix] HMR updated stylesheet', update.path)
+      continue
+    }
 
-      try {
-        let updated = await updateJavaScriptModule(
-          update.path,
-          update.acceptedPath ?? update.path,
-          payload.timestamp,
-        )
-        failedJavaScriptUpdates.delete(update.path)
-        if (updated) console.debug('[remix] HMR accepted update', update.path)
-      } catch (error) {
-        failedJavaScriptUpdates.set(update.path, update.acceptedPath ?? update.path)
-        throw error
-      }
+    try {
+      if (update.importMap && !installImportMap(update.importMap)) return
+      let updated = await updateJavaScriptModule(
+        update.path,
+        update.acceptedPath ?? update.path,
+        payload.timestamp,
+      )
+      failedJavaScriptUpdates.delete(update.path)
+      if (updated) console.debug('[remix] HMR accepted update', update.path)
+    } catch (error) {
+      failedJavaScriptUpdates.set(update.path, update.acceptedPath ?? update.path)
+      throw error
     }
   }
 }
@@ -204,7 +223,7 @@ async function updateJavaScriptModule(path, acceptedPath, timestamp) {
       await callback(previousContext.data)
     }
 
-    let updatedModule = await import(withTimestamp(path, timestamp))
+    let updatedModule = await __remixImport(withTimestamp(path, timestamp), import.meta.url)
     previousContext.invalidated = false
     previousContext.updating = true
     try {
@@ -227,7 +246,7 @@ async function updateJavaScriptModule(path, acceptedPath, timestamp) {
     }
   }
 
-  let updatedModule = await import(withTimestamp(acceptedPath, timestamp))
+  let updatedModule = await __remixImport(withTimestamp(acceptedPath, timestamp), import.meta.url)
   previousContext.invalidated = false
   previousContext.updating = true
   try {
@@ -258,7 +277,7 @@ async function propagateInvalidatedJavaScriptModule(path, timestamp) {
       await callback(importerContext.data)
     }
 
-    let updatedModule = await import(withTimestamp(path, timestamp))
+    let updatedModule = await __remixImport(withTimestamp(path, timestamp), import.meta.url)
     importerContext.invalidated = false
     importerContext.updating = true
     try {
@@ -346,6 +365,160 @@ function withTimestamp(path, timestamp) {
   return url.pathname + url.search
 }
 
+function installImportMap(importMap) {
+  processMutations(observer.takeRecords())
+  processImportMaps()
+  let delta = getImportMapDelta(installedImportMap, importMap)
+  if (delta === null) {
+    reloadPage()
+    return false
+  }
+  if (!delta) return true
+
+  let script = document.createElement('script')
+  script.setAttribute('data-rmx-import-map', '')
+  script.type = 'importmap'
+  script.textContent = JSON.stringify(delta)
+  document.head.appendChild(script)
+  processedScripts.add(script)
+  mergeImportMap(installedImportMap, delta)
+  return true
+}
+
+function processImportMap(script) {
+  if (processedScripts.has(script)) return
+  processedScripts.add(script)
+
+  let importMap
+  try {
+    importMap = JSON.parse(script.textContent ?? '')
+  } catch {
+    return
+  }
+  if (!importMap || typeof importMap !== 'object') return
+  mergeImportMap(installedImportMap, importMap)
+}
+
+function processImportMaps() {
+  for (let script of document.querySelectorAll('script[type="importmap"]')) {
+    processImportMap(script)
+  }
+}
+
+function processMutations(mutations) {
+  for (let mutation of mutations) {
+    if (mutation.type !== 'childList') continue
+    for (let node of mutation.addedNodes) {
+      if (node instanceof HTMLScriptElement && node.matches('script[type="importmap"]')) {
+        processImportMap(node)
+      }
+    }
+  }
+}
+
+function getImportMapDelta(installed, importMap) {
+  let imports = getImportMapImportsDelta(installed.imports, importMap.imports)
+  if (imports === null) return null
+
+  let scopes
+  if (importMap.scopes && typeof importMap.scopes === 'object') {
+    scopes = {}
+    for (let [scope, entries] of Object.entries(importMap.scopes)) {
+      let normalizedScope = normalizeImportMapUrl(scope)
+      if (!normalizedScope || !entries || typeof entries !== 'object') continue
+      let installedEntries = installed.scopes.get(normalizedScope) ?? new Map()
+      let entriesDelta = getImportMapImportsDelta(installedEntries, entries, scope)
+      if (entriesDelta === null) return null
+      if (entriesDelta) scopes[scope] = entriesDelta
+    }
+    if (Object.keys(scopes).length === 0) scopes = undefined
+  }
+
+  if (!imports && !scopes) return undefined
+  return {
+    ...(imports ? { imports } : null),
+    ...(scopes ? { scopes } : null),
+  }
+}
+
+function getImportMapImportsDelta(installed, entries, scope) {
+  if (!entries || typeof entries !== 'object') return undefined
+  let delta = {}
+  for (let [specifier, href] of Object.entries(entries)) {
+    if (href !== null && typeof href !== 'string') continue
+    let normalizedSpecifier = normalizeImportMapSpecifier(specifier)
+    if (!normalizedSpecifier) continue
+    let normalizedHref = normalizeImportMapAddress(href)
+    let existing = installed.get(normalizedSpecifier)
+    if (existing === normalizedHref) continue
+    if (existing !== undefined) {
+      let scopeDescription = scope ? \` in scope "\${scope}"\` : ''
+      console.warn(
+        \`[remix] HMR reloading page after import map conflict for "\${specifier}"\${scopeDescription}: \` +
+          formatImportMapAddress(existing) +
+          ' is already installed, but the new map points to ' +
+          formatImportMapAddress(normalizedHref),
+      )
+      return null
+    }
+    delta[specifier] = href
+  }
+  return Object.keys(delta).length > 0 ? delta : undefined
+}
+
+function mergeImportMap(installed, importMap) {
+  mergeImportMapImports(installed.imports, importMap.imports)
+  if (!importMap.scopes || typeof importMap.scopes !== 'object') return
+  for (let [scope, entries] of Object.entries(importMap.scopes)) {
+    let normalizedScope = normalizeImportMapUrl(scope)
+    if (!normalizedScope || !entries || typeof entries !== 'object') continue
+    let installedEntries = installed.scopes.get(normalizedScope)
+    if (!installedEntries) {
+      installedEntries = new Map()
+      installed.scopes.set(normalizedScope, installedEntries)
+    }
+    mergeImportMapImports(installedEntries, entries)
+  }
+}
+
+function mergeImportMapImports(installed, entries) {
+  if (!entries || typeof entries !== 'object') return
+  for (let [specifier, href] of Object.entries(entries)) {
+    if (href !== null && typeof href !== 'string') continue
+    let normalizedSpecifier = normalizeImportMapSpecifier(specifier)
+    if (!normalizedSpecifier || installed.has(normalizedSpecifier)) continue
+    installed.set(normalizedSpecifier, normalizeImportMapAddress(href))
+  }
+}
+
+function normalizeImportMapSpecifier(specifier) {
+  if (
+    specifier.startsWith('/') ||
+    specifier.startsWith('./') ||
+    specifier.startsWith('../') ||
+    URL.canParse(specifier)
+  ) {
+    return normalizeImportMapUrl(specifier)
+  }
+  return specifier
+}
+
+function normalizeImportMapAddress(href) {
+  return href === null ? null : normalizeImportMapUrl(href)
+}
+
+function formatImportMapAddress(href) {
+  return href === null ? 'null' : '"' + href + '"'
+}
+
+function normalizeImportMapUrl(value) {
+  try {
+    return new URL(value, document.baseURI).href
+  } catch {
+    return null
+  }
+}
+
 function reloadPage() {
   if (pageReloadTimer) clearTimeout(pageReloadTimer)
   pageReloadTimer = setTimeout(() => {

package/dist/lib/injected-packages.d.ts

@@ -1,8 +1,9 @@
 export declare function isInjectedPackageFilePath(filePath: string): boolean;
-export declare function getInjectedPackageRouteConfigs(): {
-    fileMap: Record<string, string>;
+export declare function getInjectedPackageMountConfigs(): {
+    mounts: Record<string, string>;
     rootDir: string;
 }[];
+export declare function getInjectedPackageRoots(): readonly string[];
 export declare function getInjectedPackageNameForSpecifier(specifier: string): string | null;
 export declare function mayContainInjectedPackageSpecifier(sourceText: string): boolean;
 export declare function maskAuthoredInjectedPackageSpecifier(specifier: string): string | null;

package/dist/lib/injected-packages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injected-packages.d.ts","sourceRoot":"","sources":["../../src/lib/injected-packages.ts"],"names":[],"mappings":"AAiBA,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWnE;AAED,wBAAgB,8BAA8B,IAAI;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,OAAO,EAAE,MAAM,CAAA;CAChB,EAAE,CAYF;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcnF;AAED,wBAAgB,kCAAkC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrF;AAED,wBAAgB,uCAAuC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYxF;AAWD,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD"}
+{"version":3,"file":"injected-packages.d.ts","sourceRoot":"","sources":["../../src/lib/injected-packages.ts"],"names":[],"mappings":"AAiBA,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWnE;AAED,wBAAgB,8BAA8B,IAAI;IAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;CAChB,EAAE,CAYF;AAED,wBAAgB,uBAAuB,IAAI,SAAS,MAAM,EAAE,CAI3D;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcnF;AAED,wBAAgB,kCAAkC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrF;AAED,wBAAgB,uCAAuC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYxF;AAWD,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD"}

package/dist/lib/injected-packages.js

@@ -16,18 +16,21 @@ export function isInjectedPackageFilePath(filePath) {
     }
     return false;
 }
-export function getInjectedPackageRouteConfigs() {
+export function getInjectedPackageMountConfigs() {
     return injectedPackageNames.map((packageName) => {
         let { packageRoot } = getResolvedInjectedPackage(packageName);
-        let { filePattern, routeRoot } = getInjectedPackageRoute(packageRoot, packageName);
+        let { fileRoot, routeRoot } = getInjectedPackageRoute(packageRoot, packageName);
         return {
-            fileMap: {
-                [getInjectedPackageRoutePattern(packageName)]: filePattern,
+            mounts: {
+                [getInjectedPackageMountPath(packageName)]: fileRoot,
             },
             rootDir: routeRoot,
         };
     });
 }
+export function getInjectedPackageRoots() {
+    return injectedPackageNames.map((packageName) => getResolvedInjectedPackage(packageName).packageRoot);
+}
 export function getInjectedPackageNameForSpecifier(specifier) {
     for (let injectedSpecifier of generatedInjectedPackageSpecifiers) {
         if (specifier === injectedSpecifier) {
@@ -88,13 +91,13 @@ function getResolvedInjectedPackage(packageName) {
     resolvedInjectedPackages.set(packageName, resolvedInjectedPackage);
     return resolvedInjectedPackage;
 }
-function getInjectedPackageRoutePattern(packageName) {
-    return `${injectedPackagesBasePath}/${packageName}/*path`;
+function getInjectedPackageMountPath(packageName) {
+    return `${injectedPackagesBasePath}/${packageName}`;
 }
 function getInjectedPackageRoute(packageRoot, packageName) {
     if (!packageRoot.endsWith(`/${packageName}`)) {
         return {
-            filePattern: `${packageRoot.slice(getFilePathDirectory(packageRoot).length + 1)}/*path`,
+            fileRoot: packageRoot.slice(getFilePathDirectory(packageRoot).length + 1),
             routeRoot: getFilePathDirectory(packageRoot),
         };
     }
@@ -103,7 +106,7 @@ function getInjectedPackageRoute(packageRoot, packageName) {
         routeRoot = getFilePathDirectory(routeRoot);
     }
     return {
-        filePattern: `${packageName}/*path`,
+        fileRoot: packageName,
         routeRoot,
     };
 }

package/dist/lib/inspection.d.ts

@@ -0,0 +1,39 @@
+import type { AccessPolicy, AssetAccessDetails } from './access.ts';
+import type { CompiledRoutes } from './routes.ts';
+/** How the asset server handles an inspected file. */
+export type AssetKind = 'file' | 'script' | 'style' | 'unsupported';
+/** Browser-reachability result for an inspected asset. */
+export type AssetStatus = 'denied' | 'missing' | 'not-allowed' | 'reachable' | 'unmapped' | 'unsupported';
+/** Diagnostic information about a configured asset URL or file path. */
+export interface AssetDetails {
+    /** Access-control decision and the rules responsible for it. */
+    access?: AssetAccessDetails;
+    /** Absolute mapped file path. */
+    filePath?: string;
+    /** Configured filesystem mount root that matched the asset. */
+    fileRoot?: string;
+    /** Browser-reachability result. */
+    status: AssetStatus;
+    /** How the asset server handles the file. */
+    type?: AssetKind;
+    /** Stable public URL pathname for the asset. */
+    url?: string;
+    /** Public mount root that matched the asset. */
+    urlRoot?: string;
+}
+interface AssetInspectorOptions {
+    accessPolicy: AccessPolicy;
+    allowFiles: readonly string[];
+    fileExtensions: readonly string[];
+    rootDir: string;
+    routes: CompiledRoutes;
+}
+export interface AssetInspector {
+    /** Returns diagnostic information for a public URL or file path. */
+    getAssetDetails(input: string): Promise<AssetDetails>;
+    /** Returns every file currently reachable through the configured asset server. */
+    getAssets(): Promise<AssetDetails[]>;
+}
+export declare function createAssetInspector(options: AssetInspectorOptions): AssetInspector;
+export {};
+//# sourceMappingURL=inspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/lib/inspection.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAInE,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,aAAa,CAAA;AAOlE,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAA;AAEnE,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,SAAS,GACT,aAAa,GACb,WAAW,GACX,UAAU,GACV,aAAa,CAAA;AAEjB,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,MAAM,EAAE,WAAW,CAAA;IACnB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,UAAU,qBAAqB;IAC7B,YAAY,EAAE,YAAY,CAAA;IAC1B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACrD,kFAAkF;IAClF,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACrC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA4BnF"}

package/dist/lib/inspection.js

@@ -0,0 +1,160 @@
+import * as fs from 'node:fs';
+import * as fsPromises from 'node:fs/promises';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseFingerprintSuffix } from './fingerprint.js';
+import { getInjectedPackageRoots } from './injected-packages.js';
+import { isAbsoluteFilePath, normalizeFilePath, resolveFilePath } from './paths.js';
+import { supportedScriptExtensions } from './scripts/resolve.js';
+import { isStyleFilePath } from './styles/compiler.js';
+const scriptExtensions = new Set(supportedScriptExtensions);
+const globSyntaxPattern = /[*?[\]{}()!+@]/;
+export function createAssetInspector(options) {
+    let fileExtensions = new Set(options.fileExtensions.map((extension) => extension.toLowerCase()));
+    return {
+        async getAssetDetails(input) {
+            let routeMatch = await resolveInput(input, options);
+            if (routeMatch === null)
+                return { status: 'unmapped' };
+            return inspectRouteMatch(routeMatch, options, fileExtensions);
+        },
+        async getAssets() {
+            let filePaths = await discoverFilePaths(options);
+            let assets = [];
+            for (let filePath of filePaths) {
+                let routeMatch = options.routes.matchFilePath(filePath);
+                if (routeMatch === null)
+                    continue;
+                let details = await inspectRouteMatch(routeMatch, options, fileExtensions);
+                if (details.status === 'reachable')
+                    assets.push(details);
+            }
+            assets.sort((left, right) => {
+                let urlOrder = (left.url ?? '').localeCompare(right.url ?? '');
+                return urlOrder === 0 ? (left.filePath ?? '').localeCompare(right.filePath ?? '') : urlOrder;
+            });
+            return assets;
+        },
+    };
+}
+async function resolveInput(input, options) {
+    if (input.startsWith('file://')) {
+        return options.routes.matchFilePath(fileURLToPath(input));
+    }
+    if (/^[A-Za-z][A-Za-z\d+.-]*:\/\//.test(input)) {
+        let pathname = parseFingerprintSuffix(new URL(input).pathname).pathname;
+        return options.routes.matchUrlPathname(pathname);
+    }
+    let filePath = resolveFilePath(options.rootDir, input);
+    if (!input.startsWith('/') || isAbsoluteFilePath(input)) {
+        if (await pathExists(filePath))
+            return options.routes.matchFilePath(filePath);
+        if (!input.startsWith('/'))
+            return options.routes.matchFilePath(filePath);
+    }
+    let pathname = parseFingerprintSuffix(new URL(input, 'http://remix.run').pathname).pathname;
+    return options.routes.matchUrlPathname(pathname);
+}
+async function inspectRouteMatch(routeMatch, options, fileExtensions) {
+    let exists = await pathExists(routeMatch.filePath);
+    let identityPath = exists ? fs.realpathSync(routeMatch.filePath) : routeMatch.filePath;
+    let normalizedIdentityPath = normalizeFilePath(identityPath);
+    let access = options.accessPolicy.inspect(normalizedIdentityPath);
+    let type = getAssetKind(routeMatch.filePath, fileExtensions);
+    let details = {
+        access,
+        filePath: routeMatch.filePath,
+        fileRoot: routeMatch.fileRoot,
+        type,
+        url: routeMatch.urlPathname,
+        urlRoot: routeMatch.urlRoot,
+    };
+    if (!exists)
+        return { ...details, status: 'missing' };
+    if (!access.allowed) {
+        return { ...details, status: access.deniedBy === undefined ? 'not-allowed' : 'denied' };
+    }
+    if (type === 'unsupported')
+        return { ...details, status: 'unsupported' };
+    return { ...details, status: 'reachable' };
+}
+function getAssetKind(filePath, fileExtensions) {
+    let extension = path.extname(filePath).toLowerCase();
+    if (scriptExtensions.has(extension))
+        return 'script';
+    if (isStyleFilePath(filePath))
+        return 'style';
+    if (fileExtensions.has(extension))
+        return 'file';
+    return 'unsupported';
+}
+async function discoverFilePaths(options) {
+    let roots = new Set();
+    for (let pattern of options.allowFiles) {
+        roots.add(resolveDiscoveryRoot(options.rootDir, pattern));
+    }
+    for (let packageRoot of options.accessPolicy.getAllowedPackageRoots()) {
+        roots.add(packageRoot);
+    }
+    for (let packageRoot of getInjectedPackageRoots()) {
+        roots.add(packageRoot);
+    }
+    let filePaths = new Set();
+    for (let root of roots) {
+        await collectFiles(root, filePaths);
+    }
+    return [...filePaths];
+}
+function resolveDiscoveryRoot(rootDir, pattern) {
+    let dynamicIndex = pattern.search(globSyntaxPattern);
+    if (dynamicIndex === -1)
+        return resolveFilePath(rootDir, pattern);
+    let rawStaticPrefix = pattern.slice(0, dynamicIndex);
+    let staticPrefix = rawStaticPrefix.replace(/[/\\]+$/, '');
+    if (staticPrefix.length === 0)
+        return rootDir;
+    return resolveFilePath(rootDir, /[/\\]$/.test(rawStaticPrefix) ? staticPrefix : path.dirname(staticPrefix));
+}
+async function collectFiles(root, filePaths) {
+    let stat;
+    try {
+        stat = await fsPromises.stat(root);
+    }
+    catch (error) {
+        if (isPathNotFoundError(error))
+            return;
+        throw error;
+    }
+    if (stat.isFile()) {
+        filePaths.add(normalizeFilePath(root));
+        return;
+    }
+    if (!stat.isDirectory())
+        return;
+    let entries = await fsPromises.readdir(root, { withFileTypes: true });
+    for (let entry of entries) {
+        let entryPath = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            await collectFiles(entryPath, filePaths);
+        }
+        else if (entry.isFile()) {
+            filePaths.add(normalizeFilePath(entryPath));
+        }
+    }
+}
+async function pathExists(filePath) {
+    try {
+        await fsPromises.access(filePath);
+        return true;
+    }
+    catch (error) {
+        if (isPathNotFoundError(error))
+            return false;
+        throw error;
+    }
+}
+function isPathNotFoundError(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        (error.code === 'ENOENT' || error.code === 'ENOTDIR'));
+}

package/dist/lib/routes.d.ts

@@ -1,11 +1,20 @@
-interface RouteConfig {
-    fileMap: Readonly<Record<string, string>>;
+interface MountConfig {
+    mounts: Readonly<Record<string, string>>;
     rootDir: string;
 }
 export interface CompiledRoutes {
     resolveUrlPathname(pathname: string): string | null;
+    matchUrlPathname(pathname: string): AssetRouteMatch | null;
     toUrlPathname(filePath: string): string | null;
+    matchFilePath(filePath: string): AssetRouteMatch | null;
 }
-export declare function compileRoutes(basePath: string, routeConfigs: readonly RouteConfig[]): CompiledRoutes;
+export interface AssetRouteMatch {
+    filePath: string;
+    fileRoot: string;
+    urlPathname: string;
+    urlRoot: string;
+}
+export declare function compileRoutes(basePath: string, mountConfigs: readonly MountConfig[]): CompiledRoutes;
+export declare function resolveMountFileRoot(rootDir: string, fileRoot: string): string;
 export {};
 //# sourceMappingURL=routes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/lib/routes.ts"],"names":[],"mappings":"AAqBA,UAAU,WAAW;IACnB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACzC,OAAO,EAAE,MAAM,CAAA;CAChB;AAUD,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC/C;AAYD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,cAAc,CAgDhB"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/lib/routes.ts"],"names":[],"mappings":"AASA,UAAU,WAAW;IACnB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACxC,OAAO,EAAE,MAAM,CAAA;CAChB;AASD,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAA;IAC1D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC9C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAA;CACxD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,cAAc,CA8DhB;AAuCD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU9E"}