Adding changes for Retention Messaging API 1.3-4

https://developer.apple.com/documentation/retentionmessaging/retention-messaging-changelog

Author: alexanderjordanbaker

appstoreserverlibrary/api_client.py

@@ -0,0 +1,35 @@
+# Copyright (c) 2026 Apple Inc. Licensed under MIT License.
+
+from uuid import UUID
+
+from attr import define
+import attr
+
+@define
+class BulletPoint:
+    """
+    The text and its bullet-point image to include in a retention message’s bulleted list.
+
+    https://developer.apple.com/documentation/retentionmessaging/bulletpoint
+    """
+
+    text: str = attr.ib(validator=attr.validators.max_len(66))
+    """
+    The text of the individual bullet point.
+
+    https://developer.apple.com/documentation/retentionmessaging/bulletpointtext
+    """
+
+    imageIdentifier: UUID = attr.ib()
+    """
+    The identifier of the image to use as the bullet point.
+
+    https://developer.apple.com/documentation/retentionmessaging/imageidentifier
+    """
+
+    altText: str = attr.ib(validator=attr.validators.max_len(150))
+    """
+    The alternative text you provide for the corresponding image of the bullet point.
+
+    https://developer.apple.com/documentation/retentionmessaging/alttext
+    """

appstoreserverlibrary/models/BulletPoint.py

@@ -18,5 +18,7 @@ class DefaultConfigurationRequest:
     """
     The message identifier of the message to configure as a default message.
 
+    Note: In a future version, this field will become required.
+
     https://developer.apple.com/documentation/retentionmessaging/messageidentifier
     """

appstoreserverlibrary/models/DefaultConfigurationRequest.py

@@ -0,0 +1,21 @@
+# Copyright (c) 2026 Apple Inc. Licensed under MIT License.
+
+from uuid import UUID
+
+from attr import define
+import attr
+
+@define
+class DefaultConfigurationResponse:
+    """
+    The response body that contains the default configuration information.
+
+    https://developer.apple.com/documentation/retentionmessaging/defaultconfigurationresponse
+    """
+
+    messageIdentifier: UUID = attr.ib()
+    """
+    The message identifier of the retention message you configured as a default.
+
+    https://developer.apple.com/documentation/retentionmessaging/messageidentifier
+    """

appstoreserverlibrary/models/DefaultConfigurationResponse.py

@@ -6,6 +6,7 @@
 from attr import define
 import attr
 
+from .ImageSize import ImageSize
 from .ImageState import ImageState
 from .LibraryUtility import AttrsRawValueAware
 
@@ -34,4 +35,16 @@ class GetImageListResponseItem(AttrsRawValueAware):
     rawImageState: Optional[str] = ImageState.create_raw_attr('imageState')
     """
     See imageState
+    """
+
+    imageSize: Optional[ImageSize] = ImageSize.create_main_attr('rawImageSize')
+    """
+    The size of the image.
+
+    https://developer.apple.com/documentation/retentionmessaging/imagesize
+    """
+
+    rawImageSize: Optional[str] = ImageSize.create_raw_attr('imageSize')
+    """
+    See imageSize
     """

appstoreserverlibrary/models/GetImageListResponseItem.py

@@ -0,0 +1,14 @@
+# Copyright (c) 2026 Apple Inc. Licensed under MIT License.
+
+from enum import Enum
+
+from .LibraryUtility import AppStoreServerLibraryEnumMeta
+
+class HeaderPosition(str, Enum, metaclass=AppStoreServerLibraryEnumMeta):
+    """
+    The position where the header text appears in a message.
+
+    https://developer.apple.com/documentation/retentionmessaging/headerposition
+    """
+    ABOVE_BODY = "ABOVE_BODY"
+    ABOVE_IMAGE = "ABOVE_IMAGE"

appstoreserverlibrary/models/HeaderPosition.py

@@ -0,0 +1,14 @@
+# Copyright (c) 2026 Apple Inc. Licensed under MIT License.
+
+from enum import Enum
+
+from .LibraryUtility import AppStoreServerLibraryEnumMeta
+
+class ImageSize(str, Enum, metaclass=AppStoreServerLibraryEnumMeta):
+    """
+    The size of an image.
+
+    https://developer.apple.com/documentation/retentionmessaging/imagesize
+    """
+    FULL_SIZE = "FULL_SIZE"
+    BULLET_POINT = "BULLET_POINT"

appstoreserverlibrary/models/ImageSize.py

@@ -0,0 +1,49 @@
+# Copyright (c) 2026 Apple Inc. Licensed under MIT License.
+
+from typing import Optional
+
+from attr import define
+import attr
+
+@define
+class PerformanceTestConfig:
+    """
+    An object that enumerates the test configuration parameters.
+
+    https://developer.apple.com/documentation/retentionmessaging/performancetestconfig
+    """
+
+    maxConcurrentRequests: Optional[int] = attr.ib(default=None)
+    """
+    The maximum number of concurrent requests the API allows.
+
+    https://developer.apple.com/documentation/retentionmessaging/maxconcurrentrequests
+    """
+
+    totalRequests: Optional[int] = attr.ib(default=None)
+    """
+    The total number of requests to make during the test.
+
+    https://developer.apple.com/documentation/retentionmessaging/totalrequests
+    """
+
+    totalDuration: Optional[int] = attr.ib(default=None)
+    """
+    The total duration of the test in milliseconds.
+
+    https://developer.apple.com/documentation/retentionmessaging/totalduration
+    """
+
+    responseTimeThreshold: Optional[int] = attr.ib(default=None)
+    """
+    The maximum time your server has to respond when the system calls your Get Retention Message endpoint in the sandbox environment.
+
+    https://developer.apple.com/documentation/retentionmessaging/responsetimethreshold
+    """
+
+    successRateThreshold: Optional[int] = attr.ib(default=None)
+    """
+    The success rate threshold percentage.
+
+    https://developer.apple.com/documentation/retentionmessaging/successratethreshold
+    """

appstoreserverlibrary/models/PerformanceTestConfig.py

@@ -0,0 +1,19 @@
+# Copyright (c) 2026 Apple Inc. Licensed under MIT License.
+
+from attr import define
+import attr
+
+@define
+class PerformanceTestRequest:
+    """
+    The request object you provide for a performance test that contains an original transaction identifier.
+
+    https://developer.apple.com/documentation/retentionmessaging/performancetestrequest
+    """
+
+    originalTransactionId: str = attr.ib()
+    """
+    The original transaction identifier of an In-App Purchase you initiate in the sandbox environment, to use as the purchase for this test.
+
+    https://developer.apple.com/documentation/retentionmessaging/originaltransactionid
+    """

appstoreserverlibrary/models/PerformanceTestRequest.py

@@ -0,0 +1,30 @@
+# Copyright (c) 2026 Apple Inc. Licensed under MIT License.
+
+from typing import Optional
+
+from attr import define
+import attr
+
+from .PerformanceTestConfig import PerformanceTestConfig
+
+@define
+class PerformanceTestResponse:
+    """
+    The performance test response object.
+
+    https://developer.apple.com/documentation/retentionmessaging/performancetestresponse
+    """
+
+    config: Optional[PerformanceTestConfig] = attr.ib(default=None)
+    """
+    The performance test configuration object.
+
+    https://developer.apple.com/documentation/retentionmessaging/performancetestconfig
+    """
+
+    requestId: Optional[str] = attr.ib(default=None)
+    """
+    The performance test request identifier.
+
+    https://developer.apple.com/documentation/retentionmessaging/requestid
+    """