typeferry 0.6.0

package/dist/react/hooks/use-method-refresh.js

@@ -0,0 +1,48 @@
+import { useCallback } from 'react';
+export const useMethodRefresh = ({ authenticated, caller, client, params, method, setError, setLoading, setResult, shouldCall, startLoading, methodOptions, defaultValue, deps, }) => {
+    return useCallback((callback) => {
+        if (!method)
+            return;
+        if (!shouldCall)
+            return;
+        if (!caller)
+            return;
+        if (authenticated && !client.authenticated) {
+            setLoading(false);
+            setResult(defaultValue);
+            return;
+        }
+        startLoading();
+        let successful = false;
+        caller
+            .call(client, method, params, methodOptions)
+            .then(_result => {
+            setResult(_result);
+            setError(undefined);
+            successful = true;
+        })
+            .catch(e => {
+            console.error(e);
+            setError(e);
+            setResult(undefined);
+        })
+            .finally(() => {
+            startLoading.cancel();
+            setLoading(false);
+            if (typeof callback === 'function')
+                callback();
+        });
+    }, [
+        client,
+        method,
+        params,
+        setResult,
+        setLoading,
+        setError,
+        client?.authenticated,
+        defaultValue,
+        ...Object.values(methodOptions),
+        ...deps,
+    ]);
+};
+//# sourceMappingURL=use-method-refresh.js.map

package/dist/react/hooks/use-method-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-method-refresh.js","sourceRoot":"","sources":["../../../src/react/hooks/use-method-refresh.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,aAAa,EACb,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,IAAI,GACL,EAAE,EAAE;IACH,OAAO,WAAW,CAChB,CAAC,QAAS,EAAE,EAAE;QACZ,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,IAAI,CAAC,UAAU;YAAE,OAAM;QACvB,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,IAAI,aAAa,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC3C,UAAU,CAAC,KAAK,CAAC,CAAA;YACjB,SAAS,CAAC,YAAY,CAAC,CAAA;YACvB,OAAM;QACR,CAAC;QAED,YAAY,EAAE,CAAA;QAEd,IAAI,UAAU,GAAG,KAAK,CAAA;QAEtB,MAAM;aACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC;aAC3C,IAAI,CAAC,OAAO,CAAC,EAAE;YACd,SAAS,CAAC,OAAO,CAAC,CAAA;YAClB,QAAQ,CAAC,SAAS,CAAC,CAAA;YACnB,UAAU,GAAG,IAAI,CAAA;QACnB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,CAAC,EAAE;YACT,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAChB,QAAQ,CAAC,CAAC,CAAC,CAAA;YACX,SAAS,CAAC,SAAS,CAAC,CAAA;QACtB,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,YAAY,CAAC,MAAM,EAAE,CAAA;YACrB,UAAU,CAAC,KAAK,CAAC,CAAA;YACjB,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAAE,QAAQ,EAAE,CAAA;QAChD,CAAC,CAAC,CAAA;IACN,CAAC,EACD;QACE,MAAM;QACN,MAAM;QACN,MAAM;QACN,SAAS;QACT,UAAU;QACV,QAAQ;QACR,MAAM,EAAE,aAAa;QACrB,YAAY;QACZ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;QAC/B,GAAG,IAAI;KACR,CACF,CAAA;AACH,CAAC,CAAA"}

package/dist/react/hooks/use-method.d.ts

@@ -0,0 +1,26 @@
+import type { CallOptions } from '../../utils/index.js';
+export type UseMethodParams = {
+    method?: string;
+    params?: any;
+    event?: string;
+    channel?: string;
+    defaultValue?: any;
+    cache?: boolean;
+    maxAge?: number;
+    timeout?: number;
+    deps?: any[];
+    authenticated?: boolean;
+    debounced?: number;
+    lazy?: boolean;
+    http?: boolean;
+    parse?(params: any): any;
+    required?: string[];
+} & CallOptions;
+export declare const useMethod: (options: UseMethodParams) => {
+    result: any;
+    error: any;
+    loading: any;
+    refresh: any;
+    optimistic: any;
+    client: import("../../client/index.js").Client<import("../../utils/index.js").ServerMethods>;
+};

