test(catalog): cover global availability behavior

src/app/app.routes.spec.ts

@@ -7,7 +7,6 @@ import { of } from 'rxjs';
 import { App } from './app';
 import { AuthService } from './core/services/auth/auth.service';
 import { CartService } from './core/services/cart/cart.service';
-import { CheckoutService } from './core/services/checkout.service';
 import { Tenant } from './core/services/tenant.interface';
 import { TenantService } from './core/services/tenant.service';
 import { routes } from './app.routes';
@@ -98,21 +97,6 @@ async function renderAppAt(
       {
         provide: AuthService,
         useValue: authService
-      },
-      {
-        provide: CheckoutService,
-        useValue: {
-          withCustomLoading() {
-            return this;
-          },
-          getPurchase: vi.fn().mockResolvedValue({
-            id: 25,
-            status: 'created',
-            items: [],
-            subtotal: '0.00',
-            total: '0.00'
-          })
-        }
       }
     ]
   }).compileComponents();
@@ -262,33 +246,15 @@ describe('app routes', () => {
     expect(compiled.textContent).toContain('No encontramos una tienda para este dominio');
   });
 
-  it('redirects unauthenticated users from /checkout/:id to /login', async () => {
+  it('redirects unauthenticated users from /checkout to /login', async () => {
-    const { router } = await renderAppAt('/checkout/25', createTenantServiceStub(), createAuthServiceStub(false));
+    const { router } = await renderAppAt('/checkout', createTenantServiceStub(), createAuthServiceStub(false));
 
-    expect(router.url).toBe('/login?returnUrl=%2Fcheckout%2F25');
+    expect(router.url).toBe('/login?returnUrl=%2Fcheckout');
   });
 
-  it('allows authenticated users to access /checkout/:id', async () => {
+  it('allows authenticated users to access /checkout', async () => {
-    const checkoutTenant = {
+    const { router } = await renderAppAt('/checkout', createTenantServiceStub(), createAuthServiceStub(true));
-      ...tenant,
-      menues: [
-        {
-          id: 1,
-          code: 'checkout',
-          label: 'Checkout',
-          parent_menu_code: null,
-          content_type: 'dynamic' as const,
-          route: '/checkout',
-          submenues: []
-        }
-      ]
-    };
-    const { router } = await renderAppAt(
-      '/checkout/25',
-      createTenantServiceStub('ready', checkoutTenant),
-      createAuthServiceStub(true)
-    );
 
-    expect(router.url).toBe('/checkout/25');
+    expect(router.url).toBe('/checkout');
   });
 });

src/app/app.spec.ts

@@ -115,6 +115,6 @@ describe('App', () => {
     expect(fixture.nativeElement.textContent).toContain('No encontramos una tienda para este dominio');
     expect(document.title).toBe('ShopitFront');
     expect(document.head.querySelector<HTMLLinkElement>('link[rel~="icon"]')?.getAttribute('href'))
-      .toBe("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg'/%3E");
+      .toBe('favicon.ico');
   });
 });

src/app/app.ts

@@ -9,8 +9,6 @@ import { GlobalLoadingComponent } from './shared/components/global-loading/globa
 import { ModalHostComponent } from './shared/components/modal-host/modal-host.component';
 import { ToastContainerComponent } from './shared/components/toast-container/toast-container.component';
 
