@ai0x0/utils 0.6.0 → 0.6.1

package/es/backend/sqlite/errors.js

@@ -1,31 +1,6 @@
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
-function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
-function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
-function _wrapNativeSuper(Class) { var _cache = typeof Map === "function" ? new Map() : undefined; _wrapNativeSuper = function _wrapNativeSuper(Class) { if (Class === null || !_isNativeFunction(Class)) return Class; if (typeof Class !== "function") { throw new TypeError("Super expression must either be null or a function"); } if (typeof _cache !== "undefined") { if (_cache.has(Class)) return _cache.get(Class); _cache.set(Class, Wrapper); } function Wrapper() { return _construct(Class, arguments, _getPrototypeOf(this).constructor); } Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } }); return _setPrototypeOf(Wrapper, Class); }; return _wrapNativeSuper(Class); }
-function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct.bind(); } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
-function _isNativeFunction(fn) { try { return Function.toString.call(fn).indexOf("[native code]") !== -1; } catch (e) { return typeof fn === "function"; } }
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
-function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
-function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-export var HttpError = /*#__PURE__*/function (_Error) {
-  _inherits(HttpError, _Error);
-  var _super = _createSuper(HttpError);
-  function HttpError(status, message) {
-    var _this;
-    _classCallCheck(this, HttpError);
-    _this = _super.call(this, message);
-    _defineProperty(_assertThisInitialized(_this), "status", void 0);
-    _this.name = "HttpError";
-    _this.status = status;
-    return _this;
-  }
-  return _createClass(HttpError);
-}( /*#__PURE__*/_wrapNativeSuper(Error));
+// HttpError 与 pg 那套是同一个类，没有任何方言相关的东西 —— 从前这里是逐字抄的一份副本，
+// 于是「同一个错误」在两棵树里是两个类：`instanceof` 互不认，而 handleOperationError 判的是
+// `error.name === "HttpError"`，副本恰好蒙混过关，所以这份重复一直没被发现。
+//
+// 现在直接转出去。sqlite 的调用方仍然从 `@/backend/sqlite/errors` 引，import 路径不用改。
+export { HttpError } from "../errors.js";

package/es/backend/sqlite/schemas/index.d.ts

