@atlaskit/link-client-extension 7.3.1 → 8.0.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @atlaskit/link-client-extension
 
+## 8.0.1
+
+### Patch Changes
+
+- [`95e7e755dad59`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/95e7e755dad59) -
+  Add internal Integrations Service actions client (AGG actions.execute) for upcoming 3P Smart Link
+  actions. Requests send the AGG `atl-attribution` header. Not exported yet.
+
+## 8.0.0
+
+### Major Changes
+
+- [`0c7c7be927bde`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/0c7c7be927bde) -
+  Remove deprecated Volt re-export shims from public package entry points. Consumers should import
+  from the replacement subpaths or implementation entry points instead.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 7.3.1
 
 ### Patch Changes

package/compass.yml

@@ -1,7 +1,7 @@
 configVersion: 1
 id: ari:cloud:compass:a436116f-02ce-4520-8fbb-7301462a1674:component/c5751cc6-3513-4070-9deb-af31e86aed34/d73d78d0-7881-40ba-a725-b85820bc5e52
 name: '@atlaskit/link-client-extension'
-ownerId: ari:cloud:identity::team/0e6dedf8-18d1-4531-b4b9-07648a425d47 # Eng - Navigation Experiences (Darko Zoroja)
+ownerId: ari:cloud:identity::team/62c5672c-3754-4ebe-8a0f-4d1c87ded5b5 # Rovo Growth - Smartlinks (Rahul Lal)
 labels:
   - platform-code
   - platform-afm
@@ -16,17 +16,17 @@ links:
     url: https://bitbucket.org/atlassian/atlassian-frontend-monorepo/src/master
   - name: Slack Channel
     type: CHAT_CHANNEL
-    url: https://atlassian.enterprise.slack.com/archives/CFKGAQZRV # #help-fe-linking-platform
+    url: https://atlassian.enterprise.slack.com/archives/C0CBM48P0DS # #help-rovo-growth
   - name: Link Client Extension
     type: REPOSITORY
     url: https://bitbucket.org/atlassian/atlassian-frontend-monorepo/src/master/platform/packages/linking-platform/link-client-extension
 customFields:
   - name: Department
     type: text
-    value: Eng - Navigation Experiences
+    value: Eng - Rovo Search Growth
   - name: Technical Owner
     type: user
-    value: ari:cloud:identity::user/712020:3eb290b3-ff87-40f2-a7ef-4ee9d0ae10bd # Darko Zoroja
+    value: ari:cloud:identity::user/712020:297a7015-e760-4d56-aca3-30a62302ef0e # Rahul Lal
   - name: Required Reviewers Opt In
     type: boolean
     value: true
@@ -36,3 +36,6 @@ customFields:
   - name: Required Reviewer Approvals
     type: number
     value: 1
+  - name: Trusted Reviewer Teams
+    type: text
+    value: ari:cloud:identity::team/72f106a3-12dc-4883-ae1d-85623ffee537 # Rovo Growth - Smartlinks - Trusted Reviewers

package/dist/cjs/services/use-integration-actions-client/build-request-headers.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildRequestHeaders = void 0;
+var _constants = require("./constants");
+/**
+ * Smart Links product → GTM product name, from the AGG Metrics Attribution list.
+ * Products without a clear match are left out, so `product` is omitted from the header.
+ */
+var GTM_PRODUCT = {
+  ATLAS: 'Atlas',
+  BITBUCKET: 'Bitbucket Cloud',
+  CONFLUENCE: 'Confluence Cloud',
+  CSM: 'Customer Service Management',
+  JPD: 'Jira Product Discovery',
+  JSM: 'Jira Service Management',
+  JSW: 'Jira',
+  JWM: 'Jira',
+  TRELLO: 'Trello'
+};
+/**
+ * The `atl-attribution` header AGG asks frontend clients to send for metrics attribution:
+ * JSON with `tenantId`, `product` (when known) and `service`.
+ *
+ * See https://hello.atlassian.net/wiki/spaces/aggp/pages/5954141702
+ */
+var buildRequestHeaders = exports.buildRequestHeaders = function buildRequestHeaders(_ref) {
+  var cloudId = _ref.cloudId,
+    product = _ref.product;
+  var attribution = {
+    tenantId: cloudId || null,
+    product: product ? GTM_PRODUCT[product] : undefined,
+    service: _constants.ATTRIBUTION_SERVICE
+  };
+  return {
+    'atl-attribution': JSON.stringify(attribution)
+  };
+};

