typeferry 0.6.0

package/dist/mongodb/timestamps.d.ts

@@ -0,0 +1,17 @@
+import type { Document } from 'mongodb';
+/** Options for timestamp helpers that need deterministic clocks in tests. */
+export interface TimestampOptions {
+    /** Timestamp to apply instead of `new Date()`. */
+    readonly now?: Date;
+}
+/** Document fields added by insert timestamp helpers. */
+export interface InsertTimestamps {
+    /** Creation timestamp. */
+    readonly createdAt: Date;
+    /** Last update timestamp. */
+    readonly updatedAt: Date;
+}
+/** Adds `createdAt` and `updatedAt` to a document before insertion. */
+export declare function withInsertTimestamps<TInput extends Document>(input: TInput, options?: TimestampOptions): TInput & InsertTimestamps;
+/** Adds `updatedAt` to a native MongoDB update document without changing other operators. */
+export declare function withUpdateTimestamp<TUpdate extends Document>(update: TUpdate, options?: TimestampOptions): TUpdate;

package/dist/mongodb/timestamps.js

@@ -0,0 +1,27 @@
+/** Adds `createdAt` and `updatedAt` to a document before insertion. */
+export function withInsertTimestamps(input, options = {}) {
+    const now = options.now ?? new Date();
+    return {
+        ...input,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/** Adds `updatedAt` to a native MongoDB update document without changing other operators. */
+export function withUpdateTimestamp(update, options = {}) {
+    const now = options.now ?? new Date();
+    const setOperator = readObjectRecord(update.$set);
+    return {
+        ...update,
+        $set: {
+            ...setOperator,
+            updatedAt: now,
+        },
+    };
+}
+function readObjectRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    return value;
+}
+//# sourceMappingURL=timestamps.js.map

package/dist/mongodb/timestamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.js","sourceRoot":"","sources":["../../src/mongodb/timestamps.ts"],"names":[],"mappings":"AAgBA,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,UAA4B,EAAE;IAE9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;IACrC,OAAO;QACL,GAAG,KAAK;QACR,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAA;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CACjC,MAAe,EACf,UAA4B,EAAE;IAE9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;IACrC,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAEjD,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE;YACJ,GAAG,WAAW;YACd,SAAS,EAAE,GAAG;SACf;KACS,CAAA;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC1E,OAAO,KAAgC,CAAA;AACzC,CAAC"}

package/dist/mongodb/types.d.ts

@@ -0,0 +1,120 @@
+import type { ChangeStreamDocument, ChangeStreamOptions, ClientSession, Collection, CreateIndexesOptions, Db, Document, IndexSpecification, MongoClient, MongoClientOptions, ObjectId } from 'mongodb';
+import type { z } from 'zod';
+import type { EventOptions, Server } from '../server/index.js';
+import type { MongoLiveOptions } from './live/types.js';
+/** Runtime brand used by typed collection tokens to carry document types. */
+export declare const MONGO_COLLECTION_DOCUMENT: unique symbol;
+/** Constructor accepted by MongoDB collection decorators. */
+export type MongoCollectionClass = abstract new (...args: never[]) => unknown;
+/** Compile-time collection token that binds a decorated class to a document type. */
+export interface MongoCollectionToken<TDocument extends Document> {
+    /** Decorated class that owns runtime collection metadata. */
+    readonly Class: MongoCollectionClass;
+    /** Phantom document type carried by the token for collection inference. */
+    readonly [MONGO_COLLECTION_DOCUMENT]: TDocument;
+}
+/** Binds a decorated collection class to a compile-time document type. */
+export declare function typedMongoCollection<TDocument extends Document>(Class: MongoCollectionClass): MongoCollectionToken<TDocument>;
+/** Extracts the document type carried by a MongoDB collection token. */
+export type MongoDocumentOf<TToken> = TToken extends MongoCollectionToken<infer TDocument> ? TDocument : never;
+/** Collection class or typed token accepted by runtime metadata readers. */
+export type MongoCollectionTarget = MongoCollectionClass | MongoCollectionToken<Document>;
+/** Index metadata declared through `@MongoIndex`. */
+export interface MongoIndexDefinition {
+    /** Native MongoDB index specification passed to `createIndexes`. */
+    readonly spec: IndexSpecification;
+    /** Native MongoDB index options passed through unchanged. */
+    readonly options?: CreateIndexesOptions;
+}
+/** Channel selection returned by a MongoDB watch definition. */
+export type MongoWatchChannel = string | readonly string[] | null | undefined;
+/** Function that maps a changed document into one or more TypeFerry channels. */
+export type MongoWatchChannelResolver<TDocument extends Document> = (document: TDocument, change: ChangeStreamDocument<TDocument>) => MongoWatchChannel | Promise<MongoWatchChannel>;
+/** Watch metadata declared through `@MongoWatch`. */
+export interface MongoWatchDefinition<TDocument extends Document = Document> {
+    /** TypeFerry event name emitted for matching collection changes. */
+    readonly event: string;
+    /** TypeFerry event options used when registering the event on the server. */
+    readonly eventOptions?: EventOptions;
+    /** Optional resolver for channel-scoped event emission. */
+    readonly getChannel?: MongoWatchChannelResolver<TDocument>;
+    /** Fields that should not trigger event emission when they are the only updates. */
+    readonly excludeFields?: readonly string[];
+    /** Native change-stream pipeline passed to `collection.watch`. */
+    readonly pipeline?: readonly Document[];
+    /** Native `fullDocument` option; defaults to `updateLookup`. */
+    readonly fullDocument?: ChangeStreamOptions['fullDocument'];
+    /** Native pre-image option used to resolve delete channels when enabled. */
+    readonly fullDocumentBeforeChange?: ChangeStreamOptions['fullDocumentBeforeChange'];
+    /** Native change-stream options passed through unchanged. */
+    readonly options?: ChangeStreamOptions;
+}
+/** Complete collection metadata accumulated by decorators. */
+export interface MongoCollectionDefinition<TDocument extends Document = Document> {
+    /** Decorated class that owns this metadata. */
+    readonly Class: MongoCollectionClass;
+    /** MongoDB collection name. */
+    readonly name: string;
+    /** Optional Zod schema used by explicit parse helpers. */
+    readonly schema?: z.ZodType<TDocument>;
+    /** Indexes declared for explicit or opt-in startup creation. */
+    readonly indexes: readonly MongoIndexDefinition[];
+    /** Change-stream definitions declared for TypeFerry event bridging. */
+    readonly watches: readonly MongoWatchDefinition<TDocument>[];
+}
+/** Options accepted by `createTypeFerryMongo`. */
+export interface TypeFerryMongoOptions {
+    /** Optional TypeFerry server used for change-stream event bridging. */
+    readonly server?: Server;
+    /** MongoDB connection string used when no `client` or `db` is supplied. */
+    readonly uri?: string;
+    /** External MongoDB client to reuse. */
+    readonly client?: MongoClient;
+    /** External MongoDB database handle to reuse. */
+    readonly db?: Db;
+    /** Database name used with `uri` or `client`. */
+    readonly dbName?: string;
+    /** Native MongoDB client options used when connecting from `uri`. */
+    readonly clientOptions?: MongoClientOptions;
+    /** Decorated collection classes or typed tokens to register. */
+    readonly collections: readonly MongoCollectionTarget[];
+    /** Whether to create declared indexes during startup. */
+    readonly ensureIndexes?: boolean;
+    /** Whether `close()` should close an externally supplied client. */
+    readonly closeExternalClient?: boolean;
+    /** Optional named MongoDB live-view extension. */
+    readonly live?: MongoLiveOptions;
+}
+/** Runtime returned by `createTypeFerryMongo`. */
+export interface TypeFerryMongo {
+    /** Native database handle used by registered collections. */
+    readonly db: Db;
+    /** Native client when one is known; `null` when constructed from an external `Db`. */
+    readonly client: MongoClient | null;
+    /** Returns a native driver collection inferred from a typed collection token. */
+    collection<TToken extends MongoCollectionToken<Document>>(token: TToken): Collection<MongoDocumentOf<TToken>>;
+    /** Returns a native driver collection by name when no typed token is available. */
+    collectionByName<TDocument extends Document = Document>(name: string): Collection<TDocument>;
+    /** Returns decorator metadata for a registered collection. */
+    meta(target: MongoCollectionTarget): MongoCollectionDefinition;
+    /** Creates all declared indexes without dropping or reconciling existing indexes. */
+    ensureIndexes(): Promise<void>;
+    /** Closes change streams and the owned MongoDB client when applicable. */
+    close(): Promise<void>;
+}
+/** Payload emitted from MongoDB change streams through TypeFerry events. */
+export interface MongoWatchPayload<TDocument extends Document> {
+    /** Driver resume token string for client-side deduplication. */
+    readonly eventId: string;
+    /** Changed document identifier. */
+    readonly _id: ObjectId;
+    /** Full document after the change, or `null` for deletes. */
+    readonly doc: TDocument | null;
+    /** Whether the change represents a delete event. */
+    readonly deleted: boolean;
+}
+/** Options passed to pure helpers that forward native sessions. */
+export interface MongoSessionOptions {
+    /** Native MongoDB session to forward to driver calls. */
+    readonly session?: ClientSession;
+}

package/dist/mongodb/types.js

@@ -0,0 +1,10 @@
+/** Runtime brand used by typed collection tokens to carry document types. */
+export const MONGO_COLLECTION_DOCUMENT = Symbol('typeferry.mongodb.collection.document');
+/** Binds a decorated collection class to a compile-time document type. */
+export function typedMongoCollection(Class) {
+    return {
+        Class,
+        [MONGO_COLLECTION_DOCUMENT]: undefined,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/mongodb/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mongodb/types.ts"],"names":[],"mappings":"AAkBA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAkB,MAAM,CAC5D,uCAAuC,CACxC,CAAA;AAeD,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CAClC,KAA2B;IAE3B,OAAO;QACL,KAAK;QACL,CAAC,yBAAyB,CAAC,EAAE,SAAiC;KAC/D,CAAA;AACH,CAAC"}

package/dist/react/components/client-provider.d.ts

@@ -0,0 +1,8 @@
+import type { PropsWithChildren } from 'react';
+import type { ClientOptions } from '../../client/index.js';
+import { Client } from '../../client/index.js';
+export declare const ClientContext: any;
+export declare const ClientProvider: ({ clientInstance, clientOptions, children, }: PropsWithChildren<{
+    clientOptions?: ClientOptions;
+    clientInstance?: Client;
+}>) => any;

package/dist/react/components/client-provider.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { useEffect } from 'react';
+import { Client } from '../../client/index.js';
+import { useCreation } from '../hooks/use-creation.js';
+export const ClientContext = React.createContext(undefined);
+ClientContext.displayName = 'TypeFerryClientContext';
+export const ClientProvider = ({ clientInstance = null, clientOptions, children, }) => {
+    const client = useCreation(() => {
+        return clientInstance ?? new Client(clientOptions);
+    }, []);
+    /**
+     * Close the client on unmount to prevent ghost WebSocket connections
+     * during HMR. Without this, each hot reload of App or ClientProvider
+     * orphans the old Client's socket, leaking server-side connections.
+     */
+    useEffect(() => {
+        return () => {
+            client?.close();
+        };
+    }, [client]);
+    return (_jsx(ClientContext.Provider, { value: client, children: client ? children : null }));
+};
+//# sourceMappingURL=client-provider.js.map

package/dist/react/components/client-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-provider.js","sourceRoot":"","sources":["../../../src/react/components/client-provider.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGxC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAA;AAE3D,aAAa,CAAC,WAAW,GAAG,wBAAwB,CAAA;AAEpD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAC7B,cAAc,GAAG,IAAI,EACrB,aAAa,EACb,QAAQ,GAIR,EAAE,EAAE;IACJ,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,OAAO,cAAc,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,CAAA;IACpD,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,KAAK,EAAE,CAAA;QACjB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,OAAO,CACL,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAClC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GACF,CAC1B,CAAA;AACH,CAAC,CAAA"}

package/dist/react/components/index.d.ts

@@ -0,0 +1 @@
+export * from './client-provider.js';

package/dist/react/components/index.js

@@ -0,0 +1,2 @@
+export * from './client-provider.js';
+//# sourceMappingURL=index.js.map

package/dist/react/components/index.js.map

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

package/dist/react/hooks/index.d.ts

@@ -0,0 +1,13 @@
+export * from './use-auth.js';
+export * from './use-channel.js';
+export * from './use-client.js';
+export * from './use-connection-state.js';
+export * from './use-creation.js';
+export * from './use-deps-change.js';
+export * from './use-local-event.js';
+export * from './use-method.js';
+export * from './use-mongodb-live-publication.js';
+export * from './use-object.js';
+export * from './use-subscribe.js';
+export * from './use-throttled-events.js';
+export * from './use-token-refresh.js';

package/dist/react/hooks/index.js

@@ -0,0 +1,14 @@
+export * from './use-auth.js';
+export * from './use-channel.js';
+export * from './use-client.js';
+export * from './use-connection-state.js';
+export * from './use-creation.js';
+export * from './use-deps-change.js';
+export * from './use-local-event.js';
+export * from './use-method.js';
+export * from './use-mongodb-live-publication.js';
+export * from './use-object.js';
+export * from './use-subscribe.js';
+export * from './use-throttled-events.js';
+export * from './use-token-refresh.js';
+//# sourceMappingURL=index.js.map

package/dist/react/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA"}

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

@@ -0,0 +1,4 @@
+/**
+ * Returns React state synchronized with the active TypeFerry authentication state.
+ */
+export declare function useAuth(): Record<string, any>;

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

@@ -0,0 +1,35 @@
+import { useCallback, useEffect, useState } from 'react';
+import { ClientEvents } from '../../utils/index.js';
+import { useClient } from './use-client.js';
+import { useObject } from './use-object.js';
+import { useThrottledEvents } from './use-throttled-events.js';
+/**
+ * Returns React state synchronized with the active TypeFerry authentication state.
+ */
+export function useAuth() {
+    const client = useClient();
+    const [authenticated, setAuthenticated] = useState(() => client.authenticated);
+    const [context, setContext] = useState(() => client.context);
+    const updateState = useCallback(() => {
+        setAuthenticated(client.authenticated);
+        setContext(client.context);
+    }, [client]);
+    useThrottledEvents(client, [
+        ClientEvents.INITIALIZED,
+        ClientEvents.LOGOUT,
+        ClientEvents.CONTEXT_CHANGED,
+    ], updateState, [updateState], 16);
+    /**
+     * Reconcile after the passive subscription is installed so an auth event
+     * delivered between render and effect cannot be lost.
+     */
+    useEffect(() => {
+        updateState();
+    }, [updateState]);
+    return useObject({
+        client,
+        authenticated,
+        context,
+    });
+}
+//# sourceMappingURL=use-auth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-auth.js","sourceRoot":"","sources":["../../../src/react/hooks/use-auth.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;GAEG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;IAC9E,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAE5D,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,gBAAgB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;QACtC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,kBAAkB,CAChB,MAAM,EACN;QACE,YAAY,CAAC,WAAW;QACxB,YAAY,CAAC,MAAM;QACnB,YAAY,CAAC,eAAe;KAC7B,EACD,WAAW,EACX,CAAC,WAAW,CAAC,EACb,EAAE,CACH,CAAA;IAED;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,EAAE,CAAA;IACf,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;IAEjB,OAAO,SAAS,CAAC;QACf,MAAM;QACN,aAAa;QACb,OAAO;KACR,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export declare const useCaller: ({ client, cache, maxAge }: {
+    client: any;
+    cache: any;
+    maxAge: any;
+}) => any;

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

@@ -0,0 +1,13 @@
+import memoizee from 'memoizee';
+import { useCallback } from 'react';
+import { EJSON } from '../../ejson/index.js';
+export const useCaller = ({ client, cache, maxAge }) => {
+    return useCallback(cache
+        ? memoizee(client?.call, {
+            maxAge,
+            promise: true,
+            normalizer: p => EJSON.stringify(p),
+        })
+        : client?.call, [cache, client]);
+};
+//# sourceMappingURL=use-caller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-caller.js","sourceRoot":"","sources":["../../../src/react/hooks/use-caller.tsx"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;IACrD,OAAO,WAAW,CAChB,KAAK;QACH,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE;YACrB,MAAM;YACN,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;SACpC,CAAC;QACJ,CAAC,CAAC,MAAM,EAAE,IAAI,EAChB,CAAC,KAAK,EAAE,MAAM,CAAC,CAChB,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1 @@
+export declare function useChannel(channel?: string): import("../../client/index.js").ClientChannel;

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

@@ -0,0 +1,7 @@
+import { NO_CHANNEL } from '../../utils/index.js';
+import { useClient } from './use-client.js';
+export function useChannel(channel = NO_CHANNEL) {
+    const client = useClient();
+    return client.channel(channel);
+}
+//# sourceMappingURL=use-channel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-channel.js","sourceRoot":"","sources":["../../../src/react/hooks/use-channel.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,MAAM,UAAU,UAAU,CAAC,UAAkB,UAAU;IACrD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAE1B,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC"}

package/dist/react/hooks/use-circuit-breaker.d.ts

@@ -0,0 +1,6 @@
+export declare function useCircuitBreaker({ parse, params, required, deps }: {
+    parse: any;
+    params: any;
+    required: any;
+    deps: any;
+}): any;

package/dist/react/hooks/use-circuit-breaker.js

@@ -0,0 +1,16 @@
+import { useMemo } from 'react';
+import { isEmpty } from '../../utils/lodash.js';
+export function useCircuitBreaker({ parse, params, required, deps }) {
+    return useMemo(() => {
+        const result = typeof parse === 'function' ? parse(params) : void 0;
+        const hasAllRequiredParams = isEmpty(required) || required.every(key => params?.[key] != null);
+        if (result !== void 0 || !hasAllRequiredParams) {
+            return {
+                shouldCall: false,
+                placeholderValue: result,
+            };
+        }
+        return { shouldCall: true };
+    }, [params, parse, required, ...deps]);
+}
+//# sourceMappingURL=use-circuit-breaker.js.map

package/dist/react/hooks/use-circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-circuit-breaker.js","sourceRoot":"","sources":["../../../src/react/hooks/use-circuit-breaker.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,MAAM,UAAU,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjE,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAEnE,MAAM,oBAAoB,GACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAA;QAEnE,IAAI,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/C,OAAO;gBACL,UAAU,EAAE,KAAK;gBACjB,gBAAgB,EAAE,MAAM;aACzB,CAAA;QACH,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;IAC7B,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;AACxC,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { Client } from '../../client/index.js';
+import type { ServerMethods } from '../../utils/index.js';
+export declare function useClient<T extends ServerMethods = ServerMethods>(): Client<T>;

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

@@ -0,0 +1,13 @@
+import { useContext } from 'react';
+import { Environment } from '../../utils/index.js';
+import { ClientContext } from '../components/index.js';
+export function useClient() {
+    const client = useContext(ClientContext);
+    if (Environment.isServer)
+        return null;
+    if (!client) {
+        throw new Error('Client Not Found');
+    }
+    return client;
+}
+//# sourceMappingURL=use-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-client.js","sourceRoot":"","sources":["../../../src/react/hooks/use-client.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAIlC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,UAAU,SAAS;IAGvB,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IAExC,IAAI,WAAW,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAErC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;IACrC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/react/hooks/use-connection-state.d.ts

@@ -0,0 +1,13 @@
+/**
+ * React hook for tracking TypeFerry client connection state.
+ *
+ * Uses event-driven updates via `useThrottledEvents` rather than polling.
+ * This prevents performance violations when tabs wake from sleep, where
+ * accumulated setInterval callbacks would fire all at once.
+ */
+export declare function useConnectionState(): {
+    isOffline: any;
+    isOnline: any;
+    isConnecting: any;
+    isReconnecting: any;
+};

package/dist/react/hooks/use-connection-state.js

@@ -0,0 +1,55 @@
+import { useCallback, useEffect, useState } from 'react';
+import { ClientEvents } from '../../utils/index.js';
+import { useClient } from './use-client.js';
+import { useThrottledEvents } from './use-throttled-events.js';
+/**
+ * React hook for tracking TypeFerry client connection state.
+ *
+ * Uses event-driven updates via `useThrottledEvents` rather than polling.
+ * This prevents performance violations when tabs wake from sleep, where
+ * accumulated setInterval callbacks would fire all at once.
+ */
+export function useConnectionState() {
+    const client = useClient();
+    const [isOffline, setOffline] = useState(true);
+    const [isOnline, setOnline] = useState(false);
+    const [isConnecting, setConnecting] = useState(false);
+    const [isReconnecting, setReconnecting] = useState(false);
+    const updateConnectionState = useCallback(() => {
+        setOffline(client.isOffline);
+        setOnline(client.isOnline);
+        setConnecting(client.isConnecting);
+    }, [client]);
+    // Update state on connection events (throttled to 16ms for performance)
+    useThrottledEvents(client, [
+        ClientEvents.INITIALIZED,
+        ClientEvents.WEBSOCKET_CLOSED,
+        ClientEvents.CONNECTING,
+    ], updateConnectionState, [updateConnectionState], 16);
+    // Track reconnecting state separately (emitted by VisibilityManager on visibility change)
+    useEffect(() => {
+        if (!client)
+            return;
+        const onReconnecting = () => setReconnecting(true);
+        const onConnected = () => setReconnecting(false);
+        client.on(ClientEvents.WEBSOCKET_RECONNECTING, onReconnecting);
+        client.on(ClientEvents.INITIALIZED, onConnected);
+        return () => {
+            client.off(ClientEvents.WEBSOCKET_RECONNECTING, onReconnecting);
+            client.off(ClientEvents.INITIALIZED, onConnected);
+        };
+    }, [client]);
+    // Initialize state on mount
+    useEffect(() => {
+        if (!client)
+            return;
+        updateConnectionState();
+    }, [client, updateConnectionState]);
+    return {
+        isOffline,
+        isOnline,
+        isConnecting,
+        isReconnecting,
+    };
+}
+//# sourceMappingURL=use-connection-state.js.map

package/dist/react/hooks/use-connection-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connection-state.js","sourceRoot":"","sources":["../../../src/react/hooks/use-connection-state.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAE1B,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEzD,MAAM,qBAAqB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7C,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC5B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC1B,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IACpC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,wEAAwE;IACxE,kBAAkB,CAChB,MAAM,EACN;QACE,YAAY,CAAC,WAAW;QACxB,YAAY,CAAC,gBAAgB;QAC7B,YAAY,CAAC,UAAU;KACxB,EACD,qBAAqB,EACrB,CAAC,qBAAqB,CAAC,EACvB,EAAE,CACH,CAAA;IAED,0FAA0F;IAC1F,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;QAEhD,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAA;QAC9D,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;QAEhD,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAA;YAC/D,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;QACnD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,4BAA4B;IAC5B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,qBAAqB,EAAE,CAAA;IACzB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAA;IAEnC,OAAO;QACL,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,cAAc;KACf,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Avoids CommonJS interop in published browser bundles while preserving the
+ * stable instance semantics TypeFerry's providers and event hooks depend on.
+ */
+export declare function useCreation<T>(factory: () => T, deps: readonly unknown[]): T;

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

@@ -0,0 +1,17 @@
+import { useRef } from 'react';
+/**
+ * Avoids CommonJS interop in published browser bundles while preserving the
+ * stable instance semantics TypeFerry's providers and event hooks depend on.
+ */
+export function useCreation(factory, deps) {
+    const cache = useRef(null);
+    if (!cache.current || !areDepsEqual(cache.current.deps, deps)) {
+        cache.current = { deps: [...deps], value: factory() };
+    }
+    return cache.current.value;
+}
+function areDepsEqual(previousDeps, nextDeps) {
+    return (previousDeps.length === nextDeps.length &&
+        previousDeps.every((dep, index) => Object.is(dep, nextDeps[index])));
+}
+//# sourceMappingURL=use-creation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-creation.js","sourceRoot":"","sources":["../../../src/react/hooks/use-creation.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAO9B;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAI,OAAgB,EAAE,IAAwB;IACvE,MAAM,KAAK,GAAG,MAAM,CAA0B,IAAI,CAAC,CAAA;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAA;IACvD,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAA;AAC5B,CAAC;AAED,SAAS,YAAY,CACnB,YAAgC,EAChC,QAA4B;IAE5B,OAAO,CACL,YAAY,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QACvC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CACpE,CAAA;AACH,CAAC"}

package/dist/react/hooks/use-deps-change.d.ts

@@ -0,0 +1 @@
+export declare function useDepsChange(deps: any, data?: {}): void;

package/dist/react/hooks/use-deps-change.js

@@ -0,0 +1,11 @@
+import { useRef } from 'react';
+export function useDepsChange(deps, data = {}) {
+    const prevDeps = useRef([]);
+    deps.forEach((value, index) => {
+        if (prevDeps.current[index] !== value) {
+            console.debug('Dep Changed', index, { prev: prevDeps.current[index] }, { next: value }, data);
+        }
+    });
+    prevDeps.current = [...deps];
+}
+//# sourceMappingURL=use-deps-change.js.map

package/dist/react/hooks/use-deps-change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-deps-change.js","sourceRoot":"","sources":["../../../src/react/hooks/use-deps-change.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAE9B,MAAM,UAAU,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;IAE3B,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC5B,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CACX,aAAa,EACb,KAAK,EACL,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EACjC,EAAE,IAAI,EAAE,KAAK,EAAE,EACf,IAAI,CACL,CAAA;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;AAC9B,CAAC"}

package/dist/react/hooks/use-local-event.d.ts

@@ -0,0 +1,13 @@
+/** Parameters for local event subscription — string shorthand or object config. */
+export type UseEventParams = {
+    event: string;
+    channel?: string;
+    active?: boolean;
+} | string;
+/**
+ * Subscribe to a local EventEmitter2 event with automatic cleanup.
+ * Supports both string shorthand (`"eventName"`) and object config.
+ * The `active` flag (default `true`) controls whether the subscription is live.
+ */
+export declare function useLocalEvent(params: UseEventParams, fn: (...args: unknown[]) => void, deps?: unknown[]): void;
+export declare function useRemoteEvent({ event, channel, active, }: Exclude<UseEventParams, string>, fn: (...args: unknown[]) => void, deps?: unknown[]): boolean;

package/dist/react/hooks/use-local-event.js

@@ -0,0 +1,32 @@
+import { useCallback, useEffect } from 'react';
+import { NO_CHANNEL } from '../../utils/index.js';
+import { useClient } from './use-client.js';
+import { useCreation } from './use-creation.js';
+import { useSubscribe } from './use-subscribe.js';
+/**
+ * Subscribe to a local EventEmitter2 event with automatic cleanup.
+ * Supports both string shorthand (`"eventName"`) and object config.
+ * The `active` flag (default `true`) controls whether the subscription is live.
+ */
+export function useLocalEvent(params, fn, deps = []) {
+    const { event, channel = NO_CHANNEL, active = true, } = typeof params === 'string' ? { event: params } : params;
+    const callback = useCallback(fn, deps);
+    const client = useClient();
+    const ch = useCreation(() => (typeof channel === 'string' ? client.channel(channel) : client), [channel]);
+    useEffect(() => {
+        if (!active)
+            return;
+        ch.on(event, callback);
+        return () => {
+            ch.off(event, callback);
+        };
+    }, [event, active, callback, ch]);
+}
+export function useRemoteEvent({ event, channel = NO_CHANNEL, active = true, }, fn, deps = []) {
+    return useSubscribe({
+        event,
+        channel,
+        active,
+    }, fn, deps);
+}
+//# sourceMappingURL=use-local-event.js.map

package/dist/react/hooks/use-local-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-local-event.js","sourceRoot":"","sources":["../../../src/react/hooks/use-local-event.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAO9C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAsB,EACtB,EAAgC,EAChC,OAAkB,EAAE;IAEpB,MAAM,EACJ,KAAK,EACL,OAAO,GAAG,UAAU,EACpB,MAAM,GAAG,IAAI,GACd,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;IAE3D,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAE1B,MAAM,EAAE,GAAG,WAAW,CACpB,GAAG,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EACtE,CAAC,OAAO,CAAC,CACV,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAEtB,OAAO,GAAG,EAAE;YACV,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACzB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,EACE,KAAK,EACL,OAAO,GAAG,UAAU,EACpB,MAAM,GAAG,IAAI,GACmB,EAClC,EAAgC,EAChC,OAAkB,EAAE;IAEpB,OAAO,YAAY,CACjB;QACE,KAAK;QACL,OAAO;QACP,MAAM;KACP,EACD,EAAE,EACF,IAAI,CACL,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+export declare const useMethodRefresh: ({ authenticated, caller, client, params, method, setError, setLoading, setResult, shouldCall, startLoading, methodOptions, defaultValue, deps, }: {
+    authenticated: any;
+    caller: any;
+    client: any;
+    params: any;
+    method: any;
+    setError: any;
+    setLoading: any;
+    setResult: any;
+    shouldCall: any;
+    startLoading: any;
+    methodOptions: any;
+    defaultValue: any;
+    deps: any;
+}) => any;