@remix-run/assets 0.2.0 → 0.4.0

package/README.md

@@ -1,10 +1,11 @@
 # assets
 
-Fetch-based server for compiling browser JS/TS and CSS assets on demand.
+Fetch-based server for compiling browser assets on demand.
 
 ## Features
 
 - **On-Demand Compilation** - Compile browser scripts and styles on demand
+- **File Serving** - Serve configured file assets like images and fonts with optional transforms
 - **Custom File Mapping** - Define patterns for mapping public URLs to file paths on disk
 - **Access Control** - Control exactly which files can be served with allow and deny rules
 - **Preloads** - Generate preload URLs for scripts and styles based on imports
@@ -20,18 +21,22 @@ npm i remix
 
 ## Usage
 
-Use `createAssetServer` to serve browser JS/TS and CSS assets from a URL namespace in your app.
+Use `createAssetServer` to serve browser assets from a URL namespace in your app.
 
 ```ts
-import { createRouter } from 'remix/fetch-router'
+import { createRouter } from 'remix/router'
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
+  basePath: '/assets',
   fileMap: {
-    '/assets/app/*path': 'app/*path',
-    '/assets/npm/*path': 'node_modules/*path',
+    '/app/*path': 'app/*path',
+    '/npm/*path': 'node_modules/*path',
   },
   allow: ['app/assets/**', 'node_modules/**'],
+  files: {
+    extensions: ['.svg', '.png', '.jpg', '.jpeg', '.woff2'],
+  },
 })
 
 let router = createRouter()
@@ -53,9 +58,10 @@ import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
   rootDir: path.resolve(import.meta.dirname, '..'),
+  basePath: '/assets',
   fileMap: {
-    '/assets/app/*path': 'app/*path',
-    '/assets/npm/*path': 'node_modules/*path',
+    '/app/*path': 'app/*path',
+    '/npm/*path': 'node_modules/*path',
   },
   allow: ['app/assets/**', 'node_modules/**'],
 })
@@ -69,7 +75,8 @@ You must provide an `allow` list to specify which files are allowed to be served
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**'],
   deny: ['app/**/*.server.*'],
 })
@@ -79,21 +86,22 @@ Rules for `allow` and `deny` are file paths or globs. Relative values are resolv
 
 ## File Map
 
-Use `fileMap` to map public URLs to file paths on disk. The keys are public URL patterns, and the values are root-relative file path patterns.
+Use `fileMap` to map public URLs to file paths on disk. `basePath` defines the shared public mount point, and the `fileMap` keys are URL patterns relative to that base path. The values are root-relative file path patterns.
 
 ```ts
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
+  basePath: '/assets',
   fileMap: {
-    '/assets/app/*path': 'app/*path',
-    '/assets/packages/*path': '../packages/*path',
+    '/app/*path': 'app/*path',
+    '/packages/*path': '../packages/*path',
   },
   allow: ['app/assets/**', '../packages/**'],
 })
 ```
 
-`fileMap` entries use [`route-pattern`](https://github.com/remix-run/remix/tree/main/packages/route-pattern) syntax for both URL and file patterns. Wildcards must be named, and the same params must appear in both patterns so imports can be rewritten back to public URLs.
+`fileMap` entries use [`route-pattern`](https://github.com/remix-run/remix/tree/main/packages/route-pattern) syntax for both URL and file patterns. Wildcards must be named, and the same params must appear in both patterns so imports can be rewritten back to public URLs. For example, with `basePath: '/assets'`, a `fileMap` key of `'/app/*path'` is served at `/assets/app/*path`.
 
 ### File watching
 
@@ -103,7 +111,8 @@ The file system is watched by default so source changes are picked up without re
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**', 'app/node_modules/**'],
 })
 ```
@@ -120,7 +129,8 @@ You can disable file watching if the files on disk won't change, or if watching
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**', 'app/node_modules/**'],
   watch: false,
 })
@@ -132,7 +142,8 @@ You can optionally provide an array of glob patterns to the `watch.ignore` optio
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**', 'app/node_modules/**'],
   watch: {
     ignore: ['**/node_modules/**'],
@@ -149,6 +160,15 @@ let src = await assetServer.getHref('app/assets/entry.tsx')
 // '/assets/app/assets/entry.tsx'
 ```
 
+For configured `files` assets, you can also pass a `transform` pipeline to build a request URL with custom file transforms. Basic transforms are written as strings, while dynamic transforms use `[name, param]` tuples.
+
+```ts
+let src = await assetServer.getHref('app/assets/image.png', {
+  transform: [['resize', '100x100'], 'webp'],
+})
+// '/assets/app/assets/image.png?transform=resize%3A100x100&transform=webp'
+```
+
 ## Preloads
 
 Use `assetServer.getPreloads()` when rendering HTML so you can turn the returned URLs into `<link rel="modulepreload">`, stylesheet preload tags, or `Link` headers for one or more assets and their dependencies. You can provide root-relative or absolute file paths, or `file://` URLs.
@@ -159,14 +179,14 @@ let preloads = await assetServer.getPreloads(['app/assets/entry.tsx', 'app/asset
 //   '/assets/app/assets/entry.tsx',
 //   '/assets/app/assets/search.tsx',
 //   '/assets/app/assets/utils.ts',
-//   '/assets/npm/@remix-run/ui/index.js',
+//   '/assets/npm/remix/ui/index.js',
 //   ...etc
 // ]
 ```
 
 ## Fingerprinting
 
-By default, assets are served at stable URLs with ETags and `Cache-Control: no-cache`. Responses are cached for the lifetime of the asset server instance.
+By default, assets are served at stable URLs with ETags and `Cache-Control: no-cache`.
 
 If you want clients to cache assets aggressively without revalidation, you can opt into source-based fingerprinting.
 
@@ -174,7 +194,8 @@ If you want clients to cache assets aggressively without revalidation, you can o
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**'],
   watch: false,
   fingerprint: {
@@ -195,7 +216,8 @@ Use `target` to lower emitted syntax to a specific browser support policy and/or
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**'],
   target: {
     chrome: '109',
@@ -215,7 +237,8 @@ Enable sourcemaps with either `'external'` or `'inline'` using `sourceMaps`:
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**'],
   sourceMaps: 'external',
 })
@@ -227,7 +250,8 @@ By default, sourcemap `sources` use URLs so they're presented alongside the comp
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**'],
   sourceMaps: 'inline',
   sourceMapSourcePaths: 'absolute',
@@ -242,7 +266,8 @@ Enable minification with `minify`:
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**'],
   minify: true,
 })
@@ -258,7 +283,8 @@ Use `scripts.define` to replace global identifiers with constant expressions.
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**', 'app/node_modules/**'],
   scripts: {
     define: {
@@ -278,7 +304,8 @@ Use `scripts.external` to leave specific import specifiers unchanged by providin
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**'],
   scripts: {
     external: ['my-external-import'],
@@ -286,15 +313,200 @@ let assetServer = createAssetServer({
 })
 ```
 
+## File Options
+
+Use `files` to serve additional leaf assets like images and fonts. File extensions must include the leading dot and are only served when explicitly configured.
+
+```ts
+import { createAssetServer } from 'remix/assets'
+
+let assetServer = createAssetServer({
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
+  allow: ['app/assets/**'],
+  files: {
+    extensions: ['.svg', '.png', '.jpg', '.jpeg', '.woff2'],
+  },
+})
+```
+
+JavaScript/TypeScript and CSS extensions not supported in `files.extensions` as they are not leaf assets and have their own module systems.
+
+### File transforms
+
+Files can optionally be transformed before serving.
+
+Use `files.transforms` for named transforms that callers can opt into per request, provided via the `transform` option when calling `assetServer.getHref()`.
+
+```ts
+import { createAssetServer, defineFileTransform } from 'remix/assets'
+import sharp from 'sharp'
+
+let assetServer = createAssetServer({
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
+  allow: ['app/assets/**'],
+  files: {
+    extensions: ['.svg', '.png', '.jpg', '.jpeg', '.woff2'],
+    transforms: {
+      webp: defineFileTransform({
+        extensions: ['.png', '.jpg', '.jpeg'],
+        async transform(bytes) {
+          return {
+            content: await sharp(bytes).webp({ quality: 80 }).toBuffer(),
+            extension: '.webp',
+          }
+        },
+      }),
+    },
+  },
+})
+
+let imageUrl = await assetServer.getHref('app/assets/photo.jpg', {
+  transform: ['webp'],
+})
+```
+
+Transforms can also accept a single string param value, provided as a `[name, param]` tuple in the `transform` array when calling `assetServer.getHref()`.
+
+```ts
+import { createAssetServer, defineFileTransform } from 'remix/assets'
+
+let assetServer = createAssetServer({
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
+  allow: ['app/assets/**'],
+  files: {
+    extensions: ['.svg', '.png', '.jpg', '.jpeg', '.woff2'],
+    transforms: {
+      recolor: defineFileTransform({
+        extensions: ['.svg'],
+        param: true,
+        async transform(bytes, { param }) {
+          if (!/^#?(?:[\da-f]{3,4}|[\da-f]{6}(?:[\da-f]{2})?)$/i.test(param)) {
+            throw new TypeError('Expected a hex color, with or without a leading #')
+          }
+
+          let svg = new TextDecoder().decode(bytes)
+          return svg.replaceAll('currentColor', `${!param.startsWith('#') ? '#' : ''}${param}`)
+        },
+      }),
+    },
+  },
+})
+
+let imageUrl = await assetServer.getHref('app/assets/logo.svg', {
+  transform: [['recolor', '0000ff']],
+})
+```
+
+Hand-authored URLs use repeated `transform` search params with `name` or `name:param` values:
+
+```css
+.selector {
+  background-image: url('/assets/app/assets/image.png?transform=resize:100x100&transform=webp');
+}
+```
+
+#### Global file transforms
+
+Use `files.globalTransforms` to define transforms that should always happen before a file is served. These transforms are run after any request-level transforms for all configured file extensions, and can return `null` to skip themselves for a given input.
+
+```ts
+import { createAssetServer } from 'remix/assets'
+import { optimize as optimizeSvg } from 'svgo'
+
+let assetServer = createAssetServer({
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
+  allow: ['app/assets/**'],
+  files: {
+    extensions: ['.svg', '.png', '.jpg', '.jpeg', '.woff2'],
+    globalTransforms: [
+      {
+        extensions: ['.svg'],
+        async transform(bytes) {
+          let svg = new TextDecoder().decode(bytes)
+          return optimizeSvg(svg, { multipass: true }).data
+        },
+      },
+    ],
+  },
+})
+```
+
+#### File transform caching
+
+Use `files.cache` to store transformed file outputs via a [`file-storage`](https://github.com/remix-run/remix/tree/main/packages/file-storage) backend.
+
+Without `files.cache`, transformed file outputs are recomputed per request.
+
+If `fingerprint.buildId` is set, the file cache can be reused across server restarts for the same build.
+
+```ts
+import * as path from 'node:path'
+import { createAssetServer } from 'remix/assets'
+import { createFsFileStorage } from 'remix/file-storage/fs'
+
+let assetServer = createAssetServer({
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
+  allow: ['app/assets/**'],
+  files: {
+    cache: createFsFileStorage(path.resolve('.tmp/assets-cache')),
+    extensions: ['.svg', '.png', '.jpg', '.jpeg', '.woff2'],
+    transforms: {
+      /*...*/
+    },
+  },
+})
+```
+
+#### Request transform limits
+
+Use `files.maxRequestTransforms` to cap request transform pipelines. It defaults to `5`.
+
+```ts
+import { createAssetServer } from 'remix/assets'
+
+let assetServer = createAssetServer({
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
+  allow: ['app/assets/**'],
+  files: {
+    maxRequestTransforms: 5,
+    extensions: ['.svg', '.png', '.jpg', '.jpeg', '.woff2'],
+    transforms: {
+      /*...*/
+    },
+  },
+})
+```
+
 ## CSS Imports
 
-Relative CSS `@import` rules are rewritten to asset server URLs. External `@import` URLs are left unchanged automatically. `url()` references are preserved as authored.
+Relative CSS `@import` rules and `url()` references are rewritten to asset server URLs.
 
 ```css
