@ailnaf/zoddb 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+## [0.2.0] - 2026-10-18
+
+graph query 2.0：补关系型后台/内容应用的高频查询表达。
+
+### Added
+
+- `every` 关系过滤：空关系为 true，存在不满足（含 NULL 谓词）为 false；支持 forward / reverse / M2M，与 `some` / `none` 组合
+- `with.aggregate`：关系级 `count` / `sum` / `max`
+  - 空关系 `count=0`、`sum/max=null`
+  - `sum` 仅数值列；`max` 保留列类型
+  - 支持一对多、反向、M2M through
+  - 聚合复用关系 `where`，不受 `limit/offset` 影响
+  - 结果挂在 `<relation>Aggregate`
+- 三层 `with` 加载：每层支持 `where` / `orderBy` / `limit` / `offset`；第 4 层在运行时和类型层显式拒绝
+- 查询数回归：20 父行下 `every`=1、aggregate=3、三层 `with`=3，锁定无 N+1
+- Studio / 外部 dogfood 覆盖新查询能力
+
+### Changed
+
+- `with` 关系加载上限从文档承诺的 2 层提升到 3 层；关系过滤仍为深度 2
+- 文档明确批量查询数边界和新能力限制
+
+### Known limitations
+
+- 仅支持 PostgreSQL
+- 关系过滤最大深度 2
+- 关系聚合仅 `count` / `sum` / `max`；不做 `avg` / `min` / 关系 groupBy / having / 嵌套聚合
+- M2M 行级 `where` / `orderBy` / `limit` 仍不支持
+- forward-only migration；不支持 down migration、shadow DB、零停机在线 DDL
+
+[0.2.0]: https://www.npmjs.com/package/@ailnaf/zoddb/v/0.2.0
+
+## [0.1.0] - 2026-10-18
+
+首个可发布预览版。
+
+### Added
+
+- zod-first graph 建模：`defineSchema`、`node`、`edge`、`manyToMany`
+- graph 运行时 `zoddb`：类型化 CRUD、关系加载、关系过滤、嵌套写入
+- 多对多 through 写入：`connect` / `set` / `disconnect`
+- `relationGraph(schema)` 纯 JSON 关系图
+- better-auth 子路径：`authSchema` / `zodDbAdapter`
+- 生产迁移 CLI：advisory lock、checksum、历史完整性、baseline、dry-run、JSON status
+- CLI 自动加载项目根 `.env`
+- `zoddb studio`：本地 schema explorer + 数据浏览（表/列/PK/唯一约束/关系；分页/总数/排序/过滤/投影、`with` 关系预览、`some/none`、FK 跳转、M2M through；仅使用公开 graph IR 与 `zoddb` runtime）
+- `zoddb init` 生成 `.mts` scaffold，避免 CommonJS 项目的首次 `dev` 加载失败
+- `zoddb studio --write`：受控写模式（create/update/delete/upsert、嵌套 create、M2M 写入、transaction；默认只读、同源 token、删除确认）
+- Studio 只读迁移状态面板：调用公开 `zoddb status --json` 展示 applied/pending/missing/out-of-order/empty/tampered/drift
+- `verify:pack` 覆盖 tarball 安装后的 Studio schema / rows / migrations 请求
+
+### Changed
+
+- npm 包名为 `@ailnaf/zoddb`（npm 拒绝无 scope 的 `zoddb`）；CLI 命令仍为 `zoddb`
+- 公开运行时面收口为 **15 个 graph/error exports**
+- `table()`、低层 DDL、`defineDb`、`relations`、`pg`、迁移函数不再从主入口导出
+- 迁移改为 CLI 工作流；低层能力保留在内部模块
+
+### Breaking
+
+- 旧的低层 `table()` / DDL / `defineDb` / `relations` 导入会失败
+- 需要低层建表或迁移脚本的用户应改用 `zoddb init/dev/generate/migrate`
+
+### Known limitations
+
+- 仅支持 PostgreSQL
+- 关系过滤最大深度 2；不支持 `every`、关系排序/聚合全套
+- forward-only migration；不支持 down migration、shadow DB、零停机在线 DDL
+- better-auth 承诺 core + admin + organization，其他插件需自行验证
+
+[0.1.0]: https://www.npmjs.com/package/@ailnaf/zoddb/v/0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 zoddb contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,3 +1,441 @@
-# Temporary Holding Version
+# zoddb
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Postgres 的 zod-first ORM：**只写 graph 建模，不写 SQL**。表、类型、关系、DDL 和迁移都从同一个 schema 推导；没有 codegen，没有低层表构造器。
+
+```ts
+const adults = await db.users.findMany({
+  where: { age: { gte: 18 } },
+  orderBy: { createdAt: 'desc' },
+  limit: 20,
+})
+// adults: { id: string; email: string; name: string | null; ... }[]
+```
+
+## 安装
+
+```bash
+npm i @ailnaf/zoddb postgres zod
+```
+
+CLI 命令仍然是 `zoddb`。也可以从 tarball 安装：
+
+```bash
+npm pack
+npm i ./ailnaf-zoddb-0.2.0.tgz postgres zod
+```
+
+要求 Node.js **>= 22.18**。
+
+## 快速开始
+
+```bash
+npx zoddb init
+
+# init 生成 .env.example；复制为 .env 并填入 DATABASE_URL
+cp .env.example .env
+# 编辑 .env：DATABASE_URL=postgres://postgres:postgres@localhost:5432/zoddb
+
+npx zoddb dev --once
+```
+
+`init` 生成 `zoddb.config.mts`、`schema.mts`、`.env.example`；`.mts` 在 CommonJS 和 ESM 项目里都能被 Node 直接加载。已有文件默认不覆盖，`--force` 才覆盖。
+
+`dev --once` 会读取 graph schema，生成 additive 迁移并应用；删列/改类型默认拒绝。
+
+## 建模：一个 graph
+
+```ts
+// src/schema.ts
+import { z } from 'zod'
+import { defineSchema, edge, manyToMany, node } from '@ailnaf/zoddb'
+
+export const schema = defineSchema({
+  nodes: {
+    users: node(z.object({
+      id: z.uuid(),
+      email: z.email(),
+      name: z.string().nullable(),
+      createdAt: z.date(),
+    }), { unique: [['email']] }),
+
+    posts: node(z.object({
+      id: z.uuid(),
+      authorId: z.uuid(),
+      title: z.string(),
+      published: z.boolean().default(false),
+      createdAt: z.date(),
+    })),
+
+    tags: node(z.object({
+      id: z.uuid(),
+      slug: z.string(),
+    }), { unique: [['slug']] }),
+
+    postTags: node(z.object({
+      postId: z.uuid(),
+      tagId: z.uuid(),
+    }), { primaryKey: ['postId', 'tagId'] }),
+  },
+
+  edges: {
+    users: {
+      posts: edge('posts', { from: 'id', to: 'authorId', kind: 'many' }),
+    },
+    posts: {
+      author: edge('users', { from: 'authorId', to: 'id', onDelete: 'cascade' }),
+      tags: manyToMany('tags', { through: 'postTags', from: 'postId', to: 'tagId' }),
+    },
+  },
+})
+```
+
+约定：
+
+- `users` → 表 `users`，`createdAt` → 列 `created_at`
+- `id: z.uuid()` → 主键 + `gen_random_uuid()`
+- `createdAt` / `updatedAt` → `timestamptz default now()`
+- `z.email()` → text，`z.int()` → int8，`z.date()` → timestamptz，`z.enum()` → text
+- 关系只写在 `edges[源表]`；不要在 node 里写 relations
+- `reverse` 可自动生成反向关系；反向关系只读
+- M2M 必须显式声明 through 表
+
+## 连接
+
+```ts
+import { zoddb } from '@ailnaf/zoddb'
+import { schema } from './schema.js'
+
+export const db = zoddb({
+  schema,
+  url: process.env.DATABASE_URL!,
+})
+```
+
+> 应用进程不会自动读 `.env`；Node 22.18+ 可用 `node --env-file=.env app.mts` 或 `process.loadEnvFile()`。CLI 会自动读取项目根 `.env`。
+
+`db` 按表名提供命名空间：
+
+```ts
+db.users
+db.posts
+db.tags
+```
+
+每个命名空间支持：
+
+```text
+create / insert / insertMany / seed / update / delete / upsert
+count / aggregate / groupBy / findMany / findOne
+```
+
+## 写入
+
+```ts
+const ada = await db.users.create({
+  email: 'ada@acme.dev',
+  name: 'Ada',
+})
+
+const [updated] = await db.users.update(
+  { id: ada.id },
+  { name: 'Ada Lovelace' },
+)
+
+await db.users.upsert(
+  { email: 'ada@acme.dev', name: 'Ada' },
+  { conflict: ['email'], update: ['name'] },
+)
+
+await db.users.delete({ id: ada.id })
+```
+
+- 写入先过 zod；`id` / `createdAt` / `updatedAt` 自动生成
+- 读出的行默认也校验；失败抛 `RowValidationError`
+- `update` / `delete` 条件不能为空；存在 `updatedAt` 时自动刷新
+
+嵌套 create：
+
+```ts
+const grace = await db.users.create({
+  email: 'grace@acme.dev',
+  name: 'Grace',
+  posts: {
+    create: [
+      { title: 'Type-safe SQL', published: true },
+      { title: 'Draft' },
+    ],
+  },
+})
+// grace.posts: Post[]
+```
+
+父行和子行同一事务；many 支持 `create` / `connect`，one 只支持 `connect`。
+
+## 查询
+
+```ts
+const rows = await db.users.findMany({
+  where: {
+    email: { contains: '@acme', mode: 'insensitive' },
+    name: { isNull: false },
+  },
+  orderBy: [{ createdAt: 'desc' }, { id: 'asc' }],
+  limit: 20,
+  offset: 0,
+})
+
+const one = await db.users.findOne({
+  where: { email: 'ada@acme.dev' },
+})
+```
+
+支持 `eq` / `ne` / `lt` / `lte` / `gt` / `gte` / `in` / `notIn` / `contains` / `startsWith` / `endsWith` / `isNull`，以及 `AND` / `OR` / `NOT`。
+
+`select` 只取需要的列；`cursor` 做 keyset 分页，必须覆盖 `orderBy`。
+
+## 关系读取
+
+```ts
+const users = await db.users.findMany({
+  orderBy: { createdAt: 'desc' },
+  with: {
+    posts: {
+      where: { published: true },
+      orderBy: { createdAt: 'desc' },
+      limit: 2,
+      with: { author: true },
+    },
+  },
+})
+```
+
+关系聚合：
+
+```ts
+const users = await db.users.findMany({
+  with: {
+    posts: {
+      aggregate: {
+        count: true,
+        sum: { views: true },
+        max: { createdAt: true },
+      },
+    },
+  },
+})
+
+users[0].postsAggregate
+// { count: number, sum: { views: number | null }, max: { createdAt: Date | null } }
+```
+
+- `count` 空关系为 0；`sum` / `max` 空关系为 null
+- 普通关系聚合复用 `where`，但不受 `limit/offset` 影响；M2M 行级 `where` 仍不支持
+
+- 每个父行独立分页（窗口函数），不是全局 LIMIT
+- 1 条主查询 + 每条关系 1 条批量查询，不做 N+1
+- 关系过滤内联为主查询的 `EXISTS`；每个 aggregate 关系额外 1 条聚合查询；三层 `with` 每层 1 条
+- 支持最多 3 层 `with`；每层 `where/orderBy/limit` 独立生效，第 4 层运行时和类型层都拒绝
+- 关系名和返回类型从 graph 推导；拼错会在编译期报错
+
+关系过滤：
+
+```ts
+const authors = await db.users.findMany({
+  where: {
+    posts: {
+      some: {
+        published: true,
+        tags: { some: { slug: 'orm' } },
+      },
+    },
+  },
+})
+
+const quiet = await db.users.findMany({
+  where: { posts: { none: { published: true } } },
+})
+
+const allPublished = await db.users.findMany({
+  where: { posts: { every: { published: true } } },
+})
+```
+
+编译为 `EXISTS` / `NOT EXISTS`，内联进主查询，不按父行查询；`every` 空关系为 `true`，存在一个不满足为 `false`；支持 forward / reverse / M2M through，最大深度 2。
+
+## 多对多
+
+```ts
+const post = await db.posts.create({
+  authorId: ada.id,
+  title: 'Why zoddb',
+  tags: {
+    connect: [{ id: orm.id }, { id: pg.id }],
+  },
+})
+
+await db.posts.update(
+  { id: post.id },
+  { tags: { set: [{ id: pg.id }] } },
+)
+
+await db.posts.update(
+  { id: post.id },
+  { tags: { disconnect: [{ id: pg.id }] } },
+)
+```
+
+- create 只支持 `connect`
+- update 支持 `set` / `connect` / `disconnect`
+- 只管理 through link，不创建 target 行
+- update 的 where 必须命中恰好一个父行
+
+## 事务
+
+```ts
+await db.transaction(async tx => {
+  const user = await tx.users.create({
+    email: 'tx@acme.dev',
+    name: 'TX',
+  })
+
+  await tx.posts.create({
+    authorId: user.id,
+    title: 'created in tx',
+  })
+})
+```
+
+回调抛错自动回滚；`tx` 有同样的 graph 命名空间。
+
+## Studio（本地只读 / 可选写模式）
+
+```bash
+npx zoddb studio
+```
+
+CLI 会读取 `zoddb.config.ts`/`zoddb.config.mts` 的 schema，在 `127.0.0.1` 启动本地 Studio，并输出带 token 的 URL。
+
+- 不配置数据库 URL 时：只展示表、列、PK、唯一约束和关系
+- 配置 `DATABASE_URL` / `--url` 时：增加只读数据浏览（分页、总数、排序、操作符过滤、`with` 关系预览、`some/none` 关系过滤、FK 跳转、M2M through）
+- 配置迁移目录时：侧栏只读展示 `zoddb status --json` 的 applied / pending / missing / out-of-order / empty / tampered / drift 快照
+- 不在 Studio 中执行迁移、DDL 或 SQL 控制台；迁移状态通过公开 CLI 子进程读取
+
+Studio 的数据层只使用公开的 `relationGraph(schema)` 和 `zoddb` runtime，因此它也是公开接口的验证器。
+
+### 写模式
+
+```bash
+npx zoddb studio --write
+```
+
+- 默认只读；只有 `--write` 才显示新建/编辑/删除/事务入口
+- 写请求走 `POST /api/write`，要求本地 token 和同源请求
+- 支持 create / update / delete / upsert / 嵌套 create / M2M 写入 / transaction
+- 删除需要二次确认；不提供 SQL、DDL 或迁移 apply
+- `npm run verify:pack` 会从 tarball 安装后启动 Studio，验证 schema / rows / migrations 三类请求
+
+
+## 迁移
+
+```bash
+zoddb generate --schema ./src/schema.ts --dir ./migrations --name init
+zoddb migrate --dir ./migrations
+zoddb status --schema ./src/schema.ts --dir ./migrations
+```
+
+- `generate` 只写文件，不执行；破坏性变更默认拒绝，`--allow-destructive` 显式放行
+- `migrate` 用 advisory lock 串行化，每个文件一个事务
+- 历史记录 `_zoddb_migrations`；缺失、乱序、空文件、checksum 变化默认拒绝
+- 破坏性变更默认拒绝
+
+CI / 存量库：
+
+```bash
+zoddb migrate --dir ./migrations --dry-run
+zoddb status --schema ./src/schema.ts --dir ./migrations --json
+zoddb baseline --schema ./src/schema.ts --dir ./migrations --through <file>
+```
+
+- `--dry-run` 只读，不写历史、不建业务表
+- `--json` 输出稳定字段；待应用/异常 exit 1
+- `baseline` 只标记 through 及之前的迁移，不执行文件 SQL；默认要求 schema 与库一致
+
+## 关系图 IR
+
+```ts
+import { relationGraph } from '@ailnaf/zoddb'
+
+const graph = relationGraph(schema)
+// { nodes, edges }；包含反向关系和 M2M through
+```
+
+不连接数据库、不执行 SQL，适合可视化与审计。
+
+## better-auth
+
+```ts
+import { betterAuth } from 'better-auth'
+import { authSchema, zodDbAdapter } from '@ailnaf/zoddb/better-auth'
+import { defineSchema, zoddb } from '@ailnaf/zoddb'
+
+const auth = authSchema({ plugins: [] })
+const schema = defineSchema({
+  nodes: auth.nodes,
+  edges: auth.edges,
+})
+const db = zoddb({ schema, url: process.env.DATABASE_URL! })
+
+const handler = betterAuth({
+  database: zodDbAdapter(db, { schema }),
+  emailAndPassword: { enabled: true },
+})
+```
+
+- `authSchema` 生成 core 四表；插件表由 plugins 推导
+- `auth.nodes` / `auth.edges` 可直接展开
+- adapter 按 schema 模型名自动映射
+
+## 错误
+
+| 错误 | 场景 |
+|---|---|
+| `ZodError` | 写入值不符合 zod |
+| `RowValidationError` | 读出的行校验失败 |
+| `UniqueViolationError` | 23505，带 table / columns |
+| `NotNullViolationError` / `ForeignKeyViolationError` | 23502 / 23503 |
+| `NoRowsError` | `.one()` 无结果 |
+| `UndefinedParamError` | SQL 参数是 undefined |
+| `PgError` | 其它 PG 错误 |
+
+```ts
+import { UniqueViolationError } from '@ailnaf/zoddb'
+
+try {
+  await db.users.create({ email: 'ada@acme.dev', name: 'Ada' })
+} catch (e) {
+  if (e instanceof UniqueViolationError) {
+    console.log(e.table, e.columns)
+  }
+}
+```
+
+## 边界
+
+- 公开运行时只有 graph 建模、`zoddb`、`relationGraph` 和错误类型
+- 低层 `table` / DDL / `defineDb` / `relations` / `pg` 是内部实现，不对外
+- 不支持 query builder、懒加载、任意深度递归、关系排序/聚合全套
+- 不支持 down migration、shadow DB、零停机在线 DDL
+- 仅 Postgres
+
+公开契约见 [`docs/api.md`](./docs/api.md)；发布准备见 [`RELEASING.md`](./RELEASING.md)、变更见 [`CHANGELOG.md`](./CHANGELOG.md)。
+
+## 开发
+
+```bash
+npm run check         # typecheck + 390 个测试
+npm run build         # tsc → dist
+npm run verify:pack   # 打包安装 smoke + 类型消费
+npm run verify:dogfood # 独立 app 干净安装 + 全链路 dogfood
+```
+
+需要本地 PG（默认 `postgres://postgres@127.0.0.1:55432/zoddb_test`，或设 `DATABASE_URL`）。

