[json-node] Add JsonObject.remove() method

json-node/src/main/java/io/avaje/json/node/JsonObject.java

@@ -159,6 +159,17 @@ public JsonObject add(String key, long value) {
     return add(key, JsonLong.of(value));
   }
 
+  /**
+   * Remove the node for the given key returning the removed value.
+   *
+   * @param key The key to remove.
+   * @return The node that has been removed.
+   */
+  @Nullable
+  public JsonNode remove(String key) {
+    return children.remove(key);
+  }
+
   /**
    * Return the direct element at the given path throwing IllegalArgumentException
    * if it is missing.

json-node/src/test/java/io/avaje/json/node/JsonObjectTest.java

@@ -94,6 +94,20 @@ void add() {
     assertThat(obj.size()).isEqualTo(1);
   }
 
+  @Test
+  void remove() {
+    var obj = JsonObject.create().add("one", 1).add("two", 2).add("three", 3);
+    assertThat(obj.elements().keySet()).containsExactly("one", "two", "three");
+
+    JsonNode two = obj.remove("two");
+    assertThat(two).isNotNull();
+    assertThat(two).isInstanceOf(JsonInteger.class);
+    assertThat(two.text()).isEqualTo("2");
+
+    assertThat(obj.elements().keySet()).containsExactly("one", "three");
+    assertThat(obj.toString()).isEqualTo("{one=1, three=3}");
+  }
+
   @Test
   void get() {
     JsonNode name = basicObject.get("name");