@roko-app/instant-react-common 0.0.0-stage → 1.0.67-roko.1

package/dist/commonjs/InstantReactRoom.js

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstantReactRoom = exports.rooms = exports.defaultActivityStopTimeout = void 0;
+exports.useTopicEffect = useTopicEffect;
+exports.usePublishTopic = usePublishTopic;
+exports.usePresence = usePresence;
+exports.useSyncPresence = useSyncPresence;
+exports.useTypingIndicator = useTypingIndicator;
+const react_1 = require("react");
+const useTimeout_ts_1 = require("./useTimeout.js");
+exports.defaultActivityStopTimeout = 1_000;
+// ------
+// Topics
+/**
+ * Listen for broadcasted events given a room and topic.
+ *
+ * @see https://instantdb.com/docs/presence-and-topics
+ * @example
+ *  function App({ roomId }) {
+ *    const room = db.room('chats', roomId);
+ *    db.rooms.useTopicEffect(room, 'emoji', (message, peer) => {
+ *      console.log(peer.name, 'sent', message);
+ *    });
+ *    // ...
+ *  }
+ */
+function useTopicEffect(room, topic, onEvent) {
+    const onEventRef = (0, react_1.useRef)(onEvent);
+    onEventRef.current = onEvent;
+    (0, react_1.useEffect)(() => {
+        const unsub = room.core._reactor.subscribeTopic(room.type, room.id, topic, (event, peer) => {
+            onEventRef.current(event, peer);
+        });
+        return unsub;
+    }, [room.id, topic]);
+}
+/**
+ * Broadcast an event to a room.
+ *
+ * @see https://instantdb.com/docs/presence-and-topics
+ * @example
+ * function App({ roomId }) {
+ *   const room = db.room('chat', roomId);
+ *   const publishTopic = db.rooms.usePublishTopic(room, "emoji");
+ *
+ *   return (
+ *     <button onClick={() => publishTopic({ emoji: "🔥" })}>Send emoji</button>
+ *   );
+ * }
+ *
+ */
+function usePublishTopic(room, topic) {
+    (0, react_1.useEffect)(() => room.core._reactor.joinRoom(room.type, room.id), [room.id]);
+    const publishTopic = (0, react_1.useCallback)((data) => {
+        room.core._reactor.publishTopic({
+            roomType: room.type,
+            roomId: room.id,
+            topic,
+            data,
+        });
+    }, [room.id, topic]);
+    return publishTopic;
+}
+// ---------
+// Presence
+/**
+ * Listen for peer's presence data in a room, and publish the current user's presence.
+ *
+ * @see https://instantdb.com/docs/presence-and-topics
+ * @example
+ *  function App({ roomId }) {
+ *    const {
+ *      peers,
+ *      publishPresence
+ *    } = db.room(roomType, roomId).usePresence({ keys: ["name", "avatar"] });
+ *
+ *    // ...
+ *  }
+ */
+function usePresence(room, opts = {}) {
+    const [state, setState] = (0, react_1.useState)(() => {
+        return (room.core._reactor.getPresence(room.type, room.id, opts) ?? {
+            peers: {},
+            isLoading: true,
+        });
+    });
+    (0, react_1.useEffect)(() => {
+        const unsub = room.core._reactor.subscribePresence(room.type, room.id, opts, (data) => {
+            setState(data);
+        });
+        return unsub;
+    }, [room.id, opts.user, opts.peers?.join(), opts.keys?.join()]);
+    const publishPresence = (0, react_1.useCallback)((data) => {
+        room.core._reactor.publishPresence(room.type, room.id, data);
+    }, [room.type, room.id]);
+    const ret = (0, react_1.useMemo)(() => {
+        return {
+            ...state,
+            publishPresence,
+        };
+    }, [state, publishPresence]);
+    return ret;
+}
+/**
+ * Publishes presence data to a room
+ *
+ * @see https://instantdb.com/docs/presence-and-topics
+ * @example
+ *  function App({ roomId, nickname }) {
+ *    const room = db.room('chat', roomId);
+ *    db.rooms.useSyncPresence(room, { nickname });
+ *  }
+ */
+function useSyncPresence(room, data, deps) {
+    (0, react_1.useEffect)(() => room.core._reactor.joinRoom(room.type, room.id, data), [room.id]);
+    (0, react_1.useEffect)(() => {
+        return room.core._reactor.publishPresence(room.type, room.id, data);
+    }, [room.type, room.id, deps ?? JSON.stringify(data)]);
+}
+// -----------------
+// Typing Indicator
+/**
+ * Manage typing indicator state
+ *
+ * @see https://instantdb.com/docs/presence-and-topics
+ * @example
+ *  function App({ roomId }) {
+ *    const room = db.room('chat', roomId);
+ *    const {
+ *      active,
+ *      setActive,
+ *      inputProps,
+ *    } = db.rooms.useTypingIndicator(room, "chat-input");
+ *
+ *    return <input {...inputProps} />;
+ *  }
+ */
+function useTypingIndicator(room, inputName, opts = {}) {
+    const timeout = (0, useTimeout_ts_1.useTimeout)();
+    const observedPresence = exports.rooms.usePresence(room, {
+        keys: [inputName],
+    });
+    const active = (0, react_1.useMemo)(() => {
+        const presenceSnapshot = room._core._reactor.getPresence(room.type, room.id);
+        return opts?.writeOnly
+            ? []
+            : Object.values(presenceSnapshot?.peers ?? {}).filter((p) => p[inputName] === true);
+    }, [opts?.writeOnly, observedPresence]);
+    const setActive = (0, react_1.useCallback)((isActive) => {
+        room.core._reactor.publishPresence(room.type, room.id, {
+            [inputName]: isActive,
+        });
+        if (!isActive)
+            return;
+        if (opts?.timeout === null || opts?.timeout === 0)
+            return;
+        timeout.set(opts?.timeout ?? exports.defaultActivityStopTimeout, () => {
+            room.core._reactor.publishPresence(room.type, room.id, {
+                [inputName]: null,
+            });
+        });
+    }, [room.type, room.id, inputName, opts?.timeout, timeout]);
+    const onKeyDown = (0, react_1.useCallback)((e) => {
+        const isEnter = opts?.stopOnEnter && e.key === 'Enter';
+        const isActive = !isEnter;
+        setActive(isActive);
+    }, [opts.stopOnEnter, setActive]);
+    const onBlur = (0, react_1.useCallback)(() => {
+        setActive(false);
+    }, [setActive]);
+    const inputProps = (0, react_1.useMemo)(() => {
+        return { onKeyDown, onBlur };
+    }, [onKeyDown, onBlur]);
+    return {
+        active,
+        setActive,
+        inputProps,
+    };
+}
+// --------------
+// Hooks
+exports.rooms = {
+    useTopicEffect,
+    usePublishTopic,
+    usePresence,
+    useSyncPresence,
+    useTypingIndicator,
+};
+// ------------
+// Class
+class InstantReactRoom {
+    core;
+    /** @deprecated use `core` instead */
+    _core;
+    type;
+    id;
+    constructor(core, type, id) {
+        this.core = core;
+        this._core = this.core;
+        this.type = type;
+        this.id = id;
+    }
+    /**
+     * @deprecated
+     * `db.room(...).useTopicEffect` is deprecated. You can replace it with `db.rooms.useTopicEffect`.
+     *
+     * @example
+     *
+     * // Before
+     * const room = db.room('chat', 'room-id');
+     * room.useTopicEffect('emoji', (message, peer) => {  });
+     *
+     * // After
+     * const room = db.room('chat', 'room-id');
+     * db.rooms.useTopicEffect(room, 'emoji', (message, peer) => {  });
+     */
+    useTopicEffect = (topic, onEvent) => {
+        exports.rooms.useTopicEffect(this, topic, onEvent);
+    };
+    /**
+     * @deprecated
+     * `db.room(...).usePublishTopic` is deprecated. You can replace it with `db.rooms.usePublishTopic`.
+     *
+     * @example
+     *
+     * // Before
+     * const room = db.room('chat', 'room-id');
+     * const publish = room.usePublishTopic('emoji');
+     *
+     * // After
+     * const room = db.room('chat', 'room-id');
+     * const publish = db.rooms.usePublishTopic(room, 'emoji');
+     */
+    usePublishTopic = (topic) => {
+        return exports.rooms.usePublishTopic(this, topic);
+    };
+    /**
+     * @deprecated
+     * `db.room(...).usePresence` is deprecated. You can replace it with `db.rooms.usePresence`.
+     *
+     * @example
+     *
+     * // Before
+     * const room = db.room('chat', 'room-id');
+     * const { peers } = room.usePresence({ keys: ["name", "avatar"] });
+     *
+     * // After
+     * const room = db.room('chat', 'room-id');
+     * const { peers } = db.rooms.usePresence(room, { keys: ["name", "avatar"] });
+     */
+    usePresence = (opts = {}) => {
+        return exports.rooms.usePresence(this, opts);
+    };
+    /**
+     * @deprecated
+     * `db.room(...).useSyncPresence` is deprecated. You can replace it with `db.rooms.useSyncPresence`.
+     *
+     * @example
+     *
+     * // Before
+     * const room = db.room('chat', 'room-id');
+     * room.useSyncPresence(room, { nickname });
+     *
+     * // After
+     * const room = db.room('chat', 'room-id');
+     * db.rooms.useSyncPresence(room, { nickname });
+     */
+    useSyncPresence = (data, deps) => {
+        return exports.rooms.useSyncPresence(this, data, deps);
+    };
+    /**
+     * @deprecated
+     * `db.room(...).useTypingIndicator` is deprecated. You can replace it with `db.rooms.useTypingIndicator`.
+     *
+     * @example
+     *
+     * // Before
+     * const room = db.room('chat', 'room-id');
+     * const typing = room.useTypingIndiactor(room, 'chat-input');
+     *
+     * // After
+     * const room = db.room('chat', 'room-id');
+     * const typing = db.rooms.useTypingIndiactor(room, 'chat-input');
+     */
+    useTypingIndicator = (inputName, opts = {}) => {
+        return exports.rooms.useTypingIndicator(this, inputName, opts);
+    };
+}
+exports.InstantReactRoom = InstantReactRoom;
+//# sourceMappingURL=InstantReactRoom.js.map

