@liveblocks/core 3.16.0-flow3 → 3.17.0-rc1

package/dist/index.d.ts

@@ -127,7 +127,8 @@ declare enum Permission {
     Write = "room:write",
     PresenceWrite = "room:presence:write",
     CommentsWrite = "comments:write",
-    CommentsRead = "comments:read"
+    CommentsRead = "comments:read",
+    FeedsWrite = "feeds:write"
 }
 
 type RenameDataField<T, TFieldName extends string> = T extends any ? {
@@ -595,47 +596,6 @@ type PlainLsonList = {
 };
 type PlainLson = PlainLsonObject | PlainLsonMap | PlainLsonList | Json;
 
-declare function lsonToJson(value: Lson): Json;
-/**
- * Per-key sync configuration for node/edge `data` properties.
- *
- * true
- *   Sync this property to Liveblocks Storage. Arrays and objects in the value
- *   will be stored as LiveLists and LiveObjects, enabling fine-grained
- *   conflict-free merging. This is the default for all keys.
- *
- * false
- *   Don't sync this property. It stays local to the current client. This
- *   property will be `undefined` on other clients.
- *
- * "atomic"
- *   Sync this property, but treat it as an indivisible value. The entire value
- *   is replaced as a whole (last-writer-wins) instead of being recursively
- *   converted to LiveObjects/LiveLists. Use this when clients always replace
- *   the value entirely and never need concurrent sub-key merging.
- *
- * { ... }
- *   A nested config object for recursively configuring sub-keys of an object.
- *
- * @example
- * ```ts
- * const sync: SyncConfig = {
- *   label: true,             // sync (default)
- *   createdAt: false,        // local-only
- *   shape: "atomic",         // replaced as a whole, no deep merge
- *   nested: {                // recursive config
- *     deep: false,
- *   },
- * };
- * ```
- */
-type SyncMode = boolean | "atomic" | SyncConfig;
-type SyncConfig = {
-    [key: string]: SyncMode | undefined;
-};
-declare function legacy_patchLiveObjectKey<O extends LsonObject, K extends keyof O, V extends Json>(liveObject: LiveObject<O>, key: K, prev?: V, next?: V): void;
-declare function legacy_patchImmutableObject<TState extends JsonObject>(state: TState, updates: StorageUpdate[]): TState;
-
 type CrdtType = (typeof CrdtType)[keyof typeof CrdtType];
 declare const CrdtType: Readonly<{
     OBJECT: 0;
@@ -733,6 +693,44 @@ type KnownKeys<T> = keyof {
     [K in keyof T as {} extends Record<K, 1> ? never : K]: true;
 } & string;
 
+/**
+ * Per-key sync configuration for node/edge `data` properties.
+ *
+ * true
+ *   Sync this property to Liveblocks Storage. Arrays and objects in the value
+ *   will be stored as LiveLists and LiveObjects, enabling fine-grained
+ *   conflict-free merging. This is the default for all keys.
+ *
+ * false
+ *   Don't sync this property. It stays local to the current client. This
+ *   property will be `undefined` on other clients.
+ *
+ * "atomic"
+ *   Sync this property, but treat it as an indivisible value. The entire value
+ *   is replaced as a whole (last-writer-wins) instead of being recursively
+ *   converted to LiveObjects/LiveLists. Use this when clients always replace
+ *   the value entirely and never need concurrent sub-key merging.
+ *
+ * { ... }
+ *   A nested config object for recursively configuring sub-keys of an object.
+ *
+ * @example
+ * ```ts
+ * const sync: SyncConfig = {
+ *   label: true,             // sync (default)
+ *   createdAt: false,        // local-only
+ *   shape: "atomic",         // replaced as a whole, no deep merge
+ *   nested: {                // recursive config
+ *     deep: false,
+ *   },
+ * };
+ * ```
+ */
+type SyncMode = boolean | "atomic" | SyncConfig;
+type SyncConfig = {
+    [key: string]: SyncMode | undefined;
+};
+
 /**
  * Optional keys of O whose non-undefined type is plain Json (not a
  * LiveStructure). These are the only keys eligible for setLocal().
@@ -1296,7 +1294,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;
@@ -1306,6 +1304,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 DFM = GetOverride<"FeedMetadata", Json, "is not a valid JSON value">;
+type DFMD = GetOverride<"FeedMessageData", Json, "is not a valid JSON value">;
 type DRI = GetOverride<"RoomInfo", BaseRoomInfo>;
 type DGI = GetOverride<"GroupInfo", BaseGroupInfo>;
 type DAD = GetOverrideOrErrorValue<"ActivitiesData", BaseActivitiesData, {
@@ -2071,6 +2071,13 @@ type RoomConnectionErrorContext = {
 type LargeMessageErrorContext = {
     type: "LARGE_MESSAGE_ERROR";
 };
+type FeedRequestErrorContext = {
+    type: "FEED_REQUEST_ERROR";
+    roomId: string;
+    requestId: string;
+    code: string;
+    reason?: string;
+};
 type CommentsOrNotificationsErrorContext = {
     type: "CREATE_THREAD_ERROR";
     roomId: string;
@@ -2131,7 +2138,7 @@ type CommentsOrNotificationsErrorContext = {
 } | {
     type: "UPDATE_NOTIFICATION_SETTINGS_ERROR";
 };
-type LiveblocksErrorContext = Relax<RoomConnectionErrorContext | CommentsOrNotificationsErrorContext | AiConnectionErrorContext | LargeMessageErrorContext>;
+type LiveblocksErrorContext = Relax<RoomConnectionErrorContext | CommentsOrNotificationsErrorContext | AiConnectionErrorContext | LargeMessageErrorContext | FeedRequestErrorContext>;
 declare class LiveblocksError extends Error {
     readonly context: LiveblocksErrorContext;
     constructor(message: string, context: LiveblocksErrorContext, cause?: Error);
@@ -2214,7 +2221,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, FM extends Json = DFM, FMD extends Json = DFMD> = {
     readonly currentUserId: Signal<string | undefined>;
     readonly mentionSuggestionsCache: Map<string, MentionData[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
@@ -2223,7 +2230,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, FM2 extends Json = FM, FMD2 extends Json = FMD>(): Client<U, TM2, CM2, FM2, FMD2>;
     createSyncSource(): SyncSource;
     emitError(context: LiveblocksErrorContext, cause?: Error): void;
     ai: Ai;
@@ -2376,23 +2383,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, FM extends Json = DFM, FMD extends Json = DFMD> = {
     /**
      * 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, FM2 extends Json = FM, FMD2 extends Json = FMD>(roomId: string): Room<P, S, U, E, TM2, CM2, FM2, FMD2> | 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, FM2 extends Json = FM, FMD2 extends Json = FMD>(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, FM2, FMD2>;
         leave: () => void;
     };
     /**
@@ -2458,7 +2465,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, FM, FMD>;
     /**
      * Returns the current global sync status of the Liveblocks client. If any
      * part of Liveblocks has any local pending changes that haven't been
@@ -2683,6 +2690,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;
@@ -2691,11 +2706,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;
@@ -2745,6 +2768,81 @@ type UpdateYDocClientMsg = {
     readonly guid?: string;
     readonly v2?: boolean;
 };
+/** Metadata filter for {@link FetchFeedsClientMsg}. Values are matched as strings. */
+type FeedFetchMetadataFilter = Record<string, string>;
+/** Metadata for {@link AddFeedClientMsg}. */
+type FeedCreateMetadata = Record<string, string | string[]>;
+/** Metadata for {@link UpdateFeedClientMsg}. Use `null` to remove a key. */
+type FeedUpdateMetadata = Record<string, string | string[] | null>;
+type FetchFeedsClientMsg = {
+    readonly type: ClientMsgCode.FETCH_FEEDS;
+    readonly requestId: string;
+    readonly cursor?: string;
+    readonly since?: number;
+    readonly limit?: number;
+    readonly metadata?: FeedFetchMetadataFilter;
+};
+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 requestId: string;
+    readonly feedId: string;
+    readonly metadata?: FeedCreateMetadata;
+    readonly createdAt?: number;
+};
+type UpdateFeedClientMsg = {
+    readonly type: ClientMsgCode.UPDATE_FEED;
+    readonly requestId: string;
+    readonly feedId: string;
+    readonly metadata: FeedUpdateMetadata;
+};
+type DeleteFeedClientMsg = {
+    readonly type: ClientMsgCode.DELETE_FEED;
+    readonly requestId: string;
+    readonly feedId: string;
+};
+type AddFeedMessageClientMsg = {
+    readonly type: ClientMsgCode.ADD_FEED_MESSAGE;
+    readonly requestId: string;
+    readonly feedId: string;
+    readonly data: JsonObject;
+    readonly id?: string;
+    readonly createdAt?: number;
+};
+type UpdateFeedMessageClientMsg = {
+    readonly type: ClientMsgCode.UPDATE_FEED_MESSAGE;
+    readonly requestId: string;
+    readonly feedId: string;
+    readonly messageId: string;
+    readonly data: JsonObject;
+    readonly updatedAt?: number;
+};
+type DeleteFeedMessageClientMsg = {
+    readonly type: ClientMsgCode.DELETE_FEED_MESSAGE;
+    readonly requestId: string;
+    readonly feedId: string;
+    readonly messageId: string;
+};
+
+type Feed<FM extends Json = Json> = {
+    feedId: string;
+    metadata: FM;
+    createdAt: number;
+    updatedAt: number;
+};
+type FeedMessage<FMD extends Json = Json> = {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    data: FMD;
+};
 
 type ServerMsgCode = (typeof ServerMsgCode)[keyof typeof ServerMsgCode];
 declare const ServerMsgCode: Readonly<{
@@ -2768,6 +2866,15 @@ 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;
+    FEED_DELETED: 503;
+    FEED_MESSAGES_LIST: 504;
+    FEED_MESSAGES_ADDED: 505;
+    FEED_MESSAGES_UPDATED: 506;
+    FEED_MESSAGES_DELETED: 507;
+    FEED_REQUEST_FAILED: 508;
     REJECT_STORAGE_OP: 299;
 }>;
 declare namespace ServerMsgCode {
@@ -2790,13 +2897,22 @@ 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 FEED_DELETED = typeof ServerMsgCode.FEED_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 FEED_REQUEST_FAILED = typeof ServerMsgCode.FEED_REQUEST_FAILED;
     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;
@@ -3027,6 +3143,66 @@ type RejectedStorageOpServerMsg = {
     readonly opIds: string[];
     readonly reason: string;
 };
+type FeedsEventServerMsg<FM extends Json = Json, FMD extends Json = Json> = FeedsListServerMsg<FM> | FeedsAddedServerMsg<FM> | FeedsUpdatedServerMsg<FM> | FeedDeletedServerMsg | FeedMessagesListServerMsg<FMD> | FeedMessagesAddedServerMsg<FMD> | FeedMessagesUpdatedServerMsg<FMD> | FeedMessagesDeletedServerMsg | FeedRequestFailedServerMsg;
+/** Error codes for {@link FeedRequestFailedServerMsg}. */
+declare const FeedRequestErrorCode: {
+    readonly INTERNAL: "INTERNAL";
+    readonly FEED_ALREADY_EXISTS: "FEED_ALREADY_EXISTS";
+    readonly FEED_NOT_FOUND: "FEED_NOT_FOUND";
+    readonly FEED_MESSAGE_NOT_FOUND: "FEED_MESSAGE_NOT_FOUND";
+};
+/** String literals accepted in {@link FeedRequestFailedServerMsg}.code */
+type FeedRequestError = (typeof FeedRequestErrorCode)[keyof typeof FeedRequestErrorCode];
+/**
+ * Sent to the client when a feed mutation referenced by `requestId` failed
+ * (e.g. validation or permission error).
+ */
+type FeedRequestFailedServerMsg = {
+    readonly type: ServerMsgCode.FEED_REQUEST_FAILED;
+    readonly requestId: string;
+    readonly code: string;
+    readonly reason?: string;
+};
+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 FeedDeletedServerMsg = {
+    readonly type: ServerMsgCode.FEED_DELETED;
+    readonly feedId: string;
+};
+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 = {
+    readonly type: ServerMsgCode.FEED_MESSAGES_DELETED;
+    readonly feedId: string;
+    readonly messageIds: readonly string[];
+};
 
 type HistoryVersion = {
     type: "historyVersion";
@@ -3364,8 +3540,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, FM extends Json = DFM, FMD extends Json = DFMD> = {
     /**
      * @private
      *
@@ -3438,6 +3614,63 @@ 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?: FeedFetchMetadataFilter;
+    }): Promise<{
+        feeds: Feed<FM>[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Fetches messages for a specific feed.
+     */
+    fetchFeedMessages(feedId: string, options?: {
+        cursor?: string;
+        since?: number;
+        limit?: number;
+    }): Promise<{
+        messages: FeedMessage<FMD>[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Adds a new feed to the room via WebSocket.
+     * Resolves when the server broadcasts the new feed, or rejects on
+     * FEED_REQUEST_FAILED (508) or timeout.
+     */
+    addFeed(feedId: string, options?: {
+        metadata?: FeedCreateMetadata;
+        createdAt?: number;
+    }): Promise<void>;
+    /**
+     * Updates metadata for an existing feed via WebSocket.
+     */
+    updateFeed(feedId: string, metadata: FeedUpdateMetadata): Promise<void>;
+    /**
+     * Deletes a feed via WebSocket.
+     */
+    deleteFeed(feedId: string): Promise<void>;
+    /**
+     * Adds a new message to a feed via WebSocket.
+     */
+    addFeedMessage(feedId: string, data: JsonObject, options?: {
+        id?: string;
+        createdAt?: number;
+    }): Promise<void>;
+    /**
+     * Updates an existing feed message via WebSocket.
+     */
+    updateFeedMessage(feedId: string, messageId: string, data: JsonObject, options?: {
+        updatedAt?: number;
+    }): Promise<void>;
+    /**
+     * Deletes a feed message via WebSocket.
+     */
+    deleteFeedMessage(feedId: string, messageId: string): Promise<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
@@ -3496,6 +3729,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<FM, FMD>>;
         /**
          * 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
@@ -4731,6 +4965,10 @@ ChildStorageNode[]>;
 declare function isLiveNode(value: unknown): value is LiveNode;
 declare function cloneLson<L extends Lson | undefined>(value: L): L;
 
+declare function lsonToJson(value: Lson): Json;
+declare function legacy_patchLiveObjectKey<O extends LsonObject, K extends keyof O, V extends Json>(liveObject: LiveObject<O>, key: K, prev?: V, next?: V): void;
+declare function legacy_patchImmutableObject<TState extends JsonObject>(state: TState, updates: StorageUpdate[]): TState;
+
 /**
  * Like `new AbortController()`, but where the result can be unpacked
  * safely, i.e. `const { signal, abort } = makeAbortController()`.
@@ -5420,4 +5658,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 SyncConfig, type SyncMode, 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, legacy_patchLiveObjectKey, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, nodeStreamToCompactNodes, objectToQuery, 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 DFM, type DFMD, 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 Feed, type FeedCreateMetadata, type FeedDeletedServerMsg, type FeedFetchMetadataFilter, type FeedMessage, type FeedMessagesAddedServerMsg, type FeedMessagesDeletedServerMsg, type FeedMessagesListServerMsg, type FeedMessagesUpdatedServerMsg, type FeedRequestError, FeedRequestErrorCode, type FeedRequestFailedServerMsg, type FeedUpdateMetadata, type FeedsAddedServerMsg, 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 SyncConfig, type SyncMode, 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, legacy_patchLiveObjectKey, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, nodeStreamToCompactNodes, objectToQuery, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };