Ë
    òÏj²(  ã                  óx   — d Z ddlmZ ddlmZmZ ddlmZmZ ddl	m
Z
 ddlmZ ddlmZmZmZmZ  G d„ d	«      Zy
)z+Synchronous store client for LangGraph SDK.é    )Úannotations)ÚMappingÚSequence)ÚAnyÚLiteral)Ú_provided_vals)ÚSyncHttpClient)ÚItemÚListNamespaceResponseÚQueryParamTypesÚSearchItemsResponsec                  ó  — e Zd ZdZdd„Z	 	 	 	 d	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dd„Zddddœ	 	 	 	 	 	 	 	 	 	 	 dd„Z	 	 d	 	 	 	 	 	 	 	 	 dd„Z	 	 	 	 	 	 	 d	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dd„Z	 	 	 	 	 dddd	œ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 dd
„Z	y)ÚSyncStoreClienta¢  A client for synchronous operations on a key-value store.

    Provides methods to interact with a remote key-value store, allowing
    storage and retrieval of items within namespaced hierarchies.

    ???+ example "Example"

        ```python
        client = get_sync_client(url="http://localhost:2024"))
        client.store.put_item(["users", "profiles"], "user123", {"name": "Alice", "age": 30})
        ```
    c                ó   — || _         y )N)Úhttp)Úselfr   s     úV/var/www/html/gaurav-v2/venv/lib/python3.12/site-packages/langgraph_sdk/_sync/store.pyÚ__init__zSyncStoreClient.__init__    s	   € Øˆ�	ó    Nc               ó˜   — |D ]  }d|v sŒt        d|› d�«      ‚ |||||dœ}	| j                  j                  dt        |	«      ||¬«       y)aÜ  Store or update an item.

        Args:
            namespace: A list of strings representing the namespace path.
            key: The unique identifier for the item within the namespace.
            value: A dictionary containing the item's data.
            index: Controls search indexing - None (use defaults), False (disable), or list of field paths to index.
            ttl: Optional time-to-live in minutes for the item, or None for no expiration.
            headers: Optional custom headers to include with the request.
            params: Optional query parameters to include with the request.

        Returns:
            `None`

        ???+ example "Example Usage"

            ```python
            client = get_sync_client(url="http://localhost:8123")
            client.store.put_item(
                ["documents", "user123"],
                key="item456",
                value={"title": "My Document", "content": "Hello World"}
            )
            ```
        Ú.úInvalid namespace label 'ú1'. Namespace labels cannot contain periods ('.').)Ú	namespaceÚkeyÚvalueÚindexÚttlú/store/items©ÚjsonÚheadersÚparamsN)Ú
ValueErrorr   Úputr   )
r   r   r   r   r   r   r"   r#   ÚlabelÚpayloads
             r   Úput_itemzSyncStoreClient.put_item#   sn   € óH ˆEØ�eŠ|Ü Ø/°¨wÐ6gÐhóð ð ð #ØØØØñ
ˆð 	�	‰	�‰Ø¤°Ó!8À'ÐRXð 	õ 	
r   )Úrefresh_ttlr"   r#   c              óÎ   — |D ]  }d|v sŒt        d|› d�«      ‚ |dj                  |«      dœ}|�||d<   |r|j                  |«       | j                  j	                  d||¬«      S )at  Retrieve a single item.

        Args:
            key: The unique identifier for the item.
            namespace: Optional list of strings representing the namespace path.
            refresh_ttl: Whether to refresh the TTL on this read operation. If `None`, uses the store's default behavior.
            headers: Optional custom headers to include with the request.

        Returns:
            The retrieved item.

        ???+ example "Example Usage"

            ```python
            client = get_sync_client(url="http://localhost:8123")
            item = client.store.get_item(
                ["documents", "user123"],
                key="item456",
            )
            print(item)
            ```

            ```shell
            ----------------------------------------------------------------

            {
                'namespace': ['documents', 'user123'],
                'key': 'item456',
                'value': {'title': 'My Document', 'content': 'Hello World'},
                'created_at': '2024-07-30T12:00:00Z',
                'updated_at': '2024-07-30T12:00:00Z'
            }
            ```
        r   r   r   ©r   r   r)   r   )r#   r"   )r$   ÚjoinÚupdater   Úget)r   r   r   r)   r"   r#   r&   Úquery_paramss           r   Úget_itemzSyncStoreClient.get_itemW   s   € óX ˆEØ�eŠ|Ü Ø/°¨wÐ6gÐhóð ð ð 03ÀÇÁÈ)ÓATÑ'UˆØÐ"Ø*5ˆL˜Ñ'ÙØ×Ñ Ô'Ø�y‰y�}‰}˜^°LÈ'ˆ}ÓRÐRr   c               óH   — | j                   j                  d||dœ||¬«       y)as  Delete an item.

        Args:
            key: The unique identifier for the item.
            namespace: Optional list of strings representing the namespace path.
            headers: Optional custom headers to include with the request.
            params: Optional query parameters to include with the request.

        Returns:
            `None`

        ???+ example "Example Usage"

            ```python
            client = get_sync_client(url="http://localhost:8123")
            client.store.delete_item(
                ["documents", "user123"],
                key="item456",
            )
            ```
        r   r+   r    N)r   Údelete)r   r   r   r"   r#   s        r   Údelete_itemzSyncStoreClient.delete_item�   s,   € ð: 	�	‰	×ÑØØ¨9Ñ5ØØð	 	õ 	
