🦗 GRILLOUT SDK & CLI (grillout)

Ephemeral Async Queues, Multicast Stridulation & Zero-Cost Notifications ($0 Infrastructure)
Part of the Terra Ecosystem — https://github.com/amglogicalis/Terra

⚡ Quick Start & Installation

Global CLI Installation

npm install -g grillout
# Or run instantly via npx without installing:
npx grillout --help

SDK Installation in Node.js / TypeScript Projects

npm install grillout

💻 CLI Commands Usage

# 🎛️ Queue Monitor & Batch Management
grillout queue list
grillout queue consume --channel alertas-produccion
grillout queue delete --channel test-queue
grillout queue inspect --channel alertas-produccion

# 📡 Webhook Gateways Pipeline
grillout gateway list
grillout gateway create --channel stripe-events --filter "payload.amount > 50"
grillout gateway edit --channel stripe-events --filter "payload.amount > 100"
grillout gateway delete --channel stripe-events
grillout gateway seed

# 📍 Destination Target Endpoints Registry
grillout target list
grillout target add --alias Discord-DevOps --endpoint https://discord.com/... --type discord
grillout target delete --alias Discord-DevOps
grillout target seed

# 📢 Chirp Multicast Fanout
grillout chirp publish --channel alertas --payload '{"subject": "Alert", "message": "Deploy clean"}'
grillout chirp replay --channel alertas --id chirp_1786432969

# 🧪 Developer Simulator & Template Synthesizer
grillout simulator run --payload '{"amount": 99}' --filter "payload.amount >= 50"
grillout template render --file email_template.html --context '{"user": "Adrian"}'

📦 SDK Programmatic Usage

import { Grillout } from 'grillout';

const grillout = new Grillout({
  githubToken: process.env.GRILLOUT_PAT,
  poisonShieldEnabled: true
});

// Publish a Multicast Chirp
const res = await grillout.publish({
  channel: 'billing-events',
  payload: { amount: 150, status: 'succeeded', user: '[email protected]' },
  priority: 'CRITICAL',
  targets: [
    { type: 'discord', endpoint: 'https://discord.com/api/webhooks/...' },
    { type: 'slack', endpoint: 'https://hooks.slack.com/services/...' }
  ]
});

console.log('Chirp enqueued:', res.chirp.id);

// Consume live batch
const consumed = await grillout.consumeQueue('billing-events');
console.log('Delivered chirps:', consumed.deliveredCount);

🛡️ Security & Privacy Note

This package does NOT hardcode or store any credentials or tokens. All authentication is read dynamically from your local environment variables (GRILLOUT_PAT / GITHUB_TOKEN) or explicitly passed flags.

🌐 Live Web Console

Live Web Console: https://amglogicalis.github.io/grillout-repo-public/

License: MIT