61 lines
1.2 KiB
Markdown
61 lines
1.2 KiB
Markdown
|
# @open-matrix/browser-host Contract
|
||
|
|
|
||
|
|
Layer: browser runtime host.
|
||
|
|
|
||
|
|
## Owns
|
||
|
|
|
||
|
|
```text
|
||
|
|
browser runtime bootstrap consumption
|
||
|
|
MatrixAuthorityContext installation into runtime context
|
||
|
|
browser runtimeInstanceRoot propagation
|
||
|
|
hosted runtime target resolution for browser apps
|
||
|
|
browser app readiness probes
|
||
|
|
```
|
||
|
|
|
||
|
|
## Does Not Own
|
||
|
|
|
||
|
|
```text
|
||
|
|
auth decisions
|
||
|
|
namespace ownership
|
||
|
|
Registry storage
|
||
|
|
Device inventory storage
|
||
|
|
NATS/JWT policy
|
||
|
|
```
|
||
|
|
|
||
|
|
## Consumes
|
||
|
|
|
||
|
|
```text
|
||
|
|
/api/bootstrap authorityContext
|
||
|
|
MatrixAuthorityContext
|
||
|
|
browser bus token material from gateway bootstrap
|
||
|
|
```
|
||
|
|
|
||
|
|
## Provided Surfaces
|
||
|
|
|
||
|
|
```text
|
||
|
|
matrix-dsl-host browser element
|
||
|
|
hosted runtime target resolution helpers
|
||
|
|
app-ready probe helpers
|
||
|
|
bundle freshness monitor
|
||
|
|
```
|
||
|
|
|
||
|
|
## Forbidden
|
||
|
|
|
||
|
|
```text
|
||
|
|
selectedAuthorityRoot from DOM authority-root
|
||
|
|
selectedAuthorityRoot from runtime.root
|
||
|
|
selectedAuthorityRoot from assetHostRoot
|
||
|
|
selectedAuthorityRoot from URL host
|
||
|
|
```
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
Browser authority comes from `/api/bootstrap`. Package configuration may control app mounting and readiness behavior, but it must not decide data authority.
|
||
|
|
|
||
|
|
## Proof Gates
|
||
|
|
|
||
|
|
```text
|
||
|
|
pnpm test:focused @open-matrix/browser-host
|
||
|
|
pnpm --filter @open-matrix/browser-host type-check
|
||
|
|
```
|