python-amazon-sp-api 2.0.15__py3-none-any.whl → 2.1.3__py3-none-any.whl

sp_api/asyncio/api/vendor_shipments/vendor_shipments.py

@@ -16,26 +16,29 @@ class VendorShipments(AsyncBaseClient):
     async def submit_shipment_confirmations(self, **kwargs) -> ApiResponse:
         """
         submit_shipment_confirmations(self, **kwargs) -> ApiResponse
-
+        
         Submits one or more shipment confirmations for vendor orders.
-
+        
         **Usage Plan:**
-
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 10 | 10 |
-
-        The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
-
-                Args:
-
-                    body: | * REQUIRED {'description': 'The request schema for the SubmitShipmentConfirmations operation.',
-         'properties': {'shipmentConfirmations': {'description': 'A list of one or more shipment confirmations.', 'items': {'$ref': '#/definitions/ShipmentConfirmation'}, 'type': 'array'}},
-         'type': 'object'}
-
-
-                Returns:
-                    ApiResponse:
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        10                                      10
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                await VendorShipments().submit_shipment_confirmations()
+        
+        Args:
+            body: SubmitShipmentConfirmationsRequest | required A request to submit shipment confirmation.
+        
+        Returns:
+            ApiResponse
         """
 
         return await self._request(kwargs.pop("path"), data=kwargs)
@@ -44,26 +47,29 @@ class VendorShipments(AsyncBaseClient):
     async def submit_shipments(self, **kwargs) -> ApiResponse:
         """
         submit_shipments(self, **kwargs) -> ApiResponse
-
+        
         Submits one or more shipment request for vendor Orders.
-
+        
         **Usage Plan:**
-
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 10 | 10 |
-
-        The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
-
-                Args:
-
-                    body: | * REQUIRED {'description': 'The request schema for the SubmitShipments operation.',
-         'properties': {'shipments': {'description': 'A list of one or more shipments with underlying details.', 'items': {'$ref': '#/definitions/Shipment'}, 'type': 'array'}},
-         'type': 'object'}
-
-
-                Returns:
-                    ApiResponse:
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        10                                      10
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                await VendorShipments().submit_shipments()
+        
+        Args:
+            body: SubmitShipments | required A request to submit shipment request.
+        
+        Returns:
+            ApiResponse
         """
 
         return await self._request(kwargs.pop("path"), data=kwargs)
@@ -72,47 +78,122 @@ class VendorShipments(AsyncBaseClient):
     async def get_shipment_details(self, **kwargs) -> ApiResponse:
         """
         get_shipment_details(self, **kwargs) -> ApiResponse
-
+        
         Returns the Details about Shipment, Carrier Details,  status of the shipment, container details and other details related to shipment based on the filter parameters value that you specify.
-
+        
         **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        10                                      10
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                await VendorShipments().get_shipment_details()
+        
+        Args:
+            key limit: object |  The limit to the number of records returned. Default value is 50 records.
+            key sortOrder: object |  Sort in ascending or descending order by purchase order creation date.
+            key nextToken: object |  Used for pagination when there are more shipments than the specified result size limit.
+            key createdAfter: object |  Get Shipment Details that became available after this timestamp will be included in the result. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key createdBefore: object |  Get Shipment Details that became available before this timestamp will be included in the result. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key shipmentConfirmedBefore: object |  Get Shipment Details by passing Shipment confirmed create Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key shipmentConfirmedAfter: object |  Get Shipment Details by passing Shipment confirmed create Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key packageLabelCreatedBefore: object |  Get Shipment Details by passing Package label create Date by buyer. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key packageLabelCreatedAfter: object |  Get Shipment Details by passing Package label create Date After by buyer. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key shippedBefore: object |  Get Shipment Details by passing Shipped Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key shippedAfter: object |  Get Shipment Details by passing Shipped Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key estimatedDeliveryBefore: object |  Get Shipment Details by passing Estimated Delivery Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key estimatedDeliveryAfter: object |  Get Shipment Details by passing Estimated Delivery Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key shipmentDeliveryBefore: object |  Get Shipment Details by passing Shipment Delivery Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key shipmentDeliveryAfter: object |  Get Shipment Details by passing Shipment Delivery Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key requestedPickUpBefore: object |  Get Shipment Details by passing Before Requested pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key requestedPickUpAfter: object |  Get Shipment Details by passing After Requested pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key scheduledPickUpBefore: object |  Get Shipment Details by passing Before scheduled pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key scheduledPickUpAfter: object |  Get Shipment Details by passing After Scheduled pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
+            key currentShipmentStatus: object |  Get Shipment Details by passing Current shipment status.
+            key vendorShipmentIdentifier: object |  Get Shipment Details by passing Vendor Shipment ID
+            key buyerReferenceNumber: object |  Get Shipment Details by passing buyer Reference ID
+            key buyerWarehouseCode: object |  Get Shipping Details based on buyer warehouse code. This value should be same as 'shipToParty.partyId' in the Shipment.
+            key sellerWarehouseCode: object |  Get Shipping Details based on vendor warehouse code. This value should be same as 'sellingParty.partyId' in the Shipment.
+        
+        Returns:
+            ApiResponse
+        """
 