-/* Rewritten to asset server URL: */
+/* Rewritten to asset server URLs: */
 @import './reset.css';
-/* External URL: */
+.selector {
+  background-image: url('./image.png');
+}
+
+/* External URLs: */
 @import 'https://fonts.googleapis.com/css2?family=Inter';
+.selector {
+  background-image: url('https://example.com/logo.svg');
+}
+```
+
+File transforms can also be applied to relative CSS `url()` references:
+
+```css
+.selector {
+  background-image: url('./image.png?transform=resize:100x100&transform=webp');
+}
 ```
 
 ## Error Handling
@@ -305,7 +517,8 @@ Use `onError` to report unexpected compilation failures and/or return a custom r
 import { createAssetServer } from 'remix/assets'
 
 let assetServer = createAssetServer({
-  fileMap: { '/assets/app/*path': 'app/*path' },
+  basePath: '/assets',
+  fileMap: { '/app/*path': 'app/*path' },
   allow: ['app/assets/**'],
   onError(error) {
     console.error('Failed to build client assets', error)

package/dist/assets.d.ts

@@ -1,3 +1,4 @@
 export { createAssetServer } from './lib/asset-server.ts';
+export { defineFileTransform } from './lib/files/config.ts';
 export type { AssetServer, AssetServerOptions } from './lib/asset-server.ts';
 //# sourceMappingURL=assets.d.ts.map

package/dist/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/assets.js

@@ -1 +1,2 @@
 export { createAssetServer } from "./lib/asset-server.js";
+export { defineFileTransform } from "./lib/files/config.js";

package/dist/lib/access.d.ts

@@ -1,4 +1,5 @@
 type AccessPolicy = {
+    isDenied(filePath: string): boolean;
     isAllowed(filePath: string): boolean;
 };
 export declare function createAccessPolicy(options: {

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

@@ -1 +1 @@
-{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/lib/access.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,GAAG;IAClB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;CACrC,CAAA;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,YAAY,CAaf"}
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/lib/access.ts"],"names":[],"mappings":"AAGA,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;CACrC,CAAA;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,YAAY,CAoBf"}

package/dist/lib/access.js

@@ -1,12 +1,21 @@
 import { createFileMatcher } from "./file-matcher.js";
+import { isInjectedPackageFilePath } from "./injected-packages.js";
 export function createAccessPolicy(options) {
     let allowMatchers = options.allow.map((pattern) => createFileMatcher(pattern, options.rootDir));
     let denyMatchers = (options.deny ?? []).map((pattern) => createFileMatcher(pattern, options.rootDir));
+    function isDenied(filePath) {
+        if (isInjectedPackageFilePath(filePath))
+            return false;
+        return denyMatchers.length > 0 && denyMatchers.some((matcher) => matcher(filePath));
+    }
     return {
+        isDenied,
         isAllowed(filePath) {
+            if (isInjectedPackageFilePath(filePath))
+                return true;
             if (!allowMatchers.some((matcher) => matcher(filePath)))
                 return false;
-            if (denyMatchers.length > 0 && denyMatchers.some((matcher) => matcher(filePath)))
+            if (isDenied(filePath))
                 return false;
             return true;
         },

package/dist/lib/asset-server.d.ts

@@ -1,3 +1,4 @@
+import type { AssetRequestTransformMap, AssetServerFilesOptions, AssetTransformInvocation } from './files/config.ts';
 import type { AssetTarget } from './target.ts';
 import type { ChokidarWatcher } from './watch.ts';
 interface AssetServerWatchOptions {
@@ -33,7 +34,13 @@ interface AssetServerScriptOptions {
     /** Import specifiers to leave unrewritten (CDN URLs, import map entries, etc.) */
     external?: string[];
 }
-export interface AssetServerOptions {
+/**
+ * Options used to construct an {@link AssetServer} via {@link createAssetServer}.
+ */
+export interface AssetServerOptions<transforms extends AssetRequestTransformMap = {}> {
+    /** Public mount path for this asset server, e.g. `'/assets'`. */
+    basePath: string;
+    /** File patterns keyed by public URL patterns relative to `basePath`. */
     /** File patterns keyed by public URL patterns. */
     fileMap: Readonly<Record<string, string>>;
     /**
@@ -80,6 +87,12 @@ export interface AssetServerOptions {
      * Script-only configuration.
      */
     scripts?: AssetServerScriptOptions;
+    /**
+     * Leaf file asset configuration. Files configured here are served directly and can be
+     * referenced from CSS `url(...)` rules. Compiled asset extensions like `.css` and script
+     * module extensions are not allowed here.
+     */
+    files?: AssetServerFilesOptions<transforms>;
     /**
      * Enable filesystem-backed cache invalidation for long-lived server instances.
      * Enabled by default. Pass `true` to use the default watcher options, an options
@@ -92,7 +105,19 @@ export interface AssetServerOptions {
      */
     onError?: (error: unknown) => void | Response | Promise<void | Response>;
 }
-export interface AssetServer {
+type AssetServerCreateOptions<transforms extends AssetRequestTransformMap> = Omit<AssetServerOptions<transforms>, 'files'> & {
+    files?: Omit<AssetServerFilesOptions<transforms>, 'transforms'> & {
+        transforms?: transforms;
+    };
+};
+export type AssetServerGetHrefOptions<transforms extends AssetRequestTransformMap> = undefined | {
+    transform: readonly AssetTransformInvocation<transforms>[];
+};
+/**
+ * Serves compiled scripts and styles for asset requests routed to it.
+ * Construct with {@link createAssetServer}.
+ */
+export interface AssetServer<transforms extends AssetRequestTransformMap = {}> {
     /**
      * Serves a script or style request. Returns `Response | null` — null means the request
      * was not handled by this server, letting the router fall through to a 404.
@@ -101,7 +126,7 @@ export interface AssetServer {
     /**
      * Returns the request href for a served asset file.
      */
-    getHref(filePath: string): Promise<string>;
+    getHref(filePath: string, options?: AssetServerGetHrefOptions<transforms>): Promise<string>;
     /**
      * Returns preload URLs for one or more served asset files, ordered shallowest-first.
      */
@@ -111,8 +136,8 @@ export interface AssetServer {
      */
     close(): Promise<void>;
 }
-export declare function getInternalChokidarWatcher(assetServer: AssetServer): ChokidarWatcher | undefined;
-export declare function getInternalWatchTargets(assetServer: AssetServer): readonly string[];
+export declare function getInternalChokidarWatcher<transforms extends AssetRequestTransformMap>(assetServer: AssetServer<transforms>): ChokidarWatcher | undefined;
+export declare function getInternalWatchTargets<transforms extends AssetRequestTransformMap>(assetServer: AssetServer<transforms>): readonly string[];
 /**
  * Create an asset server instance
  *
@@ -125,8 +150,9 @@ export declare function getInternalWatchTargets(assetServer: AssetServer): reado
  * @example
  * ```ts
  * let assetServer = createAssetServer({
+ *   basePath: '/assets',
  *   fileMap: {
- *     '/assets/app/*path': 'app/*path',
+ *     '/app/*path': 'app/*path',
  *   },
  *   allow: ['app/**'],
  * })