package/dist/aggregate.d.ts

@@ -0,0 +1,42 @@
+import type postgres from 'postgres';
+import { type WhereFilter } from './filter.js';
+import { type RowOf, type SqlFragment, type Table } from './table.js';
+export type AggKey<T extends Table> = keyof RowOf<T> & string;
+type SumFields<S extends readonly string[]> = S extends readonly [] ? {} : {
+    [K in S[number] as `sum_${K}`]: string | null;
+};
+type AvgFields<A extends readonly string[]> = A extends readonly [] ? {} : {
+    [K in A[number] as `avg_${K}`]: string | null;
+};
+type MinFields<T extends Table, N extends readonly string[]> = N extends readonly [] ? {} : {
+    [K in N[number] as `min_${K}`]: RowOf<T>[Extract<K, keyof RowOf<T>>] | null;
+};
+type MaxFields<T extends Table, X extends readonly string[]> = X extends readonly [] ? {} : {
+    [K in X[number] as `max_${K}`]: RowOf<T>[Extract<K, keyof RowOf<T>>] | null;
+};
+/** 聚合结果：分组键 + count + 只包含请求了的聚合字段 */
+export type AggRow<T extends Table, G extends readonly string[] = [], S extends readonly string[] = [], A extends readonly string[] = [], N extends readonly string[] = [], X extends readonly string[] = []> = Pick<RowOf<T>, Extract<G[number], keyof RowOf<T>>> & {
+    count: number;
+} & SumFields<S> & AvgFields<A> & MinFields<T, N> & MaxFields<T, X>;
+export interface AggregateOptions<T extends Table> {
+    where?: WhereFilter<T>;
+    sum?: readonly AggKey<T>[];
+    avg?: readonly AggKey<T>[];
+    min?: readonly AggKey<T>[];
+    max?: readonly AggKey<T>[];
+    /** 高级逃生口：如 sql`count(*) > 1` */
+    having?: SqlFragment;
+    /** 高级逃生口：如 sql`count(*) desc` */
+    orderBy?: SqlFragment;
+    limit?: number;
+    offset?: number;
+}
+export type AggregateRunner = (sql: string, params: readonly unknown[], meta: {
+    operation: string;
+    table?: string;
+}) => Promise<unknown[]>;
+export declare function aggregateImpl(raw: postgres.Sql, table: Table, opts: AggregateOptions<Table> & {
+    groupBy?: readonly string[];
+}, requireGroup: boolean, run?: AggregateRunner): Promise<Array<Record<string, unknown>>>;
+export {};
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAA;AACpC,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAiB,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAEpF,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,KAAK,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAA;AAE7D,KAAK,SAAS,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,IACxC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,EAAE,GAAG,MAAM,GAAG,IAAI;CAAE,CAAA;AAChF,KAAK,SAAS,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,IACxC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,EAAE,GAAG,MAAM,GAAG,IAAI;CAAE,CAAA;AAChF,KAAK,SAAS,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,IACzD,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;CAAE,CAAA;AAC9G,KAAK,SAAS,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,SAAS,MAAM,EAAE,IACzD,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;CAAE,CAAA;AAE9G,qCAAqC;AACrC,MAAM,MAAM,MAAM,CAChB,CAAC,SAAS,KAAK,EACf,CAAC,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,EAChC,CAAC,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,EAChC,CAAC,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,EAChC,CAAC,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,EAChC,CAAC,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,IAC9B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACxE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEjE,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,KAAK;IAC/C,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;IACtB,GAAG,CAAC,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1B,GAAG,CAAC,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1B,GAAG,CAAC,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1B,GAAG,CAAC,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1B,gCAAgC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACxC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AAEvB,wBAAsB,aAAa,CACjC,GAAG,EAAE,QAAQ,CAAC,GAAG,EACjB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAC/D,YAAY,EAAE,OAAO,EACrB,GAAG,CAAC,EAAE,eAAe,GACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CA+DzC"}

