@onetype/framework 2.0.41 → 2.0.43

package/docs/servers.md

@@ -1,187 +0,0 @@
-# Servers
-
-HTTP and gRPC servers, both configured through the commands addon.
-
-## HTTP server
-
-```js
-import commands from '#commands/load.js';
-
-commands.Fn('http.server', 3000, {
-    onStart: (server) => {
-        console.log('HTTP server started on port 3000');
-    },
-    onResponse: (http) => {
-        // Called after each response
-    },
-    onError: (error) => {
-        console.log('HTTP server error:', error.message);
-    }
-});
-```
-
-## HTTP object
-
-Every request creates an `http` object passed to `onRequest` and command callbacks (via `this.http`):
-
-| Property | Type | Description |
-|---|---|---|
-| `request` | IncomingMessage | Node.js request (headers, method, url) |
-| `response` | ServerResponse | Node.js response (writeHead, setHeader, end) |
-| `data` | object | Parsed request data (query params + body) |
-| `url` | URL | Parsed request URL |
-| `user` | object | `{ ip, agent, forwarded, referrer }` |
-| `respond` | object | `{ type, data, message, code }` — response payload |
-| `prevent` | boolean | Set `true` to skip automatic response |
-
-## Cookies
-
-Built-in cookie support via `onetype.Cookie*` methods. Works on both front (browser) and back (server) — detected via `onetype.environment`.
-
-### Back (server)
-
-```js
-// Read from request
-const token = onetype.CookieGet('token', this.http.request);
-
-// Set on response (HttpOnly + Secure by default)
-onetype.CookieSet('token', value, {
-    path: '/',
-    maxAge: 86400,
-    sameSite: 'Strict'
-}, this.http.response);
-
-// Clear
-onetype.CookieClear('token', { path: '/' }, this.http.response);
-```
-
-### Front (browser)
-
-```js
-onetype.CookieSet('theme', 'dark', { path: '/', maxAge: 86400 });
-const theme = onetype.CookieGet('theme');
-onetype.CookieClear('theme');
-```
-
-### Options
-
-| Option | Back default | Front default | Description |
-|---|---|---|---|
-| `path` | — | — | Cookie path |
-| `maxAge` | — | — | Lifetime in seconds |
-| `domain` | — | — | Cookie domain |
-| `httpOnly` | `true` | N/A | JS can't read the cookie |
-| `secure` | `true` | `false` | HTTPS only |
-| `sameSite` | — | — | `Strict`, `Lax`, or `None` |
-
-## gRPC server
-
-Bidirectional streaming with automatic reconnection and binary data transport.
-
-```js
-commands.Fn('grpc.server', 50000, {
-    onStart: function() {
-        console.log('gRPC server started on port 50000');
-    },
-    onStreamConnect: async function(stream) {
-        // Authenticate via metadata
-        const node = await nodes.Fn('find', stream.metadata.get('token')[0]);
-
-        // Track the connection as an item
-        const connection = streams.Item({
-            gateway_id: gateway.Get('id'),
-            node_id: node.Get('id')
-        });
-        await connection.Create();
-
-        // Attach runtime state via Store
-        connection.StoreSet('gateway', gateway);
-        connection.StoreSet('node', node);
-        connection.StoreSet('stream', stream);
-
-        stream.connection = connection;
-
-        console.log('Connection established:', node.Get('name'));
-    },
-    onStreamEnd: function(stream) {
-        if (stream.connection) {
-            const node = stream.connection.StoreGet('node');
-            console.log('Disconnected:', node.Get('name'));
-
-            stream.connection.Delete();
-            stream.connection.Remove();
-        }
-    },
-    onStreamError: function(stream) {
-        console.log('Stream error');
-    },
-    onError: function(message) {
-        console.log('Server error:', message);
-    }
-});
-```
-
-## Binary transport
-
-gRPC messages are JSON strings. Binary data (Buffers) is automatically extracted into a separate `map<string, bytes>` field before sending and re-injected on receive.
-
-```js
-// Extract binaries from a data object
-const extracted = onetype.BinariesExtract(data);
-// extracted.data    → JSON-safe object (Buffers replaced with keys)
-// extracted.binaries → map of key → Buffer
-
-// Re-inject binaries
-const restored = onetype.BinariesInject(extracted.data, extracted.binaries);
-```
-
-This enables transparent file transfers over the same gRPC stream without base64 encoding.
-
-## Store API
-
-Per-item in-memory key-value storage — useful for attaching runtime state (like gRPC streams) to items:
-
-```js
-// Set
-connection.StoreSet('node', nodeItem);
-connection.StoreSet('stream', streamObject);
-
-// Get
-const node = connection.StoreGet('node');
-const stream = connection.StoreGet('stream');
-```
-
-Store data is never persisted to the database. It exists only in memory for the lifetime of the item.
-
-## Requesting over gRPC
-
-Send a request to a connected node and await the response:
-
-```js
-const response = await stream.request('tool-slug', inputProperties, (chunk) => {
-    // Optional: handle streaming chunks
-    resolve(chunk.data, chunk.message, chunk.code, false);
-});
-
-// response.data, response.message, response.code, response.time
-```
-
-## Graceful shutdown
-
-The framework handles process signals through middleware:
-
-```js
-process.on('SIGINT', async () => {
-    await onetype.Middleware('sigint');
-    await onetype.Middleware('shutdown');
-    process.exit(0);
-});
-```
-
-Register shutdown handlers:
-
-```js
-onetype.MiddlewareAdd('shutdown', async () => {
-    // Close connections, flush data, etc.
-});
-```

