@liveblocks/server 1.1.1-pnpmtest1 → 1.2.1

package/dist/index.d.cts

@@ -1,10 +1,257 @@
-import { DistributiveOmit, SetParentKeyOp, DeleteCrdtOp, ClientMsg as ClientMsg$1, JsonObject, Json, Brand, asPos, SerializedCrdt, IUserInfo, SerializedRootObject, SerializedChild, StorageNode, Awaitable, PlainLsonObject, NodeMap as NodeMap$1, NodeStream as NodeStream$1, ClientWireOp, IgnoredOp, ServerMsg as ServerMsg$1, BaseUserMeta } from '@liveblocks/core';
+import { asPos, SerializedCrdt, Json, IUserInfo, JsonObject, DistributiveOmit, SetParentKeyOp, DeleteCrdtOp, ClientMsg as ClientMsg$1, Brand, SerializedRootObject, SerializedChild, StorageNode, Awaitable, PlainLsonObject, NodeMap as NodeMap$1, NodeStream as NodeStream$1, ClientWireOp, IgnoredOp, ServerMsg as ServerMsg$1, BaseUserMeta } from '@liveblocks/core';
 export { BroadcastEventClientMsg, ClientMsg, ClientWireOp, CreateListOp, CreateMapOp, CreateObjectOp, CreateOp, CreateRegisterOp, DeleteCrdtOp, DeleteObjectKeyOp, FetchStorageClientMsg, FetchYDocClientMsg, HasOpId, IgnoredOp, Op, RoomStateServerMsg, ServerMsg, ServerWireOp, SetParentKeyOp, UpdateObjectOp, UpdatePresenceClientMsg, UpdateStorageClientMsg, UpdateYDocClientMsg } from '@liveblocks/core';
 import * as decoders from 'decoders';
 import { Decoder } from 'decoders';
 import { Mutex } from 'async-mutex';
 import * as Y from 'yjs';
 
