@toa.io/extensions.exposition 0.24.0-alpha.9 → 1.0.0-alpha.10

package/source/directives/octets/workflows/Execution.ts

@@ -0,0 +1,76 @@
+import { Readable } from 'stream'
+import type { Unit } from './Workflow'
+import type { Remotes } from '../../../Remotes'
+import type { Component } from '@toa.io/core'
+import type { Maybe } from '@toa.io/types'
+import type { Entry } from '@toa.io/extensions.storages'
+
+export class Execution extends Readable {
+  private readonly units: Unit[]
+  private readonly remotes: Remotes
+  private readonly context: Context
+  private readonly components: Record<string, Component> = {}
+  private readonly discovery: Record<string, Promise<Component>> = {}
+  private interrupted = false
+
+  public constructor (context: Context, units: Unit[], remotes: Remotes) {
+    super({ objectMode: true })
+
+    this.context = context
+    this.units = units
+    this.remotes = remotes
+
+    void this.run()
+  }
+
+  public override _read (): void {
+  }
+
+  private async run (): Promise<void> {
+    for (const unit of this.units) {
+      await this.execute(unit)
+
+      if (this.interrupted)
+        break
+    }
+
+    this.push(null)
+  }
+
+  private async execute (unit: Unit): Promise<void> {
+    const promises = Object.entries(unit).map(async ([step, endpoint]) => {
+      const result = await this.call(endpoint).catch((error: Error) => console.error(error))
+
+      if (result instanceof Error) {
+        this.push({ error: { step, ...result } })
+        this.interrupted = true
+      } else
+        this.push({ [step]: result ?? null })
+    })
+
+    await Promise.all(promises)
+  }
+
+  private async call (endpoint: string): Promise<Maybe<unknown>> {
+    const [operation, component, namespace = 'default'] = endpoint.split('.').reverse()
+    const key = `${namespace}.${component}`
+
+    this.components[key] ??= await this.discover(key, namespace, component)
+
+    return await this.components[key].invoke(operation, { input: this.context })
+  }
+
+  private async discover (key: string, namespace: string, component: string): Promise<Component> {
+    if (this.discovery[key] === undefined)
+      this.discovery[key] = this.remotes.discover(namespace, component)
+
+    return await this.discovery[key]
+  }
+}
+
+export interface Context {
+  storage: string
+  path: string
+  entry: Entry
+  parameters: Record<string, string>
+}

package/source/directives/octets/workflows/Workflow.ts

@@ -0,0 +1,37 @@
+import { posix } from 'node:path'
+import { match } from 'matchacho'
+import { Execution } from './Execution'
+import type { Context } from './Execution'
+import type { Parameter } from '../../../RTD'
+import type { Input } from '../types'
+import type { Entry } from '@toa.io/extensions.storages'
+import type { Remotes } from '../../../Remotes'
+
+export class Workflow {
+  private readonly units: Unit[]
+  private readonly remotes: Remotes
+
+  public constructor (units: Unit[] | Unit, remotes: Remotes) {
+    this.units = match<Unit[]>(units,
+      Array, (units: Unit[]) => units,
+      Object, (unit: Unit) => [unit])
+
+    this.remotes = remotes
+  }
+
+  // eslint-disable-next-line max-params
+  public execute
+  (input: Input, storage: string, entry: Entry, params: Parameter[]): Execution {
+    const path = posix.join(input.request.url, entry.id)
+    const parameters: Record<string, string> = {}
+
+    for (const { name, value } of params)
+      parameters[name] = value
+
+    const context: Context = { storage, path, entry, parameters }
+
+    return new Execution(context, this.units, this.remotes)
+  }
+}
+
+export type Unit = Record<string, string>

package/source/directives/octets/workflows/index.ts

@@ -0,0 +1 @@
+export { Workflow, type Unit } from './Workflow'

package/source/directives/vary/Directive.ts

@@ -0,0 +1,6 @@
+import type { Properties } from './Properties'
+import type { Input } from '../../io'
+
+export interface Directive {
+  preflight: (request: Input, properties: Properties) => void
+}

package/source/directives/vary/Embed.ts

