quickblox 2.24.0-beta.1 → 2.24.1-alpha.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "quickblox",
   "description": "QuickBlox JavaScript SDK",
-  "version": "2.24.0-beta.1",
+  "version": "2.24.1-alpha.0",
   "homepage": "https://quickblox.com/developers/Javascript",
   "main": "src/qbMain.js",
   "types": "quickblox.d.ts",

package/quickblox.d.ts

@@ -418,6 +418,26 @@ export declare interface QBChatMessage {
    * Available since SDK 2.24.0.
    */
   reactions?: QBReaction[]
+  /**
+   * Message editing flag (SR-2955). The server sets `1` when the message was
+   * edited, `0`/`null` otherwise. Delivered on the message object in REST
+   * responses (`message.list` / `message.getById`). Note: the server also carries it
+   * in `NoticeUpdatedMessage` (server release 2.94.0), but the SDK's real-time
+   * `onMessageUpdatedListener` object does not currently include it — read it from
+   * a REST fetch of the message.
+   * Available since SDK 2.24.0.
+   */
+  is_edited?: 0 | 1 | boolean | null
+  /**
+   * ID of the user who last edited the message (SR-2955). Omitted/`null` when the
+   * message was never edited. Available since SDK 2.24.0.
+   */
+  editor_id?: number | null
+  /**
+   * ISO timestamp of the last edit (SR-2955). Omitted/`null` when the message was
+   * never edited. Available since SDK 2.24.0.
+   */
+  edited_at?: string | null
   /**
    * Name of the custom field.
    * Chat message can be extended with additional fields and contain any other user key-value custom parameters.
@@ -683,7 +703,8 @@ interface QBChatModule {
   /**
    * Subscribe the current XMPP session to Notice Feature stanzas (urn:xmpp:notice:0).
    * After a successful IQ result the server starts delivering NoticeUpdatedMessage /
-   * NoticeDeletedMessage / NoticeUpdatedDialog / NoticeDeletedDialog headline stanzas.
+   * NoticeDeletedMessage / NoticeCreatedDialog / NoticeUpdatedDialog / NoticeDeletedDialog
+   * headline stanzas.
    * The local enabled flag is reset on chat disconnect — call enableNotices() again after reconnect.
    * @since 2.24.0
    */
@@ -749,6 +770,18 @@ interface QBChatModule {
    * @since 2.24.0
    */
   onDialogUpdatedListener?: (dialog: QBChatDialog) => void
+  /**
+   * Notice Feature: a Group or Private dialog was created (SR-2952). Delivered via the
+   * XMPP `NoticeCreatedDialog` headline stanza after `enableNotices()`, only to users
+   * with the Notice feature enabled. NOT sent for Public dialogs.
+   *
+   * The dialog object is a PARTIAL snapshot captured at creation time: it carries
+   * `created_at` / `updated_at` / `user_id` (creator) and the base fields, but has no
+   * `last_message*` fields (the dialog is brand new) and, for a private dialog, no
+   * `xmpp_room_jid`. Preserves the existing QBChatDialog snake_case shape.
+   * @since 2.24.1
+   */
+  onDialogCreatedListener?: (dialog: QBChatDialog) => void
   /** Blocked entities receive an error when try to chat with a user in a 1-1 chat and receivie nothing in a group chat. */
   onMessageErrorListener?: (messageId: QBChatMessage['_id'], error: any) => void
   /**

package/quickblox.js

@@ -30540,6 +30540,7 @@ NOTICE_KNOWN_MODULE_IDS[noticeConsts.NOTICE_MODULE_IDENTIFIER.UPDATED_MESSAGE] =
 NOTICE_KNOWN_MODULE_IDS[noticeConsts.NOTICE_MODULE_IDENTIFIER.DELETED_MESSAGE] = true;
 NOTICE_KNOWN_MODULE_IDS[noticeConsts.NOTICE_MODULE_IDENTIFIER.UPDATED_DIALOG] = true;
 NOTICE_KNOWN_MODULE_IDS[noticeConsts.NOTICE_MODULE_IDENTIFIER.DELETED_DIALOG] = true;
+NOTICE_KNOWN_MODULE_IDS[noticeConsts.NOTICE_MODULE_IDENTIFIER.CREATED_DIALOG] = true;
 
 /**
  * Cross-env: get all direct child elements of `parent` whose tag name equals
@@ -30823,6 +30824,91 @@ function _parseCustomData(extraParams) {
     return out;
 }
 
+/**
+ * Build a partial QBChatDialog object from a dialog-notice <extraParams>.
+ * Shared by NoticeUpdatedDialog and NoticeCreatedDialog (SR-2952) — the server
+ * sends a full dialog snapshot in both cases. Fields with null/empty values are
+ * omitted by the server, so every read is guarded.
+ *
+ * CreatedDialog additionally carries created_at/updated_at/user_id (creator) and
+ * has no last_message* fields (dialog just created); UpdatedDialog carries
+ * last_message* and (per server contract) may also carry created_at/updated_at/
+ * user_id. Reading them here for both is safe — absent fields are simply skipped.
+ *
+ * @param {Element} extraParams
+ * @param {String} dialogId - already-resolved dialog_id text.
+ * @return {Object} partial dialog snapshot.
+ */
+function _parseDialogSnapshot(extraParams, dialogId) {
+    var dlg = {};
+    dlg._id = dialogId;
+
+    var name = chatUtils.getElementText(extraParams, 'name');
+    if (name !== undefined && name !== null && name !== '') {
+        dlg.name = name;
+    }
+    var photo = chatUtils.getElementText(extraParams, 'photo');
+    if (photo !== undefined && photo !== null && photo !== '') {
+        dlg.photo = photo;
+    }
+    var typeText = chatUtils.getElementText(extraParams, 'type');
+    var typeNum = parseInt(typeText, 10);
+    if (!isNaN(typeNum)) {
+        dlg.type = typeNum;
+    }
+    var occupants = _parseNumericIdsCsv(chatUtils.getElementText(extraParams, 'occupants_ids'));
+    if (occupants.length > 0) {
+        dlg.occupants_ids = occupants;
+    }
+    var admins = _parseNumericIdsCsv(chatUtils.getElementText(extraParams, 'admin_ids'));
+    if (admins.length > 0) {
+        dlg.admin_ids = admins;
+    }
+    var isJoinReqText = chatUtils.getElementText(extraParams, 'is_join_required');
+    if (isJoinReqText !== undefined && isJoinReqText !== null && isJoinReqText !== '') {
+        var isJoinReq = parseInt(isJoinReqText, 10);
+        dlg.is_join_required = isNaN(isJoinReq) ? isJoinReqText : isJoinReq;
+    }
+    var roomJid = chatUtils.getElementText(extraParams, 'xmpp_room_jid');
+    if (roomJid !== undefined && roomJid !== null && roomJid !== '') {
+        // Server may pretty-print xmpp_room_jid with surrounding whitespace.
+        dlg.xmpp_room_jid = roomJid.trim();
+    }
+    var customData = _parseCustomData(extraParams);
+    if (customData !== undefined) {
+        dlg.custom_data = customData;
+    }
+    // Creation / modification metadata (present on CreatedDialog; also valid on
+    // UpdatedDialog per server contract). Kept as ISO-8601 strings verbatim.
+    var createdAt = chatUtils.getElementText(extraParams, 'created_at');
+    if (createdAt !== undefined && createdAt !== null && createdAt !== '') {
+        dlg.created_at = createdAt;
+    }
+    var updatedAt = chatUtils.getElementText(extraParams, 'updated_at');
+    if (updatedAt !== undefined && updatedAt !== null && updatedAt !== '') {
+        dlg.updated_at = updatedAt;
+    }
+    var userIdText = chatUtils.getElementText(extraParams, 'user_id');
+    var userId = parseInt(userIdText, 10);
+    if (!isNaN(userId)) {
+        dlg.user_id = userId;
+    }
+    // Last message fields (present on UpdatedDialog; absent on a freshly
+    // CreatedDialog — the guards below simply skip them then).
+    var lmText = chatUtils.getElementText(extraParams, 'last_message');
+    if (lmText) { dlg.last_message = lmText; }
+    var lmId = chatUtils.getElementText(extraParams, 'last_message_id');
+    if (lmId) { dlg.last_message_id = lmId; }
+    var lmDsText = chatUtils.getElementText(extraParams, 'last_message_date_sent');
+    var lmDs = parseInt(lmDsText, 10);
+    if (!isNaN(lmDs)) { dlg.last_message_date_sent = lmDs; }
+    var lmUidText = chatUtils.getElementText(extraParams, 'last_message_user_id');
+    var lmUid = parseInt(lmUidText, 10);
+    if (!isNaN(lmUid)) { dlg.last_message_user_id = lmUid; }
+
+    return dlg;
+}
+
 /**
  * Parse a Notice headline stanza into {type, payload} ready for routing.
  * Returns null if stanza is not a Notice (no urn:xmpp:notice:0 namespace, or
@@ -30918,59 +31004,12 @@ function _parseNoticeStanza(stanza) {
                 message: msg
             };
         }
-    } else if (type === IDS.UPDATED_DIALOG) {
-        // Build a partial QBChatDialog object from extraParams (full server snapshot).
-        var dlg = {};
-        dlg._id = dialogId;
-        var name = chatUtils.getElementText(extraParams, 'name');
-        if (name !== undefined && name !== null && name !== '') {
-            dlg.name = name;
-        }
-        var photo = chatUtils.getElementText(extraParams, 'photo');
-        if (photo !== undefined && photo !== null && photo !== '') {
-            dlg.photo = photo;
-        }
-        var typeText = chatUtils.getElementText(extraParams, 'type');
-        var typeNum = parseInt(typeText, 10);
-        if (!isNaN(typeNum)) {
-            dlg.type = typeNum;
-        }
-        var occupants = _parseNumericIdsCsv(chatUtils.getElementText(extraParams, 'occupants_ids'));
-        if (occupants.length > 0) {
-            dlg.occupants_ids = occupants;
-        }
-        var admins = _parseNumericIdsCsv(chatUtils.getElementText(extraParams, 'admin_ids'));
-        if (admins.length > 0) {
-            dlg.admin_ids = admins;
-        }
-        var isJoinReqText = chatUtils.getElementText(extraParams, 'is_join_required');
-        if (isJoinReqText !== undefined && isJoinReqText !== null && isJoinReqText !== '') {
-            var isJoinReq = parseInt(isJoinReqText, 10);
-            dlg.is_join_required = isNaN(isJoinReq) ? isJoinReqText : isJoinReq;
-        }
-        var roomJid = chatUtils.getElementText(extraParams, 'xmpp_room_jid');
-        if (roomJid !== undefined && roomJid !== null && roomJid !== '') {
-            dlg.xmpp_room_jid = roomJid;
-        }
-        var customData = _parseCustomData(extraParams);
-        if (customData !== undefined) {
-            dlg.custom_data = customData;
-        }
-        // Last message fields.
-        var lmText = chatUtils.getElementText(extraParams, 'last_message');
-        if (lmText) { dlg.last_message = lmText; }
-        var lmId = chatUtils.getElementText(extraParams, 'last_message_id');
-        if (lmId) { dlg.last_message_id = lmId; }
-        var lmDsText = chatUtils.getElementText(extraParams, 'last_message_date_sent');
-        var lmDs = parseInt(lmDsText, 10);
-        if (!isNaN(lmDs)) { dlg.last_message_date_sent = lmDs; }
-        var lmUidText = chatUtils.getElementText(extraParams, 'last_message_user_id');
-        var lmUid = parseInt(lmUidText, 10);
-        if (!isNaN(lmUid)) { dlg.last_message_user_id = lmUid; }
-
+    } else if (type === IDS.UPDATED_DIALOG || type === IDS.CREATED_DIALOG) {
+        // Full server dialog snapshot. UpdatedDialog and CreatedDialog (SR-2952)
+        // share the same shape; they differ only by moduleIdentifier (routing).
         payload = {
             kind: 'dialog',
-            dialog: dlg
+            dialog: _parseDialogSnapshot(extraParams, dialogId)
         };
     } else {
         return null;
@@ -31017,6 +31056,10 @@ function _routeNoticeEvent(chatProxy, parsed) {
         if (typeof chatProxy.onDialogUpdatedListener === 'function') {
             Utils.safeCallbackCall(chatProxy.onDialogUpdatedListener, p.dialog);
         }
+    } else if (type === IDS.CREATED_DIALOG) {
+        if (typeof chatProxy.onDialogCreatedListener === 'function') {
+            Utils.safeCallbackCall(chatProxy.onDialogCreatedListener, p.dialog);
+        }
     }
 }
 
@@ -31117,6 +31160,15 @@ function ChatProxy(service) {
     this.onMessageReactionChangedListener = null;
     this.onDialogDeletedListener = null;
     this.onDialogUpdatedListener = null;
+    /**
+     * NoticeCreatedDialog listener (SR-2952). Fired when a Group or Private
+     * dialog is created and the current user has the Notice feature enabled.
+     * Signature: onDialogCreatedListener(dialog). The dialog is a partial
+     * snapshot from the creation notice — it carries created_at/updated_at/
+     * user_id (creator) but no last_message* fields (the dialog is brand new),
+     * and for a private dialog no xmpp_room_jid. Not fired for Public dialogs.
+     */
+    this.onDialogCreatedListener = null;
 
     // [QC-1550] XMPP connection is considered "verified" only after the first
     // successful pong response. Strophe emits Status.CONNECTED at the transport
@@ -32961,7 +33013,8 @@ ChatProxy.prototype = {
      * Subscribe the current XMPP session to Notice Feature stanzas
      * (urn:xmpp:notice:0). After a successful IQ result the server starts
      * delivering NoticeUpdatedMessage / NoticeDeletedMessage /
-     * NoticeUpdatedDialog / NoticeDeletedDialog headline stanzas.
+     * NoticeCreatedDialog / NoticeUpdatedDialog / NoticeDeletedDialog
+     * headline stanzas.
      *
      * The local enabled flag is reset to false on chat disconnect — consumers
      * must call enableNotices() again after a reconnect (intentional divergence
@@ -32969,10 +33022,8 @@ ChatProxy.prototype = {
      *
      * TODO(2.25.0): make auto-enable SDK-internal — fire on initial connect and
      * on relogin after session-expired, skip on Stream-Management reconnect.
-     * Spec & three-state matrix:
-     *   __ai-work-log/sdk-js/tasks/ad-hoc-2026-05-05-notice-reaction-admin-role/
-     *     backlog-2.25.0-auto-enable-notices.md
-     *     jira-stories/_jira-src-06-auto-enable-notices.md
+     * Spec & three-state matrix are tracked in the internal 2.25.0 backlog
+     * (auto-enable notices).
      *
      * Do not call enableNotices again before the previous callback fires —
      * concurrent enable calls are not specified.
@@ -35158,7 +35209,8 @@ var NOTICE_MODULE_IDENTIFIER = {
     UPDATED_MESSAGE: 'NoticeUpdatedMessage',
     DELETED_MESSAGE: 'NoticeDeletedMessage',
     UPDATED_DIALOG:  'NoticeUpdatedDialog',
-    DELETED_DIALOG:  'NoticeDeletedDialog'
+    DELETED_DIALOG:  'NoticeDeletedDialog',
+    CREATED_DIALOG:  'NoticeCreatedDialog'
 };
 
 module.exports = {
@@ -37778,92 +37830,110 @@ function _getStats(peer, lastResults, successCallback, errorCallback) {
 
     peer.getStats(null).then(function (results) {
         results.forEach(function (result) {
-            var item;
-
-            if (result.bytesReceived && result.type === 'inbound-rtp') {
-                item = statistic.remote[result.mediaType];
-                item.bitrate = _getBitratePerSecond(result, lastResults, false);
-                item.bytesReceived = result.bytesReceived;
-                item.packetsReceived = result.packetsReceived;
-                item.timestamp = result.timestamp;
-                if (result.mediaType === 'video' && result.framerateMean) {
-                    item.framesPerSecond = Math.round(result.framerateMean * 10) / 10;
-                }
-            } else if (result.bytesSent && result.type === 'outbound-rtp') {
-                item = statistic.local[result.mediaType];
-                item.bitrate = _getBitratePerSecond(result, lastResults, true);
-                item.bytesSent = result.bytesSent;
-                item.packetsSent = result.packetsSent;
-                item.timestamp = result.timestamp;
-                if (result.mediaType === 'video' && result.framerateMean) {
-                    item.framesPerSecond = Math.round(result.framerateMean * 10) / 10;
-                }
-            } else if (result.type === 'local-candidate') {
-                item = statistic.local.candidate;
-                if (result.candidateType === 'host' && result.mozLocalTransport === 'udp' && result.transport === 'udp') {
-                    item.protocol = result.transport;
-                    item.ip = result.ipAddress;
-                    item.port = result.portNumber;
-                } else if (!Helpers.getVersionFirefox()) {
-                    item.protocol = result.protocol;
-                    item.ip = result.ip;
-                    item.port = result.port;
-                }
-            } else if (result.type === 'remote-candidate') {
-                item = statistic.remote.candidate;
-                item.protocol = result.protocol || result.transport;
-                item.ip = result.ip || result.ipAddress;
-                item.port = result.port || result.portNumber;
-            } else if (result.type === 'track' && result.kind === 'video' && !Helpers.getVersionFirefox()) {
-                if (result.remoteSource) {
-                    item = statistic.remote.video;
-                    item.frameHeight = result.frameHeight;
-                    item.frameWidth = result.frameWidth;
-                    item.framesPerSecond = _getFramesPerSecond(result, lastResults, false);
-                } else {
-                    item = statistic.local.video;
-                    item.frameHeight = result.frameHeight;
-                    item.frameWidth = result.frameWidth;
-                    item.framesPerSecond = _getFramesPerSecond(result, lastResults, true);
-                }
-            }
+            _applyStatReport(statistic, result, lastResults);
         });
         successCallback(statistic, results);
     }, errorCallback);
+}
+
+function _applyStatReport(statistic, result, lastResults) {
+    var item;
+    // mediaType is deprecated in the W3C webrtc-stats spec and replaced by kind.
+    // Safari/WebKit omits mediaType on some reports and provides only kind, so we
+    // normalize once and use it for both the statistic lookup and the 'video' check.
+    var mediaType = result.mediaType || result.kind;
+
+    if (result.bytesReceived && result.type === 'inbound-rtp') {
+        item = statistic.remote[mediaType];
 
-    function _getBitratePerSecond(result, lastResults, isLocal) {
-        var lastResult = lastResults && lastResults.get(result.id),
-            seconds = lastResult ? ((result.timestamp - lastResult.timestamp) / 1000) : 5,
-            kilo = 1024,
-            bit = 8,
-            bitrate;
-
-        if (!lastResult) {
-            bitrate = 0;
-        } else if (isLocal) {
-            bitrate = bit * (result.bytesSent - lastResult.bytesSent) / (kilo * seconds);
+        if (item) {
+            item.bitrate = _getBitratePerSecond(result, lastResults, false);
+            item.bytesReceived = result.bytesReceived;
+            item.packetsReceived = result.packetsReceived;
+            item.timestamp = result.timestamp;
+            if (mediaType === 'video' && result.framerateMean) {
+                item.framesPerSecond = Math.round(result.framerateMean * 10) / 10;
+            }
         } else {
-            bitrate = bit * (result.bytesReceived - lastResult.bytesReceived) / (kilo * seconds);
+            Helpers.traceWarning('_getStats: skipping inbound-rtp report with unknown mediaType/kind: ' + mediaType);
+        }
+    } else if (result.bytesSent && result.type === 'outbound-rtp') {
+        item = statistic.local[mediaType];
+
+        if (item) {
+            item.bitrate = _getBitratePerSecond(result, lastResults, true);
+            item.bytesSent = result.bytesSent;
+            item.packetsSent = result.packetsSent;
+            item.timestamp = result.timestamp;
+            if (mediaType === 'video' && result.framerateMean) {
+                item.framesPerSecond = Math.round(result.framerateMean * 10) / 10;
+            }
+        } else {
+            Helpers.traceWarning('_getStats: skipping outbound-rtp report with unknown mediaType/kind: ' + mediaType);
+        }
+    } else if (result.type === 'local-candidate') {
+        item = statistic.local.candidate;
+        if (result.candidateType === 'host' && result.mozLocalTransport === 'udp' && result.transport === 'udp') {
+            item.protocol = result.transport;
+            item.ip = result.ipAddress;
+            item.port = result.portNumber;
+        } else if (!Helpers.getVersionFirefox()) {
+            item.protocol = result.protocol;
+            item.ip = result.ip;
+            item.port = result.port;
+        }
+    } else if (result.type === 'remote-candidate') {
+        item = statistic.remote.candidate;
+        item.protocol = result.protocol || result.transport;
+        item.ip = result.ip || result.ipAddress;
+        item.port = result.port || result.portNumber;
+    } else if (result.type === 'track' && result.kind === 'video' && !Helpers.getVersionFirefox()) {
+        if (result.remoteSource) {
+            item = statistic.remote.video;
+            item.frameHeight = result.frameHeight;
+            item.frameWidth = result.frameWidth;
+            item.framesPerSecond = _getFramesPerSecond(result, lastResults, false);
+        } else {
+            item = statistic.local.video;
+            item.frameHeight = result.frameHeight;
+            item.frameWidth = result.frameWidth;
+            item.framesPerSecond = _getFramesPerSecond(result, lastResults, true);
         }
+    }
+}
 
-        return Math.round(bitrate);
+function _getBitratePerSecond(result, lastResults, isLocal) {
+    var lastResult = lastResults && lastResults.get(result.id),
+        seconds = lastResult ? ((result.timestamp - lastResult.timestamp) / 1000) : 5,
+        kilo = 1024,
+        bit = 8,
+        bitrate;
+
+    if (!lastResult) {
+        bitrate = 0;
+    } else if (isLocal) {
+        bitrate = bit * (result.bytesSent - lastResult.bytesSent) / (kilo * seconds);
+    } else {
+        bitrate = bit * (result.bytesReceived - lastResult.bytesReceived) / (kilo * seconds);
     }
 
-    function _getFramesPerSecond(result, lastResults, isLocal) {
-        var lastResult = lastResults && lastResults.get(result.id),
-            seconds = lastResult ? ((result.timestamp - lastResult.timestamp) / 1000) : 5,
-            framesPerSecond;
+    return Math.round(bitrate);
+}
 
-        if (!lastResult) {
-            framesPerSecond = 0;
-        } else if (isLocal) {
-            framesPerSecond = (result.framesSent - lastResult.framesSent) / seconds;
-        } else {
-            framesPerSecond = (result.framesReceived - lastResult.framesReceived) / seconds;
-        }
+function _getFramesPerSecond(result, lastResults, isLocal) {
+    var lastResult = lastResults && lastResults.get(result.id),
+        seconds = lastResult ? ((result.timestamp - lastResult.timestamp) / 1000) : 5,
+        framesPerSecond;
 
-        return Math.round(framesPerSecond * 10) / 10;
+    if (!lastResult) {
+        framesPerSecond = 0;
+    } else if (isLocal) {
+        framesPerSecond = (result.framesSent - lastResult.framesSent) / seconds;
+    } else {
+        framesPerSecond = (result.framesReceived - lastResult.framesReceived) / seconds;
     }
+
+    return Math.round(framesPerSecond * 10) / 10;
 }
 
 // Find the line in sdpLines[startLine...endLine - 1] that starts with |prefix|
@@ -38050,6 +38120,9 @@ function setMediaBitrate(sdp, media, bitrate) {
     return newLines.join('\n');
 }
 
+// PRIVATE - exposed for unit tests only, not part of the public SDK contract.
+qbRTCPeerConnection._applyStatReport = _applyStatReport;
+
 module.exports = qbRTCPeerConnection;
 
 },{"../../qbConfig":152,"./qbWebRTCHelpers":146}],145:[function(require,module,exports){
@@ -40550,8 +40623,8 @@ module.exports = StreamManagement;
  */
 
 var config = {
-  version: '2.24.0-beta.1',
-  buildNumber: '1179',
+  version: '2.24.1-alpha.0',
+  buildNumber: '1181',
   creds: {
     'appId': 0,
     'authKey': '',