package/dist/react/hooks/use-method.js

@@ -0,0 +1,161 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useDebouncedCallback } from 'use-debounce';
+import { TypeFerryEvents, ClientEvents, NO_CHANNEL } from '../../utils/index.js';
+import { useCaller } from './use-caller.js';
+import { useCircuitBreaker } from './use-circuit-breaker.js';
+import { useClient } from './use-client.js';
+import { useLocalEvent, useRemoteEvent } from './use-local-event.js';
+import { useMethodRefresh } from './use-method-refresh.js';
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+const noop = () => { };
+function useOptimistic(result, setResult) {
+    return useCallback(cb => {
+        if (typeof cb !== 'function')
+            throw new Error('Function Expected');
+        const simulatedResult = cb(result);
+        setResult(simulatedResult);
+    }, [result, setResult]);
+}
+function useInitializingHandler(authenticated, setLoading) {
+    useLocalEvent({ event: ClientEvents.INITIALIZING }, () => {
+        if (authenticated)
+            setLoading(true);
+    }, [authenticated]);
+}
+function useInitializedHandler(authenticated, refreshCallback) {
+    useLocalEvent({ event: ClientEvents.INITIALIZED }, () => {
+        if (authenticated)
+            refreshCallback();
+    }, [refreshCallback, authenticated]);
+}
+function useLogoutHandler(authenticated, refreshCallback) {
+    useLocalEvent({ event: ClientEvents.LOGOUT }, () => {
+        if (authenticated)
+            refreshCallback();
+    }, [refreshCallback, authenticated]);
+}
+function useMethodRefreshEvent(channel, method, refreshCallback) {
+    useRemoteEvent({ event: TypeFerryEvents.METHOD_REFRESH, channel }, (refreshMethod) => {
+        if (refreshMethod === method)
+            refreshCallback();
+    }, [refreshCallback]);
+}
+function useAutoRefresh(method, client, lazy, refreshCallback, params, debounced) {
+    useEffect(() => {
+        if (!method || !client)
+            return;
+        if (!lazy)
+            refreshCallback();
+    }, [client, method, params, debounced]);
+}
+function useCleanup(debouncedRefresh) {
+    useEffect(() => () => {
+        debouncedRefresh.cancel();
+    }, []);
+}
+function useEventSubscriptions(authenticated, setLoading, refreshCallback, event, channel, method) {
+    useInitializingHandler(authenticated, setLoading);
+    useInitializedHandler(authenticated, refreshCallback);
+    useLogoutHandler(authenticated, refreshCallback);
+    useLocalEvent({ event, channel }, refreshCallback, [refreshCallback]);
+    useMethodRefreshEvent(channel, method, refreshCallback);
+}
+const DEFAULT_OPTIONS = {
+    method: null,
+    params: undefined,
+    event: null,
+    channel: NO_CHANNEL,
+    defaultValue: null,
+    cache: false,
+    maxAge: 60000,
+    deps: [],
+    authenticated: false,
+    debounced: null,
+    parse: null,
+    lazy: false,
+    required: [],
+};
+function normalizeOptions(options) {
+    return { ...DEFAULT_OPTIONS, ...options };
+}
+function useMethodState(lazy) {
+    const [error, setError] = useState(null);
+    const [result, setResult] = useState(null);
+    const [loading, setLoading] = useState(!lazy);
+    return { error, setError, result, setResult, loading, setLoading };
+}
+function useRefreshCallback(refresh, debouncedRefresh, debounced) {
+    return useMemo(() => (debounced ? debouncedRefresh : refresh), [debounced, debouncedRefresh, refresh]);
+}
+function useMethodCore(options) {
+    const { method, params: _params, event, channel, defaultValue: _defaultValue, cache, maxAge, deps, authenticated, debounced, parse, lazy, required, ...methodOptions } = options;
+    const client = useClient();
+    const defaultValue = useMemo(() => _defaultValue, deps);
+    const params = useMemo(() => _params, deps);
+    const { error, setError, result, setResult, loading, setLoading } = useMethodState(lazy);
+    const { shouldCall, placeholderValue } = useCircuitBreaker({
+        parse,
+        params,
+        required,
+        deps,
+    });
+    const optimistic = useOptimistic(result, setResult);
+    const startLoading = useDebouncedCallback(() => setLoading(true), 100);
+    const caller = useCaller({ cache, client, maxAge });
+    const refresh = useMethodRefresh({
+        authenticated,
+        caller,
+        client,
+        params,
+        method,
+        setError,
+        setLoading,
+        setResult,
+        shouldCall,
+        startLoading,
+        methodOptions,
+        defaultValue,
+        deps,
+    });
+    const debouncedRefresh = useDebouncedCallback(refresh, debounced ?? 100);
+    const refreshCallback = useRefreshCallback(refresh, debouncedRefresh, debounced);
+    useEventSubscriptions(authenticated, setLoading, refreshCallback, event, channel, method);
+    useAutoRefresh(method, client, lazy, refreshCallback, params, debounced);
+    useCleanup(debouncedRefresh);
+    return {
+        shouldCall,
+        placeholderValue,
+        defaultValue,
+        error,
+        loading,
+        result,
+        refreshCallback,
+        optimistic,
+        client,
+    };
+}
+export const useMethod = (options) => {
+    const normalized = normalizeOptions(options);
+    if (!normalized.method)
+        throw new Error('Method name is required.');
+    const core = useMethodCore(normalized);
+    if (!core.shouldCall) {
+        return {
+            result: core.placeholderValue ?? core.defaultValue,
+            error: core.error,
+            loading: false,
+            refresh: noop,
+            optimistic: noop,
+            client: core.client,
+        };
+    }
+    return {
+        result: core.result ?? core.defaultValue,
+        error: core.error,
+        loading: core.loading,
+        refresh: core.refreshCallback,
+        optimistic: core.optimistic,
+        client: core.client,
+    };
+};
+//# sourceMappingURL=use-method.js.map

