sa2kit 1.0.0

package/dist/config/index.d.mts

@@ -0,0 +1,64 @@
+/**
+ * Config 模块类型定义
+ */
+interface ConfigItem {
+    key: string;
+    value: any;
+    type: string;
+    isRequired: boolean;
+    isSensitive: boolean;
+    description?: string;
+    defaultValue?: any;
+    readonly?: boolean;
+}
+interface AllConfigs {
+    [category: string]: {
+        [key: string]: ConfigItem;
+    };
+}
+interface UseConfigsOptions {
+    /**
+     * API 基础 URL
+     */
+    apiBaseUrl?: string;
+    /**
+     * 获取认证 token 的函数
+     */
+    getAuthToken: () => string | null | Promise<string | null>;
+    /**
+     * 未认证时的回调（可选）
+     */
+    onUnauthorized?: () => void;
+    /**
+     * 缓存去重时间（毫秒）
+     */
+    dedupingInterval?: number;
+    /**
+     * 是否在窗口聚焦时重新验证
+     */
+    revalidateOnFocus?: boolean;
+}
+
+/**
+ * 创建 useConfigs Hook
+ */
+declare function createUseConfigs(options: UseConfigsOptions): () => {
+    configs: AllConfigs | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: any;
+    updateConfigs: (category: string, updates: Record<string, any>) => Promise<{
+        success: boolean;
+    }>;
+    refresh: () => void;
+};
+/**
+ * 预加载配置
+ */
+declare function prefetchConfigs(apiBaseUrl?: string): void;
+/**
+ * 全局缓存失效
+ */
+declare function invalidateAllConfigs(apiBaseUrl?: string): void;
+
+export { type AllConfigs, type ConfigItem, type UseConfigsOptions, createUseConfigs, invalidateAllConfigs, prefetchConfigs };

package/dist/config/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Config 模块类型定义
+ */
+interface ConfigItem {
+    key: string;
+    value: any;
+    type: string;
+    isRequired: boolean;
+    isSensitive: boolean;
+    description?: string;
+    defaultValue?: any;
+    readonly?: boolean;
+}
+interface AllConfigs {
+    [category: string]: {
+        [key: string]: ConfigItem;
+    };
+}
+interface UseConfigsOptions {
+    /**
+     * API 基础 URL
+     */
+    apiBaseUrl?: string;
+    /**
+     * 获取认证 token 的函数
+     */
+    getAuthToken: () => string | null | Promise<string | null>;
+    /**
+     * 未认证时的回调（可选）
+     */
+    onUnauthorized?: () => void;
+    /**
+     * 缓存去重时间（毫秒）
+     */
+    dedupingInterval?: number;
+    /**
+     * 是否在窗口聚焦时重新验证
+     */
+    revalidateOnFocus?: boolean;
+}
+
+/**
+ * 创建 useConfigs Hook
+ */
+declare function createUseConfigs(options: UseConfigsOptions): () => {
+    configs: AllConfigs | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: any;
+    updateConfigs: (category: string, updates: Record<string, any>) => Promise<{
+        success: boolean;
+    }>;
+    refresh: () => void;
+};
+/**
+ * 预加载配置
+ */
+declare function prefetchConfigs(apiBaseUrl?: string): void;
+/**
+ * 全局缓存失效
+ */
+declare function invalidateAllConfigs(apiBaseUrl?: string): void;
+
+export { type AllConfigs, type ConfigItem, type UseConfigsOptions, createUseConfigs, invalidateAllConfigs, prefetchConfigs };

package/dist/config/index.js

