@webex/internal-plugin-dss 3.0.0-beta.42 → 3.0.0-beta.420

package/dist/dss.js.map

@@ -1 +1 @@
-{"version":3,"names":["DSS","WebexPlugin","extend","namespace","registered","register","webex","canAuthorize","logger","error","reject","Error","info","resolve","internal","mercury","connect","then","listenForEvents","trigger","DSS_REGISTERED","catch","message","unregister","stopListeningForEvents","disconnect","DSS_UNREGISTERED","on","DSS_LOOKUP_MERCURY_EVENT","envelope","_handleEvent","data","DSS_SEARCH_MERCURY_EVENT","off","_getResultEventName","requestId","DSS_RESULT","DSS_LOOKUP_RESULT","_request","options","resource","params","dataPath","uuid","v4","eventName","result","expectedSeqNums","listenTo","resultData","sequence","finished","map","String","done","resultArray","forEach","index","seqResult","push","stopListening","request","service","DSS_SERVICE_NAME","method","contentType","body","lookupDetail","id","device","orgId","lookup","ids","entityProviderType","lookupValues","lookupByEmail","emails","search","requestedTypes","resultSize","queryString"],"sources":["dss.ts"],"sourcesContent":["/* eslint-disable no-underscore-dangle */\n/*!\n * Copyright (c) 2015-2022 Cisco Systems, Inc. See LICENSE file.\n */\nimport uuid from 'uuid';\nimport {WebexPlugin} from '@webex/webex-core';\nimport '@webex/internal-plugin-mercury';\nimport {range, isEqual, get} from 'lodash';\nimport type {\n  SearchOptions,\n  LookupDetailOptions,\n  LookupOptions,\n  LookupByEmailOptions,\n} from './types';\n\nimport {\n  DSS_REGISTERED,\n  DSS_UNREGISTERED,\n  DSS_LOOKUP_MERCURY_EVENT,\n  DSS_LOOKUP_RESULT,\n  DSS_SERVICE_NAME,\n  DSS_SEARCH_MERCURY_EVENT,\n  DSS_RESULT,\n} from './constants';\n\nconst DSS = WebexPlugin.extend({\n  namespace: 'DSS',\n\n  /**\n   * registered value indicating events registration is successful\n   * @instance\n   * @type {Boolean}\n   * @memberof DSS\n   */\n  registered: false,\n\n  /**\n   * Explicitly sets up the DSS plugin by connecting to mercury, and listening for DSS events.\n   * @returns {Promise}\n   * @public\n   * @memberof DSS\n   */\n  register() {\n    if (!this.webex.canAuthorize) {\n      this.logger.error('DSS->register#ERROR, Unable to register, SDK cannot authorize');\n\n      return Promise.reject(new Error('SDK cannot authorize'));\n    }\n\n    if (this.registered) {\n      this.logger.info('dss->register#INFO, DSS plugin already registered');\n\n      return Promise.resolve();\n    }\n\n    return this.webex.internal.mercury\n      .connect()\n      .then(() => {\n        this.listenForEvents();\n        this.trigger(DSS_REGISTERED);\n        this.registered = true;\n      })\n      .catch((error) => {\n        this.logger.error(`DSS->register#ERROR, Unable to register, ${error.message}`);\n\n        return Promise.reject(error);\n      });\n  },\n\n  /**\n   * Explicitly tears down the DSS plugin by disconnecting from mercury, and stops listening to DSS events\n   * @returns {Promise}\n   * @public\n   * @memberof DSS\n   */\n  unregister() {\n    if (!this.registered) {\n      this.logger.info('DSS->unregister#INFO, DSS plugin already unregistered');\n\n      return Promise.resolve();\n    }\n\n    this.stopListeningForEvents();\n\n    return this.webex.internal.mercury.disconnect().then(() => {\n      this.trigger(DSS_UNREGISTERED);\n      this.registered = false;\n    });\n  },\n\n  /**\n   * registers for DSS events through mercury\n   * @returns {undefined}\n   * @private\n   */\n  listenForEvents() {\n    this.webex.internal.mercury.on(DSS_LOOKUP_MERCURY_EVENT, (envelope) => {\n      this._handleEvent(envelope.data);\n    });\n    this.webex.internal.mercury.on(DSS_SEARCH_MERCURY_EVENT, (envelope) => {\n      this._handleEvent(envelope.data);\n    });\n  },\n\n  /**\n   * unregisteres all the DSS events from mercury\n   * @returns {undefined}\n   * @private\n   */\n  stopListeningForEvents() {\n    this.webex.internal.mercury.off(DSS_LOOKUP_MERCURY_EVENT);\n    this.webex.internal.mercury.off(DSS_SEARCH_MERCURY_EVENT);\n  },\n\n  /**\n   * @param {UUID} requestId the id of the request\n   * @returns {string}\n   */\n  _getResultEventName(requestId) {\n    return `${DSS_RESULT}${requestId}`;\n  },\n\n  /**\n   * @param {Object} data the event data\n   * @returns {undefined}\n   */\n  _handleEvent(data) {\n    this.trigger(this._getResultEventName(data.requestId), data);\n    this.trigger(DSS_LOOKUP_RESULT, data);\n  },\n\n  /**\n   * Makes the request to the directory service\n   * @param {Object} options\n   * @param {string} options.resource the URL to query\n   * @param {string} options.params additional params for the body of the request\n   * @param {string} options.dataPath to path to get the data in the result object\n   * @returns {Promise} Resolves with an array of entities found\n   */\n  _request(options) {\n    const {resource, params, dataPath} = options;\n\n    const requestId = uuid.v4();\n    const eventName = this._getResultEventName(requestId);\n    const result = {};\n    let expectedSeqNums;\n\n    return new Promise((resolve) => {\n      this.listenTo(this, eventName, (data) => {\n        const resultData = get(data, dataPath);\n\n        result[data.sequence] = resultData;\n\n        if (data.finished) {\n          expectedSeqNums = range(data.sequence + 1).map(String);\n        }\n\n        const done = isEqual(expectedSeqNums, Object.keys(result));\n\n        if (done) {\n          const resultArray = [];\n          expectedSeqNums.forEach((index) => {\n            const seqResult = result[index];\n            if (seqResult) {\n              resultArray.push(...seqResult);\n            }\n          });\n\n          resolve(resultArray);\n          this.stopListening(this, eventName);\n        }\n      });\n      this.webex.request({\n        service: DSS_SERVICE_NAME,\n        resource,\n        method: 'POST',\n        contentType: 'application/json',\n        body: {requestId, ...params},\n      });\n    });\n  },\n\n  /**\n   * Retrieves detailed information about an entity\n   * @param {Object} options\n   * @param {UUID} options.id the id of the entity to lookup\n   * @returns {Promise} Resolves with an array of entities found\n   */\n  lookupDetail(options: LookupDetailOptions) {\n    const {id} = options;\n\n    return this._request({\n      dataPath: 'lookupResult.entities',\n      resource: `/lookup/orgid/${this.webex.internal.device.orgId}/identity/${id}/detail`,\n    });\n  },\n\n  /**\n   * Retrieves basic information about a list entities within an organization\n   * @param {Object} options\n   * @param {UUID} options.ids the id of the entity to lookup\n   * @param {UUID} options.entityProviderType the provider to query (optional)\n   * @returns {Promise} Resolves with an array of entities found\n   */\n  lookup(options: LookupOptions) {\n    const {ids, entityProviderType} = options;\n\n    const resource = entityProviderType\n      ? `/lookup/orgid/${this.webex.internal.device.orgId}/entityprovidertype/${entityProviderType}`\n      : `/lookup/orgid/${this.webex.internal.device.orgId}/identities`;\n\n    return this._request({\n      dataPath: 'lookupResult.entities',\n      resource,\n      params: {\n        lookupValues: ids,\n      },\n    });\n  },\n\n  /**\n   * Retrieves basic information about a list entities within an organization\n   * @param {Object} options\n   * @param {UUID} options.emails the emails of the entities to lookup\n   * @returns {Promise} Resolves with an array of entities found\n   */\n  lookupByEmail(options: LookupByEmailOptions) {\n    const {emails} = options;\n\n    return this._request({\n      dataPath: 'lookupResult.entities',\n      resource: `/lookup/orgid/${this.webex.internal.device.orgId}/emails`,\n      params: {\n        lookupValues: emails,\n      },\n    });\n  },\n\n  /**\n   * Search for information about entities\n   * @param {Object} options\n   * @param {SearchType[]} options.requestedTypes an array of search types from: PERSON, CALLING_SERVICE, EXTERNAL_CALLING, ROOM, ROBOT\n   * @param {string[]} options.queryString A query string that will be transformed into a Directory search filter query. It is used to search the following fields: username, givenName, familyName, displayName and email\n   * @param {number} options.resultSize The maximum number of results returned from each provider\n   * @returns {Promise} Resolves with an array of entities found\n   */\n  search(options: SearchOptions) {\n    const {requestedTypes, resultSize, queryString} = options;\n\n    return this._request({\n      dataPath: 'directoryEntities',\n      resource: `/search/orgid/${this.webex.internal.device.orgId}/entities`,\n      params: {\n        queryString,\n        resultSize,\n        requestedTypes,\n      },\n    });\n  },\n});\n\nexport default DSS;\n"],"mappings":"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"}
+{"version":3,"names":["DSS","WebexPlugin","extend","namespace","registered","initialize","args","prototype","batchers","register","webex","canAuthorize","logger","error","reject","Error","info","resolve","internal","mercury","connect","then","listenForEvents","trigger","DSS_REGISTERED","catch","message","unregister","stopListeningForEvents","disconnect","DSS_UNREGISTERED","on","DSS_LOOKUP_MERCURY_EVENT","envelope","_handleEvent","data","DSS_SEARCH_MERCURY_EVENT","off","_getResultEventName","requestId","DSS_RESULT","DSS_LOOKUP_RESULT","_request","options","resource","params","dataPath","foundPath","notFoundPath","timeout","config","requestTimeout","uuid","v4","eventName","result","expectedSeqNums","notFoundArray","timer","Timer","stopListening","DssTimeoutError","listenTo","reset","resultData","found","sequence","finished","map","String","done","cancel","resultArray","foundArray","forEach","index","seqResult","push","resolveValue","request","service","DSS_SERVICE_NAME","method","contentType","body","start","_batchedLookup","lookupValue","LOOKUP_DATA_PATH","entitiesFoundPath","LOOKUP_FOUND_PATH","entitiesNotFoundPath","LOOKUP_NOT_FOUND_PATH","requestKey","LOOKUP_REQUEST_KEY","DssBatcher","parent","lookupDetail","id","device","orgId","lookup","entityProviderType","shouldBatch","lookupByEmail","email","search","requestedTypes","resultSize","queryString","SEARCH_DATA_PATH","searchPlaces","isOnlySchedulableRooms"],"sources":["dss.ts"],"sourcesContent":["/* eslint-disable no-underscore-dangle */\n/*!\n * Copyright (c) 2015-2022 Cisco Systems, Inc. See LICENSE file.\n */\n/* eslint-disable no-underscore-dangle */\nimport uuid from 'uuid';\nimport {WebexPlugin} from '@webex/webex-core';\nimport '@webex/internal-plugin-mercury';\nimport {range, isEqual, get} from 'lodash';\n\nimport {Timer} from '@webex/common-timers';\nimport type {\n  SearchOptions,\n  LookupDetailOptions,\n  LookupOptions,\n  LookupByEmailOptions,\n  SearchPlaceOptions,\n} from './types';\nimport {\n  DSS_REGISTERED,\n  DSS_UNREGISTERED,\n  DSS_LOOKUP_MERCURY_EVENT,\n  DSS_LOOKUP_RESULT,\n  DSS_SERVICE_NAME,\n  DSS_SEARCH_MERCURY_EVENT,\n  DSS_RESULT,\n  LOOKUP_DATA_PATH,\n  LOOKUP_FOUND_PATH,\n  LOOKUP_NOT_FOUND_PATH,\n  LOOKUP_REQUEST_KEY,\n  SEARCH_DATA_PATH,\n} from './constants';\nimport DssBatcher from './dss-batcher';\nimport {DssTimeoutError} from './dss-errors';\nimport {BatcherOptions, RequestOptions, RequestResult} from './types';\n\nconst DSS = WebexPlugin.extend({\n  namespace: 'DSS',\n\n  /**\n   * registered value indicating events registration is successful\n   * @instance\n   * @type {Boolean}\n   * @memberof DSS\n   */\n  registered: false,\n\n  /**\n   * Initializer\n   * @private\n   * @param {Object} attrs\n   * @param {Object} options\n   * @returns {undefined}\n   */\n  initialize(...args) {\n    Reflect.apply(WebexPlugin.prototype.initialize, this, args);\n    this.batchers = {};\n  },\n\n  /**\n   * Explicitly sets up the DSS plugin by connecting to mercury, and listening for DSS events.\n   * @returns {Promise}\n   * @public\n   * @memberof DSS\n   */\n  register() {\n    if (!this.webex.canAuthorize) {\n      this.logger.error('DSS->register#ERROR, Unable to register, SDK cannot authorize');\n\n      return Promise.reject(new Error('SDK cannot authorize'));\n    }\n\n    if (this.registered) {\n      this.logger.info('dss->register#INFO, DSS plugin already registered');\n\n      return Promise.resolve();\n    }\n\n    return this.webex.internal.mercury\n      .connect()\n      .then(() => {\n        this.listenForEvents();\n        this.trigger(DSS_REGISTERED);\n        this.registered = true;\n      })\n      .catch((error) => {\n        this.logger.error(`DSS->register#ERROR, Unable to register, ${error.message}`);\n\n        return Promise.reject(error);\n      });\n  },\n\n  /**\n   * Explicitly tears down the DSS plugin by disconnecting from mercury, and stops listening to DSS events\n   * @returns {Promise}\n   * @public\n   * @memberof DSS\n   */\n  unregister() {\n    if (!this.registered) {\n      this.logger.info('DSS->unregister#INFO, DSS plugin already unregistered');\n\n      return Promise.resolve();\n    }\n\n    this.stopListeningForEvents();\n\n    return this.webex.internal.mercury.disconnect().then(() => {\n      this.trigger(DSS_UNREGISTERED);\n      this.registered = false;\n    });\n  },\n\n  /**\n   * registers for DSS events through mercury\n   * @returns {undefined}\n   * @private\n   */\n  listenForEvents() {\n    this.webex.internal.mercury.on(DSS_LOOKUP_MERCURY_EVENT, (envelope) => {\n      this._handleEvent(envelope.data);\n    });\n    this.webex.internal.mercury.on(DSS_SEARCH_MERCURY_EVENT, (envelope) => {\n      this._handleEvent(envelope.data);\n    });\n  },\n\n  /**\n   * unregisteres all the DSS events from mercury\n   * @returns {undefined}\n   * @private\n   */\n  stopListeningForEvents() {\n    this.webex.internal.mercury.off(DSS_LOOKUP_MERCURY_EVENT);\n    this.webex.internal.mercury.off(DSS_SEARCH_MERCURY_EVENT);\n  },\n\n  /**\n   * constructs the event name based on request id\n   * @param {UUID} requestId the id of the request\n   * @returns {string}\n   */\n  _getResultEventName(requestId) {\n    return `${DSS_RESULT}${requestId}`;\n  },\n\n  /**\n   * Takes incoming data and triggers correct events\n   * @param {Object} data the event data\n   * @returns {undefined}\n   */\n  _handleEvent(data) {\n    this.trigger(this._getResultEventName(data.requestId), data);\n    this.trigger(DSS_LOOKUP_RESULT, data);\n  },\n\n  /**\n   * Makes the request to the directory service\n   * @param {Object} options\n   * @param {string} options.resource the URL to query\n   * @param {Mixed} options.params additional params for the body of the request\n   * @param {string} options.dataPath the path to get the data in the result object\n   * @param {string} [options.foundPath] the path to get the lookups of the found data\n   * @param {string} [options.notFoundPath] the path to get the lookups of the not found data\n   * @returns {Promise<Object>} result Resolves with an object\n   * @returns {Array} result.resultArray an array of entities found\n   * @returns {Array} result.foundArray an array of the lookups of the found entities (if foundPath provided)\n   * @returns {Array} result.notFoundArray an array of the lookups of the not found entities (if notFoundPath provided)\n   * @throws {DssTimeoutError} when server does not respond in the specified timeframe\n   */\n  _request(options: RequestOptions): Promise<RequestResult> {\n    const {resource, params, dataPath, foundPath, notFoundPath} = options;\n\n    const timeout = this.config.requestTimeout;\n    const requestId = uuid.v4();\n    const eventName = this._getResultEventName(requestId);\n    const result = {};\n    let expectedSeqNums: string[];\n    let notFoundArray: unknown[];\n\n    return new Promise((resolve, reject) => {\n      const timer = new Timer(() => {\n        this.stopListening(this, eventName);\n        reject(new DssTimeoutError({requestId, timeout, resource, params}));\n      }, timeout);\n\n      this.listenTo(this, eventName, (data) => {\n        timer.reset();\n        const resultData = get(data, dataPath, []);\n        let found;\n\n        if (foundPath) {\n          found = get(data, foundPath, []);\n        }\n        result[data.sequence] = foundPath ? {resultData, found} : {resultData};\n\n        if (data.finished) {\n          expectedSeqNums = range(data.sequence + 1).map(String);\n          if (notFoundPath) {\n            notFoundArray = get(data, notFoundPath, []);\n          }\n        }\n\n        const done = isEqual(expectedSeqNums, Object.keys(result));\n\n        if (done) {\n          timer.cancel();\n\n          const resultArray: any[] = [];\n          const foundArray: any[] = [];\n\n          expectedSeqNums.forEach((index) => {\n            const seqResult = result[index];\n\n            if (seqResult) {\n              resultArray.push(...seqResult.resultData);\n              if (foundPath) {\n                foundArray.push(...seqResult.found);\n              }\n            }\n          });\n          const resolveValue: RequestResult = {\n            resultArray,\n          };\n\n          if (foundPath) {\n            resolveValue.foundArray = foundArray;\n          }\n          if (notFoundPath) {\n            resolveValue.notFoundArray = notFoundArray;\n          }\n          resolve(resolveValue);\n          this.stopListening(this, eventName);\n        }\n      });\n      this.webex.request({\n        service: DSS_SERVICE_NAME,\n        resource,\n        method: 'POST',\n        contentType: 'application/json',\n        body: {requestId, ...params},\n      });\n      timer.start();\n    });\n  },\n\n  /**\n   * Uses a batcher to make the request to the directory service\n   * @param {Object} options\n   * @param {string} options.resource the URL to query\n   * @param {string} options.value the id or email to lookup\n   * @returns {Promise} Resolves with an array of entities found\n   * @throws {DssTimeoutError} when server does not respond in the specified timeframe\n   */\n  _batchedLookup(options: BatcherOptions) {\n    const {resource, lookupValue} = options;\n    const dataPath = LOOKUP_DATA_PATH;\n    const entitiesFoundPath = LOOKUP_FOUND_PATH;\n    const entitiesNotFoundPath = LOOKUP_NOT_FOUND_PATH;\n    const requestKey = LOOKUP_REQUEST_KEY;\n\n    this.batchers[resource] =\n      this.batchers[resource] ||\n      new DssBatcher({\n        resource,\n        dataPath,\n        entitiesFoundPath,\n        entitiesNotFoundPath,\n        requestKey,\n        parent: this,\n      });\n\n    return this.batchers[resource].request(lookupValue);\n  },\n\n  /**\n   * Retrieves detailed information about an entity\n   * @param {Object} options\n   * @param {UUID} options.id the id of the entity to lookup\n   * @returns {Promise} Resolves with the entity found or null if not found\n   * @throws {DssTimeoutError} when server does not respond in the specified timeframe\n   */\n  lookupDetail(options: LookupDetailOptions) {\n    const {id} = options;\n\n    const resource = `/lookup/orgid/${this.webex.internal.device.orgId}/identity/${id}/detail`;\n\n    return this._request({\n      dataPath: LOOKUP_DATA_PATH,\n      foundPath: LOOKUP_FOUND_PATH,\n      resource,\n    }).then(({resultArray, foundArray}) => {\n      // TODO: find out what is actually returned!\n      if (foundArray[0] === id) {\n        return resultArray[0];\n      }\n\n      return null;\n    });\n  },\n\n  /**\n   * Retrieves basic information about an entity within an organization\n   * @param {Object} options\n   * @param {UUID} options.id the id of the entity to lookup\n   * @param {UUID} [options.entityProviderType] the provider to query\n   * @param {Boolean} options.shouldBatch whether to batch the query, set to false for single immediate result (defaults to true)\n   * @returns {Promise} Resolves with the entity found or null if not found\n   * @throws {DssTimeoutError} when server does not respond in the specified timeframe\n   */\n  lookup(options: LookupOptions) {\n    const {id, entityProviderType, shouldBatch = true} = options;\n\n    const resource = entityProviderType\n      ? `/lookup/orgid/${this.webex.internal.device.orgId}/entityprovidertype/${entityProviderType}`\n      : `/lookup/orgid/${this.webex.internal.device.orgId}/identities`;\n\n    if (shouldBatch) {\n      return this._batchedLookup({\n        resource,\n        lookupValue: id,\n      });\n    }\n\n    return this._request({\n      dataPath: LOOKUP_DATA_PATH,\n      foundPath: LOOKUP_FOUND_PATH,\n      resource,\n      params: {\n        [LOOKUP_REQUEST_KEY]: [id],\n      },\n    }).then(({resultArray, foundArray}) => {\n      if (foundArray[0] === id) {\n        return resultArray[0];\n      }\n\n      return null;\n    });\n  },\n\n  /**\n   * Retrieves basic information about an enitity within an organization\n   * @param {Object} options\n   * @param {UUID} options.email the email of the entity to lookup\n   * @returns {Promise} Resolves with the entity found or rejects if not found\n   * @throws {DssTimeoutError} when server does not respond in the specified timeframe\n   */\n  lookupByEmail(options: LookupByEmailOptions) {\n    const {email} = options;\n    const resource = `/lookup/orgid/${this.webex.internal.device.orgId}/emails`;\n\n    return this._request({\n      dataPath: LOOKUP_DATA_PATH,\n      foundPath: LOOKUP_FOUND_PATH,\n      resource,\n      params: {\n        [LOOKUP_REQUEST_KEY]: [email],\n      },\n    }).then(({resultArray, foundArray}) => {\n      if (foundArray[0] === email) {\n        return resultArray[0];\n      }\n\n      return null;\n    });\n  },\n\n  /**\n   * Search for information about entities\n   * @param {Object} options\n   * @param {SearchType[]} options.requestedTypes an array of search types from: PERSON, CALLING_SERVICE, EXTERNAL_CALLING, ROOM, ROBOT\n   * @param {string[]} options.queryString A query string that will be transformed into a Directory search filter query. It is used to search the following fields: username, givenName, familyName, displayName and email\n   * @param {number} options.resultSize The maximum number of results returned from each provider\n   * @returns {Promise} Resolves with an array of entities found\n   * @throws {DssTimeoutError} when server does not respond in the specified timeframe\n   */\n  search(options: SearchOptions) {\n    const {requestedTypes, resultSize, queryString} = options;\n\n    return this._request({\n      dataPath: SEARCH_DATA_PATH,\n      resource: `/search/orgid/${this.webex.internal.device.orgId}/entities`,\n      params: {\n        queryString,\n        resultSize,\n        requestedTypes,\n      },\n    }).then(({resultArray}) => resultArray);\n  },\n\n  /**\n   * Search for information about places\n   * @param {Object} options\n   * @param {string} options.queryString A query string that will be transformed into a Directory search filter query. It is used to search the following fields: placeName, displayName.\n   * @param {number} options.resultSize The maximum number of results returned from each provider\n   * @returns {Promise} Resolves with an array of entities found\n   */\n  searchPlaces(options: SearchPlaceOptions) {\n    const {resultSize, queryString, isOnlySchedulableRooms} = options;\n\n    return this._request({\n      dataPath: 'directoryEntities',\n      resource: `/search/orgid/${this.webex.internal.device.orgId}/places`,\n      params: {\n        queryString,\n        resultSize,\n        isOnlySchedulableRooms,\n      },\n    }).catch((error) => {\n      this.logger.error(`DSS->search place#ERROR, search place failure, ${error.message}`);\n\n      return Promise.reject(error);\n    });\n  },\n});\n\nexport default DSS;\n"],"mappings":"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"}

