@liveblocks/core 3.14.1 → 3.15.0-feeds1

package/dist/index.d.ts

@@ -1203,7 +1203,7 @@ declare global {
         [key: string]: unknown;
     }
 }
-type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "CommentMetadata" | "RoomInfo" | "GroupInfo" | "ActivitiesData";
+type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "CommentMetadata" | "FeedMetadata" | "FeedMessageData" | "RoomInfo" | "GroupInfo" | "ActivitiesData";
 type MakeErrorString<K extends ExtendableTypes, Reason extends string = "does not match its requirements"> = `The type you provided for '${K}' ${Reason}. To learn how to fix this, see https://liveblocks.io/docs/errors/${K}`;
 type GetOverride<K extends ExtendableTypes, B, Reason extends string = "does not match its requirements"> = GetOverrideOrErrorValue<K, B, MakeErrorString<K, Reason>>;
 type GetOverrideOrErrorValue<K extends ExtendableTypes, B, ErrorType> = unknown extends Liveblocks[K] ? B : Liveblocks[K] extends B ? Liveblocks[K] : ErrorType;
@@ -1213,6 +1213,8 @@ type DU = GetOverrideOrErrorValue<"UserMeta", BaseUserMeta, Record<"id" | "info"
 type DE = GetOverride<"RoomEvent", Json, "is not a valid JSON value">;
 type DTM = GetOverride<"ThreadMetadata", BaseMetadata>;
 type DCM = GetOverride<"CommentMetadata", BaseMetadata>;
