@liveblocks/core 3.23.0-file1 → 3.23.0-file3

package/dist/index.d.cts

@@ -1184,6 +1184,7 @@ type BatchStore<O, I> = {
     setData: (entries: [I, O][]) => void;
     getItemState: (input: I) => AsyncResult<O> | undefined;
     getData: (input: I) => O | undefined;
+    waitUntilItemCacheExpires: (input: I) => Promise<void> | undefined;
     invalidate: (inputs?: I[]) => void;
 };
 
@@ -1731,6 +1732,10 @@ type MakeOptionalFieldsNullable<T> = {
  */
 type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
 
+type FileUrlData = {
+    readonly url: string;
+    readonly expiresAt: number;
+};
 interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
     getThreads(options: {
         roomId: string;
@@ -1906,7 +1911,7 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         file: File;
         signal?: AbortSignal;
     }): Promise<LiveFile>;
-    getOrCreateFileUrlsStore(roomId: string): BatchStore<string, string>;
+    getOrCreateFileUrlsStore(roomId: string): BatchStore<FileUrlData, string>;
     createTextMention({ roomId, mentionId, mention, }: {
         roomId: string;
         mentionId: string;
@@ -3314,7 +3319,13 @@ type LiveTreeNode<TName extends `Live${string}` = `Live${string}`> = {
     readonly key: string;
     readonly payload: LsonTreeNode[];
 };
-type LsonTreeNode = LiveTreeNode | JsonTreeNode;
+type LiveFileTreeNode = {
+    readonly type: "LiveFile";
+    readonly id: string;
+    readonly key: string;
+    readonly payload: LiveFileData;
+};
+type LsonTreeNode = LiveTreeNode | LiveFileTreeNode | JsonTreeNode;
 type UserTreeNode = {
     readonly type: "User";
     readonly id: string;
@@ -3338,12 +3349,13 @@ type TreeNode = LsonTreeNode | UserTreeNode | CustomEventTreeNode;
 
 type DevToolsTreeNode_CustomEventTreeNode = CustomEventTreeNode;
 type DevToolsTreeNode_JsonTreeNode = JsonTreeNode;
+type DevToolsTreeNode_LiveFileTreeNode = LiveFileTreeNode;
 type DevToolsTreeNode_LiveTreeNode<TName extends `Live${string}` = `Live${string}`> = LiveTreeNode<TName>;
 type DevToolsTreeNode_LsonTreeNode = LsonTreeNode;
 type DevToolsTreeNode_TreeNode = TreeNode;
 type DevToolsTreeNode_UserTreeNode = UserTreeNode;
 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 };
+  export type { DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode, DevToolsTreeNode_JsonTreeNode as JsonTreeNode, DevToolsTreeNode_LiveFileTreeNode as LiveFileTreeNode, DevToolsTreeNode_LiveTreeNode as LiveTreeNode, DevToolsTreeNode_LsonTreeNode as LsonTreeNode, DevToolsTreeNode_TreeNode as TreeNode, DevToolsTreeNode_UserTreeNode as UserTreeNode };
 }
 
 type LegacyOthersEvent<P extends JsonObject, U extends BaseUserMeta> = {
@@ -4258,7 +4270,7 @@ type PrivateRoomApi = {
         incomingMessage(data: string): void;
     };
     attachmentUrlsStore: BatchStore<string, string>;
-    fileUrlsStore: BatchStore<string, string>;
+    fileUrlsStore: BatchStore<FileUrlData, string>;
 };
 type Stackframe<P extends JsonObject> = Op | PresenceStackframe<P>;
 type PresenceStackframe<P extends JsonObject> = {
@@ -5878,4 +5890,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 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 CompactFileNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateFileOp, 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 FileStorageNode, 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, LiveFile, type LiveFileData, type LiveFileReference, 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 PlainLsonFile, 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 SerializedFile, 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 ThreadVisibility, 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 UploadFileOptions, 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, createStorageFileId, createThreadId, deepLiveify, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getLiveFileId, getMentionsFromCommentBody, getSubscriptionKey, hasPermissionAccess, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isFileStorageNode, 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 };
+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 CompactFileNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateFileOp, 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 FileStorageNode, type FileUrlData, 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, LiveFile, type LiveFileData, type LiveFileReference, 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 PlainLsonFile, 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 SerializedFile, 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 ThreadVisibility, 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 UploadFileOptions, 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, createStorageFileId, createThreadId, deepLiveify, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getLiveFileId, getMentionsFromCommentBody, getSubscriptionKey, hasPermissionAccess, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isFileStorageNode, 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 };

package/dist/index.d.ts

@@ -1184,6 +1184,7 @@ type BatchStore<O, I> = {
     setData: (entries: [I, O][]) => void;
     getItemState: (input: I) => AsyncResult<O> | undefined;
     getData: (input: I) => O | undefined;
+    waitUntilItemCacheExpires: (input: I) => Promise<void> | undefined;
     invalidate: (inputs?: I[]) => void;
 };
 
@@ -1731,6 +1732,10 @@ type MakeOptionalFieldsNullable<T> = {
  */
 type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
 
+type FileUrlData = {
+    readonly url: string;
+    readonly expiresAt: number;
+};
 interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
     getThreads(options: {
         roomId: string;
@@ -1906,7 +1911,7 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         file: File;
         signal?: AbortSignal;
     }): Promise<LiveFile>;
-    getOrCreateFileUrlsStore(roomId: string): BatchStore<string, string>;
+    getOrCreateFileUrlsStore(roomId: string): BatchStore<FileUrlData, string>;
     createTextMention({ roomId, mentionId, mention, }: {
         roomId: string;
         mentionId: string;
@@ -3314,7 +3319,13 @@ type LiveTreeNode<TName extends `Live${string}` = `Live${string}`> = {
     readonly key: string;
     readonly payload: LsonTreeNode[];
 };
-type LsonTreeNode = LiveTreeNode | JsonTreeNode;
+type LiveFileTreeNode = {
+    readonly type: "LiveFile";
+    readonly id: string;
+    readonly key: string;
+    readonly payload: LiveFileData;
+};
+type LsonTreeNode = LiveTreeNode | LiveFileTreeNode | JsonTreeNode;
 type UserTreeNode = {
     readonly type: "User";
     readonly id: string;
@@ -3338,12 +3349,13 @@ type TreeNode = LsonTreeNode | UserTreeNode | CustomEventTreeNode;
 
 type DevToolsTreeNode_CustomEventTreeNode = CustomEventTreeNode;
 type DevToolsTreeNode_JsonTreeNode = JsonTreeNode;
+type DevToolsTreeNode_LiveFileTreeNode = LiveFileTreeNode;
 type DevToolsTreeNode_LiveTreeNode<TName extends `Live${string}` = `Live${string}`> = LiveTreeNode<TName>;
 type DevToolsTreeNode_LsonTreeNode = LsonTreeNode;
 type DevToolsTreeNode_TreeNode = TreeNode;
 type DevToolsTreeNode_UserTreeNode = UserTreeNode;
 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 };
+  export type { DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode, DevToolsTreeNode_JsonTreeNode as JsonTreeNode, DevToolsTreeNode_LiveFileTreeNode as LiveFileTreeNode, DevToolsTreeNode_LiveTreeNode as LiveTreeNode, DevToolsTreeNode_LsonTreeNode as LsonTreeNode, DevToolsTreeNode_TreeNode as TreeNode, DevToolsTreeNode_UserTreeNode as UserTreeNode };
 }
 
 type LegacyOthersEvent<P extends JsonObject, U extends BaseUserMeta> = {
@@ -4258,7 +4270,7 @@ type PrivateRoomApi = {
         incomingMessage(data: string): void;
     };
     attachmentUrlsStore: BatchStore<string, string>;
-    fileUrlsStore: BatchStore<string, string>;
+    fileUrlsStore: BatchStore<FileUrlData, string>;
 };
 type Stackframe<P extends JsonObject> = Op | PresenceStackframe<P>;
 type PresenceStackframe<P extends JsonObject> = {
@@ -5878,4 +5890,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 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 CompactFileNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateFileOp, 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 FileStorageNode, 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, LiveFile, type LiveFileData, type LiveFileReference, 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 PlainLsonFile, 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 SerializedFile, 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 ThreadVisibility, 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 UploadFileOptions, 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, createStorageFileId, createThreadId, deepLiveify, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getLiveFileId, getMentionsFromCommentBody, getSubscriptionKey, hasPermissionAccess, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isFileStorageNode, 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 };
+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 CompactFileNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateFileOp, 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 FileStorageNode, type FileUrlData, 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, LiveFile, type LiveFileData, type LiveFileReference, 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 PlainLsonFile, 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 SerializedFile, 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 ThreadVisibility, 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 UploadFileOptions, 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, createStorageFileId, createThreadId, deepLiveify, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getLiveFileId, getMentionsFromCommentBody, getSubscriptionKey, hasPermissionAccess, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isFileStorageNode, 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 };

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.23.0-file1";
+var PKG_VERSION = "3.23.0-file3";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -1663,7 +1663,7 @@ var LiveFile = class _LiveFile extends AbstractCrdt {
   /** @internal */
   _toTreeNode(key) {
     return {
-      type: "Json",
+      type: "LiveFile",
       id: this._id ?? nanoid(),
       key,
       payload: this.#data
@@ -1919,8 +1919,10 @@ var Batch = class {
     this.#clearDelayTimeout();
   }
 };
-function createBatchStore(batch2) {
+function createBatchStore(batch2, options) {
   const signal = new MutableSignal(/* @__PURE__ */ new Map());
+  const cacheExpiryTimeouts = /* @__PURE__ */ new Map();
+  const pendingEnqueues = /* @__PURE__ */ new Map();
   function getCacheKey(args) {
     return stableStringify(args);
   }
@@ -1935,7 +1937,42 @@ function createBatchStore(batch2) {
       }
     });
   }
+  function clearCacheExpiry(cacheKey) {
+    const timeoutId = cacheExpiryTimeouts.get(cacheKey);
+    if (timeoutId !== void 0) {
+      clearTimeout(timeoutId);
+      cacheExpiryTimeouts.delete(cacheKey);
+    }
+  }
+  function scheduleCacheExpiry(input, expiresAt) {
+    const cacheKey = getCacheKey(input);
+    clearCacheExpiry(cacheKey);
+    if (expiresAt === void 0 || !Number.isFinite(expiresAt)) {
+      return;
+    }
+    const timeoutId = setTimeout(
+      () => {
+        cacheExpiryTimeouts.delete(cacheKey);
+        invalidate([input]);
+      },
+      Math.max(0, expiresAt - Date.now())
+    );
+    cacheExpiryTimeouts.set(cacheKey, timeoutId);
+  }
   function invalidate(inputs) {
+    if (Array.isArray(inputs)) {
+      for (const input of inputs) {
+        const cacheKey = getCacheKey(input);
+        clearCacheExpiry(cacheKey);
+        pendingEnqueues.delete(cacheKey);
+      }
+    } else {
+      for (const timeoutId of cacheExpiryTimeouts.values()) {
+        clearTimeout(timeoutId);
+      }
+      cacheExpiryTimeouts.clear();
+      pendingEnqueues.clear();
+    }
     signal.mutate((cache) => {
       if (Array.isArray(inputs)) {
         for (const input of inputs) {
@@ -1946,23 +1983,54 @@ function createBatchStore(batch2) {
       }
     });
   }
-  async function enqueue(input) {
-    const cacheKey = getCacheKey(input);
-    const cache = signal.get();
-    if (cache.has(cacheKey)) {
-      return;
-    }
+  async function processEnqueue(input, cacheKey, batchResult$, pendingEnqueueId) {
     try {
-      update({ key: cacheKey, state: { isLoading: true } });
-      const result = await batch2.get(input);
+      const result = await batchResult$;
+      if (pendingEnqueues.get(cacheKey)?.id !== pendingEnqueueId) {
+        return;
+      }
       update({ key: cacheKey, state: { isLoading: false, data: result } });
+      scheduleCacheExpiry(input, options?.getCacheExpiry?.(result));
     } catch (error3) {
+      if (pendingEnqueues.get(cacheKey)?.id !== pendingEnqueueId) {
+        return;
+      }
+      scheduleCacheExpiry(input, options?.getErrorCacheExpiry?.(error3));
       update({
         key: cacheKey,
         state: { isLoading: false, error: error3 }
       });
+    } finally {
+      if (pendingEnqueues.get(cacheKey)?.id === pendingEnqueueId) {
+        pendingEnqueues.delete(cacheKey);
+      }
     }
   }
+  function enqueue(input) {
+    const cacheKey = getCacheKey(input);
+    const existingEnqueue = pendingEnqueues.get(cacheKey);
+    if (existingEnqueue !== void 0) {
+      return existingEnqueue.promise;
+    }
+    const cache = signal.get();
+    if (cache.has(cacheKey)) {
+      return Promise.resolve();
+    }
+    const batchResult$ = batch2.get(input);
+    const pendingEnqueueId = /* @__PURE__ */ Symbol();
+    const pendingEnqueue$ = processEnqueue(
+      input,
+      cacheKey,
+      batchResult$,
+      pendingEnqueueId
+    );
+    pendingEnqueues.set(cacheKey, {
+      id: pendingEnqueueId,
+      promise: pendingEnqueue$
+    });
+    update({ key: cacheKey, state: { isLoading: true } });
+    return pendingEnqueue$;
+  }
   function setData(entries2) {
     update(
       entries2.map((entry) => ({
@@ -1970,6 +2038,9 @@ function createBatchStore(batch2) {
         state: { isLoading: false, data: entry[1] }
       }))
     );
+    for (const [input, output] of entries2) {
+      scheduleCacheExpiry(input, options?.getCacheExpiry?.(output));
+    }
   }
   function getItemState(input) {
     const cacheKey = getCacheKey(input);
@@ -1981,6 +2052,21 @@ function createBatchStore(batch2) {
     const cache = signal.get();
     return cache.get(cacheKey)?.data;
   }
+  function waitUntilItemCacheExpires(input) {
+    const cacheKey = getCacheKey(input);
+    if (!cacheExpiryTimeouts.has(cacheKey)) {
+      return void 0;
+    }
+    const initialState = signal.get().get(cacheKey);
+    return new Promise((resolve) => {
+      const unsubscribe = signal.subscribe(() => {
+        if (signal.get().get(cacheKey) !== initialState) {
+          unsubscribe();
+          resolve();
+        }
+      });
+    });
+  }
   function _cacheKeys() {
     const cache = signal.get();
     return [...cache.keys()];
@@ -1991,6 +2077,7 @@ function createBatchStore(batch2) {
     setData,
     getItemState,
     getData,
+    waitUntilItemCacheExpires,
     invalidate,
     batch: batch2,
     _cacheKeys
@@ -2274,6 +2361,10 @@ function isUrl(string) {
 // src/api-client.ts
 var ROOM_FILE_PART_SIZE = 5 * 1024 * 1024;
 var ROOM_FILE_RETRY_ATTEMPTS = 10;
+var FILE_URL_EXPIRY_BUFFER = 3e4;
+var FILE_URL_ERROR_RETRY_DELAY = 1e3;
+var FILE_URL_ERROR_MAX_ATTEMPTS = 3;
+var FILE_URL_ERROR_ATTEMPTS_EXPIRY = 3e4;
 var ROOM_FILE_RETRY_DELAYS = [
   2e3,
   2e3,
@@ -2286,10 +2377,13 @@ var ROOM_FILE_RETRY_DELAYS = [
   2e3,
   2e3
 ];
+var FileUrlRetryableError = class extends Error {
+};
 async function uploadRoomFile({
   file,
   signal,
   abortErrorMessage,
+  retryMultipartCompletion,
   uploadSingle,
   createMultipartUpload,
   uploadMultipartPart,
@@ -2304,10 +2398,7 @@ async function uploadRoomFile({
     if (signal?.aborted) {
       throw abortError;
     }
-    if (err instanceof HttpError && err.status === 413) {
-      throw err;
-    }
-    return false;
+    return err instanceof HttpError && err.status >= 400 && err.status < 500;
   };
   if (file.size <= ROOM_FILE_PART_SIZE) {
     return autoRetry(
@@ -2319,12 +2410,7 @@ async function uploadRoomFile({
   }
   let uploadId;
   const uploadedParts = [];
-  const multipartUpload = await autoRetry(
-    createMultipartUpload,
-    ROOM_FILE_RETRY_ATTEMPTS,
-    ROOM_FILE_RETRY_DELAYS,
-    handleRetryError
-  );
+  const multipartUpload = await createMultipartUpload();
   try {
     uploadId = multipartUpload.uploadId;
     if (signal?.aborted) {
@@ -2348,12 +2434,17 @@ async function uploadRoomFile({
     if (signal?.aborted) {
       throw abortError;
     }
-    return completeMultipartUpload(
-      uploadId,
-      uploadedParts.sort((a, b) => a.partNumber - b.partNumber)
+    const sortedParts = uploadedParts.sort(
+      (a, b) => a.partNumber - b.partNumber
     );
+    return retryMultipartCompletion ? autoRetry(
+      () => completeMultipartUpload(multipartUpload.uploadId, sortedParts),
+      ROOM_FILE_RETRY_ATTEMPTS,
+      ROOM_FILE_RETRY_DELAYS,
+      handleRetryError
+    ) : completeMultipartUpload(uploadId, sortedParts);
   } catch (error3) {
-    if (uploadId && isAbortOrTimeoutError(error3)) {
+    if (uploadId) {
       try {
         await abortMultipartUpload(uploadId);
       } catch {
@@ -2375,9 +2466,6 @@ function splitFileIntoParts(file) {
   }
   return parts;
 }
-function isAbortOrTimeoutError(error3) {
-  return error3 instanceof Error && (error3.name === "AbortError" || error3.name === "TimeoutError");
-}
 function createAbortError(message) {
   if (typeof DOMException === "function") {
     return new DOMException(message, "AbortError");
@@ -2706,6 +2794,7 @@ function createApiClient({
       file: attachment.file,
       signal: options.signal,
       abortErrorMessage: `Upload of attachment ${attachment.id} was aborted.`,
+      retryMultipartCompletion: false,
       uploadSingle: async () => httpClient.putBlob(
         url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/upload/${attachment.name}`,
         await authManager.getAuthValue({
@@ -2769,6 +2858,7 @@ function createApiClient({
       file,
       signal: options.signal,
       abortErrorMessage: `Upload of file ${fileId} was aborted.`,
+      retryMultipartCompletion: true,
       uploadSingle: async () => httpClient.putBlob(
         url`/v2/c/rooms/${roomId}/storage/files/${fileId}/upload/${file.name}`,
         await authManager.getAuthValue({
@@ -2854,10 +2944,37 @@ function createApiClient({
     return batch2.get(options.attachmentId);
   }
   const fileUrlsBatchStoresByRoom = new DefaultMap((roomId) => {
+    const errorAttempts = /* @__PURE__ */ new Map();
+    const clearErrorAttempts = (fileId) => {
+      const attempts = errorAttempts.get(fileId);
+      if (attempts !== void 0) {
+        clearTimeout(attempts.cleanupTimeoutId);
+        errorAttempts.delete(fileId);
+      }
+    };
+    const shouldRetryFileUrlError = (fileId) => {
+      const previousAttempts = errorAttempts.get(fileId);
+      if (previousAttempts !== void 0) {
+        clearTimeout(previousAttempts.cleanupTimeoutId);
+      }
+      const count = (previousAttempts?.count ?? 0) + 1;
+      if (count >= FILE_URL_ERROR_MAX_ATTEMPTS) {
+        errorAttempts.delete(fileId);
+        return false;
+      }
+      errorAttempts.set(fileId, {
+        count,
+        cleanupTimeoutId: setTimeout(
+          () => errorAttempts.delete(fileId),
+          FILE_URL_ERROR_ATTEMPTS_EXPIRY
+        )
+      });
+      return true;
+    };
     const batch2 = new Batch(
       async (batchedFileIds) => {
         const fileIds = batchedFileIds.flat();
-        const { urls } = await httpClient.post(
+        const { urls, expiresAt } = await httpClient.post(
           url`/v2/c/rooms/${roomId}/storage/files/presigned-urls`,
           await authManager.getAuthValue({
             roomId,
@@ -2866,20 +2983,34 @@ function createApiClient({
           }),
           { fileIds }
         );
-        return urls.map(
-          (url2) => url2 ?? new Error("There was an error while getting this file's URL")
-        );
+        const expiresAtTimestamp = Date.parse(expiresAt);
+        return urls.map((url2, index) => {
+          const fileId = fileIds[index];
+          if (url2 !== null) {
+            clearErrorAttempts(fileId);
+            return { url: url2, expiresAt: expiresAtTimestamp };
+          }
+          if (shouldRetryFileUrlError(fileId)) {
+            return new FileUrlRetryableError(
+              "There was an error while getting this file's URL"
+            );
+          }
+          return new Error("There was an error while getting this file's URL");
+        });
       },
       { delay: 50 }
     );
-    return createBatchStore(batch2);
+    return createBatchStore(batch2, {
+      getCacheExpiry: ({ expiresAt }) => expiresAt - FILE_URL_EXPIRY_BUFFER,
+      getErrorCacheExpiry: (error3) => error3 instanceof FileUrlRetryableError ? Date.now() + FILE_URL_ERROR_RETRY_DELAY : void 0
+    });
   });
   function getOrCreateFileUrlsStore(roomId) {
     return fileUrlsBatchStoresByRoom.getOrCreate(roomId);
   }
-  function getFileUrl(options) {
+  async function getFileUrl(options) {
     const batch2 = getOrCreateFileUrlsStore(options.roomId).batch;
-    return batch2.get(options.fileId);
+    return (await batch2.get(options.fileId)).url;
   }
   async function getSubscriptionSettings(options) {
     return httpClient.get(
@@ -8247,6 +8378,8 @@ function reconcile(live, json, config) {
     return reconcileLiveList(live, json, config);
   } else if (isLiveMap(live) && isPlainObject(json)) {
     return reconcileLiveMap(live, config);
+  } else if (isLiveFile(live) && shallow(live.data, json)) {
+    return live;
   } else {
     return deepLiveify(json, config);
   }
@@ -9173,8 +9306,31 @@ function isJsonEq(a, b) {
 }
 function diffNodeMap(prev, next) {
   const ops = [];
-  prev.forEach((_, id) => {
-    if (!next.get(id)) {
+  const idsToRecreate = /* @__PURE__ */ new Set();
+  next.forEach((nextCrdt, id) => {
+    const currentCrdt = prev.get(id);
+    if (currentCrdt === void 0) {
+      return;
+    }
+    if (currentCrdt.type !== nextCrdt.type || currentCrdt.type === CrdtType.FILE && nextCrdt.type === CrdtType.FILE && (currentCrdt.data.id !== nextCrdt.data.id || currentCrdt.data.name !== nextCrdt.data.name || currentCrdt.data.size !== nextCrdt.data.size || currentCrdt.data.mimeType !== nextCrdt.data.mimeType)) {
+      idsToRecreate.add(id);
+    }
+  });
+  let foundDescendant = true;
+  while (foundDescendant) {
+    foundDescendant = false;
+    for (const nodes of [prev, next]) {
+      nodes.forEach((crdt, id) => {
+        if (!idsToRecreate.has(id) && crdt.parentId !== void 0 && idsToRecreate.has(crdt.parentId)) {
+          idsToRecreate.add(id);
+          foundDescendant = true;
+        }
+      });
+    }
+  }
+  prev.forEach((crdt, id) => {
+    const parentWillBeRecreated = crdt.parentId !== void 0 && idsToRecreate.has(crdt.parentId);
+    if ((!next.has(id) || idsToRecreate.has(id)) && !parentWillBeRecreated) {
       ops.push({ type: OpCode.DELETE_CRDT, id });
     }
   });
@@ -9185,7 +9341,7 @@ function diffNodeMap(prev, next) {
     }
     emitted.add(id);
     const parentId = crdt.parentId;
-    if (parentId !== void 0 && !prev.has(parentId)) {
+    if (parentId !== void 0 && (!prev.has(parentId) || idsToRecreate.has(parentId))) {
       const parentCrdt = next.get(parentId);
       if (parentCrdt !== void 0) {
         emitCreate(parentId, parentCrdt);
@@ -9244,29 +9400,25 @@ function diffNodeMap(prev, next) {
   }
   next.forEach((crdt, id) => {
     const currentCrdt = prev.get(id);
-    if (currentCrdt) {
-      if (crdt.type === CrdtType.OBJECT) {
-        if (currentCrdt.type !== CrdtType.OBJECT) {
-          ops.push({ type: OpCode.UPDATE_OBJECT, id, data: crdt.data });
-        } else {
-          const changed = /* @__PURE__ */ new Map();
-          for (const key of Object.keys(crdt.data)) {
-            const value = crdt.data[key];
-            if (value !== void 0 && !isJsonEq(value, currentCrdt.data[key])) {
-              changed.set(key, value);
-            }
-          }
-          if (changed.size > 0) {
-            ops.push({
-              type: OpCode.UPDATE_OBJECT,
-              id,
-              data: Object.fromEntries(changed)
-            });
+    if (currentCrdt && !idsToRecreate.has(id)) {
+      if (crdt.type === CrdtType.OBJECT && currentCrdt.type === CrdtType.OBJECT) {
+        const changed = /* @__PURE__ */ new Map();
+        for (const key of Object.keys(crdt.data)) {
+          const value = crdt.data[key];
+          if (value !== void 0 && !isJsonEq(value, currentCrdt.data[key])) {
+            changed.set(key, value);
           }
-          for (const key of Object.keys(currentCrdt.data)) {
-            if (!(key in crdt.data)) {
-              ops.push({ type: OpCode.DELETE_OBJECT_KEY, id, key });
-            }
+        }
+        if (changed.size > 0) {
+          ops.push({
+            type: OpCode.UPDATE_OBJECT,
+            id,
+            data: Object.fromEntries(changed)
+          });
+        }
+        for (const key of Object.keys(currentCrdt.data)) {
+          if (!(key in crdt.data)) {
+            ops.push({ type: OpCode.DELETE_OBJECT_KEY, id, key });
           }
         }
       }