@toa.io/extensions.exposition 1.0.0-alpha.46 → 1.0.0-alpha.48

package/documentation/flow.md

@@ -0,0 +1,31 @@
+# Request flow
+
+## `flow:fetch`
+
+Fetches the content from the resource returned by the specified endpoint.
+
+The value of the directive is a `string` specifying endpoint to be called for the redirection
+request.
+
+Request `authority`, `path` and `parameters` are passed as input to the redirection endpoint,
+and it must return a URL `string`, an `Error` or an object with the following properties:
+
+```yaml
+url: string
+options?:
+  method?: string
+  headers?: Record<string, string>
+  body?: string
+```
+
+If it returns a URL or Request, then the response to the specified request is returned as the
+response to the original request, along with the `content-type`, `content-length`, and `etag`
+headers.
+
+> Shortcut `redirect` is available.
+
+```yaml
+/:
+  GET:
+    flow:redirect: urls.resolve
+```

package/documentation/octets.md

@@ -134,10 +134,6 @@ The value of the directive is an object with the following properties:
   [BLOB variant](/extensions/storages/readme.md#async-fetchpath-string-maybereadable) must be
   specified in the path otherwise.
   Defaults to `true`.
-- `redirect`: `string` specifying endpoint to be called for the redirection url.
-
-Redirection endpoint must return a `string` or an `Error`.
-Request `authority`, `path` and `parameters` are passed as input.
 
 ```yaml
 /images:

package/features/flow.feature

@@ -0,0 +1,45 @@
+Feature: Request flow
+
+  Scenario: Fetching url
+    Given the `octets.tester` is running
+    And the annotation:
+      """yaml
+      /:
+        octets:context: octets
+        /:type:
+          GET:
+            anonymous: true
+            io:output: true
+            flow:fetch: octets.tester.redirect
+      """
+    When the following request is received:
+      """
+      GET /rfc HTTP/1.1
+      host: nex.toa.io
+      """
+    Then the following reply is sent:
+      """
+      200 OK
+      content-type: text/plain
+
+      Faster Than Light Speed Protocol (FLIP)
+      """
+    When the following request is received:
+      """
+      GET /img HTTP/1.1
+      host: nex.toa.io
+      """
+    Then the following reply is sent:
+      """
+      200 OK
+      content-type: image/svg+xml
+      """
+    When the following request is received:
+      """
+      GET /err HTTP/1.1
+      host: nex.toa.io
+      """
+    Then the following reply is sent:
+      """
+      404 Not Found
+      """

package/features/steps/components/octets.tester/manifest.toa.yaml

@@ -26,4 +26,15 @@ operations:
       authority*: string
       path*: string
       parameters: <string>
-    output: string
+    output:
+      type: object
+      properties:
+        url: string
+        options:
+          type: object
+          properties:
+            method: string
+            headers: object
+            body: string
+      required:
+        - url

package/features/steps/components/octets.tester/operations/redirect.js

@@ -1,7 +1,12 @@
 'use strict'
 
-async function redirect (input) {
-  return 'https://www.rfc-editor.org/rfc/rfc9564.txt'
+function redirect (input) {
+  return input.parameters.type in urls ? { url: urls[input.parameters.type] } : new Error()
+}
+
+const urls = {
+  'rfc': 'https://www.rfc-editor.org/rfc/rfc9564.txt',
+  'img': 'https://www.w3.org/assets/logos/w3c/w3c-no-bars.svg'
 }
 
 exports.computation = redirect

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.exposition",
-  "version": "1.0.0-alpha.46",
+  "version": "1.0.0-alpha.48",
   "description": "Toa Exposition",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -17,9 +17,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@toa.io/core": "1.0.0-alpha.46",
-    "@toa.io/generic": "1.0.0-alpha.46",
-    "@toa.io/schemas": "1.0.0-alpha.46",
+    "@toa.io/core": "1.0.0-alpha.48",
+    "@toa.io/generic": "1.0.0-alpha.48",
+    "@toa.io/schemas": "1.0.0-alpha.48",
     "bcryptjs": "2.4.3",
     "error-value": "0.3.0",
     "js-yaml": "4.1.0",
@@ -44,11 +44,11 @@
     "features:security": "cucumber-js --tags @security"
   },
   "devDependencies": {
-    "@toa.io/agent": "1.0.0-alpha.46",
-    "@toa.io/extensions.storages": "1.0.0-alpha.46",
+    "@toa.io/agent": "1.0.0-alpha.48",
+    "@toa.io/extensions.storages": "1.0.0-alpha.48",
     "@types/bcryptjs": "2.4.3",
     "@types/cors": "2.8.13",
     "@types/negotiator": "0.6.1"
   },
-  "gitHead": "60d2cc702afd217de1760d2df2e6ad76893ac18c"
+  "gitHead": "b0ace2cca06b1d29c5410ca1e244b04d32093fa9"
 }

package/schemas/octets/fetch.cos.yaml

@@ -1,4 +1,3 @@
 blob: boolean
 meta: boolean
-redirect: string
 _: true

package/source/directives/auth/Incept.ts

@@ -23,7 +23,7 @@ export class Incept implements Directive {
 
     if (id === undefined)
       throw new http.Conflict('Identity inception has failed as the response body ' +
-        ` does not contain the '${this.property}' property.`)
+        `does not contain the '${this.property}' property.`)
 
     const [scheme, credentials] = split(input.request.headers.authorization!)
     const provider = PROVIDERS[scheme]

package/source/directives/flow/Fetch.ts

@@ -0,0 +1,88 @@
+import { Readable } from 'node:stream'
+import assert from 'node:assert'
+import { match } from 'matchacho'
+import { NotFound } from '../../HTTP'
+import type { Directive } from './types'
+import type { ReadableStream } from 'node:stream/web'
+import type { Remotes } from '../../Remotes'
+import type { Maybe } from '@toa.io/types'
+import type { Component } from '@toa.io/core'
+import type { Output } from '../../io'
+import type { Input } from '../octets/types'
+import type { Parameter } from '../../RTD'
+
+export class Fetch implements Directive {
+  public readonly targeted = true
+
+  private readonly connecting: Promise<Component>
+  private remote: Component | null = null
+  private readonly operation: string
+
+  public constructor (endpoint: string, discovery: Remotes) {
+    assert.equal(typeof endpoint, 'string', '`flow:redirect` must be a string')
+
+    const [operation, name, namespace = 'default'] = endpoint.split('.').reverse()
+
+    this.operation = operation
+    this.connecting = discovery.discover(namespace, name)
+  }
+
+  public async apply (input: Input, parameters: Parameter[]): Promise<Output> {
+    if ('if-none-match' in input.request.headers)
+      return { status: 304 }
+
+    this.remote ??= await this.connecting
+
+    const request = await this.remote.invoke<Maybe<Request | string>>(this.operation, {
+      input: {
+        authority: input.authority,
+        path: input.request.url,
+        parameters: Object.fromEntries(parameters.map(({ name, value }) => [name, value]))
+      }
+    })
+
+    if (request instanceof Error)
+      throw new NotFound(request)
+
+    const { url, options } = match<Request>(request,
+      String, { url: request },
+      (request: Request): Request => ({
+        url: request.url,
+        options: {
+          method: request.options?.method ?? 'GET',
+          body: request.options?.body,
+          headers: request.options?.headers
+        }
+      }))
+
+    const response = await fetch(url, options)
+
+    if (!response.ok)
+      throw new NotFound()
+
+    const headers = new Headers()
+
+    for (const header of ['content-type', 'content-length', 'etag']) {
+      const value = response.headers.get(header)
+
+      if (value !== null)
+        headers.set(header, value)
+    }
+
+    return {
+      headers,
+      body: response.body === null ? null : Readable.fromWeb(response.body as ReadableStream)
+    }
+  }
+}
+
+interface Request {
+  url: string
+  options?: RequestOptions
+}
+
+interface RequestOptions {
+  method?: string
+  body?: string
+  headers?: Record<string, string>
+}

package/source/directives/flow/Flow.ts

@@ -0,0 +1,34 @@
+import { Fetch } from './Fetch'
+import type { Directive } from './types'
+import type { Input, Output } from '../../io'
+import type { DirectiveFamily, Parameter } from '../../RTD'
+import type { Remotes } from '../../Remotes'
+
+export class Flow implements DirectiveFamily<Directive> {
+  public readonly name: string = 'flow'
+  public readonly mandatory: boolean = false
+
+  public create (name: string, value: unknown, remotes: Remotes): Directive {
+    const Class = constructors[name]
+
+    if (Class === undefined)
+      throw new Error(`Directive '${this.name}:${name}' is not implemented.`)
+
+    return new Class(value, remotes)
+  }
+
+  public async preflight (directives: Directive[], input: Input, parameters: Parameter[]): Promise<Output> {
+    for (const directive of directives) {
+      const output = await directive.apply(input, parameters)
+
+      if (output !== null)
+        return output
+    }
+
+    return null
+  }
+}
+
+const constructors: Record<string, new (value: any, discovery: Remotes) => Directive> = {
+  fetch: Fetch
+}

package/source/directives/flow/index.ts

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

package/source/directives/flow/types.ts

@@ -0,0 +1,6 @@
+import type { Input, Output } from '../../io'
+import type { Parameter } from '../../RTD'
+
+export interface Directive {
+  apply: (input: Input, parameters: Parameter[]) => Promise<Output>
+}

package/source/directives/index.ts

@@ -6,8 +6,9 @@ import { octets } from './octets'
 import { io } from './io'
 import { vary } from './vary'
 import { req } from './require'
+import { flow } from './flow'
 import type { DirectiveFamily } from '../RTD'
 import type { Interceptor } from '../Interception'
 
-export const families: DirectiveFamily[] = [authorization, io, cache, vary, req, octets, dev]
+export const families: DirectiveFamily[] = [authorization, io, cache, vary, req, flow, octets, dev]
 export const interceptors: Interceptor[] = [cors]

package/source/directives/octets/Fetch.ts

@@ -1,45 +1,35 @@
 import { posix } from 'node:path'
-import { Readable } from 'node:stream'
 import { Forbidden, NotFound } from '../../HTTP'
 import * as schemas from './schemas'
 import { Directive } from './Directive'
-import type { Remotes } from '../../Remotes'
+import type { Readable } from 'node:stream'
 import type { Maybe } from '@toa.io/types'
 import type { Entry } from '@toa.io/extensions.storages'
 import type { Component } from '@toa.io/core'
 import type { Output } from '../../io'
 import type { Input } from './types'
-import type { Parameter } from '../../RTD'
 
 export class Fetch extends Directive {
   public readonly targeted = true
 
   private readonly options: Required<Options> = {
     blob: true,
-    meta: false,
-    redirect: null
+    meta: false
   }
 
   private readonly discovery: Promise<Component>
   private storage!: Component
-  private readonly remotes: Remotes
-  private connecting: Promise<Component> | null = null
-  private remote!: Component
 
-  public constructor (options: Options | null, discovery: Promise<Component>, remotes: Remotes) {
+  public constructor (options: Options | null, discovery: Promise<Component>) {
     super()
 
     schemas.fetch.validate(options)
     Object.assign(this.options, options)
 
     this.discovery = discovery
-    this.remotes = remotes
   }
 
-  public async apply (storage: string, input: Input, parameters: Parameter[]): Promise<Output> {
-    if (this.options.redirect !== null)
-      return this.redirect(input, parameters)
-
+  public async apply (storage: string, input: Input): Promise<Output> {
     this.storage ??= await this.discovery
 
     const variant = posix.basename(input.request.url).includes('.')
@@ -83,48 +73,6 @@ export class Fetch extends Directive {
     }
   }
 
-  private async redirect (input: Input, parameters: Parameter[]): Promise<Output> {
-    if ('if-none-match' in input.request.headers)
-      return { status: 304 }
-
-    const [operation, name, namespace = 'default'] = this.options.redirect!.split('.').reverse()
-
-    if (this.connecting === null)
-      this.connecting = this.remotes.discover(namespace, name)
-
-    this.remote ??= await this.connecting
-
-    const url = await this.remote.invoke<Maybe<string>>(operation, {
-      input: {
-        authority: input.authority,
-        path: input.request.url,
-        parameters: Object.fromEntries(parameters.map(({ name, value }) => [name, value]))
-      }
-    })
-
-    if (url instanceof Error)
-      throw new NotFound(url)
-
-    const response = await fetch(url)
-
-    if (!response.ok)
-      throw new NotFound()
-
-    const headers = new Headers()
-
-    for (const header of ['content-type', 'content-length', 'etag']) {
-      const value = response.headers.get(header)
-
-      if (value !== null)
-        headers.set(header, value)
-    }
-
-    return {
-      headers,
-      body: response.body === null ? null : Readable.fromWeb(response.body as any)
-    }
-  }
-
   private async get (storage: string, input: Input): Promise<Output> {
     const entry = await this.storage.invoke<Maybe<Entry>>('get', {
       input: {
@@ -143,7 +91,6 @@ export class Fetch extends Directive {
 export interface Options {
   blob?: boolean
   meta?: boolean
-  redirect?: string | null
 }
 
 interface FetchResult {

package/transpiled/directives/auth/Incept.js

@@ -42,7 +42,7 @@ class Incept {
         const id = response.body?.[this.property];
         if (id === undefined)
             throw new http.Conflict('Identity inception has failed as the response body ' +
-                ` does not contain the '${this.property}' property.`);
+                `does not contain the '${this.property}' property.`);
         const [scheme, credentials] = (0, split_1.split)(input.request.headers.authorization);
         const provider = schemes_1.PROVIDERS[scheme];
         this.schemes[scheme] ??= await this.discovery[provider];

package/transpiled/directives/auth/Incept.js.map

@@ -1 +1 @@
-{"version":3,"file":"Incept.js","sourceRoot":"","sources":["../../../source/directives/auth/Incept.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,iDAAkC;AAElC,mCAA+B;AAC/B,uCAAqC;AAErC,MAAa,MAAM;IACA,QAAQ,CAAQ;IAChB,SAAS,CAAW;IACpB,OAAO,GAAY,EAAwB,CAAA;IAE5D,YAAoB,QAAgB,EAAE,SAAoB;QACxD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAEM,SAAS,CAAE,QAAyB,EAAE,KAAY;QACvD,OAAO,QAAQ,KAAK,IAAI,IAAI,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAA;IACtE,CAAC;IAEM,KAAK,CAAC,MAAM,CAAE,KAAY,EAAE,QAA8B;QAC/D,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEzC,IAAI,EAAE,KAAK,SAAS;YAClB,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,qDAAqD;gBAC3E,0BAA0B,IAAI,CAAC,QAAQ,aAAa,CAAC,CAAA;QAEzD,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAA,aAAK,EAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAc,CAAC,CAAA;QACzE,MAAM,QAAQ,GAAG,mBAAS,CAAC,MAAM,CAAC,CAAA;QAElC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAEvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;aACxC,MAAM,CAAkB,QAAQ,EAAE;YACnC,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,EAAE;gBACF,WAAW;aACZ;SACF,CAAC,CAAA;QAEF,IAAI,QAAQ,YAAY,KAAK;YAC3B,MAAM,IAAI,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAA;QAE9C,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACzB,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAA;IAChC,CAAC;CACF;AAzCD,wBAyCC"}
+{"version":3,"file":"Incept.js","sourceRoot":"","sources":["../../../source/directives/auth/Incept.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,iDAAkC;AAElC,mCAA+B;AAC/B,uCAAqC;AAErC,MAAa,MAAM;IACA,QAAQ,CAAQ;IAChB,SAAS,CAAW;IACpB,OAAO,GAAY,EAAwB,CAAA;IAE5D,YAAoB,QAAgB,EAAE,SAAoB;QACxD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAEM,SAAS,CAAE,QAAyB,EAAE,KAAY;QACvD,OAAO,QAAQ,KAAK,IAAI,IAAI,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAA;IACtE,CAAC;IAEM,KAAK,CAAC,MAAM,CAAE,KAAY,EAAE,QAA8B;QAC/D,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEzC,IAAI,EAAE,KAAK,SAAS;YAClB,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,qDAAqD;gBAC3E,yBAAyB,IAAI,CAAC,QAAQ,aAAa,CAAC,CAAA;QAExD,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAA,aAAK,EAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAc,CAAC,CAAA;QACzE,MAAM,QAAQ,GAAG,mBAAS,CAAC,MAAM,CAAC,CAAA;QAElC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAEvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;aACxC,MAAM,CAAkB,QAAQ,EAAE;YACnC,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,EAAE;gBACF,WAAW;aACZ;SACF,CAAC,CAAA;QAEF,IAAI,QAAQ,YAAY,KAAK;YAC3B,MAAM,IAAI,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAA;QAE9C,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACzB,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAA;IAChC,CAAC;CACF;AAzCD,wBAyCC"}

package/transpiled/directives/flow/Fetch.d.ts

@@ -0,0 +1,13 @@
+import type { Directive } from './types';
+import type { Remotes } from '../../Remotes';
+import type { Output } from '../../io';
+import type { Input } from '../octets/types';
+import type { Parameter } from '../../RTD';
+export declare class Fetch implements Directive {
+    readonly targeted = true;
+    private readonly connecting;
+    private remote;
+    private readonly operation;
+    constructor(endpoint: string, discovery: Remotes);
+    apply(input: Input, parameters: Parameter[]): Promise<Output>;
+}

package/transpiled/directives/flow/Fetch.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fetch = void 0;
+const node_stream_1 = require("node:stream");
+const node_assert_1 = __importDefault(require("node:assert"));
+const matchacho_1 = require("matchacho");
+const HTTP_1 = require("../../HTTP");
+class Fetch {
+    targeted = true;
+    connecting;
+    remote = null;
+    operation;
+    constructor(endpoint, discovery) {
+        node_assert_1.default.equal(typeof endpoint, 'string', '`flow:redirect` must be a string');
+        const [operation, name, namespace = 'default'] = endpoint.split('.').reverse();
+        this.operation = operation;
+        this.connecting = discovery.discover(namespace, name);
+    }
+    async apply(input, parameters) {
+        if ('if-none-match' in input.request.headers)
+            return { status: 304 };
+        this.remote ??= await this.connecting;
+        const request = await this.remote.invoke(this.operation, {
+            input: {
+                authority: input.authority,
+                path: input.request.url,
+                parameters: Object.fromEntries(parameters.map(({ name, value }) => [name, value]))
+            }
+        });
+        if (request instanceof Error)
+            throw new HTTP_1.NotFound(request);
+        const { url, options } = (0, matchacho_1.match)(request, String, { url: request }, (request) => ({
+            url: request.url,
+            options: {
+                method: request.options?.method ?? 'GET',
+                body: request.options?.body,
+                headers: request.options?.headers
+            }
+        }));
+        const response = await fetch(url, options);
+        if (!response.ok)
+            throw new HTTP_1.NotFound();
+        const headers = new Headers();
+        for (const header of ['content-type', 'content-length', 'etag']) {
+            const value = response.headers.get(header);
+            if (value !== null)
+                headers.set(header, value);
+        }
+        return {
+            headers,
+            body: response.body === null ? null : node_stream_1.Readable.fromWeb(response.body)
+        };
+    }
+}
+exports.Fetch = Fetch;
+//# sourceMappingURL=Fetch.js.map

package/transpiled/directives/flow/Fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fetch.js","sourceRoot":"","sources":["../../../source/directives/flow/Fetch.ts"],"names":[],"mappings":";;;;;;AAAA,6CAAsC;AACtC,8DAAgC;AAChC,yCAAiC;AACjC,qCAAqC;AAUrC,MAAa,KAAK;IACA,QAAQ,GAAG,IAAI,CAAA;IAEd,UAAU,CAAoB;IACvC,MAAM,GAAqB,IAAI,CAAA;IACtB,SAAS,CAAQ;IAElC,YAAoB,QAAgB,EAAE,SAAkB;QACtD,qBAAM,CAAC,KAAK,CAAC,OAAO,QAAQ,EAAE,QAAQ,EAAE,kCAAkC,CAAC,CAAA;QAE3E,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;QAE9E,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IACvD,CAAC;IAEM,KAAK,CAAC,KAAK,CAAE,KAAY,EAAE,UAAuB;QACvD,IAAI,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO;YAC1C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAA;QAExB,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,UAAU,CAAA;QAErC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAA0B,IAAI,CAAC,SAAS,EAAE;YAChF,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG;gBACvB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;aACnF;SACF,CAAC,CAAA;QAEF,IAAI,OAAO,YAAY,KAAK;YAC1B,MAAM,IAAI,eAAQ,CAAC,OAAO,CAAC,CAAA;QAE7B,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAA,iBAAK,EAAU,OAAO,EAC7C,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EACxB,CAAC,OAAgB,EAAW,EAAE,CAAC,CAAC;YAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE;gBACP,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK;gBACxC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI;gBAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO;aAClC;SACF,CAAC,CAAC,CAAA;QAEL,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE;YACd,MAAM,IAAI,eAAQ,EAAE,CAAA;QAEtB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;QAE7B,KAAK,MAAM,MAAM,IAAI,CAAC,cAAc,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC;YAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAE1C,IAAI,KAAK,KAAK,IAAI;gBAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;QAED,OAAO;YACL,OAAO;YACP,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAsB,CAAC;SACxF,CAAA;IACH,CAAC;CACF;AA/DD,sBA+DC"}

package/transpiled/directives/flow/Flow.d.ts

@@ -0,0 +1,10 @@
+import type { Directive } from './types';
+import type { Input, Output } from '../../io';
+import type { DirectiveFamily, Parameter } from '../../RTD';
+import type { Remotes } from '../../Remotes';
+export declare class Flow implements DirectiveFamily<Directive> {
+    readonly name: string;
+    readonly mandatory: boolean;
+    create(name: string, value: unknown, remotes: Remotes): Directive;
+    preflight(directives: Directive[], input: Input, parameters: Parameter[]): Promise<Output>;
+}

package/transpiled/directives/flow/Flow.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Flow = void 0;
+const Fetch_1 = require("./Fetch");
+class Flow {
+    name = 'flow';
+    mandatory = false;
+    create(name, value, remotes) {
+        const Class = constructors[name];
+        if (Class === undefined)
+            throw new Error(`Directive '${this.name}:${name}' is not implemented.`);
+        return new Class(value, remotes);
+    }
+    async preflight(directives, input, parameters) {
+        for (const directive of directives) {
+            const output = await directive.apply(input, parameters);
+            if (output !== null)
+                return output;
+        }
+        return null;
+    }
+}
+exports.Flow = Flow;
+const constructors = {
+    fetch: Fetch_1.Fetch
+};
+//# sourceMappingURL=Flow.js.map

package/transpiled/directives/flow/Flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Flow.js","sourceRoot":"","sources":["../../../source/directives/flow/Flow.ts"],"names":[],"mappings":";;;AAAA,mCAA+B;AAM/B,MAAa,IAAI;IACC,IAAI,GAAW,MAAM,CAAA;IACrB,SAAS,GAAY,KAAK,CAAA;IAEnC,MAAM,CAAE,IAAY,EAAE,KAAc,EAAE,OAAgB;QAC3D,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,KAAK,KAAK,SAAS;YACrB,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,IAAI,IAAI,uBAAuB,CAAC,CAAA;QAEzE,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;IAEM,KAAK,CAAC,SAAS,CAAE,UAAuB,EAAE,KAAY,EAAE,UAAuB;QACpF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;YAEvD,IAAI,MAAM,KAAK,IAAI;gBACjB,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAvBD,oBAuBC;AAED,MAAM,YAAY,GAAsE;IACtF,KAAK,EAAE,aAAK;CACb,CAAA"}

package/transpiled/directives/flow/index.d.ts

@@ -0,0 +1,2 @@
+import { Flow } from './Flow';
+export declare const flow: Flow;

package/transpiled/directives/flow/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flow = void 0;
+const Flow_1 = require("./Flow");
+exports.flow = new Flow_1.Flow();
+//# sourceMappingURL=index.js.map

package/transpiled/directives/flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/directives/flow/index.ts"],"names":[],"mappings":";;;AAAA,iCAA6B;AAEhB,QAAA,IAAI,GAAG,IAAI,WAAI,EAAE,CAAA"}

package/transpiled/directives/flow/types.d.ts

@@ -0,0 +1,5 @@
+import type { Input, Output } from '../../io';
+import type { Parameter } from '../../RTD';
+export interface Directive {
+    apply: (input: Input, parameters: Parameter[]) => Promise<Output>;
+}

package/transpiled/directives/flow/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/transpiled/directives/flow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../source/directives/flow/types.ts"],"names":[],"mappings":""}

package/transpiled/directives/index.js

@@ -9,6 +9,7 @@ const octets_1 = require("./octets");
 const io_1 = require("./io");
 const vary_1 = require("./vary");
 const require_1 = require("./require");
-exports.families = [auth_1.authorization, io_1.io, cache_1.cache, vary_1.vary, require_1.req, octets_1.octets, dev_1.dev];
+const flow_1 = require("./flow");
+exports.families = [auth_1.authorization, io_1.io, cache_1.cache, vary_1.vary, require_1.req, flow_1.flow, octets_1.octets, dev_1.dev];
 exports.interceptors = [cors_1.cors];
 //# sourceMappingURL=index.js.map

package/transpiled/directives/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/directives/index.ts"],"names":[],"mappings":";;;AAAA,iCAAsC;AACtC,mCAA+B;AAC/B,iCAA6B;AAC7B,+BAA2B;AAC3B,qCAAiC;AACjC,6BAAyB;AACzB,iCAA6B;AAC7B,uCAA+B;AAIlB,QAAA,QAAQ,GAAsB,CAAC,oBAAa,EAAE,OAAE,EAAE,aAAK,EAAE,WAAI,EAAE,aAAG,EAAE,eAAM,EAAE,SAAG,CAAC,CAAA;AAChF,QAAA,YAAY,GAAkB,CAAC,WAAI,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/directives/index.ts"],"names":[],"mappings":";;;AAAA,iCAAsC;AACtC,mCAA+B;AAC/B,iCAA6B;AAC7B,+BAA2B;AAC3B,qCAAiC;AACjC,6BAAyB;AACzB,iCAA6B;AAC7B,uCAA+B;AAC/B,iCAA6B;AAIhB,QAAA,QAAQ,GAAsB,CAAC,oBAAa,EAAE,OAAE,EAAE,aAAK,EAAE,WAAI,EAAE,aAAG,EAAE,WAAI,EAAE,eAAM,EAAE,SAAG,CAAC,CAAA;AACtF,QAAA,YAAY,GAAkB,CAAC,WAAI,CAAC,CAAA"}

package/transpiled/directives/octets/Fetch.d.ts

@@ -1,25 +1,18 @@
 import { Directive } from './Directive';
-import type { Remotes } from '../../Remotes';
 import type { Component } from '@toa.io/core';
 import type { Output } from '../../io';
 import type { Input } from './types';
-import type { Parameter } from '../../RTD';
 export declare class Fetch extends Directive {
     readonly targeted = true;
     private readonly options;
     private readonly discovery;
     private storage;
-    private readonly remotes;
-    private connecting;
-    private remote;
-    constructor(options: Options | null, discovery: Promise<Component>, remotes: Remotes);
-    apply(storage: string, input: Input, parameters: Parameter[]): Promise<Output>;
+    constructor(options: Options | null, discovery: Promise<Component>);
+    apply(storage: string, input: Input): Promise<Output>;
     private fetch;
-    private redirect;
     private get;
 }
 export interface Options {
     blob?: boolean;
     meta?: boolean;
-    redirect?: string | null;
 }