@toa.io/extensions.exposition 1.0.0-alpha.29 → 1.0.0-alpha.291

package/transpiled/HTTP/Probe.js

@@ -0,0 +1,80 @@
+import * as http from 'node:http';
+import { console } from 'openspan';
+/**
+ * The readiness probe, on a port of its own.
+ *
+ * It cannot share the port the gateway serves traffic on: kubelet speaks HTTP/1.1 only, and a
+ * cleartext HTTP/2 server answers nothing else on its port — there is no ALPN to negotiate with.
+ *
+ * It is the gateway's own readiness, not the process's. The identity composition nested in this
+ * process connects before route discovery has settled, so a probe tied to that composition would
+ * report ready while the gateway still had no routes and no open port.
+ */
+export class Probe {
+    server = http.createServer();
+    port;
+    path;
+    ready = false;
+    startedAt = 0;
+    listening = false;
+    skipped = false;
+    constructor(port, path = PATH) {
+        this.port = port;
+        this.path = path;
+        this.server.on('request', (request, response) => this.listener(request, response));
+    }
+    async listen() {
+        this.startedAt = Date.now();
+        try {
+            await new Promise((resolve, reject) => {
+                this.server.once('error', reject);
+                this.server.listen(this.port, () => {
+                    this.server.removeListener('error', reject);
+                    resolve();
+                });
+            });
+        }
+        catch (error) {
+            // processes sharing a host share the port; in a pod nothing else claims it
+            if (error?.code === 'EADDRINUSE') {
+                this.skipped = true;
+                console.warn('Ready probe port already in use, skipping', { port: this.port });
+                return;
+            }
+            throw error;
+        }
+        this.listening = true;
+        // a probe answers while the process runs; it must never be the reason it keeps running
+        this.server.unref();
+    }
+    /** The gateway is listening and has routes: answer `200`. */
+    complete() {
+        this.ready = true;
+        // the IPC signal is not tied to the probe: a process that gave up the shared port is
+        // still ready, and pm2 `wait_ready` would otherwise block until `listen_timeout`
+        process.send?.('ready');
+    }
+    async close() {
+        this.ready = false;
+        if (!this.listening || this.skipped)
+            return;
+        this.listening = false;
+        // keep-alive connections would otherwise hold the server handle, delaying the exit
+        this.server.closeAllConnections();
+        await new Promise((resolve) => this.server.close(() => resolve()));
+    }
+    listener(request, response) {
+        if (request.url !== this.path) {
+            response.writeHead(404).end();
+            return;
+        }
+        if (this.ready)
+            response.writeHead(200, { 'cache-control': 'no-store' }).end();
+        else {
+            const remaining = Math.ceil((Date.now() - this.startedAt) / 1000).toString();
+            response.writeHead(503, { 'retry-after': remaining }).end();
+        }
+    }
+}
+export const PATH = '/.ready';
+//# sourceMappingURL=Probe.js.map

package/transpiled/HTTP/Probe.js.map

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

package/transpiled/HTTP/Server.d.ts

@@ -1,36 +1,56 @@
 import { Connector } from '@toa.io/core';
-import { type OutgoingMessage } from './messages';
-import { Context } from './Context';
+import { type OutgoingMessage } from './messages.js';
+import { Context } from './Context.js';
+import type { Protocol } from './types.js';
+import type { Bouncer, MCP, OAuth, RPC } from '../Annotation.js';
 export declare class Server extends Connector {
     private readonly server;
     private readonly properties;
+    /** Host to authority. A map: a `Host` of `constructor` names what a plain object answers. */
     private readonly authorities;
+    /** Tracked for the drain: `Http2Server` has no `closeIdleConnections`. */
+    private readonly sessions;
+    private readonly probe;
     private process?;
-    private ready;
-    private startedAt;
     private constructor();
     static create(options: Options): Server;
-    attach(process: Processing): void;
+    attach(process: Processor): void;
     protected open(): Promise<void>;
     protected close(): Promise<void>;
+    /** A malformed HTTP/1.1 request has no framing to answer in, so the status line is written by hand. */
+    private h1;
+    /** HTTP/2 has no `clientError`: failures surface per session, per stream, or per frame. */
+    private h2;
     private listener;
+    private serve;
     private success;
     private fail;
 }
