@fleetbase/storefront-engine 0.3.23 → 0.3.25

package/server/src/Http/Resources/CatalogProduct.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Fleetbase\Storefront\Http\Resources;
+
+use Fleetbase\Support\Http;
+
+class CatalogProduct extends Product
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return array
+     */
+    public function toArray($request)
+    {
+        return [
+            'id'                 => $this->when(Http::isInternalRequest(), $this->id, $this->public_id),
+            'uuid'               => $this->when(Http::isInternalRequest(), $this->uuid),
+            'public_id'          => $this->when(Http::isInternalRequest(), $this->public_id),
+            'company_uuid'       => $this->when(Http::isInternalRequest(), $this->company_uuid),
+            'store_uuid'         => $this->when(Http::isInternalRequest(), $this->store_uuid),
+            'category_uuid'      => $this->when(Http::isInternalRequest(), $this->category_uuid),
+            'created_by_uuid'    => $this->when(Http::isInternalRequest(), $this->created_by_uuid),
+            'primary_image_uuid' => $this->when(Http::isInternalRequest(), $this->primary_image_uuid),
+            'name'               => $this->name,
+            'description'        => $this->description,
+            'sku'                => $this->sku,
+            'primary_image_url'  => $this->primary_image_url,
+            'price'              => $this->price,
+            'sale_price'         => $this->sale_price,
+            'currency'           => $this->currency,
+            'is_on_sale'         => $this->is_on_sale,
+            'is_recommended'     => $this->is_recommended,
+            'is_service'         => $this->is_service,
+            'is_bookable'        => $this->is_bookable,
+            'is_available'       => $this->is_available,
+            'tags'               => $this->tags ?? [],
+            'status'             => $this->status,
+            'slug'               => $this->slug,
+            'translations'       => $this->translations ?? [],
+            'addon_categories'   => $this->mapAddonCategories($this->addonCategories),
+            'variants'           => $this->mapVariants($this->variants),
+            'files'              => $this->when(Http::isInternalRequest(), $this->files),
+            'images'             => $this->when(!Http::isInternalRequest(), $this->mapFiles($this->files)),
+            'videos'             => $this->when(!Http::isInternalRequest(), $this->mapFiles($this->files, 'video')),
+            'hours'              => $this->mapHours($this->hours),
+            'youtube_urls'       => $this->youtube_urls ?? [],
+            'created_at'         => $this->created_at,
+            'updated_at'         => $this->updated_at,
+            'type'               => $this->when(Http::isInternalRequest(), 'product'),
+        ];
+    }
+}

package/server/src/Http/Resources/FoodTruck.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Fleetbase\Storefront\Http\Resources;
+
+use Fleetbase\FleetOps\Http\Resources\v1\ServiceArea as ServiceAreaResource;
+use Fleetbase\FleetOps\Http\Resources\v1\Vehicle as VehicleResource;
+use Fleetbase\FleetOps\Http\Resources\v1\Zone as ZoneResource;
+use Fleetbase\Http\Resources\FleetbaseResource;
+use Fleetbase\Support\Http;
+
+class FoodTruck extends FleetbaseResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return array
+     */
+    public function toArray($request)
+    {
+        return [
+            'id'                            => $this->when(Http::isInternalRequest(), $this->id, $this->public_id),
+            'uuid'                          => $this->when(Http::isInternalRequest(), $this->uuid),
+            'public_id'                     => $this->when(Http::isInternalRequest(), $this->public_id),
+            'company_uuid'                  => $this->when(Http::isInternalRequest(), $this->company_uuid),
+            'created_by_uuid'               => $this->when(Http::isInternalRequest(), $this->created_by_uuid),
+            'store_uuid'                    => $this->when(Http::isInternalRequest(), $this->store_uuid),
+            'service_area_uuid'             => $this->when(Http::isInternalRequest(), $this->service_area_uuid),
+            'zone_uuid'                     => $this->when(Http::isInternalRequest(), $this->zone_uuid),
+            'vehicle_uuid'                  => $this->when(Http::isInternalRequest(), $this->vehicle_uuid),
+            'vehicle'                       => $this->vehicle ? new VehicleResource($this->vehicle) : null,
+            'service_area'                  => $this->serviceArea ? new ServiceAreaResource($this->serviceArea) : null,
+            'zone'                          => $this->zone ? new ZoneResource($this->zone) : null,
+            'catalogs'                      => Catalog::collection($this->catalogs ?? []),
+            'online'                        => $this->vehicle ? $this->vehicle->online : false,
+            'status'                        => $this->status,
+            'created_at'                    => $this->created_at,
+            'updated_at'                    => $this->updated_at,
+        ];
+    }
+}

package/server/src/Http/Resources/Product.php

