Emit Stock Updated Event on Inventory Reconciliation

Summary

Expose a new event that fires whenever WMS/ERP updates product variant stock in Brink, so that downstream consumers (e.g. auction services) can listen and reconcile their own inventory counts in near-real-time.

Background & Motivation

External services that manage their own view of available stock currently have no way to know when a warehouse has updated inventory in Brink. They need a reliable event to trigger their own stock reconciliation logic, particularly when quantity increases after a restock or replenishment from WMS.

Use Cases

1. Stock reconciliation — A warehouse sends updated stock levels to Brink. An external auction service listens to the event and adjusts its own inventory accordingly.

Proposed Behaviour Emit a stock.updated event (or equivalent) on theProductVariantInventory resource whenever stock quantity is changed via the inventory API (i.e. WMS/ERP-initiated updates). The event payload should include:

• productVariantId

• inventoryId

• before.quantity

• after.quantity

• timestamp

This enables consumers to derive their own logic, such as: Reconciliation — before.quantity < after.quantity (restock / replenishment)