Skip to main content

Introduction

Welcome to RocketWave Pulse — a real-time event stream processing platform that enables powerful workflow automation.

Overview​

RocketWave Pulse consists of two main components:

Stream Consumer​

The Consumer is a Node.js application that processes events from AWS Kinesis streams. It executes user-defined workflows in isolated V8 sandboxes, providing:

  • High throughput event processing
  • Secure isolation via isolated-vm
  • Dynamic script execution with injected helper functions
  • AI/LLM integration for intelligent content generation
  • Social media publishing capabilities

Admin Console​

The Admin Console is a Next.js web application for managing your stream processing infrastructure:

  • Visual workflow builder with drag-and-drop nodes
  • Event type and source configuration
  • Environment variable management
  • Real-time monitoring and logs
  • Organization and team management

Architecture​

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  Event Sources  │───▶│  AWS Kinesis     │───▶│  Consumer       │
│  (APIs, etc.)   │    │  Stream          │    │  (V8 Isolate)   │
└─────────────────┘    └──────────────────┘    └────────┬────────┘
                                                        │
                                                        ▼
                                               ┌─────────────────┐
                                               │  Workflows      │
                                               │  • Conditions   │
                                               │  • Actions      │
                                               │  • Scripts      │
                                               └────────┬────────┘
                                                        │
                                                        ▼
                                               ┌─────────────────┐
                                               │  Outputs        │
                                               │  • Mastodon     │
                                               │  • Webhooks     │
                                               │  • Storage      │
                                               └─────────────────┘

Key Concepts​

Workflows​

Workflows define how events are processed. Each workflow contains:

  • Triggers: Conditions that determine when the workflow runs
  • Actions: Steps to execute when triggered
  • Scripts: Custom JavaScript code that runs in a secure sandbox

Scripts​

Scripts are JavaScript functions injected into the V8 execution context. They provide capabilities like:

  • Calling AI/LLM services
  • Posting to social media
  • Evaluating complex conditions
  • Debug logging

See the Scripts Reference for complete documentation.

Environment Variables​

Sensitive data like API keys are stored as environment variables at the organization level and securely injected into workflow execution contexts.

Getting Started​

  1. Set up the Admin Console to create your organization and configure event sources
  2. Define event types that your system will process
  3. Build workflows using the visual editor
  4. Add scripts for custom logic and integrations
  5. Deploy the Consumer to start processing events

Next Steps​

  • Scripts Reference — Learn about available script functions
  • Workflow Guide — Building your first workflow (coming soon)
  • Deployment Guide — Running in production (coming soon)