Order Lifecycle

Status transitions

Allowed transitions:

• new -> accepted
• accepted -> in_prep
• in_prep -> ready
• ready -> completed
• new | accepted | in_prep | ready -> cancelled

Terminal states:

• completed
• cancelled

Validate transitions

Use canTransitionOrderStatus before mutation if your UI needs local guards.

import { canTransitionOrderStatus } from "@frappes/firebase"

const allowed = canTransitionOrderStatus("accepted", "in_prep") // true

Update status

await client.updateOrderStatus({
  orderId: "ord_123",
  toStatus: "ready",
  idempotencyKey: "ord_123-ready-v1",
  payload: { station: "kitchen_2" },
})

updateOrderStatus will:

1. read current order in a transaction
2. reject invalid transitions
3. update status and statusUpdatedAt
4. append a status_changed event

Custom events

await client.appendOrderEvent("ord_123", {
  type: "driver_assigned",
  payload: { driverId: "drv_77" },
  idempotencyKey: "ord_123-driver_assigned-v1",
})

If you pass idempotencyKey, the event ID is derived from it (sanitized for Firestore-safe IDs).