Skip to content

gabedalmolin/dispatchlane

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dispatchlane

Dispatchlane is an integration reliability platform for webhook ingestion, outbound event delivery, retries, dead-letter handling, replay, and operational visibility.

Status

Dispatchlane is being built in public. The repository is intentionally developed with small commits, reviewable pull requests, ADRs, and CI discipline from day one.

Thesis

Integration systems usually become brittle first at the reliability boundary, not at the CRUD boundary.

Dispatchlane exists to handle the hard operational parts of integration traffic:

  • inbound webhook ingestion
  • signature verification
  • canonical event persistence
  • deduplication and fingerprinting
  • outbound delivery attempts
  • retry scheduling
  • dead-letter handling
  • replay
  • delivery inspection and auditability
  • health, readiness, metrics, and operator visibility

Current scaffold scope

The current repository scaffold intentionally includes only:

  • Node.js and TypeScript project setup
  • Fastify runtime baseline
  • environment loading
  • minimal API entrypoint
  • GET /healthz
  • CI checks for install, typecheck, and build

The first scaffold does not yet include database, workers, replay, ingestion, or delivery logic.

Planned v1

  • HTTP ingestion endpoint for generic webhook sources
  • HMAC-SHA256 verification with timestamp tolerance
  • immutable ingress receipts
  • immutable canonical events
  • subscription-based HTTP delivery
  • retry policy enforcement
  • dead-letter state
  • replay by event and bounded range
  • inspection APIs for events, deliveries, and attempts
  • health, readiness, metrics, and structured logs

Non-goals for v1

  • exactly-once delivery claims
  • Kafka or RabbitMQ integration
  • arbitrary transformation scripting
  • no-code workflow builder
  • multi-region active-active deployment
  • frontend-heavy operator console

Development

Requirements

  • Node.js 20+

Install

npm install

Run locally

npm run dev

Validate

npm run typecheck
npm run build

Smoke test

curl http://localhost:3000/healthz

Engineering principles

  • explicit contracts over hidden behaviour
  • durable state before acknowledgement
  • immutable history where auditability matters
  • operational clarity over architecture theatre
  • small, reviewable changes
  • documentation that matches real behaviour

Repository workflow

  • main stays stable and reviewable
  • work lands through short-lived branches and pull requests
  • important design decisions are captured as ADRs
  • CI expands with the codebase instead of being added late
  • documentation is maintained alongside implementation

Documentation

Licence

Apache-2.0

About

Integration reliability platform for webhook ingestion, event delivery, retries, dead-letter handling, replay, and operational visibility.

Resources

License

Stars

Watchers

Forks

Contributors