@forinda/kickjs-db

中文文档
8.12.4发布于 2026/10/30MITTypeScriptES Module构建来源已验证近 30 天下载 3395

KickJS- native ORM — 代码- 第1 schema, 可逆迁移, 多透析 SQL 构建器

中文使用文档
文档目录4 节
  1. 安装
  2. 快速实例
  3. 文档
  4. 许可证

@forinda/kickjs-db (英语)

kick/db,"KickJS"数据库层:一个代码-第一 schema,完全打入的查询,以及由 schema 变化产生的迁移. 与PostgreSQL,MySQL和SQLite合作.

安装

kick add db        # or: pnpm add @forinda/kickjs-db pg

作为子路径的Dialects飞船: @forinda/kickjs-db/pg (驾驶员) pg, (中文(简体) ), /mysql (单位:千美元)mysql2和 /sqlite (单位:千美元)better-sqlite3) (中文(简体) ).

快速实例

import { createDbClient, table, timestamp, uuid, varchar } from '@forinda/kickjs-db'
import { pgDialect } from '@forinda/kickjs-db/pg'
import { Pool } from 'pg'

const users = table('users', {
  id: uuid().primaryKey().defaultRandom(),
  email: varchar(255).notNull().unique(),
  createdAt: timestamp().notNull().defaultNow(),
})

const db = createDbClient({
  schema: { users },
  dialect: pgDialect({ pool: new Pool({ connectionString: process.env.DATABASE_URL }) }),
})

const user = await db.query.users.findFirst({
  where: (_u, eb) => eb('email', '=', '[email protected]'),
})
//    ^ { id: string; email: string; createdAt: Date } | undefined

kick db generate 从您的计划变化中写入迁移,以及 kick db migrate 应用它.

文档

kickjs.app/指针/数据库: 开始, 计划, 查询, 关系, 迁移, 交易, 测试, 以及从 Prisma, Drizzle, TypeORM 或 Sequelize 移动 .

许可证

麻省理工学院

版本与发布记录

@forinda/kickjs-db 共发布 48 个版本,首次发布于 2026/04/28;过去 12 个月发布了 48 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.12.4latest2026/10/3016 天前
8.12.32026/10/3016 天前
8.12.22026/10/3016 天前
8.12.12026/10/2521 天前
8.12.02026/10/2521 天前
8.11.32026/10/2423 天前

其他发布通道:alpha → 7.0.0-alpha.0。

关于 @forinda/kickjs-db 的常见问题

@forinda/kickjs-db 是什么?

KickJS- native ORM — 代码- 第1 schema, 可逆迁移, 多透析 SQL 构建器

如何安装 @forinda/kickjs-db?

在项目目录运行 npm install @forinda/kickjs-db,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@forinda/kickjs(>=8.8.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 kickjs-db,可以用 npx kickjs-db 直接运行。

@forinda/kickjs-db 支持 TypeScript 吗?

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

@forinda/kickjs-db 支持 ESM 还是 CommonJS?

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

@forinda/kickjs-db 需要什么版本的 Node.js?

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

@forinda/kickjs-db 可以商用吗?

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

@forinda/kickjs-db 的下载量有多少?

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

@forinda/kickjs-db 还在维护吗?

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