makenotion/notion-sdk-js

This is the official JavaScript and TypeScript client library for the Notion API, published by Notion itself. It lets developers write code that talks to a Notion workspace: reading pages and databases, creating or updating content, querying filtered lists of records, and managing users or comments, all from a Node.js application or any JavaScript environment. Installing the package takes a single command, and the setup is straightforward. You provide an authentication token, which Notion calls an integration token, and the client handles the rest of the connection. Every Notion API endpoint is available as a method on the client object, with all the parameters (whether they normally go in the URL, the query string, or the request body) grouped into one plain object so you do not have to track where each one belongs. The library handles several common problems automatically. If Notion's servers are temporarily overloaded or return a rate-limit response telling the client to slow down, the SDK will wait and retry the request on its own, using progressively longer delays between attempts. You can configure how many retries to allow, how long to wait between them, or turn the behavior off entirely. Error handling is structured so that specific failure codes (like a database not being found, or a token not having permission to access something) can be caught and handled distinctly in your code. For debugging, the client can log the details of every request and response to the console or to a custom logging function of your choosing. Configuration options include setting a request timeout, pointing the client at a mock server for testing, and routing traffic through an HTTP proxy. The package is written in TypeScript and ships with type definitions, so editors with type-checking support will show autocomplete suggestions and catch mismatched parameters before the code runs. It is published on npm under the name @notionhq/client.