@toa.io/definitions 1.0.0-alpha.288

package/transpiled/extensions.state/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../source/extensions.state/context.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAA;AACvD,CAAC"}

package/transpiled/extensions.state/index.d.ts

@@ -0,0 +1 @@
+export { context } from './context.js';

package/transpiled/extensions.state/index.js

@@ -0,0 +1,2 @@
+export { context } from './context.js';
+//# sourceMappingURL=index.js.map

package/transpiled/extensions.state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/transpiled/extensions.storages/Annotation.d.ts

@@ -0,0 +1,8 @@
+import type { Provider } from './secrets.js';
+export type Annotation = Record<string, Declaration>;
+/** What a storage is declared as; what else it takes is the provider's, stated in its schema. */
+export type Declaration = {
+    provider: Provider;
+} & Record<string, any>;
+export type { Provider };
+export declare function validateAnnotation(annotation: unknown): asserts annotation is Annotation;

package/transpiled/extensions.storages/Annotation.js

@@ -0,0 +1,31 @@
+import assert from 'node:assert';
+import { secrets } from './secrets.js';
+import * as schemas from './schemas.js';
+export function validateAnnotation(annotation) {
+    try {
+        schemas.annotation.validate(annotation);
+    }
+    catch (error) {
+        explain(annotation);
+        // if all declarations are valid, re-throw the error
+        throw error;
+    }
+}
+/*
+It is required because `oneOf` schema is used for the annotation validation.
+ */
+function explain(annotation) {
+    assert.ok(typeof annotation === 'object' && annotation !== null, 'TOA_STORAGES is not an object');
+    for (const declaration of Object.values(annotation)) {
+        assert.ok(typeof declaration === 'object' &&
+            declaration !== null &&
+            declaration.provider in secrets, `Unknown provider '${declaration.provider}'`);
+        assert.ok(declaration.provider in schemas, `No schema for provider '${declaration.provider}'`);
+        const provider = declaration.provider;
+        // the declaration names the provider
+        // oxlint-disable-next-line import/namespace
+        const schema = schemas[provider];
+        schema.validate(declaration, `Storage '${declaration.provider}' annotation`);
+    }
+}
+//# sourceMappingURL=Annotation.js.map

package/transpiled/extensions.storages/Annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Annotation.js","sourceRoot":"","sources":["../../source/extensions.storages/Annotation.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAWvC,MAAM,UAAU,kBAAkB,CAChC,UAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,UAAU,CAAC,CAAA;QAEnB,oDAAoD;QACpD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,OAAO,CAAC,UAAmB;IAClC,MAAM,CAAC,EAAE,CACP,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EACrD,+BAA+B,CAChC,CAAA;IAED,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,EAAE,CACP,OAAO,WAAW,KAAK,QAAQ;YAC7B,WAAW,KAAK,IAAI;YACpB,WAAW,CAAC,QAAQ,IAAI,OAAO,EACjC,qBAAqB,WAAW,CAAC,QAAQ,GAAG,CAC7C,CAAA;QAED,MAAM,CAAC,EAAE,CACP,WAAW,CAAC,QAAQ,IAAI,OAAO,EAC/B,2BAA2B,WAAW,CAAC,QAAQ,GAAG,CACnD,CAAA;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAoB,CAAA;QAEjD,qCAAqC;QACrC,4CAA4C;QAC5C,MAAM,MAAM,GAAwB,OAAO,CAAC,QAAQ,CAAC,CAAA;QAErD,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,WAAW,CAAC,QAAQ,cAAc,CAAC,CAAA;IAC9E,CAAC;AACH,CAAC"}

package/transpiled/extensions.storages/context.d.ts

@@ -0,0 +1,3 @@
+import type { Contribution } from '@toa.io/core/types';
+/** What this extension puts on the context of a component that declares it. */
+export declare function context(declaration: string[]): Contribution | null;

package/transpiled/extensions.storages/context.js

@@ -0,0 +1,12 @@
+/** What this extension puts on the context of a component that declares it. */
+export function context(declaration) {
+    if (!Array.isArray(declaration) || declaration.length === 0)
+        return null;
+    const names = declaration.map((name) => JSON.stringify(name)).join(' | ');
+    return {
+        name: 'storages',
+        type: `Record<${names}, Storage>`,
+        imports: { '@toa.io/extensions.storages': ['Storage'] }
+    };
+}
+//# sourceMappingURL=context.js.map

