@hubspot/cli 7.7.3-experimental.0 → 7.7.5-experimental.0

package/lang/en.d.ts

@@ -26,6 +26,7 @@ The authentication method is ${string}, which is an access token tied to a speci
 Global configuration replaces hubspot.config.yml, and you will be prompted to migrate your existing config if one exists.`;
                 readonly options: {
                     readonly account: "HubSpot account to authenticate";
+                    readonly personalAccessKey: "Enter existing personal access key";
                 };
                 readonly errors: {
                     readonly failedToUpdateConfig: "Failed to update the configuration file. Please try again.";
@@ -153,6 +154,9 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
             readonly account: {
                 readonly describe: "HubSpot account to authenticate";
             };
+            readonly personalAccessKey: {
+                readonly describe: "Enter existing personal access key";
+            };
         };
         readonly success: {
             readonly configFileUpdated: (accountName: string, configFilename: string, authType: string) => string;
@@ -665,6 +669,21 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
                     readonly fetch: (tableId: string, path: string) => string;
                 };
             };
+            readonly list: {
+                readonly tables: `${string}:`;
+                readonly describe: "List HubDB tables.";
+                readonly labels: {
+                    readonly label: "Label";
+                    readonly id: "ID";
+                    readonly name: "Name";
+                    readonly columns: "Columns";
+                    readonly rows: "Rows";
+                };
+                readonly success: (accountId: number) => string;
+                readonly noTables: (accountId: number) => string;
+                readonly tablesDisplayed: (displayed: number, total: number, truncated?: number) => string;
+                readonly viewTablesLink: (baseUrl: string, accountId: number) => string;
+            };
         };
     };
     readonly init: {
@@ -1062,7 +1081,7 @@ ${string}`;
             readonly continueOrExitPrompt: "Press <enter> to load more, or ctrl+c to exit";
             readonly viewAllBuildsLink: "View all builds";
             readonly showingNextBuilds: (count: string, projectName: string) => string;