package/dist/react/hooks/use-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-method.js","sourceRoot":"","sources":["../../../src/react/hooks/use-method.tsx"],"names":[],"mappings":"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"}

package/dist/react/hooks/use-mongodb-live-publication.d.ts

@@ -0,0 +1,13 @@
+import type { MongoLiveArgsOf, MongoLiveClientDocument, MongoLiveDocumentOf, MongoLivePublicationDescriptor, MongoLiveViewSnapshot } from '../../mongodb/live/types.js';
+/** Options accepted by `useMongoLivePublication`. */
+export interface UseMongoLivePublicationOptions<TDescriptor extends MongoLivePublicationDescriptor<string, unknown, MongoLiveClientDocument>> {
+    /** Typed named publication descriptor. */
+    readonly publication: TDescriptor;
+    /** Arguments inferred from the publication descriptor. */
+    readonly args: MongoLiveArgsOf<TDescriptor>;
+}
+/** Materializes a named MongoDB publication and rerenders for every valid delta. */
+export declare function useMongoLivePublication<TDescriptor extends MongoLivePublicationDescriptor<string, unknown, MongoLiveClientDocument>>(options: UseMongoLivePublicationOptions<TDescriptor>): MongoLiveViewSnapshot<MongoLiveDocumentOf<TDescriptor>> & {
+    /** Requests a complete authoritative replacement. */
+    readonly resync: () => Promise<void>;
+};

package/dist/react/hooks/use-mongodb-live-publication.js

