Add Dribbble provider (#69)

* add dribbble provider

* remove unnecessary response body type

* add minor changeset

---------

Co-authored-by: Victor <me@victorsales.dev>

.changesets/5n81r.minor.md

@@ -0,0 +1 @@
+Add Dribbble provider

README.md

@@ -29,6 +29,7 @@ For a flexible OAuth 2.0 client, see [`oslo/oauth2`](http://github.com/pilcrowon
 - Box
 - Coinbase
 - Discord
+- Dribbble
 - Dropbox
 - Facebook
 - Figma

docs/malta.config.json

@@ -23,6 +23,7 @@
 				["Box", "/providers/box"],
 				["Coinbase", "/providers/coinbase"],
 				["Discord", "/providers/discord"],
+				["Dribbble", "/providers/dribbble"],
 				["Dropbox", "/providers/dropbox"],
 				["Facebook", "/providers/facebook"],
 				["Figma", "/providers/figma"],

docs/pages/providers/dribbble.md

@@ -0,0 +1,35 @@
+---
+title: "Dribbble"
+---
+
+# Dribbble
+
+For usage, see [OAuth 2.0 provider](/guides/oauth2).
+
+```ts
+import { Dribbble } from "arctic";
+
+const dribbble = new Dribbble(clientId, clientSecret, redirectURI);
+```
+
+```ts
+const url: URL = await dribbble.createAuthorizationURL(state, {
+	// optional
+	scopes
+});
+const tokens: DribbbleTokens = await dribbble.validateAuthorizationCode(code);
+```
+
+## Get user profile
+
+Use the [`/user` endpoint](https://developer.dribbble.com/v2/user).
+
+```ts
+const tokens = await dribbble.validateAuthorizationCode(code);
+const response = await fetch("https://api.dribbble.com/v2/user", {
+	headers: {
+		Authorization: `Bearer ${tokens.accessToken}`
+	}
+});
+const user = await response.json();
+```

src/index.ts

@@ -6,6 +6,7 @@ export { Bitbucket } from "./providers/bitbucket.js";
 export { Box } from "./providers/box.js";
 export { Coinbase } from "./providers/coinbase.js";
 export { Discord } from "./providers/discord.js";
+export { Dribbble } from "./providers/dribbble.js";
 export { Dropbox } from "./providers/dropbox.js";
 export { Facebook } from "./providers/facebook.js";
 export { Figma } from "./providers/figma.js";
@@ -45,6 +46,7 @@ export type { BitbucketTokens } from "./providers/bitbucket.js";
 export type { BoxTokens } from "./providers/box.js";
 export type { CoinbaseTokens } from "./providers/coinbase.js";
 export type { DiscordTokens } from "./providers/discord.js";
+export type { DribbbleTokens } from "./providers/dribbble.js";
 export type { DropboxRefreshedTokens, DropboxTokens } from "./providers/dropbox.js";
 export type { FacebookTokens } from "./providers/facebook.js";
 export type { FigmaRefreshedTokens, FigmaTokens } from "./providers/figma.js";

src/providers/dribbble.ts

@@ -0,0 +1,45 @@
+import { OAuth2Client } from "oslo/oauth2";
+
+import type { OAuth2Provider } from "../index.js";
+
+const authorizeEndpoint = "https://dribbble.com/oauth/authorize";
+const tokenEndpoint = "https://dribbble.com/oauth/token";
+
+export class Dribbble implements OAuth2Provider {
+	private client: OAuth2Client;
+	private clientSecret: string;
+
+	constructor(clientId: string, clientSecret: string, redirectURI: string) {
+		this.client = new OAuth2Client(clientId, authorizeEndpoint, tokenEndpoint, {
+			redirectURI
+		});
+		this.clientSecret = clientSecret;
+	}
+
+	public async createAuthorizationURL(
+		state: string,
+		options?: {
+			scopes?: string[];
+		}
+	): Promise<URL> {
+		return await this.client.createAuthorizationURL({
+			state,
+			scopes: options?.scopes ?? []
+		});
+	}
+
+	public async validateAuthorizationCode(code: string): Promise<DribbbleTokens> {
+		const result = await this.client.validateAuthorizationCode(code, {
+			authenticateWith: "request_body",
+			credentials: this.clientSecret
+		});
+		const tokens: DribbbleTokens = {
+			accessToken: result.access_token
+		};
+		return tokens;
+	}
+}
+
+export interface DribbbleTokens {
+	accessToken: string;
+}