@toa.io/extensions.configuration 1.0.0-alpha.272 → 1.0.0-alpha.274

package/source/epoch.test.ts

@@ -0,0 +1,26 @@
+import { epoch } from './epoch'
+
+it('should be a sha256 hex', () => {
+  expect(epoch({ type: 'object' })).toMatch(/^[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' }
+
+  expect(epoch(a)).toStrictEqual(epoch(b))
+})
+
+it('should depend on values', () => {
+  const a = { type: 'object', properties: { foo: { type: 'string' } } }
+  const b = { type: 'object', properties: { foo: { type: 'number' } } }
+
+  expect(epoch(a)).not.toStrictEqual(epoch(b))
+})
+
+it('should keep array order', () => {
+  const a = { enum: [1, 2] }
+  const b = { enum: [2, 1] }
+
+  expect(epoch(a)).not.toStrictEqual(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 { deployment, describe } from './deployment'
+export { components } from './Composition'
 export { Factory } from './Factory'

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';
+import type { Manifest } from './manifest';
 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,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Aspect = void 0;
+const openspan_1 = require("openspan");
 const core_1 = require("@toa.io/core");
+const configuration_1 = require("./configuration");
+const epoch_1 = require("./epoch");
 class Aspect extends core_1.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 = (0, epoch_1.epoch)(manifest.schema);
+        if (client !== null)
+            this.depends(client);
     }
     invoke(path) {
         let cursor = this.value;
@@ -16,6 +33,33 @@ class Aspect extends core_1.Connector {
                 cursor = cursor[segment];
         return cursor;
     }
+    async open() {
+        if (this.client === null) {
+            this.value = (0, configuration_1.local)(this.locator, this.manifest);
+            return;
+        }
+        const { configuration, created } = await this.client.fetch(this.locator.id, this.epoch);
+        this.value = (0, configuration_1.fit)(configuration, this.manifest);
+        this.created = created;
+        this.client.subscribe(this.locator.id, this.epoch, this.listener);
+    }
+    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 = (0, configuration_1.fit)(configuration, this.manifest);
+            this.created = created;
+            openspan_1.console.info('Configuration updated', { component: this.locator.id, created });
+        }
+        catch (error) {
+            // the service validated it against the schema of its epoch, so the two schemas differ
+            openspan_1.console.error('Configuration value does not match the schema', { component: this.locator.id, 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":";;;AAAA,uCAAkC;AAClC,uCAAuE;AACvE,mDAAuD;AACvD,mCAA+B;AAI/B,MAAa,MAAO,SAAQ,gBAAS;IACnB,IAAI,GAAG,eAAe,CAAA;IAErB,OAAO,CAAS;IAChB,QAAQ,CAAU;IAClB,MAAM,CAAe;IACrB,KAAK,CAAQ;IACtB,KAAK,GAAS,EAAE,CAAA;IAChB,OAAO,GAAG,CAAC,CAAA;IAEnB;;;OAGG;IACH,YAAoB,OAAgB,EAAE,QAAkB,EAAE,MAAqB;QAC7E,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,KAAK,GAAG,IAAA,aAAK,EAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QAEnC,IAAI,MAAM,KAAK,IAAI;YACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,CAAC;IAEM,MAAM,CAAE,IAAe;QAC5B,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;IAEkB,KAAK,CAAC,IAAI;QAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAA,qBAAK,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;YAE/C,OAAM;QACR,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAEvF,IAAI,CAAC,KAAK,GAAG,IAAA,mBAAG,EAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IACnE,CAAC;IAEkB,KAAK,CAAC,KAAK;QAC5B,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtE,CAAC;IAEgB,QAAQ,GAAG,CAAC,EAAE,aAAa,EAAE,OAAO,EAAS,EAAQ,EAAE;QACtE,qFAAqF;QACrF,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO;YACzB,OAAM;QAER,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,GAAG,IAAA,mBAAG,EAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;YAEtB,kBAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sFAAsF;YACtF,kBAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QACvG,CAAC;IACH,CAAC,CAAA;CACF;AArED,wBAqEC"}

package/transpiled/Aspect.test.js

@@ -1,15 +1,65 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@toa.io/core");
+const randomstring_1 = require("randomstring");
 const Aspect_1 = require("./Aspect");
-it('should return value', async () => {
-    const configuration = {
-        foo: 'bar',
-        bar: {
-            baz: 'quux'
+class Fake extends core_1.Connector {
+    fetch = jest.fn(async () => ({ configuration: { foo: 'served' }, created: 5 }));
+    subscribe = jest.fn();
+    unsubscribe = jest.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 core_1.Locator((0, randomstring_1.generate)(), (0, randomstring_1.generate)());
+});
+afterEach(() => {
+    delete process.env['TOA_CONFIGURATION_' + locator.uppercase];
+});
+it('should be named', async () => {
+    expect(new Aspect_1.Aspect(locator, manifest, null).name).toStrictEqual('configuration');
+});
+it('should resolve locally without a client', async () => {
+    process.env['TOA_CONFIGURATION_' + locator.uppercase] = JSON.stringify({ foo: 'local' });
+    const aspect = new Aspect_1.Aspect(locator, manifest, null);
+    await aspect.connect();
+    expect(aspect.invoke()).toStrictEqual({ foo: 'local', bar: { baz: 'quux' } });
+    expect(aspect.invoke(['foo'])).toStrictEqual('local');
+    expect(aspect.invoke(['bar', 'baz'])).toStrictEqual('quux');
+});
+it('should fetch from the client and follow it', async () => {
+    const client = new Fake();
+    const aspect = new Aspect_1.Aspect(locator, manifest, client);
+    await aspect.connect();
+    expect(client.connected).toStrictEqual(true);
+    expect(client.fetch).toHaveBeenCalledTimes(1);
+    const [component, epoch] = client.fetch.mock.calls[0];
+    expect(component).toStrictEqual(locator.id);
+    expect(epoch).toMatch(/^[a-f0-9]{64}$/);
+    expect(aspect.invoke()).toStrictEqual({ foo: 'served', bar: { baz: 'quux' } });
+    expect(client.subscribe).toHaveBeenCalledWith(component, epoch, expect.any(Function));
+    const listener = client.subscribe.mock.calls[0][2];
+    listener({ configuration: { foo: 'updated' }, created: 6 });
+    expect(aspect.invoke(['foo'])).toStrictEqual('updated');
+    // what is not newer than the held value is left alone
+    listener({ configuration: { foo: 'stale' }, created: 6 });
+    listener({ configuration: { foo: 'older' }, created: 4 });
+    expect(aspect.invoke(['foo'])).toStrictEqual('updated');
+    // a value that does not fit keeps the previous one
+    listener({ configuration: { foo: { nested: true } }, created: 7 });
+    expect(aspect.invoke(['foo'])).toStrictEqual('updated');
+    // and the one after it still applies
+    listener({ configuration: { foo: 'latest' }, created: 8 });
+    expect(aspect.invoke(['foo'])).toStrictEqual('latest');
+    await aspect.disconnect();
+    expect(client.unsubscribe).toHaveBeenCalledWith(component, epoch, 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 { Bootloader } from './Factory';
+/**
+ * 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 boot;
+    private readonly options;
+    private readonly pending;
+    private readonly listeners;
+    private remote;
+    private timer;
+    private flushing;
+    private fresh;
+    private round;
+    constructor(boot: Bootloader, 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;

package/transpiled/Client.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = void 0;
+const openspan_1 = require("openspan");
+const core_1 = require("@toa.io/core");
+const const_1 = require("./const");
+/**
+ * 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.
+ */
+class Client extends core_1.Connector {
+    /** Disconnected once, a connector keeps what it depended on, so a gone client is not reused. */
+    disposed = false;
+    boot;
+    options;
+    pending = new Map();
+    listeners = new Map();
+    remote = null;
+    timer = null;
+    flushing = false;
+    fresh = false;
+    round = 0;
+    constructor(boot, options = {}) {
+        super();
+        this.boot = boot;
+        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.boot.remote(LOCATOR, const_1.SOURCE);
+        this.depends(this.remote);
+        await this.remote.connect();
+        const subscription = new Subscription(this.deliver.bind(this));
+        const consumer = await this.boot.receive(const_1.EVENT, subscription);
+        this.depends(consumer);
+        await consumer.connect();
+    }
+    async close() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    async dispose() {
+        this.disposed = true;
+    }
+    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) {
+            openspan_1.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)
+            openspan_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);
+    }
+}
+exports.Client = Client;
+/** What the event consumer hands deliveries to. */
+class Subscription extends core_1.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 core_1.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/Client.test.d.ts

@@ -0,0 +1 @@
+export {};

package/transpiled/Client.test.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@toa.io/core");
+const generic_1 = require("@toa.io/generic");
+const Client_1 = require("./Client");
+const const_1 = require("./const");
+class Remote extends core_1.Connector {
+    invoke = jest.fn(async (_endpoint, request) => request.input.map((pair) => ({
+        ...pair,
+        configuration: this.values[pair.component] ?? null,
+        created: this.values[pair.component] === undefined ? 0 : 7
+    })));
+    values = {};
+}
+let remote;
+let receiver;
+let boot;
+let client;
+beforeEach(() => {
+    remote = new Remote();
+    receiver = null;
+    boot = {
+        remote: jest.fn(async (locator) => {
+            expect(locator.id).toStrictEqual('configuration.values');
+            return remote;
+        }),
+        receive: jest.fn(async (label, consumer) => {
+            expect(label).toStrictEqual(const_1.EVENT);
+            receiver = consumer;
+            return new core_1.Connector();
+        })
+    };
+    client = new Client_1.Client(boot, { base: 10, max: 20, warn: 2 });
+});
+afterEach(async () => {
+    await client.disconnect();
+});
+it('should send the requests of one tick as one call', async () => {
+    remote.values = { 'a.one': { foo: 1 }, 'a.two': { foo: 2 } };
+    await client.connect();
+    const [one, two] = await Promise.all([client.fetch('a.one', 'e1'), client.fetch('a.two', 'e2')]);
+    expect(one).toStrictEqual({ configuration: { foo: 1 }, created: 7 });
+    expect(two).toStrictEqual({ configuration: { foo: 2 }, created: 7 });
+    expect(remote.invoke).toHaveBeenCalledTimes(1);
+    expect(remote.invoke.mock.calls[0][1]).toStrictEqual({
+        input: [{ component: 'a.one', epoch: 'e1' }, { component: 'a.two', epoch: 'e2' }]
+    });
+});
+it('should keep asking until served', async () => {
+    await client.connect();
+    const fetching = client.fetch('a.one', 'e1');
+    const deadline = Date.now() + 1000;
+    while (remote.invoke.mock.calls.length < 2 && Date.now() < deadline)
+        await (0, generic_1.timeout)(5);
+    expect(remote.invoke.mock.calls.length).toBeGreaterThanOrEqual(2);
+    remote.values = { 'a.one': { foo: 1 } };
+    expect((await fetching).configuration).toStrictEqual({ foo: 1 });
+});
+it('should hand a created object to its subscribers', async () => {
+    await client.connect();
+    const listener = jest.fn();
+    const other = jest.fn();
+    client.subscribe('a.one', 'e1', listener);
+    client.subscribe('a.one', 'e0', other);
+    await receiver.receive({
+        payload: { component: 'a.one', epoch: 'e1', configuration: { foo: 2 }, _created: 12 }
+    });
+    expect(listener).toHaveBeenCalledWith({ configuration: { foo: 2 }, created: 12 });
+    expect(other).not.toHaveBeenCalled();
+    expect(remote.invoke).not.toHaveBeenCalled();
+    client.unsubscribe('a.one', 'e1', listener);
+    await receiver.receive({
+        payload: { component: 'a.one', epoch: 'e1', configuration: { foo: 3 }, _created: 13 }
+    });
+    expect(listener).toHaveBeenCalledTimes(1);
+});
+//# sourceMappingURL=Client.test.js.map

package/transpiled/Client.test.js.map

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

package/transpiled/Composition.d.ts

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

package/transpiled/Composition.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.components = exports.Composition = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const core_1 = require("@toa.io/core");
+const const_1 = require("./const");
+const UI_1 = require("./UI");
+/** Hosts the values component in the service process. */
+class Composition extends core_1.Connector {
+    boot;
+    constructor(boot) {
+        super();
+        this.boot = boot;
+    }
+    async open() {
+        const composition = await this.boot.composition(components().paths);
+        await composition.connect();
+        this.depends(composition);
+        // connected here rather than declared as a dependency: dependencies are connected
+        // before `open` runs, so one added from inside it would never be
+        const ui = new UI_1.UI(const_1.UI_PORT);
+        await ui.connect();
+        this.depends(ui);
+    }
+}
+exports.Composition = Composition;
+function components() {
+    const labels = [];
+    const paths = [];
+    for (const entry of entries()) {
+        labels.push(entry.name.replace('.', '-'));
+        paths.push((0, node_path_1.resolve)(ROOT, entry.name));
+    }
+    return { labels, paths };
+}
+exports.components = components;
+function entries() {
+    const entries = (0, node_fs_1.readdirSync)(ROOT, { withFileTypes: true });
+    return entries.filter((entry) => entry.isDirectory());
+}
+const ROOT = (0, node_path_1.resolve)(__dirname, '../components/');
+//# sourceMappingURL=Composition.js.map

package/transpiled/Composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Composition.js","sourceRoot":"","sources":["../source/Composition.ts"],"names":[],"mappings":";;;AAAA,qCAAkD;AAClD,yCAAmC;AACnC,uCAAwC;AACxC,mCAAiC;AACjC,6BAAyB;AAGzB,yDAAyD;AACzD,MAAa,WAAY,SAAQ,gBAAS;IACvB,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAA;QAEnE,MAAM,WAAW,CAAC,OAAO,EAAE,CAAA;QAE3B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAEzB,kFAAkF;QAClF,iEAAiE;QACjE,MAAM,EAAE,GAAG,IAAI,OAAE,CAAC,eAAO,CAAC,CAAA;QAE1B,MAAM,EAAE,CAAC,OAAO,EAAE,CAAA;QAElB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAClB,CAAC;CACF;AAvBD,kCAuBC;AAED,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QACzC,KAAK,CAAC,IAAI,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC1B,CAAC;AAVD,gCAUC;AAED,SAAS,OAAO;IACd,MAAM,OAAO,GAAG,IAAA,qBAAW,EAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAE1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;AACvD,CAAC;AAOD,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA"}