@grest-ts/websocket 0.0.23 → 0.0.25

package/dist/src/client/GGWebSocketSchema.createClient.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Client extension for GGWebSocketSchema - adds createClient method.
+ *
+ * Mirrors the server's onConnection handler exactly:
+ *
+ *   server: ChatApi.register((incoming, outgoing) => {
+ *       incoming.on({ ... })
+ *   })
+ *
+ *   client: const client = ChatApi.createClient({ url })
+ *           await client.connect(({incoming, outgoing}) => {
+ *               incoming.on({ ... })
+ *           })
+ *           await client.outgoing.xxx(...)
+ *
+ * The setup callback is the single place that wires handlers. It is re-run on
+ * every successful (re)connection, so auto-reconnect produces a fully-rewired
+ * client without any persistent-handler state to go stale.
+ *
+ * Works in both browser and Node.js contexts.
+ */
+import { GGWebSocketMiddleware } from "../schema/GGWebSocketMiddleware";
+export interface GGHeartbeatConfig {
+    /** How often to send a PING. Default 30 000 ms. */
+    intervalMs?: number;
+    /** Grace period for a PONG after each PING. Default 10 000 ms. */
+    timeoutMs?: number;
+}
+export interface GGReconnectConfig {
+    /** First retry delay. Default 500 ms. */
+    initialDelayMs?: number;
+    /** Delay cap for exponential backoff. Default 30 000 ms. */
+    maxDelayMs?: number;
+    /** Backoff multiplier. Default 2. */
+    multiplier?: number;
+    /** Give up after this many consecutive failures. Default Infinity. */
+    maxAttempts?: number;
+    /**
+     * Predicate deciding whether an error during a reconnect attempt should
+     * trigger another retry. Default: retry on any error EXCEPT NOT_AUTHORIZED
+     * and FORBIDDEN — those are treated as permanent and fire a final onClose
+     * with reason "unrecoverable". Return true to retry, false to give up.
+     */
+    shouldRetry?: (error: Error) => boolean;
+    /**
+     * Dead-connection detection via protocol PING/PONG. Off by default.
+     * Only supported on Node (browsers cannot initiate pings). Browser clients
+     * silently ignore this config.
+     */
+    heartbeat?: GGHeartbeatConfig;
+}
+export interface GGWebSocketClientConfig<TQuery = undefined> {
+    /**
+     * WebSocket server URL, e.g. "ws://localhost:3000".
+     * If omitted, uses service discovery (requires @grest-ts/discovery).
+     * In browsers, pass an explicit URL (or "" for same-origin).
+     */
+    url?: string;
+    /**
+     * Query parameters to include on connect. Typed from `queryOnConnect<T>()` if used.
+     * If the schema declares a query validator, it's applied here before connecting.
+     */
+    query?: TQuery;
+    /**
+     * Extra middlewares merged on top of the schema's middlewares, in order.
+     * Use this to attach per-client concerns (e.g. a static auth token) without
+     * requiring callers to set up a GGContext around connect(). Manual
+     * header manipulation is intentionally not exposed — middleware is the API.
+     */
+    middlewares?: GGWebSocketMiddleware[];
+    /**
+     * Default timeout in ms for request/response outgoing calls. Defaults to 30 000.
+     * Fire-and-forget methods ignore this.
+     */
+    timeout?: number;
+    /**
+     * Auto-reconnect on unexpected drops. Default off.
+     * `true` enables with defaults; pass an object to tune.
+     * Manual `disconnect()` / `close()` always wins over reconnect.
+     */
+    reconnect?: boolean | GGReconnectConfig;
+}
+export interface GGWebSocketSetupTools<TServerToClientImpl, TClientToServer> {
+    incoming: {
+        /**
+         * Register handlers for serverToClient messages.
+         * Partial — register only methods you care about.
+         */
+        on(handlers: Partial<TServerToClientImpl>): void;
+    };
+    outgoing: TClientToServer;
+}
+/**
+ * Setup callback — receives handler registration tools + outgoing methods.
+ * Re-invoked on every successful (re)connection; keep it pure wrt setup actions.
+ *
+ * For correctness: register incoming handlers synchronously at the top of the
+ * callback (before any `await`), so no pushed message can slip through before
+ * handlers exist.
+ */
+export type GGWebSocketSetup<TServerToClientImpl, TClientToServer> = (tools: GGWebSocketSetupTools<TServerToClientImpl, TClientToServer>) => void | Promise<void>;
+/**
+ * Reason the client was finally closed (no further reconnects will happen).
+ *
+ *  - "manual"            — user called disconnect()/close()
+ *  - "drop"              — socket dropped and reconnect is disabled
+ *  - "retries-exhausted" — reconnect enabled, hit maxAttempts
+ *  - "unrecoverable"     — reconnect skipped due to shouldRetry returning false
+ *                          (default: NOT_AUTHORIZED / FORBIDDEN)
+ */
+export type GGWebSocketCloseReason = "manual" | "drop" | "retries-exhausted" | "unrecoverable";
+export interface GGWebSocketClient<TClientToServer, TServerToClientImpl> {
+    /**
+     * Methods to call on the server (clientToServer).
+     * Throws `SERVER_ERROR` synchronously if called before connect().
+     */
+    readonly outgoing: TClientToServer;
+    /** True when a socket is connected and the handshake has completed. */
+    readonly isConnected: boolean;
+    /**
+     * Establish the connection and run the setup callback.
+     * If `reconnect` is enabled, the callback is re-invoked on every successful
+     * reconnection, so handlers + initial outgoing calls rebuild the full state.
+     */
+    connect(setup?: GGWebSocketSetup<TServerToClientImpl, TClientToServer>): Promise<void>;
+    /**
+     * Gracefully close. Disables further auto-reconnect and drains pending calls.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Immediately close. Disables further auto-reconnect.
+     */
+    close(): void;
+    /**
+     * Fires once, when the client has stopped reconnecting.
+     * The `reason` identifies why; for terminal/error cases `error` carries the cause.
+     */
+    onClose(cb: (reason: GGWebSocketCloseReason, error?: Error) => void): this;
+    /**
+     * Fires on every socket drop (before any reconnect attempt).
+     * `"manual"` = user called disconnect/close; `"drop"` = unexpected.
+     */
+    onDisconnect(cb: (reason: "manual" | "drop") => void): this;
+    /**
+     * Fires on socket errors. Multiple events possible per connection lifetime.
+     */
+    onError(cb: (error: Error) => void): this;
+}
+declare module "../schema/GGWebSocketSchema" {
+    interface GGWebSocketSchema<TClientToServer, TServerToClient, TContext = {}, TQuery = undefined, TClientToServerImpl = TClientToServer, TServerToClientImpl = TServerToClient> {
+        createClient(config?: GGWebSocketClientConfig<TQuery>): GGWebSocketClient<TClientToServer, TServerToClientImpl>;
+    }
+}
+//# sourceMappingURL=GGWebSocketSchema.createClient.d.ts.map

