zio / zio-webhooks   0.1.5

GitHub

A microlibrary for reliable and persistent webhook delivery

zio-webhooks

Project Stage CI Release Snapshot Discord
Project stage CI Release Artifacts Snapshot Artifacts Badge-Discord

Summary

Microlibrary for reliable and persistent webhook delivery.

Getting Started

There are two ways to start a webhook server: as part of the managed construction of its live layer WebhookServer.live, or manually by calling WebhookServer.start. See examples for a list of code examples. The managed approach is recommended as it guarantees the server shuts down gracefully. Make sure to call shutdown on a server created manually. Either way, users will have to implement the following dependencies that are part of WebhookServer's environment:

  • WebhookRepo - to get webhooks and update webhook status;
  • WebhookEventRepo - to subscribe to events and update event status;
  • WebhookHttpClient - to deliver events via HTTP POST (WebhookSttpClient is provided and ready to use);
  • WebhookServerConfig - to specify settings for error hub capacity, retrying, and batching; and
  • SerializePayload - for specifying custom serialization of single and batched event payloads of some content type.

Example Programs

Documentation

ZIO Webhooks Microsite

Contributing

Documentation for contributors

Code of Conduct

See the Code of Conduct

Support

Come chat with us on Badge-Discord.

License

License