-        | Rate (requests per second) | Burst |
-        | ---- | ---- |
-        | 10 | 10 |
+        return await self._request(kwargs.pop("path"), params=kwargs)
 
-        The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
 
+    @sp_endpoint("/vendor/shipping/v1/shipmentConfirmation", method="POST")
+    async def submit_shipment_confirmation(self, **kwargs) -> ApiResponse:
+        """
+        submit_shipment_confirmation(self, **kwargs) -> ApiResponse
+        
+        Submits one shipment confirmation for vendor orders and get response immediately.
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        10                                      10
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                await VendorShipments().submit_shipment_confirmation()
+        
         Args:
+            body: SubmitShipmentConfirmationRequest | required A request to submit shipment confirmation.
+        
+        Returns:
+            ApiResponse
+        """
+        return await self._request(kwargs.pop("path"), data=kwargs)
 
-            key limit:integer |  The limit to the number of records returned. Default value is 50 records.
-            key sortOrder:string |  Sort in ascending or descending order by purchase order creation date.
-            key nextToken:string |  Used for pagination when there are more shipments than the specified result size limit.
-            key createdAfter:string |  Get Shipment Details that became available after this timestamp will be included in the result. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key createdBefore:string |  Get Shipment Details that became available before this timestamp will be included in the result. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key shipmentConfirmedBefore:string |  Get Shipment Details by passing Shipment confirmed create Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key shipmentConfirmedAfter:string |  Get Shipment Details by passing Shipment confirmed create Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key packageLabelCreatedBefore:string |  Get Shipment Details by passing Package label create Date by buyer. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key packageLabelCreatedAfter:string |  Get Shipment Details by passing Package label create Date After by buyer. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key shippedBefore:string |  Get Shipment Details by passing Shipped Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key shippedAfter:string |  Get Shipment Details by passing Shipped Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key estimatedDeliveryBefore:string |  Get Shipment Details by passing Estimated Delivery Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key estimatedDeliveryAfter:string |  Get Shipment Details by passing Estimated Delivery Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key shipmentDeliveryBefore:string |  Get Shipment Details by passing Shipment Delivery Date Before. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key shipmentDeliveryAfter:string |  Get Shipment Details by passing Shipment Delivery Date After. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key requestedPickUpBefore:string |  Get Shipment Details by passing Before Requested pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key requestedPickUpAfter:string |  Get Shipment Details by passing After Requested pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key scheduledPickUpBefore:string |  Get Shipment Details by passing Before scheduled pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key scheduledPickUpAfter:string |  Get Shipment Details by passing After Scheduled pickup date. Must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format.
-            key currentShipmentStatus:string |  Get Shipment Details by passing Current shipment status.
-            key vendorShipmentIdentifier:string |  Get Shipment Details by passing Vendor Shipment ID
-            key buyerReferenceNumber:string |  Get Shipment Details by passing buyer Reference ID
-            key buyerWarehouseCode:string |  Get Shipping Details based on buyer warehouse code. This value should be same as 'shipToParty.partyId' in the Shipment.
-            key sellerWarehouseCode:string |  Get Shipping Details based on vendor warehouse code. This value should be same as 'sellingParty.partyId' in the Shipment.
 
 
+    @sp_endpoint("/vendor/shipping/v1/transportLabels", method="GET")
+    async def get_shipment_labels(self, **kwargs) -> ApiResponse:
+        """
+        get_shipment_labels(self, **kwargs) -> ApiResponse
+        
+        Returns small parcel shipment labels based on the filters that you specify.
+        
+        **Usage Plan:**
+        
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        10                                      10
+        ======================================  ==============
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                await VendorShipments().get_shipment_labels()
+        
+        Args:
+            key limit: object |  The limit to the number of records returned. Default value is 50 records.
+            key sortOrder: object |  Sort the list by shipment label creation date in ascending or descending order.
+            key nextToken: object |  A token that you use to retrieve the next page of results. The response includes `nextToken` when the number of results exceeds the specified `pageSize` value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.
+            key labelCreatedAfter: object |  Shipment labels created after this time will be included in the result. This field must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) datetime format.
+            key labelCreatedBefore: object |  Shipment labels created before this time will be included in the result. This field must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) datetime format.
+            key buyerReferenceNumber: object |  Get Shipment labels by passing buyer reference number.
+            key vendorShipmentIdentifier: object |  Get Shipment labels by passing vendor shipment identifier.
+            key sellerWarehouseCode: object |  Get Shipping labels based on vendor warehouse code. This value must be same as the `sellingParty.partyId` in the shipment.
+        
         Returns:
-            ApiResponse:
+            ApiResponse
         """
