AssetResolver

Defined in: packages/core/src/runtime/pkg/types.ts:133

Resolve per-package assets (WASM binaries, ESM glue) for a bundle factory.

Role

Implement this to resolve a package’s sidecar assets by relative name.

Remarks

Passed into package factories ((resolver?: AssetResolver) => Extension) so the same factory works in two locations:

• Host-side (monorepo / dev): the factory constructs its own resolver from import.meta.url via createWasmBin(import.meta.url, ...).
• Guest-side (pkg install from a registry): the pkg bin builds a resolver rooted at the installed package’s bundle directory (see fsResolver, cachedResolver, nullResolver in runtime/pkg/evaluator.ts) and threads it into the factory.

Asset names are relative paths declared by the package’s assets field in the registry index (e.g., "vim.wasm", "vim.glue.mjs"). The resolver joins the name to its base path; callers never pass absolute paths.

Example

import type { AssetResolver, Extension } from '@fishnet/core'
import { createWasmBin } from '@fishnet/runtime'

export default function myWasmTool(resolver?: AssetResolver): Extension {
  const bin = createWasmBin(resolver ?? import.meta.url, 'tool.wasm', 'tool.glue.mjs')
  return { bins: { tool: bin } }
}

See

Extension

Methods

loadModule()

loadModule(name): Promise<unknown>

Defined in: packages/core/src/runtime/pkg/types.ts:155

Load a sidecar ESM/CJS module by relative name and return its namespace.

Parameters

name

string

Returns

Promise<unknown>

Invariant

The returned value is the module’s namespace-or-default. The default export is unwrapped for ESM; CJS modules return their module.exports.

Throws

Error when the module is not found or fails to evaluate.

---

resolve()

resolve(name): Promise<Uint8Array<ArrayBufferLike>>

Defined in: packages/core/src/runtime/pkg/types.ts:145

Read a sidecar asset’s bytes by relative name.

Parameters

name

string

Returns

Promise<Uint8Array<ArrayBufferLike>>

Invariant

name is a package-relative path segment (no leading slash, no .. traversal). The implementation joins it to the package’s base.

Invariant

The returned Uint8Array owns its buffer — callers may transfer or hand it to WebAssembly.compile without copying.

Throws

Error when the asset is not found (e.g., missing file or cache miss in a preloaded resolver).