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.
  • titanium-behaviours – For Appcelerator Titanium.
  • More coming soon

• The framework powers the Behaviours product, where code is generated directly from user stories. Importantly, the generated code is fully editable and maintainable—unlike most other code generators.

• 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.

---

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

• licensed as MIT.