@@ -5,8 +5,8 @@ namespace Fleetbase\Storefront\Http\Resources;
 use Fleetbase\Http\Resources\FleetbaseResource;
 use Fleetbase\Support\Http;
 use Illuminate\Support\Arr;
-use Illuminate\Support\Str;
 use Illuminate\Support\Collection;
+use Illuminate\Support\Str;
 
 class Product extends FleetbaseResource
 {
@@ -53,6 +53,7 @@ class Product extends FleetbaseResource
             'youtube_urls'       => $this->youtube_urls ?? [],
             'created_at'         => $this->created_at,
             'updated_at'         => $this->updated_at,
+            'type'               => $this->when(Http::isInternalRequest(), 'product'),
         ];
     }
 

package/server/src/Models/AddonCategory.php

@@ -20,6 +20,18 @@ class AddonCategory extends Category
      */
     protected string $payloadKey = 'addon_category';
 
+    /**
+     * Override the boot method to set "for" automatically.
+     */
+    protected static function boot()
+    {
+        parent::boot();
+
+        static::creating(function (Category $model) {
+            $model->for = 'storefront_product_addon';
+        });
+    }
+
     /**
      * @return \Illuminate\Database\Eloquent\Relations\HasMany
      */

package/server/src/Models/Cart.php

@@ -334,6 +334,12 @@ class Cart extends StorefrontModel
             'addons'            => $addons,
         ];
 