package/dist/cjs/services/use-integration-actions-client/constants.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.USER_CONSENT_REQUIRED = exports.GENERIC_OPERATION_ERROR_MESSAGE = exports.GENERIC_GRAPHQL_ERROR_MESSAGE = exports.EXECUTE_INTEGRATION_ACTION_OPERATION_NAME = exports.EXECUTE_INTEGRATION_ACTION_MUTATION = exports.ATTRIBUTION_SERVICE = void 0;
+var EXECUTE_INTEGRATION_ACTION_OPERATION_NAME = exports.EXECUTE_INTEGRATION_ACTION_OPERATION_NAME = 'LinkClientExtension_ExecuteIntegrationAction';
+var EXECUTE_INTEGRATION_ACTION_MUTATION = exports.EXECUTE_INTEGRATION_ACTION_MUTATION = "mutation ".concat(EXECUTE_INTEGRATION_ACTION_OPERATION_NAME, "(\n\t$actionTypeKey: String\n\t$filter: ActionsExecuteActionFilter!\n\t$actionInput: ActionsExecuteActionInput!\n\t$workspace: String\n) {\n\tactions {\n\t\texecute(\n\t\t\tactionTypeKey: $actionTypeKey\n\t\t\tfilter: $filter\n\t\t\tactionInput: $actionInput\n\t\t\tworkspace: $workspace\n\t\t) {\n\t\t\tstatus\n\t\t\toutputs\n\t\t}\n\t}\n}");
+var USER_CONSENT_REQUIRED = exports.USER_CONSENT_REQUIRED = 'USER_CONSENT_REQUIRED';
+
+/** `service` value for the AGG `atl-attribution` header. */
+var ATTRIBUTION_SERVICE = exports.ATTRIBUTION_SERVICE = 'link-client-extension';
+
+/** Fallback message when IS reports an error without one. */
+var GENERIC_OPERATION_ERROR_MESSAGE = exports.GENERIC_OPERATION_ERROR_MESSAGE = 'Action failed';
+
+/** Fallback message when AGG returns a GraphQL error without one. */
+var GENERIC_GRAPHQL_ERROR_MESSAGE = exports.GENERIC_GRAPHQL_ERROR_MESSAGE = 'GraphQL error';

package/dist/cjs/services/use-integration-actions-client/get-agg-url.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getAggUrl = void 0;
+var _getBaseUrl = require("@atlaskit/linking-common/get-base-url");
+var _constants = require("./constants");
+var EDGE_PROXY_AGG_PATH = '/gateway/api/graphql';
+
+/**
+ * AGG endpoint for the CardClient's environment.
+ * - No envKey (running inside a product): same-origin `/gateway/api/graphql`. On the server there
+ *   is no `window`, so this is relative and requests fail with an `http` error instead of crashing.
+ * - `custom`: `baseUrlOverride` is a full object resolver URL (e.g. a direct service URL for SSR),
+ *   so we can't build an AGG URL from it. Use the relative edge proxy path instead, the same
+ *   fallback `getResolverUrl` uses.
+ * - Other envKeys (e.g. `stg` in examples): the Stargate base URL for that environment + `/graphql`,
+ *   e.g. `https://pug.jira-dev.com/gateway/api/graphql`.
+ * The operation name is added as a query param so requests are easy to identify.
+ */
+var getAggUrl = exports.getAggUrl = function getAggUrl(envKey) {
+  var graphqlUrl;
+  if (envKey === 'custom') {
+    graphqlUrl = EDGE_PROXY_AGG_PATH;
+  } else if (envKey) {
+    var stargateBaseUrl = (0, _getBaseUrl.getBaseUrl)(envKey);
+    graphqlUrl = "".concat(stargateBaseUrl.replace(/\/$/, ''), "/graphql");
+  } else {
+    var origin = (0, _getBaseUrl.getBaseUrl)();
+    graphqlUrl = "".concat(origin).concat(EDGE_PROXY_AGG_PATH);
+  }
+  return "".concat(graphqlUrl, "?operationName=").concat(_constants.EXECUTE_INTEGRATION_ACTION_OPERATION_NAME);
+};

