divhunt 2.0.6 → 2.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "divhunt",
-    "version": "2.0.6",
+    "version": "2.0.9",
     "description": "Full-stack isomorphic JavaScript framework built from scratch. One addon abstraction powers databases, servers, commands, pages, directives, queues, and more.",
     "type": "module",
     "main": "lib/load.js",
@@ -13,7 +13,7 @@
         "./servers/http": "./addons/core/servers/back/http/load.js",
         "./clients/grpc": "./addons/core/clients/back/grpc/load.js",
         "./clients/http": "./addons/core/clients/back/http/load.js",
-        "./commands": "./addons/core/commands/back/load.js",
+        "./commands": "./addons/core/commands/core/load.js",
         "./queue": "./addons/core/queue/back/load.js",
         "./assets": "./addons/render/assets/back/load.js",
         "./html": "./addons/render/html/load.js",
@@ -26,7 +26,7 @@
         "#database/*": "./addons/core/database/back/*",
         "#servers/*": "./addons/core/servers/back/*",
         "#clients/*": "./addons/core/clients/back/*",
-        "#commands/*": "./addons/core/commands/back/*",
+        "#commands/*": "./addons/core/commands/*",
         "#queue/*": "./addons/core/queue/back/*",
         "#assets/*": "./addons/render/assets/back/*",
         "#html/*": "./addons/render/html/*",

package/test/front/test.js

@@ -0,0 +1,31 @@
+pages.Item({
+    id: 'home',
+    route: '/',
+    title: 'dh-command test',
+    grid: {
+        template: '"content"',
+        columns: '1fr',
+        rows: '1fr'
+    },
+    areas: {
+        content: function()
+        {
+            return `
+                {{ name }}
+                <h1>dh-command test</h1>
+
+                <dh-command command="test" :api="true" bind="test2" :data='{"name": "dejan"}'>
+                    <p dh-if="test.loading">Loading...</p>
+                    <p dh-if="test.error">Error: {{test.error}}</p>
+                    <p dh-if="test.response">{{test.response.message}}</p>
+                </dh-command>
+
+                <dh-command command="test" :api="true" bind="test" :data='{"name": "dejan"}'>
+                    <p dh-if="test.loading">Loading...</p>
+                    <p dh-if="test.error">Error: {{test.error}}</p>
+                    <p dh-if="test.response">{{test.response.message}}</p>
+                </dh-command>
+            `;
+        }
+    }
+});

package/test.js

@@ -0,0 +1,52 @@
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)));
+
+import assets from './addons/render/assets/back/load.js';
+import commands from './addons/core/commands/core/load.js';
+import html from './addons/render/html/load.js';
+
+assets.Fn('import', ['framework', 'directives', 'commands', 'pages']);
+assets.Item({ type: 'js', order: 10, path: resolve(root, 'test/front') });
+assets.Item({ type: 'css', order: 10, path: resolve(root, 'test/front') });
+
+commands.Item({
+    id: 'html',
+    exposed: true,
+    method: 'GET',
+    endpoint: '*',
+    type: 'HTML',
+    callback: async function(properties, resolve)
+    {
+        resolve(html.Fn('render'));
+    }
+});
+
+commands.Item({
+    id: 'test',
+    exposed: true,
+    method: 'POST',
+    endpoint: '/api/test',
+    type: 'JSON',
+    in: {
+        name: ['string', 'World']
+    },
+    out: {
+        message: ['string']
+    },
+    callback: async function(properties, resolve)
+    {
+        resolve({ message: 'Hello, ' + properties.name + '!' });
+    }
+});
+
+
+commands.Fn('expose', 'commands:run', '/api/commands/run');
+
+await commands.Fn('http.server', 3000, {
+    onStart: () =>
+    {
+        console.log('test server running on http://localhost:3000');
+    }
+});

package/addons/core/commands/LICENSE.txt

