@toa.io/extensions.configuration 1.0.0-alpha.31 → 1.0.0-alpha.311

package/readme.md

@@ -11,8 +11,12 @@ namespace: dummies
 
 configuration:
   schema:
-    foo: string
-    bar: number
+    type: object
+    properties:
+      foo:
+        type: string
+      bar:
+        type: number
   defaults:
     foo: bar
     bar: 1
@@ -21,7 +25,7 @@ configuration:
 ### Use
 
 ```javascript
-function transition (input, entity, context) {
+function transition(input, entity, context) {
   const { foo, bar } = context.configuration
 
   // ...
@@ -34,9 +38,9 @@ function transition (input, entity, context) {
 # context.toa.yaml
 configuration:
   dummies.dummy:
-    foo: qux          # override default value
+    foo: qux # override default value
     foo@staging: quux # deployment environment discriminator
-    bar: $BAZ_VALUE   # secret
+    bar: $BAZ_VALUE # secret
 ```
 
 ### Deploy secrets
@@ -45,22 +49,28 @@ configuration:
 $ toa conceal configuration BAZ_VALUE=$ecr3t
 ```
 
----
+### Change at runtime
 
-## Problem Definition
+```http
+POST /configuration/values/dummies.dummy/ HTTP/1.1
+authorization: Token ...
+content-type: application/yaml
 
-- Components should be runnable in different deployment environments.
-- Some algorithm's parameters should be deployed secretly.
-- Components should be reusable in different contexts.
+configuration:
+  foo: quux
+  bar: 2
+```
+
+---
 
 ## Manifest
 
-Component's configuration is declared using `configuration` manifest,
-containing `schema` and optionnaly `defaults` properties.
+Component's configuration is declared using the `configuration` manifest, containing `schema`
+and optionally `defaults` properties.
 
 ### Schema
 
-Configuration schema is declared with [COS](/libraries/concise).
+Configuration schema is declared with [JSON Schema](https://json-schema.org).
 
 ```yaml
 # manifest.toa.yaml
@@ -69,30 +79,24 @@ namespace: dummies
 
 configuration:
   schema:
-    foo: string
-    bar: number
+    type: object
+    properties:
+      foo:
+        type: string
+      bar:
+        type: number
+      token:
+        type: string
+        format: secret
 ```
 
-> Introducing non-backward compatible changes to a configuration schema will result in a loss of
-> compatibility with existing contexts and deployment environments.
-> Therefore, configuration schema changes are subject to component versioning.
-
-If `configuration` object doesn't contain property `schema`, then it is considered to be schema.
-
-```yaml
-# manifest.toa.yaml
-name: dummy
-namespace: dummies
-
-configuration:
-  foo: string
-  bar: number
-```
+A string the component reads as a secret is declared `format: secret`. It is a `Secret`
+on the context, and is given as a `$NAME` reference — see [Secrets](#secrets).
 
 ### Defaults
 
-The default configuration value can be provided using the `defaults` property, which should conform
-to the configuration schema.
+The default configuration value can be provided using the `defaults` property, which should
+conform to the configuration schema.
 
 ```yaml
 # manifest.toa.yaml
@@ -101,27 +105,22 @@ namespace: dummies
 
 configuration:
   schema:
-    foo: string
-    bar: number
+    type: object
+    properties:
+      foo:
+        type: string
+      bar:
+        type: number
   defaults:
     foo: hello
     bar: 0
 ```
 
-#### Schema defaults hint
-
-The configuration schema itself can contain default primitive values using the COS syntax.
+### Epoch
 
-```yaml
-# manifest.toa.yaml
-name: dummy
-namespace: dummies
-
-configuration:
-  schema:
-    foo: hello
-    bar: 0
-```
+The configuration epoch of a component is the SHA-256 of its configuration schema, as
+canonical JSON. A configuration object belongs to the epoch of the schema it was validated
+against. A schema change is a new epoch.
 
 ## Annotation
 
@@ -136,9 +135,37 @@ configuration:
     bar@staging: 2
 ```
 