@@ -0,0 +1,136 @@
+'use strict';
+
+require('../chunk-DGUM43GV.js');
+var useSWR = require('swr');
+var react = require('react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var useSWR__default = /*#__PURE__*/_interopDefault(useSWR);
+
+function createUseConfigs(options) {
+  const {
+    apiBaseUrl = "",
+    getAuthToken,
+    onUnauthorized,
+    dedupingInterval = 6e4,
+    revalidateOnFocus = false
+  } = options;
+  const fetcher = async (url) => {
+    const token = await getAuthToken();
+    const res = await fetch(`${apiBaseUrl}${url}`, {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      credentials: "include"
+    });
+    if (!res.ok) {
+      if (res.status === 401) {
+        onUnauthorized?.();
+        throw new Error("Unauthorized");
+      }
+      throw new Error("Failed to fetch configs");
+    }
+    const data = await res.json();
+    return data.data;
+  };
+  return function useConfigs() {
+    const {
+      data,
+      error,
+      mutate: mutateConfigs
+    } = useSWR__default.default("/api/admin/config", fetcher, {
+      // 配置选项
+      revalidateOnFocus,
+      revalidateOnReconnect: true,
+      // 网络重连时重新验证
+      dedupingInterval,
+      // 缓存去重时间
+      errorRetryCount: 3,
+      // 错误重试3次
+      errorRetryInterval: 5e3,
+      // 重试间隔5秒
+      shouldRetryOnError: true,
+      // 启用错误重试
+      // 成功时的回调
+      onSuccess: (_data) => {
+        console.log("\u2705 Configs loaded from cache or network");
+      },
+      // 错误时的回调
+      onError: (err) => {
+        console.error("\u274C Failed to load configs:", err);
+      }
+    });
+    const updateConfigs = react.useCallback(
+      async (category, updates) => {
+        const token = await getAuthToken();
+        mutateConfigs(
+          (current) => {
+            if (!current) return current;
+            return {
+              ...current,
+              [category]: {
+                ...current[category],
+                ...Object.entries(updates).reduce((acc, [key, value]) => {
+                  acc[key] = {
+                    ...current[category]?.[key],
+                    value
+                  };
+                  return acc;
+                }, {})
+              }
+            };
+          },
+          false
+          // 不立即重新验证
+        );
+        try {
+          const res = await fetch(`${apiBaseUrl}/api/admin/config/${category}`, {
+            method: "POST",
+            headers: {
+              Authorization: `Bearer ${token}`,
+              "Content-Type": "application/json"
+            },
+            credentials: "include",
+            body: JSON.stringify({ configs: updates })
+          });
+          if (!res.ok) throw new Error("Update failed");
+          mutateConfigs();
+          return { success: true };
+        } catch (error2) {
+          mutateConfigs();
+          throw error2;
+        }
+      },
+      [mutateConfigs, getAuthToken, apiBaseUrl]
+    );
+    const refresh = react.useCallback(() => {
+      mutateConfigs();
+    }, [mutateConfigs]);
+    return {
+      configs: data,
+      isLoading: !error && !data,
+      isError: !!error,
+      error,
+      updateConfigs,
+      refresh
+    };
+  };
+}
+function prefetchConfigs(apiBaseUrl = "") {
+  useSWR.mutate(`${apiBaseUrl}/api/admin/config`);
+}
+function invalidateAllConfigs(apiBaseUrl = "") {
+  useSWR.mutate(
+    (key) => typeof key === "string" && key.startsWith(`${apiBaseUrl}/api/admin/config`),
+    void 0,
+    { revalidate: true }
+  );
+}
+
+exports.createUseConfigs = createUseConfigs;
+exports.invalidateAllConfigs = invalidateAllConfigs;
+exports.prefetchConfigs = prefetchConfigs;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/hooks/useConfigs.ts"],"names":["useSWR","useCallback","error","mutate"],"mappings":"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","file":"index.js","sourcesContent":["'use client';\n\n/**\n * 配置缓存优化 Hook\n *\n * 使用 SWR 实现智能缓存和自动重新验证\n * 支持多平台：Web、React Native、小程序\n *\n * 优点：\n * 1. 自动缓存，减少网络请求\n * 2. 自动重新验证（可配置）\n * 3. 乐观更新\n * 4. 错误重试\n * 5. 防抖和去重\n */\n\nimport { default as useSWR, mutate } from 'swr';\nimport { useCallback } from 'react';\nimport type { AllConfigs, UseConfigsOptions, ConfigItem } from '../types';\n\nexport type { AllConfigs, UseConfigsOptions, ConfigItem };\n\n/**\n * 创建 useConfigs Hook\n */\nexport function createUseConfigs(options: UseConfigsOptions) {\n  const {\n    apiBaseUrl = '',\n    getAuthToken,\n    onUnauthorized,\n    dedupingInterval = 60000,\n    revalidateOnFocus = false,\n  } = options;\n\n  // Fetcher 函数\n  const fetcher = async (url: string) => {\n    const token = await getAuthToken();\n\n    const res = await fetch(`${apiBaseUrl}${url}`, {\n      headers: {\n        Authorization: `Bearer ${token}`,\n        'Content-Type': 'application/json',\n      },\n      credentials: 'include',\n    });\n\n    if (!res.ok) {\n      if (res.status === 401) {\n        onUnauthorized?.();\n        throw new Error('Unauthorized');\n      }\n      throw new Error('Failed to fetch configs');\n    }\n\n    const data = await res.json();\n    return data.data as AllConfigs;\n  };\n\n  // 返回 Hook 函数\n  return function useConfigs() {\n    const {\n      data,\n      error,\n      mutate: mutateConfigs,\n    } = useSWR<AllConfigs>('/api/admin/config', fetcher, {\n      // 配置选项\n      revalidateOnFocus,\n      revalidateOnReconnect: true, // 网络重连时重新验证\n      dedupingInterval, // 缓存去重时间\n      errorRetryCount: 3, // 错误重试3次\n      errorRetryInterval: 5000, // 重试间隔5秒\n      shouldRetryOnError: true, // 启用错误重试\n\n      // 成功时的回调\n      onSuccess: (_data: AllConfigs) => {\n        console.log('✅ Configs loaded from cache or network');\n      },\n\n      // 错误时的回调\n      onError: (err: Error) => {\n        console.error('❌ Failed to load configs:', err);\n      },\n    });\n\n    // 更新配置（乐观更新）\n    const updateConfigs = useCallback(\n      async (category: string, updates: Record<string, any>) => {\n        const token = await getAuthToken();\n\n        // 乐观更新：立即更新本地缓存\n        mutateConfigs(\n          (current: AllConfigs | undefined) => {\n            if (!current) return current;\n            return {\n              ...current,\n              [category]: {\n                ...current[category],\n                ...Object.entries(updates).reduce((acc, [key, value]) => {\n                  acc[key] = {\n                    ...current[category]?.[key],\n                    value,\n                  };\n                  return acc;\n                }, {} as any),\n              },\n            };\n          },\n          false // 不立即重新验证\n        );\n\n        try {\n          // 发送到服务器\n          const res = await fetch(`${apiBaseUrl}/api/admin/config/${category}`, {\n            method: 'POST',\n            headers: {\n              Authorization: `Bearer ${token}`,\n              'Content-Type': 'application/json',\n            },\n            credentials: 'include',\n            body: JSON.stringify({ configs: updates }),\n          });\n\n          if (!res.ok) throw new Error('Update failed');\n\n          // 更新成功，重新验证缓存\n          mutateConfigs();\n\n          return { success: true };\n        } catch (error) {\n          // 更新失败，回滚\n          mutateConfigs(); // 从服务器重新获取\n          throw error;\n        }\n      },\n      [mutateConfigs, getAuthToken, apiBaseUrl]\n    );\n\n    // 手动刷新\n    const refresh = useCallback(() => {\n      mutateConfigs();\n    }, [mutateConfigs]);\n\n    return {\n      configs: data,\n      isLoading: !error && !data,\n      isError: !!error,\n      error,\n      updateConfigs,\n      refresh,\n    };\n  };\n}\n\n/**\n * 预加载配置\n */\nexport function prefetchConfigs(apiBaseUrl: string = '') {\n  mutate(`${apiBaseUrl}/api/admin/config`);\n}\n\n/**\n * 全局缓存失效\n */\nexport function invalidateAllConfigs(apiBaseUrl: string = '') {\n  mutate(\n    (key: any) => typeof key === 'string' && key.startsWith(`${apiBaseUrl}/api/admin/config`),\n    undefined,\n    { revalidate: true }\n  );\n}\n\n"]}

package/dist/config/index.mjs

@@ -0,0 +1,128 @@
+import '../chunk-BJTO5JO5.mjs';
+import useSWR, { mutate } from 'swr';
+import { useCallback } from 'react';
+
+function createUseConfigs(options) {
+  const {
+    apiBaseUrl = "",
+    getAuthToken,
+    onUnauthorized,
+    dedupingInterval = 6e4,
+    revalidateOnFocus = false
+  } = options;
+  const fetcher = async (url) => {
+    const token = await getAuthToken();
+    const res = await fetch(`${apiBaseUrl}${url}`, {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      credentials: "include"
+    });
+    if (!res.ok) {
+      if (res.status === 401) {
+        onUnauthorized?.();
+        throw new Error("Unauthorized");
+      }
+      throw new Error("Failed to fetch configs");
+    }
+    const data = await res.json();
+    return data.data;
+  };
+  return function useConfigs() {
+    const {
+      data,
+      error,
+      mutate: mutateConfigs
+    } = useSWR("/api/admin/config", fetcher, {
+      // 配置选项
+      revalidateOnFocus,
+      revalidateOnReconnect: true,
+      // 网络重连时重新验证
+      dedupingInterval,
+      // 缓存去重时间
+      errorRetryCount: 3,
+      // 错误重试3次
+      errorRetryInterval: 5e3,
+      // 重试间隔5秒
+      shouldRetryOnError: true,
+      // 启用错误重试
+      // 成功时的回调
+      onSuccess: (_data) => {
+        console.log("\u2705 Configs loaded from cache or network");
+      },
+      // 错误时的回调
+      onError: (err) => {
+        console.error("\u274C Failed to load configs:", err);
+      }
+    });
+    const updateConfigs = useCallback(
+      async (category, updates) => {
+        const token = await getAuthToken();
+        mutateConfigs(
+          (current) => {
+            if (!current) return current;
+            return {
+              ...current,
+              [category]: {
+                ...current[category],
+                ...Object.entries(updates).reduce((acc, [key, value]) => {
+                  acc[key] = {
+                    ...current[category]?.[key],
+                    value
+                  };
+                  return acc;
+                }, {})
+              }
+            };
+          },
+          false
+          // 不立即重新验证
+        );
+        try {
+          const res = await fetch(`${apiBaseUrl}/api/admin/config/${category}`, {
+            method: "POST",
+            headers: {
+              Authorization: `Bearer ${token}`,
+              "Content-Type": "application/json"
+            },
+            credentials: "include",
+            body: JSON.stringify({ configs: updates })
+          });
+          if (!res.ok) throw new Error("Update failed");
+          mutateConfigs();
+          return { success: true };
+        } catch (error2) {
+          mutateConfigs();
+          throw error2;
+        }
+      },
+      [mutateConfigs, getAuthToken, apiBaseUrl]
+    );
+    const refresh = useCallback(() => {
+      mutateConfigs();
+    }, [mutateConfigs]);
+    return {
+      configs: data,
+      isLoading: !error && !data,
+      isError: !!error,
+      error,
+      updateConfigs,
+      refresh
+    };
+  };
+}
+function prefetchConfigs(apiBaseUrl = "") {
+  mutate(`${apiBaseUrl}/api/admin/config`);
+}
+function invalidateAllConfigs(apiBaseUrl = "") {
+  mutate(
+    (key) => typeof key === "string" && key.startsWith(`${apiBaseUrl}/api/admin/config`),
+    void 0,
+    { revalidate: true }
+  );
+}
+
+export { createUseConfigs, invalidateAllConfigs, prefetchConfigs };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/config/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/hooks/useConfigs.ts"],"names":["error"],"mappings":"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","file":"index.mjs","sourcesContent":["'use client';\n\n/**\n * 配置缓存优化 Hook\n *\n * 使用 SWR 实现智能缓存和自动重新验证\n * 支持多平台：Web、React Native、小程序\n *\n * 优点：\n * 1. 自动缓存，减少网络请求\n * 2. 自动重新验证（可配置）\n * 3. 乐观更新\n * 4. 错误重试\n * 5. 防抖和去重\n */\n\nimport { default as useSWR, mutate } from 'swr';\nimport { useCallback } from 'react';\nimport type { AllConfigs, UseConfigsOptions, ConfigItem } from '../types';\n\nexport type { AllConfigs, UseConfigsOptions, ConfigItem };\n\n/**\n * 创建 useConfigs Hook\n */\nexport function createUseConfigs(options: UseConfigsOptions) {\n  const {\n    apiBaseUrl = '',\n    getAuthToken,\n    onUnauthorized,\n    dedupingInterval = 60000,\n    revalidateOnFocus = false,\n  } = options;\n\n  // Fetcher 函数\n  const fetcher = async (url: string) => {\n    const token = await getAuthToken();\n\n    const res = await fetch(`${apiBaseUrl}${url}`, {\n      headers: {\n        Authorization: `Bearer ${token}`,\n        'Content-Type': 'application/json',\n      },\n      credentials: 'include',\n    });\n\n    if (!res.ok) {\n      if (res.status === 401) {\n        onUnauthorized?.();\n        throw new Error('Unauthorized');\n      }\n      throw new Error('Failed to fetch configs');\n    }\n\n    const data = await res.json();\n    return data.data as AllConfigs;\n  };\n\n  // 返回 Hook 函数\n  return function useConfigs() {\n    const {\n      data,\n      error,\n      mutate: mutateConfigs,\n    } = useSWR<AllConfigs>('/api/admin/config', fetcher, {\n      // 配置选项\n      revalidateOnFocus,\n      revalidateOnReconnect: true, // 网络重连时重新验证\n      dedupingInterval, // 缓存去重时间\n      errorRetryCount: 3, // 错误重试3次\n      errorRetryInterval: 5000, // 重试间隔5秒\n      shouldRetryOnError: true, // 启用错误重试\n\n      // 成功时的回调\n      onSuccess: (_data: AllConfigs) => {\n        console.log('✅ Configs loaded from cache or network');\n      },\n\n      // 错误时的回调\n      onError: (err: Error) => {\n        console.error('❌ Failed to load configs:', err);\n      },\n    });\n\n    // 更新配置（乐观更新）\n    const updateConfigs = useCallback(\n      async (category: string, updates: Record<string, any>) => {\n        const token = await getAuthToken();\n\n        // 乐观更新：立即更新本地缓存\n        mutateConfigs(\n          (current: AllConfigs | undefined) => {\n            if (!current) return current;\n            return {\n              ...current,\n              [category]: {\n                ...current[category],\n                ...Object.entries(updates).reduce((acc, [key, value]) => {\n                  acc[key] = {\n                    ...current[category]?.[key],\n                    value,\n                  };\n                  return acc;\n                }, {} as any),\n              },\n            };\n          },\n          false // 不立即重新验证\n        );\n\n        try {\n          // 发送到服务器\n          const res = await fetch(`${apiBaseUrl}/api/admin/config/${category}`, {\n            method: 'POST',\n            headers: {\n              Authorization: `Bearer ${token}`,\n              'Content-Type': 'application/json',\n            },\n            credentials: 'include',\n            body: JSON.stringify({ configs: updates }),\n          });\n\n          if (!res.ok) throw new Error('Update failed');\n\n          // 更新成功，重新验证缓存\n          mutateConfigs();\n\n          return { success: true };\n        } catch (error) {\n          // 更新失败，回滚\n          mutateConfigs(); // 从服务器重新获取\n          throw error;\n        }\n      },\n      [mutateConfigs, getAuthToken, apiBaseUrl]\n    );\n\n    // 手动刷新\n    const refresh = useCallback(() => {\n      mutateConfigs();\n    }, [mutateConfigs]);\n\n    return {\n      configs: data,\n      isLoading: !error && !data,\n      isError: !!error,\n      error,\n      updateConfigs,\n      refresh,\n    };\n  };\n}\n\n/**\n * 预加载配置\n */\nexport function prefetchConfigs(apiBaseUrl: string = '') {\n  mutate(`${apiBaseUrl}/api/admin/config`);\n}\n\n/**\n * 全局缓存失效\n */\nexport function invalidateAllConfigs(apiBaseUrl: string = '') {\n  mutate(\n    (key: any) => typeof key === 'string' && key.startsWith(`${apiBaseUrl}/api/admin/config`),\n    undefined,\n    { revalidate: true }\n  );\n}\n\n"]}

package/dist/drizzle-auth-service-Bxlovhv8.d.ts

@@ -0,0 +1,145 @@
+import { U as UserRole } from './enums-Dume-V5Y.js';
+
+/**
+ * Auth Services - Types
+ * 认证服务类型定义
+ */
+
+/**
+ * 认证服务配置
+ */
+interface AuthServiceConfig {
+    /**
+     * Drizzle 数据库实例
+     */
+    db: any;
+    /**
+     * JWT 密钥
+     */
+    jwtSecret: string;
+    /**
+     * JWT 过期时间 (默认: '7d')
+     */
+    jwtExpiresIn?: string;
+    /**
+     * bcrypt 加密轮数 (默认: 12)
+     */
+    saltRounds?: number;
+    /**
+     * 是否在生产环境检查密钥强度 (默认: true)
+     */
+    checkSecretStrength?: boolean;
+}
+/**
+ * 用户信息（返回给客户端的精简版）
+ */
+interface UserInfo {
+    id: string;
+    email: string;
+    username: string;
+    role: UserRole;
+}
+/**
+ * 认证结果
+ */
+interface AuthResult {
+    user: UserInfo;
+    token: string;
+}
+/**
+ * 会话信息
+ */
+interface SessionInfo {
+    id: string;
+    userId: string;
+    token: string;
+    expiresAt: string;
+    ipAddress?: string | null;
+    userAgent?: string | null;
+}
+/**
+ * 验证结果
+ */
+interface VerifyResult {
+    user: UserInfo;
+    session: SessionInfo;
+}
+
+/**
+ * Auth Services - Drizzle Auth Service
+ * 基于 Drizzle ORM 的认证服务
+ */
+
+/**
+ * Drizzle 认证服务类
+ *
+ * @example
+ * ```typescript
+ * import { DrizzleAuthService } from '@qhr123/sa2kit/auth/services';
+ * import { db } from './db';
+ *
+ * const authService = new DrizzleAuthService({
+ *   db,
+ *   jwtSecret: process.env.JWT_SECRET!,
+ *   jwtExpiresIn: '7d',
+ * });
+ *
+ * // 用户注册
+ * const result = await authService.signUp('user@example.com', 'password123', 'username');
+ *
+ * // 用户登录
+ * const loginResult = await authService.signIn('user@example.com', 'password123');
+ * ```
+ */
+declare class DrizzleAuthService {
+    private config;
+    constructor(config: AuthServiceConfig);
+    /**
+     * 验证配置
+     */
+    private validateConfig;
+    /**
+     * 用户注册
+     */
+    signUp(email: string, password: string, username?: string, role?: UserRole): Promise<AuthResult>;
+    /**
+     * 用户登录
+     */
+    signIn(email: string, password: string): Promise<AuthResult>;
+    /**
+     * 验证 Token
+     */
+    verifyToken(token: string): Promise<VerifyResult>;
+    /**
+     * 创建会话
+     */
+    createSession(userId: string, token: string, ipAddress?: string, userAgent?: string): Promise<void>;
+    /**
+     * 删除会话（登出）
+     */
+    signOut(token: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * 获取会话
+     */
+    getSession(token: string): Promise<VerifyResult | null>;
+    /**
+     * 检查管理员权限
+     */
+    requireAdmin(token: string): Promise<VerifyResult>;
+    /**
+     * 检查超级管理员权限
+     */
+    requireSuperAdmin(token: string): Promise<VerifyResult>;
+    /**
+     * 通过用户 ID 获取用户信息
+     */
+    getUserById(userId: string): Promise<UserInfo | null>;
+    /**
+     * 通过邮箱获取用户信息
+     */
+    getUserByEmail(email: string): Promise<UserInfo | null>;
+}
+
+export { type AuthResult as A, DrizzleAuthService as D, type SessionInfo as S, type UserInfo as U, type VerifyResult as V, type AuthServiceConfig as a };