@stacksjs/defaults 0.72.102 → 0.73.0

package/resources/components/Dashboard/Commerce/Delivery/DeliveryRouteDialog.stx

@@ -1,5 +1,5 @@
 <script client>
-interface DriverOption {
+interface CourierOption {
   id: number
   name: string
   vehicle_number: string
@@ -8,8 +8,8 @@ interface DriverOption {
 
 interface DeliveryRouteRecord {
   id: number
-  driver: string
-  driver_id?: number | null
+  courier: string
+  courier_id?: number | null
   vehicle: string
   stops: number
   delivery_time: number
@@ -20,11 +20,11 @@ interface DeliveryRouteRecord {
 const open = useReactiveProp('open', false)
 const mode = useReactiveProp('mode', 'create')
 const record = useReactiveProp('record', null as DeliveryRouteRecord | null)
-const drivers = useReactiveProp('drivers', [] as DriverOption[])
+const couriers = useReactiveProp('couriers', [] as CourierOption[])
 const busy = useReactiveProp('busy', false)
 const error = useReactiveProp('error', '')
 const emit = defineEmits()
-const driverId = state('')
+const courierId = state('')
 const stops = state('0')
 const deliveryTime = state('0')
 const totalDistance = state('0')
@@ -64,26 +64,26 @@ effect(() => {
   if (hydrationKey === nextKey)
     return
   hydrationKey = nextKey
-  driverId.set(current?.driver_id ? String(current.driver_id) : '')
+  courierId.set(current?.courier_id ? String(current.courier_id) : '')
   stops.set(String(current?.stops ?? 0))
   deliveryTime.set(String(current?.delivery_time ?? 0))
   totalDistance.set(String(current?.total_distance ?? 0))
   lastActive.set(toDateTimeLocal(current?.last_active))
 })
 
-function selectedDriver(): DriverOption | undefined {
-  const id = Number(driverId())
-  return drivers().find(driver => driver.id === id)
+function selectedCourier(): CourierOption | undefined {
+  const id = Number(courierId())
+  return couriers().find(courier => courier.id === id)
 }
 
 function submit(): void {
-  const driver = selectedDriver()
+  const courier = selectedCourier()
   const parsedStops = Number(stops())
   const parsedDeliveryTime = Number(deliveryTime())
   const parsedDistance = Number(totalDistance())
 
-  if (!driver) {
-    emit('invalid', 'Select a persisted driver.')
+  if (!courier) {
+    emit('invalid', 'Select a persisted courier.')
     return
   }
   if (!Number.isInteger(parsedStops) || parsedStops < 0) {
@@ -104,9 +104,9 @@ function submit(): void {
   }
 
   emit('submit', {
-    driver: driver.name,
-    driverId: driver.id,
-    vehicle: driver.vehicle_number,
+    courier: courier.name,
+    courierId: courier.id,
+    vehicle: courier.vehicle_number,
     stops: parsedStops,
     deliveryTime: parsedDeliveryTime,
     totalDistance: parsedDistance,
@@ -118,7 +118,7 @@ function submit(): void {
 <Modal
   :isOpen="open()"
   :title="mode() === 'edit' ? 'Edit delivery route' : 'Add delivery route'"
-  description="Assign a persisted driver and record the operational route metrics."
+  description="Assign a persisted courier and record the operational route metrics."
   size="lg"
   @close="emit('close')"
 >
@@ -127,15 +127,15 @@ function submit(): void {
 
         <div class="space-y-4">
           <label class="block">
-            <span class="font-medium text-gray-700 text-sm dark:text-neutral-200">Driver</span>
-            <select x-model="driverId" required class="mt-1 px-3 py-2 w-full text-gray-900 text-sm dark:text-white bg-white dark:bg-neutral-900 border border-gray-300 rounded-md dark:border-neutral-700">
-              <option value="">Select a driver</option>
-              <template :for="driver in drivers()" :key="driver.id"><option :value="driver.id">{{ driver.name }} - {{ driver.vehicle_number }}</option></template>
+            <span class="font-medium text-gray-700 text-sm dark:text-neutral-200">Courier</span>
+            <select x-model="courierId" required class="mt-1 px-3 py-2 w-full text-gray-900 text-sm dark:text-white bg-white dark:bg-neutral-900 border border-gray-300 rounded-md dark:border-neutral-700">
+              <option value="">Select a courier</option>
+              <template :for="courier in couriers()" :key="courier.id"><option :value="courier.id">{{ courier.name }} - {{ courier.vehicle_number }}</option></template>
             </select>
           </label>
-          <div :if="selectedDriver()" class="flex gap-3 items-center p-3 text-gray-600 text-sm dark:text-neutral-300 bg-gray-50 dark:bg-neutral-900/60 border border-gray-200 rounded-lg dark:border-neutral-700">
+          <div :if="selectedCourier()" class="flex gap-3 items-center p-3 text-gray-600 text-sm dark:text-neutral-300 bg-gray-50 dark:bg-neutral-900/60 border border-gray-200 rounded-lg dark:border-neutral-700">
             <span class="h-5 w-5 text-blue-600 i-hugeicons-delivery-truck-02"></span>
-            <span><strong class="text-gray-900 dark:text-white">{{ selectedDriver()?.vehicle_number }}</strong> will be stored as the route vehicle snapshot.</span>
+            <span><strong class="text-gray-900 dark:text-white">{{ selectedCourier()?.vehicle_number }}</strong> will be stored as the route vehicle snapshot.</span>
           </div>
           <div class="grid gap-4 grid-cols-1 sm:grid-cols-3">
             <label class="block"><span class="font-medium text-gray-700 text-sm dark:text-neutral-200">Stops</span><input x-model="stops" type="number" required min="0" step="1" inputmode="numeric" class="mt-1 px-3 py-2 w-full tabular-nums text-gray-900 text-sm dark:text-white bg-white dark:bg-neutral-900 border border-gray-300 rounded-md dark:border-neutral-700" /></label>

package/resources/components/Dashboard/Commerce/Delivery/DeliveryRoutesDashboard.stx

@@ -2,7 +2,7 @@
 import { dashboardApi } from '../../../../../functions/dashboard-api'
 import { pushToast } from '../../../../../functions/toasts'
 
-interface DriverRecord {
+interface CourierRecord {
   id: number
   name: string
   vehicle_number: string
@@ -11,9 +11,9 @@ interface DriverRecord {
 
 interface DeliveryRouteRecord {
   id: number
-  driver: string
-  driver_id?: number | null
-  driver_record?: DriverRecord
+  courier: string
+  courier_id?: number | null
+  courier_record?: CourierRecord
   vehicle: string
   stops: number
   delivery_time: number
@@ -22,8 +22,8 @@ interface DeliveryRouteRecord {
 }
 
 interface DeliveryRoutePayload {
-  driver: string
-  driverId: number
+  courier: string
+  courierId: number
   vehicle: string
   stops: number
   deliveryTime: number
@@ -32,7 +32,7 @@ interface DeliveryRoutePayload {
 }
 
 const records = state<DeliveryRouteRecord[]>([])
-const drivers = state<DriverRecord[]>([])
+const couriers = state<CourierRecord[]>([])
 const loading = state(true)
 const loadError = state('')
 const search = state('')
@@ -47,14 +47,14 @@ const deleting = state<DeliveryRouteRecord | null>(null)
 const deleteBusy = state(false)
 const deleteError = state('')
 
-function driverFor(id?: number | null): DriverRecord | undefined {
-  return id ? drivers().find(driver => driver.id === id) : undefined
+function courierFor(id?: number | null): CourierRecord | undefined {
+  return id ? couriers().find(courier => courier.id === id) : undefined
 }
 
-function withDriver(record: DeliveryRouteRecord): DeliveryRouteRecord {
+function withCourier(record: DeliveryRouteRecord): DeliveryRouteRecord {
   return {
     ...record,
-    driver_record: driverFor(record.driver_id) || record.driver_record,
+    courier_record: courierFor(record.courier_id) || record.courier_record,
   }
 }
 
@@ -70,8 +70,8 @@ function filteredRecords(): DeliveryRouteRecord[] {
     return records()
   return records().filter(record => [
     record.id,
-    record.driver,
-    record.driver_record?.name,
+    record.courier,
+    record.courier_record?.name,
     record.vehicle,
     record.stops,
     record.delivery_time,
@@ -90,7 +90,7 @@ function metricCards(): Array<{ label: string, value: string, detail: string }>
   const activeCutoff = Date.now() - (24 * 60 * 60 * 1000)
   const activeRoutes = records().filter(record => routeTime(record.last_active) >= activeCutoff).length
   return [
-    { label: 'Routes', value: records().length.toLocaleString(), detail: `${records().filter(record => record.driver_id).length} linked to drivers` },
+    { label: 'Routes', value: records().length.toLocaleString(), detail: `${records().filter(record => record.courier_id).length} linked to couriers` },
     { label: 'Stops', value: totalStops.toLocaleString(), detail: 'Across the current route plan' },
     { label: 'Distance', value: `${totalDistance.toLocaleString()} mi`, detail: 'Planned route distance' },
     { label: 'Active in 24h', value: activeRoutes.toLocaleString(), detail: 'Based on persisted activity time' },
@@ -101,14 +101,14 @@ async function loadRoutes(): Promise<void> {
   loading.set(true)
   loadError.set('')
   try {
-    const [routeData, driverData] = await Promise.all([
+    const [routeData, courierData] = await Promise.all([
       dashboardApi<DeliveryRouteRecord[]>('/api/dashboard/commerce/delivery-routes'),
-      dashboardApi<DriverRecord[]>('/api/dashboard/commerce/drivers'),
+      dashboardApi<CourierRecord[]>('/api/dashboard/commerce/couriers'),
     ])
-    if (!Array.isArray(routeData) || !Array.isArray(driverData))
+    if (!Array.isArray(routeData) || !Array.isArray(courierData))
       throw new TypeError('Delivery route resources were not returned in the expected shape.')
-    drivers.set(driverData)
-    records.set(routeData.map(withDriver))
+    couriers.set(courierData)
+    records.set(routeData.map(withCourier))
     const lastPage = Math.max(1, Math.ceil(filteredRecords().length / perPage()))
     if (page() > lastPage)
       page.set(lastPage)
@@ -167,7 +167,7 @@ async function saveRoute(payload: DeliveryRoutePayload): Promise<void> {
         body: payload,
       },
     )
-    const hydrated = withDriver(updated)
+    const hydrated = withCourier(updated)
     if (current) {
       records.set(records().map(record => record.id === current.id ? hydrated : record))
     }
@@ -240,16 +240,16 @@ onMount(() => {
   <header class="flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between">
     <div>
       <h1 class="font-bold text-2xl text-gray-900 dark:text-white">Delivery routes</h1>
-      <p class="mt-1 text-gray-500 text-sm dark:text-neutral-400">Assign persisted drivers and track route workload, distance, and activity.</p>
+      <p class="mt-1 text-gray-500 text-sm dark:text-neutral-400">Assign persisted couriers and track route workload, distance, and activity.</p>
     </div>
     <div class="flex gap-2">
       <Button :loading="loading()" variant="secondary" @click="loadRoutes()"><span :if="!loading()" aria-hidden="true" class="h-4 w-4 i-hugeicons-refresh"></span>Refresh</Button>
-      <Button :disabled="loading() || drivers().length === 0" @click="openCreate()"><span aria-hidden="true" class="h-4 w-4 i-hugeicons-add-01"></span>Add route</Button>
+      <Button :disabled="loading() || couriers().length === 0" @click="openCreate()"><span aria-hidden="true" class="h-4 w-4 i-hugeicons-add-01"></span>Add route</Button>
     </div>
   </header>
 
   <div :if="loadError()" class="flex gap-4 items-center justify-between p-4 text-red-700 text-sm dark:text-red-300 bg-red-50 dark:bg-red-950/30 border border-red-200 rounded-lg dark:border-red-900"><span>{{ loadError() }}</span><Button variant="secondary" size="sm" @click="loadRoutes()">Retry</Button></div>
-  <div :if="!loading() && drivers().length === 0" class="p-4 text-amber-800 text-sm dark:text-amber-200 bg-amber-50 dark:bg-amber-950/30 border border-amber-200 rounded-lg dark:border-amber-900">Add a driver before creating a delivery route.</div>
+  <div :if="!loading() && couriers().length === 0" class="p-4 text-amber-800 text-sm dark:text-amber-200 bg-amber-50 dark:bg-amber-950/30 border border-amber-200 rounded-lg dark:border-amber-900">Add a courier before creating a delivery route.</div>
 
   <section aria-label="Delivery route metrics" class="grid gap-3 grid-cols-1 sm:grid-cols-2 xl:grid-cols-4">
     <template :for="item in metricCards()" :key="item.label"><article class="p-4 bg-white dark:bg-neutral-800 border border-gray-200 rounded-lg dark:border-neutral-700"><p class="text-gray-500 text-xs dark:text-neutral-400">{{ item.label }}</p><p class="mt-2 font-semibold text-2xl text-gray-900 dark:text-white">{{ item.value }}</p><p class="mt-1 text-gray-400 text-xs dark:text-neutral-500">{{ item.detail }}</p></article></template>
@@ -268,5 +268,5 @@ onMount(() => {
   </section>
 </div>
 
-<DeliveryRouteDialog :open="editorOpen()" :mode="editorMode()" :record="editing()" :drivers="drivers()" :busy="saving()" :error="editorError()" @submit="saveRoute" @invalid="setEditorError" @close="closeEditor()" />
+<DeliveryRouteDialog :open="editorOpen()" :mode="editorMode()" :record="editing()" :couriers="couriers()" :busy="saving()" :error="editorError()" @submit="saveRoute" @invalid="setEditorError" @close="closeEditor()" />
 <DeliveryRouteDeleteDialog :open="Boolean(deleting())" :record="deleting()" :busy="deleteBusy()" :error="deleteError()" @confirm="confirmDelete()" @close="closeDelete()" />

package/resources/components/Dashboard/Commerce/Delivery/DeliveryRoutesTable.stx

@@ -1,9 +1,9 @@
 <script client>
 interface DeliveryRouteRow {
   id: number
-  driver: string
-  driver_id?: number | null
-  driver_record?: { id: number, name: string, vehicle_number: string }
+  courier: string
+  courier_id?: number | null
+  courier_record?: { id: number, name: string, vehicle_number: string }
   vehicle: string
   stops: number
   delivery_time: number
@@ -39,7 +39,7 @@ function formatNumber(value: number): string {
     <thead class="bg-stone-50/80 dark:bg-neutral-800">
       <tr>
         <th scope="col" class="pl-6 pr-3 py-3.5 font-semibold text-left text-stone-500 text-xs tracking-wider uppercase dark:text-neutral-400">Route</th>
-        <th scope="col" class="px-4 py-3.5 font-semibold text-left text-stone-500 text-xs tracking-wider uppercase dark:text-neutral-400">Driver</th>
+        <th scope="col" class="px-4 py-3.5 font-semibold text-left text-stone-500 text-xs tracking-wider uppercase dark:text-neutral-400">Courier</th>
         <th scope="col" class="px-4 py-3.5 font-semibold text-left text-stone-500 text-xs tracking-wider uppercase dark:text-neutral-400">Vehicle</th>
         <th scope="col" class="px-4 py-3.5 font-semibold text-left text-stone-500 text-xs tracking-wider uppercase dark:text-neutral-400">Stops</th>
         <th scope="col" class="px-4 py-3.5 font-semibold text-left text-stone-500 text-xs tracking-wider uppercase dark:text-neutral-400">Time</th>
@@ -57,8 +57,8 @@ function formatNumber(value: number): string {
             #{{ route.id }}
           </td>
           <td class="px-4 py-3.5 font-medium text-sm text-stone-800 whitespace-nowrap dark:text-white">
-            <span class="block">{{ route.driver_record?.name || route.driver }}</span>
-            <span class="block font-normal text-stone-400 text-xs dark:text-neutral-500">{{ route.driver_id ? 'Linked driver #' + route.driver_id : 'Legacy snapshot' }}</span>
+            <span class="block">{{ route.courier_record?.name || route.courier }}</span>
+            <span class="block font-normal text-stone-400 text-xs dark:text-neutral-500">{{ route.courier_id ? 'Linked courier #' + route.courier_id : 'Legacy snapshot' }}</span>
           </td>
           <td class="px-4 py-3.5 text-sm text-stone-500 whitespace-nowrap dark:text-neutral-300">
             {{ route.vehicle }}
@@ -81,7 +81,7 @@ function formatNumber(value: number): string {
               size="sm"
               iconOnly
               @click="emit('edit', route)"
-              :ariaLabel="'Edit delivery route ' + route.id + ' for ' + route.driver"
+              :ariaLabel="'Edit delivery route ' + route.id + ' for ' + route.courier"
             >
               <span class="block h-4 w-4 text-blue-500 i-hugeicons-edit-01"></span>
             </Button>
@@ -90,7 +90,7 @@ function formatNumber(value: number): string {
               size="sm"
               iconOnly
               @click="emit('delete', route)"
-              :ariaLabel="'Delete delivery route ' + route.id + ' for ' + route.driver"
+              :ariaLabel="'Delete delivery route ' + route.id + ' for ' + route.courier"
             >
               <span class="block h-4 w-4 text-red-500 i-hugeicons-waste"></span>
             </Button>

package/resources/components/Dashboard/Commerce/Delivery/TabNavigation.stx

@@ -13,7 +13,7 @@ const tabs = [
   { name: 'Digital Delivery', value: 'digital', href: '/commerce/delivery/digital-delivery' },
   { name: 'License Keys', value: 'license', href: '/commerce/delivery/license-keys' },
   { name: 'Delivery Routes', value: 'routes', href: '/commerce/delivery/delivery-routes' },
-  { name: 'Drivers', value: 'drivers', href: '/commerce/delivery/drivers' },
+  { name: 'Couriers', value: 'couriers', href: '/commerce/delivery/couriers' },
 ]
 </script>
 <div ref="pageRoot">

package/resources/functions/dashboard/data.ts

@@ -102,7 +102,7 @@ const MODEL_PATHS: Record<string, string[]> = {
   ShippingZone: ['app/Models/ShippingZone.ts', 'storage/framework/defaults/app/Models/commerce/ShippingZone.ts'],
   DeliveryRoute: ['app/Models/DeliveryRoute.ts', 'storage/framework/defaults/app/Models/commerce/DeliveryRoute.ts'],
   DigitalDelivery: ['app/Models/DigitalDelivery.ts', 'storage/framework/defaults/app/Models/commerce/DigitalDelivery.ts'],
-  Driver: ['app/Models/Driver.ts', 'storage/framework/defaults/app/Models/commerce/Driver.ts'],
+  Courier: ['app/Models/Courier.ts', 'storage/framework/defaults/app/Models/commerce/Courier.ts'],
   TaxRate: ['app/Models/TaxRate.ts', 'storage/framework/defaults/app/Models/commerce/TaxRate.ts'],
   WaitlistProduct: ['app/Models/WaitlistProduct.ts', 'storage/framework/defaults/app/Models/commerce/WaitlistProduct.ts'],
   WaitlistRestaurant: ['app/Models/WaitlistRestaurant.ts', 'storage/framework/defaults/app/Models/commerce/WaitlistRestaurant.ts'],

package/resources/functions/dashboard/sidebar.ts

@@ -417,7 +417,7 @@ export function buildNavSections(
         'manufacturer', 'review', 'coupon', 'gift-card', 'payment', 'category',
         'cart', 'cart-item', 'order-item', 'tax-rate',
         'shipping-method', 'shipping-rate', 'shipping-zone',
-        'delivery-route', 'driver', 'license-key', 'digital-delivery',
+        'delivery-route', 'courier', 'license-key', 'digital-delivery',
         'print-device', 'receipt',
         'waitlist-product', 'waitlist-restaurant',
       ])),
@@ -431,7 +431,7 @@ export function buildNavSections(
       { to: '/commerce/delivery/shipping-methods', icon: 'truck', text: 'Shipping Methods' },
       { to: '/commerce/delivery/shipping-rates', icon: 'percent', text: 'Shipping Rates' },
       { to: '/commerce/delivery/shipping-zones', icon: 'globe', text: 'Shipping Zones' },
-      { to: '/commerce/delivery/drivers', icon: 'user', text: 'Drivers' },
+      { to: '/commerce/delivery/couriers', icon: 'user', text: 'Couriers' },
       { to: '/commerce/delivery/delivery-routes', icon: 'globe', text: 'Routes' },
       { to: '/commerce/delivery/license-keys', icon: 'lock', text: 'License Keys' },
       { to: '/commerce/delivery/digital-delivery', icon: 'package', text: 'Digital Delivery' },

package/routes/dashboard-api.ts

@@ -351,7 +351,7 @@ route.group({ prefix: '/api/dashboard', apiResponse: true }, () => {
   // guard so production totals are never protected by client-side role checks.
   guard(route.get('/commerce/stats', 'Actions/Dashboard/Commerce/CommerceDashboardAction'))
 
-  // Delivery operations overview. Guarded because route and driver data is
+  // Delivery operations overview. Guarded because route and courier data is
   // operational information even though the underlying models expose their
   // own generated useApi endpoints.
   guard(route.get('/commerce/delivery', 'Actions/Dashboard/Commerce/CommerceDeliveryAction'))
@@ -383,11 +383,11 @@ route.group({ prefix: '/api/dashboard', apiResponse: true }, () => {
   guard(route.patch('/commerce/delivery-routes/{id}', 'Actions/Commerce/Shipping/DeliveryRouteUpdateAction'))
   guard(route.delete('/commerce/delivery-routes/{id}', 'Actions/Commerce/Shipping/DeliveryRouteDestroyAction'))
 
-  guard(route.get('/commerce/drivers', 'Actions/Dashboard/Commerce/DriverIndexAction'))
-  guard(route.get('/commerce/drivers/{id}', 'Actions/Commerce/Shipping/DriverShowAction'))
-  guard(route.post('/commerce/drivers', 'Actions/Commerce/Shipping/DriverStoreAction'))
-  guard(route.patch('/commerce/drivers/{id}', 'Actions/Commerce/Shipping/DriverUpdateAction'))
-  guard(route.delete('/commerce/drivers/{id}', 'Actions/Commerce/Shipping/DriverDestroyAction'))
+  guard(route.get('/commerce/couriers', 'Actions/Dashboard/Commerce/CourierIndexAction'))
+  guard(route.get('/commerce/couriers/{id}', 'Actions/Commerce/Shipping/CourierShowAction'))
+  guard(route.post('/commerce/couriers', 'Actions/Commerce/Shipping/CourierStoreAction'))
+  guard(route.patch('/commerce/couriers/{id}', 'Actions/Commerce/Shipping/CourierUpdateAction'))
+  guard(route.delete('/commerce/couriers/{id}', 'Actions/Commerce/Shipping/CourierDestroyAction'))
 
   guard(route.get('/commerce/digital-deliveries', 'Actions/Dashboard/Commerce/DigitalDeliveryIndexAction'))
   guard(route.get('/commerce/digital-deliveries/{id}', 'Actions/Commerce/Shipping/DigitalDeliveryShowAction'))

package/routes/dashboard.ts

@@ -439,9 +439,9 @@ route.group({ prefix: '/api/commerce', middleware: 'auth' }, () => {
   // Shipping (moved from a top-level /shipping group on 2026-05-08).
   // The frontend composables (defaults/functions/commerce/shippings/*.ts)
   // all expect these resources under /commerce/*, so the prior /shipping
-  // group was orphaned — every shipping/driver/license/digital call
+  // group was orphaned — every shipping/courier/license/digital call
   // from the dashboard was 404ing. Resource names match the composable
-  // file names: shipping-methods/rates/zones, delivery-routes, drivers,
+  // file names: shipping-methods/rates/zones, delivery-routes, couriers,
   // digital-deliveries, license-keys.
   // ----------------------------------------------------------------
   route.get('/shipping-methods', 'Actions/Commerce/Shipping/ShippingMethodIndexAction')
@@ -468,11 +468,11 @@ route.group({ prefix: '/api/commerce', middleware: 'auth' }, () => {
   route.patch('/delivery-routes/{id}', 'Actions/Commerce/Shipping/DeliveryRouteUpdateAction')
   route.delete('/delivery-routes/{id}', 'Actions/Commerce/Shipping/DeliveryRouteDestroyAction')
 
-  route.get('/drivers', 'Actions/Commerce/Shipping/DriverIndexAction')
-  route.get('/drivers/{id}', 'Actions/Commerce/Shipping/DriverShowAction')
-  route.post('/drivers', 'Actions/Commerce/Shipping/DriverStoreAction')
-  route.patch('/drivers/{id}', 'Actions/Commerce/Shipping/DriverUpdateAction')
-  route.delete('/drivers/{id}', 'Actions/Commerce/Shipping/DriverDestroyAction')
+  route.get('/couriers', 'Actions/Commerce/Shipping/CourierIndexAction')
+  route.get('/couriers/{id}', 'Actions/Commerce/Shipping/CourierShowAction')
+  route.post('/couriers', 'Actions/Commerce/Shipping/CourierStoreAction')
+  route.patch('/couriers/{id}', 'Actions/Commerce/Shipping/CourierUpdateAction')
+  route.delete('/couriers/{id}', 'Actions/Commerce/Shipping/CourierDestroyAction')
 
   // Renamed from `/digital` — frontend composable expects `/digital-deliveries`.
   route.get('/digital-deliveries', 'Actions/Commerce/Shipping/DigitalDeliveryIndexAction')

package/routes/delivery.ts

@@ -0,0 +1,24 @@
+import { route } from '@stacksjs/router'
+
+/**
+ * Courier-facing delivery endpoints.
+ *
+ * The tracking pipeline in `@stacksjs/commerce` has always been able to ingest
+ * a position, recompute an ETA and broadcast it - it just had no way in from a
+ * device. These are that way in.
+ *
+ * Every route authorises against the courier the session belongs to, not
+ * against an id in the body, so one courier cannot post positions or complete
+ * stops as another. `CourierPing` deliberately has no `useApi` surface: the
+ * generated CRUD would let a client write the ping row directly and skip the
+ * position update, ETA recompute, broadcast and arrival latching that make a
+ * ping mean anything.
+ */
+
+route.post('/delivery/pings', 'Actions/Commerce/Shipping/CourierPingStoreAction')
+
+route.post('/delivery/routes/{id}/start', 'Actions/Commerce/Shipping/DeliveryRouteStartAction')
+
+route.post('/delivery/stops/{id}/start', 'Actions/Commerce/Shipping/DeliveryStopStartAction')
+route.post('/delivery/stops/{id}/complete', 'Actions/Commerce/Shipping/DeliveryStopCompleteAction')
+route.post('/delivery/stops/{id}/fail', 'Actions/Commerce/Shipping/DeliveryStopFailAction')

package/types/defaults.ts

@@ -195,7 +195,7 @@ export interface Reviews {
 
 export type NewReview = Omit<Reviews, 'id'>
 
-export interface Drivers {
+export interface Couriers {
   id: number
   user_id: number
   name: string
@@ -207,7 +207,7 @@ export interface Drivers {
 
 }
 
-export type NewDriver = Omit<Drivers, 'id'>
+export type NewCourier = Omit<Couriers, 'id'>
 
 export interface LicenseKeys {
   id: number
@@ -242,7 +242,7 @@ export interface LicenseTemplates {
 
 export interface DeliveryRoutes {
   id: number
-  driver: string
+  courier: string
   vehicle: string
   stops: number
   delivery_time: number

package/views/dashboard/.discovered-models.json

@@ -151,6 +151,23 @@
         "highlight": true
       }
     },
+    {
+      "id": "courier",
+      "name": "Courier",
+      "icon": "car.fill",
+      "hasDedicatedPage": false,
+      "category": "commerce",
+      "dashboard": {
+        "highlight": true
+      }
+    },
+    {
+      "id": "courier-ping",
+      "name": "CourierPing",
+      "icon": "tablecells.fill",
+      "hasDedicatedPage": false,
+      "category": "commerce"
+    },
     {
       "id": "customer",
       "name": "Customer",
@@ -201,23 +218,6 @@
         "highlight": true
       }
     },
-    {
-      "id": "driver",
-      "name": "Driver",
-      "icon": "car.fill",
-      "hasDedicatedPage": false,
-      "category": "commerce",
-      "dashboard": {
-        "highlight": true
-      }
-    },
-    {
-      "id": "driver-ping",
-      "name": "DriverPing",
-      "icon": "tablecells.fill",
-      "hasDedicatedPage": false,
-      "category": "commerce"
-    },
     {
       "id": "email-idempotency",
       "name": "EmailIdempotency",
@@ -696,4 +696,4 @@
     }
   },
   "nav": []
-}
+}

package/views/dashboard/AUDIT.md

@@ -19,7 +19,7 @@ described the componentized dashboard.
 | Direct `fetch()` calls in dashboard views, components, and stores | 0 |
 
 The eleven models without `useApi` are internal, relationship-owned, or
-provider-owned records: driver pings, order idempotency keys, order items,
+provider-owned records: courier pings, order idempotency keys, order items,
 errors, jobs, failed jobs, payment methods, payment products, payment
 transactions, social accounts, and subscriptions. They are not missing generic
 CRUD surfaces.

package/views/dashboard/commerce/delivery/{drivers.stx → couriers.stx}

@@ -1,10 +1,10 @@
 @extends('layouts/default')
 
 @section('content')
-@title('Dashboard - Delivery Drivers')
+@title('Dashboard - Delivery Couriers')
 
 <div class="p-4 lg:p-8 min-h-[100dvh] dark:bg-neutral-900">
-  <DriversDashboard />
+  <CouriersDashboard />
 </div>
 
 @endsection

package/views/dashboard/composables/useChart.ts

@@ -57,10 +57,15 @@ export interface ChartHandle {
   update: () => void
 }
 
+/** A handle that renders nothing, for the cases where there is no canvas to draw on. */
+function inertHandle(): ChartHandle {
+  return { instance: null, destroy: () => {}, update: () => {} }
+}
+
 export function useChart(opts: UseChartOptions): ChartHandle {
   // SSR-safe — no document means no canvas.
   if (typeof document === 'undefined')
-    return { instance: null, destroy: () => {}, update: () => {} }
+    return inertHandle()
 
   const el = document.getElementById(opts.id)
   if (!el) {
@@ -69,7 +74,16 @@ export function useChart(opts: UseChartOptions): ChartHandle {
     // missing chart and can grep the id.
     // eslint-disable-next-line no-console
     console.warn(`[useChart] no element with id "${opts.id}". Chart not initialised.`)
-    return { instance: null, destroy: () => {}, update: () => {} }
+    return inertHandle()
+  }
+
+  // Chart draws on a canvas, and an id that resolves to a `<div>` is the same
+  // class of page mistake as an id that resolves to nothing: worth the same
+  // warning rather than a stack trace from inside the chart library.
+  if (!(el instanceof HTMLCanvasElement)) {
+    // eslint-disable-next-line no-console
+    console.warn(`[useChart] element with id "${opts.id}" is a <${el.tagName.toLowerCase()}>, not a <canvas>. Chart not initialised.`)
+    return inertHandle()
   }
 
   const instance = new opts.Chart(el, { type: opts.type, data: opts.data, options: opts.options })

package/views/dashboard/layouts/default.stx

@@ -644,7 +644,7 @@ onDestroy(() => {
       <!-- Chrome strip. The traffic lights are the platform's, so this draws
           none and reserves whatever room the host says they need. Craft
           measures its own window: the far edge of the real buttons where they
-          float over this sidebar, and nothing where they do not — a window
+          float over this sidebar, and nothing where they do not: a window
           that keeps them in a titlebar, a fullscreen one whose titlebar has
           slid away, or a browser, which has no window buttons at all. It is also the window drag
           region, and in a browser it is the same empty strip macOS sidebars

package/app/Actions/Dashboard/Commerce/DriverIndexAction.ts

@@ -1,24 +0,0 @@
-import { Action } from '@stacksjs/actions'
-import { Driver, User } from '@stacksjs/orm'
-import { dashboardOperationalError } from '../dashboard-response'
-import { indexDriverUsers, normalizeDriverRecord } from './driver-records'
-
-export default new Action({
-  name: 'Dashboard Drivers',
-  description: 'Returns validated drivers and their optional User relationships.',
-  method: 'GET',
-  apiResponse: true,
-
-  async handle() {
-    try {
-      const drivers = await Driver.orderBy('name', 'asc').limit(500).get()
-      const userIds = [...new Set(drivers.map(driver => driver.get('user_id')).filter(Boolean))]
-      const users = userIds.length ? await User.whereIn('id', userIds).get() : []
-      const usersById = indexDriverUsers(users)
-      return drivers.map(driver => normalizeDriverRecord(driver, usersById))
-    }
-    catch (error) {
-      return dashboardOperationalError(error, 'Driver records could not be read.', 'DriverIndexAction')
-    }
-  },
-})

package/functions/commerce/shippings/drivers.ts

@@ -1,19 +0,0 @@
-import type { Drivers, NewDriver } from '../../../types/defaults'
-import { createDashboardResource } from './dashboard-resource'
-
-const resource = createDashboardResource<Drivers, NewDriver>({
-  path: '/api/dashboard/commerce/drivers',
-  storageKey: 'drivers',
-  singular: 'driver',
-  plural: 'drivers',
-})
-
-export function useDrivers() {
-  return {
-    drivers: resource.items,
-    fetchDrivers: resource.fetchAll,
-    createDriver: resource.create,
-    updateDriver: resource.update,
-    deleteDriver: resource.destroy,
-  }
-}