Get role details

//native

type Neondb = {

	apiKey: string

}

/**

 * Get role details

 * Retrieves details about the specified role.

You can obtain a `project_id` by listing the projects for your Neon account.

You can obtain the `branch_id` by listing the project's branches.

You can obtain the `role_name` by listing the roles for a branch.

In Neon, the terms "role" and "user" are synonymous.

For related information, see [Manage roles](https://neon.tech/docs/manage/roles/).

 */

export async function main(auth: Neondb, project_id: string, branch_id: string, role_name: string) {

	const url = new URL(

		`https://console.neon.tech/api/v2/projects/${project_id}/branches/${branch_id}/roles/${role_name}`

	)

	const response = await fetch(url, {

		method: 'GET',

		headers: {

			Authorization: 'Bearer ' + auth.apiKey

		},

		body: undefined

	})

	if (!response.ok) {

		const text = await response.text()

		throw new Error(`${response.status} ${text}`)

	}

	return await response.json()

}