@onetype/framework 2.0.21 → 2.0.24

package/addons/core/database/README.md

@@ -1,276 +0,0 @@
-# Database Service
-
-A comprehensive database abstraction layer built on top of Knex.js providing a powerful query builder, CRUD operations, and relationship management for PostgreSQL databases.
-
-## Features
-
-- **Advanced Query Builder** - Fluent API for complex queries with filtering, sorting, pagination
-- **CRUD Operations** - Create, read, update, delete with automatic timestamp management
-- **Relationship Management** - One-to-one and one-to-many relationship handling
-- **Transaction Support** - Database transaction wrapper for atomic operations
-- **Validation** - Built-in field and parameter validation
-- **Connection Management** - Automatic PostgreSQL connection pooling via Knex.js
-- **Middleware Integration** - Seamless integration with framework middleware system
-
-## Installation
-
-```javascript
-import database from '#database/load.js';
-```
-
-## Configuration
-
-Create a database connection item:
-
-```javascript
-const dbConnection = database.ItemAdd({
-    hostname: 'localhost',
-    port: 5432,
-    username: 'postgres',
-    password: 'password',
-    database: 'myapp'
-});
-```
-
-## Framework Integration
-
-The database service integrates seamlessly with the framework's middleware system. Each addon automatically gets `Find()` method, and each item gets `Create()`, `Update()`, `Delete()` methods that call middleware interceptors.
-
-### Addon Methods
-
-```javascript
-// Every addon has a Find() method
-const users = await userAddon.Find()
-    .filter('status', 'active')
-    .many();
-```
-
-### Item Methods
-
-```javascript
-// Every item has CRUD methods
-await userItem.Create('primary');    // Creates new record
-await userItem.Update('primary');    // Updates existing record  
-await userItem.Delete('primary');    // Deletes record
-```
-
-These methods work by calling middleware interceptors:
-
-```javascript
-// How item methods work internally
-const AddonItemCrud = {
-    async Create(connection = 'primary') {
-        const value = {item: this, table: this.addon.TableGet(), response: null, connection};
-        await this.addon.onetype.Middleware('item.crud.create', value);
-        return value.response;
-    },
-
-    async Update(connection = 'primary') {
-        const value = {item: this, table: this.addon.TableGet(), response: null, connection};
-        await this.addon.onetype.Middleware('item.crud.update', value);
-        return value.response;
-    },
-
-    async Delete(connection = 'primary') {
-        const value = {item: this, table: this.addon.TableGet(), response: null, connection};
-        await this.addon.onetype.Middleware('item.crud.delete', value);
-        return value.response;
-    }
-};
-```
-
-The database service intercepts these middleware calls:
-- `item.crud.create` → `database.Fn('create')`
-- `item.crud.update` → `database.Fn('update')`  
-- `item.crud.delete` → `database.Fn('delete')`
-- `addon.items.find` → `database.Fn('find')`
-
-## Basic Usage
-
-### Finding Records
-
-```javascript
-// Simple find
-const users = await database.Fn('find', connection, table, addon)
-    .filter('status', 'active')
-    .many();
-
-// Complex filtering
-const results = await database.Fn('find', connection, table, addon)
-    .filter('age', 18, 'GREATER EQUALS')
-    .filter('name', 'John%', 'LIKE')
-    .sort('created_at', 'desc')
-    .limit(10)
-    .page(2)
-    .many();
-
-// Grouped conditions
-const users = await database.Fn('find', connection, table, addon)
-    .group('OR')
-        .filter('status', 'premium')
-        .filter('trial_expires', new Date(), 'GREATER')
-    .end()
-    .filter('active', true)
-    .many();
-```
-
-### CRUD Operations
-
-```javascript
-// Framework integration - automatic methods on items
-await userItem.Create('primary');
-await userItem.Update('primary');  
-await userItem.Delete('primary');
-
-// Direct database service usage
-await database.Fn('create', connection, table, item);
-await database.Fn('update', connection, table, item);
-await database.Fn('delete', connection, table, item);
-
-// Item-level functions (bypassing middleware)
-await item.save();
-await item.create(addon);
-await item.update();
-await item.delete();
-```
-
-### Framework vs Direct Usage
-
-```javascript
-// Framework way (goes through middleware)
-const user = userAddon.ItemAdd({name: 'John', email: 'john@example.com'});
-await user.Create('primary');
-
-// Direct way (bypasses middleware)  
-const user = userAddon.ItemAdd({name: 'John', email: 'john@example.com'});
-await user.save();
-
-// Both achieve the same result, framework way allows middleware interception
-```
-
-### Item-Level Operations
-
-```javascript
-// Direct item operations
-await item.create(addon);
-await item.update();
-await item.delete();
-await item.save();
-
-// Find related items
-const user = await item.relation('user_id', userAddon);
-const comments = await item.relations('post_id', commentAddon);
-```
-
-## Query Methods
-
-### Filters
-
-| Operator | Description | Example |
-|----------|-------------|---------|
-| `EQUALS` | Exact match (default) | `.filter('status', 'active')` |
-| `NOT EQUALS` | Not equal | `.filter('status', 'inactive', 'NOT EQUALS')` |
-| `GREATER` | Greater than | `.filter('age', 18, 'GREATER')` |
-| `LESS` | Less than | `.filter('price', 100, 'LESS')` |
-| `LIKE` | Pattern matching | `.filter('name', 'John%', 'LIKE')` |
-| `IN` | Value in list | `.filter('status', ['active', 'pending'], 'IN')` |
-| `BETWEEN` | Between values | `.filter('age', [18, 65], 'BETWEEN')` |
-| `NULL` | Is null | `.filter('deleted_at', null, 'NULL')` |
-
-### Query Builder Methods
-
-```javascript
-const query = database.Fn('find', connection, table, addon);
-
-// Filtering
-query.filter(field, value, operator)
-query.orFilter(field, value, operator)
-
-// Grouping
-query.group('AND|OR')
-    .filter(...)
-    .filter(...)
-.end()
-
-// Sorting & Pagination
-query.sort(field, 'asc|desc')
-query.limit(count)
-query.page(number)
-
-// Selection
-query.select(['field1', 'field2'])
-query.distinct()
-
-// Execution
-await query.many()      // Get multiple records
-await query.one()       // Get single record
-await query.count()     // Get count
-await query.exists()    // Check if exists
-```
-
-## Transactions
-
-```javascript
-await item.transaction(async (trx) => {
-    await database.Fn('create', trx, table1, item1);
-    await database.Fn('update', trx, table2, item2);
-    // Auto-commit on success, auto-rollback on error
-});
-```
-
-## Relationships
-
-```javascript
-// One-to-one relationship
-const user = await post.relation('user_id', userAddon);
-
-// One-to-many relationship  
-const comments = await post.relations('post_id', commentAddon);
-```
-
-## Validation
-
-The service includes automatic validation for:
-- Field names (alphanumeric + underscore + dot, max 64 chars)
-- Operators (must be from supported list)
-- Values (string, number, boolean, or null)
-- Pagination parameters (positive integers)
-- Sort directions ('asc' or 'desc')
-
-## Error Handling
-
-All operations include comprehensive error handling with descriptive messages:
-
-```javascript
-try {
-    const results = await query.filter('invalid-field!', 'value').many();
-} catch (error) {
-    // Error: Invalid field name format: 'invalid-field!'...
-}
-```
-
-## Architecture
-
-The service uses a layered architecture:
-
-1. **Item Functions** - Core database operations
-2. **Main Functions** - Thin wrappers calling item functions  
-3. **Middleware** - Framework integration layer
-4. **Query Builder** - Fluent API for complex queries
-
-This design ensures code reuse and maintains consistency across all access patterns.
-
-## Connection Management
-
-Connections are automatically managed with:
-- Connection pooling (0-25 connections)
-- 1-second timeouts for acquisition and idle
-- Automatic cleanup and error handling
-
-## Data Schemas
-
-The service defines validation schemas for:
-- `filter` - Query filter structure
-- `query` - Complete query parameters
-
-These ensure type safety and parameter validation throughout the system.