@@ -0,0 +1,62 @@
+import assert from 'node:assert'
+import { Header, embeddings } from './embeddings'
+import type { Embedding } from './embeddings'
+import type { Input } from '../../io'
+import type { Directive } from './Directive'
+import type { Properties } from './Properties'
+
+export class Embed implements Directive {
+  private readonly embeddings: Array<[string, Embedding[]]> = []
+
+  public constructor (map: Record<string, string | string[]>) {
+    for (const [key, values] of Object.entries(map)) {
+      const names = Array.isArray(values) ? values : [values]
+
+      const instances = names.map((name) => {
+        if (name[0] === ':')
+          return new Header(name.slice(1))
+
+        assert.ok(name in embeddings, `Unknown embedding: ${name}`)
+
+        return new embeddings[name]()
+      })
+
+      this.embeddings.push([key, instances])
+    }
+  }
+
+  public preflight (input: Input, properties: Properties): void {
+    const values: Record<string, unknown> = {}
+
+    for (const [key, instances] of this.embeddings)
+      values[key] = this.resolve(instances, input, properties)
+
+    input.pipelines.body.push(this.embedding(values))
+  }
+
+  private resolve (instances: Embedding[], input: Input, properties: Properties): unknown {
+    let value
+
+    for (const instance of instances) {
+      value = instance.resolve(input, properties)
+
+      if (value !== undefined)
+        break
+    }
+
+    assert.ok(value !== undefined, 'Neither embedding resolved a value.')
+
+    return value
+  }
+
+  private embedding (values: Record<string, unknown>) {
+    return (body: unknown): object => {
+      if (body === undefined || body === null || typeof body !== 'object')
+        return values
+
+      Object.assign(body, values)
+
+      return body
+    }
+  }
+}

package/source/directives/vary/Properties.ts

@@ -0,0 +1,17 @@
+export interface Properties {
+  languages?: string[]
+}
+
+export class Property<K extends keyof Properties = keyof Properties> {
+  public readonly name: K
+  public readonly value: Properties[K]
+
+  public constructor (name: K, value: Properties[K]) {
+    this.name = name
+    this.value = value
+  }
+}
+
+export const properties: Properties = {
+  languages: []
+}

package/source/directives/vary/Vary.ts

@@ -0,0 +1,48 @@
+import { match } from 'matchacho'
+import { properties, Property } from './Properties'
+import { Embed } from './Embed'
+import type { Properties } from './Properties'
+import type { Directive } from './Directive'
+import type { DirectiveFamily } from '../../RTD'
+import type { Input, Output } from '../../io'
+
+export class Vary implements DirectiveFamily {
+  public readonly name = 'vary'
+  public readonly mandatory = false
+
+  public create (name: string, value: unknown): Property | Directive {
+    return match(name,
+      () => name in properties, (name: PN) => new Property(name, value as PV),
+      () => name in directives, (name: keyof typeof directives) => new directives[name](value),
+      () => {
+        throw new Error(`Unknown directive 'vary:${name}'`)
+      })
+  }
+
+  public preflight (instances: Array<Directive | Property>, request: Input): Output {
+    /*
+    To stop constructing `properties` object on each request, Directive Families must be refactored
+    from singleton factories to per-Node instances on the Tree.
+     */
+    const properties: Properties = {}
+    const directives: Directive[] = []
+
+    for (const instance of instances)
+      if (instance instanceof Property)
+        properties[instance.name] = instance.value
+      else
+        directives.push(instance)
+
+    for (const directive of directives)
+      directive.preflight(request, properties)
+
+    return null
+  }
+}
+
+type PN = keyof Properties
+type PV = Properties[PN]
+
+const directives: Record<string, new (value: any) => Directive> = {
+  embed: Embed
+}

package/source/directives/vary/embeddings/Embedding.ts

@@ -0,0 +1,6 @@
+import type { Properties } from '../Properties'
+import type { Input } from '../../../io'
+
+export interface Embedding {
+  resolve: (input: Input, properties: Properties) => string | undefined
+}

package/source/directives/vary/embeddings/Header.ts

@@ -0,0 +1,32 @@
+import { cors } from '../../cors'
+import type { Input } from '../../../io'
+import type { Embedding } from './Embedding'
+
+export class Header implements Embedding {
+  private readonly name: string
+
+  public constructor (name: string) {
+    this.name = name.toLowerCase()
+
+    if (this.name !== 'host')
+      cors.allow(this.name)
+  }
+
+  public resolve (input: Input): string | undefined {
+    const value = input.request.headers[this.name]
+
+    if (value === undefined)
+      return value
+
+    if (this.name !== 'host')
+      input.pipelines.response.push((response) => {
+        response.headers ??= new Headers()
+        response.headers.append('vary', this.name)
+      })
+
+    if (Array.isArray(value))
+      return value.join(', ')
+    else
+      return value
+  }
+}

package/source/directives/vary/embeddings/Language.ts

