@toa.io/extensions.introspection 1.0.0-alpha.259

package/source/annotation.ts

@@ -0,0 +1,83 @@
+import { decode } from '@toa.io/generic'
+import { DEFAULT_INTERVAL, DEFAULT_THRESHOLD, DENIED, ENV } from './const'
+import type { Resources } from '@toa.io/operations'
+
+/** `context.toa.yaml` */
+export type Annotation = false | {
+  /** Capture real payloads. Off by default: this is production data. */
+  samples?: boolean
+  /** Flush period, seconds. */
+  interval?: number
+  /** Flush as soon as this many distinct edges are buffered. */
+  threshold?: number
+  /** Publish the UI. On by default. */
+  ui?: boolean
+  resources?: Resources
+}
+
+/** `manifest.toa.yaml` */
+export type Declaration = false | {
+  samples?: boolean
+}
+
+/** What `deployment()` encodes into the environment. */
+export interface Options {
+  samples: boolean
+  interval: number
+  threshold: number
+  ui: boolean
+}
+
+/** The effective per-component decision. */
+export interface Settings {
+  enabled: boolean
+  samples: boolean
+}
+
+export const DISABLED: Settings = { enabled: false, samples: false }
+
+export function options (annotation?: Annotation): Options {
+  const declaration = annotation === undefined || annotation === false ? {} : annotation
+
+  return {
+    samples: declaration.samples === true,
+    interval: declaration.interval ?? DEFAULT_INTERVAL,
+    threshold: declaration.threshold ?? DEFAULT_THRESHOLD,
+    ui: declaration.ui !== false
+  }
+}
+
+/** Reads what `deployment()` has put into the environment. */
+export function environment (): Options | null {
+  const value = process.env[ENV]
+
+  if (value === undefined)
+    return null
+
+  return decode<Options>(value)
+}
+
+export function component (declaration: Declaration | null | undefined): Declaration {
+  if (declaration === false)
+    return false
+
+  // predefined extensions arrive as null for components that say nothing
+  if (declaration === null || declaration === undefined)
+    return {}
+
+  return declaration.samples === undefined ? {} : { samples: declaration.samples }
+}
+
+/**
+ * Both levels must agree, and either can veto: the context is the environment
+ * ceiling, the manifest is the component's own call. A component handling
+ * personal data opts out for good, and no context flag overrides that.
+ */
+export function settings (namespace: string, declaration: Declaration, opts: Options | null): Settings {
+  if (opts === null || declaration === false)
+    return DISABLED
+
+  const samples = opts.samples && declaration.samples !== false && !DENIED.has(namespace)
+
+  return { enabled: true, samples }
+}

package/source/const.ts

@@ -0,0 +1,32 @@
+export const ID = 'introspection'
+export const NAMESPACE = 'introspection'
+
+export const ENV = 'TOA_INTROSPECTION'
+
+export const NODES = 'nodes'
+export const EDGES = 'edges'
+
+/** Where the UI is mounted; `/introspection/*` belongs to the components' own API. */
+export const UI_PATH = '/.introspection'
+export const UI_PORT = 8002
+
+export const DEFAULT_INTERVAL = 300
+export const DEFAULT_THRESHOLD = 1024
+
+/** How often a component re-announces its description, so that removed components fade out. */
+export const ANNOUNCE_INTERVAL = 1_800_000
+
+/**
+ * `source` arrives over the wire, so the number of distinct edges a process
+ * can hold must be bounded regardless of what peers send.
+ */
+export const MAX_EDGES = 4096
+
+/** Never capture samples for these namespaces, whatever the annotation says. */
+export const DENIED = new Set(['identity', 'introspection'])
+
+/** Keys never stored in a sample, even when sampling is on. */
+export const REDACTED = /^(password|secret|token|credentials?|key|authorization|cookie)$/i
+
+/** Serialized size cap of a single sample. */
+export const SAMPLE_LIMIT = 4096

package/source/describe.ts