package/dist/index.js

@@ -13,5 +13,8 @@ _Object$defineProperty(exports, "default", {
 });
 var _webexCore = require("@webex/webex-core");
 var _dss = _interopRequireDefault(require("./dss"));
-(0, _webexCore.registerInternalPlugin)('dss', _dss.default);
+var _config = _interopRequireDefault(require("./config"));
+(0, _webexCore.registerInternalPlugin)('dss', _dss.default, {
+  config: _config.default
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["registerInternalPlugin","DSS"],"sources":["index.ts"],"sourcesContent":["import {registerInternalPlugin} from '@webex/webex-core';\n\nimport DSS from './dss';\n\nregisterInternalPlugin('dss', DSS);\n\nexport {default} from './dss';\n"],"mappings":";;;;;;;;;;;;;AAAA;AAEA;AAEA,IAAAA,iCAAsB,EAAC,KAAK,EAAEC,YAAG,CAAC"}
+{"version":3,"names":["registerInternalPlugin","DSS","config"],"sources":["index.ts"],"sourcesContent":["import {registerInternalPlugin} from '@webex/webex-core';\n\nimport DSS from './dss';\nimport config from './config';\n\nregisterInternalPlugin('dss', DSS, {config});\n\nexport {default} from './dss';\n"],"mappings":";;;;;;;;;;;;;AAAA;AAEA;AACA;AAEA,IAAAA,iCAAsB,EAAC,KAAK,EAAEC,YAAG,EAAE;EAACC,MAAM,EAANA;AAAM,CAAC,CAAC"}

package/dist/types.js

@@ -5,7 +5,6 @@ _Object$defineProperty(exports, "__esModule", {
   value: true
 });
 exports.SearchType = exports.EntityProviderType = void 0;
-// eslint-disable-next-line no-shadow
 var EntityProviderType;
 exports.EntityProviderType = EntityProviderType;
 (function (EntityProviderType) {

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["EntityProviderType","SearchType"],"sources":["types.ts"],"sourcesContent":["export interface LookupDetailOptions {\n  id: string;\n}\n\n// eslint-disable-next-line no-shadow\nexport enum EntityProviderType {\n  CI_USER = 'CI_USER',\n  CI_MACHINE = 'CI_MACHINE',\n  CONTACTS = 'CONTACTS',\n  CSDM = 'CSDM',\n}\n\nexport interface LookupOptions {\n  ids: string[];\n  entityProviderType?: EntityProviderType;\n}\n\nexport interface LookupByEmailOptions {\n  emails: string[];\n}\n\n// eslint-disable-next-line no-shadow\nexport enum SearchType {\n  PERSON = 'PERSON',\n  CALLING_SERVICE = 'CALLING_SERVICE',\n  EXTERNAL_CALLING = 'EXTERNAL_CALLING',\n  ROOM = 'ROOM',\n  ROBOT = 'ROBOT',\n}\n\nexport interface SearchOptions {\n  requestedTypes: SearchType[];\n  resultSize: number;\n  queryString: string;\n}\n"],"mappings":";;;;;;;AAIA;AAAA,IACYA,kBAAkB;AAAA;AAAA,WAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;AAAA,GAAlBA,kBAAkB,kCAAlBA,kBAAkB;AAgB9B;AAAA,IACYC,UAAU;AAAA;AAAA,WAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;AAAA,GAAVA,UAAU,0BAAVA,UAAU"}
+{"version":3,"names":["EntityProviderType","SearchType"],"sources":["types.ts"],"sourcesContent":["export interface RequestOptions {\n  resource: string;\n  dataPath: string;\n  foundPath?: string;\n  notFoundPath?: string;\n  params?: Record<string, unknown>;\n}\n\nexport interface RequestResult {\n  foundArray?: any[];\n  notFoundArray?: any[];\n  resultArray: any[];\n}\n\nexport interface LookupDetailOptions {\n  id: string;\n}\n\nexport enum EntityProviderType {\n  CI_USER = 'CI_USER',\n  CI_MACHINE = 'CI_MACHINE',\n  CONTACTS = 'CONTACTS',\n  CSDM = 'CSDM',\n}\n\nexport interface LookupOptions {\n  id: string;\n  entityProviderType?: EntityProviderType;\n  shouldBatch?: boolean;\n}\n\nexport interface LookupByEmailOptions {\n  email: string;\n}\n\n// eslint-disable-next-line no-shadow\nexport enum SearchType {\n  PERSON = 'PERSON',\n  CALLING_SERVICE = 'CALLING_SERVICE',\n  EXTERNAL_CALLING = 'EXTERNAL_CALLING',\n  ROOM = 'ROOM',\n  ROBOT = 'ROBOT',\n}\n\nexport interface SearchOptions {\n  requestedTypes: SearchType[];\n  resultSize: number;\n  queryString: string;\n}\n\nexport interface BatcherOptions {\n  resource: string;\n  lookupValue: string;\n}\n\nexport interface SearchPlaceOptions {\n  resultSize: number;\n  queryString: string;\n  isOnlySchedulableRooms: boolean;\n}\n"],"mappings":";;;;;;;IAkBYA,kBAAkB;AAAA;AAAA,WAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;EAAlBA,kBAAkB;AAAA,GAAlBA,kBAAkB,kCAAlBA,kBAAkB;AAiB9B;AAAA,IACYC,UAAU;AAAA;AAAA,WAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;EAAVA,UAAU;AAAA,GAAVA,UAAU,0BAAVA,UAAU"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webex/internal-plugin-dss",
-  "version": "3.0.0-beta.42",
+  "version": "3.0.0-beta.420",
   "description": "",
   "license": "MIT",
   "author": "Colin Read <coread@cisco.com>",
@@ -21,14 +21,17 @@
     ]
   },
   "dependencies": {
-    "@webex/internal-plugin-mercury": "3.0.0-beta.42",
-    "@webex/webex-core": "3.0.0-beta.42",
+    "@webex/common": "3.0.0-beta.420",
+    "@webex/common-timers": "3.0.0-beta.420",
+    "@webex/internal-plugin-mercury": "3.0.0-beta.420",
+    "@webex/webex-core": "3.0.0-beta.420",
     "lodash": "^4.17.21",
     "uuid": "^3.3.2"
   },
   "devDependencies": {
-    "@webex/internal-plugin-dss": "3.0.0-beta.42",
-    "@webex/test-helper-chai": "3.0.0-beta.42",
-    "@webex/test-helper-mock-webex": "3.0.0-beta.42"
+    "@webex/internal-plugin-dss": "3.0.0-beta.420",
+    "@webex/test-helper-chai": "3.0.0-beta.420",
+    "@webex/test-helper-mock-webex": "3.0.0-beta.420",
+    "sinon": "^9.2.4"
   }
 }

