dominus-sdk-python 6.2.0__py3-none-any.whl → 6.3.0__py3-none-any.whl

dominus/__init__.py

@@ -160,12 +160,19 @@ from .errors import (
     ValidationError,
     ConflictError,
     ServiceError,
+    StashBookmarkArtifactNotFound,
+    StashBookmarkInvalidVersionRef,
+    StashBookmarkDuplicateName,
+    StashBookmarkUpstreamRejected,
+    StashWatchInvalidWebhookUrl,
+    StashWatchUpstreamRejected,
+    StashWatchNotFound,
     SecureTableError,
     ConnectionError as DominusConnectionError,
     TimeoutError as DominusTimeoutError,
 )
 
-__version__ = "6.2.0"
+__version__ = "6.3.0"
 __all__ = [
     # Main SDK instance
     "dominus",
@@ -250,6 +257,13 @@ __all__ = [
     "ValidationError",
     "ConflictError",
     "ServiceError",
+    "StashBookmarkArtifactNotFound",
+    "StashBookmarkInvalidVersionRef",
+    "StashBookmarkDuplicateName",
+    "StashBookmarkUpstreamRejected",
+    "StashWatchInvalidWebhookUrl",
+    "StashWatchUpstreamRejected",
+    "StashWatchNotFound",
     "SecureTableError",
     "DominusConnectionError",
     "DominusTimeoutError",

dominus/errors.py

@@ -205,6 +205,34 @@ class ServiceError(DominusError):
         super().__init__(message, status_code, details, endpoint)
 
 
+class StashBookmarkArtifactNotFound(NotFoundError):
+    """Raised when a stash artifact bookmark target cannot be found."""
+
+
+class StashBookmarkInvalidVersionRef(ValidationError):
+    """Raised when a stash artifact bookmark version_ref is invalid."""
+
+
+class StashBookmarkDuplicateName(ConflictError):
+    """Raised when a stash artifact bookmark name is already in use."""
+
+
+class StashBookmarkUpstreamRejected(ServiceError):
+    """Raised when the artifact backend rejects a stash bookmark operation."""
+
+
+class StashWatchInvalidWebhookUrl(ValidationError):
+    """Raised when a stash artifact watcher webhook_url is invalid."""
+
+
+class StashWatchUpstreamRejected(ServiceError):
+    """Raised when the artifact backend rejects a stash watch operation."""
+
+
+class StashWatchNotFound(NotFoundError):
+    """Raised when a stash artifact watcher cannot be found."""
+
+
 class ConnectionError(DominusError):
     """Raised when connection to the backend fails."""
 
@@ -244,6 +272,17 @@ class SecureTableError(DominusError):
         super().__init__(message, status_code, details, endpoint)
 
 
+STASH_ERROR_CLASSES = {
+    "stash.bookmark.artifact_not_found": StashBookmarkArtifactNotFound,
+    "stash.bookmark.invalid_version_ref": StashBookmarkInvalidVersionRef,
+    "stash.bookmark.duplicate_name": StashBookmarkDuplicateName,
+    "stash.bookmark.upstream_rejected": StashBookmarkUpstreamRejected,
+    "stash.watch.invalid_webhook_url": StashWatchInvalidWebhookUrl,
+    "stash.watch.upstream_rejected": StashWatchUpstreamRejected,
+    "stash.watch.not_found": StashWatchNotFound,
+}
+
+
 def raise_for_status(
     status_code: int,
     message: str,
@@ -262,6 +301,7 @@ def raise_for_status(
     Raises:
         Appropriate DominusError subclass
     """
+    code = _first_string((details or {}).get("code"))
     error_classes = {
         400: ValidationError,
         401: AuthenticationError,
@@ -274,5 +314,5 @@ def raise_for_status(
         504: TimeoutError,
     }
 
-    error_class = error_classes.get(status_code, DominusError)
+    error_class = STASH_ERROR_CLASSES.get(code) or error_classes.get(status_code, DominusError)
     raise error_class(message, status_code, details, endpoint)

dominus/namespaces/stash.py

@@ -6,10 +6,18 @@ stores items in each project's ``stash.*`` schema and transparently falls
 back to a designated shared project on read.
 """
 from typing import Any, Dict, List, Optional, TYPE_CHECKING
+from urllib.parse import urlencode
 
 if TYPE_CHECKING:
     from ..start import Dominus
 
+BookmarkRef = Dict[str, Any]
+WatcherRef = Dict[str, Any]
+
+
+def _facade_query(*, env: str, kind: str, scope: str, key: str) -> str:
+    return urlencode({"env": env, "kind": kind, "scope": scope, "key": key})
+
 
 class StashNamespace:
     """
@@ -273,3 +281,155 @@ class StashNamespace:
             body=body,
             use_gateway=True,
         )
+
+    async def bookmark(
+        self,
+        *,
+        env: str,
+        kind: str,
+        scope: str,
+        key: str,
+        name: str,
+        version_ref: str,
+        timeout: float = 30.0,
+    ) -> BookmarkRef:
+        """Create or update a named bookmark for a stash artifact facade item."""
+        return await self._client._request(
+            endpoint="/svc/stash/bookmark",
+            method="POST",
+            body={
+                "env": env,
+                "kind": kind,
+                "scope": scope,
+                "key": key,
+                "name": name,
+                "version_ref": version_ref,
+            },
+            use_gateway=True,
+            timeout=timeout,
+        )
+
+    async def unbookmark(
+        self,
+        *,
+        env: str,
+        kind: str,
+        scope: str,
+        key: str,
+        name: str,
+        timeout: float = 30.0,
+    ) -> None:
+        """Remove a named bookmark from a stash artifact facade item."""
+        await self._client._request(
+            endpoint="/svc/stash/unbookmark",
+            method="POST",
+            body={
+                "env": env,
+                "kind": kind,
+                "scope": scope,
+                "key": key,
+                "name": name,
+            },
+            use_gateway=True,
+            timeout=timeout,
+        )
+        return None
+
+    async def watch(
+        self,
+        *,
+        env: str,
+        kind: str,
+        scope: str,
+        key: str,
+        watcher_name: str,
+        webhook_url: str,
+        timeout: float = 30.0,
+    ) -> WatcherRef:
+        """Create or update a webhook watcher for a stash artifact facade item."""
+        return await self._client._request(
+            endpoint="/svc/stash/watch",
+            method="POST",
+            body={
+                "env": env,
+                "kind": kind,
+                "scope": scope,
+                "key": key,
+                "watcher_name": watcher_name,
+                "webhook_url": webhook_url,
+            },
+            use_gateway=True,
+            timeout=timeout,
+        )
+
+    async def unwatch(
+        self,
+        *,
+        env: str,
+        kind: str,
+        scope: str,
+        key: str,
+        watcher_name: str,
+        timeout: float = 30.0,
+    ) -> None:
+        """Remove a webhook watcher from a stash artifact facade item."""
+        await self._client._request(
+            endpoint="/svc/stash/unwatch",
+            method="POST",
+            body={
+                "env": env,
+                "kind": kind,
+                "scope": scope,
+                "key": key,
+                "watcher_name": watcher_name,
+            },
+            use_gateway=True,
+            timeout=timeout,
+        )
+        return None
+
+    async def list_bookmarks(
+        self,
+        *,
+        env: str,
+        kind: str,
+        scope: str,
+        key: str,
+        timeout: float = 30.0,
+    ) -> List[BookmarkRef]:
+        """List bookmark refs for a stash artifact facade item."""
+        result = await self._client._request(
+            endpoint=f"/svc/stash/bookmark/list?{_facade_query(env=env, kind=kind, scope=scope, key=key)}",
+            method="GET",
+            use_gateway=True,
+            timeout=timeout,
+        )
+        if isinstance(result, list):
+            return result
+        if isinstance(result, dict):
+            bookmarks = result.get("bookmarks")
+            return bookmarks if isinstance(bookmarks, list) else []
+        return []
+
+    async def list_watchers(
+        self,
+        *,
+        env: str,
+        kind: str,
+        scope: str,
+        key: str,
+        timeout: float = 30.0,
+    ) -> List[WatcherRef]:
+        """List watcher refs for a stash artifact facade item."""
+        result = await self._client._request(
+            endpoint=f"/svc/stash/watch/list?{_facade_query(env=env, kind=kind, scope=scope, key=key)}",
+            method="GET",
+            use_gateway=True,
+            timeout=timeout,
+        )
+        if isinstance(result, list):
+            return result
+        if isinstance(result, dict):
+            watchers = result.get("watchers")
+            return watchers if isinstance(watchers, list) else []
+        return []

{dominus_sdk_python-6.2.0.dist-info → dominus_sdk_python-6.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 6.2.0
+Version: 6.3.0
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary

{dominus_sdk_python-6.2.0.dist-info → dominus_sdk_python-6.3.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-dominus/__init__.py,sha256=YN_EQvrVr1Sl96vmxGQAJhmglFG1A-nUZp6zEjj6X8A,7116
-dominus/errors.py,sha256=NthcR-o1Q1nQsE3ZSHStcW_RdZ8LQ06mPDSenY1txgM,8547
+dominus/__init__.py,sha256=ufIz_THCMp-6QD7Q9ptReUaM8OItGXsRGAsZuKcSbI8,7584
+dominus/errors.py,sha256=mni7otKhnwMUle99hkBOgLt2AeDCaAnqydaYsqWKWwM,9994
 dominus/start.py,sha256=ofvuNx6aNRijs3qRBI9r2UOzw2LV59ncZP8BoIOj2UU,50385
 dominus/config/__init__.py,sha256=nvLLNh4dM_MCqcfF3XFS2NnVn44q0RYHEfAPP-2G5To,434
 dominus/config/endpoints.py,sha256=IFioVY3jQ5Mqy65L6rNbEXyPUfYTaXRQkfyGdKv33A8,4140
@@ -36,12 +36,12 @@ dominus/namespaces/recipes.py,sha256=vBe09bnqP4p9DCoYll3yXk81PPGyBj0thw746wyV8AI
 dominus/namespaces/redis.py,sha256=1joYhewLGdN4-OCYJu5rvhsF5yORUUfVtBrgjzLKAzs,19337
 dominus/namespaces/secrets.py,sha256=od8AKgENwW6U-kVfIX3DSphXKeJA6XC-SxbGqsxhhUk,6253
 dominus/namespaces/secure.py,sha256=9idGY5R6k7b-JM1SAF_1Gt-YV5OempyxFBflgLJieLo,7168
-dominus/namespaces/stash.py,sha256=rdDHl0b0zVyoP_CQxyBxVLPo2O4m_Y1z2YuUWmYXdEM,9945
+dominus/namespaces/stash.py,sha256=Gos3OjWD45ODgKAlSz0X5zUOvIN9yivlNTPkqvU69EE,14418
 dominus/namespaces/sync.py,sha256=mGwMNwc_iWoKgS94n1staPdsKBHNvliMG7omokl7Qmk,2198
 dominus/namespaces/warden.py,sha256=ebbCeBJJwK9uALEj2aDbvWJ5HTlOXOpXJOwzokH1cso,1139
 dominus/namespaces/workflow.py,sha256=_PF7-9HtkCWhSAvBAq4g-e_43eTb7KjPHAKWmToHvBo,48474
 dominus/services/__init__.py,sha256=LQl5sx6DHhX1xCN3MRoUgffxqwm3Mfm525hijyFods8,43
-dominus_sdk_python-6.2.0.dist-info/METADATA,sha256=HFgaoiX3QunTO0IZ05ML4oZSKrQR8aCoW4DkqC7V07A,9852
-dominus_sdk_python-6.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-dominus_sdk_python-6.2.0.dist-info/top_level.txt,sha256=515zxMIbX0DpheRbjvNqKIt_AFqdFjX41jtyp_SqLf4,8
-dominus_sdk_python-6.2.0.dist-info/RECORD,,
+dominus_sdk_python-6.3.0.dist-info/METADATA,sha256=NAkxpwSdhyrbZVI5br3Lf0MZzZWpoUGztmkWHkax4Us,9852
+dominus_sdk_python-6.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+dominus_sdk_python-6.3.0.dist-info/top_level.txt,sha256=515zxMIbX0DpheRbjvNqKIt_AFqdFjX41jtyp_SqLf4,8
+dominus_sdk_python-6.3.0.dist-info/RECORD,,