@@ -0,0 +1,68 @@
+import type { Node, Operation, Event, Receiver } from './model'
+import type { Manifest } from '@toa.io/norm'
+
+/**
+ * Turns a normalized component manifest into the node of the map.
+ *
+ * Everything here is already expanded by norm: concise schemas are resolved and
+ * the prototype chain is collapsed, so this is the shape the runtime actually runs.
+ */
+export function describe (manifest: Manifest): Node {
+  return {
+    namespace: manifest.namespace,
+    component: manifest.name,
+    version: manifest.version,
+    entity: entity(manifest),
+    operations: operations(manifest),
+    events: events(manifest),
+    receivers: receivers(manifest),
+
+    // names only: extension declarations carry configuration and secrets
+    extensions: Object.keys(manifest.extensions ?? {})
+  }
+}
+
+function entity (manifest: Manifest): Node['entity'] {
+  if (manifest.entity === undefined)
+    return null
+
+  return {
+    schema: manifest.entity.schema,
+    storage: manifest.entity.storage,
+    associated: manifest.entity.associated === true
+  }
+}
+
+function operations (manifest: Manifest): Operation[] {
+  return Object.entries(manifest.operations ?? {})
+    .map(([endpoint, definition]: [string, any]) => ({
+      endpoint,
+      type: definition.type,
+      scope: definition.scope,
+      query: definition.query,
+      input: definition.input ?? null,
+      output: definition.output ?? null,
+      errors: definition.errors ?? []
+    }))
+}
+
+function events (manifest: Manifest): Event[] {
+  return Object.entries(manifest.events ?? {})
+    .map(([label, definition]: [string, any]) => ({ label, binding: definition.binding }))
+}
+
+/*
+ * Receiver labels contain dots (`identity.bans.created`), which is why nodes keep
+ * these as arrays rather than maps — a dot in a document key is a hazard in Mongo.
+ */
+function receivers (manifest: Manifest): Receiver[] {
+  return Object.entries(manifest.receivers ?? {})
+    .map(([label, definition]: [string, any]) => ({
+      label,
+      source: definition.source ?? label.split('.').slice(0, 2).join('.'),
+      event: label.split('.').pop()!,
+      operation: definition.operation,
+      conditioned: definition.conditioned === true,
+      adaptive: definition.adaptive === true
+    }))
+}

package/source/extension.ts

@@ -0,0 +1,45 @@
+import { encode } from '@toa.io/generic'
+import { options } from './annotation'
+import { components } from './Composition'
+import { ENV, UI_PATH, UI_PORT } from './const'
+import * as schemas from './schemas'
+import type { Annotation } from './annotation'
+import type { Dependency, Instances, Service } from '@toa.io/operations'
+
+export const standalone = true
+
+/**
+ * The explorer hosts the introspection components, exactly as the exposition
+ * gateway hosts the identity ones. Collection is on unless the context says
+ * `introspection: false`, and the environment variable is emitted together
+ * with the service — never on its own, or tasks would pile up in a queue
+ * nothing consumes.
+ */
+export function deployment (_: Instances<unknown>, annotation?: Annotation): Dependency {
+  if (annotation === false)
+    return {}
+
+  if (annotation !== undefined)
+    schemas.annotation.validate(annotation)
+
+  const opts = options(annotation)
+
+  const service: Service = {
+    group: 'introspection',
+    name: 'explorer',
+    version: require('../package.json').version,
+    components: components().labels,
+    resources: annotation?.resources,
+    variables: []
+  }
+
+  if (opts.ui) {
+    service.port = UI_PORT
+    service.ingress = { path: UI_PATH }
+  }
+
+  return {
+    services: [service],
+    variables: { global: [{ name: ENV, value: encode(opts) }] }
+  }
+}

package/source/index.ts

@@ -0,0 +1,7 @@
+export { Factory } from './Factory'
+export { manifest } from './manifest'
+export { components } from './Composition'
+export * from './extension'
+
+export type { Annotation, Declaration, Options, Settings } from './annotation'
+export type * from './model'

package/source/manifest.ts

