@striae-org/striae 5.4.5 → 5.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@striae-org/striae",
-  "version": "5.4.5",
+  "version": "5.5.1",
   "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",
@@ -105,8 +105,8 @@
     "isbot": "^5.1.37",
     "jszip": "^3.10.1",
     "qrcode": "^1.5.4",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "react-router": "^7.14.0"
   },
   "devDependencies": {
@@ -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.1"
   },
   "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/scripts/update-markdown-versions.cjs

@@ -7,6 +7,14 @@ const markdownFiles = [
   // Add other markdown files that need version updates
 ];
 
+const workerDirs = [
+  'workers/audit-worker',
+  'workers/data-worker',
+  'workers/image-worker',
+  'workers/pdf-worker',
+  'workers/user-worker',
+];
+
 function updateMarkdownVersions() {
   console.log(`📝 Updating markdown files with version ${packageJson.version}...`);
   
@@ -31,8 +39,57 @@ function updateMarkdownVersions() {
       console.error(`❌ Error updating ${filePath}:`, error.message);
     }
   });
+
+  console.log(`📦 Updating worker package.json files with version ${packageJson.version}...`);
+
+  workerDirs.forEach(workerDir => {
+    const pkgPath = path.join(__dirname, '..', workerDir, 'package.json');
+    const lockPath = path.join(__dirname, '..', workerDir, 'package-lock.json');
+
+    // --- Update package.json ---
+    if (!fs.existsSync(pkgPath)) {
+      console.log(`⚠️  Skipping ${workerDir}/package.json (file not found)`);
+    } else {
+      try {
+        const workerPkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        workerPkg.version = packageJson.version;
+        fs.writeFileSync(pkgPath, JSON.stringify(workerPkg, null, 2) + '\n');
+        console.log(`✅ Updated ${workerDir}/package.json`);
+      } catch (error) {
+        console.error(`❌ Error updating ${workerDir}/package.json:`, error.message);
+      }
+    }
+
+    // --- Update package-lock.json ---
+    // Lockfile v2/v3 stores the version in two places:
+    //   - Top-level `version` field
+    //   - `packages[""].version` (the self-referencing root entry)
+    // Both must match package.json to pass `npm ci` consistency checks.
+    if (!fs.existsSync(lockPath)) {
+      console.log(
+        `⚠️  No package-lock.json found in ${workerDir} — run \`npm install\` there to generate one.`
+      );
+    } else {
+      try {
+        const lockData = JSON.parse(fs.readFileSync(lockPath, 'utf8'));
+
+        if ('version' in lockData) {
+          lockData.version = packageJson.version;
+        }
+
+        if (lockData.packages && '' in lockData.packages) {
+          lockData.packages[''].version = packageJson.version;
+        }
+
+        fs.writeFileSync(lockPath, JSON.stringify(lockData, null, 2) + '\n');
+        console.log(`✅ Updated ${workerDir}/package-lock.json`);
+      } catch (error) {
+        console.error(`❌ Error updating ${workerDir}/package-lock.json:`, error.message);
+      }
+    }
+  });
   
-  console.log('🎉 Markdown version update complete!');
+  console.log('🎉 Version update complete!');
 }
 
 // Run if called directly

package/workers/audit-worker/package.json

