@droponair/sdk-js 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -6,6 +6,21 @@ This project follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.12.0], 2026-05-20
+
+### Added
+
+- **Notification clear sync.** `client.clearNotification(conversationId)` tells the user's other devices a conversation's notifications were dismissed; `client.onNotificationCleared(cb)` listens for it. Always available (no opt-out) — it is plain own-device hygiene.
+- **Draft sync.** `client.syncDraft(conversationId, draftText)` pushes a conversation draft to the user's other devices; `client.onDraftSync(cb)` listens for it. **Opt-in:** the app owner enables it in the dashboard, and the draft text crosses the relay in cleartext (fanned out, never stored). When disabled the server drops the frame.
+- New exported types: `NotificationClearEvent` / `NotificationClearCallback`, `DraftSyncEvent` / `DraftSyncCallback`.
+
+### Notes
+
+- Both ride the existing `SyncFrame` wire type (own-device fan-out only, never delivered to a different user). No PROTOCOL_VERSION change.
+- Your app decides when to call `clearNotification()` / `syncDraft()` — the platform never infers dismissal or tracks drafts.
+
+---
+
 ## [0.11.0], 2026-05-20
 
 ### Added

package/README.md

@@ -102,6 +102,10 @@ const client = await initialize(options);
 | `revokeMyDevice(deviceId)` | `Promise<DeviceInfo>` | Revoke one of the current user's devices. Permanent. |
 | `markRead(messageId, conversationId?)` | `void` | Mark a message as read; relays a receipt to the user's other devices. |
 | `onReadReceipt(callback)` | `() => void` | Listen for read receipts from the user's other devices. |
+| `clearNotification(conversationId)` | `void` | Tell the user's other devices a conversation's notifications were dismissed. |
+| `onNotificationCleared(callback)` | `() => void` | Listen for notification-clear syncs from the user's other devices. |
+| `syncDraft(conversationId, draftText)` | `void` | Push a conversation draft to the user's other devices (opt-in, cleartext). |
+| `onDraftSync(callback)` | `() => void` | Listen for draft syncs from the user's other devices. |
 
 ### Cross-device read receipts
 
