Add build method in promise api to allow execute promise without return it

packages/near-sdk-js/src/promise.ts

@@ -645,6 +645,15 @@ export class NearPromise {
   onReturn() {
     this.asReturn().constructRecursively();
   }
+
+  /**
+   * Attach the promise to transaction but does not return it. The promise will be executed, but
+   * whether it success or not will not affect the transaction result. If you want the promise fail
+   * also makes the transaction fail, you can simply return the promise from a @call method.
+   */
+  build(): PromiseIndex {
+    return this.constructRecursively();
+  }
 }
 
 export type PromiseOrValue<T> = NearPromise | T;

tests/__tests__/test_highlevel_promise.ava.js

@@ -349,3 +349,33 @@ test("highlevel promise and", async (t) => {
     }
   );
 });
+
+test("highlevel promise not build and not return", async (t) => {
+  const { bob, highlevelPromise } = t.context.accounts;
+
+  let r = await bob.callRaw(highlevelPromise, "not_return_not_build", "", {
+    gas: "100 Tgas",
+  });
+
+  try {
+    let balance = await highlevelPromise.getSubAccount("b").balance();
+  } catch (e) {
+    t.is(e.type, "AccountDoesNotExist");
+  }
+});
+
+test("highlevel promise build and not return", async (t) => {
+  const { bob, highlevelPromise } = t.context.accounts;
+
+  let r = await bob.callRaw(highlevelPromise, "build_not_return", "", {
+    gas: "100 Tgas",
+  });
+  t.is(
+    r.result.receipts_outcome[1].outcome.executor_id,
+    highlevelPromise.getSubAccount("b").accountId
+  );
+  t.is(r.result.receipts_outcome[1].outcome.status.SuccessValue, "");
+
+  let balance = await highlevelPromise.getSubAccount("b").balance();
+  t.is(balance.total.toString(), "10000000000000000000000000");
+});

tests/src/highlevel-promise.js

@@ -263,4 +263,21 @@ export class HighlevelPromiseContract {
       );
     return promise;
   }
+
+  @call({})
+  not_return_not_build() {
+    // let promise = NearPromise.new("b.highlevel-promise.test.near")
+    //   .createAccount()
+    //   .transfer(10000000000000000000000000n);
+    // nothing happens
+  }
+
+  @call({})
+  build_not_return() {
+    let promise = NearPromise.new("b.highlevel-promise.test.near")
+      .createAccount()
+      .transfer(10000000000000000000000000n);
+    promise.build();
+    // doesn't return the promise, but promise should be created and executed
+  }
 }