package/dist/cjs/services/use-integration-actions-client/index.js

@@ -0,0 +1,143 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useIntegrationActionsClient = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _react = require("react");
+var _api = require("@atlaskit/linking-common/api");
+var _buildRequestHeaders = require("./build-request-headers");
+var _constants = require("./constants");
+var _getAggUrl = require("./get-agg-url");
+var _integrationActionError = require("./integration-action-error");
+var _parseExecuteIntegrationActionResponse = require("./parse-execute-integration-action-response");
+// Check the shape rather than `instanceof Response`; `instanceof` checks on errors have caused HOTs before.
+var isResponseLike = function isResponseLike(value) {
+  return (0, _typeof2.default)(value) === 'object' && value !== null && typeof value.json === 'function';
+};
+var readErrorBody = /*#__PURE__*/function () {
+  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(response) {
+    var _t;
+    return _regenerator.default.wrap(function (_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _context.prev = 0;
+          _context.next = 1;
+          return response.json();
+        case 1:
+          return _context.abrupt("return", _context.sent);
+        case 2:
+          _context.prev = 2;
+          _t = _context["catch"](0);
+          return _context.abrupt("return", undefined);
+        case 3:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee, null, [[0, 2]]);
+  }));
+  return function readErrorBody(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();
+var toHttpError = function toHttpError(error, statusCode) {
+  return new _integrationActionError.IntegrationActionError('http', error instanceof Error && error.message ? error.message : "Request failed".concat(statusCode ? " with status ".concat(statusCode) : ''), {
+    statusCode: statusCode,
+    originalError: error
+  });
+};
+/**
+ * useIntegrationActionsClient
+ *
+ * Runs Integrations Service (IS) actions on 3P resources (e.g. listing or adding Google Docs
+ * comments) through the AGG `actions { execute }` mutation. Uses a plain fetch rather than Relay,
+ * so it works in any host that provides a CardClient.
+ *
+ * `executeAction` resolves with the action's `outputs`. It throws an `IntegrationActionError` when:
+ * - the user needs to connect their 3P account (`kind: 'consent-required'`, with `authUrl`)
+ * - IS reports the action failed (`kind: 'operation'`)
+ * - AGG returns GraphQL errors (`kind: 'graphql'`)
+ * - the request fails (`kind: 'http'`)
+ *
+ * Each request sends the AGG metrics attribution header (`atl-attribution`), using
+ * `actionInput.cloudId` as the tenant.
+ *
+ * Call `executeAction` from effects or event handlers, not during render (it doesn't run in SSR).
+ *
+ * @param cardClient used to pick the AGG endpoint for the environment
+ * @param options.product product hosting the Smart Link, for metrics attribution
+ */
+var useIntegrationActionsClient = exports.useIntegrationActionsClient = function useIntegrationActionsClient(cardClient) {
+  var _ref2 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+    product = _ref2.product;
+  var aggUrl = (0, _react.useMemo)(function () {
+    return (0, _getAggUrl.getAggUrl)(cardClient === null || cardClient === void 0 ? void 0 : cardClient.envKey);
+  }, [cardClient === null || cardClient === void 0 ? void 0 : cardClient.envKey]);
+  var executeAction = (0, _react.useCallback)( /*#__PURE__*/function () {
+    var _ref4 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(_ref3) {
+      var actionTypeKey, filter, actionInput, workspace, body, _errorBody$errors, _errorBody$data, errorBody, _t2;
+      return _regenerator.default.wrap(function (_context2) {
+        while (1) switch (_context2.prev = _context2.next) {
+          case 0:
+            actionTypeKey = _ref3.actionTypeKey, filter = _ref3.filter, actionInput = _ref3.actionInput, workspace = _ref3.workspace;
+            _context2.prev = 1;
+            _context2.next = 2;
+            return (0, _api.request)('post', aggUrl, {
+              operationName: _constants.EXECUTE_INTEGRATION_ACTION_OPERATION_NAME,
+              query: _constants.EXECUTE_INTEGRATION_ACTION_MUTATION,
+              variables: {
+                actionTypeKey: actionTypeKey,
+                filter: filter,
+                actionInput: actionInput,
+                workspace: workspace
+              }
+            }, (0, _buildRequestHeaders.buildRequestHeaders)({
+              cloudId: actionInput === null || actionInput === void 0 ? void 0 : actionInput.cloudId,
+              product: product
+            }), [200]);
+          case 2:
+            body = _context2.sent;
+            _context2.next = 7;
+            break;
+          case 3:
+            _context2.prev = 3;
+            _t2 = _context2["catch"](1);
+            if (!isResponseLike(_t2)) {
+              _context2.next = 6;
+              break;
+            }
+            _context2.next = 4;
+            return readErrorBody(_t2);
+          case 4:
+            errorBody = _context2.sent;
+            if (!(errorBody !== null && errorBody !== void 0 && (_errorBody$errors = errorBody.errors) !== null && _errorBody$errors !== void 0 && _errorBody$errors.length || errorBody !== null && errorBody !== void 0 && (_errorBody$data = errorBody.data) !== null && _errorBody$data !== void 0 && (_errorBody$data = _errorBody$data.actions) !== null && _errorBody$data !== void 0 && _errorBody$data.execute)) {
+              _context2.next = 5;
+              break;
+            }
+            return _context2.abrupt("return", (0, _parseExecuteIntegrationActionResponse.parseExecuteIntegrationActionResponse)(errorBody, _t2.status));
+          case 5:
+            throw toHttpError(undefined, _t2.status);
+          case 6:
+            throw toHttpError(_t2);
+          case 7:
+            return _context2.abrupt("return", (0, _parseExecuteIntegrationActionResponse.parseExecuteIntegrationActionResponse)(body, 200));
+          case 8:
+          case "end":
+            return _context2.stop();
+        }
+      }, _callee2, null, [[1, 3]]);
+    }));
+    return function (_x2) {
+      return _ref4.apply(this, arguments);
+    };
+  }(), [aggUrl, product]);
+  return (0, _react.useMemo)(function () {
+    return {
+      executeAction: executeAction
+    };
+  }, [executeAction]);
+};

