@toa.io/extensions.configuration 1.0.0-alpha.28 → 1.0.0-alpha.282

package/source/deployment.ts

@@ -1,35 +1,64 @@
+import { readFileSync } from 'node:fs'
 import assert from 'node:assert'
-import { type Dependency, type Variable, type Variables } from '@toa.io/operations'
-import * as schemas from '@toa.io/schemas'
-import { encode, overwrite } from '@toa.io/generic'
-import { type Manifest } from './manifest'
-import * as validators from './schemas'
-import type { Schema } from '@toa.io/schemas'
+import { type Dependency, type Resources, type Service, type Variable, type Variables } from '@toa.io/operations'
+import { components } from './Composition.js'
+import { EVENT, PREFIX, SECRET_RX, UI_PATH, UI_PORT, VALUES } from './const.js'
+import { epoch } from './epoch.js'
+import * as validators from './schemas.js'
+import type { Manifest } from './manifest.js'
 import type { context } from '@toa.io/norm'
 
 export function deployment (instances: Instance[], annotation: Annotation = {}): Dependency {
-  validate(annotation, instances)
+  const { resources, values } = split(annotation)
+
+  annotation = prepare(values, instances)
 
   const variables: Variables = {}
 
   for (const instance of instances) {
     const values = annotation[instance.locator.id]
 
-    validateInstance(instance, values)
+    if (values === undefined)
+      continue
 
-    if (values === undefined) continue
+    const secrets = createSecrets(values)
 
-    variables[instance.locator.label] = [{
-      name: PREFIX + instance.locator.uppercase,
-      value: encode(values)
+    if (secrets.length > 0)
+      variables[instance.locator.label] = secrets
+  }
+
+  const service: Service = {
+    group: 'configuration',
+    name: 'values',
+    version: JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version,
+    components: components().labels,
+    resources,
+    // the service that holds the values also serves the page that reads them
+    port: UI_PORT,
+    ingress: { path: UI_PATH },
+    variables: [{
+      name: VALUES,
+      value: JSON.stringify(describe(instances, annotation))
     }]
+  }
 
-    const secrets = createSecrets(values)
+  return { services: [service], variables, events: [EVENT] }
+}
 
-    variables[instance.locator.label].push(...secrets)
-  }
+/** What the values service is given: the epoch, the schema and the defaults of every component. */
+export function describe (instances: Instance[], annotation: Annotation = {}): Values {
+  annotation = prepare(split(annotation).values, instances)
+
+  const values: Values = {}
+
+  for (const { locator, manifest } of instances)
+    values[locator.id] = {
+      epoch: epoch(manifest.schema),
+      schema: manifest.schema,
+      defaults: annotation[locator.id] ?? manifest.defaults
+    }
 
-  return { variables }
+  return values
 }
 
 function createSecrets (values: object): Variable[] {
@@ -61,26 +90,45 @@ function createSecrets (values: object): Variable[] {
   return secrets
 }
 
-function validate (annotation: Annotation, instances: Instance[]): void {
+/**
+ * The service's own resources, and the component values that are the rest of the annotation.
+ *
+ * Every key here names a component, so the one option the service has of its own needs a
+ * name that cannot be mistaken for one. `resources` is reserved: a component actually
+ * called that is written with its namespace, `default.resources`, which is what an id is
+ * anyway — the bare form is the shorthand.
+ */
+function split (annotation: Annotation): { resources?: Resources, values: Annotation } {
   validators.annotation.validate(annotation)
 
+  const { resources, ...values } = annotation as Annotation & { resources?: Resources }
+
+  return { resources, values }
+}
+
+/** Validated, keyed by full component ids, and checked against the components that ask. */
+function prepare (annotation: Annotation, instances: Instance[]): Annotation {
+  const normalized: Annotation = {}
   const requested = instances.map((instance) => instance.locator.id)
 
-  for (const id of Object.keys(annotation))
+  for (const [key, values] of Object.entries(annotation)) {
+    const id = key.includes('.') ? key : 'default.' + key
+
     assert.ok(requested.includes(id),
       `Component '${id}' does not request configuration or does not exist.`)
-}
 
-function validateInstance (instace: Instance, values: object = {}): void {
-  const defaults = instace.manifest.defaults ?? {}
-  const configuration = overwrite(defaults, values)
-  const schema: Schema<any> = schemas.schema(instace.manifest.schema)
+    normalized[id] = values
+  }
 
-  schema.validate(configuration)
+  return normalized
 }
 
-export const SECRET_RX = /^\$(?<variable>[A-Z0-9_]{1,32})$/
-export const PREFIX = 'TOA_CONFIGURATION_'
-
 export type Annotation = Record<string, object>
 export type Instance = context.Dependency<Manifest>
+export type Values = Record<string, Entry>
+
+export interface Entry {
+  epoch: string
+  schema: object
+  defaults?: object
+}

package/source/epoch.test.ts

@@ -0,0 +1,29 @@
+import { it } from 'node:test'
+import assert from 'node:assert/strict'
+
+import { epoch } from './epoch.js'
+
+it('should be a sha256 hex', () => {
+  assert.match(epoch({ type: 'object' }), /^[a-f0-9]{64}$/)
+})
+
+it('should not depend on key order', () => {
+  const a = { type: 'object', properties: { foo: { type: 'string', default: 'x' }, bar: { type: 'number' } } }
+  const b = { properties: { bar: { type: 'number' }, foo: { default: 'x', type: 'string' } }, type: 'object' }
+
+  assert.deepStrictEqual(epoch(a), epoch(b))
+})
+
+it('should depend on values', () => {
+  const a = { type: 'object', properties: { foo: { type: 'string' } } }
+  const b = { type: 'object', properties: { foo: { type: 'number' } } }
+
+  assert.notDeepStrictEqual(epoch(a), epoch(b))
+})
+
+it('should keep array order', () => {
+  const a = { enum: [1, 2] }
+  const b = { enum: [2, 1] }
+
+  assert.notDeepStrictEqual(epoch(a), epoch(b))
+})

package/source/epoch.ts

@@ -0,0 +1,21 @@
+import { createHash } from 'node:crypto'
+
+/** The same for the same schema, whatever the key order it was written in. */
+export function epoch (schema: object): string {
+  return createHash('sha256').update(canonical(schema)).digest('hex')
+}
+
+function canonical (value: unknown): string {
+  if (Array.isArray(value))
+    return '[' + value.map(canonical).join(',') + ']'
+
+  if (value !== null && typeof value === 'object') {
+    const object = value as Record<string, unknown>
+    const keys = Object.keys(object).filter((key) => object[key] !== undefined).sort()
+    const entries = keys.map((key) => JSON.stringify(key) + ':' + canonical(object[key]))
+
+    return '{' + entries.join(',') + '}'
+  }
+
+  return JSON.stringify(value) ?? 'null'
+}

package/source/index.ts

@@ -1,3 +1,4 @@
-export { manifest } from './manifest'
-export { deployment } from './deployment'
-export { Factory } from './Factory'
+export { manifest } from './manifest.js'
+export { deployment, describe } from './deployment.js'
+export { components } from './Composition.js'
+export { Factory } from './Factory.js'

package/source/manifest.test.ts

@@ -1,15 +1,18 @@
-import { type Manifest, manifest } from './manifest'
+import { it } from 'node:test'
+import assert from 'node:assert/strict'
+
+import { type Manifest, manifest } from './manifest.js'
 
 it('should validate', async () => {
   const additional = { schema: {}, foo: 'bar' } as unknown as Manifest
 
-  expect(() => {
+  assert.throws(() => {
     manifest(additional)
-  }).toThrow('not expected')
+  }, (error: any) => /not expected/.test(error.message))
 
   const wrongType = { schema: 'not ok' } as unknown as Manifest
 
-  expect(() => {
+  assert.throws(() => {
     manifest(wrongType)
-  }).toThrow('object')
+  }, (error: any) => /object/.test(error.message))
 })

package/source/manifest.ts

@@ -1,9 +1,7 @@
-import * as schemas from './schemas'
-import { type Node } from './configuration'
+import * as schemas from './schemas.js'
+import { type Node } from './configuration.js'
 
 export function manifest (manifest: Manifest): Manifest {
-  if (manifest.schema === undefined) manifest = { schema: manifest }
-
   schemas.manifest.validate(manifest)
 
   return manifest

package/source/schemas.ts

@@ -2,7 +2,7 @@ import { resolve } from 'node:path'
 import * as schemas from '@toa.io/schemas'
 import type { Schema } from '@toa.io/schemas'
 
-const path = resolve(__dirname, '../schemas')
+const path = resolve(import.meta.dirname, '../schemas')
 const namespace = schemas.namespace(path)
 
 export const manifest: Schema<any> = namespace.schema('manifest')

package/transpiled/Aspect.d.ts

@@ -1,7 +1,21 @@
-import { Connector, type extensions } from '@toa.io/core';
+import { Connector, type Locator, type extensions } from '@toa.io/core';
+import type { Client } from './Client.js';
+import type { Manifest } from './manifest.js';
 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 './epoch.js';
+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,33 @@ 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.info('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/Aspect.test.js

@@ -1,15 +1,66 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const Aspect_1 = require("./Aspect");
-it('should return value', async () => {
-    const configuration = {
-        foo: 'bar',
-        bar: {
-            baz: 'quux'
+import { it, beforeEach, afterEach, mock } from 'node:test';
+import assert from 'node:assert/strict';
+import { isDeepStrictEqual } from 'node:util';
+import { Connector, Locator } from '@toa.io/core';
+import { generate } from 'randomstring';
+import { Aspect } from './Aspect.js';
+class Fake extends Connector {
+    fetch = mock.fn(async () => ({ configuration: { foo: 'served' }, created: 5 }));
+    subscribe = mock.fn();
+    unsubscribe = mock.fn();
+}
+const manifest = {
+    schema: {
+        type: 'object',
+        properties: {
+            foo: { type: 'string' },
+            bar: { type: 'object', properties: { baz: { type: 'string' } }, default: { baz: 'quux' } }
         }
-    };
-    const aspect = new Aspect_1.Aspect(configuration);
-    expect(aspect.invoke(['foo'])).toStrictEqual(configuration.foo);
-    expect(aspect.invoke(['bar', 'baz'])).toStrictEqual(configuration.bar.baz);
+    }
+};
+let locator;
+beforeEach(() => {
+    locator = new Locator(generate(), generate());
+});
+afterEach(() => {
+    delete process.env['TOA_CONFIGURATION_' + locator.uppercase];
+});
+it('should be named', async () => {
+    assert.deepStrictEqual(new Aspect(locator, manifest, null).name, 'configuration');
+});
+it('should resolve locally without a client', async () => {
+    process.env['TOA_CONFIGURATION_' + locator.uppercase] = JSON.stringify({ foo: 'local' });
+    const aspect = new Aspect(locator, manifest, null);
+    await aspect.connect();
+    assert.deepStrictEqual(aspect.invoke(), { foo: 'local', bar: { baz: 'quux' } });
+    assert.deepStrictEqual(aspect.invoke(['foo']), 'local');
+    assert.deepStrictEqual(aspect.invoke(['bar', 'baz']), 'quux');
+});
+it('should fetch from the client and follow it', async () => {
+    const client = new Fake();
+    const aspect = new Aspect(locator, manifest, client);
+    await aspect.connect();
+    assert.deepStrictEqual(client.connected, true);
+    assert.strictEqual(client.fetch.mock.callCount(), 1);
+    const [component, epoch] = client.fetch.mock.calls[0].arguments;
+    assert.deepStrictEqual(component, locator.id);
+    assert.match(epoch, /^[a-f0-9]{64}$/);
+    assert.deepStrictEqual(aspect.invoke(), { foo: 'served', bar: { baz: 'quux' } });
+    assert.ok(client.subscribe.mock.calls.some((call) => call.arguments.length === 3 && isDeepStrictEqual(call.arguments[0], component) && isDeepStrictEqual(call.arguments[1], epoch) && typeof call.arguments[2] === 'function'));
+    const listener = client.subscribe.mock.calls[0].arguments[2];
+    listener({ configuration: { foo: 'updated' }, created: 6 });
+    assert.deepStrictEqual(aspect.invoke(['foo']), 'updated');
+    // what is not newer than the held value is left alone
+    listener({ configuration: { foo: 'stale' }, created: 6 });
+    listener({ configuration: { foo: 'older' }, created: 4 });
+    assert.deepStrictEqual(aspect.invoke(['foo']), 'updated');
+    // a value that does not fit keeps the previous one
+    listener({ configuration: { foo: { nested: true } }, created: 7 });
+    assert.deepStrictEqual(aspect.invoke(['foo']), 'updated');
+    // and the one after it still applies
+    listener({ configuration: { foo: 'latest' }, created: 8 });
+    assert.deepStrictEqual(aspect.invoke(['foo']), 'latest');
+    await aspect.disconnect();
+    assert.ok(client.unsubscribe.mock.calls.some((call) => call.arguments.length === 3 && isDeepStrictEqual(call.arguments[0], component) && isDeepStrictEqual(call.arguments[1], epoch) && isDeepStrictEqual(call.arguments[2], listener)));
 });
 //# sourceMappingURL=Aspect.test.js.map

package/transpiled/Aspect.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"Aspect.test.js","sourceRoot":"","sources":["../source/Aspect.test.ts"],"names":[],"mappings":";;AAAA,qCAAiC;AAEjC,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;IACnC,MAAM,aAAa,GAAG;QACpB,GAAG,EAAE,KAAK;QACV,GAAG,EAAE;YACH,GAAG,EAAE,MAAM;SACZ;KACF,CAAA;IAED,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAA;IAExC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;IAC/D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAC5E,CAAC,CAAC,CAAA"}
+{"version":3,"file":"Aspect.test.js","sourceRoot":"","sources":["../source/Aspect.test.ts"],"names":[],"mappings":"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"}

package/transpiled/Client.d.ts

@@ -0,0 +1,61 @@
+import { Connector } from '@toa.io/core';
+import type { Host } from './Factory.js';
+/**
+ * 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. */
+    disposed: boolean;
+    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>;
+    protected dispose(): 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;