@ackplus/nest-auth-客户端

框架不可知 JavaScript/ TypeScript 客户端 @ackplus/nest-auth。零对等依赖性。 现代JS运行的任何地方的作品——浏览器,节点18+,回放土著,Cloudflare工人,德诺,邦.

📚 完整文档: ack-solutions.github.io/nst-auth/docs/客户

为什么用它

官方客户端 @ackplus/nest-auth 后端 。 直接从Vue、Angular、Svelte、vanilla JS那里使用,或作为基金会 @ackplus/nest-auth-react。 。 。 .

它处理亲笔写作的活泼部分: 符号持续, 401 上自动刷新并同时请求去除, cookie/header 模式切换, MFA 流量,多租户上下文,以及一个事件订阅 API.

安装

pnpm add @ackplus/nest-auth-client

无对等依存. 软件包中TypeScript定义船.

最小示例

import { AuthClient } from '@ackplus/nest-auth-client';

const auth = new AuthClient({
  baseUrl: 'https://api.example.com',
});

await auth.signup({
  email: '[email protected]',
  password: 'correct horse battery staple',
  firstName: 'Alice',     // any extra field flows through to UserRegisteredEvent
});

await auth.login({
  credentials: { email: '[email protected]', password: 'correct horse battery staple' },
});

if (auth.getIsAuthenticated()) {
  const user = await auth.getSessionUserData();
  console.log('Hello', user.email);
}

包括什么

配置

new AuthClient({
  baseUrl: 'https://api.example.com',
  storage: new LocalStorageAdapter('myapp_'),
  httpAdapter: new FetchAdapter(),
  accessTokenType: 'header',     // or 'cookie' or null (auto-detect)
  autoRefresh: true,
  refreshThreshold: 60,          // seconds before expiry
  onTokenRefreshed: (tokens) => { /* … */ },
  onLogout: () => { window.location.href = '/login'; },
  onError: (err) => console.error(err),
});

完全配置参考 {}

原生反应

import AsyncStorage from '@react-native-async-storage/async-storage';
import { AuthClient, type StorageAdapter } from '@ackplus/nest-auth-client';

const RNStorage: StorageAdapter = {
  get:    (k) => AsyncStorage.getItem(k),
  set:    (k, v) => AsyncStorage.setItem(k, v),
  remove: (k) => AsyncStorage.removeItem(k),
  clear:  () => AsyncStorage.clear(),
};

export const auth = new AuthClient({
  baseUrl: 'https://api.example.com',
  storage: RNStorage,
});

文档

配套软件包

所有4个包都与同版本号一起放出. 把它们绑在同一个版本.

链接

• 📚 文档
• 💬 问题跟踪器
• 📦 GitHub 仓库

许可证

麻省理工学院