@studyfetch/sdk 1.25.0 → 1.26.0

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

@@ -68,6 +68,29 @@ export class Upload extends APIResource {
     );
   }
 
+  /**
+   * Uploads a file and waits for processing to finish before returning. Useful for
+   * synchronous API usage.
+   *
+   * @example
+   * ```ts
+   * const material =
+   *   await client.v1.materials.upload.uploadFileAndProcess({
+   *     file: fs.createReadStream('path/to/file'),
+   *     name: 'name',
+   *   });
+   * ```
+   */
+  uploadFileAndProcess(
+    body: UploadUploadFileAndProcessParams,
+    options?: RequestOptions,
+  ): APIPromise<MaterialsAPI.Material> {
+    return this._client.post(
+      '/api/v1/materials/upload/file-and-process',
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+
   /**
    * Upload material from URL
    *
@@ -86,6 +109,43 @@ export class Upload extends APIResource {
   ): APIPromise<MaterialsAPI.Material> {
     return this._client.post('/api/v1/materials/upload/url', { body, ...options });
   }
+
+  /**
+   * Fetches content from URL and waits for processing to finish before returning.
+   * Useful for synchronous API usage.
+   *
+   * @example
+   * ```ts
+   * const material =
+   *   await client.v1.materials.upload.uploadURLAndProcess({
+   *     name: 'My Document',
+   *     url: 'https://example.com/document.pdf',
+   *   });
+   * ```
+   */
+  uploadURLAndProcess(
+    body: UploadUploadURLAndProcessParams,
+    options?: RequestOptions,
+  ): APIPromise<MaterialsAPI.Material> {
+    return this._client.post('/api/v1/materials/upload/url-and-process', { body, ...options });
+  }
+}
+
+export interface Complete {
+  /**
+   * The ID of the material that was uploaded
+   */
+  materialId: string;
+
+  /**
+   * The ID of the organization
+   */
+  organizationId: string;
+
+  /**
+   * The S3 key of the uploaded file
+   */
+  s3Key: string;
 }
 
 export interface UploadCreatePresignedURLResponse {
@@ -158,6 +218,30 @@ export interface UploadUploadFileParams {
   folderId?: string;
 }
 
+export interface UploadUploadFileAndProcessParams {
+  file: Uploadable;
+
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * Folder ID (optional)
+   */
+  folderId?: string;
+
+  /**
+   * Polling interval in milliseconds (default: 2000)
+   */
+  pollIntervalMs?: number;
+
+  /**
+   * Processing timeout in milliseconds (default: 300000)
+   */
+  timeoutMs?: number;
+}
+
 export interface UploadUploadFromURLParams {
   /**
    * Material name
@@ -175,12 +259,42 @@ export interface UploadUploadFromURLParams {
   folderId?: string;
 }
 
+export interface UploadUploadURLAndProcessParams {
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * URL to fetch content from
+   */
+  url: string;
+
+  /**
+   * Folder ID (optional)
+   */
+  folderId?: string;
+
+  /**
+   * Polling interval in milliseconds (default: 2 seconds)
+   */
+  pollIntervalMs?: number;
+
+  /**
+   * Maximum time to wait for processing in milliseconds (default: 5 minutes)
+   */
+  timeoutMs?: number;
+}
+
 export declare namespace Upload {
   export {
+    type Complete as Complete,
     type UploadCreatePresignedURLResponse as UploadCreatePresignedURLResponse,
     type UploadCompleteUploadParams as UploadCompleteUploadParams,
     type UploadCreatePresignedURLParams as UploadCreatePresignedURLParams,
     type UploadUploadFileParams as UploadUploadFileParams,
+    type UploadUploadFileAndProcessParams as UploadUploadFileAndProcessParams,
     type UploadUploadFromURLParams as UploadUploadFromURLParams,
+    type UploadUploadURLAndProcessParams as UploadUploadURLAndProcessParams,
   };
 }

package/src/resources/v1/usage/analyst.ts

@@ -7,33 +7,38 @@ import { RequestOptions } from '../../../internal/request-options';
 
 export class Analyst extends APIResource {
   /**
-   * Get test results for users and groups in JWT
+   * Get test results with full question data for user or group
    *
    * @example
    * ```ts
    * await client.v1.usage.analyst.getTestQuestions();
    * ```
    */
-  getTestQuestions(options?: RequestOptions): APIPromise<void> {
+  getTestQuestions(
+    query: AnalystGetTestQuestionsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
     return this._client.get('/api/v1/usage-analyst/test-questions', {
+      query,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
   /**
-   * Get chat messages for users and groups in JWT
+   * Get all chat messages from sessions for user or group
    *
    * @example
    * ```ts
-   * await client.v1.usage.analyst.listChatMessages();
+   * const response =
+   *   await client.v1.usage.analyst.listChatMessages();
    * ```
    */
-  listChatMessages(options?: RequestOptions): APIPromise<void> {
-    return this._client.get('/api/v1/usage-analyst/chat-messages', {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  listChatMessages(
+    query: AnalystListChatMessagesParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AnalystListChatMessagesResponse> {
+    return this._client.get('/api/v1/usage-analyst/chat-messages', { query, ...options });
   }
 
   /**
@@ -57,6 +62,56 @@ export class Analyst extends APIResource {
   }
 }
 
+export interface AnalystListChatMessagesResponse {
+  messages?: Array<AnalystListChatMessagesResponse.Message>;
+
+  sessionCount?: number;
+
+  total?: number;
+}
+
+export namespace AnalystListChatMessagesResponse {
+  export interface Message {
+    componentId?: string;
+
+    content?: string;
+
+    createdAt?: string;
+
+    metadata?: unknown;
+
+    role?: 'user' | 'assistant' | 'system';
+
+    sessionId?: string;
+
+    userId?: string;
+  }
+}
+
+export interface AnalystGetTestQuestionsParams {
+  /**
+   * Array of group IDs to filter
+   */
+  groupIds?: Array<string>;
+
+  /**
+   * User ID to get test results for
+   */
+  userId?: string;
+}
+
+export interface AnalystListChatMessagesParams {
+  /**
+   * Array of group IDs to filter
+   */
+  groupIds?: Array<string>;
+
+  /**
+   * User ID to get chat messages for
+   */
+  userId?: string;
+}
+
 export interface AnalystListEventsParams {
   /**
    * End date for filtering (ISO 8601)
@@ -95,8 +150,23 @@ export interface AnalystListEventsParams {
    * Start date for filtering (ISO 8601)
    */
   startDate: string;
+
+  /**
+   * Array of group IDs to filter
+   */
+  groupIds?: Array<string>;
+
+  /**
+   * Array of user IDs to filter
+   */
+  userIds?: Array<string>;
 }
 
 export declare namespace Analyst {
-  export { type AnalystListEventsParams as AnalystListEventsParams };
+  export {
+    type AnalystListChatMessagesResponse as AnalystListChatMessagesResponse,
+    type AnalystGetTestQuestionsParams as AnalystGetTestQuestionsParams,
+    type AnalystListChatMessagesParams as AnalystListChatMessagesParams,
+    type AnalystListEventsParams as AnalystListEventsParams,
+  };
 }

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

@@ -1,6 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Analyst, type AnalystListEventsParams } from './analyst';
+export {
+  Analyst,
+  type AnalystListChatMessagesResponse,
+  type AnalystGetTestQuestionsParams,
+  type AnalystListChatMessagesParams,
+  type AnalystListEventsParams,
+} from './analyst';
 export {
   Usage,
   type UsageGetStatsParams,

package/src/resources/v1/usage/usage.ts

@@ -2,7 +2,13 @@
 
 import { APIResource } from '../../../core/resource';
 import * as AnalystAPI from './analyst';
-import { Analyst, AnalystListEventsParams } from './analyst';
+import {
+  Analyst,
+  AnalystGetTestQuestionsParams,
+  AnalystListChatMessagesParams,
+  AnalystListChatMessagesResponse,
+  AnalystListEventsParams,
+} from './analyst';
 import { APIPromise } from '../../../core/api-promise';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
@@ -184,5 +190,11 @@ export declare namespace Usage {
     type UsageListEventsParams as UsageListEventsParams,
   };
 
-  export { Analyst as Analyst, type AnalystListEventsParams as AnalystListEventsParams };
+  export {
+    Analyst as Analyst,
+    type AnalystListChatMessagesResponse as AnalystListChatMessagesResponse,
+    type AnalystGetTestQuestionsParams as AnalystGetTestQuestionsParams,
+    type AnalystListChatMessagesParams as AnalystListChatMessagesParams,
+    type AnalystListEventsParams as AnalystListEventsParams,
+  };
 }

package/src/resources/v1/v1.ts

@@ -42,14 +42,29 @@ import {
   AudioRecaps,
 } from './audio-recaps/audio-recaps';
 import * as ChatAPI from './chat/chat';
-import { Chat, ChatGetSessionParams, ChatSendMessageParams, ChatStreamParams } from './chat/chat';
+import {
+  Chat,
+  ChatGetSessionParams,
+  ChatSendMessageParams,
+  ChatStreamParams,
+  Interaction,
+} from './chat/chat';
+import * as DataAnalystAPI from './data-analyst/data-analyst';
+import {
+  DataAnalyst,
+  DataAnalystRetrieveSessionParams,
+  DataAnalystSendMessageParams,
+  DataAnalystStreamParams,
+} from './data-analyst/data-analyst';
 import * as EmbedAPI from './embed/embed';
 import { Embed, EmbedGetThemeParams, EmbedVerifyParams } from './embed/embed';
 import * as MaterialsAPI from './materials/materials';
 import {
+  Content,
   Material,
   MaterialBatchCreateParams,
   MaterialBatchCreateResponse,
+  MaterialCreateAndProcessParams,
   MaterialCreateParams,
   MaterialDebugResponse,
   MaterialGetDownloadURLParams,
@@ -83,6 +98,9 @@ import * as UploadAPI from './upload/upload';
 import { Upload } from './upload/upload';
 import * as UsageAPI from './usage/usage';
 import { Usage, UsageGetStatsParams, UsageGetSummaryParams, UsageListEventsParams } from './usage/usage';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
 
 export class V1 extends APIResource {
   materials: MaterialsAPI.Materials = new MaterialsAPI.Materials(this._client);
@@ -100,6 +118,22 @@ export class V1 extends APIResource {
   assignmentGrader: AssignmentGraderAPI.AssignmentGrader = new AssignmentGraderAPI.AssignmentGrader(
     this._client,
   );
+  dataAnalyst: DataAnalystAPI.DataAnalyst = new DataAnalystAPI.DataAnalyst(this._client);
+
+  /**
+   * Test MongoDB connection and get outbound IP
+   *
+   * @example
+   * ```ts
+   * await client.v1.testMongoDB();
+   * ```
+   */
+  testMongoDB(options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/api/v1/test-mongodb', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 V1.Materials = Materials;
@@ -115,10 +149,12 @@ V1.Scenarios = Scenarios;
 V1.Explainers = Explainers;
 V1.Upload = Upload;
 V1.AssignmentGrader = AssignmentGrader;
+V1.DataAnalyst = DataAnalyst;
 
 export declare namespace V1 {
   export {
     Materials as Materials,
+    type Content as Content,
     type Material as Material,
     type MaterialListResponse as MaterialListResponse,
     type MaterialBatchCreateResponse as MaterialBatchCreateResponse,
@@ -128,6 +164,7 @@ export declare namespace V1 {
     type MaterialCreateParams as MaterialCreateParams,
     type MaterialListParams as MaterialListParams,
     type MaterialBatchCreateParams as MaterialBatchCreateParams,
+    type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams,
     type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams,
     type MaterialMoveParams as MaterialMoveParams,
     type MaterialRenameParams as MaterialRenameParams,
@@ -167,6 +204,7 @@ export declare namespace V1 {
 
   export {
     Chat as Chat,
+    type Interaction as Interaction,
     type ChatGetSessionParams as ChatGetSessionParams,
     type ChatSendMessageParams as ChatSendMessageParams,
     type ChatStreamParams as ChatStreamParams,
@@ -221,4 +259,11 @@ export declare namespace V1 {
     type AssignmentGraderGetAllResponse as AssignmentGraderGetAllResponse,
     type AssignmentGraderCreateParams as AssignmentGraderCreateParams,
   };
+
+  export {
+    DataAnalyst as DataAnalyst,
+    type DataAnalystRetrieveSessionParams as DataAnalystRetrieveSessionParams,
+    type DataAnalystSendMessageParams as DataAnalystSendMessageParams,
+    type DataAnalystStreamParams as DataAnalystStreamParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.25.0'; // x-release-please-version
+export const VERSION = '1.26.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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