/**
 * Pushed Synchron orders (S8; contract v0.3.0; Q17 decided 2026-10-18).
 *
 * The same number is used everywhere, never a prefix: an HHA order number is
 * the nine-digit trip number, and Synchron's own orders keep eight digits.
 * Either way the Workspace trip is `HH-<order number>`, the reference the
 * Synchron importer already uses for the 957 historical trips
 * (scripts/synchron/README.md). Pure rules, no I/O.
 */
export type OrderOrigin = 'hha' | 'synchron'

/** Who created the order, read from the number itself; null when it is not an order number. */
export function orderOrigin(orderNumber: string): OrderOrigin | null {
  if (/^[1-9]\d{8}$/.test(orderNumber)) return 'hha'
  if (/^\d{8}$/.test(orderNumber)) return 'synchron'
  return null
}

/** The Workspace trip reference for an order number, or null when the number is invalid. */
export function tripRefForOrder(orderNumber: string): string | null {
  return orderOrigin(orderNumber) ? `HH-${orderNumber}` : null
}

/** The order number inside a Workspace trip reference (8 or 9 digits), or null. */
export function orderNumberForTripRef(refCode: string): string | null {
  const m = /^HH-(\d{8,9})$/.exec(refCode)
  return m && orderOrigin(m[1]) ? m[1] : null
}

export type RouteEventDecision = 'apply' | 'duplicate' | 'stale'

/**
 * route.completed / route.updated carry route_version. Apply only a newer
 * version; the same version is a retried delivery and an older one arrived
 * late. Either way the answer to Synchron is 200 so it stops retrying.
 */
export function routeEventDecision(storedVersion: number | null | undefined, incomingVersion: number): RouteEventDecision {
  if (!Number.isInteger(incomingVersion) || incomingVersion < 1) return 'stale'
  if (storedVersion == null) return 'apply'
  if (incomingVersion === storedVersion) return 'duplicate'
  return incomingVersion > storedVersion ? 'apply' : 'stale'
}

/** A route version of 2 or more is a corrected route and shows "Updated" (Nash, 2026-10-07, item 5). */
export function isCorrectedRoute(version: number | null | undefined): boolean {
  return (version ?? 1) >= 2
}
