nexus-auth-sdk 4.1.0

package/index.d.ts

@@ -0,0 +1,42 @@
+declare module '@authcore/sdk' {
+  interface AuthCoreConfig {
+    apiKey: string;
+    baseUrl?: string;
+  }
+
+  interface RegisterParams {
+    email: string;
+    password: string;
+    username?: string;
+  }
+
+  interface LoginParams {
+    email: string;
+    password: string;
+  }
+
+  interface AuthResponse {
+    token: string;
+    user: {
+      id: string;
+      email: string;
+      username: string;
+    };
+  }
+
+  interface VerifyResponse {
+    valid: boolean;
+    user?: {
+      id: string;
+      email: string;
+      username: string;
+    };
+  }
+
+  export class AuthCore {
+    constructor(config: AuthCoreConfig);
+    register(params: RegisterParams): Promise<AuthResponse>;
+    login(params: LoginParams): Promise<AuthResponse>;
+    verify(token: string): Promise<VerifyResponse>;
+  }
+}

package/index.js

@@ -0,0 +1,52 @@
+/**
+ * nexus-auth-sdk — Auth as a Service
+ * npm install nexus-auth-sdk
+ *
+ * const { AuthCore } = require('nexus-auth-sdk');
+ * const auth = new AuthCore({ apiKey: 'nx_xxx' });
+ * const { token, user } = await auth.register({ email, password, username });
+ */
+
+const API = 'https://auth.miaogou.site/api';
+
+class AuthCore {
+  constructor(config = {}) {
+    if (!config.apiKey) throw new Error('[AuthCore] apiKey is required. Get yours at https://auth.miaogou.site');
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || API;
+  }
+
+  async _fetch(path, body) {
+    const res = await fetch(this.baseUrl + path, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'X-API-Key': this.apiKey },
+      body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.message || data.error || `AuthCore API error: ${res.status}`);
+    return data;
+  }
+
+  /** Register a new user. Returns { token, user }. */
+  async register({ email, password, username }) {
+    if (!email || !password) throw new Error('[AuthCore] email and password are required');
+    if (password.length < 8) throw new Error('[AuthCore] password must be at least 8 characters');
+    return this._fetch('/auth/register', { email, password, username: username || email.split('@')[0] });
+  }
+
+  /** Login an existing user. Returns { token, user }. */
+  async login({ email, password }) {
+    if (!email || !password) throw new Error('[AuthCore] email and password are required');
+    return this._fetch('/auth/login', { email, password });
+  }
+
+  /** Verify a JWT token. Returns { valid, user? }. */
+  async verify(token) {
+    if (!token) throw new Error('[AuthCore] token is required');
+    return this._fetch('/auth/authenticate', { token });
+  }
+}
+
+// ESM and CJS compatible
+module.exports = { AuthCore };
+if (typeof exports !== 'undefined') exports.AuthCore = AuthCore;

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "nexus-auth-sdk",
+  "version": "4.1.0",
+  "description": "AuthCore — 认证即服务 SDK。为你的应用添加用户注册、登录、Token 验证，3 行代码接入。",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": ["index.js", "index.d.ts", "react.js", "react.d.ts"],
+  "keywords": ["auth", "authentication", "jwt", "authcore", "login", "register"],
+  "license": "MIT",
+  "repository": "https://github.com/kwan/authcore-sdk"
+}

package/react.js

