@boxdb/better-auth-adapter

中文文档
0.7.0发布于 2026/10/31MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 1870

BoxDB 直接更好的 Auth 数据库适配器

中文使用文档

BoxDB 数据库适配器

Better Auth 1.7.x的直接适配器. 安装 @boxdb/client, (中文(简体) ), @boxdb/better-auth-adapter,以及 better-auth。 。 。 .

npm install @boxdb/client @boxdb/better-auth-adapter better-auth
import { BoxDB } from "@boxdb/client";
import { betterAuth } from "better-auth";
import { betterAuthAdapter } from "@boxdb/better-auth-adapter";

const client = await BoxDB.open("auth.db");
export const auth = betterAuth({
  database: betterAuthAdapter(client),
  secret: process.env.BETTER_AUTH_SECRET,
  baseURL: process.env.BETTER_AUTH_URL,
  emailAndPassword: { enabled: true },
});
// Close client when the application shuts down.

适配器使用Better Auth的工厂进行模型/场地映射,ID,日期, 布尔斯,JSON和阵列。 设定 usePlural 或者说 debugLogs 在适配器的第二个 必要时进行论证。 两者都产生了字符串ID和序列数字ID工作. 更好的 Auth 交易回调在内部使用明确的 BoxDB 交易 . 原生单声明 consumeOne 财务报告和审定财务报表 incrementOne 保留原子性 同时提出请求.

使用更好的 Auth 的 schema 生成命令, 或者直接生成 SQL :

const options = { emailAndPassword: { enabled: true } };
const adapter = betterAuthAdapter(client)(options);
const schema = await adapter.createSchema!(options);
await client.exec(schema.code); // Initial schema creation, once.

生成生成一个初始计划; 它不会 diff 或迁移已有的 计划 审查在应用插件/schema更改前生成了 SQL 。 更好的认证 处理通过适配器-构件回落获取的关系。 整数 字段必须符合 JavaScript 的安全范围; 布林由 Bigint 存储结果映射. 适配器借客户端而永不收.

版本与发布记录

@boxdb/better-auth-adapter 共发布 15 个版本,首次发布于 2026/10/15;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.7.0latest2026/10/318 天前
0.6.02026/10/309 天前
0.5.12026/10/2415 天前
0.5.02026/10/2317 天前
0.4.32026/10/2217 天前
0.4.22026/10/1821 天前

关于 @boxdb/better-auth-adapter 的常见问题

@boxdb/better-auth-adapter 是什么?

BoxDB 直接更好的 Auth 数据库适配器

如何安装 @boxdb/better-auth-adapter?

在项目目录运行 npm install @boxdb/better-auth-adapter,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:better-auth(^1.7.7)、@boxdb/client(^0.7.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@boxdb/better-auth-adapter 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@boxdb/better-auth-adapter 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@boxdb/better-auth-adapter 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.18.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@boxdb/better-auth-adapter 可以商用吗?

@boxdb/better-auth-adapter 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@boxdb/better-auth-adapter 的下载量有多少?

根据 npm 官方下载统计,@boxdb/better-auth-adapter 在 2026/10/09 – 2026/11/07 这 30 天内被下载 1,870 次,日均约 62 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@boxdb/better-auth-adapter 还在维护吗?

最新版本 0.7.0 发布于 2026/10/31(8 天前);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/10/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。