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

package/src/resources/chapters.ts

@@ -0,0 +1,301 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { PageNumberPagination, type PageNumberPaginationParams, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Chapters extends APIResource {
+  /**
+   * Creates a new chapter in a project
+   *
+   * @example
+   * ```ts
+   * const chapter = await client.chapters.create({
+   *   project_id: 'prj_xyz789',
+   *   title: 'Chapter 1 - The Beginning',
+   * });
+   * ```
+   */
+  create(body: ChapterCreateParams, options?: RequestOptions): APIPromise<Chapter> {
+    return this._client.post('/chapters', { body, ...options });
+  }
+
+  /**
+   * Updates an existing chapter
+   *
+   * @example
+   * ```ts
+   * const chapter = await client.chapters.update('id');
+   * ```
+   */
+  update(id: string, body: ChapterUpdateParams, options?: RequestOptions): APIPromise<Chapter> {
+    return this._client.patch(path`/chapters/${id}`, { body, ...options });
+  }
+
+  /**
+   * Returns a paginated list of chapters for a project
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const chapterListItem of client.chapters.list({
+   *   project_id: 'project_id',
+   * })) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: ChapterListParams,
+    options?: RequestOptions,
+  ): PagePromise<ChapterListItemsPageNumberPagination, ChapterListItem> {
+    return this._client.getAPIList('/chapters', PageNumberPagination<ChapterListItem>, { query, ...options });
+  }
+
+  /**
+   * Deletes a chapter (soft delete)
+   *
+   * @example
+   * ```ts
+   * await client.chapters.delete('id');
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/chapters/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Returns a single chapter by ID, including full text content and cost breakdown
+   *
+   * @example
+   * ```ts
+   * const chapter = await client.chapters.get('id');
+   * ```
+   */
+  get(id: string, options?: RequestOptions): APIPromise<Chapter> {
+    return this._client.get(path`/chapters/${id}`, options);
+  }
+}
+
+export type ChapterListItemsPageNumberPagination = PageNumberPagination<ChapterListItem>;
+
+/**
+ * A chapter with full content and cost breakdown
+ */
+export interface Chapter {
+  /**
+   * Unique chapter identifier
+   */
+  id: string;
+
+  /**
+   * Parent project identifier
+   */
+  project_id: string;
+
+  /**
+   * Chapter title
+   */
+  title: string;
+
+  /**
+   * Cost breakdown for the translation
+   */
+  cost?: Chapter.Cost | null;
+
+  /**
+   * Chapter creation timestamp
+   */
+  created_at?: string | null;
+
+  /**
+   * Timestamp of most recent translation edit
+   */
+  last_edited_at?: string | null;
+
+  /**
+   * Source language of the most recent translation
+   */
+  original_language?: string | null;
+
+  /**
+   * Original source text
+   */
+  original_text?: string | null;
+
+  /**
+   * AI-generated summary of the chapter content
+   */
+  summary_text?: string | null;
+
+  /**
+   * Target language of the most recent translation
+   */
+  translated_language?: string | null;
+
+  /**
+   * Translated text
+   */
+  translated_text?: string | null;
+}
+
+export namespace Chapter {
+  /**
+   * Cost breakdown for the translation
+   */
+  export interface Cost {
+    /**
+     * AI edit cost
+     */
+    edit?: number | null;
+
+    /**
+     * AI glossary generation cost
+     */
+    glossary?: number | null;
+
+    /**
+     * Summary generation cost
+     */
+    summary?: number | null;
+
+    /**
+     * Total cost (sum of all costs)
+     */
+    total?: number | null;
+
+    /**
+     * Translation cost
+     */
+    translation?: number | null;
+  }
+}
+
+/**
+ * A chapter summary for list responses
+ */
+export interface ChapterListItem {
+  /**
+   * Unique chapter identifier
+   */
+  id: string;
+
+  /**
+   * Parent project identifier
+   */
+  project_id: string;
+
+  /**
+   * Chapter title
+   */
+  title: string;
+
+  /**
+   * Chapter creation timestamp
+   */
+  created_at?: string | null;
+
+  /**
+   * Timestamp of most recent translation edit
+   */
+  last_edited_at?: string | null;
+
+  /**
+   * Source language of the most recent translation
+   */
+  original_language?: string | null;
+
+  /**
+   * AI-generated summary of the chapter content
+   */
+  summary_text?: string | null;
+
+  /**
+   * Target language of the most recent translation
+   */
+  translated_language?: string | null;
+}
+
+/**
+ * Paginated list of chapters
+ */
+export interface ChapterListResponse {
+  /**
+   * List of chapters
+   */
+  data: Array<ChapterListItem>;
+
+  /**
+   * Current page number
+   */
+  page: number;
+
+  /**
+   * Number of items per page
+   */
+  page_size: number;
+
+  /**
+   * Total number of chapters
+   */
+  total: number;
+
+  /**
+   * Total number of pages
+   */
+  total_pages: number;
+}
+
+export interface ChapterCreateParams {
+  /**
+   * Parent project ID
+   */
+  project_id: string;
+
+  /**
+   * Chapter title
+   */
+  title: string;
+}
+
+export interface ChapterUpdateParams {
+  /**
+   * Chapter title
+   */
+  title?: string;
+}
+
+export interface ChapterListParams extends PageNumberPaginationParams {
+  /**
+   * Project ID to filter chapters by
+   */
+  project_id: string;
+
+  /**
+   * Sort direction
+   */
+  sort_direction?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
+   */
+  sort_field?: 'title' | 'created_at' | 'last_edited_at';
+}
+
+export declare namespace Chapters {
+  export {
+    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/resources/index.ts

@@ -1,3 +1,22 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Chapters,
+  type Chapter,
+  type ChapterListItem,
+  type ChapterListResponse,
+  type ChapterCreateParams,
+  type ChapterUpdateParams,
+  type ChapterListParams,
+  type ChapterListItemsPageNumberPagination,
+} from './chapters';
+export {
+  Projects,
+  type Project,
+  type ProjectListResponse,
+  type ProjectCreateParams,
+  type ProjectUpdateParams,
+  type ProjectListParams,
+  type ProjectsPageNumberPagination,
+} from './projects';
 export { Users, type User } from './users';

package/src/resources/projects.ts

@@ -0,0 +1,289 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { PageNumberPagination, type PageNumberPaginationParams, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Projects extends APIResource {
+  /**
+   * Creates a new project
+   *
+   * @example
+   * ```ts
+   * const project = await client.projects.create();
+   * ```
+   */
+  create(body: ProjectCreateParams, options?: RequestOptions): APIPromise<Project> {
+    return this._client.post('/projects', { body, ...options });
+  }
+
+  /**
+   * Updates an existing project
+   *
+   * @example
+   * ```ts
+   * const project = await client.projects.update('id');
+   * ```
+   */
+  update(id: string, body: ProjectUpdateParams, options?: RequestOptions): APIPromise<Project> {
+    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: ProjectListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ProjectsPageNumberPagination, Project> {
+    return this._client.getAPIList('/projects', PageNumberPagination<Project>, { query, ...options });
+  }
+
+  /**
+   * Deletes a project (soft delete)
+   *
+   * @example
+   * ```ts
+   * await client.projects.delete('id');
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    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: string, options?: RequestOptions): APIPromise<Project> {
+    return this._client.get(path`/projects/${id}`, options);
+  }
+}
+
+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,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.2'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.4'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.2";
+export declare const VERSION = "0.1.0-alpha.4";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.2";
+export declare const VERSION = "0.1.0-alpha.4";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.1.0-alpha.2'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.4'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0-alpha.2'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.4'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map