@mixedbread/sdk 0.15.0 → 0.16.0

package/src/resources/data-sources/data-sources.ts

@@ -7,13 +7,14 @@ import {
   ConnectorDeleteParams,
   ConnectorDeleteResponse,
   ConnectorListParams,
-  ConnectorListResponse,
   ConnectorRetrieveParams,
   ConnectorUpdateParams,
   Connectors,
   DataSourceConnector,
+  DataSourceConnectorsCursor,
 } from './connectors';
 import { APIPromise } from '../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -66,8 +67,8 @@ export class DataSources extends APIResource {
   list(
     query: DataSourceListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<DataSourceListResponse> {
-    return this._client.get('/v1/data_sources/', { query, ...options });
+  ): PagePromise<DataSourcesCursor, DataSource> {
+    return this._client.getAPIList('/v1/data_sources/', Cursor<DataSource>, { query, ...options });
   }
 
   /**
@@ -80,6 +81,8 @@ export class DataSources extends APIResource {
   }
 }
 
+export type DataSourcesCursor = Cursor<DataSource>;
+
 /**
  * Service-level representation of a data source.
  */
@@ -255,98 +258,6 @@ export interface Oauth2Params {
   type?: 'oauth2';
 }
 
-/**
- * A list of data sources with pagination.
- */
-export interface DataSourceListResponse {
-  /**
-   * Response model for cursor-based pagination.
-   *
-   * Examples: Forward pagination response: { "has_more": true, "first_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMSIsImlkIjoiYWJjMTIzIn0=", "last_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMCIsImlkIjoieHl6Nzg5In0=", "total": null }
-   *
-   *     Final page response:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOSIsImlkIjoibGFzdDEyMyJ9",
-   *             "last_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOCIsImlkIjoiZmluYWw0NTYifQ==",
-   *             "total": 42
-   *         }
-   *
-   *     Empty results:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": null,
-   *             "last_cursor": null,
-   *             "total": 0
-   *         }
-   */
-  pagination: DataSourceListResponse.Pagination;
-
-  /**
-   * The list of data sources
-   */
-  data: Array<DataSource>;
-
-  /**
-   * The object type of the response
-   */
-  object?: 'list';
-}
-
-export namespace DataSourceListResponse {
-  /**
-   * Response model for cursor-based pagination.
-   *
-   * Examples: Forward pagination response: { "has_more": true, "first_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMSIsImlkIjoiYWJjMTIzIn0=", "last_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMCIsImlkIjoieHl6Nzg5In0=", "total": null }
-   *
-   *     Final page response:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOSIsImlkIjoibGFzdDEyMyJ9",
-   *             "last_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOCIsImlkIjoiZmluYWw0NTYifQ==",
-   *             "total": 42
-   *         }
-   *
-   *     Empty results:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": null,
-   *             "last_cursor": null,
-   *             "total": 0
-   *         }
-   */
-  export interface Pagination {
-    /**
-     * Contextual direction-aware flag: True if more items exist in the requested
-     * pagination direction. For 'after': more items after this page. For 'before':
-     * more items before this page.
-     */
-    has_more: boolean;
-
-    /**
-     * Cursor of the first item in this page. Use for backward pagination. None if page
-     * is empty.
-     */
-    first_cursor: string | null;
-
-    /**
-     * Cursor of the last item in this page. Use for forward pagination. None if page
-     * is empty.
-     */
-    last_cursor: string | null;
-
-    /**
-     * Total number of items available across all pages. Only included when
-     * include_total=true was requested. Expensive operation - use sparingly.
-     */
-    total?: number | null;
-  }
-}
-
 /**
  * Deleted data source.
  */
@@ -497,29 +408,7 @@ export declare namespace DataSourceUpdateParams {
   }
 }
 
