@toa.io/pointer 0.20.0-dev.4 → 0.20.0-dev.40

package/source/index.ts

@@ -0,0 +1,7 @@
+export { createVariables } from './createVariables'
+export { resolve, resolveRecord } from './resolve'
+export { normalize } from './annotation'
+export * as naming from './naming'
+
+export type { Declaration } from './annotation'
+export type { Request, URIMap } from './Deployment'

package/source/naming.ts

@@ -0,0 +1,11 @@
+export function nameVariable (...segments: string[]): string {
+  return 'TOA_' + segments.join('_')
+    .replaceAll(/[-.]/g, '_')
+    .toUpperCase()
+}
+
+export function nameSecret (...segments: string[]): string {
+  return 'toa-' + segments.join('-')
+    .replaceAll('.', '-')
+    .replace(/--$/, '.default')
+}

package/source/resolve.ts

@@ -0,0 +1,63 @@
+import { dedupe } from '@toa.io/dns'
+import { nameVariable } from './naming'
+import { type AnnotationRecord, type URIMap } from './Deployment'
+
+export async function resolve (id: string, selector: string): Promise<string[]> {
+  const variable = nameVariable(id, selector)
+  const value = process.env[variable]
+
+  if (value === undefined) throw new Error(`${variable} is not set.`)
+
+  let urls = value.split(' ')
+
+  const protocol = getProtocol(urls)
+
+  if (protocol !== 'http:')
+    urls = await dedupe(urls)
+
+  return withCredentials(variable, urls)
+}
+
+export function resolveRecord (uris: URIMap, selector: string): AnnotationRecord {
+  if (selector in uris) return getRecord(uris, selector)
+
+  const segments = selector.split('.')
+
+  while (segments.pop() !== undefined) {
+    const current = segments.join('.')
+
+    if (current in uris) return getRecord(uris, current)
+  }
+
+  if ('.' in uris) return getRecord(uris, '.')
+  else throw new Error(`Selector '${selector}' cannot be resolved.`)
+}
+
+function withCredentials (variable: string, urls: string[]): string[] {
+  const username = process.env[variable + '_USERNAME'] ?? ''
+  const password = process.env[variable + '_PASSWORD'] ?? ''
+
+  return urls.map((url) => addCredentials(url, username, password))
+}
+
+function addCredentials (ref: string, username: string, password: string): string {
+  const url = new URL(ref)
+
+  url.username = username
+  url.password = password
+
+  return url.href
+}
+
+function getProtocol (urls: string[]): string {
+  const url = new URL(urls[0])
+
+  return url.protocol
+}
+
+function getRecord (uris: URIMap, key: string): AnnotationRecord {
+  return {
+    key,
+    references: uris[key]
+  }
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./transpiled"
+  },
+  "include": [
+    "source"
+  ],
+  "exclude": [
+    "**/*.test.ts"
+  ]
+}

package/source/.deployment/.variables/credentials.js

@@ -1,35 +0,0 @@
-'use strict'
-
-const { concat, letters: { up, down } } = require('@toa.io/generic')
-
-/**
- * @param {string} prefix
- * @param {toa.pointer.URIs} uris
- * @returns {toa.deployment.dependency.Variable[]}
- */
-const credentials = (prefix, uris) => {
-  const variables = []
-
-  for (const key of Object.keys(uris)) {
-    const [namespace, name] = key.split('.')
-    const entry = namespace + concat('-', name)
-
-    const env = `TOA_${up(prefix)}_${up(entry)}_`
-    const sec = `toa-${down(prefix)}-${down(entry)}`
-
-    for (const property of ['username', 'password']) {
-      const name = env + up(property)
-
-      const secret = {
-        name: sec,
-        key: property
-      }
-
-      variables.push({ name, secret })
-    }
-  }
-
-  return variables
-}
-
-exports.credentials = credentials

package/source/.deployment/.variables/index.js

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

package/source/.deployment/.variables/pointer.js

@@ -1,18 +0,0 @@
-'use strict'
-
-const { encode, letters: { up } } = require('@toa.io/generic')
-
-/**
- * @param {string} prefix
- * @param {toa.pointer.URIs} uris
- * @returns {toa.deployment.dependency.Variable}
- */
-const pointer = (prefix, uris) => {
-  const name = `TOA_${up(prefix)}_POINTER`
-  const json = JSON.stringify(uris)
-  const value = encode(json)
-
-  return { name, value }
-}
-
-exports.pointer = pointer

package/source/.deployment/index.js

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

package/source/.deployment/validate.js

@@ -1,19 +0,0 @@
-'use strict'
-
-/**
- * @param {toa.pointer.URIs} uris
- */
-const validate = (uris) => {
-  Object.values(uris).forEach(check)
-}
-
-/**
- * @param {string} uri
- */
-const check = (uri) => {
-  const url = new URL(uri)
-
-  if (url.hostname === '') throw new Error(`URI ${url.href} must contain a hostname`)
-}
-
-exports.validate = validate

