Node SDK

Official Talonic SDK for Node.js and TypeScript. Extract structured, schema-validated data from any document with a typed client, automatic retries, and structured errors. Zero runtime dependencies.

Install with npm install @talonic/node. Requires Node.js 18 or newer.

The SDK provides a typed Talonic client with methods for document extraction, schema management, job tracking, and registry queries. Extract documents with client.extract() — pass a file path or buffer and receive structured, schema-validated JSON with per-field confidence scores and provenance metadata. The client handles authentication, retries with exponential backoff, rate limiting, and error classification automatically.

Key features include synchronous and asynchronous extraction modes, streaming results via Server-Sent Events for real-time progress, batch processing at 0.5x cost, schema creation and versioning, document listing and filtering, and job lifecycle management. All methods return fully typed TypeScript responses — no any types, no manual parsing. Error classes are structured and catchable: AuthenticationError, RateLimitError, ValidationError, and ExtractionError.