package/examples/basic-api/README.md

@@ -1,34 +0,0 @@
-# Basic API
-
-In-memory task CRUD API using the commands addon.
-
-## Run
-
-```bash
-node index.js
-```
-
-## Endpoints
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| GET | /api/tasks | List all tasks |
-| POST | /api/tasks | Create a task |
-| PUT | /api/tasks/:id | Toggle task done |
-| DELETE | /api/tasks/:id | Delete a task |
-
-## Example
-
-```bash
-# Create
-curl -X POST http://localhost:3000/api/tasks -d '{"title":"Buy milk"}'
-
-# List
-curl http://localhost:3000/api/tasks
-
-# Toggle
-curl -X PUT http://localhost:3000/api/tasks/1234
-
-# Delete
-curl -X DELETE http://localhost:3000/api/tasks/1234
-```

package/examples/basic-api/addons/tasks/addon.js

@@ -1,10 +0,0 @@
-import onetype from 'onetype';
-
-const tasks = onetype.Addon('tasks', (addon) =>
-{
-    addon.Field('id', ['number']);
-    addon.Field('title', ['string', null, true]);
-    addon.Field('done', ['boolean', false]);
-});
-
-export default tasks;

package/examples/basic-api/addons/tasks/items/commands/create.js

@@ -1,22 +0,0 @@
-import commands from 'onetype/commands';
-import tasks from '../../addon.js';
-
-commands.Item({
-    id: 'tasks:create',
-    method: 'POST',
-    endpoint: '/api/tasks',
-    exposed: true,
-    in: {
-        title: ['string', null, true]
-    },
-    callback: async function(properties, resolve)
-    {
-        const task = tasks.Item({
-            id: Date.now(),
-            title: properties.title,
-            done: false
-        });
-
-        resolve({ task: task.Get(['id', 'title', 'done']) });
-    }
-});

package/examples/basic-api/addons/tasks/items/commands/delete.js

@@ -1,26 +0,0 @@
-import commands from 'onetype/commands';
-import tasks from '../../addon.js';
-
-commands.Item({
-    id: 'tasks:delete',
-    method: 'DELETE',
-    endpoint: '/api/tasks/:id',
-    exposed: true,
-    in: {
-        id: ['number', null, true]
-    },
-    callback: async function(properties, resolve)
-    {
-        const items = Object.values(tasks.Items());
-        const task = items.find(item => item.Get('id') === properties.id);
-
-        if(!task)
-        {
-            return resolve(null, 'Task not found', 404);
-        }
-
-        task.Remove();
-
-        resolve({ success: true });
-    }
-});

package/examples/basic-api/addons/tasks/items/commands/list.js

@@ -1,17 +0,0 @@
-import commands from 'onetype/commands';
-import tasks from '../../addon.js';
-
-commands.Item({
-    id: 'tasks:list',
-    method: 'GET',
-    endpoint: '/api/tasks',
-    exposed: true,
-    callback: async function(properties, resolve)
-    {
-        const items = Object.values(tasks.Items());
-
-        resolve({
-            tasks: items.map(item => item.Get(['id', 'title', 'done']))
-        });
-    }
-});

package/examples/basic-api/addons/tasks/items/commands/toggle.js

