@hubspot/cli 7.8.0-experimental.0 → 7.8.0

package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js

@@ -0,0 +1,68 @@
+import { Tool } from '../../types.js';
+import { z } from 'zod';
+import { trackToolUsage } from '../../utils/toolUsageTracking.js';
+import { http } from '@hubspot/local-dev-lib/http';
+import { formatTextContents } from '../../utils/content.js';
+import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { getAccountId } from '@hubspot/local-dev-lib/config';
+const inputSchema = {
+    appId: z
+        .string()
+        .regex(/^\d+$/, 'App ID must be a numeric string')
+        .describe('The numeric app ID as a string (e.g., "3003909"). Use get-applications-info to find available app IDs.'),
+    startDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
+        .optional()
+        .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
+    endDate: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
+        .optional()
+        .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
+};
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const inputSchemaZodObject = z.object({ ...inputSchema });
+const toolName = 'get-api-usage-patterns-by-app-id';
+export class GetApiUsagePatternsByAppIdTool extends Tool {
+    constructor(mcpServer) {
+        super(mcpServer);
+    }
+    async handler({ appId, startDate, endDate, }) {
+        await trackToolUsage(toolName);
+        try {
+            // Get account ID from CLI config
+            const accountId = getAccountId();
+            if (!accountId) {
+                const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
+                return formatTextContents(authErrorMessage);
+            }
+            const response = await http.get(accountId, {
+                url: `app/feature/utilization/public/v3/insights/app/${appId}/usage-patterns`,
+                params: {
+                    ...(startDate && { startDate }),
+                    ...(endDate && { endDate }),
+                },
+            });
+            // Format the response for display
+            const { data } = response;
+            const formattedResult = JSON.stringify(data, null, 2);
+            return formatTextContents(formattedResult);
+        }
+        catch (error) {
+            if (isHubSpotHttpError(error)) {
+                // Handle HubSpot-specific HTTP errors
+                return formatTextContents(error.toString());
+            }
+            const errorMessage = `${error instanceof Error ? error.message : String(error)}`;
+            return formatTextContents(errorMessage);
+        }
+    }
+    register() {
+        return this.mcpServer.registerTool(toolName, {
+            title: 'Get API Usage Patterns by App ID',
+            description: 'Retrieves detailed API usage pattern analytics for a specific HubSpot application. Requires an appId (string) to identify the target application. Optionally accepts startDate and endDate parameters in YYYY-MM-DD format to filter results within a specific time range. Returns patternSummaries object containing usage statistics including portalPercentage (percentage of portals using this pattern) and numOfPortals (total count of portals) for different usage patterns. This data helps analyze how the application is being used across different HubSpot portals and can inform optimization decisions.',
+            inputSchema,
+        }, this.handler);
+    }
+}

package/mcp-server/tools/project/GetApplicationInfoTool.d.ts

@@ -0,0 +1,11 @@
+import { TextContentResponse, Tool } from '../../types.js';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+declare const inputSchemaZodObject: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetApplicationInfoInputSchema = z.infer<typeof inputSchemaZodObject>;
+export declare class GetApplicationInfoTool extends Tool<GetApplicationInfoInputSchema> {
+    constructor(mcpServer: McpServer);
+    handler({}: GetApplicationInfoInputSchema): Promise<TextContentResponse>;
+    register(): RegisteredTool;
+}
+export {};

package/mcp-server/tools/project/GetApplicationInfoTool.js

