@api.global/typedsocket 7.0.0 → 8.0.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@api.global/typedsocket',
-    version: '7.0.0',
+    version: '8.0.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.requestcancellationmanager.d.ts

@@ -0,0 +1,61 @@
+import * as plugins from './plugins.js';
+export declare const TYPEDSOCKET_MAX_ACTIVE_REQUEST_HANDLERS_PER_CONNECTION = 64;
+export declare const TYPEDSOCKET_MAX_ACTIVE_REQUEST_HANDLERS = 1024;
+export declare const TYPEDSOCKET_MAX_REQUEST_CANCELLATION_TOMBSTONES_PER_CONNECTION = 1024;
+export declare const TYPEDSOCKET_MAX_REQUEST_CANCELLATION_TOMBSTONES = 16384;
+export declare const TYPEDSOCKET_REQUEST_HANDLER_MAX_LIFETIME_MS: number;
+export declare const TYPEDSOCKET_REQUEST_CANCELLATION_TOMBSTONE_RETENTION_MS = 10000;
+/** Internal control-flow error for an authenticated remote cancellation. */
+export declare class TypedSocketRemoteRequestCancellationError extends plugins.typedrequest.TypedResponseError {
+    constructor();
+}
+export interface IRequestCancellationIdentity {
+    readonly method: string;
+    readonly correlationId: string;
+    readonly requestInstanceId: string;
+}
+export interface IRequestCancellationContext {
+    readonly connection: object;
+    readonly routingSurface: object;
+    readonly generation: number;
+    close(reasonArg: string): void;
+}
+export type TRequestSignalRegistration = plugins.typedrequest.ITypedRouterRequestSignalRegistration;
+export interface IRequestCancellationManagerOptions {
+    readonly maxActivePerConnection?: number;
+    readonly maxActive?: number;
+    readonly maxTombstonesPerConnection?: number;
+    readonly maxTombstones?: number;
+    readonly activeLifetimeMs?: number;
+    readonly tombstoneRetentionMs?: number;
+}
+export declare class RequestCancellationManager {
+    private readonly states;
+    private readonly limits;
+    private activeCount;
+    private detachedActiveCount;
+    private tombstoneCount;
+    private stopped;
+    constructor(optionsArg?: IRequestCancellationManagerOptions);
+    register(contextArg: IRequestCancellationContext, identityArg: IRequestCancellationIdentity): TRequestSignalRegistration;
+    cancel(contextArg: IRequestCancellationContext, identityArg: IRequestCancellationIdentity): void;
+    closeConnection(connectionArg: object, reasonArg: unknown): void;
+    stop(reasonArg: unknown): void;
+    getStats(): Readonly<{
+        /** Registrations that have not called complete(), including detached work. */
+        active: number;
+        /** Aborted registrations detached from their connection but not yet complete. */
+        detachedActive: number;
+        tombstones: number;
+        /** Cancellation states still attached to a physical connection. */
+        connections: number;
+    }>;
+    private getState;
+    private completeActive;
+    private addTombstone;
+    private deleteTombstone;
+    private reclaimGlobalTombstoneCapacity;
+    private failConnection;
+    private createKey;
+    private getValidatedKey;
+}

package/dist_ts/classes.requestcancellationmanager.js

