@toa.io/extensions.configuration 1.0.0-alpha.313 → 1.0.0-alpha.315

package/components/configuration.values/manifest.toa.yaml

@@ -6,6 +6,10 @@ name: values
 # What every component's epoch, schema and defaults are, the service is told on
 # deployment (`TOA_CONFIGURATION_VALUES`). A created object is published as the
 # prototype's `created` event.
+#
+# A reset is an object too: it holds the deployed defaults and their revision, so the event
+# carries the value a running component is to take. While it is the latest, what is served is
+# the defaults deployed now, which a later deployment may have changed.
 
 entity:
   properties:
@@ -17,6 +21,10 @@ entity:
       type: object
     originator:
       type: string
+    # of the defaults a reset holds; a created object has none
+    revision:
+      type: string
+      nullable: true
   required:
     - component
     - epoch
@@ -47,9 +55,17 @@ operations:
           type: object
         epoch:
           type: string
+        created:
+          type: integer
+        # of the deployed defaults when they are what is served; null for a created object
+        revision:
+          type: string
+          nullable: true
       required:
         - configuration
         - epoch
+        - created
+        - revision
   # the same for many at once, as the aspects of one process ask
   fetch:
     query: false
@@ -104,11 +120,18 @@ operations:
             type: object
           configuration:
             type: object
+          created:
+            type: integer
+          revision:
+            type: string
+            nullable: true
         required:
           - component
           - epoch
           - schema
           - configuration
+          - created
+          - revision
   create:
     query: false
     input:
@@ -132,6 +155,26 @@ operations:
     errors:
       - UNKNOWN_COMPONENT
       - INVALID_CONFIGURATION
+  # back to the deployed defaults, as a new object like any created one
+  reset:
+    query: false
+    input:
+      type: object
+      properties:
+        component:
+          type: string
+        originator:
+          type: object
+          properties:
+            id:
+              type: string
+          required:
+            - id
+      required:
+        - component
+        - originator
+    errors:
+      - UNKNOWN_COMPONENT
 
 exposition:
   isolated: true
@@ -153,3 +196,8 @@ exposition:
         role: system:configuration:create
         delegate: originator
       endpoint: create
+    DELETE:
+      auth:rule:
+        role: system:configuration:create
+        delegate: originator
+      endpoint: reset

package/components/configuration.values/operations/create.js

@@ -1,6 +1,7 @@
 import * as schemas from '@toa.io/schemas';
 import { assertSecrets } from '@toa.io/definitions/extensions.configuration';
 import { entry } from './lib/map.js';