package/dist/commonjs/InstantReactRoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstantReactRoom.js","sourceRoot":"","sources":["../../src/InstantReactRoom.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  // types\n  type PresenceOpts,\n  type PresenceResponse,\n  type RoomSchemaShape,\n  InstantCoreDatabase,\n  InstantSchemaDef,\n} from '@instantdb/core';\n\nimport {\n  KeyboardEvent,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nimport { useTimeout } from './useTimeout.ts';\n\nexport type PresenceHandle<\n  PresenceShape,\n  Keys extends keyof PresenceShape,\n> = PresenceResponse<PresenceShape, Keys> & {\n  publishPresence: (data: Partial<PresenceShape>) => void;\n};\n\nexport type TypingIndicatorOpts = {\n  timeout?: number | null;\n  stopOnEnter?: boolean;\n  // Perf opt - `active` will always be an empty array\n  writeOnly?: boolean;\n};\n\nexport type TypingIndicatorHandle<PresenceShape> = {\n  active: PresenceShape[];\n  setActive(active: boolean): void;\n  inputProps: {\n    onKeyDown: (e: KeyboardEvent) => void;\n    onBlur: () => void;\n  };\n};\n\nexport const defaultActivityStopTimeout = 1_000;\n\n// ------\n// Topics\n\n/**\n * Listen for broadcasted events given a room and topic.\n *\n * @see https://instantdb.com/docs/presence-and-topics\n * @example\n *  function App({ roomId }) {\n *    const room = db.room('chats', roomId);\n *    db.rooms.useTopicEffect(room, 'emoji', (message, peer) => {\n *      console.log(peer.name, 'sent', message);\n *    });\n *    // ...\n *  }\n */\nexport function useTopicEffect<\n  RoomSchema extends RoomSchemaShape,\n  RoomType extends string & keyof RoomSchema,\n  TopicType extends keyof RoomSchema[RoomType]['topics'],\n>(\n  room: InstantReactRoom<any, RoomSchema, RoomType>,\n  topic: TopicType,\n  onEvent: (\n    event: RoomSchema[RoomType]['topics'][TopicType],\n    peer: RoomSchema[RoomType]['presence'],\n  ) => any,\n): void {\n  const onEventRef = useRef(onEvent);\n  onEventRef.current = onEvent;\n\n  useEffect(() => {\n    const unsub = room.core._reactor.subscribeTopic(\n      room.type,\n      room.id,\n      topic,\n      (event, peer) => {\n        onEventRef.current(event, peer);\n      },\n    );\n\n    return unsub;\n  }, [room.id, topic]);\n}\n\n/**\n * Broadcast an event to a room.\n *\n * @see https://instantdb.com/docs/presence-and-topics\n * @example\n * function App({ roomId }) {\n *   const room = db.room('chat', roomId);\n *   const publishTopic = db.rooms.usePublishTopic(room, \"emoji\");\n *\n *   return (\n *     <button onClick={() => publishTopic({ emoji: \"🔥\" })}>Send emoji</button>\n *   );\n * }\n *\n */\nexport function usePublishTopic<\n  RoomSchema extends RoomSchemaShape,\n  RoomType extends string & keyof RoomSchema,\n  TopicType extends keyof RoomSchema[RoomType]['topics'],\n>(\n  room: InstantReactRoom<any, RoomSchema, RoomType>,\n  topic: TopicType,\n): (data: RoomSchema[RoomType]['topics'][TopicType]) => void {\n  useEffect(() => room.core._reactor.joinRoom(room.type, room.id), [room.id]);\n\n  const publishTopic = useCallback(\n    (data) => {\n      room.core._reactor.publishTopic({\n        roomType: room.type,\n        roomId: room.id,\n        topic,\n        data,\n      });\n    },\n    [room.id, topic],\n  );\n\n  return publishTopic;\n}\n\n// ---------\n// Presence\n\n/**\n * Listen for peer's presence data in a room, and publish the current user's presence.\n *\n * @see https://instantdb.com/docs/presence-and-topics\n * @example\n *  function App({ roomId }) {\n *    const {\n *      peers,\n *      publishPresence\n *    } = db.room(roomType, roomId).usePresence({ keys: [\"name\", \"avatar\"] });\n *\n *    // ...\n *  }\n */\nexport function usePresence<\n  RoomSchema extends RoomSchemaShape,\n  RoomType extends string & keyof RoomSchema,\n  Keys extends keyof RoomSchema[RoomType]['presence'],\n>(\n  room: InstantReactRoom<any, RoomSchema, RoomType>,\n  opts: PresenceOpts<RoomSchema[RoomType]['presence'], Keys> = {},\n): PresenceHandle<RoomSchema[RoomType]['presence'], Keys> {\n  const [state, setState] = useState<\n    PresenceResponse<RoomSchema[RoomType]['presence'], Keys>\n  >(() => {\n    return (\n      room.core._reactor.getPresence(room.type, room.id, opts) ?? {\n        peers: {},\n        isLoading: true,\n      }\n    );\n  });\n\n  useEffect(() => {\n    const unsub = room.core._reactor.subscribePresence(\n      room.type,\n      room.id,\n      opts,\n      (data) => {\n        setState(data);\n      },\n    );\n\n    return unsub;\n  }, [room.id, opts.user, opts.peers?.join(), opts.keys?.join()]);\n\n  const publishPresence = useCallback(\n    (data) => {\n      room.core._reactor.publishPresence(room.type, room.id, data);\n    },\n    [room.type, room.id],\n  );\n  const ret = useMemo(() => {\n    return {\n      ...state,\n      publishPresence,\n    };\n  }, [state, publishPresence]);\n  return ret;\n}\n\n/**\n * Publishes presence data to a room\n *\n * @see https://instantdb.com/docs/presence-and-topics\n * @example\n *  function App({ roomId, nickname }) {\n *    const room = db.room('chat', roomId);\n *    db.rooms.useSyncPresence(room, { nickname });\n *  }\n */\nexport function useSyncPresence<\n  RoomSchema extends RoomSchemaShape,\n  RoomType extends string & keyof RoomSchema,\n>(\n  room: InstantReactRoom<any, RoomSchema, RoomType>,\n  data: Partial<RoomSchema[RoomType]['presence']>,\n  deps?: any[],\n): void {\n  useEffect(\n    () => room.core._reactor.joinRoom(room.type, room.id, data),\n    [room.id],\n  );\n  useEffect(() => {\n    return room.core._reactor.publishPresence(room.type, room.id, data);\n  }, [room.type, room.id, deps ?? JSON.stringify(data)]);\n}\n\n// -----------------\n// Typing Indicator\n\n/**\n * Manage typing indicator state\n *\n * @see https://instantdb.com/docs/presence-and-topics\n * @example\n *  function App({ roomId }) {\n *    const room = db.room('chat', roomId);\n *    const {\n *      active,\n *      setActive,\n *      inputProps,\n *    } = db.rooms.useTypingIndicator(room, \"chat-input\");\n *\n *    return <input {...inputProps} />;\n *  }\n */\nexport function useTypingIndicator<\n  RoomSchema extends RoomSchemaShape,\n  RoomType extends string & keyof RoomSchema,\n>(\n  room: InstantReactRoom<any, RoomSchema, RoomType>,\n  inputName: string,\n  opts: TypingIndicatorOpts = {},\n): TypingIndicatorHandle<RoomSchema[RoomType]['presence']> {\n  const timeout = useTimeout();\n\n  const observedPresence = rooms.usePresence(room, {\n    keys: [inputName] as (keyof RoomSchema[RoomType]['presence'])[],\n  });\n\n  const active = useMemo(() => {\n    const presenceSnapshot = room._core._reactor.getPresence(\n      room.type,\n      room.id,\n    );\n\n    return opts?.writeOnly\n      ? []\n      : Object.values(presenceSnapshot?.peers ?? {}).filter(\n          (p) => p[inputName] === true,\n        );\n  }, [opts?.writeOnly, observedPresence]);\n\n  const setActive = useCallback(\n    (isActive: boolean) => {\n      room.core._reactor.publishPresence(room.type, room.id, {\n        [inputName]: isActive,\n      } as unknown as Partial<RoomSchema[RoomType]>);\n\n      if (!isActive) return;\n\n      if (opts?.timeout === null || opts?.timeout === 0) return;\n\n      timeout.set(opts?.timeout ?? defaultActivityStopTimeout, () => {\n        room.core._reactor.publishPresence(room.type, room.id, {\n          [inputName]: null,\n        } as Partial<RoomSchema[RoomType]>);\n      });\n    },\n    [room.type, room.id, inputName, opts?.timeout, timeout],\n  );\n  const onKeyDown = useCallback(\n    (e: KeyboardEvent) => {\n      const isEnter = opts?.stopOnEnter && e.key === 'Enter';\n      const isActive = !isEnter;\n\n      setActive(isActive);\n    },\n    [opts.stopOnEnter, setActive],\n  );\n  const onBlur = useCallback(() => {\n    setActive(false);\n  }, [setActive]);\n\n  const inputProps = useMemo(() => {\n    return { onKeyDown, onBlur };\n  }, [onKeyDown, onBlur]);\n\n  return {\n    active,\n    setActive,\n    inputProps,\n  };\n}\n\n// --------------\n// Hooks\n\nexport const rooms = {\n  useTopicEffect,\n  usePublishTopic,\n  usePresence,\n  useSyncPresence,\n  useTypingIndicator,\n};\n\n// ------------\n// Class\n\nexport class InstantReactRoom<\n  Schema extends InstantSchemaDef<any, any, any>,\n  RoomSchema extends RoomSchemaShape,\n  RoomType extends string & keyof RoomSchema,\n> {\n  core: InstantCoreDatabase<Schema, boolean>;\n  /** @deprecated use `core` instead */\n  _core: InstantCoreDatabase<Schema, boolean>;\n  type: RoomType;\n  id: string;\n\n  constructor(\n    core: InstantCoreDatabase<Schema, boolean>,\n    type: RoomType,\n    id: string,\n  ) {\n    this.core = core;\n    this._core = this.core;\n    this.type = type;\n    this.id = id;\n  }\n\n  /**\n   * @deprecated\n   * `db.room(...).useTopicEffect` is deprecated. You can replace it with `db.rooms.useTopicEffect`.\n   *\n   * @example\n   *\n   * // Before\n   * const room = db.room('chat', 'room-id');\n   * room.useTopicEffect('emoji', (message, peer) => {  });\n   *\n   * // After\n   * const room = db.room('chat', 'room-id');\n   * db.rooms.useTopicEffect(room, 'emoji', (message, peer) => {  });\n   */\n  useTopicEffect = <TopicType extends keyof RoomSchema[RoomType]['topics']>(\n    topic: TopicType,\n    onEvent: (\n      event: RoomSchema[RoomType]['topics'][TopicType],\n      peer: RoomSchema[RoomType]['presence'],\n    ) => any,\n  ): void => {\n    rooms.useTopicEffect(this, topic, onEvent);\n  };\n\n  /**\n   * @deprecated\n   * `db.room(...).usePublishTopic` is deprecated. You can replace it with `db.rooms.usePublishTopic`.\n   *\n   * @example\n   *\n   * // Before\n   * const room = db.room('chat', 'room-id');\n   * const publish = room.usePublishTopic('emoji');\n   *\n   * // After\n   * const room = db.room('chat', 'room-id');\n   * const publish = db.rooms.usePublishTopic(room, 'emoji');\n   */\n  usePublishTopic = <Topic extends keyof RoomSchema[RoomType]['topics']>(\n    topic: Topic,\n  ): ((data: RoomSchema[RoomType]['topics'][Topic]) => void) => {\n    return rooms.usePublishTopic(this, topic);\n  };\n\n  /**\n   * @deprecated\n   * `db.room(...).usePresence` is deprecated. You can replace it with `db.rooms.usePresence`.\n   *\n   * @example\n   *\n   * // Before\n   * const room = db.room('chat', 'room-id');\n   * const { peers } = room.usePresence({ keys: [\"name\", \"avatar\"] });\n   *\n   * // After\n   * const room = db.room('chat', 'room-id');\n   * const { peers } = db.rooms.usePresence(room, { keys: [\"name\", \"avatar\"] });\n   */\n  usePresence = <Keys extends keyof RoomSchema[RoomType]['presence']>(\n    opts: PresenceOpts<RoomSchema[RoomType]['presence'], Keys> = {},\n  ): PresenceHandle<RoomSchema[RoomType]['presence'], Keys> => {\n    return rooms.usePresence(this, opts);\n  };\n\n  /**\n   * @deprecated\n   * `db.room(...).useSyncPresence` is deprecated. You can replace it with `db.rooms.useSyncPresence`.\n   *\n   * @example\n   *\n   * // Before\n   * const room = db.room('chat', 'room-id');\n   * room.useSyncPresence(room, { nickname });\n   *\n   * // After\n   * const room = db.room('chat', 'room-id');\n   * db.rooms.useSyncPresence(room, { nickname });\n   */\n  useSyncPresence = (\n    data: Partial<RoomSchema[RoomType]['presence']>,\n    deps?: any[],\n  ): void => {\n    return rooms.useSyncPresence(this, data, deps);\n  };\n\n  /**\n   * @deprecated\n   * `db.room(...).useTypingIndicator` is deprecated. You can replace it with `db.rooms.useTypingIndicator`.\n   *\n   * @example\n   *\n   * // Before\n   * const room = db.room('chat', 'room-id');\n   * const typing = room.useTypingIndiactor(room, 'chat-input');\n   *\n   * // After\n   * const room = db.room('chat', 'room-id');\n   * const typing = db.rooms.useTypingIndiactor(room, 'chat-input');\n   */\n  useTypingIndicator = (\n    inputName: string,\n    opts: TypingIndicatorOpts = {},\n  ): TypingIndicatorHandle<RoomSchema[RoomType]['presence']> => {\n    return rooms.useTypingIndicator(this, inputName, opts);\n  };\n}\n"]}

