@stigg/typescript 0.1.0-alpha.1 → 0.1.0-alpha.3

package/src/core/pagination.ts

@@ -109,22 +109,31 @@ export class PagePromise<
 
 export interface MyCursorIDPageResponse<Item> {
   data: Array<Item>;
+
+  pagination: MyCursorIDPageResponse.Pagination;
+}
+
+export namespace MyCursorIDPageResponse {
+  export interface Pagination {
+    next?: string;
+
+    prev?: string;
+  }
 }
 
 export interface MyCursorIDPageParams {
-  starting_after?: string;
+  after?: string;
 
-  ending_before?: string;
+  before?: string;
 
   limit?: number;
 }
 
-export class MyCursorIDPage<Item extends { cursor_id: string }>
-  extends AbstractPage<Item>
-  implements MyCursorIDPageResponse<Item>
-{
+export class MyCursorIDPage<Item> extends AbstractPage<Item> implements MyCursorIDPageResponse<Item> {
   data: Array<Item>;
 
+  pagination: MyCursorIDPageResponse.Pagination;
+
   constructor(
     client: Stigg,
     response: Response,
@@ -134,6 +143,7 @@ export class MyCursorIDPage<Item extends { cursor_id: string }>
     super(client, response, body, options);
 
     this.data = body.data || [];
+    this.pagination = body.pagination || {};
   }
 
   getPaginatedItems(): Item[] {
@@ -141,14 +151,10 @@ export class MyCursorIDPage<Item extends { cursor_id: string }>
   }
 
   nextPageRequestOptions(): PageRequestOptions | null {
-    const data = this.getPaginatedItems();
-
-    const isForwards = !(
-      typeof this.options.query === 'object' && 'ending_before' in (this.options.query || {})
-    );
-    if (isForwards) {
-      const cursorID = data[data.length - 1]?.cursor_id;
-      if (!cursorID) {
+    if ((this.options.query as Record<string, unknown>)?.['before']) {
+      // in reverse
+      const prev = this.pagination?.prev;
+      if (!prev) {
         return null;
       }
 
@@ -156,13 +162,13 @@ export class MyCursorIDPage<Item extends { cursor_id: string }>
         ...this.options,
         query: {
           ...maybeObj(this.options.query),
-          starting_after: cursorID,
+          before: prev,
         },
       };
     }
 
-    const cursorID = data[0]?.cursor_id;
-    if (!cursorID) {
+    const cursor = this.pagination?.next;
+    if (!cursor) {
       return null;
     }
 
@@ -170,7 +176,7 @@ export class MyCursorIDPage<Item extends { cursor_id: string }>
       ...this.options,
       query: {
         ...maybeObj(this.options.query),
-        ending_before: cursorID,
+        after: cursor,
       },
     };
   }

package/src/resources/v1/coupons.ts

@@ -2,40 +2,55 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Coupons extends APIResource {
   /**
-   * Create a new Coupon
+   * Create coupon
    */
   create(body: CouponCreateParams, options?: RequestOptions): APIPromise<CouponCreateResponse> {
     return this._client.post('/api/v1/coupons', { body, ...options });
   }
 
   /**
-   * Get a single Coupon by id
+   * Get a single coupon by ID
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<CouponRetrieveResponse> {
     return this._client.get(path`/api/v1/coupons/${id}`, options);
   }
 
   /**
-   * Get a list of Coupons
+   * Get a list of coupons
    */
   list(
     query: CouponListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<CouponListResponse> {
-    return this._client.get('/api/v1/coupons', { query, ...options });
+  ): PagePromise<CouponListResponsesMyCursorIDPage, CouponListResponse> {
+    return this._client.getAPIList('/api/v1/coupons', MyCursorIDPage<CouponListResponse>, {
+      query,
+      ...options,
+    });
   }
 }
 
+export type CouponListResponsesMyCursorIDPage = MyCursorIDPage<CouponListResponse>;
+
+/**
+ * Response object
+ */
 export interface CouponCreateResponse {
+  /**
+   * Discount instrument with percentage or fixed amount
+   */
   data: CouponCreateResponse.Data;
 }
 
 export namespace CouponCreateResponse {
+  /**
+   * Discount instrument with percentage or fixed amount
+   */
   export interface Data {
     /**
      * The unique identifier for the entity
@@ -104,6 +119,9 @@ export namespace CouponCreateResponse {
   }
 
   export namespace Data {
+    /**
+     * Monetary amount with currency
+     */
     export interface AmountsOff {
       /**
        * The price amount
@@ -229,17 +247,25 @@ export namespace CouponCreateResponse {
         | 'ugx'
         | 'pyg'
         | 'xof'
-        | 'xpf'
-        | null;
+        | 'xpf';
     }
   }
 }
 
+/**
+ * Response object
+ */
 export interface CouponRetrieveResponse {
+  /**
+   * Discount instrument with percentage or fixed amount
+   */
   data: CouponRetrieveResponse.Data;
 }
 
 export namespace CouponRetrieveResponse {
+  /**
+   * Discount instrument with percentage or fixed amount
+   */
   export interface Data {
     /**
      * The unique identifier for the entity
@@ -308,6 +334,9 @@ export namespace CouponRetrieveResponse {
   }
 
   export namespace Data {
+    /**
+     * Monetary amount with currency
+     */
     export interface AmountsOff {
       /**
        * The price amount
@@ -433,218 +462,211 @@ export namespace CouponRetrieveResponse {
         | 'ugx'
         | 'pyg'
         | 'xof'
-        | 'xpf'
-        | null;
+        | 'xpf';
     }
   }
 }
 
+/**
+ * Discount instrument with percentage or fixed amount
+ */
 export interface CouponListResponse {
-  data: Array<CouponListResponse.Data>;
-}
+  /**
+   * The unique identifier for the entity
+   */
+  id: string;
 
-export namespace CouponListResponse {
-  export interface Data {
-    /**
-     * The unique identifier for the entity
-     */
-    id: string;
+  /**
+   * Fixed amount discounts in different currencies
+   */
+  amountsOff: Array<CouponListResponse.AmountsOff> | null;
 
-    /**
-     * Fixed amount discounts in different currencies
-     */
-    amountsOff: Array<Data.AmountsOff> | null;
+  /**
+   * The unique identifier for the entity in the billing provider
+   */
+  billingId: string | null;
 
-    /**
-     * The unique identifier for the entity in the billing provider
-     */
-    billingId: string | null;
+  /**
+   * The URL to the entity in the billing provider
+   */
+  billingLinkUrl: string | null;
 
-    /**
-     * The URL to the entity in the billing provider
-     */
-    billingLinkUrl: string | null;
+  /**
+   * Timestamp of when the record was created
+   */
+  createdAt: string;
 
-    /**
-     * Timestamp of when the record was created
-     */
-    createdAt: string;
+  /**
+   * Description of the coupon
+   */
+  description: string | null;
 
-    /**
-     * Cursor ID for query pagination
-     */
-    cursorId: string;
+  /**
+   * Duration of the coupon validity in months
+   */
+  durationInMonths: number | null;
 
-    /**
-     * Description of the coupon
-     */
-    description: string | null;
+  /**
+   * Name of the coupon
+   */
+  name: string;
 
-    /**
-     * Duration of the coupon validity in months
-     */
-    durationInMonths: number | null;
+  /**
+   * Percentage discount off the original price
+   */
+  percentOff: number | null;
 
-    /**
-     * Name of the coupon
-     */
-    name: string;
+  /**
+   * The source of the coupon
+   */
+  source: 'STIGG' | 'STIGG_ADHOC' | 'STRIPE' | null;
 
-    /**
-     * Percentage discount off the original price
-     */
-    percentOff: number | null;
+  /**
+   * Current status of the coupon
+   */
+  status: 'ACTIVE' | 'ARCHIVED';
 
-    /**
-     * The source of the coupon
-     */
-    source: 'STIGG' | 'STIGG_ADHOC' | 'STRIPE' | null;
+  /**
+   * Type of the coupon (percentage or fixed amount)
+   */
+  type: 'FIXED' | 'PERCENTAGE';
 
-    /**
-     * Current status of the coupon
-     */
-    status: 'ACTIVE' | 'ARCHIVED';
+  /**
+   * Timestamp of when the record was last updated
+   */
+  updatedAt: string;
+}
 
+export namespace CouponListResponse {
+  /**
+   * Monetary amount with currency
+   */
+  export interface AmountsOff {
     /**
-     * Type of the coupon (percentage or fixed amount)
+     * The price amount
      */
-    type: 'FIXED' | 'PERCENTAGE';
+    amount: number;
 
     /**
-     * Timestamp of when the record was last updated
+     * The price currency
      */
-    updatedAt: string;
-  }
-
-  export namespace Data {
-    export interface AmountsOff {
-      /**
-       * The price amount
-       */
-      amount: number;
-
-      /**
-       * The price currency
-       */
-      currency:
-        | 'usd'
-        | 'aed'
-        | 'all'
-        | 'amd'
-        | 'ang'
-        | 'aud'
-        | 'awg'
-        | 'azn'
-        | 'bam'
-        | 'bbd'
-        | 'bdt'
-        | 'bgn'
-        | 'bif'
-        | 'bmd'
-        | 'bnd'
-        | 'bsd'
-        | 'bwp'
-        | 'byn'
-        | 'bzd'
-        | 'brl'
-        | 'cad'
-        | 'cdf'
-        | 'chf'
-        | 'cny'
-        | 'czk'
-        | 'dkk'
-        | 'dop'
-        | 'dzd'
-        | 'egp'
-        | 'etb'
-        | 'eur'
-        | 'fjd'
-        | 'gbp'
-        | 'gel'
-        | 'gip'
-        | 'gmd'
-        | 'gyd'
-        | 'hkd'
-        | 'hrk'
-        | 'htg'
-        | 'idr'
-        | 'ils'
-        | 'inr'
-        | 'isk'
-        | 'jmd'
-        | 'jpy'
-        | 'kes'
-        | 'kgs'
-        | 'khr'
-        | 'kmf'
-        | 'krw'
-        | 'kyd'
-        | 'kzt'
-        | 'lbp'
-        | 'lkr'
-        | 'lrd'
-        | 'lsl'
-        | 'mad'
-        | 'mdl'
-        | 'mga'
-        | 'mkd'
-        | 'mmk'
-        | 'mnt'
-        | 'mop'
-        | 'mro'
-        | 'mvr'
-        | 'mwk'
-        | 'mxn'
-        | 'myr'
-        | 'mzn'
-        | 'nad'
-        | 'ngn'
-        | 'nok'
-        | 'npr'
-        | 'nzd'
-        | 'pgk'
-        | 'php'
-        | 'pkr'
-        | 'pln'
-        | 'qar'
-        | 'ron'
-        | 'rsd'
-        | 'rub'
-        | 'rwf'
-        | 'sar'
-        | 'sbd'
-        | 'scr'
-        | 'sek'
-        | 'sgd'
-        | 'sle'
-        | 'sll'
-        | 'sos'
-        | 'szl'
-        | 'thb'
-        | 'tjs'
-        | 'top'
-        | 'try'
-        | 'ttd'
-        | 'tzs'
-        | 'uah'
-        | 'uzs'
-        | 'vnd'
-        | 'vuv'
-        | 'wst'
-        | 'xaf'
-        | 'xcd'
-        | 'yer'
-        | 'zar'
-        | 'zmw'
-        | 'clp'
-        | 'djf'
-        | 'gnf'
-        | 'ugx'
-        | 'pyg'
-        | 'xof'
-        | 'xpf'
-        | null;
-    }
+    currency:
+      | 'usd'
+      | 'aed'
+      | 'all'
+      | 'amd'
+      | 'ang'
+      | 'aud'
+      | 'awg'
+      | 'azn'
+      | 'bam'
+      | 'bbd'
+      | 'bdt'
+      | 'bgn'
+      | 'bif'
+      | 'bmd'
+      | 'bnd'
+      | 'bsd'
+      | 'bwp'
+      | 'byn'
+      | 'bzd'
+      | 'brl'
+      | 'cad'
+      | 'cdf'
+      | 'chf'
+      | 'cny'
+      | 'czk'
+      | 'dkk'
+      | 'dop'
+      | 'dzd'
+      | 'egp'
+      | 'etb'
+      | 'eur'
+      | 'fjd'
+      | 'gbp'
+      | 'gel'
+      | 'gip'
+      | 'gmd'
+      | 'gyd'
+      | 'hkd'
+      | 'hrk'
+      | 'htg'
+      | 'idr'
+      | 'ils'
+      | 'inr'
+      | 'isk'
+      | 'jmd'
+      | 'jpy'
+      | 'kes'
+      | 'kgs'
+      | 'khr'
+      | 'kmf'
+      | 'krw'
+      | 'kyd'
+      | 'kzt'
+      | 'lbp'
+      | 'lkr'
+      | 'lrd'
+      | 'lsl'
+      | 'mad'
+      | 'mdl'
+      | 'mga'
+      | 'mkd'
+      | 'mmk'
+      | 'mnt'
+      | 'mop'
+      | 'mro'
+      | 'mvr'
+      | 'mwk'
+      | 'mxn'
+      | 'myr'
+      | 'mzn'
+      | 'nad'
+      | 'ngn'
+      | 'nok'
+      | 'npr'
+      | 'nzd'
+      | 'pgk'
+      | 'php'
+      | 'pkr'
+      | 'pln'
+      | 'qar'
+      | 'ron'
+      | 'rsd'
+      | 'rub'
+      | 'rwf'
+      | 'sar'
+      | 'sbd'
+      | 'scr'
+      | 'sek'
+      | 'sgd'
+      | 'sle'
+      | 'sll'
+      | 'sos'
+      | 'szl'
+      | 'thb'
+      | 'tjs'
+      | 'top'
+      | 'try'
+      | 'ttd'
+      | 'tzs'
+      | 'uah'
+      | 'uzs'
+      | 'vnd'
+      | 'vuv'
+      | 'wst'
+      | 'xaf'
+      | 'xcd'
+      | 'yer'
+      | 'zar'
+      | 'zmw'
+      | 'clp'
+      | 'djf'
+      | 'gnf'
+      | 'ugx'
+      | 'pyg'
+      | 'xof'
+      | 'xpf';
   }
 }
 
@@ -686,6 +708,9 @@ export interface CouponCreateParams {
 }
 
 export namespace CouponCreateParams {
+  /**
+   * Monetary amount with currency
+   */
   export interface AmountsOff {
     /**
      * The price amount
@@ -815,28 +840,14 @@ export namespace CouponCreateParams {
   }
 }
 
-export interface CouponListParams {
-  /**
-   * Ending before this UUID for pagination
-   */
-  endingBefore?: string;
-
-  /**
-   * Items per page
-   */
-  limit?: number;
-
-  /**
-   * Starting after this UUID for pagination
-   */
-  startingAfter?: string;
-}
+export interface CouponListParams extends MyCursorIDPageParams {}
 
 export declare namespace Coupons {
   export {
     type CouponCreateResponse as CouponCreateResponse,
     type CouponRetrieveResponse as CouponRetrieveResponse,
     type CouponListResponse as CouponListResponse,
+    type CouponListResponsesMyCursorIDPage as CouponListResponsesMyCursorIDPage,
     type CouponCreateParams as CouponCreateParams,
     type CouponListParams as CouponListParams,
   };