@liveblocks/core 2.16.1-ai → 2.16.1-ai1

package/dist/index.d.mts

@@ -151,9 +151,11 @@ type Observable<T> = {
 };
 type EventSource<T> = Observable<T> & {
     /**
-     * Notify all subscribers about the event.
+     * Notify all subscribers about the event. Will return `false` if there
+     * weren't any subscribers at the time the .notify() was called, or `true` if
+     * there was at least one subscriber.
      */
-    notify(event: T): void;
+    notify(event: T): boolean;
     /**
      * Returns the number of active subscribers.
      */
@@ -300,9 +302,6 @@ type LostConnectionEvent = "lost" | "restored" | "failed";
  * any value (except null).
  */
 type BaseAuthResult = NonNullable<Json>;
-declare class LiveblocksError extends Error {
-    code: number;
-}
 type Delegates<T extends BaseAuthResult> = {
     authenticate: () => Promise<T>;
     createSocket: (authValue: T) => IWebSocketInstance;
@@ -1056,7 +1055,7 @@ type StringOperators<T> = T | {
  *  - `startsWith` (`^` in query string)
  */
 type QueryMetadata<M extends BaseMetadata> = {
-    [K in keyof M]: string extends M[K] ? StringOperators<M[K]> : M[K];
+    [K in keyof M]: (string extends M[K] ? StringOperators<M[K]> : M[K]) | null;
 };
 
 declare global {
@@ -1522,6 +1521,84 @@ declare namespace DevToolsTreeNode {
   export type { DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode, DevToolsTreeNode_JsonTreeNode as JsonTreeNode, DevToolsTreeNode_LiveTreeNode as LiveTreeNode, DevToolsTreeNode_LsonTreeNode as LsonTreeNode, DevToolsTreeNode_TreeNode as TreeNode, DevToolsTreeNode_UserTreeNode as UserTreeNode };
 }
 
+type OptionalKeys<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? K : never;
+}[keyof T];
+type MakeOptionalFieldsNullable<T> = {
+    [K in keyof T]: K extends OptionalKeys<T> ? T[K] | null : T[K];
+};
+type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
+
+type RoomConnectionErrorContext = {
+    type: "ROOM_CONNECTION_ERROR";
+    code: -1 | 4001 | 4005 | 4006 | (number & {});
+    roomId: string;
+};
+type CommentsOrNotificationsErrorContext = {
+    type: "CREATE_THREAD_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    body: CommentBody;
+    metadata: BaseMetadata;
+} | {
+    type: "DELETE_THREAD_ERROR";
+    roomId: string;
+    threadId: string;
+} | {
+    type: "EDIT_THREAD_METADATA_ERROR";
+    roomId: string;
+    threadId: string;
+    metadata: Patchable<BaseMetadata>;
+} | {
+    type: "MARK_THREAD_AS_RESOLVED_ERROR" | "MARK_THREAD_AS_UNRESOLVED_ERROR";
+    roomId: string;
+    threadId: string;
+} | {
+    type: "CREATE_COMMENT_ERROR" | "EDIT_COMMENT_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    body: CommentBody;
+} | {
+    type: "DELETE_COMMENT_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+} | {
+    type: "ADD_REACTION_ERROR" | "REMOVE_REACTION_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    emoji: string;
+} | {
+    type: "MARK_INBOX_NOTIFICATION_AS_READ_ERROR";
+    inboxNotificationId: string;
+    roomId?: string;
+} | {
+    type: "DELETE_INBOX_NOTIFICATION_ERROR";
+    inboxNotificationId: string;
+} | {
+    type: "MARK_ALL_INBOX_NOTIFICATIONS_AS_READ_ERROR" | "DELETE_ALL_INBOX_NOTIFICATIONS_ERROR";
+} | {
+    type: "UPDATE_NOTIFICATION_SETTINGS_ERROR";
+    roomId: string;
+};
+type LiveblocksErrorContext = Relax<RoomConnectionErrorContext | CommentsOrNotificationsErrorContext>;
+declare class LiveblocksError extends Error {
+    readonly context: LiveblocksErrorContext;
+    constructor(message: string, context: LiveblocksErrorContext, cause?: Error);
+    /** Convenience accessor for error.context.roomId (if available) */
+    get roomId(): LiveblocksErrorContext["roomId"];
+    /** @deprecated Prefer using `context.code` instead, to enable type narrowing */
+    get code(): LiveblocksErrorContext["code"];
+    /**
+     * Creates a LiveblocksError from a generic error, by attaching Liveblocks
+     * contextual information like room ID, thread ID, etc.
+     */
+    static from(context: LiveblocksErrorContext, cause?: Error): LiveblocksError;
+}
+
 /**
  * Represents a user connected in a room. Treated as immutable.
  */
@@ -1575,14 +1652,6 @@ declare enum TextEditorType {
     TipTap = "tiptap"
 }
 
-type OptionalKeys<T> = {
-    [K in keyof T]-?: undefined extends T[K] ? K : never;
-}[keyof T];
-type MakeOptionalFieldsNullable<T> = {
-    [K in keyof T]: K extends OptionalKeys<T> ? T[K] | null : T[K];
-};
-type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
-
 type RoomThreadsNotificationSettings = "all" | "replies_and_mentions" | "none";
 type RoomNotificationSettings = {
     threads: RoomThreadsNotificationSettings;
@@ -1987,7 +2056,6 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         readonly self: Observable<User<P, U>>;
         readonly myPresence: Observable<P>;
         readonly others: Observable<OthersEvent<P, U>>;
-        readonly error: Observable<LiveblocksError>;
         /**
          * @deprecated Renamed to `storageBatch`. The `storage` event source will
          * soon be replaced by another/incompatible API.
@@ -2784,6 +2852,7 @@ type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly httpClient: LiveblocksHttpApi<M>;
     as<M2 extends BaseMetadata>(): Client<U, M2>;
     createSyncSource(): SyncSource;
+    emitError(context: LiveblocksErrorContext, cause?: Error): void;
 };
 type NotificationsApi<M extends BaseMetadata> = {
     /**
@@ -2976,11 +3045,9 @@ type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
     getSyncStatus(): SyncStatus;
     /**
      * All possible client events, subscribable from a single place.
-     *
-     * @private These event sources are private for now, but will become public
-     * once they're stable.
      */
     readonly events: {
+        readonly error: Observable<LiveblocksError>;
         readonly syncStatus: Observable<void>;
     };
 } & NotificationsApi<M>;
@@ -3251,10 +3318,14 @@ declare function assert(condition: boolean, errmsg: string): asserts condition;
 declare function nn<T>(value: T, errmsg?: string): NonNullable<T>;
 
 declare class HttpError extends Error {
-    message: string;
-    status: number;
-    details?: JsonObject | undefined;
-    constructor(message: string, status: number, details?: JsonObject | undefined);
+    response: Response;
+    details?: JsonObject;
+    private constructor();
+    static fromResponse(response: Response): Promise<HttpError>;
+    /**
+     * Convenience accessor for response.status.
+     */
+    get status(): number;
 }
 /**
  * Wraps a promise factory. Will create promises until one succeeds. If
@@ -3394,7 +3465,7 @@ declare const nanoid: (t?: number) => string;
  * // resolved:true AND metadata["status"]:open AND metadata["priority"]:3 AND metadata["org"]^"liveblocks:"
  * ```
  */
-type SimpleFilterValue = string | number | boolean;
+type SimpleFilterValue = string | number | boolean | null;
 type OperatorFilterValue = {
     startsWith: string;
 };
@@ -3629,11 +3700,6 @@ declare class SortedList<T> {
  * nested objects are ordered.
  */
 declare function stringify(value: unknown): string;
-/**
- * Like JSON.stringify(), but returns the same value no matter how keys in any
- * nested objects are ordered.
- */
-declare function unstringify(value: string): unknown;
 
 type QueryParams = Record<string, string | number | null | undefined> | URLSearchParams;
 /**
@@ -3788,4 +3854,4 @@ declare const CommentsApiError: typeof HttpError;
 /** @deprecated Use HttpError instead. */
 declare const NotificationsApiError: typeof HttpError;
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, 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, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, 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 RejectedStorageOpServerMsg, type Relax, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, unstringify, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, 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, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, 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 RejectedStorageOpServerMsg, type Relax, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };

package/dist/index.d.ts

@@ -151,9 +151,11 @@ type Observable<T> = {
 };
 type EventSource<T> = Observable<T> & {
     /**
-     * Notify all subscribers about the event.
+     * Notify all subscribers about the event. Will return `false` if there
+     * weren't any subscribers at the time the .notify() was called, or `true` if
+     * there was at least one subscriber.
      */
-    notify(event: T): void;
+    notify(event: T): boolean;
     /**
      * Returns the number of active subscribers.
      */
@@ -300,9 +302,6 @@ type LostConnectionEvent = "lost" | "restored" | "failed";
  * any value (except null).
  */
 type BaseAuthResult = NonNullable<Json>;
-declare class LiveblocksError extends Error {
-    code: number;
-}
 type Delegates<T extends BaseAuthResult> = {
     authenticate: () => Promise<T>;
     createSocket: (authValue: T) => IWebSocketInstance;
@@ -1056,7 +1055,7 @@ type StringOperators<T> = T | {
  *  - `startsWith` (`^` in query string)
  */
 type QueryMetadata<M extends BaseMetadata> = {
-    [K in keyof M]: string extends M[K] ? StringOperators<M[K]> : M[K];
+    [K in keyof M]: (string extends M[K] ? StringOperators<M[K]> : M[K]) | null;
 };
 
 declare global {
@@ -1522,6 +1521,84 @@ declare namespace DevToolsTreeNode {
   export type { DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode, DevToolsTreeNode_JsonTreeNode as JsonTreeNode, DevToolsTreeNode_LiveTreeNode as LiveTreeNode, DevToolsTreeNode_LsonTreeNode as LsonTreeNode, DevToolsTreeNode_TreeNode as TreeNode, DevToolsTreeNode_UserTreeNode as UserTreeNode };
 }
 
+type OptionalKeys<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? K : never;
+}[keyof T];
+type MakeOptionalFieldsNullable<T> = {
+    [K in keyof T]: K extends OptionalKeys<T> ? T[K] | null : T[K];
+};
+type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
+
+type RoomConnectionErrorContext = {
+    type: "ROOM_CONNECTION_ERROR";
+    code: -1 | 4001 | 4005 | 4006 | (number & {});
+    roomId: string;
+};
+type CommentsOrNotificationsErrorContext = {
+    type: "CREATE_THREAD_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    body: CommentBody;
+    metadata: BaseMetadata;
+} | {
+    type: "DELETE_THREAD_ERROR";
+    roomId: string;
+    threadId: string;
+} | {
+    type: "EDIT_THREAD_METADATA_ERROR";
+    roomId: string;
+    threadId: string;
+    metadata: Patchable<BaseMetadata>;
+} | {
+    type: "MARK_THREAD_AS_RESOLVED_ERROR" | "MARK_THREAD_AS_UNRESOLVED_ERROR";
+    roomId: string;
+    threadId: string;
+} | {
+    type: "CREATE_COMMENT_ERROR" | "EDIT_COMMENT_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    body: CommentBody;
+} | {
+    type: "DELETE_COMMENT_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+} | {
+    type: "ADD_REACTION_ERROR" | "REMOVE_REACTION_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    emoji: string;
+} | {
+    type: "MARK_INBOX_NOTIFICATION_AS_READ_ERROR";
+    inboxNotificationId: string;
+    roomId?: string;
+} | {
+    type: "DELETE_INBOX_NOTIFICATION_ERROR";
+    inboxNotificationId: string;
+} | {
+    type: "MARK_ALL_INBOX_NOTIFICATIONS_AS_READ_ERROR" | "DELETE_ALL_INBOX_NOTIFICATIONS_ERROR";
+} | {
+    type: "UPDATE_NOTIFICATION_SETTINGS_ERROR";
+    roomId: string;
+};
+type LiveblocksErrorContext = Relax<RoomConnectionErrorContext | CommentsOrNotificationsErrorContext>;
+declare class LiveblocksError extends Error {
+    readonly context: LiveblocksErrorContext;
+    constructor(message: string, context: LiveblocksErrorContext, cause?: Error);
+    /** Convenience accessor for error.context.roomId (if available) */
+    get roomId(): LiveblocksErrorContext["roomId"];
+    /** @deprecated Prefer using `context.code` instead, to enable type narrowing */
+    get code(): LiveblocksErrorContext["code"];
+    /**
+     * Creates a LiveblocksError from a generic error, by attaching Liveblocks
+     * contextual information like room ID, thread ID, etc.
+     */
+    static from(context: LiveblocksErrorContext, cause?: Error): LiveblocksError;
+}
+
 /**
  * Represents a user connected in a room. Treated as immutable.
  */
@@ -1575,14 +1652,6 @@ declare enum TextEditorType {
     TipTap = "tiptap"
 }
 
-type OptionalKeys<T> = {
-    [K in keyof T]-?: undefined extends T[K] ? K : never;
-}[keyof T];
-type MakeOptionalFieldsNullable<T> = {
-    [K in keyof T]: K extends OptionalKeys<T> ? T[K] | null : T[K];
-};
-type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
-
 type RoomThreadsNotificationSettings = "all" | "replies_and_mentions" | "none";
 type RoomNotificationSettings = {
     threads: RoomThreadsNotificationSettings;
@@ -1987,7 +2056,6 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         readonly self: Observable<User<P, U>>;
         readonly myPresence: Observable<P>;
         readonly others: Observable<OthersEvent<P, U>>;
-        readonly error: Observable<LiveblocksError>;
         /**
          * @deprecated Renamed to `storageBatch`. The `storage` event source will
          * soon be replaced by another/incompatible API.
@@ -2784,6 +2852,7 @@ type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly httpClient: LiveblocksHttpApi<M>;
     as<M2 extends BaseMetadata>(): Client<U, M2>;
     createSyncSource(): SyncSource;
+    emitError(context: LiveblocksErrorContext, cause?: Error): void;
 };
 type NotificationsApi<M extends BaseMetadata> = {
     /**
@@ -2976,11 +3045,9 @@ type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
     getSyncStatus(): SyncStatus;
     /**
      * All possible client events, subscribable from a single place.
-     *
-     * @private These event sources are private for now, but will become public
-     * once they're stable.
      */
     readonly events: {
+        readonly error: Observable<LiveblocksError>;
         readonly syncStatus: Observable<void>;
     };
 } & NotificationsApi<M>;
@@ -3251,10 +3318,14 @@ declare function assert(condition: boolean, errmsg: string): asserts condition;
 declare function nn<T>(value: T, errmsg?: string): NonNullable<T>;
 
 declare class HttpError extends Error {
-    message: string;
-    status: number;
-    details?: JsonObject | undefined;
-    constructor(message: string, status: number, details?: JsonObject | undefined);
+    response: Response;
+    details?: JsonObject;
+    private constructor();
+    static fromResponse(response: Response): Promise<HttpError>;
+    /**
+     * Convenience accessor for response.status.
+     */
+    get status(): number;
 }
 /**
  * Wraps a promise factory. Will create promises until one succeeds. If
@@ -3394,7 +3465,7 @@ declare const nanoid: (t?: number) => string;
  * // resolved:true AND metadata["status"]:open AND metadata["priority"]:3 AND metadata["org"]^"liveblocks:"
  * ```
  */
-type SimpleFilterValue = string | number | boolean;
+type SimpleFilterValue = string | number | boolean | null;
 type OperatorFilterValue = {
     startsWith: string;
 };
@@ -3629,11 +3700,6 @@ declare class SortedList<T> {
  * nested objects are ordered.
  */
 declare function stringify(value: unknown): string;
-/**
- * Like JSON.stringify(), but returns the same value no matter how keys in any
- * nested objects are ordered.
- */
-declare function unstringify(value: string): unknown;
 
 type QueryParams = Record<string, string | number | null | undefined> | URLSearchParams;
 /**
@@ -3788,4 +3854,4 @@ declare const CommentsApiError: typeof HttpError;
 /** @deprecated Use HttpError instead. */
 declare const NotificationsApiError: typeof HttpError;
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, 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, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, 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 RejectedStorageOpServerMsg, type Relax, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, unstringify, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, 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, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, 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 RejectedStorageOpServerMsg, type Relax, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };