Auth

@tripo3d/auth · 基于 Ory Kratos 的统一认证客户端,封装 Tripo 全线产品的账号登录、注册、验证、找回、会话管理。

特性

🔑

多种登录方式

密码 / 邮箱或手机验证码 / OIDC(Google、Apple 等第三方)

📮

完整注册流程

密码注册、验证码注册、邮箱/手机验证、账号找回、改密

🎫

JWT 会话

内置 jwt-decode,提供 token 解析、过期检测、自动刷新点

🧭

错误可定位

TripoAuthError 统一错误类,附带错误码表,便于前端精准提示

🌍

标识符自适应

自动识别 email 与手机号,发起合适的验证流程

🔬

可测性高

所有方法均为纯异步函数,便于 mock 与单元测试

安装

请先完成 GitHub Packages 认证配置。

pnpm add @tripo3d/auth

快速开始

import { TripoAuth } from '@tripo3d/auth';

const auth = new TripoAuth({
  // Ory Kratos public URL
  basePath: 'https://auth.tripo3d.ai',
});

// 密码登录：先创建 flow，再调子方法
const loginFlow = await auth.createLoginFlow();
await loginFlow.password({
  email: 'user@example.com',
  password: '••••••',
});

// 取当前 JWT（已登录返回 token，未登录返回 undefined）
const token = await auth.tokenized();

下一步

• 架构总览 — Ory + JWT 模型
• 密码流程
• 验证码流程
• OIDC 登录
• API Reference — 完整 API 文档(自动生成)
• Playground — 交互式测试页(规划中)