feat: Begins breaking out database interfaces and api controllers into seperate items.

Sources/App/Controllers/Api/EmployeeApiController.swift

@@ -0,0 +1,64 @@
+import Fluent
+import Vapor
+
+struct EmployeeApiController: RouteCollection {
+
+  private let employeeDB = EmployeeDB()
+
+  func boot(routes: any RoutesBuilder) throws {
+    let protected = routes.apiProtected(route: "employees")
+    protected.get(use: index(req:))
+    protected.post(use: create(req:))
+    protected.group(":employeeID") {
+      $0.get(use: get(req:))
+      $0.put(use: update(req:))
+      $0.delete(use: delete(req:))
+    }
+  }
+
+  @Sendable
+  func index(req: Request) async throws -> [Employee.DTO] {
+    let params = try req.query.decode(EmployeesIndexQuery.self)
+    return try await employeeDB.fetchAll(active: params.active, on: req.db)
+  }
+
+  @Sendable
+  func create(req: Request) async throws -> Employee.DTO {
+    try Employee.Create.validate(content: req)
+    let create = try req.content.decode(Employee.Create.self)
+    return try await employeeDB.create(create, on: req.db)
+  }
+
+  @Sendable
+  func get(req: Request) async throws -> Employee.DTO {
+    guard let id = req.parameters.get("employeeID", as: Employee.IDValue.self),
+          let employee = try await employeeDB.get(id: id, on: req.db)
+    else {
+      throw Abort(.notFound)
+    }
+    return employee
+  }
+
+  @Sendable
+  func update(req: Request) async throws -> Employee.DTO {
+    try Employee.Update.validate(content: req)
+    guard let employeeID = req.parameters.get("employeeID", as: Employee.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Employee id value not provided")
+    }
+    let updates = try req.content.decode(Employee.Update.self)
+    return try await employeeDB.update(id: employeeID, with: updates, on: req.db)
+  }
+
+  @Sendable
+  func delete(req: Request) async throws -> HTTPStatus {
+    guard let employeeID = req.parameters.get("employeeID", as: Employee.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Employee id value not provided")
+    }
+    try await employeeDB.delete(id: employeeID, on: req.db)
+    return .ok
+  }
+}
+
+struct EmployeesIndexQuery: Content {
+  let active: Bool?
+}

Sources/App/Controllers/Api/PurchaseOrderApiController.swift

@@ -0,0 +1,62 @@
+import Fluent
+import Vapor
+
+// TODO: Add update route.
+
+struct PurchaseOrderApiController: RouteCollection {
+  private let purchaseOrders = PurchaseOrderDB()
+
+  func boot(routes: any RoutesBuilder) throws {
+    let protected = routes.apiProtected(route: "purchase-orders")
+    protected.get(use: index(req:))
+    protected.post(use: create(req:))
+    protected.group(":id") {
+      $0.get(use: get(req:))
+      $0.delete(use: delete(req:))
+    }
+  }
+
+  @Sendable
+  func index(req: Request) async throws -> [PurchaseOrder.DTO] {
+    try await purchaseOrders.fetchAll(on: req.db)
+  }
+
+  @Sendable
+  func create(req: Request) async throws -> PurchaseOrder.DTO {
+    try PurchaseOrder.Create.validate(content: req)
+    let model = try req.content.decode(PurchaseOrder.Create.self)
+    return try await purchaseOrders.create(
+      model,
+      createdById: req.auth.require(User.self).requireID(),
+      on: req.db
+    )
+  }
+
+  @Sendable
+  func get(req: Request) async throws -> PurchaseOrder.DTO {
+    guard let id = req.parameters.get("id", as: PurchaseOrder.IDValue.self),
+          let purchaseOrder = try await purchaseOrders.get(id: id, on: req.db)
+    else {
+      throw Abort(.notFound)
+    }
+    return purchaseOrder
+  }
+
+  @Sendable
+  func delete(req: Request) async throws -> HTTPStatus {
+    guard let id = req.parameters.get("id", as: PurchaseOrder.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Purchase order id not provided.")
+    }
+    try await purchaseOrders.delete(id: id, on: req.db)
+    return .ok
+  }
+
+  // @Sendable
+  // func update(req: Request) async throws -> PurchaseOrder.DTO {
+  //   guard let id = req.parameters.get("id", as: PurchaseOrder.IDValue.self) else {
+  //     throw Abort(.badRequest, reason: "Purchase order id not provided.")
+  //   }
+  //   try await purchaseOrders.delete(id: id, on: req.db)
+  //   return .ok
+  // }
+}

Sources/App/Controllers/Api/UserApiController.swift