@@ -0,0 +1,19 @@
+import { component } from './annotation'
+import * as schemas from './schemas'
+import type { Declaration } from './annotation'
+
+/**
+ * The component level of the annotation.
+ *
+ * The extension is predefined, so most components say nothing and the
+ * declaration arrives as `null` — which still has to produce a value,
+ * or norm rejects the extension.
+ */
+export function manifest (declaration: Declaration | null | undefined): Declaration {
+  const normalized = component(declaration)
+
+  if (normalized !== false)
+    schemas.declaration.validate(normalized)
+
+  return normalized
+}

package/source/model.ts

@@ -0,0 +1,82 @@
+import type { Source } from '@toa.io/core'
+
+export type { Source }
+
+/**
+ * The caller side of an edge: the operation that made the call, the event that
+ * caused it, or the service the call came from.
+ */
+export type Origin = Source
+
+/** The callee side of an edge. */
+export interface Target {
+  namespace: string
+  component: string
+  operation: string
+}
+
+export interface Operation {
+  endpoint: string
+  type: string
+  scope?: string
+  query?: boolean
+  input?: object | null
+  output?: object | null
+  errors?: string[]
+}
+
+export interface Event {
+  label: string
+  binding?: string
+}
+
+export interface Receiver {
+  label: string
+  source: string
+  event: string
+  operation: string
+  conditioned: boolean
+  adaptive: boolean
+}
+
+export interface Entity {
+  schema: object
+  storage?: string
+  associated: boolean
+}
+
+/**
+ * The static description of a component, derived from its manifest.
+ * Sent to `introspection.nodes`.
+ */
+export interface Node {
+  namespace: string
+  component: string
+  version: string
+  entity: Entity | null
+  operations: Operation[]
+  events: Event[]
+  receivers: Receiver[]
+  extensions: string[]
+}
+
+export interface Sample {
+  at: number
+  input?: unknown
+  outcome: Outcome
+}
+
+export type Outcome = 'ok' | 'error' | 'exception'
+
+/**
+ * A call observed in a process between flushes. What the application declares —
+ * which events exist, and which receiver takes which — is a node's business;
+ * an edge is what actually happened.
+ *
+ * Sent to `introspection.edges`.
+ */
+export interface Edge {
+  src: Origin
+  dst: Target
+  sample?: Sample
+}

package/source/sample.ts

@@ -0,0 +1,49 @@
+import { Readable } from 'node:stream'
+import { REDACTED, SAMPLE_LIMIT } from './const'
+import type { Outcome, Sample } from './model'
+
+/**
+ * Captures the payload of a call. Only reached when both the context and the
+ * component have opted in, and never for a denied namespace.
+ */
+export function capture (input: unknown, outcome: Outcome): Sample {
+  return { at: Date.now(), input: redact(input), outcome }
+}
+
+export function samplable (input: unknown): boolean {
+  return !(input instanceof Readable)
+}
+
+function redact (value: unknown): unknown {
+  if (value === null || value === undefined || typeof value !== 'object')
+    return truncate(value)
+
+  if (Array.isArray(value))
+    return truncate(value.map(redact))
+
+  const result: Record<string, unknown> = {}
+
+  for (const [key, property] of Object.entries(value))
+    result[key] = REDACTED.test(key) ? '***' : redact(property)
+
+  return truncate(result)
+}
+
+/**
+ * The map holds one sample per edge indefinitely, so a single oversized
+ * payload must not become a permanent tenant of the collection.
+ */
+function truncate (value: unknown): unknown {
+  let serialized: string
+
+  try {
+    serialized = JSON.stringify(value) ?? ''
+  } catch {
+    return '[unserializable]'
+  }
+
+  if (serialized.length <= SAMPLE_LIMIT)
+    return value
+
+  return '[truncated]'
+}

package/source/schemas.ts

@@ -0,0 +1,10 @@
+import { resolve } from 'node:path'
+import schemas from '@toa.io/schemas'
+import type { Schema } from '@toa.io/schemas'
+import type { Annotation, Declaration } from './annotation'
+
+const path = resolve(__dirname, '../schemas')
+const namespace = schemas.namespace(path)
+
+export const annotation: Schema<Exclude<Annotation, false>> = namespace.schema('annotation')
+export const declaration: Schema<Exclude<Declaration, false>> = namespace.schema('declaration')

package/transpiled/Composition.d.ts

