@salesforce/pwa-kit-mcp 0.1.0-preview.0

package/dist/utils/pwa-create-app-guideline-tool.js

@@ -0,0 +1,99 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _utils = require("./utils");
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */ // Project dependencies
+const CREATE_APP_COMMAND = (0, _utils.getCreateAppCommand)();
+const DISPLAY_PROGRAM_FLAG = '--displayProgram';
+const COMMAND_RUNNER = (0, _utils.isMonoRepo)() ? 'node' : 'npx';
+const guidelinesText = `
+# PWA Kit Create App — Agent Usage Guidelines
+
+## Overview
+
+This document defines the behavior agents must follow when using the \`@salesforce/pwa-kit-create-app\` CLI tool to generate new PWA Kit projects. The CLI supports both **presets** and **templates** for project creation, and agents must clearly distinguish between these two modes of operation.
+
+---
+
+## General Rules
+
+- Always use this tool to initiate project creation. Never attempt to manually create a project outside of this process.
+- Ask one question at a time when gathering information from the user.
+- Do not mix presets and templates. Only show or ask about one based on the user's intent.
+- Never proceed with project generation unless all required information has been collected.
+
+---
+
+## Creating a Project Using a Preset
+
+If the user requests a project using a **preset**:
+
+- List only the available presets.
+- If a preset is provided, use the \`--preset\` flag with the CLI.
+- Do not ask for or display any template options.
+
+---
+
+## Creating a Project Using a Template
+
+If the user requests a project using a **template**:
+
+- List only the available templates.
+- If a template is provided:
+  - Use its associated questions to prompt the user, one at a time.
+  - Do not proceed with project generation until all required answers have been collected.
+- Do not ask for or display any preset options.
+
+---
+
+## Important Reminders
+
+- Never attempt to create a project without using this tool.
+- When gathering answers for a template, ask questions one at a time to maintain clarity.
+- Presets and templates are mutually exclusive paths. Do not offer both options unless explicitly requested.
+- Do not pass any flags to the \`${CREATE_APP_COMMAND}\` CLI tool that are not listed in the program.json options".
+- Use the \`${COMMAND_RUNNER}\` command to run the \`${CREATE_APP_COMMAND}\` CLI tool when creating a new project.
+`;
+var _default = exports.default = {
+  name: 'create_app_guidelines',
+  description: `This tool is used to provide the agent with the instructions on how to use the @salesforce/pwa-kit-create-app CLI tool to create a new PWA Kit projects. Do not attempt to create a project without using this tool first.`,
+  inputSchema: _utils.EmptyJsonSchema,
+  fn: function () {
+    var _ref = _asyncToGenerator(function* () {
+      // Run the display program and get the output.
+      const programOutput = yield (0, _utils.runCommand)(COMMAND_RUNNER, [...(COMMAND_RUNNER === 'npx' ? ['--yes'] : []), CREATE_APP_COMMAND, DISPLAY_PROGRAM_FLAG]);
+
+      // Parse the output and get the data, metadata, and schemas.
+      const {
+        data,
+        metadata: {
+          description: cli
+        },
+        schemas
+      } = JSON.parse(programOutput);
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({
+            guidelines: guidelinesText,
+            cli,
+            schemas,
+            data
+          }, null, 2)
+        }]
+      };
+    });
+    return function fn() {
+      return _ref.apply(this, arguments);
+    };
+  }()
+};

package/dist/utils/pwa-developer-guideline-tool.js

