feat: Mostly implemented routing using url-routing package.

Sources/SharedModels/SiteRoute.swift

@@ -2,217 +2,18 @@ import CasePathsCore
 import Foundation
 @preconcurrency import URLRouting
 
-// TODO: Share view and api routes.
-
-public enum ViewRoute: Sendable {
-  case employee(EmployeeRoute)
-  case purchaseOrder(PurchaseOrderRoute)
-  case select(SelectRoute)
-  case user(UserRoute)
-  case vendor(VendorRoute)
+public enum SiteRoute: Sendable {
+  case api(ApiRoute)
+  case health
+  case view(ViewRoute)
 
   public static let router = OneOf {
-    Route(.case(Self.employee)) { EmployeeRoute.router }
-    Route(.case(Self.purchaseOrder)) { PurchaseOrderRoute.router }
-    Route(.case(Self.select)) { SelectRoute.router }
-    Route(.case(Self.user)) { UserRoute.router }
-    Route(.case(Self.vendor)) { VendorRoute.router }
-  }
-
-  public enum EmployeeRoute: Sendable {
-    case create(Employee.Create)
-    case delete(id: Employee.ID)
-    case get(id: Employee.ID)
-    case form
-    case index
-    case update(id: Employee.ID, updates: Employee.Update)
-
-    static let rootPath = "employees"
-
-    public static let router = OneOf {
-      Route(.case(Self.create)) {
-        Path { rootPath }
-        Method.post
-        Body(.json(Employee.Create.self))
-      }
-      Route(.case(Self.index)) {
-        Path { rootPath }
-        Method.get
-      }
-      Route(.case(Self.delete(id:))) {
-        Path { rootPath; UUID.parser() }
-        Method.delete
-      }
-      Route(.case(Self.get(id:))) {
-        Path { rootPath; UUID.parser() }
-        Method.get
-      }
-      Route(.case(Self.form)) {
-        Path { rootPath; "create" }
-        Method.get
-      }
-      Route(.case(Self.update(id:updates:))) {
-        Path { rootPath; UUID.parser() }
-        Method.put
-        Body(.json(Employee.Update.self))
-      }
-    }
-  }
-
-  // TODO: Add search.
-  public enum PurchaseOrderRoute: Sendable {
-    case create(PurchaseOrder.Create)
-    case form
-    case get(id: PurchaseOrder.ID)
-    case index
-    case next(page: Int, limit: Int)
-
-    static let rootPath = "purchase-orders"
-
-    public static let router = OneOf {
-      Route(.case(Self.create)) {
-        Path { rootPath }
-        Method.post
-        Body(.json(PurchaseOrder.Create.self))
-      }
-      Route(.case(Self.form)) {
-        Path { rootPath; "create" }
-        Method.get
-      }
-      Route(.case(Self.get(id:))) {
-        Path { rootPath; Digits() }
-        Method.get
-      }
-      Route(.case(Self.index)) {
-        Path { rootPath }
-        Method.get
-      }
-      Route(.case(Self.next(page:limit:))) {
-        Path { rootPath; "next" }
-        Method.get
-        Query {
-          Field("page", default: 1) { Digits() }
-          Field("limit", default: 25) { Digits() }
-        }
-      }
-    }
-  }
-
-  public enum SelectRoute: Sendable {
-    case employee(context: Context)
-    case vendorBranches(context: Context)
-
-    public enum Context: String, Codable, Sendable, CaseIterable {
-      case purchaseOrderForm
-      case purchaseOrderSearch
-    }
-
-    static let rootPath = "select"
-
-    public static let router = OneOf {
-      Route(.case(Self.employee(context:))) {
-        Path { rootPath; "employee" }
-        Method.get
-        Query {
-          Field("context") { Context.parser() }
-        }
-      }
-      Route(.case(Self.vendorBranches(context:))) {
-        Path { rootPath; "vendor-branches" }
-        Method.get
-        Query {
-          Field("context") { Context.parser() }
-        }
-      }
-    }
-  }
-
-  public enum UserRoute: Sendable {
-    case create(User.Create)
-    case delete(id: User.ID)
-    case form
-    case get(id: User.ID)
-    case index
-    case login(User.Login)
-    case update(id: User.ID, updates: User.Update)
-
-    static let rootPath = "users"
-
-    public static let router = OneOf {
-      Route(.case(Self.create)) {
-        Path { rootPath }
-        Method.post
-        Body(.json(User.Create.self))
-      }
-      Route(.case(Self.delete(id:))) {
-        Path { rootPath; User.ID.parser() }
-        Method.delete
-      }
-      Route(.case(Self.form)) {
-        Path { rootPath; "create" }
-        Method.get
-      }
-      Route(.case(Self.get(id:))) {
-        Path { rootPath; User.ID.parser() }
-        Method.get
-      }
-      Route(.case(Self.index)) {
-        Path { rootPath }
-        Method.get
-      }
-      Route(.case(Self.login)) {
-        Path { rootPath }
-        Method.post
-        Body(.json(User.Login.self))
-      }
-      Route(.case(Self.update(id:updates:))) {
-        Path { rootPath; User.ID.parser() }
-        // TODO: Use put or patch.
-        Method.post
-        Body(.json(User.Update.self))
-      }
-    }
-  }
-
-  public enum VendorRoute: Sendable {
-    case create(Vendor.Create)
-    case createBranch(VendorBranch.Create)
-    case form
-    case get(id: Vendor.ID)
-    case index
-    case update(id: Vendor.ID, updates: Vendor.Update)
-
-    static let rootPath = "vendors"
-
-    public static let router = OneOf {
-      Route(.case(Self.create)) {
-        Path { rootPath }
-        Method.post
-        Body(.json(Vendor.Create.self))
-      }
-      Route(.case(Self.createBranch)) {
-        Path { rootPath; "branches" }
-        Method.post
-        Body(.json(VendorBranch.Create.self))
-      }
-      Route(.case(Self.form)) {
-        Path { rootPath; "create" }
-        Method.get
-      }
-      Route(.case(Self.get(id:))) {
-        Path { rootPath; Vendor.ID.parser() }
-        Method.get
-      }
-      Route(.case(Self.index)) {
-        Path { rootPath }
-        Method.get
-      }
-      Route(.case(Self.update(id:updates:))) {
-        Path { rootPath; Vendor.ID.parser() }
-        Method.put
-        Body(.json(Vendor.Update.self))
-      }
+    Route(.case(Self.view)) { ViewRoute.router }
+    Route(.case(Self.health)) {
+      Path { "health" }
+      Method.get
     }
+    Route(.case(Self.api)) { ApiRoute.router }
   }
 }
 
@@ -224,12 +25,29 @@ public enum ApiRoute: Sendable {
   case vendor(VendorApiRoute)
   case vendorBranch(VendorBranchApiRoute)
 
+  static let rootPath = Path { "api"; "v1" }
+
   public static let router = OneOf {
-    Route(.case(Self.employee)) { EmployeeApiRoute.router }
-    Route(.case(Self.purchaseOrder)) { PurchaseOrderApiRoute.router }
-    Route(.case(Self.user)) { UserApiRoute.router }
-    Route(.case(Self.vendor)) { VendorApiRoute.router }
-    Route(.case(Self.vendorBranch)) { VendorBranchApiRoute.router }
+    Route(.case(Self.employee)) {
+      rootPath
+      EmployeeApiRoute.router
+    }
+    Route(.case(Self.purchaseOrder)) {
+      rootPath
+      PurchaseOrderApiRoute.router
+    }
+    Route(.case(Self.user)) {
+      rootPath
+      UserApiRoute.router
+    }
+    Route(.case(Self.vendor)) {
+      rootPath
+      VendorApiRoute.router
+    }
+    Route(.case(Self.vendorBranch)) {
+      rootPath
+      VendorBranchApiRoute.router
+    }
   }
 
   public enum EmployeeApiRoute: Sendable {
@@ -305,6 +123,7 @@ public enum ApiRoute: Sendable {
     }
   }
 
+  // TODO: Add logout.
   public enum UserApiRoute: Sendable {
     case create(User.Create)
     case delete(id: User.ID)
@@ -349,8 +168,9 @@ public enum ApiRoute: Sendable {
 
   public enum VendorApiRoute: Sendable {
     case create(Vendor.Create)
+    case delete(id: Vendor.ID)
     case get(id: Vendor.ID)
-    case index
+    case index(withBranches: Bool?)
     case update(id: Vendor.ID, updates: Vendor.Update)
 
     static let rootPath = "vendors"
@@ -361,13 +181,22 @@ public enum ApiRoute: Sendable {
         Method.post
         Body(.json(Vendor.Create.self))
       }
+      Route(.case(Self.delete(id:))) {
+        Path { rootPath; Vendor.ID.parser() }
+        Method.delete
+      }
       Route(.case(Self.get(id:))) {
         Path { rootPath; Vendor.ID.parser() }
         Method.get
       }
-      Route(.case(Self.index)) {
+      Route(.case(Self.index(withBranches:))) {
         Path { rootPath }
         Method.get
+        Query {
+          Field("branches", default: nil) {
+            Optionally { Bool.parser() }
+          }
+        }
       }
       Route(.case(Self.update(id:updates:))) {
         Path { rootPath; Vendor.ID.parser() }
@@ -381,6 +210,7 @@ public enum ApiRoute: Sendable {
     case create(VendorBranch.Create)
     case delete(id: VendorBranch.ID)
     case get(id: VendorBranch.ID)
+    case index(for: Vendor.ID? = nil)
     case update(id: VendorBranch.ID, updates: VendorBranch.Update)
 
     public static let router = OneOf {
@@ -397,6 +227,13 @@ public enum ApiRoute: Sendable {
         Path { "vendors"; "branches"; VendorBranch.ID.parser() }
         Method.get
       }
+      Route(.case(Self.index(for:))) {
+        Path { "vendors"; "branches" }
+        Method.get
+        Query {
+          Field("vendorID", default: nil) { Optionally { VendorBranch.ID.parser() } }
+        }
+      }
       Route(.case(Self.update(id:updates:))) {
         Path { "vendors"; "branches"; VendorBranch.ID.parser() }
         Method.put
@@ -405,3 +242,181 @@ public enum ApiRoute: Sendable {
     }
   }
 }
+
+public enum ViewRoute: Sendable {
+
+  case employee(EmployeeRoute)
+  case login
+  case purchaseOrder(PurchaseOrderRoute)
+  case select(SelectRoute)
+  case user(UserRoute)
+  case vendor(VendorRoute)
+
+  public static let router = OneOf {
+    Route(.case(Self.employee)) { EmployeeRoute.router }
+    Route(.case(Self.login)) {
+      Path { "login" }
+      Method.get
+    }
+    Route(.case(Self.purchaseOrder)) { PurchaseOrderRoute.router }
+    Route(.case(Self.select)) { SelectRoute.router }
+    Route(.case(Self.user)) { UserRoute.router }
+    Route(.case(Self.vendor)) { VendorRoute.router }
+  }
+
+  public enum EmployeeRoute: Sendable {
+    case form
+    case shared(ApiRoute.EmployeeApiRoute)
+
+    static let rootPath = "employees"
+
+    public static let router = OneOf {
+      Route(.case(Self.form)) {
+        Path { rootPath; "create" }
+        Method.get
+      }
+      Route(.case(Self.shared)) {
+        ApiRoute.EmployeeApiRoute.router
+      }
+    }
+  }
+
+  public enum PurchaseOrderRoute: Sendable {
+    case form
+    case search(Search)
+    case shared(ApiRoute.PurchaseOrderApiRoute)
+
+    static let rootPath = "purchase-orders"
+
+    public static let router = OneOf {
+      Route(.case(Self.form)) {
+        Path { rootPath; "create" }
+        Method.get
+      }
+      Route(.case(Self.search)) {
+        Search.router
+      }
+      Route(.case(Self.shared)) {
+        ApiRoute.PurchaseOrderApiRoute.router
+      }
+    }
+
+    public enum Search: Sendable {
+      case index(context: Context, table: Bool?)
+      case search(Request)
+
+      static let rootPath = Path { "purchase-orders"; "search" }
+
+      static let router = OneOf {
+        Route(.case(Search.index(context:table:))) {
+          rootPath
+          Method.get
+          Query {
+            Field("context", default: .employee) { Search.Context.parser() }
+            Field("table", default: nil) { Optionally { Bool.parser() } }
+          }
+        }
+        Route(.case(Search.search)) {
+          rootPath
+          Method.post
+          Body(.json(Search.Request.self))
+        }
+      }
+
+      public enum Context: String, Codable, CaseIterable, Sendable {
+        case employee
+        case customer
+        case vendor
+      }
+
+      public struct Request: Codable, Sendable {
+        public let context: Context
+        public let createdForID: Employee.ID?
+        public let customerSearch: String?
+        public let vendorBranchID: VendorBranch.ID?
+
+        public init(
+          context: Context,
+          createdForID: Employee.ID? = nil,
+          customerSearch: String? = nil,
+          vendorBranchID: VendorBranch.ID? = nil
+        ) {
+          self.context = context
+          self.createdForID = createdForID
+          self.customerSearch = customerSearch
+          self.vendorBranchID = vendorBranchID
+        }
+      }
+
+    }
+  }
+
+  public enum SelectRoute: Sendable {
+    case employee(context: Context)
+    case vendorBranches(context: Context)
+
+    public enum Context: String, Codable, Sendable, CaseIterable {
+      case purchaseOrderForm
+      case purchaseOrderSearch
+    }
+
+    static let rootPath = "select"
+
+    public static let router = OneOf {
+      Route(.case(Self.employee(context:))) {
+        Path { rootPath; "employee" }
+        Method.get
+        Query {
+          Field("context") { Context.parser() }
+        }
+      }
+      Route(.case(Self.vendorBranches(context:))) {
+        Path { rootPath; "vendor-branches" }
+        Method.get
+        Query {
+          Field("context") { Context.parser() }
+        }
+      }
+    }
+  }
+
+  public enum UserRoute: Sendable {
+    case form
+    case shared(ApiRoute.UserApiRoute)
+
+    static let rootPath = "users"
+
+    public static let router = OneOf {
+      Route(.case(Self.form)) {
+        Path { rootPath; "create" }
+        Method.get
+      }
+      Route(.case(Self.shared)) {
+        ApiRoute.UserApiRoute.router
+      }
+    }
+  }
+
+  public enum VendorRoute: Sendable {
+    case createBranch(VendorBranch.Create)
+    case form
+    case shared(ApiRoute.VendorApiRoute)
+
+    static let rootPath = "vendors"
+
+    public static let router = OneOf {
+      Route(.case(Self.createBranch)) {
+        Path { rootPath; "branches" }
+        Method.post
+        Body(.json(VendorBranch.Create.self))
+      }
+      Route(.case(Self.form)) {
+        Path { rootPath; "create" }
+        Method.get
+      }
+      Route(.case(Self.shared)) {
+        ApiRoute.VendorApiRoute.router
+      }
+    }
+  }
+}