package/transpiled/extensions.storages/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../source/extensions.storages/context.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,WAAqB;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAExE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAEzE,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU,KAAK,YAAY;QACjC,OAAO,EAAE,EAAE,6BAA6B,EAAE,CAAC,SAAS,CAAC,EAAE;KACxD,CAAA;AACH,CAAC"}

package/transpiled/extensions.storages/deployment.d.ts

@@ -0,0 +1,5 @@
+import type { Dependency } from '@toa.io/operations';
+import type { context } from '@toa.io/norm';
+export declare const ENV_PREFIX = "TOA_STORAGES";
+export declare function deployment(instances: Instance[], annotation: unknown): Dependency;
+export type Instance = context.Dependency<string[]>;

package/transpiled/extensions.storages/deployment.js

@@ -0,0 +1,64 @@
+import * as assert from 'node:assert';
+import { secrets as declared } from './secrets.js';
+import { validateAnnotation } from './Annotation.js';
+export const ENV_PREFIX = 'TOA_STORAGES';
+export function deployment(instances, annotation) {
+    validate(instances, annotation);
+    const value = JSON.stringify(annotation);
+    const pointer = { name: ENV_PREFIX, value };
+    const secrets = getSecrets(annotation);
+    const mounts = getMounts(instances, annotation);
+    const dependency = { variables: { global: [pointer, ...secrets] } };
+    if (mounts !== null)
+        dependency.mounts = mounts;
+    return dependency;
+}
+function validate(instances, annotation) {
+    validateAnnotation(annotation);
+    for (const instance of instances) {
+        instance.manifest ??= [];
+        contains(instance, annotation);
+    }
+}
+function contains(instance, annotation) {
+    for (const name of instance.manifest)
+        assert.ok(name in annotation, `Missing '${name}' storage annotation ` +
+            `declared in '${instance.component.locator.id}'`);
+}
+function getSecrets(annotation) {
+    const secrets = [];
+    for (const [name, declaration] of Object.entries(annotation)) {
+        for (const secret of declared[declaration.provider])
+            secrets.push({
+                name: `${ENV_PREFIX}_${name}_${secret.name}`.toUpperCase(),
+                secret: {
+                    name: `toa-storages-${name}`,
+                    key: secret.name,
+                    optional: secret.optional
+                }
+            });
+    }
+    return secrets;
+}
+function getMounts(instances, annotation) {
+    let mounts = null;
+    for (const { locator, manifest } of instances)
+        for (const name of manifest) {
+            const declaration = annotation[name];
+            // eslint-disable-next-line max-depth
+            if (declaration.provider !== 'fs')
+                continue;
+            // eslint-disable-next-line max-depth
+            if (declaration.claim !== undefined) {
+                mounts ??= {};
+                mounts[locator.label] ??= [];
+                mounts[locator.label].push({
+                    name,
+                    path: declaration.path,
+                    claim: declaration.claim
+                });
+            }
+        }
+    return mounts;
+}
+//# sourceMappingURL=deployment.js.map

package/transpiled/extensions.storages/deployment.js.map

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

package/transpiled/extensions.storages/index.d.ts

@@ -0,0 +1,8 @@
+export { deployment, ENV_PREFIX } from './deployment.js';
+export { manifest } from './manifest.js';
+export { validateAnnotation } from './Annotation.js';
+export { secrets } from './secrets.js';
+export { context } from './context.js';
+export * as schemas from './schemas.js';
+export type { Annotation, Declaration, Provider } from './Annotation.js';
+export type { Secret } from './secrets.js';

package/transpiled/extensions.storages/index.js

@@ -0,0 +1,7 @@
+export { deployment, ENV_PREFIX } from './deployment.js';
+export { manifest } from './manifest.js';
+export { validateAnnotation } from './Annotation.js';
+export { secrets } from './secrets.js';
+export { context } from './context.js';
+export * as schemas from './schemas.js';
+//# sourceMappingURL=index.js.map

package/transpiled/extensions.storages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.storages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/transpiled/extensions.storages/manifest.d.ts

@@ -0,0 +1 @@
+export declare function manifest(manifest: string | string[] | null): string[];

package/transpiled/extensions.storages/manifest.js

@@ -0,0 +1,8 @@
+export function manifest(manifest) {
+    if (manifest === null)
+        return [];
+    if (typeof manifest === 'string')
+        return [manifest];
+    return manifest;
+}
+//# sourceMappingURL=manifest.js.map

