quickblox 2.24.0 → 2.24.1-alpha.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "quickblox",
   "description": "QuickBlox JavaScript SDK",
-  "version": "2.24.0",
+  "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
@@ -35156,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 = {
@@ -40569,8 +40623,8 @@ module.exports = StreamManagement;
  */
 
 var config = {
-  version: '2.24.0',
-  buildNumber: '1180',
+  version: '2.24.1-alpha.0',
+  buildNumber: '1181',
   creds: {
     'appId': 0,
     'authKey': '',