@studyfetch/sdk 0.1.0-alpha.1

package/src/resources/v1/folders.ts

@@ -0,0 +1,167 @@
+// 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 { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Folders extends APIResource {
+  /**
+   * Create a new folder
+   *
+   * @example
+   * ```ts
+   * await client.v1.folders.create({ name: 'name' });
+   * ```
+   */
+  create(body: FolderCreateParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/folders', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get folder by ID
+   *
+   * @example
+   * ```ts
+   * await client.v1.folders.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/api/v1/folders/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Update folder
+   *
+   * @example
+   * ```ts
+   * await client.v1.folders.update('id');
+   * ```
+   */
+  update(id: string, body: FolderUpdateParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.patch(path`/api/v1/folders/${id}`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get all folders
+   *
+   * @example
+   * ```ts
+   * await client.v1.folders.list();
+   * ```
+   */
+  list(query: FolderListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/api/v1/folders', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Delete folder
+   *
+   * @example
+   * ```ts
+   * await client.v1.folders.delete('id');
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/api/v1/folders/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get folder tree structure
+   *
+   * @example
+   * ```ts
+   * await client.v1.folders.getTree();
+   * ```
+   */
+  getTree(options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/api/v1/folders/tree', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.folders.listMaterials('id');
+   * ```
+   */
+  listMaterials(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/api/v1/folders/${id}/materials`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.folders.move('id');
+   * ```
+   */
+  move(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.patch(path`/api/v1/folders/${id}/move`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface FolderCreateParams {
+  /**
+   * Folder name
+   */
+  name: string;
+
+  /**
+   * Parent folder ID (optional)
+   */
+  parentId?: string;
+}
+
+export interface FolderUpdateParams {
+  /**
+   * New folder name
+   */
+  name?: string;
+
+  /**
+   * New parent folder ID
+   */
+  parentId?: string;
+}
+
+export interface FolderListParams {
+  /**
+   * Filter by parent folder
+   */
+  parentId?: unknown;
+}
+
+export declare namespace Folders {
+  export {
+    type FolderCreateParams as FolderCreateParams,
+    type FolderUpdateParams as FolderUpdateParams,
+    type FolderListParams as FolderListParams,
+  };
+}

package/src/resources/v1/index.ts

@@ -0,0 +1,68 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Admin } from './admin/index';
+export {
+  AudioRecaps,
+  type AudioRecapCreateParams,
+  type AudioRecapAskQuestionParams,
+} from './audio-recaps/index';
+export {
+  Auth,
+  type AuthRegisterNewUserParams,
+  type AuthRegisterWithInviteParams,
+  type AuthRequestPasswordResetParams,
+  type AuthResetPasswordParams,
+} from './auth/index';
+export {
+  Chat,
+  type ChatRetrieveSessionParams,
+  type ChatSendMessageParams,
+  type ChatStreamParams,
+} from './chat/index';
+export {
+  Components,
+  type ComponentCreateParams,
+  type ComponentUpdateParams,
+  type ComponentListParams,
+  type ComponentEmbedParams,
+} from './components';
+export { Embed, type EmbedGetThemeParams, type EmbedVerifyParams } from './embed/index';
+export { Explainers, type ExplainerCreateParams, type ExplainerHandleWebhookParams } from './explainers';
+export {
+  Flashcards,
+  type FlashcardBatchProcessResponse,
+  type FlashcardGetAlgorithmInfoResponse,
+  type FlashcardGetTypesResponse,
+  type FlashcardBatchProcessParams,
+  type FlashcardGetAllParams,
+  type FlashcardGetDueParams,
+  type FlashcardGetStatsParams,
+  type FlashcardRateParams,
+} from './flashcards';
+export { Folders, type FolderCreateParams, type FolderUpdateParams, type FolderListParams } from './folders';
+export {
+  Materials,
+  type MaterialCreateParams,
+  type MaterialListParams,
+  type MaterialGetDownloadURLParams,
+} from './materials/index';
+export { Organizations, type OrganizationUpdateParams } from './organizations/index';
+export { Scenarios, type ScenarioCreateParams, type ScenarioUpdateParams } from './scenarios/index';
+export {
+  Tests,
+  type TestCreateParams,
+  type TestRetakeParams,
+  type TestSubmitParams,
+  type TestSubmitAnswerParams,
+} from './tests/index';
+export { Upload } from './upload/index';
+export {
+  Usage,
+  type UsageGetStatsParams,
+  type UsageGetSummaryParams,
+  type UsageListEventsParams,
+  type UsageTrackChatParams,
+  type UsageTrackEventParams,
+  type UsageTrackPerformanceParams,
+} from './usage';
+export { V1 } from './v1';

package/src/resources/v1/materials/bulk.ts

@@ -0,0 +1,21 @@
+// 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 { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Bulk extends APIResource {
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.bulk.move();
+   * ```
+   */
+  move(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/bulk/move', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}

package/src/resources/v1/materials/index.ts

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Bulk } from './bulk';
+export {
+  Materials,
+  type MaterialCreateParams,
+  type MaterialListParams,
+  type MaterialGetDownloadURLParams,
+} from './materials';
+export { Test } from './test';
+export { Upload, type UploadUploadFileParams, type UploadUploadFromURLParams } from './upload';

package/src/resources/v1/materials/materials.ts

@@ -0,0 +1,259 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as BulkAPI from './bulk';
+import { Bulk } from './bulk';
+import * as TestAPI from './test';
+import { Test } from './test';
+import * as UploadAPI from './upload';
+import { Upload, UploadUploadFileParams, UploadUploadFromURLParams } from './upload';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Materials extends APIResource {
+  upload: UploadAPI.Upload = new UploadAPI.Upload(this._client);
+  bulk: BulkAPI.Bulk = new BulkAPI.Bulk(this._client);
+  test: TestAPI.Test = new TestAPI.Test(this._client);
+
+  /**
+   * Create a new material
+   *
+   * @example
+   * ```ts
+   * await client.v1.materials.create({
+   *   content: { type: 'text' },
+   *   name: 'Chapter 1 - Introduction',
+   * });
+   * ```
+   */
+  create(body: MaterialCreateParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get material by ID
+   *
+   * @example
+   * ```ts
+   * await client.v1.materials.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/api/v1/materials/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get all materials for organization
+   *
+   * @example
+   * ```ts
+   * await client.v1.materials.list();
+   * ```
+   */
+  list(query: MaterialListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/api/v1/materials', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Delete material
+   *
+   * @example
+   * ```ts
+   * await client.v1.materials.delete('id');
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/api/v1/materials/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.createBatch();
+   * ```
+   */
+  createBatch(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/batch', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.debug('id');
+   * ```
+   */
+  debug(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/api/v1/materials/${id}/debug`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.getDownloadURL('id', {
+   *   expiresIn: 'expiresIn',
+   * });
+   * ```
+   */
+  getDownloadURL(
+    id: string,
+    query: MaterialGetDownloadURLParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.get(path`/api/v1/materials/${id}/download-url`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.move('id');
+   * ```
+   */
+  move(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/api/v1/materials/${id}/move`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.rename('id');
+   * ```
+   */
+  rename(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/api/v1/materials/${id}/rename`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.reprocess('id');
+   * ```
+   */
+  reprocess(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/api/v1/materials/${id}/reprocess`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.search();
+   * ```
+   */
+  search(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/search', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface MaterialCreateParams {
+  /**
+   * Content details
+   */
+  content: MaterialCreateParams.Content;
+
+  /**
+   * Name of the material
+   */
+  name: string;
+
+  /**
+   * Folder ID to place the material in
+   */
+  folderId?: string;
+}
+
+export namespace MaterialCreateParams {
+  /**
+   * Content details
+   */
+  export interface Content {
+    /**
+     * Type of content
+     */
+    type: 'text' | 'pdf' | 'video' | 'audio' | 'url';
+
+    /**
+     * URL to fetch content from
+     */
+    sourceUrl?: string;
+
+    /**
+     * Text content (for text type)
+     */
+    text?: string;
+
+    /**
+     * URL to the content (for url type)
+     */
+    url?: string;
+  }
+}
+
+export interface MaterialListParams {
+  /**
+   * Filter by folder ID
+   */
+  folderId?: string;
+}
+
+export interface MaterialGetDownloadURLParams {
+  expiresIn: string;
+}
+
+Materials.Upload = Upload;
+Materials.Bulk = Bulk;
+Materials.Test = Test;
+
+export declare namespace Materials {
+  export {
+    type MaterialCreateParams as MaterialCreateParams,
+    type MaterialListParams as MaterialListParams,
+    type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams,
+  };
+
+  export {
+    Upload as Upload,
+    type UploadUploadFileParams as UploadUploadFileParams,
+    type UploadUploadFromURLParams as UploadUploadFromURLParams,
+  };
+
+  export { Bulk as Bulk };
+
+  export { Test as Test };
+}

package/src/resources/v1/materials/test.ts

@@ -0,0 +1,60 @@
+// 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 { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Test extends APIResource {
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.test.performOcr();
+   * ```
+   */
+  performOcr(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/test/ocr', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.test.processEpub();
+   * ```
+   */
+  processEpub(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/test/epub-processing', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.test.processImage();
+   * ```
+   */
+  processImage(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/test/image-processing', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.test.processVideo();
+   * ```
+   */
+  processVideo(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/test/video-processing', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}

package/src/resources/v1/materials/upload.ts

@@ -0,0 +1,114 @@
+// 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 { type Uploadable } from '../../../core/uploads';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { multipartFormRequestOptions } from '../../../internal/uploads';
+
+export class Upload extends APIResource {
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.upload.completeUpload();
+   * ```
+   */
+  completeUpload(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/upload/complete', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.materials.upload.getPresignedURL();
+   * ```
+   */
+  getPresignedURL(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/upload/presigned-url', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Upload a material file
+   *
+   * @example
+   * ```ts
+   * await client.v1.materials.upload.uploadFile({
+   *   file: fs.createReadStream('path/to/file'),
+   *   name: 'name',
+   * });
+   * ```
+   */
+  uploadFile(body: UploadUploadFileParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(
+      '/api/v1/materials/upload',
+      multipartFormRequestOptions(
+        { body, ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
+        this._client,
+      ),
+    );
+  }
+
+  /**
+   * Upload material from URL
+   *
+   * @example
+   * ```ts
+   * await client.v1.materials.upload.uploadFromURL({
+   *   name: 'name',
+   *   url: 'url',
+   * });
+   * ```
+   */
+  uploadFromURL(body: UploadUploadFromURLParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/materials/upload/url', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface UploadUploadFileParams {
+  file: Uploadable;
+
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * Folder ID (optional)
+   */
+  folderId?: string;
+}
+
+export interface UploadUploadFromURLParams {
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * URL to fetch content from
+   */
+  url: string;
+
+  /**
+   * Folder ID (optional)
+   */
+  folderId?: string;
+}
+
+export declare namespace Upload {
+  export {
+    type UploadUploadFileParams as UploadUploadFileParams,
+    type UploadUploadFromURLParams as UploadUploadFromURLParams,
+  };
+}

package/src/resources/v1/materials.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './materials/index';