@delopay/sdk 0.143.0 → 0.145.0

package/dist/index.cjs

@@ -76,6 +76,7 @@ __export(index_exports, {
   PANES_MAX: () => PANES_MAX,
   PANE_CATEGORY_KEYS: () => PANE_CATEGORY_KEYS,
   PANE_ICON_KEYS: () => PANE_ICON_KEYS,
+  PaypalDisputes: () => PaypalDisputes,
   RTL_CHECKOUT_LOCALES: () => RTL_CHECKOUT_LOCALES,
   Regions: () => Regions,
   Risk: () => Risk,
@@ -1248,6 +1249,52 @@ var Disputes = class {
   }
 };
 
+// src/resources/paypalDisputes.ts
+var PaypalDisputes = class {
+  constructor(request) {
+    this.request = request;
+  }
+  actions(caseId, offset = 0) {
+    return this.request("GET", `/disputes/paypal/cases/${encodeURIComponent(caseId)}/actions`, {
+      query: { offset }
+    });
+  }
+  download(caseId, documentUrl) {
+    const body = { document_url: documentUrl };
+    return this.request(
+      "POST",
+      `/disputes/paypal/cases/${encodeURIComponent(caseId)}/documents/download`,
+      { body }
+    );
+  }
+  list(params) {
+    return this.request("GET", "/disputes/paypal/cases", {
+      query: params
+    });
+  }
+  retrieve(caseId, forceSync = false) {
+    return this.request("GET", `/disputes/paypal/cases/${encodeURIComponent(caseId)}`, {
+      query: { force_sync: forceSync }
+    });
+  }
+  history(caseId, offset = 0) {
+    return this.request("GET", `/disputes/paypal/cases/${encodeURIComponent(caseId)}/history`, {
+      query: { offset }
+    });
+  }
+  import(params) {
+    return this.request("POST", "/disputes/paypal/import", { body: params });
+  }
+  /** The backend checks current provider permissions and deduplicates request_id.
+   * An unknown result requires reconciliation, not a new request ID.
+   */
+  act(caseId, params) {
+    return this.request("POST", `/disputes/paypal/cases/${encodeURIComponent(caseId)}/actions`, {
+      body: params
+    });
+  }
+};
+
 // src/resources/ephemeralKeys.ts
 var EphemeralKeys = class {
   constructor(request) {
@@ -4577,6 +4624,31 @@ var Settlement = class {
   constructor(request) {
     this.request = request;
   }
+  /**
+   * Read signed refund/dispute processor fees and report availability.
+   * Merchant scope and connector grants apply. Empty movements confirm zero
+   * only when the source is reported and complete.
+   * Supply payment_id without year/month for all history. force_sync reads
+   * provider reports for this page; it requires payment_id and limit <= 20,
+   * and never issues a payment, refund or dispute action.
+   * Omit test_mode for every reporting partition of one payment; period
+   * queries default to live. Each source states its reporting partition.
+   */
+  async listProcessorCostEvents(params, options) {
+    return this.request("GET", "/settlement/processor-cost-events", {
+      query: {
+        profile_id: params.profile_id,
+        payment_id: params.payment_id,
+        year: params.year,
+        month: params.month,
+        test_mode: params.test_mode,
+        limit: params.limit,
+        offset: params.offset,
+        force_sync: params.force_sync
+      },
+      ...options
+    });
+  }
   /**
    * Per-shop settlement rollup for the host merchant: unpaid totals and the
    * running current period, one row per shop.
@@ -4611,7 +4683,9 @@ var Settlement = class {
    * **Host-only.** The response is the host's cost base, which a shop owner
    * must never see, so a profile-scoped caller is refused with a 403 rather
    * than given a redacted shell. Gate the surface on the caller's scope
-   * instead of calling it and handling the failure.
+   * instead of calling it and handling the failure. Connector-restricted
+   * roles cannot read this merchant-wide aggregate; fee-event reads retain
+   * their connector grants.
    *
    * Two things not to flatten when rendering the result:
    * `margin_usd` is absent — not zero — whenever `margin_quality` is
@@ -5053,6 +5127,7 @@ var Delopay = class {
     this.paymentLinks = new PaymentLinks(request);
     this.mandates = new Mandates(request);
     this.disputes = new Disputes(request);
+    this.paypalDisputes = new PaypalDisputes(request);
     this.payouts = new Payouts(request);
     this.ephemeralKeys = new EphemeralKeys(request);
     this.events = new Events(request);
@@ -7687,12 +7762,18 @@ var CheckoutSession = class {
    * order that PayPal's buttons or Card Fields attach the buyer's choice to.
    * The client secret is attached automatically.
    *
-   * For PayPal Card Fields (be#1387) pass `payment_method: 'card'` and the
+   * For PayPal Card Fields pass `payment_method: 'card'` and the
    * `merchant_connector_id` the checkout was rendered with; the order id comes
    * back in `next_action.next_action_data.order_id` and is what the SDK's
    * `createOrder` returns. The confirm that captures it sends the same order
    * and account as `payment_method_data.card_reference`.
    *
+   * Send a distinct `Idempotency-Key` through `options.headers` for each new
+   * card submission; reuse it only to retry that same session request. The
+   * returned order is bound to this attempt and account. Sessions cannot
+   * replace an order while authentication or money processing is unresolved,
+   * or after authorization/capture; stale or foreign references are refused.
+   *
    * `POST /payments/{paymentId}/post-session-tokens` (publishable key)
    */
   async postSessionTokens(params, options) {
@@ -8203,6 +8284,7 @@ var encodeNativePanes = encodePanes;
   PANES_MAX,
   PANE_CATEGORY_KEYS,
   PANE_ICON_KEYS,
+  PaypalDisputes,
   RTL_CHECKOUT_LOCALES,
   Regions,
   Risk,