@toa.io/extensions.configuration 0.20.0-dev.34 → 0.20.0-dev.36

package/source/.manifest/.normalize/verbose.js

@@ -1,51 +0,0 @@
-'use strict'
-
-const { remap } = require('@toa.io/generic')
-
-const verbose = (node) => {
-  const isObject = node.properties !== undefined
-  const isValue = node.type !== undefined && node.type !== 'object'
-  const isProperties = node[SYM] === 1
-
-  if (!isObject && !isValue && !isProperties) return convert(node)
-
-  return node
-}
-
-const convert = (node) => {
-  const properties = remap(node, property)
-
-  properties[SYM] = 1
-
-  return { type: 'object', properties, additionalProperties: false }
-}
-
-function property (node) {
-  if (node === null) return { type: 'null', default: null }
-
-  const type = Array.isArray(node) ? 'array' : typeof node
-
-  if (type === 'object') return node
-  if (type === 'array') return array(node)
-
-  return { type, default: node }
-}
-
-const array = (array) => {
-  if (array.length === 0) throw new Error('Configuration: cannot resolve concise array items type because it\'s empty')
-
-  const type = typeof array[0]
-
-  const schema = {
-    type: 'array',
-    default: array
-  }
-
-  if (array.length === 1) schema.items = array[0]
-
-  return schema
-}
-
-const SYM = Symbol()
-
-exports.verbose = verbose

package/source/.manifest/index.js

@@ -1,7 +0,0 @@
-'use strict'
-
-const { normalize } = require('./normalize')
-const { validate } = require('./validate')
-
-exports.normalize = normalize
-exports.validate = validate

package/source/.manifest/normalize.js

@@ -1,16 +0,0 @@
-'use strict'
-
-const { traverse } = require('@toa.io/generic')
-const { verbose } = require('./.normalize/verbose')
-
-const normalize = (manifest) => {
-  if (manifest.properties === undefined) manifest = expand(manifest)
-
-  return manifest
-}
-
-const expand = (concise) => {
-  return traverse(concise, verbose)
-}
-
-exports.normalize = normalize

package/source/.manifest/schema.yaml

@@ -1,9 +0,0 @@
-$schema: https://json-schema.org/draft/2019-09/schema
-$id: https://schemas.toa.io/0.0.0/extensions/configuration/manifest
-
-$ref: 'https://schemas.toa.io/0.0.0/definitions#/definitions/schema'
-type: object
-properties:
-  type:
-    const: object
-    default: object

package/source/.manifest/validate.js

@@ -1,13 +0,0 @@
-'use strict'
-
-const path = require('path')
-
-const { Schema } = require('@toa.io/schema')
-const { load } = require('@toa.io/yaml')
-
-const schema = load.sync(path.resolve(__dirname, 'schema.yaml'))
-const validator = new Schema(schema)
-
-const validate = (declaration) => validator.validate(declaration)
-
-exports.validate = validate

package/source/.provider/env.js

@@ -1,19 +0,0 @@
-'use strict'
-
-const { map } = require('@toa.io/generic')
-
-function env (object) {
-  return map(object,
-    /**
-     * @type {toa.generic.map.transform<string>}
-     */
-    (value) => {
-      if (typeof value !== 'string') return
-
-      return value.replaceAll(RX, (match, variable) => process.env[variable] ?? match)
-    })
-}
-
-const RX = /\${(?<variable>[A-Z0-9_]{1,32})}/g
-
-exports.env = env

package/source/.provider/form.js

@@ -1,20 +0,0 @@
-'use strict'
-
-const { traverse } = require('@toa.io/generic')
-
-/**
- * @param {toa.schema.JSON | Object} schema
- * @return {Object}
- */
-const form = (schema) => {
-  const defaults = (node) => {
-    if (node.type === 'object' && node.properties !== undefined) return { ...node.properties }
-    if (node.default !== undefined) return node.default
-
-    return null
-  }
-
-  return traverse(schema, defaults)
-}
-
-exports.form = form

package/source/.provider/index.js

@@ -1,7 +0,0 @@
-'use strict'
-
-const { form } = require('./form')
-const { env } = require('./env')
-
-exports.form = form
-exports.env = env

package/source/annotation.fixtures.js

