Merge branch 'fix/zoom_block' of https://gitea.quo.ar/tbianchini/shopit-front into fix/zoom_block

commit 38d03588b1
Merge: 8e987d0 6f4aa3b
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 26 10:25:23 2026 -0300

    Merge branch 'fix/cart-expiration-notification' of https://gitea.quo.ar/tbianchini/shopit-front into fix/cart-expiration-notification

commit 8e987d0ce6
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 26 10:02:26 2026 -0300

    fix(purchase-status): clear cart on approved purchase

commit e171b9a233
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 17:06:07 2026 -0300

    refactor(checkout): use purchase id route segment

commit 643d43adea
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 17:05:59 2026 -0300

    fix(checkout): handle expired purchase exits

commit d89d01b511
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 16:47:17 2026 -0300

    fix(checkout): refresh expired carts

commit eeb245209b
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 16:46:12 2026 -0300

    fix(checkout): show backend start errors

commit 9d3754c2d8
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 16:33:44 2026 -0300

    fix(cart): refresh state after expiration

commit 6f4aa3b1bd
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 26 10:02:26 2026 -0300

    fix(purchase-status): clear cart on approved purchase

commit 2b342ec235
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 17:06:07 2026 -0300

    refactor(checkout): use purchase id route segment

commit d06b146104
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 17:05:59 2026 -0300

    fix(checkout): handle expired purchase exits

commit f4e0a9e028
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 16:47:17 2026 -0300

    fix(checkout): refresh expired carts

commit 8c2b738806
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 16:46:12 2026 -0300

    fix(checkout): show backend start errors

commit 1362d0c163
Author: ncoronel <ncoronel@quo.ar>
Date:   Tue Aug 25 16:33:44 2026 -0300

    fix(cart): refresh state after expiration

src/app/app.routes.spec.ts

@@ -7,6 +7,7 @@ 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';
@@ -97,6 +98,21 @@ 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();
@@ -246,15 +262,33 @@ describe('app routes', () => {
     expect(compiled.textContent).toContain('No encontramos una tienda para este dominio');
   });
 
-  it('redirects unauthenticated users from /checkout to /login', async () => {
-    const { router } = await renderAppAt('/checkout', createTenantServiceStub(), createAuthServiceStub(false));
+  it('redirects unauthenticated users from /checkout/:id to /login', async () => {
+    const { router } = await renderAppAt('/checkout/25', createTenantServiceStub(), createAuthServiceStub(false));
 
-    expect(router.url).toBe('/login?returnUrl=%2Fcheckout');
+    expect(router.url).toBe('/login?returnUrl=%2Fcheckout%2F25');
   });
 
-  it('allows authenticated users to access /checkout', async () => {
-    const { router } = await renderAppAt('/checkout', createTenantServiceStub(), createAuthServiceStub(true));
+  it('allows authenticated users to access /checkout/:id', async () => {
+    const checkoutTenant = {
+      ...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');
+    expect(router.url).toBe('/checkout/25');
   });
 });

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('favicon.ico');
+      .toBe("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg'/%3E");
   });
 });

src/app/app.ts

