@dime-technology/dime-js-sdk 1.2.0 → 1.3.0

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/config.ts
 var DEFAULT_BASE_URL = "https://app.dimepayments.com";
-var VERSION = "1.2.0";
+var VERSION = "1.3.0";
 var Config = class {
   token;
   baseUrl;
@@ -777,6 +777,36 @@ var Deposits = class extends AbstractResource {
   }
 };
 
+// src/data-objects/cover-fee-quote.ts
+var CoverFeeQuote = class _CoverFeeQuote {
+  constructor(basis, base, ccFee, ccTotal, achFee, achTotal) {
+    this.basis = basis;
+    this.base = base;
+    this.ccFee = ccFee;
+    this.ccTotal = ccTotal;
+    this.achFee = achFee;
+    this.achTotal = achTotal;
+  }
+  basis;
+  base;
+  ccFee;
+  ccTotal;
+  achFee;
+  achTotal;
+  static fromRaw(data) {
+    const cc = arrObjectFrom(data, ["cc"]);
+    const ach = arrObjectFrom(data, ["ach"]);
+    return new _CoverFeeQuote(
+      arrString(data, "basis"),
+      arrString(data, "base"),
+      arrString(cc, "fee"),
+      arrString(cc, "total"),
+      arrString(ach, "fee"),
+      arrString(ach, "total")
+    );
+  }
+};
+
 // src/data-objects/invoice-customer.ts
 var InvoiceCustomer = class _InvoiceCustomer {
   constructor(id, name, email) {
@@ -851,29 +881,32 @@ var InvoiceLineItem = class _InvoiceLineItem {
 
 // src/data-objects/invoice-payment.ts
 var InvoicePayment = class _InvoicePayment {
-  constructor(amount, paidAt, method, transactionId) {
+  constructor(amount, paidAt, method, transactionId, coverFee) {
     this.amount = amount;
     this.paidAt = paidAt;
     this.method = method;
     this.transactionId = transactionId;
+    this.coverFee = coverFee;
   }
   amount;
   paidAt;
   method;
   transactionId;
+  coverFee;
   static fromRaw(data) {
     return new _InvoicePayment(
       arrString(data, "amount"),
       arrString(data, "paid_at"),
       arrString(data, "method"),
-      arrString(data, "transaction_id")
+      arrString(data, "transaction_id"),
+      arrString(data, "cover_fee")
     );
   }
 };
 
 // src/data-objects/invoice.ts
 var Invoice = class _Invoice {
-  constructor(id, invoiceNumber, status, token, paymentTerms, issueDate, dueDate, isOverdue = false, subtotal, total, amountPaid, balance, allowPartialPayment = false, thankYouNote, customerName, customerEmail, publicUrl, customer = new InvoiceCustomer(), items = [], payments = [], events = []) {
+  constructor(id, invoiceNumber, status, token, paymentTerms, issueDate, dueDate, isOverdue = false, subtotal, total, amountPaid, balance, allowPartialPayment = false, thankYouNote, customerName, customerEmail, publicUrl, customer = new InvoiceCustomer(), items = [], payments = [], events = [], coverFeeRequired = false, coverFeeQuote) {
     this.id = id;
     this.invoiceNumber = invoiceNumber;
     this.status = status;
@@ -895,6 +928,8 @@ var Invoice = class _Invoice {
     this.items = items;
     this.payments = payments;
     this.events = events;
+    this.coverFeeRequired = coverFeeRequired;
+    this.coverFeeQuote = coverFeeQuote;
   }
   id;
   invoiceNumber;
@@ -917,6 +952,8 @@ var Invoice = class _Invoice {
   items;
   payments;
   events;
+  coverFeeRequired;
+  coverFeeQuote;
   static fromRaw(data) {
     return new _Invoice(
       arrInt(data, "id"),
@@ -939,7 +976,9 @@ var Invoice = class _Invoice {
       InvoiceCustomer.fromRaw(arrObjectFrom(data, ["customer"])),
       arrArrayFrom(data, "items").map(InvoiceLineItem.fromRaw),
       arrArrayFrom(data, "payments").map(InvoicePayment.fromRaw),
-      arrArrayFrom(data, "events").map(InvoiceEvent.fromRaw)
+      arrArrayFrom(data, "events").map(InvoiceEvent.fromRaw),
+      arrBool(data, "cover_fee_required"),
+      data["cover_fee_quote"] && typeof data["cover_fee_quote"] === "object" ? CoverFeeQuote.fromRaw(data["cover_fee_quote"]) : void 0
     );
   }
 };
@@ -1011,7 +1050,13 @@ var Invoices = class extends AbstractResource {
    *   `unit_price` and optional `description`. Optional: `invoice_number`,
    *   `issue_date` (Y-m-d, defaults to today — `due_date` is derived from
    *   `payment_terms`), `thank_you_note`, `allow_partial_payment`,
-   *   `reminder_settings`.
+   *   `cover_fee_required`, `reminder_settings`.
+   *
+   *   Set `cover_fee_required` to make the customer pay the processing fee. The
+   *   fee is added on top of the invoice at payment time rather than becoming a
+   *   line item, so `total` stays the amount owed to the merchant — read
+   *   `invoice.coverFeeQuote` for what the customer will actually be charged.
+   *   Omitting the field inherits the merchant's invoice setting.
    */
   async create(sid, attributes) {
     const raw = await this.transport.request(
@@ -1089,6 +1134,12 @@ var Invoices = class extends AbstractResource {
    *   `account_type` (Checking | Savings) / `account_name`. Omit `amount` to pay
    *   the full balance — partial amounts require the invoice to allow them.
    *   Optional: `memo`, `billing_address`.
+   *
+   *   On a cover-fee invoice the processing fee for `payment_type` is charged on
+   *   top of `amount`, so the card or bank account is debited more than the
+   *   invoice is credited. The fee lands as `coverFee` on the matching entry in
+   *   `invoice.payments`. Card and ACH rates differ, so the same `amount` settles
+   *   differently per `payment_type`.
    */
   async pay(sid, invoiceId, attributes) {
     const raw = await this.transport.request(
@@ -1414,7 +1465,7 @@ var PaymentMethods = class extends AbstractResource {
 
 // src/data-objects/recurring-invoice.ts
 var RecurringInvoice = class _RecurringInvoice {
-  constructor(id, status, recurrenceSchedule, paymentTerms, startDate, endDate, nextRunDate, lastRunDate, customerName, thankYouNote, customer = new InvoiceCustomer(), items = [], upcomingRunDates = [], invoices = []) {
+  constructor(id, status, recurrenceSchedule, paymentTerms, startDate, endDate, nextRunDate, lastRunDate, customerName, thankYouNote, customer = new InvoiceCustomer(), items = [], upcomingRunDates = [], invoices = [], coverFeeRequired = false) {
     this.id = id;
     this.status = status;
     this.recurrenceSchedule = recurrenceSchedule;
@@ -1429,6 +1480,7 @@ var RecurringInvoice = class _RecurringInvoice {
     this.items = items;
     this.upcomingRunDates = upcomingRunDates;
     this.invoices = invoices;
+    this.coverFeeRequired = coverFeeRequired;
   }
   id;
   status;
@@ -1444,6 +1496,7 @@ var RecurringInvoice = class _RecurringInvoice {
   items;
   upcomingRunDates;
   invoices;
+  coverFeeRequired;
   static fromRaw(data) {
     const runDates = data["upcoming_run_dates"];
     return new _RecurringInvoice(
@@ -1460,7 +1513,8 @@ var RecurringInvoice = class _RecurringInvoice {
       InvoiceCustomer.fromRaw(arrObjectFrom(data, ["customer"])),
       arrArrayFrom(data, "items").map(InvoiceLineItem.fromRaw),
       Array.isArray(runDates) ? runDates.map((d) => String(d)) : [],
-      arrArrayFrom(data, "invoices").map(Invoice.fromRaw)
+      arrArrayFrom(data, "invoices").map(Invoice.fromRaw),
+      arrBool(data, "cover_fee_required")
     );
   }
 };
@@ -1499,6 +1553,9 @@ var RecurringInvoices = class extends AbstractResource {
    *   `recurring_start_date` (Y-m-d) and `lines` are required. Optional:
    *   `recurring_end_date` (Y-m-d, on or after the start date),
    *   `thank_you_note`.
+   *
+   *   `cover_fee_required` makes the customer cover the processing fee on every
+   *   invoice this template generates.
    */
   async create(sid, attributes) {
     const raw = await this.transport.request(
@@ -1813,6 +1870,7 @@ export {
   Client,
   Config,
   ConnectionException,
+  CoverFeeQuote,
   CursorPage,
   Customer,
   DEFAULT_BASE_URL,