feat(web): add ErrorBoundary, PageErrorBoundary, ComponentErrorBoundary

Implements GOO-63 audit requirement — React error boundaries with
Vietnamese-language fallback UI, Sentry capture, and "Thử lại" retry.

- ErrorBoundary: generic class component wrapping Sentry.captureException
- PageErrorBoundary: full-page fallback for route layouts
- ComponentErrorBoundary: inline widget fallback (compact + standard modes)
- Applied to ListingMap, CheckoutModal, SearchResults as first targets

Co-Authored-By: Paperclip <noreply@paperclip.ing>

apps/api/src/modules/notifications/application/__tests__/listing-expiring.listener.spec.ts

@@ -0,0 +1,174 @@
+import { ListingExpiringEvent } from '../../../listings/domain/events/listing-expiring.event';
+import type { SendNotificationCommand } from '../commands/send-notification/send-notification.command';
+import { ListingExpiringListener } from '../listeners/listing-expiring.listener';
+
+describe('ListingExpiringListener', () => {
+  let listener: ListingExpiringListener;
+  let mockCommandBus: { execute: ReturnType<typeof vi.fn> };
+  let mockPrisma: {
+    listing: { findUnique: ReturnType<typeof vi.fn> };
+  };
+  let mockLogger: {
+    log: ReturnType<typeof vi.fn>;
+    warn: ReturnType<typeof vi.fn>;
+    error: ReturnType<typeof vi.fn>;
+  };
+
+  const expiresAt = new Date(Date.now() + 2 * 24 * 60 * 60 * 1000);
+
+  beforeEach(() => {
+    mockCommandBus = { execute: vi.fn().mockResolvedValue(undefined) };
+    mockPrisma = {
+      listing: { findUnique: vi.fn() },
+    };
+    mockLogger = { log: vi.fn(), warn: vi.fn(), error: vi.fn() };
+
+    listener = new ListingExpiringListener(
+      mockCommandBus as any,
+      mockPrisma as any,
+      mockLogger as any,
+    );
+  });
+
+  it('sends both email and Zalo OA notifications when seller has email and phone', async () => {
+    mockPrisma.listing.findUnique.mockResolvedValue({
+      id: 'listing-1',
+      property: { title: 'Căn hộ Quận 7' },
+      seller: { id: 'seller-1', email: 'seller@example.com', phone: '0901234567' },
+    });
+
+    const event = new ListingExpiringEvent('listing-1', 'seller-1', expiresAt);
+    await listener.handle(event);
+
+    expect(mockCommandBus.execute).toHaveBeenCalledTimes(2);
+
+    const commands = mockCommandBus.execute.mock.calls.map((c) => c[0]) as SendNotificationCommand[];
+
+    // Email notification
+    const emailCmd = commands.find((c) => c.channel === 'EMAIL')!;
+    expect(emailCmd.userId).toBe('seller-1');
+    expect(emailCmd.templateKey).toBe('listing.expiring');
+    expect(emailCmd.recipientAddress).toBe('seller@example.com');
+    expect(emailCmd.templateData).toEqual(
+      expect.objectContaining({
+        listingTitle: 'Căn hộ Quận 7',
+        expiresAt: expiresAt.toISOString(),
+      }),
+    );
+
+    // Zalo OA notification
+    const zaloCmd = commands.find((c) => c.channel === 'ZALO_OA')!;
+    expect(zaloCmd.userId).toBe('seller-1');
+    expect(zaloCmd.templateKey).toBe('listing.expiring');
+    expect(zaloCmd.recipientAddress).toBe('0901234567');
+  });
+
+  it('sends only email when seller has no phone', async () => {
+    mockPrisma.listing.findUnique.mockResolvedValue({
+      id: 'listing-1',
+      property: { title: 'Nhà phố Quận 1' },
+      seller: { id: 'seller-1', email: 'seller@example.com', phone: null },
+    });
+
+    const event = new ListingExpiringEvent('listing-1', 'seller-1', expiresAt);
+    await listener.handle(event);
+
+    expect(mockCommandBus.execute).toHaveBeenCalledTimes(1);
+
+    const cmd = mockCommandBus.execute.mock.calls[0]![0] as SendNotificationCommand;
+    expect(cmd.channel).toBe('EMAIL');
+    expect(cmd.recipientAddress).toBe('seller@example.com');
+  });
+
+  it('sends only Zalo OA when seller has no email', async () => {
+    mockPrisma.listing.findUnique.mockResolvedValue({
+      id: 'listing-1',
+      property: { title: 'Biệt thự Thảo Điền' },
+      seller: { id: 'seller-1', email: null, phone: '0909876543' },
+    });
+
+    const event = new ListingExpiringEvent('listing-1', 'seller-1', expiresAt);
+    await listener.handle(event);
+
+    expect(mockCommandBus.execute).toHaveBeenCalledTimes(1);
+
+    const cmd = mockCommandBus.execute.mock.calls[0]![0] as SendNotificationCommand;
+    expect(cmd.channel).toBe('ZALO_OA');
+    expect(cmd.recipientAddress).toBe('0909876543');
+  });
+
+  it('skips notification when listing not found', async () => {
+    mockPrisma.listing.findUnique.mockResolvedValue(null);
+
+    const event = new ListingExpiringEvent('nonexistent', 'seller-1', expiresAt);
+    await listener.handle(event);
+
+    expect(mockCommandBus.execute).not.toHaveBeenCalled();
+  });
+
+  it('sends no notifications when seller has neither email nor phone', async () => {
+    mockPrisma.listing.findUnique.mockResolvedValue({
+      id: 'listing-1',
+      property: { title: 'Căn hộ mini' },
+      seller: { id: 'seller-1', email: null, phone: null },
+    });
+
+    const event = new ListingExpiringEvent('listing-1', 'seller-1', expiresAt);
+    await listener.handle(event);
+
+    expect(mockCommandBus.execute).not.toHaveBeenCalled();
+  });
+
+  it('includes correct daysRemaining in templateData', async () => {
+    const twoDaysFromNow = new Date(Date.now() + 2 * 24 * 60 * 60 * 1000);
+    mockPrisma.listing.findUnique.mockResolvedValue({
+      id: 'listing-1',
+      property: { title: 'Căn hộ' },
+      seller: { id: 'seller-1', email: 'test@example.com', phone: null },
+    });
+
+    const event = new ListingExpiringEvent('listing-1', 'seller-1', twoDaysFromNow);
+    await listener.handle(event);
+
+    const cmd = mockCommandBus.execute.mock.calls[0]![0] as SendNotificationCommand;
+    expect(cmd.templateData).toHaveProperty('daysRemaining');
+    expect(cmd.templateData.daysRemaining).toBeGreaterThanOrEqual(1);
+    expect(cmd.templateData.daysRemaining).toBeLessThanOrEqual(3);
+  });
+
+  it('uses Promise.allSettled so one notification failure does not block the other', async () => {
+    mockPrisma.listing.findUnique.mockResolvedValue({
+      id: 'listing-1',
+      property: { title: 'Căn hộ' },
+      seller: { id: 'seller-1', email: 'seller@example.com', phone: '0901234567' },
+    });
+
+    // Email fails, Zalo succeeds
+    mockCommandBus.execute
+      .mockRejectedValueOnce(new Error('SMTP down'))
+      .mockResolvedValueOnce(undefined);
+
+    const event = new ListingExpiringEvent('listing-1', 'seller-1', expiresAt);
+
+    // Should not throw even though email notification failed
+    await expect(listener.handle(event)).resolves.toBeUndefined();
+
+    // Both notifications were attempted
+    expect(mockCommandBus.execute).toHaveBeenCalledTimes(2);
+  });
+
+  it('queries listing with correct include shape', async () => {
+    mockPrisma.listing.findUnique.mockResolvedValue(null);
+
+    const event = new ListingExpiringEvent('listing-1', 'seller-1', expiresAt);
+    await listener.handle(event);
+
+    expect(mockPrisma.listing.findUnique).toHaveBeenCalledWith({
+      where: { id: 'listing-1' },
+      include: {
+        property: { select: { title: true } },
+        seller: { select: { id: true, email: true, phone: true } },
+      },
+    });
+  });
+});