feat: add v5.7.0 package updates (#101)

## Release v5.7.0

### 🚀 Features
- feat: [SDK-4438] add typed error-messages accessor to ApiException
- feat: [SDK-4440] generate typed error-code catalog module per SDK
- feat: [SDK-4441] add idempotency-key retry helper for
create-notification

### 📚 Docs
- docs: clarify errorMessages excludes structured meta; show how to read
it
- docs: [SDK-4440] cross-link OneSignalErrors catalog from DefaultApi.md
error handling

---
_Generated from
[OneSignal/API-Client-Libraries@e4fc576...06c5b0f](OneSignal/API-Client-Libraries@e4fc576...06c5b0ffeb52f85914a6dd8f14ad4d6cdf81c176)._

Author: sherwinski

README.md

@@ -1,7 +1,7 @@
 # onesignal-java-client
 
 OneSignal
-- API version: 5.6.0
+- API version: 5.7.0
 
 A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
 
@@ -19,14 +19,14 @@ Building the API client library requires:
 <dependency>
   <groupId>com.onesignal</groupId>
   <artifactId>onesignal-java-client</artifactId>
-  <version>5.6.0</version>
+  <version>5.7.0</version>
 </dependency>
 ```
 
 ### Gradle
 
 ```groovy
-implementation "com.onesignal:onesignal-java-client:5.6.0"
+implementation "com.onesignal:onesignal-java-client:5.7.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.6.0
+  version: 5.7.0
 servers:
 - url: https://api.onesignal.com
 paths:
@@ -903,6 +903,7 @@ paths:
           description: Rate Limit Exceeded
       security:
       - rest_api_key: []
+      x-onesignal-create-user-conflict-example: true
       x-content-type: application/json
       x-accepts: application/json
   /apps/{app_id}/users/by/{alias_label}/{alias_id}:

build.gradle

@@ -5,7 +5,7 @@ apply plugin: 'com.diffplug.spotless'
 apply plugin: 'com.vanniktech.maven.publish'
 
 group = 'com.onesignal'
-version = '5.6.0'
+version = '5.7.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.6.0",
+    version := "5.7.0",
     scalaVersion := "2.11.4",
     scalacOptions ++= Seq("-feature"),
     javacOptions in compile ++= Seq("-Xlint:deprecation"),

docs/DefaultApi.md

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

pom.xml

@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * The version of the OpenAPI document: 5.6.0
+ * The version of the OpenAPI document: 5.7.0
  * Contact: devrel@onesignal.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

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

@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * The version of the OpenAPI document: 5.6.0
+ * The version of the OpenAPI document: 5.7.0
  * Contact: devrel@onesignal.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -133,7 +133,7 @@ private void init() {
         json = new JSON();
 
         // Set default User-Agent.
-        setUserAgent("OpenAPI-Generator/5.6.0/java");
+        setUserAgent("OpenAPI-Generator/5.7.0/java");
 
         authentications = new HashMap<String, Authentication>();
     }

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

@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * The version of the OpenAPI document: 5.6.0
+ * The version of the OpenAPI document: 5.7.0
  * Contact: devrel@onesignal.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -13,6 +13,12 @@
 
 package com.onesignal.client;
 
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParser;
+
+import java.util.ArrayList;
+import java.util.Collections;
 import java.util.Map;
 import java.util.List;
 
@@ -163,4 +169,76 @@ public String getMessage() {
         return String.format("Message: %s%nHTTP response code: %s%nHTTP response body: %s%nHTTP response headers: %s",
                 super.getMessage(), this.getCode(), this.getResponseBody(), this.getResponseHeaders());
     }
+
+    /**
+     * Get the error messages carried by the response body, normalized to a flat
+     * list of strings regardless of which envelope shape the API returned
+     * ({@code {"errors": "..."}}, {@code {"errors": ["..."]}},
+     * {@code {"errors": [{"code": ..., "title": ...}]}}, or an object map such as
+     * {@code {"errors": {"invalid_aliases": {...}}}}, surfaced as
+     * {@code "<key>: <value>"} entries). Returns an empty list when the body is
+     * not a recognizable error envelope. The raw body remains available via
+     * {@link #getResponseBody()}.
+     *
+     * @return the normalized error messages
+     */
+    public List<String> getErrorMessages() {
+        List<String> messages = new ArrayList<String>();
+        if (responseBody == null || responseBody.isEmpty()) {
+            return messages;
+        }
+
+        try {
+            JsonElement root = JsonParser.parseString(responseBody);
+            if (!root.isJsonObject()) {
+                return messages;
+            }
+
+            JsonElement errors = root.getAsJsonObject().get("errors");
+            if (errors == null || errors.isJsonNull()) {
+                return messages;
+            }
+
+            if (errors.isJsonPrimitive()) {
+                if (errors.getAsJsonPrimitive().isString()) {
+                    messages.add(errors.getAsString());
+                }
+            } else if (errors.isJsonArray()) {
+                for (JsonElement item : errors.getAsJsonArray()) {
+                    if (item.isJsonPrimitive()) {
+                        if (item.getAsJsonPrimitive().isString()) {
+                            messages.add(item.getAsString());
+                        }
+                    } else if (item.isJsonObject()) {
+                        JsonObject object = item.getAsJsonObject();
+                        JsonElement title = object.get("title");
+                        JsonElement code = object.get("code");
+                        if (title != null && title.isJsonPrimitive() && title.getAsJsonPrimitive().isString()
+                                && !title.getAsString().isEmpty()) {
+                            messages.add(title.getAsString());
+                        } else if (code != null && !code.isJsonNull()) {
+                            messages.add(code.isJsonPrimitive() ? code.getAsString() : code.toString());
+                        }
+                    }
+                }
+            } else if (errors.isJsonObject()) {
+                // Object-shaped envelopes (e.g. {"invalid_aliases": {...}}) carry
+                // data under arbitrary keys; surface each so it isn't silently
+                // dropped. Key order is unspecified, so sort for deterministic output.
+                JsonObject object = errors.getAsJsonObject();
+                for (Map.Entry<String, JsonElement> entry : object.entrySet()) {
+                    JsonElement value = entry.getValue();
+                    String rendered = value.isJsonPrimitive() && value.getAsJsonPrimitive().isString()
+                            ? value.getAsString()
+                            : value.toString();
+                    messages.add(entry.getKey() + ": " + rendered);
+                }
+                Collections.sort(messages);
+            }
+        } catch (RuntimeException e) {
+            return messages;
+        }
+
+        return messages;
+    }
 }

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

@@ -2,7 +2,7 @@
  * OneSignal
  * A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com
  *
- * The version of the OpenAPI document: 5.6.0
+ * The version of the OpenAPI document: 5.7.0
  * Contact: devrel@onesignal.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).