@onesignal/node-onesignal 5.8.0 → 5.10.0

package/README.md

@@ -62,6 +62,15 @@ const response = await client.createNotification(notification);
 console.log('Notification ID:', response.id);
 ```
 
+## Send with idempotent retries
+
+`createNotificationWithRetry` generates a UUIDv4 `idempotency_key` when absent (a caller-provided key is respected), retries 429 / 503 / transport errors with the **same** key (honoring `Retry-After`, exponential backoff otherwise; `maxRetries` / `baseDelayMs` configurable via the options object), fails fast on other errors, and reports via `wasReplayed` whether the server answered from a previously completed request (`Idempotent-Replayed` response header). It is a `DefaultApi` method, so the call mirrors `createNotification`:
+
+```javascript
+const result = await client.createNotificationWithRetry(notification);
+console.log('Notification ID:', result.response.id, 'replayed:', result.wasReplayed);
+```
+
 ## Send a push notification by External ID
 
 Target specific users with the alias label `external_id` (snake_case). This is different from the notification-level `external_id` field, which is only for [idempotent requests](https://documentation.onesignal.com/docs/idempotent-notification-requests).

package/dist/apis/DefaultApi.d.ts

@@ -63,7 +63,7 @@ export declare class DefaultApiRequestFactory extends BaseAPIRequestFactory {
     getApps(_options?: Configuration): Promise<RequestContext>;
     getNotification(appId: string, notificationId: string, _options?: Configuration): Promise<RequestContext>;
     getNotificationHistory(notificationId: string, getNotificationHistoryRequestBody: GetNotificationHistoryRequestBody, _options?: Configuration): Promise<RequestContext>;
-    getNotifications(appId: string, limit?: number, offset?: number, kind?: 0 | 1 | 3, _options?: Configuration): Promise<RequestContext>;
+    getNotifications(appId: string, limit?: number, offset?: number, kind?: 0 | 1 | 3, timeOffset?: string, _options?: Configuration): Promise<RequestContext>;
     getOutcomes(appId: string, outcomeNames: string, outcomeNames2?: string, outcomeTimeRange?: string, outcomePlatforms?: string, outcomeAttribution?: string, _options?: Configuration): Promise<RequestContext>;
     getSegments(appId: string, offset?: number, limit?: number, _options?: Configuration): Promise<RequestContext>;
     getUser(appId: string, aliasLabel: string, aliasId: string, _options?: Configuration): Promise<RequestContext>;