Add TypeScript types for lib

**Description**
Currently api lacks proper pagination support.

**Proposed solution**
Add configurable pagination with sensible defaults.

**Priority**: Low/Medium

Start by locating the library entry point and the API implementation referenced by the issue, then check how existing TypeScript types are organized. Confirm the intended pagination behavior and configurable defaults before changing anything. Done means the API supports pagination and the library exposes accurate TypeScript types for it.

Written by the indexing model from the issue text.