package/dist/commonjs/index.d.ts

@@ -0,0 +1,5 @@
+import InstantReactAbstractDatabase from './InstantReactAbstractDatabase.tsx';
+import type { InstantReactRoom } from './InstantReactRoom.ts';
+import { useQueryInternal } from './useQuery.ts';
+export { InstantReactAbstractDatabase, type InstantReactRoom, useQueryInternal, };
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EACL,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,gBAAgB,GACjB,CAAC"}

package/dist/commonjs/index.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useQueryInternal = exports.InstantReactAbstractDatabase = void 0;
+const InstantReactAbstractDatabase_tsx_1 = __importDefault(require("./InstantReactAbstractDatabase.js"));
+exports.InstantReactAbstractDatabase = InstantReactAbstractDatabase_tsx_1.default;
+const useQuery_ts_1 = require("./useQuery.js");
+Object.defineProperty(exports, "useQueryInternal", { enumerable: true, get: function () { return useQuery_ts_1.useQueryInternal; } });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,yGAA8E;AAK5E,uCALK,0CAA4B,CAKL;AAH9B,+CAAiD;AAK/C,iGALO,8BAAgB,OAKP","sourcesContent":["import InstantReactAbstractDatabase from './InstantReactAbstractDatabase.tsx';\nimport type { InstantReactRoom } from './InstantReactRoom.ts';\nimport { useQueryInternal } from './useQuery.ts';\n\nexport {\n  InstantReactAbstractDatabase,\n  type InstantReactRoom,\n  useQueryInternal,\n};\n"]}

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/commonjs/useInfiniteQuerySubscription.d.ts

