growsurf-python 0.2.0__tar.gz → 0.4.0__tar.gz

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

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

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.4.0 (2026-05-20)
+
+Full Changelog: [v0.3.0...v0.4.0](https://github.com/growsurf/growsurf-python/compare/v0.3.0...v0.4.0)
+
+### Features
+
+* **api:** Add Participant.mobileInstanceId ([0dc8db9](https://github.com/growsurf/growsurf-python/commit/0dc8db9d24e075b782975aaa5236281fb8d4c5fd))
+
+## 0.3.0 (2026-05-19)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/growsurf/growsurf-python/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** manual updates ([fa106aa](https://github.com/growsurf/growsurf-python/commit/fa106aacec6012c1edd197e17f39bd05fb0396ec))
+
 ## 0.2.0 (2026-05-15)
 
 Full Changelog: [v0.1.1...v0.2.0](https://github.com/growsurf/growsurf-python/compare/v0.1.1...v0.2.0)

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/PKG-INFO

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

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/api.md

@@ -11,6 +11,7 @@ from growsurf.types import (
     ParticipantPayoutList,
     ReferralList,
     CampaignListResponse,
+    CampaignCreateMobileParticipantTokenResponse,
     CampaignRetrieveAnalyticsResponse,
 )
 ```
@@ -19,6 +20,7 @@ Methods:
 
 - <code title="get /campaign/{id}">client.campaign.<a href="./src/growsurf/resources/campaign/campaign.py">retrieve</a>(id) -> <a href="./src/growsurf/types/campaign/campaign.py">Campaign</a></code>
 - <code title="get /campaigns">client.campaign.<a href="./src/growsurf/resources/campaign/campaign.py">list</a>() -> <a href="./src/growsurf/types/campaign_list_response.py">CampaignListResponse</a></code>
+- <code title="post /campaign/{id}/mobile-participant-token">client.campaign.<a href="./src/growsurf/resources/campaign/campaign.py">create_mobile_participant_token</a>(id, \*\*<a href="src/growsurf/types/campaign_create_mobile_participant_token_params.py">params</a>) -> <a href="./src/growsurf/types/campaign_create_mobile_participant_token_response.py">CampaignCreateMobileParticipantTokenResponse</a></code>
 - <code title="get /campaign/{id}/commissions">client.campaign.<a href="./src/growsurf/resources/campaign/campaign.py">list_commissions</a>(id, \*\*<a href="src/growsurf/types/campaign_list_commissions_params.py">params</a>) -> <a href="./src/growsurf/types/participant_commission_list.py">ParticipantCommissionList</a></code>
 - <code title="get /campaign/{id}/leaderboard">client.campaign.<a href="./src/growsurf/resources/campaign/campaign.py">list_leaderboard</a>(id, \*\*<a href="src/growsurf/types/campaign_list_leaderboard_params.py">params</a>) -> <a href="./src/growsurf/types/participant_list.py">ParticipantList</a></code>
 - <code title="get /campaign/{id}/participants">client.campaign.<a href="./src/growsurf/resources/campaign/campaign.py">list_participants</a>(id, \*\*<a href="src/growsurf/types/campaign_list_participants_params.py">params</a>) -> <a href="./src/growsurf/types/participant_list.py">ParticipantList</a></code>
@@ -32,13 +34,13 @@ Types:
 
 ```python
 from growsurf.types.campaign import (
+    Create,
     FraudRiskLevel,
     Participant,
     ParticipantReward,
     ReferralSource,
     ReferralStatus,
     ParticipantDeleteResponse,
-    ParticipantCreateMobileTokenResponse,
     ParticipantListRewardsResponse,
     ParticipantRecordTransactionResponse,
     ParticipantSendInvitesResponse,
@@ -52,7 +54,6 @@ Methods:
 - <code title="post /campaign/{id}/participant/{participantIdOrEmail}">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">update</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_update_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/participant.py">Participant</a></code>
 - <code title="delete /campaign/{id}/participant/{participantIdOrEmail}">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">delete</a>(participant_id_or_email, \*, id) -> <a href="./src/growsurf/types/campaign/participant_delete_response.py">ParticipantDeleteResponse</a></code>
 - <code title="post /campaign/{id}/participant">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">add</a>(id, \*\*<a href="src/growsurf/types/campaign/participant_add_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/participant.py">Participant</a></code>
-- <code title="post /campaign/{id}/participant/{participantIdOrEmail}/mobile-token">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">create_mobile_token</a>(participant_id_or_email, \*, id) -> <a href="./src/growsurf/types/campaign/participant_create_mobile_token_response.py">ParticipantCreateMobileTokenResponse</a></code>
 - <code title="get /campaign/{id}/participant/{participantIdOrEmail}/commissions">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">list_commissions</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_list_commissions_params.py">params</a>) -> <a href="./src/growsurf/types/participant_commission_list.py">ParticipantCommissionList</a></code>
 - <code title="get /campaign/{id}/participant/{participantIdOrEmail}/payouts">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">list_payouts</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_list_payouts_params.py">params</a>) -> <a href="./src/growsurf/types/participant_payout_list.py">ParticipantPayoutList</a></code>
 - <code title="get /campaign/{id}/participant/{participantIdOrEmail}/referrals">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">list_referrals</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_list_referrals_params.py">params</a>) -> <a href="./src/growsurf/types/referral_list.py">ReferralList</a></code>

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/pyproject.toml

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

{growsurf_python-0.2.0 → growsurf_python-0.4.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__ = "0.2.0"  # x-release-please-version
+__version__ = "0.4.0"  # x-release-please-version

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/src/growsurf/resources/campaign/campaign.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from typing import Dict
 from typing_extensions import Literal
 
 import httpx
@@ -21,6 +22,7 @@ from ...types import (
     campaign_list_leaderboard_params,
     campaign_list_participants_params,
     campaign_retrieve_analytics_params,
+    campaign_create_mobile_participant_token_params,
 )
 from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ..._utils import path_template, maybe_transform, async_maybe_transform
@@ -58,6 +60,7 @@ from ...types.participant_payout_list import ParticipantPayoutList
 from ...types.campaign.referral_status import ReferralStatus
 from ...types.participant_commission_list import ParticipantCommissionList
 from ...types.campaign_retrieve_analytics_response import CampaignRetrieveAnalyticsResponse
+from ...types.campaign_create_mobile_participant_token_response import CampaignCreateMobileParticipantTokenResponse
 
 __all__ = ["CampaignResource", "AsyncCampaignResource"]
 
@@ -148,6 +151,72 @@ class CampaignResource(SyncAPIResource):
             cast_to=CampaignListResponse,
         )
 
+    def create_mobile_participant_token(
+        self,
+        id: str,
+        *,
+        email: str,
+        fingerprint: str | Omit = omit,
+        first_name: str | Omit = omit,
+        ip_address: str | Omit = omit,
+        last_name: str | Omit = omit,
+        metadata: Dict[str, object] | Omit = omit,
+        mobile_instance_id: str | Omit = omit,
+        referral_status: Literal["CREDIT_PENDING", "CREDIT_AWARDED"] | Omit = omit,
+        referred_by: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> CampaignCreateMobileParticipantTokenResponse:
+        """
+        Creates or returns a participant using the same input behavior as Add
+        Participant, then returns a participant-scoped token for GrowSurf mobile SDK
+        participant endpoints. Use this endpoint from your backend after your mobile app
+        authenticates a signed-in user. The program must have mobile SDK access enabled.
+
+        Args:
+          metadata: Shallow custom metadata object.
+
+          mobile_instance_id: Optional app-install scoped identifier for native mobile anti-fraud. Recommended
+              for mobile participant creation and mobile participant token flows.
+
+          referred_by: Referrer participant ID or email address.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            path_template("/campaign/{id}/mobile-participant-token", id=id),
+            body=maybe_transform(
+                {
+                    "email": email,
+                    "fingerprint": fingerprint,
+                    "first_name": first_name,
+                    "ip_address": ip_address,
+                    "last_name": last_name,
+                    "metadata": metadata,
+                    "mobile_instance_id": mobile_instance_id,
+                    "referral_status": referral_status,
+                    "referred_by": referred_by,
+                },
+                campaign_create_mobile_participant_token_params.CampaignCreateMobileParticipantTokenParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=CampaignCreateMobileParticipantTokenResponse,
+        )
+
     def list_commissions(
         self,
         id: str,
@@ -592,6 +661,72 @@ class AsyncCampaignResource(AsyncAPIResource):
             cast_to=CampaignListResponse,
         )
 
+    async def create_mobile_participant_token(
+        self,
+        id: str,
+        *,
+        email: str,
+        fingerprint: str | Omit = omit,
+        first_name: str | Omit = omit,
+        ip_address: str | Omit = omit,
+        last_name: str | Omit = omit,
+        metadata: Dict[str, object] | Omit = omit,
+        mobile_instance_id: str | Omit = omit,
+        referral_status: Literal["CREDIT_PENDING", "CREDIT_AWARDED"] | Omit = omit,
+        referred_by: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> CampaignCreateMobileParticipantTokenResponse:
+        """
+        Creates or returns a participant using the same input behavior as Add
+        Participant, then returns a participant-scoped token for GrowSurf mobile SDK
+        participant endpoints. Use this endpoint from your backend after your mobile app
+        authenticates a signed-in user. The program must have mobile SDK access enabled.
+
+        Args:
+          metadata: Shallow custom metadata object.
+
+          mobile_instance_id: Optional app-install scoped identifier for native mobile anti-fraud. Recommended
+              for mobile participant creation and mobile participant token flows.
+
+          referred_by: Referrer participant ID or email address.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            path_template("/campaign/{id}/mobile-participant-token", id=id),
+            body=await async_maybe_transform(
+                {
+                    "email": email,
+                    "fingerprint": fingerprint,
+                    "first_name": first_name,
+                    "ip_address": ip_address,
+                    "last_name": last_name,
+                    "metadata": metadata,
+                    "mobile_instance_id": mobile_instance_id,
+                    "referral_status": referral_status,
+                    "referred_by": referred_by,
+                },
+                campaign_create_mobile_participant_token_params.CampaignCreateMobileParticipantTokenParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=CampaignCreateMobileParticipantTokenResponse,
+        )
+
     async def list_commissions(
         self,
         id: str,
@@ -960,6 +1095,9 @@ class CampaignResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             campaign.list,
         )
+        self.create_mobile_participant_token = to_raw_response_wrapper(
+            campaign.create_mobile_participant_token,
+        )
         self.list_commissions = to_raw_response_wrapper(
             campaign.list_commissions,
         )
@@ -1004,6 +1142,9 @@ class AsyncCampaignResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             campaign.list,
         )
+        self.create_mobile_participant_token = async_to_raw_response_wrapper(
+            campaign.create_mobile_participant_token,
+        )
         self.list_commissions = async_to_raw_response_wrapper(
             campaign.list_commissions,
         )
@@ -1048,6 +1189,9 @@ class CampaignResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             campaign.list,
         )
+        self.create_mobile_participant_token = to_streamed_response_wrapper(
+            campaign.create_mobile_participant_token,
+        )
         self.list_commissions = to_streamed_response_wrapper(
             campaign.list_commissions,
         )
@@ -1092,6 +1236,9 @@ class AsyncCampaignResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             campaign.list,
         )
