@toa.io/extensions.configuration 1.0.0-alpha.273 → 1.0.0-alpha.275

package/CHANGELOG.md

@@ -3,6 +3,226 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.275](https://github.com/toa-io/toa/compare/v1.0.0-alpha.274...v1.0.0-alpha.275) (2026-09-02)
+
+
+### Bug Fixes
+
+* **configuration:** ship the component's code and the built page ([6ffe988](https://github.com/toa-io/toa/commit/6ffe988a9e67025c114e74ba94665b28a2cafaa1))
+* **introspection:** keep a sideways scroll off the browser's back gesture ([419e012](https://github.com/toa-io/toa/commit/419e012ce093bcd0429dc93fe457bbd964cfc11c))
+
+
+### Features
+
+* **ui:** give both consoles a favicon ([27d3881](https://github.com/toa-io/toa/commit/27d3881eda10e59dc4c9c5ef38c2a58b71e1448d))
+* **ui:** leave signing out to its icon ([a82fbab](https://github.com/toa-io/toa/commit/a82fbab513706436254348a5e35115dc3721873f))
+
+
+
+
+
+# [1.0.0-alpha.274](https://github.com/toa-io/toa/compare/v1.0.0-alpha.273...v1.0.0-alpha.274) (2026-09-02)
+
+
+* Configuration is served by a component, followed live, and kept per epoch (#1017) ([b05997d](https://github.com/toa-io/toa/commit/b05997d3adb784f238a222cb46878b23859339a2)), closes [#1017](https://github.com/toa-io/toa/issues/1017)
+
+
+### Features
+
+* **configuration:** drop the label from the epoch ([4baaff5](https://github.com/toa-io/toa/commit/4baaff5b22d00719142a65d56b50a1b100b29fbd))
+
+
+### BREAKING CHANGES
+
+* a secret configuration value is an object, not a string;
+read it with `unwrap()`.
+
+Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
+
+* test(configuration): wait for the second round rather than assume it
+
+Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
+
+* refactor(configuration)!: read a secret with its own unwrap
+
+Component code depends on no Toa package, so a secret is read as
+`context.configuration.apiKey.unwrap()` and the helper in `@toa.io/generic`
+goes. A value a component reads as a secret is therefore given as a reference:
+`identity.basic` no longer defaults `pepper` to `''`, the development context
+and the feature harness give the token keys, the federation client secret and
+the signing key as references, and the harness has a step for the secrets a
+scenario refers to. CONTRIBUTING states the rule.
+* `identity.basic` `pepper` has no default; a value read as a
+secret must be given as a `$NAME` reference.
+
+Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
+
+* feat(configuration): list the configurations
+
+`configuration.values.list` returns every component's configuration for its
+deployed epoch, by component name, and `GET /configuration/values/` serves it
+behind `system:configuration:get`.
+
+Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
+
+* fix(exposition): write a value in YAML the way its toJSON says
+
+A redacted secret in a reply was dumped as an empty object; it is written as
+`<REDACTED>`, as JSON and msgpack already write it.
+
+Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
+
+* test(configuration): a secret is an object, and stays redacted in a reply
+
+A component with `{ a: 1, b: $SECRET_B }` returns its configuration as
+`{ a: 1, b: '<REDACTED>' }` and the secret itself through `unwrap()`. The reply
+step also accepts a reply as a caller across a process boundary receives it,
+since a call within the process hands the object over as it is.
+
+Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
+
+* chore(schemas): bump the dependencies
+
+ajv 8.18.0 to 8.20.0, ajv-formats 2.1.1 to 3.0.1, better-ajv-errors 1.2.0
+to 2.0.3, fast-glob 3.2.12 to 3.3.3 and js-yaml 4.3.1 to 5.4.1 — the version
+exposition already uses. The three majors keep the CommonJS entry points this
+library calls: ajv-formats as a function, better-ajv-errors as .default, and
+js-yaml's load.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(configuration)!: serve the schema with the value
+
+GET /configuration/values/:component/ answers { configuration, schema, epoch }
+where it answered with the configuration alone, and list carries the schema of
+every component. Nothing reads a configuration without needing to know what it
+is checked against, and the schema was only ever on the values service.
+
+An epoch the deployment does not know has no schema; the value stored for it
+is still returned.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(configuration): publish a configuration UI
+
+The values service serves a page at /.configuration on port 8003, out of the
+directory ui builds: the configured components, a screen per component showing
+what it holds now, and a dialog creating the next one. Reading needs
+system:configuration:get and creating needs system:configuration:create.
+
+A configuration is immutable, so the dialog opens on the current value and what
+is left out of it is left out of the component. The editor takes YAML, the
+schema is applied before anything is sent, and a secret is a reference the page
+never shows.
+
+The page is always published: the annotation is the per-component values map
+and has nowhere to carry a switch.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(introspection): link a component to its configuration
+
+A card carrying @toa.io/extensions.configuration reads that extension as a link
+to the configuration UI rather than as a name, and configuration joins the
+namespaces the runtime provides, so its components band under System.
+
+Deployed, both pages sit behind the same ingress and the path alone is right;
+locally each console has its own port.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(introspection): scroll the map, zoom with a modifier
+
+The map was grabbed to move and zoomed with a bare wheel, which is neither what
+a page does nor what the wheel does anywhere else. A plain scroll now pans on
+both axes and the wheel scales only with the modifier held — a trackpad pinch
+arrives as one of those on every platform.
+
+A card's own scrollable box keeps its wheel, in both paths.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* refactor(introspection): centre the filter in the header
+
+The sides take equal space, which is what leaves the filter between them.
+Neither side may shrink under what it holds, or the tabs run out from under
+their side and across the filter, and the filter across the sign-out button;
+the title gives way instead.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* fix(configuration): connect the UI to the values service
+
+The page was declared as a dependency from inside `open`, and a connector connects
+what it depends on before `open` runs — so the server was constructed and never
+listened. Nothing caught it: the UI feature builds the server itself.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(configuration)!: reserve resources in the annotation
+
+The values service deploys like any other and must state what it may take, but the
+annotation is a map of component ids and had nowhere to put it — so `toa env` failed
+for every context using configuration unless it declared a context-wide `resources`.
+
+`resources` is now the service's own, read the way `introspection` and `realtime` read
+theirs. A component actually named `resources` is written `default.resources`, which is
+what its id is anyway.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(configuration): follow the system colour scheme
+
+The dark tokens were behind a `.dark` class nothing sets, and the `dark:` variant was
+pointed at that class too — so a component's own dark styling never applied either.
+Both now key off `prefers-color-scheme`, and `color-scheme` hands the native chrome
+the same answer.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(introspection): follow the system colour scheme
+
+The dark tokens were behind a `.dark` class nothing sets, and the `dark:` variant was
+pointed at that class too — so a component's own dark styling never applied either.
+Both now key off `prefers-color-scheme`, and `color-scheme` hands the native chrome
+the same answer.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(configuration): present a change as an edit of what is there
+
+A configuration is immutable and creating one replaces the whole of it, but the dialog
+opens on the current value and the page never shows an older one — so what the reader
+does is edit. The words follow: Edit rather than New, Update rather than Create, and
+the paragraph explaining the model goes, along with the field's label, which the title
+above it already said.
+
+The editor also stayed as wide as its longest line — `field-sizing: content` sizes to
+content, and no `max-width` clamps that — so a long value painted outside the dialog.
+It is fixed now, the dialog takes the width the screen has rather than a fixed step,
+and the band held for errors no longer leaves a gap when there are none.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(configuration): mark a component that keeps a secret
+
+A key after the name on the row, wherever the configuration holds a reference, however
+deep. The predicate reads the same lines the value screen renders, so the two cannot
+disagree about what counts as a secret.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+* feat(configuration): lead back to the list from the title
+
+Every address ends in a slash, so the way up is the address itself on the list and one
+level above it on a component's screen — which holds wherever the page is mounted.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
+
+
+
+
 # [1.0.0-alpha.273](https://github.com/toa-io/toa/compare/v1.0.0-alpha.272...v1.0.0-alpha.273) (2026-09-02)
 
 **Note:** Version bump only for package @toa.io/extensions.configuration

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

@@ -0,0 +1,158 @@
+namespace: configuration
+name: values
+
+# One document per configuration created. Documents are immutable: a change is a new
+# document, and the latest one for a component and an epoch is the last created.
+# What every component's epoch, schema and defaults are, the service is told on
+# deployment (`TOA_CONFIGURATION_VALUES`). A created object is published as the
+# prototype's `created` event.
+
+entity:
+  schema:
+    type: object
+    properties:
+      component:
+        type: string
+      epoch:
+        type: string
+      configuration:
+        type: object
+      originator:
+        type: string
+    required:
+      - component
+      - epoch
+      - configuration
+      - originator
+  index:
+    lookup:
+      component: asc
+      epoch: asc
+      _created: desc
+
+operations:
+  # the latest configuration of a component: created, else deployed defaults, else none
+  get:
+    query: false
+    input:
+      type: object
+      properties:
+        component:
+          type: string
+        epoch:
+          type: string
+      required:
+        - component
+    # the value and the schema it is checked against, so a caller can show and check it
+    output:
+      type: object
+      nullable: true
+      properties:
+        configuration:
+          type: object
+        schema:
+          type: object
+        epoch:
+          type: string
+      required:
+        - configuration
+        - epoch
+  # the same for many at once, as the aspects of one process ask
+  fetch:
+    query: false
+    input:
+      type: array
+      items:
+        type: object
+        properties:
+          component:
+            type: string
+          epoch:
+            type: string
+        required:
+          - component
+          - epoch
+    output:
+      type: array
+      items:
+        type: object
+        properties:
+          component:
+            type: string
+          epoch:
+            type: string
+          configuration:
+            type: object
+            nullable: true
+          created:
+            type: integer
+        required:
+          - component
+          - epoch
+          - configuration
+          - created
+  # every component's configuration for its deployed epoch, by component name
+  list:
+    query: false
+    output:
+      type: array
+      items:
+        type: object
+        properties:
+          component:
+            type: string
+          epoch:
+            type: string
+          schema:
+            type: object
+          configuration:
+            type: object
+        required:
+          - component
+          - epoch
+          - schema
+          - configuration
+  create:
+    query: false
+    input:
+      type: object
+      properties:
+        component:
+          type: string
+        configuration:
+          type: object
+        originator:
+          type: object
+          properties:
+            id:
+              type: string
+          required:
+            - id
+      required:
+        - component
+        - configuration
+        - originator
+    errors:
+      - UNKNOWN_COMPONENT
+      - INVALID_CONFIGURATION
+
+exposition:
+  isolated: true
+  /:
+    GET:
+      io:output: true
+      auth:role: system:configuration:get
+      endpoint: list
+  /:component:
+    map:segments:
+      component: component
+    GET:
+      io:output: true
+      auth:role: system:configuration:get
+      endpoint: get
+    POST:
+      io:output: [id, epoch]
+      auth:rule:
+        role: system:configuration:create
+        delegate: originator
+      endpoint: create

package/components/configuration.values/operations/create.d.ts

@@ -0,0 +1,16 @@
+export declare function transition(input: Input, object: Entity): Promise<Entity | Error>;
+interface Input {
+    component: string;
+    configuration: object;
+    originator: {
+        id: string;
+    };
+}
+interface Entity {
+    id: string;
+    component: string;
+    epoch: string;
+    configuration: object;
+    originator: string;
+}
+export {};

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

@@ -0,0 +1,58 @@
+"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.transition = void 0;
+const schemas = __importStar(require("@toa.io/schemas"));
+const map_1 = require("./lib/map");
+async function transition(input, object) {
+    const known = (0, map_1.entry)(input.component);
+    if (known === undefined)
+        return new UnknownComponentError(input.component);
+    // the schema fills its defaults, so what is stored is whole
+    const configuration = structuredClone(input.configuration);
+    const schema = schemas.schema(known.schema);
+    try {
+        schema.validate(configuration);
+    }
+    catch (error) {
+        return new InvalidConfigurationError(error.message);
+    }
+    object.component = input.component;
+    object.epoch = known.epoch;
+    object.configuration = configuration;
+    object.originator = input.originator.id;
+    return object;
+}
+exports.transition = transition;
+class UnknownComponentError extends Error {
+    code = 'UNKNOWN_COMPONENT';
+    constructor(component) {
+        super(`Component '${component}' is not configured`);
+    }
+}
+class InvalidConfigurationError extends Error {
+    code = 'INVALID_CONFIGURATION';
+}
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../source/create.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yDAA0C;AAC1C,mCAAiC;AAG1B,KAAK,UAAU,UAAU,CAAE,KAAY,EAAE,MAAc;IAC5D,MAAM,KAAK,GAAG,IAAA,WAAK,EAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAEpC,IAAI,KAAK,KAAK,SAAS;QACrB,OAAO,IAAI,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAEnD,4DAA4D;IAC5D,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IAE1D,MAAM,MAAM,GAAgB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAExD,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,yBAAyB,CAAE,KAAe,CAAC,OAAO,CAAC,CAAA;IAChE,CAAC;IAED,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;IAClC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IAC1B,MAAM,CAAC,aAAa,GAAG,aAAa,CAAA;IACpC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,EAAE,CAAA;IAEvC,OAAO,MAAM,CAAA;AACf,CAAC;AAvBD,gCAuBC;AAED,MAAM,qBAAsB,SAAQ,KAAK;IACvB,IAAI,GAAG,mBAAmB,CAAA;IAE1C,YAAoB,SAAiB;QACnC,KAAK,CAAC,cAAc,SAAS,qBAAqB,CAAC,CAAA;IACrD,CAAC;CACF;AAED,MAAM,yBAA0B,SAAQ,KAAK;IAC3B,IAAI,GAAG,uBAAuB,CAAA;CAC/C"}

package/components/configuration.values/operations/fetch.d.ts

@@ -0,0 +1,11 @@
+import { type Context } from './lib/resolve';
+export declare function computation(input: Pair[], context: Context): Promise<Fetched[]>;
+interface Pair {
+    component: string;
+    epoch: string;
+}
+interface Fetched extends Pair {
+    configuration: object | null;
+    created: number;
+}
+export {};

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computation = void 0;
+const resolve_1 = require("./lib/resolve");
+async function computation(input, context) {
+    return await Promise.all(input.map(async ({ component, epoch }) => {
+        const value = await (0, resolve_1.resolve)(context, component, epoch);
+        return {
+            component,
+            epoch,
+            configuration: value === null ? null : value.configuration,
+            created: value === null ? 0 : value.created
+        };
+    }));
+}
+exports.computation = computation;
+//# sourceMappingURL=fetch.js.map

package/components/configuration.values/operations/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../source/fetch.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AAE9C,KAAK,UAAU,WAAW,CAAE,KAAa,EAAE,OAAgB;IAChE,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;QAChE,MAAM,KAAK,GAAG,MAAM,IAAA,iBAAO,EAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;QAEtD,OAAO;YACL,SAAS;YACT,KAAK;YACL,aAAa,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa;YAC1D,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;SAC5C,CAAA;IACH,CAAC,CAAC,CAAC,CAAA;AACL,CAAC;AAXD,kCAWC"}

package/components/configuration.values/operations/get.d.ts

@@ -0,0 +1,17 @@
+import { type Context } from './lib/resolve';
+/**
+ * The latest configuration of a component, with the schema it is checked against. The
+ * schema is the deployment's, so an epoch the deployment does not know has none — the
+ * value is still what was stored for it.
+ */
+export declare function computation(input: Input, context: Context): Promise<Item | null>;
+interface Input {
+    component: string;
+    epoch?: string;
+}
+interface Item {
+    configuration: object;
+    schema?: object;
+    epoch: string;
+}
+export {};

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computation = void 0;
+const map_1 = require("./lib/map");
+const resolve_1 = require("./lib/resolve");
+/**
+ * The latest configuration of a component, with the schema it is checked against. The
+ * schema is the deployment's, so an epoch the deployment does not know has none — the
+ * value is still what was stored for it.
+ */
+async function computation(input, context) {
+    const value = await (0, resolve_1.resolve)(context, input.component, input.epoch);
+    if (value === null)
+        return null;
+    const known = (0, map_1.entry)(input.component);
+    return {
+        configuration: value.configuration,
+        schema: known?.schema,
+        epoch: input.epoch ?? known.epoch
+    };
+}
+exports.computation = computation;
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../source/get.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AACjC,2CAAqD;AAErD;;;;GAIG;AACI,KAAK,UAAU,WAAW,CAAE,KAAY,EAAE,OAAgB;IAC/D,MAAM,KAAK,GAAG,MAAM,IAAA,iBAAO,EAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAElE,IAAI,KAAK,KAAK,IAAI;QAChB,OAAO,IAAI,CAAA;IAEb,MAAM,KAAK,GAAG,IAAA,WAAK,EAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAEpC,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM;QACrB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAM,CAAC,KAAK;KACnC,CAAA;AACH,CAAC;AAbD,kCAaC"}

package/components/configuration.values/operations/lib/map.d.ts

@@ -0,0 +1,11 @@
+/** What the deployment told the service about every configured component. */
+export declare function entry(component: string): Entry | undefined;
+/** The configured components, by name. */
+export declare function components(): string[];
+export declare const VARIABLE = "TOA_CONFIGURATION_VALUES";
+export interface Entry {
+    epoch: string;
+    schema: object;
+    defaults?: object;
+}
+export type Values = Record<string, Entry>;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VARIABLE = exports.components = exports.entry = void 0;
+/** What the deployment told the service about every configured component. */
+function entry(component) {
+    return read()[component];
+}
+exports.entry = entry;
+/** The configured components, by name. */
+function components() {
+    return Object.keys(read()).sort();
+}
+exports.components = components;
+function read() {
+    const source = process.env[exports.VARIABLE] ?? '{}';
+    // read again once the variable changes, as it does between scenarios of one process
+    if (source !== parsed) {
+        values = JSON.parse(source);
+        parsed = source;
+    }
+    return values;
+}
+let parsed = null;
+let values = {};
+exports.VARIABLE = 'TOA_CONFIGURATION_VALUES';
+//# sourceMappingURL=map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../source/lib/map.ts"],"names":[],"mappings":";;;AAAA,6EAA6E;AAC7E,SAAgB,KAAK,CAAE,SAAiB;IACtC,OAAO,IAAI,EAAE,CAAC,SAAS,CAAC,CAAA;AAC1B,CAAC;AAFD,sBAEC;AAED,0CAA0C;AAC1C,SAAgB,UAAU;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AACnC,CAAC;AAFD,gCAEC;AAED,SAAS,IAAI;IACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAQ,CAAC,IAAI,IAAI,CAAA;IAE5C,oFAAoF;IACpF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAW,CAAA;QACrC,MAAM,GAAG,MAAM,CAAA;IACjB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,IAAI,MAAM,GAAkB,IAAI,CAAA;AAChC,IAAI,MAAM,GAAW,EAAE,CAAA;AAEV,QAAA,QAAQ,GAAG,0BAA0B,CAAA"}

package/components/configuration.values/operations/lib/map.test.d.ts

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

package/components/configuration.values/operations/lib/map.test.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const map_1 = require("./map");
+afterEach(() => {
+    delete process.env[map_1.VARIABLE];
+});
+it('should be empty without the variable', () => {
+    expect((0, map_1.entry)('a.b')).toBeUndefined();
+});
+it('should read the variable', () => {
+    const values = { 'a.b': { epoch: 'e', schema: { type: 'object' }, defaults: { foo: 1 } } };
+    process.env[map_1.VARIABLE] = JSON.stringify(values);
+    expect((0, map_1.entry)('a.b')).toStrictEqual(values['a.b']);
+    expect((0, map_1.entry)('a.c')).toBeUndefined();
+});
+it('should follow the variable', () => {
+    process.env[map_1.VARIABLE] = JSON.stringify({ 'a.b': { epoch: 'e1', schema: {} } });
+    expect((0, map_1.entry)('a.b')?.epoch).toStrictEqual('e1');
+    process.env[map_1.VARIABLE] = JSON.stringify({ 'a.b': { epoch: 'e2', schema: {} } });
+    expect((0, map_1.entry)('a.b')?.epoch).toStrictEqual('e2');
+});
+it('should list the components by name', () => {
+    process.env[map_1.VARIABLE] = JSON.stringify({ 'b.two': { epoch: 'e', schema: {} }, 'a.one': { epoch: 'e', schema: {} } });
+    expect((0, map_1.components)()).toStrictEqual(['a.one', 'b.two']);
+});
+//# sourceMappingURL=map.test.js.map

package/components/configuration.values/operations/lib/map.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.test.js","sourceRoot":"","sources":["../../source/lib/map.test.ts"],"names":[],"mappings":";;AAAA,+BAAmD;AAEnD,SAAS,CAAC,GAAG,EAAE;IACb,OAAO,OAAO,CAAC,GAAG,CAAC,cAAQ,CAAC,CAAA;AAC9B,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAC9C,MAAM,CAAC,IAAA,WAAK,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;AACtC,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;IAClC,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAA;IAE1F,OAAO,CAAC,GAAG,CAAC,cAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAE9C,MAAM,CAAC,IAAA,WAAK,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACjD,MAAM,CAAC,IAAA,WAAK,EAAC,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;AACtC,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACpC,OAAO,CAAC,GAAG,CAAC,cAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IAE9E,MAAM,CAAC,IAAA,WAAK,EAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAE/C,OAAO,CAAC,GAAG,CAAC,cAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IAE9E,MAAM,CAAC,IAAA,WAAK,EAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;AACjD,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAC5C,OAAO,CAAC,GAAG,CAAC,cAAQ,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IAEpH,MAAM,CAAC,IAAA,gBAAU,GAAE,CAAC,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AACxD,CAAC,CAAC,CAAA"}

package/components/configuration.values/operations/lib/resolve.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The latest configuration created for the component and the epoch; the deployed
+ * defaults when none was; `null` when the epoch is not the one deployed.
+ */
+export declare function resolve(context: Context, component: string, epoch?: string): Promise<Value | null>;
+/** A configuration and when it was created; `0` for the deployed defaults. */
+export interface Value {
+    configuration: object;
+    created: number;
+}
+export interface Context {
+    local: {
+        enumerate: (request: {
+            query: Query;
+        }) => Promise<Stored[]>;
+    };
+}
+interface Query {
+    criteria: string;
+    sort: string[];
+    limit: number;
+}
+interface Stored {
+    configuration: object;
+    _created: number;
+}
+export {};