feat: add getAppActionCallResponse method to fetch raw response data

- Implemented `getAppActionCallResponse` method in the `createEnvironmentApi` to retrieve the raw response (headers/body) for completed App Action Calls.
- Updated unit tests to validate the new API call functionality, ensuring correct request parameters and response handling.

Author: lewisjcs

lib/create-environment-api.ts

@@ -11,7 +11,10 @@ import type { BasicQueryOptions, MakeRequest } from './common-types'
 import entities from './entities'
 import type { CreateAppInstallationProps } from './entities/app-installation'
 import type { CreateAppSignedRequestProps } from './entities/app-signed-request'
-import type { CreateAppActionCallProps } from './entities/app-action-call'
+import type {
+  CreateAppActionCallProps,
+  AppActionCallRawResponseProps,
+} from './entities/app-action-call'
 import type {
   AssetFileProp,
   AssetProps,
@@ -1597,6 +1600,46 @@ export default function createEnvironmentApi(makeRequest: MakeRequest) {
         payload: data,
       }).then((payload) => wrapAppActionCall(makeRequest, payload))
     },
+
+    /**
+     * Gets the raw response (headers/body) for a completed App Action Call
+     * @param appDefinitionId - AppDefinition ID
+     * @param appActionId - App Action ID
+     * @param callId - App Action Call ID
+     * @return Promise for the raw response object including `response.body` and optional `response.headers`
+     * @example ```javascript
+     * const contentful = require('contentful-management')
+     *
+     * const client = contentful.createClient({
+     *   accessToken: '<content_management_api_key>'
+     * })
+     *
+     * client
+     *   .getSpace('<space_id>')
+     *   .then((space) => space.getEnvironment('<environment_id>'))
+     *   .then((environment) => environment.getAppActionCallResponse('<app_definition_id>', '<app_action_id>', '<call_id>'))
+     *   .then((raw) => console.log(raw.response.body))
+     *   .catch(console.error)
+     * ```
+     */
+    getAppActionCallResponse(
+      appDefinitionId: string,
+      appActionId: string,
+      callId: string
+    ): Promise<AppActionCallRawResponseProps> {
+      const raw = this.toPlainObject() as EnvironmentProps
+      return makeRequest({
+        entityType: 'AppActionCall',
+        action: 'getResponse',
+        params: {
+          spaceId: raw.sys.space.sys.id,
+          environmentId: raw.sys.id,
+          appDefinitionId,
+          appActionId,
+          callId,
+        },
+      })
+    },
     /**
      * Creates an app signed request
      * @param appDefinitionId - AppDefinition ID

test/unit/create-environment-api.test.ts

@@ -34,6 +34,7 @@ import { wrapAsset } from '../../lib/entities/asset'
 import { wrapTagCollection } from '../../lib/entities/tag'
 import setupMakeRequest from './mocks/makeRequest'
 import createEnvironmentApi from '../../lib/create-environment-api'
+import { AppActionCallRawResponseProps } from '../../lib/entities/app-action-call'
 
 function setup<T>(promise: Promise<T>) {
   const entitiesMock = setupEntitiesMock()
@@ -540,6 +541,38 @@ describe('A createEnvironmentApi', () => {
     })
   })
 
+  test('API call getAppActionCallResponse', async () => {
+    const rawResponse: AppActionCallRawResponseProps = {
+      sys: {
+        id: 'call-1',
+        type: 'AppActionCallResponse',
+        space: { sys: { type: 'Link', linkType: 'Space', id: 'spaceId' } },
+        environment: { sys: { type: 'Link', linkType: 'Environment', id: 'envId' } },
+        appInstallation: { sys: { type: 'Link', linkType: 'AppInstallation', id: 'appDef' } },
+        appAction: { sys: { type: 'Link', linkType: 'AppAction', id: 'actionId' } },
+        createdAt: new Date().toISOString(),
+      },
+      response: { body: '{"ok":true}' },
+    }
+
+    const { api, makeRequest } = setup(Promise.resolve(rawResponse))
+
+    const result = await api.getAppActionCallResponse('appDef', 'actionId', 'call-1')
+
+    expect(result).to.eql(rawResponse)
+    expect(makeRequest).toHaveBeenCalledWith({
+      entityType: 'AppActionCall',
+      action: 'getResponse',
+      params: {
+        spaceId: environmentMock.sys.space.sys.id,
+        environmentId: environmentMock.sys.id,
+        appDefinitionId: 'appDef',
+        appActionId: 'actionId',
+        callId: 'call-1',
+      },
+    })
+  })
+
   test('API call getAppInstallation', async () => {
     return makeGetEntityTest(setup, {
       entityType: 'appInstallation',