package/dist/src/client/GGWebSocketSchema.createClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGWebSocketSchema.createClient.d.ts","sourceRoot":"","sources":["../../../src/client/GGWebSocketSchema.createClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAcH,OAAO,EAAC,qBAAqB,EAAC,MAAM,iCAAiC,CAAA;AAErE,MAAM,WAAW,iBAAiB;IAC9B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,iBAAiB;IAC9B,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAA;CAChC;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,SAAS;IACvD;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAA;CAC1C;AAED,MAAM,WAAW,qBAAqB,CAAC,mBAAmB,EAAE,eAAe;IACvE,QAAQ,EAAE;QACN;;;WAGG;QACH,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAA;KACnD,CAAA;IACD,QAAQ,EAAE,eAAe,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,CAAC,mBAAmB,EAAE,eAAe,IAAI,CACjE,KAAK,EAAE,qBAAqB,CAAC,mBAAmB,EAAE,eAAe,CAAC,KACjE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,MAAM,GAAG,mBAAmB,GAAG,eAAe,CAAA;AAE9F,MAAM,WAAW,iBAAiB,CAAC,eAAe,EAAE,mBAAmB;IACnE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAElC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAE7B;;;;OAIG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtF;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;IAEb;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;IAE1E;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IAE3D;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;CAC5C;AAED,OAAO,QAAQ,6BAA6B,CAAC;IACzC,UAAU,iBAAiB,CACvB,eAAe,EACf,eAAe,EACf,QAAQ,GAAG,EAAE,EACb,MAAM,GAAG,SAAS,EAClB,mBAAmB,GAAG,eAAe,EACrC,mBAAmB,GAAG,eAAe;QAErC,YAAY,CACR,MAAM,CAAC,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACzC,iBAAiB,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAA;KAC7D;CACJ"}

