@liveblocks/core 3.20.0-pre1 → 3.20.0

package/dist/index.d.ts

@@ -64,6 +64,83 @@ type DistributiveRelax<T, Ks extends string | number | symbol> = T extends any ?
     [K in Exclude<Ks, keyof T>]?: never;
 }> : never;
 
+declare const Permission: {
+    /**
+     * Default permission for a room.
+     */
+    readonly Read: "*:read";
+    readonly Write: "*:write";
+    /**
+     * Legacy aliases for default room permissions.
+     */
+    readonly RoomWrite: "room:write";
+    readonly RoomRead: "room:read";
+    /**
+     * Storage
+     */
+    readonly StorageRead: "storage:read";
+    readonly StorageWrite: "storage:write";
+    readonly StorageNone: "storage:none";
+    /**
+     * Comments
+     */
+    readonly CommentsWrite: "comments:write";
+    readonly CommentsRead: "comments:read";
+    readonly CommentsNone: "comments:none";
+    /**
+     * Feeds
+     */
+    readonly FeedsRead: "feeds:read";
+    readonly FeedsWrite: "feeds:write";
+    readonly FeedsNone: "feeds:none";
+    /**
+     * Legacy
+     */
+    readonly LegacyRoomPresenceWrite: "room:presence:write";
+};
+type Permission = (typeof Permission)[keyof typeof Permission];
+declare const ACCESS_LEVELS: readonly ["none", "read", "write"];
+type AccessLevel = (typeof ACCESS_LEVELS)[number];
+type RequiredAccessLevel = "read" | "write";
+type PermissionMatrix = {
+    room: AccessLevel;
+    storage: AccessLevel;
+    comments: AccessLevel;
+    feeds: AccessLevel;
+    personal: AccessLevel;
+};
+type PermissionResources = keyof PermissionMatrix;
+type RoomPermissions = Permission[];
+type RoomAccesses = Record<string, RoomPermissions>;
+type UpdateRoomAccesses = Record<string, RoomPermissions | null>;
+declare function permissionMatrixFromScopes(scopes: RoomPermissions): PermissionMatrix;
+declare function hasPermissionAccess(matrix: Partial<PermissionMatrix>, resource: PermissionResources, requiredAccess: RequiredAccessLevel): boolean;
+declare function normalizeRoomPermissions(permissions: string[] | readonly string[]): RoomPermissions;
+declare function normalizeRoomAccesses(accesses: RoomAccesses | undefined): RoomAccesses | undefined;
+declare function normalizeUpdateRoomAccesses(accesses: UpdateRoomAccesses | undefined): UpdateRoomAccesses | undefined;
+/**
+ * Merges permission scopes from multiple sources, by priority: explicit user
+ * accesses override group accesses, which override the room defaults. Groups
+ * all share the same priority, so they are first merged together by taking
+ * the highest access level per feature (and base).
+ */
+declare function mergeRoomPermissionScopes({ defaultAccesses, groupsAccesses, userAccesses, }: {
+    defaultAccesses: RoomPermissions;
+    groupsAccesses: RoomPermissions[];
+    userAccesses: RoomPermissions;
+}): RoomPermissions;
+/**
+ * Validates a set of permissions:
+ * - every scope must be a known permission scope,
+ * - exactly one base permission is required (*:read, *:write, or the legacy
+ *   aliases room:read, room:write),
+ * - at most one scope per feature (storage, comments, feeds, ...),
+ * - room:presence:write is accepted as an extra legacy scope.
+ *
+ * Returns `true` when the set is valid, or an error message otherwise.
+ */
+declare function validatePermissionsSet(scopes: readonly string[]): true | string;
+
 type CustomAuthenticationResult = Relax<{
     token: string;
 } | {
@@ -132,15 +209,6 @@ type BaseUserMeta = {
     info?: IUserInfo;
 };
 
-declare enum Permission {
-    Read = "room:read",
-    Write = "room:write",
-    PresenceWrite = "room:presence:write",
-    CommentsWrite = "comments:write",
-    CommentsRead = "comments:read",
-    FeedsWrite = "feeds:write"
-}
-
 type RenameDataField<T, TFieldName extends string> = T extends any ? {
     [K in keyof T as K extends "data" ? TFieldName : K]: T[K];
 } : never;
@@ -242,90 +310,6 @@ type BatchStore<O, I> = {
     invalidate: (inputs?: I[]) => void;
 };
 
-declare const kTrigger: unique symbol;
-/**
- * Runs a callback function that is allowed to change multiple signals. At the
- * end of the batch, all changed signals will be notified (at most once).
- *
- * Nesting batches is supported.
- */
-declare function batch(callback: Callback<void>): void;
-type SignalType<S extends ISignal<any>> = S extends ISignal<infer T> ? T : never;
-interface ISignal<T> {
-    get(): T;
-    subscribe(callback: Callback<void>): UnsubscribeCallback;
-    addSink(sink: DerivedSignal<unknown>): void;
-    removeSink(sink: DerivedSignal<unknown>): void;
-}
-/**
- * Base functionality every Signal implementation needs.
- */
-declare abstract class AbstractSignal<T> implements ISignal<T>, Observable<void> {
-    #private;
-    constructor(equals?: (a: T, b: T) => boolean);
-    dispose(): void;
-    abstract get(): T;
-    get hasWatchers(): boolean;
-    [kTrigger](): void;
-    subscribe(callback: Callback<void>): UnsubscribeCallback;
-    subscribeOnce(callback: Callback<void>): UnsubscribeCallback;
-    waitUntil(): never;
-    markSinksDirty(): void;
-    addSink(sink: DerivedSignal<unknown>): void;
-    removeSink(sink: DerivedSignal<unknown>): void;
-    asReadonly(): ISignal<T>;
-}
-declare class Signal<T> extends AbstractSignal<T> {
-    #private;
-    constructor(value: T, equals?: (a: T, b: T) => boolean);
-    dispose(): void;
-    get(): T;
-    set(newValue: T | ((oldValue: T) => T)): void;
-}
-declare class DerivedSignal<T> extends AbstractSignal<T> {
-    #private;
-    static from<Ts extends unknown[], V>(...args: [...signals: {
-        [K in keyof Ts]: ISignal<Ts[K]>;
-    }, transform: (...values: Ts) => V]): DerivedSignal<V>;
-    static from<Ts extends unknown[], V>(...args: [...signals: {
-        [K in keyof Ts]: ISignal<Ts[K]>;
-    }, transform: (...values: Ts) => V, equals: (a: V, b: V) => boolean]): DerivedSignal<V>;
-    private constructor();
-    dispose(): void;
-    get isDirty(): boolean;
-    markDirty(): void;
-    get(): T;
-    /**
-     * Called by the Signal system if one or more of the dependent signals have
-     * changed. In the case of a DerivedSignal, we'll only want to re-evaluate
-     * the actual value if it's being watched, or any of their sinks are being
-     * watched actively.
-     */
-    [kTrigger](): void;
-}
-/**
- * A MutableSignal is a bit like Signal, except its state is managed by
- * a single value whose reference does not change but is mutated.
- *
- * Similar to how useSyncExternalState() works in React, there is a way to read
- * the current state at any point in time synchronously, and a way to update
- * its reference.
- */
-declare class MutableSignal<T extends object> extends AbstractSignal<T> {
-    #private;
-    constructor(initialState: T);
-    dispose(): void;
-    get(): T;
-    /**
-     * Invokes a callback function that is allowed to mutate the given state
-     * value. Do not change the value outside of the callback.
-     *
-     * If the callback explicitly returns `false`, it's assumed that the state
-     * was not changed.
-     */
-    mutate(callback?: (state: T) => void | boolean): void;
-}
-
 type ContextualPromptResponse = Relax<{
     type: "insert";
     text: string;
@@ -519,6 +503,7 @@ type HasOpId = {
  * acknowledge the receipt.
  */
 type ClientWireOp = Op & HasOpId;
+type ClientWireCreateOp = CreateOp & HasOpId;
 /**
  * ServerWireOp: Ops sent from server → client. Three variants:
  * 1. ClientWireOp — Full echo back of our own op, confirming it was applied
@@ -744,6 +729,14 @@ type SyncMode = boolean | "atomic" | SyncConfig;
 type SyncConfig = {
     [key: string]: SyncMode | undefined;
 };
+/**
+ * Deeply converts all nested lists to LiveLists, and all nested objects to
+ * LiveObjects.
+ *
+ * As such, the returned result will not contain any Json arrays or Json
+ * objects anymore.
+ */
+declare function deepLiveify(value: Json, config?: SyncMode): Lson;
 
 /**
  * Optional keys of O whose non-undefined type is plain Json (not a
@@ -864,6 +857,30 @@ type LiveListUpdate = LiveListUpdates<Lson>;
  */
 type StorageUpdate = LiveMapUpdate | LiveObjectUpdate | LiveListUpdate;
 
+/**
+ * Read-only query surface over {@link UnacknowledgedOps}, handed to CRDTs so
+ * they can look up their own still-pending Create ops without being able to
+ * mutate the set (only the room adds/acks).
+ */
+interface ReadonlyUnacknowledgedOps {
+    /** Still-unacknowledged Create ops whose `parentId` is the given one. */
+    getByParentId(parentId: string): Iterable<ClientWireCreateOp>;
+    /**
+     * Still-unacknowledged Create ops whose `parentId` and `parentKey` are both
+     * the given ones (i.e. targeting one exact position).
+     */
+    getByParentIdAndKey(parentId: string, parentKey: string): Iterable<ClientWireCreateOp>;
+    /**
+     * Whether the given pending op may already have been processed by the
+     * server. True for ops that were in flight when a connection died: the
+     * server may have stored them with the ack getting lost in the disconnect,
+     * or may never have received them. Until the (re-sent) op's ack arrives,
+     * the client cannot know which, so optimistic predictions that assume the
+     * op has not been processed yet are unsound for these ops.
+     */
+    isPossiblyStored(opId: string): boolean;
+}
+
 /**
  * The managed pool is a namespace registry (i.e. a context) that "owns" all
  * the individual live nodes, ensuring each one has a unique ID, and holding on
@@ -892,6 +909,11 @@ interface ManagedPool {
      * @returns {void}
      */
     assertStorageIsWritable: () => void;
+    /**
+     * Read-only view of the client's still-unacknowledged ops (sent or
+     * pending-send, not yet confirmed by the server).
+     */
+    readonly unacknowledgedOps: ReadonlyUnacknowledgedOps;
 }
 type CreateManagedPoolOptions = {
     /**
@@ -911,6 +933,13 @@ type CreateManagedPoolOptions = {
      * have an effect upstream.
      */
     isStorageWritable?: () => boolean;
+    /**
+     * Read-only view of the client's still-unacknowledged ops. Used by CRDTs
+     * (e.g. LiveList) to know which of their optimistic mutations the server
+     * hasn't confirmed yet. Defaults to an empty view (e.g. server-side pools
+     * that dispatch-and-flush have no optimistic state to track).
+     */
+    unacknowledgedOps?: ReadonlyUnacknowledgedOps;
 };
 /**
  * @private Private API, never use this API directly.
@@ -1649,7 +1678,7 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         subscriptions: SubscriptionData[];
         requestedAt: Date;
         nextCursor: string | null;
-        permissionHints: Record<string, Permission[]>;
+        permissionHints: Record<string, RoomPermissions>;
     }>;
     getThreadsSince(options: {
         roomId: string;
@@ -1669,7 +1698,7 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
             deleted: SubscriptionDeleteInfo[];
         };
         requestedAt: Date;
-        permissionHints: Record<string, Permission[]>;
+        permissionHints: Record<string, RoomPermissions>;
     }>;
     searchComments(options: {
         roomId: string;
@@ -1788,18 +1817,6 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         signal?: AbortSignal;
     }): Promise<CommentAttachment>;
     getOrCreateAttachmentUrlsStore(roomId: string): BatchStore<string, string>;
-    uploadChatAttachment({ chatId, attachment, signal, }: {
-        chatId: string;
-        attachment: {
-            id: string;
-            file: File;
-        };
-        signal?: AbortSignal;
-    }): Promise<void>;
-    getOrCreateChatAttachmentUrlsStore(chatId: string): BatchStore<string, string>;
-    getChatAttachmentUrl(options: {
-        attachmentId: string;
-    }): Promise<string>;
     createTextMention({ roomId, mentionId, mention, }: {
         roomId: string;
         mentionId: string;
@@ -1931,7 +1948,7 @@ interface LiveblocksHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> ex
         subscriptions: SubscriptionData[];
         nextCursor: string | null;
         requestedAt: Date;
-        permissionHints: Record<string, Permission[]>;
+        permissionHints: Record<string, RoomPermissions>;
     }>;
     getUserThreadsSince_experimental(options: {
         since: Date;
@@ -1950,7 +1967,7 @@ interface LiveblocksHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> ex
             deleted: SubscriptionDeleteInfo[];
         };
         requestedAt: Date;
-        permissionHints: Record<string, Permission[]>;
+        permissionHints: Record<string, RoomPermissions>;
     }>;
     groupsStore: BatchStore<GroupData | undefined, string>;
     getGroup(groupId: string): Promise<GroupData | undefined>;
@@ -1981,6 +1998,90 @@ declare const kInternal: unique symbol;
  */
 type NoInfr<A> = [A][A extends any ? 0 : never];
 
+declare const kTrigger: unique symbol;
+/**
+ * Runs a callback function that is allowed to change multiple signals. At the
+ * end of the batch, all changed signals will be notified (at most once).
+ *
+ * Nesting batches is supported.
+ */
+declare function batch(callback: Callback<void>): void;
+type SignalType<S extends ISignal<any>> = S extends ISignal<infer T> ? T : never;
+interface ISignal<T> {
+    get(): T;
+    subscribe(callback: Callback<void>): UnsubscribeCallback;
+    addSink(sink: DerivedSignal<unknown>): void;
+    removeSink(sink: DerivedSignal<unknown>): void;
+}
+/**
+ * Base functionality every Signal implementation needs.
+ */
+declare abstract class AbstractSignal<T> implements ISignal<T>, Observable<void> {
+    #private;
+    constructor(equals?: (a: T, b: T) => boolean);
+    dispose(): void;
+    abstract get(): T;
+    get hasWatchers(): boolean;
+    [kTrigger](): void;
+    subscribe(callback: Callback<void>): UnsubscribeCallback;
+    subscribeOnce(callback: Callback<void>): UnsubscribeCallback;
+    waitUntil(): never;
+    markSinksDirty(): void;
+    addSink(sink: DerivedSignal<unknown>): void;
+    removeSink(sink: DerivedSignal<unknown>): void;
+    asReadonly(): ISignal<T>;
+}
+declare class Signal<T> extends AbstractSignal<T> {
+    #private;
+    constructor(value: T, equals?: (a: T, b: T) => boolean);
+    dispose(): void;
+    get(): T;
+    set(newValue: T | ((oldValue: T) => T)): void;
+}
+declare class DerivedSignal<T> extends AbstractSignal<T> {
+    #private;
+    static from<Ts extends unknown[], V>(...args: [...signals: {
+        [K in keyof Ts]: ISignal<Ts[K]>;
+    }, transform: (...values: Ts) => V]): DerivedSignal<V>;
+    static from<Ts extends unknown[], V>(...args: [...signals: {
+        [K in keyof Ts]: ISignal<Ts[K]>;
+    }, transform: (...values: Ts) => V, equals: (a: V, b: V) => boolean]): DerivedSignal<V>;
+    private constructor();
+    dispose(): void;
+    get isDirty(): boolean;
+    markDirty(): void;
+    get(): T;
+    /**
+     * Called by the Signal system if one or more of the dependent signals have
+     * changed. In the case of a DerivedSignal, we'll only want to re-evaluate
+     * the actual value if it's being watched, or any of their sinks are being
+     * watched actively.
+     */
+    [kTrigger](): void;
+}
+/**
+ * A MutableSignal is a bit like Signal, except its state is managed by
+ * a single value whose reference does not change but is mutated.
+ *
+ * Similar to how useSyncExternalState() works in React, there is a way to read
+ * the current state at any point in time synchronously, and a way to update
+ * its reference.
+ */
+declare class MutableSignal<T extends object> extends AbstractSignal<T> {
+    #private;
+    constructor(initialState: T);
+    dispose(): void;
+    get(): T;
+    /**
+     * Invokes a callback function that is allowed to mutate the given state
+     * value. Do not change the value outside of the callback.
+     *
+     * If the callback explicitly returns `false`, it's assumed that the state
+     * was not changed.
+     */
+    mutate(callback?: (state: T) => void | boolean): void;
+}
+
 type Awaitable<T> = T | PromiseLike<T>;
 
 type AiConnectionErrorContext = {
@@ -2112,11 +2213,6 @@ type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS> = Resolv
      * the authentication endpoint or connect via WebSocket.
      */
     autoConnect?: boolean;
-    /**
-     * @deprecated This flag no longer has any effect and will be removed in
-     * a future version. All rooms now use the v2 storage engine by default.
-     */
-    engine?: 1 | 2;
 } & PartialUnless<P, {
     /**
      * The initial Presence to use and announce when you enter the Room. The
@@ -2424,12 +2520,6 @@ type ClientOptions<U extends BaseUserMeta = DU> = {
     lostConnectionTimeout?: number;
     backgroundKeepAliveTimeout?: number;
     polyfills?: Polyfills;
-    /**
-     * @deprecated All rooms will be migrated to the v2 storage engine in the
-     * future, which has native support for streaming. After that migration, this
-     * flag will no longer have any effect and will be removed in a future version.
-     */
-    unstable_streamData?: boolean;
     /**
      * A function that returns a list of mention suggestions matching a string.
      */
@@ -3639,10 +3729,15 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
     }>;
     /**
      * Get the room's storage synchronously.
-     * The storage's root is a {@link LiveObject}.
+     * The storage's root is a LiveObject.
      *
      * @example
-     * const root = room.getStorageSnapshot();
+     * const root = room.getStorageOrNull();
+     */
+    getStorageOrNull(): LiveObject<S> | null;
+    /**
+     * @deprecated Renamed to `Room.getStorageOrNull`. This alias will be
+     * removed in the future.
      */
     getStorageSnapshot(): LiveObject<S> | null;
     /**
@@ -3759,7 +3854,7 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         subscriptions: SubscriptionData[];
         requestedAt: Date;
         nextCursor: string | null;
-        permissionHints: Record<string, Permission[]>;
+        permissionHints: Record<string, RoomPermissions>;
     }>;
     /**
      * Returns the updated and deleted threads and their associated inbox notifications and subscriptions since the requested date.
@@ -3783,7 +3878,7 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
             deleted: SubscriptionDeleteInfo[];
         };
         requestedAt: Date;
-        permissionHints: Record<string, Permission[]>;
+        permissionHints: Record<string, RoomPermissions>;
     }>;
     /**
      * Returns a thread and the associated inbox notification and subscription if it exists.
@@ -4075,7 +4170,7 @@ type StaticSessionInfo = {
 type DynamicSessionInfo = {
     readonly actor: number;
     readonly nonce: string;
-    readonly scopes: string[];
+    readonly permissionMatrix: PermissionMatrix;
     readonly meta: JsonObject;
 };
 type Polyfills = {
@@ -5457,6 +5552,13 @@ declare class SortedList<T> {
     reposition(value: T): number;
     at(index: number): T | undefined;
     get length(): number;
+    /**
+     * Whether the given value is present, by identity. O(log n) plus the length
+     * of any run of items that share its sort key (normally 1). Bisects on the
+     * value's own key, so it only finds values sitting at their sorted position,
+     * which is true for any item currently in the list.
+     */
+    includes(value: T): boolean;
     filter(predicate: (value: T) => boolean): IterableIterator<T>;
     findAllRight(predicate: (value: T, index: number) => unknown): IterableIterator<T>;
     [Symbol.iterator](): IterableIterator<T>;
@@ -5669,4 +5771,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 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 ReadonlyJson, type ReadonlyJsonObject, 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 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, 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 AccessLevel, 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 PermissionMatrix, type PermissionResources, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type ReadonlyJson, type ReadonlyJsonObject, type RegisterStorageNode, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type RequiredAccessLevel, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomAccesses, type RoomEventMessage, type RoomPermissions, 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 ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateRoomAccesses, 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, deepLiveify, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, hasPermissionAccess, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isListStorageNode, isLiveNode, isMapStorageNode, isNotificationChannelEnabled, isNumberOperator, isObjectStorageNode, isPlainObject, isRegisterStorageNode, isRootStorageNode, isStartsWithOperator, isUrl, kInternal, keys, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, mergeRoomPermissionScopes, nanoid, nn, nodeStreamToCompactNodes, normalizeRoomAccesses, normalizeRoomPermissions, normalizeUpdateRoomAccesses, objectToQuery, patchNotificationSettings, permissionMatrixFromScopes, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, validatePermissionsSet, wait, warnOnce, warnOnceIf, withTimeout };