@towns-labs/react-sdk 2.0.1

package/dist/esm/useGdm.js

@@ -0,0 +1,16 @@
+import { useMemo } from 'react';
+import { useSyncAgent } from './useSyncAgent';
+import { useObservable } from './useObservable';
+/**
+ * Hook to get the data of a Group DM.
+ * You can use this hook to get Group DM metadata and if the user has joined the Group DM.
+ * @param streamId - The id of the Group DM to get the data of.
+ * @param config - Configuration options for the observable.
+ * @returns The GdmModel of the Group DM.
+ */
+export const useGdm = (streamId, config) => {
+    const sync = useSyncAgent();
+    const gdm = useMemo(() => sync.gdms.getGdm(streamId), [streamId, sync]);
+    return useObservable(gdm, config);
+};
+//# sourceMappingURL=useGdm.js.map

package/dist/esm/useGdm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGdm.js","sourceRoot":"","sources":["../../src/useGdm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAyB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEtE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAE,MAA4C,EAAE,EAAE;IACrF,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACvE,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AACrC,CAAC,CAAA"}

package/dist/esm/useJoinSpace.js

@@ -0,0 +1,23 @@
+'use client';
+import { useAction } from './internals/useAction';
+import { useSyncAgent } from './useSyncAgent';
+/**
+ * Hook to join a space.
+ * @param config - Configuration options for the action.
+ * @returns The joinSpace action and the status of the action.
+ */
+export const useJoinSpace = (config) => {
+    const sync = useSyncAgent();
+    const { action: joinSpace, ...rest } = useAction(sync.spaces, 'joinSpace', config);
+    return {
+        /**
+         * Action to join a space.
+         * @param spaceId - The id of the space to join.
+         * @param signer - The signer to use to join the space.
+         * @param opts - Options for the join action.
+         */
+        joinSpace,
+        ...rest,
+    };
+};
+//# sourceMappingURL=useJoinSpace.js.map

package/dist/esm/useJoinSpace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useJoinSpace.js","sourceRoot":"","sources":["../../src/useJoinSpace.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAGZ,OAAO,EAAqB,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAA0C,EAAE,EAAE;IACvE,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IAElF,OAAO;QACH;;;;;WAKG;QACH,SAAS;QACT,GAAG,IAAI;KACV,CAAA;AACL,CAAC,CAAA"}

package/dist/esm/useMember.js

@@ -0,0 +1,36 @@
+import { useMemo } from 'react';
+import { useObservable } from './useObservable';
+import { useSyncAgent } from './useSyncAgent';
+import { getRoom } from './utils';
+/**
+ * Hook to get data from a specific member of a Space, GDM, Channel, or DM.
+ * @param props - The streamId and userId of the member to get data from.
+ * @param config - Configuration options for the observable.
+ * @returns The Member data.
+ */
+export const useMember = (props, config) => {
+    const sync = useSyncAgent();
+    const member = useMemo(() => getRoom(sync, props.streamId).members.get(props.userId), [sync, props]);
+    const { data, ...rest } = useObservable(member, config);
+    return {
+        // Excluding `Member.id` property from the return value, since its a internal store id and can lead to confusion
+        userId: data.userId,
+        streamId: data.streamId,
+        initialized: data.initialized,
+        // username
+        username: data.username,
+        isUsernameConfirmed: data.isUsernameConfirmed,
+        isUsernameEncrypted: data.isUsernameEncrypted,
+        // displayName
+        displayName: data.displayName,
+        isDisplayNameEncrypted: data.isDisplayNameEncrypted,
+        // ensAddress
+        ensAddress: data.ensAddress,
+        // nft
+        nft: data.nft,
+        // membership
+        membership: data.membership,
+        ...rest,
+    };
+};
+//# sourceMappingURL=useMember.js.map

package/dist/esm/useMember.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMember.js","sourceRoot":"","sources":["../../src/useMember.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACrB,KAA2C,EAC3C,MAAgD,EAClD,EAAE;IACA,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAG,OAAO,CAClB,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAC7D,CAAC,IAAI,EAAE,KAAK,CAAC,CAChB,CAAA;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvD,OAAO;QACH,gHAAgH;QAChH,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW;QACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,cAAc;QACd,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;QACnD,aAAa;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM;QACN,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,aAAa;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,IAAI;KACV,CAAA;AACL,CAAC,CAAA"}

