binect-chrome/TESTING_PDF_VIEWER.md

Testing PDF Sending from Chrome's Integrated PDF Viewer

This guide explains how to test the new PDF viewer integration that allows sending PDFs directly from Chrome's built-in PDF viewer to the Binect API.

What Changed

The extension now detects PDFs in two ways:

1. PDF Downloads (Original) - Detects when you download a PDF file
2. PDF Viewer (New) - Detects when you're viewing a PDF in Chrome's integrated viewer

The popup will prioritize showing PDFs from the current tab viewer over previously downloaded PDFs.

Testing the PDF Viewer Integration

Setup

1. Reload the Extension

   chrome://extensions/ → Find BinectChrome → Click reload icon
   

2. Check Permissions

   • The extension now requires activeTab and <all_urls> permissions
   • Chrome will ask you to approve these new permissions
   • Click "Allow" when prompted

Test Scenario 1: Open a PDF in a New Tab

Steps:

1. Find any PDF URL on the web (examples below)
2. Right-click the PDF link → "Open link in new tab"
3. Chrome will open the PDF in its integrated viewer
4. Click the BinectChrome extension icon
5. The popup should show the PDF details with "Send PDF to Binect" button

Test PDF URLs:

https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf
https://www.adobe.com/support/products/enterprise/knowledgecenter/media/c4611_sample_explain.pdf
https://www.africau.edu/images/default/sample.pdf

Expected Results:

• PDF filename extracted from URL or tab title
• Domain shows the source domain
• Size shows "Size unknown" (normal for viewed PDFs)
• Timestamp shows "Just now"
• "Send PDF to Binect" button is active

Test Scenario 2: Navigate Directly to a PDF URL

Steps:

1. Copy a PDF URL (use test URLs above)
2. Paste it into Chrome's address bar and press Enter
3. Chrome loads the PDF in the viewer
4. Click the BinectChrome extension icon
5. The popup should detect and show the PDF

Expected Results:

• Same as Scenario 1

Test Scenario 3: View PDF from Google Drive / Cloud Storage

Steps:

1. Go to Google Drive, Dropbox, or any cloud storage
2. Click on a PDF file to view it
3. Wait for the PDF to load in the viewer
4. Click the BinectChrome extension icon

Expected Results:

• Extension detects the PDF
• Domain shows the cloud provider's domain
• File can be sent to Binect

Note: Some cloud providers use blob URLs or viewer applications that may not be directly detected. If this happens, download the PDF instead (it will be detected via download detection).

Test Scenario 4: Send PDF to Binect API

Steps:

1. Open a PDF in Chrome's viewer (use Scenario 1 or 2)
2. Click the BinectChrome extension icon
3. If not signed in:
   • Enter your Binect credentials
   • Click "Sign In"
4. Once authenticated, the PDF should be shown
5. Click "Send PDF to Binect"

Expected Results:

• Status shows "Uploading..."
• After successful upload: "Success! Document ID: [id]"
• Tracking entry is created with the transfer details
• After 3 seconds, the popup clears

Expected Errors (if testing with invalid credentials):

• Authentication errors show in red
• Network errors are displayed
• Failed transfers are tracked with error messages

API Integration Testing

Test with Real Binect API

If you have Binect API credentials:

1. Sign in with valid credentials
2. Open a test PDF
3. Send it to Binect
4. Check the tracking info (click "?" button) to see the transfer log
5. Verify the document appears in your Binect account

Test with Invalid Credentials

1. Sign in with invalid credentials
2. Should show "Invalid credentials" error
3. Extension should return to login screen

Test with Network Errors

1. Disconnect from internet
2. Try to authenticate or send PDF
3. Should show "Network error" message

Test Session Expiry

1. Sign in successfully
2. Wait for token to expire (or manipulate storage to simulate)
3. Try to send PDF
4. Should show "Session expired. Please sign in again."
5. Should automatically log out after 2 seconds

Debugging Tips

Check Console Logs

Popup Console:

