beamjs

Private IoB & generative AI IoC enterprise full-stack web development framework Built on BackendJS, ExpressJS, AngularJS (or Any), and MongoDB (or Many) — designed for behavior-first, declarative, and modular enterprise systems.

Introduction

• BeamJS is built on top of Backend-JS, offering data controllers for both SQL and NoSQL databases. It also provides file system controllers that work with local or cloud storage.
• These data controllers act as abstract adapters over ODM/ORM patterns from MongooseJS and SequelizeJS. Their purpose is to define a unified query API that works across different database engines—including both NoSQL and SQL.
• BeamJS stands for the following technology stack:
  • Backend-JS – A Node.js module built on ExpressJS. Check it out.
  • ExpressJS – A minimal and flexible Node.js web application framework. Visit repo.
  • Angular (or Any) – A single-page front-end application framework. View here.
  • MongoDB (or Many) – A NoSQL database engine. More info.
• BeamJS is a tech-agnostic framework that can be configured to work with different database engines and front-end frameworks.

Why BeamJS and Backend-JS?

• Designed for agility, BeamJS supports highly configurable, modular, and adaptive systems.

• BeamJS is an enterprise-grade, declarative framework for private IoB, enabling seamless and secure implementation of both organizational and customer behaviors.

• It is especially powerful when building or integrating with AI agents, as it provides an IoC to embed intelligent behaviors within structured and secure workflows — making AI less indeterministic and more predictable.

• Features include:

  • Database encryption for pseudonymization and GDPR compliance.
  • A built-in data mapping pipeline.
  • Support for CQRS architecture with mixed model definitions across different databases.
  • Horizontal/database multi-tenancy with automatic multi-DB connection mapping.
  • Deep route-based load balancing using an integrated queuing system.
  • A built-in static file server that decouples file sources (local or cloud) from HTTP static request handling.
  • Complex file streaming and transformations managed within the queue system and load balancer.
  • A built-in forward and reverse proxy server using the queue system for efficient load balancing, virtual hosting, and advanced domain routing.
  • Support for connectionless long-polling HTTP requests.
  • Event-driven architecture over mixed HTTP/WebSocket protocols for pulling and pushing data.
  • Abstract, secure WebSocket handling for scalable real-time events, including features like sub-rooms.
  • It is ready for event-sourcing applications.

• Backend-JS introduces the concept of API Behaviors—organizational and customer behaviors implemented vertically using a customizable enterprise algorithmic mental model. This model follows a Behavior-First approach inspired by BDD. Read more.

• It supports a microservices architecture by vertically implementing Behaviors (APIs), along with a built-in service abstraction layer.

• The framework encourages defining the API contract first. These contracts can then be viewed by integrators for straightforward REST integration. This Behavioral model combines behavioral science, API-first, and headless architecture principles to deliver highly robust and modern applications.

• Integration between applications built with BeamJS and Backend-JS is akin to internal function calls or RPC in distributed systems. It supports SOAP-like behavior on top of REST APIs and provides several front-end integration libraries:

  • ng-behaviours – For Angular and Ionic.
  • js-behaviours – For Node.js, ElectronJS, and browser.
  • dotnet-behaviours – For .NET Core.
  • droid-behaviours – For Android.
  • ios-behaviours – For iOS.
  • php-behaviours – For PHP.
  • flutter-behaviours – For Flutter.
  • titanium-behaviours – For Appcelerator Titanium.
  • More coming soon

• The framework represents a state-of-the-art implementation of programming paradigms shaped by great human minds:

  • BeamJS and its sub-frameworks are inspired by declarative programming and functional programming.
  • BeamJS SDKs draw on principles from agent-oriented programming and meta-programming.

• The framework powers the Behaviors Engine for software engineering:

  • Chain-of-Thought (CoT) for planning sequential system operations.
  • Tree-of-Thoughts (ToT) for structuring hierarchical system behaviors.
  • Behavior-first programming as an executable translation of behavioral models — a key reducer of essential complexity in modern agile, AI-assisted software development.
  • High-level declarative abstraction that remains tech-agnostic to isolate low-level technologies and minimize accidental complexity — the main source of LLM hallucinations and security violations.

• The results:

  • Requires far less context as input to SLM — no need for folders of specs, just correct requirements or user stories.
  • Generates highly deterministic, hallucination-free, durable code — an asset, not a debt.
  • Minimal or no code review or debugging is required.
  • Produces very compact output, thanks to declarative programming — consuming far fewer tokens.
  • Operates as a single-step generation, not a multi-step agent consuming extra compute and time.
  • Enables a true inversion of control for GenAI, embedding security and compliance deeply for enterprise-grade performance.
  • A starter can build like an expert without losing deep technical understanding, thanks to transparent declarative abstraction.
  • Domain context boundaries are fully respected yet open for modifiability — addressing the gap left by traditional DDD in the AI era.
  • It’s full-stack generation — backend, frontend, mobile, IoT, services, and more — all seamlessly integrated from the start, thanks to declarative agent SDKs.
  • The generated code supports incremental architecture — switch from request–response to real-time or multi-tenancy with a single line of code. With a truly tech-agnostic approach, you write once and run on any database or service, supporting diverse modern architectures.

It isn’t a replacement for developers — it empowers them to focus on iterative development and validation testing.

Benchmarking

• Codacy static analysis rates the framework between A and C.
• Load testing of applications built with BeamJS reached over 10,000 sessions per minute and more than 1,000 concurrent connections on a 1 GB RAM / 1 vCPU AWS EC2 instance.
• The total number of dependencies is under 30, with 0 or 1 known vulnerabilities.

Starter project

Explore a sample project with usage examples:

👉 https://github.com/QuaNode/BeamJS-Start

Documentation

Table of Contents

• Getting Started

  • Installation
  • Starter
  • Architecture
  • Behaviors

• Usage

  • Backend
  • Model
  • Entity
  • Query
  • Service
  • Data
  • Behavior

  ---

📄 License

• MIT.