@api.global/typedsocket 6.3.0 → 7.1.0

package/dist_ts/00_commitinfo_data.js

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

@@ -1,10 +1,9 @@
 import * as plugins from './plugins.js';
-import { NativeByteManager } from './classes.nativebytemanager.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';
 import type { TTypedSocketDiagnosticEvent } from './interfaces.diagnostics.js';
-import type { INativeByteAuthorizationAdapter, INativeByteCreateVirtualStreamOptions, TNativeByteCapabilityMode } from './interfaces.nativebytes.js';
-import type { INativeMessageAuthorizationAdapter, INativeMessageCreateBinaryChannelOptions, INativeMessageReceiveGrant, TNativeMessageCapabilityMode } from './interfaces.nativemessages.js';
+import type { ICreateVirtualStreamOptions, IVirtualStreamAuthorizationAdapter, TVirtualStreamDirection } from './interfaces.virtualstream.js';
 import type { ITypedSocketClientTagPolicy } from './classes.typedsockettagpolicymanager.js';
 export type TTypedSocketSide = 'server' | 'client';
 export type TConnectionStatus = 'new' | 'connecting' | 'connected' | 'disconnected' | 'reconnecting';
@@ -49,6 +48,9 @@ export interface ITypedSocketRequestContext {
 export declare class TypedSocketConnectionRestoreDeniedError extends Error {
     constructor(messageArg: string);
 }
+export declare class TypedSocketHandshakeError extends Error {
+    constructor(messageArg: string, optionsArg?: ErrorOptions);
+}
 /**
  * Options for creating a TypedSocket client
  */
@@ -58,19 +60,16 @@ export interface ITypedSocketClientOptions {
     initialBackoffMs?: number;
     maxBackoffMs?: number;
     abortSignal?: AbortSignal;
-    nativeByteCapabilityMode?: TNativeByteCapabilityMode;
-    nativeMessageCapabilityMode?: TNativeMessageCapabilityMode;
     /** Limits may lower, but never raise, TypedSocket package ceilings. */
     limits?: Partial<ITypedSocketClientLimits>;
     /** Restores connection-bound authentication before desired tags are reconciled. */
     restoreConnection?: (contextArg: ITypedSocketConnectionRestoreContext) => void | Promise<void>;
 }
 export interface ITypedSocketServerOptions {
-    nativeByteCapabilityMode?: TNativeByteCapabilityMode;
-    nativeByteAuthorizationAdapter?: INativeByteAuthorizationAdapter;
-    nativeMessageCapabilityMode?: TNativeMessageCapabilityMode;
-    nativeMessageAuthorizationAdapter?: INativeMessageAuthorizationAdapter;
+    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.
@@ -92,7 +91,7 @@ export interface ISmartServeConnectionWrapper {
 }
 export declare class TypedSocket {
     /**
-     * Creates a TypedSocket client using native WebSocket.
+     * Creates a TypedSocket client using the platform WebSocket implementation.
      * Works in both browser and Node.js environments.
      *
      * @param typedrouterArg - TypedRouter for handling server-initiated requests
@@ -122,37 +121,13 @@ export declare class TypedSocket {
      * Call attachSmartServe() after constructing the SmartServe transport.
      */
     static createServer(typedRouterOrRoutersArg: TTypedSocketServerRouterInput, optionsArg?: ITypedSocketServerOptions): TypedSocket;
-    /**
-     * Creates and attaches a TypedSocket server to an existing SmartServe
-     * instance. Prefer createServer() plus attachSmartServe() when transport
-     * construction needs the composed routers first.
-     *
-     * @param smartServeArg - SmartServe instance configured with the application router
-     * @param typedRouterArg - Application TypedRouter used by SmartServe
-     *
-     * @example
-     * ```typescript
-     * const typedRouter = new TypedRouter();
-     * const smartServe = new SmartServe({
-     *   port: 3000,
-     *   websocket: {
-     *     typedRouter
-     *   }
-     * });
-     * await smartServe.start();
-     * const typedSocket = TypedSocket.fromSmartServe(smartServe, typedRouter);
-     * // Authenticated server handlers assign protected connection metadata with:
-     * // typedSocket.setServerTag(peer, 'authenticated', { userId });
-     * ```
-     */
-    static fromSmartServe(smartServeArg: plugins.SmartServe, typedRouterArg: TTypedSocketServerRouterInput, optionsArg?: ITypedSocketServerOptions): TypedSocket;
     /**
      * Registers built-in TypedHandlers for tag management
      */
     private static registerProtocolHandlers;
     readonly side: TTypedSocketSide;
     readonly typedrouter: plugins.typedrequest.TypedRouter;
-    readonly nativeBytes: NativeByteManager;
+    readonly virtualStreams: VirtualStreamManager;
     readonly webSocketTransportOwner: plugins.IWebSocketTransportOwner;
     statusSubject: plugins.smartrx.rxjs.Subject<TConnectionStatus>;
     /**
@@ -162,6 +137,7 @@ export declare class TypedSocket {
     readonly diagnosticsSubject: plugins.smartrx.rxjs.Subject<TTypedSocketDiagnosticEvent>;
     private connectionStatus;
     private reconnectExhaustedReported;
+    private terminalFailure;
     private websocket;
     private connectionGeneration;
     private clientConnectionState;
@@ -177,19 +153,20 @@ export declare class TypedSocket {
     private readonly clientTagReconciler;
     private smartServeRef;
     private serverTypedRouters;
+    private serverRoutingSurfaces;
     private detachProtocolRouters;
-    private detachLegacyVirtualStreamPolicies;
     private serverStopping;
     private serverLifecycleGeneration;
     private unsubscribeSmartServeConnectionClose;
-    private detachNativeStreamResolvers;
+    private detachVirtualStreamResolvers;
+    private detachIncomingRequestAuthorityGuards;
     private detachResponseAuthorityGuards;
     private pendingServerRequests;
     private pendingServerRequestIdsByPeer;
     private retainedServerInterests;
     private retainedServerInterestsByPeer;
-    private readonly nativeByteAuthorizationAdapter;
-    private readonly nativeMessageAuthorizationAdapter;
+    private readonly serverReadyCallbackPeers;
+    private readonly virtualStreamAuthorizationAdapter;
     private readonly tagPolicyManager;
     private constructor();
     /**
@@ -197,11 +174,10 @@ export declare class TypedSocket {
      */
     attachSmartServe(smartServeArg: plugins.SmartServe): this;
     /**
-     * Connects the client to the server using native WebSocket
+     * Connects the client to the server using the platform WebSocket implementation.
      */
     private connect;
-    private negotiateClientCapabilities;
-    private negotiateClientNativeMessages;
+    private checkClientVersion;
     private restoreClientConnection;
     /**
      * Converts an HTTP(S) URL to a WebSocket URL
@@ -214,6 +190,7 @@ export declare class TypedSocket {
     private handleMessage;
     private sendClientTextEnvelope;
     private isCurrentClientConnection;
+    private failClientHandshake;
     private abortClientConnectionState;
     /**
      * Handles WebSocket disconnection
@@ -258,6 +235,8 @@ export declare class TypedSocket {
     private retainServerInterestRegistration;
     private authorizeIncomingServerResponse;
     private isAttachedServerPeer;
+    private isOwnedServerPeer;
+    private findPhysicalServerPeer;
     private findServerPeerFromRequest;
     private sendServerRequest;
     /**
@@ -266,16 +245,7 @@ export declare class TypedSocket {
      * On servers, sends to the specified target connection.
      */
     createTypedRequest<T extends plugins.typedrequestInterfaces.ITypedRequest>(methodName: T['method'], targetConnection?: ISmartServeConnectionWrapper, optionsArg?: ITypedSocketRequestOptions): plugins.typedrequest.TypedRequest<T>;
-    /**
-     * Creates an exact authorized native-byte receive facade for one server peer.
-     * TypedRequest carries its opaque descriptor when the facade enters a DTO.
-     */
-    createVirtualStream(optionsArg: INativeByteCreateVirtualStreamOptions): plugins.typedrequestInterfaces.INativeByteVirtualStreamReceiver<Uint8Array>;
-    /**
-     * Creates an authorized ephemeral binary-message receive channel for one
-     * exact server peer. Its ordinary descriptor must be sent explicitly.
-     */
-    createBinaryMessageChannel(optionsArg: INativeMessageCreateBinaryChannelOptions): INativeMessageReceiveGrant;
+    createVirtualStream<TDirection extends TVirtualStreamDirection>(optionsArg: ICreateVirtualStreamOptions<TDirection>): plugins.typedrequestInterfaces.TVirtualStream<TDirection>;
     /**
      * Gets the current connection status
      */
@@ -301,6 +271,8 @@ export declare class TypedSocket {
      * @client-only
      */
     removeTag(name: string): Promise<void>;
+    /** Returns the transport-owned SmartServe routing surface for an application router. */
+    getServerRoutingSurface(applicationRouterArg?: plugins.typedrequest.TypedRouter): plugins.typedrequest.TypedRouter;
     /**
      * Resolves the exact SmartServe transport peer for one incoming TypedRequest.
      * Server handlers can pass their TypedTools argument without type assertions.