@@ -0,0 +1,31 @@
+import assert from 'node:assert'
+import Negotiator from 'negotiator'
+import { cors } from '../../cors'
+import type { Properties } from '../Properties'
+import type { Embedding } from './Embedding'
+import type { Input } from '../../../io'
+
+export class Language implements Embedding {
+  public constructor () {
+    cors.allow('accept-language')
+  }
+
+  public resolve (input: Input, properties: Properties): string | undefined {
+    assert.ok(properties.languages !== undefined,
+      'Supported languages are not defined. Use `vary:languages` directive.')
+
+    assert.ok(properties.languages.length > 0,
+      'List of supported languages is empty.')
+
+    const negotiator = new Negotiator(input.request)
+    const language = negotiator.language(properties.languages) ?? properties.languages[0]
+
+    input.pipelines.response.push((response) => {
+      response.headers ??= new Headers()
+      response.headers.set('content-language', language)
+      response.headers.append('vary', 'accept-language')
+    })
+
+    return language
+  }
+}

package/source/directives/vary/embeddings/index.ts

@@ -0,0 +1,11 @@
+import { Language } from './Language'
+import { Header } from './Header'
+
+import type { Embedding } from './Embedding'
+
+export const embeddings: Record<string, new () => Embedding> = {
+  language: Language
+}
+
+export { Header }
+export type { Embedding }

package/source/directives/vary/index.ts

@@ -0,0 +1,3 @@
+import { Vary } from './Vary'
+
+export const vary = new Vary()

package/source/exceptions.ts

@@ -1,17 +1,21 @@
 import { type Exception } from '@toa.io/core'
+import { match } from 'matchacho'
 import * as http from './HTTP'
 
 export function rethrow (exception: Exception): void {
   // see /runtime/core/src/exceptions.js
 
-  if ((exception.code >= 200 && exception.code < 210) || exception.code === 221)
-    throw new http.BadRequest(exception.message)
-
-  if (exception.code === 302)
-    throw new http.NotFound()
-
-  if (exception.code === 303)
-    throw new http.PreconditionFailed()
+  throw match<Error>(exception.code,
+    badRequest, () => new http.BadRequest(exception.message),
+    302, NOT_FOUND,
+    303, PRECONDITION_FAILED,
+    306, () => new http.Conflict(exception.message),
+    () => exception)
+}
 
-  throw exception as unknown as Error
+function badRequest (code: number): boolean {
+  return (code >= 200 && code < 210) || code === 221
 }
+
+const NOT_FOUND = new http.NotFound()
+const PRECONDITION_FAILED = new http.PreconditionFailed()

package/source/io.ts

@@ -0,0 +1,4 @@
+import type { Context, OutgoingMessage } from './HTTP'
+
+export type Input = Context
+export type Output = OutgoingMessage | null

package/source/manifest.test.ts

