@stacksjs/defaults 0.72.103 → 0.73.0

package/app/Actions/Dashboard/Commerce/commerce-delivery.ts

@@ -6,7 +6,7 @@ export interface DeliveryOverviewStat {
 
 export interface DeliveryOverviewRoute {
   id: number
-  driver: string
+  courier: string
   vehicle: string
   stops: number
   duration: string
@@ -35,7 +35,7 @@ export interface DeliveryOverviewResult {
   routes: DeliveryOverviewRoute[]
   methods: DeliveryOverviewMethod[]
   zones: DeliveryOverviewZone[]
-  drivers: {
+  couriers: {
     total: number
     active: number
     onDelivery: number
@@ -87,30 +87,30 @@ export function buildDeliveryOverview(
   methodRows: any[],
   routeRows: any[],
   zoneRows: any[],
-  driverRows: any[],
+  courierRows: any[],
   currency = 'USD',
   now = new Date(),
 ): DeliveryOverviewResult {
   const normalizedCurrency = commerceCurrency(currency, 'Commerce configuration')
-  const normalizedDrivers = driverRows.map((driver) => {
-    const identifier = commerceIdentifier(commerceValue(driver, 'id', 'uuid'), 'Driver')
-    const source = `Driver ${identifier}`
+  const normalizedCouriers = courierRows.map((courier) => {
+    const identifier = commerceIdentifier(commerceValue(courier, 'id', 'uuid'), 'Courier')
+    const source = `Courier ${identifier}`
     return {
       id: identifier,
-      name: commerceRequiredString(commerceValue(driver, 'name'), source, 'name'),
+      name: commerceRequiredString(commerceValue(courier, 'name'), source, 'name'),
       vehicle: commerceRequiredString(
-        commerceValue(driver, 'vehicle_number', 'vehicleNumber'),
+        commerceValue(courier, 'vehicle_number', 'vehicleNumber'),
         source,
         'vehicle_number',
       ),
-      status: commerceEnum(commerceValue(driver, 'status'), source, 'status', [
+      status: commerceEnum(commerceValue(courier, 'status'), source, 'status', [
         'active',
         'on_delivery',
         'on_break',
       ]),
     }
   })
-  const driversById = new Map(normalizedDrivers.map(driver => [driver.id, driver]))
+  const couriersById = new Map(normalizedCouriers.map(courier => [courier.id, courier]))
 
   const routeMinutesById = new Map<number, number>()
   const allRoutes = routeRows.map((route): DeliveryOverviewRoute => {
@@ -119,14 +119,14 @@ export function buildDeliveryOverview(
       integer: true,
     })
     const source = `DeliveryRoute ${numericId}`
-    const driverId = commerceOptionalIdentifier(
-      commerceValue(route, 'driver_id', 'driverId'),
+    const courierId = commerceOptionalIdentifier(
+      commerceValue(route, 'courier_id', 'courierId'),
       source,
-      'driver_id',
+      'courier_id',
     )
-    const linkedDriver = driverId ? driversById.get(driverId) : undefined
-    if (driverId && !linkedDriver)
-      throw new TypeError(`${source}.driver_id references missing Driver ${driverId}.`)
+    const linkedCourier = courierId ? couriersById.get(courierId) : undefined
+    if (courierId && !linkedCourier)
+      throw new TypeError(`${source}.courier_id references missing Courier ${courierId}.`)
     const deliveryTime = commerceNumber(
       commerceValue(route, 'delivery_time', 'deliveryTime'),
       source,
@@ -136,9 +136,9 @@ export function buildDeliveryOverview(
     routeMinutesById.set(numericId, deliveryTime)
     return {
       id: numericId,
-      driver: linkedDriver?.name
-        || commerceRequiredString(commerceValue(route, 'driver'), source, 'driver'),
-      vehicle: linkedDriver?.vehicle
+      courier: linkedCourier?.name
+        || commerceRequiredString(commerceValue(route, 'courier'), source, 'courier'),
+      vehicle: linkedCourier?.vehicle
         || commerceRequiredString(commerceValue(route, 'vehicle'), source, 'vehicle'),
       stops: commerceNumber(commerceValue(route, 'stops'), source, 'stops', {
         min: 0,
@@ -224,8 +224,8 @@ export function buildDeliveryOverview(
       return statusOrder || left.name.localeCompare(right.name)
     })
 
-  const driverStatusCounts = normalizedDrivers.reduce<Record<string, number>>((counts, driver) => {
-    counts[driver.status] = (counts[driver.status] || 0) + 1
+  const courierStatusCounts = normalizedCouriers.reduce<Record<string, number>>((counts, courier) => {
+    counts[courier.status] = (counts[courier.status] || 0) + 1
     return counts
   }, {})
 
@@ -242,9 +242,9 @@ export function buildDeliveryOverview(
         detail: `${activeRoutes.reduce((total, route) => total + route.stops, 0).toLocaleString('en-US')} stops active in 24h`,
       },
       {
-        label: 'Drivers on Delivery',
-        value: (driverStatusCounts.on_delivery || 0).toLocaleString('en-US'),
-        detail: `${driverRows.length.toLocaleString('en-US')} drivers total`,
+        label: 'Couriers on Delivery',
+        value: (courierStatusCounts.on_delivery || 0).toLocaleString('en-US'),
+        detail: `${courierRows.length.toLocaleString('en-US')} couriers total`,
       },
       {
         label: 'Average Route',
@@ -260,11 +260,11 @@ export function buildDeliveryOverview(
     routes: activeRoutes.slice(0, 5),
     methods: methods.slice(0, 5),
     zones: zones.slice(0, 5),
-    drivers: {
-      total: normalizedDrivers.length,
-      active: driverStatusCounts.active || 0,
-      onDelivery: driverStatusCounts.on_delivery || 0,
-      onBreak: driverStatusCounts.on_break || 0,
+    couriers: {
+      total: normalizedCouriers.length,
+      active: courierStatusCounts.active || 0,
+      onDelivery: courierStatusCounts.on_delivery || 0,
+      onBreak: courierStatusCounts.on_break || 0,
     },
   }
 }

package/app/Actions/Dashboard/Commerce/{driver-records.test.ts → courier-records.test.ts}

@@ -1,9 +1,9 @@
 import { describe, expect, test } from 'bun:test'
-import { indexDriverUsers, normalizeDriverRecord } from './driver-records'
+import { indexCourierUsers, normalizeCourierRecord } from './courier-records'
 
-describe('driver records', () => {
+describe('courier records', () => {
   const user = { id: 2, name: 'Ada Lovelace', email: 'ada@example.com' }
-  const users = indexDriverUsers([user])
+  const users = indexCourierUsers([user])
   const base = {
     id: 1,
     name: 'Alex Morgan',
@@ -17,8 +17,8 @@ describe('driver records', () => {
     uuid: null,
   }
 
-  test('normalizes drivers and linked users', () => {
-    expect(normalizeDriverRecord(base, users)).toEqual({
+  test('normalizes couriers and linked users', () => {
+    expect(normalizeCourierRecord(base, users)).toEqual({
       id: 1,
       name: 'Alex Morgan',
       phone: '+1 555 0100',
@@ -34,9 +34,9 @@ describe('driver records', () => {
   })
 
   test('rejects missing users and unknown statuses', () => {
-    expect(() => normalizeDriverRecord(base, new Map()))
-      .toThrow('Driver 1.user_id references missing User 2')
-    expect(() => normalizeDriverRecord({ ...base, user_id: null, status: 'offline' }, users))
-      .toThrow('Driver 1.status must be active or on_delivery or on_break')
+    expect(() => normalizeCourierRecord(base, new Map()))
+      .toThrow('Courier 1.user_id references missing User 2')
+    expect(() => normalizeCourierRecord({ ...base, user_id: null, status: 'offline' }, users))
+      .toThrow('Courier 1.status must be active or on_delivery or on_break')
   })
 })

package/app/Actions/Dashboard/Commerce/{driver-records.ts → courier-records.ts}

@@ -10,24 +10,24 @@ import {
   commerceValue,
 } from './commerce-record'
 
-export const driverStatuses = ['active', 'on_delivery', 'on_break'] as const
-export type DriverStatus = typeof driverStatuses[number]
+export const courierStatuses = ['active', 'on_delivery', 'on_break'] as const
+export type CourierStatus = typeof courierStatuses[number]
 
-export interface DriverUser {
+export interface CourierUser {
   id: number
   name: string
   email: string
 }
 
-export interface DriverRecord {
+export interface CourierRecord {
   id: number
   name: string
   phone: string
   vehicle_number: string
   license: string
-  status: DriverStatus
+  status: CourierStatus
   user_id: number | null
-  user: DriverUser | null
+  user: CourierUser | null
   created_at: string
   updated_at: string
   uuid: string
@@ -40,8 +40,8 @@ function numericIdentifier(input: unknown, source: string, field = 'id'): number
   return id
 }
 
-export function indexDriverUsers(records: any[]): Map<number, DriverUser> {
-  const result = new Map<number, DriverUser>()
+export function indexCourierUsers(records: any[]): Map<number, CourierUser> {
+  const result = new Map<number, CourierUser>()
   for (const record of records) {
     const id = numericIdentifier(commerceValue(record, 'id'), 'User')
     const source = `User ${id}`
@@ -56,12 +56,12 @@ export function indexDriverUsers(records: any[]): Map<number, DriverUser> {
   return result
 }
 
-export function normalizeDriverRecord(
+export function normalizeCourierRecord(
   record: any,
-  users: ReadonlyMap<number, DriverUser>,
-): DriverRecord {
-  const id = numericIdentifier(commerceValue(record, 'id'), 'Driver')
-  const source = `Driver ${id}`
+  users: ReadonlyMap<number, CourierUser>,
+): CourierRecord {
+  const id = numericIdentifier(commerceValue(record, 'id'), 'Courier')
+  const source = `Courier ${id}`
   const userIdentifier = commerceOptionalIdentifier(
     commerceValue(record, 'user_id', 'userId'),
     source,
@@ -82,7 +82,7 @@ export function normalizeDriverRecord(
       'vehicle_number',
     ),
     license: commerceRequiredString(commerceValue(record, 'license'), source, 'license'),
-    status: commerceEnum(commerceValue(record, 'status'), source, 'status', driverStatuses),
+    status: commerceEnum(commerceValue(record, 'status'), source, 'status', courierStatuses),
     user_id: userId,
     user: user || null,
     created_at: commerceTimestamp(commerceValue(record, 'created_at', 'createdAt'), source),

package/app/Actions/Dashboard/Commerce/delivery-route-records.test.ts

@@ -1,21 +1,21 @@
 import { describe, expect, test } from 'bun:test'
 import {
-  indexDeliveryRouteDrivers,
+  indexDeliveryRouteCouriers,
   normalizeDeliveryRouteRecord,
 } from './delivery-route-records'
 
 describe('delivery route records', () => {
-  const driver = {
+  const courier = {
     id: 2,
     name: 'Alex Morgan',
     vehicle_number: 'VAN-204',
     status: 'active',
   }
-  const drivers = indexDeliveryRouteDrivers([driver])
+  const couriers = indexDeliveryRouteCouriers([courier])
   const base = {
     id: 1,
-    driver: 'Alex Morgan',
-    driver_id: 2,
+    courier: 'Alex Morgan',
+    courier_id: 2,
     vehicle: 'VAN-204',
     stops: 8,
     delivery_time: 90,
@@ -26,12 +26,12 @@ describe('delivery route records', () => {
     uuid: null,
   }
 
-  test('normalizes route metrics and the linked driver', () => {
-    expect(normalizeDeliveryRouteRecord(base, drivers)).toEqual({
+  test('normalizes route metrics and the linked courier', () => {
+    expect(normalizeDeliveryRouteRecord(base, couriers)).toEqual({
       id: 1,
-      driver: 'Alex Morgan',
-      driver_id: 2,
-      driver_record: driver,
+      courier: 'Alex Morgan',
+      courier_id: 2,
+      courier_record: courier,
       vehicle: 'VAN-204',
       stops: 8,
       delivery_time: 90,
@@ -43,10 +43,10 @@ describe('delivery route records', () => {
     })
   })
 
-  test('rejects missing drivers and fractional operational counts', () => {
+  test('rejects missing couriers and fractional operational counts', () => {
     expect(() => normalizeDeliveryRouteRecord(base, new Map()))
-      .toThrow('DeliveryRoute 1.driver_id references missing Driver 2')
-    expect(() => normalizeDeliveryRouteRecord({ ...base, driver_id: null, stops: 1.5 }, drivers))
+      .toThrow('DeliveryRoute 1.courier_id references missing Courier 2')
+    expect(() => normalizeDeliveryRouteRecord({ ...base, courier_id: null, stops: 1.5 }, couriers))
       .toThrow('DeliveryRoute 1.stops must be an integer')
   })
 })

package/app/Actions/Dashboard/Commerce/delivery-route-records.ts

@@ -8,21 +8,21 @@ import {
   commerceTimestamp,
   commerceValue,
 } from './commerce-record'
-import type { DriverStatus } from './driver-records'
-import { driverStatuses } from './driver-records'
+import type { CourierStatus } from './courier-records'
+import { courierStatuses } from './courier-records'
 
-export interface DeliveryRouteDriver {
+export interface DeliveryRouteCourier {
   id: number
   name: string
   vehicle_number: string
-  status: DriverStatus
+  status: CourierStatus
 }
 
 export interface DeliveryRouteRecord {
   id: number
-  driver: string
-  driver_id: number | null
-  driver_record: DeliveryRouteDriver | null
+  courier: string
+  courier_id: number | null
+  courier_record: DeliveryRouteCourier | null
   vehicle: string
   stops: number
   delivery_time: number
@@ -40,13 +40,13 @@ function numericIdentifier(input: unknown, source: string, field = 'id'): number
   return id
 }
 
-export function indexDeliveryRouteDrivers(records: any[]): Map<number, DeliveryRouteDriver> {
-  const result = new Map<number, DeliveryRouteDriver>()
+export function indexDeliveryRouteCouriers(records: any[]): Map<number, DeliveryRouteCourier> {
+  const result = new Map<number, DeliveryRouteCourier>()
   for (const record of records) {
-    const id = numericIdentifier(commerceValue(record, 'id'), 'Driver')
-    const source = `Driver ${id}`
+    const id = numericIdentifier(commerceValue(record, 'id'), 'Courier')
+    const source = `Courier ${id}`
     if (result.has(id))
-      throw new TypeError(`Duplicate Driver ${id}.`)
+      throw new TypeError(`Duplicate Courier ${id}.`)
     result.set(id, {
       id,
       name: commerceRequiredString(commerceValue(record, 'name'), source, 'name'),
@@ -55,7 +55,7 @@ export function indexDeliveryRouteDrivers(records: any[]): Map<number, DeliveryR
         source,
         'vehicle_number',
       ),
-      status: commerceEnum(commerceValue(record, 'status'), source, 'status', driverStatuses),
+      status: commerceEnum(commerceValue(record, 'status'), source, 'status', courierStatuses),
     })
   }
   return result
@@ -63,27 +63,27 @@ export function indexDeliveryRouteDrivers(records: any[]): Map<number, DeliveryR
 
 export function normalizeDeliveryRouteRecord(
   record: any,
-  drivers: ReadonlyMap<number, DeliveryRouteDriver>,
+  couriers: ReadonlyMap<number, DeliveryRouteCourier>,
 ): DeliveryRouteRecord {
   const id = numericIdentifier(commerceValue(record, 'id'), 'DeliveryRoute')
   const source = `DeliveryRoute ${id}`
-  const driverIdentifier = commerceOptionalIdentifier(
-    commerceValue(record, 'driver_id', 'driverId'),
+  const courierIdentifier = commerceOptionalIdentifier(
+    commerceValue(record, 'courier_id', 'courierId'),
     source,
-    'driver_id',
+    'courier_id',
   )
-  const driverId = driverIdentifier
-    ? numericIdentifier(driverIdentifier, source, 'driver_id')
+  const courierId = courierIdentifier
+    ? numericIdentifier(courierIdentifier, source, 'courier_id')
     : null
-  const driverRecord = driverId ? drivers.get(driverId) : undefined
-  if (driverId && !driverRecord)
-    throw new TypeError(`${source}.driver_id references missing Driver ${driverId}.`)
+  const courierRecord = courierId ? couriers.get(courierId) : undefined
+  if (courierId && !courierRecord)
+    throw new TypeError(`${source}.courier_id references missing Courier ${courierId}.`)
 
   return {
     id,
-    driver: commerceRequiredString(commerceValue(record, 'driver'), source, 'driver'),
-    driver_id: driverId,
-    driver_record: driverRecord || null,
+    courier: commerceRequiredString(commerceValue(record, 'courier'), source, 'courier'),
+    courier_id: courierId,
+    courier_record: courierRecord || null,
     vehicle: commerceRequiredString(commerceValue(record, 'vehicle'), source, 'vehicle'),
     stops: commerceNumber(commerceValue(record, 'stops'), source, 'stops', {
       integer: true,

package/app/Models/User.ts

@@ -58,7 +58,7 @@ export default defineModel({
     },
   },
 
-  hasOne: ['Subscriber', 'Driver', 'Author'],
+  hasOne: ['Subscriber', 'Courier', 'Author'],
 
   hasMany: [
     'PersonalAccessToken',

package/app/Models/commerce/{Driver.ts → Courier.ts}

@@ -2,13 +2,13 @@ import { defineModel } from '@stacksjs/orm'
 import { schema } from '@stacksjs/validation'
 
 export default defineModel({
-  name: 'Driver',
-  table: 'drivers',
+  name: 'Courier',
+  table: 'couriers',
   primaryKey: 'id',
   autoIncrement: true,
 
   belongsTo: ['User'],
-  hasMany: ['DeliveryRoute', 'DriverPing'],
+  hasMany: ['DeliveryRoute', 'CourierPing'],
 
   traits: {
     useUuid: true,
@@ -25,7 +25,7 @@ export default defineModel({
     },
 
     useApi: {
-      uri: 'drivers',
+      uri: 'couriers',
       middleware: ['auth'],
     },
 
@@ -94,8 +94,8 @@ export default defineModel({
     /*
      * Last known position.
      *
-     * Denormalised from the `driver_pings` series on purpose: "where is this
-     * driver right now" is asked on every map frame and by every tracking
+     * Denormalised from the `courier_pings` series on purpose: "where is this
+     * courier right now" is asked on every map frame and by every tracking
      * page, and answering it with a MAX(recorded_at) subquery over a table
      * that grows by a row every few seconds is the wrong shape. The series is
      * the history; these three columns are the present.
@@ -149,7 +149,7 @@ export default defineModel({
 
     /*
      * When the last fix landed. A tracking map needs this to say "updated 4
-     * seconds ago" and, more importantly, to stop claiming a driver is at a
+     * seconds ago" and, more importantly, to stop claiming a courier is at a
      * position that is ten minutes stale.
      */
     lastPingAt: {

package/app/Models/commerce/{DriverPing.ts → CourierPing.ts}

@@ -2,9 +2,9 @@ import { defineModel } from '@stacksjs/orm'
 import { schema } from '@stacksjs/validation'
 
 /**
- * One position fix from a driver's device.
+ * One position fix from a courier's device.
  *
- * The append-only history behind `drivers.latitude/longitude`. A tracking map
+ * The append-only history behind `couriers.latitude/longitude`. A tracking map
  * needs the present position, but everything else about a delivery needs the
  * series: drawing the path already travelled, replaying a disputed drop,
  * measuring how long a stop actually took, and deriving an ETA from recent
@@ -12,12 +12,12 @@ import { schema } from '@stacksjs/validation'
  *
  * Deliberately not `useSearch` (indexing a row every few seconds is pointless
  * and expensive) and not `useApi` (writes come through
- * `recordDriverPing`, which does the fan-out, and reads are scoped to a
+ * `recordCourierPing`, which does the fan-out, and reads are scoped to a
  * route). `usePrunable` keeps the table from growing without bound.
  */
 export default defineModel({
-  name: 'DriverPing',
-  table: 'driver_pings',
+  name: 'CourierPing',
+  table: 'courier_pings',
   primaryKey: 'id',
   autoIncrement: true,
 
@@ -27,7 +27,7 @@ export default defineModel({
     useSeeder: { count: 0 },
   },
 
-  belongsTo: ['Driver', 'DeliveryRoute'],
+  belongsTo: ['Courier', 'DeliveryRoute'],
 
   attributes: {
     latitude: {
@@ -89,7 +89,7 @@ export default defineModel({
 
     /**
      * When the device took the fix, which is not when the server received it.
-     * A driver through a tunnel sends five fixes at once on the far side, and
+     * A courier through a tunnel sends five fixes at once on the far side, and
      * ordering them by arrival draws a path that never happened.
      */
     recordedAt: {

package/app/Models/commerce/DeliveryRoute.ts

@@ -11,10 +11,10 @@ export default defineModel({
     useUuid: true,
     useTimestamps: true,
     useSearch: {
-      displayable: ['id', 'driver', 'vehicle', 'stops', 'deliveryTime', 'totalDistance', 'lastActive'],
-      searchable: ['driver', 'vehicle'],
+      displayable: ['id', 'courier', 'vehicle', 'stops', 'deliveryTime', 'totalDistance', 'lastActive'],
+      searchable: ['courier', 'vehicle'],
       sortable: ['stops', 'deliveryTime', 'totalDistance', 'lastActive', 'createdAt', 'updatedAt'],
-      filterable: ['driver', 'vehicle'],
+      filterable: ['courier', 'vehicle'],
     },
 
     useSeeder: {
@@ -29,11 +29,11 @@ export default defineModel({
     observe: true,
   },
 
-  belongsTo: ['Driver'],
-  hasMany: ['DeliveryStop', 'DriverPing'],
+  belongsTo: ['Courier'],
+  hasMany: ['DeliveryStop', 'CourierPing'],
 
   attributes: {
-    driver: {
+    courier: {
       order: 1,
       fillable: true,
       validation: {

package/app/Models/commerce/DeliveryStop.ts

@@ -6,11 +6,11 @@ import { schema } from '@stacksjs/validation'
  *
  * `DeliveryRoute` records that a route happened and how far it went; this is
  * the route itself. Without it `stops` is an integer, which is enough to bill
- * a driver and not nearly enough to tell a customer where their order is: the
+ * a courier and not nearly enough to tell a customer where their order is: the
  * link from an order to the vehicle carrying it runs through here.
  *
  * Sequence is the planned order. `status` is what actually happened, which
- * diverges the moment a driver skips a building and comes back to it.
+ * diverges the moment a courier skips a building and comes back to it.
  */
 export default defineModel({
   name: 'DeliveryStop',
@@ -26,7 +26,7 @@ export default defineModel({
       displayable: ['id', 'sequence', 'status', 'address', 'etaAt'],
       searchable: ['address', 'recipientName'],
       sortable: ['sequence', 'etaAt', 'createdAt'],
-      filterable: ['status', 'deliveryRouteId'],
+      filterable: ['status', 'type', 'deliveryRouteId'],
     },
 
     useSeeder: { count: 0 },
@@ -82,7 +82,7 @@ export default defineModel({
 
     /**
      * Geocoded destination. Nullable because an address can arrive before it
-     * resolves, and a stop with no coordinates is still a stop the driver can
+     * resolves, and a stop with no coordinates is still a stop the courier can
      * complete; it just cannot be drawn.
      */
     latitude: {
@@ -113,7 +113,7 @@ export default defineModel({
       factory: faker => faker.phone.number(),
     },
 
-    /** Current estimate, rewritten as the driver moves. */
+    /** Current estimate, rewritten as the courier moves. */
     etaAt: {
       order: 8,
       fillable: true,
@@ -122,7 +122,7 @@ export default defineModel({
     },
 
     /**
-     * When the customer was told the driver was close.
+     * When the customer was told the courier was close.
      *
      * The latch that makes "nearly there" fire once. Without it every ping
      * inside the radius sends another text, which is roughly one text every
@@ -135,7 +135,7 @@ export default defineModel({
       factory: () => null,
     },
 
-    /** When the driver crossed the arrival radius. */
+    /** When the courier crossed the arrival radius. */
     arrivedAt: {
       order: 10,
       fillable: true,
@@ -151,13 +151,36 @@ export default defineModel({
       factory: () => null,
     },
 
-    /** Why a stop failed, or anything the driver needs to record. */
+    /** Why a stop failed, or anything the courier needs to record. */
     notes: {
       order: 12,
       fillable: true,
       validation: { rule: schema.string().max(1000) },
       factory: () => '',
     },
+
+    /**
+     * Which leg of the run this stop is.
+     *
+     * A delivery is two stops, not one: collect from the merchant, then hand
+     * over to the customer. Without the distinction both legs look like a
+     * dropoff, so arriving at the restaurant would tell the customer their
+     * order is out for delivery, and collecting it would mark the order
+     * delivered before it had left the kitchen.
+     *
+     * Defaults to `dropoff` so existing single-stop routes keep their meaning.
+     */
+    type: {
+      order: 13,
+      required: true,
+      fillable: true,
+      default: 'dropoff',
+      validation: {
+        rule: schema.enum(['pickup', 'dropoff']),
+        message: { enum: 'Type must be one of: pickup, dropoff' },
+      },
+      factory: () => 'dropoff',
+    },
   },
 
   dashboard: {

package/bootstrap.ts

@@ -175,6 +175,13 @@ if (mounts('forms', feature('forms'))) {
   await route.register(frameworkPath('defaults/routes/forms.ts'))
 }
 
+// Courier delivery endpoints: position ingest and the stop/route lifecycle a
+// courier's device drives. Gated with the rest of the commerce surface, since
+// they are meaningless without the delivery models behind them.
+if (mounts('delivery', feature('commerce'))) {
+  await route.register(frameworkPath('defaults/routes/delivery.ts'))
+}
+
 // Social sign-in: `/auth/{provider}` + `/auth/{provider}/callback`
 // (stacksjs/stacks#2276). An opt-in bundle, NOT part of the implicit default
 // set or `all` — OAuth callback URLs in an app that configured no provider

package/functions/commerce/shippings/couriers.ts

@@ -0,0 +1,19 @@
+import type { Couriers, NewCourier } from '../../../types/defaults'
+import { createDashboardResource } from './dashboard-resource'
+
+const resource = createDashboardResource<Couriers, NewCourier>({
+  path: '/api/dashboard/commerce/couriers',
+  storageKey: 'couriers',
+  singular: 'courier',
+  plural: 'couriers',
+})
+
+export function useCouriers() {
+  return {
+    couriers: resource.items,
+    fetchCouriers: resource.fetchAll,
+    createCourier: resource.create,
+    updateCourier: resource.update,
+    deleteCourier: resource.destroy,
+  }
+}