@mldong/jeeflow 1.6.3 → 1.6.5

package/dist/persist.d.ts

@@ -35,10 +35,19 @@ export declare class SqliteDynamicTableWriter implements DynamicTableWriter {
     /** 用户列默认值（issues/19）：优先取 data 中已注入的 apply_user_id=流程 operator，
      *  否则用此配置值，缺省 "system"——多数框架业务表 create_user/update_user 为 BIGINT 存 userId */
     defaultUserValue: unknown;
+    /** 列匹配（issues/20）：默认宽松——驼峰↔下划线归一匹配（表单字段 companyName ↔ 表列 company_name）；
+     *  需要精确控制列名的集成方显式开启严格模式（忽略大小写精确匹配） */
+    strictColumnMatch: boolean;
+    /** 主键生成器（issues/21）：非自增主键表（雪花/应用生成）插入时生成主键值，入参表名 */
+    primaryKeyGenerator?: (tableName: string) => unknown;
     constructor(db: DatabaseSync);
     private tableColumns;
     filterColumns(tableName: string, columns: string[]): string[];
     insert(tableName: string, data: Record<string, unknown>): unknown;
+    /** 列匹配（issues/20）：严格=忽略大小写精确；宽松（默认）=驼峰↔下划线归一匹配 */
+    private findColumn;
+    /** 在 data 中找匹配指定表列的 key（宽松模式驼峰 key 匹配下划线列） */
+    private findDataKey;
     exists(tableName: string, bizKey: string, bizKeyValue: unknown): boolean;
     fillSystemFields(data: Record<string, unknown>, isInsert: boolean): void;
     /** 默认用户值（issues/19）：优先取 data 中已注入的 apply_user_id

package/dist/persist.js

@@ -2,6 +2,10 @@ import { KeySubmitType, KeyDeptID } from './engine.js';
 import { TypeEnd, InstanceState, SubmitType } from './model.js';
 // ─── 默认实现：node:sqlite（内置零依赖） ──────────────────────────────────────
 const TABLE_NAME_RE = /^[A-Za-z0-9_]+$/;
+/** 列名归一（issues/20）：转小写 + 去下划线（companyName / company_name / COMPANY_NAME 等价） */
+function normalizeColumn(name) {
+    return name.toLowerCase().replace(/_/g, '');
+}
 function nowText() {
     const d = new Date();
     const p = (n) => String(n).padStart(2, '0');
@@ -34,6 +38,11 @@ export class SqliteDynamicTableWriter {
     /** 用户列默认值（issues/19）：优先取 data 中已注入的 apply_user_id=流程 operator，
      *  否则用此配置值，缺省 "system"——多数框架业务表 create_user/update_user 为 BIGINT 存 userId */
     defaultUserValue = 'system';
+    /** 列匹配（issues/20）：默认宽松——驼峰↔下划线归一匹配（表单字段 companyName ↔ 表列 company_name）；
+     *  需要精确控制列名的集成方显式开启严格模式（忽略大小写精确匹配） */
+    strictColumnMatch = false;
+    /** 主键生成器（issues/21）：非自增主键表（雪花/应用生成）插入时生成主键值，入参表名 */
+    primaryKeyGenerator;
     constructor(db) {
         this.db = db;
     }
@@ -41,36 +50,43 @@ export class SqliteDynamicTableWriter {
         const cached = this.cache.get(tableName);
         if (cached)
             return cached;
-        // PRAGMA 不支持占位符——表名已过安全校验
+        // PRAGMA 不支持占位符——表名已过安全校验；INTEGER PRIMARY KEY 为 rowid 别名（自增）
         const rows = this.db.prepare(`PRAGMA table_info(${tableName})`).all();
         if (rows.length === 0)
             throw new Error(`persist: table ${tableName} not found`);
-        const cols = rows.map(r => r.name.toUpperCase());
+        const cols = rows.map(r => ({
+            name: r.name.toUpperCase(),
+            primaryKey: r.pk === 1,
+            autoIncrement: r.pk === 1 && r.type.trim().toUpperCase() === 'INTEGER',
+        }));
         this.cache.set(tableName, cols);
         return cols;
     }
     filterColumns(tableName, columns) {
         checkTableName(tableName);
-        const set = new Set(this.tableColumns(tableName));
-        return columns.filter(c => set.has(c.toUpperCase()));
+        const cols = this.tableColumns(tableName);
+        return columns.filter(c => this.findColumn(cols, c) !== '');
     }
     insert(tableName, data) {
         checkTableName(tableName);
         const cols = this.tableColumns(tableName);
         const names = [];
         const values = [];
-        // 保持插入顺序稳定（对象键无序，按表列顺序取）
-        for (const col of cols) {
-            if (Object.prototype.hasOwnProperty.call(data, col)) {
-                names.push(col);
-                values.push(data[col]);
+        // 保持插入顺序稳定（对象键无序，按表列顺序取）；写入用表列原名（issues/20）
+        for (const m of cols) {
+            const key = this.findDataKey(data, m.name);
+            if (key !== '') {
+                names.push(m.name);
+                values.push(data[key]);
+                continue;
             }
-            else {
-                const key = Object.keys(data).find(k => k.toUpperCase() === col);
-                if (key !== undefined) {
-                    names.push(col);
-                    values.push(data[key]);
+            // 主键生成（issues/21）：非自增主键表且 data 无主键值 → 调生成器；未配置 → 清晰报错
+            if (m.primaryKey && !m.autoIncrement) {
+                if (!this.primaryKeyGenerator) {
+                    throw new Error(`persist: table ${tableName} primary key ${m.name} is not auto-increment and no primary key generator configured (set primaryKeyGenerator, e.g. snowflake)`);
                 }
+                names.push(m.name);
+                values.push(this.primaryKeyGenerator(tableName));
             }
         }
         if (names.length === 0)
@@ -80,6 +96,32 @@ export class SqliteDynamicTableWriter {
         const res = stmt.run(...values);
         return res.lastInsertRowid;
     }
+    /** 列匹配（issues/20）：严格=忽略大小写精确；宽松（默认）=驼峰↔下划线归一匹配 */
+    findColumn(cols, key) {
+        for (const m of cols) {
+            if (this.strictColumnMatch) {
+                if (m.name.toUpperCase() === key.toUpperCase())
+                    return m.name;
+            }
+            else if (normalizeColumn(m.name) === normalizeColumn(key)) {
+                return m.name;
+            }
+        }
+        return '';
+    }
+    /** 在 data 中找匹配指定表列的 key（宽松模式驼峰 key 匹配下划线列） */
+    findDataKey(data, col) {
+        for (const k of Object.keys(data)) {
+            if (this.strictColumnMatch) {
+                if (col.toUpperCase() === k.toUpperCase())
+                    return k;
+            }
+            else if (normalizeColumn(col) === normalizeColumn(k)) {
+                return k;
+            }
+        }
+        return '';
+    }
     exists(tableName, bizKey, bizKeyValue) {
         checkTableName(tableName);
         this.tableColumns(tableName); // 表不存在提前报错

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mldong/jeeflow",
-  "version": "1.6.3",
+  "version": "1.6.5",
   "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
   "type": "module",
   "main": "./dist/index.js",