@gate-forge/pack-auth
授权合同包。 纯 TypeScript 检测器( 无子进程) , 可以发现四个框架和释放的作用守护模式 auth.resource 带有角色+租赁属性的条目.
检测到的框架
| 框架 | 检测信号 |
|---|---|
| 网点JS | @Controller() 分类 @UseGuards(...) + 键 @Roles('admin', ...) + 键 @Get/Post/Put/Patch/Delete |
| 快递 | app.METHOD(path, mw, ...) 编号 : router.METHOD(path, mw, ...) 地点 mw 读取 req.user.role |
| 快捷化 | fastify.METHOD(path, { preHandler }, handler) 谁 preHandler 读取 request.user.role |
| 浩诺 | app.METHOD(path, mw, ...) 地点 mw 读取 c.var.user.role 或者说 c.get('user') |
每个被守护的终点都变成了一个资源:
{
id: "auth.billing.post-refund",
kind: "auth.resource",
source: "src/billing.controller.ts",
location: { file, line, col },
detectorVersion: "0.1.0",
attributes: {
framework: "nestjs" | "express" | "fastify" | "hono",
path: "/billing/refund",
httpMethods: ["POST"],
roleRequirement: ["admin", "finance"],
tenancy: true | false
}
}
资源 ID 遵循语法 auth.<area>.<verb>-<endpoint>;区域是第一个路径段,动词是小写HTTP方法.
合同义务词汇
定义 src/obligations.ts 和再出口为 AUTH_OBLIGATION_CONTRACTS义务编号 <resourceId>:<contract> 按引擎的id语法.
| 合同 | 含义 |
|---|---|
auth:role-allowed | 负责 roleRequirement 收到2xx回复 |
auth:role-denied | 没有匹配角色的呼叫者获得401/403 |
auth:tenant-isolated | 具有正确角色但错误租户的打电话者可领取403(何时) tenancy: true(中文(简体) ) |
auth:denied-no-side-effect | 被拒绝的请求不会改变资源( 后拒绝显示行不变/ 丢失) |
auth:forged-token-rejected | 伪造 JWT( 错误签名、 过期、 错误、 缺失) 返回 401 |
调查结果
| 代码 | 含义 |
|---|---|
AMBIGUOUS_GUARD | A 类 @Roles() 装饰者使用非文体参数(例如. @Roles(...ALLOWED)(中文(简体) ) |
DUPLICATE_RESOURCE_ID | 两个声明产生相同的结果 auth.<area>.<verb>-<endpoint> 编号 |
PARSE_ERROR | 无法读取扫描文件 |
实体适配器方案a
货船 src/adapter-schema.ts 页:1 @gate-forge/pack-sqlalchemy适配器合同),所以收费资源可以被目击到只有GET-. 实例 Auth 服务器发送 x-gateforge-env: example-auth-v1 每个响应;适配器 environmentFingerprint 必须等同于这一价值.
// .gateforge/adapters/auth.billing.refund.mjs
export default {
resourceId: 'auth.billing.refund',
read: async (ctx, id) => fetch(`${ctx.baseUrl}/billing/refund/${id}`, { headers: ctx.headers ?? {} }),
normalize: (body) => ({ entityId: body.id, fields: { id: body.id, status: body.status, tenant_id: body.tenant_id } }),
deletion: 'archive',
environmentFingerprint: 'example-auth-v1',
};
示例服务器
example/auth/server.js ——零依赖节点:http服务器于端口 3001数字 :
POST /billing/refund由角色监管admin和房客的配对; 创建一行内在的一行.GET /billing/refund/:id返回行(缺行为404;交叉租户为403).- 所有答复均附有
x-gateforge-env: example-auth-v1。 。 。 .
运行它:
node example/auth/server.js
# → gateforge auth example server listening on http://127.0.0.1:3001
测试
cd packages/pack-auth
npx tsc --noEmit # typecheck
npx vitest run # unit + e2e
E2e套接字套接字在OS指定的自由端口上为服务器提供靴子,执行所有5个义务合同,并包括两个对抗测试:
fake-green: role-denied with 200——vitest必须拒绝(服务器返回403).fake-green: no-side-effect without post-deny GET——正格套件中的伴奏断言证明需要GET探测器.
用作 CLI 插件
# .gateforge.yml
plugins:
- id: gateforge.pack-auth
version: 0.1.0
transport: in-process
module: '@gate-forge/pack-auth'
限制
- Python出处超出范围(每个简报只限TS).
- 动态角色集(例如.
@Roles(...ALLOWED)表面为AMBIGUOUS_GUARD永远不要成为资源;用户必须将其提升到文字上. - Regex 检测器不运行 TS 编译器;框架特定语法必须精确匹配所记录的信号(解码器顺序,选项块形状等).