package/dist/esm/useMemberList.js

@@ -0,0 +1,17 @@
+import { useMemo } from 'react';
+import { useObservable } from './useObservable';
+import { useSyncAgent } from './useSyncAgent';
+import { getRoom } from './utils';
+/**
+ * Hook to get the members userIds of a Space, GDM, Channel, or DM.
+ * Used with useMember to get data from a specific member.
+ * @param streamId - The id of the stream to get the members of.
+ * @param config - Configuration options for the observable.
+ * @returns The MembersModel of the stream, containing the userIds of the members.
+ */
+export const useMemberList = (streamId, config) => {
+    const sync = useSyncAgent();
+    const members = useMemo(() => getRoom(sync, streamId).members, [sync, streamId]);
+    return useObservable(members, config);
+};
+//# sourceMappingURL=useMemberList.js.map

package/dist/esm/useMemberList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMemberList.js","sourceRoot":"","sources":["../../src/useMemberList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAyB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CACzB,QAAgB,EAChB,MAAgD,EAClD,EAAE;IACA,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;IAChF,OAAO,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AACzC,CAAC,CAAA"}

package/dist/esm/useMyMember.js

@@ -0,0 +1,71 @@
+import { useMemo } from 'react';
+import { useAction } from './internals/useAction';
+import { useObservable } from './useObservable';
+import { useSyncAgent } from './useSyncAgent';
+import { getRoom } from './utils';
+const getMyMember = (sync, streamId) => getRoom(sync, streamId).members.myself;
+/**
+ * Hook to get the data of the current user in a stream.
+ * @param streamId - The id of the stream to get the current user of.
+ * @param config - Configuration options for the observable.
+ * @returns The MemberModel of the current user.
+ */
+export const useMyMember = (streamId, config) => {
+    const sync = useSyncAgent();
+    const myself = useMemo(() => getMyMember(sync, streamId), [sync, streamId]);
+    const { data } = useObservable(myself.member, config);
+    return {
+        ...data,
+    };
+};
+/**
+ * Hook to set the ENS address of the current user in a stream.
+ * You should be validating if the ENS address belongs to the user before setting it.
+ * @param streamId - The id of the stream to set the ENS address of.
+ * @param config - Configuration options for the action.
+ * @returns The `setEnsAddress` action and its loading state.
+ */
+export const useSetEnsAddress = (streamId, config) => {
+    const sync = useSyncAgent();
+    const member = useMemo(() => getMyMember(sync, streamId), [sync, streamId]);
+    const { action: setEnsAddress, ...rest } = useAction(member, 'setEnsAddress', config);
+    return { setEnsAddress, ...rest };
+};
+/**
+ * Hook to set the username of the current user in a stream.
+ * @param streamId - The id of the stream to set the username of.
+ * @param config - Configuration options for the action.
+ * @returns The `setUsername` action and its loading state.
+ */
+export const useSetUsername = (streamId, config) => {
+    const sync = useSyncAgent();
+    const member = useMemo(() => getMyMember(sync, streamId), [sync, streamId]);
+    const { action: setUsername, ...rest } = useAction(member, 'setUsername', config);
+    return { setUsername, ...rest };
+};
+/**
+ * Hook to set the display name of the current user in a stream.
+ * @param streamId - The id of the stream to set the display name of.
+ * @param config - Configuration options for the action.
+ * @returns The `setDisplayName` action and its loading state.
+ */
+export const useSetDisplayName = (streamId, config) => {
+    const sync = useSyncAgent();
+    const member = useMemo(() => getMyMember(sync, streamId), [sync, streamId]);
+    const { action: setDisplayName, ...rest } = useAction(member, 'setDisplayName', config);
+    return { setDisplayName, ...rest };
+};
+/**
+ * Hook to set the NFT of the current user in a stream.
+ * You should be validating if the NFT belongs to the user before setting it.
+ * @param streamId - The id of the stream to set the NFT of.
+ * @param config - Configuration options for the action.
+ * @returns The `setNft` action and its loading state.
+ */
+export const useSetNft = (streamId, config) => {
+    const sync = useSyncAgent();
+    const member = useMemo(() => getMyMember(sync, streamId), [sync, streamId]);
+    const { action: setNft, ...rest } = useAction(member, 'setNft', config);
+    return { setNft, ...rest };
+};
+//# sourceMappingURL=useMyMember.js.map