@@ -0,0 +1,26 @@
+import { useEffect, useMemo, useSyncExternalStore, } from 'react';
+import { createMongoLiveView, } from '../../mongodb/live/client.js';
+import { EJSON } from '../../ejson/index.js';
+import { useClient } from './use-client.js';
+/** Materializes a named MongoDB publication and rerenders for every valid delta. */
+export function useMongoLivePublication(options) {
+    const client = useClient();
+    const argsKey = EJSON.stringify(options.args, { canonical: true });
+    const view = useMemo(() => createMongoLiveView({
+        client,
+        publication: options.publication,
+        args: options.args,
+    }), [client, options.publication, argsKey]);
+    const snapshot = useSyncExternalStore(view.subscribe, view.getSnapshot, view.getSnapshot);
+    useEffect(() => {
+        void view.start();
+        return () => {
+            void view.stop();
+        };
+    }, [view]);
+    return {
+        ...snapshot,
+        resync: () => view.resync(),
+    };
+}
+//# sourceMappingURL=use-mongodb-live-publication.js.map

package/dist/react/hooks/use-mongodb-live-publication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mongodb-live-publication.js","sourceRoot":"","sources":["../../../src/react/hooks/use-mongodb-live-publication.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,OAAO,EACP,oBAAoB,GACrB,MAAM,OAAO,CAAA;AAEd,OAAO,EACL,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAQlC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAgBxC,oFAAoF;AACpF,MAAM,UAAU,uBAAuB,CAOrC,OAAoD;IAKpD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAClE,MAAM,IAAI,GAAG,OAAO,CAClB,GAAG,EAAE,CACH,mBAAmB,CAAC;QAClB,MAAM;QACN,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC,EACJ,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CACvC,CAAA;IACD,MAAM,QAAQ,GAAG,oBAAoB,CACnC,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,WAAW,CACjB,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,IAAI,CAAC,KAAK,EAAE,CAAA;QACjB,OAAO,GAAG,EAAE;YACV,KAAK,IAAI,CAAC,IAAI,EAAE,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAEV,OAAO;QACL,GAAG,QAAQ;QACX,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;KAC5B,CAAA;AACH,CAAC"}

package/dist/react/hooks/use-object.d.ts

@@ -0,0 +1,2 @@
+export declare function useLastChangedTimestamp(obj: any): any;
+export declare function useObject(currentObject: Record<string, any>): Record<string, any>;

package/dist/react/hooks/use-object.js

@@ -0,0 +1,22 @@
+import isEqual from 'fast-deep-equal';
+import { useEffect, useRef, useState } from 'react';
+import { useCreation } from './use-creation.js';
+export function useLastChangedTimestamp(obj) {
+    const [timestamp, setTimestamp] = useState(() => Date.now());
+    const previousObj = useRef(obj);
+    const lastTimestamp = useRef(timestamp);
+    useEffect(() => {
+        if (!isEqual(previousObj.current, obj)) {
+            previousObj.current = obj;
+            const nextTimestamp = Math.max(Date.now(), lastTimestamp.current + 1);
+            lastTimestamp.current = nextTimestamp;
+            setTimestamp(nextTimestamp);
+        }
+    }, [obj]);
+    return timestamp;
+}
+export function useObject(currentObject) {
+    const timestamp = useLastChangedTimestamp(currentObject);
+    return useCreation(() => currentObject, [timestamp]);
+}
+//# sourceMappingURL=use-object.js.map

package/dist/react/hooks/use-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-object.js","sourceRoot":"","sources":["../../../src/react/hooks/use-object.tsx"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,iBAAiB,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C,MAAM,UAAU,uBAAuB,CAAC,GAAG;IACzC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAE5D,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IAC/B,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IAEvC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;YACvC,WAAW,CAAC,OAAO,GAAG,GAAG,CAAA;YACzB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;YACrE,aAAa,CAAC,OAAO,GAAG,aAAa,CAAA;YACrC,YAAY,CAAC,aAAa,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAET,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,aAAkC;IAC1D,MAAM,SAAS,GAAG,uBAAuB,CAAC,aAAa,CAAC,CAAA;IAExD,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;AACtD,CAAC"}