@@ -21,16 +21,8 @@ it('should create branch', async () => {
   const node = manifest(declaration, mf)
 
   expect(node).toBeDefined()
-
-  // namespace route
   expect(node.routes).toHaveLength(1)
-  expect(node.routes[0].path).toBe('/' + namespace)
-
-  const ns = node.routes[0].node
-
-  // component route
-  expect(ns.routes).toHaveLength(1)
-  expect(ns.routes[0].path).toBe('/' + name)
+  expect(node.routes[0].path).toBe('/' + namespace + '/' + name)
 })
 
 it('should not create node for default namespace', async () => {
@@ -43,16 +35,16 @@ it('should not create node for default namespace', async () => {
 })
 
 it('should throw on invalid declaration type', async () => {
-  expect(() => manifest('hello' as unknown as object, mf)).toThrow('RTD parse error')
+  expect(() => manifest('hello' as unknown as object, mf))
+    .toThrow('Exposition declaration must be an object')
 })
 
 it('should set namespace and component', async () => {
   const node = manifest(declaration, mf)
 
-  const ns = node.routes[0].node
-  const cm = ns.routes[0].node
-  const root = cm.routes[0].node
-  const GET = root.methods[0]
+  const root = node.routes[0].node
+  const intemediate = root.routes[0].node
+  const GET = intemediate.methods[0]
 
   expect(GET.mapping?.namespace).toBe(namespace)
   expect(GET.mapping?.component).toBe(name)

package/source/manifest.ts

@@ -1,25 +1,28 @@
+import assert from 'node:assert'
 import { parse, type Node, type Method, type Query } from './RTD/syntax'
 import { shortcuts } from './Directive'
 import * as schemas from './schemas'
 import type { Manifest } from '@toa.io/norm'
 
 export function manifest (declaration: object, manifest: Manifest): Node {
-  declaration = wrap(manifest.name, declaration)
+  assert.ok(typeof declaration === 'object' && declaration !== null,
+    'Exposition declaration must be an object')
 
-  if (manifest.namespace !== undefined && manifest.namespace !== 'default')
-    declaration = wrap(manifest.namespace, declaration)
+  declaration = wrap(declaration, manifest.namespace, manifest.name)
 
   const node = parse(declaration, shortcuts)
 
   concretize(node, manifest)
-
   schemas.node.validate(node)
 
   return node
 }
 
-function wrap (segment: string, declaration: object): object {
-  return { ['/' + segment]: { protected: true, ...declaration } }
+function wrap (declaration: object, namespace: string, name: string): object {
+  const path = (namespace === undefined || namespace === 'default' ? '' : '/' + namespace) +
+    '/' + name
+
+  return { [path]: { protected: true, ...declaration } }
 }
 
 function concretize (node: Node, manifest: Manifest): void {

package/source/root.ts

@@ -25,6 +25,11 @@ const PREDEFINED: syntax.Node = {
                 family: 'auth',
                 name: 'echo',
                 value: null
+              },
+              {
+                family: 'io',
+                name: 'output',
+                value: ['id', 'roles']
               }
             ]
           }

package/source/schemas.ts

@@ -1,9 +1,13 @@
 import { resolve } from 'node:path'
 import schemas from '@toa.io/schemas'
+import type { Query } from './HTTP'
+import type { Node } from './RTD'
+import type { Schema } from '@toa.io/schemas'
+import type { Annotation } from './Annotation'
 
 const path = resolve(__dirname, '../schemas')
 const namespace = schemas.namespace(path)
 
-export const querystring = namespace.schema('querystring')
-export const annotaion = namespace.schema('annotation')
-export const node = namespace.schema('node')
+export const querystring: Schema<Query> = namespace.schema('querystring')
+export const annotaion: Schema<Annotation> = namespace.schema('annotation')
+export const node: Schema<Node> = namespace.schema('node')

package/transpiled/Annotation.d.ts

@@ -3,5 +3,6 @@ export interface Annotation {
     class?: string;
     annotations?: Record<string, string>;
     debug: boolean;
+    trace: boolean;
     '/'?: object;
 }

package/transpiled/Composition.js.map

@@ -1 +1 @@
-{"version":3,"file":"Composition.js","sourceRoot":"","sources":["../source/Composition.ts"],"names":[],"mappings":";;;AAAA,qCAAkD;AAClD,yCAAmC;AACnC,uCAAwC;AAGxC,MAAa,WAAY,SAAQ,gBAAS;IACvB,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;QACpB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAEtD,MAAM,WAAW,CAAC,OAAO,EAAE,CAAA;QAE3B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAEzB,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACvC,CAAC;IAEkB,OAAO;QACxB,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAChD,CAAC;CACF;AAtBD,kCAsBC;AAED,SAAS,IAAI;IACX,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED,SAAS,OAAO;IACd,MAAM,OAAO,GAAG,IAAA,qBAAW,EAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAE1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;AACvD,CAAC;AAED,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QACzC,KAAK,CAAC,IAAI,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;KACtC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC1B,CAAC;AAVD,gCAUC;AAOD,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"Composition.js","sourceRoot":"","sources":["../source/Composition.ts"],"names":[],"mappings":";;;AAAA,qCAAkD;AAClD,yCAAmC;AACnC,uCAAwC;AAGxC,MAAa,WAAY,SAAQ,gBAAS;IACvB,IAAI,CAAY;IAEjC,YAAoB,IAAgB;QAClC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEkB,KAAK,CAAC,IAAI;QAC3B,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;QACpB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAEtD,MAAM,WAAW,CAAC,OAAO,EAAE,CAAA;QAE3B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAEzB,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACvC,CAAC;IAEkB,OAAO;QACxB,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAChD,CAAC;CACF;AAtBD,kCAsBC;AAED,SAAS,IAAI;IACX,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED,SAAS,OAAO;IACd,MAAM,OAAO,GAAG,IAAA,qBAAW,EAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAE1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;AACvD,CAAC;AAED,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QACzC,KAAK,CAAC,IAAI,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC1B,CAAC;AAVD,gCAUC;AAOD,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA"}

package/transpiled/Context.d.ts

@@ -1,5 +1,7 @@
-import { type Endpoint } from './Endpoint';
-import { type Directives } from './Directive';
-import { type Branch } from './Branch';
 import type * as RTD from './RTD';
-export type Context = RTD.Context<Endpoint, Directives, Branch>;
+export type Context = RTD.Context<Extension>;
+interface Extension {
+    namespace: string;
+    component: string;
+}
+export {};

package/transpiled/Directive.d.ts

@@ -1,32 +1,18 @@
-import { type IncomingMessage, type OutgoingMessage } from './HTTP';
-import { type Remotes } from './Remotes';
+import type { Context, OutgoingMessage } from './HTTP';
+import type { Remotes } from './Remotes';
+import type { Output } from './io';
 import type * as RTD from './RTD';
-export declare class Directives implements RTD.Directives<Directives> {
-    private readonly directives;
-    constructor(directives: DirectiveSet[]);
-    preflight(request: IncomingMessage, parameters: RTD.Parameter[]): Promise<Output>;
-    settle(request: IncomingMessage, response: OutgoingMessage): Promise<void>;
-    merge(directives: Directives): void;
+export declare class Directives implements RTD.Directives {
+    private readonly sets;
+    constructor(sets: RTD.DirectiveSet[]);
+    preflight(context: Context, parameters: RTD.Parameter[]): Promise<Output>;
+    settle(context: Context, response: OutgoingMessage): Promise<void>;
 }
-export declare class DirectivesFactory implements RTD.DirectivesFactory<Directives> {
-    private readonly remtoes;
+export declare class DirectivesFactory implements RTD.DirectiveFactory {
+    private readonly remotes;
     private readonly families;
     private readonly mandatory;
-    constructor(families: Family[], remotes: Remotes);
+    constructor(families: RTD.DirectiveFamily[], remotes: Remotes);
     create(declarations: RTD.syntax.Directive[]): Directives;
 }
 export declare const shortcuts: RTD.syntax.Shortcuts;
-export interface Family<TDirective = any, TExtension = any> {
-    readonly name: string;
-    readonly mandatory: boolean;
-    create: (name: string, value: any, remotes: Remotes) => TDirective;
-    preflight: (directives: TDirective[], request: IncomingMessage & TExtension, parameters: RTD.Parameter[]) => Output | Promise<Output>;
-    settle?: (directives: TDirective[], request: IncomingMessage & TExtension, response: OutgoingMessage) => void | Promise<void>;
-}
-interface DirectiveSet {
-    family: Family;
-    directives: any[];
-}
-export type Input = IncomingMessage;
-export type Output = OutgoingMessage | null;
-export {};

package/transpiled/Directive.js

@@ -2,32 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.shortcuts = exports.DirectivesFactory = exports.Directives = void 0;
 class Directives {
-    directives;
-    constructor(directives) {
-        this.directives = directives;
+    sets;
+    constructor(sets) {
+        this.sets = sets;
     }
-    async preflight(request, parameters) {
-        for (const directive of this.directives) {
-            const output = await directive.family.preflight(directive.directives, request, parameters);
+    async preflight(context, parameters) {
+        for (const set of this.sets) {
+            if (set.family.preflight === undefined)
+                continue;
+            const output = await set.family.preflight(set.directives, context, parameters);
             if (output !== null) {
-                await this.settle(request, output);
+                await this.settle(context, output);
                 return output;
             }
         }
         return null;
     }
-    async settle(request, response) {
-        for (const directive of this.directives)
-            if (directive.family.settle !== undefined)
-                await directive.family.settle(directive.directives, request, response);
-    }
-    merge(directives) {
-        this.directives.push(...directives.directives);
+    async settle(context, response) {
+        for (const set of this.sets)
+            if (set.family.settle !== undefined)
+                await set.family.settle(set.directives, context, response);
     }
 }
 exports.Directives = Directives;
 class DirectivesFactory {
-    remtoes;
+    remotes;
     families = {};
     mandatory = [];
     constructor(families, remotes) {
@@ -36,7 +35,7 @@ class DirectivesFactory {
             if (family.mandatory)
                 this.mandatory.push(family.name);
         }
-        this.remtoes = remotes;
+        this.remotes = remotes;
     }
     create(declarations) {
         const groups = {};
@@ -45,8 +44,8 @@ class DirectivesFactory {
         for (const declaration of declarations) {
             const family = this.families[declaration.family];
             if (family === undefined)
-                throw new Error(`Directive family '${declaration.family}' not found.`);
-            const directive = family.create(declaration.name, declaration.value, this.remtoes);
+                throw new Error(`Directive family '${declaration.family}' is not found.`);
+            const directive = family.create(declaration.name, declaration.value, this.remotes);
             groups[family.name] ??= [];
             groups[family.name].push(directive);
             mandatory.delete(family.name);

package/transpiled/Directive.js.map

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