aint-sdk 0.1.0-alpha.2 → 0.1.0-alpha.4

package/resources/projects.d.ts

@@ -0,0 +1,220 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { PageNumberPagination, type PageNumberPaginationParams, PagePromise } from "../core/pagination.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Projects extends APIResource {
+    /**
+     * Creates a new project
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.create();
+     * ```
+     */
+    create(body: ProjectCreateParams, options?: RequestOptions): APIPromise<Project>;
+    /**
+     * Updates an existing project
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.update('id');
+     * ```
+     */
+    update(id: string, body: ProjectUpdateParams, options?: RequestOptions): APIPromise<Project>;
+    /**
+     * Returns a paginated list of the user's projects
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const project of client.projects.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: ProjectListParams | null | undefined, options?: RequestOptions): PagePromise<ProjectsPageNumberPagination, Project>;
+    /**
+     * Deletes a project (soft delete)
+     *
+     * @example
+     * ```ts
+     * await client.projects.delete('id');
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Returns a single project by ID
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.get('id');
+     * ```
+     */
+    get(id: string, options?: RequestOptions): APIPromise<Project>;
+}
+export type ProjectsPageNumberPagination = PageNumberPagination<Project>;
+/**
+ * A translation project
+ */
+export interface Project {
+    /**
+     * Unique project identifier
+     */
+    id: string;
+    /**
+     * Project name
+     */
+    name: string;
+    /**
+     * Number of translation batches
+     */
+    batch_count?: number | null;
+    /**
+     * Number of chapters in the project
+     */
+    chapter_count?: number | null;
+    /**
+     * Project creation timestamp
+     */
+    created_at?: string | null;
+    /**
+     * Custom translation instructions
+     */
+    custom_instructions?: string | null;
+    /**
+     * Project description
+     */
+    description?: string | null;
+    /**
+     * Last update timestamp
+     */
+    last_updated_at?: string | null;
+    /**
+     * Name of the last updated chapter
+     */
+    last_updated_chapter_name?: string | null;
+    /**
+     * Source language for translation
+     */
+    original_language?: string | null;
+    /**
+     * JSON string of section break positions for latest file uploaded for batch
+     * translation
+     */
+    section_breaks?: string | null;
+    /**
+     * Target language for translation
+     */
+    translated_language?: string | null;
+    /**
+     * Latest filename of uploaded content for batch translation
+     */
+    uploaded_filename?: string | null;
+    /**
+     * Length of latest file uploaded for batch translation in characters
+     */
+    uploaded_length?: number | null;
+    /**
+     * UUID of latest file uploaded for batch translation
+     */
+    uploaded_uuid?: string | null;
+}
+/**
+ * Paginated list of projects
+ */
+export interface ProjectListResponse {
+    /**
+     * List of projects
+     */
+    data: Array<Project>;
+    /**
+     * Current page number
+     */
+    page: number;
+    /**
+     * Number of items per page
+     */
+    page_size: number;
+    /**
+     * Total number of projects
+     */
+    total: number;
+    /**
+     * Total number of pages
+     */
+    total_pages: number;
+}
+export interface ProjectCreateParams {
+    /**
+     * Custom translation instructions
+     */
+    custom_instructions?: string | null;
+    /**
+     * Project description
+     */
+    description?: string | null;
+    /**
+     * Project name (defaults to 'My Project')
+     */
+    name?: string;
+    /**
+     * Source language (defaults to 'Korean')
+     */
+    original_language?: string | null;
+    /**
+     * Target language (defaults to 'English')
+     */
+    translated_language?: string | null;
+}
+export interface ProjectUpdateParams {
+    /**
+     * Custom translation instructions
+     */
+    custom_instructions?: string | null;
+    /**
+     * Project description
+     */
+    description?: string | null;
+    /**
+     * Project name
+     */
+    name?: string;
+    /**
+     * Source language
+     */
+    original_language?: string | null;
+    /**
+     * JSON string of section break positions for batch translation
+     */
+    section_breaks?: string | null;
+    /**
+     * Target language
+     */
+    translated_language?: string | null;
+}
+export interface ProjectListParams extends PageNumberPaginationParams {
+    /**
+     * Filter by original language
+     */
+    original_language?: string;
+    /**
+     * Search query for project name
+     */
+    query?: string;
+    /**
+     * Sort direction
+     */
+    sort_direction?: 'asc' | 'desc';
+    /**
+     * Field to sort by
+     */
+    sort_field?: 'last_updated_at' | 'created_at' | 'name';
+    /**
+     * Filter by translated language
+     */
+    translated_language?: string;
+}
+export declare namespace Projects {
+    export { type Project as Project, type ProjectListResponse as ProjectListResponse, type ProjectsPageNumberPagination as ProjectsPageNumberPagination, type ProjectCreateParams as ProjectCreateParams, type ProjectUpdateParams as ProjectUpdateParams, type ProjectListParams as ProjectListParams, };
+}
+//# sourceMappingURL=projects.d.ts.map

