arvo-event-handler

Arvo

What is Arvo

Arvo is an opinionated approach to building event-driven systems. It's designed as a pattern and methodology rather than a rigid framework.

Principal

The core principle of Arvo is to provide a solid foundation with enough flexibility for customization, allowing you to impose your own technical posture, including security measures, event brokerage, and telemetry. While Arvo offers a structured approach, it encourages developers to implement their own solutions if they believe they can improve upon or diverge from Arvo's principles.

If you're looking to focus on results without getting bogged down in the nitty-gritty of event creation, handling, system state management, and telemetry, while also avoiding vendor lock-in, Arvo provides an excellent starting point. I believe, it strikes a balance between opinionated design and customization, making it an ideal choice for developers who want a head start in building event-driven systems without sacrificing flexibility.

Key features of Arvo include:

Lightweight and unopinionated core
Extensible architecture
Cloud-agnostic design
Built-in primitives for event-driven patterns
Easy integration with existing systems and tools

Whether you're building a small microservice or a large-scale distributed system, my hope with Arvo is to offers you some of the tools and patterns to help you succeed in the world of event-driven architecture.

Arvo suite

Arvo is a collection of libraries which allows you to build the event driven system in the Arvo pattern. However, if you feel you don't have to use them or you can use them as you see fit.

Scope	NPM	Github	Documentation
Orchestration	https://www.npmjs.com/package/arvo-xstate?activeTab=readme	https://github.com/SaadAhmad123/arvo-xstate	https://saadahmad123.github.io/arvo-xstate/index.html
Core	https://www.npmjs.com/package/arvo-core?activeTab=readme	https://github.com/SaadAhmad123/arvo-core	https://saadahmad123.github.io/arvo-core/index.html
Event Handling	https://www.npmjs.com/package/arvo-event-handler?activeTab=readme	https://github.com/SaadAhmad123/arvo-event-handler	https://saadahmad123.github.io/arvo-event-handler/index.html

Arvo - Event Handler

This package contains the event handler primitive required to enable an Arvo Event Driven System. These are light weight classes and types which take care of event listening, contract bound type inference, distributed open telemetry and much more.

Documentation & Resources

Source	Link
Package	https://www.npmjs.com/package/arvo-event-handler?activeTab=readme
Github	https://github.com/SaadAhmad123/arvo-event-handler
Documenation	https://saadahmad123.github.io/arvo-event-handler/index.html

Installation

You can install the core package via npm or yarn

npm install arvo-event-handler arvo-core

yarn add arvo-event-handler arvo-core

Components

There 2 main types of event handlers in Arvo event driven system

ArvoEventHandler is designed to facilitate the handling of events as per an ArvoContract (see arvo-core). It provides a robust and flexible way to create, manage, and execute event handlers for Arvo-based event driven systems.
ArvoEventRouter is designed to route ArvoEvents to appropriate ArvoEventHandlers. It provides a centralized mechanism for managing and executing multiple event handlers based on event types.
MultiArvoEventHandler is a flexible and powerful event handling class designed to process multiple event types across different ArvoContracts. This handler offers greater versatility compared to the more specialized ArvoEventHandler, as it's not bound to a specific contract or event type.

Getting Started

To start using Arvo Event Handlers in your project:

Install the package as shown in the Installation section.
Import the necessary components:

import {
  createArvoEvent,
  createArvoContract,
  createArvoContractLibrary,
  createArvoEventFactory,
} from 'arvo-core';

import {
  createArvoEventHandler,
  createMultiArvoEventHandler,
  createArvoEventRouter,
} from 'arvo-event-handler';