This library provides the definitions and reference implementation of the ValOS sourcerer architecture which is used to route ValOS event streams.

This document is part of the library workspace @valos/sourcerer (of domain @valos/kernel) which has the description: `ValOS Sourcerer API, schema`

valosp: scheme specifies remote chronicle sourcery as a combination of four primary https operations:

• narrate events via GET

• proclaim commands via PUT (single command) and POST (multi-command)

• bvob upload via multipart POST

• bvob download via GET

A valid valosp: authority URI has no query or fragment parts and its hierarchy part (which can be arbitrarily deep) must terminate to '/', (f.ex.:valosp://localhost:5443/deep/taur/).

Given an authority URI, a chronicle URI is an immediate sub-path with chronicle id route-vplot as the step, f.ex.:valosp://localhost:5443/deep/taur/~raw!example-chronicle/

The primary operations of the chronicle are sub-paths of the chronicle URI. These operations are grouped into three different route signatures (assuming authority URI sans terminating "/" as base):

• /:chroniclePlot/-log!:eventIndex/ GET, PUT, OPTIONS: single-event, restful application/json single object operations

• /:chroniclePlot/-log{'!:startIndex}{'!:endIndex} GET, POST, OPTIONS: multi-event, application/json array operations. Note no terminating "/"

• /:chroniclePlot/~bvob!:contentHash/ GET, POST, OPTIONS: bvob operations, with application/octet-stream download andmultipart/form-data upload as per rfc1887

The event objects are version "0.3" events with the delta aspect as their root aspect.

The 'VSourcerer' namespace describes the @valos/sourcerer library public API.