sa2kit 1.6.10 → 1.6.12

package/dist/auth/index.js

@@ -1,41 +1,24 @@
 'use strict';
 
+var chunkFAHLZIYQ_js = require('../chunk-FAHLZIYQ.js');
 var chunkCD77U7LZ_js = require('../chunk-CD77U7LZ.js');
 var chunk6W5BMXJG_js = require('../chunk-6W5BMXJG.js');
-var chunkO26VCNS3_js = require('../chunk-O26VCNS3.js');
-var chunkROEYW4A7_js = require('../chunk-ROEYW4A7.js');
+var chunkUOFTHYIH_js = require('../chunk-UOFTHYIH.js');
+var chunk5QMBZP7S_js = require('../chunk-5QMBZP7S.js');
 var chunkDUHZ7VZP_js = require('../chunk-DUHZ7VZP.js');
 var chunkSVWQN2LR_js = require('../chunk-SVWQN2LR.js');
 require('../chunk-DGUM43GV.js');
 
-// src/auth/server.ts
-async function validateApiAuth(request) {
-  try {
-    const token = chunkDUHZ7VZP_js.getTokenFromRequest(request);
-    if (!token) return null;
-    const secret = process.env.JWT_SECRET || "your-secret-key";
-    const payload = await chunkDUHZ7VZP_js.verifyJwtToken(token, secret);
-    if (!payload || !payload.userId) return null;
-    return {
-      id: payload.userId,
-      email: payload.email,
-      username: payload.username,
-      role: payload.role
-    };
-  } catch (error) {
-    console.error("API \u8EAB\u4EFD\u9A8C\u8BC1\u5931\u8D25:", error);
-    return null;
-  }
-}
-async function validateApiAuthNumeric(request) {
-  const user2 = await validateApiAuth(request);
-  if (!user2) return null;
-  return {
-    ...user2,
-    id: parseInt(user2.id, 10)
-  };
-}
 
