divhunt 2.0.2 → 2.0.3

package/lib/src/classes/error/class.js

@@ -1,4 +1,4 @@
-class DivhuntError extends Error
+class DivhuntErrorClass extends Error
 {
     constructor(code, message, context)
     {
@@ -10,4 +10,4 @@ class DivhuntError extends Error
     }
 }
 
-export default DivhuntError;
+export default DivhuntErrorClass;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "divhunt",
-    "version": "2.0.2",
+    "version": "2.0.3",
     "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",

package/.claude/settings.local.json

@@ -1,13 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(git push:*)",
-      "Bash(git diff --staged)",
-      "Bash(git status)",
-      "Bash(git push git@github-iamdejan:tomic-d/framework.git main)",
-      "Bash(node:*)"
-    ]
-  }
-}

package/CLAUDE.md

@@ -1,132 +0,0 @@
-# CLAUDE.md — Divhunt Framework
-
-## PURPOSE
-
-AI project guardian. Maintains full context, protects scope, tracks every decision, and keeps all project files synchronized. This file is the operating system of this project.
-
----
-
-## STATUS
-
-Phase: 3 — Maintenance
-Focus: Stability, bugfixes, optimization
-Blocker: None
-Last session: 2026-02-19 — Added DivhuntError (divhunt.Error(code, message, context)), emit on error, removed copyright headers
-
----
-
-## PHASES
-
-### Phase 1: V2 Build (completed)
-- Core rebuilt from scratch — Proxy reactivity, mixin composition, addon abstraction
-- PostgreSQL ORM, HTTP/gRPC servers, command system, render engine
-- 40+ UI components, SPA router, directive system, asset bundler
-- **Gate:** Framework powers a real application end-to-end.
-
-### Phase 2: Open Source Launch (completed)
-- Published on npm as `divhunt`
-- MIT license
-- Full documentation (6 docs covering all subsystems)
-- Working example (basic-api)
-- Public GitHub repo
-- **Gate:** Published, documented, usable by external developers.
-
-### Phase 3: Maintenance (current)
-- Bugfixes, stability improvements, performance optimization
-- No new major features without explicit approval
-- Documentation kept up to date
-- **Gate:** Stable, battle-tested, zero critical bugs.
-
-### Phase 4: Growth
-- Community adoption, contributions
-- New addons, integrations
-- Plugin system, ecosystem
-
----
-
-## MODES
-
-### Work Mode (default)
-Normal development. Follow tasks, fix bugs, optimize code.
-
-### Vision Mode
-**Trigger:** "let's talk about the vision", "let's change the vision", "let's discuss strategy", "let's talk about the framework direction"
-
-Behavior:
-1. Read brief.md and current STATUS
-2. Discuss with user — ask questions, challenge assumptions, propose alternatives
-3. After alignment, update ALL affected files:
-   - brief.md — product definition changes
-   - architecture.md — if technical direction changes
-   - decisions.md — log what changed and why
-   - tasks.md — add/remove/reprioritize
-   - progress.md — adjust milestones if needed
-4. Update STATUS in CLAUDE.md
-5. Print a summary of all changes made
-
-### Review Mode
-**Trigger:** "where are we?", "status?", "overview", "what's done?"
-
-Behavior:
-1. Read all files
-2. Give a concise report: phase, focus, blockers, recent progress, next steps
-
-### Decision Mode
-**Trigger:** "I need to decide", "what do you think I should choose", "I have a dilemma"
-
-Behavior:
-1. Listen to the options
-2. Analyze pros and cons of each
-3. Give a recommendation with reasoning
-4. After the decision — log in decisions.md with full context
-
----
-
-## RULES
-
-### Scope Protection
-- Phase 3 = maintenance. No new features without explicit approval.
-- If user proposes a new feature → "Is this maintenance or Phase 4? Logging in tasks.md as future."
-- Bugfix and optimization PRs are always welcome
-- Breaking changes require a decision logged in decisions.md
-
-### Decision Tracking
-- Every non-trivial decision MUST be logged in decisions.md BEFORE implementation
-- Format: decision + reason + rejected alternatives + context
-
-### Session Management
-- Start of session: read STATUS and tasks.md to know where you are
-- End of session: update STATUS (phase, focus, blocker, last session summary)
-- If session was a vision/strategy discussion — update all affected files
-
-### Auto-Update Rules
-- **brief.md** — Changes ONLY in Vision Mode with explicit approval.
-- **architecture.md** — Updated when code or technical direction changes.
-- **decisions.md** — Every decision, immediately, no exceptions.
-- **tasks.md** — Updated when a task is completed, added, or reprioritized.
-- **progress.md** — Updated when a milestone is reached.
-
-### Git
-- Never add Co-Authored-By or any co-author lines to commit messages
-- All commits are authored solely by Dejan Tomic
-- Use SSH remote: git@github-iamdejan:tomic-d/framework.git
-- Commit style: short, lowercase, imperative, no period
-
-### Communication
-- Serbian or English, match the user
-- Direct, no fluff
-- When user is wrong — say it
-- When user is right — confirm it
-- Code style: follow existing conventions with maximum precision
-
----
-
-## FILES
-
-| File | Purpose | When it changes |
-|---|---|---|
-| brief.md | What, for whom, why, vision, competition | Vision Mode, with approval |
-| architecture.md | Living technical overview of the system | When code/tech stack changes |
-| decisions.md | Decision + why + rejected alternatives | Every decision, immediately |
-| tasks.md | Active tasks, granular | When task is added/completed/changed |
-| progress.md | Milestones, what's done | When a milestone is reached |

