@iblai/iblai-js 1.4.2 → 1.4.4

package/dist/playwright/index.esm.js

@@ -824,6 +824,7 @@ async function expectNoAccessibilityViolationsOnDialogs(page, rules, exclude = [
     expect(results.violations).toEqual([]);
 }
 
+const deferredNotificationText = 'You will be notified once the report is available.';
 async function inviteUserTest(page, inviteModal) {
     const emailInput = inviteModal.locator('#email-invite');
     await expect(emailInput).toBeVisible({ timeout: 10000 });
@@ -847,6 +848,28 @@ async function navigateToAccountComponent(page, profileBtn) {
     await expect(tenantDialog).toBeVisible();
     return tenantDialog;
 }
+/**
+ * Click a report card's primary action and confirm the date-range picker, so callers
+ * always end up in the post-generation state.
+ *
+ * Prefers the "Regenerate report" button when present (completed reports) because the plain
+ * "Download report" button on a completed card re-downloads the existing URL and skips the
+ * picker. When no Regenerate button exists, clicks "Download report" — which on a
+ * non-completed card also opens the picker.
+ *
+ * Either way we wait for the picker and click Generate/Regenerate to start the report.
+ */
+async function triggerReportFromCard(page, card) {
+    const regenerateButton = card.getByRole('button', { name: 'Regenerate report' });
+    const downloadButton = card.getByRole('button', { name: 'Download report' });
+    const hasRegenerate = await regenerateButton.isVisible().catch(() => false);
+    const trigger = hasRegenerate ? regenerateButton : downloadButton;
+    await trigger.click();
+    const dateRangePopover = page.getByTestId('report-date-range-popover');
+    await expect(dateRangePopover).toBeVisible({ timeout: 10000 });
+    await dateRangePopover.getByRole('button', { name: /^(Generate|Regenerate)$/ }).click();
+    await expect(dateRangePopover).not.toBeVisible({ timeout: 10000 });
+}
 async function navigateToDataReports(page) {
     const dataReportsTab = page.getByRole('tab', { name: 'Data Reports' });
     await expect(dataReportsTab).toBeVisible({ timeout: 120000 });
@@ -898,14 +921,40 @@ async function shouldOpenCSVEditorDialog(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
+    await triggerReportFromCard(page, userReportCard);
+    //expect Report generation processing...
+    await expect(page.getByText('Report generation processing...')).toBeVisible({ timeout: 5000 });
+    // After the processing toast appears, the backend either finishes in time (CSV editor opens)
+    // or polling times out (deferred-notification toast appears). Treat both as valid outcomes.
+    await waitForReportOutcomeOrCSVDialogOpen(page);
+}
+async function waitForReportOutcomeOrCSVDialogOpen(page) {
+    const csvEditorDialog = page.getByRole('dialog', { name: 'Edit CSV Data' });
+    const deferredNotification = page.getByText(deferredNotificationText);
+    const downloadPromise = page.waitForEvent('download', { timeout: 60000 });
+    const outcome = await Promise.race([
+        csvEditorDialog
+            .waitFor({ state: 'visible', timeout: 60000 })
+            .then(() => 'csv-editor'),
+        deferredNotification
+            .waitFor({ state: 'visible', timeout: 60000 })
+            .then(() => 'deferred'),
+        downloadPromise.then(() => 'download'),
+    ]).catch(() => null);
+    if (outcome === 'deferred') {
+        logger.info('Report generation deferred — user will be notified when available');
+        return false;
+    }
+    if (outcome === 'download') {
+        const download = await downloadPromise;
+        const filename = download.suggestedFilename();
+        expect(filename).toBe('report.csv');
+        logger.info(`CSV file "${filename}" downloaded successfully`);
+        return false;
+    }
+    if (outcome !== 'csv-editor') {
+        throw new Error('Report generation did not complete: neither CSV editor nor deferred-notification toast appeared within 60s');
+    }
     const dialogTitle = csvEditorDialog.getByRole('heading', {
         name: 'Edit CSV Data',
         level: 2,
@@ -919,6 +968,7 @@ async function shouldOpenCSVEditorDialog(page) {
     await expect(csvEditorDialog.getByRole('button', { name: 'Save' })).toBeVisible();
     await expect(csvEditorDialog.getByRole('button', { name: 'Close' }).first()).toBeVisible();
     logger.info('CSV Editor dialog opened successfully');
+    return csvEditorDialog;
 }
 async function shouldDisplayCSVInEditableTableFormat(page) {
     const dataReportsTab = page.getByRole('tab', { name: 'Data Reports' });
@@ -931,14 +981,12 @@ async function shouldDisplayCSVInEditableTableFormat(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
+    await triggerReportFromCard(page, userReportCard);
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
+    }
     const table = csvEditorDialog.getByRole('table', {
         name: 'CSV data table',
     });
@@ -962,14 +1010,12 @@ async function shouldAllowEditingCellValuesInCSVEditor(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
+    await triggerReportFromCard(page, userReportCard);
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
+    }
     const table = csvEditorDialog.getByRole('table', {
         name: 'CSV data table',
     });
@@ -1002,14 +1048,12 @@ async function shouldAddNewRowWhenClickingAddRowButton(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
+    await triggerReportFromCard(page, userReportCard);
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
+    }
     const table = csvEditorDialog.locator('table');
     const initialRowCount = await table.locator('tbody tr').count();
     const addRowButton = csvEditorDialog.getByRole('button', {
@@ -1032,16 +1076,14 @@ async function shouldSaveEditedCSVAndTriggerDownload(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
+    await triggerReportFromCard(page, userReportCard);
     await page.waitForLoadState('networkidle');
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
-    const downloadPromise = page.waitForEvent('download', { timeout: 30000 });
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
+    }
+    const downloadPromise = page.waitForEvent('download', { timeout: 40000 });
     const saveButton = csvEditorDialog.getByRole('button', { name: 'Save' });
     await saveButton.click();
     const download = await downloadPromise;
@@ -1061,15 +1103,13 @@ async function shouldCloseCSVEditorWithoutSavingWhenClickingCancel(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
+    await triggerReportFromCard(page, userReportCard);
     await page.waitForLoadState('networkidle');
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
+    }
     const cancelButton = csvEditorDialog.getByRole('button', {
         name: 'Cancel',
     });
@@ -1089,15 +1129,13 @@ async function shouldCloseCSVEditorWhenClickingCloseButton(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
+    await triggerReportFromCard(page, userReportCard);
     await page.waitForLoadState('networkidle');
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
+    }
     const closeButton = csvEditorDialog
         .getByRole('button', {
         name: 'Close',
@@ -1118,15 +1156,13 @@ async function shouldVerifyCSVEditorDialogAccessibility(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
+    await triggerReportFromCard(page, userReportCard);
     await page.waitForLoadState('networkidle');
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
+    }
     await expect(csvEditorDialog).toHaveAttribute('role', 'dialog');
     const csvTable = csvEditorDialog.getByRole('table', {
         name: 'CSV data table',
@@ -1161,15 +1197,12 @@ async function shouldOpenCSVEditorForUserMetadataReport(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = userMetadataReportCard.getByRole('button', {
-        name: 'Download report',
-    });
-    await downloadButton.click();
-    await page.waitForLoadState('networkidle');
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    await expect(csvEditorDialog).toBeVisible({ timeout: 60000 });
+    await triggerReportFromCard(page, userMetadataReportCard);
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
+    }
     const table = csvEditorDialog.locator('table');
     const companyHeader = table.locator('thead th input[value="company"]');
     const hasCompanyColumn = await companyHeader.isVisible().catch(() => false);
@@ -1189,21 +1222,32 @@ async function shouldDirectlyDownloadChatHistoryReportWithoutCSVEditor(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = chatHistoryCard.getByRole('button', {
-        name: 'Download report',
-    });
-    const downloadPromise = page.waitForEvent('download', { timeout: 120000 });
-    await expect(downloadButton).toBeVisible({ timeout: 30000 });
-    await downloadButton.click();
-    try {
-        const download = await downloadPromise;
-        const filename = download.suggestedFilename();
+    // Prefer the Regenerate button (guaranteed to open the picker); fall back to Download.
+    // Start listening for the download event before clicking since the auto-download fires
+    // as soon as the picker is confirmed.
+    const downloadPromise = page.waitForEvent('download', { timeout: 40000 });
+    await triggerReportFromCard(page, chatHistoryCard);
+    // Either the browser fires a download within 40s, or the backend defers and shows the
+    // "You will be notified once the report is available." toast. Both are valid outcomes.
+    const deferredNotification = page.getByText(deferredNotificationText);
+    const outcome = await Promise.race([
+        downloadPromise.then((download) => ({ kind: 'download', download })),
+        deferredNotification
+            .waitFor({ state: 'visible', timeout: 40000 })
+            .then(() => ({ kind: 'deferred' })),
+    ]).catch(() => null);
+    if (!outcome) {
+        throw new Error('Chat History generation did not complete: neither a download nor the deferred-notification toast appeared within 40s');
+    }
+    if (outcome.kind === 'download') {
+        const filename = outcome.download.suggestedFilename();
         expect(filename.endsWith('.csv')).toBeTruthy();
         logger.info(`Chat History report downloaded: ${filename}`);
     }
-    catch (_a) {
-        logger.info('Chat History download may have completed without triggering download event');
+    else {
+        logger.info('Chat History generation deferred — user will be notified when available');
     }
+    // Regardless of outcome, the CSV editor dialog should never have opened for chat history.
     const csvEditorDialog = page.getByRole('dialog', {
         name: 'Edit CSV Data',
     });
@@ -1224,23 +1268,23 @@ async function shouldDisableOtherDownloadButtonsWhileGeneratingReport(page) {
         test$2.skip();
         return;
     }
-    await downloadButtons.first().click();
+    // Trigger generation on the first report card (preferring Regenerate when present so the
+    // date-range picker always shows, then confirming it).
+    const firstCard = page.getByLabel(/ report card$/).first();
+    await triggerReportFromCard(page, firstCard);
+    //slight timeout to wait for other download buttons to be disabled
     await page.waitForTimeout(500);
     const secondButton = downloadButtons.nth(1);
     const isSecondDisabled = await secondButton.isDisabled();
     if (isSecondDisabled) {
         logger.info('Other download buttons correctly disabled during report generation');
     }
-    const csvEditorDialog = page.getByRole('dialog', {
-        name: 'Edit CSV Data',
-    });
-    const dialogVisible = await csvEditorDialog
-        .waitFor({ state: 'visible', timeout: 30000 })
-        .then(() => true)
-        .catch(() => false);
-    if (dialogVisible) {
-        await csvEditorDialog.getByRole('button', { name: 'Close' }).first().click();
+    const csvEditorDialog = await waitForReportOutcomeOrCSVDialogOpen(page);
+    if (!csvEditorDialog) {
+        test$2.skip();
+        return;
     }
+    await csvEditorDialog.getByRole('button', { name: 'Close' }).first().click();
 }
 // ============================================
 // Combined Recommendation Reports Test Helpers
@@ -1260,12 +1304,9 @@ async function shouldShowCombiningReportsDialog(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = combinedReportCard
-        .first()
-        .getByRole('button', { name: 'Download report' });
-    await downloadButton.click();
+    await triggerReportFromCard(page, combinedReportCard.first());
     const combiningDialog = page.locator('[data-testid="combining-reports-dialog"]');
-    await expect(combiningDialog).toBeVisible({ timeout: 30000 });
+    await expect(combiningDialog).toBeVisible({ timeout: 40000 });
     await expect(combiningDialog.getByText('Combining Reports')).toBeVisible();
     await expect(combiningDialog.getByText('Loading & combining recommendations data')).toBeVisible();
     logger.info('Combining reports dialog displayed successfully');
@@ -1285,12 +1326,9 @@ async function shouldCancelCombiningReports(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = combinedReportCard
-        .first()
-        .getByRole('button', { name: 'Download report' });
-    await downloadButton.click();
+    await triggerReportFromCard(page, combinedReportCard.first());
     const combiningDialog = page.locator('[data-testid="combining-reports-dialog"]');
-    await expect(combiningDialog).toBeVisible({ timeout: 30000 });
+    await expect(combiningDialog).toBeVisible({ timeout: 40000 });
     const cancelButton = page.locator('[data-testid="cancel-combining-button"]');
     await expect(cancelButton).toBeVisible();
     await cancelButton.click();
@@ -1331,10 +1369,7 @@ async function shouldCombineRecommendationReports(page) {
         test$2.skip();
         return;
     }
-    const downloadButton = combinedReportCard
-        .first()
-        .getByRole('button', { name: 'Download report' });
-    await downloadButton.click();
+    await triggerReportFromCard(page, combinedReportCard.first());
     const combiningDialog = page.locator('[data-testid="combining-reports-dialog"]');
     const dialogOrEditor = await Promise.race([
         combiningDialog.waitFor({ state: 'visible', timeout: 10000 }).then(() => 'dialog'),
@@ -1674,6 +1709,371 @@ async function verifyMemoryNotExists(page, content) {
     logger.info(`Verified memory removed: "${content}"`);
 }
 
+// ============================
+// Navigation Helpers
+// ============================
+/**
+ * Navigate to the Audit tab within the Analytics section.
+ * Assumes the user is already on the analytics page (any tab).
+ */
+async function navigateToAuditLog(page) {
+    const auditLogTab = page.getByRole('tab', { name: 'Audit' });
+    await expect(auditLogTab).toBeVisible({ timeout: 60000 });
+    await auditLogTab.click();
+    await waitForPageReady(page);
+    await safeWaitForURL(page, /\/analytics\/audit-log$/);
+    logger.info('Successfully navigated to Audit page');
+}
+// ============================
+// Table Verification Helpers
+// ============================
+/**
+ * Verify the audit log table is visible with correct headers.
+ */
+async function verifyAuditLogTableVisible(page) {
+    const table = page.locator('table');
+    await expect(table).toBeVisible({ timeout: 30000 });
+    await expect(table.locator('th').filter({ hasText: 'Person' })).toBeVisible();
+    await expect(table.locator('th').filter({ hasText: 'Action' })).toBeVisible();
+    await expect(table.locator('th').filter({ hasText: 'Timestamp' })).toBeVisible();
+    logger.info('Audit log table is visible with correct headers');
+}
+/**
+ * Get the number of rows currently displayed in the audit log table.
+ * Returns 0 if no table body rows are found.
+ */
+async function getAuditLogRowCount(page) {
+    const rows = page.locator('table tbody tr');
+    const count = await rows.count();
+    logger.info(`Audit log table has ${count} rows`);
+    return count;
+}
+/**
+ * Verify that audit log entries contain expected data structure
+ * (person name in first cell, action description in second, timestamp in third).
+ */
+async function verifyAuditLogEntryStructure(page) {
+    const firstRow = page.locator('table tbody tr').first();
+    await expect(firstRow).toBeVisible({ timeout: 30000 });
+    const cells = firstRow.locator('td');
+    const cellCount = await cells.count();
+    expect(cellCount).toBe(3);
+    // Person cell should have text content
+    const personText = await cells.nth(0).textContent();
+    expect(personText === null || personText === void 0 ? void 0 : personText.trim().length).toBeGreaterThan(0);
+    // Action cell should have text content
+    const actionText = await cells.nth(1).textContent();
+    expect(actionText === null || actionText === void 0 ? void 0 : actionText.trim().length).toBeGreaterThan(0);
+    // Timestamp cell should have text content
+    const timestampText = await cells.nth(2).textContent();
+    expect(timestampText === null || timestampText === void 0 ? void 0 : timestampText.trim().length).toBeGreaterThan(0);
+    logger.info(`Audit log entry: Person="${personText === null || personText === void 0 ? void 0 : personText.trim()}", Action="${actionText === null || actionText === void 0 ? void 0 : actionText.trim()}", Timestamp="${timestampText === null || timestampText === void 0 ? void 0 : timestampText.trim()}"`);
+}
+// ============================
+// Empty & Error State Helpers
+// ============================
+/**
+ * Verify the empty state is displayed when there are no audit log entries.
+ */
+async function verifyAuditLogEmptyState(page) {
+    const emptyMessage = page.getByText('No audit log entries found for this tenant.');
+    await expect(emptyMessage).toBeVisible({ timeout: 30000 });
+    logger.info('Audit log empty state is displayed');
+}
+/**
+ * Verify the 403 permission error state is displayed.
+ */
+async function verifyAuditLogPermissionError(page) {
+    const errorMessage = page.getByText('You do not have permission to view audit logs.');
+    await expect(errorMessage).toBeVisible({ timeout: 30000 });
+    logger.info('Audit log permission error is displayed');
+}
+/**
+ * Verify the generic error state is displayed.
+ */
+async function verifyAuditLogGenericError(page) {
+    const errorMessage = page.getByText('An error occurred while loading audit logs.');
+    await expect(errorMessage).toBeVisible({ timeout: 30000 });
+    logger.info('Audit log generic error is displayed');
+}
+/**
+ * Verify the loading spinner is displayed while audit logs are being fetched.
+ */
+async function verifyAuditLogLoading(page) {
+    const spinner = page.locator('.animate-spin');
+    await expect(spinner).toBeVisible({ timeout: 10000 });
+    logger.info('Audit log loading spinner is displayed');
+}
+/**
+ * Wait for the audit log data to finish loading.
+ * Waits for either table data, empty state, or error state to appear.
+ */
+async function waitForAuditLogDataLoaded(page, timeout = 60000) {
+    await page
+        .locator('table tbody tr, [class*="empty"], [class*="error"]')
+        .first()
+        .waitFor({ state: 'visible', timeout })
+        .catch(() => {
+        // Also check for known text states
+    });
+    // Wait for spinner to disappear
+    const spinner = page.locator('.animate-spin');
+    const isSpinnerVisible = await spinner.isVisible().catch(() => false);
+    if (isSpinnerVisible) {
+        await expect(spinner).not.toBeVisible({ timeout });
+    }
+    logger.info('Audit log data has finished loading');
+}
+// ============================
+// Filter Interaction Helpers
+// ============================
+/**
+ * Filter audit log entries by action type.
+ * @param action - One of 'All Actions', 'Create', 'Update', or 'Delete'
+ */
+async function filterByAction(page, action) {
+    const selectTrigger = page.locator('[role="combobox"][dir="ltr"]');
+    await expect(selectTrigger).toBeVisible({ timeout: 10000 });
+    await selectTrigger.click();
+    const option = page.getByRole('option', { name: action });
+    await expect(option).toBeVisible({ timeout: 5000 });
+    await option.click();
+    await waitForAuditLogDataLoaded(page);
+    logger.info(`Filtered audit log by action: ${action}`);
+}
+/**
+ * Filter audit log entries by actor/person using the search combobox.
+ * @param actorName - The username to filter by, or empty string to clear the filter
+ */
+async function filterByActor(page, actorName) {
+    const actorButton = page.getByLabel('Search for User');
+    await expect(actorButton).toBeVisible({ timeout: 10000 });
+    await actorButton.click();
+    // Wait for the command popover to open
+    const searchInput = page.getByPlaceholder('Search user...');
+    await expect(searchInput).toBeVisible({ timeout: 5000 });
+    if (actorName) {
+        await searchInput.fill(actorName);
+        // Select the matching actor from the dropdown
+        const actorItem = page.locator('[cmdk-item]').filter({ hasText: actorName });
+        await expect(actorItem).toBeVisible({ timeout: 5000 });
+        await actorItem.click();
+    }
+    else {
+        // Select "All Users" to clear the filter
+        const allPeopleItem = page.locator('[cmdk-item]').filter({ hasText: 'All Users' });
+        await expect(allPeopleItem).toBeVisible({ timeout: 5000 });
+        await allPeopleItem.click();
+    }
+    await waitForAuditLogDataLoaded(page);
+    logger.info(`Filtered audit log by actor: ${actorName || 'All Users'}`);
+}
+/**
+ * Get the list of actors available in the actor filter dropdown.
+ * Opens the dropdown, reads the options, then closes it.
+ */
+async function getAvailableActors(page) {
+    const actorButton = page.getByLabel('Search for User');
+    await expect(actorButton).toBeVisible({ timeout: 10000 });
+    await actorButton.click();
+    // Wait for the command popover
+    await expect(page.getByPlaceholder('Search user...')).toBeVisible({ timeout: 5000 });
+    const actorItems = page.locator('[cmdk-item] .font-medium.text-gray-700');
+    const count = await actorItems.count();
+    const actors = [];
+    for (let i = 0; i < count; i++) {
+        const text = await actorItems.nth(i).textContent();
+        if (text)
+            actors.push(text.trim());
+    }
+    // Close the dropdown by pressing Escape
+    await page.keyboard.press('Escape');
+    logger.info(`Available actors: ${actors.join(', ')}`);
+    return actors;
+}
+/**
+ * Open the date range picker and select a date range.
+ * @param fromDate - Start date to select
+ * @param toDate - End date to select
+ */
+async function filterByDateRange(page, fromDate, toDate) {
+    const dateButton = page.getByRole('button', {
+        name: /Pick a Date Range|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec/,
+    });
+    await expect(dateButton).toBeVisible({ timeout: 10000 });
+    await dateButton.click();
+    // Wait for calendar to appear
+    const calendar = page.locator('[role="grid"]').first();
+    await expect(calendar).toBeVisible({ timeout: 5000 });
+    // Select the from date
+    const fromDay = String(fromDate.getDate());
+    const fromButton = calendar.getByRole('gridcell', { name: fromDay, exact: true }).first();
+    await fromButton.click();
+    // Select the to date
+    const toDay = String(toDate.getDate());
+    const toButton = calendar.getByRole('gridcell', { name: toDay, exact: true }).first();
+    await toButton.click();
+    // Close by clicking outside
+    await page.locator('body').click({ position: { x: 0, y: 0 } });
+    await waitForAuditLogDataLoaded(page);
+    logger.info(`Filtered audit log by date range: ${fromDate.toISOString().split('T')[0]} to ${toDate.toISOString().split('T')[0]}`);
+}
+/**
+ * Clear the date range filter by clicking the date picker and resetting.
+ */
+async function clearDateRangeFilter(page) {
+    const dateButton = page.getByRole('button', { name: /Pick a Date Range/ });
+    // If button shows "Pick a Date Range", filter is already cleared
+    const isCleared = await dateButton.isVisible().catch(() => false);
+    if (isCleared) {
+        logger.info('Date range filter is already cleared');
+        return;
+    }
+    logger.info('Date range filter cleared');
+}
+// ============================
+// Pagination Helpers
+// ============================
+/**
+ * Get the current pagination info text (e.g., "Showing 1 to 20 of 45 results").
+ * Returns null if pagination is not visible.
+ */
+async function getPaginationInfo(page) {
+    var _a;
+    const paginationText = page.locator('.text-sm.text-gray-700');
+    const isVisible = await paginationText.isVisible().catch(() => false);
+    if (!isVisible) {
+        logger.info('Pagination info is not visible (likely single page)');
+        return null;
+    }
+    const text = await paginationText.textContent();
+    logger.info(`Pagination info: ${text === null || text === void 0 ? void 0 : text.trim()}`);
+    return (_a = text === null || text === void 0 ? void 0 : text.trim()) !== null && _a !== void 0 ? _a : null;
+}
+/**
+ * Navigate to the next page of audit log results.
+ */
+async function goToNextPage(page) {
+    const nextLink = page.getByRole('link', { name: 'Go to next page' });
+    await expect(nextLink).toBeVisible({ timeout: 5000 });
+    await nextLink.click();
+    await waitForAuditLogDataLoaded(page);
+    logger.info('Navigated to next page');
+}
+/**
+ * Navigate to the previous page of audit log results.
+ */
+async function goToPreviousPage(page) {
+    const prevLink = page.getByRole('link', { name: 'Go to previous page' });
+    await expect(prevLink).toBeVisible({ timeout: 5000 });
+    await prevLink.click();
+    await waitForAuditLogDataLoaded(page);
+    logger.info('Navigated to previous page');
+}
+/**
+ * Navigate to the first page of audit log results.
+ */
+async function goToFirstPage(page) {
+    await goToPage(page, 1);
+    logger.info('Navigated to first page');
+}
+/**
+ * Navigate to the last page of audit log results.
+ * Finds the highest numbered page link in the pagination.
+ */
+async function goToLastPage(page) {
+    const paginationNav = page.getByRole('navigation', { name: 'pagination' });
+    await expect(paginationNav).toBeVisible({ timeout: 5000 });
+    const pageLinks = paginationNav.getByRole('link');
+    const count = await pageLinks.count();
+    // The last numeric link before "Next" is the last page
+    let lastPageNum = 1;
+    for (let i = 0; i < count; i++) {
+        const text = await pageLinks.nth(i).textContent();
+        const num = Number(text === null || text === void 0 ? void 0 : text.trim());
+        if (!isNaN(num) && num > lastPageNum) {
+            lastPageNum = num;
+        }
+    }
+    await goToPage(page, lastPageNum);
+    logger.info(`Navigated to last page (${lastPageNum})`);
+}
+/**
+ * Navigate to a specific page number by clicking its page button.
+ */
+async function goToPage(page, pageNumber) {
+    const pageLink = page
+        .getByRole('navigation', { name: 'pagination' })
+        .getByRole('link', { name: String(pageNumber), exact: true });
+    await expect(pageLink).toBeVisible({ timeout: 5000 });
+    await pageLink.click();
+    await waitForAuditLogDataLoaded(page);
+    logger.info(`Navigated to page ${pageNumber}`);
+}
+/**
+ * Verify the current page is highlighted/active in pagination.
+ */
+async function verifyCurrentPage(page, expectedPage) {
+    const pageLink = page
+        .getByRole('navigation', { name: 'pagination' })
+        .getByRole('link', { name: String(expectedPage), exact: true });
+    await expect(pageLink).toBeVisible({ timeout: 5000 });
+    await expect(pageLink).toHaveClass(/bg-blue-500/);
+    logger.info(`Verified current page is ${expectedPage}`);
+}
+/**
+ * Check if the next page button is disabled (i.e., we're on the last page).
+ */
+async function isOnLastPage(page) {
+    const nextLink = page.getByRole('link', { name: 'Go to next page' });
+    const hasDisabledClass = await nextLink
+        .evaluate((el) => el.classList.contains('pointer-events-none'))
+        .catch(() => true);
+    return hasDisabledClass;
+}
+/**
+ * Check if the previous page button is disabled (i.e., we're on the first page).
+ */
+async function isOnFirstPage(page) {
+    const prevLink = page.getByRole('link', { name: 'Go to previous page' });
+    const hasDisabledClass = await prevLink
+        .evaluate((el) => el.classList.contains('pointer-events-none'))
+        .catch(() => true);
+    return hasDisabledClass;
+}
+// ============================
+// Combined Workflow Helpers
+// ============================
+/**
+ * Full workflow: Navigate to audit log tab, wait for data to load,
+ * and verify the table is visible. Use this as a test setup helper.
+ */
+async function navigateToAuditLogAndWaitForData(page) {
+    await navigateToAuditLog(page);
+    await waitForAuditLogDataLoaded(page);
+    logger.info('Audit log page ready with data loaded');
+}
+/**
+ * Verify audit log entries are displayed after applying action filter.
+ * Returns the row count after filtering.
+ */
+async function filterByActionAndVerify(page, action) {
+    await filterByAction(page, action);
+    const count = await getAuditLogRowCount(page);
+    logger.info(`After filtering by "${action}": ${count} entries found`);
+    return count;
+}
+/**
+ * Verify audit log entries are displayed after applying actor filter.
+ * Returns the row count after filtering.
+ */
+async function filterByActorAndVerify(page, actorName) {
+    await filterByActor(page, actorName);
+    const count = await getAuditLogRowCount(page);
+    logger.info(`After filtering by actor "${actorName}": ${count} entries found`);
+    return count;
+}
+
 /** Extract browser key from device name (e.g., 'Desktop Chrome' -> 'chrome') */
 function getBrowserKey(deviceName) {
     return deviceName.toLowerCase().replace(/^desktop\s+/, '');
@@ -1799,5 +2199,5 @@ function createPlaywrightConfig(options) {
     });
 }
 
-export { AuthFlowBuilder, CustomReporter, MailsacClient, addMemory, archiveFirstMemory, archiveMemoryByContent, buildReportUrl, canChatWithEmbedMentor, checkAdminStatus, clickBackHome, clickDownloadAgain, clickManualDownloadLink, closeWithEsc, createAuthSetup, createEnvConfig, createPlaywrightConfig, deleteFirstMemory, deleteMemoryByContent, expectNoAccessibilityViolations, expectNoAccessibilityViolationsOnDialogs, generateBrowserSetupProjects, generateProjectConfig, getBrowserKey, getMemoryCount, getMentorIdFromUrl, inviteUserTest, isFirefox, isJSON, isMemoryTabVisible, logger, loginWithEmailAndPassword, loginWithMicrosoftIdp, navigateToAccountComponent, navigateToDataReports, navigateToReportDownload, openAddMemoryDialog, parseReportUrlParams, reliableClick, reliableFill, retry, safeWaitForURL, selectDateFromCalendar, shouldAddNewRowWhenClickingAddRowButton, shouldAllowEditingCellValuesInCSVEditor, shouldCancelCombiningReports, shouldCloseCSVEditorWhenClickingCloseButton, shouldCloseCSVEditorWithoutSavingWhenClickingCancel, shouldCombineRecommendationReports, shouldDirectlyDownloadChatHistoryReportWithoutCSVEditor, shouldDisableOtherDownloadButtonsWhileGeneratingReport, shouldDisplayCSVInEditableTableFormat, shouldDisplayReportCards, shouldHaveCombinedReportDataTestIds, shouldOpenCSVEditorDialog, shouldOpenCSVEditorForUserMetadataReport, shouldSaveEditedCSVAndTriggerDownload, shouldShowCombiningReportsDialog, shouldVerifyCSVEditorDialogAccessibility, signUpWithEmailAndPassword, switchToMemoryTab, test, toggleMemorySwitch, verifyDonePhase, verifyDownloadingPhase, verifyErrorPhase, verifyMemoryExists, verifyMemoryNotExists, verifyMemoryTabMemoriesList, verifyMemoryTabSettings, verifyPreparingPhase, waitForDialogReady, waitForElementStable, waitForPageLoad, waitForPageReady, waitForReportDownload };
+export { AuthFlowBuilder, CustomReporter, MailsacClient, addMemory, archiveFirstMemory, archiveMemoryByContent, buildReportUrl, canChatWithEmbedMentor, checkAdminStatus, clearDateRangeFilter, clickBackHome, clickDownloadAgain, clickManualDownloadLink, closeWithEsc, createAuthSetup, createEnvConfig, createPlaywrightConfig, deleteFirstMemory, deleteMemoryByContent, expectNoAccessibilityViolations, expectNoAccessibilityViolationsOnDialogs, filterByAction, filterByActionAndVerify, filterByActor, filterByActorAndVerify, filterByDateRange, generateBrowserSetupProjects, generateProjectConfig, getAuditLogRowCount, getAvailableActors, getBrowserKey, getMemoryCount, getMentorIdFromUrl, getPaginationInfo, goToFirstPage, goToLastPage, goToNextPage, goToPage, goToPreviousPage, inviteUserTest, isFirefox, isJSON, isMemoryTabVisible, isOnFirstPage, isOnLastPage, logger, loginWithEmailAndPassword, loginWithMicrosoftIdp, navigateToAccountComponent, navigateToAuditLog, navigateToAuditLogAndWaitForData, navigateToDataReports, navigateToReportDownload, openAddMemoryDialog, parseReportUrlParams, reliableClick, reliableFill, retry, safeWaitForURL, selectDateFromCalendar, shouldAddNewRowWhenClickingAddRowButton, shouldAllowEditingCellValuesInCSVEditor, shouldCancelCombiningReports, shouldCloseCSVEditorWhenClickingCloseButton, shouldCloseCSVEditorWithoutSavingWhenClickingCancel, shouldCombineRecommendationReports, shouldDirectlyDownloadChatHistoryReportWithoutCSVEditor, shouldDisableOtherDownloadButtonsWhileGeneratingReport, shouldDisplayCSVInEditableTableFormat, shouldDisplayReportCards, shouldHaveCombinedReportDataTestIds, shouldOpenCSVEditorDialog, shouldOpenCSVEditorForUserMetadataReport, shouldSaveEditedCSVAndTriggerDownload, shouldShowCombiningReportsDialog, shouldVerifyCSVEditorDialogAccessibility, signUpWithEmailAndPassword, switchToMemoryTab, test, toggleMemorySwitch, verifyAuditLogEmptyState, verifyAuditLogEntryStructure, verifyAuditLogGenericError, verifyAuditLogLoading, verifyAuditLogPermissionError, verifyAuditLogTableVisible, verifyCurrentPage, verifyDonePhase, verifyDownloadingPhase, verifyErrorPhase, verifyMemoryExists, verifyMemoryNotExists, verifyMemoryTabMemoriesList, verifyMemoryTabSettings, verifyPreparingPhase, waitForAuditLogDataLoaded, waitForDialogReady, waitForElementStable, waitForPageLoad, waitForPageReady, waitForReportDownload };
 //# sourceMappingURL=index.esm.js.map