moolabs 0.3.0__py3-none-any.whl

moolabs/models/stripe_webhook_response.py

@@ -0,0 +1,118 @@
+# coding: utf-8
+
+"""
+    Moolabs API
+
+    Unified Moolabs SDK. Capability-based public surface stitched from internal service specs: bff, meter, arc, acute. Customers see capability namespaces (usage, billing, collections, etc.); the SDK routes per-operation internally.
+
+    The version of the OpenAPI document: 0.3.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
+
+class StripeWebhookResponse(BaseModel):
+    """
+    Stripe webhook response.
+    """ # noqa: E501
+    namespace_id: Annotated[str, Field(strict=True)] = Field(description="ULID (Universally Unique Lexicographically Sortable Identifier).", alias="namespaceId")
+    app_id: Annotated[str, Field(strict=True)] = Field(description="ULID (Universally Unique Lexicographically Sortable Identifier).", alias="appId")
+    customer_id: Optional[Annotated[str, Field(strict=True)]] = Field(default=None, description="ULID (Universally Unique Lexicographically Sortable Identifier).", alias="customerId")
+    message: Optional[StrictStr] = None
+    __properties: ClassVar[List[str]] = ["namespaceId", "appId", "customerId", "message"]
+
+    @field_validator('namespace_id')
+    def namespace_id_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if not re.match(r"^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$", value):
+            raise ValueError(r"must validate the regular expression /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/")
+        return value
+
+    @field_validator('app_id')
+    def app_id_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if not re.match(r"^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$", value):
+            raise ValueError(r"must validate the regular expression /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/")
+        return value
+
+    @field_validator('customer_id')
+    def customer_id_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if value is None:
+            return value
+
+        if not re.match(r"^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$", value):
+            raise ValueError(r"must validate the regular expression /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of StripeWebhookResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of StripeWebhookResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "namespaceId": obj.get("namespaceId"),
+            "appId": obj.get("appId"),
+            "customerId": obj.get("customerId"),
+            "message": obj.get("message")
+        })
+        return _obj
+
+

moolabs/models/subject.py

@@ -0,0 +1,122 @@
+# coding: utf-8
+
+"""
+    Moolabs API
+
+    Unified Moolabs SDK. Capability-based public surface stitched from internal service specs: bff, meter, arc, acute. Customers see capability namespaces (usage, billing, collections, etc.); the SDK routes per-operation internally.
+
+    The version of the OpenAPI document: 0.3.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
+
+class Subject(BaseModel):
+    """
+    A subject is a unique identifier for a usage attribution by its key. Subjects only exist in the concept of metering. Subjects are optional to create and work as an enrichment for the subject key like displayName, metadata, etc. Subjects are useful when you are reporting usage events with your own database ID but want to enrich the subject with a human-readable name or metadata. For most use cases, a subject is equivalent to a customer.
+    """ # noqa: E501
+    created_at: datetime = Field(description="Timestamp of when the resource was created.", alias="createdAt")
+    updated_at: datetime = Field(description="Timestamp of when the resource was last updated.", alias="updatedAt")
+    deleted_at: Optional[datetime] = Field(default=None, description="Timestamp of when the resource was permanently deleted.", alias="deletedAt")
+    id: Annotated[str, Field(strict=True)] = Field(description="A unique identifier for the subject.")
+    key: StrictStr = Field(description="A unique, human-readable identifier for the subject. This is typically a database ID or a customer key.")
+    display_name: Optional[StrictStr] = Field(default=None, description="A human-readable display name for the subject.", alias="displayName")
+    metadata: Optional[Dict[str, Any]] = Field(default=None, description="Metadata for the subject.")
+    current_period_start: Optional[datetime] = Field(default=None, description="The start of the current period for the subject.", alias="currentPeriodStart")
+    current_period_end: Optional[datetime] = Field(default=None, description="The end of the current period for the subject.", alias="currentPeriodEnd")
+    stripe_customer_id: Optional[StrictStr] = Field(default=None, description="The Stripe customer ID for the subject.", alias="stripeCustomerId")
+    __properties: ClassVar[List[str]] = ["createdAt", "updatedAt", "deletedAt", "id", "key", "displayName", "metadata", "currentPeriodStart", "currentPeriodEnd", "stripeCustomerId"]
+
+    @field_validator('id')
+    def id_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if not re.match(r"^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$", value):
+            raise ValueError(r"must validate the regular expression /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of Subject from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        """
+        excluded_fields: Set[str] = set([
+            "created_at",
+            "updated_at",
+            "deleted_at",
+            "id",
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of Subject from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "createdAt": obj.get("createdAt"),
+            "updatedAt": obj.get("updatedAt"),
+            "deletedAt": obj.get("deletedAt"),
+            "id": obj.get("id"),
+            "key": obj.get("key"),
+            "displayName": obj.get("displayName"),
+            "metadata": obj.get("metadata"),
+            "currentPeriodStart": obj.get("currentPeriodStart"),
+            "currentPeriodEnd": obj.get("currentPeriodEnd"),
+            "stripeCustomerId": obj.get("stripeCustomerId")
+        })
+        return _obj
+
+

moolabs/models/subject_upsert.py

@@ -0,0 +1,98 @@
+# coding: utf-8
+
+"""
+    Moolabs API
+
+    Unified Moolabs SDK. Capability-based public surface stitched from internal service specs: bff, meter, arc, acute. Customers see capability namespaces (usage, billing, collections, etc.); the SDK routes per-operation internally.
+
+    The version of the OpenAPI document: 0.3.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class SubjectUpsert(BaseModel):
+    """
+    A subject is a unique identifier for a user or entity.
+    """ # noqa: E501
+    key: StrictStr = Field(description="A unique, human-readable identifier for the subject. This is typically a database ID or a customer key.")
+    display_name: Optional[StrictStr] = Field(default=None, description="A human-readable display name for the subject.", alias="displayName")
+    metadata: Optional[Dict[str, Any]] = Field(default=None, description="Metadata for the subject.")
+    current_period_start: Optional[datetime] = Field(default=None, description="The start of the current period for the subject.", alias="currentPeriodStart")
+    current_period_end: Optional[datetime] = Field(default=None, description="The end of the current period for the subject.", alias="currentPeriodEnd")
+    stripe_customer_id: Optional[StrictStr] = Field(default=None, description="The Stripe customer ID for the subject.", alias="stripeCustomerId")
+    __properties: ClassVar[List[str]] = ["key", "displayName", "metadata", "currentPeriodStart", "currentPeriodEnd", "stripeCustomerId"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of SubjectUpsert from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of SubjectUpsert from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "key": obj.get("key"),
+            "displayName": obj.get("displayName"),
+            "metadata": obj.get("metadata"),
+            "currentPeriodStart": obj.get("currentPeriodStart"),
+            "currentPeriodEnd": obj.get("currentPeriodEnd"),
+            "stripeCustomerId": obj.get("stripeCustomerId")
+        })
+        return _obj
+
+

moolabs/models/subscription.py

@@ -0,0 +1,201 @@
+# coding: utf-8
+
+"""
+    Moolabs API
+
+    Unified Moolabs SDK. Capability-based public surface stitched from internal service specs: bff, meter, arc, acute. Customers see capability namespaces (usage, billing, collections, etc.); the SDK routes per-operation internally.
+
+    The version of the OpenAPI document: 0.3.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from moolabs.models.alignment import Alignment
+from moolabs.models.commercial_overrides import CommercialOverrides
+from moolabs.models.plan_reference import PlanReference
+from moolabs.models.pro_rating_config import ProRatingConfig
+from moolabs.models.subscription_status import SubscriptionStatus
+from typing import Optional, Set
+from typing_extensions import Self
+
+class Subscription(BaseModel):
+    """
+    Subscription is an exact subscription instance.
+    """ # noqa: E501
+    id: Annotated[str, Field(strict=True)] = Field(description="A unique identifier for the resource.")
+    name: Annotated[str, Field(min_length=1, strict=True, max_length=256)] = Field(description="Human-readable name for the resource. Between 1 and 256 characters.")
+    description: Optional[Annotated[str, Field(strict=True, max_length=1024)]] = Field(default=None, description="Optional description of the resource. Maximum 1024 characters.")
+    metadata: Optional[Dict[str, StrictStr]] = Field(default=None, description="Additional metadata for the resource.")
+    created_at: datetime = Field(description="Timestamp of when the resource was created.", alias="createdAt")
+    updated_at: datetime = Field(description="Timestamp of when the resource was last updated.", alias="updatedAt")
+    deleted_at: Optional[datetime] = Field(default=None, description="Timestamp of when the resource was permanently deleted.", alias="deletedAt")
+    active_from: datetime = Field(description="The cadence start of the resource.", alias="activeFrom")
+    active_to: Optional[datetime] = Field(default=None, description="The cadence end of the resource.", alias="activeTo")
+    annotations: Optional[Dict[str, Any]] = Field(default=None, description="Set of key-value pairs managed by the system. Cannot be modified by user.")
+    alignment: Optional[Alignment] = Field(default=None, description="Alignment configuration for the plan.")
+    status: SubscriptionStatus = Field(description="The status of the subscription.")
+    customer_id: Annotated[str, Field(strict=True)] = Field(description="The customer ID of the subscription.", alias="customerId")
+    plan: Optional[PlanReference] = Field(default=None, description="The plan of the subscription.")
+    currency: Annotated[str, Field(min_length=3, strict=True, max_length=3)] = Field(description="The currency code of the subscription. Will be revised once we add multi currency support.")
+    billing_cadence: StrictStr = Field(description="The billing cadence for the subscriptions. Defines how often customers are billed using ISO8601 duration format. Examples: \"P1M\" (monthly), \"P3M\" (quarterly), \"P1Y\" (annually).", alias="billingCadence")
+    pro_rating_config: Optional[ProRatingConfig] = Field(default=None, description="The pro-rating configuration for the subscriptions.", alias="proRatingConfig")
+    billing_anchor: datetime = Field(description="The normalizedbilling anchor of the subscription.", alias="billingAnchor")
+    commercial_overrides: Optional[CommercialOverrides] = Field(default=None, description="Commercial terms for this subscription (discounts, pool overrides, wallet policy).", alias="commercialOverrides")
+    quote_origin_key: Optional[Annotated[str, Field(min_length=1, strict=True, max_length=256)]] = Field(default=None, description="Idempotency key linking this subscription to the accepted quote version that created it.", alias="quoteOriginKey")
+    grants_status: Optional[StrictStr] = Field(default=None, description="Transient grant activation status returned by create and quote-origin duplicate recovery flows.", alias="grantsStatus")
+    __properties: ClassVar[List[str]] = ["id", "name", "description", "metadata", "createdAt", "updatedAt", "deletedAt", "activeFrom", "activeTo", "annotations", "alignment", "status", "customerId", "plan", "currency", "billingCadence", "proRatingConfig", "billingAnchor", "commercialOverrides", "quoteOriginKey", "grantsStatus"]
+
+    @field_validator('id')
+    def id_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if not re.match(r"^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$", value):
+            raise ValueError(r"must validate the regular expression /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/")
+        return value
+
+    @field_validator('customer_id')
+    def customer_id_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if not re.match(r"^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$", value):
+            raise ValueError(r"must validate the regular expression /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/")
+        return value
+
+    @field_validator('currency')
+    def currency_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if not re.match(r"^[A-Z]{3}$", value):
+            raise ValueError(r"must validate the regular expression /^[A-Z]{3}$/")
+        return value
+
+    @field_validator('quote_origin_key')
+    def quote_origin_key_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if value is None:
+            return value
+
+        if not re.match(r"^\S(?:.*\S)?$", value):
+            raise ValueError(r"must validate the regular expression /^\S(?:.*\S)?$/")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of Subscription from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        * OpenAPI `readOnly` fields are excluded.
+        """
+        excluded_fields: Set[str] = set([
+            "id",
+            "created_at",
+            "updated_at",
+            "deleted_at",
+            "annotations",
+            "status",
+            "billing_cadence",
+            "pro_rating_config",
+            "billing_anchor",
+            "commercial_overrides",
+            "quote_origin_key",
+            "grants_status",
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of alignment
+        if self.alignment:
+            _dict['alignment'] = self.alignment.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of plan
+        if self.plan:
+            _dict['plan'] = self.plan.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of pro_rating_config
+        if self.pro_rating_config:
+            _dict['proRatingConfig'] = self.pro_rating_config.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of commercial_overrides
+        if self.commercial_overrides:
+            _dict['commercialOverrides'] = self.commercial_overrides.to_dict()
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of Subscription from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "id": obj.get("id"),
+            "name": obj.get("name"),
+            "description": obj.get("description"),
+            "metadata": obj.get("metadata"),
+            "createdAt": obj.get("createdAt"),
+            "updatedAt": obj.get("updatedAt"),
+            "deletedAt": obj.get("deletedAt"),
+            "activeFrom": obj.get("activeFrom"),
+            "activeTo": obj.get("activeTo"),
+            "annotations": obj.get("annotations"),
+            "alignment": Alignment.from_dict(obj["alignment"]) if obj.get("alignment") is not None else None,
+            "status": obj.get("status"),
+            "customerId": obj.get("customerId"),
+            "plan": PlanReference.from_dict(obj["plan"]) if obj.get("plan") is not None else None,
+            "currency": obj.get("currency"),
+            "billingCadence": obj.get("billingCadence"),
+            "proRatingConfig": ProRatingConfig.from_dict(obj["proRatingConfig"]) if obj.get("proRatingConfig") is not None else None,
+            "billingAnchor": obj.get("billingAnchor"),
+            "commercialOverrides": CommercialOverrides.from_dict(obj["commercialOverrides"]) if obj.get("commercialOverrides") is not None else None,
+            "quoteOriginKey": obj.get("quoteOriginKey"),
+            "grantsStatus": obj.get("grantsStatus")
+        })
+        return _obj
+
+

moolabs/models/subscription_activate_request.py

@@ -0,0 +1,101 @@
+# coding: utf-8
+
+"""
+    Moolabs API
+
+    Unified Moolabs SDK. Capability-based public surface stitched from internal service specs: bff, meter, arc, acute. Customers see capability namespaces (usage, billing, collections, etc.); the SDK routes per-operation internally.
+
+    The version of the OpenAPI document: 0.3.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictFloat, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class SubscriptionActivateRequest(BaseModel):
+    """
+    Request to activate a subscription: sync to mirror + create initial credit grants.
+    """ # noqa: E501
+    subscription_data: Dict[str, Any] = Field(description="Raw OpenMeter subscription response")
+    customer_id: Optional[StrictStr] = Field(default=None, description="Customer ID")
+    customer_key: Optional[StrictStr] = Field(default=None, description="Customer key (for wallet binding)")
+    subject_keys: Optional[List[StrictStr]] = Field(default=None, description="Usage attribution subject keys")
+    active_from: Optional[StrictStr] = Field(default=None, description="Subscription start date (ISO 8601)")
+    active_to: Optional[StrictStr] = Field(default=None, description="Subscription end date (ISO 8601)")
+    billing_cadence: Optional[StrictStr] = Field(default=None, description="Billing cadence (ISO 8601 duration)")
+    pool_overrides: Optional[Dict[str, Union[StrictFloat, StrictInt]]] = Field(default=None, description="Per-pool recurring credit overrides: pool_key -> amount. '__global__' overrides global pool.")
+    __properties: ClassVar[List[str]] = ["subscription_data", "customer_id", "customer_key", "subject_keys", "active_from", "active_to", "billing_cadence", "pool_overrides"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of SubscriptionActivateRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of SubscriptionActivateRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "subscription_data": obj.get("subscription_data"),
+            "customer_id": obj.get("customer_id"),
+            "customer_key": obj.get("customer_key"),
+            "subject_keys": obj.get("subject_keys"),
+            "active_from": obj.get("active_from"),
+            "active_to": obj.get("active_to"),
+            "billing_cadence": obj.get("billing_cadence"),
+            "pool_overrides": obj.get("pool_overrides")
+        })
+        return _obj
+
+