supabase-management-js

supabase-management-js

A convenience wrapper for the Supabase Management API written in TypeScript.

$3

The Management API is in beta. It is usable in it's current state, but it's likely that there will be breaking changes.

$3

To install supabase-management-js in a Node.js project:

``sh
npm install supabase-management-js
`

supabase-management-js requires Node.js 18 and above because it relies on the native fetch client.

$3

You can configure the SupabaseManagementAPI class with an access token, retrieved either through OAuth or by generating an API token in your account page. Your API tokens carry the same privileges as your user account, so be sure to keep it secret.

`ts
import { SupabaseManagementAPI } from "supabase-management-js";

const client = new SupabaseManagementAPI({ accessToken: "" });
`

$3

The SupabaseManagementAPI class exposes each API endpoint of the Management API as a function that returns a Promise with the corresponding response data type.

`ts
import { SupabaseManagementAPI } from "supabase-management-js";

const client = new SupabaseManagementAPI({ accessToken: "" });

const projects = await client.getProjects();

if (projects) {
console.log(Found ${projects.length} projects);
}
`

$3

Response errors are thrown as an instance of SupabaseManagementAPIError which is a subclass of Error. You can use the exported isSupabaseError guard function to narrow the type of an unknown error object:

`ts
import { SupabaseManagementAPI, isSupabaseError } from "supabase-management-js";

const client = new SupabaseManagementAPI({ accessToken: "" });

try {
await client.getProjects();
} catch (error) {
if (isSupabaseError(error)) {
// error is now typed as SupabaseManagementAPI
console.log(
Supabase Error: ${error.message}, response status: ${error.response.status}
);
}
}
`

$3

Contributions to this project are very welcome and greatly appreciated!

1. Clone the repo into a public GitHub repo (or fork https://github.com/supabase-community/supabase-management-js/fork).

2. Go to the project folder.

`sh
cd supabase-management-js
`

3. Install packages with npm:

`sh
npm install
`

4. Make your changes

5. Make sure types are correct

`sh
npm run typecheck
`

6. Create a changeset to describe your changes if you are making changes to the source code that effects its public API

`sh
npm exec changeset
`

7. Create a branch, commit your changes, and open a Pull Request against the main branch in this repo.

$3

The v1.d.ts file is auto-generated based on the Supabase OpenAPI spec file with the following command:

`sh
npm run generate
``