@@ -0,0 +1,49 @@
+import { Tool } from '../../types.js';
+import { z } from 'zod';
+import { trackToolUsage } from '../../utils/toolUsageTracking.js';
+import { http } from '@hubspot/local-dev-lib/http';
+import { formatTextContents } from '../../utils/content.js';
+import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { getAccountId } from '@hubspot/local-dev-lib/config';
+const inputSchema = {};
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const inputSchemaZodObject = z.object({ ...inputSchema });
+const toolName = 'get-applications-info';
+export class GetApplicationInfoTool extends Tool {
+    constructor(mcpServer) {
+        super(mcpServer);
+    }
+    async handler({}) {
+        await trackToolUsage(toolName);
+        try {
+            // Get account ID from CLI config
+            const accountId = getAccountId();
+            if (!accountId) {
+                const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
+                return formatTextContents(authErrorMessage);
+            }
+            const response = await http.get(accountId, {
+                url: `app/feature/utilization/public/v3/insights/apps`,
+            });
+            // Format the response for display
+            const { data } = response;
+            const formattedResult = JSON.stringify(data, null, 2);
+            return formatTextContents(formattedResult);
+        }
+        catch (error) {
+            if (isHubSpotHttpError(error)) {
+                // Handle HubSpot-specific HTTP errors
+                return formatTextContents(error.toString());
+            }
+            const errorMessage = `${error instanceof Error ? error.message : String(error)}`;
+            return formatTextContents(errorMessage);
+        }
+    }
+    register() {
+        return this.mcpServer.registerTool(toolName, {
+            title: 'Get Applications Information',
+            description: 'Retrieves a list of all HubSpot applications available in the current account. Returns an array of applications, where each application contains an appId (numeric identifier) and appName (string). This information is useful for identifying available applications before using other tools that require specific application IDs, such as getting API usage patterns. No input parameters are required - this tool fetches all applications from the HubSpot Insights API.',
+            inputSchema,
+        }, this.handler);
+    }
+}

package/mcp-server/tools/project/GetConfigValuesTool.d.ts

@@ -2,19 +2,22 @@ import { TextContentResponse, Tool } from '../../types.js';
 import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 declare const inputSchemaZodObject: z.ZodObject<{
+    absoluteCurrentWorkingDirectory: z.ZodString;
     platformVersion: z.ZodString;
     featureType: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     platformVersion: string;
+    absoluteCurrentWorkingDirectory: string;
     featureType: string;
 }, {
     platformVersion: string;
+    absoluteCurrentWorkingDirectory: string;
     featureType: string;
 }>;
 type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
 export declare class GetConfigValuesTool extends Tool<InputSchemaType> {
     constructor(mcpServer: McpServer);
-    handler({ platformVersion, featureType, }: InputSchemaType): Promise<TextContentResponse>;
+    handler({ absoluteCurrentWorkingDirectory, platformVersion, featureType, }: InputSchemaType): Promise<TextContentResponse>;
     register(): RegisteredTool;
 }
 export {};

package/mcp-server/tools/project/GetConfigValuesTool.js

@@ -1,10 +1,12 @@
 import { Tool } from '../../types.js';
 import { z } from 'zod';
 import { formatTextContents } from '../../utils/content.js';
+import { absoluteCurrentWorkingDirectory } from './constants.js';
 import { getIntermediateRepresentationSchema, mapToInternalType, } from '@hubspot/project-parsing-lib';
