Add SeamPaginator

Author: razor-x

src/lib/seam/connect/seam-http-request.ts

@@ -20,6 +20,11 @@ interface SeamHttpRequestConfig<TResponseKey> {
   readonly options?: Pick<SeamHttpRequestOptions, 'waitForActionAttempt'>
 }
 
+interface Pagination {
+  readonly hasNextPage: boolean
+  readonly nextPageCursor: string | null
+}
+
 export class SeamHttpRequest<
   const TResponse,
   const TResponseKey extends keyof TResponse | undefined,
@@ -33,6 +38,8 @@ export class SeamHttpRequest<
   readonly #parent: SeamHttpRequestParent
   readonly #config: SeamHttpRequestConfig<TResponseKey>
 
+  #pagination: Pagination | null = null
+
   constructor(
     parent: SeamHttpRequestParent,
     config: SeamHttpRequestConfig<TResponseKey>,
@@ -56,15 +63,18 @@ export class SeamHttpRequest<
 
     const origin = getUrlPrefix(client.defaults.baseURL ?? '')
 
-    const pathname = this.#config.path.startsWith('/')
-      ? this.#config.path
-      : `/${this.#config.path}`
-
-    const path = params == null ? pathname : `${pathname}?${serializer(params)}`
+    const path =
+      params == null ? this.pathname : `${this.pathname}?${serializer(params)}`
 
     return new URL(`${origin}${path}`)
   }
 
+  public get pathname(): string {
+    return this.#config.path.startsWith('/')
+      ? this.#config.path
+      : `/${this.#config.path}`
+  }
+
   public get method(): Method {
     return this.#config.method
   }
@@ -73,6 +83,10 @@ export class SeamHttpRequest<
     return this.#config.body
   }
 
+  public get pagination(): Pagination | null {
+    return this.#pagination
+  }
+
   async execute(): Promise<
     TResponseKey extends keyof TResponse ? TResponse[TResponseKey] : undefined
   > {
@@ -88,6 +102,7 @@ export class SeamHttpRequest<
         ? TResponse[TResponseKey]
         : undefined
     }
+    if ('pagination' in response.data) this.#pagination = this.pagination
     const data = response.data[this.responseKey]
     if (this.responseKey === 'action_attempt') {
       const waitForActionAttempt =

src/lib/seam/connect/seam-http.ts

@@ -40,6 +40,8 @@ import {
   SeamHttpWebhooks,
   SeamHttpWorkspaces,
 } from './routes/index.js'
+import type { SeamHttpRequest } from './seam-http-request.js'
+import { SeamPaginator } from './seam-paginator.js'
 
 export class SeamHttp {
   client: Client
@@ -143,6 +145,10 @@ export class SeamHttp {
     return new SeamHttp(constructorOptions)
   }
 
+  createPaginator(page: SeamHttpRequest<any, any>): SeamPaginator {
+    return new SeamPaginator(this, page)
+  }
+
   async updateClientSessionToken(
     clientSessionToken: SeamHttpOptionsWithClientSessionToken['clientSessionToken'],
   ): Promise<void> {