@toa.io/definitions 1.0.0-alpha.288

package/schemas/extensions.configuration/manifest.cos.yaml

@@ -0,0 +1,9 @@
+properties:
+  schema:
+    type: object
+  defaults:
+    type: object
+additionalProperties: false
+type: object
+required:
+  - schema

package/schemas/extensions.exposition/annotation.cos.yaml

@@ -0,0 +1,125 @@
+properties:
+  class:
+    type: string
+  resources:
+    # `null` deploys the service without any, which every deployment has to state one way
+    # or the other — see `migrations/262.md`.
+    type: object
+    nullable: true
+    properties:
+      cpu:
+        type: array
+        items:
+          type: string
+        minItems: 2
+        maxItems: 2
+      memory:
+        type: array
+        items:
+          type: string
+        minItems: 2
+        maxItems: 2
+  annotations:
+    type: object
+    patternProperties:
+      ^.+$:
+        type: string
+  service:
+    type: object
+    properties:
+      annotations:
+        type: object
+        patternProperties:
+          ^.+$:
+            type: string
+  debug:
+    type: boolean
+  ip:
+    type: string
+    minLength: 1
+  bouncer:
+    type: object
+    properties:
+      attempts:
+        type: integer
+        minimum: 1
+      interval:
+        type: integer
+        minimum: 1
+    additionalProperties: false
+  protocol:
+    type: string
+    enum: [h1, h2c]
+  oauth:
+    type: object
+    properties:
+      authorize:
+        description: The absolute URL of the consent page the application serves
+        type: string
+        pattern: ^https?://
+      resources:
+        description: Paths a token may be restricted to
+        type: array
+        items:
+          type: string
+          pattern: ^/
+      scopes:
+        type: array
+        items:
+          type: string
+      trust:
+        description: Origins whose Client ID Metadata Documents may be read
+        type: array
+        items:
+          type: string
+          pattern: ^https://
+      registration:
+        type: string
+        enum: [open, closed]
+    required:
+      - authorize
+    additionalProperties: false
+  rpc:
+    description: JSON-RPC at `/.rpc`; writing it is what turns the endpoint on
+    type: object
+    properties:
+      batch:
+        description: Calls one request may carry
+        type: integer
+        minimum: 1
+    additionalProperties: false
+  mcp:
+    description: MCP at `/.mcp`; writing it is what turns the endpoint on
+    type: object
+    properties:
+      name:
+        description: What the server calls itself
+        type: string
+        minLength: 1
+      instructions:
+        description: What a model is told before it calls anything here
+        type: string
+      origins:
+        description: Browser origins the endpoint answers; none without it
+        type: array
+        items:
+          type: string
+          pattern: ^https?://
+      anonymous:
+        description: Whether the endpoint answers without a credential
+        type: boolean
+    required:
+      - name
+    additionalProperties: false
+  /: {}
+  authorities:
+    type: object
+    patternProperties:
+      ^.+$:
+        type: string
+type: object
+required:
+  - authorities
+dependencies:
+  bouncer:
+    - ip

package/schemas/extensions.exposition/call.cos.yaml

@@ -0,0 +1,18 @@
+description: One JSON-RPC call, as the envelope carries it
+properties:
+  jsonrpc:
+    const: '2.0'
+  method:
+    type: string
+    minLength: 1
+  params:
+    description: By name only, because `io:input` validates an object
+    type: object
+  id:
+    description: Absent makes the call a notification, which answers nothing
+    type: [string, number]
+required:
+  - jsonrpc
+  - method
+additionalProperties: false
+type: object

package/schemas/extensions.exposition/directive.cos.yaml

@@ -0,0 +1,7 @@
+properties:
+  family:
+    type: string
+  name:
+    type: string
+  value: {}
+type: object

package/schemas/extensions.exposition/method.cos.yaml

@@ -0,0 +1,23 @@
+properties:
+  verb:
+    type: string
+    pattern: ^(GET|HEAD|POST|PUT|PATCH|DELETE|LOCK|UNLOCK)$
+  mapping:
+    properties:
+      namespace:
+        type: string
+      component:
+        type: string
+      endpoint:
+        type: string
+      query:
+        $ref: query
+      paged:
+        type: boolean
+    additionalProperties: false
+    type: object
+  directives:
+    type: array
+    items:
+      $ref: directive
+type: object