@@ -117,6 +121,18 @@ client.onReadReceipt(e => {
 });
 ```
 
+### Notification clear & draft sync
+
+Available since SDK `0.12.0`, both own-device only. `clearNotification()` tells your user's other devices a conversation's notifications were dismissed — always available. `syncDraft()` pushes a draft so the user can keep typing on another device — **opt-in** (the app owner enables it in the dashboard) and the draft text crosses the relay in cleartext.
+
+```typescript
+client.clearNotification(conversationId);
+client.onNotificationCleared(e => { /* clear badge for e.conversationId */ });
+
+client.syncDraft(conversationId, composerText);
+client.onDraftSync(e => { /* pre-fill composer with e.draftText */ });
+```
+
 ### Device trust
 
 Available since SDK `0.10.0`. Any device that completes a connection is implicitly trusted. `listMyDevices()` powers a "Your devices" screen; `revokeMyDevice()` cuts a device off immediately. When the *current* device is revoked, the SDK stops reconnecting and emits a `DEVICE_REVOKED` event via `onEvent` — listen for it to clear local key storage and prompt re-registration.

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

@@ -1,6 +1,6 @@
 import { CryptoService } from '../crypto/crypto-service';
 import { SessionManager } from './session-manager';
-import { BroadcastCallback, CallEventCallback, DropOnAirClient, EventCallback, GroupCallEventCallback, GroupInfo, GroupMessageCallback, InitializeOptions, MessageCallback, MessageDeleteCallback, MessageEditCallback, TurnCredentials, DeviceInfo, ReadReceiptCallback } from './types';
+import { BroadcastCallback, CallEventCallback, DropOnAirClient, EventCallback, GroupCallEventCallback, GroupInfo, GroupMessageCallback, InitializeOptions, MessageCallback, MessageDeleteCallback, MessageEditCallback, TurnCredentials, DeviceInfo, ReadReceiptCallback, NotificationClearCallback, DraftSyncCallback } from './types';
 import { AttachmentRef, CreateUploadSessionOptions, DownloadedAttachment, PrepareAttachmentOptions, UploadSession } from '../attachment/attachment-types';
 export declare class MessagingClient implements DropOnAirClient {
     private readonly options;
@@ -72,6 +72,8 @@ export declare class MessagingClient implements DropOnAirClient {
     private readonly broadcastListeners;
     private readonly messageEditListeners;
     private readonly readReceiptListeners;
+    private readonly notificationClearListeners;
+    private readonly draftSyncListeners;
     private readonly messageDeleteListeners;
     /** ------------------------------------------------------------------
      * Lightweight structured logger. Only active when options.debug === true.
@@ -178,6 +180,25 @@ export declare class MessagingClient implements DropOnAirClient {
      *                        other devices so they can bucket the receipt
      */
     markRead(messageId: string, conversationId?: string): void;
+    /**
+     * Tell this user's other devices that the notification(s) for a
+     * conversation have been dismissed - call this when YOUR app dismisses a
+     * notification or the user opens the conversation. The other devices clear
+     * the matching badge. The relay never decides what "dismissed" means.
+     */
+    clearNotification(conversationId: string): void;
+    /**
+     * Push the current draft text for a conversation to this user's other
+     * devices so the user can continue typing on another device. Draft sync is
+     * opt-in: the app owner must enable it in the dashboard, and the draft text
+     * crosses the relay in cleartext (it is fanned out, never stored). If the
+     * feature is disabled the server silently drops the frame.
+     */
+    syncDraft(conversationId: string, draftText: string): void;
+    /** Register a listener for notification-clear syncs from the user's other devices. */
+    onNotificationCleared(callback: NotificationClearCallback): () => void;
+    /** Register a listener for draft syncs from the user's other devices. */
+    onDraftSync(callback: DraftSyncCallback): () => void;
     private handleIncomingSync;
     sendCleartextMessage(toUserId: string, plaintext: string): Promise<{
         messageId: string;

package/dist/core/messaging-client.js

@@ -221,6 +221,8 @@ class MessagingClient {
         this.broadcastListeners = new Set();
         this.messageEditListeners = new Set();
         this.readReceiptListeners = new Set();
+        this.notificationClearListeners = new Set();
+        this.draftSyncListeners = new Set();
         this.messageDeleteListeners = new Set();
         this.wsUrl = options.messagingWsUrl ?? 'wss://sdk.droponair.com/ws';
         this.httpUrl = options.messagingHttpUrl ?? 'https://sdk.droponair.com';
@@ -667,6 +669,54 @@ class MessagingClient {
         };
         this.ws.send(this.codec.encodeSyncFrame(frame));
     }
+    /**
+     * Tell this user's other devices that the notification(s) for a
+     * conversation have been dismissed - call this when YOUR app dismisses a
+     * notification or the user opens the conversation. The other devices clear
+     * the matching badge. The relay never decides what "dismissed" means.
+     */
+    clearNotification(conversationId) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('DropOnAir websocket is not connected');
+        }
+        const frame = {
+            type: 'SYNC_CLEAR_NOTIFICATION',
+            messageId: '',
+            conversationId,
+            timestamp: Date.now(),
+        };
+        this.ws.send(this.codec.encodeSyncFrame(frame));
+    }
+    /**
+     * Push the current draft text for a conversation to this user's other
+     * devices so the user can continue typing on another device. Draft sync is
+     * opt-in: the app owner must enable it in the dashboard, and the draft text
+     * crosses the relay in cleartext (it is fanned out, never stored). If the
+     * feature is disabled the server silently drops the frame.
+     */
+    syncDraft(conversationId, draftText) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('DropOnAir websocket is not connected');
+        }
+        const frame = {
+            type: 'SYNC_DRAFT',
+            messageId: '',
+            conversationId,
+            timestamp: Date.now(),
+            payload: draftText,
+        };
+        this.ws.send(this.codec.encodeSyncFrame(frame));
+    }
+    /** Register a listener for notification-clear syncs from the user's other devices. */
+    onNotificationCleared(callback) {
+        this.notificationClearListeners.add(callback);
+        return () => this.notificationClearListeners.delete(callback);
+    }
+    /** Register a listener for draft syncs from the user's other devices. */
+    onDraftSync(callback) {
+        this.draftSyncListeners.add(callback);
+        return () => this.draftSyncListeners.delete(callback);
+    }
     handleIncomingSync(frame) {
         if (frame.type === 'SYNC_READ_RECEIPT') {
             const event = {
@@ -681,6 +731,31 @@ class MessagingClient {
                 catch { /* listener errors must not break the socket */ }
             }
         }
+        else if (frame.type === 'SYNC_CLEAR_NOTIFICATION') {
+            const event = {
+                conversationId: frame.conversationId || '',
+                timestamp: frame.timestamp,
+            };
+            for (const listener of this.notificationClearListeners) {
+                try {
+                    listener(event);
+                }
+                catch { /* listener errors must not break the socket */ }
+            }
+        }
+        else if (frame.type === 'SYNC_DRAFT') {
+            const event = {
+                conversationId: frame.conversationId || '',
+                draftText: frame.payload || '',
+                timestamp: frame.timestamp,
+            };
+            for (const listener of this.draftSyncListeners) {
+                try {
+                    listener(event);
+                }
+                catch { /* listener errors must not break the socket */ }
+            }
+        }
     }
     // ---------------------------------------------------------------------------
     // Cleartext messaging (no E2EE key exchange required)

package/dist/core/types.d.ts

@@ -60,6 +60,26 @@ export interface ReadReceiptEvent {
     timestamp: number;
 }
 export type ReadReceiptCallback = (event: ReadReceiptEvent) => void;
+/**
+ * Delivered to the user's OTHER devices when one device calls
+ * clearNotification(). Use it to clear the conversation's notification badge.
+ */
+export interface NotificationClearEvent {
+    conversationId: string;
+    timestamp: number;
+}
+export type NotificationClearCallback = (event: NotificationClearEvent) => void;
+/**
+ * Delivered to the user's OTHER devices when one device calls syncDraft().
+ * Use it to pre-fill the message composer for that conversation. Draft sync
+ * is opt-in and the text crosses the relay in cleartext.
+ */
+export interface DraftSyncEvent {
+    conversationId: string;
+    draftText: string;
+    timestamp: number;
+}
+export type DraftSyncCallback = (event: DraftSyncEvent) => void;
 export interface BroadcastMessage {
     broadcastId: string;
     channelId: string;
@@ -203,6 +223,20 @@ export interface DropOnAirClient {
     markRead(messageId: string, conversationId?: string): void;
     /** Register a listener for read receipts reported by this user's other devices. */
     onReadReceipt(callback: ReadReceiptCallback): () => void;
+    /**
+     * Tell the user's other devices a conversation's notifications were
+     * dismissed. The app decides what "dismissed" means.
+     */
+    clearNotification(conversationId: string): void;
+    /** Listen for notification-clear syncs from the user's other devices. */
+    onNotificationCleared(callback: NotificationClearCallback): () => void;
+    /**
+     * Push a conversation draft to the user's other devices. Opt-in; the draft
+     * text crosses the relay in cleartext and is never stored.
+     */
+    syncDraft(conversationId: string, draftText: string): void;
+    /** Listen for draft syncs from the user's other devices. */
+    onDraftSync(callback: DraftSyncCallback): () => void;
     /**
      * Register this device's push notification token. The platform delivers a
      * push via APNs / FCM / Web Push when a sender attaches a pushPayload to

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { InitializeOptions, DropOnAirClient } from './core/types';
 export { SDK_VERSION, PROTOCOL_VERSION, PAYLOAD_FORMAT_VERSION } from './version';
 export declare function initialize(options: InitializeOptions): Promise<DropOnAirClient>;
-export type { InitializeOptions, DropOnAirClient, DropOnAirEvent, MessageCallback, EventCallback, DecryptedMessage, KeyStorageAdapter, CallEvent, CallEventType, CallEventCallback, TurnCredentials, BroadcastMessage, BroadcastCallback, GroupInfo, GroupMemberInfo, DecryptedGroupMessage, GroupMessageCallback, GroupCallEvent, GroupCallEventType, GroupCallEventCallback, MessageEditEvent, MessageEditCallback, MessageDeleteEvent, MessageDeleteCallback, DeviceInfo, ReadReceiptEvent, ReadReceiptCallback, } from './core/types';
+export type { InitializeOptions, DropOnAirClient, DropOnAirEvent, MessageCallback, EventCallback, DecryptedMessage, KeyStorageAdapter, CallEvent, CallEventType, CallEventCallback, TurnCredentials, BroadcastMessage, BroadcastCallback, GroupInfo, GroupMemberInfo, DecryptedGroupMessage, GroupMessageCallback, GroupCallEvent, GroupCallEventType, GroupCallEventCallback, MessageEditEvent, MessageEditCallback, MessageDeleteEvent, MessageDeleteCallback, DeviceInfo, ReadReceiptEvent, ReadReceiptCallback, NotificationClearEvent, NotificationClearCallback, DraftSyncEvent, DraftSyncCallback, } from './core/types';
 export type { AttachmentEncryptionType, AttachmentConversationType, AttachmentRef, DeviceWrappedKey, CreateUploadSessionOptions, UploadSession, PrepareAttachmentOptions, DownloadedAttachment, } from './attachment/attachment-types';
 declare const _default: {
     initialize: typeof initialize;

package/dist/transport/protobuf-codec.d.ts

@@ -157,6 +157,7 @@ export interface WireSyncFrame {
     messageId: string;
     conversationId?: string;
     timestamp: number;
+    payload?: string;
 }
 /** Tombstone frame, scope FOR_EVERYONE or FOR_ME. */
 export interface WireMessageDeleteFrame {

package/dist/transport/protobuf-codec.js

@@ -224,7 +224,8 @@ const SyncFrameType = new protobuf.Type('SyncFrame')
     .add(new protobuf.Field('type', 1, 'string'))
     .add(new protobuf.Field('messageId', 2, 'string'))
     .add(new protobuf.Field('conversationId', 3, 'string'))
-    .add(new protobuf.Field('timestamp', 4, 'int64'));
+    .add(new protobuf.Field('timestamp', 4, 'int64'))
+    .add(new protobuf.Field('payload', 5, 'string'));
 class ProtobufCodec {
     encodeEnvelope(value) {
         return EnvelopeType.encode(value).finish();

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.11.0";
+export declare const SDK_VERSION = "0.12.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.11.0';
+exports.SDK_VERSION = '0.12.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.11.0",
+  "version": "0.12.0",
   "description": "DropOnAir SDK for end-to-end encrypted messaging",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",