Skip to content

v0.3.0

Choose a tag to compare

View all tags
@webpatser webpatser released this 21 May 18:50
v0.3.0
63d666d

Server-side plugin API. Resonate stays a product-agnostic Pusher relay, but a host application can now load ServerPlugin classes into the server process to intercept messages, observe the connection lifecycle, and run periodic ticks on the event loop. Ordinary Pusher traffic is unaffected: when every plugin returns Relay, routing is byte-identical to before.

Added

  • Webpatser\Resonate\Plugins namespace: ServerPlugin marker contract plus the MessageInterceptor, ConnectionLifecycle, and TickScheduler capability interfaces.
  • MessageDisposition enum (Handled / Rejected / Relay) returned by interceptors.
  • PluginManager - capability-indexed registry; every fan-out call is exception-isolated so a plugin error cannot break the core.
  • PluginContext - the API handed to plugins at boot: sendTo(), broadcast() (scaling-aware), terminate(), connectionsOn(), plus application() / applications().
  • Per-connection plugin state bag on the Connection contract: setState(), state(), hasState(), forgetState().
  • New config key reverb.servers.reverb.plugins, an array of ServerPlugin class names resolved through the container.
  • Scheduler (Webpatser\Resonate\Scheduling\Scheduler) - a thin layer over the Revolt event loop. Every task runs inside a fiber and is exception-isolated, named for logging, and cancellable.

Changed

  • Server::message() runs the interceptor chain after validation and before the pusher: / client-* split; Server::open() / close() and EventHandler::afterSubscribe() fire the lifecycle hooks.
  • A message a plugin marks Handled or Rejected no longer fires the MessageReceived event or logs Message Handled; both are now scoped to traffic the core actually routed (Relay).
  • StartServer registers all periodic work through the Scheduler instead of bare EventLoop::repeat calls, so every task is fiber-wrapped and exception-isolated. Periodic tasks are cancelled when the server begins to drain or stop.

Docs

  • New docs/plugins.md - a full setup walkthrough with a worked plugin implementing all three capabilities.

Suite grows to 313 tests.

Assets 2
Loading