@zmdb/app 1.0.0-beta.1

package/dist/messaging/index.js

@@ -0,0 +1,442 @@
+// @zmdb/app — transport-neutral message dispatch and application-extension
+// contracts. Strategies own broker framing and settlement; the framework owns
+// validation, handler dispatch, request correlation and bounded client waits.
+import { applicationExtensionControllersOf } from '../application.js';
+import { consumerSpan, toTraceHeaders } from '../observability/index.js';
+export { abortError, decodeDelivery, decodeReply, encodeDelivery, encodeReply, InFlight, reportTransportError, withinGrace, } from './transport-kit.js';
+/** A request was made against a strategy without request/reply support. */
+export class TransportUnsupportedError extends Error {
+    transport;
+    operation;
+    constructor(transport) {
+        super(`transport "${transport}" does not support request/response`);
+        this.name = 'TransportUnsupportedError';
+        this.transport = transport;
+        this.operation = 'send';
+    }
+}
+/** A request did not settle before its required deadline. */
+export class MessageTimeoutError extends Error {
+    pattern;
+    timeoutMs;
+    correlationId;
+    constructor(pattern, timeoutMs, correlationId) {
+        super(`message request "${pattern}" timed out after ${String(timeoutMs)}ms`);
+        this.name = 'MessageTimeoutError';
+        this.pattern = pattern;
+        this.timeoutMs = timeoutMs;
+        this.correlationId = correlationId;
+    }
+}
+/** A remote handler failed without exposing its private error detail. */
+export class MessageRemoteError extends Error {
+    pattern;
+    correlationId;
+    constructor(pattern, correlationId, message) {
+        super(message);
+        this.name = 'MessageRemoteError';
+        this.pattern = pattern;
+        this.correlationId = correlationId;
+    }
+}
+/** A transport returned a reply for a different outstanding request. */
+export class MessageCorrelationError extends Error {
+    pattern;
+    expected;
+    received;
+    constructor(pattern, expected, received) {
+        super(`message request "${pattern}" received correlation "${received}", expected "${expected}"`);
+        this.name = 'MessageCorrelationError';
+        this.pattern = pattern;
+        this.expected = expected;
+        this.received = received;
+    }
+}
+const MESSAGE_PATTERNS = Symbol('zmdb.app.messaging.patterns');
+const DEFAULT_MAX_ATTEMPTS = 5;
+const MAX_RETRY_MS = 30_000;
+// boundary: MessagePattern and EventPattern are the only writers of this
+// private metadata slot, so the typed view is sound.
+function messageMetadata(metadata) {
+    return metadata;
+}
+function pushPattern(metadata, pattern) {
+    const view = messageMetadata(metadata);
+    const own = Object.hasOwn(metadata, MESSAGE_PATTERNS) ? view[MESSAGE_PATTERNS] : undefined;
+    if (own === undefined) {
+        view[MESSAGE_PATTERNS] = [pattern];
+    }
+    else {
+        own.push(pattern);
+    }
+}
+function ownPatterns(metadata) {
+    if (!Object.hasOwn(metadata, MESSAGE_PATTERNS)) {
+        return [];
+    }
+    return messageMetadata(metadata)[MESSAGE_PATTERNS] ?? [];
+}
+function storedPatterns(cls) {
+    const metadata = cls[Symbol.metadata];
+    if (metadata === undefined || metadata === null) {
+        return [];
+    }
+    const baseFirst = [];
+    for (let record = metadata; record !== null; record = Object.getPrototypeOf(record)) {
+        baseFirst.unshift(record);
+    }
+    let composed = [];
+    for (const record of baseFirst) {
+        const own = ownPatterns(record);
+        if (own.length === 0) {
+            continue;
+        }
+        const overridden = new Set(own.map(pattern => pattern.handlerName));
+        composed = [...composed.filter(pattern => !overridden.has(pattern.handlerName)), ...own];
+    }
+    return composed;
+}
+function patternDecorator(pattern, validate, semantics) {
+    return function (_target, context) {
+        const handlerName = String(context.name);
+        pushPattern(context.metadata, { pattern, handlerName, semantics, validate });
+    };
+}
+/** Declare a request/reply handler with its consume-boundary validator. */
+export function MessagePattern(pattern, validate) {
+    return patternDecorator(pattern, validate, 'request');
+}
+/** Declare a one-way event handler. Returning a value is a compile error. */
+export function EventPattern(pattern, validate) {
+    return patternDecorator(pattern, validate, 'event');
+}
+/** Read declarations from one class without constructing or discovering it. */
+export function getMessagePatterns(cls) {
+    return storedPatterns(cls).map(({ pattern, handlerName, semantics }) => ({ pattern, handlerName, semantics }));
+}
+function constructorOf(instance) {
+    const ctor = instance.constructor;
+    if (typeof ctor !== 'function') {
+        throw new Error('@zmdb/app: message consumer has no constructor');
+    }
+    return ctor;
+}
+function boundPatterns(instance) {
+    return storedPatterns(constructorOf(instance)).map(pattern => {
+        const value = Reflect.get(instance, pattern.handlerName);
+        if (typeof value !== 'function') {
+            throw new Error(`@zmdb/app: message handler "${pattern.handlerName}" is not callable`);
+        }
+        return {
+            ...pattern,
+            async invoke(ctx) {
+                return Reflect.apply(value, instance, [ctx]);
+            },
+        };
+    });
+}
+function positiveInteger(value, name) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new RangeError(`@zmdb/app: ${name} must be a positive integer`);
+    }
+    return value;
+}
+function defaultRetryAfter(attempt) {
+    return Math.min(MAX_RETRY_MS, 1_000 * 2 ** Math.max(0, attempt - 1));
+}
+function observe(action) {
+    try {
+        void Promise.resolve(action()).catch(() => undefined);
+    }
+    catch {
+        // Observation cannot replace dispatch or settlement.
+    }
+}
+function withReply(settlement, reply) {
+    return reply === undefined ? { settlement } : { settlement, reply };
+}
+function errorReply(message, detail) {
+    if (message.replyTo === undefined || message.correlationId === undefined) {
+        return undefined;
+    }
+    return { kind: 'error', correlationId: message.correlationId, message: detail };
+}
+function isRequestEnvelope(message) {
+    return message.replyTo !== undefined && message.correlationId !== undefined;
+}
+/** Build one exact-pattern map for the supplied application-owned consumers. */
+export function createMessageDispatcher(consumers, options) {
+    const maxAttempts = positiveInteger(options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS, 'maxAttempts');
+    const byPattern = new Map();
+    for (const consumer of consumers) {
+        for (const pattern of boundPatterns(consumer)) {
+            if (pattern.pattern.length === 0) {
+                throw new RangeError('@zmdb/app: a message pattern cannot be empty');
+            }
+            if (byPattern.has(pattern.pattern)) {
+                throw new Error(`@zmdb/app: duplicate message pattern "${pattern.pattern}"`);
+            }
+            byPattern.set(pattern.pattern, pattern);
+        }
+    }
+    const failureSettlement = (message, error) => {
+        observe(() => options.onHandlerError(message, error));
+        if (message.deliveryAttempt >= maxAttempts) {
+            return { kind: 'dead', reason: 'attempts-exhausted' };
+        }
+        const retryAfter = options.retryAfterMs ?? defaultRetryAfter;
+        let afterMs;
+        try {
+            afterMs = positiveInteger(retryAfter(message.deliveryAttempt), 'retryAfterMs result');
+        }
+        catch (policyError) {
+            observe(() => options.onHandlerError(message, policyError));
+            return { kind: 'dead', reason: 'invalid-retry-policy' };
+        }
+        return { kind: 'retry', afterMs };
+    };
+    return {
+        patterns: [...byPattern.keys()],
+        async dispatch(message, transport) {
+            const binding = byPattern.get(message.pattern);
+            if (binding === undefined) {
+                observe(() => options.onUnhandled(message));
+                return withReply({ kind: 'ack' }, errorReply(message, 'message pattern is not handled'));
+            }
+            if (message.parseError !== undefined) {
+                observe(() => options.onInvalidPayload(message, message.parseError));
+                return withReply({ kind: 'dead', reason: 'invalid-payload' }, errorReply(message, 'invalid message payload'));
+            }
+            let payload;
+            try {
+                payload = binding.validate(message.payload);
+            }
+            catch (error) {
+                observe(() => options.onInvalidPayload(message, error));
+                return withReply({ kind: 'dead', reason: 'invalid-payload' }, errorReply(message, 'invalid message payload'));
+            }
+            if (binding.semantics === 'request' && !isRequestEnvelope(message)) {
+                const error = new Error(`request pattern "${message.pattern}" requires correlationId and replyTo`);
+                observe(() => options.onHandlerError(message, error));
+                return { settlement: { kind: 'dead', reason: 'invalid-request-envelope' } };
+            }
+            const context = {
+                kind: 'message',
+                pattern: message.pattern,
+                payload,
+                headers: message.headers,
+                correlationId: message.correlationId ?? globalThis.crypto.randomUUID(),
+                deliveryAttempt: message.deliveryAttempt,
+                transport,
+                ...(options.observability?.tracer === undefined
+                    ? {}
+                    : {
+                        span: consumerSpan(options.observability, message, binding.semantics === 'request' ? 'request-reply' : 'queued'),
+                    }),
+            };
+            try {
+                const result = await binding.invoke(context);
+                if (binding.semantics === 'request' && message.correlationId !== undefined) {
+                    return {
+                        settlement: { kind: 'ack' },
+                        reply: { kind: 'result', correlationId: message.correlationId, payload: result },
+                    };
+                }
+                return { settlement: { kind: 'ack' } };
+            }
+            catch (error) {
+                context.span?.recordException(error instanceof Error ? error : new Error(String(error)));
+                context.span?.setStatus({ error: true });
+                if (binding.semantics === 'request') {
+                    observe(() => options.onHandlerError(message, error));
+                    return withReply({ kind: 'ack' }, errorReply(message, 'message handler failed'));
+                }
+                return { settlement: failureSettlement(message, error) };
+            }
+            finally {
+                context.span?.end();
+            }
+        },
+    };
+}
+/**
+ * Attach transport strategies to the protocol-neutral application lifecycle.
+ *
+ * The strategy snapshot and exact-pattern dispatcher are application-owned;
+ * concrete broker clients remain outside this package.
+ */
+export function transportExtension(options) {
+    const transports = Object.freeze([...options.transports]);
+    const dispatcherOptions = options.dispatcher;
+    let entered = [];
+    return {
+        name: '@zmdb/app:messaging',
+        async start(context) {
+            validateTransportNames(transports);
+            validateLazyConsumers(applicationExtensionControllersOf(context));
+            for (const transport of transports) {
+                validateUndeliverableSink(transport, dispatcherOptions);
+            }
+            const dispatcher = createMessageDispatcher(context.controllers, {
+                ...dispatcherOptions,
+                observability: context.observability,
+            });
+            for (const transport of transports) {
+                entered.push(transport);
+                await transport.listen(async (message) => {
+                    const outcome = await dispatcher.dispatch(message, transport.name);
+                    reportUndeliverable(transport, dispatcherOptions, message, outcome.settlement);
+                    return outcome;
+                });
+            }
+        },
+        async stop({ graceMs }) {
+            const errors = [];
+            const deadline = Date.now() + graceMs;
+            for (let index = entered.length - 1; index >= 0; index -= 1) {
+                const transport = entered[index];
+                if (transport === undefined)
+                    continue;
+                try {
+                    await transport.close(Math.max(0, deadline - Date.now()));
+                }
+                catch (error) {
+                    errors.push(error);
+                }
+            }
+            entered = [];
+            throwTransportErrors(errors);
+        },
+    };
+}
+function validateTransportNames(transports) {
+    const names = new Set();
+    for (const transport of transports) {
+        if (transport.name.length === 0) {
+            throw new RangeError('@zmdb/app: a transport name cannot be empty');
+        }
+        if (names.has(transport.name)) {
+            throw new Error(`@zmdb/app: duplicate transport name "${transport.name}"`);
+        }
+        names.add(transport.name);
+    }
+}
+function validateLazyConsumers(controllers) {
+    for (const binding of controllers) {
+        if (binding.kind === 'deferred' && getMessagePatterns(binding.controller).length > 0) {
+            throw new Error(`@zmdb/app: lazy controller "${binding.controller.name}" declares message patterns; ` +
+                'message consumers must be eager');
+        }
+    }
+}
+function validateUndeliverableSink(transport, options) {
+    if ((!transport.capabilities.redelivery || !transport.capabilities.deadLetter) &&
+        options.onUndeliverable === undefined) {
+        throw new Error(`@zmdb/app: transport "${transport.name}" requires onUndeliverable`);
+    }
+}
+function reportUndeliverable(transport, options, message, settlement) {
+    const dropped = (settlement.kind === 'retry' && !transport.capabilities.redelivery) ||
+        (settlement.kind === 'dead' && !transport.capabilities.deadLetter);
+    if (!dropped || options.onUndeliverable === undefined) {
+        return;
+    }
+    observe(() => options.onUndeliverable?.(message, settlement));
+}
+function throwTransportErrors(errors) {
+    if (errors.length === 0)
+        return;
+    const first = errors[0];
+    if (errors.length === 1 && first !== undefined)
+        throw first;
+    throw new AggregateError(errors, '@zmdb/app: transport shutdown failed');
+}
+function requestMethod(transport, pattern, timeoutMs, validate) {
+    return async (payload, span) => {
+        if (!transport.capabilities.requestResponse) {
+            throw new TransportUnsupportedError(transport.name);
+        }
+        const correlationId = globalThis.crypto.randomUUID();
+        const controller = new AbortController();
+        const timeoutError = new MessageTimeoutError(pattern, timeoutMs, correlationId);
+        let timer;
+        const timeout = new Promise((_resolve, reject) => {
+            timer = setTimeout(() => {
+                controller.abort(timeoutError);
+                reject(timeoutError);
+            }, timeoutMs);
+        });
+        const request = {
+            pattern,
+            payload,
+            correlationId,
+            timeoutMs,
+            signal: controller.signal,
+            ...(span === undefined ? {} : toTraceHeaders(span)),
+        };
+        try {
+            const reply = await Promise.race([Promise.resolve().then(() => transport.send(request)), timeout]);
+            if (reply.correlationId !== correlationId) {
+                throw new MessageCorrelationError(pattern, correlationId, reply.correlationId);
+            }
+            if (reply.kind === 'error') {
+                throw new MessageRemoteError(pattern, correlationId, reply.message);
+            }
+            return Reflect.apply(validate, undefined, [reply.payload]);
+        }
+        finally {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+        }
+    };
+}
+/** Build a typed request client from a total response-validator map. */
+export function createMessageClient(transport, options) {
+    const timeoutMs = positiveInteger(options.timeoutMs, 'timeoutMs');
+    // boundary: the mapped type and total validator map have the same key set;
+    // every own validator key is installed before the client is returned.
+    const client = Object.create(null);
+    for (const pattern of Object.keys(options.validate)) {
+        const validator = Reflect.get(options.validate, pattern);
+        if (typeof validator !== 'function') {
+            throw new Error(`@zmdb/app: message pattern "${pattern}" has no response validator`);
+        }
+        const installed = Reflect.set(client, pattern, requestMethod(transport, pattern, timeoutMs, validator));
+        if (!installed) {
+            throw new Error(`@zmdb/app: could not install message client pattern "${pattern}"`);
+        }
+    }
+    return client;
+}
+/** Build a typed one-way publisher. Methods are cached on first property access. */
+export function createEventPublisher(transport) {
+    const methods = new Map();
+    // boundary: the mapped return type limits consumer-visible properties to
+    // keyof E; the proxy only turns those string properties into emit calls.
+    const target = Object.create(null);
+    return new Proxy(target, {
+        get(_target, property, receiver) {
+            if (typeof property !== 'string') {
+                return Reflect.get(target, property, receiver);
+            }
+            if (property === 'then') {
+                // A synthesized `then` makes the publisher a never-settling thenable.
+                return undefined;
+            }
+            const existing = methods.get(property);
+            if (existing !== undefined) {
+                return existing;
+            }
+            const method = (payload, span) => {
+                if (span === undefined) {
+                    return transport.emit(property, payload);
+                }
+                return transport.emit(property, payload, toTraceHeaders(span));
+            };
+            methods.set(property, method);
+            return method;
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/messaging/index.js.map

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

package/dist/messaging/transport-kit.d.ts

@@ -0,0 +1,22 @@
+import type { TraceCarrier } from '../observability/index.js';
+import type { MessageReply, RawMessage } from './index.js';
+export interface DeliveryMetadata {
+    readonly correlationId?: string;
+    readonly replyTo?: string;
+}
+export declare function encodeDelivery(payload: unknown, carrier: TraceCarrier | undefined, metadata?: DeliveryMetadata): string;
+export declare function decodeDelivery(pattern: string, text: string, deliveryAttempt: number, metadata?: DeliveryMetadata): RawMessage;
+export declare function encodeReply(reply: MessageReply): string;
+export declare function decodeReply(text: string): MessageReply;
+export type TransportErrorSink = (error: unknown) => void;
+export declare function reportTransportError(sink: TransportErrorSink, error: unknown): void;
+export declare class InFlight {
+    #private;
+    constructor(onError: TransportErrorSink);
+    run(action: () => Promise<void>): Promise<void>;
+    stop(): void;
+    settled(): Promise<void>;
+}
+export declare function withinGrace(action: Promise<void>, graceMs: number): Promise<boolean>;
+export declare function abortError(signal: AbortSignal): unknown;
+//# sourceMappingURL=transport-kit.d.ts.map

package/dist/messaging/transport-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-kit.d.ts","sourceRoot":"","sources":["../../src/messaging/transport-kit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAqCD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,QAAQ,GAAE,gBAAqB,GAC9B,MAAM,CAcR;AAoBD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,QAAQ,GAAE,gBAAqB,GAC9B,UAAU,CAmDZ;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEvD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAiBtD;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAMnF;AAED,qBAAa,QAAQ;;IAKnB,YAAY,OAAO,EAAE,kBAAkB,EAEtC;IAED,GAAG,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9C;IAED,IAAI,IAAI,IAAI,CAEX;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7B;CACF;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc1F;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEvD"}

package/dist/messaging/transport-kit.js

@@ -0,0 +1,174 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stringRecord(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry !== 'string') {
+            return undefined;
+        }
+        result[key] = entry;
+    }
+    return result;
+}
+function optionalString(value) {
+    return value === undefined || typeof value === 'string' ? value : false;
+}
+function encode(value, description) {
+    let encoded;
+    try {
+        encoded = JSON.stringify(value);
+    }
+    catch (error) {
+        throw new TypeError(`@zmdb/app: ${description} is not JSON-serializable`, { cause: error });
+    }
+    if (encoded === undefined) {
+        throw new TypeError(`@zmdb/app: ${description} is not JSON-serializable`);
+    }
+    return encoded;
+}
+export function encodeDelivery(payload, carrier, metadata = {}) {
+    if (payload === undefined) {
+        throw new TypeError('@zmdb/app: broker payloads cannot be undefined');
+    }
+    const envelope = {
+        version: 1,
+        payload,
+        headers: {},
+        ...(metadata.correlationId === undefined ? {} : { correlationId: metadata.correlationId }),
+        ...(metadata.replyTo === undefined ? {} : { replyTo: metadata.replyTo }),
+        ...(carrier?.traceparent === undefined ? {} : { traceparent: carrier.traceparent }),
+        ...(carrier?.tracestate === undefined ? {} : { tracestate: carrier.tracestate }),
+    };
+    return encode(envelope, 'broker payload');
+}
+function invalidDelivery(pattern, payload, deliveryAttempt, error, metadata) {
+    return {
+        pattern,
+        payload,
+        headers: {},
+        correlationId: metadata.correlationId,
+        replyTo: metadata.replyTo,
+        deliveryAttempt,
+        parseError: error,
+    };
+}
+export function decodeDelivery(pattern, text, deliveryAttempt, metadata = {}) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        return invalidDelivery(pattern, text, deliveryAttempt, error, metadata);
+    }
+    if (!isRecord(parsed)) {
+        return invalidDelivery(pattern, parsed, deliveryAttempt, new TypeError('@zmdb/app: broker envelope must be an object'), metadata);
+    }
+    const headers = stringRecord(parsed.headers);
+    const correlationId = optionalString(parsed.correlationId);
+    const replyTo = optionalString(parsed.replyTo);
+    const traceparent = optionalString(parsed.traceparent);
+    const tracestate = optionalString(parsed.tracestate);
+    if (parsed.version !== 1 ||
+        !Object.hasOwn(parsed, 'payload') ||
+        headers === undefined ||
+        correlationId === false ||
+        replyTo === false ||
+        traceparent === false ||
+        tracestate === false) {
+        return invalidDelivery(pattern, Object.hasOwn(parsed, 'payload') ? parsed.payload : parsed, deliveryAttempt, new TypeError('@zmdb/app: invalid broker envelope'), metadata);
+    }
+    return {
+        pattern,
+        payload: parsed.payload,
+        headers,
+        correlationId: metadata.correlationId ?? correlationId,
+        replyTo: metadata.replyTo ?? replyTo,
+        deliveryAttempt,
+        ...(traceparent === undefined ? {} : { traceparent }),
+        ...(tracestate === undefined ? {} : { tracestate }),
+    };
+}
+export function encodeReply(reply) {
+    return encode(reply, 'broker reply');
+}
+export function decodeReply(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new TypeError('@zmdb/app: broker reply is not valid JSON', { cause: error });
+    }
+    if (!isRecord(parsed) || typeof parsed.correlationId !== 'string') {
+        throw new TypeError('@zmdb/app: invalid broker reply envelope');
+    }
+    if (parsed.kind === 'result' && Object.hasOwn(parsed, 'payload')) {
+        return { kind: 'result', correlationId: parsed.correlationId, payload: parsed.payload };
+    }
+    if (parsed.kind === 'error' && typeof parsed.message === 'string') {
+        return { kind: 'error', correlationId: parsed.correlationId, message: parsed.message };
+    }
+    throw new TypeError('@zmdb/app: invalid broker reply envelope');
+}
+export function reportTransportError(sink, error) {
+    try {
+        sink(error);
+    }
+    catch {
+        // A diagnostic sink cannot replace transport settlement or shutdown.
+    }
+}
+export class InFlight {
+    #tasks = new Set();
+    #onError;
+    #accepting = true;
+    constructor(onError) {
+        this.#onError = onError;
+    }
+    run(action) {
+        if (!this.#accepting) {
+            return Promise.resolve();
+        }
+        let task;
+        task = Promise.resolve()
+            .then(action)
+            .catch(error => {
+            reportTransportError(this.#onError, error);
+        })
+            .finally(() => {
+            this.#tasks.delete(task);
+        });
+        this.#tasks.add(task);
+        return task;
+    }
+    stop() {
+        this.#accepting = false;
+    }
+    async settled() {
+        await Promise.all(this.#tasks);
+    }
+}
+export async function withinGrace(action, graceMs) {
+    let timer;
+    try {
+        return await Promise.race([
+            action.then(() => true),
+            new Promise(resolve => {
+                timer = setTimeout(() => resolve(false), graceMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+    }
+}
+export function abortError(signal) {
+    return signal.reason ?? new Error('@zmdb/app: broker request aborted');
+}
+//# sourceMappingURL=transport-kit.js.map