@api.global/typedsocket 6.0.0 → 6.2.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@api.global/typedsocket',
-    version: '6.0.0',
+    version: '6.2.0',
     description: 'A library for creating typed WebSocket connections, supporting bi-directional communication with type safety.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx5QkFBeUI7SUFDL0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLCtHQUErRztDQUM3SCxDQUFBIn0=

package/dist_ts/classes.clienttagreconciler.d.ts

@@ -0,0 +1,51 @@
+import type { TTypedSocketTagMutationResponse } from './classes.typedsockettagpolicymanager.js';
+import type { ITypedSocketTagMutationDeniedDiagnostic } from './interfaces.diagnostics.js';
+export declare const TYPEDSOCKET_MAX_RETAINED_CLIENT_TAG_MUTATIONS_PER_NAME = 8;
+export declare const TYPEDSOCKET_MAX_RETAINED_CLIENT_TAG_MUTATIONS = 64;
+/**
+ * Transport surface the reconciler needs from its owning TypedSocket client.
+ * The connection state type stays opaque; the reconciler only compares and
+ * forwards it.
+ */
+export interface IClientTagTransportAdapter<TConnectionState> {
+    isCurrentConnection(stateArg: TConnectionState): boolean;
+    getCurrentConnectionState(): TConnectionState | null;
+    getConnectionGeneration(stateArg: TConnectionState): number;
+    getCurrentGeneration(): number;
+    fireSetTag(nameArg: string, payloadArg: unknown): Promise<TTypedSocketTagMutationResponse>;
+    fireRemoveTag(nameArg: string): Promise<TTypedSocketTagMutationResponse>;
+    emitDiagnostic(eventArg: ITypedSocketTagMutationDeniedDiagnostic): void;
+}
+/**
+ * Client-side tag state machine: separates desired tag state (survives
+ * transport failure, reconciled on every connection) from acknowledged state
+ * (bound to one physical connection generation), serializes mutations per
+ * name, and bounds retained mutation work.
+ */
+export declare class ClientTagReconciler<TConnectionState> {
+    private readonly transport;
+    private clientTags;
+    private clientTagRevisions;
+    private desiredClientTags;
+    private clientTagDesiredMutationQueues;
+    private clientTagMutationSequence;
+    private clientTagMutationTails;
+    private retainedClientTagMutations;
+    private retainedClientTagMutationsByName;
+    constructor(transport: IClientTagTransportAdapter<TConnectionState>);
+    setTag(nameArg: string, payloadArg: unknown): Promise<void>;
+    removeTag(nameArg: string): Promise<void>;
+    /**
+     * Re-applies all client tags after a reconnect, since server-side tags are
+     * bound to the previous connection.
+     */
+    reapplyTags(stateArg: TConnectionState | null): Promise<void>;
+    private emitDeniedDiagnostic;
+    private retainClientTagMutation;
+    private setDesiredClientTag;
+    private settleDesiredClientTag;
+    private serializeClientTagMutation;
+    private submitDesiredClientTag;
+    private requireTagMutationSuccess;
+    private applyClientTagMutation;
+}

package/dist_ts/classes.clienttagreconciler.js

