modules/scheduling-queues/hyper-p2p-cron-gossip

hyper-p2p-cron-gossip

Distributed cron scheduling with local tick() and remote cron-fire gossip.

Category: Scheduling & queues · Protocol: cron-gossip/v1

When to use

Cluster-wide periodic tasks, @every intervals, or classic five-field UTC cron strings shared on a topic.

When not to use

Sub-second precision timers, single-process setInterval only, or durable job queues (use deadline/activity queues).

Quick start

const { HyperP2PCronGossip } = require('hyper-p2p-cron-gossip')
const cron = new HyperP2PCronGossip({ topic: process.argv[2] })
await cron.ready()
cron.schedule('@every 5s', 'heartbeat')
setInterval(() => cron.tick(), 1000)

Docs

docs/api.md · docs/architecture.md

Test

npm install && npm test · bare examples/basic.js [topic]