studyfetch-sdk 0.1.0a17__py3-none-any.whl → 0.1.0a18__py3-none-any.whl

studyfetch_sdk/resources/v1/materials/test.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
@@ -14,6 +14,10 @@ from ...._response import (
     async_to_streamed_response_wrapper,
 )
 from ...._base_client import make_request_options
+from ....types.v1.materials.test_perform_ocr_response import TestPerformOcrResponse
+from ....types.v1.materials.test_process_epub_response import TestProcessEpubResponse
+from ....types.v1.materials.test_process_image_response import TestProcessImageResponse
+from ....types.v1.materials.test_process_video_response import TestProcessVideoResponse
 
 __all__ = ["TestResource", "AsyncTestResource"]
 
@@ -49,14 +53,14 @@ class TestResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> TestPerformOcrResponse:
+        """Test OCR functionality with a sample PDF"""
         return self._post(
             "/api/v1/materials/test/ocr",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=TestPerformOcrResponse,
         )
 
     def process_epub(
@@ -68,14 +72,14 @@ class TestResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> TestProcessEpubResponse:
+        """Test EPUB processing functionality"""
         return self._post(
             "/api/v1/materials/test/epub-processing",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=TestProcessEpubResponse,
         )
 
     def process_image(
@@ -87,14 +91,14 @@ class TestResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> TestProcessImageResponse:
+        """Test image processing with OCR and AI vision"""
         return self._post(
             "/api/v1/materials/test/image-processing",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=TestProcessImageResponse,
         )
 
     def process_video(
@@ -106,14 +110,14 @@ class TestResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> TestProcessVideoResponse:
+        """Test video processing setup and dependencies"""
         return self._post(
             "/api/v1/materials/test/video-processing",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=TestProcessVideoResponse,
         )
 
 
@@ -146,14 +150,14 @@ class AsyncTestResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> TestPerformOcrResponse:
+        """Test OCR functionality with a sample PDF"""
         return await self._post(
             "/api/v1/materials/test/ocr",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=TestPerformOcrResponse,
         )
 
     async def process_epub(
@@ -165,14 +169,14 @@ class AsyncTestResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> TestProcessEpubResponse:
+        """Test EPUB processing functionality"""
         return await self._post(
             "/api/v1/materials/test/epub-processing",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=TestProcessEpubResponse,
         )
 
     async def process_image(
@@ -184,14 +188,14 @@ class AsyncTestResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> TestProcessImageResponse:
+        """Test image processing with OCR and AI vision"""
         return await self._post(
             "/api/v1/materials/test/image-processing",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=TestProcessImageResponse,
         )
 
     async def process_video(
@@ -203,14 +207,14 @@ class AsyncTestResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> TestProcessVideoResponse:
+        """Test video processing setup and dependencies"""
         return await self._post(
             "/api/v1/materials/test/video-processing",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=TestProcessVideoResponse,
         )
 
 

studyfetch_sdk/resources/v1/materials/upload.py

@@ -6,7 +6,7 @@ from typing import Mapping, cast
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven, FileTypes
+from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven, FileTypes
 from ...._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -18,7 +18,13 @@ from ...._response import (
 )
 from ...._base_client import make_request_options
 from ....types.v1.material import Material
-from ....types.v1.materials import upload_upload_file_params, upload_upload_from_url_params
+from ....types.v1.materials import (
+    upload_upload_file_params,
+    upload_complete_upload_params,
+    upload_upload_from_url_params,
+    upload_create_presigned_url_params,
+)
+from ....types.v1.materials.upload_create_presigned_url_response import UploadCreatePresignedURLResponse
 
 __all__ = ["UploadResource", "AsyncUploadResource"]
 
@@ -46,39 +52,99 @@ class UploadResource(SyncAPIResource):
     def complete_upload(
         self,
         *,
+        material_id: str,
+        organization_id: str,
+        s3_key: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> Material:
+        """
+        Complete upload after using presigned URL
+
+        Args:
+          material_id: The ID of the material that was uploaded
+
+          organization_id: The ID of the organization
+
+          s3_key: The S3 key of the uploaded file
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         return self._post(
             "/api/v1/materials/upload/complete",
+            body=maybe_transform(
+                {
+                    "material_id": material_id,
+                    "organization_id": organization_id,
+                    "s3_key": s3_key,
+                },
+                upload_complete_upload_params.UploadCompleteUploadParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=Material,
         )
 
     def create_presigned_url(
         self,
         *,
+        content_type: str,
+        filename: str,
+        name: str,
+        folder_id: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> UploadCreatePresignedURLResponse:
+        """
+        Get presigned URL for direct S3 upload
+
+        Args:
+          content_type: MIME type of the file
+
+          filename: Filename to upload
+
+          name: Display name for the material
+
+          folder_id: Folder ID to place the material in
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         return self._post(
             "/api/v1/materials/upload/presigned-url",
+            body=maybe_transform(
+                {
+                    "content_type": content_type,
+                    "filename": filename,
+                    "name": name,
+                    "folder_id": folder_id,
+                },
+                upload_create_presigned_url_params.UploadCreatePresignedURLParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=UploadCreatePresignedURLResponse,
         )
 
     def upload_file(
@@ -203,39 +269,99 @@ class AsyncUploadResource(AsyncAPIResource):
     async def complete_upload(
         self,
         *,
+        material_id: str,
+        organization_id: str,
+        s3_key: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> Material:
+        """
+        Complete upload after using presigned URL
+
+        Args:
+          material_id: The ID of the material that was uploaded
+
+          organization_id: The ID of the organization
+
+          s3_key: The S3 key of the uploaded file
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         return await self._post(
             "/api/v1/materials/upload/complete",
+            body=await async_maybe_transform(
+                {
+                    "material_id": material_id,
+                    "organization_id": organization_id,
+                    "s3_key": s3_key,
+                },
+                upload_complete_upload_params.UploadCompleteUploadParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=Material,
         )
 
     async def create_presigned_url(
         self,
         *,
+        content_type: str,
+        filename: str,
+        name: str,
+        folder_id: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+    ) -> UploadCreatePresignedURLResponse:
+        """
+        Get presigned URL for direct S3 upload
+
+        Args:
+          content_type: MIME type of the file
+
+          filename: Filename to upload
+
+          name: Display name for the material
+
+          folder_id: Folder ID to place the material in
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         return await self._post(
             "/api/v1/materials/upload/presigned-url",
+            body=await async_maybe_transform(
+                {
+                    "content_type": content_type,
+                    "filename": filename,
+                    "name": name,
+                    "folder_id": folder_id,
+                },
+                upload_create_presigned_url_params.UploadCreatePresignedURLParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=UploadCreatePresignedURLResponse,
         )
 
     async def upload_file(

studyfetch_sdk/types/v1/__init__.py

@@ -13,11 +13,13 @@ from .embed_verify_params import EmbedVerifyParams as EmbedVerifyParams
 from .folder_create_params import FolderCreateParams as FolderCreateParams
 from .folder_update_params import FolderUpdateParams as FolderUpdateParams
 from .material_list_params import MaterialListParams as MaterialListParams
+from .material_move_params import MaterialMoveParams as MaterialMoveParams
 from .component_list_params import ComponentListParams as ComponentListParams
 from .flashcard_rate_params import FlashcardRateParams as FlashcardRateParams
 from .embed_get_theme_params import EmbedGetThemeParams as EmbedGetThemeParams
 from .material_create_params import MaterialCreateParams as MaterialCreateParams
 from .material_list_response import MaterialListResponse as MaterialListResponse
+from .material_rename_params import MaterialRenameParams as MaterialRenameParams
 from .material_search_params import MaterialSearchParams as MaterialSearchParams
 from .scenario_create_params import ScenarioCreateParams as ScenarioCreateParams
 from .scenario_update_params import ScenarioUpdateParams as ScenarioUpdateParams
@@ -27,17 +29,21 @@ from .component_create_params import ComponentCreateParams as ComponentCreatePar
 from .component_list_response import ComponentListResponse as ComponentListResponse
 from .component_update_params import ComponentUpdateParams as ComponentUpdateParams
 from .explainer_create_params import ExplainerCreateParams as ExplainerCreateParams
+from .material_debug_response import MaterialDebugResponse as MaterialDebugResponse
 from .chat_send_message_params import ChatSendMessageParams as ChatSendMessageParams
 from .flashcard_get_all_params import FlashcardGetAllParams as FlashcardGetAllParams
 from .flashcard_get_due_params import FlashcardGetDueParams as FlashcardGetDueParams
+from .material_search_response import MaterialSearchResponse as MaterialSearchResponse
 from .usage_get_summary_params import UsageGetSummaryParams as UsageGetSummaryParams
 from .usage_list_events_params import UsageListEventsParams as UsageListEventsParams
 from .test_submit_answer_params import TestSubmitAnswerParams as TestSubmitAnswerParams
 from .assignment_grader_response import AssignmentGraderResponse as AssignmentGraderResponse
 from .flashcard_get_stats_params import FlashcardGetStatsParams as FlashcardGetStatsParams
 from .flashcard_get_types_response import FlashcardGetTypesResponse as FlashcardGetTypesResponse
+from .material_batch_create_params import MaterialBatchCreateParams as MaterialBatchCreateParams
 from .scenario_submit_answer_params import ScenarioSubmitAnswerParams as ScenarioSubmitAnswerParams
 from .flashcard_batch_process_params import FlashcardBatchProcessParams as FlashcardBatchProcessParams
+from .material_batch_create_response import MaterialBatchCreateResponse as MaterialBatchCreateResponse
 from .assignment_grader_create_params import AssignmentGraderCreateParams as AssignmentGraderCreateParams
 from .component_generate_embed_params import ComponentGenerateEmbedParams as ComponentGenerateEmbedParams
 from .explainer_handle_webhook_params import ExplainerHandleWebhookParams as ExplainerHandleWebhookParams
@@ -46,3 +52,4 @@ from .flashcard_get_algorithm_response import FlashcardGetAlgorithmResponse as F
 from .material_get_download_url_params import MaterialGetDownloadURLParams as MaterialGetDownloadURLParams
 from .component_generate_embed_response import ComponentGenerateEmbedResponse as ComponentGenerateEmbedResponse
 from .assignment_grader_get_all_response import AssignmentGraderGetAllResponse as AssignmentGraderGetAllResponse
+from .material_get_download_url_response import MaterialGetDownloadURLResponse as MaterialGetDownloadURLResponse

studyfetch_sdk/types/v1/material_batch_create_params.py

@@ -0,0 +1,29 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["MaterialBatchCreateParams", "Material"]
+
+
+class MaterialBatchCreateParams(TypedDict, total=False):
+    materials: Required[Iterable[Material]]
+    """Array of materials to create"""
+
+
+class Material(TypedDict, total=False):
+    content_type: Required[Annotated[str, PropertyInfo(alias="contentType")]]
+    """MIME type"""
+
+    filename: Required[str]
+    """Filename"""
+
+    name: Required[str]
+    """Material name"""
+
+    folder_id: Annotated[str, PropertyInfo(alias="folderId")]
+    """Folder ID"""

studyfetch_sdk/types/v1/material_batch_create_response.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["MaterialBatchCreateResponse", "MaterialBatchCreateResponseItem"]
+
+
+class MaterialBatchCreateResponseItem(BaseModel):
+    material_id: str = FieldInfo(alias="materialId")
+    """Material ID"""
+
+    name: str
+    """Material name"""
+
+    s3_key: str = FieldInfo(alias="s3Key")
+    """S3 key"""
+
+    upload_url: str = FieldInfo(alias="uploadUrl")
+    """Presigned upload URL"""
+
+
+MaterialBatchCreateResponse: TypeAlias = List[MaterialBatchCreateResponseItem]

studyfetch_sdk/types/v1/material_debug_response.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["MaterialDebugResponse", "Image"]
+
+
+class Image(BaseModel):
+    id: Optional[str] = None
+
+    description: Optional[str] = None
+
+    page_index: Optional[float] = FieldInfo(alias="pageIndex", default=None)
+
+    s3_key: Optional[str] = FieldInfo(alias="s3Key", default=None)
+
+    s3_url: Optional[str] = FieldInfo(alias="s3Url", default=None)
+
+
+class MaterialDebugResponse(BaseModel):
+    content: object
+    """Content details"""
+
+    content_type: str = FieldInfo(alias="contentType")
+    """Content type"""
+
+    images: List[Image]
+    """Processed images"""
+
+    material_id: str = FieldInfo(alias="materialId")
+    """Material ID"""
+
+    metadata: object
+    """Material metadata"""
+
+    name: str
+    """Material name"""
+
+    status: str
+    """Processing status"""
+
+    transcript_structure: Optional[object] = FieldInfo(alias="transcriptStructure", default=None)
+    """Transcript structure for videos"""

studyfetch_sdk/types/v1/material_get_download_url_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, Annotated, TypedDict
+from typing_extensions import Annotated, TypedDict
 
 from ..._utils import PropertyInfo
 
@@ -10,4 +10,5 @@ __all__ = ["MaterialGetDownloadURLParams"]
 
 
 class MaterialGetDownloadURLParams(TypedDict, total=False):
-    expires_in: Required[Annotated[str, PropertyInfo(alias="expiresIn")]]
+    expires_in: Annotated[float, PropertyInfo(alias="expiresIn")]
+    """URL expiration time in seconds (default: 3600)"""

studyfetch_sdk/types/v1/material_get_download_url_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["MaterialGetDownloadURLResponse"]
+
+
+class MaterialGetDownloadURLResponse(BaseModel):
+    download_url: str = FieldInfo(alias="downloadUrl")
+    """Temporary download URL"""

studyfetch_sdk/types/v1/material_move_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["MaterialMoveParams"]
+
+
+class MaterialMoveParams(TypedDict, total=False):
+    folder_id: Required[Annotated[Optional[str], PropertyInfo(alias="folderId")]]
+    """Target folder ID (null for root)"""

studyfetch_sdk/types/v1/material_rename_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["MaterialRenameParams"]
+
+
+class MaterialRenameParams(TypedDict, total=False):
+    name: Required[str]
+    """New name for the material"""

studyfetch_sdk/types/v1/material_search_params.py

@@ -15,13 +15,10 @@ class MaterialSearchParams(TypedDict, total=False):
     """Search query"""
 
     folder_ids: Annotated[List[str], PropertyInfo(alias="folderIds")]
-    """
-    Optional: Limit search to materials within specific folders (includes
-    subfolders)
-    """
+    """Limit search to materials within specific folders (includes subfolders)"""
 
     material_ids: Annotated[List[str], PropertyInfo(alias="materialIds")]
-    """Optional: Limit search to specific material IDs"""
+    """Limit search to specific material IDs"""
 
     top_k: Annotated[float, PropertyInfo(alias="topK")]
-    """Number of results to return (default: 5)"""
+    """Number of results to return"""