@remix-run/assets 0.0.0 → 0.1.0

package/src/lib/scripts/emit.ts

@@ -0,0 +1,122 @@
+import MagicString from 'magic-string'
+
+import {
+  createAssetServerCompilationError,
+  isAssetServerCompilationError,
+} from '../compilation-error.ts'
+import { hashContent } from '../fingerprint.ts'
+import type { ResolvedModule } from './resolve.ts'
+import { composeSourceMaps } from '../source-maps.ts'
+import type { AssetServerCompilationError } from '../compilation-error.ts'
+
+export type EmittedAsset = {
+  content: string
+  etag: string
+}
+
+export type EmittedModule = {
+  code: EmittedAsset
+  fingerprint: string | null
+  importUrls: string[]
+  sourceMap: EmittedAsset | null
+}
+
+type EmitResult =
+  | {
+      ok: true
+      value: EmittedModule
+    }
+  | {
+      ok: false
+      error: AssetServerCompilationError
+    }
+
+export async function emitResolvedModule(
+  resolvedModule: ResolvedModule,
+  options: {
+    getServedUrl(identityPath: string): Promise<string>
+    sourceMaps?: 'external' | 'inline'
+  },
+): Promise<EmitResult> {
+  try {
+    let importUrls = await Promise.all(
+      resolvedModule.deps.map((depPath) => options.getServedUrl(depPath)),
+    )
+    let rewriteResult = await rewriteImports(resolvedModule, options)
+    let finalCode = rewriteResult.code
+
+    if (rewriteResult.sourceMap) {
+      if (options.sourceMaps === 'inline') {
+        let encoded = Buffer.from(rewriteResult.sourceMap).toString('base64')
+        finalCode += `\n//# sourceMappingURL=data:application/json;base64,${encoded}`
+      } else if (options.sourceMaps === 'external') {
+        finalCode += `\n//# sourceMappingURL=${await options.getServedUrl(resolvedModule.identityPath)}.map`
+      }
+    }
+
+    return {
+      ok: true,
+      value: {
+        code: await createEmittedAsset(finalCode),
+        fingerprint: resolvedModule.fingerprint,
+        importUrls,
+        sourceMap: rewriteResult.sourceMap
+          ? await createEmittedAsset(rewriteResult.sourceMap)
+          : null,
+      },
+    }
+  } catch (error) {
+    return {
+      ok: false,
+      error: toEmitError(error, resolvedModule.identityPath),
+    }
+  }
+}
+
+async function rewriteImports(
+  resolvedModule: ResolvedModule,
+  options: {
+    getServedUrl(identityPath: string): Promise<string>
+  },
+): Promise<{ code: string; sourceMap: string | null }> {
+  let rewrittenSource = new MagicString(resolvedModule.rawCode)
+
+  for (let imported of resolvedModule.imports) {
+    let url = await options.getServedUrl(imported.depPath)
+    rewrittenSource.overwrite(
+      imported.start,
+      imported.end,
+      imported.quote ? `${imported.quote}${url}${imported.quote}` : url,
+    )
+  }
+
+  let code = rewrittenSource.toString()
+  let sourceMap =
+    resolvedModule.sourceMap && resolvedModule.imports.length > 0
+      ? composeSourceMaps(
+          rewrittenSource.generateMap({ hires: true }).toString(),
+          resolvedModule.sourceMap,
+        )
+      : resolvedModule.sourceMap
+
+  return { code, sourceMap }
+}
+
+async function createEmittedAsset(content: string): Promise<EmittedAsset> {
+  return {
+    content,
+    etag: `W/"${await hashContent(content)}"`,
+  }
+}
+
+function toEmitError(error: unknown, identityPath: string): AssetServerCompilationError {
+  if (isAssetServerCompilationError(error)) return error
+
+  return createAssetServerCompilationError(
+    `Failed to emit module ${identityPath}. ${error instanceof Error ? error.message : String(error)}`,
+    {
+      cause: error,
+      code: 'MODULE_EMIT_FAILED',
+    },
+  )
+}

package/src/lib/scripts/resolve.ts