package/dist/cjs/services/use-integration-actions-client/integration-action-error.js

@@ -0,0 +1,42 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.IntegrationActionError = void 0;
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime/helpers/possibleConstructorReturn"));
+var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime/helpers/getPrototypeOf"));
+var _inherits2 = _interopRequireDefault(require("@babel/runtime/helpers/inherits"));
+var _wrapNativeSuper2 = _interopRequireDefault(require("@babel/runtime/helpers/wrapNativeSuper"));
+function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2.default)(o), (0, _possibleConstructorReturn2.default)(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], (0, _getPrototypeOf2.default)(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; })(); }
+/** Thrown by `executeAction` when an action can't be run or fails. */
+var IntegrationActionError = exports.IntegrationActionError = /*#__PURE__*/function (_Error) {
+  /** Set when `kind` is `consent-required`: where the user can connect their 3P account. */
+
+  /** HTTP status, or the status IS reported for the action. */
+
+  /** The underlying error, when the request itself failed. */
+
+  function IntegrationActionError(kind, message) {
+    var _this;
+    var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+    (0, _classCallCheck2.default)(this, IntegrationActionError);
+    _this = _callSuper(this, IntegrationActionError, [message]);
+    _this.name = 'IntegrationActionError';
+    _this.kind = kind;
+    _this.authUrl = options.authUrl;
+    _this.errorType = options.errorType;
+    _this.retryable = options.retryable;
+    _this.statusCode = options.statusCode;
+    _this.graphQLErrors = options.graphQLErrors;
+    _this.operationErrors = options.operationErrors;
+    _this.originalError = options.originalError;
+    return _this;
+  }
+  (0, _inherits2.default)(IntegrationActionError, _Error);
+  return (0, _createClass2.default)(IntegrationActionError);
+}( /*#__PURE__*/(0, _wrapNativeSuper2.default)(Error));

