@striae-org/striae 5.4.5 → 5.5.0

package/app/components/actions/export-audit-pdf.ts

@@ -0,0 +1,439 @@
+import type { User } from 'firebase/auth';
+import { auditService } from '~/services/audit';
+import type { ValidationAuditEntry } from '~/types';
+import { getCaseData } from '~/utils/data';
+import { canAccessCase } from '~/utils/data/permissions';
+import { fetchPdfApi } from '~/utils/api';
+import type { ToastType } from '~/components/toast/toast';
+
+interface ExportAuditPdfParams {
+  user: User;
+  caseNumber: string;
+  userCompany?: string;
+  userFirstName?: string;
+  userLastName?: string;
+  userBadgeId?: string;
+  setIsExportingPDF: (isExporting: boolean) => void;
+  setToastType: (type: ToastType) => void;
+  setToastMessage: (message: string) => void;
+  setShowToast: (show: boolean) => void;
+  setToastDuration?: (duration: number) => void;
+}
+
+interface AuditTrailPdfPayload {
+  reportMode: 'audit-trail';
+  caseNumber: string;
+  exportedAt: string;
+  exportRangeStart: string;
+  exportRangeEnd: string;
+  chunkIndex: number;
+  totalChunks: number;
+  totalEntries: number;
+  includeRawJsonAppendix: boolean;
+  entries: ValidationAuditEntry[];
+}
+
+const MAX_AUDIT_ENTRIES_PER_PDF = 200;
+const AUDIT_FETCH_WINDOW_DAYS = 30;
+
+const formatShortDate = (date: Date): string => {
+  const month = (date.getMonth() + 1).toString().padStart(2, '0');
+  const day = date.getDate().toString().padStart(2, '0');
+  const year = date.getFullYear().toString();
+  return `${month}/${day}/${year}`;
+};
+
+const formatDateStamp = (date: Date): string => {
+  const year = date.getFullYear().toString();
+  const month = (date.getMonth() + 1).toString().padStart(2, '0');
+  const day = date.getDate().toString().padStart(2, '0');
+  return `${year}${month}${day}`;
+};
+
+const chunkEntries = (entries: ValidationAuditEntry[]): ValidationAuditEntry[][] => {
+  if (entries.length === 0) {
+    return [];
+  }
+
+  const chunks: ValidationAuditEntry[][] = [];
+  for (let offset = 0; offset < entries.length; offset += MAX_AUDIT_ENTRIES_PER_PDF) {
+    chunks.push(entries.slice(offset, offset + MAX_AUDIT_ENTRIES_PER_PDF));
+  }
+
+  return chunks;
+};
+
+const downloadPdfBlob = (blob: Blob, filename: string): void => {
+  const downloadUrl = URL.createObjectURL(blob);
+  const anchor = document.createElement('a');
+  anchor.href = downloadUrl;
+  anchor.download = filename;
+  document.body.appendChild(anchor);
+  anchor.click();
+  document.body.removeChild(anchor);
+  URL.revokeObjectURL(downloadUrl);
+};
+
+const normalizeIsoDate = (value?: string): string | null => {
+  if (!value) {
+    return null;
+  }
+
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return null;
+  }
+
+  return parsed.toISOString();
+};
+
+const toUtcDayStart = (value: string): Date => {
+  const parsed = new Date(value);
+  return new Date(Date.UTC(parsed.getUTCFullYear(), parsed.getUTCMonth(), parsed.getUTCDate(), 0, 0, 0, 0));
+};
+
+const toUtcDayEnd = (value: string): Date => {
+  const parsed = new Date(value);
+  return new Date(Date.UTC(parsed.getUTCFullYear(), parsed.getUTCMonth(), parsed.getUTCDate(), 23, 59, 59, 999));
+};
+
+const addUtcDays = (date: Date, days: number): Date => {
+  return new Date(Date.UTC(
+    date.getUTCFullYear(),
+    date.getUTCMonth(),
+    date.getUTCDate() + days,
+    date.getUTCHours(),
+    date.getUTCMinutes(),
+    date.getUTCSeconds(),
+    date.getUTCMilliseconds()
+  ));
+};
+
+const getAuditEntryIdentity = (entry: ValidationAuditEntry): string => {
+  return [
+    entry.timestamp,
+    entry.userId,
+    entry.action,
+    entry.result,
+    entry.details.caseNumber || '',
+    entry.details.fileName || '',
+    entry.details.confirmationId || ''
+  ].join('|');
+};
+
+const fetchAllCaseEntriesForExport = async (
+  user: User,
+  caseNumber: string,
+  caseCreatedAtIso: string,
+  nowIso: string
+): Promise<ValidationAuditEntry[]> => {
+  const rangeStart = toUtcDayStart(caseCreatedAtIso);
+  const rangeEnd = toUtcDayEnd(nowIso);
+
+  const mergedEntries = new Map<string, ValidationAuditEntry>();
+  let windowStart = new Date(rangeStart);
+
+  while (windowStart.getTime() <= rangeEnd.getTime()) {
+    const windowEndCandidate = addUtcDays(windowStart, AUDIT_FETCH_WINDOW_DAYS - 1);
+    const windowEnd = windowEndCandidate.getTime() > rangeEnd.getTime() ? new Date(rangeEnd) : windowEndCandidate;
+
+    const windowEntries = await auditService.getAuditEntriesForUser(user.uid, {
+      requestingUser: user,
+      caseNumber,
+      startDate: windowStart.toISOString(),
+      endDate: windowEnd.toISOString()
+    });
+
+    for (const entry of windowEntries) {
+      mergedEntries.set(getAuditEntryIdentity(entry), entry);
+    }
+
+    windowStart = addUtcDays(windowEnd, 1);
+    windowStart = new Date(Date.UTC(
+      windowStart.getUTCFullYear(),
+      windowStart.getUTCMonth(),
+      windowStart.getUTCDate(),
+      0,
+      0,
+      0,
+      0
+    ));
+  }
+
+  return Array.from(mergedEntries.values());
+};
+
+const extractErrorMessage = async (response: Response): Promise<string> => {
+  const contentType = response.headers.get('Content-Type') ?? '';
+
+  if (contentType.includes('application/json')) {
+    try {
+      const json = await response.json() as { error?: string; details?: string };
+      if (json.error) {
+        return json.details ? `${json.error}: ${json.details}` : json.error;
+      }
+    } catch {
+      // fall through to text fallback
+    }
+  }
+
+  try {
+    const text = await response.text();
+    return text.trim() || `HTTP ${response.status} ${response.statusText}`;
+  } catch {
+    return `HTTP ${response.status} ${response.statusText}`;
+  }
+};
+
+const buildPartFilename = (
+  caseNumber: string,
+  exportDate: Date,
+  partIndex: number,
+  totalParts: number
+): string => {
+  const sanitizedCaseNumber = caseNumber.trim().replace(/[^a-zA-Z0-9_-]+/g, '-');
+  const dateStamp = formatDateStamp(exportDate);
+
+  if (totalParts <= 1) {
+    return `audit-trail-${sanitizedCaseNumber}-${dateStamp}.pdf`;
+  }
+
+  return `audit-trail-${sanitizedCaseNumber}-${dateStamp}-part-${partIndex}-of-${totalParts}.pdf`;
+};
+
+const buildAuditTrailPayload = (
+  caseNumber: string,
+  entries: ValidationAuditEntry[],
+  exportRangeStart: string,
+  exportRangeEnd: string,
+  chunkIndex: number,
+  totalChunks: number,
+  totalEntries: number,
+  exportedAt: string
+): AuditTrailPdfPayload => {
+  return {
+    reportMode: 'audit-trail',
+    caseNumber,
+    exportedAt,
+    exportRangeStart,
+    exportRangeEnd,
+    chunkIndex,
+    totalChunks,
+    totalEntries,
+    includeRawJsonAppendix: true,
+    entries
+  };
+};
+
+export const exportAuditPDF = async ({
+  user,
+  caseNumber,
+  userCompany,
+  userFirstName,
+  userLastName,
+  userBadgeId,
+  setIsExportingPDF,
+  setToastType,
+  setToastMessage,
+  setShowToast,
+  setToastDuration
+}: ExportAuditPdfParams): Promise<void> => {
+  setIsExportingPDF(true);
+  setToastType('loading');
+  setToastMessage('Preparing full case audit trail PDF export...');
+  if (setToastDuration) {
+    setToastDuration(0);
+  }
+  setShowToast(true);
+
+  const exportStartTime = Date.now();
+
+  try {
+    const accessCheck = await canAccessCase(user, caseNumber);
+    if (!accessCheck.allowed) {
+      throw new Error(accessCheck.reason || 'You do not have access to export this case audit trail.');
+    }
+
+    const caseData = await getCaseData(user, caseNumber);
+    const now = new Date();
+    const nowIso = now.toISOString();
+    const caseCreatedAtIso = normalizeIsoDate(caseData?.createdAt) || '1970-01-01T00:00:00.000Z';
+    const isBundledArchivedCase = Boolean(
+      caseData?.isReadOnly === true &&
+      caseData?.archived === true &&
+      caseData?.bundledAuditTrail?.source === 'archive-bundle'
+    );
+
+    const allEntries = isBundledArchivedCase
+      ? await auditService.getAuditEntriesForUser(user.uid, {
+          requestingUser: user,
+          caseNumber
+        })
+      : await fetchAllCaseEntriesForExport(user, caseNumber, caseCreatedAtIso, nowIso);
+
+    if (allEntries.length === 0) {
+      setToastType('warning');
+      setToastMessage(`No audit entries were found for case ${caseNumber}.`);
+      if (setToastDuration) {
+        setToastDuration(5000);
+      }
+      setShowToast(true);
+      return;
+    }
+
+    const sortedEntries = [...allEntries].sort(
+      (left, right) => new Date(left.timestamp).getTime() - new Date(right.timestamp).getTime()
+    );
+    const exportRangeStartIso = isBundledArchivedCase
+      ? normalizeIsoDate(sortedEntries[0]?.timestamp) || caseCreatedAtIso
+      : caseCreatedAtIso;
+    const exportRangeEndIso = isBundledArchivedCase
+      ? normalizeIsoDate(sortedEntries[sortedEntries.length - 1]?.timestamp) || nowIso
+      : nowIso;
+
+    const chunks = chunkEntries(sortedEntries);
+    const totalChunks = chunks.length;
+    const exportedAtIso = nowIso;
+    const currentDate = formatShortDate(now);
+
+    let successfulParts = 0;
+    const failedParts: number[] = [];
+
+    for (let chunkIndex = 0; chunkIndex < chunks.length; chunkIndex += 1) {
+      const partNumber = chunkIndex + 1;
+      const chunkEntriesForPart = chunks[chunkIndex];
+      const filename = buildPartFilename(caseNumber, now, partNumber, totalChunks);
+      const partStartTime = Date.now();
+
+      const pdfData = {
+        reportMode: 'audit-trail' as const,
+        currentDate,
+        caseNumber,
+        userCompany,
+        userFirstName,
+        userLastName,
+        userBadgeId,
+        auditTrailReport: buildAuditTrailPayload(
+          caseNumber,
+          chunkEntriesForPart,
+          exportRangeStartIso,
+          exportRangeEndIso,
+          partNumber,
+          totalChunks,
+          sortedEntries.length,
+          exportedAtIso
+        )
+      };
+
+      setToastType('loading');
+      setToastMessage(`Generating audit PDF part ${partNumber} of ${totalChunks}...`);
+      setShowToast(true);
+
+      try {
+        const response = await fetchPdfApi(user, '/', {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json'
+          },
+          body: JSON.stringify({ data: pdfData })
+        });
+
+        if (!response.ok) {
+          const errorMessage = await extractErrorMessage(response);
+          throw new Error(errorMessage);
+        }
+
+        const blob = await response.blob();
+        downloadPdfBlob(blob, filename);
+        successfulParts += 1;
+
+        try {
+          await auditService.logPDFGeneration(
+            user,
+            filename,
+            caseNumber,
+            'success',
+            Date.now() - partStartTime,
+            blob.size,
+            [],
+            `audit-trail:${caseNumber}:part-${partNumber}`,
+            `audit-trail-${caseNumber}`
+          );
+        } catch (auditError) {
+          console.error('Failed to log audit PDF generation success:', auditError);
+        }
+      } catch (error) {
+        failedParts.push(partNumber);
+
+        try {
+          await auditService.logPDFGeneration(
+            user,
+            filename,
+            caseNumber,
+            'failure',
+            Date.now() - partStartTime,
+            0,
+            [error instanceof Error ? error.message : 'Unknown PDF generation error'],
+            `audit-trail:${caseNumber}:part-${partNumber}`,
+            `audit-trail-${caseNumber}`
+          );
+        } catch (auditError) {
+          console.error('Failed to log audit PDF generation failure:', auditError);
+        }
+      }
+    }
+
+    if (failedParts.length === 0) {
+      setToastType('success');
+      setToastMessage(
+        successfulParts > 1
+          ? `Exported ${successfulParts} audit PDF parts for case ${caseNumber}.`
+          : `Exported audit PDF for case ${caseNumber}.`
+      );
+      if (setToastDuration) {
+        setToastDuration(6000);
+      }
+      setShowToast(true);
+      return;
+    }
+
+    const failedPartLabel = failedParts.join(', ');
+    setToastType('warning');
+    setToastMessage(
+      successfulParts > 0
+        ? `Export completed with issues. Successful parts: ${successfulParts}/${totalChunks}. Failed parts: ${failedPartLabel}.`
+        : `Audit PDF export failed. Failed parts: ${failedPartLabel}.`
+    );
+    if (setToastDuration) {
+      setToastDuration(9000);
+    }
+    setShowToast(true);
+  } catch (error) {
+    const processingTime = Date.now() - exportStartTime;
+
+    try {
+      await auditService.logPDFGeneration(
+        user,
+        `audit-trail-${caseNumber}-failed-${Date.now()}.pdf`,
+        caseNumber,
+        'failure',
+        processingTime,
+        0,
+        [error instanceof Error ? error.message : 'Unknown audit PDF export error'],
+        `audit-trail:${caseNumber}`,
+        `audit-trail-${caseNumber}`
+      );
+    } catch (auditError) {
+      console.error('Failed to log audit PDF export error:', auditError);
+    }
+
+    setToastType('error');
+    setToastMessage(error instanceof Error ? error.message : 'Failed to export case audit trail PDF.');
+    if (setToastDuration) {
+      setToastDuration(7000);
+    }
+    setShowToast(true);
+  } finally {
+    setIsExportingPDF(false);
+  }
+};