package/architecture.md

@@ -1,138 +0,0 @@
-# ARCHITECTURE — Divhunt Framework
-
-*Living technical overview. Updated alongside the code.*
-
----
-
-## Status: Stable — V2 complete, in maintenance
-
-## Stack
-
-- **Language:** JavaScript (ES Modules, `"type": "module"`)
-- **Runtime:** Node.js >= 18 (backend), Browser (frontend bundle)
-- **Database:** PostgreSQL via Knex
-- **Transport:** HTTP + gRPC
-- **Bundling:** Convention-based (terser for minification)
-- **SSR:** linkedom for server-side DOM
-- **No TypeScript, no test framework, no linter, no build step**
-
-## Project Structure
-
-```
-lib/                         Core Divhunt class + 17 mixins
-  load.js                    Node.js entry point (creates instance, handles signals)
-  browser.js                 Browser entry point (attaches to window, mounts body)
-  src/
-    divhunt.js               Main class (mixin-composed)
-    mixins/                  addons, emitter, middleware, data, dom, route,
-                             function, generate, binaries, helper, validate,
-                             string, request, logger, dependencies, overrides, error
-    classes/
-      addon/                 DivhuntAddon + mixins (fields, items, functions, find, render, store)
-        classes/
-          item/              DivhuntAddonItem + mixins (get, set, crud, functions, store)
-          render/            DivhuntAddonRender + mixins (compile, dom, process, events)
-      error/                 DivhuntError class (extends Error — code, message, context)
-
-addons/                      Built-in addon library
-  core/
-    database/                PostgreSQL ORM (Knex, fluent query builder, 17+ operators)
-    servers/                 HTTP + gRPC servers
-    clients/                 HTTP + gRPC clients
-    commands/                Typed API command system
-    queue/                   Concurrency task queue
-  render/
-    directives/              dh-if, dh-for, dh-click, dh-fetch, dh-show, dh-html, dh-text
-    pages/                   SPA page router with CSS Grid layouts + async data loading
-    elements/                40+ pre-built UI components
-    assets/                  Convention-based asset bundler (terser)
-    html/                    HTML document builder
-    tags/                    HTML tag system
-    transforms/              Data transforms
-  modules/
-    variables/               Named variable registry
-    actions/                 Action triggers
-    events/                  Event bindings
-    schedules/               Cron-like scheduling
-    shortcuts/               Keyboard shortcut bindings
-    sources/                 Data source registry
-  float/
-    modals/                  Modal dialogs
-    toasts/                  Toast notifications
-    tooltips/                Tooltip system
-    popups/                  Popup menus
-    overlays/                Overlay backdrops
-
-docs/                        Full documentation (6 files)
-examples/basic-api/          Minimal working example
-```
-
-## Key Classes
-
-| Class | Mixins | Purpose |
-|---|---|---|
-| Divhunt | 17 | Core engine — addon registry, emitter, middleware, routing, DOM, error |
-| DivhuntAddon | 9 | Addon abstraction — fields, items, functions, find, render, store |
-| DivhuntAddonItem | 6 | Single record — get, set, CRUD, functions, store |
-| DivhuntAddonRender | 7 | Frontend component — compile, DOM diffing, events, lifecycle |
-| DivhuntError | — | Structured error (extends Error) — code, message, context |
-
-## Import Aliases
-
-Defined in `package.json` under `imports`:
-
-| Alias | Maps to |
-|---|---|
-| `#framework/*` | `./lib/*` |
-| `#database/*` | `./addons/core/database/back/*` |
-| `#servers/*` | `./addons/core/servers/back/*` |
-| `#clients/*` | `./addons/core/clients/back/*` |
-| `#commands/*` | `./addons/core/commands/back/*` |
-| `#queue/*` | `./addons/core/queue/back/*` |
-| `#assets/*` | `./addons/render/assets/back/*` |
-| `#html/*` | `./addons/render/html/*` |
-| `#directives/*` | `./addons/render/directives/*` |
-| `#elements/*` | `./addons/render/elements/*` |
-| `#tags/*` | `./addons/render/tags/*` |
-| `#sources/*` | `./addons/modules/sources/*` |
-| `#variables/*` | `./addons/modules/variables/*` |
-
-## Design Decisions
-
-### Mixin composition over inheritance
-`Object.assign(Class.prototype, mixin)`. No class hierarchies. Each mixin is a plain object of methods merged onto the prototype.
-
-### Middleware as the extension point
-CRUD operations are async middleware chains. Database addon intercepts for SQL. Without database — everything works in-memory. Storage is swappable.
-
-### Self-registering imports
-Importing `load.js` registers the addon. No manual wiring, no DI container. `AddonReady` handles async dependency resolution regardless of import order.
-
-### Field transforms
-Every field has `get[]` and `set[]` transform arrays plus a `define` schema. Type coercion, validation, and computed fields are declared at the field level.
-
-### Proxy-driven reactivity (frontend)
-Property assignment triggers Proxy trap → schedules 16ms debounced `Update()` → re-compile → DOM diff → patch. No virtual DOM.
-
-### Binary transport over gRPC
-Buffer instances extracted to separate `map<string, bytes>` before sending. Re-injected on receive. Transparent binary transport over JSON-based gRPC.
-
-### Structured error handling
-`divhunt.Error(code, message, context)` returns a `DivhuntError` (extends `Error`). HTTP-compatible codes (400, 404, 500). Emits `'error'` event on creation. HTTP server and command system read `error.code` instead of hardcoding 500. `LogError` includes code and context in meta.
-
-### Convention-based bundling
-No webpack. Scans directories, prioritizes `addon.js`, strips ES module syntax, concatenates by order, minifies via terser.
-
-## Dependencies
-
-| Package | Purpose |
-|---|---|
-| knex | SQL query builder |
-| pg | PostgreSQL driver |
-| @grpc/grpc-js | gRPC server/client |
-| @grpc/proto-loader | gRPC proto loading |
-| bcrypt | Password hashing |
-| busboy | Multipart/file upload parsing |
-| dotenv | Environment config |
-| linkedom | Server-side DOM |
-| terser | JS minification |