@@ -1,40 +0,0 @@
-Copyright © 2025 Divhunt GmbH
-
-This License governs use of the Divhunt framework (the "Software"). By accessing or using the Software, you agree to be bound by the terms of this License.
-
-1. GRANT OF LICENSE  
-   You are granted a limited, non-exclusive, non-transferable, non-sublicensable license to use the Software solely for:
-   - personal projects;
-   - internal business purposes;
-   - client work, provided the client is not reselling or redistributing the Software.
-
-2. ATTRIBUTION AND BRANDING  
-   a. All uses of the Software must retain visible attribution to “Divhunt”.  
-   b. You must not remove, obscure, alter, or suppress any branding, notices, or credits related to Divhunt.  
-   c. Any public project using the Software must clearly state that it uses the “Divhunt Framework”.
-
-3. PROHIBITED USES  
-   The following are strictly prohibited:  
-   a. Rebranding, renaming, or representing the Software as your own work;  
-   b. Creating derivative frameworks or similar software tools based on the Software with the intent of distribution;  
-   c. Redistributing, sublicensing, or selling the Software or any modified version thereof;  
-   d. Using the Software in any commercial product, service, or offering without explicit, written permission from Divhunt GmbH.
-
-4. MODIFICATIONS  
-   You may modify the Software for personal or internal use only. Modified versions may not be:  
-   - redistributed;  
-   - rebranded or marketed as original work;  
-   - offered as a service or product.
-
-5. ENFORCEMENT AND TERMINATION  
-   Any violation of this License will result in the immediate termination of all rights granted herein. Divhunt GmbH reserves the right to pursue legal remedies including but not limited to damages, injunctions, and recovery of profits obtained through unauthorized use.
-
-6. NO WARRANTY  
-   THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL JOVANAT GMBH BE LIABLE FOR ANY DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE.
-
-7. GOVERNING LAW  
-   This License shall be governed by and construed in accordance with the laws of Switzerland. All disputes shall be subject to the exclusive jurisdiction of the courts of Zug, Switzerland.
-
----
-
-For commercial licensing or other questions, please contact: **dejan@divhunt.com**

package/addons/core/commands/README.md