@@ -1,39 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-const { Locator } = require('@toa.io/core')
-const { random } = require('@toa.io/generic')
-
-const instance = () => {
-  const name = generate()
-  const namespace = generate()
-  const locator = new Locator(name, namespace)
-
-  const manifest = {
-    type: 'object',
-    properties: {
-      foo: {
-        type: 'number',
-        default: 1
-      }
-    }
-  }
-
-  return { locator, manifest }
-}
-
-/** @type {toa.norm.context.dependencies.Instance[]} */
-const instances = []
-
-for (let i = 0; i < random(5) + 5; i++) instances.push(instance())
-
-/** @type {Object} */
-const annotation = {}
-
-for (let i = 0; i < random(instances.length - 1) + 1; i++) {
-  const instance = instances[i]
-  annotation[instance.locator.id] = { foo: random() }
-}
-
-exports.instances = instances
-exports.annotation = annotation

package/source/annotation.js

@@ -1,36 +0,0 @@
-'use strict'
-
-const { Schema } = require('@toa.io/schema')
-
-/**
- * @param {Object} annotation
- * @param {toa.norm.context.dependencies.Instance[]} instances
- */
-const annotation = (annotation, instances) => {
-  const keys = Object.keys(annotation)
-
-  check(keys, instances)
-
-  for (const instance of instances) {
-    const object = annotation[instance.locator.id] ?? {}
-    const schema = new Schema(instance.manifest)
-
-    schema.validate(object)
-  }
-
-  return annotation
-}
-
-/**
- * @param {string[]} keys
- * @param {toa.norm.context.dependencies.Instance[]} instances
- */
-const check = (keys, instances) => {
-  const ids = instances.map((instance) => instance.locator.id)
-
-  for (const key of keys) {
-    if (!ids.includes(key)) throw new Error(`Configuration Schema '${key}' is not defined`)
-  }
-}
-
-exports.annotation = annotation

package/source/annotation.test.js

@@ -1,43 +0,0 @@
-'use strict'
-
-const clone = require('clone-deep')
-const { generate } = require('randomstring')
-const { sample } = require('@toa.io/generic')
-
-const fixtures = require('./annotation.fixtures')
-const { annotation } = require('../')
-
-let input
-/** @type {toa.norm.context.dependencies.Instance[]} */ let instances
-
-const call = () => annotation(input, instances)
-
-beforeEach(() => {
-  input = clone(fixtures.annotation)
-  instances = clone(fixtures.instances)
-})
-
-it('sample must be valid', () => {
-  expect(call).not.toThrow()
-})
-
-it('should must be a function', () => {
-  expect(annotation).toBeDefined()
-  expect(annotation).toBeInstanceOf(Function)
-})
-
-it('should throw on non-existent component', () => {
-  input[generate()] = {}
-
-  expect(call).toThrow(/Configuration Schema/)
-})
-
-it('should throw if object doesn\'t match schema', () => {
-  const keys = Object.keys(input)
-  const key = sample(keys)
-  const object = input[key]
-
-  object.foo = generate()
-
-  expect(call).toThrow(/foo must be number/)
-})

package/source/aspect.fixtures.js

@@ -1,32 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-
-const schema = {
-  type: 'object',
-  properties: {
-    foo: {
-      type: 'string',
-      default: generate()
-    },
-    bar: {
-      type: 'object',
-      properties: {
-        baz: {
-          type: 'number',
-          default: 1
-        }
-      }
-    }
-  }
-}
-
-const concise = {
-  foo: schema.properties.foo.default,
-  bar: {
-    baz: schema.properties.bar.properties.baz.default
-  }
-}
-
-exports.schema = schema
-exports.concise = concise

package/source/aspect.js

@@ -1,36 +0,0 @@
-'use strict'
-
-const { Connector } = require('@toa.io/core')
-
-/**
- * @implements {toa.extensions.configuration.Aspect}
- */
-class Aspect extends Connector {
-  /** @readonly */
-  name = 'configuration'
-
-  /** @type {toa.core.Reflection} */
-  #refection
-
-  /**
-   * @param {toa.core.Reflection} reflection
-   */
-  constructor (reflection) {
-    super()
-
-    this.#refection = reflection
-
-    this.depends(reflection)
-  }
-
-  invoke (path) {
-    /** @type {any} */
-    let cursor = this.#refection.value
-
-    if (path !== undefined) for (const segment of path) cursor = cursor[segment]
-
-    return cursor
-  }
-}
-
-exports.Aspect = Aspect

package/source/aspect.test.js