@@ -1,4 +1,3 @@
-import { z } from "zod";
 import { type SQLiteColumnBuilderBase, type SQLiteTableExtraConfigValue } from "drizzle-orm/sqlite-core";
 import type { BuildExtraConfigColumns } from "drizzle-orm";
 export declare const basicFields: {
@@ -9,116 +8,7 @@ export declare const basicFields: {
     createdAt: import("drizzle-orm").HasRuntimeDefault<import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/sqlite-core").SQLiteTimestampBuilderInitial<string>>>>;
     updatedAt: import("drizzle-orm").HasRuntimeDefault<import("drizzle-orm").HasDefault<import("drizzle-orm").NotNull<import("drizzle-orm/sqlite-core").SQLiteTimestampBuilderInitial<string>>>>;
 };
-/**
- * 业务侧 insert schema 需要从 drizzle-zod 生成的 schema 中排除的基础字段。
- * 这些字段由后端在 createPostAction 中自动写入。
- *
- * 使用方式（在业务 schema 中）：
- *   const insertFooSchema = createInsertSchema(foos)
- *     .omit(BASIC_INSERT_OMIT)
- *     .extend({ ... });
- *
- * 说明：上游导出为 const 而不是 helper function，是为了避免经过泛型
- * wrapper 后 TS 把 drizzle-zod 推导出的深层条件 Shape 归约成 Omit，
- * 从而在下游 `.extend(...)` 时丢失原有字段类型。
- */
-export declare const BASIC_INSERT_OMIT: {
-    readonly id: true;
-    readonly creatorId: true;
-    readonly editorId: true;
-    readonly accessedAt: true;
-    readonly createdAt: true;
-    readonly updatedAt: true;
-};
-/**
- * 业务侧 update schema 需要从 drizzle-zod 生成的 schema 中排除的基础字段。
- * update 保留 id（随后用 `.required({ id: true })` 变成必填），其余由
- * 后端 createPutAction 自动维护。
- */
-export declare const BASIC_UPDATE_OMIT: {
-    readonly creatorId: true;
-    readonly editorId: true;
-    readonly accessedAt: true;
-    readonly createdAt: true;
-    readonly updatedAt: true;
-};
-export declare const queryListSchema: <Incoming extends z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>>(schema: Incoming) => z.ZodObject<(("creatorId" | "orderBy" | "orderDir" | "pageSize" | "current" | "createdAtFrom" | "createdAtTo") & keyof Incoming["shape"] extends never ? {
-    current: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    pageSize: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    createdAtFrom: z.ZodOptional<z.ZodString>;
-    createdAtTo: z.ZodOptional<z.ZodString>;
-    orderBy: z.ZodOptional<z.ZodString>;
-    creatorId: z.ZodOptional<z.ZodString>;
-    orderDir: z.ZodOptional<z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>>;
-} & Incoming["shape"] : ({
-    current: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    pageSize: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    createdAtFrom: z.ZodOptional<z.ZodString>;
-    createdAtTo: z.ZodOptional<z.ZodString>;
-    orderBy: z.ZodOptional<z.ZodString>;
-    creatorId: z.ZodOptional<z.ZodString>;
-    orderDir: z.ZodOptional<z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>>;
-} extends infer T_1 extends z.core.util.SomeObject ? { [K in keyof T_1 as K extends keyof Incoming["shape"] ? never : K]: {
-    current: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    pageSize: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    createdAtFrom: z.ZodOptional<z.ZodString>;
-    createdAtTo: z.ZodOptional<z.ZodString>;
-    orderBy: z.ZodOptional<z.ZodString>;
-    creatorId: z.ZodOptional<z.ZodString>;
-    orderDir: z.ZodOptional<z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>>;
-}[K]; } : never) & (Incoming["shape"] extends infer T_2 extends z.core.util.SomeObject ? { [K_1 in keyof T_2]: Incoming["shape"][K_1]; } : never)) extends infer T ? { [k in keyof T]: (("creatorId" | "orderBy" | "orderDir" | "pageSize" | "current" | "createdAtFrom" | "createdAtTo") & keyof Incoming["shape"] extends never ? {
-    current: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    pageSize: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    createdAtFrom: z.ZodOptional<z.ZodString>;
-    createdAtTo: z.ZodOptional<z.ZodString>;
-    orderBy: z.ZodOptional<z.ZodString>;
-    creatorId: z.ZodOptional<z.ZodString>;
-    orderDir: z.ZodOptional<z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>>;
-} & Incoming["shape"] : ({
-    current: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    pageSize: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    createdAtFrom: z.ZodOptional<z.ZodString>;
-    createdAtTo: z.ZodOptional<z.ZodString>;
-    orderBy: z.ZodOptional<z.ZodString>;
-    creatorId: z.ZodOptional<z.ZodString>;
-    orderDir: z.ZodOptional<z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>>;
-} extends infer T_1 extends z.core.util.SomeObject ? { [K in keyof T_1 as K extends keyof Incoming["shape"] ? never : K]: {
-    current: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    pageSize: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    createdAtFrom: z.ZodOptional<z.ZodString>;
-    createdAtTo: z.ZodOptional<z.ZodString>;
-    orderBy: z.ZodOptional<z.ZodString>;
-    creatorId: z.ZodOptional<z.ZodString>;
-    orderDir: z.ZodOptional<z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>>;
-}[K]; } : never) & (Incoming["shape"] extends infer T_2 extends z.core.util.SomeObject ? { [K_1 in keyof T_2]: Incoming["shape"][K_1]; } : never))[k]; } : never, Incoming["_zod"]["config"]>;
-export declare const listBodySchema: <T extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>(schema: T) => z.ZodObject<{
-    total: z.ZodNumber;
-    data: z.ZodArray<T>;
-}, z.core.$strip>;
-/**
- * 给 schema 上已有的字段挂说明。字段不在这个 schema 里就跳过 —— 同一张表的
- * insert / update / select 三份含的列不一样（basicFields 只在 select 里），一份说明表要能同时
- * 喂给三者，就不能对「字段一定存在」有要求。**不给不存在的字段凭空造一个。**
- */
-export declare const describeFields: <T extends z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>>(schema: T, notes: Record<string, string>) => T;
+export { BASIC_INSERT_OMIT, BASIC_UPDATE_OMIT, describeFields, listBodySchema, queryListSchema, } from "../../schemas/common.js";
 /**
  * 基于 drizzle + drizzle-zod 快速生成带基础字段（id / 创建时间等）的
  * 表定义以及 select / insert / update / query / list zod schema。

package/es/backend/sqlite/schemas/index.js

@@ -4,12 +4,6 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
-function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { z } from "zod";
 import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
 import { createInsertSchema, createSelectSchema, createUpdateSchema } from "drizzle-zod";
@@ -46,141 +40,16 @@ export var basicFields = {
   updatedAt: updatedAt()
 };
 
-/**
- * 业务侧 insert schema 需要从 drizzle-zod 生成的 schema 中排除的基础字段。
- * 这些字段由后端在 createPostAction 中自动写入。
- *
- * 使用方式（在业务 schema 中）：
- *   const insertFooSchema = createInsertSchema(foos)
- *     .omit(BASIC_INSERT_OMIT)
- *     .extend({ ... });
- *
- * 说明：上游导出为 const 而不是 helper function，是为了避免经过泛型
- * wrapper 后 TS 把 drizzle-zod 推导出的深层条件 Shape 归约成 Omit，
- * 从而在下游 `.extend(...)` 时丢失原有字段类型。
- */
-export var BASIC_INSERT_OMIT = {
-  id: true,
-  creatorId: true,
-  editorId: true,
-  accessedAt: true,
-  createdAt: true,
-  updatedAt: true
-};
-
-/**
- * 业务侧 update schema 需要从 drizzle-zod 生成的 schema 中排除的基础字段。
- * update 保留 id（随后用 `.required({ id: true })` 变成必填），其余由
- * 后端 createPutAction 自动维护。
- */
-export var BASIC_UPDATE_OMIT = {
-  creatorId: true,
-  editorId: true,
-  accessedAt: true,
-  createdAt: true,
-  updatedAt: true
-};
-
-// =============================================================================
-// 列表查询字段
-// =============================================================================
-// 说明写成 `.describe()` 而不是行末注释：注释只有读源码的人看得到，而这七个字段会出现在每一个
-// list 端点的 OpenAPI spec 里，再从那里流进生成的 client 与 CLI 文档。写成注释的代价是下游只能
-// 自己再手写一份 —— 那份必然会漂，而且漂了没有任何东西会报错。
-//
-// 类型是 string 而不是 number：query 参数在线上只有字符串，服务端收下之后才转数字。默认值也
-// 因此是 "1" / "10"。
-export var queryListSchema = function queryListSchema(schema) {
-  return z.object({
-    current: z.string().optional().default("1").describe("Page number, starting at 1."),
-    pageSize: z.string().optional().default("10").describe("Rows per page. Omitting it yields only 10 — pass a larger value to get the whole set."),
-    createdAtFrom: z.string().optional().describe("Keep only rows created at or after this instant (ISO 8601, e.g. 2026-08-01T00:00:00Z)."),
-    createdAtTo: z.string().optional().describe("Keep only rows created at or before this instant."),
-    orderBy: z.string().optional().describe("Column to sort by — a column name of this resource (createdAt / updatedAt and the like)."),
-    creatorId: z.string().optional().describe("Keep only rows created by this user. Useful in shared spaces to filter down to one member."),
-    orderDir: z.enum(["asc", "desc"]).optional().describe("Sort ascending or descending.")
-  }).merge(schema);
-};
-
 // =============================================================================
-// 列表返回字段
+// 与方言无关的那几份助手
 // =============================================================================
-// 这两个字段出现在**每一个** list 端点的响应里，所以说明写在这儿一次就够 —— 下游那边它们是
-// 逐个 list 命令重复一遍的（在一个 101 端点的项目上是 24 行空白）。
-export var listBodySchema = function listBodySchema(schema) {
-  return z.object({
-    total: z.number().describe("Total number of rows matching the filters — not the length of `data`. Use it to decide whether another page exists."),
-    data: z.array(schema).describe("This page's rows.")
-  });
-};
-
-// =============================================================================
-// 给基础字段挂说明
-// =============================================================================
-// basicFields 是 drizzle 列，而 drizzle 列没有「描述」这个概念 —— 所以说明只能挂在
-// drizzle-zod 出来的 schema 上。值得做是因为这六个字段出现在**每一张表**的 select schema 里：
-// 一处写完，所有 list / get 端点的返回字段都有说明了。
-//
-// 一律只挂元数据，**不换类型**：`.describe()` / `.meta()` 返回的是带元数据的克隆，校验行为一模
-// 一样。selectSchema 是有人拿去 safeParse 的（本包自己的测试就在用 Date 校验它），换类型等于改
-// 这个包的契约。
-//
-// 时间戳那三列额外用 `.meta()` 补上 JSON Schema 表示，因为不补就是错的：drizzle-zod 给的是
-// `z.date()`，而 `Date` 在 JSON Schema 里表达不出来，于是这三个字段在 spec 里是**空对象** ——
-// 没有 `type`，照 spec 生成的 client / CLI 只能得到 `unknown`。而线上根本不可能是 Date：响应一经
-// JSON 序列化就是 ISO 8601 字符串。
-//
-// `.meta({ type, format })` 恰好只改「怎么描述」不改「怎么校验」：spec 里成为
-// `{"type":"string","format":"date-time"}`，而 `safeParse(new Date())` 照样通过。
-// 不用 `z.iso.datetime()` 换掉它，是因为那既改了校验（不再收 Date），又会往 JSON Schema 里塞一条
-// 380 字节的正则 —— 乘上每张表几十 KB，而 `format` 已经把「按日期时间解析」说清楚了。
-var BASIC_FIELD_NOTES = {
-  creatorId: "User id of the creator. Stamped by the server; clients cannot send it.",
-  editorId: "User id of whoever changed this row last. Stamped by the server; clients cannot send it.",
-  id: "Primary key of this row (uuid)."
-};
-var BASIC_TIMESTAMP_NOTES = {
-  accessedAt: "When this row was last accessed.",
-  createdAt: "When this row was created.",
-  updatedAt: "When this row was last modified."
-};
-
-/**
- * 给 schema 上已有的字段挂说明。字段不在这个 schema 里就跳过 —— 同一张表的
- * insert / update / select 三份含的列不一样（basicFields 只在 select 里），一份说明表要能同时
- * 喂给三者，就不能对「字段一定存在」有要求。**不给不存在的字段凭空造一个。**
- */
-export var describeFields = function describeFields(schema, notes) {
-  var overlay = {};
-  for (var _i = 0, _Object$entries = Object.entries(notes); _i < _Object$entries.length; _i++) {
-    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
-      field = _Object$entries$_i[0],
-      note = _Object$entries$_i[1];
-    var existing = schema.shape[field];
-    if (existing) {
-      overlay[field] = existing.describe(note);
-    }
-  }
-  return Object.keys(overlay).length ? schema.extend(overlay) : schema;
-};
-var describeBasicFields = function describeBasicFields(schema) {
-  var withNotes = describeFields(schema, BASIC_FIELD_NOTES);
-  var overlay = {};
-  for (var _i2 = 0, _Object$entries2 = Object.entries(BASIC_TIMESTAMP_NOTES); _i2 < _Object$entries2.length; _i2++) {
-    var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2),
-      field = _Object$entries2$_i[0],
-      note = _Object$entries2$_i[1];
-    var existing = withNotes.shape[field];
-    if (existing) {
-      overlay[field] = existing.meta({
-        description: note,
-        format: "date-time",
-        type: "string"
-      });
-    }
-  }
-  return Object.keys(overlay).length ? withNotes.extend(overlay) : withNotes;
-};
+// BASIC_INSERT_OMIT / BASIC_UPDATE_OMIT / queryListSchema / listBodySchema / describeFields
+// 都只碰 zod，两套方言逐字相同 —— 实现搬去了 schemas/common，这里原样转出去，调用方的
+// import 路径一个字都不用改。
+// createTableSchema 自己也要用其中几个 —— `export ... from` 只转发、不把名字带进
+// 本地作用域，所以这里还得再 import 一次。
+import { describeBasicFields, describeFields, queryListSchema } from "../../schemas/common.js";
+export { BASIC_INSERT_OMIT, BASIC_UPDATE_OMIT, describeFields, listBodySchema, queryListSchema } from "../../schemas/common.js";
 
 // =============================================================================
 // 建表 —— 表 + 5 份 zod schema

