hexaFn

Modular event-driven function pipeline framework powered by the 6F Lifecycle Flow

πŸ¦€ Rust ⚑ Event-Driven πŸ”§ Modular πŸ“¦ WASM/JS/DSL πŸ—οΈ Hexagonal Architecture πŸ“‹ MIT Licensed

Why hexaFn?

6
Lifecycle Phases
7
Core Modules
3
Runtime Types
100%
Type Safe

The 6F Lifecycle Flow

Every pipeline follows the same predictable flow: Feed β†’ Filter β†’ Format β†’ Function β†’ Forward β†’ Feedback

Feed
β†’
Filter
β†’
Format
β†’
Function
β†’
Forward
β†’
Feedback
1

Feed

Ingest data from external sources like webhooks, APIs, message queues, or file systems.

HexaBridge: HTTP endpoints, SDK integrations
2

Filter

Apply conditional logic and pre-condition checks to gate pipeline execution.

HexaTrigger: Rule engine, condition evaluation
3

Format

Normalize, transform, and validate incoming data for consistent processing.

Data transformation, schema validation
4

Function

Execute user-defined logic using WASM, JavaScript, or internal DSL.

HexaRun: Multi-runtime function execution
5

Forward

Route results to KV stores, pub/sub topics, or external services.

HexaStore: KV storage, HexaCast: pub/sub
6

Feedback

Log, trace, audit, and monitor pipeline execution for observability.

HexaWatch: Structured logging, tracing

Core Modules

Seven specialized modules working together through clean, hexagonal architecture boundaries.

πŸ—οΈ

hexafn-core

Shared kernel providing core architecture, pipeline orchestration, and event flow management.

  • Pipeline builder and orchestrator
  • Domain events and value objects
  • Shared traits and interfaces
  • Configuration management
πŸŒ‰

hexafn-bridge

External integrations and webhook management for data ingestion (Feed phase).

  • HTTP webhook endpoints
  • SDK integrations
  • Event normalization
  • Token-based security
🎯

hexafn-trigger

Conditional logic and rule engine for pipeline gating (Filter phase).

  • Rule-based trigger evaluation
  • Compound conditions (AND/OR/NOT)
  • Priority-based execution
  • Dynamic configuration reload
⚑

hexafn-run

Multi-runtime function execution supporting WASM, JavaScript, and DSL (Function phase).

  • WebAssembly (WASM) runtime
  • JavaScript (QuickJS) runtime
  • Internal DSL interpreter
  • Resource limiting and timeouts
πŸ—„οΈ

hexafn-store

Event-driven key-value storage with triggers and versioning (Forward phase).

  • Namespaced KV operations
  • Version tracking and TTL
  • Transaction support
  • Multiple backend support
πŸ“‘

hexafn-cast

Pub/sub messaging engine with topic management (Forward phase).

  • Topic-based messaging
  • Subscriber lifecycle management
  • Message filtering and routing
  • Retry and acknowledgment
πŸ‘οΈ

hexafn-watch

Observability and audit tracing for comprehensive monitoring (Feedback phase).

  • Structured logging with trace context
  • OpenTelemetry integration
  • Metrics and alerting
  • Performance monitoring

Quick Start

Get up and running with hexaFn in minutes. Built with Rust for performance and safety.

git clone https://github.com/hTuneSys/hexaFn.git
cd hexaFn
cargo build --release
cargo run -- --help

πŸ”§ Development

Start developing with hot-reload and comprehensive tooling support.

cargo watch -x "run -- --dev-mode"

πŸš€ Production

Deploy with Docker or as a standalone binary with configuration.

./target/release/hexafn --config config.toml

πŸ§ͺ Testing

Run comprehensive test suites including integration tests.

cargo test --all && ./scripts/test/run-integration.sh

Documentation

Comprehensive documentation covering architecture, development, and deployment.

πŸ“–

Getting Started

Step-by-step guide to setting up and using hexaFn for the first time.

Read Guide
πŸ—οΈ

Architecture Guide

Deep dive into hexagonal architecture, DDD principles, and module boundaries.

Learn Architecture
πŸ’»

Development Guide

Contributing guidelines, code standards, and development workflow.

Start Contributing
πŸ“Š

Use Cases

Real-world examples and practical applications of hexaFn pipelines.

View Examples
πŸ—ΊοΈ

Roadmap

Project roadmap, milestones, and planned features for future releases.

View Roadmap
πŸ“‹

API Reference

Complete API documentation generated from source code.

API Docs