dub 0.27.2__tar.gz → 0.27.4__tar.gz

{dub-0.27.2 → dub-0.27.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dub
-Version: 0.27.2
+Version: 0.27.4
 Summary: Python Client SDK Generated by Speakeasy
 Author: Speakeasy
 Requires-Python: >=3.9.2
@@ -32,7 +32,7 @@ Learn more about the Dub.co Python SDK in the [official documentation](https://d
 <!-- Start Summary [summary] -->
 ## Summary
 
-Dub API: Dub is link management infrastructure for companies to create marketing campaigns, link sharing features, and referral programs.
+Dub API: Dub is the modern link attribution platform for short links, conversion tracking, and affiliate programs.
 <!-- End Summary [summary] -->
 
 <!-- Start Table of Contents [toc] -->

{dub-0.27.2 → dub-0.27.4}/README-PYPI.md

@@ -14,7 +14,7 @@ Learn more about the Dub.co Python SDK in the [official documentation](https://d
 <!-- Start Summary [summary] -->
 ## Summary
 
-Dub API: Dub is link management infrastructure for companies to create marketing campaigns, link sharing features, and referral programs.
+Dub API: Dub is the modern link attribution platform for short links, conversion tracking, and affiliate programs.
 <!-- End Summary [summary] -->
 
 <!-- Start Table of Contents [toc] -->

{dub-0.27.2 → dub-0.27.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dub"
-version = "0.27.2"
+version = "0.27.4"
 description = "Python Client SDK Generated by Speakeasy"
 authors = [{ name = "Speakeasy" },]
 readme = "README-PYPI.md"

{dub-0.27.2 → dub-0.27.4}/src/dub/_version.py

@@ -3,10 +3,10 @@
 import importlib.metadata
 
 __title__: str = "dub"
-__version__: str = "0.27.2"
+__version__: str = "0.27.4"
 __openapi_doc_version__: str = "0.0.1"
-__gen_version__: str = "2.662.0"
-__user_agent__: str = "speakeasy-sdk/python 0.27.2 2.662.0 0.0.1 dub"
+__gen_version__: str = "2.674.3"
+__user_agent__: str = "speakeasy-sdk/python 0.27.4 2.674.3 0.0.1 dub"
 
 try:
     if __package__ is not None:

{dub-0.27.2 → dub-0.27.4}/src/dub/models/components/__init__.py

@@ -2,6 +2,7 @@
 
 from typing import TYPE_CHECKING
 from importlib import import_module
+import builtins
 
 if TYPE_CHECKING:
     from .analyticsbrowsers import AnalyticsBrowsers, AnalyticsBrowsersTypedDict
@@ -634,5 +635,5 @@ def __getattr__(attr_name: str) -> object:
 
 
 def __dir__():
-    lazy_attrs = list(_dynamic_imports.keys())
-    return sorted(lazy_attrs)
+    lazy_attrs = builtins.list(_dynamic_imports.keys())
+    return builtins.sorted(lazy_attrs)

{dub-0.27.2 → dub-0.27.4}/src/dub/models/components/clickevent.py

@@ -29,6 +29,7 @@ class ClickTypedDict(TypedDict):
     referer_url: str
     qr: bool
     ip: str
+    trigger: NotRequired[Nullable[str]]
 
 
 class Click(BaseModel):
@@ -60,6 +61,38 @@ class Click(BaseModel):
 
     ip: str
 
+    trigger: OptionalNullable[str] = UNSET
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = ["trigger"]
+        nullable_fields = ["trigger"]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
 
 class ClickEventGeoTypedDict(TypedDict):
     r"""Geo targeting information for the short link in JSON format `{[COUNTRY]: https://example.com }`. Learn more: https://d.to/geo"""
@@ -871,8 +904,6 @@ class LinkTypedDict(TypedDict):
     geo: Nullable[ClickEventGeoTypedDict]
     r"""Geo targeting information for the short link in JSON format `{[COUNTRY]: https://example.com }`. Learn more: https://d.to/geo"""
     public_stats: bool
-    tag_id: Nullable[str]
-    r"""The unique ID of the tag assigned to the short link. This field is deprecated – use `tags` instead."""
     tags: Nullable[List[TagSchemaTypedDict]]
     r"""The tags assigned to the short link."""
     folder_id: Nullable[str]
@@ -903,18 +934,22 @@ class LinkTypedDict(TypedDict):
     last_clicked: str
     created_at: str
     updated_at: str
+    tag_id: Nullable[str]
+    r"""Deprecated: Use `tags` instead. The unique ID of the tag assigned to the short link."""
     project_id: str
-    r"""The project ID of the short link. This field is deprecated – use `workspaceId` instead."""
+    r"""Deprecated: Use `workspaceId` instead. The project ID of the short link."""
     test_variants: NotRequired[Nullable[List[ClickEventTestVariantsTypedDict]]]
     r"""An array of A/B test URLs and the percentage of traffic to send to each URL."""
     clicks: NotRequired[float]
     r"""The number of clicks on the short link."""
     leads: NotRequired[float]
-    r"""The number of leads the short links has generated."""
+    r"""The number of leads the short link has generated."""
+    conversions: NotRequired[float]
+    r"""The number of leads that converted to paying customers."""
     sales: NotRequired[float]
-    r"""The number of sales the short links has generated."""
+    r"""The total number of sales (includes recurring sales) generated by the short link."""
     sale_amount: NotRequired[float]
-    r"""The total dollar amount of sales the short links has generated (in cents)."""
+    r"""The total dollar value of sales (in cents) generated by the short link."""
 
 
 class Link(BaseModel):
@@ -981,15 +1016,6 @@ class Link(BaseModel):
 
     public_stats: Annotated[bool, pydantic.Field(alias="publicStats")]
 
-    tag_id: Annotated[
-        Nullable[str],
-        pydantic.Field(
-            deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible.",
-            alias="tagId",
-        ),
-    ]
-    r"""The unique ID of the tag assigned to the short link. This field is deprecated – use `tags` instead."""
-
     tags: Nullable[List[TagSchema]]
     r"""The tags assigned to the short link."""
 
@@ -1038,6 +1064,15 @@ class Link(BaseModel):
 
     updated_at: Annotated[str, pydantic.Field(alias="updatedAt")]
 
+    tag_id: Annotated[
+        Nullable[str],
+        pydantic.Field(
+            deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible.",
+            alias="tagId",
+        ),
+    ]
+    r"""Deprecated: Use `tags` instead. The unique ID of the tag assigned to the short link."""
+
     project_id: Annotated[
         str,
         pydantic.Field(
@@ -1045,7 +1080,7 @@ class Link(BaseModel):
             alias="projectId",
         ),
     ]
-    r"""The project ID of the short link. This field is deprecated – use `workspaceId` instead."""
+    r"""Deprecated: Use `workspaceId` instead. The project ID of the short link."""
 
     test_variants: Annotated[
         OptionalNullable[List[ClickEventTestVariants]],
@@ -1057,17 +1092,27 @@ class Link(BaseModel):
     r"""The number of clicks on the short link."""
 
     leads: Optional[float] = 0
-    r"""The number of leads the short links has generated."""
+    r"""The number of leads the short link has generated."""
+
+    conversions: Optional[float] = 0
+    r"""The number of leads that converted to paying customers."""
 
     sales: Optional[float] = 0
-    r"""The number of sales the short links has generated."""
+    r"""The total number of sales (includes recurring sales) generated by the short link."""
 
     sale_amount: Annotated[Optional[float], pydantic.Field(alias="saleAmount")] = 0
-    r"""The total dollar amount of sales the short links has generated (in cents)."""
+    r"""The total dollar value of sales (in cents) generated by the short link."""
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = ["testVariants", "clicks", "leads", "sales", "saleAmount"]
+        optional_fields = [
+            "testVariants",
+            "clicks",
+            "leads",
+            "conversions",
+            "sales",
+            "saleAmount",
+        ]
         nullable_fields = [
             "externalId",
             "tenantId",
@@ -1082,7 +1127,6 @@ class Link(BaseModel):
             "ios",
             "android",
             "geo",
-            "tagId",
             "tags",
             "folderId",
             "comments",
@@ -1095,6 +1139,7 @@ class Link(BaseModel):
             "testStartedAt",
             "testCompletedAt",
             "userId",
+            "tagId",
         ]
         null_default_fields = []
 
@@ -1129,31 +1174,31 @@ class ClickEventTypedDict(TypedDict):
     click: ClickTypedDict
     link: LinkTypedDict
     click_id: str
-    r"""Deprecated. Use `click.id` instead."""
+    r"""Deprecated: Use `click.id` instead."""
     link_id: str
-    r"""Deprecated. Use `link.id` instead."""
+    r"""Deprecated: Use `link.id` instead."""
     domain: str
-    r"""Deprecated. Use `link.domain` instead."""
+    r"""Deprecated: Use `link.domain` instead."""
     key: str
-    r"""Deprecated. Use `link.key` instead."""
+    r"""Deprecated: Use `link.key` instead."""
     url: str
-    r"""Deprecated. Use `click.url` instead."""
+    r"""Deprecated: Use `click.url` instead."""
     continent: str
-    r"""Deprecated. Use `click.continent` instead."""
+    r"""Deprecated: Use `click.continent` instead."""
     country: str
-    r"""Deprecated. Use `click.country` instead."""
+    r"""Deprecated: Use `click.country` instead."""
     city: str
-    r"""Deprecated. Use `click.city` instead."""
+    r"""Deprecated: Use `click.city` instead."""
     device: str
-    r"""Deprecated. Use `click.device` instead."""
+    r"""Deprecated: Use `click.device` instead."""
     browser: str
-    r"""Deprecated. Use `click.browser` instead."""
+    r"""Deprecated: Use `click.browser` instead."""
     os: str
-    r"""Deprecated. Use `click.os` instead."""
+    r"""Deprecated: Use `click.os` instead."""
     qr: float
-    r"""Deprecated. Use `click.qr` instead."""
+    r"""Deprecated: Use `click.qr` instead."""
     ip: str
-    r"""Deprecated. Use `click.ip` instead."""
+    r"""Deprecated: Use `click.ip` instead."""
 
 
 class ClickEvent(BaseModel):
@@ -1171,7 +1216,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.id` instead."""
+    r"""Deprecated: Use `click.id` instead."""
 
     link_id: Annotated[
         str,
@@ -1179,7 +1224,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `link.id` instead."""
+    r"""Deprecated: Use `link.id` instead."""
 
     domain: Annotated[
         str,
@@ -1187,7 +1232,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `link.domain` instead."""
+    r"""Deprecated: Use `link.domain` instead."""
 
     key: Annotated[
         str,
@@ -1195,7 +1240,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `link.key` instead."""
+    r"""Deprecated: Use `link.key` instead."""
 
     url: Annotated[
         str,
@@ -1203,7 +1248,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.url` instead."""
+    r"""Deprecated: Use `click.url` instead."""
 
     continent: Annotated[
         str,
@@ -1211,7 +1256,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.continent` instead."""
+    r"""Deprecated: Use `click.continent` instead."""
 
     country: Annotated[
         str,
@@ -1219,7 +1264,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.country` instead."""
+    r"""Deprecated: Use `click.country` instead."""
 
     city: Annotated[
         str,
@@ -1227,7 +1272,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.city` instead."""
+    r"""Deprecated: Use `click.city` instead."""
 
     device: Annotated[
         str,
@@ -1235,7 +1280,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.device` instead."""
+    r"""Deprecated: Use `click.device` instead."""
 
     browser: Annotated[
         str,
@@ -1243,7 +1288,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.browser` instead."""
+    r"""Deprecated: Use `click.browser` instead."""
 
     os: Annotated[
         str,
@@ -1251,7 +1296,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.os` instead."""
+    r"""Deprecated: Use `click.os` instead."""
 
     qr: Annotated[
         float,
@@ -1259,7 +1304,7 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.qr` instead."""
+    r"""Deprecated: Use `click.qr` instead."""
 
     ip: Annotated[
         str,
@@ -1267,4 +1312,4 @@ class ClickEvent(BaseModel):
             deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
         ),
     ]
-    r"""Deprecated. Use `click.ip` instead."""
+    r"""Deprecated: Use `click.ip` instead."""

{dub-0.27.2 → dub-0.27.4}/src/dub/models/components/domainschema.py

@@ -13,10 +13,14 @@ class RegisteredDomainTypedDict(TypedDict):
 
     id: str
     r"""The ID of the registered domain record."""
+    auto_renewal_disabled_at: Nullable[str]
+    r"""The date the domain auto-renew is disabled."""
     created_at: str
     r"""The date the domain was created."""
     expires_at: str
     r"""The date the domain expires."""
+    renewal_fee: float
+    r"""The fee to renew the domain."""
 
 
 class RegisteredDomain(BaseModel):
@@ -25,12 +29,50 @@ class RegisteredDomain(BaseModel):
     id: str
     r"""The ID of the registered domain record."""
 
+    auto_renewal_disabled_at: Annotated[
+        Nullable[str], pydantic.Field(alias="autoRenewalDisabledAt")
+    ]
+    r"""The date the domain auto-renew is disabled."""
+
     created_at: Annotated[str, pydantic.Field(alias="createdAt")]
     r"""The date the domain was created."""
 
     expires_at: Annotated[str, pydantic.Field(alias="expiresAt")]
     r"""The date the domain expires."""
 
+    renewal_fee: Annotated[float, pydantic.Field(alias="renewalFee")]
+    r"""The fee to renew the domain."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = []
+        nullable_fields = ["autoRenewalDisabledAt"]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
 
 class DomainSchemaTypedDict(TypedDict):
     id: str

{dub-0.27.2 → dub-0.27.4}/src/dub/models/components/leadcreatedevent.py

@@ -111,6 +111,7 @@ class LeadCreatedEventClickTypedDict(TypedDict):
     referer_url: str
     qr: bool
     ip: str
+    trigger: NotRequired[Nullable[str]]
 
 
 class LeadCreatedEventClick(BaseModel):
@@ -142,6 +143,38 @@ class LeadCreatedEventClick(BaseModel):
 
     ip: str
 
+    trigger: OptionalNullable[str] = UNSET
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = ["trigger"]
+        nullable_fields = ["trigger"]
+        null_default_fields = []
+
+        serialized = handler(self)
+
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            serialized.pop(k, None)
+
+            optional_nullable = k in optional_fields and k in nullable_fields
+            is_set = (
+                self.__pydantic_fields_set__.intersection({n})
+                or k in null_default_fields
+            )  # pylint: disable=no-member
+
+            if val is not None and val != UNSET_SENTINEL:
+                m[k] = val
+            elif val != UNSET_SENTINEL and (
+                not k in optional_fields or (optional_nullable and is_set)
+            ):
+                m[k] = val
+
+        return m
+
 
 class LeadCreatedEventGeoTypedDict(TypedDict):
     r"""Geo targeting information for the short link in JSON format `{[COUNTRY]: https://example.com }`. Learn more: https://d.to/geo"""
@@ -953,8 +986,6 @@ class LeadCreatedEventLinkTypedDict(TypedDict):
     geo: Nullable[LeadCreatedEventGeoTypedDict]
     r"""Geo targeting information for the short link in JSON format `{[COUNTRY]: https://example.com }`. Learn more: https://d.to/geo"""
     public_stats: bool
-    tag_id: Nullable[str]
-    r"""The unique ID of the tag assigned to the short link. This field is deprecated – use `tags` instead."""
     tags: Nullable[List[TagSchemaTypedDict]]
     r"""The tags assigned to the short link."""
     folder_id: Nullable[str]
@@ -985,18 +1016,22 @@ class LeadCreatedEventLinkTypedDict(TypedDict):
     last_clicked: str
     created_at: str
     updated_at: str
+    tag_id: Nullable[str]
+    r"""Deprecated: Use `tags` instead. The unique ID of the tag assigned to the short link."""
     project_id: str
-    r"""The project ID of the short link. This field is deprecated – use `workspaceId` instead."""
+    r"""Deprecated: Use `workspaceId` instead. The project ID of the short link."""
     test_variants: NotRequired[Nullable[List[LeadCreatedEventTestVariantsTypedDict]]]
     r"""An array of A/B test URLs and the percentage of traffic to send to each URL."""
     clicks: NotRequired[float]
     r"""The number of clicks on the short link."""
     leads: NotRequired[float]
-    r"""The number of leads the short links has generated."""
+    r"""The number of leads the short link has generated."""
+    conversions: NotRequired[float]
+    r"""The number of leads that converted to paying customers."""
     sales: NotRequired[float]
-    r"""The number of sales the short links has generated."""
+    r"""The total number of sales (includes recurring sales) generated by the short link."""
     sale_amount: NotRequired[float]
-    r"""The total dollar amount of sales the short links has generated (in cents)."""
+    r"""The total dollar value of sales (in cents) generated by the short link."""
 
 
 class LeadCreatedEventLink(BaseModel):
@@ -1063,15 +1098,6 @@ class LeadCreatedEventLink(BaseModel):
 
     public_stats: Annotated[bool, pydantic.Field(alias="publicStats")]
 
-    tag_id: Annotated[
-        Nullable[str],
-        pydantic.Field(
-            deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible.",
-            alias="tagId",
-        ),
-    ]
-    r"""The unique ID of the tag assigned to the short link. This field is deprecated – use `tags` instead."""
-
     tags: Nullable[List[TagSchema]]
     r"""The tags assigned to the short link."""
 
@@ -1120,6 +1146,15 @@ class LeadCreatedEventLink(BaseModel):
 
     updated_at: Annotated[str, pydantic.Field(alias="updatedAt")]
 
+    tag_id: Annotated[
+        Nullable[str],
+        pydantic.Field(
+            deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible.",
+            alias="tagId",
+        ),
+    ]
+    r"""Deprecated: Use `tags` instead. The unique ID of the tag assigned to the short link."""
+
     project_id: Annotated[
         str,
         pydantic.Field(
@@ -1127,7 +1162,7 @@ class LeadCreatedEventLink(BaseModel):
             alias="projectId",
         ),
     ]
-    r"""The project ID of the short link. This field is deprecated – use `workspaceId` instead."""
+    r"""Deprecated: Use `workspaceId` instead. The project ID of the short link."""
 
     test_variants: Annotated[
         OptionalNullable[List[LeadCreatedEventTestVariants]],
@@ -1139,17 +1174,27 @@ class LeadCreatedEventLink(BaseModel):
     r"""The number of clicks on the short link."""
 
     leads: Optional[float] = 0
-    r"""The number of leads the short links has generated."""
+    r"""The number of leads the short link has generated."""
+
+    conversions: Optional[float] = 0
+    r"""The number of leads that converted to paying customers."""
 
     sales: Optional[float] = 0
-    r"""The number of sales the short links has generated."""
+    r"""The total number of sales (includes recurring sales) generated by the short link."""
 
     sale_amount: Annotated[Optional[float], pydantic.Field(alias="saleAmount")] = 0
-    r"""The total dollar amount of sales the short links has generated (in cents)."""
+    r"""The total dollar value of sales (in cents) generated by the short link."""
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = ["testVariants", "clicks", "leads", "sales", "saleAmount"]
+        optional_fields = [
+            "testVariants",
+            "clicks",
+            "leads",
+            "conversions",
+            "sales",
+            "saleAmount",
+        ]
         nullable_fields = [
             "externalId",
             "tenantId",
@@ -1164,7 +1209,6 @@ class LeadCreatedEventLink(BaseModel):
             "ios",
             "android",
             "geo",
-            "tagId",
             "tags",
             "folderId",
             "comments",
@@ -1177,6 +1221,7 @@ class LeadCreatedEventLink(BaseModel):
             "testStartedAt",
             "testCompletedAt",
             "userId",
+            "tagId",
         ]
         null_default_fields = []