feat(catalog): expose availability policies

app/Domains/Catalog/Resources/CatalogSearchItemResource.php

@@ -28,8 +28,7 @@ class CatalogSearchItemResource extends JsonResource
             'descripcion' => $this->descripcion,
             'precio' => $this->precio,
             'image' => $attachment?->getTemporaryUrl(1440),
-            'maximum_addable_quantity' => $this->maximumAddable($availableStock),
-            'unavailable_message' => $this->unavailableMessage($availableStock),
+            'availability' => $this->availability($availableStock),
             'variants' => $this->variants
                 ->map(function (Variant $variant): array {
                     $variantStock = $this->inventory_policy === InventoryPolicy::Unlimited
@@ -44,8 +43,7 @@ class CatalogSearchItemResource extends JsonResource
                         'event_dates' => $variant->selectedEventDates()->map(fn ($eventDate): string => $eventDate->date->format('Y-m-d'))->values(),
                         'descripcion' => $variant->getDescription(),
                         'precio' => number_format($variant->getPrice(), 2, '.', ''),
-                        'maximum_addable_quantity' => $this->maximumAddable($variantStock),
-                        'unavailable_message' => $this->unavailableMessage($variantStock),
+                        'availability' => $this->availability($variantStock, 'variant'),
                         'values' => $variant->selectorOptions($this->itemAttributes),
                     ];
                 })
@@ -53,19 +51,13 @@ class CatalogSearchItemResource extends JsonResource
         ];
     }
 
-    private function maximumAddable(?int $stock): ?int
+    /** @return array<string, mixed> */
+    private function availability(?int $stock, string $scope = 'product'): array
     {
-        return app(CatalogItemAllowanceService::class)->maximumAddableQuantity(
-            $stock,
-            $this->getAttribute('remaining_user_quota'),
-        );
-    }
-
-    private function unavailableMessage(?int $stock): ?string
-    {
-        return app(CatalogItemAllowanceService::class)->unavailableMessage(
+        return app(CatalogItemAllowanceService::class)->availability(
             $stock,
             $this->getAttribute('remaining_user_quota'),
+            $scope,
         );
     }
 }