@atlaskit/teams-client 4.26.0 → 4.27.0

package/dist/es2019/common/utils/ufo/constants.js

@@ -1,6 +1,6 @@
 import { ExperiencePerformanceTypes, ExperienceTypes } from '@atlaskit/ufo';
 import { TeamsUFOExperience } from './index';
-const TeamsClientExperienceKeyList = ['getAllTeams', 'getTeamById', 'updateTeamById', 'querySettings', 'queryFeatureFlags', 'queryTeamMemberships', 'queryUser', 'inviteUsersToTeam', 'getMyTeamMembership', 'getTeamLinksByTeamId', 'createTeamLink', 'updateTeamLink', 'deleteTeamLink', 'reorderTeamLink', 'acceptTeamInvitation', 'declineTeamInvitation', 'selfJoinTeam', 'cancelJoinRequest', 'acceptJoinRequest', 'declineJoinRequest', 'deleteTeamMembership', 'revokeTeamInvite', 'deleteTeam', 'archiveTeam', 'unarchiveTeam', 'unlinkTeamFromGroup', 'isSingleFullMemberTeam', 'createTeam', 'createTeamContainers', 'createExternalTeam', 'getProfileWithMutability', 'getIsSiteAdmin', 'addUsersToTeam', 'removeTeamMemberships', 'getRecommendedProducts', 'joinOrRequestDefaultAccessToProductsBulk', 'getReadMediaToken', 'getWriteUserMediaToken', 'updateUserHeaderImage', 'getWriteTeamMediaToken', 'getSoftDeletedTeamById', 'restoreTeam', 'getUserInSiteUserBase', 'getLinkedTeamsBulk', 'getTeamProfileDetails', 'getUserContainers', 'getPermissions', 'getUserManageConfig', 'getMyAvatarUploadedStatus', 'deleteUserAvatar', 'getTeamLinkIcons', 'getTeamInSlack', 'getOrgScope', 'restoreTeamToSyncedGroup', 'getTeamAndGroupDiff', 'linkExistingTeamToGroup', 'fetchUserAvatarInfo', 'getOrgEligibilityForManagedTeams', 'updateUser', 'updateUserAvatar', 'disconnectTeamInSlack', 'updateTeamInSlack', 'getUserTenure', 'getAriFromUrl', 'getWebLinkTitle', 'addAgentToTeam', 'getTeamEnabledSites', 'assignTeamsToSites', 'removeAgentTeamAssociation', 'getAssignedTeams', 'setTeamSiteAssignmentPermission', 'getUnassignedTeams', 'getTeamSiteAssignmentOrgDetails', 'getTeamsToBeClonedToJsmSites', 'getReportingLines'];
+const TeamsClientExperienceKeyList = ['getAllTeams', 'getTeamById', 'updateTeamById', 'querySettings', 'queryFeatureFlags', 'queryTeamMemberships', 'queryUser', 'inviteUsersToTeam', 'getMyTeamMembership', 'getTeamLinksByTeamId', 'createTeamLink', 'updateTeamLink', 'deleteTeamLink', 'reorderTeamLink', 'acceptTeamInvitation', 'declineTeamInvitation', 'selfJoinTeam', 'cancelJoinRequest', 'acceptJoinRequest', 'declineJoinRequest', 'deleteTeamMembership', 'revokeTeamInvite', 'deleteTeam', 'archiveTeam', 'unarchiveTeam', 'unlinkTeamFromGroup', 'isSingleFullMemberTeam', 'createTeam', 'createTeamContainers', 'createExternalTeam', 'getProfileWithMutability', 'getIsSiteAdmin', 'addUsersToTeam', 'removeTeamMemberships', 'getRecommendedProducts', 'joinOrRequestDefaultAccessToProductsBulk', 'getReadMediaToken', 'getWriteUserMediaToken', 'updateUserHeaderImage', 'getWriteTeamMediaToken', 'getSoftDeletedTeamById', 'restoreTeam', 'getUserInSiteUserBase', 'getLinkedTeamsBulk', 'getTeamProfileDetails', 'getUserContainers', 'getRecommendedUsers', 'getPermissions', 'getUserManageConfig', 'getMyAvatarUploadedStatus', 'deleteUserAvatar', 'getTeamLinkIcons', 'getTeamInSlack', 'getOrgScope', 'restoreTeamToSyncedGroup', 'getTeamAndGroupDiff', 'linkExistingTeamToGroup', 'fetchUserAvatarInfo', 'getOrgEligibilityForManagedTeams', 'updateUser', 'updateUserAvatar', 'disconnectTeamInSlack', 'updateTeamInSlack', 'getUserTenure', 'getAriFromUrl', 'getWebLinkTitle', 'addAgentToTeam', 'getTeamEnabledSites', 'assignTeamsToSites', 'removeAgentTeamAssociation', 'getAssignedTeams', 'setTeamSiteAssignmentPermission', 'getUnassignedTeams', 'getTeamSiteAssignmentOrgDetails', 'getTeamsToBeClonedToJsmSites', 'getReportingLines'];
 export const TEAMS_CLIENT_EXPERIENCES = new Map([...TeamsClientExperienceKeyList.map(key => [key,
 // camelCase to kebab-case
 new TeamsUFOExperience(`teams-client-${key.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()}`, {

package/dist/es2019/services/agg-client/utils/query-context-headers.js

@@ -0,0 +1,14 @@
+import { fg } from '@atlaskit/platform-feature-flags';
+
+/**
+ * Creates headers object with X-Query-Context header if cloudId is provided and feature flag is enabled.
+ * Use this for AGG client makeGraphQLRequest calls.
+ */
+export function createQueryContextHeaders(cloudId) {
+  if (!cloudId || !fg('enable_x_query_context_header')) {
+    return undefined;
+  }
+  return {
+    'X-Query-Context': `ari:cloud:platform::site/${cloudId}`
+  };
+}

package/dist/es2019/services/collaborationgraph-client/index.js

@@ -31,6 +31,27 @@ export class CollaborationGraphClient extends RestClient {
       expanded: true
     });
   }
+  getRecommendedUsers({
+    accountId,
+    cloudId,
+    maxNumberOfResults = 12,
+    filter = 'account_status:"active" AND (NOT email_domain:"connect.atlassian.com") AND (NOT account_type:"app")'
+  }) {
+    return this.postResource('/v2/recommend/user', {
+      context: {
+        userId: accountId,
+        tenantId: cloudId
+      },
+      modelRequestParams: {
+        experience: 'CgUserNearbyUser',
+        caller: 'atlas'
+      },
+      requestingUserId: accountId,
+      expand: 'existing',
+      maxNumberOfResults,
+      filter
+    });
+  }
 }
 export default new CollaborationGraphClient({
   serviceUrl: DEFAULT_CONFIG.collaborationGraphUrl

package/dist/es2019/services/graphql-client/main.js

@@ -1,3 +1,4 @@
+import { fg } from '@atlaskit/platform-feature-flags';
 import { DefaultError, GraphQLError } from '../../common/utils/error';
 import { BaseClient } from '../base-client';
 import { handleGraphQLRequest } from './utils';
@@ -9,9 +10,33 @@ export class BaseGraphQlClient extends BaseClient {
   setServiceUrl(serviceUrl) {
     this.serviceUrl = serviceUrl;
   }
+
+  /**
+   * Creates query context headers if cloudId is available and feature flag is enabled.
+   */
+  createQueryContextHeaders(cloudId) {
+    if (!cloudId || !fg('enable_x_query_context_header')) {
+      return undefined;
+    }
+    return {
+      'X-Query-Context': `ari:cloud:platform::site/${cloudId}`
+    };
+  }
   async makeGraphQLRequest(body, options = {}) {
     try {
-      return handleGraphQLRequest(this.serviceUrl, body, options);
+      // Automatically add X-Query-Context header if cloudId is available in context
+      const cloudId = this.getCloudId();
+      const queryContextHeaders = this.createQueryContextHeaders(cloudId);
+
+      // Merge headers: query context headers first, then provided headers (provided headers take precedence)
+      const mergedOptions = {
+        ...options,
+        headers: {
+          ...queryContextHeaders,
+          ...options.headers
+        }
+      };
+      return handleGraphQLRequest(this.serviceUrl, body, mergedOptions);
     } catch (error) {
       if (error instanceof GraphQLError) {
         throw error;

package/dist/es2019/services/graphql-client/utils/index.js

@@ -8,7 +8,8 @@ export async function makeGraphQLRequestWithoutRetries(serviceUrl, body, options
   const request = fetch(url, {
     method: 'POST',
     headers: new Headers({
-      'Content-Type': 'application/json'
+      'Content-Type': 'application/json',
+      ...(options.headers || {})
     }),
     credentials: 'include',
     body: JSON.stringify(body)

package/dist/es2019/services/main.js

@@ -603,6 +603,13 @@ export class TeamsClient {
     return this.measurePerformance('getUserContainers', () => this._collaborationGraphClient.getUserContainers(...args));
   }
 
+  /**
+   * Fetch recommended users from collaboration graph
+   */
+  async getRecommendedUsers(...args) {
+    return this.measurePerformance('getRecommendedUsers', () => this._collaborationGraphClient.getRecommendedUsers(...args));
+  }
+
   /**
    * Fetch mutatability of external managed user fields
    */

package/dist/esm/common/utils/ufo/constants.js

@@ -1,7 +1,7 @@
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 import { ExperiencePerformanceTypes, ExperienceTypes } from '@atlaskit/ufo';
 import { TeamsUFOExperience } from './index';
-var TeamsClientExperienceKeyList = ['getAllTeams', 'getTeamById', 'updateTeamById', 'querySettings', 'queryFeatureFlags', 'queryTeamMemberships', 'queryUser', 'inviteUsersToTeam', 'getMyTeamMembership', 'getTeamLinksByTeamId', 'createTeamLink', 'updateTeamLink', 'deleteTeamLink', 'reorderTeamLink', 'acceptTeamInvitation', 'declineTeamInvitation', 'selfJoinTeam', 'cancelJoinRequest', 'acceptJoinRequest', 'declineJoinRequest', 'deleteTeamMembership', 'revokeTeamInvite', 'deleteTeam', 'archiveTeam', 'unarchiveTeam', 'unlinkTeamFromGroup', 'isSingleFullMemberTeam', 'createTeam', 'createTeamContainers', 'createExternalTeam', 'getProfileWithMutability', 'getIsSiteAdmin', 'addUsersToTeam', 'removeTeamMemberships', 'getRecommendedProducts', 'joinOrRequestDefaultAccessToProductsBulk', 'getReadMediaToken', 'getWriteUserMediaToken', 'updateUserHeaderImage', 'getWriteTeamMediaToken', 'getSoftDeletedTeamById', 'restoreTeam', 'getUserInSiteUserBase', 'getLinkedTeamsBulk', 'getTeamProfileDetails', 'getUserContainers', 'getPermissions', 'getUserManageConfig', 'getMyAvatarUploadedStatus', 'deleteUserAvatar', 'getTeamLinkIcons', 'getTeamInSlack', 'getOrgScope', 'restoreTeamToSyncedGroup', 'getTeamAndGroupDiff', 'linkExistingTeamToGroup', 'fetchUserAvatarInfo', 'getOrgEligibilityForManagedTeams', 'updateUser', 'updateUserAvatar', 'disconnectTeamInSlack', 'updateTeamInSlack', 'getUserTenure', 'getAriFromUrl', 'getWebLinkTitle', 'addAgentToTeam', 'getTeamEnabledSites', 'assignTeamsToSites', 'removeAgentTeamAssociation', 'getAssignedTeams', 'setTeamSiteAssignmentPermission', 'getUnassignedTeams', 'getTeamSiteAssignmentOrgDetails', 'getTeamsToBeClonedToJsmSites', 'getReportingLines'];
+var TeamsClientExperienceKeyList = ['getAllTeams', 'getTeamById', 'updateTeamById', 'querySettings', 'queryFeatureFlags', 'queryTeamMemberships', 'queryUser', 'inviteUsersToTeam', 'getMyTeamMembership', 'getTeamLinksByTeamId', 'createTeamLink', 'updateTeamLink', 'deleteTeamLink', 'reorderTeamLink', 'acceptTeamInvitation', 'declineTeamInvitation', 'selfJoinTeam', 'cancelJoinRequest', 'acceptJoinRequest', 'declineJoinRequest', 'deleteTeamMembership', 'revokeTeamInvite', 'deleteTeam', 'archiveTeam', 'unarchiveTeam', 'unlinkTeamFromGroup', 'isSingleFullMemberTeam', 'createTeam', 'createTeamContainers', 'createExternalTeam', 'getProfileWithMutability', 'getIsSiteAdmin', 'addUsersToTeam', 'removeTeamMemberships', 'getRecommendedProducts', 'joinOrRequestDefaultAccessToProductsBulk', 'getReadMediaToken', 'getWriteUserMediaToken', 'updateUserHeaderImage', 'getWriteTeamMediaToken', 'getSoftDeletedTeamById', 'restoreTeam', 'getUserInSiteUserBase', 'getLinkedTeamsBulk', 'getTeamProfileDetails', 'getUserContainers', 'getRecommendedUsers', 'getPermissions', 'getUserManageConfig', 'getMyAvatarUploadedStatus', 'deleteUserAvatar', 'getTeamLinkIcons', 'getTeamInSlack', 'getOrgScope', 'restoreTeamToSyncedGroup', 'getTeamAndGroupDiff', 'linkExistingTeamToGroup', 'fetchUserAvatarInfo', 'getOrgEligibilityForManagedTeams', 'updateUser', 'updateUserAvatar', 'disconnectTeamInSlack', 'updateTeamInSlack', 'getUserTenure', 'getAriFromUrl', 'getWebLinkTitle', 'addAgentToTeam', 'getTeamEnabledSites', 'assignTeamsToSites', 'removeAgentTeamAssociation', 'getAssignedTeams', 'setTeamSiteAssignmentPermission', 'getUnassignedTeams', 'getTeamSiteAssignmentOrgDetails', 'getTeamsToBeClonedToJsmSites', 'getReportingLines'];
 export var TEAMS_CLIENT_EXPERIENCES = new Map(_toConsumableArray(TeamsClientExperienceKeyList.map(function (key) {
   return [key,
   // camelCase to kebab-case

package/dist/esm/services/agg-client/utils/query-context-headers.js

@@ -0,0 +1,14 @@
+import { fg } from '@atlaskit/platform-feature-flags';
+
+/**
+ * Creates headers object with X-Query-Context header if cloudId is provided and feature flag is enabled.
+ * Use this for AGG client makeGraphQLRequest calls.
+ */
+export function createQueryContextHeaders(cloudId) {
+  if (!cloudId || !fg('enable_x_query_context_header')) {
+    return undefined;
+  }
+  return {
+    'X-Query-Context': "ari:cloud:platform::site/".concat(cloudId)
+  };
+}

package/dist/esm/services/collaborationgraph-client/index.js

@@ -44,6 +44,30 @@ export var CollaborationGraphClient = /*#__PURE__*/function (_RestClient) {
         expanded: true
       });
     }
+  }, {
+    key: "getRecommendedUsers",
+    value: function getRecommendedUsers(_ref2) {
+      var accountId = _ref2.accountId,
+        cloudId = _ref2.cloudId,
+        _ref2$maxNumberOfResu = _ref2.maxNumberOfResults,
+        maxNumberOfResults = _ref2$maxNumberOfResu === void 0 ? 12 : _ref2$maxNumberOfResu,
+        _ref2$filter = _ref2.filter,
+        filter = _ref2$filter === void 0 ? 'account_status:"active" AND (NOT email_domain:"connect.atlassian.com") AND (NOT account_type:"app")' : _ref2$filter;
+      return this.postResource('/v2/recommend/user', {
+        context: {
+          userId: accountId,
+          tenantId: cloudId
+        },
+        modelRequestParams: {
+          experience: 'CgUserNearbyUser',
+          caller: 'atlas'
+        },
+        requestingUserId: accountId,
+        expand: 'existing',
+        maxNumberOfResults: maxNumberOfResults,
+        filter: filter
+      });
+    }
   }]);
 }(RestClient);
 export default new CollaborationGraphClient({

package/dist/esm/services/graphql-client/main.js

@@ -1,3 +1,4 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
@@ -5,8 +6,11 @@ import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstruct
 import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
 import _inherits from "@babel/runtime/helpers/inherits";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+import { fg } from '@atlaskit/platform-feature-flags';
 import { DefaultError, GraphQLError } from '../../common/utils/error';
 import { BaseClient } from '../base-client';
 import { handleGraphQLRequest } from './utils';
@@ -24,34 +28,57 @@ export var BaseGraphQlClient = /*#__PURE__*/function (_BaseClient) {
     value: function setServiceUrl(serviceUrl) {
       this.serviceUrl = serviceUrl;
     }
+
+    /**
+     * Creates query context headers if cloudId is available and feature flag is enabled.
+     */
+  }, {
+    key: "createQueryContextHeaders",
+    value: function createQueryContextHeaders(cloudId) {
+      if (!cloudId || !fg('enable_x_query_context_header')) {
+        return undefined;
+      }
+      return {
+        'X-Query-Context': "ari:cloud:platform::site/".concat(cloudId)
+      };
+    }
   }, {
     key: "makeGraphQLRequest",
     value: function () {
       var _makeGraphQLRequest = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(body) {
         var options,
+          cloudId,
+          queryContextHeaders,
+          mergedOptions,
           _args = arguments;
         return _regeneratorRuntime.wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
               options = _args.length > 1 && _args[1] !== undefined ? _args[1] : {};
               _context.prev = 1;
-              return _context.abrupt("return", handleGraphQLRequest(this.serviceUrl, body, options));
-            case 5:
-              _context.prev = 5;
+              // Automatically add X-Query-Context header if cloudId is available in context
+              cloudId = this.getCloudId();
+              queryContextHeaders = this.createQueryContextHeaders(cloudId); // Merge headers: query context headers first, then provided headers (provided headers take precedence)
+              mergedOptions = _objectSpread(_objectSpread({}, options), {}, {
+                headers: _objectSpread(_objectSpread({}, queryContextHeaders), options.headers)
+              });
+              return _context.abrupt("return", handleGraphQLRequest(this.serviceUrl, body, mergedOptions));
+            case 8:
+              _context.prev = 8;
               _context.t0 = _context["catch"](1);
               if (!(_context.t0 instanceof GraphQLError)) {
-                _context.next = 9;
+                _context.next = 12;
                 break;
               }
               throw _context.t0;
-            case 9:
+            case 12:
               this.logException(_context.t0, 'UnknownError in GraphQLClient.makeGraphQLRequestWithoutRetries');
               throw new DefaultError({});
-            case 11:
+            case 14:
             case "end":
               return _context.stop();
           }
-        }, _callee, this, [[1, 5]]);
+        }, _callee, this, [[1, 8]]);
       }));
       function makeGraphQLRequest(_x) {
         return _makeGraphQLRequest.apply(this, arguments);

package/dist/esm/services/graphql-client/utils/index.js

@@ -1,5 +1,8 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import { GraphQLError, HttpError } from '../../../common/utils/error';
 import { EXPONENTIAL_BACKOFF_RETRY_POLICY, is5xx, isFetchResponse, withExponentialBackoff } from '../../../common/utils/http';
 import { handleResponse } from '../../../common/utils/status-code-handlers-provider';
@@ -25,9 +28,9 @@ function _makeGraphQLRequestWithoutRetries() {
           url = serviceUrl + operationNameQuery;
           request = fetch(url, {
             method: 'POST',
-            headers: new Headers({
+            headers: new Headers(_objectSpread({
               'Content-Type': 'application/json'
-            }),
+            }, options.headers || {})),
             credentials: 'include',
             body: JSON.stringify(body)
           }).then(function (res) {