growsurf-python 0.0.2__py3-none-any.whl → 0.1.0__py3-none-any.whl

growsurf/_files.py

@@ -99,7 +99,7 @@ async def async_to_httpx_files(files: RequestFiles | None) -> HttpxRequestFiles
     elif is_sequence_t(files):
         files = [(key, await _async_transform_file(file)) for key, file in files]
     else:
-        raise TypeError("Unexpected file type input {type(files)}, expected mapping or sequence")
+        raise TypeError(f"Unexpected file type input {type(files)}, expected mapping or sequence")
 
     return files
 

growsurf/_models.py

@@ -25,7 +25,9 @@ from typing_extensions import (
     ClassVar,
     Protocol,
     Required,
+    Annotated,
     ParamSpec,
+    TypeAlias,
     TypedDict,
     TypeGuard,
     final,
@@ -79,7 +81,15 @@ from ._compat import (
 from ._constants import RAW_RESPONSE_HEADER
 
 if TYPE_CHECKING:
+    from pydantic import GetCoreSchemaHandler, ValidatorFunctionWrapHandler
+    from pydantic_core import CoreSchema, core_schema
     from pydantic_core.core_schema import ModelField, ModelSchema, LiteralSchema, ModelFieldsSchema
+else:
+    try:
+        from pydantic_core import CoreSchema, core_schema
+    except ImportError:
+        CoreSchema = None
+        core_schema = None
 
 __all__ = ["BaseModel", "GenericModel"]
 
@@ -396,6 +406,76 @@ class BaseModel(pydantic.BaseModel):
             )
 
 
+class _EagerIterable(list[_T], Generic[_T]):
+    """
+    Accepts any Iterable[T] input (including generators), consumes it
+    eagerly, and validates all items upfront.
+
+    Validation preserves the original container type where possible
+    (e.g. a set[T] stays a set[T]).  Serialization (model_dump / JSON)
+    always emits a list — round-tripping through model_dump() will not
+    restore the original container type.
+    """
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        source_type: Any,
+        handler: GetCoreSchemaHandler,
+    ) -> CoreSchema:
+        (item_type,) = get_args(source_type) or (Any,)
+        item_schema: CoreSchema = handler.generate_schema(item_type)
+        list_of_items_schema: CoreSchema = core_schema.list_schema(item_schema)
+
+        return core_schema.no_info_wrap_validator_function(
+            cls._validate,
+            list_of_items_schema,
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                cls._serialize,
+                info_arg=False,
+            ),
+        )
+
+    @staticmethod
+    def _validate(v: Iterable[_T], handler: "ValidatorFunctionWrapHandler") -> Any:
+        original_type: type[Any] = type(v)
+
+        # Normalize to list so list_schema can validate each item
+        if isinstance(v, list):
+            items: list[_T] = v
+        else:
+            try:
+                items = list(v)
+            except TypeError as e:
+                raise TypeError("Value is not iterable") from e
+
+        # Validate items against the inner schema
+        validated: list[_T] = handler(items)
+
+        # Reconstruct original container type
+        if original_type is list:
+            return validated
+        # str(list) produces the list's repr, not a string built from items,
+        # so skip reconstruction for str and its subclasses.
+        if issubclass(original_type, str):
+            return validated
+        try:
+            return original_type(validated)
+        except (TypeError, ValueError):
+            # If the type cannot be reconstructed, just return the validated list
+            return validated
+
+    @staticmethod
+    def _serialize(v: Iterable[_T]) -> list[_T]:
+        """Always serialize as a list so Pydantic's JSON encoder is happy."""
+        if isinstance(v, list):
+            return v
+        return list(v)
+
+
+EagerIterable: TypeAlias = Annotated[Iterable[_T], _EagerIterable]
+
+
 def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if value is None:
         return field_get_default(field)

growsurf/_version.py

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

growsurf/resources/campaign/participant.py

@@ -39,6 +39,7 @@ 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"]
 
@@ -272,6 +273,50 @@ 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,
@@ -966,6 +1011,50 @@ 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,
@@ -1447,6 +1536,9 @@ 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,
         )
@@ -1486,6 +1578,9 @@ 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,
         )
@@ -1525,6 +1620,9 @@ 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,
         )
@@ -1564,6 +1662,9 @@ 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/types/campaign/__init__.py

