@friggframework/devtools 1.1.1-canary.282.4de1ac1.0 → 1.2.0-canary.293.50b9cd8.0

package/index.js

@@ -1,5 +1,5 @@
-const eslintConfig = require('./eslint-config')
-const prettierConfig = require('./prettier-config')
+const eslintConfig = require('../../../utils/eslint-config')
+const prettierConfig = require('../../../utils/prettier-config')
 const testEnvironment = require('./test-environment/index');
 
 module.exports = {

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "@friggframework/devtools",
   "prettier": "@friggframework/prettier-config",
-  "version": "1.1.1-canary.282.4de1ac1.0",
+  "version": "1.2.0-canary.293.50b9cd8.0",
   "dependencies": {
     "@babel/eslint-parser": "^7.18.9",
-    "@friggframework/core": "1.1.1-canary.282.4de1ac1.0",
     "eslint": "^8.22.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-json": "^3.1.0",
@@ -15,6 +14,7 @@
     "mongodb-memory-server": "^8.9.0"
   },
   "devDependencies": {
+    "@friggframework/core": "1.2.0-canary.293.50b9cd8.0",
     "jest": "^28.1.3",
     "prettier": "^2.7.1"
   },
@@ -37,5 +37,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "4de1ac138121295b795e1e9e0bb9e37bea2e8492"
+  "gitHead": "50b9cd8324cb94af601837fcd4661276613ecd47"
 }

package/test-environment/auther-definition-tester.js

