typeferry 0.6.0

package/dist/client/client.js

@@ -0,0 +1,401 @@
+import isEqual from 'fast-deep-equal';
+import qs from 'query-string';
+import { isEmpty, isPlainObject, merge } from '../utils/lodash.js';
+import { TypeFerryEvents, ClientEvents, Environment, Errors, Methods, NO_CHANNEL, PayloadType, Presentation, TOKEN_HEADER_KEY, } from '../utils/index.js';
+import { callMethodProxy } from './call-method-proxy.js';
+import { ClientChannel } from './client-channel.js';
+import { ClientHttp } from './client-http.js';
+import { ClientSocket } from './client-socket.js';
+import { ContextManager } from './context-manager.js';
+import { IdleTimer } from './idle-timer.js';
+import { logger, LogLevel } from './logger.js';
+import { VisibilityManager } from './visibility-manager.js';
+/**
+ * When working with Next.js, it is probably a good idea to not run this in the
+ * server side by using it inside a `useEffect` hook.
+ */
+export class Client extends ClientChannel {
+    uuid;
+    clientSocket;
+    clientHttp;
+    contextManager;
+    errorHandler;
+    channels = new Map();
+    timeouts = new Set();
+    initialized = false;
+    authenticated = false;
+    options = {
+        host: 'localhost',
+        secure: false,
+        errorHandler: null,
+        debug: false,
+        logLevel: LogLevel.WARN,
+        allowedContextKeys: [],
+        meta: {},
+    };
+    /** Logger instance for this client */
+    logger = logger;
+    initializing;
+    visibilityManager;
+    idleTimer = null;
+    m;
+    // Note: Heartbeat is handled by application-level ping/pong in the WebSocket transport
+    get context() {
+        return this.contextManager.context;
+    }
+    set context(value) {
+        this.contextManager.context = value;
+    }
+    constructor(options = {}) {
+        super(NO_CHANNEL);
+        this.m = callMethodProxy(this);
+        this.uuid = Presentation.uuid();
+        this.setClient(this);
+        this.options = merge(this.options, options);
+        const storage = typeof localStorage !== 'undefined' ? localStorage : undefined;
+        this.contextManager = new ContextManager(storage);
+        this.contextManager.on(ClientEvents.CONTEXT_CHANGED, () => this.emit(ClientEvents.CONTEXT_CHANGED));
+        this.clientHttp = new ClientHttp(this);
+        this.channels.set(NO_CHANNEL, this);
+        /**
+         * The client should only ever be ready when the context is loaded,
+         * scheduling the client socket construction for after the context
+         * is first loaded does the trick as the init event is only emitted after
+         * the ClientSocket is built.
+         */
+        this.loadContext();
+        if (this.options.initialContext) {
+            this.setContext(this.options.initialContext);
+        }
+        this.authenticated = !!this.context.token;
+        this.clientSocket = new ClientSocket(this, this.options.ws);
+        // Configure logger level
+        if (this.options.logLevel !== undefined) {
+            this.logger.setLevel(this.options.logLevel);
+        }
+        else if (this.options.debug) {
+            this.logger.setLevel(LogLevel.DEBUG);
+        }
+        this.on(ClientEvents.ERROR, error => {
+            this.logger.connection(LogLevel.ERROR, 'Client error', { error });
+        });
+        if (Environment.isBrowser && Environment.isDevelopment) {
+            // @ts-ignore
+            window.TypeFerry = this;
+        }
+        this.connect().catch(error => {
+            this.logger.connection(LogLevel.ERROR, 'Connection failed', { error });
+        });
+        const { idlenessTimeout } = this.options;
+        this.idleTimer = idlenessTimeout
+            ? new IdleTimer(this, idlenessTimeout)
+            : null;
+        this.visibilityManager = new VisibilityManager(this, this.idleTimer);
+    }
+    get isConnecting() {
+        return !!this.clientSocket?.connecting;
+    }
+    /**
+     * Forces a reconnection. Useful for testing or manual recovery.
+     */
+    reconnect() {
+        this.visibilityManager.reconnect();
+    }
+    get isOffline() {
+        return !this.clientSocket?.ready;
+    }
+    get isOnline() {
+        return !!this.clientSocket?.ready;
+    }
+    get connected() {
+        return this.clientSocket.ready;
+    }
+    /**
+     * Opens the WebSocket connection and waits for initialization.
+     * Reconnection is handled entirely by ClientSocket's exponential
+     * backoff — this method just waits for the first successful init.
+     */
+    async connect() {
+        this.clientSocket.connect();
+        try {
+            await this.waitFor(ClientEvents.INITIALIZED, 30000);
+        }
+        catch (error) {
+            this.logger.connection(LogLevel.ERROR, 'Initialization failed', {}, error);
+            this.emit(ClientEvents.INITIALIZATION_FAILED, { error });
+        }
+    }
+    /** Delegates to ContextManager. */
+    loadContext() {
+        this.contextManager.loadContext();
+    }
+    /** Delegates to ContextManager. */
+    setContext(context) {
+        this.contextManager.setContext(context);
+    }
+    /**
+     * Sets context (if changed) and reconnects the socket to re-authenticate.
+     * Stops the current socket without triggering auto-reconnection, then
+     * opens a fresh connection with the new context (token in query params).
+     */
+    async setContextAndReInit(context) {
+        if (!isEqual(this.context, context)) {
+            this.setContext(context);
+        }
+        // Stop any ongoing reconnection attempts before starting fresh.
+        this.clientSocket.stopped = true;
+        this.clientSocket.clearReconnectTimer();
+        const oldSocket = this.clientSocket.socket;
+        if (oldSocket) {
+            oldSocket.onclose = null;
+            oldSocket.onerror = null;
+            oldSocket.onmessage = null;
+            oldSocket.close();
+            this.clientSocket.socket = undefined;
+        }
+        this.logger.auth(LogLevel.DEBUG, 'setContextAndReInit: connecting');
+        this.clientSocket.connect();
+        this.logger.auth(LogLevel.DEBUG, 'setContextAndReInit: waiting for INITIALIZED');
+        await this.waitFor(ClientEvents.INITIALIZED, 10000);
+        this.logger.auth(LogLevel.DEBUG, 'setContextAndReInit: done');
+    }
+    /** Delegates to ContextManager. */
+    updateContext(context) {
+        this.contextManager.updateContext(context);
+    }
+    /** Delegates to ContextManager. */
+    clearContext() {
+        this.contextManager.clearContext();
+    }
+    async close() {
+        this.emit(ClientEvents.CLOSE);
+        this.timeouts.forEach(timeout => clearTimeout(timeout));
+        this.idleTimer?.destroy();
+        this.visibilityManager.destroy();
+        // Clear event sub/unsub timeouts.
+        this.channels.forEach(channel => {
+            channel.emit(TypeFerryEvents.COMMIT_PENDING_SUBSCRIPTIONS, {});
+        });
+        this.channels.forEach(channel => {
+            channel.emit(TypeFerryEvents.COMMIT_PENDING_UNSUBSCRIPTIONS, {});
+        });
+        await this.clientSocket.close();
+    }
+    /**
+     * Initializes the client. It should be called before any other method.
+     *
+     * It should be called whenever a transport is connected, either on reconnection or from calling `connect`.
+     * Auth now happens during connection handshake. The authenticated state is set by AUTH_RESULT message.
+     */
+    async initialize() {
+        if (this.initializing) {
+            await this.waitFor(ClientEvents.INITIALIZED);
+            return;
+        }
+        this.initializing = true;
+        this.initialized = false;
+        this.loadContext();
+        this.emit(ClientEvents.INITIALIZING);
+        this.initialized = true;
+        this.initializing = false;
+        await this.resubscribeAllChannels();
+        this.emit(ClientEvents.INITIALIZED, this.authenticated);
+        return true;
+    }
+    /**
+     * The login method is always called via http so a http-only cookie can be set if the user so prefers.
+     */
+    async login(params, opts) {
+        const response = await this.call(Methods.RPC_LOGIN, params, {
+            ...opts,
+            http: true,
+        });
+        if (!response || isEmpty(response)) {
+            throw new Error(Errors.AUTHENTICATION_FAILED);
+        }
+        if (isPlainObject(response)) {
+            await this.setContextAndReInit(response);
+        }
+    }
+    async logout() {
+        await this.call(Methods.RPC_LOGOUT);
+        this.authenticated = false;
+        this.clearContext();
+        this.emit(ClientEvents.LOGOUT, false);
+    }
+    async resubscribeAllChannels() {
+        for (const [, channel] of this.channels) {
+            await channel.resubscribe();
+        }
+    }
+    async disconnect() {
+        return this.close();
+    }
+    /**
+     * Calls a method without expecting a return value (fire-and-forget).
+     */
+    void(method, params, { http, httpFallback = true } = {}) {
+        return new Promise((resolve, reject) => {
+            const payload = { method, params };
+            this.emit(ClientEvents.OUTBOUND_MESSAGE, payload);
+            if (http || (!this.clientSocket.ready && httpFallback)) {
+                const uuid = Presentation.uuid();
+                const httpPayload = {
+                    type: PayloadType.METHOD,
+                    uuid,
+                    method,
+                    params,
+                    void: true,
+                };
+                return this.clientHttp.request(httpPayload, null, reject);
+            }
+            // Fire-and-forget: send without waiting for acknowledgment
+            this.clientSocket.send('rpc:void', payload);
+            resolve();
+        });
+    }
+    async waitForInitialization(timeout) {
+        try {
+            this.logger.connection(LogLevel.DEBUG, 'Waiting for initialization', {
+                timeout,
+            });
+            await this.waitFor(ClientEvents.INITIALIZED, Math.floor(timeout / 2));
+        }
+        catch {
+            throw new Error('TypeFerry: Client not initialized');
+        }
+    }
+    /**
+     * Executes a method call using WebSocket RPC or HTTP fallback.
+     * Uses UUID-based request/response correlation.
+     */
+    async executeCall(method, params, http, httpFallback, timeout) {
+        this.emit(ClientEvents.OUTBOUND_MESSAGE, { method, params });
+        // HTTP path: used when http=true or socket not ready with fallback enabled
+        if (http || (!this.clientSocket.ready && httpFallback)) {
+            return new Promise((resolve, reject) => {
+                const uuid = Presentation.uuid();
+                const payload = { uuid, type: PayloadType.METHOD, method, params };
+                this.clientHttp.request(payload, resolve, reject);
+            });
+        }
+        // WebSocket path: use UUID-correlated RPC
+        try {
+            return await this.clientSocket.emitWithAck('rpc', { method, params }, timeout);
+        }
+        catch (error) {
+            // Pass through errorHandler if configured
+            if (this.errorHandler) {
+                this.errorHandler(error);
+            }
+            throw error;
+        }
+    }
+    static DEFAULT_CALL_OPTIONS = {
+        timeout: 20000,
+        http: undefined,
+        httpFallback: true,
+        ignoreInit: false,
+        maxRetries: 0,
+        delayBetweenRetriesMs: 3000,
+    };
+    normalizeCallOptions(options) {
+        return { ...Client.DEFAULT_CALL_OPTIONS, ...options };
+    }
+    async retryCall(method, params, opts) {
+        let lastError;
+        for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+            try {
+                return await this.executeCall(method, params, opts.http, opts.httpFallback, opts.timeout);
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt > 0) {
+                    this.logger.method(LogLevel.WARN, 'Method call retry failed', {
+                        method,
+                        attempt: attempt + 1,
+                        maxRetries: opts.maxRetries,
+                        error: error.message,
+                    });
+                }
+                if (attempt >= opts.maxRetries)
+                    throw lastError;
+                await new Promise(resolve => setTimeout(resolve, opts.delayBetweenRetriesMs));
+            }
+        }
+    }
+    async call(method, params, options) {
+        const opts = this.normalizeCallOptions(options);
+        const shouldWaitForInit = !opts.ignoreInit && !this.initialized;
+        if (shouldWaitForInit)
+            await this.waitForInitialization(opts.timeout);
+        return this.retryCall(method, params, opts);
+    }
+    typed(types) {
+        return this;
+    }
+    combine(methods) {
+        return this;
+    }
+    /** Handles subscription events from the server. */
+    handleEvent(payload) {
+        this.emit(ClientEvents.INBOUND_MESSAGE, payload);
+        this.logger.channel(LogLevel.DEBUG, 'Event received', {
+            channel: payload.channel,
+            event: payload.event,
+        });
+        return this.channel(payload.channel).emit(payload.event, payload.params);
+    }
+    /**
+     * Generates a URL path from string parts. The last argument can be a query
+     * string object definition.
+     */
+    href(...path) {
+        let queryString = '';
+        if (isPlainObject(path.at(-1))) {
+            const params = path.pop();
+            queryString = '?'.concat(qs.stringify(params));
+        }
+        if (path.some(isPlainObject))
+            throw new Error('Parameters are only allowed in the last argument.');
+        return `${this.clientHttp.host}/${path
+            .join('/')
+            .replace(/^\/|\/{2,}/, '')}${queryString}`;
+    }
+    channel(name = NO_CHANNEL) {
+        if (name != null &&
+            typeof name === 'object' &&
+            name.constructor.name === 'ObjectId' &&
+            typeof name.toString === 'function') {
+            name = name.toString();
+        }
+        if (!name || typeof name !== 'string')
+            return null;
+        if (name === NO_CHANNEL)
+            return this;
+        const channelName = name;
+        if (this.channels.has(channelName))
+            return this.channels.get(channelName);
+        const channel = new ClientChannel(channelName);
+        channel.setClient(this);
+        this.channels.set(channelName, channel);
+        return channel;
+    }
+    isConnected() {
+        return new Promise(resolve => {
+            if (this.connected)
+                return resolve(true);
+            this.once(ClientEvents.INITIALIZED, () => resolve(true));
+        });
+    }
+    fetch(url, options = {}) {
+        return fetch(url, {
+            credentials: 'include',
+            headers: {
+                [TOKEN_HEADER_KEY]: this.context.token,
+            },
+            ...options,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,iBAAiB,CAAA;AACrC,OAAO,EAAE,MAAM,cAAc,CAAA;AAE7B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAG/D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,OAAO,EACP,UAAU,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,GACjB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAsDxD;;;GAGG;AACH,MAAM,OAAO,MAEX,SAAQ,aAAa;IACrB,IAAI,CAAQ;IAEZ,YAAY,CAAc;IAC1B,UAAU,CAAY;IACtB,cAAc,CAAgB;IAC9B,YAAY,CAAc;IAE1B,QAAQ,GAA+B,IAAI,GAAG,EAAE,CAAA;IAEhD,QAAQ,GAAiB,IAAI,GAAG,EAAE,CAAA;IAElC,WAAW,GAAG,KAAK,CAAA;IAEnB,aAAa,GAAG,KAAK,CAAA;IAErB,OAAO,GAAkB;QACvB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,KAAK;QACb,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,kBAAkB,EAAE,EAAE;QACtB,IAAI,EAAE,EAAE;KACT,CAAA;IAED,sCAAsC;IACtC,MAAM,GAAoB,MAAM,CAAA;IAEhC,YAAY,CAAS;IAErB,iBAAiB,CAAmB;IACpC,SAAS,GAAqB,IAAI,CAAA;IAElC,CAAC,CAAa;IAEd,uFAAuF;IAEvF,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAA;IACpC,CAAC;IAED,IAAI,OAAO,CAAC,KAAuB;QACjC,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,KAAK,CAAA;IACrC,CAAC;IAED,YAAY,UAAyB,EAAE;QACrC,KAAK,CAAC,UAAU,CAAC,CAAA;QAEjB,IAAI,CAAC,CAAC,GAAG,eAAe,CAAC,IAAI,CAA2B,CAAA;QAExD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,CAAA;QAE/B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAEpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAE3C,MAAM,OAAO,GACX,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAA;QAChE,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;QACjD,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,GAAG,EAAE,CACxD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CACxC,CAAA;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;QAEtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAEnC;;;;;WAKG;QACH,IAAI,CAAC,WAAW,EAAE,CAAA;QAElB,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QAC9C,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA;QAEzC,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAE3D,yBAAyB;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC7C,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACtC,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;YAClC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QACnE,CAAC,CAAC,CAAA;QAEF,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,aAAa,EAAE,CAAC;YACvD,aAAa;YACb,MAAM,CAAC,SAAS,GAAG,IAAI,CAAA;QACzB,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QACxE,CAAC,CAAC,CAAA;QAEF,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,OAAO,CAAA;QACxC,IAAI,CAAC,SAAS,GAAG,eAAe;YAC9B,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,eAAe,CAAC;YACtC,CAAC,CAAC,IAAI,CAAA;QACR,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACtE,CAAC;IAED,IAAI,YAAY;QACd,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAA;IACxC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAA;IACpC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAA;IAClC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAA;IACnC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;IAChC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAA;QAE3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,UAAU,CACpB,QAAQ,CAAC,KAAK,EACd,uBAAuB,EACvB,EAAE,EACF,KAAc,CACf,CAAA;YACD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,WAAW;QACT,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CAAA;IACnC,CAAC;IAED,mCAAmC;IACnC,UAAU,CAAC,OAAgC;QACzC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CAAC,OAAgC;QACxD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC;QAED,gEAAgE;QAChE,IAAI,CAAC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAA;QAChC,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAA;QAEvC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAA;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,GAAG,IAAI,CAAA;YACxB,SAAS,CAAC,OAAO,GAAG,IAAI,CAAA;YACxB,SAAS,CAAC,SAAS,GAAG,IAAI,CAAA;YAC1B,SAAS,CAAC,KAAK,EAAE,CAAA;YACjB,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,SAAS,CAAA;QACtC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,iCAAiC,CAAC,CAAA;QACnE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAA;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,QAAQ,CAAC,KAAK,EACd,8CAA8C,CAC/C,CAAA;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAA;IAC/D,CAAC;IAED,mCAAmC;IACnC,aAAa,CAAC,OAAgC;QAC5C,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IAC5C,CAAC;IAED,mCAAmC;IACnC,YAAY;QACV,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAE7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;QAEvD,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAA;QACzB,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAA;QAEhC,kCAAkC;QAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC9B,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAA;QAChE,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC9B,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAA;QAClE,CAAC,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IACjC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;YAC5C,OAAM;QACR,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QACxB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;QACxB,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAA;QAEpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACvB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QAEzB,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAA;QACnC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAEvD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,MAA8B,EAAE,IAAkB;QAC5D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE;YAC1D,GAAG,IAAI;YACP,IAAI,EAAE,IAAI;SACX,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAA;QAC/C,CAAC;QAED,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QACnC,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;QAC1B,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAA;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,CACF,MAAc,EACd,MAAwB,EACxB,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,KAAkB,EAAE;QAE/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;YAElC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;YAEjD,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,YAAY,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,CAAA;gBAChC,MAAM,WAAW,GAAG;oBAClB,IAAI,EAAE,WAAW,CAAC,MAAM;oBACxB,IAAI;oBACJ,MAAM;oBACN,MAAM;oBACN,IAAI,EAAE,IAAI;iBACX,CAAA;gBACD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;YAC3D,CAAC;YAED,2DAA2D;YAC3D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;YAE3C,OAAO,EAAE,CAAA;QACX,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,qBAAqB,CAAC,OAAe;QACjD,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,4BAA4B,EAAE;gBACnE,OAAO;aACR,CAAC,CAAA;YACF,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,WAAW,CACvB,MAAc,EACd,MAAW,EACX,IAAa,EACb,YAAqB,EACrB,OAAe;QAEf,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAE5D,2EAA2E;QAC3E,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,YAAY,CAAC,EAAE,CAAC;YACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,CAAA;gBAChC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;gBAClE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;YACnD,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,0CAA0C;QAC1C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CACxC,KAAK,EACL,EAAE,MAAM,EAAE,MAAM,EAAE,EAClB,OAAO,CACR,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0CAA0C;YAC1C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,YAAY,CAAC,KAAc,CAAC,CAAA;YACnC,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAEO,MAAM,CAAU,oBAAoB,GAAG;QAC7C,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,SAAgC;QACtC,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,CAAC;QACb,qBAAqB,EAAE,IAAI;KAC5B,CAAA;IAEO,oBAAoB,CAAC,OAAqB;QAChD,OAAO,EAAE,GAAG,MAAM,CAAC,oBAAoB,EAAE,GAAG,OAAO,EAAE,CAAA;IACvD,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,MAAc,EACd,MAAW,EACX,IAAkD;QAElD,IAAI,SAAc,CAAA;QAElB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YAC5D,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAC3B,MAAM,EACN,MAAM,EACN,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,OAAO,CACb,CAAA;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,CAAA;gBACjB,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,EAAE;wBAC5D,MAAM;wBACN,OAAO,EAAE,OAAO,GAAG,CAAC;wBACpB,UAAU,EAAE,IAAI,CAAC,UAAU;wBAC3B,KAAK,EAAG,KAAe,CAAC,OAAO;qBAChC,CAAC,CAAA;gBACJ,CAAC;gBACD,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU;oBAAE,MAAM,SAAS,CAAA;gBAC/C,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAC1B,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAChD,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAAc,EACd,MAAU,EACV,OAAqB;QAErB,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAA;QAE/C,MAAM,iBAAiB,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,WAAW,CAAA;QAC/D,IAAI,iBAAiB;YAAE,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAErE,OAAO,IAAI,CAAC,SAAS,CAAI,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,CAA0B,KAAQ;QACrC,OAAO,IAAwB,CAAA;IACjC,CAAC;IAED,OAAO,CAAmB,OAAU;QAClC,OAAO,IAA0D,CAAA;IACnE,CAAC;IAED,mDAAmD;IACnD,WAAW,CAAC,OAA6B;QACvC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE;YACpD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1E,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAsC;QAC5C,IAAI,WAAW,GAAG,EAAE,CAAA;QAEpB,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACzB,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,MAAa,CAAC,CAAC,CAAA;QACvD,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QAEtE,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI;aACnC,IAAI,CAAC,GAAG,CAAC;aACT,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,WAAW,EAAE,CAAA;IAC9C,CAAC;IAED,OAAO,CAAC,OAAwB,UAAU;QACxC,IACE,IAAI,IAAI,IAAI;YACZ,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,UAAU;YACpC,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EACnC,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QACxB,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QAClD,IAAI,IAAI,KAAK,UAAU;YAAE,OAAO,IAAI,CAAA;QAEpC,MAAM,WAAW,GAAG,IAAc,CAAA;QAElC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QAEzE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAA;QAC9C,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAEvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;QAEvC,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;YAC3B,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;YAExC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QAC1D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,UAAmC,EAAE;QACtD,OAAO,KAAK,CAAC,GAAG,EAAE;YAChB,WAAW,EAAE,SAAkB;YAC/B,OAAO,EAAE;gBACP,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;aACvC;YACD,GAAG,OAAO;SACX,CAAC,CAAA;IACJ,CAAC"}

package/dist/client/context-manager.d.ts

@@ -0,0 +1,54 @@
+import EventEmitter2 from '../utils/event-emitter.js';
+/**
+ * Known client-side context fields used by the auth/refresh system.
+ * The index signature allows arbitrary additional keys while giving
+ * first-class types to commonly accessed properties.
+ */
+export interface TypeFerryContext {
+    token?: string;
+    exp?: number;
+    iat?: number;
+    /** Local timestamp when the token was received — used for clock-skew-safe refresh scheduling. */
+    _tokenReceivedAt?: number;
+    [key: string]: unknown;
+}
+/**
+ * Manages client context (auth tokens, user data) with localStorage persistence
+ * and equality-guarded event emission. Extracted from Client to isolate context
+ * concerns from connection/RPC logic.
+ */
+export declare class ContextManager extends EventEmitter2 {
+    private storage?;
+    context: TypeFerryContext;
+    constructor(storage?: Storage);
+    /**
+     * Restores context from localStorage. Skips the update (and the resulting
+     * CONTEXT_CHANGED event) when the stored context matches what's already
+     * in memory — prevents redundant refresh cascades during initialize().
+     */
+    loadContext(): void;
+    /**
+     * Replaces context entirely, persists to storage, and emits CONTEXT_CHANGED.
+     *
+     * Sensitive keys like `refreshToken` are stripped before persisting to
+     * localStorage — the refresh token lives exclusively in an HttpOnly
+     * cookie to prevent XSS exfiltration.
+     */
+    setContext(context: Record<string, unknown>): void;
+    /**
+     * Merges partial context into the current context and persists the result.
+     * Skips the update (and the resulting CONTEXT_CHANGED event) when the
+     * merged context is identical to the current one — prevents redundant
+     * event cascades that cause infinite refresh loops on unstable transports.
+     */
+    updateContext(context: Record<string, unknown>): void;
+    /** Resets context to empty, removes from storage, and emits CONTEXT_CHANGED. */
+    clearContext(): void;
+}
+/**
+ * Clock-skew-safe token expiry check. Uses `iat` + `_tokenReceivedAt` when
+ * available to compute elapsed time relative to when the token was received
+ * locally, preventing false positives when the client clock diverges from
+ * the server.
+ */
+export declare function isTokenExpired(context: TypeFerryContext): boolean;

package/dist/client/context-manager.js

@@ -0,0 +1,89 @@
+import isEqual from 'fast-deep-equal';
+import { merge } from '../utils/lodash.js';
+import { EJSON } from '../ejson/index.js';
+import EventEmitter2 from '../utils/event-emitter.js';
+import { ClientEvents } from '../utils/index.js';
+const STORAGE_KEY = 'context';
+/**
+ * Manages client context (auth tokens, user data) with localStorage persistence
+ * and equality-guarded event emission. Extracted from Client to isolate context
+ * concerns from connection/RPC logic.
+ */
+export class ContextManager extends EventEmitter2 {
+    storage;
+    context = {};
+    constructor(storage) {
+        super({ maxListeners: 512 });
+        this.storage = storage;
+    }
+    /**
+     * Restores context from localStorage. Skips the update (and the resulting
+     * CONTEXT_CHANGED event) when the stored context matches what's already
+     * in memory — prevents redundant refresh cascades during initialize().
+     */
+    loadContext() {
+        if (!this.storage)
+            return;
+        const raw = this.storage.getItem(STORAGE_KEY);
+        if (!raw)
+            return;
+        const stored = EJSON.parse(raw);
+        if (isEqual(this.context, stored))
+            return;
+        this.updateContext(stored);
+    }
+    /**
+     * Replaces context entirely, persists to storage, and emits CONTEXT_CHANGED.
+     *
+     * Sensitive keys like `refreshToken` are stripped before persisting to
+     * localStorage — the refresh token lives exclusively in an HttpOnly
+     * cookie to prevent XSS exfiltration.
+     */
+    setContext(context) {
+        this.context = context;
+        if (this.storage) {
+            const { refreshToken: _, ...safe } = context;
+            this.storage.setItem(STORAGE_KEY, EJSON.stringify(safe));
+        }
+        this.emit(ClientEvents.CONTEXT_CHANGED);
+    }
+    /**
+     * Merges partial context into the current context and persists the result.
+     * Skips the update (and the resulting CONTEXT_CHANGED event) when the
+     * merged context is identical to the current one — prevents redundant
+     * event cascades that cause infinite refresh loops on unstable transports.
+     */
+    updateContext(context) {
+        const newContext = merge({}, this.context, context);
+        if (isEqual(this.context, newContext))
+            return;
+        this.setContext(newContext);
+    }
+    /** Resets context to empty, removes from storage, and emits CONTEXT_CHANGED. */
+    clearContext() {
+        this.context = {};
+        if (this.storage) {
+            this.storage.removeItem(STORAGE_KEY);
+        }
+        this.emit(ClientEvents.CONTEXT_CHANGED);
+    }
+}
+/**
+ * Clock-skew-safe token expiry check. Uses `iat` + `_tokenReceivedAt` when
+ * available to compute elapsed time relative to when the token was received
+ * locally, preventing false positives when the client clock diverges from
+ * the server.
+ */
+export function isTokenExpired(context) {
+    const { exp, iat, _tokenReceivedAt } = context;
+    if (!exp)
+        return false;
+    if (iat && _tokenReceivedAt) {
+        const tokenTtlMs = (exp - iat) * 1000;
+        const elapsedMs = Date.now() - _tokenReceivedAt;
+        return elapsedMs > tokenTtlMs;
+    }
+    const now = Math.floor(Date.now() / 1000);
+    return exp < now;
+}
+//# sourceMappingURL=context-manager.js.map

package/dist/client/context-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.js","sourceRoot":"","sources":["../../src/client/context-manager.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,iBAAiB,CAAA;AAErC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAChC,OAAO,aAAa,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC,MAAM,WAAW,GAAG,SAAS,CAAA;AAgB7B;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAG3B;IAFpB,OAAO,GAAqB,EAAE,CAAA;IAE9B,YAAoB,OAAiB;QACnC,KAAK,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAA;QADV,YAAO,GAAP,OAAO,CAAU;IAErC,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAC7C,IAAI,CAAC,GAAG;YAAE,OAAM;QAEhB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAA;QAC1D,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;YAAE,OAAM;QAEzC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,OAAgC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QAEtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;YAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;QAC1D,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAA;IACzC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,OAAgC;QAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAEnD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;YAAE,OAAM;QAE7C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IAC7B,CAAC;IAED,gFAAgF;IAChF,YAAY;QACV,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;QAEjB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;QACtC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAA;IACzC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAA;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAA;IAEtB,IAAI,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,CAAA;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAA;QAC/C,OAAO,SAAS,GAAG,UAAU,CAAA;IAC/B,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACzC,OAAO,GAAG,GAAG,GAAG,CAAA;AAClB,CAAC"}

package/dist/client/idle-timer.d.ts

@@ -0,0 +1,35 @@
+import type { Client } from './client.js';
+/**
+ * Disconnects the client after a period of inactivity.
+ * Only instantiated when `idlenessTimeout` is configured.
+ *
+ * Extracted from the former IdleTimeout class to isolate idle-disconnect
+ * logic from visibility-based reconnection (now in VisibilityManager).
+ */
+export declare class IdleTimer {
+    private client;
+    private timeout;
+    private timerId;
+    private resetHandler;
+    constructor(client: Client, timeout: number);
+    /** Starts the idle countdown. Fires `client.close()` when it expires. */
+    start(): void;
+    /** Clears the current idle countdown. */
+    stop(): void;
+    /**
+     * Resets the idle timer and reconnects if the socket is disconnected.
+     * Called on user activity (mousemove, keydown, etc.).
+     *
+     * Only reconnects if the socket is actually down — does NOT force
+     * reconnection when initialized=false, which would create loops.
+     */
+    /**
+     * Resets the idle timer and reconnects if the socket is disconnected.
+     * Defers restarting the idle countdown until after the connection is
+     * established to prevent the timer from firing mid-reconnect.
+     */
+    reset(): Promise<void>;
+    /** Removes all event listeners and cleans up resources. */
+    destroy(): void;
+    private setup;
+}