@@ -33,3 +33,6 @@ 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/types/campaign/participant_create_mobile_token_response.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["ParticipantCreateMobileTokenResponse"]
+
+
+class ParticipantCreateMobileTokenResponse(BaseModel):
+    expires_in: int = FieldInfo(alias="expiresIn")
+    """Token lifetime in seconds."""
+
+    participant_token: str = FieldInfo(alias="participantToken")
+    """Participant-scoped bearer token for GrowSurf mobile SDK participant endpoints."""

{growsurf_python-0.0.2.dist-info → growsurf_python-0.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: growsurf-python
-Version: 0.0.2
+Version: 0.1.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.0.2.dist-info → growsurf_python-0.1.0.dist-info}/RECORD

@@ -4,14 +4,14 @@ growsurf/_client.py,sha256=Iu6ABJ4B21yJ0QRE0RwjEJbFQN2wdc3d3JXY5J7kUqw,17638
 growsurf/_compat.py,sha256=_9guQfzYnL3DNtudX5W7T2cdSskx89B5AFfhPQDxMUk,6811
 growsurf/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
 growsurf/_exceptions.py,sha256=3bEzw4WDc3VYTMnwkiOucauRjS8Vhr3L0Qb02P0ZKaE,3224
-growsurf/_files.py,sha256=GsGgJfC6PEiO0d4ItFBMQlBrK8LLNpTaBdHa7T3EMDE,5452
-growsurf/_models.py,sha256=tYTwrY0cUy4ED2Z5fUEl2JegX-yVTYHxr-pv5DjjEYQ,32269
+growsurf/_files.py,sha256=SVYqNE1L-wYm1GciyF95BCJGC1gsWAqvXvSyos-_rNo,5453
+growsurf/_models.py,sha256=s_NXt8o1OMGsQilB4EliLxkFGZCWdrSiy5HJ0T2NZEo,35012
 growsurf/_qs.py,sha256=ZSfQv6arGBBoWlcy60zK1zmPE2Ije0i8kzKdnoxWUjU,4833
 growsurf/_resource.py,sha256=oeDA0FL2ottIchoUi86M_8eUqmtrGQLYTgfKYEzrsWg,1112
 growsurf/_response.py,sha256=RTZ8t27W4S6ExkCjzCg4HbcDUTCdOMgiheiMAuAxgu4,28937
 growsurf/_streaming.py,sha256=9aJ_V6JtddntWCon2Cq_MOLMnySnhc7wuqeZx7sUtKU,10558
 growsurf/_types.py,sha256=r8hAVihrutiLUToaJhSDys9T9sMc8BMy2qUrr3W_8Wo,7751
-growsurf/_version.py,sha256=4Sru0Bqk98PXjpRL1QFG7tmJWNpQhO20HB8OW031gek,160
+growsurf/_version.py,sha256=1YB5RjbPw4Mk7vcoe4ToN0ismIbh1P7vP2iPuCXhZbs,160
 growsurf/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 growsurf/_utils/__init__.py,sha256=nQq-iFa5YxTaWySaLigatew5rHgTR0M75FNYm4mrO1s,2313
 growsurf/_utils/_compat.py,sha256=33246eDcl3pwL6kWsEhVuT4Akrd8gZEW9LPTm465ohk,1231
@@ -32,7 +32,7 @@ growsurf/resources/__init__.py,sha256=xfEkuLlMZ7ZMm_bcpbd5XKNGLBo9xEvNVGX6EHH0g-
 growsurf/resources/campaign/__init__.py,sha256=3k4V-N7TZLU1xJunA-760I62BQ1elIddwlLf_OtWQUQ,2045
 growsurf/resources/campaign/campaign.py,sha256=4r9je07cVILuvR0uxXnB1HlVr-G-u2Pt5HLdcOGKsWQ,43126
 growsurf/resources/campaign/commission.py,sha256=K5HmznRM7nO-VNiP2Jy1rIeW63rAx1Aa2M9DEJ9dB2I,10294
-growsurf/resources/campaign/participant.py,sha256=OTrmsJs8HtQUe3WQ5uuWj5-SoTPeNTY1duBQDT7oF6Q,63882
+growsurf/resources/campaign/participant.py,sha256=3U7wNhTy48-HjMdmiMGg8EL_G8U5uNsH8OQVqXX56Zg,68164
 growsurf/resources/campaign/reward.py,sha256=AVPDhttbglDXnZE4onrCvf6Br6PdAohVV9WJgF7DsjY,14034
 growsurf/types/__init__.py,sha256=dVCfznQhh_l796cd1s584hjxXqILBQ49CWFp51dcNHA,1391
 growsurf/types/campaign_list_commissions_params.py,sha256=5T8SWE63fWyMglJP_EnK5AG8OVQIbE0rf5jNcvc8tn8,622