+type DSM = GetOverride<"FeedMetadata", Json, "is not a valid JSON value">;
+type DMD = GetOverride<"FeedMessageData", Json, "is not a valid JSON value">;
 type DRI = GetOverride<"RoomInfo", BaseRoomInfo>;
 type DGI = GetOverride<"GroupInfo", BaseGroupInfo>;
 type DAD = GetOverrideOrErrorValue<"ActivitiesData", BaseActivitiesData, {
@@ -2114,7 +2116,7 @@ type InternalSyncStatus = SyncStatus | "has-local-changes";
  * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
  * will probably happen if you do.
  */
-type PrivateClientApi<U extends BaseUserMeta, TM extends BaseMetadata, CM extends BaseMetadata> = {
+type PrivateClientApi<U extends BaseUserMeta, TM extends BaseMetadata, CM extends BaseMetadata, SM extends Json = DSM, MD extends Json = DMD> = {
     readonly currentUserId: Signal<string | undefined>;
     readonly mentionSuggestionsCache: Map<string, MentionData[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
@@ -2123,7 +2125,7 @@ type PrivateClientApi<U extends BaseUserMeta, TM extends BaseMetadata, CM extend
     readonly groupsInfoStore: BatchStore<DGI | undefined, string>;
     readonly getRoomIds: () => string[];
     readonly httpClient: LiveblocksHttpApi<TM, CM>;
-    as<TM2 extends BaseMetadata, CM2 extends BaseMetadata>(): Client<U, TM2, CM2>;
+    as<TM2 extends BaseMetadata, CM2 extends BaseMetadata, SM2 extends Json = SM, MD2 extends Json = MD>(): Client<U, TM2, CM2, SM2, MD2>;
     createSyncSource(): SyncSource;
     emitError(context: LiveblocksErrorContext, cause?: Error): void;
     ai: Ai;
@@ -2276,23 +2278,23 @@ type NotificationsApi<TM extends BaseMetadata, CM extends BaseMetadata> = {
  * narrower.
  */
 type OpaqueClient = Client<BaseUserMeta>;
-type Client<U extends BaseUserMeta = DU, TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM> = {
+type Client<U extends BaseUserMeta = DU, TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM, SM extends Json = DSM, MD extends Json = DMD> = {
     /**
      * Gets a room. Returns null if {@link Client.enter} has not been called previously.
      *
      * @param roomId The id of the room
      */
-    getRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, TM2 extends BaseMetadata = TM, CM2 extends BaseMetadata = CM>(roomId: string): Room<P, S, U, E, TM2, CM2> | null;
+    getRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, TM2 extends BaseMetadata = TM, CM2 extends BaseMetadata = CM, SM2 extends Json = SM, MD2 extends Json = MD>(roomId: string): Room<P, S, U, E, TM2, CM2, SM2, MD2> | null;
     /**
      * Enter a room.
      * @param roomId The id of the room
      * @param options Optional. You can provide initializers for the Presence or Storage when entering the Room.
      * @returns The room and a leave function. Call the returned leave() function when you no longer need the room.
      */
-    enterRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, TM2 extends BaseMetadata = TM, CM2 extends BaseMetadata = CM>(roomId: string, ...args: OptionalTupleUnless<P & S, [
+    enterRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, TM2 extends BaseMetadata = TM, CM2 extends BaseMetadata = CM, SM2 extends Json = SM, MD2 extends Json = MD>(roomId: string, ...args: OptionalTupleUnless<P & S, [
         options: EnterOptions<NoInfr<P>, NoInfr<S>>
     ]>): {
-        room: Room<P, S, U, E, TM2, CM2>;
+        room: Room<P, S, U, E, TM2, CM2, SM2, MD2>;
         leave: () => void;
     };
     /**
@@ -2358,7 +2360,7 @@ type Client<U extends BaseUserMeta = DU, TM extends BaseMetadata = DTM, CM exten
      * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
      * will probably happen if you do.
      */
-    readonly [kInternal]: PrivateClientApi<U, TM, CM>;
+    readonly [kInternal]: PrivateClientApi<U, TM, CM, SM, MD>;
     /**
      * Returns the current global sync status of the Liveblocks client. If any
      * part of Liveblocks has any local pending changes that haven't been
@@ -2584,6 +2586,14 @@ declare const ClientMsgCode: Readonly<{
     UPDATE_STORAGE: 201;
     FETCH_YDOC: 300;
     UPDATE_YDOC: 301;
+    FETCH_FEEDS: 510;
+    FETCH_FEED_MESSAGES: 511;
+    ADD_FEED: 512;
+    UPDATE_FEED: 513;
+    DELETE_FEED: 514;
+    ADD_FEED_MESSAGE: 515;
+    UPDATE_FEED_MESSAGE: 516;
+    DELETE_FEED_MESSAGE: 517;
 }>;
 declare namespace ClientMsgCode {
     type UPDATE_PRESENCE = typeof ClientMsgCode.UPDATE_PRESENCE;
@@ -2592,11 +2602,19 @@ declare namespace ClientMsgCode {
     type UPDATE_STORAGE = typeof ClientMsgCode.UPDATE_STORAGE;
     type FETCH_YDOC = typeof ClientMsgCode.FETCH_YDOC;
     type UPDATE_YDOC = typeof ClientMsgCode.UPDATE_YDOC;
+    type FETCH_FEEDS = typeof ClientMsgCode.FETCH_FEEDS;
+    type FETCH_FEED_MESSAGES = typeof ClientMsgCode.FETCH_FEED_MESSAGES;
+    type ADD_FEED = typeof ClientMsgCode.ADD_FEED;
+    type UPDATE_FEED = typeof ClientMsgCode.UPDATE_FEED;
+    type DELETE_FEED = typeof ClientMsgCode.DELETE_FEED;
+    type ADD_FEED_MESSAGE = typeof ClientMsgCode.ADD_FEED_MESSAGE;
+    type UPDATE_FEED_MESSAGE = typeof ClientMsgCode.UPDATE_FEED_MESSAGE;
+    type DELETE_FEED_MESSAGE = typeof ClientMsgCode.DELETE_FEED_MESSAGE;
 }
 /**
  * Messages that can be sent from the client to the server.
  */
-type ClientMsg<P extends JsonObject, E extends Json> = BroadcastEventClientMsg<E> | UpdatePresenceClientMsg<P> | UpdateStorageClientMsg | FetchStorageClientMsg | FetchYDocClientMsg | UpdateYDocClientMsg;
+type ClientMsg<P extends JsonObject, E extends Json> = BroadcastEventClientMsg<E> | UpdatePresenceClientMsg<P> | UpdateStorageClientMsg | FetchStorageClientMsg | FetchYDocClientMsg | UpdateYDocClientMsg | FetchFeedsClientMsg | FetchFeedMessagesClientMsg | AddFeedClientMsg | UpdateFeedClientMsg | DeleteFeedClientMsg | AddFeedMessageClientMsg | UpdateFeedMessageClientMsg | DeleteFeedMessageClientMsg;
 type BroadcastEventClientMsg<E extends Json> = {
     type: ClientMsgCode.BROADCAST_EVENT;
     event: E;
@@ -2646,6 +2664,66 @@ type UpdateYDocClientMsg = {
     readonly guid?: string;
     readonly v2?: boolean;
 };
+type FetchFeedsClientMsg = {
+    readonly type: ClientMsgCode.FETCH_FEEDS;
+    readonly requestId: string;
+    readonly cursor?: string;
+    readonly since?: number;
+    readonly limit?: number;
+    readonly metadata?: Record<string, string>;
+};
+type FetchFeedMessagesClientMsg = {
+    readonly type: ClientMsgCode.FETCH_FEED_MESSAGES;
+    readonly requestId: string;
+    readonly feedId: string;
+    readonly cursor?: string;
+    readonly since?: number;
+    readonly limit?: number;
+};
+type AddFeedClientMsg = {
+    readonly type: ClientMsgCode.ADD_FEED;
+    readonly feedId: string;
+    readonly metadata?: JsonObject;
+    readonly timestamp?: number;
+};
+type UpdateFeedClientMsg = {
+    readonly type: ClientMsgCode.UPDATE_FEED;
+    readonly feedId: string;
+    readonly metadata: JsonObject;
+};
+type DeleteFeedClientMsg = {
+    readonly type: ClientMsgCode.DELETE_FEED;
+    readonly feedId: string;
+};
+type AddFeedMessageClientMsg = {
+    readonly type: ClientMsgCode.ADD_FEED_MESSAGE;
+    readonly feedId: string;
+    readonly data: JsonObject;
+    readonly id?: string;
+    readonly timestamp?: number;
+};
+type UpdateFeedMessageClientMsg = {
+    readonly type: ClientMsgCode.UPDATE_FEED_MESSAGE;
+    readonly feedId: string;
+    readonly messageId: string;
+    readonly data: JsonObject;
+};
+type DeleteFeedMessageClientMsg = {
+    readonly type: ClientMsgCode.DELETE_FEED_MESSAGE;
+    readonly feedId: string;
+    readonly messageId: string;
+};
+
+type Feed<FM extends Json = Json> = {
+    feedId: string;
+    metadata: FM;
+    timestamp: number;
+};
+type FeedMessage<FMD extends Json = Json> = {
+    id: string;
+    timestamp: number;
+    data: FMD;
+};
 
 type ServerMsgCode = (typeof ServerMsgCode)[keyof typeof ServerMsgCode];
 declare const ServerMsgCode: Readonly<{
@@ -2669,6 +2747,14 @@ declare const ServerMsgCode: Readonly<{
     COMMENT_REACTION_ADDED: 405;
     COMMENT_REACTION_REMOVED: 406;
     COMMENT_METADATA_UPDATED: 409;
+    FEEDS_LIST: 500;
+    FEEDS_ADDED: 501;
+    FEEDS_UPDATED: 502;
+    FEEDS_DELETED: 503;
+    FEED_MESSAGES_LIST: 504;
+    FEED_MESSAGES_ADDED: 505;
+    FEED_MESSAGES_UPDATED: 506;
+    FEED_MESSAGES_DELETED: 507;
     REJECT_STORAGE_OP: 299;
 }>;
 declare namespace ServerMsgCode {
@@ -2691,13 +2777,21 @@ declare namespace ServerMsgCode {
     type COMMENT_DELETED = typeof ServerMsgCode.COMMENT_DELETED;
     type COMMENT_REACTION_ADDED = typeof ServerMsgCode.COMMENT_REACTION_ADDED;
     type COMMENT_REACTION_REMOVED = typeof ServerMsgCode.COMMENT_REACTION_REMOVED;
+    type FEEDS_LIST = typeof ServerMsgCode.FEEDS_LIST;
+    type FEEDS_ADDED = typeof ServerMsgCode.FEEDS_ADDED;
+    type FEEDS_UPDATED = typeof ServerMsgCode.FEEDS_UPDATED;
+    type FEEDS_DELETED = typeof ServerMsgCode.FEEDS_DELETED;
+    type FEED_MESSAGES_LIST = typeof ServerMsgCode.FEED_MESSAGES_LIST;
+    type FEED_MESSAGES_ADDED = typeof ServerMsgCode.FEED_MESSAGES_ADDED;
+    type FEED_MESSAGES_UPDATED = typeof ServerMsgCode.FEED_MESSAGES_UPDATED;
+    type FEED_MESSAGES_DELETED = typeof ServerMsgCode.FEED_MESSAGES_DELETED;
     type COMMENT_METADATA_UPDATED = typeof ServerMsgCode.COMMENT_METADATA_UPDATED;
     type REJECT_STORAGE_OP = typeof ServerMsgCode.REJECT_STORAGE_OP;
 }
 /**
  * Messages that can be sent from the server to the client.
  */
-type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | StorageStateServerMsg_V7 | StorageChunkServerMsg | StorageEndServerMsg | UpdateStorageServerMsg | YDocUpdateServerMsg | RejectedStorageOpServerMsg | CommentsEventServerMsg;
+type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | StorageStateServerMsg_V7 | StorageChunkServerMsg | StorageEndServerMsg | UpdateStorageServerMsg | YDocUpdateServerMsg | RejectedStorageOpServerMsg | CommentsEventServerMsg | FeedsEventServerMsg;
 type CommentsEventServerMsg = ThreadCreatedEvent | ThreadDeletedEvent | ThreadMetadataUpdatedEvent | ThreadUpdatedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved | CommentMetadataUpdatedEvent;
 type ThreadCreatedEvent = {
     type: ServerMsgCode.THREAD_CREATED;
@@ -2928,6 +3022,47 @@ type RejectedStorageOpServerMsg = {
     readonly opIds: string[];
     readonly reason: string;
 };
+type FeedsEventServerMsg<FM extends Json = Json, FMD extends Json = Json> = FeedsListServerMsg<FM> | FeedsAddedServerMsg<FM> | FeedsUpdatedServerMsg<FM> | FeedsDeletedServerMsg<FM> | FeedMessagesListServerMsg<FMD> | FeedMessagesAddedServerMsg<FMD> | FeedMessagesUpdatedServerMsg<FMD> | FeedMessagesDeletedServerMsg<FMD>;
+type FeedsListServerMsg<FM extends Json = Json> = {
+    readonly type: ServerMsgCode.FEEDS_LIST;
+    readonly requestId: string;
+    readonly feeds: Feed<FM>[];
+    readonly nextCursor?: string;
+};
+type FeedsAddedServerMsg<FM extends Json = Json> = {
+    readonly type: ServerMsgCode.FEEDS_ADDED;
+    readonly feeds: Feed<FM>[];
+};
+type FeedsUpdatedServerMsg<FM extends Json = Json> = {
+    readonly type: ServerMsgCode.FEEDS_UPDATED;
+    readonly feeds: Feed<FM>[];
+};
+type FeedsDeletedServerMsg<FM extends Json = Json> = {
+    readonly type: ServerMsgCode.FEEDS_DELETED;
+    readonly feeds: Feed<FM>[];
+};
+type FeedMessagesListServerMsg<FMD extends Json = Json> = {
+    readonly type: ServerMsgCode.FEED_MESSAGES_LIST;
+    readonly requestId: string;
+    readonly feedId: string;
+    readonly messages: FeedMessage<FMD>[];
+    readonly nextCursor?: string;
+};
+type FeedMessagesAddedServerMsg<FMD extends Json = Json> = {
+    readonly type: ServerMsgCode.FEED_MESSAGES_ADDED;
+    readonly feedId: string;
+    readonly messages: FeedMessage<FMD>[];
+};
+type FeedMessagesUpdatedServerMsg<FMD extends Json = Json> = {
+    readonly type: ServerMsgCode.FEED_MESSAGES_UPDATED;
+    readonly feedId: string;
+    readonly messages: FeedMessage<FMD>[];
+};
+type FeedMessagesDeletedServerMsg<FMD extends Json = Json> = {
+    readonly type: ServerMsgCode.FEED_MESSAGES_DELETED;
+    readonly feedId: string;
+    readonly messages: FeedMessage<FMD>[];
+};
 
 type HistoryVersion = {
     type: "historyVersion";
@@ -3262,8 +3397,8 @@ type GetSubscriptionSettingsOptions = {
  * this type is different from `Room`-without-type-arguments. That represents
  * a Room instance using globally augmented types only, which is narrower.
  */
-type OpaqueRoom = Room<JsonObject, LsonObject, BaseUserMeta, Json, BaseMetadata>;
-type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUserMeta = DU, E extends Json = DE, TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM> = {
+type OpaqueRoom = Room<JsonObject, LsonObject, BaseUserMeta, Json, BaseMetadata, BaseMetadata, Json, Json>;
+type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUserMeta = DU, E extends Json = DE, TM extends BaseMetadata = DTM, CM extends BaseMetadata = DCM, SM extends Json = DSM, MD extends Json = DMD> = {
     /**
      * @private
      *
@@ -3336,6 +3471,59 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * Sends a request for the current document from liveblocks server
      */
     fetchYDoc(stateVector: string, guid?: string, isV2?: boolean): void;
+    /**
+     * Fetches feeds for the room.
+     */
+    fetchFeeds(options?: {
+        cursor?: string;
+        since?: number;
+        limit?: number;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        feeds: Feed<SM>[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Fetches messages for a specific feed.
+     */
+    fetchFeedMessages(feedId: string, options?: {
+        cursor?: string;
+        since?: number;
+        limit?: number;
+    }): Promise<{
+        messages: FeedMessage<MD>[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Adds a new feed to the room via WebSocket.
+     */
+    addFeed(feedId: string, options?: {
+        metadata?: JsonObject;
+        timestamp?: number;
+    }): void;
+    /**
+     * Updates metadata for an existing feed via WebSocket.
+     */
+    updateFeed(feedId: string, metadata: JsonObject): void;
+    /**
+     * Deletes a feed via WebSocket.
+     */
+    deleteFeed(feedId: string): void;
+    /**
+     * Adds a new message to a feed via WebSocket.
+     */
+    addFeedMessage(feedId: string, data: JsonObject, options?: {
+        id?: string;
+        timestamp?: number;
+    }): void;
+    /**
+     * Updates an existing feed message via WebSocket.
+     */
+    updateFeedMessage(feedId: string, messageId: string, data: JsonObject): void;
+    /**
+     * Deletes a feed message via WebSocket.
+     */
+    deleteFeedMessage(feedId: string, messageId: string): void;
     /**
      * Broadcasts an event to other users in the room. Event broadcasted to the room can be listened with {@link Room.subscribe}("event").
      * @param {any} event the event to broadcast. Should be serializable to JSON
@@ -3394,6 +3582,7 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         readonly storageStatus: Observable<StorageStatus>;
         readonly ydoc: Observable<YDocUpdateServerMsg | UpdateYDocClientMsg>;
         readonly comments: Observable<CommentsEventServerMsg>;
+        readonly feeds: Observable<FeedsEventServerMsg<SM, MD>>;
         /**
          * Called right before the room is destroyed. The event cannot be used to
          * prevent the room from being destroyed, only to be informed that this is
@@ -5321,4 +5510,4 @@ type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
 };
 
-export { type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeRetrievalPart, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiSourcesPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUrlSource, type AiUserMessage, type AiWebRetrievalPart, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type ChildStorageNode, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type ClientWireOp, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsEventServerMsg, type CompactChildNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DCM, type DE, type DGI, type DP, type DRI, type DS, type DTM, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type HasOpId, type History, type HistoryVersion, HttpError, type ISODateString, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IgnoredOp, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InferFromSchema, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LayerKey, type ListStorageNode, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MapStorageNode, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NodeStream, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type ObjectStorageNode, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RegisterStorageNode, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type RootStorageNode, type SearchCommentsResult, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type ServerWireOp, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageChunkServerMsg, type StorageNode, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type UrlMetadata, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactNodesToNodeStream, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isListStorageNode, isLiveNode, isMapStorageNode, isNotificationChannelEnabled, isNumberOperator, isObjectStorageNode, isPlainObject, isRegisterStorageNode, isRootStorageNode, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, nodeStreamToCompactNodes, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };
+export { type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeRetrievalPart, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiSourcesPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUrlSource, type AiUserMessage, type AiWebRetrievalPart, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type ChildStorageNode, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type ClientWireOp, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsEventServerMsg, type CompactChildNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DCM, type DE, type DGI, type DMD, type DP, type DRI, type DS, type DSM, type DTM, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type Feed, type FeedMessage, type FeedMessagesAddedServerMsg, type FeedMessagesDeletedServerMsg, type FeedMessagesListServerMsg, type FeedMessagesUpdatedServerMsg, type FeedsAddedServerMsg, type FeedsDeletedServerMsg, type FeedsEventServerMsg, type FeedsListServerMsg, type FeedsUpdatedServerMsg, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type HasOpId, type History, type HistoryVersion, HttpError, type ISODateString, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IgnoredOp, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InferFromSchema, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LayerKey, type ListStorageNode, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MapStorageNode, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NodeStream, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type ObjectStorageNode, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RegisterStorageNode, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type RootStorageNode, type SearchCommentsResult, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type ServerWireOp, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageChunkServerMsg, type StorageNode, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type UrlMetadata, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactNodesToNodeStream, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isListStorageNode, isLiveNode, isMapStorageNode, isNotificationChannelEnabled, isNumberOperator, isObjectStorageNode, isPlainObject, isRegisterStorageNode, isRootStorageNode, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, nodeStreamToCompactNodes, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.14.1";
+var PKG_VERSION = "3.15.0-feeds1";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -3219,6 +3219,15 @@ var ServerMsgCode = Object.freeze({
   COMMENT_REACTION_ADDED: 405,
   COMMENT_REACTION_REMOVED: 406,
   COMMENT_METADATA_UPDATED: 409,
+  // For Feeds
+  FEEDS_LIST: 500,
+  FEEDS_ADDED: 501,
+  FEEDS_UPDATED: 502,
+  FEEDS_DELETED: 503,
+  FEED_MESSAGES_LIST: 504,
+  FEED_MESSAGES_ADDED: 505,
+  FEED_MESSAGES_UPDATED: 506,
+  FEED_MESSAGES_DELETED: 507,
   // Error codes
   REJECT_STORAGE_OP: 299
   // Sent if a mutation was not allowed on the server (i.e. due to permissions, limit exceeded, etc)
@@ -8774,7 +8783,16 @@ var ClientMsgCode = Object.freeze({
   UPDATE_STORAGE: 201,
   // For Yjs support
   FETCH_YDOC: 300,
-  UPDATE_YDOC: 301
+  UPDATE_YDOC: 301,
+  // For Feeds
+  FETCH_FEEDS: 510,
+  FETCH_FEED_MESSAGES: 511,
+  ADD_FEED: 512,
+  UPDATE_FEED: 513,
+  DELETE_FEED: 514,
+  ADD_FEED_MESSAGE: 515,
+  UPDATE_FEED_MESSAGE: 516,
+  DELETE_FEED_MESSAGE: 517
 });
 
 // src/refs/ManagedOthers.ts
@@ -9250,6 +9268,7 @@ function createRoom(options, config) {
     storageStatus: makeEventSource(),
     ydoc: makeEventSource(),
     comments: makeEventSource(),
+    feeds: makeEventSource(),
     roomWillDestroy: makeEventSource()
   };
   async function createTextMention(mentionId, mention) {
@@ -9783,6 +9802,64 @@ function createRoom(options, config) {
           eventHub.comments.notify(message);
           break;
         }
+        case ServerMsgCode.FEEDS_LIST: {
+          const feedsListMsg = message;
+          const pending = pendingFeedsRequests.get(feedsListMsg.requestId);
+          if (pending) {
+            pending.resolve({
+              feeds: feedsListMsg.feeds,
+              nextCursor: feedsListMsg.nextCursor
+            });
+            pendingFeedsRequests.delete(feedsListMsg.requestId);
+          }
+          eventHub.feeds.notify(feedsListMsg);
+          break;
+        }
+        case ServerMsgCode.FEEDS_ADDED: {
+          const feedsAddedMsg = message;
+          eventHub.feeds.notify(feedsAddedMsg);
+          break;
+        }
+        case ServerMsgCode.FEEDS_UPDATED: {
+          const feedsUpdatedMsg = message;
+          eventHub.feeds.notify(feedsUpdatedMsg);
+          break;
+        }
+        case ServerMsgCode.FEEDS_DELETED: {
+          const feedsDeletedMsg = message;
+          eventHub.feeds.notify(feedsDeletedMsg);
+          break;
+        }
+        case ServerMsgCode.FEED_MESSAGES_LIST: {
+          const feedMsgsListMsg = message;
+          const pending = pendingFeedMessagesRequests.get(
+            feedMsgsListMsg.requestId
+          );
+          if (pending) {
+            pending.resolve({
+              messages: feedMsgsListMsg.messages,
+              nextCursor: feedMsgsListMsg.nextCursor
+            });
+            pendingFeedMessagesRequests.delete(feedMsgsListMsg.requestId);
+          }
+          eventHub.feeds.notify(feedMsgsListMsg);
+          break;
+        }
+        case ServerMsgCode.FEED_MESSAGES_ADDED: {
+          const feedMsgsAddedMsg = message;
+          eventHub.feeds.notify(feedMsgsAddedMsg);
+          break;
+        }
+        case ServerMsgCode.FEED_MESSAGES_UPDATED: {
+          const feedMsgsUpdatedMsg = message;
+          eventHub.feeds.notify(feedMsgsUpdatedMsg);
+          break;
+        }
+        case ServerMsgCode.FEED_MESSAGES_DELETED: {
+          const feedMsgsDeletedMsg = message;
+          eventHub.feeds.notify(feedMsgsDeletedMsg);
+          break;
+        }
         case ServerMsgCode.STORAGE_STATE_V7:
         // No longer used in V8
         default:
@@ -9886,6 +9963,8 @@ function createRoom(options, config) {
   }
   let _getStorage$ = null;
   let _resolveStoragePromise = null;
+  const pendingFeedsRequests = /* @__PURE__ */ new Map();
+  const pendingFeedMessagesRequests = /* @__PURE__ */ new Map();
   function processInitialStorage(nodes) {
     const unacknowledgedOps = new Map(context.unacknowledgedOps);
     createOrUpdateRootFromMessage(nodes);
@@ -9957,6 +10036,107 @@ function createRoom(options, config) {
     }
     flushNowOrSoon();
   }
+  async function fetchFeeds(options2) {
+    const requestId = nanoid();
+    const { promise, resolve, reject } = Promise_withResolvers();
+    pendingFeedsRequests.set(requestId, { resolve, reject });
+    const message = {
+      type: ClientMsgCode.FETCH_FEEDS,
+      requestId,
+      cursor: options2?.cursor,
+      since: options2?.since,
+      limit: options2?.limit,
+      metadata: options2?.metadata
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+    setTimeout(() => {
+      if (pendingFeedsRequests.has(requestId)) {
+        pendingFeedsRequests.delete(requestId);
+        reject(new Error("Feeds fetch timeout"));
+      }
+    }, 3e4);
+    return promise;
+  }
+  async function fetchFeedMessages(feedId, options2) {
+    const requestId = nanoid();
+    const { promise, resolve, reject } = Promise_withResolvers();
+    pendingFeedMessagesRequests.set(requestId, { resolve, reject });
+    const message = {
+      type: ClientMsgCode.FETCH_FEED_MESSAGES,
+      requestId,
+      feedId,
+      cursor: options2?.cursor,
+      since: options2?.since,
+      limit: options2?.limit
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+    setTimeout(() => {
+      if (pendingFeedMessagesRequests.has(requestId)) {
+        pendingFeedMessagesRequests.delete(requestId);
+        reject(new Error("Feed messages fetch timeout"));
+      }
+    }, 3e4);
+    return promise;
+  }
+  function addFeed(feedId, options2) {
+    const message = {
+      type: ClientMsgCode.ADD_FEED,
+      feedId,
+      metadata: options2?.metadata,
+      timestamp: options2?.timestamp
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+  }
+  function updateFeed(feedId, metadata) {
+    const message = {
+      type: ClientMsgCode.UPDATE_FEED,
+      feedId,
+      metadata
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+  }
+  function deleteFeed(feedId) {
+    const message = {
+      type: ClientMsgCode.DELETE_FEED,
+      feedId
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+  }
+  function addFeedMessage(feedId, data, options2) {
+    const message = {
+      type: ClientMsgCode.ADD_FEED_MESSAGE,
+      feedId,
+      data,
+      id: options2?.id,
+      timestamp: options2?.timestamp
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+  }
+  function updateFeedMessage(feedId, messageId, data) {
+    const message = {
+      type: ClientMsgCode.UPDATE_FEED_MESSAGE,
+      feedId,
+      messageId,
+      data
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+  }
+  function deleteFeedMessage(feedId, messageId) {
+    const message = {
+      type: ClientMsgCode.DELETE_FEED_MESSAGE,
+      feedId,
+      messageId
+    };
+    context.buffer.messages.push(message);
+    flushNowOrSoon();
+  }
   function undo() {
     if (context.activeBatch) {
       throw new Error("undo is not allowed during a batch");
@@ -10099,6 +10279,7 @@ function createRoom(options, config) {
     storageStatus: eventHub.storageStatus.observable,
     ydoc: eventHub.ydoc.observable,
     comments: eventHub.comments.observable,
+    feeds: eventHub.feeds.observable,
     roomWillDestroy: eventHub.roomWillDestroy.observable
   };
   async function getThreadsSince(options2) {
@@ -10307,7 +10488,7 @@ function createRoom(options, config) {
       id: roomId,
       subscribe: makeClassicSubscribeFn(
         roomId,
-        events,
+        eventHub,
         config.errorEventSource
       ),
       connect: () => managedSocket.connect(),
@@ -10342,6 +10523,14 @@ function createRoom(options, config) {
         resume: resumeHistory
       },
       fetchYDoc,
+      fetchFeeds,
+      fetchFeedMessages,
+      addFeed,
+      updateFeed,
+      deleteFeed,
+      addFeedMessage,
+      updateFeedMessage,
+      deleteFeedMessage,
       getStorage,
       getStorageSnapshot,
       getStorageStatus,