package/dist/src/client/GGWebSocketSchema.createClient.js

@@ -0,0 +1,345 @@
+/**
+ * Client extension for GGWebSocketSchema - adds createClient method.
+ *
+ * Mirrors the server's onConnection handler exactly:
+ *
+ *   server: ChatApi.register((incoming, outgoing) => {
+ *       incoming.on({ ... })
+ *   })
+ *
+ *   client: const client = ChatApi.createClient({ url })
+ *           await client.connect(({incoming, outgoing}) => {
+ *               incoming.on({ ... })
+ *           })
+ *           await client.outgoing.xxx(...)
+ *
+ * The setup callback is the single place that wires handlers. It is re-run on
+ * every successful (re)connection, so auto-reconnect produces a fully-rewired
+ * client without any persistent-handler state to go stale.
+ *
+ * Works in both browser and Node.js contexts.
+ */
+import { FORBIDDEN, GGContractExecutor, GGPromise, NOT_AUTHORIZED, SERVER_ERROR, VALIDATION_ERROR, } from "@grest-ts/schema";
+import { GGWebSocketSchema } from "../schema/GGWebSocketSchema.js";
+import { GGSocketPool } from "./GGSocketPool.js";
+/** Default: don't retry if the server said "auth" — re-trying won't help. */
+const defaultShouldRetry = (err) => {
+    if (err instanceof NOT_AUTHORIZED)
+        return false;
+    if (err instanceof FORBIDDEN)
+        return false;
+    return true;
+};
+function normalizeReconnect(r) {
+    if (!r)
+        return null;
+    const cfg = r === true ? {} : r;
+    return {
+        initialDelayMs: cfg.initialDelayMs ?? 500,
+        maxDelayMs: cfg.maxDelayMs ?? 30_000,
+        multiplier: cfg.multiplier ?? 2,
+        maxAttempts: cfg.maxAttempts ?? Infinity,
+        shouldRetry: cfg.shouldRetry ?? defaultShouldRetry,
+        heartbeat: cfg.heartbeat
+            ? {
+                intervalMs: cfg.heartbeat.intervalMs ?? 30_000,
+                timeoutMs: cfg.heartbeat.timeoutMs ?? 10_000,
+            }
+            : undefined,
+    };
+}
+GGWebSocketSchema.prototype.createClient = function (config) {
+    const contract = this.contract;
+    if (!contract) {
+        throw new Error(`WebSocketSchema "${this.name}" has no contract.`);
+    }
+    const schemaName = this.name;
+    const normalizedPath = this.path.startsWith("/") ? this.path : "/" + this.path;
+    const schemaMiddlewares = this.middlewares || [];
+    const queryValidator = this.queryValidator;
+    const clientToServerContract = contract.clientToServer;
+    const serverToClientContract = contract.serverToClient;
+    const timeout = config?.timeout ?? 30_000;
+    const reconnectConfig = normalizeReconnect(config?.reconnect);
+    let socket;
+    let savedSetup;
+    let reconnectAttempt = 0;
+    let reconnectTimer;
+    let finallyClosed = false;
+    let finalCloseFired = false;
+    const onCloseCallbacks = [];
+    const onDisconnectCallbacks = [];
+    const onErrorCallbacks = [];
+    // --------------------------------------------------------------------
+    // URL resolution + query validation
+    // --------------------------------------------------------------------
+    const resolveDomain = async () => {
+        if (config?.url !== undefined) {
+            return config.url;
+        }
+        try {
+            const { GG_DISCOVERY } = await import(/* @vite-ignore */ "@grest-ts/discovery");
+            return await GG_DISCOVERY.get().discoverApi(schemaName);
+        }
+        catch (err) {
+            throw new SERVER_ERROR({
+                displayMessage: "Service discovery failed for WebSocket API " + schemaName,
+                originalError: err,
+            });
+        }
+    };
+    const validateQuery = () => {
+        if (!queryValidator)
+            return config?.query;
+        if (config?.query === undefined)
+            return undefined;
+        const parsed = queryValidator.safeParse(config.query, true);
+        if (parsed.success === false) {
+            throw new VALIDATION_ERROR(parsed.issues.toJSON(), { displayMessage: "Invalid query parameters" });
+        }
+        return parsed.value;
+    };
+    // --------------------------------------------------------------------
+    // Outgoing — stable object; methods throw if called before/after connect
+    // --------------------------------------------------------------------
+    const outgoingImpl = {};
+    for (const methodName of Object.keys(clientToServerContract.methods)) {
+        const contractFn = clientToServerContract.methods[methodName];
+        const hasResponse = contractFn.success !== undefined;
+        outgoingImpl[methodName] = async (data) => {
+            if (!socket) {
+                throw new SERVER_ERROR({
+                    displayMessage: "WebSocket client is not connected. Call connect() first.",
+                });
+            }
+            return socket.send(`${schemaName}.${methodName}`, data, hasResponse, timeout);
+        };
+    }
+    const outgoing = clientToServerContract.implement(outgoingImpl, { skipLocatorRegistration: true });
+    // --------------------------------------------------------------------
+    // Setup tools factory — fresh per connect attempt
+    // --------------------------------------------------------------------
+    const buildSetupTools = (s) => ({
+        incoming: {
+            on(handlers) {
+                for (const methodName of Object.keys(handlers)) {
+                    const userHandler = handlers[methodName];
+                    if (!userHandler)
+                        continue;
+                    const contractFn = serverToClientContract.methods[methodName];
+                    if (!contractFn) {
+                        throw new Error(`Method "${methodName}" is not defined in serverToClient of "${schemaName}"`);
+                    }
+                    const wrapped = (data) => new GGPromise(GGContractExecutor.call(contractFn, data, undefined, async (validated) => userHandler(validated)));
+                    s.registerHandler({ path: `${schemaName}.${methodName}`, handler: wrapped });
+                }
+            },
+        },
+        outgoing,
+    });
+    // --------------------------------------------------------------------
+    // Connection flow
+    // --------------------------------------------------------------------
+    /**
+     * Open one socket. Runs setup, wires close/error handlers, starts heartbeat.
+     * Throws on any failure — caller (initial connect or reconnect loop) decides
+     * retry policy. Never leaves a socket dangling on error.
+     */
+    const openOnce = async () => {
+        const domain = await resolveDomain();
+        const validatedQuery = validateQuery();
+        const merged = [...schemaMiddlewares, ...(config?.middlewares ?? [])];
+        const newSocket = await GGSocketPool.connect({
+            domain,
+            path: normalizedPath,
+            query: validatedQuery,
+            middlewares: merged,
+        });
+        // #1: If user called disconnect() while we were awaiting the handshake,
+        //     close the freshly-opened socket immediately — don't leak it.
+        if (finallyClosed) {
+            newSocket.close();
+            return;
+        }
+        socket = newSocket;
+        // setupPhase guards the onClose listener: while setup is in flight, a drop
+        // (whether from setup's own catch closing the socket, or an external close)
+        // only fires onDisconnect. Reconnect scheduling / finalClose are the job of
+        // the catch chain in this openOnce call or its caller (scheduleReconnect).
+        // After setup completes, setupPhase is cleared and onClose becomes the
+        // authoritative reconnect dispatcher.
+        let setupPhase = true;
+        newSocket.onClose(() => {
+            if (socket === newSocket) {
+                socket = undefined;
+            }
+            fireOnDisconnect(finallyClosed ? "manual" : "drop");
+            if (finallyClosed) {
+                fireFinalClose("manual");
+                return;
+            }
+            if (setupPhase) {
+                // Catch chain owns retry decisions for setup-phase failures.
+                return;
+            }
+            if (!reconnectConfig) {
+                fireFinalClose("drop");
+                return;
+            }
+            if (reconnectAttempt >= reconnectConfig.maxAttempts) {
+                fireFinalClose("retries-exhausted");
+                return;
+            }
+            scheduleReconnect();
+        });
+        for (const cb of onErrorCallbacks)
+            newSocket.onError(cb);
+        // Heartbeat (if configured and adapter supports it — browsers no-op).
+        if (reconnectConfig?.heartbeat) {
+            newSocket.startHeartbeat(reconnectConfig.heartbeat);
+        }
+        // #2: Run setup with explicit cleanup on throw so we never leak a socket.
+        if (savedSetup) {
+            try {
+                await savedSetup(buildSetupTools(newSocket));
+            }
+            catch (setupErr) {
+                if (socket === newSocket) {
+                    socket = undefined;
+                }
+                try {
+                    newSocket.close();
+                }
+                catch (_) { }
+                throw setupErr;
+            }
+        }
+        setupPhase = false;
+        reconnectAttempt = 0;
+    };
+    /**
+     * Schedule a retry per the reconnect config. Called from the onClose handler
+     * (socket dropped) — never from initial connect().
+     */
+    const scheduleReconnect = () => {
+        if (!reconnectConfig)
+            return;
+        const attempt = reconnectAttempt++;
+        const delay = Math.min(reconnectConfig.initialDelayMs * Math.pow(reconnectConfig.multiplier, attempt), reconnectConfig.maxDelayMs);
+        reconnectTimer = setTimeout(async () => {
+            reconnectTimer = undefined;
+            if (finallyClosed)
+                return;
+            try {
+                await openOnce();
+            }
+            catch (err) {
+                const error = err;
+                for (const cb of onErrorCallbacks) {
+                    try {
+                        cb(error);
+                    }
+                    catch (_) { }
+                }
+                // #4: terminal errors skip further retries.
+                if (!reconnectConfig.shouldRetry(error)) {
+                    fireFinalClose("unrecoverable", error);
+                    return;
+                }
+                if (reconnectAttempt < reconnectConfig.maxAttempts) {
+                    scheduleReconnect();
+                }
+                else {
+                    fireFinalClose("retries-exhausted", error);
+                }
+            }
+        }, delay);
+    };
+    const fireOnDisconnect = (reason) => {
+        for (const cb of onDisconnectCallbacks) {
+            try {
+                cb(reason);
+            }
+            catch (_) { }
+        }
+    };
+    const fireFinalClose = (reason, error) => {
+        if (finalCloseFired)
+            return;
+        finalCloseFired = true;
+        for (const cb of onCloseCallbacks) {
+            try {
+                cb(reason, error);
+            }
+            catch (_) { }
+        }
+    };
+    // --------------------------------------------------------------------
+    // Public client surface
+    // --------------------------------------------------------------------
+    const client = {
+        outgoing,
+        get isConnected() {
+            return socket !== undefined;
+        },
+        async connect(setup) {
+            if (finallyClosed) {
+                throw new SERVER_ERROR({
+                    displayMessage: "WebSocket client has been closed and cannot be reconnected. Create a new client.",
+                });
+            }
+            if (socket)
+                return;
+            savedSetup = setup;
+            await openOnce();
+        },
+        async disconnect() {
+            finallyClosed = true;
+            if (reconnectTimer) {
+                clearTimeout(reconnectTimer);
+                reconnectTimer = undefined;
+            }
+            const s = socket;
+            socket = undefined;
+            if (s) {
+                await s.teardown();
+            }
+            else {
+                fireOnDisconnect("manual");
+                fireFinalClose("manual");
+            }
+        },
+        close() {
+            finallyClosed = true;
+            if (reconnectTimer) {
+                clearTimeout(reconnectTimer);
+                reconnectTimer = undefined;
+            }
+            const s = socket;
+            socket = undefined;
+            if (s) {
+                s.close();
+            }
+            else {
+                fireOnDisconnect("manual");
+                fireFinalClose("manual");
+            }
+        },
+        onClose(cb) {
+            onCloseCallbacks.push(cb);
+            return this;
+        },
+        onDisconnect(cb) {
+            onDisconnectCallbacks.push(cb);
+            return this;
+        },
+        onError(cb) {
+            onErrorCallbacks.push(cb);
+            if (socket)
+                socket.onError(cb);
+            return this;
+        },
+    };
+    return client;
+};
+//# sourceMappingURL=GGWebSocketSchema.createClient.js.map

