Class: PatreonUserClientInstance<IncludeAll>
Defined in: clients/v2/user.ts:8
Extends
PatreonSharedClient<"default",IncludeAll>
Type Parameters
| Type Parameter |
|---|
IncludeAll extends boolean |
Constructors
Constructor
new PatreonUserClientInstance<
IncludeAll>(client,token):PatreonUserClientInstance<IncludeAll>
Defined in: clients/v2/user.ts:12
Parameters
| Parameter | Type |
|---|---|
client | PatreonUserClient<IncludeAll> |
token | Oauth2StoredToken |
Returns
PatreonUserClientInstance<IncludeAll>
Overrides
PatreonSharedClient<'default', IncludeAll>.constructor
Properties
| Property | Modifier | Type | Description | Inherited from |
|---|---|---|---|---|
client | public | PatreonUserClient<IncludeAll> | - | - |
lives | public | WriteResourceSharedClient<Live, "default", IncludeAll, string> | Interact with the lives API routes. From the Patreon documentation:\ The Live APIs are early-access, and may be subject to change based on feedback from our partners. See https://docs.patreon.com/#post-api-oauth2-v2-lives | PatreonSharedClient.lives |
token | public readonly | Oauth2StoredToken | - | - |
Methods
fetchCampaign()
fetchCampaign<
Query>(campaignId,query?,options?):Promise<GetResponsePayload<Query>>
Defined in: clients/v2/shared.ts:300
Fetch a campaign.
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Campaign, false> | If<IncludeAll, PatreonQuery<Campaign, "benefits" | "goals" | "live_access_rules" | "tiers" | "creator", RelationshipMap<Campaign, "benefits" | "goals" | "live_access_rules" | "tiers" | "creator">, false>, PatreonQuery<Campaign, never, never, false>> |
Parameters
| Parameter | Type | Description |
|---|---|---|
campaignId | string | The id of the campaign to return. |
query? | Query | The query for requesting relationships and attributes |
options? | Oauth2RouteOptions | The request options. Allows for authentication (token) and fetch options. |
Returns
Promise<GetResponsePayload<Query>>
The API response for the route. If using a (client) response parser, the response will be transformed.
See
https://docs.patreon.com/#get-api-oauth2-v2-campaigns-campaign_id
Requires
campaigns scope.
Inherited from
PatreonSharedClient.fetchCampaign
fetchCampaignMembers()
fetchCampaignMembers<
Query>(campaignId,query?,options?):Promise<GetResponsePayload<Query>>
Defined in: clients/v2/shared.ts:322
Fetch campaign members. This returns a single page of members, to paginate through more pages see paginateCampaignMembers.
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Member, true> | If<IncludeAll, PatreonQuery<Member, "address" | "campaign" | "user" | "pledge_history" | "currently_entitled_tiers", RelationshipMap<Member, "address" | "campaign" | "user" | "pledge_history" | "currently_entitled_tiers">, true>, PatreonQuery<Member, never, never, true>> |
Parameters
| Parameter | Type | Description |
|---|---|---|
campaignId | string | The campaign id of the members |
query? | Query | The query for requesting relationships and attributes |
options? | Oauth2RouteOptions | The request options. Allows for authentication (token) and fetch options. |
Returns
Promise<GetResponsePayload<Query>>
The API response for the route. If using a (client) response parser, the response will be transformed.
See
https://docs.patreon.com/#get-api-oauth2-v2-campaigns-campaign_id-members
Requires
campaigns.members scope. For the address the campaigns.members.address scope is required.
Inherited from
PatreonSharedClient.fetchCampaignMembers
fetchCampaignPosts()
fetchCampaignPosts<
Query>(campaignId,query?,options?):Promise<GetResponsePayload<Query>>
Defined in: clients/v2/shared.ts:343
Fetch campaign posts. This returns a single page of posts, to paginate through more pages see paginateCampaignPosts.
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Post, true> | If<IncludeAll, PatreonQuery<Post, "campaign" | "user", RelationshipMap<Post, "campaign" | "user">, true>, PatreonQuery<Post, never, never, true>> |
Parameters
| Parameter | Type | Description |
|---|---|---|
campaignId | string | The campaign id of the posts |
query? | Query | The query for requesting relationships and attributes |
options? | Oauth2RouteOptions | The request options. Allows for authentication (token) and fetch options. |
Returns
Promise<GetResponsePayload<Query>>
The API response for the route. If using a (client) response parser, the response will be transformed.
See
https://docs.patreon.com/#get-api-oauth2-v2-campaigns-campaign_id-posts
Requires
campaigns.posts scope
Inherited from
PatreonSharedClient.fetchCampaignPosts
fetchCampaigns()
fetchCampaigns<
Query>(query?,options?):Promise<GetResponsePayload<Query>>
Defined in: clients/v2/shared.ts:281
Fetch campaigns. This returns a single page of campaigns, to paginate through more pages see paginateCampaigns.
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Campaign, true> | If<IncludeAll, PatreonQuery<Campaign, "benefits" | "goals" | "live_access_rules" | "tiers" | "creator", RelationshipMap<Campaign, "benefits" | "goals" | "live_access_rules" | "tiers" | "creator">, true>, PatreonQuery<Campaign, never, never, true>> |
Parameters
| Parameter | Type | Description |
|---|---|---|
query? | Query | The query for requesting relationships and attributes |
options? | Oauth2RouteOptions | The request options. Allows for authentication (token) and fetch options. |
Returns
Promise<GetResponsePayload<Query>>
The API response for the route. If using a (client) response parser, the response will be transformed.
See
https://docs.patreon.com/#get-api-oauth2-v2-campaigns
Requires
campaigns scope.
Inherited from
PatreonSharedClient.fetchCampaigns
fetchDiscordId()
fetchDiscordId():
Promise<string|undefined>
Defined in: clients/v2/user.ts:32
Fetch the ID of the Discord connection.
This will only work if the current token is associated with the user.
Returns
Promise<string | undefined>
The discord user ID
fetchIdentity()
fetchIdentity<
Query>(query?,options?):Promise<GetResponsePayload<Query>>
Defined in: clients/v2/shared.ts:402
Fetch the current user for the oauth token.
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<User, false> | If<IncludeAll, PatreonQuery<User, "campaign" | "memberships", RelationshipMap<User, "campaign" | "memberships">, false>, PatreonQuery<User, never, never, false>> |
Parameters
| Parameter | Type | Description |
|---|---|---|
query? | Query | The query for requesting relationships and attributes |
options? | Oauth2RouteOptions | The request options. Allows for authentication (token) and fetch options. |
Returns
Promise<GetResponsePayload<Query>>
The API response for the route. If using a (client) response parser, the response will be transformed.
See
https://docs.patreon.com/#get-api-oauth2-v2-identity
Requires
identity scope.
Inherited from
PatreonSharedClient.fetchIdentity
fetchMember()
fetchMember<
Query>(memberId,query?,options?):Promise<GetResponsePayload<Query>>
Defined in: clients/v2/shared.ts:363
Fetch a member.
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Member, false> | If<IncludeAll, PatreonQuery<Member, "address" | "campaign" | "user" | "pledge_history" | "currently_entitled_tiers", RelationshipMap<Member, "address" | "campaign" | "user" | "pledge_history" | "currently_entitled_tiers">, false>, PatreonQuery<Member, never, never, false>> |
Parameters
| Parameter | Type | Description |
|---|---|---|
memberId | string | The id of the member to return. |
query? | Query | The query for requesting relationships and attributes |
options? | Oauth2RouteOptions | The request options. Allows for authentication (token) and fetch options. |
Returns
Promise<GetResponsePayload<Query>>
The API response for the route. If using a (client) response parser, the response will be transformed.
See
https://docs.patreon.com/#get-api-oauth2-v2-members-member_id
Requires
campaigns.members scope.
Inherited from
PatreonSharedClient.fetchMember
fetchOauth2()
fetchOauth2<
Query>(path,query,options?):Promise<GetResponsePayload<Query>>
Defined in: clients/v2/shared.ts:234
Fetch the Patreon Oauth V2 API
Type Parameters
| Type Parameter |
|---|
Query extends BasePatreonQuery |
Parameters
| Parameter | Type | Description |
|---|---|---|
path | string | The Oauth V2 API Route |
query | Query | The query builder with included fields and attributes |
options? | Oauth2FetchOptions | Request options |
Returns
Promise<GetResponsePayload<Query>>
the response for succesful requests
Throws
on failed request
Inherited from
PatreonSharedClient.fetchOauth2
fetchPost()
fetchPost<
Query>(postId,query?,options?):Promise<GetResponsePayload<Query>>
Defined in: clients/v2/shared.ts:383
Fetch a post.
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Post, false> | If<IncludeAll, PatreonQuery<Post, "campaign" | "user", RelationshipMap<Post, "campaign" | "user">, false>, PatreonQuery<Post, never, never, false>> |
Parameters
| Parameter | Type | Description |
|---|---|---|
postId | string | The id of the post to return. |
query? | Query | The query for requesting relationships and attributes |
options? | Oauth2RouteOptions | The request options. Allows for authentication (token) and fetch options. |
Returns
Promise<GetResponsePayload<Query>>
The API response for the route. If using a (client) response parser, the response will be transformed.
See
https://docs.patreon.com/#get-api-oauth2-v2-posts-id
Requires
campaigns.posts scope.
Inherited from
PatreonSharedClient.fetchPost
paginateCampaignMembers()
paginateCampaignMembers<
Query>(campaignId,query?,options?):AsyncGenerator<GetResponsePayload<Query>,number,unknown>
Defined in: clients/v2/shared.ts:422
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Member, true> | If<IncludeAll, PatreonQuery<Member, "address" | "campaign" | "user" | "pledge_history" | "currently_entitled_tiers", RelationshipMap<Member, "address" | "campaign" | "user" | "pledge_history" | "currently_entitled_tiers">, true>, PatreonQuery<Member, never, never, true>> |
Parameters
| Parameter | Type |
|---|---|
campaignId | string |
query? | Query |
options? | Oauth2RouteOptions |
Returns
AsyncGenerator<GetResponsePayload<Query>, number, unknown>
Inherited from
PatreonSharedClient.paginateCampaignMembers
paginateCampaignPosts()
paginateCampaignPosts<
Query>(campaignId,query?,options?):AsyncGenerator<GetResponsePayload<Query>,number,unknown>
Defined in: clients/v2/shared.ts:433
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Post, true> | If<IncludeAll, PatreonQuery<Post, "campaign" | "user", RelationshipMap<Post, "campaign" | "user">, true>, PatreonQuery<Post, never, never, true>> |
Parameters
| Parameter | Type |
|---|---|
campaignId | string |
query? | Query |
options? | Oauth2RouteOptions |
Returns
AsyncGenerator<GetResponsePayload<Query>, number, unknown>
Inherited from
PatreonSharedClient.paginateCampaignPosts
paginateCampaigns()
paginateCampaigns<
Query>(query?,options?):AsyncGenerator<GetResponsePayload<Query>,number,unknown>
Defined in: clients/v2/shared.ts:412
Type Parameters
| Type Parameter | Default type |
|---|---|
Query extends BasePatreonQueryType<Campaign, true> | If<IncludeAll, PatreonQuery<Campaign, "benefits" | "goals" | "live_access_rules" | "tiers" | "creator", RelationshipMap<Campaign, "benefits" | "goals" | "live_access_rules" | "tiers" | "creator">, true>, PatreonQuery<Campaign, never, never, true>> |
Parameters
| Parameter | Type |
|---|---|
query? | Query |
options? | Oauth2RouteOptions |
Returns
AsyncGenerator<GetResponsePayload<Query>, number, unknown>
Inherited from
PatreonSharedClient.paginateCampaigns
paginateOauth2()
paginateOauth2<
Query>(path,query,options?):AsyncGenerator<GetResponsePayload<Query>,number,unknown>
Defined in: clients/v2/shared.ts:254
Paginate the Patreon Oauth V2 API until all pages are fetched
Type Parameters
| Type Parameter |
|---|
Query extends BasePatreonQuery |
Parameters
| Parameter | Type | Description |
|---|---|---|
path | string | The Oauth V2 API Route |
query | Query | The query builder with included fields and attributes |
options? | Oauth2FetchOptions | Request options |
Returns
AsyncGenerator<GetResponsePayload<Query>, number, unknown>
the amount of pages fetched
Yields
a page of response data
Inherited from
PatreonSharedClient.paginateOauth2