@droponair/sdk-js 0.22.1 → 0.23.0

package/CHANGELOG.md

@@ -6,6 +6,14 @@ This project follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.23.0], 2026-06-01
+
+### Added
+
+- **Idempotent retries via `sendMessage(..., { clientMessageId })`.** Pass a stable id to reuse across retries of the same logical message. The relay now dedups by `(appId, fromUserId, messageId)`, so re-sending after a lost ack or a reconnect delivers the message at most once instead of creating duplicates. Omit it for new messages and a fresh id is generated (unchanged default behavior). Requires relay support shipped alongside this release; wire format and `PROTOCOL_VERSION` are unchanged (the `clientMessageId` field already existed).
+
+---
+
 ## [0.22.1], 2026-05-31
 
 ### Fixed

package/dist/core/messaging-client.d.ts

@@ -101,6 +101,7 @@ export declare class MessagingClient implements DropOnAirClient {
     disconnect(): void;
     sendMessage(toUserId: string, plaintextMessage: string, options?: {
         attachments?: AttachmentRef[];
+        clientMessageId?: string;
     }): Promise<{
         messageId: string;
     }>;

package/dist/core/messaging-client.js

@@ -337,7 +337,10 @@ class MessagingClient {
             throw new Error('JWT_EXPIRED: Secure messaging session is reconnecting; please retry in a moment');
         }
         const myDeviceId = this.deviceId ?? await this.getOrCreateDeviceId();
-        const messageId = crypto.randomUUID();
+        // Reuse a caller-supplied id for idempotent retries: the relay dedups by
+        // (appId, fromUserId, messageId), so re-sending with the same id is a no-op
+        // delivery instead of a duplicate. Defaults to a fresh id for new messages.
+        const messageId = options?.clientMessageId ?? crypto.randomUUID();
         const timestamp = Date.now();
         const myIdentity = await this.cryptoService.getOrCreateIdentity();
         const myPublicKeyBytes = (0, bytes_1.fromBase64)(myIdentity.publicKey);

package/dist/core/types.d.ts

@@ -304,9 +304,16 @@ export interface DropOnAirClient {
     /**
      * Send a 1:1 E2EE message. Optionally attach one or more attachments
      * prepared via {@link prepareAttachmentAndUpload} or {@link createUploadSession}.
+     *
+     * Pass `options.clientMessageId` to reuse a stable id across retries: the relay
+     * dedups by `(appId, fromUserId, messageId)`, so re-sending a message with the
+     * same id delivers it at most once instead of creating a duplicate. Omit it for
+     * new messages and a fresh id is generated. The chosen id is returned as
+     * `messageId`.
      */
     sendMessage(toUserId: string, plaintextMessage: string, options?: {
         attachments?: import('../attachment/attachment-types').AttachmentRef[];
+        clientMessageId?: string;
     }): Promise<{
         messageId: string;
     }>;

package/dist/version.d.ts

@@ -7,7 +7,7 @@
  *   MINOR, additive feature (e.g. multi-device payloads, new call event type)
  *   PATCH, bug-fix / perf improvement with no wire or API change
  */
-export declare const SDK_VERSION = "0.22.1";
+export declare const SDK_VERSION = "0.23.0";
 /**
  * Binary encrypted-payload format version.
  * Included as the first byte of every encrypted payload so receivers can

package/dist/version.js

@@ -10,7 +10,7 @@ exports.PROTOCOL_VERSION = exports.PAYLOAD_FORMAT_VERSION = exports.SDK_VERSION
  *   MINOR, additive feature (e.g. multi-device payloads, new call event type)
  *   PATCH, bug-fix / perf improvement with no wire or API change
  */
-exports.SDK_VERSION = '0.22.1';
+exports.SDK_VERSION = '0.23.0';
 /**
  * Binary encrypted-payload format version.
  * Included as the first byte of every encrypted payload so receivers can

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@droponair/sdk-js",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "description": "DropOnAir SDK for end-to-end encrypted messaging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",