package/dist/esm/useMyMember.js.map

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

package/dist/esm/useObservable.js

@@ -0,0 +1,56 @@
+'use client';
+import { useCallback, useEffect, useMemo, useSyncExternalStore } from 'react';
+import { isPersistedModel } from './internals/utils';
+/**
+ * This hook subscribes to an observable and returns the value of the observable.
+ * @param observable - The observable to subscribe to.
+ * @param config - Configuration options for the observable.
+ * @returns The value of the observable.
+ */
+export function useObservable(observable, config) {
+    const opts = useMemo(() => ({ fireImmediately: true, ...config }), [config]);
+    const subscribeFn = useCallback((subFn) => {
+        return observable.subscribe(subFn, {
+            fireImediately: opts?.fireImmediately,
+        });
+    }, [observable, opts?.fireImmediately]);
+    const value = useSyncExternalStore(subscribeFn, () => observable.value);
+    useEffect(() => {
+        if (isPersistedModel(value)) {
+            if (value.status === 'loaded') {
+                opts.onUpdate?.(value.data);
+            }
+            if (value.status === 'error') {
+                opts.onError?.(value.error);
+            }
+        }
+        else {
+            opts.onUpdate?.(value);
+        }
+    }, [opts, value]);
+    const data = useMemo(() => {
+        if (isPersistedModel(value)) {
+            const { data, status } = value;
+            return {
+                data: data,
+                error: status === 'error' ? value.error : undefined,
+                status,
+                isLoading: status === 'loading',
+                isError: status === 'error',
+                isLoaded: status === 'loaded',
+            };
+        }
+        else {
+            return {
+                data: value,
+                error: undefined,
+                status: 'loaded',
+                isLoading: false,
+                isError: false,
+                isLoaded: true,
+            };
+        }
+    }, [value]);
+    return data;
+}
+//# sourceMappingURL=useObservable.js.map

package/dist/esm/useObservable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObservable.js","sourceRoot":"","sources":["../../src/useObservable.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAiEpD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAG3B,UAA6B,EAAE,MAAyC;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAE5E,MAAM,WAAW,GAAG,WAAW,CAC3B,CAAC,KAAiB,EAAE,EAAE;QAClB,OAAO,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE;YAC/B,cAAc,EAAE,IAAI,EAAE,eAAe;SACxC,CAAC,CAAA;IACN,CAAC,EACD,CAAC,UAAU,EAAE,IAAI,EAAE,eAAe,CAAC,CACtC,CAAA;IAED,MAAM,KAAK,GAAG,oBAAoB,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAEvE,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC/B,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAC/B,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAA;QAC1B,CAAC;IACL,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAEjB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;QACtB,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;YAC9B,OAAO;gBACH,IAAI,EAAE,IAAuB;gBAC7B,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBACnD,MAAM;gBACN,SAAS,EAAE,MAAM,KAAK,SAAS;gBAC/B,OAAO,EAAE,MAAM,KAAK,OAAO;gBAC3B,QAAQ,EAAE,MAAM,KAAK,QAAQ;aAChC,CAAA;QACL,CAAC;aAAM,CAAC;YACJ,OAAO;gBACH,IAAI,EAAE,KAAwB;gBAC9B,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,QAAiB;gBACzB,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI;aACjB,CAAA;QACL,CAAC;IACL,CAAC,EAAE,CAAC,KAAK,CAAC,CAAiC,CAAA;IAE3C,OAAO,IAAI,CAAA;AACf,CAAC"}

package/dist/esm/useReactions.js

@@ -0,0 +1,17 @@
+import { Space, assert } from '@towns-labs/sdk';
+import { useSyncAgent } from './useSyncAgent';
+import { useObservable } from './useObservable';
+import { getRoom } from './utils';
+/**
+ * Hook to get the reactions of a specific stream.
+ * @param streamId - The id of the stream to get the reactions of.
+ * @param config - Configuration options for the observable.
+ * @returns The reactions of the stream as a map from the message eventId to the reaction.
+ */
+export const useReactions = (streamId, config) => {
+    const sync = useSyncAgent();
+    const room = getRoom(sync, streamId);
+    assert(!(room instanceof Space), 'Space does not have reactions');
+    return useObservable(room.timeline.reactions, config);
+};
+//# sourceMappingURL=useReactions.js.map

