@fidscript/instant-solidjs 0.1.0

package/dist/esm/InstantSolidDatabase.js

@@ -0,0 +1,321 @@
+import { txInit, init as core_init, coerceQuery, getInfiniteQueryInitialSnapshot, InstantError, } from '@fidscript/instant-sdk';
+import { createSignal, createEffect, onCleanup, createMemo } from 'solid-js';
+import { InstantSolidRoom, rooms } from './InstantSolidRoom.js';
+import version from './version.js';
+const defaultState = {
+    isLoading: true,
+    data: undefined,
+    pageInfo: undefined,
+    error: undefined,
+};
+const defaultAuthState = {
+    isLoading: true,
+    user: undefined,
+    error: undefined,
+};
+function stateForResult(result) {
+    return {
+        isLoading: !Boolean(result),
+        data: undefined,
+        pageInfo: undefined,
+        error: undefined,
+        ...(result ? result : {}),
+    };
+}
+export class InstantSolidDatabase {
+    tx = txInit();
+    auth;
+    storage;
+    streams;
+    core;
+    constructor(core) {
+        this.core = core;
+        this.auth = this.core.auth;
+        this.storage = this.core.storage;
+        this.streams = this.core.streams;
+    }
+    /**
+     * Returns a unique ID for a given `name`. It's stored in local storage,
+     * so you will get the same ID across sessions.
+     *
+     * @example
+     *  const deviceId = await db.getLocalId('device');
+     */
+    getLocalId = (name) => {
+        return this.core.getLocalId(name);
+    };
+    /**
+     * Use this to write data! You can create, update, delete, and link objects
+     *
+     * @see https://instantdb.com/docs/instaml
+     *
+     * @example
+     *   const goalId = id();
+     *   db.transact(db.tx.goals[goalId].update({title: "Get fit"}))
+     */
+    transact = (chunks) => {
+        return this.core.transact(chunks);
+    };
+    /**
+     * One time query for the logged in state.
+     *
+     * @see https://instantdb.com/docs/auth
+     * @example
+     *   const user = await db.getAuth();
+     *   console.log('logged in as', user.email)
+     */
+    getAuth() {
+        return this.core.getAuth();
+    }
+    /**
+     * Use this for one-off queries.
+     * Returns local data if available, otherwise fetches from the server.
+     *
+     * @see https://instantdb.com/docs/instaql
+     *
+     * @example
+     *  const resp = await db.queryOnce({ goals: {} });
+     *  console.log(resp.data.goals)
+     */
+    queryOnce = (query, opts) => {
+        return this.core.queryOnce(query, opts);
+    };
+    // -----------
+    // Solid reactive hooks
+    /**
+     * Use this to query your data!
+     *
+     * @see https://instantdb.com/docs/instaql
+     *
+     * @example
+     *   const state = db.useQuery({ goals: {} });
+     *   // state().isLoading, state().error, state().data
+     */
+    useQuery = (query, opts) => {
+        const [state, setState] = createSignal(defaultState);
+        createEffect(() => {
+            const resolvedQuery = typeof query === 'function' ? query() : query;
+            if (!resolvedQuery) {
+                setState(() => defaultState);
+                return;
+            }
+            let q = resolvedQuery;
+            if (opts && 'ruleParams' in opts) {
+                q = { $$ruleParams: opts['ruleParams'], ...q };
+            }
+            const coerced = coerceQuery(q);
+            const prev = this.core._reactor.getPreviousResult(coerced);
+            if (prev) {
+                setState(() => stateForResult(prev));
+            }
+            const unsub = this.core.subscribeQuery(coerced, (result) => {
+                setState(() => Object.assign({
+                    isLoading: false,
+                    data: undefined,
+                    pageInfo: undefined,
+                    error: undefined,
+                }, result));
+            });
+            onCleanup(unsub);
+        });
+        return state;
+    };
+    /**
+     * Subscribe to a query and incrementally load more items.
+     *
+     * Only one top level namespace in the query is allowed.
+     *
+     * @see https://instantdb.com/docs/instaql
+     *
+     * @example
+     *   const state = db.useInfiniteQuery({
+     *     posts: {
+     *       $: {
+     *         limit: 20,
+     *         order: { createdAt: 'desc' },
+     *       },
+     *     },
+     *   });
+     *   // state().data, state().isLoading, state().error,
+     *   // state().canLoadNextPage, state().loadNextPage()
+     */
+    useInfiniteQuery = (query, opts) => {
+        let sub = null;
+        const loadNextPage = () => sub?.loadNextPage();
+        const [state, setState] = createSignal({
+            isLoading: true,
+            error: undefined,
+            data: undefined,
+            canLoadNextPage: false,
+            loadNextPage,
+        });
+        createEffect(() => {
+            const resolvedQuery = typeof query === 'function' ? query() : query;
+            if (!resolvedQuery) {
+                sub = null;
+                setState(() => ({
+                    isLoading: true,
+                    error: undefined,
+                    data: undefined,
+                    canLoadNextPage: false,
+                    loadNextPage,
+                }));
+                return;
+            }
+            const snapshot = getInfiniteQueryInitialSnapshot(this.core, resolvedQuery, opts);
+            setState(() => ({
+                ...snapshot,
+                isLoading: !snapshot.data && !snapshot.error,
+                loadNextPage,
+            }));
+            sub = this.core.subscribeInfiniteQuery(resolvedQuery, (resp) => {
+                setState(() => ({
+                    ...resp,
+                    isLoading: false,
+                    loadNextPage,
+                }));
+            }, opts);
+            onCleanup(() => {
+                sub?.unsubscribe();
+                sub = null;
+            });
+        });
+        return state;
+    };
+    /**
+     * Listen for the logged in state. This is useful
+     * for deciding when to show a login screen.
+     *
+     * @see https://instantdb.com/docs/auth
+     * @example
+     *  function App() {
+     *    const auth = db.useAuth();
+     *    // auth().isLoading, auth().user, auth().error
+     *  }
+     */
+    useAuth = () => {
+        const [state, setState] = createSignal(this.core._reactor._currentUserCached ?? defaultAuthState);
+        createEffect(() => {
+            const unsub = this.core.subscribeAuth((auth) => {
+                setState({ isLoading: false, ...auth });
+            });
+            onCleanup(unsub);
+        });
+        return state;
+    };
+    /**
+     * Subscribe to the currently logged in user.
+     * If the user is not logged in, this will throw an Error.
+     *
+     * @see https://instantdb.com/docs/auth
+     * @example
+     *  function UserDisplay() {
+     *    const user = db.useUser();
+     *    return <div>Logged in as: {user().email}</div>
+     *  }
+     */
+    useUser = () => {
+        const auth = this.useAuth();
+        return createMemo(() => {
+            const { user } = auth();
+            if (!user) {
+                throw new InstantError('useUser must be used within an auth-protected route');
+            }
+            return user;
+        });
+    };
+    /**
+     * Listen for connection status changes to Instant.
+     *
+     * @see https://www.instantdb.com/docs/patterns#connection-status
+     * @example
+     *  function App() {
+     *    const status = db.useConnectionStatus();
+     *    return <div>Connection state: {status()}</div>
+     *  }
+     */
+    useConnectionStatus = () => {
+        const [status, setStatus] = createSignal(this.core._reactor.status);
+        createEffect(() => {
+            const unsub = this.core.subscribeConnectionStatus((newStatus) => {
+                setStatus(() => newStatus);
+            });
+            onCleanup(unsub);
+        });
+        return status;
+    };
+    /**
+     * A hook that returns a unique ID for a given `name`. localIds are
+     * stored in local storage, so you will get the same ID across sessions.
+     *
+     * Initially returns `null`, and then loads the localId.
+     *
+     * @example
+     * const deviceId = db.useLocalId('device');
+     * // deviceId() is null initially, then the ID string
+     */
+    useLocalId = (name) => {
+        const [localId, setLocalId] = createSignal(null);
+        createEffect(() => {
+            let mounted = true;
+            this.getLocalId(name).then((id) => {
+                if (mounted) {
+                    setLocalId(() => id);
+                }
+            });
+            onCleanup(() => {
+                mounted = false;
+            });
+        });
+        return localId;
+    };
+    /**
+     * Obtain a handle to a room, which allows you to listen to topics and presence data
+     *
+     * @see https://instantdb.com/docs/presence-and-topics
+     *
+     * @example
+     *  const room = db.room('chat', roomId);
+     *  const presence = db.rooms.usePresence(room);
+     */
+    room(type = '_defaultRoomType', id = '_defaultRoomId') {
+        return new InstantSolidRoom(this.core, type, id);
+    }
+    /**
+     * Hooks for working with rooms
+     *
+     * @see https://instantdb.com/docs/presence-and-topics
+     *
+     * @example
+     *  const room = db.room('chat', roomId);
+     *  const presence = db.rooms.usePresence(room);
+     *  const publish = db.rooms.usePublishTopic(room, 'emoji');
+     */
+    rooms = rooms;
+}
+// -----------
+// init
+/**
+ * The first step: init your application!
+ *
+ * Visit https://instantdb.com/dash to get your `appId` :)
+ *
+ * @example
+ *  import { init } from "@instantdb/solidjs"
+ *
+ *  const db = init({ appId: "my-app-id" })
+ *
+ *  // You can also provide a schema for type safety and editor autocomplete!
+ *
+ *  import { init } from "@instantdb/solidjs"
+ *  import schema from "../instant.schema.ts";
+ *
+ *  const db = init({ appId: "my-app-id", schema })
+ */
+export function init(config) {
+    const coreDb = core_init(config, undefined, undefined, {
+        '@instantdb/solidjs': version,
+    });
+    return new InstantSolidDatabase(coreDb);
+}
+//# sourceMappingURL=InstantSolidDatabase.js.map