@@ -1,11 +1,7 @@
-const {
-    Auther,
-    ModuleConstants,
-    createObjectId,
-    connectToDatabase,
-    disconnectFromDatabase,
-} = require('@friggframework/core');
-const { createMockApiObject } = require("./mock-integration");
+const { Auther } = require('@friggframework/core/module-plugin/auther');
+const { ModuleConstants } = require('@friggframework/core/module-plugin/ModuleConstants');
+const { createObjectId,connectToDatabase, disconnectFromDatabase } = require('@friggframework/core/database');
+const { createMockApiObject } = require("@friggframework/devtools/test-environment/mock-integration");
 
 
 function testAutherDefinition(definition, mocks) {

package/test-environment/index.js

@@ -1,24 +1,25 @@
-const { TestMongo } = require('./mongodb');
-const {
-    overrideEnvironment,
-    restoreEnvironment,
-} = require('./override-environment');
-const globalTeardown = require('./jest-global-teardown');
-const globalSetup = require('./jest-global-setup');
-const {testDefinitionRequiredAuthMethods} = require('./auther-definition-method-tester');
-const {createMockIntegration, createMockApiObject} = require('./mock-integration');
+const Authenticator = require('@friggframework/devtools/test/Authenticator')
+const { createMockIntegration, createMockApiObject } = require('mock-integration');
 const { testAutherDefinition } = require('./auther-definition-tester');
-const Authenticator = require('./Authenticator')
-
-module.exports = {
+const { testDefinitionRequiredAuthMethods } = require('./auther-definition-method-tester');
+const {  } = require('./../../utils/test-environment');
+const {
     TestMongo,
     overrideEnvironment,
     restoreEnvironment,
     globalTeardown,
     globalSetup,
+} = require('./../../../utils/test-environment');
+
+module.exports = {
     createMockIntegration,
     createMockApiObject,
     testDefinitionRequiredAuthMethods,
     testAutherDefinition,
-    Authenticator
+    Authenticator,
+    TestMongo,
+    overrideEnvironment,
+    restoreEnvironment,
+    globalTeardown,
+    globalSetup,
 };

package/test-environment/mock-integration.js

@@ -1,9 +1,8 @@
-const { Auther, Credential, Entity, IntegrationModel, mongoose } = require('@friggframework/core');
-
+const { Auther, Credential, Entity, IntegrationModel, createObjectId } = require('@friggframework/core')
 
 async function createMockIntegration(IntegrationClassDef, userId = null, config = {},) {
     const integration = new IntegrationClassDef();
-    userId = userId || new mongoose.Types.ObjectId();
+    userId = userId || createObjectId();
     integration.delegateTypes.push(...IntegrationClassDef.Config.events)
 
     const insertOptions = {
@@ -51,8 +50,9 @@ async function createMockIntegration(IntegrationClassDef, userId = null, config
     integration.id = integration.record._id
 
     for (const i in entities){
+        if (Object.entries(IntegrationClassDef.modules).length <= i) break
         const [moduleName, ModuleDef] = Object.entries(IntegrationClassDef.modules)[i];
-        const module = Auther.getInstance({definition: ModuleDef, userId: userId})
+        const module = await Auther.getInstance({definition: ModuleDef, userId: userId})
         module.entity = entities[i];
         integration[moduleName] = module;
     }

package/eslint-config/.eslintrc.json

@@ -1,3 +0,0 @@
-{
-    "extends": "@friggframework/eslint-config"
-}

package/eslint-config/CHANGELOG.md

@@ -1,17 +0,0 @@
-# v1.0.8 (Mon Jan 09 2023)
-
-#### 🐛 Bug Fix
-
-- Merge remote-tracking branch 'origin/main' into gitbook-updates [#48](https://github.com/friggframework/frigg/pull/48) ([@seanspeaks](https://github.com/seanspeaks))
-- Bump independent versions \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
-- Merge remote-tracking branch 'origin/main' into simplify-mongoose-models ([@seanspeaks](https://github.com/seanspeaks))
-- Add READMEs for all packages and api-modules [#20](https://github.com/friggframework/frigg/pull/20) ([@seanspeaks](https://github.com/seanspeaks))
-- Add READMEs for all packages and api-modules ([@seanspeaks](https://github.com/seanspeaks))
-
-#### ⚠️ Pushed to `main`
-
-- Refactored for more conventional naming (at least for packages) ([@seanspeaks](https://github.com/seanspeaks))
-
-#### Authors: 1
-
-- Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))

package/eslint-config/LICENSE.md

@@ -1,9 +0,0 @@
-MIT License
-
-Copyright (c) 2022 Left Hook Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/eslint-config/README.md

@@ -1,3 +0,0 @@
-# eslint-config
-
-This package exports the default `eslint-config` settings used in [Frigg](https://friggframework.org). You can find its documentation [on Frigg's website](https://docs.friggframework.org/packages/eslint-config).

package/eslint-config/index.js

@@ -1,38 +0,0 @@
-module.exports = {
-    env: {
-        commonjs: true,
-        es2020: true,
-        jest: true,
-    },
-    extends: ['prettier', 'plugin:markdown/recommended'],
-    parser: '@babel/eslint-parser',
-    parserOptions: {
-        ecmaVersion: 11,
-        requireConfigFile: false,
-    },
-    plugins: ['no-only-tests'],
-    ignorePatterns: ['coverage/', '.nyc_output/'],
-    overrides: [
-        {
-            files: ['*.json'],
-            plugins: ['json'],
-            extends: ['plugin:json/recommended'],
-        },
-        {
-            files: ['*.yaml', '*.yml'],
-            plugins: ['yaml'],
-            extends: ['plugin:yaml/recommended'],
-        },
-    ],
-    rules: {
-        'no-only-tests/no-only-tests': ['error', { fix: false }],
-        'no-unused-vars': [
-            'warn',
-            { vars: 'all', args: 'after-used', ignoreRestSiblings: false },
-        ],
-        'no-console': ['warn'],
-        camelcase: ['warn'],
-        'no-mixed-requires': ['warn'],
-        'no-warning-comments': ['warn'],
-    },
-};

package/prettier-config/.eslintrc.json

@@ -1,3 +0,0 @@
-{
-    "extends": "@friggframework/eslint-config"
-}

package/prettier-config/CHANGELOG.md

@@ -1,17 +0,0 @@
-# v1.0.6 (Mon Jan 09 2023)
-
-#### 🐛 Bug Fix
-
-- Merge remote-tracking branch 'origin/main' into gitbook-updates [#48](https://github.com/friggframework/frigg/pull/48) ([@seanspeaks](https://github.com/seanspeaks))
-- Bump independent versions \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
-- Merge remote-tracking branch 'origin/main' into simplify-mongoose-models ([@seanspeaks](https://github.com/seanspeaks))
-- Add READMEs for all packages and api-modules [#20](https://github.com/friggframework/frigg/pull/20) ([@seanspeaks](https://github.com/seanspeaks))
-- Add READMEs for all packages and api-modules ([@seanspeaks](https://github.com/seanspeaks))
-
-#### ⚠️ Pushed to `main`
-
-- Refactored for more conventional naming (at least for packages) ([@seanspeaks](https://github.com/seanspeaks))
-
-#### Authors: 1
-
-- Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))

package/prettier-config/LICENSE.md

@@ -1,9 +0,0 @@
-MIT License
-
-Copyright (c) 2022 Left Hook Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/prettier-config/README.md

@@ -1,3 +0,0 @@
-# prettier-config
-
-This package exports the `prettier-config` default used in [Frigg](https://friggframework.org). You can find its documentation [on Frigg's website](https://docs.friggframework.org/packages/prettier-config).

package/prettier-config/index.js

@@ -1,6 +0,0 @@
-module.exports = {
-    semi: true,
-    tabWidth: 4,
-    singleQuote: true,
-    useTabs: false,
-};

package/test-environment/.eslintrc.json

@@ -1,3 +0,0 @@
-{
-    "extends": "@friggframework/eslint-config"
-}

package/test-environment/CHANGELOG.md

@@ -1,46 +0,0 @@
-# v1.1.6 (Tue Jan 31 2023)
-
-#### 🐛 Bug Fix
-
-- Updates/api module yotpo [#108](https://github.com/friggframework/frigg/pull/108) ([@seanspeaks](https://github.com/seanspeaks))
-- # mock-api.js Work in Progress ([@seanspeaks](https://github.com/seanspeaks))
-- Bump independent versions \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
-
-#### Authors: 1
-
-- Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
-
----
-
-# v1.1.5 (Mon Jan 09 2023)
-
-#### 🐛 Bug Fix
-
-- Merge remote-tracking branch 'origin/main' into gitbook-updates [#48](https://github.com/friggframework/frigg/pull/48) ([@seanspeaks](https://github.com/seanspeaks))
-- Bump independent versions \[skip ci\] ([@seanspeaks](https://github.com/seanspeaks))
-- Merge remote-tracking branch 'origin/main' into simplify-mongoose-models ([@seanspeaks](https://github.com/seanspeaks))
-- Add READMEs for all packages and api-modules [#20](https://github.com/friggframework/frigg/pull/20) ([@seanspeaks](https://github.com/seanspeaks))
-- Add READMEs for all packages and api-modules ([@seanspeaks](https://github.com/seanspeaks))
-
-#### ⚠️ Pushed to `main`
-
-- Merge branch 'main' into gitbook-updates ([@seanspeaks](https://github.com/seanspeaks))
-- Refactored for more conventional naming (at least for packages) ([@seanspeaks](https://github.com/seanspeaks))
-
-#### Authors: 1
-
-- Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))
-
----
-
-# v1.1.4 (Mon Sep 19 2022)
-
-#### 🐛 Bug Fix
-
-- Test environment setup for all modules [#49](https://github.com/friggframework/frigg/pull/49) ([@seanspeaks](https://github.com/seanspeaks))
-- Test environment setup for all modules ([@seanspeaks](https://github.com/seanspeaks))
-- Merge remote-tracking branch 'origin/main' into gitbook-updates [#48](https://github.com/friggframework/frigg/pull/48) ([@seanspeaks](https://github.com/seanspeaks))
-
-#### Authors: 1
-
-- Sean Matthews ([@seanspeaks](https://github.com/seanspeaks))

package/test-environment/LICENSE.md

@@ -1,9 +0,0 @@
-MIT License
-
-Copyright (c) 2022 Left Hook Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/test-environment/README.md

@@ -1,3 +0,0 @@
-# test-environment
-
-This package exports the `test-environment` defaults used in [Frigg](https://friggframework.org). You can find its documentation [on Frigg's website](https://docs.friggframework.org/packages/test-environment).

package/test-environment/jest-global-setup.js

@@ -1,8 +0,0 @@
-const { TestMongo } = require('./mongodb');
-const { overrideEnvironment} = require('./override-environment');
-
-module.exports = async function () {
-    overrideEnvironment({ STAGE: 'dev'})
-    global.testMongo = new TestMongo();
-    await global.testMongo.start();
-};

package/test-environment/jest-global-teardown.js

@@ -1,5 +0,0 @@
-const { restoreEnvironment } = require('./override-environment');
-module.exports = async function () {
-    restoreEnvironment();
-    await global.testMongo.stop();
-};

package/test-environment/jest-preset.js

@@ -1,14 +0,0 @@
-module.exports = {
-    collectCoverage: true,
-    testTimeout: 20_000,
-    runner: 'groups',
-    coverageReporters: ['text'],
-    coverageThreshold: {
-        global: {
-            statements: 80,
-            branches: 80,
-            functions: 80,
-            lines: 80,
-        },
-    },
-};

package/test-environment/mock-api-readme.md

@@ -1,102 +0,0 @@
-# Mocked Requests Set Up for Your API Module
-
-## Add Tooling to the Test File
-
-Example code:
-
-```js
-const Api = require('./Api');
-const { mockApi } = require('../../../../test/utils/mockApi');
-
-const MockedApi = mockApi(Api, {
-    authenticationMode: 'browser',
-});
-
-describe('DemoNock API', async () => {
-    before(async function () {
-        await MockedApi.initialize({ test: this.test });
-    });
-
-    after(async function () {
-        await MockedApi.clean({ test: this.test });
-    });
-
-    it('tests a nice thing', async () => {
-        const api = await MockedApi.mock();
-        const users = await api.getUsers();
-        expect(users).to.have.length(2);
-    });
-});
-```
-
-Api - the LH API class that is being tested/mocked
-
-mockApi - tool to record/playback requests and automate login to API
-
-MockedApi - Api class with wrapper around it to record/playback requests and automate login to API. `authenticationMode` sets how to handle authentication when recording requests. Browser means it will require a manual step in the browser (uses Authenticator). Client credentials mode gets a token automcaitcally with machine-to-machine token. Manual means the developer will handle authentication manually, like setting an API key. By default mockApi will use the class name of the mocked API to name the output file. This can be overidden by passing in `displayName`.
-test/recorded-requests - the directory where recorded API requests are saved
-
-before - make sure to use the `async function` form here, so we can access mocha's `this` object. The call to `initialize` sets up the tooling for recording/playback
-
-after - same here need to use the `async function` form and pass in `this.test` to `clean`. This stops recording/playback and removes all hooks and other tooling from Node's HTTP code.
-
-test - instead of using `new Api` in your tests, use `await MockedApi.mock`. Any parameters you would normally pass into `new Api` will be passed through with the call to `mock`. The instance of the Api class that is returned will already be authenticated (unless using manual mode).
-
-## Creating new API tests
-
-When running your tests while creating them, use `npm --record-apis=demonock test`.
-
-This tells the tooling to record the requests made while running the tests for the DemoNockApi class.
-
-## Finalizing API tests
-
-When satisified with your tests, run `npm test` without adding the `--record-apis` flag to make sure the recorded requests worked. The tests should pass without needing you to perform a login step in the browser.
-
-## Tests that fail...
-
-Sometimes a "finished" test that was previously working starts to fail. Or, a test passes when it should fail (false negative). There are a few reasons this might happen.
-
-### Test fails after code updates
-
-If you made updates to the code, this may cause a test to fail. In this case the developer doesn't need to update mocks. To make the test pass, the updated code should be fixed, or the test should be updated to reflect the new data shape.
-
-One way to test for this scenario is running `npm test` in the main branch, seeing that all tests pass, and then confirming tests fail in your feature branch. This would show that the test is almost certainly failing due to a change in your branch.
-
-### Test should fail but passes
-
-If a test is passing, but in the "real world" the code is failing, the API response may have changed. Re-record mocks by running tests with `--record-apis=nockdemo`. Hopefully, one or more tests will now fail. These tests and related code should be updated to work with the new API response data shape.
-
-When creating the PR for this update, flag that the mocks were re-recorded so the updated mocks will be sure to be reviewed by another team member as part of code review.
-
-### Mocks in error state
-
-If the recorded files get messed up when updating (sometimes unavoidable under certain error conditions) just `git restore test/recorded-requests` or delete the file(s) in that directory and re-record.
-
-## Miscellaneous Notes
-
-More than one API can be set to record mode at a time: `npm --record-apis=activecampaign,hubspot test`
-
-You can use .only when --record-apis is passed, but only for the root level test suite. Otherwise an error will be thrown to prevent partial recording of the mocks. .skip is fine to use to skip tests that should not be recorded.
-
-CAN UPDATE RECORDED REQUESTS:
-
-```js
-describe('Nock Demo API', () => {
-    it('does x');
-    it.skip('does y');
-});
-```
-
-CANNOT UPDATE RECORDED REQUESTS:
-
-```js
-describe('Nock Demo API', () => {
-    it('does x');
-    it('does y');
-});
-```
-
-## Caveats
-
--   Client credential mode may only work with Crossbeam currently
--   Puppet mode (browser automation) for login is not yet implemented

package/test-environment/mock-api.js

@@ -1,284 +0,0 @@
-const nock = require('nock');
-const Authenticator = require('./Authenticator');
-const { join: joinPath } = require('path');
-const { parse: parseUrl } = require('url');
-const { mkdir, readFile, rename, rm, writeFile } = require('fs/promises');
-
-// TODO store in DB?
-const tokenDirectory = joinPath(process.cwd(), 'test', '.token-cache');
-const fixtureDirectory = joinPath(process.cwd(), 'test', 'recorded-requests');
-nock.back.fixtures = fixtureDirectory;
-
-// Try to rename but fail silently if the file does not exist.
-const tryRename = async (a, b) => {
-    try {
-        await rename(a, b);
-    } catch (error) {
-        if (error.code === 'ENOENT') {
-            return;
-        }
-        throw error;
-    }
-};
-const getJestGlobalState = () => {
-    const globalSymbols = Object.getOwnPropertySymbols(global);
-    let jestState;
-    globalSymbols.forEach((sym) => {
-        if (sym.toString() === 'Symbol(JEST_STATE_SYMBOL)') {
-            jestState = global[sym];
-        }
-    });
-
-    return jestState;
-};
-
-const checkForOnlies = () => {
-    let didFindOnly = false;
-    const findOnly = (child) => {
-        if (child.mode === 'only') {
-            didFindOnly = true;
-        }
-        if (child.children) {
-            child.children.forEach((nestedChild) => {
-                findOnly(nestedChild);
-            });
-        }
-    };
-    const jestState = getJestGlobalState();
-    const rootDescribe = jestState.rootDescribeBlock;
-
-    for (const child of rootDescribe.children) {
-        findOnly(child);
-    }
-
-    return didFindOnly;
-};
-
-const mockApi = (Api, classOptionByName = {}) => {
-    const {
-        authenticationMode,
-        displayName = Api.name,
-        filteringScope,
-    } = classOptionByName;
-    // The tag is the lower case display name, with any trailing 'Api' in the string removed.
-    const tag = displayName.replace(/Api$/i, '').toLowerCase();
-    const tokenFile = `${displayName}.json`;
-    const tokenFileFullPath = joinPath(tokenDirectory, tokenFile);
-
-    return class MockedApi extends Api {
-        static name = `Mocked${displayName}`;
-        static tokenResponse = null;
-        static excludedRecordingPaths = [];
-        static #context = {};
-
-        static async initialize() {
-            this.#context = {};
-
-            const didFindOnlies = checkForOnlies();
-
-            if (didFindOnlies) {
-                throw new Error(
-                    'Cancelled recording API mocks because some tests were marked `.only`.  Please remove any `.only`s from any `describe` blocks deeper than the root level, and all `it` blocks.'
-                );
-            }
-
-            this.#context.originalNockMode = nock.back.currentMode;
-
-            const { npm_config_record_apis: apisToRecordText = '' } =
-                process.env;
-            const apisToRecord = apisToRecordText
-                .split(',')
-                .map((name) => name.trim().toLowerCase());
-
-            if (apisToRecord.includes(tag)) {
-                this.#context.nockMode = 'update';
-            } else {
-                this.#context.nockMode = 'lockdown';
-            }
-
-            nock.back.setMode(this.#context.nockMode);
-
-            const fixtureFile = `${displayName}.json`;
-
-            if (this.#context.nockMode === 'update') {
-                const fixtureFileFullPath = joinPath(
-                    fixtureDirectory,
-                    fixtureFile
-                );
-                const fixtureFileBackupFullPath = joinPath(
-                    fixtureDirectory,
-                    `.${displayName}.json.backup`
-                );
-
-                await tryRename(fixtureFileFullPath, fixtureFileBackupFullPath);
-
-                this.#context.restoreFixture = async () =>
-                    await tryRename(
-                        fixtureFileBackupFullPath,
-                        fixtureFileFullPath
-                    );
-                this.#context.deleteFixtureBackup = async () =>
-                    await rm(fixtureFileBackupFullPath, { force: true });
-            }
-
-            const nockBack = await nock.back(fixtureFile, {
-                before: (scope) => {
-                    if (filteringScope) {
-                        scope.options.filteringScope = filteringScope;
-                    }
-                },
-                // Filter out token URLs
-                afterRecord: (recordings) =>
-                    recordings.filter(
-                        ({ path }) =>
-                            !this.excludedRecordingPaths.includes(path)
-                    ),
-                recorder: {
-                    output_objects: true,
-                    enable_reqheaders_recording: false,
-                },
-            });
-
-            this.#context.assertAllRequests = () =>
-                nockBack.context.assertScopesFinished();
-            this.#context.done = () => nockBack.nockDone();
-        }
-
-        static async clean() {
-            const {
-                assertAllRequests,
-                done,
-                nockMode,
-                originalNockMode,
-                restoreFixture,
-                deleteFixtureBackup,
-            } = this.#context;
-
-            const { didAllTestsPass } = global.mockApiResults;
-
-            if (done) {
-                done();
-            }
-            if (originalNockMode) {
-                nock.back.setMode(originalNockMode);
-            }
-            if (assertAllRequests && nockMode !== 'update') {
-                assertAllRequests();
-            }
-
-            nock.cleanAll();
-            nock.restore();
-
-            if (nockMode === 'update') {
-                if (!didAllTestsPass) {
-                    try {
-                        await restoreFixture();
-                    } finally {
-                        throw new Error(
-                            'Cancelled recording API mocks because some tests failed.  Please fix the failing tests and try to record again.'
-                        );
-                    }
-                } else {
-                    await deleteFixtureBackup();
-                }
-            }
-        }
-
-        static async saveCachedTokenResponse() {
-            if (!this.tokenResponse) {
-                return;
-            }
-
-            await mkdir(tokenDirectory, { recursive: true });
-            await writeFile(
-                tokenFileFullPath,
-                JSON.stringify(this.tokenResponse)
-            );
-        }
-
-        static async loadCachedTokenResponse() {
-            try {
-                const tokenResponseText = await readFile(tokenFileFullPath);
-                this.tokenResponse = JSON.parse(tokenResponseText);
-            } catch (error) {
-                if (error.code === 'ENOENT') {
-                    this.tokenResponse = null;
-                    return;
-                }
-                throw error;
-            }
-        }
-
-        static async mock(...constructorParameters) {
-            const api = new this(...constructorParameters);
-
-            if (nock.back.currentMode !== 'lockdown') {
-                await this.loadCachedTokenResponse();
-            }
-
-            // TODO read authentication mode from module package
-            if (authenticationMode === 'client_credentials') {
-                // TODO make generic (tied to crossbeam api)
-                api.grantType = 'client_credentials';
-                api.refreshAccessToken = api.getTokenFromClientCredentials;
-
-                if (process.env.CROSSBEAM_API_BASE_URL)
-                    api.baseUrl = process.env.CROSSBEAM_API_BASE_URL;
-                if (process.env.CROSSBEAM_API_AUTH_URL)
-                    api.tokenUri = `${process.env.CROSSBEAM_API_AUTH_URL}/oauth/token`;
-                if (process.env.CROSSBEAM_API_AUDIENCE)
-                    api.audience = process.env.CROSSBEAM_API_AUDIENCE;
-
-                api.client_secret = process.env.CROSSBEAM_TEST_CLIENT_SECRET;
-                api.client_id = process.env.CROSSBEAM_TEST_CLIENT_ID;
-                api.refreshAccessToken = api.getTokenFromClientCredentials;
-
-                this.tokenResponse = await api.getTokenFromClientCredentials();
-            } else if (authenticationMode === 'puppet') {
-                throw new Error('Not yet implemented');
-            } else if (authenticationMode === 'browser') {
-                if (nock.back.currentMode !== 'lockdown') {
-                    const { path: tokenPath } = parseUrl(api.tokenUri);
-                    this.excludedRecordingPaths.push(tokenPath);
-
-                    if (this.tokenResponse) {
-                        await api.setTokens(this.tokenResponse);
-
-                        try {
-                            await api.testAuth();
-                        } catch {
-                            this.tokenResponse = null;
-                            nock.cleanAll();
-                            await rm(tokenFileFullPath, {
-                                force: true,
-                            });
-                        }
-                    }
-
-                    if (!this.tokenResponse) {
-                        const url = api.authorizationUri;
-                        const { data } = await Authenticator.oauth2(url);
-                        const { code } = data;
-                        this.tokenResponse = await api.getTokenFromCode(code);
-                        await api.setTokens(this.tokenResponse);
-                        nock.cleanAll();
-                    }
-                }
-            } else if (authenticationMode === 'manual') {
-                // NOOP.  This space intentionally left blank.  No action should be performed in this mode, and the developer writing the test will handle authentication externally to this module.
-            } else {
-                throw new Error(
-                    'Unrecognized authentication mode for mocked API.'
-                );
-            }
-
-            if (nock.back.currentMode !== 'lockdown') {
-                await this.saveCachedTokenResponse();
-            }
-
-            return api;
-        }
-    };
-};
-
-module.exports = { mockApi };

package/test-environment/mongodb.js

@@ -1,22 +0,0 @@
-const { MongoMemoryServer } = require('mongodb-memory-server');
-
-class TestMongo {
-    #mongoServer;
-
-    // Start the in-memory mongo instance and set env variable for the app to use in its connection.
-    async start() {
-        this.#mongoServer = await MongoMemoryServer.create();
-        process.env.MONGO_URI = this.#mongoServer.getUri();
-        console.log('Started in memory mongo server', process.env.MONGO_URI);
-    }
-
-    async stop() {
-        await this.#mongoServer.stop();
-        process.env.MONGO_URI = undefined;
-        this.#mongoServer = undefined;
-    }
-}
-
-module.exports = {
-    TestMongo,
-};

package/test-environment/override-environment.js

@@ -1,11 +0,0 @@
-const originalEnv = process.env;
-
-function overrideEnvironment(overrideByKey) {
-    process.env = { ...process.env, ...overrideByKey };
-}
-
-function restoreEnvironment() {
-    process.env = originalEnv;
-}
-
-module.exports = { overrideEnvironment, restoreEnvironment };