package/resources/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/resources/projects.ts"],"names":[],"mappings":"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"}

package/resources/projects.js

@@ -0,0 +1,73 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Projects = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+class Projects extends resource_1.APIResource {
+    /**
+     * Creates a new project
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.create();
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/projects', { body, ...options });
+    }
+    /**
+     * Updates an existing project
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.update('id');
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch((0, path_1.path) `/projects/${id}`, { body, ...options });
+    }
+    /**
+     * Returns a paginated list of the user's projects
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const project of client.projects.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/projects', (pagination_1.PageNumberPagination), { query, ...options });
+    }
+    /**
+     * Deletes a project (soft delete)
+     *
+     * @example
+     * ```ts
+     * await client.projects.delete('id');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/projects/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Returns a single project by ID
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.get('id');
+     * ```
+     */
+    get(id, options) {
+        return this._client.get((0, path_1.path) `/projects/${id}`, options);
+    }
+}
+exports.Projects = Projects;
+//# sourceMappingURL=projects.js.map

package/resources/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../src/resources/projects.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAAwG;AACxG,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;OAOG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,iCAA6B,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,EAAU,EAAE,OAAwB;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AArED,4BAqEC"}

package/resources/projects.mjs

@@ -0,0 +1,69 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { PageNumberPagination } from "../core/pagination.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class Projects extends APIResource {
+    /**
+     * Creates a new project
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.create();
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/projects', { body, ...options });
+    }
+    /**
+     * Updates an existing project
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.update('id');
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch(path `/projects/${id}`, { body, ...options });
+    }
+    /**
+     * Returns a paginated list of the user's projects
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const project of client.projects.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/projects', (PageNumberPagination), { query, ...options });
+    }
+    /**
+     * Deletes a project (soft delete)
+     *
+     * @example
+     * ```ts
+     * await client.projects.delete('id');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/projects/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Returns a single project by ID
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.get('id');
+     * ```
+     */
+    get(id, options) {
+        return this._client.get(path `/projects/${id}`, options);
+    }
+}
+//# sourceMappingURL=projects.mjs.map

package/resources/projects.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.mjs","sourceRoot":"","sources":["../src/resources/projects.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,oBAAoB,EAAgD;OACtE,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;OAOG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,oBAA6B,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,EAAU,EAAE,OAAwB;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/src/client.ts

@@ -13,9 +13,34 @@ import * as Shims from './internal/shims';
 import * as Opts from './internal/request-options';
 import { VERSION } from './version';
 import * as Errors from './core/error';
+import * as Pagination from './core/pagination';
+import {
+  AbstractPage,
+  type PageNumberPaginationParams,
+  PageNumberPaginationResponse,
+} from './core/pagination';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
+import {
+  Chapter,
+  ChapterCreateParams,
+  ChapterListItem,
+  ChapterListItemsPageNumberPagination,
+  ChapterListParams,
+  ChapterListResponse,
+  ChapterUpdateParams,
+  Chapters,
+} from './resources/chapters';
+import {
+  Project,
+  ProjectCreateParams,
+  ProjectListParams,
+  ProjectListResponse,
+  ProjectUpdateParams,
+  Projects,
+  ProjectsPageNumberPagination,
+} from './resources/projects';
 import { User, Users } from './resources/users';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