-const EMPTY_FAVICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg'/%3E";
-
 function hexToRgb(hex: string): string {
   const cleanHex = hex.replace('#', '').trim();
   let r = 0, g = 0, b = 0;
@@ -68,7 +66,7 @@ export class App {
     effect(() => {
       const tenant = this.tenantService.tenant();
       const siteTitle = tenant?.site_title?.trim() || 'ShopitFront';
-      const faviconHref = tenant?.favicon || EMPTY_FAVICON;
+      const faviconHref = tenant?.favicon || 'favicon.ico';
 
       this.title.setTitle(siteTitle);
 

src/app/core/guards/menu.guard.spec.ts

@@ -62,7 +62,7 @@ describe('hasMenuGuard', () => {
   });
 
   it('redirects a missing menu route to the store root', () => {
-    const result = runGuard('checkout', '/checkout/25', tenant);
+    const result = runGuard('checkout', '/checkout', tenant);
 
     expect(result instanceof UrlTree).toBe(true);
     expect(TestBed.inject(Router).serializeUrl(result as UrlTree)).toBe('/');

src/app/core/layout/store-layout/store-layout.component.spec.ts

@@ -1,6 +1,5 @@
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import { signal } from '@angular/core';
-import { HttpErrorResponse } from '@angular/common/http';
 import { TestBed } from '@angular/core/testing';
 import { By } from '@angular/platform-browser';
 import {
@@ -247,7 +246,7 @@ describe('StoreLayoutComponent', () => {
   it('disables the cart icon and prevents opening the popup during checkout with a tenant base path', () => {
     tenantState.set({ ...tenant, base_path: 'fiesta' });
     const router = TestBed.inject(Router);
-    vi.spyOn(router, 'url', 'get').mockReturnValue('/fiesta/checkout/25');
+    vi.spyOn(router, 'url', 'get').mockReturnValue('/fiesta/checkout?purchase=25');
 
     const fixture = TestBed.createComponent(StoreLayoutComponent);
     fixture.detectChanges();
@@ -588,7 +587,7 @@ describe('StoreLayoutComponent', () => {
     const authService = TestBed.inject(AuthService);
     const cartService = TestBed.inject(CartService);
     const router = TestBed.inject(Router);
-    vi.spyOn(router, 'url', 'get').mockReturnValue('/checkout/25');
+    vi.spyOn(router, 'url', 'get').mockReturnValue('/checkout?purchase=25');
     const navigateSpy = vi.spyOn(router, 'navigate').mockResolvedValue(true);
 
     const fixture = TestBed.createComponent(StoreLayoutComponent);
@@ -675,44 +674,12 @@ describe('StoreLayoutComponent', () => {
     expect(checkoutServiceStub.startCheckout).toHaveBeenCalledWith('test', {
       cart_id: 1,
     });
-    expect(router.navigate).toHaveBeenCalledWith(['/checkout', 55]);
+    expect(router.navigate).toHaveBeenCalledWith(['/checkout'], {
+      queryParams: { purchase: 55 },
+    });
     expect((fixture.componentInstance as any).isCartOpen()).toBe(false);
   });
 
-  it('shows the backend message and refreshes the cart when its reservation expired', async () => {
-    const message = 'La reserva de stock venció. Usá el carrito activo para continuar.';
-    checkoutServiceStub.startCheckout.mockRejectedValue(
-      new HttpErrorResponse({
-        status: 422,
-        error: { code: 'stock_reservation.expired', message },
-      }),
-    );
-    cartState.set({
-      id: 1,
-      tenant_codigo: tenant.codigo,
-      status: 'active',
-      subtotal: '100.00',
-      items: [],
-    });
-    authUserState.set({
-      id: 7,
-      nombre_apellido: 'Juan Perez',
-      email: 'juan@example.com',
-      dni: '12345678',
-      telefono: '3415555555',
-    });
-
-    const fixture = TestBed.createComponent(StoreLayoutComponent);
-    const loadCart = vi.spyOn(TestBed.inject(CartService), 'loadCart');
-    fixture.detectChanges();
-    loadCart.mockClear();
-
-    await (fixture.componentInstance as any).onCheckoutClick();
-
-    expect(TestBed.inject(ToastService).danger).toHaveBeenCalledWith(message);
-    expect(loadCart).toHaveBeenCalledOnce();
-  });
-
   it('allows modifying quantities directly in the regular cart without a toggle', () => {
     cartState.set({
       id: 1,

src/app/core/layout/store-layout/store-layout.component.ts

@@ -1,4 +1,3 @@
-import { HttpErrorResponse } from '@angular/common/http';
 import { Component, computed, DestroyRef, inject, OnInit, signal } from '@angular/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import {
@@ -18,10 +17,7 @@ import { ButtonComponent } from '../../../shared/components/button/button.compon
 import { CartItem, CartItemVariantValue } from '../../services/cart/cart.interface';
 import { AuthService } from '../../services/auth/auth.service';
 import { findMenu } from '../../services/menu.utils';
-import {
+import { CheckoutService } from '../../services/checkout.service';
-  CheckoutService,
-  isExpiredStockReservationResponse,
-} from '../../services/checkout.service';
 import { ToastService } from '../../services/toast.service';
 import { Category } from '../../services/tenant.interface';
 
@@ -277,20 +273,12 @@ export class StoreLayoutComponent implements OnInit {
       });
 
       this.isCartOpen.set(false);
-      await this.router.navigate(['/checkout', purchase.id]);
+      await this.router.navigate(['/checkout'], {
+        queryParams: { purchase: purchase.id },
+      });
     } catch (error) {
       console.error('Failed to create cart purchase:', error);
-      const message =
+      this.toastService.danger('No se pudo iniciar la compra.');
-        error instanceof HttpErrorResponse && typeof error.error?.message === 'string'
-          ? error.error.message
-          : 'No se pudo iniciar la compra.';
-      this.toastService.danger(message);
-
-      if (error instanceof HttpErrorResponse && isExpiredStockReservationResponse(error.error)) {
-        this.cartService.loadCart().subscribe({
-          error: (refreshError) => console.error('Error refreshing expired cart', refreshError),
-        });
-      }
     } finally {
       this.isCreatingPurchase.set(false);
     }

src/app/core/services/auth/auth.guards.spec.ts

@@ -24,12 +24,12 @@ describe('auth guards', () => {
     });
 
     const result = TestBed.runInInjectionContext(() =>
-      authGuard(null as never, { url: '/checkout/25' } as never),
+      authGuard(null as never, { url: '/checkout?mode=direct' } as never),
     );
 
     expect(result instanceof UrlTree).toBe(true);
     expect(TestBed.inject(Router).serializeUrl(result as UrlTree)).toBe(
-      '/login?returnUrl=%2Fcheckout%2F25',
+      '/login?returnUrl=%2Fcheckout%3Fmode%3Ddirect',
     );
   });
 
@@ -39,7 +39,7 @@ describe('auth guards', () => {
     });
 
     const result = TestBed.runInInjectionContext(() =>
-      authGuard(null as never, { url: '/checkout/25' } as never),
+      authGuard(null as never, { url: '/checkout' } as never),
     );
 
     expect(result).toBe(true);

src/app/core/services/catalog/catalog-availability.spec.ts

@@ -0,0 +1,59 @@
+import { describe, expect, it } from 'vitest';
+
+import { CatalogAvailability } from './catalog.interface';
+import {
+  allowsCatalogAction,
+  combineCatalogAvailability,
+  createCatalogAvailability,
+  maximumCatalogQuantity,
+} from './catalog-availability';
+
+describe('catalog availability', () => {
+  it('represents hidden items without irrelevant actions or quantities', () => {
+    const availability = createCatalogAvailability(0);
+
+    expect(availability).toEqual({
+      state: 'hidden',
+      reasons: [
+        {
+          code: 'out_of_stock',
+          message: 'Este producto no tiene stock disponible.',
+        },
+      ],
+    });
+    expect(allowsCatalogAction(availability, 'buy_now')).toBe(false);
+    expect(maximumCatalogQuantity(availability)).toBe(0);
+  });
+
+  it('intersects product and variant actions and quantities', () => {
+    const product: CatalogAvailability = {
+      state: 'visible',
+      maximum_quantity: 3,
+      allowed_actions: ['select_variant', 'change_quantity'],
+      reasons: [{ code: 'limited', message: 'Corregí la selección.' }],
+    };
+    const variant: CatalogAvailability = {
+      state: 'visible',
+      maximum_quantity: 2,
+      allowed_actions: ['change_quantity', 'add_to_cart'],
+      reasons: [],
+    };
+
+    expect(combineCatalogAvailability(product, variant)).toEqual({
+      state: 'visible',
+      maximum_quantity: 2,
+      allowed_actions: ['change_quantity'],
+      reasons: [{ code: 'limited', message: 'Corregí la selección.' }],
+    });
+  });
+
+  it('lets a hidden decision win composition', () => {
+    const availability = combineCatalogAvailability(
+      createCatalogAvailability(5),
+      createCatalogAvailability(0),
+    );
+
+    expect(availability.state).toBe('hidden');
+    expect(allowsCatalogAction(availability, 'add_to_cart')).toBe(false);
+  });
+});

src/app/core/services/catalog/catalog-availability.ts

@@ -0,0 +1,80 @@
+import { CatalogAction, CatalogAvailability } from './catalog.interface';
+
+const ALL_CATALOG_ACTIONS: CatalogAction[] = [
+  'select_variant',
+  'change_quantity',
+  'add_to_cart',
+  'buy_now',
+];
+
+export const AVAILABLE_CATALOG_AVAILABILITY: CatalogAvailability = {
+  state: 'visible',
+  maximum_quantity: null,
+  allowed_actions: ALL_CATALOG_ACTIONS,
+  reasons: [],
+};
+
+export function createCatalogAvailability(maximumQuantity: number | null): CatalogAvailability {
+  const unavailable = maximumQuantity === 0;
+
+  if (unavailable) {
+    return {
+      state: 'hidden',
+      reasons: [
+        {
+          code: 'out_of_stock',
+          message: 'Este producto no tiene stock disponible.',
+        },
+      ],
+    };
+  }
+
+  return {
+    state: 'visible',
+    maximum_quantity: maximumQuantity,
+    allowed_actions: [...ALL_CATALOG_ACTIONS],
+    reasons: [],
+  };
+}
+
+export function primaryAvailabilityMessage(availability: CatalogAvailability): string | null {
+  return availability.reasons[0]?.message ?? null;
+}
+
+export function allowsCatalogAction(
+  availability: CatalogAvailability,
+  action: CatalogAction,
+): boolean {
+  return availability.state === 'visible' && availability.allowed_actions.includes(action);
+}
+
+export function maximumCatalogQuantity(availability: CatalogAvailability): number | null {
+  return availability.state === 'visible' ? availability.maximum_quantity : 0;
+}
+
+export function combineCatalogAvailability(
+  product: CatalogAvailability,
+  variant?: CatalogAvailability | null,
+): CatalogAvailability {
+  if (!variant) return product;
+
+  const reasons = [...product.reasons, ...variant.reasons];
+  if (product.state === 'hidden' || variant.state === 'hidden') {
+    return { state: 'hidden', reasons };
+  }
+
+  return {
+    state: 'visible',
+    maximum_quantity: minimumNullable(product.maximum_quantity, variant.maximum_quantity),
+    allowed_actions: product.allowed_actions.filter((action) =>
+      variant.allowed_actions.includes(action),
+    ),
+    reasons,
+  };
+}
+
+function minimumNullable(left: number | null, right: number | null): number | null {
+  if (left === null) return right;
+  if (right === null) return left;
+  return Math.min(left, right);
+}

src/app/core/services/catalog/catalog.interface.ts

@@ -49,6 +49,25 @@ export interface ProductAttribute {
 
 export type InventoryPolicy = 'tracked' | 'unlimited';
 
+export interface CatalogRestriction {
+  code: 'out_of_stock' | 'user_quota_reached' | string;
+  message: string;
+}
+
+export type CatalogAction = 'select_variant' | 'change_quantity' | 'add_to_cart' | 'buy_now';
+
+export type CatalogAvailability =
+  | {
+      state: 'hidden';
+      reasons: CatalogRestriction[];
+    }
+  | {
+      state: 'visible';
+      maximum_quantity: number | null;
+      allowed_actions: CatalogAction[];
+      reasons: CatalogRestriction[];
+    };
+
 export interface CatalogVariantOption {
   value: string;
   label: string;
@@ -66,8 +85,7 @@ export interface CatalogItemVariant {
   event_date_id?: number | null;
   event_date_ids?: number[];
   event_dates?: string[];
-  maximum_addable_quantity?: number | null;
+  availability: CatalogAvailability;
-  unavailable_message?: string | null;
   minimum_use_date?: string | null;
   maximum_use_date?: string | null;
   effective_minimum_use_date?: string | null;
@@ -99,7 +117,7 @@ export interface CatalogItemDetail {
   attributes: ProductAttribute[];
   variants: CatalogItemVariant[];
   selected_variant?: SelectedCatalogItemVariant;
-  maximum_addable_quantity?: number | null;
+  availability: CatalogAvailability;
   images?: string[];
 }
 
@@ -114,8 +132,7 @@ export interface CatalogFeaturedItemVariant {
   id: number;
   descripcion?: string | null;
   precio?: string;
-  maximum_addable_quantity?: number | null;
+  availability: CatalogAvailability;
-  unavailable_message?: string | null;
   values: Record<string, CatalogVariantValue>;
 }
 
@@ -147,8 +164,7 @@ export interface CatalogFeaturedItem {
   descripcion?: string | null;
   precio: number | string;
   image?: string | null;
-  maximum_addable_quantity?: number | null;
+  availability: CatalogAvailability;
-  unavailable_message?: string | null;
   variants?: CatalogFeaturedItemVariant[];
 }
 

src/app/core/services/checkout.service.ts

@@ -45,21 +45,6 @@ export function isInsufficientStockResponse(value: unknown): value is Insufficie
   );
 }
 
-export interface ExpiredStockReservationResponse {
-  code: 'stock_reservation.expired';
-  message: string;
-}
-
-export function isExpiredStockReservationResponse(
-  value: unknown,
-): value is ExpiredStockReservationResponse {
-  return (
-    typeof value === 'object' &&
-    value !== null &&
-    (value as Partial<ExpiredStockReservationResponse>).code === 'stock_reservation.expired'
-  );
-}
-
 export type StartCheckoutPayload =
   | {
       cart_id: number;

src/app/features/componentes-test/pages/reutilizables-test-page/reutilizables-test-page.component.ts

@@ -13,6 +13,7 @@ import { StoreSectionComponent } from '../../../../shared/components/store-secti
 import { ModalService } from '../../../../core/services/modal.service';
 import { TenantService } from '../../../../core/services/tenant.service';
 import { ToastService } from '../../../../core/services/toast.service';
+import { createCatalogAvailability } from '../../../../core/services/catalog/catalog-availability';
 import { StepperComponent } from '../../../../shared/components/stepper/stepper.component';
 import { StepComponent } from '../../../../shared/components/stepper/step.component';
 import { CarouselComponent } from '../../../../shared/components/carousel/carousel.component';
@@ -232,7 +233,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1001,
         precio: 250000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('a', 'Sector A'),
@@ -243,7 +244,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1002,
         precio: 250000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('a', 'Sector A'),
@@ -254,7 +255,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1003,
         precio: 250000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('c', 'Sector C'),
@@ -265,7 +266,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1004,
         precio: 200000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('a', 'Sector A'),
@@ -276,7 +277,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1005,
         precio: 200000,
-        maximum_addable_quantity: 0,
+        availability: createCatalogAvailability(0),
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('a', 'Sector A'),
@@ -287,7 +288,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1006,
         precio: 100000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('b', 'Sector B'),
@@ -298,7 +299,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1007,
         precio: 100000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('b', 'Sector B'),
@@ -309,7 +310,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1008,
         precio: 90000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('d', 'Sector D'),
@@ -320,7 +321,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1009,
         precio: 65000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('d', 'Sector D'),
@@ -331,7 +332,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1010,
         precio: 40000,
-        maximum_addable_quantity: 1,
+        availability: createCatalogAvailability(1),
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('d', 'Sector D'),

src/app/features/store/components/product-attribute-selector/product-attribute-selector.component.html

@@ -17,7 +17,7 @@
               [attr.aria-label]="option.label"
               [attr.aria-pressed]="hasSelectedOption(attribute, option)"
               [title]="option.label"
-              [disabled]="!availableOptions()[attribute.codigo][option.id]"
+              [disabled]="disabled() || !availableOptions()[attribute.codigo][option.id]"
               (click)="selectAttributeOption(attribute, option)"
             >
               <span class="visually-hidden">{{ option.label }}</span>
@@ -33,7 +33,7 @@
                 !availableOptions()[attribute.codigo][option.id]
               "
               [attr.aria-pressed]="hasSelectedOption(attribute, option)"
-              [disabled]="!availableOptions()[attribute.codigo][option.id]"
+              [disabled]="disabled() || !availableOptions()[attribute.codigo][option.id]"
               (click)="selectAttributeOption(attribute, option)"
             >
               {{ option.label }}

src/app/features/store/components/product-attribute-selector/product-attribute-selector.component.spec.ts

@@ -2,6 +2,7 @@ import { TestBed } from '@angular/core/testing';
 import { beforeEach, describe, expect, it } from 'vitest';
 
 import { ProductAttribute } from '../../../../core/services/catalog/catalog.interface';
+import { createCatalogAvailability } from '../../../../core/services/catalog/catalog-availability';
 import { ProductAttributeSelectorComponent } from './product-attribute-selector.component';
 
 describe('ProductAttributeSelectorComponent', () => {
@@ -31,7 +32,7 @@ describe('ProductAttributeSelectorComponent', () => {
     fixture.componentRef.setInput('variants', [
       {
         id: 1,
-        maximum_addable_quantity: null,
+        availability: createCatalogAvailability(null),
         values: { size: 'S' },
       },
     ]);
@@ -51,12 +52,12 @@ describe('ProductAttributeSelectorComponent', () => {
     fixture.componentRef.setInput('variants', [
       {
         id: 1,
-        maximum_addable_quantity: 0,
+        availability: createCatalogAvailability(0),
         values: { size: 'S' },
       },
       {
         id: 2,
-        maximum_addable_quantity: 2,
+        availability: createCatalogAvailability(2),
         values: { size: 'M' },
       },
     ]);
@@ -92,9 +93,9 @@ describe('ProductAttributeSelectorComponent', () => {
     ]);
     fixture.componentRef.setInput('inventoryPolicy', 'unlimited');
     fixture.componentRef.setInput('variants', [
-      { id: 1, maximum_addable_quantity: null, values: { event_date: '1' } },
+      { id: 1, availability: createCatalogAvailability(null), values: { event_date: '1' } },
-      { id: 2, maximum_addable_quantity: null, values: { event_date: '2' } },
+      { id: 2, availability: createCatalogAvailability(null), values: { event_date: '2' } },
-      { id: 3, maximum_addable_quantity: null, values: { event_date: ['1', '2'] } },
+      { id: 3, availability: createCatalogAvailability(null), values: { event_date: ['1', '2'] } },
     ]);
     fixture.detectChanges();
 
@@ -135,8 +136,16 @@ describe('ProductAttributeSelectorComponent', () => {
     ]);
     fixture.componentRef.setInput('inventoryPolicy', 'unlimited');
     fixture.componentRef.setInput('variants', [
-      { id: 1, maximum_addable_quantity: null, values: { size: 'S', internal_type: 'adult' } },
+      {
-      { id: 2, maximum_addable_quantity: null, values: { size: 'M', internal_type: 'child' } },
+        id: 1,
+        availability: createCatalogAvailability(null),
+        values: { size: 'S', internal_type: 'adult' },
+      },
+      {
+        id: 2,
+        availability: createCatalogAvailability(null),
+        values: { size: 'M', internal_type: 'child' },
+      },
     ]);
     fixture.detectChanges();
 

src/app/features/store/components/product-attribute-selector/product-attribute-selector.component.ts

@@ -15,6 +15,7 @@ import {
   ProductAttribute,
   ProductAttributeOption,
 } from '../../../../core/services/catalog/catalog.interface';
+import { allowsCatalogAction } from '../../../../core/services/catalog/catalog-availability';
 
 @Component({
   selector: 'app-product-attribute-selector',
@@ -29,6 +30,7 @@ export class ProductAttributeSelectorComponent {
   public variants = input<CatalogItemVariant[]>([]);
   public selectedVariant = input<CatalogItemVariant | null>(null);
   public inventoryPolicy = input.required<InventoryPolicy>();
+  public disabled = input(false);
 
   public variantChange = output<CatalogItemVariant | null>();
 
@@ -51,22 +53,15 @@ export class ProductAttributeSelectorComponent {
         const optionNormalized = this.normalizeText(option.value || option.label);
         const selectedForAttribute = selections[attribute.codigo] ?? [];
 
-        if (
-          !attribute.allow_multi_select &&
-          selectedForAttribute.length >= 1 &&
-          !selectedForAttribute.includes(option.id)
-        ) {
-          availability[attribute.codigo][option.id] = false;
-          continue;
-        }
-
         const isAvailable = variants.some((variant) => {
           if (!this.isVariantAvailable(variant)) return false;
 
           const variantAttrValues = this.getVariantAttributeValues(attribute, variant.values);
-          const desiredOptionIds = selectedForAttribute.includes(option.id)
+          const desiredOptionIds = attribute.allow_multi_select
-            ? selectedForAttribute
+            ? selectedForAttribute.includes(option.id)
-            : [...selectedForAttribute, option.id];
+              ? selectedForAttribute
+              : [...selectedForAttribute, option.id]
+            : [option.id];
           const desiredValues = desiredOptionIds
             .map((id) => attribute.options.find((candidate) => candidate.id === id))
             .filter((candidate): candidate is ProductAttributeOption => candidate !== undefined)
@@ -137,6 +132,8 @@ export class ProductAttributeSelectorComponent {
     attribute: ProductAttribute,
     option: ProductAttributeOption,
   ): void {
+    if (this.disabled()) return;
+
     this.selectedAttributeOptions.update((current) => {
       const selected = current[attribute.codigo] ?? [];
       const isMultiple = attribute.allow_multi_select ?? false;
@@ -186,7 +183,15 @@ export class ProductAttributeSelectorComponent {
       return [];
     }
 
-    const defaultValues = this.getVariantAttributeValues(attribute, variant.values);
+    const defaultValues =
+      attribute.type === 'event_date'
+        ? (
+            variant.event_date_ids ??
+            (variant.event_date_id === null || variant.event_date_id === undefined
+              ? []
+              : [variant.event_date_id])
+          ).map(String)
+        : this.getVariantAttributeValues(attribute, variant.values);
     if (defaultValues.length === 0) {
       return [];
     }
@@ -215,6 +220,17 @@ export class ProductAttributeSelectorComponent {
       }
     }
 
+    if (attribute.type === 'event_date') {
+      const variant = this.variants().find((candidate) => candidate.values === variantAttributes);
+      const eventDateIds =
+        variant?.event_date_ids ??
+        (variant?.event_date_id === null || variant?.event_date_id === undefined
+          ? []
+          : [variant.event_date_id]);
+
+      return eventDateIds.map(String);
+    }
+
     return [];
   }
 
@@ -227,7 +243,7 @@ export class ProductAttributeSelectorComponent {
   }
 
   private isVariantAvailable(variant: CatalogItemVariant): boolean {
-    return variant.maximum_addable_quantity !== 0;
+    return allowsCatalogAction(variant.availability, 'select_variant');
   }
 
   private findFirstHexValue(value: unknown): string | null {

src/app/features/store/pages/category-items-page/category-items-page.component.ts

@@ -23,10 +23,7 @@ import {
 
 import { AuthService } from '../../../../core/services/auth/auth.service';
 import { CartService } from '../../../../core/services/cart/cart.service';
-import {
+import { CheckoutService } from '../../../../core/services/checkout.service';
-  CheckoutService,
-  isExpiredStockReservationResponse,
-} from '../../../../core/services/checkout.service';
 import {
   CatalogGroupLayout,
   CategoryItemsResponse,
@@ -170,20 +167,10 @@ export class CategoryItemsPageComponent {
               ],
             },
       );
-      await this.router.navigate(['/checkout', purchase.id]);
+      await this.router.navigate(['/checkout'], { queryParams: { purchase: purchase.id } });
     } catch (error) {
       console.error('Failed to create direct purchase:', error);
-      const message =
+      this.toastService.danger('No se pudo iniciar la compra directa.');
-        error instanceof HttpErrorResponse && typeof error.error?.message === 'string'
-          ? error.error.message
-          : 'No se pudo iniciar la compra directa.';
-      this.toastService.danger(message);
-
-      if (error instanceof HttpErrorResponse && isExpiredStockReservationResponse(error.error)) {
-        this.cartService.loadCart().subscribe({
-          error: (refreshError) => console.error('Error refreshing expired cart', refreshError),
-        });
-      }
     } finally {
       this.creatingDirectPurchase.set(false);
     }

src/app/features/store/pages/checkout-page/checkout-page.component.spec.ts

@@ -33,7 +33,7 @@ describe('CheckoutPageComponent payment validation', () => {
     stop: ReturnType<typeof vi.fn>;
   };
   let cartServiceStub: { loadCart: ReturnType<typeof vi.fn> };
-  let routeParamMap: ReturnType<typeof convertToParamMap>;
+  let routeQueryParamMap: ReturnType<typeof convertToParamMap>;
   let authUserState: ReturnType<typeof signal>;
   let tenantState: ReturnType<
     typeof signal<{
@@ -76,7 +76,7 @@ describe('CheckoutPageComponent payment validation', () => {
     cartServiceStub = {
       loadCart: vi.fn().mockReturnValue(of({ id: 30, items: [], subtotal: '0.00' })),
     };
-    routeParamMap = convertToParamMap({});
+    routeQueryParamMap = convertToParamMap({});
     authUserState = signal(null);
     tenantState = signal({
       codigo: 'tenant-test',
@@ -103,8 +103,8 @@ describe('CheckoutPageComponent payment validation', () => {
           provide: ActivatedRoute,
           useValue: {
             snapshot: {
-              get paramMap() {
+              get queryParamMap() {
-                return routeParamMap;
+                return routeQueryParamMap;
               },
             },
           },
@@ -317,7 +317,7 @@ describe('CheckoutPageComponent payment validation', () => {
       subtotal: '2501.00',
       total: '2501.00',
     };
-    routeParamMap = convertToParamMap({ id: 25 });
+    routeQueryParamMap = convertToParamMap({ purchase: 25 });
     checkoutServiceStub.getPurchase.mockResolvedValue(purchase);
     authUserState.set({
       id: 7,
@@ -354,7 +354,7 @@ describe('CheckoutPageComponent payment validation', () => {
 
   it('keeps the checkout hidden while the purchase is loading', async () => {
     let resolvePurchase!: (purchase: any) => void;
-    routeParamMap = convertToParamMap({ id: 25 });
+    routeQueryParamMap = convertToParamMap({ purchase: 25 });
     checkoutServiceStub.getPurchase.mockReturnValue(
       new Promise((resolve) => {
         resolvePurchase = resolve;
@@ -375,13 +375,12 @@ describe('CheckoutPageComponent payment validation', () => {
     });
     await Promise.resolve();
 
-    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledWith('tenant-test', 25);
     expect(component.isLoadingPurchase()).toBe(false);
     expect(component.checkoutStepIndex()).toBe(0);
   });
 
   it('opens a pending purchase on the payment step and restores its payment method', async () => {
-    routeParamMap = convertToParamMap({ id: 25 });
+    routeQueryParamMap = convertToParamMap({ purchase: 25 });
     checkoutServiceStub.getPurchase.mockResolvedValue({
       id: 25,
       status: 'pending_payment',
@@ -401,7 +400,7 @@ describe('CheckoutPageComponent payment validation', () => {
   });
 
   it('generates a new QR when reopening a pending QR purchase', async () => {
-    routeParamMap = convertToParamMap({ id: 25 });
+    routeQueryParamMap = convertToParamMap({ purchase: 25 });
     checkoutServiceStub.getPurchase.mockResolvedValue({
       id: 25,
       status: 'pending_payment',
@@ -425,7 +424,7 @@ describe('CheckoutPageComponent payment validation', () => {
   it.each(['paid', 'cancelled', 'rejected', 'expired'])(
     'redirects a %s purchase to its status page',
     async (status) => {
-      routeParamMap = convertToParamMap({ id: 25 });
+      routeQueryParamMap = convertToParamMap({ purchase: 25 });
       checkoutServiceStub.getPurchase.mockResolvedValue({
         id: 25,
         status,
@@ -443,7 +442,7 @@ describe('CheckoutPageComponent payment validation', () => {
   );
 
   it('redirects a submitted pending payment purchase to its status page', async () => {
-    routeParamMap = convertToParamMap({ id: 25 });
+    routeQueryParamMap = convertToParamMap({ purchase: 25 });
     checkoutServiceStub.getPurchase.mockResolvedValue({
       id: 25,
       status: 'pending_payment',
@@ -461,7 +460,7 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25]);
   });
 
-  it('shows the API error and redirects to status when cancellation finds an expired purchase', async () => {
+  it('shows the API error in a toast when cancelling the purchase fails', async () => {
     const message = 'La compra venció. Iniciá una nueva compra.';
     checkoutServiceStub.cancelPurchase.mockRejectedValue({
       error: { code: 'purchase.expired', message },
@@ -471,9 +470,7 @@ describe('CheckoutPageComponent payment validation', () => {
     await component.onModifyPurchase();
 
     expect(toastServiceStub.danger).toHaveBeenCalledWith(message);
-    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25], {
+    expect(routerStub.navigate).not.toHaveBeenCalled();
-      queryParams: { status: 'expired' },
-    });
     expect(globalLoadingServiceStub.start).toHaveBeenCalledOnce();
     expect(globalLoadingServiceStub.stop).toHaveBeenCalledOnce();
     expect(component.isCancellingPurchase()).toBe(false);
@@ -590,24 +587,7 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(component.createdPurchaseId()).toBe(25);
   });
 
-  it('allows leaving checkout when cancellation finds an expired stock reservation', async () => {
+  it('shows the API message and redirects home when a checkout operation finds an expired purchase', async () => {
-    const message = 'La reserva de stock venció. Usá el carrito activo para continuar.';
-    checkoutServiceStub.cancelPurchase.mockRejectedValue({
-      error: { code: 'stock_reservation.expired', message },
-    });
-    const { component } = createComponent();
-
-    await expect(component.canDeactivate()).resolves.toBe(true);
-
-    expect(toastServiceStub.danger).toHaveBeenCalledWith(message);
-    expect(cartServiceStub.loadCart).toHaveBeenCalledOnce();
-    expect(component.createdPurchaseId()).toBeNull();
-    expect(component.createdPurchase()).toBeNull();
-    expect(globalLoadingServiceStub.start).toHaveBeenCalledOnce();
-    expect(globalLoadingServiceStub.stop).toHaveBeenCalledOnce();
-  });
-
-  it('shows the API message and redirects to status when a checkout operation finds an expired purchase', async () => {
     checkoutServiceStub.generatePaymentIntent.mockRejectedValue(
       new HttpErrorResponse({
         status: 422,
@@ -624,35 +604,10 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(toastServiceStub.danger).toHaveBeenCalledWith(
       'La compra venci\u00f3. Inici\u00e1 una nueva compra.',
     );
-    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25], {
+    expect(routerStub.navigate).toHaveBeenCalledWith(['/']);
-      queryParams: { status: 'expired' },
-    });
     expect(component.isGeneratingIntent()).toBe(false);
   });
 
-  it('redirects to status when QR polling receives a purchase-expired response', async () => {
-    checkoutServiceStub.getPurchase.mockRejectedValue(
-      new HttpErrorResponse({
-        status: 422,
-        error: {
-          code: 'purchase.expired',
-          message: 'La compra venci\u00f3. Inici\u00e1 una nueva compra.',
-        },
-      }),
-    );
-    const { component } = createComponent();
-
-    await component.selectPaymentMethod('qr');
-    await vi.advanceTimersByTimeAsync(5_000);
-
-    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25], {
-      queryParams: { status: 'expired' },
-    });
-    expect(toastServiceStub.danger).toHaveBeenCalledWith(
-      'La compra venci\u00f3. Inici\u00e1 una nueva compra.',
-    );
-  });
-
   it('treats a generic customer-data error as expired when the local deadline passed', () => {
     const { component } = createComponent();
     component.createdPurchase.set({
@@ -680,8 +635,6 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(toastServiceStub.danger).toHaveBeenCalledWith(
       'La compra venci\u00f3. Inici\u00e1 una nueva compra.',
     );
-    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25], {
+    expect(routerStub.navigate).toHaveBeenCalledWith(['/']);
-      queryParams: { status: 'expired' },
-    });
   });
 });

src/app/features/store/pages/checkout-page/checkout-page.component.ts

@@ -161,7 +161,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
   }
 
   ngOnInit(): void {
-    const purchaseId = Number(this.route.snapshot.paramMap.get('id'));
+    const purchaseId = Number(this.route.snapshot.queryParamMap.get('purchase'));
     if (!Number.isInteger(purchaseId) || purchaseId <= 0) {
       void this.router.navigate(['/']);
       return;
@@ -296,18 +296,6 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
       return true;
     } catch (error) {
       console.error('Failed to cancel the current purchase:', error);
-
-      if (this.isStockReservationExpiredError(error)) {
-        this.showRequestError(error, 'La reserva de stock venció.');
-        this.cartService.loadCart().subscribe({
-          error: (refreshError) => console.error('Error refreshing expired cart', refreshError),
-        });
-        this.createdPurchaseId.set(null);
-        this.createdPurchase.set(null);
-        this.navigationStarted = true;
-        return true;
-      }
-
       this.showRequestError(error, 'No se pudo cancelar la compra.');
       return false;
     } finally {
@@ -504,17 +492,8 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
         this.navigateToPurchaseStatus(purchaseId);
         return;
       }
-
-      if (purchase.status === 'expired') {
-        this.navigateToPurchaseStatus(purchaseId);
-        return;
-      }
     } catch (error) {
       console.error('Failed to validate transfer payment:', error);
-      if (this.isPurchaseExpiredError(error)) {
-        this.showRequestError(error, 'La compra venció. Iniciá una nueva compra.');
-        return;
-      }
     }
 
     if (runId !== this.transferPollingRunId) {
@@ -596,17 +575,8 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
         this.qrPaymentStatus.set('failed');
         return;
       }
-
-      if (purchase.status === 'expired') {
-        this.navigateToPurchaseStatus(purchaseId);
-        return;
-      }
     } catch (error) {
       console.error('Failed to validate QR payment:', error);
-      if (this.isPurchaseExpiredError(error)) {
-        this.showRequestError(error, 'La compra venció. Iniciá una nueva compra.');
-        return;
-      }
     } finally {
       if (runId === this.qrPollingRunId) {
         this.isCheckingQrPayment.set(false);
@@ -713,17 +683,15 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
       }
     } catch (error) {
       console.error('Failed to load purchase:', error);
-      const expired = this.showRequestError(error, 'No se pudo cargar la compra.');
+      this.showRequestError(error, 'No se pudo cargar la compra.');
-      if (!expired) {
+      void this.router.navigate(['/']);
-        void this.router.navigate(['/']);
-      }
     }
   }
 
-  private showRequestError(error: unknown, fallbackMessage: string): boolean {
+  private showRequestError(error: unknown, fallbackMessage: string): void {
     const payload =
       typeof error === 'object' && error !== null && 'error' in error
-        ? (error as { error?: ApiErrorResponse }).error
+        ? (error as { error?: { message?: unknown } }).error
         : undefined;
     const message =
       typeof payload?.message === 'string' && payload.message.trim()
@@ -731,13 +699,6 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
         : fallbackMessage;
 
     this.toastService.danger(message);
-
-    if (payload?.code === 'purchase.expired') {
-      this.navigateToExpiredPurchaseStatus();
-      return true;
-    }
-
-    return false;
   }
 
   private handleCheckoutError(error: unknown, fallbackMessage: string): boolean {
@@ -756,7 +717,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
           ? response.message
           : 'La compra venció. Iniciá una nueva compra.',
       );
-      this.navigateToExpiredPurchaseStatus();
+      void this.router.navigate(['/']);
       return true;
     }
 
@@ -768,42 +729,6 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
     return false;
   }
 
-  private navigateToExpiredPurchaseStatus(): void {
-    const purchaseId = this.createdPurchaseId() ?? this.createdPurchase()?.id;
-
-    if (purchaseId) {
-      if (this.navigationStarted) {
-        return;
-      }
-
-      this.navigationStarted = true;
-      this.stopQrPolling();
-      this.stopTransferPolling();
-      void this.router.navigate(['/checkout/status', purchaseId], {
-        queryParams: { status: 'expired' },
-      });
-      return;
-    }
-
-    void this.router.navigate(['/']);
-  }
-
-  private isPurchaseExpiredError(error: unknown): boolean {
-    if (typeof error !== 'object' || error === null || !('error' in error)) {
-      return false;
-    }
-
-    return (error as { error?: ApiErrorResponse }).error?.code === 'purchase.expired';
-  }
-
-  private isStockReservationExpiredError(error: unknown): boolean {
-    if (typeof error !== 'object' || error === null || !('error' in error)) {
-      return false;
-    }
-
-    return (error as { error?: ApiErrorResponse }).error?.code === 'stock_reservation.expired';
-  }
-
   private hasExpiredPurchase(): boolean {
     const purchase = this.createdPurchase();
 

src/app/features/store/pages/product-detail-page/product-detail-page.component.html

@@ -44,6 +44,7 @@
                 [variants]="prod.variants"
                 [selectedVariant]="prod.selected_variant ?? null"
                 [inventoryPolicy]="prod.inventory_policy"
+                [disabled]="!allows(prod.availability, 'select_variant')"
                 (variantChange)="onVariantChange($event)"
               />
             </section>
@@ -53,14 +54,22 @@
 
           <section class="product-detail__section">
             <div class="product-detail__purchase">
-              <app-quantity-selector [(quantity)]="quantity" [max]="selectedVariantMax()" />
+              @if (restrictionMessage(); as message) {
+                <p class="mb-0 text-danger" role="status">{{ message }}</p>
+              }
+
+              <app-quantity-selector
+                [(quantity)]="quantity"
+                [max]="selectedVariantMax()"
+                [disabled]="!allows(effectiveAvailability(), 'change_quantity')"
+              />
 
               <div class="product-detail__actions">
                 <app-button
                   class="product-detail__cta"
                   variant="secondary"
                   type="button"
-                  [disabled]="!selectedVariantAvailable() || variantLoading() || addingToCart()"
+                  [disabled]="!canAddToCart() || variantLoading() || addingToCart()"
                   (click)="addToCart()"
                 >
                   @if (addingToCart()) {
@@ -75,9 +84,7 @@
                 <app-button
                   class="product-detail__cta"
                   type="button"
-                  [disabled]="
+                  [disabled]="!canBuyNow() || variantLoading() || creatingDirectPurchase()"
-                    !selectedVariantAvailable() || variantLoading() || creatingDirectPurchase()
-                  "
                   (click)="buyNow()"
                 >
                   @if (variantLoading() || creatingDirectPurchase()) {

src/app/features/store/pages/product-detail-page/product-detail-page.component.spec.ts

@@ -10,6 +10,7 @@ import { beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
 import { CatalogItemDetail } from '../../../../core/services/catalog/catalog.interface';
 import { CatalogService } from '../../../../core/services/catalog/catalog.service';
 import { CatalogAvailabilityService } from '../../../../core/services/catalog/catalog-availability.service';
+import { createCatalogAvailability } from '../../../../core/services/catalog/catalog-availability';
 import { CartService } from '../../../../core/services/cart/cart.service';
 import { ToastService } from '../../../../core/services/toast.service';
 import { ProductDetailPageComponent } from './product-detail-page.component';
@@ -38,7 +39,7 @@ describe('ProductDetailPageComponent', () => {
     has_tickets: false,
     minimum_use_date: null,
     maximum_use_date: null,
-    maximum_addable_quantity: 10,
+    availability: createCatalogAvailability(10),
     attributes: [],
     variants: [],
   };
@@ -179,7 +180,7 @@ describe('ProductDetailPageComponent', () => {
 
   it('reloads product availability when the cart changes', async () => {
     catalogServiceStub.getCatalogItem.mockReturnValue(
-      of({ ...mockProduct, maximum_addable_quantity: 4 }),
+      of({ ...mockProduct, availability: createCatalogAvailability(4) }),
     );
     await configureTestingModule();
     const fixture = TestBed.createComponent(ProductDetailPageComponent);
@@ -192,6 +193,21 @@ describe('ProductDetailPageComponent', () => {
     expect(fixture.componentInstance['selectedVariantMax']()).toBe(4);
   });
 
+  it('stops presenting a product that becomes hidden during an availability refresh', async () => {
+    catalogServiceStub.getCatalogItem.mockReturnValue(
+      throwError(() => new HttpErrorResponse({ status: 404 })),
+    );
+    await configureTestingModule();
+    const fixture = TestBed.createComponent(ProductDetailPageComponent);
+    fixture.detectChanges();
+
+    TestBed.inject(CatalogAvailabilityService).notifyAvailabilityChanged();
+    fixture.detectChanges();
+
+    expect(fixture.componentInstance['product']()).toBeNull();
+    expect(fixture.nativeElement.textContent).toContain('Este producto ya no está disponible.');
+  });
+
   it('shows error message if the resolver cannot load the product', async () => {
     resolveProductError(PRODUCT_DETAIL_ERROR_MESSAGE);
     await configureTestingModule();
@@ -207,10 +223,10 @@ describe('ProductDetailPageComponent', () => {
     const detailProduct: CatalogItemDetail = {
       ...mockProduct,
       images: ['https://example.com/product.png'],
-      variants: [{ id: 123, maximum_addable_quantity: 10, values: {} }],
+      variants: [{ id: 123, availability: createCatalogAvailability(10), values: {} }],
       selected_variant: {
         id: 123,
-        maximum_addable_quantity: 10,
+        availability: createCatalogAvailability(10),
         images: ['https://example.com/variant1.png', 'https://example.com/variant2.png'],
         values: {},
       },
@@ -312,11 +328,15 @@ describe('ProductDetailPageComponent', () => {
         },
       ],
       variants: [
-        { id: 123, maximum_addable_quantity: 10, values: { color: 'beige', material: 'Cuero' } },
+        {
+          id: 123,
+          availability: createCatalogAvailability(10),
+          values: { color: 'beige', material: 'Cuero' },
+        },
       ],
       selected_variant: {
         id: 123,
-        maximum_addable_quantity: 10,
+        availability: createCatalogAvailability(10),
         images: ['https://example.com/variant1.png'],
         values: {
           color: 'beige',
@@ -353,8 +373,18 @@ describe('ProductDetailPageComponent', () => {
       purpose: 'entry',
       has_tickets: true,
       variants: [
-        { id: 101, event_date_id: 20, maximum_addable_quantity: 10, values: { event_date: '20' } },
+        {
-        { id: 102, event_date_id: 21, maximum_addable_quantity: 10, values: { event_date: '21' } },
+          id: 101,
+          event_date_id: 20,
+          availability: createCatalogAvailability(10),
+          values: { event_date: '20' },
+        },
+        {
+          id: 102,
+          event_date_id: 21,
+          availability: createCatalogAvailability(10),
+          values: { event_date: '21' },
+        },
       ],
       attributes: [
         {
@@ -385,7 +415,7 @@ describe('ProductDetailPageComponent', () => {
       selected_variant: {
         id: 101,
         event_date_id: 20,
-        maximum_addable_quantity: 10,
+        availability: createCatalogAvailability(10),
         images: [],
         values: {},
       },
@@ -407,6 +437,8 @@ describe('ProductDetailPageComponent', () => {
 
     options[1].click();
     fixture.detectChanges();
+    await fixture.whenStable();
+    fixture.detectChanges();
 
     expect(catalogServiceStub.getCatalogItem).toHaveBeenCalledWith(1, 102);
   });
@@ -429,7 +461,7 @@ describe('ProductDetailPageComponent', () => {
 
     fixture.componentInstance['selectedVariant'].set({
       id: 1,
-      maximum_addable_quantity: 10,
+      availability: createCatalogAvailability(10),
       values: {},
     });
     fixture.detectChanges();
@@ -507,7 +539,9 @@ describe('ProductDetailPageComponent', () => {
         },
       ],
     });
-    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout', 44]);
+    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout'], {
+      queryParams: { purchase: 44 },
+    });
   });
 
   it('shows the backend purchase-limit message for a direct checkout', async () => {
@@ -517,7 +551,7 @@ describe('ProductDetailPageComponent', () => {
         error: {
           code: 'purchase.limit_exceeded',
           message: 'Podés agregar hasta 2 unidades más de “Auriculares Bluetooth”.',
-          maximum_addable_quantity: 2,
+          availability: createCatalogAvailability(2),
         },
       }),
     );
@@ -542,13 +576,13 @@ describe('ProductDetailPageComponent', () => {
       variants: [
         {
           id: 123,
-          maximum_addable_quantity: 5,
+          availability: createCatalogAvailability(5),
           values: {},
         },
       ],
       selected_variant: {
         id: 123,
-        maximum_addable_quantity: 5,
+        availability: createCatalogAvailability(5),
         images: [],
         values: {},
       },
@@ -581,7 +615,7 @@ describe('ProductDetailPageComponent', () => {
     resolveProduct({
       ...mockProduct,
       variants: [],
-      maximum_addable_quantity: 4,
+      availability: createCatalogAvailability(4),
     });
 
     await configureTestingModule();
@@ -607,13 +641,13 @@ describe('ProductDetailPageComponent', () => {
       variants: [
         {
           id: 123,
-          maximum_addable_quantity: 5,
+          availability: createCatalogAvailability(5),
           values: {},
         },
       ],
       selected_variant: {
         id: 123,
-        maximum_addable_quantity: 5,
+        availability: createCatalogAvailability(5),
         images: [],
         values: {},
       },
@@ -645,7 +679,7 @@ describe('ProductDetailPageComponent', () => {
   it('allows unlimited variants to increase quantity without a maximum', async () => {
     const unlimitedVariant = {
       id: 321,
-      maximum_addable_quantity: null,
+      availability: createCatalogAvailability(null),
       values: {},
     };
     resolveProduct({
@@ -653,7 +687,7 @@ describe('ProductDetailPageComponent', () => {
       inventory_policy: 'unlimited',
       selected_variant: {
         id: 321,
-        maximum_addable_quantity: null,
+        availability: createCatalogAvailability(null),
         images: [],
         values: {},
       },
@@ -677,7 +711,7 @@ describe('ProductDetailPageComponent', () => {
   it('caps an unlimited variant at the per-user purchase limit', async () => {
     const unlimitedVariant = {
       id: 322,
-      maximum_addable_quantity: 2,
+      availability: createCatalogAvailability(2),
       values: {},
     };
     resolveProduct({
@@ -686,7 +720,7 @@ describe('ProductDetailPageComponent', () => {
       max_units_per_user: 2,
       selected_variant: {
         id: 322,
-        maximum_addable_quantity: 2,
+        availability: createCatalogAvailability(2),
         images: [],
         values: { event_date: '20' },
       },
@@ -710,14 +744,14 @@ describe('ProductDetailPageComponent', () => {
   it('disables purchase actions for tracked variants without stock', async () => {
     const trackedVariant = {
       id: 654,
-      maximum_addable_quantity: 0,
+      availability: createCatalogAvailability(0),
       values: {},
     };
     resolveProduct({
       ...mockProduct,
       selected_variant: {
         id: 654,
-        maximum_addable_quantity: 0,
+        availability: createCatalogAvailability(0),
         images: [],
         values: {},
       },

src/app/features/store/pages/product-detail-page/product-detail-page.component.ts

@@ -32,6 +32,13 @@ import { ProductDetailResolvedData } from './product-detail-page.resolver';
 import { CheckoutService } from '../../../../core/services/checkout.service';
 import { TenantService } from '../../../../core/services/tenant.service';
 import { AuthService } from '../../../../core/services/auth/auth.service';
+import {
+  AVAILABLE_CATALOG_AVAILABILITY,
+  allowsCatalogAction,
+  combineCatalogAvailability,
+  maximumCatalogQuantity,
+  primaryAvailabilityMessage,
+} from '../../../../core/services/catalog/catalog-availability';
 
 @Component({
   selector: 'app-product-detail-page',
@@ -96,29 +103,41 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
     () => this.selectedVariant()?.precio ?? this.product()?.precio,
   );
   protected readonly quantity = signal(1);
+  protected readonly effectiveAvailability = computed(() => {
+    const prod = this.product();
+    const variant = this.selectedVariant();
+    if (!prod) return AVAILABLE_CATALOG_AVAILABILITY;
+
+    return combineCatalogAvailability(prod.availability, variant?.availability);
+  });
   protected readonly selectedVariantMax = computed<number | null>(() => {
     const prod = this.product();
     const variant = this.selectedVariant();
     if (!prod) return 0;
+    if (!variant && prod.variants.length > 0) return 0;
 
-    return variant
+    return maximumCatalogQuantity(this.effectiveAvailability());
-      ? (variant.maximum_addable_quantity ?? null)
-      : prod.variants.length === 0
-        ? (prod.maximum_addable_quantity ?? null)
-        : 0;
   });
-  protected readonly selectedVariantAvailable = computed(() => {
+  protected readonly hasPurchasableSelection = computed(() => {
     const prod = this.product();
     if (!prod) return false;
-    if (this.selectedVariantMax() === 0) return false;
 
-    const variant = this.selectedVariant();
+    return prod.variants.length === 0 || this.selectedVariant() !== null;
-    if (variant) return this.isVariantAvailable(variant);
-    if (prod.purpose === 'entry') return false;
-    if (prod.variants.length > 0) return false;
-
-    return this.selectedVariantMax() !== 0;
   });
+  protected readonly canAddToCart = computed(
+    () =>
+      this.hasPurchasableSelection() &&
+      allowsCatalogAction(this.effectiveAvailability(), 'add_to_cart'),
+  );
+  protected readonly canBuyNow = computed(
+    () =>
+      this.hasPurchasableSelection() &&
+      allowsCatalogAction(this.effectiveAvailability(), 'buy_now'),
+  );
+  protected readonly restrictionMessage = computed(() =>
+    primaryAvailabilityMessage(this.effectiveAvailability()),
+  );
+  protected readonly allows = allowsCatalogAction;
   protected readonly descriptionExpanded = signal(false);
   protected readonly descriptionMaxHeight = signal(0);
   protected readonly descriptionHasOverflow = signal(false);
@@ -224,8 +243,12 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
             this.quantity.set(Math.max(1, maximum));
           }
         },
-        error: () => {
+        error: (error: HttpErrorResponse) => {
-          // Keep the last known availability if the silent refresh fails.
+          if (error.status === 404) {
+            this.product.set(null);
+            this.selectedVariant.set(null);
+            this.error.set('Este producto ya no está disponible.');
+          }
         },
       });
   }
@@ -295,8 +318,10 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
   protected addToCart(): void {
     const currentProduct = this.product();
     const variant = this.selectedVariant();
-    if (!currentProduct || !this.selectedVariantAvailable()) {
+    if (!currentProduct || !this.canAddToCart()) {
-      this.toastService.danger('Por favor, selecciona una variante.');
+      this.toastService.danger(
+        this.effectiveAvailability().reasons[0]?.message ?? 'Por favor, selecciona una variante.',
+      );
       return;
     }
 
@@ -326,8 +351,10 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
       return;
     }
 
-    if (!currentProduct || !this.selectedVariantAvailable()) {
+    if (!currentProduct || !this.canBuyNow()) {
-      this.toastService.danger('Por favor, selecciona una variante.');
+      this.toastService.danger(
+        this.effectiveAvailability().reasons[0]?.message ?? 'Por favor, selecciona una variante.',
+      );
       return;
     }
 
@@ -358,7 +385,9 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
         ],
       });
 
-      await this.router.navigate(['/checkout', purchase.id]);
+      await this.router.navigate(['/checkout'], {
+        queryParams: { purchase: purchase.id },
+      });
     } catch (error) {
       console.error('Failed to create direct purchase:', error);
       const message =
@@ -371,10 +400,6 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
     }
   }
 
-  private isVariantAvailable(variant: CatalogItemVariant): boolean {
-    return variant.maximum_addable_quantity !== 0;
-  }
-
   protected toggleDescription(): void {
     this.descriptionExpanded.update((current) => !current);
   }

src/app/features/store/pages/product-detail-page/product-detail-page.resolver.spec.ts

@@ -5,6 +5,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { CatalogItemDetail } from '../../../../core/services/catalog/catalog.interface';
 import { CatalogService } from '../../../../core/services/catalog/catalog.service';
+import { createCatalogAvailability } from '../../../../core/services/catalog/catalog-availability';
 import {
   PRODUCT_DETAIL_ERROR_MESSAGE,
   PRODUCT_DETAIL_INVALID_ID_MESSAGE,
@@ -29,7 +30,7 @@ describe('productDetailResolver', () => {
     has_tickets: false,
     minimum_use_date: null,
     maximum_use_date: null,
-    maximum_addable_quantity: 0,
+    availability: createCatalogAvailability(0),
     attributes: [],
     variants: [],
   };

src/app/features/store/pages/purchase-status-page/purchase-status-page.component.spec.ts

@@ -5,7 +5,6 @@ import {
   CheckoutService,
   PurchaseDetailResponse,
 } from '../../../../core/services/checkout.service';
-import { CartService } from '../../../../core/services/cart/cart.service';
 import { Tenant } from '../../../../core/services/tenant.interface';
 import { TenantService } from '../../../../core/services/tenant.service';
 import { PurchaseStatusPageComponent } from './purchase-status-page.component';
@@ -67,7 +66,7 @@ describe('PurchaseStatusPageComponent', () => {
     TestBed.resetTestingModule();
   });
 
-  async function render(hasGeneratedTickets: boolean, forcedStatus?: string) {
+  async function render(hasGeneratedTickets: boolean) {
     const checkoutService = {
       getPurchase: vi.fn().mockResolvedValue(purchase(hasGeneratedTickets)),
       withCustomLoading() {
@@ -78,24 +77,15 @@ describe('PurchaseStatusPageComponent', () => {
       navigate: vi.fn().mockResolvedValue(true),
       navigateByUrl: vi.fn().mockResolvedValue(true),
     };
-    const cartService = { clearCart: vi.fn() };
 
     await TestBed.configureTestingModule({
       imports: [PurchaseStatusPageComponent],
       providers: [
         { provide: CheckoutService, useValue: checkoutService },
-        { provide: CartService, useValue: cartService },
         { provide: TenantService, useValue: { tenant: () => tenant } },
         {
           provide: ActivatedRoute,
-          useValue: {
+          useValue: { snapshot: { paramMap: convertToParamMap({ id: '42' }) } },
-            snapshot: {
-              paramMap: convertToParamMap({ id: '42' }),
-              queryParamMap: convertToParamMap(
-                forcedStatus ? { status: forcedStatus } : {},
-              ),
-            },
-          },
         },
         { provide: Router, useValue: router },
       ],
@@ -110,22 +100,15 @@ describe('PurchaseStatusPageComponent', () => {
       fixture,
       element: fixture.nativeElement as HTMLElement,
       checkoutService,
-      cartService,
       router,
     };
   }
 
-  it('clears the cart when the purchase is approved', async () => {
-    const { cartService } = await render(true);
-
-    expect(cartService.clearCart).toHaveBeenCalledOnce();
-  });
-
   it('shows the tickets action when this purchase generated tickets', async () => {
     const { element, checkoutService, router } = await render(true);
 
     expect(checkoutService.getPurchase).toHaveBeenCalledOnce();
-    expect(element.textContent).toContain('Mis tickets');
+    expect(element.textContent).toContain('Ver mis tickets');
     expect(element.textContent).not.toContain('WhatsApp');
 
     element.querySelector<HTMLButtonElement>('app-button button')?.click();
@@ -151,14 +134,6 @@ describe('PurchaseStatusPageComponent', () => {
     openSpy.mockRestore();
   });
 
-  it('shows the expired result without polling when checkout redirects after expiration', async () => {
-    const { element, checkoutService } = await render(false, 'expired');
-
-    expect(element.textContent).toContain('LA COMPRA VENCIÓ');
-    expect(element.textContent).not.toContain('ESTAMOS VERIFICANDO TU PAGO');
-    expect(checkoutService.getPurchase).not.toHaveBeenCalled();
-  });
-
   it('polls every five seconds while the payment is pending and shows the confirmation', async () => {
     vi.useFakeTimers();
 
@@ -172,13 +147,11 @@ describe('PurchaseStatusPageComponent', () => {
           return this;
         },
       };
-      const cartService = { clearCart: vi.fn() };
 
       await TestBed.configureTestingModule({
         imports: [PurchaseStatusPageComponent],
         providers: [
           { provide: CheckoutService, useValue: checkoutService },
-          { provide: CartService, useValue: cartService },
           { provide: TenantService, useValue: { tenant: () => tenant } },
           {
             provide: ActivatedRoute,
@@ -201,7 +174,6 @@ describe('PurchaseStatusPageComponent', () => {
 
       expect(checkoutService.getPurchase).toHaveBeenCalledTimes(2);
       expect(fixture.nativeElement.textContent).toContain('COMPRA REALIZADA!');
-      expect(cartService.clearCart).toHaveBeenCalledOnce();
 
       await vi.advanceTimersByTimeAsync(10_000);
       expect(checkoutService.getPurchase).toHaveBeenCalledTimes(2);
@@ -225,7 +197,6 @@ describe('PurchaseStatusPageComponent', () => {
         imports: [PurchaseStatusPageComponent],
         providers: [
           { provide: CheckoutService, useValue: checkoutService },
-          { provide: CartService, useValue: { clearCart: vi.fn() } },
           { provide: TenantService, useValue: { tenant: () => tenant } },
           {
             provide: ActivatedRoute,

src/app/features/store/pages/purchase-status-page/purchase-status-page.component.ts

@@ -15,7 +15,6 @@ import {
   CheckoutService,
   PurchaseStatusResponse,
 } from '../../../../core/services/checkout.service';
-import { CartService } from '../../../../core/services/cart/cart.service';
 import { findMenu } from '../../../../core/services/menu.utils';
 import { TenantService } from '../../../../core/services/tenant.service';
 import { ButtonComponent } from '../../../../shared/components/button/button.component';
@@ -36,7 +35,6 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
   private readonly route = inject(ActivatedRoute);
   private readonly router = inject(Router);
   private readonly checkoutService = inject(CheckoutService);
-  private readonly cartService = inject(CartService);
   private readonly tenantService = inject(TenantService);
   private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
 
@@ -74,12 +72,6 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
     this.purchaseId = purchaseId;
     this.tenantCode = tenant.codigo;
 
-    if (this.route.snapshot.queryParamMap?.get('status') === 'expired') {
-      this.status.set('expired');
-      this.isLoading.set(false);
-      return;
-    }
-
     void this.loadStatus();
   }
 
@@ -106,10 +98,6 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
       this.status.set(status);
       this.hasGeneratedTickets.set(purchase.has_generated_tickets === true);
 
-      if (status === 'approved') {
-        this.cartService.clearCart();
-      }
-
       if (status === 'pending') {
         this.schedulePolling();
       } else {
@@ -119,10 +107,7 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
       console.error('Failed to fetch purchase status:', error);
 
       if (!this.isDestroyed) {
-        if (this.isPurchaseExpiredError(error)) {
+        if (isPolling) {
-          this.status.set('expired');
-          this.stopPolling();
-        } else if (isPolling) {
           this.schedulePolling();
         } else {
           this.status.set('error');
@@ -169,14 +154,6 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
     return 'pending';
   }
 
-  private isPurchaseExpiredError(error: unknown): boolean {
-    if (typeof error !== 'object' || error === null || !('error' in error)) {
-      return false;
-    }
-
-    return (error as { error?: { code?: string } }).error?.code === 'purchase.expired';
-  }
-
   protected goToTickets(): void {
     const route = this.ticketsRoute();
 

src/app/features/store/pages/register-page/register-page.component.html

@@ -38,13 +38,11 @@
     <label class="visually-hidden" for="register-password">Contraseña</label>
     <app-input
       id="register-password"
-      type="password-toggle"
+      type="password"
       placeholder="Contraseña"
       [value]="form.controls.password.value"
       [invalid]="showControlError('password')"
-      [visible]="passwordVisible()"
       (valueChange)="updateField('password', $event)"
-      (visibleChange)="setPasswordVisibility($event)"
     />
     @if (getControlError('password'); as errorMessage) {
       <small class="text-danger">{{ errorMessage }}</small>
@@ -53,13 +51,11 @@
     <label class="visually-hidden" for="register-password-repeat">Repetir Contraseña</label>
     <app-input
       id="register-password-repeat"
-      type="password-toggle"
+      type="password"
       placeholder="Repetir Contraseña"
       [value]="form.controls.password_confirmation.value"
       [invalid]="showControlError('password_confirmation')"
-      [visible]="passwordVisible()"
       (valueChange)="updateField('password_confirmation', $event)"
-      (visibleChange)="setPasswordVisibility($event)"
     />
     @if (getControlError('password_confirmation'); as errorMessage) {
       <small class="text-danger">{{ errorMessage }}</small>

src/app/features/store/pages/register-page/register-page.component.spec.ts

@@ -12,48 +12,6 @@ describe('RegisterPageComponent', () => {
     TestBed.resetTestingModule();
   });
 
-  it('shows and hides both password fields with either visibility control', async () => {
-    await TestBed.configureTestingModule({
-      imports: [RegisterPageComponent],
-      providers: [
-        provideRouter([]),
-        { provide: AuthService, useValue: { register: vi.fn() } },
-        { provide: ModalService, useValue: { openSimple: vi.fn() } },
-        { provide: ToastService, useValue: { danger: vi.fn() } }
-      ]
-    }).compileComponents();
-
-    const fixture = TestBed.createComponent(RegisterPageComponent);
-    fixture.detectChanges();
-
-    const getPasswordInputs = () =>
-      Array.from(
-        fixture.nativeElement.querySelectorAll(
-          'input#register-password, input#register-password-repeat'
-        )
-      ) as HTMLInputElement[];
-    const getVisibilityButtons = () =>
-      Array.from(
-        fixture.nativeElement.querySelectorAll('button[aria-label]')
-      ) as HTMLButtonElement[];
-
-    expect(getPasswordInputs().map((input) => input.type)).toEqual(['password', 'password']);
-
-    getVisibilityButtons()[0].click();
-    fixture.detectChanges();
-
-    expect(getPasswordInputs().map((input) => input.type)).toEqual(['text', 'text']);
-    expect(getVisibilityButtons().map((button) => button.getAttribute('aria-label'))).toEqual([
-      'Ocultar contraseña',
-      'Ocultar contraseña'
-    ]);
-
-    getVisibilityButtons()[1].click();
-    fixture.detectChanges();
-
-    expect(getPasswordInputs().map((input) => input.type)).toEqual(['password', 'password']);
-  });
-
   it('submits registration data and redirects to /login on success', async () => {
     const authService = {
       register: vi.fn().mockReturnValue(

src/app/features/store/pages/register-page/register-page.component.ts

@@ -48,7 +48,6 @@ export class RegisterPageComponent {
   private readonly submittedState = signal(false);
   private readonly serverErrorState = signal<string | null>(null);
   private readonly isSubmittingState = signal(false);
-  private readonly passwordVisibleState = signal(false);
 
   protected readonly form = this.formBuilder.nonNullable.group({
     nombre_apellido: ['', [Validators.required, Validators.maxLength(TEXT_MAX_LENGTH)]],
@@ -68,11 +67,6 @@ export class RegisterPageComponent {
   protected readonly submitted = this.submittedState.asReadonly();
   protected readonly serverError = this.serverErrorState.asReadonly();
   protected readonly isSubmitting = this.isSubmittingState.asReadonly();
-  protected readonly passwordVisible = this.passwordVisibleState.asReadonly();
-
-  protected setPasswordVisibility(visible: boolean): void {
-    this.passwordVisibleState.set(visible);
-  }
 
   goToLogin(): void {
     void this.router.navigate(['/login']);

src/app/features/store/pages/reset-password-page/reset-password-page.component.html

@@ -13,13 +13,11 @@
     <label class="visually-hidden" for="reset-password-new">Nueva Contraseña</label>
     <app-input
       id="reset-password-new"
-      type="password-toggle"
+      type="password"
       placeholder="Nueva Contraseña"
       [value]="form.controls.password.value"
       [invalid]="showControlError('password')"
-      [visible]="passwordVisible()"
       (valueChange)="updatePassword('password', $event)"
-      (visibleChange)="setPasswordVisibility($event)"
     />
     @if (getControlError('password'); as errorMessage) {
       <small class="text-danger">{{ errorMessage }}</small>
@@ -32,13 +30,11 @@
     </label>
     <app-input
       id="reset-password-confirmation"
-      type="password-toggle"
+      type="password"
       placeholder="Repetir Nueva Contraseña"
       [value]="form.controls.password_confirmation.value"
       [invalid]="showControlError('password_confirmation')"
-      [visible]="passwordVisible()"
       (valueChange)="updatePassword('password_confirmation', $event)"
-      (visibleChange)="setPasswordVisibility($event)"
     />
     @if (getControlError('password_confirmation'); as errorMessage) {
       <small class="text-danger">{{ errorMessage }}</small>

src/app/features/store/pages/reset-password-page/reset-password-page.component.spec.ts

@@ -50,43 +50,6 @@ describe('ResetPasswordPageComponent', () => {
     ];
   }
 
-  it('shows and hides both password fields with either visibility control', async () => {
-    const modalService = {
-      openSimple: vi.fn(),
-    };
-
-    await TestBed.configureTestingModule({
-      imports: [ResetPasswordPageComponent],
-      providers: resetProviders(modalService),
-    }).compileComponents();
-
-    const fixture = TestBed.createComponent(ResetPasswordPageComponent);
-    fixture.detectChanges();
-
-    const getPasswordInputs = () =>
-      Array.from(fixture.nativeElement.querySelectorAll('input')) as HTMLInputElement[];
-    const getVisibilityButtons = () =>
-      Array.from(
-        fixture.nativeElement.querySelectorAll('button[aria-label]'),
-      ) as HTMLButtonElement[];
-
-    expect(getPasswordInputs().map((input) => input.type)).toEqual(['password', 'password']);
-
-    getVisibilityButtons()[0].click();
-    fixture.detectChanges();
-
-    expect(getPasswordInputs().map((input) => input.type)).toEqual(['text', 'text']);
-    expect(getVisibilityButtons().map((button) => button.getAttribute('aria-label'))).toEqual([
-      'Ocultar contraseña',
-      'Ocultar contraseña',
-    ]);
-
-    getVisibilityButtons()[1].click();
-    fixture.detectChanges();
-
-    expect(getPasswordInputs().map((input) => input.type)).toEqual(['password', 'password']);
-  });
-
   it('rejects passwords that do not match', async () => {
     const modalService = {
       openSimple: vi.fn(),

src/app/features/store/pages/reset-password-page/reset-password-page.component.ts

@@ -49,7 +49,6 @@ export class ResetPasswordPageComponent {
   private readonly submittedState = signal(false);
   private readonly isSubmittingState = signal(false);
   private readonly serverErrorState = signal<string | null>(null);
-  private readonly passwordVisibleState = signal(false);
 
   private readonly email = this.route.snapshot.queryParamMap.get('email') ?? '';
   private readonly code = this.route.snapshot.queryParamMap.get('code') ?? '';
@@ -73,11 +72,6 @@ export class ResetPasswordPageComponent {
   protected readonly submitted = this.submittedState.asReadonly();
   protected readonly isSubmitting = this.isSubmittingState.asReadonly();
   protected readonly serverError = this.serverErrorState.asReadonly();
-  protected readonly passwordVisible = this.passwordVisibleState.asReadonly();
-
-  protected setPasswordVisibility(visible: boolean): void {
-    this.passwordVisibleState.set(visible);
-  }
 
   protected updatePassword(controlName: PasswordControlName, value: string | number): void {
     this.form.controls[controlName].setValue(String(value));

src/app/features/store/pages/search-page/search-page.component.ts

@@ -24,10 +24,7 @@ import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 
 import { CartService } from '../../../../core/services/cart/cart.service';
 import { AuthService } from '../../../../core/services/auth/auth.service';
-import {
+import { CheckoutService } from '../../../../core/services/checkout.service';
-  CheckoutService,
-  isExpiredStockReservationResponse,
-} from '../../../../core/services/checkout.service';
 import {
   CatalogFeaturedItem,
   CatalogFeaturedItems,
@@ -202,20 +199,10 @@ export class SearchPageComponent {
               ],
             },
       );
-      await this.router.navigate(['/checkout', purchase.id]);
+      await this.router.navigate(['/checkout'], { queryParams: { purchase: purchase.id } });
     } catch (error) {
       console.error('Failed to create direct purchase:', error);
-      const message =
+      this.toastService.danger('No se pudo iniciar la compra directa.');
-        error instanceof HttpErrorResponse && typeof error.error?.message === 'string'
-          ? error.error.message
-          : 'No se pudo iniciar la compra directa.';
-      this.toastService.danger(message);
-
-      if (error instanceof HttpErrorResponse && isExpiredStockReservationResponse(error.error)) {
-        this.cartService.loadCart().subscribe({
-          error: (refreshError) => console.error('Error refreshing expired cart', refreshError),
-        });
-      }
     } finally {
       this.creatingDirectPurchase.set(false);
     }

src/app/features/store/pages/store-home-page/store-home-page.component.spec.ts

@@ -13,6 +13,7 @@ import {
 } from '../../../../core/services/catalog/catalog.interface';
 import { CatalogService } from '../../../../core/services/catalog/catalog.service';
 import { CatalogAvailabilityService } from '../../../../core/services/catalog/catalog-availability.service';
+import { createCatalogAvailability } from '../../../../core/services/catalog/catalog-availability';
 import { Tenant } from '../../../../core/services/tenant.interface';
 import { TenantService } from '../../../../core/services/tenant.service';
 import { ToastService } from '../../../../core/services/toast.service';
@@ -83,6 +84,7 @@ const pageOneItems: CatalogFeaturedItem[] = [
     nombre: 'Auriculares Bluetooth',
     precio: '24999.00',
     image: '/catalog/auriculares.jpg',
+    availability: createCatalogAvailability(null),
   },
   {
     id: 2,
@@ -90,6 +92,7 @@ const pageOneItems: CatalogFeaturedItem[] = [
     nombre: 'Teclado Mecanico',
     precio: '18999.00',
     image: null,
+    availability: createCatalogAvailability(null),
   },
 ];
 
@@ -406,7 +409,14 @@ describe('StoreHomePageComponent', () => {
 
   it('requests another page for the selected featured group', async () => {
     const pageTwoItems: CatalogFeaturedItem[] = [
-      { id: 3, type: 'product', nombre: 'Mouse Gamer', precio: '15999.00', image: null },
+      {
+        id: 3,
+        type: 'product',
+        nombre: 'Mouse Gamer',
+        precio: '15999.00',
+        image: null,
+        availability: createCatalogAvailability(null),
+      },
     ];
     const catalogServiceStub = {
       getCatalog: vi.fn(),

src/app/features/store/pages/store-home-page/store-home-page.component.ts

@@ -21,7 +21,6 @@ import { TenantService } from '../../../../core/services/tenant.service';
 import { ToastService } from '../../../../core/services/toast.service';
 import {
   CheckoutService,
-  isExpiredStockReservationResponse,
   isInsufficientStockResponse,
 } from '../../../../core/services/checkout.service';
 import {
@@ -218,18 +217,10 @@ export class StoreHomePageComponent implements OnInit, OnDestroy {
         tenant.codigo,
         reservedCartId !== null ? { cart_id: reservedCartId } : { direct_items: directItems },
       );
-      await this.router.navigate(['/checkout', purchase.id]);
+      await this.router.navigate(['/checkout'], { queryParams: { purchase: purchase.id } });
     } catch (error) {
       console.error('Failed to create direct purchase:', error);
 
-      if (error instanceof HttpErrorResponse && isExpiredStockReservationResponse(error.error)) {
-        this.toastService.danger(error.error.message);
-        this.cartService.loadCart().subscribe({
-          error: (refreshError) => console.error('Error refreshing expired cart', refreshError),
-        });
-        return;
-      }
-
       if (error instanceof HttpErrorResponse && isInsufficientStockResponse(error.error)) {
         const unavailableIds = error.error.unavailable_items
           .map((item) => item.variant_id)

src/app/features/store/store.routes.ts

@@ -91,6 +91,15 @@ export const routes: Routes = [
             (m) => m.ProductDetailPageComponent,
           ),
       },
+      {
+        path: 'checkout',
+        canActivate: [authGuard, hasMenuGuard('checkout')],
+        canDeactivate: [checkoutPendingPurchaseGuard],
+        loadComponent: () =>
+          import('./pages/checkout-page/checkout-page.component').then(
+            (m) => m.CheckoutPageComponent,
+          ),
+      },
       {
         path: 'checkout/status',
         component: SimpleLayoutComponent,
@@ -104,15 +113,6 @@ export const routes: Routes = [
           },
         ],
       },
-      {
-        path: 'checkout/:id',
-        canActivate: [authGuard, hasMenuGuard('checkout')],
-        canDeactivate: [checkoutPendingPurchaseGuard],
-        loadComponent: () =>
-          import('./pages/checkout-page/checkout-page.component').then(
-            (m) => m.CheckoutPageComponent,
-          ),
-      },
       {
         path: 'ayuda',
         canActivate: [hasMenuGuard('help')],

src/app/shared/components/cart/cart.component.spec.ts

@@ -175,63 +175,6 @@ describe('CartComponent', () => {
     expect(removeItem).not.toHaveBeenCalled();
   });
 
-  it('notifies the user and refreshes the cart when a mutation reports expiration', async () => {
-    const expirationMessage = 'La reserva de stock venció. Usá el carrito activo para continuar.';
-    const removeItem = vi.fn().mockReturnValue(
-      throwError(() => ({
-        error: {
-          code: 'stock_reservation.expired',
-          message: expirationMessage,
-        },
-      })),
-    );
-    const loadCart = vi.fn().mockReturnValue(of({}));
-    const danger = vi.fn();
-
-    await TestBed.configureTestingModule({
-      imports: [CartComponent],
-      providers: [
-        {
-          provide: CartService,
-          useValue: {
-            cart: signal(null).asReadonly(),
-            loadCart,
-            updateItemQuantity: vi.fn(),
-            removeItem,
-          },
-        },
-        {
-          provide: ModalService,
-          useValue: { openConfirmDelete: vi.fn().mockReturnValue(of(true)) },
-        },
-        {
-          provide: ToastService,
-          useValue: { success: vi.fn(), info: vi.fn(), danger },
-        },
-      ],
-    }).compileComponents();
-
-    const fixture = TestBed.createComponent(CartComponent);
-    fixture.componentRef.setInput('items', [
-      {
-        cartItemId: 10,
-        imageUrl: null,
-        product: 'Producto vencido',
-        originalPrice: null,
-        discountedPrice: 1000,
-        discountPercentage: null,
-        attributes: [],
-        quantity: 1,
-      },
-    ]);
-    fixture.detectChanges();
-
-    fixture.debugElement.query(By.css('app-cart-item')).triggerEventHandler('remove');
-
-    expect(danger).toHaveBeenCalledWith(expirationMessage);
-    expect(loadCart).toHaveBeenCalledOnce();
-  });
-
   it('optimistically updates quantity and rolls back on error', async () => {
     vi.useFakeTimers();
     const updateItemQuantity = vi.fn().mockReturnValue(throwError(() => new Error('Error')));

src/app/shared/components/cart/cart.component.ts

@@ -98,12 +98,11 @@ export class CartComponent {
                     this.clearOverride(update.cartItemId);
                   },
                   error: (err: HttpErrorResponse) => {
+                    console.error('Error updating cart quantity', err);
+                    const msg =
+                      err.error?.message || 'Error al actualizar la cantidad del producto.';
+                    this.toastService.danger(msg);
                     this.clearOverride(update.cartItemId);
-                    this.handleMutationError(
-                      err,
-                      'Error al actualizar la cantidad del producto.',
-                      'Error updating cart quantity',
-                    );
                   },
                 }),
                 catchError(() => EMPTY),
@@ -206,12 +205,9 @@ export class CartComponent {
           this.toastService.success(response.message || 'Variante actualizada.');
         },
         error: (error: HttpErrorResponse) => {
+          console.error('Error updating cart item variant', error);
           this.clearVariantOverride(cartItemId);
-          this.handleMutationError(
+          this.toastService.danger(error.error?.message || 'No se pudo actualizar la variante.');
-            error,
-            'No se pudo actualizar la variante.',
-            'Error updating cart item variant',
-          );
         },
       });
   }
@@ -309,29 +305,10 @@ export class CartComponent {
         this.toastService.info(msg);
       },
       error: (err: HttpErrorResponse) => {
-        this.handleMutationError(
+        console.error('Error removing item from cart', err);
-          err,
+        const msg = err.error?.message || 'Error al eliminar el producto del carrito.';
-          'Error al eliminar el producto del carrito.',
+        this.toastService.danger(msg);
-          'Error removing item from cart',
-        );
       },
     });
   }
-
-  private handleMutationError(
-    error: HttpErrorResponse,
-    fallbackMessage: string,
-    logMessage: string,
-  ): void {
-    console.error(logMessage, error);
-    this.toastService.danger(error.error?.message || fallbackMessage);
-
-    if (error.error?.code !== 'stock_reservation.expired') {
-      return;
-    }
-
-    this.cartService.loadCart().subscribe({
-      error: (refreshError) => console.error('Error refreshing expired cart', refreshError),
-    });
-  }
 }

src/app/shared/components/product-list/product-list.component.html

@@ -12,8 +12,7 @@
           [title]="item.nombre"
           [description]="item.descripcion ?? ''"
           [price]="price(item)"
-          [maximumAddableQuantity]="item.maximum_addable_quantity ?? null"
+          [availability]="itemAvailability(item)"
-          [unavailableMessage]="item.unavailable_message ?? null"
           [variants]="item.variants ?? []"
           [saving]="savingProductIds().has(item.id)"
           (buy)="emitRowBuy(item, $event)"
@@ -25,8 +24,7 @@
           [title]="item.nombre"
           [description]="item.descripcion ?? ''"
           [price]="price(item)"
-          [maximumAddableQuantity]="item.maximum_addable_quantity ?? null"
+          [availability]="itemAvailability(item)"
-          [unavailableMessage]="item.unavailable_message ?? null"
           [variants]="item.variants ?? []"
           [saving]="savingProductIds().has(item.id)"
           (buy)="emitColumnBuy(item, $event)"
@@ -40,8 +38,8 @@
           [description]="item.descripcion ?? ''"
           [price]="price(item)"
           [imageUrl]="loadImages() ? (item.image ?? null) : null"
-          [unavailableMessage]="item.unavailable_message ?? null"
+          [unavailableMessage]="availabilityMessage(item)"
-          [disabled]="loading() || !!item.unavailable_message"
+          [disabled]="loading() || !allows(itemAvailability(item), 'buy_now')"
           (buy)="emitTicketBuy(item, $event)"
         />
       }
@@ -50,7 +48,7 @@
           [imageUrl]="loadImages() ? (item.image ?? null) : null"
           [title]="item.nombre"
           [originalPrice]="price(item)"
-          [unavailableMessage]="item.unavailable_message ?? null"
+          [unavailableMessage]="availabilityMessage(item)"
           [imagePriority]="loadImages() && index < 4"
           (buy)="emitProductDetailBuy(item)"
         />

src/app/shared/components/product-list/product-list.component.spec.ts

@@ -6,6 +6,7 @@ import { of } from 'rxjs';
 import { ApiPaginatedResponse } from '../../../core/services/api-paginated-response.interface';
 import { CartService } from '../../../core/services/cart/cart.service';
 import { CatalogService } from '../../../core/services/catalog/catalog.service';
+import { createCatalogAvailability } from '../../../core/services/catalog/catalog-availability';
 import {
   CatalogFeaturedItems,
   CatalogGroupLayout,
@@ -23,6 +24,7 @@ describe('ProductListComponent', () => {
       descripcion: 'Primera descripcion',
       precio: '100.00',
       image: '/images/one.png',
+      availability: createCatalogAvailability(null),
       variants: [],
     },
     {
@@ -32,6 +34,7 @@ describe('ProductListComponent', () => {
       descripcion: 'Segunda descripcion',
       precio: 200,
       image: null,
+      availability: createCatalogAvailability(null),
       variants: [],
     },
   ];
@@ -56,6 +59,20 @@ describe('ProductListComponent', () => {
   ) {
     const getVariantOptions = vi.fn().mockReturnValue(
       of({
+        variants: [
+          {
+            id: 401,
+            precio: '10000.00',
+            availability: createCatalogAvailability(1),
+            values: { tipo: '1', sector: '2', fila: '3', asiento: '4' },
+          },
+          {
+            id: 402,
+            precio: '12000.00',
+            availability: createCatalogAvailability(1),
+            values: { tipo: '1', sector: '2', fila: '3', asiento: '5' },
+          },
+        ],
         selectors: ['tipo', 'sector', 'fila', 'asiento'].map((key, index) => ({
           key,
           label: key,
@@ -73,7 +90,12 @@ describe('ProductListComponent', () => {
     await TestBed.configureTestingModule({
       imports: [ProductListComponent],
       providers: [
-        { provide: CatalogService, useValue: { getVariantOptions } },
+        {
+          provide: CatalogService,
+          useValue: {
+            withoutLoading: () => ({ getVariantOptions }),
+          },
+        },
         { provide: CartService, useValue: {} },
       ],
     }).compileComponents();
@@ -193,8 +215,8 @@ describe('ProductListComponent', () => {
     const itemWithVariants: ProductListItem = {
       ...items[0],
       variants: [
-        { id: 91, maximum_addable_quantity: 3, values: { fecha: '10 de octubre' } },
+        { id: 91, availability: createCatalogAvailability(3), values: { fecha: '10 de octubre' } },
-        { id: 92, maximum_addable_quantity: 4, values: { fecha: '11 de octubre' } },
+        { id: 92, availability: createCatalogAvailability(4), values: { fecha: '11 de octubre' } },
       ],
     };
     const fixture = await render('column_with_cart', [itemWithVariants]);
@@ -220,7 +242,7 @@ describe('ProductListComponent', () => {
       variants: [
         {
           id: 91,
-          maximum_addable_quantity: 2,
+          availability: createCatalogAvailability(2),
           values: { fecha: '10 de octubre' },
         },
       ],
@@ -248,7 +270,7 @@ describe('ProductListComponent', () => {
       variants: [
         {
           id: 91,
-          maximum_addable_quantity: 0,
+          availability: createCatalogAvailability(0),
           values: { fecha: '10 de octubre' },
         },
       ],
@@ -304,7 +326,7 @@ describe('ProductListComponent', () => {
         {
           id: 401,
           precio: '10000.00',
-          maximum_addable_quantity: 1,
+          availability: createCatalogAvailability(1),
           values: {
             tipo: { value: 'vip', label: 'VIP' },
             sector: { value: 'a', label: 'Sector A' },
@@ -315,7 +337,7 @@ describe('ProductListComponent', () => {
         {
           id: 402,
           precio: '12000.00',
-          maximum_addable_quantity: 1,
+          availability: createCatalogAvailability(1),
           values: {
             tipo: { value: 'vip', label: 'VIP' },
             sector: { value: 'a', label: 'Sector A' },

src/app/shared/components/product-list/product-list.component.ts

@@ -18,6 +18,11 @@ import {
   CatalogGroupLayout,
   CatalogProductLayout,
 } from '../../../core/services/catalog/catalog.interface';
+import {
+  AVAILABLE_CATALOG_AVAILABILITY,
+  allowsCatalogAction,
+  primaryAvailabilityMessage,
+} from '../../../core/services/catalog/catalog-availability';
 import { CarouselComponent } from '../carousel/carousel.component';
 import { PaginatorComponent } from '../paginator/paginator.component';
 import { ProductColumnWithImageComponent } from '../product-column-with-image/product-column-with-image.component';
@@ -74,6 +79,7 @@ export class ProductListComponent {
   readonly buy = output<ProductListBuyEvent>();
   readonly addToCart = output<ProductListCartEvent>();
   readonly pageChange = output<number>();
+  protected readonly allows = allowsCatalogAction;
 
   protected readonly effectiveLayout = computed<ProductListLayout>(() =>
     this.mobile() && this.layout() === 'row' ? 'column_with_cart' : this.layout(),
@@ -108,6 +114,14 @@ export class ProductListComponent {
     return Number.isFinite(price) ? price : 0;
   }
 
+  protected availabilityMessage(item: ProductListItem): string | null {
+    return primaryAvailabilityMessage(this.itemAvailability(item));
+  }
+
+  protected itemAvailability(item: ProductListItem) {
+    return item.availability ?? AVAILABLE_CATALOG_AVAILABILITY;
+  }
+
   protected emitRowCart(
     product: ProductListItem,
     event: { quantity: number; variant: unknown },

src/app/shared/components/product-row-card/product-row-card.component.html

@@ -21,13 +21,14 @@
         <app-variant-selector
           class="product-row-card__selectors"
           [variants]="variants()"
+          [disabled]="!allows(availability(), 'select_variant')"
           [(selectedVariant)]="selectedVariant"
         />
 
         <app-quantity-selector
           [(quantity)]="quantity"
           [max]="effectiveMaximum()"
-          [disabled]="unavailable()"
+          [disabled]="!allows(effectiveAvailability(), 'change_quantity')"
         />
       </div>
 
@@ -38,14 +39,22 @@
 
     <div class="product-row-card__buttons">
       <div class="product-row-card__btn-wrapper">
-        <app-button variant="primary" [disabled]="unavailable()" (click)="onBuy()">
+        <app-button
+          variant="primary"
+          [disabled]="!hasPurchasableSelection() || !allows(effectiveAvailability(), 'buy_now')"
+          (click)="onBuy()"
+        >
           Comprar
         </app-button>
       </div>
       <div class="product-row-card__btn-wrapper">
         <app-button
           variant="secondary"
-          [disabled]="saving() || unavailable()"
+          [disabled]="
+            saving() ||
+            !hasPurchasableSelection() ||
+            !allows(effectiveAvailability(), 'add_to_cart')
+          "
           (click)="onAddToCart()"
         >
           {{ saving() ? 'Guardando' : 'Agregar al carrito' }}

src/app/shared/components/product-row-card/product-row-card.component.ts

@@ -14,13 +14,20 @@ import {
   VariantSelectorComponent,
   VariantSelectorVariant,
 } from '../variant-selector/variant-selector.component';
+import { CatalogAvailability } from '../../../core/services/catalog/catalog.interface';
+import {
+  AVAILABLE_CATALOG_AVAILABILITY,
+  allowsCatalogAction,
+  combineCatalogAvailability,
+  maximumCatalogQuantity,
+  primaryAvailabilityMessage,
+} from '../../../core/services/catalog/catalog-availability';
 
 export interface Variant extends VariantSelectorVariant {
   label?: string;
   descripcion?: string | null;
   precio?: string | number;
-  maximum_addable_quantity?: number | null;
+  availability?: CatalogAvailability;
-  unavailable_message?: string | null;
 }
 
 @Component({
@@ -36,8 +43,7 @@ export class ProductRowCardComponent {
   readonly title = input<string>('');
   readonly description = input<string>('');
   readonly price = input<number>(0);
-  readonly maximumAddableQuantity = input<number | null>(null);
+  readonly availability = input<CatalogAvailability>(AVAILABLE_CATALOG_AVAILABILITY);
-  readonly unavailableMessage = input<string | null>(null);
   readonly variants = input<Variant[]>([]);
   readonly saving = input(false);
 
@@ -60,19 +66,22 @@ export class ProductRowCardComponent {
 
     return Number.isFinite(variantPrice) ? variantPrice : this.price();
   });
-  protected readonly effectiveMaximum = computed(
+  protected readonly effectiveAvailability = computed(() =>
-    () => this.selectedVariantData()?.maximum_addable_quantity ?? this.maximumAddableQuantity(),
+    combineCatalogAvailability(this.availability(), this.selectedVariantData()?.availability),
+  );
+  protected readonly hasVariants = computed(() => this.variants().length > 0);
+  protected readonly hasPurchasableSelection = computed(
+    () => !this.hasVariants() || this.selectedVariantData() !== undefined,
+  );
+  protected readonly effectiveMaximum = computed(() =>
+    maximumCatalogQuantity(this.effectiveAvailability()),
+  );
+  protected readonly effectiveUnavailableMessage = computed(() =>
+    primaryAvailabilityMessage(this.effectiveAvailability()),
   );
-  protected readonly unavailable = computed(() => this.effectiveMaximum() === 0);
-  protected readonly effectiveUnavailableMessage = computed(() => {
-    const selectedVariant = this.selectedVariantData();
-
-    return selectedVariant
-      ? (selectedVariant.unavailable_message ?? null)
-      : this.unavailableMessage();
-  });
 
   readonly formattedPrice = computed(() => this.formatCurrency(this.effectivePrice()));
+  protected readonly allows = allowsCatalogAction;
 
   constructor() {
     effect(() => {
@@ -85,7 +94,11 @@ export class ProductRowCardComponent {
   }
 
   protected onAddToCart(): void {
-    if (this.saving() || this.unavailable()) {
+    if (
+      this.saving() ||
+      !this.hasPurchasableSelection() ||
+      !this.allows(this.effectiveAvailability(), 'add_to_cart')
+    ) {
       return;
     }
 
@@ -96,7 +109,8 @@ export class ProductRowCardComponent {
   }
 
   protected onBuy(): void {
-    if (this.unavailable()) return;
+    if (!this.hasPurchasableSelection() || !this.allows(this.effectiveAvailability(), 'buy_now'))
+      return;
 
     this.buy.emit({
       quantity: this.quantity(),

src/app/shared/components/product-ticket-selector/product-ticket-selector.component.ts

@@ -23,6 +23,10 @@ import {
   CatalogVariantSelector,
   CatalogVariantValue,
 } from '../../../core/services/catalog/catalog.interface';
+import {
+  allowsCatalogAction,
+  createCatalogAvailability,
+} from '../../../core/services/catalog/catalog-availability';
 import { CatalogService } from '../../../core/services/catalog/catalog.service';
 import { ModalService } from '../../../core/services/modal.service';
 import { ToastService } from '../../../core/services/toast.service';
@@ -353,7 +357,11 @@ export class ProductTicketSelectorComponent {
     if (reservedVariant !== null && !variants.some(({ id }) => id === reservedVariant.id)) {
       variants.push(reservedVariant);
     }
-    return variants.filter(({ id }) => !reservedByOtherRows.has(id));
+    return variants.filter(
+      ({ id, availability }) =>
+        (availability === undefined || allowsCatalogAction(availability, 'select_variant')) &&
+        !reservedByOtherRows.has(id),
+    );
   }
 
   private reservedVariantData(row: TicketSelectionRow): CatalogFeaturedItemVariant | null {
@@ -363,7 +371,9 @@ export class ProductTicketSelectorComponent {
     return {
       id: item.variant.id,
       precio: item.variant.precio,
-      maximum_addable_quantity: item.variant.stock_tecnico,
+      availability: createCatalogAvailability(
+        item.variant.stock_tecnico === null ? null : item.variant.stock_tecnico + item.cantidad,
+      ),
       values: item.variant.values,
     };
   }

src/app/shared/components/product-vertical-with-cart-card/product-vertical-with-cart-card.component.html

@@ -19,7 +19,7 @@
         <app-quantity-selector
           [(quantity)]="quantity"
           [max]="effectiveMaximum()"
-          [disabled]="unavailable()"
+          [disabled]="!allows(effectiveAvailability(), 'change_quantity')"
         />
       </div>
     } @else {
@@ -29,12 +29,16 @@
           <app-quantity-selector
             [(quantity)]="quantity"
             [max]="effectiveMaximum()"
-            [disabled]="unavailable()"
+            [disabled]="!allows(effectiveAvailability(), 'change_quantity')"
           />
         </div>
 
         <div class="product-vertical-with-cart-card__variant-selectors">
-          <app-variant-selector [variants]="variants()" [(selectedVariant)]="selectedVariant" />
+          <app-variant-selector
+            [variants]="variants()"
+            [disabled]="!allows(availability(), 'select_variant')"
+            [(selectedVariant)]="selectedVariant"
+          />
         </div>
       </div>
     }
@@ -42,14 +46,21 @@
     <div class="product-vertical-with-cart-card__actions">
       <app-button
         variant="primary"
-        [disabled]="unavailable() || (hasVariants() && selectedVariant() === null)"
+        [disabled]="
+          !allows(effectiveAvailability(), 'buy_now') ||
+          (hasVariants() && selectedVariant() === null)
+        "
         (click)="onBuy()"
       >
         Comprar
       </app-button>
       <app-button
         variant="secondary"
-        [disabled]="saving() || unavailable() || (hasVariants() && selectedVariant() === null)"
+        [disabled]="
+          saving() ||
+          !allows(effectiveAvailability(), 'add_to_cart') ||
+          (hasVariants() && selectedVariant() === null)
+        "
         (click)="onAddToCart()"
       >
         {{ saving() ? 'Guardando' : 'Agregar al carrito' }}

src/app/shared/components/product-vertical-with-cart-card/product-vertical-with-cart-card.component.spec.ts

@@ -58,11 +58,17 @@ describe('ProductVerticalWithCartCardComponent', () => {
 
   it('shows the backend availability message with the reusable tooltip', async () => {
     const fixture = await createComponent();
-    fixture.componentRef.setInput('maximumAddableQuantity', 0);
+    fixture.componentRef.setInput('availability', {
-    fixture.componentRef.setInput(
+      state: 'visible',
-      'unavailableMessage',
+      maximum_quantity: 0,
-      'Alcanzaste el cupo máximo permitido para este producto.',
+      reasons: [
-    );
+        {
+          code: 'user_quota_reached',
+          message: 'Alcanzaste el cupo máximo permitido para este producto.',
+        },
+      ],
+      allowed_actions: [],
+    });
     fixture.detectChanges();
 
     const tooltip = (fixture.nativeElement as HTMLElement).querySelector('app-tooltip');

src/app/shared/components/product-vertical-with-cart-card/product-vertical-with-cart-card.component.ts

@@ -15,12 +15,19 @@ import {
   VariantSelectorComponent,
   VariantSelectorVariant,
 } from '../variant-selector/variant-selector.component';
+import { CatalogAvailability } from '../../../core/services/catalog/catalog.interface';
+import {
+  AVAILABLE_CATALOG_AVAILABILITY,
+  allowsCatalogAction,
+  combineCatalogAvailability,
+  maximumCatalogQuantity,
+  primaryAvailabilityMessage,
+} from '../../../core/services/catalog/catalog-availability';
 
 export interface VerticalCartVariant extends VariantSelectorVariant {
   descripcion?: string | null;
   precio?: string | number;
-  maximum_addable_quantity?: number | null;
+  availability?: CatalogAvailability;
-  unavailable_message?: string | null;
 }
 
 @Component({
@@ -34,8 +41,7 @@ export class ProductVerticalWithCartCardComponent {
   readonly title = input<string>('');
   readonly description = input<string>('');
   readonly price = input<number>(0);
-  readonly maximumAddableQuantity = input<number | null>(null);
+  readonly availability = input<CatalogAvailability>(AVAILABLE_CATALOG_AVAILABILITY);
-  readonly unavailableMessage = input<string | null>(null);
   readonly variants = input<VerticalCartVariant[]>([]);
   readonly saving = input(false);
 
@@ -58,17 +64,16 @@ export class ProductVerticalWithCartCardComponent {
   });
   protected readonly formattedPrice = computed(() => this.formatCurrency(this.effectivePrice()));
   protected readonly hasVariants = computed(() => this.variants().length > 0);
-  protected readonly effectiveMaximum = computed(
+  protected readonly effectiveAvailability = computed(() =>
-    () => this.selectedVariantData()?.maximum_addable_quantity ?? this.maximumAddableQuantity(),
+    combineCatalogAvailability(this.availability(), this.selectedVariantData()?.availability),
   );
-  protected readonly unavailable = computed(() => this.effectiveMaximum() === 0);
+  protected readonly effectiveMaximum = computed(() =>
-  protected readonly effectiveUnavailableMessage = computed(() => {
+    maximumCatalogQuantity(this.effectiveAvailability()),
-    const selectedVariant = this.selectedVariantData();
+  );
-
+  protected readonly effectiveUnavailableMessage = computed(() =>
-    return selectedVariant
+    primaryAvailabilityMessage(this.effectiveAvailability()),
-      ? (selectedVariant.unavailable_message ?? null)
+  );
-      : this.unavailableMessage();
+  protected readonly allows = allowsCatalogAction;
-  });
 
   constructor() {
     effect(() => {
@@ -81,7 +86,7 @@ export class ProductVerticalWithCartCardComponent {
   }
 
   protected onAddToCart(): void {
-    if (this.saving() || this.unavailable()) {
+    if (this.saving() || !this.allows(this.effectiveAvailability(), 'add_to_cart')) {
       return;
     }
 
@@ -89,7 +94,7 @@ export class ProductVerticalWithCartCardComponent {
   }
 
   protected onBuy(): void {
-    if (this.unavailable()) return;
+    if (!this.allows(this.effectiveAvailability(), 'buy_now')) return;
 
     this.buy.emit({ quantity: this.quantity(), variant: this.selectedVariant() });
   }

src/app/shared/components/variant-selector/variant-selector.component.spec.ts

@@ -62,6 +62,8 @@ describe('VariantSelectorComponent', () => {
     ]);
     fixture.componentRef.setInput('selectedVariant', 2);
     fixture.detectChanges();
+    await fixture.whenStable();
+    fixture.detectChanges();
 
     const selects = Array.from(
       fixture.nativeElement.querySelectorAll('select'),
@@ -80,6 +82,28 @@ describe('VariantSelectorComponent', () => {
     expect(fixture.componentInstance.selectedVariant()).toBe(1);
   });
 
+  it('does not offer variants whose availability forbids selection', async () => {
+    await TestBed.configureTestingModule({
+      imports: [VariantSelectorComponent],
+    }).compileComponents();
+    const fixture = TestBed.createComponent(VariantSelectorComponent);
+    fixture.componentRef.setInput('variants', [
+      { id: 1, values: { talle: 'S' } },
+      {
+        id: 2,
+        values: { talle: 'M' },
+        availability: { state: 'visible', maximum_quantity: 0, allowed_actions: [], reasons: [] },
+      },
+    ]);
+    fixture.detectChanges();
+    await fixture.whenStable();
+    fixture.detectChanges();
+
+    expect(fixture.nativeElement.textContent).toContain('S');
+    expect(fixture.nativeElement.textContent).not.toContain('M');
+    expect(fixture.componentInstance.selectedVariant()).toBe(1);
+  });
+
   it('requires manual selections when autoSelectFirst is disabled', async () => {
     await TestBed.configureTestingModule({
       imports: [VariantSelectorComponent],

src/app/shared/components/variant-selector/variant-selector.component.ts

@@ -10,6 +10,8 @@ import {
   untracked,
 } from '@angular/core';
 import { FormsModule } from '@angular/forms';
+import { CatalogAvailability } from '../../../core/services/catalog/catalog.interface';
+import { allowsCatalogAction } from '../../../core/services/catalog/catalog-availability';
 
 export interface VariantAttributeOption {
   value: string;
@@ -22,6 +24,7 @@ export type VariantAttributeValue = VariantAttributeScalar | VariantAttributeSca
 export interface VariantSelectorVariant {
   id: unknown;
   values: Record<string, VariantAttributeValue>;
+  availability?: CatalogAvailability;
 }
 
 export interface VariantSelectorSelectionChange {
@@ -64,10 +67,12 @@ export class VariantSelectorComponent {
     right: VariantAttributeValue | null,
   ): boolean => left !== null && right !== null && this.sameValue(left, right);
   protected readonly attributeKeys = computed(() =>
-    Array.from(new Set(this.variants().flatMap((variant) => Object.keys(variant.values)))),
+    Array.from(
+      new Set(this.getSelectableVariants().flatMap((variant) => Object.keys(variant.values))),
+    ),
   );
   protected readonly selectors = computed<VariantSelectorGroup[]>(() => {
-    const variants = this.variants();
+    const variants = this.getSelectableVariants();
     const keys = this.attributeKeys();
     const selectedValues = this.selectedValues();
 
@@ -110,7 +115,7 @@ export class VariantSelectorComponent {
     });
 
     effect(() => {
-      const variants = this.variants();
+      const variants = this.getSelectableVariants();
       const selectedVariant = this.selectedVariant();
       const autoSelectFirst = this.autoSelectFirst();
 
@@ -139,7 +144,7 @@ export class VariantSelectorComponent {
   }
 
   protected onValueChange(key: string, value: VariantAttributeValue | null): void {
-    const variants = this.variants();
+    const variants = this.getSelectableVariants();
     const keys = this.attributeKeys();
     const changedIndex = keys.indexOf(key);
     const values = { ...this.selectedValues() };
@@ -198,6 +203,14 @@ export class VariantSelectorComponent {
     return Array.from(options.values());
   }
 
+  private getSelectableVariants(): VariantSelectorVariant[] {
+    return this.variants().filter(
+      (variant) =>
+        variant.availability === undefined ||
+        allowsCatalogAction(variant.availability, 'select_variant'),
+    );
+  }
+
   private reconcileManualSelection(
     selectedValues: Record<string, VariantAttributeValue>,
     variants: VariantSelectorVariant[],

src/environments/environment.homo.ts

@@ -1,5 +1,5 @@
 export const environment = {
-  production: true,
+  production: false,
   nombre:"Homologación - activo",
   url:"https://backend.qa.shopit.com.ar/api/",
   urlDescarga:"url/"

src/index.html

@@ -5,7 +5,7 @@
   <title>ShopitFront</title>
   <base href="/">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg'/%3E">
+  <link rel="icon" type="image/x-icon" href="favicon.ico">
 </head>
 <body>
   <app-root></app-root>