#moon-token

moon update
moon add mldong/moon-token
moon add moonbitlang/async      # async 运行时；库本身不依赖它，但调用方要

#它解决什么

#五分钟跑通

pub(all) struct DemoPerms {
  permissions : Array[String]
  roles : Array[String]
}

// 业务只负责"给数"，AND/OR 裁决在库里
pub impl @port.PermissionProvider for DemoPerms with fn get_permissions(
  self,
  _login_id,
  _device,
) {
  self.permissions
}

pub impl @port.PermissionProvider for DemoPerms with fn get_roles(self, _login_id, _device) {
  self.roles
}

pub impl @port.PermissionProvider for DemoPerms with fn is_super_admin(
  _self,
  _login_id,
  _device,
) {
  false
}

pub  DemoPerms with @port.PermissionProvider::{
  get_permissions,
  get_roles,
  is_super_admin,
}

fn new_auth() -> @app.TokenAuth[@mem.MemoryStore, DemoPerms] {
  let p : DemoPerms = { permissions: ["user:info"], roles: ["user"] }
  @app.TokenAuth::new(
    "user",                          // realm：账号体系
    @app.TokenConfig::default(),     // 十三项配置，默认值即推荐值
    @mem.MemoryStore::new("user"),   // 存储端口；换后端只改这一处
    p,
    @style.opaque_style(),           // token 生成；取不到平台熵即 abort
  )
}

async fn flow() -> (String, String) raise {
  let auth = new_auth()
  let result = auth.login("u1", device="pc")             // 一次签发 access + refresh 整对
  let login_id = auth.check_login(result.token)          // 通过给 login_id
  auth.kickout("u1", device="pc") |> ignore
  let reason = auth.check_login(result.token) catch {
    err => err.message()
  }
  (login_id, reason)
}

async test "被踢方拿到的是 KickedOut，不是笼统未登录" {
  let (login_id, reason) = flow()
  assert_eq(login_id, "u1")
  assert_eq(reason, "not login: KickedOut")
}

#文档

#边界（v1）

• 只交付内存存储。进程重启状态清零；持久化后端（事务型、Lua 原子型）在下一轮。
• 熵源分档：默认 opaque_style() 取平台熵，取不到即 abort，绝不静默回落到固定种子。 wasm-gc 档无平台熵源，请改用 opaque_style_with_seed / opaque_style_with。
• 随机流是 core 提供的 ChaCha8（8 轮变体），本项目不宣称其等同 ChaCha20 强度。
• 不做注解式鉴权（语言无注解）；不做 JWT；二级认证与框架中间件适配归下一轮。
• 存储层不落 token 哈希（键位属共享内核，v1 未开放该钩子）。

#许可与模块