@studyfetch/sdk 1.27.0 → 1.29.0

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

@@ -143,6 +143,27 @@ export class Materials extends APIResource {
     return this._client.get(path`/api/v1/materials/${id}/debug`, options);
   }
 
+  /**
+   * Uses AI to generate study materials like outlines, notes, summaries, etc. from a
+   * given topic and waits for processing to complete
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.v1.materials.generateAndProcess({
+   *     name: 'Photosynthesis Study Plan',
+   *     topic: 'Photosynthesis in plants',
+   *     type: 'notes',
+   *   });
+   * ```
+   */
+  generateAndProcess(
+    body: MaterialGenerateAndProcessParams,
+    options?: RequestOptions,
+  ): APIPromise<MaterialGenerateAndProcessResponse> {
+    return this._client.post('/api/v1/materials/generate-and-process', { body, ...options });
+  }
+
   /**
    * Get temporary download URL for material
    *
@@ -400,6 +421,89 @@ export namespace MaterialDebugResponse {
   }
 }
 
+export interface MaterialGenerateAndProcessResponse {
+  /**
+   * Material ID
+   */
+  _id: string;
+
+  /**
+   * Material content
+   */
+  content: MaterialGenerateAndProcessResponse.Content;
+
+  /**
+   * Content type
+   */
+  contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
+
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+
+  /**
+   * Folder ID
+   */
+  folderId: string | null;
+
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * Organization ID
+   */
+  organizationId: string;
+
+  /**
+   * Material status
+   */
+  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
+
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+
+  /**
+   * Generation metadata
+   */
+  generationMetadata?: unknown;
+
+  /**
+   * Material metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * Usage information
+   */
+  usage?: unknown;
+}
+
+export namespace MaterialGenerateAndProcessResponse {
+  /**
+   * Material content
+   */
+  export interface Content {
+    filename?: string;
+
+    fileSize?: number;
+
+    mimeType?: string;
+
+    s3Key?: string;
+
+    s3Url?: string;
+
+    text?: string;
+
+    url?: string;
+  }
+}
+
 export interface MaterialGetDownloadURLResponse {
   /**
    * Temporary download URL
@@ -562,6 +666,53 @@ export interface MaterialCreateAndProcessParams {
   timeoutMs?: number;
 }
 
+export interface MaterialGenerateAndProcessParams {
+  /**
+   * Name for the generated material
+   */
+  name: string;
+
+  /**
+   * Topic or context to generate material from
+   */
+  topic: string;
+
+  /**
+   * Type of material to generate
+   */
+  type: 'outline' | 'overview' | 'notes' | 'summary';
+
+  /**
+   * Additional context or details about the topic
+   */
+  context?: string;
+
+  /**
+   * Target folder ID
+   */
+  folderId?: string;
+
+  /**
+   * Length of the generated content
+   */
+  length?: 'short' | 'medium' | 'long';
+
+  /**
+   * Target education level
+   */
+  level?: 'high_school' | 'college' | 'professional';
+
+  /**
+   * Polling interval in milliseconds (default: 2 seconds)
+   */
+  pollIntervalMs?: number;
+
+  /**
+   * Maximum time to wait for processing in milliseconds (default: 5 minutes)
+   */
+  timeoutMs?: number;
+}
+
 export interface MaterialGetDownloadURLParams {
   /**
    * URL expiration time in seconds (default: 3600)
@@ -616,12 +767,14 @@ export declare namespace Materials {
     type MaterialListResponse as MaterialListResponse,
     type MaterialBatchCreateResponse as MaterialBatchCreateResponse,
     type MaterialDebugResponse as MaterialDebugResponse,
+    type MaterialGenerateAndProcessResponse as MaterialGenerateAndProcessResponse,
     type MaterialGetDownloadURLResponse as MaterialGetDownloadURLResponse,
     type MaterialSearchResponse as MaterialSearchResponse,
     type MaterialCreateParams as MaterialCreateParams,
     type MaterialListParams as MaterialListParams,
     type MaterialBatchCreateParams as MaterialBatchCreateParams,
     type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams,
+    type MaterialGenerateAndProcessParams as MaterialGenerateAndProcessParams,
     type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams,
     type MaterialMoveParams as MaterialMoveParams,
     type MaterialRenameParams as MaterialRenameParams,

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

@@ -252,7 +252,7 @@ export interface UploadUploadFileAndProcessParams {
   pollIntervalMs?: number;
 
   /**
-   * Processing timeout in milliseconds (default: 300000)
+   * Processing timeout in milliseconds (default: 300000 - 5 minutes)
    */
   timeoutMs?: number;
 }

package/src/resources/v1/v1.ts

@@ -8,6 +8,8 @@ import {
   AssignmentGraderGetAllResponse,
   AssignmentGraderResponse,
 } from './assignment-grader';
+import * as ChatAPI from './chat';
+import { Chat, ChatStreamParams } from './chat';
 import * as ComponentsAPI from './components';
 import {
   Component,
@@ -32,6 +34,8 @@ import {
   MaterialCreateAndProcessParams,
   MaterialCreateParams,
   MaterialDebugResponse,
+  MaterialGenerateAndProcessParams,
+  MaterialGenerateAndProcessResponse,
   MaterialGetDownloadURLParams,
   MaterialGetDownloadURLResponse,
   MaterialListParams,
@@ -60,6 +64,7 @@ export class V1 extends APIResource {
   assignmentGrader: AssignmentGraderAPI.AssignmentGrader = new AssignmentGraderAPI.AssignmentGrader(
     this._client,
   );
+  chat: ChatAPI.Chat = new ChatAPI.Chat(this._client);
 
   /**
    * Test MongoDB connection and get outbound IP
@@ -84,6 +89,7 @@ V1.Usage = Usage;
 V1.Embed = Embed;
 V1.Upload = Upload;
 V1.AssignmentGrader = AssignmentGrader;
+V1.Chat = Chat;
 
 export declare namespace V1 {
   export {
@@ -93,12 +99,14 @@ export declare namespace V1 {
     type MaterialListResponse as MaterialListResponse,
     type MaterialBatchCreateResponse as MaterialBatchCreateResponse,
     type MaterialDebugResponse as MaterialDebugResponse,
+    type MaterialGenerateAndProcessResponse as MaterialGenerateAndProcessResponse,
     type MaterialGetDownloadURLResponse as MaterialGetDownloadURLResponse,
     type MaterialSearchResponse as MaterialSearchResponse,
     type MaterialCreateParams as MaterialCreateParams,
     type MaterialListParams as MaterialListParams,
     type MaterialBatchCreateParams as MaterialBatchCreateParams,
     type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams,
+    type MaterialGenerateAndProcessParams as MaterialGenerateAndProcessParams,
     type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams,
     type MaterialMoveParams as MaterialMoveParams,
     type MaterialRenameParams as MaterialRenameParams,
@@ -144,4 +152,6 @@ export declare namespace V1 {
     type AssignmentGraderGetAllResponse as AssignmentGraderGetAllResponse,
     type AssignmentGraderCreateParams as AssignmentGraderCreateParams,
   };
+
+  export { Chat as Chat, type ChatStreamParams as ChatStreamParams };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.27.0'; // x-release-please-version
+export const VERSION = '1.29.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.27.0";
+export declare const VERSION = "1.29.0";
 //# 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 = '1.27.0'; // x-release-please-version
+exports.VERSION = '1.29.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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