package/dist/esm/useReactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReactions.js","sourceRoot":"","sources":["../../src/useReactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAyB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CACxB,QAAgB,EAChB,MAAoE,EACtE,EAAE;IACA,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACpC,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,+BAA+B,CAAC,CAAA;IAEjE,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AACzD,CAAC,CAAA"}

package/dist/esm/useRedact.js

@@ -0,0 +1,43 @@
+'use client';
+import { Space, assert } from '@towns-labs/sdk';
+import { useAction } from './internals/useAction';
+import { useSyncAgent } from './useSyncAgent';
+import { getRoom } from './utils';
+/**
+ * Hook to redact your own message in a channel stream.
+ * @example
+ *
+ * ### Redact a message
+ *
+ * You can use `redact` to redact a message in a stream.
+ * ```ts
+ * import { useRedact } from '@towns-labs/react-sdk'
+ *
+ * const { redact } = useRedact(streamId)
+ * redact({ eventId: messageEventId })
+ * ```
+ *
+ * ### Redact a message reaction
+ *
+ * You can also use `redact` to redact a message reaction in a stream.
+ * ```ts
+ * import { useRedact } from '@towns-labs/react-sdk'
+ *
+ * const { redact } = useRedact(streamId)
+ * redact({ eventId: reactionEventId })
+ * ```
+ * @param streamId - The id of the stream to redact the message in.
+ * @param config - Configuration options for the action.
+ * @returns The `redact` action and its loading state.
+ */
+export const useRedact = (streamId, config) => {
+    const sync = useSyncAgent();
+    const room = getRoom(sync, streamId);
+    assert(!(room instanceof Space), 'Space does not have reactions');
+    const { action: redact, ...rest } = useAction(room, 'redact', config);
+    return {
+        redact,
+        ...rest,
+    };
+};
+//# sourceMappingURL=useRedact.js.map

package/dist/esm/useRedact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRedact.js","sourceRoot":"","sources":["../../src/useRedact.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAqB,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,MAAwC,EAAE,EAAE;IACpF,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACpC,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,+BAA+B,CAAC,CAAA;IACjE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IAErE,OAAO;QACH,MAAM;QACN,GAAG,IAAI;KACV,CAAA;AACL,CAAC,CAAA"}

package/dist/esm/useScrollback.js

@@ -0,0 +1,27 @@
+'use client';
+import { Space, assert } from '@towns-labs/sdk';
+import { useMemo } from 'react';
+import { useAction } from './internals/useAction';
+import { useSyncAgent } from './useSyncAgent';
+import { getRoom } from './utils';
+/**
+ * Hook to get the scrollback action for a stream.
+ *
+ * Scrollback is the action of getting miniblocks from a stream before a certain point in time.
+ * Getting miniblocks means that new events that are possibly new messages, reactions and so on are fetched.
+ *
+ * @param streamId - The id of the stream to get the scrollback action for.
+ * @param config - Configuration options for the action.
+ * @returns The `scrollback` action and its loading state.
+ */
+export const useScrollback = (streamId, config) => {
+    const sync = useSyncAgent();
+    const room = useMemo(() => getRoom(sync, streamId), [sync, streamId]);
+    assert(!(room instanceof Space), 'cant scrollback spaces');
+    const { action: scrollback, ...rest } = useAction(room.timeline, 'scrollback', config);
+    return {
+        scrollback,
+        ...rest,
+    };
+};
+//# sourceMappingURL=useScrollback.js.map

package/dist/esm/useScrollback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollback.js","sourceRoot":"","sources":["../../src/useScrollback.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAwB,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAqB,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CACzB,QAAgB,EAChB,MAAoD,EACtD,EAAE;IACA,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;IACrE,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAA;IAC1D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;IACtF,OAAO;QACH,UAAU;QACV,GAAG,IAAI;KACV,CAAA;AACL,CAAC,CAAA"}

package/dist/esm/useSendMessage.js