@@ -1,76 +0,0 @@
-'use strict'
-
-const { Locator } = require('@toa.io/core')
-const { encode } = require('@toa.io/generic')
-
-const fixtures = require('./aspect.fixtures')
-const { Factory } = require('../')
-const { generate } = require('randomstring')
-
-const factory = new Factory()
-
-/** @type {toa.extensions.configuration.Aspect} */
-let aspect
-
-/** @type {toa.core.Locator} */
-let locator
-
-describe('defaults', () => {
-  beforeEach(async () => {
-    const namespace = generate()
-    const name = generate()
-
-    locator = new Locator(name, namespace)
-
-    aspect = factory.aspect(locator, fixtures.schema)
-
-    await aspect.connect()
-  })
-
-  it('should return schema defaults', () => {
-    const foo = aspect.invoke(['foo'])
-
-    expect(foo).toStrictEqual(fixtures.schema.properties.foo.default)
-  })
-
-  it('should return nested values', () => {
-    const baz = aspect.invoke(['bar', 'baz'])
-
-    expect(baz).toStrictEqual(fixtures.schema.properties.bar.properties.baz.default)
-  })
-
-  it('should expose configuration tree', () => {
-    const configuration = aspect.invoke()
-
-    expect(configuration).toStrictEqual({
-      foo: fixtures.schema.properties.foo.default,
-      bar: {
-        baz: fixtures.schema.properties.bar.properties.baz.default
-      }
-    })
-  })
-})
-
-describe('resolution', () => {
-  let object
-  let varname
-
-  beforeEach(() => {
-    object = { foo: generate() }
-
-    varname = 'TOA_CONFIGURATION_' + locator.uppercase
-  })
-
-  it('should resolve configuration object from environment variable', async () => {
-    process.env[varname] = encode(object)
-
-    aspect = factory.aspect(locator, fixtures.schema)
-
-    await aspect.connect()
-
-    const configuration = aspect.invoke()
-
-    expect(configuration.foo).toStrictEqual(object.foo)
-    expect(configuration.bar.baz).toStrictEqual(fixtures.schema.properties.bar.properties.baz.default)
-  })
-})

package/source/configuration.js

@@ -1,19 +0,0 @@
-'use strict'
-
-const { Reflection } = require('@toa.io/core')
-
-/**
- * @implements {toa.core.Reflection}
- */
-class Configuration extends Reflection {
-  /**
-   * @param {toa.extensions.configuration.Provider} provider
-   */
-  constructor (provider) {
-    super(provider.source)
-
-    this.depends(provider)
-  }
-}
-
-exports.Configuration = Configuration

package/source/deployment.fixtures.js

@@ -1,38 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-
-const { Locator } = require('@toa.io/core')
-const { random } = require('@toa.io/generic')
-
-const component = () => {
-  const namespace = generate()
-  const name = generate()
-
-  return { locator: new Locator(name, namespace) }
-}
-
-/** @type {toa.norm.context.dependencies.Instance[]} */
-const components = []
-const annotations = {}
-
-const annotate = (component) => {
-  const key = component.locator.id
-
-  annotations[key] = { [generate()]: generate() }
-}
-
-for (let i = 0; i < random(10) + 5; i++) components.push(component())
-for (let i = 0; i < components.length; i++) if (i % 2 === 0) annotate(components[i])
-
-/**
- * @param {string} id
- * @returns {toa.norm.context.dependencies.Instance}
- */
-const find = (id) => {
-  return components.find((component) => component.locator.id === id)
-}
-
-exports.components = components
-exports.annotations = annotations
-exports.find = find

package/source/deployment.js

@@ -1,20 +0,0 @@
-'use strict'
-
-const { merge } = require('@toa.io/generic')
-const get = require('./.deployment')
-
-/**
- * @param {toa.norm.context.dependencies.Instance[]} components
- * @param {object} annotations
- * @return {toa.deployment.dependency.Declaration}
- */
-const deployment = (components, annotations) => {
-  const variables = get.variables(components, annotations)
-  const secrets = get.secrets(components, annotations)
-
-  merge(variables, secrets)
-
-  return { variables }
-}
-
-exports.deployment = deployment

package/source/deployment.test.js

