@mixedbread/sdk 0.11.0 → 0.12.0

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

@@ -2,7 +2,6 @@
 
 import { APIResource } from '../../core/resource';
 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';
 
@@ -73,12 +72,8 @@ export class Connectors extends APIResource {
     dataSourceID: string,
     query: ConnectorListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<DataSourceConnectorsCursor, DataSourceConnector> {
-    return this._client.getAPIList(
-      path`/v1/data_sources/${dataSourceID}/connectors`,
-      Cursor<DataSourceConnector>,
-      { query, ...options },
-    );
+  ): APIPromise<ConnectorListResponse> {
+    return this._client.get(path`/v1/data_sources/${dataSourceID}/connectors`, { query, ...options });
   }
 
   /**
@@ -99,8 +94,6 @@ export class Connectors extends APIResource {
   }
 }
 
-export type DataSourceConnectorsCursor = Cursor<DataSourceConnector>;
-
 /**
  * Service-level representation of a connector.
  */
@@ -176,6 +169,98 @@ export interface DataSourceConnector {
   object?: 'data_source.connector';
 }
 
+/**
+ * A list of connectors with pagination.
+ */
+export interface ConnectorListResponse {
+  /**
+   * 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: ConnectorListResponse.Pagination;
+
+  /**
+   * The list of connectors
+   */
+  data: Array<DataSourceConnector>;
+
+  /**
+   * The object type of the response
+   */
+  object?: 'list';
+}
+
+export namespace ConnectorListResponse {
+  /**
+   * 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 connector.
  */
@@ -267,7 +352,29 @@ export interface ConnectorUpdateParams {
   polling_interval?: number | string | null;
 }
 
-export interface ConnectorListParams extends CursorParams {}
+export interface ConnectorListParams {
+  /**
+   * 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 ConnectorDeleteParams {
   /**
@@ -279,8 +386,8 @@ export interface ConnectorDeleteParams {
 export declare namespace Connectors {
   export {
     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/data-sources.ts

@@ -7,14 +7,13 @@ 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';
 
@@ -67,8 +66,8 @@ export class DataSources extends APIResource {
   list(
     query: DataSourceListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<DataSourcesCursor, DataSource> {
-    return this._client.getAPIList('/v1/data_sources/', Cursor<DataSource>, { query, ...options });
+  ): APIPromise<DataSourceListResponse> {
+    return this._client.get('/v1/data_sources/', { query, ...options });
   }
 
   /**
@@ -81,8 +80,6 @@ export class DataSources extends APIResource {
   }
 }
 
-export type DataSourcesCursor = Cursor<DataSource>;
-
 /**
  * Service-level representation of a data source.
  */
@@ -258,6 +255,98 @@ 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.
  */
@@ -408,7 +497,29 @@ export declare namespace DataSourceUpdateParams {
   }
 }
 
-export interface DataSourceListParams extends CursorParams {}
+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;
+}
 
 DataSources.Connectors = Connectors;
 
@@ -420,8 +531,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,
@@ -430,8 +541,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,7 +2,6 @@
 
 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';
@@ -56,8 +55,8 @@ export class Files extends APIResource {
   list(
     query: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<FileObjectsCursor, FileObject> {
-    return this._client.getAPIList('/v1/files', Cursor<FileObject>, { query, ...options });
+  ): APIPromise<FileListResponse> {
+    return this._client.get('/v1/files', { query, ...options });
   }
 
   /**
@@ -87,8 +86,6 @@ export class Files extends APIResource {
   }
 }
 
-export type FileObjectsCursor = Cursor<FileObject>;
-
 /**
  * A model representing a file object in the system.
  *
@@ -152,6 +149,95 @@ 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
@@ -183,14 +269,41 @@ export interface FileUpdateParams {
   file: Uploadable;
 }
 
-export interface FileListParams extends CursorParams {}
+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;
+
+  /**
+   * Search query for fuzzy matching over name and description fields
+   */
+  q?: string | null;
+}
 
 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,6 +47,7 @@ export {
   type ScoredVideoURLInputChunk,
   type VectorStore,
   type VectorStoreChunkSearchOptions,
+  type VectorStoreListResponse,
   type VectorStoreDeleteResponse,
   type VectorStoreQuestionAnsweringResponse,
   type VectorStoreSearchResponse,
@@ -55,7 +56,6 @@ export {
   type VectorStoreListParams,
   type VectorStoreQuestionAnsweringParams,
   type VectorStoreSearchParams,
-  type VectorStoresCursor,
 } from './vector-stores/vector-stores';
 export {
   type Embedding,

package/src/resources/parsing/index.ts

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