@@ -48,13 +48,14 @@ growsurf/types/participant_commission_list.py,sha256=79Eb8Wyic557dBERHiDpgjvYqC4
 growsurf/types/participant_list.py,sha256=5oety8iTXx5anr0W5wAjzCAIMPkQLPeVIc2TNuRbrMY,430
 growsurf/types/participant_payout_list.py,sha256=xO4_EwJAVA5B5opldd7S3X5O6WeAsejgpbVtQ_oacwQ,1419
 growsurf/types/referral_list.py,sha256=SOU3s0cjeQLhbZVbeGoeCprVyrPTk-tvmMBMV25uG1o,969
-growsurf/types/campaign/__init__.py,sha256=5QXEoVqNvARl_R8iRAILUVariVEN9Lno41tNHEKIC8E,2436
+growsurf/types/campaign/__init__.py,sha256=bPWw1pegsnKubl4k9DDEzN_IMlTRqKUOVa__kbmA6QY,2576
 growsurf/types/campaign/campaign.py,sha256=JuiQhipggLIZatBvdmVZVYW5YkLabGHqhZ03rdJ9g-Q,2293
 growsurf/types/campaign/commission_approve_response.py,sha256=fcM2IM6qyqkne4aFPbYcJlfbO3P2fZsJQcBxdsB3BaE,225
 growsurf/types/campaign/commission_delete_response.py,sha256=psVQ1Yqh9j20kvg76LrRtXIa5cy0CVSWzKaZk9IvGKU,223
 growsurf/types/campaign/fraud_risk_level.py,sha256=e14xAEYtKH6gGnkJ9-sr81GZ2UY-zDQ6TZKCkBJLagw,228
 growsurf/types/campaign/participant.py,sha256=E6Hwr275wt5l0I-YdhUWXV1-J47vfXJJY-elrAMLgzg,5205
 growsurf/types/campaign/participant_add_params.py,sha256=wAbyxqdDZIqK0HDuuLwyjuQGAAdEICdVHySumv3VF5k,892
+growsurf/types/campaign/participant_create_mobile_token_response.py,sha256=asUJXjAeA699qrr14BA2hv5TrSMsZqmz0MGoU18E1NU,513
 growsurf/types/campaign/participant_delete_response.py,sha256=qXghOQ04cS3jZh3oHZYr_iXzlanjELyeN5I4kUfFfRM,225
 growsurf/types/campaign/participant_list_commissions_params.py,sha256=4Cxa7rETQYmp71mR4wIzymfPYv2UV3vCzmQvv5iik1c,662
 growsurf/types/campaign/participant_list_payouts_params.py,sha256=AbadljbUZvMgc7cEDvDXpIg3n0nM1x4t2vZgTD-w69A,638
@@ -74,7 +75,7 @@ growsurf/types/campaign/reward_approve_params.py,sha256=IbGDBmEWgmtQQpmYaMg_navf
 growsurf/types/campaign/reward_approve_response.py,sha256=AID7RxcX5_BGxssHn6vR-pGOB_PK-xQhUBNk-ZkNkgI,217
 growsurf/types/campaign/reward_delete_response.py,sha256=YGOQ8GQEEN1HDzOT2pU30Q98UNM-s-U4VkTqMewNe5M,215
 growsurf/types/campaign/reward_fulfill_response.py,sha256=KlimtB3q-3djYMlRzshAxEyU_IVACOesNECbTeU574E,217
-growsurf_python-0.0.2.dist-info/METADATA,sha256=7juFQN5dTN5RrKtzDiZAEHhNxA2_r1_hDWhV9VDStYs,13597
-growsurf_python-0.0.2.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-growsurf_python-0.0.2.dist-info/licenses/LICENSE,sha256=kTHLVE-ra1gtTxcn395uFqcOzcErebE-mDdPNW7b8OU,11338
-growsurf_python-0.0.2.dist-info/RECORD,,
+growsurf_python-0.1.0.dist-info/METADATA,sha256=IiSfcoYAt0BQhGwS4DbmGAV_6WcpDORYFr1KuWrTNRg,13597
+growsurf_python-0.1.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+growsurf_python-0.1.0.dist-info/licenses/LICENSE,sha256=kTHLVE-ra1gtTxcn395uFqcOzcErebE-mDdPNW7b8OU,11338
+growsurf_python-0.1.0.dist-info/RECORD,,