eva4j 1.0.16 → 1.0.17

package/examples/domain-read-models.yaml

@@ -0,0 +1,113 @@
+# Example: Read Models (Local Projections)
+#
+# This example shows an "orders" module that uses readModels to maintain
+# local projections of data from "products" and "customers" modules,
+# eliminating synchronous HTTP dependencies.
+#
+# ─── SOURCE MODULE NOTE ──────────────────────────────────────────────────────
+# The source module (e.g. products/domain.yaml) must declare the events
+# that this readModel's syncedBy entries reference. Use lifecycle: to
+# automatically emit raise() at CRUD operations:
+#
+#   events:
+#     - name: ProductCreatedEvent
+#       lifecycle: create          # raise() in creation constructor
+#       fields:
+#         - name: productId
+#           type: String
+#         - name: name
+#           type: String
+#         - name: price
+#           type: BigDecimal
+#         - name: status
+#           type: String
+#
+#     - name: ProductUpdatedEvent
+#       lifecycle: update          # raise() in UpdateCommandHandler
+#       fields: [...]
+#
+#     - name: ProductDeactivatedEvent
+#       lifecycle: softDelete      # raise() in softDelete() method
+#       fields: [...]
+# ─────────────────────────────────────────────────────────────────────────────
+
+aggregates:
+  - name: Order
+    entities:
+      - name: Order
+        isRoot: true
+        tableName: orders
+        audit:
+          enabled: true
+          trackUser: true
+        fields:
+          - name: id
+            type: String
+          - name: orderNumber
+            type: String
+          - name: customerId
+            type: String
+            reference:
+              aggregate: Customer
+              module: customers
+          - name: totalAmount
+            type: BigDecimal
+            readOnly: true
+            defaultValue: "0.00"
+    enums:
+      - name: OrderStatus
+        initialValue: DRAFT
+        values: [DRAFT, PLACED, CONFIRMED, CANCELLED]
+        transitions:
+          - from: DRAFT
+            to: PLACED
+            method: place
+          - from: PLACED
+            to: CONFIRMED
+            method: confirm
+          - from: [DRAFT, PLACED]
+            to: CANCELLED
+            method: cancel
+
+readModels:
+  - name: ProductReadModel
+    source:
+      module: products
+      aggregate: Product
+    tableName: rm_products
+    fields:
+      - name: id
+        type: String
+      - name: name
+        type: String
+      - name: price
+        type: BigDecimal
+      - name: status
+        type: String
+    syncedBy:
+      - event: ProductCreatedEvent
+        action: UPSERT
+      - event: ProductUpdatedEvent
+        action: UPSERT
+      - event: ProductDeactivatedEvent
+        action: SOFT_DELETE
+
+  - name: CustomerReadModel
+    source:
+      module: customers
+      aggregate: Customer
+    tableName: rm_customers
+    fields:
+      - name: id
+        type: String
+      - name: fullName
+        type: String
+      - name: email
+        type: String
+    syncedBy:
+      - event: CustomerRegisteredEvent
+        action: UPSERT
+      - event: CustomerUpdatedEvent
+        action: UPSERT
+      - event: CustomerDeletedEvent
+        action: DELETE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eva4j",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "description": "A powerful Node.js CLI for generating Spring Boot projects with modular architecture that enables efficient monolith-first development with seamless transition to microservices",
   "main": "bin/eva4j.js",
   "bin": {