+import { UnknownComponentError } from './lib/errors.js';
 export async function transition(input, object) {
     const known = entry(input.component);
     if (known === undefined)
@@ -20,13 +21,7 @@ export async function transition(input, object) {
     object.originator = input.originator.id;
     return object;
 }
-class UnknownComponentError extends Error {
-    code = 'UNKNOWN_COMPONENT';
-    constructor(component) {
-        super(`Component '${component}' is not configured`);
-    }
-}
 class InvalidConfigurationError extends Error {
     code = 'INVALID_CONFIGURATION';
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3JlYXRlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc291cmNlL2NyZWF0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGlCQUFpQixDQUFBO0FBQzFDLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSw4Q0FBOEMsQ0FBQTtBQUM1RSxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sY0FBYyxDQUFBO0FBR3BDLE1BQU0sQ0FBQyxLQUFLLFVBQVUsVUFBVSxDQUFDLEtBQVksRUFBRSxNQUFjO0lBQzNELE1BQU0sS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFcEMsSUFBSSxLQUFLLEtBQUssU0FBUztRQUFFLE9BQU8sSUFBSSxxQkFBcUIsQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFMUUsTUFBTSxhQUFhLEdBQUcsZUFBZSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUUxRCxNQUFNLE1BQU0sR0FBZ0IsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUE7SUFFeEQsSUFBSSxDQUFDO1FBQ0gsTUFBTSxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsQ0FBQTtRQUM5QixhQUFhLENBQUMsS0FBSyxDQUFDLE1BQU0sRUFBRSxhQUFhLENBQUMsQ0FBQTtJQUM1QyxDQUFDO0lBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztRQUNmLE9BQU8sSUFBSSx5QkFBeUIsQ0FBRSxLQUFlLENBQUMsT0FBTyxDQUFDLENBQUE7SUFDaEUsQ0FBQztJQUVELE1BQU0sQ0FBQyxTQUFTLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQTtJQUNsQyxNQUFNLENBQUMsS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUE7SUFDMUIsTUFBTSxDQUFDLGFBQWEsR0FBRyxhQUFhLENBQUE7SUFDcEMsTUFBTSxDQUFDLFVBQVUsR0FBRyxLQUFLLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQTtJQUV2QyxPQUFPLE1BQU0sQ0FBQTtBQUNmLENBQUM7QUFFRCxNQUFNLHFCQUFzQixTQUFRLEtBQUs7SUFDdkIsSUFBSSxHQUFHLG1CQUFtQixDQUFBO0lBRTFDLFlBQW1CLFNBQWlCO1FBQ2xDLEtBQUssQ0FBQyxjQUFjLFNBQVMscUJBQXFCLENBQUMsQ0FBQTtJQUNyRCxDQUFDO0NBQ0Y7QUFFRCxNQUFNLHlCQUEwQixTQUFRLEtBQUs7SUFDM0IsSUFBSSxHQUFHLHVCQUF1QixDQUFBO0NBQy9DIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3JlYXRlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc291cmNlL2NyZWF0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGlCQUFpQixDQUFBO0FBQzFDLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSw4Q0FBOEMsQ0FBQTtBQUM1RSxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sY0FBYyxDQUFBO0FBQ3BDLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLGlCQUFpQixDQUFBO0FBR3ZELE1BQU0sQ0FBQyxLQUFLLFVBQVUsVUFBVSxDQUFDLEtBQVksRUFBRSxNQUFjO0lBQzNELE1BQU0sS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFcEMsSUFBSSxLQUFLLEtBQUssU0FBUztRQUFFLE9BQU8sSUFBSSxxQkFBcUIsQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFMUUsTUFBTSxhQUFhLEdBQUcsZUFBZSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUUxRCxNQUFNLE1BQU0sR0FBZ0IsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUE7SUFFeEQsSUFBSSxDQUFDO1FBQ0gsTUFBTSxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsQ0FBQTtRQUM5QixhQUFhLENBQUMsS0FBSyxDQUFDLE1BQU0sRUFBRSxhQUFhLENBQUMsQ0FBQTtJQUM1QyxDQUFDO0lBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztRQUNmLE9BQU8sSUFBSSx5QkFBeUIsQ0FBRSxLQUFlLENBQUMsT0FBTyxDQUFDLENBQUE7SUFDaEUsQ0FBQztJQUVELE1BQU0sQ0FBQyxTQUFTLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQTtJQUNsQyxNQUFNLENBQUMsS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUE7SUFDMUIsTUFBTSxDQUFDLGFBQWEsR0FBRyxhQUFhLENBQUE7SUFDcEMsTUFBTSxDQUFDLFVBQVUsR0FBRyxLQUFLLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQTtJQUV2QyxPQUFPLE1BQU0sQ0FBQTtBQUNmLENBQUM7QUFFRCxNQUFNLHlCQUEwQixTQUFRLEtBQUs7SUFDM0IsSUFBSSxHQUFHLHVCQUF1QixDQUFBO0NBQy9DIn0=

package/components/configuration.values/operations/get.js

@@ -13,7 +13,9 @@ export async function computation(input, context) {
     return {
         configuration: value.configuration,
         schema: known?.schema,
-        epoch: input.epoch ?? known.epoch
+        epoch: input.epoch ?? known.epoch,
+        created: value.created,
+        revision: value.revision
     };
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2V0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc291cmNlL2dldC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sY0FBYyxDQUFBO0FBQ3BDLE9BQU8sRUFBRSxPQUFPLEVBQWdCLE1BQU0sa0JBQWtCLENBQUE7QUFFeEQ7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsV0FBVyxDQUFDLEtBQVksRUFBRSxPQUFnQjtJQUM5RCxNQUFNLEtBQUssR0FBRyxNQUFNLE9BQU8sQ0FBQyxPQUFPLEVBQUUsS0FBSyxDQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUE7SUFFbEUsSUFBSSxLQUFLLEtBQUssSUFBSTtRQUFFLE9BQU8sSUFBSSxDQUFBO0lBRS9CLE1BQU0sS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFcEMsT0FBTztRQUNMLGFBQWEsRUFBRSxLQUFLLENBQUMsYUFBYTtRQUNsQyxNQUFNLEVBQUUsS0FBSyxFQUFFLE1BQU07UUFDckIsS0FBSyxFQUFFLEtBQUssQ0FBQyxLQUFLLElBQUksS0FBTSxDQUFDLEtBQUs7S0FDbkMsQ0FBQTtBQUNILENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2V0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc291cmNlL2dldC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sY0FBYyxDQUFBO0FBQ3BDLE9BQU8sRUFBRSxPQUFPLEVBQWdCLE1BQU0sa0JBQWtCLENBQUE7QUFFeEQ7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsV0FBVyxDQUFDLEtBQVksRUFBRSxPQUFnQjtJQUM5RCxNQUFNLEtBQUssR0FBRyxNQUFNLE9BQU8sQ0FBQyxPQUFPLEVBQUUsS0FBSyxDQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUE7SUFFbEUsSUFBSSxLQUFLLEtBQUssSUFBSTtRQUFFLE9BQU8sSUFBSSxDQUFBO0lBRS9CLE1BQU0sS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFcEMsT0FBTztRQUNMLGFBQWEsRUFBRSxLQUFLLENBQUMsYUFBYTtRQUNsQyxNQUFNLEVBQUUsS0FBSyxFQUFFLE1BQU07UUFDckIsS0FBSyxFQUFFLEtBQUssQ0FBQyxLQUFLLElBQUksS0FBTSxDQUFDLEtBQUs7UUFDbEMsT0FBTyxFQUFFLEtBQUssQ0FBQyxPQUFPO1FBQ3RCLFFBQVEsRUFBRSxLQUFLLENBQUMsUUFBUTtLQUN6QixDQUFBO0FBQ0gsQ0FBQyJ9

package/components/configuration.values/operations/lib/errors.js

@@ -0,0 +1,7 @@
+export class UnknownComponentError extends Error {
+    code = 'UNKNOWN_COMPONENT';
+    constructor(component) {
+        super(`Component '${component}' is not configured`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc291cmNlL2xpYi9lcnJvcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsTUFBTSxPQUFPLHFCQUFzQixTQUFRLEtBQUs7SUFDOUIsSUFBSSxHQUFHLG1CQUFtQixDQUFBO0lBRTFDLFlBQW1CLFNBQWlCO1FBQ2xDLEtBQUssQ0FBQyxjQUFjLFNBQVMscUJBQXFCLENBQUMsQ0FBQTtJQUNyRCxDQUFDO0NBQ0YifQ==

package/components/configuration.values/operations/lib/resolve.js

@@ -2,7 +2,8 @@ import { revision } from '@toa.io/definitions/extensions.configuration';
 import { entry } from './map.js';
 /**
  * The latest configuration created for the component and the epoch; the deployed
- * defaults when none was; `null` when the epoch is not the one deployed.
+ * defaults when none was, or when the latest is a reset; `null` when the epoch is not the one
+ * deployed.
  */
 export async function resolve(context, component, epoch) {
     const known = entry(component);
@@ -16,19 +17,21 @@ export async function resolve(context, component, epoch) {
         limit: 1
     };
     const objects = await context.local.enumerate({ query });
-    if (objects.length > 0)
+    const latest = objects[0];
+    if (latest !== undefined && (latest.revision ?? null) === null)
         return {
-            configuration: objects[0].configuration,
-            created: objects[0].CREATED,
+            configuration: latest.configuration,
+            created: latest.CREATED,
             revision: null
         };
-    // what a component was deployed with tells this deployment's defaults from another's
+    // a reset stored the defaults of its deployment; those of this one are what it means
     if (known !== undefined && known.epoch === epoch)
         return {
             configuration: known.defaults ?? {},
-            created: 0,
+            created: latest === undefined ? 0 : latest.CREATED,
+            // what a component was deployed with tells this deployment's defaults from another's
             revision: revision(known.defaults)
         };
     return null;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzb2x2ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NvdXJjZS9saWIvcmVzb2x2ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sOENBQThDLENBQUE7QUFDdkUsT0FBTyxFQUFFLEtBQUssRUFBRSxNQUFNLFVBQVUsQ0FBQTtBQUVoQzs7O0dBR0c7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLE9BQU8sQ0FDM0IsT0FBZ0IsRUFDaEIsU0FBaUIsRUFDakIsS0FBYztJQUVkLE1BQU0sS0FBSyxHQUFHLEtBQUssQ0FBQyxTQUFTLENBQUMsQ0FBQTtJQUU5QixLQUFLLEtBQUssS0FBSyxFQUFFLEtBQUssQ0FBQTtJQUV0QixJQUFJLEtBQUssS0FBSyxTQUFTO1FBQUUsT0FBTyxJQUFJLENBQUE7SUFFcEMsd0ZBQXdGO0lBQ3hGLE1BQU0sS0FBSyxHQUFVO1FBQ25CLFFBQVEsRUFBRSxlQUFlLFNBQVMsYUFBYSxLQUFLLEdBQUc7UUFDdkQsSUFBSSxFQUFFLENBQUMsY0FBYyxDQUFDO1FBQ3RCLEtBQUssRUFBRSxDQUFDO0tBQ1QsQ0FBQTtJQUVELE1BQU0sT0FBTyxHQUFHLE1BQU0sT0FBTyxDQUFDLEtBQUssQ0FBQyxTQUFTLENBQUMsRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFBO0lBRXhELElBQUksT0FBTyxDQUFDLE1BQU0sR0FBRyxDQUFDO1FBQ3BCLE9BQU87WUFDTCxhQUFhLEVBQUUsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLGFBQWE7WUFDdkMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQyxPQUFPO1lBQzNCLFFBQVEsRUFBRSxJQUFJO1NBQ2YsQ0FBQTtJQUVILHFGQUFxRjtJQUNyRixJQUFJLEtBQUssS0FBSyxTQUFTLElBQUksS0FBSyxDQUFDLEtBQUssS0FBSyxLQUFLO1FBQzlDLE9BQU87WUFDTCxhQUFhLEVBQUUsS0FBSyxDQUFDLFFBQVEsSUFBSSxFQUFFO1lBQ25DLE9BQU8sRUFBRSxDQUFDO1lBQ1YsUUFBUSxFQUFFLFFBQVEsQ0FBQyxLQUFLLENBQUMsUUFBUSxDQUFDO1NBQ25DLENBQUE7SUFFSCxPQUFPLElBQUksQ0FBQTtBQUNiLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzb2x2ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NvdXJjZS9saWIvcmVzb2x2ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sOENBQThDLENBQUE7QUFDdkUsT0FBTyxFQUFFLEtBQUssRUFBRSxNQUFNLFVBQVUsQ0FBQTtBQUVoQzs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxPQUFPLENBQzNCLE9BQWdCLEVBQ2hCLFNBQWlCLEVBQ2pCLEtBQWM7SUFFZCxNQUFNLEtBQUssR0FBRyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFOUIsS0FBSyxLQUFLLEtBQUssRUFBRSxLQUFLLENBQUE7SUFFdEIsSUFBSSxLQUFLLEtBQUssU0FBUztRQUFFLE9BQU8sSUFBSSxDQUFBO0lBRXBDLHdGQUF3RjtJQUN4RixNQUFNLEtBQUssR0FBVTtRQUNuQixRQUFRLEVBQUUsZUFBZSxTQUFTLGFBQWEsS0FBSyxHQUFHO1FBQ3ZELElBQUksRUFBRSxDQUFDLGNBQWMsQ0FBQztRQUN0QixLQUFLLEVBQUUsQ0FBQztLQUNULENBQUE7SUFFRCxNQUFNLE9BQU8sR0FBRyxNQUFNLE9BQU8sQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQTtJQUN4RCxNQUFNLE1BQU0sR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUE7SUFFekIsSUFBSSxNQUFNLEtBQUssU0FBUyxJQUFJLENBQUMsTUFBTSxDQUFDLFFBQVEsSUFBSSxJQUFJLENBQUMsS0FBSyxJQUFJO1FBQzVELE9BQU87WUFDTCxhQUFhLEVBQUUsTUFBTSxDQUFDLGFBQWE7WUFDbkMsT0FBTyxFQUFFLE1BQU0sQ0FBQyxPQUFPO1lBQ3ZCLFFBQVEsRUFBRSxJQUFJO1NBQ2YsQ0FBQTtJQUVILHFGQUFxRjtJQUNyRixJQUFJLEtBQUssS0FBSyxTQUFTLElBQUksS0FBSyxDQUFDLEtBQUssS0FBSyxLQUFLO1FBQzlDLE9BQU87WUFDTCxhQUFhLEVBQUUsS0FBSyxDQUFDLFFBQVEsSUFBSSxFQUFFO1lBQ25DLE9BQU8sRUFBRSxNQUFNLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxPQUFPO1lBQ2xELHFGQUFxRjtZQUNyRixRQUFRLEVBQUUsUUFBUSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUM7U0FDbkMsQ0FBQTtJQUVILE9BQU8sSUFBSSxDQUFBO0FBQ2IsQ0FBQyJ9

package/components/configuration.values/operations/list.js

@@ -5,7 +5,14 @@ export async function computation(_, context) {
     return await Promise.all(components().map(async (component) => {
         const { epoch, schema } = entry(component);
         const value = await resolve(context, component, epoch);
-        return { component, epoch, schema, configuration: value.configuration };
+        return {
+            component,
+            epoch,
+            schema,
+            configuration: value.configuration,
+            created: value.created,
+            revision: value.revision
+        };
     }));
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGlzdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NvdXJjZS9saXN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFLE1BQU0sY0FBYyxDQUFBO0FBQ2hELE9BQU8sRUFBRSxPQUFPLEVBQWdCLE1BQU0sa0JBQWtCLENBQUE7QUFFeEQsc0ZBQXNGO0FBQ3RGLE1BQU0sQ0FBQyxLQUFLLFVBQVUsV0FBVyxDQUFDLENBQU8sRUFBRSxPQUFnQjtJQUN6RCxPQUFPLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FDdEIsVUFBVSxFQUFFLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxTQUFTLEVBQUUsRUFBRTtRQUNuQyxNQUFNLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxHQUFHLEtBQUssQ0FBQyxTQUFTLENBQUUsQ0FBQTtRQUMzQyxNQUFNLEtBQUssR0FBRyxNQUFNLE9BQU8sQ0FBQyxPQUFPLEVBQUUsU0FBUyxFQUFFLEtBQUssQ0FBQyxDQUFBO1FBRXRELE9BQU8sRUFBRSxTQUFTLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxhQUFhLEVBQUUsS0FBTSxDQUFDLGFBQWEsRUFBRSxDQUFBO0lBQzFFLENBQUMsQ0FBQyxDQUNILENBQUE7QUFDSCxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGlzdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NvdXJjZS9saXN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFLE1BQU0sY0FBYyxDQUFBO0FBQ2hELE9BQU8sRUFBRSxPQUFPLEVBQWdCLE1BQU0sa0JBQWtCLENBQUE7QUFFeEQsc0ZBQXNGO0FBQ3RGLE1BQU0sQ0FBQyxLQUFLLFVBQVUsV0FBVyxDQUFDLENBQU8sRUFBRSxPQUFnQjtJQUN6RCxPQUFPLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FDdEIsVUFBVSxFQUFFLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxTQUFTLEVBQUUsRUFBRTtRQUNuQyxNQUFNLEVBQUUsS0FBSyxFQUFFLE1BQU0sRUFBRSxHQUFHLEtBQUssQ0FBQyxTQUFTLENBQUUsQ0FBQTtRQUMzQyxNQUFNLEtBQUssR0FBRyxNQUFNLE9BQU8sQ0FBQyxPQUFPLEVBQUUsU0FBUyxFQUFFLEtBQUssQ0FBQyxDQUFBO1FBRXRELE9BQU87WUFDTCxTQUFTO1lBQ1QsS0FBSztZQUNMLE1BQU07WUFDTixhQUFhLEVBQUUsS0FBTSxDQUFDLGFBQWE7WUFDbkMsT0FBTyxFQUFFLEtBQU0sQ0FBQyxPQUFPO1lBQ3ZCLFFBQVEsRUFBRSxLQUFNLENBQUMsUUFBUTtTQUMxQixDQUFBO0lBQ0gsQ0FBQyxDQUFDLENBQ0gsQ0FBQTtBQUNILENBQUMifQ==

package/components/configuration.values/operations/reset.js

@@ -0,0 +1,20 @@
+import { revision } from '@toa.io/definitions/extensions.configuration';
+import { entry } from './lib/map.js';
+import { UnknownComponentError } from './lib/errors.js';
+/**
+ * The deployed defaults, as a new object. The revision tells it from a created one: it is
+ * what a component checks the defaults against, and what makes `resolve` serve the defaults
+ * deployed now rather than those stored.
+ */
+export async function transition(input, object) {
+    const known = entry(input.component);
+    if (known === undefined)
+        return new UnknownComponentError(input.component);
+    object.component = input.component;
+    object.epoch = known.epoch;
+    object.configuration = structuredClone(known.defaults ?? {});
+    object.revision = revision(known.defaults);
+    object.originator = input.originator.id;
+    return object;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzZXQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zb3VyY2UvcmVzZXQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDhDQUE4QyxDQUFBO0FBQ3ZFLE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxjQUFjLENBQUE7QUFDcEMsT0FBTyxFQUFFLHFCQUFxQixFQUFFLE1BQU0saUJBQWlCLENBQUE7QUFFdkQ7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsVUFBVSxDQUFDLEtBQVksRUFBRSxNQUFjO0lBQzNELE1BQU0sS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFcEMsSUFBSSxLQUFLLEtBQUssU0FBUztRQUFFLE9BQU8sSUFBSSxxQkFBcUIsQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFMUUsTUFBTSxDQUFDLFNBQVMsR0FBRyxLQUFLLENBQUMsU0FBUyxDQUFBO0lBQ2xDLE1BQU0sQ0FBQyxLQUFLLEdBQUcsS0FBSyxDQUFDLEtBQUssQ0FBQTtJQUMxQixNQUFNLENBQUMsYUFBYSxHQUFHLGVBQWUsQ0FBQyxLQUFLLENBQUMsUUFBUSxJQUFJLEVBQUUsQ0FBQyxDQUFBO0lBQzVELE1BQU0sQ0FBQyxRQUFRLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsQ0FBQTtJQUMxQyxNQUFNLENBQUMsVUFBVSxHQUFHLEtBQUssQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFBO0lBRXZDLE9BQU8sTUFBTSxDQUFBO0FBQ2YsQ0FBQyJ9

package/components/configuration.values/source/create.ts

@@ -1,6 +1,7 @@
 import * as schemas from '@toa.io/schemas'
 import { assertSecrets } from '@toa.io/definitions/extensions.configuration'
 import { entry } from './lib/map.ts'
+import { UnknownComponentError } from './lib/errors.ts'
 import type { Schema } from '@toa.io/schemas'
 
 export async function transition(input: Input, object: Entity): Promise<Entity | Error> {
@@ -27,14 +28,6 @@ export async function transition(input: Input, object: Entity): Promise<Entity |
   return object
 }
 
-class UnknownComponentError extends Error {
-  public readonly code = 'UNKNOWN_COMPONENT'
-
-  public constructor(component: string) {
-    super(`Component '${component}' is not configured`)
-  }
-}
-
 class InvalidConfigurationError extends Error {
   public readonly code = 'INVALID_CONFIGURATION'
 }

package/components/configuration.values/source/get.ts

@@ -16,7 +16,9 @@ export async function computation(input: Input, context: Context): Promise<Item
   return {
     configuration: value.configuration,
     schema: known?.schema,
-    epoch: input.epoch ?? known!.epoch
+    epoch: input.epoch ?? known!.epoch,
+    created: value.created,
+    revision: value.revision
   }
 }
 
@@ -29,4 +31,6 @@ interface Item {
   configuration: object
   schema?: object
   epoch: string
+  created: number
+  revision: string | null
 }

package/components/configuration.values/source/lib/errors.ts

@@ -0,0 +1,7 @@
+export class UnknownComponentError extends Error {
+  public readonly code = 'UNKNOWN_COMPONENT'
+
+  public constructor(component: string) {
+    super(`Component '${component}' is not configured`)
+  }
+}

package/components/configuration.values/source/lib/resolve.ts

@@ -3,7 +3,8 @@ import { entry } from './map.ts'
 
 /**
  * The latest configuration created for the component and the epoch; the deployed
- * defaults when none was; `null` when the epoch is not the one deployed.
+ * defaults when none was, or when the latest is a reset; `null` when the epoch is not the one
+ * deployed.
  */
 export async function resolve(
   context: Context,
@@ -24,19 +25,21 @@ export async function resolve(
   }
 
   const objects = await context.local.enumerate({ query })
+  const latest = objects[0]
 
-  if (objects.length > 0)
+  if (latest !== undefined && (latest.revision ?? null) === null)
     return {
-      configuration: objects[0].configuration,
-      created: objects[0].CREATED,
+      configuration: latest.configuration,
+      created: latest.CREATED,
       revision: null
     }
 
-  // what a component was deployed with tells this deployment's defaults from another's
+  // a reset stored the defaults of its deployment; those of this one are what it means
   if (known !== undefined && known.epoch === epoch)
     return {
       configuration: known.defaults ?? {},
-      created: 0,
+      created: latest === undefined ? 0 : latest.CREATED,
+      // what a component was deployed with tells this deployment's defaults from another's
       revision: revision(known.defaults)
     }
 
@@ -44,8 +47,8 @@ export async function resolve(
 }
 
 /**
- * A configuration and when it was created; `0` for the deployed defaults, which alone have a
- * revision.
+ * A configuration and when it was created: `0` for the deployed defaults, unless a reset
+ * brought them back. The defaults alone have a revision.
  */
 export interface Value {
   configuration: object
@@ -67,5 +70,6 @@ interface Query {
 
 interface Stored {
   configuration: object
+  revision?: string | null
   CREATED: number
 }

package/components/configuration.values/source/list.ts

@@ -8,7 +8,14 @@ export async function computation(_: null, context: Context): Promise<Item[]> {
       const { epoch, schema } = entry(component)!
       const value = await resolve(context, component, epoch)
 
-      return { component, epoch, schema, configuration: value!.configuration }
+      return {
+        component,
+        epoch,
+        schema,
+        configuration: value!.configuration,
+        created: value!.created,
+        revision: value!.revision
+      }
     })
   )
 }
@@ -18,4 +25,6 @@ interface Item {
   epoch: string
   schema: object
   configuration: object
+  created: number
+  revision: string | null
 }

package/components/configuration.values/source/reset.ts

@@ -0,0 +1,38 @@
+import { revision } from '@toa.io/definitions/extensions.configuration'
+import { entry } from './lib/map.ts'
+import { UnknownComponentError } from './lib/errors.ts'
+
+/**
+ * The deployed defaults, as a new object. The revision tells it from a created one: it is
+ * what a component checks the defaults against, and what makes `resolve` serve the defaults
+ * deployed now rather than those stored.
+ */
+export async function transition(input: Input, object: Entity): Promise<Entity | Error> {
+  const known = entry(input.component)
+
+  if (known === undefined) return new UnknownComponentError(input.component)
+
+  object.component = input.component
+  object.epoch = known.epoch
+  object.configuration = structuredClone(known.defaults ?? {})
+  object.revision = revision(known.defaults)
+  object.originator = input.originator.id
+
+  return object
+}
+
+interface Input {
+  component: string
+  originator: {
+    id: string
+  }
+}
+
+interface Entity {
+  id: string
+  component: string
+  epoch: string
+  configuration: object
+  revision: string
+  originator: string
+}

package/components/configuration.values/types/toa.d.ts

@@ -1,7 +1,7 @@
 // Written by `toa types`. Every run rewrites it.
 // What a manifest does not state belongs in a file of your own.
 
-import type { Options, Query, RemoteError } from '@toa.io/core/types'
+import type { Query, RemoteError } from '@toa.io/core/types'
 import type { Readable } from 'node:stream'
 
 export interface Entity {
@@ -9,6 +9,7 @@ export interface Entity {
   epoch: string
   configuration: Record<string, unknown>
   originator: string
+  revision?: string | null
   id: string
   VERSION: number
   CREATED: number
@@ -26,6 +27,8 @@ export type GetOutput = {
   configuration: Record<string, unknown>
   schema?: Record<string, unknown>
   epoch: string
+  created: number
+  revision: string | null
 } | null
 
 export type FetchInput = Array<{
@@ -46,6 +49,8 @@ export type ListOutput = Array<{
   epoch: string
   schema: Record<string, unknown>
   configuration: Record<string, unknown>
+  created: number
+  revision: string | null
 }>
 
 export type CreateInput = {
@@ -56,15 +61,23 @@ export type CreateInput = {
   }
 }
 
+export type ResetInput = {
+  component: string
+  originator: {
+    id: string
+  }
+}
+
 export interface Component {
-  get: (request: { input: GetInput, task?: boolean }, options?: Options) => Promise<GetOutput>
-  fetch: (request: { input: FetchInput, task?: boolean }, options?: Options) => Promise<FetchOutput>
-  list: (request: { input?: null, task?: boolean }, options?: Options) => Promise<ListOutput>
-  create: (request: { input: CreateInput, task?: boolean }, options?: Options) => Promise<unknown | RemoteError<"UNKNOWN_COMPONENT" | "INVALID_CONFIGURATION">>
-  assign: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity>
-  ensure: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity>
-  enumerate: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity[]>
-  observe: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity | null>
-  stream: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Readable>
-  terminate: (request: { input?: null, query?: Query<Entity>, task?: boolean }, options?: Options) => Promise<Entity>
+  get: (request: { input: GetInput, task?: boolean }) => Promise<GetOutput>
+  fetch: (request: { input: FetchInput, task?: boolean }) => Promise<FetchOutput>
+  list: (request: { input?: null, task?: boolean }) => Promise<ListOutput>
+  create: (request: { input: CreateInput, task?: boolean }) => Promise<unknown | RemoteError<"UNKNOWN_COMPONENT" | "INVALID_CONFIGURATION">>
+  reset: (request: { input: ResetInput, task?: boolean }) => Promise<unknown | RemoteError<"UNKNOWN_COMPONENT">>
+  assign: (request: { input?: null, query?: Query<Entity>, task?: boolean }) => Promise<Entity>
+  ensure: (request: { input?: null, query?: Query<Entity>, task?: boolean }) => Promise<Entity>
+  enumerate: (request: { input?: null, query?: Query<Entity>, task?: boolean }) => Promise<Entity[]>
+  observe: (request: { input?: null, query?: Query<Entity>, task?: boolean }) => Promise<Entity | null>
+  stream: (request: { input?: null, query?: Query<Entity>, task?: boolean }) => Promise<Readable>
+  terminate: (request: { input?: null, query?: Query<Entity>, task?: boolean }) => Promise<Entity>
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.configuration",
-  "version": "1.0.0-alpha.313",
+  "version": "1.0.0-alpha.315",
   "type": "module",
   "description": "Toa Configuration",
   "author": "temich <tema.gurtovoy@gmail.com>",
@@ -32,10 +32,10 @@
     "prepack": "npm run build:ui",
     "features": "TSX_TSCONFIG_PATH=features/steps/tsconfig.json NODE_OPTIONS=--import=tsx cucumber-js"
   },
-  "gitHead": "7da3b2627ceeefd1fa19d5c8851be88d928523b6",
+  "gitHead": "d88ed286bf44bf95b5f3d9db6e7d4621261dbb99",
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.312",
-    "@toa.io/definitions": "1.0.0-alpha.313",
+    "@toa.io/core": "1.0.0-alpha.315",
+    "@toa.io/definitions": "1.0.0-alpha.315",
     "@toa.io/generic": "1.0.0-alpha.311",
     "@toa.io/schemas": "1.0.0-alpha.311",
     "openspan": "1.0.0-alpha.305"

package/readme.md

@@ -233,50 +233,64 @@ created one. Each object records its `originator`.
 
 The configuration of a component for an epoch is:
 
-1. The latest object created for the component and the epoch;
+1. The latest object created for the component and the epoch, unless it is a reset;
 2. Otherwise, the deployed defaults, if the epoch is the deployed one;
 3. Otherwise, none.
 
+A reset brings a component back to its deployed defaults and keeps it following them: a later
+deployment that changes the defaults changes what is served after a reset.
+
 ### Operations
 
 - `get({ component, epoch? })`: the configuration with the schema it is checked against, as
-  `{ configuration, schema, epoch }`, or `null` when there is none. The epoch is the deployed
-  one when omitted; an epoch the deployment does not know has no `schema`.
+  `{ configuration, schema, epoch, created, revision }`, or `null` when there is none. The
+  epoch is the deployed one when omitted; an epoch the deployment does not know has no
+  `schema`. `created` is `0` for the deployed defaults, unless a reset brought them back.
+  `revision` is that of the deployed defaults when they are what is served, and `null` for a
+  created object.
 - `fetch([{ component, epoch }])`: the same for several pairs at once, as
-  `[{ component, epoch, configuration, created, revision }]`. `revision` is that of the deployed
-  defaults when they are what is served, and `null` for a created object.
+  `[{ component, epoch, configuration, created, revision }]`.
 - `list()`: every component's configuration for its deployed epoch, by component name, as
-  `[{ component, epoch, schema, configuration }]`.
+  `[{ component, epoch, schema, configuration, created, revision }]`.
 - `create({ component, configuration, originator })`: a new object for the component's
   deployed epoch. The configuration must satisfy the schema. Errors: `UNKNOWN_COMPONENT`,
   `INVALID_CONFIGURATION`.
+- `reset({ component, originator })`: a new object for the component's deployed epoch, holding
+  its deployed defaults and their `revision`. Errors: `UNKNOWN_COMPONENT`.
 
-Creating a configuration publishes the `configuration.values.created` event with the
-object as stored.
+Creating and resetting publish the `configuration.values.created` event with the object as
+stored. The object of a reset carries a `revision`; a created one does not.
 
 ### Resources
 
-| Method | Path                                | Role                          |
-| ------ | ----------------------------------- | ----------------------------- |
-| `GET`  | `/configuration/values/`            | `system:configuration:get`    |
-| `GET`  | `/configuration/values/:component/` | `system:configuration:get`    |
-| `POST` | `/configuration/values/:component/` | `system:configuration:create` |
+| Method   | Path                                | Role                          |
+| -------- | ----------------------------------- | ----------------------------- |
+| `GET`    | `/configuration/values/`            | `system:configuration:get`    |
+| `GET`    | `/configuration/values/:component/` | `system:configuration:get`    |
+| `POST`   | `/configuration/values/:component/` | `system:configuration:create` |
+| `DELETE` | `/configuration/values/:component/` | `system:configuration:create` |
 
 `GET /configuration/values/` lists every component's configuration for its deployed epoch, by
-component name, as `[{ component, epoch, schema, configuration }]`.
+component name, as `[{ component, epoch, schema, configuration, created, revision }]`.
 
-`GET /configuration/values/:component/` returns `{ configuration, schema, epoch }` for the
-deployed epoch, `404` when there is none.
+`GET /configuration/values/:component/` returns
+`{ configuration, schema, epoch, created, revision }` for the deployed epoch, `404` when
+there is none.
 
 `POST` takes `{ configuration }`, records the Identity as the `originator`, and returns
 `{ id, epoch }`. A configuration not satisfying the schema, or an unknown component, is
 `422`.
 
+`DELETE` resets the component's configuration to its deployed defaults, records the Identity as
+the `originator`, and answers `204`. An unknown component is `422`.
+
 ## UI
 
-The values service serves a page listing the configured components and creating
-configurations, mounted at `/.configuration` on port `8003`. Reading it needs the
-`system:configuration:get` role, creating needs `system:configuration:create`.
+The values service serves a page listing the configured components, creating configurations and
+resetting them, mounted at `/.configuration` on port `8003`. Reading it needs the
+`system:configuration:get` role, creating and resetting need `system:configuration:create`.
+A created configuration is marked on the list. Reset is offered only for those: the deployed
+defaults have nothing to bring back.
 
 The page is always published: unlike the introspection annotation, the configuration
 annotation is the per-component values map and has nowhere to carry a switch.
@@ -297,12 +311,13 @@ On start, a component requests its configuration for its epoch from the values s
 waits until there is one, reporting every fifth attempt. The schema is applied, and secrets
 are substituted. What is served is what was stored, whole: a `default` written into the schema
 fills nothing, so a value every component is to have is declared in `defaults`. After a
-configuration is created, the running component receives the new object and takes it when its
-`CREATED` is later than that of the value it holds.
+configuration is created or reset, the running component receives the new object and takes it
+when its `CREATED` is later than that of the value it holds.
 
 Deployed defaults are taken only from a values service of the component's own
 [revision](#revision). One of another — a values service of the previous deployment, still serving
-while it is replaced — is refused and asked again, and the refusal is logged as
+while it is replaced — is refused and asked again, at start and when a running component
+receives a reset, and the refusal is logged as
 `Configuration of another revision refused` with the `component`, its `epoch`, the `expected`
 revision and the `received` one, on the first refusal and every fifth. A created configuration is
 taken from any. A component deployed without a revision, one started by `toa compose` or evicted

package/transpiled/Aspect.d.ts

@@ -8,6 +8,7 @@ export declare class Aspect extends Connector implements extensions.Aspect {
     private readonly manifest;
     private readonly client;
     private readonly epoch;
+    private readonly revision;
     private value;
     private created;
     /**

package/transpiled/Aspect.js

@@ -8,6 +8,7 @@ export class Aspect extends Connector {
     manifest;
     client;
     epoch;
+    revision;
     value = {};
     created = 0;
     /**
@@ -20,6 +21,7 @@ export class Aspect extends Connector {
         this.manifest = manifest;
         this.client = client;
         this.epoch = epoch(manifest.schema);
+        this.revision = revision(locator);
         if (client !== null)
             this.depends(client);
     }
@@ -35,7 +37,7 @@ export class Aspect extends Connector {
             this.value = local(this.locator, this.manifest);
             return;
         }
-        const { configuration, created } = await this.client.fetch(this.locator.id, this.epoch, revision(this.locator));
+        const { configuration, created } = await this.client.fetch(this.locator.id, this.epoch, this.revision);
         this.value = fit(configuration, this.manifest);
         this.created = created;
         this.client.subscribe(this.locator.id, this.epoch, this.listener);
@@ -48,10 +50,19 @@ export class Aspect extends Connector {
     async close() {
         this.client?.unsubscribe(this.locator.id, this.epoch, this.listener);
     }
-    listener = ({ configuration, created }) => {
+    listener = (value) => {
         // deliveries may repeat or cross: only what is newer than the held value replaces it
-        if (created <= this.created)
+        if (value.created <= this.created)
             return;
+        // a reset made by a values service of another deployment holds that deployment's defaults,
+        // so they are asked for as on start, where a refusal is reported
+        if (this.revision !== undefined &&
+            value.revision !== null &&
+            value.revision !== this.revision) {
+            void this.client.fetch(this.locator.id, this.epoch, this.revision).then(this.listener);
+            return;
+        }
+        const { configuration, created } = value;
         try {
             this.value = fit(configuration, this.manifest);
             this.created = created;