@studyfetch/sdk 1.35.0 → 1.37.0

package/src/resources/v1/folders.ts

@@ -1,6 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as FoldersAPI from './folders';
+import * as MaterialsAPI from './materials/materials';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -97,8 +99,12 @@ export class Folders extends APIResource {
    * );
    * ```
    */
-  listMaterials(id: string, options?: RequestOptions): APIPromise<FolderListMaterialsResponse> {
-    return this._client.get(path`/api/v1/folders/${id}/materials`, options);
+  listMaterials(
+    id: string,
+    query: FolderListMaterialsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<FolderListMaterialsResponse> {
+    return this._client.get(path`/api/v1/folders/${id}/materials`, { query, ...options });
   }
 
   /**
@@ -116,6 +122,33 @@ export class Folders extends APIResource {
   }
 }
 
+export interface FolderMetadata {
+  /**
+   * Folder color
+   */
+  color?: string;
+
+  /**
+   * Folder icon
+   */
+  icon?: string;
+
+  /**
+   * Last activity date
+   */
+  lastActivity?: string;
+
+  /**
+   * Number of materials in folder
+   */
+  materialCount?: number;
+
+  /**
+   * Total size of materials in folder
+   */
+  totalSize?: number;
+}
+
 export interface FolderCreateResponse {
   /**
    * Folder ID
@@ -155,7 +188,7 @@ export interface FolderCreateResponse {
   /**
    * Folder metadata
    */
-  metadata?: FolderCreateResponse.Metadata;
+  metadata?: FolderMetadata;
 
   /**
    * Parent folder ID
@@ -163,38 +196,6 @@ export interface FolderCreateResponse {
   parentFolderId?: string | null;
 }
 
-export namespace FolderCreateResponse {
-  /**
-   * Folder metadata
-   */
-  export interface Metadata {
-    /**
-     * Folder color
-     */
-    color?: string;
-
-    /**
-     * Folder icon
-     */
-    icon?: string;
-
-    /**
-     * Last activity date
-     */
-    lastActivity?: string;
-
-    /**
-     * Number of materials in folder
-     */
-    materialCount?: number;
-
-    /**
-     * Total size of materials in folder
-     */
-    totalSize?: number;
-  }
-}
-
 export interface FolderRetrieveResponse {
   /**
    * Folder ID
@@ -206,11 +207,6 @@ export interface FolderRetrieveResponse {
    */
   materialCount: number;
 
-  /**
-   * Materials in this folder
-   */
-  materials: Array<unknown>;
-
   /**
    * Folder name
    */
@@ -231,11 +227,6 @@ export interface FolderRetrieveResponse {
    */
   subfolders: Array<unknown>;
 
-  /**
-   * Total size of all materials in bytes
-   */
-  totalSize: number;
-
   /**
    * Creation date
    */
@@ -249,7 +240,7 @@ export interface FolderRetrieveResponse {
   /**
    * Folder metadata
    */
-  metadata?: FolderRetrieveResponse.Metadata;
+  metadata?: FolderMetadata;
 
   /**
    * Parent folder ID
@@ -262,38 +253,6 @@ export interface FolderRetrieveResponse {
   updatedAt?: unknown;
 }
 
-export namespace FolderRetrieveResponse {
-  /**
-   * Folder metadata
-   */
-  export interface Metadata {
-    /**
-     * Folder color
-     */
-    color?: string;
-
-    /**
-     * Folder icon
-     */
-    icon?: string;
-
-    /**
-     * Last activity date
-     */
-    lastActivity?: string;
-
-    /**
-     * Number of materials in folder
-     */
-    materialCount?: number;
-
-    /**
-     * Total size of materials in folder
-     */
-    totalSize?: number;
-  }
-}
-
 export interface FolderUpdateResponse {
   /**
    * Folder ID
@@ -333,7 +292,7 @@ export interface FolderUpdateResponse {
   /**
    * Folder metadata
    */
-  metadata?: FolderUpdateResponse.Metadata;
+  metadata?: FolderMetadata;
 
   /**
    * Parent folder ID
@@ -341,38 +300,6 @@ export interface FolderUpdateResponse {
   parentFolderId?: string | null;
 }
 
-export namespace FolderUpdateResponse {
-  /**
-   * Folder metadata
-   */
-  export interface Metadata {
-    /**
-     * Folder color
-     */
-    color?: string;
-
-    /**
-     * Folder icon
-     */
-    icon?: string;
-
-    /**
-     * Last activity date
-     */
-    lastActivity?: string;
-
-    /**
-     * Number of materials in folder
-     */
-    materialCount?: number;
-
-    /**
-     * Total size of materials in folder
-     */
-    totalSize?: number;
-  }
-}
-
 export type FolderListResponse = Array<FolderListResponse.FolderListResponseItem>;
 
 export namespace FolderListResponse {
@@ -415,45 +342,13 @@ export namespace FolderListResponse {
     /**
      * Folder metadata
      */
-    metadata?: FolderListResponseItem.Metadata;
+    metadata?: FoldersAPI.FolderMetadata;
 
     /**
      * Parent folder ID
      */
     parentFolderId?: string | null;
   }
-
-  export namespace FolderListResponseItem {
-    /**
-     * Folder metadata
-     */
-    export interface Metadata {
-      /**
-       * Folder color
-       */
-      color?: string;
-
-      /**
-       * Folder icon
-       */
-      icon?: string;
-
-      /**
-       * Last activity date
-       */
-      lastActivity?: string;
-
-      /**
-       * Number of materials in folder
-       */
-      materialCount?: number;
-
-      /**
-       * Total size of materials in folder
-       */
-      totalSize?: number;
-    }
-  }
 }
 
 export type FolderGetTreeResponse = Array<FolderGetTreeResponse.FolderGetTreeResponseItem>;
@@ -498,7 +393,7 @@ export namespace FolderGetTreeResponse {
     /**
      * Folder metadata
      */
-    metadata?: FolderGetTreeResponseItem.Metadata;
+    metadata?: FoldersAPI.FolderMetadata;
 
     /**
      * Parent folder ID
@@ -510,120 +405,16 @@ export namespace FolderGetTreeResponse {
      */
     updatedAt?: unknown;
   }
-
-  export namespace FolderGetTreeResponseItem {
-    /**
-     * Folder metadata
-     */
-    export interface Metadata {
-      /**
-       * Folder color
-       */
-      color?: string;
-
-      /**
-       * Folder icon
-       */
-      icon?: string;
-
-      /**
-       * Last activity date
-       */
-      lastActivity?: string;
-
-      /**
-       * Number of materials in folder
-       */
-      materialCount?: number;
-
-      /**
-       * Total size of materials in folder
-       */
-      totalSize?: number;
-    }
-  }
 }
 
-export type FolderListMaterialsResponse = Array<FolderListMaterialsResponse.FolderListMaterialsResponseItem>;
-
-export namespace FolderListMaterialsResponse {
-  export interface FolderListMaterialsResponseItem {
-    /**
-     * Material ID
-     */
-    _id: string;
-
-    /**
-     * Material content
-     */
-    content: FolderListMaterialsResponseItem.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;
-
-    /**
-     * Material metadata
-     */
-    metadata?: unknown;
-
-    /**
-     * Usage information
-     */
-    usage?: unknown;
-  }
-
-  export namespace FolderListMaterialsResponseItem {
-    /**
-     * Material content
-     */
-    export interface Content {
-      filename?: string;
-
-      fileSize?: number;
+export interface FolderListMaterialsResponse {
+  materials?: Array<MaterialsAPI.MaterialResponse>;
 
-      mimeType?: string;
+  page?: number;
 
-      s3Key?: string;
+  totalCount?: number;
 
-      s3Url?: string;
-
-      text?: string;
-
-      url?: string;
-    }
-  }
+  totalPages?: number;
 }
 
 export interface FolderMoveResponse {
@@ -665,7 +456,7 @@ export interface FolderMoveResponse {
   /**
    * Folder metadata
    */
-  metadata?: FolderMoveResponse.Metadata;
+  metadata?: FolderMetadata;
 
   /**
    * Parent folder ID
@@ -673,38 +464,6 @@ export interface FolderMoveResponse {
   parentFolderId?: string | null;
 }
 
-export namespace FolderMoveResponse {
-  /**
-   * Folder metadata
-   */
-  export interface Metadata {
-    /**
-     * Folder color
-     */
-    color?: string;
-
-    /**
-     * Folder icon
-     */
-    icon?: string;
-
-    /**
-     * Last activity date
-     */
-    lastActivity?: string;
-
-    /**
-     * Number of materials in folder
-     */
-    materialCount?: number;
-
-    /**
-     * Total size of materials in folder
-     */
-    totalSize?: number;
-  }
-}
-
 export interface FolderCreateParams {
   /**
    * Folder name
@@ -742,13 +501,35 @@ export interface FolderUpdateParams {
    * New folder name
    */
   name?: string;
+
+  /**
+   * New parent folder ID
+   */
+  parentFolderId?: string;
 }
 
 export interface FolderListParams {
   /**
    * Filter by parent folder
    */
-  parentId?: unknown;
+  parentFolderId?: string;
+}
+
+export interface FolderListMaterialsParams {
+  /**
+   * Number of items per page (default: 20, max: 200)
+   */
+  limit?: string;
+
+  /**
+   * Page number (default: 1)
+   */
+  page?: string;
+
+  /**
+   * Search materials by name
+   */
+  search?: string;
 }
 
 export interface FolderMoveParams {
@@ -760,6 +541,7 @@ export interface FolderMoveParams {
 
 export declare namespace Folders {
   export {
+    type FolderMetadata as FolderMetadata,
     type FolderCreateResponse as FolderCreateResponse,
     type FolderRetrieveResponse as FolderRetrieveResponse,
     type FolderUpdateResponse as FolderUpdateResponse,
@@ -770,6 +552,7 @@ export declare namespace Folders {
     type FolderCreateParams as FolderCreateParams,
     type FolderUpdateParams as FolderUpdateParams,
     type FolderListParams as FolderListParams,
+    type FolderListMaterialsParams as FolderListMaterialsParams,
     type FolderMoveParams as FolderMoveParams,
   };
 }

package/src/resources/v1/index.ts

@@ -2,26 +2,23 @@
 
 export {
   AssignmentGrader,
+  type AssignmentGraderResponse,
   type AssignmentGraderCreateResponse,
   type AssignmentGraderGetAllResponse,
-  type AssignmentGraderGetByIDResponse,
   type AssignmentGraderCreateParams,
 } from './assignment-grader/index';
 export { Chat, type ChatStreamParams } from './chat';
 export {
   ChatAnalytics,
-  type ChatAnalyticAnalyzeResponse,
+  type ChatAnalyticsResponse,
   type ChatAnalyticExportResponse,
-  type ChatAnalyticGetComponentResponse,
   type ChatAnalyticAnalyzeParams,
   type ChatAnalyticExportParams,
   type ChatAnalyticGetComponentParams,
 } from './chat-analytics';
 export {
   Components,
-  type ComponentCreateResponse,
-  type ComponentRetrieveResponse,
-  type ComponentUpdateResponse,
+  type ComponentResponse,
   type ComponentListResponse,
   type ComponentGenerateEmbedResponse,
   type ComponentCreateParams,
@@ -32,6 +29,7 @@ export {
 export { Embed, type EmbedGetThemeParams, type EmbedVerifyParams } from './embed/index';
 export {
   Folders,
+  type FolderMetadata,
   type FolderCreateResponse,
   type FolderRetrieveResponse,
   type FolderUpdateResponse,
@@ -42,22 +40,18 @@ export {
   type FolderCreateParams,
   type FolderUpdateParams,
   type FolderListParams,
+  type FolderListMaterialsParams,
   type FolderMoveParams,
 } from './folders';
 export {
   Materials,
-  type MaterialCreateResponse,
-  type MaterialRetrieveResponse,
+  type Content,
+  type GeneratedMaterialResponse,
+  type MaterialResponse,
   type MaterialListResponse,
-  type MaterialCreateAndProcessResponse,
   type MaterialCreateBatchUploadURLsResponse,
-  type MaterialGenerateResponse,
-  type MaterialGenerateAndProcessResponse,
   type MaterialGetDebugInfoResponse,
   type MaterialGetDownloadURLResponse,
-  type MaterialMoveResponse,
-  type MaterialRenameResponse,
-  type MaterialReprocessResponse,
   type MaterialSearchResponse,
   type MaterialCreateParams,
   type MaterialListParams,

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

@@ -3,18 +3,13 @@
 export { Bulk, type BulkMoveResponse, type BulkMoveParams } from './bulk';
 export {
   Materials,
-  type MaterialCreateResponse,
-  type MaterialRetrieveResponse,
+  type Content,
+  type GeneratedMaterialResponse,
+  type MaterialResponse,
   type MaterialListResponse,
-  type MaterialCreateAndProcessResponse,
   type MaterialCreateBatchUploadURLsResponse,
-  type MaterialGenerateResponse,
-  type MaterialGenerateAndProcessResponse,
   type MaterialGetDebugInfoResponse,
   type MaterialGetDownloadURLResponse,
-  type MaterialMoveResponse,
-  type MaterialRenameResponse,
-  type MaterialReprocessResponse,
   type MaterialSearchResponse,
   type MaterialCreateParams,
   type MaterialListParams,
@@ -27,21 +22,9 @@ export {
   type MaterialRenameParams,
   type MaterialSearchParams,
 } from './materials';
-export {
-  Test,
-  type TestTestEpubProcessingResponse,
-  type TestTestImageProcessingResponse,
-  type TestTestOcrResponse,
-  type TestTestVideoProcessingResponse,
-} from './test';
 export {
   Upload,
-  type UploadCompleteUploadResponse,
   type UploadGetPresignedURLResponse,
-  type UploadUploadFileResponse,
-  type UploadUploadFileAndProcessResponse,
-  type UploadUploadFromURLResponse,
-  type UploadUploadFromURLAndProcessResponse,
   type UploadCompleteUploadParams,
   type UploadGetPresignedURLParams,
   type UploadUploadFileParams,