Path watchers with local callbacks plus gossip drive-change notifications; bridge to hyper-p2p-distributed-event-bus for app-wide fanout. Hyperswarm gossip when topic is set.

Category: Storage (Hyperdrive)

Composes with: hyper-p2p-distributed-event-bus

Protocol: drive-watch-notify/v1

When to use

Drive tree changes must reach remote peers subscribed on the same topic.

When not to use

Local-only file notifications without swarm.

Quick start

const { HyperP2PDriveWatchNotify } = require('hyper-p2p-drive-watch-notify')
const topic = process.argv[2] // 64-char hex or string
const mod = new HyperP2PDriveWatchNotify({ topic })
await mod.ready()   // joins swarm when topic set
// ... application logic ...
await mod.close()

Docs

docs/api.md — constructor, methods, events, errors
docs/architecture.md — wire types, state, composition
../_shared/PRODUCTION.md — production checklist
../_shared/DOC_STANDARDS.md — documentation standards

Test

npm install && npm test