updates on the api endpoints on the customer page and more

constants/constants.go

@@ -75,6 +75,37 @@ const (
 	ErrOtpInvalid             = "OTP_INVALID"
 	ErrIdempotencyInProgress  = "IDEMPOTENCY_IN_PROGRESS" // an identical keyed request is still running
 	ErrEmailInUse             = "EMAIL_IN_USE"
+	ErrHubNotFound            = "HUB_NOT_FOUND" // hub_id on a handover does not resolve to an active base
+	ErrHubRequired            = "HUB_REQUIRED"  // handover attempted with no base to hand over to
+)
+
+// Pickup source types — what kind of place a booking is collected FROM. Sent
+// on every miler booking row as pickup_source_type so the rider app can title a
+// stop correctly instead of guessing from the source name, the pincode or the
+// rider's own base. "customer" is a real value, never an omission: a front-door
+// pickup has no configured location id, and "no location because it is a front
+// door" must be distinguishable from "no location because nobody filled it in".
+//
+// The rider app renders "hub" as Base — the wire value stays hub.
+const (
+	PickupSourceHub      = "hub"
+	PickupSourceCustomer = "customer"
+	PickupSourceMerchant = "merchant"
+	PickupSourceStore    = "store"
+)
+
+// Next actions — what the rider does next with a parcel. Returned by
+// pickup-complete and, so a poll or a cold restart can rebuild the leg without
+// a local cache, on every GET /miler/bookings row. Consignment status alone
+// cannot carry this: a hub-routed parcel and a freshly-collected hyperlocal one
+// can both sit on Created.
+const (
+	NextActionPickup        = "pickup"         // not collected yet — the stop is the pickup
+	NextActionStartDelivery = "start_delivery" // collected, hyperlocal, not yet out for delivery
+	NextActionDeliver       = "deliver"        // carry it to the receiver
+	NextActionInwardAtHub   = "inward_at_hub"  // carry it to a base and hand it over
+	NextActionHandedToHub   = "handed_to_hub"  // already inwarded at the base — nothing left for this rider
+	NextActionNone          = "none"           // terminal (delivered, cancelled, returned)
 )
 
 // Payment Modes