Module edits
Expand description
When a generic field edit asks for confirmation.
Every door decides it the same way, from the edit alone: no app code is
needed to read a field edit. Removing an item of a collection asks, as a
delete verb does, unless the record publishes that collection’s removals
as quiet. Any edit of a field the record publishes as guarded asks: one
whose change can weaken the person’s security or expose them. A field
that weakens only one way (Weaker) asks only for a change that way.
Otherwise setting, splicing, adding, upserting an item by its key, moving
and an outbox’s settle and forget ask nothing.
Structs§
- Weakening
Field - A field that weakens one way, read back from its
weakening_tag(without the prefix). JSON text holds no raw tab, so tabs part it.
Enums§
- Edit
Step - One step of a field edit’s path, as the decision reads it.
- Weaker
- Which way a field’s value weakens the person’s security.
Constants§
- FIELD_
EDIT_ TAG - The tag a published field edit carries.
- GUARDED_
FIELD_ TAG - The tag prefix naming one field, by its dotted path from the edit’s root
(
*for an item), any edit at or below which asks. - QUIET_
REMOVAL_ TAG - The tag prefix naming one collection, by its dotted path from the edit’s
root (
*for an item), whose removals ask nothing. - WEAKENING_
FIELD_ TAG - The tag prefix of a field that weakens security only one way
(
weakening_tag): an edit making it weaker asks, any other does not.
Functions§
- dotted
pathas the dotted patternQUIET_REMOVAL_TAGnames collections by.- field_
edit_ asks - Whether the field edit
op(its JSON name) atpathasks for confirmation before it runs, wherequietnames the collections whose removals ask nothing andguardedthe fields whose every edit asks. - guarded_
at - Whether
pathis one of theguardedfields or lies below one. - weakening_
edit - Whether the field edit
opatpath, settingvalue(JSON text) when it is a set, can weaken one offields: a set of the field itself to a weaker value, and any other edit at or below it, which is not read. - weakening_
tag - The
WEAKENING_FIELD_TAGpublishing that the field atpath(dotted, asdottedspells it) weakensweaker’s way and holdsnow(JSON text), when known.