growsurf-python 1.16.0__tar.gz → 1.18.0__tar.gz

growsurf_python-1.18.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.18.0"
+}

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [1.18.0](https://github.com/growsurf/growsurf-python/compare/v1.17.0...v1.18.0) (2026-11-03)
+
+
+### Features
+
+* remove account create method (endpoint retired) ([0a464f2](https://github.com/growsurf/growsurf-python/commit/0a464f2e5d7bcb644d333545907b1847117936a2))
+* remove account create method (endpoint retired) ([7a60066](https://github.com/growsurf/growsurf-python/commit/7a60066f82a98eb1715fd457c76a7e1dc63bd386))
+
+## [1.17.0](https://github.com/growsurf/growsurf-python/compare/v1.16.0...v1.17.0) (2026-11-03)
+
+
+### Features
+
+* add Tint and Glass program styles ([a975c13](https://github.com/growsurf/growsurf-python/commit/a975c13b267bf97ff9d57f26673f92bc29642b35))
+* **api:** add languages.flagCountries to Campaign Options ([d5663f0](https://github.com/growsurf/growsurf-python/commit/d5663f08a9fa3e4ec421a90af9b4491ba4eb6dc4))
+* **api:** sync REST v2 contract changes ([2a0e777](https://github.com/growsurf/growsurf-python/commit/2a0e7778a0bdddadbdfe7b55c225723d2c813d02))
+* expose documented error-body fields and sync campaign and participant models ([65db348](https://github.com/growsurf/growsurf-python/commit/65db34829db847313e17757832f6d8f2324535ba))
+* expose program visual style in campaign design ([0d93f91](https://github.com/growsurf/growsurf-python/commit/0d93f917180557f492016acc623cf449962b7120))
+
+
+### Bug Fixes
+
+* **deps:** bump aiohttp to 3.14.5 and certifi to 2026.10.23 for security advisories ([c9640ee](https://github.com/growsurf/growsurf-python/commit/c9640eeb58f96838f52b3b24f2168a24b5402e74))
+
+
+### Documentation
+
+* clarify Add Participant claim-offer wording and page title defaults ([5fc74e8](https://github.com/growsurf/growsurf-python/commit/5fc74e8666defb009a7870ee20701c0ce8ca0506))
+* clarify referral reward metadata amounts ([1bf9897](https://github.com/growsurf/growsurf-python/commit/1bf9897e437a67f4c912fcec24f234d24ebbf155))
+* correct default program style ([4f6bbd5](https://github.com/growsurf/growsurf-python/commit/4f6bbd5425ceb84889d14ddd70b0e2653ef94f04))
+
 ## [1.16.0](https://github.com/growsurf/growsurf-python/compare/v1.15.1...v1.16.0) (2026-10-19)
 
 

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: growsurf-python
-Version: 1.16.0
+Version: 1.18.0
 Summary: The official Python library for the growsurf API
 Project-URL: Homepage, https://growsurf.com/
 Project-URL: Repository, https://github.com/growsurf/growsurf-python

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/api.md

@@ -1,17 +1,3 @@
-# Account
-
-Types:
-
-```python
-from growsurf.types import (
-    CreateAccountResponse,
-)
-```
-
-Methods:
-
-- <code title="post /accounts">client.account.<a href="./src/growsurf/resources/account.py">create</a>(\*\*<a href="src/growsurf/types/account_create_params.py">params</a>) -> <a href="./src/growsurf/types/create_account_response.py">CreateAccountResponse</a></code>
-
 # Team
 
 Types:
@@ -287,3 +273,22 @@ Methods:
 
 - <code title="get /campaign/{id}/installation">client.campaign.installation.<a href="./src/growsurf/resources/campaign/installation.py">retrieve</a>(id) -> <a href="./src/growsurf/types/campaign/campaign_installation.py">CampaignInstallation</a></code>
 - <code title="patch /campaign/{id}/installation">client.campaign.installation.<a href="./src/growsurf/resources/campaign/installation.py">update</a>(id, \*, body) -> <a href="./src/growsurf/types/campaign/campaign_installation.py">CampaignInstallation</a></code>
+
+## CustomDomain
+
+Types:
+
+```python
+from growsurf.types.campaign import (
+    CampaignCustomDomain,
+    CampaignCustomDomainDNSRecord,
+    DeleteCampaignCustomDomainResponse,
+)
+```
+
+Methods:
+
+- <code title="get /campaign/{id}/custom-domain">client.campaign.custom_domain.<a href="./src/growsurf/resources/campaign/custom_domain.py">retrieve</a>(id) -> <a href="./src/growsurf/types/campaign/campaign_custom_domain.py">CampaignCustomDomain</a></code>
+- <code title="put /campaign/{id}/custom-domain">client.campaign.custom_domain.<a href="./src/growsurf/resources/campaign/custom_domain.py">set</a>(id, \*\*<a href="src/growsurf/types/campaign/custom_domain_set_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/campaign_custom_domain.py">CampaignCustomDomain</a></code>
+- <code title="post /campaign/{id}/custom-domain/verify">client.campaign.custom_domain.<a href="./src/growsurf/resources/campaign/custom_domain.py">verify</a>(id) -> <a href="./src/growsurf/types/campaign/campaign_custom_domain.py">CampaignCustomDomain</a></code>
+- <code title="delete /campaign/{id}/custom-domain">client.campaign.custom_domain.<a href="./src/growsurf/resources/campaign/custom_domain.py">delete</a>(id) -> <a href="./src/growsurf/types/campaign/delete_campaign_custom_domain_response.py">DeleteCampaignCustomDomainResponse</a></code>

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "growsurf-python"
-version = "1.16.0"
+version = "1.18.0"
 description = "The official Python library for the growsurf API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/requirements-dev.lock

@@ -9,7 +9,7 @@ anyio==4.15.1
     #   httpx
 backports-asyncio-runner==1.2.0 ; python_full_version < '3.11'
     # via pytest-asyncio
-certifi==2026.1.4
+certifi==2026.10.23
     # via
     #   httpcore
     #   httpx

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/src/growsurf/_client.py

@@ -36,9 +36,8 @@ from ._base_client import (
 )
 
 if TYPE_CHECKING:
-    from .resources import team, account, campaign
+    from .resources import team, campaign
     from .resources.team import TeamResource, AsyncTeamResource
-    from .resources.account import AccountResource, AsyncAccountResource
     from .resources.campaign.campaign import CampaignResource, AsyncCampaignResource
 
 __all__ = [
@@ -116,12 +115,6 @@ class Growsurf(SyncAPIClient):
         )
         self._idempotency_header = "Idempotency-Key"
 
-    @cached_property
-    def account(self) -> AccountResource:
-        from .resources.account import AccountResource
-
-        return AccountResource(self)
-
     @cached_property
     def team(self) -> TeamResource:
         from .resources.team import TeamResource
@@ -319,12 +312,6 @@ class AsyncGrowsurf(AsyncAPIClient):
         )
         self._idempotency_header = "Idempotency-Key"
 
-    @cached_property
-    def account(self) -> AsyncAccountResource:
-        from .resources.account import AsyncAccountResource
-
-        return AsyncAccountResource(self)
-
     @cached_property
     def team(self) -> AsyncTeamResource:
         from .resources.team import AsyncTeamResource
@@ -465,12 +452,6 @@ class GrowsurfWithRawResponse:
     def __init__(self, client: Growsurf) -> None:
         self._client = client
 
-    @cached_property
-    def account(self) -> account.AccountResourceWithRawResponse:
-        from .resources.account import AccountResourceWithRawResponse
-
-        return AccountResourceWithRawResponse(self._client.account)
-
     @cached_property
     def team(self) -> team.TeamResourceWithRawResponse:
         from .resources.team import TeamResourceWithRawResponse
@@ -490,12 +471,6 @@ class AsyncGrowsurfWithRawResponse:
     def __init__(self, client: AsyncGrowsurf) -> None:
         self._client = client
 
-    @cached_property
-    def account(self) -> account.AsyncAccountResourceWithRawResponse:
-        from .resources.account import AsyncAccountResourceWithRawResponse
-
-        return AsyncAccountResourceWithRawResponse(self._client.account)
-
     @cached_property
     def team(self) -> team.AsyncTeamResourceWithRawResponse:
         from .resources.team import AsyncTeamResourceWithRawResponse
@@ -515,12 +490,6 @@ class GrowsurfWithStreamedResponse:
     def __init__(self, client: Growsurf) -> None:
         self._client = client
 
-    @cached_property
-    def account(self) -> account.AccountResourceWithStreamingResponse:
-        from .resources.account import AccountResourceWithStreamingResponse
-
-        return AccountResourceWithStreamingResponse(self._client.account)
-
     @cached_property
     def team(self) -> team.TeamResourceWithStreamingResponse:
         from .resources.team import TeamResourceWithStreamingResponse
@@ -540,12 +509,6 @@ class AsyncGrowsurfWithStreamedResponse:
     def __init__(self, client: AsyncGrowsurf) -> None:
         self._client = client
 
-    @cached_property
-    def account(self) -> account.AsyncAccountResourceWithStreamingResponse:
-        from .resources.account import AsyncAccountResourceWithStreamingResponse
-
-        return AsyncAccountResourceWithStreamingResponse(self._client.account)
-
     @cached_property
     def team(self) -> team.AsyncTeamResourceWithStreamingResponse:
         from .resources.team import AsyncTeamResourceWithStreamingResponse

growsurf_python-1.18.0/src/growsurf/_exceptions.py

@@ -0,0 +1,199 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, cast
+from typing_extensions import Literal
+
+import httpx
+
+__all__ = [
+    "BadRequestError",
+    "AuthenticationError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "ConflictError",
+    "UnprocessableEntityError",
+    "RateLimitError",
+    "InternalServerError",
+]
+
+
+class GrowsurfError(Exception):
+    pass
+
+
+class APIError(GrowsurfError):
+    message: str
+    request: httpx.Request
+
+    body: object | None
+    """The API response body.
+
+    If the API responded with a valid JSON structure then this property will be the
+    decoded result.
+
+    If it isn't a valid JSON structure then this will be the raw response.
+
+    If there was no response associated with this error then it will be `None`.
+    """
+
+    def __init__(self, message: str, request: httpx.Request, *, body: object | None) -> None:  # noqa: ARG002
+        super().__init__(message)
+        self.request = request
+        self.message = message
+        self.body = body
+
+
+class APIResponseValidationError(APIError):
+    response: httpx.Response
+    status_code: int
+
+    def __init__(self, response: httpx.Response, body: object | None, *, message: str | None = None) -> None:
+        super().__init__(message or "Data returned by API invalid for expected schema.", response.request, body=body)
+        self.response = response
+        self.status_code = response.status_code
+
+
+class APIStatusError(APIError):
+    """Raised when an API response has a status code of 4xx or 5xx."""
+
+    response: httpx.Response
+    status_code: int
+
+    # Documented error-body fields. Each is `None` when the body omits it or sends another
+    # type; `body` keeps the complete response body, including fields added later.
+    error_name: str | None
+    """Error name returned for the failed request."""
+
+    error_code: str | None
+    """Stable machine-readable error code."""
+
+    error_message: str | None
+    """Human-readable error message."""
+
+    errors: List[Dict[str, object]] | None
+    """Optional validation details for specific request fields."""
+
+    support_url: str | None
+    """Support URL related to the error, when available."""
+
+    policy_name: str | None
+    """Rate-limit policy name for `429` errors, when available."""
+
+    level: str | None
+    """Error severity level, when available."""
+
+    timestamp: str | None
+    """When the error response was created."""
+
+    fraud_risk_level: str | None
+    """Fraud risk level assigned to the blocked signup."""
+
+    fraud_reason_code: str | None
+    """Machine-readable reason code for the fraud decision."""
+
+    matched_participant_ids: List[str] | None
+    """Existing participant IDs related to the fraud match."""
+
+    email: str | None
+    """Email address from the blocked signup attempt."""
+
+    referrer_id: str | None
+    """Referrer participant ID supplied with the blocked signup, or `null`."""
+
+    ip_address: str | None
+    """IP address supplied with the blocked signup, or `null`."""
+
+    fingerprint: str | None
+    """Browser fingerprint supplied with the blocked signup, or `null`."""
+
+    blocked_at: str | None
+    """When the signup was blocked."""
+
+    def __init__(self, message: str, *, response: httpx.Response, body: object | None) -> None:
+        super().__init__(message, response.request, body=body)
+        self.response = response
+        self.status_code = response.status_code
+
+        fields = cast(Dict[str, object], body) if isinstance(body, dict) else {}
+        self.error_name = _str_or_none(fields.get("name"))
+        self.error_code = _str_or_none(fields.get("code"))
+        self.error_message = _str_or_none(fields.get("message"))
+        self.errors = _record_list_or_none(fields.get("errors"))
+        self.support_url = _str_or_none(fields.get("supportUrl"))
+        self.policy_name = _str_or_none(fields.get("policyName"))
+        self.level = _str_or_none(fields.get("level"))
+        self.timestamp = _str_or_none(fields.get("timestamp"))
+        self.fraud_risk_level = _str_or_none(fields.get("fraudRiskLevel"))
+        self.fraud_reason_code = _str_or_none(fields.get("fraudReasonCode"))
+        self.matched_participant_ids = _str_list_or_none(fields.get("matchedParticipantIds"))
+        self.email = _str_or_none(fields.get("email"))
+        self.referrer_id = _str_or_none(fields.get("referrerId"))
+        self.ip_address = _str_or_none(fields.get("ipAddress"))
+        self.fingerprint = _str_or_none(fields.get("fingerprint"))
+        self.blocked_at = _str_or_none(fields.get("blockedAt"))
+
+
+class APIConnectionError(APIError):
+    def __init__(self, *, message: str = "Connection error.", request: httpx.Request) -> None:
+        super().__init__(message, request, body=None)
+
+
+class APITimeoutError(APIConnectionError):
+    def __init__(self, request: httpx.Request) -> None:
+        super().__init__(message="Request timed out.", request=request)
+
+
+class BadRequestError(APIStatusError):
+    status_code: Literal[400] = 400  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class AuthenticationError(APIStatusError):
+    status_code: Literal[401] = 401  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class PermissionDeniedError(APIStatusError):
+    status_code: Literal[403] = 403  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class NotFoundError(APIStatusError):
+    status_code: Literal[404] = 404  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class ConflictError(APIStatusError):
+    status_code: Literal[409] = 409  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class UnprocessableEntityError(APIStatusError):
+    status_code: Literal[422] = 422  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class RateLimitError(APIStatusError):
+    status_code: Literal[429] = 429  # pyright: ignore[reportIncompatibleVariableOverride]
+
+
+class InternalServerError(APIStatusError):
+    pass
+
+
+def _str_or_none(value: object) -> str | None:
+    return value if isinstance(value, str) else None
+
+
+def _str_list_or_none(value: object) -> List[str] | None:
+    if not isinstance(value, list):
+        return None
+    items = cast(List[object], value)
+    if not all(isinstance(item, str) for item in items):
+        return None
+    return cast(List[str], items)
+
+
+def _record_list_or_none(value: object) -> List[Dict[str, object]] | None:
+    if not isinstance(value, list):
+        return None
+    items = cast(List[object], value)
+    if not all(isinstance(item, dict) for item in items):
+        return None
+    return cast(List[Dict[str, object]], items)

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/src/growsurf/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "growsurf"
-__version__ = "1.16.0"  # x-release-please-version
+__version__ = "1.18.0"  # x-release-please-version

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/src/growsurf/resources/__init__.py

@@ -8,14 +8,6 @@ from .team import (
     TeamResourceWithStreamingResponse,
     AsyncTeamResourceWithStreamingResponse,
 )
-from .account import (
-    AccountResource,
-    AsyncAccountResource,
-    AccountResourceWithRawResponse,
-    AsyncAccountResourceWithRawResponse,
-    AccountResourceWithStreamingResponse,
-    AsyncAccountResourceWithStreamingResponse,
-)
 from .campaign import (
     CampaignResource,
     AsyncCampaignResource,
@@ -26,12 +18,6 @@ from .campaign import (
 )
 
 __all__ = [
-    "AccountResource",
-    "AsyncAccountResource",
-    "AccountResourceWithRawResponse",
-    "AsyncAccountResourceWithRawResponse",
-    "AccountResourceWithStreamingResponse",
-    "AsyncAccountResourceWithStreamingResponse",
     "TeamResource",
     "AsyncTeamResource",
     "TeamResourceWithRawResponse",

{growsurf_python-1.16.0 → growsurf_python-1.18.0}/src/growsurf/resources/campaign/__init__.py

@@ -88,6 +88,14 @@ from .integrations import (
     IntegrationsResourceWithStreamingResponse,
     AsyncIntegrationsResourceWithStreamingResponse,
 )
+from .custom_domain import (
+    CustomDomainResource,
+    AsyncCustomDomainResource,
+    CustomDomainResourceWithRawResponse,
+    AsyncCustomDomainResourceWithRawResponse,
+    CustomDomainResourceWithStreamingResponse,
+    AsyncCustomDomainResourceWithStreamingResponse,
+)
 from .program_resources import (
     ProgramResourcesResource,
     AsyncProgramResourcesResource,
@@ -158,6 +166,12 @@ __all__ = [
     "AsyncInstallationResourceWithRawResponse",
     "InstallationResourceWithStreamingResponse",
     "AsyncInstallationResourceWithStreamingResponse",
+    "CustomDomainResource",
+    "AsyncCustomDomainResource",
+    "CustomDomainResourceWithRawResponse",
+    "AsyncCustomDomainResourceWithRawResponse",
+    "CustomDomainResourceWithStreamingResponse",
+    "AsyncCustomDomainResourceWithStreamingResponse",
     "CommissionResource",
     "AsyncCommissionResource",
     "CommissionResourceWithRawResponse",