@fleetbase/fleetops-engine 0.6.58 → 0.6.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (701) hide show
  1. package/README.md +3 -0
  2. package/RELEASE.md +36 -0
  3. package/addon/components/customer/form.hbs +0 -49
  4. package/addon/components/entity/card.hbs +1 -0
  5. package/addon/components/modals/order-label.hbs +1 -1
  6. package/addon/components/place/form.hbs +1 -1
  7. package/addon/components/vehicle/details/schedules.hbs +2 -2
  8. package/addon/components/vehicle/details/schedules.js +7 -1
  9. package/addon/controllers/maintenance/schedules/index/edit.js +10 -1
  10. package/addon/services/entity-actions.js +32 -0
  11. package/addon/services/vehicle-actions.js +4 -2
  12. package/addon/styles/fleetops-engine.css +0 -1
  13. package/composer.json +8 -3
  14. package/extension.json +1 -1
  15. package/index.js +7 -1
  16. package/package.json +2 -1
  17. package/scripts/coverage-file-runner.php +240 -0
  18. package/scripts/coverage-runner.php +2 -1
  19. package/scripts/coverage-summary.php +41 -2
  20. package/scripts/pest-bootstrap.php +237 -3
  21. package/scripts/pest-file-runner.php +13 -1
  22. package/scripts/pest-runner.php +57 -2
  23. package/server/config/fleetops.php +44 -0
  24. package/server/config/geocoder.php +1 -1
  25. package/server/migrations/2026_08_08_000001_make_sku_and_provider_transaction_unique_indexes_soft_delete_aware.php +152 -0
  26. package/server/resources/views/labels/entity-label.php +4 -4
  27. package/server/src/Casts/MultiPolygon.php +8 -3
  28. package/server/src/Casts/OrderConfigEntities.php +10 -3
  29. package/server/src/Casts/Point.php +10 -6
  30. package/server/src/Casts/Polygon.php +5 -2
  31. package/server/src/Console/Commands/AssignCustomerRoles.php +28 -6
  32. package/server/src/Console/Commands/AssignDriverRoles.php +36 -6
  33. package/server/src/Console/Commands/AuditCustomerUserConflicts.php +6 -1
  34. package/server/src/Console/Commands/DispatchAdhocOrders.php +12 -2
  35. package/server/src/Console/Commands/FixCustomerCompanies.php +46 -11
  36. package/server/src/Console/Commands/FixDriverCompanies.php +18 -3
  37. package/server/src/Console/Commands/FixLegacyOrderConfigs.php +31 -6
  38. package/server/src/Console/Commands/ProcessMaintenanceTriggers.php +94 -42
  39. package/server/src/Console/Commands/PurgeUnpurchasedServiceQuotes.php +42 -12
  40. package/server/src/Console/Commands/ReplayVehicleLocations.php +120 -55
  41. package/server/src/Console/Commands/SendDriverNotification.php +25 -4
  42. package/server/src/Console/Commands/SendMaintenanceReminders.php +43 -23
  43. package/server/src/Console/Commands/SimulateOrderRouteNavigation.php +36 -6
  44. package/server/src/Console/Commands/TrackOrderDistanceAndTime.php +6 -1
  45. package/server/src/Events/DriverLocationChanged.php +1 -1
  46. package/server/src/Events/DriverSimulatedLocationChanged.php +1 -1
  47. package/server/src/Events/EntityActivityChanged.php +1 -1
  48. package/server/src/Events/EntityCompleted.php +1 -1
  49. package/server/src/Events/EntityDriverAssigned.php +1 -1
  50. package/server/src/Events/FuelProviderTransactionImported.php +1 -1
  51. package/server/src/Events/FuelProviderTransactionMatched.php +1 -1
  52. package/server/src/Events/FuelProviderTransactionUnmatched.php +1 -1
  53. package/server/src/Events/FuelReportCreatedFromProvider.php +1 -1
  54. package/server/src/Events/GeofenceDwelled.php +1 -1
  55. package/server/src/Events/GeofenceEntered.php +1 -1
  56. package/server/src/Events/GeofenceExited.php +1 -1
  57. package/server/src/Events/VehicleLocationChanged.php +1 -1
  58. package/server/src/Events/WaypointActivityChanged.php +1 -1
  59. package/server/src/Events/WaypointCompleted.php +1 -1
  60. package/server/src/Exceptions/IntegratedVendorException.php +2 -2
  61. package/server/src/Exceptions/TelematicRateLimitExceededException.php +1 -1
  62. package/server/src/Http/Controllers/Api/v1/ContactController.php +89 -22
  63. package/server/src/Http/Controllers/Api/v1/CustomerController.php +346 -101
  64. package/server/src/Http/Controllers/Api/v1/DeviceController.php +48 -14
  65. package/server/src/Http/Controllers/Api/v1/DriverController.php +224 -64
  66. package/server/src/Http/Controllers/Api/v1/EntityController.php +112 -66
  67. package/server/src/Http/Controllers/Api/v1/EquipmentController.php +40 -10
  68. package/server/src/Http/Controllers/Api/v1/FleetController.php +54 -14
  69. package/server/src/Http/Controllers/Api/v1/FuelReportController.php +54 -14
  70. package/server/src/Http/Controllers/Api/v1/FuelTransactionController.php +36 -11
  71. package/server/src/Http/Controllers/Api/v1/GeofenceController.php +73 -23
  72. package/server/src/Http/Controllers/Api/v1/IssueController.php +54 -14
  73. package/server/src/Http/Controllers/Api/v1/LabelController.php +61 -22
  74. package/server/src/Http/Controllers/Api/v1/NavigatorController.php +32 -15
  75. package/server/src/Http/Controllers/Api/v1/OrderConfigController.php +35 -5
  76. package/server/src/Http/Controllers/Api/v1/OrderController.php +388 -203
  77. package/server/src/Http/Controllers/Api/v1/PartController.php +40 -10
  78. package/server/src/Http/Controllers/Api/v1/PayloadController.php +90 -30
  79. package/server/src/Http/Controllers/Api/v1/PlaceController.php +188 -91
  80. package/server/src/Http/Controllers/Api/v1/PurchaseRateController.php +100 -36
  81. package/server/src/Http/Controllers/Api/v1/ServiceAreaController.php +96 -26
  82. package/server/src/Http/Controllers/Api/v1/ServiceQuoteController.php +169 -81
  83. package/server/src/Http/Controllers/Api/v1/ServiceRateController.php +104 -75
  84. package/server/src/Http/Controllers/Api/v1/TrackingNumberController.php +92 -14
  85. package/server/src/Http/Controllers/Api/v1/TrackingStatusController.php +66 -16
  86. package/server/src/Http/Controllers/Api/v1/VehicleController.php +121 -67
  87. package/server/src/Http/Controllers/Api/v1/VendorController.php +54 -14
  88. package/server/src/Http/Controllers/Api/v1/WorkOrderController.php +47 -12
  89. package/server/src/Http/Controllers/Api/v1/ZoneController.php +84 -24
  90. package/server/src/Http/Controllers/Concerns/ResolvesReviewAccountBypass.php +62 -0
  91. package/server/src/Http/Controllers/Internal/v1/AnalyticsController.php +15 -5
  92. package/server/src/Http/Controllers/Internal/v1/ContactController.php +113 -28
  93. package/server/src/Http/Controllers/Internal/v1/CustomerController.php +36 -11
  94. package/server/src/Http/Controllers/Internal/v1/DeviceController.php +9 -4
  95. package/server/src/Http/Controllers/Internal/v1/DriverController.php +168 -70
  96. package/server/src/Http/Controllers/Internal/v1/EquipmentController.php +18 -3
  97. package/server/src/Http/Controllers/Internal/v1/FleetController.php +137 -60
  98. package/server/src/Http/Controllers/Internal/v1/FleetOpsLookupController.php +24 -9
  99. package/server/src/Http/Controllers/Internal/v1/FuelReportController.php +18 -3
  100. package/server/src/Http/Controllers/Internal/v1/GeocoderController.php +26 -8
  101. package/server/src/Http/Controllers/Internal/v1/GettingStartedController.php +12 -2
  102. package/server/src/Http/Controllers/Internal/v1/IntegratedVendorController.php +27 -6
  103. package/server/src/Http/Controllers/Internal/v1/IssueController.php +82 -29
  104. package/server/src/Http/Controllers/Internal/v1/MaintenanceController.php +34 -26
  105. package/server/src/Http/Controllers/Internal/v1/MaintenanceScheduleController.php +141 -97
  106. package/server/src/Http/Controllers/Internal/v1/ManifestController.php +28 -8
  107. package/server/src/Http/Controllers/Internal/v1/MetricsController.php +21 -12
  108. package/server/src/Http/Controllers/Internal/v1/MorphController.php +90 -18
  109. package/server/src/Http/Controllers/Internal/v1/NavigatorController.php +88 -35
  110. package/server/src/Http/Controllers/Internal/v1/OrchestrationController.php +149 -39
  111. package/server/src/Http/Controllers/Internal/v1/OrderConfigController.php +54 -18
  112. package/server/src/Http/Controllers/Internal/v1/OrderController.php +298 -86
  113. package/server/src/Http/Controllers/Internal/v1/PartController.php +18 -3
  114. package/server/src/Http/Controllers/Internal/v1/PaymentController.php +46 -14
  115. package/server/src/Http/Controllers/Internal/v1/PlaceController.php +31 -5
  116. package/server/src/Http/Controllers/Internal/v1/ProofController.php +88 -48
  117. package/server/src/Http/Controllers/Internal/v1/SearchController.php +1 -1
  118. package/server/src/Http/Controllers/Internal/v1/SensorController.php +6 -1
  119. package/server/src/Http/Controllers/Internal/v1/ServiceAreaController.php +6 -1
  120. package/server/src/Http/Controllers/Internal/v1/ServiceQuoteController.php +255 -105
  121. package/server/src/Http/Controllers/Internal/v1/SettingController.php +88 -35
  122. package/server/src/Http/Controllers/Internal/v1/TelematicController.php +1 -4
  123. package/server/src/Http/Controllers/Internal/v1/Traits/DriverSchedulingTrait.php +42 -14
  124. package/server/src/Http/Controllers/Internal/v1/VendorController.php +103 -33
  125. package/server/src/Http/Controllers/Internal/v1/WorkOrderController.php +42 -12
  126. package/server/src/Http/Filter/DriverFilter.php +2 -2
  127. package/server/src/Http/Filter/MaintenanceScheduleFilter.php +40 -0
  128. package/server/src/Http/Filter/OrderFilter.php +1 -1
  129. package/server/src/Http/Filter/VehicleFilter.php +21 -7
  130. package/server/src/Http/Middleware/AuthenticateCustomerToken.php +12 -2
  131. package/server/src/Http/Requests/BulkDispatchRequest.php +3 -9
  132. package/server/src/Http/Requests/CancelOrderRequest.php +2 -6
  133. package/server/src/Http/Requests/CreateContactRequest.php +2 -6
  134. package/server/src/Http/Requests/CreateCustomerRequest.php +9 -1
  135. package/server/src/Http/Requests/CreateDeviceRequest.php +2 -2
  136. package/server/src/Http/Requests/CreateDriverRequest.php +3 -9
  137. package/server/src/Http/Requests/CreateEntityRequest.php +2 -6
  138. package/server/src/Http/Requests/CreateEquipmentRequest.php +2 -2
  139. package/server/src/Http/Requests/CreateFleetRequest.php +2 -6
  140. package/server/src/Http/Requests/CreateFuelReportRequest.php +16 -9
  141. package/server/src/Http/Requests/CreateFuelTransactionRequest.php +66 -3
  142. package/server/src/Http/Requests/CreateIssueRequest.php +2 -6
  143. package/server/src/Http/Requests/CreateOrderRequest.php +7 -8
  144. package/server/src/Http/Requests/CreatePartRequest.php +41 -3
  145. package/server/src/Http/Requests/CreatePayloadRequest.php +7 -9
  146. package/server/src/Http/Requests/CreatePlaceRequest.php +2 -6
  147. package/server/src/Http/Requests/CreatePurchaseRateRequest.php +2 -6
  148. package/server/src/Http/Requests/CreateSensorRequest.php +2 -2
  149. package/server/src/Http/Requests/CreateServiceAreaRequest.php +2 -6
  150. package/server/src/Http/Requests/CreateServiceQuoteRequest.php +2 -6
  151. package/server/src/Http/Requests/CreateServiceRateRequest.php +2 -6
  152. package/server/src/Http/Requests/CreateTrackingNumberRequest.php +2 -6
  153. package/server/src/Http/Requests/CreateTrackingStatusRequest.php +2 -6
  154. package/server/src/Http/Requests/CreateVehicleRequest.php +2 -6
  155. package/server/src/Http/Requests/CreateVendorRequest.php +2 -6
  156. package/server/src/Http/Requests/CreateWorkOrderRequest.php +2 -2
  157. package/server/src/Http/Requests/CreateZoneRequest.php +2 -6
  158. package/server/src/Http/Requests/DecodeTrackingNumberQR.php +2 -6
  159. package/server/src/Http/Requests/DriverSimulationRequest.php +2 -6
  160. package/server/src/Http/Requests/Internal/AssignOrderRequest.php +3 -7
  161. package/server/src/Http/Requests/Internal/CreateDriverRequest.php +4 -12
  162. package/server/src/Http/Requests/Internal/CreateOrderConfigRequest.php +2 -6
  163. package/server/src/Http/Requests/Internal/CreateOrderRequest.php +7 -8
  164. package/server/src/Http/Requests/Internal/FleetActionRequest.php +18 -12
  165. package/server/src/Http/Requests/Internal/UpdateDriverRequest.php +6 -3
  166. package/server/src/Http/Requests/QueryServiceQuotesRequest.php +2 -6
  167. package/server/src/Http/Requests/ScheduleOrderRequest.php +2 -6
  168. package/server/src/Http/Requests/UpdateIssueRequest.php +1 -3
  169. package/server/src/Http/Resources/v1/Customer.php +2 -2
  170. package/server/src/Http/Resources/v1/Maintenance.php +3 -4
  171. package/server/src/Http/Resources/v1/MaintenanceSchedule.php +3 -4
  172. package/server/src/Http/Resources/v1/Order.php +3 -7
  173. package/server/src/Http/Resources/v1/PurchaseRate.php +4 -6
  174. package/server/src/Http/Resources/v1/TrackingNumber.php +33 -0
  175. package/server/src/Http/Resources/v1/TrackingStatus.php +4 -6
  176. package/server/src/Http/Resources/v1/WorkOrder.php +3 -4
  177. package/server/src/Imports/ContactImport.php +10 -1
  178. package/server/src/Imports/DriverImport.php +10 -1
  179. package/server/src/Imports/EquipmentImport.php +6 -1
  180. package/server/src/Imports/FleetImport.php +10 -1
  181. package/server/src/Imports/FuelReportImport.php +10 -1
  182. package/server/src/Imports/IssueImport.php +10 -1
  183. package/server/src/Imports/MaintenanceImport.php +6 -1
  184. package/server/src/Imports/MaintenanceScheduleImport.php +6 -1
  185. package/server/src/Imports/PartImport.php +6 -1
  186. package/server/src/Imports/PlaceImport.php +10 -1
  187. package/server/src/Imports/VehicleImport.php +10 -1
  188. package/server/src/Imports/VendorImport.php +10 -1
  189. package/server/src/Imports/WorkOrderImport.php +6 -1
  190. package/server/src/Integrations/Lalamove/Lalamove.php +3 -7
  191. package/server/src/Integrations/Lalamove/LalamoveServiceType.php +5 -8
  192. package/server/src/Jobs/CheckGeofenceDwell.php +41 -16
  193. package/server/src/Jobs/FinalizeApiOrderCreation.php +17 -2
  194. package/server/src/Jobs/FinalizeInternalOrderCreation.php +11 -1
  195. package/server/src/Jobs/NotifyBulkAssignedDriver.php +29 -16
  196. package/server/src/Jobs/ProcessAllocationJob.php +59 -25
  197. package/server/src/Jobs/ReplayPositions.php +17 -10
  198. package/server/src/Jobs/SendPositionReplay.php +18 -7
  199. package/server/src/Jobs/SimulateDrivingRoute.php +14 -3
  200. package/server/src/Jobs/SyncFuelProviderTransactionsJob.php +12 -2
  201. package/server/src/Listeners/HandleDeliveryCompletion.php +11 -1
  202. package/server/src/Listeners/HandleGeofenceDwelled.php +6 -1
  203. package/server/src/Listeners/HandleGeofenceEntered.php +4 -2
  204. package/server/src/Listeners/HandleGeofenceExited.php +6 -1
  205. package/server/src/Listeners/HandleOrderCanceled.php +18 -3
  206. package/server/src/Listeners/HandleOrderDispatchFailed.php +12 -2
  207. package/server/src/Listeners/HandleOrderDispatched.php +61 -26
  208. package/server/src/Listeners/HandleOrderDriverAssigned.php +12 -2
  209. package/server/src/Listeners/HandleUserRemovedFromCompany.php +19 -6
  210. package/server/src/Listeners/NotifyDriverOnShiftChange.php +24 -4
  211. package/server/src/Listeners/NotifyOrderEvent.php +11 -6
  212. package/server/src/Models/Contact.php +6 -7
  213. package/server/src/Models/Device.php +26 -3
  214. package/server/src/Models/Driver.php +0 -6
  215. package/server/src/Models/Entity.php +4 -4
  216. package/server/src/Models/Equipment.php +1 -1
  217. package/server/src/Models/FuelReport.php +26 -1
  218. package/server/src/Models/IntegratedVendor.php +2 -2
  219. package/server/src/Models/Issue.php +5 -1
  220. package/server/src/Models/MaintenanceSchedule.php +25 -10
  221. package/server/src/Models/Order.php +18 -15
  222. package/server/src/Models/OrderConfig.php +1 -1
  223. package/server/src/Models/Payload.php +9 -16
  224. package/server/src/Models/Place.php +20 -13
  225. package/server/src/Models/Sensor.php +24 -0
  226. package/server/src/Models/ServiceArea.php +3 -6
  227. package/server/src/Models/ServiceQuote.php +5 -0
  228. package/server/src/Models/ServiceRate.php +13 -6
  229. package/server/src/Models/Telematic.php +2 -2
  230. package/server/src/Models/TrackingNumber.php +55 -10
  231. package/server/src/Models/TrackingStatus.php +24 -4
  232. package/server/src/Models/Waypoint.php +44 -10
  233. package/server/src/Models/Zone.php +3 -6
  234. package/server/src/Notifications/DriverArrivedAtGeofence.php +1 -1
  235. package/server/src/Notifications/OrderDispatched.php +3 -9
  236. package/server/src/Notifications/OrderPing.php +3 -9
  237. package/server/src/Observers/CategoryObserver.php +6 -1
  238. package/server/src/Observers/CompanyObserver.php +5 -0
  239. package/server/src/Observers/CompanyUserObserver.php +12 -2
  240. package/server/src/Observers/DriverObserver.php +19 -4
  241. package/server/src/Observers/FleetObserver.php +6 -1
  242. package/server/src/Observers/PurchaseRateObserver.php +66 -11
  243. package/server/src/Observers/ServiceAreaObserver.php +12 -2
  244. package/server/src/Observers/ServiceRateObserver.php +21 -6
  245. package/server/src/Observers/TrackingNumberObserver.php +19 -4
  246. package/server/src/Observers/UserObserver.php +6 -1
  247. package/server/src/Observers/VehicleObserver.php +27 -7
  248. package/server/src/Observers/WorkOrderObserver.php +27 -7
  249. package/server/src/Orchestration/Engines/DriverAssignmentEngine.php +8 -3
  250. package/server/src/Orchestration/Support/OrchestrationPayloadBuilder.php +2 -2
  251. package/server/src/Providers/FleetOpsServiceProvider.php +12 -0
  252. package/server/src/Providers/NotificationServiceProvider.php +6 -0
  253. package/server/src/Support/Ai/Capabilities/AssetStatusCapability.php +36 -26
  254. package/server/src/Support/Ai/Capabilities/CreateOrderPreviewCapability.php +18 -5
  255. package/server/src/Support/Ai/Capabilities/OrderInsightsCapability.php +6 -1
  256. package/server/src/Support/Ai/Capabilities/SearchResourcesCapability.php +26 -6
  257. package/server/src/Support/Analytics/FuelEfficiency.php +9 -3
  258. package/server/src/Support/Analytics/FuelProviderSummary.php +14 -5
  259. package/server/src/Support/Analytics/GeofenceViolations.php +40 -20
  260. package/server/src/Support/Analytics/IssuesInsights.php +38 -18
  261. package/server/src/Support/Analytics/MaintenanceOverview.php +51 -21
  262. package/server/src/Support/Analytics/OnTimeDelivery.php +3 -2
  263. package/server/src/Support/Analytics/OperationsPulse.php +59 -35
  264. package/server/src/Support/Analytics/OrdersByStatus.php +12 -7
  265. package/server/src/Support/Analytics/RevenueTrend.php +16 -6
  266. package/server/src/Support/Analytics/TopDrivers.php +3 -2
  267. package/server/src/Support/FleetOps.php +109 -104
  268. package/server/src/Support/FuelProviders/FuelProviderService.php +10 -1
  269. package/server/src/Support/Geocoding.php +52 -14
  270. package/server/src/Support/GeofenceIntersectionService.php +47 -27
  271. package/server/src/Support/LiveOrderQuery.php +6 -1
  272. package/server/src/Support/Metrics/ActiveRevenueQuery.php +3 -2
  273. package/server/src/Support/Metrics/FuelCostsMetric.php +6 -1
  274. package/server/src/Support/ResolvesOrderServiceStops.php +10 -0
  275. package/server/src/Support/Telematics/Providers/GeotabProvider.php +9 -4
  276. package/server/src/Support/Utils.php +122 -16
  277. package/server/src/Tracking/Providers/GoogleRoutesTrackingProvider.php +6 -1
  278. package/server/src/Tracking/Providers/OsrmTrackingProvider.php +11 -6
  279. package/server/src/Tracking/TrackingProviderManager.php +2 -3
  280. package/server/src/Tracking/TrackingProviderRegistry.php +8 -4
  281. package/server/src/Traits/PayloadAccessors.php +6 -1
  282. package/server/src/routes.php +24 -17
  283. package/server/tests/AiOperationalQueryCapabilityTest.php +457 -1
  284. package/server/tests/AiPreviewCapabilityContractsTest.php +180 -0
  285. package/server/tests/AnalyticsRoutesTest.php +380 -1
  286. package/server/tests/AnalyticsWidgetContractsTest.php +740 -0
  287. package/server/tests/ApiContactControllerContractsTest.php +284 -0
  288. package/server/tests/ApiCustomerControllerContractsTest.php +1130 -0
  289. package/server/tests/ApiDriverControllerContractsTest.php +603 -0
  290. package/server/tests/ApiEntityControllerContractsTest.php +329 -0
  291. package/server/tests/ApiEquipmentControllerContractsTest.php +239 -0
  292. package/server/tests/ApiFleetControllerContractsTest.php +176 -0
  293. package/server/tests/ApiFuelReportControllerContractsTest.php +217 -0
  294. package/server/tests/ApiIssueControllerContractsTest.php +217 -0
  295. package/server/tests/ApiOrderControllerContractsTest.php +1030 -0
  296. package/server/tests/ApiPartControllerContractsTest.php +251 -0
  297. package/server/tests/ApiPayloadControllerContractsTest.php +314 -0
  298. package/server/tests/ApiPlaceControllerContractsTest.php +541 -0
  299. package/server/tests/ApiPurchaseRateControllerContractsTest.php +283 -0
  300. package/server/tests/ApiServiceAreaZoneControllerContractsTest.php +442 -0
  301. package/server/tests/ApiServiceQuoteControllerContractsTest.php +322 -0
  302. package/server/tests/ApiTrackingNumberControllerContractsTest.php +225 -0
  303. package/server/tests/ApiTrackingStatusControllerContractsTest.php +254 -0
  304. package/server/tests/ApiVehicleControllerContractsTest.php +368 -0
  305. package/server/tests/ApiVendorControllerContractsTest.php +199 -0
  306. package/server/tests/AssetAndPlaceSearchContractsTest.php +220 -0
  307. package/server/tests/BackendSmallModelContractsTest.php +354 -0
  308. package/server/tests/CapacityAllocationEngineTest.php +56 -0
  309. package/server/tests/CommandContractsTest.php +2695 -0
  310. package/server/tests/CompactResourceSerializationTest.php +2838 -0
  311. package/server/tests/ControllerFilterContractsTest.php +1273 -0
  312. package/server/tests/ControllerHelperContractsTest.php +1740 -0
  313. package/server/tests/ControllerSerializationContractsTest.php +141 -0
  314. package/server/tests/CoverageSummaryScriptTest.php +93 -0
  315. package/server/tests/CustomerContactIdentitySafetyTest.php +1 -6
  316. package/server/tests/CustomerEndpointTest.php +169 -2
  317. package/server/tests/DriverFilterExecutionTest.php +263 -0
  318. package/server/tests/DriverGeofenceProcessingTest.php +153 -0
  319. package/server/tests/DriverResourceSerializationTest.php +245 -0
  320. package/server/tests/DriverSchedulingTraitContractsTest.php +259 -0
  321. package/server/tests/EventContractsTest.php +1259 -0
  322. package/server/tests/ExceptionContractsTest.php +81 -0
  323. package/server/tests/ExpansionContractsTest.php +242 -0
  324. package/server/tests/ExportCoverageTest.php +116 -0
  325. package/server/tests/Feature/Http/Api/ContactControllerPhotoAndDeleteTest.php +199 -0
  326. package/server/tests/Feature/Http/Api/CustomerControllerHelperSeamsTest.php +831 -0
  327. package/server/tests/Feature/Http/Api/DeviceControllerContractsTest.php +347 -0
  328. package/server/tests/Feature/Http/Api/DeviceControllerCrudTest.php +176 -0
  329. package/server/tests/Feature/Http/Api/DriverControllerAuthFlowsTest.php +530 -0
  330. package/server/tests/Feature/Http/Api/DriverControllerHelpersTest.php +240 -0
  331. package/server/tests/Feature/Http/Api/DriverControllerLookupTest.php +186 -0
  332. package/server/tests/Feature/Http/Api/DriverControllerOrganizationsTest.php +112 -0
  333. package/server/tests/Feature/Http/Api/DriverControllerSessionHelpersTest.php +207 -0
  334. package/server/tests/Feature/Http/Api/DriverControllerSwitchOrgAndGeofenceTest.php +329 -0
  335. package/server/tests/Feature/Http/Api/DriverControllerTrackTest.php +383 -0
  336. package/server/tests/Feature/Http/Api/EntityControllerHelpersTest.php +150 -0
  337. package/server/tests/Feature/Http/Api/FuelTransactionControllerContractsTest.php +352 -0
  338. package/server/tests/Feature/Http/Api/GeofenceControllerContractsTest.php +461 -0
  339. package/server/tests/Feature/Http/Api/LabelControllerSubjectsTest.php +148 -0
  340. package/server/tests/Feature/Http/Api/OrderConfigControllerTest.php +112 -0
  341. package/server/tests/Feature/Http/Api/OrderControllerCreateTest.php +279 -0
  342. package/server/tests/Feature/Http/Api/OrderControllerIntegratedVendorTest.php +295 -0
  343. package/server/tests/Feature/Http/Api/OrderControllerLifecycleActionsTest.php +279 -0
  344. package/server/tests/Feature/Http/Api/OrderControllerLookupHelpersTest.php +207 -0
  345. package/server/tests/Feature/Http/Api/OrderControllerNearbyFiltersTest.php +282 -0
  346. package/server/tests/Feature/Http/Api/OrderControllerPersistenceHelpersTest.php +216 -0
  347. package/server/tests/Feature/Http/Api/OrderControllerQueryFiltersTest.php +184 -0
  348. package/server/tests/Feature/Http/Api/OrderControllerStartActivityTest.php +663 -0
  349. package/server/tests/Feature/Http/Api/PayloadControllerHelpersTest.php +134 -0
  350. package/server/tests/Feature/Http/Api/PlaceAndServiceQuoteSeamsTest.php +479 -0
  351. package/server/tests/Feature/Http/Api/PurchaseRateControllerHelpersTest.php +176 -0
  352. package/server/tests/Feature/Http/Api/PurchaseRateControllerOrderCreationTest.php +268 -0
  353. package/server/tests/Feature/Http/Api/SensorControllerCrudTest.php +239 -0
  354. package/server/tests/Feature/Http/Api/ServiceAreaControllerBorderAndSeamsTest.php +187 -0
  355. package/server/tests/Feature/Http/Api/ServiceQuoteControllerQueryTest.php +405 -0
  356. package/server/tests/Feature/Http/Api/ServiceQuoteControllerVendorBridgeTest.php +212 -0
  357. package/server/tests/Feature/Http/Api/ServiceRateControllerContractsTest.php +263 -0
  358. package/server/tests/Feature/Http/Api/SmallApiControllerHelpersTest.php +272 -0
  359. package/server/tests/Feature/Http/Api/TrackingNumberControllerHelpersTest.php +160 -0
  360. package/server/tests/Feature/Http/Api/TrackingStatusControllerHelpersTest.php +165 -0
  361. package/server/tests/Feature/Http/Api/VehicleControllerTrackingTest.php +483 -0
  362. package/server/tests/Feature/Http/Api/WorkOrderControllerContractsTest.php +326 -0
  363. package/server/tests/Feature/Http/Api/WorkOrderControllerHelpersTest.php +130 -0
  364. package/server/tests/Feature/Http/Api/ZoneControllerBordersAndSeamsTest.php +294 -0
  365. package/server/tests/Feature/Http/FleetOpsRouteRegistrationTest.php +189 -0
  366. package/server/tests/Feature/Http/Internal/AnalyticsControllerSeamsTest.php +53 -0
  367. package/server/tests/Feature/Http/Internal/ContactControllerContractsTest.php +240 -0
  368. package/server/tests/Feature/Http/Internal/ContactControllerCustomerGuardsTest.php +128 -0
  369. package/server/tests/Feature/Http/Internal/ContactControllerEndpointsTest.php +294 -0
  370. package/server/tests/Feature/Http/Internal/CustomerControllerCredentialsTest.php +196 -0
  371. package/server/tests/Feature/Http/Internal/DeviceControllerContractsTest.php +370 -0
  372. package/server/tests/Feature/Http/Internal/DeviceControllerExportAndFiltersTest.php +151 -0
  373. package/server/tests/Feature/Http/Internal/DriverControllerContractsTest.php +1167 -0
  374. package/server/tests/Feature/Http/Internal/DriverControllerCreateRecordTest.php +233 -0
  375. package/server/tests/Feature/Http/Internal/DriverControllerExistingUserAdoptionTest.php +710 -0
  376. package/server/tests/Feature/Http/Internal/DriverControllerHelpersTest.php +218 -0
  377. package/server/tests/Feature/Http/Internal/FleetAssignmentsAndTriggersTest.php +198 -0
  378. package/server/tests/Feature/Http/Internal/FleetOpsLookupControllerDbTest.php +90 -0
  379. package/server/tests/Feature/Http/Internal/HubControllerTest.php +206 -0
  380. package/server/tests/Feature/Http/Internal/IssueControllerContractsTest.php +404 -0
  381. package/server/tests/Feature/Http/Internal/IssueControllerExportImportTest.php +118 -0
  382. package/server/tests/Feature/Http/Internal/LiveControllerEndpointsTest.php +246 -0
  383. package/server/tests/Feature/Http/Internal/LiveControllerTest.php +778 -0
  384. package/server/tests/Feature/Http/Internal/MaintenanceScheduleControllerContractsTest.php +263 -0
  385. package/server/tests/Feature/Http/Internal/MaintenanceScheduleControllerSurfacesTest.php +214 -0
  386. package/server/tests/Feature/Http/Internal/MetricsControllerContractsTest.php +249 -0
  387. package/server/tests/Feature/Http/Internal/MetricsControllerHelpersTest.php +66 -0
  388. package/server/tests/Feature/Http/Internal/MorphControllerHelpersTest.php +125 -0
  389. package/server/tests/Feature/Http/Internal/NavigatorControllerHelpersTest.php +201 -0
  390. package/server/tests/Feature/Http/Internal/OrchestrationControllerContractsTest.php +928 -0
  391. package/server/tests/Feature/Http/Internal/OrchestrationControllerHelpersTest.php +214 -0
  392. package/server/tests/Feature/Http/Internal/OrchestrationControllerImportOrdersTest.php +340 -0
  393. package/server/tests/Feature/Http/Internal/OrderConfigControllerContractsTest.php +314 -0
  394. package/server/tests/Feature/Http/Internal/OrderControllerActivityFlowsTest.php +663 -0
  395. package/server/tests/Feature/Http/Internal/OrderControllerCapturePhotoTest.php +507 -0
  396. package/server/tests/Feature/Http/Internal/OrderControllerContractsTest.php +1742 -0
  397. package/server/tests/Feature/Http/Internal/OrderControllerCreateRecordTest.php +488 -0
  398. package/server/tests/Feature/Http/Internal/OrderControllerHelperSeamsTest.php +298 -0
  399. package/server/tests/Feature/Http/Internal/OrderControllerHelpersTest.php +267 -0
  400. package/server/tests/Feature/Http/Internal/OrderControllerImportFromFilesTest.php +179 -0
  401. package/server/tests/Feature/Http/Internal/OrderControllerUpstreamNotFoundTest.php +80 -0
  402. package/server/tests/Feature/Http/Internal/PaymentControllerPaymentsTest.php +154 -0
  403. package/server/tests/Feature/Http/Internal/PlaceControllerTest.php +252 -0
  404. package/server/tests/Feature/Http/Internal/PositionControllerReplayMetricsTest.php +163 -0
  405. package/server/tests/Feature/Http/Internal/ProofControllerContractsTest.php +219 -0
  406. package/server/tests/Feature/Http/Internal/SearchControllerEndpointTest.php +151 -0
  407. package/server/tests/Feature/Http/Internal/ServiceQuoteControllerHelpersTest.php +208 -0
  408. package/server/tests/Feature/Http/Internal/ServiceQuoteControllerQueryRecordTest.php +217 -0
  409. package/server/tests/Feature/Http/Internal/ServiceQuoteControllerVendorBridgeTest.php +239 -0
  410. package/server/tests/Feature/Http/Internal/ServiceQuotePreliminaryQueryTest.php +271 -0
  411. package/server/tests/Feature/Http/Internal/SettingControllerHelpersTest.php +133 -0
  412. package/server/tests/Feature/Http/Internal/SmallInternalControllersTest.php +180 -0
  413. package/server/tests/Feature/Http/Internal/TelematicControllerEndpointsTest.php +417 -0
  414. package/server/tests/Feature/Http/Internal/VehicleControllerEndpointsTest.php +361 -0
  415. package/server/tests/Feature/Http/Internal/VendorControllerEndpointsTest.php +203 -0
  416. package/server/tests/Feature/Http/Internal/WorkOrderAndConfigSurfacesTest.php +289 -0
  417. package/server/tests/Feature/Http/Internal/WorkOrderControllerContractsTest.php +199 -0
  418. package/server/tests/Feature/Http/TelematicWebhookIngestTest.php +343 -0
  419. package/server/tests/Feature/Http/Telematics/TelematicWebhookControllerProcessingTest.php +254 -0
  420. package/server/tests/FleetOpsSupportContractsTest.php +187 -0
  421. package/server/tests/FlespiProviderContractsTest.php +244 -0
  422. package/server/tests/FlowResourceTest.php +295 -0
  423. package/server/tests/FuelProviderConnectionControllerContractsTest.php +303 -0
  424. package/server/tests/FuelProviderImplementationTest.php +753 -0
  425. package/server/tests/FuelProviderResourceContractsTest.php +171 -0
  426. package/server/tests/FuelProviderTransactionControllerContractsTest.php +198 -0
  427. package/server/tests/GeofenceIntersectionServiceContractsTest.php +164 -0
  428. package/server/tests/HOSConstraintContractsTest.php +128 -0
  429. package/server/tests/HubAndGettingStartedContractsTest.php +158 -0
  430. package/server/tests/ImportContractsTest.php +191 -0
  431. package/server/tests/InternalCustomerControllerContractsTest.php +238 -0
  432. package/server/tests/InternalFleetControllerContractsTest.php +389 -0
  433. package/server/tests/InternalImportExportControllerContractsTest.php +289 -0
  434. package/server/tests/InternalMetricsControllerContractsTest.php +69 -0
  435. package/server/tests/InternalPlaceWorkOrderControllerContractsTest.php +207 -0
  436. package/server/tests/InternalServiceQuoteCheckoutControllerContractsTest.php +470 -0
  437. package/server/tests/InternalVendorControllerContractsTest.php +331 -0
  438. package/server/tests/InventoryTelemetryModelContractsTest.php +516 -0
  439. package/server/tests/IssueTimelineContractsTest.php +191 -0
  440. package/server/tests/LabelPdfRenderingTest.php +57 -0
  441. package/server/tests/LalamoveIntegrationContractsTest.php +167 -0
  442. package/server/tests/LiveOrderQueryTest.php +145 -18
  443. package/server/tests/LookupAndGeocoderControllerContractsTest.php +357 -0
  444. package/server/tests/MaintainableTraitContractsTest.php +245 -0
  445. package/server/tests/MaintenanceScheduleControllerContractsTest.php +101 -0
  446. package/server/tests/MaintenanceWarrantyContractsTest.php +237 -0
  447. package/server/tests/ManifestControllerContractsTest.php +310 -0
  448. package/server/tests/MetricsRegistryTest.php +596 -10
  449. package/server/tests/MiddlewareContractsTest.php +150 -0
  450. package/server/tests/ModelAccessorContractsTest.php +3201 -0
  451. package/server/tests/MorphControllerContractsTest.php +410 -0
  452. package/server/tests/NavigatorControllerContractsTest.php +206 -0
  453. package/server/tests/NotificationAndMailContractsTest.php +677 -0
  454. package/server/tests/ObserverContractsTest.php +1414 -0
  455. package/server/tests/OperationalAlgorithmContractsTest.php +852 -0
  456. package/server/tests/OperationsMonitorEndpointTest.php +2 -1
  457. package/server/tests/OrchestrationPayloadBuilderTest.php +87 -0
  458. package/server/tests/OrderActivityFlowRegressionTest.php +354 -7
  459. package/server/tests/OrderDispatchListenerContractsTest.php +577 -0
  460. package/server/tests/OrderFilterExecutionTest.php +244 -0
  461. package/server/tests/OrderQueuedClosureRegressionTest.php +2 -1
  462. package/server/tests/PaymentControllerContractsTest.php +199 -0
  463. package/server/tests/PointResolutionTest.php +54 -0
  464. package/server/tests/ProcessAllocationJobContractsTest.php +224 -0
  465. package/server/tests/ProofAndSensorControllerContractsTest.php +44 -0
  466. package/server/tests/ProviderContractsTest.php +409 -0
  467. package/server/tests/PublicApiControllerInputContractsTest.php +294 -0
  468. package/server/tests/QueueJobContractsTest.php +764 -0
  469. package/server/tests/ReportSchemaContractsTest.php +271 -0
  470. package/server/tests/RequestContractsTest.php +1058 -0
  471. package/server/tests/RouteRegistrationExecutionTest.php +178 -0
  472. package/server/tests/RouteSequencingEngineTest.php +179 -0
  473. package/server/tests/RulesAndCastsTest.php +246 -0
  474. package/server/tests/SamsaraProviderContractsTest.php +272 -0
  475. package/server/tests/SearchControllerContractsTest.php +311 -0
  476. package/server/tests/ServiceRateRouteValidationTest.php +76 -0
  477. package/server/tests/SettingControllerContractsTest.php +410 -0
  478. package/server/tests/SmallControllerContractsTest.php +480 -0
  479. package/server/tests/SupportAnalyticsCustomerAuthContractsTest.php +221 -0
  480. package/server/tests/SupportJobAndAiCoverageTest.php +812 -0
  481. package/server/tests/SupportServiceContractsTest.php +287 -0
  482. package/server/tests/SupportValueObjectsTest.php +155 -0
  483. package/server/tests/TelematicControllerContractsTest.php +185 -0
  484. package/server/tests/TelematicProviderRegistryTest.php +167 -0
  485. package/server/tests/TelematicServiceHelperContractsTest.php +315 -0
  486. package/server/tests/TelematicWebhookControllerContractsTest.php +253 -0
  487. package/server/tests/TelematicsHardeningTest.php +642 -86
  488. package/server/tests/TrackingIntelligenceTest.php +644 -1
  489. package/server/tests/TrackingNumberTraitContractsTest.php +106 -0
  490. package/server/tests/Unit/Casts/SpatialCastBranchesTest.php +75 -0
  491. package/server/tests/Unit/Console/AssignCustomerRolesCommandTest.php +102 -0
  492. package/server/tests/Unit/Console/AssignDriverRolesCommandTest.php +113 -0
  493. package/server/tests/Unit/Console/Commands/FixLegacyOrderConfigsHelpersTest.php +108 -0
  494. package/server/tests/Unit/Console/Commands/ProcessOperationalAlertsCommandTest.php +265 -0
  495. package/server/tests/Unit/Console/Commands/ReplayVehicleLocationsCommandTest.php +320 -0
  496. package/server/tests/Unit/Console/Commands/SimulateGeofenceEventsCommandTest.php +207 -0
  497. package/server/tests/Unit/Console/FixCommandsAndMaintenanceControllerTest.php +256 -0
  498. package/server/tests/Unit/Console/FleetOpsCommandsTest.php +198 -0
  499. package/server/tests/Unit/Console/ReplayVehicleLocationsCommandTest.php +252 -0
  500. package/server/tests/Unit/Console/SendMaintenanceRemindersTest.php +212 -0
  501. package/server/tests/Unit/Console/SimulateGeofenceEventsCommandTest.php +232 -0
  502. package/server/tests/Unit/Console/SyncTelematicsCommandTest.php +136 -0
  503. package/server/tests/Unit/Constraints/HOSConstraintTest.php +158 -0
  504. package/server/tests/Unit/Events/EventModelRecordTest.php +93 -0
  505. package/server/tests/Unit/Events/OrderDispatchFailedTest.php +34 -0
  506. package/server/tests/Unit/Exports/ExportCollectionsTest.php +142 -0
  507. package/server/tests/Unit/Exports/OperationalExportMappingTest.php +651 -0
  508. package/server/tests/Unit/Exports/VehicleExportTest.php +284 -0
  509. package/server/tests/Unit/Flow/EventFiringTest.php +95 -0
  510. package/server/tests/Unit/Http/Api/QueryWithRequestSeamsTest.php +198 -0
  511. package/server/tests/Unit/Http/Api/SensorInputTest.php +95 -0
  512. package/server/tests/Unit/Http/Filter/DeviceFilterTest.php +199 -0
  513. package/server/tests/Unit/Http/Filter/EmptyValueGuardsTest.php +66 -0
  514. package/server/tests/Unit/Http/Filter/FilterDateRangesTest.php +72 -0
  515. package/server/tests/Unit/Http/Filter/FuelProviderTransactionFilterTest.php +172 -0
  516. package/server/tests/Unit/Http/Filter/InternalRelationUuidLookupTest.php +135 -0
  517. package/server/tests/Unit/Http/Filter/IssueFilterTest.php +129 -0
  518. package/server/tests/Unit/Http/Filter/MaintenanceScheduleFilterTest.php +69 -0
  519. package/server/tests/Unit/Http/Filter/PartFilterTest.php +173 -0
  520. package/server/tests/Unit/Http/Internal/ControllerDelegationSeamsTest.php +136 -0
  521. package/server/tests/Unit/Http/Internal/ControllerExcelSeamsTest.php +89 -0
  522. package/server/tests/Unit/Http/Middleware/SetupDriverSessionTest.php +32 -0
  523. package/server/tests/Unit/Http/Requests/CreateFuelReportRequestTest.php +68 -0
  524. package/server/tests/Unit/Http/Requests/FleetActionRequestTest.php +80 -0
  525. package/server/tests/Unit/Http/Requests/RequestAuthorizationTest.php +50 -0
  526. package/server/tests/Unit/Http/Resources/CustomerResourceTest.php +108 -0
  527. package/server/tests/Unit/Http/Resources/EntityCustomerTypeTest.php +35 -0
  528. package/server/tests/Unit/Http/Resources/FleetResourceTest.php +102 -0
  529. package/server/tests/Unit/Http/Resources/IndexOrderResourceTest.php +210 -0
  530. package/server/tests/Unit/Http/Resources/IndexVehicleResourceTest.php +194 -0
  531. package/server/tests/Unit/Http/Resources/MaintenanceResourcesTest.php +182 -0
  532. package/server/tests/Unit/Http/Resources/OrderAndDriverResourceTest.php +121 -0
  533. package/server/tests/Unit/Http/Resources/OrderConfigResourceTest.php +47 -0
  534. package/server/tests/Unit/Http/Resources/PayloadResourceTest.php +111 -0
  535. package/server/tests/Unit/Http/Resources/RelationResourceFallbacksTest.php +32 -0
  536. package/server/tests/Unit/Http/Resources/ResourceRelationResolutionTest.php +55 -0
  537. package/server/tests/Unit/Http/Resources/TrackingNumberResourceTest.php +174 -0
  538. package/server/tests/Unit/Http/Resources/WaypointResourceTest.php +295 -0
  539. package/server/tests/Unit/Http/Resources/WorkOrderResourceTest.php +164 -0
  540. package/server/tests/Unit/Imports/ImportDelegationTest.php +151 -0
  541. package/server/tests/Unit/Integrations/Lalamove/LalamoveDeliveryStopTest.php +79 -0
  542. package/server/tests/Unit/Integrations/Lalamove/LalamoveLifecycleTest.php +211 -0
  543. package/server/tests/Unit/Integrations/Lalamove/LalamoveQuoteAndServiceOrderTest.php +381 -0
  544. package/server/tests/Unit/Integrations/Lalamove/LalamoveServiceTypeTest.php +51 -0
  545. package/server/tests/Unit/Integrations/LalamoveQuotationTest.php +194 -0
  546. package/server/tests/Unit/Integrations/LalamoveResponseHandlingTest.php +58 -0
  547. package/server/tests/Unit/Jobs/GeofenceDwellAndBulkNotifyTest.php +190 -0
  548. package/server/tests/Unit/Jobs/ReplayPositionsTest.php +57 -0
  549. package/server/tests/Unit/Jobs/SimulateWaypointReachedTest.php +92 -0
  550. package/server/tests/Unit/Listeners/HandleGeofenceEnteredTest.php +256 -0
  551. package/server/tests/Unit/Listeners/HandleOrderDispatchFailedListenerTest.php +101 -0
  552. package/server/tests/Unit/Listeners/HandleOrderDispatchedConcreteTest.php +203 -0
  553. package/server/tests/Unit/Listeners/HandleOrderDispatchedHelpersTest.php +186 -0
  554. package/server/tests/Unit/Listeners/HandleUserRemovedFromCompanyTest.php +65 -0
  555. package/server/tests/Unit/Listeners/ListenerDelegationSeamsTest.php +83 -0
  556. package/server/tests/Unit/Models/AssetTest.php +469 -0
  557. package/server/tests/Unit/Models/ContactCustomerUserTest.php +370 -0
  558. package/server/tests/Unit/Models/ContactTest.php +577 -0
  559. package/server/tests/Unit/Models/DeviceEventTest.php +481 -0
  560. package/server/tests/Unit/Models/DeviceLastPositionDefaultTest.php +128 -0
  561. package/server/tests/Unit/Models/DriverModelHelpersTest.php +268 -0
  562. package/server/tests/Unit/Models/DriverTest.php +401 -0
  563. package/server/tests/Unit/Models/EntityTest.php +171 -0
  564. package/server/tests/Unit/Models/EquipmentTest.php +434 -0
  565. package/server/tests/Unit/Models/FleetTest.php +153 -0
  566. package/server/tests/Unit/Models/FuelProviderTransactionTest.php +82 -0
  567. package/server/tests/Unit/Models/FuelReportImportAndLabelsTest.php +193 -0
  568. package/server/tests/Unit/Models/ImportRowFallbackSeamsTest.php +100 -0
  569. package/server/tests/Unit/Models/IntegratedVendorLifecycleTest.php +203 -0
  570. package/server/tests/Unit/Models/IntegratedVendorTest.php +135 -0
  571. package/server/tests/Unit/Models/IssueTest.php +160 -0
  572. package/server/tests/Unit/Models/MaintenanceScheduleTest.php +319 -0
  573. package/server/tests/Unit/Models/MaintenanceTest.php +277 -0
  574. package/server/tests/Unit/Models/MaintenanceWorkOrderImportTest.php +161 -0
  575. package/server/tests/Unit/Models/ManifestStopTest.php +121 -0
  576. package/server/tests/Unit/Models/ManifestTest.php +163 -0
  577. package/server/tests/Unit/Models/ModelLookupFallbackSeamsTest.php +149 -0
  578. package/server/tests/Unit/Models/OrderConfigTest.php +341 -0
  579. package/server/tests/Unit/Models/OrderDynamicContractsTest.php +190 -0
  580. package/server/tests/Unit/Models/OrderPayloadConfigAndDistanceTest.php +426 -0
  581. package/server/tests/Unit/Models/OrderPayloadRouteTest.php +227 -0
  582. package/server/tests/Unit/Models/OrderPurchaseAndDriversTest.php +188 -0
  583. package/server/tests/Unit/Models/OrderTest.php +917 -0
  584. package/server/tests/Unit/Models/PartTest.php +399 -0
  585. package/server/tests/Unit/Models/PayloadTest.php +710 -0
  586. package/server/tests/Unit/Models/PayloadWaypointsAndEntitiesTest.php +317 -0
  587. package/server/tests/Unit/Models/PlaceCreationAndImportTest.php +384 -0
  588. package/server/tests/Unit/Models/PlaceGeocodingResultsTest.php +253 -0
  589. package/server/tests/Unit/Models/PlaceSharedAndGeocodingTest.php +271 -0
  590. package/server/tests/Unit/Models/PlaceTest.php +589 -0
  591. package/server/tests/Unit/Models/PositionTest.php +49 -0
  592. package/server/tests/Unit/Models/RouteTest.php +55 -0
  593. package/server/tests/Unit/Models/SensorLastPositionDefaultTest.php +130 -0
  594. package/server/tests/Unit/Models/SensorReadingsTest.php +168 -0
  595. package/server/tests/Unit/Models/SensorTest.php +284 -0
  596. package/server/tests/Unit/Models/ServiceAreaGeometryTest.php +129 -0
  597. package/server/tests/Unit/Models/ServiceAreaTest.php +125 -0
  598. package/server/tests/Unit/Models/ServiceQuoteTest.php +617 -0
  599. package/server/tests/Unit/Models/ServiceRateFeeTest.php +73 -0
  600. package/server/tests/Unit/Models/ServiceRatePersistenceAndServicabilityTest.php +428 -0
  601. package/server/tests/Unit/Models/ServiceRateTest.php +533 -0
  602. package/server/tests/Unit/Models/SmallModelSurfacesTest.php +294 -0
  603. package/server/tests/Unit/Models/TrackingNumberTest.php +199 -0
  604. package/server/tests/Unit/Models/TrackingStatusTest.php +131 -0
  605. package/server/tests/Unit/Models/VehicleDeviceTest.php +115 -0
  606. package/server/tests/Unit/Models/VehiclePositionsAndImportTest.php +220 -0
  607. package/server/tests/Unit/Models/VehicleTest.php +266 -0
  608. package/server/tests/Unit/Models/VendorRelationsAndImportTest.php +107 -0
  609. package/server/tests/Unit/Models/WarrantyTest.php +187 -0
  610. package/server/tests/Unit/Models/WaypointTest.php +366 -0
  611. package/server/tests/Unit/Models/WorkOrderTest.php +272 -0
  612. package/server/tests/Unit/Models/ZoneTest.php +83 -0
  613. package/server/tests/Unit/Notifications/MonitoringNotificationsTest.php +136 -0
  614. package/server/tests/Unit/Notifications/OrderAssignedChannelsTest.php +53 -0
  615. package/server/tests/Unit/Notifications/OrderDispatchedChannelsTest.php +81 -0
  616. package/server/tests/Unit/Notifications/OrderFailedChannelsTest.php +73 -0
  617. package/server/tests/Unit/Notifications/OrderPingChannelsTest.php +69 -0
  618. package/server/tests/Unit/Notifications/TerminalOrderNotificationsTest.php +185 -0
  619. package/server/tests/Unit/Observers/FleetOpsCompanyUserAndServiceAreaObserversTest.php +133 -0
  620. package/server/tests/Unit/Observers/ObserverHelperExecutionTest.php +135 -0
  621. package/server/tests/Unit/Observers/ObserverListenerSeamsTest.php +267 -0
  622. package/server/tests/Unit/Observers/PurchaseRateObserverAndOrderJobsTest.php +169 -0
  623. package/server/tests/Unit/Orchestration/Engines/DriverAssignmentEngineTest.php +393 -0
  624. package/server/tests/Unit/Orchestration/Engines/VroomOrchestrationEngineLifecycleTest.php +397 -0
  625. package/server/tests/Unit/Orchestration/OrchestrationEngineRegistryTest.php +45 -0
  626. package/server/tests/Unit/Orchestration/VroomEngineTransportAndSettingsTest.php +253 -0
  627. package/server/tests/Unit/Providers/FleetOpsAiRegistrationTest.php +59 -0
  628. package/server/tests/Unit/Rules/ResolvableVehicleTest.php +85 -0
  629. package/server/tests/Unit/Support/Ai/AssetStatusCapabilityQueriesTest.php +120 -0
  630. package/server/tests/Unit/Support/Ai/Capabilities/CreateOrderPreviewCapabilityTest.php +385 -0
  631. package/server/tests/Unit/Support/Ai/Capabilities/OrderInsightsCapabilityTest.php +226 -0
  632. package/server/tests/Unit/Support/Ai/Capabilities/SearchResourcesCapabilityTest.php +237 -0
  633. package/server/tests/Unit/Support/AiCapabilityPermissionsTest.php +124 -0
  634. package/server/tests/Unit/Support/AlgoEdgeBranchesTest.php +24 -0
  635. package/server/tests/Unit/Support/Analytics/GeofenceViolationsTest.php +109 -0
  636. package/server/tests/Unit/Support/Analytics/LiveFleetTest.php +205 -0
  637. package/server/tests/Unit/Support/Analytics/MaintenanceOverviewTest.php +236 -0
  638. package/server/tests/Unit/Support/Analytics/OnTimeDeliveryAndTopDriversTest.php +250 -0
  639. package/server/tests/Unit/Support/CreateOrderPreviewDraftingTest.php +235 -0
  640. package/server/tests/Unit/Support/CustomerAuthTest.php +132 -0
  641. package/server/tests/Unit/Support/FuelEfficiencyAndCanceledHandlersTest.php +164 -0
  642. package/server/tests/Unit/Support/FuelProviderRegistryResolutionTest.php +51 -0
  643. package/server/tests/Unit/Support/FuelProviderServiceMatchingTest.php +280 -0
  644. package/server/tests/Unit/Support/GeocodingInjectedClientTest.php +268 -0
  645. package/server/tests/Unit/Support/GeocodingLocateTest.php +32 -0
  646. package/server/tests/Unit/Support/GeofenceIntersectionServiceTest.php +188 -0
  647. package/server/tests/Unit/Support/GettingStartedTest.php +164 -0
  648. package/server/tests/Unit/Support/GuardReturnSeamsTest.php +172 -0
  649. package/server/tests/Unit/Support/IntegratedVendorsResolverTest.php +250 -0
  650. package/server/tests/Unit/Support/IssuesInsightsAndAllocationJobTest.php +156 -0
  651. package/server/tests/Unit/Support/MagicAccessorSeamsTest.php +54 -0
  652. package/server/tests/Unit/Support/MaintainableAndOperationalAlertsTest.php +215 -0
  653. package/server/tests/Unit/Support/Metrics/AvgOrderValueMetricTest.php +308 -0
  654. package/server/tests/Unit/Support/Metrics/CountMetricsTest.php +280 -0
  655. package/server/tests/Unit/Support/Metrics/FuelCostsMetricTest.php +102 -0
  656. package/server/tests/Unit/Support/Metrics/MetricQuerySeamsTest.php +129 -0
  657. package/server/tests/Unit/Support/Metrics/OrdersScheduledMetricTest.php +146 -0
  658. package/server/tests/Unit/Support/MoreQuerySeamsTest.php +410 -0
  659. package/server/tests/Unit/Support/OperationalQueryDistributionTest.php +152 -0
  660. package/server/tests/Unit/Support/OperationsPulseTest.php +130 -0
  661. package/server/tests/Unit/Support/OptimizeOrderRouteCapabilityTest.php +147 -0
  662. package/server/tests/Unit/Support/OrchestrationPayloadBuilderTest.php +135 -0
  663. package/server/tests/Unit/Support/OrchestrationRouteAndVehicleTasksTest.php +254 -0
  664. package/server/tests/Unit/Support/OsrmProofAndIssueFilterTest.php +247 -0
  665. package/server/tests/Unit/Support/PetroAppFuelProviderTest.php +165 -0
  666. package/server/tests/Unit/Support/PlaceSearchRankingTest.php +191 -0
  667. package/server/tests/Unit/Support/QuerySeamsTest.php +309 -0
  668. package/server/tests/Unit/Support/ResolvesOrderServiceStopsDbTest.php +303 -0
  669. package/server/tests/Unit/Support/ResolvesOrderServiceStopsTest.php +382 -0
  670. package/server/tests/Unit/Support/SkipAndFallbackGuardsTest.php +70 -0
  671. package/server/tests/Unit/Support/TelematicCredentialResolutionTest.php +31 -0
  672. package/server/tests/Unit/Support/TelematicServiceTest.php +256 -0
  673. package/server/tests/Unit/Support/Telematics/Providers/AbstractProviderTest.php +154 -0
  674. package/server/tests/Unit/Support/Telematics/Providers/AfaqyProviderTest.php +191 -0
  675. package/server/tests/Unit/Support/Telematics/Providers/AfaqyProviderTransportTest.php +138 -0
  676. package/server/tests/Unit/Support/Telematics/Providers/GeotabProviderTest.php +329 -0
  677. package/server/tests/Unit/Support/Telematics/Providers/ProviderTransportSeamsTest.php +133 -0
  678. package/server/tests/Unit/Support/Telematics/Providers/SafeeProviderTest.php +487 -0
  679. package/server/tests/Unit/Support/Telematics/TelematicProviderRegistryTest.php +39 -0
  680. package/server/tests/Unit/Support/Telematics/TelematicServiceLifecycleTest.php +711 -0
  681. package/server/tests/Unit/Support/Telematics/TelematicServiceTelemetryTest.php +364 -0
  682. package/server/tests/Unit/Support/UtilsAdditionalTest.php +256 -0
  683. package/server/tests/Unit/Support/UtilsGeoMatrixAndVendorTest.php +382 -0
  684. package/server/tests/Unit/Tracking/TrackingContextTest.php +114 -0
  685. package/server/tests/Unit/Tracking/TrackingIntelligenceAndContextTest.php +477 -0
  686. package/server/tests/Unit/Tracking/TrackingProviderManagerFallbacksTest.php +208 -0
  687. package/server/tests/Unit/Traits/HasTrackingNumberTest.php +303 -0
  688. package/server/tests/Unit/Traits/PayloadAccessorsTest.php +150 -0
  689. package/server/tests/UtilsContractsTest.php +244 -0
  690. package/server/tests/VehicleControllerHelperContractsTest.php +488 -0
  691. package/server/tests/VehicleDataParsingTest.php +45 -0
  692. package/server/tests/VehicleResourceContractsTest.php +313 -0
  693. package/translations/bg-bg.yaml +2 -0
  694. package/translations/en-us.yaml +2 -0
  695. package/translations/es-pa.yaml +2 -0
  696. package/translations/fr-fr.yaml +2 -0
  697. package/translations/mn-mn.yaml +2 -0
  698. package/translations/pt-br.yaml +2 -0
  699. package/translations/ru-ru.yaml +2 -0
  700. package/server/tests/DeviceFilterTest.php +0 -44
  701. package/server/tests/LiveControllerViewportTest.php +0 -52
