@delopay/sdk 0.147.0 → 0.150.0

package/dist/index.cjs

@@ -1348,7 +1348,7 @@ var Events = class {
   }
   /**
    * Fire an outgoing webhook event by hand for one object.
-   * `POST /events/{merchant_id}/trigger` (be#318)
+   * `POST /events/{merchant_id}/trigger`
    *
    * Not a replay — see {@link EventManualTriggerRequest}. Needs the
    * `WebhookEventTrigger` permission, which is separate from the one that
@@ -1371,7 +1371,7 @@ var Events = class {
   }
   /**
    * Fire an outgoing webhook event by hand (profile-scoped).
-   * `POST /events/profile/trigger` (be#318)
+   * `POST /events/profile/trigger`
    *
    * The shop-user twin of {@link trigger}; the shop is taken from the auth
    * context, so `profile_id` on the body is ignored.
@@ -2064,9 +2064,8 @@ var Payments = class {
     );
   }
   /**
-   * Open a playback of the payment's stored checkout recording
-   * (delopay-backend#1501, delopay-control-center#779): the audited act of
-   * watching. Answers the manifest — which slices exist, how long the
+   * Open a playback of the payment's stored checkout recording: the audited
+   * act of watching. Answers the manifest — which slices exist, how long the
    * recording runs, whether a pause in it is expected — and the
    * `playback_id` every {@link Payments.replaySlice} call carries.
    *
@@ -4676,6 +4675,15 @@ var Audit = class {
 };
 
 // src/resources/settlement.ts
+function exportHeaders(options, accept) {
+  const headers = new Headers(options?.headers);
+  headers.set("Accept", accept);
+  const output = {};
+  headers.forEach((value, key) => {
+    output[key] = value;
+  });
+  return output;
+}
 var Settlement = class {
   constructor(request) {
     this.request = request;
@@ -4828,6 +4836,45 @@ var Settlement = class {
       { body: params, ...options }
     );
   }
+  /** Append one external transfer record. Send a stable idempotency_key for safe retries. */
+  async recordStatementPayout(statementId, params, options) {
+    return this.request(
+      "POST",
+      `/settlement/statements/${encodeURIComponent(statementId)}/payout`,
+      {
+        body: params,
+        ...options,
+        bodyIdempotencyKey: params.idempotency_key ?? null
+      }
+    );
+  }
+  /** Read individual transfer records, their signed total, and any overpayment. */
+  async listStatementPayouts(statementId, options) {
+    return this.request(
+      "GET",
+      `/settlement/statements/${encodeURIComponent(statementId)}/payouts`,
+      options
+    );
+  }
+  /** Record a transfer against a shop's month before its statement exists. */
+  async recordAdvance(params, options) {
+    return this.request("POST", "/settlement/advances", {
+      body: params,
+      ...options,
+      bodyIdempotencyKey: params.idempotency_key ?? null
+    });
+  }
+  async listAdvances(params, options) {
+    return this.request("GET", "/settlement/advances", {
+      query: {
+        profile_id: params.profile_id,
+        year: params.year,
+        month: params.month,
+        test_mode: params.test_mode
+      },
+      ...options
+    });
+  }
   /**
    * Export a statement as PDF. Returns the raw PDF bytes as a `Blob`, with
    * the same auth, retries and error handling as every other call — persist
@@ -4945,6 +4992,109 @@ var Settlement = class {
       options
     );
   }
+  /**
+   * Calculate a period in its transaction currency. Requires a host-level
+   * dashboard JWT and settlement read permission. Profile users and roles
+   * restricted to selected connector accounts cannot read this aggregate.
+   * Rates apply once to the period total. Unknown or estimated fees keep
+   * dependent amounts provisional. Native money values remain integer strings.
+   */
+  async previewNative(params, options) {
+    return this.request("POST", "/settlement/native/preview", { body: params, ...options });
+  }
+  /**
+   * Recalculate and freeze an immutable report version. Requires settlement
+   * edit permission. Explicitly allow provisional figures when source fees
+   * are incomplete. A report records a calculation and sends no money.
+   * Reuse the same idempotency key when retrying the same request.
+   */
+  async createNativeReport(params, options) {
+    return this.request("POST", "/settlement/native/reports", {
+      body: params,
+      ...options,
+      bodyIdempotencyKey: params.idempotency_key
+    });
+  }
+  async retrieveNativeReport(reportId, options) {
+    return this.request(
+      "GET",
+      `/settlement/native/reports/${encodeURIComponent(reportId)}`,
+      options
+    );
+  }
+  /** List report summaries without fetching every source row in each saved snapshot. */
+  async listNativeReports(params, options) {
+    return this.request("GET", "/settlement/native/reports", {
+      query: {
+        profile_id: params.profile_id,
+        currency: params.currency,
+        test_mode: params.test_mode,
+        limit: params.limit,
+        offset: params.offset
+      },
+      ...options
+    });
+  }
+  /**
+   * Record a transfer already made, under settlement write permission and
+   * the caller's payout limits. This method never sends money. Native minor
+   * units remain strings; negative records must name a same-scope reversal.
+   * These records belong to the native ledger, separate from monthly USD
+   * statement payouts and advances.
+   */
+  async recordNativePayout(params, options) {
+    return this.request("POST", "/settlement/native/payouts", {
+      body: params,
+      ...options,
+      bodyIdempotencyKey: params.idempotency_key
+    });
+  }
+  async listNativePayouts(params, options) {
+    return this.request("GET", "/settlement/native/payouts", {
+      query: {
+        profile_id: params.profile_id,
+        currency: params.currency,
+        test_mode: params.test_mode,
+        limit: params.limit,
+        offset: params.offset
+      },
+      ...options
+    });
+  }
+  /** Refresh a bounded page of provider fee evidence. Follow next_offset while has_more is true. */
+  async refreshNativeFees(params, options) {
+    return this.request("POST", "/settlement/native/fees/refresh", { body: params, ...options });
+  }
+  async downloadNativeReportPdf(reportId, params, options) {
+    return this.request("GET", `/settlement/native/reports/${encodeURIComponent(reportId)}/pdf`, {
+      query: { include_transactions: params?.include_transactions },
+      responseType: "blob",
+      ...options
+    });
+  }
+  /** Download the frozen source rows and calculation as CSV. */
+  async downloadNativeReportCsv(reportId, options) {
+    return this.request(
+      "GET",
+      `/settlement/native/reports/${encodeURIComponent(reportId)}/export`,
+      {
+        ...options,
+        headers: exportHeaders(options, "text/csv"),
+        responseType: "blob"
+      }
+    );
+  }
+  /** Export the frozen report as JSON, excluding host account-level costs. */
+  async exportNativeReportJson(reportId, options) {
+    return this.request(
+      "GET",
+      `/settlement/native/reports/${encodeURIComponent(reportId)}/export`,
+      {
+        ...options,
+        headers: exportHeaders(options, "application/json")
+      }
+    );
+  }
 };
 
 // src/resources/operationLimits.ts