package/addons/render/assets/back/README.md

@@ -1 +0,0 @@
-# assets

package/addons/render/assets/back/functions/import.js

@@ -1,45 +0,0 @@
-import assets from '../addon.js';
-
-import { dirname, resolve } from 'path';
-import { fileURLToPath } from 'url';
-
-const root = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', '..', '..');
-
-const map =
-{
-    framework:  { js: 'lib', ignore: ['lib/load.js'] },
-    commands:   { js: 'addons/core/commands', ignore: ['addons/core/commands/back'] },
-    database:   { js: 'addons/core/database/front' },
-    actions:    { js: 'addons/modules/actions/front' },
-    variables:  { js: 'addons/modules/variables' },
-    bugs:       { js: 'addons/modules/bugs/front' },
-    events:     { js: 'addons/modules/events/front' },
-    schedules:  { js: 'addons/modules/schedules/front' },
-    shortcuts:  { js: 'addons/modules/shortcuts/front' },
-    sources:    { js: 'addons/modules/sources/front' },
-    directives: { js: 'addons/render/directives/front' },
-    transforms: { js: 'addons/render/transforms/front' },
-    pages:      { js: 'addons/render/pages', css: 'addons/render/pages/front' },
-    elements:   { js: 'addons/render/elements/front', css: 'addons/render/elements/front' },
-    float:      { js: 'addons/float', css: 'addons/float' }
-};
-
-assets.Fn('import', function(modules)
-{
-    for (let i = 0; i < modules.length; i++)
-    {
-        const config = map[modules[i]];
-
-        if (!config) continue;
-
-        if (config.js)
-        {
-            assets.Item({ type: 'js', order: i, path: resolve(root, config.js), ignore: config.ignore || [] });
-        }
-
-        if (config.css)
-        {
-            assets.Item({ type: 'css', order: i, path: resolve(root, config.css) });
-        }
-    }
-});