@@ -0,0 +1,31 @@
+'use client';
+import { Space, assert } from '@towns-labs/sdk';
+import { useMemo } from 'react';
+import { useAction } from './internals/useAction';
+import { useSyncAgent } from './useSyncAgent';
+import { getRoom } from './utils';
+/**
+ * Hook to send a message to a stream. Can be used to send a message to a channel or a dm/group dm.
+ * @param streamId - The id of the stream to send the message to.
+ * @param config - Configuration options for the action.
+ * @returns The sendMessage action and the status of the action.
+ */
+export const useSendMessage = (streamId, 
+// TODO: now that we're using runtime check for room type, Gdm/Dm will have the same config as Channel.
+// Its not a problem, both should be the same, but we need more abstractions around this on the SyncAgent
+config) => {
+    const sync = useSyncAgent();
+    const room = useMemo(() => getRoom(sync, streamId), [streamId, sync]);
+    assert(!(room instanceof Space), 'room cant be a space');
+    const { action: sendMessage, ...rest } = useAction(room, 'sendMessage', config);
+    return {
+        /** Sends a message to the stream.
+         * @param message - The message to send.
+         * @param options - Additional options for the message.
+         * @returns The event id of the message.
+         */
+        sendMessage,
+        ...rest,
+    };
+};
+//# sourceMappingURL=useSendMessage.js.map

package/dist/esm/useSendMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSendMessage.js","sourceRoot":"","sources":["../../src/useSendMessage.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAW,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAqB,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC1B,QAAgB;AAChB,uGAAuG;AACvG,yGAAyG;AACzG,MAA6C,EAC/C,EAAE;IACA,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACrE,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,sBAAsB,CAAC,CAAA;IACxD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,CAAA;IAE/E,OAAO;QACH;;;;WAIG;QACH,WAAW;QACX,GAAG,IAAI;KACV,CAAA;AACL,CAAC,CAAA"}

package/dist/esm/useSendReaction.js

@@ -0,0 +1,33 @@
+'use client';
+import { Space, assert } from '@towns-labs/sdk';
+import { useAction } from './internals/useAction';
+import { useSyncAgent } from './useSyncAgent';
+import { getRoom } from './utils';
+/**
+ * Hook to send a reaction to a message in a stream.
+ *
+ * Reaction can be any string value, including emojis.
+ *
+ * @example
+ * ```ts
+ * import { useSendReaction } from '@towns-labs/react-sdk'
+ *
+ * const { sendReaction } = useSendReaction('stream-id')
+ * sendReaction(messageEventId, '🔥')
+ * ```
+ *
+ * @param streamId - The id of the stream to send the reaction to.
+ * @param config - Configuration options for the action.
+ * @returns The `sendReaction` action and its loading state.
+ */
+export const useSendReaction = (streamId, config) => {
+    const sync = useSyncAgent();
+    const room = getRoom(sync, streamId);
+    assert(!(room instanceof Space), 'Space does not have reactions');
+    const { action: sendReaction, ...rest } = useAction(room, 'sendReaction', config);
+    return {
+        sendReaction,
+        ...rest,
+    };
+};
+//# sourceMappingURL=useSendReaction.js.map

package/dist/esm/useSendReaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSendReaction.js","sourceRoot":"","sources":["../../src/useSendReaction.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAqB,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC3B,QAAgB,EAChB,MAA8C,EAChD,EAAE;IACA,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACpC,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,+BAA+B,CAAC,CAAA;IAEjE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,CAAA;IAEjF,OAAO;QACH,YAAY;QACZ,GAAG,IAAI;KACV,CAAA;AACL,CAAC,CAAA"}

package/dist/esm/useSpace.js

@@ -0,0 +1,28 @@
+'use client';
+import { useMemo } from 'react';
+import { useSyncAgent } from './useSyncAgent';
+import { useObservable } from './useObservable';
+/**
+ * Hook to get data about a space.
+ * You can use this hook to get space metadata and ids of channels in the space.
+ * @param spaceId - The id of the space to get data about.
+ * @param config - Configuration options for the observable.
+ * @returns The SpaceModel data.
+ * @example
+ * You can use this hook to display the data about a space:
+ *
+ * ```tsx
+ * import { useSpace } from '@towns-labs/react-sdk'
+ *
+ * const Space = ({ spaceId }: { spaceId: string }) => {
+ *     const { data: space } = useSpace(spaceId)
+ *     return <div>{space.metadata?.name || 'Unnamed Space'}</div>
+ * }
+ * ```
+ */
+export const useSpace = (spaceId, config) => {
+    const sync = useSyncAgent();
+    const observable = useMemo(() => sync.spaces.getSpace(spaceId), [sync, spaceId]);
+    return useObservable(observable, config);
+};
+//# sourceMappingURL=useSpace.js.map

