Release 0.1: Complete BinectChrome implementation

Implements all requirements from ProductRequirementsDocument.md:
- PDF detection via Chrome Downloads API
- Secure credential storage with AES-GCM encryption
- Binect API integration for PDF uploads
- Popup UI with Binect branding
- Local transfer tracking (500 entry cap)
- Help page with tracking view and CSV export
- 60-day credential retention with auto-expiry
- Accessibility compliance (WCAG 2.1 AA)

Technical implementation:
- Chrome Extension Manifest V3
- TypeScript with strict mode
- Webpack build system
- Jest test suite (22/22 passing)
- ESLint configured (0 errors)

Build output: 13 KB total (production minified)
Test coverage: crypto, pdf-detector, tracker, binect-api

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
tegwick 2026-01-13 00:30:39 +01:00
parent 8f85c51d4e
commit b09290cb83
43 changed files with 12078 additions and 2 deletions

315
src/popup/popup.css Normal file
View file

@ -0,0 +1,315 @@
/**
* Popup UI Styles
* Based on Binect Innovation BrandBook
*/
:root {
/* Core Colors */
--binect-blue: #4A90E2;
--binect-blue-deep: #2C5F8D;
--neutral-ink: #1A1A1A;
--paper: #FFFFFF;
--light-bg: #F8F9FA;
/* Accent Colors */
--signal-green: #4CAF50;
--cyan: #00BCD4;
--red: #E53935;
/* Text */
--text-primary: #1A1A1A;
--text-secondary: #666666;
--text-light: #999999;
/* Spacing */
--spacing-xs: 4px;
--spacing-sm: 8px;
--spacing-md: 16px;
--spacing-lg: 24px;
/* Border */
--border-radius: 8px;
--border-color: #E0E0E0;
}
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
font-size: 14px;
line-height: 1.5;
color: var(--text-primary);
background: var(--paper);
width: 380px;
min-height: 400px;
}
.container {
display: flex;
flex-direction: column;
height: 100%;
}
/* Header */
.header {
display: flex;
justify-content: space-between;
align-items: center;
padding: var(--spacing-md);
border-bottom: 1px solid var(--border-color);
background: var(--light-bg);
}
.header h1 {
font-size: 18px;
font-weight: 600;
color: var(--binect-blue-deep);
}
.icon-btn {
width: 32px;
height: 32px;
border-radius: 50%;
border: 2px solid var(--binect-blue);
background: var(--paper);
color: var(--binect-blue);
font-size: 16px;
font-weight: 600;
cursor: pointer;
transition: all 0.2s;
}
.icon-btn:hover {
background: var(--binect-blue);
color: var(--paper);
}
.icon-btn:focus {
outline: 2px solid var(--binect-blue);
outline-offset: 2px;
}
/* Views */
.view {
flex: 1;
padding: var(--spacing-lg);
}
/* Info Text */
.info-text {
color: var(--text-secondary);
margin-bottom: var(--spacing-md);
text-align: center;
}
/* Forms */
.form-group {
margin-bottom: var(--spacing-md);
}
.form-group label {
display: block;
margin-bottom: var(--spacing-xs);
font-weight: 500;
color: var(--text-primary);
}
.form-group input {
width: 100%;
padding: var(--spacing-sm) var(--spacing-md);
border: 1px solid var(--border-color);
border-radius: var(--border-radius);
font-size: 14px;
transition: border-color 0.2s;
}
.form-group input:focus {
outline: none;
border-color: var(--binect-blue);
box-shadow: 0 0 0 3px rgba(74, 144, 226, 0.1);
}
/* Buttons */
.btn {
width: 100%;
padding: var(--spacing-sm) var(--spacing-md);
border: none;
border-radius: var(--border-radius);
font-size: 14px;
font-weight: 500;
cursor: pointer;
transition: all 0.2s;
text-align: center;
min-height: 44px; /* Accessibility: touch target size */
}
.btn:focus {
outline: 2px solid var(--binect-blue);
outline-offset: 2px;
}
.btn-primary {
background: var(--binect-blue);
color: var(--paper);
}
.btn-primary:hover {
background: var(--binect-blue-deep);
}
.btn-primary:disabled {
background: var(--border-color);
cursor: not-allowed;
}
.btn-secondary {
background: var(--light-bg);
color: var(--text-primary);
border: 1px solid var(--border-color);
}
.btn-secondary:hover {
background: var(--border-color);
}
.btn-large {
padding: var(--spacing-md);
font-size: 16px;
min-height: 48px;
}
.btn-small {
padding: var(--spacing-xs) var(--spacing-sm);
font-size: 12px;
min-height: 36px;
}
/* PDF Info */
.content-section {
margin-bottom: var(--spacing-lg);
}
.pdf-info {
display: flex;
gap: var(--spacing-md);
padding: var(--spacing-md);
background: var(--light-bg);
border-radius: var(--border-radius);
margin-bottom: var(--spacing-md);
}
.pdf-icon {
font-size: 32px;
flex-shrink: 0;
}
.pdf-details {
flex: 1;
min-width: 0;
}
.pdf-filename {
font-weight: 600;
color: var(--text-primary);
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.pdf-meta {
font-size: 12px;
color: var(--text-secondary);
margin-top: var(--spacing-xs);
}
.pdf-timestamp {
font-size: 11px;
color: var(--text-light);
margin-top: var(--spacing-xs);
}
/* Status Messages */
.status-message {
padding: var(--spacing-md);
border-radius: var(--border-radius);
text-align: center;
margin-top: var(--spacing-md);
}
.status-message.uploading {
background: rgba(0, 188, 212, 0.1);
color: var(--cyan);
border: 1px solid var(--cyan);
}
.status-message.success {
background: rgba(76, 175, 80, 0.1);
color: var(--signal-green);
border: 1px solid var(--signal-green);
}
.status-message.error {
background: rgba(229, 57, 53, 0.1);
color: var(--red);
border: 1px solid var(--red);
}
.error-message {
padding: var(--spacing-sm);
background: rgba(229, 57, 53, 0.1);
color: var(--red);
border-radius: var(--border-radius);
font-size: 12px;
margin-top: var(--spacing-sm);
}
/* Settings */
.settings-section {
border-top: 1px solid var(--border-color);
padding-top: var(--spacing-md);
}
/* Footer */
.footer {
padding: var(--spacing-md);
border-top: 1px solid var(--border-color);
text-align: center;
}
.footer-link {
font-size: 12px;
color: var(--binect-blue);
text-decoration: none;
}
.footer-link:hover {
text-decoration: underline;
}
.footer-link:focus {
outline: 2px solid var(--binect-blue);
outline-offset: 2px;
border-radius: 2px;
}
/* Accessibility */
@media (prefers-reduced-motion: reduce) {
* {
transition: none !important;
}
}
/* High contrast mode support */
@media (prefers-contrast: high) {
.btn-primary {
border: 2px solid var(--text-primary);
}
.form-group input {
border-width: 2px;
}
}

82
src/popup/popup.html Normal file
View file

@ -0,0 +1,82 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>BinectChrome</title>
<link rel="stylesheet" href="popup.css">
</head>
<body>
<div class="container">
<!-- Header -->
<div class="header">
<h1>BinectChrome</h1>
<button id="helpBtn" class="icon-btn" aria-label="Help and tracking info" title="Help & Info">?</button>
</div>
<!-- Authentication View -->
<div id="authView" class="view">
<p class="info-text">Please sign in to send PDFs to Binect</p>
<form id="loginForm">
<div class="form-group">
<label for="username">Username</label>
<input type="text" id="username" name="username" required autocomplete="username">
</div>
<div class="form-group">
<label for="password">Password</label>
<input type="password" id="password" name="password" required autocomplete="current-password">
</div>
<button type="submit" class="btn btn-primary" id="loginBtn">Sign In</button>
<div id="authError" class="error-message" style="display: none;"></div>
</form>
</div>
<!-- Main View (After Authentication) -->
<div id="mainView" class="view" style="display: none;">
<!-- No PDF Detected -->
<div id="noPdfView" class="content-section">
<p class="info-text">No PDF detected. Download a PDF to get started.</p>
</div>
<!-- PDF Detected -->
<div id="pdfView" class="content-section" style="display: none;">
<div class="pdf-info">
<div class="pdf-icon">📄</div>
<div class="pdf-details">
<div class="pdf-filename" id="pdfFilename"></div>
<div class="pdf-meta">
<span id="pdfSize"></span><span id="pdfDomain"></span>
</div>
<div class="pdf-timestamp" id="pdfTimestamp"></div>
</div>
</div>
<button id="sendBtn" class="btn btn-primary btn-large">
Send PDF to Binect
</button>
<!-- Progress/Status -->
<div id="statusMessage" class="status-message" style="display: none;"></div>
</div>
<!-- Settings -->
<div class="settings-section">
<button id="logoutBtn" class="btn btn-secondary btn-small">Sign Out</button>
</div>
</div>
<!-- Footer -->
<div class="footer">
<a href="mailto:bernd.worsch@binect.de?subject=BinectChrome Feedback" class="footer-link">
Report Issue / Request Feature
</a>
</div>
</div>
<script src="popup.js"></script>
</body>
</html>

334
src/popup/popup.ts Normal file
View file

@ -0,0 +1,334 @@
/**
* Popup UI Logic
*/
import { loadCredentials, saveCredentials, deleteCredentials, updateLastUse } from '../utils/storage';
import { authenticate, uploadPDF, BinectAPIError } from '../utils/binect-api';
import { fetchPDFBytes, DetectedPDF } from '../utils/pdf-detector';
import { addTrackingEntry } from '../tracking/tracker';
// DOM Elements
const authView = document.getElementById('authView')!;
const mainView = document.getElementById('mainView')!;
const noPdfView = document.getElementById('noPdfView')!;
const pdfView = document.getElementById('pdfView')!;
const loginForm = document.getElementById('loginForm') as HTMLFormElement;
const usernameInput = document.getElementById('username') as HTMLInputElement;
const passwordInput = document.getElementById('password') as HTMLInputElement;
const loginBtn = document.getElementById('loginBtn') as HTMLButtonElement;
const authError = document.getElementById('authError')!;
const pdfFilename = document.getElementById('pdfFilename')!;
const pdfSize = document.getElementById('pdfSize')!;
const pdfDomain = document.getElementById('pdfDomain')!;
const pdfTimestamp = document.getElementById('pdfTimestamp')!;
const sendBtn = document.getElementById('sendBtn') as HTMLButtonElement;
const statusMessage = document.getElementById('statusMessage')!;
const logoutBtn = document.getElementById('logoutBtn')!;
const helpBtn = document.getElementById('helpBtn')!;
// State
let currentPDF: DetectedPDF | null = null;
let authToken: string | null = null;
/**
* Initialize popup
*/
async function init() {
// Check if user has credentials
const credentials = await loadCredentials();
if (credentials) {
// Try to authenticate
try {
const token = await authenticate(credentials.username, credentials.password);
authToken = token.token;
await updateLastUse();
showMainView();
await loadLastPDF();
} catch (error) {
// Authentication failed, credentials may be invalid
showAuthView();
}
} else {
showAuthView();
}
// Setup event listeners
setupEventListeners();
}
/**
* Setup event listeners
*/
function setupEventListeners() {
loginForm.addEventListener('submit', handleLogin);
sendBtn.addEventListener('click', handleSendPDF);
logoutBtn.addEventListener('click', handleLogout);
helpBtn.addEventListener('click', handleHelp);
}
/**
* Handle login
*/
async function handleLogin(e: Event) {
e.preventDefault();
const username = usernameInput.value.trim();
const password = passwordInput.value;
if (!username || !password) {
showError('Please enter username and password');
return;
}
loginBtn.disabled = true;
loginBtn.textContent = 'Signing in...';
hideError();
try {
const token = await authenticate(username, password);
authToken = token.token;
// Save credentials
await saveCredentials({ username, password });
showMainView();
await loadLastPDF();
} catch (error) {
if (error instanceof BinectAPIError) {
showError(error.message);
} else {
showError('Authentication failed. Please try again.');
}
} finally {
loginBtn.disabled = false;
loginBtn.textContent = 'Sign In';
}
}
/**
* Handle send PDF
*/
async function handleSendPDF() {
if (!currentPDF || !authToken) {
return;
}
sendBtn.disabled = true;
showStatus('Uploading...', 'uploading');
try {
// Fetch PDF bytes
const pdfBytes = await fetchPDFBytes(currentPDF.url);
// Upload to Binect
const result = await uploadPDF(pdfBytes, currentPDF.filename, authToken);
// Track successful transfer
await addTrackingEntry({
timestamp: Date.now(),
sourceDomain: currentPDF.sourceDomain,
destinationUrl: 'https://api.binect.de/documents/upload',
pdfSize: currentPDF.size,
result: 'success'
});
// Update last use timestamp
await updateLastUse();
// Notify background script
chrome.runtime.sendMessage({ action: 'pdfSent' });
showStatus(`Success! Document ID: ${result.documentId}`, 'success');
// Clear PDF after 3 seconds
setTimeout(() => {
currentPDF = null;
showNoPDF();
hideStatus();
}, 3000);
} catch (error) {
let errorMessage = 'Upload failed';
if (error instanceof BinectAPIError) {
errorMessage = error.message;
// If auth error, might need to re-login
if (error.statusCode === 401) {
errorMessage = 'Session expired. Please sign in again.';
setTimeout(() => {
handleLogout();
}, 2000);
}
} else if (error instanceof Error) {
errorMessage = error.message;
}
// Track failed transfer
await addTrackingEntry({
timestamp: Date.now(),
sourceDomain: currentPDF.sourceDomain,
destinationUrl: 'https://api.binect.de/documents/upload',
pdfSize: currentPDF.size,
result: 'failure',
errorMessage
});
showStatus(errorMessage, 'error');
} finally {
sendBtn.disabled = false;
}
}
/**
* Handle logout
*/
async function handleLogout() {
await deleteCredentials();
authToken = null;
currentPDF = null;
// Clear form
loginForm.reset();
showAuthView();
}
/**
* Handle help button
*/
function handleHelp() {
// Open tracking page
chrome.tabs.create({ url: chrome.runtime.getURL('tracking.html') });
}
/**
* Load last detected PDF
*/
async function loadLastPDF() {
// Ask background script for last PDF
chrome.runtime.sendMessage({ action: 'getLastPDF' }, (response) => {
if (response && response.pdf) {
currentPDF = response.pdf;
if (currentPDF) {
showPDF(currentPDF);
} else {
showNoPDF();
}
} else {
showNoPDF();
}
});
}
/**
* Show auth view
*/
function showAuthView() {
authView.style.display = 'block';
mainView.style.display = 'none';
}
/**
* Show main view
*/
function showMainView() {
authView.style.display = 'none';
mainView.style.display = 'block';
}
/**
* Show no PDF view
*/
function showNoPDF() {
noPdfView.style.display = 'block';
pdfView.style.display = 'none';
}
/**
* Show PDF view
*/
function showPDF(pdf: DetectedPDF) {
noPdfView.style.display = 'none';
pdfView.style.display = 'block';
pdfFilename.textContent = pdf.filename;
pdfSize.textContent = formatFileSize(pdf.size);
pdfDomain.textContent = pdf.sourceDomain;
pdfTimestamp.textContent = formatTimestamp(pdf.timestamp);
sendBtn.disabled = false;
hideStatus();
}
/**
* Show error message
*/
function showError(message: string) {
authError.textContent = message;
authError.style.display = 'block';
}
/**
* Hide error message
*/
function hideError() {
authError.style.display = 'none';
}
/**
* Show status message
*/
function showStatus(message: string, type: 'uploading' | 'success' | 'error') {
statusMessage.textContent = message;
statusMessage.className = `status-message ${type}`;
statusMessage.style.display = 'block';
}
/**
* Hide status message
*/
function hideStatus() {
statusMessage.style.display = 'none';
}
/**
* Format file size
*/
function formatFileSize(bytes: number): string {
if (bytes < 1024) {
return `${bytes} B`;
} else if (bytes < 1024 * 1024) {
return `${(bytes / 1024).toFixed(1)} KB`;
} else {
return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
}
}
/**
* Format timestamp
*/
function formatTimestamp(timestamp: number): string {
const now = Date.now();
const diff = now - timestamp;
if (diff < 60 * 1000) {
return 'Just now';
} else if (diff < 60 * 60 * 1000) {
const minutes = Math.floor(diff / (60 * 1000));
return `${minutes} minute${minutes > 1 ? 's' : ''} ago`;
} else if (diff < 24 * 60 * 60 * 1000) {
const hours = Math.floor(diff / (60 * 60 * 1000));
return `${hours} hour${hours > 1 ? 's' : ''} ago`;
} else {
return new Date(timestamp).toLocaleDateString();
}
}
// Initialize on load
init();