\"\n}\n```\n\n```json\n{\n \"error\": \"PDF processing error: Document processing timed out\",\n \"code\": \"timeout-error\"\n}\n```\n\n```json\n{\n \"error\": \"Failed to fetch URL: 404 Not Found\"\n}\n```\n\n```json\n{\n \"error\": \"Invalid URL format\"\n}\n```\n\n**Text Processing:**\n- Removes excessive whitespace and formatting artifacts\n- Strips common header/footer patterns and page numbers\n- Optimizes text flow for natural TTS reading\n- Handles complex document structures (tables, lists, etc.)\n- For URLs: Extracts main article content using reader view algorithms\n- For Markdown: Converts to plain text while preserving readability\n- For PDFs: Uses AI when needed to handle complex layouts and maintain reading order\n\n### GET /api/usage\n\nGet usage statistics for the authenticated customer. Response includes legacy top-level fields for compatibility plus new `credits` field.\n\n**Plus/Pro User Response:**\n```json\n{\n \"user_tier\": \"premium\",\n \"monthly_limit\": 900000,\n \"current_usage\": 150000,\n \"remaining_characters\": 750000,\n \"usage_percentage\": 17,\n \"reset_date\": \"2024-02-01T00:00:00.000Z\",\n \"plan_key\": \"plus\",\n \"credits\": {\n \"subscription\": {\n \"plan_key\": \"plus\",\n \"monthly_limit\": 900000,\n \"current_usage\": 150000,\n \"remaining_characters\": 750000,\n \"usage_percentage\": 17,\n \"reset_date\": \"2024-02-01T00:00:00.000Z\"\n },\n \"non_expiring_tokens\": {\n \"balance\": 70000,\n \"total_granted\": 95000,\n \"total_consumed\": 25000,\n \"purchases\": [\n {\n \"source\": \"free_grant\",\n \"characters\": 45000,\n \"price_usd\": 0\n },\n {\n \"source\": \"iap\",\n \"product_lookup_key\": \"credit_pack_1hr\",\n \"characters\": 25000,\n \"price_usd\": 2.99\n }\n ]\n }\n }\n}\n```\n\n**Free User Response:**\n```json\n{\n \"user_tier\": \"free\",\n \"lifetime_limit\": 45000,\n \"current_usage\": 5000,\n \"remaining_characters\": 40000,\n \"usage_percentage\": 11,\n \"message\": \"Subscribe for monthly credits or purchase additional credits.\",\n \"credits\": {\n \"subscription\": null,\n \"non_expiring_tokens\": {\n \"balance\": 40000,\n \"total_granted\": 45000,\n \"total_consumed\": 5000,\n \"purchases\": [\n {\n \"source\": \"free_grant\",\n \"characters\": 45000,\n \"price_usd\": 0\n }\n ]\n }\n }\n}\n```\n\n**Admin User Response (no query parameter):**\n```json\n{\n \"message\": \"Admin users have unlimited usage\",\n \"is_admin\": true\n}\n```\n\n**Admin Query Parameter:**\n```\nGET /api/usage?customer_id=specific_customer_id\n```\nAllows admins to check usage for any specific customer ID.\n\n### GET /health\n\nHealth check endpoint that returns the service status.\n\n**Response:**\n```json\n{\n \"status\": \"ok\",\n \"timestamp\": \"2024-01-01T00:00:00.000Z\"\n}\n```\n\n### POST /revenuecat/webhook\n\nWebhook endpoint for RevenueCat to notify about purchases and refunds.\n\n**Headers:**\n- `Authorization: {REVENUECAT_WEBHOOK_AUTH}` (must match environment variable)\n\n**Handled Events:**\n- `NON_RENEWING_PURCHASE` - Grants credits for credit pack purchases\n- `REFUND` - Deducts credits for refunded purchases\n\n**Response:**\n```json\n{\n \"success\": true\n}\n```\n\n### GET /\n\nRoot endpoint that provides basic API information.\n\n**Response:**\n```json\n{\n \"message\": \"Text Extraction API\",\n \"version\": \"1.0.0\",\n \"endpoints\": {\n \"health\": \"/health\",\n \"speech\": \"/api/speech\",\n \"extractText\": \"/api/extract-text\",\n \"usage\": \"/api/usage\"\n },\n \"supportedFileTypes\": [\"txt\", \"rtf\", \"docx\", \"md\", \"pdf\"],\n \"timestamp\": \"2024-01-01T00:00:00.000Z\"\n}\n```\n\n## Database Schema\n\nThe system uses SQLite with multiple tables for comprehensive tracking:\n\n### Table: `customer_usage_v1`\nTracks all usage (both subscription and non-expiring):\n- `id` - Auto-incrementing primary key\n- `customer_id` - Customer identifier from RevenueCat\n- `character_count` - Number of characters in the request\n- `request_timestamp` - ISO timestamp of the request\n- `created_at` - Database insertion timestamp\n\n### Table: `credit_grants_v1`\nLedger of all credit additions:\n- `id` - Auto-incrementing primary key\n- `customer_id` - Customer identifier\n- `source` - Type of grant (free_grant, iap, admin, refund)\n- `product_lookup_key` - RevenueCat product ID for purchases\n- `revenuecat_tx_id` - Transaction ID for idempotency\n- `characters_granted` - Number of characters granted (negative for refunds)\n- `price_usd` - Price paid for the credits\n- `granted_at` - Timestamp of grant\n\n### Table: `credit_debits_v1`\nLedger of non-expiring credit consumption:\n- `id` - Auto-incrementing primary key\n- `customer_id` - Customer identifier\n- `usage_id` - Foreign key to customer_usage_v1\n- `characters_consumed` - Number of non-expiring characters used\n- `consumed_at` - Timestamp of consumption\n\n## Configuration\n\nThe API automatically configures:\n- `response_format`: Always set to \"mp3\"\n- `word_timestamps`: Always set to true\n\nOnly `voice` and `input` parameters need to be provided by the client.\n\n## External Services\n\n### PDFVector API\n- Used for PDF text extraction\n- Pricing: 1-2 credits per page depending on AI usage\n- AI Enhancement: Automatically enabled for complex layouts\n- Timeout: 3 minutes maximum per document\n- Supported formats: PDF and Word documents\n\n## Error Codes\n\n- `400` - Bad Request (missing required fields, invalid file type)\n- `401` - Unauthorized (missing/invalid auth header)\n- `403` - Forbidden (no active subscription)\n- `429` - Too Many Requests (monthly limit exceeded)\n- `500` - Internal Server Error\n\n## Dependencies\n\n- `hono` - Web framework\n- `mammoth` - DOCX text extraction\n- `rtf-parser` - RTF text extraction\n- `remove-markdown` - Markdown to plain text conversion\n- `pdfvector` - PDF text extraction via API\n- `@extractus/article-extractor` - Web page content extraction\n",[],[199],{"_103":438,"_96":439,"_156":440,"_158":-5,"_159":141,"_160":417,"_162":118,"_105":441,"_100":32,"_164":178,"_166":442,"_167":22,"_168":-5,"_169":443,"_99":444},"147a2a58-72e9-11f0-a843-0224a6c84d84","deno.json","147a2ad0-72e9-11f0-a843-0224a6c84d84",["D",1754500584486],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\n \"https://www.val.town/types/valtown.d.ts\"\n ],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"files\": {\n \"include\": [\n \"deno:/https/esm.town/**/*\"\n ]\n },\n \"rules\": {\n \"exclude\": [\n \"no-explicit-any\"\n ]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[],[439],{"_103":446,"_96":447,"_156":448,"_158":-5,"_159":141,"_160":177,"_162":118,"_105":449,"_100":32,"_164":210,"_166":73,"_167":22,"_168":-5,"_169":450,"_99":451},"d84daf7c-4a12-11f0-8741-76b3cceeab13","main.tsx","d84db026-4a12-11f0-8741-76b3cceeab13",["D",1750010524725],[],[447],{"_103":453,"_96":454,"_156":455,"_158":-5,"_159":141,"_160":269,"_162":118,"_105":456,"_100":177,"_164":178,"_166":457,"_167":22,"_168":-5,"_169":458,"_99":459},"8c0ca422-b7e2-11f0-9bff-0224a6c84d84","test-upload.html","60b4e410-4aa0-11f0-bd2f-76b3cceeab13",["D",1762084408836],"\n\n\n Test Document Upload\n\n\n

