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

package/transpiled/UI.js

@@ -0,0 +1,172 @@
+import * as fs from 'node:fs';
+import * as http from 'node:http';
+import * as path from 'node:path';
+import { Connector } from '@toa.io/core';
+import { console } from 'openspan';
+import { UI_PATH } from './const.js';
+/**
+ * Serves the configuration UI: the directory `ui` builds, and nothing else.
+ *
+ * The page is a single-page application whose mount path is baked into the bundle,
+ * so this server routes relative to `UI_PATH` — which is also what the ingress
+ * forwards. `/configuration/*` is left alone: that is the component's own API.
+ */
+export class UI extends Connector {
+    server = http.createServer();
+    port;
+    root;
+    constructor(port, root = SITE) {
+        super();
+        this.port = port;
+        this.root = root;
+        this.server.on('request', (request, response) => {
+            this.listen(request, response);
+        });
+    }
+    async open() {
+        /*
+         * A taken port is a real error: uniqueness across services is settled at export
+         * time, so nothing here has to negotiate for one.
+         */
+        await new Promise((resolve, reject) => {
+            const failed = (error) => {
+                this.server.off('listening', listening);
+                reject(error);
+            };
+            const listening = () => {
+                this.server.off('error', failed);
+                resolve();
+            };
+            this.server.once('error', failed);
+            this.server.once('listening', listening);
+            this.server.listen(this.port);
+        });
+        if (!isFile(path.join(this.root, 'index.html')))
+            console.warn('Configuration UI is not built', { root: this.root });
+        console.info('Configuration UI started', { port: this.port, path: UI_PATH + '/' });
+    }
+    async close() {
+        const closed = new Promise((resolve) => this.server.once('close', () => {
+            resolve();
+        }));
+        this.server.close();
+        this.server.closeAllConnections();
+        await closed;
+    }
+    listen(request, response) {
+        void this.respond(request, response).catch((error) => {
+            console.error('Configuration UI failure', { message: error.message });
+            if (!response.writableEnded)
+                response.writeHead(500).end();
+        });
+    }
+    async respond(request, response) {
+        if (request.method !== 'GET' && request.method !== 'HEAD') {
+            response.writeHead(405, { allow: 'GET, HEAD' }).end();
+            return;
+        }
+        const pathname = decode(request.url ?? '/');
+        if (pathname === null) {
+            response.writeHead(400).end();
+            return;
+        }
+        // the port is the explorer's alone, so the root is the way in
+        if (pathname === '/') {
+            response.writeHead(302, { location: UI_PATH + '/' }).end();
+            return;
+        }
+        const file = this.resolve(pathname);
+        if (file === null)
+            response.writeHead(404).end();
+        else
+            await this.send(file, request, response);
+    }
+    /**
+     * The file a request lands on, or `null` when nothing does. A path that exists is
+     * served as it is; anything else that could be a route falls back to the page,
+     * because the client router — not this server — knows what routes there are.
+     */
+    resolve(pathname) {
+        if (!pathname.startsWith(UI_PATH))
+            return null;
+        const relative = pathname.slice(UI_PATH.length);
+        if (relative !== '' && !relative.startsWith('/'))
+            return null;
+        const file = path.join(this.root, relative);
+        if (file !== this.root && !file.startsWith(this.root + path.sep))
+            return null;
+        if (isFile(file))
+            return file;
+        /*
+         * A missing asset is missing, but a route can look like one: `identity.passkeys` is a
+         * component, not a file with an extension. What this server would have served is what
+         * it knows how to serve, so anything else is a route and falls back to the page — as
+         * does anything ending in a slash, which is no name for a file at all.
+         */
+        const asset = !relative.endsWith('/') && path.extname(relative) in TYPES;
+        return asset ? null : path.join(this.root, 'index.html');
+    }
+    async send(file, request, response) {
+        const stats = await fs.promises.stat(file).catch(() => null);
+        if (stats === null) {
+            response.writeHead(503, { 'content-type': 'text/plain' })
+                .end('The configuration UI is not built. Run `npm run build:ui`.\n');
+            return;
+        }
+        response.writeHead(200, {
+            'content-type': TYPES[path.extname(file)] ?? 'application/octet-stream',
+            'content-length': stats.size,
+            'cache-control': caching(path.relative(this.root, file))
+        });
+        if (request.method === 'HEAD')
+            response.end();
+        else
+            fs.createReadStream(file).pipe(response);
+    }
+}
+function decode(url) {
+    try {
+        return decodeURIComponent(url.split('?')[0]);
+    }
+    catch {
+        return null;
+    }
+}
+function isFile(file) {
+    return fs.existsSync(file) && fs.statSync(file).isFile();
+}
+/** Where `npm run build:ui` puts the page, from both `source` and `transpiled`. */
+const SITE = path.resolve(import.meta.dirname, '..', 'ui', 'dist');
+/** Assets under this prefix carry their build hash in the name. */
+const IMMUTABLE = path.join('_app', 'immutable');
+const FOREVER = 'public, max-age=31536000, immutable';
+/** The icons: named without a hash, so they are re-read, but rarely. */
+const ICONS = new Set(['favicon.ico', 'favicon-96x96.png', 'apple-touch-icon.png']);
+const DAY = 'public, max-age=86400';
+/**
+ * How long what is served may be held. The page is never cached — it names the assets,
+ * and their names carry the build. An icon is named for what it is rather than for its
+ * content, so it is asked about again, but not on every page load.
+ */
+function caching(relative) {
+    if (relative.startsWith(IMMUTABLE))
+        return FOREVER;
+    return ICONS.has(relative) ? DAY : 'no-cache';
+}
+const TYPES = {
+    '.css': 'text/css; charset=utf-8',
+    '.html': 'text/html; charset=utf-8',
+    '.ico': 'image/x-icon',
+    '.jpg': 'image/jpeg',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+    '.txt': 'text/plain; charset=utf-8',
+    '.webmanifest': 'application/manifest+json',
+    '.webp': 'image/webp',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2'
+};
+//# sourceMappingURL=UI.js.map