@@ -5302,7 +5452,7 @@ var Delopay = class {
         url += `?${qs}`;
       }
     }
-    const headers = {
+    let headers = {
       ...this.jwtToken ? { Authorization: `Bearer ${this.jwtToken}` } : this.apiKey ? { "api-key": this.apiKey } : {},
       ...options?.headers
     };
@@ -5310,14 +5460,40 @@ var Delopay = class {
     if (options?.body && !isRawBody) {
       headers["Content-Type"] = "application/json";
     }
-    const idempotencyKey = findIdempotencyKey(headers)?.trim();
-    const isRetryable = method === "GET" || method === "DELETE" || idempotencyKey !== void 0 && idempotencyKey !== "";
     let serializedBody;
     if (isRawBody) {
       serializedBody = options?.body;
     } else if (options?.body) {
       serializedBody = JSON.stringify(options.body);
     }
+    let idempotencyKey = findIdempotencyKey(headers)?.trim();
+    if (options && Object.prototype.hasOwnProperty.call(options, "bodyIdempotencyKey")) {
+      const bodyKey = options?.bodyIdempotencyKey;
+      const serialized = !isRawBody && typeof serializedBody === "string" ? JSON.parse(serializedBody) : null;
+      const actualKey = serialized && typeof serialized === "object" && !Array.isArray(serialized) ? serialized.idempotency_key ?? null : null;
+      const suppliedHeaders = Object.keys(headers).filter(
+        (name) => name.toLowerCase() === "idempotency-key"
+      );
+      if (bodyKey !== null && typeof bodyKey !== "string" || actualKey !== bodyKey || suppliedHeaders.some(
+        (name) => headers[name] !== bodyKey || headers[name]?.trim() !== headers[name]
+      )) {
+        throw new DelopayError("Request retry keys must match the JSON body key", {
+          status: 0,
+          code: "IDEMPOTENCY_KEY_MISMATCH",
+          type: "invalid_request"
+        });
+      }
+      idempotencyKey = bodyKey?.trim();
+      if (suppliedHeaders.length > 0) {
+        headers = {
+          ...Object.fromEntries(
+            Object.entries(headers).filter(([name]) => name.toLowerCase() !== "idempotency-key")
+          ),
+          "Idempotency-Key": idempotencyKey ?? ""
+        };
+      }
+    }
+    const isRetryable = method === "GET" || method === "DELETE" || idempotencyKey !== void 0 && idempotencyKey !== "";
     const callerSignal = options?.signal;
     if (callerSignal?.aborted) {
       throw new DelopayError("Request aborted", {
@@ -7658,10 +7834,9 @@ var CheckoutSession = class {
     }
   }
   /**
-   * Store one slice of the buyer's checkout recording on our own side
-   * (delopay-backend#1501, delopay-control-center#779). Called by the hosted
-   * checkout as the buyer works through the page; the client secret is
-   * attached automatically.
+   * Store one slice of the buyer's checkout recording on our own side.
+   * Called by the hosted checkout as the buyer works through the page; the
+   * client secret is attached automatically.
    *
    * **Not telemetry semantics, on purpose.** Unlike
    * {@link CheckoutSession.recordEvent}, this rejects with a `DelopayError`
@@ -7717,20 +7892,6 @@ var CheckoutSession = class {
       }
     );
   }
-  /**
-   * The Paysepro rail catalog for the buyer's country.
-   *
-   * `GET /payment-link/{merchantId}/{paymentId}/paysepro/methods`
-   *
-   * @param country - Lowercase ISO 3166-1 alpha-2 country code.
-   */
-  async payseproMethods(country, options) {
-    return this.client.request("GET", `${this.linkBase}/paysepro/methods`, {
-      query: { cc: country },
-      ...options,
-      headers: this.bearerHeaders(options?.headers)
-    });
-  }
   /**
    * The e-Payouts rail catalog for the buyer's country, plus the set of
    * countries that have at least one vendor.