package/brief.md

@@ -1,62 +0,0 @@
-# BRIEF — Divhunt Framework
-
-*Product definition. What this is, for whom, and why.*
-
----
-
-## What is this?
-
-Full-stack isomorphic JavaScript framework built from scratch. No React, no Express, no Vue — original architecture from zero. One universal abstraction — the **addon** — powers everything: databases, servers, commands, pages, directives, queues, and more.
-
-Published on npm as `divhunt`. Version 2.0.0.
-
-## Who is it for?
-
-Primary: Dejan's own projects (Divhunt platform, Agents, freelance work).
-Secondary: Open-source community — developers who want a different approach to full-stack JS.
-
-## What problem does it solve?
-
-Modern JS ecosystem is fragmented. You need React + Express + Prisma + Next + 50 packages just to build a CRUD app. This framework gives you one abstraction that handles backend, frontend, data, APIs, and reactivity — all from a single addon definition.
-
-Define an addon with fields → you get: validation, events, middleware, PostgreSQL CRUD, API exposure, frontend reactivity, and DOM manipulation. No glue code.
-
-## Technical identity
-
-- **Zero external framework dependencies** — built from scratch
-- **Addon as universal abstraction** — every entity is an addon
-- **Mixin composition** — no inheritance hierarchies, Object.assign on prototypes
-- **Middleware chains** — storage-agnostic CRUD (in-memory by default, PostgreSQL via addon)
-- **Proxy-based reactivity** — 16ms debounced DOM diffing, no virtual DOM
-- **gRPC + HTTP** — dual transport, binary-safe
-- **Convention-based bundling** — no webpack, no config
-- **Self-registering imports** — import order doesn't matter
-
-## Production track record
-
-- V1 powered Divhunt cloud SaaS for 4+ years (thousands of users)
-- Travel agency site (27 addons, 50+ components)
-- Distributed function execution gateway
-- Multi-tenant CMS
-- Divhunt Agents platform (current)
-
-## Competition
-
-| Framework | How we're different |
-|---|---|
-| Express | Backend only, no frontend, no ORM, no reactivity |
-| Next.js | React-based, different paradigm, heavy |
-| Nuxt | Vue-based, same issue |
-| Fastify | Backend only, no addon abstraction |
-| Hono | Lightweight but backend only |
-
-Our edge: one abstraction for everything. No framework soup. One person can build a full production app.
-
-## Vision
-
-1. ~~V2 rebuild~~ (done)
-2. ~~Open source~~ (done)
-3. Stability and documentation (current)
-4. Community adoption
-5. Plugin ecosystem
-6. Become a viable alternative for solo developers and small teams