package/lib/backend/actions/create-delete-action.d.ts

@@ -1,11 +1,10 @@
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
 import { BaseTable } from "../types.js";
-import { ScopeArg } from "../scope.js";
 export declare function createDeleteAction<TTable extends BaseTable>({ table, db, }: {
     db: NodePgDatabase<Record<string, unknown>>;
     table: TTable;
 }): ({ id }: {
     id: string;
 }, { scope }: {
-    scope: ScopeArg;
-}) => Promise<TTable["$inferSelect"] extends infer T ? T extends TTable["$inferSelect"] ? T extends undefined ? QueryResult<import("drizzle-orm").Assume<this["row"], QueryResultRow>> : T[] : never : never>;
+    scope: import("..").ScopeArg;
+}) => Promise<any>;

package/lib/backend/actions/create-delete-action.js

@@ -22,24 +22,12 @@ __export(create_delete_action_exports, {
   createDeleteAction: () => createDeleteAction
 });
 module.exports = __toCommonJS(create_delete_action_exports);
-var import_drizzle_orm = require("drizzle-orm");
-var import_scope = require("../scope");
-var import_errors = require("../errors");
+var import_write_action_core = require("./write-action-core");
 function createDeleteAction({
   table,
   db
 }) {
-  return async ({ id }, { scope }) => {
-    if (!id) {
-      throw new import_errors.HttpError(400, "缺少 id");
-    }
-    const guard = (0, import_scope.scopeCondition)(table, scope);
-    const rows = await db.delete(table).where(guard ? (0, import_drizzle_orm.and)((0, import_drizzle_orm.eq)(table.id, id), guard) : (0, import_drizzle_orm.eq)(table.id, id)).returning();
-    if (rows.length === 0 && scope !== import_scope.NO_SCOPE) {
-      throw new import_errors.HttpError(404, "未找到删除对象，或没有权限");
-    }
-    return rows;
-  };
+  return (0, import_write_action_core.createDeleteActionCore)({ db, table });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/backend/actions/create-put-action.d.ts

@@ -6,6 +6,6 @@ export declare function createPutAction<T extends ZodSchema, TTable extends Base
     bodySchema: T;
     db: NodePgDatabase<Record<string, unknown>>;
     table: TTable;
-}): (body: Partial<z.infer<T>> & Record<string, unknown>, { scope }: {
+}): (body: Partial<z.infer<T>> & Record<string, unknown>, options: {
     scope: ScopeArg;
 }) => Promise<z.infer<T>>;

