@delopay/sdk 0.30.0 → 0.31.0

package/dist/index.d.cts

@@ -185,6 +185,8 @@ interface PaymentCreateRequest {
     allowed_payment_method_types?: PaymentMethodType[] | null;
     /** Browser metadata for 3-D Secure fingerprinting. */
     browser_info?: Record<string, unknown> | null;
+    /** Set to `true` to generate a hosted payment link for this payment. */
+    payment_link?: boolean | null;
 }
 interface PaymentUpdateRequest {
     amount?: number | null;
@@ -217,6 +219,8 @@ interface PaymentUpdateRequest {
     phone_country_code?: string | null;
 }
 interface PaymentConfirmRequest {
+    /** Client secret from the created payment, required for client-side confirmation with a publishable key. */
+    client_secret?: string | null;
     payment_method?: PaymentMethod | null;
     payment_method_type?: PaymentMethodType | null;
     payment_method_data?: Record<string, unknown> | null;
@@ -323,6 +327,8 @@ interface PaymentResponse {
     disputes?: DisputeResponse[] | null;
     /** Instructions for completing additional customer actions (3DS redirect, etc.). */
     next_action?: Record<string, unknown> | null;
+    /** Hosted payment link details, present when the payment was created with `payment_link: true`. */
+    payment_link?: PaymentLinkResponse | null;
     /** Reason provided when the payment was cancelled. */
     cancellation_reason?: string | null;
     /** Bank statement descriptor (name portion). */
@@ -541,6 +547,8 @@ interface PaymentMethodResponse {
     client_secret?: string | null;
     status?: string | null;
     billing?: Address | null;
+    /** Token used to charge this saved method on a later payment (pass as `payment_token` to `payments.create`). */
+    payment_token?: string | null;
 }
 interface PaymentMethodListParams {
     client_secret?: string | null;
@@ -668,6 +676,8 @@ interface ShopUpdateRequest {
     return_url?: string | null;
     webhook_url?: string | null;
     is_active?: boolean | null;
+    /** Webhook signing secret for this shop. Outgoing webhooks are HMAC-SHA512 signed with this key. */
+    payment_response_hash_key?: string | null;
     payment_link_config?: BusinessPaymentLinkConfig | null;
     /**
      * Origins permitted to embed this shop's hosted checkout in an iframe.
@@ -2492,18 +2502,20 @@ declare class Payments {
      * 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' } },
+     * );
      * ```
      */
-    create(params: PaymentCreateRequest): Promise<PaymentResponse>;
+    create(params: PaymentCreateRequest, options?: RequestExtras): Promise<PaymentResponse>;
     /**
      * Retrieve a payment by its ID.
      *
@@ -2562,6 +2574,8 @@ declare class Payments {
      * 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
@@ -2569,7 +2583,7 @@ declare class Payments {
      * const { data } = await delopay.payments.list({ customer_id: 'cus_123', limit: 25 });
      * ```
      */
-    list(params?: PaymentListParams): Promise<PaymentListResponse>;
+    list(params?: PaymentListParams, options?: RequestExtras): Promise<PaymentListResponse>;
     /** Generate session tokens. `POST /payments/session-tokens` */
     sessionTokens(params: Record<string, unknown>): Promise<Record<string, unknown>>;
     /** Retrieve payment with gateway credentials. `POST /payments/sync` */
@@ -3031,7 +3045,7 @@ declare class Shops {
      *
      * @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' });
      * ```
      */
     create(merchantId: string, params: ShopCreateRequest): Promise<ShopResponse>;
@@ -3508,6 +3522,12 @@ interface RequestOptions {
     signal?: AbortSignal;
 }
 type RequestFn = <T>(method: string, path: string, options?: RequestOptions) => Promise<T>;
+/**
+ * Per-call options that resource methods accept as an optional final argument:
+ * extra HTTP headers (e.g. `Idempotency-Key`), a per-request timeout override,
+ * and an `AbortSignal` for cancellation.
+ */
+type RequestExtras = Pick<RequestOptions, 'headers' | 'timeout' | 'signal'>;
 /**
  * Delopay API client.
  *
@@ -3517,7 +3537,7 @@ type RequestFn = <T>(method: string, path: string, options?: RequestOptions) =>
  *
  * @example
  * ```typescript
- * const delopay = new Delopay('sk_live_...', { sandbox: false });
+ * const delopay = new Delopay('prd_...', { sandbox: false });
  * const payment = await delopay.payments.create({ amount: 5000, currency: 'EUR' });
  * ```
  */
@@ -3575,7 +3595,7 @@ declare class Delopay {
     /**
      * 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).
      */
@@ -3608,14 +3628,32 @@ declare class Delopay {
      * 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);
      * }
@@ -3623,10 +3661,14 @@ declare class Delopay {
      */
     paginate<T, P extends Record<string, unknown>>(listFn: (params: P & {
         limit: number;
-        offset: number;
+        offset?: number;
+        starting_after?: string;
     }) => Promise<{
         data: T[];
-    } | T[]>, params?: P, pageSize?: number): AsyncGenerator<T>;
+    } | T[]>, params?: P, options?: number | {
+        pageSize?: number;
+        cursor?: (item: T) => string | undefined;
+    }): AsyncGenerator<T>;
 }
 
 /**

package/dist/index.d.ts

@@ -185,6 +185,8 @@ interface PaymentCreateRequest {
     allowed_payment_method_types?: PaymentMethodType[] | null;
     /** Browser metadata for 3-D Secure fingerprinting. */
     browser_info?: Record<string, unknown> | null;
+    /** Set to `true` to generate a hosted payment link for this payment. */
+    payment_link?: boolean | null;
 }
 interface PaymentUpdateRequest {
     amount?: number | null;
@@ -217,6 +219,8 @@ interface PaymentUpdateRequest {
     phone_country_code?: string | null;
 }
 interface PaymentConfirmRequest {
+    /** Client secret from the created payment, required for client-side confirmation with a publishable key. */
+    client_secret?: string | null;
     payment_method?: PaymentMethod | null;
     payment_method_type?: PaymentMethodType | null;
     payment_method_data?: Record<string, unknown> | null;
@@ -323,6 +327,8 @@ interface PaymentResponse {
     disputes?: DisputeResponse[] | null;
     /** Instructions for completing additional customer actions (3DS redirect, etc.). */
     next_action?: Record<string, unknown> | null;
+    /** Hosted payment link details, present when the payment was created with `payment_link: true`. */
+    payment_link?: PaymentLinkResponse | null;
     /** Reason provided when the payment was cancelled. */
     cancellation_reason?: string | null;
     /** Bank statement descriptor (name portion). */
@@ -541,6 +547,8 @@ interface PaymentMethodResponse {
     client_secret?: string | null;
     status?: string | null;
     billing?: Address | null;
+    /** Token used to charge this saved method on a later payment (pass as `payment_token` to `payments.create`). */
+    payment_token?: string | null;
 }
 interface PaymentMethodListParams {
     client_secret?: string | null;
@@ -668,6 +676,8 @@ interface ShopUpdateRequest {
     return_url?: string | null;
     webhook_url?: string | null;
     is_active?: boolean | null;
+    /** Webhook signing secret for this shop. Outgoing webhooks are HMAC-SHA512 signed with this key. */
+    payment_response_hash_key?: string | null;
     payment_link_config?: BusinessPaymentLinkConfig | null;
     /**
      * Origins permitted to embed this shop's hosted checkout in an iframe.
@@ -2492,18 +2502,20 @@ declare class Payments {
      * 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' } },
+     * );
      * ```
      */
-    create(params: PaymentCreateRequest): Promise<PaymentResponse>;
+    create(params: PaymentCreateRequest, options?: RequestExtras): Promise<PaymentResponse>;
     /**
      * Retrieve a payment by its ID.
      *
@@ -2562,6 +2574,8 @@ declare class Payments {
      * 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
@@ -2569,7 +2583,7 @@ declare class Payments {
      * const { data } = await delopay.payments.list({ customer_id: 'cus_123', limit: 25 });
      * ```
      */
-    list(params?: PaymentListParams): Promise<PaymentListResponse>;
+    list(params?: PaymentListParams, options?: RequestExtras): Promise<PaymentListResponse>;
     /** Generate session tokens. `POST /payments/session-tokens` */
     sessionTokens(params: Record<string, unknown>): Promise<Record<string, unknown>>;
     /** Retrieve payment with gateway credentials. `POST /payments/sync` */
@@ -3031,7 +3045,7 @@ declare class Shops {
      *
      * @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' });
      * ```
      */
     create(merchantId: string, params: ShopCreateRequest): Promise<ShopResponse>;
@@ -3508,6 +3522,12 @@ interface RequestOptions {
     signal?: AbortSignal;
 }
 type RequestFn = <T>(method: string, path: string, options?: RequestOptions) => Promise<T>;
+/**
+ * Per-call options that resource methods accept as an optional final argument:
+ * extra HTTP headers (e.g. `Idempotency-Key`), a per-request timeout override,
+ * and an `AbortSignal` for cancellation.
+ */
+type RequestExtras = Pick<RequestOptions, 'headers' | 'timeout' | 'signal'>;
 /**
  * Delopay API client.
  *
@@ -3517,7 +3537,7 @@ type RequestFn = <T>(method: string, path: string, options?: RequestOptions) =>
  *
  * @example
  * ```typescript
- * const delopay = new Delopay('sk_live_...', { sandbox: false });
+ * const delopay = new Delopay('prd_...', { sandbox: false });
  * const payment = await delopay.payments.create({ amount: 5000, currency: 'EUR' });
  * ```
  */
@@ -3575,7 +3595,7 @@ declare class Delopay {
     /**
      * 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).
      */
@@ -3608,14 +3628,32 @@ declare class Delopay {
      * 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);
      * }
@@ -3623,10 +3661,14 @@ declare class Delopay {
      */
     paginate<T, P extends Record<string, unknown>>(listFn: (params: P & {
         limit: number;
-        offset: number;
+        offset?: number;
+        starting_after?: string;
     }) => Promise<{
         data: T[];
-    } | T[]>, params?: P, pageSize?: number): AsyncGenerator<T>;
+    } | T[]>, params?: P, options?: number | {
+        pageSize?: number;
+        cursor?: (item: T) => string | undefined;
+    }): AsyncGenerator<T>;
 }
 
 /**

package/dist/index.js

@@ -41,7 +41,7 @@ import {
   shadowFor,
   surfacePadValue,
   verticalGapValue
-} from "./chunk-INP6UXMJ.js";
+} from "./chunk-5C42YTV2.js";
 export {
   Analytics,
   AnalyticsDashboard,

package/dist/internal.cjs

@@ -1014,19 +1014,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.
@@ -1110,6 +1112,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
@@ -1117,9 +1121,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) ---
@@ -1840,7 +1845,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) {
@@ -2733,7 +2738,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).
    */
@@ -2990,34 +2995,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;
+      }
     }
   }
 };