+The annotated object is deployed as the defaults of the component for its epoch, in place of
+the manifest `defaults`.
+
+Every key names a component except `resources`, which is the values service's own: it deploys
+like any other and states what it may take. A component actually named `resources` is written
+with its namespace, `default.resources` — the bare form is only shorthand for that.
+
+```yaml
+# context.toa.yaml
+configuration:
+  resources:
+    cpu: [200m, 1000m]
+    memory: [200Mi, 500Mi]
+  dummies.dummy:
+    foo: bye
+```
+
 ## Secrets
 
-Configuration annotation top-level values which are uppercase strings prefixed with `$` considered as secrets.
+A property declared `format: secret` is given as an uppercase name prefixed with `$`.
+A plain string in its place is refused.
+
+```yaml
+# manifest.toa.yaml
+configuration:
+  schema:
+    properties:
+      api-key:
+        type: string
+        format: secret
+```
 
 ```yaml
 # context.toa.yaml
@@ -158,14 +185,115 @@ Deployed kubernetes secret's name is predefined as `configuration`.
 $ toa conceal configuration STRIPE_API_KEY=xxxxxxxx
 ```
 
+A secret is substituted in the component's process, from the variable
+`TOA_CONFIGURATION__<NAME>` deployed to it — a variable the component's code cannot read.
+The values service holds and returns the reference.
+
+In the component, a secret is a `Secret` object: `unwrap()` returns the string, while
+`toString()`, JSON and `util.inspect` give `<REDACTED>`.
+
+```javascript
+function transition(input, entity, context) {
+  const key = context.configuration.apiKey.unwrap()
+
+  // ...
+}
+```
+
+## Values
+
+Configuration values are held by the `configuration.values` component, deployed as the
+`configuration-values` service. The service is deployed with the variable
+`TOA_CONFIGURATION_VALUES`: the epoch, the schema and the defaults of every component
+declaring configuration, [evicted](/documentation/compositions.md#evicted) ones included.
+
+```json
+{
+  "dummies.dummy": {
+    "epoch": "3f2a…",
+    "schema": { "type": "object", "properties": { "foo": { "type": "string" } } },
+    "defaults": { "foo": "bye" }
+  }
+}
+```
+
+Configuration objects are immutable. Creating a configuration is creating a new object for
+the component's current epoch; the latest object for a component and an epoch is the last
+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;
+2. Otherwise, the deployed defaults, if the epoch is the deployed one;
+3. Otherwise, none.
+
+### 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`.
+- `fetch([{ component, epoch }])`: the same for several pairs at once, as
+  `[{ component, epoch, configuration }]`.
+- `list()`: every component's configuration for its deployed epoch, by component name, as
+  `[{ component, epoch, schema, configuration }]`.
+- `create({ component, configuration, originator })`: a new object for the component's
+  deployed epoch. The configuration must satisfy the schema. Errors: `UNKNOWN_COMPONENT`,
+  `INVALID_CONFIGURATION`.
+
+Creating a configuration publishes the `configuration.values.created` event with the
+object as stored.
+
+### Resources
+
+| Method | Path                                | Role                          |
+| ------ | ----------------------------------- | ----------------------------- |
+| `GET`  | `/configuration/values/`            | `system:configuration:get`    |
+| `GET`  | `/configuration/values/:component/` | `system:configuration:get`    |
+| `POST` | `/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 }]`.
+
+`GET /configuration/values/:component/` returns `{ configuration, schema, epoch }` 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`.
+
+## 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 page is always published: unlike the introspection annotation, the configuration
+annotation is the per-component values map and has nowhere to carry a switch.
+
 ## Aspect
 
 Component's configuration values are available as a well-known Aspect `configuration`.
 
 ```javascript
-function transition (input, entity, context) {
-  const foo = context.configiuration.foo
+function transition(input, entity, context) {
+  const foo = context.configuration.foo
 
   // ...
 }
 ```
+
+On start, a component requests its configuration for its epoch from the values service and
+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.
+
+### Local override
+
+When the variable `TOA_CONFIGURATION_<NAMESPACE>_<NAME>` is set, the component's
+configuration is the variable's value with the manifest `defaults` filled in and the schema
+applied, and the values service is not used.
+
+```shell
+$ TOA_CONFIGURATION_DUMMIES_DUMMY='{"foo":"local"}' toa run components/dummy
+```

package/transpiled/Aspect.d.ts

@@ -1,7 +1,22 @@
-import { Connector, type extensions } from '@toa.io/core';
+import { Connector, type Locator } from '@toa.io/core';
+import type { extensions } from '@toa.io/core/types';
+import type { Client } from './Client.ts';
+import type { Manifest } from '@toa.io/definitions/extensions.configuration';
 export declare class Aspect extends Connector implements extensions.Aspect {
     readonly name = "configuration";
-    private readonly value;
-    constructor(value: object);
-    invoke(path: string[]): any;
+    private readonly locator;
+    private readonly manifest;
+    private readonly client;
+    private readonly epoch;
+    private value;
+    private created;
+    /**
+     * Without a client the value is local: the variable, the defaults and the schema.
+     * With one, the value is what the service holds, and it follows the service.
+     */
+    constructor(locator: Locator, manifest: Manifest, client: Client | null);
+    invoke(path?: string[]): any;
+    protected open(): Promise<void>;
+    protected close(): Promise<void>;
+    private readonly listener;
 }

package/transpiled/Aspect.js

@@ -1,13 +1,27 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Aspect = void 0;
-const core_1 = require("@toa.io/core");
-class Aspect extends core_1.Connector {
+import { console } from 'openspan';
+import { Connector } from '@toa.io/core';
+import { fit, local } from './configuration.js';
+import { epoch } from '@toa.io/definitions/extensions.configuration';
+export class Aspect extends Connector {
     name = 'configuration';
-    value;
-    constructor(value) {
+    locator;
+    manifest;
+    client;
+    epoch;
+    value = {};
+    created = 0;
+    /**
+     * Without a client the value is local: the variable, the defaults and the schema.
+     * With one, the value is what the service holds, and it follows the service.
+     */
+    constructor(locator, manifest, client) {
         super();
-        this.value = value;
+        this.locator = locator;
+        this.manifest = manifest;
+        this.client = client;
+        this.epoch = epoch(manifest.schema);
+        if (client !== null)
+            this.depends(client);
     }
     invoke(path) {
         let cursor = this.value;
@@ -16,6 +30,45 @@ class Aspect extends core_1.Connector {
                 cursor = cursor[segment];
         return cursor;
     }
+    async open() {
+        if (this.client === null) {
+            this.value = local(this.locator, this.manifest);
+            return;
+        }
+        const { configuration, created } = await this.client.fetch(this.locator.id, this.epoch);
+        this.value = fit(configuration, this.manifest);
+        this.created = created;
+        this.client.subscribe(this.locator.id, this.epoch, this.listener);
+        console.trace('Configuration resolved', {
+            component: this.locator.id,
+            epoch: this.epoch,
+            created
+        });
+    }
+    async close() {
+        this.client?.unsubscribe(this.locator.id, this.epoch, this.listener);
+    }
+    listener = ({ configuration, created }) => {
+        // deliveries may repeat or cross: only what is newer than the held value replaces it
+        if (created <= this.created)
+            return;
+        try {
+            this.value = fit(configuration, this.manifest);
+            this.created = created;
+            console.info('Configuration updated', {
+                component: this.locator.id,
+                epoch: this.epoch,
+                created
+            });
+        }
+        catch (error) {
+            // the service validated it against the schema of its epoch, so the two schemas differ
+            console.error('Configuration value does not match the schema', {
+                component: this.locator.id,
+                epoch: this.epoch,
+                error
+            });
+        }
+    };
 }
-exports.Aspect = Aspect;
 //# sourceMappingURL=Aspect.js.map

package/transpiled/Aspect.js.map

@@ -1 +1 @@
-{"version":3,"file":"Aspect.js","sourceRoot":"","sources":["../source/Aspect.ts"],"names":[],"mappings":";;;AAAA,uCAAyD;AAEzD,MAAa,MAAO,SAAQ,gBAAS;IACnB,IAAI,GAAG,eAAe,CAAA;IAErB,KAAK,CAAQ;IAE9B,YAAoB,KAAa;QAC/B,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,MAAM,CAAE,IAAc;QAC3B,IAAI,MAAM,GAAQ,IAAI,CAAC,KAAK,CAAA;QAE5B,IAAI,IAAI,KAAK,SAAS;YACpB,KAAK,MAAM,OAAO,IAAI,IAAI;gBACxB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QAE5B,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AApBD,wBAoBC"}
+{"version":3,"file":"Aspect.js","sourceRoot":"","sources":["../source/Aspect.ts"],"names":[],"mappings":"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"}

package/transpiled/Client.d.ts

@@ -0,0 +1,59 @@
+import { Connector } from '@toa.io/core';
+import type { Host } from './Factory.ts';
+/**
+ * One per process: one remote to the values service and one subscription to its events,
+ * shared by every Aspect. What the Aspects ask for is collected and sent as one call;
+ * what the service creates afterwards is handed to whoever subscribed.
+ */
+export declare class Client extends Connector {
+    /** Disconnected once, a connector keeps what it depended on, so a gone client is not reused. */
+    private readonly host;
+    private readonly options;
+    private readonly pending;
+    private readonly listeners;
+    private remote;
+    private timer;
+    private flushing;
+    private fresh;
+    private round;
+    constructor(host: Host, options?: Partial<Options>);
+    /** The configuration of a component for an epoch, once the service has one. */
+    fetch(component: string, epoch: string): Promise<Value>;
+    subscribe(component: string, epoch: string, listener: Listener): void;
+    unsubscribe(component: string, epoch: string, listener: Listener): void;
+    protected open(): Promise<void>;
+    protected close(): Promise<void>;
+    private schedule;
+    private flush;
+    /** Those the service has served are told; the rest stay for the next round. */
+    private settle;
+    private report;
+    private backoff;
+    /** A created object goes to the subscribers of its component and epoch, as it is. */
+    private deliver;
+}
+export interface Options {
+    base: number;
+    max: number;
+    /** Every n-th round of waiting is reported. */
+    warn: number;
+}
+/** A configuration and when it was created; `0` for the deployed defaults. */
+export interface Value {
+    configuration: object;
+    created: number;
+}
+export interface Fetched {
+    component: string;
+    epoch: string;
+    configuration: object | null;
+    created: number;
+}
+/** The `configuration.values.created` payload: the object as stored. */
+export interface Created {
+    component: string;
+    epoch: string;
+    configuration: object;
+    CREATED: number;
+}
+export type Listener = (value: Value) => void;

package/transpiled/Client.js

@@ -0,0 +1,171 @@
+import { console } from 'openspan';
+import { Connector, Locator } from '@toa.io/core';
+import { EVENT, SOURCE } from '@toa.io/definitions/extensions.configuration';
+/**
+ * One per process: one remote to the values service and one subscription to its events,
+ * shared by every Aspect. What the Aspects ask for is collected and sent as one call;
+ * what the service creates afterwards is handed to whoever subscribed.
+ */
+export class Client extends Connector {
+    /** Disconnected once, a connector keeps what it depended on, so a gone client is not reused. */
+    host;
+    options;
+    pending = new Map();
+    listeners = new Map();
+    remote = null;
+    timer = null;
+    flushing = false;
+    fresh = false;
+    round = 0;
+    constructor(host, options = {}) {
+        super();
+        this.host = host;
+        this.options = { ...DEFAULTS, ...options };
+    }
+    /** The configuration of a component for an epoch, once the service has one. */
+    async fetch(component, epoch) {
+        const key = id(component, epoch);
+        let entry = this.pending.get(key);
+        if (entry === undefined) {
+            entry = { component, epoch, waiters: [] };
+            this.pending.set(key, entry);
+        }
+        const promise = new Promise((resolve) => {
+            entry.waiters.push(resolve);
+        });
+        if (this.flushing)
+            this.fresh = true;
+        else
+            this.schedule(0);
+        return await promise;
+    }
+    subscribe(component, epoch, listener) {
+        const key = id(component, epoch);
+        if (!this.listeners.has(key))
+            this.listeners.set(key, new Set());
+        this.listeners.get(key).add(listener);
+    }
+    unsubscribe(component, epoch, listener) {
+        this.listeners.get(id(component, epoch))?.delete(listener);
+    }
+    async open() {
+        this.remote = await this.host.remote(LOCATOR, SOURCE);
+        this.depends(this.remote);
+        await this.remote.connect();
+        const subscription = new Subscription(this.deliver.bind(this));
+        const consumer = await this.host.receive(EVENT, subscription);
+        this.depends(consumer);
+        await consumer.connect();
+    }
+    async close() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    schedule(delay) {
+        if (this.flushing)
+            return;
+        if (this.timer !== null) {
+            // a request that has just arrived does not wait for the round already planned
+            if (delay > 0)
+                return;
+            clearTimeout(this.timer);
+        }
+        this.timer = setTimeout(() => {
+            void this.flush();
+        }, delay);
+    }
+    async flush() {
+        this.timer = null;
+        this.flushing = true;
+        this.fresh = false;
+        const batch = [...this.pending.values()];
+        const input = batch.map(({ component, epoch }) => ({ component, epoch }));
+        try {
+            const output = await this.remote.invoke('fetch', { input });
+            if (output instanceof Error)
+                throw output;
+            this.settle(output);
+        }
+        catch (error) {
+            console.warn('Configuration fetch failed', { error });
+        }
+        finally {
+            this.flushing = false;
+        }
+        this.report(batch);
+        if (this.pending.size === 0)
+            return;
+        if (this.fresh)
+            this.schedule(0);
+        else
+            this.schedule(this.backoff());
+    }
+    /** Those the service has served are told; the rest stay for the next round. */
+    settle(output) {
+        for (const { component, epoch, configuration, created } of output) {
+            if (configuration === null)
+                continue;
+            const key = id(component, epoch);
+            const entry = this.pending.get(key);
+            if (entry === undefined)
+                continue;
+            this.pending.delete(key);
+            for (const resolve of entry.waiters)
+                resolve({ configuration, created });
+        }
+    }
+    report(batch) {
+        const waiting = batch
+            .filter(({ component, epoch }) => this.pending.has(id(component, epoch)))
+            .map(({ component }) => component);
+        if (waiting.length === 0) {
+            this.round = 0;
+            return;
+        }
+        this.round++;
+        if (this.round % this.options.warn === 1)
+            console.warn('Waiting for configuration', {
+                components: waiting,
+                round: this.round
+            });
+    }
+    backoff() {
+        return Math.min(this.options.base * Math.pow(FACTOR, this.round), this.options.max);
+    }
+    /** A created object goes to the subscribers of its component and epoch, as it is. */
+    deliver(created) {
+        const listeners = this.listeners.get(id(created.component, created.epoch));
+        if (listeners === undefined)
+            return;
+        const value = {
+            configuration: created.configuration,
+            created: created.CREATED
+        };
+        for (const listener of listeners)
+            listener(value);
+    }
+}
+/** What the event consumer hands deliveries to. */
+class Subscription extends Connector {
+    handler;
+    constructor(handler) {
+        super();
+        this.handler = handler;
+    }
+    async receive(message) {
+        this.handler(message.payload);
+    }
+}
+function id(component, epoch) {
+    return component + '\0' + epoch;
+}
+const LOCATOR = new Locator('values', 'configuration');
+const FACTOR = 1.5;
+const DEFAULTS = {
+    base: 1000,
+    max: 10000,
+    warn: 5
+};
+//# sourceMappingURL=Client.js.map

package/transpiled/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../source/Client.ts"],"names":[],"mappings":"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"}

package/transpiled/Composition.d.ts

@@ -0,0 +1,14 @@
+import { Connector } from '@toa.io/core';
+import type { Host } from './Factory.ts';
+/** Hosts the values component in the service process. */
+export declare class Composition extends Connector {
+    private readonly host;
+    constructor(host: Host);
+    protected open(): Promise<void>;
+}
+export declare function components(): Components;
+interface Components {
+    labels: string[];
+    paths: string[];
+}
+export {};