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

package/source/manifest.test.js

@@ -1,123 +0,0 @@
-'use strict'
-
-const { generate } = require('randomstring')
-const { random } = require('@toa.io/generic')
-
-const { manifest } = require('../')
-
-it('should export', () => {
-  expect(manifest).toBeInstanceOf(Function)
-})
-
-describe('validation', () => {
-  it('should throw if not an object', () => {
-    const call = () => manifest(generate())
-    expect(call).toThrow(/must be object/)
-  })
-
-  it('should throw if not a valid schema', () => {
-    const object = { type: generate() }
-    const call = () => manifest(object)
-
-    expect(call).toThrow(/one of the allowed values/)
-  })
-
-  it('should throw if schema is not an object type', () => {
-    const schema = { type: 'number' }
-    const call = () => manifest(schema)
-
-    expect(call).toThrow(/equal to constant 'object'/)
-  })
-})
-
-describe('normalization', () => {
-  it('should expand concise', () => {
-    const concise = {
-      foo: generate(),
-      bar: {
-        baz: random()
-      }
-    }
-
-    const declaration = manifest(concise)
-
-    expect(declaration).toMatchObject({
-      type: 'object',
-      properties: {
-        foo: {
-          type: 'string',
-          default: concise.foo
-        },
-        bar: {
-          type: 'object',
-          properties: {
-            baz: {
-              type: 'number',
-              default: concise.bar.baz
-            }
-          }
-        }
-      }
-    })
-  })
-
-  it('should expand partially concise', () => {
-    const concise = {
-      foo: generate(),
-      bar: {
-        baz: random()
-      },
-      qux: {
-        type: 'string',
-        default: null
-      }
-    }
-
-    const declaration = manifest(concise)
-
-    expect(declaration).toMatchObject({
-      type: 'object',
-      properties: {
-        foo: {
-          type: 'string',
-          default: concise.foo
-        },
-        bar: {
-          type: 'object',
-          properties: {
-            baz: {
-              type: 'number',
-              default: concise.bar.baz
-            }
-          }
-        },
-        qux: {
-          type: 'string',
-          default: null
-        }
-      }
-    })
-  })
-
-  it('should expand arrays', () => {
-    const concise = { foo: [1, 2, 3] }
-
-    const declaration = manifest(concise)
-
-    expect(declaration).toMatchObject({
-      type: 'object',
-      properties: {
-        foo: {
-          type: 'array',
-          default: [1, 2, 3]
-        }
-      }
-    })
-  })
-
-  it('should throw on empty array', () => {
-    const concise = { foo: [] }
-
-    expect(() => manifest(concise)).toThrow(/array items type because it's empty/)
-  })
-})

package/source/provider.js

@@ -1,119 +0,0 @@
-'use strict'
-
-const clone = require('clone-deep')
-const { decode, encode, empty, overwrite } = require('@toa.io/generic')
-
-const { Connector } = require('@toa.io/core')
-
-const { secrets } = require('./secrets')
-const { env, form } = require('./.provider')
-
-/**
- * @implements {toa.extensions.configuration.Provider}
- */
-class Provider extends Connector {
-  /** @type {toa.schema.Schema} */
-  #schema
-
-  /** @type {Object} */
-  #form
-  /** @type {Object} */
-  #value
-
-  source
-  object
-  key
-
-  /**
-   * @param {toa.core.Locator} locator
-   * @param {toa.schema.Schema} schema
-   */
-  constructor (locator, schema) {
-    super()
-
-    this.source = this.#source.bind(this)
-
-    this.key = PREFIX + locator.uppercase
-    this.#schema = schema
-
-    // form is required to enable nested defaults
-    this.#form = form(schema.schema)
-  }
-
-  async open () {
-    this.#retrieve()
-  }
-
-  set (key, value) {
-    const object = this.object === undefined ? {} : clone(this.object)
-    const properties = key.split('.')
-    const property = properties.pop()
-
-    let cursor = object
-
-    for (const name of properties) {
-      if (cursor[name] === undefined) cursor[name] = {}
-
-      cursor = cursor[name]
-    }
-
-    if (value === undefined) delete cursor[property]
-    else cursor[property] = value
-
-    this.#set(object)
-  }
-
-  unset (key) {
-    this.set(key, undefined)
-  }
-
-  reset () {
-    this.object = undefined
-  }
-
-  export () {
-    return this.object === undefined ? undefined : encode(this.object)
-  }
-
-  #source () {
-    return this.#value
-  }
-
-  #retrieve () {
-    const string = process.env[this.key]
-    const object = string === undefined ? {} : decode(string)
-
-    this.#set(object)
-  }
-
-  #set (object) {
-    object = this.#reveal(object)
-    object = env(object)
-
-    this.#merge(object)
-
-    this.object = empty(object) ? undefined : object
-  }
-
-  #merge (object) {
-    object = clone(object)
-
-    const form = clone(this.#form)
-    const value = overwrite(form, object)
-
-    this.#schema.validate(value)
-    this.#value = value
-  }
-
-  #reveal (object) {
-    return secrets(object, (variable) => {
-      if (!(variable in process.env)) throw new Error(`Configuration secret value ${variable} is not set`)
-
-      return process.env[variable]
-    })
-  }
-}
-
-const PREFIX = 'TOA_CONFIGURATION_'
-
-exports.Provider = Provider