@@ -0,0 +1,256 @@
1
+ <?php
2
+
3
+ use Fleetbase\FleetOps\Models\Device;
4
+ use Fleetbase\FleetOps\Models\Sensor;
5
+ use Fleetbase\FleetOps\Models\Telematic;
6
+ use Fleetbase\FleetOps\Support\Telematics\TelematicProviderRegistry;
7
+ use Fleetbase\FleetOps\Support\Telematics\TelematicService;
8
+ use Illuminate\Database\ConnectionResolver;
9
+ use Illuminate\Database\Eloquent\Model as EloquentModel;
10
+ use Illuminate\Database\SQLiteConnection;
11
+ use Illuminate\Validation\ValidationException;
12
+
13
+ /**
14
+ * Covers the TelematicService persistence pipeline against SQLite: device
15
+ * linking with identity validation, device event storage with telemetry
16
+ * field mapping, sensor storage with identity fallbacks and default
17
+ * locations, device filtering, connection test recording, credential
18
+ * decryption fallbacks, payload device resolution, and webhook telematic
19
+ * resolution by integration id, account id, and device id.
20
+ */
21
+ function fleetopsTelematicServiceBoot(): SQLiteConnection
22
+ {
23
+ $pdo = new PDO('sqlite::memory:');
24
+ $pdo->sqliteCreateFunction('ST_PointFromText', fn ($wkt, $srid = 0, $axisOrder = null) => $wkt);
25
+ $pdo->sqliteCreateFunction('ST_GeomFromText', fn ($wkt, $srid = 0, $axisOrder = null) => $wkt);
26
+ $connection = new SQLiteConnection($pdo);
27
+ $resolver = new ConnectionResolver(['default' => $connection, 'mysql' => $connection]);
28
+ $resolver->setDefaultConnection('mysql');
29
+ EloquentModel::setConnectionResolver($resolver);
30
+ app()->instance('db', new class($connection) {
31
+ public function __construct(public SQLiteConnection $c)
32
+ {
33
+ }
34
+
35
+ public function connection($name = null): SQLiteConnection
36
+ {
37
+ return $this->c;
38
+ }
39
+
40
+ public function __call($method, $arguments)
41
+ {
42
+ return $this->c->{$method}(...$arguments);
43
+ }
44
+ });
45
+ Illuminate\Support\Facades\DB::clearResolvedInstance('db');
46
+
47
+ app()->instance('encrypter', new class {
48
+ public function encryptString($value)
49
+ {
50
+ return base64_encode((string) $value);
51
+ }
52
+
53
+ public function decryptString($value)
54
+ {
55
+ $decoded = base64_decode((string) $value, true);
56
+ if ($decoded === false) {
57
+ throw new RuntimeException('Unable to decrypt.');
58
+ }
59
+
60
+ return $decoded;
61
+ }
62
+
63
+ public function __call($method, $arguments)
64
+ {
65
+ return null;
66
+ }
67
+ });
68
+ Illuminate\Support\Facades\Crypt::clearResolvedInstance('encrypter');
69
+
70
+ $schema = $connection->getSchemaBuilder();
71
+ $tables = [
72
+ 'telematics' => ['uuid', 'public_id', 'company_uuid', 'provider', 'name', 'credentials', 'status', 'meta', '_key'],
73
+ 'devices' => ['uuid', 'public_id', 'company_uuid', 'telematic_uuid', 'device_id', 'internal_id', 'imei', 'name', 'status', 'online', 'location', 'meta', 'device_type', 'device_provider', 'last_seen_at', 'attachable_uuid', 'attachable_type', '_key', 'serial_number', 'model', 'manufacturer', 'connection_status', 'provider', 'last_position', 'last_online_at', 'type'],
74
+ 'device_events' => ['uuid', 'public_id', 'company_uuid', 'device_uuid', 'event_type', 'severity', 'message', 'provider', 'ident', 'code', 'state', 'reason', 'occurred_at', 'data', 'payload', 'meta', 'location', '_key', 'processed_at'],
75
+ 'sensors' => ['uuid', 'public_id', 'company_uuid', 'telematic_uuid', 'device_uuid', 'type', 'internal_id', 'name', 'unit', 'last_value', 'last_reading_at', 'status', 'meta', 'last_position', 'sensor_type', 'min_threshold', 'max_threshold'],
76
+ 'vehicles' => ['uuid', 'public_id', 'company_uuid', 'name', 'location', 'online', 'heading', 'speed', 'altitude', 'meta'],
77
+ 'positions' => ['uuid', 'public_id', 'company_uuid', 'subject_uuid', 'subject_type', 'coordinates', 'heading', 'speed', 'altitude', '_key'],
78
+ 'alerts' => ['uuid', 'public_id', 'company_uuid', 'type', 'severity', 'status', 'subject_type', 'subject_uuid', 'message', 'context', 'triggered_at', 'resolved_at'],
79
+ ];
80
+ foreach ($tables as $table => $columns) {
81
+ $schema->create($table, function ($blueprint) use ($columns) {
82
+ $blueprint->increments('id');
83
+ foreach ($columns as $column) {
84
+ $blueprint->string($column)->nullable();
85
+ }
86
+ $blueprint->timestamps();
87
+ $blueprint->timestamp('deleted_at')->nullable();
88
+ });
89
+ }
90
+
91
+ session(['company' => 'company-1']);
92
+
93
+ return $connection;
94
+ }
95
+
96
+ function fleetopsTelematicServiceTelematic(): Telematic
97
+ {
98
+ $telematic = new Telematic();
99
+ $telematic->setRawAttributes([
100
+ 'uuid' => 'tm-1',
101
+ 'public_id' => 'telematic_test',
102
+ 'company_uuid' => 'company-1',
103
+ 'provider' => 'traccar',
104
+ 'name' => 'Traccar Server',
105
+ ], true);
106
+ $telematic->exists = true;
107
+
108
+ return $telematic;
109
+ }
110
+
111
+ function fleetopsTelematicService(): TelematicService
112
+ {
113
+ return new TelematicService(new TelematicProviderRegistry());
114
+ }
115
+
116
+ test('link device validates identity and reconciles telemetry', function () {
117
+ $connection = fleetopsTelematicServiceBoot();
118
+ $service = fleetopsTelematicService();
119
+ $telematic = fleetopsTelematicServiceTelematic();
120
+
121
+ expect(fn () => $service->linkDevice($telematic, []))->toThrow(ValidationException::class);
122
+
123
+ $device = $service->linkDevice($telematic, [
124
+ 'device_id' => 'unit-9',
125
+ 'name' => 'Tracker Nine',
126
+ 'online' => true,
127
+ ]);
128
+
129
+ expect($device)->toBeInstanceOf(Device::class)
130
+ ->and($connection->table('devices')->count())->toBe(1)
131
+ ->and($connection->table('devices')->value('device_id'))->toBe('unit-9');
132
+
133
+ // Linking the same external id updates rather than duplicates
134
+ $service->linkDevice($telematic, ['device_id' => 'unit-9', 'name' => 'Tracker Nine Renamed']);
135
+ expect($connection->table('devices')->count())->toBe(1);
136
+ });
137
+
138
+ test('store device event maps telemetry fields and links the device', function () {
139
+ $connection = fleetopsTelematicServiceBoot();
140
+ $service = fleetopsTelematicService();
141
+ $telematic = fleetopsTelematicServiceTelematic();
142
+
143
+ $device = $service->linkDevice($telematic, ['device_id' => 'unit-9']);
144
+
145
+ $event = $service->storeDeviceEvent($telematic, [
146
+ 'event_type' => 'position_update',
147
+ 'severity' => 'info',
148
+ 'event_id' => 'evt-1',
149
+ 'speed' => 42,
150
+ 'heading' => 180,
151
+ 'ignition' => true,
152
+ 'occurred_at' => '2026-07-28 08:00:00',
153
+ 'location' => ['latitude' => 1, 'longitude' => 2],
154
+ ], $device);
155
+
156
+ expect($event->exists)->toBeTrue()
157
+ ->and($connection->table('device_events')->count())->toBe(1)
158
+ ->and($event->event_type)->toBe('position_update')
159
+ ->and($event->ident)->toBe('evt-1');
160
+
161
+ // Payload-resolved devices attach without an explicit device
162
+ $second = $service->storeDeviceEvent($telematic, ['device_id' => 'unit-9', 'event_type' => 'ignition_on', 'reason' => 'ignition']);
163
+ expect($second->device_uuid)->toBe($device->uuid);
164
+ });
165
+
166
+ test('store sensor validates identity applies defaults and updates', function () {
167
+ $connection = fleetopsTelematicServiceBoot();
168
+ $service = fleetopsTelematicService();
169
+ $telematic = fleetopsTelematicServiceTelematic();
170
+
171
+ expect(fn () => $service->storeSensor($telematic, []))->toThrow(ValidationException::class);
172
+
173
+ $sensor = $service->storeSensor($telematic, [
174
+ 'sensor_id' => 'sensor-9',
175
+ 'type' => 'temperature',
176
+ 'name' => 'Cold Chain',
177
+ 'unit' => 'C',
178
+ 'value' => 4.5,
179
+ ]);
180
+
181
+ expect($sensor)->toBeInstanceOf(Sensor::class)
182
+ ->and($connection->table('sensors')->count())->toBe(1)
183
+ ->and($connection->table('sensors')->value('last_value'))->toBe('4.5');
184
+
185
+ // Device-linked sensors resolve identity from the device
186
+ $device = $service->linkDevice($telematic, ['device_id' => 'unit-9']);
187
+ $linked = $service->storeSensor($telematic, ['type' => 'fuel'], $device);
188
+ expect($linked->device_uuid)->toBe($device->uuid);
189
+
190
+ // A reading carrying coordinates keeps them instead of the (0, 0) default
191
+ $located = $service->storeSensor($telematic, [
192
+ 'sensor_id' => 'sensor-10',
193
+ 'type' => 'gps',
194
+ 'location' => ['lat' => '1.29', 'lng' => '103.85'],
195
+ ]);
196
+ expect($located->last_position->getLat())->toBe(1.29)
197
+ ->and($located->last_position->getLng())->toBe(103.85);
198
+ });
199
+
200
+ test('get devices filters by status and search terms', function () {
201
+ $connection = fleetopsTelematicServiceBoot();
202
+ $service = fleetopsTelematicService();
203
+ $telematic = fleetopsTelematicServiceTelematic();
204
+
205
+ $connection->table('devices')->insert([
206
+ ['uuid' => 'device-1', 'telematic_uuid' => 'tm-1', 'device_id' => 'unit-1', 'name' => 'Alpha Tracker', 'status' => 'active'],
207
+ ['uuid' => 'device-2', 'telematic_uuid' => 'tm-1', 'device_id' => 'unit-2', 'name' => 'Beta Tracker', 'status' => 'disabled'],
208
+ ]);
209
+
210
+ expect($service->getDevices($telematic))->toHaveCount(2)
211
+ ->and($service->getDevices($telematic, ['status' => 'active']))->toHaveCount(1)
212
+ ->and($service->getDevices($telematic, ['search' => 'Beta']))->toHaveCount(1)
213
+ ->and($service->getDevices($telematic, ['search' => 'unit-1']))->toHaveCount(1);
214
+ });
215
+
216
+ test('connection tests and credentials round trip through the service', function () {
217
+ $connection = fleetopsTelematicServiceBoot();
218
+ $service = fleetopsTelematicService();
219
+ $connection->table('telematics')->insert(['uuid' => 'tm-1', 'public_id' => 'telematic_test', 'company_uuid' => 'company-1', 'provider' => 'traccar']);
220
+ $telematic = Telematic::where('uuid', 'tm-1')->withoutGlobalScopes()->first();
221
+
222
+ $service->recordConnectionTest($telematic, ['success' => true, 'metadata' => ['latency' => 20]]);
223
+ expect($connection->table('telematics')->value('status'))->toBe('connected');
224
+
225
+ $service->recordConnectionTest($telematic, ['success' => false, 'message' => 'refused']);
226
+ expect($connection->table('telematics')->value('status'))->toBe('error');
227
+
228
+ // Array credentials pass through; json strings fall back after failed
229
+ // decryption; empty credentials return an empty array
230
+ $telematic->credentials = null;
231
+ expect($service->getCredentials($telematic))->toBe([]);
232
+
233
+ $plain = fleetopsTelematicServiceTelematic();
234
+ $plain->credentials = json_encode(['token' => 'abc']);
235
+ expect($service->getCredentials($plain))->toBe(['token' => 'abc']);
236
+ });
237
+
238
+ test('webhook telematics resolve by integration account and device ids', function () {
239
+ $connection = fleetopsTelematicServiceBoot();
240
+ $service = fleetopsTelematicService();
241
+
242
+ $connection->table('telematics')->insert([
243
+ ['uuid' => 'tm-1', 'public_id' => 'telematic_hook', 'company_uuid' => 'company-1', 'provider' => 'traccar', 'meta' => json_encode(['provider_account_id' => 'acct-1'])],
244
+ ['uuid' => 'tm-2', 'public_id' => 'telematic_other', 'company_uuid' => 'company-1', 'provider' => 'traccar', 'meta' => json_encode([])],
245
+ ]);
246
+ $connection->table('devices')->insert(['uuid' => 'device-1', 'telematic_uuid' => 'tm-2', 'device_id' => 'unit-77']);
247
+
248
+ // Integration id wins outright
249
+ expect($service->resolveWebhookTelematic('traccar', [], [], 'telematic_hook')?->uuid)->toBe('tm-1')
250
+ // Account id metadata matches a single telematic
251
+ ->and($service->resolveWebhookTelematic('traccar', ['account_id' => 'acct-1'])?->uuid)->toBe('tm-1')
252
+ // Device identity resolves through the device relation
253
+ ->and($service->resolveWebhookTelematic('traccar', ['device_id' => 'unit-77'])?->uuid)->toBe('tm-2')
254
+ // Nothing matches
255
+ ->and($service->resolveWebhookTelematic('traccar', ['device_id' => 'unit-none']))->toBeNull();
256
+ });
@@ -0,0 +1,154 @@
1
+ <?php
2
+
3
+ use Fleetbase\FleetOps\Exceptions\TelematicRateLimitExceededException;
4
+ use Fleetbase\FleetOps\Models\Telematic;
5
+ use Fleetbase\FleetOps\Support\Telematics\Providers\AbstractProvider;
6
+ use Illuminate\Cache\ArrayStore;
7
+ use Illuminate\Cache\Repository;
8
+ use Illuminate\Http\Client\Factory as HttpFactory;
9
+ use Illuminate\Support\Facades\Cache;
10
+ use Illuminate\Support\Facades\Http;
11
+
12
+ class FleetOpsAbstractTelematicProviderProbe extends AbstractProvider
13
+ {
14
+ public function __construct()
15
+ {
16
+ $this->baseUrl = 'https://provider.test';
17
+ $this->headers = ['Authorization' => 'Bearer test-token'];
18
+ }
19
+
20
+ public function requestForTest(string $method, string $endpoint, array $data = []): array
21
+ {
22
+ return $this->request($method, $endpoint, $data);
23
+ }
24
+
25
+ public function recordRequestForTest(): void
26
+ {
27
+ $this->recordRequest();
28
+ }
29
+
30
+ public function rateLimitKeyForTest(): string
31
+ {
32
+ return $this->rateLimitKey();
33
+ }
34
+
35
+ public function testConnection(array $credentials): array
36
+ {
37
+ return ['success' => true, 'message' => 'ok', 'metadata' => $credentials];
38
+ }
39
+
40
+ public function fetchDevices(array $options = []): array
41
+ {
42
+ return ['devices' => [], 'next_cursor' => null, 'has_more' => false];
43
+ }
44
+
45
+ public function fetchDeviceDetails(string $externalId): array
46
+ {
47
+ return ['external_id' => $externalId];
48
+ }
49
+
50
+ public function normalizeDevice(array $payload): array
51
+ {
52
+ return $payload;
53
+ }
54
+
55
+ public function normalizeEvent(array $payload): array
56
+ {
57
+ return $payload;
58
+ }
59
+
60
+ public function normalizeSensor(array $payload): array
61
+ {
62
+ return $payload;
63
+ }
64
+
65
+ protected function prepareAuthentication(): void
66
+ {
67
+ }
68
+ }
69
+
70
+ function fleetopsAbstractProviderUseArrayCache(): void
71
+ {
72
+ Cache::swap(new Repository(new ArrayStore()));
73
+ }
74
+
75
+ function fleetopsAbstractProviderTelematic(): Telematic
76
+ {
77
+ $telematic = new Telematic();
78
+ $telematic->setRawAttributes([
79
+ 'uuid' => 'telematic-provider',
80
+ 'credentials' => ['token' => 'array-token'],
81
+ ], true);
82
+
83
+ return $telematic;
84
+ }
85
+
86
+ test('abstract provider makes authenticated requests and refills rate tokens', function () {
87
+ fleetopsAbstractProviderUseArrayCache();
88
+
89
+ $requests = [];
90
+ Http::fake(function ($request) use (&$requests) {
91
+ $requests[] = [
92
+ 'method' => $request->method(),
93
+ 'url' => (string) $request->url(),
94
+ 'authorization' => $request->header('Authorization'),
95
+ 'data' => $request->data(),
96
+ ];
97
+
98
+ return Http::response(['ok' => true, 'devices' => [['id' => 'device-1']]], 200);
99
+ });
100
+
101
+ $provider = new FleetOpsAbstractTelematicProviderProbe();
102
+ $provider->connect(fleetopsAbstractProviderTelematic());
103
+
104
+ $result = $provider->requestForTest('POST', '/devices', ['limit' => 10]);
105
+
106
+ expect($result)->toBe(['ok' => true, 'devices' => [['id' => 'device-1']]])
107
+ ->and($requests)->toBe([
108
+ [
109
+ 'method' => 'POST',
110
+ 'url' => 'https://provider.test/devices',
111
+ 'authorization' => ['Bearer test-token'],
112
+ 'data' => ['limit' => 10],
113
+ ],
114
+ ])
115
+ ->and(Cache::get($provider->rateLimitKeyForTest()))->toBe(10);
116
+ });
117
+
118
+ test('abstract provider rejects exhausted rate limit buckets and failed responses', function () {
119
+ fleetopsAbstractProviderUseArrayCache();
120
+
121
+ $provider = new FleetOpsAbstractTelematicProviderProbe();
122
+ $provider->connect(fleetopsAbstractProviderTelematic());
123
+ Cache::put($provider->rateLimitKeyForTest(), 0, 60);
124
+
125
+ expect(fn () => $provider->requestForTest('GET', '/blocked'))
126
+ ->toThrow(TelematicRateLimitExceededException::class, 'Rate limit exceeded for provider');
127
+
128
+ fleetopsAbstractProviderUseArrayCache();
129
+ Http::swap(new HttpFactory());
130
+ Http::fake(fn () => Http::response(['error' => true], 503));
131
+
132
+ $provider = new FleetOpsAbstractTelematicProviderProbe();
133
+ $provider->connect(fleetopsAbstractProviderTelematic());
134
+
135
+ expect(fn () => $provider->requestForTest('GET', '/failure'))
136
+ ->toThrow(Exception::class, 'Provider API request failed with status 503');
137
+ });
138
+
139
+ test('abstract provider caps gradual rate limit refill at burst size', function () {
140
+ fleetopsAbstractProviderUseArrayCache();
141
+
142
+ $provider = new FleetOpsAbstractTelematicProviderProbe();
143
+ $provider->connect(fleetopsAbstractProviderTelematic());
144
+
145
+ Cache::put($provider->rateLimitKeyForTest(), 7, 60);
146
+ $provider->recordRequestForTest();
147
+
148
+ expect(Cache::get($provider->rateLimitKeyForTest()))->toBe(8);
149
+
150
+ Cache::put($provider->rateLimitKeyForTest(), 10, 60);
151
+ $provider->recordRequestForTest();
152
+
153
+ expect(Cache::get($provider->rateLimitKeyForTest()))->toBe(10);
154
+ });
@@ -0,0 +1,191 @@
1
+ <?php
2
+
3
+ use Fleetbase\FleetOps\Support\Telematics\Providers\AfaqyProvider;
4
+
5
+ class FleetOpsAfaqyProviderUnitProbe extends AfaqyProvider
6
+ {
7
+ public array $postCalls = [];
8
+ public array $responses = [];
9
+ public ?Throwable $postException = null;
10
+ public ?string $authToken = 'authenticated-token';
11
+ public int $authentications = 0;
12
+
13
+ public function setCredentialsForTest(array $credentials): void
14
+ {
15
+ $this->credentials = $credentials;
16
+ }
17
+
18
+ public function credentialsForTest(): array
19
+ {
20
+ return $this->credentials;
21
+ }
22
+
23
+ public function headersForTest(): array
24
+ {
25
+ return $this->headers;
26
+ }
27
+
28
+ public function baseUrlForTest(): string
29
+ {
30
+ return $this->baseUrl;
31
+ }
32
+
33
+ public function prepareAuthenticationForTest(): void
34
+ {
35
+ $this->prepareAuthentication();
36
+ }
37
+
38
+ public function queuePostResponse(array $response): void
39
+ {
40
+ $this->responses[] = $response;
41
+ }
42
+
43
+ protected function authenticate(): string
44
+ {
45
+ $this->authentications++;
46
+
47
+ if (!$this->authToken) {
48
+ throw new InvalidArgumentException('AFAQY username/password or token is required.');
49
+ }
50
+
51
+ return $this->authToken;
52
+ }
53
+
54
+ protected function afaqyPost(string $endpoint, array $payload = [], bool $tokenInQuery = false, ?int $timeout = null, ?int $connectTimeout = null): array
55
+ {
56
+ $this->postCalls[] = [$endpoint, $payload, $tokenInQuery, $timeout, $connectTimeout];
57
+
58
+ if ($this->postException) {
59
+ throw $this->postException;
60
+ }
61
+
62
+ return array_shift($this->responses) ?? [];
63
+ }
64
+ }
65
+
66
+ function fleetopsAfaqyProviderUnit(array $credentials = []): FleetOpsAfaqyProviderUnitProbe
67
+ {
68
+ $provider = new FleetOpsAfaqyProviderUnitProbe();
69
+ $provider->setCredentialsForTest($credentials);
70
+
71
+ return $provider;
72
+ }
73
+
74
+ test('afaqy provider prepares token authentication and custom base urls', function () {
75
+ $staticToken = fleetopsAfaqyProviderUnit([
76
+ 'base_url' => 'https://afaqy.example.test/',
77
+ 'token' => 'static-token',
78
+ ]);
79
+ $staticToken->prepareAuthenticationForTest();
80
+
81
+ expect($staticToken->baseUrlForTest())->toBe('https://afaqy.example.test')
82
+ ->and($staticToken->credentialsForTest()['token'])->toBe('static-token')
83
+ ->and($staticToken->headersForTest())->toBe([
84
+ 'Accept' => 'application/json',
85
+ 'Content-Type' => 'application/json',
86
+ 'Authorization' => 'Bearer static-token',
87
+ ])
88
+ ->and($staticToken->authentications)->toBe(0);
89
+
90
+ $refreshable = fleetopsAfaqyProviderUnit([
91
+ 'username' => 'unit-user',
92
+ 'password' => 'unit-secret',
93
+ ]);
94
+ $refreshable->prepareAuthenticationForTest();
95
+
96
+ expect($refreshable->credentialsForTest()['token'])->toBe('authenticated-token')
97
+ ->and($refreshable->authentications)->toBe(1);
98
+
99
+ expect(fn () => fleetopsAfaqyProviderUnit()->prepareAuthenticationForTest())
100
+ ->toThrow(InvalidArgumentException::class, 'AFAQY username/password or token is required.');
101
+ });
102
+
103
+ test('afaqy provider tests connections with timeout settings and failure metadata', function () {
104
+ $success = fleetopsAfaqyProviderUnit(['token' => 'static-token']);
105
+ $success->queuePostResponse([
106
+ 'data' => [['id' => 'unit-1'], ['id' => 'unit-2']],
107
+ 'status_code' => 200,
108
+ ]);
109
+
110
+ expect($success->testConnection(['token' => 'static-token']))->toBe([
111
+ 'success' => true,
112
+ 'message' => 'Connection successful',
113
+ 'metadata' => [
114
+ 'units_count' => 2,
115
+ 'status_code' => 200,
116
+ ],
117
+ ])
118
+ ->and($success->postCalls)->toHaveCount(1)
119
+ ->and($success->postCalls[0][0])->toBe('/units/lists')
120
+ ->and($success->postCalls[0][2])->toBeTrue()
121
+ ->and($success->postCalls[0][3])->toBe(30)
122
+ ->and($success->postCalls[0][4])->toBe(10);
123
+
124
+ $failure = fleetopsAfaqyProviderUnit();
125
+ $failure->postException = new RuntimeException('provider unavailable');
126
+
127
+ expect($failure->testConnection(['token' => 'static-token']))->toBe([
128
+ 'success' => false,
129
+ 'message' => 'provider unavailable',
130
+ 'metadata' => [],
131
+ ]);
132
+ });
133
+
134
+ test('afaqy provider fetches paginated devices details and credential schema', function () {
135
+ $provider = fleetopsAfaqyProviderUnit(['token' => 'static-token']);
136
+ $provider->queuePostResponse([
137
+ 'data' => [
138
+ ['_id' => 'unit-1', 'name' => 'Unit 1'],
139
+ ['_id' => 'unit-2', 'name' => 'Unit 2'],
140
+ ],
141
+ 'pagination' => [
142
+ 'offset' => 10,
143
+ 'limit' => 2,
144
+ 'resultCount' => 2,
145
+ 'filtersCount' => 20,
146
+ 'allCount' => 30,
147
+ ],
148
+ ]);
149
+ $provider->queuePostResponse([
150
+ 'data' => ['_id' => 'unit-1', 'name' => 'Unit 1'],
151
+ ]);
152
+
153
+ $devices = $provider->fetchDevices([
154
+ 'limit' => 1000,
155
+ 'cursor' => 10,
156
+ 'filters' => [],
157
+ 'address' => true,
158
+ ]);
159
+ $details = $provider->fetchDeviceDetails('unit-1');
160
+
161
+ expect($devices)->toMatchArray([
162
+ 'devices' => [
163
+ ['_id' => 'unit-1', 'name' => 'Unit 1'],
164
+ ['_id' => 'unit-2', 'name' => 'Unit 2'],
165
+ ],
166
+ 'next_cursor' => 12,
167
+ 'has_more' => true,
168
+ 'pagination' => [
169
+ 'allCount' => 30,
170
+ 'filtersCount' => 20,
171
+ 'resultCount' => 2,
172
+ 'offset' => 10,
173
+ 'limit' => 2,
174
+ ],
175
+ ])
176
+ ->and($details)->toBe(['_id' => 'unit-1', 'name' => 'Unit 1'])
177
+ ->and($provider->postCalls[0][0])->toBe('/units/lists')
178
+ ->and($provider->postCalls[0][1]['data']['limit'])->toBe(500)
179
+ ->and($provider->postCalls[0][1]['data']['offset'])->toBe(10)
180
+ ->and($provider->postCalls[0][1]['data']['filters'])->toBeInstanceOf(stdClass::class)
181
+ ->and($provider->postCalls[0][1]['data']['address'])->toBeTrue()
182
+ ->and($provider->postCalls[0][2])->toBeTrue()
183
+ ->and($provider->postCalls[1])->toBe(['/units/view', ['data' => ['id' => 'unit-1']], false, null, null]);
184
+
185
+ $schema = $provider->getCredentialSchema();
186
+
187
+ expect(array_column($schema, 'name'))->toBe(['base_url', 'username', 'password', 'token'])
188
+ ->and($schema[0]['default_value'])->toBe('https://api.afaqy.sa')
189
+ ->and($schema[1]['validation'])->toBe('required_without:token|string')
190
+ ->and($schema[3]['validation'])->toBe('required_without:username|string');
191
+ });