package/transpiled/extensions.storages/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../source/extensions.storages/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,QAAkC;IACzD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IAEhC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAEnD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/transpiled/extensions.storages/schemas.d.ts

@@ -0,0 +1,9 @@
+import type { Schema } from '@toa.io/schemas';
+import type { Annotation, Declaration } from './Annotation.js';
+export declare const annotation: Schema<Annotation>;
+export declare const s3: Schema<Declaration>;
+export declare const spaces: Schema<Declaration>;
+export declare const cloudinary: Schema<Declaration>;
+export declare const fs: Schema<Declaration>;
+export declare const tmp: Schema<Declaration>;
+export declare const test: Schema<Declaration>;

package/transpiled/extensions.storages/schemas.js

@@ -0,0 +1,12 @@
+import { resolve } from 'node:path';
+import { namespace } from '@toa.io/schemas';
+const path = resolve(import.meta.dirname, '../../schemas/extensions.storages');
+const ns = namespace(path);
+export const annotation = ns.schema('annotation');
+export const s3 = ns.schema('s3');
+export const spaces = ns.schema('spaces');
+export const cloudinary = ns.schema('cloudinary');
+export const fs = ns.schema('fs');
+export const tmp = ns.schema('tmp');
+export const test = ns.schema('test');
+//# sourceMappingURL=schemas.js.map

package/transpiled/extensions.storages/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../source/extensions.storages/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAI3C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAA;AAC9E,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;AAE1B,MAAM,CAAC,MAAM,UAAU,GAAuB,EAAE,CAAC,MAAM,CAAa,YAAY,CAAC,CAAA;AACjF,MAAM,CAAC,MAAM,EAAE,GAAwB,EAAE,CAAC,MAAM,CAAc,IAAI,CAAC,CAAA;AACnE,MAAM,CAAC,MAAM,MAAM,GAAwB,EAAE,CAAC,MAAM,CAAc,QAAQ,CAAC,CAAA;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAwB,EAAE,CAAC,MAAM,CAAc,YAAY,CAAC,CAAA;AACnF,MAAM,CAAC,MAAM,EAAE,GAAwB,EAAE,CAAC,MAAM,CAAc,IAAI,CAAC,CAAA;AACnE,MAAM,CAAC,MAAM,GAAG,GAAwB,EAAE,CAAC,MAAM,CAAc,KAAK,CAAC,CAAA;AACrE,MAAM,CAAC,MAAM,IAAI,GAAwB,EAAE,CAAC,MAAM,CAAc,MAAM,CAAC,CAAA"}

package/transpiled/extensions.storages/schemas.test.d.ts

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

package/transpiled/extensions.storages/schemas.test.js

@@ -0,0 +1,59 @@
+import { it } from 'node:test';
+import assert from 'node:assert/strict';
+import * as schemas from './schemas.js';
+const ok = {
+    a: {
+        provider: 'tmp',
+        directory: 'ok'
+    },
+    b: {
+        provider: 'fs',
+        path: 'ok'
+    },
+    c: {
+        provider: 's3',
+        bucket: 'my-bucket'
+    },
+    e: {
+        provider: 'spaces',
+        space: 'my-space',
+        region: 'nyc3'
+    }
+};
+const oh = [
+    {
+        whatever: {
+            provider: 'non-existent'
+        }
+    },
+    {
+        whatever: {
+            provider: 'fs'
+        }
+    },
+    {
+        whatever: {
+            provider: 'tmp',
+            extra: true
+        }
+    },
+    {
+        whatever: {
+            provider: 's3'
+        }
+    },
+    {
+        whatever: {
+            provider: 'spaces',
+            space: 'my-space'
+        }
+    }
+];
+it('should pass', () => {
+    assert.doesNotThrow(() => schemas.annotation.validate(ok));
+});
+for (const value of oh)
+    it('should fail', () => {
+        assert.throws(() => schemas.annotation.validate(value));
+    });
+//# sourceMappingURL=schemas.test.js.map

