Repository navigation
Expand file tree
/
Copy pathimpact.json
More file actions
23 lines (23 loc) · 1.93 KB
/
Copy pathimpact.json
File metadata and controls
23 lines (23 loc) · 1.93 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://bearsunday.github.io/BEAR.QueryRepository/schemas/graph/impact.json",
"title": "qr-graph impact line",
"description": "One URI the invalidation reaches through the declared graph, breadth-first, each reached once by its shortest path. Follow `by` back to the start to explain the line.",
"type": "object",
"required": ["uri", "via", "by", "depth", "cached", "source"],
"properties": {
"uri": {"type": "string"},
"via": {
"description": "`target`: the URI asked about. `refresh`/`purge`: a target of the write method asked about. `embed`: embeds `by`, by an #[Embed] or by its resource layout. `dependsOn`: its onGet() declares #[DependsOn] on `by`; followed only from a `target`, `refresh` or `purge` line, since the declaration carries the exact tag of `by` and nothing `by` carries. Tags are not compared: a declaration that does not match what the write purges is warned on stderr and still listed.",
"enum": ["target", "refresh", "purge", "embed", "dependsOn"]
},
"by": {"type": ["string", "null"]},
"depth": {"type": "integer", "minimum": 0},
"cached": {
"description": "Whether the resource declares a cache at all. Tags reach a parent only from a child that already ran, carrying an ETag (the non-donut path), or an ETag or Surrogate-Key (donut materials; holes have not run yet), so an `embed` line whose `by` is not cached is a dependency the cache may not track (for a donut page, a hole rendered per request). A `by` reached via `dependsOn` is the exception: once it has run inside the page (not as a hole), its declared tags reach the page whether it is cached or not.",
"type": "boolean"
},
"source": {"description": "file:line; null for a URI no scanned resource serves.", "type": ["string", "null"]}
},
"additionalProperties": false
}