@@ -134,6 +160,6 @@ export declare function getInternalWatchTargets(assetServer: AssetServer): reado
  * route('/assets/*path', ({ request }) => assetServer.fetch(request))
  * ```
  */
-export declare function createAssetServer(options: AssetServerOptions): AssetServer;
+export declare function createAssetServer<const transforms extends AssetRequestTransformMap = {}>(options: AssetServerCreateOptions<transforms>): AssetServer<transforms>;
 export {};
 //# sourceMappingURL=asset-server.d.ts.map

package/dist/lib/asset-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-server.d.ts","sourceRoot":"","sources":["../../src/lib/asset-server.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAA6C,MAAM,aAAa,CAAA;AAEzF,OAAO,KAAK,EAAsB,eAAe,EAAE,MAAM,YAAY,CAAA;AAErE,UAAU,uBAAuB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,UAAU,kBAAkB;IAC1B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,KAAK,eAAe,GAAG,QAAQ,GAAG,UAAU,CAAA;AAC5C,KAAK,yBAAyB,GAAG,KAAK,GAAG,UAAU,CAAA;AAEnD,UAAU,wBAAwB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAID,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACzC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,yBAAyB,CAAA;IAChD;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAA;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAA;IACzC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAA;CACzE;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IACjD;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACpE;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAuBD,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS,CAEhG;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,MAAM,EAAE,CAEnF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAqN1E"}
+{"version":3,"file":"asset-server.d.ts","sourceRoot":"","sources":["../../src/lib/asset-server.ts"],"names":[],"mappings":"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"}