@hubspot/cli 5.4.0 → 6.0.0

package/lang/en.lyaml

@@ -483,6 +483,7 @@ en:
           errors:
             noProjectConfig: "No project detected. Please run this command again from a project directory."
             invalidProjectComponents: "Projects cannot contain both private and public apps. Move your apps to separate projects before attempting local development."
+            noRunnableComponents: "No supported components were found in this project. Run {{ command }} to see a list of available components and add one to your project."
             parentAccountNotConfigured: "To develop this project locally, run {{ authCommand }} to authenticate the App Developer Account {{ accountId }} associated with {{ accountIdentifier }}."
           examples:
             default: "Start local dev for the current project"
@@ -591,16 +592,18 @@ en:
         logs:
           describe: "Get execution logs for a serverless function within a project"
           errors:
-            invalidAppName: "Could not find app with name \"{{ appName }}\" in project \"{{ projectName }}\""
+            noProjectConfig: "No project detected. Run this command again from a project directory."
+            failedToFetchProjectDetails: "There was an error fetching project details"
+            noFunctionsLinkText: "Visit developer docs"
+            noFunctionsInProject: "There aren't any functions in this project\n\t- Run `{{#orange}}hs project logs --help{{/orange}}` to learn more about logs\n\t- {{link}} to learn more about serverless functions"
+            noFunctionWithName: "No function with name \"{{ name }}\""
+            functionNotDeployed: "The function with name \"{{ name }}\" is not deployed"
           logs:
             showingLogs: "Showing logs for:"
-            hubspotLogsLink: "View private apps in HubSpot"
-            hubspotLogsDirectLink: "View logs in HubSpot"
+            hubspotLogsDirectLink: "View function logs in HubSpot"
             noLogsFound: "No logs were found for \"{{ name }}\""
           table:
             accountHeader: "Account"
-            projectHeader: "Project"
-            appHeader: "App"
             functionHeader: "Function"
             endpointHeader: "Endpoint"
           examples:
@@ -617,12 +620,8 @@ en:
               describe: "Retrieve most recent log only"
             limit:
               describe: "Limit the number of logs to output"
-            project:
-              describe: "Project name"
             function:
               describe: "App function name"
-            endpoint:
-              describe: "Public endpoint path"
         upload:
           describe: "Upload your project files and create a new build"
           examples:
@@ -708,6 +707,20 @@ en:
               describe: "Open Github issues in your browser to report a bug."
             general:
               describe: "Open Github issues in your browser to give feedback."
+        installDeps:
+          help:
+            describe: "Install the dependencies for your project, or add a dependency to a subcomponent of a project"
+            installAppDepsExample: "Install the dependencies for the project"
+            addDepToSubComponentExample: "Install the dependencies to one or more project subcomponents"
+          installLocationPrompt: "Choose the project components to install the dependencies:"
+          installLocationPromptRequired: "You must choose at least one subcomponent"
+          installingDependencies: "Installing dependencies in {{directory}}"
+          installationSuccessful: "Installed dependencies in {{directory}}"
+          addingDependenciesToLocation: "Installing {{dependencies}} in {{directory}}"
+          installingDependenciesFailed: "Installing dependencies for {{directory}} failed"
+          noProjectConfig: "No project detected. Run this command from a project directory."
+          noPackageJsonInProject: "No dependencies to install. The project {{ projectName }} folder might be missing component or subcomponent files. {{ link }}"
+          packageManagerNotInstalled: "This command depends on {{ packageManager }}, install {{#bold}}{{ link }}{{/bold}}"
     remove:
       describe: "Delete a file or folder from HubSpot."
       deleted: "Deleted \"{{ path }}\" from account {{ accountId }}"
@@ -765,30 +778,6 @@ en:
           options:
             account:
               describe: "Account name or id to delete"