+        self.create_mobile_participant_token = async_to_streamed_response_wrapper(
+            campaign.create_mobile_participant_token,
+        )
         self.list_commissions = async_to_streamed_response_wrapper(
             campaign.list_commissions,
         )

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/src/growsurf/resources/campaign/participant.py

@@ -39,7 +39,6 @@ from ...types.campaign.participant_list_rewards_response import ParticipantListR
 from ...types.campaign.participant_send_invites_response import ParticipantSendInvitesResponse
 from ...types.campaign.participant_trigger_referral_response import ParticipantTriggerReferralResponse
 from ...types.campaign.participant_record_transaction_response import ParticipantRecordTransactionResponse
-from ...types.campaign.participant_create_mobile_token_response import ParticipantCreateMobileTokenResponse
 
 __all__ = ["ParticipantResource", "AsyncParticipantResource"]
 
@@ -223,6 +222,7 @@ class ParticipantResource(SyncAPIResource):
         ip_address: str | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
+        mobile_instance_id: str | Omit = omit,
         referral_status: Literal["CREDIT_PENDING", "CREDIT_AWARDED"] | Omit = omit,
         referred_by: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -240,6 +240,9 @@ class ParticipantResource(SyncAPIResource):
         Args:
           metadata: Shallow custom metadata object.
 