package/addons/render/items/js/#register/addon.js

@@ -1,14 +0,0 @@
-const items = onetype.Addon('items', (addon) =>
-{
-    addon.Field('id', ['string|number']);
-
-    addon.Field('group', ['string']);
-    addon.Field('order', ['number', 0]);
-
-    addon.Field('before', ['string|number']);
-    addon.Field('after', ['string|number']);
-
-    addon.Field('data', ['object', {}]);
-    addon.Field('render', ['function']);
-    addon.Field('condition', ['function']);
-});

package/addons/render/items/js/functions/count.js

@@ -1,9 +0,0 @@
-items.Fn('count', function(group = null)
-{
-	if(!group)
-	{
-		return Object.keys(this.Items()).length;
-	}
-
-	return Object.values(this.Items()).filter(item => item.Get('group') === group).length;
-});

package/addons/render/items/js/functions/get.js

@@ -1,34 +0,0 @@
-items.Fn('get', function(group, options = {})
-{
-	const {
-		order = true,
-		data = true,
-		condition = true
-	} = options;
-
-	let result = Object.values(this.Items()).filter(item => item.Get('group') === group);
-
-	// Apply condition filter if enabled
-	if(condition)
-	{
-		result = result.filter(item =>
-		{
-			const cond = item.Get('condition');
-			return !cond || cond(item);
-		});
-	}
-
-	// Sort by order if enabled
-	if(order)
-	{
-		result = result.sort((a, b) => a.Get('order') - b.Get('order'));
-	}
-
-	// Return only data if enabled, otherwise return items
-	if(data)
-	{
-		result = result.map(item => item.Get('data'));
-	}
-
-	return result;
-});

package/addons/render/items/js/functions/groups.js