-        sync:
-          describe: "Sync to a sandbox account"
-          examples:
-            default: "Initiates a sync to a sandbox account."
-            force: "Skips all confirmation prompts when initiating a sync."
-          info:
-            developmentSandbox: "This will sync CRM object definitions."
-            standardSandbox: "This will sync all supported assets.
-              \nTo sync only specific assets, follow this link: {{#bold}}{{ url }}{{/bold}}"
-            sync: "\nSync direction:
-              \n- Target sandbox: {{#cyan}}{{#bold}}{{ sandboxName }}{{/bold}}{{/cyan}}
-              \n- Source account: {{#bold}}{{ parentAccountName }}{{/bold}}
-              \n\nRun {{#bold}}hs accounts use{{/bold}} to change your default account and sync to a different target sandbox."
-          warning:
-            developmentSandbox: "Syncing will update previously synced object definitions and add new ones from production to your development sandbox. Object definitions that were created in your sandbox will stay the same."
-            standardSandbox: "Syncing can have a big impact. Updates from your production account may overwrite changes in your standard sandbox. Standard sandboxes are usually shared with other Super Admins."
-          confirm:
-            developmentSandbox: "Sync CRM object definitions to {{#cyan}}{{#bold}}{{ sandboxName }}{{/bold}}{{/cyan}} from {{#bold}}{{ parentAccountName }}{{/bold}}?"
-            standardSandbox: "Sync all supported assets to {{#cyan}}{{#bold}}{{ sandboxName }}{{/bold}}{{/cyan}} from {{#bold}}{{ parentAccountName }}{{/bold}}?"
-          failure:
-            invalidAccountType: "Sync must be run in a sandbox account. Your default account is a {{ accountType }}. Run {{#bold}}hs auth{{/bold}} to connect your sandbox account to the CLI or {{#bold}}hs accounts use{{/bold}} to change your default account, then try again."
-            missingParentPortal: "The production account associated to {{#bold}}{{ sandboxName }}{{/bold}} is not connected to your HubSpot CLI.
-              \n- Run {{#bold}}hs auth{{/bold}} to connect that account to your terminal, then try again.
-              \n- Run {{#bold}}hs accounts use{{/bold}} to change your default account, if you want to sync to a different sandbox. Then try again.\n"
     secrets:
       describe: "Manage HubSpot secrets."
       subcommands:
@@ -984,7 +973,6 @@ en:
       failedToInitialize: "Missing required arguments to initialize Local Dev"
       noDeployedBuild: "Your project {{#bold}}{{ projectName }}{{/bold}} exists in {{ accountIdentifier }}, but has no deployed build. Projects must be successfully deployed to be developed locally. Address any build and deploy errors your project may have, then run {{ uploadCommand }} to upload and deploy your project."
       noComponents: "There are no components in this project."
-      noRunnableComponents: "No supported components were found under {{#bold}}{{ projectSourceDir }}{{/bold}}. Run {{ command }} to see a list of available components."
       betaMessage: "HubSpot projects local development"
       learnMoreLocalDevServer: "Learn more about the projects local dev server"
       running: "Running {{#bold}}{{ projectName }}{{/bold}} locally on {{ accountIdentifier }}, waiting for changes ..."
@@ -1024,7 +1012,6 @@ en:
         invalidPrivateAppAccount: "This project contains a private app. The account specified with the \"--account\" flag points to a developer account, which do not support the local development of private apps. Update the \"--account\" flag to point to a standard, sandbox, or developer test account, or change your default account by running {{ useCommand }}."
         nonSandboxWarning: "Testing in a sandbox is strongly recommended. To switch the target account, select an option below or run {{#bold}}`hs accounts use`{{/bold}} before running the command again."
         publicAppNonDeveloperTestAccountWarning: "Local development of public apps is only supported in {{#bold}}developer test accounts{{/bold}}."
-        privateAppInAppDeveloperAccountError: "Local development of private apps is not supported in {{#bold}}app developer accounts{{/bold}}"
       createNewProjectForLocalDev:
         projectMustExistExplanation: "The project {{ projectName }} does not exist in the target account {{ accountIdentifier}}. This command requires the project to exist in the target account."
         publicAppProjectMustExistExplanation: "The project {{ projectName }} does not exist in {{ accountIdentifier}}, the app developer account associated with your target account. This command requires the project to exist in this app developer account."
@@ -1120,12 +1107,6 @@ en:
           projectDevCommand:
             command: "hs project dev"
             message: "Run {{ command }} to set up your test environment and start local development"
-          sandboxSyncDevelopmentCommand:
-            command: "hs sandbox sync"
-            message: "Run {{ command }} to to update CRM object definitions in your sandbox"
-          sandboxSyncStandardCommand:
-            command: "hs sandbox sync"
-            message: "Run {{ command }} to to update all supported assets to your sandbox from production"
           sampleProjects:
             linkText: "HubSpot's sample projects"
             url: "https://developers.hubspot.com/docs/platform/sample-projects?utm_source=cli&utm_content=project_create_whats_next"
@@ -1170,16 +1151,7 @@ en:
         confirmDefaultAccount: "Continue testing on {{#bold}}{{ accountName }} ({{ accountType }}){{/bold}}? (Y/n)"
         confirmUseExistingDeveloperTestAccount: "Continue with {{ accountName }}? This account isn't currently connected to the HubSpot CLI. By continuing, you'll be prompted to generate a personal access key and connect it."
       projectLogsPrompt:
-        projectName:
-          message: "[--project] Enter the project name:"
-          error: "Project name is required"
-        logType:
-          message: "Select the type of serverless function"
-          function: "App function"
-          endpoint: "Public endpoint"
-        appName: "[--app] Select the app"
-        functionName: "[--function] Enter the app function name:"
-        endpointName: "[--endpoint] Enter the public endpoint path:"
+        functionName: "[--function] Select function in {{#bold}}{{projectName}}{{/bold}} project"
       setAsDefaultAccountPrompt:
         setAsDefaultAccountMessage: "Set this account as the default?"
         setAsDefaultAccount: "Account \"{{ accountName }}\" set as the default account"
@@ -1421,8 +1393,7 @@ en:
           successDevSbInfo: "Initiated sync of object definitions from production to {{ accountName }}. It may take some time. {{ url }}"
         failure:
           invalidUser: "Couldn't sync {{ accountName }} because your account has been removed from {{ parentAccountName }} or your permission set doesn't allow you to sync the sandbox. To update your permissions, contact a super admin in {{ parentAccountName }}."
-          missingScopes: "Couldn’t run the sync because there are scopes missing in your production account. To update scopes, deactivate your current personal access key for {{#bold}}{{ accountName }}{{/bold}}, and generate a new one. Then run `hs auth` to update the CLI with the new key."
-          syncInProgress: "Couldn’t run the sync because there’s another sync in progress. Wait for the current sync to finish and then try again. To check the sync status, visit the sync activity log: {{ url }}."
+          syncInProgress: "Couldn't run the sync because there's another sync in progress. Wait for the current sync to finish and then try again. To check the sync status, visit the sync activity log: {{ url }}."
           notSuperAdmin: "Couldn't run the sync because you are not a super admin in {{ account }}. Ask the account owner for super admin access to the sandbox."
           objectNotFound: "Couldn't sync the sandbox because {{#bold}}{{ account }}{{/bold}} may have been deleted through the UI. Run {{#bold}}hs sandbox delete{{/bold}} to remove this account from the config. "
     errorHandlers:
@@ -1437,21 +1408,6 @@ en:
         errorOccurred: "An error occurred while {{ fileAction }} {{ filepath }}."
         errorExplanation: "This is the result of a system error: {{ errorMessage }}"
       apiErrors:
-        messageDetail: "{{ request }} in account {{ accountId }}"
-        unableToUpload: 'Unable to upload "{{ payload }}.'
-        codes:
-          400: "The {{ messageDetail }} was bad."
-          401: "The {{ messageDetail }} was unauthorized."
-          403MissingScope: "Couldn't run the project command because there are scopes missing in your production account. To update scopes, deactivate your current personal access key for {{ accountId }}, and generate a new one. Then run `hs auth` to update the CLI with the new key."
-          403Gating: "The current target account {{ accountId }} does not have access to HubSpot projects. To opt in to the CRM Development Beta and use projects, visit https://app.hubspot.com/l/product-updates/in-beta?update=13899236."
-          403: "The {{ messageDetail }} was forbidden."
-          404Request: 'The {{ action }} failed because "{{ request }}" was not found in account {{ accountId }}.'
-          404: "The {{ messageDetail }} was not found."
-          429: "The {{ messageDetail }} surpassed the rate limit. Retry in one minute."
-          503: "The {{ messageDetail }} could not be handled at this time. Please try again or visit https://help.hubspot.com/ to submit a ticket or contact HubSpot Support if the issue persists."
-          500Generic: "The {{ messageDetail }} failed due to a server error. Please try again or visit https://help.hubspot.com/ to submit a ticket or contact HubSpot Support if the issue persists."
-          400Generic: "The {{ messageDetail }} failed due to a client error."
-          generic: "The {{ messageDetail }} failed."
         verifyAccessKeyAndUserAccess:
           fetchScopeDataError: "Error verifying access of scopeGroup {{ scopeGroup }}: {{ error }}"
           portalMissingScope: "Your account does not have access to this action. Talk to an account admin to request it."
@@ -1466,5 +1422,4 @@ en:
           updateProject: "Please update your project to the latest version and try again."
           docsLink: "Projects platform versioning (BETA)"
           betaLink: "For more info, see {{ docsLink }}."
-
-
+        missingScopeError: "Couldn't execute the {{ request }} because the access key for {{ accountName }} is missing required scopes. To update scopes, run {{ authCommand }}. Then deactivate the existing key and generate a new one that includes the missing scopes."

package/lib/LocalDevManager.js

@@ -63,7 +63,7 @@ class LocalDevManager {
     this.isGithubLinked = options.isGithubLinked;
     this.watcher = null;
     this.uploadWarnings = {};
-    this.runnableComponents = this.getRunnableComponents(options.components);
+    this.runnableComponents = options.runnableComponents;
     this.activeApp = null;
     this.activePublicAppData = null;
     this.env = options.env;
@@ -78,27 +78,6 @@ class LocalDevManager {
       logger.log(i18n(`${i18nKey}.failedToInitialize`));
       process.exit(EXIT_CODES.ERROR);
     }
-
-    // The project is empty, there is nothing to run locally
-    if (!options.components.length) {
-      logger.error(i18n(`${i18nKey}.noComponents`));
-      process.exit(EXIT_CODES.SUCCESS);
-    }
-
-    // The project does not contain any components that support local development
-    if (!this.runnableComponents.length) {
-      logger.error(
-        i18n(`${i18nKey}.noRunnableComponents`, {
-          projectSourceDir: this.projectSourceDir,
-          command: uiCommandReference('hs project add'),
-        })
-      );
-      process.exit(EXIT_CODES.SUCCESS);
-    }
-  }
-
-  getRunnableComponents(components) {
-    return components.filter(component => component.runnable);
   }
 
   async setActiveApp(appUid) {

package/lib/__tests__/dependencyManagement.test.js

@@ -0,0 +1,245 @@
+jest.mock('../projects');
+jest.mock('@hubspot/local-dev-lib/logger');
+jest.mock('@hubspot/local-dev-lib/fs');
+jest.mock('../ui/SpinniesManager');
+jest.mock('fs', () => ({
+  ...jest.requireActual('fs'),
+  existsSync: jest.fn().mockReturnValue(true),
+}));
+
+const util = require('util');
+const {
+  isGloballyInstalled,
+  installPackages,
+  getProjectPackageJsonLocations,
+} = require('../dependencyManagement');
+const { walk } = require('@hubspot/local-dev-lib/fs');
+const path = require('path');
+const { getProjectConfig } = require('../projects');
+const SpinniesManager = require('../ui/SpinniesManager');
+const { existsSync } = require('fs');
+
+describe('cli/lib/dependencyManagement', () => {
+  let execMock;
+
+  const projectDir = path.join('path', 'to', 'project');
+  const srcDir = 'src';
+  const appDir = path.join(projectDir, srcDir, 'app');
+  const appFunctionsDir = path.join(appDir, 'app.functions');
+  const extensionsDir = path.join(appDir, 'exensions');
+  const projectName = 'super cool test project';
+
+  beforeEach(() => {
+    execMock = jest.fn();
+    util.promisify = jest.fn().mockReturnValue(execMock);
+    getProjectConfig.mockResolvedValue({
+      projectDir,
+      projectConfig: {
+        srcDir,
+        name: projectName,
+      },
+    });
+  });
+
+  describe('isGloballyInstalled', () => {
+    it('should return true when exec is successful', async () => {
+      const actual = await isGloballyInstalled('npm');
+      expect(actual).toBe(true);
+      expect(execMock).toHaveBeenCalledTimes(1);
+      expect(execMock).toHaveBeenCalledWith('npm --version');
+    });
+
+    it('should return false when exec is unsuccessful', async () => {
+      execMock = jest.fn().mockImplementationOnce(() => {
+        throw new Error('unsuccessful');
+      });
+      util.promisify = jest.fn().mockReturnValueOnce(execMock);
+      const actual = await isGloballyInstalled('npm');
+      expect(actual).toBe(false);
+      expect(execMock).toHaveBeenCalledTimes(1);
+      expect(execMock).toHaveBeenCalledWith('npm --version');
+    });
+  });
+
+  describe('installPackages', () => {
+    it('should setup a loading spinner', async () => {
+      const packages = ['package1', 'package2'];
+      const installLocations = ['src/app/app.functions', 'src/app/extensions'];
+      await installPackages({ packages, installLocations });
+      expect(SpinniesManager.init).toHaveBeenCalledTimes(
+        installLocations.length
+      );
+      expect(SpinniesManager.add).toHaveBeenCalledTimes(
+        installLocations.length
+      );
+      expect(SpinniesManager.succeed).toHaveBeenCalledTimes(
+        installLocations.length
+      );
+    });
+
+    it('should install the provided packages in all the provided install locations', async () => {
+      const packages = ['package1', 'package2'];
+      const installLocations = ['src/app/app.functions', 'src/app/extensions'];
+      await installPackages({ packages, installLocations });
+
+      expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+      expect(SpinniesManager.add).toHaveBeenCalledTimes(
+        installLocations.length
+      );
+      expect(SpinniesManager.succeed).toHaveBeenCalledTimes(
+        installLocations.length
+      );
+
+      for (const location of installLocations) {
+        expect(execMock).toHaveBeenCalledWith(
+          `npm --prefix=${location} install package1 package2`
+        );
+        expect(SpinniesManager.add).toHaveBeenCalledWith(
+          `installingDependencies-${location}`,
+          {
+            text: `Installing [package1, package2] in ${location}`,
+          }
+        );
+        expect(SpinniesManager.succeed).toHaveBeenCalledWith(
+          `installingDependencies-${location}`,
+          {
+            text: `Installed dependencies in ${location}`,
+          }
+        );
+      }
+    });
+
+    it('should use the provided install locations', async () => {
+      const installLocations = ['src/app/app.functions', 'src/app/extensions'];
+      await installPackages({ installLocations });
+      expect(execMock).toHaveBeenCalledTimes(installLocations.length);
+      expect(execMock).toHaveBeenCalledWith(
+        `npm --prefix=${installLocations[0]} install`
+      );
+      expect(execMock).toHaveBeenCalledWith(
+        `npm --prefix=${installLocations[1]} install`
+      );
+    });
+
+    it('should locate the projects package.json files when install locations is not provided', async () => {
+      const installLocations = [
+        path.join(appFunctionsDir, 'package.json'),
+        path.join(extensionsDir, 'package.json'),
+      ];
+
+      walk.mockResolvedValue(installLocations);
+
+      getProjectConfig.mockResolvedValue({
+        projectDir,
+        projectConfig: {
+          srcDir,
+        },
+      });
+
+      await installPackages({});
+      // Its called once per each install location, plus once to check if npm installed
+      expect(execMock).toHaveBeenCalledTimes(installLocations.length + 1);
+      expect(execMock).toHaveBeenCalledWith(
+        `npm --prefix=${appFunctionsDir} install`
+      );
+      expect(execMock).toHaveBeenCalledWith(
+        `npm --prefix=${extensionsDir} install`
+      );
+    });
+
+    it('should throw an error when installing the dependencies fails', async () => {
+      execMock = jest.fn().mockImplementation(command => {
+        if (command !== 'npm --version') {
+          throw new Error('OH NO');
+        }
+      });
+
+      util.promisify = jest.fn().mockReturnValue(execMock);
+
+      const installLocations = [
+        path.join(appFunctionsDir, 'package.json'),
+        path.join(extensionsDir, 'package.json'),
+      ];
+
+      walk.mockResolvedValue(installLocations);
+
+      getProjectConfig.mockResolvedValue({
+        projectDir,
+        projectConfig: {
+          srcDir,
+        },
+      });
+
+      await expect(() => installPackages({})).rejects.toThrowError(
+        `Installing dependencies for ${appFunctionsDir} failed`
+      );
+
+      expect(SpinniesManager.fail).toHaveBeenCalledTimes(
+        installLocations.length
+      );
+
+      expect(SpinniesManager.fail).toHaveBeenCalledWith(
+        `installingDependencies-${appFunctionsDir}`,
+        {
+          text: `Installing dependencies for ${appFunctionsDir} failed`,
+        }
+      );
+      expect(SpinniesManager.fail).toHaveBeenCalledWith(
+        `installingDependencies-${extensionsDir}`,
+        {
+          text: `Installing dependencies for ${extensionsDir} failed`,
+        }
+      );
+    });
+  });
+
+  describe('getProjectPackageJsonFiles', () => {
+    it('should throw an error when ran outside the boundary of a project', async () => {
+      getProjectConfig.mockResolvedValue({});
+      await expect(() => getProjectPackageJsonLocations()).rejects.toThrowError(
+        'No project detected. Run this command from a project directory.'
+      );
+    });
+
+    it('should throw an error if npm is not globally installed', async () => {
+      execMock = jest.fn().mockImplementation(() => {
+        throw new Error('OH NO');
+      });
+      util.promisify = jest.fn().mockReturnValue(execMock);
+      await expect(() => getProjectPackageJsonLocations()).rejects.toThrowError(
+        /This command depends on npm, install/
+      );
+    });
+
+    it('should throw an error if the project directory does not exist', async () => {
+      existsSync.mockReturnValueOnce(false);
+      await expect(() => getProjectPackageJsonLocations()).rejects.toThrowError(
+        `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. Learn how to create a project from scratch.: https://developers.hubspot.com/beta-docs/guides/crm/intro/create-a-project`
+      );
+    });
+
+    it('should ignore package.json files in certain directories', async () => {
+      const nodeModulesDir = path.join(appDir, 'node_modules');
+      const viteDir = path.join(appDir, '.vite');
+      const installLocations = [
+        path.join(appFunctionsDir, 'package.json'),
+        path.join(extensionsDir, 'package.json'),
+        path.join(viteDir, 'package.json'),
+        path.join(nodeModulesDir, 'package.json'),
+      ];
+
+      walk.mockResolvedValue(installLocations);
+
+      const actual = await getProjectPackageJsonLocations();
+      expect(actual).toEqual([appFunctionsDir, extensionsDir]);
+    });
+
+    it('should throw an error if no package.json files are found', async () => {
+      walk.mockResolvedValue([]);
+
+      await expect(() => getProjectPackageJsonLocations()).rejects.toThrowError(
+        `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. Learn how to create a project from scratch.: https://developers.hubspot.com/beta-docs/guides/crm/intro/create-a-project`
+      );
+    });
+  });
+});

package/lib/__tests__/projectLogsManager.test.js

@@ -0,0 +1,210 @@
+jest.mock('../projects');
+jest.mock('@hubspot/local-dev-lib/api/projects');
+
+const ProjectLogsManager = require('../projectLogsManager');
+const { getProjectConfig, ensureProjectExists } = require('../projects');
+const {
+  fetchProjectComponentsMetadata,
+} = require('@hubspot/local-dev-lib/api/projects');
+
+describe('cli/lib/projectLogsManager', () => {
+  const accountId = 12345678;
+  const appId = 999999;
+  const projectName = 'super cool test project';
+  const projectConfig = { projectConfig: { name: projectName } };
+  const projectId = 987654321;
+  const projectDetails = {
+    project: {
+      id: projectId,
+      deployedBuild: {
+        subbuildStatuses: {},
+      },
+    },
+  };
+
+  const function1 = {
+    componentName: 'function1',
+    type: {
+      name: 'APP_FUNCTION',
+    },
+    deployOutput: {
+      appId,
+    },
+  };
+  const functions = [
+    function1,
+    {
+      componentName: 'function2',
+      type: {
+        name: 'APP_FUNCTION',
+      },
+      deployOutput: {
+        appId,
+      },
+    },
+  ];
+
+  beforeEach(() => {
+    ProjectLogsManager.reset();
+
+    getProjectConfig.mockResolvedValue(projectConfig);
+    ensureProjectExists.mockResolvedValue(projectDetails);
+    fetchProjectComponentsMetadata.mockResolvedValue({
+      topLevelComponentMetadata: [
+        {
+          type: {
+            name: 'PRIVATE_APP',
+          },
+          deployOutput: {
+            appId,
+          },
+          featureComponents: [
+            ...functions,
+            {
+              type: {
+                name: 'NOT_AN_APP_FUNCTION',
+              },
+            },
+          ],
+        },
+      ],
+    });
+  });
+
+  describe('init', () => {
+    it('should load the project config', async () => {
+      await ProjectLogsManager.init(accountId);
+      expect(getProjectConfig).toHaveBeenCalledTimes(1);
+    });
+
+    it('should throw an error if there is a problem with the config', async () => {
+      getProjectConfig.mockResolvedValue({});
+      await expect(async () =>
+        ProjectLogsManager.init(accountId)
+      ).rejects.toThrow(
+        'No project detected. Run this command again from a project directory.'
+      );
+      expect(getProjectConfig).toHaveBeenCalledTimes(1);
+    });
+
+    it('should ensure the project exists', async () => {
+      await ProjectLogsManager.init(accountId);
+      expect(ensureProjectExists).toHaveBeenCalledTimes(1);
+      expect(ensureProjectExists).toHaveBeenCalledWith(accountId, projectName, {
+        allowCreate: false,
+      });
+    });
+
+    it('should throw an error if there is data missing from the project details', async () => {
+      ensureProjectExists.mockResolvedValue({});
+      await expect(async () =>
+        ProjectLogsManager.init(accountId)
+      ).rejects.toThrow(/There was an error fetching project details/);
+    });
+
+    it('should set all of the expected fields correctly', async () => {
+      await ProjectLogsManager.init(accountId);
+      expect(ProjectLogsManager.projectId).toEqual(projectId);
+      expect(ProjectLogsManager.projectName).toEqual(projectName);
+      expect(ProjectLogsManager.accountId).toEqual(accountId);
+      expect(ProjectLogsManager.functions).toEqual(functions);
+    });
+  });
+
+  describe('fetchFunctionDetails', () => {
+    it('should throw an error if the projectId is null when the method is called', async () => {
+      await expect(async () =>
+        ProjectLogsManager.fetchFunctionDetails()
+      ).rejects.toThrow(
+        'No project detected. Run this command again from a project directory.'
+      );
+    });
+
+    it('should fetch the component metadata', async () => {
+      ProjectLogsManager.projectId = projectId;
+      ProjectLogsManager.accountId = accountId;
+      await ProjectLogsManager.fetchFunctionDetails();
+      expect(fetchProjectComponentsMetadata).toHaveBeenCalledTimes(1);
+      expect(fetchProjectComponentsMetadata).toHaveBeenCalledWith(
+        accountId,
+        projectId
+      );
+    });
+
+    it('should set the functions correctly', async () => {
+      ProjectLogsManager.projectId = projectId;
+      ProjectLogsManager.accountId = accountId;
+      await ProjectLogsManager.fetchFunctionDetails();
+      expect(ProjectLogsManager.functions).toEqual(functions);
+    });
+  });
+
+  describe('getFunctionNames', () => {
+    it('should return an empty array if functions is nullable', async () => {
+      ProjectLogsManager.functions = undefined;
+      expect(ProjectLogsManager.getFunctionNames()).toEqual([]);
+    });
+
+    it('should return an array of the componentNames', async () => {
+      ProjectLogsManager.functions = functions;
+      expect(ProjectLogsManager.getFunctionNames()).toEqual([
+        'function1',
+        'function2',
+      ]);
+    });
+  });
+
+  describe('setFunction', () => {
+    it('should throw an error when functions is nullable', async () => {
+      ProjectLogsManager.functions = undefined;
+      expect(() => ProjectLogsManager.setFunction('foo')).toThrow(
+        `There aren't any functions in this project`
+      );
+    });
+
+    it('should throw an error when the provided function is invalid', async () => {
+      ProjectLogsManager.functions = functions;
+      const badName = 'foo';
+      expect(() => ProjectLogsManager.setFunction(badName)).toThrow(
+        `No function with name "${badName}"`
+      );
+    });
+
+    it('should set the data correctly for public functions', async () => {
+      const functionToChoose = {
+        componentName: 'function1',
+        type: {
+          name: 'APP_FUNCTION',
+        },
+        deployOutput: {
+          endpoint: { path: 'yooooooo', method: ['GET'] },
+        },
+      };
+      ProjectLogsManager.functions = [functionToChoose];
+      ProjectLogsManager.setFunction('function1');
+      expect(ProjectLogsManager.functionName).toEqual('function1');
+      expect(ProjectLogsManager.endpointName).toEqual('yooooooo');
+      expect(ProjectLogsManager.selectedFunction).toEqual(functionToChoose);
+      expect(ProjectLogsManager.method).toEqual(['GET']);
+      expect(ProjectLogsManager.isPublicFunction).toEqual(true);
+    });
+
+    it('should set the data correctly for public functions', async () => {
+      ProjectLogsManager.functions = functions;
+      ProjectLogsManager.setFunction('function1');
+      expect(ProjectLogsManager.selectedFunction).toEqual(function1);
+      expect(ProjectLogsManager.functionName).toEqual('function1');
+      expect(ProjectLogsManager.isPublicFunction).toEqual(false);
+    });
+  });
+
+  describe('reset', () => {
+    it('should reset all the values', async () => {
+      ProjectLogsManager.someRandomField = 'value';
+      expect(ProjectLogsManager.someRandomField).toBeDefined();
+
+      ProjectLogsManager.reset();
+      expect(ProjectLogsManager.isPublicFunction).toBeUndefined();
+    });
+  });
+});