@@ -0,0 +1,21 @@
+import { Connector } from '@toa.io/core';
+import { type Bootloader } from './Factory';
+import type { Annotation } from './annotation';
+/** Hosts the introspection components in the explorer process. */
+export declare class Composition extends Connector {
+    private readonly boot;
+    constructor(boot: Bootloader);
+    protected open(): Promise<void>;
+}
+export declare function find(): string[];
+/**
+ * The extension is predefined, so an application that turns introspection off
+ * must not end up with the explorer components — nor with the exposition
+ * dependency they bring in.
+ */
+export declare function components(annotation?: Annotation): Components;
+interface Components {
+    labels: string[];
+    paths: string[];
+}
+export {};

package/transpiled/Composition.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.components = exports.find = exports.Composition = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const core_1 = require("@toa.io/core");
+/** Hosts the introspection components in the explorer process. */
+class Composition extends core_1.Connector {
+    boot;
+    constructor(boot) {
+        super();
+        this.boot = boot;
+    }
+    async open() {
+        const paths = find();
+        const composition = await this.boot.composition(paths);
+        await composition.connect();
+        this.depends(composition);
+    }
+}
+exports.Composition = Composition;
+function find() {
+    return entries().map((entry) => (0, node_path_1.resolve)(ROOT, entry.name));
+}
+exports.find = find;
+function entries() {
+    const entries = (0, node_fs_1.readdirSync)(ROOT, { withFileTypes: true });
+    return entries.filter((entry) => entry.isDirectory());
+}
+/**
+ * The extension is predefined, so an application that turns introspection off
+ * must not end up with the explorer components — nor with the exposition
+ * dependency they bring in.
+ */
+function components(annotation) {
+    if (annotation === false)
+        return { labels: [], paths: [] };
+    const labels = [];
+    const paths = [];
+    for (const entry of entries()) {
+        labels.push(entry.name.replace('.', '-'));
+        paths.push((0, node_path_1.resolve)(ROOT, entry.name));
+    }
+    return { labels, paths };
+}
+exports.components = components;
+const ROOT = (0, node_path_1.resolve)(__dirname, '../components/');
+//# sourceMappingURL=Composition.js.map

package/transpiled/Composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Composition.js","sourceRoot":"","sources":["../source/Composition.ts"],"names":[],"mappings":";;;AAAA,qCAAkD;AAClD,yCAAmC;AACnC,uCAAwC;AAIxC,kEAAkE;AAClE,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;IAC3B,CAAC;CACF;AAhBD,kCAgBC;AAED,SAAgB,IAAI;IAClB,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5D,CAAC;AAFD,oBAEC;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;;;;GAIG;AACH,SAAgB,UAAU,CAAE,UAAuB;IACjD,IAAI,UAAU,KAAK,KAAK;QACtB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAElC,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;AAbD,gCAaC;AAOD,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA"}

package/transpiled/Explorer.d.ts

@@ -0,0 +1,9 @@
+import { Connector } from '@toa.io/core';
+/**
+ * The explorer process. It hosts the introspection components — the map is read
+ * through their own operations — and serves the UI.
+ */
+export declare class Explorer extends Connector {
+    protected open(): Promise<void>;
+    protected dispose(): void;
+}

package/transpiled/Explorer.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Explorer = void 0;
+const core_1 = require("@toa.io/core");
+const openspan_1 = require("openspan");
+/**
+ * The explorer process. It hosts the introspection components — the map is read
+ * through their own operations — and serves the UI.
+ */
+class Explorer extends core_1.Connector {
+    async open() {
+        openspan_1.console.info('Introspection explorer started');
+    }
+    dispose() {
+        openspan_1.console.info('Introspection explorer is closed');
+    }
+}
+exports.Explorer = Explorer;
+//# sourceMappingURL=Explorer.js.map

package/transpiled/Explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Explorer.js","sourceRoot":"","sources":["../source/Explorer.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AACxC,uCAAkC;AAElC;;;GAGG;AACH,MAAa,QAAS,SAAQ,gBAAS;IAClB,KAAK,CAAC,IAAI;QAC3B,kBAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IAChD,CAAC;IAEkB,OAAO;QACxB,kBAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;IAClD,CAAC;CACF;AARD,4BAQC"}

