@asyncapi/generator 3.1.2 → 3.2.1

package/docs/generator-template.md

@@ -9,7 +9,7 @@ Suppose you can only sleep when the AC in your bedroom is set to 22 °C, and you
 
 In this tutorial:
 
-- You'll use the [Eclipse Mosquito](https://test.mosquitto.org) **MQTT broker**, which you'll connect to subscribe and publish messages using an MQTT client.
+- You'll use the [Eclipse Mosquitto](https://test.mosquitto.org) **MQTT broker**, which you'll connect to subscribe and publish messages using an MQTT client.
 - You'll use [Python Paho-MQTT](https://pypi.org/project/paho-mqtt/) as the **MQTT client** in this project.
 - You'll create a React template that will use the MQTT broker to allow you to monitor your bedroom's temperature and notify you when the temperature drops or rises above 22 °C.
 - Lastly, create a reusable component for the output code's `sendTemperatureDrop` and `sendTemperatureRise` functions.
@@ -44,7 +44,7 @@ Before you create the template, you'll need to have an [AsyncAPI document](https
 
 ``` yml
 
-asyncapi: 2.6.0
+asyncapi: 3.0.1
 
 info:
   title: Temperature Service
@@ -53,22 +53,26 @@ info:
 
 servers:
   dev:
-    url: test.mosquitto.org #in case you're using local mosquitto instance, change this value to localhost.
+    host: test.mosquitto.org #in case you're using local mosquitto instance, change this value to localhost.
     protocol: mqtt
 
 channels:
-  temperature/changed:
-    description: Updates the bedroom temperature in the database when the temperatures drops or goes up.
-    publish:
-      operationId: temperatureChange
-      message:
+  temperatureChanged:
+    address: temperature/changed
+    messages:
+      temperatureChange:
         description: Message that is being sent when the temperature in the bedroom changes.
         payload:
-          type: object
-          additionalProperties: false
-          properties:
-            temperatureId:
-              type: string
+          $ref: '#/components/schemas/temperatureId'
+    description: Updates the bedroom temperature in the database when the temperatures drops or goes up.
+
+operations:
+  temperatureChange:
+    action: receive
+    summary: Message sent to the broker when the temperature is changed.
+    channel:
+      $ref: '#/channels/temperatureChanged'
+
 components:
   schemas:
     temperatureId:
@@ -112,8 +116,8 @@ The **package.json** file is used to define the dependencies for your template.
   "version": "0.0.1",
   "description": "A template that generates a Python MQTT client using MQTT.",
   "generator": {
-    "apiVersion": "v1",
-    "generator": ">=1.10.0 <2.0.0",
+    "apiVersion": "v3",
+    "generator": ">=2.0.0 <4.0.0",
     "supportedProtocols": ["mqtt"]
   },
   "dependencies": {
@@ -326,8 +330,8 @@ In **package.json** you can have the scripts property that you invoke by calling
         "test": "npm run test:clean && npm run test:generate && npm run test:start"
       },
       "generator": {
-        "apiVersion": "v1",
-        "generator": ">=1.10.0 <2.0.0",
+        "apiVersion": "v3",
+        "generator": ">=2.0.0 <4.0.0",
         "supportedProtocols": ["mqtt"]
       },
       "dependencies": {
@@ -357,7 +361,7 @@ You often have different runtime environments in programming, e.g., development
 ```yml
 servers:
   dev:
-    url: test.mosquitto.org
+    host: test.mosquitto.org
     protocol: mqtt
 ```
 
@@ -391,7 +395,7 @@ Update your `test:generate` script in **package.json** to include the server par
 "test:generate": "asyncapi generate fromTemplate test/fixtures/asyncapi.yml ./ --output test/project --force-write --param server=dev"
 ```
 
-You can now replace the static broker from `mqttBroker = 'test.mosquitto.org'` to `mqttBroker = "${asyncapi.servers().get(params.server).url()}"` in **index.js**.
+You can now replace the static broker from `mqttBroker = 'test.mosquitto.org'` to `mqttBroker = "${asyncapi.servers().get(params.server).host()}"` in **index.js**.
 
 Now the template code looks like this:
 
