N
Nornsdocs

norns

Boot

boot() builds the root container, runs every feature module, and returns the SvelteKit hooks.

src/hooks.server.c is the whole wiring:

features := import.meta.glob './lib/norns/*/server/module.c', { eager: true }

app := await boot { features }

{ handle, handleError } := app
export { handle, handleError }

boot is auto-imported in server files; import it explicitly from @human-synthesis/norns/server if you prefer.

#What boot() does

  1. Creates a fresh root Container.
  2. If serializer is given, installs it as the app-wide response serializer.
  3. For every entry in features, takes the module's default export (or the module itself when it is a function) and calls it with the root container. Each module.c registers its bindings there. A module whose default export is not a function fails boot with a clear error naming the path.
  4. Builds handle as sequence(contextHandle(container), ...extraHandle) and picks handleError (yours, or the default errorHandle()).

#Options

Option Type Notes
features Record<path, module> Usually the result of import.meta.glob(..., { eager: true }).
extraHandle Handle or Handle[] Extra SvelteKit handles run after the context handle, for example auth.
handleError HandleServerError Replaces the default error handle.
serializer Serializer or null App-wide route() serializer, e.g. tronSerializer() from norns-tron.

#Return value

{ container, handle, handleError }. container is the root container, useful in tests and scripts; requests never touch it directly, they get a child scope (see Request scope).

#createApp()

Returns an empty root container with nothing registered. Use it in tests that want full control over bindings.