| name | commerce-events |
| description | Stream real-time commerce events and manage webhooks. Use when debugging live behavior (orders/inventory/customers/products/returns) or integrating external systems via webhooks. |
Commerce Events
Stream real-time commerce domain events (pub/sub) and manage webhook endpoints for event delivery.
How It Works
- Subscribe to an in-process event stream.
- Filter events by category (orders, inventory, customers, products, returns).
- Output as human-readable lines or JSON (one event per line).
- Optionally manage webhook endpoints for event delivery.
Usage
- CLI:
stateset-events, stateset-events --filter orders, stateset-events --json.
- Webhooks:
stateset-events webhooks list, stateset-events webhooks add <url>, stateset-events webhooks remove <id>.
Event Fields
event_type: Event type as snake_case (e.g. order_created, inventory_adjusted).timestamp: RFC3339 timestamp.- Domain fields depend on event type (e.g.
order_id, customer_id, sku, quantity).
- Note: the raw serde tag is
type; the Node binding also adds event_type for convenience.
Output
{"event_type":"order_created","order_id":"...","customer_id":"...","total_amount":"100.00","item_count":2,"timestamp":"2026-02-10T00:00:00Z","type":"order_created"}
Present Results to User
- Keep output scannable: show
event_type, timestamp, and the most relevant identifiers.
- When filtering, state which categories or event types are included.
- For inventory, highlight
quantity_change and new_quantity when present.
Troubleshooting
- No events arriving: ensure you subscribed before triggering the operation that emits the event.
- Filter returns nothing: check event types are snake_case and match the core enum.
- Webhooks not listed: webhooks are in-process and not persisted unless you add persistence on top.
References
- /home/dom/stateset-icommerce/crates/stateset-core/src/events.rs
- /home/dom/stateset-icommerce/crates/stateset-embedded/src/events/mod.rs
- /home/dom/stateset-icommerce/cli/bin/stateset-events.js
- /home/dom/stateset-icommerce/bindings/node/src/lib.rs