-import { getAccountId, getConfigPath, loadConfig, } from '@hubspot/local-dev-lib/config';
-import { useV3Api } from '../../../lib/projects/platformVersion.js';
+import { isV2Project } from '../../../lib/projects/platformVersion.js';
+import { getAccountIdFromCliConfig } from '../../utils/cliConfig.js';
 const inputSchema = {
+    absoluteCurrentWorkingDirectory,
     platformVersion: z
         .string()
         .describe('The platform version for the project. Located in the hsproject.json file.'),
@@ -16,21 +18,25 @@ const inputSchema = {
 const inputSchemaZodObject = z.object({
     ...inputSchema,
 });
-const toolName = 'get-hubspot-feature-config-schema';
+const toolName = 'get-feature-config-schema';
 export class GetConfigValuesTool extends Tool {
     constructor(mcpServer) {
         super(mcpServer);
     }
-    async handler({ platformVersion, featureType, }) {
+    async handler({ absoluteCurrentWorkingDirectory, platformVersion, featureType, }) {
         try {
-            if (!useV3Api(platformVersion)) {
+            if (!isV2Project(platformVersion)) {
                 return formatTextContents(`Can only be used on projects with a minimum platformVersion of 2025.2`);
             }
-            loadConfig(getConfigPath());
+            const accountId = getAccountIdFromCliConfig(absoluteCurrentWorkingDirectory);
+            if (!accountId) {
+                const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
+                return formatTextContents(authErrorMessage);
+            }
             const schema = await getIntermediateRepresentationSchema({
                 platformVersion,
                 projectSourceDir: '',
-                accountId: getAccountId(),
+                accountId,
             });
             const internalComponentType = mapToInternalType(featureType);
             if (schema[internalComponentType]) {

package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts

@@ -4,9 +4,9 @@ import { z } from 'zod';
 declare const inputSchemaZodObject: z.ZodObject<{
     command: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"hs init">, z.ZodLiteral<"hs auth">, z.ZodLiteral<"hs project create">, z.ZodLiteral<"hs project upload">]>>;
 }, "strip", z.ZodTypeAny, {
-    command?: "hs auth" | "hs project upload" | "hs project create" | "hs init" | undefined;
+    command?: "hs auth" | "hs project create" | "hs project upload" | "hs init" | undefined;
 }, {
-    command?: "hs auth" | "hs project upload" | "hs project create" | "hs init" | undefined;
+    command?: "hs auth" | "hs project create" | "hs project upload" | "hs init" | undefined;
 }>;
 type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
 export declare class GuidedWalkthroughTool extends Tool<InputSchemaType> {

package/mcp-server/tools/project/GuidedWalkthroughTool.js

@@ -24,7 +24,7 @@ const inputSchema = {
 const inputSchemaZodObject = z.object({
     ...inputSchema,
 });
-const toolName = 'guided-walkthrough-hubspot-cli';
+const toolName = 'guided-walkthrough-cli';
 export class GuidedWalkthroughTool extends Tool {
     constructor(mcpServer) {
         super(mcpServer);

package/mcp-server/tools/project/UploadProjectTools.js

@@ -11,7 +11,7 @@ const inputSchema = {
 const inputSchemaZodObject = z.object({
     ...inputSchema,
 });
-const toolName = 'upload-hubspot-project';
+const toolName = 'upload-project';
 export class UploadProjectTools extends Tool {
     constructor(mcpServer) {
         super(mcpServer);
@@ -24,7 +24,7 @@ export class UploadProjectTools extends Tool {
     register() {
         return this.mcpServer.registerTool(toolName, {
             title: 'Upload HubSpot Project',
-            description: 'Uploads the HubSpot project in current working directory.  If the project does not exist, it will be created. MUST be ran from within the project directory. DO NOT run this tool unless the user specifies they would like to upload the project, it is potentially destructive',
+            description: 'DO NOT run this tool unless the user specifies they would like to upload the project, it is potentially destructive. Uploads the HubSpot project in current working directory.  If the project does not exist, it will be created. MUST be ran from within the project directory.',
             inputSchema,
         }, this.handler);
     }

package/mcp-server/tools/project/ValidateProjectTool.js

@@ -9,7 +9,7 @@ const inputSchema = {
 };
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const inputSchemaZodObject = z.object({ ...inputSchema });
-const toolName = 'validate-hubspot-project';
+const toolName = 'validate-project';
 export class ValidateProjectTool extends Tool {
     constructor(mcpServer) {
         super(mcpServer);

package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js

@@ -28,7 +28,7 @@ describe('mcp-server/tools/project/AddFeatureToProject', () => {
     describe('register', () => {
         it('should register tool with correct parameters', () => {
             const result = tool.register();
-            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('add-feature-to-hubspot-project', expect.objectContaining({
+            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('add-feature-to-project', expect.objectContaining({
                 title: 'Add feature to HubSpot Project',
                 description: expect.stringContaining('Adds a feature to an existing HubSpot project'),
                 inputSchema: expect.any(Object),

package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js

@@ -6,7 +6,7 @@ vi.mock('@modelcontextprotocol/sdk/server/mcp.js');
 vi.mock('../../../utils/project');
 vi.mock('../../../utils/command');
 vi.mock('../../../../lib/constants');
-vi.mock('../../../../lib/projects/create/v3');
+vi.mock('../../../../lib/projects/create/v2');
 vi.mock('../../../utils/toolUsageTracking');
 const mockRunCommandInDir = runCommandInDir;
 const mockAddFlag = addFlag;
@@ -29,7 +29,7 @@ describe('mcp-server/tools/project/CreateProjectTool', () => {
     describe('register', () => {
         it('should register tool with correct parameters', () => {
             const result = tool.register();
-            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('create-hubspot-project', {
+            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('create-project', {
                 title: 'Create HubSpot Project',
                 description: 'Creates a HubSpot project with the provided name and outputs it in the provided destination',
                 inputSchema: expect.any(Object),

package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js

@@ -26,7 +26,7 @@ describe('mcp-server/tools/project/DeployProject', () => {
     describe('register', () => {
         it('should register tool with correct parameters', () => {
             const result = tool.register();
-            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('deploy-hubspot-project', {
+            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('deploy-project', {
                 title: 'Deploy a build of HubSpot Project',
                 description: expect.stringContaining('Takes a build number and a project name and deploys that build of the project'),
                 inputSchema: expect.any(Object),

package/mcp-server/tools/project/__tests__/DocFetchTool.test.js

@@ -24,9 +24,9 @@ describe('mcp-server/tools/project/DocFetchTool', () => {
     describe('register', () => {
         it('should register tool with correct parameters', () => {
             const result = tool.register();
-            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('fetch-hubspot-doc', {
+            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('fetch-doc', {
                 title: 'Fetch HubSpot Developer Documentation (single file)',
-                description: 'Always use this immediately after `search-hubspot-docs` and before creating a plan, writing code, or answering technical questions. This tool retrieves the full, authoritative content of a HubSpot Developer Documentation page from its URL, ensuring responses are accurate, up-to-date, and grounded in the official docs.',
+                description: 'Always use this immediately after `search-docs` and before creating a plan, writing code, or answering technical questions. This tool retrieves the full, authoritative content of a HubSpot Developer Documentation page from its URL, ensuring responses are accurate, up-to-date, and grounded in the official docs.',
                 inputSchema: expect.any(Object),
             }, tool.handler);
             expect(result).toBe(mockRegisteredTool);

package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js

@@ -1,14 +1,14 @@
 import { DocsSearchTool } from '../DocsSearchTool.js';
 import { http } from '@hubspot/local-dev-lib/http';
-import { getAccountId } from '@hubspot/local-dev-lib/config';
 import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+import { getAccountIdFromCliConfig } from '../../../utils/cliConfig.js';
 vi.mock('@modelcontextprotocol/sdk/server/mcp.js');
 vi.mock('@hubspot/local-dev-lib/http');
-vi.mock('@hubspot/local-dev-lib/config');
 vi.mock('@hubspot/local-dev-lib/errors/index');
 vi.mock('../../../utils/toolUsageTracking');
+vi.mock('../../../utils/cliConfig.js');
 const mockHttp = http;
-const mockGetAccountId = getAccountId;
+const mockGetAccountIdFromCliConfig = getAccountIdFromCliConfig;
 const mockIsHubSpotHttpError = vi.mocked(isHubSpotHttpError);
 describe('mcp-server/tools/project/DocsSearchTool', () => {
     let mockMcpServer;
@@ -27,9 +27,9 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
     describe('register', () => {
         it('should register tool with correct parameters', () => {
             const result = tool.register();
-            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('search-hubspot-docs', {
+            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('search-docs', {
                 title: 'Search HubSpot Developer Documentation',
-                description: 'Use this first whenever you need details about HubSpot APIs, SDKs, integrations, or developer platform features. This searches the official HubSpot Developer Documentation and returns the most relevant pages, each with a URL for use in `fetch-hubspot-doc`. Always follow this with a fetch to get the full, authoritative content before making plans or writing answers.',
+                description: 'Use this first whenever you need details about HubSpot APIs, SDKs, integrations, or developer platform features. This searches the official HubSpot Developer Documentation and returns the most relevant pages, each with a URL for use in `fetch-doc`. Always follow this with a fetch to get the full, authoritative content before making plans or writing answers.',
                 inputSchema: expect.any(Object),
             }, tool.handler);
             expect(result).toBe(mockRegisteredTool);
@@ -38,9 +38,10 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
     describe('handler', () => {
         const mockInput = {
             docsSearchQuery: 'test query',
+            absoluteCurrentWorkingDirectory: '/foo',
         };
         it('should return auth error message when no account ID is found', async () => {
-            mockGetAccountId.mockReturnValue(null);
+            mockGetAccountIdFromCliConfig.mockReturnValue(null);
             const result = await tool.handler(mockInput);
             expect(result).toEqual({
                 content: [
@@ -52,7 +53,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
             });
         });
         it('should return successful results when docs are found', async () => {
-            mockGetAccountId.mockReturnValue(12345);
+            mockGetAccountIdFromCliConfig.mockReturnValue(12345);
             const mockResponse = {
                 results: [
                     {
@@ -76,6 +77,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
                 data: mockResponse,
             });
             const result = await tool.handler(mockInput);
+            expect(mockGetAccountIdFromCliConfig).toHaveBeenCalledWith('/foo');
             expect(mockHttp.post).toHaveBeenCalledWith(12345, {
                 url: 'dev/docs/llms/v1/docs-search',
                 data: {
@@ -103,7 +105,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
             expect(resultText).toContain('Test content 2');
         });
         it('should return no results message when no documentation is found', async () => {
-            mockGetAccountId.mockReturnValue(12345);
+            mockGetAccountIdFromCliConfig.mockReturnValue(12345);
             const mockResponse = {
                 results: [],
             };
@@ -122,7 +124,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
             });
         });
         it('should return no results message when results is null', async () => {
-            mockGetAccountId.mockReturnValue(12345);
+            mockGetAccountIdFromCliConfig.mockReturnValue(12345);
             const mockResponse = {
                 results: null,
             };
@@ -141,7 +143,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
             });
         });
         it('should handle HubSpot HTTP errors', async () => {
-            mockGetAccountId.mockReturnValue(12345);
+            mockGetAccountIdFromCliConfig.mockReturnValue(12345);
             const mockError = {
                 toString: () => 'HubSpot API Error: 404 Not Found',
             };
@@ -158,7 +160,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
             });
         });
         it('should handle generic errors', async () => {
-            mockGetAccountId.mockReturnValue(12345);
+            mockGetAccountIdFromCliConfig.mockReturnValue(12345);
             const mockError = new Error('Network error');
             mockHttp.post.mockRejectedValue(mockError);
             mockIsHubSpotHttpError.mockReturnValue(false);
@@ -173,7 +175,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
             });
         });
         it('should handle non-Error rejections', async () => {
-            mockGetAccountId.mockReturnValue(12345);
+            mockGetAccountIdFromCliConfig.mockReturnValue(12345);
             mockHttp.post.mockRejectedValue('String error');
             mockIsHubSpotHttpError.mockReturnValue(false);
             const result = await tool.handler(mockInput);

package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts

@@ -0,0 +1 @@
+export {};

package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js

@@ -0,0 +1,169 @@
+import { GetApiUsagePatternsByAppIdTool } from '../GetApiUsagePatternsByAppIdTool.js';
+import { z } from 'zod';
+import { getAccountId } from '@hubspot/local-dev-lib/config';
+import { http } from '@hubspot/local-dev-lib/http';
+import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
+vi.mock('@modelcontextprotocol/sdk/server/mcp.js');
+vi.mock('../../../utils/toolUsageTracking');
+vi.mock('@hubspot/local-dev-lib/http');
+vi.mock('@hubspot/local-dev-lib/errors/index');
+vi.mock('@hubspot/local-dev-lib/config');
+const mockGetAccountId = getAccountId;
+const mockHttp = http;
+const mockIsHubSpotHttpError = isHubSpotHttpError;
+describe('mcp-server/tools/project/GetApiUsagePatternsByAppIdTool', () => {
+    let mockMcpServer;
+    let tool;
+    let mockRegisteredTool;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // @ts-expect-error Not mocking the whole thing
+        mockMcpServer = {
+            registerTool: vi.fn(),
+        };
+        mockRegisteredTool = {};
+        mockMcpServer.registerTool.mockReturnValue(mockRegisteredTool);
+        tool = new GetApiUsagePatternsByAppIdTool(mockMcpServer);
+    });
+    describe('register', () => {
+        it('should register tool with correct parameters', () => {
+            const result = tool.register();
+            expect(mockMcpServer.registerTool).toHaveBeenCalledWith('get-api-usage-patterns-by-app-id', {
+                title: 'Get API Usage Patterns by App ID',
+                description: 'Retrieves detailed API usage pattern analytics for a specific HubSpot application. Requires an appId (string) to identify the target application. Optionally accepts startDate and endDate parameters in YYYY-MM-DD format to filter results within a specific time range. Returns patternSummaries object containing usage statistics including portalPercentage (percentage of portals using this pattern) and numOfPortals (total count of portals) for different usage patterns. This data helps analyze how the application is being used across different HubSpot portals and can inform optimization decisions.',
+                inputSchema: expect.objectContaining({
+                    appId: expect.objectContaining({
+                        describe: expect.any(Function),
+                    }),
+                    startDate: expect.objectContaining({
+                        optional: expect.any(Function),
+                    }),
+                    endDate: expect.objectContaining({
+                        optional: expect.any(Function),
+                    }),
+                }),
+            }, tool.handler);
+            expect(result).toBe(mockRegisteredTool);
+        });
+    });
+    describe('input validation', () => {
+        const inputSchema = z.object({
+            appId: z
+                .string()
+                .describe('The application ID to get API usage patterns for.'),
+            startDate: z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
+                .optional()
+                .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
+            endDate: z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
+                .optional()
+                .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
+        });
+        it('should validate date format correctly', () => {
+            const validInput = {
+                appId: '12345',
+                startDate: '2025-01-01',
+                endDate: '2025-12-31',
+            };
+            const invalidInput = {
+                appId: '12345',
+                startDate: '2025-1-1',
+                endDate: '2025-12-31T00:00:00Z',
+            };
+            expect(() => inputSchema.parse(validInput)).not.toThrow();
+            expect(() => inputSchema.parse(invalidInput)).toThrow();
+        });
+    });
+    describe('handler', () => {
+        const input = {
+            appId: '12345',
+            startDate: '2025-01-01',
+            endDate: '2025-12-31',
+        };
+        beforeEach(() => {
+            mockGetAccountId.mockReturnValue(123456789);
+            mockIsHubSpotHttpError.mockReturnValue(false);
+        });
+        it('should return API usage patterns successfully', async () => {
+            const mockResponse = {
+                data: {
+                    patternSummaries: {
+                        additionalProp1: {
+                            portalPercentage: 25.5,
+                            numOfPortals: 150,
+                        },
+                        additionalProp2: {
+                            portalPercentage: 18.2,
+                            numOfPortals: 89,
+                        },
+                        additionalProp3: {
+                            portalPercentage: 32.1,
+                            numOfPortals: 201,
+                        },
+                    },
+                },
+                status: 200,
+                statusText: 'OK',
+                headers: {},
+                config: { headers: {} },
+            };
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            mockHttp.get.mockResolvedValue(mockResponse);
+            const result = await tool.handler(input);
+            expect(mockGetAccountId).toHaveBeenCalledWith();
+            expect(mockHttp.get).toHaveBeenCalledWith(123456789, {
+                url: 'app/feature/utilization/public/v3/insights/app/12345/usage-patterns',
+                params: {
+                    startDate: '2025-01-01',
+                    endDate: '2025-12-31',
+                },
+            });
+            expect(result).toEqual({
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(mockResponse.data, null, 2),
+                    },
+                ],
+            });
+        });
+        it('should return error when account ID cannot be determined', async () => {
+            mockGetAccountId.mockReturnValue(null);
+            const result = await tool.handler(input);
+            expect(result).toEqual({
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No account ID found. Please run `hs account auth` to configure an account, or set a default account with `hs account use <account>`',
+                    },
+                ],
+            });
+            expect(mockHttp.get).not.toHaveBeenCalled();
+        });
+        it('should handle empty usage patterns response', async () => {
+            const mockResponse = {
+                data: {
+                    patternSummaries: {},
+                },
+                status: 200,
+                statusText: 'OK',
+                headers: {},
+                config: { headers: {} },
+            };
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            mockHttp.get.mockResolvedValue(mockResponse);
+            const result = await tool.handler(input);
+            expect(result).toEqual({
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(mockResponse.data, null, 2),
+                    },
+                ],
+            });
+        });
+    });
+});

package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts

@@ -0,0 +1 @@
+export {};