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

package/transpiled/const.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOURCE = exports.EVENT = exports.UI_PORT = exports.UI_PATH = exports.SECRET_RX = exports.VALUES = exports.PREFIX = void 0;
+/** Per-component variables: the local override and the secrets. */
+exports.PREFIX = 'TOA_CONFIGURATION_';
+/** The map of every configured component, on the values service. */
+exports.VALUES = 'TOA_CONFIGURATION_VALUES';
+exports.SECRET_RX = /^\$(?<variable>[A-Z0-9_]{1,32})$/;
+/** Where the UI is mounted; `/configuration/*` belongs to the component's own API. */
+exports.UI_PATH = '/.configuration';
+exports.UI_PORT = 8003;
+exports.EVENT = 'configuration.values.created';
+exports.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;AACtD,QAAA,MAAM,GAAG,oBAAoB,CAAA;AAE1C,oEAAoE;AACvD,QAAA,MAAM,GAAG,0BAA0B,CAAA;AAEnC,QAAA,SAAS,GAAG,kCAAkC,CAAA;AAE3D,sFAAsF;AACzE,QAAA,OAAO,GAAG,iBAAiB,CAAA;AAC3B,QAAA,OAAO,GAAG,IAAI,CAAA;AAEd,QAAA,KAAK,GAAG,8BAA8B,CAAA;AAEtC,QAAA,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';
 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_";