package/dist/esm/InstantSolidDatabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstantSolidDatabase.js","sourceRoot":"","sources":["../../src/InstantSolidDatabase.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  // types\n  type AuthState,\n  type User,\n  type ConnectionStatus,\n  type TransactionChunk,\n  type RoomSchemaShape,\n  type InstaQLOptions,\n  type InstantConfig,\n  type PageInfoResponse,\n  type InstaQLLifecycleState,\n  type InstaQLResponse,\n  type InfiniteQuerySubscription,\n  type ValidQuery,\n  // classes\n  Auth,\n  Storage,\n  Streams,\n  txInit,\n  InstantCoreDatabase,\n  init as core_init,\n  coerceQuery,\n  getInfiniteQueryInitialSnapshot,\n  InstantSchemaDef,\n  RoomsOf,\n  InstantError,\n  IInstantDatabase,\n} from '@fidscript/instant-sdk';\n\nimport { createSignal, createEffect, onCleanup, createMemo } from 'solid-js';\nimport type { Accessor } from 'solid-js';\n\nimport { InstantSolidRoom, rooms } from './InstantSolidRoom.js';\nimport version from './version.js';\n\nconst defaultState = {\n  isLoading: true,\n  data: undefined,\n  pageInfo: undefined,\n  error: undefined,\n} as const;\n\nexport type InfiniteQueryState<\n  Schema extends InstantSchemaDef<any, any, any>,\n  Q extends ValidQuery<Q, Schema>,\n  UseDates extends boolean,\n> = {\n  isLoading: boolean;\n  error: { message: string } | undefined;\n  data: InstaQLResponse<Schema, Q, UseDates> | undefined;\n  canLoadNextPage: boolean;\n  loadNextPage: () => void;\n};\n\nconst defaultAuthState: AuthState = {\n  isLoading: true,\n  user: undefined,\n  error: undefined,\n};\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 class InstantSolidDatabase<\n  Schema extends InstantSchemaDef<any, any, any>,\n  UseDates extends boolean = false,\n  Rooms extends RoomSchemaShape = RoomsOf<Schema>,\n> implements IInstantDatabase<Schema>\n{\n  public tx = txInit<Schema>();\n\n  public auth: Auth;\n  public storage: Storage;\n  public streams: Streams;\n  public core: InstantCoreDatabase<Schema, UseDates>;\n\n  constructor(core: InstantCoreDatabase<Schema, UseDates>) {\n    this.core = core;\n    this.auth = this.core.auth;\n    this.storage = this.core.storage;\n    this.streams = this.core.streams;\n  }\n\n  /**\n   * Returns a unique ID for a given `name`. It's stored in local storage,\n   * so you will get the same ID across sessions.\n   *\n   * @example\n   *  const deviceId = await db.getLocalId('device');\n   */\n  getLocalId = (name: string): Promise<string> => {\n    return this.core.getLocalId(name);\n  };\n\n  /**\n   * Use this to write data! You can create, update, delete, and link objects\n   *\n   * @see https://instantdb.com/docs/instaml\n   *\n   * @example\n   *   const goalId = id();\n   *   db.transact(db.tx.goals[goalId].update({title: \"Get fit\"}))\n   */\n  transact = (\n    chunks: TransactionChunk<any, any> | TransactionChunk<any, any>[],\n  ) => {\n    return this.core.transact(chunks);\n  };\n\n  /**\n   * One time query for the logged in state.\n   *\n   * @see https://instantdb.com/docs/auth\n   * @example\n   *   const user = await db.getAuth();\n   *   console.log('logged in as', user.email)\n   */\n  getAuth(): Promise<User | null> {\n    return this.core.getAuth();\n  }\n\n  /**\n   * Use this for one-off queries.\n   * Returns local data if available, otherwise fetches from the server.\n   *\n   * @see https://instantdb.com/docs/instaql\n   *\n   * @example\n   *  const resp = await db.queryOnce({ goals: {} });\n   *  console.log(resp.data.goals)\n   */\n  queryOnce = <Q extends ValidQuery<Q, Schema>>(\n    query: Q,\n    opts?: InstaQLOptions,\n  ): Promise<{\n    data: InstaQLResponse<Schema, Q, UseDates>;\n    pageInfo: PageInfoResponse<Q>;\n  }> => {\n    return this.core.queryOnce(query, opts);\n  };\n\n  // -----------\n  // Solid reactive hooks\n\n  /**\n   * Use this to query your data!\n   *\n   * @see https://instantdb.com/docs/instaql\n   *\n   * @example\n   *   const state = db.useQuery({ goals: {} });\n   *   // state().isLoading, state().error, state().data\n   */\n  useQuery = <Q extends ValidQuery<Q, Schema>>(\n    query: (() => null | Q) | null | Q,\n    opts?: InstaQLOptions,\n  ): Accessor<InstaQLLifecycleState<Schema, Q, UseDates>> => {\n    const [state, setState] = createSignal<\n      InstaQLLifecycleState<Schema, Q, UseDates>\n    >(defaultState as InstaQLLifecycleState<Schema, Q, UseDates>);\n\n    createEffect(() => {\n      const resolvedQuery = typeof query === 'function' ? query() : query;\n\n      if (!resolvedQuery) {\n        setState(\n          () => defaultState as InstaQLLifecycleState<Schema, Q, UseDates>,\n        );\n        return;\n      }\n\n      let q = resolvedQuery;\n      if (opts && 'ruleParams' in opts) {\n        q = { $$ruleParams: (opts as any)['ruleParams'], ...q };\n      }\n\n      const coerced = coerceQuery(q);\n      const prev = this.core._reactor.getPreviousResult(coerced);\n      if (prev) {\n        setState(\n          () =>\n            stateForResult(prev) as InstaQLLifecycleState<Schema, Q, UseDates>,\n        );\n      }\n\n      const unsub = this.core.subscribeQuery<Q, UseDates>(coerced, (result) => {\n        setState(\n          () =>\n            Object.assign(\n              {\n                isLoading: false,\n                data: undefined,\n                pageInfo: undefined,\n                error: undefined,\n              },\n              result,\n            ) as InstaQLLifecycleState<Schema, Q, UseDates>,\n        );\n      });\n\n      onCleanup(unsub);\n    });\n\n    return state;\n  };\n\n  /**\n   * Subscribe to a query and incrementally load more items.\n   *\n   * Only one top level namespace in the query is allowed.\n   *\n   * @see https://instantdb.com/docs/instaql\n   *\n   * @example\n   *   const state = db.useInfiniteQuery({\n   *     posts: {\n   *       $: {\n   *         limit: 20,\n   *         order: { createdAt: 'desc' },\n   *       },\n   *     },\n   *   });\n   *   // state().data, state().isLoading, state().error,\n   *   // state().canLoadNextPage, state().loadNextPage()\n   */\n  useInfiniteQuery = <Q extends ValidQuery<Q, Schema>>(\n    query: (() => null | Q) | null | Q,\n    opts?: InstaQLOptions,\n  ): Accessor<InfiniteQueryState<Schema, Q, UseDates>> => {\n    let sub: InfiniteQuerySubscription | null = null;\n    const loadNextPage = () => sub?.loadNextPage();\n\n    const [state, setState] = createSignal<\n      InfiniteQueryState<Schema, Q, UseDates>\n    >({\n      isLoading: true,\n      error: undefined,\n      data: undefined,\n      canLoadNextPage: false,\n      loadNextPage,\n    });\n\n    createEffect(() => {\n      const resolvedQuery = typeof query === 'function' ? query() : query;\n\n      if (!resolvedQuery) {\n        sub = null;\n        setState(() => ({\n          isLoading: true,\n          error: undefined,\n          data: undefined,\n          canLoadNextPage: false,\n          loadNextPage,\n        }));\n        return;\n      }\n\n      const snapshot = getInfiniteQueryInitialSnapshot<Schema, Q, UseDates>(\n        this.core,\n        resolvedQuery,\n        opts,\n      );\n      setState(() => ({\n        ...snapshot,\n        isLoading: !snapshot.data && !snapshot.error,\n        loadNextPage,\n      }));\n\n      sub = this.core.subscribeInfiniteQuery<Q>(\n        resolvedQuery,\n        (resp) => {\n          setState(() => ({\n            ...resp,\n            isLoading: false,\n            loadNextPage,\n          }));\n        },\n        opts,\n      );\n\n      onCleanup(() => {\n        sub?.unsubscribe();\n        sub = null;\n      });\n    });\n\n    return state;\n  };\n\n  /**\n   * Listen for the logged in state. This is useful\n   * for deciding when to show a login screen.\n   *\n   * @see https://instantdb.com/docs/auth\n   * @example\n   *  function App() {\n   *    const auth = db.useAuth();\n   *    // auth().isLoading, auth().user, auth().error\n   *  }\n   */\n  useAuth = (): Accessor<AuthState> => {\n    const [state, setState] = createSignal<AuthState>(\n      this.core._reactor._currentUserCached ?? defaultAuthState,\n    );\n\n    createEffect(() => {\n      const unsub = this.core.subscribeAuth((auth) => {\n        setState({ isLoading: false, ...auth });\n      });\n\n      onCleanup(unsub);\n    });\n\n    return state;\n  };\n\n  /**\n   * Subscribe to the currently logged in user.\n   * If the user is not logged in, this will throw an Error.\n   *\n   * @see https://instantdb.com/docs/auth\n   * @example\n   *  function UserDisplay() {\n   *    const user = db.useUser();\n   *    return <div>Logged in as: {user().email}</div>\n   *  }\n   */\n  useUser = (): Accessor<User> => {\n    const auth = this.useAuth();\n    return createMemo(() => {\n      const { user } = auth();\n      if (!user) {\n        throw new InstantError(\n          'useUser must be used within an auth-protected route',\n        );\n      }\n      return user;\n    });\n  };\n\n  /**\n   * Listen for connection status changes to Instant.\n   *\n   * @see https://www.instantdb.com/docs/patterns#connection-status\n   * @example\n   *  function App() {\n   *    const status = db.useConnectionStatus();\n   *    return <div>Connection state: {status()}</div>\n   *  }\n   */\n  useConnectionStatus = (): Accessor<ConnectionStatus> => {\n    const [status, setStatus] = createSignal<ConnectionStatus>(\n      this.core._reactor.status as ConnectionStatus,\n    );\n\n    createEffect(() => {\n      const unsub = this.core.subscribeConnectionStatus((newStatus) => {\n        setStatus(() => newStatus);\n      });\n\n      onCleanup(unsub);\n    });\n\n    return status;\n  };\n\n  /**\n   * A hook that returns a unique ID for a given `name`. localIds are\n   * stored in local storage, so you will get the same ID across sessions.\n   *\n   * Initially returns `null`, and then loads the localId.\n   *\n   * @example\n   * const deviceId = db.useLocalId('device');\n   * // deviceId() is null initially, then the ID string\n   */\n  useLocalId = (name: string): Accessor<string | null> => {\n    const [localId, setLocalId] = createSignal<string | null>(null);\n\n    createEffect(() => {\n      let mounted = true;\n      this.getLocalId(name).then((id) => {\n        if (mounted) {\n          setLocalId(() => id);\n        }\n      });\n      onCleanup(() => {\n        mounted = false;\n      });\n    });\n\n    return localId;\n  };\n\n  /**\n   * Obtain a handle to a room, which allows you to listen to topics and presence data\n   *\n   * @see https://instantdb.com/docs/presence-and-topics\n   *\n   * @example\n   *  const room = db.room('chat', roomId);\n   *  const presence = db.rooms.usePresence(room);\n   */\n  room<RoomType extends keyof Rooms>(\n    type: RoomType = '_defaultRoomType' as RoomType,\n    id: string = '_defaultRoomId',\n  ) {\n    return new InstantSolidRoom<Schema, Rooms, RoomType>(this.core, type, id);\n  }\n\n  /**\n   * Hooks for working with rooms\n   *\n   * @see https://instantdb.com/docs/presence-and-topics\n   *\n   * @example\n   *  const room = db.room('chat', roomId);\n   *  const presence = db.rooms.usePresence(room);\n   *  const publish = db.rooms.usePublishTopic(room, 'emoji');\n   */\n  rooms = rooms;\n}\n\n// -----------\n// init\n\n/**\n * The first step: init your application!\n *\n * Visit https://instantdb.com/dash to get your `appId` :)\n *\n * @example\n *  import { init } from \"@instantdb/solidjs\"\n *\n *  const db = init({ appId: \"my-app-id\" })\n *\n *  // You can also provide a schema for type safety and editor autocomplete!\n *\n *  import { init } from \"@instantdb/solidjs\"\n *  import schema from \"../instant.schema.ts\";\n *\n *  const db = init({ appId: \"my-app-id\", schema })\n */\nexport function init<\n  Schema extends InstantSchemaDef<any, any, any>,\n  UseDates extends boolean = false,\n>(\n  config: Omit<InstantConfig<Schema, UseDates>, 'useDateObjects'> & {\n    useDateObjects?: UseDates;\n  },\n): InstantSolidDatabase<Schema, UseDates> {\n  const coreDb = core_init<Schema, UseDates>(config, undefined, undefined, {\n    '@instantdb/solidjs': version,\n  });\n  return new InstantSolidDatabase<Schema, UseDates>(coreDb);\n}\n"]}