package/dist/cjs/services/use-integration-actions-client/mocks.js

@@ -0,0 +1,91 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.mockExecuteIntegrationActionSuccessResponse = exports.mockExecuteIntegrationActionOperationFailureResponse = exports.mockExecuteIntegrationActionGraphQLErrorResponse = exports.mockExecuteIntegrationActionConsentRequiredResponse = exports.mockAuthUrl = void 0;
+/**
+ * Mock AGG `actions { execute }` responses, based on what the ASIMO-5527 spike saw
+ * on staging.
+ */
+
+var mockExecuteIntegrationActionSuccessResponse = exports.mockExecuteIntegrationActionSuccessResponse = {
+  data: {
+    actions: {
+      execute: {
+        status: 200,
+        outputs: {
+          entities: {
+            comments: [{
+              id: 'comment-1',
+              content: 'Looks good to me',
+              author: {
+                displayName: 'Jane Smith'
+              },
+              createdTime: '2026-10-27T01:00:00.000Z'
+            }]
+          }
+        }
+      }
+    }
+  }
+};
+var mockAuthUrl = exports.mockAuthUrl = 'https://id.atlassian.com/outboundAuth/start?key=google-drive';
+
+/** IS returns consent errors in `outputs.errors` with HTTP 200 and no GraphQL `errors`. */
+var mockExecuteIntegrationActionConsentRequiredResponse = exports.mockExecuteIntegrationActionConsentRequiredResponse = {
+  data: {
+    actions: {
+      execute: {
+        status: 401,
+        outputs: {
+          errors: [{
+            message: 'User consent is required to access this integration',
+            statusCode: 401,
+            extensions: {
+              errorType: 'USER_CONSENT_REQUIRED',
+              errorCategory: 'AUTH',
+              retryable: false,
+              authUrl: mockAuthUrl
+            }
+          }]
+        }
+      }
+    }
+  }
+};
+var mockExecuteIntegrationActionOperationFailureResponse = exports.mockExecuteIntegrationActionOperationFailureResponse = {
+  data: {
+    actions: {
+      execute: {
+        status: 404,
+        outputs: {
+          errors: [{
+            message: 'File not found',
+            statusCode: 404,
+            extensions: {
+              errorType: 'NOT_FOUND',
+              errorCategory: 'CLIENT',
+              retryable: false
+            }
+          }]
+        }
+      }
+    }
+  }
+};
+var mockExecuteIntegrationActionGraphQLErrorResponse = exports.mockExecuteIntegrationActionGraphQLErrorResponse = {
+  data: {
+    actions: {
+      execute: null
+    }
+  },
+  errors: [{
+    message: 'Action not found for filter',
+    path: ['actions', 'execute'],
+    extensions: {
+      classification: 'DataFetchingException',
+      statusCode: 400
+    }
+  }]
+};

package/dist/cjs/services/use-integration-actions-client/parse-execute-integration-action-response.js

