@liveblocks/core 3.22.0-rc1 → 3.23.0-file1

package/dist/index.d.ts

@@ -217,123 +217,6 @@ type BaseUserMeta = {
     info?: IUserInfo;
 };
 
-type RenameDataField<T, TFieldName extends string> = T extends any ? {
-    [K in keyof T as K extends "data" ? TFieldName : K]: T[K];
-} : never;
-type AsyncLoading<F extends string = "data"> = RenameDataField<{
-    readonly isLoading: true;
-    readonly data?: never;
-    readonly error?: never;
-}, F>;
-type AsyncSuccess<T, F extends string = "data"> = RenameDataField<{
-    readonly isLoading: false;
-    readonly data: T;
-    readonly error?: never;
-}, F>;
-type AsyncError<F extends string = "data"> = RenameDataField<{
-    readonly isLoading: false;
-    readonly data?: never;
-    readonly error: Error;
-}, F>;
-type AsyncResult<T, F extends string = "data"> = AsyncLoading<F> | AsyncSuccess<T, F> | AsyncError<F>;
-
-type Callback<T> = (event: T) => void;
-type UnsubscribeCallback = () => void;
-type Observable<T> = {
-    /**
-     * Register a callback function to be called whenever the event source emits
-     * an event.
-     */
-    subscribe(callback: Callback<T>): UnsubscribeCallback;
-    /**
-     * Register a one-time callback function to be called whenever the event
-     * source emits an event. After the event fires, the callback is
-     * auto-unsubscribed.
-     */
-    subscribeOnce(callback: Callback<T>): UnsubscribeCallback;
-    /**
-     * Returns a promise that will resolve when an event is emitted by this
-     * event source. Optionally, specify a predicate that has to match. The first
-     * event matching that predicate will then resolve the promise.
-     */
-    waitUntil(predicate?: (event: T) => boolean): Promise<T>;
-};
-type EventSource<T> = Observable<T> & {
-    /**
-     * 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): boolean;
-    /**
-     * Returns the number of active subscribers.
-     */
-    count(): number;
-    /**
-     * Observable instance, which can be used to subscribe to this event source
-     * in a readonly fashion. Safe to publicly expose.
-     */
-    observable: Observable<T>;
-    /**
-     * Disposes of this event source.
-     *
-     * Will clears all registered event listeners. None of the registered
-     * functions will ever get called again.
-     *
-     * WARNING!
-     * Be careful when using this API, because the subscribers may not have any
-     * idea they won't be notified anymore.
-     */
-    dispose(): void;
-};
-/**
- * makeEventSource allows you to generate a subscribe/notify pair of functions
- * to make subscribing easy and to get notified about events.
- *
- * The events are anonymous, so you can use it to define events, like so:
- *
- *   const event1 = makeEventSource();
- *   const event2 = makeEventSource();
- *
- *   event1.subscribe(foo);
- *   event1.subscribe(bar);
- *   event2.subscribe(qux);
- *
- *   // Unsubscription is pretty standard
- *   const unsub = event2.subscribe(foo);
- *   unsub();
- *
- *   event1.notify();  // Now foo and bar will get called
- *   event2.notify();  // Now qux will get called (but foo will not, since it's unsubscribed)
- *
- */
-declare function makeEventSource<T>(): EventSource<T>;
-
-type BatchStore<O, I> = {
-    subscribe: (callback: Callback<void>) => UnsubscribeCallback;
-    enqueue: (input: I) => Promise<void>;
-    setData: (entries: [I, O][]) => void;
-    getItemState: (input: I) => AsyncResult<O> | undefined;
-    getData: (input: I) => O | undefined;
-    invalidate: (inputs?: I[]) => void;
-};
-
-type ContextualPromptResponse = Relax<{
-    type: "insert";
-    text: string;
-} | {
-    type: "replace";
-    text: string;
-} | {
-    type: "other";
-    text: string;
-}>;
-type ContextualPromptContext = {
-    beforeSelection: string;
-    selection: string;
-    afterSelection: string;
-};
-
 declare const brand: unique symbol;
 type Brand<T, TBrand extends string> = T & {
     [brand]: TBrand;
@@ -419,6 +302,7 @@ declare const OpCode: Readonly<{
     DELETE_OBJECT_KEY: 6;
     CREATE_MAP: 7;
     CREATE_REGISTER: 8;
+    CREATE_FILE: 11;
 }>;
 declare namespace OpCode {
     type INIT = typeof OpCode.INIT;
@@ -430,13 +314,14 @@ declare namespace OpCode {
     type DELETE_OBJECT_KEY = typeof OpCode.DELETE_OBJECT_KEY;
     type CREATE_MAP = typeof OpCode.CREATE_MAP;
     type CREATE_REGISTER = typeof OpCode.CREATE_REGISTER;
+    type CREATE_FILE = typeof OpCode.CREATE_FILE;
 }
 /**
  * These operations are the payload for {@link UpdateStorageServerMsg} messages
  * only.
  */
 type Op = CreateOp | UpdateObjectOp | DeleteCrdtOp | SetParentKeyOp | DeleteObjectKeyOp;
-type CreateOp = CreateObjectOp | CreateRegisterOp | CreateMapOp | CreateListOp;
+type CreateOp = CreateObjectOp | CreateRegisterOp | CreateMapOp | CreateListOp | CreateFileOp;
 type UpdateObjectOp = {
     readonly opId?: string;
     readonly id: string;
@@ -481,6 +366,16 @@ type CreateRegisterOp = {
     readonly intent?: "set" | "push";
     readonly deletedId?: string;
 };
+type CreateFileOp = {
+    readonly opId?: string;
+    readonly id: string;
+    readonly type: OpCode.CREATE_FILE;
+    readonly parentId: string;
+    readonly parentKey: string;
+    readonly data: LiveFileData;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
+};
 type DeleteCrdtOp = {
     readonly opId?: string;
     readonly id: string;
@@ -523,6 +418,133 @@ type TheirOp = DistributiveOmit<Op, "opId"> & {
     opId?: undefined;
 };
 
+type LiveListUpdateDelta = {
+    type: "insert";
+    index: number;
+    item: Lson;
+} | {
+    type: "delete";
+    index: number;
+    deletedItem: Lson;
+} | {
+    type: "move";
+    index: number;
+    previousIndex: number;
+    item: Lson;
+} | {
+    type: "set";
+    index: number;
+    item: Lson;
+};
+/**
+ * A LiveList notification that is sent in-client to any subscribers whenever
+ * one or more of the items inside the LiveList instance have changed.
+ */
+type LiveListUpdates<TItem extends Lson> = {
+    type: "LiveList";
+    node: LiveList<TItem>;
+    updates: LiveListUpdateDelta[];
+};
+/**
+ * The LiveList class represents an ordered collection of items that is synchronized across clients.
+ */
+declare class LiveList<TItem extends Lson> extends AbstractCrdt {
+    #private;
+    constructor(items: TItem[]);
+    /**
+     * Returns the number of elements.
+     */
+    get length(): number;
+    /**
+     * Adds one element to the end of the LiveList.
+     * @param element The element to add to the end of the LiveList.
+     */
+    push(element: TItem): void;
+    /**
+     * Inserts one element at a specified index.
+     * @param element The element to insert.
+     * @param index The index at which you want to insert the element.
+     */
+    insert(element: TItem, index: number): void;
+    /**
+     * Move one element from one index to another.
+     * @param index The index of the element to move
+     * @param targetIndex The index where the element should be after moving.
+     */
+    move(index: number, targetIndex: number): void;
+    /**
+     * Deletes an element at the specified index
+     * @param index The index of the element to delete
+     */
+    delete(index: number): void;
+    clear(): void;
+    set(index: number, item: TItem): void;
+    /**
+     * Tests whether all elements pass the test implemented by the provided function.
+     * @param predicate Function to test for each element, taking two arguments (the element and its index).
+     * @returns true if the predicate function returns a truthy value for every element. Otherwise, false.
+     */
+    every(predicate: (value: TItem, index: number) => unknown): boolean;
+    /**
+     * Creates an array with all elements that pass the test implemented by the provided function.
+     * @param predicate Function to test each element of the LiveList. Return a value that coerces to true to keep the element, or to false otherwise.
+     * @returns An array with the elements that pass the test.
+     */
+    filter(predicate: (value: TItem, index: number) => unknown): TItem[];
+    /**
+     * Returns the first element that satisfies the provided testing function.
+     * @param predicate Function to execute on each value.
+     * @returns The value of the first element in the LiveList that satisfies the provided testing function. Otherwise, undefined is returned.
+     */
+    find(predicate: (value: TItem, index: number) => unknown): TItem | undefined;
+    /**
+     * Returns the index of the first element in the LiveList that satisfies the provided testing function.
+     * @param predicate Function to execute on each value until the function returns true, indicating that the satisfying element was found.
+     * @returns The index of the first element in the LiveList that passes the test. Otherwise, -1.
+     */
+    findIndex(predicate: (value: TItem, index: number) => unknown): number;
+    /**
+     * Executes a provided function once for each element.
+     * @param callbackfn Function to execute on each element.
+     */
+    forEach(callbackfn: (value: TItem, index: number) => void): void;
+    /**
+     * Get the element at the specified index.
+     * @param index The index on the element to get.
+     * @returns The element at the specified index or undefined.
+     */
+    get(index: number): TItem | undefined;
+    /**
+     * Returns the first index at which a given element can be found in the LiveList, or -1 if it is not present.
+     * @param searchElement Element to locate.
+     * @param fromIndex The index to start the search at.
+     * @returns The first index of the element in the LiveList; -1 if not found.
+     */
+    indexOf(searchElement: TItem, fromIndex?: number): number;
+    /**
+     * Returns the last index at which a given element can be found in the LiveList, or -1 if it is not present. The LiveList is searched backwards, starting at fromIndex.
+     * @param searchElement Element to locate.
+     * @param fromIndex The index at which to start searching backwards.
+     * @returns The last index of the element in the LiveList; -1 if not found.
+     */
+    lastIndexOf(searchElement: TItem, fromIndex?: number): number;
+    /**
+     * Creates an array populated with the results of calling a provided function on every element.
+     * @param callback Function that is called for every element.
+     * @returns An array with each element being the result of the callback function.
+     */
+    map<U>(callback: (value: TItem, index: number) => U): U[];
+    /**
+     * Tests whether at least one element in the LiveList passes the test implemented by the provided function.
+     * @param predicate Function to test for each element.
+     * @returns true if the callback function returns a truthy value for at least one element. Otherwise, false.
+     */
+    some(predicate: (value: TItem, index: number) => unknown): boolean;
+    [Symbol.iterator](): IterableIterator<TItem>;
+    toJSON(): readonly ToJson<TItem>[];
+    clone(): LiveList<TItem>;
+}
+
 type UpdateDelta = {
     type: "update";
 } | {
@@ -609,15 +631,17 @@ declare const CrdtType: Readonly<{
     LIST: 1;
     MAP: 2;
     REGISTER: 3;
+    FILE: 5;
 }>;
 declare namespace CrdtType {
     type OBJECT = typeof CrdtType.OBJECT;
     type LIST = typeof CrdtType.LIST;
     type MAP = typeof CrdtType.MAP;
     type REGISTER = typeof CrdtType.REGISTER;
+    type FILE = typeof CrdtType.FILE;
 }
 type SerializedCrdt = SerializedRootObject | SerializedChild;
-type SerializedChild = SerializedObject | SerializedList | SerializedMap | SerializedRegister;
+type SerializedChild = SerializedObject | SerializedList | SerializedMap | SerializedRegister | SerializedFile;
 type SerializedRootObject = {
     readonly type: CrdtType.OBJECT;
     readonly data: JsonObject;
@@ -646,13 +670,20 @@ type SerializedRegister = {
     readonly parentKey: string;
     readonly data: Json;
 };
+type SerializedFile = {
+    readonly type: CrdtType.FILE;
+    readonly parentId: string;
+    readonly parentKey: string;
+    readonly data: LiveFileData;
+};
 type StorageNode = RootStorageNode | ChildStorageNode;
-type ChildStorageNode = ObjectStorageNode | ListStorageNode | MapStorageNode | RegisterStorageNode;
+type ChildStorageNode = ObjectStorageNode | ListStorageNode | MapStorageNode | RegisterStorageNode | FileStorageNode;
 type RootStorageNode = [id: "root", value: SerializedRootObject];
 type ObjectStorageNode = [id: string, value: SerializedObject];
 type ListStorageNode = [id: string, value: SerializedList];
 type MapStorageNode = [id: string, value: SerializedMap];
 type RegisterStorageNode = [id: string, value: SerializedRegister];
+type FileStorageNode = [id: string, value: SerializedFile];
 type NodeMap = Map<string, SerializedCrdt>;
 type NodeStream = Iterable<StorageNode>;
 declare function isRootStorageNode(node: StorageNode): node is RootStorageNode;
@@ -660,8 +691,9 @@ declare function isObjectStorageNode(node: StorageNode): node is RootStorageNode
 declare function isListStorageNode(node: StorageNode): node is ListStorageNode;
 declare function isMapStorageNode(node: StorageNode): node is MapStorageNode;
 declare function isRegisterStorageNode(node: StorageNode): node is RegisterStorageNode;
+declare function isFileStorageNode(node: StorageNode): node is FileStorageNode;
 type CompactNode = CompactRootNode | CompactChildNode;
-type CompactChildNode = CompactObjectNode | CompactListNode | CompactMapNode | CompactRegisterNode;
+type CompactChildNode = CompactObjectNode | CompactListNode | CompactMapNode | CompactRegisterNode | CompactFileNode;
 type CompactRootNode = readonly [id: "root", data: JsonObject];
 type CompactObjectNode = readonly [
     id: string,
@@ -689,6 +721,13 @@ type CompactRegisterNode = readonly [
     parentKey: string,
     data: Json
 ];
+type CompactFileNode = readonly [
+    id: string,
+    type: CrdtType.FILE,
+    parentId: string,
+    parentKey: string,
+    data: LiveFileData
+];
 declare function compactNodesToNodeStream(compactNodes: CompactNode[]): NodeStream;
 declare function nodeStreamToCompactNodes(nodes: NodeStream): Iterable<CompactNode>;
 
@@ -854,6 +893,56 @@ declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
     clone(): LiveObject<O>;
 }
 
+/**
+ * INTERNAL
+ */
+declare class LiveRegister<TValue extends Json> extends AbstractCrdt {
+    #private;
+    constructor(data: TValue);
+    get data(): TValue;
+    clone(): TValue;
+}
+
+type LiveStructure = LiveObject<LsonObject> | LiveList<Lson> | LiveMap<string, Lson> | LiveFile;
+/**
+ * Think of Lson as a sibling of the Json data tree, except that the nested
+ * data structure can contain a mix of Json values and LiveStructure instances.
+ */
+type Lson = Json | LiveStructure;
+/**
+ * LiveNode is the internal tree for managing Live data structures. The key
+ * difference with Lson is that all the Json values get represented in
+ * a LiveRegister node.
+ */
+type LiveNode = LiveStructure | LiveRegister<Json>;
+/**
+ * A mapping of keys to Lson values. A Lson value is any valid JSON
+ * value or a Live storage data structure (LiveMap, LiveList, etc.)
+ */
+type LsonObject = Record<string, Lson | undefined>;
+/**
+ * Helper type to convert any valid Lson type to the equivalent Json type.
+ *
+ * Examples:
+ *
+ *   ToJson<42>                         // 42
+ *   ToJson<'hi'>                       // 'hi'
+ *   ToJson<number>                     // number
+ *   ToJson<string>                     // string
+ *   ToJson<string | LiveList<number>>  // string | readonly number[]
+ *   ToJson<LiveMap<string, LiveList<number>>>
+ *                                      // { readonly [key: string]: readonly number[] }
+ *   ToJson<LiveObject<{ a: number, b: LiveList<string>, c?: number }>>
+ *                                      // { readonly a: null, readonly b: readonly string[], readonly c?: number }
+ */
+type ToJson<L extends Lson | LsonObject> = L extends LiveList<infer I extends Lson> ? Lson extends I ? readonly ReadonlyJson[] : readonly ToJson<I>[] : L extends LiveObject<infer O extends LsonObject> ? LsonObject extends O ? ReadonlyJsonObject : {
+    readonly [K in keyof O]: ToJson<Exclude<O[K], undefined>> | (undefined extends O[K] ? undefined : never);
+} : L extends LiveMap<infer KS extends string, infer V extends Lson> ? Lson extends V ? ReadonlyJsonObject : {
+    readonly [K in KS]: ToJson<V>;
+} : L extends LiveFile ? LiveFileData : L extends LsonObject ? string extends keyof L ? ReadonlyJsonObject : {
+    readonly [K in keyof L]: ToJson<Exclude<L[K], undefined>> | (undefined extends L[K] ? undefined : never);
+} : L extends Json ? L : never;
+
 type StorageCallback = (updates: StorageUpdate[]) => void;
 type LiveMapUpdate = LiveMapUpdates<string, Lson>;
 type LiveObjectUpdate = LiveObjectUpdates<LsonObject>;
@@ -895,7 +984,6 @@ interface ReadonlyUnacknowledgedOps {
  * to live nodes before and after they are inter-connected.
  */
 interface ManagedPool {
-    readonly roomId: string;
     readonly nodes: ReadonlyMap<string, LiveNode>;
     readonly generateId: () => string;
     readonly generateOpId: () => string;
@@ -912,246 +1000,208 @@ interface ManagedPool {
     /**
      * Ensures storage can be written to else throws an error.
      * This is used to prevent writing to storage when the user does not have
-     * permission to do so.
-     * @throws {Error} if storage is not writable
-     * @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 = {
-    /**
-     * Returns the current connection ID. This is used to generate unique
-     * prefixes for nodes created by this client. This number is allowed to
-     * change over time (for example, when the client reconnects).
-     */
-    getCurrentConnectionId(): number;
-    /**
-     * Will get invoked when any Live structure calls .dispatch() on the pool.
-     */
-    onDispatch?: (ops: ClientWireOp[], reverse: Op[], storageUpdates: Map<string, StorageUpdate>) => void;
-    /**
-     * Will get invoked when any Live structure calls .assertStorageIsWritable()
-     * on the pool. Defaults to true when not provided. Return false if you want
-     * to prevent writes to the pool locally early, because you know they won't
-     * 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.
- */
-declare function createManagedPool(roomId: string, options: CreateManagedPoolOptions): ManagedPool;
-declare abstract class AbstractCrdt {
-    #private;
-    get roomId(): string | null;
-    /**
-     * @private
-     * Returns true if the cached JSON snapshot exists and is reference-equal
-     * to the given value. Does not trigger a recompute.
-     */
-    hasCache(value: unknown): boolean;
-    /**
-     * Return a JSON-compatible snapshot of this Live node and its children.
-     * LiveObject values become plain objects, LiveList values become arrays,
-     * and LiveMap values also become plain objects (not Map instances).
-     * The result is cached and only recomputed when the contents change.
-     */
-    toJSON(): ReadonlyJson;
-    /**
-     * Returns a deep clone of the current LiveStructure, suitable for insertion
-     * in the tree elsewhere.
-     */
-    abstract clone(): Lson;
-}
-
-type LiveListUpdateDelta = {
-    type: "insert";
-    index: number;
-    item: Lson;
-} | {
-    type: "delete";
-    index: number;
-    deletedItem: Lson;
-} | {
-    type: "move";
-    index: number;
-    previousIndex: number;
-    item: Lson;
-} | {
-    type: "set";
-    index: number;
-    item: Lson;
-};
-/**
- * A LiveList notification that is sent in-client to any subscribers whenever
- * one or more of the items inside the LiveList instance have changed.
- */
-type LiveListUpdates<TItem extends Lson> = {
-    type: "LiveList";
-    node: LiveList<TItem>;
-    updates: LiveListUpdateDelta[];
-};
-/**
- * The LiveList class represents an ordered collection of items that is synchronized across clients.
- */
-declare class LiveList<TItem extends Lson> extends AbstractCrdt {
-    #private;
-    constructor(items: TItem[]);
-    /**
-     * Returns the number of elements.
-     */
-    get length(): number;
-    /**
-     * Adds one element to the end of the LiveList.
-     * @param element The element to add to the end of the LiveList.
-     */
-    push(element: TItem): void;
-    /**
-     * Inserts one element at a specified index.
-     * @param element The element to insert.
-     * @param index The index at which you want to insert the element.
-     */
-    insert(element: TItem, index: number): void;
-    /**
-     * Move one element from one index to another.
-     * @param index The index of the element to move
-     * @param targetIndex The index where the element should be after moving.
-     */
-    move(index: number, targetIndex: number): void;
-    /**
-     * Deletes an element at the specified index
-     * @param index The index of the element to delete
-     */
-    delete(index: number): void;
-    clear(): void;
-    set(index: number, item: TItem): void;
-    /**
-     * Tests whether all elements pass the test implemented by the provided function.
-     * @param predicate Function to test for each element, taking two arguments (the element and its index).
-     * @returns true if the predicate function returns a truthy value for every element. Otherwise, false.
-     */
-    every(predicate: (value: TItem, index: number) => unknown): boolean;
-    /**
-     * Creates an array with all elements that pass the test implemented by the provided function.
-     * @param predicate Function to test each element of the LiveList. Return a value that coerces to true to keep the element, or to false otherwise.
-     * @returns An array with the elements that pass the test.
+     * permission to do so.
+     * @throws {Error} if storage is not writable
+     * @returns {void}
      */
-    filter(predicate: (value: TItem, index: number) => unknown): TItem[];
+    assertStorageIsWritable: () => void;
     /**
-     * Returns the first element that satisfies the provided testing function.
-     * @param predicate Function to execute on each value.
-     * @returns The value of the first element in the LiveList that satisfies the provided testing function. Otherwise, undefined is returned.
+     * Read-only view of the client's still-unacknowledged ops (sent or
+     * pending-send, not yet confirmed by the server).
      */
-    find(predicate: (value: TItem, index: number) => unknown): TItem | undefined;
+    readonly unacknowledgedOps: ReadonlyUnacknowledgedOps;
+}
+type CreateManagedPoolOptions = {
     /**
-     * Returns the index of the first element in the LiveList that satisfies the provided testing function.
-     * @param predicate Function to execute on each value until the function returns true, indicating that the satisfying element was found.
-     * @returns The index of the first element in the LiveList that passes the test. Otherwise, -1.
+     * Returns the current connection ID. This is used to generate unique
+     * prefixes for nodes created by this client. This number is allowed to
+     * change over time (for example, when the client reconnects).
      */
-    findIndex(predicate: (value: TItem, index: number) => unknown): number;
+    getCurrentConnectionId(): number;
     /**
-     * Executes a provided function once for each element.
-     * @param callbackfn Function to execute on each element.
+     * Will get invoked when any Live structure calls .dispatch() on the pool.
      */
-    forEach(callbackfn: (value: TItem, index: number) => void): void;
+    onDispatch?: (ops: ClientWireOp[], reverse: Op[], storageUpdates: Map<string, StorageUpdate>) => void;
     /**
-     * Get the element at the specified index.
-     * @param index The index on the element to get.
-     * @returns The element at the specified index or undefined.
+     * Will get invoked when any Live structure calls .assertStorageIsWritable()
+     * on the pool. Defaults to true when not provided. Return false if you want
+     * to prevent writes to the pool locally early, because you know they won't
+     * have an effect upstream.
      */
-    get(index: number): TItem | undefined;
+    isStorageWritable?: () => boolean;
     /**
-     * Returns the first index at which a given element can be found in the LiveList, or -1 if it is not present.
-     * @param searchElement Element to locate.
-     * @param fromIndex The index to start the search at.
-     * @returns The first index of the element in the LiveList; -1 if not found.
+     * 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).
      */
-    indexOf(searchElement: TItem, fromIndex?: number): number;
+    unacknowledgedOps?: ReadonlyUnacknowledgedOps;
+};
+/**
+ * @private Private API, never use this API directly.
+ */
+declare function createManagedPool(options: CreateManagedPoolOptions): ManagedPool;
+declare abstract class AbstractCrdt {
+    #private;
     /**
-     * Returns the last index at which a given element can be found in the LiveList, or -1 if it is not present. The LiveList is searched backwards, starting at fromIndex.
-     * @param searchElement Element to locate.
-     * @param fromIndex The index at which to start searching backwards.
-     * @returns The last index of the element in the LiveList; -1 if not found.
+     * @private
+     * Returns true if the cached JSON snapshot exists and is reference-equal
+     * to the given value. Does not trigger a recompute.
      */
-    lastIndexOf(searchElement: TItem, fromIndex?: number): number;
+    hasCache(value: unknown): boolean;
     /**
-     * Creates an array populated with the results of calling a provided function on every element.
-     * @param callback Function that is called for every element.
-     * @returns An array with each element being the result of the callback function.
+     * Return a JSON-compatible snapshot of this Live node and its children.
+     * LiveObject values become plain objects, LiveList values become arrays,
+     * and LiveMap values also become plain objects (not Map instances).
+     * The result is cached and only recomputed when the contents change.
      */
-    map<U>(callback: (value: TItem, index: number) => U): U[];
+    toJSON(): ReadonlyJson;
     /**
-     * Tests whether at least one element in the LiveList passes the test implemented by the provided function.
-     * @param predicate Function to test for each element.
-     * @returns true if the callback function returns a truthy value for at least one element. Otherwise, false.
+     * Returns a deep clone of the current LiveStructure, suitable for insertion
+     * in the tree elsewhere.
      */
-    some(predicate: (value: TItem, index: number) => unknown): boolean;
-    [Symbol.iterator](): IterableIterator<TItem>;
-    toJSON(): readonly ToJson<TItem>[];
-    clone(): LiveList<TItem>;
+    abstract clone(): Lson;
 }
 
+type LiveFileData = {
+    readonly id: string;
+    readonly name: string;
+    readonly size: number;
+    readonly mimeType: string;
+};
+type LiveFileReference = LiveFile | LiveFileData | string;
+declare function getLiveFileId(file: LiveFileReference): string;
 /**
- * INTERNAL
+ * A LiveFile is an immutable Storage leaf that references file bytes stored
+ * outside the realtime Storage tree.
  */
-declare class LiveRegister<TValue extends Json> extends AbstractCrdt {
+declare class LiveFile extends AbstractCrdt {
     #private;
-    constructor(data: TValue);
-    get data(): TValue;
-    clone(): TValue;
+    constructor(data: LiveFileData);
+    get data(): Readonly<LiveFileData>;
+    get id(): string;
+    get name(): string;
+    get size(): number;
+    get mimeType(): string;
+    clone(): LiveFile;
 }
 
-type LiveStructure = LiveObject<LsonObject> | LiveList<Lson> | LiveMap<string, Lson>;
-/**
- * Think of Lson as a sibling of the Json data tree, except that the nested
- * data structure can contain a mix of Json values and LiveStructure instances.
- */
-type Lson = Json | LiveStructure;
-/**
- * LiveNode is the internal tree for managing Live data structures. The key
- * difference with Lson is that all the Json values get represented in
- * a LiveRegister node.
- */
-type LiveNode = LiveStructure | LiveRegister<Json>;
-/**
- * A mapping of keys to Lson values. A Lson value is any valid JSON
- * value or a Live storage data structure (LiveMap, LiveList, etc.)
- */
-type LsonObject = Record<string, Lson | undefined>;
+type RenameDataField<T, TFieldName extends string> = T extends any ? {
+    [K in keyof T as K extends "data" ? TFieldName : K]: T[K];
+} : never;
+type AsyncLoading<F extends string = "data"> = RenameDataField<{
+    readonly isLoading: true;
+    readonly data?: never;
+    readonly error?: never;
+}, F>;
+type AsyncSuccess<T, F extends string = "data"> = RenameDataField<{
+    readonly isLoading: false;
+    readonly data: T;
+    readonly error?: never;
+}, F>;
+type AsyncError<F extends string = "data"> = RenameDataField<{
+    readonly isLoading: false;
+    readonly data?: never;
+    readonly error: Error;
+}, F>;
+type AsyncResult<T, F extends string = "data"> = AsyncLoading<F> | AsyncSuccess<T, F> | AsyncError<F>;
+
+type Callback<T> = (event: T) => void;
+type UnsubscribeCallback = () => void;
+type Observable<T> = {
+    /**
+     * Register a callback function to be called whenever the event source emits
+     * an event.
+     */
+    subscribe(callback: Callback<T>): UnsubscribeCallback;
+    /**
+     * Register a one-time callback function to be called whenever the event
+     * source emits an event. After the event fires, the callback is
+     * auto-unsubscribed.
+     */
+    subscribeOnce(callback: Callback<T>): UnsubscribeCallback;
+    /**
+     * Returns a promise that will resolve when an event is emitted by this
+     * event source. Optionally, specify a predicate that has to match. The first
+     * event matching that predicate will then resolve the promise.
+     */
+    waitUntil(predicate?: (event: T) => boolean): Promise<T>;
+};
+type EventSource<T> = Observable<T> & {
+    /**
+     * 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): boolean;
+    /**
+     * Returns the number of active subscribers.
+     */
+    count(): number;
+    /**
+     * Observable instance, which can be used to subscribe to this event source
+     * in a readonly fashion. Safe to publicly expose.
+     */
+    observable: Observable<T>;
+    /**
+     * Disposes of this event source.
+     *
+     * Will clears all registered event listeners. None of the registered
+     * functions will ever get called again.
+     *
+     * WARNING!
+     * Be careful when using this API, because the subscribers may not have any
+     * idea they won't be notified anymore.
+     */
+    dispose(): void;
+};
 /**
- * Helper type to convert any valid Lson type to the equivalent Json type.
+ * makeEventSource allows you to generate a subscribe/notify pair of functions
+ * to make subscribing easy and to get notified about events.
  *
- * Examples:
+ * The events are anonymous, so you can use it to define events, like so:
+ *
+ *   const event1 = makeEventSource();
+ *   const event2 = makeEventSource();
+ *
+ *   event1.subscribe(foo);
+ *   event1.subscribe(bar);
+ *   event2.subscribe(qux);
+ *
+ *   // Unsubscription is pretty standard
+ *   const unsub = event2.subscribe(foo);
+ *   unsub();
+ *
+ *   event1.notify();  // Now foo and bar will get called
+ *   event2.notify();  // Now qux will get called (but foo will not, since it's unsubscribed)
  *
- *   ToJson<42>                         // 42
- *   ToJson<'hi'>                       // 'hi'
- *   ToJson<number>                     // number
- *   ToJson<string>                     // string
- *   ToJson<string | LiveList<number>>  // string | readonly number[]
- *   ToJson<LiveMap<string, LiveList<number>>>
- *                                      // { readonly [key: string]: readonly number[] }
- *   ToJson<LiveObject<{ a: number, b: LiveList<string>, c?: number }>>
- *                                      // { readonly a: null, readonly b: readonly string[], readonly c?: number }
  */
-type ToJson<L extends Lson | LsonObject> = L extends LiveList<infer I extends Lson> ? Lson extends I ? readonly ReadonlyJson[] : readonly ToJson<I>[] : L extends LiveObject<infer O extends LsonObject> ? LsonObject extends O ? ReadonlyJsonObject : {
-    readonly [K in keyof O]: ToJson<Exclude<O[K], undefined>> | (undefined extends O[K] ? undefined : never);
-} : L extends LiveMap<infer KS extends string, infer V extends Lson> ? Lson extends V ? ReadonlyJsonObject : {
-    readonly [K in KS]: ToJson<V>;
-} : L extends LsonObject ? string extends keyof L ? ReadonlyJsonObject : {
-    readonly [K in keyof L]: ToJson<Exclude<L[K], undefined>> | (undefined extends L[K] ? undefined : never);
-} : L extends Json ? L : never;
+declare function makeEventSource<T>(): EventSource<T>;
+
+type BatchStore<O, I> = {
+    subscribe: (callback: Callback<void>) => UnsubscribeCallback;
+    enqueue: (input: I) => Promise<void>;
+    setData: (entries: [I, O][]) => void;
+    getItemState: (input: I) => AsyncResult<O> | undefined;
+    getData: (input: I) => O | undefined;
+    invalidate: (inputs?: I[]) => void;
+};
+
+type ContextualPromptResponse = Relax<{
+    type: "insert";
+    text: string;
+} | {
+    type: "replace";
+    text: string;
+} | {
+    type: "other";
+    text: string;
+}>;
+type ContextualPromptContext = {
+    beforeSelection: string;
+    selection: string;
+    afterSelection: string;
+};
 
 type DateToString<T> = {
     [P in keyof T]: T[P] extends Date ? string : T[P] extends Date | null ? string | null : T[P] extends Date | undefined ? string | undefined : T[P];
@@ -1847,6 +1897,16 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         signal?: AbortSignal;
     }): Promise<CommentAttachment>;
     getOrCreateAttachmentUrlsStore(roomId: string): BatchStore<string, string>;
+    getFileUrl(options: {
+        roomId: string;
+        fileId: string;
+    }): Promise<string>;
+    uploadFile({ roomId, file, signal, }: {
+        roomId: string;
+        file: File;
+        signal?: AbortSignal;
+    }): Promise<LiveFile>;
+    getOrCreateFileUrlsStore(roomId: string): BatchStore<string, string>;
     createTextMention({ roomId, mentionId, mention, }: {
         roomId: string;
         mentionId: string;
@@ -1856,13 +1916,21 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         roomId: string;
         mentionId: string;
     }): Promise<void>;
-    getYjsHistoryVersion({ roomId, versionId, }: {
+    fetchStorageHistoryVersion({ roomId, versionId, }: {
+        roomId: string;
+        versionId: string;
+    }): Promise<Response>;
+    fetchYjsHistoryVersion({ roomId, versionId, }: {
         roomId: string;
         versionId: string;
     }): Promise<Response>;
     createVersionHistorySnapshot({ roomId }: {
         roomId: string;
     }): Promise<void>;
+    deleteHistoryVersion({ roomId, versionId, }: {
+        roomId: string;
+        versionId: string;
+    }): Promise<void>;
     reportTextEditor({ roomId, type, rootKey, }: {
         roomId: string;
         type: TextEditorType;
@@ -3565,6 +3633,9 @@ type GetThreadsSinceOptions = {
 type UploadAttachmentOptions = {
     signal?: AbortSignal;
 };
+type UploadFileOptions = {
+    signal?: AbortSignal;
+};
 type ListTextVersionsSinceOptions = {
     since: Date;
     signal?: AbortSignal;
@@ -4073,6 +4144,23 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * await room.getAttachmentUrl("at_xxx");
      */
     getAttachmentUrl(attachmentId: string): Promise<string>;
+    /**
+     * Uploads a file for a `LiveFile`.
+     *
+     * @example
+     * const liveFile = await room.uploadFile(file);
+     */
+    uploadFile(file: File, options?: UploadFileOptions): Promise<LiveFile>;
+    /**
+     * Returns a presigned URL for a `LiveFile`.
+     *
+     * @example
+     * await getFileUrl("fl_xxx");
+     *
+     * @example
+     * await getFileUrl(liveFile);
+     */
+    getFileUrl(file: LiveFileReference): Promise<string>;
     /**
      * Gets the user's subscription settings for the current room.
      *
@@ -4149,8 +4237,12 @@ type PrivateRoomApi = {
         versions: HistoryVersion[];
         requestedAt: Date;
     }>;
-    getYjsHistoryVersion(versionId: string): Promise<Response>;
+    fetchStorageHistoryVersion(versionId: string): Promise<Response>;
+    fetchYjsHistoryVersion(versionId: string): Promise<Response>;
+    liveObjectFromNodeStream(nodes: NodeStream): LiveObject<LsonObject>;
+    reconcileStorageWithNodes(nodes: NodeStream): void;
     createVersionHistorySnapshot(): Promise<void>;
+    deleteHistoryVersion(versionId: string): Promise<void>;
     executeContextualPrompt(options: {
         prompt: string;
         context: ContextualPromptContext;
@@ -4166,6 +4258,7 @@ type PrivateRoomApi = {
         incomingMessage(data: string): void;
     };
     attachmentUrlsStore: BatchStore<string, string>;
+    fileUrlsStore: BatchStore<string, string>;
 };
 type Stackframe<P extends JsonObject> = Op | PresenceStackframe<P>;
 type PresenceStackframe<P extends JsonObject> = {
@@ -5065,7 +5158,11 @@ type PlainLsonList = {
     liveblocksType: "LiveList";
     data: PlainLson[];
 };
-type PlainLson = PlainLsonObject | PlainLsonMap | PlainLsonList | Json;
+type PlainLsonFile = {
+    liveblocksType: "LiveFile";
+    data: LiveFileData;
+};
+type PlainLson = PlainLsonObject | PlainLsonMap | PlainLsonList | PlainLsonFile | Json;
 
 /**
  * Returns PlainLson for a given Json or LiveStructure, suitable for calling the storage init api
@@ -5173,6 +5270,7 @@ declare function Promise_withResolvers<T>(): ControlledPromise<T>;
 declare function createThreadId(): string;
 declare function createCommentId(): string;
 declare function createCommentAttachmentId(): string;
+declare function createStorageFileId(): string;
 declare function createInboxNotificationId(): string;
 
 /**
@@ -5780,4 +5878,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 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 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 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 };
+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 };