@toa.io/extensions.exposition 1.0.0-alpha.26 → 1.0.0-alpha.263

package/transpiled/Gateway.js

@@ -22,8 +22,14 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __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.Gateway = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
+const promises_1 = require("node:timers/promises");
+const openspan_1 = require("openspan");
 const core_1 = require("@toa.io/core");
 const http = __importStar(require("./HTTP"));
 const exceptions_1 = require("./exceptions");
@@ -31,6 +37,12 @@ class Gateway extends core_1.Connector {
     broadcast;
     tree;
     interceptor;
+    branches = new Map();
+    lastMerge = 0;
+    widestGap = 0;
+    lastPing = 0;
+    stopped = false;
+    resolveFirstMerge = null;
     constructor(broadcast, tree, interception) {
         super();
         this.broadcast = broadcast;
@@ -42,13 +54,15 @@ class Gateway extends core_1.Connector {
         const interception = await context.timing.capture('intercept', this.interceptor.intercept(context));
         if (interception !== null)
             return interception;
-        const match = this.tree.match(context.url.pathname);
-        if (match === null)
-            throw new http.NotFound('Route not found');
-        const { node, parameters } = match;
-        if (!(context.request.method in node.methods))
+        const { node, parameters } = this.match(context);
+        if (context.request.method === 'OPTIONS')
+            return await this.explain(node, parameters);
+        let verb = context.request.method;
+        if (!(verb in node.methods) && verb === 'HEAD' && 'GET' in node.methods)
+            verb = 'GET';
+        if (!(verb in node.methods))
             throw new http.MethodNotAllowed();
-        const method = node.methods[context.request.method];
+        const method = node.methods[verb];
         const interruption = await context.timing.capture('preflight', method.directives.preflight(context, parameters)).catch(exceptions_1.rethrow);
         const response = interruption ??
             await context.timing.capture('call', this.call(method, context, parameters));
@@ -57,10 +71,30 @@ class Gateway extends core_1.Connector {
     }
     async open() {
         await this.discover();
-        console.info('Gateway has started and is awaiting resource branches');
+        openspan_1.console.info('Gateway started');
     }
     dispose() {
-        console.info('Gateway is closed');
+        this.stopped = true;
+        this.tree.dispose();
+        openspan_1.console.info('Gateway is closed');
+    }
+    match(context) {
+        const match = this.tree.match(context.url.pathname);
+        if (match === null) {
+            // the route may be missing because an expose has been lost
+            this.reping();
+            throw new http.NotFound('Route not found');
+        }
+        if (match.node.forward === null)
+            return match;
+        const destination = match.node.forward.replace(/\/:([^/]+)/g, (_, name) => {
+            const value = match.parameters.find((parameter) => parameter.name === name)?.value;
+            node_assert_1.default.ok(value !== undefined, `Forwarded parameter '${name}' not found`);
+            return `/${value}`;
+        });
+        const forward = this.tree.match(destination);
+        node_assert_1.default.ok(forward !== null, 'Forwarded route not found');
+        return forward;
     }
     async call(method, context, parameters) {
         if (context.url.pathname[context.url.pathname.length - 1] !== '/')
@@ -73,20 +107,111 @@ class Gateway extends core_1.Connector {
             .call(context, parameters)
             .catch(exceptions_1.rethrow);
     }
+    async explain(node, parameters) {
+        const body = await node.explain(parameters);
+        const allow = [...Object.keys(node.methods)].join(', ');
+        const headers = new Headers({ allow });
+        return { body, headers };
+    }
     async discover() {
+        const first = new Promise((resolve) => {
+            this.resolveFirstMerge = resolve;
+        });
         await this.broadcast.receive('expose', this.merge.bind(this));
-        await this.broadcast.transmit('ping', null);
+        void this.knock();
+        await this.settled(first);
+    }
+    /**
+     * A single ping is enough only if every tenant is listening by then, which is
+     * not the case while the deployment is still rolling out.
+     */
+    async knock() {
+        for (const delay of KNOCK_DELAYS) {
+            if (this.stopped)
+                return;
+            if (delay > 0)
+                await (0, promises_1.setTimeout)(delay, undefined, { ref: false });
+            await this.ping();
+        }
+    }
+    async ping() {
+        if (this.stopped)
+            return;
+        this.lastPing = Date.now();
+        await this.broadcast.transmit('ping', null)
+            .catch((exception) => openspan_1.console.error('Discovery ping failed', { message: exception.message }));
+    }
+    reping() {
+        if (Date.now() - this.lastPing < PING_COOLDOWN)
+            return;
+        void this.ping();
+    }
+    async settled(first) {
+        const deadline = Date.now() + SETTLE_TIMEOUT;
+        const abort = new AbortController();
+        // an uncancelled timer keeps the process alive long after the race is won
+        await Promise.race([first, (0, promises_1.setTimeout)(SETTLE_TIMEOUT, undefined, { signal: abort.signal })])
+            .finally(() => { abort.abort(); })
+            .catch(() => { });
+        if (this.lastMerge === 0) {
+            openspan_1.console.warn('Discovery timed out waiting for the first expose');
+            return;
+        }
+        while (Date.now() - this.lastMerge < this.quiet()) {
+            if (Date.now() >= deadline)
+                break;
+            await (0, promises_1.setTimeout)(SETTLE_POLL);
+        }
+    }
+    /**
+     * How long the branches must stay quiet before discovery counts as settled.
+     *
+     * Every tenant of a local composition answers the first ping at once, so a short window
+     * is enough; a rolling deployment brings them up seconds apart, and the window grows with
+     * the widest gap seen so far to keep waiting for the ones still starting.
+     */
+    quiet() {
+        const adaptive = this.widestGap * SETTLE_QUIET_FACTOR;
+        return Math.min(Math.max(adaptive, SETTLE_QUIET_MIN), SETTLE_QUIET_MAX);
     }
     merge(branch) {
+        const id = branch.namespace + '.' + branch.component;
+        const attributes = {
+            namespace: branch.namespace,
+            component: branch.component,
+            version: branch.version
+        };
+        const exposed = this.branches.get(id);
+        // rebuilding an identical branch would only tear down its live endpoints
+        if (exposed?.version === branch.version) {
+            this.tree.refresh(exposed.nodes);
+            openspan_1.console.debug('Branch refreshed', attributes);
+            return;
+        }
+        let nodes;
         try {
-            this.tree.merge(branch.node, branch);
-            console.info('Resource branch of ' +
-                `'${branch.namespace}.${branch.component}' has been merged`);
+            nodes = this.tree.merge(branch.node, branch);
         }
         catch (exception) {
-            console.error(exception);
+            const message = exception instanceof Error ? exception.message : 'Unknown error';
+            openspan_1.console.error('Branch merge exception', { message, ...attributes });
+            return;
         }
+        this.branches.set(id, { version: branch.version, nodes });
+        if (this.lastMerge !== 0)
+            this.widestGap = Math.max(this.widestGap, Date.now() - this.lastMerge);
+        this.lastMerge = Date.now();
+        this.resolveFirstMerge?.();
+        this.resolveFirstMerge = null;
+        openspan_1.console.info('Branch merged', attributes);
     }
 }
 exports.Gateway = Gateway;
+const SETTLE_QUIET_MIN = 500;
+const SETTLE_QUIET_MAX = 10_000;
+const SETTLE_QUIET_FACTOR = 2;
+const SETTLE_TIMEOUT = 30_000;
+const SETTLE_POLL = 50;
+const KNOCK_DELAYS = [0, 500, 1000, 1500];
+const PING_COOLDOWN = 5_000;
 //# sourceMappingURL=Gateway.js.map

package/transpiled/Gateway.js.map

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

package/transpiled/HTTP/Context.d.ts

@@ -1,9 +1,12 @@
 /// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
 import { Timing } from './Timing';
 import { type Format } from './formats';
 import type { OutgoingMessage } from './messages';
 import type * as http from 'node:http';
 export declare class Context {
+    readonly id: string;
     readonly authority: string;
     readonly request: IncomingMessage;
     readonly url: URL;
@@ -12,8 +15,11 @@ export declare class Context {
     readonly timing: Timing;
     readonly debug: boolean;
     readonly pipelines: Pipelines;
+    private consumed;
     constructor(authority: string, request: IncomingMessage, properties: Properties);
+    buffer(): Promise<Buffer>;
     body<T>(): Promise<T>;
+    private log;
 }
 export interface IncomingMessage extends http.IncomingMessage {
     url: string;
@@ -21,10 +27,9 @@ export interface IncomingMessage extends http.IncomingMessage {
 }
 interface Pipelines {
     body: Array<(input: unknown) => unknown>;
-    response: Array<(output: OutgoingMessage) => void>;
+    response: Array<(output: OutgoingMessage) => void | Promise<void>>;
 }
 interface Properties {
     debug: boolean;
-    trace: boolean;
 }
 export {};

package/transpiled/HTTP/Context.js

@@ -4,11 +4,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Context = void 0;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const consumers_1 = require("node:stream/consumers");
 const negotiator_1 = __importDefault(require("negotiator"));
+const openspan_1 = require("openspan");
 const Timing_1 = require("./Timing");
 const formats_1 = require("./formats");
 const messages_1 = require("./messages");
 class Context {
+    id;
     authority;
     request;
     url;
@@ -20,12 +24,15 @@ class Context {
         body: [],
         response: []
     };
+    consumed = false;
     constructor(authority, request, properties) {
         this.authority = authority;
         this.request = request;
+        this.id = node_crypto_1.default.randomUUID();
         this.url = new URL(request.url, `https://${request.headers.host}`);
-        this.timing = new Timing_1.Timing(properties.trace);
+        this.timing = new Timing_1.Timing();
         this.debug = properties.debug;
+        this.log(request);
         if (this.request.headers.accept !== undefined) {
             const match = SUBTYPE.exec(this.request.headers.accept);
             if (match !== null) {
@@ -39,11 +46,22 @@ class Context {
         if (mediaType !== undefined)
             this.encoder = formats_1.formats[mediaType];
     }
+    async buffer() {
+        this.consumed = true;
+        return await (0, consumers_1.buffer)(this.request);
+    }
     async body() {
-        const value = await (0, messages_1.read)(this);
-        return this.pipelines.body.length === 0
-            ? value
-            : this.pipelines.body.reduce((value, transform) => transform(value), value);
+        let value = this.consumed ? null : await (0, messages_1.read)(this);
+        for (const transform of this.pipelines.body)
+            value = await transform(value);
+        return value;
+    }
+    log(request) {
+        const headers = { ...request.headers };
+        if (headers.authorization !== undefined)
+            // only scheme
+            headers.authorization = headers.authorization.slice(0, headers.authorization.indexOf(' '));
+        openspan_1.console.debug('Received request', { method: request.method, url: request.url, headers });
     }
 }
 exports.Context = Context;

package/transpiled/HTTP/Context.js.map

@@ -1 +1 @@
-{"version":3,"file":"Context.js","sourceRoot":"","sources":["../../source/HTTP/Context.ts"],"names":[],"mappings":";;;;;;AAAA,4DAAmC;AACnC,qCAAiC;AACjC,uCAAuD;AACvD,yCAAiC;AAIjC,MAAa,OAAO;IACF,SAAS,CAAQ;IACjB,OAAO,CAAiB;IACxB,GAAG,CAAK;IACR,OAAO,GAAkB,IAAI,CAAA;IAC7B,OAAO,GAAkB,IAAI,CAAA;IAC7B,MAAM,CAAQ;IACd,KAAK,CAAS;IAEd,SAAS,GAAc;QACrC,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,EAAE;KACb,CAAA;IAED,YAAoB,SAAiB,EAAE,OAAwB,EAAE,UAAsB;QACrF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QAEtB,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QAClE,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QAC1C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAA;QAE7B,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAEvD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,EACJ,IAAI,EACJ,OAAO,EACP,MAAM,EACP,GAAG,KAAK,CAAC,MAAO,CAAA;gBAEjB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,MAAM,EAAE,CAAA;gBACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;YACxB,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,oBAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,eAAK,CAAC,CAAA;QAE7C,IAAI,SAAS,KAAK,SAAS;YACzB,IAAI,CAAC,OAAO,GAAG,iBAAO,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,MAAM,KAAK,GAAG,MAAM,IAAA,eAAI,EAAC,IAAI,CAAC,CAAA;QAE9B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YACrC,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAA;IAC/E,CAAC;CACF;AAnDD,0BAmDC;AAiBD,MAAM,OAAO,GAAG,4EAA4E,CAAA"}
+{"version":3,"file":"Context.js","sourceRoot":"","sources":["../../source/HTTP/Context.ts"],"names":[],"mappings":"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"}

package/transpiled/HTTP/Server.d.ts

@@ -10,27 +10,32 @@ export declare class Server extends Connector {
     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>;
     private listener;
+    private serve;
     private success;
     private fail;
 }
 export declare const PORT = 8000;
+/**
+ * The initial delay of the readiness probe. The server does not sleep for it: whoever
+ * probes is the one that waits, and doing it here as well only delayed the process twice.
+ */
 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;
 }
 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

@@ -26,12 +26,14 @@ 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;
+exports.DRAIN = exports.DELAY = exports.PORT = exports.Server = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
 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 openspan_1 = require("openspan");
 const core_1 = require("@toa.io/core");
 const messages_1 = require("./messages");
 const exceptions_1 = require("./exceptions");
@@ -48,9 +50,16 @@ class Server extends core_1.Connector {
         this.properties = properties;
         this.authorities = Object.fromEntries(Object.entries(properties.authorities).map(([key, value]) => [value, key]));
         this.server.on('request', (req, res) => this.listener(req, res));
+        this.server.on('clientError', (error, socket) => {
+            openspan_1.console.warn('Client connection error', error);
+            if (socket.writable)
+                socket.end('HTTP/1.1 400 Bad Request\r\n\r\n');
+            else
+                socket.destroy();
+        });
     }
     static create(options) {
-        const properties = Object.assign({}, DEFAULTS, options);
+        const properties = { ...DEFAULTS, ...options };
         return new Server(properties);
     }
     attach(process) {
@@ -60,19 +69,41 @@ class Server extends core_1.Connector {
         this.startedAt = Date.now();
         this.server.listen(this.properties.port);
         await (0, node_events_1.once)(this.server, 'listening');
-        console.info('HTTP Server is listening');
-        await (0, promises_1.setTimeout)(this.properties.delay);
+        openspan_1.console.info('HTTP Server is listening');
         this.ready = true;
-        console.info('Ready');
+        openspan_1.console.info('Ready');
+        process.send?.('ready');
     }
     async 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');
+        this.server.close();
+        this.server.closeIdleConnections();
+        openspan_1.console.info('Stopped accepting new connections');
+        // keep-alive clients hold connections open indefinitely, so the drain is bounded
+        await Promise.race([
+            (0, node_events_1.once)(this.server, 'close'),
+            (0, promises_1.setTimeout)(this.properties.drain, undefined, { ref: false })
+        ]);
+        this.server.closeAllConnections();
+        openspan_1.console.info('Stopped');
     }
     listener(request, response) {
+        request.once('error', (error) => {
+            openspan_1.console.warn('Request error', errorAttributes(request, error));
+            if (!response.writableEnded)
+                response.destroy();
+        });
+        request.socket.once('error', (error) => {
+            openspan_1.console.warn('Socket error', errorAttributes(request, error));
+            if (!response.writableEnded)
+                response.destroy();
+        });
+        const invalid = validate(request);
+        if (invalid !== null) {
+            openspan_1.console.warn('Invalid request', errorAttributes(request, invalid));
+            response.writeHead(400).end();
+            return;
+        }
         if (request.method === undefined || !this.properties.methods.has(request.method)) {
             response.writeHead(501).end();
             return;
@@ -86,62 +117,159 @@ class Server extends core_1.Connector {
             }
             return;
         }
-        if (request.headers.host === undefined || !(request.headers.host in this.authorities)) {
-            response.writeHead(404).end('Unknown authority');
-            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));
+        (0, node_assert_1.default)(this.process !== undefined, 'Request processor is not attached');
+        const host = request.headers.host;
+        const authority = this.authorities[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)
+            : (0, openspan_1.run)(remote, async () => await this.serve(request, response, authority));
+        processing.catch((error) => {
+            openspan_1.console.error('Request processing failed', error);
+            if (!response.writableEnded)
+                response.writeHead(500).end();
+        });
+    }
+    async serve(request, response, authority) {
+        await openspan_1.console.span({
+            name: `${request.method} ${request.url}`,
+            kind: 'server',
+            service: 'exposition',
+            attributes: { method: request.method, url: request.url, authority }
+        }, async () => {
+            response.setHeader('ray', (0, openspan_1.current)().traceId);
+            const context = new Context_1.Context(authority, request, this.properties);
+            await this.process(context)
+                .then(this.success(context, response))
+                .catch(this.fail(context, response))
+                .finally(() => {
+                request.removeAllListeners('error');
+                request.socket.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 (0, messages_1.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 {
+                if (!context.request.complete)
+                    await adam(context.request);
+                const status = exception instanceof exceptions_1.Exception ? exception.status : 500;
+                const span = (0, openspan_1.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 };
+                    // eslint-disable-next-line max-depth
+                    if (context.encoder === null)
+                        message.body = undefined;
+                    else if (exception instanceof exceptions_1.ClientError || this.properties.debug)
+                        message.body =
+                            exception instanceof exceptions_1.Exception
+                                ? exception.body
+                                : (this.properties.debug && exception.stack) ?? exception.message;
+                    await (0, messages_1.write)(context, response, message);
+                }
+            }
+            catch (final) {
+                openspan_1.console.error('Error in error handler', final);
+                if (!response.writableEnded)
+                    try {
+                        response.writeHead(500).end();
+                    }
+                    catch (e) {
+                        // Nothing more we can do
+                    }
+            }
         };
     }
 }
 exports.Server = Server;
+function validate(request) {
+    try {
+        void new URL(request.url, `https://${request.headers.host}`);
+        return null;
+    }
+    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');
+    devnull.on('error', () => undefined);
+    request.pipe(devnull).on('error', () => undefined);
+    await (0, node_events_1.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;
 }
 exports.PORT = 8000;
+/**
+ * The initial delay of the readiness probe. The server does not sleep for it: whoever
+ * probes is the one that waits, and doing it here as well only delayed the process twice.
+ */
 exports.DELAY = 3; // seconds
+exports.DRAIN = 10; // seconds
+/**
+ * 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 (0, openspan_1.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: (0, openspan_1.decide)() };
+    return null;
+}
+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
+    drain: exports.DRAIN * 1000
 };
+/**
+ * I'm too fucking dumb to figure out how to handle this in a better way.
+ * It can be reproduced by calling `response.destroy()` on the client side while reading
+ * an empty stream.
+ */
+process.on('uncaughtException', (err) => {
+    const code = err.code;
+    if (code === 'ECONNRESET' || code === 'EPIPE')
+        openspan_1.console.warn('Connection reset by peer', code);
+    else
+        throw err;
+});
 //# sourceMappingURL=Server.js.map