-
-        return await self._request(kwargs.pop("path"), params=kwargs)
+        return await self._request(kwargs.pop("path"), params=kwargs)

sp_api/asyncio/api/vendor_transaction_status/vendor_transaction_status.py

@@ -16,26 +16,31 @@ class VendorTransactionStatus(AsyncBaseClient):
     async def get_transaction(self, transactionId, **kwargs) -> ApiResponse:
         """
         get_transaction(self, transactionId, **kwargs) -> ApiResponse
-
+        
         Returns the status of the transaction that you specify.
-
-        **Usage Plans:**
-
+        
+        **Usage Plan:**
+        
         ======================================  ==============
         Rate (requests per second)               Burst
         ======================================  ==============
-        10                                      10
+        10                                      20
         ======================================  ==============
-
-        The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
-
+        
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+        
+        Examples:
+            literal blocks::
+            
+                await VendorTransactionStatus().get_transaction("value")
+        
         Args:
-            transactionId:string | * REQUIRED The GUID provided by Amazon in the 'transactionId' field in response to the post request of a specific transaction.
-
+            transactionId: object | required The GUID provided by Amazon in the 'transactionId' field in response to the post request of a specific transaction.
+        
         Returns:
-            ApiResponse:
+            ApiResponse
         """
 
         return await self._request(
             fill_query_params(kwargs.pop("path"), transactionId), params=kwargs
-        )
+        )

sp_api/asyncio/base/client.py

@@ -1,4 +1,4 @@
-from datetime import datetime
+from datetime import datetime, timezone
 import logging
 import os
 
@@ -75,7 +75,7 @@ class Client(BaseClient):
             "host": self.endpoint[8:],
             "user-agent": self.user_agent,
             "x-amz-access-token": token,