@@ -0,0 +1,28 @@
+import { type InstantCoreDatabase, type InstantSchemaDef, type InstaQLOptions, InstaQLResponse, ValidQuery } from '@instantdb/core';
+export type InfiniteQueryResult<Schema extends InstantSchemaDef<any, any, any>, Q extends ValidQuery<Q, Schema>, UseDates extends boolean> = {
+    error: {
+        message: string;
+    };
+    data: undefined;
+    isLoading: false;
+    canLoadNextPage: boolean;
+    loadNextPage: () => void;
+} | {
+    error: undefined;
+    data: undefined;
+    isLoading: true;
+    canLoadNextPage: boolean;
+    loadNextPage: () => void;
+} | {
+    error: undefined;
+    data: InstaQLResponse<Schema, Q, UseDates>;
+    isLoading: false;
+    canLoadNextPage: boolean;
+    loadNextPage: () => void;
+};
+export declare function useInfiniteQuerySubscription<Schema extends InstantSchemaDef<any, any, any>, Q extends ValidQuery<Q, Schema>, UseDates extends boolean>({ core, query, opts, }: {
+    core: InstantCoreDatabase<Schema, UseDates>;
+    query: Q | null;
+    opts?: InstaQLOptions;
+}): InfiniteQueryResult<Schema, Q, UseDates>;
+//# sourceMappingURL=useInfiniteQuerySubscription.d.ts.map

