@achinet/nestjs-async 0.0.1 → 0.1.0

package/misc/references/ref.html

@@ -0,0 +1,303 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>AsyncAPI Documentation</title>
+</head>
+<body>
+  <h1>AsyncAPI Documentation</h1>
+  <p>Mock HTML generated for testing</p>
+  <pre>asyncapi: 2.5.0
+info:
+  title: Feline
+  description: Feline server description here
+  version: '1.0'
+  contact: {}
+tags: []
+servers:
+  europe: &ref_0
+    url: ws://0.0.0.0:4001
+    protocol: socket.io
+    protocolVersion: '4'
+    description: &gt;-
+      Allows you to connect using the websocket protocol to our Socket.io
+      server.
+    security:
+      - user-password: []
+    variables:
+      port:
+        description: Secure connection (TLS) is available through port 443.
+        default: '443'
+    bindings: {}
+  asia: *ref_0
+  north-america: *ref_0
+  south-america: *ref_0
+  africa: *ref_0
+  australia: *ref_0
+components:
+  securitySchemes:
+    user-password:
+      type: userPassword
+  schemas:
+    Feline:
+      type: object
+      properties:
+        id:
+          type: number
+        name:
+          type: string
+        age:
+          type: number
+        gender:
+          enum: &ref_2
+            - male
+            - female
+          type: string
+        dominantPaw:
+          enum: &ref_3
+            - left
+            - right
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+        birthDatetime:
+          format: date-time
+          type: string
+      required:
+        - id
+        - name
+        - age
+        - gender
+        - dominantPaw
+        - tags
+        - birthDatetime
+    CreateFelineDto:
+      type: object
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+        version:
+          type: string
+          format: x.y.z
+          example: 1.0.1
+        payload:
+          oneOf:
+            - $ref: '#/components/schemas/Cat'
+            - $ref: '#/components/schemas/Lion'
+            - $ref: '#/components/schemas/Tiger'
+          allOf:
+            - $ref: '#/components/schemas/Feline'
+        timestamp:
+          format: date-time
+          type: string
+      required:
+        - correlationId
+        - version
+        - payload
+        - timestamp
+    FelineRto:
+      type: object
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+        version:
+          type: string
+          format: x.y.z
+          example: 1.0.1
+        payload:
+          oneOf: &ref_1
+            - $ref: '#/components/schemas/Cat'
+            - $ref: '#/components/schemas/Lion'
+            - $ref: '#/components/schemas/Tiger'
+          allOf:
+            - $ref: '#/components/schemas/Feline'
+        timestamp:
+          format: date-time
+          type: string
+      required:
+        - correlationId
+        - version
+        - payload
+        - timestamp
+    FelineExtendedRto:
+      type: object
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+        version:
+          type: string
+          format: x.y.z
+          example: 1.0.1
+        payload:
+          oneOf: *ref_1
+          allOf:
+            - $ref: '#/components/schemas/Feline'
+        timestamp:
+          format: date-time
+          type: string
+      required:
+        - correlationId
+        - version
+        - payload
+        - timestamp
+    JournalingDataDto:
+      type: object
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+        version:
+          type: string
+          format: x.y.z
+          example: 1.0.1
+        payload:
+          type: object
+        timestamp:
+          format: date-time
+          type: string
+      required:
+        - correlationId
+        - version
+        - payload
+        - timestamp
+    Cat:
+      type: object
+      properties:
+        breed:
+          type: string
+          example: Maine Coon
+        id:
+          type: number
+        name:
+          type: string
+        age:
+          type: number
+        gender:
+          enum: *ref_2
+          type: string
+        dominantPaw:
+          enum: *ref_3
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+        birthDatetime:
+          format: date-time
+          type: string
+      required:
+        - breed
+        - id
+        - name
+        - age
+        - gender
+        - dominantPaw
+        - tags
+        - birthDatetime
+    Lion:
+      type: object
+      properties:
+        id:
+          type: number
+        name:
+          type: string
+        age:
+          type: number
+        gender:
+          enum: *ref_2
+          type: string
+        dominantPaw:
+          enum: *ref_3
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+        birthDatetime:
+          format: date-time
+          type: string
+        roarVolume:
+          type: number
+      required:
+        - id
+        - name
+        - age
+        - gender
+        - dominantPaw
+        - tags
+        - birthDatetime
+        - roarVolume
+    Tiger:
+      type: object
+      properties:
+        id:
+          type: number
+        name:
+          type: string
+        age:
+          type: number
+        gender:
+          enum: *ref_2
+          type: string
+        dominantPaw:
+          enum: *ref_3
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+        birthDatetime:
+          format: date-time
+          type: string
+        numberOfStripes:
+          type: number
+      required:
+        - id
+        - name
+        - age
+        - gender
+        - dominantPaw
+        - tags
+        - birthDatetime
+        - numberOfStripes
+defaultContentType: application/json
+channels:
+  ws/create/feline:
+    subscribe:
+      message:
+        oneOf:
+          - name: 'oneOf demo #1'
+            payload:
+              $ref: '#/components/schemas/FelineRto'
+          - name: 'oneOf demo #2'
+            payload:
+              $ref: '#/components/schemas/FelineExtendedRto'
+    publish:
+      message:
+        payload:
+          $ref: '#/components/schemas/CreateFelineDto'
+        name: FelinesGateway#createFeline
+  ms/journal:
+    subscribe:
+      message:
+        payload:
+          $ref: '#/components/schemas/JournalingDataDto'
+        name: FelinesController#journal
+  ms/create/feline:
+    subscribe:
+      message:
+        payload:
+          $ref: '#/components/schemas/FelineRto'
+        name: FelinesController#createFeline
+    publish:
+      message:
+        payload:
+          $ref: '#/components/schemas/CreateFelineDto'
+        name: FelinesController#createFeline
+</pre>
+</body>
+</html>