package/transpiled/Factory.d.ts

@@ -0,0 +1,22 @@
+import { Connector } from '@toa.io/core';
+import type { Declaration } from './annotation';
+import type { Manifest } from '@toa.io/norm';
+import type { Component, Locator, extensions } from '@toa.io/core';
+export declare class Factory implements extensions.Factory {
+    private readonly boot;
+    private readonly options;
+    private readonly settings;
+    private reporter;
+    constructor(boot: Bootloader);
+    tenant(locator: Locator, decl: Declaration | null, manifest: Manifest): Connector;
+    component(component: Component): Component;
+    service(): Connector | null;
+    /**
+     * `tenant()` runs before any component is created, so settings are warm.
+     * A component booted on its own (without a composition) falls back to
+     * the environment, with sampling off.
+     */
+    private resolve;
+    private collector;
+}
+export type Bootloader = typeof import('@toa.io/boot');

package/transpiled/Factory.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Factory = void 0;
+const core_1 = require("@toa.io/core");
+const annotation_1 = require("./annotation");
+const const_1 = require("./const");
+const describe_1 = require("./describe");
+const Reporter_1 = require("./Reporter");
+const Tenant_1 = require("./Tenant");
+const Composition_1 = require("./Composition");
+const Explorer_1 = require("./Explorer");
+const UI_1 = require("./UI");
+const sample_1 = require("./sample");
+class Factory {
+    boot;
+    options;
+    settings = {};
+    reporter = null;
+    constructor(boot) {
+        this.boot = boot;
+        this.options = (0, annotation_1.environment)();
+    }
+    tenant(locator, decl, manifest) {
+        const resolved = (0, annotation_1.settings)(locator.namespace, (0, annotation_1.component)(decl), this.options);
+        this.settings[locator.id] = resolved;
+        if (!resolved.enabled || locator.namespace === const_1.NAMESPACE)
+            return new core_1.Connector();
+        return new Tenant_1.Tenant(this.collector(), (0, describe_1.describe)(manifest));
+    }
+    component(component) {
+        const locator = component.locator;
+        const resolved = this.resolve(locator);
+        if (!resolved.enabled)
+            return component;
+        const reporter = this.collector();
+        const invoke = component.invoke.bind(component);
+        component.invoke = async (endpoint, request) => {
+            let outcome = 'ok';
+            let reply;
+            try {
+                reply = await invoke(endpoint, request);
+                if (reply?.exception !== undefined)
+                    outcome = 'exception';
+                else if (reply?.error !== undefined)
+                    outcome = 'error';
+                return reply;
+            }
+            catch (error) {
+                outcome = 'exception';
+                throw error;
+            }
+            finally {
+                // a call that failed is still a connection between two components
+                const src = request?.source ?? UNKNOWN;
+                const dst = { namespace: locator.namespace, component: locator.name, operation: endpoint };
+                const sample = resolved.samples && (0, sample_1.samplable)(request?.input)
+                    ? (0, sample_1.capture)(request?.input, outcome)
+                    : undefined;
+                reporter.observe({ src, dst, sample });
+            }
+        };
+        component.depends(reporter);
+        return component;
+    }
+    service() {
+        if (this.options === null)
+            return null;
+        const composition = new Composition_1.Composition(this.boot);
+        const explorer = new Explorer_1.Explorer();
+        explorer.depends(composition);
+        if (this.options.ui)
+            explorer.depends(new UI_1.UI(const_1.UI_PORT));
+        return explorer;
+    }
+    /**
+     * `tenant()` runs before any component is created, so settings are warm.
+     * A component booted on its own (without a composition) falls back to
+     * the environment, with sampling off.
+     */
+    resolve(locator) {
+        if (locator.namespace === const_1.NAMESPACE)
+            return annotation_1.DISABLED;
+        return this.settings[locator.id] ??
+            (0, annotation_1.settings)(locator.namespace, {}, this.options === null ? null : { ...this.options, samples: false });
+    }
+    collector() {
+        this.reporter ??= new Reporter_1.Reporter(this.boot, this.options);
+        return this.reporter;
+    }
+}
+exports.Factory = Factory;
+const UNKNOWN = { service: 'unknown' };
+//# sourceMappingURL=Factory.js.map