+/**
+ * Copyright (c) Liveblocks Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+type Pos = ReturnType<typeof asPos>;
+type NodeTuple<T extends SerializedCrdt = SerializedCrdt> = [
+    id: string,
+    value: T
+];
+type NodeMap = {
+    size: number;
+    [Symbol.iterator]: () => IterableIterator<[id: string, node: SerializedCrdt]>;
+    clear: () => void;
+    delete: (key: string) => boolean;
+    get: (key: string) => SerializedCrdt | undefined;
+    has: (key: string) => boolean;
+    keys: () => Iterable<string>;
+    set(key: string, value: SerializedCrdt): void;
+};
+type NodeStream = Iterable<NodeTuple>;
+/**
+ * Leased session data structure for server-side sessions with temporarily persisted presence.
+ */
+type LeasedSession = {
+    sessionId: string;
+    presence: Json;
+    updatedAt: number;
+    info: IUserInfo;
+    ttl: number;
+    actorId: number;
+};
+/**
+ * Feed message data structure for messages within feeds.
+ */
+type FeedMessage = {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    data: Json;
+};
+/**
+ * Feed data structure for feed-related data within a room.
+ * Note: Messages are stored separately and accessed via list_feed_messages.
+ */
+type Feed = {
+    feedId: string;
+    metadata: Json;
+    createdAt: number;
+    updatedAt: number;
+};
+
+/**
+ * Copyright (c) Liveblocks Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * NOTE: this will be moved to @liveblocks/core in the future.
+ * Feed WebSocket message codes.
+ * 50x = server → client, 51x = client → server.
+ */
+declare const FeedMsgCode: {
+    readonly FEEDS_LIST: 500;
+    readonly FEEDS_ADDED: 501;
+    readonly FEEDS_UPDATED: 502;
+    readonly FEED_DELETED: 503;
+    readonly FEED_MESSAGES_LIST: 504;
+    readonly FEED_MESSAGES_ADDED: 505;
+    readonly FEED_MESSAGES_UPDATED: 506;
+    readonly FEED_MESSAGES_DELETED: 507;
+    readonly FEED_REQUEST_FAILED: 508;
+    readonly FETCH_FEEDS: 510;
+    readonly FETCH_FEED_MESSAGES: 511;
+    readonly ADD_FEED: 512;
+    readonly UPDATE_FEED: 513;
+    readonly DELETE_FEED: 514;
+    readonly ADD_FEED_MESSAGE: 515;
+    readonly UPDATE_FEED_MESSAGE: 516;
+    readonly DELETE_FEED_MESSAGE: 517;
+};
+/** 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";
+};
+
+type FeedsListServerMsg = {
+    type: 500;
+    requestId: string;
+    feeds: Feed[];
+    nextCursor?: string;
+};
+type FeedsAddedServerMsg = {
+    type: 501;
+    feeds: Feed[];
+};
+type FeedsUpdatedServerMsg = {
+    type: 502;
+    feeds: Feed[];
+};
+type FeedDeletedServerMsg = {
+    type: 503;
+    feedId: string;
+};
+type FeedRequestFailedServerMsg = {
+    type: 508;
+    requestId: string;
+    code: string;
+    reason?: string;
+};
+type FeedsServerMsg = FeedsListServerMsg | FeedsAddedServerMsg | FeedsUpdatedServerMsg | FeedDeletedServerMsg | FeedRequestFailedServerMsg;
+type FeedMessagesListServerMsg = {
+    type: 504;
+    requestId: string;
+    feedId: string;
+    messages: FeedMessage[];
+    nextCursor?: string;
+};
+type FeedMessagesAddedServerMsg = {
+    type: 505;
+    feedId: string;
+    messages: FeedMessage[];
+};
+type FeedMessagesUpdatedServerMsg = {
+    type: 506;
+    feedId: string;
+    messages: FeedMessage[];
+};
+type FeedMessagesDeletedServerMsg = {
+    type: 507;
+    feedId: string;
+    messageIds: string[];
+};
+type FeedMessagesServerMsg = FeedMessagesListServerMsg | FeedMessagesAddedServerMsg | FeedMessagesUpdatedServerMsg | FeedMessagesDeletedServerMsg | FeedRequestFailedServerMsg;
+type FetchFeedsClientMsg = {
+    type: 510;
+    requestId: string;
+    cursor?: string;
+    since?: number;
+    limit?: number;
+    /** Match feeds whose metadata contains these keys (same value rules as room metadata updates). */
+    metadata?: Record<string, string | string[] | null>;
+};
+type FetchFeedMessagesClientMsg = {
+    type: 511;
+    requestId: string;
+    feedId: string;
+    cursor?: string;
+    since?: number;
+    limit?: number;
+};
+type AddFeedClientMsg = {
+    type: 512;
+    feedId: string;
+    metadata?: Record<string, string[] | string>;
+    timestamp?: number;
+    requestId?: string;
+};
+type UpdateFeedClientMsg = {
+    type: 513;
+    feedId: string;
+    metadata: Record<string, string[] | string | null>;
+    requestId?: string;
+};
+type DeleteFeedClientMsg = {
+    type: 514;
+    feedId: string;
+    requestId?: string;
+};
+type AddFeedMessageClientMsg = {
+    type: 515;
+    feedId: string;
+    data: JsonObject;
+    id?: string;
+    timestamp?: number;
+    requestId?: string;
+};
+type UpdateFeedMessageClientMsg = {
+    type: 516;
+    feedId: string;
+    messageId: string;
+    data: JsonObject;
+    timestamp?: number;
+    requestId?: string;
+};
+type DeleteFeedMessageClientMsg = {
+    type: 517;
+    feedId: string;
+    messageId: string;
+    requestId?: string;
+};
+
+/**
+ * Copyright (c) Liveblocks Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare function feedRequestFailed(requestId: string | undefined, code: string, reason?: string): FeedRequestFailedServerMsg;
+/**
+ * Maps driver / Room errors to stable {@link FeedRequestFailedServerMsg} codes.
+ * Prefer matching known {@link Error#message} shapes storage drivers.
+ */
+declare function mapFeedError(err: unknown): {
+    code: string;
+    reason?: string;
+};
+/** Maps an arbitrary thrown value to a {@link FeedRequestFailedServerMsg}. */
+declare function feedFailureServerMsg(requestId: string | undefined, err: unknown): FeedRequestFailedServerMsg;
+
 /**
  * Copyright (c) Liveblocks Inc.
  *
@@ -109,6 +356,44 @@ type FixOp = DistributiveOmit<SetParentKeyOp | DeleteCrdtOp, "opId">;
 declare const clientMsgDecoder: Decoder<ClientMsg$1<JsonObject, Json>>;
 declare const transientClientMsgDecoder: Decoder<ClientMsg$1<JsonObject, Json>>;
 
+/**
+ * Copyright (c) Liveblocks Inc.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Feed metadata decoders — same rules as room/thread metadata (see @shared/common
+ * createMetadataDecoder / updateRoomMetadataDecoder).
+ */
+
+declare const feedMetadataIdDecoder: Decoder<string>;
+/**
+ * Optional feed metadata on create (WebSocket ADD_FEED, HTTP POST …/feeds).
+ * Same rules as createMetadataDecoder / room metadata on create (no null values).
+ */
+declare const optionalFeedMetadataDecoder: Decoder<Record<string, string | string[]> | undefined>;
+/**
+ * Full metadata object for update (WebSocket UPDATE_FEED, HTTP PATCH …/feeds/:id).
+ * Same shape as updateRoomMetadataDecoder.
+ */
+declare const feedMetadataUpdateDecoder: Decoder<Record<string, string | string[] | null>>;
+/**
+ * Optional metadata filter for FETCH_FEEDS — same key/value rules as
+ * {@link feedMetadataUpdateDecoder} / updateRoomMetadataDecoder in @shared/common.
+ */
+declare const fetchFeedsMetadataFilterDecoder: Decoder<Record<string, string | string[] | null> | undefined>;
+
 /**
  * Copyright (c) Liveblocks Inc.
  *
@@ -312,51 +597,37 @@ declare class Logger {
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
 
-type Pos = ReturnType<typeof asPos>;
-type NodeTuple<T extends SerializedCrdt = SerializedCrdt> = [
-    id: string,
-    value: T
-];
-type NodeMap = {
-    size: number;
-    [Symbol.iterator]: () => IterableIterator<[id: string, node: SerializedCrdt]>;
-    clear: () => void;
-    delete: (key: string) => boolean;
-    get: (key: string) => SerializedCrdt | undefined;
-    has: (key: string) => boolean;
-    keys: () => Iterable<string>;
-    set(key: string, value: SerializedCrdt): void;
+/**
+ * Options for listing feeds with pagination and filtering.
+ */
+type ListFeedsOptions = {
+    cursor?: string;
+    since?: number;
+    limit?: number;
+    metadata?: Record<string, Json>;
 };
