/** *
* Built-in FourSquare integration. * * * *
* * @module providers/foursquare */ import type { OAuthConfig, OAuthUserConfig } from "./index.js" /** * Add FourSquare login to your page. * * ### Setup * * #### Callback URL * ``` * https://example.com/api/auth/callback/foursquare * ``` * * #### Configuration *```ts * import { Auth } from "@auth/core" * import FourSquare from "@auth/core/providers/foursquare" * * const request = new Request(origin) * const response = await Auth(request, { * providers: [ * FourSquare({ * clientId: FOURSQUARE_CLIENT_ID, * clientSecret: FOURSQUARE_CLIENT_SECRET, * }), * ], * }) * ``` * * ### Resources * * - [FourSquare OAuth documentation](https://docs.foursquare.com/developer/reference/authentication) * * ### Notes * * By default, Auth.js assumes that the FourSquare provider is * based on the [OAuth 2](https://www.rfc-editor.org/rfc/rfc6749.html) specification. * * :::warning * Foursquare requires an additional apiVersion parameter in YYYYMMDD format, which essentially states "I'm prepared for API changes up to this date". * ::: * * :::tip * * The FourSquare provider comes with a [default configuration](https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/providers/foursquare.ts). * To override the defaults for your use case, check out [customizing a built-in OAuth provider](https://authjs.dev/guides/configuring-oauth-providers). * * ::: * * :::info **Disclaimer** * * If you think you found a bug in the default configuration, you can [open an issue](https://authjs.dev/new/provider-issue). * * Auth.js strictly adheres to the specification and it cannot take responsibility for any deviation from * the spec by the provider. You can open an issue, but if the problem is non-compliance with the spec, * we might not pursue a resolution. You can ask for more help in [Discussions](https://authjs.dev/new/github-discussions). * * ::: */ export default function Foursquare( options: OAuthUserConfig> & { apiVersion?: string } ): OAuthConfig> { const { apiVersion = "20230131" } = options return { id: "foursquare", name: "Foursquare", type: "oauth", authorization: "https://foursquare.com/oauth2/authenticate", token: "https://foursquare.com/oauth2/access_token", userinfo: { url: `https://api.foursquare.com/v2/users/self?v=${apiVersion}`, request({ tokens, provider }) { const url = new URL(provider.userinfo?.url!) url.searchParams.append("oauth_token", tokens.access_token!) return fetch(url).then((res) => res.json()) }, }, profile({ response: { user: profile } }) { return { id: profile.id, name: `${profile.firstName} ${profile.lastName}`, email: profile.contact.email, image: profile.photo ? `${profile.photo.prefix}original${profile.photo.suffix}` : null, } }, style: { bg: "#000", text: "#fff", }, options, } }