package/schemas/extensions.exposition/node.cos.yaml

@@ -0,0 +1,22 @@
+properties:
+  protected:
+    type: boolean
+  isolated:
+    type: boolean
+  forward:
+    type: string
+  routes:
+    type: array
+    items:
+      $ref: route
+  methods:
+    type: array
+    items:
+      $ref: method
+  directives:
+    type: array
+    items:
+      $ref: directive
+  version:
+    type: string
+type: object

package/schemas/extensions.exposition/query.cos.yaml

@@ -0,0 +1,31 @@
+properties:
+  id:
+    type: string
+  criteria:
+    type: string
+  sort:
+    type: string
+  search:
+    type: boolean
+  sample:
+    type: integer
+  omit:
+    $ref: range
+  limit:
+    $ref: range
+  selectors:
+    type: array
+    items:
+      type: string
+  projection:
+    type: array
+    items:
+      type: string
+  parameters:
+    type: array
+    items:
+      type: string
+  deleted:
+    type: boolean
+nullable: true
+type: object

package/schemas/extensions.exposition/querystring.cos.yaml

@@ -0,0 +1,19 @@
+properties:
+  id:
+    type: string
+  criteria:
+    type: string
+  search:
+    type: string
+  sample:
+    type: number
+  sort:
+    type: string
+  omit:
+    type: number
+  limit:
+    type: number
+  version:
+    type: number
+additionalProperties: false
+type: object

package/schemas/extensions.exposition/range.cos.yaml

@@ -0,0 +1,10 @@
+properties:
+  range:
+    type: array
+    items:
+      type: number
+  value:
+    type: number
+type: object
+required:
+  - range

package/schemas/extensions.exposition/route.cos.yaml

@@ -0,0 +1,6 @@
+properties:
+  path:
+    type: string
+  node:
+    $ref: node
+type: object

package/schemas/extensions.introspection/annotation.cos.yaml

@@ -0,0 +1,31 @@
+# context.toa.yaml introspection annotation
+properties:
+  samples:
+    type: boolean
+  interval:
+    type: integer
+    minimum: 1
+  threshold:
+    type: integer
+    minimum: 1
+  ui:
+    type: boolean
+  resources:
+    # `null` deploys the service without any, which every deployment has to state one way
+    # or the other — see `migrations/262.md`.
+    type: object
+    nullable: true
+    properties:
+      cpu:
+        type: array
+        items:
+          type: string
+        minItems: 2
+        maxItems: 2
+      memory:
+        type: array
+        items:
+          type: string
+        minItems: 2
+        maxItems: 2
+type: object

package/schemas/extensions.introspection/declaration.cos.yaml

@@ -0,0 +1,5 @@
+# manifest.toa.yaml introspection declaration
+properties:
+  samples:
+    type: boolean
+type: object

package/schemas/extensions.storages/annotation.cos.yaml

@@ -0,0 +1,11 @@
+type: object
+patternProperties:
+  ^[a-z0-9_]{1,32}$:
+    oneOf:
+      - $ref: s3
+      - $ref: spaces
+      - $ref: cloudinary
+      - $ref: fs
+      - $ref: tmp
+      - $ref: test
+additionalProperties: false

package/schemas/extensions.storages/cloudinary.cos.yaml

@@ -0,0 +1,38 @@
+type: object
+properties:
+  provider:
+    const: cloudinary
+  environment:
+    type: string
+  type:
+    enum:
+      - image
+      - video
+  prefix:
+    type: string
+  eager:
+    type: array
+    items:
+      type: object
+  transformations:
+    type: array
+    items:
+      type: object
+      properties:
+        extension:
+          type: string
+        transformation:
+          anyOf:
+            - type: object
+            - type: array
+              items:
+                type: object
+        optional:
+          type: boolean
+      required:
+        - extension
+        - transformation
+required:
+  - environment
+  - type
+additionalProperties: false

package/schemas/extensions.storages/fs.cos.yaml