@@ -0,0 +1,131 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _utils = require("./utils");
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const guidelinesText = `# Salesforce Commerce Composable Storefront Development Guidelines
+
+## Overview
+This document offers guidelines in the development of Salesforce Commerce Composable Storefront applications using PWA Kit. The AI should possess a comprehensive understanding of the PWA Kit architecture, sample Retail React App, Chakra UI, and standard React application practices.
+
+## Core Principles
+
+### Project Understanding
+- Thoroughly analyze requests and the existing project for successful implementation.
+- Promptly clarify ambiguous requirements.
+
+### Development Workflow
+- **Analyze Requirements** - Clearly define the objectives and functionalities required.
+- **Review Existing Code** - Examine the current codebase to identify similar solutions and potentially reusable components.
+- **Understand Existing Hooks and Utilities** - Familiarize with hooks and utility functions available within the project, including those from commerce-sdk-react and template-retail-react-app modules.
+- **Plan Implementation** - Design component structure before coding.
+- **Implement Incrementally** - Develop and test the service in small, manageable steps.
+- **Test Thoroughly** - Ensure comprehensive testing, including the use of Jest.
+
+## Technical Stack
+
+### Core Technologies
+- **React** - UI components and SPA architecture
+- **Express** - Server-side rendering and backend
+- **@salesforce/commerce-sdk-react** - Commerce Cloud API integration (hooks)
+- **PWA Kit** - SSR, routing, config, Salesforce integration
+- **Chakra UI V2** - UI components and theming
+- **Emotion** - CSS-in-JS styling
+- **React Router** - Routing
+- **React Intl** - Localization
+- **React Query** - Data fetching/caching
+- **Webpack** - Bundling
+- **React Testing Library, Jest** - Testing libraries
+- **react-helmet, framer-motion, etc.** - Utilities, animation, head management
+- **ESLint/Prettier** - Code formatting and linting
+
+## PWK Kit Architecture
+
+### Configuration Files
+- PWA Kit apps are customized using configuration files for API access, URL formatting, and server-side rendering.
+- These files support JavaScript, YAML, and JSON formats, with default.js being the standard.
+- Configuration values are serialized for isomorphic rendering, so secrets must not be included.
+- Environment-specific configuration files can replace or complement default.js.
+- File precedence is .js > .yml > .yaml > .json if base names are the same.
+
+### Proxy Requests
+- Managed Runtime's proxy feature routes API requests through the storefront domain to avoid CORS issues and improve performance.
+- Local proxy configurations are set in config/default.js, while Managed Runtime deployments use Runtime Admin or the Managed Runtime API.
+- Requests use the /mobify/proxy/<PROXY_PATH> pattern.
+- Proxied requests and responses are modified for transparent operation.
+- Proxied requests are uncached by default but can be cached using a caching path prefix.
+
+### Rendering
+- PWA Kit uses server-side rendering (SSR) for fast initial page loads, leveraging CDN caching.
+- After the first load, client-side rendering (CSR) takes over for fluid user interactions.
+- Application code must be isomorphic, functioning in both server and client environments, often with conditional logic.
+- Props from API requests are serialized into the page source during SSR for client-side hydration.
+- A correlation ID is provided on each page for tracking requests across PWA Kit and other systems.
+
+### Routing
+- PWA Kit uses Express.js and React Router for handling requests and rendering components.
+- Routes are defined in app/routes.jsx as an array of objects with 'path' and 'component' properties.
+- You can use both withReactQuery and withLegacyGetProps at the same time.
+- getProps and shouldGetProps were removed from the default template of pages of the Retail React App, but aren't deprecated. Long-term support for these methods remains.
+
+### PWA Kit Special Components
+- Customize your storefront by overriding default special components that start with an underscore (_), such as app/components/_app-config/index.jsx.
+- app/components/_app-config: The top-level component for app-wide configurations like theme providers and state management.
+- app/components/_app: The child of _app-config. Use it for layout and UI that persist throughout your React app, such as the header, footer, and sidebar.
+- app/components/_error: Renders when a page or its data isn't found, or when an error occurs, returning a 404 status.
+
+### State Management
+- PWA Kit applications support various state management approaches, including simple prop-passing or React's Context API.
+- The React Context API can be used with useReducer and useContext for shared global state.
+- The AppConfig special component is the primary place to initialize a state management system.
+- When integrating libraries like Redux, AppConfig methods such as restore, freeze, extraGetPropsArgs, and render are utilized.
+
+### PWA Kit Extensibility
+- In PWA Kit v3, you can extend a base template (@salesforce/retail-react-app) by replacing specific files using a local "overrides directory."
+- Extensibility is configured in package.json with the base template (ccExtensibility.extends) and your overrides directory (ccExtensibility.overridesDir).
+- To override a file, recreate its exact path and filename in your overrides directory.
+
+### PWA Kit Storefront Development
+- Start development with Retail React App sample codebase and tooling.
+- Use included npm scripts for automating development tasks like build, test, and lint.
+- Access Shopper data through the commerce-sdk-react hooks to fetch, cache, and mutate utilizing Salesforce Commerce API (SLAS) and OCAPI.
+- Use Chakra UI and existing components when available.
+- Create simple, functional, modular, reusable components.
+- Use the React Helmet library to modify the HTML tags in Document, such as <head>.
+- Use kebab-case for file names. Only start with an underscore (_) if they are special components.
+- Use React Hooks (e.g., useState, useEffect, useContext, useMemo, useCallback) for state management and side effects. 
+
+## Quality Standards
+- Maintain consistent code formatting using project standards.
+- Write comprehensive test coverage.
+- Ensure components are accessible and mobile-friendly.
+- Follow security best practices for all code.
+`;
+var _default = exports.default = {
+  name: 'development_guidelines',
+  description: `You must follow this development guidelines before attempting to analyze/ generate / refactor / modify / fix code.
+    - e.g. "Create a customer service Chat component", "Find bugs in my_script.jsx", "Refactor my_script.jsx to use React Hooks"`,
+  inputSchema: _utils.EmptyJsonSchema,
+  fn: function () {
+    var _ref = _asyncToGenerator(function* () {
+      return {
+        content: [{
+          type: 'text',
+          text: guidelinesText
+        }]
+      };
+    });
+    return function fn() {
+      return _ref.apply(this, arguments);
+    };
+  }()
+};

