Merge pull request #107 from bobbrodie/SP-794

SP-794 Update examples to use async
bitpay · May 24, 2024 · c8241d8 · c8241d8
2 parents f7382aa + aabba7d
commit c8241d8
Show file tree

Hide file tree

Showing 14 changed files with 106 additions and 81 deletions.
diff --git a/.husky/pre-commit b/.husky/pre-commit
diff --git a/examples/Merchant/BillRequests.ts b/examples/Merchant/BillRequests.ts
@@ -3,22 +3,24 @@ import {Bill} from "../../src/Model";
 import {Item} from "../../src/Model/Bill/Item";
 
 class BillRequests {
-  public createBill(): void {
+  public async createBill(): Promise<void> {
     const client = ClientProvider.create();
 
     const bill = new Bill('someNumber', "USD", "[email protected]", [])
-    client.createBill(bill);
+    await client.createBill(bill);
   }
 
-  public getBill(): void {
+  public async getBill(): Promise<void> {
     const client = ClientProvider.create();
 
-    const bill = client.getBill('someBillId');
+    // Get one bill
+    const bill = await client.getBill('someBillId');
 
-    const bills = client.getBills('draft');
+    // Get bills by status
+    const bills = await client.getBills('draft');
   }
 
-  public updateBill(): void {
+  public async updateBill(): Promise<void> {
     const client = ClientProvider.create();
 
     const item = new Item()
@@ -28,12 +30,14 @@ class BillRequests {
 
     const bill = new Bill('someNumber', "USD", "[email protected]", []);
 
-    client.updateBill(bill, bill.id)
+    if (bill.id) {
+      await client.updateBill(bill, bill.id)
+    }
   }
 
-  public deliverBillViaEmail(): void {
+  public async deliverBillViaEmail(): Promise<void> {
     const client = ClientProvider.create();
 
-    client.deliverBill('someBillId', 'myBillToken');
+    await client.deliverBill('someBillId', 'myBillToken');
   }
 }
diff --git a/examples/Merchant/InvoiceRequests.ts b/examples/Merchant/InvoiceRequests.ts
@@ -3,7 +3,7 @@ import {Buyer} from "../../src/Model/Invoice/Buyer";
 import {ClientProvider} from "../ClientProvider";
 
 class InvoiceRequests {
-  public createInvoice(): void {
+  public async createInvoice(): Promise<void> {
     const invoice = new Invoice(10.0, 'USD');
     invoice.notificationEmail = '[email protected]';
     invoice.notificationURL = 'https://some-url.com';
@@ -23,10 +23,10 @@ class InvoiceRequests {
 
     const client = ClientProvider.create();
 
-    const createdInvoice = client.createInvoice(invoice);
+    const createdInvoice = await client.createInvoice(invoice);
   }
 
-  public getInvoice(): void {
+  public async getInvoice(): Promise<void> {
     const client = ClientProvider.create();
 
     const invoice = client.getInvoice('myInvoiceId');
@@ -40,28 +40,29 @@ class InvoiceRequests {
       limit: null,
       offset: null
     };
-    const invoices = client.getInvoices(params)
+    const invoices = await client.getInvoices(params)
   }
 
-  public updateInvoice(): void {
+  public async updateInvoice(): Promise<void> {
     const client = ClientProvider.create();
-    const params = [];
-    params['buyerSms'] = '123321312';
+    const params = {
+      buyerSms: '123321312'
+    };
 
-    const updatedInvoice = client.updateInvoice('someId', params)
+    const updatedInvoice = await client.updateInvoice('someId', params)
   }
 
-  public cancelInvoice(): void {
+  public async cancelInvoice(): Promise<void> {
     const client = ClientProvider.create();
 
-    client.cancelInvoice('someInvoiceId');
+    await client.cancelInvoice('someInvoiceId');
 
-    client.cancelInvoiceByGuid('someGuid');
+    await client.cancelInvoiceByGuid('someGuid');
   }
 
-  public requestInvoiceWebhookToBeResent(): void {
+  public async requestInvoiceWebhookToBeResent(): Promise<void> {
     const client = ClientProvider.create();
 
-    client.deliverBill('someBillId', 'myBillToken');
+    await client.deliverBill('someBillId', 'myBillToken');
   }
 }
diff --git a/examples/Merchant/LedgerRequests.ts b/examples/Merchant/LedgerRequests.ts
@@ -1,13 +1,13 @@
 import {ClientProvider} from "../ClientProvider";
 
 class LedgerRequests {
-  public getLedgers(): void {
+  public async getLedgers(): Promise<void> {
     const client = ClientProvider.create();
 
-    const ledgers = client.getLedgers()
+    const ledgers = await client.getLedgers()
   }
 
-  public getLedgerEntries(): void {
+  public async getLedgerEntries(): Promise<void> {
     const client = ClientProvider.create();
 
     const oneMonthAgo = new Date();
@@ -16,6 +16,6 @@ class LedgerRequests {
     const tomorrow = new Date();
     tomorrow.setDate(tomorrow.getDate() + 1);
 
-    const ledgerEntries = client.getLedgerEntries('USD', oneMonthAgo, tomorrow)
+    const ledgerEntries = await client.getLedgerEntries('USD', oneMonthAgo, tomorrow)
   }
 }
diff --git a/examples/Merchant/RefundRequests.ts b/examples/Merchant/RefundRequests.ts
@@ -2,38 +2,47 @@ import {ClientProvider} from "../ClientProvider";
 import {Refund} from "../../src/Model/Invoice/Refund";
 
 class RefundRequests {
-  public createRefund(): void {
+  public async createRefund(): Promise<void> {
     const client = ClientProvider.create();
 
     const refund = new Refund(12, "someInvoiceId", "someToken");
 
-    const result = client.createRefund(refund);
+    const result = await client.createRefund(refund);
   }
 
-  public updateRefund(): void {
+  public async updateRefund(): Promise<void> {
     const client = ClientProvider.create();
 
-    const updateRefund = client.updateRefund('myRefundId','created');
-    const updatedRefundByGuid = client.updateRefundByGuid('myRefundId','created');
+    // Update a refund by ID
+    const updateRefund = await client.updateRefund('myRefundId','created');
+
+    // Update a refund by GUID
+    const updatedRefundByGuid = await client.updateRefundByGuid('myRefundId','created');
   }
 
-  public getRefund(): void {
+  public async getRefund(): Promise<void> {
     const client = ClientProvider.create();
 
-    const refund = client.getRefund('someRefundId');
-    const refundByGuid = client.getRefundByGuid('someGuid');
+    // Get a refund by ID
+    const refund = await client.getRefund('someRefundId');
+
+    // Get a refund by GUID
+    const refundByGuid = await client.getRefundByGuid('someGuid');
   }
 
-  public cancelRefund(): void {
+  public async cancelRefund(): Promise<void> {
     const client = ClientProvider.create();
 
-    const cancelRefund = client.cancelRefund('myRefundId');
-    const cancelRefundByGuid = client.cancelRefundByGuid('someGuid');
+    // Cancel a refund by ID
+    const cancelRefund = await client.cancelRefund('myRefundId');
+
+    // Cancel a refund by GUID
+    const cancelRefundByGuid = await client.cancelRefundByGuid('someGuid');
   }
 
-  public requestRefundNotificationToBeResent(): void {
+  public async requestRefundNotificationToBeResent(): Promise<void> {
     const client = ClientProvider.create();
 
-    const result = client.sendRefundNotification('someRefundId');
+    const result = await client.sendRefundNotification('someRefundId');
   }
 }
diff --git a/examples/Merchant/SettlementRequests.ts b/examples/Merchant/SettlementRequests.ts
@@ -2,26 +2,28 @@ import {ClientProvider} from "../ClientProvider";
 import {Settlement} from "../../src/Model/Settlement/Settlement";
 
 class SettlementRequests {
-  public getSettlement(): void {
+  public async getSettlement(): Promise<void> {
     const client = ClientProvider.create();
 
-    const settlement = client.getSettlement('someSettlementId');
+    // Get one settlement
+    const settlement = await client.getSettlement('someSettlementId');
 
+    // Get settlements by filter
     const params = {
       startDate: '2021-05-10',
       endDate: '2021-05-12',
       status: 'processing',
       limit: 100,
       offset: 0
     };
-    const settlements = client.getSettlements(params)
+    const settlements = await client.getSettlements(params)
   }
 
-  public fetchReconciliationReport(): void {
+  public async fetchReconciliationReport(): Promise<void> {
     const client = ClientProvider.create();
 
     const settlement = new Settlement();
 
-    const result = client.getSettlementReconciliationReport('settlementId', 'settlementToken');
+    const result = await client.getSettlementReconciliationReport('settlementId', 'settlementToken');
   }
 }
diff --git a/examples/Payout/PayoutRequests.ts b/examples/Payout/PayoutRequests.ts
@@ -3,41 +3,46 @@ import {Payout} from "../../src/Model";
 import {PayoutStatus} from "../../src";
 
 class PayoutRequests {
-  public createPayout(): void {
+  public async createPayout(): Promise<void> {
     const client = ClientProvider.create();
 
     const payout = new Payout(12.34, 'USD', 'USD');
     payout.notificationEmail = '[email protected]';
     payout.notificationURL = 'https://my-url.com';
 
-    const createdPayout = client.submitPayout(payout);
+    // Submit one payout
+    const createdPayout = await client.submitPayout(payout);
 
-    const payouts = client.submitPayouts([
+    // Submit multiple payouts
+    const payouts = await client.submitPayouts([
       new Payout(12.34, 'USD', 'USD'),
       new Payout(56.14, 'USD', 'USD'),
     ])
   }
 
-  public getPayouts(): void {
+  public async getPayouts(): Promise<void> {
     const client = ClientProvider.create();
 
-    const payout = client.getPayout('myPayoutId')
+    // Get one payout
+    const payout = await client.getPayout('myPayoutId')
 
-    const payouts = client.getPayouts({ status: PayoutStatus.New });
+    // Get payouts by filter
+    const payouts = await client.getPayouts({ status: PayoutStatus.New });
   }
 
-  public cancelPayout(): void {
+  public async cancelPayout(): Promise<void> {
     const client = ClientProvider.create();
 
-    const result = client.cancelPayout('somePayoutId');
+    // Cancel one payout
+    const result = await client.cancelPayout('somePayoutId');
 
-    // const payoutGroupId = payout.groupId;
+    // Cancel payout group
     const cancelledPayouts = client.cancelPayouts('payoutGroupId');
   }
 
-  public requestPayoutWebhookToBeResent(): void {
+  public async requestPayoutWebhookToBeResent(): Promise<void> {
     const client = ClientProvider.create();
 
-    const result = client.requestPayoutNotification('somePayoutId');
+    const result = await client.requestPayoutNotification('somePayoutId');
   }
 }
diff --git a/examples/Payout/RecipientRequests.ts b/examples/Payout/RecipientRequests.ts
@@ -2,36 +2,38 @@ import {ClientProvider} from "../ClientProvider";
 import {PayoutRecipient, PayoutRecipients} from "../../src/Model";
 
 class RecipientRequests {
-  public inviteRecipients(): void {
+  public async inviteRecipients(): Promise<void> {
     const client = ClientProvider.create();
 
     const payoutRecipient = new PayoutRecipient('[email protected]', 'someLabel', 'https://notification.com');
 
     const payoutRecipients = new PayoutRecipients([payoutRecipient]);
 
-    const recipients = client.submitPayoutRecipients(payoutRecipients);
+    const recipients = await client.submitPayoutRecipients(payoutRecipients);
   }
 
-  public getRecipient(): void {
+  public async getRecipient(): Promise<void> {
     const client = ClientProvider.create();
 
-    const recipient = client.getPayoutRecipient('someRecipientId');
+    // Get one payout recipient
+    const recipient = await client.getPayoutRecipient('someRecipientId');
 
-    const recipients = client.getPayoutRecipients('invited');
+    // Get payout recipients by filter
+    const recipients = await client.getPayoutRecipients('invited');
   }
 
-  public updateRecipient(): void {
+  public async updateRecipient(): Promise<void> {
     const client = ClientProvider.create();
 
     const payoutRecipient = new PayoutRecipient('[email protected]', 'someLabel', 'https://notification.com');
     payoutRecipient.label = 'some label';
 
-    const recipient = client.updatePayoutRecipient(payoutRecipient.id, payoutRecipient);
+    const recipient = await client.updatePayoutRecipient(payoutRecipient.id, payoutRecipient);
   }
 
-  public removeRecipient(): void  {
+  public async removeRecipient(): Promise<void>  {
     const client = ClientProvider.create();
 
-    const result = client.deletePayoutRecipient('somePayoutRecipientId');
+    const result = await client.deletePayoutRecipient('somePayoutRecipientId');
   }
 }
diff --git a/examples/Pos/BillRequests.ts b/examples/Pos/BillRequests.ts
@@ -3,22 +3,22 @@ import {Bill} from "../../src/Model";
 import {Item} from "../../src/Model/Bill/Item";
 
 class BillRequests {
-  public createBill(): void {
+  public async createBill(): Promise<void> {
     const client = ClientProvider.createPos();
 
     const bill = new Bill('someNumber', "USD", "[email protected]", [])
-    client.createBill(bill);
+    await client.createBill(bill);
   }
 
-  public getBill(): void {
+  public async getBill(): Promise<void> {
     const client = ClientProvider.createPos();
 
-    const bill = client.getBill('someBillId');
+    const bill = await client.getBill('someBillId');
   }
 
-  public deliverBillViaEmail(): void {
+  public async deliverBillViaEmail(): Promise<void> {
     const client = ClientProvider.createPos();
 
-    client.deliverBill('someBillId', 'myBillToken');
+    await client.deliverBill('someBillId', 'myBillToken');
   }
 }
diff --git a/examples/Pos/InvoiceRequests.ts b/examples/Pos/InvoiceRequests.ts
@@ -3,7 +3,7 @@ import {Buyer} from "../../src/Model/Invoice/Buyer";
 import {ClientProvider} from "../ClientProvider";
 
 class InvoiceRequests {
-  public createInvoice(): void {
+  public async createInvoice(): Promise<void> {
     const invoice = new Invoice(10.0, 'USD');
     invoice.notificationEmail = '[email protected]';
     invoice.notificationURL = 'https://some-url.com';
@@ -23,12 +23,12 @@ class InvoiceRequests {
 
     const client = ClientProvider.createPos();
 
-    const createdInvoice = client.createInvoice(invoice);
+    const createdInvoice = await client.createInvoice(invoice);
   }
 
-  public getInvoice(): void {
+  public async getInvoice(): Promise<void> {
     const client = ClientProvider.createPos();
 
-    const invoice = client.getInvoice('myInvoiceId');
+    const invoice = await client.getInvoice('myInvoiceId');
   }
 }