package/source/provider.test.js

@@ -1,130 +0,0 @@
-'use strict'
-
-/* eslint-disable no-template-curly-in-string */
-
-const { generate } = require('randomstring')
-const { encode } = require('@toa.io/generic')
-
-const { Provider } = require('./provider')
-
-it('should be', async () => {
-  expect(Provider).toBeInstanceOf(Function)
-})
-
-const locator = /** @type {toa.core.Locator} */ { uppercase: generate().toUpperCase() }
-const schema = /** @type {toa.schema.Schema} */ { validate: () => undefined }
-
-/** @type {Provider} */
-let provider
-
-beforeEach(() => {
-  cleanEnv()
-  provider = new Provider(locator, schema)
-})
-
-it('should replace secret values', async () => {
-  const configuration = { foo: '$FOO_SECRET' }
-  const secrets = { FOO_SECRET: generate() }
-
-  setEnv(configuration, secrets)
-
-  await provider.open()
-  const value = provider.source()
-
-  expect(value).toStrictEqual({ foo: secrets.FOO_SECRET })
-})
-
-it('should throw if secret value is not set', async () => {
-  const configuration = { foo: '$FOO_SECRET' }
-
-  setEnv(configuration)
-
-  await expect(provider.open()).rejects.toThrow('FOO_SECRET is not set')
-})
-
-it('should replace nested secrets', async () => {
-  const configuration = { foo: { bar: '$BAR' } }
-  const secrets = { BAR: generate() }
-
-  setEnv(configuration, secrets)
-
-  await provider.open()
-  const value = provider.source()
-
-  expect(value).toStrictEqual({ foo: { bar: secrets.BAR } })
-})
-
-it('should replace placeholders', async () => {
-  const name = 'FOO_VALUE'
-  const configuration = { foo: { bar: 'foo_${' + name + '}' } }
-  const value = generate()
-
-  setEnv(configuration)
-  setVal(name, value)
-
-  await provider.open()
-  const source = provider.source()
-
-  expect(source).toStrictEqual({ foo: { bar: 'foo_' + value } })
-})
-
-it('should replace multiple placeholders', async () => {
-  const configuration = { foo: '${FOO} ${BAR}' }
-
-  setEnv(configuration)
-  setVal('FOO', 'hello')
-  setVal('BAR', 'world')
-
-  await provider.open()
-  const source = provider.source()
-
-  expect(source).toStrictEqual({ foo: 'hello world' })
-})
-
-it('should not replace if variable not set', async () => {
-  const configuration = { foo: '${FOO}' }
-
-  setEnv(configuration)
-
-  await provider.open()
-  const value = provider.source()
-
-  expect(value).toStrictEqual(configuration)
-})
-
-const usedVariables = []
-
-/**
- * @param {object} configuration
- * @param {Record<string, string>} [secrets]
- */
-function setEnv (configuration, secrets) {
-  const variable = PREFIX + locator.uppercase
-  const encoded = encode(configuration)
-
-  setVal(variable, encoded)
-
-  if (secrets !== undefined) {
-    for (const [key, value] of Object.entries(secrets)) {
-      const variable = PREFIX + '_' + key
-
-      process.env[variable] = value
-      usedVariables.push(variable)
-    }
-  }
-}
-
-function setVal (variable, value) {
-  process.env[variable] = value
-  usedVariables.push(variable)
-}
-
-function cleanEnv () {
-  for (const variable of usedVariables) {
-    delete process.env[variable]
-  }
-
-  usedVariables.length = 0
-}
-
-const PREFIX = 'TOA_CONFIGURATION_'

