# @aglyn/tenant-data-admin 中文文档

规范地址：https://npmcn.com/package/%40aglyn/tenant-data-admin/

版本：1\.18\.0
npm 元数据更新时间：2026-11-07T06:45:59.093Z
中文译文更新时间：2026-11-05T22:00:09.247Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aglyn/tenant-data-admin
原文对照：https://npmcn.com/package/%40aglyn/tenant-data-admin/?lang=original
项目主页：https://aglyn.com/
源码仓库：https://github.com/aglyn/aglyn

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

- 包体积（解压后）：10.7 MB，668 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：10 个
- peer 依赖：next ^16\.3\.3，react ^19\.2\.8，firebase-admin ^14\.3\.0
- 首次发布：2026-09-20T23:54:59.524Z
- 最新版本发布：2026-11-07T06:45:58.741Z
- 近 30 天下载量：14378（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：151（近 12 个月 151 个）

## 中文简介

Aglyn的租户运行时间的服务器数据层:Firebase Admin设置,打入了Firestore转换器,以及使用管理员证书读取和写入平台数据的服务器侧模块. 它主要是一个内部构件 `@aglyn/tenant-runtime`

## 安装

```sh
npm install @aglyn/tenant-data-admin
```

也可以使用：`pnpm add @aglyn/tenant-data-admin`、`yarn add @aglyn/tenant-data-admin`、`bun add @aglyn/tenant-data-admin`

## README

# @aglyn/tenant-data-admin (英语)

Aglyn的租户运行时间的服务器数据层: Firebase 管理员设置, 键入 Firestore 转换器,以及读取和写入的服务器侧模块 带有管理员证书的平台数据。 主要是内部建筑 联 合 国 `@aglyn/tenant-runtime`,从Aglyn的服务器应用程序, 和服务器的一半 页:1 `@aglyn/plugins-*` 软件包。 只有您正在写时才直接安装 服务器代码与Aglyn部署的Firestore对接.

> 从Aglyn monorepo出版到npm. 随后的版本 [语义版本](https://semver.org/)。 。 。 .

## 安装

```
npm install @aglyn/tenant-data-admin
```

同伴依赖性 :

-   `firebase-admin`
-   `next` (渲染缓存用途) `next/cache`,并使用两个请求处理器 下一个是 API 路由类型)
-   `react` (一个模块使用 React 的) `cache`(中文(简体) )

此软件包仅限服务器使用 。 它使用节点内置和管理员证书 不得从客户端代码导入。 这取决于 `sharp` 图像 变相.

## 里面有什么东西

根导出为一桶以上 `src/lib/server`其主要领域:

-   消防基地管理员: `firebaseAdmin`,用于核心文件的 Firestore 转换器 (单位:千美元)`hostConverter`, (中文(简体) ), `screenConverter`, (中文(简体) ), `screenVersionConverter`, (中文(简体) ), `layoutConverter`, (中文(简体) ), `layoutVersionConverter`)和身份证检查,例如: `verifyConsoleIdToken` 财务报告和审定财务报表 `isEmailVerified`。 。 。 .
-   访问: API 密钥 (`mintApiKey`, (中文(简体) ), `verifyApiKey`, (中文(简体) ), `listApiKeys`, (中文(简体) ), `revokeApiKey`, (中文(简体) ), `API_SCOPES`),主办成员,组织,编辑-访问 代币、代币转让、特别服务单位政策和供应、代币撤销和 封锁.
-   域: a 后面的工作空间域 `DomainProvider` 连接 (单位:千美元)`domainProvider`),控制台域,DNS检测和电子邮件发送域.
-   电子邮件:压制、取消订阅链接、专题确认、计量、 派遣率州长,营销门和发送者声誉.
-   联系人和客户关系管理记录:联系人上升、合并、电子邮件索引、公司链接、, 列表成员和客户关系管理活动记录.
-   媒体:存储路径,签名,下载令牌,变体,隔离, 墓碑、送货和CDN请求处理器.
-   隐私:消除`erase`, (中文(简体) ), `erase-person`)和个人数据导出.
-   滥用限制:限速商店、访客写作和控制台API费率限制, 密码重置,验证电子邮件和会员回收节流阀.
-   组织计费文件`org-billing`),释放旗帜、通知和日志排出 签名检查.

导入根具有副作用, 目的: 评价 `email-send-rate` 财务报告和审定财务报表 `email-marketing-gate` 安装平台发送率 州长和共享电子邮件发送器的营销门 所以每个服务器 表面, 导入此软件包时无需拨打.

由子路径:

-   `@aglyn/tenant-data-admin/render-cache` 已经 `withRenderCache`,缓存 标记 (`tenantDataTag`, (中文(简体) ), `tenantHostAliasTag`和用于 已公布的网站数据.
-   下方的任何文件 `src/lib`,例如 `@aglyn/tenant-data-admin/server/api-keys`,用于导入一个模块,而不包含 枪管及其副作用.

## 使用量

```ts
import { verifyApiKey } from '@aglyn/tenant-data-admin/server/api-keys'
import { withRenderCache } from '@aglyn/tenant-data-admin/render-cache'
```

```ts
import { firebaseAdmin, hostConverter } from '@aglyn/tenant-data-admin'
```

## 怎样才合适

这是数据块 `tenant` 范围。 进口 核心资源`@aglyn/aglyn`)和通用软件 `@aglyn/shared-*` 公用事业,没有 {\\fn华文仿宋\\fs16\\1chd1d1d1}在它上面. `@aglyn/tenant-runtime` 通过它读取,以及插件的服务器代码 可能导入;它从未导入插件.

## 许可证

阿帕奇2.0 (英语). 资料来源: [https://github.com/aglyn/aglyn/tree/main/libs/tenant/data/admin 页面存档备份,存于互联网档案馆](https://github.com/aglyn/aglyn/tree/main/libs/tenant/data/admin)

## 常见问题

### @aglyn/tenant-data-admin 是什么？

Aglyn的租户运行时间的服务器数据层:Firebase Admin设置,打入了Firestore转换器,以及使用管理员证书读取和写入平台数据的服务器侧模块\. 它主要是一个内部构件 @aglyn/tenant-runtime

### 如何安装 @aglyn/tenant-data-admin？

在项目目录运行 npm install @aglyn/tenant-data-admin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（^16\.3\.3）、react（^19\.2\.8）、firebase-admin（^14\.3\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aglyn/tenant-data-admin 支持 TypeScript 吗？

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

### @aglyn/tenant-data-admin 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aglyn/tenant-data-admin 可以商用吗？

@aglyn/tenant-data-admin 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aglyn/tenant-data-admin 的下载量有多少？

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

### @aglyn/tenant-data-admin 还在维护吗？

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