-export type Annotation = Record<string, object>;
+/** 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, any>;
 export type Instance = context.Dependency<Manifest>;
+export type Values = Record<string, Entry>;
+export interface Entry {
+    epoch: string;
+    schema: object;
+    defaults?: object;
+}

package/transpiled/deployment.js

@@ -26,27 +26,54 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PREFIX = exports.SECRET_RX = exports.deployment = void 0;
+exports.describe = exports.deployment = void 0;
 const node_assert_1 = __importDefault(require("node:assert"));
-const generic_1 = require("@toa.io/generic");
+const Composition_1 = require("./Composition");
+const const_1 = require("./const");
+const epoch_1 = require("./epoch");
 const validators = __importStar(require("./schemas"));
 function deployment(instances, annotation = {}) {
-    validate(annotation, instances);
+    const { resources, values } = split(annotation);
+    annotation = prepare(values, instances);
     const variables = {};
     for (const instance of instances) {
         const values = annotation[instance.locator.id];
         if (values === undefined)
             continue;
-        variables[instance.locator.label] = [{
-                name: exports.PREFIX + instance.locator.uppercase,
-                value: (0, generic_1.encode)(values)
-            }];
         const secrets = createSecrets(values);
-        variables[instance.locator.label].push(...secrets);
+        if (secrets.length > 0)
+            variables[instance.locator.label] = secrets;
     }
-    return { variables };
+    const service = {
+        group: 'configuration',
+        name: 'values',
+        version: require('../package.json').version,
+        components: (0, Composition_1.components)().labels,
+        resources,
+        // the service that holds the values also serves the page that reads them
+        port: const_1.UI_PORT,
+        ingress: { path: const_1.UI_PATH },
+        variables: [{
+                name: const_1.VALUES,
+                value: JSON.stringify(describe(instances, annotation))
+            }]
+    };
+    return { services: [service], variables, events: [const_1.EVENT] };
 }
 exports.deployment = deployment;
+/** What the values service is given: the epoch, the schema and the defaults of every component. */
+function describe(instances, annotation = {}) {
+    annotation = prepare(split(annotation).values, instances);
+    const values = {};
+    for (const { locator, manifest } of instances)
+        values[locator.id] = {
+            epoch: (0, epoch_1.epoch)(manifest.schema),
+            schema: manifest.schema,
+            defaults: annotation[locator.id] ?? manifest.defaults
+        };
+    return values;
+}
+exports.describe = describe;
 function createSecrets(values) {
     const secrets = [];
     for (const value of Object.values(values)) {
@@ -54,13 +81,13 @@ function createSecrets(values) {
             secrets.push(...createSecrets(value));
         if (typeof value !== 'string')
             continue;
-        const match = value.match(exports.SECRET_RX);
+        const match = value.match(const_1.SECRET_RX);
         if (match === null)
             continue;
         const name = match.groups?.variable;
         node_assert_1.default.ok(name !== undefined);
         secrets.push({
-            name: exports.PREFIX + '_' + name,
+            name: const_1.PREFIX + '_' + name,
             secret: {
                 name: 'toa-configuration',
                 key: name
@@ -69,19 +96,28 @@ function createSecrets(values) {
     }
     return secrets;
 }
-function validate(annotation, instances) {
+/**
+ * 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) {
     validators.annotation.validate(annotation);
+    const { resources, ...values } = annotation;
+    return { resources, values };
+}
+/** Validated, keyed by full component ids, and checked against the components that ask. */
+function prepare(annotation, instances) {
+    const normalized = {};
     const requested = instances.map((instance) => instance.locator.id);
-    for (let id of Object.keys(annotation)) {
-        if (!id.includes('.')) {
-            const newid = 'default.' + id;
-            annotation[newid] = annotation[id];
-            delete annotation[id];
-            id = newid;
-        }
+    for (const [key, values] of Object.entries(annotation)) {
+        const id = key.includes('.') ? key : 'default.' + key;
         node_assert_1.default.ok(requested.includes(id), `Component '${id}' does not request configuration or does not exist.`);
+        normalized[id] = values;
     }
+    return normalized;
 }
-exports.SECRET_RX = /^\$(?<variable>[A-Z0-9_]{1,32})$/;
-exports.PREFIX = 'TOA_CONFIGURATION_';
 //# sourceMappingURL=deployment.js.map

package/transpiled/deployment.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../source/deployment.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8DAAgC;AAEhC,6CAAwC;AAExC,sDAAuC;AAGvC,SAAgB,UAAU,CAAE,SAAqB,EAAE,aAAyB,EAAE;IAC5E,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IAE/B,MAAM,SAAS,GAAc,EAAE,CAAA;IAE/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAE9C,IAAI,MAAM,KAAK,SAAS;YACtB,SAAQ;QAEV,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;gBACnC,IAAI,EAAE,cAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS;gBACzC,KAAK,EAAE,IAAA,gBAAM,EAAC,MAAM,CAAC;aACtB,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;QAErC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;IACpD,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAA;AACtB,CAAC;AAtBD,gCAsBC;AAED,SAAS,aAAa,CAAE,MAAc;IACpC,MAAM,OAAO,GAAe,EAAE,CAAA;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAe,CAAC,CAAC,CAAA;QAEjD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAQ;QAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAS,CAAC,CAAA;QAEpC,IAAI,KAAK,KAAK,IAAI;YAAE,SAAQ;QAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAA;QAEnC,qBAAM,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAA;QAE7B,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,cAAM,GAAG,GAAG,GAAG,IAAI;YACzB,MAAM,EAAE;gBACN,IAAI,EAAE,mBAAmB;gBACzB,GAAG,EAAE,IAAI;aACV;SACF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,QAAQ,CAAE,UAAsB,EAAE,SAAqB;IAC9D,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IAE1C,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAElE,KAAK,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,UAAU,GAAG,EAAE,CAAA;YAE7B,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;YAClC,OAAO,UAAU,CAAC,EAAE,CAAC,CAAA;YACrB,EAAE,GAAG,KAAK,CAAA;QACZ,CAAC;QAED,qBAAM,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAC9B,cAAc,EAAE,qDAAqD,CAAC,CAAA;IAC1E,CAAC;AACH,CAAC;AAEY,QAAA,SAAS,GAAG,kCAAkC,CAAA;AAC9C,QAAA,MAAM,GAAG,oBAAoB,CAAA"}
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../source/deployment.ts"],"names":[],"mappings":"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"}

package/transpiled/deployment.test.js

@@ -1,8 +1,68 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@toa.io/core");
 const deployment_1 = require("./deployment");
+const epoch_1 = require("./epoch");
+const const_1 = require("./const");
+const schema = {
+    type: 'object',
+    properties: { foo: { type: 'string' }, key: { type: 'string' } }
+};
+function instance(name, defaults) {
+    return {
+        locator: new core_1.Locator(name, 'configuration'),
+        manifest: { schema, defaults },
+        component: {}
+    };
+}
 it('should validate annotation', async () => {
     const wrongType = 'not ok';
     expect(() => (0, deployment_1.deployment)([], wrongType)).toThrow('object');
 });
+it('should reject unknown components', async () => {
+    expect(() => (0, deployment_1.deployment)([instance('base')], { 'configuration.nope': {} }))
+        .toThrow("Component 'configuration.nope' does not request configuration");
+});
+it('should deploy the values service with the map', async () => {
+    const instances = [instance('base', { foo: 'hello' }), instance('other')];
+    const annotation = { 'configuration.other': { foo: 'set' } };
+    const dependency = (0, deployment_1.deployment)(instances, annotation);
+    expect(dependency.events).toStrictEqual([const_1.EVENT]);
+    expect(dependency.services).toHaveLength(1);
+    const service = dependency.services[0];
+    expect(service.group).toStrictEqual('configuration');
+    expect(service.name).toStrictEqual('values');
+    expect(service.components).toStrictEqual(['configuration-values']);
+    const variable = service.variables.find((variable) => variable.name === const_1.VALUES);
+    expect(variable).toBeDefined();
+    expect(JSON.parse(variable.value)).toStrictEqual((0, deployment_1.describe)(instances, annotation));
+});
+it('should describe every component', async () => {
+    const instances = [instance('base', { foo: 'hello' }), instance('other')];
+    const values = (0, deployment_1.describe)(instances, { 'configuration.other': { foo: 'set' } });
+    expect(values).toStrictEqual({
+        'configuration.base': { epoch: (0, epoch_1.epoch)(schema), schema, defaults: { foo: 'hello' } },
+        'configuration.other': { epoch: (0, epoch_1.epoch)(schema), schema, defaults: { foo: 'set' } }
+    });
+});
+it('should prefer the context over the manifest defaults', async () => {
+    const values = (0, deployment_1.describe)([instance('base', { foo: 'hello' })], { 'configuration.base': { foo: 'bye' } });
+    expect(values['configuration.base'].defaults).toStrictEqual({ foo: 'bye' });
+});
+it('should not map values to the component', async () => {
+    const dependency = (0, deployment_1.deployment)([instance('base')], { 'configuration.base': { foo: 'set' } });
+    expect(dependency.variables).toStrictEqual({});
+});
+it('should map secrets to the component', async () => {
+    const dependency = (0, deployment_1.deployment)([instance('base')], { 'configuration.base': { key: '$KEY' } });
+    expect(dependency.variables).toStrictEqual({
+        'configuration-base': [{
+                name: 'TOA_CONFIGURATION__KEY',
+                secret: { name: 'toa-configuration', key: 'KEY' }
+            }]
+    });
+    // the service holds the reference, not the secret
+    expect((0, deployment_1.describe)([instance('base')], { 'configuration.base': { key: '$KEY' } })['configuration.base'].defaults)
+        .toStrictEqual({ key: '$KEY' });
+});
 //# sourceMappingURL=deployment.test.js.map

package/transpiled/deployment.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployment.test.js","sourceRoot":"","sources":["../source/deployment.test.ts"],"names":[],"mappings":";;AAAA,6CAA0D;AAE1D,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;IAC1C,MAAM,SAAS,GAAG,QAAiC,CAAA;IAEnD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,uBAAU,EAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AAC3D,CAAC,CAAC,CAAA"}
+{"version":3,"file":"deployment.test.js","sourceRoot":"","sources":["../source/deployment.test.ts"],"names":[],"mappings":"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"}

package/transpiled/epoch.d.ts

@@ -0,0 +1,2 @@
+/** The same for the same schema, whatever the key order it was written in. */
+export declare function epoch(schema: object): string;

package/transpiled/epoch.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.epoch = void 0;
+const node_crypto_1 = require("node:crypto");
+/** The same for the same schema, whatever the key order it was written in. */
+function epoch(schema) {
+    return (0, node_crypto_1.createHash)('sha256').update(canonical(schema)).digest('hex');
+}
+exports.epoch = epoch;
+function canonical(value) {
+    if (Array.isArray(value))
+        return '[' + value.map(canonical).join(',') + ']';
+    if (value !== null && typeof value === 'object') {
+        const object = value;
+        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';
+}
+//# sourceMappingURL=epoch.js.map

package/transpiled/epoch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epoch.js","sourceRoot":"","sources":["../source/epoch.ts"],"names":[],"mappings":";;;AAAA,6CAAwC;AAExC,8EAA8E;AAC9E,SAAgB,KAAK,CAAE,MAAc;IACnC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACrE,CAAC;AAFD,sBAEC;AAED,SAAS,SAAS,CAAE,KAAc;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACtB,OAAO,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;IAEnD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,EAAE,CAAA;QAClF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAErF,OAAO,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;IACtC,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAA;AACxC,CAAC"}

package/transpiled/epoch.test.d.ts

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

package/transpiled/epoch.test.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const epoch_1 = require("./epoch");
+it('should be a sha256 hex', () => {
+    expect((0, epoch_1.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((0, epoch_1.epoch)(a)).toStrictEqual((0, epoch_1.epoch)(b));
+});
+it('should depend on values', () => {
+    const a = { type: 'object', properties: { foo: { type: 'string' } } };
+    const b = { type: 'object', properties: { foo: { type: 'number' } } };
+    expect((0, epoch_1.epoch)(a)).not.toStrictEqual((0, epoch_1.epoch)(b));
+});
+it('should keep array order', () => {
+    const a = { enum: [1, 2] };
+    const b = { enum: [2, 1] };
+    expect((0, epoch_1.epoch)(a)).not.toStrictEqual((0, epoch_1.epoch)(b));
+});
+//# sourceMappingURL=epoch.test.js.map

package/transpiled/epoch.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epoch.test.js","sourceRoot":"","sources":["../source/epoch.test.ts"],"names":[],"mappings":";;AAAA,mCAA+B;AAE/B,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;IAChC,MAAM,CAAC,IAAA,aAAK,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAC7D,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;IACxC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAC5G,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;IAE5G,MAAM,CAAC,IAAA,aAAK,EAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAA,aAAK,EAAC,CAAC,CAAC,CAAC,CAAA;AAC1C,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACjC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IACrE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAErE,MAAM,CAAC,IAAA,aAAK,EAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,IAAA,aAAK,EAAC,CAAC,CAAC,CAAC,CAAA;AAC9C,CAAC,CAAC,CAAA;AAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACjC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;IAC1B,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;IAE1B,MAAM,CAAC,IAAA,aAAK,EAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,IAAA,aAAK,EAAC,CAAC,CAAC,CAAC,CAAA;AAC9C,CAAC,CAAC,CAAA"}

package/transpiled/index.d.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/index.js

@@ -1,10 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Factory = exports.deployment = exports.manifest = void 0;
+exports.Factory = exports.components = exports.describe = exports.deployment = exports.manifest = void 0;
 var manifest_1 = require("./manifest");
 Object.defineProperty(exports, "manifest", { enumerable: true, get: function () { return manifest_1.manifest; } });
 var deployment_1 = require("./deployment");
 Object.defineProperty(exports, "deployment", { enumerable: true, get: function () { return deployment_1.deployment; } });
+Object.defineProperty(exports, "describe", { enumerable: true, get: function () { return deployment_1.describe; } });
+var Composition_1 = require("./Composition");
+Object.defineProperty(exports, "components", { enumerable: true, get: function () { return Composition_1.components; } });
 var Factory_1 = require("./Factory");
 Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return Factory_1.Factory; } });
 //# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;AAAA,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,2CAAyC;AAAhC,wGAAA,UAAU,OAAA;AACnB,qCAAmC;AAA1B,kGAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;AAAA,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,2CAAmD;AAA1C,wGAAA,UAAU,OAAA;AAAE,sGAAA,QAAQ,OAAA;AAC7B,6CAA0C;AAAjC,yGAAA,UAAU,OAAA;AACnB,qCAAmC;AAA1B,kGAAA,OAAO,OAAA"}