@studyfetch/sdk 1.23.0 → 1.25.0

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

@@ -4,35 +4,49 @@ import { APIResource } from '../../../core/resource';
 import * as MaterialsAPI from './materials';
 import { APIPromise } from '../../../core/api-promise';
 import { type Uploadable } from '../../../core/uploads';
-import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { multipartFormRequestOptions } from '../../../internal/uploads';
 
 export class Upload extends APIResource {
   /**
+   * Complete upload after using presigned URL
+   *
    * @example
    * ```ts
-   * await client.v1.materials.upload.completeUpload();
+   * const material =
+   *   await client.v1.materials.upload.completeUpload({
+   *     materialId: '507f1f77bcf86cd799439013',
+   *     organizationId: '507f1f77bcf86cd799439011',
+   *     s3Key:
+   *       'organizations/507f1f77bcf86cd799439011/materials/document.pdf',
+   *   });
    * ```
    */
-  completeUpload(options?: RequestOptions): APIPromise<void> {
-    return this._client.post('/api/v1/materials/upload/complete', {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  completeUpload(
+    body: UploadCompleteUploadParams,
+    options?: RequestOptions,
+  ): APIPromise<MaterialsAPI.Material> {
+    return this._client.post('/api/v1/materials/upload/complete', { body, ...options });
   }
 
   /**
+   * Get presigned URL for direct S3 upload
+   *
    * @example
    * ```ts
-   * await client.v1.materials.upload.createPresignedURL();
+   * const response =
+   *   await client.v1.materials.upload.createPresignedURL({
+   *     contentType: 'application/pdf',
+   *     filename: 'document.pdf',
+   *     name: 'Chapter 1 Notes',
+   *   });
    * ```
    */
-  createPresignedURL(options?: RequestOptions): APIPromise<void> {
-    return this._client.post('/api/v1/materials/upload/presigned-url', {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  createPresignedURL(
+    body: UploadCreatePresignedURLParams,
+    options?: RequestOptions,
+  ): APIPromise<UploadCreatePresignedURLResponse> {
+    return this._client.post('/api/v1/materials/upload/presigned-url', { body, ...options });
   }
 
   /**
@@ -74,6 +88,62 @@ export class Upload extends APIResource {
   }
 }
 
+export interface UploadCreatePresignedURLResponse {
+  /**
+   * Material ID to use for completion
+   */
+  materialId: string;
+
+  /**
+   * S3 key for the file
+   */
+  s3Key: string;
+
+  /**
+   * Presigned URL for direct S3 upload
+   */
+  uploadUrl: string;
+}
+
+export interface UploadCompleteUploadParams {
+  /**
+   * 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 UploadCreatePresignedURLParams {
+  /**
+   * MIME type of the file
+   */
+  contentType: string;
+
+  /**
+   * Filename to upload
+   */
+  filename: string;
+
+  /**
+   * Display name for the material
+   */
+  name: string;
+
+  /**
+   * Folder ID to place the material in
+   */
+  folderId?: string;
+}
+
 export interface UploadUploadFileParams {
   file: Uploadable;
 
@@ -107,6 +177,9 @@ export interface UploadUploadFromURLParams {
 
 export declare namespace Upload {
   export {
+    type UploadCreatePresignedURLResponse as UploadCreatePresignedURLResponse,
+    type UploadCompleteUploadParams as UploadCompleteUploadParams,
+    type UploadCreatePresignedURLParams as UploadCreatePresignedURLParams,
     type UploadUploadFileParams as UploadUploadFileParams,
     type UploadUploadFromURLParams as UploadUploadFromURLParams,
   };

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

@@ -66,7 +66,7 @@ export class Component extends APIResource {
    *
    * @example
    * ```ts
-   * const response =
+   * const fileUploadResponse =
    *   await client.v1.upload.component.uploadFile(
    *     'componentId',
    *     {
@@ -81,7 +81,7 @@ export class Component extends APIResource {
     componentID: string,
     body: ComponentUploadFileParams,
     options?: RequestOptions,
-  ): APIPromise<ComponentUploadFileResponse> {
+  ): APIPromise<FileUploadResponse> {
     return this._client.post(
       path`/api/v1/upload/component/${componentID}/file`,
       multipartFormRequestOptions({ body, ...options }, this._client),
@@ -93,56 +93,28 @@ export class Component extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.v1.upload.component.uploadURL(
-   *   'componentId',
-   *   {
-   *     folderId: '507f1f77bcf86cd799439012',
-   *     name: 'my-document.pdf',
-   *     organizationId: '507f1f77bcf86cd799439011',
-   *     url: 'https://example.com/document.pdf',
-   *   },
-   * );
+   * const fileUploadResponse =
+   *   await client.v1.upload.component.uploadURL(
+   *     'componentId',
+   *     {
+   *       folderId: '507f1f77bcf86cd799439012',
+   *       name: 'my-document.pdf',
+   *       organizationId: '507f1f77bcf86cd799439011',
+   *       url: 'https://example.com/document.pdf',
+   *     },
+   *   );
    * ```
    */
   uploadURL(
     componentID: string,
     body: ComponentUploadURLParams,
     options?: RequestOptions,
-  ): APIPromise<ComponentUploadURLResponse> {
+  ): APIPromise<FileUploadResponse> {
     return this._client.post(path`/api/v1/upload/component/${componentID}/url`, { body, ...options });
   }
 }
 
-export interface ComponentCompleteUploadResponse {
-  /**
-   * The ID of the uploaded material
-   */
-  id: string;
-
-  /**
-   * The name of the material
-   */
-  name: string;
-
-  /**
-   * The status of the material
-   */
-  status: string;
-}
-
-export interface ComponentGetPresignedURLResponse {
-  /**
-   * The S3 key for the file
-   */
-  key: string;
-
-  /**
-   * The presigned URL for uploading
-   */
-  uploadUrl: string;
-}
-
-export interface ComponentUploadFileResponse {
+export interface FileUploadResponse {
   /**
    * The ID of the uploaded material
    */
@@ -169,31 +141,33 @@ export interface ComponentUploadFileResponse {
   status: string;
 }
 
-export interface ComponentUploadURLResponse {
+export interface ComponentCompleteUploadResponse {
   /**
    * The ID of the uploaded material
    */
   id: string;
 
   /**
-   * The content type of the material
+   * The name of the material
    */
-  contentType: string;
+  name: string;
 
   /**
-   * The name of the material
+   * The status of the material
    */
-  name: string;
+  status: string;
+}
 
+export interface ComponentGetPresignedURLResponse {
   /**
-   * The S3 key of the uploaded file
+   * The S3 key for the file
    */
-  s3Key: string;
+  key: string;
 
   /**
-   * The status of the material
+   * The presigned URL for uploading
    */
-  status: string;
+  uploadUrl: string;
 }
 
 export interface ComponentCompleteUploadParams {
@@ -276,10 +250,9 @@ export interface ComponentUploadURLParams {
 
 export declare namespace Component {
   export {
+    type FileUploadResponse as FileUploadResponse,
     type ComponentCompleteUploadResponse as ComponentCompleteUploadResponse,
     type ComponentGetPresignedURLResponse as ComponentGetPresignedURLResponse,
-    type ComponentUploadFileResponse as ComponentUploadFileResponse,
-    type ComponentUploadURLResponse as ComponentUploadURLResponse,
     type ComponentCompleteUploadParams as ComponentCompleteUploadParams,
     type ComponentGetPresignedURLParams as ComponentGetPresignedURLParams,
     type ComponentUploadFileParams as ComponentUploadFileParams,

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

@@ -2,10 +2,9 @@
 
 export {
   Component,
+  type FileUploadResponse,
   type ComponentCompleteUploadResponse,
   type ComponentGetPresignedURLResponse,
-  type ComponentUploadFileResponse,
-  type ComponentUploadURLResponse,
   type ComponentCompleteUploadParams,
   type ComponentGetPresignedURLParams,
   type ComponentUploadFileParams,

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

@@ -9,9 +9,8 @@ import {
   ComponentGetPresignedURLParams,
   ComponentGetPresignedURLResponse,
   ComponentUploadFileParams,
-  ComponentUploadFileResponse,
   ComponentUploadURLParams,
-  ComponentUploadURLResponse,
+  FileUploadResponse,
 } from './component';
 
 export class Upload extends APIResource {
@@ -23,10 +22,9 @@ Upload.Component = Component;
 export declare namespace Upload {
   export {
     Component as Component,
+    type FileUploadResponse as FileUploadResponse,
     type ComponentCompleteUploadResponse as ComponentCompleteUploadResponse,
     type ComponentGetPresignedURLResponse as ComponentGetPresignedURLResponse,
-    type ComponentUploadFileResponse as ComponentUploadFileResponse,
-    type ComponentUploadURLResponse as ComponentUploadURLResponse,
     type ComponentCompleteUploadParams as ComponentCompleteUploadParams,
     type ComponentGetPresignedURLParams as ComponentGetPresignedURLParams,
     type ComponentUploadFileParams as ComponentUploadFileParams,

package/src/resources/v1/v1.ts

@@ -48,11 +48,18 @@ import { Embed, EmbedGetThemeParams, EmbedVerifyParams } from './embed/embed';
 import * as MaterialsAPI from './materials/materials';
 import {
   Material,
+  MaterialBatchCreateParams,
+  MaterialBatchCreateResponse,
   MaterialCreateParams,
+  MaterialDebugResponse,
   MaterialGetDownloadURLParams,
+  MaterialGetDownloadURLResponse,
   MaterialListParams,
   MaterialListResponse,
+  MaterialMoveParams,
+  MaterialRenameParams,
   MaterialSearchParams,
+  MaterialSearchResponse,
   Materials,
 } from './materials/materials';
 import * as ScenariosAPI from './scenarios/scenarios';
@@ -114,9 +121,16 @@ export declare namespace V1 {
     Materials as Materials,
     type Material as Material,
     type MaterialListResponse as MaterialListResponse,
+    type MaterialBatchCreateResponse as MaterialBatchCreateResponse,
+    type MaterialDebugResponse as MaterialDebugResponse,
+    type MaterialGetDownloadURLResponse as MaterialGetDownloadURLResponse,
+    type MaterialSearchResponse as MaterialSearchResponse,
     type MaterialCreateParams as MaterialCreateParams,
     type MaterialListParams as MaterialListParams,
+    type MaterialBatchCreateParams as MaterialBatchCreateParams,
     type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams,
+    type MaterialMoveParams as MaterialMoveParams,
+    type MaterialRenameParams as MaterialRenameParams,
     type MaterialSearchParams as MaterialSearchParams,
   };
 

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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