@@ -0,0 +1,13 @@
+type: object
+properties:
+  provider:
+    const: fs
+  path:
+    type: string
+    maxLength: 4096
+  claim:
+    type: string
+required:
+  - provider
+  - path
+additionalProperties: false

package/schemas/extensions.storages/s3.cos.yaml

@@ -0,0 +1,17 @@
+type: object
+properties:
+  provider:
+    const: s3
+  bucket:
+    type: string
+    minLength: 3
+    maxLength: 63
+  region:
+    type: string
+  endpoint:
+    type: string
+    format: uri
+required:
+  - provider
+  - bucket
+additionalProperties: false

package/schemas/extensions.storages/spaces.cos.yaml

@@ -0,0 +1,16 @@
+type: object
+properties:
+  provider:
+    const: spaces
+  space:
+    type: string
+    minLength: 3
+    maxLength: 63
+  region:
+    type: string
+    minLength: 1
+required:
+  - provider
+  - space
+  - region
+additionalProperties: false

package/schemas/extensions.storages/test.cos.yaml

@@ -0,0 +1,10 @@
+type: object
+properties:
+  provider:
+    const: test
+  directory:
+    type: string
+required:
+  - provider
+  - directory
+additionalProperties: false

package/schemas/extensions.storages/tmp.cos.yaml

@@ -0,0 +1,10 @@
+type: object
+properties:
+  provider:
+    const: tmp
+  directory:
+    type: string
+required:
+  - provider
+  - directory
+additionalProperties: false

package/source/bindings.amqp/annotation.ts

@@ -0,0 +1,26 @@
+import * as pointer from '@toa.io/pointer'
+import { type URIMap } from '@toa.io/pointer'
+
+export function normalize(declaration: string | Declaration): Annotation {
+  const annotation = expand(declaration)
+  const context = pointer.normalize(annotation.context)
+  const sources = pointer.normalize(annotation.sources)
+
+  return { context, sources }
+}
+
+function expand(declaration: string | Declaration): Declaration {
+  if (typeof declaration === 'string') return { context: { '.': [declaration] } }
+  else if (Array.isArray(declaration)) return { context: { '.': declaration } }
+  else return declaration
+}
+
+export interface Annotation {
+  context: URIMap
+  sources?: URIMap
+}
+
+export interface Declaration {
+  context: string | Record<string, string | string[]>
+  sources?: Record<string, string | string[]>
+}

package/source/bindings.amqp/context.ts

@@ -0,0 +1,68 @@
+import { type Dependency, type Variable } from '@toa.io/operations'
+import { naming } from '@toa.io/pointer'
+import { type Annotation } from './annotation.js'
+
+export function createDependency(context: Context): Dependency {
+  const global: Variable[] = []
+  const variables = { global }
+
+  const contextVariables = createVariables(context)
+
+  global.push(...contextVariables)
+
+  return { variables }
+}
+
+function createVariables(context: Context): Variable[] {
+  const variables: Variable[] = []
+  const uris = JSON.stringify(context)
+
+  const contextVariable: Variable = {
+    name: VARIABLE,
+    value: uris
+  }
+
+  const secrets = createSecrets(context)
+
+  variables.push(contextVariable, ...secrets)
+
+  return variables
+}
+
+function createSecrets(context: Context): Variable[] {
+  const secrets: Variable[] = []
+
+  for (const key of Object.keys(context)) {
+    const keySecrets = createKeySecrets(key)
+
+    secrets.push(...keySecrets)
+  }
+
+  return secrets
+}
+
+function createKeySecrets(key: string): Variable[] {
+  const username = createSecretVariable(key, 'username')
+  const password = createSecretVariable(key, 'password')
+
+  return [username, password]
+}
+
+function createSecretVariable(key: string, secretKey: string): Variable {
+  const varKey = key === '.' ? '' : key
+  const varName = naming.nameVariable(ID, varKey, secretKey.toUpperCase())
+  const secName = naming.nameSecret(ID, key)
+
+  return {
+    name: varName,
+    secret: {
+      name: secName,
+      key: secretKey
+    }
+  }
+}
+
+export const ID = 'amqp-context'
+export const VARIABLE = 'TOA_AMQP_CONTEXT'
+
+type Context = Annotation['context']