@@ -405,7 +409,7 @@ export default function ({ asyncapi, params }) {
     <File name="client.py">
       {`import paho.mqtt.client as mqtt
 
-mqttBroker = "${asyncapi.servers().get(params.server).url()}"
+mqttBroker = "${asyncapi.servers().get(params.server).host()}"
 
 class TemperatureServiceClient:
     def __init__(self):
@@ -436,7 +440,7 @@ export default function ({ asyncapi, params }) {
     // 2
       <Text newLines={2}>import paho.mqtt.client as mqtt</Text>
     // 3
-      <Text newLines={2}>mqttBroker = "{asyncapi.servers().get(params.server).url()}"</Text>
+      <Text newLines={2}>mqttBroker = "{asyncapi.servers().get(params.server).host()}"</Text>
     // 4
       <Text newLines={2}>class {asyncapi.info().title().replaceAll(' ', '')}Client:</Text>
     // 5
@@ -483,23 +487,23 @@ class TemperatureServiceClient:
 
 ```
 
-You'll then need to template to dynamically generate `sendTemperatureDrop` and `sendTemperatureRise` functions in the generated code based off the AsyncAPI document content. The goal is to write template code that returns functions for channels that the Temperature Service application is subscribed to. The template code to generate these functions will look like this:
+You'll then need a template to dynamically generate `sendTemperatureDrop` and `sendTemperatureRise` functions in the generated code based off the AsyncAPI document content. The goal is to write template code that returns functions for operations marked with `action: receive`, using their associated channels. The template code to generate these functions will look like this:
 
 ```js
 <Text indent={2} newLines={2}>
-  <TopicFunction channels={asyncapi.channels().filterByReceive()} />
+  <TopicFunction operations={asyncapi.operations().filterByReceive()} />
 </Text>
 ```
 
-It's recommended to put reusable components outside the template directory in a new directory called components. You'll create a component that will dynamically generate functions in the output for as many channels as there are in your AsyncAPI document that contains a `publish` operation. Add the following code in the **python-mqtt-client-template/components/TopicFunction.js** file, after creating the **python-mqtt-client-template/components/** directory:
+It's recommended to put reusable components outside the template directory in a new directory called components. You'll create a component that will dynamically generate functions in the output for as many operations as there are in your AsyncAPI document that are marked with `action: receive`. Add the following code in the **python-mqtt-client-template/components/TopicFunction.js** file, after creating the **python-mqtt-client-template/components/** directory:
 
 ```js
 /*
  * This component returns a block of functions that user can use to send messages to specific topic.
- * As input it requires a list of Channel models from the parsed AsyncAPI document
+ * As input it requires a list of Operation models from the parsed AsyncAPI document marked with `action: receive`.
  */
-export function TopicFunction({ channels }) {
-  const topicsDetails = getTopics(channels);
+export function TopicFunction({ operations }) {
+  const topicsDetails = getTopics(operations);
   let functions = '';
 
   topicsDetails.forEach((t) => {
@@ -518,25 +522,28 @@ export function TopicFunction({ channels }) {
  *
  * As input it requires a list of Channel models from the parsed AsyncAPI document
  */
-function getTopics(channels) {
-  const channelsCanSendTo = channels;
+function getTopics(operations) {
   let topicsDetails = [];
 
-  channelsCanSendTo.forEach((ch) => {
-    const topic = {};
-    const operationId = ch.operations().filterByReceive()[0].id();
-    topic.name = operationId.charAt(0).toUpperCase() + operationId.slice(1);
-    topic.topic = ch.address();
-
-    topicsDetails.push(topic);
-  })
-
+  operations.forEach((op) => {
+    const channels = op.channels().all();
+    if (!channels.length) return;
+
+    const channel = channels[0];
+    const operationId = op.operationId() || op.id();
+    
+    topicsDetails.push({
+      name: operationId.charAt(0).toUpperCase() + operationId.slice(1),
+      topic: channel.address()
+    });
+  });
+  
   return topicsDetails;
 }
 ```
 
-`{ channels }`: the `TopicFunction` component accepts a custom prop called channels and in your template code
-`getTopics(channels)`: Returns a list of objects, one for each channel with two properties; name and topic. The **name** holds information about the `operationId` provided in the AsyncAPI document while the **topic** holds information about the address of the topic.
+`{ operations }`: the `TopicFunction` component accepts a custom prop called operations and in your template code 
+`getTopics(operations)`: Returns a list of objects, one for each operation with two properties; name and topic. The **name** holds information about the `operationId` provided in the AsyncAPI document (or a generated ID if operationId is not set) while the **topic** holds information about the address of the topic from the operation's associated channel.
 
 Import the `TopicFunction` component in your template code in **index.js** and add the template code to generate the functions to topics that the `Temperature Service` application is subscribed to. In your case, the final version of your template code should look like this:
 
@@ -549,7 +556,7 @@ export default function ({ asyncapi, params }) {
     <File name="client.py">
       <Text newLines={2}>import paho.mqtt.client as mqtt</Text>
 
-      <Text newLines={2}>mqttBroker = "{asyncapi.servers().get(params.server).url()}"</Text>
+      <Text newLines={2}>mqttBroker = "{asyncapi.servers().get(params.server).host()}"</Text>
 
       <Text newLines={2}>class {asyncapi.info().title().replaceAll(' ', '')}Client:</Text>
 
@@ -560,7 +567,7 @@ export default function ({ asyncapi, params }) {
       </Text>
 
       <Text indent={2} newLines={2}>
-        <TopicFunction channels={asyncapi.channels().filterByReceive()} />
+        <TopicFunction operations={asyncapi.operations().filterByReceive()} />
       </Text>
     </File>
   )
@@ -587,7 +594,7 @@ python-mqtt-client-template
 
 Run `npm test` on your terminal to ensure everything works as expected.
 
-In the next section, you'll add another channel to **asyncapi.yml** file called `temperature/dropped` and `temperature/risen` then run the template again to make sure it still works as expected.
+In the next section, you'll add another channel to **asyncapi.yml** file called `temperatureDropped` and `temperatureRisen` then run the template again to make sure it still works as expected.
 
 #### 5d. Update AsyncAPI document
 
@@ -595,31 +602,34 @@ Update the AsyncAPI document to use two channels:
 
 ```yml
 channels:
-  temperature/dropped:
-    description:  Notifies the user when the temperature drops past a certain point.
-    publish:
-      operationId: temperatureDrop
-      message:
+  temperatureDropped:
+    address: temperature/dropped
+    messages:
+      temperatureDrop:
         description: Message that is being sent when the temperature drops past a certain point.
         payload:
-          type: object
-          additionalProperties: false
-          properties:
-            temperatureId:
-              type: string
-
-  temperature/risen:
-    description: Notifies the user when the temperature rises past a certain point.
-    publish:
-      operationId: temperatureRise
-      message:
+          $ref: '#/components/schemas/temperatureId'
+    description: Notifies the user when the temperature drops past a certain point.
+  temperatureRisen:
+    address: temperature/risen
+    messages:
+      temperatureRise:
         description: Message that is being sent when the temperature rises past a certain point.
         payload:
-          type: object
-          additionalProperties: false
-          properties:
-            temperatureId:
-              type: string
+          $ref: '#/components/schemas/temperatureId'
+    description: Notifies the user when the temperature rises past a certain point.
+
+operations:
+  temperatureDrop:
+    action: receive
+    summary: Message sent to the broker when the temperature is dropped.
+    channel:
+      $ref: '#/channels/temperatureDropped'
+  temperatureRise:
+    action: receive
+    summary: Message sent to the broker when the temperature is risen.
+    channel:
+      $ref: '#/channels/temperatureRisen'
 ```
 
 And update your test script in test.py to test the two functions as below:
@@ -644,6 +654,6 @@ Temperature rise detected 66943992 sent to temperature/risen
 
 Great job completing this tutorial! You have learnt how to use an AsyncAPI file to create a Python MQTT template and used it with the Paho-MQTT library in Python to connect to an MQTT broker and publish messages.😃
 
-If you want to tinker with a completed template and see what it would look like in production, check out the [Paho-MQTT template](https://github.com/derberg/python-mqtt-client-template/tree/v1.0.0). You can also check out the accompanying [article about creating MQTT client code](https://www.brainfart.dev/blog/asyncapi-codegen-python).
+If you want to tinker with a completed template and see what it would look like in production, check out the [Paho-MQTT template](https://github.com/Harsh16gupta/asyncapi-v3-template-final).
 
 You can also check out the [MQTT beginners guide](https://medium.com/python-point/mqtt-basics-with-python-examples-7c758e605d4) tutorial to learn more about asynchronous messaging using MQTT.

package/docs/model-generation.md

@@ -5,7 +5,7 @@ weight: 200
 
 This guide will walk you through the process of enabling models/types generation in a template by using [Modelina](https://www.asyncapi.com/tools/modelina).
 
-Modelina is an AsyncAPI library designed for generating data models using inputs such as [AsyncAPI](generator/asyncapi-document), OpenAPI, or JSON schema inputs. Its functionality revolves around creating data models from the provided AsyncAPI document and the model template, which defines message payloads. It is better to use Modelina in your template to handle model generation rather than providing custom templates.
+Modelina is an AsyncAPI library designed for generating data models using inputs such as [AsyncAPI](asyncapi-document), OpenAPI, or JSON schema inputs. Its functionality revolves around creating data models from the provided AsyncAPI document and the model template, which defines message payloads. It is better to use Modelina in your template to handle model generation rather than providing custom templates.
 
 You can integrate the work shown in this guide into a template by following the [tutorial about creating a template](https://www.asyncapi.com/docs/tools/generator/generator-template).
 

package/docs/usage.md

@@ -40,29 +40,29 @@ asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template
 
 **The shortest possible syntax:**
 ```bash
-asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator
+asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.5.4
 ```
 
 **Generating from a URL:**
 ```bash
-asyncapi generate fromTemplate https://bit.ly/asyncapi @asyncapi/html-template@3.0.0 --use-new-generator
+asyncapi generate fromTemplate https://bit.ly/asyncapi @asyncapi/html-template@3.5.4 
 ```
 
 **Specify where to put the result:**
 ```bash
-asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator -o ./docs
+asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.5.4 -o ./docs
 ```
 
 **Passing parameters to templates:**
 ```bash
-asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator -o ./docs -p title='Hello from param'
+asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.5.4  -o ./docs -p title='Hello from param'
 ```
 
-In the template you can use it like this: ` {{ params.title }}`
+In the template you can use it like this: `{{ params.title }}`
 
 **Disabling the hooks:**
 ```bash
-asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator -o ./docs -d generate:before generate:after=foo,bar
+asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.5.4 -o ./docs -d generate:before generate:after=foo,bar
 ```
 
 The generator skips all hooks of the `generate:before` type and `foo`, `bar` hooks of the `generate:after` type.
@@ -81,7 +81,7 @@ asyncapi generate fromTemplate asyncapi.yaml https://github.com/asyncapi/html-te
 
 **Map schema references from baseUrl to local folder:**
 ```bash
-asyncapi generate fromTemplate test/docs/apiwithref.json @asyncapi/html-template@3.0.0 --use-new-generator -o ./build/ --force-write --map-base-url https://schema.example.com/crm/:./test/docs/
+asyncapi generate fromTemplate test/docs/apiwithref.json @asyncapi/html-template@3.5.4 -o ./build/ --force-write --map-base-url https://schema.example.com/crm/:./test/docs/
 ```
 
 The parameter `--map-base-url` maps external schema references to local folders.
@@ -104,7 +104,7 @@ docker run --rm -it \
    --user=root \
    -v ${PWD}/test/fixtures/asyncapi_v1.yml:/app/asyncapi.yml \
    -v ${PWD}/output:/app/output \
-   asyncapi/cli generate fromTemplate -o /app/output /app/asyncapi.yml @asyncapi/html-template@3.0.0 --use-new-generator --force-write
+   asyncapi/cli generate fromTemplate -o /app/output /app/asyncapi.yml @asyncapi/html-template@3.5.4 --force-write
 ```
 Note: Use ``` ` ``` instead of `\` for Windows.
 
@@ -115,7 +115,7 @@ Note: Use ``` ` ``` instead of `\` for Windows.
 Use the following npx command on your terminal:
 
 ```bash
-npx -p @asyncapi/cli asyncapi generate fromTemplate ./asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator
+npx -p @asyncapi/cli asyncapi generate fromTemplate ./asyncapi.yaml @asyncapi/html-template@3.5.4 
 ```
 
 ## Using as a module/package

package/docs/versioning.md

@@ -18,10 +18,9 @@ It is better to lock a specific version of the template and the generator if you
 Generate HTML with the latest AsyncAPI CLI using the html-template.
 ```
 npm install -g @asyncapi/cli
-asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.0.0 --use-new-generator
+asyncapi generate fromTemplate asyncapi.yaml @asyncapi/html-template@3.5.4
 ```
 
-> AsyncAPI CLI has multiple versions of the generator, and to use the latest version, you may need to pass the `--use-new-generator` flag. For more details you can also check [asyncapi generate fromTemplate ASYNCAPI TEMPLATE](https://www.asyncapi.com/docs/tools/cli/usage#asyncapi-generate-fromtemplate-asyncapi-template)
 
 Generate HTML using a particular version of the AsyncAPI CLI using the html-template.
 

package/lib/conditionalGeneration.js

@@ -42,7 +42,8 @@ async function isGenerationConditionMet (
       return conditionalSubjectGeneration(
         asyncapiDocument,
         templateConfig,
-        matchedConditionPath
+        matchedConditionPath,
+        templateParams
       );
     }
     return conditionalParameterGeneration(templateConfig,matchedConditionPath,templateParams);
@@ -111,9 +112,7 @@ async function conditionalSubjectGeneration (
   const server = templateParams.server && asyncapiDocument.servers().get(templateParams.server);
   const source = jmespath.search({
     ...asyncapiDocument.json(),
-    ...{
-      server: server ? server.json() : undefined,
-    },
+    server: server ? server.json() : undefined,
   }, subject);
 
   if (!source) {
@@ -140,7 +139,6 @@ async function validateStatus(
   if (!validation) {
     return false; 
   }
- 
   const isValid = validation(argument);
 
   if (!isValid) {
@@ -151,7 +149,6 @@ async function validateStatus(
       // TODO: https://github.com/asyncapi/generator/issues/1553
       log.debug(logMessage.conditionalFilesMatched(matchedConditionPath));
     }
- 
     return false;
   }
   return true;

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-kafka-java-quarkus/package.json

@@ -32,8 +32,7 @@
     "eslint": "^6.8.0",
     "eslint-plugin-jest": "^23.8.2",
     "eslint-plugin-react": "^7.34.1",
-    "eslint-plugin-sonarjs": "^0.5.0",
-    "jest-esm-transformer": "^1.0.0"
+    "eslint-plugin-sonarjs": "^0.5.0"
   },
   "babel": {
     "presets": [

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",
@@ -21,7 +23,6 @@
     "@babel/core": "^7.26.0",
     "@babel/preset-env": "^7.26.0",
     "@babel/preset-react": "^7.25.9",
-    "jest-esm-transformer": "^1.0.0",
     "eslint": "^6.8.0",
     "eslint-plugin-jest": "^23.8.2",
     "eslint-plugin-react": "^7.34.1",

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

@@ -2,7 +2,7 @@ apiVersion: v3
 parameters:
   server:
     description: The name of the server described in AsyncAPI document
-    required: false
+    required: true
   appendClientSuffix:
     description: Add 'Client' suffix at the end of the class name. This option has no effect if 'customClientName' is specified.
     required: false

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

@@ -12,14 +12,16 @@
   "author": "Shuaib Salad <sh.salat@gmail.com>",
   "license": "Apache-2.0",
   "scripts": {
-    "test": "jest  --coverage --passWithNoTests",
+    "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": {
@@ -33,8 +35,7 @@
     "eslint": "^6.8.0",
     "eslint-plugin-jest": "^23.8.2",
     "eslint-plugin-react": "^7.34.1",
-    "eslint-plugin-sonarjs": "^0.5.0",
-    "jest-esm-transformer": "^1.0.0"
+    "eslint-plugin-sonarjs": "^0.5.0"
   },
   "babel": {
     "presets": [

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

@@ -7,4 +7,4 @@ You can test this template:
 4. Install with `npm install` and run test with `npm run test`
 5. Start example script that uses a client library generated by the test: `node example.js`
 
-> By default this is testing against Hoppscotch echo service. You can modify `packages/templates/clients/websocket/javascript/example.js` and change first line to `const WSClient = require('./tests/temp/snapshotTestResult/client_postman/client.js');` and run `node example.js` again. You will see example still works but now it is using a different API. This is possible since both AsyncAPI documents define the same name of operation for sending messages: `sendEchoMessage` so each client generated has the same API.
+> By default this is testing against Hoppscotch echo service. You can modify `packages/templates/clients/websocket/javascript/example.js` and change first line to `const WSClient = require('./test/temp/snapshotTestResult/client_postman/client.js');` and run `node example.js` again. You will see example still works but now it is using a different API. This is possible since both AsyncAPI documents define the same name of operation for sending messages: `sendEchoMessage` so each client generated has the same API.

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

@@ -5,16 +5,19 @@
   "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.6.0",
     "@asyncapi/generator-helpers": "1.1.0",
     "@asyncapi/generator-react-sdk": "*",
-    "@asyncapi/generator-components": "0.5.0",
-    "@asyncapi/keeper": "0.5.0"
+    "@asyncapi/keeper": "0.5.0",
+    "ws": "^8.19.0"
   },
   "devDependencies": {
     "@asyncapi/parser": "^3.4.0",
@@ -25,8 +28,7 @@
     "eslint": "^6.8.0",
     "eslint-plugin-jest": "^23.8.2",
     "eslint-plugin-react": "^7.34.1",
-    "eslint-plugin-sonarjs": "^0.5.0",
-    "jest-esm-transformer": "^1.0.0"
+    "eslint-plugin-sonarjs": "^0.5.0"
   },
   "babel": {
     "presets": [

package/lib/templates/bakedInTemplates/core-template-client-websocket-python/__transpiled/components/ReceiveOperationsDiscriminators.js

@@ -10,11 +10,7 @@ var jsxRuntime = require('/home/runner/work/generator/generator/node_modules/rea
 function ReceiveOperationsDiscriminators({
   receiveOperations
 }) {
-  const hasOperations = Array.isArray(receiveOperations) && receiveOperations.length > 0;
-  if (!hasOperations) {
-    return null;
-  }
-  const operationDiscriminators = generatorHelpers.getMessageDiscriminatorsFromOperations(receiveOperations);
+  const operationDiscriminators = Array.isArray(receiveOperations) && receiveOperations.length > 0 ? generatorHelpers.getMessageDiscriminatorsFromOperations(receiveOperations) : [];
   const serializedDiscriminators = JSON.stringify(operationDiscriminators);
   return /*#__PURE__*/jsxRuntime.jsx(generatorReactSdk.Text, {
     indent: 2,

package/lib/templates/bakedInTemplates/core-template-client-websocket-python/__transpiled/components/ReceiveOperationsDiscriminators.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReceiveOperationsDiscriminators.js","sources":["../../../../../../../../packages/templates/clients/websocket/python/components/ReceiveOperationsDiscriminators.js"],"sourcesContent":["import { Text } from '@asyncapi/generator-react-sdk';\nimport { getMessageDiscriminatorsFromOperations } from '@asyncapi/generator-helpers';\n\n/**\n * Component that generates initialization code for receive operation discriminators.\n * \n * @param {Object} props - Component properties\n * @param {Array<Object>} [props.receiveOperations] - Receive operations from AsyncAPI document\n * @returns {React.Element|null} Rendered initialization code or null.\n */\nexport function ReceiveOperationsDiscriminators({ receiveOperations }) {\n  const hasOperations = Array.isArray(receiveOperations) && receiveOperations.length > 0;\n  if (!hasOperations) {\n    return null;\n  }\n\n  const operationDiscriminators = getMessageDiscriminatorsFromOperations(receiveOperations);\n  const serializedDiscriminators = JSON.stringify(operationDiscriminators);\n\n  return (\n    <Text indent={2} newLines={2}>\n      {`\n      self.receive_operation_handlers = {}\n      self.receive_operation_discriminators = ${serializedDiscriminators}`\n      }\n    </Text>\n  );\n}\n"],"names":["ReceiveOperationsDiscriminators","receiveOperations","hasOperations","Array","isArray","length","operationDiscriminators","getMessageDiscriminatorsFromOperations","serializedDiscriminators","JSON","stringify","_jsx","Text","indent","newLines","children"],"mappings":";;;;;;;;;AAUO,SAASA,+BAA+BA,CAAC;AAAEC,EAAAA,iBAAAA;AAAkB,CAAC,EAAE;AACrE,EAAA,MAAMC,aAAa,GAAGC,KAAK,CAACC,OAAO,CAACH,iBAAiB,CAAC,IAAIA,iBAAiB,CAACI,MAAM,GAAG,CAAC,CAAA;EACtF,IAAI,CAACH,aAAa,EAAE;AAClB,IAAA,OAAO,IAAI,CAAA;AACb,GAAA;AAEA,EAAA,MAAMI,uBAAuB,GAAGC,uDAAsC,CAACN,iBAAiB,CAAC,CAAA;AACzF,EAAA,MAAMO,wBAAwB,GAAGC,IAAI,CAACC,SAAS,CAACJ,uBAAuB,CAAC,CAAA;EAExE,oBACEK,cAAA,CAACC,sBAAI,EAAA;AAACC,IAAAA,MAAM,EAAE,CAAE;AAACC,IAAAA,QAAQ,EAAE,CAAE;AAAAC,IAAAA,QAAA,EAC1B,CAAA;AACP;AACA,8CAAA,EAAgDP,wBAAwB,CAAA,CAAA;AAAE,GAEhE,CAAC,CAAA;AAEX;;;;"}
+{"version":3,"file":"ReceiveOperationsDiscriminators.js","sources":["../../../../../../../../packages/templates/clients/websocket/python/components/ReceiveOperationsDiscriminators.js"],"sourcesContent":["import { Text } from '@asyncapi/generator-react-sdk';\nimport { getMessageDiscriminatorsFromOperations } from '@asyncapi/generator-helpers';\n\n/**\n * Component that generates initialization code for receive operation discriminators.\n * \n * @param {Object} props - Component properties\n * @param {Array<Object>} [props.receiveOperations] - Receive operations from AsyncAPI document\n * @returns {React.Element|null} Rendered initialization code or null.\n */\nexport function ReceiveOperationsDiscriminators({ receiveOperations }) {\n  const operationDiscriminators = Array.isArray(receiveOperations) && receiveOperations.length > 0\n    ? getMessageDiscriminatorsFromOperations(receiveOperations)\n    : [];\n  const serializedDiscriminators = JSON.stringify(operationDiscriminators);\n\n  return (\n    <Text indent={2} newLines={2}>\n      {`\n      self.receive_operation_handlers = {}\n      self.receive_operation_discriminators = ${serializedDiscriminators}`\n      }\n    </Text>\n  );\n}\n"],"names":["ReceiveOperationsDiscriminators","receiveOperations","operationDiscriminators","Array","isArray","length","getMessageDiscriminatorsFromOperations","serializedDiscriminators","JSON","stringify","_jsx","Text","indent","newLines","children"],"mappings":";;;;;;;;;AAUO,SAASA,+BAA+BA,CAAC;AAAEC,EAAAA,iBAAAA;AAAkB,CAAC,EAAE;EACrE,MAAMC,uBAAuB,GAAGC,KAAK,CAACC,OAAO,CAACH,iBAAiB,CAAC,IAAIA,iBAAiB,CAACI,MAAM,GAAG,CAAC,GAC5FC,uDAAsC,CAACL,iBAAiB,CAAC,GACzD,EAAE,CAAA;AACN,EAAA,MAAMM,wBAAwB,GAAGC,IAAI,CAACC,SAAS,CAACP,uBAAuB,CAAC,CAAA;EAExE,oBACEQ,cAAA,CAACC,sBAAI,EAAA;AAACC,IAAAA,MAAM,EAAE,CAAE;AAACC,IAAAA,QAAQ,EAAE,CAAE;AAAAC,IAAAA,QAAA,EAC1B,CAAA;AACP;AACA,8CAAA,EAAgDP,wBAAwB,CAAA,CAAA;AAAE,GAEhE,CAAC,CAAA;AAEX;;;;"}

package/lib/templates/bakedInTemplates/core-template-client-websocket-python/__transpiled/components/Send.js

@@ -17,7 +17,7 @@ function Send({
     indent: 2,
     children: `
 @staticmethod
-async def _send(message, socket):
+def _send(message, socket):
     """
     Internal helper to handle the actual sending logic.
 
@@ -31,7 +31,7 @@ async def _send(message, socket):
     try:
         if isinstance(message, dict):
             message = json.dumps(message)
-        await socket.send(message)
+        socket.send(message)
     except Exception as e:
         print("Error sending:", e)`
   });

package/lib/templates/bakedInTemplates/core-template-client-websocket-python/__transpiled/components/Send.js.map

@@ -1 +1 @@
-{"version":3,"file":"Send.js","sources":["../../../../../../../../packages/templates/clients/websocket/python/components/Send.js"],"sourcesContent":["import { Text } from '@asyncapi/generator-react-sdk';\n\nexport function Send({ sendOperations }) {\n  if (!sendOperations || sendOperations.length === 0) {\n    return null;\n  }\n\n  return (\n    <Text newLines={2} indent={2}>\n      {\n        `\n@staticmethod\nasync def _send(message, socket):\n    \"\"\"\n    Internal helper to handle the actual sending logic.\n\n    Args:\n        message (dict or str): The message to send.\n        socket (websockets.WebSocketCommonProtocol): The WebSocket to send through.\n\n    Notes:\n        If message is a dictionary, it will be automatically converted to JSON.\n    \"\"\"\n    try:\n        if isinstance(message, dict):\n            message = json.dumps(message)\n        await socket.send(message)\n    except Exception as e:\n        print(\"Error sending:\", e)`\n      }\n    </Text>\n  );\n}\n"],"names":["Send","sendOperations","length","_jsx","Text","newLines","indent","children"],"mappings":";;;;;;;;AAEO,SAASA,IAAIA,CAAC;AAAEC,EAAAA,cAAAA;AAAe,CAAC,EAAE;EACvC,IAAI,CAACA,cAAc,IAAIA,cAAc,CAACC,MAAM,KAAK,CAAC,EAAE;AAClD,IAAA,OAAO,IAAI,CAAA;AACb,GAAA;EAEA,oBACEC,cAAA,CAACC,sBAAI,EAAA;AAACC,IAAAA,QAAQ,EAAE,CAAE;AAACC,IAAAA,MAAM,EAAE,CAAE;AAAAC,IAAAA,QAAA,EAEzB,CAAA;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,kCAAA,CAAA;AAAmC,GAEzB,CAAC,CAAA;AAEX;;;;"}
+{"version":3,"file":"Send.js","sources":["../../../../../../../../packages/templates/clients/websocket/python/components/Send.js"],"sourcesContent":["import { Text } from '@asyncapi/generator-react-sdk';\n\nexport function Send({ sendOperations }) {\n  if (!sendOperations || sendOperations.length === 0) {\n    return null;\n  }\n\n  return (\n    <Text newLines={2} indent={2}>\n      {\n        `\n@staticmethod\ndef _send(message, socket):\n    \"\"\"\n    Internal helper to handle the actual sending logic.\n\n    Args:\n        message (dict or str): The message to send.\n        socket (websockets.WebSocketCommonProtocol): The WebSocket to send through.\n\n    Notes:\n        If message is a dictionary, it will be automatically converted to JSON.\n    \"\"\"\n    try:\n        if isinstance(message, dict):\n            message = json.dumps(message)\n        socket.send(message)\n    except Exception as e:\n        print(\"Error sending:\", e)`\n      }\n    </Text>\n  );\n}\n"],"names":["Send","sendOperations","length","_jsx","Text","newLines","indent","children"],"mappings":";;;;;;;;AAEO,SAASA,IAAIA,CAAC;AAAEC,EAAAA,cAAAA;AAAe,CAAC,EAAE;EACvC,IAAI,CAACA,cAAc,IAAIA,cAAc,CAACC,MAAM,KAAK,CAAC,EAAE;AAClD,IAAA,OAAO,IAAI,CAAA;AACb,GAAA;EAEA,oBACEC,cAAA,CAACC,sBAAI,EAAA;AAACC,IAAAA,QAAQ,EAAE,CAAE;AAACC,IAAAA,MAAM,EAAE,CAAE;AAAAC,IAAAA,QAAA,EAEzB,CAAA;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,kCAAA,CAAA;AAAmC,GAEzB,CAAC,CAAA;AAEX;;;;"}

package/lib/templates/bakedInTemplates/core-template-client-websocket-python/__transpiled/template/client.py.js

@@ -31,7 +31,7 @@ function Send({
     indent: 2,
     children: `
 @staticmethod
-async def _send(message, socket):
+def _send(message, socket):
     """
     Internal helper to handle the actual sending logic.
 
@@ -45,7 +45,7 @@ async def _send(message, socket):
     try:
         if isinstance(message, dict):
             message = json.dumps(message)
-        await socket.send(message)
+        socket.send(message)
     except Exception as e:
         print("Error sending:", e)`
   });
@@ -95,11 +95,7 @@ function InitSignature({
 function ReceiveOperationsDiscriminators({
   receiveOperations
 }) {
-  const hasOperations = Array.isArray(receiveOperations) && receiveOperations.length > 0;
-  if (!hasOperations) {
-    return null;
-  }
-  const operationDiscriminators = generatorHelpers.getMessageDiscriminatorsFromOperations(receiveOperations);
+  const operationDiscriminators = Array.isArray(receiveOperations) && receiveOperations.length > 0 ? generatorHelpers.getMessageDiscriminatorsFromOperations(receiveOperations) : [];
   const serializedDiscriminators = JSON.stringify(operationDiscriminators);
   return /*#__PURE__*/jsxRuntime.jsx(generatorReactSdk.Text, {
     indent: 2,