@studyfetch/sdk 0.1.0-alpha.1

package/src/resources/v1/chat/chat.ts

@@ -0,0 +1,233 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as SessionsAPI from './sessions';
+import { SessionRetrieveParams, Sessions } from './sessions';
+import * as TestAPI from './test';
+import { Test } from './test';
+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 Chat extends APIResource {
+  sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
+  test: TestAPI.Test = new TestAPI.Test(this._client);
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.chat.getHistory();
+   * ```
+   */
+  getHistory(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/chat/history', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.chat.retrieveSession('sessionId', {
+   *   userId: 'userId',
+   * });
+   * ```
+   */
+  retrieveSession(
+    sessionID: string,
+    query: ChatRetrieveSessionParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.get(path`/api/v1/chat/session/${sessionID}`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.chat.sendFollowups();
+   * ```
+   */
+  sendFollowups(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/chat/followups', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.chat.sendMessage({
+   *   componentId: 'componentId',
+   *   message: {},
+   *   'x-component-id': 'x-component-id',
+   * });
+   * ```
+   */
+  sendMessage(params: ChatSendMessageParams, options?: RequestOptions): APIPromise<void> {
+    const { 'x-component-id': xComponentID, ...body } = params;
+    return this._client.post('/api/v1/chat/message', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*', 'x-component-id': xComponentID }, options?.headers]),
+    });
+  }
+
+  /**
+   * Stream chat responses
+   *
+   * @example
+   * ```ts
+   * await client.v1.chat.stream();
+   * ```
+   */
+  stream(params: ChatStreamParams, options?: RequestOptions): APIPromise<void> {
+    const { 'x-component-id': xComponentID, ...body } = params;
+    return this._client.post('/api/v1/chat/stream', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*', ...(xComponentID != null ? { 'x-component-id': xComponentID } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface ChatRetrieveSessionParams {
+  userId: string;
+}
+
+export interface ChatSendMessageParams {
+  /**
+   * Body param: Component ID for context
+   */
+  componentId: string;
+
+  /**
+   * Body param: Chat message content
+   */
+  message: ChatSendMessageParams.Message;
+
+  /**
+   * Header param:
+   */
+  'x-component-id': string;
+
+  /**
+   * Body param: Additional context data
+   */
+  context?: unknown;
+
+  /**
+   * Body param: Group ID for collaboration
+   */
+  groupId?: string;
+
+  /**
+   * Body param: Session ID for conversation continuity
+   */
+  sessionId?: string;
+
+  /**
+   * Body param: User ID for tracking
+   */
+  userId?: string;
+}
+
+export namespace ChatSendMessageParams {
+  /**
+   * Chat message content
+   */
+  export interface Message {
+    /**
+     * Images attached to the message
+     */
+    images?: Array<Message.Image>;
+
+    /**
+     * Text content of the message
+     */
+    text?: string;
+  }
+
+  export namespace Message {
+    export interface Image {
+      /**
+       * Base64 encoded image data
+       */
+      base64?: string;
+
+      /**
+       * Caption for the image
+       */
+      caption?: string;
+
+      /**
+       * MIME type of the image
+       */
+      mimeType?: string;
+
+      /**
+       * URL of the image
+       */
+      url?: string;
+    }
+  }
+}
+
+export interface ChatStreamParams {
+  /**
+   * Body param:
+   */
+  context?: unknown;
+
+  /**
+   * Body param:
+   */
+  groupId?: string;
+
+  /**
+   * Body param:
+   */
+  messages?: Array<ChatStreamParams.Message>;
+
+  /**
+   * Body param:
+   */
+  userId?: string;
+
+  /**
+   * Header param: Component ID for context
+   */
+  'x-component-id'?: string;
+}
+
+export namespace ChatStreamParams {
+  export interface Message {
+    content?: string;
+
+    role?: 'user' | 'assistant' | 'system';
+  }
+}
+
+Chat.Sessions = Sessions;
+Chat.Test = Test;
+
+export declare namespace Chat {
+  export {
+    type ChatRetrieveSessionParams as ChatRetrieveSessionParams,
+    type ChatSendMessageParams as ChatSendMessageParams,
+    type ChatStreamParams as ChatStreamParams,
+  };
+
+  export { Sessions as Sessions, type SessionRetrieveParams as SessionRetrieveParams };
+
+  export { Test as Test };
+}

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

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Chat,
+  type ChatRetrieveSessionParams,
+  type ChatSendMessageParams,
+  type ChatStreamParams,
+} from './chat';
+export { Sessions, type SessionRetrieveParams } from './sessions';
+export { Test } from './test';

package/src/resources/v1/chat/sessions.ts

@@ -0,0 +1,46 @@
+// 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 Sessions extends APIResource {
+  /**
+   * @example
+   * ```ts
+   * await client.v1.chat.sessions.create();
+   * ```
+   */
+  create(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/chat/sessions/create', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.chat.sessions.retrieve('userId', {
+   *   limit: 'limit',
+   * });
+   * ```
+   */
+  retrieve(userID: string, query: SessionRetrieveParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/api/v1/chat/sessions/${userID}`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface SessionRetrieveParams {
+  limit: string;
+}
+
+export declare namespace Sessions {
+  export { type SessionRetrieveParams as SessionRetrieveParams };
+}

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

@@ -0,0 +1,34 @@
+// 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.chat.test.citeImage();
+   * ```
+   */
+  citeImage(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/chat/test/image-citation', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.chat.test.uploadImage();
+   * ```
+   */
+  uploadImage(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/chat/test/image', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}

package/src/resources/v1/chat.ts

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

package/src/resources/v1/components.ts

@@ -0,0 +1,372 @@
+// 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 Components extends APIResource {
+  /**
+   * Create a new component
+   *
+   * @example
+   * ```ts
+   * await client.v1.components.create({
+   *   config: {},
+   *   name: 'My Study Component',
+   *   origin: 'chat',
+   *   type: 'chat',
+   * });
+   * ```
+   */
+  create(body: ComponentCreateParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/components', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get component by ID
+   *
+   * @example
+   * ```ts
+   * await client.v1.components.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/api/v1/components/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Update component
+   *
+   * @example
+   * ```ts
+   * await client.v1.components.update('id');
+   * ```
+   */
+  update(id: string, body: ComponentUpdateParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.patch(path`/api/v1/components/${id}`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Get all components
+   *
+   * @example
+   * ```ts
+   * await client.v1.components.list();
+   * ```
+   */
+  list(query: ComponentListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/api/v1/components', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Delete component
+   *
+   * @example
+   * ```ts
+   * await client.v1.components.delete('id');
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/api/v1/components/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.components.activate('id');
+   * ```
+   */
+  activate(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/api/v1/components/${id}/activate`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.components.deactivate('id');
+   * ```
+   */
+  deactivate(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/api/v1/components/${id}/deactivate`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Generate embed code for component
+   *
+   * @example
+   * ```ts
+   * await client.v1.components.embed('id');
+   * ```
+   */
+  embed(id: string, body: ComponentEmbedParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/api/v1/components/${id}/embed`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.components.interact('id');
+   * ```
+   */
+  interact(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/api/v1/components/${id}/interact`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface ComponentCreateParams {
+  /**
+   * Component-specific configuration
+   */
+  config: unknown;
+
+  /**
+   * Name of the component
+   */
+  name: string;
+
+  /**
+   * Origin of the component
+   */
+  origin: 'chat' | 'classroom' | 'upload' | 'console' | 'api';
+
+  /**
+   * Type of component to create
+   */
+  type:
+    | 'chat'
+    | 'flashcards'
+    | 'scenarios'
+    | 'practice_test'
+    | 'audio_recap'
+    | 'tutor_me'
+    | 'explainers'
+    | 'uploads';
+
+  /**
+   * Component description
+   */
+  description?: string;
+
+  /**
+   * Additional metadata
+   */
+  metadata?: unknown;
+}
+
+export interface ComponentUpdateParams {
+  /**
+   * Component status
+   */
+  status?: 'draft' | 'active' | 'inactive' | 'processing' | 'error';
+}
+
+export interface ComponentListParams {
+  /**
+   * Filter by component type
+   */
+  type?:
+    | 'chat'
+    | 'flashcards'
+    | 'scenarios'
+    | 'practice_test'
+    | 'audio_recap'
+    | 'tutor_me'
+    | 'explainers'
+    | 'uploads';
+}
+
+export interface ComponentEmbedParams {
+  /**
+   * Token expiry time in hours
+   */
+  expiryHours?: number;
+
+  /**
+   * Feature toggles
+   */
+  features?: ComponentEmbedParams.Features;
+
+  /**
+   * Group ID for collaboration
+   */
+  groupId?: string;
+
+  /**
+   * Embed height (e.g., "400px", "100vh")
+   */
+  height?: string;
+
+  /**
+   * Session ID for continuity
+   */
+  sessionId?: string;
+
+  /**
+   * Theme customization
+   */
+  theme?: ComponentEmbedParams.Theme;
+
+  /**
+   * User ID for tracking
+   */
+  userId?: string;
+
+  /**
+   * Embed width (e.g., "100%", "600px")
+   */
+  width?: string;
+}
+
+export namespace ComponentEmbedParams {
+  /**
+   * Feature toggles
+   */
+  export interface Features {
+    /**
+     * Enable component creation
+     */
+    enableComponentCreation?: boolean;
+
+    /**
+     * Enable follow-up questions
+     */
+    enableFollowUps?: boolean;
+
+    /**
+     * Enable history
+     */
+    enableHistory?: boolean;
+
+    /**
+     * Enable image sources
+     */
+    enableImageSources?: boolean;
+
+    /**
+     * Enable outline
+     */
+    enableOutline?: boolean;
+
+    /**
+     * Enable transcript
+     */
+    enableTranscript?: boolean;
+
+    /**
+     * Enable voice input
+     */
+    enableVoice?: boolean;
+
+    /**
+     * Enable web search
+     */
+    enableWebSearch?: boolean;
+
+    /**
+     * Enable web search sources
+     */
+    enableWebSearchSources?: boolean;
+
+    /**
+     * Placeholder text
+     */
+    placeholderText?: string;
+  }
+
+  /**
+   * Theme customization
+   */
+  export interface Theme {
+    /**
+     * Background color (hex)
+     */
+    backgroundColor?: string;
+
+    /**
+     * Border radius
+     */
+    borderRadius?: string;
+
+    /**
+     * Font family
+     */
+    fontFamily?: string;
+
+    /**
+     * Font size
+     */
+    fontSize?: string;
+
+    /**
+     * Hide branding
+     */
+    hideBranding?: boolean;
+
+    /**
+     * Logo URL
+     */
+    logoUrl?: string;
+
+    /**
+     * Padding
+     */
+    padding?: string;
+
+    /**
+     * Primary color (hex)
+     */
+    primaryColor?: string;
+
+    /**
+     * Secondary color (hex)
+     */
+    secondaryColor?: string;
+
+    /**
+     * Text color (hex)
+     */
+    textColor?: string;
+  }
+}
+
+export declare namespace Components {
+  export {
+    type ComponentCreateParams as ComponentCreateParams,
+    type ComponentUpdateParams as ComponentUpdateParams,
+    type ComponentListParams as ComponentListParams,
+    type ComponentEmbedParams as ComponentEmbedParams,
+  };
+}