Fix Dev Server to allow serving static assets from a shared folder outside of the extension directory

[vividviolet]

WHY are these changes introduced?

When two extension points within the same extension declare assets whose source basenames collide (e.g. both reference a tools.json, or both compile to main.js), the dev server previously served whichever file happened to win the filesystem race. The URL shape (/assets/<basename>) gave no way to distinguish which extension point a request belonged to, so one target's asset would silently shadow another's.

Additionally, the middleware served files directly from the extension's source directory, which allowed path traversal to files outside the extension's bundle and made it impossible to serve include_assets-copied files that had been renamed by uniqueBasename during the build step.

WHAT is this pull request doing?

Opaque, target-scoped asset URLs

Asset URLs are now emitted as /assets/<target>/<assetKey>[.ext] instead of /assets/<basename>. This makes every URL unique per extension point, even when two targets share a source file.

Asset resolver

A new AssetResolver (Map<string, string>) is introduced per extension. During payload generation, each emitted URL subpath is registered in the resolver alongside the output-relative filesystem path the middleware should read. The resolver is cleared and rebuilt on every payload regeneration so stale entries from removed targets or renamed assets don't persist.

The resolver is stored in ExtensionsPayloadStore (keyed by devUUID) and exposed via getAssetResolver(devUUID). It is cleaned up when an extension is deleted.

Middleware rewrite

getExtensionAssetMiddleware now:

1. Looks up the request's assetPath in the extension's resolver to find the actual output-relative filename (falling back to the raw path for direct compiled-artefact fetches).
2. Resolves the candidate path against the extension's outputDir (the bundle directory that include_assets populates).
3. Rejects any path — whether from the URL or from a resolver value — that escapes outputDir via traversal, returning 404 rather than 403 to avoid leaking directory structure.

Static directory assets

A new staticAssetsMapper handles directory-valued config entries (e.g. assets = "./assets"). It emits a directory-prefix URL with a trailing slash and registers one resolver entry per copied file, including nested subdirectories.

resolveOutputDir extracted

The logic for deriving an output directory from outputPath (file with extension → dirname; no extension → path itself) is extracted into a shared resolveOutputDir helper used by both the build step and the middleware.

How to test your changes?

1. Create a UI extension with two extension points that both declare a tools asset pointing at different source files.
2. Run shopify app dev and observe that each extension point's payload contains a distinct URL (/<target-a>/tools.json vs /<target-b>/tools.json).
3. Fetch each URL from the dev server and confirm the correct file content is returned for each target.
4. Verify that requesting a file path not present in the resolver (e.g. a raw ../secret.txt) returns 404.
5. Create an extension point with assets = "./assets" containing nested files; confirm each file is individually servable via its resolver-mapped URL.

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes
• I've considered analytics changes to measure impact
• The change is user-facing — I've identified the correct bump type (patch for bug fixes · minor for new features · major for breaking changes) and added a changeset with pnpm changeset add

[vividviolet]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Allow preserving file paths when including assets from config key entry #7389
• Fix Dev Server to allow serving static assets from a shared folder outside of the extension directory #7386 👈 (View in Graphite)
• address png encoding bug, path changes #7378
• Add assets config key support for UI extension points #7363
• support bundle folder in the bundle ui step config #7340
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.