@cicctencent/json-orm 0.1.1

package/dist/esm/json-sql.js

@@ -0,0 +1,319 @@
+/**
+ * JSON 回退存储：SQL 执行入口（json-fallback-storage 规格）
+ *
+ * 在 json-sql-expr（表达式引擎）与 json-sql-select（SELECT 执行器）之上：
+ *   - INSERT ... VALUES ... [ON DUPLICATE KEY UPDATE]（含 VALUES(col)/IF/NOW()）
+ *   - UPDATE ... SET ... WHERE（返回 affectedRows/changedRows）
+ *   - DELETE FROM ... WHERE（返回 affectedRows）
+ *   - ALTER/CREATE/DROP/SHOW/SET/LOCK/UNLOCK：no-op；TRUNCATE：清空表
+ */
+import { tokenizeSql, TokenCursor, looseEqual } from "./json-where.js";
+import { parseExpr, evalExpr, truthy } from "./json-sql-expr.js";
+import { executeSelect, parseQualifiedTableName, parseTableAlias } from "./json-sql-select.js";
+import { toParams } from "./json-sql-shared.js";
+import { getNonEntityUniqueColumns } from "./json-entity-meta.js";
+/**
+ * 执行原生 SQL（MySQL 方言子集）。
+ * SELECT 返回行数组；INSERT/UPDATE/DELETE 返回 OkPacket 形态；DDL 返回 []。
+ */
+export async function executeRawQuery(sql, params, getSqlTable) {
+    const cursor = new TokenCursor(tokenizeSql(sql));
+    const head = cursor.peek();
+    if (head.type !== 'ident') {
+        throw new Error(`[json-storage] 无法识别的 SQL：${sql.slice(0, 60)}`);
+    }
+    switch (head.value.toUpperCase()) {
+        case 'SELECT':
+            return await executeSelect(cursor, toParams(params), getSqlTable);
+        case 'INSERT':
+            return await executeInsert(cursor, false, toParams(params), getSqlTable);
+        case 'REPLACE':
+            return await executeInsert(cursor, true, toParams(params), getSqlTable);
+        case 'UPDATE':
+            return await executeUpdate(cursor, toParams(params), getSqlTable);
+        case 'DELETE':
+            return await executeDelete(cursor, toParams(params), getSqlTable);
+        case 'ALTER':
+        case 'CREATE':
+        case 'DROP':
+        case 'SHOW':
+        case 'SET':
+        case 'LOCK':
+        case 'UNLOCK':
+        case 'RENAME':
+        case 'ANALYZE':
+        case 'OPTIMIZE':
+        case 'CALL':
+            return [];
+        case 'TRUNCATE': {
+            // 语法：TRUNCATE [TABLE] <表>（MySQL 兼容，TABLE 关键字可选；
+            // 此前 peek(1) 恒为 'TABLE' 导致标准写法静默 no-op）
+            const t = cursor.isKeyword('TABLE', 1) ? cursor.peek(2) : cursor.peek(1);
+            if (t.type === 'ident') {
+                // 必须 await：返回时清空已完成（否则后续读写与后台删除交错，且可能 unhandled rejection）
+                await getSqlTable(t.value)?.collection.clear();
+            }
+            return [];
+        }
+        default:
+            throw new Error(`[json-storage] 不支持的 SQL 语句类型：${head.value.toUpperCase()}`);
+    }
+}
+// ---------------- INSERT ----------------
+async function executeInsert(cursor, replace, params, getSqlTable) {
+    cursor.expectKeyword(replace ? 'REPLACE' : 'INSERT');
+    if (cursor.isKeyword('IGNORE'))
+        cursor.next();
+    cursor.expectKeyword('INTO');
+    const tableName = parseQualifiedTableName(cursor);
+    const table = getSqlTable(tableName);
+    if (!table) {
+        throw new Error(`[json-storage] INSERT 引用了未知表：${tableName}`);
+    }
+    const meta = table.meta;
+    const aliases = [{ alias: tableName, meta }];
+    // 列清单
+    const columns = [];
+    if (cursor.peek().type === 'lparen') {
+        cursor.next();
+        do {
+            columns.push(cursor.expect('ident').value);
+        } while (cursor.peek().type === 'comma' && (cursor.next(), true));
+        cursor.expect('rparen');
+    }
+    cursor.expectKeyword('VALUES');
+    const tuples = [];
+    do {
+        cursor.expect('lparen');
+        const values = [];
+        if (cursor.peek().type !== 'rparen') {
+            do {
+                values.push(parseExpr(cursor));
+            } while (cursor.peek().type === 'comma' && (cursor.next(), true));
+        }
+        cursor.expect('rparen');
+        tuples.push(values);
+    } while (cursor.peek().type === 'comma' && (cursor.next(), true));
+    // ON DUPLICATE KEY UPDATE
+    const upserts = [];
+    if (cursor.isKeyword('ON')) {
+        cursor.next();
+        cursor.expectKeyword('DUPLICATE');
+        cursor.expectKeyword('KEY');
+        cursor.expectKeyword('UPDATE');
+        do {
+            const col = cursor.expect('ident').value;
+            cursor.expect('op', '=');
+            upserts.push({ column: col, expr: parseExpr(cursor) });
+        } while (cursor.peek().type === 'comma' && (cursor.next(), true));
+    }
+    if (!cursor.atEnd()) {
+        throw new Error(`[json-storage] INSERT 解析失败：未消费的 token "${cursor.peek().value}"`);
+    }
+    // 两遍执行：
+    //   第一遍按 SQL 文本顺序求值全部 VALUES 元组（位置参数跨元组推进，与 MySQL 绑定顺序一致）；
+    //   ODKU 的位置参数从 VALUES 消费完的位置起步，且每个冲突行独立从该起点消费
+    //   （MySQL 语义：同一占位符参数对每一行求值，而非跨行推进）。
+    let affected = 0;
+    let lastId = 0;
+    const pos = { i: 0 };
+    const evaluatedTuples = tuples.map(tuple => {
+        const ctx = {
+            named: params.named,
+            positional: params.positional,
+            pos,
+            aliases,
+            row: {},
+        };
+        return tuple.map(e => evalExpr(e, ctx));
+    });
+    const odkuStart = pos.i;
+    // 唯一索引冲突检测快照：惰性获取一次、随写维护（含本批新行，保证批内自冲突检测正确）
+    let uniqueSnapshot = null;
+    for (let ti = 0; ti < evaluatedTuples.length; ti += 1) {
+        const vals = evaluatedTuples[ti];
+        const newRow = {};
+        columns.forEach((col, i) => {
+            const prop = meta?.columnByDbName.get(col) ?? col;
+            newRow[prop] = vals[i];
+        });
+        const pk = table.collection.primaryProperty;
+        if (!pk) {
+            throw new Error(`[json-storage] 表 ${tableName} 缺少主键定义，无法执行 INSERT`);
+        }
+        const keyValue = newRow[pk];
+        let existing = keyValue !== undefined && keyValue !== null ? await table.collection.get(keyValue) : undefined;
+        if (!existing) {
+            // 主键未提供：按唯一索引检测冲突行（如 t_ai_chat_tool_result 的
+            // uk_msg_toolcall(messageId, toolCallId)，ON DUPLICATE KEY UPDATE 依赖它幂等）
+            uniqueSnapshot ??= await table.collection.all();
+            existing = findByUniqueIndex(uniqueSnapshot, meta, tableName, newRow);
+        }
+        if (existing && !replace && upserts.length > 0) {
+            // ON DUPLICATE KEY UPDATE：列引用当前行，VALUES(col) 引用新行
+            const valuesRow = {};
+            columns.forEach((col, i) => {
+                valuesRow[col] = vals[i];
+            });
+            const updCtx = {
+                named: params.named,
+                positional: params.positional,
+                pos: { i: odkuStart },
+                aliases,
+                row: { [tableName]: existing },
+                valuesRow,
+            };
+            const merged = { ...existing };
+            for (const u of upserts) {
+                const prop = meta?.columnByDbName.get(u.column) ?? u.column;
+                merged[prop] = evalExpr(u.expr, updCtx);
+            }
+            await table.collection.write(merged);
+            affected += 2;
+            lastId = merged[pk];
+        }
+        else {
+            if (existing && replace) {
+                await table.collection.delete(existing[pk]);
+            }
+            if (newRow[pk] === undefined || newRow[pk] === null) {
+                // 自增主键未提供：由序列器分配
+                newRow[pk] = await table.collection.nextId();
+            }
+            await table.collection.write(newRow);
+            // 随写维护快照（REPLACE 先删后插残留的旧快照行仅致无害的冗余命中，最终态正确）
+            uniqueSnapshot?.push({ ...newRow });
+            // 已知语义（见设计 Risks）：REPLACE = 删后插，本求值器 affectedRows 记 1（MySQL 记 2）。
+            // 仅消费 insertId 时无影响；依赖 affectedRows 计数做分支的调用方需注意。
+            affected += 1;
+            lastId = newRow[pk];
+        }
+    }
+    return { affectedRows: affected, insertId: Number(lastId) || 0, fieldCount: 0, info: '' };
+}
+/**
+ * 按唯一索引查找已存在的行（ON DUPLICATE KEY UPDATE 冲突检测）。
+ * 实体表用元数据唯一索引（属性名），非实体表用注册的唯一列组（原始列名）。
+ * 在调用方提供的快照上查找：快照由元组循环共享并随写维护，避免逐元组整表深拷贝。
+ */
+function findByUniqueIndex(rows, meta, tableName, newRow) {
+    const keyGroups = meta ? meta.uniqueIndexes : getNonEntityUniqueColumns(tableName);
+    for (const group of keyGroups) {
+        const hit = group.every(k => newRow[k] !== undefined && newRow[k] !== null);
+        if (!hit)
+            continue;
+        const found = rows.find(row => group.every(k => looseEqual(row[k], newRow[k])));
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+// ---------------- UPDATE ----------------
+async function executeUpdate(cursor, params, getSqlTable) {
+    cursor.expectKeyword('UPDATE');
+    const tableName = parseQualifiedTableName(cursor);
+    const table = getSqlTable(tableName);
+    if (!table) {
+        throw new Error(`[json-storage] UPDATE 引用了未知表：${tableName}`);
+    }
+    const alias = parseTableAlias(cursor, tableName);
+    const meta = table.meta;
+    const aliases = [{ alias, meta }];
+    cursor.expectKeyword('SET');
+    const assigns = [];
+    do {
+        const col = cursor.expect('ident').value;
+        cursor.expect('op', '=');
+        assigns.push({ column: col, expr: parseExpr(cursor) });
+    } while (cursor.peek().type === 'comma' && (cursor.next(), true));
+    let where;
+    if (cursor.isKeyword('WHERE')) {
+        cursor.next();
+        where = parseExpr(cursor);
+    }
+    if (!cursor.atEnd()) {
+        throw new Error(`[json-storage] UPDATE 解析失败：未消费的 token "${cursor.peek().value}"`);
+    }
+    let affected = 0;
+    let changed = 0;
+    const rows = await table.collection.all();
+    for (const row of rows) {
+        const ctx = {
+            named: params.named,
+            positional: params.positional,
+            pos: { i: 0 },
+            aliases,
+            row: { [alias]: row },
+        };
+        if (where && !truthy(evalExpr(where, ctx)))
+            continue;
+        affected += 1;
+        const updated = { ...row };
+        let rowChanged = false;
+        for (const a of assigns) {
+            const prop = meta?.columnByDbName.get(a.column) ?? a.column;
+            const value = evalExpr(a.expr, ctx);
+            if (!looseEq(updated[prop], value))
+                rowChanged = true;
+            updated[prop] = value;
+        }
+        if (rowChanged) {
+            changed += 1;
+            await table.collection.write(updated);
+        }
+    }
+    return { affectedRows: affected, changedRows: changed, fieldCount: 0, info: '' };
+}
+function looseEq(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || a === undefined || b === null || b === undefined)
+        return false;
+    if (a instanceof Date || b instanceof Date)
+        return looseEqual(a, b);
+    return looseEqual(a, b);
+}
+// ---------------- DELETE ----------------
+async function executeDelete(cursor, params, getSqlTable) {
+    cursor.expectKeyword('DELETE');
+    cursor.expectKeyword('FROM');
+    const tableName = parseQualifiedTableName(cursor);
+    const table = getSqlTable(tableName);
+    if (!table) {
+        throw new Error(`[json-storage] DELETE 引用了未知表：${tableName}`);
+    }
+    const alias = parseTableAlias(cursor, tableName);
+    const meta = table.meta;
+    const aliases = [{ alias, meta }];
+    let where;
+    if (cursor.isKeyword('WHERE')) {
+        cursor.next();
+        where = parseExpr(cursor);
+    }
+    if (!cursor.atEnd()) {
+        throw new Error(`[json-storage] DELETE 解析失败：未消费的 token "${cursor.peek().value}"`);
+    }
+    const pk = table.collection.primaryProperty;
+    if (!pk) {
+        throw new Error(`[json-storage] 表 ${tableName} 缺少主键定义，无法执行 DELETE`);
+    }
+    let affected = 0;
+    const rows = await table.collection.all();
+    for (const row of rows) {
+        if (where) {
+            const ctx = {
+                named: params.named,
+                positional: params.positional,
+                pos: { i: 0 },
+                aliases,
+                row: { [alias]: row },
+            };
+            if (!truthy(evalExpr(where, ctx)))
+                continue;
+        }
+        if (await table.collection.delete(row[pk]))
+            affected += 1;
+    }
+    return { affectedRows: affected, fieldCount: 0, info: '' };
+}
+//# sourceMappingURL=json-sql.js.map

package/dist/esm/json-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-sql.js","sourceRoot":"","sources":["../../src/json-sql.ts"],"names":[],"mappings":"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"}

package/dist/esm/json-where.d.ts

@@ -0,0 +1,54 @@
+/**
+ * JSON 回退存储：WHERE 条件解析与求值（json-fallback-storage 规格）
+ *
+ * 三部分：
+ *   1) SQL 分词器（`tokenizeSql`，供本模块与 json-sql.ts / json-sql-expr.ts 共用）
+ *   2) 值比较与 LIKE 匹配原语（`compareValues`/`looseEqual`/`likeMatch`，供本模块与
+ *      json-sql 求值器共用；字符串条件统一拼成 SQL 后由 json-sql 解析求值）
+ *   3) FindOptionsWhere 对象匹配（等值 + typeorm FindOperator：In/Like/Not/
+ *      IsNull/LessThan/MoreThan/Between 等）
+ *
+ * 列名解析：`alias.Fxxx` / `Fxxx`（数据库列名）或 `alias.prop` / `prop`（属性名）
+ * 均经 JsonEntityMeta 映射到 JSON 行的属性键；超出语法覆盖时显式抛错（fail-loud）。
+ */
+import { FindOperator } from 'typeorm';
+import type { JsonEntityMeta } from './json-entity-meta.js';
+/**
+ * 跨 typeorm 多副本安全的 FindOperator 判定。
+ * 本包与消费方（如 app/work-space）常因 pnpm 解析到不同 typeorm 副本，
+ * 导致 `instanceof FindOperator` 跨模块实例失效；改用运行时类名鸭子类型检测，
+ * 避免把 FindOperator 误判为普通值。
+ */
+export declare function isFindOperator(value: unknown): value is FindOperator<unknown>;
+export type TokenType = 'ident' | 'string' | 'number' | 'param' | 'qmark' | 'op' | 'lparen' | 'rparen' | 'comma' | 'dot' | 'eof';
+export interface Token {
+    type: TokenType;
+    value: string;
+    pos: number;
+}
+export declare function tokenizeSql(sql: string): Token[];
+/** 分词游标（供条件/表达式解析共用） */
+export declare class TokenCursor {
+    readonly tokens: Token[];
+    private idx;
+    constructor(tokens: Token[]);
+    peek(offset?: number): Token;
+    next(): Token;
+    /** 当前 ident 是否关键字（大小写不敏感） */
+    isKeyword(word: string, offset?: number): boolean;
+    expectKeyword(word: string): void;
+    expect(type: TokenType, value?: string): Token;
+    atEnd(): boolean;
+}
+/** 稳健比较：数字按数值、日期按时间戳、字符串按字典序；类型不可比时按字符串 */
+export declare function compareValues(a: unknown, b: unknown): number;
+/** SQL LIKE：`%` 任意串、`_` 单字符 */
+export declare function likeMatch(input: string, pattern: string): boolean;
+/** 宽松等值（Date/ISO 字符串、数字/字符串数字） */
+export declare function looseEqual(a: unknown, b: unknown): boolean;
+/**
+ * 匹配 FindOptionsWhere（对象或对象数组=OR）。
+ * 键为属性名（若为数据库列名则经 meta 映射），值支持原始值与 FindOperator。
+ */
+export declare function matchesWhere(row: Record<string, unknown>, where: unknown, meta: JsonEntityMeta | null): boolean;
+//# sourceMappingURL=json-where.d.ts.map

package/dist/esm/json-where.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-where.d.ts","sourceRoot":"","sources":["../../src/json-where.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC,CAQ7E;AAID,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,OAAO,GACP,IAAI,GACJ,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,KAAK,GACL,KAAK,CAAC;AAEV,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CAwHhD;AAED,wBAAwB;AACxB,qBAAa,WAAW;IAEV,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE;IADpC,OAAO,CAAC,GAAG,CAAK;gBACK,MAAM,EAAE,KAAK,EAAE;IAEpC,IAAI,CAAC,MAAM,SAAI,GAAG,KAAK;IAIvB,IAAI,IAAI,KAAK;IAMb,6BAA6B;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,OAAO;IAK5C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOjC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK;IAU9C,KAAK,IAAI,OAAO;CAGjB;AAID,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAe5D;AAoBD,+BAA+B;AAC/B,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAOjE;AAED,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAe1D;AAoBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,cAAc,GAAG,IAAI,GAC1B,OAAO,CAyBT"}