package/source/bindings.amqp/deployment.ts

@@ -0,0 +1,14 @@
+import { type Dependency } from '@toa.io/operations'
+import { merge } from '@toa.io/generic'
+import { type Declaration, normalize } from './annotation.js'
+import * as sources from './sources.js'
+import * as context from './context.js'
+import { type Instance } from './instance.js'
+
+export function deployment(instances: Instance[], declaration: Declaration): Dependency {
+  const annotation = normalize(declaration)
+  const contextDependency = context.createDependency(annotation.context)
+  const sourcesDependency = sources.createDependency(annotation.sources, instances)
+
+  return merge(contextDependency, sourcesDependency)
+}

package/source/bindings.amqp/index.ts

@@ -0,0 +1,9 @@
+import type { bindings } from '@toa.io/core/types'
+
+export const properties: bindings.Properties = { async: true }
+
+export { deployment } from './deployment.js'
+export { ID as CONTEXT, VARIABLE as CONTEXT_VARIABLE } from './context.js'
+export { ID as SOURCES } from './sources.js'
+
+export type { Annotation, Declaration } from './annotation.js'

package/source/bindings.amqp/instance.ts

@@ -0,0 +1,3 @@
+import { type context } from '@toa.io/norm'
+
+export type Instance = context.Dependency

package/source/bindings.amqp/sources.ts

@@ -0,0 +1,39 @@
+import { createVariables, type Request } from '@toa.io/pointer'
+import { type Manifest } from '@toa.io/norm'
+import { type Dependency } from '@toa.io/operations'
+import { type Instance } from './instance.js'
+import { type Annotation } from './annotation.js'
+
+export function createDependency(sources: Sources, instances: Instance[]): Dependency {
+  const requests = []
+
+  for (const instance of instances) {
+    const request = createRequest(instance)
+
+    if (request !== null) requests.push(request)
+  }
+
+  const variables = createVariables(ID, sources, requests)
+
+  return { variables }
+}
+
+function createRequest(instance: Instance): Request | null {
+  const group = instance.locator.label
+  const selectors = createSelectors(instance.component)
+
+  if (selectors === null) return null
+  else return { group, selectors }
+}
+
+function createSelectors(component: Manifest): string[] | null {
+  if (component.receivers === undefined) return null
+
+  const sources = Object.values(component.receivers).map((receiver) => receiver.source)
+
+  return sources.filter((source) => source !== undefined) as string[]
+}
+
+export const ID = 'amqp-sources'
+
+type Sources = Annotation['sources']

package/source/bindings.loop/index.ts

@@ -0,0 +1,3 @@
+import type { bindings } from '@toa.io/core/types'
+
+export const properties: bindings.Properties = { async: false, local: true }

package/source/bridges.bash/const.ts

@@ -0,0 +1,2 @@
+export const DIR = 'operations'
+export const EXT = '.sh'

package/source/bridges.bash/define.ts

@@ -0,0 +1,38 @@
+import * as fs from 'node:fs/promises'
+import { join, extname } from 'node:path'
+import { DIR, EXT } from './const.js'
+import type { component } from '@toa.io/norm'
+
+export async function operations(root: string): Promise<component.Operations> {
+  const path = join(root, DIR)
+  const names = await list(path)
+
+  const promises = names.map(async (name) => operation(root, name))
+
+  const operations = await Promise.all(promises)
+
+  return operations.reduce<component.Operations>((acc, operation, index) => {
+    acc[names[index]] = operation
+
+    return acc
+  }, {})
+}
+
+export async function operation(
+  root: string,
+  name: string
+): Promise<component.Operation> {
+  const path = join(root, DIR, name + EXT)
+
+  await fs.access(path, fs.constants.F_OK)
+
+  return { type: 'computation' }
+}
+
+async function list(path: string): Promise<string[]> {
+  const files = await fs.readdir(path)
+
+  return files
+    .filter((file) => extname(file) === EXT)
+    .map((file) => file.slice(0, -EXT.length))
+}

package/source/bridges.bash/index.ts

@@ -0,0 +1,2 @@
+export * as define from './define.js'
+export { DIR, EXT } from './const.js'