sweatstack 0.92.0__tar.gz → 0.93.0__tar.gz

{sweatstack-0.92.0 → sweatstack-0.93.0}/CHANGELOG.md

@@ -6,6 +6,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [0.93.0] - 2026-10-09
+
+Issues are only about the data your app uses. Requires the SweatStack API release that adds
+`capabilities` to applications (see the platform changelog).
+
+### Changed
+
+- **BREAKING: `issue.status` is an `IssueStatus`**, `action_required` or `syncing`, on
+  `oauth.userinfo()` and `profile.status()`. The `unavailable` issues
+  (`activity_history_unavailable`, `dailies_unavailable`, `workouts_unavailable`) are gone: what
+  no connected source provides is in `capabilities`, where `unavailable` means the user could
+  still connect a source that provides it. Three new codes, each `action_required` with a
+  `destination`: `activities_blocked_upstream`, `dailies_no_source`, `workouts_no_source`. A
+  client on 0.90.0 or later accepts them without an upgrade (`StatusIssueCode` is open).
+- `ApplicationCreate.capabilities` and `ApplicationResponse.capabilities`: the capabilities an
+  app declares it uses (`list[Capability]`; omit it for the default, `activities` and
+  `activity_history`). SweatStack reports issues only for these.
+
 ## [0.92.0] - 2026-10-08
 
 Portal links are created with the user's token, when the user acts. Requires the SweatStack API

