@delopay/sdk 0.30.0 → 0.32.0

package/dist/index.cjs

@@ -1003,19 +1003,21 @@ var Payments = class {
    * Create a new payment intent.
    *
    * @param params - Payment creation parameters including amount and currency.
+   * @param options - Optional per-call extras: extra `headers` (e.g. an
+   *   `Idempotency-Key` to make the create safe to retry), a `timeout` override,
+   *   and an `AbortSignal`.
    * @returns The created payment intent.
    *
    * @example
    * ```typescript
-   * const payment = await delopay.payments.create({
-   *   amount: 5000,
-   *   currency: 'EUR',
-   *   customer_id: 'cus_123',
-   * });
+   * const payment = await delopay.payments.create(
+   *   { amount: 5000, currency: 'EUR', customer_id: 'cus_123' },
+   *   { headers: { 'Idempotency-Key': 'order_1001' } },
+   * );
    * ```
    */
-  async create(params) {
-    return this.request("POST", "/payments", { body: params });
+  async create(params, options) {
+    return this.request("POST", "/payments", { body: params, ...options });
   }
   /**
    * Retrieve a payment by its ID.
@@ -1099,6 +1101,8 @@ var Payments = class {
    * List payment intents, optionally filtered by customer or date range.
    *
    * @param params - Optional filter and pagination parameters.
+   * @param options - Optional per-call extras: extra `headers`, a `timeout`
+   *   override, and an `AbortSignal` for cancellation.
    * @returns Paginated list of payment intents.
    *
    * @example
@@ -1106,9 +1110,10 @@ var Payments = class {
    * const { data } = await delopay.payments.list({ customer_id: 'cus_123', limit: 25 });
    * ```
    */
-  async list(params) {
+  async list(params, options) {
     return this.request("GET", "/payments/list", {
-      query: params
+      query: params,
+      ...options
     });
   }
   // --- Advanced operations (Task 3.2) ---
@@ -1829,7 +1834,7 @@ var Shops = class {
    *
    * @example
    * ```typescript
-   * const shop = await delopay.shops.create('merch_123', { profile_name: 'EU Store' });
+   * const shop = await delopay.shops.create('merch_123', { shop_name: 'EU Store' });
    * ```
    */
   async create(merchantId, params) {
@@ -2589,11 +2594,16 @@ var Subscriptions = class {
   constructor(request) {
     this.request = request;
   }
-  /** Create and immediately confirm a subscription. `POST /subscriptions` */
+  /**
+   * Create and immediately confirm a subscription. `POST /subscriptions`
+   *
+   * For billing processors that require buyer approval (e.g. PayPal), the
+   * response carries a `redirect_url` the customer must be sent to.
+   */
   async createAndConfirm(params) {
     return this.request("POST", "/subscriptions", { body: params });
   }
-  /** Create a subscription (without confirming). `POST /subscriptions/create` */
+  /** Create a subscription without confirming it. `POST /subscriptions/create` */
   async create(params) {
     return this.request("POST", "/subscriptions/create", { body: params });
   }
@@ -2601,43 +2611,58 @@ var Subscriptions = class {
   async retrieve(subscriptionId) {
     return this.request("GET", `/subscriptions/${encodeURIComponent(subscriptionId)}`);
   }
-  /** Confirm a subscription. `POST /subscriptions/{subscriptionId}/confirm` */
+  /**
+   * Confirm a previously created subscription. `POST /subscriptions/{subscriptionId}/confirm`
+   *
+   * Like {@link createAndConfirm}, the response may carry a `redirect_url` for
+   * processors that require buyer approval.
+   */
   async confirm(subscriptionId, params) {
     return this.request("POST", `/subscriptions/${encodeURIComponent(subscriptionId)}/confirm`, {
       body: params
     });
   }
-  /** Update a subscription. `PUT /subscriptions/{subscriptionId}/update` */
+  /** Update a subscription's plan/price. `PUT /subscriptions/{subscriptionId}/update` */
   async update(subscriptionId, params) {
     return this.request("PUT", `/subscriptions/${encodeURIComponent(subscriptionId)}/update`, {
       body: params
     });
   }
-  /** List subscriptions. `GET /subscriptions/list` */
+  /** List subscriptions for the profile. `GET /subscriptions/list` */
   async list(params) {
     return this.request("GET", "/subscriptions/list", {
       query: params
     });
   }
-  /** Get subscription estimate. `GET /subscriptions/estimate` */
+  /** Estimate the cost of a subscription before creating it. `GET /subscriptions/estimate` */
   async getEstimate(params) {
-    return this.request("GET", "/subscriptions/estimate", { query: params });
+    return this.request("GET", "/subscriptions/estimate", {
+      query: params
+    });
   }
-  /** Get subscription items. `GET /subscriptions/items` */
+  /** List purchasable subscription items (plans/addons). `GET /subscriptions/items` */
   async getItems(params) {
-    return this.request("GET", "/subscriptions/items", { query: params });
+    return this.request("GET", "/subscriptions/items", {
+      query: params
+    });
   }
   /** Pause a subscription. `POST /subscriptions/{subscriptionId}/pause` */
-  async pause(subscriptionId) {
-    return this.request("POST", `/subscriptions/${encodeURIComponent(subscriptionId)}/pause`);
+  async pause(subscriptionId, params) {
+    return this.request("POST", `/subscriptions/${encodeURIComponent(subscriptionId)}/pause`, {
+      body: params
+    });
   }
-  /** Resume a subscription. `POST /subscriptions/{subscriptionId}/resume` */
-  async resume(subscriptionId) {
-    return this.request("POST", `/subscriptions/${encodeURIComponent(subscriptionId)}/resume`);
+  /** Resume a paused subscription. `POST /subscriptions/{subscriptionId}/resume` */
+  async resume(subscriptionId, params) {
+    return this.request("POST", `/subscriptions/${encodeURIComponent(subscriptionId)}/resume`, {
+      body: params
+    });
   }
   /** Cancel a subscription. `POST /subscriptions/{subscriptionId}/cancel` */
-  async cancel(subscriptionId) {
-    return this.request("POST", `/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`);
+  async cancel(subscriptionId, params) {
+    return this.request("POST", `/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`, {
+      body: params
+    });
   }
 };
 
@@ -2722,7 +2747,7 @@ var Delopay = class {
   /**
    * Create a new Delopay client.
    *
-   * @param apiKey - Your Delopay API key (e.g. `sk_live_...` or `sk_test_...`).
+   * @param apiKey - Your Delopay API key (e.g. `prd_...` or `snd_...`).
    *   Pass an empty string or omit for JWT-only usage (e.g. dashboard apps).
    * @param options - Optional configuration (sandbox mode, base URL override, timeout).
    */
@@ -2979,34 +3004,64 @@ var Delopay = class {
    * Auto-paginate a list endpoint. Yields items one by one, fetching
    * the next page automatically when the current one is exhausted.
    *
-   * @param listFn - A function that takes `{ limit, offset }` and returns `{ data: T[] }` or `T[]`.
+   * Delopay list endpoints use one of two pagination styles, so this helper
+   * supports both:
+   * - **Offset** (default) — for endpoints like `customers.list` that accept
+   *   `offset`/`limit`. Each page advances `offset` by the number of items returned.
+   * - **Cursor** — for endpoints like `payments.list` and `payouts.list` that page
+   *   with `starting_after`/`limit` (they ignore `offset`). Pass a `cursor` extractor
+   *   that returns the id of an item; the next page is requested with
+   *   `starting_after` set to the last item's id.
+   *
+   * @param listFn - A function that takes the paging params and returns `{ data: T[] }` or `T[]`.
    * @param params - Additional parameters to pass to every page request.
-   * @param pageSize - Number of items per page. Defaults to `50`.
+   * @param options - Page size (number) for offset mode, or `{ pageSize?, cursor? }`.
+   *   Provide `cursor` to switch to cursor pagination.
    *
    * @example
    * ```typescript
+   * // Offset endpoint (customers):
+   * for await (const c of delopay.paginate((p) => delopay.customers.list(p))) {
+   *   console.log(c.customer_id);
+   * }
+   *
+   * // Cursor endpoint (payments): extract the id used as the next cursor.
    * for await (const payment of delopay.paginate(
    *   (p) => delopay.payments.list(p),
+   *   undefined,
+   *   { cursor: (p) => p.payment_id },
    * )) {
    *   console.log(payment.payment_id);
    * }
    * ```
    */
-  async *paginate(listFn, params, pageSize = 50) {
+  async *paginate(listFn, params, options) {
+    const pageSize = typeof options === "number" ? options : options?.pageSize ?? 50;
+    const cursorOf = typeof options === "object" ? options.cursor : void 0;
     let offset = 0;
+    let after;
     while (true) {
-      const result = await listFn({
-        ...params ?? {},
-        limit: pageSize,
-        offset
-      });
+      const page = { ...params ?? {}, limit: pageSize };
+      if (cursorOf) {
+        if (after !== void 0) page.starting_after = after;
+      } else {
+        page.offset = offset;
+      }
+      const result = await listFn(page);
       const items = Array.isArray(result) ? result : result.data;
       if (items.length === 0) break;
       for (const item of items) {
         yield item;
       }
       if (items.length < pageSize) break;
-      offset += items.length;
+      if (cursorOf) {
+        const last = items[items.length - 1];
+        if (last === void 0) break;
+        after = cursorOf(last);
+        if (after === void 0) break;
+      } else {
+        offset += items.length;
+      }
     }
   }
 };