loro-crdt 1.4.1 → 1.4.2

package/bundler/loro_wasm.d.ts

@@ -109,7 +109,7 @@ interface LoroDoc {
      *  text = doc.getContainerById(textId);
      *  ```
      */
-    getContainerById(id: ContainerID): Container;
+    getContainerById(id: ContainerID): Container | undefined;
 
     /**
      * Subscribe to updates from local edits.
@@ -1859,6 +1859,8 @@ export class LoroDoc {
 * The object returned is a new js object each time because it need to cross
 * the WASM boundary.
 *
+* If the container does not exist, an error will be thrown.
+*
 * @example
 * ```ts
 * import { LoroDoc } from "loro-crdt";
@@ -1872,11 +1874,43 @@ export class LoroDoc {
   getText(cid: ContainerID | string): LoroText;
 /**
 * Get a LoroCounter by container id
+*
+* If the container does not exist, an error will be thrown.
 * @param {ContainerID | string} cid
 * @returns {LoroCounter}
 */
   getCounter(cid: ContainerID | string): LoroCounter;
 /**
+* Check if the doc contains the target container.
+*
+* A root container always exists, while a normal container exists
+* if it has ever been created on the doc.
+*
+* @example
+* ```ts
+* import { LoroDoc, LoroMap, LoroText, LoroList } from "loro-crdt";
+*
+* const doc = new LoroDoc();
+* doc.setPeerId("1");
+* const text = doc.getMap("map").setContainer("text", new LoroText());
+* const list = doc.getMap("map").setContainer("list", new LoroList());
+* expect(doc.isContainerExists("cid:root-map:Map")).toBe(true);
+* expect(doc.isContainerExists("cid:0@1:Text")).toBe(true);
+* expect(doc.isContainerExists("cid:1@1:List")).toBe(true);
+*
+* const doc2 = new LoroDoc();
+* // Containers exist, as long as the history or the doc state include it
+* doc.detach();
+* doc2.import(doc.export({ mode: "update" }));
+* expect(doc2.isContainerExists("cid:root-map:Map")).toBe(true);
+* expect(doc2.isContainerExists("cid:0@1:Text")).toBe(true);
+* expect(doc2.isContainerExists("cid:1@1:List")).toBe(true);
+* ```
+* @param {ContainerID} container_id
+* @returns {boolean}
+*/
+  hasContainer(container_id: ContainerID): boolean;
+/**
 * Set the commit message of the next commit
 * @param {string} msg
 */

package/bundler/loro_wasm_bg.js

@@ -1457,6 +1457,8 @@ export class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1489,6 +1491,8 @@ export class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1521,6 +1525,8 @@ export class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1553,6 +1559,8 @@ export class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1581,6 +1589,8 @@ export class LoroDoc {
     }
     /**
     * Get a LoroCounter by container id
+    *
+    * If the container does not exist, an error will be thrown.
     * @param {ContainerID | string} cid
     * @returns {LoroCounter}
     */
@@ -1606,6 +1616,8 @@ export class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1633,8 +1645,42 @@ export class LoroDoc {
         }
     }
     /**
-    * Get the container corresponding to the container id
+    * Check if the doc contains the target container.
     *
+    * A root container always exists, while a normal container exists
+    * if it has ever been created on the doc.
+    *
+    * @example
+    * ```ts
+    * import { LoroDoc, LoroMap, LoroText, LoroList } from "loro-crdt";
+    *
+    * const doc = new LoroDoc();
+    * doc.setPeerId("1");
+    * const text = doc.getMap("map").setContainer("text", new LoroText());
+    * const list = doc.getMap("map").setContainer("list", new LoroList());
+    * expect(doc.isContainerExists("cid:root-map:Map")).toBe(true);
+    * expect(doc.isContainerExists("cid:0@1:Text")).toBe(true);
+    * expect(doc.isContainerExists("cid:1@1:List")).toBe(true);
+    *
+    * const doc2 = new LoroDoc();
+    * // Containers exist, as long as the history or the doc state include it
+    * doc.detach();
+    * doc2.import(doc.export({ mode: "update" }));
+    * expect(doc2.isContainerExists("cid:root-map:Map")).toBe(true);
+    * expect(doc2.isContainerExists("cid:0@1:Text")).toBe(true);
+    * expect(doc2.isContainerExists("cid:1@1:List")).toBe(true);
+    * ```
+    * @param {ContainerID} container_id
+    * @returns {boolean}
+    */
+    hasContainer(container_id) {
+        const ret = wasm.lorodoc_hasContainer(this.__wbg_ptr, addHeapObject(container_id));
+        return ret !== 0;
+    }
+    /**
+    * Get the container corresponding to the container id.
+    *
+    * If the container does not exist, it returns `undefined`.
     *
     * @example
     * ```ts
@@ -6013,28 +6059,33 @@ export function __wbindgen_object_drop_ref(arg0) {
     takeObject(arg0);
 };
 
+export function __wbg_lorocounter_new(arg0) {
+    const ret = LoroCounter.__wrap(arg0);
+    return addHeapObject(ret);
+};
+
 export function __wbg_lorotreenode_new(arg0) {
     const ret = LoroTreeNode.__wrap(arg0);
     return addHeapObject(ret);
 };
 
-export function __wbg_lorotree_new(arg0) {
-    const ret = LoroTree.__wrap(arg0);
+export function __wbg_cursor_new(arg0) {
+    const ret = Cursor.__wrap(arg0);
     return addHeapObject(ret);
 };
 
-export function __wbg_lorolist_new(arg0) {
-    const ret = LoroList.__wrap(arg0);
+export function __wbg_loromap_new(arg0) {
+    const ret = LoroMap.__wrap(arg0);
     return addHeapObject(ret);
 };
 
-export function __wbg_lorocounter_new(arg0) {
-    const ret = LoroCounter.__wrap(arg0);
+export function __wbg_lorotext_new(arg0) {
+    const ret = LoroText.__wrap(arg0);
     return addHeapObject(ret);
 };
 
-export function __wbg_loromap_new(arg0) {
-    const ret = LoroMap.__wrap(arg0);
+export function __wbg_lorotree_new(arg0) {
+    const ret = LoroTree.__wrap(arg0);
     return addHeapObject(ret);
 };
 
@@ -6043,13 +6094,8 @@ export function __wbg_loromovablelist_new(arg0) {
     return addHeapObject(ret);
 };
 
-export function __wbg_lorotext_new(arg0) {
-    const ret = LoroText.__wrap(arg0);
-    return addHeapObject(ret);
-};
-
-export function __wbg_cursor_new(arg0) {
-    const ret = Cursor.__wrap(arg0);
+export function __wbg_lorolist_new(arg0) {
+    const ret = LoroList.__wrap(arg0);
     return addHeapObject(ret);
 };
 
@@ -6281,7 +6327,7 @@ export function __wbg_error_f851667af71bcfc6(arg0, arg1) {
     }
 };
 
-export const __wbg_now_bc6f749123583eb9 = typeof Date.now == 'function' ? Date.now : notDefined('Date.now');
+export const __wbg_now_cd30a09c9b727b65 = typeof Date.now == 'function' ? Date.now : notDefined('Date.now');
 
 export function __wbg_crypto_1d1f22824a6a080c(arg0) {
     const ret = getObject(arg0).crypto;
@@ -6606,12 +6652,12 @@ export function __wbindgen_memory() {
 };
 
 export function __wbindgen_closure_wrapper482(arg0, arg1, arg2) {
-    const ret = makeMutClosure(arg0, arg1, 10, __wbg_adapter_60);
+    const ret = makeMutClosure(arg0, arg1, 8, __wbg_adapter_60);
     return addHeapObject(ret);
 };
 
 export function __wbindgen_closure_wrapper485(arg0, arg1, arg2) {
-    const ret = makeMutClosure(arg0, arg1, 8, __wbg_adapter_63);
+    const ret = makeMutClosure(arg0, arg1, 10, __wbg_adapter_63);
     return addHeapObject(ret);
 };
 

package/bundler/loro_wasm_bg.wasm.d.ts

@@ -59,6 +59,7 @@ export function lorodoc_getList(a: number, b: number, c: number): void;
 export function lorodoc_getMovableList(a: number, b: number, c: number): void;
 export function lorodoc_getCounter(a: number, b: number, c: number): void;
 export function lorodoc_getTree(a: number, b: number, c: number): void;
+export function lorodoc_hasContainer(a: number, b: number): number;
 export function lorodoc_getContainerById(a: number, b: number, c: number): void;
 export function lorodoc_setNextCommitMessage(a: number, b: number, c: number): void;
 export function lorodoc_getDeepValueWithID(a: number): number;

package/nodejs/loro_wasm.d.ts

@@ -109,7 +109,7 @@ interface LoroDoc {
      *  text = doc.getContainerById(textId);
      *  ```
      */
-    getContainerById(id: ContainerID): Container;
+    getContainerById(id: ContainerID): Container | undefined;
 
     /**
      * Subscribe to updates from local edits.
@@ -1859,6 +1859,8 @@ export class LoroDoc {
 * The object returned is a new js object each time because it need to cross
 * the WASM boundary.
 *
+* If the container does not exist, an error will be thrown.
+*
 * @example
 * ```ts
 * import { LoroDoc } from "loro-crdt";
@@ -1872,11 +1874,43 @@ export class LoroDoc {
   getText(cid: ContainerID | string): LoroText;
 /**
 * Get a LoroCounter by container id
+*
+* If the container does not exist, an error will be thrown.
 * @param {ContainerID | string} cid
 * @returns {LoroCounter}
 */
   getCounter(cid: ContainerID | string): LoroCounter;
 /**
+* Check if the doc contains the target container.
+*
+* A root container always exists, while a normal container exists
+* if it has ever been created on the doc.
+*
+* @example
+* ```ts
+* import { LoroDoc, LoroMap, LoroText, LoroList } from "loro-crdt";
+*
+* const doc = new LoroDoc();
+* doc.setPeerId("1");
+* const text = doc.getMap("map").setContainer("text", new LoroText());
+* const list = doc.getMap("map").setContainer("list", new LoroList());
+* expect(doc.isContainerExists("cid:root-map:Map")).toBe(true);
+* expect(doc.isContainerExists("cid:0@1:Text")).toBe(true);
+* expect(doc.isContainerExists("cid:1@1:List")).toBe(true);
+*
+* const doc2 = new LoroDoc();
+* // Containers exist, as long as the history or the doc state include it
+* doc.detach();
+* doc2.import(doc.export({ mode: "update" }));
+* expect(doc2.isContainerExists("cid:root-map:Map")).toBe(true);
+* expect(doc2.isContainerExists("cid:0@1:Text")).toBe(true);
+* expect(doc2.isContainerExists("cid:1@1:List")).toBe(true);
+* ```
+* @param {ContainerID} container_id
+* @returns {boolean}
+*/
+  hasContainer(container_id: ContainerID): boolean;
+/**
 * Set the commit message of the next commit
 * @param {string} msg
 */

package/nodejs/loro_wasm.js

@@ -1455,6 +1455,8 @@ class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1487,6 +1489,8 @@ class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1519,6 +1523,8 @@ class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1551,6 +1557,8 @@ class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1579,6 +1587,8 @@ class LoroDoc {
     }
     /**
     * Get a LoroCounter by container id
+    *
+    * If the container does not exist, an error will be thrown.
     * @param {ContainerID | string} cid
     * @returns {LoroCounter}
     */
@@ -1604,6 +1614,8 @@ class LoroDoc {
     * The object returned is a new js object each time because it need to cross
     * the WASM boundary.
     *
+    * If the container does not exist, an error will be thrown.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -1631,8 +1643,42 @@ class LoroDoc {
         }
     }
     /**
-    * Get the container corresponding to the container id
+    * Check if the doc contains the target container.
     *
+    * A root container always exists, while a normal container exists
+    * if it has ever been created on the doc.
+    *
+    * @example
+    * ```ts
+    * import { LoroDoc, LoroMap, LoroText, LoroList } from "loro-crdt";
+    *
+    * const doc = new LoroDoc();
+    * doc.setPeerId("1");
+    * const text = doc.getMap("map").setContainer("text", new LoroText());
+    * const list = doc.getMap("map").setContainer("list", new LoroList());
+    * expect(doc.isContainerExists("cid:root-map:Map")).toBe(true);
+    * expect(doc.isContainerExists("cid:0@1:Text")).toBe(true);
+    * expect(doc.isContainerExists("cid:1@1:List")).toBe(true);
+    *
+    * const doc2 = new LoroDoc();
+    * // Containers exist, as long as the history or the doc state include it
+    * doc.detach();
+    * doc2.import(doc.export({ mode: "update" }));
+    * expect(doc2.isContainerExists("cid:root-map:Map")).toBe(true);
+    * expect(doc2.isContainerExists("cid:0@1:Text")).toBe(true);
+    * expect(doc2.isContainerExists("cid:1@1:List")).toBe(true);
+    * ```
+    * @param {ContainerID} container_id
+    * @returns {boolean}
+    */
+    hasContainer(container_id) {
+        const ret = wasm.lorodoc_hasContainer(this.__wbg_ptr, addHeapObject(container_id));
+        return ret !== 0;
+    }
+    /**
+    * Get the container corresponding to the container id.
+    *
+    * If the container does not exist, it returns `undefined`.
     *
     * @example
     * ```ts
@@ -6020,28 +6066,33 @@ module.exports.__wbindgen_object_drop_ref = function(arg0) {
     takeObject(arg0);
 };
 
+module.exports.__wbg_lorocounter_new = function(arg0) {
+    const ret = LoroCounter.__wrap(arg0);
+    return addHeapObject(ret);
+};
+
 module.exports.__wbg_lorotreenode_new = function(arg0) {
     const ret = LoroTreeNode.__wrap(arg0);
     return addHeapObject(ret);
 };
 
-module.exports.__wbg_lorotree_new = function(arg0) {
-    const ret = LoroTree.__wrap(arg0);
+module.exports.__wbg_cursor_new = function(arg0) {
+    const ret = Cursor.__wrap(arg0);
     return addHeapObject(ret);
 };
 
-module.exports.__wbg_lorolist_new = function(arg0) {
-    const ret = LoroList.__wrap(arg0);
+module.exports.__wbg_loromap_new = function(arg0) {
+    const ret = LoroMap.__wrap(arg0);
     return addHeapObject(ret);
 };
 
-module.exports.__wbg_lorocounter_new = function(arg0) {
-    const ret = LoroCounter.__wrap(arg0);
+module.exports.__wbg_lorotext_new = function(arg0) {
+    const ret = LoroText.__wrap(arg0);
     return addHeapObject(ret);
 };
 
-module.exports.__wbg_loromap_new = function(arg0) {
-    const ret = LoroMap.__wrap(arg0);
+module.exports.__wbg_lorotree_new = function(arg0) {
+    const ret = LoroTree.__wrap(arg0);
     return addHeapObject(ret);
 };
 
@@ -6050,13 +6101,8 @@ module.exports.__wbg_loromovablelist_new = function(arg0) {
     return addHeapObject(ret);
 };
 
-module.exports.__wbg_lorotext_new = function(arg0) {
-    const ret = LoroText.__wrap(arg0);
-    return addHeapObject(ret);
-};
-
-module.exports.__wbg_cursor_new = function(arg0) {
-    const ret = Cursor.__wrap(arg0);
+module.exports.__wbg_lorolist_new = function(arg0) {
+    const ret = LoroList.__wrap(arg0);
     return addHeapObject(ret);
 };
 
@@ -6288,7 +6334,7 @@ module.exports.__wbg_error_f851667af71bcfc6 = function(arg0, arg1) {
     }
 };
 
-module.exports.__wbg_now_bc6f749123583eb9 = typeof Date.now == 'function' ? Date.now : notDefined('Date.now');
+module.exports.__wbg_now_cd30a09c9b727b65 = typeof Date.now == 'function' ? Date.now : notDefined('Date.now');
 
 module.exports.__wbg_crypto_1d1f22824a6a080c = function(arg0) {
     const ret = getObject(arg0).crypto;
@@ -6613,12 +6659,12 @@ module.exports.__wbindgen_memory = function() {
 };
 
 module.exports.__wbindgen_closure_wrapper482 = function(arg0, arg1, arg2) {
-    const ret = makeMutClosure(arg0, arg1, 10, __wbg_adapter_60);
+    const ret = makeMutClosure(arg0, arg1, 8, __wbg_adapter_60);
     return addHeapObject(ret);
 };
 
 module.exports.__wbindgen_closure_wrapper485 = function(arg0, arg1, arg2) {
-    const ret = makeMutClosure(arg0, arg1, 8, __wbg_adapter_63);
+    const ret = makeMutClosure(arg0, arg1, 10, __wbg_adapter_63);
     return addHeapObject(ret);
 };
 

package/nodejs/loro_wasm_bg.wasm.d.ts

@@ -59,6 +59,7 @@ export function lorodoc_getList(a: number, b: number, c: number): void;
 export function lorodoc_getMovableList(a: number, b: number, c: number): void;
 export function lorodoc_getCounter(a: number, b: number, c: number): void;
 export function lorodoc_getTree(a: number, b: number, c: number): void;
+export function lorodoc_hasContainer(a: number, b: number): number;
 export function lorodoc_getContainerById(a: number, b: number, c: number): void;
 export function lorodoc_setNextCommitMessage(a: number, b: number, c: number): void;
 export function lorodoc_getDeepValueWithID(a: number): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loro-crdt",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Loro CRDTs is a high-performance CRDT framework that makes your app state synchronized, collaborative and maintainable effortlessly.",
   "keywords": [
     "crdt",

package/web/loro_wasm.d.ts

@@ -109,7 +109,7 @@ interface LoroDoc {
      *  text = doc.getContainerById(textId);
      *  ```
      */
-    getContainerById(id: ContainerID): Container;
+    getContainerById(id: ContainerID): Container | undefined;
 
     /**
      * Subscribe to updates from local edits.
@@ -1859,6 +1859,8 @@ export class LoroDoc {
 * The object returned is a new js object each time because it need to cross
 * the WASM boundary.
 *
+* If the container does not exist, an error will be thrown.
+*
 * @example
 * ```ts
 * import { LoroDoc } from "loro-crdt";
@@ -1872,11 +1874,43 @@ export class LoroDoc {
   getText(cid: ContainerID | string): LoroText;
 /**
 * Get a LoroCounter by container id
+*
+* If the container does not exist, an error will be thrown.
 * @param {ContainerID | string} cid
 * @returns {LoroCounter}
 */
   getCounter(cid: ContainerID | string): LoroCounter;
 /**
+* Check if the doc contains the target container.
+*
+* A root container always exists, while a normal container exists
+* if it has ever been created on the doc.
+*
+* @example
+* ```ts
+* import { LoroDoc, LoroMap, LoroText, LoroList } from "loro-crdt";
+*
+* const doc = new LoroDoc();
+* doc.setPeerId("1");
+* const text = doc.getMap("map").setContainer("text", new LoroText());
+* const list = doc.getMap("map").setContainer("list", new LoroList());
+* expect(doc.isContainerExists("cid:root-map:Map")).toBe(true);
+* expect(doc.isContainerExists("cid:0@1:Text")).toBe(true);
+* expect(doc.isContainerExists("cid:1@1:List")).toBe(true);
+*
+* const doc2 = new LoroDoc();
+* // Containers exist, as long as the history or the doc state include it
+* doc.detach();
+* doc2.import(doc.export({ mode: "update" }));
+* expect(doc2.isContainerExists("cid:root-map:Map")).toBe(true);
+* expect(doc2.isContainerExists("cid:0@1:Text")).toBe(true);
+* expect(doc2.isContainerExists("cid:1@1:List")).toBe(true);
+* ```
+* @param {ContainerID} container_id
+* @returns {boolean}
+*/
+  hasContainer(container_id: ContainerID): boolean;
+/**
 * Set the commit message of the next commit
 * @param {string} msg
 */
@@ -3695,6 +3729,7 @@ export interface InitOutput {
   readonly lorodoc_getMovableList: (a: number, b: number, c: number) => void;
   readonly lorodoc_getCounter: (a: number, b: number, c: number) => void;
   readonly lorodoc_getTree: (a: number, b: number, c: number) => void;
+  readonly lorodoc_hasContainer: (a: number, b: number) => number;
   readonly lorodoc_getContainerById: (a: number, b: number, c: number) => void;
   readonly lorodoc_setNextCommitMessage: (a: number, b: number, c: number) => void;
   readonly lorodoc_getDeepValueWithID: (a: number) => number;