# @dyad-sh/supabase-management-js 中文文档

规范地址：https://npmcn.com/package/%40dyad-sh/supabase-management-js/

版本：1\.0\.1
npm 元数据更新时间：2025-11-13T07:26:42.745Z
中文译文更新时间：2026-11-13T02:04:55.024Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dyad-sh/supabase-management-js
原文对照：https://npmcn.com/package/%40dyad-sh/supabase-management-js/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：487 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：1 个
- 首次发布：2025-04-23T06:18:49.178Z
- 最新版本发布：2025-11-13T07:26:42.559Z
- 近 30 天下载量：7095（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

Supabase管理 API 的方便包装

## 安装

```sh
npm install @dyad-sh/supabase-management-js
```

也可以使用：`pnpm add @dyad-sh/supabase-management-js`、`yarn add @dyad-sh/supabase-management-js`、`bun add @dyad-sh/supabase-management-js`

## README

## supabase-management-js (西班牙语)

方便包装 [Supabase 管理 API](https://supabase.com/docs/reference/api/introduction) 用 TypeScript 写出.

### 状态

管理API在β. 它在目前状态下可以使用,但很可能会出现断裂变化.

### 安装

要安装 `supabase-management-js` 在节点项目中:

```sh
npm install supabase-management-js
```

`supabase-management-js` 需要18和18个以上节点,因为它依赖当地人 `fetch` 客户端.

### 认证

您可以配置 `SupabaseManagementAPI` 类,带有访问符,通过 [奥奥特](https://supabase.com/docs/guides/integrations/oauth-apps/authorize-an-oauth-app) 或通过生成 API 令牌 [账户](https://supabase.com/dashboard/account/tokens) 页 次 您的 API 令牌带有与您的用户账户相同的权限, 所以请务必保密 .

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

const client = new SupabaseManagementAPI({ accessToken: "<access token>" });
```

### 使用量

这个 `SupabaseManagementAPI` 类曝光 API 的每个端点 [管理层 API](https://supabase.com/docs/reference/api/introduction) 作为返回带有相应响应数据类型的“承诺”的函数.

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

const client = new SupabaseManagementAPI({ accessToken: "<access token>" });

const projects = await client.getProjects();

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

### 处理错误

反应错误被抛出作为 `SupabaseManagementAPIError` 它是一个子类 `Error`。您可以使用导出 `isSupabaseError` 守护功能以缩小类型 `unknown` 错误对象 :

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

const client = new SupabaseManagementAPI({ accessToken: "<access token>" });

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}`
    );
  }
}
```

### 捐款

对这个项目的贡献是十分受欢迎和高度赞赏的!

1.  将回放切入公共 GitHub 回放( 或分叉) [https://github.com/supabase-community/supabase-管理-js/fork 互联网档案馆的存檔,存档日期2013-12-11](https://github.com/supabase-community/supabase-management-js/fork)) (中文(简体) ).
    
2.  转到项目文件夹 .
    

```sh
cd supabase-management-js
```

3.  安装软件包 `npm`数字 :

```sh
npm install
```

4.  做你的改变
    
5.  确保类型正确
    

```sh
npm run typecheck
```

6.  如果您正在修改源代码以影响其公共 API 的更改, 则创建更改列表来描述您的更改

```sh
npm exec changeset
```

7.  创建分支, 执行您的更改, 并打开 Pull 请求以对抗 `main` 树枝在这个repo.

### 恢复类型

这个 [v1.d.ts (中文(简体) )](https://npmcn.com/package/%40dyad-sh/supabase-management-js/src/api/v1.d.ts) 文件基于 Supabase 自动生成 [OpenAPI 光谱](https://api.supabase.com/api/v1-json) 带有以下命令的文件 :

```sh
npm run generate
```

## 常见问题

### @dyad-sh/supabase-management-js 是什么？

Supabase管理 API 的方便包装

### 如何安装 @dyad-sh/supabase-management-js？

在项目目录运行 npm install @dyad-sh/supabase-management-js，或使用 pnpm add / yarn add / bun add。

### @dyad-sh/supabase-management-js 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dyad-sh/supabase-management-js 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @dyad-sh/supabase-management-js 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dyad-sh/supabase-management-js 可以商用吗？

@dyad-sh/supabase-management-js 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @dyad-sh/supabase-management-js 的下载量有多少？

根据 npm 官方下载统计，@dyad-sh/supabase-management-js 在 2026/10/13 – 2026/11/11 这 30 天内被下载 7,095 次，日均约 237 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dyad-sh/supabase-management-js 还在维护吗？

最新版本 1\.0\.1 发布于 2025/11/13（1 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/04/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。