+          mobile_instance_id: Optional app-install scoped identifier for native mobile anti-fraud. Recommended
+              for mobile participant creation and mobile participant token flows.
+
           referred_by: Referrer participant ID or email address.
 
           extra_headers: Send extra headers
@@ -262,6 +265,7 @@ class ParticipantResource(SyncAPIResource):
                     "ip_address": ip_address,
                     "last_name": last_name,
                     "metadata": metadata,
+                    "mobile_instance_id": mobile_instance_id,
                     "referral_status": referral_status,
                     "referred_by": referred_by,
                 },
@@ -273,50 +277,6 @@ class ParticipantResource(SyncAPIResource):
             cast_to=Participant,
         )
 
-    def create_mobile_token(
-        self,
-        participant_id_or_email: str,
-        *,
-        id: str,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> ParticipantCreateMobileTokenResponse:
-        """Creates a participant-scoped token for GrowSurf mobile SDK participant
-        endpoints.
-
-        The program must have mobile SDK access enabled.
-
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        if not participant_id_or_email:
-            raise ValueError(
-                f"Expected a non-empty value for `participant_id_or_email` but received {participant_id_or_email!r}"
-            )
-        return self._post(
-            path_template(
-                "/campaign/{id}/participant/{participant_id_or_email}/mobile-token",
-                id=id,
-                participant_id_or_email=participant_id_or_email,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=ParticipantCreateMobileTokenResponse,
-        )
-
     def list_commissions(
         self,
         participant_id_or_email: str,
@@ -961,6 +921,7 @@ class AsyncParticipantResource(AsyncAPIResource):
         ip_address: str | Omit = omit,
         last_name: str | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
+        mobile_instance_id: str | Omit = omit,
         referral_status: Literal["CREDIT_PENDING", "CREDIT_AWARDED"] | Omit = omit,
         referred_by: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -978,6 +939,9 @@ class AsyncParticipantResource(AsyncAPIResource):
         Args:
           metadata: Shallow custom metadata object.
 
+          mobile_instance_id: Optional app-install scoped identifier for native mobile anti-fraud. Recommended
+              for mobile participant creation and mobile participant token flows.
+
           referred_by: Referrer participant ID or email address.
 
           extra_headers: Send extra headers
@@ -1000,6 +964,7 @@ class AsyncParticipantResource(AsyncAPIResource):
                     "ip_address": ip_address,
                     "last_name": last_name,
                     "metadata": metadata,
+                    "mobile_instance_id": mobile_instance_id,
                     "referral_status": referral_status,
                     "referred_by": referred_by,
                 },
@@ -1011,50 +976,6 @@ class AsyncParticipantResource(AsyncAPIResource):
             cast_to=Participant,
         )
 
-    async def create_mobile_token(
-        self,
-        participant_id_or_email: str,
-        *,
-        id: str,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> ParticipantCreateMobileTokenResponse:
-        """Creates a participant-scoped token for GrowSurf mobile SDK participant
-        endpoints.
-
-        The program must have mobile SDK access enabled.
-
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        if not participant_id_or_email:
-            raise ValueError(
-                f"Expected a non-empty value for `participant_id_or_email` but received {participant_id_or_email!r}"
-            )
-        return await self._post(
-            path_template(
-                "/campaign/{id}/participant/{participant_id_or_email}/mobile-token",
-                id=id,
-                participant_id_or_email=participant_id_or_email,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=ParticipantCreateMobileTokenResponse,
-        )
-
     async def list_commissions(
         self,
         participant_id_or_email: str,
@@ -1536,9 +1457,6 @@ class ParticipantResourceWithRawResponse:
         self.add = to_raw_response_wrapper(
             participant.add,
         )
-        self.create_mobile_token = to_raw_response_wrapper(
-            participant.create_mobile_token,
-        )
         self.list_commissions = to_raw_response_wrapper(
             participant.list_commissions,
         )
@@ -1578,9 +1496,6 @@ class AsyncParticipantResourceWithRawResponse:
         self.add = async_to_raw_response_wrapper(
             participant.add,
         )
-        self.create_mobile_token = async_to_raw_response_wrapper(
-            participant.create_mobile_token,
-        )
         self.list_commissions = async_to_raw_response_wrapper(
             participant.list_commissions,
         )
@@ -1620,9 +1535,6 @@ class ParticipantResourceWithStreamingResponse:
         self.add = to_streamed_response_wrapper(
             participant.add,
         )
-        self.create_mobile_token = to_streamed_response_wrapper(
-            participant.create_mobile_token,
-        )
         self.list_commissions = to_streamed_response_wrapper(
             participant.list_commissions,
         )
@@ -1662,9 +1574,6 @@ class AsyncParticipantResourceWithStreamingResponse:
         self.add = async_to_streamed_response_wrapper(
             participant.add,
         )
-        self.create_mobile_token = async_to_streamed_response_wrapper(
-            participant.create_mobile_token,
-        )
         self.list_commissions = async_to_streamed_response_wrapper(
             participant.list_commissions,
         )

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/src/growsurf/types/__init__.py

@@ -16,3 +16,9 @@ from .campaign_list_leaderboard_params import CampaignListLeaderboardParams as C
 from .campaign_list_participants_params import CampaignListParticipantsParams as CampaignListParticipantsParams
 from .campaign_retrieve_analytics_params import CampaignRetrieveAnalyticsParams as CampaignRetrieveAnalyticsParams
 from .campaign_retrieve_analytics_response import CampaignRetrieveAnalyticsResponse as CampaignRetrieveAnalyticsResponse
+from .campaign_create_mobile_participant_token_params import (
+    CampaignCreateMobileParticipantTokenParams as CampaignCreateMobileParticipantTokenParams,
+)
+from .campaign_create_mobile_participant_token_response import (
+    CampaignCreateMobileParticipantTokenResponse as CampaignCreateMobileParticipantTokenResponse,
+)

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/src/growsurf/types/campaign/__init__.py

@@ -33,6 +33,3 @@ from .participant_trigger_referral_response import (
 from .participant_record_transaction_response import (
     ParticipantRecordTransactionResponse as ParticipantRecordTransactionResponse,
 )
-from .participant_create_mobile_token_response import (
-    ParticipantCreateMobileTokenResponse as ParticipantCreateMobileTokenResponse,
-)

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/src/growsurf/types/campaign/participant.py

@@ -114,6 +114,12 @@ class Participant(BaseModel):
     metadata: Optional[Dict[str, object]] = None
     """Shallow custom metadata object."""
 
+    mobile_instance_id: Optional[str] = FieldInfo(alias="mobileInstanceId", default=None)
+    """
+    App-install scoped mobile identifier used for anti-fraud matching when provided
+    by native mobile apps. Not stored when strict GDPR/CCPA mode is enabled.
+    """
+
     monthly_referrals: Optional[List[str]] = FieldInfo(alias="monthlyReferrals", default=None)
 
     notes: Optional[str] = None

{growsurf_python-0.2.0 → growsurf_python-0.4.0}/src/growsurf/types/campaign/participant_add_params.py

@@ -24,6 +24,12 @@ class ParticipantAddParams(TypedDict, total=False):
     metadata: Dict[str, object]
     """Shallow custom metadata object."""
 
+    mobile_instance_id: Annotated[str, PropertyInfo(alias="mobileInstanceId")]
+    """Optional app-install scoped identifier for native mobile anti-fraud.
+
+    Recommended for mobile participant creation and mobile participant token flows.
+    """
+
     referral_status: Annotated[Literal["CREDIT_PENDING", "CREDIT_AWARDED"], PropertyInfo(alias="referralStatus")]
 
     referred_by: Annotated[str, PropertyInfo(alias="referredBy")]

growsurf_python-0.4.0/src/growsurf/types/campaign_create_mobile_participant_token_params.py

@@ -0,0 +1,36 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["CampaignCreateMobileParticipantTokenParams"]
+
+
+class CampaignCreateMobileParticipantTokenParams(TypedDict, total=False):
+    email: Required[str]
+
+    fingerprint: str
+
+    first_name: Annotated[str, PropertyInfo(alias="firstName")]
+
+    ip_address: Annotated[str, PropertyInfo(alias="ipAddress")]
+
+    last_name: Annotated[str, PropertyInfo(alias="lastName")]
+
+    metadata: Dict[str, object]
+    """Shallow custom metadata object."""
+
+    mobile_instance_id: Annotated[str, PropertyInfo(alias="mobileInstanceId")]
+    """Optional app-install scoped identifier for native mobile anti-fraud.
+
+    Recommended for mobile participant creation and mobile participant token flows.
+    """
+
+    referral_status: Annotated[Literal["CREDIT_PENDING", "CREDIT_AWARDED"], PropertyInfo(alias="referralStatus")]
+
+    referred_by: Annotated[str, PropertyInfo(alias="referredBy")]
+    """Referrer participant ID or email address."""

growsurf_python-0.4.0/src/growsurf/types/campaign_create_mobile_participant_token_response.py

@@ -0,0 +1,24 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+from .campaign.participant import Participant
+
+__all__ = ["CampaignCreateMobileParticipantTokenResponse"]
+
+
+class CampaignCreateMobileParticipantTokenResponse(BaseModel):
+    expires_in: int = FieldInfo(alias="expiresIn")
+    """Token lifetime in seconds."""
+
+    is_new: bool = FieldInfo(alias="isNew")
+    """Whether this request created a new participant.
+
+    Returns false when the participant already existed.
+    """
+
+    participant: Participant
+
+    participant_token: str = FieldInfo(alias="participantToken")
+    """Participant-scoped bearer token for GrowSurf mobile SDK participant endpoints."""