@delopay/sdk 0.68.0 → 0.70.0

package/dist/index.cjs

@@ -735,10 +735,14 @@ var Disputes = class {
     return this.request("PUT", "/disputes/evidence", { body: params });
   }
   /**
-   * Retrieve previously submitted evidence for a dispute.
+   * Retrieve previously stored evidence for a dispute.
+   *
+   * Returns an ARRAY of file-evidence blocks (this was previously mistyped
+   * as the flat submit-request shape). Only file evidence is reported —
+   * text evidence is not retrievable once submitted.
    *
    * @param disputeId - The dispute ID.
-   * @returns The submitted evidence.
+   * @returns The stored file-evidence blocks.
    */
   async retrieveEvidence(disputeId) {
     return this.request("GET", `/disputes/evidence/${encodeURIComponent(disputeId)}`);
@@ -776,16 +780,22 @@ var Disputes = class {
     return this.request("GET", "/disputes/profile/aggregate", { query: params });
   }
   /**
-   * Fetch the latest dispute state from the connector (gateway).
-   * `GET /disputes/{connectorId}/fetch`
+   * Fetch the latest dispute state from the connector (gateway) and persist it.
+   * `GET /disputes/{disputeId}?force_sync=true`
+   *
+   * The path parameter is the **Delopay dispute id** (`dp_…`). Force-sync asks the
+   * backend to pull the dispute from the connector (supported where the connector
+   * implements the dispute-sync flow, e.g. Stripe) and update the stored record
+   * before returning it.
    *
-   * Note: the path parameter is the **connector dispute id** on the gateway, not the
-   * Delopay dispute id. Method is GET (not POST) and this method signature was
-   * previously wrong — callers depending on the old `POST /disputes/{id}/fetch_from_connector`
-   * path were silently hitting 404s.
+   * Note: this method previously called `GET /disputes/{id}/fetch`, which is a
+   * different backend route — a bulk import keyed by **merchant connector account
+   * id** with a required date range — so every call with a dispute id failed.
    */
-  async fetchFromConnector(connectorId) {
-    return this.request("GET", `/disputes/${encodeURIComponent(connectorId)}/fetch`);
+  async fetchFromConnector(disputeId) {
+    return this.request("GET", `/disputes/${encodeURIComponent(disputeId)}`, {
+      query: { force_sync: "true" }
+    });
   }
 };
 
@@ -1297,6 +1307,30 @@ var Payments = class {
   async listAttempts(paymentId, options) {
     return this.request("GET", `/payments/${encodeURIComponent(paymentId)}/attempts`, options);
   }
+  /**
+   * The status timeline of a payment: every recorded creation / status
+   * transition of the intent and its attempts, refunds and disputes, oldest
+   * first. `complete: false` marks timelines partially reconstructed from
+   * current records (payments created before the status log existed).
+   *
+   * @param paymentId - The payment intent ID.
+   * @returns The ordered status-history events.
+   *
+   * @example
+   * ```typescript
+   * const { events, complete } = await delopay.payments.listStatusHistory('pay_abc123');
+   * for (const event of events) {
+   *   console.log(event.timestamp, event.entity_type, event.status);
+   * }
+   * ```
+   */
+  async listStatusHistory(paymentId, options) {
+    return this.request(
+      "GET",
+      `/payments/${encodeURIComponent(paymentId)}/status-history`,
+      options
+    );
+  }
   /**
    * Update an existing payment intent before it is confirmed.
    *