@studyfetch/sdk 0.1.0-alpha.1

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

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as ComponentAPI from './component';
+import { Component } from './component';
+
+export class Upload extends APIResource {
+  component: ComponentAPI.Component = new ComponentAPI.Component(this._client);
+}
+
+Upload.Component = Component;
+
+export declare namespace Upload {
+  export { Component as Component };
+}

package/src/resources/v1/upload.ts

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

package/src/resources/v1/usage.ts

@@ -0,0 +1,475 @@
+// 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 Usage extends APIResource {
+  /**
+   * Get usage statistics
+   *
+   * @example
+   * ```ts
+   * await client.v1.usage.getStats();
+   * ```
+   */
+  getStats(query: UsageGetStatsParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/api/v1/usage/stats', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get usage summary
+   *
+   * @example
+   * ```ts
+   * await client.v1.usage.getSummary({
+   *   endDate: 'endDate',
+   *   period: 'hourly',
+   *   startDate: 'startDate',
+   * });
+   * ```
+   */
+  getSummary(query: UsageGetSummaryParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/api/v1/usage/summary', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get usage events
+   *
+   * @example
+   * ```ts
+   * await client.v1.usage.listEvents();
+   * ```
+   */
+  listEvents(
+    query: UsageListEventsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.get('/api/v1/usage/events', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Track chat usage
+   *
+   * @example
+   * ```ts
+   * await client.v1.usage.trackChat({
+   *   inputTokens: 0,
+   *   model: 'openai:gpt-4.1',
+   *   outputTokens: 0,
+   *   sessionId: 'sessionId',
+   * });
+   * ```
+   */
+  trackChat(body: UsageTrackChatParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/usage/chat', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Track general usage event
+   *
+   * @example
+   * ```ts
+   * await client.v1.usage.trackEvent({
+   *   eventType: 'material_created',
+   * });
+   * ```
+   */
+  trackEvent(body: UsageTrackEventParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/usage/track', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Track performance metrics
+   *
+   * @example
+   * ```ts
+   * await client.v1.usage.trackPerformance();
+   * ```
+   */
+  trackPerformance(body: UsageTrackPerformanceParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/usage/performance', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface UsageGetStatsParams {
+  /**
+   * End date for stats (ISO 8601)
+   */
+  endDate?: string;
+
+  /**
+   * Filter by group ID
+   */
+  groupId?: string;
+
+  /**
+   * Start date for stats (ISO 8601)
+   */
+  startDate?: string;
+
+  /**
+   * Filter by user ID
+   */
+  userId?: string;
+}
+
+export interface UsageGetSummaryParams {
+  /**
+   * End date for summary (ISO 8601)
+   */
+  endDate: string;
+
+  /**
+   * Summary period
+   */
+  period: 'hourly' | 'daily' | 'monthly';
+
+  /**
+   * Start date for summary (ISO 8601)
+   */
+  startDate: string;
+
+  /**
+   * Group results by
+   */
+  groupBy?: 'user' | 'group' | 'model' | 'endpoint';
+}
+
+export interface UsageListEventsParams {
+  /**
+   * End date for filtering (ISO 8601)
+   */
+  endDate?: string;
+
+  /**
+   * Filter by event type
+   */
+  eventType?:
+    | 'material_created'
+    | 'material_uploaded'
+    | 'material_processed'
+    | 'material_deleted'
+    | 'component_created'
+    | 'component_accessed'
+    | 'component_deleted'
+    | 'component_usage'
+    | 'chat_message_sent'
+    | 'chat_session_started'
+    | 'chat_session_ended'
+    | 'test_created'
+    | 'test_started'
+    | 'test_completed'
+    | 'test_question_answered'
+    | 'test_retaken'
+    | 'audio_recap_create'
+    | 'api_call'
+    | 'cache_hit'
+    | 'sso_login'
+    | 'sso_logout'
+    | 'student_performance';
+
+  /**
+   * Filter by group ID
+   */
+  groupId?: string;
+
+  /**
+   * Number of results to return
+   */
+  limit?: number;
+
+  /**
+   * Offset for pagination
+   */
+  offset?: number;
+
+  /**
+   * Filter by resource ID
+   */
+  resourceId?: string;
+
+  /**
+   * Start date for filtering (ISO 8601)
+   */
+  startDate?: string;
+
+  /**
+   * Filter by user ID
+   */
+  userId?: string;
+}
+
+export interface UsageTrackChatParams {
+  /**
+   * Number of input tokens
+   */
+  inputTokens: number;
+
+  /**
+   * AI model used
+   */
+  model:
+    | 'openai:gpt-4.1'
+    | 'openai:gpt-4o'
+    | 'openai:gpt-4o-mini'
+    | 'openai:gpt-4'
+    | 'openai:gpt-3.5-turbo'
+    | 'openai:o1'
+    | 'openai:o1-mini'
+    | 'openai:o3-mini'
+    | 'anthropic:claude-3-opus'
+    | 'anthropic:claude-3-sonnet'
+    | 'anthropic:claude-3-haiku'
+    | 'google:gemini-pro'
+    | 'meta:llama-3';
+
+  /**
+   * Number of output tokens
+   */
+  outputTokens: number;
+
+  /**
+   * Chat session ID
+   */
+  sessionId: string;
+
+  /**
+   * Component ID
+   */
+  componentId?: string;
+
+  /**
+   * Group ID
+   */
+  groupId?: string;
+
+  /**
+   * Additional metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * Number of reasoning tokens
+   */
+  reasoningTokens?: number;
+
+  /**
+   * User ID
+   */
+  userId?: string;
+}
+
+export interface UsageTrackEventParams {
+  /**
+   * Type of usage event
+   */
+  eventType:
+    | 'material_created'
+    | 'material_uploaded'
+    | 'material_processed'
+    | 'material_deleted'
+    | 'component_created'
+    | 'component_accessed'
+    | 'component_deleted'
+    | 'component_usage'
+    | 'chat_message_sent'
+    | 'chat_session_started'
+    | 'chat_session_ended'
+    | 'test_created'
+    | 'test_started'
+    | 'test_completed'
+    | 'test_question_answered'
+    | 'test_retaken'
+    | 'audio_recap_create'
+    | 'api_call'
+    | 'cache_hit'
+    | 'sso_login'
+    | 'sso_logout'
+    | 'student_performance';
+
+  /**
+   * Whether response was served from cache
+   */
+  cacheHit?: boolean;
+
+  /**
+   * Component name
+   */
+  componentName?: string;
+
+  /**
+   * Component type
+   */
+  componentType?: string;
+
+  /**
+   * Size of content in bytes
+   */
+  contentSize?: number;
+
+  /**
+   * API endpoint accessed
+   */
+  endpoint?: string;
+
+  /**
+   * File size in bytes
+   */
+  fileSize?: number;
+
+  /**
+   * File MIME type
+   */
+  fileType?: string;
+
+  /**
+   * Group ID for collaborative sessions
+   */
+  groupId?: string;
+
+  /**
+   * Number of input tokens
+   */
+  inputTokens?: number;
+
+  /**
+   * Client IP address
+   */
+  ipAddress?: string;
+
+  /**
+   * Additional metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * HTTP method used
+   */
+  method?: string;
+
+  /**
+   * AI model used
+   */
+  model?:
+    | 'openai:gpt-4.1'
+    | 'openai:gpt-4o'
+    | 'openai:gpt-4o-mini'
+    | 'openai:gpt-4'
+    | 'openai:gpt-3.5-turbo'
+    | 'openai:o1'
+    | 'openai:o1-mini'
+    | 'openai:o3-mini'
+    | 'anthropic:claude-3-opus'
+    | 'anthropic:claude-3-sonnet'
+    | 'anthropic:claude-3-haiku'
+    | 'google:gemini-pro'
+    | 'meta:llama-3';
+
+  /**
+   * Number of output tokens
+   */
+  outputTokens?: number;
+
+  /**
+   * Performance metrics data
+   */
+  performanceData?: unknown;
+
+  /**
+   * Number of reasoning tokens
+   */
+  reasoningTokens?: number;
+
+  /**
+   * Resource ID being accessed
+   */
+  resourceId?: string;
+
+  /**
+   * Type of resource
+   */
+  resourceType?: string;
+
+  /**
+   * Response time in milliseconds
+   */
+  responseTime?: number;
+
+  /**
+   * Session ID
+   */
+  sessionId?: string;
+
+  /**
+   * HTTP status code
+   */
+  statusCode?: number;
+
+  /**
+   * Total number of tokens
+   */
+  totalTokens?: number;
+
+  /**
+   * Client user agent
+   */
+  userAgent?: string;
+
+  /**
+   * User ID
+   */
+  userId?: string;
+}
+
+export interface UsageTrackPerformanceParams {
+  componentId?: string;
+
+  metrics?: UsageTrackPerformanceParams.Metrics;
+}
+
+export namespace UsageTrackPerformanceParams {
+  export interface Metrics {
+    interactionTime?: number;
+
+    loadTime?: number;
+
+    renderTime?: number;
+  }
+}
+
+export declare namespace Usage {
+  export {
+    type UsageGetStatsParams as UsageGetStatsParams,
+    type UsageGetSummaryParams as UsageGetSummaryParams,
+    type UsageListEventsParams as UsageListEventsParams,
+    type UsageTrackChatParams as UsageTrackChatParams,
+    type UsageTrackEventParams as UsageTrackEventParams,
+    type UsageTrackPerformanceParams as UsageTrackPerformanceParams,
+  };
+}

package/src/resources/v1/v1.ts

@@ -0,0 +1,211 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ComponentsAPI from './components';
+import {
+  ComponentCreateParams,
+  ComponentEmbedParams,
+  ComponentListParams,
+  ComponentUpdateParams,
+  Components,
+} from './components';
+import * as ExplainersAPI from './explainers';
+import { ExplainerCreateParams, ExplainerHandleWebhookParams, Explainers } from './explainers';
+import * as FlashcardsAPI from './flashcards';
+import {
+  FlashcardBatchProcessParams,
+  FlashcardBatchProcessResponse,
+  FlashcardGetAlgorithmInfoResponse,
+  FlashcardGetAllParams,
+  FlashcardGetDueParams,
+  FlashcardGetStatsParams,
+  FlashcardGetTypesResponse,
+  FlashcardRateParams,
+  Flashcards,
+} from './flashcards';
+import * as FoldersAPI from './folders';
+import { FolderCreateParams, FolderListParams, FolderUpdateParams, Folders } from './folders';
+import * as UsageAPI from './usage';
+import {
+  Usage,
+  UsageGetStatsParams,
+  UsageGetSummaryParams,
+  UsageListEventsParams,
+  UsageTrackChatParams,
+  UsageTrackEventParams,
+  UsageTrackPerformanceParams,
+} from './usage';
+import * as AdminAPI from './admin/admin';
+import { Admin } from './admin/admin';
+import * as AudioRecapsAPI from './audio-recaps/audio-recaps';
+import {
+  AudioRecapAskQuestionParams,
+  AudioRecapCreateParams,
+  AudioRecaps,
+} from './audio-recaps/audio-recaps';
+import * as AuthAPI from './auth/auth';
+import {
+  Auth,
+  AuthRegisterNewUserParams,
+  AuthRegisterWithInviteParams,
+  AuthRequestPasswordResetParams,
+  AuthResetPasswordParams,
+} from './auth/auth';
+import * as ChatAPI from './chat/chat';
+import { Chat, ChatRetrieveSessionParams, ChatSendMessageParams, ChatStreamParams } from './chat/chat';
+import * as EmbedAPI from './embed/embed';
+import { Embed, EmbedGetThemeParams, EmbedVerifyParams } from './embed/embed';
+import * as MaterialsAPI from './materials/materials';
+import {
+  MaterialCreateParams,
+  MaterialGetDownloadURLParams,
+  MaterialListParams,
+  Materials,
+} from './materials/materials';
+import * as OrganizationsAPI from './organizations/organizations';
+import { OrganizationUpdateParams, Organizations } from './organizations/organizations';
+import * as ScenariosAPI from './scenarios/scenarios';
+import { ScenarioCreateParams, ScenarioUpdateParams, Scenarios } from './scenarios/scenarios';
+import * as TestsAPI from './tests/tests';
+import {
+  TestCreateParams,
+  TestRetakeParams,
+  TestSubmitAnswerParams,
+  TestSubmitParams,
+  Tests,
+} from './tests/tests';
+import * as UploadAPI from './upload/upload';
+import { Upload } from './upload/upload';
+
+export class V1 extends APIResource {
+  auth: AuthAPI.Auth = new AuthAPI.Auth(this._client);
+  organizations: OrganizationsAPI.Organizations = new OrganizationsAPI.Organizations(this._client);
+  materials: MaterialsAPI.Materials = new MaterialsAPI.Materials(this._client);
+  usage: UsageAPI.Usage = new UsageAPI.Usage(this._client);
+  folders: FoldersAPI.Folders = new FoldersAPI.Folders(this._client);
+  components: ComponentsAPI.Components = new ComponentsAPI.Components(this._client);
+  embed: EmbedAPI.Embed = new EmbedAPI.Embed(this._client);
+  chat: ChatAPI.Chat = new ChatAPI.Chat(this._client);
+  flashcards: FlashcardsAPI.Flashcards = new FlashcardsAPI.Flashcards(this._client);
+  tests: TestsAPI.Tests = new TestsAPI.Tests(this._client);
+  audioRecaps: AudioRecapsAPI.AudioRecaps = new AudioRecapsAPI.AudioRecaps(this._client);
+  scenarios: ScenariosAPI.Scenarios = new ScenariosAPI.Scenarios(this._client);
+  explainers: ExplainersAPI.Explainers = new ExplainersAPI.Explainers(this._client);
+  upload: UploadAPI.Upload = new UploadAPI.Upload(this._client);
+  admin: AdminAPI.Admin = new AdminAPI.Admin(this._client);
+}
+
+V1.Auth = Auth;
+V1.Organizations = Organizations;
+V1.Materials = Materials;
+V1.Usage = Usage;
+V1.Folders = Folders;
+V1.Components = Components;
+V1.Embed = Embed;
+V1.Chat = Chat;
+V1.Flashcards = Flashcards;
+V1.Tests = Tests;
+V1.AudioRecaps = AudioRecaps;
+V1.Scenarios = Scenarios;
+V1.Explainers = Explainers;
+V1.Upload = Upload;
+V1.Admin = Admin;
+
+export declare namespace V1 {
+  export {
+    Auth as Auth,
+    type AuthRegisterNewUserParams as AuthRegisterNewUserParams,
+    type AuthRegisterWithInviteParams as AuthRegisterWithInviteParams,
+    type AuthRequestPasswordResetParams as AuthRequestPasswordResetParams,
+    type AuthResetPasswordParams as AuthResetPasswordParams,
+  };
+
+  export { Organizations as Organizations, type OrganizationUpdateParams as OrganizationUpdateParams };
+
+  export {
+    Materials as Materials,
+    type MaterialCreateParams as MaterialCreateParams,
+    type MaterialListParams as MaterialListParams,
+    type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams,
+  };
+
+  export {
+    Usage as Usage,
+    type UsageGetStatsParams as UsageGetStatsParams,
+    type UsageGetSummaryParams as UsageGetSummaryParams,
+    type UsageListEventsParams as UsageListEventsParams,
+    type UsageTrackChatParams as UsageTrackChatParams,
+    type UsageTrackEventParams as UsageTrackEventParams,
+    type UsageTrackPerformanceParams as UsageTrackPerformanceParams,
+  };
+
+  export {
+    Folders as Folders,
+    type FolderCreateParams as FolderCreateParams,
+    type FolderUpdateParams as FolderUpdateParams,
+    type FolderListParams as FolderListParams,
+  };
+
+  export {
+    Components as Components,
+    type ComponentCreateParams as ComponentCreateParams,
+    type ComponentUpdateParams as ComponentUpdateParams,
+    type ComponentListParams as ComponentListParams,
+    type ComponentEmbedParams as ComponentEmbedParams,
+  };
+
+  export {
+    Embed as Embed,
+    type EmbedGetThemeParams as EmbedGetThemeParams,
+    type EmbedVerifyParams as EmbedVerifyParams,
+  };
+
+  export {
+    Chat as Chat,
+    type ChatRetrieveSessionParams as ChatRetrieveSessionParams,
+    type ChatSendMessageParams as ChatSendMessageParams,
+    type ChatStreamParams as ChatStreamParams,
+  };
+
+  export {
+    Flashcards as Flashcards,
+    type FlashcardBatchProcessResponse as FlashcardBatchProcessResponse,
+    type FlashcardGetAlgorithmInfoResponse as FlashcardGetAlgorithmInfoResponse,
+    type FlashcardGetTypesResponse as FlashcardGetTypesResponse,
+    type FlashcardBatchProcessParams as FlashcardBatchProcessParams,
+    type FlashcardGetAllParams as FlashcardGetAllParams,
+    type FlashcardGetDueParams as FlashcardGetDueParams,
+    type FlashcardGetStatsParams as FlashcardGetStatsParams,
+    type FlashcardRateParams as FlashcardRateParams,
+  };
+
+  export {
+    Tests as Tests,
+    type TestCreateParams as TestCreateParams,
+    type TestRetakeParams as TestRetakeParams,
+    type TestSubmitParams as TestSubmitParams,
+    type TestSubmitAnswerParams as TestSubmitAnswerParams,
+  };
+
+  export {
+    AudioRecaps as AudioRecaps,
+    type AudioRecapCreateParams as AudioRecapCreateParams,
+    type AudioRecapAskQuestionParams as AudioRecapAskQuestionParams,
+  };
+
+  export {
+    Scenarios as Scenarios,
+    type ScenarioCreateParams as ScenarioCreateParams,
+    type ScenarioUpdateParams as ScenarioUpdateParams,
+  };
+
+  export {
+    Explainers as Explainers,
+    type ExplainerCreateParams as ExplainerCreateParams,
+    type ExplainerHandleWebhookParams as ExplainerHandleWebhookParams,
+  };
+
+  export { Upload as Upload };
+
+  export { Admin as Admin };
+}

package/src/resources/v1.ts

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

package/src/resources.ts

@@ -0,0 +1 @@
+export * from './resources/index';