@digitalsee/login-sdk

Headless Login SDK for Digitalsee IAM Login V2.

它只负责认证状态机、配置加载、核心认证 API、错误、事件、存储和语义 Screen 导航；不提供 UI。IAM-Login/src/pages/login-v2 负责模板、Widget、默认 Screen 和远程 Screen 渲染。

安装

IAM-Login 当前通过本地依赖消费：

{
  "@digitalsee/login-sdk": "file:../digitalsee-login-sdk"
}

独立发布后可按 npm 包安装：

pnpm add @digitalsee/login-sdk

最小接入

import { LoginSDKProvider, usePasswordLogin } from '@digitalsee/login-sdk';

function App() {
  return (
    <LoginSDKProvider
      clientId="usercenter"
      tcode="bit"
      options={{ debug: import.meta.env.DEV }}
    >
      <LoginPage />
    </LoginSDKProvider>
  );
}

function LoginPage() {
  const { login, isLogging } = usePasswordLogin();

  return (
    <button disabled={isLogging} onClick={() => login('username', 'password')}>
      Login
    </button>
  );
}

如果需要覆盖 API 域名或端点，请放到 options 中：

<LoginSDKProvider
  clientId="usercenter"
  tcode="bit"
  options={{
    baseURL: 'https://iam.example.com',
    apiEndpoints: {
      loginHello: '/iam/login/login_hello',
    },
  }}
>
  <LoginPage />
</LoginSDKProvider>

文档

• DOCS-INDEX.md
• QUICK-START.md
• docs/API-REFERENCE.md
• docs/ARCHITECTURE.md
• docs/BEST-PRACTICES.md