package/transpiled/extensions.storages/schemas.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.test.js","sourceRoot":"","sources":["../../source/extensions.storages/schemas.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAC9B,OAAO,MAAM,MAAM,oBAAoB,CAAA;AAEvC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,MAAM,EAAE,GAAG;IACT,CAAC,EAAE;QACD,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,IAAI;KAChB;IACD,CAAC,EAAE;QACD,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,IAAI;KACX;IACD,CAAC,EAAE;QACD,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,WAAW;KACpB;IACD,CAAC,EAAE;QACD,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,MAAM;KACf;CACF,CAAA;AAED,MAAM,EAAE,GAAG;IACT;QACE,QAAQ,EAAE;YACR,QAAQ,EAAE,cAAc;SACzB;KACF;IACD;QACE,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;SACf;KACF;IACD;QACE,QAAQ,EAAE;YACR,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,IAAI;SACZ;KACF;IACD;QACE,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;SACf;KACF;IACD;QACE,QAAQ,EAAE;YACR,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,UAAU;SAClB;KACF;CACF,CAAA;AAED,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;IACrB,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;AAC5D,CAAC,CAAC,CAAA;AAEF,KAAK,MAAM,KAAK,IAAI,EAAE;IACpB,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACrB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA"}

package/transpiled/extensions.storages/secrets.d.ts

@@ -0,0 +1,10 @@
+/**
+ * What each provider reads from the environment, stated apart from the provider so that a
+ * deployment enumerates them without loading the SDK the provider is written against.
+ */
+export declare const secrets: Record<Provider, readonly Secret[]>;
+export type Provider = 's3' | 'spaces' | 'cloudinary' | 'fs' | 'tmp' | 'test';
+export interface Secret {
+    readonly name: string;
+    readonly optional?: boolean;
+}

package/transpiled/extensions.storages/secrets.js

@@ -0,0 +1,16 @@
+/**
+ * What each provider reads from the environment, stated apart from the provider so that a
+ * deployment enumerates them without loading the SDK the provider is written against.
+ */
+export const secrets = {
+    s3: [
+        { name: 'ACCESS_KEY_ID', optional: true },
+        { name: 'SECRET_ACCESS_KEY', optional: true }
+    ],
+    spaces: [{ name: 'ACCESS_KEY_ID' }, { name: 'SECRET_ACCESS_KEY' }],
+    cloudinary: [{ name: 'API_KEY' }, { name: 'API_SECRET' }],
+    fs: [],
+    tmp: [],
+    test: [{ name: 'USERNAME' }, { name: 'PASSWORD' }]
+};
+//# sourceMappingURL=secrets.js.map

package/transpiled/extensions.storages/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../source/extensions.storages/secrets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAwC;IAC1D,EAAE,EAAE;QACF,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC9C;IACD,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAClE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IACzD,EAAE,EAAE,EAAE;IACN,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;CACnD,CAAA"}

package/transpiled/extensions.telemetry/const.d.ts

@@ -0,0 +1,4 @@
+export declare const ID = "telemetry";
+export declare const LOGS_PREFIX: string;
+export declare const TRACES_ENV: string;
+export declare const READY_ENV = "TOA_TELEMETRY_READY";

package/transpiled/extensions.telemetry/const.js

@@ -0,0 +1,6 @@
+export const ID = 'telemetry';
+const ENV_PREFIX = 'TOA_TELEMETRY';
+export const LOGS_PREFIX = ENV_PREFIX + '_LOGS';
+export const TRACES_ENV = ENV_PREFIX + '_TRACES';
+export const READY_ENV = 'TOA_TELEMETRY_READY';
+//# sourceMappingURL=const.js.map

package/transpiled/extensions.telemetry/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../../source/extensions.telemetry/const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,EAAE,GAAG,WAAW,CAAA;AAE7B,MAAM,UAAU,GAAG,eAAe,CAAA;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,CAAA;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;AAChD,MAAM,CAAC,MAAM,SAAS,GAAG,qBAAqB,CAAA"}

package/transpiled/extensions.telemetry/context.d.ts

@@ -0,0 +1,3 @@
+import type { Contribution } from '@toa.io/core/types';
+/** What this extension puts on the context of every component, being declared for all. */
+export declare function context(): Contribution[];

package/transpiled/extensions.telemetry/context.js

@@ -0,0 +1,9 @@
+/** What this extension puts on the context of every component, being declared for all. */
+export function context() {
+    const imports = { '@toa.io/extensions.telemetry': ['Logs', 'Span'] };
+    return [
+        { name: 'logs', type: 'Logs', imports },
+        { name: 'span', type: 'Span', imports }
+    ];
+}
+//# sourceMappingURL=context.js.map

package/transpiled/extensions.telemetry/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../source/extensions.telemetry/context.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,UAAU,OAAO;IACrB,MAAM,OAAO,GAAG,EAAE,8BAA8B,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;IAEpE,OAAO;QACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QACvC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;KACxC,CAAA;AACH,CAAC"}