package/decisions.md

@@ -1,58 +0,0 @@
-# DECISIONS — Divhunt Framework
-
-*Every decision with reasoning. Never delete, only append.*
-
----
-
-## D001 — Mixin composition over class inheritance
-**Date:** Pre-open-source
-**Decision:** Use `Object.assign(Class.prototype, mixin)` instead of class inheritance.
-**Reason:** No diamond problem, no deep hierarchies, easy to add/remove capabilities. Each mixin is a plain object — simple to read, test, and compose.
-**Rejected alternatives:**
-- Class inheritance — fragile hierarchies, hard to compose multiple behaviors
-- Functional composition — loses `this` context, harder to debug
-
----
-
-## D002 — Addon as universal abstraction
-**Date:** Pre-open-source
-**Decision:** Every entity (users, pages, commands, servers) is an addon with the same interface: fields, items, functions, events, middleware.
-**Reason:** One pattern to learn. Backend and frontend use the same abstraction. Reduces cognitive load.
-**Rejected alternatives:**
-- Separate abstractions for models, controllers, components — more code, more concepts, more glue
-
----
-
-## D003 — Open source under MIT
-**Date:** 2026-02-19
-**Decision:** Publish framework as open source on GitHub under MIT license.
-**Reason:** Portfolio value. Framework proves deep technical capability. Public code > private code for career and credibility.
-**Rejected alternatives:**
-- Keep private — no portfolio benefit, no community
-- AGPL/proprietary — limits adoption
-
----
-
-## D004 — AI-managed project files
-**Date:** 2026-02-19
-**Decision:** Use CLAUDE.md + structured files (brief, architecture, decisions, tasks, progress) for project management.
-**Reason:** Same system used for Agents repo and iamdejan.com. AI maintains context across sessions, tracks decisions, protects scope.
-**Context:** Third project using this system. Pattern is proven.
-
----
-
-## D005 — divhunt.Error() instead of global DivhuntError class
-**Date:** 2026-02-19
-**Decision:** Structured errors via `divhunt.Error(code, message, context)` method on the instance, not a global class.
-**Reason:** `divhunt` is already imported everywhere. No additional imports needed. Emits `'error'` event on creation so listeners can react. Returns a throwable `DivhuntError extends Error`.
-**Rejected alternatives:**
-- `globalThis.DivhuntError` — global pollution
-- `throw new Error({})` — Error constructor expects string, object becomes `[object Object]`
-- Separate import — extra boilerplate in every file
-
----
-
-## D006 — Remove copyright headers from source files
-**Date:** 2026-02-19
-**Decision:** Remove `// © 2025 Divhunt GmbH` comment from all 92 source files.
-**Reason:** MIT license in LICENSE file is sufficient. Copyright headers add noise to every file.

