@asyncapi/generator 3.2.0 → 3.2.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @asyncapi/generator
 
+## 3.2.1
+
+### Patch Changes
+
+- 643f194: Fix browserslist error when using pnpm
+
+  Set BROWSERSLIST_ROOT_PATH environment variable during template compilation
+  to prevent browserslist from searching outside the template directory. This
+  fixes an issue where pnpm's shim files were incorrectly parsed as browserslist
+  configuration, causing "Unknown browser query" errors.
+
+  Fixes: https://github.com/asyncapi/cli/issues/1781
+
 ## 3.2.0
 
 ### Minor Changes

package/docs/api_components.md

@@ -97,6 +97,10 @@ weight: 77
   
   Renders WebSocket send operation methods. Generates both static and instance methods for sending messages through WebSocket connections.
 
+* [createError](#createError) ⇒ `Error`<br/>
+  
+  Creates an error with a specific error code for programmatic handling
+
 
 <a name="CloseConnection"></a>
 ### CloseConnection()
@@ -366,13 +370,13 @@ Renders a language-specific formatted method definition.
 |------|------|-------------|
 | props | `Object` | Component props. |
 | props.language | `Language` | Programming language used for method formatting. |
-| props.methodName | `string` | Name of the method. |
+| props.methodName | `string` | Name of the method (non-empty string required). |
 | props.methodParams | `Array.<string>` | Method parameters. |
 | props.methodDocs | `string` | Optional documentation string. |
 | props.methodLogic | `string` | Core method logic. |
 | props.preExecutionCode | `string` | Code before main logic. |
 | props.postExecutionCode | `string` | Code after main logic. |
-| props.indent | `number` | Indentation for the method block. |
+| props.indent | `number` | Indentation for the method block (must be &gt;&#x3D; 0). |
 | props.newLines | `number` | Number of new lines after method. |
 | props.customMethodConfig | `Object` | Optional custom syntax configuration for the current language. |
 | props.methodConfig | `Object` | Language-level or framework-level configuration. |
@@ -1231,3 +1235,24 @@ renderSendOperations().catch(console.error);
 ```
 
 
+
+<a name="createError"></a>
+### createError()
+Creates an error with a specific error code for programmatic handling
+
+
+**Parameters**
+
+| Name | Type | Description |
+|------|------|-------------|
+| code | `string` | The error code (from ERROR_CODES) |
+| message | `string` | The error message |
+
+
+
+**Returns**
+
+- `Error` - An error object with an attached code property
+
+
+

package/lib/generator.js

@@ -401,7 +401,22 @@ class Generator {
    */
   async configureTemplate() {
     if (this.compile) {
-      await configureReact(this.templateDir, this.templateContentDir, TRANSPILED_TEMPLATE_LOCATION);
+      // Set BROWSERSLIST_ROOT_PATH to prevent browserslist from searching
+      // outside the template directory. This fixes issues with pnpm where
+      // browserslist would incorrectly parse pnpm shim files as config.
+      // See: https://github.com/asyncapi/cli/issues/1781
+      const previousRootPath = process.env.BROWSERSLIST_ROOT_PATH;
+      process.env.BROWSERSLIST_ROOT_PATH = this.templateDir;
+      try {
+        await configureReact(this.templateDir, this.templateContentDir, TRANSPILED_TEMPLATE_LOCATION);
+      } finally {
+        // Restore previous value if it existed
+        if (previousRootPath === undefined) {
+          delete process.env.BROWSERSLIST_ROOT_PATH;
+        } else {
+          process.env.BROWSERSLIST_ROOT_PATH = previousRootPath;
+        }
+      }
     }
   }
 

package/lib/templates/bakedInTemplates/core-template-client-websocket-dart/package.json

@@ -5,6 +5,8 @@
   "scripts": {
     "test": "jest --coverage --passWithNoTests",
     "test:update": "npm run test -- -u",
+    "test:integration": "npm --prefix ../test/integration-test run test:dart",
+    "test:integration:update": "npm --prefix ../test/integration-test run test:dart:update",
     "lint": "eslint --max-warnings 0 --config ../../../../../.eslintrc --ignore-path ../../../../../.eslintignore .",
     "lint:fix": "eslint --fix --max-warnings 0 --config ../../../../../.eslintrc --ignore-path ../../../../../.eslintignore ."
   },
@@ -13,7 +15,7 @@
   "dependencies": {
     "@asyncapi/generator-react-sdk": "*",
     "@asyncapi/generator-helpers": "1.1.0",
-    "@asyncapi/generator-components": "0.5.0"
+    "@asyncapi/generator-components": "0.6.0"
   },
   "devDependencies": {
     "@asyncapi/parser": "^3.4.0",

package/lib/templates/bakedInTemplates/core-template-client-websocket-java-quarkus/package.json

@@ -14,12 +14,14 @@
   "scripts": {
     "test": "jest  --coverage",
     "test:update": "npm run test -- -u",
+    "test:integration": "npm --prefix ../../test/integration-test run test:java-quarkus",
+    "test:integration:update": "npm --prefix ../../test/integration-test run test:java-quarkus:update",
     "lint": "eslint --max-warnings 0 --config ../../../../../../.eslintrc --ignore-path ../../../../../../.eslintignore .",
     "lint:fix": "eslint --fix --max-warnings 0 --config ../../../../../../.eslintrc --ignore-path ../../../../../../.eslintignore ."
   },
   "dependencies": {
     "@asyncapi/generator-helpers": "1.1.0",
-    "@asyncapi/generator-components": "0.5.0",
+    "@asyncapi/generator-components": "0.6.0",
     "@asyncapi/generator-react-sdk": "^1.1.2"
   },
   "devDependencies": {

package/lib/templates/bakedInTemplates/core-template-client-websocket-javascript/package.json

@@ -5,13 +5,15 @@
   "scripts": {
     "test": "jest --coverage --passWithNoTests",
     "test:update": "npm run test -- -u",
+    "test:integration": "npm --prefix ../test/integration-test run test:javascript",
+    "test:integration:update": "npm --prefix ../test/integration-test run test:javascript:update",
     "lint": "eslint --max-warnings 0 --config ../../../../../.eslintrc --ignore-path ../../../../../.eslintignore .",
     "lint:fix": "eslint --fix --max-warnings 0 --config ../../../../../.eslintrc --ignore-path ../../../../../.eslintignore ."
   },
   "author": "Lukasz Gornicki <lpgornicki@gmail.com>",
   "license": "Apache-2.0",
   "dependencies": {
-    "@asyncapi/generator-components": "0.5.0",
+    "@asyncapi/generator-components": "0.6.0",
     "@asyncapi/generator-helpers": "1.1.0",
     "@asyncapi/generator-react-sdk": "*",
     "@asyncapi/keeper": "0.5.0",

package/lib/templates/bakedInTemplates/core-template-client-websocket-python/package.json

@@ -5,6 +5,8 @@
   "scripts": {
     "test": "jest --coverage",
     "test:update": "npm run test -- -u",
+    "test:integration": "npm --prefix ../test/integration-test run test:python",
+    "test:integration:update": "npm --prefix ../test/integration-test run test:python:update",
     "lint": "eslint --max-warnings 0 --config ../../../../../.eslintrc --ignore-path ../../../../../.eslintignore .",
     "lint:fix": "eslint --fix --max-warnings 0 --config ../../../../../.eslintrc --ignore-path ../../../../../.eslintignore ."
   },
@@ -13,7 +15,7 @@
   "dependencies": {
     "@asyncapi/generator-react-sdk": "*",
     "@asyncapi/generator-helpers": "1.1.0",
-    "@asyncapi/generator-components": "0.5.0"
+    "@asyncapi/generator-components": "0.6.0"
   },
   "devDependencies": {
     "@asyncapi/parser": "^3.4.0",

package/lib/templates/bakedInTemplates.js

@@ -37,15 +37,21 @@ module.exports.isCoreTemplate = (templateName) => {
 /**
  * Retrieve a template by name and validate its path.
  * If the path does not exist, fallback to `node_modules/{templateName}`.
+ * Returns undefined when templateName is invalid (null, undefined, not a string, or empty/whitespace-only) or when no baked-in template exists with the given name.
  *
  * @async
  * @param {string} templateName - The name of the template to retrieve.
- * @returns {Promise<{name: string, path: string}|undefined>} An object containing the template's name and path, or undefined if not found.
+ * @returns {Promise<{name: string, path: string}|undefined>} An object containing the template's name and path, or undefined if templateName is invalid or template is not on the list.
  */
 module.exports.getTemplate = async (templateName) => {
+  if (templateName == null || typeof templateName !== 'string' || templateName.trim() === '') {
+    return undefined;
+  }
   const template = templates.find(t => t.name === templateName);
-
-  const templatePath = template?.path || path.resolve(__dirname, BAKED_IN_TEMPLATES_DIR, template.name);
+  if (!template) {
+    return undefined;
+  }
+  const templatePath = template.path || path.resolve(__dirname, BAKED_IN_TEMPLATES_DIR, template.name);
   return {
     name: template.name,
     path: templatePath

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asyncapi/generator",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "The AsyncAPI generator. It can generate documentation, code, anything!",
   "main": "./lib/generator.js",
   "engines": {