package/dist/commonjs/useInfiniteQuerySubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteQuerySubscription.d.ts","sourceRoot":"","sources":["../../src/useInfiniteQuerySubscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,eAAe,EACf,UAAU,EAGX,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,mBAAmB,CAC7B,MAAM,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC9C,CAAC,SAAS,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,EAC/B,QAAQ,SAAS,OAAO,IAEtB;IACE,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,GACD;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,GACD;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3C,SAAS,EAAE,KAAK,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AASN,wBAAgB,4BAA4B,CAC1C,MAAM,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC9C,CAAC,SAAS,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,EAC/B,QAAQ,SAAS,OAAO,EACxB,EACA,IAAI,EACJ,KAAK,EACL,IAAI,GACL,EAAE;IACD,IAAI,EAAE,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5C,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,CAqE3C"}

package/dist/commonjs/useInfiniteQuerySubscription.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useInfiniteQuerySubscription = useInfiniteQuerySubscription;
+const core_1 = require("@instantdb/core");
+const react_1 = require("react");
+const defaultState = {
+    error: undefined,
+    data: undefined,
+    isLoading: true,
+    canLoadNextPage: false,
+};
+function useInfiniteQuerySubscription({ core, query, opts, }) {
+    const subRef = (0, react_1.useRef)(null);
+    const queryHash = (0, core_1.weakHash)(query);
+    const optsHash = (0, core_1.weakHash)(opts);
+    const snapshot = (0, core_1.getInfiniteQueryInitialSnapshot)(core, query, opts);
+    const stateCacheRef = (0, react_1.useRef)({
+        ...snapshot,
+        isLoading: !snapshot.data && !snapshot.error,
+    });
+    const subscribe = (0, react_1.useCallback)((cb) => {
+        subRef.current = null;
+        const nextSnapshot = (0, core_1.getInfiniteQueryInitialSnapshot)(core, query, opts);
+        stateCacheRef.current = {
+            ...nextSnapshot,
+            isLoading: !nextSnapshot.data && !nextSnapshot.error,
+        };
+        cb();
+        if (!query) {
+            return () => { };
+        }
+        const sub = core.subscribeInfiniteQuery(query, (resp) => {
+            stateCacheRef.current = {
+                ...resp,
+                isLoading: false,
+            };
+            cb();
+        }, opts);
+        subRef.current = sub;
+        return () => {
+            sub.unsubscribe();
+            if (subRef.current === sub) {
+                subRef.current = null;
+            }
+        };
+    }, [queryHash, optsHash]);
+    const state = (0, react_1.useSyncExternalStore)(subscribe, () => stateCacheRef.current, () => defaultState);
+    const loadNextPage = () => {
+        subRef.current?.loadNextPage();
+    };
+    // @ts-expect-error union type
+    return {
+        ...state,
+        loadNextPage,
+    };
+}
+//# sourceMappingURL=useInfiniteQuerySubscription.js.map