package/dist/src/client/GGWebSocketSchema.createClient.js.map

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

package/dist/src/index-browser.d.ts

@@ -5,6 +5,7 @@ export * from "./socket/GGSocket";
 export * from "./schema/webSocketSchema";
 export * from "./schema/GGWebSocketSchema";
 export * from "./schema/GGWebSocketMiddleware";
-export * from "./client/GGSocketClient";
 export * from "./client/GGSocketPool";
+export * from "./client/GGWebSocketSchema.createClient";
+import "./client/GGWebSocketSchema.createClient";
 //# sourceMappingURL=index-browser.d.ts.map

package/dist/src/index-browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-browser.d.ts","sourceRoot":"","sources":["../../src/index-browser.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAG/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index-browser.d.ts","sourceRoot":"","sources":["../../src/index-browser.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAG/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yCAAyC,CAAC;AAGxD,OAAO,yCAAyC,CAAC"}

package/dist/src/index-browser.js

@@ -10,6 +10,8 @@ export * from "./schema/webSocketSchema.js";
 export * from "./schema/GGWebSocketSchema.js";
 export * from "./schema/GGWebSocketMiddleware.js";
 // Client
-export * from "./client/GGSocketClient.js";
 export * from "./client/GGSocketPool.js";
+export * from "./client/GGWebSocketSchema.createClient.js";
+// Extensions
+import "./client/GGWebSocketSchema.createClient.js";
 //# sourceMappingURL=index-browser.js.map