@@ -0,0 +1,290 @@
+import { assertBoundedTextIdentifier, createTypedSocketTagPayloadSnapshot, TYPEDSOCKET_MAX_CLIENT_TAG_RETAINED_BYTES_PER_PEER, TYPEDSOCKET_MAX_CLIENT_TAGS_PER_PEER, TYPEDSOCKET_MAX_TAG_NAME_BYTES, TYPEDSOCKET_TAG_DENIAL_CODES, TypedSocketClientTagDeniedError, } from './classes.typedsockettagpolicymanager.js';
+export const TYPEDSOCKET_MAX_RETAINED_CLIENT_TAG_MUTATIONS_PER_NAME = 8;
+export const TYPEDSOCKET_MAX_RETAINED_CLIENT_TAG_MUTATIONS = 64;
+const textEncoder = new TextEncoder();
+/**
+ * Client-side tag state machine: separates desired tag state (survives
+ * transport failure, reconciled on every connection) from acknowledged state
+ * (bound to one physical connection generation), serializes mutations per
+ * name, and bounds retained mutation work.
+ */
+export class ClientTagReconciler {
+    constructor(transport) {
+        this.transport = transport;
+        // Acknowledged state is diagnostic state for the current server connection.
+        this.clientTags = new Map();
+        this.clientTagRevisions = new Map();
+        // Desired state survives transport failure and is reconciled on every connection.
+        this.desiredClientTags = new Map();
+        this.clientTagDesiredMutationQueues = new Map();
+        this.clientTagMutationSequence = 0;
+        this.clientTagMutationTails = new Map();
+        this.retainedClientTagMutations = 0;
+        this.retainedClientTagMutationsByName = new Map();
+    }
+    async setTag(nameArg, payloadArg) {
+        let releaseMutation;
+        try {
+            releaseMutation = this.retainClientTagMutation(nameArg);
+            const snapshot = createTypedSocketTagPayloadSnapshot(payloadArg);
+            const desired = this.setDesiredClientTag(nameArg, 'set', snapshot.payload, snapshot.byteLength);
+            return await this.serializeClientTagMutation(nameArg, async () => {
+                let applied;
+                try {
+                    applied = await this.submitDesiredClientTag(nameArg, desired);
+                }
+                catch (errorArg) {
+                    this.settleDesiredClientTag(nameArg, desired, errorArg instanceof TypedSocketClientTagDeniedError ? 'denied' : 'retained');
+                    throw errorArg;
+                }
+                this.settleDesiredClientTag(nameArg, desired, applied ? 'accepted' : 'retained');
+            });
+        }
+        catch (errorArg) {
+            this.emitDeniedDiagnostic('set', nameArg, errorArg);
+            throw errorArg;
+        }
+        finally {
+            releaseMutation?.();
+        }
+    }
+    async removeTag(nameArg) {
+        let releaseMutation;
+        try {
+            releaseMutation = this.retainClientTagMutation(nameArg);
+            const desired = this.setDesiredClientTag(nameArg, 'remove', undefined, 0);
+            return await this.serializeClientTagMutation(nameArg, async () => {
+                let applied;
+                try {
+                    applied = await this.submitDesiredClientTag(nameArg, desired);
+                }
+                catch (errorArg) {
+                    this.settleDesiredClientTag(nameArg, desired, errorArg instanceof TypedSocketClientTagDeniedError ? 'denied' : 'retained');
+                    throw errorArg;
+                }
+                this.settleDesiredClientTag(nameArg, desired, applied ? 'accepted' : 'retained');
+            });
+        }
+        catch (errorArg) {
+            this.emitDeniedDiagnostic('remove', nameArg, errorArg);
+            throw errorArg;
+        }
+        finally {
+            releaseMutation?.();
+        }
+    }
+    /**
+     * Re-applies all client tags after a reconnect, since server-side tags are
+     * bound to the previous connection.
+     */
+    async reapplyTags(stateArg) {
+        if (!stateArg || !this.transport.isCurrentConnection(stateArg)) {
+            throw new Error('TypedSocket has no active connection for tag restoration.');
+        }
+        this.clientTags.clear();
+        this.clientTagRevisions.clear();
+        while (this.transport.isCurrentConnection(stateArg)) {
+            const snapshot = Array.from(this.desiredClientTags.entries());
+            for (const [name, desired] of snapshot) {
+                try {
+                    const applied = await this.submitDesiredClientTag(name, desired, stateArg);
+                    if (applied
+                        && desired.operation === 'remove'
+                        && this.desiredClientTags.get(name)?.sequence === desired.sequence) {
+                        this.desiredClientTags.delete(name);
+                    }
+                }
+                catch (errorArg) {
+                    if (errorArg instanceof TypedSocketClientTagDeniedError
+                        && this.desiredClientTags.get(name)?.sequence === desired.sequence) {
+                        this.desiredClientTags.delete(name);
+                    }
+                    this.emitDeniedDiagnostic(desired.operation, name, errorArg);
+                    throw errorArg;
+                }
+            }
+            const stable = snapshot.length === this.desiredClientTags.size
+                && snapshot.every(([name, desired]) => {
+                    return this.desiredClientTags.get(name)?.sequence === desired.sequence;
+                });
+            if (stable)
+                return;
+        }
+        throw new Error('TypedSocket connection changed while restoring client tags.');
+    }
+    emitDeniedDiagnostic(operationArg, nameArg, errorArg) {
+        if (!(errorArg instanceof TypedSocketClientTagDeniedError))
+            return;
+        let name = '';
+        try {
+            assertBoundedTextIdentifier(nameArg, 'tag name', TYPEDSOCKET_MAX_TAG_NAME_BYTES);
+            name = nameArg;
+        }
+        catch { }
+        this.transport.emitDiagnostic({
+            kind: 'tagMutationDenied',
+            side: 'client',
+            operation: operationArg,
+            name,
+            code: errorArg.code,
+        });
+    }
+    retainClientTagMutation(nameArg) {
+        assertBoundedTextIdentifier(nameArg, 'tag name', TYPEDSOCKET_MAX_TAG_NAME_BYTES);
+        const retainedForName = this.retainedClientTagMutationsByName.get(nameArg) ?? 0;
+        if (retainedForName >= TYPEDSOCKET_MAX_RETAINED_CLIENT_TAG_MUTATIONS_PER_NAME
+            || this.retainedClientTagMutations >= TYPEDSOCKET_MAX_RETAINED_CLIENT_TAG_MUTATIONS) {
+            throw new TypedSocketClientTagDeniedError('TAG_MUTATION_CAPACITY_EXCEEDED', 'TypedSocket retained client tag mutation capacity exceeded.');
+        }
+        this.retainedClientTagMutations++;
+        this.retainedClientTagMutationsByName.set(nameArg, retainedForName + 1);
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            this.retainedClientTagMutations--;
+            const currentForName = this.retainedClientTagMutationsByName.get(nameArg);
+            if (currentForName === undefined || currentForName < 1) {
+                throw new Error('TypedSocket client tag mutation accounting underflow.');
+            }
+            if (currentForName === 1) {
+                this.retainedClientTagMutationsByName.delete(nameArg);
+            }
+            else {
+                this.retainedClientTagMutationsByName.set(nameArg, currentForName - 1);
+            }
+        };
+    }
+    setDesiredClientTag(nameArg, operationArg, payloadArg, payloadBytesArg) {
+        assertBoundedTextIdentifier(nameArg, 'tag name', TYPEDSOCKET_MAX_TAG_NAME_BYTES);
+        const retainedBytes = textEncoder.encode(nameArg).byteLength + payloadBytesArg;
+        const desired = Object.freeze({
+            sequence: ++this.clientTagMutationSequence,
+            operation: operationArg,
+            payload: operationArg === 'set' ? payloadArg : undefined,
+            retainedBytes,
+        });
+        const alreadyPresent = this.desiredClientTags.has(nameArg);
+        if (!alreadyPresent && this.desiredClientTags.size >= TYPEDSOCKET_MAX_CLIENT_TAGS_PER_PEER) {
+            throw new TypedSocketClientTagDeniedError('TAG_COUNT_LIMIT_EXCEEDED', 'TypedSocket desired client tag count limit exceeded.');
+        }
+        let retainedTotal = retainedBytes;
+        for (const [name, entry] of this.desiredClientTags) {
+            if (name !== nameArg)
+                retainedTotal += entry.retainedBytes;
+        }
+        if (retainedTotal > TYPEDSOCKET_MAX_CLIENT_TAG_RETAINED_BYTES_PER_PEER) {
+            throw new TypedSocketClientTagDeniedError('TAG_RETAINED_BYTES_EXCEEDED', 'TypedSocket desired client tag retained-byte limit exceeded.');
+        }
+        let queue = this.clientTagDesiredMutationQueues.get(nameArg);
+        if (!queue) {
+            queue = {
+                baseline: this.desiredClientTags.get(nameArg),
+                pending: [],
+            };
+            this.clientTagDesiredMutationQueues.set(nameArg, queue);
+        }
+        queue.pending.push(desired);
+        this.desiredClientTags.set(nameArg, desired);
+        return desired;
+    }
+    settleDesiredClientTag(nameArg, desiredArg, outcomeArg) {
+        const queue = this.clientTagDesiredMutationQueues.get(nameArg);
+        const settled = queue?.pending.shift();
+        if (!queue || settled !== desiredArg) {
+            throw new Error('TypedSocket desired client tag mutation order changed unexpectedly.');
+        }
+        if (outcomeArg === 'accepted') {
+            queue.baseline = desiredArg.operation === 'set' ? desiredArg : undefined;
+        }
+        else if (outcomeArg === 'retained') {
+            queue.baseline = desiredArg;
+        }
+        const current = queue.pending.at(-1) ?? queue.baseline;
+        if (current)
+            this.desiredClientTags.set(nameArg, current);
+        else
+            this.desiredClientTags.delete(nameArg);
+        if (queue.pending.length === 0)
+            this.clientTagDesiredMutationQueues.delete(nameArg);
+    }
+    async serializeClientTagMutation(nameArg, mutationArg) {
+        const previous = this.clientTagMutationTails.get(nameArg) ?? Promise.resolve();
+        const operation = previous.catch(() => { }).then(mutationArg);
+        const tail = operation.then(() => { }, () => { });
+        this.clientTagMutationTails.set(nameArg, tail);
+        try {
+            await operation;
+        }
+        finally {
+            if (this.clientTagMutationTails.get(nameArg) === tail) {
+                this.clientTagMutationTails.delete(nameArg);
+            }
+        }
+    }
+    async submitDesiredClientTag(nameArg, desiredArg, stateArg = this.transport.getCurrentConnectionState()) {
+        if (!stateArg || !this.transport.isCurrentConnection(stateArg)) {
+            throw new Error('WebSocket not connected');
+        }
+        const connectionGeneration = this.transport.getConnectionGeneration(stateArg);
+        const response = desiredArg.operation === 'set'
+            ? this.requireTagMutationSuccess(await this.transport.fireSetTag(nameArg, desiredArg.payload))
+            : this.requireTagMutationSuccess(await this.transport.fireRemoveTag(nameArg));
+        const applied = this.applyClientTagMutation(nameArg, desiredArg.payload, response, connectionGeneration, desiredArg.operation);
+        return applied;
+    }
+    requireTagMutationSuccess(responseArg) {
+        if (!responseArg || typeof responseArg.success !== 'boolean') {
+            throw new TypedSocketClientTagDeniedError('MALFORMED_TAG_RESPONSE', 'TypedSocket server returned a malformed tag mutation response.');
+        }
+        if (!responseArg.success) {
+            // The denial code is server-controlled data: anything outside the
+            // package-defined set collapses to MALFORMED_TAG_RESPONSE so no
+            // free-form string reaches typed consumers or diagnostics.
+            if (typeof responseArg.code !== 'string'
+                || typeof responseArg.message !== 'string'
+                || !TYPEDSOCKET_TAG_DENIAL_CODES.includes(responseArg.code)) {
+                throw new TypedSocketClientTagDeniedError('MALFORMED_TAG_RESPONSE', 'TypedSocket server returned a malformed tag denial response.');
+            }
+            throw new TypedSocketClientTagDeniedError(responseArg.code, responseArg.message);
+        }
+        if (typeof responseArg.connectionId !== 'string'
+            || responseArg.connectionId.length === 0
+            || !Number.isSafeInteger(responseArg.tagRevision)
+            || responseArg.tagRevision < 1) {
+            throw new TypedSocketClientTagDeniedError('MALFORMED_TAG_RESPONSE', 'TypedSocket server returned malformed tag mutation ordering metadata.');
+        }
+        return responseArg;
+    }
+    applyClientTagMutation(nameArg, payloadArg, responseArg, connectionGenerationArg, operationArg) {
+        if (connectionGenerationArg !== this.transport.getCurrentGeneration())
+            return false;
+        const current = this.clientTagRevisions.get(nameArg);
+        if (current) {
+            if (connectionGenerationArg < current.connectionGeneration)
+                return false;
+            if (connectionGenerationArg === current.connectionGeneration) {
+                if (responseArg.connectionId !== current.connectionId) {
+                    throw new TypedSocketClientTagDeniedError('MALFORMED_TAG_RESPONSE', 'TypedSocket server changed tag mutation connection identity within one connection generation.');
+                }
+                if (responseArg.tagRevision <= current.tagRevision)
+                    return false;
+            }
+        }
+        if (operationArg === 'set') {
+            this.clientTagRevisions.set(nameArg, {
+                connectionGeneration: connectionGenerationArg,
+                connectionId: responseArg.connectionId,
+                tagRevision: responseArg.tagRevision,
+            });
+            this.clientTags.set(nameArg, createTypedSocketTagPayloadSnapshot(payloadArg).payload);
+        }
+        else {
+            this.clientTags.delete(nameArg);
+            this.clientTagRevisions.delete(nameArg);
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jbGllbnR0YWdyZWNvbmNpbGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2xhc3Nlcy5jbGllbnR0YWdyZWNvbmNpbGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCwyQkFBMkIsRUFDM0IsbUNBQW1DLEVBQ25DLGtEQUFrRCxFQUNsRCxvQ0FBb0MsRUFDcEMsOEJBQThCLEVBQzlCLDRCQUE0QixFQUM1QiwrQkFBK0IsR0FDaEMsTUFBTSwwQ0FBMEMsQ0FBQztBQU9sRCxNQUFNLENBQUMsTUFBTSxzREFBc0QsR0FBRyxDQUFDLENBQUM7QUFDeEUsTUFBTSxDQUFDLE1BQU0sNkNBQTZDLEdBQUcsRUFBRSxDQUFDO0FBRWhFLE1BQU0sV0FBVyxHQUFHLElBQUksV0FBVyxFQUFFLENBQUM7QUFtQ3RDOzs7OztHQUtHO0FBQ0gsTUFBTSxPQUFPLG1CQUFtQjtJQVk5QixZQUNtQixTQUF1RDtRQUF2RCxjQUFTLEdBQVQsU0FBUyxDQUE4QztRQVoxRSw0RUFBNEU7UUFDcEUsZUFBVSxHQUFHLElBQUksR0FBRyxFQUFtQixDQUFDO1FBQ3hDLHVCQUFrQixHQUFHLElBQUksR0FBRyxFQUE4QixDQUFDO1FBQ25FLGtGQUFrRjtRQUMxRSxzQkFBaUIsR0FBRyxJQUFJLEdBQUcsRUFBcUMsQ0FBQztRQUNqRSxtQ0FBOEIsR0FBRyxJQUFJLEdBQUcsRUFBMEMsQ0FBQztRQUNuRiw4QkFBeUIsR0FBRyxDQUFDLENBQUM7UUFDOUIsMkJBQXNCLEdBQUcsSUFBSSxHQUFHLEVBQXlCLENBQUM7UUFDMUQsK0JBQTBCLEdBQUcsQ0FBQyxDQUFDO1FBQy9CLHFDQUFnQyxHQUFHLElBQUksR0FBRyxFQUFrQixDQUFDO0lBSWxFLENBQUM7SUFFRyxLQUFLLENBQUMsTUFBTSxDQUFDLE9BQWUsRUFBRSxVQUFtQjtRQUN0RCxJQUFJLGVBQXlDLENBQUM7UUFDOUMsSUFBSSxDQUFDO1lBQ0gsZUFBZSxHQUFHLElBQUks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

package/dist_ts/classes.nativebyteerror.js

@@ -0,0 +1,26 @@
+export class NativeByteError extends Error {
+    constructor(messageArg, code, optionsArg) {
+        super(messageArg, optionsArg);
+        this.code = code;
+        this.name = 'NativeByteError';
+    }
+}
+export class NativeByteProtocolError extends NativeByteError {
+    constructor(messageArg, optionsArg) {
+        super(messageArg, 'NATIVE_BYTE_PROTOCOL_ERROR', optionsArg);
+        this.name = 'NativeByteProtocolError';
+    }
+}
+export class NativeByteCapabilityError extends NativeByteError {
+    constructor(messageArg = 'native-byte-v1 is unavailable', optionsArg) {
+        super(messageArg, 'NATIVE_BYTE_CAPABILITY_UNAVAILABLE', optionsArg);
+        this.name = 'NativeByteCapabilityError';
+    }
+}
+export class NativeByteStreamClosedError extends NativeByteError {
+    constructor(messageArg = 'Native byte stream is closed', optionsArg) {
+        super(messageArg, 'NATIVE_BYTE_STREAM_CLOSED', optionsArg);
+        this.name = 'NativeByteStreamClosedError';
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5uYXRpdmVieXRlZXJyb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9jbGFzc2VzLm5hdGl2ZWJ5dGVlcnJvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLE9BQU8sZUFBZ0IsU0FBUSxLQUFLO0lBQ3hDLFlBQ0UsVUFBa0IsRUFDRixJQUFZLEVBQzVCLFVBQXlCO1FBRXpCLEtBQUssQ0FBQyxVQUFVLEVBQUUsVUFBVSxDQUFDLENBQUM7UUFIZCxTQUFJLEdBQUosSUFBSSxDQUFRO1FBSTVCLElBQUksQ0FBQyxJQUFJLEdBQUcsaUJBQWlCLENBQUM7SUFDaEMsQ0FBQztDQUNGO0FBRUQsTUFBTSxPQUFPLHVCQUF3QixTQUFRLGVBQWU7SUFDMUQsWUFBWSxVQUFrQixFQUFFLFVBQXlCO1FBQ3ZELEtBQUssQ0FBQyxVQUFVLEVBQUUsNEJBQTRCLEVBQUUsVUFBVSxDQUFDLENBQUM7UUFDNUQsSUFBSSxDQUFDLElBQUksR0FBRyx5QkFBeUIsQ0FBQztJQUN4QyxDQUFDO0NBQ0Y7QUFFRCxNQUFNLE9BQU8seUJBQTBCLFNBQVEsZUFBZTtJQUM1RCxZQUFZLFVBQVUsR0FBRywrQkFBK0IsRUFBRSxVQUF5QjtRQUNqRixLQUFLLENBQUMsVUFBVSxFQUFFLG9DQUFvQyxFQUFFLFVBQVUsQ0FBQyxDQUFDO1FBQ3BFLElBQUksQ0FBQyxJQUFJLEdBQUcsMkJBQTJCLENBQUM7SUFDMUMsQ0FBQztDQUNGO0FBRUQsTUFBTSxPQUFPLDJCQUE0QixTQUFRLGVBQWU7SUFDOUQsWUFBWSxVQUFVLEdBQUcsOEJBQThCLEVBQUUsVUFBeUI7UUFDaEYsS0FBSyxDQUFDLFVBQVUsRUFBRSwyQkFBMkIsRUFBRSxVQUFVLENBQUMsQ0FBQztRQUMzRCxJQUFJLENBQUMsSUFBSSxHQUFHLDZCQUE2QixDQUFDO0lBQzVDLENBQUM7Q0FDRiJ9

package/dist_ts/{nativebytes.manager.d.ts → classes.nativebytemanager.d.ts}

@@ -1,6 +1,7 @@
-import * as plugins from './typedsocket.plugins.js';
-import { NativeByteStreamClosedError } from './nativebytes.errors.js';
-import type { INativeByteCapabilityStatus, INativeByteCreateReceiveGrantOptions, INativeByteDescriptor, INativeByteOpenSenderOptions, INativeByteReceipt, INativeByteReceiveGrant, INativeByteRuntime, INativeByteStats, TNativeByteCapabilityMode, TNativeByteConnectionBinding, TNativeByteRevalidate } from './nativebytes.types.js';
+import * as plugins from './plugins.js';
+import { NativeByteStreamClosedError } from './classes.nativebyteerror.js';
+import type { INativeByteCapabilityStatus, INativeByteCreateReceiveGrantOptions, INativeByteDescriptor, INativeByteOpenSenderOptions, INativeByteReceipt, INativeByteReceiveGrant, INativeByteRuntime, INativeByteStats, TNativeByteCapabilityMode, TNativeByteConnectionBinding, TNativeByteRevalidate } from './interfaces.nativebytes.js';
+import type { TNativeByteDiagnosticEvent } from './interfaces.diagnostics.js';
 type TNativeStreamTransport = plugins.typedrequestInterfaces.INativeStreamTransport;
 type TNativeStreamEndpoint = plugins.typedrequestInterfaces.INativeStreamTransportEndpoint;
 type TSha256Hasher = ReturnType<typeof plugins.smarthash.createSha256Hasher>;
@@ -187,12 +188,15 @@ export interface INativeByteManagerOptions {
     readonly side: 'client' | 'server';
     readonly capabilityMode?: TNativeByteCapabilityMode;
     readonly runtime?: INativeByteRuntime;
+    /** Structured close/rejection diagnostics; must not throw, errors are swallowed. */
+    readonly onDiagnostic?: (eventArg: TNativeByteDiagnosticEvent) => void;
 }
 export declare class NativeByteManager {
     readonly webSocketTransportOwner: plugins.IWebSocketTransportOwner;
     private readonly side;
     private readonly capabilityMode;
     private readonly runtime;
+    private readonly onDiagnostic?;
     private readonly clientNativeStreamTransport;
     private readonly serverConnections;
     private readonly serverSettlementConnections;
@@ -316,6 +320,7 @@ export declare class NativeByteManager {
     private releaseOutboundQueueBytes;
     private releaseProducerPayloadAccounting;
     private removeQueuedFramesForStream;
+    private emitDiagnostic;
     private closeConnection;
     private failConnection;
 }