Merge pull request #66

feature/upgrade-to-node-24

Author: marioserrano09

README.md

@@ -1,4 +1,3 @@
-
 [![Maven Central](https://img.shields.io/maven-central/v/tools.dynamia/tools.dynamia.app)](https://search.maven.org/search?q=tools.dynamia)
 ![Java Version Required](https://img.shields.io/badge/java-25-blue)
 ![CalVer](https://img.shields.io/badge/versioning-CalVer%20YY.MM.MINOR-blue)
@@ -8,7 +7,15 @@
 [![DynamiaTools Documentation](https://img.shields.io/badge/DynamiaTools-Documentation-orange)](https://dynamia.tools/getting-started/)
 
 
-<h1 align="center">Dynamia Platform</h1>
+
+
+<h1 align="center">
+<img src="https://raw.githubusercontent.com/dynamiatools/website/main/public/icon.png" alt="Dynamia Logo" width="150"/>
+
+Dynamia Platform
+</h1>
+
+
 
 > **The Next Generation of DynamiaTools**
 
@@ -43,7 +50,7 @@ Dynamia Platform represents a major evolution from DynamiaTools, bringing togeth
 
 By default, **Dynamia Platform automatically generates full-featured web interfaces** using **ZK Framework**, a powerful server-side component framework that eliminates the need to write JavaScript, HTML, or CSS manually. Simply define your entities and view descriptors, and ZK renders responsive, interactive UIs with zero frontend code.
 
-**Coming Soon**: In upcoming releases, Dynamia Platform will support **modern frontend frameworks** like **React**, **Vue**, and **Angular**, giving you the flexibility to choose your preferred technology stack while maintaining the same automatic generation capabilities. You'll be able to leverage our **TypeScript SDK** and pre-built components to build modern, decoupled SPAs that consume Dynamia's RESTful APIs.
+**Coming Soon**: In upcoming releases, Dynamia Platform will support additional **modern frontend frameworks** like **React** and **Angular**. **Vue 3** is already supported via [`@dynamia-tools/vue`](https://www.npmjs.com/package/@dynamia-tools/vue). You can leverage our **TypeScript SDK** and pre-built components to build modern, decoupled SPAs that consume Dynamia's RESTful APIs.
 
 ## ✨ Core Capabilities
 
@@ -78,19 +85,34 @@ We're actively working on making Dynamia Platform more accessible, flexible, and
 - Better search and navigation
 
 #### 📦 **TypeScript SDK**
-A complete TypeScript/JavaScript package ecosystem for frontend development:
-- **`@dynamia/client`** - Core client library for REST API interaction
-- **`@dynamia/types`** - TypeScript type definitions for all API responses
-- **`@dynamia/hooks`** - React hooks for common operations
-- **`@dynamia/composables`** - Vue composables for reactive integration
+A complete TypeScript/JavaScript package ecosystem for frontend development, available on npm:
+
+| Package | Description |
+|---|---|
+| **[`@dynamia-tools/sdk`](https://www.npmjs.com/package/@dynamia-tools/sdk)** | Core client library for REST API interaction |
+| **[`@dynamia-tools/ui-core`](https://www.npmjs.com/package/@dynamia-tools/ui-core)** | Framework-agnostic view/viewer/renderer core |
+| **[`@dynamia-tools/vue`](https://www.npmjs.com/package/@dynamia-tools/vue)** | Vue 3 composables and components for reactive integration |
+| **[`@dynamia-tools/cli`](https://www.npmjs.com/package/@dynamia-tools/cli)** | CLI tool for scaffolding Dynamia Platform projects |
+
+```bash
+# Install the core SDK
+npm install @dynamia-tools/sdk
+
+# Install the Vue adapter
+npm install @dynamia-tools/vue
+
+# Install the CLI globally
+npm install -g @dynamia-tools/cli
+```
+
 - Full type safety and IntelliSense support
 - Automatic API client generation from backend schema
 - WebSocket support for real-time features
 
-#### 🎨 **Vue Template**
-Modern frontend template with:
+#### 🎨 **Vue Integration** ✅ Available
+Modern Vue 3 frontend integration with:
 - Vue 3 + TypeScript + Vite
-- Pre-configured integration with Dynamia Platform APIs
+- Pre-configured integration with Dynamia Platform APIs via `@dynamia-tools/vue`
 - Responsive design with Tailwind CSS
 - Authentication and authorization out of the box
 - CRUD components library
@@ -110,7 +132,7 @@ Seamless integration with popular frameworks:
 - Built-in authentication flows
 
 #### ⚡ **Automation & Developer Experience**
-- CLI tool for scaffolding projects and modules
+- **[`@dynamia-tools/cli`](https://www.npmjs.com/package/@dynamia-tools/cli)** ✅ CLI tool for scaffolding projects and modules
 - Code generators for entities, views, and endpoints
 - Hot reload for view descriptors
 - Development dashboard for monitoring
@@ -147,13 +169,16 @@ Full-featured SaaS support with:
 - Payment and subscription handling
 - Per-tenant data segregation
 - Status monitoring and control
+- 📦 **npm:** [`@dynamia-tools/saas-sdk`](https://www.npmjs.com/package/@dynamia-tools/saas-sdk) — TypeScript/JavaScript client SDK for the SaaS REST API
 
 ### **Entity File Management**
 Attach files to any entity with:
 - Local disk storage
 - **AWS S3 integration** for cloud storage
+- **[Buckie](https://dynamia.tools/buckie/) integration** — the lightweight, filesystem-native file server built by Dynamia (see [GitHub](https://github.com/dynamiatools/buckie) · [npm `@dynamia-tools/buckie`](https://www.npmjs.com/package/@dynamia-tools/buckie))
 - Metadata persistence
 - Automatic file handling
+- 📦 **npm:** [`@dynamia-tools/files-sdk`](https://www.npmjs.com/package/@dynamia-tools/files-sdk) — TypeScript/JavaScript client SDK for the Entity Files REST API
 
 ### **Email & SMS**
 Professional communication capabilities:
@@ -178,6 +203,7 @@ Comprehensive reporting framework:
 - Email delivery
 - Chart visualization
 - Embeddable reports
+- 📦 **npm:** [`@dynamia-tools/reports-sdk`](https://www.npmjs.com/package/@dynamia-tools/reports-sdk) — TypeScript/JavaScript client SDK for the Reports REST API
 
 ### **Finance Framework**
 Domain-driven financial calculations for:
@@ -230,29 +256,29 @@ Enterprise authentication and authorization:
        <dependency>
            <groupId>tools.dynamia</groupId>
            <artifactId>tools.dynamia.app</artifactId>
-           <version>26.4.1</version>
+           <version>26.5.2</version>
        </dependency>
 
        <dependency>
            <groupId>tools.dynamia</groupId>
            <artifactId>tools.dynamia.zk</artifactId>
-           <version>26.4.1</version>
+           <version>26.5.2</version>
        </dependency>
 
        <dependency>
            <groupId>tools.dynamia</groupId>
            <artifactId>tools.dynamia.domain.jpa</artifactId>
-           <version>26.4.1</version>
+           <version>26.5.2</version>
        </dependency>
    </dependencies>
    ```
 
    **Gradle** (`build.gradle`)
    ```groovy
    dependencies {
-       implementation 'tools.dynamia:tools.dynamia.app:26.4.1'
-       implementation 'tools.dynamia:tools.dynamia.zk:26.4.1'
-       implementation 'tools.dynamia:tools.dynamia.domain.jpa:26.4.1'
+       implementation 'tools.dynamia:tools.dynamia.app:26.5.2'
+       implementation 'tools.dynamia:tools.dynamia.zk:26.5.2'
+       implementation 'tools.dynamia:tools.dynamia.domain.jpa:26.5.2'
    }
    ```
 
@@ -291,67 +317,83 @@ Enterprise authentication and authorization:
 
 ### Adding Extensions
 
-To use any of the built-in extensions, simply add their dependencies. **All extensions now share the same version (26.4.1)** thanks to unified CalVer:
+To use any of the built-in extensions, simply add their dependencies. **All extensions now share the same version (26.5.2)** thanks to unified CalVer:
 
 ```xml
 <!-- Multi-tenancy / SaaS -->
 <dependency>
     <groupId>tools.dynamia.modules</groupId>
     <artifactId>tools.dynamia.modules.saas</artifactId>
-    <version>26.4.1</version>
+    <version>26.5.2</version>
 </dependency>
 
 <!-- Email & SMS -->
 <dependency>
     <groupId>tools.dynamia.modules</groupId>
     <artifactId>tools.dynamia.modules.email</artifactId>
-    <version>26.4.1</version>
+    <version>26.5.2</version>
 </dependency>
 
 <!-- Entity Files with S3 Support -->
 <dependency>
     <groupId>tools.dynamia.modules</groupId>
     <artifactId>tools.dynamia.modules.entityfiles</artifactId>
-    <version>26.4.1</version>
+    <version>26.5.2</version>
 </dependency>
 <dependency>
     <groupId>tools.dynamia.modules</groupId>
     <artifactId>tools.dynamia.modules.entityfiles.s3</artifactId>
-    <version>26.4.1</version>
+    <version>26.5.2</version>
 </dependency>
 
 <!-- Dashboard -->
 <dependency>
     <groupId>tools.dynamia.modules</groupId>
     <artifactId>tools.dynamia.modules.dashboard</artifactId>
-    <version>26.4.1</version>
+    <version>26.5.2</version>
 </dependency>
 
 <!-- Reporting -->
 <dependency>
     <groupId>tools.dynamia.reports</groupId>
     <artifactId>tools.dynamia.reports.core</artifactId>
-    <version>26.4.1</version>
+    <version>26.5.2</version>
 </dependency>
 
 <!-- File Importer -->
 <dependency>
     <groupId>tools.dynamia.modules</groupId>
     <artifactId>tools.dynamia.modules.fileimporter</artifactId>
-    <version>26.4.1</version>
+    <version>26.5.2</version>
 </dependency>
 
 <!-- Security -->
 <dependency>
     <groupId>tools.dynamia.modules</groupId>
     <artifactId>tools.dynamia.modules.security</artifactId>
-    <version>26.4.1</version>
+    <version>26.5.2</version>
 </dependency>
 ```
 
-> **💡 Pro Tip**: With CalVer, all Dynamia Platform components use the same version. Just use `26.4.1` for everything!
+For extensions that expose a REST API, install their **TypeScript/JavaScript SDK** from npm:
+
+```bash
+# Multi-tenancy / SaaS SDK
+npm install @dynamia-tools/saas-sdk
+
+# Entity Files SDK (works with local, S3 and Buckie storage)
+npm install @dynamia-tools/files-sdk
+
+# Reporting SDK
+npm install @dynamia-tools/reports-sdk
+
+# Buckie file server (standalone or as Dynamia storage backend)
+npm install @dynamia-tools/buckie
+```
+
+> **💡 Pro Tip**: With CalVer, all Dynamia Platform components use the same version. Just use `26.5.2` for everything!
 
-> **Note**: All artifacts are available on [Maven Central](https://search.maven.org/search?q=tools.dynamia)
+> **Note**: All artifacts are available on [Maven Central](https://search.maven.org/search?q=tools.dynamia) and npm packages on [npmjs.com](https://www.npmjs.com/search?q=%40dynamia-tools)
 
 ## 📚 Documentation
 
@@ -472,7 +514,7 @@ Java 11+ and ecosystem update:
 - 🚀 **Spring Boot 4** - Next-gen Spring ecosystem
 - 🎨 **ZK 10+** - Modern web UI capabilities
 - 🔄 **Synchronized Releases** - Core, extensions, starters, and themes share the same version
-- 🎯 **Simplified Dependencies** - One version to rule them all (e.g., 26.4.1 for February 2026)
+- 🎯 **Simplified Dependencies** - One version to rule them all (e.g., 26.5.2 for February 2026)
 - ⚡ **Enhanced Performance** - Optimized for modern JVM and cloud environments
 - 🛡️ **Production Hardened** - Battle-tested in enterprise environments
 

examples/demo-vue-books/package.json

@@ -17,10 +17,9 @@
     "vue": "^3.5.13"
   },
   "devDependencies": {
-    "@vitejs/plugin-vue": "^5.2.3",
+    "@vitejs/plugin-vue": "^6.0.0",
     "typescript": "^5.7.3",
-    "vite": "^6.2.0",
+    "vite": "^8.0.0",
     "vue-tsc": "^2.2.0"
   }
 }
-

examples/demo-zk-books/pom.xml

@@ -47,7 +47,7 @@
         <timestamp>${maven.build.timestamp}</timestamp>
         <maven.build.timestamp.format>yyyyMMdd</maven.build.timestamp.format>
 
-        <tools.version>26.5.1</tools.version>
+        <tools.version>26.5.2</tools.version>
 
     </properties>
 

extensions/dashboard/sources/pom.xml

@@ -23,7 +23,7 @@
     <parent>
         <groupId>tools.dynamia.modules</groupId>
         <artifactId>tools.dynamia.modules.parent</artifactId>
-        <version>26.5.1</version>
+        <version>26.5.2</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
 
@@ -38,12 +38,12 @@
         <dependency>
             <groupId>tools.dynamia</groupId>
             <artifactId>tools.dynamia.zk</artifactId>
-            <version>26.5.1</version>
+            <version>26.5.2</version>
         </dependency>
         <dependency>
             <groupId>tools.dynamia.modules</groupId>
             <artifactId>tools.dynamia.modules.saas.api</artifactId>
-            <version>26.5.1</version>
+            <version>26.5.2</version>
         </dependency>
     </dependencies>
 

extensions/email-sms/sources/core/pom.xml

@@ -23,7 +23,7 @@
     <parent>
         <artifactId>tools.dynamia.modules.email.parent</artifactId>
         <groupId>tools.dynamia.modules</groupId>
-        <version>26.5.1</version>
+        <version>26.5.2</version>
     </parent>
 
     <artifactId>tools.dynamia.modules.email</artifactId>
@@ -50,12 +50,12 @@
         <dependency>
             <groupId>tools.dynamia</groupId>
             <artifactId>tools.dynamia.domain.jpa</artifactId>
-            <version>26.5.1</version>
+            <version>26.5.2</version>
         </dependency>
         <dependency>
             <groupId>tools.dynamia</groupId>
             <artifactId>tools.dynamia.templates</artifactId>
-            <version>26.5.1</version>
+            <version>26.5.2</version>
         </dependency>
         <dependency>
             <groupId>org.springframework</groupId>

extensions/email-sms/sources/pom.xml

@@ -23,7 +23,7 @@
     <parent>
         <groupId>tools.dynamia.modules</groupId>
         <artifactId>tools.dynamia.modules.parent</artifactId>
-        <version>26.5.1</version>
+        <version>26.5.2</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
 
@@ -85,7 +85,7 @@
         <dependency>
             <groupId>tools.dynamia.modules</groupId>
             <artifactId>tools.dynamia.modules.saas.jpa</artifactId>
-            <version>26.5.1</version>
+            <version>26.5.2</version>
         </dependency>
 
 

extensions/email-sms/sources/ui/pom.xml

@@ -22,7 +22,7 @@
 	<parent>
 		<artifactId>tools.dynamia.modules.email.parent</artifactId>
 		<groupId>tools.dynamia.modules</groupId>
-		<version>26.5.1</version>
+		<version>26.5.2</version>
 	</parent>
 
 	<name>DynamiaModules - Email UI</name>
@@ -34,12 +34,12 @@
 		<dependency>
 			<groupId>tools.dynamia</groupId>
 			<artifactId>tools.dynamia.zk</artifactId>
-			<version>26.5.1</version>
+			<version>26.5.2</version>
 		</dependency>
 		<dependency>
 			<groupId>tools.dynamia.modules</groupId>
 			<artifactId>tools.dynamia.modules.email</artifactId>
-			<version>26.5.1</version>
+			<version>26.5.2</version>
 		</dependency>
 		<dependency>
 			<groupId>tools.dynamia.zk.addons</groupId>

extensions/entity-files/packages/files-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamia-tools/files-sdk",
-  "version": "26.5.1",
+  "version": "26.5.2",
   "website": "https://dynamia.tools",
   "description": "TypeScript/JavaScript client SDK for the Dynamia Entity Files extension REST API",
   "keywords": [
@@ -65,11 +65,14 @@
   },
   "devDependencies": {
     "@dynamia-tools/sdk": "workspace:*",
-    "@types/node": "^22.0.0",
+    "@types/node": "^24.0.0",
     "typescript": "^5.7.0",
-    "vite": "^6.2.0",
-    "vite-plugin-dts": "^4.5.0",
-    "vitest": "^3.0.0",
-    "@vitest/coverage-v8": "^3.0.0"
+    "vite": "^8.0.0",
+    "vite-plugin-dts": "^5.0.0",
+    "vitest": "^4.0.0",
+    "@vitest/coverage-v8": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=24"
   }
 }