@ai0x0/utils 0.0.36 → 0.0.38

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

@@ -0,0 +1,133 @@
+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 ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+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); }
+/* eslint-disable no-unused-vars */
+import { z } from "zod";
+import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+import { createInsertSchema, createSelectSchema, createUpdateSchema } from "drizzle-zod";
+
+//============================基本字段============================//
+var timestamp = function timestamp(name) {
+  return integer(name, {
+    mode: "timestamp_ms"
+  });
+};
+var now = function now() {
+  return new Date();
+};
+var id = function id() {
+  return crypto.randomUUID();
+};
+var createdAt = function createdAt() {
+  return timestamp("created_at").notNull().$defaultFn(now);
+};
+var updatedAt = function updatedAt() {
+  return timestamp("updated_at").notNull().$defaultFn(now);
+};
+var accessedAt = function accessedAt() {
+  return timestamp("accessed_at").notNull().$defaultFn(now);
+};
+export var basicFields = {
+  id: text("id").primaryKey().$defaultFn(id),
+  creatorId: text("creator_id"),
+  editorId: text("editor_id"),
+  accessedAt: accessedAt(),
+  createdAt: createdAt(),
+  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
+};
+
+//============================列表查询字段============================//
+export var queryListSchema = function queryListSchema(schema) {
+  return z.object({
+    current: z.string().optional().default("1"),
+    // 默认页码为 1
+    pageSize: z.string().optional().default("10"),
+    // 默认每页条数为 10
+    createdAtFrom: z.string().optional(),
+    // 筛选开始日期
+    createdAtTo: z.string().optional(),
+    // 筛选结束日期
+    orderBy: z.string().optional(),
+    creatorId: z.string().optional(),
+    orderDir: z.enum(["asc", "desc"]).optional()
+  }).merge(schema);
+};
+
+//============================列表返回字段============================//
+export var listBodySchema = function listBodySchema(schema) {
+  return z.object({
+    total: z.number(),
+    data: z.array(schema)
+  });
+};
+
+//============================创建一个sqlite表============================//
+/**
+ * 基于 drizzle + drizzle-zod 快速生成带基础字段（id / 创建时间等）的
+ * 表定义以及 select / insert / update / query / list zod schema。
+ */
+export var createTableSchema = function createTableSchema(_ref) {
+  var name = _ref.name,
+    columns = _ref.columns,
+    extraConfig = _ref.extraConfig;
+  var mergedColumns = _objectSpread(_objectSpread({}, basicFields), columns);
+  var table = sqliteTable(name, mergedColumns, extraConfig);
+  var selectSchema = createSelectSchema(table);
+  var insertSchema = createInsertSchema(sqliteTable(name, columns));
+  var updateSchema = createUpdateSchema(sqliteTable(name, _objectSpread({
+    id: text("id")
+  }, columns))).extend({
+    id: z.string()
+  });
+  var querySchema = z.object({
+    id: z.string()
+  });
+  var queryListWithSchema = queryListSchema(z.object({}).catchall(z.unknown()));
+  return {
+    table: table,
+    selectSchema: selectSchema,
+    insertSchema: insertSchema,
+    updateSchema: updateSchema,
+    querySchema: querySchema,
+    queryListSchema: queryListWithSchema,
+    queryListSelectSchema: selectSchema
+  };
+};

package/es/backend/sqlite/types.d.ts

@@ -0,0 +1,16 @@
+import { AnySQLiteColumn, SQLiteTable } from "drizzle-orm/sqlite-core";
+import { SQL } from "drizzle-orm";
+export interface BaseTable extends SQLiteTable {
+    id: AnySQLiteColumn;
+    creatorId: AnySQLiteColumn;
+    editorId: AnySQLiteColumn;
+    accessedAt: AnySQLiteColumn;
+    createdAt: AnySQLiteColumn;
+    updatedAt: AnySQLiteColumn;
+}
+export type GetListRelations = {
+    groupBy?: boolean;
+    select?: Record<string, unknown>;
+    sql?: SQL;
+    table?: BaseTable;
+}[];

package/es/backend/sqlite/types.js

@@ -0,0 +1 @@
+export {};

package/eslint-rules/require-section-divider.js

@@ -3,11 +3,10 @@
  * ------------------------
  * 约束：大文件必须在顶层用 `=====` 等号注释块做分区。
  *
- * 分区要求（按行数）：
- *   - 150 ~ 349 行：至少 1 个分区块
- *   - 350 ~ 549 行：至少 2 个分区块
- *   - 550 ~ 749 行：至少 3 个分区块
- *   以此类推，每 200 行增加 1 个分区块。
+ * 分区要求：
+ *   - 行数只作为最低检查下限
+ *   - AI 应按业务模块、状态、数据流、工具函数等结构尽量多加分区注释
+ *   - 不要只按“150 行一个”机械补齐
  *
  * 分隔注释块格式（见 node_modules/@ai0x0/utils/.agents/skills/nextjs/SKILL.md）：
  *