package/dist/esm/InstantSolidRoom.d.ts

@@ -0,0 +1,97 @@
+import { type PresenceOpts, type PresenceResponse, type RoomSchemaShape, InstantCoreDatabase, InstantSchemaDef } from '@fidscript/instant-sdk';
+import type { Accessor } from 'solid-js';
+export type PresenceHandle<PresenceShape, Keys extends keyof PresenceShape> = PresenceResponse<PresenceShape, Keys> & {
+    publishPresence: (data: Partial<PresenceShape>) => void;
+};
+export type TypingIndicatorOpts = {
+    timeout?: number | null;
+    stopOnEnter?: boolean;
+    writeOnly?: boolean;
+};
+export type TypingIndicatorHandle<PresenceShape> = {
+    active: Accessor<PresenceShape[]>;
+    setActive(active: boolean): void;
+    inputProps: {
+        onKeyDown: (e: KeyboardEvent) => void;
+        onBlur: () => void;
+    };
+};
+export declare const defaultActivityStopTimeout = 1000;
+/**
+ * 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);
+ *    });
+ *    // ...
+ *  }
+ */
+export declare function useTopicEffect<RoomSchema extends RoomSchemaShape, RoomType extends keyof RoomSchema, TopicType extends keyof RoomSchema[RoomType]['topics']>(room: InstantSolidRoom<any, RoomSchema, RoomType>, topic: TopicType, onEvent: (event: RoomSchema[RoomType]['topics'][TopicType], peer: RoomSchema[RoomType]['presence']) => any): void;
+/**
+ * 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>
+ *   );
+ * }
+ *
+ */
+export declare function usePublishTopic<RoomSchema extends RoomSchemaShape, RoomType extends keyof RoomSchema, TopicType extends keyof RoomSchema[RoomType]['topics']>(room: InstantSolidRoom<any, RoomSchema, RoomType>, topic: TopicType): (data: RoomSchema[RoomType]['topics'][TopicType]) => void;
+/**
+ * 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 presence = db.rooms.usePresence(room, { keys: ["name", "avatar"] });
+ *    // presence().peers, presence().isLoading, presence().publishPresence
+ *  }
+ */
+export declare function usePresence<RoomSchema extends RoomSchemaShape, RoomType extends keyof RoomSchema, Keys extends keyof RoomSchema[RoomType]['presence']>(room: InstantSolidRoom<any, RoomSchema, RoomType>, opts?: PresenceOpts<RoomSchema[RoomType]['presence'], Keys>): Accessor<PresenceHandle<RoomSchema[RoomType]['presence'], Keys>>;
+/**
+ * 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 });
+ *  }
+ */
+export declare function useSyncPresence<RoomSchema extends RoomSchemaShape, RoomType extends keyof RoomSchema>(room: InstantSolidRoom<any, RoomSchema, RoomType>, data: Partial<RoomSchema[RoomType]['presence']>, deps?: any[]): void;
+/**
+ * Manage typing indicator state
+ *
+ * @see https://instantdb.com/docs/presence-and-topics
+ * @example
+ *  function App({ roomId }) {
+ *    const room = db.room('chat', roomId);
+ *    const typing = db.rooms.useTypingIndicator(room, "chat-input");
+ *    // typing.active(), typing.setActive(bool), typing.inputProps
+ *  }
+ */
+export declare function useTypingIndicator<RoomSchema extends RoomSchemaShape, RoomType extends keyof RoomSchema>(room: InstantSolidRoom<any, RoomSchema, RoomType>, inputName: string, opts?: TypingIndicatorOpts): TypingIndicatorHandle<RoomSchema[RoomType]['presence']>;
+export declare const rooms: {
+    useTopicEffect: typeof useTopicEffect;
+    usePublishTopic: typeof usePublishTopic;
+    usePresence: typeof usePresence;
+    useSyncPresence: typeof useSyncPresence;
+    useTypingIndicator: typeof useTypingIndicator;
+};
+export declare class InstantSolidRoom<Schema extends InstantSchemaDef<any, any, any>, RoomSchema extends RoomSchemaShape, RoomType extends keyof RoomSchema> {
+    core: InstantCoreDatabase<Schema, boolean>;
+    type: RoomType;
+    id: string;
+    constructor(core: InstantCoreDatabase<Schema, boolean>, type: RoomType, id: string);
+}
+//# sourceMappingURL=InstantSolidRoom.d.ts.map