package/transpiled/extensions.telemetry/deployment.d.ts

@@ -0,0 +1,18 @@
+import { type ReadyAnnotation } from './ready.js';
+import type { Dependency } from '@toa.io/operations';
+import type { ExportersConfig, LevelName } from 'openspan';
+export declare function deployment(_: unknown, annotation?: Annotation): Dependency;
+interface Annotation {
+    logs?: LogsAnnotation & Record<string, LogsAnnotation>;
+    traces?: TracesAnnotation;
+    ready?: ReadyAnnotation;
+}
+interface LogsAnnotation {
+    level: LevelName;
+}
+interface TracesAnnotation {
+    sample?: number;
+    rate?: number;
+    exporters?: ExportersConfig;
+}
+export {};

package/transpiled/extensions.telemetry/deployment.js

@@ -0,0 +1,49 @@
+import assert from 'node:assert';
+import { LOGS_PREFIX, READY_ENV, TRACES_ENV } from './const.js';
+import { DEFAULT_ANNOTATION, normalizeAnnotation } from './ready.js';
+export function deployment(_, annotation) {
+    const variables = { global: [] };
+    if (annotation?.logs !== undefined)
+        addLogsVariables(annotation.logs, variables);
+    if (annotation?.traces !== undefined)
+        addTracesVariables(annotation.traces, variables);
+    const ready = normalizeAnnotation(annotation?.ready);
+    if (ready === false) {
+        variables.global.push({ name: READY_ENV, value: JSON.stringify(false) });
+        return { variables, probe: false };
+    }
+    variables.global.push({ name: READY_ENV, value: JSON.stringify(ready) });
+    const probe = {
+        path: ready.path ?? DEFAULT_ANNOTATION.path,
+        port: ready.port ?? DEFAULT_ANNOTATION.port
+    };
+    return { variables, probe };
+}
+function addLogsVariables(annotation, variables) {
+    const { level, ...components } = annotation;
+    const global = { level };
+    if (level !== undefined)
+        variables.global.push({ name: LOGS_PREFIX, value: JSON.stringify(global) });
+    for (const [id, override] of Object.entries(components)) {
+        const [namespace, name] = id.split('.');
+        const value = Object.assign({}, global, override);
+        variables.global.push({
+            name: `${LOGS_PREFIX}_${namespace.toUpperCase()}_${name.toUpperCase()}`,
+            value: JSON.stringify(value)
+        });
+    }
+}
+function addTracesVariables(annotation, variables) {
+    const { sample, rate, exporters } = annotation;
+    if (sample !== undefined)
+        assert.ok(typeof sample === 'number' && sample >= 0 && sample <= 1, 'telemetry.traces.sample must be a number within [0, 1]');
+    if (rate !== undefined)
+        assert.ok(typeof rate === 'number' && rate > 0, 'telemetry.traces.rate must be a positive number');
+    if (exporters?.otlp !== undefined)
+        assert.ok(typeof exporters.otlp.endpoint === 'string', 'telemetry.traces.exporters.otlp.endpoint is required');
+    variables.global.push({
+        name: TRACES_ENV,
+        value: JSON.stringify({ sample, rate, exporters })
+    });
+}
+//# sourceMappingURL=deployment.js.map

package/transpiled/extensions.telemetry/deployment.js.map

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

package/transpiled/extensions.telemetry/index.d.ts

@@ -0,0 +1,5 @@
+export { deployment } from './deployment.js';
+export { ID, LOGS_PREFIX, TRACES_ENV, READY_ENV } from './const.js';
+export { DEFAULT_ANNOTATION, normalizeAnnotation } from './ready.js';
+export type { ReadyAnnotation, ReadyConfig } from './ready.js';
+export { context } from './context.js';

package/transpiled/extensions.telemetry/index.js

@@ -0,0 +1,5 @@
+export { deployment } from './deployment.js';
+export { ID, LOGS_PREFIX, TRACES_ENV, READY_ENV } from './const.js';
+export { DEFAULT_ANNOTATION, normalizeAnnotation } from './ready.js';
+export { context } from './context.js';
+//# sourceMappingURL=index.js.map

package/transpiled/extensions.telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/extensions.telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/transpiled/extensions.telemetry/ready.d.ts