package/transpiled/Factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../source/Factory.ts"],"names":[],"mappings":";;;AAAA,uCAAwC;AACxC,6CAAwF;AACxF,mCAA4C;AAC5C,yCAAqC;AACrC,yCAAqC;AACrC,qCAAiC;AACjC,+CAA2C;AAC3C,yCAAqC;AACrC,6BAAyB;AACzB,qCAA6C;AAM7C,MAAa,OAAO;IACD,IAAI,CAAY;IAChB,OAAO,CAAgB;IACvB,QAAQ,GAA6B,EAAE,CAAA;IAChD,QAAQ,GAAoB,IAAI,CAAA;IAExC,YAAoB,IAAgB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,IAAA,wBAAW,GAAE,CAAA;IAC9B,CAAC;IAEM,MAAM,CAAE,OAAgB,EAAE,IAAwB,EAAE,QAAkB;QAC3E,MAAM,QAAQ,GAAG,IAAA,qBAAQ,EAAC,OAAO,CAAC,SAAS,EAAE,IAAA,sBAAW,EAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAE7E,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAA;QAEpC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,SAAS,KAAK,iBAAS;YACtD,OAAO,IAAI,gBAAS,EAAE,CAAA;QAExB,OAAO,IAAI,eAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAA,mBAAQ,EAAC,QAAQ,CAAC,CAAC,CAAA;IACzD,CAAC;IAEM,SAAS,CAAE,SAAoB;QACpC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAEtC,IAAI,CAAC,QAAQ,CAAC,OAAO;YACnB,OAAO,SAAS,CAAA;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QACjC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAE/C,SAAS,CAAC,MAAM,GAAG,KAAK,EAAE,QAAgB,EAAE,OAAgB,EAAgB,EAAE;YAC5E,IAAI,OAAO,GAAY,IAAI,CAAA;YAC3B,IAAI,KAAwB,CAAA;YAE5B,IAAI,CAAC;gBACH,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;gBAEvC,IAAI,KAAK,EAAE,SAAS,KAAK,SAAS;oBAAE,OAAO,GAAG,WAAW,CAAA;qBACpD,IAAI,KAAK,EAAE,KAAK,KAAK,SAAS;oBAAE,OAAO,GAAG,OAAO,CAAA;gBAEtD,OAAO,KAAK,CAAA;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,WAAW,CAAA;gBAErB,MAAM,KAAK,CAAA;YACb,CAAC;oBAAS,CAAC;gBACT,kEAAkE;gBAClE,MAAM,GAAG,GAAW,OAAO,EAAE,MAAM,IAAI,OAAO,CAAA;gBAC9C,MAAM,GAAG,GAAW,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;gBAElG,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,IAAI,IAAA,kBAAS,EAAC,OAAO,EAAE,KAAK,CAAC;oBAC1D,CAAC,CAAC,IAAA,gBAAO,EAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC;oBAClC,CAAC,CAAC,SAAS,CAAA;gBAEb,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;YACxC,CAAC;QACH,CAAC,CAAA;QAED,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE3B,OAAO,SAAS,CAAA;IAClB,CAAC;IAEM,OAAO;QACZ,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YACvB,OAAO,IAAI,CAAA;QAEb,MAAM,WAAW,GAAG,IAAI,yBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,QAAQ,GAAG,IAAI,mBAAQ,EAAE,CAAA;QAE/B,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAE7B,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE;YACjB,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAE,CAAC,eAAO,CAAC,CAAC,CAAA;QAEnC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACK,OAAO,CAAE,OAAgB;QAC/B,IAAI,OAAO,CAAC,SAAS,KAAK,iBAAS;YACjC,OAAO,qBAAQ,CAAA;QAEjB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,IAAA,qBAAQ,EAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IACvG,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,QAAQ,KAAK,IAAI,mBAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAQ,CAAC,CAAA;QAExD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;CACF;AAlGD,0BAkGC;AAED,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,SAAS,EAAW,CAAA"}