@@ -1,294 +0,0 @@
-## Built with the Divhunt Framework – non-commercial use only. For commercial use, contact dejan@divhunt.com.
-
-# Commands Addon
-
-The Commands addon provides a structured way to define and manage API endpoints with automatic validation, routing, and response formatting.
-
-## Basic Usage
-
-### Creating a Command
-
-```javascript
-import commands from '#commands/load.js';
-
-commands.Item({
-    id: 'users:create',
-    method: 'POST',
-    endpoint: '/api/users',
-    type: 'JSON',
-    description: 'Create a new user',
-    in: {
-        name: ['string', null, true],
-        email: ['string', null, true],
-        age: ['number']
-    },
-    out: {
-        user: {
-            type: 'object',
-            config: {
-                id: ['string'],
-                name: ['string'],
-                email: ['string']
-            }
-        }
-    },
-    callback: async function(properties, resolve) {
-        // Your logic here
-        const user = createUser(properties);
-        resolve({user});
-    }
-});
-```
-
-## Command Properties
-
-### Required Fields
-
-- **id** - Unique identifier for the command
-- **callback** - Function that executes the command logic
-
-### Optional Fields
-
-- **method** - HTTP method (`GET`, `POST`, `PUT`, `DELETE`). Default: `GET`
-- **endpoint** - URL pattern (supports route parameters with `:param`)
-- **type** - Response type (`JSON`, `HTML`, `CSS`, `JSS`). Default: `JSON`
-- **description** - Human-readable description
-- **in** - Input validation schema
-- **out** - Output validation schema
-
-## Route Parameters
-
-Use `:parameter` syntax in endpoints to capture URL segments:
-
-```javascript
-commands.Item({
-    id: 'users:get:one',
-    method: 'GET',
-    endpoint: '/api/users/:id',
-    in: {
-        id: ['string', null, true]
-    },
-    callback: async function(properties, resolve) {
-        // properties.id contains the URL parameter
-        const user = await findUser(properties.id);
-        resolve({user});
-    }
-});
-```
-
-## Input Validation
-
-Define input schemas to automatically validate request data:
-
-```javascript
-// Simple validation
-in: {
-    name: ['string', null, true], // required string
-    age: ['number', 18],          // optional number, default 18
-    active: ['boolean', true]     // optional boolean, default true
-}
-
-// Complex validation
-in: {
-    user: {
-        type: 'object',
-        config: {
-            profile: {
-                type: 'object',
-                config: {
-                    name: ['string', null, true],
-                    contacts: {
-                        type: 'array',
-                        each: {
-                            type: 'object',
-                            config: {
-                                type: ['string'],
-                                value: ['string']
-                            }
-                        }
-                    }
-                }
-            }
-        }
-    }
-}
-
-// Using predefined schemas
-in: 'user --skip=id --skip=created_at'
-```
-
-## Output Validation
-
-Define output schemas to validate and format responses:
-
-```javascript
-out: {
-    users: {
-        type: 'array',
-        each: {
-            type: 'object',
-            config: {
-                id: ['string'],
-                name: ['string'],
-                email: ['string']
-            }
-        }
-    },
-    total: ['number', null, true],
-    page: ['number', null, true]
-}
-```
-
-## Callback Function
-
-The callback receives two parameters:
-
-```javascript
-callback: async function(properties, resolve) {
-    // properties - validated input data
-    // resolve(data, message, code) - response function
-    
-    try {
-        const result = await doSomething(properties);
-        resolve(result); // Success with default message and 200 code
-    } catch (error) {
-        resolve(null, 'Error occurred', 500);
-    }
-}
-```
-
-### Resolve Function
-
-```javascript
-resolve(data, message, code)
-```
-
-- **data** - Response data (will be validated against `out` schema)
-- **message** - Response message (optional, has default)
-- **code** - HTTP status code (optional, default: 200)
-
-## Finding Commands
-
-### Find by Method and Path
-
-```javascript
-const command = commands.Fn('find', 'GET', '/api/users/123');
-```
-
-## Running Commands
-
-```javascript
-const command = commands.ItemGet('users:create');
-const result = await command.Fn('run', inputData, context);
-
-// Returns:
-// {
-//     data: {...},      // Validated output
-//     message: "...",   // Success/error message  
-//     code: 200         // HTTP status code
-// }
-```
-
-## Response Types
-
-### JSON (Default)
-
-```javascript
-type: 'JSON' // Returns application/json
-```
-
-### HTML
-
-```javascript
-type: 'HTML' // Returns text/html
-```
-
-### CSS
-
-```javascript
-type: 'CSS' // Returns text/css  
-```
-
-### JavaScript
-
-```javascript
-type: 'JSS' // Returns application/javascript
-```
-
-## Built-in Commands
-
-The addon includes two built-in commands:
-
-### List All Commands
-
-```
-GET /api/commands
-```
-
-Returns all registered commands with their metadata.
-
-### Get Single Command
-
-```
-GET /api/commands/:id
-```
-
-Returns details for a specific command.
-
-## Data Type Hints
-
-Use type hints in property names for automatic conversion:
-
-```javascript
-// URL: /api/users?age:number=25&active:boolean=true&tags:array=tag1,tag2
-
-// Converts to:
-// {
-//     age: 25,           // number
-//     active: true,      // boolean  
-//     tags: ['tag1', 'tag2'] // array
-// }
-```
-
-Available hints:
-- `:number` - Convert to number
-- `:string` - Convert to string
-- `:boolean` - Convert to boolean (`true`, `1`, `false`, `0`)
-- `:array` - Convert to array (comma-separated or JSON)
-- `:object` - Convert to object (JSON)
-
-## Error Handling
-
-Commands automatically handle validation errors and return appropriate error responses:
-
-```javascript
-// Input validation error
-{
-    data: "Error message",
-    message: "Request contains invalid parameters.",
-    code: 400
-}
-
-// Command not found
-{
-    data: {},
-    message: "Command does not exist.",
-    code: 404
-}
-
-// Server error
-{
-    data: {},
-    message: "Command could not be completed.",
-    code: 500
-}
-```
-
-## Best Practices
-
-1. **Use descriptive IDs** - Follow pattern `resource:action` or `resource:action:modifier`
-2. **Validate inputs** - Always define `in` schema for data integrity
-3. **Handle errors gracefully** - Use try/catch and appropriate error codes
-4. **Use route parameters** - Prefer `/users/:id` over query parameters for resources
-5. **Document commands** - Add meaningful descriptions
-6. **Consistent responses** - Use standard response format across commands# commands

package/addons/core/commands/back/load.js