-            "x-amz-date": datetime.utcnow().strftime("%Y%m%dT%H%M%SZ"),
+            "x-amz-date": datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ"),
             "content-type": "application/json",
         }
 

sp_api/asyncio/util/load_date_bound.py

@@ -21,7 +21,7 @@ def load_date_bound(interval_days: int = 30):
                 {
                     "dataStartTime": parse_if_needed(kwargs["dataStartTime"]),
                     "dataEndTime": parse_if_needed(
-                        kwargs.get("dataEndTime", datetime.datetime.utcnow())
+                        kwargs.get("dataEndTime", datetime.datetime.now(datetime.timezone.utc))
                     ),
                 }
             )

sp_api/base/__init__.py

@@ -23,6 +23,8 @@ from .schedules import Schedules
 from .report_status import ReportStatus
 from .sales_enum import FirstDayOfWeek, Granularity, BuyerType
 from .fulfillment_channel import FulfillmentChannel
+from .identifiersType import IdentifiersType
+from .InventoryEnums import InventoryGranularity
 from .included_data import (
     IncludedData,
     ListingItemsIncludedData,
@@ -46,6 +48,7 @@ __all__ = [
     "AccessTokenClient",
     "ReportType",
     "FeedType",
+    "FeedTypes",
     "ProcessingStatus",
     "ApiResponse",
     "Client",
@@ -70,6 +73,9 @@ __all__ = [
     "Granularity",
     "BuyerType",
     "FulfillmentChannel",
+    "FulfillmentChannels",
+    "IdentifiersType",
+    "InventoryGranularity",
     "deprecated",
     "NotificationType",
     "CredentialProvider",
@@ -82,3 +88,7 @@ __all__ = [
     "CatalogItemsIncludedData",
     "AwsEnv",
 ]
+
+# Backward-compatibility aliases for docs and legacy imports.
+FeedTypes = FeedType
+FulfillmentChannels = FulfillmentChannel

sp_api/base/_core.py

@@ -1,5 +1,5 @@
 import json
-from datetime import datetime
+from datetime import datetime, timezone
 from json import JSONDecodeError
 
 from .ApiResponse import ApiResponse
@@ -52,7 +52,7 @@ def build_headers(endpoint, user_agent, access_token, content_type="application/
         "host": endpoint[8:],
         "user-agent": user_agent,
         "x-amz-access-token": access_token,
-        "x-amz-date": datetime.utcnow().strftime("%Y%m%dT%H%M%SZ"),
+        "x-amz-date": datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ"),
         "content-type": content_type,
     }
 

sp_api/base/client.py

@@ -1,4 +1,4 @@
-from datetime import datetime
+from datetime import datetime, timezone
 import logging
 import os
 
@@ -72,7 +72,7 @@ class Client(BaseClient):
             "host": self.endpoint[8:],
             "user-agent": self.user_agent,
             "x-amz-access-token": self.restricted_data_token or self.auth.access_token,
-            "x-amz-date": datetime.utcnow().strftime("%Y%m%dT%H%M%SZ"),
+            "x-amz-date": datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ"),
             "content-type": "application/json",
         }
 
@@ -179,7 +179,7 @@ class Client(BaseClient):
             "host": self.endpoint[8:],
             "user-agent": self.user_agent,
             "x-amz-access-token": self.grantless_auth.access_token,
-            "x-amz-date": datetime.utcnow().strftime("%Y%m%dT%H%M%SZ"),
+            "x-amz-date": datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ"),
             "content-type": "application/json",
         }
         log.debug("HTTP Method: %s", self.method)

sp_api/base/helpers.py

@@ -7,7 +7,18 @@ from urllib import parse
 
 
 def fill_query_params(query, *args):
-    return query.format(*[parse.quote(arg, safe="") for arg in args])
+    quoted = [parse.quote(str(arg), safe="") for arg in args]
+    try:
+        return query.format(*quoted)
+    except KeyError:
+        import string
+
+        formatter = string.Formatter()
+        fields = [field_name for _, field_name, _, _ in formatter.parse(query) if field_name]
+        if fields and len(fields) == len(quoted):
+            mapping = dict(zip(fields, quoted))
+            return query.format_map(mapping)
+        raise
 
 
 def sp_endpoint(path, method="GET"):

sp_api/base/marketplaces.py

@@ -49,9 +49,12 @@ if AwsEnv(AWS_ENVIRONMENT) == AwsEnv.SANDBOX:
 
 class Marketplaces(Enum):
     """Enumeration for MWS marketplaces, containing endpoints and marketplace IDs.
-    Example, endpoint and ID for UK marketplace:
-        endpoint = Marketplaces.UK.endpoint
-        marketplace_id = Marketplaces.UK.marketplace_id
+
+    Examples:
+        literal blocks::
+
+            endpoint = Marketplaces.UK.endpoint
+            marketplace_id = Marketplaces.UK.marketplace_id
     """
 
     #: Amazon marketplace in United Arab Emirates (AE)

sp_api/util/__init__.py

@@ -22,6 +22,7 @@ from .products_definitions import (
     CompetitiveSummaryRequest,
     GetCompetitiveSummaryBatch,
 )
+from .versioned_client import VersionedClientMeta
 
 __all__ = [
     "retry",
@@ -46,4 +47,5 @@ __all__ = [
     "GetFeaturedOfferExpectedPriceBatch",
     "CompetitiveSummaryRequest",
     "GetCompetitiveSummaryBatch",
+    "VersionedClientMeta",
 ]

sp_api/util/load_date_bound.py

@@ -21,7 +21,7 @@ def load_date_bound(interval_days: int = 30):
                 {
                     "dataStartTime": parse_if_needed(kwargs["dataStartTime"]),
                     "dataEndTime": parse_if_needed(
-                        kwargs.get("dataEndTime", datetime.datetime.utcnow())
+                        kwargs.get("dataEndTime", datetime.datetime.now(datetime.timezone.utc))
                     ),
                 }
             )

sp_api/util/versioned_client.py

@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+from typing import Any
+
+
+class VersionedClientMeta(type):
+    """Metaclass that dispatches construction to a version-specific implementation.
+
+    This keeps the call-site ergonomic (`Client(version=...)`) while allowing a single
+    place to implement the dispatch logic.
+
+    Subclasses should define:
+      - `_VERSION_MAP`: mapping of normalized version strings to implementation classes
+      - `_VERSION_ALIASES` (optional): mapping of alias strings to normalized versions
+      - `_DEFAULT_VERSION`: default version when none is provided
+
+    Front classes must set `_DISPATCH = True` in their class body.
+    """
+
+    def __call__(cls, *args: Any, **kwargs: Any):
+        version = kwargs.pop("version", None)
+
+        # Only dispatch for the public front class itself.
+        if cls.__dict__.get("_DISPATCH", False):
+            # Backwards-compatible default: if no version is provided, return the
+            # oldest supported implementation.
+            v_raw = version if version is not None else getattr(cls, "_DEFAULT_VERSION", None)
+            if v_raw is None:
+                return super().__call__(*args, **kwargs)
+
+            v_raw = getattr(v_raw, "value", v_raw)
+            v = str(v_raw)
+            aliases: dict[str, str] = getattr(cls, "_VERSION_ALIASES", {})
+            v_norm = aliases.get(v, v)
+
+            impl_map: dict[str, type] = getattr(cls, "_VERSION_MAP", {})
+            impl = impl_map.get(v_norm)
+            if impl is not None:
+                kwargs["version"] = v_norm
+                return impl(*args, **kwargs)
+
+            supported = ", ".join(sorted(impl_map.keys()))
+            raise ValueError(f"Unsupported version {v!r}. Supported: {supported}")
+
+        return super().__call__(*args, **kwargs)