@@ -0,0 +1,59 @@
+import Fluent
+import Vapor
+
+// TODO: Add update and get by id.
+struct UserApiController: RouteCollection {
+  let users = UserDB()
+
+  func boot(routes: any RoutesBuilder) throws {
+    let unProtected = routes.apiUnprotected(route: "users")
+    let protected = routes.apiProtected(route: "users")
+
+    unProtected.post(use: create(req:))
+    protected.get(use: index(req:))
+    protected.post("login", use: login(req:))
+    protected.group(":id") {
+      $0.delete(use: delete(req:))
+    }
+  }
+
+  @Sendable
+  func index(req: Request) async throws -> [User.DTO] {
+    try await users.fetchAll(on: req.db)
+  }
+
+  @Sendable
+  func create(req: Request) async throws -> User.DTO {
+    // Allow the first user to be created without authentication.
+    let count = try await User.query(on: req.db).count()
+    if count > 0 {
+      guard req.auth.get(User.self) != nil else {
+        throw Abort(.unauthorized)
+      }
+    }
+    try User.Create.validate(content: req)
+    let model = try req.content.decode(User.Create.self)
+    return try await users.create(model, on: req.db)
+  }
+
+  @Sendable
+  func login(req: Request) async throws -> UserToken {
+    let user = try req.auth.require(User.self)
+    return try await users.login(user: user, on: req.db)
+  }
+
+  // @Sendable
+  // func get(req: Request) async throws -> User.DTO {
+  //   guard let id = req.parameters.get("id", as: User.IDValue.self),
+  //   let user = users.
+  // }
+
+  @Sendable
+  func delete(req: Request) async throws -> HTTPStatus {
+    guard let id = req.parameters.get("id", as: User.IDValue.self) else {
+      throw Abort(.badRequest, reason: "User id not provided")
+    }
+    try await users.delete(id: id, on: req.db)
+    return .ok
+  }
+}

Sources/App/Controllers/Api/VendorApiController.swift

@@ -0,0 +1,52 @@
+import Fluent
+import Vapor
+
+struct VendorApiController: RouteCollection {
+  private let vendors = VendorDB()
+
+  func boot(routes: any RoutesBuilder) throws {
+    let protected = routes.apiProtected(route: "vendors")
+    protected.get(use: index(req:))
+    protected.post(use: create(req:))
+    protected.group(":id") {
+      $0.put(use: update(req:))
+      $0.delete(use: delete(req:))
+    }
+  }
+
+  @Sendable
+  func index(req: Request) async throws -> [Vendor.DTO] {
+    let params = try req.query.decode(VendorsIndexQuery.self)
+    return try await vendors.fetchAll(withBranches: params.branches, on: req.db)
+  }
+
+  @Sendable
+  func create(req: Request) async throws -> Vendor.DTO {
+    try Vendor.Create.validate(content: req)
+    let model = try req.content.decode(Vendor.Create.self)
+    return try await vendors.create(model, on: req.db)
+  }
+
+  @Sendable
+  func update(req: Request) async throws -> Vendor.DTO {
+    guard let id = req.parameters.get("id", as: Vendor.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Vendor id not provided.")
+    }
+    try Vendor.Update.validate(content: req)
+    let updates = try req.content.decode(Vendor.Update.self)
+    return try await vendors.update(id: id, with: updates, on: req.db)
+  }
+
+  @Sendable
+  func delete(req: Request) async throws -> HTTPStatus {
+    guard let id = req.parameters.get("id", as: Vendor.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Vendor id not provided.")
+    }
+    try await vendors.delete(id: id, on: req.db)
+    return .ok
+  }
+}
+
+struct VendorsIndexQuery: Content {
+  let branches: Bool?
+}

Sources/App/Controllers/Api/VendorBranchApiController.swift

@@ -0,0 +1,64 @@
+import Fluent
+import Vapor
+
+struct VendorBranchApiController: RouteCollection {
+  private let vendorBranches = VendorBranchDB()
+
+  func boot(routes: any RoutesBuilder) throws {
+    let prefix = routes.apiProtected(route: "vendors")
+    let root = prefix.grouped("branches")
+    root.get(use: index(req:))
+    root.group(":id") {
+      $0.put(use: update(req:))
+      $0.delete(use: delete(req:))
+    }
+
+    prefix.group(":vendorID", "branches") {
+      $0.get(use: indexForVendor(req:))
+      $0.post(use: create(req:))
+    }
+  }
+
+  @Sendable
+  func index(req: Request) async throws -> [VendorBranch.DTO] {
+    try await vendorBranches.fetchAll(on: req.db)
+  }
+
+  @Sendable
+  func indexForVendor(req: Request) async throws -> [VendorBranch.DTO] {
+    guard let id = req.parameters.get("vendorID", as: Vendor.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Vendor id not provided.")
+    }
+    return try await vendorBranches.fetch(for: id, on: req.db)
+  }
+
+  @Sendable
+  func create(req: Request) async throws -> VendorBranch.DTO {
+    guard let id = req.parameters.get("vendorID", as: Vendor.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Vendor id not provided.")
+    }
+    try VendorBranch.Create.validate(content: req)
+    let model = try req.content.decode(VendorBranch.Create.self)
+    return try await vendorBranches.create(model, for: id, on: req.db)
+  }
+
+  @Sendable
+  func update(req: Request) async throws -> VendorBranch.DTO {
+    guard let id = req.parameters.get("id", as: VendorBranch.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Vendor branch id not provided.")
+    }
+    try VendorBranch.Update.validate(content: req)
+    let updates = try req.content.decode(VendorBranch.Update.self)
+    return try await vendorBranches.update(id: id, with: updates, on: req.db)
+  }
+
+  @Sendable
+  func delete(req: Request) async throws -> HTTPStatus {
+    guard let id = req.parameters.get("id", as: VendorBranch.IDValue.self) else {
+      throw Abort(.badRequest, reason: "Vendor branch id not provided.")
+    }
+    try await vendorBranches.delete(id: id, on: req.db)
+    return .ok
+  }
+
+}