@stream-io/feeds-client 0.1.3 → 0.1.5

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,5 @@
+export * from './useFeedActivities';
+export * from './useComments';
+export * from './useOwnCapabilities';
+export * from './useFollowers';
+export * from './useFollowing';

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,27 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [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)
+
+
+* update to latest openapi ([#62](https://github.com/GetStream/stream-feeds-js/issues/62)) ([82b39ae](https://github.com/GetStream/stream-feeds-js/commit/82b39aee0c62cd9aa1598fb42aaf6637ded83a33))
+
 ## [0.1.3](https://github.com/GetStream/stream-feeds-js/compare/@stream-io/feeds-client-0.1.2...@stream-io/feeds-client-0.1.3) (2025-07-15)
 
 

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: () => {
+    isHealthy: boolean | undefined;
+};

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

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

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'];
+    hasNextPage: boolean;
+    isLoadingNextPage: 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>>;
+    isLoading?: boolean | undefined;
+    hasNextPage?: boolean | undefined;
+    activities?: import("../../..").ActivityResponse[] | 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> & {
+    isLoadingNextPage: boolean;
+    hasNextPage: 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> & {
+    isLoadingNextPage: boolean;
+    hasNextPage: 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/{useOwnCapabilities.d.ts → feed-state-hooks/useOwnCapabilities.d.ts}

@@ -1,5 +1,5 @@
-import type { Feed } from '../../src/Feed';
-export declare const useOwnCapabilities: (feed: Feed | undefined) => {
+import { Feed } from '../../../src/Feed';
+export declare const useOwnCapabilities: (feedFromProps?: Feed) => {
     canAddActivity: boolean;
     canAddActivityReaction: boolean;
     canAddComment: boolean;

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;
+};