package/dist/esm/InstantSolidRoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstantSolidRoom.d.ts","sourceRoot":"","sources":["../../src/InstantSolidRoom.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAKzC,MAAM,MAAM,cAAc,CACxB,aAAa,EACb,IAAI,SAAS,MAAM,aAAa,IAC9B,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG;IAC1C,eAAe,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,aAAa,IAAI;IACjD,MAAM,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAClC,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE;QACV,SAAS,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;QACtC,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAKhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,UAAU,SAAS,eAAe,EAClC,QAAQ,SAAS,MAAM,UAAU,EACjC,SAAS,SAAS,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAEtD,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EACjD,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,CACP,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,EAChD,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,KACnC,GAAG,GACP,IAAI,CAaN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,UAAU,SAAS,eAAe,EAClC,QAAQ,SAAS,MAAM,UAAU,EACjC,SAAS,SAAS,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAEtD,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EACjD,KAAK,EAAE,SAAS,GACf,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,CAc3D;AAKD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,UAAU,SAAS,eAAe,EAClC,QAAQ,SAAS,MAAM,UAAU,EACjC,IAAI,SAAS,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,EAEnD,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EACjD,IAAI,GAAE,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAM,GAC9D,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC,CA+BlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,UAAU,SAAS,eAAe,EAClC,QAAQ,SAAS,MAAM,UAAU,EAEjC,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EACjD,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,EAC/C,IAAI,CAAC,EAAE,GAAG,EAAE,GACX,IAAI,CAmBN;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,SAAS,eAAe,EAClC,QAAQ,SAAS,MAAM,UAAU,EAEjC,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EACjD,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,mBAAwB,GAC7B,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,CAgEzD;AAKD,eAAO,MAAM,KAAK;;;;;;CAMjB,CAAC;AAKF,qBAAa,gBAAgB,CAC3B,MAAM,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC9C,UAAU,SAAS,eAAe,EAClC,QAAQ,SAAS,MAAM,UAAU;IAEjC,IAAI,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;gBAGT,IAAI,EAAE,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,MAAM;CAMb"}