package/dist/commonjs/useInfiniteQuerySubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteQuerySubscription.js","sourceRoot":"","sources":["../../src/useInfiniteQuerySubscription.ts"],"names":[],"mappings":";;AA8CA,oEAiFC;AA/HD,0CASyB;AACzB,iCAAkE;AA6BlE,MAAM,YAAY,GAAG;IACnB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,SAAgB,4BAA4B,CAI1C,EACA,IAAI,EACJ,KAAK,EACL,IAAI,GAKL;IACC,MAAM,MAAM,GAAG,IAAA,cAAM,EAAmC,IAAI,CAAC,CAAC;IAE9D,MAAM,SAAS,GAAG,IAAA,eAAQ,EAAC,KAAK,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAA,sCAA+B,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAEpE,MAAM,aAAa,GAAG,IAAA,cAAM,EAE1B;QACA,GAAG,QAAQ;QACX,SAAS,EAAE,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK;KAC7C,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAA,mBAAW,EAC3B,CAAC,EAAc,EAAE,EAAE;QACjB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QAEtB,MAAM,YAAY,GAAG,IAAA,sCAA+B,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACxE,aAAa,CAAC,OAAO,GAAG;YACtB,GAAG,YAAY;YACf,SAAS,EAAE,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK;SACrD,CAAC;QAEF,EAAE,EAAE,CAAC;QAEL,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,sBAAsB,CACrC,KAAK,EACL,CAAC,IAAI,EAAE,EAAE;YACP,aAAa,CAAC,OAAO,GAAG;gBACtB,GAAG,IAAI;gBACP,SAAS,EAAE,KAAK;aACjB,CAAC;YACF,EAAE,EAAE,CAAC;QACP,CAAC,EACD,IAAI,CACL,CAAC;QAEF,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;QAErB,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,WAAW,EAAE,CAAC;YAClB,IAAI,MAAM,CAAC,OAAO,KAAK,GAAG,EAAE,CAAC;gBAC3B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EACD,CAAC,SAAS,EAAE,QAAQ,CAAC,CACtB,CAAC;IAEF,MAAM,KAAK,GAAG,IAAA,4BAAoB,EAChC,SAAS,EACT,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,EAC3B,GAAG,EAAE,CAAC,YAAY,CACnB,CAAC;IAEF,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IACjC,CAAC,CAAC;IAEF,8BAA8B;IAC9B,OAAO;QACL,GAAG,KAAK;QACR,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["import {\n  type InfiniteQuerySubscription,\n  type InstantCoreDatabase,\n  type InstantSchemaDef,\n  type InstaQLOptions,\n  InstaQLResponse,\n  ValidQuery,\n  weakHash,\n  getInfiniteQueryInitialSnapshot,\n} from '@instantdb/core';\nimport { useCallback, useRef, useSyncExternalStore } from 'react';\n\nexport type InfiniteQueryResult<\n  Schema extends InstantSchemaDef<any, any, any>,\n  Q extends ValidQuery<Q, Schema>,\n  UseDates extends boolean,\n> =\n  | {\n      error: { message: string };\n      data: undefined;\n      isLoading: false;\n      canLoadNextPage: boolean;\n      loadNextPage: () => void;\n    }\n  | {\n      error: undefined;\n      data: undefined;\n      isLoading: true;\n      canLoadNextPage: boolean;\n      loadNextPage: () => void;\n    }\n  | {\n      error: undefined;\n      data: InstaQLResponse<Schema, Q, UseDates>;\n      isLoading: false;\n      canLoadNextPage: boolean;\n      loadNextPage: () => void;\n    };\n\nconst defaultState = {\n  error: undefined,\n  data: undefined,\n  isLoading: true,\n  canLoadNextPage: false,\n};\n\nexport function useInfiniteQuerySubscription<\n  Schema extends InstantSchemaDef<any, any, any>,\n  Q extends ValidQuery<Q, Schema>,\n  UseDates extends boolean,\n>({\n  core,\n  query,\n  opts,\n}: {\n  core: InstantCoreDatabase<Schema, UseDates>;\n  query: Q | null;\n  opts?: InstaQLOptions;\n}): InfiniteQueryResult<Schema, Q, UseDates> {\n  const subRef = useRef<InfiniteQuerySubscription | null>(null);\n\n  const queryHash = weakHash(query);\n  const optsHash = weakHash(opts);\n  const snapshot = getInfiniteQueryInitialSnapshot(core, query, opts);\n\n  const stateCacheRef = useRef<\n    Omit<InfiniteQueryResult<Schema, Q, UseDates>, 'loadNextPage'>\n  >({\n    ...snapshot,\n    isLoading: !snapshot.data && !snapshot.error,\n  });\n\n  const subscribe = useCallback(\n    (cb: () => void) => {\n      subRef.current = null;\n\n      const nextSnapshot = getInfiniteQueryInitialSnapshot(core, query, opts);\n      stateCacheRef.current = {\n        ...nextSnapshot,\n        isLoading: !nextSnapshot.data && !nextSnapshot.error,\n      };\n\n      cb();\n\n      if (!query) {\n        return () => {};\n      }\n\n      const sub = core.subscribeInfiniteQuery(\n        query,\n        (resp) => {\n          stateCacheRef.current = {\n            ...resp,\n            isLoading: false,\n          };\n          cb();\n        },\n        opts,\n      );\n\n      subRef.current = sub;\n\n      return () => {\n        sub.unsubscribe();\n        if (subRef.current === sub) {\n          subRef.current = null;\n        }\n      };\n    },\n    [queryHash, optsHash],\n  );\n\n  const state = useSyncExternalStore(\n    subscribe,\n    () => stateCacheRef.current,\n    () => defaultState,\n  );\n\n  const loadNextPage = () => {\n    subRef.current?.loadNextPage();\n  };\n\n  // @ts-expect-error union type\n  return {\n    ...state,\n    loadNextPage,\n  };\n}\n"]}

package/dist/commonjs/useQuery.d.ts

@@ -0,0 +1,7 @@
+import { type InstaQLOptions, InstantCoreDatabase, InstaQLLifecycleState, InstantSchemaDef, ValidQuery } from '@instantdb/core';
+export declare function useQueryInternal<Q extends ValidQuery<Q, Schema>, Schema extends InstantSchemaDef<any, any, any>, UseDates extends boolean>(_core: InstantCoreDatabase<Schema, UseDates>, _query: null | Q, _opts?: InstaQLOptions, serverSnapshot?: () => InstaQLLifecycleState<Schema, Q, UseDates> | undefined): {
+    state: InstaQLLifecycleState<Schema, Q, UseDates>;
+    query: any;
+    queryHash: string;
+};
+//# sourceMappingURL=useQuery.d.ts.map

package/dist/commonjs/useQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQuery.d.ts","sourceRoot":"","sources":["../../src/useQuery.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,cAAc,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACX,MAAM,iBAAiB,CAAC;AAoBzB,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,EAC/B,MAAM,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC9C,QAAQ,SAAS,OAAO,EAExB,KAAK,EAAE,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC5C,MAAM,EAAE,IAAI,GAAG,CAAC,EAChB,KAAK,CAAC,EAAE,cAAc,EACtB,cAAc,CAAC,EAAE,MAAM,qBAAqB,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,GAAG,SAAS,GAC5E;IACD,KAAK,EAAE,qBAAqB,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClD,KAAK,EAAE,GAAG,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB,CAgFA"}

package/dist/commonjs/useQuery.js

