Patreon-api.ts

Typescript oauth library for the V2 Patreon API with:

• Support for Creator access tokens and oauth tokens
• Client with methods for calling every endpoint, both resource and webhook endpoints
• Methods to create a webhook server
• Typescript types that strongly reflect your query for raw or simplified responses

const query = QueryBuilder.campaign
    .setAttributes({ campaign: ['patron_count'] })

const payload = await client.fetchCampaign('campaign_id', query)
    // ^? { data: { attributes: { patron_count: number } }, ... }
const campaign = await client.simplified.fetchCampaign('campaign_id', query)
    // ^? { patronCount: number, id: string, type: Type.Campaign }

Installation

npm install patreon-api.ts
pnpm add patreon-api.ts
yarn add patreon-api.ts

Usage

The default API version for this package is 2 and might change in major versions.

[!CAUTION] This package does not include v1 of the Patreon API and starts with API v2. The sections in the Patreon documentation are prefixed by APIv2:. The Oauth flow, introduction and sections below sorting are related to all versions.

When the default API version is changed, old versions will still receive updates. You can not import this module by API version since it is unlikely that Patreon will release a new version any time soon.

To read more about how to use this library, go to the documentation. Still doubting if this library has everything you need related to the Patreon API? Compare all libraries yourself.

To check for compatibility with this package, look if your platform:

• has the globals: AbortController, setTimeout, clearTimeout, setInterval, clearInterval, Request, fetch, URL and URLSearchParams
  • for node.js: v22 or higher
  • for Cloudflare workers: enable Node.js
• supports ES2020
• supports the node:crypto module: createHmac and randomUUID

OpenAPI schema

This library is used to create the Patreon OpenAPI schemas for the patreon-api-spec repository.

Examples

• Commonly used routes and community apps
• Example webhook server: Cloudflare worker and express.js server
• Example Node.js server: ESM and CJS

Changelog

Detailed changes are listed for each release in the changelog.

For upcoming releases, see the roadmap for planned changes.

Contributing

See the code of conduct and the contributing guide for how to contribute. You can also support the development by writing guides, posts and templates or by funding the maintainers.

Do you have a question about using this library? Open a Q&A discussion on GitHub.

License

MIT

Copyright (c) 2023-present, ghostrider-05