feat: add v5.13.0 package updates (#129)

Channels: Current

### 🚀 New Features

- feat: [SDK-5021] add `ios_sound` to UpdateLiveActivityRequest and
deprecate `sound` (OneSignal/API-Client-Libraries#455)

Author: fadi-george

README.md

@@ -3,7 +3,7 @@
 > **Building with an AI agent or LLM?** See [AGENTS.md](https://github.com/OneSignal/onesignal-java-api/blob/main/AGENTS.md) for an agent-oriented integration guide — authentication, calling conventions, idempotent retries, and the full API reference.
 
 OneSignal
-- API version: 5.12.0
+- API version: 5.13.0
 
 A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
 
@@ -21,14 +21,14 @@ Building the API client library requires:
 <dependency>
   <groupId>com.onesignal</groupId>
   <artifactId>onesignal-java-client</artifactId>
-  <version>5.12.0</version>
+  <version>5.13.0</version>
 </dependency>
 ```
 
 ### Gradle
 
 ```groovy
-implementation "com.onesignal:onesignal-java-client:5.12.0"
+implementation "com.onesignal:onesignal-java-client:5.13.0"
 ```
 
 ## Configuration

api/openapi.yaml

@@ -8,7 +8,7 @@ info:
     customer engagement strategies. Learn more at onesignal.com
   termsOfService: https://onesignal.com/tos
   title: OneSignal
-  version: 5.12.0
+  version: 5.13.0
 servers:
 - url: https://api.onesignal.com
 paths:
@@ -4529,6 +4529,7 @@ components:
           tr: tr
         sound: sound
         name: name
+        ios_sound: ios_sound
         headings:
           de: de
           hi: hi
@@ -4576,6 +4577,7 @@ components:
         dismissal_date: 6
         event: update
         priority: 1
+        ios_relevance_score: 5.962133916683182
       properties:
         name:
           description: An internal name to assist with your campaign organization.
@@ -4595,9 +4597,15 @@ components:
         headings:
           $ref: '#/components/schemas/LanguageStringMap'
         sound:
-          description: Sound file that is included in your app to play instead of
-            the default device notification sound. Omit to disable vibration and sound
-            for the notification.
+          deprecated: true
+          description: Deprecated. The API ignores this field. Use `ios_sound`.
+          type: string
+        ios_sound:
+          description: "Sound file that is included in your app to play instead of\
+            \ the default device notification sound. Omit to disable vibration and\
+            \ sound for the notification. Requires `headings` on the same request:\
+            \ ActivityKit ignores an update whose alert has no title, which silently\
+            \ drops the sound. Supersedes the deprecated `sound` field.\n"
           type: string
         stale_date:
           description: "Accepts Unix timestamp in seconds. When time reaches the configured\
@@ -4609,14 +4617,22 @@ components:
             "end"
           type: integer
         priority:
-          description: "Delivery priority through the the push provider (APNs). Pass\
-            \ 10 for higher priority notifications, or 5 for lower priority notifications.\
+          description: "Delivery priority through the push provider (APNs). Pass 10\
+            \ for higher priority notifications, or 5 for lower priority notifications.\
             \ Lower priority notifications are sent based on the power considerations\
             \ of the end user's device. If not set, defaults to 10. Some providers\
             \ (APNs) allow for a limited budget of high priority notifications per\
             \ hour, and if that budget is exceeded, the provider may throttle notification\
             \ delivery."
           type: integer
+        ios_relevance_score:
+          description: "A value between 0 and 1. When more than one Live Activity\
+            \ is active for your app, the one with the highest relevance score shows\
+            \ in the Dynamic Island. If the scores are equal, the system shows the\
+            \ Live Activity that started first. The score also sets the order of Live\
+            \ Activities on the Lock Screen. Only available on iOS 16.2 and later."
+          nullable: true
+          type: number
       required:
       - event
       - event_updates
@@ -5140,8 +5156,11 @@ components:
             \ of the end user's device. If not set, defaults to 10."
           type: integer
         ios_relevance_score:
-          description: iOS 15+. A score to indicate how a notification should be displayed
-            when grouped. Use a float between 0-1.
+          description: "A value between 0 and 1. When more than one Live Activity\
+            \ is active for your app, the one with the highest relevance score shows\
+            \ in the Dynamic Island. If the scores are equal, the system shows the\
+            \ Live Activity that started first. The score also sets the order of Live\
+            \ Activities on the Lock Screen. Only available on iOS 16.2 and later."
           nullable: true
           type: number
         idempotency_key:

build.gradle

@@ -5,7 +5,7 @@ apply plugin: 'com.diffplug.spotless'
 apply plugin: 'com.vanniktech.maven.publish'
 
 group = 'com.onesignal'
-version = '5.12.0'
+version = '5.13.0'
 
 buildscript {
     repositories {

build.sbt

@@ -2,7 +2,7 @@ lazy val root = (project in file(".")).
   settings(
     organization := "com.onesignal",
     name := "onesignal-java-client",
-    version := "5.12.0",
+    version := "5.13.0",
     scalaVersion := "2.11.4",
     scalacOptions ++= Seq("-feature"),
     javacOptions in compile ++= Seq("-Xlint:deprecation"),

docs/StartLiveActivityRequest.md

@@ -16,7 +16,7 @@
 |**headings** | [**LanguageStringMap**](LanguageStringMap.md) |  |  |
 |**staleDate** | **Integer** | Accepts Unix timestamp in seconds. When time reaches the configured stale date, the system considers the Live Activity out of date, and the ActivityState of the Live Activity changes to ActivityState.stale. |  [optional] |
 |**priority** | **Integer** | Delivery priority through the push provider (APNs). Pass 10 for higher priority notifications, or 5 for lower priority notifications. Lower priority notifications are sent based on the power considerations of the end user's device. If not set, defaults to 10. |  [optional] |
-|**iosRelevanceScore** | **BigDecimal** | iOS 15+. A score to indicate how a notification should be displayed when grouped. Use a float between 0-1. |  [optional] |
+|**iosRelevanceScore** | **BigDecimal** | A value between 0 and 1. When more than one Live Activity is active for your app, the one with the highest relevance score shows in the Dynamic Island. If the scores are equal, the system shows the Live Activity that started first. The score also sets the order of Live Activities on the Lock Screen. Only available on iOS 16.2 and later. |  [optional] |
 |**idempotencyKey** | **String** | Correlation and idempotency key. A request received with this parameter will first look for another notification with the same idempotency key. If one exists, a notification will not be sent, and result of the previous operation will instead be returned. Therefore, if you plan on using this feature, it's important to use a good source of randomness to generate the UUID passed here. This key is only idempotent for 30 days. After 30 days, the notification could be removed from our system and a notification with the same idempotency key will be sent again.   See Idempotent Notification Requests for more details writeOnly: true  |  [optional] |
 |**includeAliases** | **Map<String, List<String>>** | Target specific users by aliases assigned via API. An alias can be an external_id, onesignal_id, or a custom alias. Accepts an object where keys are alias labels and values are arrays of alias IDs to include Example usage: { \"external_id\": [\"exId1\", \"extId2\"], \"internal_label\": [\"id1\", \"id2\"] } Keys must match API spellings exactly (for example the label for External ID is the string `external_id`; arbitrary keys such as camelCase variants are not aliases and may yield no recipients). Not compatible with any other targeting parameters. REQUIRED: REST API Key Authentication Limit of 2,000 entries per REST API call Note: If targeting push, email, or sms subscribers with same ids, use with target_channel to indicate you are sending a push or email or sms. |  [optional] |
 |**includeSubscriptionIds** | **List<String>** | Specific subscription ids to target. Not compatible with other targeting parameters. |  [optional] |

docs/UpdateLiveActivityRequest.md

@@ -12,10 +12,12 @@
 |**eventUpdates** | **Object** | This must match the ContentState interface you have defined within your Live Activity in your app. |  |
 |**contents** | [**LanguageStringMap**](LanguageStringMap.md) |  |  [optional] |
 |**headings** | [**LanguageStringMap**](LanguageStringMap.md) |  |  [optional] |
-|**sound** | **String** | Sound file that is included in your app to play instead of the default device notification sound. Omit to disable vibration and sound for the notification. |  [optional] |
+|**sound** | **String** | Deprecated. The API ignores this field. Use `ios_sound`. |  [optional] |
+|**iosSound** | **String** | Sound file that is included in your app to play instead of the default device notification sound. Omit to disable vibration and sound for the notification. Requires `headings` on the same request: ActivityKit ignores an update whose alert has no title, which silently drops the sound. Supersedes the deprecated `sound` field.  |  [optional] |
 |**staleDate** | **Integer** | Accepts Unix timestamp in seconds. When time reaches the configured stale date, the system considers the Live Activity out of date, and the ActivityState of the Live Activity changes to ActivityState.stale. |  [optional] |
 |**dismissalDate** | **Integer** | Accepts Unix timestamp in seconds; only allowed if event is \"end\" |  [optional] |
-|**priority** | **Integer** | Delivery priority through the the push provider (APNs). Pass 10 for higher priority notifications, or 5 for lower priority notifications. Lower priority notifications are sent based on the power considerations of the end user's device. If not set, defaults to 10. Some providers (APNs) allow for a limited budget of high priority notifications per hour, and if that budget is exceeded, the provider may throttle notification delivery. |  [optional] |
+|**priority** | **Integer** | Delivery priority through the push provider (APNs). Pass 10 for higher priority notifications, or 5 for lower priority notifications. Lower priority notifications are sent based on the power considerations of the end user's device. If not set, defaults to 10. Some providers (APNs) allow for a limited budget of high priority notifications per hour, and if that budget is exceeded, the provider may throttle notification delivery. |  [optional] |
+|**iosRelevanceScore** | **BigDecimal** | A value between 0 and 1. When more than one Live Activity is active for your app, the one with the highest relevance score shows in the Dynamic Island. If the scores are equal, the system shows the Live Activity that started first. The score also sets the order of Live Activities on the Lock Screen. Only available on iOS 16.2 and later. |  [optional] |
 
 
 

pom.xml

@@ -5,7 +5,7 @@
     <artifactId>onesignal-java-client</artifactId>
     <packaging>jar</packaging>
     <name>onesignal-java-client</name>
-    <version>5.12.0</version>
+    <version>5.13.0</version>
     <url>https://github.com/OneSignal/onesignal-java-api</url>
     <description>OneSignal Java API Client</description>
     <scm>

src/main/java/com/onesignal/client/ApiClient.java

@@ -132,7 +132,7 @@ private void init() {
         json = new JSON();
 
         // Set default User-Agent.
-        setUserAgent("OpenAPI-Generator/5.12.0/java");
+        setUserAgent("OpenAPI-Generator/5.13.0/java");
 
         authentications = new HashMap<String, Authentication>();
     }