package/lib/backend/actions/create-put-action.js

@@ -22,26 +22,13 @@ __export(create_put_action_exports, {
   createPutAction: () => createPutAction
 });
 module.exports = __toCommonJS(create_put_action_exports);
-var import_transform_body = require("./transform-body");
-var import_drizzle_orm = require("drizzle-orm");
-var import_scope = require("../scope");
-var import_errors = require("../errors");
+var import_write_action_core = require("./write-action-core");
 function createPutAction({
   db,
   table
 }) {
-  return async (body, { scope }) => {
-    const id = body.id;
-    if (!id) {
-      throw new import_errors.HttpError(400, "缺少 id");
-    }
-    const guard = (0, import_scope.scopeCondition)(table, scope);
-    const [data] = await db.update(table).set((0, import_transform_body.transformBody)(body)).where(guard ? (0, import_drizzle_orm.and)((0, import_drizzle_orm.eq)(table.id, id), guard) : (0, import_drizzle_orm.eq)(table.id, id)).returning();
-    if (!data && scope !== import_scope.NO_SCOPE) {
-      throw new import_errors.HttpError(404, "未找到编辑对象，或没有权限");
-    }
-    return data;
-  };
+  const run = (0, import_write_action_core.createPutActionCore)({ db, table });
+  return async (body, options) => await run(body, options);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/backend/actions/get-list-query-core.d.ts

@@ -0,0 +1,46 @@
+import { Column, SQL } from "drizzle-orm";
+import { ScopeArg } from "../scope.js";
+/**
+ * 核心用得到表的哪一部分：只有 `id`（计数与分组要它）和「按列名取列」。
+ * 两棵树的 BaseTable 都满足它，而 dialect 各自的 Table 类型不必进来。
+ */
+export interface ListQueryTable {
+    id: Column;
+}
+export interface ListQueryRelation {
+    groupBy?: boolean;
+    select?: Record<string, unknown>;
+    sql?: SQL;
+    table?: ListQueryTable;
+}
+/** 两套方言之间**全部**的差异。加第三种数据库时要写的也只有这两条。 */
+export interface ListQueryDialect {
+    /** 大小写不敏感的「包含」。 */
+    contains(_column: Column, _keyword: string): SQL;
+    /** 「这个 JSON 数组列里有没有元素含这段文字」。 */
+    jsonArrayContains(_column: Column, _keyword: string): SQL;
+}
+export interface ListQueryParams {
+    [field: string]: unknown;
+    orderBy?: string;
+    orderDir?: "asc" | "desc";
+    page?: number;
+    pageSize?: number;
+}
+export declare function createGetListQuery(dialect: ListQueryDialect): <TTable extends ListQueryTable, TSelection extends Record<string, unknown>>({ db, fields, jsonArrayFields, params, relations, scope, table, }: {
+    db: any;
+    fields: TSelection;
+    jsonArrayFields?: string[] | undefined;
+    /**
+     * 行级作用域。**必填**，不想隔离就显式传 NO_SCOPE —— 写成可选的话，漏传就退化成查全表，
+     * 而那是静默的越权（见 scope.ts）。它不走下面 params 那条筛选通道，因为那条的规矩是
+     * 「空值跳过」，一个取不到值的作用域会让整条 where 消失。
+     */
+    scope: ScopeArg;
+    params: ListQueryParams;
+    relations?: ListQueryRelation[] | undefined;
+    table: TTable;
+}) => {
+    countQuery: any;
+    query: any;
+};

package/lib/backend/actions/get-list-query-core.js

@@ -0,0 +1,151 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc2) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc2 = __getOwnPropDesc(from, key)) || desc2.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/backend/actions/get-list-query-core.ts
+var get_list_query_core_exports = {};
+__export(get_list_query_core_exports, {
+  createGetListQuery: () => createGetListQuery
+});
+module.exports = __toCommonJS(get_list_query_core_exports);
+var import_drizzle_orm = require("drizzle-orm");
+var import_scope = require("../scope");
+function columnAt(table, key) {
+  return table[key];
+}
+function createGetListQuery(dialect) {
+  return function getListQuery({
+    db,
+    fields,
+    jsonArrayFields,
+    params,
+    relations,
+    scope,
+    table
+  }) {
+    const {
+      page = 1,
+      pageSize = 10,
+      orderBy = "createdAt",
+      orderDir = "desc",
+      ...filters
+    } = params;
+    function buildBaseQuery() {
+      let queryFields = { ...fields };
+      if (relations == null ? void 0 : relations.length) {
+        for (const { select } of relations) {
+          queryFields = { ...queryFields, ...select };
+        }
+      }
+      const query2 = db.select(queryFields).from(table);
+      if (relations == null ? void 0 : relations.length) {
+        query2.groupBy(
+          table.id,
+          ...relations.filter(({ groupBy }) => groupBy).filter(({ table: joined }) => joined).map(({ table: joined }) => joined.id)
+        );
+      }
+      return query2;
+    }
+    function findTargetColumn(key) {
+      return [table].concat(
+        (relations == null ? void 0 : relations.filter(({ table: joined }) => joined).map(({ table: joined }) => joined)) || []
+      ).map((candidate) => columnAt(candidate, key)).find(Boolean);
+    }
+    function addCondition(conditions2, key, value, targetColumn) {
+      const isIdField = /id/i.test(key);
+      const isJsonArray = jsonArrayFields == null ? void 0 : jsonArrayFields.includes(key);
+      if (typeof value !== "string") {
+        conditions2.push((0, import_drizzle_orm.eq)(targetColumn, value));
+        return;
+      }
+      if (value.includes(",")) {
+        const values = value.split(",").map((item) => item.trim()).filter(Boolean);
+        if (!values.length) {
+          return;
+        }
+        if (isJsonArray) {
+          conditions2.push(dialect.jsonArrayContains(targetColumn, values[0]));
+        } else if (isIdField) {
+          conditions2.push((0, import_drizzle_orm.inArray)(targetColumn, values));
+        } else {
+          conditions2.push(
+            (0, import_drizzle_orm.or)(
+              ...values.map((item) => dialect.contains(targetColumn, item))
+            )
+          );
+        }
+        return;
+      }
+      if (isJsonArray) {
+        conditions2.push(dialect.jsonArrayContains(targetColumn, value));
+      } else if (isIdField) {
+        conditions2.push((0, import_drizzle_orm.eq)(targetColumn, value));
+      } else {
+        conditions2.push(dialect.contains(targetColumn, value));
+      }
+    }
+    function buildConditions() {
+      const conditions2 = [];
+      for (const [key, value] of Object.entries(filters)) {
+        if (!value) {
+          continue;
+        }
+        if (key.endsWith("AtFrom") || key.endsWith("AtTo")) {
+          const baseFieldName = key.replace(/(AtFrom|AtTo)$/, "");
+          const targetColumn2 = findTargetColumn(`${baseFieldName}At`);
+          if (!targetColumn2) {
+            continue;
+          }
+          conditions2.push(
+            key.endsWith("AtFrom") ? (0, import_drizzle_orm.gte)(targetColumn2, new Date(value)) : (0, import_drizzle_orm.lte)(targetColumn2, new Date(value))
+          );
+          continue;
+        }
+        const targetColumn = findTargetColumn(key);
+        if (!targetColumn) {
+          continue;
+        }
+        addCondition(conditions2, key, value, targetColumn);
+      }
+      return conditions2;
+    }
+    function buildOrderBy() {
+      const orderColumn = columnAt(table, orderBy);
+      return orderDir === "asc" ? (0, import_drizzle_orm.asc)(orderColumn) : (0, import_drizzle_orm.desc)(orderColumn);
+    }
+    const baseQuery = buildBaseQuery();
+    const scopeSql = (0, import_scope.scopeCondition)(table, scope);
+    const conditions = scopeSql ? [scopeSql] : [];
+    conditions.push(...buildConditions());
+    const where = conditions.length > 0 ? (0, import_drizzle_orm.and)(...conditions) : void 0;
+    const query = baseQuery.where(where).orderBy(buildOrderBy()).limit(pageSize).offset((page - 1) * pageSize);
+    const countQuery = db.select({ count: import_drizzle_orm.sql`COUNT(DISTINCT ${table.id})` }).from(table).where(where);
+    if (relations == null ? void 0 : relations.length) {
+      for (const { table: relationTable, sql: joinSql } of relations) {
+        if (relationTable) {
+          query.leftJoin(relationTable, joinSql);
+          countQuery.leftJoin(relationTable, joinSql);
+        }
+      }
+    }
+    return { countQuery, query };
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGetListQuery
+});

