adds local-only integration test for s3

.env.test.example.local

@@ -0,0 +1,4 @@
+S3_ACCESS_KEY_ID=
+S3_ACCESS_KEY_SECRET=
+S3_BUCKET=
+S3_REGION=

README.md

@@ -166,14 +166,14 @@ In order to try out UAA, you will need to comment out your CF_API_TOKEN and then
 
 ### Step 6: Testing
 
-To run the entire test suite, you will need to start the docker database container:
+To run the entire unit test suite, you will need to start the docker database container:
 
 ```bash
 cd cgui-db-docker
 docker compose up
 ```
 
-To run the entire test suite:
+Run the suite:
 
 ```bash
 npm test
@@ -185,6 +185,20 @@ To run test files matching certain text (one example):
 npm test -- serverside
 ```
 
+#### Integration testing
+
+We have one test that runs against the s3 bucket to test that updates to the AWS libraries have not broken the connection. This test runs locally and is not part of the CI pipeline. To run this test, set up a local-only test environment file. This file should not be tracked in version control:
+
+```bash
+cp .env.test.example.local .env.test.local
+```
+
+Then, if you have not already, set up a [s3 service key](#s3-user-information). Copy the values into `.env.test.local`.  To run the test:
+
+```bash
+npm run test:integration
+```
+
 ### Step 7: Committing
 
 #### Preparing your code

__tests__/api/aws/s3.test.integration.js

@@ -0,0 +1,21 @@
+import nock from 'nock';
+import { afterAll, beforeAll, describe, expect, it } from '@jest/globals';
+import { getUserLogonInfo } from '@/api/aws/s3';
+
+describe('s3 integration tests', () => {
+  beforeAll(() => {
+    // allow connection to AWS
+    nock.enableNetConnect('amazonaws.com');
+  });
+
+  afterAll(() => {
+    // disable network connections in case other tests are being run with this file
+    nock.disableNetConnect();
+  });
+
+  it('connects to the bucket and retrieves the user logon info file', async () => {
+    const info = await getUserLogonInfo();
+    expect(info).toBeDefined();
+    expect(info.user_summary).toBeDefined();
+  });
+});

package.json

@@ -5,7 +5,8 @@
     "dev": "next dev",
     "dev-cf": "./token-refresh.sh; next dev",
     "start": "next start",
-    "test": "jest",
+    "test": "jest --testPathPattern=test\\.js",
+    "test:integration": "jest --testPathPattern=integration\\.js --collectCoverage=false",
     "lint": "next lint",
     "format": "prettier --check '**/*.{js,jsx,ts,tsx}'",
     "format:fix": "prettier --write '**/*.{js,jsx,ts,tsx}'"