+
+Object.defineProperty(exports, "validateApiAuth", {
+  enumerable: true,
+  get: function () { return chunkFAHLZIYQ_js.validateApiAuth; }
+});
+Object.defineProperty(exports, "validateApiAuthNumeric", {
+  enumerable: true,
+  get: function () { return chunkFAHLZIYQ_js.validateApiAuthNumeric; }
+});
 Object.defineProperty(exports, "createAnalyticsAdapter", {
   enumerable: true,
   get: function () { return chunkCD77U7LZ_js.createAnalyticsAdapter; }
@@ -90,23 +73,23 @@ Object.defineProperty(exports, "createAuthMiddleware", {
 });
 Object.defineProperty(exports, "API_ROUTES", {
   enumerable: true,
-  get: function () { return chunkO26VCNS3_js.API_ROUTES; }
+  get: function () { return chunkUOFTHYIH_js.API_ROUTES; }
 });
 Object.defineProperty(exports, "BaseApiClient", {
   enumerable: true,
-  get: function () { return chunkO26VCNS3_js.BaseApiClient; }
+  get: function () { return chunkUOFTHYIH_js.BaseApiClient; }
 });
 Object.defineProperty(exports, "STORAGE_KEYS", {
   enumerable: true,
-  get: function () { return chunkO26VCNS3_js.STORAGE_KEYS; }
+  get: function () { return chunkUOFTHYIH_js.STORAGE_KEYS; }
 });
 Object.defineProperty(exports, "useAuth", {
   enumerable: true,
-  get: function () { return chunkROEYW4A7_js.useAuth; }
+  get: function () { return chunk5QMBZP7S_js.useAuth; }
 });
 Object.defineProperty(exports, "useAuthForm", {
   enumerable: true,
-  get: function () { return chunkROEYW4A7_js.useAuthForm; }
+  get: function () { return chunk5QMBZP7S_js.useAuthForm; }
 });
 Object.defineProperty(exports, "DrizzleAuthService", {
   enumerable: true,
@@ -164,7 +147,5 @@ Object.defineProperty(exports, "verifications", {
   enumerable: true,
   get: function () { return chunkSVWQN2LR_js.verifications; }
 });
-exports.validateApiAuth = validateApiAuth;
-exports.validateApiAuthNumeric = validateApiAuthNumeric;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/auth/server.ts"],"names":["getTokenFromRequest","verifyJwtToken","user"],"mappings":";;;;;;;;;;;AAOA,eAAsB,gBAAgB,OAAA,EAAsB;AAC1D,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAQA,qCAAoB,OAAO,CAAA;AACzC,IAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AAInB,IAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,iBAAA;AACzC,IAAA,MAAM,OAAA,GAAU,MAAMC,+BAAA,CAAe,KAAA,EAAO,MAAM,CAAA;AAElD,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,OAAA,CAAQ,QAAQ,OAAO,IAAA;AAExC,IAAA,OAAO;AAAA,MACL,IAAI,OAAA,CAAQ,MAAA;AAAA,MACZ,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,MAAM,OAAA,CAAQ;AAAA,KAChB;AAAA,EACF,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,KAAA,CAAM,6CAAe,KAAK,CAAA;AAClC,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAMA,eAAsB,uBAAuB,OAAA,EAAsB;AACjE,EAAA,MAAMC,KAAAA,GAAO,MAAM,eAAA,CAAgB,OAAO,CAAA;AAC1C,EAAA,IAAI,CAACA,OAAM,OAAO,IAAA;AAElB,EAAA,OAAO;AAAA,IACL,GAAGA,KAAAA;AAAA,IACH,EAAA,EAAI,QAAA,CAASA,KAAAA,CAAK,EAAA,EAAI,EAAE;AAAA,GAC1B;AACF","file":"index.js","sourcesContent":["import { NextRequest } from 'next/server';\nimport { getTokenFromRequest, verifyJwtToken } from './services';\n\n/**\n * 验证 API 请求的身份\n * 从请求头中获取 Token 并验证，返回用户信息\n */\nexport async function validateApiAuth(request: NextRequest) {\n  try {\n    const token = getTokenFromRequest(request);\n    if (!token) return null;\n\n    // 注意：这里需要 JWT_SECRET，在演示环境中可能没有\n    // 这是一个基础实现，实际使用时需要确保环境变量正确\n    const secret = process.env.JWT_SECRET || 'your-secret-key';\n    const payload = await verifyJwtToken(token, secret);\n    \n    if (!payload || !payload.userId) return null;\n\n    return {\n      id: payload.userId,\n      email: payload.email,\n      username: payload.username,\n      role: payload.role,\n    };\n  } catch (error) {\n    console.error('API 身份验证失败:', error);\n    return null;\n  }\n}\n\n/**\n * 验证 API 请求的身份（针对使用数字 ID 的项目）\n * 将 string 类型的 userId 转换为 number 类型\n */\nexport async function validateApiAuthNumeric(request: NextRequest) {\n  const user = await validateApiAuth(request);\n  if (!user) return null;\n  \n  return {\n    ...user,\n    id: parseInt(user.id, 10)\n  };\n}\n\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/auth/index.mjs

@@ -1,40 +1,10 @@
+export { validateApiAuth, validateApiAuthNumeric } from '../chunk-6BZ3QFA5.mjs';
 export { createAnalyticsAdapter, createDefaultBaseConfig, createDefaultLoginConfig, createDefaultRegisterConfig, createLoginHandler, createLoginOptionsHandler, createLogoutHandler, createLogoutOptionsHandler, createMeHandler, createMeOptionsHandler, createRegisterHandler, createRegisterOptionsHandler } from '../chunk-QAT2RWAO.mjs';
 export { createAuthMiddleware } from '../chunk-ESRCX5TQ.mjs';
-export { API_ROUTES, BaseApiClient, STORAGE_KEYS } from '../chunk-HEMA7SWK.mjs';
-export { useAuth, useAuthForm } from '../chunk-KGRQNEIR.mjs';
-import { getTokenFromRequest, verifyJwtToken } from '../chunk-OCR5DS4C.mjs';
+export { API_ROUTES, BaseApiClient, STORAGE_KEYS } from '../chunk-6YKMCPQI.mjs';
+export { useAuth, useAuthForm } from '../chunk-KW5JH6V6.mjs';
 export { DrizzleAuthService, generateToken, getTokenFromRequest, hashPassword, verifyJwtToken, verifyPassword } from '../chunk-OCR5DS4C.mjs';
 export { account, accountRelations, session, sessionRelations, user, userRelations, userRole, verifications } from '../chunk-AIKEVVDR.mjs';
 import '../chunk-BJTO5JO5.mjs';
-
-// src/auth/server.ts
-async function validateApiAuth(request) {
-  try {
-    const token = getTokenFromRequest(request);
-    if (!token) return null;
-    const secret = process.env.JWT_SECRET || "your-secret-key";
-    const payload = await verifyJwtToken(token, secret);
-    if (!payload || !payload.userId) return null;
-    return {
-      id: payload.userId,
-      email: payload.email,
-      username: payload.username,
-      role: payload.role
-    };
-  } catch (error) {
-    console.error("API \u8EAB\u4EFD\u9A8C\u8BC1\u5931\u8D25:", error);
-    return null;
-  }
-}
-async function validateApiAuthNumeric(request) {
-  const user2 = await validateApiAuth(request);
-  if (!user2) return null;
-  return {
-    ...user2,
-    id: parseInt(user2.id, 10)
-  };
-}
-
-export { validateApiAuth, validateApiAuthNumeric };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/auth/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/auth/server.ts"],"names":["user"],"mappings":";;;;;;;;;;AAOA,eAAsB,gBAAgB,OAAA,EAAsB;AAC1D,EAAA,IAAI;AACF,IAAA,MAAM,KAAA,GAAQ,oBAAoB,OAAO,CAAA;AACzC,IAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AAInB,IAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,iBAAA;AACzC,IAAA,MAAM,OAAA,GAAU,MAAM,cAAA,CAAe,KAAA,EAAO,MAAM,CAAA;AAElD,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,OAAA,CAAQ,QAAQ,OAAO,IAAA;AAExC,IAAA,OAAO;AAAA,MACL,IAAI,OAAA,CAAQ,MAAA;AAAA,MACZ,OAAO,OAAA,CAAQ,KAAA;AAAA,MACf,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,MAAM,OAAA,CAAQ;AAAA,KAChB;AAAA,EACF,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,KAAA,CAAM,6CAAe,KAAK,CAAA;AAClC,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAMA,eAAsB,uBAAuB,OAAA,EAAsB;AACjE,EAAA,MAAMA,KAAAA,GAAO,MAAM,eAAA,CAAgB,OAAO,CAAA;AAC1C,EAAA,IAAI,CAACA,OAAM,OAAO,IAAA;AAElB,EAAA,OAAO;AAAA,IACL,GAAGA,KAAAA;AAAA,IACH,EAAA,EAAI,QAAA,CAASA,KAAAA,CAAK,EAAA,EAAI,EAAE;AAAA,GAC1B;AACF","file":"index.mjs","sourcesContent":["import { NextRequest } from 'next/server';\nimport { getTokenFromRequest, verifyJwtToken } from './services';\n\n/**\n * 验证 API 请求的身份\n * 从请求头中获取 Token 并验证，返回用户信息\n */\nexport async function validateApiAuth(request: NextRequest) {\n  try {\n    const token = getTokenFromRequest(request);\n    if (!token) return null;\n\n    // 注意：这里需要 JWT_SECRET，在演示环境中可能没有\n    // 这是一个基础实现，实际使用时需要确保环境变量正确\n    const secret = process.env.JWT_SECRET || 'your-secret-key';\n    const payload = await verifyJwtToken(token, secret);\n    \n    if (!payload || !payload.userId) return null;\n\n    return {\n      id: payload.userId,\n      email: payload.email,\n      username: payload.username,\n      role: payload.role,\n    };\n  } catch (error) {\n    console.error('API 身份验证失败:', error);\n    return null;\n  }\n}\n\n/**\n * 验证 API 请求的身份（针对使用数字 ID 的项目）\n * 将 string 类型的 userId 转换为 number 类型\n */\nexport async function validateApiAuthNumeric(request: NextRequest) {\n  const user = await validateApiAuth(request);\n  if (!user) return null;\n  \n  return {\n    ...user,\n    id: parseInt(user.id, 10)\n  };\n}\n\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/auth/middleware/index.d.mts

@@ -0,0 +1,75 @@
+import { D as DrizzleAuthService, U as UserInfo, S as SessionInfo } from '../../drizzle-auth-service-DZY2F1sv.mjs';
+import '../../enums-Dume-V5Y.mjs';
+import 'drizzle-orm/pg-core';
+
+/**
+ * Auth Middleware - Types
+ * 认证中间件类型定义
+ */
+
+/**
+ * 认证级别
+ */
+type AuthLevel = 'none' | 'user' | 'admin' | 'super_admin';
+/**
+ * 路由上下文
+ */
+interface RouteContext {
+    /**
+     * 用户信息（认证后注入）
+     */
+    user?: UserInfo;
+    /**
+     * 会话信息（认证后注入）
+     */
+    session?: SessionInfo;
+    /**
+     * 路由参数
+     */
+    params?: any;
+}
+/**
+ * 路由处理器
+ */
+type RouteHandler = (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * 认证中间件配置
+ */
+interface AuthMiddlewareConfig {
+    /**
+     * 认证服务实例
+     */
+    authService: DrizzleAuthService;
+}
+
+/**
+ * Auth Middleware - withAuth
+ * 认证中间件
+ */
+
+/**
+ * 创建认证中间件
+ *
+ * @example
+ * ```typescript
+ * import { createAuthMiddleware } from '@qhr123/sa2kit/auth/middleware';
+ *
+ * const { withAuth, requireAdmin } = createAuthMiddleware({
+ *   authService: myAuthService,
+ * });
+ *
+ * // 使用中间件
+ * export const GET = requireAdmin(async (request, context) => {
+ *   const { user } = context; // 自动注入用户信息
+ *   // ... 业务逻辑
+ * });
+ * ```
+ */
+declare function createAuthMiddleware(config: AuthMiddlewareConfig): {
+    withAuth: (handler: RouteHandler, level?: AuthLevel) => RouteHandler;
+    requireAuth: (handler: RouteHandler) => RouteHandler;
+    requireAdmin: (handler: RouteHandler) => RouteHandler;
+    requireSuperAdmin: (handler: RouteHandler) => RouteHandler;
+};
+
+export { type AuthLevel, type AuthMiddlewareConfig, type RouteContext, type RouteHandler, createAuthMiddleware };

package/dist/auth/middleware/index.d.ts

@@ -0,0 +1,75 @@
+import { D as DrizzleAuthService, U as UserInfo, S as SessionInfo } from '../../drizzle-auth-service-Bxlovhv8.js';
+import '../../enums-Dume-V5Y.js';
+import 'drizzle-orm/pg-core';
+
+/**
+ * Auth Middleware - Types
+ * 认证中间件类型定义
+ */
+
+/**
+ * 认证级别
+ */
+type AuthLevel = 'none' | 'user' | 'admin' | 'super_admin';
+/**
+ * 路由上下文
+ */
+interface RouteContext {
+    /**
+     * 用户信息（认证后注入）
+     */
+    user?: UserInfo;
+    /**
+     * 会话信息（认证后注入）
+     */
+    session?: SessionInfo;
+    /**
+     * 路由参数
+     */
+    params?: any;
+}
+/**
+ * 路由处理器
+ */
+type RouteHandler = (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * 认证中间件配置
+ */
+interface AuthMiddlewareConfig {
+    /**
+     * 认证服务实例
+     */
+    authService: DrizzleAuthService;
+}
+
+/**
+ * Auth Middleware - withAuth
+ * 认证中间件
+ */
+
+/**
+ * 创建认证中间件
+ *
+ * @example
+ * ```typescript
+ * import { createAuthMiddleware } from '@qhr123/sa2kit/auth/middleware';
+ *
+ * const { withAuth, requireAdmin } = createAuthMiddleware({
+ *   authService: myAuthService,
+ * });
+ *
+ * // 使用中间件
+ * export const GET = requireAdmin(async (request, context) => {
+ *   const { user } = context; // 自动注入用户信息
+ *   // ... 业务逻辑
+ * });
+ * ```
+ */
+declare function createAuthMiddleware(config: AuthMiddlewareConfig): {
+    withAuth: (handler: RouteHandler, level?: AuthLevel) => RouteHandler;
+    requireAuth: (handler: RouteHandler) => RouteHandler;
+    requireAdmin: (handler: RouteHandler) => RouteHandler;
+    requireSuperAdmin: (handler: RouteHandler) => RouteHandler;
+};
+
+export { type AuthLevel, type AuthMiddlewareConfig, type RouteContext, type RouteHandler, createAuthMiddleware };

package/dist/auth/routes/index.d.mts

@@ -0,0 +1,261 @@
+import { D as DrizzleAuthService } from '../../drizzle-auth-service-DZY2F1sv.mjs';
+import '../../enums-Dume-V5Y.mjs';
+import 'drizzle-orm/pg-core';
+
+/**
+ * Auth Routes - Types
+ * 路由处理器类型定义
+ */
+
+/**
+ * 基础路由配置
+ */
+interface BaseRouteConfig {
+    /**
+     * 认证服务实例
+     */
+    authService: DrizzleAuthService;
+    /**
+     * 可选的 Analytics 服务
+     */
+    analytics?: {
+        track: (eventName: string, properties: any) => Promise<void>;
+    };
+    /**
+     * CORS 配置
+     */
+    cors?: {
+        enabled?: boolean;
+        origin?: string | string[];
+        methods?: string[];
+        allowedHeaders?: string[];
+        credentials?: boolean;
+    };
+}
+/**
+ * 登录路由配置
+ */
+interface LoginRouteConfig extends BaseRouteConfig {
+    /**
+     * Cookie 配置
+     */
+    cookieOptions?: {
+        name?: string;
+        httpOnly?: boolean;
+        secure?: boolean;
+        sameSite?: 'strict' | 'lax' | 'none';
+        maxAge?: number;
+        path?: string;
+    };
+}
+/**
+ * 注册路由配置
+ */
+interface RegisterRouteConfig extends BaseRouteConfig {
+    /**
+     * 默认角色
+     */
+    defaultRole?: 'USER' | 'ADMIN' | 'SUPER_ADMIN';
+    /**
+     * 是否需要邮箱验证
+     */
+    emailVerificationRequired?: boolean;
+    /**
+     * Cookie 配置
+     */
+    cookieOptions?: {
+        name?: string;
+        httpOnly?: boolean;
+        secure?: boolean;
+        sameSite?: 'strict' | 'lax' | 'none';
+        maxAge?: number;
+        path?: string;
+    };
+}
+/**
+ * 标准 API 响应
+ */
+interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    message?: string;
+}
+
+/**
+ * Auth Routes - Login
+ * 登录路由处理器
+ */
+
+/**
+ * 创建登录路由处理器
+ *
+ * @example
+ * ```typescript
+ * import { createLoginHandler } from 'sa2kit/auth/routes';
+ *
+ * export const POST = createLoginHandler({
+ *   authService: myAuthService,
+ *   analytics: myAnalytics,
+ *   cors: { enabled: true },
+ * });
+ * ```
+ */
+declare function createLoginHandler(config: LoginRouteConfig): (request: Request) => Promise<Response>;
+/**
+ * 创建 CORS 预检请求处理器
+ */
+declare function createLoginOptionsHandler(config: LoginRouteConfig): (request: Request) => Promise<Response>;
+
+/**
+ * Auth Routes - Register
+ * 注册路由处理器
+ */
+
+/**
+ * 创建注册路由处理器
+ *
+ * @example
+ * ```typescript
+ * import { createRegisterHandler } from 'sa2kit/auth/routes';
+ *
+ * export const POST = createRegisterHandler({
+ *   authService: myAuthService,
+ *   defaultRole: 'USER',
+ *   cors: { enabled: true },
+ * });
+ * ```
+ */
+declare function createRegisterHandler(config: RegisterRouteConfig): (request: Request) => Promise<Response>;
+/**
+ * 创建 CORS 预检请求处理器
+ */
+declare function createRegisterOptionsHandler(config: RegisterRouteConfig): (request: Request) => Promise<Response>;
+
+/**
+ * Auth Routes - Me
+ * 获取当前用户信息路由处理器
+ */
+
+/**
+ * 创建获取当前用户信息路由处理器
+ *
+ * @example
+ * ```typescript
+ * import { createMeHandler } from 'sa2kit/auth/routes';
+ *
+ * export const GET = createMeHandler({
+ *   authService: myAuthService,
+ *   cors: { enabled: true },
+ * });
+ * ```
+ */
+declare function createMeHandler(config: BaseRouteConfig): (request: Request) => Promise<Response>;
+/**
+ * 创建 CORS 预检请求处理器
+ */
+declare function createMeOptionsHandler(config: BaseRouteConfig): (request: Request) => Promise<Response>;
+
+/**
+ * Auth Routes - Logout
+ * 登出路由处理器
+ */
+
+/**
+ * 创建登出路由处理器
+ *
+ * @example
+ * ```typescript
+ * import { createLogoutHandler } from 'sa2kit/auth/routes';
+ *
+ * export const POST = createLogoutHandler({
+ *   authService: myAuthService,
+ *   cors: { enabled: true },
+ * });
+ * ```
+ */
+declare function createLogoutHandler(config: BaseRouteConfig): (request: Request) => Promise<Response>;
+/**
+ * 创建 CORS 预检请求处理器
+ */
+declare function createLogoutOptionsHandler(config: BaseRouteConfig): (request: Request) => Promise<Response>;
+
+/**
+ * Auth Routes - Default Configurations
+ * 默认路由配置
+ */
+
+/**
+ * 创建默认的基础路由配置
+ */
+declare function createDefaultBaseConfig(authService: DrizzleAuthService, overrides?: Partial<BaseRouteConfig>): BaseRouteConfig;
+/**
+ * 创建默认的登录路由配置
+ */
+declare function createDefaultLoginConfig(authService: DrizzleAuthService, overrides?: Partial<LoginRouteConfig>): LoginRouteConfig;
+/**
+ * 创建默认的注册路由配置
+ */
+declare function createDefaultRegisterConfig(authService: DrizzleAuthService, overrides?: Partial<RegisterRouteConfig>): RegisterRouteConfig;
+
+/**
+ * Auth Routes - Analytics Adapter
+ * 埋点适配器，用于适配不同的埋点服务
+ */
+/**
+ * 埋点事件接口
+ */
+interface AnalyticsEvent {
+    id: string;
+    eventType: string;
+    eventName: string;
+    timestamp: string;
+    priority: number;
+    userId: string;
+    sessionId: string;
+    deviceId: string;
+    platform: string;
+    appVersion: string;
+    sdkVersion: string;
+    properties: Record<string, any>;
+}
+/**
+ * 埋点服务接口
+ */
+interface AnalyticsService {
+    insertAnalyticsEvents(events: AnalyticsEvent[]): Promise<void>;
+}
+/**
+ * 创建埋点适配器
+ *
+ * @param analyticsService 埋点服务实例
+ * @param options 可选配置
+ * @returns 符合 sa2kit 格式的埋点函数
+ *
+ * @example
+ * ```typescript
+ * import { createAnalyticsAdapter } from 'sa2kit/auth/routes';
+ * import { analyticsService } from '@/lib/analytics';
+ *
+ * const analytics = createAnalyticsAdapter(analyticsService, {
+ *   platform: 'backend',
+ *   appVersion: '1.0.0',
+ * });
+ *
+ * // 在路由配置中使用
+ * const config = createDefaultLoginConfig(authService, {
+ *   analytics,
+ * });
+ * ```
+ */
+declare function createAnalyticsAdapter(analyticsService: AnalyticsService, options?: {
+    platform?: string;
+    appVersion?: string;
+    sdkVersion?: string;
+    deviceId?: string;
+    generateId?: () => string;
+}): {
+    track: (eventName: string, properties: any) => Promise<void>;
+};
+
+export { type AnalyticsEvent, type AnalyticsService, type ApiResponse, type BaseRouteConfig, type LoginRouteConfig, type RegisterRouteConfig, createAnalyticsAdapter, createDefaultBaseConfig, createDefaultLoginConfig, createDefaultRegisterConfig, createLoginHandler, createLoginOptionsHandler, createLogoutHandler, createLogoutOptionsHandler, createMeHandler, createMeOptionsHandler, createRegisterHandler, createRegisterOptionsHandler };