Test Document Text Extraction

\n \n \n \n

\n \n \n\n\n",[],[454],{"_103":461,"_96":462,"_156":463,"_158":-5,"_159":141,"_160":464,"_162":118,"_105":465,"_100":32,"_164":178,"_166":466,"_167":22,"_168":-5,"_169":467,"_99":468},"c31e33ca-54de-11f0-986d-f69ea79377d9","test-url-extraction.html","c31e3474-54de-11f0-986d-f69ea79377d9",73,["D",1751197618141],"\n\n\n \n \n URL Text Extraction Test\n \n\n\n

URL Text Extraction Test

Test the new URL-based text extraction functionality of the /api/extract-text endpoint.

\n \n \n \n

\n\n \n\n",[],[462],"files",[153,171,183,190,197,205,214,222,230,240,247,256,265,272,280,288,298,304,313,319,328,336,346,352,361,368,378,387,398,404,413,422,430,437,445,452,460],"counts",{"_473":32,"_474":187,"_475":32,"_476":477},"pulls","branches","forks","envVars",{"_478":479,"_480":32},"count",7,"emptyCount","contents",[483,486,489,492,495,498,501,504,507,510,513,516],{"_103":154,"_96":155,"_156":157,"_158":-5,"_159":141,"_160":161,"_162":118,"_105":484,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_99":485},["D",1755951597953],[155],{"_103":184,"_96":185,"_156":186,"_158":-5,"_159":141,"_160":187,"_162":118,"_105":487,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_99":488},["D",1750015912808],[185],{"_103":347,"_96":348,"_156":349,"_158":-5,"_159":141,"_160":175,"_162":118,"_105":490,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_99":491},["D",1758484581786],[348],{"_103":362,"_96":363,"_156":364,"_158":-5,"_159":141,"_160":365,"_162":118,"_105":493,"_100":177,"_164":165,"_166":-5,"_167":22,"_168":-5,"_99":494},["D",1752092718604],[363],{"_103":399,"_96":400,"_156":401,"_158":-5,"_159":141,"_160":175,"_162":118,"_105":496,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_99":497},["D",1758484581786],[400],{"_103":414,"_96":415,"_156":416,"_158":-5,"_159":141,"_160":417,"_162":118,"_105":499,"_100":32,"_164":178,"_166":419,"_167":22,"_168":-5,"_99":500},["D",1754500584486],[415],{"_103":423,"_96":424,"_156":425,"_158":-5,"_159":141,"_160":175,"_162":118,"_105":502,"_100":32,"_164":178,"_166":427,"_167":22,"_168":-5,"_99":503},["D",1758484581786],[424],{"_103":431,"_96":199,"_156":432,"_158":-5,"_159":141,"_160":292,"_162":118,"_105":505,"_100":244,"_164":178,"_166":434,"_167":22,"_168":-5,"_99":506},["D",1762602165335],[199],{"_103":438,"_96":439,"_156":440,"_158":-5,"_159":141,"_160":417,"_162":118,"_105":508,"_100":32,"_164":178,"_166":442,"_167":22,"_168":-5,"_99":509},["D",1754500584486],[439],{"_103":446,"_96":447,"_156":448,"_158":-5,"_159":141,"_160":177,"_162":118,"_105":511,"_100":32,"_164":210,"_166":73,"_167":22,"_168":-5,"_99":512},["D",1750010524725],[447],{"_103":453,"_96":454,"_156":455,"_158":-5,"_159":141,"_160":269,"_162":118,"_105":514,"_100":177,"_164":178,"_166":457,"_167":22,"_168":-5,"_99":515},["D",1762084408836],[454],{"_103":461,"_96":462,"_156":463,"_158":-5,"_159":141,"_160":464,"_162":118,"_105":517,"_100":32,"_164":178,"_166":466,"_167":22,"_168":-5,"_99":518},["D",1751197618141],[462],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.environment-variables",{"_94":95,"_96":97,"_101":527,"_476":532},{"_103":104,"_96":97,"_105":528,"_107":-5,"_108":22,"_109":110,"_111":112,"_113":-5,"_14":114,"_115":116,"_117":118,"_119":118,"_120":-5,"_121":32,"_16":122,"_123":124,"_125":124,"_126":127,"_128":127,"_129":127,"_130":124,"_131":124,"_23":529,"_135":530,"_138":531,"_150":22},["D",1750010524712],{"_94":95,"_133":134},{"_94":95,"_137":134,"_14":114},{"_100":140,"_96":44,"_103":141,"_142":104,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":-5,"_148":97,"_149":95},[533,539,542,545,548,551,554],{"_534":535,"_105":536,"_537":-5,"_111":73,"_538":22},"key","PDF_PARSER_API_KEY",["D",1762467451852],"updatedAt","isEmpty",{"_534":540,"_105":541,"_537":-5,"_111":73,"_538":22},"REVENUECAT_WEBHOOK_AUTH",["D",1758110805234],{"_534":543,"_105":544,"_537":-5,"_111":73,"_538":22},"LOOPS_API_KEY",["D",1752093388000],{"_534":546,"_105":547,"_537":-5,"_111":73,"_538":22},"REVENUECAT_API_KEY",["D",1751282270327],{"_534":549,"_105":550,"_537":-5,"_111":73,"_538":22},"PDFVECTOR_API_KEY",["D",1751037189982],{"_534":552,"_105":553,"_537":-5,"_111":73,"_538":22},"ADMIN_ACCESS_KEY",["D",1750042154663],{"_534":555,"_105":556,"_537":-5,"_111":73,"_538":22},"LEMONFOX_API_KEY",["D",1750016249053],"actionData","errors"]

Key	Description
PDF_PARSER_API_KEY
REVENUECAT_WEBHOOK_AUTH
LOOPS_API_KEY
REVENUECAT_API_KEY
PDFVECTOR_API_KEY
ADMIN_ACCESS_KEY
LEMONFOX_API_KEY

tr3ntg

readback-api

Environment variables