package/app/components/audit/user-audit-viewer.tsx

@@ -1,6 +1,8 @@
-import { useContext, useMemo } from 'react';
+import { useCallback, useContext, useMemo, useState } from 'react';
 import { AuthContext } from '~/contexts/auth.context';
 import { useOverlayDismiss } from '~/hooks/useOverlayDismiss';
+import { exportAuditPDF } from '~/components/actions/export-audit-pdf';
+import { Toast, type ToastType } from '~/components/toast/toast';
 import { AuditViewerHeader } from './viewer/audit-viewer-header';
 import { AuditUserInfoCard } from './viewer/audit-user-info-card';
 import { AuditActivitySummary } from './viewer/audit-activity-summary';
@@ -20,6 +22,12 @@ interface UserAuditViewerProps {
 
 export const UserAuditViewer = ({ isOpen, onClose, caseNumber, title }: UserAuditViewerProps) => {
   const { user } = useContext(AuthContext);
+  const [isExportingPdf, setIsExportingPdf] = useState(false);
+  const [showToast, setShowToast] = useState(false);
+  const [toastType, setToastType] = useState<ToastType>('success');
+  const [toastMessage, setToastMessage] = useState('');
+  const [toastDuration, setToastDuration] = useState(4000);
+
   const {
     filterAction,
     setFilterAction,
@@ -79,107 +87,157 @@ export const UserAuditViewer = ({ isOpen, onClose, caseNumber, title }: UserAudi
   });
 
   const userBadgeId = userData?.badgeId?.trim() || '';
+  const isCaseScopedViewer = Boolean(effectiveCaseNumber?.trim());
+
+  const handleExportPdf = useCallback(async () => {
+    if (!user || !effectiveCaseNumber || isExportingPdf) {
+      return;
+    }
+
+    const displayName = user.displayName?.trim() || '';
+    const [firstFromDisplayName, ...lastFromDisplayNameParts] = displayName.split(/\s+/).filter(Boolean);
+
+    await exportAuditPDF({
+      user,
+      caseNumber: effectiveCaseNumber,
+      userCompany: userData?.company,
+      userFirstName: firstFromDisplayName || userData?.firstName || '',
+      userLastName: lastFromDisplayNameParts.join(' ') || userData?.lastName || '',
+      userBadgeId,
+      setIsExportingPDF: setIsExportingPdf,
+      setToastType,
+      setToastMessage,
+      setShowToast,
+      setToastDuration
+    });
+  }, [
+    effectiveCaseNumber,
+    isExportingPdf,
+    user,
+    userBadgeId,
+    userData?.company,
+    userData?.firstName,
+    userData?.lastName
+  ]);
 
   if (!isOpen) return null;
 
   return (
-    <div
-      className={styles.overlay}
-      aria-label="Close audit trail dialog"
-      {...overlayProps}
-    >
-      <div className={styles.modal}>
-        <AuditViewerHeader
-          title={title || (effectiveCaseNumber ? `Audit Trail - Case ${effectiveCaseNumber}` : 'My Audit Trail')}
-          onClose={requestClose}
-        />
-
-        <div className={styles.content}>
-          {loading && (
-            <div className={styles.loading}>
-              <div className={styles.spinner}></div>
-              <p>Loading your audit trail...this may take a while for longer time ranges</p>
-            </div>
-          )}
-
-          {error && (
-            <div className={styles.error}>
-              <p>Error: {error}</p>
-              <button onClick={loadAuditData} className={styles.retryButton}>
-                Retry
-              </button>
-            </div>
-          )}
-
-          {!loading && !error && (
-            <>
-              {isArchivedReadOnlyCase && (
-                <div className={bundledAuditWarning ? styles.archivedWarning : styles.archivedNotice}>
-                  <p>
-                    {bundledAuditWarning || 'Viewing bundled audit trail data from this imported archived case package.'}
-                  </p>
-                </div>
-              )}
-
-              {/* User Information Section */}
-              {user && (
-                <AuditUserInfoCard user={user} userData={userData} userBadgeId={userBadgeId} />
-              )}
-
-              {/* Summary Section */}
-              <AuditActivitySummary
-                caseNumber={caseNumber}
-                filterCaseNumber={filterCaseNumber}
-                dateRangeDisplay={dateRangeDisplay}
-                summary={auditSummary}
-              />
-
-              {/* Filters */}
-              <AuditFiltersPanel
-                dateRange={dateRange}
-                customStartDate={customStartDate}
-                customEndDate={customEndDate}
-                customStartDateInput={customStartDateInput}
-                customEndDateInput={customEndDateInput}
-                caseNumber={caseNumber}
-                filterCaseNumber={filterCaseNumber}
-                caseNumberInput={caseNumberInput}
-                filterBadgeId={filterBadgeId}
-                badgeIdInput={badgeIdInput}
-                filterAction={filterAction}
-                filterResult={filterResult}
-                onDateRangeChange={handleDateRangeChange}
-                onCustomStartDateInputChange={setCustomStartDateInput}
-                onCustomEndDateInputChange={setCustomEndDateInput}
-                onApplyCustomDateRange={handleApplyCustomDateRange}
-                onClearCustomDateRange={handleClearCustomDateRange}
-                onCaseNumberInputChange={setCaseNumberInput}
-                onApplyCaseFilter={handleApplyCaseFilter}
-                onClearCaseFilter={handleClearCaseFilter}
-                onBadgeIdInputChange={setBadgeIdInput}
-                onApplyBadgeFilter={handleApplyBadgeFilter}
-                onClearBadgeFilter={handleClearBadgeFilter}
-                onFilterActionChange={setFilterAction}
-                onFilterResultChange={setFilterResult}
-              />
-
-              {/* Entries List */}
-              <AuditEntriesList entries={filteredEntries} />
-
-            </>
-          )}
-
-          {auditEntries.length === 0 && !loading && !error && (
-            <div className={styles.noData}>
-              <p>
-                {isArchivedReadOnlyCase
-                  ? 'No bundled audit trail entries are available for this imported archived case.'
-                  : 'No audit trail available. Your activities will appear here as you use Striae.'}
-              </p>
-            </div>
-          )}
+    <>
+      <Toast
+        message={toastMessage}
+        type={toastType}
+        isVisible={showToast}
+        onClose={() => setShowToast(false)}
+        duration={toastDuration}
+      />
+      <div
+        className={styles.overlay}
+        aria-label="Close audit trail dialog"
+        {...overlayProps}
+      >
+        <div className={styles.modal}>
+          <AuditViewerHeader
+            title={title || (effectiveCaseNumber ? `Audit Trail - Case ${effectiveCaseNumber}` : 'My Audit Trail')}
+            onClose={requestClose}
+            onExportPdf={isCaseScopedViewer ? () => void handleExportPdf() : undefined}
+            canExportPdf={isCaseScopedViewer && auditEntries.length > 0 && !loading && !error}
+            isExportingPdf={isExportingPdf}
+          />
+
+          <div className={styles.content}>
+            {loading && (
+              <div className={styles.loading}>
+                <div className={styles.spinner}></div>
+                <p>Loading your audit trail...this may take a while for longer time ranges</p>
+              </div>
+            )}
+
+            {error && (
+              <div className={styles.error}>
+                <p>Error: {error}</p>
+                <button onClick={loadAuditData} className={styles.retryButton}>
+                  Retry
+                </button>
+              </div>
+            )}
+
+            {!loading && !error && (
+              <>
+                {isArchivedReadOnlyCase && (
+                  <div className={bundledAuditWarning ? styles.archivedWarning : styles.archivedNotice}>
+                    <p>
+                      {bundledAuditWarning || 'Viewing bundled audit trail data from this imported archived case package.'}
+                    </p>
+                  </div>
+                )}
+
+                {/* User Information Section */}
+                {user && (
+                  <AuditUserInfoCard user={user} userData={userData} userBadgeId={userBadgeId} />
+                )}
+
+                {/* Summary Section */}
+                <AuditActivitySummary
+                  caseNumber={caseNumber}
+                  filterCaseNumber={filterCaseNumber}
+                  dateRangeDisplay={dateRangeDisplay}
+                  summary={auditSummary}
+                />
+
+                {isCaseScopedViewer && (
+                  <div className={styles.exportScopeNote}>
+                    Export PDF always includes full case history from case creation through now, regardless of current filters.
+                  </div>
+                )}
+
+                {/* Filters */}
+                <AuditFiltersPanel
+                  dateRange={dateRange}
+                  customStartDate={customStartDate}
+                  customEndDate={customEndDate}
+                  customStartDateInput={customStartDateInput}
+                  customEndDateInput={customEndDateInput}
+                  caseNumber={caseNumber}
+                  filterCaseNumber={filterCaseNumber}
+                  caseNumberInput={caseNumberInput}
+                  filterBadgeId={filterBadgeId}
+                  badgeIdInput={badgeIdInput}
+                  filterAction={filterAction}
+                  filterResult={filterResult}
+                  onDateRangeChange={handleDateRangeChange}
+                  onCustomStartDateInputChange={setCustomStartDateInput}
+                  onCustomEndDateInputChange={setCustomEndDateInput}
+                  onApplyCustomDateRange={handleApplyCustomDateRange}
+                  onClearCustomDateRange={handleClearCustomDateRange}
+                  onCaseNumberInputChange={setCaseNumberInput}
+                  onApplyCaseFilter={handleApplyCaseFilter}
+                  onClearCaseFilter={handleClearCaseFilter}
+                  onBadgeIdInputChange={setBadgeIdInput}
+                  onApplyBadgeFilter={handleApplyBadgeFilter}
+                  onClearBadgeFilter={handleClearBadgeFilter}
+                  onFilterActionChange={setFilterAction}
+                  onFilterResultChange={setFilterResult}
+                />
+
+                {/* Entries List */}
+                <AuditEntriesList entries={filteredEntries} />
+
+              </>
+            )}
+
+            {auditEntries.length === 0 && !loading && !error && (
+              <div className={styles.noData}>
+                <p>
+                  {isArchivedReadOnlyCase
+                    ? 'No bundled audit trail entries are available for this imported archived case.'
+                    : 'No audit trail available. Your activities will appear here as you use Striae.'}
+                </p>
+              </div>
+            )}
+          </div>
         </div>
       </div>
-    </div>
+    </>
   );
 };

package/app/components/audit/user-audit.module.css

@@ -72,6 +72,12 @@
   transform: translateY(0);
 }
 