package/dist/src/index-browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-browser.js","sourceRoot":"","sources":["../../src/index-browser.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,yBAAyB,CAAC;AAExC,UAAU;AACV,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAEvC,OAAO;AACP,cAAc,mBAAmB,CAAC;AAElC,aAAa;AACb,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAE/C,SAAS;AACT,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index-browser.js","sourceRoot":"","sources":["../../src/index-browser.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,yBAAyB,CAAC;AAExC,UAAU;AACV,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAEvC,OAAO;AACP,cAAc,mBAAmB,CAAC;AAElC,aAAa;AACb,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAE/C,SAAS;AACT,cAAc,uBAAuB,CAAC;AACtC,cAAc,yCAAyC,CAAC;AAExD,aAAa;AACb,OAAO,yCAAyC,CAAC"}

package/dist/src/index-node.d.ts

@@ -8,7 +8,8 @@ export * from "./schema/GGWebSocketSchema";
 export * from "./schema/GGWebSocketMiddleware";
 export * from "./server/GGSocketServer";
 export * from "./server/GGWebSocketSchema.startServer";
-export * from "./client/GGSocketClient";
 export * from "./client/GGSocketPool";
+export * from "./client/GGWebSocketSchema.createClient";
 import "./server/GGWebSocketSchema.startServer";