-type NodeStream = Iterable<NodeTuple>;
 /**
- * Leased session data structure for server-side sessions with temporarily persisted presence.
+ * Options for listing feed messages with pagination.
  */
-type LeasedSession = {
-    sessionId: string;
-    presence: Json;
-    updatedAt: number;
-    info: IUserInfo;
-    ttl: number;
-    actorId: number;
+type ListFeedMessagesOptions = {
+    cursor?: string;
+    since?: number;
+    limit?: number;
 };
-
 /**
- * Copyright (c) Liveblocks Inc.
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as published
- * by the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU Affero General Public License for more details.
- *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ * Result of listing feeds with pagination info.
  */
-
+type ListFeedsResult = {
+    feeds: Feed[];
+    nextCursor?: string;
+};
+/**
+ * Result of listing feed messages with pagination info.
+ */
+type ListFeedMessagesResult = {
+    messages: FeedMessage[];
+    nextCursor?: string;
+};
 /**
  * An isolated, read-only copy of the storage document at a point in time.
  *
@@ -567,6 +838,58 @@ interface IStorageDriver {
      * and reset the counter.
      */
     takeRowsWritten?(): number;
+    /**
+     * List feeds with pagination, filtering, and metadata querying.
+     * Feeds are sorted by createdAt descending (newest first).
+     */
+    list_feeds(options?: ListFeedsOptions): Awaitable<ListFeedsResult>;
+    /**
+     * Get a specific feed by feed ID.
+     * Returns feed metadata only (without messages).
+     * Use list_feed_messages to retrieve messages for this feed.
+     * Returns undefined if the feed doesn't exist.
+     */
+    get_feed(feedId: string): Awaitable<Feed | undefined>;
+    /**
+     * Create a new feed.
+     * If feedId already exists, throws an error.
+     */
+    create_feed(feed: Feed): Awaitable<void>;
+    /**
+     * Update a feed's metadata.
+     * The feed must exist, otherwise throws an error.
+     */
+    update_feed_metadata(feedId: string, metadata: Json): Awaitable<void>;
+    /**
+     * Delete a feed by feed ID.
+     * Also deletes all messages associated with the feed (via CASCADE).
+     * No-op if feed doesn't exist.
+     */
+    delete_feed(feedId: string): Awaitable<void>;
+    /**
+     * List feed messages for a feed with pagination.
+     * Messages are sorted by createdAt descending (newest first).
+     */
+    list_feed_messages(feedId: string, options?: ListFeedMessagesOptions): Awaitable<ListFeedMessagesResult>;
+    /**
+     * Add a message to a feed.
+     * The message must have id, createdAt, and updatedAt already set (handled by Room layer).
+     * The feed must exist, otherwise throws an error.
+     */
+    add_feed_message(feedId: string, message: FeedMessage): Awaitable<void>;
+    /**
+     * Update a feed message's data.
+     * Returns the updated message.
+     * The feed and message must exist, otherwise throws an error.
+     * If timestamp is not provided, current server time is used.
+     * Messages are only updated if the provided timestamp is greater than or equal to the stored updatedAt.
+     */
+    update_feed_message(feedId: string, messageId: string, data: Json, timestamp?: number): Awaitable<FeedMessage>;
+    /**
+     * Delete a feed message.
+     * The feed and message must exist, otherwise throws an error.
+     */
+    delete_feed_message(feedId: string, messageId: string): Awaitable<void>;
 }
 
 /**
@@ -843,7 +1166,7 @@ declare class YjsStorage {
      * @returns a base64 encoded array of YJS updates
      */
     getYDocUpdate(logger: Logger, stateVector?: string, guid?: Guid, isV2?: boolean): Promise<string | null>;
