@webex/plugin-meetings 3.11.0-next.4 → 3.11.0-next.41

package/dist/types/member/index.d.ts

@@ -6,6 +6,7 @@ export type MemberId = string;
 export default class Member {
     associatedUser: MemberId | null;
     associatedUsers: Set<MemberId>;
+    canApproveAIEnablement: boolean;
     canReclaimHost: boolean;
     id: MemberId;
     isAudioMuted: any;

package/dist/types/member/util.d.ts

@@ -5,6 +5,11 @@ declare const MemberUtil: {
      * @returns {Boolean}
      */
     canReclaimHost: (participant: any) => any;
+    /**
+     * @param {Object} participant - The locus participant object.
+     * @returns {Boolean}
+     */
+    canApproveAIEnablement: (participant: any) => boolean;
     /**
      * @param {Object} participant - The locus participant object.
      * @returns {[ServerRoleShape]}

package/dist/types/metrics/constants.d.ts

@@ -87,5 +87,6 @@ declare const BEHAVIORAL_METRICS: {
     MEDIA_ISSUE_DETECTED: string;
     LOCUS_CLASSIC_VS_HASH_TREE_MISMATCH: string;
     LOCUS_HASH_TREE_UNSUPPORTED_OPERATION: string;
+    MEDIA_STILL_NOT_CONNECTED: string;
 };
 export { BEHAVIORAL_METRICS as default };

package/dist/types/reactions/reactions.type.d.ts

@@ -32,6 +32,7 @@ export declare enum SkinToneType {
     dark = "dark"
 }
 export type Sender = {
+    displayName: string;
     participantId: string;
 };
 export type ProcessedReaction = {

package/dist/webinar/index.js

@@ -506,7 +506,7 @@ var Webinar = _webexCore.WebexPlugin.extend({
       }, _callee8);
     }))();
   },
-  version: "3.11.0-next.4"
+  version: "3.11.0-next.41"
 });
 var _default = exports.default = Webinar;
 //# sourceMappingURL=index.js.map

package/package.json

@@ -41,14 +41,15 @@
     "@types/jsdom": "^21",
     "@webex/babel-config-legacy": "0.0.0",
     "@webex/eslint-config-legacy": "0.0.0",
+    "@webex/event-dictionary-ts": "^1.0.2073",
     "@webex/jest-config-legacy": "0.0.0",
     "@webex/legacy-tools": "0.0.0",
-    "@webex/plugin-rooms": "3.11.0-next.1",
-    "@webex/test-helper-chai": "3.10.0-next.1",
-    "@webex/test-helper-mocha": "3.10.0-next.1",
-    "@webex/test-helper-mock-webex": "3.10.0-next.1",
-    "@webex/test-helper-retry": "3.10.0-next.1",
-    "@webex/test-helper-test-users": "3.10.0-next.1",
+    "@webex/plugin-rooms": "3.11.0-next.10",
+    "@webex/test-helper-chai": "3.11.0-next.1",
+    "@webex/test-helper-mocha": "3.11.0-next.1",
+    "@webex/test-helper-mock-webex": "3.11.0-next.1",
+    "@webex/test-helper-retry": "3.11.0-next.1",
+    "@webex/test-helper-test-users": "3.11.0-next.1",
     "chai": "^4.3.4",
     "chai-as-promised": "^7.1.1",
     "eslint": "^8.24.0",
@@ -60,23 +61,22 @@
     "typescript": "^4.7.4"
   },
   "dependencies": {
-    "@webex/common": "3.10.0-next.1",
-    "@webex/event-dictionary-ts": "^1.0.1930",
-    "@webex/internal-media-core": "2.22.0",
-    "@webex/internal-plugin-conversation": "3.11.0-next.1",
-    "@webex/internal-plugin-device": "3.11.0-next.1",
-    "@webex/internal-plugin-llm": "3.11.0-next.1",
-    "@webex/internal-plugin-mercury": "3.11.0-next.1",
-    "@webex/internal-plugin-metrics": "3.11.0-next.1",
-    "@webex/internal-plugin-support": "3.11.0-next.1",
-    "@webex/internal-plugin-user": "3.11.0-next.1",
-    "@webex/internal-plugin-voicea": "3.11.0-next.1",
-    "@webex/media-helpers": "3.11.0-next.1",
-    "@webex/plugin-people": "3.11.0-next.1",
-    "@webex/plugin-rooms": "3.11.0-next.1",
+    "@webex/common": "3.11.0-next.1",
+    "@webex/internal-media-core": "2.22.1",
+    "@webex/internal-plugin-conversation": "3.11.0-next.10",
+    "@webex/internal-plugin-device": "3.11.0-next.7",
+    "@webex/internal-plugin-llm": "3.11.0-next.10",
+    "@webex/internal-plugin-mercury": "3.11.0-next.9",
+    "@webex/internal-plugin-metrics": "3.11.0-next.7",
+    "@webex/internal-plugin-support": "3.11.0-next.10",
+    "@webex/internal-plugin-user": "3.11.0-next.7",
+    "@webex/internal-plugin-voicea": "3.11.0-next.10",
+    "@webex/media-helpers": "3.11.0-next.3",
+    "@webex/plugin-people": "3.11.0-next.9",
+    "@webex/plugin-rooms": "3.11.0-next.10",
     "@webex/ts-sdp": "^1.8.1",
     "@webex/web-capabilities": "^1.9.0",
-    "@webex/webex-core": "3.11.0-next.1",
+    "@webex/webex-core": "3.11.0-next.7",
     "ampersand-collection": "^2.0.2",
     "bowser": "^2.11.0",
     "btoa": "^1.2.1",
@@ -93,5 +93,5 @@
   "//": [
     "TODO: upgrade jwt-decode when moving to node 18"
   ],
-  "version": "3.11.0-next.4"
+  "version": "3.11.0-next.41"
 }

package/src/aiEnableRequest/README.md

@@ -0,0 +1,84 @@
+# AI Assistant Enable Request
+
+The AI Assistant Enable Request feature provides support for requesting and approving the enablement of AI assistant capabilities during a meeting. This feature implements a permission-based workflow where one participant can request to enable the AI assistant, and another participant (typically the host or a cohost) can accept or decline that request.
+
+### Structure
+
+The AI Enable Request plugin manages the approval workflow for enabling AI assistant functionality in meetings. It handles sending requests, receiving approval events, and processing responses.
+
+### Events
+
+The plugin emits events when approval requests are received:
+
+```javascript
+// Listen for approval request events
+meeting.aiEnableRequest.on('approval-request-arrived', (event) => {
+  const {actionType, isApprover, isInitiator, initiatorId, approverId, url} = event;
+
+  if (isApprover) {
+    // This participant received a request
+    console.log(`Received ${actionType} from ${initiatorId}`);
+  }
+
+  if (isInitiator) {
+    // This participant sent a request that was processed
+    console.log(`Your ${actionType} request was processed`);
+  }
+});
+```
+
+### Initiator (requester) functionality
+
+The following method is available to participants who want to request AI assistant enablement:
+
+```javascript
+// Request to enable AI assistant, specifying the approver's participant ID
+meeting.aiEnableRequest.requestEnableAIAssistant({
+  approverId: 'approver-participant-id',
+});
+```
+
+### Approver functionality
+
+The following methods are available to participants who receive AI assistant enable requests:
+
+```javascript
+// Accept an AI assistant enable request
+// url and initiatorId come from the 'approval-request-arrived' event
+meeting.aiEnableRequest.acceptEnableAIAssistantRequest({
+  url: approvalUrl,
+  initiatorId,
+});
+
+// Decline an AI assistant enable request
+meeting.aiEnableRequest.declineEnableAIAssistantRequest({
+  url: approvalUrl,
+  initiatorId,
+});
+
+// Decline all pending AI assistant enable requests
+meeting.aiEnableRequest.declineAllEnableAIAssistantRequests({
+  url: approvalUrl,
+  initiatorId,
+});
+```
+
+### Example workflow
+
+```javascript
+// Participant A requests to enable AI assistant
+await meeting.aiEnableRequest.requestEnableAIAssistant({
+  approverId: participantB.id,
+});
+
+// Participant B receives the request via event
+meeting.aiEnableRequest.on('approval-request-arrived', async (event) => {
+  if (event.isApprover && event.actionType === 'REQUESTED') {
+    // User can now choose to accept or decline
+    await meeting.aiEnableRequest.acceptEnableAIAssistantRequest({
+      url: event.url,
+      initiatorId: event.initiatorId,
+    });
+  }
+});
+```

package/src/aiEnableRequest/index.ts

@@ -0,0 +1,170 @@
+/*!
+ * Copyright (c) 2015-2026 Cisco Systems, Inc. See LICENSE file.
+ */
+import {WebexPlugin} from '@webex/webex-core';
+import {AI_ENABLE_REQUEST, HTTP_VERBS, LOCUSEVENT, MEETINGS} from '../constants';
+
+/**
+ * @class AIEnableRequest
+ */
+const AIEnableRequest = WebexPlugin.extend({
+  namespace: MEETINGS,
+
+  props: {
+    approvalUrl: 'string',
+    selfParticipantId: 'string',
+    hasSubscribedToEvents: 'boolean',
+  },
+
+  /**
+   * Update the approval url for handoff
+   * @param {string} approvalUrl
+   * @returns {void}
+   */
+  approvalUrlUpdate(approvalUrl) {
+    this.set('approvalUrl', approvalUrl);
+  },
+
+  /**
+   * Update the self participant id
+   * @param {string} selfParticipantId
+   * @returns {void}
+   */
+  selfParticipantIdUpdate(selfParticipantId) {
+    this.set('selfParticipantId', selfParticipantId);
+
+    if (!this.hasSubscribedToEvents) {
+      this.listenToApprovalRequests();
+      this.set('hasSubscribedToEvents', true);
+    }
+  },
+
+  /**
+   * Listen to locus approval request events and trigger a new event with necessary details when an AI enablement approval request is received
+   * @returns {void}
+   */
+  listenToApprovalRequests() {
+    this.listenTo(this.webex.internal.mercury, `event:${LOCUSEVENT.APPROVAL_REQUEST}`, (event) => {
+      if (event?.data?.approval?.resourceType === AI_ENABLE_REQUEST.RESOURCE_TYPE) {
+        const {receivers, initiator, actionType, url} = event.data.approval;
+        const approverId = receivers?.[0]?.participantId;
+        const isApprover = !!approverId && approverId === this.selfParticipantId;
+        const initiatorId = initiator?.participantId;
+        const isInitiator = !!initiatorId && initiatorId === this.selfParticipantId;
+        if (
+          !isApprover &&
+          !isInitiator &&
+          // Not just the initiator needs to know about declined all because
+          // all future requests will be rejected if the meeting is in the declined all state
+          actionType !== AI_ENABLE_REQUEST.ACTION_TYPE.DECLINED_ALL
+        ) {
+          return;
+        }
+        this.trigger(AI_ENABLE_REQUEST.EVENTS.APPROVAL_REQUEST_ARRIVED, {
+          actionType,
+          isApprover,
+          isInitiator,
+          initiatorId,
+          approverId,
+          url,
+        });
+      }
+    });
+  },
+
+  /**
+   * Helper method to send AI assistant request
+   * @param {Object} params
+   * @param {string} params.url approval url
+   * @param {string} params.actionType the type of action (REQUESTED, ACCEPTED, DECLINED, DECLINED_ALL)
+   * @param {string} params.initiatorId
+   * @param {string} params.approverId
+   * @param {string} params.method HTTP method to use for the request
+   * @returns {Promise}
+   */
+  sendApprovalRequest({url, actionType, initiatorId, approverId, method}) {
+    return this.request({
+      method,
+      uri: url,
+      body: {
+        actionType,
+        resourceType: AI_ENABLE_REQUEST.RESOURCE_TYPE,
+        initiator: {
+          participantId: initiatorId,
+        },
+        approver: {
+          participantId: approverId,
+        },
+      },
+    });
+  },
+
+  /**
+   * Sends a request to enable the AI assistant
+   * @param {Object} params
+   * @param {string} params.approverId
+   * @returns {Promise}
+   */
+  requestEnableAIAssistant({approverId}) {
+    return this.sendApprovalRequest({
+      url: this.approvalUrl,
+      actionType: AI_ENABLE_REQUEST.ACTION_TYPE.REQUESTED,
+      initiatorId: this.selfParticipantId,
+      approverId,
+      method: HTTP_VERBS.POST,
+    });
+  },
+
+  /**
+   * Sends a request to accept the AI assistant enablement
+   * @param {Object} params
+   * @param {string} params.url approval url
+   * @param {string} params.initiatorId
+   * @returns {Promise}
+   */
+  acceptEnableAIAssistantRequest({url, initiatorId}) {
+    return this.sendApprovalRequest({
+      url,
+      actionType: AI_ENABLE_REQUEST.ACTION_TYPE.ACCEPTED,
+      initiatorId,
+      approverId: this.selfParticipantId,
+      method: HTTP_VERBS.PUT,
+    });
+  },
+
+  /**
+   * Sends a request to decline the AI assistant enablement
+   * @param {Object} params
+   * @param {string} params.url approval url
+   * @param {string} params.initiatorId
+   * @returns {Promise}
+   */
+  declineEnableAIAssistantRequest({url, initiatorId}) {
+    return this.sendApprovalRequest({
+      url,
+      actionType: AI_ENABLE_REQUEST.ACTION_TYPE.DECLINED,
+      initiatorId,
+      approverId: this.selfParticipantId,
+      method: HTTP_VERBS.PUT,
+    });
+  },
+
+  /**
+   * Sends a request to decline all AI assistant enablement requests
+   * @param {Object} params
+   * @param {string} params.url approval url
+   * @param {string} params.initiatorId
+   * @returns {Promise}
+   */
+  declineAllEnableAIAssistantRequests({url, initiatorId}) {
+    return this.sendApprovalRequest({
+      url,
+      actionType: AI_ENABLE_REQUEST.ACTION_TYPE.DECLINED_ALL,
+      initiatorId,
+      approverId: this.selfParticipantId,
+      method: HTTP_VERBS.PUT,
+    });
+  },
+});
+
+export default AIEnableRequest;

package/src/aiEnableRequest/utils.ts

@@ -0,0 +1,25 @@
+/* eslint-disable import/prefer-default-export */
+import Meeting from '../meeting';
+
+export const getAIEnablementApprover = (meeting: Meeting) => {
+  const members = Object.values(meeting.members.membersCollection.members);
+
+  // find the host, if the host has the capability, return the host id
+  const host = members.find((member) => member.roles.moderator && member.canApproveAIEnablement);
+
+  if (host) {
+    return host.id;
+  }
+
+  // find the cohosts, if the host has the capability, return the host id
+  const cohosts = members
+    .filter((member) => member.roles.cohost && member.canApproveAIEnablement)
+    .sort((a, b) => a.id.localeCompare(b.id));
+
+  if (cohosts.length > 0) {
+    return cohosts[0].id;
+  }
+
+  // if no cohost has the capability, return null
+  return null;
+};

package/src/annotation/index.ts

@@ -13,7 +13,7 @@ import {
 } from './constants';
 
 import {StrokeData, RequestData, IAnnotationChannel, CommandRequestBody} from './annotation.types';
-import {HTTP_VERBS} from '../constants';
+import {HTTP_VERBS, LOCUSEVENT} from '../constants';
 
 /**
  * @description Annotation to handle LLM and Mercury message and locus API
@@ -69,7 +69,7 @@ class AnnotationChannel extends WebexPlugin implements IAnnotationChannel {
    */
   private eventCommandProcessor(e) {
     if (
-      e?.data?.eventType === 'locus.approval_request' &&
+      e?.data?.eventType === LOCUSEVENT.APPROVAL_REQUEST &&
       e?.data?.approval?.resourceType === ANNOTATION_RESOURCE_TYPE &&
       e?.data?.approval?.actionType
     ) {
@@ -110,7 +110,7 @@ class AnnotationChannel extends WebexPlugin implements IAnnotationChannel {
     if (!this.hasSubscribedToEvents) {
       // @ts-ignore
       this.webex.internal.mercury.on(
-        'event:locus.approval_request',
+        `event:${LOCUSEVENT.APPROVAL_REQUEST}`,
         this.eventCommandProcessor,
         this
       );
@@ -127,7 +127,10 @@ class AnnotationChannel extends WebexPlugin implements IAnnotationChannel {
   public deregisterEvents() {
     if (this.hasSubscribedToEvents) {
       // @ts-ignore
-      this.webex.internal.mercury.off('event:locus.approval_request', this.eventCommandProcessor);
+      this.webex.internal.mercury.off(
+        `event:${LOCUSEVENT.APPROVAL_REQUEST}`,
+        this.eventCommandProcessor
+      );
 
       // @ts-ignore
       this.webex.internal.llm.off('event:relay.event', this.eventDataProcessor);

package/src/config.ts

@@ -101,5 +101,8 @@ export default {
     stopIceGatheringAfterFirstRelayCandidate: false,
     enableAudioTwccForMultistream: false,
     enablePerUdpUrlReachability: false, // true: separate peer connection per each UDP URL; false: single peer connection for all URLs
+    locus: {
+      excludedDataSets: ['attendees'], // attendees data set only applies to webinar attendees and we never really need that
+    },
   },
 };

package/src/constants.ts

@@ -364,6 +364,8 @@ export const EVENT_TRIGGERS = {
   MEETING_CONTROLS_VIEW_THE_PARTICIPANTS_LIST_UPDATED:
     'meeting:controls:view-the-participants-list:updated',
   MEETING_CONTROLS_RAISE_HAND_UPDATED: 'meeting:controls:raise-hand:updated',
+  MEETING_CONTROLS_AI_SUMMARY_NOTIFICATION_UPDATED:
+    'meeting:controls:ai-summary-notification:updated',
   MEETING_CONTROLS_VIDEO_UPDATED: 'meeting:controls:video:updated',
   MEETING_CONTROLS_STAGE_VIEW_UPDATED: 'meeting:controls:stage-view:updated',
   MEETING_CONTROLS_WEBCAST_UPDATED: 'meeting:controls:webcast:updated',
@@ -387,6 +389,7 @@ export const EVENT_TRIGGERS = {
   MEETING_MANUAL_CAPTION_UPDATED: 'meeting:manualCaptionControl:updated',
   MEETING_CAPTION_RECEIVED: 'meeting:caption-received',
   MEETING_PARTICIPANT_REASON_CHANGED: 'meeting:participant-reason-changed',
+  MEETING_AI_ENABLE_REQUEST: 'meeting:aiEnableRequest',
 };
 
 export const EVENT_TYPES = {
@@ -413,7 +416,6 @@ export const HEADERS = {
 // Meeting actually ended
 export const MEETING_REMOVED_REASON = {
   SELF_REMOVED: 'SELF_REMOVED', // server or host removed you from the meeting
-  FULLSTATE_REMOVED: 'FULLSTATE_REMOVED', // meeting got dropped ? not sure
   MEETING_INACTIVE_TERMINATING: 'MEETING_INACTIVE_TERMINATING', // Meeting got ended or everyone left the meeting
   CLIENT_LEAVE_REQUEST: 'CLIENT_LEAVE_REQUEST', // You triggered leave meeting
   CLIENT_LEAVE_REQUEST_TAB_CLOSED: 'CLIENT_LEAVE_REQUEST_TAB_CLOSED', // You triggered leave meeting, such as closing the browser tab directly
@@ -704,6 +706,7 @@ export const LOCUSINFO = {
     CONTROLS_MEETING_LAYOUT_UPDATED: 'CONTROLS_MEETING_LAYOUT_UPDATED',
     CONTROLS_RECORDING_UPDATED: 'CONTROLS_RECORDING_UPDATED',
     CONTROLS_MEETING_TRANSCRIBE_UPDATED: 'CONTROLS_MEETING_TRANSCRIBE_UPDATED',
+    CONTROLS_AI_SUMMARY_NOTIFICATION_UPDATED: 'CONTROLS_AI_SUMMARY_NOTIFICATION_UPDATED',
     CONTROLS_MEETING_TRANSCRIPTION_SPOKEN_LANGUAGE_UPDATED:
       'CONTROLS_MEETING_TRANSCRIPTION_SPOKEN_LANGUAGE_UPDATED',
     CONTROLS_MEETING_MANUAL_CAPTION_UPDATED: 'CONTROLS_MEETING_MANUAL_CAPTION_UPDATED',
@@ -750,6 +753,7 @@ export const LOCUSINFO = {
     SELF_IS_SHARING_BLOCKED_CHANGE: 'SELF_IS_SHARING_BLOCKED_CHANGE',
     SELF_MEETING_BREAKOUTS_CHANGED: 'SELF_MEETING_BREAKOUTS_CHANGED',
     SELF_MEETING_INTERPRETATION_CHANGED: 'SELF_MEETING_INTERPRETATION_CHANGED',
+    SELF_ID_CHANGED: 'SELF_ID_CHANGED',
     SELF_MEETING_BRB_CHANGED: 'SELF_MEETING_BRB_CHANGED',
     MEDIA_INACTIVITY: 'MEDIA_INACTIVITY',
     LINKS_SERVICES: 'LINKS_SERVICES',
@@ -797,6 +801,8 @@ export const LOCUSEVENT = {
 
   HASH_TREE_DATA_UPDATED: 'locus.state_message',
 
+  APPROVAL_REQUEST: 'locus.approval_request',
+
   // events generated internally by SDK
   SDK_LOCUS_FROM_SYNC_MEETINGS: 'jsSdk.locus_from_sync_meetings', // generated for each meeting from response to GET /loci Locus API call
   SDK_NO_EVENT: 'jsSdk.no_event', // used in cases where eventType is irrelevant
@@ -977,6 +983,8 @@ export const DISPLAY_HINTS = {
   LOWER_SOMEONE_ELSES_HAND: 'LOWER_SOMEONE_ELSES_HAND',
   LEAVE_TRANSFER_HOST_END_MEETING: 'LEAVE_TRANSFER_HOST_END_MEETING',
   LEAVE_END_MEETING: 'LEAVE_END_MEETING',
+  END_MEETING: 'END_MEETING',
+  REQUIRE_HOST_END_MEETING_BEFORE_LEAVE: 'REQUIRE_HOST_END_MEETING_BEFORE_LEAVE',
   STREAMING_STATUS_STARTED: 'STREAMING_STATUS_STARTED',
   STREAMING_STATUS_STOPPED: 'STREAMING_STATUS_STOPPED',
   CAPTION_START: 'CAPTION_START',
@@ -1080,6 +1088,10 @@ export const DISPLAY_HINTS = {
   // Polling QA
   ENABLE_ATTENDEE_START_POLLING_QA: 'ENABLE_ATTENDEE_START_POLLING_QA',
   DISABLE_ATTENDEE_START_POLLING_QA: 'DISABLE_ATTENDEE_START_POLLING_QA',
+
+  // AI
+  ATTENDEE_REQUEST_AI_ASSISTANT_ENABLED: 'ATTENDEE_REQUEST_AI_ASSISTANT_ENABLED',
+  ATTENDEE_REQUEST_AI_ASSISTANT_DECLINED_ALL: 'ATTENDEE_REQUEST_AI_ASSISTANT_DECLINED_ALL',
 };
 
 export const INTERSTITIAL_DISPLAY_HINTS = [DISPLAY_HINTS.VOIP_IS_ENABLED];
@@ -1403,3 +1415,16 @@ export const STAGE_MANAGER_TYPE = {
 };
 
 export const DEFAULT_LARGE_SCALE_WEBINAR_ATTENDEE_SEARCH_LIMIT = 50;
+
+export const AI_ENABLE_REQUEST = {
+  EVENTS: {
+    APPROVAL_REQUEST_ARRIVED: 'APPROVAL_REQUEST_ARRIVED',
+  },
+  ACTION_TYPE: {
+    REQUESTED: 'REQUESTED',
+    ACCEPTED: 'ACCEPTED',
+    DECLINED: 'DECLINED',
+    DECLINED_ALL: 'DECLINED_ALL',
+  },
+  RESOURCE_TYPE: 'AiAssistant',
+};

package/src/hashTree/constants.ts

@@ -6,4 +6,5 @@ export const DataSetNames = {
   ATD_ACTIVE: 'atd-active', // only sent to panelists, over LLM; the attendees that have their hands raised or are allowed to unmute themselves
   ATD_UNMUTED: 'atd-unmuted', // sent to web client, over LLM, not sent to panelists; the attendees that are unmuted
   SELF: 'self', // sent to web client, over Mercury
+  UNJOINED: 'unjoined', // sent when you are not joined, but can still see some stuff from the meeting (mutually exclusive with "main")
 };

package/src/hashTree/hashTree.ts

@@ -371,6 +371,23 @@ class HashTree {
     return items;
   }
 
+  /**
+   * Retrieves the version of a specific item by its id and type.
+   * @param {number} id The ID of the item.
+   * @param {ObjectType} type The type of the item.
+   * @returns {number | undefined} The version of the item if found, undefined otherwise.
+   */
+  getItemVersion(id: number, type: ObjectType): number | undefined {
+    if (this.numLeaves === 0) {
+      return undefined;
+    }
+
+    const index = id % this.numLeaves;
+    const item = this.leaves[index]?.[type]?.[id];
+
+    return item?.version;
+  }
+
   /**
    * Resizes the HashTree to have a new number of leaf nodes, redistributing all existing items.
    * @param {number} newNumLeaves The new number of leaf nodes (must be 0 or a power of 2).