Core Engine: Neuron & Synapse

The architecture of neuron-js is built around two primary components: the Neuron (Registry) and the Synapse (Execution Engine).

Neuron: The Registry

A Neuron instance serves as the central registry for the library. Before any script can be executed, the constructors for Actions, Conditions, and Rules must be registered with a Neuron.

• Role: Component Catalog.
• Responsibility: Storing and retrieving element definitions based on unique type strings.
• Why?: This decoupling allows the engine to remain lightweight while being infinitely extensible. You only register the specific logic units your application actually needs.

import { Neuron } from '@sebasoft/neuron-js';

const neuron = new Neuron();

// Custom components are registered by type
neuron.registerAction('SendNotification', MyNotificationAction);
neuron.registerCondition('IsOverLimit', MyLimitCondition);

Synapse: The Engine

A Synapse instance is the engine that drives execution. It takes a configured Neuron registry and performs the actual work of processing a script.

• Role: Runtime Engine.
• Responsibility: Iterating through script rules, evaluating conditions, executing actions, and managing context state transitions.
• Input: ScriptInterface, ExecutionContext.
• Output: ExecutionResult.

import { Synapse } from '@sebasoft/neuron-js';

const synapse = new Synapse(neuron);
const result = synapse.execute(myScript, initialContext);

Separation of Concerns

This design ensures a clean separation between definitions, data, and execution:

1. Definitions (Neuron): The "dictionary" of what can be done.
2. Logic (Script): The JSON-serializable "sentence" describing what to do.
3. Execution (Synapse): The "reader" that processes the sentence using the dictionary.