@gapi/ac

中文文档
1.8.263发布于 2026/11/16MITTypeScriptESM + CJS零依赖近 30 天下载 3914

@gapi/ ac 库是一个用于GraphQL应用程序的访问控制工具。 它帮助开发者管理不同用户角色的权限,例如GULT,USER,和ADMIN,跨越各种GraphQL动作,如查询,突变,下标等

中文使用文档

@gapi/ ac 库是一个用于GraphQL应用程序的访问控制工具。 它帮助开发者管理不同用户角色的权限,例如GULT,USER,和ADMIN,跨越各种GraphQL动作,例如查询,突变,订阅和事件. 它允许开发者定义并强制执行规则,其中的角色可以访问或操纵系统中的特定资源.

关键特征包括:

基于角色权限:您可以根据用户角色定义访问控制(如GULT,USER,ADMIN),并控制他们可以执行的行动. GraphQL 聚焦:在 GraphQL 中为处理许可而专门构建,使其自然适合应用此API标准. 过滤数据 : 库允许根据用户角色过滤数据,因此不同角色只看到他们被授权访问的数据. 例如,管理员可以访问查询某个数据字段(状态),而普通用户可以部分访问,根据许可定义过滤出一些响应属性.

import { AccessControl, Union } from '@gapi/ac';

enum GraphqlActions {
  query,
  mutation,
  subscription,
  event,
}

enum Roles {
  GUEST,
  USER,
  ADMIN,
}

interface IQuery {
  status: {
    status: number;
  };
}

const Permissions: Union<typeof Roles, IQuery, typeof GraphqlActions> = {
  GUEST: {
    status: {
      query: {
        enabled: false,
      },
    },
  },
  USER: {
    status: {
      query: {
        enabled: true,
        attributes: {
          status: false,
        },
      },
    },
  },
  ADMIN: {
    status: {
      query: {
        enabled: true,
      },
    },
  },
};

const ac = new AccessControl<
  typeof Roles,
  IQuery & ISubscription & IMutation,
  typeof GraphqlActions
>(Permissions);

const canAdminQueryStatus = ac.can('ADMIN', 'query', 'status');
const canAdminQueryStatus = ac.can('USER', 'query', 'status');

if (!canAdminQueryStatus) {
  throw new Error('You are not authorized');
}

const data = { status: 200 };
const filteredData = await ac.filter('USER', 'query', 'status')(data);
filteredData; // { status: null }

版本与发布记录

@gapi/ac 共发布 216 个版本,首次发布于 2020/04/22;过去 12 个月发布了 116 个版本。

版本发布日期距今
1.8.263latest2026/11/16今天
1.8.2622026/11/132 天前
1.8.2612026/11/096 天前
1.8.2602026/11/097 天前
1.8.2592026/11/097 天前
1.8.2582026/11/078 天前

其他发布通道:nightly → 1.8.168-nightly.3。

关于 @gapi/ac 的常见问题

@gapi/ac 是什么?

@gapi/ ac 库是一个用于GraphQL应用程序的访问控制工具。 它帮助开发者管理不同用户角色的权限,例如GULT,USER,和ADMIN,跨越各种GraphQL动作,如查询,突变,下标等

如何安装 @gapi/ac?

在项目目录运行 npm install @gapi/ac,或使用 pnpm add / yarn add / bun add。

@gapi/ac 支持 TypeScript 吗?

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

@gapi/ac 支持 ESM 还是 CommonJS?

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

@gapi/ac 可以商用吗?

@gapi/ac 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gapi/ac 的下载量有多少?

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

@gapi/ac 还在维护吗?

最新版本 1.8.263 发布于 2026/11/16(今天);至今共发布 216 个版本,其中过去 12 个月发布了 116 个;首次发布于 2020/04/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。