r   c	               ód   — ||||||dœ}	| j                   j                  dt        |	«      ||¬«      S )a*  Search for items within a namespace prefix.

        Args:
            namespace_prefix: List of strings representing the namespace prefix.
            filter: Optional dictionary of key-value pairs to filter results.
            limit: Maximum number of items to return (default is 10).
            offset: Number of items to skip before returning results (default is 0).
            query: Optional query for natural language search.
            refresh_ttl: Whether to refresh the TTL on items returned by this search. If `None`, uses the store's default behavior.
            headers: Optional custom headers to include with the request.
            params: Optional query parameters to include with the request.

        Returns:
            A list of items matching the search criteria.

        ???+ example "Example Usage"

            ```python
            client = get_sync_client(url="http://localhost:8123")
            items = client.store.search_items(
                ["documents"],
                filter={"author": "John Doe"},
                limit=5,
                offset=0
            )
            print(items)
            ```
            ```shell
            ----------------------------------------------------------------

            {
                "items": [
                    {
                        "namespace": ["documents", "user123"],
                        "key": "item789",
                        "value": {
                            "title": "Another Document",
                            "author": "John Doe"
                        },
                        "created_at": "2024-07-30T12:00:00Z",
                        "updated_at": "2024-07-30T12:00:00Z"
                    },
                    # ... additional items ...
                ]
            }
            ```
        )Únamespace_prefixÚfilterÚlimitÚoffsetÚqueryr)   z/store/items/searchr    ©r   Úpostr   )
r   r5   r6   r7   r8   r9   r)   r"   r#   r'   s
             r   Úsearch_itemszSyncStoreClient.search_items´   sK   € ðx !1ØØØØØ&ñ
ˆð �y‰y�~‰~Ø!Ü Ó(ØØð	 ó 
ð 	
r   )r"   r#   c               ób   — |||||dœ}| j                   j                  dt        |«      ||¬«      S )a  List namespaces with optional match conditions.

        Args:
            prefix: Optional list of strings representing the prefix to filter namespaces.
            suffix: Optional list of strings representing the suffix to filter namespaces.
            max_depth: Optional integer specifying the maximum depth of namespaces to return.
            limit: Maximum number of namespaces to return (default is 100).
            offset: Number of namespaces to skip before returning results (default is 0).
            headers: Optional custom headers to include with the request.

        Returns:
            A list of namespaces matching the criteria.

        ???+ example "Example Usage"

            ```python
            client = get_sync_client(url="http://localhost:8123")
            namespaces = client.store.list_namespaces(
                prefix=["documents"],
                max_depth=3,
                limit=10,
                offset=0
            )
            print(namespaces)
            ```

            ```shell
            ----------------------------------------------------------------

            [
                ["documents", "user123", "reports"],
                ["documents", "user456", "invoices"],
                ...
            ]
            ```
        )ÚprefixÚsuffixÚ	max_depthr7   r8   z/store/namespacesr    r:   )	r   r>   r?   r@   r7   r8   r"   r#   r'   s	            r   Úlist_namespaceszSyncStoreClient.list_namespacesþ   sH   € ð` ØØ"ØØñ
ˆð �y‰y�~‰~ØÜ Ó(ØØð	 ó 
ð 	
r   )r   r	   ÚreturnÚNone)NNNN)r   Ústrr   zMapping[str, Any]r   z!Literal[False] | list[str] | Noner   ú
int | Noner"   úMapping[str, str] | Noner#   úQueryParamTypes | Noner   úSequence[str]rB   rC   )r   rD   r   rH   r)   úbool | Noner"   rF   r#   rG   rB   r
   )NN)
r   rD   r"   rF   r#   rG   r   rH   rB   rC   )Né
   r   NNNN)r6   zMapping[str, Any] | Noner7   Úintr8   rK   r9   z
str | Noner)   rI   r"   rF   r#   rG   r5   rH   rB   r   )NNNéd   r   )r>   úlist[str] | Noner?   rM   r@   rE   r7   rK   r8   rK   r"   rF   r#   rG   rB   r   )
Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r(   r0   r3   r<   rA   © r   r   r   r      sî  „ ñóð 48ØØ,0Ø)-ð2
ð ð	2
ð
 !ð2
ð 1ð2
ð ð2
ð *ð2
ð 'ð2
à ð2
ð 
ó2
ðt $(Ø,0Ø)-ñ7Sð ð	7Sà ð7Sð !ð7Sð *ð7Sð 'ð7Sð 
ó7Sð| -1Ø)-ð"
ð ð	"
ð
 *ð"
ð 'ð"
à ð"
ð 
ó"
ðP ,0ØØØ Ø#'Ø,0Ø)-ðH
ð )ð	H
ð
 ðH
ð ðH
ð ðH
ð !ðH
ð *ðH
ð 'ðH
à'ðH
ð 
óH
ðX $(Ø#'Ø $ØØð;
ð -1Ø)-ñ;
à ð;
ð !ð;
ð ð	;
ð
 ð;
ð ð;
ð *ð;
ð 'ð;
ð 
ô;
r   r   N)rQ   Ú
__future__r   Úcollections.abcr   r   Útypingr   r   Úlanggraph_sdk._shared.utilitiesr   Úlanggraph_sdk._sync.httpr	   Úlanggraph_sdk.schemar
   r   r   r   r   rR   r   r   Ú<module>rY      s-   ðÙ 1å "ç -ß å :Ý 3÷ó ÷g
ò g
r   