package/transpiled/UI.js.map

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

package/transpiled/configuration.d.ts

@@ -1,4 +1,9 @@
 import { type Locator } from '@toa.io/core';
-import { type Manifest } from './manifest';
-export declare function get(locator: Locator, manifest: Manifest): Node;
+import type { Manifest } from './manifest.js';
+/** The variable is set, so the values service is not consulted. */
+export declare function overridden(locator: Locator): boolean;
+/** The variable, the manifest defaults, then the schema. */
+export declare function local(locator: Locator, manifest: Manifest): Node;
+/** A copy of the value with the schema applied and the secrets substituted. */
+export declare function fit(raw: object, manifest: Manifest): Node;
 export type Node = Record<string, unknown>;

package/transpiled/configuration.js

@@ -1,49 +1,38 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.get = void 0;
-const generic_1 = require("@toa.io/generic");
-const schemas = __importStar(require("@toa.io/schemas"));
-const deployment_1 = require("./deployment");
-function get(locator, manifest) {
-    const values = getConfiguration(locator.uppercase);
-    substituteSecrets(values);
+import { add } from '@toa.io/generic';
+import * as schemas from '@toa.io/schemas';
+import { PREFIX, SECRET_RX } from './const.js';
+import { Secret } from './Secret.js';
+/** The variable is set, so the values service is not consulted. */
+export function overridden(locator) {
+    return process.env[PREFIX + locator.uppercase] !== undefined;
+}
+/** The variable, the manifest defaults, then the schema. */
+export function local(locator, manifest) {
+    const values = read(locator.uppercase);
     if (manifest.defaults !== undefined)
-        (0, generic_1.add)(values, manifest.defaults);
+        add(values, manifest.defaults);
+    return fit(values, manifest);
+}
+/** A copy of the value with the schema applied and the secrets substituted. */
+export function fit(raw, manifest) {
+    // a copy of the caller's, and one of this realm: what came over the wire is JSON anyway
+    const values = JSON.parse(JSON.stringify(raw));
+    // the schema sees the references, which are the strings it declares
+    validate(values, manifest);
+    substituteSecrets(values);
+    return values;
+}
+function validate(values, manifest) {
     const schema = schemas.schema(manifest.schema);
     schema.validate(values);
-    return values;
 }
-exports.get = get;
-function getConfiguration(suffix) {
-    const variable = deployment_1.PREFIX + suffix;
+function read(suffix) {
+    const variable = PREFIX + suffix;
     const string = process.env[variable];
     if (string === undefined)
         return {};
     else
-        return (0, generic_1.decode)(string);
+        return JSON.parse(string);
 }
 function substituteSecrets(configuration) {
     for (const [key, value] of Object.entries(configuration)) {
@@ -51,15 +40,15 @@ function substituteSecrets(configuration) {
             substituteSecrets(value);
         if (typeof value !== 'string')
             continue;
-        const match = value.match(deployment_1.SECRET_RX);
+        const match = value.match(SECRET_RX);
         if (match === null)
             continue;
         const name = match.groups?.variable;
-        configuration[key] = getSecret(name);
+        configuration[key] = new Secret(getSecret(name));
     }
 }
 function getSecret(name) {
-    const variable = deployment_1.PREFIX + '_' + name;
+    const variable = PREFIX + '_' + name;
     const value = process.env[variable];
     if (value === undefined)
         throw new Error(`${variable} is not set.`);

package/transpiled/configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../source/configuration.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,6CAA6C;AAC7C,yDAA0C;AAC1C,6CAAgD;AAIhD,SAAgB,GAAG,CAAE,OAAgB,EAAE,QAAkB;IACvD,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAElD,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAEzB,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS;QACjC,IAAA,aAAG,EAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEhC,MAAM,MAAM,GAAgB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE3D,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAEvB,OAAO,MAAM,CAAA;AACf,CAAC;AAbD,kBAaC;AAED,SAAS,gBAAgB,CAAE,MAAc;IACvC,MAAM,QAAQ,GAAG,mBAAM,GAAG,MAAM,CAAA;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEpC,IAAI,MAAM,KAAK,SAAS;QACtB,OAAO,EAAE,CAAA;;QAET,OAAO,IAAA,gBAAM,EAAC,MAAM,CAAC,CAAA;AACzB,CAAC;AAED,SAAS,iBAAiB,CAAE,aAAmB;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAC7C,iBAAiB,CAAC,KAAa,CAAC,CAAA;QAElC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAQ;QAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,sBAAS,CAAC,CAAA;QAEpC,IAAI,KAAK,KAAK,IAAI;YAAE,SAAQ;QAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAA;QAEnC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAK,CAAC,CAAA;IACvC,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAE,IAAY;IAC9B,MAAM,QAAQ,GAAG,mBAAM,GAAG,GAAG,GAAG,IAAI,CAAA;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEnC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,cAAc,CAAC,CAAA;IAEnE,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../source/configuration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIpC,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAE,OAAgB;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS,CAAA;AAC9D,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,KAAK,CAAE,OAAgB,EAAE,QAAkB;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAEtC,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS;QACjC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEhC,OAAO,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAC9B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,GAAG,CAAE,GAAW,EAAE,QAAkB;IAClD,wFAAwF;IACxF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAS,CAAA;IAEtD,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAEzB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,QAAQ,CAAE,MAAY,EAAE,QAAkB;IACjD,MAAM,MAAM,GAAgB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE3D,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AACzB,CAAC;AAED,SAAS,IAAI,CAAE,MAAc;IAC3B,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEpC,IAAI,MAAM,KAAK,SAAS;QACtB,OAAO,EAAE,CAAA;;QAET,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC;AAED,SAAS,iBAAiB,CAAE,aAAmB;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAC7C,iBAAiB,CAAC,KAAa,CAAC,CAAA;QAElC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAQ;QAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAEpC,IAAI,KAAK,KAAK,IAAI;YAAE,SAAQ;QAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAA;QAEnC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,IAAK,CAAC,CAAC,CAAA;IACnD,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAE,IAAY;IAC9B,MAAM,QAAQ,GAAG,MAAM,GAAG,GAAG,GAAG,IAAI,CAAA;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEnC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,cAAc,CAAC,CAAA;IAEnE,OAAO,KAAK,CAAA;AACd,CAAC"}

package/transpiled/configuration.test.js

@@ -1,61 +1,108 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const generic_1 = require("@toa.io/generic");
-const core_1 = require("@toa.io/core");
-const randomstring_1 = require("randomstring");
-const configuration_1 = require("./configuration");
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { Locator } from '@toa.io/core';
+import { generate } from 'randomstring';
+import { fit, local, overridden } from './configuration.js';
+import { Secret } from './Secret.js';
 let locator;
 let manifest;
 beforeEach(() => {
-    locator = new core_1.Locator((0, randomstring_1.generate)(), (0, randomstring_1.generate)());
-    manifest = { schema: { foo: 'string' } };
+    locator = new Locator(generate(), generate());
+    manifest = {
+        schema: {
+            type: 'object',
+            properties: { foo: { type: 'string' } }
+        }
+    };
 });
 afterEach(() => {
     for (const name of used)
         delete process.env[name];
     used = [];
 });
-it('should read value', async () => {
-    manifest.schema = { foo: 'string' };
-    const value = { foo: (0, randomstring_1.generate)() };
-    set(value);
-    const result = (0, configuration_1.get)(locator, manifest);
-    expect(result).toStrictEqual(value);
-});
-it('should return empty object if no value set', async () => {
-    expect((0, configuration_1.get)(locator, manifest)).toStrictEqual({});
-});
-it('should substitute secrets', async () => {
-    const value = { foo: '$BAR' };
-    set(value);
-    set('bar', '_BAR');
-    const result = (0, configuration_1.get)(locator, manifest);
-    expect(result).toStrictEqual({ foo: 'bar' });
+describe('overridden', () => {
+    it('should be false without the variable', async () => {
+        assert.deepStrictEqual(overridden(locator), false);
+    });
+    it('should be true with the variable', async () => {
+        set({});
+        assert.deepStrictEqual(overridden(locator), true);
+    });
 });
-it('should use defaults', async () => {
-    manifest.schema = { foo: 'string', bar: ['number'], 'baz?': 'string' };
-    manifest.defaults = { foo: 'bar', bar: [1] };
-    const values = { bar: [2], baz: 'foo' };
-    set(values);
-    const result = (0, configuration_1.get)(locator, manifest);
-    expect(result).toStrictEqual({
-        foo: 'bar',
-        bar: [2],
-        baz: 'foo'
+describe('local', () => {
+    it('should read value', async () => {
+        const value = { foo: generate() };
+        set(value);
+        assert.deepStrictEqual(local(locator, manifest), value);
+    });
+    it('should return empty object if no value set', async () => {
+        assert.deepStrictEqual(local(locator, manifest), {});
+    });
+    it('should substitute secrets', async () => {
+        set({ foo: '$BAR' });
+        set('bar', '_BAR');
+        const { foo } = local(locator, manifest);
+        assert.ok(foo instanceof Secret);
+        assert.deepStrictEqual(foo.unwrap(), 'bar');
+        assert.deepStrictEqual(String(foo), '<REDACTED>');
+    });
+    it('should substitute secrets in defaults', async () => {
+        manifest.defaults = { foo: '$BAR' };
+        set('bar', '_BAR');
+        assert.deepStrictEqual(local(locator, manifest).foo.unwrap(), 'bar');
+    });
+    it('should use defaults', async () => {
+        manifest.schema = {
+            type: 'object',
+            properties: {
+                foo: { type: 'string' },
+                bar: { type: 'array', items: { type: 'number' } },
+                baz: { type: 'string' }
+            },
+            required: ['foo', 'bar']
+        };
+        manifest.defaults = { foo: 'bar', bar: [1] };
+        set({ bar: [2], baz: 'foo' });
+        assert.deepStrictEqual(local(locator, manifest), { foo: 'bar', bar: [2], baz: 'foo' });
+    });
+    it('should validate', async () => {
+        manifest.schema = {
+            type: 'object',
+            properties: {
+                foo: { type: 'string', default: 'hello' },
+                bar: { type: 'number' }
+            }
+        };
+        set({ bar: 5 });
+        assert.deepStrictEqual(local(locator, manifest), { foo: 'hello', bar: 5 });
     });
 });
-it('should validate', async () => {
-    manifest.schema = { foo: 'hello', bar: 'number' };
-    const values = { bar: 5 };
-    set(values);
-    const result = (0, configuration_1.get)(locator, manifest);
-    expect(result).toStrictEqual({
-        foo: 'hello',
-        bar: 5
+describe('fit', () => {
+    it('should substitute secrets and apply the schema', async () => {
+        manifest.schema = {
+            type: 'object',
+            properties: {
+                foo: { type: 'string' },
+                bar: { type: 'number', default: 1 }
+            }
+        };
+        set('secret', '_FOO');
+        const raw = { foo: '$FOO' };
+        const values = fit(raw, manifest);
+        assert.deepStrictEqual(values.foo.unwrap(), 'secret');
+        assert.deepStrictEqual(values.bar, 1);
+        assert.deepStrictEqual(raw, { foo: '$FOO' }); // untouched
+    });
+    it('should not apply the manifest defaults', async () => {
+        manifest.defaults = { foo: 'hello' };
+        assert.deepStrictEqual(fit({}, manifest), {});
+    });
+    it('should throw on a value not fitting the schema', async () => {
+        assert.throws(() => fit({ foo: { nested: true } }, manifest));
     });
 });
 function set(value, key = locator.uppercase) {
-    const string = typeof value === 'string' ? value : (0, generic_1.encode)(value);
+    const string = typeof value === 'string' ? value : JSON.stringify(value);
     const name = 'TOA_CONFIGURATION_' + key;
     process.env[name] = string;
     used.push(name);

package/transpiled/configuration.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.test.js","sourceRoot":"","sources":["../source/configuration.test.ts"],"names":[],"mappings":";;AAAA,6CAAwC;AACxC,uCAAsC;AACtC,+CAAuC;AACvC,mDAAqC;AAGrC,IAAI,OAAgB,CAAA;AACpB,IAAI,QAAkB,CAAA;AAEtB,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,GAAG,IAAI,cAAO,CAAC,IAAA,uBAAQ,GAAE,EAAE,IAAA,uBAAQ,GAAE,CAAC,CAAA;IAC7C,QAAQ,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAA;AAC1C,CAAC,CAAC,CAAA;AAEF,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,MAAM,IAAI,IAAI,IAAI;QACrB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAE1B,IAAI,GAAG,EAAE,CAAA;AACX,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;IACjC,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAA;IAEnC,MAAM,KAAK,GAAW,EAAE,GAAG,EAAE,IAAA,uBAAQ,GAAE,EAAE,CAAA;IAEzC,GAAG,CAAC,KAAK,CAAC,CAAA;IAEV,MAAM,MAAM,GAAG,IAAA,mBAAG,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAErC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACrC,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;IAC1D,MAAM,CAAC,IAAA,mBAAG,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;AAClD,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;IACzC,MAAM,KAAK,GAAW,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;IAErC,GAAG,CAAC,KAAK,CAAC,CAAA;IACV,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAElB,MAAM,MAAM,GAAG,IAAA,mBAAG,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAErC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;AAC9C,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;IACnC,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;IACtE,QAAQ,CAAC,QAAQ,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAE5C,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;IAEvC,GAAG,CAAC,MAAM,CAAC,CAAA;IAEX,MAAM,MAAM,GAAG,IAAA,mBAAG,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAErC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;QAC3B,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,CAAC,CAAC,CAAC;QACR,GAAG,EAAE,KAAK;KACX,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;IAC/B,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAA;IAEjD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAA;IAEzB,GAAG,CAAC,MAAM,CAAC,CAAA;IAEX,MAAM,MAAM,GAAG,IAAA,mBAAG,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAErC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;QAC3B,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,CAAC;KACP,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,SAAS,GAAG,CAAE,KAAsB,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS;IAC3D,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,gBAAM,EAAC,KAAK,CAAC,CAAA;IAChE,MAAM,IAAI,GAAG,oBAAoB,GAAG,GAAG,CAAA;IAEvC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAA;IAE1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACjB,CAAC;AAED,IAAI,IAAI,GAAa,EAAE,CAAA"}
+{"version":3,"file":"configuration.test.js","sourceRoot":"","sources":["../source/configuration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC/D,OAAO,MAAM,MAAM,oBAAoB,CAAA;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,IAAI,OAAgB,CAAA;AACpB,IAAI,QAAkB,CAAA;AAEtB,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC7C,QAAQ,GAAG;QACT,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;SACxC;KACF,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,MAAM,IAAI,IAAI,IAAI;QACrB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAE1B,IAAI,GAAG,EAAE,CAAA;AACX,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,GAAG,CAAC,EAAE,CAAC,CAAA;QAEP,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACjC,MAAM,KAAK,GAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAA;QAEzC,GAAG,CAAC,KAAK,CAAC,CAAA;QAEV,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;QACpB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAElB,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAExC,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY,MAAM,CAAC,CAAA;QAChC,MAAM,CAAC,eAAe,CAAE,GAAc,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAA;QACvD,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,QAAQ,CAAC,QAAQ,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;QAEnC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAElB,MAAM,CAAC,eAAe,CAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,GAAc,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAA;IAClF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;QACnC,QAAQ,CAAC,MAAM,GAAG;YAChB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBACjD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACxB;YACD,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;SACzB,CAAA;QACD,QAAQ,CAAC,QAAQ,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAE5C,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;QAE7B,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;IACxF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;QAC/B,QAAQ,CAAC,MAAM,GAAG;YAChB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;gBACzC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACxB;SACF,CAAA;QAED,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAEf,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;IACnB,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,QAAQ,CAAC,MAAM,GAAG;YAChB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;aACpC;SACF,CAAA;QAED,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAErB,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAEjC,MAAM,CAAC,eAAe,CAAE,MAAM,CAAC,GAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAA;QACjE,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA,CAAC,YAAY;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,QAAQ,CAAC,QAAQ,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAA;QAEpC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,SAAS,GAAG,CAAE,KAAsB,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS;IAC3D,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACxE,MAAM,IAAI,GAAG,oBAAoB,GAAG,GAAG,CAAA;IAEvC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAA;IAE1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACjB,CAAC;AAED,IAAI,IAAI,GAAa,EAAE,CAAA"}

package/transpiled/const.d.ts

@@ -0,0 +1,11 @@
+import type { Source } from '@toa.io/core';
+/** Per-component variables: the local override and the secrets. */
+export declare const PREFIX = "TOA_CONFIGURATION_";
+/** The map of every configured component, on the values service. */
+export declare const VALUES = "TOA_CONFIGURATION_VALUES";
+export declare const SECRET_RX: RegExp;
+/** Where the UI is mounted; `/configuration/*` belongs to the component's own API. */
+export declare const UI_PATH = "/.configuration";
+export declare const UI_PORT = 8003;
+export declare const EVENT = "configuration.values.created";
+export declare const SOURCE: Source;

package/transpiled/const.js

@@ -0,0 +1,11 @@
+/** Per-component variables: the local override and the secrets. */
+export const PREFIX = 'TOA_CONFIGURATION_';
+/** The map of every configured component, on the values service. */
+export const VALUES = 'TOA_CONFIGURATION_VALUES';
+export const SECRET_RX = /^\$(?<variable>[A-Z0-9_]{1,32})$/;
+/** Where the UI is mounted; `/configuration/*` belongs to the component's own API. */
+export const UI_PATH = '/.configuration';
+export const UI_PORT = 8003;
+export const EVENT = 'configuration.values.created';
+export const SOURCE = { service: 'configuration' };
+//# sourceMappingURL=const.js.map

package/transpiled/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../source/const.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,CAAC,MAAM,MAAM,GAAG,oBAAoB,CAAA;AAE1C,oEAAoE;AACpE,MAAM,CAAC,MAAM,MAAM,GAAG,0BAA0B,CAAA;AAEhD,MAAM,CAAC,MAAM,SAAS,GAAG,kCAAkC,CAAA;AAE3D,sFAAsF;AACtF,MAAM,CAAC,MAAM,OAAO,GAAG,iBAAiB,CAAA;AACxC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAA;AAE3B,MAAM,CAAC,MAAM,KAAK,GAAG,8BAA8B,CAAA;AAEnD,MAAM,CAAC,MAAM,MAAM,GAAW,EAAE,OAAO,EAAE,eAAe,EAAE,CAAA"}

package/transpiled/deployment.d.ts

@@ -1,8 +1,14 @@
 import { type Dependency } from '@toa.io/operations';
-import { type Manifest } from './manifest';
+import type { Manifest } from './manifest.js';
 import type { context } from '@toa.io/norm';
 export declare function deployment(instances: Instance[], annotation?: Annotation): Dependency;
-export declare const SECRET_RX: RegExp;
-export declare const PREFIX = "TOA_CONFIGURATION_";
+/** What the values service is given: the epoch, the schema and the defaults of every component. */
+export declare function describe(instances: Instance[], annotation?: Annotation): Values;
 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;
+}