package/lib/backend/actions/get-list-query.d.ts

@@ -1,34 +1,21 @@
 import { BaseTable, GetListRelations } from "../types.js";
 import { SelectedFields } from "drizzle-orm/pg-core/query-builders/select.types";
-import { SQL } from "drizzle-orm";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
 import { ScopeArg } from "../scope.js";
-export declare function getListQuery<TTable extends BaseTable, TSelection extends SelectedFields>({ db, fields, jsonArrayFields, params, relations, scope, table, }: {
+import { type ListQueryParams } from "./get-list-query-core.js";
+export declare function getListQuery<TTable extends BaseTable, TSelection extends SelectedFields>(args: {
     db: NodePgDatabase<Record<string, unknown>>;
     fields: TSelection;
     jsonArrayFields?: string[];
     /**
      * 行级作用域。**必填**，不想隔离就显式传 NO_SCOPE —— 写成可选的话，漏传就退化成查全表，
-     * 而那是静默的越权（见 scope.ts）。它不走下面 params 那条筛选通道，因为那条的规矩是
-     * 「空值跳过」，一个取不到值的作用域会让整条 where 消失。
+     * 而那是静默的越权（见 scope.ts）。
      */
     scope: ScopeArg;
-    params: {
-        [field: string]: unknown;
-        orderBy?: keyof BaseTable;
-        orderDir?: "asc" | "desc";
-        page?: number;
-        pageSize?: number;
-    };
+    params: ListQueryParams;
     relations?: GetListRelations;
     table: TTable;
 }): {
-    countQuery: Omit<import("drizzle-orm/pg-core").PgSelectBase<string, {
-        count: SQL<unknown>;
-    }, "partial", Record<string, "not-null">, false, "where", {
-        count: unknown;
-    }[], {
-        count: import("drizzle-orm").DrizzleTypeError<"You cannot reference this field without assigning it an alias first - use `.as(<alias>)`">;
-    }>, "where">;
+    countQuery: any;
     query: any;
 };