@webex/common
Version:
Common utilities for Cisco Webex
190 lines (176 loc) • 6.15 kB
JavaScript
;
var _Object$defineProperty = require("@babel/runtime-corejs2/core-js/object/define-property");
_Object$defineProperty(exports, "__esModule", {
value: true
});
exports.buildHydraMembershipId = buildHydraMembershipId;
exports.buildHydraMessageId = buildHydraMessageId;
exports.buildHydraOrgId = buildHydraOrgId;
exports.buildHydraPersonId = buildHydraPersonId;
exports.buildHydraRoomId = buildHydraRoomId;
exports.constructHydraId = constructHydraId;
exports.deconstructHydraId = deconstructHydraId;
exports.getHydraClusterString = getHydraClusterString;
exports.getHydraFiles = getHydraFiles;
exports.getHydraRoomType = getHydraRoomType;
var _base = require("./base64");
var _constants = require("./constants");
var hydraBaseUrl = 'https://api.ciscospark.com/v1';
var isRequired = function isRequired() {
throw Error('parameter is required');
};
/**
* Constructs a Hydra ID for a given UUID and type.
*
* @export
* @param {string} type one of PEOPLE, TEAM, ROOM
* @param {any} id identifying the "TYPE" object
* @param {string} cluster containing the "TYPE" object
* @returns {string}
*/
function constructHydraId() {
var type = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : isRequired();
var id = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : isRequired();
var cluster = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'us';
if (!type.toUpperCase) {
throw Error('"type" must be a string');
}
if (type === _constants.hydraTypes.PEOPLE || type === _constants.hydraTypes.ORGANIZATION) {
// Cluster is always "us" for people and orgs
return (0, _base.encode)("ciscospark://us/".concat(type.toUpperCase(), "/").concat(id));
}
return (0, _base.encode)("ciscospark://".concat(cluster, "/").concat(type.toUpperCase(), "/").concat(id));
}
/**
* @typedef {Object} DeconstructedHydraId
* @property {UUID} id identifying the object
* @property {String} type of the object
* @property {String} cluster containing the object
*/
/**
* Deconstructs a Hydra ID.
*
* @export
* @param {String} id Hydra style id
* @returns {DeconstructedHydraId} deconstructed id
*/
function deconstructHydraId(id) {
var payload = (0, _base.decode)(id).split('/');
return {
id: payload.pop(),
type: payload.pop(),
cluster: payload.pop()
};
}
/**
* Constructs a Hydra ID for a message based on internal UUID
*
* @export
* @param {any} uuid
* @param {string} cluster containing the message
* @returns {string}
*/
function buildHydraMessageId(uuid, cluster) {
return constructHydraId(_constants.hydraTypes.MESSAGE, uuid, cluster);
}
/**
* Constructs a Hydra ID for a person based on internal UUID
*
* @export
* @param {any} uuid
* @param {string} cluster containing the person
* @returns {string}
*/
function buildHydraPersonId(uuid, cluster) {
return constructHydraId(_constants.hydraTypes.PEOPLE, uuid, cluster);
}
/**
* Constructs a Hydra ID for a room based on internal UUID
*
* @export
* @param {any} uuid
* @param {string} cluster containing the room
* @returns {string}
*/
function buildHydraRoomId(uuid, cluster) {
return constructHydraId(_constants.hydraTypes.ROOM, uuid, cluster);
}
/**
* Constructs a Hydra ID for an organization based on internal UUID
*
* @export
* @param {any} uuid
* @param {string} cluster containing the organization
* @returns {string}
*/
function buildHydraOrgId(uuid, cluster) {
return constructHydraId(_constants.hydraTypes.ORGANIZATION, uuid, cluster);
}
/**
* Constructs a Hydra ID for an membership based on an
* internal UUID for the person, and the space
*
* @export
* @param {any} personUUID
* @param {any} spaceUUID
* @param {string} cluster containing the membership
* @returns {string}
*/
function buildHydraMembershipId(personUUID, spaceUUID, cluster) {
return constructHydraId(_constants.hydraTypes.MEMBERSHIP, "".concat(personUUID, ":").concat(spaceUUID), cluster);
}
/**
* Returns a hydra cluster string based on a conversation url
* @private
* @memberof Messages
* @param {Object} webex sdk instance
* @param {String} conversationUrl url of space where activity took place
* @returns {String} string suitable for UUID -> public ID encoding
*/
function getHydraClusterString(webex, conversationUrl) {
var internalClusterString = webex.internal.services.getClusterId(conversationUrl);
if (internalClusterString.startsWith(_constants.INTERNAL_US_CLUSTER_NAME) || internalClusterString.startsWith(_constants.INTERNAL_US_INTEGRATION_CLUSTER_NAME)) {
// Original US cluster is simply 'us' for backwards compatibility
return 'us';
}
var clusterParts = internalClusterString.split(':');
if (clusterParts.length < 3) {
throw Error("Unable to determine cluster for convo: ".concat(conversationUrl));
}
return "".concat(clusterParts[0], ":").concat(clusterParts[1], ":").concat(clusterParts[2]);
}
/**
* Returns a Hydra roomType based on conversation tags
*
* @export
* @param {arra} tags
* @returns {string}
*/
function getHydraRoomType(tags) {
if (tags.includes(_constants.SDK_EVENT.INTERNAL.ACTIVITY_TAG.ONE_ON_ONE)) {
return _constants.SDK_EVENT.EXTERNAL.SPACE_TYPE.DIRECT;
}
return _constants.SDK_EVENT.EXTERNAL.SPACE_TYPE.GROUP;
}
/**
* Returns file URLs for the activity, adhering to Hydra details,
* e.g., https://api.ciscospark.com/v1/contents/Y2lzY29zcGF...
* @see https://developer.webex.com/docs/api/v1/messages/get-message-details
* @param {Object} activity from mercury
* @param {string} cluster containing the files
* @returns {Array} file URLs
*/
function getHydraFiles(activity, cluster) {
var hydraFiles = [];
var files = activity.object.files;
if (files) {
var items = files.items;
// Note: Generated ID is dependent on file order.
for (var i = 0; i < items.length; i += 1) {
var contentId = constructHydraId(_constants.hydraTypes.CONTENT, "".concat(activity.id, "/").concat(i), cluster);
hydraFiles.push("".concat(hydraBaseUrl, "/contents/").concat(contentId));
}
}
return hydraFiles;
}
//# sourceMappingURL=uuid-utils.js.map