package/source/secrets.js

@@ -1,28 +0,0 @@
-'use strict'
-
-const { map } = require('@toa.io/generic')
-
-/**
- * @param {object} configuration
- * @param {(variable: string, name?: string) => void} callback
- * @returns {object}
- */
-function secrets (configuration, callback) {
-  return map(configuration, (value) => {
-    if (typeof value !== 'string') return
-
-    const match = value.match(SECRET_RX)
-
-    if (match === null) return
-
-    const name = match.groups.variable
-    const variable = PREFIX + name
-
-    return callback(variable, name)
-  })
-}
-
-const PREFIX = 'TOA_CONFIGURATION__'
-const SECRET_RX = /^\$(?<variable>[A-Z0-9_]{1,32})$/
-
-exports.secrets = secrets

package/source/secrets.test.js

@@ -1,47 +0,0 @@
-'use strict'
-
-const { secrets } = require('./secrets')
-
-it('should be', async () => {
-  expect(secrets).toBeInstanceOf(Function)
-})
-
-it('should find secrets', async () => {
-  const configuration = {
-    foo: {
-      bar: '$BAR_VALUE'
-    },
-    baz: '$BAZ_VALUE'
-  }
-
-  const variables = new Set()
-  const names = new Set()
-
-  secrets(configuration, (variable, name) => {
-    variables.add(variable)
-    names.add(name)
-  })
-
-  expect(variables.has('TOA_CONFIGURATION__BAR_VALUE')).toStrictEqual(true)
-  expect(variables.has('TOA_CONFIGURATION__BAZ_VALUE')).toStrictEqual(true)
-
-  expect(names.has('BAR_VALUE')).toStrictEqual(true)
-  expect(names.has('BAZ_VALUE')).toStrictEqual(true)
-})
-
-it('should replace values', async () => {
-  const configuration = { foo: '$FOO' }
-
-  const output = secrets(configuration, (variable) => 'hello')
-
-  expect(output).toStrictEqual({ foo: 'hello' })
-})
-
-it('should allow numbers in secret names', async () => {
-  const configuration = { foo: '$HOST_0' }
-  const found = new Set()
-
-  secrets(configuration, (variable) => found.add(variable))
-
-  expect(found.has('TOA_CONFIGURATION__HOST_0')).toStrictEqual(true)
-})

package/types/aspect.d.ts

@@ -1,11 +0,0 @@
-// noinspection ES6UnusedImports
-
-import * as core from '@toa.io/core/types/extensions'
-
-declare namespace toa.extensions.configuration {
-
-  interface Aspect extends core.Aspect {
-    invoke(path?: string[]): any
-  }
-
-}

package/types/factory.d.ts

@@ -1,12 +0,0 @@
-import { Component } from '@toa.io/norm/types'
-
-import * as _extensions from '@toa.io/core/types/extensions'
-import * as _provider from './provider'
-
-declare namespace toa.extensions.configuration {
-
-  interface Factory extends _extensions.Factory {
-    provider(component: Component): _provider.Provider
-  }
-
-}

package/types/provider.d.ts

@@ -1,22 +0,0 @@
-import { Source } from '@toa.io/core/types/reflection'
-import { Connector } from '@toa.io/core/types'
-
-declare namespace toa.extensions.configuration {
-
-    interface Provider extends Connector {
-        source: Source
-        object: Object
-        key: string
-
-        set(key: string, value: any): void
-
-        unset(key: string): void
-
-        reset(): void
-
-        export(): string
-    }
-
-}
-
-export type Provider = toa.extensions.configuration.Provider