package/source/.deployment/variables.js

@@ -1,22 +0,0 @@
-'use strict'
-
-const declare = require('./.variables')
-
-/**
- * @param {toa.pointer.URIs} uris
- * @param {string} prefix
- * @returns {toa.deployment.dependency.Variable[]}
- */
-const variables = (uris, prefix) => {
-  /** @type {toa.deployment.dependency.Variable[]} */
-  const variables = []
-  const pointer = declare.pointer(prefix, uris)
-  const credentials = declare.credentials(prefix, uris)
-
-  variables.push(pointer)
-  variables.push(...credentials)
-
-  return variables
-}
-
-exports.variables = variables

package/source/.pointer/env.js

@@ -1,44 +0,0 @@
-'use strict'
-
-const { concat, decode, letters: { up, capitalize } } = require('@toa.io/generic')
-const { console } = require('@toa.io/console')
-
-const { resolve } = require('../uris')
-
-/**
- * @param {string} prefix
- * @param {toa.core.Locator} locator
- */
-const env = (prefix, locator) => {
-  const key = `TOA_${up(prefix)}_POINTER`
-  const value = process.env[key]
-
-  if (value === undefined) throw new Error(`Environment variable ${key} is not set`)
-
-  const uris = decode(value)
-  const { url, entry } = resolve(locator, uris)
-
-  const suffix = convert(entry)
-  const env = `TOA_${up(prefix)}_${suffix}`
-
-  for (const property of ['username', 'password']) {
-    const value = process.env[env + '_' + up(property)]
-
-    if (value !== undefined) url[property] = value
-    else console.warn(`${capitalize(property)} for ${env} is not set`)
-  }
-
-  return url
-}
-
-/**
- * @param {string} entry
- * @returns {string}
- */
-const convert = (entry) => {
-  const [namespace, name] = entry.toUpperCase().split('.')
-
-  return namespace + concat('_', name)
-}
-
-exports.env = env

package/source/.pointer/index.js

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

package/source/.pointer/label.js

@@ -1,15 +0,0 @@
-'use strict'
-
-/**
- * @param {URL} url
- * @returns {string}
- */
-const label = (url) => {
-  const safe = new URL(url.href)
-
-  safe.password = ''
-
-  return safe.href
-}
-
-exports.label = label

package/source/.pointer/local.js

@@ -1,17 +0,0 @@
-'use strict'
-
-/**
- * @param {string} protocol
- * @returns {URL}
- */
-const local = (protocol) => {
-  const url = new URL(protocol + '//')
-
-  url.hostname = 'localhost'
-  url.username = 'developer'
-  url.password = 'secret'
-
-  return url
-}
-
-exports.local = local

package/source/deployment.js

@@ -1,17 +0,0 @@
-'use strict'
-
-const get = require('./.deployment')
-
-/** @type {toa.pointer.Deployment} */
-const deployment = (instances, uris, options) => {
-  if (typeof uris === 'string') uris = { default: uris }
-
-  get.validate(uris)
-
-  const global = get.variables(uris, options.prefix)
-  const variables = { global }
-
-  return { variables }
-}
-
-exports.deployment = deployment

package/source/index.js

@@ -1,11 +0,0 @@
-'use strict'
-
-const { Pointer } = require('./pointer')
-const { deployment } = require('./deployment')
-const { variable } = require('./variable')
-
-exports.uris = require('./uris')
-
-exports.Pointer = Pointer
-exports.deployment = deployment
-exports.variable = variable

package/source/pointer.js

@@ -1,34 +0,0 @@
-'use strict'
-
-const get = require('./.pointer')
-
-class Pointer {
-  protocol
-  host
-  port
-  hostname
-  path
-  reference
-  label
-
-  /**
-   * @param {string} prefix
-   * @param {toa.core.Locator} locator
-   * @param {toa.pointer.Options} options
-   */
-  constructor (prefix, locator, options) {
-    const dev = process.env.TOA_DEV === '1'
-    const url = dev ? get.local(options.protocol) : get.env(prefix, locator)
-
-    this.protocol = url.protocol
-    this.hostname = url.hostname
-    this.port = Number(url.port)
-    this.path = url.pathname
-    this.username = url.username
-    this.password = url.password
-    this.reference = url.href
-    this.label = get.label(url)
-  }
-}
-
-exports.Pointer = Pointer

package/source/uris/construct.js

@@ -1,18 +0,0 @@
-'use strict'
-
-const { normalize } = require('./normalize')
-const { validate } = require('./validate')
-
-/**
- * @param {toa.pointer.URIs | string} declaration
- * @returns {toa.pointer.URIs}
- */
-const construct = (declaration) => {
-  const normalized = normalize(declaration)
-
-  validate(normalized)
-
-  return normalized
-}
-
-exports.construct = construct

package/source/uris/index.js

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

package/source/uris/normalize.js

