stackshift 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

stackshift/assets.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import json
+import hashlib
 from pathlib import Path
 from typing import Any, BinaryIO
 from urllib.parse import quote
@@ -66,7 +67,7 @@ class AssetsClient:
             "key": key,
             "folder": folder,
             "visibility": visibility,
-            "cacheControl": cache_control,
+            "cache_control": cache_control,
             "metadata": json.dumps(metadata) if metadata else None,
         })
 
@@ -77,21 +78,25 @@ class AssetsClient:
     def get(self, asset_id: str) -> dict[str, Any]:
         return self._client.request("GET", f"/assets/{asset_id}")
 
-    def delete(self, asset_id: str) -> dict[str, Any]:
-        return self._client.request("DELETE", f"/assets/{asset_id}")
+    def delete(self, asset_id: str, revision: int, *, idempotency_key: str | None = None) -> dict[str, Any]:
+        headers = {"If-Match": f'"{revision}"'}
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+        return self._client.request("DELETE", f"/assets/{asset_id}", headers=headers)
 
     def replace(
         self,
         asset_id: str,
+        revision: int,
         file: str | Path | BinaryIO,
         *,
         cache_control: str | None = None,
         metadata: dict[str, Any] | None = None,
     ) -> dict[str, Any]:
         return self._multipart("PUT", f"/assets/{asset_id}/replace", file, {
-            "cacheControl": cache_control,
+            "cache_control": cache_control,
             "metadata": json.dumps(metadata) if metadata else None,
-        })
+        }, headers={"If-Match": f'"{revision}"'})
 
     def signed_url(
         self,
@@ -101,16 +106,18 @@ class AssetsClient:
         max_downloads: int | None = None,
     ) -> dict[str, Any]:
         return self._client.request("POST", f"/assets/{asset_id}/signed-url", json={
-            "expiresIn": expires_in,
-            "maxDownloads": max_downloads,
+            "expires_in": expires_in,
+            "max_downloads": max_downloads,
         })
 
     def signed_upload_url(self, **payload: Any) -> dict[str, Any]:
         return self.create_upload_session(**payload)
 
     def create_upload_session(self, **payload: Any) -> dict[str, Any]:
+        idempotency_key = payload.pop("idempotency_key", None)
         clean = {key: value for key, value in payload.items() if value not in (None, "")}
-        return self._client.request("POST", "/assets/upload-sessions", json=clean)
+        headers = {"Idempotency-Key": idempotency_key} if idempotency_key else None
+        return self._client.request("POST", "/assets/upload-sessions", json=clean, headers=headers)
 
     def create_chunked_upload_session(self, **payload: Any) -> dict[str, Any]:
         return self.create_upload_session(mode="chunked", **payload)
@@ -126,10 +133,11 @@ class AssetsClient:
             origin = self._client.base_url.removesuffix("/api/v1")
             target = f"{origin}/uploads/{quote(upload_url_or_token)}"
 
+        raw = chunk if isinstance(chunk, bytes) else chunk.read()
         response = self._client.session.put(
             f"{target}/parts/{part_number}",
-            data=chunk,
-            headers={"User-Agent": "StackShift-Python/0.1"},
+            data=raw,
+            headers={"User-Agent": "StackShift-Python/0.1", "X-Content-SHA256": hashlib.sha256(raw).hexdigest()},
         )
         payload = response.json() if response.content else None
         if response.status_code < 200 or response.status_code >= 300:
@@ -146,6 +154,27 @@ class AssetsClient:
     def cancel_upload_session(self, session_id: str) -> dict[str, Any]:
         return self._client.request("DELETE", f"/assets/upload-sessions/{session_id}")
 