{sweatstack-0.92.0 → sweatstack-0.93.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sweatstack
-Version: 0.92.0
+Version: 0.93.0
 Summary: The official Python client for SweatStack
 Project-URL: Homepage, https://sweatstack.no
 Project-URL: Documentation, https://docs.sweatstack.no/learn/python/

{sweatstack-0.92.0 → sweatstack-0.93.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sweatstack"
-version = "0.92.0"
+version = "0.93.0"
 description = "The official Python client for SweatStack"
 readme = "README.md"
 license = "MIT"

{sweatstack-0.92.0 → sweatstack-0.93.0}/src/sweatstack/client.py

@@ -60,6 +60,7 @@ from .schemas import (
     CapabilityStatus,
     DailyMeasure,
     DailyResponse,
+    IssueStatus,
     Marker,
     Metric,
     Modifier,
@@ -1103,6 +1104,7 @@ __all__ = sorted(
         "CapabilityStatus",
         "DailyMeasure",
         "DailyResponse",
+        "IssueStatus",
         "Marker",
         "Metric",
         "Modifier",

{sweatstack-0.92.0 → sweatstack-0.93.0}/src/sweatstack/openapi_schemas.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.json
-#   timestamp: 2026-10-08T18:52:13+00:00
+#   timestamp: 2026-10-09T08:30:22+00:00
 
 from __future__ import annotations
 from open_sport_taxonomy.pydantic import SportField  # OST sport type (see schemas.py)
@@ -44,26 +44,6 @@ class AltitudeSummary(BaseModel):
     max: int | float | None = Field(None, title='Max')
 
 
-class ApplicationCreate(BaseModel):
-    name: constr(min_length=1, max_length=100) = Field(..., title='Name')
-    description: constr(max_length=500) | None = Field(None, title='Description')
-    redirect_uris: list[str] | None = Field(None, title='Redirect Uris')
-    page: str | None = Field(None, title='Page')
-    generate_secret: bool | None = Field(False, title='Generate Secret')
-
-
-class ApplicationCreateOrUpdate(BaseModel):
-    name: str = Field(..., title='Name')
-    description: str | None = Field(None, title='Description')
-    url: AnyUrl | None = Field(None, title='Url')
-    image: AnyUrl | None = Field(None, title='Image')
-    redirect_uris: list[str] | None = Field(None, title='Redirect Uris')
-    privacy_statement: AnyUrl | None = Field(None, title='Privacy Statement')
-    brand_color: str | None = Field(None, title='Brand Color')
-    webhook_endpoints: list[AnyUrl] | None = Field(None, title='Webhook Endpoints')
-    webhook_secret: SecretStr | None = Field(None, title='Webhook Secret')
-
-
 class ApplicationListItem(BaseModel):
     id: str = Field(..., title='Id')
     name: str = Field(..., title='Name')
@@ -432,6 +412,11 @@ class IntervalsIcuWebhookEventType(Enum):
     FITNESS_UPDATED = 'FITNESS_UPDATED'
 
 
+class IssueStatus(Enum):
+    action_required = 'action_required'
+    syncing = 'syncing'
+
+
 class ManagedUserCreate(BaseModel):
     first_name: str = Field(..., title='First Name')
     last_name: str | None = Field(..., title='Last Name')
@@ -619,18 +604,18 @@ class SpeedSummary(BaseModel):
 class StatusIssueCode(Enum):
     no_source_connected = 'no_source_connected'
     activities_not_granted = 'activities_not_granted'
+    activities_blocked_upstream = 'activities_blocked_upstream'
     activity_history_not_granted = 'activity_history_not_granted'
     dailies_not_granted = 'dailies_not_granted'
+    dailies_no_source = 'dailies_no_source'
     workouts_not_granted = 'workouts_not_granted'
+    workouts_no_source = 'workouts_no_source'
     sync_pending = 'sync_pending'
-    activity_history_unavailable = 'activity_history_unavailable'
-    dailies_unavailable = 'dailies_unavailable'
-    workouts_unavailable = 'workouts_unavailable'
 
 
 class StatusIssueResponse(BaseModel):
     code: StatusIssueCode
-    status: CapabilityStatus
+    status: IssueStatus
     message: str = Field(..., title='Message')
     destination: PortalDestination | None = None
 
@@ -944,6 +929,32 @@ class ActivitySummarySummary(BaseModel):
     smo2: Smo2Summary | None = None
 
 
+class ApplicationCreate(BaseModel):
+    name: constr(min_length=1, max_length=100) = Field(..., title='Name')
+    description: constr(max_length=500) | None = Field(None, title='Description')
+    redirect_uris: list[str] | None = Field(None, title='Redirect Uris')
+    capabilities: list[Capability] | None = Field(
+        None,
+        description="The capabilities your app uses: SweatStack reports account-status issues only for these (plan 075). Omit it for the default, activities and activity_history. An empty list means no issues at all. Change it later in the app's settings.",
+        title='Capabilities',
+    )
+    page: str | None = Field(None, title='Page')
+    generate_secret: bool | None = Field(False, title='Generate Secret')
+
+
+class ApplicationCreateOrUpdate(BaseModel):
+    name: str = Field(..., title='Name')
+    description: str | None = Field(None, title='Description')
+    url: AnyUrl | None = Field(None, title='Url')
+    image: AnyUrl | None = Field(None, title='Image')
+    redirect_uris: list[str] | None = Field(None, title='Redirect Uris')
+    privacy_statement: AnyUrl | None = Field(None, title='Privacy Statement')
+    brand_color: str | None = Field(None, title='Brand Color')
+    webhook_endpoints: list[AnyUrl] | None = Field(None, title='Webhook Endpoints')
+    webhook_secret: SecretStr | None = Field(None, title='Webhook Secret')
+    capabilities: list[Capability] | None = Field(None, title='Capabilities')
+
+
 class ApplicationCreateResponse(BaseModel):
     id: str = Field(..., title='Id')
     name: str = Field(..., title='Name')
@@ -959,6 +970,11 @@ class ApplicationCreateResponse(BaseModel):
         description='The App Directory is retired. Reflects the last stored listing; removed on 2026-10-12.',
         title='Published',
     )
+    capabilities: list[Capability] | None = Field(
+        None,
+        description='The capabilities this app uses. SweatStack reports account-status issues only for these. Default: activities and activity_history.',
+        title='Capabilities',
+    )
     webhook_endpoints: list[AnyUrl] | None = Field(None, title='Webhook Endpoints')
     webhook_secret: SecretStr | None = Field(None, title='Webhook Secret')
     client_secret: str | None = Field(None, title='Client Secret')

{sweatstack-0.92.0 → sweatstack-0.93.0}/src/sweatstack/resources/oauth.py

@@ -147,7 +147,8 @@ class OAuth(Resource):
         ``None`` when there is nothing to say, otherwise the one thing to tell the user now.
         ``issue.destination`` says the user can fix it in the Portal: pass it to
         ``client.portal.sessions.create()`` when they click. It is ``None`` on delegated tokens
-        and on ``syncing`` or ``unavailable`` issues, so show a button only when it is set.
+        and on ``syncing`` issues, so show a button only when it is set. Issues are reported only
+        for the capabilities your app declared it uses.
         Without the ``profile`` scope, ``client.profile.status()`` gives the same ``issue``.
 
         Returns:

{sweatstack-0.92.0 → sweatstack-0.93.0}/src/sweatstack/resources/profile.py

@@ -24,16 +24,20 @@ class Profile(Resource):
 
         **Beta**: the server documents this endpoint as beta.
 
-        ``issue`` is ``None`` when there is nothing to tell the user, otherwise
-        ``{code, status, message, destination}``. Branch on ``issue.status``
-        (:class:`CapabilityStatus`: ``ready``, ``syncing``, ``action_required``,
-        ``unavailable``), show ``issue.message``, and show a button only when
-        ``issue.destination`` is set: on click, pass it to ``client.portal.sessions.create()``.
-        Don't parse ``message`` or branch on ``code``.
+        ``issue`` is ``None`` when nothing is wrong with the data your app uses, otherwise
+        ``{code, status, message, destination}``. An issue is always temporary: ``issue.status``
+        is ``action_required`` (the user can fix it) or ``syncing`` (the data is arriving), never
+        a third value. Show ``issue.message``, and show a button only when ``issue.destination``
+        is set: on click, pass it to ``client.portal.sessions.create()``. Don't parse
+        ``message`` or branch on ``code``. Issues are reported only for the capabilities your app
+        declared it uses (its settings; the default is activities and activity history).
 
         ``capabilities`` maps each :class:`Capability` (``activities``, ``activity_history``,
-        ``dailies``, ``workouts``) to a :class:`CapabilityStatus`. Codes and capability keys are
-        open sets: a value the client doesn't know parses as a pseudo-member; ignore it.
+        ``dailies``, ``workouts``) to a :class:`CapabilityStatus` (``ready``, ``syncing``,
+        ``action_required``, ``unavailable``): facts about the user's connected sources, the
+        same for every app. ``unavailable`` means no connected source provides it, which
+        changes when the user connects one that does. Codes and capability keys are open sets:
+        a value the client doesn't know parses as a pseudo-member; ignore it.
 
         Accepts a token with ``data:read`` or ``profile``. Delegated tokens are allowed and
         always get ``destination=None``.

{sweatstack-0.92.0 → sweatstack-0.93.0}/src/sweatstack/schemas.py

@@ -30,6 +30,7 @@ from .openapi_schemas import (
     CapabilityStatus,
     DailyMeasure,
     DailyResponse,
+    IssueStatus,
     Marker,
     Metric,
     PortalDestination,

{sweatstack-0.92.0 → sweatstack-0.93.0}/tests/test_account_status.py

@@ -1,8 +1,9 @@
 """Account status: ``userinfo.issue`` and ``GET /api/v1/profile/status``.
 
-The fixtures are the five payloads the public docs prescribe for mocking
+The fixtures are the six payloads the public docs prescribe for mocking
 ("Why does this user have no data?"), verbatim, so these tests pin the SDK to
-the documented contract rather than to our reading of it.
+the documented contract rather than to our reading of it. An issue is always
+temporary: ``action_required`` or ``syncing``, never ``unavailable`` (plan 075).
 """
 
 from unittest.mock import MagicMock, patch
@@ -16,6 +17,7 @@ from sweatstack import (
     AccountStatusResponse,
     Capability,
     CapabilityStatus,
+    IssueStatus,
     PortalDestination,
     StatusIssueCode,
     StatusIssueResponse,
@@ -50,12 +52,20 @@ DOCS_PAYLOADS = {
             "destination": "manage-integrations",
         }
     },
-    "permanently_limited": {
+    "blocked_upstream": {
         "issue": {
-            "code": "dailies_unavailable",
-            "status": "unavailable",
+            "code": "activities_blocked_upstream",
+            "status": "action_required",
+            "message": "Intervals.icu can't pass on activities that come from Strava.",
+            "destination": "manage-integrations",
+        }
+    },
+    "no_source": {
+        "issue": {
+            "code": "dailies_no_source",
+            "status": "action_required",
             "message": "No connected source provides daily health data.",
-            "destination": None,
+            "destination": "manage-integrations",
         }
     },
     "all_good": {"issue": None},
@@ -108,7 +118,7 @@ class TestDocumentedPayloads:
             assert user.issue is None
         else:
             assert isinstance(user.issue, StatusIssueResponse)
-            assert user.issue.status == CapabilityStatus(payload["issue"]["status"])
+            assert user.issue.status == IssueStatus(payload["issue"]["status"])
             assert user.issue.code == StatusIssueCode(payload["issue"]["code"])
             assert user.issue.message == payload["issue"]["message"]
             expected = payload["issue"]["destination"]

{sweatstack-0.92.0 → sweatstack-0.93.0}/uv.lock

@@ -2748,7 +2748,7 @@ wheels = [
 
 [[package]]
 name = "sweatstack"
-version = "0.92.0"
+version = "0.93.0"
 source = { editable = "." }
 dependencies = [
     { name = "email-validator" },