@@ -0,0 +1,106 @@
+/**
+ * nexus-auth-sdk/react — React bindings for AuthCore
+ *
+ * <AuthCoreProvider apiKey="nx_xxx">
+ *   <SignIn />
+ * </AuthCoreProvider>
+ */
+
+const React = require('react');
+const { AuthCore } = require('./index');
+
+const AuthCoreContext = React.createContext(null);
+
+/** Wrap your app with this provider to enable AuthCore hooks. */
+function AuthCoreProvider({ apiKey, baseUrl, children }) {
+  const [client] = React.useState(() => new AuthCore({ apiKey, baseUrl }));
+  const [user, setUser] = React.useState(null);
+  const [token, setToken] = React.useState(null);
+
+  const value = React.useMemo(() => ({
+    client,
+    user, setUser,
+    token, setToken,
+    isSignedIn: !!token,
+    signOut: () => { setToken(null); setUser(null); },
+  }), [client, user, token]);
+
+  return React.createElement(AuthCoreContext.Provider, { value }, children);
+}
+
+/** Hook to access the AuthCore client and user state. */
+function useAuthCore() {
+  const ctx = React.useContext(AuthCoreContext);
+  if (!ctx) throw new Error('useAuthCore must be used within <AuthCoreProvider>');
+  return ctx;
+}
+
+/** Sign-in form component with email/password. */
+function SignIn({ onSuccess, className }) {
+  const { client, setUser, setToken } = useAuthCore();
+  const [email, setEmail] = React.useState('');
+  const [password, setPassword] = React.useState('');
+  const [error, setError] = React.useState('');
+  const [loading, setLoading] = React.useState(false);
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    setError('');
+    setLoading(true);
+    try {
+      const result = await client.login({ email, password });
+      setToken(result.token);
+      setUser(result.user);
+      onSuccess && onSuccess(result);
+    } catch (err) {
+      setError(err.message);
+    }
+    setLoading(false);
+  };
+
+  return React.createElement('form', { onSubmit: handleSubmit, className, style: { display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 } },
+    error && React.createElement('div', { style: { color: '#e05a5a', fontSize: 13, padding: '8px 12px', background: '#fee2e2', borderRadius: 8 } }, error),
+    React.createElement('input', { type: 'email', placeholder: '邮箱', value: email, onChange: e => setEmail(e.target.value), required: true, style: { padding: '10px 14px', borderRadius: 8, border: '2px solid #c4b89e', fontSize: 14 } }),
+    React.createElement('input', { type: 'password', placeholder: '密码', value: password, onChange: e => setPassword(e.target.value), required: true, style: { padding: '10px 14px', borderRadius: 8, border: '2px solid #c4b89e', fontSize: 14 } }),
+    React.createElement('button', { type: 'submit', disabled: loading, style: { padding: '10px 20px', background: '#19c8b9', color: '#fff', border: 'none', borderRadius: 50, fontWeight: 700, cursor: 'pointer', fontSize: 14 } },
+      loading ? '登录中...' : '登录'
+    )
+  );
+}
+
+/** Sign-up form component with email/password/username. */
+function SignUp({ onSuccess, className }) {
+  const { client, setUser, setToken } = useAuthCore();
+  const [email, setEmail] = React.useState('');
+  const [password, setPassword] = React.useState('');
+  const [username, setUsername] = React.useState('');
+  const [error, setError] = React.useState('');
+  const [loading, setLoading] = React.useState(false);
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    setError('');
+    setLoading(true);
+    try {
+      const result = await client.register({ email, password, username });
+      setToken(result.token);
+      setUser(result.user);
+      onSuccess && onSuccess(result);
+    } catch (err) {
+      setError(err.message);
+    }
+    setLoading(false);
+  };
+
+  return React.createElement('form', { onSubmit: handleSubmit, className, style: { display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 } },
+    error && React.createElement('div', { style: { color: '#e05a5a', fontSize: 13, padding: '8px 12px', background: '#fee2e2', borderRadius: 8 } }, error),
+    React.createElement('input', { type: 'text', placeholder: '用户名', value: username, onChange: e => setUsername(e.target.value), style: { padding: '10px 14px', borderRadius: 8, border: '2px solid #c4b89e', fontSize: 14 } }),
+    React.createElement('input', { type: 'email', placeholder: '邮箱', value: email, onChange: e => setEmail(e.target.value), required: true, style: { padding: '10px 14px', borderRadius: 8, border: '2px solid #c4b89e', fontSize: 14 } }),
+    React.createElement('input', { type: 'password', placeholder: '密码（8位+，含大小写和数字）', value: password, onChange: e => setPassword(e.target.value), required: true, style: { padding: '10px 14px', borderRadius: 8, border: '2px solid #c4b89e', fontSize: 14 } }),
+    React.createElement('button', { type: 'submit', disabled: loading, style: { padding: '10px 20px', background: '#19c8b9', color: '#fff', border: 'none', borderRadius: 50, fontWeight: 700, cursor: 'pointer', fontSize: 14 } },
+      loading ? '注册中...' : '注册'
+    )
+  );
+}
+
+module.exports = { AuthCoreProvider, useAuthCore, SignIn, SignUp };