1. Click extension icon to open popup
2. Right-click inside popup → "Inspect"
3. Check console for errors or debug messages

Background Service Worker Console:

1. Go to chrome://extensions/
2. Find BinectChrome
3. Click "service worker" link
4. Check console for detection logs

Common Issues

Issue: PDF not detected

• Solution 1: The URL might not end with .pdf - this is normal for some cloud services
• Solution 2: Try refreshing the PDF tab
• Solution 3: Download the PDF instead (download detection should work)

Issue: "Failed to fetch PDF: 403 Forbidden"

• Cause: The PDF URL requires authentication/cookies that the extension can't access
• Solution: Download the PDF instead

Issue: "Failed to fetch PDF: CORS error"

• Cause: The server doesn't allow cross-origin requests
• Solution: Download the PDF instead

Issue: Extension shows "No PDF detected"

• Check: Is the current tab actually showing a PDF?
• Check: Does the URL end with .pdf or contain PDF indicators?
• Try: Download the PDF to test the download detection

Verifying API Requests

Using Chrome DevTools Network Tab

1. Open popup with DevTools open (right-click → Inspect)
2. Go to Network tab
3. Send a PDF
4. Look for requests to https://api.binect.de/
5. Check request details:
   • POST /auth/login - Authentication request
   • POST /documents/upload - PDF upload request

Authentication Request:

POST https://api.binect.de/auth/login
Content-Type: application/json

{
  "username": "your-username",
  "password": "your-password"
}

Upload Request:

POST https://api.binect.de/documents/upload
Authorization: Bearer [token]
Content-Type: multipart/form-data

[PDF file data]

Expected API Responses

Successful Authentication:

{
  "token": "eyJhbGc...",
  "expiresAt": "2024-01-15T12:00:00Z"
}

Successful Upload:

{
  "documentId": "doc_abc123",
  "status": "uploaded",
  "uploadedAt": "2024-01-14T12:00:00Z"
}

Authentication Error (401):

{
  "error": "Invalid credentials"
}

Upload Error (400):

{
  "error": "Invalid file format"
}

Tracking Data

After sending PDFs, check the tracking data:

1. Click the "?" button in the extension popup
2. Opens tracking page
3. Shows list of all transfer attempts
4. Includes:
   • Timestamp
   • Source domain
   • PDF size
   • Result (success/failure)
   • Error message (if failed)

Comparison: Download Detection vs. Viewer Detection

Feature	Download Detection	PDF Viewer Detection
Trigger	PDF file download completes	User opens PDF in browser
File Size	Known (from download)	Unknown (estimated after fetch)
Reliability	High	Depends on URL format
Use Case	Downloading PDFs from web	Viewing PDFs directly in browser
Badge	Shows "1" after download	No badge (on-demand)

Next Steps

Once you've verified the PDF viewer integration works:

1. Test with various PDF sources (Google Drive, Dropbox, direct links)
2. Verify all error cases are handled gracefully
3. Check that tracking data is accurate
4. Test the download detection still works alongside viewer detection
5. Consider edge cases:
   • Very large PDFs (10MB+)
   • PDFs with special characters in filename
   • PDFs from authenticated sources
   • PDFs from blob URLs

Known Limitations

1. Blob URLs: Some web apps create temporary blob URLs that can't be re-fetched
   • Workaround: Download the PDF instead
2. Authenticated PDFs: PDFs behind login walls may not be accessible
   • Workaround: Download the PDF instead
3. Embedded PDFs: PDFs embedded in iframes may not be detected
   • Workaround: Open the PDF in a new tab or download it
4. Size Unknown: PDF size is not known until fetch, so tracking may show 0 initially
   • Note: Actual size is recorded after successful upload

Support

If you encounter issues:

1. Check the console logs (popup and service worker)
2. Verify the PDF URL format
3. Try downloading the PDF as an alternative
4. Report issues to bernd.worsch@binect.de with:
   • PDF URL (if public)
   • Error message
   • Console logs
   • Tracking data export