eva4j 1.0.12 → 1.0.13

package/examples/domain-audit-complete.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:
@@ -67,7 +67,7 @@ aggregates:
 
   - name: Customer
     entities:
-      - name: customer
+      - name: Customer
         isRoot: true
         tableName: customers
         audit:

package/examples/domain-collections.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: BlogPost
     entities:
-      - name: blogPost
+      - name: BlogPost
         isRoot: true
         tableName: blog_posts
         auditable: true
@@ -41,7 +41,7 @@ aggregates:
             cascade: [PERSIST, MERGE, REMOVE]
             fetch: LAZY
       
-      - name: comment
+      - name: Comment
         tableName: comments
         auditable: true
         fields:

package/examples/domain-ecommerce.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: ShoppingCart
     entities:
-      - name: shoppingCart
+      - name: ShoppingCart
         isRoot: true
         tableName: shopping_carts
         auditable: true
@@ -39,7 +39,7 @@ aggregates:
             cascade: [PERSIST, MERGE, REMOVE]
             fetch: LAZY
       
-      - name: cartItem
+      - name: CartItem
         tableName: cart_items
         auditable: true
         fields:

package/examples/domain-events.yaml

@@ -127,7 +127,7 @@
 aggregates:
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:

package/examples/domain-field-visibility.yaml

@@ -6,7 +6,7 @@ aggregates:
   # User Management Aggregate
   - name: User
     entities:
-      - name: user
+      - name: User
         isRoot: true
         tableName: users
         audit:
@@ -40,6 +40,7 @@ aggregates:
           - name: loginCount
             type: Integer
             readOnly: true
+            defaultValue: 0   # Initialized to 0 on creation
           
           # Readonly field - NOT in constructor or CreateDto
           # Use case: Calculated timestamp
@@ -57,7 +58,7 @@ aggregates:
   # Order Management Aggregate
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:
@@ -80,11 +81,13 @@ aggregates:
           - name: totalAmount
             type: BigDecimal
             readOnly: true
+            defaultValue: "0.00"  # Starts at zero before items are added
           
           # Readonly field - count of items
           - name: itemCount
             type: Integer
             readOnly: true
+            defaultValue: 0   # Starts at zero
           
           # Hidden field - internal processing flag
           - name: processingToken
@@ -97,7 +100,7 @@ aggregates:
             mappedBy: order
             cascade: [PERSIST, MERGE, REMOVE]
       
-      - name: orderItem
+      - name: OrderItem
         tableName: order_items
         fields:
           - name: id
@@ -116,6 +119,7 @@ aggregates:
           - name: subtotal
             type: BigDecimal
             readOnly: true
+            defaultValue: "0.00"  # Calculated on creation
         
         relationships:
           - type: ManyToOne
@@ -125,7 +129,7 @@ aggregates:
   # Product Catalog Aggregate
   - name: Product
     entities:
-      - name: product
+      - name: Product
         isRoot: true
         tableName: products
         audit:
@@ -147,6 +151,7 @@ aggregates:
           - name: stockLevel
             type: Integer
             readOnly: true
+            defaultValue: 0   # New products start with zero stock
           
           # Readonly field - last updated stock timestamp
           - name: stockUpdatedAt
@@ -166,7 +171,7 @@ aggregates:
   # Session Management Aggregate
   - name: Session
     entities:
-      - name: session
+      - name: Session
         isRoot: true
         tableName: sessions
         fields:
@@ -191,6 +196,7 @@ aggregates:
             type: Boolean
             hidden: true
             readOnly: true
+            defaultValue: false  # Sessions start as not revoked
           
           - name: createdAt
             type: LocalDateTime

package/examples/domain-multi-aggregate.yaml

@@ -6,7 +6,7 @@ aggregates:
   # AGREGADO 1: Customer
   - name: Customer
     entities:
-      - name: customer
+      - name: Customer
         isRoot: true
         tableName: customers
         auditable: true