@@ -1,26 +0,0 @@
-import commands from 'onetype/commands';
-import tasks from '../../addon.js';
-
-commands.Item({
-    id: 'tasks:toggle',
-    method: 'PUT',
-    endpoint: '/api/tasks/:id',
-    exposed: true,
-    in: {
-        id: ['number', null, true]
-    },
-    callback: async function(properties, resolve)
-    {
-        const items = Object.values(tasks.Items());
-        const task = items.find(item => item.Get('id') === properties.id);
-
-        if(!task)
-        {
-            return resolve(null, 'Task not found', 404);
-        }
-
-        task.Set('done', !task.Get('done'));
-
-        resolve({ task: task.Get(['id', 'title', 'done']) });
-    }
-});

package/examples/basic-api/addons/tasks/load.js

@@ -1,8 +0,0 @@
-import tasks from './addon.js';
-
-import './items/commands/list.js';
-import './items/commands/create.js';
-import './items/commands/toggle.js';
-import './items/commands/delete.js';
-
-export default tasks;

package/examples/basic-api/index.js

@@ -1,15 +0,0 @@
-import onetype from 'onetype';
-import commands from 'onetype/commands';
-
-import './addons/tasks/load.js';
-
-commands.Fn('http.server', 3000, {
-    onStart: () =>
-    {
-        console.log('API running on http://localhost:3000');
-        console.log('');
-        console.log('Try:');
-        console.log('  curl http://localhost:3000/api/tasks');
-        console.log('  curl -X POST http://localhost:3000/api/tasks -d \'{"title":"Buy milk"}\'');
-    }
-});

package/examples/basic-api/package.json

@@ -1,7 +0,0 @@
-{
-    "name": "basic-api-example",
-    "type": "module",
-    "dependencies": {
-        "onetype": "^2.0.0"
-    }
-}

package/examples/basic-front/back/assets.js

@@ -1,12 +0,0 @@
-import assets from 'onetype/assets';
-import 'onetype/pages';
-
-import { dirname, resolve } from 'path';
-import { fileURLToPath } from 'url';
-
-const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-
-assets.Fn('import', ['framework', 'commands', 'pages']);
-
-assets.Item({ type: 'js', order: 10, path: resolve(root, 'front') });
-assets.Item({ type: 'css', order: 10, path: resolve(root, 'front') });

package/examples/basic-front/back/index.js

@@ -1,13 +0,0 @@
-import './assets.js';
-import './items/html/fonts.js';
-import './items/commands/html.js';
-import './items/commands/test.js';
-
-import commands from 'onetype/commands';
-
-commands.Fn('http.server', 3000, {
-    onStart: () =>
-    {
-        console.log('basic-front running on http://localhost:3000');
-    }
-});

package/examples/basic-front/back/items/commands/html.js

@@ -1,14 +0,0 @@
-import commands from 'onetype/commands';
-import html from 'onetype/html';
-
-commands.Item({
-    id: 'html',
-    exposed: true,
-    method: 'GET',
-    endpoint: '*',
-    type: 'HTML',
-    callback: async function(properties, resolve)
-    {
-        resolve(html.Fn('render'));
-    }
-});

package/examples/basic-front/back/items/commands/test.js

@@ -1,19 +0,0 @@
-import commands from 'onetype/commands';
-
-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 + '!' });
-    }
-});

package/examples/basic-front/back/items/html/fonts.js

@@ -1,12 +0,0 @@
-import html from 'onetype/html';
-
-html.Item({
-    id: 'fonts',
-    tag: 'link',
-    position: 'head',
-    order: 85,
-    attributes: {
-        rel: 'stylesheet',
-        href: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap'
-    }
-});

package/examples/basic-front/front/pages/home.js

@@ -1,16 +0,0 @@
-pages.Item({
-    id: 'home',
-    route: '/',
-    title: 'OneType Framework',
-    areas: {
-        main: function()
-        {
-            return `
-                <div class="hero">
-                    <h1>Hello from OneType Framework</h1>
-                    <p>A minimal full-stack JavaScript framework.</p>
-                </div>
-            `;
-        }
-    }
-});

package/examples/basic-front/front/styles/main.css

@@ -1,31 +0,0 @@
-* {
-    margin: 0;
-    padding: 0;
-    box-sizing: border-box;
-}
-
-body {
-    font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-    background: #0f0f0f;
-    color: #e0e0e0;
-    min-height: 100vh;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-}
-
-.hero {
-    text-align: center;
-}
-
-.hero h1 {
-    font-size: 48px;
-    font-weight: 600;
-    letter-spacing: -1px;
-    margin-bottom: 16px;
-}
-
-.hero p {
-    font-size: 16px;
-    color: #888;
-}