-    getYDocUpdateBinary(logger: Logger, stateVector?: string, guid?: Guid, isV2?: boolean): Promise<Uint8Array | null>;
+    getYDocUpdateBinary(logger: Logger, stateVector?: string, guid?: Guid, isV2?: boolean): Promise<Uint8Array<ArrayBuffer> | null>;
     getYStateVector(guid?: Guid): Promise<string | null>;
     getSnapshotHash(options: {
         guid?: Guid;
@@ -895,6 +1218,8 @@ declare class YjsStorage {
 
 type LoadingState = "initial" | "loading" | "loaded";
 type ActorID = Brand<number, "ActorID">;
+/** Number of milliseconds since Unix epoch. */
+type Millis = Brand<number, "Millis">;
 /**
  * Session keys are also known as the "nonce" in the protocol. It's a random,
  * unique, but PRIVATE, identifier for the session, and it's important that
@@ -903,8 +1228,8 @@ type ActorID = Brand<number, "ActorID">;
  */
 type SessionKey = Brand<string, "SessionKey">;
 type PreSerializedServerMsg = Brand<string, "PreSerializedServerMsg">;
-type ClientMsg = ClientMsg$1<JsonObject, Json>;
-type ServerMsg = ServerMsg$1<JsonObject, BaseUserMeta, Json>;
+type ClientMsg = ClientMsg$1<JsonObject, Json> | FetchFeedsClientMsg | FetchFeedMessagesClientMsg | AddFeedClientMsg | UpdateFeedClientMsg | DeleteFeedClientMsg | AddFeedMessageClientMsg | UpdateFeedMessageClientMsg | DeleteFeedMessageClientMsg;
+type ServerMsg = ServerMsg$1<JsonObject, BaseUserMeta, Json> | FeedMessagesServerMsg | FeedsServerMsg;
 declare function serialize(msgs: ServerMsg | readonly ServerMsg[]): PreSerializedServerMsg;
 declare function ackIgnoredOp(opId: string): IgnoredOp;
 /**
@@ -943,14 +1268,13 @@ declare class BrowserSession<SM, CM extends JsonObject> {
     #private;
     readonly version: ProtocolVersion;
     readonly actor: ActorID;
-    readonly createdAt: Date;
+    readonly createdAt: Millis;
     readonly user: IUserData;
     readonly scopes: string[];
     readonly meta: SM;
     readonly publicMeta?: CM;
-    get lastActiveAt(): Date;
+    get lastActiveAt(): Millis;
     get hasNotifiedClientStorageUpdateError(): boolean;
-    markActive(now?: Date): void;
     setHasNotifiedClientStorageUpdateError(): void;
     sendPong(): number;
     send(serverMsg: ServerMsg | ServerMsg[] | PreSerializedServerMsg): number;
@@ -1053,6 +1377,15 @@ declare class Room<RM, SM, CM extends JsonObject, C = undefined> {
     meta: RM;
     readonly driver: IStorageDriver;
     logger: Logger;
+    /**
+     * While a room is in "maintenance mode", all WebSocket connections to the
+     * room should be rejected until it's pulled out of maintenance mode again.
+     * Maintenance mode should only last a couple of milliseconds, typically.
+     *
+     * This mutex ensures that concurrent destructive operations (like
+     * init-storage, storage-reset, etc.) cannot interfere with one another.
+     */
+    private readonly _maintenanceMode;
     private _loadData$;
     private _data;
     private _qsize;
@@ -1065,6 +1398,17 @@ declare class Room<RM, SM, CM extends JsonObject, C = undefined> {
     get yjsStorage(): YjsStorage;
     get mutex(): Mutex;
     private get data();
+    /**
+     * Returns true if the room is currently in maintenance mode.
+     * When in maintenance mode, callers should refuse new WebSocket connections.
+     */
+    get isInMaintenance(): boolean;
+    /**
+     * Tries to enter maintenance mode and run the given callback exclusively.
+     * If the room is already in maintenance mode, throws E_ALREADY_LOCKED
+     * immediately instead of queuing the request.
+     */
+    runInMaintenanceMode<T>(callback: () => Promise<T>): Promise<T>;
     /**
      * Initializes the Room, so it's ready to start accepting connections. Safe
      * to call multiple times. After awaiting `room.load()` the Room is ready to
@@ -1188,6 +1532,50 @@ declare class Room<RM, SM, CM extends JsonObject, C = undefined> {
      * Delete all server sessions and broadcast USER_LEFT to all sessions.
      */
     deleteAllLeasedSessions(ctx?: C, defer?: (promise: Promise<void>) => void): Promise<void>;
+    /**
+     * List feeds with pagination and filtering.
+     */
+    listFeeds(options?: ListFeedsOptions): Promise<ListFeedsResult>;
+    /**
+     * Get a specific feed by feed ID.
+     */
+    getFeed(feedId: string): Promise<Feed | undefined>;
+    /**
+     * Create a new feed.
+     * If timestamp is not provided, current server time is used.
+     */
+    createFeed(feed: Omit<Feed, "createdAt" | "updatedAt"> & {
+        timestamp?: number;
+    }): Promise<Feed>;
+    /**
+     * Update a feed's metadata.
+     */
+    updateFeedMetadata(feedId: string, metadata: Json): Promise<void>;
+    /**
+     * Delete a feed.
+     */
+    deleteFeed(feedId: string): Promise<void>;
+    /**
+     * List feed messages for a feed with pagination.
+     */
+    listFeedMessages(feedId: string, options?: ListFeedMessagesOptions): Promise<ListFeedMessagesResult>;
+    /**
+     * Add a message to a feed.
+     * If message id is not provided, a unique ID is automatically generated.
+     * If timestamp is not provided, current server time is used.
+     */
+    addFeedMessage(feedId: string, message: Omit<FeedMessage, "id" | "createdAt" | "updatedAt"> & Partial<Pick<FeedMessage, "id">> & {
+        timestamp?: number;
+    }): Promise<FeedMessage>;
+    /**
+     * Update a feed message's data.
+     * Returns the updated message.
+     */
+    updateFeedMessage(feedId: string, messageId: string, data: Json, timestamp?: number): Promise<FeedMessage>;
+    /**
+     * Delete a feed message.
+     */
+    deleteFeedMessage(feedId: string, messageId: string): Promise<void>;
     /**
      * Will send the given ServerMsg through all Session, except the Session
      * where the message originates from.
@@ -1237,7 +1625,7 @@ declare class Room<RM, SM, CM extends JsonObject, C = undefined> {
 /**
  * Concatenates multiple Uint8Arrays into a single Uint8Array.
  */
-declare function concatUint8Arrays(arrays: Uint8Array[]): Uint8Array;
+declare function concatUint8Arrays(arrays: Uint8Array[]): Uint8Array<ArrayBuffer>;
 /**
  * Check if a leased session is expired.
  * Returns true if the current time is greater than or equal to updatedAt + ttl.
@@ -1471,23 +1859,34 @@ declare class InMemoryDriver implements IStorageDriver {
     private _metadb;
     private _ydb;
     private _leasedSessions;
+    private _feeds;
+    private _feedMessages;
     constructor(options?: {
         initialActor?: number;
         initialNodes?: Iterable<[string, SerializedCrdt]>;
     });
-    raw_iter_nodes(): IterableIterator<[string, SerializedCrdt]>;
+    raw_iter_nodes(): MapIterator<[string, SerializedCrdt]>;
     /** Deletes all nodes and replaces them with the given document. */
     DANGEROUSLY_reset_nodes(doc: PlainLsonObject): void;
     get_meta(key: string): Promise<Json | undefined>;
     put_meta(key: string, value: Json): Promise<void>;
     delete_meta(key: string): Promise<void>;
-    list_leased_sessions(): Promise<IterableIterator<[string, LeasedSession]>>;
+    list_leased_sessions(): Promise<MapIterator<[string, LeasedSession]>>;
     get_leased_session(sessionId: string): Promise<LeasedSession | undefined>;
     put_leased_session(session: LeasedSession): Promise<void>;
     delete_leased_session(sessionId: string): Promise<void>;
     takeRowsWritten(): number;
+    list_feeds(options?: ListFeedsOptions): Promise<ListFeedsResult>;
+    get_feed(feedId: string): Promise<Feed | undefined>;
+    create_feed(feed: Feed): Promise<void>;
+    update_feed_metadata(feedId: string, metadata: Json): Promise<void>;
+    delete_feed(feedId: string): Promise<void>;
+    list_feed_messages(feedId: string, options?: ListFeedMessagesOptions): Promise<ListFeedMessagesResult>;
+    add_feed_message(feedId: string, message: FeedMessage): Promise<void>;
+    update_feed_message(feedId: string, messageId: string, data: Json, timestamp?: number): Promise<FeedMessage>;
+    delete_feed_message(feedId: string, messageId: string): Promise<void>;
     next_actor(): number;
-    iter_y_updates(docId: YDocId): Promise<IterableIterator<[string, Uint8Array]>>;
+    iter_y_updates(docId: YDocId): Promise<IterableIterator<[string, Uint8Array<ArrayBufferLike>]>>;
     write_y_updates(docId: YDocId, key: string, data: Uint8Array): Promise<void>;
     delete_y_updates(docId: YDocId, keys: string[]): Promise<void>;
     /** @private Only use this in unit tests, never in production. */
@@ -1495,4 +1894,4 @@ declare class InMemoryDriver implements IStorageDriver {
     load_nodes_api(): IStorageDriverNodeAPI;
 }
 
-export { type ActorID, BackendSession, BrowserSession, ConsoleTarget, type CreateTicketOptions, DefaultMap, type FixOp, type Guid, type IReadableSnapshot, type IServerWebSocket, type IStorageDriver, type IStorageDriverNodeAPI, type IUserData, InMemoryDriver, type LeasedSession, type LoadingState, LogLevel, LogTarget, Logger, type MetadataDB, NestedMap, type NodeMap, type NodeStream, type NodeTuple, type Pos, type PreSerializedServerMsg, ProtocolVersion, ROOT_YDOC_ID, Room, type SessionKey, type Ticket, UniqueMap, type YDocId, type YUpdate, type YVector, ackIgnoredOp, clientMsgDecoder, concatUint8Arrays, guidDecoder, isLeasedSessionExpired, jsonObjectYolo, jsonYolo, makeInMemorySnapshot, makeMetadataDB, plainLsonToNodeStream, protocolVersionDecoder, quote, serialize as serializeServerMsg, snapshotToLossyJson_eager, snapshotToLossyJson_lazy, snapshotToNodeStream, snapshotToPlainLson_eager, snapshotToPlainLson_lazy, Storage as test_only__Storage, YjsStorage as test_only__YjsStorage, transientClientMsgDecoder, tryCatch };
+export { type ActorID, type AddFeedClientMsg, type AddFeedMessageClientMsg, BackendSession, BrowserSession, ConsoleTarget, type CreateTicketOptions, DefaultMap, type DeleteFeedClientMsg, type DeleteFeedMessageClientMsg, type Feed, type FeedDeletedServerMsg, type FeedMessage, type FeedMessagesAddedServerMsg, type FeedMessagesDeletedServerMsg, type FeedMessagesListServerMsg, type FeedMessagesServerMsg, type FeedMessagesUpdatedServerMsg, FeedMsgCode, FeedRequestErrorCode, type FeedRequestFailedServerMsg, type FeedsAddedServerMsg, type FeedsListServerMsg, type FeedsServerMsg, type FeedsUpdatedServerMsg, type FetchFeedMessagesClientMsg, type FetchFeedsClientMsg, type FixOp, type Guid, type IReadableSnapshot, type IServerWebSocket, type IStorageDriver, type IStorageDriverNodeAPI, type IUserData, InMemoryDriver, type LeasedSession, type ListFeedMessagesOptions, type ListFeedMessagesResult, type ListFeedsOptions, type ListFeedsResult, type LoadingState, LogLevel, LogTarget, Logger, type MetadataDB, type Millis, NestedMap, type NodeMap, type NodeStream, type NodeTuple, type Pos, type PreSerializedServerMsg, ProtocolVersion, ROOT_YDOC_ID, Room, type SessionKey, type Ticket, UniqueMap, type UpdateFeedClientMsg, type UpdateFeedMessageClientMsg, type YDocId, type YUpdate, type YVector, ackIgnoredOp, clientMsgDecoder, concatUint8Arrays, feedFailureServerMsg, feedMetadataIdDecoder, feedMetadataUpdateDecoder, feedRequestFailed, fetchFeedsMetadataFilterDecoder, guidDecoder, isLeasedSessionExpired, jsonObjectYolo, jsonYolo, makeInMemorySnapshot, makeMetadataDB, mapFeedError, optionalFeedMetadataDecoder, plainLsonToNodeStream, protocolVersionDecoder, quote, serialize as serializeServerMsg, snapshotToLossyJson_eager, snapshotToLossyJson_lazy, snapshotToNodeStream, snapshotToPlainLson_eager, snapshotToPlainLson_lazy, Storage as test_only__Storage, YjsStorage as test_only__YjsStorage, transientClientMsgDecoder, tryCatch };