@@ -30,7 +30,7 @@ aggregates:
             cascade: [PERSIST, MERGE, REMOVE]
             fetch: LAZY
       
-      - name: address
+      - name: Address
         tableName: customer_addresses
         fields:
           - name: id
@@ -77,7 +77,7 @@ aggregates:
   # AGREGADO 2: Supplier
   - name: Supplier
     entities:
-      - name: supplier
+      - name: Supplier
         isRoot: true
         tableName: suppliers
         auditable: true
@@ -97,7 +97,7 @@ aggregates:
           - name: rating
             type: Integer
       
-      - name: contract
+      - name: Contract
         tableName: contracts
         auditable: true
         fields:
@@ -133,7 +133,7 @@ aggregates:
   # AGREGADO 3: Inventory
   - name: Inventory
     entities:
-      - name: inventory
+      - name: Inventory
         isRoot: true
         tableName: inventory
         auditable: true
@@ -169,7 +169,7 @@ aggregates:
             cascade: [PERSIST, MERGE]
             fetch: LAZY
       
-      - name: stockMovement
+      - name: StockMovement
         tableName: stock_movements
         auditable: true
         fields:

package/examples/domain-one-to-many.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:

package/examples/domain-one-to-one.yaml

@@ -29,7 +29,7 @@ aggregates:
         relationships:
           - type: OneToOne
             target: UserProfile
-            mappedBy: User
+            mappedBy: user
             cascade: [PERSIST, MERGE, REMOVE]
             fetch: LAZY
       

package/examples/domain-secondary-onetomany.yaml

@@ -11,7 +11,7 @@
 aggregates:
   - name: Project
     entities:
-      - name: project
+      - name: Project
         isRoot: true
         tableName: projects
         audit:

package/examples/domain-secondary-onetoone.yaml

@@ -11,7 +11,7 @@
 aggregates:
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:

package/examples/domain-simple.yaml

@@ -6,7 +6,7 @@
 aggregates:
   - name: Product
     entities:
-      - name: product
+      - name: Product
         isRoot: true
         tableName: products
         auditable: true

package/examples/domain-soft-delete.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: Document
     entities:
-      - name: document
+      - name: Document
         isRoot: true
         tableName: documents
         auditable: true
@@ -48,7 +48,7 @@ aggregates:
             cascade: [PERSIST, MERGE, REMOVE]
             fetch: LAZY
       
-      - name: revision
+      - name: Revision
         tableName: document_revisions
         auditable: true
         fields:
@@ -66,7 +66,7 @@ aggregates:
             type: String
        
       
-      - name: attachment
+      - name: Attachment
         tableName: document_attachments
         auditable: true
         fields:

package/examples/domain-transitions.yaml

@@ -1,7 +1,7 @@
 aggregates:
   - name: Order
     entities:
-      - name: order
+      - name: Order
         isRoot: true
         tableName: orders
         audit:

package/examples/domain-value-objects.yaml

@@ -5,7 +5,7 @@
 aggregates:
   - name: User
     entities:
-      - name: user
+      - name: User
         isRoot: true
         tableName: users
         auditable: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eva4j",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "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": {

package/src/utils/yaml-to-entity.js

@@ -242,8 +242,71 @@ function buildAnnotationString(validation) {
   return params.length === 0 ? `@${type}` : `@${type}(${params.join(', ')})`;
 }
 