package/misc/references/ref.json

@@ -0,0 +1 @@
+{"asyncapi":"2.5.0","info":{"title":"Feline","description":"Feline server description here","version":"1.0","contact":{}},"tags":[],"servers":{"europe":{"url":"ws://0.0.0.0:4001","protocol":"socket.io","protocolVersion":"4","description":"Allows you to connect using the websocket protocol to our Socket.io server.","security":[{"user-password":[]}],"variables":{"port":{"description":"Secure connection (TLS) is available through port 443.","default":"443"}},"bindings":{}},"asia":{"url":"ws://0.0.0.0:4001","protocol":"socket.io","protocolVersion":"4","description":"Allows you to connect using the websocket protocol to our Socket.io server.","security":[{"user-password":[]}],"variables":{"port":{"description":"Secure connection (TLS) is available through port 443.","default":"443"}},"bindings":{}},"north-america":{"url":"ws://0.0.0.0:4001","protocol":"socket.io","protocolVersion":"4","description":"Allows you to connect using the websocket protocol to our Socket.io server.","security":[{"user-password":[]}],"variables":{"port":{"description":"Secure connection (TLS) is available through port 443.","default":"443"}},"bindings":{}},"south-america":{"url":"ws://0.0.0.0:4001","protocol":"socket.io","protocolVersion":"4","description":"Allows you to connect using the websocket protocol to our Socket.io server.","security":[{"user-password":[]}],"variables":{"port":{"description":"Secure connection (TLS) is available through port 443.","default":"443"}},"bindings":{}},"africa":{"url":"ws://0.0.0.0:4001","protocol":"socket.io","protocolVersion":"4","description":"Allows you to connect using the websocket protocol to our Socket.io server.","security":[{"user-password":[]}],"variables":{"port":{"description":"Secure connection (TLS) is available through port 443.","default":"443"}},"bindings":{}},"australia":{"url":"ws://0.0.0.0:4001","protocol":"socket.io","protocolVersion":"4","description":"Allows you to connect using the websocket protocol to our Socket.io server.","security":[{"user-password":[]}],"variables":{"port":{"description":"Secure connection (TLS) is available through port 443.","default":"443"}},"bindings":{}}},"components":{"securitySchemes":{"user-password":{"type":"userPassword"}},"schemas":{"Feline":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"age":{"type":"number"},"gender":{"enum":["male","female"],"type":"string"},"dominantPaw":{"enum":["left","right"],"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"birthDatetime":{"format":"date-time","type":"string"}},"required":["id","name","age","gender","dominantPaw","tags","birthDatetime"]},"CreateFelineDto":{"type":"object","properties":{"correlationId":{"type":"string","format":"uuid"},"version":{"type":"string","format":"x.y.z","example":"1.0.1"},"payload":{"oneOf":[{"$ref":"#/components/schemas/Cat"},{"$ref":"#/components/schemas/Lion"},{"$ref":"#/components/schemas/Tiger"}],"allOf":[{"$ref":"#/components/schemas/Feline"}]},"timestamp":{"format":"date-time","type":"string"}},"required":["correlationId","version","payload","timestamp"]},"FelineRto":{"type":"object","properties":{"correlationId":{"type":"string","format":"uuid"},"version":{"type":"string","format":"x.y.z","example":"1.0.1"},"payload":{"oneOf":[{"$ref":"#/components/schemas/Cat"},{"$ref":"#/components/schemas/Lion"},{"$ref":"#/components/schemas/Tiger"}],"allOf":[{"$ref":"#/components/schemas/Feline"}]},"timestamp":{"format":"date-time","type":"string"}},"required":["correlationId","version","payload","timestamp"]},"FelineExtendedRto":{"type":"object","properties":{"correlationId":{"type":"string","format":"uuid"},"version":{"type":"string","format":"x.y.z","example":"1.0.1"},"payload":{"oneOf":[{"$ref":"#/components/schemas/Cat"},{"$ref":"#/components/schemas/Lion"},{"$ref":"#/components/schemas/Tiger"}],"allOf":[{"$ref":"#/components/schemas/Feline"}]},"timestamp":{"format":"date-time","type":"string"}},"required":["correlationId","version","payload","timestamp"]},"JournalingDataDto":{"type":"object","properties":{"correlationId":{"type":"string","format":"uuid"},"version":{"type":"string","format":"x.y.z","example":"1.0.1"},"payload":{"type":"object"},"timestamp":{"format":"date-time","type":"string"}},"required":["correlationId","version","payload","timestamp"]},"Cat":{"type":"object","properties":{"breed":{"type":"string","example":"Maine Coon"},"id":{"type":"number"},"name":{"type":"string"},"age":{"type":"number"},"gender":{"enum":["male","female"],"type":"string"},"dominantPaw":{"enum":["left","right"],"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"birthDatetime":{"format":"date-time","type":"string"}},"required":["breed","id","name","age","gender","dominantPaw","tags","birthDatetime"]},"Lion":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"age":{"type":"number"},"gender":{"enum":["male","female"],"type":"string"},"dominantPaw":{"enum":["left","right"],"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"birthDatetime":{"format":"date-time","type":"string"},"roarVolume":{"type":"number"}},"required":["id","name","age","gender","dominantPaw","tags","birthDatetime","roarVolume"]},"Tiger":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"age":{"type":"number"},"gender":{"enum":["male","female"],"type":"string"},"dominantPaw":{"enum":["left","right"],"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"birthDatetime":{"format":"date-time","type":"string"},"numberOfStripes":{"type":"number"}},"required":["id","name","age","gender","dominantPaw","tags","birthDatetime","numberOfStripes"]}}},"defaultContentType":"application/json","channels":{"ws/create/feline":{"subscribe":{"message":{"oneOf":[{"name":"oneOf demo #1","payload":{"$ref":"#/components/schemas/FelineRto"}},{"name":"oneOf demo #2","payload":{"$ref":"#/components/schemas/FelineExtendedRto"}}]}},"publish":{"message":{"payload":{"$ref":"#/components/schemas/CreateFelineDto"},"name":"FelinesGateway#createFeline"}}},"ms/journal":{"subscribe":{"message":{"payload":{"$ref":"#/components/schemas/JournalingDataDto"},"name":"FelinesController#journal"}}},"ms/create/feline":{"subscribe":{"message":{"payload":{"$ref":"#/components/schemas/FelineRto"},"name":"FelinesController#createFeline"}},"publish":{"message":{"payload":{"$ref":"#/components/schemas/CreateFelineDto"},"name":"FelinesController#createFeline"}}}}}

package/misc/references/ref.yaml

@@ -0,0 +1,292 @@
+asyncapi: 2.5.0
+info:
+  title: Feline
+  description: Feline server description here
+  version: '1.0'
+  contact: {}
+tags: []
+servers:
+  europe: &ref_0
+    url: ws://0.0.0.0:4001
+    protocol: socket.io
+    protocolVersion: '4'
+    description: >-
+      Allows you to connect using the websocket protocol to our Socket.io
+      server.
+    security:
+      - user-password: []
+    variables:
+      port:
+        description: Secure connection (TLS) is available through port 443.
+        default: '443'
+    bindings: {}
+  asia: *ref_0
+  north-america: *ref_0
+  south-america: *ref_0
+  africa: *ref_0
+  australia: *ref_0
+components:
+  securitySchemes:
+    user-password:
+      type: userPassword
+  schemas:
+    Feline:
+      type: object
+      properties:
+        id:
+          type: number
+        name:
+          type: string
+        age:
+          type: number
+        gender:
+          enum: &ref_2
+            - male
+            - female
+          type: string
+        dominantPaw:
+          enum: &ref_3
+            - left
+            - right
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+        birthDatetime:
+          format: date-time
+          type: string
+      required:
+        - id
+        - name
+        - age
+        - gender
+        - dominantPaw
+        - tags
+        - birthDatetime
+    CreateFelineDto:
+      type: object
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+        version:
+          type: string
+          format: x.y.z
+          example: 1.0.1
+        payload:
+          oneOf:
+            - $ref: '#/components/schemas/Cat'
+            - $ref: '#/components/schemas/Lion'
+            - $ref: '#/components/schemas/Tiger'
+          allOf:
+            - $ref: '#/components/schemas/Feline'
+        timestamp:
+          format: date-time
+          type: string
+      required:
+        - correlationId
+        - version
+        - payload
+        - timestamp
+    FelineRto:
+      type: object
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+        version:
+          type: string
+          format: x.y.z
+          example: 1.0.1
+        payload:
+          oneOf: &ref_1
+            - $ref: '#/components/schemas/Cat'
+            - $ref: '#/components/schemas/Lion'
+            - $ref: '#/components/schemas/Tiger'
+          allOf:
+            - $ref: '#/components/schemas/Feline'
+        timestamp:
+          format: date-time
+          type: string
+      required:
+        - correlationId
+        - version
+        - payload
+        - timestamp
+    FelineExtendedRto:
+      type: object
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+        version:
+          type: string
+          format: x.y.z
+          example: 1.0.1
+        payload:
+          oneOf: *ref_1
+          allOf:
+            - $ref: '#/components/schemas/Feline'
+        timestamp:
+          format: date-time
+          type: string
+      required:
+        - correlationId
+        - version
+        - payload
+        - timestamp
+    JournalingDataDto:
+      type: object
+      properties:
+        correlationId:
+          type: string
+          format: uuid
+        version:
+          type: string
+          format: x.y.z
+          example: 1.0.1
+        payload:
+          type: object
+        timestamp:
+          format: date-time
+          type: string
+      required:
+        - correlationId
+        - version
+        - payload
+        - timestamp
+    Cat:
+      type: object
+      properties:
+        breed:
+          type: string
+          example: Maine Coon
+        id:
+          type: number
+        name:
+          type: string
+        age:
+          type: number
+        gender:
+          enum: *ref_2
+          type: string
+        dominantPaw:
+          enum: *ref_3
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+        birthDatetime:
+          format: date-time
+          type: string
+      required:
+        - breed
+        - id
+        - name
+        - age
+        - gender
+        - dominantPaw
+        - tags
+        - birthDatetime
+    Lion:
+      type: object
+      properties:
+        id:
+          type: number
+        name:
+          type: string
+        age:
+          type: number
+        gender:
+          enum: *ref_2
+          type: string
+        dominantPaw:
+          enum: *ref_3
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+        birthDatetime:
+          format: date-time
+          type: string
+        roarVolume:
+          type: number
+      required:
+        - id
+        - name
+        - age
+        - gender
+        - dominantPaw
+        - tags
+        - birthDatetime
+        - roarVolume
+    Tiger:
+      type: object
+      properties:
+        id:
+          type: number
+        name:
+          type: string
+        age:
+          type: number
+        gender:
+          enum: *ref_2
+          type: string
+        dominantPaw:
+          enum: *ref_3
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+        birthDatetime:
+          format: date-time
+          type: string
+        numberOfStripes:
+          type: number
+      required:
+        - id
+        - name
+        - age
+        - gender
+        - dominantPaw
+        - tags
+        - birthDatetime
+        - numberOfStripes
+defaultContentType: application/json
+channels:
+  ws/create/feline:
+    subscribe:
+      message:
+        oneOf:
+          - name: 'oneOf demo #1'
+            payload:
+              $ref: '#/components/schemas/FelineRto'
+          - name: 'oneOf demo #2'
+            payload:
+              $ref: '#/components/schemas/FelineExtendedRto'
+    publish:
+      message:
+        payload:
+          $ref: '#/components/schemas/CreateFelineDto'
+        name: FelinesGateway#createFeline
+  ms/journal:
+    subscribe:
+      message:
+        payload:
+          $ref: '#/components/schemas/JournalingDataDto'
+        name: FelinesController#journal
+  ms/create/feline:
+    subscribe:
+      message:
+        payload:
+          $ref: '#/components/schemas/FelineRto'
+        name: FelinesController#createFeline
+    publish:
+      message:
+        payload:
+          $ref: '#/components/schemas/CreateFelineDto'
+        name: FelinesController#createFeline

package/misc/take-snaphots.sh

@@ -0,0 +1,8 @@
+curl http://localhost:4001/async-api > misc/references/ref.html
+curl http://localhost:4001/async-api > docs/live-demo/index.html
+curl http://localhost:4001/async-api-json > misc/references/ref.json
+curl http://localhost:4001/async-api-yaml > misc/references/ref.yaml
+echo 'test snapshots were taken'
+
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@achinet/nestjs-async",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "",
   "author": "",
   "license": "UNLICENSED",
@@ -11,7 +11,8 @@
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\"",
     "lint:fix": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
     "clean": "rimraf dist",
-    "test": "jest"
+    "test": "jest --passWithNoTests",
+    "test:e2e": "jest --runInBand --config test/configs/jest-e2e.config.js"
   },
   "jest": {
     "moduleFileExtensions": [
@@ -25,7 +26,7 @@
     "rootDir": "./",
     "testRegex": ".*\\.spec\\.ts$",
     "transform": {
-      "^.+\\.(t|j)s$": [
+      "^.+\\.ts$": [
         "@swc/jest",
         {
           "jsc": {
@@ -41,6 +42,9 @@
         }
       ]
     },
+    "moduleNameMapper": {
+      "^@asyncapi/generator$": "<rootDir>/test/__mocks__/@asyncapi/generator.js"
+    },
     "collectCoverageFrom": [
       "**/*.(t|j)s"
     ],
@@ -51,14 +55,14 @@
     "@nestjs/cli": "11.0.5",
     "@nestjs/microservices": "11.0.11",
     "@nestjs/platform-express": "11.0.11",
-    "@nestjs/platform-fastify": "11.0.11",
+    "@nestjs/platform-fastify": "11.1.10",
     "@nestjs/platform-socket.io": "11.0.11",
     "@nestjs/schematics": "11.0.2",
     "@nestjs/testing": "11.0.11",
-    "@nestjs/websockets": "11.0.11",
     "@types/express": "4.17.21",
     "@types/jest": "29.5.11",
     "@types/js-yaml": "4.0.9",
+    "@types/lodash": "^4",
     "@types/node": "20.11.14",
     "@types/supertest": "2.0.12",
     "@types/url-join": "4.0.3",
@@ -76,19 +80,22 @@
     "socket.io": "4.7.4",
     "socket.io-client": "4.7.4",
     "supertest": "6.3.3",
-    "ts-jest": "29.1.2",
+    "ts-jest": "^29.4.5",
     "ts-loader": "9.5.1",
-    "ts-node": "10.9.2",
+    "ts-node": "^10.9.2",
     "tsconfig-paths": "4.2.0",
-    "typescript": "5.3.3"
+    "typescript": "5.9.3"
   },
   "dependencies": {
-    "@asyncapi/generator": "1.13.1",
-    "@asyncapi/html-template": "0.28.4",
+    "@asyncapi/generator": "^3.1.2",
+    "@asyncapi/html-template": "^3.5.4",
     "@nestjs/common": "^11.1.7",
     "@nestjs/core": "^11.1.7",
     "@nestjs/swagger": "^11.2.1",
-    "js-yaml": "4.1.0",
+    "@nestjs/websockets": "^11.1.7",
+    "@swc/core": "1.13.5",
+    "js-yaml": "4.1.1",
+    "lodash": "^4.17.21",
     "reflect-metadata": "0.2.1"
   }
 }