package/dist/react/hooks/use-subscribe.d.ts

@@ -0,0 +1,8 @@
+import type { AnyFunction } from '../../utils/index.js';
+type UseSubscribeParams = {
+    event: string;
+    channel?: string;
+    active?: boolean;
+};
+export declare function useSubscribe({ event, channel, active }: UseSubscribeParams, callback?: AnyFunction, deps?: any[]): any;
+export {};

package/dist/react/hooks/use-subscribe.js

@@ -0,0 +1,49 @@
+import { useEffect, useState } from 'react';
+import { NO_CHANNEL } from '../../utils/index.js';
+import { useClient } from './use-client.js';
+import { useCreation } from './use-creation.js';
+export function useSubscribe({ event, channel = NO_CHANNEL, active = true }, callback = null, deps = []) {
+    if (typeof event !== 'string') {
+        throw new Error('event name is required');
+    }
+    if (typeof channel !== 'string' && active) {
+        throw new Error('channel name is required');
+    }
+    const client = useClient();
+    const [ready, setReady] = useState(false);
+    const _channel = useCreation(() => client.channel(channel), [client, channel]);
+    useEffect(() => {
+        if (!callback)
+            return;
+        if (!active)
+            return;
+        const events = _channel._events?.[event];
+        const isAlreadyRegistered = events === callback ||
+            (Array.isArray(events) && events.includes(callback));
+        if (!isAlreadyRegistered) {
+            _channel.on(event, callback);
+        }
+        return () => {
+            _channel.off(event, callback);
+        };
+    }, [event, channel, callback, active].concat(deps));
+    useEffect(() => {
+        if (!active)
+            return;
+        _channel
+            .subscribe(event)
+            .then(result => setReady(result?.[event] ?? false))
+            .catch(console.error);
+        return () => {
+            // Prevent unsubscribing too early due to simple re-rendering
+            setTimeout(() => {
+                // Only unsubscribe if there are no other listeners
+                if (!_channel._events[event]?.length) {
+                    _channel.unsubscribe(event).catch(console.error);
+                }
+            }, 1000);
+        };
+    }, [event, channel, active]);
+    return ready;
+}
+//# sourceMappingURL=use-subscribe.js.map

package/dist/react/hooks/use-subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-subscribe.js","sourceRoot":"","sources":["../../../src/react/hooks/use-subscribe.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAQ5C,MAAM,UAAU,YAAY,CAC1B,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,EAAE,MAAM,GAAG,IAAI,EAAsB,EAClE,WAAwB,IAAI,EAC5B,OAAc,EAAE;IAEhB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC3C,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEzC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAE9E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ;YAAE,OAAM;QACrB,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,CAAgC,CAAA;QAEvE,MAAM,mBAAmB,GACvB,MAAM,KAAK,QAAQ;YACnB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;QAEtD,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAC9B,CAAC;QAED,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAC/B,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAEnD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,QAAQ;aACL,SAAS,CAAC,KAAK,CAAC;aAChB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;aAClD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAEvB,OAAO,GAAG,EAAE;YACV,6DAA6D;YAC7D,UAAU,CAAC,GAAG,EAAE;gBACd,mDAAmD;gBACnD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;oBACrC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBAClD,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,CAAA;QACV,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;IAE5B,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/react/hooks/use-throttled-events.d.ts

@@ -0,0 +1,7 @@
+import type EventEmitter2 from '../../utils/event-emitter.js';
+type ThrottleOptions = {
+    leading?: boolean;
+    trailing?: boolean;
+};
+export declare function useThrottledEvents(emitter: EventEmitter2, events: string[], callback: (...args: any[]) => void, deps?: any[], throttleMs?: number, throttleOptions?: ThrottleOptions): void;
+export {};

package/dist/react/hooks/use-throttled-events.js