@@ -1,18 +1,17 @@
-{
-	"name": "audit-worker",
-	"version": "0.0.0",
-	"private": true,
-	"scripts": {
-		"deploy": "wrangler deploy",
-		"dev": "wrangler dev",
-		"start": "wrangler dev"
-	},
-	"devDependencies": {
-		"@cloudflare/puppeteer": "^1.0.6",
-		"wrangler": "^4.80.0"
-	},
-	"overrides": {
-		"undici": "7.24.1",
-		"yauzl": "3.2.1"
-	}
-}
+{
+  "name": "audit-worker",
+  "version": "5.5.1",
+  "private": true,
+  "scripts": {
+    "deploy": "wrangler deploy",
+    "dev": "wrangler dev",
+    "start": "wrangler dev"
+  },
+  "devDependencies": {
+    "wrangler": "^4.81.1"
+  },
+  "overrides": {
+    "undici": "7.24.1",
+    "yauzl": "3.2.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-09",
   "compatibility_flags": [
     "nodejs_compat"
   ], 

package/workers/data-worker/package.json

@@ -1,18 +1,17 @@
-{
-  "name": "data-worker",
-  "version": "0.0.0",
-  "private": true,
-  "scripts": {
-    "deploy": "wrangler deploy",
-    "dev": "wrangler dev",
-    "start": "wrangler dev"
-  },
-  "devDependencies": {
-    "@cloudflare/puppeteer": "^1.0.6",
-    "wrangler": "^4.80.0"
-  },
-  "overrides": {
-    "undici": "7.24.1",
-    "yauzl": "3.2.1"
-  }
-}
+{
+  "name": "data-worker",
+  "version": "5.5.1",
+  "private": true,
+  "scripts": {
+    "deploy": "wrangler deploy",
+    "dev": "wrangler dev",
+    "start": "wrangler dev"
+  },
+  "devDependencies": {
+    "wrangler": "^4.81.1"
+  },
+  "overrides": {
+    "undici": "7.24.1",
+    "yauzl": "3.2.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-09",
   "compatibility_flags": [
     "nodejs_compat"
   ], 

package/workers/image-worker/package.json

@@ -1,18 +1,17 @@
-{
-	"name": "image-worker",
-	"version": "0.0.0",
-	"private": true,
-	"scripts": {
-		"deploy": "wrangler deploy",
-		"dev": "wrangler dev",
-		"start": "wrangler dev"
-	},
-	"devDependencies": {
-		"@cloudflare/puppeteer": "^1.0.6",
-		"wrangler": "^4.80.0"
-	},
-	"overrides": {
-		"undici": "7.24.1",
-		"yauzl": "3.2.1"
-	}
-}
+{
+  "name": "image-worker",
+  "version": "5.5.1",
+  "private": true,
+  "scripts": {
+    "deploy": "wrangler deploy",
+    "dev": "wrangler dev",
+    "start": "wrangler dev"
+  },
+  "devDependencies": {
+    "wrangler": "^4.81.1"
+  },
+  "overrides": {
+    "undici": "7.24.1",
+    "yauzl": "3.2.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-09",
   "compatibility_flags": [
     "nodejs_compat"
   ], 

package/workers/pdf-worker/package.json

@@ -1,19 +1,18 @@
-{
-	"name": "pdf-worker",
-	"version": "0.0.0",
-	"private": true,
-	"scripts": {
-		"generate:assets": "node scripts/generate-assets.js",
-		"deploy": "wrangler deploy",
-		"dev": "wrangler dev",
-		"start": "wrangler dev"
-	},
-	"devDependencies": {
-		"@cloudflare/puppeteer": "^1.0.6",
-		"wrangler": "^4.80.0"
-	},
-	"overrides": {
-		"undici": "7.24.1",
-		"yauzl": "3.2.1"
-	}
-}
+{
+  "name": "pdf-worker",
+  "version": "5.5.1",
+  "private": true,
+  "scripts": {
+    "generate:assets": "node scripts/generate-assets.js",
+    "deploy": "wrangler deploy",
+    "dev": "wrangler dev",
+    "start": "wrangler dev"
+  },
+  "devDependencies": {
+    "wrangler": "^4.81.1"
+  },
+  "overrides": {
+    "undici": "7.24.1",
+    "yauzl": "3.2.1"
+  }
+}

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

@@ -0,0 +1,253 @@
+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, timezone?: string): string => {
+  const parsed = new Date(timestamp);
+  if (Number.isNaN(parsed.getTime())) {
+    return timestamp;
+  }
+
+  if (!timezone) {
+    return parsed.toISOString();
+  }
+
+  try {
+      const parts = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        month: '2-digit',
+        day: '2-digit',
+        year: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+        timeZoneName: 'short'
+      }).formatToParts(parsed);
+
+      const get = (type: string): string => parts.find(p => p.type === type)?.value ?? '';
+      return `${get('month')}/${get('day')}/${get('year')} ${get('hour')}:${get('minute')}:${get('second')} ${get('timeZoneName')}`;
+  } catch {
+    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 timezone = data.userTimezone;
+
+  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, timezone))}</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, timezone))}</div>
+          <div><strong>Range Start:</strong> ${safeText(formatTimestamp(payload.exportRangeStart, timezone))}</div>
+          <div><strong>Range End:</strong> ${safeText(formatTimestamp(payload.exportRangeEnd, timezone))}</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,21 @@ export interface PDFGenerationData {
   userFirstName?: string;
   userLastName?: string;
   userBadgeId?: string;
+  reportMode?: 'audit-trail';
+  auditTrailReport?: AuditTrailReportPayload;
+  userTimezone?: string;
+}
+
+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-09",
   "compatibility_flags": [
     "nodejs_compat"
   ],