-export declare const PORT = 8000;
-export declare const DELAY = 3;
+export declare const DRAIN = 10;
 interface Properties {
     authorities: Record<string, string>;
     methods: Set<string>;
     debug: boolean;
-    trace: boolean;
     port: number;
-    delay: number;
+    drain: number;
+    protocol: Protocol;
+    /** Port of the readiness probe, which is HTTP/1.1 whatever the gateway serves. */
+    probe: number;
+    /** The header the client address is read from; the connection's address without one. */
+    ip?: string;
+    /** Failed authentications an address may make; none are metered unless set. */
+    bouncer?: Bouncer;
+    /** The authorization server this context exposes; none is exposed without it. */
+    oauth?: OAuth;
+    /** JSON-RPC at `/.rpc`; none is served without it. */
+    rpc?: RPC;
+    /** MCP at `/.mcp`; none is served without it. */
+    mcp?: MCP;
 }
 export type Options = {
     authorities: Properties['authorities'];
 } & {
     [K in Exclude<keyof Properties, 'authorities'>]?: Properties[K];
 };
-export type Processing = (input: Context) => Promise<OutgoingMessage>;
+export type Processor = (input: Context) => Promise<OutgoingMessage>;
 export {};

package/transpiled/HTTP/Server.js

@@ -1,147 +1,304 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DELAY = exports.PORT = exports.Server = void 0;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_os_1 = __importDefault(require("node:os"));
-const http = __importStar(require("node:http"));
-const node_events_1 = require("node:events");
-const promises_1 = require("node:timers/promises");
-const core_1 = require("@toa.io/core");
-const messages_1 = require("./messages");
-const exceptions_1 = require("./exceptions");
-const Context_1 = require("./Context");
-class Server extends core_1.Connector {
-    server = http.createServer();
+import assert from 'node:assert';
+import fs from 'node:fs';
+import os from 'node:os';
+import * as http from 'node:http';
+import * as http2 from 'node:http2';
+import { once } from 'node:events';
+import { setTimeout } from 'node:timers/promises';
+import { console, current, decide, decode, run } from 'openspan';
+import { Connector } from '@toa.io/core';
+import { write } from './messages.js';
+import { ClientError, Exception } from './exceptions.js';
+import { Context } from './Context.js';
+import { Probe } from './Probe.js';
+import { PORT, PROBE } from '../const.js';
+export class Server extends Connector {
+    server;
     properties;
+    /** Host to authority. A map: a `Host` of `constructor` names what a plain object answers. */
     authorities;
+    /** Tracked for the drain: `Http2Server` has no `closeIdleConnections`. */
+    sessions = new Set();
+    probe;
     process;
-    ready = false;
-    startedAt = 0;
     constructor(properties) {
         super();
         this.properties = properties;
-        this.authorities = Object.fromEntries(Object.entries(properties.authorities).map(([key, value]) => [value, key]));
+        this.authorities = new Map(Object.entries(properties.authorities).map(([key, value]) => [value, key]));
+        this.server = instantiate(properties.protocol);
+        this.probe = new Probe(properties.probe);
         this.server.on('request', (req, res) => this.listener(req, res));
+        if (properties.protocol === 'h1')
+            this.h1(this.server);
+        else
+            this.h2(this.server);
     }
     static create(options) {
-        const properties = Object.assign({}, DEFAULTS, options);
+        const properties = { ...DEFAULTS, ...options };
         return new Server(properties);
     }
     attach(process) {
         this.process = process;
     }
     async open() {
-        this.startedAt = Date.now();
+        // answers 503 from here; the gateway's dependencies have settled by the time `open` runs
+        await this.probe.listen();
         this.server.listen(this.properties.port);
-        await (0, node_events_1.once)(this.server, 'listening');
+        await once(this.server, 'listening');
         console.info('HTTP Server is listening');
-        await (0, promises_1.setTimeout)(this.properties.delay);
-        this.ready = true;
+        this.probe.complete();
         console.info('Ready');
     }
     async close() {
+        await this.probe.close();
         this.server.close();
-        this.ready = false;
-        console.info('HTTP Server stopped accepting new connections');
-        await (0, node_events_1.once)(this.server, 'close');
-        console.info('HTTP Server has been stopped');
+        // GOAWAY lets in-flight streams finish; `Http2Server` has no `closeIdleConnections`
+        if (this.properties.protocol === 'h1')
+            this.server.closeIdleConnections();
+        else
+            for (const session of this.sessions)
+                session.close();
+        console.info('Stopped accepting new connections');
+        // keep-alive clients hold connections open indefinitely, so the drain is bounded
+        await Promise.race([
+            once(this.server, 'close'),
+            setTimeout(this.properties.drain, undefined, { ref: false })
+        ]);
+        if (this.properties.protocol === 'h1')
+            this.server.closeAllConnections();
+        else
+            for (const session of this.sessions)
+                session.destroy();
+        console.info('Stopped');
+    }
+    /** A malformed HTTP/1.1 request has no framing to answer in, so the status line is written by hand. */
+    h1(server) {
+        server.on('clientError', (error, socket) => {
+            console.warn('Client connection error', error);
+            if (socket.writable)
+                socket.end('HTTP/1.1 400 Bad Request\r\n\r\n');
+            else
+                socket.destroy();
+        });
+    }
+    /** HTTP/2 has no `clientError`: failures surface per session, per stream, or per frame. */
+    h2(server) {
+        server.on('session', (session) => {
+            this.sessions.add(session);
+            session.on('close', () => this.sessions.delete(session));
+        });
+        server.on('sessionError', (error) => console.warn('Session error', error));
+        server.on('streamError', (error) => console.warn('Stream error', error));
+        server.on('unknownProtocol', (socket) => {
+            console.warn('Unknown protocol');
+            socket.destroy();
+        });
     }
     listener(request, response) {
-        if (request.method === undefined || !this.properties.methods.has(request.method)) {
-            response.writeHead(501).end();
+        request.once('error', (error) => {
+            console.warn('Request error', errorAttributes(request, error));
+            if (!response.writableEnded)
+                response.destroy();
+        });
+        // no listener on `request.socket`: under HTTP/2 it is the session's socket, shared by
+        // every concurrent stream, and removing listeners on it would strip the siblings'
+        const host = authorityOf(request)?.toLowerCase();
+        if (host === undefined || !HOST.test(host)) {
+            console.warn('Request without a valid authority', errorAttributes(request, new Error('Invalid authority')));
+            response.writeHead(400).end();
             return;
         }
-        if (request.url === '/.ready') {
-            if (this.ready)
-                response.writeHead(200, { 'cache-control': 'no-store' }).end();
-            else {
-                const remaining = (Math.ceil((Date.now() - this.startedAt) / 1000)).toString();
-                response.writeHead(503, { 'retry-after': remaining }).end();
-            }
+        // directives and components read `host`; HTTP/2 sends `:authority` instead, and what a
+        // component sees must not depend on the protocol the request arrived over
+        request.headers.host ??= host;
+        const url = parse(request, host);
+        if (url instanceof Error) {
+            console.warn('Invalid request', errorAttributes(request, url));
+            response.writeHead(400).end();
             return;
         }
-        if (request.headers.host === undefined || !(request.headers.host in this.authorities)) {
-            response.writeHead(404).end('Unknown authority');
+        if (request.method === undefined || !this.properties.methods.has(request.method)) {
+            response.writeHead(501).end();
             return;
         }
-        const authority = this.authorities[request.headers.host];
-        const context = new Context_1.Context(authority, request, this.properties);
-        this.process(context)
-            .then(this.success(context, response))
-            .catch(this.fail(context, response));
+        assert(this.process !== undefined, 'Request processor is not attached');
+        const authority = this.authorities.get(host) ?? host;
+        // if the request carries no trace context, the trace starts here
+        const remote = trace(request.headers);
+        const processing = remote === null
+            ? this.serve(request, response, authority, url)
+            : run(remote, async () => await this.serve(request, response, authority, url));
+        processing.catch((error) => {
+            console.error('Request processing failed', error);
+            if (!response.writableEnded)
+                response.writeHead(500).end();
+        });
+    }
+    // eslint-disable-next-line max-params
+    async serve(request, response, authority, url) {
+        await console.span({
+            name: `${request.method} ${request.url}`,
+            kind: 'server',
+            service: 'exposition',
+            attributes: { method: request.method, url: request.url, authority }
+        }, async () => {
+            response.setHeader('ray', current().traceId);
+            const context = new Context(authority, request, this.properties, url);
+            await this.process(context)
+                .then(this.success(context, response))
+                .catch(this.fail(context, response))
+                .finally(() => request.removeAllListeners('error'));
+        });
     }
     success(context, response) {
-        return (message) => {
+        return async (message) => {
             let status = message.status;
             if (status === undefined)
                 if (message.body === null)
                     status = 404;
                 else if (context.request.method === 'POST')
                     status = 201;
-                else if (message.body === undefined)
+                else if (message.body === undefined && context.request.method !== 'HEAD')
                     status = 204;
                 else
                     status = 200;
-            response.statusCode = message.status = status;
-            (0, messages_1.write)(context, response, message);
+            message.status = status;
+            await write(context, response, message);
         };
     }
     fail(context, response) {
         return async (exception) => {
-            if (!context.request.complete)
-                await adam(context.request);
-            response.statusCode = exception instanceof exceptions_1.Exception ? exception.status : 500;
-            const message = { status: response.statusCode };
-            const verbose = exception instanceof exceptions_1.ClientError || this.properties.debug;
-            if (verbose)
-                message.body =
-                    exception instanceof exceptions_1.Exception
-                        ? exception.body
-                        : exception.stack ?? exception.message;
-            (0, messages_1.write)(context, response, message);
+            try {
+                // Over HTTP/2 the reply is followed by RST_STREAM(NO_ERROR), which tells the client
+                // to stop sending without discarding the response — so the body is never read.
+                if (!context.request.complete && this.properties.protocol === 'h1')
+                    await adam(context.request);
+                const status = exception instanceof Exception ? exception.status : 500;
+                const span = current();
+                // https://opentelemetry.io/docs/specs/semconv/http/http-spans/#status
+                if (status >= 500 && span !== undefined)
+                    span.status = 'error';
+                if (!response.writableEnded) {
+                    response.statusCode = status;
+                    const message = {
+                        status: response.statusCode,
+                        authentic: true
+                    };
+                    // eslint-disable-next-line max-depth
+                    if (exception instanceof Exception && exception.headers !== undefined)
+                        message.headers = exception.headers;
+                    // eslint-disable-next-line max-depth
+                    if (context.encoder === null)
+                        message.body = undefined;
+                    else if (exception instanceof ClientError || this.properties.debug)
+                        message.body =
+                            exception instanceof Exception
+                                ? exception.body
+                                : ((this.properties.debug && exception.stack) ?? exception.message);
+                    await write(context, response, message);
+                }
+            }
+            catch (final) {
+                console.error('Error in error handler', final);
+                if (!response.writableEnded)
+                    try {
+                        response.writeHead(500).end();
+                    }
+                    catch {
+                        // Nothing more we can do
+                    }
+            }
         };
     }
 }
-exports.Server = Server;
+function instantiate(protocol) {
+    if (protocol === 'h1')
+        return http.createServer();
+    return http2.createServer({
+        // realtime pins one stream per subscription, and they all share a session
+        maxSessionMemory: SESSION_MEMORY,
+        settings: { initialWindowSize: WINDOW }
+    });
+}
+/**
+ * The authority the request is addressed to. HTTP/2 carries it in `:authority` and omits
+ * `host` entirely, so reading `host` alone would leave every HTTP/2 request unattributed.
+ */
+function authorityOf(request) {
+    return request.headers[':authority'] ?? request.headers.host;
+}
+/** Parsing the URL is how a request is validated, so the `Context` is handed the result. */
+function parse(request, authority) {
+    try {
+        return new URL(request.url, `https://${authority}`);
+    }
+    catch (error) {
+        return error;
+    }
+}
 // https://github.com/whatwg/fetch/issues/1254
 async function adam(request) {
-    const devnull = node_fs_1.default.createWriteStream(node_os_1.default.devNull);
-    request.pipe(devnull);
-    return (0, node_events_1.once)(request, 'end');
+    const devnull = fs.createWriteStream(os.devNull);
+    devnull.on('error', () => undefined);
+    request.pipe(devnull).on('error', () => undefined);
+    await once(request, 'end');
+}
+function errorAttributes(request, error) {
+    const attributes = {
+        path: request.url,
+        method: request.method,
+        name: error.name
+    };
+    if (typeof error.code === 'string')
+        attributes.code = error.code;
+    if (typeof error.stack === 'string')
+        attributes.stack = error.stack;
+    return attributes;
+}
+export const DRAIN = 10; // seconds
+/** Megabytes a single HTTP/2 session may hold, over Node's default of 10. */
+const SESSION_MEMORY = 128;
+/** Per-stream flow control window. The default 64 KiB throttles in proportion to RTT. */
+const WINDOW = 1024 * 1024;
+/**
+ * Extracts the remote trace context from the request headers.
+ *
+ * The `ray` header adopts the trace by ID only and does not bypass sampling:
+ * the sampling decision is made by the server.
+ */
+function trace(headers) {
+    if (typeof headers.traceparent === 'string')
+        return decode(headers.traceparent);
+    // adopting a trace by ID does not bypass sampling
+    if (typeof headers.ray === 'string' &&
+        RAY.test(headers.ray) &&
+        headers.ray !== ZERO_RAY)
+        return { traceId: headers.ray.toLowerCase(), sampled: decide() };
+    return null;
 }
-exports.PORT = 8000;
-exports.DELAY = 3; // seconds
+/**
+ * A host name with an optional port, or a bracketed IPv6 literal. The URL parser admits
+ * `,` `;` `=` `(` `)` and quotes in a host, and the authority is written into criteria.
+ */
+const HOST = /^(?:[a-z0-9.-]{1,253}|\[[0-9a-f:.]{2,45}\])(?::\d{1,5})?$/;
+const RAY = /^[\da-f]{32}$/i;
+const ZERO_RAY = '0'.repeat(32);
 const DEFAULTS = {
-    methods: new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS']),
+    methods: new Set([
+        'OPTIONS',
+        'GET',
+        'HEAD',
+        'POST',
+        'PUT',
+        'PATCH',
+        'DELETE',
+        'LOCK',
+        'UNLOCK'
+    ]),
     debug: false,
-    trace: false,
-    port: exports.PORT,
-    delay: exports.DELAY * 1000
+    port: PORT,
+    drain: DRAIN * 1000,
+    protocol: 'h1',
+    probe: PROBE
 };
 //# sourceMappingURL=Server.js.map

package/transpiled/HTTP/Server.js.map

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

package/transpiled/HTTP/Timing.d.ts

@@ -1,10 +1,6 @@
-/// <reference types="node" />
-import type { ServerResponse } from 'node:http';
+import type { ServerResponse } from './types.js';
+/** How long the request took, from received to written: one number, the header's. */
 export declare class Timing {
-    private readonly skip;
     private readonly start;
-    private readonly breakpoints;
-    constructor(enabled: boolean);
-    capture<T>(id: string, promise: Promise<T>): Promise<T>;
     append(response: ServerResponse): void;
 }

package/transpiled/HTTP/Timing.js

@@ -1,29 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Timing = void 0;
-const node_perf_hooks_1 = require("node:perf_hooks");
-class Timing {
-    skip;
-    start = node_perf_hooks_1.performance.now();
-    breakpoints = [];
-    constructor(enabled) {
-        this.skip = !enabled;
-    }
-    async capture(id, promise) {
-        if (this.skip)
-            return promise;
-        const start = node_perf_hooks_1.performance.now();
-        const result = promise instanceof Promise ? await promise : promise;
-        this.breakpoints.push({ id, duration: node_perf_hooks_1.performance.now() - start });
-        return result;
-    }
+import { performance } from 'node:perf_hooks';
+/** How long the request took, from received to written: one number, the header's. */
+export class Timing {
+    start = performance.now();
     append(response) {
-        if (this.skip)
-            return;
-        this.breakpoints.push({ id: 'total', duration: node_perf_hooks_1.performance.now() - this.start });
-        for (const breakpoint of this.breakpoints)
-            response.appendHeader('server-timing', `${breakpoint.id};dur=${breakpoint.duration.toFixed(3)}`);
+        response.setHeader('server-timing', `total;dur=${(performance.now() - this.start).toFixed(3)}`);
     }
 }
-exports.Timing = Timing;
 //# sourceMappingURL=Timing.js.map

package/transpiled/HTTP/Timing.js.map

@@ -1 +1 @@
-{"version":3,"file":"Timing.js","sourceRoot":"","sources":["../../source/HTTP/Timing.ts"],"names":[],"mappings":";;;AAAA,qDAA6C;AAG7C,MAAa,MAAM;IACA,IAAI,CAAS;IACb,KAAK,GAAG,6BAAW,CAAC,GAAG,EAAE,CAAA;IACzB,WAAW,GAAiB,EAAE,CAAA;IAE/C,YAAoB,OAAgB;QAClC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAA;IACtB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAK,EAAU,EAAE,OAAmB;QACtD,IAAI,IAAI,CAAC,IAAI;YACX,OAAO,OAAO,CAAA;QAEhB,MAAM,KAAK,GAAG,6BAAW,CAAC,GAAG,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,OAAO,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;QAEnE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,6BAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;QAElE,OAAO,MAAM,CAAA;IACf,CAAC;IAEM,MAAM,CAAE,QAAwB;QACrC,IAAI,IAAI,CAAC,IAAI;YACX,OAAM;QAER,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,6BAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QAEhF,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW;YACvC,QAAQ,CAAC,YAAY,CAAC,eAAe,EACnC,GAAG,UAAU,CAAC,EAAE,QAAQ,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC/D,CAAC;CACF;AA/BD,wBA+BC"}
+{"version":3,"file":"Timing.js","sourceRoot":"","sources":["../../source/HTTP/Timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG7C,qFAAqF;AACrF,MAAM,OAAO,MAAM;IACA,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAEnC,MAAM,CAAC,QAAwB;QACpC,QAAQ,CAAC,SAAS,CAChB,eAAe,EACf,aAAa,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAC3D,CAAA;IACH,CAAC;CACF"}