+.exportButton:disabled {
+  opacity: 0.65;
+  cursor: not-allowed;
+  box-shadow: none;
+}
+
 .title {
   margin: 0;
   color: var(--textTitle);
@@ -178,6 +184,17 @@
   border: 1px solid color-mix(in lab, var(--textLight) 20%, transparent);
 }
 
+.exportScopeNote {
+  margin: -12px 0 16px;
+  padding: 10px 12px;
+  border-radius: 6px;
+  border: 1px solid color-mix(in lab, var(--primary) 30%, transparent);
+  background: color-mix(in lab, var(--primary) 10%, transparent);
+  color: var(--textBody);
+  font-size: 0.85rem;
+  line-height: 1.45;
+}
+
 /* Common heading styles */
 .summary h3,
 .entriesList h3 {

package/app/components/audit/viewer/audit-viewer-header.tsx

@@ -3,16 +3,32 @@ import styles from '../user-audit.module.css';
 interface AuditViewerHeaderProps {
   title: string;
   onClose: () => void;
+  onExportPdf?: () => void;
+  canExportPdf?: boolean;
+  isExportingPdf?: boolean;
 }
 
 export const AuditViewerHeader = ({
   title,
   onClose,
+  onExportPdf,
+  canExportPdf = false,
+  isExportingPdf = false,
 }: AuditViewerHeaderProps) => {
   return (
     <div className={styles.header}>
       <h2 className={styles.title}>{title}</h2>
       <div className={styles.headerActions}>
+        {onExportPdf && (
+          <button
+            type="button"
+            className={styles.exportButton}
+            onClick={onExportPdf}
+            disabled={!canExportPdf || isExportingPdf}
+          >
+            {isExportingPdf ? 'Exporting PDF...' : 'Export PDF'}
+          </button>
+        )}
         <button className={styles.closeButton} onClick={onClose}>
           ×
         </button>

package/app/components/sidebar/notes/notes.module.css

@@ -730,7 +730,13 @@ textarea:focus {
   position: sticky;
   bottom: 0;
   padding: 0.75rem 0 0.25rem;
-  background: linear-gradient(to top, white 72%, rgba(255, 255, 255, 0));
+  background: linear-gradient(
+    to bottom,
+    rgba(255, 255, 255, 0),
+    white 28%,
+    white 72%,
+    rgba(255, 255, 255, 0)
+  );
 }
 
 .saveButton:hover {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@striae-org/striae",
-  "version": "5.4.5",
+  "version": "5.5.0",
   "private": false,
   "description": "Striae is a specialized, cloud-native platform designed to streamline forensic firearms identification by providing an intuitive environment for digital comparison image annotation, authenticated confirmations, and automated report generation.",
   "license": "Apache-2.0",
@@ -115,8 +115,8 @@
     "@types/qrcode": "^1.5.6",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@typescript-eslint/eslint-plugin": "^8.58.0",
-    "@typescript-eslint/parser": "^8.58.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.1",
+    "@typescript-eslint/parser": "^8.58.1",
     "eslint": "^9.39.4",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
@@ -126,9 +126,9 @@
     "firebase-admin": "^13.7.0",
     "modern-normalize": "^3.0.1",
     "typescript": "^5.9.3",
-    "vite": "^6.4.1",
+    "vite": "^7.3.2",
     "vite-tsconfig-paths": "^6.1.1",
-    "wrangler": "^4.80.0"
+    "wrangler": "^4.81.0"
   },
   "overrides": {
     "@tootallnate/once": "3.0.1",
@@ -136,7 +136,7 @@
     "undici": "7.24.1"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.19.0"
   },
   "packageManager": "npm@11.11.0"
 }

package/workers/audit-worker/package.json

@@ -9,7 +9,7 @@
 	},
 	"devDependencies": {
 		"@cloudflare/puppeteer": "^1.0.6",
-		"wrangler": "^4.80.0"
+		"wrangler": "^4.81.0"
 	},
 	"overrides": {
 		"undici": "7.24.1",

package/workers/audit-worker/wrangler.jsonc.example

@@ -7,7 +7,7 @@
   "name": "AUDIT_WORKER_NAME",
   "account_id": "ACCOUNT_ID",
   "main": "src/audit-worker.ts",
-  "compatibility_date": "2026-04-03",
+  "compatibility_date": "2026-04-08",
   "compatibility_flags": [
     "nodejs_compat"
   ], 

package/workers/data-worker/package.json

@@ -9,7 +9,7 @@
   },
   "devDependencies": {
     "@cloudflare/puppeteer": "^1.0.6",
-    "wrangler": "^4.80.0"
+    "wrangler": "^4.81.0"
   },
   "overrides": {
     "undici": "7.24.1",

package/workers/data-worker/wrangler.jsonc.example

@@ -5,7 +5,7 @@
   "name": "DATA_WORKER_NAME",
   "account_id": "ACCOUNT_ID",
   "main": "src/data-worker.ts",
-  "compatibility_date": "2026-04-03",
+  "compatibility_date": "2026-04-08",
   "compatibility_flags": [
     "nodejs_compat"
   ], 

package/workers/image-worker/package.json

@@ -9,7 +9,7 @@
 	},
 	"devDependencies": {
 		"@cloudflare/puppeteer": "^1.0.6",
-		"wrangler": "^4.80.0"
+		"wrangler": "^4.81.0"
 	},
 	"overrides": {
 		"undici": "7.24.1",

package/workers/image-worker/wrangler.jsonc.example

@@ -2,7 +2,7 @@
   "name": "IMAGES_WORKER_NAME",
   "account_id": "ACCOUNT_ID",
   "main": "src/image-worker.ts",
-  "compatibility_date": "2026-04-03",
+  "compatibility_date": "2026-04-08",
   "compatibility_flags": [
     "nodejs_compat"
   ], 

package/workers/pdf-worker/package.json

@@ -10,7 +10,7 @@
 	},
 	"devDependencies": {
 		"@cloudflare/puppeteer": "^1.0.6",
-		"wrangler": "^4.80.0"
+		"wrangler": "^4.81.0"
 	},
 	"overrides": {
 		"undici": "7.24.1",

package/workers/pdf-worker/src/audit-trail-report.ts

@@ -0,0 +1,231 @@
+import type { AuditTrailReportPayload, PDFGenerationData, ReportPdfOptions } from './report-types';
+import { buildRepeatedChromePdfOptions, escapeHtml } from './report-layout';
+
+const safeText = (value: unknown): string => escapeHtml(String(value ?? ''));
+
+const formatTimestamp = (timestamp: string): string => {
+  const parsed = new Date(timestamp);
+  if (Number.isNaN(parsed.getTime())) {
+    return timestamp;
+  }
+
+  return parsed.toISOString();
+};
+
+const renderEntryDetailsSummary = (entry: Record<string, unknown>): string => {
+  const details = (entry.details ?? {}) as Record<string, unknown>;
+  const caseNumber = typeof details.caseNumber === 'string' ? details.caseNumber : '';
+  const workflowPhase = typeof details.workflowPhase === 'string' ? details.workflowPhase : '';
+  const fileName = typeof details.fileName === 'string' ? details.fileName : '';
+
+  const summaryRows = [
+    caseNumber ? `<div><strong>Case:</strong> ${safeText(caseNumber)}</div>` : '',
+    workflowPhase ? `<div><strong>Phase:</strong> ${safeText(workflowPhase)}</div>` : '',
+    fileName ? `<div><strong>File:</strong> ${safeText(fileName)}</div>` : ''
+  ].filter(Boolean);
+
+  if (summaryRows.length === 0) {
+    return '<div class="entry-meta-muted">No structured summary fields available.</div>';
+  }
+
+  return summaryRows.join('');
+};
+
+const renderRawJsonAppendix = (entry: unknown): string => {
+  if (entry === null || entry === undefined) {
+    return '';
+  }
+
+  let rawJson: string;
+  try {
+    rawJson = JSON.stringify(entry, null, 2) ?? '';
+  } catch {
+    return '';
+  }
+
+  if (!rawJson) {
+    return '';
+  }
+
+  return `
+    <div class="entry-raw-json">
+      <div class="entry-raw-label">Raw JSON Entry</div>
+      <pre>${escapeHtml(rawJson)}</pre>
+    </div>
+  `;
+};
+
+export const isAuditTrailReportMode = (data: PDFGenerationData): boolean =>
+  data.reportMode === 'audit-trail';
+
+export const getAuditTrailPayload = (data: PDFGenerationData): AuditTrailReportPayload => {
+  const payload = data.auditTrailReport;
+
+  if (!payload) {
+    throw new Error('Audit trail report payload is required when reportMode is audit-trail');
+  }
+
+  return payload;
+};
+
+export const renderAuditTrailReport = (data: PDFGenerationData): string => {
+  const payload = getAuditTrailPayload(data);
+  const entries = payload.entries || [];
+
+  const entrySections = entries.map((entry, index) => {
+    const entryRecord = entry as Record<string, unknown>;
+    const timestamp = typeof entryRecord.timestamp === 'string' ? entryRecord.timestamp : 'unknown';
+    const action = typeof entryRecord.action === 'string' ? entryRecord.action : 'unknown';
+    const result = typeof entryRecord.result === 'string' ? entryRecord.result : 'unknown';
+    const userEmail = typeof entryRecord.userEmail === 'string' ? entryRecord.userEmail : 'unknown';
+    const userId = typeof entryRecord.userId === 'string' ? entryRecord.userId : 'unknown';
+
+    return `
+      <section class="entry-section">
+        <h3 class="entry-title">Entry ${index + 1} of ${entries.length}</h3>
+        <div class="entry-core-grid">
+          <div><strong>Timestamp:</strong> ${safeText(formatTimestamp(timestamp))}</div>
+          <div><strong>Action:</strong> ${safeText(action)}</div>
+          <div><strong>Result:</strong> ${safeText(result)}</div>
+          <div><strong>User Email:</strong> ${safeText(userEmail)}</div>
+          <div><strong>User ID:</strong> ${safeText(userId)}</div>
+        </div>
+        <div class="entry-meta">
+          ${renderEntryDetailsSummary(entryRecord)}
+        </div>
+        ${renderRawJsonAppendix(entry)}
+      </section>
+    `;
+  }).join('');
+
+  return `
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <style>
+      html, body {
+        margin: 0;
+        padding: 0;
+        width: 100%;
+        font-family: Arial, sans-serif;
+        color: #1f2933;
+        background: #ffffff;
+      }
+      body {
+        box-sizing: border-box;
+      }
+      .report-body {
+        width: 100%;
+        box-sizing: border-box;
+      }
+      .summary {
+        border: 1px solid #d0d7de;
+        border-radius: 8px;
+        padding: 16px;
+        margin-bottom: 16px;
+        page-break-inside: avoid;
+      }
+      .summary h1 {
+        margin: 0 0 8px;
+        font-size: 22px;
+      }
+      .summary-grid {
+        display: grid;
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+        gap: 6px 12px;
+        font-size: 12px;
+      }
+      .entry-section {
+        border: 1px solid #d0d7de;
+        border-radius: 8px;
+        padding: 12px;
+        margin-bottom: 12px;
+        page-break-inside: avoid;
+      }
+      .entry-title {
+        margin: 0 0 8px;
+        font-size: 14px;
+      }
+      .entry-core-grid {
+        display: grid;
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+        gap: 6px 12px;
+        font-size: 11px;
+      }
+      .entry-meta {
+        margin-top: 10px;
+        font-size: 11px;
+        color: #334155;
+      }
+      .entry-meta-muted {
+        color: #64748b;
+        font-style: italic;
+      }
+      .entry-raw-json {
+        margin-top: 12px;
+        border-top: 1px dashed #c5ced8;
+        padding-top: 10px;
+      }
+      .entry-raw-label {
+        font-size: 10px;
+        letter-spacing: 0.05em;
+        text-transform: uppercase;
+        color: #475569;
+        margin-bottom: 6px;
+        font-weight: 700;
+      }
+      .entry-raw-json pre {
+        margin: 0;
+        padding: 10px;
+        border: 1px solid #d0d7de;
+        border-radius: 6px;
+        background: #f8fafc;
+        color: #0f172a;
+        font-size: 10px;
+        line-height: 1.5;
+        white-space: pre-wrap;
+        word-break: break-word;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="report-body">
+      <section class="summary">
+        <h1>Case Audit Trail Report</h1>
+        <div class="summary-grid">
+          <div><strong>Case Number:</strong> ${safeText(payload.caseNumber)}</div>
+          <div><strong>Exported At:</strong> ${safeText(formatTimestamp(payload.exportedAt))}</div>
+          <div><strong>Range Start:</strong> ${safeText(formatTimestamp(payload.exportRangeStart))}</div>
+          <div><strong>Range End:</strong> ${safeText(formatTimestamp(payload.exportRangeEnd))}</div>
+          <div><strong>Total Entries (All Parts):</strong> ${safeText(payload.totalEntries)}</div>
+          <div><strong>This Part:</strong> ${safeText(payload.chunkIndex)} of ${safeText(payload.totalChunks)}</div>
+          <div><strong>Entries in Part:</strong> ${safeText(entries.length)}</div>
+          <div><strong>Raw JSON Appendix:</strong> Included when available</div>
+        </div>
+      </section>
+      ${entrySections}
+    </div>
+  </body>
+</html>
+`;
+};
+
+export const getAuditTrailPdfOptions = (data: PDFGenerationData): Partial<ReportPdfOptions> => {
+  const payload = getAuditTrailPayload(data);
+
+  return {
+    format: 'letter',
+    ...buildRepeatedChromePdfOptions({
+      headerLeft: data.currentDate,
+      headerCenter: 'Case Audit Trail Report',
+      headerRight: `Case ${payload.caseNumber}`,
+      headerDetailLeft: `Entries ${payload.totalEntries}`,
+      headerDetailRight: `Part ${payload.chunkIndex}/${payload.totalChunks}`,
+      footerLeft: 'Striae Audit Export',
+      footerCenter: payload.exportedAt,
+      footerRight: `Case ${payload.caseNumber}`,
+      includePageNumbers: true
+    })
+  };
+};

package/workers/pdf-worker/src/formats/format-striae.ts

@@ -480,17 +480,19 @@ export const renderReport: ReportRenderer = (data: PDFGenerationData): string =>
 `;
 };
 
-export const getPdfOptions: ReportPdfOptionsBuilder = (data: PDFGenerationData) => buildRepeatedChromePdfOptions({
-  headerLeft: data.currentDate,
-  headerRight: data.caseNumber,
-  headerDetailLeft: [data.annotationData?.leftCase, data.annotationData?.leftItem].filter(Boolean).join(' / ')
-    ? `Left Case / Item: ${[data.annotationData?.leftCase, data.annotationData?.leftItem].filter(Boolean).join(' / ')}`
-    : undefined,
-  headerDetailRight: [data.annotationData?.rightCase, data.annotationData?.rightItem].filter(Boolean).join(' / ')
-    ? `Right Case / Item: ${[data.annotationData?.rightCase, data.annotationData?.rightItem].filter(Boolean).join(' / ')}`
-    : undefined,
-  footerLeft: 'Notes formatted by Striae',
-  footerCenter: data.userCompany,
-  footerRight: data.notesUpdatedFormatted ? `Notes updated ${data.notesUpdatedFormatted}` : undefined,
-  footerLeftImageSrc: ICON_256,
-});
+export const getPdfOptions: ReportPdfOptionsBuilder = (data: PDFGenerationData) => {
+  return buildRepeatedChromePdfOptions({
+    headerLeft: data.currentDate,
+    headerRight: data.caseNumber,
+    headerDetailLeft: [data.annotationData?.leftCase, data.annotationData?.leftItem].filter(Boolean).join(' / ')
+      ? `Left Case / Item: ${[data.annotationData?.leftCase, data.annotationData?.leftItem].filter(Boolean).join(' / ')}`
+      : undefined,
+    headerDetailRight: [data.annotationData?.rightCase, data.annotationData?.rightItem].filter(Boolean).join(' / ')
+      ? `Right Case / Item: ${[data.annotationData?.rightCase, data.annotationData?.rightItem].filter(Boolean).join(' / ')}`
+      : undefined,
+    footerLeft: 'Notes formatted by Striae',
+    footerCenter: data.userCompany,
+    footerRight: data.notesUpdatedFormatted ? `Notes updated ${data.notesUpdatedFormatted}` : undefined,
+    footerLeftImageSrc: ICON_256,
+  });
+};

package/workers/pdf-worker/src/pdf-worker.example.ts

@@ -1,4 +1,5 @@
 import type { PDFGenerationData, PDFGenerationRequest, ReportModule, ReportPdfOptions } from './report-types';
+import { getAuditTrailPdfOptions, isAuditTrailReportMode, renderAuditTrailReport } from './audit-trail-report';
 
 interface Env {
   PDF_WORKER_AUTH: string;
@@ -112,6 +113,13 @@ function resolveReportRequest(payload: unknown): PDFGenerationRequest {
 }
 
 async function renderReport(reportFormat: string, data: PDFGenerationData): Promise<{ html: string; pdfOptions: ReportPdfOptions }> {
+  if (isAuditTrailReportMode(data)) {
+    return {
+      html: renderAuditTrailReport(data),
+      pdfOptions: resolvePdfOptions(getAuditTrailPdfOptions(data)),
+    };
+  }
+
   const loader = reportModuleLoaders[reportFormat];
 
   if (!loader) {

package/workers/pdf-worker/src/report-types.ts

@@ -58,6 +58,20 @@ export interface PDFGenerationData {
   userFirstName?: string;
   userLastName?: string;
   userBadgeId?: string;
+  reportMode?: 'audit-trail';
+  auditTrailReport?: AuditTrailReportPayload;
+}
+
+export interface AuditTrailReportPayload {
+  caseNumber: string;
+  exportedAt: string;
+  exportRangeStart: string;
+  exportRangeEnd: string;
+  chunkIndex: number;
+  totalChunks: number;
+  totalEntries: number;
+  includeRawJsonAppendix: boolean;
+  entries: unknown[];
 }
 
 export interface PDFGenerationRequest {

package/workers/pdf-worker/wrangler.jsonc.example

@@ -2,7 +2,7 @@
   "name": "PDF_WORKER_NAME",
   "account_id": "ACCOUNT_ID",
   "main": "src/pdf-worker.ts",
-  "compatibility_date": "2026-04-03",
+  "compatibility_date": "2026-04-08",
   "compatibility_flags": [
     "nodejs_compat"
   ],

package/workers/user-worker/package.json

@@ -9,7 +9,7 @@
   },
   "devDependencies": {
     "@cloudflare/puppeteer": "^1.0.6",
-    "wrangler": "^4.80.0"
+    "wrangler": "^4.81.0"
   },
   "overrides": {
     "undici": "7.24.1",

package/workers/user-worker/wrangler.jsonc.example

@@ -2,7 +2,7 @@
   "name": "USER_WORKER_NAME",
   "account_id": "ACCOUNT_ID",
   "main": "src/user-worker.ts",
-  "compatibility_date": "2026-04-03",
+  "compatibility_date": "2026-04-08",
   "compatibility_flags": [
     "nodejs_compat"
   ], 

package/wrangler.toml.example

@@ -1,6 +1,6 @@
 #:schema node_modules/wrangler/config-schema.json
 name = "PAGES_PROJECT_NAME"
-compatibility_date = "2026-04-03"
+compatibility_date = "2026-04-08"
 compatibility_flags = ["nodejs_compat"]
 pages_build_output_dir = "./build/client"