package/dist/aggregate.js

@@ -0,0 +1,77 @@
+import { compileWhere } from './filter.js';
+import { isSqlFragment } from './table.js';
+const quoteIdent = (s) => `"${s.replace(/"/g, '""')}"`;
+export async function aggregateImpl(raw, table, opts, requireGroup, run) {
+    const sum = opts.sum ?? [];
+    const avg = opts.avg ?? [];
+    const min = opts.min ?? [];
+    const max = opts.max ?? [];
+    const groupBy = opts.groupBy ?? [];
+    if (requireGroup && groupBy.length === 0)
+        throw new Error('groupBy: groupBy 不能为空');
+    const planOf = (k) => {
+        const p = table.__plan.find(p => p.outKey === k);
+        if (!p)
+            throw new Error(`aggregate: 未知列 ${table.name}.${k}`);
+        return p;
+    };
+    for (const k of [...groupBy, ...sum, ...avg, ...min, ...max])
+        planOf(k);
+    const where = opts.where ? compileWhere(table, opts.where) : { text: '', params: [] };
+    const params = [...where.params];
+    const fragmentSQL = (frag) => {
+        if (!frag)
+            return '';
+        if (!isSqlFragment(frag))
+            throw new Error('aggregate: having/orderBy 必须是 sql 片段');
+        let out = frag.strings[0] ?? '';
+        frag.params.forEach((p, i) => {
+            params.push(p);
+            out += `$${params.length}${frag.strings[i + 1] ?? ''}`;
+        });
+        return out;
+    };
+    const selects = [];
+    const groupCols = [];
+    for (const k of groupBy) {
+        const col = quoteIdent(planOf(k).dbKey);
+        groupCols.push(col);
+        selects.push(`${col} as ${quoteIdent(k)}`);
+    }
+    selects.push('count(*)::int as "count"');
+    for (const k of sum)
+        selects.push(`sum(${quoteIdent(planOf(k).dbKey)})::text as ${quoteIdent(`sum_${k}`)}`);
+    for (const k of avg)
+        selects.push(`avg(${quoteIdent(planOf(k).dbKey)})::text as ${quoteIdent(`avg_${k}`)}`);
+    for (const k of min)
+        selects.push(`min(${quoteIdent(planOf(k).dbKey)}) as ${quoteIdent(`min_${k}`)}`);
+    for (const k of max)
+        selects.push(`max(${quoteIdent(planOf(k).dbKey)}) as ${quoteIdent(`max_${k}`)}`);
+    let text = `select ${selects.join(', ')} from ${quoteIdent(table.name)}`;
+    if (where.text)
+        text += ` where ${where.text}`;
+    if (groupCols.length > 0)
+        text += ` group by ${groupCols.join(', ')}`;
+    const having = fragmentSQL(opts.having);
+    if (having)
+        text += ` having ${having}`;
+    const order = fragmentSQL(opts.orderBy);
+    if (order)
+        text += ` order by ${order}`;
+    if (opts.limit !== undefined) {
+        if (!Number.isInteger(opts.limit) || opts.limit < 0)
+            throw new Error('limit 必须是非负整数');
+        params.push(opts.limit);
+        text += ` limit $${params.length}`;
+    }
+    if (opts.offset !== undefined) {
+        if (!Number.isInteger(opts.offset) || opts.offset < 0)
+            throw new Error('offset 必须是非负整数');
+        params.push(opts.offset);
+        text += ` offset $${params.length}`;
+    }
+    if (run)
+        return await run(text, params, { operation: 'aggregate', table: table.name });
+    return await raw.unsafe(text, params);
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,aAAa,EAA4C,MAAM,YAAY,CAAA;AAsCpF,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAA;AAQtE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAiB,EACjB,KAAY,EACZ,IAA+D,EAC/D,YAAqB,EACrB,GAAqB;IAErB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;IAClC,IAAI,YAAY,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAElF,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAA;QAChD,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;QAC5D,OAAO,CAAC,CAAA;IACV,CAAC,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC;QAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAEvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAe,EAAE,CAAA;IAClG,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IAEhC,MAAM,WAAW,GAAG,CAAC,IAA6B,EAAU,EAAE;QAC5D,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAA;QACpB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QACjF,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACd,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;QACxD,CAAC,CAAC,CAAA;QACF,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,SAAS,GAAa,EAAE,CAAA;IAC9B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACvC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnB,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IACxC,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC3G,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC3G,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACrG,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAErG,IAAI,IAAI,GAAG,UAAU,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAA;IACxE,IAAI,KAAK,CAAC,IAAI;QAAE,IAAI,IAAI,UAAU,KAAK,CAAC,IAAI,EAAE,CAAA;IAC9C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,IAAI,aAAa,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;IACrE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,MAAM;QAAE,IAAI,IAAI,WAAW,MAAM,EAAE,CAAA;IACvC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,KAAK;QAAE,IAAI,IAAI,aAAa,KAAK,EAAE,CAAA;IAEvC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAA;QACrF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,IAAI,IAAI,WAAW,MAAM,CAAC,MAAM,EAAE,CAAA;IACpC,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA;QACxF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACxB,IAAI,IAAI,YAAY,MAAM,CAAC,MAAM,EAAE,CAAA;IACrC,CAAC;IAED,IAAI,GAAG;QAAE,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAmC,CAAA;IACxH,OAAO,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAe,CAA8C,CAAA;AAC7F,CAAC"}