@@ -0,0 +1,234 @@
+import * as plugins from './plugins.js';
+export const TYPEDSOCKET_MAX_ACTIVE_REQUEST_HANDLERS_PER_CONNECTION = 64;
+export const TYPEDSOCKET_MAX_ACTIVE_REQUEST_HANDLERS = 1024;
+export const TYPEDSOCKET_MAX_REQUEST_CANCELLATION_TOMBSTONES_PER_CONNECTION = 1024;
+export const TYPEDSOCKET_MAX_REQUEST_CANCELLATION_TOMBSTONES = 16_384;
+export const TYPEDSOCKET_REQUEST_HANDLER_MAX_LIFETIME_MS = 5 * 60 * 1000;
+export const TYPEDSOCKET_REQUEST_CANCELLATION_TOMBSTONE_RETENTION_MS = 10_000;
+/** Internal control-flow error for an authenticated remote cancellation. */
+export class TypedSocketRemoteRequestCancellationError extends plugins.typedrequest.TypedResponseError {
+    constructor() {
+        super('TypedSocket remote request cancelled');
+        this.name = 'TypedSocketRemoteRequestCancellationError';
+    }
+}
+export class RequestCancellationManager {
+    constructor(optionsArg = {}) {
+        this.states = new Map();
+        this.activeCount = 0;
+        this.detachedActiveCount = 0;
+        this.tombstoneCount = 0;
+        this.stopped = false;
+        this.limits = {
+            maxActivePerConnection: optionsArg.maxActivePerConnection
+                ?? TYPEDSOCKET_MAX_ACTIVE_REQUEST_HANDLERS_PER_CONNECTION,
+            maxActive: optionsArg.maxActive ?? TYPEDSOCKET_MAX_ACTIVE_REQUEST_HANDLERS,
+            maxTombstonesPerConnection: optionsArg.maxTombstonesPerConnection
+                ?? TYPEDSOCKET_MAX_REQUEST_CANCELLATION_TOMBSTONES_PER_CONNECTION,
+            maxTombstones: optionsArg.maxTombstones
+                ?? TYPEDSOCKET_MAX_REQUEST_CANCELLATION_TOMBSTONES,
+            activeLifetimeMs: optionsArg.activeLifetimeMs
+                ?? TYPEDSOCKET_REQUEST_HANDLER_MAX_LIFETIME_MS,
+            tombstoneRetentionMs: optionsArg.tombstoneRetentionMs
+                ?? TYPEDSOCKET_REQUEST_CANCELLATION_TOMBSTONE_RETENTION_MS,
+        };
+        for (const [name, value] of Object.entries(this.limits)) {
+            if (!Number.isSafeInteger(value) || value < 1) {
+                throw new RangeError(`Request cancellation limit ${name} must be a positive safe integer`);
+            }
+        }
+    }
+    register(contextArg, identityArg) {
+        const state = this.getState(contextArg);
+        const key = this.getValidatedKey(state, identityArg);
+        if (state.active.has(key) || state.tombstones.get(key)?.kind === 'terminal') {
+            this.failConnection(state, 'TypedSocket request instance was replayed');
+            throw new Error('TypedSocket request instance was replayed');
+        }
+        if (state.active.size >= this.limits.maxActivePerConnection
+            || this.activeCount >= this.limits.maxActive) {
+            this.failConnection(state, 'TypedSocket active request handler capacity exhausted');
+            throw new Error('TypedSocket active request handler capacity exhausted');
+        }
+        const earlyCancel = state.tombstones.get(key)?.kind === 'early-cancel';
+        if (earlyCancel)
+            this.deleteTombstone(state, key);
+        const abortController = new AbortController();
+        const activeRequest = {
+            key,
+            context: state.context,
+            abortController,
+            completed: false,
+            timeout: setTimeout(() => {
+                this.failConnection(state, 'TypedSocket request handler lifetime exceeded');
+            }, this.limits.activeLifetimeMs),
+        };
+        activeRequest.timeout.unref?.();
+        state.active.set(key, activeRequest);
+        this.activeCount++;
+        if (earlyCancel) {
+            abortController.abort(new TypedSocketRemoteRequestCancellationError());
+        }
+        return Object.freeze({
+            abortSignal: abortController.signal,
+            complete: () => this.completeActive(state, activeRequest),
+        });
+    }
+    cancel(contextArg, identityArg) {
+        const state = this.getState(contextArg);
+        const key = this.getValidatedKey(state, identityArg);
+        const activeRequest = state.active.get(key);
+        if (activeRequest) {
+            activeRequest.abortController.abort(new TypedSocketRemoteRequestCancellationError());
+            return;
+        }
+        if (state.tombstones.has(key))
+            return;
+        this.addTombstone(state, key, 'early-cancel');
+    }
+    closeConnection(connectionArg, reasonArg) {
+        const state = this.states.get(connectionArg);
+        if (!state)
+            return;
+        state.closed = true;
+        this.states.delete(connectionArg);
+        for (const activeRequest of state.active.values()) {
+            clearTimeout(activeRequest.timeout);
+            this.detachedActiveCount++;
+            activeRequest.abortController.abort(reasonArg);
+        }
+        for (const key of Array.from(state.tombstones.keys())) {
+            this.deleteTombstone(state, key);
+        }
+    }
+    stop(reasonArg) {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        for (const connection of Array.from(this.states.keys())) {
+            this.closeConnection(connection, reasonArg);
+        }
+    }
+    getStats() {
+        return Object.freeze({
+            active: this.activeCount,
+            detachedActive: this.detachedActiveCount,
+            tombstones: this.tombstoneCount,
+            connections: this.states.size,
+        });
+    }
+    getState(contextArg) {
+        if (this.stopped)
+            throw new Error('TypedSocket request cancellation manager stopped');
+        const existing = this.states.get(contextArg.connection);
+        if (existing) {
+            if (existing.closed
+                || existing.context.routingSurface !== contextArg.routingSurface
+                || existing.context.generation !== contextArg.generation) {
+                this.failConnection(existing, 'TypedSocket request cancellation authority mismatch');
+                throw new Error('TypedSocket request cancellation authority mismatch');
+            }
+            return existing;
+        }
+        const state = {
+            context: Object.freeze({ ...contextArg }),
+            active: new Map(),
+            tombstones: new Map(),
+            closed: false,
+        };
+        this.states.set(contextArg.connection, state);
+        return state;
+    }
+    completeActive(stateArg, activeRequestArg) {
+        if (activeRequestArg.completed)
+            return;
+        activeRequestArg.completed = true;
+        clearTimeout(activeRequestArg.timeout);
+        if (stateArg.active.get(activeRequestArg.key) === activeRequestArg) {
+            stateArg.active.delete(activeRequestArg.key);
+            this.activeCount--;
+            if (stateArg.closed)
+                this.detachedActiveCount--;
+        }
+        if (!stateArg.closed) {
+            this.addTombstone(stateArg, activeRequestArg.key, 'terminal');
+        }
+    }
+    addTombstone(stateArg, keyArg, kindArg) {
+        if (stateArg.closed)
+            return;
+        if (stateArg.tombstones.size >= this.limits.maxTombstonesPerConnection) {
+            this.failConnection(stateArg, 'TypedSocket per-connection request cancellation tombstone capacity exhausted');
+            return;
+        }
+        if (this.tombstoneCount >= this.limits.maxTombstones
+            && !this.reclaimGlobalTombstoneCapacity()) {
+            this.failConnection(stateArg, 'TypedSocket global request cancellation tombstone capacity exhausted');
+            return;
+        }
+        if (stateArg.closed)
+            return;
+        const timeout = setTimeout(() => {
+            this.deleteTombstone(stateArg, keyArg);
+        }, this.limits.tombstoneRetentionMs);
+        timeout.unref?.();
+        stateArg.tombstones.set(keyArg, { kind: kindArg, timeout });
+        this.tombstoneCount++;
+    }
+    deleteTombstone(stateArg, keyArg) {
+        const tombstone = stateArg.tombstones.get(keyArg);
+        if (!tombstone)
+            return;
+        clearTimeout(tombstone.timeout);
+        stateArg.tombstones.delete(keyArg);
+        this.tombstoneCount--;
+    }
+    reclaimGlobalTombstoneCapacity() {
+        let largestConsumer;
+        // Map iteration is insertion ordered, so equal shares evict the oldest state.
+        for (const state of this.states.values()) {
+            if (state.closed
+                || state.tombstones.size === 0
+                || (largestConsumer
+                    && state.tombstones.size <= largestConsumer.tombstones.size))
+                continue;
+            largestConsumer = state;
+        }
+        if (!largestConsumer)
+            return false;
+        this.failConnection(largestConsumer, 'TypedSocket global request cancellation tombstone capacity exhausted');
+        return this.tombstoneCount < this.limits.maxTombstones;
+    }
+    failConnection(stateArg, reasonArg) {
+        if (stateArg.closed)
+            return;
+        try {
+            stateArg.context.close(reasonArg);
+        }
+        finally {
+            this.closeConnection(stateArg.context.connection, new Error(reasonArg));
+        }
+    }
+    createKey(identityArg) {
+        return JSON.stringify([
+            identityArg.method,
+            identityArg.correlationId,
+            identityArg.requestInstanceId,
+        ]);
+    }
+    getValidatedKey(stateArg, identityArg) {
+        const values = [
+            identityArg.method,
+            identityArg.correlationId,
+            identityArg.requestInstanceId,
+        ];
+        if (values.some((valueArg) => (typeof valueArg !== 'string'
+            || valueArg.length === 0
+            || new TextEncoder().encode(valueArg).byteLength > 256))) {
+            this.failConnection(stateArg, 'TypedSocket request cancellation identity is malformed');
+            throw new Error('TypedSocket request cancellation identity is malformed');
+        }
+        return this.createKey(identityArg);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5yZXF1ZXN0Y2FuY2VsbGF0aW9ubWFuYWdlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2NsYXNzZXMucmVxdWVzdGNhbmNlbGxhdGlvbm1hbmFnZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFFeEMsTUFBTSxDQUFDLE1BQU0sc0RBQXNELEdBQUcsRUFBRSxDQUFDO0FBQ3pFLE1BQU0sQ0FBQyxNQUFNLHVDQUF1QyxHQUFHLElBQUksQ0FBQztBQUM1RCxNQUFNLENBQUMsTUFBTSw4REFBOEQsR0FBRyxJQUFJLENBQUM7QUFDbkYsTUFBTSxDQUFDLE1BQU0sK0NBQStDLEdBQUcsTUFBTSxDQUFDO0FBQ3RFLE1BQU0sQ0FBQyxNQUFNLDJDQUEyQyxHQUFHLENBQUMsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBQ3pFLE1BQU0sQ0FBQyxNQUFNLHVEQUF1RCxHQUFHLE1BQU0sQ0FBQztBQUU5RSw0RUFBNEU7QUFDNUUsTUFBTSxPQUFPLHlDQUNYLFNBQVEsT0FBTyxDQUFDLFlBQVksQ0FBQyxrQkFBa0I7SUFDL0M7UUFDRSxLQUFLLENBQUMsc0NBQXNDLENBQUMsQ0FBQztRQUM5QyxJQUFJLENBQUMsSUFBSSxHQUFHLDJDQUEyQyxDQUFDO0lBQzFELENBQUM7Q0FDRjtBQStDRCxNQUFNLE9BQU8sMEJBQTBCO0lBUXJDLFlBQVksYUFBaUQsRUFBRTtRQVA5QyxXQUFNLEdBQUcsSUFBSSxHQUFHLEVBQXdDLENBQUM7UUFFbEUsZ0JBQVcsR0FBRyxDQUFDLENBQUM7UUFDaEIsd0JBQW1CLEdBQUcsQ0FBQyxDQUFDO1FBQ3hCLG1CQUFjLEdBQUcsQ0FBQyxDQUFDO1FBQ25CLFlBQU8sR0FBRyxLQUFLLENBQUM7UUFHdEIsSUFBSSxDQUFDLE1BQU0sR0FBRztZQUNaLHNCQUFzQixFQUFFLFVBQVUsQ0FBQyxzQkFBc0I7bUJBQ3BELHNEQUFzRDtZQUMzRCxT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

package/dist_ts/classes.typedsocket.d.ts

@@ -2,6 +2,7 @@ import * as plugins from './plugins.js';
 import { VirtualStreamManager } from './classes.virtualstreammanager.js';
 export { toClientWebSocketCloseCode } from './helpers.websocket.js';
 export { TYPEDSOCKET_MAX_RETAINED_CLIENT_TAG_MUTATIONS, TYPEDSOCKET_MAX_RETAINED_CLIENT_TAG_MUTATIONS_PER_NAME, } from './classes.clienttagreconciler.js';
+export { TYPEDSOCKET_REQUEST_CANCELLATION_METHOD, TYPEDSOCKET_REQUEST_CANCELLATION_PROTOCOL, } from './constants.virtualstream.js';
 import type { TTypedSocketDiagnosticEvent } from './interfaces.diagnostics.js';
 import type { ICreateVirtualStreamOptions, IVirtualStreamAuthorizationAdapter, TVirtualStreamDirection } from './interfaces.virtualstream.js';
 import type { ITypedSocketClientTagPolicy } from './classes.typedsockettagpolicymanager.js';
@@ -68,6 +69,8 @@ export interface ITypedSocketClientOptions {
 export interface ITypedSocketServerOptions {
     virtualStreamAuthorizationAdapter?: IVirtualStreamAuthorizationAdapter;
     clientTagPolicy?: ITypedSocketClientTagPolicy;
+    /** Runs synchronously after the exact server handshake response is settled. */
+    onServerConnectionReady?: (connectionArg: ISmartServeConnectionWrapper) => undefined;
 }
 /**
  * Lifecycle controls for one TypedRequest sent over a TypedSocket.
@@ -158,13 +161,16 @@ export declare class TypedSocket {
     private unsubscribeSmartServeConnectionClose;
     private detachVirtualStreamResolvers;
     private detachIncomingRequestAuthorityGuards;
+    private detachIncomingRequestSignalResolvers;
     private detachResponseAuthorityGuards;
     private pendingServerRequests;
     private pendingServerRequestIdsByPeer;
     private retainedServerInterests;
     private retainedServerInterestsByPeer;
+    private readonly serverReadyCallbackPeers;
     private readonly virtualStreamAuthorizationAdapter;
     private readonly tagPolicyManager;
+    private readonly requestCancellationManager;
     private constructor();
     /**
      * Attaches the SmartServe transport after server router composition.
@@ -189,6 +195,9 @@ export declare class TypedSocket {
     private isCurrentClientConnection;
     private failClientHandshake;
     private abortClientConnectionState;
+    private registerClientRequestSignal;
+    private handleClientCancellation;
+    private createClientCancellationContext;
     /**
      * Handles WebSocket disconnection
      */
@@ -228,7 +237,12 @@ export declare class TypedSocket {
     private sendRequest;
     private normalizeRequestTimeout;
     private requireClientOptions;
+    private sendClientCancellation;
     private cancelPendingServerRequestsForPeer;
+    private registerServerRequestSignal;
+    private handleServerCancellation;
+    private createServerCancellationContext;
+    private sendServerCancellation;
     private retainServerInterestRegistration;
     private authorizeIncomingServerResponse;
     private isAttachedServerPeer;