unique_sdk 0.10.15__py3-none-any.whl → 0.10.17__py3-none-any.whl

unique_sdk/api_resources/_content.py

@@ -1,8 +1,18 @@
 from enum import Enum
-from typing import Any, ClassVar, Dict, List, Literal, Optional, TypedDict, cast
+from typing import (
+    Any,
+    ClassVar,
+    Dict,
+    List,
+    Literal,
+    Optional,
+    TypedDict,
+    cast,
+)
 
 from typing_extensions import NotRequired, Unpack
 
+import unique_sdk
 from unique_sdk._api_resource import APIResource
 from unique_sdk._request_options import RequestOptions
 
@@ -75,6 +85,7 @@ class Content(APIResource["Content"]):
         metadataFilter: dict
         skip: NotRequired[int]
         take: NotRequired[int]
+        filePath: NotRequired[str]
 
     class CustomApiOptions(TypedDict):
         apiIdentifier: str
@@ -117,6 +128,13 @@ class Content(APIResource["Content"]):
         storeInternally: bool
         fileUrl: Optional[str]
 
+    class UpdateParams(RequestOptions):
+        contentId: str | None = None
+        filePath: str | None = None
+        ownerId: str | None = None
+        parentFolderPath: str | None = None
+        title: str | None = None
+
     class Chunk(TypedDict):
         id: str
         text: str
@@ -148,6 +166,14 @@ class Content(APIResource["Content"]):
         contentInfos: List["Content.ContentInfo"]
         totalCount: int
 
+    class DeleteParams(RequestOptions):
+        contentId: NotRequired[str]
+        filePath: NotRequired[str]
+        chatId: NotRequired[str]
+
+    class DeleteResponse(TypedDict):
+        id: str
+
     id: str
     key: str
     url: Optional[str]
