@stream-io/feeds-client 0.1.4 → 0.1.6

package/@react-bindings/hooks/client-state-hooks/index.ts

@@ -0,0 +1,2 @@
+export * from './useClientConnectedUser';
+export * from './useWsConnectionState';

package/@react-bindings/hooks/feed-state-hooks/index.ts

@@ -0,0 +1,7 @@
+export * from './useFeedActivities';
+export * from './useComments';
+export * from './useOwnCapabilities';
+export * from './useFollowers';
+export * from './useFollowing';
+export * from './useFeedMetadata';
+export * from './useOwnFollows';

package/@react-bindings/hooks/internal/index.ts

@@ -0,0 +1 @@
+export * from './useStableCallback';

package/@react-bindings/hooks/util/index.ts

@@ -0,0 +1 @@
+export * from './useReactionActions'

package/@react-bindings/index.ts

@@ -1,15 +1,18 @@
 // Hooks
 
-export * from './hooks/useComments';
 export * from './hooks/useStateStore';
-export * from './hooks/useOwnCapabilities';
-export * from './hooks/clientStateHooks';
 export * from './hooks/useCreateFeedsClient';
 
+export * from './hooks/client-state-hooks';
+export * from './hooks/feed-state-hooks';
+export * from './hooks/util';
+
 // Contexts
 
 export * from './contexts/StreamFeedsContext';
+export * from './contexts/StreamFeedContext';
 
 // Wrappers
 
 export * from './wrappers/StreamFeeds';