@@ -1,12 +0,0 @@
-'use strict'
-
-/**
- * @param {toa.pointer.URIs | string} declaration
- * @returns {toa.pointer.URIs}
- */
-const normalize = (declaration) => {
-  if (typeof declaration === 'string') return { default: declaration }
-  return declaration
-}
-
-exports.normalize = normalize

package/source/uris/resolve.js

@@ -1,18 +0,0 @@
-'use strict'
-
-/** @type {toa.pointer.uris.Resolver} */
-const resolve = (locator, uris) => {
-  const keys = [locator.id, locator.namespace, 'default']
-  const entry = keys.find((key) => key in uris)
-  const uri = uris[entry]
-
-  if (entry === undefined) throw new Error(`URI annotation for '${locator.id}' is not found`)
-
-  const url = new URL(uri)
-
-  if (url.hostname === '') throw new Error(`URI annotation for '${locator.id}' must contain a hostname`)
-
-  return { url, entry }
-}
-
-exports.resolve = resolve

package/source/uris/schema.yaml

@@ -1,17 +0,0 @@
-$schema: https://json-schema.org/draft/2019-09/schema
-
-definitions:
-  node:
-    oneOf:
-      - $ref: '#/definitions/locator'
-      - type: object
-        patternProperties:
-          '.*':
-            $ref: '#/definitions/node'
-  locator:
-    type: string
-
-type: object
-patternProperties:
-  '.*':
-    $ref: '#/definitions/node'

package/source/uris/validate.js

@@ -1,17 +0,0 @@
-'use strict'
-
-const path = require('path')
-
-const schemas = require('@toa.io/schemas')
-const { load } = require('@toa.io/yaml')
-
-const cos = load.sync(path.resolve(__dirname, 'schema.yaml'))
-const schema = schemas.schema(cos)
-
-const validate = (declaration) => {
-  const error = schema.fit(declaration)
-
-  if (error) throw new TypeError(error.message)
-}
-
-exports.validate = validate

package/source/variable.js

@@ -1,12 +0,0 @@
-'use strict'
-
-const { letters: { up } } = require('@toa.io/generic')
-
-/** @type {toa.pointer.Variable} */
-const variable = (scope, locator, label, value) => {
-  const name = `TOA_${up(scope)}_${locator.uppercase}_${up(label)}`
-
-  return { name, value }
-}
-
-exports.variable = variable

package/test/deployment.test.js

@@ -1,92 +0,0 @@
-'use strict'
-
-const { encode, letters: { up, down } } = require('@toa.io/generic')
-const mock = require('@toa.io/mock')
-
-const { deployment } = require('../')
-
-const prefix = 'foo-bar'
-
-/** @type {toa.norm.context.dependencies.Instance[]} */
-let instances
-
-/** @type {toa.pointer.deployment.Options} */
-let options
-
-beforeEach(() => {
-  instances = mock.dependencies.instances()
-  options = { prefix }
-})
-
-it('should be', () => {
-  expect(deployment).toBeInstanceOf(Function)
-})
-
-it('should throw if protocol is omitted', () => {
-  const annotation = { default: 'no-protocol' }
-
-  expect(() => deployment(instances, annotation, options)).toThrow('Invalid URL')
-})
-
-it('should throw if hostname is omitted', () => {
-  const annotation = { default: 'amqps:///' }
-
-  expect(() => deployment(instances, annotation, options)).toThrow('must contain a hostname')
-})
-
-it('should consider string annotation as default', () => {
-  const annotation = 'pg://host0'
-
-  const output = deployment(instances, annotation, options)
-
-  const name = `TOA_${up(prefix)}_POINTER`
-  const value = encode({ default: annotation })
-
-  expect(output.variables.global).toStrictEqual(expect.arrayContaining([{ name, value }]))
-})
-
-describe('variables', () => {
-  it('should export POINTER variable', () => {
-    const annotation = { default: 'amqps://host0' }
-    const json = JSON.stringify(annotation)
-    const value = encode(json)
-    const output = deployment(instances, annotation, options)
-
-    expect(output.variables.global).toStrictEqual(expect.arrayContaining([{
-      name: `TOA_${up(prefix)}_POINTER`,
-      value
-    }]))
-  })
-
-  it('should export USERNAME and PASSWORD for each entry of URI Set', () => {
-    const annotation = {
-      default: 'amqps://host0',
-      system: 'amqps://host2',
-      dummies: 'amqps://host3',
-      'dummies.one': 'amqps://host4'
-    }
-
-    const expected = []
-
-    const env = `TOA_${up(prefix)}_`
-    const sec = `toa-${down(prefix)}-`
-
-    for (const key of Object.keys(annotation)) {
-      const label = key.replaceAll('.', '-').toLowerCase()
-
-      for (const property of ['username', 'password']) {
-        expected.push({
-          name: `${env}${up(label)}_${up(property)}`,
-          secret: {
-            name: `${sec}${down(label)}`,
-            key: property
-          }
-        })
-      }
-    }
-
-    const output = deployment(instances, annotation, options)
-
-    expect(output.variables.global).toStrictEqual(expect.arrayContaining(expected))
-  })
-})