@@ -0,0 +1,79 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useQueryInternal = useQueryInternal;
+const core_1 = require("@instantdb/core");
+const react_1 = require("react");
+const defaultState = {
+    isLoading: true,
+    data: undefined,
+    pageInfo: undefined,
+    error: undefined,
+};
+function stateForResult(result) {
+    return {
+        isLoading: !Boolean(result),
+        data: undefined,
+        pageInfo: undefined,
+        error: undefined,
+        ...(result ? result : {}),
+    };
+}
+function useQueryInternal(_core, _query, _opts, serverSnapshot) {
+    if (_query && _opts && 'ruleParams' in _opts) {
+        _query = { $$ruleParams: _opts['ruleParams'], ..._query };
+    }
+    const query = _query ? (0, core_1.coerceQuery)(_query) : null;
+    const queryHash = (0, core_1.weakHash)(query);
+    // We use a ref to store the result of the query.
+    // This is becuase `useSyncExternalStore` uses `Object.is`
+    // to compare the previous and next state.
+    // If we don't use a ref, the state will always be considered different, so
+    // the component will always re-render.
+    const resultCacheRef = (0, react_1.useRef)(stateForResult(_core._reactor.getPreviousResult(query)));
+    // Cache the server snapshot to satisfy useSyncExternalStore's requirement
+    // that getServerSnapshot returns the same reference across calls.
+    const serverSnapshotCacheRef = (0, react_1.useRef)(defaultState);
+    // Similar to `resultCacheRef`, `useSyncExternalStore` will unsubscribe
+    // if `subscribe` changes, so we use `useCallback` to memoize the function.
+    const subscribe = (0, react_1.useCallback)((cb) => {
+        // Update the ref when the query changes to avoid showing stale data
+        resultCacheRef.current = stateForResult(_core._reactor.getPreviousResult(query));
+        // before the subscribeQuery is connected and calls it's own callback,
+        // we might have data in the store via SSR, we need to notify useSyncExternalStore that
+        // the data has changed.
+        cb();
+        // Don't subscribe if query is null
+        if (!query) {
+            const unsubscribe = () => { };
+            return unsubscribe;
+        }
+        const unsubscribe = _core.subscribeQuery(query, (result) => {
+            resultCacheRef.current = {
+                isLoading: !Boolean(result),
+                // @ts-expect-error: ts thinks this will always be overwritten
+                data: undefined,
+                // @ts-expect-error: ts thinks this will always be overwritten
+                pageInfo: undefined,
+                // @ts-expect-error: ts thinks this will always be overwritten
+                error: undefined,
+                ...result,
+            };
+            cb();
+        });
+        return unsubscribe;
+    }, 
+    // Build a new subscribe function if the query changes
+    [queryHash]);
+    const state = (0, react_1.useSyncExternalStore)(subscribe, () => resultCacheRef.current, () => {
+        if (serverSnapshot && serverSnapshotCacheRef.current === defaultState) {
+            const result = serverSnapshot();
+            if (result) {
+                serverSnapshotCacheRef.current = result;
+            }
+        }
+        return serverSnapshotCacheRef.current;
+    });
+    return { state, query, queryHash };
+}
+//# sourceMappingURL=useQuery.js.map