@@ -9,6 +9,8 @@ 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;
@@ -66,7 +68,7 @@ export class App {
     effect(() => {
       const tenant = this.tenantService.tenant();
       const siteTitle = tenant?.site_title?.trim() || 'ShopitFront';
-      const faviconHref = tenant?.favicon || 'favicon.ico';
+      const faviconHref = tenant?.favicon || EMPTY_FAVICON;
 
       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', tenant);
+    const result = runGuard('checkout', '/checkout/25', tenant);
 
     expect(result instanceof UrlTree).toBe(true);
     expect(TestBed.inject(Router).serializeUrl(result as UrlTree)).toBe('/');

src/app/core/layout/store-layout/store-header/store-header.component.html

@@ -152,9 +152,9 @@
     </div>
   </div>
 
-  @if (displayCategories()) {
-    <div class="store-layout__categories d-none d-md-block">
-      <div class="container-xl px-3 px-md-4">
+  <div class="store-layout__categories d-none d-md-block">
+    <div class="container-xl h-100 px-3 px-md-4 d-flex align-items-center">
+      @if (displayCategories()) {
         <div class="store-layout__category-menu">
           <button
             type="button"
@@ -175,7 +175,18 @@
             (categorySelect)="onCategorySelect($event)"
           />
         </div>
-      </div>
+      }
+
+      @if (checkoutRemainingTime(); as remainingTime) {
+        <div
+          class="store-layout__checkout-timer ms-auto d-none d-md-flex align-items-baseline gap-3"
+          role="timer"
+          aria-label="Tiempo restante de compra"
+        >
+          <span class="store-layout__checkout-timer-label">Tiempo restante de compra:</span>
+          <span class="store-layout__checkout-timer-value">{{ remainingTime }}</span>
+        </div>
+      }
     </div>
-  }
+  </div>
 </header>

src/app/core/layout/store-layout/store-header/store-header.component.scss

@@ -10,6 +10,26 @@
   border-bottom: 1px solid var(--border-color);
 }
 
+.store-layout__categories {
+  height: 3.5rem;
+}
+
+.store-layout__checkout-timer {
+  color: var(--tenant-primary);
+  font-weight: 700;
+  white-space: nowrap;
+}
+
+.store-layout__checkout-timer-label {
+  font-size: 13px;
+}
+
+.store-layout__checkout-timer-value {
+  font-size: 20px;
+  line-height: 1;
+  font-variant-numeric: tabular-nums;
+}
+
 .store-layout__brand-slot {
   min-width: 150px;
 }

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

@@ -1,4 +1,13 @@
-import { Component, ElementRef, HostListener, inject, input, output, signal } from '@angular/core';
+import {
+  Component,
+  computed,
+  ElementRef,
+  HostListener,
+  inject,
+  input,
+  output,
+  signal,
+} from '@angular/core';
 import { Router, RouterLink } from '@angular/router';
 import { AuthUser } from '../../../services/auth/auth.interfaces';
 import { CartIconComponent } from '../../../../shared/components/cart-icon/cart-icon.component';
@@ -40,6 +49,7 @@ export class StoreHeaderComponent {
   readonly displaySeachBar = input(true);
   readonly displayCart = input(true);
   readonly cartDisabled = input(false);
+  readonly checkoutRemainingSeconds = input<number | null>(null);
   readonly cartClick = output<void>();
   readonly ticketsClick = output<void>();
   readonly loginClick = output<void>();
@@ -53,6 +63,18 @@ export class StoreHeaderComponent {
   protected readonly minSearchLength = 3;
   protected readonly showSearchError = signal(false);
   protected readonly searchControl = new FormControl('', { nonNullable: true });
+  protected readonly checkoutRemainingTime = computed(() => {
+    const remainingSeconds = this.checkoutRemainingSeconds();
+
+    if (remainingSeconds === null) {
+      return null;
+    }
+
+    const minutes = Math.floor(remainingSeconds / 60);
+    const seconds = remainingSeconds % 60;
+
+    return `${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}`;
+  });
 
   protected onCartClick(): void {
     if (this.cartDisabled()) {

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

@@ -13,6 +13,7 @@
     [displaySeachBar]="tenant()?.display_seach_bar ?? true"
     [displayCart]="displayCart()"
     [cartDisabled]="isCheckoutRoute()"
+    [checkoutRemainingSeconds]="checkoutRemainingSeconds()"
     (cartClick)="onCartClick()"
     (ticketsClick)="onTicketsClick()"
     (loginClick)="onLoginClick()"

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

@@ -1,5 +1,7 @@
 :host {
   display: flex;
+  width: 100%;
+  min-width: 0;
   min-height: 100dvh;
   background: #f5f5f5;
   color: #202020;
@@ -7,6 +9,8 @@
 
 .store-layout {
   position: relative;
+  width: 100%;
+  min-width: 0;
 }
 
 .store-layout__cart-overlay {

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

@@ -1,5 +1,6 @@
 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 {
@@ -23,6 +24,7 @@ import { AuthUser } from '../../services/auth/auth.interfaces';
 import { StoreLayoutComponent } from './store-layout.component';
 import { StoreHeaderComponent } from './store-header/store-header.component';
 import { CheckoutService } from '../../services/checkout.service';
+import { CheckoutCountdownService } from '../../services/checkout-countdown.service';
 import { TenantUrlSerializer } from '../../services/tenant-url.serializer';
 
 const tenant: Tenant = {
@@ -149,6 +151,7 @@ describe('StoreLayoutComponent', () => {
   let tenantState = signal<Tenant | null>(tenant);
   let cartState = signal<Cart | null>(null);
   let authUserState = signal<AuthUser | null>(null);
+  let checkoutRemainingSecondsState = signal<number | null>(null);
   let checkoutServiceStub: { startCheckout: ReturnType<typeof vi.fn> };
   let queryParamMapState: BehaviorSubject<ParamMap>;
 
@@ -156,6 +159,7 @@ describe('StoreLayoutComponent', () => {
     tenantState = signal<Tenant | null>(tenant);
     cartState = signal<Cart | null>(null);
     authUserState = signal<AuthUser | null>(null);
+    checkoutRemainingSecondsState = signal<number | null>(null);
     queryParamMapState = new BehaviorSubject(convertToParamMap({}));
     const isAuthenticatedState = signal(false);
     checkoutServiceStub = {
@@ -214,6 +218,12 @@ describe('StoreLayoutComponent', () => {
           provide: CheckoutService,
           useValue: checkoutServiceStub,
         },
+        {
+          provide: CheckoutCountdownService,
+          useValue: {
+            remainingSeconds: checkoutRemainingSecondsState.asReadonly(),
+          },
+        },
       ],
     }).compileComponents();
   });
@@ -246,7 +256,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?purchase=25');
+    vi.spyOn(router, 'url', 'get').mockReturnValue('/fiesta/checkout/25');
 
     const fixture = TestBed.createComponent(StoreLayoutComponent);
     fixture.detectChanges();
@@ -270,6 +280,22 @@ describe('StoreLayoutComponent', () => {
     expect(element.querySelector('.store-layout__cart-overlay')).toBeNull();
   });
 
+  it('shows the synchronized countdown in the header whenever one is active', () => {
+    checkoutRemainingSecondsState.set(587);
+
+    const fixture = TestBed.createComponent(StoreLayoutComponent);
+    fixture.detectChanges();
+
+    const element = fixture.nativeElement as HTMLElement;
+
+    expect(element.querySelector('.store-layout__checkout-timer-label')?.textContent).toContain(
+      'Tiempo restante de compra:',
+    );
+    expect(element.querySelector('.store-layout__checkout-timer-value')?.textContent?.trim()).toBe(
+      '09:47',
+    );
+  });
+
   it('hides the configured header elements when the tenant disables them', () => {
     tenantState.set({
       ...tenant,
@@ -587,7 +613,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?purchase=25');
+    vi.spyOn(router, 'url', 'get').mockReturnValue('/checkout/25');
     const navigateSpy = vi.spyOn(router, 'navigate').mockResolvedValue(true);
 
     const fixture = TestBed.createComponent(StoreLayoutComponent);
@@ -674,12 +700,44 @@ describe('StoreLayoutComponent', () => {
     expect(checkoutServiceStub.startCheckout).toHaveBeenCalledWith('test', {
       cart_id: 1,
     });
-    expect(router.navigate).toHaveBeenCalledWith(['/checkout'], {
-      queryParams: { purchase: 55 },
-    });
+    expect(router.navigate).toHaveBeenCalledWith(['/checkout', 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,3 +1,4 @@
+import { HttpErrorResponse } from '@angular/common/http';
 import { Component, computed, DestroyRef, inject, OnInit, signal } from '@angular/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import {
@@ -17,9 +18,13 @@ 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 { CheckoutService } from '../../services/checkout.service';
+import {
+  CheckoutService,
+  isExpiredStockReservationResponse,
+} from '../../services/checkout.service';
 import { ToastService } from '../../services/toast.service';
 import { Category } from '../../services/tenant.interface';
+import { CheckoutCountdownService } from '../../services/checkout-countdown.service';
 
 @Component({
   selector: 'app-store-layout',
@@ -38,6 +43,7 @@ export class StoreLayoutComponent implements OnInit {
   private readonly cartService = inject(CartService);
   private readonly authService = inject(AuthService);
   private readonly checkoutService = inject(CheckoutService);
+  private readonly checkoutCountdownService = inject(CheckoutCountdownService);
   private readonly toastService = inject(ToastService);
   private readonly router = inject(Router);
   private readonly route = inject(ActivatedRoute);
@@ -45,6 +51,7 @@ export class StoreLayoutComponent implements OnInit {
 
   protected readonly isCartOpen = signal(false);
   protected readonly isCheckoutRoute = signal(this.isCheckoutUrl(this.router.url));
+  protected readonly checkoutRemainingSeconds = this.checkoutCountdownService.remainingSeconds;
   protected readonly isCreatingPurchase = signal(false);
   protected readonly displayCart = computed(() => this.tenant()?.display_cart ?? true);
   protected readonly cartEditingPolicy = computed(() => this.tenant()?.cart_editing_policy ?? null);
@@ -273,12 +280,20 @@ export class StoreLayoutComponent implements OnInit {
       });
 
       this.isCartOpen.set(false);
-      await this.router.navigate(['/checkout'], {
-        queryParams: { purchase: purchase.id },
-      });
+      await this.router.navigate(['/checkout', purchase.id]);
     } catch (error) {
       console.error('Failed to create cart purchase:', error);
-      this.toastService.danger('No se pudo iniciar la compra.');
+      const message =
+        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(true).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?mode=direct' } as never),
+      authGuard(null as never, { url: '/checkout/25' } as never),
     );
 
     expect(result instanceof UrlTree).toBe(true);
     expect(TestBed.inject(Router).serializeUrl(result as UrlTree)).toBe(
-      '/login?returnUrl=%2Fcheckout%3Fmode%3Ddirect',
+      '/login?returnUrl=%2Fcheckout%2F25',
     );
   });
 
@@ -39,7 +39,7 @@ describe('auth guards', () => {
     });
 
     const result = TestBed.runInInjectionContext(() =>
-      authGuard(null as never, { url: '/checkout' } as never),
+      authGuard(null as never, { url: '/checkout/25' } as never),
     );
 
     expect(result).toBe(true);

src/app/core/services/cart/cart.service.spec.ts

@@ -83,6 +83,20 @@ describe('CartService', () => {
     req.flush({ data: mockCart });
   });
 
+  it('refreshes catalog availability only after the expired cart has been reloaded', () => {
+    const availabilityChanged = vi.fn();
+    catalogAvailabilityService.availabilityChanged$.subscribe(availabilityChanged);
+
+    service.loadCart(true).subscribe();
+
+    expect(availabilityChanged).not.toHaveBeenCalled();
+    const req = httpMock.expectOne('http://api.test/tenants/acme/cart');
+    req.flush({ data: mockCart });
+
+    expect(service.cart()).toEqual(mockCart);
+    expect(availabilityChanged).toHaveBeenCalledOnce();
+  });
+
   it('propagates a custom loading mode to the request context', () => {
     service.withCustomLoading().loadCart().subscribe();
 

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

@@ -34,14 +34,19 @@ export class CartService extends BaseApiService {
     });
   }
 
-  loadCart(): Observable<Cart> {
+  loadCart(refreshCatalogAvailability = false): Observable<Cart> {
     return this.http
       .get<ApiResponse<Cart>>(`${this.tenantApiUrl}/cart`, {
         withCredentials: true,
       })
       .pipe(
         map((response) => response.data),
-        tap((cart) => this.cartState.set(cart)),
+        tap((cart) => {
+          this.cartState.set(cart);
+          if (refreshCatalogAvailability) {
+            this.catalogAvailabilityService.notifyAvailabilityChanged();
+          }
+        }),
       );
   }
 

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

@@ -1,59 +0,0 @@
-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

@@ -1,80 +0,0 @@
-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,25 +49,6 @@ 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;
@@ -85,7 +66,8 @@ export interface CatalogItemVariant {
   event_date_id?: number | null;
   event_date_ids?: number[];
   event_dates?: string[];
-  availability: CatalogAvailability;
+  maximum_addable_quantity?: number | null;
+  unavailable_message?: string | null;
   minimum_use_date?: string | null;
   maximum_use_date?: string | null;
   effective_minimum_use_date?: string | null;
@@ -117,7 +99,7 @@ export interface CatalogItemDetail {
   attributes: ProductAttribute[];
   variants: CatalogItemVariant[];
   selected_variant?: SelectedCatalogItemVariant;
-  availability: CatalogAvailability;
+  maximum_addable_quantity?: number | null;
   images?: string[];
 }
 
@@ -132,7 +114,8 @@ export interface CatalogFeaturedItemVariant {
   id: number;
   descripcion?: string | null;
   precio?: string;
-  availability: CatalogAvailability;
+  maximum_addable_quantity?: number | null;
+  unavailable_message?: string | null;
   values: Record<string, CatalogVariantValue>;
 }
 
@@ -164,7 +147,8 @@ export interface CatalogFeaturedItem {
   descripcion?: string | null;
   precio: number | string;
   image?: string | null;
-  availability: CatalogAvailability;
+  maximum_addable_quantity?: number | null;
+  unavailable_message?: string | null;
   variants?: CatalogFeaturedItemVariant[];
 }
 

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

@@ -14,7 +14,6 @@ import {
   CatalogItemDetail,
   CatalogVariantOptionsResponse,
   CategoryItemsResponse,
-  Product,
 } from './catalog.interface';
 
 type HttpParamValue = string | number | boolean | readonly (string | number | boolean)[];
@@ -33,12 +32,6 @@ export class CatalogService extends BaseApiService {
     return this.tenantService.getTenantApiUrl();
   }
 
-  getProductos(params?: ApiPaginationQueryParams): Observable<ApiPaginatedResponse<Product[]>> {
-    return this.http.get<ApiPaginatedResponse<Product[]>>(`${this.tenantApiUrl}/productos`, {
-      params: this.buildHttpParams(params),
-    });
-  }
-
   getCatalog(): Observable<CatalogFeaturedGroup[]> {
     return this.http.get<CatalogFeaturedGroup[]>(`${this.tenantApiUrl}/catalog`);
   }

src/app/core/services/checkout-countdown.service.spec.ts

@@ -0,0 +1,69 @@
+import { TestBed } from '@angular/core/testing';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { CheckoutCountdownService } from './checkout-countdown.service';
+
+describe('CheckoutCountdownService', () => {
+  let service: CheckoutCountdownService;
+
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.setSystemTime(new Date('2026-08-27T12:00:00.000Z'));
+    TestBed.configureTestingModule({ providers: [CheckoutCountdownService] });
+    service = TestBed.inject(CheckoutCountdownService);
+  });
+
+  afterEach(() => {
+    service.clear();
+    vi.useRealTimers();
+  });
+
+  it('counts down from the checkout server timing without depending on the client clock', () => {
+    service.synchronize({
+      expires_at: '2026-08-27T15:10:00.000Z',
+      expires_in_seconds: 600,
+      server_time: '2026-08-27T15:00:00.000Z',
+    });
+
+    expect(service.remainingSeconds()).toBe(600);
+
+    vi.advanceTimersByTime(1_000);
+
+    expect(service.remainingSeconds()).toBe(599);
+  });
+
+  it('recalculates against the deadline after a delayed browser interval', () => {
+    service.synchronize({
+      expires_at: null,
+      expires_in_seconds: 10,
+      server_time: '2026-08-27T15:00:00.000Z',
+    });
+
+    vi.setSystemTime(new Date('2026-08-27T12:00:07.000Z'));
+    vi.advanceTimersByTime(1_000);
+
+    expect(service.remainingSeconds()).toBe(2);
+  });
+
+  it('clears the countdown when checkout has no expiration', () => {
+    service.synchronize({
+      expires_at: null,
+      expires_in_seconds: null,
+      server_time: '2026-08-27T15:00:00.000Z',
+    });
+
+    expect(service.remainingSeconds()).toBeNull();
+  });
+
+  it('keeps the active countdown when a partial checkout response omits timing fields', () => {
+    service.synchronize({
+      expires_at: null,
+      expires_in_seconds: 10,
+      server_time: '2026-08-27T15:00:00.000Z',
+    });
+
+    service.synchronize({});
+
+    expect(service.remainingSeconds()).toBe(10);
+  });
+});

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

@@ -0,0 +1,97 @@
+import { Injectable, OnDestroy, signal } from '@angular/core';
+
+export interface CheckoutTiming {
+  expires_at: string | null;
+  expires_in_seconds: number | null;
+  server_time: string;
+}
+
+@Injectable({
+  providedIn: 'root',
+})
+export class CheckoutCountdownService implements OnDestroy {
+  private readonly remainingSecondsState = signal<number | null>(null);
+  private deadlineMs: number | null = null;
+  private intervalId: ReturnType<typeof setInterval> | null = null;
+
+  readonly remainingSeconds = this.remainingSecondsState.asReadonly();
+
+  synchronize(timing: Partial<CheckoutTiming>): void {
+    const remainingSeconds = this.resolveRemainingSeconds(timing);
+
+    if (remainingSeconds === undefined) {
+      return;
+    }
+
+    if (remainingSeconds === null) {
+      this.clear();
+      return;
+    }
+
+    this.stopInterval();
+    this.deadlineMs = Date.now() + remainingSeconds * 1_000;
+    this.updateRemainingSeconds();
+
+    if (remainingSeconds > 0) {
+      this.intervalId = setInterval(() => this.updateRemainingSeconds(), 1_000);
+    }
+  }
+
+  clear(): void {
+    this.stopInterval();
+    this.deadlineMs = null;
+    this.remainingSecondsState.set(null);
+  }
+
+  ngOnDestroy(): void {
+    this.clear();
+  }
+
+  private resolveRemainingSeconds(timing: Partial<CheckoutTiming>): number | null | undefined {
+    if (timing.expires_at === null && timing.expires_in_seconds === null) {
+      return null;
+    }
+
+    const expiresAt =
+      typeof timing.expires_at === 'string' ? Date.parse(timing.expires_at) : Number.NaN;
+    const serverTime =
+      typeof timing.server_time === 'string' ? Date.parse(timing.server_time) : Number.NaN;
+
+    if (Number.isFinite(expiresAt) && Number.isFinite(serverTime)) {
+      return Math.max(0, Math.ceil((expiresAt - serverTime) / 1_000));
+    }
+
+    if (
+      typeof timing.expires_in_seconds === 'number' &&
+      Number.isFinite(timing.expires_in_seconds)
+    ) {
+      return Math.max(0, Math.ceil(timing.expires_in_seconds));
+    }
+
+    if (Number.isFinite(expiresAt)) {
+      return Math.max(0, Math.ceil((expiresAt - Date.now()) / 1_000));
+    }
+
+    return undefined;
+  }
+
+  private updateRemainingSeconds(): void {
+    if (this.deadlineMs === null) {
+      return;
+    }
+
+    const remainingSeconds = Math.max(0, Math.ceil((this.deadlineMs - Date.now()) / 1_000));
+    this.remainingSecondsState.set(remainingSeconds);
+
+    if (remainingSeconds === 0) {
+      this.stopInterval();
+    }
+  }
+
+  private stopInterval(): void {
+    if (this.intervalId !== null) {
+      clearInterval(this.intervalId);
+      this.intervalId = null;
+    }
+  }
+}

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

@@ -1,9 +1,10 @@
 import { provideHttpClient } from '@angular/common/http';
 import { HttpTestingController, provideHttpClientTesting } from '@angular/common/http/testing';
 import { TestBed } from '@angular/core/testing';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { environment } from '../../../environments/environment';
+import { CatalogAvailabilityService } from './catalog/catalog-availability.service';
 import { CheckoutService } from './checkout.service';
 
 describe('CheckoutService', () => {
@@ -38,4 +39,59 @@ describe('CheckoutService', () => {
 
     await expect(purchasePromise).resolves.toMatchObject({ id: 55 });
   });
+
+  it('refreshes catalog availability when starting checkout fails', async () => {
+    const catalogAvailabilityService = TestBed.inject(CatalogAvailabilityService);
+    const notifyAvailabilityChanged = vi.spyOn(
+      catalogAvailabilityService,
+      'notifyAvailabilityChanged',
+    );
+    const purchasePromise = service.startCheckout('desfile', { cart_id: 12 });
+    const request = httpMock.expectOne(`${environment.url}tenants/desfile/compras/start-checkout`);
+
+    request.flush(
+      { message: 'No hay stock disponible.' },
+      { status: 422, statusText: 'Unprocessable Entity' },
+    );
+
+    await expect(purchasePromise).rejects.toBeTruthy();
+    expect(notifyAvailabilityChanged).toHaveBeenCalledOnce();
+  });
+
+  it('waits for the expired cart refresh before refreshing catalog availability', async () => {
+    const catalogAvailabilityService = TestBed.inject(CatalogAvailabilityService);
+    const notifyAvailabilityChanged = vi.spyOn(
+      catalogAvailabilityService,
+      'notifyAvailabilityChanged',
+    );
+    const purchasePromise = service.startCheckout('desfile', { cart_id: 12 });
+    const request = httpMock.expectOne(`${environment.url}tenants/desfile/compras/start-checkout`);
+
+    request.flush(
+      {
+        code: 'stock_reservation.expired',
+        message: 'La reserva de stock venció.',
+      },
+      { status: 422, statusText: 'Unprocessable Entity' },
+    );
+
+    await expect(purchasePromise).rejects.toBeTruthy();
+    expect(notifyAvailabilityChanged).not.toHaveBeenCalled();
+  });
+
+  it('preserves checkout timing fields when completing a purchase', async () => {
+    const purchasePromise = service.completePurchase('desfile', 55);
+    const request = httpMock.expectOne(`${environment.url}tenants/desfile/compras/55/complete`);
+    const response = {
+      status: 'pending_payment',
+      expires_at: '2026-08-26T20:00:00.000Z',
+      expires_in_seconds: 900,
+      server_time: '2026-08-26T19:45:00.000Z',
+    };
+
+    expect(request.request.method).toBe('POST');
+    request.flush({ data: response });
+
+    await expect(purchasePromise).resolves.toEqual(response);
+  });
 });

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

@@ -1,10 +1,11 @@
-import { Injectable } from '@angular/core';
+import { inject, Injectable } from '@angular/core';
 import { firstValueFrom } from 'rxjs';
 
 import { environment } from '../../../environments/environment';
 import { ApiPaginatedResponse } from './api-paginated-response.interface';
 import { ApiPaginationQueryParams } from './api-pagination-query-params.interface';
 import { BaseApiService } from './base-api.service';
+import { CatalogAvailabilityService } from './catalog/catalog-availability.service';
 
 export interface UpdatePurchaseCustomerPayload {
   dni: string;
@@ -45,6 +46,21 @@ 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;
@@ -55,6 +71,32 @@ export type StartCheckoutPayload =
 
 export interface PurchaseStatusResponse {
   status: string | null;
+  expires_at: string | null;
+  expires_in_seconds: number | null;
+  server_time: string;
+  payment_verification?: PurchasePaymentVerificationResponse;
+}
+
+export type PurchasePaymentCandidateReason =
+  | 'ambiguous_exact_match'
+  | 'exact_dni_near_amount'
+  | 'exact_amount_near_dni';
+
+export interface PurchasePaymentCandidatePrimaryResponse {
+  reason: PurchasePaymentCandidateReason;
+  dni_distance: number | null;
+  payment_amount: string;
+  purchase_amount: string;
+  amount_difference: string;
+  confidence: 'exact' | 'high' | 'medium';
+  detected_at: string | null;
+}
+
+export interface PurchasePaymentVerificationResponse {
+  status: 'pending' | 'candidate';
+  candidate_count: number;
+  primary: PurchasePaymentCandidatePrimaryResponse | null;
+  reasons: PurchasePaymentCandidateReason[];
 }
 
 export interface PurchaseSummaryResponse extends PurchaseStatusResponse {
@@ -91,7 +133,6 @@ export interface PurchaseDetailResponse extends PurchaseStatusResponse {
   user_id: number;
   created_at: string | null;
   payment_method: string | null;
-  expires_at: string | null;
   dni: string | null;
   transfer_payer_dni: string | null;
   telefono: string | null;
@@ -109,24 +150,34 @@ export interface PurchaseDetailResponse extends PurchaseStatusResponse {
   providedIn: 'root',
 })
 export class CheckoutService extends BaseApiService {
+  private readonly catalogAvailabilityService = inject(CatalogAvailabilityService);
+
   async startCheckout(
     tenantCode: string,
     payload: StartCheckoutPayload,
   ): Promise<PurchaseDetailResponse> {
-    const response = await firstValueFrom(
-      this.http.post<{ data?: PurchaseDetailResponse } | PurchaseDetailResponse>(
-        `${environment.url}tenants/${tenantCode}/compras/start-checkout`,
-        payload,
-      ),
-    );
+    try {
+      const response = await firstValueFrom(
+        this.http.post<{ data?: PurchaseDetailResponse } | PurchaseDetailResponse>(
+          `${environment.url}tenants/${tenantCode}/compras/start-checkout`,
+          payload,
+        ),
+      );
 
-    const purchase = this.extractResponseData<PurchaseDetailResponse>(response);
+      const purchase = this.extractResponseData<PurchaseDetailResponse>(response);
 
-    if (!purchase?.id) {
-      throw new Error('Error al crear la compra.');
+      if (!purchase?.id) {
+        throw new Error('Error al crear la compra.');
+      }
+
+      return purchase;
+    } catch (error) {
+      const responseBody = (error as { error?: unknown } | null)?.error;
+      if (!isExpiredStockReservationResponse(responseBody)) {
+        this.catalogAvailabilityService.notifyAvailabilityChanged();
+      }
+      throw error;
     }
-
-    return purchase;
   }
 
   async generatePaymentIntent(
@@ -171,25 +222,6 @@ export class CheckoutService extends BaseApiService {
     return purchase;
   }
 
-  async completePurchase(tenantCode: string, purchaseId: number): Promise<PurchaseStatusResponse> {
-    const response = await firstValueFrom(
-      this.http.post<{ data?: PurchaseStatusResponse } | PurchaseStatusResponse>(
-        `${environment.url}tenants/${tenantCode}/compras/${purchaseId}/complete`,
-        {},
-      ),
-    );
-
-    const purchase = this.extractResponseData<PurchaseStatusResponse>(response);
-
-    if (!purchase) {
-      throw new Error('Error al finalizar la compra.');
-    }
-
-    return {
-      status: purchase.status ?? null,
-    };
-  }
-
   async submitPurchaseForReview(
     tenantCode: string,
     purchaseId: number,
@@ -206,7 +238,7 @@ export class CheckoutService extends BaseApiService {
       throw new Error('Error al enviar la compra a revisi\u00f3n.');
     }
 
-    return { status: purchase.status ?? null };
+    return purchase;
   }
 
   async cancelPurchase(tenantCode: string, purchaseId: number): Promise<PurchaseStatusResponse> {
@@ -222,7 +254,7 @@ export class CheckoutService extends BaseApiService {
       throw new Error('Error al cancelar la compra.');
     }
 
-    return { status: purchase.status ?? null };
+    return purchase;
   }
 
   async getPurchases(

src/app/core/services/modal.service.spec.ts

@@ -7,6 +7,7 @@ import { firstValueFrom } from 'rxjs';
 
 import { ConfirmDeleteModalComponent } from '../../shared/components/confirm-delete-modal/confirm-delete-modal.component';
 import { ConfirmModalComponent } from '../../shared/components/confirm-modal/confirm-modal.component';
+import { ImageModalComponent } from '../../shared/components/image-modal/image-modal.component';
 import { QrModalComponent } from '../../shared/components/qr-modal/qr-modal.component';
 import { SimpleModalComponent } from '../../shared/components/simple-modal/simple-modal.component';
 import { MODAL_DATA, ModalRef, ModalService } from './modal.service';
@@ -258,6 +259,36 @@ describe('ModalService', () => {
       showCloseButton: true,
     });
   });
+
+  it('opens the image viewer fullscreen with normalized zoom limits', () => {
+    service.openImage({
+      title: 'Producto',
+      src: '/images/producto.webp',
+      alt: 'Producto visto de frente',
+      initialZoom: 8,
+      minZoom: 0,
+      maxZoom: 3,
+    });
+
+    const activeModal = service.activeModal();
+
+    expect(activeModal?.component).toBe(ImageModalComponent);
+    expect(activeModal?.config).toEqual({
+      title: 'Producto',
+      size: 'full',
+      presentation: 'fullscreen-media',
+      data: {
+        src: '/images/producto.webp',
+        alt: 'Producto visto de frente',
+        initialZoom: 3,
+        minZoom: 0.1,
+        maxZoom: 3,
+      },
+      closeOnBackdrop: true,
+      closeOnEscape: true,
+      showCloseButton: true,
+    });
+  });
 });
 
 @Component({

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

@@ -2,16 +2,19 @@ import { InjectionToken, Injectable, Type, signal } from '@angular/core';
 import { Observable, Subject, map } from 'rxjs';
 import { ConfirmDeleteModalComponent } from '../../shared/components/confirm-delete-modal/confirm-delete-modal.component';
 import { ConfirmModalComponent } from '../../shared/components/confirm-modal/confirm-modal.component';
+import { ImageModalComponent } from '../../shared/components/image-modal/image-modal.component';
 import { QrModalComponent } from '../../shared/components/qr-modal/qr-modal.component';
 import { SimpleModalComponent } from '../../shared/components/simple-modal/simple-modal.component';
 
 export type ModalSize = 'qr' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
-export type ModalDismissReason = 'backdrop' | 'escape' | 'programmatic' | 'replaced';
+export type ModalDismissReason = 'backdrop' | 'escape' | 'programmatic' | 'replaced' | 'swipe';
+export type ModalPresentation = 'dialog' | 'fullscreen-media';
 
 export interface ModalConfig<TData = unknown> {
   title?: string;
   data?: TData;
   size?: ModalSize;
+  presentation?: ModalPresentation;
   closeOnBackdrop?: boolean;
   closeOnEscape?: boolean;
   showCloseButton?: boolean;
@@ -62,6 +65,25 @@ export interface QrModalConfig extends Omit<ModalConfig<QrModalData>, 'data' | '
   ticket: string;
 }
 
+export interface ImageModalData {
+  src: string;
+  alt: string;
+  initialZoom: number;
+  minZoom: number;
+  maxZoom: number;
+}
+
+export interface ImageModalConfig extends Omit<
+  ModalConfig<ImageModalData>,
+  'data' | 'presentation' | 'size'
+> {
+  src: string;
+  alt: string;
+  initialZoom?: number;
+  minZoom?: number;
+  maxZoom?: number;
+}
+
 export interface ActiveModalState<TResult = unknown, TData = unknown> {
   component: Type<unknown>;
   config: NormalizedModalConfig<TData>;
@@ -195,6 +217,33 @@ export class ModalService {
     });
   }
 
+  openImage(config: ImageModalConfig): Observable<void> {
+    return this.openImageRef(config).afterClosed$.pipe(map(() => undefined));
+  }
+
+  openImageRef(config: ImageModalConfig): ModalRef<void> {
+    const { src, alt, initialZoom = 1, minZoom = 1, maxZoom = 4, ...modalConfig } = config;
+    const normalizedMinZoom = Math.max(0.1, minZoom);
+    const normalizedMaxZoom = Math.max(normalizedMinZoom, maxZoom);
+    const normalizedInitialZoom = Math.min(
+      normalizedMaxZoom,
+      Math.max(normalizedMinZoom, initialZoom),
+    );
+
+    return this.open(ImageModalComponent, {
+      ...modalConfig,
+      size: 'full',
+      presentation: 'fullscreen-media',
+      data: {
+        src,
+        alt,
+        initialZoom: normalizedInitialZoom,
+        minZoom: normalizedMinZoom,
+        maxZoom: normalizedMaxZoom,
+      },
+    });
+  }
+
   private close<TResult>(ref: ModalRef<TResult>, result?: TResult): void {
     if (this.activeModalState()?.ref !== ref) {
       return;

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

@@ -83,6 +83,9 @@
               Abrir modal ancho
             </app-button>
             <app-button (click)="openSimpleModal()"> Abrir simple modal </app-button>
+            <app-button variant="secondary" (click)="openImageModal()">
+              Abrir visor de imagen
+            </app-button>
           </div>
           <div class="modal-showcase__result" data-testid="modal-last-result">
             {{ lastModalResult }}

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

@@ -51,6 +51,7 @@ function createModalServiceStub() {
     open: vi.fn(),
     openConfirm: vi.fn().mockReturnValue(of(true)),
     openConfirmDelete: vi.fn().mockReturnValue(of(false)),
+    openImage: vi.fn().mockReturnValue(of(undefined)),
   };
 }
 
@@ -281,6 +282,9 @@ describe('ReutilizablesTestPageComponent', () => {
     const deleteButton = buttons.find((button) =>
       button.textContent?.includes('Abrir confirm delete'),
     ) as HTMLButtonElement;
+    const imageButton = buttons.find((button) =>
+      button.textContent?.includes('Abrir visor de imagen'),
+    ) as HTMLButtonElement;
 
     expect(element.querySelector('[data-testid="modal-last-result"]')?.textContent).toContain(
       'Todavia no se abrio ningun modal.',
@@ -290,6 +294,8 @@ describe('ReutilizablesTestPageComponent', () => {
     fixture.detectChanges();
     deleteButton.click();
     fixture.detectChanges();
+    imageButton.click();
+    fixture.detectChanges();
 
     expect(modalServiceStub.openConfirm).toHaveBeenCalledWith({
       title: 'Confirmar accion',
@@ -302,6 +308,11 @@ describe('ReutilizablesTestPageComponent', () => {
         'Esta accion eliminara el producto del catalogo. Podras volver a crearlo manualmente.',
       confirmLabel: 'Eliminar',
     });
+    expect(modalServiceStub.openImage).toHaveBeenCalledWith({
+      title: 'Mochila urbana roja',
+      src: '/images/carousel-mochila-roja.webp',
+      alt: 'Mochila urbana roja vista de frente',
+    });
     expect(element.querySelector('[data-testid="modal-last-result"]')?.textContent).toContain(
       'Resultado: false',
     );

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

@@ -13,7 +13,6 @@ 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';
@@ -233,7 +232,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1001,
         precio: 250000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('a', 'Sector A'),
@@ -244,7 +243,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1002,
         precio: 250000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('a', 'Sector A'),
@@ -255,7 +254,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1003,
         precio: 250000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('c', 'Sector C'),
@@ -266,7 +265,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1004,
         precio: 200000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('a', 'Sector A'),
@@ -277,7 +276,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1005,
         precio: 200000,
-        availability: createCatalogAvailability(0),
+        maximum_addable_quantity: 0,
         values: {
           tipo: ticketOption('vip_lunch', 'VIP + Lunch'),
           sector: ticketOption('a', 'Sector A'),
@@ -288,7 +287,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1006,
         precio: 100000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('b', 'Sector B'),
@@ -299,7 +298,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1007,
         precio: 100000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('b', 'Sector B'),
@@ -310,7 +309,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1008,
         precio: 90000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('d', 'Sector D'),
@@ -321,7 +320,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1009,
         precio: 65000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('d', 'Sector D'),
@@ -332,7 +331,7 @@ export class ReutilizablesTestPageComponent {
       {
         id: 1010,
         precio: 40000,
-        availability: createCatalogAvailability(1),
+        maximum_addable_quantity: 1,
         values: {
           tipo: ticketOption('general', 'General'),
           sector: ticketOption('d', 'Sector D'),
@@ -494,6 +493,14 @@ export class ReutilizablesTestPageComponent {
       });
   }
 
+  protected openImageModal(): void {
+    this.modalService.openImage({
+      title: 'Mochila urbana roja',
+      src: '/images/carousel-mochila-roja.webp',
+      alt: 'Mochila urbana roja vista de frente',
+    });
+  }
+
   private openConfirmModal(config: Parameters<ModalService['openConfirm']>[0]): void {
     this.modalService.openConfirm(config).subscribe((confirmed) => {
       this.lastModalResult = `Resultado: ${confirmed}`;

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]="disabled() || !availableOptions()[attribute.codigo][option.id]"
+              [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]="disabled() || !availableOptions()[attribute.codigo][option.id]"
+              [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,7 +2,6 @@ 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', () => {
@@ -32,7 +31,7 @@ describe('ProductAttributeSelectorComponent', () => {
     fixture.componentRef.setInput('variants', [
       {
         id: 1,
-        availability: createCatalogAvailability(null),
+        maximum_addable_quantity: null,
         values: { size: 'S' },
       },
     ]);
@@ -52,12 +51,12 @@ describe('ProductAttributeSelectorComponent', () => {
     fixture.componentRef.setInput('variants', [
       {
         id: 1,
-        availability: createCatalogAvailability(0),
+        maximum_addable_quantity: 0,
         values: { size: 'S' },
       },
       {
         id: 2,
-        availability: createCatalogAvailability(2),
+        maximum_addable_quantity: 2,
         values: { size: 'M' },
       },
     ]);
@@ -93,9 +92,9 @@ describe('ProductAttributeSelectorComponent', () => {
     ]);
     fixture.componentRef.setInput('inventoryPolicy', 'unlimited');
     fixture.componentRef.setInput('variants', [
-      { id: 1, availability: createCatalogAvailability(null), values: { event_date: '1' } },
-      { id: 2, availability: createCatalogAvailability(null), values: { event_date: '2' } },
-      { id: 3, availability: createCatalogAvailability(null), values: { event_date: ['1', '2'] } },
+      { id: 1, maximum_addable_quantity: null, values: { event_date: '1' } },
+      { id: 2, maximum_addable_quantity: null, values: { event_date: '2' } },
+      { id: 3, maximum_addable_quantity: null, values: { event_date: ['1', '2'] } },
     ]);
     fixture.detectChanges();
 
@@ -136,16 +135,8 @@ describe('ProductAttributeSelectorComponent', () => {
     ]);
     fixture.componentRef.setInput('inventoryPolicy', 'unlimited');
     fixture.componentRef.setInput('variants', [
-      {
-        id: 1,
-        availability: createCatalogAvailability(null),
-        values: { size: 'S', internal_type: 'adult' },
-      },
-      {
-        id: 2,
-        availability: createCatalogAvailability(null),
-        values: { size: 'M', internal_type: 'child' },
-      },
+      { id: 1, maximum_addable_quantity: null, values: { size: 'S', internal_type: 'adult' } },
+      { id: 2, maximum_addable_quantity: null, values: { size: 'M', internal_type: 'child' } },
     ]);
     fixture.detectChanges();
 

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

@@ -15,7 +15,6 @@ import {
   ProductAttribute,
   ProductAttributeOption,
 } from '../../../../core/services/catalog/catalog.interface';
-import { allowsCatalogAction } from '../../../../core/services/catalog/catalog-availability';
 
 @Component({
   selector: 'app-product-attribute-selector',
@@ -30,7 +29,6 @@ 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>();
 
@@ -53,15 +51,22 @@ 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 = attribute.allow_multi_select
-            ? selectedForAttribute.includes(option.id)
-              ? selectedForAttribute
-              : [...selectedForAttribute, option.id]
-            : [option.id];
+          const desiredOptionIds = selectedForAttribute.includes(option.id)
+            ? selectedForAttribute
+            : [...selectedForAttribute, option.id];
           const desiredValues = desiredOptionIds
             .map((id) => attribute.options.find((candidate) => candidate.id === id))
             .filter((candidate): candidate is ProductAttributeOption => candidate !== undefined)
@@ -132,8 +137,6 @@ 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;
@@ -183,15 +186,7 @@ export class ProductAttributeSelectorComponent {
       return [];
     }
 
-    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);
+    const defaultValues = this.getVariantAttributeValues(attribute, variant.values);
     if (defaultValues.length === 0) {
       return [];
     }
@@ -220,17 +215,6 @@ 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 [];
   }
 
@@ -243,7 +227,7 @@ export class ProductAttributeSelectorComponent {
   }
 
   private isVariantAvailable(variant: CatalogItemVariant): boolean {
-    return allowsCatalogAction(variant.availability, 'select_variant');
+    return variant.maximum_addable_quantity !== 0;
   }
 
   private findFirstHexValue(value: unknown): string | null {

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

@@ -23,7 +23,10 @@ import {
 
 import { AuthService } from '../../../../core/services/auth/auth.service';
 import { CartService } from '../../../../core/services/cart/cart.service';
-import { CheckoutService } from '../../../../core/services/checkout.service';
+import {
+  CheckoutService,
+  isExpiredStockReservationResponse,
+} from '../../../../core/services/checkout.service';
 import {
   CatalogGroupLayout,
   CategoryItemsResponse,
@@ -167,10 +170,20 @@ export class CategoryItemsPageComponent {
               ],
             },
       );
-      await this.router.navigate(['/checkout'], { queryParams: { purchase: purchase.id } });
+      await this.router.navigate(['/checkout', purchase.id]);
     } catch (error) {
       console.error('Failed to create direct purchase:', error);
-      this.toastService.danger('No se pudo iniciar la compra directa.');
+      const message =
+        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(true).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.html

@@ -34,6 +34,7 @@
             [qrPaymentAmount]="cartTotal()"
             [whatsappUrl]="whatsappUrl()"
             [transferValidationStatus]="transferValidationStatus()"
+            [transferVerificationErrorTitle]="transferVerificationErrorTitle()"
             (paymentMethodChange)="selectPaymentMethod($event)"
             (copyTransferValue)="copyTransferValue($event.field, $event.value)"
             (cancelStep)="onCancel()"
@@ -46,6 +47,17 @@
     </div>
 
     <div class="checkout-page__cart-col">
+      @if (checkoutRemainingTime(); as remainingTime) {
+        <div
+          class="checkout-page__mobile-countdown d-flex d-md-none align-items-baseline justify-content-center gap-3"
+          role="timer"
+          aria-label="Tiempo restante de compra"
+        >
+          <span class="checkout-page__mobile-countdown-label">Tiempo restante de compra:</span>
+          <span class="checkout-page__mobile-countdown-value">{{ remainingTime }}</span>
+        </div>
+      }
+
       <app-cart
         title="COMPRA"
         [items]="mappedCartItems()"

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

@@ -28,6 +28,24 @@
     display: flex;
     flex-direction: column;
   }
+
+  &__mobile-countdown {
+    flex: 0 0 auto;
+    margin-bottom: 1.5rem;
+    color: var(--tenant-primary);
+    font-weight: 700;
+    white-space: nowrap;
+  }
+
+  &__mobile-countdown-label {
+    font-size: 13px;
+  }
+
+  &__mobile-countdown-value {
+    font-size: 20px;
+    line-height: 1;
+    font-variant-numeric: tabular-nums;
+  }
 }
 
 .checkout-page__loading {

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

@@ -14,6 +14,7 @@ import { TenantService } from '../../../../core/services/tenant.service';
 import { ToastService } from '../../../../core/services/toast.service';
 import { CartService } from '../../../../core/services/cart/cart.service';
 import { CartEditingPolicy } from '../../../../core/services/tenant.interface';
+import { CheckoutCountdownService } from '../../../../core/services/checkout-countdown.service';
 import { CheckoutPageComponent } from './checkout-page.component';
 
 describe('CheckoutPageComponent payment validation', () => {
@@ -33,7 +34,7 @@ describe('CheckoutPageComponent payment validation', () => {
     stop: ReturnType<typeof vi.fn>;
   };
   let cartServiceStub: { loadCart: ReturnType<typeof vi.fn> };
-  let routeQueryParamMap: ReturnType<typeof convertToParamMap>;
+  let routeParamMap: ReturnType<typeof convertToParamMap>;
   let authUserState: ReturnType<typeof signal>;
   let tenantState: ReturnType<
     typeof signal<{
@@ -76,7 +77,7 @@ describe('CheckoutPageComponent payment validation', () => {
     cartServiceStub = {
       loadCart: vi.fn().mockReturnValue(of({ id: 30, items: [], subtotal: '0.00' })),
     };
-    routeQueryParamMap = convertToParamMap({});
+    routeParamMap = convertToParamMap({});
     authUserState = signal(null);
     tenantState = signal({
       codigo: 'tenant-test',
@@ -103,8 +104,8 @@ describe('CheckoutPageComponent payment validation', () => {
           provide: ActivatedRoute,
           useValue: {
             snapshot: {
-              get queryParamMap() {
-                return routeQueryParamMap;
+              get paramMap() {
+                return routeParamMap;
               },
             },
           },
@@ -129,6 +130,93 @@ describe('CheckoutPageComponent payment validation', () => {
     return { fixture, component: fixture.componentInstance as any };
   }
 
+  it('does not expose an active countdown until the purchase timing is loaded', async () => {
+    const countdown = TestBed.inject(CheckoutCountdownService);
+    countdown.synchronize({
+      expires_at: null,
+      expires_in_seconds: 600,
+      server_time: new Date().toISOString(),
+    });
+    checkoutServiceStub.getPurchase.mockResolvedValue({
+      id: 25,
+      status: 'created',
+      expires_at: '2026-08-27T15:10:00.000Z',
+      expires_in_seconds: 600,
+      server_time: '2026-08-27T15:00:00.000Z',
+      items: [],
+      subtotal: '0.00',
+      total: '0.00',
+    });
+    routeParamMap = convertToParamMap({ id: 25 });
+
+    const { component } = createComponent();
+
+    expect(component.checkoutRemainingTime()).toBeNull();
+
+    await Promise.resolve();
+
+    expect(countdown.remainingSeconds()).toBe(600);
+    expect(component.checkoutRemainingTime()).toBe('10:00');
+  });
+
+  it('checks the purchase when the countdown expires and redirects to the expired status', async () => {
+    const countdown = TestBed.inject(CheckoutCountdownService);
+    checkoutServiceStub.getPurchase.mockResolvedValue({ status: 'expired' });
+    const { fixture, component } = createComponent();
+    component.createdPurchase.set({
+      id: 25,
+      status: 'created',
+      expires_at: new Date(Date.now() + 1_000).toISOString(),
+      expires_in_seconds: 1,
+      server_time: new Date().toISOString(),
+      items: [],
+      subtotal: '0.00',
+      total: '0.00',
+    });
+    countdown.synchronize(component.createdPurchase());
+    fixture.detectChanges();
+
+    await vi.advanceTimersByTimeAsync(1_000);
+    fixture.detectChanges();
+    await Promise.resolve();
+
+    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledOnce();
+    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledWith('tenant-test', 25);
+    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25], {
+      queryParams: { status: 'expired' },
+    });
+  });
+
+  it('checks the purchase only once when the expired countdown remains at zero', async () => {
+    const countdown = TestBed.inject(CheckoutCountdownService);
+    checkoutServiceStub.getPurchase.mockResolvedValue({
+      status: 'pending_payment',
+      expires_at: new Date(Date.now() - 1_000).toISOString(),
+      expires_in_seconds: 0,
+      server_time: new Date().toISOString(),
+    });
+    const { fixture, component } = createComponent();
+    component.createdPurchase.set({
+      id: 25,
+      status: 'pending_payment',
+      expires_at: new Date(Date.now() - 1_000).toISOString(),
+      expires_in_seconds: 0,
+      server_time: new Date().toISOString(),
+      items: [],
+      subtotal: '0.00',
+      total: '0.00',
+    });
+    countdown.synchronize(component.createdPurchase());
+    fixture.detectChanges();
+
+    await Promise.resolve();
+    fixture.detectChanges();
+    await vi.advanceTimersByTimeAsync(5_000);
+
+    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledOnce();
+    expect(routerStub.navigate).not.toHaveBeenCalled();
+  });
+
   it('polls QR after five seconds and navigates only when payment is paid', async () => {
     checkoutServiceStub.getPurchase
       .mockResolvedValueOnce({ status: 'pending_payment' })
@@ -195,7 +283,7 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(checkoutServiceStub.getPurchase).not.toHaveBeenCalled();
   });
 
-  it('polls a transfer every three seconds up to four attempts', async () => {
+  it('polls a transfer every three seconds for one minute', async () => {
     checkoutServiceStub.getPurchase.mockResolvedValue({ status: 'pending_payment' });
     const { component } = createComponent();
     component.selectedPaymentMethod.set('transfer');
@@ -205,14 +293,12 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(checkoutServiceStub.submitPurchaseForReview).toHaveBeenCalledWith('tenant-test', 25);
     expect(checkoutServiceStub.getPurchase).not.toHaveBeenCalled();
 
-    for (let attempt = 1; attempt <= 3; attempt += 1) {
-      await vi.advanceTimersByTimeAsync(3_000);
-      expect(checkoutServiceStub.getPurchase).toHaveBeenCalledTimes(attempt);
-      expect(component.transferValidationStatus()).toBe('checking');
-    }
+    await vi.advanceTimersByTimeAsync(57_000);
+    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledTimes(19);
+    expect(component.transferValidationStatus()).toBe('checking');
 
     await vi.advanceTimersByTimeAsync(3_000);
-    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledTimes(4);
+    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledTimes(20);
     expect(checkoutServiceStub.getPurchase).toHaveBeenLastCalledWith('tenant-test', 25);
     expect(component.transferValidationStatus()).toBe('error');
     expect(routerStub.navigate).not.toHaveBeenCalled();
@@ -256,13 +342,43 @@ describe('CheckoutPageComponent payment validation', () => {
     component.selectedPaymentMethod.set('transfer');
 
     await component.onComplete();
-    await vi.advanceTimersByTimeAsync(12_000);
+    await vi.advanceTimersByTimeAsync(60_000);
 
-    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledTimes(4);
+    expect(checkoutServiceStub.getPurchase).toHaveBeenCalledTimes(20);
     expect(component.transferValidationStatus()).toBe('error');
     expect(routerStub.navigate).not.toHaveBeenCalled();
   });
 
+  it('uses the primary candidate reason when transfer polling times out', async () => {
+    checkoutServiceStub.getPurchase.mockResolvedValue({
+      status: 'in_review',
+      payment_verification: {
+        status: 'candidate',
+        candidate_count: 1,
+        primary: {
+          reason: 'exact_amount_near_dni',
+          dni_distance: 1,
+          payment_amount: '300000.00',
+          purchase_amount: '300000.00',
+          amount_difference: '0.00',
+          confidence: 'medium',
+          detected_at: '2026-08-27T18:00:00-03:00',
+        },
+        reasons: ['exact_amount_near_dni'],
+      },
+    });
+    const { component } = createComponent();
+    component.selectedPaymentMethod.set('transfer');
+
+    await component.onComplete();
+    await vi.advanceTimersByTimeAsync(60_000);
+
+    expect(component.transferValidationStatus()).toBe('error');
+    expect(component.transferVerificationErrorTitle()).toBe(
+      'El DNI no corresponde con el de la transferencia',
+    );
+  });
+
   it('does not poll when submitting a transfer for review fails', async () => {
     vi.spyOn(console, 'error').mockImplementation(() => undefined);
     checkoutServiceStub.submitPurchaseForReview.mockRejectedValue(new Error('network error'));
@@ -317,7 +433,7 @@ describe('CheckoutPageComponent payment validation', () => {
       subtotal: '2501.00',
       total: '2501.00',
     };
-    routeQueryParamMap = convertToParamMap({ purchase: 25 });
+    routeParamMap = convertToParamMap({ id: 25 });
     checkoutServiceStub.getPurchase.mockResolvedValue(purchase);
     authUserState.set({
       id: 7,
@@ -354,7 +470,7 @@ describe('CheckoutPageComponent payment validation', () => {
 
   it('keeps the checkout hidden while the purchase is loading', async () => {
     let resolvePurchase!: (purchase: any) => void;
-    routeQueryParamMap = convertToParamMap({ purchase: 25 });
+    routeParamMap = convertToParamMap({ id: 25 });
     checkoutServiceStub.getPurchase.mockReturnValue(
       new Promise((resolve) => {
         resolvePurchase = resolve;
@@ -375,12 +491,13 @@ 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 () => {
-    routeQueryParamMap = convertToParamMap({ purchase: 25 });
+    routeParamMap = convertToParamMap({ id: 25 });
     checkoutServiceStub.getPurchase.mockResolvedValue({
       id: 25,
       status: 'pending_payment',
@@ -400,7 +517,7 @@ describe('CheckoutPageComponent payment validation', () => {
   });
 
   it('generates a new QR when reopening a pending QR purchase', async () => {
-    routeQueryParamMap = convertToParamMap({ purchase: 25 });
+    routeParamMap = convertToParamMap({ id: 25 });
     checkoutServiceStub.getPurchase.mockResolvedValue({
       id: 25,
       status: 'pending_payment',
@@ -424,7 +541,7 @@ describe('CheckoutPageComponent payment validation', () => {
   it.each(['paid', 'cancelled', 'rejected', 'expired'])(
     'redirects a %s purchase to its status page',
     async (status) => {
-      routeQueryParamMap = convertToParamMap({ purchase: 25 });
+      routeParamMap = convertToParamMap({ id: 25 });
       checkoutServiceStub.getPurchase.mockResolvedValue({
         id: 25,
         status,
@@ -442,7 +559,7 @@ describe('CheckoutPageComponent payment validation', () => {
   );
 
   it('redirects a submitted pending payment purchase to its status page', async () => {
-    routeQueryParamMap = convertToParamMap({ purchase: 25 });
+    routeParamMap = convertToParamMap({ id: 25 });
     checkoutServiceStub.getPurchase.mockResolvedValue({
       id: 25,
       status: 'pending_payment',
@@ -460,7 +577,7 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25]);
   });
 
-  it('shows the API error in a toast when cancelling the purchase fails', async () => {
+  it('shows the API error and redirects to status when cancellation finds an expired purchase', async () => {
     const message = 'La compra venció. Iniciá una nueva compra.';
     checkoutServiceStub.cancelPurchase.mockRejectedValue({
       error: { code: 'purchase.expired', message },
@@ -470,7 +587,9 @@ describe('CheckoutPageComponent payment validation', () => {
     await component.onModifyPurchase();
 
     expect(toastServiceStub.danger).toHaveBeenCalledWith(message);
-    expect(routerStub.navigate).not.toHaveBeenCalled();
+    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25], {
+      queryParams: { status: 'expired' },
+    });
     expect(globalLoadingServiceStub.start).toHaveBeenCalledOnce();
     expect(globalLoadingServiceStub.stop).toHaveBeenCalledOnce();
     expect(component.isCancellingPurchase()).toBe(false);
@@ -587,7 +706,24 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(component.createdPurchaseId()).toBe(25);
   });
 
-  it('shows the API message and redirects home when a checkout operation finds an expired purchase', async () => {
+  it('allows leaving checkout when cancellation finds an expired stock reservation', 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,
@@ -604,10 +740,35 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(toastServiceStub.danger).toHaveBeenCalledWith(
       'La compra venci\u00f3. Inici\u00e1 una nueva compra.',
     );
-    expect(routerStub.navigate).toHaveBeenCalledWith(['/']);
+    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25], {
+      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({
@@ -635,6 +796,8 @@ describe('CheckoutPageComponent payment validation', () => {
     expect(toastServiceStub.danger).toHaveBeenCalledWith(
       'La compra venci\u00f3. Inici\u00e1 una nueva compra.',
     );
-    expect(routerStub.navigate).toHaveBeenCalledWith(['/']);
+    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout/status', 25], {
+      queryParams: { status: 'expired' },
+    });
   });
 });

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

@@ -2,6 +2,7 @@ import {
   ChangeDetectionStrategy,
   Component,
   computed,
+  effect,
   inject,
   OnDestroy,
   OnInit,
@@ -16,8 +17,10 @@ import { firstValueFrom, startWith } from 'rxjs';
 import { TenantService } from '../../../../core/services/tenant.service';
 import {
   CheckoutService,
+  PurchasePaymentCandidateReason,
   PurchaseDetailItemResponse,
   PurchaseDetailResponse,
+  PurchaseStatusResponse,
 } from '../../../../core/services/checkout.service';
 import { AuthService } from '../../../../core/services/auth/auth.service';
 import { GlobalLoadingService } from '../../../../core/services/global-loading/global-loading.service';
@@ -28,6 +31,7 @@ import { StepComponent } from '../../../../shared/components/stepper/step.compon
 import { StepperComponent } from '../../../../shared/components/stepper/stepper.component';
 import { CheckoutDataStepComponent } from './checkout-data-step.component';
 import { CheckoutPaymentStepComponent } from './checkout-payment-step.component';
+import { CheckoutCountdownService } from '../../../../core/services/checkout-countdown.service';
 import {
   CheckoutForm,
   PaymentMethod,
@@ -64,6 +68,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
   private readonly router = inject(Router);
   private readonly tenantService = inject(TenantService);
   private readonly checkoutService = inject(CheckoutService);
+  private readonly checkoutCountdownService = inject(CheckoutCountdownService);
   private readonly authService = inject(AuthService);
   private readonly globalLoadingService = inject(GlobalLoadingService);
   private readonly toastService = inject(ToastService);
@@ -71,7 +76,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
   private readonly qrPollingIntervalMs = 5_000;
   private readonly qrPollingMaxAttempts = 120;
   private readonly transferPollingIntervalMs = 3_000;
-  private readonly transferPollingMaxAttempts = 209;
+  private readonly transferPollingMaxAttempts = 20;
 
   private qrPollingTimeoutId: ReturnType<typeof setTimeout> | null = null;
   private qrPollingAttempts = 0;
@@ -82,6 +87,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
   private paymentMethodRequestId = 0;
   private navigationStarted = false;
   private cancelPurchasePromise: Promise<boolean> | null = null;
+  private expirationCheckPurchaseId: number | null = null;
 
   @ViewChild(StepperComponent) stepper!: StepperComponent;
 
@@ -95,6 +101,27 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
   protected readonly createdPurchase = signal<PurchaseDetailResponse | null>(null);
   protected readonly isLoadingPurchase = signal(true);
   protected readonly checkoutStepIndex = signal(0);
+  protected readonly checkoutRemainingTime = computed(() => {
+    const purchase = this.createdPurchase();
+
+    if (
+      !purchase ||
+      (typeof purchase.expires_at !== 'string' && typeof purchase.expires_in_seconds !== 'number')
+    ) {
+      return null;
+    }
+
+    const remainingSeconds = this.checkoutCountdownService.remainingSeconds();
+
+    if (remainingSeconds === null) {
+      return null;
+    }
+
+    const minutes = Math.floor(remainingSeconds / 60);
+    const seconds = remainingSeconds % 60;
+
+    return `${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}`;
+  });
   protected readonly cartSubtotal = computed(() => {
     const purchase = this.createdPurchase();
     return purchase ? parseFloat(purchase.subtotal) : 0;
@@ -135,6 +162,14 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
   protected readonly qrPaymentStatus = signal<QrPaymentStatus>('idle');
   protected readonly isCheckingQrPayment = signal(false);
   protected readonly transferValidationStatus = signal<TransferValidationStatus>('idle');
+  private readonly transferPrimaryCandidateReason = signal<PurchasePaymentCandidateReason | null>(
+    null,
+  );
+  protected readonly transferVerificationErrorTitle = computed(() =>
+    this.transferPrimaryCandidateReason() === 'exact_amount_near_dni'
+      ? 'El DNI no corresponde con el de la transferencia'
+      : null,
+  );
   protected readonly whatsappUrl = computed(
     () =>
       this.tenantService
@@ -143,6 +178,28 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
   );
 
   constructor() {
+    effect(() => {
+      const remainingSeconds = this.checkoutCountdownService.remainingSeconds();
+      const purchaseId = this.createdPurchaseId() ?? this.createdPurchase()?.id ?? null;
+
+      if (remainingSeconds !== null && remainingSeconds > 0) {
+        this.expirationCheckPurchaseId = null;
+        return;
+      }
+
+      if (
+        remainingSeconds !== 0 ||
+        purchaseId === null ||
+        this.navigationStarted ||
+        this.expirationCheckPurchaseId === purchaseId
+      ) {
+        return;
+      }
+
+      this.expirationCheckPurchaseId = purchaseId;
+      void this.checkPurchaseAfterCountdownExpiration(purchaseId);
+    });
+
     this.form.statusChanges
       .pipe(startWith(this.form.status))
       .subscribe(() => this.isStep1Valid.set(this.form.valid));
@@ -161,7 +218,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
   }
 
   ngOnInit(): void {
-    const purchaseId = Number(this.route.snapshot.queryParamMap.get('purchase'));
+    const purchaseId = Number(this.route.snapshot.paramMap.get('id'));
     if (!Number.isInteger(purchaseId) || purchaseId <= 0) {
       void this.router.navigate(['/']);
       return;
@@ -228,6 +285,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
         nombre_apellido: formValue.nombre,
       });
       this.createdPurchase.set(purchase);
+      this.checkoutCountdownService.synchronize(purchase);
 
       this.stepper.next();
 
@@ -281,6 +339,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
     const tenant = this.tenantService.tenant();
     const purchaseId = this.createdPurchaseId();
     if (!tenant || !purchaseId) {
+      this.checkoutCountdownService.clear();
       return true;
     }
 
@@ -291,11 +350,25 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
       await firstValueFrom(this.cartService.loadCart());
       this.createdPurchaseId.set(null);
       this.createdPurchase.set(null);
+      this.checkoutCountdownService.clear();
 
       this.navigationStarted = true;
       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(true).subscribe({
+          error: (refreshError) => console.error('Error refreshing expired cart', refreshError),
+        });
+        this.createdPurchaseId.set(null);
+        this.createdPurchase.set(null);
+        this.checkoutCountdownService.clear();
+        this.navigationStarted = true;
+        return true;
+      }
+
       this.showRequestError(error, 'No se pudo cancelar la compra.');
       return false;
     } finally {
@@ -370,6 +443,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
     this.transferDni.set(dni);
     this.stopTransferPolling();
     this.transferValidationStatus.set('idle');
+    this.transferPrimaryCandidateReason.set(null);
     this.isGeneratingIntent.set(true);
     try {
       const response = await this.checkoutService
@@ -426,6 +500,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
     this.stopTransferPolling();
     this.hasSubmittedTransfer.set(true);
     this.transferValidationStatus.set('checking');
+    this.transferPrimaryCandidateReason.set(null);
     this.transferPollingAttempts = 0;
 
     const runId = this.transferPollingRunId;
@@ -439,6 +514,9 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
         return;
       }
 
+      this.checkoutCountdownService.synchronize(purchase);
+      this.captureTransferCandidateReason(purchase);
+
       if (purchase.status === 'paid') {
         this.navigateToPurchaseStatus(purchaseId);
         return;
@@ -488,12 +566,24 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
         return;
       }
 
+      this.checkoutCountdownService.synchronize(purchase);
+      this.captureTransferCandidateReason(purchase);
+
       if (purchase.status === 'paid') {
         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) {
@@ -509,6 +599,14 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
     this.scheduleTransferPoll(runId);
   }
 
+  private captureTransferCandidateReason(purchase: PurchaseStatusResponse): void {
+    const reason = purchase.payment_verification?.primary?.reason;
+
+    if (reason) {
+      this.transferPrimaryCandidateReason.set(reason);
+    }
+  }
+
   private stopTransferPolling(): void {
     this.transferPollingRunId += 1;
 
@@ -565,6 +663,8 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
         return;
       }
 
+      this.checkoutCountdownService.synchronize(purchase);
+
       if (purchase.status === 'paid') {
         this.handleConfirmedPayment(purchaseId);
         return;
@@ -575,8 +675,17 @@ 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);
@@ -629,10 +738,40 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
     this.navigationStarted = true;
     this.stopQrPolling();
     this.stopTransferPolling();
+    this.checkoutCountdownService.clear();
 
     void this.router.navigate(['/checkout/status', purchaseId]);
   }
 
+  private async checkPurchaseAfterCountdownExpiration(purchaseId: number): Promise<void> {
+    const tenant = this.tenantService.tenant();
+
+    if (!tenant || this.navigationStarted) {
+      return;
+    }
+
+    try {
+      const purchase = await this.checkoutService
+        .withCustomLoading()
+        .getPurchase(tenant.codigo, purchaseId);
+
+      if (this.navigationStarted) {
+        return;
+      }
+
+      if (purchase.status === 'expired') {
+        this.navigateToExpiredPurchaseStatus();
+        return;
+      }
+
+      this.checkoutCountdownService.synchronize(purchase);
+    } catch (error) {
+      if (this.isPurchaseExpiredError(error)) {
+        this.navigateToExpiredPurchaseStatus();
+      }
+    }
+  }
+
   private async loadPurchase(purchaseId: number): Promise<void> {
     const tenant = this.tenantService.tenant();
     if (!tenant) {
@@ -666,6 +805,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
 
       this.createdPurchaseId.set(purchase.id);
       this.createdPurchase.set(purchase);
+      this.checkoutCountdownService.synchronize(purchase);
       this.checkoutStepIndex.set(purchase.status === 'pending_payment' ? 1 : 0);
 
       if (
@@ -683,15 +823,17 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
       }
     } catch (error) {
       console.error('Failed to load purchase:', error);
-      this.showRequestError(error, 'No se pudo cargar la compra.');
-      void this.router.navigate(['/']);
+      const expired = this.showRequestError(error, 'No se pudo cargar la compra.');
+      if (!expired) {
+        void this.router.navigate(['/']);
+      }
     }
   }
 
-  private showRequestError(error: unknown, fallbackMessage: string): void {
+  private showRequestError(error: unknown, fallbackMessage: string): boolean {
     const payload =
       typeof error === 'object' && error !== null && 'error' in error
-        ? (error as { error?: { message?: unknown } }).error
+        ? (error as { error?: ApiErrorResponse }).error
         : undefined;
     const message =
       typeof payload?.message === 'string' && payload.message.trim()
@@ -699,6 +841,13 @@ 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 {
@@ -717,7 +866,7 @@ export class CheckoutPageComponent implements OnInit, OnDestroy {
           ? response.message
           : 'La compra venció. Iniciá una nueva compra.',
       );
-      void this.router.navigate(['/']);
+      this.navigateToExpiredPurchaseStatus();
       return true;
     }
 
@@ -729,6 +878,43 @@ 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();
+      this.checkoutCountdownService.clear();
+      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/checkout-page/checkout-payment-step.component.html

@@ -53,6 +53,7 @@
           [validationStatus]="transferValidationStatus()"
           [paymentAmount]="qrPaymentAmount()"
           [whatsappUrl]="whatsappUrl()"
+          [verificationErrorTitle]="transferVerificationErrorTitle()"
           (copyTransferValue)="requestCopy($event.field, $event.value)"
           (submitDni)="generateTransferIntent.emit($event)"
           (completePurchase)="complete.emit()"

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

@@ -33,6 +33,7 @@ export class CheckoutPaymentStepComponent {
   readonly qrPaymentAmount = input<number>(0);
   readonly whatsappUrl = input<string | null>(null);
   readonly transferValidationStatus = input<TransferValidationStatus>('idle');
+  readonly transferVerificationErrorTitle = input<string | null>(null);
 
   readonly paymentMethodChange = output<PaymentMethod>();
   readonly copyTransferValue = output<{ field: TransferField; value: string }>();

src/app/features/store/pages/checkout-page/components/checkout-payment-transfer/checkout-payment-transfer.component.html

@@ -3,6 +3,7 @@
     <app-payment-verification-error
       [paymentAmount]="paymentAmount()"
       [whatsappUrl]="whatsappUrl()"
+      [title]="verificationErrorTitle()"
     />
   } @else {
     <div class="dni-form-container">

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

@@ -47,4 +47,23 @@ describe('CheckoutPaymentTransferComponent', () => {
     expect(whatsapp).toBeDefined();
     expect(element.querySelector('.payment-verification')).toBeNull();
   });
+
+  it('shows a custom validation title for a near DNI candidate', async () => {
+    await TestBed.configureTestingModule({
+      imports: [CheckoutPaymentTransferComponent],
+    }).compileComponents();
+
+    const fixture = TestBed.createComponent(CheckoutPaymentTransferComponent);
+    fixture.componentRef.setInput('validationStatus', 'error');
+    fixture.componentRef.setInput(
+      'verificationErrorTitle',
+      'El DNI no corresponde con el de la transferencia',
+    );
+    fixture.detectChanges();
+
+    expect(fixture.nativeElement.textContent).toContain(
+      'El DNI no corresponde con el de la transferencia',
+    );
+    expect(fixture.nativeElement.textContent).not.toContain('No pudimos verificar el pago de');
+  });
 });

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

@@ -41,6 +41,7 @@ export class CheckoutPaymentTransferComponent implements OnInit {
   readonly validationStatus = input<TransferValidationStatus>('idle');
   readonly paymentAmount = input<number>(0);
   readonly whatsappUrl = input<string | null>(null);
+  readonly verificationErrorTitle = input<string | null>(null);
 
   readonly copyTransferValue = output<{ field: TransferField; value: string }>();
   readonly submitDni = output<string>();

src/app/features/store/pages/checkout-page/components/payment-verification-error/payment-verification-error.component.html

@@ -2,7 +2,7 @@
   <div class="payment-timeout__icon" aria-hidden="true">
     <i class="fa-solid fa-xmark"></i>
   </div>
-  <h4 class="payment-timeout__title">No pudimos verificar el pago de {{ formattedAmount() }}.</h4>
+  <h4 class="payment-timeout__title">{{ displayTitle() }}</h4>
   <p class="payment-timeout__message">Por favor contactate con nosotros para resolverlo.</p>
   @if (whatsappUrl()) {
     <app-button

src/app/features/store/pages/checkout-page/components/payment-verification-error/payment-verification-error.component.ts

@@ -13,6 +13,7 @@ import { ButtonComponent } from '../../../../../../shared/components/button/butt
 export class PaymentVerificationErrorComponent {
   readonly paymentAmount = input<number>(0);
   readonly whatsappUrl = input<string | null>(null);
+  readonly title = input<string | null>(null);
 
   protected readonly formattedAmount = computed(() =>
     new Intl.NumberFormat('es-AR', {
@@ -21,6 +22,9 @@ export class PaymentVerificationErrorComponent {
       maximumFractionDigits: 0,
     }).format(this.paymentAmount()),
   );
+  protected readonly displayTitle = computed(
+    () => this.title() ?? `No pudimos verificar el pago de ${this.formattedAmount()}.`,
+  );
 
   protected openWhatsApp(): void {
     const url = this.whatsappUrl();

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

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

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

@@ -10,7 +10,6 @@ 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';
@@ -39,7 +38,7 @@ describe('ProductDetailPageComponent', () => {
     has_tickets: false,
     minimum_use_date: null,
     maximum_use_date: null,
-    availability: createCatalogAvailability(10),
+    maximum_addable_quantity: 10,
     attributes: [],
     variants: [],
   };
@@ -180,7 +179,7 @@ describe('ProductDetailPageComponent', () => {
 
   it('reloads product availability when the cart changes', async () => {
     catalogServiceStub.getCatalogItem.mockReturnValue(
-      of({ ...mockProduct, availability: createCatalogAvailability(4) }),
+      of({ ...mockProduct, maximum_addable_quantity: 4 }),
     );
     await configureTestingModule();
     const fixture = TestBed.createComponent(ProductDetailPageComponent);
@@ -193,21 +192,6 @@ 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();
@@ -223,10 +207,10 @@ describe('ProductDetailPageComponent', () => {
     const detailProduct: CatalogItemDetail = {
       ...mockProduct,
       images: ['https://example.com/product.png'],
-      variants: [{ id: 123, availability: createCatalogAvailability(10), values: {} }],
+      variants: [{ id: 123, maximum_addable_quantity: 10, values: {} }],
       selected_variant: {
         id: 123,
-        availability: createCatalogAvailability(10),
+        maximum_addable_quantity: 10,
         images: ['https://example.com/variant1.png', 'https://example.com/variant2.png'],
         values: {},
       },
@@ -328,15 +312,11 @@ describe('ProductDetailPageComponent', () => {
         },
       ],
       variants: [
-        {
-          id: 123,
-          availability: createCatalogAvailability(10),
-          values: { color: 'beige', material: 'Cuero' },
-        },
+        { id: 123, maximum_addable_quantity: 10, values: { color: 'beige', material: 'Cuero' } },
       ],
       selected_variant: {
         id: 123,
-        availability: createCatalogAvailability(10),
+        maximum_addable_quantity: 10,
         images: ['https://example.com/variant1.png'],
         values: {
           color: 'beige',
@@ -373,18 +353,8 @@ describe('ProductDetailPageComponent', () => {
       purpose: 'entry',
       has_tickets: true,
       variants: [
-        {
-          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' },
-        },
+        { 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' } },
       ],
       attributes: [
         {
@@ -415,7 +385,7 @@ describe('ProductDetailPageComponent', () => {
       selected_variant: {
         id: 101,
         event_date_id: 20,
-        availability: createCatalogAvailability(10),
+        maximum_addable_quantity: 10,
         images: [],
         values: {},
       },
@@ -437,8 +407,6 @@ describe('ProductDetailPageComponent', () => {
 
     options[1].click();
     fixture.detectChanges();
-    await fixture.whenStable();
-    fixture.detectChanges();
 
     expect(catalogServiceStub.getCatalogItem).toHaveBeenCalledWith(1, 102);
   });
@@ -461,7 +429,7 @@ describe('ProductDetailPageComponent', () => {
 
     fixture.componentInstance['selectedVariant'].set({
       id: 1,
-      availability: createCatalogAvailability(10),
+      maximum_addable_quantity: 10,
       values: {},
     });
     fixture.detectChanges();
@@ -539,9 +507,7 @@ describe('ProductDetailPageComponent', () => {
         },
       ],
     });
-    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout'], {
-      queryParams: { purchase: 44 },
-    });
+    expect(routerStub.navigate).toHaveBeenCalledWith(['/checkout', 44]);
   });
 
   it('shows the backend purchase-limit message for a direct checkout', async () => {
@@ -551,7 +517,7 @@ describe('ProductDetailPageComponent', () => {
         error: {
           code: 'purchase.limit_exceeded',
           message: 'Podés agregar hasta 2 unidades más de “Auriculares Bluetooth”.',
-          availability: createCatalogAvailability(2),
+          maximum_addable_quantity: 2,
         },
       }),
     );
@@ -576,13 +542,13 @@ describe('ProductDetailPageComponent', () => {
       variants: [
         {
           id: 123,
-          availability: createCatalogAvailability(5),
+          maximum_addable_quantity: 5,
           values: {},
         },
       ],
       selected_variant: {
         id: 123,
-        availability: createCatalogAvailability(5),
+        maximum_addable_quantity: 5,
         images: [],
         values: {},
       },
@@ -615,7 +581,7 @@ describe('ProductDetailPageComponent', () => {
     resolveProduct({
       ...mockProduct,
       variants: [],
-      availability: createCatalogAvailability(4),
+      maximum_addable_quantity: 4,
     });
 
     await configureTestingModule();
@@ -641,13 +607,13 @@ describe('ProductDetailPageComponent', () => {
       variants: [
         {
           id: 123,
-          availability: createCatalogAvailability(5),
+          maximum_addable_quantity: 5,
           values: {},
         },
       ],
       selected_variant: {
         id: 123,
-        availability: createCatalogAvailability(5),
+        maximum_addable_quantity: 5,
         images: [],
         values: {},
       },
@@ -679,7 +645,7 @@ describe('ProductDetailPageComponent', () => {
   it('allows unlimited variants to increase quantity without a maximum', async () => {
     const unlimitedVariant = {
       id: 321,
-      availability: createCatalogAvailability(null),
+      maximum_addable_quantity: null,
       values: {},
     };
     resolveProduct({
@@ -687,7 +653,7 @@ describe('ProductDetailPageComponent', () => {
       inventory_policy: 'unlimited',
       selected_variant: {
         id: 321,
-        availability: createCatalogAvailability(null),
+        maximum_addable_quantity: null,
         images: [],
         values: {},
       },
@@ -711,7 +677,7 @@ describe('ProductDetailPageComponent', () => {
   it('caps an unlimited variant at the per-user purchase limit', async () => {
     const unlimitedVariant = {
       id: 322,
-      availability: createCatalogAvailability(2),
+      maximum_addable_quantity: 2,
       values: {},
     };
     resolveProduct({
@@ -720,7 +686,7 @@ describe('ProductDetailPageComponent', () => {
       max_units_per_user: 2,
       selected_variant: {
         id: 322,
-        availability: createCatalogAvailability(2),
+        maximum_addable_quantity: 2,
         images: [],
         values: { event_date: '20' },
       },
@@ -744,14 +710,14 @@ describe('ProductDetailPageComponent', () => {
   it('disables purchase actions for tracked variants without stock', async () => {
     const trackedVariant = {
       id: 654,
-      availability: createCatalogAvailability(0),
+      maximum_addable_quantity: 0,
       values: {},
     };
     resolveProduct({
       ...mockProduct,
       selected_variant: {
         id: 654,
-        availability: createCatalogAvailability(0),
+        maximum_addable_quantity: 0,
         images: [],
         values: {},
       },

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

@@ -32,13 +32,6 @@ 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',
@@ -103,41 +96,29 @@ 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 maximumCatalogQuantity(this.effectiveAvailability());
+    return variant
+      ? (variant.maximum_addable_quantity ?? null)
+      : prod.variants.length === 0
+        ? (prod.maximum_addable_quantity ?? null)
+        : 0;
   });
-  protected readonly hasPurchasableSelection = computed(() => {
+  protected readonly selectedVariantAvailable = computed(() => {
     const prod = this.product();
     if (!prod) return false;
+    if (this.selectedVariantMax() === 0) return false;
 
-    return prod.variants.length === 0 || this.selectedVariant() !== null;
+    const variant = this.selectedVariant();
+    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);
@@ -243,12 +224,8 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
             this.quantity.set(Math.max(1, maximum));
           }
         },
-        error: (error: HttpErrorResponse) => {
-          if (error.status === 404) {
-            this.product.set(null);
-            this.selectedVariant.set(null);
-            this.error.set('Este producto ya no está disponible.');
-          }
+        error: () => {
+          // Keep the last known availability if the silent refresh fails.
         },
       });
   }
@@ -318,10 +295,8 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
   protected addToCart(): void {
     const currentProduct = this.product();
     const variant = this.selectedVariant();
-    if (!currentProduct || !this.canAddToCart()) {
-      this.toastService.danger(
-        this.effectiveAvailability().reasons[0]?.message ?? 'Por favor, selecciona una variante.',
-      );
+    if (!currentProduct || !this.selectedVariantAvailable()) {
+      this.toastService.danger('Por favor, selecciona una variante.');
       return;
     }
 
@@ -351,10 +326,8 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
       return;
     }
 
-    if (!currentProduct || !this.canBuyNow()) {
-      this.toastService.danger(
-        this.effectiveAvailability().reasons[0]?.message ?? 'Por favor, selecciona una variante.',
-      );
+    if (!currentProduct || !this.selectedVariantAvailable()) {
+      this.toastService.danger('Por favor, selecciona una variante.');
       return;
     }
 
@@ -385,9 +358,7 @@ export class ProductDetailPageComponent implements OnInit, OnDestroy {
         ],
       });
 
-      await this.router.navigate(['/checkout'], {
-        queryParams: { purchase: purchase.id },
-      });
+      await this.router.navigate(['/checkout', purchase.id]);
     } catch (error) {
       console.error('Failed to create direct purchase:', error);
       const message =
@@ -400,6 +371,10 @@ 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,7 +5,6 @@ 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,
@@ -30,7 +29,7 @@ describe('productDetailResolver', () => {
     has_tickets: false,
     minimum_use_date: null,
     maximum_use_date: null,
-    availability: createCatalogAvailability(0),
+    maximum_addable_quantity: 0,
     attributes: [],
     variants: [],
   };

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

@@ -17,7 +17,9 @@
 
     <div class="status-content__section status-content__section--secondary">
       @if (ticketsRoute()) {
-        <p class="status-content__message">A continuación, vas a poder ver los tickets que debés presentar en el evento.</p>
+        <p class="status-content__message">
+          A continuación, vas a poder ver los tickets que debés presentar en el evento.
+        </p>
 
         <app-button
           type="button"
@@ -29,7 +31,9 @@
           <span>Mis tickets</span>
         </app-button>
       } @else if (whatsappUrl()) {
-        <p class="status-content__message">Comunicate con nosotros para coordinar el env&iacute;o.</p>
+        <p class="status-content__message">
+          Comunicate con nosotros para coordinar el env&iacute;o.
+        </p>
 
         <app-button
           type="button"
@@ -51,13 +55,21 @@
         <i class="fa-solid fa-clock"></i>
       </div>
       <h2 class="status-content__title">ESTAMOS VERIFICANDO TU PAGO</h2>
-      <p class="status-content__subtitle">Tu compra ya fue registrada y estamos esperando la confirmaci&oacute;n del pago.</p>
+      <p class="status-content__subtitle">
+        Tu compra ya fue registrada y estamos esperando la confirmaci&oacute;n del pago.
+      </p>
     </div>
 
     <hr class="status-content__divider" />
 
     <div class="status-content__section status-content__section--secondary">
-      <p class="status-content__message">Te avisaremos cuando el pago sea confirmado.</p>
+      @if (paymentIssueMessage()) {
+        <p class="status-content__message">
+          {{ paymentIssueMessage() }} Estamos revisando el pago.
+        </p>
+      } @else {
+        <p class="status-content__message">Te avisaremos cuando el pago sea confirmado.</p>
+      }
     </div>
   } @else if (status() === 'expired') {
     <div class="status-content__section status-content__section--primary">
@@ -65,13 +77,17 @@
         <i class="fa-solid fa-clock"></i>
       </div>
       <h2 class="status-content__title">LA COMPRA VENCI&Oacute;</h2>
-      <p class="status-content__subtitle">El plazo de pago termin&oacute; y liberamos el stock reservado.</p>
+      <p class="status-content__subtitle">
+        El plazo de pago termin&oacute; y liberamos el stock reservado.
+      </p>
     </div>
 
     <hr class="status-content__divider" />
 
     <div class="status-content__section status-content__section--secondary">
-      <p class="status-content__message">Pod&eacute;s volver a la tienda e iniciar una nueva compra.</p>
+      <p class="status-content__message">
+        Pod&eacute;s volver a la tienda e iniciar una nueva compra.
+      </p>
     </div>
   } @else if (status() === 'rejected') {
     <div class="status-content__section status-content__section--primary">
@@ -79,7 +95,9 @@
         <i class="fa-solid fa-triangle-exclamation"></i>
       </div>
       <h2 class="status-content__title">NO PUDIMOS CONFIRMAR EL PAGO</h2>
-      <p class="status-content__subtitle">Revis&aacute; el medio de pago o comunicate con nosotros para continuar.</p>
+      <p class="status-content__subtitle">
+        Revis&aacute; el medio de pago o comunicate con nosotros para continuar.
+      </p>
     </div>
 
     <hr class="status-content__divider" />
@@ -114,7 +132,9 @@
     <hr class="status-content__divider" />
 
     <div class="status-content__section status-content__section--secondary">
-      <p class="status-content__message">Volv&eacute; a ingresar m&aacute;s tarde. Si el problema sigue, comunicate con nosotros.</p>
+      <p class="status-content__message">
+        Volv&eacute; a ingresar m&aacute;s tarde. Si el problema sigue, comunicate con nosotros.
+      </p>
 
       @if (whatsappUrl()) {
         <div class="status-content__actions">

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

@@ -5,6 +5,7 @@ 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';
@@ -66,9 +67,13 @@ describe('PurchaseStatusPageComponent', () => {
     TestBed.resetTestingModule();
   });
 
-  async function render(hasGeneratedTickets: boolean) {
+  async function render(
+    hasGeneratedTickets: boolean,
+    forcedStatus?: string,
+    purchaseResponse = purchase(hasGeneratedTickets),
+  ) {
     const checkoutService = {
-      getPurchase: vi.fn().mockResolvedValue(purchase(hasGeneratedTickets)),
+      getPurchase: vi.fn().mockResolvedValue(purchaseResponse),
       withCustomLoading() {
         return this;
       },
@@ -77,15 +82,22 @@ 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: { snapshot: { paramMap: convertToParamMap({ id: '42' }) } },
+          useValue: {
+            snapshot: {
+              paramMap: convertToParamMap({ id: '42' }),
+              queryParamMap: convertToParamMap(forcedStatus ? { status: forcedStatus } : {}),
+            },
+          },
         },
         { provide: Router, useValue: router },
       ],
@@ -100,15 +112,22 @@ 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('Ver mis tickets');
+    expect(element.textContent).toContain('Mis tickets');
     expect(element.textContent).not.toContain('WhatsApp');
 
     element.querySelector<HTMLButtonElement>('app-button button')?.click();
@@ -134,6 +153,38 @@ 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('shows the primary transfer candidate issue while the purchase is in review', async () => {
+    const { element } = await render(false, undefined, {
+      status: 'in_review',
+      payment_verification: {
+        status: 'candidate',
+        candidate_count: 2,
+        primary: {
+          reason: 'exact_dni_near_amount',
+          dni_distance: 0,
+          payment_amount: '49000.00',
+          purchase_amount: '50000.00',
+          amount_difference: '1000.00',
+          confidence: 'high',
+          detected_at: '2026-08-27T18:00:00-03:00',
+        },
+        reasons: ['exact_dni_near_amount', 'exact_amount_near_dni'],
+      },
+    } as PurchaseDetailResponse);
+
+    expect(element.textContent).toContain('Encontramos 2 transferencias posibles.');
+    expect(element.textContent).toMatch(/diferencia de \$\s*1\.000/);
+    expect(element.textContent).toContain('Estamos revisando el pago.');
+  });
+
   it('polls every five seconds while the payment is pending and shows the confirmation', async () => {
     vi.useFakeTimers();
 
@@ -147,11 +198,13 @@ 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,
@@ -174,6 +227,7 @@ 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);
@@ -197,6 +251,7 @@ 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

@@ -13,8 +13,10 @@ import { ActivatedRoute, Router } from '@angular/router';
 
 import {
   CheckoutService,
+  PurchasePaymentVerificationResponse,
   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';
@@ -35,6 +37,7 @@ 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));
 
@@ -46,6 +49,7 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
   protected readonly isLoading = signal(true);
   protected readonly status = signal<PurchaseStatusView>('pending');
   protected readonly hasGeneratedTickets = signal(false);
+  protected readonly paymentIssueMessage = signal<string | null>(null);
   protected readonly ticketsRoute = computed(() => {
     if (!this.hasGeneratedTickets()) {
       return null;
@@ -72,6 +76,12 @@ 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();
   }
 
@@ -97,6 +107,11 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
       const status = this.resolveStatus(purchase);
       this.status.set(status);
       this.hasGeneratedTickets.set(purchase.has_generated_tickets === true);
+      this.paymentIssueMessage.set(this.resolvePaymentIssueMessage(purchase.payment_verification));
+
+      if (status === 'approved') {
+        this.cartService.clearCart();
+      }
 
       if (status === 'pending') {
         this.schedulePolling();
@@ -107,7 +122,10 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
       console.error('Failed to fetch purchase status:', error);
 
       if (!this.isDestroyed) {
-        if (isPolling) {
+        if (this.isPurchaseExpiredError(error)) {
+          this.status.set('expired');
+          this.stopPolling();
+        } else if (isPolling) {
           this.schedulePolling();
         } else {
           this.status.set('error');
@@ -154,6 +172,51 @@ export class PurchaseStatusPageComponent implements OnInit, OnDestroy {
     return 'pending';
   }
 
+  private resolvePaymentIssueMessage(
+    verification?: PurchasePaymentVerificationResponse,
+  ): string | null {
+    const primary = verification?.primary;
+
+    if (!primary) {
+      return null;
+    }
+
+    const primaryMessage = (() => {
+      switch (primary.reason) {
+        case 'ambiguous_exact_match':
+          return 'Encontramos una transferencia que también coincide con otra compra.';
+        case 'exact_dni_near_amount':
+          return `El DNI coincide, pero el monto transferido tiene una diferencia de ${this.formatCurrency(primary.amount_difference)}.`;
+        case 'exact_amount_near_dni':
+          return primary.dni_distance === null
+            ? 'El monto coincide, pero el DNI del pagador es diferente.'
+            : `El monto coincide, pero el DNI del pagador presenta ${primary.dni_distance} ${primary.dni_distance === 1 ? 'diferencia' : 'diferencias'} de escritura.`;
+      }
+    })();
+
+    if (verification.candidate_count > 1) {
+      return `Encontramos ${verification.candidate_count} transferencias posibles. ${primaryMessage}`;
+    }
+
+    return primaryMessage;
+  }
+
+  private formatCurrency(amount: string): string {
+    return new Intl.NumberFormat('es-AR', {
+      style: 'currency',
+      currency: 'ARS',
+      maximumFractionDigits: 2,
+    }).format(Number(amount));
+  }
+
+  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,11 +38,13 @@
     <label class="visually-hidden" for="register-password">Contraseña</label>
     <app-input
       id="register-password"
-      type="password"
+      type="password-toggle"
       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>
@@ -51,11 +53,13 @@
     <label class="visually-hidden" for="register-password-repeat">Repetir Contraseña</label>
     <app-input
       id="register-password-repeat"
-      type="password"
+      type="password-toggle"
       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,6 +12,48 @@ 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,6 +48,7 @@ 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)]],
@@ -67,6 +68,11 @@ 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,11 +13,13 @@
     <label class="visually-hidden" for="reset-password-new">Nueva Contraseña</label>
     <app-input
       id="reset-password-new"
-      type="password"
+      type="password-toggle"
       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>
@@ -30,11 +32,13 @@
     </label>
     <app-input
       id="reset-password-confirmation"
-      type="password"
+      type="password-toggle"
       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,6 +50,43 @@ 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,6 +49,7 @@ 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') ?? '';
@@ -72,6 +73,11 @@ 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,7 +24,10 @@ import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 
 import { CartService } from '../../../../core/services/cart/cart.service';
 import { AuthService } from '../../../../core/services/auth/auth.service';
-import { CheckoutService } from '../../../../core/services/checkout.service';
+import {
+  CheckoutService,
+  isExpiredStockReservationResponse,
+} from '../../../../core/services/checkout.service';
 import {
   CatalogFeaturedItem,
   CatalogFeaturedItems,
@@ -199,10 +202,20 @@ export class SearchPageComponent {
               ],
             },
       );
-      await this.router.navigate(['/checkout'], { queryParams: { purchase: purchase.id } });
+      await this.router.navigate(['/checkout', purchase.id]);
     } catch (error) {
       console.error('Failed to create direct purchase:', error);
-      this.toastService.danger('No se pudo iniciar la compra directa.');
+      const message =
+        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(true).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,7 +13,6 @@ 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';
@@ -84,7 +83,6 @@ const pageOneItems: CatalogFeaturedItem[] = [
     nombre: 'Auriculares Bluetooth',
     precio: '24999.00',
     image: '/catalog/auriculares.jpg',
-    availability: createCatalogAvailability(null),
   },
   {
     id: 2,
@@ -92,7 +90,6 @@ const pageOneItems: CatalogFeaturedItem[] = [
     nombre: 'Teclado Mecanico',
     precio: '18999.00',
     image: null,
-    availability: createCatalogAvailability(null),
   },
 ];
 
@@ -409,14 +406,7 @@ 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,
-        availability: createCatalogAvailability(null),
-      },
+      { id: 3, type: 'product', nombre: 'Mouse Gamer', precio: '15999.00', image: null },
     ];
     const catalogServiceStub = {
       getCatalog: vi.fn(),

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

@@ -21,6 +21,7 @@ import { TenantService } from '../../../../core/services/tenant.service';
 import { ToastService } from '../../../../core/services/toast.service';
 import {
   CheckoutService,
+  isExpiredStockReservationResponse,
   isInsufficientStockResponse,
 } from '../../../../core/services/checkout.service';
 import {
@@ -217,10 +218,18 @@ export class StoreHomePageComponent implements OnInit, OnDestroy {
         tenant.codigo,
         reservedCartId !== null ? { cart_id: reservedCartId } : { direct_items: directItems },
       );
-      await this.router.navigate(['/checkout'], { queryParams: { purchase: purchase.id } });
+      await this.router.navigate(['/checkout', 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(true).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,15 +91,6 @@ 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,
@@ -113,6 +104,15 @@ 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,6 +175,63 @@ 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,11 +98,12 @@ 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),
@@ -205,9 +206,12 @@ 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.toastService.danger(error.error?.message || 'No se pudo actualizar la variante.');
+          this.handleMutationError(
+            error,
+            'No se pudo actualizar la variante.',
+            'Error updating cart item variant',
+          );
         },
       });
   }
@@ -305,10 +309,29 @@ export class CartComponent {
         this.toastService.info(msg);
       },
       error: (err: HttpErrorResponse) => {
-        console.error('Error removing item from cart', err);
-        const msg = err.error?.message || 'Error al eliminar el producto del carrito.';
-        this.toastService.danger(msg);
+        this.handleMutationError(
+          err,
+          'Error al eliminar el producto del carrito.',
+          '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(true).subscribe({
+      error: (refreshError) => console.error('Error refreshing expired cart', refreshError),
+    });
+  }
 }

src/app/shared/components/image-modal/image-modal.component.html

@@ -0,0 +1,58 @@
+<div
+  class="image-modal"
+  [class.image-modal--gesturing]="gestureActive()"
+  [class.image-modal--settling]="swipeSettling()"
+  [style.transform]="swipeTransform()"
+>
+  <div
+    #viewport
+    class="image-modal__viewport"
+    [class.image-modal__viewport--zoomed]="zoom() > data.minZoom"
+    (wheel)="onWheel($event)"
+    (dblclick)="onDoubleClick($event)"
+    (pointerdown)="onPointerDown($event)"
+    (pointermove)="onPointerMove($event)"
+    (pointerup)="onPointerUp($event)"
+    (pointercancel)="onPointerUp($event)"
+  >
+    @if (!imageFailed()) {
+      <img
+        #image
+        class="image-modal__image"
+        [src]="data.src"
+        [alt]="data.alt"
+        [style.transform]="transform()"
+        decoding="async"
+        draggable="false"
+        (load)="onImageLoad()"
+        (error)="imageFailed.set(true)"
+      />
+    } @else {
+      <p class="image-modal__error" role="alert">No se pudo cargar la imagen.</p>
+    }
+  </div>
+
+  <div class="image-modal__controls" aria-label="Controles de zoom">
+    <button
+      type="button"
+      class="image-modal__control"
+      aria-label="Alejar"
+      [disabled]="zoom() <= data.minZoom"
+      (click)="zoomOut()"
+    >
+      &minus;
+    </button>
+    <button type="button" class="image-modal__zoom" aria-label="Restablecer zoom" (click)="reset()">
+      {{ zoomLabel() }}
+    </button>
+    <button
+      type="button"
+      class="image-modal__control"
+      aria-label="Acercar"
+      [disabled]="zoom() >= data.maxZoom"
+      (click)="zoomIn()"
+    >
+      &plus;
+    </button>
+  </div>
+</div>

src/app/shared/components/image-modal/image-modal.component.scss

@@ -0,0 +1,146 @@
+:host {
+  display: flex;
+  min-height: 0;
+  flex: 1;
+}
+
+.image-modal {
+  position: relative;
+  display: flex;
+  min-width: 0;
+  min-height: 0;
+  flex: 1;
+  flex-direction: column;
+  overflow: hidden;
+  background: black;
+  transform-origin: center top;
+}
+
+.image-modal--settling {
+  transition: transform 180ms ease-out;
+}
+
+.image-modal--gesturing {
+  will-change: transform;
+}
+
+.image-modal__viewport {
+  display: flex;
+  min-width: 0;
+  min-height: 0;
+  flex: 1;
+  align-items: center;
+  justify-content: center;
+  overflow: hidden;
+  cursor: zoom-in;
+  touch-action: none;
+  user-select: none;
+}
+
+.image-modal__viewport--zoomed {
+  cursor: grab;
+}
+
+.image-modal__viewport--zoomed:active {
+  cursor: grabbing;
+}
+
+.image-modal__image {
+  display: block;
+  max-width: 100%;
+  max-height: 100%;
+  object-fit: contain;
+  transform-origin: center;
+  transition: transform 120ms ease-out;
+  -webkit-user-drag: none;
+}
+
+.image-modal--gesturing .image-modal__image {
+  transition: none;
+  will-change: transform;
+}
+
+.image-modal__viewport:active .image-modal__image {
+  transition: none;
+}
+
+.image-modal__error {
+  margin: 1rem;
+  color: #ffffff;
+  text-align: center;
+}
+
+.image-modal__controls {
+  position: absolute;
+  right: 50%;
+  bottom: max(1.25rem, env(safe-area-inset-bottom));
+  z-index: 1;
+  display: flex;
+  align-items: center;
+  overflow: hidden;
+  border: 1px solid rgba(255, 255, 255, 0.25);
+  border-radius: 2rem;
+  background: rgba(20, 20, 20, 0.78);
+  box-shadow: 0 0.25rem 1rem rgba(0, 0, 0, 0.3);
+  transform: translateX(50%);
+  backdrop-filter: blur(0.5rem);
+}
+
+.image-modal__control,
+.image-modal__zoom {
+  display: inline-flex;
+  height: 2.75rem;
+  align-items: center;
+  justify-content: center;
+  border: 0;
+  color: #ffffff;
+  background: transparent;
+}
+
+.image-modal__control {
+  width: 2.75rem;
+  font-size: 1.5rem;
+}
+
+.image-modal__zoom {
+  min-width: 4rem;
+  padding: 0 0.5rem;
+  font-size: 0.875rem;
+  font-variant-numeric: tabular-nums;
+}
+
+.image-modal__control:hover:not(:disabled),
+.image-modal__zoom:hover {
+  background: rgba(255, 255, 255, 0.12);
+}
+
+.image-modal__control:focus-visible,
+.image-modal__zoom:focus-visible {
+  outline: 2px solid #ffffff;
+  outline-offset: -3px;
+}
+
+.image-modal__control:disabled {
+  opacity: 0.35;
+}
+
+@media (max-width: 576px) {
+  .image-modal__controls {
+    bottom: max(1rem, env(safe-area-inset-bottom));
+    background: rgba(20, 20, 20, 0.94);
+    backdrop-filter: none;
+  }
+}
+
+@media (pointer: coarse) {
+  .image-modal__controls {
+    background: rgba(20, 20, 20, 0.94);
+    backdrop-filter: none;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .image-modal__image {
+    transition: none;
+  }
+}

src/app/shared/components/image-modal/image-modal.component.spec.ts

@@ -0,0 +1,165 @@
+import '@angular/compiler';
+import { ComponentFixture, TestBed, getTestBed } from '@angular/core/testing';
+import { BrowserTestingModule, platformBrowserTesting } from '@angular/platform-browser/testing';
+import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { ImageModalData, MODAL_DATA, ModalRef } from '../../../core/services/modal.service';
+import { ImageModalComponent } from './image-modal.component';
+
+describe('ImageModalComponent', () => {
+  let fixture: ComponentFixture<ImageModalComponent>;
+  const modalRef = { dismiss: vi.fn() };
+  const data: ImageModalData = {
+    src: '/images/producto.webp',
+    alt: 'Vista frontal del producto',
+    initialZoom: 1,
+    minZoom: 1,
+    maxZoom: 2,
+  };
+
+  beforeAll(() => {
+    try {
+      getTestBed().initTestEnvironment(BrowserTestingModule, platformBrowserTesting());
+    } catch {
+      // Test environment may already be initialized by another setup entrypoint.
+    }
+  });
+
+  beforeEach(async () => {
+    modalRef.dismiss.mockReset();
+    await TestBed.configureTestingModule({
+      imports: [ImageModalComponent],
+      providers: [
+        { provide: MODAL_DATA, useValue: data },
+        { provide: ModalRef, useValue: modalRef },
+      ],
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(ImageModalComponent);
+    fixture.detectChanges();
+  });
+
+  afterEach(() => {
+    fixture.destroy();
+    TestBed.resetTestingModule();
+  });
+
+  it('renders the image and accessible zoom controls', () => {
+    const element = fixture.nativeElement as HTMLElement;
+    const image = element.querySelector('img') as HTMLImageElement;
+
+    expect(image.getAttribute('src')).toBe('/images/producto.webp');
+    expect(image.alt).toBe('Vista frontal del producto');
+    expect(element.querySelector('[aria-label="Acercar"]')).not.toBeNull();
+    expect(element.querySelector('[aria-label="Alejar"]')).not.toBeNull();
+  });
+
+  it('zooms with controls, respects limits, and resets', () => {
+    const element = fixture.nativeElement as HTMLElement;
+    const zoomIn = element.querySelector('[aria-label="Acercar"]') as HTMLButtonElement;
+    const zoomOut = element.querySelector('[aria-label="Alejar"]') as HTMLButtonElement;
+    const reset = element.querySelector('[aria-label="Restablecer zoom"]') as HTMLButtonElement;
+
+    zoomIn.click();
+    fixture.detectChanges();
+    expect(reset.textContent).toContain('150%');
+    expect(zoomOut.disabled).toBe(false);
+
+    zoomIn.click();
+    fixture.detectChanges();
+    expect(reset.textContent).toContain('200%');
+    expect(zoomIn.disabled).toBe(true);
+
+    reset.click();
+    fixture.detectChanges();
+    expect(reset.textContent).toContain('100%');
+    expect(zoomOut.disabled).toBe(true);
+  });
+
+  it('supports pinch zoom through touch pointer events', async () => {
+    const viewport = fixture.nativeElement.querySelector('.image-modal__viewport') as HTMLElement;
+    const zoom = fixture.nativeElement.querySelector(
+      '[aria-label="Restablecer zoom"]',
+    ) as HTMLButtonElement;
+
+    viewport.dispatchEvent(pointerEvent('pointerdown', 1, 100, 100));
+    viewport.dispatchEvent(pointerEvent('pointerdown', 2, 200, 100));
+    viewport.dispatchEvent(pointerEvent('pointermove', 2, 250, 100));
+    await renderNextFrame();
+    fixture.detectChanges();
+
+    expect(zoom.textContent).toContain('150%');
+  });
+
+  it('dismisses with a downward swipe while the image is at its base zoom', async () => {
+    const viewport = fixture.nativeElement.querySelector('.image-modal__viewport') as HTMLElement;
+    const modal = fixture.nativeElement.querySelector('.image-modal') as HTMLElement;
+
+    viewport.dispatchEvent(pointerEvent('pointerdown', 1, 150, 100));
+    viewport.dispatchEvent(pointerEvent('pointermove', 1, 155, 230));
+    await renderNextFrame();
+    fixture.detectChanges();
+
+    expect(modal.style.transform).toBe('translate3d(0, 130px, 0)');
+    expect(Number(modal.style.opacity)).toBeLessThan(1);
+
+    viewport.dispatchEvent(pointerEvent('pointerup', 1, 155, 230));
+
+    expect(modalRef.dismiss).toHaveBeenCalledWith('swipe');
+  });
+
+  it('returns smoothly to its position when the swipe is too short', async () => {
+    const viewport = fixture.nativeElement.querySelector('.image-modal__viewport') as HTMLElement;
+    const modal = fixture.nativeElement.querySelector('.image-modal') as HTMLElement;
+
+    viewport.dispatchEvent(pointerEvent('pointerdown', 1, 150, 100));
+    viewport.dispatchEvent(pointerEvent('pointermove', 1, 150, 160));
+    await renderNextFrame();
+    fixture.detectChanges();
+    expect(modal.style.transform).toBe('translate3d(0, 60px, 0)');
+
+    viewport.dispatchEvent(pointerEvent('pointerup', 1, 150, 160));
+    fixture.detectChanges();
+
+    expect(modalRef.dismiss).not.toHaveBeenCalled();
+    expect(modal.classList.contains('image-modal--settling')).toBe(true);
+    expect(modal.style.transform).toBe('translate3d(0, 0px, 0)');
+  });
+
+  it('does not dismiss with a downward gesture while the image is zoomed', () => {
+    const element = fixture.nativeElement as HTMLElement;
+    const viewport = element.querySelector('.image-modal__viewport') as HTMLElement;
+    const zoomIn = element.querySelector('[aria-label="Acercar"]') as HTMLButtonElement;
+    zoomIn.click();
+    fixture.detectChanges();
+
+    viewport.dispatchEvent(pointerEvent('pointerdown', 1, 150, 100));
+    viewport.dispatchEvent(pointerEvent('pointermove', 1, 155, 230));
+    viewport.dispatchEvent(pointerEvent('pointerup', 1, 155, 230));
+
+    expect(modalRef.dismiss).not.toHaveBeenCalled();
+  });
+
+  it('shows a fallback when the image cannot be loaded', () => {
+    const image = fixture.nativeElement.querySelector('img') as HTMLImageElement;
+    image.dispatchEvent(new Event('error'));
+    fixture.detectChanges();
+
+    expect(fixture.nativeElement.querySelector('[role="alert"]')?.textContent).toContain(
+      'No se pudo cargar la imagen',
+    );
+  });
+});
+
+function pointerEvent(type: string, pointerId: number, clientX: number, clientY: number): Event {
+  const event = new MouseEvent(type, { bubbles: true, clientX, clientY });
+  Object.defineProperties(event, {
+    pointerId: { value: pointerId },
+    pointerType: { value: 'touch' },
+  });
+  return event;
+}
+
+async function renderNextFrame(): Promise<void> {
+  await new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));
+}

src/app/shared/components/image-modal/image-modal.component.ts

@@ -0,0 +1,395 @@
+import {
+  ChangeDetectionStrategy,
+  Component,
+  DestroyRef,
+  ElementRef,
+  computed,
+  inject,
+  signal,
+  viewChild,
+} from '@angular/core';
+
+import { ImageModalData, MODAL_DATA, ModalRef } from '../../../core/services/modal.service';
+
+const SWIPE_DISMISS_DISTANCE = 100;
+const SWIPE_DIRECTION_RATIO = 1.25;
+
+interface Point {
+  x: number;
+  y: number;
+}
+
+interface ViewerGeometry {
+  imageHeight: number;
+  imageWidth: number;
+  viewportHeight: number;
+  viewportLeft: number;
+  viewportTop: number;
+  viewportWidth: number;
+}
+
+@Component({
+  selector: 'app-image-modal',
+  templateUrl: './image-modal.component.html',
+  styleUrl: './image-modal.component.scss',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ImageModalComponent {
+  protected readonly data = inject<ImageModalData>(MODAL_DATA);
+  private readonly modalRef = inject<ModalRef<void>>(ModalRef);
+  private readonly destroyRef = inject(DestroyRef);
+  private readonly viewport = viewChild.required<ElementRef<HTMLElement>>('viewport');
+  private readonly image = viewChild<ElementRef<HTMLImageElement>>('image');
+  private readonly pointers = new Map<number, Point>();
+
+  protected readonly zoom = signal(this.data.initialZoom);
+  protected readonly offsetX = signal(0);
+  protected readonly offsetY = signal(0);
+  protected readonly imageFailed = signal(false);
+  protected readonly swipeOffsetY = signal(0);
+  protected readonly swipeSettling = signal(false);
+  protected readonly gestureActive = signal(false);
+  protected readonly transform = computed(
+    () => `translate3d(${this.offsetX()}px, ${this.offsetY()}px, 0) scale(${this.zoom()})`,
+  );
+  protected readonly zoomLabel = computed(() => `${Math.round(this.zoom() * 100)}%`);
+  protected readonly swipeTransform = computed(() => `translate3d(0, ${this.swipeOffsetY()}px, 0)`);
+
+  private dragStart: Point | null = null;
+  private dragOffset: Point = { x: 0, y: 0 };
+  private pinchDistance = 0;
+  private pinchZoom = 1;
+  private pinchLocal: Point = { x: 0, y: 0 };
+  private pointerDownAt: Point | null = null;
+  private gestureMoved = false;
+  private hadMultiplePointers = false;
+  private lastTapAt = 0;
+  private swipeStart: Point | null = null;
+  private geometry: ViewerGeometry | null = null;
+  private animationFrameId: number | null = null;
+
+  constructor() {
+    this.destroyRef.onDestroy(() => this.cancelGestureFrame());
+  }
+
+  protected zoomIn(): void {
+    this.setZoomAt(Math.min(this.data.maxZoom, this.zoom() + 0.5));
+  }
+
+  protected zoomOut(): void {
+    this.setZoomAt(Math.max(this.data.minZoom, this.zoom() - 0.5));
+  }
+
+  protected reset(): void {
+    this.zoom.set(this.data.initialZoom);
+    this.offsetX.set(0);
+    this.offsetY.set(0);
+  }
+
+  protected onWheel(event: WheelEvent): void {
+    event.preventDefault();
+    const factor = event.deltaY < 0 ? 1.15 : 1 / 1.15;
+    this.setZoomAt(this.zoom() * factor, event.clientX, event.clientY);
+  }
+
+  protected onDoubleClick(event: MouseEvent): void {
+    this.toggleZoom(event.clientX, event.clientY);
+  }
+
+  protected onPointerDown(event: PointerEvent): void {
+    if (event.pointerType === 'mouse' && event.button !== 0) {
+      return;
+    }
+
+    event.preventDefault();
+    if (this.pointers.size === 0) {
+      this.refreshGeometry();
+      this.gestureActive.set(true);
+    }
+    this.viewport().nativeElement.setPointerCapture?.(event.pointerId);
+    const point = { x: event.clientX, y: event.clientY };
+    this.pointers.set(event.pointerId, point);
+    this.pointerDownAt = point;
+    this.gestureMoved = false;
+
+    if (this.pointers.size === 1) {
+      this.swipeSettling.set(false);
+      this.dragStart = point;
+      this.dragOffset = { x: this.offsetX(), y: this.offsetY() };
+      this.swipeStart =
+        event.pointerType === 'touch' && this.zoom() <= this.data.minZoom + 0.01 ? point : null;
+    } else if (this.pointers.size === 2) {
+      this.hadMultiplePointers = true;
+      this.swipeStart = null;
+      this.swipeOffsetY.set(0);
+      this.beginPinch();
+    }
+  }
+
+  protected onPointerMove(event: PointerEvent): void {
+    if (!this.pointers.has(event.pointerId)) {
+      return;
+    }
+
+    const point = { x: event.clientX, y: event.clientY };
+    this.pointers.set(event.pointerId, point);
+
+    if (this.pointerDownAt && this.distance(this.pointerDownAt, point) > 4) {
+      this.gestureMoved = true;
+    }
+
+    this.scheduleGestureFrame();
+  }
+
+  protected onPointerUp(event: PointerEvent): void {
+    const wasTouch = event.pointerType === 'touch';
+    const trackedPoint = this.pointers.get(event.pointerId);
+    const endPoint = trackedPoint ? { x: event.clientX, y: event.clientY } : null;
+    if (endPoint) {
+      this.pointers.set(event.pointerId, endPoint);
+      if (this.animationFrameId !== null) {
+        this.flushGestureFrame();
+      } else {
+        this.applyPointerMovement();
+      }
+    }
+    const shouldDismiss =
+      event.type === 'pointerup' &&
+      wasTouch &&
+      endPoint !== null &&
+      this.isSwipeDown(this.swipeStart, endPoint);
+    this.pointers.delete(event.pointerId);
+    const viewport = this.viewport().nativeElement;
+    if (viewport.hasPointerCapture?.(event.pointerId)) {
+      viewport.releasePointerCapture(event.pointerId);
+    }
+
+    if (shouldDismiss) {
+      this.resetGesture();
+      this.modalRef.dismiss('swipe');
+      return;
+    }
+
+    if (wasTouch && endPoint && !this.gestureMoved && !this.hadMultiplePointers) {
+      const now = Date.now();
+      if (now - this.lastTapAt < 300) {
+        this.toggleZoom(endPoint.x, endPoint.y);
+        this.lastTapAt = 0;
+      } else {
+        this.lastTapAt = now;
+      }
+    }
+
+    if (this.pointers.size === 1) {
+      const remaining = [...this.pointers.values()][0];
+      this.dragStart = remaining;
+      this.dragOffset = { x: this.offsetX(), y: this.offsetY() };
+    } else if (this.pointers.size === 0) {
+      this.dragStart = null;
+      this.pointerDownAt = null;
+      this.hadMultiplePointers = false;
+      this.swipeStart = null;
+      this.gestureActive.set(false);
+      if (this.swipeOffsetY() > 0) {
+        this.swipeSettling.set(true);
+        this.swipeOffsetY.set(0);
+      }
+      this.clampOffset();
+    }
+  }
+
+  protected onImageLoad(): void {
+    this.imageFailed.set(false);
+    this.refreshGeometry();
+    this.clampOffset();
+  }
+
+  private beginPinch(): void {
+    const [first, second] = [...this.pointers.values()];
+    const midpoint = this.midpoint(first, second);
+    const geometry = this.geometry ?? this.refreshGeometry();
+    if (!geometry) {
+      return;
+    }
+
+    this.pinchDistance = Math.max(1, this.distance(first, second));
+    this.pinchZoom = this.zoom();
+    this.pinchLocal = {
+      x:
+        (midpoint.x - (geometry.viewportLeft + geometry.viewportWidth / 2) - this.offsetX()) /
+        this.zoom(),
+      y:
+        (midpoint.y - (geometry.viewportTop + geometry.viewportHeight / 2) - this.offsetY()) /
+        this.zoom(),
+    };
+  }
+
+  private toggleZoom(clientX?: number, clientY?: number): void {
+    const target =
+      this.zoom() > this.data.minZoom + 0.01
+        ? this.data.minZoom
+        : Math.min(this.data.maxZoom, Math.max(2, this.data.minZoom));
+    this.setZoomAt(target, clientX, clientY);
+  }
+
+  private setZoomAt(value: number, clientX?: number, clientY?: number): void {
+    const nextZoom = this.clampZoom(value);
+    const currentZoom = this.zoom();
+    const geometry = this.refreshGeometry();
+
+    if (clientX !== undefined && clientY !== undefined && currentZoom > 0 && geometry) {
+      const pointX = clientX - (geometry.viewportLeft + geometry.viewportWidth / 2);
+      const pointY = clientY - (geometry.viewportTop + geometry.viewportHeight / 2);
+      const localX = (pointX - this.offsetX()) / currentZoom;
+      const localY = (pointY - this.offsetY()) / currentZoom;
+      this.offsetX.set(pointX - localX * nextZoom);
+      this.offsetY.set(pointY - localY * nextZoom);
+    }
+
+    this.zoom.set(nextZoom);
+    if (nextZoom <= this.data.minZoom) {
+      this.offsetX.set(0);
+      this.offsetY.set(0);
+    }
+    this.clampOffset();
+  }
+
+  private clampZoom(value: number): number {
+    return Math.min(this.data.maxZoom, Math.max(this.data.minZoom, value));
+  }
+
+  private clampOffset(): void {
+    const geometry = this.geometry;
+    if (!geometry) {
+      return;
+    }
+
+    const maxX = Math.max(0, (geometry.imageWidth * this.zoom() - geometry.viewportWidth) / 2);
+    const maxY = Math.max(0, (geometry.imageHeight * this.zoom() - geometry.viewportHeight) / 2);
+
+    this.offsetX.set(Math.min(maxX, Math.max(-maxX, this.offsetX())));
+    this.offsetY.set(Math.min(maxY, Math.max(-maxY, this.offsetY())));
+  }
+
+  private midpoint(first: Point, second: Point): Point {
+    return { x: (first.x + second.x) / 2, y: (first.y + second.y) / 2 };
+  }
+
+  private distance(first: Point, second: Point): number {
+    return Math.hypot(second.x - first.x, second.y - first.y);
+  }
+
+  private isSwipeDown(start: Point | null, end: Point): boolean {
+    if (!start || this.hadMultiplePointers || this.zoom() > this.data.minZoom + 0.01) {
+      return false;
+    }
+
+    const deltaX = Math.abs(end.x - start.x);
+    const deltaY = end.y - start.y;
+    return deltaY >= SWIPE_DISMISS_DISTANCE && deltaY >= deltaX * SWIPE_DIRECTION_RATIO;
+  }
+
+  private resetGesture(): void {
+    this.cancelGestureFrame();
+    this.pointers.clear();
+    this.dragStart = null;
+    this.pointerDownAt = null;
+    this.swipeStart = null;
+    this.hadMultiplePointers = false;
+    this.gestureActive.set(false);
+  }
+
+  private scheduleGestureFrame(): void {
+    if (this.animationFrameId !== null) {
+      return;
+    }
+
+    this.animationFrameId = requestAnimationFrame(() => {
+      this.animationFrameId = null;
+      this.applyPointerMovement();
+    });
+  }
+
+  private flushGestureFrame(): void {
+    if (this.animationFrameId === null) {
+      return;
+    }
+
+    cancelAnimationFrame(this.animationFrameId);
+    this.animationFrameId = null;
+    this.applyPointerMovement();
+  }
+
+  private cancelGestureFrame(): void {
+    if (this.animationFrameId !== null) {
+      cancelAnimationFrame(this.animationFrameId);
+      this.animationFrameId = null;
+    }
+  }
+
+  private applyPointerMovement(): void {
+    if (this.pointers.size === 2) {
+      const [first, second] = [...this.pointers.values()];
+      const geometry = this.geometry;
+      if (!geometry) {
+        return;
+      }
+
+      const distance = this.distance(first, second);
+      const midpoint = this.midpoint(first, second);
+      const nextZoom = this.clampZoom(this.pinchZoom * (distance / this.pinchDistance));
+
+      this.zoom.set(nextZoom);
+      this.offsetX.set(
+        midpoint.x -
+          (geometry.viewportLeft + geometry.viewportWidth / 2) -
+          this.pinchLocal.x * nextZoom,
+      );
+      this.offsetY.set(
+        midpoint.y -
+          (geometry.viewportTop + geometry.viewportHeight / 2) -
+          this.pinchLocal.y * nextZoom,
+      );
+      this.clampOffset();
+      return;
+    }
+
+    if (this.pointers.size !== 1) {
+      return;
+    }
+
+    const point = [...this.pointers.values()][0];
+    if (this.swipeStart) {
+      const deltaX = Math.abs(point.x - this.swipeStart.x);
+      const deltaY = point.y - this.swipeStart.y;
+      this.swipeOffsetY.set(deltaY > 0 && deltaY >= deltaX ? deltaY : 0);
+      return;
+    }
+
+    if (this.dragStart && this.zoom() > this.data.minZoom) {
+      this.offsetX.set(this.dragOffset.x + point.x - this.dragStart.x);
+      this.offsetY.set(this.dragOffset.y + point.y - this.dragStart.y);
+      this.clampOffset();
+    }
+  }
+
+  private refreshGeometry(): ViewerGeometry | null {
+    const viewport = this.viewport().nativeElement;
+    const image = this.image()?.nativeElement;
+    if (!image) {
+      this.geometry = null;
+      return null;
+    }
+
+    const rect = viewport.getBoundingClientRect();
+    this.geometry = {
+      imageHeight: image.offsetHeight,
+      imageWidth: image.offsetWidth,
+      viewportHeight: viewport.clientHeight,
+      viewportLeft: rect.left,
+      viewportTop: rect.top,
+      viewportWidth: viewport.clientWidth,
+    };
+    return this.geometry;
+  }
+}

src/app/shared/components/modal-host/modal-host.component.html

@@ -2,6 +2,7 @@
   <app-modal-shell
     [title]="modal.config.title"
     [size]="modal.config.size"
+    [presentation]="modal.config.presentation ?? 'dialog'"
     [showCloseButton]="modal.config.showCloseButton"
     (backdropClick)="onBackdropClick()"
     (closeRequested)="onCloseRequested()"

src/app/shared/components/modal-host/modal-host.component.spec.ts

@@ -51,6 +51,10 @@ describe('ModalHostComponent', () => {
   afterEach(() => {
     doc.body.style.overflow = '';
     doc.body.style.paddingRight = '';
+    doc.body.style.position = '';
+    doc.body.style.top = '';
+    doc.body.style.left = '';
+    doc.body.style.width = '';
     TestBed.resetTestingModule();
   });
 
@@ -99,6 +103,10 @@ describe('ModalHostComponent', () => {
     expect(service.activeModal()).toBeNull();
     expect(doc.body.style.overflow).toBe('');
     expect(doc.body.style.paddingRight).toBe('');
+    expect(doc.body.style.position).toBe('');
+    expect(doc.body.style.top).toBe('');
+    expect(doc.body.style.left).toBe('');
+    expect(doc.body.style.width).toBe('');
   });
 
   it('closes on backdrop click when enabled', () => {

src/app/shared/components/modal-host/modal-host.component.ts

@@ -55,11 +55,23 @@ export class ModalHostComponent {
       const body = this.document.body;
       const previousOverflow = body.style.overflow;
       const previousPaddingRight = body.style.paddingRight;
+      const previousPosition = body.style.position;
+      const previousTop = body.style.top;
+      const previousLeft = body.style.left;
+      const previousWidth = body.style.width;
       const view = this.document.defaultView;
+      const scrollX = view?.scrollX ?? 0;
+      const scrollY = view?.scrollY ?? 0;
       const scrollbarWidth = view
         ? Math.max(0, view.innerWidth - this.document.documentElement.clientWidth)
         : 0;
 
+      const activeElement = this.document.activeElement;
+
+      if (activeElement instanceof HTMLElement && activeElement !== body) {
+        activeElement.blur();
+      }
+
       if (scrollbarWidth > 0 && view) {
         const currentPaddingRight =
           Number.parseFloat(view.getComputedStyle(body).paddingRight) || 0;
@@ -68,6 +80,47 @@ export class ModalHostComponent {
 
       body.style.overflow = 'hidden';
 
+      const isIos = view
+        ? /iPad|iPhone|iPod/.test(view.navigator.userAgent) ||
+          (view.navigator.platform === 'MacIntel' && view.navigator.maxTouchPoints > 1)
+        : false;
+
+      if (isIos) {
+        body.style.position = 'fixed';
+        body.style.top = `${-scrollY}px`;
+        body.style.left = `${-scrollX}px`;
+        body.style.width = '100%';
+      }
+
+      let viewportFrame: number | undefined;
+      const viewportSyncTimers: number[] = [];
+      const syncVisualViewport = () => {
+        if (!view) {
+          return;
+        }
+
+        if (viewportFrame !== undefined) {
+          view.cancelAnimationFrame(viewportFrame);
+        }
+
+        viewportFrame = view.requestAnimationFrame(() => {
+          viewportFrame = undefined;
+          this.modalShell()?.setVisualViewport(view.visualViewport, view.scrollX, view.scrollY);
+        });
+      };
+
+      view?.visualViewport?.addEventListener('resize', syncVisualViewport);
+      view?.visualViewport?.addEventListener('scroll', syncVisualViewport);
+      view?.addEventListener('orientationchange', syncVisualViewport);
+      syncVisualViewport();
+
+      if (view) {
+        viewportSyncTimers.push(
+          view.setTimeout(syncVisualViewport, 100),
+          view.setTimeout(syncVisualViewport, 300),
+        );
+      }
+
       const onKeyDown = (event: KeyboardEvent) => {
         if (event.key !== 'Escape' || !this.activeModal()?.config.closeOnEscape) {
           return;
@@ -82,8 +135,26 @@ export class ModalHostComponent {
 
       onCleanup(() => {
         this.document.removeEventListener('keydown', onKeyDown);
+        view?.visualViewport?.removeEventListener('resize', syncVisualViewport);
+        view?.visualViewport?.removeEventListener('scroll', syncVisualViewport);
+        view?.removeEventListener('orientationchange', syncVisualViewport);
+
+        if (viewportFrame !== undefined) {
+          view?.cancelAnimationFrame(viewportFrame);
+        }
+
+        viewportSyncTimers.forEach((timer) => view?.clearTimeout(timer));
+
         body.style.overflow = previousOverflow;
         body.style.paddingRight = previousPaddingRight;
+        body.style.position = previousPosition;
+        body.style.top = previousTop;
+        body.style.left = previousLeft;
+        body.style.width = previousWidth;
+
+        if (isIos) {
+          view?.scrollTo(scrollX, scrollY);
+        }
       });
     });
   }

src/app/shared/components/modal-shell/modal-shell.component.html

@@ -1,4 +1,9 @@
-<div class="modal-shell" (click)="backdropClick.emit()">
+<div
+  #shell
+  class="modal-shell"
+  [class.modal-shell--fullscreen-media]="presentation() === 'fullscreen-media'"
+  (click)="backdropClick.emit()"
+>
   <div
     class="modal-dialog modal-dialog-centered modal-dialog-scrollable modal-shell__dialog"
     [ngClass]="dialogClass()"

src/app/shared/components/modal-shell/modal-shell.component.scss

@@ -4,7 +4,10 @@
 
 .modal-shell {
   position: fixed;
-  inset: 0;
+  top: var(--modal-viewport-top, 0);
+  left: var(--modal-viewport-left, 0);
+  width: var(--modal-viewport-width, 100vw);
+  height: var(--modal-viewport-height, 100dvh);
   z-index: 2000;
   display: flex;
   align-items: center;
@@ -109,6 +112,64 @@
   color: #303030;
 }
 
+.modal-shell--fullscreen-media {
+  padding: 1.5rem;
+  background: rgba(0, 0, 0, 0.92);
+}
+
+.modal-shell--fullscreen-media .modal-shell__dialog {
+  width: 100%;
+  max-width: 100%;
+  height: calc(100dvh - 3rem);
+}
+
+.modal-shell--fullscreen-media .modal-shell__content {
+  min-height: 0;
+  height: 100%;
+  max-height: none;
+  overflow: hidden;
+  border-radius: 0.4rem;
+  background: #111111;
+}
+
+.modal-shell--fullscreen-media .modal-shell__header {
+  position: absolute;
+  inset: 0 0 auto;
+  z-index: 2;
+  justify-content: flex-start;
+  height: 0;
+  padding: 0;
+}
+
+.modal-shell--fullscreen-media .modal-shell__title {
+  position: absolute;
+  top: max(1.25rem, env(safe-area-inset-top));
+  left: max(1.25rem, env(safe-area-inset-left));
+  width: auto;
+  max-width: calc(100% - 8rem);
+  overflow: hidden;
+  color: #ffffff;
+  font-size: 1rem;
+  line-height: 1.4;
+  text-align: left;
+  text-overflow: ellipsis;
+  text-shadow: 0 1px 3px #000000;
+  white-space: nowrap;
+}
+
+.modal-shell--fullscreen-media .modal-shell__header .btn-close {
+  top: max(1rem, env(safe-area-inset-top));
+  right: max(1rem, env(safe-area-inset-right));
+  filter: invert(1) grayscale(1) brightness(2) drop-shadow(0 1px 2px #000000);
+}
+
+.modal-shell--fullscreen-media .modal-shell__body {
+  min-height: 0;
+  padding: 0;
+  overflow: hidden;
+  color: #ffffff;
+}
+
 @media (max-width: 576px) {
   .modal-shell {
     padding: 0.75rem;
@@ -128,4 +189,18 @@
     max-height: min(100dvh - 1.5rem, 48rem);
     border-radius: 1.25rem 1.25rem 0.75rem 0.75rem;
   }
+
+  .modal-shell--fullscreen-media {
+    align-items: center;
+    padding: 0;
+  }
+
+  .modal-shell--fullscreen-media .modal-shell__dialog {
+    height: 100dvh;
+  }
+
+  .modal-shell--fullscreen-media .modal-shell__content {
+    max-height: none;
+    border-radius: 0;
+  }
 }

src/app/shared/components/modal-shell/modal-shell.component.ts

@@ -9,7 +9,7 @@ import {
   viewChild,
 } from '@angular/core';
 
-import { ModalSize } from '../../../core/services/modal.service';
+import { ModalPresentation, ModalSize } from '../../../core/services/modal.service';
 
 @Component({
   selector: 'app-modal-shell',
@@ -19,10 +19,12 @@ import { ModalSize } from '../../../core/services/modal.service';
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
 export class ModalShellComponent {
+  private readonly shell = viewChild.required<ElementRef<HTMLElement>>('shell');
   private readonly panel = viewChild.required<ElementRef<HTMLElement>>('panel');
 
   readonly title = input<string | undefined>();
   readonly size = input<ModalSize>('md');
+  readonly presentation = input<ModalPresentation>('dialog');
   readonly showCloseButton = input(true);
 
   readonly backdropClick = output<void>();
@@ -46,6 +48,28 @@ export class ModalShellComponent {
     return this.title() ? this.titleId : null;
   }
 
+  setVisualViewport(viewport: VisualViewport | null, layoutScrollX = 0, layoutScrollY = 0): void {
+    const shell = this.shell().nativeElement;
+
+    if (!viewport) {
+      shell.style.removeProperty('--modal-viewport-top');
+      shell.style.removeProperty('--modal-viewport-left');
+      shell.style.removeProperty('--modal-viewport-width');
+      shell.style.removeProperty('--modal-viewport-height');
+      return;
+    }
+
+    // pageTop/pageLeft are a useful fallback for WebKit versions that update
+    // offsetTop/offsetLeft one frame late after dismissing a native control.
+    const top = Math.max(viewport.offsetTop, viewport.pageTop - layoutScrollY);
+    const left = Math.max(viewport.offsetLeft, viewport.pageLeft - layoutScrollX);
+
+    shell.style.setProperty('--modal-viewport-top', `${top}px`);
+    shell.style.setProperty('--modal-viewport-left', `${left}px`);
+    shell.style.setProperty('--modal-viewport-width', `${viewport.width}px`);
+    shell.style.setProperty('--modal-viewport-height', `${viewport.height}px`);
+  }
+
   focusInitialElement(): void {
     const panel = this.panel().nativeElement;
     const focusTarget = panel.querySelector<HTMLElement>(

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

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

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

@@ -6,7 +6,6 @@ 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,
@@ -24,7 +23,6 @@ describe('ProductListComponent', () => {
       descripcion: 'Primera descripcion',
       precio: '100.00',
       image: '/images/one.png',
-      availability: createCatalogAvailability(null),
       variants: [],
     },
     {
@@ -34,7 +32,6 @@ describe('ProductListComponent', () => {
       descripcion: 'Segunda descripcion',
       precio: 200,
       image: null,
-      availability: createCatalogAvailability(null),
       variants: [],
     },
   ];
@@ -59,20 +56,6 @@ 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,
@@ -90,12 +73,7 @@ describe('ProductListComponent', () => {
     await TestBed.configureTestingModule({
       imports: [ProductListComponent],
       providers: [
-        {
-          provide: CatalogService,
-          useValue: {
-            withoutLoading: () => ({ getVariantOptions }),
-          },
-        },
+        { provide: CatalogService, useValue: { getVariantOptions } },
         { provide: CartService, useValue: {} },
       ],
     }).compileComponents();
@@ -215,8 +193,8 @@ describe('ProductListComponent', () => {
     const itemWithVariants: ProductListItem = {
       ...items[0],
       variants: [
-        { id: 91, availability: createCatalogAvailability(3), values: { fecha: '10 de octubre' } },
-        { id: 92, availability: createCatalogAvailability(4), values: { fecha: '11 de octubre' } },
+        { id: 91, maximum_addable_quantity: 3, values: { fecha: '10 de octubre' } },
+        { id: 92, maximum_addable_quantity: 4, values: { fecha: '11 de octubre' } },
       ],
     };
     const fixture = await render('column_with_cart', [itemWithVariants]);
@@ -242,7 +220,7 @@ describe('ProductListComponent', () => {
       variants: [
         {
           id: 91,
-          availability: createCatalogAvailability(2),
+          maximum_addable_quantity: 2,
           values: { fecha: '10 de octubre' },
         },
       ],
@@ -270,7 +248,7 @@ describe('ProductListComponent', () => {
       variants: [
         {
           id: 91,
-          availability: createCatalogAvailability(0),
+          maximum_addable_quantity: 0,
           values: { fecha: '10 de octubre' },
         },
       ],
@@ -326,7 +304,7 @@ describe('ProductListComponent', () => {
         {
           id: 401,
           precio: '10000.00',
-          availability: createCatalogAvailability(1),
+          maximum_addable_quantity: 1,
           values: {
             tipo: { value: 'vip', label: 'VIP' },
             sector: { value: 'a', label: 'Sector A' },
@@ -337,7 +315,7 @@ describe('ProductListComponent', () => {
         {
           id: 402,
           precio: '12000.00',
-          availability: createCatalogAvailability(1),
+          maximum_addable_quantity: 1,
           values: {
             tipo: { value: 'vip', label: 'VIP' },
             sector: { value: 'a', label: 'Sector A' },

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

@@ -18,11 +18,6 @@ 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';
@@ -79,7 +74,6 @@ 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(),
@@ -114,14 +108,6 @@ 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,14 +21,13 @@
         <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]="!allows(effectiveAvailability(), 'change_quantity')"
+          [disabled]="unavailable()"
         />
       </div>
 
@@ -39,22 +38,14 @@
 
     <div class="product-row-card__buttons">
       <div class="product-row-card__btn-wrapper">
-        <app-button
-          variant="primary"
-          [disabled]="!hasPurchasableSelection() || !allows(effectiveAvailability(), 'buy_now')"
-          (click)="onBuy()"
-        >
+        <app-button variant="primary" [disabled]="unavailable()" (click)="onBuy()">
           Comprar
         </app-button>
       </div>
       <div class="product-row-card__btn-wrapper">
         <app-button
           variant="secondary"
-          [disabled]="
-            saving() ||
-            !hasPurchasableSelection() ||
-            !allows(effectiveAvailability(), 'add_to_cart')
-          "
+          [disabled]="saving() || unavailable()"
           (click)="onAddToCart()"
         >
           {{ saving() ? 'Guardando' : 'Agregar al carrito' }}

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

@@ -14,20 +14,13 @@ 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;
-  availability?: CatalogAvailability;
+  maximum_addable_quantity?: number | null;
+  unavailable_message?: string | null;
 }
 
 @Component({
@@ -43,7 +36,8 @@ export class ProductRowCardComponent {
   readonly title = input<string>('');
   readonly description = input<string>('');
   readonly price = input<number>(0);
-  readonly availability = input<CatalogAvailability>(AVAILABLE_CATALOG_AVAILABILITY);
+  readonly maximumAddableQuantity = input<number | null>(null);
+  readonly unavailableMessage = input<string | null>(null);
   readonly variants = input<Variant[]>([]);
   readonly saving = input(false);
 
@@ -66,22 +60,19 @@ export class ProductRowCardComponent {
 
     return Number.isFinite(variantPrice) ? variantPrice : this.price();
   });
-  protected readonly effectiveAvailability = computed(() =>
-    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 effectiveMaximum = computed(
+    () => this.selectedVariantData()?.maximum_addable_quantity ?? this.maximumAddableQuantity(),
   );
+  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(() => {
@@ -94,11 +85,7 @@ export class ProductRowCardComponent {
   }
 
   protected onAddToCart(): void {
-    if (
-      this.saving() ||
-      !this.hasPurchasableSelection() ||
-      !this.allows(this.effectiveAvailability(), 'add_to_cart')
-    ) {
+    if (this.saving() || this.unavailable()) {
       return;
     }
 
@@ -109,8 +96,7 @@ export class ProductRowCardComponent {
   }
 
   protected onBuy(): void {
-    if (!this.hasPurchasableSelection() || !this.allows(this.effectiveAvailability(), 'buy_now'))
-      return;
+    if (this.unavailable()) return;
 
     this.buy.emit({
       quantity: this.quantity(),

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

@@ -107,6 +107,17 @@
   </div>
 
   @if (imageUrl(); as image) {
-    <img class="ticket-selector__map" [src]="image" [alt]="'Plano de ubicaciones de ' + title()" />
+    <button
+      type="button"
+      class="ticket-selector__map-button"
+      aria-label="Ampliar plano de ubicaciones"
+      (click)="openImage(image)"
+    >
+      <img
+        class="ticket-selector__map"
+        [src]="image"
+        [alt]="'Plano de ubicaciones de ' + title()"
+      />
+    </button>
   }
 </article>

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

@@ -153,11 +153,27 @@
     margin-top: 0.75rem;
   }
 
-  &__map {
+  &__map-button {
     display: block;
     width: min(100%, 720px);
-    max-height: 680px;
     margin: 3rem auto 0;
+    padding: 0;
+    overflow: hidden;
+    border: 0;
+    border-radius: 0.4rem;
+    background: transparent;
+    cursor: zoom-in;
+
+    &:focus-visible {
+      outline: 3px solid var(--tenant-primary);
+      outline-offset: 0.25rem;
+    }
+  }
+
+  &__map {
+    display: block;
+    width: 100%;
+    max-height: 680px;
     object-fit: contain;
   }
 }
@@ -188,7 +204,7 @@
       display: none;
     }
 
-    &__map {
+    &__map-button {
       margin-top: 2rem;
     }
   }

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

@@ -104,6 +104,10 @@ describe('ProductTicketSelectorComponent', () => {
     };
     catalogService.withoutLoading.mockReturnValue(catalogService);
     cartService.withoutLoading.mockReturnValue(cartService);
+    const modalService = {
+      openConfirmDelete: vi.fn().mockReturnValue(of(true)),
+      openImage: vi.fn(),
+    };
 
     await TestBed.configureTestingModule({
       imports: [ProductTicketSelectorComponent],
@@ -112,7 +116,7 @@ describe('ProductTicketSelectorComponent', () => {
         { provide: CartService, useValue: cartService },
         {
           provide: ModalService,
-          useValue: { openConfirmDelete: vi.fn().mockReturnValue(of(true)) },
+          useValue: modalService,
         },
         { provide: ToastService, useValue: { danger: toastDanger } },
       ],
@@ -125,7 +129,7 @@ describe('ProductTicketSelectorComponent', () => {
     await fixture.whenStable();
     fixture.detectChanges();
 
-    return { fixture, getVariantOptions, cartService, toastDanger };
+    return { fixture, getVariantOptions, cartService, toastDanger, modalService };
   }
 
   it('loads one map, recalculates the cascade locally and reserves only after the last select', async () => {
@@ -226,6 +230,25 @@ describe('ProductTicketSelectorComponent', () => {
     ]);
   });
 
+  it('opens the zoomable image modal when the seating map is clicked', async () => {
+    const { fixture, modalService } = await createComponent({
+      maps: [mapResponse([variant(401, 'general', 'A', '1', '1')])],
+    });
+    fixture.componentRef.setInput('imageUrl', '/images/plano.png');
+    fixture.detectChanges();
+
+    const button = fixture.nativeElement.querySelector(
+      'button[aria-label="Ampliar plano de ubicaciones"]',
+    ) as HTMLButtonElement;
+    button.click();
+
+    expect(modalService.openImage).toHaveBeenCalledWith({
+      title: 'Entrada',
+      src: '/images/plano.png',
+      alt: 'Plano de ubicaciones de Entrada',
+    });
+  });
+
   it('clears only the seat after a stock conflict when the row still has alternatives', async () => {
     const failed = variant(401, 'general', 'A', '1', '1');
     const alternative = variant(402, 'general', 'A', '1', '2');

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

@@ -23,10 +23,6 @@ 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';
@@ -158,6 +154,14 @@ export class ProductTicketSelectorComponent {
     if (this.hasSelection() && variantIds.length > 0) this.buy.emit(variantIds);
   }
 
+  protected openImage(src: string): void {
+    this.modalService.openImage({
+      title: this.title(),
+      src,
+      alt: `Plano de ubicaciones de ${this.title()}`,
+    });
+  }
+
   protected addRow(): void {
     if (!this.canAddRow()) return;
     const row = this.createRow(this.nextRowId++);
@@ -357,11 +361,7 @@ export class ProductTicketSelectorComponent {
     if (reservedVariant !== null && !variants.some(({ id }) => id === reservedVariant.id)) {
       variants.push(reservedVariant);
     }
-    return variants.filter(
-      ({ id, availability }) =>
-        (availability === undefined || allowsCatalogAction(availability, 'select_variant')) &&
-        !reservedByOtherRows.has(id),
-    );
+    return variants.filter(({ id }) => !reservedByOtherRows.has(id));
   }
 
   private reservedVariantData(row: TicketSelectionRow): CatalogFeaturedItemVariant | null {
@@ -371,9 +371,7 @@ export class ProductTicketSelectorComponent {
     return {
       id: item.variant.id,
       precio: item.variant.precio,
-      availability: createCatalogAvailability(
-        item.variant.stock_tecnico === null ? null : item.variant.stock_tecnico + item.cantidad,
-      ),
+      maximum_addable_quantity: item.variant.stock_tecnico,
       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]="!allows(effectiveAvailability(), 'change_quantity')"
+          [disabled]="unavailable()"
         />
       </div>
     } @else {
@@ -29,16 +29,12 @@
           <app-quantity-selector
             [(quantity)]="quantity"
             [max]="effectiveMaximum()"
-            [disabled]="!allows(effectiveAvailability(), 'change_quantity')"
+            [disabled]="unavailable()"
           />
         </div>
 
         <div class="product-vertical-with-cart-card__variant-selectors">
-          <app-variant-selector
-            [variants]="variants()"
-            [disabled]="!allows(availability(), 'select_variant')"
-            [(selectedVariant)]="selectedVariant"
-          />
+          <app-variant-selector [variants]="variants()" [(selectedVariant)]="selectedVariant" />
         </div>
       </div>
     }
@@ -46,21 +42,14 @@
     <div class="product-vertical-with-cart-card__actions">
       <app-button
         variant="primary"
-        [disabled]="
-          !allows(effectiveAvailability(), 'buy_now') ||
-          (hasVariants() && selectedVariant() === null)
-        "
+        [disabled]="unavailable() || (hasVariants() && selectedVariant() === null)"
         (click)="onBuy()"
       >
         Comprar
       </app-button>
       <app-button
         variant="secondary"
-        [disabled]="
-          saving() ||
-          !allows(effectiveAvailability(), 'add_to_cart') ||
-          (hasVariants() && selectedVariant() === null)
-        "
+        [disabled]="saving() || unavailable() || (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.scss

@@ -17,7 +17,7 @@
   height: 100%;
   box-sizing: border-box;
   padding: 30px 20px;
-  overflow: hidden;
+  overflow: visible;
   background-color: #ffffff;
   border: 1px solid var(--border-color);
   border-radius: 7px;

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

@@ -58,17 +58,11 @@ describe('ProductVerticalWithCartCardComponent', () => {
 
   it('shows the backend availability message with the reusable tooltip', async () => {
     const fixture = await createComponent();
-    fixture.componentRef.setInput('availability', {
-      state: 'visible',
-      maximum_quantity: 0,
-      reasons: [
-        {
-          code: 'user_quota_reached',
-          message: 'Alcanzaste el cupo máximo permitido para este producto.',
-        },
-      ],
-      allowed_actions: [],
-    });
+    fixture.componentRef.setInput('maximumAddableQuantity', 0);
+    fixture.componentRef.setInput(
+      'unavailableMessage',
+      'Alcanzaste el cupo máximo permitido para este producto.',
+    );
     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,19 +15,12 @@ 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;
-  availability?: CatalogAvailability;
+  maximum_addable_quantity?: number | null;
+  unavailable_message?: string | null;
 }
 
 @Component({
@@ -41,7 +34,8 @@ export class ProductVerticalWithCartCardComponent {
   readonly title = input<string>('');
   readonly description = input<string>('');
   readonly price = input<number>(0);
-  readonly availability = input<CatalogAvailability>(AVAILABLE_CATALOG_AVAILABILITY);
+  readonly maximumAddableQuantity = input<number | null>(null);
+  readonly unavailableMessage = input<string | null>(null);
   readonly variants = input<VerticalCartVariant[]>([]);
   readonly saving = input(false);
 
@@ -64,16 +58,17 @@ export class ProductVerticalWithCartCardComponent {
   });
   protected readonly formattedPrice = computed(() => this.formatCurrency(this.effectivePrice()));
   protected readonly hasVariants = computed(() => this.variants().length > 0);
-  protected readonly effectiveAvailability = computed(() =>
-    combineCatalogAvailability(this.availability(), this.selectedVariantData()?.availability),
+  protected readonly effectiveMaximum = computed(
+    () => this.selectedVariantData()?.maximum_addable_quantity ?? this.maximumAddableQuantity(),
   );
-  protected readonly effectiveMaximum = computed(() =>
-    maximumCatalogQuantity(this.effectiveAvailability()),
-  );
-  protected readonly effectiveUnavailableMessage = computed(() =>
-    primaryAvailabilityMessage(this.effectiveAvailability()),
-  );
-  protected readonly allows = allowsCatalogAction;
+  protected readonly unavailable = computed(() => this.effectiveMaximum() === 0);
+  protected readonly effectiveUnavailableMessage = computed(() => {
+    const selectedVariant = this.selectedVariantData();
+
+    return selectedVariant
+      ? (selectedVariant.unavailable_message ?? null)
+      : this.unavailableMessage();
+  });
 
   constructor() {
     effect(() => {
@@ -86,7 +81,7 @@ export class ProductVerticalWithCartCardComponent {
   }
 
   protected onAddToCart(): void {
-    if (this.saving() || !this.allows(this.effectiveAvailability(), 'add_to_cart')) {
+    if (this.saving() || this.unavailable()) {
       return;
     }
 
@@ -94,7 +89,7 @@ export class ProductVerticalWithCartCardComponent {
   }
 
   protected onBuy(): void {
-    if (!this.allows(this.effectiveAvailability(), 'buy_now')) return;
+    if (this.unavailable()) return;
 
     this.buy.emit({ quantity: this.quantity(), variant: this.selectedVariant() });
   }

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

@@ -62,8 +62,6 @@ describe('VariantSelectorComponent', () => {
     ]);
     fixture.componentRef.setInput('selectedVariant', 2);
     fixture.detectChanges();
-    await fixture.whenStable();
-    fixture.detectChanges();
 
     const selects = Array.from(
       fixture.nativeElement.querySelectorAll('select'),
@@ -82,28 +80,6 @@ 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,8 +10,6 @@ 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;
@@ -24,7 +22,6 @@ export type VariantAttributeValue = VariantAttributeScalar | VariantAttributeSca
 export interface VariantSelectorVariant {
   id: unknown;
   values: Record<string, VariantAttributeValue>;
-  availability?: CatalogAvailability;
 }
 
 export interface VariantSelectorSelectionChange {
@@ -67,12 +64,10 @@ export class VariantSelectorComponent {
     right: VariantAttributeValue | null,
   ): boolean => left !== null && right !== null && this.sameValue(left, right);
   protected readonly attributeKeys = computed(() =>
-    Array.from(
-      new Set(this.getSelectableVariants().flatMap((variant) => Object.keys(variant.values))),
-    ),
+    Array.from(new Set(this.variants().flatMap((variant) => Object.keys(variant.values)))),
   );
   protected readonly selectors = computed<VariantSelectorGroup[]>(() => {
-    const variants = this.getSelectableVariants();
+    const variants = this.variants();
     const keys = this.attributeKeys();
     const selectedValues = this.selectedValues();
 
@@ -115,7 +110,7 @@ export class VariantSelectorComponent {
     });
 
     effect(() => {
-      const variants = this.getSelectableVariants();
+      const variants = this.variants();
       const selectedVariant = this.selectedVariant();
       const autoSelectFirst = this.autoSelectFirst();
 
@@ -144,7 +139,7 @@ export class VariantSelectorComponent {
   }
 
   protected onValueChange(key: string, value: VariantAttributeValue | null): void {
-    const variants = this.getSelectableVariants();
+    const variants = this.variants();
     const keys = this.attributeKeys();
     const changedIndex = keys.indexOf(key);
     const values = { ...this.selectedValues() };
@@ -203,14 +198,6 @@ 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: false,
+  production: true,
   nombre:"Homologación - activo",
   url:"https://backend.qa.shopit.com.ar/api/",
   urlDescarga:"url/"

src/index.html

@@ -1,13 +1,16 @@
 <!doctype html>
 <html lang="es">
-<head>
-  <meta charset="utf-8">
-  <title>ShopitFront</title>
-  <base href="/">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <link rel="icon" type="image/x-icon" href="favicon.ico">
-</head>
-<body>
-  <app-root></app-root>
-</body>
+  <head>
+    <meta charset="utf-8" />
+    <title>ShopitFront</title>
+    <base href="/" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, viewport-fit=cover"
+    />
+    <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg'/%3E" />
+  </head>
+  <body>
+    <app-root></app-root>
+  </body>
 </html>

src/styles.scss

@@ -6,6 +6,15 @@
 
 @import '../node_modules/bootstrap/scss/bootstrap';
 
+html,
+body,
+app-root {
+  width: 100%;
+  min-height: 100%;
+  margin: 0;
+  background: #f5f5f5;
+}
+
 :root,
 app-root {
   --border-color: #dddddd;