+        // If item was added from a food truck
+        if ($storeLocationId && Str::startsWith($storeLocationId, 'food_truck_')) {
+            $properties['food_truck_id']     = $storeLocationId;
+            $properties['store_location_id'] = Utils::get($product, 'store.locations.0.public_id');
+        }
+
         $this->updateCurrency($product->currency, false);
 
         foreach ($properties as $prop => $value) {

package/server/src/Models/Catalog.php

@@ -0,0 +1,213 @@
+<?php
+
+namespace Fleetbase\Storefront\Models;
+
+use Fleetbase\Casts\Json;
+use Fleetbase\Models\Company;
+use Fleetbase\Models\User;
+use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasPublicid;
+use Fleetbase\Traits\HasUuid;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\MorphToMany;
+
+class Catalog extends StorefrontModel
+{
+    use HasUuid;
+    use HasPublicid;
+    use HasApiModelBehavior;
+
+    /**
+     * The type of public ID to generate.
+     *
+     * @var string
+     */
+    protected $publicIdType = 'catalog';
+
+    /**
+     * The database table used by the model.
+     *
+     * @var string
+     */
+    protected $table = 'catalogs';
+
+    /**
+     * Searchable columns.
+     *
+     * @var array
+     */
+    protected $searchableColumns = ['name'];
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array
+     */
+    protected $fillable = [
+        'uuid',
+        'store_uuid',
+        'company_uuid',
+        'created_by_uuid',
+        'name',
+        'description',
+        'status',
+        'meta',
+    ];
+
+    /**
+     * The attributes that should be cast to native types.
+     *
+     * @var array
+     */
+    protected $casts = [
+        'meta' => Json::class,
+    ];
+
+    /**
+     * Dynamic attributes that are appended to object.
+     *
+     * @var array
+     */
+    protected $appends = [];
+
+    /**
+     * The attributes excluded from the model's JSON form.
+     *
+     * @var array
+     */
+    protected $hidden = [];
+
+    /**
+     * Get the user who created the catalog.
+     */
+    public function createdBy(): BelongsTo
+    {
+        return $this
+            ->setConnection(config('fleetbase.connection.db'))
+            ->belongsTo(User::class, 'created_by_uuid', 'uuid');
+    }
+
+    /**
+     * Get the company this catalog belongs to.
+     */
+    public function company(): BelongsTo
+    {
+        return $this
+            ->setConnection(config('fleetbase.connection.db'))
+            ->belongsTo(Company::class, 'company_uuid', 'uuid');
+    }
+
+    /**
+     * Get the store that owns this food truck.
+     */
+    public function store(): BelongsTo
+    {
+        return $this->belongsTo(Store::class, 'store_uuid', 'uuid');
+    }
+
+    /**
+     * Hours the catalog is available to customers.
+     */
+    public function hours(): HasMany
+    {
+        return $this->hasMany(CatalogHour::class, 'catalog_uuid', 'uuid');
+    }
+
+    /**
+     * Categories the catalog contains.
+     */
+    public function categories(): HasMany
+    {
+        return $this->setConnection(config('fleetbase.connection.db'))->hasMany(CatalogCategory::class, 'owner_uuid', 'uuid');
+    }
+
+    /**
+     * Assignments of subjects the catalog has.
+     */
+    public function assignments(): HasMany
+    {
+        return $this->hasMany(CatalogSubject::class, 'catalog_uuid', 'uuid');
+    }
+
+    /**
+     * Subjects the catalog has been assigned too.
+     */
+    public function subjects(): MorphToMany
+    {
+        return $this->morphedByMany(
+            StorefrontModel::class,
+            'subject',
+            'catalog_subjects',
+            'catalog_uuid',
+            'subject_uuid'
+        );
+    }
+
+    /**
+     * Update or create categories for this catalog based on the provided array.
+     *
+     * This method:
+     *  1) Deletes categories that are no longer in the `$categories` list.
+     *  2) Updates existing categories if their UUID is found in `$categories`.
+     *  3) Creates new categories for entries without a UUID.
+     *  4) Delegates product assignment to `setProducts()` on each category.
+     *
+     * @param array $categories An array of category data, each containing:
+     *                          - 'uuid' (optional): if provided, indicates an existing category to update
+     *                          - 'name': the category name
+     *                          - 'products' (optional): an array of product UUIDs or objects to link
+     *
+     * @return $this
+     */
+    public function setCategories(array $categories = []): Catalog
+    {
+        // Ensure categories relation is loaded.
+        $this->loadMissing('categories');
+
+        // Grab all existing categories for this catalog.
+        $existingCategories = $this->categories;
+
+        // Extract incoming category UUIDs (if any).
+        $incomingUuids = collect($categories)->pluck('uuid')->filter()->unique();
+
+        // 1) Delete categories that are no longer present.
+        //    (i.e., they exist in DB but their UUID is not in $incomingUuids)
+        $existingCategories
+            ->whereNotIn('uuid', $incomingUuids)
+            ->each(function (CatalogCategory $cat) {
+                $cat->delete(); // or $cat->forceDelete() if you don't want soft deletes
+            });
+
+        // 2) Loop through incoming categories array
+        foreach ($categories as $categoryData) {
+            $categoryUuid = data_get($categoryData, 'uuid');
+            $products     = data_get($categoryData, 'products', []);
+            $name         = data_get($categoryData, 'name');
+
+            // Try to find an existing category
+            $categoryRecord = null;
+            if ($categoryUuid) {
+                $categoryRecord = $existingCategories->firstWhere('uuid', $categoryUuid);
+            }
+
+            if ($categoryRecord) {
+                // 2a) Update existing category
+                $categoryRecord->update(['name' => $name]);
+            } else {
+                // 2b) Create a new category
+                $categoryRecord = CatalogCategory::create([
+                    'name'         => $name,
+                    'company_uuid' => $this->company_uuid,
+                    'owner_uuid'   => $this->uuid,
+                    'owner_type'   => get_class($this),
+                ]);
+            }
+
+            // 3) Update products for this category
+            $categoryRecord->setProducts($products);
+        }
+
+        return $this;
+    }
+}

package/server/src/Models/CatalogCategory.php

@@ -0,0 +1,118 @@
+<?php
+
+namespace Fleetbase\Storefront\Models;
+
+use Fleetbase\Models\Category;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\MorphTo;
+use Illuminate\Support\Str;
+
+class CatalogCategory extends Category
+{
+    /**
+     * The key to use in the payload responses (optional).
+     */
+    protected string $payloadKey = 'catalog_category';
+
+    /**
+     * Override the boot method to set "for" automatically.
+     */
+    protected static function boot()
+    {
+        parent::boot();
+
+        static::creating(function (Category $model) {
+            $model->for = 'storefront_catalog';
+        });
+    }
+
+    /**
+     * The catalog the category belongs to.
+     */
+    public function owner(): MorphTo
+    {
+        return $this->setConnection(config('storefront.connection.db'))->morphTo(__FUNCTION__, 'owner_type', 'owner_uuid');
+    }
+
+    /**
+     * The catalog the category belongs to.
+     */
+    public function catalog(): BelongsTo
+    {
+        return $this->setConnection(config('storefront.connection.db'))->belongsTo(Catalog::class, 'owner_uuid', 'uuid');
+    }
+
+    /**
+     * Many-to-many relationship with Product via the pivot table.
+     */
+    public function products(): BelongsToMany
+    {
+        return $this->setConnection(config('storefront.connection.db'))
+        ->belongsToMany(
+            Product::class,
+            'catalog_category_products',
+            'catalog_category_uuid',
+            'product_uuid'
+        )
+        ->using(CatalogProduct::class)
+        ->withTimestamps()
+        ->wherePivotNull('deleted_at');
+    }
+
+    /**
+     * Update or create product relationships for this catalog category.
+     *
+     * This method:
+     *  1) Removes pivot entries (CatalogProduct) for products no longer in `$products`.
+     *  2) Creates pivot entries for new product IDs/UUIDs in `$products`.
+     *
+     * @param array $products an array of product identifiers (UUIDs) or objects containing a 'uuid' key
+     *
+     * @return $this
+     */
+    public function setProducts(array $products = []): CatalogCategory
+    {
+        // Ensure products relation is loaded if needed (optional).
+        $this->loadMissing('products');
+
+        // Fetch existing pivot records for this category
+        $existingPivotRecords = CatalogProduct::where('catalog_category_uuid', $this->uuid)->get();
+        $existingProductUuids = $existingPivotRecords->pluck('product_uuid')->toArray();
+
+        // Normalize incoming product UUIDs
+        $incomingProductUuids = collect($products)
+            ->map(function ($item) {
+                // If $item is simply a UUID string, use it
+                if (is_string($item) && Str::isUuid($item)) {
+                    return $item;
+                }
+
+                // If $item is an array/object, try to extract 'uuid'
+                return data_get($item, 'uuid');
+            })
+            ->filter(fn ($uuid) => Str::isUuid($uuid)) // only valid UUIDs
+            ->unique()
+            ->values()
+            ->toArray();
+
+        // 1) Remove pivot rows for products not in incoming list
+        $toRemove = array_diff($existingProductUuids, $incomingProductUuids);
+        if (!empty($toRemove)) {
+            CatalogProduct::where('catalog_category_uuid', $this->uuid)
+                ->whereIn('product_uuid', $toRemove)
+                ->delete();
+        }
+
+        // 2) Create pivot rows for new products
+        $toAdd = array_diff($incomingProductUuids, $existingProductUuids);
+        foreach ($toAdd as $productUuid) {
+            CatalogProduct::create([
+                'catalog_category_uuid' => $this->uuid,
+                'product_uuid'          => $productUuid,
+            ]);
+        }
+
+        return $this;
+    }
+}

package/server/src/Models/CatalogHour.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace Fleetbase\Storefront\Models;
+
+use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasUuid;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class CatalogHour extends StorefrontModel
+{
+    use HasUuid;
+    use HasApiModelBehavior;
+    use SoftDeletes;
+
+    /**
+     * The database table used by the model.
+     *
+     * @var string
+     */
+    protected $table = 'catalog_hours';
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array
+     */
+    protected $fillable = [
+        'catalog_uuid',
+        'day_of_week',
+        'start',
+        'end',
+    ];
+
+    /**
+     * The relationships that should always be loaded.
+     *
+     * @var array
+     */
+    protected $with = [];
+
+    public function catalog(): BelongsTo
+    {
+        return $this->belongsTo(Catalog::class, 'catalog_uuid', 'uuid');
+    }
+}

package/server/src/Models/CatalogProduct.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Fleetbase\Storefront\Models;
+
+use Fleetbase\Traits\HasUuid;
+use Illuminate\Database\Eloquent\Relations\Pivot;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class CatalogProduct extends Pivot
+{
+    use SoftDeletes;
+    use HasUuid;
+
+    protected $connection = 'storefront';
+    protected $table      = 'catalog_category_products';
+    protected $primaryKey = 'uuid';
+    public $incrementing  = false;
+    protected $fillable   = ['catalog_category_uuid', 'product_uuid'];
+
+    public function __construct(array $attributes = [])
+    {
+        $this->setConnection(config('storefront.connection.db'));
+        parent::__construct($attributes);
+    }
+}

package/server/src/Models/CatalogSubject.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace Fleetbase\Storefront\Models;
+
+use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasUuid;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\MorphPivot;
+use Illuminate\Database\Eloquent\Relations\MorphTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class CatalogSubject extends MorphPivot
+{
+    use HasUuid;
+    use HasApiModelBehavior;
+    use SoftDeletes;
+
+    /**
+     * The default database connection to use.
+     *
+     * @var string
+     */
+    protected $connection = 'storefront';
+
+    /**
+     * The table associated with the model.
+     *
+     * @var string
+     */
+    protected $table = 'catalog_subjects';
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array
+     */
+    protected $fillable = [
+        'uuid',
+        'catalog_uuid',
+        'subject_type',
+        'subject_uuid',
+        'company_uuid',
+        'created_by_uuid',
+    ];
+
+    /**
+     * Set the configured connection.
+     */
+    public function __construct(array $attributes = [])
+    {
+        $this->setConnection(config('storefront.connection.db'));
+        parent::__construct($attributes);
+    }
+
+    /**
+     * The "subject" of this pivot - can be a Store, FoodTruck, etc.
+     */
+    public function subject(): MorphTo
+    {
+        return $this->morphTo(__FUNCTION__, 'subject_type', 'subject_uuid');
+    }
+
+    /**
+     * Get the associated catalog.
+     */
+    public function catalog(): BelongsTo
+    {
+        return $this->belongsTo(Catalog::class, 'catalog_uuid', 'uuid');
+    }
+}