@@ -0,0 +1,11 @@
+import { useEffect } from 'react';
+import { onAllThrottled } from '../../utils/index.js';
+import { useCreation } from './use-creation.js';
+export function useThrottledEvents(emitter, events, callback, deps = [], throttleMs = 1000, throttleOptions) {
+    const _events = useCreation(() => events, events);
+    const _callback = useCreation(() => callback, deps);
+    useEffect(() => {
+        return onAllThrottled(emitter, _events, _callback, throttleMs, throttleOptions);
+    }, [emitter, _events, _callback, throttleMs]);
+}
+//# sourceMappingURL=use-throttled-events.js.map

package/dist/react/hooks/use-throttled-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-throttled-events.js","sourceRoot":"","sources":["../../../src/react/hooks/use-throttled-events.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAO5C,MAAM,UAAU,kBAAkB,CAChC,OAAsB,EACtB,MAAgB,EAChB,QAAkC,EAClC,OAAc,EAAE,EAChB,UAAU,GAAG,IAAI,EACjB,eAAiC;IAEjC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAEnD,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,cAAc,CACnB,OAAO,EACP,OAAO,EACP,SAAS,EACT,UAAU,EACV,eAAe,CAChB,CAAA;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;AAC/C,CAAC"}

package/dist/react/hooks/use-token-refresh.d.ts

@@ -0,0 +1,13 @@
+import { type TokenRefreshConfig } from '../../auth/client/token-refresh.js';
+/**
+ * Hook to set up automatic token refresh when authenticated.
+ * Automatically cleans up when the component unmounts or auth state changes.
+ *
+ * Also registers a pre-reconnect hook on the visibility manager so that
+ * expired access tokens are refreshed via HTTP *before* the socket reconnects
+ * after a tab restore — preventing a failed-auth flash that forces the user
+ * to see the login screen momentarily.
+ *
+ * @param config - Optional configuration for refresh behavior
+ */
+export declare function useTokenRefresh(config?: Partial<TokenRefreshConfig>): void;

package/dist/react/hooks/use-token-refresh.js

@@ -0,0 +1,40 @@
+import { useEffect, useRef } from 'react';
+import { refreshAccessToken, setupTokenRefreshOnExpiry, } from '../../auth/client/token-refresh.js';
+import { isTokenExpired } from '../../client/context-manager.js';
+import { useAuth } from './use-auth.js';
+import { useClient } from './use-client.js';
+/**
+ * Hook to set up automatic token refresh when authenticated.
+ * Automatically cleans up when the component unmounts or auth state changes.
+ *
+ * Also registers a pre-reconnect hook on the visibility manager so that
+ * expired access tokens are refreshed via HTTP *before* the socket reconnects
+ * after a tab restore — preventing a failed-auth flash that forces the user
+ * to see the login screen momentarily.
+ *
+ * @param config - Optional configuration for refresh behavior
+ */
+export function useTokenRefresh(config) {
+    const client = useClient();
+    const { authenticated } = useAuth();
+    const configRef = useRef(config);
+    useEffect(() => {
+        configRef.current = config;
+    }, [config]);
+    useEffect(() => {
+        if (!authenticated) {
+            return;
+        }
+        const cleanupExpiry = setupTokenRefreshOnExpiry(client, configRef.current);
+        client.visibilityManager.onBeforeReconnect = async () => {
+            if (isTokenExpired(client.context)) {
+                await refreshAccessToken(client, configRef.current);
+            }
+        };
+        return () => {
+            cleanupExpiry();
+            client.visibilityManager.onBeforeReconnect = null;
+        };
+    }, [authenticated, client]);
+}
+//# sourceMappingURL=use-token-refresh.js.map