package/src/config.ts

@@ -0,0 +1,31 @@
+/*!
+ * Copyright (c) 2015-2022 Cisco Systems, Inc. See LICENSE file.
+ */
+
+export default {
+  dss: {
+    /**
+     * Timeout before DSS request fails, in milliseconds.
+     * @type {Number}
+     */
+    requestTimeout: 6000,
+
+    /**
+     * Debounce wait (ms) before sending a dss request (gap between lookups that will trigger a request)
+     * @type {Number}
+     */
+    batcherWait: 50,
+
+    /**
+     * Maximum queue size before sending a dss request
+     * @type {Number}
+     */
+    batcherMaxCalls: 50,
+
+    /**
+     * Debounce max wait (ms) before sending a dss request (time from first lookup that will trigger a request)
+     * @type {Number}
+     */
+    batcherMaxWait: 150,
+  },
+};

package/src/constants.ts

@@ -12,3 +12,8 @@ export const SEARCH_TYPES = {
   ROOM: 'ROOM',
   ROBOT: 'ROBOT',
 };
+export const LOOKUP_DATA_PATH = 'lookupResult.entities';
+export const LOOKUP_FOUND_PATH = 'lookupResult.entitiesFound';
+export const LOOKUP_NOT_FOUND_PATH = 'lookupResult.entitiesNotFound';
+export const LOOKUP_REQUEST_KEY = 'lookupValues';
+export const SEARCH_DATA_PATH = 'directoryEntities';