package/dist/esm/useSpace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSpace.js","sourceRoot":"","sources":["../../src/useSpace.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAyB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,MAA+C,EAAE,EAAE;IACzF,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAChF,OAAO,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;AAC5C,CAAC,CAAA"}

package/dist/esm/useSyncAgent.jsx

@@ -0,0 +1,20 @@
+'use client';
+import { useTownsSync } from './internals/useTownsSync';
+/**
+ * Hook to get the sync agent from the TownsSyncProvider.
+ *
+ * You can use it to interact with the sync agent for more advanced usage.
+ *
+ * Throws an error if no sync agent is set in the TownsSyncProvider.
+ *
+ * @returns The sync agent in use, set in TownsSyncProvider.
+ * @throws If no sync agent is set, use TownsSyncProvider to set one or use useAgentConnection to check if connected.
+ */
+export const useSyncAgent = () => {
+    const towns = useTownsSync();
+    if (!towns?.syncAgent) {
+        throw new Error('No SyncAgent set, use TownsSyncProvider to set one or use useAgentConnection to check if connected');
+    }
+    return towns.syncAgent;
+};
+//# sourceMappingURL=useSyncAgent.jsx.map

package/dist/esm/useSyncAgent.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSyncAgent.jsx","sourceRoot":"","sources":["../../src/useSyncAgent.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC7B,MAAM,KAAK,GAAG,YAAY,EAAE,CAAA;IAE5B,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACX,oGAAoG,CACvG,CAAA;IACL,CAAC;IAED,OAAO,KAAK,CAAC,SAAS,CAAA;AAC1B,CAAC,CAAA"}

package/dist/esm/useThreads.js

@@ -0,0 +1,19 @@
+import { useMemo } from 'react';
+import { Space, assert } from '@towns-labs/sdk';
+import { useSyncAgent } from './useSyncAgent';
+import { useObservable } from './useObservable';
+import { getRoom } from './utils';
+/**
+ * Hook to get the threads from a stream.
+ *
+ * @param streamId - The id of the stream to get the threads from.
+ * @param config - Configuration options for the observable.
+ * @returns The threads of the stream as a map from the message eventId to a thread.
+ */
+export const useThreads = (streamId, config) => {
+    const sync = useSyncAgent();
+    const room = useMemo(() => getRoom(sync, streamId), [streamId, sync]);
+    assert(!(room instanceof Space), 'room cant be a space');
+    return useObservable(room.timeline.threads, config);
+};
+//# sourceMappingURL=useThreads.js.map

package/dist/esm/useThreads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThreads.js","sourceRoot":"","sources":["../../src/useThreads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAyB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACtB,QAAgB,EAChB,MAAsD,EACxD,EAAE;IACA,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACrE,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,sBAAsB,CAAC,CAAA;IACxD,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AACvD,CAAC,CAAA"}

package/dist/esm/useTimeline.js

@@ -0,0 +1,32 @@
+import { Space, assert } from '@towns-labs/sdk';
+import { useMemo } from 'react';
+import { useObservable } from './useObservable';
+import { getRoom } from './utils';
+import { useSyncAgent } from './useSyncAgent';
+/**
+ * Hook to get the timeline events from a stream.
+ *
+ * You can use the `useTimeline` hook to get the timeline events from a channel stream, dm stream or group dm stream
+ *
+ * @example
+ * ```ts
+ * import { useTimeline } from '@towns-labs/react-sdk'
+ * import { RiverTimelineEvent } from '@towns-labs/sdk'
+ *
+ * const { data: events } = useTimeline(streamId)
+ *
+ * // You can filter the events by their kind
+ * const messages = events.filter((event) => event.content?.kind === RiverTimelineEvent.ChannelMessage)
+ * ```
+ *
+ * @param streamId - The id of the stream to get the timeline events from.
+ * @param config - Configuration options for the observable.
+ * @returns The timeline events of the stream as an observable.
+ */
+export const useTimeline = (streamId, config) => {
+    const sync = useSyncAgent();
+    const room = useMemo(() => getRoom(sync, streamId), [streamId, sync]);
+    assert(!(room instanceof Space), 'Space does not have timeline');
+    return useObservable(room.timeline.events, config);
+};
+//# sourceMappingURL=useTimeline.js.map

