\"\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",[],[200],{"_104":439,"_96":440,"_157":441,"_159":-5,"_160":142,"_161":418,"_163":119,"_106":442,"_101":32,"_165":179,"_167":443,"_168":22,"_169":-5,"_170":444,"_99":445},"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}",[],[440],{"_104":447,"_96":448,"_157":449,"_159":-5,"_160":142,"_161":178,"_163":119,"_106":450,"_101":32,"_165":211,"_167":73,"_168":22,"_169":-5,"_170":451,"_99":452},"d84daf7c-4a12-11f0-8741-76b3cceeab13","main.tsx","d84db026-4a12-11f0-8741-76b3cceeab13",["D",1750010524725],[],[448],{"_104":454,"_96":455,"_157":456,"_159":-5,"_160":142,"_161":270,"_163":119,"_106":457,"_101":178,"_165":179,"_167":458,"_168":22,"_169":-5,"_170":459,"_99":460},"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",[],[455],{"_104":462,"_96":463,"_157":464,"_159":-5,"_160":142,"_161":465,"_163":119,"_106":466,"_101":32,"_165":179,"_167":467,"_168":22,"_169":-5,"_170":468,"_99":469},"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",[],[463],"files",[154,172,184,191,198,206,215,223,231,241,248,257,266,273,281,289,299,305,314,320,329,337,347,353,362,369,379,388,399,405,414,423,431,438,446,453,461],"counts",{"_474":32,"_475":188,"_476":32,"_477":478},"pulls","branches","forks","envVars",{"_479":480,"_481":32},"count",7,"emptyCount","contents",[484],{"_104":306,"_96":307,"_157":308,"_159":302,"_160":142,"_161":176,"_163":119,"_106":485,"_101":32,"_165":211,"_167":310,"_168":22,"_169":-5,"_99":486},["D",1758484581786],[186,301,307],{"_104":300,"_96":301,"_157":302,"_159":187,"_160":142,"_161":176,"_163":119,"_106":488,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_99":489},["D",1758484581786],[186,301],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.code.$",{"_94":95,"_96":97,"_98":44,"_101":-7,"_99":100,"_102":498,"_152":503,"_470":615,"_179":616,"_482":618,"_621":-5,"_622":-5,"_623":-5,"_624":-5,"_625":626},{"_104":105,"_96":97,"_106":499,"_108":-5,"_109":22,"_110":111,"_112":113,"_114":-5,"_14":115,"_116":117,"_118":119,"_120":119,"_121":-5,"_122":32,"_16":123,"_124":125,"_126":125,"_127":128,"_129":128,"_130":128,"_131":125,"_132":125,"_23":500,"_136":501,"_139":502,"_151":22},["D",1750010524712],{"_94":95,"_134":135},{"_94":95,"_138":135,"_14":115},{"_101":141,"_96":44,"_104":142,"_143":105,"_144":-5,"_145":-5,"_146":-5,"_147":-5,"_148":-5,"_149":97,"_150":95},[504,510,570,576,588,594,597,600,603,606,609,612],{"_104":155,"_96":156,"_157":158,"_159":-5,"_160":142,"_161":162,"_163":119,"_106":164,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":505,"_99":509},[506],{"_104":173,"_96":174,"_157":175,"_159":158,"_160":142,"_161":176,"_163":119,"_106":177,"_101":178,"_165":179,"_167":180,"_168":22,"_169":-5,"_170":507,"_99":508},[],[156,174],[156],{"_104":185,"_96":186,"_157":187,"_159":-5,"_160":142,"_161":188,"_163":119,"_106":189,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":511,"_99":569},[512,530,539,551,557,563,566],{"_104":192,"_96":193,"_157":194,"_159":187,"_160":142,"_161":195,"_163":119,"_106":196,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":513,"_99":529},[514,517,520,523,526],{"_104":199,"_96":200,"_157":201,"_159":194,"_160":142,"_161":176,"_163":119,"_106":202,"_101":178,"_165":179,"_167":203,"_168":22,"_169":-5,"_170":515,"_99":516},[],[186,193,200],{"_104":207,"_96":208,"_157":209,"_159":194,"_160":142,"_161":176,"_163":119,"_106":210,"_101":32,"_165":211,"_167":212,"_168":22,"_169":-5,"_170":518,"_99":519},[],[186,193,208],{"_104":216,"_96":217,"_157":218,"_159":194,"_160":142,"_161":176,"_163":119,"_106":219,"_101":32,"_165":211,"_167":220,"_168":22,"_169":-5,"_170":521,"_99":522},[],[186,193,217],{"_104":224,"_96":225,"_157":226,"_159":194,"_160":142,"_161":176,"_163":119,"_106":227,"_101":32,"_165":211,"_167":228,"_168":22,"_169":-5,"_170":524,"_99":525},[],[186,193,225],{"_104":232,"_96":233,"_157":234,"_159":194,"_160":142,"_161":176,"_163":119,"_106":235,"_101":236,"_165":211,"_167":237,"_168":22,"_169":-5,"_170":527,"_99":528},[],[186,193,233],[186,193],{"_104":242,"_96":243,"_157":244,"_159":187,"_160":142,"_161":245,"_163":119,"_106":246,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":531,"_99":538},[532,535],{"_104":249,"_96":250,"_157":251,"_159":244,"_160":142,"_161":176,"_163":119,"_106":252,"_101":253,"_165":211,"_167":254,"_168":22,"_169":-5,"_170":533,"_99":534},[],[186,243,250],{"_104":258,"_96":233,"_157":259,"_159":244,"_160":142,"_161":176,"_163":119,"_106":260,"_101":261,"_165":211,"_167":262,"_168":22,"_169":-5,"_170":536,"_99":537},[],[186,243,233],[186,243],{"_104":267,"_96":268,"_157":269,"_159":187,"_160":142,"_161":270,"_163":119,"_106":271,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":540,"_99":550},[541,544,547],{"_104":274,"_96":275,"_157":276,"_159":269,"_160":142,"_161":270,"_163":119,"_106":277,"_101":32,"_165":211,"_167":278,"_168":22,"_169":-5,"_170":542,"_99":543},[],[186,268,275],{"_104":282,"_96":283,"_157":284,"_159":269,"_160":142,"_161":270,"_163":119,"_106":285,"_101":32,"_165":211,"_167":286,"_168":22,"_169":-5,"_170":545,"_99":546},[],[186,268,283],{"_104":290,"_96":291,"_157":292,"_159":269,"_160":142,"_161":293,"_163":119,"_106":294,"_101":32,"_165":211,"_167":295,"_168":22,"_169":-5,"_170":548,"_99":549},[],[186,268,291],[186,268],{"_104":300,"_96":301,"_157":302,"_159":187,"_160":142,"_161":176,"_163":119,"_106":303,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":552,"_99":556},[553],{"_104":306,"_96":307,"_157":308,"_159":302,"_160":142,"_161":176,"_163":119,"_106":309,"_101":32,"_165":211,"_167":310,"_168":22,"_169":-5,"_170":554,"_99":555},[],[186,301,307],[186,301],{"_104":315,"_96":316,"_157":317,"_159":187,"_160":142,"_161":293,"_163":119,"_106":318,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":558,"_99":562},[559],{"_104":321,"_96":322,"_157":323,"_159":317,"_160":142,"_161":293,"_163":119,"_106":324,"_101":32,"_165":211,"_167":325,"_168":22,"_169":-5,"_170":560,"_99":561},[],[186,316,322],[186,316],{"_104":330,"_96":200,"_157":331,"_159":187,"_160":142,"_161":293,"_163":119,"_106":332,"_101":333,"_165":179,"_167":334,"_168":22,"_169":-5,"_170":564,"_99":565},[],[186,200],{"_104":338,"_96":339,"_157":117,"_159":187,"_160":142,"_161":141,"_163":119,"_106":340,"_101":341,"_165":342,"_167":343,"_168":22,"_169":-5,"_170":567,"_99":568},[],[186,339],[186],{"_104":348,"_96":349,"_157":350,"_159":-5,"_160":142,"_161":176,"_163":119,"_106":351,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":571,"_99":575},[572],{"_104":354,"_96":355,"_157":356,"_159":350,"_160":142,"_161":176,"_163":119,"_106":357,"_101":32,"_165":179,"_167":358,"_168":22,"_169":-5,"_170":573,"_99":574},[],[349,355],[349],{"_104":363,"_96":364,"_157":365,"_159":-5,"_160":142,"_161":366,"_163":119,"_106":367,"_101":178,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":577,"_99":587},[578,581,584],{"_104":370,"_96":371,"_157":372,"_159":365,"_160":142,"_161":373,"_163":119,"_106":374,"_101":195,"_165":375,"_167":376,"_168":22,"_169":-5,"_170":579,"_99":580},[],[364,371],{"_104":380,"_96":381,"_157":382,"_159":365,"_160":142,"_161":383,"_163":119,"_106":384,"_101":253,"_165":342,"_167":385,"_168":22,"_169":-5,"_170":582,"_99":583},[],[364,381],{"_104":389,"_96":390,"_157":391,"_159":365,"_160":142,"_161":392,"_163":119,"_106":393,"_101":394,"_165":342,"_167":395,"_168":22,"_169":-5,"_170":585,"_99":586},[],[364,390],[364],{"_104":400,"_96":401,"_157":402,"_159":-5,"_160":142,"_161":176,"_163":119,"_106":403,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_170":589,"_99":593},[590],{"_104":406,"_96":407,"_157":408,"_159":402,"_160":142,"_161":176,"_163":119,"_106":409,"_101":32,"_165":211,"_167":410,"_168":22,"_169":-5,"_170":591,"_99":592},[],[401,407],[401],{"_104":415,"_96":416,"_157":417,"_159":-5,"_160":142,"_161":418,"_163":119,"_106":419,"_101":32,"_165":179,"_167":420,"_168":22,"_169":-5,"_170":595,"_99":596},[],[416],{"_104":424,"_96":425,"_157":426,"_159":-5,"_160":142,"_161":176,"_163":119,"_106":427,"_101":32,"_165":179,"_167":428,"_168":22,"_169":-5,"_170":598,"_99":599},[],[425],{"_104":432,"_96":200,"_157":433,"_159":-5,"_160":142,"_161":293,"_163":119,"_106":434,"_101":245,"_165":179,"_167":435,"_168":22,"_169":-5,"_170":601,"_99":602},[],[200],{"_104":439,"_96":440,"_157":441,"_159":-5,"_160":142,"_161":418,"_163":119,"_106":442,"_101":32,"_165":179,"_167":443,"_168":22,"_169":-5,"_170":604,"_99":605},[],[440],{"_104":447,"_96":448,"_157":449,"_159":-5,"_160":142,"_161":178,"_163":119,"_106":450,"_101":32,"_165":211,"_167":73,"_168":22,"_169":-5,"_170":607,"_99":608},[],[448],{"_104":454,"_96":455,"_157":456,"_159":-5,"_160":142,"_161":270,"_163":119,"_106":457,"_101":178,"_165":179,"_167":458,"_168":22,"_169":-5,"_170":610,"_99":611},[],[455],{"_104":462,"_96":463,"_157":464,"_159":-5,"_160":142,"_161":465,"_163":119,"_106":466,"_101":32,"_165":179,"_167":467,"_168":22,"_169":-5,"_170":613,"_99":614},[],[463],[504,506,510,512,514,517,520,523,526,530,532,535,539,541,544,547,551,553,557,559,563,566,570,572,576,578,581,584,588,590,594,597,600,603,606,609,612],{"_104":300,"_96":301,"_157":302,"_159":187,"_160":142,"_161":176,"_163":119,"_106":488,"_101":32,"_165":166,"_167":-5,"_168":22,"_169":-5,"_99":617},[186,301],[619],{"_104":306,"_96":307,"_157":308,"_159":302,"_160":142,"_161":176,"_163":119,"_106":485,"_101":32,"_165":211,"_167":310,"_168":22,"_169":-5,"_99":620},[186,301,307],"upstream","pull","ahead","behind","templates",[],"actionData","errors"]

tr3ntg

readback-api