@@ -1,70 +0,0 @@
-'use strict'
-
-const clone = require('clone-deep')
-const { encode, sample } = require('@toa.io/generic')
-
-const fixtures = require('./deployment.fixtures')
-const { deployment } = require('../')
-const { generate } = require('randomstring')
-
-/** @type {toa.deployment.dependency.Declaration} */
-let declaration
-
-beforeAll(() => {
-  declaration = deployment(fixtures.components, fixtures.annotations)
-})
-
-it('should exist', () => {
-  expect(deployment).toBeDefined()
-})
-
-it('should declare variables', () => {
-  expect(declaration.variables).toBeDefined()
-})
-
-it('should map configurations', () => {
-  const keys = Object.keys(fixtures.annotations)
-
-  expect(keys.length).toBeGreaterThan(0)
-
-  for (const [id, annotations] of Object.entries(fixtures.annotations)) {
-    const component = fixtures.find(id)
-    const variables = declaration.variables[component.locator.label]
-    const encoded = encode(annotations)
-
-    expect(component).toBeDefined()
-    expect(variables).toBeDefined()
-    expect(variables).toBeInstanceOf(Array)
-    expect(variables.length).toStrictEqual(1)
-
-    const env = variables[0]
-
-    expect(env.name).toBeDefined()
-    expect(env.name).toStrictEqual('TOA_CONFIGURATION_' + component.locator.uppercase)
-    expect(env.value).toBeDefined()
-    expect(env.value).toStrictEqual(encoded)
-  }
-})
-
-it('should declare secrets', async () => {
-  const annotations = clone(fixtures.annotations)
-  const component = sample(fixtures.components)
-  const id = component.locator.id
-  const key = generate()
-  const name = generate().substring(0, 16).toUpperCase()
-  const value = '$' + name
-
-  if (annotations[id] === undefined) annotations[id] = {}
-
-  annotations[id][key] = value
-
-  declaration = deployment(fixtures.components, annotations)
-
-  const variables = declaration.variables[component.locator.label]
-
-  expect(variables).toBeDefined()
-
-  const secret = variables.find((variable) => variable.name === 'TOA_CONFIGURATION__' + name)
-
-  expect(secret).toBeDefined()
-})

package/source/factory.js

@@ -1,39 +0,0 @@
-'use strict'
-
-const { Schema } = require('@toa.io/schema')
-const { Aspect } = require('./aspect')
-const { Configuration } = require('./configuration')
-const { Provider } = require('./provider')
-
-/**
- * @implements {toa.extensions.configuration.Factory}
- */
-class Factory {
-  /**
-   * @param {toa.core.Locator} locator
-   * @param {toa.schema.JSON | Object} annotation
-   * @return {toa.extensions.configuration.Aspect}
-   */
-  aspect (locator, annotation) {
-    const schema = new Schema(annotation)
-    const provider = new Provider(locator, schema)
-    const configuration = new Configuration(provider)
-
-    return new Aspect(configuration)
-  }
-
-  provider (component) {
-    const locator = component.locator
-    const declaration = component.extensions?.[ID]
-
-    if (declaration === undefined) throw new Error(`Configuration extension not found in '${locator.id}'`)
-
-    const schema = new Schema(declaration)
-
-    return new Provider(locator, schema)
-  }
-}
-
-const ID = require('../package.json').name
-
-exports.Factory = Factory

package/source/factory.test.js

@@ -1,22 +0,0 @@
-'use strict'
-
-const { Factory } = require('../')
-
-it('should export', () => {
-  expect(Factory).toBeInstanceOf(Function)
-})
-
-/** @type {toa.extensions.configuration.Factory} */
-let factory
-
-beforeAll(async () => {
-  factory = new Factory()
-})
-
-it('should expose context', () => {
-  expect(factory.aspect).toBeInstanceOf(Function)
-})
-
-it('should expose provider', () => {
-  expect(factory.provider).toBeInstanceOf(Function)
-})

package/source/index.js

@@ -1,13 +0,0 @@
-'use strict'
-
-const { manifest } = require('./manifest')
-const { annotation } = require('./annotation')
-const { deployment } = require('./deployment')
-
-const { Factory } = require('./factory')
-
-exports.manifest = manifest
-exports.annotation = annotation
-exports.deployment = deployment
-
-exports.Factory = Factory

package/source/manifest.js

@@ -1,13 +0,0 @@
-'use strict'
-
-const { normalize, validate } = require('./.manifest')
-
-const manifest = (manifest) => {
-  const declaration = normalize(manifest)
-
-  validate(declaration)
-
-  return declaration
-}
-
-exports.manifest = manifest