package/dist/utils/run-site-test-accessibility.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.runAccessibilityTest = runAccessibilityTest;
+var _playwright = require("playwright");
+var _playwright2 = _interopRequireDefault(require("@axe-core/playwright"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+function runAccessibilityTest(_x) {
+  return _runAccessibilityTest.apply(this, arguments);
+}
+function _runAccessibilityTest() {
+  _runAccessibilityTest = _asyncToGenerator(function* (siteUrl) {
+    const browser = yield _playwright.chromium.launch();
+    const context = yield browser.newContext();
+    const page = yield context.newPage();
+    yield page.goto(siteUrl);
+    const results = yield new _playwright2.default({
+      page
+    }).analyze();
+    yield browser.close();
+    return results;
+  });
+  return _runAccessibilityTest.apply(this, arguments);
+}

package/dist/utils/run-site-test-performance.js

@@ -0,0 +1,107 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.runAccessibilityTest = runAccessibilityTest;
+exports.runPerformanceTest = runPerformanceTest;
+var _playwright = require("playwright");
+var _playwright2 = _interopRequireDefault(require("@axe-core/playwright"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+function runAccessibilityTest(_x) {
+  return _runAccessibilityTest.apply(this, arguments);
+}
+function _runAccessibilityTest() {
+  _runAccessibilityTest = _asyncToGenerator(function* (siteUrl) {
+    const browser = yield _playwright.chromium.launch();
+    const context = yield browser.newContext();
+    const page = yield context.newPage();
+    yield page.goto(siteUrl);
+    const results = yield new _playwright2.default({
+      page
+    }).analyze();
+    yield browser.close();
+    return results;
+  });
+  return _runAccessibilityTest.apply(this, arguments);
+}
+function runPerformanceTest(_x2) {
+  return _runPerformanceTest.apply(this, arguments);
+}
+function _runPerformanceTest() {
+  _runPerformanceTest = _asyncToGenerator(function* (siteUrl) {
+    const browser = yield _playwright.chromium.launch();
+    const page = yield browser.newPage();
+    yield page.goto(siteUrl);
+
+    // Wait for page to fully load
+    yield page.waitForLoadState('load');
+
+    // Extract detailed navigation timing data from the browser
+    const navigationEntries = yield page.evaluate(() => {
+      const nav = performance.getEntriesByType('navigation')[0];
+      if (!nav) return null;
+      return {
+        type: nav.type,
+        startTime: nav.startTime,
+        unloadEventStart: nav.unloadEventStart,
+        unloadEventEnd: nav.unloadEventEnd,
+        redirectStart: nav.redirectStart,
+        redirectEnd: nav.redirectEnd,
+        fetchStart: nav.fetchStart,
+        domainLookupStart: nav.domainLookupStart,
+        domainLookupEnd: nav.domainLookupEnd,
+        connectStart: nav.connectStart,
+        connectEnd: nav.connectEnd,
+        secureConnectionStart: nav.secureConnectionStart,
+        requestStart: nav.requestStart,
+        responseStart: nav.responseStart,
+        responseEnd: nav.responseEnd,
+        domLoading: nav.domLoading,
+        domInteractive: nav.domInteractive,
+        domContentLoadedEventStart: nav.domContentLoadedEventStart,
+        domContentLoadedEventEnd: nav.domContentLoadedEventEnd,
+        domComplete: nav.domComplete,
+        loadEventStart: nav.loadEventStart,
+        loadEventEnd: nav.loadEventEnd,
+        duration: nav.duration
+      };
+    });
+
+    // Fallback for browsers that don't support Navigation Timing Level 2
+    const perfTiming = navigationEntries || (yield page.evaluate(() => JSON.parse(JSON.stringify(window.performance.timing))));
+
+    // Calculate key metrics
+    const metrics = _objectSpread({
+      totalLoadTime: perfTiming.loadEventEnd - perfTiming.startTime,
+      domContentLoadedTime: perfTiming.domContentLoadedEventEnd - perfTiming.startTime,
+      timeToFirstByte: perfTiming.responseStart - perfTiming.startTime,
+      domInteractive: perfTiming.domInteractive - perfTiming.startTime,
+      firstPaint: perfTiming.responseEnd - perfTiming.startTime
+    }, perfTiming);
+    yield browser.close();
+    return {
+      content: [{
+        type: 'text',
+        text: `Total Load Time: ${metrics.totalLoadTime}ms, \
+        DOM Content Loaded: ${metrics.domContentLoadedTime}ms, \
+        Time to First Byte: ${metrics.timeToFirstByte}ms, 
+        DOM Interactive: ${metrics.domInteractive}ms, \
+        First Paint: ${metrics.firstPaint}ms`
+      }]
+    };
+  });
+  return _runPerformanceTest.apply(this, arguments);
+}

package/dist/utils/run-site-test-tool.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TestWithPlaywrightTool = void 0;
+var _runSiteTestPerformance = require("./run-site-test-performance");
+var _runSiteTestAccessibility = require("./run-site-test-accessibility");
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const DEFAULT_SITE_URL = 'https://pwa-kit.mobify-storefront.com';
+class TestWithPlaywrightTool {
+  /**
+   * Runs a Playwright test file by name (e.g., 'performance' or 'accessibility')
+   * @param {string} testType - 'performance' or 'accessibility'
+   * @param {string} [siteUrl] - Optional site URL to test
+   * @returns {object} - Result of the test run
+   */
+  run(testType, siteUrl = DEFAULT_SITE_URL) {
+    return _asyncToGenerator(function* () {
+      switch (testType) {
+        case 'performance':
+          {
+            return (0, _runSiteTestPerformance.runPerformanceTest)(siteUrl);
+          }
+        case 'accessibility':
+          {
+            return (0, _runSiteTestAccessibility.runAccessibilityTest)(siteUrl);
+          }
+        default:
+          {
+            const result = {
+              error: 'unsupported test type'
+            };
+            console.log('Unsupported test type result:', result);
+            return result;
+          }
+      }
+    })();
+  }
+}
+exports.TestWithPlaywrightTool = TestWithPlaywrightTool;

package/dist/utils/utils.js

@@ -0,0 +1,115 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getCreateAppCommand = exports.EmptyJsonSchema = void 0;
+exports.isMonoRepo = isMonoRepo;
+exports.runCommand = void 0;
+exports.toKebabCase = toKebabCase;
+exports.toPascalCase = void 0;
+var _fs = _interopRequireDefault(require("fs"));
+var _path = _interopRequireDefault(require("path"));
+var _crossSpawn = require("cross-spawn");
+var _zodToJsonSchema = require("zod-to-json-schema");
+var _zod = require("zod");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+// CONSTANTS
+// const CREATE_APP_VERSION = 'latest'
+const CREATE_APP_VERSION = '3.11.0-nightly-20250710080214';
+
+// Private schema used to generate the JSON schema
+const emptySchema = _zod.z.object({}).strict();
+const EmptyJsonSchema = exports.EmptyJsonSchema = (0, _zodToJsonSchema.zodToJsonSchema)(emptySchema);
+
+/**
+ * Converts a string to kebab-case (e.g., ProductCard -> product-card)
+ */
+function toKebabCase(str) {
+  return str.replace(/([a-z])([A-Z])/g, '$1-$2').replace(/\s+/g, '-').toLowerCase();
+}
+
+/**
+ * Converts a string to PascalCase (e.g., product-card -> ProductCard)
+ */
+const toPascalCase = str => str.replace(/(^\w|[-_\s]\w)/g, match => match.replace(/[-_\s]/, '').toUpperCase());
+
+/**
+ * Runs a shell command and captures its stdout/stderr as a string.
+ *
+ * @param {string} command - The executable to run (e.g. "node", "npx", "ls").
+ * @param {string[]} args - Arguments to pass to the command.
+ * @param {Object} [options] - Optional spawn options (e.g. cwd).
+ * @returns {Promise<string>} - Resolves with combined stdout and stderr.
+ */
+exports.toPascalCase = toPascalCase;
+const runCommand = exports.runCommand = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator(function* (command, args = [], options = {}) {
+    return new Promise((resolve, reject) => {
+      const child = (0, _crossSpawn.spawn)(command, args, _objectSpread(_objectSpread({}, options), {}, {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        // ignore stdin, pipe out/err
+        shell: false // be explicit — set to true if you want shell features
+      }));
+      let output = '';
+      child.stdout.on('data', chunk => {
+        output += chunk.toString();
+      });
+      child.stderr.on('data', chunk => {
+        output += chunk.toString(); // combine stderr into output
+      });
+      child.on('error', err => {
+        reject(err);
+      });
+      child.on('close', code => {
+        if (code === 0) {
+          resolve(output);
+        } else {
+          const error = new Error(`Command failed with exit code ${code}`);
+          error.output = output;
+          error.code = code;
+          reject(error);
+        }
+      });
+    });
+  });
+  return function runCommand(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();
+
+/**
+ * Checks if the project is a monorepo by verifying the existence of lerna.json in the root directory.
+ *
+ * @returns {boolean} True if lerna.json exists in the current workspace, false otherwise.
+ */
+function isMonoRepo() {
+  const lernaPath = _path.default.resolve(...(process.env.WORKSPACE_FOLDER_PATHS ? [process.env.WORKSPACE_FOLDER_PATHS] : []), 'lerna.json');
+  return _fs.default.existsSync(lernaPath);
+}
+
+/**
+ * Returns the command or path to use for creating a new PWA Kit app.
+ *
+ * If the project is a monorepo (detected by the presence of lerna.json),
+ * it returns the absolute path to the local create-mobify-app.js script.
+ * Otherwise, it returns the npm package name with a specific version.
+ *
+ * @returns {string} The command or path to use for app creation.
+ */
+const getCreateAppCommand = () => {
+  return isMonoRepo() ? _path.default.resolve(`${process.env.WORKSPACE_FOLDER_PATHS}/packages/pwa-kit-create-app/scripts/create-mobify-app.js`) : `@salesforce/pwa-kit-create-app@${CREATE_APP_VERSION}`;
+};
+exports.getCreateAppCommand = getCreateAppCommand;

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@salesforce/pwa-kit-mcp",
+  "version": "0.1.0-preview.0",
+  "private": false,
+  "description": "MCP server that helps you build Salesforce Commerce Cloud PWA Kit Composable Storefront",
+  "main": "dist/server/server.js",
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE",
+    "dist/**/*.{js,d.ts,json}",
+    "!dist/CHANGELOG.md",
+    "!dist/README.md",
+    "!**/*.test.{ts,js}"
+  ],
+  "scripts": {
+    "build": "cross-env NODE_ENV=production internal-lib-build build",
+    "build:watch": "nodemon --watch 'src/**' --ext 'js,ts' --exec  'npm run build'",
+    "format": "pwa-kit-dev format \"**/*.{js,jsx}\"",
+    "lint": "npm run lint:js",
+    "lint:fix": "npm run lint:js -- --fix",
+    "lint:js": "pwa-kit-dev lint \"**/*.{js,ts}\"",
+    "prepare": "npm run build",
+    "test": "internal-lib-build test",
+    "test:inspect": "node --inspect-brk jest --runInBand",
+    "test:watch": "npm test -- --watch",
+    "start": "node dist/server/server.js"
+  },
+  "keywords": [
+    "mcp",
+    "server",
+    "pwa",
+    "salesforce",
+    "commerce",
+    "commerce cloud",
+    "pwa kit",
+    "composable storefront"
+  ],
+  "author": "Spark Team",
+  "bin": {
+    "pwa-kit-mcp": "dist/server/server.js"
+  },
+  "license": "ISC",
+  "dependencies": {
+    "@axe-core/playwright": "^4.10.1",
+    "@babel/runtime": "^7.21.0",
+    "@modelcontextprotocol/sdk": "^1.13.2",
+    "axe-core": "^4.10.3",
+    "cross-spawn": "^7.0.6",
+    "playwright": "^1.49.0",
+    "zod": "^3.25.56"
+  },
+  "devDependencies": {
+    "@babel/node": "^7.22.5",
+    "@playwright/test": "^1.49.0",
+    "@salesforce/pwa-kit-dev": "3.11.0-dev.0",
+    "cross-env": "^5.2.1",
+    "internal-lib-build": "3.11.0-dev.0",
+    "nodemon": "^2.0.22"
+  },
+  "engines": {
+    "node": "^16.11.0 || ^18.0.0 || ^20.0.0 || ^22.0.0",
+    "npm": "^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0"
+  },
+  "publishConfig": {
+    "directory": "dist"
+  }
+}