feat: Add CLI Tool for Creating Meteor Extensions (#678)

* feat: add CLI for creating boilerplate extension

* fix: fix pnpm-lock file

* fix: enable corepack to fix CI job issues

* fix: remove yarn from "create-meteor-extension" scripts

* fix: update TS version in create-meteor-extension

* feat: optimize the structure of our example app and add variables

* chore: update ESLint configuration in create-meteor-extension and run formatting

* feat: update create-meteor-extension to enforce 'meteor-app' directory structure for Shopware 6.7+ plugins

* feat(create-meteor-extension): improve cli running and example project

* ci: add CI integration tests for the create-meteot-extension package

* ci: add pull request trigger for create-meteor-extension integration tests

* ci: update pnpm version in create-meteor-extension integration workflow

* ci: modify plugin creation command to include --no-interaction flag in integration workflow

* ci: update plugin creation command in integration workflow to specify plugin namespace

* ci: fix path in plugin creation command for integration workflow

* ci: update path in plugin creation command for integration workflow

* ci: refactor Playwright configuration to use defineConfig for improved clarity

* ci: update integration workflow to create admin user and adjust job numbering

* ci: update integration workflow to change admin user password for tests

* fix: update admin password to meet security requirements in Shopware trunk

- Changed admin password from 'shopware' to 'shopware123!' to meet minimum
  password security requirements introduced in recent Shopware versions
- Added cache:clear after password change to ensure changes are applied
- Added API endpoint verification step to help diagnose any remaining issues
- Updated SHOPWARE_ADMIN_PASSWORD environment variable in test step

This fixes the authentication failures in the integration tests where the
oauth/token endpoint was not returning an access token.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: remove special character from admin password

The exclamation mark in shopware123! was likely causing issues with
bash history expansion or YAML parsing. Changed to shopware12345
which still meets minimum password length requirements.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: use default Shopware admin password instead of changing it

The setup-shopware action creates admin user with password 'shopware' by default.
Removed unnecessary password change step that was causing issues. Using the
default password 'shopware' directly in tests.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor: simplify integration tests by removing acceptance-test-suite

Replace the complex @shopware-ag/acceptance-test-suite with plain Playwright
implementation. This simplifies authentication, reduces dependencies, and makes
the tests more maintainable.

Changes:
- Removed @shopware-ag/acceptance-test-suite dependency
- Created simple login helper (helpers/login.ts)
- Created API-based product creation helper (helpers/createProduct.ts)
- Simplified test fixtures to use plain Playwright
- Rewrote all three integration tests with direct DOM interactions
- Removed unnecessary API verification step from workflow

The new approach uses standard Playwright patterns:
- Direct login via form submission
- API calls for test data creation
- Simple page.goto() for navigation
- Standard locator queries for element verification

This should resolve the persistent authentication failures.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: use type imports for Playwright Page type

The Page type should be imported with 'import type' rather than as a
regular import, since it's a TypeScript type and not a runtime export.

This fixes the error:
SyntaxError: The requested module '@playwright/test' does not provide
an export named 'Page'

Co-authored-by: Cursor <cursoragent@cursor.com>

* feat: add UUID generation function and update product creation logic

* ci: enhance integration workflow with cache clearing and extension verification steps

* feat: make integreation test working for create-meteor-extension cli

* format: run formatter

* fix: update createProduct function signature in integration tests

* docs: update development instructions for create-meteor-extension

* fix: apply code review comments

* feat: introduce a new command `test:nightly` for running tests specifically on template dependencies

* fix: fix pnpm-lock file

* fix: update test:nightly command to do an NPM audit with a real NPM command

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: somethings <l.apple@shopware.com>

Author: 3 people

.github/workflows/create-meteor-extension-integration.yml

@@ -0,0 +1,135 @@
+name: create-meteor-extension Integration Tests
+
+on:
+  pull_request:
+
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  integration-test:
+    name: Test CLI with Shopware trunk
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      # 1. Setup Shopware 6 using shopware/setup-shopware
+      - name: Setup Shopware
+        uses: shopware/setup-shopware@v2
+        with:
+          shopware-version: trunk
+          shopware-repository: shopware/shopware
+          install: true
+          install-locale: en-GB
+          install-currency: EUR
+          install-admin: true
+          env: dev
+          path: shopware/
+
+      # 2. Checkout meteor repo
+      - name: Checkout meteor
+        uses: actions/checkout@v6
+        with:
+          path: meteor/
+
+      # 3. Setup Node.js and pnpm
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.12.3
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '24'
+          cache: 'pnpm'
+          cache-dependency-path: 'meteor/pnpm-lock.yaml'
+
+      # 4. Create plugin structure using Shopware's plugin:create command
+      - name: Create plugin using Shopware CLI
+        working-directory: shopware/
+        run: |
+          bin/console plugin:create TestExtensionPlugin Test --no-interaction
+
+      # 5. Install meteor dependencies and build CLI
+      - name: Install meteor dependencies
+        working-directory: meteor/
+        run: pnpm install --frozen-lockfile
+
+      - name: Build create-meteor-extension CLI
+        working-directory: meteor/
+        run: pnpm turbo run build --filter=@shopware-ag/create-meteor-extension
+
+      # 6. Generate extension using CLI directly into plugin structure
+      - name: Generate meteor extension into plugin
+        working-directory: shopware/custom/plugins/TestExtensionPlugin/src/Resources/app
+        run: |
+          node ../../../../../../../meteor/packages/create-meteor-extension/bin/create-meteor-extension --name test-extension --output-dir meteor-app
+
+      # 7. Install generated extension dependencies
+      - name: Install extension dependencies
+        working-directory: shopware/custom/plugins/TestExtensionPlugin/src/Resources/app/meteor-app
+        run: pnpm install
+
+      # 8. Build extension
+      - name: Build extension
+        working-directory: shopware/custom/plugins/TestExtensionPlugin/src/Resources/app/meteor-app
+        run: pnpm run build
+
+      # 9. Activate plugin in Shopware
+      - name: Activate plugin
+        working-directory: shopware/
+        run: |
+          bin/console plugin:refresh
+          bin/console plugin:install --activate TestExtensionPlugin
+          bin/console cache:clear
+
+      # 10. Build Shopware admin assets
+      - name: Build Shopware admin
+        working-directory: shopware/
+        run: |
+          composer run build:js:admin
+          bin/console cache:clear
+
+      # 11. Verify extension files exist
+      - name: Verify extension build
+        run: |
+          echo "Checking extension files..."
+          ls -la shopware/custom/plugins/TestExtensionPlugin/src/Resources/app/meteor-app/dist/
+          echo "Checking for extension in public..."
+          ls -la shopware/public/bundles/testextensionplugin/
+
+      # 12. Start Shopware web server
+      - name: Start Shopware server
+        working-directory: shopware/
+        run: |
+          symfony server:start --allow-http --no-tls --port=8000 -d
+
+      # 13. Wait for server to be ready
+      - name: Wait for Shopware to be ready
+        run: |
+          timeout 60 bash -c 'until curl -f http://localhost:8000/admin; do sleep 2; done'
+
+      # 14. Install Playwright and run tests
+      - name: Install integration test dependencies
+        working-directory: meteor/packages/create-meteor-extension/tests/integration
+        run: |
+          pnpm install
+          npx playwright install --with-deps chromium
+
+      - name: Run Playwright tests
+        working-directory: meteor/packages/create-meteor-extension/tests/integration
+        env:
+          APP_URL: http://localhost:8000
+          SHOPWARE_ADMIN_USERNAME: admin
+          SHOPWARE_ADMIN_PASSWORD: shopware
+          CI: true
+        run: npx playwright test --reporter=github --trace=on-first-retry
+
+      # 15. Upload test results
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: integration-test-results
+          path: meteor/packages/create-meteor-extension/tests/integration/test-results/
+          retention-days: 7

.github/workflows/create-meteor-extension-nightly.yml

@@ -0,0 +1,29 @@
+name: create-meteor-extension Nightly Checks
+
+on:
+  schedule:
+    - cron: "0 2 * * *" # Every night at 2am UTC
+  workflow_dispatch:
+
+jobs:
+  template-dependency-audit:
+    name: Check template dependencies for outdated major versions
+    runs-on: ubuntu-latest
+    continue-on-error: true
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --prefer-offline
+
+      - name: Run nightly template dependency check
+        run: pnpm --filter @shopware-ag/create-meteor-extension run test:nightly

packages/create-meteor-extension/.gitignore

@@ -0,0 +1,20 @@
+.DS_Store
+node_modules
+npm-debug.log
+coverage
+.nyc_output
+dist
+build
+.vscode
+
+# Generated extension output
+meteor-app/
+
+# Integration test artifacts
+tests/integration/test-results/
+tests/integration/node_modules/
+tests/integration/package-lock.json
+tests/integration/pnpm-lock.yaml
+
+# Test temporary directories
+__tests__/tmp/

packages/create-meteor-extension/LICENSE

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

packages/create-meteor-extension/__tests__/cli-integration.test.ts

@@ -0,0 +1,124 @@
+import { filesystem } from 'gluegun'
+
+const src = filesystem.path(__dirname, '..')
+
+test('outputs version', async () => {
+  const { run } = require(filesystem.path(src, 'src', 'cli'))
+  const toolbox = await run(['--version'])
+
+  expect(toolbox).toBeDefined()
+  expect(run).toBeDefined()
+})
+
+test('outputs help', async () => {
+  const { run } = require(filesystem.path(src, 'src', 'cli'))
+  const toolbox = await run(['--help'])
+
+  expect(toolbox).toBeDefined()
+  expect(run).toBeDefined()
+})
+
+test('validates extension name - rejects uppercase', async () => {
+  // TODO: This test would need proper mocking of the prompt
+  // For now, we're just validating the regex pattern
+  const regex = /^[a-z0-9-]+$/
+  expect(regex.test('TestExtension')).toBe(false)
+  expect(regex.test('test-extension')).toBe(true)
+})
+
+test('validates extension name - rejects spaces', async () => {
+  const regex = /^[a-z0-9-]+$/
+  expect(regex.test('test extension')).toBe(false)
+  expect(regex.test('test-extension')).toBe(true)
+})
+
+test('validates extension name - accepts valid names', async () => {
+  const regex = /^[a-z0-9-]+$/
+  expect(regex.test('my-extension')).toBe(true)
+  expect(regex.test('test123')).toBe(true)
+  expect(regex.test('my-extension-2024')).toBe(true)
+})
+
+test('non-interactive mode - creates extension package.json with correct name', async () => {
+  const { run } = require(filesystem.path(src, 'src', 'cli'))
+  const testName = 'test-extension-' + Date.now() + '-' + Math.random().toString(36).slice(2, 8)
+  const testDir = filesystem.path(src, '__tests__', 'tmp', testName)
+
+  // Ensure test directory doesn't exist
+  if (filesystem.exists(testDir)) {
+    filesystem.remove(testDir)
+  }
+
+  // Create temp directory and run CLI in non-interactive mode
+  filesystem.dir(testDir)
+
+  // Change to test directory
+  const originalCwd = process.cwd()
+  process.chdir(testDir)
+
+  try {
+    const toolbox = await run(['--name', testName])
+
+    // Check that meteor-app directory was created
+    const meteorAppDir = filesystem.path(testDir, 'meteor-app')
+    expect(filesystem.exists(meteorAppDir)).toBe(true)
+
+    // Check that package.json was created with correct name
+    const packageJson = filesystem.read(
+      filesystem.path(meteorAppDir, 'package.json'),
+      'json',
+    )
+    expect(packageJson.name).toBe(testName)
+  } finally {
+    // Clean up
+    process.chdir(originalCwd)
+    if (filesystem.exists(testDir)) {
+      filesystem.remove(testDir)
+    }
+  }
+})
+
+test('non-interactive mode - creates extension with custom --output-dir', async () => {
+  const { run } = require(filesystem.path(src, 'src', 'cli'))
+  const testName = 'custom-output-' + Date.now() + '-' + Math.random().toString(36).slice(2, 8)
+  const testDir = filesystem.path(src, '__tests__', 'tmp', testName)
+  const customOutputDir = 'my-custom-app'
+
+  // Ensure test directory doesn't exist
+  if (filesystem.exists(testDir)) {
+    filesystem.remove(testDir)
+  }
+
+  // Create temp directory and run CLI in non-interactive mode
+  filesystem.dir(testDir)
+
+  // Change to test directory
+  const originalCwd = process.cwd()
+  process.chdir(testDir)
+
+  try {
+    const toolbox = await run([
+      '--name',
+      testName,
+      '--output-dir',
+      customOutputDir,
+    ])
+
+    // Check that custom output directory was created
+    const customDir = filesystem.path(testDir, customOutputDir)
+    expect(filesystem.exists(customDir)).toBe(true)
+
+    // Check that package.json was created with correct name
+    const packageJson = filesystem.read(
+      filesystem.path(customDir, 'package.json'),
+      'json',
+    )
+    expect(packageJson.name).toBe(testName)
+  } finally {
+    // Clean up
+    process.chdir(originalCwd)
+    if (filesystem.exists(testDir)) {
+      filesystem.remove(testDir)
+    }
+  }
+})