@fleetbase/fleetops-engine 0.6.49 → 0.6.51

package/server/src/Models/VendorPersonnel.php

@@ -3,6 +3,7 @@
 namespace Fleetbase\FleetOps\Models;
 
 use Fleetbase\Models\Model;
+use Fleetbase\Models\User;
 use Fleetbase\Traits\HasUuid;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
@@ -22,7 +23,7 @@ class VendorPersonnel extends Model
      *
      * @var array
      */
-    protected $fillable = ['vendor_uuid', 'contact_uuid'];
+    protected $fillable = ['vendor_uuid', 'contact_uuid', 'role', 'status', 'invited_by_uuid'];
 
     /**
      * These attributes that can be queried.
@@ -60,4 +61,12 @@ class VendorPersonnel extends Model
     {
         return $this->belongsTo(Contact::class);
     }
+
+    /**
+     * The Fleetbase user who invited this personnel.
+     */
+    public function invitedBy(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'invited_by_uuid');
+    }
 }

package/server/src/Models/Waypoint.php

@@ -2,8 +2,8 @@
 
 namespace Fleetbase\FleetOps\Models;
 
-use Barryvdh\DomPDF\Facade\Pdf;
 use Fleetbase\Casts\PolymorphicType;
+use Fleetbase\FleetOps\Support\LabelPdf;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\FleetOps\Traits\HasTrackingNumber;
 use Fleetbase\FleetOps\Traits\PayloadAccessors;
@@ -94,7 +94,7 @@ class Waypoint extends Model
      */
     public function pdfLabel()
     {
-        return Pdf::loadHTML($this->label());
+        return LabelPdf::fromHtml($this->label());
     }
 
     /**

package/server/src/Models/Zone.php

@@ -118,7 +118,7 @@ class Zone extends Model
      */
     public function serviceArea()
     {
-        return $this->belongsTo(ServiceArea::class);
+        return $this->belongsTo(ServiceArea::class, 'service_area_uuid', 'uuid');
     }
 
     /**

package/server/src/Notifications/LateDeparture.php

@@ -12,9 +12,9 @@ class LateDeparture extends Notification implements ShouldQueue
 {
     use Queueable;
 
-    public static string $name = 'Late Departure';
+    public static string $name        = 'Late Departure';
     public static string $description = 'Notify when an order has not departed after the configured grace period.';
-    public static string $package = 'fleet-ops';
+    public static string $package     = 'fleet-ops';
 
     public function __construct(public Order $order, public array $context = [])
     {

package/server/src/Notifications/ProlongedStoppage.php

@@ -12,9 +12,9 @@ class ProlongedStoppage extends Notification implements ShouldQueue
 {
     use Queueable;
 
-    public static string $name = 'Prolonged Stoppage';
+    public static string $name        = 'Prolonged Stoppage';
     public static string $description = 'Notify when a vehicle remains stopped during an active trip beyond the configured threshold.';
-    public static string $package = 'fleet-ops';
+    public static string $package     = 'fleet-ops';
 
     public function __construct(public Order $order, public array $context = [])
     {

package/server/src/Notifications/RouteDeviation.php

@@ -12,9 +12,9 @@ class RouteDeviation extends Notification implements ShouldQueue
 {
     use Queueable;
 
-    public static string $name = 'Route Deviation';
+    public static string $name        = 'Route Deviation';
     public static string $description = 'Notify when tracked vehicle location deviates from the active route beyond the configured threshold.';
-    public static string $package = 'fleet-ops';
+    public static string $package     = 'fleet-ops';
 
     public function __construct(public Order $order, public array $context = [])
     {

package/server/src/Observers/ContactObserver.php

@@ -31,6 +31,8 @@ class ContactObserver
             throw new \Exception('Customer contact type cannot be changed.');
         }
 
+        $contact->assertCustomerIdentityIsAvailable();
+
         // Get the contacts assosciated user
         if ($contact->doesntHaveUser()) {
             $contact->createUser();

package/server/src/Observers/PurchaseRateObserver.php

@@ -2,6 +2,7 @@
 
 namespace Fleetbase\FleetOps\Observers;
 
+use Fleetbase\FleetOps\Models\Order;
 use Fleetbase\FleetOps\Models\PurchaseRate;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\Models\Company;
@@ -18,7 +19,12 @@ class PurchaseRateObserver
      */
     public function creating(PurchaseRate $purchaseRate)
     {
+        if (!$purchaseRate->uuid) {
+            $purchaseRate->uuid = PurchaseRate::generateUuid();
+        }
+
         $purchaseRate->load(['serviceQuote.items', 'serviceQuote.serviceRate']);
+        $order = $this->resolveOrder($purchaseRate);
 
         // get company
         $company = Company::where('uuid', session('company', $purchaseRate->company_uuid))->first();
@@ -32,12 +38,17 @@ class PurchaseRateObserver
             'company_uuid'           => session('company', $purchaseRate->company_uuid),
             'customer_uuid'          => $purchaseRate->customer_uuid,
             'customer_type'          => $purchaseRate->customer_type,
+            'subject_uuid'           => $order?->uuid,
+            'subject_type'           => $order ? Order::class : null,
+            'context_uuid'           => $purchaseRate->uuid,
+            'context_type'           => PurchaseRate::class,
             'gateway_transaction_id' => $purchaseRate->getMeta('transaction_id', Transaction::generateNumber()),
             'gateway'                => 'internal',
             'amount'                 => data_get($purchaseRate, 'serviceQuote.amount', 0),
             'currency'               => $currency,
             'description'            => 'Dispatch order',
             'type'                   => 'dispatch',
+            'direction'              => Transaction::DIRECTION_CREDIT,
             'status'                 => 'success',
         ]);
 