+    def list_buckets(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/buckets")
+
+    def create_bucket(self, **payload: Any) -> dict[str, Any]:
+        return self._client.request("POST", "/assets/buckets", json=payload)
+
+    def update_bucket(self, bucket_id: str, revision: int, **payload: Any) -> dict[str, Any]:
+        return self._client.request("PUT", f"/assets/buckets/{bucket_id}", json=payload, headers={"If-Match": f'"{revision}"'})
+
+    def delete_bucket(self, bucket_id: str, revision: int) -> dict[str, Any]:
+        return self._client.request("DELETE", f"/assets/buckets/{bucket_id}", headers={"If-Match": f'"{revision}"'})
+
+    def set_tags(self, asset_id: str, revision: int, tags: list[str]) -> dict[str, Any]:
+        return self._client.request("PUT", f"/assets/{asset_id}/tags", json={"tags": tags}, headers={"If-Match": f'"{revision}"'})
+
+    def patch_metadata(self, asset_id: str, revision: int, metadata: dict[str, Any]) -> dict[str, Any]:
+        return self._client.request("PATCH", f"/assets/{asset_id}/metadata", json={"metadata": metadata}, headers={"If-Match": f'"{revision}"'})
+
+    def patch(self, asset_id: str, revision: int, **payload: Any) -> dict[str, Any]:
+        return self._client.request("PATCH", f"/assets/{asset_id}", json=payload, headers={"If-Match": f'"{revision}"'})
+
     def url(self, asset_id: str, **options: Any) -> str:
         spec = _transform_spec(options)
         return f"{self._client.cdn_base_url}/assets/{quote(asset_id)}/tr/{quote(spec)}"
@@ -153,18 +182,6 @@ class AssetsClient:
     def named_url(self, asset_id: str, name: str) -> str:
         return f"{self._client.cdn_base_url}/t/{quote(name)}/assets/{quote(asset_id)}"
 
-    def video_url(
-        self,
-        asset_id: str,
-        kind: str,
-        profile: str = "default",
-        token: str | None = None,
-    ) -> str:
-        prefix = "/private/assets" if token else "/assets"
-        base = f"{self._client.cdn_base_url}{prefix}/{quote(asset_id)}"
-        result = f"{base}/video/{quote(kind)}/{quote(profile)}"
-        return f"{result}?token={quote(token)}" if token else result
-
     def version_url(self, asset_id: str, version_id: str, token: str | None = None) -> str:
         prefix = "/private/assets" if token else "/assets"
         result = f"{self._client.cdn_base_url}{prefix}/{quote(asset_id)}/versions/{quote(version_id)}"
@@ -175,26 +192,35 @@ class AssetsClient:
         result = f"{self._client.cdn_base_url}{prefix}/{quote(asset_id)}/branches/{quote(branch)}"
         return f"{result}?token={quote(token)}" if token else result
 
+    def video_url(self, asset_id: str, kind: str, profile: str = "default", token: str | None = None) -> str:
+        prefix = "/private/assets" if token else "/assets"
+        result = f"{self._client.cdn_base_url}{prefix}/{quote(asset_id)}/video/{quote(kind)}/{quote(profile)}"
+        return f"{result}?token={quote(token)}" if token else result
+
     def ai(self, asset_id: str) -> dict[str, Any]:
         return self._client.request("GET", f"/assets/{asset_id}/ai")
 
-    def request_ai_analyze(self, asset_id: str) -> dict[str, Any]:
-        return self._client.request("POST", f"/assets/{asset_id}/ai/analyze")
+    def request_ai_analyze(self, asset_id: str, *, idempotency_key: str | None = None) -> dict[str, Any]:
+        return self._request_ai_job(f"/assets/{asset_id}/ai/analyze", idempotency_key)
 
-    def request_moderation(self, asset_id: str) -> dict[str, Any]:
-        return self._client.request("POST", f"/assets/{asset_id}/moderation")
+    def request_moderation(self, asset_id: str, *, idempotency_key: str | None = None) -> dict[str, Any]:
+        return self._request_ai_job(f"/assets/{asset_id}/moderation", idempotency_key)
 
     def transcript(self, asset_id: str) -> dict[str, Any]:
         return self._client.request("GET", f"/assets/{asset_id}/transcript")
 
-    def request_transcript(self, asset_id: str) -> dict[str, Any]:
-        return self._client.request("POST", f"/assets/{asset_id}/transcript")
+    def request_transcript(self, asset_id: str, *, idempotency_key: str | None = None) -> dict[str, Any]:
+        return self._request_ai_job(f"/assets/{asset_id}/transcript", idempotency_key)
+
+    def request_smart_crop(self, asset_id: str, *, idempotency_key: str | None = None) -> dict[str, Any]:
+        return self._request_ai_job(f"/assets/{asset_id}/smart-crop", idempotency_key)
 
-    def request_smart_crop(self, asset_id: str) -> dict[str, Any]:
-        return self._client.request("POST", f"/assets/{asset_id}/smart-crop")
+    def request_background_removal(self, asset_id: str, *, idempotency_key: str | None = None) -> dict[str, Any]:
+        return self._request_ai_job(f"/assets/{asset_id}/background-remove", idempotency_key)
 
-    def request_background_removal(self, asset_id: str) -> dict[str, Any]:
-        return self._client.request("POST", f"/assets/{asset_id}/background-remove")
+    def _request_ai_job(self, path: str, idempotency_key: str | None) -> dict[str, Any]:
+        headers = {"Idempotency-Key": idempotency_key} if idempotency_key else None
+        return self._client.request("POST", path, headers=headers)
 
     def versions(self, asset_id: str) -> dict[str, Any]:
         return self._client.request("GET", f"/assets/{asset_id}/versions")
@@ -265,7 +291,74 @@ class AssetsClient:
         clean = {key: value for key, value in options.items() if value not in (None, "")}
         return self._client.request("POST", f"/assets/{asset_id}/transform-url", json=clean)
 
-    def _multipart(self, method: str, suffix: str, file: str | Path | BinaryIO, fields: dict[str, Any]) -> dict[str, Any]:
+    def get_ai_config(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/ai/config")
+
+    def update_ai_config(self, revision: int, *, enabled_actions: list[str], monthly_spend_cap_micros: int) -> dict[str, Any]:
+        return self._client.request("PUT", "/assets/ai/config", headers={"If-Match": f'"{revision}"'}, json={
+            "enabled_actions": enabled_actions,
+            "monthly_spend_cap_micros": monthly_spend_cap_micros,
+        })
+
+    def job(self, job_id: str) -> dict[str, Any]:
+        return self._client.request("GET", f"/assets/jobs/{quote(job_id)}")
+
+    def cancel_job(self, job_id: str) -> dict[str, Any]:
+        return self._client.request("POST", f"/assets/jobs/{quote(job_id)}/cancel")
+
+    def create_lifecycle_rule(self, **payload: Any) -> dict[str, Any]:
+        return self._client.request("POST", "/assets/lifecycle-rules", json=payload)
+
+    def list_lifecycle_rules(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/lifecycle-rules")
+
+    def delete_lifecycle_rule(self, rule_id: str) -> dict[str, Any]:
+        return self._client.request("DELETE", f"/assets/lifecycle-rules/{quote(rule_id)}")
+
+    def create_domain(self, domain: str) -> dict[str, Any]:
+        return self._client.request("POST", "/assets/domains", json={"domain": domain})
+
+    def list_domains(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/domains")
+
+    def verify_domain(self, domain_id: str) -> dict[str, Any]:
+        return self._client.request("POST", f"/assets/domains/{quote(domain_id)}/verify")
+
+    def delete_domain(self, domain_id: str) -> dict[str, Any]:
+        return self._client.request("DELETE", f"/assets/domains/{quote(domain_id)}")
+
+    def analytics(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/analytics")
+
+    def usage_summary(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/summary")
+
+    def events(self, limit: int = 50) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/events", params={"limit": limit})
+
+    def create_webhook(self, url: str, event_types: list[str] | None = None) -> dict[str, Any]:
+        return self._client.request("POST", "/assets/webhooks", json={"url": url, "event_types": event_types or ["asset.*"]})
+
+    def list_webhooks(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/webhooks")
+
+    def delete_webhook(self, webhook_id: str) -> dict[str, Any]:
+        return self._client.request("DELETE", f"/assets/webhooks/{quote(webhook_id)}")
+
+    def list_webhook_deliveries(self, webhook_id: str, limit: int = 50) -> dict[str, Any]:
+        return self._client.request("GET", f"/assets/webhooks/{quote(webhook_id)}/deliveries", params={"limit": limit})
+
+    def retry_webhook_delivery(self, delivery_id: str) -> dict[str, Any]:
+        return self._client.request("POST", f"/assets/webhook-deliveries/{quote(delivery_id)}/retry")
+
+    def purge(self, asset_id: str) -> dict[str, Any]:
+        return self._client.request("POST", f"/assets/{quote(asset_id)}/purge")
+
+    def bulk(self, *, action: str, items: list[dict[str, Any]], idempotency_key: str | None = None, **payload: Any) -> dict[str, Any]:
+        headers = {"Idempotency-Key": idempotency_key} if idempotency_key else None
+        return self._client.request("POST", "/assets/bulk", json={"action": action, "items": items, **payload}, headers=headers)
+
+    def _multipart(self, method: str, suffix: str, file: str | Path | BinaryIO, fields: dict[str, Any], headers: dict[str, str] | None = None) -> dict[str, Any]:
         should_close = False
         if isinstance(file, (str, Path)):
             handle = Path(file).open("rb")
@@ -277,7 +370,7 @@ class AssetsClient:
 
         try:
             data = {key: value for key, value in fields.items() if value not in (None, "")}
-            return self._client.request(method, suffix, data=data, files={"file": (filename, handle)})
+            return self._client.request(method, suffix, data=data, files={"file": (filename, handle)}, headers=headers)
         finally:
             if should_close:
                 handle.close()
@@ -292,4 +385,6 @@ def _transform_spec(options: dict[str, Any]) -> str:
     parts.append(f"c_{options.get('crop') or 'fit'}")
     parts.append(f"f_{options.get('format') or 'auto'}")
     parts.append(f"q_{options.get('quality') or 'auto'}")
+    parts.append(f"g_{options.get('gravity') or 'centre'}")
+    parts.append(f"a_{options.get('animation') or 'first'}")
     return ",".join(parts)

{stackshift-0.1.1.dist-info → stackshift-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackshift
-Version: 0.1.1
+Version: 0.1.2
 Summary: Official Python SDK for StackShift.
 Requires-Python: >=3.9
 Requires-Dist: requests>=2.31

{stackshift-0.1.1.dist-info → stackshift-0.1.2.dist-info}/RECORD

@@ -1,12 +1,12 @@
 stackshift/__init__.py,sha256=e5QZUzE6m_195Cvvawyv8p_M18eNkQzW6sBgBn3SlRo,1008
-stackshift/assets.py,sha256=Q_YHycCrqynWF6VWiQLfURG8ZndOwyhDudsg1t47nB0,16980
+stackshift/assets.py,sha256=qRzL9BNZSneNBc3es_vLsY4_hh_r3zOfdO_rAKQq5LU,22949
 stackshift/client.py,sha256=AcJivv4VRCQ756MRrxCrLi0Q4in-4np0Re8ceQSTF1Y,3000
 stackshift/mail.py,sha256=vegCniMcWBvHtz_UGAfNfVxFYTety8H3KKFQsWfKZSs,13462
 stackshift/mail_advanced.py,sha256=-lzajXqlrkR8qA4YpRX5Sv3VwcEQITtKfIXbWwjRRQE,3533
 stackshift/mail_phase7.py,sha256=Ud2fyKwt-vpaw7vgEayLw5q9tiDIF-fkfTBaoGJMJBI,5377
 stackshift/mail_reputation.py,sha256=mPvPkZeqcQc5808PhBK7gYsgf4Fk_U19nRxSsJ60MGU,1112
 stackshift/projects.py,sha256=oYWaE7xNRR6OXuPEwJH-oFFeOmDA9ozq6jJY09ANIHA,498
-stackshift-0.1.1.dist-info/METADATA,sha256=HUXITWCwNLSzCl8fs5t8ly_ARJYZ1SpV9jfKC5B7y2A,152
-stackshift-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-stackshift-0.1.1.dist-info/top_level.txt,sha256=qe3uWsu_O9mNtq7bIck9Y8rjTIMrH0kzgAlGFDoRGqs,11
-stackshift-0.1.1.dist-info/RECORD,,
+stackshift-0.1.2.dist-info/METADATA,sha256=GKbdBmBmZWOUs8DTe-amYxZNbplrh7pAlkaRtkBWQ14,152
+stackshift-0.1.2.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+stackshift-0.1.2.dist-info/top_level.txt,sha256=qe3uWsu_O9mNtq7bIck9Y8rjTIMrH0kzgAlGFDoRGqs,11
+stackshift-0.1.2.dist-info/RECORD,,

{stackshift-0.1.1.dist-info → stackshift-0.1.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (83.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any