package/dist/commonjs/useQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQuery.js","sourceRoot":"","sources":["../../src/useQuery.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AA8Bb,4CA6FC;AAzHD,0CAQyB;AACzB,iCAAkE;AAElE,MAAM,YAAY,GAAG;IACnB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,SAAS;CACR,CAAC;AAEX,SAAS,cAAc,CAAC,MAAW;IACjC,OAAO;QACL,SAAS,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAC3B,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,SAAS;QAChB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,SAAgB,gBAAgB,CAK9B,KAA4C,EAC5C,MAAgB,EAChB,KAAsB,EACtB,cAA6E;IAM7E,IAAI,MAAM,IAAI,KAAK,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;QAC7C,MAAM,GAAG,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAA,kBAAW,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,MAAM,SAAS,GAAG,IAAA,eAAQ,EAAC,KAAK,CAAC,CAAC;IAElC,iDAAiD;IACjD,0DAA0D;IAC1D,0CAA0C;IAC1C,2EAA2E;IAC3E,uCAAuC;IACvC,MAAM,cAAc,GAAG,IAAA,cAAM,EAC3B,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CACxD,CAAC;IAEF,0EAA0E;IAC1E,kEAAkE;IAClE,MAAM,sBAAsB,GAAG,IAAA,cAAM,EAEnC,YAAmB,CAAC,CAAC;IAEvB,uEAAuE;IACvE,2EAA2E;IAC3E,MAAM,SAAS,GAAG,IAAA,mBAAW,EAC3B,CAAC,EAAE,EAAE,EAAE;QACL,oEAAoE;QACpE,cAAc,CAAC,OAAO,GAAG,cAAc,CACrC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,CACxC,CAAC;QACF,sEAAsE;QACtE,uFAAuF;QACvF,wBAAwB;QACxB,EAAE,EAAE,CAAC;QAEL,mCAAmC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,WAAW,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;YAC7B,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAc,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE;YACtE,cAAc,CAAC,OAAO,GAAG;gBACvB,SAAS,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC3B,8DAA8D;gBAC9D,IAAI,EAAE,SAAS;gBACf,8DAA8D;gBAC9D,QAAQ,EAAE,SAAS;gBACnB,8DAA8D;gBAC9D,KAAK,EAAE,SAAS;gBAChB,GAAG,MAAM;aACV,CAAC;YAEF,EAAE,EAAE,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,sDAAsD;IACtD,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,MAAM,KAAK,GAAG,IAAA,4BAAoB,EAGhC,SAAS,EACT,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,EAC5B,GAAG,EAAE;QACH,IAAI,cAAc,IAAI,sBAAsB,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;YACtE,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;YAChC,IAAI,MAAM,EAAE,CAAC;gBACX,sBAAsB,CAAC,OAAO,GAAG,MAAM,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,OAAO,sBAAsB,CAAC,OAAO,CAAC;IACxC,CAAC,CACF,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC","sourcesContent":["'use client';\n\nimport {\n  weakHash,\n  coerceQuery,\n  type InstaQLOptions,\n  InstantCoreDatabase,\n  InstaQLLifecycleState,\n  InstantSchemaDef,\n  ValidQuery,\n} from '@instantdb/core';\nimport { useCallback, useRef, useSyncExternalStore } from 'react';\n\nconst defaultState = {\n  isLoading: true,\n  data: undefined,\n  pageInfo: undefined,\n  error: undefined,\n} as const;\n\nfunction stateForResult(result: any) {\n  return {\n    isLoading: !Boolean(result),\n    data: undefined,\n    pageInfo: undefined,\n    error: undefined,\n    ...(result ? result : {}),\n  };\n}\n\nexport function useQueryInternal<\n  Q extends ValidQuery<Q, Schema>,\n  Schema extends InstantSchemaDef<any, any, any>,\n  UseDates extends boolean,\n>(\n  _core: InstantCoreDatabase<Schema, UseDates>,\n  _query: null | Q,\n  _opts?: InstaQLOptions,\n  serverSnapshot?: () => InstaQLLifecycleState<Schema, Q, UseDates> | undefined,\n): {\n  state: InstaQLLifecycleState<Schema, Q, UseDates>;\n  query: any;\n  queryHash: string;\n} {\n  if (_query && _opts && 'ruleParams' in _opts) {\n    _query = { $$ruleParams: _opts['ruleParams'], ..._query };\n  }\n  const query = _query ? coerceQuery(_query) : null;\n  const queryHash = weakHash(query);\n\n  // We use a ref to store the result of the query.\n  // This is becuase `useSyncExternalStore` uses `Object.is`\n  // to compare the previous and next state.\n  // If we don't use a ref, the state will always be considered different, so\n  // the component will always re-render.\n  const resultCacheRef = useRef<InstaQLLifecycleState<Schema, Q, UseDates>>(\n    stateForResult(_core._reactor.getPreviousResult(query)),\n  );\n\n  // Cache the server snapshot to satisfy useSyncExternalStore's requirement\n  // that getServerSnapshot returns the same reference across calls.\n  const serverSnapshotCacheRef = useRef<\n    InstaQLLifecycleState<Schema, Q, UseDates>\n  >(defaultState as any);\n\n  // Similar to `resultCacheRef`, `useSyncExternalStore` will unsubscribe\n  // if `subscribe` changes, so we use `useCallback` to memoize the function.\n  const subscribe = useCallback(\n    (cb) => {\n      // Update the ref when the query changes to avoid showing stale data\n      resultCacheRef.current = stateForResult(\n        _core._reactor.getPreviousResult(query),\n      );\n      // before the subscribeQuery is connected and calls it's own callback,\n      // we might have data in the store via SSR, we need to notify useSyncExternalStore that\n      // the data has changed.\n      cb();\n\n      // Don't subscribe if query is null\n      if (!query) {\n        const unsubscribe = () => {};\n        return unsubscribe;\n      }\n\n      const unsubscribe = _core.subscribeQuery<Q, UseDates>(query, (result) => {\n        resultCacheRef.current = {\n          isLoading: !Boolean(result),\n          // @ts-expect-error: ts thinks this will always be overwritten\n          data: undefined,\n          // @ts-expect-error: ts thinks this will always be overwritten\n          pageInfo: undefined,\n          // @ts-expect-error: ts thinks this will always be overwritten\n          error: undefined,\n          ...result,\n        };\n\n        cb();\n      });\n\n      return unsubscribe;\n    },\n    // Build a new subscribe function if the query changes\n    [queryHash],\n  );\n\n  const state = useSyncExternalStore<\n    InstaQLLifecycleState<Schema, Q, UseDates>\n  >(\n    subscribe,\n    () => resultCacheRef.current,\n    () => {\n      if (serverSnapshot && serverSnapshotCacheRef.current === defaultState) {\n        const result = serverSnapshot();\n        if (result) {\n          serverSnapshotCacheRef.current = result;\n        }\n      }\n\n      return serverSnapshotCacheRef.current;\n    },\n  );\n\n  return { state, query, queryHash };\n}\n"]}

package/dist/commonjs/useTimeout.d.ts

@@ -0,0 +1,5 @@
+export declare function useTimeout(): {
+    set: (delay: number, fn: () => void) => void;
+    clear: () => void;
+};
+//# sourceMappingURL=useTimeout.d.ts.map

package/dist/commonjs/useTimeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeout.d.ts","sourceRoot":"","sources":["../../src/useTimeout.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU;iBAOJ,MAAM,MAAM,MAAM,IAAI;;EAY3C"}

package/dist/commonjs/useTimeout.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTimeout = useTimeout;
+const react_1 = require("react");
+function useTimeout() {
+    const timeoutRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        clear();
+    }, []);
+    function set(delay, fn) {
+        clear();
+        timeoutRef.current = setTimeout(fn, delay);
+    }
+    function clear() {
+        if (timeoutRef.current) {
+            clearTimeout(timeoutRef.current);
+        }
+    }
+    return { set, clear };
+}
+//# sourceMappingURL=useTimeout.js.map

package/dist/commonjs/useTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeout.js","sourceRoot":"","sources":["../../src/useTimeout.ts"],"names":[],"mappings":";;AAEA,gCAmBC;AArBD,iCAA0C;AAE1C,SAAgB,UAAU;IACxB,MAAM,UAAU,GAAG,IAAA,cAAM,EAAuC,IAAI,CAAC,CAAC;IAEtE,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,KAAK,EAAE,CAAC;IACV,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,GAAG,CAAC,KAAa,EAAE,EAAc;QACxC,KAAK,EAAE,CAAC;QACR,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,KAAK;QACZ,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC","sourcesContent":["import { useEffect, useRef } from 'react';\n\nexport function useTimeout() {\n  const timeoutRef = useRef<null | ReturnType<typeof setTimeout>>(null);\n\n  useEffect(() => {\n    clear();\n  }, []);\n\n  function set(delay: number, fn: () => void) {\n    clear();\n    timeoutRef.current = setTimeout(fn, delay);\n  }\n\n  function clear() {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n    }\n  }\n\n  return { set, clear };\n}\n"]}

package/dist/commonjs/version.d.ts

@@ -0,0 +1,3 @@
+import { version } from '@instantdb/version';
+export default version;
+//# sourceMappingURL=version.d.ts.map

package/dist/commonjs/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,eAAe,OAAO,CAAC"}

package/dist/commonjs/version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const version_1 = require("@instantdb/version");
+exports.default = version_1.version;
+//# sourceMappingURL=version.js.map

package/dist/commonjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;AAAA,gDAA6C;AAE7C,kBAAe,iBAAO,CAAC","sourcesContent":["import { version } from '@instantdb/version';\n\nexport default version;\n"]}