befly 3.9.12 → 3.9.14

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly",
-    "version": "3.9.12",
+    "version": "3.9.14",
     "description": "Befly - 为 Bun 专属打造的 TypeScript API 接口框架核心引擎",
     "type": "module",
     "private": false,
@@ -65,7 +65,7 @@
         "bun": ">=1.3.0"
     },
     "dependencies": {
-        "befly-shared": "^1.2.2",
+        "befly-shared": "^1.2.3",
         "chalk": "^5.6.2",
         "es-toolkit": "^1.42.0",
         "fast-jwt": "^6.1.0",
@@ -74,7 +74,7 @@
         "pino": "^10.1.0",
         "pino-roll": "^4.0.0"
     },
-    "gitHead": "1065d8c11e32a4d9cf6177ad484500c4c98b1e2f",
+    "gitHead": "9f37fe1d7b660c79cbee174865b9d65b1a4ead22",
     "devDependencies": {
         "typescript": "^5.9.3"
     }

package/sync/syncDb/apply.ts

@@ -61,7 +61,7 @@ export function compareFieldDefinition(existingColumn: ColumnInfo, fieldDef: Fie
         }
     }
 
-    // 检查注释变化（MySQL/PG 支持列注释）
+    // 检查注释变化（MySQL/PG 支持列注释，对比数据库 comment 与字段 name）
     if (!isSQLite()) {
         const currentComment = existingColumn.comment || '';
         if (currentComment !== fieldDef.name) {

package/sync/syncDb/constants.ts

@@ -18,17 +18,6 @@ export const DB_VERSION_REQUIREMENTS = {
     SQLITE_MIN_VERSION_NUM: 35000 // 3 * 10000 + 50 * 100
 } as const;
 
-/**
- * 系统字段定义（所有表都包含的固定字段）
- */
-export const SYSTEM_FIELDS = {
-    ID: { name: 'id', comment: '主键ID' },
-    CREATED_AT: { name: 'created_at', comment: '创建时间' },
-    UPDATED_AT: { name: 'updated_at', comment: '更新时间' },
-    DELETED_AT: { name: 'deleted_at', comment: '删除时间' },
-    STATE: { name: 'state', comment: '状态字段' }
-} as const;
-
 /**
  * 需要创建索引的系统字段
  */

package/sync/syncDb/helpers.ts

@@ -81,7 +81,6 @@ export function applyFieldDefaults(fieldDef: any): void {
     fieldDef.default = fieldDef.default ?? null;
     fieldDef.index = fieldDef.index ?? false;
     fieldDef.unique = fieldDef.unique ?? false;
-    fieldDef.comment = fieldDef.comment ?? '';
     fieldDef.nullable = fieldDef.nullable ?? false;
     fieldDef.unsigned = fieldDef.unsigned ?? true;
     fieldDef.regexp = fieldDef.regexp ?? null;

package/sync/syncDb/table.ts

@@ -170,8 +170,8 @@ export async function modifyTable(sql: SQL, tableName: string, fields: Record<st
         }
     }
 
-    // PG 列注释处理
-    const commentActions = [];
+    // PG 列注释处理（对比数据库 comment 与字段 name）
+    const commentActions: string[] = [];
     if (isPG()) {
         for (const [fieldKey, fieldDef] of Object.entries(fields)) {
             // 转换字段名为下划线格式

package/sync/syncDb/tableCreate.ts

@@ -19,7 +19,7 @@ import type { SQL } from 'bun';
 import type { FieldDefinition } from 'befly-shared/types';
 
 /**
- * 为 PostgreSQL 表添加列注释
+ * 为 PostgreSQL 表添加列注释（使用字段的 name 作为注释）
  *
  * @param sql - SQL 客户端实例
  * @param tableName - 表名
@@ -44,7 +44,7 @@ async function addPostgresComments(sql: SQL, tableName: string, fields: Record<s
         }
     }
 
-    // 业务字段注释
+    // 业务字段注释（使用 fieldDef.name 作为数据库列注释）
     for (const [fieldKey, fieldDef] of Object.entries(fields)) {
         // 转换字段名为下划线格式
         const dbFieldName = snakeCase(fieldKey);
@@ -149,7 +149,7 @@ export async function createTable(sql: SQL, tableName: string, fields: Record<st
         await sql.unsafe(createSQL);
     }
 
-    // PostgreSQL: 添加列注释
+    // PostgreSQL: 添加列注释（使用字段 name 作为数据库列注释）
     if (isPG() && !IS_PLAN) {
         await addPostgresComments(sql, tableName, fields);
     } else if (isPG() && IS_PLAN) {

package/tests/syncDb-constants.test.ts

@@ -3,7 +3,7 @@
  *
  * 测试 constants.ts 中的常量：
  * - DB_VERSION_REQUIREMENTS
- * - SYSTEM_FIELDS
+ * - SYSTEM_INDEX_FIELDS
  * - SYSTEM_INDEX_FIELDS
  * - CHANGE_TYPE_LABELS
  * - MYSQL_TABLE_CONFIG
@@ -36,28 +36,6 @@ describe('DB_VERSION_REQUIREMENTS', () => {
     });
 });
 
-describe('SYSTEM_FIELDS', () => {
-    test('包含 id 字段', () => {
-        expect(constants.SYSTEM_FIELDS.ID.name).toBe('id');
-    });
-
-    test('包含 created_at 字段', () => {
-        expect(constants.SYSTEM_FIELDS.CREATED_AT.name).toBe('created_at');
-    });
-
-    test('包含 updated_at 字段', () => {
-        expect(constants.SYSTEM_FIELDS.UPDATED_AT.name).toBe('updated_at');
-    });
-
-    test('包含 deleted_at 字段', () => {
-        expect(constants.SYSTEM_FIELDS.DELETED_AT.name).toBe('deleted_at');
-    });
-
-    test('包含 state 字段', () => {
-        expect(constants.SYSTEM_FIELDS.STATE.name).toBe('state');
-    });
-});
-
 describe('SYSTEM_INDEX_FIELDS', () => {
     test('包含 created_at', () => {
         expect(constants.SYSTEM_INDEX_FIELDS).toContain('created_at');

package/tests/syncDb-helpers.test.ts

@@ -67,7 +67,6 @@ describe('applyFieldDefaults', () => {
         expect(fieldDef.default).toBe(null);
         expect(fieldDef.index).toBe(false);
         expect(fieldDef.unique).toBe(false);
-        expect(fieldDef.comment).toBe('');
         expect(fieldDef.nullable).toBe(false);
         expect(fieldDef.unsigned).toBe(true);
         expect(fieldDef.regexp).toBe(null);

package/types/database.d.ts

@@ -203,8 +203,6 @@ export interface ColumnInfo {
     nullable: boolean;
     /** 默认值 */
     default: any;
-    /** 注释 */
-    comment: string;
     /** 长度 */
     length?: number;
 }