package/lib/README.md

@@ -1,132 +0,0 @@
-## Built with the Divhunt Framework – non-commercial use only. For commercial use, contact dejan@divhunt.com.
-
-# Divhunt Framework
-
-A lightweight, extensible JavaScript framework built around an addon system with powerful data validation, event handling, and DOM manipulation capabilities.
-
-## Core Architecture
-
-The framework consists of a main `Divhunt` class with modular mixins and an extensible addon system:
-
-```
-Framework Core
-├── Divhunt Class (main)
-├── Mixins (functionality)
-│   ├── Addons
-│   ├── Data Validation
-│   ├── Event System
-│   ├── Middleware
-│   ├── DOM Manipulation
-│   └── Utilities
-└── Addon System
-    ├── DivhuntAddon
-    ├── DivhuntAddonItem
-    └── DivhuntAddonRender
-```
-
-## Quick Start
-
-### Server-side
-```javascript
-import Divhunt from './lib/load.js';
-
-const divhunt = new Divhunt();
-
-// Create an addon
-const users = divhunt.Addon('users', (addon) => {
-    addon.Field('name', ['string']);
-    addon.Field('email', ['string']);
-});
-
-// Add items
-users.Item({
-    name: 'John Doe',
-    email: 'john@example.com'
-});
-```
-
-### Browser
-```html
-<script src="framework/browser.js"></script>
-<script>
-    // window.divhunt is automatically available
-    const myAddon = window.divhunt.Addon('myAddon');
-</script>
-```
-
-## Core Features
-
-### 🔧 Addon System
-Create modular, reusable components with built-in validation
-
-### 📊 Data Validation
-Powerful schema-based validation with nested objects and arrays
-
-### 🎯 Event System
-Publisher-subscriber pattern for decoupled communication
-
-### ⚡ Middleware
-Intercept and modify operations with middleware chains
-
-### 🌐 DOM Manipulation
-Efficient DOM operations with state preservation
-
-### 🛠️ Utilities
-Helper functions for common operations and data manipulation
-
-## Documentation
-
-- [Installation](./docs/installation.md)
-- [Addons](./docs/addons.md)
-- [Data Validation](./docs/data-validation.md)
-- [Events & Middleware](./docs/events-middleware.md)
-- [DOM Manipulation](./docs/dom.md)
-- [Utilities](./docs/utilities.md)
-- [API Reference](./docs/api-reference.md)
-
-## Example Usage
-
-```javascript
-// Create a blog addon
-const blog = divhunt.Addon('blog', (addon) => {
-    addon.Field('title', ['string', '', true]);
-    addon.Field('content', ['string', '', true]);
-    addon.Field('author', ['object', {}, true], null, null, false, {
-        name: ['string'],
-        email: ['string']
-    });
-    addon.Field('tags', ['array'], null, null, false, {
-        each: ['string']
-    });
-});
-
-// Add a post
-const post = blog.Item({
-    title: 'Getting Started',
-    content: 'Welcome to our blog...',
-    author: {
-        name: 'Jane Smith',
-        email: 'jane@example.com'
-    },
-    tags: ['tutorial', 'getting-started']
-});
-
-// Listen for events
-divhunt.EmitOn('addon.item.add', (addon, item) => {
-    console.log(`New item added to ${addon.GetName()}`);
-});
-
-// Custom function
-blog.Fn('getByTag', function(tag) {
-    return Object.values(this.Items()).filter(item => 
-        item.Get('tags').includes(tag)
-    );
-});
-
-// Use the function
-const tutorials = blog.Fn('getByTag', 'tutorial');
-```
-
-## License
-
-Licensed under the Divhunt Framework License. See LICENSE.txt for terms.