+import "./client/GGWebSocketSchema.createClient";
 //# sourceMappingURL=index-node.d.ts.map

package/dist/src/index-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AAGxC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAG/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wCAAwC,CAAC;AAGvD,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,wCAAwC,CAAC"}
+{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AAGxC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAG/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wCAAwC,CAAC;AAGvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,yCAAyC,CAAC;AAGxD,OAAO,wCAAwC,CAAC;AAChD,OAAO,yCAAyC,CAAC"}

package/dist/src/index-node.js

@@ -15,8 +15,9 @@ export * from "./schema/GGWebSocketMiddleware.js";
 export * from "./server/GGSocketServer.js";
 export * from "./server/GGWebSocketSchema.startServer.js";
 // Client
-export * from "./client/GGSocketClient.js";
 export * from "./client/GGSocketPool.js";
+export * from "./client/GGWebSocketSchema.createClient.js";
 // Extensions
 import "./server/GGWebSocketSchema.startServer.js";
+import "./client/GGWebSocketSchema.createClient.js";
 //# sourceMappingURL=index-node.js.map

package/dist/src/index-node.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,yBAAyB,CAAC;AAExC,UAAU;AACV,cAAc,6BAA6B,CAAC;AAE5C,UAAU;AACV,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAEvC,OAAO;AACP,cAAc,mBAAmB,CAAC;AAElC,aAAa;AACb,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAE/C,SAAS;AACT,cAAc,yBAAyB,CAAC;AACxC,cAAc,wCAAwC,CAAC;AAEvD,SAAS;AACT,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,OAAO,wCAAwC,CAAC"}
+{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,yBAAyB,CAAC;AAExC,UAAU;AACV,cAAc,6BAA6B,CAAC;AAE5C,UAAU;AACV,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAEvC,OAAO;AACP,cAAc,mBAAmB,CAAC;AAElC,aAAa;AACb,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAE/C,SAAS;AACT,cAAc,yBAAyB,CAAC;AACxC,cAAc,wCAAwC,CAAC;AAEvD,SAAS;AACT,cAAc,uBAAuB,CAAC;AACtC,cAAc,yCAAyC,CAAC;AAExD,aAAa;AACb,OAAO,wCAAwC,CAAC;AAChD,OAAO,yCAAyC,CAAC"}

package/dist/src/schema/GGWebSocketMiddleware.d.ts

@@ -1,3 +1,4 @@
+import type { GGSchema } from "@grest-ts/schema";
 /**
  * WebSocket-specific middleware interface.
  * Independent from @grest-ts/http - WebSocket has its own middleware system.
@@ -20,6 +21,17 @@ export interface GGWebSocketHandshakeContext {
  * Unlike HTTP middleware, WebSocket middleware works with handshake data.
  */
 export interface GGWebSocketMiddleware {
+    /**
+     * Handshake headers this middleware reads or writes, mapped to their value schemas.
+     * Keys are header names; values describe the header value format for docs and OpenAPI/AsyncAPI.
+     * Use {} if the middleware touches no custom handshake headers.
+     *
+     * @example
+     * headers: {
+     *   "authorization": IsBearerToken.docs({description: "JWT access token"})
+     * }
+     */
+    readonly headers?: Record<string, GGSchema<string | undefined>>;
     /**
      * Client-side: Add headers to the handshake message before sending.
      * Called by GGSocketPool when establishing a connection.

package/dist/src/schema/GGWebSocketMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GGWebSocketMiddleware.d.ts","sourceRoot":"","sources":["../../../src/schema/GGWebSocketMiddleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAE7D;;;OAGG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAE5D;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"GGWebSocketMiddleware.d.ts","sourceRoot":"","sources":["../../../src/schema/GGWebSocketMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAE/C;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAEhE;;;OAGG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAE7D;;;OAGG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAE5D;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/dist/src/schema/GGWebSocketMiddleware.js

@@ -1,6 +1,2 @@
-/**
- * WebSocket-specific middleware interface.
- * Independent from @grest-ts/http - WebSocket has its own middleware system.
- */
 export {};
 //# sourceMappingURL=GGWebSocketMiddleware.js.map

package/dist/src/schema/GGWebSocketMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"GGWebSocketMiddleware.js","sourceRoot":"","sources":["../../../src/schema/GGWebSocketMiddleware.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"GGWebSocketMiddleware.js","sourceRoot":"","sources":["../../../src/schema/GGWebSocketMiddleware.ts"],"names":[],"mappings":""}

package/dist/src/schema/GGWebSocketSchema.d.ts

@@ -1,5 +1,5 @@
 import { GGWebSocketMiddleware } from "./GGWebSocketMiddleware";
-import { GGContractApiDefinition, GGContractClass } from "@grest-ts/schema";
+import { GGContractApiDefinition, GGContractClass, GGValidator } from "@grest-ts/schema";
 /**
  * WebSocket API Schema - pure data definition with typed context
  *
@@ -10,13 +10,14 @@ import { GGContractApiDefinition, GGContractClass } from "@grest-ts/schema";
  * - TQuery: Query parameters on connect
  * - TClientToServerImpl: Server implementation type for clientToServer handlers (returns Promise)
  */
-export declare class GGWebSocketSchema<TClientToServer, TServerToClient, TContext = {}, TQuery = undefined, TClientToServerImpl = TClientToServer> {
+export declare class GGWebSocketSchema<TClientToServer, TServerToClient, TContext = {}, TQuery = undefined, TClientToServerImpl = TClientToServer, TServerToClientImpl = TServerToClient> {
     readonly name: string;
     readonly path: string;
     readonly middlewares: readonly GGWebSocketMiddleware[];
+    readonly queryValidator?: GGValidator<TQuery>;
     private readonly contractFactory;
     private contractCache;
-    constructor(name: string, path: string, contractFactory: () => GGWebSocketContractRuntime, middlewares?: readonly GGWebSocketMiddleware[]);
+    constructor(name: string, path: string, contractFactory: () => GGWebSocketContractRuntime, middlewares?: readonly GGWebSocketMiddleware[], queryValidator?: GGValidator<TQuery>);
     get contract(): GGWebSocketContractRuntime;
 }
 /**