@mixedbread/sdk 0.14.0 → 0.16.0

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.
  */
@@ -194,6 +200,11 @@ export interface ParsingJob {
    */
   file_id: string;
 
+  /**
+   * The name of the file
+   */
+  filename?: string | null;
+
   /**
    * The status of the job
    */
@@ -332,140 +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 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';
 }
 
 /**
@@ -515,33 +439,16 @@ export interface JobCreateParams {
   mode?: 'fast' | 'high_quality';
 }
 
-export interface JobListParams {
-  /**
-   * Maximum number of items to return per page (1-100)
-   */
-  limit?: number;
-
+export interface JobListParams extends CursorParams {
   /**
-   * 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)
+   * Status to filter by
    */
-  include_total?: boolean;
+  statuses?: Array<ParsingJobStatus> | null;
 
   /**
-   * Status to filter by
+   * Search query to filter by
    */
-  statuses?: Array<ParsingJobStatus> | null;
+  q?: string | null;
 }
 
 export declare namespace Jobs {
@@ -553,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,
   };

package/src/resources/vector-stores/files.ts

@@ -5,6 +5,7 @@ import * as FilesAPI from './files';
 import * as Shared from '../shared';
 import * as VectorStoresAPI from './vector-stores';
 import { APIPromise } from '../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import * as polling from '../../lib/polling';
 import { Uploadable } from '../../uploads';
@@ -56,8 +57,12 @@ export class Files extends APIResource {
     vectorStoreIdentifier: string,
     query: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FileListResponse> {
-    return this._client.get(path`/v1/vector_stores/${vectorStoreIdentifier}/files`, { query, ...options });
+  ): PagePromise<VectorStoreFilesCursor, VectorStoreFile> {
+    return this._client.getAPIList(
+      path`/v1/vector_stores/${vectorStoreIdentifier}/files`,
+      Cursor<VectorStoreFile>,
+      { query, ...options },
+    );
   }
 
   /**
@@ -197,6 +202,8 @@ export class Files extends APIResource {
   }
 }
 
+export type VectorStoreFilesCursor = Cursor<VectorStoreFile>;
+
 /**
  * Represents a reranking configuration.
  */
@@ -345,95 +352,6 @@ export interface VectorStoreFile {
   object?: 'vector_store.file';
 }
 
-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 vector store files
-   */
-  data: Array<VectorStoreFile>;
-}
-
-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;
-  }
-}
-
 /**
  * Response model for file deletion.
  */
@@ -507,29 +425,7 @@ export interface FileRetrieveParams {
   vector_store_identifier: string;
 }
 
-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 {
   /**
    * Status to filter by
    */
@@ -627,9 +523,9 @@ export declare namespace Files {
     type ScoredVectorStoreFile as ScoredVectorStoreFile,
     type VectorStoreFileStatus as VectorStoreFileStatus,
     type VectorStoreFile as VectorStoreFile,
-    type FileListResponse as FileListResponse,
     type FileDeleteResponse as FileDeleteResponse,
     type FileSearchResponse as FileSearchResponse,
+    type VectorStoreFilesCursor as VectorStoreFilesCursor,
     type FileCreateParams as FileCreateParams,
     type FileRetrieveParams as FileRetrieveParams,
     type FileListParams as FileListParams,

package/src/resources/vector-stores/index.ts

@@ -6,7 +6,6 @@ export {
   type ScoredVectorStoreFile,
   type VectorStoreFileStatus,
   type VectorStoreFile,
-  type FileListResponse,
   type FileDeleteResponse,
   type FileSearchResponse,
   type FileCreateParams,
@@ -14,6 +13,7 @@ export {
   type FileListParams,
   type FileDeleteParams,
   type FileSearchParams,
+  type VectorStoreFilesCursor,
 } from './files';
 export {
   VectorStores,
@@ -24,7 +24,6 @@ export {
   type ScoredVideoURLInputChunk,
   type VectorStore,
   type VectorStoreChunkSearchOptions,
-  type VectorStoreListResponse,
   type VectorStoreDeleteResponse,
   type VectorStoreQuestionAnsweringResponse,
   type VectorStoreSearchResponse,
@@ -33,4 +32,5 @@ export {
   type VectorStoreListParams,
   type VectorStoreQuestionAnsweringParams,
   type VectorStoreSearchParams,
+  type VectorStoresCursor,
 } from './vector-stores';