sweatstack 0.45.0__tar.gz → 0.47.0__tar.gz

{sweatstack-0.45.0 → sweatstack-0.47.0}/CHANGELOG.md

@@ -6,6 +6,22 @@ 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.47.0] - 2025-08-07
+
+### Added
+
+- Added a new `ss.get_backfill_status()` method that returns the current backfill status from the activities backfill-status endpoint.
+- Added a new `ss.watch_backfill_status()` method that watches the backfill status from the activities backfill-status endpoint.
+
+
+## [0.46.0] - 2025-08-01
+
+### Added
+
+- Added a new `registered_at` field to the `UserInfoResponse` model that is returned by `ss.get_userinfo()`. This field is the timestamp of the user's registration with SweatStack.
+
+
+
 ## [0.45.0] - 2025-06-24
 
 ### Added

{sweatstack-0.45.0 → sweatstack-0.47.0}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.4
 Name: sweatstack
-Version: 0.45.0
+Version: 0.47.0
 Summary: The official Python client for SweatStack
 Author-email: Aart Goossens <aart@gssns.io>
 Requires-Python: >=3.9
+Requires-Dist: email-validator>=2.2.0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: pandas>=2.2.3
 Requires-Dist: platformdirs>=4.0.0

{sweatstack-0.45.0 → sweatstack-0.47.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sweatstack"
-version = "0.45.0"
+version = "0.47.0"
 description = "The official Python client for SweatStack"
 readme = "README.md"
 authors = [
@@ -8,6 +8,7 @@ authors = [
 ]
 requires-python = ">=3.9"
 dependencies = [
+    "email-validator>=2.2.0",
     "httpx>=0.28.1",
     "pandas>=2.2.3",
     "platformdirs>=4.0.0",

{sweatstack-0.45.0 → sweatstack-0.47.0}/src/sweatstack/client.py

@@ -16,7 +16,7 @@ from http.server import BaseHTTPRequestHandler, HTTPServer
 from importlib.metadata import version
 from io import BytesIO
 from pathlib import Path
-from typing import Any, Generator, get_type_hints, List, Literal
+from typing import Any, Dict, Generator, get_type_hints, List, Literal
 from urllib.parse import parse_qs, urlparse
 
 import httpx
@@ -25,7 +25,8 @@ from platformdirs import user_data_dir
 
 from .constants import DEFAULT_URL
 from .schemas import (
-    ActivityDetails, ActivitySummary, Metric, Sport, TraceDetails, UserInfoResponse, UserSummary
+    ActivityDetails, ActivitySummary, BackfillStatus, Metric, Sport,
+    TraceDetails, UserInfoResponse, UserSummary
 )
 from .utils import decode_jwt_body, make_dataframe_streamlit_compatible
 
@@ -1230,6 +1231,67 @@ class Client(OAuth2Mixin, DelegationMixin, TokenStorageMixin):
 
         return self._get_user_by_id(user_id)
 
+    def _parse_backfill_line(self, line: str) -> BackfillStatus | None:
+        """Parse a single NDJSON line from backfill status stream."""
+        try:
+            return BackfillStatus.model_validate_json(line)
+        except Exception:
+            pass
+        return None
+
+    def watch_backfill_status(self, *, auto_reconnect: bool = False) -> Generator[BackfillStatus, None, None]:
+        """Watches backfill status from the activities backfill-status endpoint.
+
+        This method connects to the backfill status event stream and yields
+        backfill_loaded_until timestamps as they are received. The connection
+        automatically closes after 60 seconds, but can be configured to auto-reconnect.
+
+        Args:
+            auto_reconnect: Whether to automatically reconnect when the connection
+                closes and continue receiving updates. Defaults to False.
+
+        Yields:
+            BackfillStatus: A BackfillStatus object for each received message.
+
+        Raises:
+            HTTPStatusError: If the API request fails.
+        """
+        while True:
+            try:
+                with self._http_client() as client:
+                    with client.stream("GET", "/api/v1/activities/backfill-status") as response:
+                        self._raise_for_status(response)
+
+                        for line in response.iter_lines():
+                            if line.strip():
+                                parsed = self._parse_backfill_line(line)
+                                if parsed:
+                                    yield parsed
+
+            except httpx.RequestError:
+                if not auto_reconnect:
+                    raise
+                time.sleep(1)
+            if not auto_reconnect:
+                break
+
+    def get_backfill_status(self) -> BackfillStatus:
+        """Gets the current backfill status from the activities backfill-status endpoint.
+
+        This method connects to the backfill status event stream and returns
+        the first backfill_loaded_until timestamp received.
+
+        Returns:
+            BackfillStatus: A BackfillStatus object containing the current backfill status.
+
+        Raises:
+            HTTPStatusError: If the API request fails.
+            ValueError: If no status message is received.
+        """
+        for status in self.watch_backfill_status(auto_reconnect=False):
+            return status
+        raise ValueError("No backfill status received")
+
 
 _default_client = Client()
 
@@ -1276,6 +1338,9 @@ _generate_singleton_methods(
         "get_userinfo",
         "whoami",
 
+        "get_backfill_status",
+        "watch_backfill_status",
+
         "get_activities",
 
         "get_activity",

{sweatstack-0.45.0 → sweatstack-0.47.0}/src/sweatstack/openapi_schemas.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.json
-#   timestamp: 2025-04-15T12:24:50+00:00
+#   timestamp: 2025-08-07T11:42:52+00:00
 
 from __future__ import annotations
 
@@ -8,19 +8,50 @@ from datetime import datetime, timedelta
 from enum import Enum
 from typing import List, Literal, Optional, Union
 
-from pydantic import AnyUrl, BaseModel, Field, SecretStr, confloat, conint
+from pydantic import (
+    AnyUrl,
+    BaseModel,
+    EmailStr,
+    Field,
+    RootModel,
+    SecretStr,
+    confloat,
+    conint,
+)
+
+
+class Activity(BaseModel):
+    id: str = Field(..., title='Id')
+    start_date_local: datetime = Field(..., title='Start Date Local')
 
 
 class ActivityUpdate(BaseModel):
     tags: Optional[List[str]] = Field(None, title='Tags')
 
 
+class Prompt(Enum):
+    none = 'none'
+    login = 'login'
+    consent = 'consent'
+    select_account = 'select_account'
+
+
+class BackfillStatus(BaseModel):
+    backfill_loaded_until: Optional[datetime] = Field(
+        ..., title='Backfill Loaded Until'
+    )
+
+
+class BodyAddEmailPartialsAddEmailPost(BaseModel):
+    email: EmailStr = Field(..., title='Email')
+
+
 class BodyCreateApplicationApplicationsPost(BaseModel):
     name: str = Field(..., title='Name')
     description: str = Field(..., title='Description')
     url: AnyUrl = Field(..., title='Url')
     image: AnyUrl = Field(..., title='Image')
-    redirect_uris: List[AnyUrl] = Field(..., title='Redirect Uris')
+    redirect_uris: List[str] = Field(..., title='Redirect Uris')
     privacy_statement: AnyUrl = Field(..., title='Privacy Statement')
     published: Optional[bool] = Field(False, title='Published')
 
@@ -133,6 +164,7 @@ class Tz(Enum):
     America_Coral_Harbour = 'America/Coral_Harbour'
     America_Cordoba = 'America/Cordoba'
     America_Costa_Rica = 'America/Costa_Rica'
+    America_Coyhaique = 'America/Coyhaique'
     America_Creston = 'America/Creston'
     America_Cuiaba = 'America/Cuiaba'
     America_Curacao = 'America/Curacao'
@@ -635,13 +667,14 @@ class Tz(Enum):
 
 
 class BodyLoginPostLoginPost(BaseModel):
-    email: str = Field(..., title='Email')
+    email: EmailStr = Field(..., title='Email')
     password: SecretStr = Field(..., title='Password')
     tz: Tz = Field(..., title='Tz')
+    state: Optional[str] = Field(None, title='State')
 
 
 class BodyRegisterPostRegisterPost(BaseModel):
-    email: str = Field(..., title='Email')
+    email: EmailStr = Field(..., title='Email')
     password: SecretStr = Field(..., title='Password')
     tz: Tz = Field(..., title='Tz')
 
@@ -654,12 +687,17 @@ class BodySaveOrUpdateIntegrationProviderTenantsTenantIdIntegrationProvidersInte
     redirect_url: str = Field(..., title='Redirect Url')
 
 
+class BodySendVerificationEmailPartialsSendVerificationEmailPost(BaseModel):
+    email: EmailStr = Field(..., title='Email')
+    tz: Tz = Field(..., title='Tz')
+
+
 class BodyUpdateApplicationApplicationsApplicationIdPut(BaseModel):
     name: str = Field(..., title='Name')
     description: str = Field(..., title='Description')
     url: AnyUrl = Field(..., title='Url')
     image: AnyUrl = Field(..., title='Image')
-    redirect_uris: List[AnyUrl] = Field(..., title='Redirect Uris')
+    redirect_uris: List[str] = Field(..., title='Redirect Uris')
     privacy_statement: AnyUrl = Field(..., title='Privacy Statement')
     published: Optional[bool] = Field(False, title='Published')
 
@@ -669,6 +707,10 @@ class BodyUpdateUserUsersUserIdPut(BaseModel):
     last_name: str = Field(..., title='Last Name')
 
 
+class BodyUploadActivityFileApiV1ActivitiesUploadPost(BaseModel):
+    files: List[bytes] = Field(..., max_length=10, title='Files')
+
+
 class BodyUploadActivityFileDataUploadPost(BaseModel):
     files: List[bytes] = Field(..., title='Files')
 
@@ -690,6 +732,13 @@ class ElevationSummary(BaseModel):
     max: Optional[int] = Field(None, title='Max')
 
 
+class GarminBackfillBody(BaseModel):
+    start: datetime = Field(..., title='Start')
+    end: datetime = Field(..., title='End')
+    user_id__in: Optional[List[str]] = Field(None, title='User Id  In')
+    user_id__not_in: Optional[List[str]] = Field(None, title='User Id  Not In')
+
+
 class GarminDeregistration(BaseModel):
     userId: str = Field(..., title='Userid')
     userAccessToken: str = Field(..., title='Useraccesstoken')
@@ -718,8 +767,33 @@ class HeartRateSummary(BaseModel):
     end: Optional[float] = Field(None, title='End')
 
 
+class Instruction(BaseModel):
+    type: Literal['instruction'] = Field('instruction', title='Type')
+    text: str = Field(..., title='Text')
+
+
 class IntegrationName(Enum):
     garmin_connect = 'garmin_connect'
+    intervals_icu = 'intervals_icu'
+
+
+class IntensityQuantity(Enum):
+    speed = 'speed'
+    power = 'power'
+
+
+class IntervalsIcuWebhookEventType(Enum):
+    APP_SCOPE_CHANGED = 'APP_SCOPE_CHANGED'
+    CALENDAR_UPDATED = 'CALENDAR_UPDATED'
+    CALENDAR_EVENT_UPDATED = 'CALENDAR_EVENT_UPDATED'
+    CALENDAR_EVENT_DELETED = 'CALENDAR_EVENT_DELETED'
+    ACTIVITY_UPLOADED = 'ACTIVITY_UPLOADED'
+    ACTIVITY_ANALYZED = 'ACTIVITY_ANALYZED'
+    ACTIVITY_UPDATED = 'ACTIVITY_UPDATED'
+    ACTIVITY_DELETED = 'ACTIVITY_DELETED'
+    ACTIVITY_ACHIEVEMENTS = 'ACTIVITY_ACHIEVEMENTS'
+    WELLNESS_UPDATED = 'WELLNESS_UPDATED'
+    FITNESS_UPDATED = 'FITNESS_UPDATED'
 
 
 class Metric(Enum):
@@ -748,6 +822,16 @@ class PowerSummary(BaseModel):
     max: Optional[float] = Field(None, title='Max')
 
 
+class Reference(Enum):
+    absolute = 'absolute'
+    tte = 'tte'
+    parameter = 'parameter'
+
+
+class RepeatQuantity(Enum):
+    number = 'number'
+
+
 class Scope(Enum):
     data_read = 'data:read'
     data_write = 'data:write'
@@ -819,6 +903,22 @@ class TemperatureSummary(BaseModel):
     max: Optional[float] = Field(None, title='Max')
 
 
+class TemplateDay(BaseModel):
+    sports: List[Sport] = Field(..., title='Sports')
+    avg_training_duration: timedelta = Field(..., title='Avg Training Duration')
+    typical_training_duration: timedelta = Field(..., title='Typical Training Duration')
+
+
+class TemplateWeekResponse(BaseModel):
+    monday: TemplateDay
+    tuesday: TemplateDay
+    wednesday: TemplateDay
+    thursday: TemplateDay
+    friday: TemplateDay
+    saturday: TemplateDay
+    sunday: TemplateDay
+
+
 class TokenRequest(BaseModel):
     grant_type: GrantType
     client_id: Optional[str] = Field(None, title='Client Id')
@@ -850,11 +950,18 @@ class TraceCreateOrUpdate(BaseModel):
     sport: Optional[Sport] = None
 
 
+class UserFlow(Enum):
+    session = 'session'
+    signup = 'signup'
+    login = 'login'
+
+
 class UserInfoResponse(BaseModel):
     sub: str = Field(..., title='Sub')
     given_name: Optional[str] = Field(None, title='Given Name')
     family_name: Optional[str] = Field(None, title='Family Name')
     email: Optional[str] = Field(None, title='Email')
+    registered_at: datetime = Field(..., title='Registered At')
     name: str = Field(..., title='Name')
 
 
@@ -872,6 +979,17 @@ class ValidationError(BaseModel):
     type: str = Field(..., title='Error Type')
 
 
+class Value(BaseModel):
+    reference: Reference
+    value: Union[int, float] = Field(..., title='Value')
+    parameter: Optional[str] = Field(None, title='Parameter')
+
+
+class VolumeQuantity(Enum):
+    duration = 'duration'
+    distance = 'distance'
+
+
 class ActivitySummarySummary(BaseModel):
     power: Optional[PowerSummary] = None
     speed: Optional[SpeedSummary] = None
@@ -883,6 +1001,18 @@ class ActivitySummarySummary(BaseModel):
     smo2: Optional[Smo2Summary] = None
 
 
+class AuthorizeQueryParams(BaseModel):
+    client_id: str = Field(..., title='Client Id')
+    redirect_uri: Optional[str] = Field(None, title='Redirect Uri')
+    scope: List[Scope] = Field(..., min_length=1, title='Scope')
+    state: Optional[str] = Field(None, title='State')
+    nonce: Optional[str] = Field(None, title='Nonce')
+    code_challenge: Optional[str] = Field(None, title='Code Challenge')
+    code_challenge_method: Optional[str] = Field(None, title='Code Challenge Method')
+    prompt: Optional[Prompt] = Field('consent', title='Prompt')
+    user_flow: Optional[UserFlow] = 'session'
+
+
 class BodyAuthorizeOauthAuthorizePost(BaseModel):
     client_id: str = Field(..., title='Client Id')
     redirect_uri: Optional[str] = Field(None, title='Redirect Uri')
@@ -893,10 +1023,32 @@ class BodyAuthorizeOauthAuthorizePost(BaseModel):
     code_challenge_method: Optional[str] = Field(None, title='Code Challenge Method')
 
 
+class BodyExpressAddEmailPostExpressAddEmailPost(BaseModel):
+    email: EmailStr = Field(..., title='Email')
+    state: Optional[str] = Field(None, title='State')
+    user_flow: Optional[UserFlow] = 'session'
+
+
 class BodyGenerateApiKeyPartialsGenerateApiKeyPost(BaseModel):
     scopes: List[Scope] = Field(..., title='Scopes')
 
 
+class ConstantValueInput(BaseModel):
+    type: Literal['constant'] = Field('constant', title='Type')
+    quantity: Union[VolumeQuantity, IntensityQuantity, RepeatQuantity] = Field(
+        ..., title='Quantity'
+    )
+    value: Value
+
+
+class ConstantValueOutput(BaseModel):
+    type: Literal['constant'] = Field('constant', title='Type')
+    quantity: Union[VolumeQuantity, IntensityQuantity, RepeatQuantity] = Field(
+        ..., title='Quantity'
+    )
+    value: Value
+
+
 class DelegatedTokenRequest(BaseModel):
     sub: str = Field(..., title='Sub')
     scopes: Optional[List[Scope]] = Field(None, title='Scopes')
@@ -922,6 +1074,13 @@ class HTTPValidationError(BaseModel):
     detail: Optional[List[ValidationError]] = Field(None, title='Detail')
 
 
+class IntervalsIcuWebhookEvent(BaseModel):
+    athlete_id: str = Field(..., title='Athlete Id')
+    type: IntervalsIcuWebhookEventType
+    timestamp: datetime = Field(..., title='Timestamp')
+    activity: Activity
+
+
 class Lap(BaseModel):
     power: Optional[PowerSummary] = None
     speed: Optional[SpeedSummary] = None
@@ -938,6 +1097,155 @@ class Lap(BaseModel):
     end_local: datetime = Field(..., title='End Local')
 
 
+class RampValueInput(BaseModel):
+    type: Literal['ramp'] = Field('ramp', title='Type')
+    quantity: Union[VolumeQuantity, IntensityQuantity, RepeatQuantity] = Field(
+        ..., title='Quantity'
+    )
+    start: Value
+    end: Value
+
+
+class RampValueOutput(BaseModel):
+    type: Literal['ramp'] = Field('ramp', title='Type')
+    quantity: Union[VolumeQuantity, IntensityQuantity, RepeatQuantity] = Field(
+        ..., title='Quantity'
+    )
+    start: Value
+    end: Value
+
+
+class RangeValueInput(BaseModel):
+    type: Literal['range'] = Field('range', title='Type')
+    quantity: Union[VolumeQuantity, IntensityQuantity, RepeatQuantity] = Field(
+        ..., title='Quantity'
+    )
+    min: Optional[Value] = None
+    max: Optional[Value] = None
+
+
+class RangeValueOutput(BaseModel):
+    type: Literal['range'] = Field('range', title='Type')
+    quantity: Union[VolumeQuantity, IntensityQuantity, RepeatQuantity] = Field(
+        ..., title='Quantity'
+    )
+    min: Optional[Value] = None
+    max: Optional[Value] = None
+
+
+class IntervalInput(BaseModel):
+    type: Literal['interval'] = Field('interval', title='Type')
+    volume: Union[ConstantValueInput, RangeValueInput, RampValueInput] = Field(
+        ..., discriminator='type', title='Volume'
+    )
+    intensity: Union[ConstantValueInput, RangeValueInput, RampValueInput] = Field(
+        ..., discriminator='type', title='Intensity'
+    )
+
+
+class IntervalOutput(BaseModel):
+    type: Literal['interval'] = Field('interval', title='Type')
+    volume: Union[ConstantValueOutput, RangeValueOutput, RampValueOutput] = Field(
+        ..., discriminator='type', title='Volume'
+    )
+    intensity: Union[ConstantValueOutput, RangeValueOutput, RampValueOutput] = Field(
+        ..., discriminator='type', title='Intensity'
+    )
+
+
+class IntervalsIcuWebhookBody(BaseModel):
+    secret: str = Field(..., title='Secret')
+    events: List[IntervalsIcuWebhookEvent] = Field(..., title='Events')
+
+
+class RepeatInput(BaseModel):
+    type: Literal['repeat'] = Field(..., title='Type')
+    count: Union[ConstantValueInput, RangeValueInput] = Field(
+        ..., discriminator='type', title='Count'
+    )
+    content: List[Union[IntervalInput, RepeatInput, Instruction]] = Field(
+        ..., title='Content'
+    )
+
+
+class RepeatOutput(BaseModel):
+    type: Literal['repeat'] = Field(..., title='Type')
+    count: Union[ConstantValueOutput, RangeValueOutput] = Field(
+        ..., discriminator='type', title='Count'
+    )
+    content: List[Union[IntervalOutput, RepeatOutput, Instruction]] = Field(
+        ..., title='Content'
+    )
+
+
+class SectionInput(BaseModel):
+    type: Literal['section'] = Field('section', title='Type')
+    name: Optional[str] = Field(..., title='Name')
+    content: List[Union[IntervalInput, RepeatInput, Instruction]] = Field(
+        ..., title='Content'
+    )
+
+
+class SectionOutput(BaseModel):
+    type: Literal['section'] = Field('section', title='Type')
+    name: Optional[str] = Field(..., title='Name')
+    content: List[Union[IntervalOutput, RepeatOutput, Instruction]] = Field(
+        ..., title='Content'
+    )
+
+
+class Content(RootModel[Union[IntervalInput, RepeatInput, SectionInput, Instruction]]):
+    root: Union[IntervalInput, RepeatInput, SectionInput, Instruction] = Field(
+        ..., discriminator='type'
+    )
+
+
+class WorkoutInput(BaseModel):
+    version: Optional[str] = Field('0.1.0', title='Version')
+    title: Optional[str] = Field(None, title='Title')
+    description: Optional[str] = Field(None, title='Description')
+    content: List[Content] = Field(..., title='Content')
+
+
+class Content1(
+    RootModel[Union[IntervalOutput, RepeatOutput, SectionOutput, Instruction]]
+):
+    root: Union[IntervalOutput, RepeatOutput, SectionOutput, Instruction] = Field(
+        ..., discriminator='type'
+    )
+
+
+class WorkoutOutput(BaseModel):
+    version: Optional[str] = Field('0.1.0', title='Version')
+    title: Optional[str] = Field(None, title='Title')
+    description: Optional[str] = Field(None, title='Description')
+    content: List[Content1] = Field(..., title='Content')
+
+
+class LibraryWorkoutCreate(BaseModel):
+    swf: WorkoutInput
+    sport: Sport
+
+
+class LibraryWorkoutResponse(BaseModel):
+    id: str = Field(..., title='Id')
+    swf: WorkoutOutput
+    sport: Sport
+
+
+class ScheduledWorkoutCreate(BaseModel):
+    swf: WorkoutInput
+    sport: Sport
+    start: datetime = Field(..., title='Start')
+
+
+class ScheduledWorkoutResponse(BaseModel):
+    id: str = Field(..., title='Id')
+    swf: WorkoutOutput
+    sport: Sport
+    start: Optional[datetime] = Field(..., title='Start')
+
+
 class ActivityDetails(BaseModel):
     tags: Optional[List[str]] = Field(None, title='Tags')
     id: str = Field(..., title='Id')
@@ -987,5 +1295,7 @@ class TraceDetails(BaseModel):
     timestamp_local: datetime = Field(..., title='Timestamp Local')
 
 
+RepeatInput.model_rebuild()
+RepeatOutput.model_rebuild()
 ActivityDetails.model_rebuild()
 ActivitySummary.model_rebuild()

{sweatstack-0.45.0 → sweatstack-0.47.0}/src/sweatstack/schemas.py

@@ -2,7 +2,7 @@ from enum import Enum
 from typing import List, Union
 
 from .openapi_schemas import (
-    ActivityDetails, ActivitySummary, Metric, Scope, Sport,
+    ActivityDetails, ActivitySummary, BackfillStatus, Metric, Scope, Sport,
     TraceDetails, UserInfoResponse, UserSummary
 )