@@ -0,0 +1,168 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.parseExecuteIntegrationActionResponse = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _constants = require("./constants");
+var _integrationActionError = require("./integration-action-error");
+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) { (0, _defineProperty2.default)(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; }
+var isRecord = function isRecord(value) {
+  return (0, _typeof2.default)(value) === 'object' && value !== null && !Array.isArray(value);
+};
+var isSuccessStatus = function isSuccessStatus(status) {
+  return status >= 200 && status < 300;
+};
+var getStringExtension = function getStringExtension(extensions, key) {
+  var value = extensions === null || extensions === void 0 ? void 0 : extensions[key];
+  return typeof value === 'string' && value !== '' ? value : undefined;
+};
+
+/**
+ * Returns `authUrl` from the extensions only if it's an absolute `https:` URL, so a malformed or
+ * unsafe value (e.g. `javascript:`) is never handed to the UI to open.
+ */
+var getAuthUrl = function getAuthUrl(extensions) {
+  var value = getStringExtension(extensions, 'authUrl');
+  if (!value) {
+    return undefined;
+  }
+  try {
+    return new URL(value).protocol === 'https:' ? value : undefined;
+  } catch (_unused) {
+    return undefined;
+  }
+};
+
+/** Normalises an entry of `outputs.errors`, which IS doesn't guarantee is well-formed. */
+var toOperationErrorEntry = function toOperationErrorEntry(error) {
+  if (typeof error === 'string') {
+    return {
+      message: error || _constants.GENERIC_OPERATION_ERROR_MESSAGE
+    };
+  }
+  if (!isRecord(error)) {
+    return {
+      message: _constants.GENERIC_OPERATION_ERROR_MESSAGE
+    };
+  }
+  return _objectSpread(_objectSpread({
+    message: typeof error.message === 'string' && error.message !== '' ? error.message : _constants.GENERIC_OPERATION_ERROR_MESSAGE
+  }, isRecord(error.extensions) ? {
+    extensions: error.extensions
+  } : {}), typeof error.statusCode === 'number' ? {
+    statusCode: error.statusCode
+  } : {});
+};
+
+/** Normalises an entry of the GraphQL `errors` array, which may be malformed. */
+var toGraphQLErrorEntry = function toGraphQLErrorEntry(error) {
+  if (!isRecord(error)) {
+    return {
+      message: typeof error === 'string' && error ? error : _constants.GENERIC_GRAPHQL_ERROR_MESSAGE
+    };
+  }
+  return _objectSpread(_objectSpread({
+    message: typeof error.message === 'string' && error.message !== '' ? error.message : _constants.GENERIC_GRAPHQL_ERROR_MESSAGE
+  }, isRecord(error.extensions) ? {
+    extensions: error.extensions
+  } : {}), Array.isArray(error.path) ? {
+    path: error.path
+  } : {});
+};
+
+/** A non-empty `outputs.errors` always means the action failed, even if the entries are malformed. */
+var getOperationErrors = function getOperationErrors(outputs) {
+  var errors = isRecord(outputs) ? outputs.errors : undefined;
+  if (!Array.isArray(errors) || errors.length === 0) {
+    return undefined;
+  }
+  return errors.map(toOperationErrorEntry);
+};
+var toOperationError = function toOperationError(operationErrors, status) {
+  var _error$extensions, _error$statusCode;
+  var consentError = operationErrors.find(function (error) {
+    return getStringExtension(error.extensions, 'errorType') === _constants.USER_CONSENT_REQUIRED || !!getAuthUrl(error.extensions);
+  });
+  var error = consentError !== null && consentError !== void 0 ? consentError : operationErrors[0];
+  var authUrl = getAuthUrl(consentError === null || consentError === void 0 ? void 0 : consentError.extensions);
+  var retryable = (_error$extensions = error.extensions) === null || _error$extensions === void 0 ? void 0 : _error$extensions.retryable;
+  var options = {
+    authUrl: authUrl,
+    errorType: getStringExtension(error.extensions, 'errorType'),
+    retryable: typeof retryable === 'boolean' ? retryable : undefined,
+    statusCode: (_error$statusCode = error.statusCode) !== null && _error$statusCode !== void 0 ? _error$statusCode : status,
+    operationErrors: operationErrors
+  };
+  if (consentError && authUrl) {
+    return new _integrationActionError.IntegrationActionError('consent-required', error.message, options);
+  }
+  return new _integrationActionError.IntegrationActionError('operation', error.message, options);
+};
+var toGraphQLError = function toGraphQLError(graphQLErrors, statusCode) {
+  var authUrl = graphQLErrors.map(function (error) {
+    return getAuthUrl(error.extensions);
+  }).find(function (url) {
+    return !!url;
+  });
+  var errorType = graphQLErrors.map(function (error) {
+    var _getStringExtension;
+    return (_getStringExtension = getStringExtension(error.extensions, 'errorType')) !== null && _getStringExtension !== void 0 ? _getStringExtension : getStringExtension(error.extensions, 'classification');
+  }).find(function (type) {
+    return !!type;
+  });
+  var message = graphQLErrors.map(function (error) {
+    return error.message;
+  }).join('; ');
+  var options = {
+    authUrl: authUrl,
+    errorType: errorType,
+    statusCode: statusCode,
+    graphQLErrors: graphQLErrors
+  };
+  if (authUrl) {
+    return new _integrationActionError.IntegrationActionError('consent-required', message, options);
+  }
+  return new _integrationActionError.IntegrationActionError('graphql', message, options);
+};
+
+/**
+ * Turns an AGG response body into the action response, or throws an `IntegrationActionError`.
+ *
+ * Errors are checked in this order:
+ * 1. IS operation errors in `outputs.errors` (consent required, or the action failed).
+ * 2. GraphQL `errors`, even with a partial `execute` result. The mutation only selects
+ *    `actions.execute`, so any GraphQL error relates to the action.
+ * 3. A missing `execute` result.
+ * 4. A non-2xx `status` from IS.
+ */
+var parseExecuteIntegrationActionResponse = exports.parseExecuteIntegrationActionResponse = function parseExecuteIntegrationActionResponse(body, httpStatus) {
+  var _body$data;
+  var execute = body === null || body === void 0 || (_body$data = body.data) === null || _body$data === void 0 || (_body$data = _body$data.actions) === null || _body$data === void 0 ? void 0 : _body$data.execute;
+  var graphQLErrors = Array.isArray(body === null || body === void 0 ? void 0 : body.errors) && body.errors.length ? body.errors.map(toGraphQLErrorEntry) : undefined;
+  var operationErrors = getOperationErrors(execute === null || execute === void 0 ? void 0 : execute.outputs);
+  if (operationErrors !== null && operationErrors !== void 0 && operationErrors.length) {
+    throw toOperationError(operationErrors, execute === null || execute === void 0 ? void 0 : execute.status);
+  }
+  if (graphQLErrors) {
+    throw toGraphQLError(graphQLErrors, httpStatus);
+  }
+  if (!execute) {
+    throw new _integrationActionError.IntegrationActionError('graphql', 'No action result returned', {
+      statusCode: httpStatus
+    });
+  }
+  if (typeof execute.status === 'number' && !isSuccessStatus(execute.status)) {
+    throw new _integrationActionError.IntegrationActionError('operation', "Action failed with status ".concat(execute.status), {
+      statusCode: execute.status
+    });
+  }
+  return {
+    status: execute.status,
+    outputs: execute.outputs
+  };
+};

package/dist/cjs/services/use-integration-actions-client/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/es2019/services/use-integration-actions-client/build-request-headers.js

@@ -0,0 +1,36 @@
+import { ATTRIBUTION_SERVICE } from './constants';
+
+/**
+ * Smart Links product → GTM product name, from the AGG Metrics Attribution list.
+ * Products without a clear match are left out, so `product` is omitted from the header.
+ */
+const GTM_PRODUCT = {
+  ATLAS: 'Atlas',
+  BITBUCKET: 'Bitbucket Cloud',
+  CONFLUENCE: 'Confluence Cloud',
+  CSM: 'Customer Service Management',
+  JPD: 'Jira Product Discovery',
+  JSM: 'Jira Service Management',
+  JSW: 'Jira',
+  JWM: 'Jira',
+  TRELLO: 'Trello'
+};
+/**
+ * The `atl-attribution` header AGG asks frontend clients to send for metrics attribution:
+ * JSON with `tenantId`, `product` (when known) and `service`.
+ *
+ * See https://hello.atlassian.net/wiki/spaces/aggp/pages/5954141702
+ */
+export const buildRequestHeaders = ({
+  cloudId,
+  product
+}) => {
+  const attribution = {
+    tenantId: cloudId || null,
+    product: product ? GTM_PRODUCT[product] : undefined,
+    service: ATTRIBUTION_SERVICE
+  };
+  return {
+    'atl-attribution': JSON.stringify(attribution)
+  };
+};