package/dist/esm/useTimeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeline.js","sourceRoot":"","sources":["../../src/useTimeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAsB,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAyB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACvB,QAAgB,EAChB,MAAyD,EAC3D,EAAE;IACA,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;IACrE,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,8BAA8B,CAAC,CAAA;IAChE,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACtD,CAAC,CAAA"}

package/dist/esm/useTowns.js

@@ -0,0 +1,16 @@
+'use client';
+import { useObservable } from './useObservable';
+import { useSyncAgent } from './useSyncAgent';
+/**
+ * Hook to get an observable from the sync agent.
+ *
+ * An alternative of our premade hooks, allowing the creation of custom abstractions.
+ * @param selector - A selector function to get a observable from the sync agent.
+ * @param config - Configuration options for the observable.
+ * @returns The data from the selected observable.
+ */
+export function useTowns(selector, config) {
+    const syncAgent = useSyncAgent();
+    return useObservable(selector(syncAgent.observables), config);
+}
+//# sourceMappingURL=useTowns.js.map

package/dist/esm/useTowns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTowns.js","sourceRoot":"","sources":["../../src/useTowns.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAyB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAI7C;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACpB,QAA+C,EAC/C,MAAqC;IAErC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAChC,OAAO,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAA;AACjE,CAAC"}

package/dist/esm/useTownsAuthStatus.js

@@ -0,0 +1,30 @@
+'use client';
+import { AuthStatus } from '@towns-labs/sdk';
+import { useTowns } from './useTowns';
+/**
+ * Hook to get the auth status of the user connection with the Towns network.
+ * @param config - Configuration options for the observable.
+ * @returns An object containing the current AuthStatus status and boolean flags for each possible status.
+ */
+export const useTownsAuthStatus = (config) => {
+    const { data: status } = useTowns((s) => s.riverAuthStatus, config);
+    return {
+        /** The current AuthStatus of the user connection with the Towns network. */
+        status,
+        /** Whether the user connection with the Towns network is initializing. */
+        isInitializing: status === AuthStatus.Initializing,
+        /** Whether the user connection with the Towns network is evaluating credentials. */
+        isEvaluatingCredentials: status === AuthStatus.EvaluatingCredentials,
+        /** Whether the user connection with the Towns network is credentialed. */
+        isCredentialed: status === AuthStatus.Credentialed,
+        /** Whether the user connection with the Towns network is connecting to Towns. */
+        isConnectingToTowns: status === AuthStatus.ConnectingToRiver,
+        /** Whether the user connection with the Towns network is connected to Towns. */
+        isConnectedToTowns: status === AuthStatus.ConnectedToRiver,
+        /** Whether the user connection with the Towns network is disconnected. */
+        isDisconnected: status === AuthStatus.Disconnected,
+        /** Whether the user connection with the Towns network is in an error state. */
+        isError: status === AuthStatus.Error,
+    };
+};
+//# sourceMappingURL=useTownsAuthStatus.js.map

package/dist/esm/useTownsAuthStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTownsAuthStatus.js","sourceRoot":"","sources":["../../src/useTownsAuthStatus.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGrC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAoD,EAAE,EAAE;IACvF,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;IACnE,OAAO;QACH,4EAA4E;QAC5E,MAAM;QACN,0EAA0E;QAC1E,cAAc,EAAE,MAAM,KAAK,UAAU,CAAC,YAAY;QAClD,oFAAoF;QACpF,uBAAuB,EAAE,MAAM,KAAK,UAAU,CAAC,qBAAqB;QACpE,0EAA0E;QAC1E,cAAc,EAAE,MAAM,KAAK,UAAU,CAAC,YAAY;QAClD,iFAAiF;QACjF,mBAAmB,EAAE,MAAM,KAAK,UAAU,CAAC,iBAAiB;QAC5D,gFAAgF;QAChF,kBAAkB,EAAE,MAAM,KAAK,UAAU,CAAC,gBAAgB;QAC1D,0EAA0E;QAC1E,cAAc,EAAE,MAAM,KAAK,UAAU,CAAC,YAAY;QAClD,+EAA+E;QAC/E,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC,KAAK;KACvC,CAAA;AACL,CAAC,CAAA"}