+/**
+ * Compute the Java literal for a defaultValue declared in domain.yaml.
+ * Returns a string ready to be emitted in a template (e.g. `0`, `"foo"`, `Status.ACTIVE`).
+ * Returns null for unsupported combinations — callers should guard before emitting.
+ *
+ * @param {*}       rawValue  - The raw value from YAML (string, number, boolean)
+ * @param {string}  javaType  - The resolved Java type (e.g. "String", "BigDecimal")
+ * @param {boolean} isEnum    - Whether the field type is an enum
+ * @returns {string|null}
+ */
+function computeJavaDefaultValue(rawValue, javaType, isEnum) {
+  if (rawValue === null || rawValue === undefined) return null;
+
+  const strValue = String(rawValue);
+
+  // Enum type: emit EnumType.VALUE
+  if (isEnum) {
+    return `${javaType}.${strValue}`;
+  }
+
+  switch (javaType) {
+    case 'String':
+      return `"${strValue}"`;
+    case 'Boolean':
+      return strValue.toLowerCase() === 'true' ? 'true' : 'false';
+    case 'Integer':
+    case 'int':
+      return strValue;
+    case 'Long':
+    case 'long':
+      return `${strValue}L`;
+    case 'Double':
+    case 'double':
+    case 'Float':
+    case 'float':
+      return strValue;
+    case 'BigDecimal':
+      return `new BigDecimal("${strValue}")`;
+    case 'LocalDateTime':
+      if (strValue === 'now') return 'LocalDateTime.now()';
+      return null; // arbitrary datetime strings not supported
+    case 'LocalDate':
+      if (strValue === 'now') return 'LocalDate.now()';
+      return null;
+    case 'LocalTime':
+      if (strValue === 'now') return 'LocalTime.now()';
+      return null;
+    case 'Instant':
+      if (strValue === 'now') return 'Instant.now()';
+      return null;
+    case 'UUID':
+      if (strValue === 'random') return 'UUID.randomUUID()';
+      return null;
+    default:
+      // Unknown type — cannot safely emit a literal
+      return null;
+  }
+}
+
 function parseProperty(propData, valueObjectNames = [], aggregateEnums = []) {
-  const { name, type, annotations = [], isValueObject = false, isEmbedded = false, enumValues, readOnly = false, hidden = false, validations = [], reference = null } = propData;
+  const { name, type, annotations = [], isValueObject = false, isEmbedded = false, enumValues, readOnly = false, hidden = false, validations = [], reference = null, defaultValue = null } = propData;
+
+  if (defaultValue !== null && !readOnly) {
+    console.warn(`⚠️  Field "${name}": "defaultValue" is only meaningful for readOnly fields. It will be ignored since readOnly is not set.`);
+  }
 
   if (reference !== null) {
     if (typeof reference !== 'object' || !reference.aggregate || typeof reference.aggregate !== 'string') {
@@ -308,7 +371,11 @@ function parseProperty(propData, valueObjectNames = [], aggregateEnums = []) {
     transitionMeta,
     autoInit,
     autoInitValue,
-    reference
+    reference,
+    defaultValue,
+    javaDefaultValue: (readOnly && !autoInit && defaultValue !== null)
+      ? computeJavaDefaultValue(defaultValue, javaType, !!enumValues || isEnumType)
+      : null
   };
 }
 

package/templates/aggregate/AggregateRoot.java.ejs

@@ -84,7 +84,8 @@ public class <%= name %> {
 
 <% const creationFields = fields.filter(f => f.name !== 'id' && f.name !== 'createdAt' && f.name !== 'updatedAt' && f.name !== 'createdBy' && f.name !== 'updatedBy' && !f.readOnly && !f.autoInit); %>
 <% const autoInitFields = fields.filter(f => f.autoInit); %>
-<% if (creationFields.length > 0 || autoInitFields.length > 0) { %>
+<% const defaultValueFields = fields.filter(f => f.readOnly && !f.autoInit && f.javaDefaultValue); %>
+<% if (creationFields.length > 0 || autoInitFields.length > 0 || defaultValueFields.length > 0) { %>
     // Constructor for new entity creation (without id, audit fields, readOnly and auto-initialized fields)
     public <%= name %>(<% let paramIdx = 0; %><% creationFields.forEach((field, idx) => { %><% if (paramIdx > 0) { %>, <% } %><%- field.javaType %> <%= field.name %><% paramIdx++; %><% }); %>) {
 <% creationFields.forEach(field => { %>
@@ -92,6 +93,9 @@ public class <%= name %> {
 <% }); %>
 <% autoInitFields.forEach(field => { %>
         this.<%= field.name %> = <%- field.javaType %>.<%= field.autoInitValue %>;
+<% }); %>
+<% defaultValueFields.forEach(field => { %>
+        this.<%= field.name %> = <%- field.javaDefaultValue %>;
 <% }); %>
     }
 <% } %>

package/templates/aggregate/DomainEntity.java.ejs

@@ -51,7 +51,8 @@ public class <%= name %> {
 
 <% const creationFields = fields.filter(f => f.name !== 'id' && f.name !== 'createdAt' && f.name !== 'updatedAt' && f.name !== 'createdBy' && f.name !== 'updatedBy' && !f.readOnly && !f.autoInit); %>
 <% const autoInitFields = fields.filter(f => f.autoInit); %>
-<% if (creationFields.length > 0 || autoInitFields.length > 0) { %>
+<% const defaultValueFields = fields.filter(f => f.readOnly && !f.autoInit && f.javaDefaultValue); %>
+<% if (creationFields.length > 0 || autoInitFields.length > 0 || defaultValueFields.length > 0) { %>
     // Constructor for new entity creation (without id, audit fields, readOnly and auto-initialized fields)
     public <%= name %>(<% let paramIdx = 0; %><% creationFields.forEach((field, idx) => { %><% if (paramIdx > 0) { %>, <% } %><%- field.javaType %> <%= field.name %><% paramIdx++; %><% }); %>) {
 <% creationFields.forEach(field => { %>
@@ -59,6 +60,9 @@ public class <%= name %> {
 <% }); %>
 <% autoInitFields.forEach(field => { %>
         this.<%= field.name %> = <%- field.javaType %>.<%= field.autoInitValue %>;
+<% }); %>
+<% defaultValueFields.forEach(field => { %>
+        this.<%= field.name %> = <%- field.javaDefaultValue %>;
 <% }); %>
     }
 <% } %>

package/templates/aggregate/JpaAggregateRoot.java.ejs

@@ -75,7 +75,8 @@ if (audit && audit.trackUser) {
     <% } %>@Embedded
     <% } %><% if (field.isEnum) { %>@Enumerated(EnumType.STRING)
     <% } %><% if (field.reference) { %>/** Cross-aggregate reference → <%= field.reference.aggregate %><% if (field.reference.module) { %> (module: <%= field.reference.module %>)<% } %> */
-    <% } %>private <%- field.isValueObject ? field.javaTypeJpa : field.javaType %> <%= field.name %>;
+    <% } %><% if (field.javaDefaultValue) { %>@Builder.Default
+    <% } %>private <%- field.isValueObject ? field.javaTypeJpa : field.javaType %> <%= field.name %><% if (field.javaDefaultValue) { %> = <%- field.javaDefaultValue %><% } %>;
   <% } %>
 <% }); %>
 <% relationships.forEach(rel => { %>

package/templates/aggregate/JpaEntity.java.ejs

@@ -85,7 +85,8 @@ if (audit && audit.trackUser) {
     <% } else if (field.javaType === 'Long' || field.javaType === 'Integer') { %>@GeneratedValue(strategy = GenerationType.IDENTITY)
     <% } %><% } %>@Column(name = "<%= field.name.replace(/([A-Z])/g, '_$1').toLowerCase() %>")
     <% if (field.reference) { %>/** Cross-aggregate reference → <%= field.reference.aggregate %><% if (field.reference.module) { %> (module: <%= field.reference.module %>)<% } %> */
-    <% } %>private <%- field.javaType %> <%= field.name %>;
+    <% } %><% if (field.javaDefaultValue) { %>@Builder.Default
+    <% } %>private <%- field.javaType %> <%= field.name %><% if (field.javaDefaultValue) { %> = <%- field.javaDefaultValue %><% } %>;
   <% } %>
 <% }); %>
 <% relationships.forEach(rel => { %>