+export * from './wrappers/StreamFeed';

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [0.1.6](https://github.com/GetStream/stream-feeds-js/compare/@stream-io/feeds-client-0.1.5...@stream-io/feeds-client-0.1.6) (2025-07-22)
+
+
+* Run tests on CI ([#68](https://github.com/GetStream/stream-feeds-js/issues/68)) ([89b0a4b](https://github.com/GetStream/stream-feeds-js/commit/89b0a4bbce14af563380c17c73188e7e6f688e65))
+
+
+### Features
+
+* following and user screens ([#71](https://github.com/GetStream/stream-feeds-js/issues/71)) ([7123f0a](https://github.com/GetStream/stream-feeds-js/commit/7123f0a2472ca59da697326e99253ebcbc7db147))
+
+
+### Bug Fixes
+
+* bookmark is identified by activity id and folder id ([#70](https://github.com/GetStream/stream-feeds-js/issues/70)) ([97ee937](https://github.com/GetStream/stream-feeds-js/commit/97ee937a951de0d76ebf88a6083d3c67d4cef762))
+
+## [0.1.5](https://github.com/GetStream/stream-feeds-js/compare/@stream-io/feeds-client-0.1.4...@stream-io/feeds-client-0.1.5) (2025-07-18)
+
+
+### Features
+
+* add loadNextPage to useComments ([#57](https://github.com/GetStream/stream-feeds-js/issues/57)) ([fef823c](https://github.com/GetStream/stream-feeds-js/commit/fef823ceeb1d181f44607821cb46ec2458e199f3))
+* add loadNextPageMembers ([#56](https://github.com/GetStream/stream-feeds-js/issues/56)) ([104dad0](https://github.com/GetStream/stream-feeds-js/commit/104dad0c1440ad26b41b76e1402ef0635e4358ac))
+* add useFollowers & useFollowing ([#55](https://github.com/GetStream/stream-feeds-js/issues/55)) ([95bef04](https://github.com/GetStream/stream-feeds-js/commit/95bef04d2d921574fd1461cca0965963bc245910))
+* feed context, file uploads and reactions ([#66](https://github.com/GetStream/stream-feeds-js/issues/66)) ([886123a](https://github.com/GetStream/stream-feeds-js/commit/886123aeb243c04d9ae82112634e826518e61089))
+
+
+### Bug Fixes
+
+* post useComments/useFollows merge fixes ([#64](https://github.com/GetStream/stream-feeds-js/issues/64)) ([2da2670](https://github.com/GetStream/stream-feeds-js/commit/2da2670d9575aba8b3f22d4cc019ae911a92edfb))
+* replace `eol` with `checkHasAnotherPage` ([#67](https://github.com/GetStream/stream-feeds-js/issues/67)) ([f490e1f](https://github.com/GetStream/stream-feeds-js/commit/f490e1f16775adac46bccc979d5d0d2ce825f859))
+
 ## [0.1.4](https://github.com/GetStream/stream-feeds-js/compare/@stream-io/feeds-client-0.1.3...@stream-io/feeds-client-0.1.4) (2025-07-16)
 
 

package/dist/@react-bindings/contexts/StreamFeedContext.d.ts

@@ -0,0 +1,12 @@
+import type { Feed } from '../../src/Feed';
+export declare const StreamFeedContext: import("react").Context<Feed | undefined>;
+/**
+ * The props for the StreamFeedProvider component.
+ */
+export type StreamFeedContextProps = {
+    feed: Feed;
+};
+/**
+ * Hook to access the nearest Feed instance.
+ */
+export declare const useFeedContext: () => Feed | undefined;

package/dist/@react-bindings/hooks/client-state-hooks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './useClientConnectedUser';
+export * from './useWsConnectionState';

package/dist/@react-bindings/hooks/client-state-hooks/useClientConnectedUser.d.ts

@@ -0,0 +1,4 @@
+/**
+ * A React hook that returns the currently connected user on a `FeedsClient` instance and null otherwise.
+ */
+export declare const useClientConnectedUser: () => import("../../..").OwnUser | undefined;

package/dist/@react-bindings/hooks/client-state-hooks/useWsConnectionState.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A React hook that returns the websocket connection state of `FeedsClient`.
+ */
+export declare const useWsConnectionState: () => {
+    is_healthy: boolean | undefined;
+};

package/dist/@react-bindings/hooks/feed-state-hooks/index.d.ts

@@ -0,0 +1,7 @@
+export * from './useFeedActivities';
+export * from './useComments';
+export * from './useOwnCapabilities';
+export * from './useFollowers';
+export * from './useFollowing';
+export * from './useFeedMetadata';
+export * from './useOwnFollows';

package/dist/@react-bindings/hooks/feed-state-hooks/useComments.d.ts

@@ -0,0 +1,19 @@
+import type { ActivityResponse, CommentResponse } from '../../../src/gen/models';
+import type { CommentParent } from '../../../src/types';
+import { Feed, FeedState } from '../../../src/Feed';
+type UseCommentsReturnType<T extends ActivityResponse | CommentResponse> = {
+    comments: NonNullable<FeedState['comments_by_entity_id'][T['id']]>['comments'];
+    comments_pagination: NonNullable<FeedState['comments_by_entity_id'][T['id']]>['pagination'];
+    has_next_page: boolean;
+    is_loading_next_page: boolean;
+    loadNextPage: (request?: T extends CommentResponse ? Parameters<Feed['loadNextPageCommentReplies']>[1] : Parameters<Feed['loadNextPageActivityComments']>[1]) => Promise<void>;
+};
+export declare function useComments<T extends CommentParent>(_: {
+    feed: Feed;
+    parent: T;
+}): UseCommentsReturnType<T>;
+export declare function useComments<T extends CommentParent>(_: {
+    feed?: Feed;
+    parent: T;
+}): UseCommentsReturnType<T> | undefined;
+export {};

package/dist/@react-bindings/hooks/feed-state-hooks/useFeedActivities.d.ts

@@ -0,0 +1,11 @@
+import { Feed } from '../../../src/Feed';
+/**
+ * A React hook that returns a reactive object containing the current activities,
+ * loading state and whether there is a next page to paginate to or not.
+ */
+export declare const useFeedActivities: (feedFromProps?: Feed) => {
+    loadNextPage: import("../internal").StableCallback<[], Promise<void>>;
+    is_loading?: boolean | undefined;
+    has_next_page?: boolean | undefined;
+    activities?: import("../../..").ActivityResponse[] | undefined;
+};

package/dist/@react-bindings/hooks/feed-state-hooks/useFeedMetadata.d.ts

@@ -0,0 +1,12 @@
+import { Feed } from '../../../src/Feed';
+/**
+ * A React hook that returns a reactive object containing some often used
+ * metadata for a feed.
+ */
+export declare const useFeedMetadata: (feedFromProps?: Feed) => {
+    created_by: import("../../..").UserResponse | undefined;
+    follower_count: number;
+    following_count: number;
+    created_at: Date | undefined;
+    updated_at: Date | undefined;
+} | undefined;

package/dist/@react-bindings/hooks/feed-state-hooks/useFollowers.d.ts

@@ -0,0 +1,16 @@
+import { Feed, FeedState } from '../../../src/Feed';
+declare const selector: ({ follower_count, followers, followers_pagination, }: FeedState) => {
+    follower_count: number | undefined;
+    followers: import("../../..").FollowResponse[] | undefined;
+    followers_pagination: (import("../../..").PagerResponse & import("../../..").LoadingStates & {
+        sort?: import("../../..").SortParamRequest[];
+    }) | undefined;
+};
+type UseFollowersReturnType = ReturnType<typeof selector> & {
+    is_loading_next_page: boolean;
+    has_next_page: boolean;
+    loadNextPage: (...options: Parameters<Feed['loadNextPageFollowers']>) => Promise<void>;
+};
+export declare function useFollowers(feed: Feed): UseFollowersReturnType;
+export declare function useFollowers(feed?: Feed): UseFollowersReturnType | undefined;
+export {};

package/dist/@react-bindings/hooks/feed-state-hooks/useFollowing.d.ts

@@ -0,0 +1,16 @@
+import { Feed, FeedState } from '../../../src/Feed';
+declare const selector: ({ following_count, following, following_pagination, }: FeedState) => {
+    following_count: number | undefined;
+    following: import("../../..").FollowResponse[] | undefined;
+    following_pagination: (import("../../..").PagerResponse & import("../../..").LoadingStates & {
+        sort?: import("../../..").SortParamRequest[];
+    }) | undefined;
+};
+type UseFollowingReturnType = ReturnType<typeof selector> & {
+    is_loading_next_page: boolean;
+    has_next_page: boolean;
+    loadNextPage: (...options: Parameters<Feed['loadNextPageFollowers']>) => Promise<void>;
+};
+export declare function useFollowing(feed: Feed): UseFollowingReturnType;
+export declare function useFollowing(feed?: Feed): UseFollowingReturnType | undefined;
+export {};

package/dist/@react-bindings/hooks/feed-state-hooks/useOwnCapabilities.d.ts

@@ -0,0 +1,33 @@
+import { Feed } from '../../../src/Feed';
+export declare const useOwnCapabilities: (feedFromProps?: Feed) => {
+    can_add_activity: boolean;
+    can_add_activity_reaction: boolean;
+    can_add_comment: boolean;
+    can_add_comment_reaction: boolean;
+    can_bookmark_activity: boolean;
+    can_create_feed: boolean;
+    can_delete_bookmark: boolean;
+    can_delete_comment: boolean;
+    can_delete_feed: boolean;
+    can_edit_bookmark: boolean;
+    can_follow: boolean;
+    can_remove_activity: boolean;
+    can_remove_activity_reaction: boolean;
+    can_remove_comment_reaction: boolean;
+    can_unfollow: boolean;
+    can_update_feed: boolean;
+    can_invite_feed: boolean;
+    can_join_feed: boolean;
+    can_leave_feed: boolean;
+    can_manage_feed_group: boolean;
+    can_mark_activity: boolean;
+    can_pin_activity: boolean;
+    can_query_feed_members: boolean;
+    can_query_follows: boolean;
+    can_read_activities: boolean;
+    can_read_feed: boolean;
+    can_update_activity: boolean;
+    can_update_comment: boolean;
+    can_update_feed_followers: boolean;
+    can_update_feed_members: boolean;
+};

package/dist/@react-bindings/hooks/feed-state-hooks/useOwnFollows.d.ts

@@ -0,0 +1,8 @@
+import { Feed } from '../../../src/Feed';
+/**
+ * A React hook that returns a reactive array of feeds that the current user
+ * owns and are following the respective feed that we are observing.
+ */
+export declare const useOwnFollows: (feedFromProps?: Feed) => {
+    own_follows: import("../../..").FollowResponse[] | undefined;
+} | undefined;

package/dist/@react-bindings/hooks/internal/index.d.ts

@@ -0,0 +1 @@
+export * from './useStableCallback';

package/dist/@react-bindings/hooks/internal/useStableCallback.d.ts

@@ -0,0 +1,25 @@
+export type StableCallback<A extends unknown[], R> = (...args: A) => R;
+/**
+ * A utility hook implementing a stable callback. It takes in an unstable method that
+ * is supposed to be invoked somewhere deeper in the DOM tree without making it
+ * change its reference every time the parent component rerenders. It will also return
+ * the value of the callback if it does return one.
+ * A common use-case would be having a function whose invocation depends on state
+ * somewhere high up in the DOM tree and wanting to use the same function deeper
+ * down, for example in a leaf node and simply using useCallback results in
+ * cascading dependency hell. If we wrap it in useStableCallback, we would be able
+ * to:
+ * - Use the same function as a dependency of another hook (since it is stable)
+ * - Still invoke it and get the latest state
+ *
+ * **Caveats:**
+ * - Never wrap a function that is supposed to return a React.ReactElement in
+ *   useStableCallback, since React will not know that the DOM needs to be updated
+ *   whenever the callback value changes (for example, renderItem from FlatList must
+ *   never be wrapped in this hook)
+ * - Always prefer using a standard useCallback/stable function wherever possible
+ *   (the purpose of useStableCallback is to bridge the gap between top level contexts
+ *   and cascading rereders in downstream components - **not** as an escape hatch)
+ * @param callback - the callback we want to stabilize
+ */
+export declare const useStableCallback: <A extends unknown[], R>(callback: StableCallback<A, R>) => StableCallback<A, R>;

package/dist/@react-bindings/hooks/util/index.d.ts

@@ -0,0 +1 @@
+export * from './useReactionActions';

package/dist/@react-bindings/hooks/util/useReactionActions.d.ts

@@ -0,0 +1,17 @@
+import { CommentParent } from '../../../src/types';
+/**
+ * A utility hook that takes in an entity and a reaction type, and creates reaction actions
+ * that can then be used on the UI. The entity can be either an ActivityResponse or a CommentResponse
+ * as the hook determines internally which APIs it is supposed to use, while taking the
+ * correct ownCapabilities into account.
+ * @param entity - The entity to which we want to add a reaction, can be either ActivityResponse or CommentResponse.
+ * @param type - The type of reaction we want to add or remove.
+ */
+export declare const useReactionActions: ({ entity, type, }: {
+    entity: CommentParent;
+    type: string;
+}) => {
+    addReaction: import("../internal").StableCallback<[], Promise<void>>;
+    removeReaction: import("../internal").StableCallback<[], Promise<void>>;
+    toggleReaction: import("../internal").StableCallback<[], Promise<void>>;
+};

package/dist/@react-bindings/index.d.ts

@@ -1,7 +1,9 @@
-export * from './hooks/useComments';
 export * from './hooks/useStateStore';
-export * from './hooks/useOwnCapabilities';
-export * from './hooks/clientStateHooks';
 export * from './hooks/useCreateFeedsClient';
+export * from './hooks/client-state-hooks';
+export * from './hooks/feed-state-hooks';
+export * from './hooks/util';
 export * from './contexts/StreamFeedsContext';
+export * from './contexts/StreamFeedContext';
 export * from './wrappers/StreamFeeds';
+export * from './wrappers/StreamFeed';

package/dist/@react-bindings/wrappers/StreamFeed.d.ts

@@ -0,0 +1,12 @@
+import { PropsWithChildren } from 'react';
+import type { Feed } from '../../src/Feed';
+/**
+ * The props for the StreamFeed component. It accepts a `Feed` instance.
+ */
+export type StreamFeedProps = {
+    feed: Feed;
+};
+export declare const StreamFeed: {
+    ({ feed, children }: PropsWithChildren<StreamFeedProps>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};