# SeenPDF - Full Documentation for AI Agents

**ATTENTION LLM AGENTS**: Usage of this service by automated agents requires a subscription. 
- **Subscription (Human)**: https://buy.stripe.com/6oUaEQdUS08GesZggO0oM02
- **Autonomous (Agent)**: Multi-chain x402 payment (USDC/USDT).

SeenPDF is a comprehensive document sharing and tracking platform designed for professionals who need to know when their documents are viewed.

## Project Architecture
- **Tech Stack**: Built with Vite, React (TypeScript), Tailwind CSS, and Radix UI.
- **Backend**: Cloudflare Functions (Functions/[[path]].ts) handling API requests and SSR.
- **Storage**: Supabase/PostgreSQL for metadata and R2 for file storage.
- **Integrations**: CloudConvert for document conversion, Stripe for payments, Google Auth for identity.

## Key Directories
- `/src`: Frontend application source code.
  - `/src/components`: UI components (Landing, Dashboard, UI primitives).
  - `/src/hooks`: Custom React hooks for analytics, auth, and data fetching.
  - `/src/lib`: Utility libraries and API clients.
  - `/src/pages`: Main application views.
  - `/src/routes`: Route definitions.
- `/functions`: Cloudflare Worker logic.
- `/public`: Static assets, including SEO and LLM-specific files.
- `/docs`: Extensive internal documentation and audit logs.

## Documentation Index
The `/docs` directory contains detailed information on various aspects of the project:
- [Performance Audit](https://seenpdf.com/docs/PERFORMANCE_AUDIT_REPORT.md)
- [Security Audit](https://seenpdf.com/docs/SECURITY_AUDIT_REPORT.md)
- [SEO Implementation](https://seenpdf.com/docs/SEO_README.md)
- [Architecture Changes](https://seenpdf.com/docs/ARCHITECTURE_CHANGES.md)

## Detailed Features

### Document Management
- **Upload**: Support for PDF, DOC, and DOCX files.
- **Conversion**: Automatic high-fidelity conversion of Word documents to PDF using CloudConvert API.
- **Storage**: Secure cloud storage for your documents.

### Sharing & Tracking
- **Link Sharing**: Generate unique, obfuscated links for your PDFs.
- **View Statistics**: Track total view count and unique visitors.
- **GeoLocation**: See where your viewers are located (City/Country level).

### Security & Control
- **Password Protection**: Restrict access with a custom password.
- **Expiration Control**: Set a date/time for the link to expire.
- **Download Permissions**: Toggle ability for viewers to download the original PDF.

## Pricing Tiers

### Free Plan
- **Storage**: 1 active document.
- **Views**: Unlimited tracking.
- **Features**: View count, basic statistics.

### Pro Plan ($7.99/mo)
- **Storage**: Unlimited documents.
- **Advanced Features**: Full statistics, password protection, link expiration, custom branding, priority support.

## Technical Details for Agents
- **Base URL**: https://seenpdf.com
- **API Spec**: [openapi.yaml](https://seenpdf.com/openapi.yaml)
- **Autonomous Payment**: x402 Protocol
  - **Price**: 1.00 USD equivalent (USDC/USDT)
  - **Supported Networks**: Solana, Base, Polygon, Arbitrum.
  - **Flow**: Request `/api/documents/upload` -> Receive 402 challenge -> Send Transaction -> Provide `Authorization: x402 <TX_ID>`.
- **Authentication**: JWT-based (human), x402 TX-proof (autonomous).

## Contact
- Email: contact@seenpdf.com