pagination.d.ts 3.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. import { FinalRequestOptions } from "../internal/request-options.js";
  2. import { APIPromise } from "./api-promise.js";
  3. import { type OpenAI } from "../client.js";
  4. import { type APIResponseProps } from "../internal/parse.js";
  5. export type PageRequestOptions = Pick<FinalRequestOptions, 'query' | 'headers' | 'body' | 'path' | 'method'>;
  6. export declare abstract class AbstractPage<Item> implements AsyncIterable<Item> {
  7. #private;
  8. protected options: FinalRequestOptions;
  9. protected response: Response;
  10. protected body: unknown;
  11. constructor(client: OpenAI, response: Response, body: unknown, options: FinalRequestOptions);
  12. abstract nextPageRequestOptions(): PageRequestOptions | null;
  13. abstract getPaginatedItems(): Item[];
  14. hasNextPage(): boolean;
  15. getNextPage(): Promise<this>;
  16. iterPages(): AsyncGenerator<this>;
  17. [Symbol.asyncIterator](): AsyncGenerator<Item>;
  18. }
  19. /**
  20. * This subclass of Promise will resolve to an instantiated Page once the request completes.
  21. *
  22. * It also implements AsyncIterable to allow auto-paginating iteration on an unawaited list call, eg:
  23. *
  24. * for await (const item of client.items.list()) {
  25. * console.log(item)
  26. * }
  27. */
  28. export declare class PagePromise<PageClass extends AbstractPage<Item>, Item = ReturnType<PageClass['getPaginatedItems']>[number]> extends APIPromise<PageClass> implements AsyncIterable<Item> {
  29. constructor(client: OpenAI, request: Promise<APIResponseProps>, Page: new (...args: ConstructorParameters<typeof AbstractPage>) => PageClass);
  30. /**
  31. * Allow auto-paginating iteration on an unawaited list call, eg:
  32. *
  33. * for await (const item of client.items.list()) {
  34. * console.log(item)
  35. * }
  36. */
  37. [Symbol.asyncIterator](): AsyncGenerator<Item>;
  38. }
  39. export interface PageResponse<Item> {
  40. data: Array<Item>;
  41. object: string;
  42. }
  43. /**
  44. * Note: no pagination actually occurs yet, this is for forwards-compatibility.
  45. */
  46. export declare class Page<Item> extends AbstractPage<Item> implements PageResponse<Item> {
  47. data: Array<Item>;
  48. object: string;
  49. constructor(client: OpenAI, response: Response, body: PageResponse<Item>, options: FinalRequestOptions);
  50. getPaginatedItems(): Item[];
  51. nextPageRequestOptions(): PageRequestOptions | null;
  52. }
  53. export interface CursorPageResponse<Item> {
  54. data: Array<Item>;
  55. has_more: boolean;
  56. }
  57. export interface CursorPageParams {
  58. after?: string;
  59. limit?: number;
  60. }
  61. export declare class CursorPage<Item extends {
  62. id: string;
  63. }> extends AbstractPage<Item> implements CursorPageResponse<Item> {
  64. data: Array<Item>;
  65. has_more: boolean;
  66. constructor(client: OpenAI, response: Response, body: CursorPageResponse<Item>, options: FinalRequestOptions);
  67. getPaginatedItems(): Item[];
  68. hasNextPage(): boolean;
  69. nextPageRequestOptions(): PageRequestOptions | null;
  70. }
  71. export interface ConversationCursorPageResponse<Item> {
  72. data: Array<Item>;
  73. has_more: boolean;
  74. last_id: string;
  75. }
  76. export interface ConversationCursorPageParams {
  77. after?: string;
  78. limit?: number;
  79. }
  80. export declare class ConversationCursorPage<Item> extends AbstractPage<Item> implements ConversationCursorPageResponse<Item> {
  81. data: Array<Item>;
  82. has_more: boolean;
  83. last_id: string;
  84. constructor(client: OpenAI, response: Response, body: ConversationCursorPageResponse<Item>, options: FinalRequestOptions);
  85. getPaginatedItems(): Item[];
  86. hasNextPage(): boolean;
  87. nextPageRequestOptions(): PageRequestOptions | null;
  88. }
  89. //# sourceMappingURL=pagination.d.ts.map