package/progress.md

@@ -1,35 +0,0 @@
-# PROGRESS — Divhunt Framework
-
-*Milestones. What's done.*
-
----
-
-## Phase 1: V2 Build
-
-- [x] Core engine rebuilt (Divhunt class + 16 mixins)
-- [x] Addon abstraction (DivhuntAddon + DivhuntAddonItem + DivhuntAddonRender)
-- [x] PostgreSQL ORM via Knex (fluent query builder, 17+ operators, joins)
-- [x] HTTP + gRPC servers and clients
-- [x] Typed API command system
-- [x] Proxy-based frontend reactivity (16ms debounced DOM diffing)
-- [x] SPA page router with CSS Grid layouts
-- [x] Directive system (dh-if, dh-for, dh-click, dh-fetch, dh-show, dh-html, dh-text)
-- [x] 40+ pre-built UI components
-- [x] Convention-based asset bundler (terser)
-- [x] Float system (modals, toasts, tooltips, popups, overlays)
-- [x] Module system (variables, actions, events, schedules, shortcuts, sources)
-
-## Phase 2: Open Source Launch
-
-- [x] **2026-02-19** — Published on npm as `divhunt@2.0.0`
-- [x] **2026-02-19** — MIT license
-- [x] **2026-02-19** — Full documentation (6 docs: addons, database, commands, servers, frontend, architecture)
-- [x] **2026-02-19** — Working example (basic-api with 4 commands)
-- [x] **2026-02-19** — Public GitHub repo (tomic-d/framework)
-- [x] **2026-02-19** — Subpath exports and import aliases configured
-
-## Phase 3: Maintenance
-
-- [x] **2026-02-19** — Project management system set up (CLAUDE.md + brief, architecture, decisions, tasks, progress)
-- [x] **2026-02-19** — Structured error handling: `divhunt.Error(code, message, context)` with emit, HTTP/command integration, LogError enhancement
-- [x] **2026-02-19** — Copyright headers removed from all 92 source files

package/tasks.md

@@ -1,23 +0,0 @@
-# TASKS — Divhunt Framework
-
-*Active tasks. Current phase only, not a wishlist.*
-
----
-
-## Phase 3: Maintenance
-
-- [x] Set up project management system (CLAUDE.md + files)
-- [x] Add structured error handling (divhunt.Error)
-- [x] Remove copyright headers
-- [ ] Migrate existing throw new Error() to divhunt.Error() incrementally
-- [ ] Audit all addons for edge cases and error handling
-- [ ] Review and update documentation if code has diverged from docs
-
-## Later (not now)
-
-- Test suite
-- TypeScript definitions
-- CI/CD pipeline
-- Plugin/extension API
-- Community contribution guidelines
-- Additional examples (database CRUD, gRPC, frontend SPA)