@@ -372,3 +398,163 @@ class Content(APIResource["Content"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def update(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Content.UpdateParams"],
+    ) -> "Content.ContentInfo":
+        content_id = cls.resolve_content_id_from_file_path(
+            user_id,
+            company_id,
+            params.get("contentId"),
+            params.get("filePath"),
+        )
+        owner_id = unique_sdk.Folder.resolve_scope_id_from_folder_path(
+            user_id,
+            company_id,
+            params.get("ownerId"),
+            params.get("parentFolderPath"),
+        )
+        params.pop("contentId", None)
+        params.pop("filePath", None)
+        params.pop("parentFolderPath", None)
+        params["ownerId"] = owner_id
+
+        return cast(
+            "Content.ContentInfo",
+            cls._static_request(
+                "patch",
+                f"/content/{content_id}",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def update_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Content.UpdateParams"],
+    ) -> "Content.ContentInfo":
+        content_id = cls.resolve_content_id_from_file_path(
+            user_id,
+            company_id,
+            params.get("contentId"),
+            params.get("filePath"),
+        )
+        owner_id = unique_sdk.Folder.resolve_scope_id_from_folder_path(
+            user_id,
+            company_id,
+            params.get("ownerId"),
+            params.get("parentFolderPath"),
+        )
+        params.pop("contentId", None)
+        params.pop("filePath", None)
+        params.pop("parentFolderPath", None)
+        params["ownerId"] = owner_id
+
+        return cast(
+            "Content.ContentInfo",
+            await cls._static_request_async(
+                "patch",
+                f"/content/{content_id}",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def delete(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: "Content.DeleteParams",
+    ) -> "Content.DeleteResponse":
+        """
+        Deletes a content by its id or file path.
+        """
+        content_id = cls.resolve_content_id_from_file_path(
+            user_id,
+            company_id,
+            params.get("contentId"),
+            params.get("filePath"),
+        )
+        params.pop("contentId", None)
+        params.pop("filePath", None)
+
+        return cast(
+            "Content.DeleteResponse",
+            cls._static_request(
+                "delete",
+                f"/content/{content_id}",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def delete_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: "Content.DeleteParams",
+    ) -> "Content.DeleteResponse":
+        """
+        Async deletes a content by its id or file path.
+        """
+        content_id = cls.resolve_content_id_from_file_path(
+            user_id,
+            company_id,
+            params.get("contentId"),
+            params.get("filePath"),
+        )
+        params.pop("contentId", None)
+        params.pop("filePath", None)
+
+        return cast(
+            "Content.DeleteResponse",
+            await cls._static_request_async(
+                "delete",
+                f"/content/{content_id}",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def resolve_content_id_from_file_path(
+        cls,
+        user_id: str,
+        company_id: str,
+        content_id: str | None = None,
+        file_path: str | None = None,
+    ) -> str:
+        """
+        Returns the contentId to use: if content_id is provided, returns it;
+        if not, but file_path is provided, resolves and returns the id for that file path.
+        """
+        if content_id:
+            return content_id
+        if file_path:
+            file_info = cls.get_info(
+                user_id=user_id,
+                company_id=company_id,
+                filePath=file_path,
+            )
+            resolved_id = (
+                file_info.get("contentInfo")[0].get("id")
+                if file_info.get("totalCount", 0) > 0
+                else None
+            )
+            if not resolved_id:
+                raise ValueError(f"Could not find file with filePath: {file_path}")
+            return resolved_id
+        return None

unique_sdk/api_resources/_folder.py

@@ -418,7 +418,7 @@ class Folder(APIResource["Folder"]):
         Delete a folder by its ID or path.
         """
 
-        scopeId = cls.resolve_scope_id(
+        scopeId = cls.resolve_scope_id_from_folder_path(
             user_id, company_id, params.get("scopeId"), params.get("folderPath")
         )
         params.pop("scopeId", None)
@@ -445,7 +445,7 @@ class Folder(APIResource["Folder"]):
         """
         Async delete a folder by its ID or path.
         """
-        scopeId = cls.resolve_scope_id(
+        scopeId = cls.resolve_scope_id_from_folder_path(
             user_id, company_id, params.get("scopeId"), params.get("folderPath")
         )
         params.pop("scopeId", None)
@@ -463,7 +463,7 @@ class Folder(APIResource["Folder"]):
         )
 
     @classmethod
-    def resolve_scope_id(
+    def resolve_scope_id_from_folder_path(
         cls,
         user_id: str,
         company_id: str,

{unique_sdk-0.10.15.dist-info → unique_sdk-0.10.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.15
+Version: 0.10.17
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -554,6 +554,98 @@ Allows you to ingest a magic table sheet, each row is processed and converted in
     unique_sdk.Content.ingest_magic_table_sheets(**params)
 ```
 
+#### `unique_sdk.Content.update` (Compatible with release >.36)
+
+Allows you to update a file specified by its `contentId` or by its `filePath`.
+
+- `contentId` optional if `filePath` is provided, the id of the file to be updated
+- `filePath` optional if `contentId` is provided, the absolute path of the file to be updated
+
+Currently, the following updates are supported:
+
+Title update:
+- `title` optional, allows updating the title of the folder
+
+Move the file to a different folder. this can be done by specifying either the `ownerId` or the `parentFolderPath`.
+- `ownerId` optional, allows moving the file to a different folder. Represents the new folder for the file and it should be the id of a folder e.g.: `scope_dhjfieurfloakmdle`. 
+- `parentFolderPath` optional, allows moving the file to a different folder. Represents the path new folder for the file. 
+
+
+Example of updating the title of a file specified by its path.
+
+```python
+unique_sdk.Content.update(
+    user_id=user_id,
+    company_id=company_id,
+    filePath="/Company/finance/january.xls",
+    title="Revision Deck"
+)
+```
+
+Example of moving a file specified by its content id.
+
+```python
+unique_sdk.Content.update(
+    user_id=user_id,
+    company_id=company_id,
+    contentId="cont_ok2343q5owbce80w78hudawu5",
+    ownerId="scope_e68yz5asho7glfh7c7d041el"
+)
+```
+
+Example of moving a file and updating its title.
+
+```python
+unique_sdk.Content.update(
+    user_id=user_id,
+    company_id=company_id,
+    contentId="cont_ok2343q5owbce80w78hudawu5",
+    ownerId="scope_e68yz5asho7glfh7c7d041el",
+    title="Revision Deck (1)"
+)
+```
+
+Example of moving a file to a folder specified by its path.
+
+```python
+unique_sdk.Content.update(
+    user_id=user_id,
+    company_id=company_id,
+    contentId="cont_ok2343q5owbce80w78hudawu5",
+    ownerId="scope_e68yz5asho7glfh7c7d041el",
+    parentFolderPath="/Company/Revisions"
+)
+```
+
+#### `unique_sdk.Content.delete` (Compatible with release >.36)
+
+Allows you to delete a file by its `contentId` or by its `filePath`. When deleting by `id`, if the file is part of a chat, the `chatId` also needs do be set. If both `contentId` and `filePath` are provided, `filePath` is ignored.
+
+- `contentId` optional if `filePath` is provided, the id of the file to be deleted
+- `chatId` optional, the id of the chat where the file is. Only needed if the file is part of a chat
+- `filePath` optional if `contentId` is provided, the absolute path of the file to be deleted
+
+Example of deleting a file from a chat.
+
+```python
+unique_sdk.Content.delete(
+    user_id=user_id,
+    company_id=company_id,
+    contentId="cont_ok2343q5owbce80w78hudawu5",
+    chatId="chat_v3xfa7liv876h89vuiibus1"
+)
+```
+
+Example of deleting a file by its path.
+
+```python
+unique_sdk.Content.delete(
+    user_id=user_id,
+    company_id=company_id,
+    filePath="/Company/finance/january.xls",
+)
+```
+
 ### Message
 
 #### `unique_sdk.Message.list`
@@ -1516,6 +1608,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.17] - 2025-09-01
+- Add function to update a file
+
+## [0.10.16] - 2025-08-31
+- Add function to delete a content.
+
 ## [0.10.15] - 2025-08-28
 - Add default values for message log types
 

{unique_sdk-0.10.15.dist-info → unique_sdk-0.10.17.dist-info}/RECORD

@@ -17,10 +17,10 @@ unique_sdk/api_resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 unique_sdk/api_resources/_acronyms.py,sha256=GIU1XH1flGWQYcpsFqTYwg4ioIGxVmb15tux84nmhEg,891
 unique_sdk/api_resources/_agentic_table.py,sha256=8-_f7t-m_iiiOj2835iESoxz91YRxl4-tkxpzQbgdcI,9958
 unique_sdk/api_resources/_chat_completion.py,sha256=ILCAffxkbkfh2iV9L4KKnfe80gZmT9pWfkNmf3mq68U,2172
-unique_sdk/api_resources/_content.py,sha256=WQiNdBSE7pe9QV15NXy_kqhEHCqrjH7Xzk3eSK-456c,10723
+unique_sdk/api_resources/_content.py,sha256=rjpTnDXJFw1EGP2n57WLlO_7fO6z8ykrnySkGXpYUEs,15820
 unique_sdk/api_resources/_embedding.py,sha256=C6qak7cCUBMBINfPhgH8taCJZ9n6w1MUElqDJJ8dG10,1281
 unique_sdk/api_resources/_event.py,sha256=bpWF9vstdoAWbUzr-iiGP713ceP0zPk77GJXiImf9zg,374
-unique_sdk/api_resources/_folder.py,sha256=u_x6g8g_LQsRiJm7ExYuFBxNywfbhOtnSIVK0HwcDws,12820
+unique_sdk/api_resources/_folder.py,sha256=mIyWaxJtIHlDLPFZ0FY1U9b3dmtmIcjDEbgOZtLA-DI,12871
 unique_sdk/api_resources/_integrated.py,sha256=z_DrftwjgVCi10QQqRYnG5_-95kD7Kfjogbb-dmnJuA,5854
 unique_sdk/api_resources/_mcp.py,sha256=zKh0dyn0QnkKk57N2zlGVN_GQoxEp5T2CS38vVm6jQY,3341
 unique_sdk/api_resources/_message.py,sha256=gEDIzg3METZU2k7m69meAuf0IWmZxnYOjbBKPRMwPYE,7688
@@ -36,7 +36,7 @@ unique_sdk/utils/chat_in_space.py,sha256=3NeBjOu7p43V_6PrjwxyaTkgknUS10KE4QRuTlF
 unique_sdk/utils/file_io.py,sha256=YY8B7VJcTLOPmCXByiOfNerXGlAtjCC5EVNmAbQJ3dQ,4306
 unique_sdk/utils/sources.py,sha256=DoxxhMLcLhmDfNarjXa41H4JD2GSSDywr71hiC-4pYc,4952
 unique_sdk/utils/token.py,sha256=AzKuAA1AwBtnvSFxGcsHLpxXr_wWE5Mj4jYBbOz2ljA,1740
-unique_sdk-0.10.15.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
-unique_sdk-0.10.15.dist-info/METADATA,sha256=u4BkT3XbxcWZ6d0Em3QtURDWrdo85KfHWGqhTvfJ3sA,52058
-unique_sdk-0.10.15.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-unique_sdk-0.10.15.dist-info/RECORD,,
+unique_sdk-0.10.17.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
+unique_sdk-0.10.17.dist-info/METADATA,sha256=kqPSSpUqlgzvlDeR_-9bfF2LXNVtMv4WSCZZYtkht60,55043
+unique_sdk-0.10.17.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+unique_sdk-0.10.17.dist-info/RECORD,,