package/dist/esm/InstantSolidRoom.js

@@ -0,0 +1,200 @@
+import { createSignal, createEffect, onCleanup, createMemo } from 'solid-js';
+export const 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);
+ *    });
+ *    // ...
+ *  }
+ */
+export function useTopicEffect(room, topic, onEvent) {
+    createEffect(() => {
+        const unsub = room.core._reactor.subscribeTopic(room.type, room.id, topic, (event, peer) => {
+            onEvent(event, peer);
+        });
+        onCleanup(unsub);
+    });
+}
+/**
+ * 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>
+ *   );
+ * }
+ *
+ */
+export function usePublishTopic(room, topic) {
+    createEffect(() => {
+        const unsub = room.core._reactor.joinRoom(room.type, room.id);
+        onCleanup(unsub);
+    });
+    return (data) => {
+        room.core._reactor.publishTopic({
+            roomType: room.type,
+            roomId: room.id,
+            topic,
+            data,
+        });
+    };
+}
+// ---------
+// 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 presence = db.rooms.usePresence(room, { keys: ["name", "avatar"] });
+ *    // presence().peers, presence().isLoading, presence().publishPresence
+ *  }
+ */
+export function usePresence(room, opts = {}) {
+    const [state, setState] = createSignal((room.core._reactor.getPresence(room.type, room.id, opts) ?? {
+        peers: {},
+        isLoading: true,
+    }));
+    createEffect(() => {
+        const unsub = room.core._reactor.subscribePresence(room.type, room.id, opts, (data) => {
+            setState(data);
+        });
+        onCleanup(unsub);
+    });
+    const publishPresence = (data) => {
+        room.core._reactor.publishPresence(room.type, room.id, data);
+    };
+    return createMemo(() => ({
+        ...state(),
+        publishPresence,
+    }));
+}
+/**
+ * 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 });
+ *  }
+ */
+export function useSyncPresence(room, data, deps) {
+    createEffect(() => {
+        const unsub = room.core._reactor.joinRoom(room.type, room.id, data);
+        onCleanup(unsub);
+    });
+    createEffect(() => {
+        // Track deps if provided, otherwise track serialized data
+        if (deps) {
+            deps.forEach((d) => (typeof d === 'function' ? d() : d));
+        }
+        else {
+            JSON.stringify(data);
+        }
+        room.core._reactor.publishPresence(room.type, room.id, 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 typing = db.rooms.useTypingIndicator(room, "chat-input");
+ *    // typing.active(), typing.setActive(bool), typing.inputProps
+ *  }
+ */
+export function useTypingIndicator(room, inputName, opts = {}) {
+    let timeoutId = null;
+    const presence = rooms.usePresence(room, {
+        keys: [inputName],
+    });
+    const active = createMemo(() => {
+        if (opts?.writeOnly)
+            return [];
+        // Access presence to track it
+        presence();
+        const presenceSnapshot = room.core._reactor.getPresence(room.type, room.id);
+        return Object.values(presenceSnapshot?.peers ?? {}).filter((p) => p[inputName] === true);
+    });
+    const setActive = (isActive) => {
+        room.core._reactor.publishPresence(room.type, room.id, {
+            [inputName]: isActive ? true : null,
+        });
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        if (!isActive)
+            return;
+        if (opts?.timeout === null || opts?.timeout === 0)
+            return;
+        timeoutId = setTimeout(() => {
+            room.core._reactor.publishPresence(room.type, room.id, {
+                [inputName]: null,
+            });
+        }, opts?.timeout ?? defaultActivityStopTimeout);
+    };
+    onCleanup(() => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        // Ensure we don't leave a sticky typing state behind on unmount,
+        // even when opts.timeout is null/0 (i.e. no auto-timeout).
+        setActive(false);
+    });
+    const onKeyDown = (e) => {
+        const isEnter = opts?.stopOnEnter && e.key === 'Enter';
+        const isActive = !isEnter;
+        setActive(isActive);
+    };
+    const onBlur = () => {
+        setActive(false);
+    };
+    return {
+        active,
+        setActive,
+        inputProps: { onKeyDown, onBlur },
+    };
+}
+// --------------
+// Hooks namespace
+export const rooms = {
+    useTopicEffect,
+    usePublishTopic,
+    usePresence,
+    useSyncPresence,
+    useTypingIndicator,
+};
+// ------------
+// Class
+export class InstantSolidRoom {
+    core;
+    type;
+    id;
+    constructor(core, type, id) {
+        this.core = core;
+        this.type = type;
+        this.id = id;
+    }
+}
+//# sourceMappingURL=InstantSolidRoom.js.map