npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

arvo-core

v1.2.0

Published

This core package contains all the core classes and components of the Arvo Event Driven System

Downloads

1,488

Readme

SonarCloud Quality Gate Status

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 - Core

This core package defines primitive types and utility functions to help you quickly start building interesting and robust event-driven applications.

Documentation & Resources

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

Installation

You can install the core package via npm or yarn

npm install arvo-core
yarn add arvo-core

Components

At its core, Arvo has only three main data structures:

  • ArvoEvent aims to provide a extendible variant of the open-source CloudEvent spec-ed object to define all the event in the system.
  • ArvoContract is a basic class to define and impose contracts between services, ensuring trust in decoupled systems during build and development.
  • ArvoContractLibrary is a utility class designed to manage and access multiple ArvoContract instances efficiently.
  • ArvoErrorSchema is the recommeded zod schema for all the errors in the ArvoEvents

Utilities

The package also includes utility functions for:

  • Creating ArvoEvents, ArvoContracts, and contract libraries
  • Integrating with OpenTelemetry
  • TypeScript types for core components

Getting Started

To start using Arvo in your project:

  • Install the package as shown in the Installation section.
  • Import the necessary components:
import {
  createArvoEvent,
  createArvoContract,
  createArvoContractLibrary,
  createArvoEventFactory,
} from 'arvo-core';
  • Begin defining your events and contracts using the provided classes.

License

This package is available under the MIT License. For more details, refer to the LICENSE.md file in the project repository.

Change Logs

For a detailed list of changes and updates, please refer to the document file.

SonarCloud Metrics

Quality Gate Status Bugs Code Smells Coverage Duplicated Lines (%) Lines of Code Reliability Rating Security Rating Technical Debt Maintainability Rating Vulnerabilities