package/dist/react/hooks/use-token-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-token-refresh.js","sourceRoot":"","sources":["../../../src/react/hooks/use-token-refresh.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAE1B,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoC;IAClE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAAA;IAEnC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAEhC,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,OAAO,GAAG,MAAM,CAAA;IAC5B,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAM;QACR,CAAC;QAED,MAAM,aAAa,GAAG,yBAAyB,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;QAE1E,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,GAAG,KAAK,IAAI,EAAE;YACtD,IAAI,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,MAAM,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;YACrD,CAAC;QACH,CAAC,CAAA;QAED,OAAO,GAAG,EAAE;YACV,aAAa,EAAE,CAAA;YACf,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,GAAG,IAAI,CAAA;QACnD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAA;AAC7B,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,2 @@
+export * from './components/index.js';
+export * from './hooks/index.js';

package/dist/react/index.js

@@ -0,0 +1,3 @@
+export * from './components/index.js';
+export * from './hooks/index.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA"}

package/dist/server/client-node.d.ts

@@ -0,0 +1,76 @@
+import { RateLimiter } from 'limiter';
+import EventEmitter2 from '../utils/event-emitter.js';
+import type { TypeFerryRequest, TypeFerryResponse } from './request-types.js';
+import type { RateLimit, Server } from './server.js';
+import type { TypeFerrySendState, TypeFerrySocket } from './types.js';
+export type ClientNodeContext = Record<string, any>;
+export declare class ClientNode extends EventEmitter2 {
+    uuid: string;
+    isAuthenticated: boolean;
+    meta: Record<string, any>;
+    context: ClientNodeContext;
+    userId: any;
+    user: Record<string, any>;
+    socket?: TypeFerrySocket | null;
+    /** Framework-agnostic request exposed by the Hono adapter. */
+    req?: TypeFerryRequest;
+    /** Framework-agnostic response exposed by the Hono adapter. */
+    res?: TypeFerryResponse;
+    isServer: boolean;
+    limiter: RateLimiter;
+    server: Server;
+    headers: Record<string, string>;
+    remoteAddress: string | string[];
+    userAgent: string;
+    constructor(server: Server, socket?: TypeFerrySocket | null, req?: TypeFerryRequest, res?: TypeFerryResponse, limit?: RateLimit);
+    get authenticated(): boolean;
+    set authenticated(authenticated: boolean);
+    get readyState(): number | undefined;
+    setId(uuid: string): void;
+    setContext(context: ClientNodeContext): void;
+    /**
+     * Extracts tracking properties (headers, IP, user-agent) from a request.
+     * Accepts both Node `IncomingMessage` and the framework-agnostic `TypeFerryRequest`.
+     */
+    setTrackingProperties(source: {
+        headers?: Record<string, string | string[] | undefined>;
+        ip?: string;
+        socket?: {
+            remoteAddress?: string;
+        };
+    }): void;
+    setUserId(): void;
+    /**
+     * Sends a push event to the client.
+     * Uses the wire protocol `{ t: "event", ... }` envelope.
+     */
+    emitTypeFerryEvent(event: string, channel?: string, params?: unknown): void;
+    /**
+     * Sends a push event and returns the native transport pressure.
+     *
+     * Live data delivery uses this result to avoid hiding slow consumers behind
+     * the WebSocket runtime's own queue.
+     */
+    sendTypeFerryEvent(event: string, channel?: string, params?: unknown): TypeFerrySendState;
+    /** Whether the transport exposes native queued-byte pressure. */
+    get supportsBufferedBytes(): boolean;
+    /** Returns native bytes queued by the WebSocket runtime without sending. */
+    get bufferedBytes(): number;
+    /**
+     * Sends an error to the client.
+     */
+    emitError(payload: {
+        uuid?: string;
+        message: string;
+        method?: string;
+        errors?: unknown;
+    }): void;
+    /**
+     * Sends authentication result to the client.
+     * Uses the wire protocol `{ t: "auth", ... }` envelope.
+     */
+    emitAuthResult(authenticated: boolean): void;
+    /** Idempotency guard — prevents duplicate DISCONNECT events. */
+    private closed;
+    close(): void;
+}