stackshift 1.1.0__tar.gz → 1.2.0__tar.gz

{stackshift-1.1.0 → stackshift-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackshift
-Version: 1.1.0
+Version: 1.2.0
 Summary: Official Python SDK for StackShift.
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -16,6 +16,27 @@ Official Python SDK for StackShift.
 pip install stackshift
 ```
 
+## AI credits
+
+AI credits are account-scoped. Use the shared client to inspect usage, start a top-up, or select managed billing versus your own provider key:
+
+```python
+from stackshift import StackShift
+
+stackshift = StackShift()
+balance = stackshift.ai_credits.balance()
+usage = stackshift.ai_credits.usage(product="assets", limit=25)
+quote = stackshift.ai_credits.quote(1_000, "USD")
+checkout = stackshift.ai_credits.checkout(
+    quote["id"],
+    "unique-checkout-id",
+    "paystack",
+)
+stackshift.ai_credits.set_funding("assets", "managed")
+```
+
+Keep account API keys and checkout creation on your server.
+
 ## Send email
 
 ```python
@@ -250,3 +271,14 @@ workspace = video.workspace(asset_id)
 Mutations carry the supplied revision in `If-Match`. Model preparation and rendering carry an idempotency key; render submission also carries the accepted maximum units. Playback renewal and events authenticate with the session credential, not the account key. Keep these clients on your backend and return grants with `Cache-Control: private, no-store`.
 
 See the [Assets SDK guide](https://docs.stackshift.cloud/assets/sdk-media-workflows) and its linked feature guides for complete language examples, inputs, permissions, review transitions and browser callbacks.
+
+## Assets storage and Cloudinary migration
+
+`sdk.assets.platform.for_space(space_id)` exposes `connections`, `storage`, and `migrations`. Use a verified Cloudinary connection, run a dry migration first, inspect its report, then start the transfer with the same folder prefix and conflict policy.
+
+```python
+platform = sdk.assets.platform.for_space(space_id)
+preview = platform.migrations.start({"source_connection_id": connection_id,
+    "destination_bucket_id": bucket_id, "source_prefix": "campaigns/2026", "dry_run": True})
+report = platform.migrations.report(preview["id"])
+```

{stackshift-1.1.0 → stackshift-1.2.0}/README.md

@@ -8,6 +8,27 @@ Official Python SDK for StackShift.
 pip install stackshift
 ```
 
+## AI credits
+
+AI credits are account-scoped. Use the shared client to inspect usage, start a top-up, or select managed billing versus your own provider key:
+
+```python
+from stackshift import StackShift
+
+stackshift = StackShift()
+balance = stackshift.ai_credits.balance()
+usage = stackshift.ai_credits.usage(product="assets", limit=25)
+quote = stackshift.ai_credits.quote(1_000, "USD")
+checkout = stackshift.ai_credits.checkout(
+    quote["id"],
+    "unique-checkout-id",
+    "paystack",
+)
+stackshift.ai_credits.set_funding("assets", "managed")
+```
+
+Keep account API keys and checkout creation on your server.
+
 ## Send email
 
 ```python
@@ -242,3 +263,14 @@ workspace = video.workspace(asset_id)
 Mutations carry the supplied revision in `If-Match`. Model preparation and rendering carry an idempotency key; render submission also carries the accepted maximum units. Playback renewal and events authenticate with the session credential, not the account key. Keep these clients on your backend and return grants with `Cache-Control: private, no-store`.
 
 See the [Assets SDK guide](https://docs.stackshift.cloud/assets/sdk-media-workflows) and its linked feature guides for complete language examples, inputs, permissions, review transitions and browser callbacks.
+
+## Assets storage and Cloudinary migration
+
+`sdk.assets.platform.for_space(space_id)` exposes `connections`, `storage`, and `migrations`. Use a verified Cloudinary connection, run a dry migration first, inspect its report, then start the transfer with the same folder prefix and conflict policy.
+
+```python
+platform = sdk.assets.platform.for_space(space_id)
+preview = platform.migrations.start({"source_connection_id": connection_id,
+    "destination_bucket_id": bucket_id, "source_prefix": "campaigns/2026", "dry_run": True})
+report = platform.migrations.report(preview["id"])
+```

{stackshift-1.1.0 → stackshift-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stackshift"
-version = "1.1.0"
+version = "1.2.0"
 description = "Official Python SDK for StackShift."
 readme = "README.md"
 requires-python = ">=3.9"

{stackshift-1.1.0 → stackshift-1.2.0}/stackshift/__init__.py

@@ -1,4 +1,5 @@
 from .client import StackShift
+from .ai_credits import AICreditsClient
 from .assets import ASSET_TRANSFORM_PRESETS, AssetsClient, asset_transform_options, asset_transform_spec, get_asset_transform_preset
 from .mail import (
     MailClient,
@@ -17,6 +18,7 @@ from .workload_security import WorkloadSecurityClient
 
 __all__ = [
     "StackShift",
+    "AICreditsClient",
     "ASSET_TRANSFORM_PRESETS",
     "AssetsClient",
     "MailClient",

stackshift-1.2.0/stackshift/ai_credits.py

@@ -0,0 +1,24 @@
+from typing import Any
+
+
+class AICreditsClient:
+    def __init__(self, client: Any) -> None:
+        self._client = client
+
+    def balance(self) -> dict[str, Any]:
+        return self._client.request("GET", "/billing/ai-credits")
+
+    def usage(self, **filters: Any) -> dict[str, Any]:
+        return self._client.request("GET", "/billing/ai-credits/usage", params=filters)
+
+    def quote(self, credits: int, currency: str) -> dict[str, Any]:
+        return self._client.request("POST", "/billing/ai-credits/top-ups/quote", json={"credits": credits, "currency": currency})
+
+    def checkout(self, quote_id: str, idempotency_key: str, provider: str) -> dict[str, Any]:
+        return self._client.request("POST", "/billing/ai-credits/top-ups/checkout", json={"quote_id": quote_id, "idempotency_key": idempotency_key, "provider": provider})
+
+    def funding(self) -> dict[str, str]:
+        return self._client.request("GET", "/billing/ai-credits/funding")
+
+    def set_funding(self, product: str, mode: str) -> dict[str, str]:
+        return self._client.request("PUT", "/billing/ai-credits/funding", json={"product": product, "mode": mode})

{stackshift-1.1.0 → stackshift-1.2.0}/stackshift/assets.py

@@ -9,6 +9,7 @@ from urllib.parse import quote
 from .assets_workflows import AssetWorkflowsMixin
 from .assets_dam import AssetDAMClient
 from .assets_video import AssetVideoClient
+from .assets_platform import AssetPlatformClient
 
 
 ASSET_TRANSFORM_PRESETS: list[dict[str, Any]] = [
@@ -56,6 +57,7 @@ class AssetsClient(AssetWorkflowsMixin):
         self._client = client
         self.dam = AssetDAMClient(client)
         self.video = AssetVideoClient(client)
+        self.platform = AssetPlatformClient(client)
 
     def upload(
         self,

stackshift-1.2.0/stackshift/assets_platform.py

@@ -0,0 +1,99 @@
+from __future__ import annotations
+
+from typing import Any
+from urllib.parse import quote
+
+
+def _id(value: str) -> str:
+    return quote(value, safe="")
+
+
+class _ScopedTransport:
+    def __init__(self, client: Any, space_id: str) -> None:
+        self._client = client
+        self._space_id = space_id
+
+    def request(self, method: str, path: str, **kwargs: Any) -> dict[str, Any]:
+        headers = dict(kwargs.pop("headers", None) or {})
+        if self._space_id:
+            headers["X-Asset-Space-ID"] = self._space_id
+        return self._client.request(method, path, headers=headers, **kwargs)
+
+
+class AssetConnectionsClient:
+    def __init__(self, client: Any) -> None:
+        self._client = client
+
+    def list(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/connections")
+
+    def get(self, connection_id: str) -> dict[str, Any]:
+        return self._client.request("GET", f"/assets/connections/{_id(connection_id)}")
+
+    def create(self, input: dict[str, Any]) -> dict[str, Any]:
+        return self._client.request("POST", "/assets/connections", json=input)
+
+    def update(self, connection_id: str, input: dict[str, Any]) -> dict[str, Any]:
+        return self._client.request("PATCH", f"/assets/connections/{_id(connection_id)}", json=input)
+
+    def verify(self, connection_id: str) -> dict[str, Any]:
+        return self._client.request("POST", f"/assets/connections/{_id(connection_id)}/verify")
+
+    def delete(self, connection_id: str) -> dict[str, Any]:
+        return self._client.request("DELETE", f"/assets/connections/{_id(connection_id)}")
+
+
+class AssetStorageClient:
+    def __init__(self, client: Any) -> None:
+        self._client = client
+
+    def configure(self, bucket_id: str, revision: int, input: dict[str, Any]) -> dict[str, Any]:
+        return self._client.request("PUT", f"/assets/buckets/{_id(bucket_id)}/storage",
+                                    json=input, headers={"If-Match": f'"{revision}"'})
+
+    def list_s2_buckets(self) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/s2-buckets")
+
+    def create_s2_bucket(self, input: dict[str, Any]) -> dict[str, Any]:
+        return self._client.request("POST", "/assets/s2-buckets", json=input)
+
+    def relocate(self, bucket_id: str, input: dict[str, Any] | None = None) -> dict[str, Any]:
+        return self._client.request("POST", f"/assets/buckets/{_id(bucket_id)}/relocations",
+                                    json=input or {})
+
+
+class AssetMigrationsClient:
+    def __init__(self, client: Any) -> None:
+        self._client = client
+
+    def start(self, input: dict[str, Any]) -> dict[str, Any]:
+        return self._client.request("POST", "/assets/migrations", json=input)
+
+    def list(self, limit: int | None = None) -> dict[str, Any]:
+        return self._client.request("GET", "/assets/migrations",
+                                    params={"limit": limit} if limit is not None else None)
+
+    def get(self, migration_id: str) -> dict[str, Any]:
+        return self._client.request("GET", f"/assets/migrations/{_id(migration_id)}")
+
+    def cancel(self, migration_id: str) -> dict[str, Any]:
+        return self._client.request("POST", f"/assets/migrations/{_id(migration_id)}/cancel")
+
+    def retry_item(self, migration_id: str, item_id: str) -> dict[str, Any]:
+        return self._client.request("POST", f"/assets/migrations/{_id(migration_id)}/items/{_id(item_id)}/retry")
+
+    def report(self, migration_id: str) -> dict[str, Any]:
+        return self._client.request("GET", f"/assets/migrations/{_id(migration_id)}/report",
+                                    params={"format": "json"})
+
+
+class AssetPlatformClient:
+    def __init__(self, client: Any, space_id: str = "") -> None:
+        self._client = client
+        transport = _ScopedTransport(client, space_id)
+        self.connections = AssetConnectionsClient(transport)
+        self.storage = AssetStorageClient(transport)
+        self.migrations = AssetMigrationsClient(transport)
+
+    def for_space(self, space_id: str) -> AssetPlatformClient:
+        return type(self)(self._client, space_id)

{stackshift-1.1.0 → stackshift-1.2.0}/stackshift/client.py

@@ -26,11 +26,13 @@ class StackShift:
         self.cdn_base_url = cdn_base_url.rstrip("/")
         self.session = session or requests.Session()
 
+        from .ai_credits import AICreditsClient
         from .assets import AssetsClient
         from .mail import MailClient
         from .projects import ProjectsClient
         from .workload_security import WorkloadSecurityClient
 
+        self.ai_credits = AICreditsClient(self)
         self.projects = ProjectsClient(self)
         self.assets = AssetsClient(self)
         self.mail = MailClient(self)

{stackshift-1.1.0 → stackshift-1.2.0}/stackshift.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackshift
-Version: 1.1.0
+Version: 1.2.0
 Summary: Official Python SDK for StackShift.
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -16,6 +16,27 @@ Official Python SDK for StackShift.
 pip install stackshift
 ```
 
+## AI credits
+
+AI credits are account-scoped. Use the shared client to inspect usage, start a top-up, or select managed billing versus your own provider key:
+
+```python
+from stackshift import StackShift
+
+stackshift = StackShift()
+balance = stackshift.ai_credits.balance()
+usage = stackshift.ai_credits.usage(product="assets", limit=25)
+quote = stackshift.ai_credits.quote(1_000, "USD")
+checkout = stackshift.ai_credits.checkout(
+    quote["id"],
+    "unique-checkout-id",
+    "paystack",
+)
+stackshift.ai_credits.set_funding("assets", "managed")
+```
+
+Keep account API keys and checkout creation on your server.
+
 ## Send email
 
 ```python
@@ -250,3 +271,14 @@ workspace = video.workspace(asset_id)
 Mutations carry the supplied revision in `If-Match`. Model preparation and rendering carry an idempotency key; render submission also carries the accepted maximum units. Playback renewal and events authenticate with the session credential, not the account key. Keep these clients on your backend and return grants with `Cache-Control: private, no-store`.
 
 See the [Assets SDK guide](https://docs.stackshift.cloud/assets/sdk-media-workflows) and its linked feature guides for complete language examples, inputs, permissions, review transitions and browser callbacks.
+
+## Assets storage and Cloudinary migration
+
+`sdk.assets.platform.for_space(space_id)` exposes `connections`, `storage`, and `migrations`. Use a verified Cloudinary connection, run a dry migration first, inspect its report, then start the transfer with the same folder prefix and conflict policy.
+
+```python
+platform = sdk.assets.platform.for_space(space_id)
+preview = platform.migrations.start({"source_connection_id": connection_id,
+    "destination_bucket_id": bucket_id, "source_prefix": "campaigns/2026", "dry_run": True})
+report = platform.migrations.report(preview["id"])
+```

{stackshift-1.1.0 → stackshift-1.2.0}/stackshift.egg-info/SOURCES.txt

@@ -1,9 +1,11 @@
 README.md
 pyproject.toml
 stackshift/__init__.py
+stackshift/ai_credits.py
 stackshift/assets.py
 stackshift/assets_dam.py
 stackshift/assets_media.py
+stackshift/assets_platform.py
 stackshift/assets_video.py
 stackshift/assets_workflows.py
 stackshift/client.py
@@ -26,7 +28,9 @@ stackshift.egg-info/SOURCES.txt
 stackshift.egg-info/dependency_links.txt
 stackshift.egg-info/requires.txt
 stackshift.egg-info/top_level.txt
+tests/test_ai_credits.py
 tests/test_assets_media.py
+tests/test_assets_platform.py
 tests/test_assets_workflows.py
 tests/test_mail.py
 tests/test_mail_advanced.py

stackshift-1.2.0/tests/test_ai_credits.py

@@ -0,0 +1,34 @@
+import unittest
+
+from stackshift.ai_credits import AICreditsClient
+
+
+class AICreditsClientTests(unittest.TestCase):
+    def test_account_credit_requests_preserve_checkout_and_funding_intent(self):
+        class Client:
+            def __init__(self):
+                self.calls = []
+
+            def request(self, *args, **kwargs):
+                self.calls.append((args, kwargs))
+                return {"id": "result"}
+
+        client = Client()
+        credits = AICreditsClient(client)
+        self.assertEqual(credits.balance(), {"id": "result"})
+        credits.usage(product="agents", user="user", limit=10)
+        credits.quote(1000, "USD")
+        credits.checkout("quote", "retry-key", "paystack")
+        credits.funding()
+        credits.set_funding("assets", "byok")
+
+        self.assertEqual(client.calls[0][0], ("GET", "/billing/ai-credits"))
+        self.assertEqual(client.calls[1][1]["params"]["product"], "agents")
+        self.assertEqual(client.calls[2][1]["json"], {"credits": 1000, "currency": "USD"})
+        self.assertEqual(client.calls[3][1]["json"]["idempotency_key"], "retry-key")
+        self.assertEqual(client.calls[4][0], ("GET", "/billing/ai-credits/funding"))
+        self.assertEqual(client.calls[5][1]["json"], {"product": "assets", "mode": "byok"})
+
+
+if __name__ == "__main__":
+    unittest.main()

stackshift-1.2.0/tests/test_assets_platform.py

@@ -0,0 +1,41 @@
+import json
+
+import requests
+
+from stackshift import StackShift
+
+
+class Session:
+    def __init__(self):
+        self.calls = []
+
+    def request(self, method, url, **kwargs):
+        self.calls.append((method, url, kwargs))
+        response = requests.Response()
+        response.status_code = 200
+        response._content = json.dumps({"success": True, "data": {"id": "result"}}).encode()
+        return response
+
+
+def test_connection_storage_and_migration_requests():
+    session = Session()
+    platform = StackShift(api_key="account", session=session).assets.platform
+    platform.connections.create({"provider": "cloudinary", "configuration": {"cloud_name": "demo"}})
+    method, url, options = session.calls[-1]
+    assert method == "POST" and url.endswith("/assets/connections")
+    assert options["json"]["provider"] == "cloudinary"
+    assert options["headers"]["Authorization"] == "Bearer account"
+
+    platform = platform.for_space("space-1")
+    platform.storage.configure("bucket/one", 7, {"storage_mode": "stackshift_s2"})
+    method, url, options = session.calls[-1]
+    assert method == "PUT" and url.endswith("/assets/buckets/bucket%2Fone/storage")
+    assert options["headers"]["If-Match"] == '"7"'
+    assert options["headers"]["X-Asset-Space-ID"] == "space-1"
+
+    platform.migrations.start({"destination_bucket_id": "bucket", "source_prefix": "campaign/"})
+    assert session.calls[-1][2]["json"]["source_prefix"] == "campaign/"
+    platform.migrations.report("migration/one")
+    method, url, options = session.calls[-1]
+    assert method == "GET" and url.endswith("/assets/migrations/migration%2Fone/report")
+    assert options["params"] == {"format": "json"}