weifuwu 0.80.0 → 0.81.0

package/dist/user/index.d.ts

@@ -1,19 +1,32 @@
 /**
- * weifuwu/userSystem — 用户系统中间件
+ * weifuwu/userSystem — 用户系统中间件（平台 → 应用 → 应用用户 三层模型）
  *
  * 注入 ctx.user（从 Authorization: Bearer 解码 + 查库）+ ctx.auth（方法面）。
  * users.routes(app) 注册 /api/auth/* 路由；users.migrate() 幂等建表。
  *
+ * 三层模型（用户决策 2026-12）：
+ *   1. 平台注册（email 全局唯一）→ 平台账号（_weifuwu_users，无租户绑定）
+ *   2. createApp 建应用 → 调用者成为 owner（_weifuwu_apps + _weifuwu_app_members）
+ *   3. 应用内注册：自助（open_registration=true）或邀请（invite token）双模式
+ *   登录入口：平台登录（/api/auth/login，token 无 appId + 我的应用列表）、
+ *           应用内登录（/api/auth/apps/:appSlug/login，token 带 appId + role）
+ *   鉴权：requireApp(appId) 应用级成员校验；token payload appId → ctx.appId 注入
+ *
  * 安全基线：
  *   - scrypt 密码哈希（per-user salt + timing-safe compare，异步不阻塞）
  *   - access token：HMAC-SHA256 JWT（无状态，与 client auth() 兼容）
  *   - refresh token：不透明随机串，DB 只存哈希，logout/轮换即撤销
  *   - 登录失败统一 401（不泄露"邮箱是否存在"——防枚举）
+ *   - 邀请 token：JWT 短效（7 天）+ email 绑定——非 owner 无法生成/消费
  *
  * 诚实裁剪：
- *   ✅ register/login/logout/me/refresh / setPassword / createToken / tenant claim
+ *   ✅ register/login/logout/me/refresh / setPassword / createToken / tenant claim /
+ *      apps 三层（createApp / registerInApp / loginApp / createInvite / addMember /
+ *      listMyApps / requireApp）
  *   ❌ OAuth、邮箱验证邮件（给 createToken + setPassword 底层 API 自接）、
- *      多因素、RBAC 权限引擎（只提供 role 字段）、多租户语义（tenant-ready）
+ *      多因素、RBAC 权限引擎（只提供 role 字段：owner/admin/member）、
+ *      订阅/计费/配额、应用业务数据（业务表挂 app_id 外键）、
+ *      应用删除的级联业务清理（只提供 deleteApp 删 app+members，业务表由业务层处理）
  *
  * ```ts
  * const db = postgres()
@@ -25,8 +38,9 @@
  * users.routes(app)
  *
  * app.get('/me', (req, ctx) => ok(ctx.user))           // ctx.user 已注入
- * app.post('/secure', (req, ctx) => {
+ * app.get('/secure', (req, ctx) => {
  *   ctx.auth.requireAuth()                              // 未登录抛 401
+ *   ctx.auth.requireApp(ctx.appId)                      // 应用成员校验（async）
  * })
  * ```
  */
@@ -51,8 +65,40 @@ export interface RegisterInput {
     password: string;
     name?: string;
     role?: string;
+    /** 兼容旧单层模型：注册即绑定应用（新三层模型请用 createApp/registerInApp） */
     tenant?: string;
 }
+/** 应用（产品/tenant 隔离单元） */
+export interface AppInfo {
+    id: string;
+    slug: string;
+    name: string;
+    owner_user_id: string;
+    open_registration: boolean;
+    created_at?: Date;
+}
+/** 我的应用摘要（平台登录/列表返回） */
+export interface AppSummary {
+    id: string;
+    slug: string;
+    name: string;
+    role: string;
+}
+export interface CreateAppInput {
+    slug: string;
+    name: string;
+    /** 允许自助注册（默认 false——邀请制） */
+    openRegistration?: boolean;
+}
+export interface RegisterInAppInput {
+    /** 应用 slug（人类可读路由标识） */
+    appSlug: string;
+    email: string;
+    password: string;
+    name?: string;
+    /** 邀请制（open_registration=false）必传 */
+    inviteToken?: string;
+}
 /** ctx.auth 方法面 */
 export interface AuthApi {
     register(input: RegisterInput): Promise<{
@@ -64,6 +110,7 @@ export interface AuthApi {
         token: string;
         refreshToken: string;
         user: User;
+        apps: AppSummary[];
     }>;
     /** 撤销 refresh token（logout） */
     logout(refreshToken: string): Promise<void>;
@@ -75,6 +122,37 @@ export interface AuthApi {
     createToken(type: string, payload: Record<string, unknown>, opts: {
         ttlSeconds: number;
     }): string;
+    /** 建应用 → 调用者成为 owner（需登录） */
+    createApp(input: CreateAppInput): Promise<AppInfo>;
+    /** 应用内注册：自助（open_registration=true）/ 邀请（inviteToken）——复用或创建平台账号 + 加成员 */
+    registerInApp(input: RegisterInAppInput): Promise<{
+        token: string;
+        refreshToken: string;
+        user: User;
+    }>;
+    /** 应用内登录：验证密码 + 应用成员资格 → token 带 appId + role */
+    loginApp(appSlug: string, email: string, password: string): Promise<{
+        token: string;
+        refreshToken: string;
+        user: User;
+    }>;
+    /** owner 生成邀请 token（7 天有效，可选绑定 email/role） */
+    createInvite(appId: string, opts: {
+        email?: string;
+        role?: string;
+    }): Promise<{
+        inviteToken: string;
+    }>;
+    /** owner 直接添加已有平台账号为成员 */
+    addMember(appId: string, email: string, role?: string): Promise<void>;
+    /** 我的应用列表（平台登录后选应用） */
+    listMyApps(): Promise<AppSummary[]>;
+    /** 应用级鉴权：未登录 401、非成员 403；返回成员信息 */
+    requireApp(appId: string): Promise<{
+        userId: string;
+        appId: string;
+        role: string;
+    }>;
 }
 export interface UserInjected {
     /** 当前用户（未登录 = null）。每次请求从 token 解码 + 查库（删号/角色变更即时生效） */
@@ -87,12 +165,12 @@ declare module '../types.ts' {
     }
 }
 export interface UserSystemClient extends Middleware<Context, Context & UserInjected> {
-    /** 幂等建表（users + sessions） */
+    /** 幂等建表（users + sessions + apps + app_members） */
     migrate: () => Promise<void>;
-    /** 注册 /api/auth/* 路由（register/login/logout/me/refresh）；exclude 跳过个别路由（应用层自定义） */
+    /** 注册 /api/auth/* 路由；exclude 跳过个别路由（应用层自定义） */
     routes: (app: Router<any>, opts?: {
         prefix?: string;
-        exclude?: Array<'register' | 'login' | 'logout' | 'refresh' | 'me'>;
+        exclude?: Array<'register' | 'login' | 'logout' | 'refresh' | 'me' | 'apps'>;
     }) => void;
 }
 export declare function userSystem(options: UserSystemOptions): UserSystemClient;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weifuwu",
   "type": "module",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "description": "AI SaaS framework — (req, ctx) => Response",
   "exports": {
     ".": {