@@ -0,0 +1,422 @@
+import * as fs from 'node:fs'
+import * as path from 'node:path'
+import type { ResolverFactory } from 'oxc-resolver'
+
+import {
+  createAssetServerCompilationError,
+  isAssetServerCompilationError,
+} from '../compilation-error.ts'
+import type { AssetServerCompilationError } from '../compilation-error.ts'
+import { normalizeFilePath } from '../paths.ts'
+import type { CompiledRoutes } from '../routes.ts'
+import type { ModuleRecord } from './store.ts'
+import type { ResolveModuleResult, TransformedModule } from './transform.ts'
+
+export const resolverExtensionAlias = {
+  '.js': ['.js', '.ts', '.tsx', '.jsx'],
+  '.jsx': ['.jsx', '.tsx'],
+  '.mjs': ['.mjs', '.mts'],
+} satisfies Record<string, string[]>
+
+export const resolverExtensions = ['.ts', '.tsx', '.js', '.jsx', '.mts', '.mjs']
+export const supportedScriptExtensions = ['.ts', '.tsx', '.js', '.jsx', '.mts', '.mjs']
+const supportedScriptExtensionSet = new Set<string>(supportedScriptExtensions)
+
+type ResolvedImport = {
+  depPath: string
+  end: number
+  quote?: '"' | "'" | '`'
+  start: number
+}
+
+type RelativeImportResolution = {
+  candidatePaths: readonly string[]
+  candidatePrefixes: readonly string[]
+  specifier: string
+}
+
+export type TrackedResolution = RelativeImportResolution & {
+  resolvedIdentityPath: string | null
+}
+
+export type ResolvedModule = {
+  deps: string[]
+  fingerprint: string | null
+  identityPath: string
+  imports: ResolvedImport[]
+  trackedFiles: string[]
+  trackedResolutions: TrackedResolution[]
+  rawCode: string
+  resolvedPath: string
+  sourceMap: string | null
+  stableUrlPathname: string
+}
+
+export type ResolutionFailureState = {
+  trackedFiles: readonly string[]
+  trackedResolutions: readonly TrackedResolution[]
+}
+
+type ResolveResult =
+  | {
+      ok: true
+      value: ResolvedModule
+    }
+  | {
+      ok: false
+      error: AssetServerCompilationError
+      tracking: ResolutionFailureState
+    }
+
+export type ResolveArgs = {
+  isAllowed(absolutePath: string): boolean
+  isWatchIgnored(filePath: string): boolean
+  resolveModulePath(absolutePath: string): ResolveModuleResult | null
+  resolverFactory: ResolverFactory
+  routes: CompiledRoutes
+}
+
+type ResolvedSpec = {
+  absolutePath: string | null
+  packageJsonPath: string | null
+  specifier: string
+}
+
+export async function resolveModule(
+  record: ModuleRecord,
+  transformed: TransformedModule,
+  args: ResolveArgs,
+): Promise<ResolveResult> {
+  let trackedFiles = new Set(transformed.trackedFiles)
+  let trackedResolutions: TrackedResolution[] = []
+  let resolvedImports: Map<string, ResolvedSpec>
+
+  try {
+    resolvedImports =
+      transformed.unresolvedImports.length > 0
+        ? await batchResolveSpecifiers(
+            getUniqueSpecifiers(transformed.unresolvedImports),
+            transformed.resolvedPath,
+            args.resolverFactory,
+          )
+        : new Map<string, ResolvedSpec>()
+  } catch (error) {
+    return failResolve(error, trackedFiles, trackedResolutions, transformed.resolvedPath, {
+      isWatchIgnored: args.isWatchIgnored,
+    })
+  }
+
+  let importsWithPaths: ResolvedImport[] = []
+  let deps = new Set<string>()
+
+  for (let unresolved of transformed.unresolvedImports) {
+    let trackedResolution = getTrackedRelativeImportResolution(
+      transformed.importerDir,
+      unresolved.specifier,
+      args.isWatchIgnored,
+    )
+
+    let resolvedSpec = resolvedImports.get(unresolved.specifier)
+    if (!resolvedSpec?.absolutePath) {
+      return failResolve(
+        createAssetServerCompilationError(
+          `Failed to resolve import "${unresolved.specifier}" in ${transformed.resolvedPath}. ` +
+            `Ensure it resolves to a file within the configured asset server fileMap, or mark it as external.`,
+          {
+            code: 'IMPORT_RESOLUTION_FAILED',
+          },
+        ),
+        trackedFiles,
+        trackedResolutions,
+        transformed.resolvedPath,
+        { isWatchIgnored: args.isWatchIgnored, trackedResolution },
+      )
+    }
+
+    let resolvedImport = args.resolveModulePath(resolvedSpec.absolutePath)
+    if (!resolvedImport) {
+      return failResolve(
+        createAssetServerCompilationError(
+          `Resolved import "${unresolved.specifier}" in ${transformed.resolvedPath} is not a supported script module. ` +
+            `Supported extensions are ${supportedScriptExtensions.join(', ')}.`,
+          {
+            code: 'IMPORT_NOT_SUPPORTED',
+          },
+        ),
+        trackedFiles,
+        trackedResolutions,
+        transformed.resolvedPath,
+        { isWatchIgnored: args.isWatchIgnored, trackedResolution },
+      )
+    }
+
+    if (!args.isAllowed(resolvedImport.identityPath)) {
+      return failResolve(
+        createAssetServerCompilationError(
+          `Resolved import "${unresolved.specifier}" in ${transformed.resolvedPath} is not allowed by the asset server allow/deny configuration. ` +
+            `Add a matching allow rule, remove a conflicting deny rule, or mark this import as external.`,
+          {
+            code: 'IMPORT_NOT_ALLOWED',
+          },
+        ),
+        trackedFiles,
+        trackedResolutions,
+        transformed.resolvedPath,
+        { isWatchIgnored: args.isWatchIgnored, trackedResolution },
+      )
+    }
+
+    let stableUrlPathname = args.routes.toUrlPathname(resolvedImport.identityPath)
+    if (!stableUrlPathname) {
+      return failResolve(
+        createAssetServerCompilationError(
+          `Resolved import "${unresolved.specifier}" in ${transformed.resolvedPath} is outside all configured fileMap entries. ` +
+            `Add a matching fileMap entry for this file path, or mark this import as external.`,
+          {
+            code: 'IMPORT_OUTSIDE_FILE_MAP',
+          },
+        ),
+        trackedFiles,
+        trackedResolutions,
+        transformed.resolvedPath,
+        { isWatchIgnored: args.isWatchIgnored, trackedResolution },
+      )
+    }
+
+    deps.add(resolvedImport.identityPath)
+
+    if (transformed.packageSpecifiers.includes(unresolved.specifier)) {
+      let packageJsonPath =
+        resolvedSpec.packageJsonPath ?? findNearestPackageJsonPath(resolvedImport.resolvedPath)
+      if (packageJsonPath && !args.isWatchIgnored(packageJsonPath)) {
+        trackedFiles.add(packageJsonPath)
+      }
+    }
+
+    if (trackedResolution) {
+      trackedResolutions.push({
+        ...trackedResolution,
+        resolvedIdentityPath: resolvedImport.identityPath,
+      })
+    }
+
+    importsWithPaths.push({
+      depPath: resolvedImport.identityPath,
+      end: unresolved.end,
+      quote: unresolved.quote,
+      start: unresolved.start,
+    })
+  }
+
+  return {
+    ok: true,
+    value: {
+      deps: [...deps],
+      fingerprint: transformed.fingerprint,
+      identityPath: record.identityPath,
+      imports: importsWithPaths,
+      trackedFiles: [...trackedFiles],
+      trackedResolutions,
+      rawCode: transformed.rawCode,
+      resolvedPath: transformed.resolvedPath,
+      sourceMap: transformed.sourceMap,
+      stableUrlPathname: transformed.stableUrlPathname,
+    },
+  }
+}
+
+function findNearestPackageJsonPath(filePath: string): string | null {
+  let directory = path.dirname(filePath)
+
+  while (true) {
+    let packageJsonPath = path.join(directory, 'package.json')
+    if (fs.existsSync(packageJsonPath)) {
+      return normalizeFilePath(packageJsonPath)
+    }
+
+    let parentDirectory = path.dirname(directory)
+    if (parentDirectory === directory) return null
+    directory = parentDirectory
+  }
+}
+
+function isRelativeImportSpecifier(specifier: string): boolean {
+  return specifier.startsWith('./') || specifier.startsWith('../')
+}
+
+function getTrackedRelativeImportResolution(
+  importerDir: string,
+  specifier: string,
+  isWatchIgnored: (filePath: string) => boolean,
+): RelativeImportResolution | null {
+  if (!isRelativeImportSpecifier(specifier)) return null
+
+  let candidatePath = resolveCandidateBasePath(importerDir, specifier)
+  let candidatePrefixes = [`${candidatePath}/`].filter(
+    (candidatePrefix) => !isWatchIgnored(candidatePrefix.replace(/\/+$/, '') || '/'),
+  )
+  let extension = path.extname(specifier)
+  if (extension === '') {
+    let candidatePaths = [
+      candidatePath,
+      ...supportedScriptExtensions.map(
+        (candidateExtension) => `${candidatePath}${candidateExtension}`,
+      ),
+    ].filter((candidatePath) => !isWatchIgnored(candidatePath))
+
+    return candidatePaths.length === 0 && candidatePrefixes.length === 0
+      ? null
+      : {
+          candidatePaths,
+          candidatePrefixes,
+          specifier,
+        }
+  }
+
+  let candidateExtensions = resolverExtensionAlias[extension as keyof typeof resolverExtensionAlias]
+  if (!candidateExtensions && !supportedScriptExtensionSet.has(extension)) {
+    let candidatePaths = [
+      candidatePath,
+      ...supportedScriptExtensions.map(
+        (candidateExtension) => `${candidatePath}${candidateExtension}`,
+      ),
+    ].filter((candidatePath) => !isWatchIgnored(candidatePath))
+
+    return candidatePaths.length === 0 && candidatePrefixes.length === 0
+      ? null
+      : {
+          candidatePaths,
+          candidatePrefixes,
+          specifier,
+        }
+  }
+
+  if (!candidateExtensions) return null
+
+  let candidatePaths = [
+    candidatePath,
+    ...candidateExtensions.map(
+      (candidateExtension) =>
+        `${candidatePath.slice(0, candidatePath.length - extension.length)}${candidateExtension}`,
+    ),
+  ].filter((candidatePath) => !isWatchIgnored(candidatePath))
+
+  return candidatePaths.length === 0 && candidatePrefixes.length === 0
+    ? null
+    : {
+        candidatePaths,
+        candidatePrefixes,
+        specifier,
+      }
+}
+
+function resolveCandidateBasePath(importerDir: string, specifier: string): string {
+  return normalizeFilePath(path.resolve(importerDir, specifier))
+}
+
+async function batchResolveSpecifiers(
+  specifiers: string[],
+  importerPath: string,
+  resolverFactory: ResolveArgs['resolverFactory'],
+): Promise<Map<string, ResolvedSpec>> {
+  let resolvedBySpecifier = new Map<string, ResolvedSpec>()
+  if (specifiers.length === 0) return resolvedBySpecifier
+
+  try {
+    for (let specifier of specifiers) {
+      let resolutionResult = await resolverFactory.resolveFileAsync(importerPath, specifier)
+      if (resolutionResult.error) {
+        throw createAssetServerCompilationError(
+          `Failed to resolve import "${specifier}" in ${importerPath}. ` +
+            `Ensure it resolves to a file within the configured asset server fileMap, or mark it as external.`,
+          {
+            code: 'IMPORT_RESOLUTION_FAILED',
+          },
+        )
+      }
+
+      resolvedBySpecifier.set(specifier, {
+        absolutePath:
+          resolutionResult.path && path.isAbsolute(resolutionResult.path)
+            ? normalizeFilePath(resolutionResult.path)
+            : null,
+        packageJsonPath: resolutionResult.packageJsonPath
+          ? normalizeFilePath(resolutionResult.packageJsonPath)
+          : null,
+        specifier,
+      })
+    }
+  } catch (error) {
+    if (isAssetServerCompilationError(error) && error.code === 'IMPORT_RESOLUTION_FAILED') {
+      throw error
+    }
+
+    throw createAssetServerCompilationError(
+      `Failed to resolve imports in ${importerPath}. ${formatUnknownError(error)}`,
+      {
+        cause: error,
+        code: 'IMPORT_RESOLUTION_FAILED',
+      },
+    )
+  }
+
+  return resolvedBySpecifier
+}
+
+function getUniqueSpecifiers(unresolvedImports: TransformedModule['unresolvedImports']): string[] {
+  return [...new Set(unresolvedImports.map((unresolved) => unresolved.specifier))]
+}
+
+function formatUnknownError(error: unknown): string {
+  return error instanceof Error ? error.message : String(error)
+}
+
+function failResolve(
+  error: unknown,
+  trackedFiles: ReadonlySet<string>,
+  trackedResolutions: readonly TrackedResolution[],
+  importerPath: string,
+  options: {
+    isWatchIgnored?: (filePath: string) => boolean
+    trackedResolution?: RelativeImportResolution | null
+  } = {},
+): ResolveResult {
+  return {
+    ok: false,
+    error: toResolveError(error, importerPath),
+    tracking: {
+      trackedFiles: [...trackedFiles],
+      trackedResolutions: appendFailedTrackedResolution(
+        trackedResolutions,
+        options.trackedResolution,
+      ),
+    },
+  }
+}
+
+function appendFailedTrackedResolution(
+  trackedResolutions: readonly TrackedResolution[],
+  trackedResolution: RelativeImportResolution | null | undefined,
+): TrackedResolution[] {
+  if (trackedResolution == null) return [...trackedResolutions]
+
+  return [
+    ...trackedResolutions,
+    {
+      ...trackedResolution,
+      resolvedIdentityPath: null,
+    },
+  ]
+}
+
+function toResolveError(error: unknown, importerPath: string): AssetServerCompilationError {
+  if (isAssetServerCompilationError(error)) return error
+
+  return createAssetServerCompilationError(
+    `Failed to resolve imports in ${importerPath}. ${formatUnknownError(error)}`,
+    {
+      cause: error,
+      code: 'IMPORT_RESOLUTION_FAILED',
+    },
+  )
+}