@@ -1,16 +0,0 @@
-items.Fn('groups', function()
-{
-	const groups = new Set();
-
-	Object.values(this.Items()).forEach(item =>
-	{
-		const group = item.Get('group');
-		
-		if(group)
-		{
-			groups.add(group);
-		}
-	});
-
-	return Array.from(groups).sort();
-});

package/addons/render/items/js/functions/render.js

@@ -1,44 +0,0 @@
-items.Fn('renderGroup', function(group, options = {})
-{
-	const {
-		order = true,
-		condition = true,
-		wrapper = null
-	} = options;
-
-	let result = Object.values(this.Items())
-		.filter(item => item.Get('group') === group && item.Get('render'));
-
-	// Apply condition filter if enabled
-	if(condition)
-	{
-		result = result.filter(item =>
-		{
-			const cond = item.Get('condition');
-			return !cond || cond(item);
-		});
-	}
-
-	// Sort by order if enabled
-	if(order)
-	{
-		result = result.sort((a, b) => a.Get('order') - b.Get('order'));
-	}
-
-	// Render all items
-	const rendered = result.map(item =>
-	{
-		const render = this.Render(item.Get('id'));
-		return render ? render.Element : null;
-	}).filter(el => el !== null);
-
-	// Wrap in container if specified
-	if(wrapper)
-	{
-		const container = document.createElement(wrapper);
-		rendered.forEach(el => container.appendChild(el));
-		return container;
-	}
-
-	return rendered;
-});

package/addons/render/items/js/item/catch/add.js

@@ -1,18 +0,0 @@
-items.ItemOn('add', (item) =>
-{
-	if(item.Get('render'))
-	{
-		items.RenderAdd(item.Get('id'), function()
-		{
-			const data = item.Get('data');
-
-			// Merge data into render context
-			for(const key in data)
-			{
-				this.Data[key] = data[key];
-			}
-
-			return item.Get('render').call(this);
-		});
-	}
-});

package/test/front/test.js

@@ -1,56 +0,0 @@
-pages.Item({
-    id: 'home',
-    route: '/',
-    title: 'ot-command test',
-    grid: {
-        template: '"content"',
-        columns: '1fr',
-        rows: '1fr'
-    },
-    areas: {
-        content: function()
-        {
-            return `
-                1
-                {{ state.user }}
-
-                <h1>ot-command test</h1>
-                <ot-command-submit command="test" :api="true" bind="test" :data='{"name": "dejan"}'>
-                    <input name="name" placeholder="Name"/>
-                    <button type="submit">Send</button>
-                    <p ot-if="test.loading">Loading...</p>
-                    <p ot-if="test.error">Error: {{test.error}}</p>
-                    <div ot-if="test.response">dsas<ot-page route="/2"></ot-page></div>
-                </ot-command-submit>
-            `;
-        }
-    }
-});
-
-
-pages.Item({
-    id: 'hom2e',
-    route: '/2',
-    title: 'ot-command test',
-    grid: {
-        template: '"content"',
-        columns: '1fr',
-        rows: '1fr'
-    },
-    areas: {
-        content: function()
-        {
-            return `
-                2
-                <h1>ot-command test</h1>
-                <ot-command-submit command="test" :api="true" bind="test" :data='{"name": "dejan"}'>
-                    <input name="name" placeholder="Name"/>
-                    <button type="submit">Send</button>
-                    <p ot-if="test.loading">Loading...</p>
-                    <p ot-if="test.error">Error: {{test.error}}</p>
-                    <div ot-if="test.response">dsas<ot-page route="/"></ot-page></div>
-                </ot-command-submit>
-            `;
-        }
-    }
-});

package/test.js

@@ -1,55 +0,0 @@
-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 pages from './addons/render/pages/core/load.js';
-import html from './addons/render/html/load.js';
-import variables from './addons/modules/variables/core/load.js';
-
-assets.Fn('import', ['framework', 'variables', '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'));
-    }
-});
-
-console.log($ot.var('test'));
-
-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');
-    }
-});