@@ -0,0 +1,14 @@
+export declare function normalizeAnnotation(ready: ReadyAnnotation | undefined): ReadyConfig | false;
+export declare const DEFAULT_ANNOTATION: {
+    readonly path: '/.ready';
+    readonly port: 8001;
+};
+export type ReadyAnnotation = false | {
+    path?: string;
+    port?: number;
+};
+export type ReadyConfig = false | {
+    enabled?: boolean;
+    path?: string;
+    port?: number;
+};

package/transpiled/extensions.telemetry/ready.js

@@ -0,0 +1,16 @@
+export function normalizeAnnotation(ready) {
+    if (ready === false)
+        return false;
+    if (ready === undefined)
+        return { enabled: true, ...DEFAULT_ANNOTATION };
+    return {
+        enabled: true,
+        path: ready.path ?? DEFAULT_ANNOTATION.path,
+        port: ready.port ?? DEFAULT_ANNOTATION.port
+    };
+}
+export const DEFAULT_ANNOTATION = {
+    path: '/.ready',
+    port: 8001
+};
+//# sourceMappingURL=ready.js.map

package/transpiled/extensions.telemetry/ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready.js","sourceRoot":"","sources":["../../source/extensions.telemetry/ready.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CACjC,KAAkC;IAElC,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IAEjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,kBAAkB,EAAE,CAAA;IAExE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,kBAAkB,CAAC,IAAI;QAC3C,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,kBAAkB,CAAC,IAAI;KAC5C,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,IAAI;CACF,CAAA"}

package/transpiled/index.d.ts

@@ -0,0 +1,2 @@
+export { version } from './version.js';
+export { definition, DEFINED } from './definition.js';

package/transpiled/index.js

@@ -0,0 +1,3 @@
+export { version } from './version.js';
+export { definition, DEFINED } from './definition.js';
+//# sourceMappingURL=index.js.map

package/transpiled/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA"}

package/transpiled/storages.mongodb/deployment.d.ts

@@ -0,0 +1,5 @@
+import { type URIMap } from '@toa.io/pointer';
+import type { context } from '@toa.io/norm';
+import type { Dependency } from '@toa.io/operations';
+export declare function deployment(instances: context.Dependency[], annotation: URIMap): Dependency;
+export declare const ID = "mongodb";

package/transpiled/storages.mongodb/deployment.js

@@ -0,0 +1,14 @@
+import { createVariables } from '@toa.io/pointer';
+export function deployment(instances, annotation) {
+    const requests = instances.map((instance) => createRequest(instance));
+    const variables = createVariables(ID, annotation, requests);
+    return { variables };
+}
+function createRequest(instance) {
+    return {
+        group: instance.locator.label,
+        selectors: [instance.locator.id]
+    };
+}
+export const ID = 'mongodb';
+//# sourceMappingURL=deployment.js.map

package/transpiled/storages.mongodb/deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../source/storages.mongodb/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA6B,MAAM,iBAAiB,CAAA;AAI5E,MAAM,UAAU,UAAU,CACxB,SAA+B,EAC/B,UAAkB;IAElB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;IACrE,MAAM,SAAS,GAAG,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;IAE3D,OAAO,EAAE,SAAS,EAAE,CAAA;AACtB,CAAC;AAED,SAAS,aAAa,CAAC,QAA4B;IACjD,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;QAC7B,SAAS,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;KACjC,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,CAAA"}

package/transpiled/storages.mongodb/index.d.ts

@@ -0,0 +1 @@
+export { deployment, ID } from './deployment.js';

package/transpiled/storages.mongodb/index.js

@@ -0,0 +1,2 @@
+export { deployment, ID } from './deployment.js';
+//# sourceMappingURL=index.js.map

package/transpiled/storages.mongodb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/storages.mongodb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA"}

package/transpiled/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The version of Toa. This package is versioned with every release, so its version
+ * is the runtime's, whether or not the runtime is installed beside it.
+ */
+export declare const version: string;

package/transpiled/version.js

@@ -0,0 +1,8 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * The version of Toa. This package is versioned with every release, so its version
+ * is the runtime's, whether or not the runtime is installed beside it.
+ */
+export const version = JSON.parse(readFileSync(join(import.meta.dirname, '../package.json'), 'utf8')).version;
+//# sourceMappingURL=version.js.map

package/transpiled/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../source/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAW,IAAI,CAAC,KAAK,CACvC,YAAY,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CACnE,CAAC,OAAO,CAAA"}

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./transpiled",
+    "rootDir": "./source"
+  },
+  "include": [
+    "source"
+  ]
+}