-export interface DataSourceListParams {
-  /**
-   * Maximum number of items to return per page (1-100)
-   */
-  limit?: number;
-
-  /**
-   * Cursor for forward pagination - get items after this position. Use last_cursor
-   * from previous response.
-   */
-  after?: string | null;
-
-  /**
-   * Cursor for backward pagination - get items before this position. Use
-   * first_cursor from previous response.
-   */
-  before?: string | null;
-
-  /**
-   * Whether to include total count in response (expensive operation)
-   */
-  include_total?: boolean;
-}
+export interface DataSourceListParams extends CursorParams {}
 
 DataSources.Connectors = Connectors;
 
@@ -531,8 +420,8 @@ export declare namespace DataSources {
     type LinearDataSource as LinearDataSource,
     type NotionDataSource as NotionDataSource,
     type Oauth2Params as Oauth2Params,
-    type DataSourceListResponse as DataSourceListResponse,
     type DataSourceDeleteResponse as DataSourceDeleteResponse,
+    type DataSourcesCursor as DataSourcesCursor,
     type DataSourceCreateParams as DataSourceCreateParams,
     type DataSourceUpdateParams as DataSourceUpdateParams,
     type DataSourceListParams as DataSourceListParams,
@@ -541,8 +430,8 @@ export declare namespace DataSources {
   export {
     Connectors as Connectors,
     type DataSourceConnector as DataSourceConnector,
-    type ConnectorListResponse as ConnectorListResponse,
     type ConnectorDeleteResponse as ConnectorDeleteResponse,
+    type DataSourceConnectorsCursor as DataSourceConnectorsCursor,
     type ConnectorCreateParams as ConnectorCreateParams,
     type ConnectorRetrieveParams as ConnectorRetrieveParams,
     type ConnectorUpdateParams as ConnectorUpdateParams,

package/src/resources/data-sources/index.ts

@@ -3,13 +3,13 @@
 export {
   Connectors,
   type DataSourceConnector,
-  type ConnectorListResponse,
   type ConnectorDeleteResponse,
   type ConnectorCreateParams,
   type ConnectorRetrieveParams,
   type ConnectorUpdateParams,
   type ConnectorListParams,
   type ConnectorDeleteParams,
+  type DataSourceConnectorsCursor,
 } from './connectors';
 export {
   DataSources,
@@ -19,9 +19,9 @@ export {
   type LinearDataSource,
   type NotionDataSource,
   type Oauth2Params,
-  type DataSourceListResponse,
   type DataSourceDeleteResponse,
   type DataSourceCreateParams,
   type DataSourceUpdateParams,
   type DataSourceListParams,
+  type DataSourcesCursor,
 } from './data-sources';

package/src/resources/files.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../core/pagination';
 import { type Uploadable } from '../core/uploads';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
@@ -55,8 +56,8 @@ export class Files extends APIResource {
   list(
     query: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FileListResponse> {
-    return this._client.get('/v1/files', { query, ...options });
+  ): PagePromise<FileObjectsCursor, FileObject> {
+    return this._client.getAPIList('/v1/files', Cursor<FileObject>, { query, ...options });
   }
 
   /**
@@ -86,6 +87,8 @@ export class Files extends APIResource {
   }
 }
 
+export type FileObjectsCursor = Cursor<FileObject>;
+
 /**
  * A model representing a file object in the system.
  *
@@ -149,95 +152,6 @@ export interface PaginationWithTotal {
   total?: number;
 }
 
-export interface FileListResponse {
-  /**
-   * Response model for cursor-based pagination.
-   *
-   * Examples: Forward pagination response: { "has_more": true, "first_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMSIsImlkIjoiYWJjMTIzIn0=", "last_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMCIsImlkIjoieHl6Nzg5In0=", "total": null }
-   *
-   *     Final page response:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOSIsImlkIjoibGFzdDEyMyJ9",
-   *             "last_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOCIsImlkIjoiZmluYWw0NTYifQ==",
-   *             "total": 42
-   *         }
-   *
-   *     Empty results:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": null,
-   *             "last_cursor": null,
-   *             "total": 0
-   *         }
-   */
-  pagination: FileListResponse.Pagination;
-
-  /**
-   * The object type of the response
-   */
-  object?: 'list';
-
-  /**
-   * The list of files
-   */
-  data: Array<FileObject>;
-}
-
-export namespace FileListResponse {
-  /**
-   * Response model for cursor-based pagination.
-   *
-   * Examples: Forward pagination response: { "has_more": true, "first_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMSIsImlkIjoiYWJjMTIzIn0=", "last_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMCIsImlkIjoieHl6Nzg5In0=", "total": null }
-   *
-   *     Final page response:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOSIsImlkIjoibGFzdDEyMyJ9",
-   *             "last_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOCIsImlkIjoiZmluYWw0NTYifQ==",
-   *             "total": 42
-   *         }
-   *
-   *     Empty results:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": null,
-   *             "last_cursor": null,
-   *             "total": 0
-   *         }
-   */
-  export interface Pagination {
-    /**
-     * Contextual direction-aware flag: True if more items exist in the requested
-     * pagination direction. For 'after': more items after this page. For 'before':
-     * more items before this page.
-     */
-    has_more: boolean;
-
-    /**
-     * Cursor of the first item in this page. Use for backward pagination. None if page
-     * is empty.
-     */
-    first_cursor: string | null;
-
-    /**
-     * Cursor of the last item in this page. Use for forward pagination. None if page
-     * is empty.
-     */
-    last_cursor: string | null;
-
-    /**
-     * Total number of items available across all pages. Only included when
-     * include_total=true was requested. Expensive operation - use sparingly.
-     */
-    total?: number | null;
-  }
-}
-
 export interface FileDeleteResponse {
   /**
    * The ID of the deleted file
@@ -269,29 +183,7 @@ export interface FileUpdateParams {
   file: Uploadable;
 }
 
-export interface FileListParams {
-  /**
-   * Maximum number of items to return per page (1-100)
-   */
-  limit?: number;
-
-  /**
-   * Cursor for forward pagination - get items after this position. Use last_cursor
-   * from previous response.
-   */
-  after?: string | null;
-
-  /**
-   * Cursor for backward pagination - get items before this position. Use
-   * first_cursor from previous response.
-   */
-  before?: string | null;
-
-  /**
-   * Whether to include total count in response (expensive operation)
-   */
-  include_total?: boolean;
-
+export interface FileListParams extends CursorParams {
   /**
    * Search query for fuzzy matching over name and description fields
    */
@@ -302,8 +194,8 @@ export declare namespace Files {
   export {
     type FileObject as FileObject,
     type PaginationWithTotal as PaginationWithTotal,
-    type FileListResponse as FileListResponse,
     type FileDeleteResponse as FileDeleteResponse,
+    type FileObjectsCursor as FileObjectsCursor,
     type FileCreateParams as FileCreateParams,
     type FileUpdateParams as FileUpdateParams,
     type FileListParams as FileListParams,

package/src/resources/index.ts

@@ -19,11 +19,11 @@ export {
   type LinearDataSource,
   type NotionDataSource,
   type Oauth2Params,
-  type DataSourceListResponse,
   type DataSourceDeleteResponse,
   type DataSourceCreateParams,
   type DataSourceUpdateParams,
   type DataSourceListParams,
+  type DataSourcesCursor,
 } from './data-sources/data-sources';
 export { Embeddings, type EncodingFormat, type ObjectType, type EmbeddingCreateParams } from './embeddings';
 export { Extractions } from './extractions/extractions';
@@ -31,11 +31,11 @@ export {
   Files,
   type FileObject,
   type PaginationWithTotal,
-  type FileListResponse,
   type FileDeleteResponse,
   type FileCreateParams,
   type FileUpdateParams,
   type FileListParams,
+  type FileObjectsCursor,
 } from './files';
 export { Parsing } from './parsing/parsing';
 export {
@@ -47,7 +47,6 @@ export {
   type ScoredVideoURLInputChunk,
   type VectorStore,
   type VectorStoreChunkSearchOptions,
-  type VectorStoreListResponse,
   type VectorStoreDeleteResponse,
   type VectorStoreQuestionAnsweringResponse,
   type VectorStoreSearchResponse,
@@ -56,6 +55,7 @@ export {
   type VectorStoreListParams,
   type VectorStoreQuestionAnsweringParams,
   type VectorStoreSearchParams,
+  type VectorStoresCursor,
 } from './vector-stores/vector-stores';
 export {
   type Embedding,

package/src/resources/parsing/index.ts

@@ -11,5 +11,6 @@ export {
   type JobDeleteResponse,
   type JobCreateParams,
   type JobListParams,
+  type JobListResponsesCursor,
 } from './jobs';
 export { Parsing } from './parsing';

package/src/resources/parsing/jobs.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../core/resource';
 import * as JobsAPI from './jobs';
 import { APIPromise } from '../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 import * as polling from '../../lib/polling';
@@ -38,8 +39,11 @@ export class Jobs extends APIResource {
    *
    * Returns: List of parsing jobs with pagination.
    */
-  list(query: JobListParams | null | undefined = {}, options?: RequestOptions): APIPromise<JobListResponse> {
-    return this._client.get('/v1/parsing/jobs', { query, ...options });
+  list(
+    query: JobListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<JobListResponsesCursor, JobListResponse> {
+    return this._client.getAPIList('/v1/parsing/jobs', Cursor<JobListResponse>, { query, ...options });
   }
 
   /**
@@ -157,6 +161,8 @@ export class Jobs extends APIResource {
   }
 }
 
+export type JobListResponsesCursor = Cursor<JobListResponse>;
+
 /**
  * Strategy used for chunking document content.
  */
@@ -337,145 +343,53 @@ export namespace ParsingJob {
 export type ReturnFormat = 'html' | 'markdown' | 'plain';
 
 /**
- * A list of parsing jobs with pagination.
+ * A parsing job item for list responses, omitting result and error fields.
  */
 export interface JobListResponse {
   /**
-   * Response model for cursor-based pagination.
-   *
-   * Examples: Forward pagination response: { "has_more": true, "first_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMSIsImlkIjoiYWJjMTIzIn0=", "last_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMCIsImlkIjoieHl6Nzg5In0=", "total": null }
-   *
-   *     Final page response:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOSIsImlkIjoibGFzdDEyMyJ9",
-   *             "last_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOCIsImlkIjoiZmluYWw0NTYifQ==",
-   *             "total": 42
-   *         }
-   *
-   *     Empty results:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": null,
-   *             "last_cursor": null,
-   *             "total": 0
-   *         }
+   * The ID of the job
    */
-  pagination: JobListResponse.Pagination;
+  id: string;
 
   /**
-   * The list of parsing jobs
+   * The ID of the file to parse
    */
-  data: Array<JobListResponse.Data>;
+  file_id: string;
 
   /**
-   * The object type of the response
+   * The name of the file
    */
-  object?: 'list';
-}
+  filename?: string | null;
 
-export namespace JobListResponse {
   /**
-   * Response model for cursor-based pagination.
-   *
-   * Examples: Forward pagination response: { "has_more": true, "first_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMSIsImlkIjoiYWJjMTIzIn0=", "last_cursor":
-   * "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0zMCIsImlkIjoieHl6Nzg5In0=", "total": null }
-   *
-   *     Final page response:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOSIsImlkIjoibGFzdDEyMyJ9",
-   *             "last_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0xMi0yOCIsImlkIjoiZmluYWw0NTYifQ==",
-   *             "total": 42
-   *         }
-   *
-   *     Empty results:
-   *         {
-   *             "has_more": false,
-   *             "first_cursor": null,
-   *             "last_cursor": null,
-   *             "total": 0
-   *         }
-   */
-  export interface Pagination {
-    /**
-     * Contextual direction-aware flag: True if more items exist in the requested
-     * pagination direction. For 'after': more items after this page. For 'before':
-     * more items before this page.
-     */
-    has_more: boolean;
-
-    /**
-     * Cursor of the first item in this page. Use for backward pagination. None if page
-     * is empty.
-     */
-    first_cursor: string | null;
-
-    /**
-     * Cursor of the last item in this page. Use for forward pagination. None if page
-     * is empty.
-     */
-    last_cursor: string | null;
-
-    /**
-     * Total number of items available across all pages. Only included when
-     * include_total=true was requested. Expensive operation - use sparingly.
-     */
-    total?: number | null;
-  }
+   * The status of the job
+   */
+  status: ParsingJobStatus;
 
   /**
-   * A parsing job item for list responses, omitting result and error fields.
+   * The started time of the job
    */
-  export interface Data {
-    /**
-     * The ID of the job
-     */
-    id: string;
-
-    /**
-     * The ID of the file to parse
-     */
-    file_id: string;
-
-    /**
-     * The name of the file
-     */
-    filename?: string | null;
-
-    /**
-     * The status of the job
-     */
-    status: JobsAPI.ParsingJobStatus;
-
-    /**
-     * The started time of the job
-     */
-    started_at?: string | null;
+  started_at?: string | null;
 
-    /**
-     * The finished time of the job
-     */
-    finished_at?: string | null;
+  /**
+   * The finished time of the job
+   */
+  finished_at?: string | null;
 
-    /**
-     * The creation time of the job
-     */
-    created_at?: string;
+  /**
+   * The creation time of the job
+   */
+  created_at?: string;
 
-    /**
-     * The updated time of the job
-     */
-    updated_at?: string | null;
+  /**
+   * The updated time of the job
+   */
+  updated_at?: string | null;
 
-    /**
-     * The type of the object
-     */
-    object?: 'parsing_job';
-  }
+  /**
+   * The type of the object
+   */
+  object?: 'parsing_job';
 }
 
 /**
@@ -525,29 +439,7 @@ export interface JobCreateParams {
   mode?: 'fast' | 'high_quality';
 }
 
-export interface JobListParams {
-  /**
-   * Maximum number of items to return per page (1-100)
-   */
-  limit?: number;
-
-  /**
-   * Cursor for forward pagination - get items after this position. Use last_cursor
-   * from previous response.
-   */
-  after?: string | null;
-
-  /**
-   * Cursor for backward pagination - get items before this position. Use
-   * first_cursor from previous response.
-   */
-  before?: string | null;
-
-  /**
-   * Whether to include total count in response (expensive operation)
-   */
-  include_total?: boolean;
-
+export interface JobListParams extends CursorParams {
   /**
    * Status to filter by
    */
@@ -568,6 +460,7 @@ export declare namespace Jobs {
     type ReturnFormat as ReturnFormat,
     type JobListResponse as JobListResponse,
     type JobDeleteResponse as JobDeleteResponse,
+    type JobListResponsesCursor as JobListResponsesCursor,
     type JobCreateParams as JobCreateParams,
     type JobListParams as JobListParams,
   };

package/src/resources/parsing/parsing.ts

@@ -9,6 +9,7 @@ import {
   JobDeleteResponse,
   JobListParams,
   JobListResponse,
+  JobListResponsesCursor,
   Jobs,
   ParsingJob,
   ParsingJobStatus,
@@ -31,6 +32,7 @@ export declare namespace Parsing {
     type ReturnFormat as ReturnFormat,
     type JobListResponse as JobListResponse,
     type JobDeleteResponse as JobDeleteResponse,
+    type JobListResponsesCursor as JobListResponsesCursor,
     type JobCreateParams as JobCreateParams,
     type JobListParams as JobListParams,
   };