-            readonly showingRecentBuilds: (count: string, projectName: string, viewAllBuildsLink: string) => string;
+            readonly showingRecentBuilds: (count: number, projectName: string, viewAllBuildsLink: string) => string;
             readonly errors: {
                 readonly noBuilds: "No builds for this project were found.";
                 readonly projectNotFound: (projectName: string) => string;
@@ -2665,11 +2684,14 @@ Run ${string} to upgrade to version ${string}`;
             readonly enterAccountId: "Enter the account ID for your account (the number under the DOMAIN column at https://app.hubspot.com/myaccounts-beta ): ";
             readonly enterClientId: "Enter your OAuth2 client ID: ";
             readonly enterClientSecret: "Enter your OAuth2 client secret: ";
-            readonly enterPersonalAccessKey: "Enter your personal access key: ";
+            readonly enterPersonalAccessKey: "[--personal-access-key] Enter your personal access key: ";
             readonly selectScopes: "Select access scopes (see https://developers.hubspot.com/docs/methods/oauth2/initiate-oauth-integration#scopes)";
             readonly personalAccessKeySetupTitle: "HubSpot Personal Access Key Setup";
-            readonly personalAccessKeyBrowserOpenPrep: "A personal access key is required to authenticate the CLI to interact with your HubSpot account. We'll open a secure page in your default browser where you can view and copy your personal access key.";
-            readonly personalAccessKeyBrowserOpenPrompt: "Open HubSpot to copy your personal access key?";
+            readonly personalAccessKeyBrowserOpenPrep: "A personal access key is required to authenticate the CLI to interact with your HubSpot account.";
+            readonly personalAccessKeyPromptChoices: {
+                readonly OPEN_BROWSER: "Open HubSpot to copy your personal access key";
+                readonly PASTE_EXISTING: "Enter existing personal access key";
+            };
             readonly logs: {
                 readonly openingWebBrowser: (url: string) => string;
             };

package/lang/en.js

@@ -36,6 +36,7 @@ exports.commands = {
                 verboseDescribe: `Configure authentication for a HubSpot account. This will create or update the global config file at ${config_1.GLOBAL_CONFIG_PATH} that stores your account information.\n\nThe authentication method is ${chalk_1.default.bold(auth_1.PERSONAL_ACCESS_KEY_AUTH_METHOD.value)}, which is an access token tied to a specific user account.\n\nGlobal configuration replaces ${config_1.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME}, and you will be prompted to migrate your existing config if one exists.`,
                 options: {
                     account: 'HubSpot account to authenticate',
+                    personalAccessKey: 'Enter existing personal access key',
                 },
                 errors: {
                     failedToUpdateConfig: 'Failed to update the configuration file. Please try again.',
@@ -163,6 +164,9 @@ exports.commands = {
             account: {
                 describe: 'HubSpot account to authenticate',
             },
+            personalAccessKey: {
+                describe: 'Enter existing personal access key',
+            },
         },
         success: {
             configFileUpdated: (accountName, configFilename, authType) => `Account "${accountName}" updated in ${configFilename} using "${authType}"`,
@@ -675,6 +679,23 @@ exports.commands = {
                     fetch: (tableId, path) => `Downloaded HubDB table ${tableId} to ${path}`,
                 },
             },
+            list: {
+                tables: `${chalk_1.default.bold('Tables')}:`,
+                describe: 'List HubDB tables.',
+                labels: {
+                    label: 'Label',
+                    id: 'ID',
+                    name: 'Name',
+                    columns: 'Columns',
+                    rows: 'Rows',
+                },
+                success: (accountId) => `Showing tables for account ${accountId}:`,
+                noTables: (accountId) => `No tables found for account ${accountId}.`,
+                tablesDisplayed: (displayed, total, truncated) => `Displaying ${displayed} of ${total} tables${truncated
+                    ? `, the remaining ${truncated} tables were not displayed.`
+                    : '.'}`,
+                viewTablesLink: (baseUrl, accountId) => (0, ui_1.uiLink)('Manage tables in HubSpot', `${baseUrl}/hubdb/${accountId}`),
+            },
         },
     },
     init: {
@@ -1015,7 +1036,7 @@ exports.commands = {
                 },
             },
             creatingComponent: (projectName) => `\nAdding a new component to ${chalk_1.default.bold(projectName)}\n`,
-            success: (componentName, multiple = false) => `${componentName} ${multiple ? 'were' : 'was'} successfully added to your app.`,
+            success: (componentName, multiple = false) => `${componentName || 'An app'} ${multiple ? 'were' : 'was'} successfully added to your ${componentName ? 'app' : 'project'}.`,
             error: {
                 failedToDownloadComponent: 'Failed to download project component. Please try again later.',
                 maxExceeded: (maxCount) => `This project has the maximum allowed(${maxCount})`,
@@ -2661,11 +2682,14 @@ exports.lib = {
             enterAccountId: 'Enter the account ID for your account (the number under the DOMAIN column at https://app.hubspot.com/myaccounts-beta ): ',
             enterClientId: 'Enter your OAuth2 client ID: ',
             enterClientSecret: 'Enter your OAuth2 client secret: ',
-            enterPersonalAccessKey: 'Enter your personal access key: ',
+            enterPersonalAccessKey: '[--personal-access-key] Enter your personal access key: ',
             selectScopes: 'Select access scopes (see https://developers.hubspot.com/docs/methods/oauth2/initiate-oauth-integration#scopes)',
             personalAccessKeySetupTitle: 'HubSpot Personal Access Key Setup',
-            personalAccessKeyBrowserOpenPrep: "A personal access key is required to authenticate the CLI to interact with your HubSpot account. We'll open a secure page in your default browser where you can view and copy your personal access key.",
-            personalAccessKeyBrowserOpenPrompt: 'Open HubSpot to copy your personal access key?',
+            personalAccessKeyBrowserOpenPrep: 'A personal access key is required to authenticate the CLI to interact with your HubSpot account.',
+            personalAccessKeyPromptChoices: {
+                OPEN_BROWSER: 'Open HubSpot to copy your personal access key',
+                PASTE_EXISTING: 'Enter existing personal access key',
+            },
             logs: {
                 openingWebBrowser: (url) => `Opening ${url} in your web browser`,
             },

package/lib/prompts/personalAccessKeyPrompt.js

@@ -12,9 +12,9 @@ const urls_1 = require("@hubspot/local-dev-lib/urls");
 const logger_1 = require("@hubspot/local-dev-lib/logger");
 const promptUtils_1 = require("./promptUtils");
 const accountNamePrompt_1 = require("./accountNamePrompt");
-const lang_1 = require("../lang");
 const ui_1 = require("../ui");
 const exitCodes_1 = require("../enums/exitCodes");
+const en_1 = require("../../lang/en");
 /**
  * Displays notification to user that we are about to open the browser,
  * then opens their browser to the personal-access-key shortlink
@@ -23,24 +23,26 @@ async function personalAccessKeyPrompt({ env, account, }) {
     const websiteOrigin = (0, urls_1.getHubSpotWebsiteOrigin)(env);
     let url = `${websiteOrigin}/l/personal-access-key`;
     if (process.env.BROWSER !== 'none') {
-        (0, ui_1.uiInfoSection)((0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.personalAccessKeySetupTitle`), () => {
-            logger_1.logger.log((0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.personalAccessKeyBrowserOpenPrep`));
+        (0, ui_1.uiInfoSection)(en_1.lib.prompts.personalAccessKeyPrompt.personalAccessKeySetupTitle, () => {
+            logger_1.logger.log(en_1.lib.prompts.personalAccessKeyPrompt.personalAccessKeyBrowserOpenPrep);
         });
         if (account) {
             url = `${websiteOrigin}/personal-access-key/${account}`;
         }
-        const { personalAcessKeyBrowserOpenPrep: shouldOpen } = await (0, promptUtils_1.promptUser)([
+        const { personalAcessKeyBrowserOpenPrep: choice } = await (0, promptUtils_1.promptUser)([
             PERSONAL_ACCESS_KEY_BROWSER_OPEN_PREP,
         ]);
-        if (shouldOpen) {
-            (0, open_1.default)(url, { url: true });
-        }
-        else {
+        if (!choice) {
             (0, config_1.deleteEmptyConfigFile)();
             process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
         }
+        if (choice ===
+            en_1.lib.prompts.personalAccessKeyPrompt.personalAccessKeyPromptChoices
+                .OPEN_BROWSER) {
+            (0, open_1.default)(url, { url: true });
+            logger_1.logger.log(en_1.lib.prompts.personalAccessKeyPrompt.logs.openingWebBrowser(url));
+        }
     }
-    logger_1.logger.log((0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.logs.openingWebBrowser`, { url }));
     const { personalAccessKey } = await (0, promptUtils_1.promptUser)(PERSONAL_ACCESS_KEY);
     return {
         personalAccessKey,
@@ -49,52 +51,59 @@ async function personalAccessKeyPrompt({ env, account, }) {
 }
 const ACCOUNT_ID = {
     name: 'accountId',
-    message: (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.enterAccountId`),
+    message: en_1.lib.prompts.personalAccessKeyPrompt.enterAccountId,
     type: 'number',
     validate(val) {
         if (!Number.isNaN(val) && val !== undefined && val > 0) {
             return true;
         }
-        return (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.errors.invalidAccountId`);
+        return en_1.lib.prompts.personalAccessKeyPrompt.errors.invalidAccountId;
     },
 };
 const CLIENT_ID = {
     name: 'clientId',
-    message: (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.enterClientId`),
+    message: en_1.lib.prompts.personalAccessKeyPrompt.enterClientId,
     validate(val) {
         if (typeof val !== 'string') {
-            return (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.errors.invalidOauthClientId`);
+            return en_1.lib.prompts.personalAccessKeyPrompt.errors.invalidOauthClientId;
         }
         else if (val.length !== 36) {
-            return (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.errors.invalidOauthClientIdLength`);
+            return en_1.lib.prompts.personalAccessKeyPrompt.errors
+                .invalidOauthClientIdLength;
         }
         return true;
     },
 };
 const CLIENT_SECRET = {
     name: 'clientSecret',
-    message: (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.enterClientSecret`),
+    message: en_1.lib.prompts.personalAccessKeyPrompt.enterClientSecret,
     validate(val) {
         if (typeof val !== 'string') {
-            return (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.errors.invalidOauthClientSecret`);
+            return en_1.lib.prompts.personalAccessKeyPrompt.errors
+                .invalidOauthClientSecret;
         }
         else if (val.length !== 36) {
-            return (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.errors.invalidOauthClientSecretLength`);
+            return en_1.lib.prompts.personalAccessKeyPrompt.errors
+                .invalidOauthClientSecretLength;
         }
         else if (val[0] === '*') {
-            return (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.errors.invalidOauthClientSecretCopy`);
+            return en_1.lib.prompts.personalAccessKeyPrompt.errors
+                .invalidOauthClientSecretCopy;
         }
         return true;
     },
 };
 const PERSONAL_ACCESS_KEY_BROWSER_OPEN_PREP = {
     name: 'personalAcessKeyBrowserOpenPrep',
-    type: 'confirm',
-    message: (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.personalAccessKeyBrowserOpenPrompt`),
+    type: 'list',
+    message: 'Choose your preferred method of authentication',
+    choices: Object.values(en_1.lib.prompts.personalAccessKeyPrompt.personalAccessKeyPromptChoices),
+    default: en_1.lib.prompts.personalAccessKeyPrompt.personalAccessKeyPromptChoices
+        .OPEN_BROWSER,
 };
 const PERSONAL_ACCESS_KEY = {
     name: 'personalAccessKey',
-    message: (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.enterPersonalAccessKey`),
+    message: en_1.lib.prompts.personalAccessKeyPrompt.enterPersonalAccessKey,
     transformer: (val) => {
         if (!val)
             return val;
@@ -106,10 +115,12 @@ const PERSONAL_ACCESS_KEY = {
     },
     validate(val) {
         if (!val || typeof val !== 'string') {
-            return (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.errors.invalidPersonalAccessKey`);
+            return en_1.lib.prompts.personalAccessKeyPrompt.errors
+                .invalidPersonalAccessKey;
         }
         else if (val[0] === '•') {
-            return (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.errors.invalidPersonalAccessKeyCopy`);
+            return en_1.lib.prompts.personalAccessKeyPrompt.errors
+                .invalidPersonalAccessKeyCopy;
         }
         return true;
     },
@@ -117,7 +128,7 @@ const PERSONAL_ACCESS_KEY = {
 const SCOPES = {
     type: 'checkbox',
     name: 'scopes',
-    message: (0, lang_1.i18n)(`lib.prompts.personalAccessKeyPrompt.selectScopes`),
+    message: en_1.lib.prompts.personalAccessKeyPrompt.selectScopes,
     default: [...auth_1.DEFAULT_OAUTH_SCOPES],
     choices: [...auth_1.OAUTH_SCOPES],
 };

package/lib/prompts/projectAddPrompt.js

@@ -66,7 +66,7 @@ async function projectAddPromptV3(components, selectedFeatures) {
         {
             name: 'componentTemplate',
             message: en_1.lib.prompts.projectAddPrompt.selectType,
-            when: selectedComponents.length === 0,
+            when: !selectedFeatures && selectedComponents.length === 0,
             type: 'checkbox',
             choices: components,
         },

package/lib/prompts/promptUtils.d.ts

@@ -4,10 +4,11 @@ export declare function confirmPrompt(message: string, options?: {
     defaultAnswer?: boolean;
     when?: PromptWhen;
 }): Promise<boolean>;
-export declare function listPrompt<T = string>(message: string, { choices, when, defaultAnswer, }: {
+export declare function listPrompt<T = string>(message: string, { choices, when, defaultAnswer, validate, }: {
     choices: PromptChoices<T>;
     when?: PromptWhen;
     defaultAnswer?: string | number | boolean;
+    validate?: (input: T[]) => (boolean | string) | Promise<boolean | string>;
 }): Promise<T>;
 export declare function inputPrompt(message: string, { when, validate, defaultAnswer, }?: {
     when?: boolean | (() => boolean);

package/lib/prompts/promptUtils.js

@@ -22,7 +22,7 @@ async function confirmPrompt(message, options = {}) {
     ]);
     return choice;
 }
-async function listPrompt(message, { choices, when, defaultAnswer, }) {
+async function listPrompt(message, { choices, when, defaultAnswer, validate, }) {
     const { choice } = await promptUser([
         {
             name: 'choice',
@@ -31,6 +31,7 @@ async function listPrompt(message, { choices, when, defaultAnswer, }) {
             choices,
             when,
             default: defaultAnswer,
+            validate,
         },
     ]);
     return choice;

package/mcp-server/server.d.ts

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

package/mcp-server/server.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const tools_1 = require("./tools");
+const server = new mcp_js_1.McpServer({
+    name: 'HubSpot CLI MCP Server',
+    version: '0.0.1',
+    description: 'Helps perform tasks for local development of HubSpot projects.',
+    capabilities: {
+        tools: {},
+        prompts: {},
+    },
+});
+(0, tools_1.registerProjectTools)(server);
+// Start receiving messages on stdin and sending messages on stdout
+const transport = new stdio_js_1.StdioServerTransport();
+server.connect(transport);

package/mcp-server/tools/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectTools(mcpServer: McpServer): RegisteredTool[];

package/mcp-server/tools/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProjectTools = registerProjectTools;
+const UploadProjectTools_1 = require("./project/UploadProjectTools");
+const CreateProjectTool_1 = require("./project/CreateProjectTool");
+const GuidedWalkthroughTool_1 = require("./project/GuidedWalkthroughTool");
+const DeployProject_1 = require("./project/DeployProject");
+const AddFeatureToProject_1 = require("./project/AddFeatureToProject");
+function registerProjectTools(mcpServer) {
+    return [
+        UploadProjectTools_1.UploadProjectTools.register(mcpServer),
+        CreateProjectTool_1.CreateProjectTool.register(mcpServer),
+        GuidedWalkthroughTool_1.GuidedWalkthroughTool.register(mcpServer),
+        DeployProject_1.DeployProject.register(mcpServer),
+        AddFeatureToProject_1.AddFeatureToProject.register(mcpServer),
+    ];
+}

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

@@ -0,0 +1,6 @@
+import { Tool } from '../../types';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class AddFeatureToProject extends Tool {
+    private static mcpServer;
+    static register(mcpServer: McpServer): RegisteredTool;
+}

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

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddFeatureToProject = void 0;
+const types_1 = require("../../types");
+const zod_1 = require("zod");
+const constants_1 = require("../../../lib/constants");
+const command_1 = require("../../utils/command");
+const constants_2 = require("./constants");
+const project_1 = require("../../utils/project");
+class AddFeatureToProject extends types_1.Tool {
+    static mcpServer;
+    static register(mcpServer) {
+        this.mcpServer = mcpServer;
+        return this.mcpServer.registerTool('add-feature-to-hubspot-project', {
+            title: 'Add feature to HubSpot Project',
+            description: 'Adds a feature to an existing HubSpot project',
+            inputSchema: {
+                absoluteProjectPath: constants_2.absoluteProjectPath,
+                addApp: zod_1.z.boolean().describe('Would you like to add an app?'),
+                distribution: zod_1.z
+                    .optional(zod_1.z.union([
+                    zod_1.z.literal(constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE),
+                    zod_1.z.literal(constants_1.APP_DISTRIBUTION_TYPES.PRIVATE),
+                ]))
+                    .describe('Private is used if you do not wish to distribute your application on the HubSpot marketplace. If not specified by the user, do not choose for them.  This cannot be changed after a project is uploaded.'),
+                auth: zod_1.z
+                    .optional(zod_1.z.union([
+                    zod_1.z.literal(constants_1.APP_AUTH_TYPES.STATIC),
+                    zod_1.z.literal(constants_1.APP_AUTH_TYPES.OAUTH),
+                ]))
+                    .describe('Static uses a static non changing authentication token, and is only available for private distribution. If not specified by the user, do not choose for them.  This cannot be changed after a project is uploaded.')
+                    .optional(),
+                features: zod_1.z
+                    .array(zod_1.z
+                    .union([
+                    zod_1.z.literal('card'),
+                    zod_1.z.literal('settings'),
+                    zod_1.z.literal('app-function'),
+                    zod_1.z.literal('webhooks'),
+                ])
+                    .describe('The features to include in the project, multiple options can be selected'))
+                    .optional(),
+            },
+        }, async ({ absoluteProjectPath, distribution, auth, features, addApp }) => {
+            try {
+                let command = `hs project add`;
+                const content = [];
+                if (distribution) {
+                    command = (0, command_1.addFlag)(command, 'distribution', distribution);
+                }
+                else if (addApp) {
+                    content.push({
+                        type: 'text',
+                        text: `Ask the user how they would you like to distribute the application? Options are ${constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE} and ${constants_1.APP_DISTRIBUTION_TYPES.PRIVATE}`,
+                    });
+                }
+                if (auth) {
+                    command = (0, command_1.addFlag)(command, 'auth', auth);
+                }
+                else if (addApp) {
+                    content.push({
+                        type: 'text',
+                        text: `Ask the user which auth type they would like to use? Options are ${constants_1.APP_AUTH_TYPES.STATIC} and ${constants_1.APP_AUTH_TYPES.OAUTH}`,
+                    });
+                }
+                if (content.length > 0) {
+                    return {
+                        content,
+                    };
+                }
+                // If features isn't provided, pass an empty array to bypass the prompt
+                command = (0, command_1.addFlag)(command, 'features', features || []);
+                const { stdout, stderr } = await (0, project_1.runCommandInDir)(absoluteProjectPath, command);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: stdout,
+                        },
+                        {
+                            type: 'text',
+                            text: stderr,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: error instanceof Error ? error.message : `${error}`,
+                        },
+                    ],
+                };
+            }
+        });
+    }
+}
+exports.AddFeatureToProject = AddFeatureToProject;

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

@@ -0,0 +1,6 @@
+import { Tool } from '../../types';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class CreateProjectTool extends Tool {
+    private static mcpServer;
+    static register(mcpServer: McpServer): RegisteredTool;
+}

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

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateProjectTool = void 0;
+const types_1 = require("../../types");
+const zod_1 = require("zod");
+const constants_1 = require("../../../lib/constants");
+const command_1 = require("../../utils/command");
+const v3_1 = require("../../../lib/projects/create/v3");
+const constants_2 = require("./constants");
+const project_1 = require("../../utils/project");
+class CreateProjectTool extends types_1.Tool {
+    static mcpServer;
+    static register(mcpServer) {
+        this.mcpServer = mcpServer;
+        return this.mcpServer.registerTool('create-hubspot-project', {
+            title: 'Create HubSpot Project',
+            description: 'Creates a HubSpot project with the provided name and outputs it in the provided destination',
+            inputSchema: {
+                absoluteCurrentWorkingDirectory: constants_2.absoluteCurrentWorkingDirectory,
+                name: zod_1.z
+                    .string()
+                    .describe('The name of the project to be created.  This name is how your project will appear in HubSpot.'),
+                destination: zod_1.z
+                    .string()
+                    .describe('Relative path to the directory the project will be created in. It is not recommended to use the current directory unless it is an empty directory'),
+                projectBase: zod_1.z
+                    .union([zod_1.z.literal(v3_1.EMPTY_PROJECT), zod_1.z.literal(v3_1.PROJECT_WITH_APP)])
+                    .describe('Empty will create and empty project, and app will create a project with an app inside of it.'),
+                distribution: zod_1.z
+                    .optional(zod_1.z.union([
+                    zod_1.z.literal(constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE),
+                    zod_1.z.literal(constants_1.APP_DISTRIBUTION_TYPES.PRIVATE),
+                ]))
+                    .describe('Private is used if you do not wish to distribute your application on the HubSpot marketplace. If not specified by the user, do not choose for them.  This cannot be changed after a project is uploaded.'),
+                auth: zod_1.z
+                    .optional(zod_1.z.union([
+                    zod_1.z.literal(constants_1.APP_AUTH_TYPES.STATIC),
+                    zod_1.z.literal(constants_1.APP_AUTH_TYPES.OAUTH),
+                ]))
+                    .describe('Static uses a static non changing authentication token, and is only available for private distribution. If not specified by the user, do not choose for them.  This cannot be changed after a project is uploaded.')
+                    .optional(),
+                features: zod_1.z
+                    .array(zod_1.z
+                    .union([
+                    zod_1.z.literal('card'),
+                    zod_1.z.literal('settings'),
+                    zod_1.z.literal('app-function'),
+                    zod_1.z.literal('webhooks'),
+                ])
+                    .describe('The features to include in the project, multiple options can be selected'))
+                    .optional(),
+            },
+        }, async ({ name, destination, projectBase, distribution, auth, features, absoluteCurrentWorkingDirectory, }) => {
+            let command = (0, command_1.addFlag)('hs project create', 'platform-version', '2025.2');
+            const content = [];
+            if (name) {
+                command = (0, command_1.addFlag)(command, 'name', name);
+            }
+            if (destination) {
+                command = (0, command_1.addFlag)(command, 'dest', destination);
+            }
+            if (projectBase) {
+                command = (0, command_1.addFlag)(command, 'project-base', projectBase);
+            }
+            if (distribution) {
+                command = (0, command_1.addFlag)(command, 'distribution', distribution);
+            }
+            else if (projectBase === v3_1.PROJECT_WITH_APP) {
+                content.push({
+                    type: 'text',
+                    text: `Ask the user how they would you like to distribute the application? Options are ${constants_1.APP_DISTRIBUTION_TYPES.MARKETPLACE} and ${constants_1.APP_DISTRIBUTION_TYPES.PRIVATE}`,
+                });
+            }
+            if (auth) {
+                command = (0, command_1.addFlag)(command, 'auth', auth);
+            }
+            else if (projectBase === v3_1.PROJECT_WITH_APP) {
+                content.push({
+                    type: 'text',
+                    text: `Ask the user which auth type they would like to use? Options are ${constants_1.APP_AUTH_TYPES.STATIC} and ${constants_1.APP_AUTH_TYPES.OAUTH}`,
+                });
+            }
+            if (content.length > 0) {
+                return {
+                    content,
+                };
+            }
+            if (features && features.length) {
+                command = (0, command_1.addFlag)(command, 'features', features);
+            }
+            try {
+                const { stdout, stderr } = await (0, project_1.runCommandInDir)(absoluteCurrentWorkingDirectory, command);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: stdout,
+                        },
+                        {
+                            type: 'text',
+                            text: stderr,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: error instanceof Error ? error.message : `${error}`,
+                        },
+                    ],
+                };
+            }
+        });
+    }
+}
+exports.CreateProjectTool = CreateProjectTool;

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

@@ -0,0 +1,6 @@
+import { Tool } from '../../types';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class DeployProject extends Tool {
+    private static mcpServer;
+    static register(mcpServer: McpServer): RegisteredTool;
+}