loro-crdt 1.4.1 → 1.4.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.4.2
+
+### Patch Changes
+
+- e0948d8: feat: add container existence check methods & avoid panic in wasm/js #651
+- 9955500: fix: an internal iter_change err that may cause fork_at panic #649
+
 ## 1.4.1
 
 ### Patch Changes

package/base64/index.js

@@ -1457,6 +1457,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";
@@ -1489,6 +1491,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";
@@ -1521,6 +1525,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";
@@ -1553,6 +1559,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";
@@ -1581,6 +1589,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}
     */
@@ -1606,6 +1616,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";
@@ -1633,8 +1645,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
@@ -6012,36 +6058,36 @@ class VersionVector {
 function __wbindgen_object_drop_ref(arg0) {
     takeObject(arg0);
 }
+function __wbg_lorocounter_new(arg0) {
+    const ret = LoroCounter.__wrap(arg0);
+    return addHeapObject(ret);
+}
 function __wbg_lorotreenode_new(arg0) {
     const ret = LoroTreeNode.__wrap(arg0);
     return addHeapObject(ret);
 }
-function __wbg_lorotree_new(arg0) {
-    const ret = LoroTree.__wrap(arg0);
+function __wbg_cursor_new(arg0) {
+    const ret = Cursor.__wrap(arg0);
     return addHeapObject(ret);
 }
-function __wbg_lorolist_new(arg0) {
-    const ret = LoroList.__wrap(arg0);
+function __wbg_loromap_new(arg0) {
+    const ret = LoroMap.__wrap(arg0);
     return addHeapObject(ret);
 }
-function __wbg_lorocounter_new(arg0) {
-    const ret = LoroCounter.__wrap(arg0);
+function __wbg_lorotext_new(arg0) {
+    const ret = LoroText.__wrap(arg0);
     return addHeapObject(ret);
 }
-function __wbg_loromap_new(arg0) {
-    const ret = LoroMap.__wrap(arg0);
+function __wbg_lorotree_new(arg0) {
+    const ret = LoroTree.__wrap(arg0);
     return addHeapObject(ret);
 }
 function __wbg_loromovablelist_new(arg0) {
     const ret = LoroMovableList.__wrap(arg0);
     return addHeapObject(ret);
 }
-function __wbg_lorotext_new(arg0) {
-    const ret = LoroText.__wrap(arg0);
-    return addHeapObject(ret);
-}
-function __wbg_cursor_new(arg0) {
-    const ret = Cursor.__wrap(arg0);
+function __wbg_lorolist_new(arg0) {
+    const ret = LoroList.__wrap(arg0);
     return addHeapObject(ret);
 }
 function __wbg_versionvector_new(arg0) {
@@ -6236,7 +6282,7 @@ function __wbg_error_f851667af71bcfc6(arg0, arg1) {
         wasm.__wbindgen_export_5(deferred0_0, deferred0_1, 1);
     }
 }
-const __wbg_now_bc6f749123583eb9 = typeof Date.now == 'function' ? Date.now : notDefined('Date.now');
+const __wbg_now_cd30a09c9b727b65 = typeof Date.now == 'function' ? Date.now : notDefined('Date.now');
 
 function __wbg_crypto_1d1f22824a6a080c(arg0) {
     const ret = getObject(arg0).crypto;
@@ -6501,11 +6547,11 @@ function __wbindgen_memory() {
     return addHeapObject(ret);
 }
 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);
 }
 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);
 }
 
@@ -6579,7 +6625,7 @@ var imports = /*#__PURE__*/Object.freeze({
     __wbg_next_196c84450b364254: __wbg_next_196c84450b364254,
     __wbg_next_40fc327bfc8770e6: __wbg_next_40fc327bfc8770e6,
     __wbg_node_104a2ff8d6ea03a2: __wbg_node_104a2ff8d6ea03a2,
-    __wbg_now_bc6f749123583eb9: __wbg_now_bc6f749123583eb9,
+    __wbg_now_cd30a09c9b727b65: __wbg_now_cd30a09c9b727b65,
     __wbg_ownKeys_658942b7f28d1fe9: __wbg_ownKeys_658942b7f28d1fe9,
     __wbg_process_4a72847cc503995b: __wbg_process_4a72847cc503995b,
     __wbg_push_a5b05aedc7234f9f: __wbg_push_a5b05aedc7234f9f,
@@ -6643,7 +6689,7 @@ var imports = /*#__PURE__*/Object.freeze({
 // Without this patch, Cloudflare Worker would raise issue like: "Uncaught TypeError: wasm2.__wbindgen_start is not a function"
 
 
-import loro_wasm_bg_js from './loro_wasm_bg-4116d6d8.js';
+import loro_wasm_bg_js from './loro_wasm_bg-b04f3476.js';
 const instance = new WebAssembly.Instance(loro_wasm_bg_js(), {
     "./loro_wasm_bg.js": imports,
 });
@@ -6848,4 +6894,4 @@ LoroDoc.prototype.toJsonWithReplacer = function (replacer) {
     return run(layer);
 };
 
-export { Awareness, AwarenessWasm, Cursor, Loro, LoroCounter, LoroDoc, LoroList, LoroMap, LoroMovableList, LoroText, LoroTree, LoroTreeNode, UndoManager, VersionVector, __wbg_String_b9412f8799faab3e, __wbg_apply_0a5aa603881e6d79, __wbg_buffer_12d079cc21e14bdb, __wbg_call_27c0f87801dedf93, __wbg_call_8e7cb608789c2528, __wbg_call_938992c832f74314, __wbg_call_b3ca7c6051f9bec1, __wbg_crypto_1d1f22824a6a080c, __wbg_cursor_new, __wbg_done_298b57d23c0fc80c, __wbg_entries_95cc2c823b285a09, __wbg_entries_ce844941d0c51880, __wbg_error_9384d761bf46409d, __wbg_error_f851667af71bcfc6, __wbg_from_89e3fc3ba5e6fb48, __wbg_getRandomValues_3aa56aa6edec874c, __wbg_get_bd8e338fbd5f5cc8, __wbg_get_e3c254076557e348, __wbg_getindex_03d06b4e7ea3475e, __wbg_getwithrefkey_edc2c8960f0f1191, __wbg_globalThis_d1e6af4856ba331b, __wbg_global_207b558942527489, __wbg_instanceof_ArrayBuffer_836825be07d4c9d2, __wbg_instanceof_Map_87917e0a7aaf4012, __wbg_instanceof_Object_71ca3c0a59266746, __wbg_instanceof_Uint8Array_2b3bbecd033d19f6, __wbg_isArray_2ab64d95e09ea0ae, __wbg_isSafeInteger_f7b04ef02296c4d2, __wbg_iterator_2cee6dadfd956dfa, __wbg_length_c20a40f15020d68a, __wbg_length_cd7af8117672b8b8, __wbg_log_aba5996d9bde071f, __wbg_log_c86c3e1bf097ba35, __wbg_log_c9486ca5d8e2cbe8, __wbg_lorocounter_new, __wbg_lorolist_new, __wbg_loromap_new, __wbg_loromovablelist_new, __wbg_lorotext_new, __wbg_lorotree_new, __wbg_lorotreenode_new, __wbg_mark_40e050a77cc39fea, __wbg_measure_aa7a73f17813f708, __wbg_msCrypto_eb05e62b530a1508, __wbg_new_16b304a2cfa7ff4a, __wbg_new_63b92bc8671ed464, __wbg_new_72fb9a18b5ae2624, __wbg_new_abda76e883ba8a5f, __wbg_new_d9bc3a0147634640, __wbg_newnoargs_e258087cd0daa0ea, __wbg_newwithbyteoffsetandlength_aa4a17c33a06e5cb, __wbg_newwithlength_66ae46612e7f0234, __wbg_newwithlength_e9b4878cebadb3d3, __wbg_next_196c84450b364254, __wbg_next_40fc327bfc8770e6, __wbg_node_104a2ff8d6ea03a2, __wbg_now_bc6f749123583eb9, __wbg_ownKeys_658942b7f28d1fe9, __wbg_process_4a72847cc503995b, __wbg_push_a5b05aedc7234f9f, __wbg_randomFillSync_5c9c955aa56b6049, __wbg_require_cca90b1a94a0255b, __wbg_resolve_b0083a7967828ec8, __wbg_self_ce0dbfc45cf2f5be, __wbg_set_1f9b04f170055d33, __wbg_set_8417257aaedc936b, __wbg_set_a47bac70306a19a7, __wbg_set_d4638f722068f043, __wbg_set_f975102236d3c502, __wbg_set_wasm, __wbg_setindex_0b7ede192dc5eca8, __wbg_stack_658279fe44541cf6, __wbg_subarray_a1f73cd4b5b42fe1, __wbg_then_0c86a60e8fcfe9f6, __wbg_value_d93c65011f51a456, __wbg_versions_f686565e586dd935, __wbg_versionvector_new, __wbg_window_c6fb939a7f436783, __wbindgen_as_number, __wbindgen_bigint_from_i64, __wbindgen_bigint_from_u64, __wbindgen_bigint_get_as_i64, __wbindgen_boolean_get, __wbindgen_cb_drop, __wbindgen_closure_wrapper482, __wbindgen_closure_wrapper485, __wbindgen_debug_string, __wbindgen_error_new, __wbindgen_in, __wbindgen_is_array, __wbindgen_is_bigint, __wbindgen_is_falsy, __wbindgen_is_function, __wbindgen_is_null, __wbindgen_is_object, __wbindgen_is_string, __wbindgen_is_undefined, __wbindgen_jsval_eq, __wbindgen_jsval_loose_eq, __wbindgen_memory, __wbindgen_number_get, __wbindgen_number_new, __wbindgen_object_clone_ref, __wbindgen_object_drop_ref, __wbindgen_rethrow, __wbindgen_string_get, __wbindgen_string_new, __wbindgen_throw, __wbindgen_typeof, decodeFrontiers, decodeImportBlobMeta, encodeFrontiers, getType, isContainer, isContainerId, newContainerID, newRootContainerID, run, setDebug };
+export { Awareness, AwarenessWasm, Cursor, Loro, LoroCounter, LoroDoc, LoroList, LoroMap, LoroMovableList, LoroText, LoroTree, LoroTreeNode, UndoManager, VersionVector, __wbg_String_b9412f8799faab3e, __wbg_apply_0a5aa603881e6d79, __wbg_buffer_12d079cc21e14bdb, __wbg_call_27c0f87801dedf93, __wbg_call_8e7cb608789c2528, __wbg_call_938992c832f74314, __wbg_call_b3ca7c6051f9bec1, __wbg_crypto_1d1f22824a6a080c, __wbg_cursor_new, __wbg_done_298b57d23c0fc80c, __wbg_entries_95cc2c823b285a09, __wbg_entries_ce844941d0c51880, __wbg_error_9384d761bf46409d, __wbg_error_f851667af71bcfc6, __wbg_from_89e3fc3ba5e6fb48, __wbg_getRandomValues_3aa56aa6edec874c, __wbg_get_bd8e338fbd5f5cc8, __wbg_get_e3c254076557e348, __wbg_getindex_03d06b4e7ea3475e, __wbg_getwithrefkey_edc2c8960f0f1191, __wbg_globalThis_d1e6af4856ba331b, __wbg_global_207b558942527489, __wbg_instanceof_ArrayBuffer_836825be07d4c9d2, __wbg_instanceof_Map_87917e0a7aaf4012, __wbg_instanceof_Object_71ca3c0a59266746, __wbg_instanceof_Uint8Array_2b3bbecd033d19f6, __wbg_isArray_2ab64d95e09ea0ae, __wbg_isSafeInteger_f7b04ef02296c4d2, __wbg_iterator_2cee6dadfd956dfa, __wbg_length_c20a40f15020d68a, __wbg_length_cd7af8117672b8b8, __wbg_log_aba5996d9bde071f, __wbg_log_c86c3e1bf097ba35, __wbg_log_c9486ca5d8e2cbe8, __wbg_lorocounter_new, __wbg_lorolist_new, __wbg_loromap_new, __wbg_loromovablelist_new, __wbg_lorotext_new, __wbg_lorotree_new, __wbg_lorotreenode_new, __wbg_mark_40e050a77cc39fea, __wbg_measure_aa7a73f17813f708, __wbg_msCrypto_eb05e62b530a1508, __wbg_new_16b304a2cfa7ff4a, __wbg_new_63b92bc8671ed464, __wbg_new_72fb9a18b5ae2624, __wbg_new_abda76e883ba8a5f, __wbg_new_d9bc3a0147634640, __wbg_newnoargs_e258087cd0daa0ea, __wbg_newwithbyteoffsetandlength_aa4a17c33a06e5cb, __wbg_newwithlength_66ae46612e7f0234, __wbg_newwithlength_e9b4878cebadb3d3, __wbg_next_196c84450b364254, __wbg_next_40fc327bfc8770e6, __wbg_node_104a2ff8d6ea03a2, __wbg_now_cd30a09c9b727b65, __wbg_ownKeys_658942b7f28d1fe9, __wbg_process_4a72847cc503995b, __wbg_push_a5b05aedc7234f9f, __wbg_randomFillSync_5c9c955aa56b6049, __wbg_require_cca90b1a94a0255b, __wbg_resolve_b0083a7967828ec8, __wbg_self_ce0dbfc45cf2f5be, __wbg_set_1f9b04f170055d33, __wbg_set_8417257aaedc936b, __wbg_set_a47bac70306a19a7, __wbg_set_d4638f722068f043, __wbg_set_f975102236d3c502, __wbg_set_wasm, __wbg_setindex_0b7ede192dc5eca8, __wbg_stack_658279fe44541cf6, __wbg_subarray_a1f73cd4b5b42fe1, __wbg_then_0c86a60e8fcfe9f6, __wbg_value_d93c65011f51a456, __wbg_versions_f686565e586dd935, __wbg_versionvector_new, __wbg_window_c6fb939a7f436783, __wbindgen_as_number, __wbindgen_bigint_from_i64, __wbindgen_bigint_from_u64, __wbindgen_bigint_get_as_i64, __wbindgen_boolean_get, __wbindgen_cb_drop, __wbindgen_closure_wrapper482, __wbindgen_closure_wrapper485, __wbindgen_debug_string, __wbindgen_error_new, __wbindgen_in, __wbindgen_is_array, __wbindgen_is_bigint, __wbindgen_is_falsy, __wbindgen_is_function, __wbindgen_is_null, __wbindgen_is_object, __wbindgen_is_string, __wbindgen_is_undefined, __wbindgen_jsval_eq, __wbindgen_jsval_loose_eq, __wbindgen_memory, __wbindgen_number_get, __wbindgen_number_new, __wbindgen_object_clone_ref, __wbindgen_object_drop_ref, __wbindgen_rethrow, __wbindgen_string_get, __wbindgen_string_new, __wbindgen_throw, __wbindgen_typeof, decodeFrontiers, decodeImportBlobMeta, encodeFrontiers, getType, isContainer, isContainerId, newContainerID, newRootContainerID, run, setDebug };

package/base64/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
 */