package/examples/basic-front/front/test.js

@@ -1,7 +0,0 @@
-const commands = onetype.Addon('commands');
-
-(async () =>
-{
-    const result = await commands.Fn('api', 'test', { name: 'Dejan' });
-    console.log('api result:', result);
-})();

package/examples/basic-front/package.json

@@ -1,7 +0,0 @@
-{
-    "name": "basic-front-example",
-    "type": "module",
-    "dependencies": {
-        "onetype": "^2.0.6"
-    }
-}

package/lib/items/directives/500-blur.js

@@ -1,46 +0,0 @@
-directives.ItemAdd({
-    id: 'ot-blur',
-    icon: 'visibility_off',
-    name: 'Blur',
-    description: 'Handle blur events when elements lose focus. Useful for form validation and input state management.',
-    category: 'events',
-    trigger: 'node',
-    order: 500,
-    attributes: {
-        'ot-blur': ['string']
-    },
-    code: function(data, item, compile, node, identifier)
-    {
-        const attribute = data['ot-blur'].value;
-
-        node.otBlur = (event) =>
-        {
-            const results = onetype.Function(attribute, compile.data, false);
-
-            if(typeof results === 'function')
-            {
-                const value = event.target.value || '';
-                results(event, {item, compile, node, identifier, value});
-            }
-        }
-    }
-});
-
-onetype.AddonReady('directives', function()
-{
-    document.addEventListener('blur', function(event)
-    {
-        let node = event.target;
-
-        while(node && node !== document)
-        {
-            if('otBlur' in node)
-            {
-                node.otBlur(event);
-                break;
-            }
-
-            node = node.parentNode;
-        }
-    }, true);
-});

package/lib/items/directives/500-change.js

@@ -1,53 +0,0 @@
-directives.ItemAdd({
-    id: 'ot-change',
-    icon: 'sync_alt',
-    name: 'Change',
-    description: 'Handle change events when form fields lose focus. Triggers after value is committed with modifiers support.',
-    category: 'events',
-    trigger: 'node',
-    order: 500,
-    attributes: {
-        'ot-change': ['string']
-    },
-    code: function(data, item, compile, node, identifier)
-    {
-        const attribute = data['ot-change'].value;
-
-        node.otChange = (event) =>
-        {
-            // Auto-apply modifiers
-            if (data['ot-change'].modifiers && data['ot-change'].modifiers.length > 0)
-            {
-                if (data['ot-change'].modifiers.includes('prevent')) event.preventDefault();
-                if (data['ot-change'].modifiers.includes('stop')) event.stopPropagation();
-            }
-
-            const results = onetype.Function(attribute, compile.data, false);
-
-            if(typeof results === 'function')
-            {
-                const value = event.target.value;
-                results(event, {item, compile, node, identifier, value});
-            }
-        }
-    }
-});
-
-onetype.AddonReady('directives', function()
-{
-    document.addEventListener('change', function(event)
-    {
-        let node = event.target;
-
-        while(node && node !== document)
-        {
-            if('otChange' in node)
-            {
-                node.otChange(event);
-                break;
-            }
-
-            node = node.parentNode;
-        }
-    });
-});

package/lib/items/directives/500-click-outside.js

@@ -1,50 +0,0 @@
-directives.ItemAdd({
-    id: 'ot-click-outside',
-    icon: 'close_fullscreen',
-    name: 'Click Outside',
-    description: 'Detect clicks outside the element. Perfect for closing dropdowns and modals.',
-    category: 'events',
-    trigger: 'node',
-    order: 500,
-    attributes: {
-        'ot-click-outside': ['string']
-    },
-    code: function(data, item, compile, node, identifier)
-    {
-        const attribute = data['ot-click-outside'].value;
-
-        const handler = (event) =>
-        {
-            const results = onetype.Function(attribute, compile.data, false);
-
-            if(typeof results === 'function')
-            {
-                results(event, {item, compile, node, identifier});
-            }
-        };
-
-        handlers.add({element: node, handler});
-    }
-});
-
-onetype.AddonReady('directives', function()
-{
-    const handlers = new Set();
-
-    document.addEventListener('click', function(event)
-    {
-        handlers.forEach(({element, handler}) =>
-        {
-            if(!document.contains(element))
-            {
-                handlers.delete({element, handler});
-                return;
-            }
-
-            if(!element.contains(event.target) && element !== event.target)
-            {
-                handler(event);
-            }
-        });
-    });
-});