@frigear-nu/authorization

中文文档
0.6.0发布于 2026/11/13MITTypeScriptES Module构建来源已验证近 30 天下载 3168

Roles, role assignment, the roles admin and the client side of access control (useAuthorization, , page rules) for the frigear ecosystem, built on @frigear-nu/auth.

原始使用文档

@frigear-nu/authorization

Roles, role assignment and the roles admin, plus the client side of access control, built on the permission engine of @frigear-nu/auth (server mode, with @frigear-nu/users) or on Auth alone in client mode.

  • Server mode: roles (authorization.roles: grant, inherit, requirements, auto) compiled by Auth, assignments in authorization_user_roles (generate and commit a migration in your app), and the roles admin (/api/admin/authorization/**, roles:read / roles:assign).
  • Client: useAuthorization() (access, a synchronous can / cannot, authorize, refresh), <Can> / <Cannot>, and filters that hide menu items, widgets and tabs whose permission the viewer lacks. access comes from GET /api/auth/me/access; in client mode (authentication.mode: 'client', such as @frigear-nu/mobile) from the issuer's /api/auth/me/access with the bearer token, falling back to the access token's permissions claim. Every client-side check is UI only: the API decides what is allowed.
  • Route rules as keys on Nuxt's native routeRules (permission, authenticated, guest) and per page (definePageMeta({ authorize }), authorize: false opens a page). Auth's anonymous sign-in pages and endpoints are always exempt from less specific rules ('/**': { authenticated: true }).

See the documentation for usage.

版本与发布记录

@frigear-nu/authorization 共发布 22 个版本,首次发布于 2026/10/11;过去 12 个月发布了 22 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.0latest2026/11/133 天前
0.5.12026/11/133 天前
0.5.02026/11/123 天前
0.4.02026/11/123 天前
0.3.22026/11/0411 天前
0.3.12026/11/0411 天前

关于 @frigear-nu/authorization 的常见问题

@frigear-nu/authorization 是什么?

Roles, role assignment, the roles admin and the client side of access control (useAuthorization, , page rules) for the frigear ecosystem, built on @frigear-nu/auth.

如何安装 @frigear-nu/authorization?

在项目目录运行 npm install @frigear-nu/authorization,或使用 pnpm add / yarn add / bun add。

@frigear-nu/authorization 支持 TypeScript 吗?

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

@frigear-nu/authorization 支持 ESM 还是 CommonJS?

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

@frigear-nu/authorization 可以商用吗?

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

@frigear-nu/authorization 的下载量有多少?

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

@frigear-nu/authorization 还在维护吗?

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