@@ -1,18 +0,0 @@
-import commands from './addon.js';
-
-import './functions/find.js';
-import './item/functions/run.js';
-
-/* gRPC */
-import './functions/grpc/server.js';
-import './functions/grpc/client.js';
-
-/* HTTP */
-import './functions/http/server.js';
-
-/* Items */
-import './items/one.js';
-import './items/many.js';
-import './items/run.js';
-
-export default commands;

package/addons/core/commands/front/#register/addon.js

@@ -1,9 +0,0 @@
-const commands = divhunt.Addon('commands', (addon) =>
-{
-    addon.Field('id', ['string']);
-    addon.Field('type', ['string', 'JSON']);
-    addon.Field('description', ['string']);
-    addon.Field('in', ['object|string']);
-    addon.Field('out', ['object|string']);
-    addon.Field('callback', ['function']);
-});

package/addons/core/commands/front/functions/find.js

@@ -1,22 +0,0 @@
-commands.Fn('find', function(method, pathname)
-{
-    const items = Object.values(this.Items());
-
-    for (const item of items)
-    {
-        if (item.Get('method') !== method)
-        {
-            continue;
-        }
-
-        const endpoint = item.Get('endpoint');
-        const result = divhunt.RouteMatch(endpoint, pathname);
-
-        if (result.match)
-        {
-            return item;
-        }
-    }
-
-    return null;
-});

package/addons/core/commands/front/item/functions/run.js

@@ -1,96 +0,0 @@
-commands.Fn('item.run', function(item, properties = {}, context = {})
-{
-    this.methods.resolve = null;
-    this.methods.reject = null;
-
-    this.methods.init = async (resolve, reject) => 
-    {
-        this.methods.resolve = resolve;
-        this.methods.reject = reject;
-        
-        if(item.Get('in'))
-        {
-            try 
-            {
-                properties = divhunt.DataDefine(properties, item.Get('in'));
-            }
-            catch(error)
-            {
-                return this.methods.resolve({data: error.message, message: 'Request contains invalid parameters.', code: 400});
-            }
-        }
-
-        if(item.Get('callback'))
-        {
-            await item.Get('callback').call(context, properties, {callback: this.methods.callback});
-        }
-        else
-        {
-            const options = {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json'
-                },
-                body: JSON.stringify({
-                    id: item.Get('id'),
-                    in: properties
-                })
-            };
-
-            try 
-            {
-                const response = await fetch('/api/commands/run', options);
-                const result = await response.json();
-
-                if(result.code !== 200)
-                {
-                    throw new Error(result.message);
-                }
-
-                return this.methods.callback(result.data.data, result.data.message, result.data.code);
-            }
-            catch(error)
-            {
-                return this.methods.callback(null, error.message, 500);
-            }
-        }
-    };
-
-    this.methods.callback = (data, message = "Command '{{command}}' executed successfully.", code = 200) => 
-    {
-        if(message === null && code === 404)
-        {
-            message = 'The requested resource cannot be found.';
-        }
-
-        if(code >= 200 && code < 300 && item.Get('out'))
-        {
-            try 
-            {
-                data = divhunt.DataDefine(data, item.Get('out'));
-            }
-            catch(error)
-            {
-                throw new Error('Command OUT Error. ' + error.message);
-            }
-        }
-        else if(code < 200 || code >= 300)
-        {
-            data = {};
-        }
-
-        this.methods.resolve({data, message: message?.replace('{{command}}', item.Get('id')), code});
-    };
-
-    return new Promise((resolve, reject) => 
-    {
-        try 
-        {
-            this.methods.init(resolve, reject);    
-        }
-        catch(error)
-        {
-            this.methods.resolve({data: error.message, message: 'Internal server error.', code: 500});
-        }
-    });
-});

package/addons/core/commands/front/items/elements/table/table.css

@@ -1,18 +0,0 @@
-/* Base */
-.e-cmd-table > .holder
-{
-	display: flex;
-	flex-direction: column;
-}
-
-.e-cmd-table > .holder > .error
-{
-	display: flex;
-	align-items: center;
-	justify-content: center;
-	padding: var(--dh-spacing-l);
-	color: var(--dh-red);
-	font-size: var(--dh-size-m);
-	background: var(--dh-red-opacity);
-	border-radius: var(--dh-radius-m);
-}