feat(json-crdt): 🎸 implement ArrApi.push() method

Author: streamich

src/json-crdt/model/api/__tests__/ArrayApi.spec.ts

@@ -1,4 +1,4 @@
-import {s} from '../../../../json-crdt-patch';
+import {nodes, s} from '../../../../json-crdt-patch';
 import {Model} from '../../Model';
 
 test('can insert a value and delete all previous ones', () => {
@@ -25,6 +25,22 @@ describe('.length()', () => {
   });
 });
 
+describe('.push()', () => {
+  test('can append elements to the end of array', () => {
+    const doc = Model.create(s.arr<nodes.con<number>>([]));
+    const arr = doc.$.$!;
+    expect(arr.view()).toEqual([]);
+    arr.push(1);
+    expect(arr.view()).toEqual([1]);
+    arr.push(2, 3);
+    expect(arr.view()).toEqual([1, 2, 3]);
+    arr.push(4);
+    expect(arr.view()).toEqual([1, 2, 3, 4]);
+    arr.push(5, 6, 7);
+    expect(arr.view()).toEqual([1, 2, 3, 4, 5, 6, 7]);
+  });
+});
+
 describe('.upd()', () => {
   test('can update array element', () => {
     const doc = Model.create([1, 2, 3]);

src/json-crdt/model/api/nodes.ts

@@ -738,8 +738,7 @@ export class ArrApi<N extends ArrNode<any> = ArrNode<any>> extends NodeApi<N> {
    * Inserts elements at a given position.
    *
    * @param index Position at which to insert elements.
-   * @param values JSON/CBOR values or IDs of the values to insert.
-   * @returns Reference to itself.
+   * @param values Values or schema of the elements to insert.
    */
   public ins(index: number, values: Array<JsonNodeView<N>[number]>): void {
     const {api, node} = this;
@@ -752,8 +751,22 @@ export class ArrApi<N extends ArrNode<any> = ArrNode<any>> extends NodeApi<N> {
     api.apply();
   }
 
-  // TODO: Implement `.push()` method.
+  /**
+   * Inserts elements at the end of the array.
+   *
+   * @param values Values or schema of the elements to insert at the end of the array.
+   */
+  public push(...values: JsonNodeView<N>[number][]): void {
+    const length = this.length();
+    this.ins(length, values);
+  }
 
+  /**
+   * Updates (overwrites) an element at a given position.
+   *
+   * @param index Position at which to update the element.
+   * @param value Value or schema of the element to replace with.
+   */
   public upd(index: number, value: JsonNodeView<N>[number]): void {
     const {api, node} = this;
     const ref = node.getId(index);