@@ -78,7 +77,7 @@ const rule = {
     ],
     messages: {
       missing:
-        "大文件需要更多 `===` 等号注释块分区。当前需要 {{required}} 个，实际只有 {{actual}} 个。每约 150 行至少应有一个分区块。",
+        "大文件需要更多 `===` 等号注释块分区。当前最低需要 {{required}} 个，实际只有 {{actual}} 个。请 AI 按业务模块尽量多加分区注释，不要只按 150 行一个机械补齐。",
     },
   },
   create(context) {

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

@@ -0,0 +1,8 @@
+import { BaseTable } from "../types.js";
+export declare function createDeleteAction<TTable extends BaseTable>({ table, db, }: {
+    db: any;
+    table: TTable;
+}): ({ id, creatorId }: {
+    id: string;
+    creatorId?: string | undefined;
+}) => Promise<any>;

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

@@ -0,0 +1,53 @@
+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, desc) => {
+  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: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/backend/sqlite/actions/create-delete-action.ts
+var create_delete_action_exports = {};
+__export(create_delete_action_exports, {
+  createDeleteAction: () => createDeleteAction
+});
+module.exports = __toCommonJS(create_delete_action_exports);
+var import_drizzle_orm = require("drizzle-orm");
+var import_sqlite = require("..");
+var import_zod = require("zod");
+var import_errors = require("../errors");
+function createDeleteAction({
+  table,
+  db
+}) {
+  return async ({ id, creatorId }) => {
+    if (creatorId) {
+      const data = await (0, import_sqlite.createGetAction)({
+        db,
+        table,
+        bodySchema: import_zod.z.object({
+          creatorId: import_zod.z.string(),
+          id: import_zod.z.string()
+        })
+      })({ creatorId, id });
+      if (!data) {
+        throw new import_errors.HttpError(404, "未找到删除对象，或没有权限");
+      }
+    }
+    return db.delete(table).where((0, import_drizzle_orm.eq)(table.id, id)).returning();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDeleteAction
+});

package/lib/backend/sqlite/actions/create-get-action.d.ts

@@ -0,0 +1,8 @@
+import { BaseTable, GetListRelations } from "../types.js";
+export declare function createGetAction<TTable extends BaseTable>({ bodySchema, db, jsonArrayFields, relations, table, }: {
+    bodySchema: any;
+    db: any;
+    jsonArrayFields?: string[];
+    relations?: GetListRelations;
+    table: TTable;
+}): (params: Record<string, unknown>) => Promise<unknown>;

package/lib/backend/sqlite/actions/create-get-action.js

@@ -0,0 +1,65 @@
+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, desc) => {
+  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: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/backend/sqlite/actions/create-get-action.ts
+var create_get_action_exports = {};
+__export(create_get_action_exports, {
+  createGetAction: () => createGetAction
+});
+module.exports = __toCommonJS(create_get_action_exports);
+var import_get_list_query = require("./get-list-query");
+var import_get_list_data = require("./get-list-data");
+function createGetAction({
+  bodySchema,
+  db,
+  jsonArrayFields,
+  relations,
+  table
+}) {
+  return async (params) => {
+    const fields = {};
+    for (const key of Object.keys(bodySchema.shape)) {
+      const field = table[key];
+      if (field) {
+        fields[key] = field;
+      }
+    }
+    const { query, countQuery } = (0, import_get_list_query.getListQuery)({
+      db,
+      fields,
+      jsonArrayFields,
+      params,
+      relations,
+      table
+    });
+    const {
+      data: [result]
+    } = await (0, import_get_list_data.getListData)({
+      bodySchema,
+      countQuery,
+      current: 1,
+      pageSize: 1,
+      query
+    })();
+    return result;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGetAction
+});

package/lib/backend/sqlite/actions/create-get-list-action.d.ts

@@ -0,0 +1,11 @@
+import { BaseTable, GetListRelations } from "../types.js";
+export declare function createGetListAction<TTable extends BaseTable>({ bodySchema, db, jsonArrayFields, relations, table, }: {
+    bodySchema: any;
+    db: any;
+    jsonArrayFields?: string[];
+    relations?: GetListRelations;
+    table: TTable;
+}): (params: Record<string, unknown>) => Promise<{
+    data: unknown[];
+    total: number;
+}>;

package/lib/backend/sqlite/actions/create-get-list-action.js

@@ -0,0 +1,63 @@
+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, desc) => {
+  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: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/backend/sqlite/actions/create-get-list-action.ts
+var create_get_list_action_exports = {};
+__export(create_get_list_action_exports, {
+  createGetListAction: () => createGetListAction
+});
+module.exports = __toCommonJS(create_get_list_action_exports);
+var import_get_list_query = require("./get-list-query");
+var import_get_list_data = require("./get-list-data");
+function createGetListAction({
+  bodySchema,
+  db,
+  jsonArrayFields,
+  relations,
+  table
+}) {
+  return async (params) => {
+    const { current, pageSize, ...other } = params;
+    const fields = {};
+    for (const key of Object.keys(bodySchema.shape)) {
+      const field = table[key];
+      if (field) {
+        fields[key] = field;
+      }
+    }
+    const { query, countQuery } = (0, import_get_list_query.getListQuery)({
+      db,
+      fields,
+      jsonArrayFields,
+      params: other,
+      relations,
+      table
+    });
+    return (0, import_get_list_data.getListData)({
+      bodySchema,
+      countQuery,
+      current,
+      pageSize,
+      query
+    })();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGetListAction
+});

package/lib/backend/sqlite/actions/create-post-action.d.ts

@@ -0,0 +1,6 @@
+import { SQLiteTable } from "drizzle-orm/sqlite-core";
+export declare function createPostAction<TTable extends SQLiteTable>({ table, db, }: {
+    bodySchema: any;
+    db: any;
+    table: TTable;
+}): (body: Record<string, unknown>) => Promise<any[]>;

package/lib/backend/sqlite/actions/create-post-action.js

@@ -0,0 +1,39 @@
+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, desc) => {
+  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: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/backend/sqlite/actions/create-post-action.ts
+var create_post_action_exports = {};
+__export(create_post_action_exports, {
+  createPostAction: () => createPostAction
+});
+module.exports = __toCommonJS(create_post_action_exports);
+var import_transform_body = require("./transform-body");
+function createPostAction({
+  table,
+  db
+}) {
+  return async (body) => {
+    const values = (0, import_transform_body.transformBody)(body);
+    const result = await db.insert(table).values(values).returning();
+    return result;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPostAction
+});

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

@@ -0,0 +1,8 @@
+import { BaseTable } from "../types.js";
+export declare function createPutAction<TTable extends BaseTable>({ db, table, }: {
+    bodySchema: any;
+    db: any;
+    table: TTable;
+}): (body: Record<string, unknown>, { byCreator, }?: {
+    byCreator?: boolean | undefined;
+}) => Promise<any>;

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

@@ -0,0 +1,60 @@
+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, desc) => {
+  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: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/backend/sqlite/actions/create-put-action.ts
+var create_put_action_exports = {};
+__export(create_put_action_exports, {
+  createPutAction: () => createPutAction
+});
+module.exports = __toCommonJS(create_put_action_exports);
+var import_zod = require("zod");
+var import_transform_body = require("./transform-body");
+var import_drizzle_orm = require("drizzle-orm");
+var import_sqlite = require("..");
+var import_errors = require("../errors");
+function createPutAction({
+  db,
+  table
+}) {
+  return async (body, {
+    byCreator = true
+  } = {}) => {
+    if (byCreator) {
+      const data2 = await (0, import_sqlite.createGetAction)({
+        db,
+        table,
+        bodySchema: import_zod.z.object({
+          creatorId: import_zod.z.string(),
+          id: import_zod.z.string()
+        })
+      })({
+        creatorId: body.editorId,
+        id: body.id
+      });
+      if (!data2) {
+        throw new import_errors.HttpError(404, "未找到编辑对象，或没有权限");
+      }
+    }
+    const [data] = await db.update(table).set((0, import_transform_body.transformBody)(body)).where((0, import_drizzle_orm.eq)(table.id, body.id)).returning();
+    return data;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPutAction
+});

package/lib/backend/sqlite/actions/get-list-data.d.ts

@@ -0,0 +1,9 @@
+import { getListQuery } from "./get-list-query.js";
+export declare function getListData({ query, countQuery, pageSize, current, }: {
+    bodySchema?: any;
+    current?: number;
+    pageSize?: number;
+} & ReturnType<typeof getListQuery>): () => Promise<{
+    data: unknown[];
+    total: number;
+}>;

package/lib/backend/sqlite/actions/get-list-data.js

@@ -0,0 +1,51 @@
+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, desc) => {
+  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: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/backend/sqlite/actions/get-list-data.ts
+var get_list_data_exports = {};
+__export(get_list_data_exports, {
+  getListData: () => getListData
+});
+module.exports = __toCommonJS(get_list_data_exports);
+async function runSelect(query) {
+  const executable = query;
+  if (executable.all) {
+    return executable.all();
+  }
+  if (executable.execute) {
+    return executable.execute();
+  }
+  return [];
+}
+function getListData({
+  query,
+  countQuery,
+  pageSize = 10,
+  current = 1
+}) {
+  return async () => {
+    const dataQuery = query.limit(+pageSize).offset((+current - 1) * +pageSize);
+    const data = await runSelect(dataQuery);
+    const [{ count }] = await runSelect(countQuery);
+    return { data, total: Number(count) };
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getListData
+});

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

@@ -0,0 +1,19 @@
+import { BaseTable, GetListRelations } from "../types.js";
+import { SelectedFields } from "drizzle-orm/sqlite-core/query-builders/select.types";
+export declare function getListQuery<TTable extends BaseTable, TSelection extends SelectedFields>({ db, fields, jsonArrayFields, params, relations, table, }: {
+    db: any;
+    fields: TSelection;
+    jsonArrayFields?: string[];
+    params: {
+        [field: string]: unknown;
+        orderBy?: keyof BaseTable;
+        orderDir?: "asc" | "desc";
+        page?: number;
+        pageSize?: number;
+    };
+    relations?: GetListRelations;
+    table: TTable;
+}): {
+    countQuery: any;
+    query: any;
+};