@@ -506,6 +531,25 @@ export class AintSDK {
     return { response, options, controller, requestLogID, retryOfRequestLogID, startTime };
   }
 
+  getAPIList<Item, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(
+    path: string,
+    Page: new (...args: any[]) => PageClass,
+    opts?: RequestOptions,
+  ): Pagination.PagePromise<PageClass, Item> {
+    return this.requestAPIList(Page, { method: 'get', path, ...opts });
+  }
+
+  requestAPIList<
+    Item = unknown,
+    PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>,
+  >(
+    Page: new (...args: ConstructorParameters<typeof Pagination.AbstractPage>) => PageClass,
+    options: FinalRequestOptions,
+  ): Pagination.PagePromise<PageClass, Item> {
+    const request = this.makeRequest(options, null, undefined);
+    return new Pagination.PagePromise<PageClass, Item>(this as any as AintSDK, request, Page);
+  }
+
   async fetchWithTimeout(
     url: RequestInfo,
     init: RequestInit | undefined,
@@ -739,12 +783,43 @@ export class AintSDK {
   static toFile = Uploads.toFile;
 
   users: API.Users = new API.Users(this);
+  projects: API.Projects = new API.Projects(this);
+  chapters: API.Chapters = new API.Chapters(this);
 }
 
 AintSDK.Users = Users;
+AintSDK.Projects = Projects;
+AintSDK.Chapters = Chapters;
 
 export declare namespace AintSDK {
   export type RequestOptions = Opts.RequestOptions;
 
+  export import PageNumberPagination = Pagination.PageNumberPagination;
+  export {
+    type PageNumberPaginationParams as PageNumberPaginationParams,
+    type PageNumberPaginationResponse as PageNumberPaginationResponse,
+  };
+
   export { Users as Users, type User as User };
+
+  export {
+    Projects as Projects,
+    type Project as Project,
+    type ProjectListResponse as ProjectListResponse,
+    type ProjectsPageNumberPagination as ProjectsPageNumberPagination,
+    type ProjectCreateParams as ProjectCreateParams,
+    type ProjectUpdateParams as ProjectUpdateParams,
+    type ProjectListParams as ProjectListParams,
+  };
+
+  export {
+    Chapters as Chapters,
+    type Chapter as Chapter,
+    type ChapterListItem as ChapterListItem,
+    type ChapterListResponse as ChapterListResponse,
+    type ChapterListItemsPageNumberPagination as ChapterListItemsPageNumberPagination,
+    type ChapterCreateParams as ChapterCreateParams,
+    type ChapterUpdateParams as ChapterUpdateParams,
+    type ChapterListParams as ChapterListParams,
+  };
 }

package/src/core/pagination.ts

@@ -0,0 +1,166 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { AintSDKError } from './error';
+import { FinalRequestOptions } from '../internal/request-options';
+import { defaultParseResponse } from '../internal/parse';
+import { type AintSDK } from '../client';
+import { APIPromise } from './api-promise';
+import { type APIResponseProps } from '../internal/parse';
+import { maybeObj } from '../internal/utils/values';
+
+export type PageRequestOptions = Pick<FinalRequestOptions, 'query' | 'headers' | 'body' | 'path' | 'method'>;
+
+export abstract class AbstractPage<Item> implements AsyncIterable<Item> {
+  #client: AintSDK;
+  protected options: FinalRequestOptions;
+
+  protected response: Response;
+  protected body: unknown;
+
+  constructor(client: AintSDK, response: Response, body: unknown, options: FinalRequestOptions) {
+    this.#client = client;
+    this.options = options;
+    this.response = response;
+    this.body = body;
+  }
+
+  abstract nextPageRequestOptions(): PageRequestOptions | null;
+
+  abstract getPaginatedItems(): Item[];
+
+  hasNextPage(): boolean {
+    const items = this.getPaginatedItems();
+    if (!items.length) return false;
+    return this.nextPageRequestOptions() != null;
+  }
+
+  async getNextPage(): Promise<this> {
+    const nextOptions = this.nextPageRequestOptions();
+    if (!nextOptions) {
+      throw new AintSDKError(
+        'No next page expected; please check `.hasNextPage()` before calling `.getNextPage()`.',
+      );
+    }
+
+    return await this.#client.requestAPIList(this.constructor as any, nextOptions);
+  }
+
+  async *iterPages(): AsyncGenerator<this> {
+    let page: this = this;
+    yield page;
+    while (page.hasNextPage()) {
+      page = await page.getNextPage();
+      yield page;
+    }
+  }
+
+  async *[Symbol.asyncIterator](): AsyncGenerator<Item> {
+    for await (const page of this.iterPages()) {
+      for (const item of page.getPaginatedItems()) {
+        yield item;
+      }
+    }
+  }
+}
+
+/**
+ * This subclass of Promise will resolve to an instantiated Page once the request completes.
+ *
+ * It also implements AsyncIterable to allow auto-paginating iteration on an unawaited list call, eg:
+ *
+ *    for await (const item of client.items.list()) {
+ *      console.log(item)
+ *    }
+ */
+export class PagePromise<
+    PageClass extends AbstractPage<Item>,
+    Item = ReturnType<PageClass['getPaginatedItems']>[number],
+  >
+  extends APIPromise<PageClass>
+  implements AsyncIterable<Item>
+{
+  constructor(
+    client: AintSDK,
+    request: Promise<APIResponseProps>,
+    Page: new (...args: ConstructorParameters<typeof AbstractPage>) => PageClass,
+  ) {
+    super(
+      client,
+      request,
+      async (client, props) =>
+        new Page(client, props.response, await defaultParseResponse(client, props), props.options),
+    );
+  }
+
+  /**
+   * Allow auto-paginating iteration on an unawaited list call, eg:
+   *
+   *    for await (const item of client.items.list()) {
+   *      console.log(item)
+   *    }
+   */
+  async *[Symbol.asyncIterator](): AsyncGenerator<Item> {
+    const page = await this;
+    for await (const item of page) {
+      yield item;
+    }
+  }
+}
+
+export interface PageNumberPaginationResponse<Item> {
+  data: Array<Item>;
+
+  page: number;
+
+  total_pages: number;
+}
+
+export interface PageNumberPaginationParams {
+  page?: number;
+
+  page_size?: number;
+}
+
+export class PageNumberPagination<Item>
+  extends AbstractPage<Item>
+  implements PageNumberPaginationResponse<Item>
+{
+  data: Array<Item>;
+
+  page: number;
+
+  total_pages: number;
+
+  constructor(
+    client: AintSDK,
+    response: Response,
+    body: PageNumberPaginationResponse<Item>,
+    options: FinalRequestOptions,
+  ) {
+    super(client, response, body, options);
+
+    this.data = body.data || [];
+    this.page = body.page || 0;
+    this.total_pages = body.total_pages || 0;
+  }
+
+  getPaginatedItems(): Item[] {
+    return this.data ?? [];
+  }
+
+  nextPageRequestOptions(): PageRequestOptions | null {
+    const currentPage = this.page;
+
+    if (currentPage >= this.total_pages) {
+      return null;
+    }
+
+    return {
+      ...this.options,
+      query: {
+        ...maybeObj(this.options.query),
+        page: currentPage + 1,
+      },
+    };
+  }
+}

package/src/index.ts

@@ -5,6 +5,7 @@ export { AintSDK as default } from './client';
 export { type Uploadable, toFile } from './core/uploads';
 export { APIPromise } from './core/api-promise';
 export { AintSDK, type ClientOptions } from './client';
+export { PagePromise } from './core/pagination';
 export {
   AintSDKError,
   APIError,

package/src/pagination.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/pagination instead */
+export * from './core/pagination';