Skip to main content
The TypeScript SDK is available from the repository path. It is not published to npm yet. In a checkout containing sdk/ and shared/, install it with npm install ./sdk and use a TypeScript-capable runtime or bundler. Create a token in the app with the scopes your calls need. This fictional example needs courses:write to import and courses:read to list:
All methods are typed from the API contract. Methods that require an input take it first; every method accepts optional { signal, idempotencyKey } call options. The SDK sends Idempotency-Key on POST requests and retries a 429 once after the server’s Retry-After delay, capped at ten seconds. An API failure throws TesseraError with code, message, details, HTTP status, and requestId from X-Request-Id. Upload a file as multipart data with await api.uploadFile(courseId, blob, 'handout.pdf'). The helper returns a file record. api.fileUrl(fileId) returns the original content URL; api.fileUrl(fileId, 'reading') returns the URL for an accessible format. Fetch those URLs with the same bearer token.