package/src/dss-batcher.ts

@@ -0,0 +1,129 @@
+/*!
+ * Copyright (c) 2015-2022 Cisco Systems, Inc. See LICENSE file.
+ */
+/* eslint-disable no-underscore-dangle */
+
+import {Batcher} from '@webex/webex-core';
+
+/**
+ * @class
+ */
+const DssBatcher = Batcher.extend({
+  namespace: 'DSS',
+
+  props: {
+    resource: {
+      type: 'string',
+      required: true,
+      setOnce: true,
+      allowNull: false,
+    },
+    dataPath: {
+      type: 'string',
+      required: true,
+      setOnce: true,
+      allowNull: false,
+    },
+    entitiesFoundPath: {
+      type: 'string',
+      required: true,
+      setOnce: true,
+      allowNull: false,
+    },
+    entitiesNotFoundPath: {
+      type: 'string',
+      required: true,
+      setOnce: true,
+      allowNull: false,
+    },
+    requestKey: {
+      type: 'string',
+      required: true,
+      setOnce: true,
+      allowNull: false,
+    },
+  },
+
+  /**
+   * Submits the DSS request
+   * @param {Object} payload
+   * @returns {Promise<Array>}
+   */
+  submitHttpRequest(payload: unknown) {
+    return this.parent._request({
+      dataPath: this.dataPath,
+      foundPath: this.entitiesFoundPath,
+      notFoundPath: this.entitiesNotFoundPath,
+      resource: this.resource,
+      params: {
+        lookupValues: payload,
+      },
+    });
+  },
+
+  /**
+   * Actions taken when the http request returns a success
+   * @param {Promise<Array>} res
+   * @returns {Promise<undefined>}
+   */
+  handleHttpSuccess(res) {
+    const successItems = res.foundArray.map((requestValue, index) => ({
+      requestValue,
+      entity: res.resultArray[index],
+    }));
+    const failureItems = res.notFoundArray.map((requestValue) => ({requestValue, entity: null}));
+
+    return Promise.all(successItems.concat(failureItems).map((item) => this.acceptItem(item)));
+  },
+
+  /**
+   * Checks if the item was found
+   * @param {Object} item
+   * @returns {Promise<Boolean>}
+   */
+  didItemFail(item) {
+    return Promise.resolve(item.entity === null);
+  },
+
+  /**
+   * Finds the Defer for the specified item and resolves its promise with null
+   * @param {Object} item
+   * @returns {Promise<undefined>}
+   */
+  handleItemFailure(item) {
+    return this.getDeferredForResponse(item).then((defer) => {
+      defer.resolve(null);
+    });
+  },
+
+  /**
+   * Finds the Defer for the specified item and resolves its promise
+   * @param {Object} item
+   * @returns {Promise<undefined>}
+   */
+  handleItemSuccess(item) {
+    return this.getDeferredForResponse(item).then((defer) => {
+      defer.resolve(item.entity);
+    });
+  },
+
+  /**
+   * Returns a promise with the unique key for the item
+   * @param {Object} item
+   * @returns {Promise}
+   */
+  fingerprintRequest(item) {
+    return Promise.resolve(item);
+  },
+
+  /**
+   * Returns a promise with the unique key for the item
+   * @param {Object} item
+   * @returns {Promise}
+   */
+  fingerprintResponse(item) {
+    return Promise.resolve(item.requestValue);
+  },
+});
+
+export default DssBatcher;

package/src/dss-errors.ts

@@ -0,0 +1,36 @@
+import {Exception} from '@webex/common';
+import {RequestOptions} from './types';
+
+interface DssTimeoutErrorParams extends Required<Pick<RequestOptions, 'resource' | 'params'>> {
+  requestId: string;
+  timeout: number;
+}
+
+/**
+ * Thrown when an expected DSS respond is not received in a timely manner.
+ */
+export class DssTimeoutError extends Exception {
+  /**
+   * Construct DssTimeoutError
+   * @param {DssTimeoutErrorParams} details
+   */
+  // eslint-disable-next-line no-useless-constructor
+  constructor(details: DssTimeoutErrorParams) {
+    super(details);
+  }
+
+  /**
+   * Parse Error details
+   *
+   * @param {DssTimeoutErrorParams} details
+   * @returns {string}
+   */
+  parse(details: DssTimeoutErrorParams) {
+    return (
+      `The DSS did not respond within ${details.timeout} ms.` +
+      `\n Request Id: ${details.requestId}` +
+      `\n Resource: ${details.resource}` +
+      `\n Params: ${JSON.stringify(details.params)}`
+    );
+  }
+}