@@ -56,4 +67,13 @@ class PurchaseRateObserver
         $purchaseRate->transaction_uuid = $transaction->uuid;
         $purchaseRate->status           = $purchaseRate->status ?: Transaction::STATUS_SUCCESS;
     }
+
+    protected function resolveOrder(PurchaseRate $purchaseRate): ?Order
+    {
+        if (!$purchaseRate->payload_uuid) {
+            return null;
+        }
+
+        return Order::where('payload_uuid', $purchaseRate->payload_uuid)->first();
+    }
 }

package/server/src/Observers/ServiceRateObserver.php

@@ -14,10 +14,10 @@ class ServiceRateObserver
      */
     public function created(ServiceRate $serviceRate)
     {
-        $serviceRateFees       = request()->input('serviceRate.rate_fees');
-        $serviceRateParcelFees = request()->input('serviceRate.parcel_fees');
+        $serviceRateFees       = request()->input('serviceRate.rate_fees', request()->input('service_rate.rate_fees'));
+        $serviceRateParcelFees = request()->input('serviceRate.parcel_fees', request()->input('service_rate.parcel_fees'));
 
-        if ($serviceRate->isFixedMeter() || $serviceRate->isPerDrop()) {
+        if ($serviceRate->isFixedMeter() || $serviceRate->isPerDrop() || $serviceRate->isMultiZoneDistance()) {
             $serviceRate->setServiceRateFees($serviceRateFees);
         }
 
@@ -33,10 +33,10 @@ class ServiceRateObserver
      */
     public function updated(ServiceRate $serviceRate)
     {
-        $serviceRateFees       = request()->input('serviceRate.rate_fees');
-        $serviceRateParcelFees = request()->input('serviceRate.parcel_fees');
+        $serviceRateFees       = request()->input('serviceRate.rate_fees', request()->input('service_rate.rate_fees'));
+        $serviceRateParcelFees = request()->input('serviceRate.parcel_fees', request()->input('service_rate.parcel_fees'));
 
-        if ($serviceRate->isFixedMeter() || $serviceRate->isPerDrop()) {
+        if ($serviceRate->isFixedMeter() || $serviceRate->isPerDrop() || $serviceRate->isMultiZoneDistance()) {
             $serviceRate->setServiceRateFees($serviceRateFees);
         }
 

package/server/src/Observers/ZoneObserver.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace Fleetbase\FleetOps\Observers;
+
+use Fleetbase\FleetOps\Models\ServiceArea;
+use Fleetbase\FleetOps\Models\Zone;
+
+class ZoneObserver
+{
+    /**
+     * Handle the Zone "created" event.
+     */
+    public function created(Zone $zone): void
+    {
+        $this->invalidateServiceAreaCache($zone);
+    }
+
+    /**
+     * Handle the Zone "updated" event.
+     */
+    public function updated(Zone $zone): void
+    {
+        $this->invalidateServiceAreaCache($zone, $zone->getOriginal('service_area_uuid'));
+        $this->invalidateServiceAreaCache($zone);
+    }
+
+    /**
+     * Handle the Zone "deleted" event.
+     */
+    public function deleted(Zone $zone): void
+    {
+        $this->invalidateServiceAreaCache($zone);
+    }
+
+    /**
+     * Handle the Zone "restored" event.
+     */
+    public function restored(Zone $zone): void
+    {
+        $this->invalidateServiceAreaCache($zone);
+    }
+
+    /**
+     * Invalidate service area API cache because service area responses embed zones.
+     */
+    protected function invalidateServiceAreaCache(Zone $zone, ?string $serviceAreaUuid = null): void
+    {
+        $serviceAreaUuid ??= $zone->service_area_uuid;
+        if (!$serviceAreaUuid) {
+            return;
+        }
+
+        ServiceArea::invalidateApiCacheManually($zone->company_uuid);
+        ServiceArea::invalidateApiCacheManually();
+    }
+}

package/server/src/Orchestration/Engines/VroomOrchestrationEngine.php

@@ -85,7 +85,7 @@ class VroomOrchestrationEngine implements OrchestrationEngineInterface
         $vroomPayload = [
             'jobs'      => [],
             'shipments' => [],
-            'vehicles' => array_map(function (array $v) use ($profile) {
+            'vehicles'  => array_map(function (array $v) use ($profile) {
                 $vehicle = [
                     'id'          => crc32($v['id']), // VROOM requires integer IDs
                     'description' => json_encode(['vehicle_id' => $v['id'], 'driver_id' => $v['driver_id']]),

package/server/src/Providers/FleetOpsServiceProvider.php

@@ -29,6 +29,7 @@ class FleetOpsServiceProvider extends CoreServiceProvider
         \Fleetbase\FleetOps\Models\ServiceRate::class            => \Fleetbase\FleetOps\Observers\ServiceRateObserver::class,
         \Fleetbase\FleetOps\Models\PurchaseRate::class           => \Fleetbase\FleetOps\Observers\PurchaseRateObserver::class,
         \Fleetbase\FleetOps\Models\ServiceArea::class            => \Fleetbase\FleetOps\Observers\ServiceAreaObserver::class,
+        \Fleetbase\FleetOps\Models\Zone::class                   => \Fleetbase\FleetOps\Observers\ZoneObserver::class,
         \Fleetbase\FleetOps\Models\TrackingNumber::class         => \Fleetbase\FleetOps\Observers\TrackingNumberObserver::class,
         \Fleetbase\FleetOps\Models\Driver::class                 => \Fleetbase\FleetOps\Observers\DriverObserver::class,
         \Fleetbase\FleetOps\Models\Vehicle::class                => \Fleetbase\FleetOps\Observers\VehicleObserver::class,
@@ -56,6 +57,7 @@ class FleetOpsServiceProvider extends CoreServiceProvider
         \Fleetbase\FleetOps\Console\Commands\FixInvalidPolymorphicRelationTypeNamespaces::class,
         \Fleetbase\FleetOps\Console\Commands\AssignDriverRoles::class,
         \Fleetbase\FleetOps\Console\Commands\AssignCustomerRoles::class,
+        \Fleetbase\FleetOps\Console\Commands\AuditCustomerUserConflicts::class,
         \Fleetbase\FleetOps\Console\Commands\SimulateOrderRouteNavigation::class,
         \Fleetbase\FleetOps\Console\Commands\DebugOrderTracker::class,
         \Fleetbase\FleetOps\Console\Commands\PurgeUnpurchasedServiceQuotes::class,

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

@@ -40,12 +40,12 @@ abstract class AbstractAnalytics
     {
         if ($period !== null && $period !== '') {
             $days = match ($period) {
-                '7d'   => 7,
-                '14d'  => 14,
-                '30d'  => 30,
-                '90d'  => 90,
-                '180d' => 180,
-                '365d' => 365,
+                '7d'    => 7,
+                '14d'   => 14,
+                '30d'   => 30,
+                '90d'   => 90,
+                '180d'  => 180,
+                '365d'  => 365,
                 default => null,
             };
 

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

@@ -22,7 +22,7 @@ class FuelEfficiency extends AbstractAnalytics
         $fuelByWeek = FuelReport::where('company_uuid', $this->company->uuid)
             ->where('currency', $currency)
             ->whereBetween('created_at', [$start, $end])
-            ->selectRaw("YEARWEEK(created_at, 1) as wk, MIN(DATE(created_at)) as wk_start, SUM(amount) as total_cost")
+            ->selectRaw('YEARWEEK(created_at, 1) as wk, MIN(DATE(created_at)) as wk_start, SUM(amount) as total_cost')
             ->groupBy('wk')
             ->orderBy('wk')
             ->get();
@@ -30,7 +30,7 @@ class FuelEfficiency extends AbstractAnalytics
         $distanceByWeek = Order::where('company_uuid', $this->company->uuid)
             ->where('status', 'completed')
             ->whereBetween('updated_at', [$start, $end])
-            ->selectRaw("YEARWEEK(updated_at, 1) as wk, SUM(distance) as total_distance")
+            ->selectRaw('YEARWEEK(updated_at, 1) as wk, SUM(distance) as total_distance')
             ->groupBy('wk')
             ->orderBy('wk')
             ->pluck('total_distance', 'wk');

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

@@ -41,7 +41,7 @@ class OrdersByStatus extends AbstractAnalytics
         while ($cursor <= $endDay) {
             $labels[] = $cursor->format('M j');
             foreach (array_keys(self::STATUS_PALETTE) as $status) {
-                $match = $rows->first(fn ($r) => $r->bucket === $cursor->format('Y-m-d') && $r->status === $status);
+                $match               = $rows->first(fn ($r) => $r->bucket === $cursor->format('Y-m-d') && $r->status === $status);
                 $byStatus[$status][] = $match ? (int) $match->total : 0;
             }
             $cursor->addDay();

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

@@ -4,7 +4,6 @@ namespace Fleetbase\FleetOps\Support\Analytics;
 
 use Fleetbase\Models\Transaction;
 use Illuminate\Support\Carbon;
-use Illuminate\Support\Facades\DB;
 
 /**
  * Time-series of revenue (sum of transactions) per bucket, filtered to the

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

@@ -12,7 +12,7 @@ use Illuminate\Support\Carbon;
  */
 class TopDrivers extends AbstractAnalytics
 {
-    protected int $limit = 10;
+    protected int $limit     = 10;
     protected string $sortBy = 'orders_completed';
 
     public function limit(int $limit): self
@@ -38,7 +38,15 @@ class TopDrivers extends AbstractAnalytics
 
         $sortColumn = match ($this->sortBy) {
             'distance' => 'distance_m',
-            'on_time'  => 'on_time_pct',
+            'on_time'  => 'CASE
+                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
+                    THEN 1 ELSE 0 END)
+                    / SUM(CASE WHEN orders.scheduled_at IS NOT NULL THEN 1 ELSE 0 END)
+                ELSE -1
+            END',
             default    => 'orders_completed',
         };
 

package/server/src/Support/CustomerAuth.php

@@ -0,0 +1,98 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support;
+
+use Fleetbase\FleetOps\Models\Contact;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+use Laravel\Sanctum\PersonalAccessToken;
+
+/**
+ * Helper for resolving the authenticated customer from a request.
+ *
+ * The customer token is issued by `CustomerController` as a Sanctum
+ * `PersonalAccessToken` whose `name` column carries the owning Contact's UUID.
+ * Mirrors {@see \Fleetbase\Storefront\Support\Storefront::getCustomerFromToken}
+ * but with no Storefront-specific session.
+ */
+class CustomerAuth
+{
+    public const HEADER = 'Customer-Token';
+
+    public const APP_BINDING = 'currentCustomer';
+
+    /**
+     * Resolve the Contact represented by the `Customer-Token` header.
+     *
+     * Preference order when a User has more than one customer-type Contact:
+     *   1. Contact whose UUID matches the token's `name` column (Storefront convention).
+     *   2. Contact in the same company as the resolved API credential (`session('company')`).
+     *   3. The first remaining customer-type Contact for the token's User.
+     */
+    public static function resolveFromHeader(?Request $request = null): ?Contact
+    {
+        $request = $request ?? request();
+        $token   = $request->header(self::HEADER);
+        if (!$token) {
+            return null;
+        }
+
+        $accessToken = PersonalAccessToken::findToken($token);
+        if (!$accessToken) {
+            return null;
+        }
+
+        // Storefront convention: token name = Contact UUID.
+        if (is_string($accessToken->name) && Str::isUuid($accessToken->name)) {
+            $contact = Contact::where('uuid', $accessToken->name)
+                ->where('type', 'customer')
+                ->first();
+            if ($contact) {
+                return $contact;
+            }
+        }
+
+        // Fallback: pick the customer Contact bound to the token's user, preferring
+        // the same company as the API credential when available.
+        $userId         = $accessToken->tokenable_id ?? null;
+        $userIdentifier = $accessToken->tokenable->uuid ?? $userId;
+        if (!$userIdentifier) {
+            return null;
+        }
+
+        $contactQuery = Contact::where('user_uuid', $userIdentifier)
+            ->where('type', 'customer');
+
+        $sessionCompany = session('company');
+        if ($sessionCompany) {
+            $companyPreferred = (clone $contactQuery)
+                ->where('company_uuid', $sessionCompany)
+                ->first();
+            if ($companyPreferred) {
+                return $companyPreferred;
+            }
+        }
+
+        return $contactQuery->first();
+    }
+
+    /**
+     * Return the currently-bound customer (set by AuthenticateCustomerToken middleware).
+     */
+    public static function current(): ?Contact
+    {
+        return app()->bound(self::APP_BINDING) ? app(self::APP_BINDING) : null;
+    }
+
+    /**
+     * Bind the resolved customer for the current request lifecycle.
+     */
+    public static function setCurrent(Contact $contact): void
+    {
+        app()->instance(self::APP_BINDING, $contact);
+        session([
+            'customer_id' => $contact->uuid,
+            'contact_id'  => $contact->uuid,
+        ]);
+    }
+}

package/server/src/Support/GettingStarted.php

@@ -0,0 +1,144 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support;
+
+use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\Order;
+use Fleetbase\FleetOps\Models\TrackingStatus;
+use Fleetbase\Models\Company;
+
+class GettingStarted
+{
+    protected Company $company;
+
+    public static function forCompany(Company $company): static
+    {
+        return new static($company);
+    }
+
+    public function __construct(Company $company)
+    {
+        $this->company = $company;
+    }
+
+    public function get(): array
+    {
+        $steps       = $this->steps();
+        $completed   = collect($steps)->filter(fn ($step) => $step['completed'])->count();
+        $total       = count($steps);
+        $nextStep    = collect($steps)->first(fn ($step) => !$step['completed']);
+        $isCompleted = $completed === $total;
+
+        return [
+            'profile_source'  => 'generic',
+            'profile'         => null,
+            'is_completed'    => $isCompleted,
+            'progress'        => [
+                'completed' => $completed,
+                'total'     => $total,
+                'percent'   => $total > 0 ? (int) round(($completed / $total) * 100) : 0,
+            ],
+            'next_step'       => $nextStep['key'] ?? null,
+            'steps'           => $steps,
+            'recommendations' => $this->recommendations(),
+        ];
+    }
+
+    protected function steps(): array
+    {
+        $companyUuid = $this->company->uuid;
+
+        $hasDriver = Driver::where('company_uuid', $companyUuid)->exists();
+        $hasOrder  = Order::where('company_uuid', $companyUuid)->exists();
+
+        $hasAssignedOrder = Order::where('company_uuid', $companyUuid)
+            ->whereNotNull('driver_assigned_uuid')
+            ->exists();
+
+        $hasOrderActivity = TrackingStatus::where('tracking_statuses.company_uuid', $companyUuid)
+            ->whereNotNull('tracking_statuses.tracking_number_uuid')
+            ->whereNotIn('tracking_statuses.code', ['CREATED', 'ORDER_CREATED'])
+            ->exists();
+
+        return [
+            [
+                'key'         => 'add_driver',
+                'title'       => 'Add a driver',
+                'description' => 'Create your first driver profile so work can be assigned.',
+                'estimate'    => '2 min',
+                'completed'   => $hasDriver,
+                'icon'        => 'id-card',
+                'route'       => 'console.fleet-ops.management.drivers.index.new',
+                'docs_url'    => 'https://www.fleetbase.io/docs/fleet-ops/drivers',
+            ],
+            [
+                'key'         => 'create_order',
+                'title'       => 'Create an order',
+                'description' => 'Add a delivery or service order to start dispatching.',
+                'estimate'    => '3 min',
+                'completed'   => $hasOrder,
+                'icon'        => 'box',
+                'route'       => 'console.fleet-ops.operations.orders.index.new',
+                'docs_url'    => 'https://www.fleetbase.io/docs/fleet-ops/orders',
+            ],
+            [
+                'key'         => 'assign_driver',
+                'title'       => 'Assign driver to order',
+                'description' => 'Connect the order to a driver for execution.',
+                'estimate'    => '1 min',
+                'completed'   => $hasAssignedOrder,
+                'icon'        => 'user-check',
+                'route'       => 'console.fleet-ops.operations.orders.index',
+                'docs_url'    => 'https://www.fleetbase.io/docs/fleet-ops/dispatch',
+            ],
+            [
+                'key'         => 'update_activity',
+                'title'       => 'Update order activity',
+                'description' => 'Move the order through its workflow and capture progress.',
+                'estimate'    => '2 min',
+                'completed'   => $hasOrderActivity,
+                'icon'        => 'route',
+                'route'       => 'console.fleet-ops.operations.orders.index',
+                'docs_url'    => 'https://www.fleetbase.io/docs/fleet-ops/tracking',
+            ],
+        ];
+    }
+
+    protected function recommendations(): array
+    {
+        return [
+            [
+                'key'         => 'route_optimization',
+                'title'       => 'Route Optimization',
+                'description' => 'Plan efficient multi-stop routes and reduce time on the road.',
+                'icon'        => 'route',
+                'accent'      => 'blue',
+                'docs_url'    => 'https://www.fleetbase.io/docs/fleet-ops/orchestrator',
+            ],
+            [
+                'key'         => 'live_fleet',
+                'title'       => 'Live Fleet Map',
+                'description' => 'Watch active drivers, vehicles, and orders in real time.',
+                'icon'        => 'map-location-dot',
+                'accent'      => 'green',
+                'docs_url'    => 'https://www.fleetbase.io/docs/fleet-ops/live-map',
+            ],
+            [
+                'key'         => 'service_rates',
+                'title'       => 'Service Rates',
+                'description' => 'Create pricing rules for deliveries, zones, and service areas.',
+                'icon'        => 'receipt',
+                'accent'      => 'amber',
+                'docs_url'    => 'https://www.fleetbase.io/docs/fleet-ops/service-rates',
+            ],
+            [
+                'key'         => 'customer_portal',
+                'title'       => 'Customer Portal',
+                'description' => 'Let customers submit orders and track deliveries from a branded portal.',
+                'icon'        => 'store',
+                'accent'      => 'purple',
+                'docs_url'    => 'https://www.fleetbase.io/docs/customer-portal',
+            ],
+        ];
+    }
+}

package/server/src/Support/LabelPdf.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support;
+
+use Barryvdh\DomPDF\Facade\Pdf;
+
+class LabelPdf
+{
+    /**
+     * Create a PDF instance for FleetOps labels with UTF-8 and embedded-font
+     * options applied consistently across order, waypoint, and entity labels.
+     */
+    public static function fromHtml(string $html)
+    {
+        $pdf = Pdf::loadHTML($html, 'UTF-8');
+
+        if (method_exists($pdf, 'setOptions')) {
+            $pdf->setOptions(static::options());
+        }
+
+        if (method_exists($pdf, 'getDomPDF')) {
+            $dompdf = $pdf->getDomPDF();
+            foreach (static::dompdfOptions() as $key => $value) {
+                if (method_exists($dompdf, 'set_option')) {
+                    $dompdf->set_option($key, $value);
+                }
+            }
+        }
+
+        return $pdf;
+    }
+
+    public static function options(): array
+    {
+        return [
+            'defaultFont'             => 'DejaVu Sans',
+            'isHtml5ParserEnabled'    => true,
+            'isFontSubsettingEnabled' => true,
+            'isRemoteEnabled'         => false,
+        ];
+    }
+
+    public static function dompdfOptions(): array
+    {
+        return [
+            'defaultFont'             => 'DejaVu Sans',
+            'isHtml5ParserEnabled'    => true,
+            'isFontSubsettingEnabled' => true,
+            'isRemoteEnabled'         => false,
+        ];
+    }
+}