@fleetbase/fleetops-engine 0.6.58 → 0.6.60

package/server/src/Support/Analytics/TopDrivers.php

@@ -4,6 +4,7 @@ namespace Fleetbase\FleetOps\Support\Analytics;
 
 use Fleetbase\FleetOps\Models\Driver;
 use Fleetbase\FleetOps\Models\Order;
+use Fleetbase\FleetOps\Support\Utils;
 use Illuminate\Support\Carbon;
 
 /**
@@ -42,7 +43,7 @@ class TopDrivers extends AbstractAnalytics
                 WHEN SUM(CASE WHEN orders.scheduled_at IS NOT NULL THEN 1 ELSE 0 END) > 0
                 THEN SUM(CASE
                     WHEN orders.scheduled_at IS NOT NULL
-                     AND TIMESTAMPDIFF(SECOND, orders.scheduled_at, orders.updated_at) <= 1800
+                     AND ' . Utils::sqlSecondsDiff('orders.scheduled_at', 'orders.updated_at') . ' <= 1800
                     THEN 1 ELSE 0 END)
                     / SUM(CASE WHEN orders.scheduled_at IS NOT NULL THEN 1 ELSE 0 END)
                 ELSE -1
@@ -68,7 +69,7 @@ class TopDrivers extends AbstractAnalytics
                 COALESCE(SUM(orders.distance), 0) as distance_m,
                 SUM(CASE
                     WHEN orders.scheduled_at IS NOT NULL
-                     AND TIMESTAMPDIFF(SECOND, orders.scheduled_at, orders.updated_at) <= 1800
+                     AND ' . Utils::sqlSecondsDiff('orders.scheduled_at', 'orders.updated_at') . ' <= 1800
                     THEN 1 ELSE 0 END) as on_time_count,
                 SUM(CASE WHEN orders.scheduled_at IS NOT NULL THEN 1 ELSE 0 END) as scheduled_count
             ')

package/server/src/Support/FleetOps.php

@@ -28,110 +28,115 @@ class FleetOps
                 'key'          => 'transport',
                 'namespace'    => 'system:order-config:transport',
             ],
-            [
-                'name'         => 'Transport',
-                'key'          => 'transport',
-                'namespace'    => 'system:order-config:transport',
-                'description'  => 'Default order configuration for transport',
-                'core_service' => 1,
-                'status'       => 'private',
-                'version'      => '0.0.1',
-                'tags'         => ['transport', 'delivery'],
-                'entities'     => [],
-                'meta'         => [],
-                'flow'         => [
-                    'created' => [
-                        'key'         => 'created',
-                        'code'        => 'created',
-                        'color'       => '#1f2937',
-                        'logic'       => [],
-                        'events'      => [],
-                        'status'      => 'Order Created',
-                        'actions'     => [],
-                        'details'     => 'New order was created.',
-                        'options'     => [],
-                        'complete'    => false,
-                        'entities'    => [],
-                        'sequence'    => 0,
-                        'activities'  => ['dispatched'],
-                        'internalId'  => Str::uuid(),
-                        'pod_method'  => 'scan',
-                        'require_pod' => false,
-                    ],
-                    'enroute' => [
-                        'key'         => 'enroute',
-                        'code'        => 'enroute',
-                        'color'       => '#1f2937',
-                        'logic'       => [],
-                        'events'      => [],
-                        'status'      => 'Driver Enroute',
-                        'actions'     => [],
-                        'details'     => 'Driver is en-route.',
-                        'options'     => [],
-                        'complete'    => false,
-                        'entities'    => [],
-                        'sequence'    => 0,
-                        'activities'  => ['completed'],
-                        'internalId'  => Str::uuid(),
-                        'pod_method'  => 'scan',
-                        'require_pod' => false,
-                    ],
-                    'started' => [
-                        'key'         => 'started',
-                        'code'        => 'started',
-                        'color'       => '#1f2937',
-                        'logic'       => [],
-                        'events'      => [],
-                        'status'      => 'Order Started',
-                        'actions'     => [],
-                        'details'     => 'Order has been started',
-                        'options'     => [],
-                        'complete'    => false,
-                        'entities'    => [],
-                        'sequence'    => 0,
-                        'activities'  => ['enroute'],
-                        'internalId'  => Str::uuid(),
-                        'pod_method'  => 'scan',
-                        'require_pod' => false,
-                    ],
-                    'completed' => [
-                        'key'         => 'completed',
-                        'code'        => 'completed',
-                        'color'       => '#1f2937',
-                        'logic'       => [],
-                        'events'      => [],
-                        'status'      => 'Order Completed',
-                        'actions'     => [],
-                        'details'     => 'Order has been completed.',
-                        'options'     => [],
-                        'complete'    => true,
-                        'entities'    => [],
-                        'sequence'    => 0,
-                        'activities'  => [],
-                        'internalId'  => Str::uuid(),
-                        'pod_method'  => 'scan',
-                        'require_pod' => false,
-                    ],
-                    'dispatched' => [
-                        'key'         => 'dispatched',
-                        'code'        => 'dispatched',
-                        'color'       => '#1f2937',
-                        'logic'       => [],
-                        'events'      => [],
-                        'status'      => 'Order Dispatched',
-                        'actions'     => [],
-                        'details'     => 'Order has been dispatched.',
-                        'options'     => [],
-                        'complete'    => false,
-                        'entities'    => [],
-                        'sequence'    => 0,
-                        'activities'  => ['started'],
-                        'internalId'  => Str::uuid(),
-                        'pod_method'  => 'scan',
-                        'require_pod' => false,
-                    ],
-                ],
-            ]
+            static::transportConfigDefaults()
         );
     }
+
+    private static function transportConfigDefaults(): array
+    {
+        return [
+            'name'         => 'Transport',
+            'key'          => 'transport',
+            'namespace'    => 'system:order-config:transport',
+            'description'  => 'Default order configuration for transport',
+            'core_service' => 1,
+            'status'       => 'private',
+            'version'      => '0.0.1',
+            'tags'         => ['transport', 'delivery'],
+            'entities'     => [],
+            'meta'         => [],
+            'flow'         => [
+                'created' => [
+                    'key'         => 'created',
+                    'code'        => 'created',
+                    'color'       => '#1f2937',
+                    'logic'       => [],
+                    'events'      => [],
+                    'status'      => 'Order Created',
+                    'actions'     => [],
+                    'details'     => 'New order was created.',
+                    'options'     => [],
+                    'complete'    => false,
+                    'entities'    => [],
+                    'sequence'    => 0,
+                    'activities'  => ['dispatched'],
+                    'internalId'  => Str::uuid(),
+                    'pod_method'  => 'scan',
+                    'require_pod' => false,
+                ],
+                'enroute' => [
+                    'key'         => 'enroute',
+                    'code'        => 'enroute',
+                    'color'       => '#1f2937',
+                    'logic'       => [],
+                    'events'      => [],
+                    'status'      => 'Driver Enroute',
+                    'actions'     => [],
+                    'details'     => 'Driver is en-route.',
+                    'options'     => [],
+                    'complete'    => false,
+                    'entities'    => [],
+                    'sequence'    => 0,
+                    'activities'  => ['completed'],
+                    'internalId'  => Str::uuid(),
+                    'pod_method'  => 'scan',
+                    'require_pod' => false,
+                ],
+                'started' => [
+                    'key'         => 'started',
+                    'code'        => 'started',
+                    'color'       => '#1f2937',
+                    'logic'       => [],
+                    'events'      => [],
+                    'status'      => 'Order Started',
+                    'actions'     => [],
+                    'details'     => 'Order has been started',
+                    'options'     => [],
+                    'complete'    => false,
+                    'entities'    => [],
+                    'sequence'    => 0,
+                    'activities'  => ['enroute'],
+                    'internalId'  => Str::uuid(),
+                    'pod_method'  => 'scan',
+                    'require_pod' => false,
+                ],
+                'completed' => [
+                    'key'         => 'completed',
+                    'code'        => 'completed',
+                    'color'       => '#1f2937',
+                    'logic'       => [],
+                    'events'      => [],
+                    'status'      => 'Order Completed',
+                    'actions'     => [],
+                    'details'     => 'Order has been completed.',
+                    'options'     => [],
+                    'complete'    => true,
+                    'entities'    => [],
+                    'sequence'    => 0,
+                    'activities'  => [],
+                    'internalId'  => Str::uuid(),
+                    'pod_method'  => 'scan',
+                    'require_pod' => false,
+                ],
+                'dispatched' => [
+                    'key'         => 'dispatched',
+                    'code'        => 'dispatched',
+                    'color'       => '#1f2937',
+                    'logic'       => [],
+                    'events'      => [],
+                    'status'      => 'Order Dispatched',
+                    'actions'     => [],
+                    'details'     => 'Order has been dispatched.',
+                    'options'     => [],
+                    'complete'    => false,
+                    'entities'    => [],
+                    'sequence'    => 0,
+                    'activities'  => ['started'],
+                    'internalId'  => Str::uuid(),
+                    'pod_method'  => 'scan',
+                    'require_pod' => false,
+                ],
+            ],
+        ];
+    }
 }

package/server/src/Support/FuelProviders/FuelProviderService.php

@@ -173,8 +173,17 @@ class FuelProviderService
         return DB::transaction(function () use ($connection, $payload) {
             $provider              = $payload['provider'] ?? $connection->provider;
             $providerTransactionId = $payload['provider_transaction_id'];
+            // The match must include company_uuid. Provider transaction ids are only
+            // unique within the account they were issued for, so keying on
+            // (provider, provider_transaction_id) alone let one company's sync find
+            // and overwrite another company's transaction — reassigning its
+            // company_uuid. Mirrors fuel_provider_txn_company_provider_unique.
             $transaction           = FuelProviderTransaction::updateOrCreate(
-                ['provider' => $provider, 'provider_transaction_id' => $providerTransactionId],
+                [
+                    'company_uuid'            => $connection->company_uuid,
+                    'provider'                => $provider,
+                    'provider_transaction_id' => $providerTransactionId,
+                ],
                 array_merge($payload, [
                     'company_uuid'                  => $connection->company_uuid,
                     'fuel_provider_connection_uuid' => $connection->uuid,

package/server/src/Support/Geocoding.php

@@ -36,9 +36,7 @@ class Geocoding
      */
     public static function geocode(string $searchQuery, $latitude = null, $longitude = null): Collection
     {
-        $httpClient = new Client();
-        $provider   = new GoogleMaps($httpClient, null, config('services.google_maps.api_key', env('GOOGLE_MAPS_API_KEY')));
-        $geocoder   = new StatefulGeocoder($provider, 'en');
+        $geocoder = static::makeGeocoder();
 
         try {
             if ($latitude && $longitude) {
@@ -57,7 +55,7 @@ class Geocoding
 
             return collect($geoResults->all())->map(
                 function ($googleAddress) {
-                    return Place::createFromGoogleAddress($googleAddress);
+                    return static::makePlaceFromGoogleAddress($googleAddress);
                 }
             )->values();
         } catch (\Exception $e) {
@@ -81,10 +79,6 @@ class Geocoding
      */
     public static function reverseFromQuery(string $searchQuery, $latitude, $longitude): Collection
     {
-        $httpClient = new Client();
-        $provider   = new GoogleMaps($httpClient, null, config('services.google_maps.api_key', env('GOOGLE_MAPS_API_KEY')));
-        $geocoder   = new StatefulGeocoder($provider, 'en');
-
         if (empty($searchQuery)) {
             return collect();
         }
@@ -93,6 +87,8 @@ class Geocoding
             return collect();
         }
 
+        $geocoder = static::makeGeocoder();
+
         try {
             $geoResults = $geocoder->reverseQuery(
                 ReverseQuery::fromCoordinates($latitude, $longitude)
@@ -103,7 +99,7 @@ class Geocoding
 
             return collect($geoResults->all())->map(
                 function ($googleAddress) {
-                    return Place::createFromGoogleAddress($googleAddress);
+                    return static::makePlaceFromGoogleAddress($googleAddress);
                 }
             )->values();
         } catch (\Exception $e) {
@@ -127,14 +123,12 @@ class Geocoding
      */
     public static function reverseFromCoordinates($latitude, $longitude, ?string $searchQuery = null): Collection
     {
-        $httpClient = new Client();
-        $provider   = new GoogleMaps($httpClient, null, config('services.google_maps.api_key', env('GOOGLE_MAPS_API_KEY')));
-        $geocoder   = new StatefulGeocoder($provider, 'en');
-
         if (empty($latitude) && empty($longitude)) {
             return collect();
         }
 
+        $geocoder = static::makeGeocoder();
+
         try {
             if ($searchQuery) {
                 $geoResults = $geocoder->reverseQuery(
@@ -153,7 +147,7 @@ class Geocoding
 
             return collect($geoResults->all())->map(
                 function ($googleAddress) {
-                    return Place::createFromGoogleAddress($googleAddress);
+                    return static::makePlaceFromGoogleAddress($googleAddress);
                 }
             )->values();
         } catch (\Exception $e) {
@@ -216,4 +210,48 @@ class Geocoding
     {
         return Utils::notEmpty(config('services.google_maps.api_key'));
     }
+
+    /**
+     * The language geocoding results are returned in — Google's `language`
+     * parameter, e.g. `en`, `ru`, `es`.
+     */
+    public static function getLocale(): string
+    {
+        // `?:` rather than a config() default: the settings table stores this
+        // key, so it exists-but-empty on installs that never filled it in, and
+        // config()'s default only applies when the key is absent entirely.
+        return config('services.google_maps.locale') ?: env('GOOGLE_MAPS_LOCALE', 'en');
+    }
+
+    /**
+     * The region requests are biased towards — Google's `region` parameter.
+     * This is a ccTLD (`us`, `ru`, `sg`), not a language code, and is a
+     * separate concern from the locale above.
+     */
+    public static function getRegion(): ?string
+    {
+        return config('services.google_maps.region') ?: env('GOOGLE_MAPS_REGION', 'us');
+    }
+
+    protected static function makeGeocoder(): object
+    {
+        // Allow an alternative geocoder (or test double) to be injected
+        // through the container without constructing a live HTTP client.
+        if (app()->bound('fleetops.geocoder')) {
+            return app('fleetops.geocoder');
+        }
+
+        // Region biases which results rank highest; locale controls the
+        // language they come back in. Applying both here covers every caller
+        // rather than each construction site repeating them.
+        $httpClient = new Client();
+        $provider   = new GoogleMaps($httpClient, static::getRegion(), config('services.google_maps.api_key', env('GOOGLE_MAPS_API_KEY')));
+
+        return new StatefulGeocoder($provider, static::getLocale());
+    }
+
+    protected static function makePlaceFromGoogleAddress($googleAddress): Place
+    {
+        return Place::createFromGoogleAddress($googleAddress);
+    }
 }

package/server/src/Support/GeofenceIntersectionService.php

@@ -70,16 +70,7 @@ class GeofenceIntersectionService
         //    - ST_Contains performs the precise polygon containment check
         //      on the reduced candidate set (accurate, no index needed).
         // ----------------------------------------------------------------
-        $insideZones = Zone::where('company_uuid', $companyUuid)
-            ->whereNotNull('border')
-            ->where(function ($q) {
-                $q->where('trigger_on_entry', true)
-                    ->orWhere('trigger_on_exit', true)
-                    ->orWhereNotNull('dwell_threshold_minutes');
-            })
-            ->whereRaw('MBRContains(`border`, ST_GeomFromText(?))', [$wkt])
-            ->whereRaw('ST_Contains(`border`, ST_GeomFromText(?))', [$wkt])
-            ->get();
+        $insideZones = $this->insideZones($companyUuid, $wkt);
 
         // ----------------------------------------------------------------
         // 2. Find all Service Areas the driver is currently inside.
@@ -87,16 +78,7 @@ class GeofenceIntersectionService
         //    Service areas use MultiPolygon borders, so we use
         //    ST_Contains which handles both Polygon and MultiPolygon.
         // ----------------------------------------------------------------
-        $insideServiceAreas = ServiceArea::where('company_uuid', $companyUuid)
-            ->whereNotNull('border')
-            ->where(function ($q) {
-                $q->where('trigger_on_entry', true)
-                    ->orWhere('trigger_on_exit', true)
-                    ->orWhereNotNull('dwell_threshold_minutes');
-            })
-            ->whereRaw('MBRContains(`border`, ST_GeomFromText(?))', [$wkt])
-            ->whereRaw('ST_Contains(`border`, ST_GeomFromText(?))', [$wkt])
-            ->get();
+        $insideServiceAreas = $this->insideServiceAreas($companyUuid, $wkt);
 
         // Merge into a unified collection with a type discriminator
         $currentlyInside = collect()
@@ -108,10 +90,7 @@ class GeofenceIntersectionService
         // ----------------------------------------------------------------
         // 3. Load the driver's current geofence state records.
         // ----------------------------------------------------------------
-        $currentStates = DB::table($stateTable)
-            ->where($subjectColumn, $subjectUuid)
-            ->get()
-            ->keyBy('geofence_uuid');
+        $currentStates = $this->currentSubjectStates($stateTable, $subjectColumn, $subjectUuid);
 
         // ----------------------------------------------------------------
         // 4. Detect ENTRIES: geofences the driver is now inside but
@@ -136,9 +115,7 @@ class GeofenceIntersectionService
         // ----------------------------------------------------------------
         foreach ($currentStates as $geofenceUuid => $state) {
             if ($state->is_inside && !in_array($geofenceUuid, $currentlyInsideUuids)) {
-                $geofence = $state->geofence_type === 'service_area'
-                    ? ServiceArea::where('uuid', $geofenceUuid)->first()
-                    : Zone::where('uuid', $geofenceUuid)->first();
+                $geofence = $this->findGeofence($state->geofence_type, $geofenceUuid);
 
                 if ($geofence) {
                     $crossings[] = [
@@ -153,6 +130,49 @@ class GeofenceIntersectionService
         return $crossings;
     }
 
+    protected function insideZones(string $companyUuid, string $wkt)
+    {
+        return Zone::where('company_uuid', $companyUuid)
+            ->whereNotNull('border')
+            ->where(function ($q) {
+                $q->where('trigger_on_entry', true)
+                    ->orWhere('trigger_on_exit', true)
+                    ->orWhereNotNull('dwell_threshold_minutes');
+            })
+            ->whereRaw('MBRContains(`border`, ST_GeomFromText(?))', [$wkt])
+            ->whereRaw('ST_Contains(`border`, ST_GeomFromText(?))', [$wkt])
+            ->get();
+    }
+
+    protected function insideServiceAreas(string $companyUuid, string $wkt)
+    {
+        return ServiceArea::where('company_uuid', $companyUuid)
+            ->whereNotNull('border')
+            ->where(function ($q) {
+                $q->where('trigger_on_entry', true)
+                    ->orWhere('trigger_on_exit', true)
+                    ->orWhereNotNull('dwell_threshold_minutes');
+            })
+            ->whereRaw('MBRContains(`border`, ST_GeomFromText(?))', [$wkt])
+            ->whereRaw('ST_Contains(`border`, ST_GeomFromText(?))', [$wkt])
+            ->get();
+    }
+
+    protected function currentSubjectStates(string $stateTable, string $subjectColumn, string $subjectUuid)
+    {
+        return DB::table($stateTable)
+            ->where($subjectColumn, $subjectUuid)
+            ->get()
+            ->keyBy('geofence_uuid');
+    }
+
+    protected function findGeofence(string $geofenceType, string $geofenceUuid)
+    {
+        return $geofenceType === 'service_area'
+            ? ServiceArea::where('uuid', $geofenceUuid)->first()
+            : Zone::where('uuid', $geofenceUuid)->first();
+    }
+
     /**
      * Check if a driver is currently recorded as inside a specific geofence.
      *

package/server/src/Support/LiveOrderQuery.php

@@ -19,7 +19,7 @@ class LiveOrderQuery
         $withRelations     = $options['with_relations'] ?? false;
         $applyPermissions  = $options['apply_permissions'] ?? true;
 
-        $query = Order::where('company_uuid', $companyUuid)
+        $query = static::newOrderQuery($companyUuid)
             ->whereHas('payload', function ($query) {
                 $query->where(function ($q) {
                     $q->whereHas('waypoints');
@@ -72,4 +72,9 @@ class LiveOrderQuery
 
         return $query;
     }
+
+    protected static function newOrderQuery(string $companyUuid): Builder
+    {
+        return Order::where('company_uuid', $companyUuid);
+    }
 }

package/server/src/Support/Metrics/ActiveRevenueQuery.php

@@ -10,7 +10,8 @@ use Illuminate\Support\Facades\Schema;
 
 class ActiveRevenueQuery
 {
-    public const ACTIVE_STATUSES               = [Transaction::STATUS_SUCCESS];
+    public const ACTIVE_STATUSES               = ['success'];
+    public const CREDIT_DIRECTION              = 'credit';
     public const INACTIVE_TRANSACTION_STATUSES = ['pending', 'failed', 'cancelled', 'canceled', 'void', 'voided', 'expired', 'reversed', 'refunded', 'ignored'];
     public const INACTIVE_ORDER_STATUSES       = ['canceled', 'cancelled', 'order_canceled'];
     public const INACTIVE_INVOICE_STATUSES     = ['void', 'voided', 'cancelled', 'canceled'];
@@ -20,7 +21,7 @@ class ActiveRevenueQuery
         $query = Transaction::query()
             ->where('company_uuid', $company->uuid)
             ->where('currency', $currency)
-            ->where('direction', Transaction::DIRECTION_CREDIT)
+            ->where('direction', self::CREDIT_DIRECTION)
             ->whereIn('status', self::ACTIVE_STATUSES)
             ->whereNotIn('status', self::INACTIVE_TRANSACTION_STATUSES)
             ->whereNull('deleted_at')

package/server/src/Support/Metrics/FuelCostsMetric.php

@@ -13,7 +13,7 @@ class FuelCostsMetric extends MoneyMetric
 
     protected function query(?\DateTimeInterface $start, ?\DateTimeInterface $end)
     {
-        $query = FuelReport::where('company_uuid', $this->company->uuid)
+        $query = $this->fuelReportQuery($this->company->uuid)
             ->where('currency', $this->currency());
 
         if ($start && $end) {
@@ -27,4 +27,9 @@ class FuelCostsMetric extends MoneyMetric
     {
         return (float) $query->sum('amount');
     }
+
+    protected function fuelReportQuery(string $companyUuid)
+    {
+        return FuelReport::where('company_uuid', $companyUuid);
+    }
 }

package/server/src/Support/ResolvesOrderServiceStops.php

@@ -381,9 +381,14 @@ trait ResolvesOrderServiceStops
             'location'     => Utils::parsePointToWkt($this->serviceStopLocationPoint($place)),
         ], $place);
 
+        // Unreachable: insertGetUuid() only returns false when the underlying
+        // insert returns false, which Laravel's forced PDO::ERRMODE_EXCEPTION
+        // never does — the insert either succeeds or throws.
+        // @codeCoverageIgnoreStart
         if (!$trackingNumberUuid) {
             return null;
         }
+        // @codeCoverageIgnoreEnd
 
         DB::table($payload->getTable())->where('uuid', $payload->uuid)->update([$column => $trackingNumberUuid]);
         $payload->{$column} = $trackingNumberUuid;
@@ -415,9 +420,14 @@ trait ResolvesOrderServiceStops
             $trackingNumber->status_uuid = $activityId;
         }
 
+        // Unreachable: endpointServiceStopTrackingNumber() always hands back a
+        // freshly queried TrackingNumber, and TrackingNumber declares no $with,
+        // so the status relation is never already loaded here.
+        // @codeCoverageIgnoreStart
         if ($trackingNumber->relationLoaded('status')) {
             $trackingNumber->unsetRelation('status');
         }
+        // @codeCoverageIgnoreEnd
 
         return $activityId ?: null;
     }

package/server/src/Support/Telematics/Providers/GeotabProvider.php

@@ -34,14 +34,14 @@ class GeotabProvider extends AbstractProvider
      */
     protected function authenticate(): void
     {
-        $response = Http::post($this->baseUrl, [
+        $response = $this->postGeotab([
             'method' => 'Authenticate',
             'params' => [
                 'database' => $this->credentials['database'],
                 'userName' => $this->credentials['username'],
                 'password' => $this->credentials['password'],
             ],
-        ])->json();
+        ]);
 
         if (isset($response['result']['credentials']['sessionId'])) {
             $this->sessionId = $response['result']['credentials']['sessionId'];
@@ -223,10 +223,15 @@ class GeotabProvider extends AbstractProvider
             'sessionId' => $this->sessionId,
         ];
 
-        return Http::post($this->baseUrl, [
+        return $this->postGeotab([
             'method' => $method,
             'params' => $params,
-        ])->json() ?? [];
+        ]) ?? [];
+    }
+
+    protected function postGeotab(array $payload): ?array
+    {
+        return Http::post($this->baseUrl, $payload)->json();
     }
 
     protected function fetchLatestLogRecords(array $devices, array $options = []): array