@pluv/react 0.0.0-canary-20261027022227

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Shoubhit Dash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+## `@pluv/react`
+
+> [React.js](https://reactjs.org/) bindings for [@pluv/client](https://www.npmjs.com/package/@pluv/client).
+
+**👉 See full documentation on [docs.pluv.io](https://docs.pluv.io/docs). 👈**
+
+## Installation
+
+```bash
+# npm
+npm install @pluv/client @pluv/react @pluv/crdt-yjs yjs zod
+
+# yarn
+yarn add @pluv/client @pluv/react @pluv/crdt-yjs yjs zod
+
+# pnpm
+pnpm add @pluv/client @pluv/react @pluv/crdt-yjs yjs zod
+```

package/dist/index.d.mts

@@ -0,0 +1,77 @@
+import { ClientDefs, InferClientMetadata, InferClientOutput, InferClientPresence, InferSchemaInput, MockedRoomEvents, PluvClient, PluvRoomAddon, PluvRoomDebug, UserInfo, WebSocketConnection } from "@pluv/client";
+import { Dispatch, FC, ReactNode } from "react";
+import { BroadcastProxy, CrdtDocLike, IOEventMessage, Id, MaybePromise, ParticipantKindOptions, ParticipantKindsOptions, PresenceProcedureProxy, PublicEventKey, RoomError, RoomLike, RoomStats, StorageProcedureProxy, UpdateMyPresenceAction } from "@pluv/types";
+import { InferDoc, InferJson, InferSeed, InferStorage } from "@pluv/crdt";
+interface PluvProviderProps {
+  children?: ReactNode;
+}
+/**
+ * Storage is all-or-nothing, so a union (not two nullable slots) lets one check narrow both.
+ */
+type UseStorageResult<TData extends unknown, TSharedType extends unknown> = [data: null, sharedType: null] | [data: TData, sharedType: TSharedType];
+type BaseRoomProviderProps<TDefs extends ClientDefs> = {
+  children?: ReactNode;
+  initialStorage?: keyof InferSeed<TDefs["storage"]> extends never ? never : InferSeed<TDefs["storage"]>;
+  room: string;
+} & (keyof InferClientPresence<TDefs> extends never ? {
+  initialPresence?: never;
+} : {
+  initialPresence: InferSchemaInput<TDefs["presence"]>;
+});
+type MockedRoomProviderProps<TDefs extends ClientDefs = ClientDefs> = BaseRoomProviderProps<TDefs> & {
+  events?: MockedRoomEvents<TDefs>;
+};
+/**
+ * React event helper (`event.foo.useEvent`). Distinct from `@pluv/types`
+ * `EventProxy`, which is `room.subscribe.event`.
+ */
+type EventProxy<TDefs extends ClientDefs = ClientDefs> = { [event in PublicEventKey<InferClientOutput<TDefs>>]: {
+  useEvent: (callback: (data: Id<IOEventMessage<TDefs["io"], event>>) => void) => void;
+}; };
+type MetadataGetter<TMetadata extends Record<string, any>> = TMetadata | (() => MaybePromise<TMetadata>);
+type PluvRoomProviderProps<TDefs extends ClientDefs = ClientDefs> = BaseRoomProviderProps<TDefs> & {
+  connect?: boolean;
+  debug?: boolean | PluvRoomDebug<TDefs["io"]>;
+  onAuthorizationFail?: (error: Error) => void;
+} & (keyof InferClientMetadata<TDefs> extends never ? {
+  metadata?: undefined;
+} : {
+  metadata: MetadataGetter<InferSchemaInput<TDefs["metadata"]>>;
+});
+interface SubscriptionHookOptions<T extends unknown> {
+  isEqual?: (a: T, b: T) => boolean;
+}
+interface CreateBundle<TDefs extends ClientDefs = ClientDefs, TSuspense extends boolean = false> {
+  MockedRoomProvider: FC<MockedRoomProviderProps<TDefs>>;
+  PluvProvider: FC<PluvProviderProps>;
+  PluvRoomProvider: FC<PluvRoomProviderProps<TDefs>>;
+  event: EventProxy<TDefs>;
+  useBroadcast: () => BroadcastProxy<TDefs["io"]>;
+  useCanRedo: () => boolean;
+  useCanUndo: () => boolean;
+  useClient: () => PluvClient<TDefs>;
+  useConnection: <TValue extends unknown = WebSocketConnection>(selector?: (connection: WebSocketConnection) => TValue, options?: SubscriptionHookOptions<Id<TValue>>) => Id<TValue>;
+  useDoc: () => CrdtDocLike<InferDoc<TDefs["storage"]>, InferStorage<TDefs["storage"]>, InferJson<TDefs["storage"]>>;
+  useEvent: <TType extends PublicEventKey<InferClientOutput<TDefs>>>(type: TType, callback: Parameters<EventProxy<TDefs>[TType]["useEvent"]>[0]) => void;
+  useMyPresence: <TValue extends unknown = InferClientPresence<TDefs>>(selector?: (myPresence: InferClientPresence<TDefs>) => TValue, options?: SubscriptionHookOptions<Id<TValue> | null>) => [myPresence: Id<TValue>, updateMyPresence: Dispatch<UpdateMyPresenceAction<InferClientPresence<TDefs>>>];
+  useMyself: <TValue extends unknown = UserInfo<TDefs["io"], InferClientPresence<TDefs>>>(selector?: (myself: Id<UserInfo<TDefs["io"], InferClientPresence<TDefs>>>) => TValue, options?: SubscriptionHookOptions<Id<TValue> | null>) => Id<TValue> | null;
+  useOther: <TValue extends unknown = UserInfo<TDefs["io"], InferClientPresence<TDefs>>>(userId: string, selector?: (other: UserInfo<TDefs["io"], InferClientPresence<TDefs>>) => TValue, options?: SubscriptionHookOptions<TValue | null> & ParticipantKindOptions) => TValue | null;
+  useOthers: <TValue extends unknown = readonly UserInfo<TDefs["io"], InferClientPresence<TDefs>>[]>(selector?: (other: readonly Id<UserInfo<TDefs["io"], InferClientPresence<TDefs>>>[]) => TValue, options?: SubscriptionHookOptions<TValue> & ParticipantKindsOptions) => TValue;
+  usePresence: () => PresenceProcedureProxy<TDefs["treaty"]["_defs"]["procedures"]["presence"]>;
+  useRedo: () => () => void;
+  useRoom: () => RoomLike<TDefs["io"], InferDoc<TDefs["storage"]>, InferClientPresence<TDefs>, InferStorage<TDefs["storage"]>, InferJson<TDefs["storage"]>, TDefs["treaty"]>;
+  useRoomError: (callback: (error: RoomError) => void) => void;
+  useRoomStats: <TValue extends unknown = RoomStats>(selector?: (stats: RoomStats) => TValue, options?: SubscriptionHookOptions<TValue> & ParticipantKindsOptions) => TValue;
+  useStorage: () => StorageProcedureProxy<TDefs["treaty"]["_defs"]["procedures"]["storage"]>;
+  useStorageField: <TKey extends keyof InferJson<TDefs["storage"]>, TData extends unknown = InferJson<TDefs["storage"]>[TKey]>(key: TKey, selector?: (data: InferJson<TDefs["storage"]>[TKey]) => TData, options?: SubscriptionHookOptions<TData | null>) => TSuspense extends true ? [data: TData, sharedType: InferStorage<TDefs["storage"]>[TKey]] : UseStorageResult<TData, InferStorage<TDefs["storage"]>[TKey]>;
+  useTransact: () => (fn: (storage: InferStorage<TDefs["storage"]>) => void, origin?: string) => void;
+  useUndo: () => () => void;
+}
+type InferBundleRoom<TBundle extends CreateBundle<any, any>> = TBundle extends CreateBundle<infer TDefs, any> ? RoomLike<TDefs["io"], InferDoc<TDefs["storage"]>, InferClientPresence<TDefs>, InferStorage<TDefs["storage"]>, InferJson<TDefs["storage"]>, TDefs["treaty"]> : never;
+type CreateBundleOptions<TSuspense extends boolean = false> = {
+  addons?: readonly PluvRoomAddon<any>[];
+  suspense?: TSuspense;
+};
+export declare const createBundle: <TDefs extends ClientDefs, const TSuspense extends boolean = false>(client: PluvClient<TDefs>, options?: CreateBundleOptions<TSuspense>) => CreateBundle<TDefs, TSuspense>;
+export type { CreateBundle, EventProxy, InferBundleRoom, PluvProviderProps, PluvRoomProviderProps, SubscriptionHookOptions, UseStorageResult };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/createBundle.tsx"],"mappings":";;;;UA+BiB;EACb,WAAW;;;;;KAMH,iBAAiB,uBAAuB,gCAC7C,YAAY,qBACZ,MAAM,OAAO,YAAY;KAE3B,sBAAsB,cAAc;EACrC,WAAW;EACX,uBAAuB,UAAU,0CAE3B,UAAU;EAChB;WACO,oBAAoB;EACvB;;EACA,iBAAiB,iBAAiB;;KAE9B,wBAAwB,cAAc,aAAa,cAC3D,sBAAsB;EAClB,SAAS,iBAAiB;;;;;;KAOtB,WAAW,cAAc,aAAa,iBAC7C,SAAS,eAAe,kBAAkB;EACvC,WAAW,WAAW,MAAM,GAAG,eAAe,aAAa;;KAIvD,eAAe,kBAAkB,uBACvC,mBACO,aAAa;KAEd,sBAAsB,cAAc,aAAa,cACzD,sBAAsB;EAClB;EACA,kBAAkB,cAAc;EAChC,uBAAuB,OAAO;WACvB,oBAAoB;EACnB;;EACA,UAAU,eAAe,iBAAiB;;UAEzC,wBAAwB;EACrC,WAAW,GAAG,GAAG,GAAG;;UAGP,aACb,cAAc,aAAa,YAC3B;EAGA,oBAAoB,GAAG,wBAAwB;EAC/C,cAAc,GAAG;EACjB,kBAAkB,GAAG,sBAAsB;EAG3C,OAAO,WAAW;EAGlB,oBAAoB,eAAe;EACnC;EACA;EACA,iBAAiB,WAAW;EAC5B,gBAAgB,yBAAyB,qBACrC,YAAY,YAAY,wBAAwB,QAChD,UAAU,wBAAwB,GAAG,aACpC,GAAG;EACR,cAAc,YACV,SAAS,mBACT,aAAa,mBACb,UAAU;EAEd,WAAW,cAAc,eAAe,kBAAkB,SACtD,MAAM,OACN,UAAU,WAAW,WAAW,OAAO;EAE3C,gBAAgB,yBAAyB,oBAAoB,QACzD,YAAY,YAAY,oBAAoB,WAAW,QACvD,UAAU,wBAAwB,GAAG,qBAErC,YAAY,GAAG,SACf,kBAAkB,SAAS,uBAAuB,oBAAoB;EAE1E,YAAY,yBAAyB,SAAS,aAAa,oBAAoB,SAC3E,YAAY,QAAQ,GAAG,SAAS,aAAa,oBAAoB,aAAa,QAC9E,UAAU,wBAAwB,GAAG,oBACpC,GAAG;EACR,WAAW,yBAAyB,SAAS,aAAa,oBAAoB,SAC1E,gBACA,YAAY,OAAO,SAAS,aAAa,oBAAoB,YAAY,QACzE,UAAU,wBAAwB,iBAAiB,2BAClD;EACL,YACI,kCAAkC,SAAS,aAAa,oBAAoB,WAE5E,YACI,gBAAgB,GAAG,SAAS,aAAa,oBAAoB,eAC5D,QACL,UAAU,wBAAwB,UAAU,4BAC3C;EACL,mBAAmB,uBAAuB;EAC1C;EACA,eAAe,SACX,aACA,SAAS,mBACT,oBAAoB,QACpB,aAAa,mBACb,UAAU,mBACV;EAEJ,eAAe,WAAW,OAAO;EACjC,eAAe,yBAAyB,WACpC,YAAY,OAAO,cAAc,QACjC,UAAU,wBAAwB,UAAU,4BAC3C;EACL,kBAAkB,sBAAsB;EACxC,kBACI,mBAAmB,UAAU,mBAC7B,wBAAwB,UAAU,kBAAkB,OAEpD,KAAK,MACL,YAAY,MAAM,UAAU,kBAAkB,UAAU,OACxD,UAAU,wBAAwB,kBACjC,0BACE,MAAM,OAAO,YAAY,aAAa,kBAAkB,SACzD,iBAAiB,OAAO,aAAa,kBAAkB;EAC7D,oBACI,KAAK,SAAS,aAAa,4BAC3B;EAEJ;;KAGQ,gBAAgB,gBAAgB,0BACxC,gBAAgB,mBAAmB,cAC7B,SACI,aACA,SAAS,mBACT,oBAAoB,QACpB,aAAa,mBACb,UAAU,mBACV;KCtHF,oBAAoB;EAC5B,kBAAkB;EAClB,WAAW;;qBAGF,eAAgB,cAAc,kBAAkB,mCAAiC,QAClF,WAAW,QAAM,UAChB,oBAAoB,eAC9B,aAAa,OAAO"}

package/dist/index.mjs

@@ -0,0 +1,528 @@
+import { MockedRoom, parsePluvSchema } from "@pluv/client";
+import fastDeepEqual from "fast-deep-equal";
+import { createContext, memo, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { ConnectionState } from "@pluv/types";
+import { jsx } from "react/jsx-runtime";
+// src/internal/hooks/useAsyncQueue.ts
+/**
+* @description This is to handle race conditions, so that our async operations that can
+* happen between re-renders will happen sequentially.
+* @date April 13, 2025
+*/
+const useAsyncQueue = () => {
+	const queueRef = useRef(Promise.resolve(void 0));
+	const push = useCallback(async (promise) => {
+		queueRef.current = queueRef.current.then(async () => await promise);
+		return await queueRef.current;
+	}, []);
+	return useMemo(() => ({ push }), [push]);
+};
+// src/internal/hooks/useDeepAsyncMemo.ts
+const useDeepAsyncMemo = (factory, isEqual = fastDeepEqual) => {
+	const [state, setState] = useState({
+		isInitialized: false,
+		isLoading: true,
+		value: void 0,
+		error: null
+	});
+	const lastValueRef = useRef(void 0);
+	const hasValueRef = useRef(false);
+	const inflightRef = useRef(null);
+	const isMountedRef = useRef(true);
+	useEffect(() => {
+		isMountedRef.current = true;
+		const promise = factory();
+		inflightRef.current = promise;
+		setState((prev) => {
+			return {
+				...prev,
+				isLoading: true,
+				error: null
+			};
+		});
+		promise.then((result) => {
+			if (!isMountedRef.current || inflightRef.current !== promise) return;
+			if (hasValueRef.current && isEqual(lastValueRef.current, result)) {
+				setState((prev) => {
+					return {
+						...prev,
+						isInitialized: true,
+						isLoading: false
+					};
+				});
+				return;
+			}
+			lastValueRef.current = result;
+			hasValueRef.current = true;
+			setState({
+				isInitialized: true,
+				isLoading: false,
+				value: result,
+				error: null
+			});
+		}).catch((err) => {
+			if (!isMountedRef.current || inflightRef.current !== promise) return;
+			setState({
+				isInitialized: hasValueRef.current,
+				isLoading: false,
+				value: void 0,
+				error: err instanceof Error ? err : /* @__PURE__ */ new Error("Unknown error")
+			});
+		});
+		return () => {
+			isMountedRef.current = false;
+		};
+	}, [isEqual]);
+	return state;
+};
+// src/internal/hooks/useNoSsr.ts
+const useNoSsr = () => {
+	const [didMount, setDidMount] = useState(false);
+	useEffect(() => setDidMount(typeof window !== "undefined"), []);
+	return useCallback((value, fallback = null) => {
+		return didMount ? typeof value !== "function" ? value : value() : fallback;
+	}, [didMount]);
+};
+// src/internal/hooks/useRerender.ts
+const useRerender = () => {
+	const [, setCount] = useState(0);
+	return useCallback(() => {
+		setCount((oldCount) => (oldCount + 1) % Number.MAX_SAFE_INTEGER);
+	}, []);
+};
+// src/internal/utils/getStorageReady.ts
+const cache = /* @__PURE__ */ new WeakMap();
+const isFailedConnection = (state) => {
+	return state === ConnectionState.Closed || state === ConnectionState.Unavailable;
+};
+const getStorageReady = (room) => {
+	if (room.getStorageLoaded()) return Promise.resolve();
+	const cached = cache.get(room);
+	if (cached) return cached;
+	let settled = false;
+	let unsubscribe = null;
+	const promise = new Promise((resolve, reject) => {
+		const settle = (outcome) => {
+			if (settled) return;
+			settled = true;
+			unsubscribe?.();
+			cache.delete(room);
+			outcome();
+		};
+		const check = (connectionState) => {
+			if (room.getStorageLoaded()) {
+				settle(resolve);
+				return;
+			}
+			if (isFailedConnection(connectionState)) settle(() => {
+				reject(/* @__PURE__ */ new Error("Room closed or storage became unavailable before storage loaded"));
+			});
+		};
+		unsubscribe = room.subscribe.connection((state) => {
+			check(state.connection.state);
+		});
+		check(room.getConnection().state);
+	});
+	if (!settled) cache.set(room, promise);
+	return promise;
+};
+// src/internal/utils/identity.ts
+const identity = (x) => x;
+// src/internal/utils/participantKindsKey.ts
+const participantKindsKey = {
+	toKey(kinds) {
+		if (kinds === void 0) return "";
+		return `\0${kinds.join("\0")}`;
+	},
+	fromKey(kindsKey) {
+		if (kindsKey === "") return void 0;
+		const joined = kindsKey.slice(1);
+		return { kinds: joined === "" ? [] : joined.split("\0") };
+	}
+};
+// src/internal/utils/shallowArrayEqual.ts
+const shallowArrayEqual = (a, b) => {
+	return a.length === b.length && a.every((item, i) => item === b[i]);
+};
+// src/internal/utils/shallowEqual.ts
+const shallowEqual = (a, b) => a === b;
+// src/internal/hooks/useSyncExternalStoreWithSelector.ts
+const useSyncExternalStoreWithSelector = (subscribe, getClientSnapshot, getServerSnapshot, selector, isEqual) => {
+	const noSsr = useNoSsr();
+	const cacheRef = useRef(null);
+	const _getServerSnapshot = getServerSnapshot ? () => {
+		const snapshot = selector(getServerSnapshot());
+		const compare = isEqual ?? shallowEqual;
+		const cached = cacheRef.current;
+		const isUnchanged = cached === null ? snapshot === null : compare(cached, snapshot);
+		/**
+		* !HACK
+		* @description Memoize only the last snapshot so that we can only rerender on changes
+		* @date June 22, 2024
+		*/
+		cacheRef.current = isUnchanged ? cached ?? snapshot : snapshot;
+		return cacheRef.current;
+	} : void 0;
+	const _getClientSnapshot = () => {
+		const snapshot = selector(getClientSnapshot());
+		const compare = isEqual ?? shallowEqual;
+		const cached = cacheRef.current;
+		const isUnchanged = cached === null ? snapshot === null : compare(cached, snapshot);
+		/**
+		* !HACK
+		* @description Memoize only the last snapshot so that we can only rerender on changes
+		* @date June 22, 2024
+		*/
+		cacheRef.current = isUnchanged ? cached ?? snapshot : snapshot;
+		return cacheRef.current;
+	};
+	const result = useSyncExternalStore(subscribe, _getClientSnapshot, _getServerSnapshot);
+	return typeof window !== "undefined" ? noSsr(result, _getServerSnapshot?.()) : result;
+};
+// src/createBundle.tsx
+const createBundle = (client, options = {}) => {
+	/**
+	* !HACK
+	* @description We'll let the context error out if client is not provided,
+	* and let the users deal with it.
+	* @date October 27, 2022
+	*/
+	const PluvContext = createContext(null);
+	/**
+	* !HACK
+	* @description We'll let the context error out if the room is not provided,
+	* and let the users deal with it.
+	* @date November 11, 2022
+	*/
+	const PluvRoomContext = createContext(null);
+	const MockedRoomContext = createContext(null);
+	const MockedRoomProvider = memo((props) => {
+		const { children, events, initialPresence, initialStorage, room: _room } = props;
+		const [room] = useState(() => {
+			return new MockedRoom(_room, {
+				events,
+				initialPresence,
+				initialStorage,
+				presence: client._defs.treaty.presence,
+				storage: client._defs.storage,
+				treaty: client._defs.treaty
+			});
+		});
+		return /* @__PURE__ */ jsx(MockedRoomContext.Provider, {
+			value: room,
+			children: /* @__PURE__ */ jsx(PluvRoomContext.Provider, {
+				value: room,
+				children
+			})
+		});
+	});
+	MockedRoomProvider.displayName = "MockedRoomProvider";
+	const PluvRoomProvider = memo((props) => {
+		const { children, connect = true, debug, initialPresence, initialStorage, metadata, onAuthorizationFail, room: _room } = props;
+		const queue = useAsyncQueue();
+		const rerender = useRerender();
+		const mockedRoom = useContext(MockedRoomContext);
+		const createRoom = useCallback(() => {
+			return client.createRoom(_room, {
+				addons: options.addons,
+				debug,
+				initialPresence,
+				initialStorage,
+				metadata,
+				onAuthorizationFail
+			});
+		}, [
+			_room,
+			debug,
+			initialPresence,
+			initialStorage,
+			metadata,
+			onAuthorizationFail
+		]);
+		const [room, setRoom] = useState(() => createRoom());
+		if (room.id !== _room) setRoom(createRoom());
+		const resolvedMeta = useDeepAsyncMemo(async () => {
+			const resolved = await Promise.resolve(typeof metadata === "function" ? metadata() : metadata);
+			return room.metadata ? parsePluvSchema(room.metadata, resolved) : resolved;
+		});
+		useEffect(() => {
+			const unsubscribe = room.subscribe.connection(() => {
+				rerender();
+			});
+			return () => {
+				unsubscribe();
+			};
+		}, [rerender, room]);
+		useEffect(() => {
+			const leaveRoom = async () => {
+				await queue.push(client.leave(room).catch((error) => {
+					console.error(error);
+				}));
+			};
+			if (!connect) {
+				leaveRoom();
+				return () => {};
+			}
+			if (!resolvedMeta.isInitialized) {
+				leaveRoom();
+				return () => {};
+			}
+			const resolved = resolvedMeta.value;
+			queue.push(client.enter(room, ...[{ metadata: resolved }]).catch(async (error) => {
+				console.error(error);
+				await leaveRoom();
+			}));
+			return () => {
+				leaveRoom();
+			};
+		}, [
+			connect,
+			queue,
+			resolvedMeta.isInitialized,
+			resolvedMeta.value,
+			room
+		]);
+		return /* @__PURE__ */ jsx(PluvRoomContext.Provider, {
+			value: mockedRoom ?? room,
+			children
+		});
+	});
+	PluvRoomProvider.displayName = "PluvRoomProvider";
+	const PluvProvider = memo((props) => {
+		const { children } = props;
+		return /* @__PURE__ */ jsx(PluvContext.Provider, {
+			value: client,
+			children
+		});
+	});
+	PluvProvider.displayName = "PluvProvider";
+	const useClient = () => useContext(PluvContext);
+	const useRoom = () => {
+		const room = useContext(PluvRoomContext);
+		if (!room) throw new Error("Room could not be found. Component must be wrapped with PluvRoomProvider");
+		return room;
+	};
+	const throwIfStoragePending = (room) => {
+		if (!options.suspense) return;
+		if (room.getStorageLoaded()) return;
+		throw getStorageReady(room);
+	};
+	const useBroadcast = () => {
+		return useRoom().broadcast;
+	};
+	const usePresence = () => {
+		return useRoom().presence;
+	};
+	const useCanRedo = () => {
+		const room = useRoom();
+		const subscribe = useCallback((onStoreChange) => room.subscribe.storage(onStoreChange), [room]);
+		const getSnapshot = useCallback(() => room.canRedo(), [room]);
+		const canRedo = useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, identity);
+		throwIfStoragePending(room);
+		return canRedo;
+	};
+	const useCanUndo = () => {
+		const room = useRoom();
+		const subscribe = useCallback((onStoreChange) => room.subscribe.storage(onStoreChange), [room]);
+		const getSnapshot = useCallback(() => room.canUndo(), [room]);
+		const canUndo = useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, identity);
+		throwIfStoragePending(room);
+		return canUndo;
+	};
+	const useConnection = (selector = identity, hookOptions) => {
+		const room = useRoom();
+		const subscribe = useCallback((onStoreChange) => room.subscribe.connection(onStoreChange), [room]);
+		const getSnapshot = room.getConnection.bind(room);
+		const _selector = useCallback((snapshot) => selector(snapshot), [selector]);
+		return useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, _selector, hookOptions?.isEqual ?? fastDeepEqual);
+	};
+	const useDoc = () => {
+		const room = useRoom();
+		const subscribe = useCallback((onStoreChange) => {
+			const unsubscribes = [room.subscribe.storageLoaded(onStoreChange), room.subscribe.connection(onStoreChange)];
+			return () => {
+				unsubscribes.forEach((unsubscribe) => {
+					unsubscribe();
+				});
+			};
+		}, [room]);
+		const getSnapshot = room.getDoc.bind(room);
+		const doc = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+		throwIfStoragePending(room);
+		return doc;
+	};
+	const useEvent = (type, callback) => {
+		const room = useRoom();
+		useEffect(() => {
+			const unsubscribe = room.subscribe.event(type, callback);
+			return () => {
+				unsubscribe();
+			};
+		}, [
+			callback,
+			room,
+			type
+		]);
+	};
+	const event = new Proxy({}, { get(_, prop) {
+		const useProxyEvent = (callback) => {
+			return useEvent(prop, callback);
+		};
+		return { useEvent: useProxyEvent };
+	} });
+	const useMyPresence = (selector = identity, hookOptions) => {
+		const room = useRoom();
+		const subscribe = useCallback((onStoreChange) => room.subscribe.myPresence(onStoreChange), [room]);
+		const getSnapshot = room.getMyPresence.bind(room);
+		const _selector = useCallback((snapshot) => selector(snapshot), [selector]);
+		return [useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, _selector, hookOptions?.isEqual ?? fastDeepEqual), room.updateMyPresence.bind(room)];
+	};
+	const useMyself = (selector = identity, hookOptions) => {
+		const room = useRoom();
+		const subscribe = useCallback((onStoreChange) => room.subscribe.myself(onStoreChange), [room]);
+		const getSnapshot = room.getMyself.bind(room);
+		const _selector = useCallback((snapshot) => {
+			return !snapshot ? null : selector(snapshot);
+		}, [selector]);
+		return useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, _selector, hookOptions?.isEqual ?? fastDeepEqual);
+	};
+	const useOther = (userId, selector = identity, hookOptions) => {
+		const room = useRoom();
+		const kind = hookOptions?.kind;
+		const subscribe = useCallback((onStoreChange) => {
+			return room.subscribe.other(userId, onStoreChange, kind === void 0 ? void 0 : { kind });
+		}, [
+			kind,
+			room,
+			userId
+		]);
+		const getSnapshot = useCallback(() => room.getOther(userId, kind === void 0 ? void 0 : { kind }), [
+			kind,
+			room,
+			userId
+		]);
+		const _selector = useCallback((snapshot) => {
+			return !snapshot ? null : selector(snapshot);
+		}, [selector]);
+		return useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, _selector, hookOptions?.isEqual ?? fastDeepEqual);
+	};
+	const useOthers = (selector = identity, hookOptions) => {
+		const room = useRoom();
+		const kindsKey = participantKindsKey.toKey(hookOptions?.kinds);
+		const subscribe = useCallback((onStoreChange) => {
+			return room.subscribe.others(onStoreChange, participantKindsKey.fromKey(kindsKey));
+		}, [kindsKey, room]);
+		const getSnapshot = useCallback(() => room.getOthers(participantKindsKey.fromKey(kindsKey)), [kindsKey, room]);
+		return useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, selector, hookOptions?.isEqual ?? ((a, b) => {
+			/**
+			* !HACK
+			* @description Assume the return type will always be an array when this occurs
+			* and do a shallow comparison instead like how standard React dependency
+			* arrays work. This is for performance's sake and may lead to bugs if the
+			* selector doesn't always return an array
+			* @date June 22, 2024
+			*/
+			if (Array.isArray(a) && Array.isArray(b) && a.length === b.length) return shallowArrayEqual(a, b);
+			return fastDeepEqual(a, b);
+		}));
+	};
+	const useRedo = () => {
+		const room = useRoom();
+		throwIfStoragePending(room);
+		return room.redo.bind(room);
+	};
+	const useRoomError = (callback) => {
+		const room = useRoom();
+		useEffect(() => {
+			const unsubscribe = room.subscribe.error(callback);
+			return () => {
+				unsubscribe();
+			};
+		}, [callback, room]);
+	};
+	const useRoomStats = (selector = identity, hookOptions) => {
+		const room = useRoom();
+		const kindsKey = participantKindsKey.toKey(hookOptions?.kinds);
+		const subscribe = useCallback((onStoreChange) => room.subscribe.roomStats(onStoreChange), [room]);
+		const getSnapshot = useCallback(() => room.getRoomStats(participantKindsKey.fromKey(kindsKey)), [kindsKey, room]);
+		return useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, selector, hookOptions?.isEqual ?? fastDeepEqual);
+	};
+	const useStorage = () => {
+		const room = useRoom();
+		throwIfStoragePending(room);
+		return room.storage;
+	};
+	const useStorageField = (key, selector = identity, hookOptions) => {
+		const room = useRoom();
+		const rerender = useRerender();
+		useEffect(() => {
+			let storageState = null;
+			const unsubscribes = [room.subscribe.storageLoaded(() => {
+				rerender();
+			}), room.subscribe.connection(({ storage }) => {
+				if (storage.state === storageState) return;
+				storageState = storage.state;
+				rerender();
+			})];
+			return () => {
+				unsubscribes.forEach((unsubscribe) => {
+					unsubscribe();
+				});
+			};
+		}, [rerender, room]);
+		const subscribe = useCallback((onStoreChange) => room.subscribe.storage(key, onStoreChange), [key, room]);
+		const getSnapshot = useCallback(() => {
+			return room.getStorageJson(key);
+		}, [key, room]);
+		const _selector = useCallback((snapshot) => {
+			return snapshot === null ? null : selector(snapshot);
+		}, [selector]);
+		const data = useSyncExternalStoreWithSelector(subscribe, getSnapshot, getSnapshot, _selector, hookOptions?.isEqual ?? fastDeepEqual);
+		const sharedType = room.getStorage(key) ?? null;
+		throwIfStoragePending(room);
+		if (data === null || sharedType === null) {
+			if (options.suspense) throw new Error("Storage is loaded but the requested field is missing");
+			return [null, null];
+		}
+		return [data, sharedType];
+	};
+	const useTransact = () => {
+		const room = useRoom();
+		throwIfStoragePending(room);
+		return room.transact.bind(room);
+	};
+	const useUndo = () => {
+		const room = useRoom();
+		throwIfStoragePending(room);
+		return room.undo.bind(room);
+	};
+	return {
+		MockedRoomProvider,
+		PluvProvider,
+		PluvRoomProvider,
+		event,
+		useBroadcast,
+		useCanRedo,
+		useCanUndo,
+		useClient,
+		useConnection,
+		useDoc,
+		useEvent,
+		useMyPresence,
+		useMyself,
+		useOther,
+		useOthers,
+		usePresence,
+		useRedo,
+		useRoom,
+		useRoomError,
+		useRoomStats,
+		useStorage,
+		useStorageField,
+		useTransact,
+		useUndo
+	};
+};
+export { createBundle };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/internal/hooks/useAsyncQueue.ts","../src/internal/hooks/useDeepAsyncMemo.ts","../src/internal/hooks/useNoSsr.ts","../src/internal/hooks/useRerender.ts","../src/internal/utils/getStorageReady.ts","../src/internal/utils/identity.ts","../src/internal/utils/participantKindsKey.ts","../src/internal/utils/shallowArrayEqual.ts","../src/internal/utils/shallowEqual.ts","../src/internal/hooks/useSyncExternalStoreWithSelector.ts","../src/createBundle.tsx"],"sourcesContent":["import { useCallback, useMemo, useRef } from \"react\";\n\n/**\n * @description This is to handle race conditions, so that our async operations that can\n * happen between re-renders will happen sequentially.\n * @date April 13, 2025\n */\nexport const useAsyncQueue = () => {\n    const queueRef = useRef<Promise<void>>(Promise.resolve(undefined));\n\n    const push = useCallback(async (promise: Promise<any>) => {\n        queueRef.current = queueRef.current.then(async () => await promise);\n\n        return await queueRef.current;\n    }, []);\n\n    return useMemo(() => ({ push }), [push]);\n};\n","import { useEffect, useRef, useState } from \"react\";\nimport fastDeepEqual from \"fast-deep-equal\";\n\nexport type UseDeepAsyncMemoResult<T extends unknown> =\n    | {\n          error: null;\n          isInitialized: true;\n          isLoading: false;\n          value: T;\n      }\n    | {\n          error: null;\n          isInitialized: boolean;\n          value: undefined;\n          isLoading: true;\n      }\n    | {\n          error: Error;\n          isInitialized: boolean;\n          value: undefined;\n          isLoading: false;\n      };\n\nexport const useDeepAsyncMemo = <T>(\n    factory: () => Promise<T>,\n    isEqual: (a: T, b: T) => boolean = fastDeepEqual,\n): UseDeepAsyncMemoResult<T> => {\n    // Store the current async state (loading, value, error, etc.)\n    const [state, setState] = useState<UseDeepAsyncMemoResult<T>>({\n        isInitialized: false,\n        isLoading: true,\n        value: undefined,\n        error: null,\n    });\n\n    // Keep track of the last resolved value to compare with new ones\n    const lastValueRef = useRef<T | undefined>(undefined);\n    const hasValueRef = useRef(false); // Tracks whether we've ever resolved a value\n\n    // Tracks the current in-flight promise to guard against race conditions\n    const inflightRef = useRef<Promise<T> | null>(null);\n\n    // Used to prevent state updates after the component unmounts\n    const isMountedRef = useRef(true);\n\n    useEffect(() => {\n        isMountedRef.current = true;\n\n        // Trigger the async factory\n        const promise = factory();\n        inflightRef.current = promise;\n\n        // Set loading state\n        setState((prev) => {\n            return {\n                ...prev,\n                isLoading: true,\n                error: null,\n            } as UseDeepAsyncMemoResult<T>;\n        });\n\n        promise\n            .then((result) => {\n                // Ignore if component unmounted or if this promise is stale\n                if (!isMountedRef.current || inflightRef.current !== promise) return;\n\n                // Skip update if value hasn't changed\n                const isSame = hasValueRef.current && isEqual(lastValueRef.current as T, result);\n                if (isSame) {\n                    setState((prev) => {\n                        return {\n                            ...prev,\n                            isInitialized: true,\n                            isLoading: false,\n                        } as UseDeepAsyncMemoResult<T>;\n                    });\n                    return;\n                }\n\n                // Save the new value\n                lastValueRef.current = result;\n                hasValueRef.current = true;\n\n                setState({\n                    isInitialized: true,\n                    isLoading: false,\n                    value: result,\n                    error: null,\n                });\n            })\n            .catch((err) => {\n                // Ignore if component unmounted or if this promise is stale\n                if (!isMountedRef.current || inflightRef.current !== promise) return;\n\n                setState({\n                    isInitialized: hasValueRef.current,\n                    isLoading: false,\n                    value: undefined,\n                    error: err instanceof Error ? err : new Error(\"Unknown error\"),\n                });\n            });\n\n        // Cleanup: prevent state updates after unmount\n        return () => {\n            isMountedRef.current = false;\n        };\n        // oxlint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n        /**\n         * !HACK\n         * @description We're only going to use the `isEqual` function to determine if this hook\n         * should re-run. This is basically our hook's version of a dependency array\n         * @date April 13, 2025\n         */\n        // factory,\n        isEqual,\n    ]);\n\n    return state;\n};\n","import { useCallback, useEffect, useState } from \"react\";\n\nexport type NoSsrFunction = <T = null>(value: T | (() => T), fallback?: T) => T;\n\nexport const useNoSsr = (): NoSsrFunction => {\n    const [didMount, setDidMount] = useState<boolean>(false);\n\n    // oxlint-disable-next-line react-hooks/set-state-in-effect\n    useEffect(() => setDidMount(typeof window !== \"undefined\"), []);\n\n    const noSsr = useCallback(\n        <T = null>(value: T | (() => T), fallback: T = null as T): T => {\n            return didMount\n                ? typeof value !== \"function\"\n                    ? value\n                    : (value as () => T)()\n                : fallback;\n        },\n        [didMount],\n    );\n\n    return noSsr;\n};\n","import { useCallback, useState } from \"react\";\n\nexport const useRerender = (): (() => void) => {\n    const [, setCount] = useState(0);\n\n    return useCallback(() => {\n        setCount((oldCount) => (oldCount + 1) % Number.MAX_SAFE_INTEGER);\n    }, []);\n};\n","import type { SubscribeFn, WebSocketConnection } from \"@pluv/types\";\nimport { ConnectionState } from \"@pluv/types\";\n\ntype StorageReadyRoom = {\n    getConnection: () => WebSocketConnection;\n    getStorageLoaded: () => boolean;\n    subscribe: {\n        connection: SubscribeFn<{ connection: WebSocketConnection }>;\n    };\n};\n\nconst cache = new WeakMap<object, Promise<void>>();\n\nconst isFailedConnection = (state: ConnectionState): boolean => {\n    return state === ConnectionState.Closed || state === ConnectionState.Unavailable;\n};\n\nexport const getStorageReady = (room: StorageReadyRoom): Promise<void> => {\n    if (room.getStorageLoaded()) return Promise.resolve();\n\n    const cached = cache.get(room);\n\n    if (cached) return cached;\n\n    let settled = false;\n    let unsubscribe: (() => void) | null = null;\n\n    const promise = new Promise<void>((resolve, reject) => {\n        const settle = (outcome: () => void): void => {\n            if (settled) return;\n\n            settled = true;\n            unsubscribe?.();\n            cache.delete(room);\n            outcome();\n        };\n\n        const check = (connectionState: ConnectionState): void => {\n            if (room.getStorageLoaded()) {\n                settle(resolve);\n                return;\n            }\n\n            if (isFailedConnection(connectionState)) {\n                settle(() => {\n                    reject(\n                        new Error(\n                            \"Room closed or storage became unavailable before storage loaded\",\n                        ),\n                    );\n                });\n            }\n        };\n\n        unsubscribe = room.subscribe.connection((state) => {\n            check(state.connection.state);\n        });\n\n        check(room.getConnection().state);\n    });\n\n    if (!settled) cache.set(room, promise);\n\n    return promise;\n};\n","export const identity = <T extends unknown>(x: T): T => x;\n","import type { ParticipantKind, ParticipantKindsOptions } from \"@pluv/types\";\n\nexport const participantKindsKey = {\n    toKey(kinds: readonly ParticipantKind[] | undefined): string {\n        if (kinds === undefined) return \"\";\n\n        return `\\0${kinds.join(\"\\0\")}`;\n    },\n    fromKey(kindsKey: string): ParticipantKindsOptions | undefined {\n        if (kindsKey === \"\") return undefined;\n\n        const joined = kindsKey.slice(1);\n\n        return { kinds: joined === \"\" ? [] : (joined.split(\"\\0\") as ParticipantKind[]) };\n    },\n};\n","export const shallowArrayEqual = <T extends unknown>(\n    a: readonly T[] | T[],\n    b: readonly T[] | T[],\n): boolean => {\n    return a.length === b.length && a.every((item, i) => item === b[i]);\n};\n","export const shallowEqual = (a: any, b: any): boolean => a === b;\n","import { useRef, useSyncExternalStore } from \"react\";\nimport { shallowEqual } from \"../utils\";\nimport { useNoSsr } from \"./useNoSsr\";\n\nexport const useSyncExternalStoreWithSelector = <TSnapshot, TSelection>(\n    subscribe: (onStoreChange: () => void) => () => void,\n    getClientSnapshot: () => TSnapshot,\n    getServerSnapshot: undefined | null | (() => TSnapshot),\n    selector: (snapshot: TSnapshot) => TSelection,\n    isEqual?: (a: TSelection, b: TSelection) => boolean,\n): TSelection => {\n    const noSsr = useNoSsr();\n    const cacheRef = useRef<TSelection | null>(null);\n\n    const _getServerSnapshot = getServerSnapshot\n        ? () => {\n              const data = getServerSnapshot();\n              const snapshot = selector(data);\n              const compare = isEqual ?? shallowEqual;\n              const cached = cacheRef.current;\n\n              const isUnchanged = cached === null ? snapshot === null : compare(cached, snapshot);\n\n              /**\n               * !HACK\n               * @description Memoize only the last snapshot so that we can only rerender on changes\n               * @date June 22, 2024\n               */\n              cacheRef.current = isUnchanged ? (cached ?? snapshot) : snapshot;\n\n              return cacheRef.current;\n          }\n        : undefined;\n\n    const _getClientSnapshot = () => {\n        const data = getClientSnapshot();\n        const snapshot = selector(data);\n        const compare = isEqual ?? shallowEqual;\n        const cached = cacheRef.current;\n\n        const isUnchanged = cached === null ? snapshot === null : compare(cached, snapshot);\n\n        /**\n         * !HACK\n         * @description Memoize only the last snapshot so that we can only rerender on changes\n         * @date June 22, 2024\n         */\n        cacheRef.current = isUnchanged ? (cached ?? snapshot) : snapshot;\n\n        return cacheRef.current;\n    };\n\n    const result = useSyncExternalStore(subscribe, _getClientSnapshot, _getServerSnapshot);\n\n    // oxlint-disable-next-line react-hooks/refs\n    return typeof window !== \"undefined\" ? noSsr(result, _getServerSnapshot?.()) : result;\n};\n","import type {\n    ClientDefs,\n    CreateRoomOptions,\n    EnterRoomParams,\n    InferClientMetadata,\n    InferClientOutput,\n    InferClientPresence,\n    InferSchemaInput,\n    PluvClient,\n    PluvRoom,\n    PluvRoomAddon,\n    UserInfo,\n    WebSocketConnection,\n} from \"@pluv/client\";\nimport { MockedRoom, parsePluvSchema } from \"@pluv/client\";\nimport type { InferDoc, InferJson, InferStorage } from \"@pluv/crdt\";\nimport type {\n    BroadcastProxy,\n    Id,\n    ParticipantKindOptions,\n    ParticipantKindsOptions,\n    PresenceProcedureProxy,\n    PublicEventKey,\n    RoomError,\n    RoomLike,\n    RoomStats,\n    StorageProcedureProxy,\n    StorageState,\n    UpdateMyPresenceAction,\n} from \"@pluv/types\";\nimport fastDeepEqual from \"fast-deep-equal\";\nimport type { Dispatch } from \"react\";\nimport {\n    createContext,\n    memo,\n    useCallback,\n    useContext,\n    useEffect,\n    useState,\n    useSyncExternalStore,\n} from \"react\";\nimport {\n    getStorageReady,\n    identity,\n    participantKindsKey,\n    shallowArrayEqual,\n    useAsyncQueue,\n    useDeepAsyncMemo,\n    useRerender,\n    useSyncExternalStoreWithSelector,\n} from \"./internal\";\nimport type {\n    CreateBundle,\n    EventProxy,\n    MockedRoomProviderProps,\n    PluvProviderProps,\n    PluvRoomProviderProps,\n    SubscriptionHookOptions,\n    UseStorageResult,\n} from \"./types\";\n\nexport type CreateBundleOptions<TSuspense extends boolean = false> = {\n    addons?: readonly PluvRoomAddon<any>[];\n    suspense?: TSuspense;\n};\n\nexport const createBundle = <TDefs extends ClientDefs, const TSuspense extends boolean = false>(\n    client: PluvClient<TDefs>,\n    options: CreateBundleOptions<TSuspense> = {} as CreateBundleOptions<TSuspense>,\n): CreateBundle<TDefs, TSuspense> => {\n    type TRoom = TDefs;\n    type TPresence = InferClientPresence<TRoom>;\n    type TMetadata = InferClientMetadata<TRoom>;\n    /**\n     * !HACK\n     * @description We'll let the context error out if client is not provided,\n     * and let the users deal with it.\n     * @date October 27, 2022\n     */\n    const PluvContext = createContext<PluvClient<TDefs>>(null as any);\n\n    /**\n     * !HACK\n     * @description We'll let the context error out if the room is not provided,\n     * and let the users deal with it.\n     * @date November 11, 2022\n     */\n    const PluvRoomContext = createContext<\n        RoomLike<\n            TDefs[\"io\"],\n            InferDoc<TDefs[\"storage\"]>,\n            TPresence,\n            InferStorage<TDefs[\"storage\"]>,\n            InferJson<TDefs[\"storage\"]>,\n            TDefs[\"treaty\"]\n        >\n    >(null as any);\n\n    const MockedRoomContext = createContext<RoomLike<\n        TDefs[\"io\"],\n        InferDoc<TDefs[\"storage\"]>,\n        TPresence,\n        InferStorage<TDefs[\"storage\"]>,\n        InferJson<TDefs[\"storage\"]>,\n        TDefs[\"treaty\"]\n    > | null>(null);\n\n    const MockedRoomProvider = memo<MockedRoomProviderProps<TRoom>>((props) => {\n        const { children, events, initialPresence, initialStorage, room: _room } = props;\n\n        const [room] = useState<MockedRoom<TRoom>>(() => {\n            return new MockedRoom<TRoom>(_room, {\n                events,\n                initialPresence,\n                initialStorage,\n                presence: client._defs.treaty.presence,\n                storage: client._defs.storage as TDefs[\"storage\"] | undefined,\n                treaty: client._defs.treaty,\n            });\n        });\n\n        return (\n            <MockedRoomContext.Provider value={room}>\n                <PluvRoomContext.Provider value={room}>{children}</PluvRoomContext.Provider>\n            </MockedRoomContext.Provider>\n        );\n    });\n\n    MockedRoomProvider.displayName = \"MockedRoomProvider\";\n\n    const PluvRoomProvider = memo<PluvRoomProviderProps<TRoom>>((props) => {\n        const {\n            children,\n            connect = true,\n            debug,\n            initialPresence,\n            initialStorage,\n            metadata,\n            onAuthorizationFail,\n            room: _room,\n        } = props;\n\n        const queue = useAsyncQueue();\n        const rerender = useRerender();\n        const mockedRoom = useContext(MockedRoomContext);\n\n        const createRoom = useCallback((): PluvRoom<TRoom> => {\n            return client.createRoom(_room, {\n                addons: options.addons,\n                debug,\n                initialPresence,\n                initialStorage,\n                metadata,\n                onAuthorizationFail,\n            } as CreateRoomOptions<TRoom>);\n        }, [_room, debug, initialPresence, initialStorage, metadata, onAuthorizationFail]);\n\n        const [room, setRoom] = useState(() => createRoom());\n\n        if (room.id !== _room) setRoom(createRoom());\n\n        const resolvedMeta = useDeepAsyncMemo(async () => {\n            const resolved = await Promise.resolve(\n                typeof metadata === \"function\"\n                    ? (\n                          metadata as () =>\n                              | InferSchemaInput<TDefs[\"metadata\"]>\n                              | Promise<InferSchemaInput<TDefs[\"metadata\"]>>\n                      )()\n                    : metadata,\n            );\n\n            return room.metadata ? parsePluvSchema(room.metadata, resolved) : resolved;\n        });\n\n        useEffect(() => {\n            const unsubscribe = room.subscribe.connection(() => {\n                rerender();\n            });\n\n            return () => {\n                unsubscribe();\n            };\n        }, [rerender, room]);\n\n        useEffect(() => {\n            const leaveRoom = async (): Promise<void> => {\n                await queue.push(\n                    client.leave(room).catch((error) => {\n                        console.error(error);\n                    }),\n                );\n            };\n\n            if (!connect) {\n                void leaveRoom();\n                return () => {};\n            }\n\n            if (!resolvedMeta.isInitialized) {\n                void leaveRoom();\n                return () => {};\n            }\n\n            const resolved = resolvedMeta.value as TMetadata;\n\n            void queue.push(\n                client\n                    .enter(\n                        room,\n                        ...([{ metadata: resolved }] as unknown as EnterRoomParams<\n                            InferSchemaInput<TDefs[\"metadata\"]>\n                        >),\n                    )\n                    .catch(async (error) => {\n                        console.error(error);\n                        await leaveRoom();\n                    }),\n            );\n\n            return () => {\n                void leaveRoom();\n            };\n        }, [connect, queue, resolvedMeta.isInitialized, resolvedMeta.value, room]);\n\n        return (\n            <PluvRoomContext.Provider value={mockedRoom ?? room}>\n                {children}\n            </PluvRoomContext.Provider>\n        );\n    });\n\n    PluvRoomProvider.displayName = \"PluvRoomProvider\";\n\n    const PluvProvider = memo<PluvProviderProps>((props) => {\n        const { children } = props;\n\n        return <PluvContext.Provider value={client}>{children}</PluvContext.Provider>;\n    });\n\n    PluvProvider.displayName = \"PluvProvider\";\n\n    const useClient = (): PluvClient<TDefs> => useContext(PluvContext);\n\n    const useRoom = () => {\n        const room = useContext(PluvRoomContext);\n\n        if (!room)\n            throw new Error(\n                \"Room could not be found. Component must be wrapped with PluvRoomProvider\",\n            );\n\n        return room;\n    };\n\n    const throwIfStoragePending = (\n        room: RoomLike<\n            TDefs[\"io\"],\n            InferDoc<TDefs[\"storage\"]>,\n            TPresence,\n            InferStorage<TDefs[\"storage\"]>,\n            InferJson<TDefs[\"storage\"]>,\n            TDefs[\"treaty\"]\n        >,\n    ): void => {\n        if (!options.suspense) return;\n        if (room.getStorageLoaded()) return;\n\n        throw getStorageReady(room);\n    };\n\n    const useBroadcast = (): BroadcastProxy<TDefs[\"io\"]> => {\n        const room = useRoom();\n\n        return room.broadcast;\n    };\n\n    const usePresence = (): PresenceProcedureProxy<\n        TDefs[\"treaty\"][\"_defs\"][\"procedures\"][\"presence\"]\n    > => {\n        const room = useRoom();\n\n        return room.presence;\n    };\n\n    const useCanRedo = (): boolean => {\n        const room = useRoom();\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => room.subscribe.storage(onStoreChange),\n            [room],\n        );\n\n        const getSnapshot = useCallback((): boolean => room.canRedo(), [room]);\n\n        const canRedo = useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            identity,\n        );\n\n        throwIfStoragePending(room);\n\n        return canRedo;\n    };\n\n    const useCanUndo = (): boolean => {\n        const room = useRoom();\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => room.subscribe.storage(onStoreChange),\n            [room],\n        );\n\n        const getSnapshot = useCallback((): boolean => room.canUndo(), [room]);\n\n        const canUndo = useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            identity,\n        );\n\n        throwIfStoragePending(room);\n\n        return canUndo;\n    };\n\n    const useConnection = <TValue extends unknown = WebSocketConnection>(\n        selector = identity as (connection: WebSocketConnection) => TValue,\n        hookOptions?: SubscriptionHookOptions<Id<TValue>>,\n    ): Id<TValue> => {\n        const room = useRoom();\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => room.subscribe.connection(onStoreChange),\n            [room],\n        );\n\n        const getSnapshot = room.getConnection.bind(room);\n\n        const _selector = useCallback(\n            (snapshot: WebSocketConnection) => selector(snapshot) as Id<TValue>,\n            [selector],\n        );\n\n        return useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            _selector,\n            hookOptions?.isEqual ?? fastDeepEqual,\n        );\n    };\n\n    const useDoc = () => {\n        const room = useRoom();\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => {\n                // Storage teardown only surfaces on the connection state, so watch both.\n                const unsubscribes = [\n                    room.subscribe.storageLoaded(onStoreChange),\n                    room.subscribe.connection(onStoreChange),\n                ];\n\n                return () => {\n                    unsubscribes.forEach((unsubscribe) => {\n                        unsubscribe();\n                    });\n                };\n            },\n            [room],\n        );\n\n        const getSnapshot = room.getDoc.bind(room);\n\n        const doc = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n        throwIfStoragePending(room);\n\n        return doc;\n    };\n\n    const useEvent = <TType extends PublicEventKey<InferClientOutput<TRoom>>>(\n        type: TType,\n        callback: Parameters<EventProxy<TRoom>[TType][\"useEvent\"]>[0],\n    ): void => {\n        const room = useRoom();\n\n        useEffect(() => {\n            const unsubscribe = room.subscribe.event(type, callback);\n\n            return () => {\n                unsubscribe();\n            };\n        }, [callback, room, type]);\n    };\n\n    const event = new Proxy(\n        {},\n        {\n            get(_, prop) {\n                const useProxyEvent = (\n                    callback: Parameters<\n                        EventProxy<TRoom>[PublicEventKey<InferClientOutput<TRoom>>][\"useEvent\"]\n                    >[0],\n                ): void => {\n                    return useEvent(prop as PublicEventKey<InferClientOutput<TRoom>>, callback);\n                };\n\n                return { useEvent: useProxyEvent };\n            },\n        },\n    ) as EventProxy<TRoom>;\n\n    const useMyPresence = <TValue extends unknown = TPresence>(\n        selector = identity as (myPresence: TPresence) => TValue,\n        hookOptions?: SubscriptionHookOptions<Id<TValue> | null>,\n    ): [Id<TValue>, Dispatch<UpdateMyPresenceAction<TPresence>>] => {\n        const room = useRoom();\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => room.subscribe.myPresence(onStoreChange),\n            [room],\n        );\n\n        const getSnapshot = room.getMyPresence.bind(room);\n\n        const _selector = useCallback(\n            (snapshot: TPresence) => selector(snapshot) as Id<TValue>,\n            [selector],\n        );\n\n        const myPresence = useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            _selector,\n            hookOptions?.isEqual ?? fastDeepEqual,\n        );\n\n        return [myPresence, room.updateMyPresence.bind(room)];\n    };\n\n    const useMyself = <TValue extends unknown = UserInfo<TDefs[\"io\"], TPresence>>(\n        selector = identity as (myself: Id<UserInfo<TDefs[\"io\"], TPresence>>) => TValue,\n        hookOptions?: SubscriptionHookOptions<Id<TValue> | null>,\n    ): Id<TValue> | null => {\n        const room = useRoom();\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => room.subscribe.myself(onStoreChange),\n            [room],\n        );\n\n        const getSnapshot = room.getMyself.bind(room);\n\n        const _selector = useCallback(\n            (snapshot: Id<UserInfo<TDefs[\"io\"], TPresence>> | null) => {\n                return !snapshot ? null : (selector(snapshot) as Id<TValue>);\n            },\n            [selector],\n        );\n\n        return useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            _selector,\n            hookOptions?.isEqual ?? fastDeepEqual,\n        );\n    };\n\n    const useOther = <TValue extends unknown = UserInfo<TDefs[\"io\"], TPresence>>(\n        userId: string,\n        selector = identity as (other: UserInfo<TDefs[\"io\"], TPresence>) => TValue,\n        hookOptions?: SubscriptionHookOptions<TValue | null> & ParticipantKindOptions,\n    ): TValue | null => {\n        const room = useRoom();\n        const kind = hookOptions?.kind;\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => {\n                return room.subscribe.other(\n                    userId,\n                    onStoreChange,\n                    kind === undefined ? undefined : { kind },\n                );\n            },\n            [kind, room, userId],\n        );\n\n        const getSnapshot = useCallback(\n            () => room.getOther(userId, kind === undefined ? undefined : { kind }),\n            [kind, room, userId],\n        );\n\n        const _selector = useCallback(\n            (snapshot: Id<UserInfo<TDefs[\"io\"], TPresence>> | null) => {\n                return !snapshot ? null : (selector(snapshot) as TValue);\n            },\n            [selector],\n        );\n\n        return useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            _selector,\n            hookOptions?.isEqual ?? fastDeepEqual,\n        );\n    };\n\n    const useOthers = <TValue extends unknown = readonly UserInfo<TDefs[\"io\"], TPresence>[]>(\n        selector = identity as (other: readonly Id<UserInfo<TDefs[\"io\"], TPresence>>[]) => TValue,\n        hookOptions?: SubscriptionHookOptions<TValue> & ParticipantKindsOptions,\n    ): TValue => {\n        const room = useRoom();\n        const kindsKey = participantKindsKey.toKey(hookOptions?.kinds);\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => {\n                return room.subscribe.others(onStoreChange, participantKindsKey.fromKey(kindsKey));\n            },\n            [kindsKey, room],\n        );\n\n        const getSnapshot = useCallback(\n            () => room.getOthers(participantKindsKey.fromKey(kindsKey)),\n            [kindsKey, room],\n        );\n\n        return useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            selector as (other: readonly Id<UserInfo<TDefs[\"io\"], TPresence>>[]) => TValue,\n            hookOptions?.isEqual ??\n                ((a, b) => {\n                    /**\n                     * !HACK\n                     * @description Assume the return type will always be an array when this occurs\n                     * and do a shallow comparison instead like how standard React dependency\n                     * arrays work. This is for performance's sake and may lead to bugs if the\n                     * selector doesn't always return an array\n                     * @date June 22, 2024\n                     */\n                    if (Array.isArray(a) && Array.isArray(b) && a.length === b.length) {\n                        return shallowArrayEqual(a, b);\n                    }\n\n                    return fastDeepEqual(a, b);\n                }),\n        );\n    };\n\n    const useRedo = () => {\n        const room = useRoom();\n\n        throwIfStoragePending(room);\n\n        return room.redo.bind(room);\n    };\n\n    const useRoomError = (callback: (error: RoomError) => void): void => {\n        const room = useRoom();\n\n        useEffect(() => {\n            const unsubscribe = room.subscribe.error(callback);\n\n            return () => {\n                unsubscribe();\n            };\n        }, [callback, room]);\n    };\n\n    const useRoomStats = <TValue extends unknown = RoomStats>(\n        selector = identity as (stats: RoomStats) => TValue,\n        hookOptions?: SubscriptionHookOptions<TValue> & ParticipantKindsOptions,\n    ): TValue => {\n        const room = useRoom();\n        const kindsKey = participantKindsKey.toKey(hookOptions?.kinds);\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => room.subscribe.roomStats(onStoreChange),\n            [room],\n        );\n\n        const getSnapshot = useCallback(\n            () => room.getRoomStats(participantKindsKey.fromKey(kindsKey)),\n            [kindsKey, room],\n        );\n\n        return useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            selector as (stats: RoomStats) => TValue,\n            hookOptions?.isEqual ?? fastDeepEqual,\n        );\n    };\n\n    const useStorage = (): StorageProcedureProxy<\n        TDefs[\"treaty\"][\"_defs\"][\"procedures\"][\"storage\"]\n    > => {\n        const room = useRoom();\n\n        throwIfStoragePending(room);\n\n        return room.storage;\n    };\n\n    const useStorageField = <\n        TKey extends keyof InferJson<TDefs[\"storage\"]>,\n        TData extends unknown = InferJson<TDefs[\"storage\"]>[TKey],\n    >(\n        key: TKey,\n        selector = identity as (data: InferJson<TDefs[\"storage\"]>[TKey]) => TData,\n        hookOptions?: SubscriptionHookOptions<TData | null>,\n    ): UseStorageResult<TData, InferStorage<TDefs[\"storage\"]>[TKey]> => {\n        const room = useRoom();\n        const rerender = useRerender();\n\n        useEffect(() => {\n            let storageState: StorageState | null = null;\n\n            const unsubscribes = [\n                room.subscribe.storageLoaded(() => {\n                    rerender();\n                }),\n                // `storageLoaded` never fires on teardown, so watch the storage state too.\n                room.subscribe.connection(({ storage }) => {\n                    if (storage.state === storageState) return;\n\n                    storageState = storage.state;\n\n                    rerender();\n                }),\n            ];\n\n            return () => {\n                unsubscribes.forEach((unsubscribe) => {\n                    unsubscribe();\n                });\n            };\n        }, [rerender, room]);\n\n        const subscribe = useCallback(\n            (onStoreChange: () => void) => room.subscribe.storage(key, onStoreChange),\n            [key, room],\n        );\n\n        const getSnapshot = useCallback((): InferJson<TDefs[\"storage\"]>[TKey] | null => {\n            return room.getStorageJson(key);\n        }, [key, room]);\n\n        const _selector = useCallback(\n            (snapshot: InferJson<TDefs[\"storage\"]>[TKey] | null) => {\n                return snapshot === null ? null : selector(snapshot);\n            },\n            [selector],\n        );\n\n        const data = useSyncExternalStoreWithSelector(\n            subscribe,\n            getSnapshot,\n            getSnapshot,\n            _selector,\n            hookOptions?.isEqual ?? fastDeepEqual,\n        );\n\n        const sharedType = room.getStorage(key) ?? null;\n\n        throwIfStoragePending(room);\n\n        if (data === null || sharedType === null) {\n            if (options.suspense) {\n                throw new Error(\"Storage is loaded but the requested field is missing\");\n            }\n\n            return [null, null];\n        }\n\n        return [data, sharedType];\n    };\n\n    const useTransact = () => {\n        const room = useRoom();\n\n        throwIfStoragePending(room);\n\n        return room.transact.bind(room);\n    };\n\n    const useUndo = () => {\n        const room = useRoom();\n\n        throwIfStoragePending(room);\n\n        return room.undo.bind(room);\n    };\n\n    return {\n        // components\n        MockedRoomProvider,\n        PluvProvider,\n        PluvRoomProvider,\n\n        // proxies\n        event,\n\n        // hooks\n        useBroadcast,\n        useCanRedo,\n        useCanUndo,\n        useClient,\n        useConnection,\n        useDoc,\n        useEvent,\n        useMyPresence,\n        useMyself,\n        useOther,\n        useOthers,\n        usePresence,\n        useRedo,\n        useRoom,\n        useRoomError,\n        useRoomStats,\n        useStorage,\n        useStorageField,\n        useTransact,\n        useUndo,\n    } as CreateBundle<TRoom, TSuspense>;\n};\n"],"mappings":";;;;;;;;;;;AAOA,MAAa,sBAAsB;CAC/B,MAAM,WAAW,OAAsB,QAAQ,QAAQ,KAAA,CAAS,CAAC;CAEjE,MAAM,OAAO,YAAY,OAAO,YAA0B;EACtD,SAAS,UAAU,SAAS,QAAQ,KAAK,YAAY,MAAM,OAAO;EAElE,OAAO,MAAM,SAAS;CAC1B,GAAG,CAAC,CAAC;CAEL,OAAO,eAAe,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC;AAC3C;;ACMA,MAAa,oBACT,SACA,UAAmC,kBACP;CAE5B,MAAM,CAAC,OAAO,YAAY,SAAoC;EAC1D,eAAe;EACf,WAAW;EACX,OAAO,KAAA;EACP,OAAO;CACX,CAAC;CAGD,MAAM,eAAe,OAAsB,KAAA,CAAS;CACpD,MAAM,cAAc,OAAO,KAAK;CAGhC,MAAM,cAAc,OAA0B,IAAI;CAGlD,MAAM,eAAe,OAAO,IAAI;CAEhC,gBAAgB;EACZ,aAAa,UAAU;EAGvB,MAAM,UAAU,QAAQ;EACxB,YAAY,UAAU;EAGtB,UAAU,SAAS;GACf,OAAO;IACH,GAAG;IACH,WAAW;IACX,OAAO;GACX;EACJ,CAAC;EAED,QACK,MAAM,WAAW;GAEd,IAAI,CAAC,aAAa,WAAW,YAAY,YAAY,SAAS;GAI9D,IADe,YAAY,WAAW,QAAQ,aAAa,SAAc,MAAM,GACnE;IACR,UAAU,SAAS;KACf,OAAO;MACH,GAAG;MACH,eAAe;MACf,WAAW;KACf;IACJ,CAAC;IACD;GACJ;GAGA,aAAa,UAAU;GACvB,YAAY,UAAU;GAEtB,SAAS;IACL,eAAe;IACf,WAAW;IACX,OAAO;IACP,OAAO;GACX,CAAC;EACL,CAAC,CAAC,CACD,OAAO,QAAQ;GAEZ,IAAI,CAAC,aAAa,WAAW,YAAY,YAAY,SAAS;GAE9D,SAAS;IACL,eAAe,YAAY;IAC3B,WAAW;IACX,OAAO,KAAA;IACP,OAAO,eAAe,QAAQ,sBAAM,IAAI,MAAM,eAAe;GACjE,CAAC;EACL,CAAC;EAGL,aAAa;GACT,aAAa,UAAU;EAC3B;CAEJ,GAAG,CAQC,OACJ,CAAC;CAED,OAAO;AACX;;ACnHA,MAAa,iBAAgC;CACzC,MAAM,CAAC,UAAU,eAAe,SAAkB,KAAK;CAGvD,gBAAgB,YAAY,OAAO,WAAW,WAAW,GAAG,CAAC,CAAC;CAa9D,OAXc,aACC,OAAsB,WAAc,SAAiB;EAC5D,OAAO,WACD,OAAO,UAAU,aACb,QACC,MAAkB,IACvB;CACV,GACA,CAAC,QAAQ,CAGF;AACf;;ACpBA,MAAa,oBAAkC;CAC3C,MAAM,GAAG,YAAY,SAAS,CAAC;CAE/B,OAAO,kBAAkB;EACrB,UAAU,cAAc,WAAW,KAAK,OAAO,gBAAgB;CACnE,GAAG,CAAC,CAAC;AACT;;ACGA,MAAM,wBAAQ,IAAI,QAA+B;AAEjD,MAAM,sBAAsB,UAAoC;CAC5D,OAAO,UAAU,gBAAgB,UAAU,UAAU,gBAAgB;AACzE;AAEA,MAAa,mBAAmB,SAA0C;CACtE,IAAI,KAAK,iBAAiB,GAAG,OAAO,QAAQ,QAAQ;CAEpD,MAAM,SAAS,MAAM,IAAI,IAAI;CAE7B,IAAI,QAAQ,OAAO;CAEnB,IAAI,UAAU;CACd,IAAI,cAAmC;CAEvC,MAAM,UAAU,IAAI,SAAe,SAAS,WAAW;EACnD,MAAM,UAAU,YAA8B;GAC1C,IAAI,SAAS;GAEb,UAAU;GACV,cAAc;GACd,MAAM,OAAO,IAAI;GACjB,QAAQ;EACZ;EAEA,MAAM,SAAS,oBAA2C;GACtD,IAAI,KAAK,iBAAiB,GAAG;IACzB,OAAO,OAAO;IACd;GACJ;GAEA,IAAI,mBAAmB,eAAe,GAClC,aAAa;IACT,uBACI,IAAI,MACA,iEACJ,CACJ;GACJ,CAAC;EAET;EAEA,cAAc,KAAK,UAAU,YAAY,UAAU;GAC/C,MAAM,MAAM,WAAW,KAAK;EAChC,CAAC;EAED,MAAM,KAAK,cAAc,CAAC,CAAC,KAAK;CACpC,CAAC;CAED,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,OAAO;CAErC,OAAO;AACX;;AChEA,MAAa,YAA+B,MAAY;;ACExD,MAAa,sBAAsB;CAC/B,MAAM,OAAuD;EACzD,IAAI,UAAU,KAAA,GAAW,OAAO;EAEhC,OAAO,KAAK,MAAM,KAAK,IAAI;CAC/B;CACA,QAAQ,UAAuD;EAC3D,IAAI,aAAa,IAAI,OAAO,KAAA;EAE5B,MAAM,SAAS,SAAS,MAAM,CAAC;EAE/B,OAAO,EAAE,OAAO,WAAW,KAAK,CAAC,IAAK,OAAO,MAAM,IAAI,EAAwB;CACnF;AACJ;;ACfA,MAAa,qBACT,GACA,MACU;CACV,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,MAAM,MAAM,SAAS,EAAE,EAAE;AACtE;;ACLA,MAAa,gBAAgB,GAAQ,MAAoB,MAAM;;ACI/D,MAAa,oCACT,WACA,mBACA,mBACA,UACA,YACa;CACb,MAAM,QAAQ,SAAS;CACvB,MAAM,WAAW,OAA0B,IAAI;CAE/C,MAAM,qBAAqB,0BACf;EAEF,MAAM,WAAW,SADJ,kBACgB,CAAC;EAC9B,MAAM,UAAU,WAAW;EAC3B,MAAM,SAAS,SAAS;EAExB,MAAM,cAAc,WAAW,OAAO,aAAa,OAAO,QAAQ,QAAQ,QAAQ;;;;;;EAOlF,SAAS,UAAU,cAAe,UAAU,WAAY;EAExD,OAAO,SAAS;CACpB,IACA,KAAA;CAEN,MAAM,2BAA2B;EAE7B,MAAM,WAAW,SADJ,kBACgB,CAAC;EAC9B,MAAM,UAAU,WAAW;EAC3B,MAAM,SAAS,SAAS;EAExB,MAAM,cAAc,WAAW,OAAO,aAAa,OAAO,QAAQ,QAAQ,QAAQ;;;;;;EAOlF,SAAS,UAAU,cAAe,UAAU,WAAY;EAExD,OAAO,SAAS;CACpB;CAEA,MAAM,SAAS,qBAAqB,WAAW,oBAAoB,kBAAkB;CAGrF,OAAO,OAAO,WAAW,cAAc,MAAM,QAAQ,qBAAqB,CAAC,IAAI;AACnF;;ACUA,MAAa,gBACT,QACA,UAA0C,CAAC,MACV;;;;;;;CAUjC,MAAM,cAAc,cAAiC,IAAW;;;;;;;CAQhE,MAAM,kBAAkB,cAStB,IAAW;CAEb,MAAM,oBAAoB,cAOhB,IAAI;CAEd,MAAM,qBAAqB,MAAsC,UAAU;EACvE,MAAM,EAAE,UAAU,QAAQ,iBAAiB,gBAAgB,MAAM,UAAU;EAE3E,MAAM,CAAC,QAAQ,eAAkC;GAC7C,OAAO,IAAI,WAAkB,OAAO;IAChC;IACA;IACA;IACA,UAAU,OAAO,MAAM,OAAO;IAC9B,SAAS,OAAO,MAAM;IACtB,QAAQ,OAAO,MAAM;GACzB,CAAC;EACL,CAAC;EAED,OACI,oBAAC,kBAAkB,UAAnB;GAA4B,OAAO;GAC/B,UAAA,oBAAC,gBAAgB,UAAjB;IAA0B,OAAO;IAAO;GAAmC,CAAA;EACnD,CAAA;CAEpC,CAAC;CAED,mBAAmB,cAAc;CAEjC,MAAM,mBAAmB,MAAoC,UAAU;EACnE,MAAM,EACF,UACA,UAAU,MACV,OACA,iBACA,gBACA,UACA,qBACA,MAAM,UACN;EAEJ,MAAM,QAAQ,cAAc;EAC5B,MAAM,WAAW,YAAY;EAC7B,MAAM,aAAa,WAAW,iBAAiB;EAE/C,MAAM,aAAa,kBAAmC;GAClD,OAAO,OAAO,WAAW,OAAO;IAC5B,QAAQ,QAAQ;IAChB;IACA;IACA;IACA;IACA;GACJ,CAA6B;EACjC,GAAG;GAAC;GAAO;GAAO;GAAiB;GAAgB;GAAU;EAAmB,CAAC;EAEjF,MAAM,CAAC,MAAM,WAAW,eAAe,WAAW,CAAC;EAEnD,IAAI,KAAK,OAAO,OAAO,QAAQ,WAAW,CAAC;EAE3C,MAAM,eAAe,iBAAiB,YAAY;GAC9C,MAAM,WAAW,MAAM,QAAQ,QAC3B,OAAO,aAAa,aAEV,SAGF,IACF,QACV;GAEA,OAAO,KAAK,WAAW,gBAAgB,KAAK,UAAU,QAAQ,IAAI;EACtE,CAAC;EAED,gBAAgB;GACZ,MAAM,cAAc,KAAK,UAAU,iBAAiB;IAChD,SAAS;GACb,CAAC;GAED,aAAa;IACT,YAAY;GAChB;EACJ,GAAG,CAAC,UAAU,IAAI,CAAC;EAEnB,gBAAgB;GACZ,MAAM,YAAY,YAA2B;IACzC,MAAM,MAAM,KACR,OAAO,MAAM,IAAI,CAAC,CAAC,OAAO,UAAU;KAChC,QAAQ,MAAM,KAAK;IACvB,CAAC,CACL;GACJ;GAEA,IAAI,CAAC,SAAS;IACV,UAAe;IACf,aAAa,CAAC;GAClB;GAEA,IAAI,CAAC,aAAa,eAAe;IAC7B,UAAe;IACf,aAAa,CAAC;GAClB;GAEA,MAAM,WAAW,aAAa;GAE9B,MAAW,KACP,OACK,MACG,MACA,GAAI,CAAC,EAAE,UAAU,SAAS,CAAC,CAG/B,CAAC,CACA,MAAM,OAAO,UAAU;IACpB,QAAQ,MAAM,KAAK;IACnB,MAAM,UAAU;GACpB,CAAC,CACT;GAEA,aAAa;IACT,UAAe;GACnB;EACJ,GAAG;GAAC;GAAS;GAAO,aAAa;GAAe,aAAa;GAAO;EAAI,CAAC;EAEzE,OACI,oBAAC,gBAAgB,UAAjB;GAA0B,OAAO,cAAc;GAC1C;EACqB,CAAA;CAElC,CAAC;CAED,iBAAiB,cAAc;CAE/B,MAAM,eAAe,MAAyB,UAAU;EACpD,MAAM,EAAE,aAAa;EAErB,OAAO,oBAAC,YAAY,UAAb;GAAsB,OAAO;GAAS;EAA+B,CAAA;CAChF,CAAC;CAED,aAAa,cAAc;CAE3B,MAAM,kBAAqC,WAAW,WAAW;CAEjE,MAAM,gBAAgB;EAClB,MAAM,OAAO,WAAW,eAAe;EAEvC,IAAI,CAAC,MACD,MAAM,IAAI,MACN,0EACJ;EAEJ,OAAO;CACX;CAEA,MAAM,yBACF,SAQO;EACP,IAAI,CAAC,QAAQ,UAAU;EACvB,IAAI,KAAK,iBAAiB,GAAG;EAE7B,MAAM,gBAAgB,IAAI;CAC9B;CAEA,MAAM,qBAAkD;EAGpD,OAFa,QAEH,CAAC,CAAC;CAChB;CAEA,MAAM,oBAED;EAGD,OAFa,QAEH,CAAC,CAAC;CAChB;CAEA,MAAM,mBAA4B;EAC9B,MAAM,OAAO,QAAQ;EAErB,MAAM,YAAY,aACb,kBAA8B,KAAK,UAAU,QAAQ,aAAa,GACnE,CAAC,IAAI,CACT;EAEA,MAAM,cAAc,kBAA2B,KAAK,QAAQ,GAAG,CAAC,IAAI,CAAC;EAErE,MAAM,UAAU,iCACZ,WACA,aACA,aACA,QACJ;EAEA,sBAAsB,IAAI;EAE1B,OAAO;CACX;CAEA,MAAM,mBAA4B;EAC9B,MAAM,OAAO,QAAQ;EAErB,MAAM,YAAY,aACb,kBAA8B,KAAK,UAAU,QAAQ,aAAa,GACnE,CAAC,IAAI,CACT;EAEA,MAAM,cAAc,kBAA2B,KAAK,QAAQ,GAAG,CAAC,IAAI,CAAC;EAErE,MAAM,UAAU,iCACZ,WACA,aACA,aACA,QACJ;EAEA,sBAAsB,IAAI;EAE1B,OAAO;CACX;CAEA,MAAM,iBACF,WAAW,UACX,gBACa;EACb,MAAM,OAAO,QAAQ;EAErB,MAAM,YAAY,aACb,kBAA8B,KAAK,UAAU,WAAW,aAAa,GACtE,CAAC,IAAI,CACT;EAEA,MAAM,cAAc,KAAK,cAAc,KAAK,IAAI;EAEhD,MAAM,YAAY,aACb,aAAkC,SAAS,QAAQ,GACpD,CAAC,QAAQ,CACb;EAEA,OAAO,iCACH,WACA,aACA,aACA,WACA,aAAa,WAAW,aAC5B;CACJ;CAEA,MAAM,eAAe;EACjB,MAAM,OAAO,QAAQ;EAErB,MAAM,YAAY,aACb,kBAA8B;GAE3B,MAAM,eAAe,CACjB,KAAK,UAAU,cAAc,aAAa,GAC1C,KAAK,UAAU,WAAW,aAAa,CAC3C;GAEA,aAAa;IACT,aAAa,SAAS,gBAAgB;KAClC,YAAY;IAChB,CAAC;GACL;EACJ,GACA,CAAC,IAAI,CACT;EAEA,MAAM,cAAc,KAAK,OAAO,KAAK,IAAI;EAEzC,MAAM,MAAM,qBAAqB,WAAW,aAAa,WAAW;EAEpE,sBAAsB,IAAI;EAE1B,OAAO;CACX;CAEA,MAAM,YACF,MACA,aACO;EACP,MAAM,OAAO,QAAQ;EAErB,gBAAgB;GACZ,MAAM,cAAc,KAAK,UAAU,MAAM,MAAM,QAAQ;GAEvD,aAAa;IACT,YAAY;GAChB;EACJ,GAAG;GAAC;GAAU;GAAM;EAAI,CAAC;CAC7B;CAEA,MAAM,QAAQ,IAAI,MACd,CAAC,GACD,EACI,IAAI,GAAG,MAAM;EACT,MAAM,iBACF,aAGO;GACP,OAAO,SAAS,MAAkD,QAAQ;EAC9E;EAEA,OAAO,EAAE,UAAU,cAAc;CACrC,EACJ,CACJ;CAEA,MAAM,iBACF,WAAW,UACX,gBAC4D;EAC5D,MAAM,OAAO,QAAQ;EAErB,MAAM,YAAY,aACb,kBAA8B,KAAK,UAAU,WAAW,aAAa,GACtE,CAAC,IAAI,CACT;EAEA,MAAM,cAAc,KAAK,cAAc,KAAK,IAAI;EAEhD,MAAM,YAAY,aACb,aAAwB,SAAS,QAAQ,GAC1C,CAAC,QAAQ,CACb;EAUA,OAAO,CARY,iCACf,WACA,aACA,aACA,WACA,aAAa,WAAW,aAGX,GAAG,KAAK,iBAAiB,KAAK,IAAI,CAAC;CACxD;CAEA,MAAM,aACF,WAAW,UACX,gBACoB;EACpB,MAAM,OAAO,QAAQ;EAErB,MAAM,YAAY,aACb,kBAA8B,KAAK,UAAU,OAAO,aAAa,GAClE,CAAC,IAAI,CACT;EAEA,MAAM,cAAc,KAAK,UAAU,KAAK,IAAI;EAE5C,MAAM,YAAY,aACb,aAA0D;GACvD,OAAO,CAAC,WAAW,OAAQ,SAAS,QAAQ;EAChD,GACA,CAAC,QAAQ,CACb;EAEA,OAAO,iCACH,WACA,aACA,aACA,WACA,aAAa,WAAW,aAC5B;CACJ;CAEA,MAAM,YACF,QACA,WAAW,UACX,gBACgB;EAChB,MAAM,OAAO,QAAQ;EACrB,MAAM,OAAO,aAAa;EAE1B,MAAM,YAAY,aACb,kBAA8B;GAC3B,OAAO,KAAK,UAAU,MAClB,QACA,eACA,SAAS,KAAA,IAAY,KAAA,IAAY,EAAE,KAAK,CAC5C;EACJ,GACA;GAAC;GAAM;GAAM;EAAM,CACvB;EAEA,MAAM,cAAc,kBACV,KAAK,SAAS,QAAQ,SAAS,KAAA,IAAY,KAAA,IAAY,EAAE,KAAK,CAAC,GACrE;GAAC;GAAM;GAAM;EAAM,CACvB;EAEA,MAAM,YAAY,aACb,aAA0D;GACvD,OAAO,CAAC,WAAW,OAAQ,SAAS,QAAQ;EAChD,GACA,CAAC,QAAQ,CACb;EAEA,OAAO,iCACH,WACA,aACA,aACA,WACA,aAAa,WAAW,aAC5B;CACJ;CAEA,MAAM,aACF,WAAW,UACX,gBACS;EACT,MAAM,OAAO,QAAQ;EACrB,MAAM,WAAW,oBAAoB,MAAM,aAAa,KAAK;EAE7D,MAAM,YAAY,aACb,kBAA8B;GAC3B,OAAO,KAAK,UAAU,OAAO,eAAe,oBAAoB,QAAQ,QAAQ,CAAC;EACrF,GACA,CAAC,UAAU,IAAI,CACnB;EAEA,MAAM,cAAc,kBACV,KAAK,UAAU,oBAAoB,QAAQ,QAAQ,CAAC,GAC1D,CAAC,UAAU,IAAI,CACnB;EAEA,OAAO,iCACH,WACA,aACA,aACA,UACA,aAAa,aACP,GAAG,MAAM;;;;;;;;;GASP,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,QACvD,OAAO,kBAAkB,GAAG,CAAC;GAGjC,OAAO,cAAc,GAAG,CAAC;EAC7B,EACR;CACJ;CAEA,MAAM,gBAAgB;EAClB,MAAM,OAAO,QAAQ;EAErB,sBAAsB,IAAI;EAE1B,OAAO,KAAK,KAAK,KAAK,IAAI;CAC9B;CAEA,MAAM,gBAAgB,aAA+C;EACjE,MAAM,OAAO,QAAQ;EAErB,gBAAgB;GACZ,MAAM,cAAc,KAAK,UAAU,MAAM,QAAQ;GAEjD,aAAa;IACT,YAAY;GAChB;EACJ,GAAG,CAAC,UAAU,IAAI,CAAC;CACvB;CAEA,MAAM,gBACF,WAAW,UACX,gBACS;EACT,MAAM,OAAO,QAAQ;EACrB,MAAM,WAAW,oBAAoB,MAAM,aAAa,KAAK;EAE7D,MAAM,YAAY,aACb,kBAA8B,KAAK,UAAU,UAAU,aAAa,GACrE,CAAC,IAAI,CACT;EAEA,MAAM,cAAc,kBACV,KAAK,aAAa,oBAAoB,QAAQ,QAAQ,CAAC,GAC7D,CAAC,UAAU,IAAI,CACnB;EAEA,OAAO,iCACH,WACA,aACA,aACA,UACA,aAAa,WAAW,aAC5B;CACJ;CAEA,MAAM,mBAED;EACD,MAAM,OAAO,QAAQ;EAErB,sBAAsB,IAAI;EAE1B,OAAO,KAAK;CAChB;CAEA,MAAM,mBAIF,KACA,WAAW,UACX,gBACgE;EAChE,MAAM,OAAO,QAAQ;EACrB,MAAM,WAAW,YAAY;EAE7B,gBAAgB;GACZ,IAAI,eAAoC;GAExC,MAAM,eAAe,CACjB,KAAK,UAAU,oBAAoB;IAC/B,SAAS;GACb,CAAC,GAED,KAAK,UAAU,YAAY,EAAE,cAAc;IACvC,IAAI,QAAQ,UAAU,cAAc;IAEpC,eAAe,QAAQ;IAEvB,SAAS;GACb,CAAC,CACL;GAEA,aAAa;IACT,aAAa,SAAS,gBAAgB;KAClC,YAAY;IAChB,CAAC;GACL;EACJ,GAAG,CAAC,UAAU,IAAI,CAAC;EAEnB,MAAM,YAAY,aACb,kBAA8B,KAAK,UAAU,QAAQ,KAAK,aAAa,GACxE,CAAC,KAAK,IAAI,CACd;EAEA,MAAM,cAAc,kBAA4D;GAC5E,OAAO,KAAK,eAAe,GAAG;EAClC,GAAG,CAAC,KAAK,IAAI,CAAC;EAEd,MAAM,YAAY,aACb,aAAuD;GACpD,OAAO,aAAa,OAAO,OAAO,SAAS,QAAQ;EACvD,GACA,CAAC,QAAQ,CACb;EAEA,MAAM,OAAO,iCACT,WACA,aACA,aACA,WACA,aAAa,WAAW,aAC5B;EAEA,MAAM,aAAa,KAAK,WAAW,GAAG,KAAK;EAE3C,sBAAsB,IAAI;EAE1B,IAAI,SAAS,QAAQ,eAAe,MAAM;GACtC,IAAI,QAAQ,UACR,MAAM,IAAI,MAAM,sDAAsD;GAG1E,OAAO,CAAC,MAAM,IAAI;EACtB;EAEA,OAAO,CAAC,MAAM,UAAU;CAC5B;CAEA,MAAM,oBAAoB;EACtB,MAAM,OAAO,QAAQ;EAErB,sBAAsB,IAAI;EAE1B,OAAO,KAAK,SAAS,KAAK,IAAI;CAClC;CAEA,MAAM,gBAAgB;EAClB,MAAM,OAAO,QAAQ;EAErB,sBAAsB,IAAI;EAE1B,OAAO,KAAK,KAAK,KAAK,IAAI;CAC9B;CAEA,OAAO;EAEH;EACA;EACA;EAGA;EAGA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ;AACJ"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@pluv/react",
+  "version": "0.0.0-canary-20261027022227",
+  "description": "@pluv/client React.js bindings",
+  "author": {
+    "email": "david@pluv.io",
+    "name": "i3dly",
+    "url": "https://github.com/i3dly"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/pluv-io/pluv",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pluv-io/pluv.git",
+    "directory": "packages/react"
+  },
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pluv/client": "^0.0.0-canary-20261027022227",
+    "@pluv/crdt": "^0.0.0-canary-20261027022227",
+    "@pluv/types": "^0.0.0-canary-20261027022227",
+    "fast-deep-equal": "^3.1.3"
+  },
+  "peerDependencies": {
+    "@types/react": "^18.0.0 || ^19.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@pluv/tsconfig": "^0.0.0-canary-20261027022227",
+    "@types/react": "^19.3.0",
+    "react": "^19.3.1",
+    "tsdown": "^0.23.2",
+    "typescript": "7.1.0-beta"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./*": "./*"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
+  }
+}