@cicctencent/json-orm 0.1.1

package/dist/cjs/json-datasource.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonDataSource = exports.JsonEntityManager = exports.sqlTableFor = void 0;
+exports.getJsonDataSource = getJsonDataSource;
+exports.resetJsonDataSourceForTest = resetJsonDataSourceForTest;
+/**
+ * JSON 回退存储：DataSource / EntityManager 垫片（json-fallback-storage 规格）
+ *
+ * 覆盖 `src/store/*` 与 `src/service/*` 实际使用的 DataSource API：
+ *   - getRepository(Entity | '表名')
+ *   - query(sql, params?)：原始 SQL（含位置/命名参数）经内存求值器执行
+ *   - transaction(fn)：JSON 存储无跨表事务语义（文件级原子写），直接透传
+ *   - manager：save(实体)/getRepository/query/transaction（chat.store、
+ *     observability.service 的事务回调用法）
+ *   - createQueryBuilder(alias?)：DS 级 QB（insert().into(Entity) 形态）
+ *   - createQueryRunner()：hasTable/createTable 等 DDL 探测为 no-op（JSON 无 schema）
+ *   - isInitialized：恒 true
+ */
+const json_sql_ts_1 = require("./json-sql.js");
+const json_collection_ts_1 = require("./json-collection.js");
+const json_entity_meta_ts_1 = require("./json-entity-meta.js");
+const json_repository_ts_1 = require("./json-repository.js");
+const json_query_builder_ts_1 = require("./json-query-builder.js");
+/** 表名 → { meta, collection }；未知表返回 null（fail-loud） */
+const sqlTableFor = (tableName) => {
+    const meta = (0, json_entity_meta_ts_1.resolveEntityMetaByTable)(tableName);
+    if (meta)
+        return { meta, collection: (0, json_collection_ts_1.getCollection)(tableName, meta) };
+    if ((0, json_entity_meta_ts_1.isNonEntityTable)(tableName)) {
+        return { meta: null, collection: (0, json_collection_ts_1.getCollection)(tableName, null) };
+    }
+    return null;
+};
+exports.sqlTableFor = sqlTableFor;
+class JsonEntityManager {
+    ds;
+    constructor(ds) {
+        this.ds = ds;
+    }
+    getRepository(target) {
+        return this.ds.getRepository(target);
+    }
+    /** save(实体 | 实体数组) 或 save(Entity, 实体 | 实体数组) */
+    async save(targetOrEntity, maybeEntity) {
+        return this.ds.save(targetOrEntity, maybeEntity);
+    }
+    async query(sql, params) {
+        return this.ds.query(sql, params);
+    }
+    async transaction(fn) {
+        // JSON 存储无跨表事务：文件级 tmp+rename 原子写，回调直接透传
+        return fn(this);
+    }
+    createQueryBuilder(alias) {
+        return this.ds.createQueryBuilder(alias);
+    }
+}
+exports.JsonEntityManager = JsonEntityManager;
+class JsonDataSource {
+    isInitialized = true;
+    manager = new JsonEntityManager(this);
+    getRepository(target) {
+        return (0, json_repository_ts_1.createJsonRepository)(target, exports.sqlTableFor);
+    }
+    async query(sql, params) {
+        return (0, json_sql_ts_1.executeRawQuery)(sql, params, exports.sqlTableFor);
+    }
+    /** EntityManager.save 语义：按实体构造器分组落库 */
+    async save(targetOrEntity, maybeEntity) {
+        const hasTarget = maybeEntity !== undefined && maybeEntity !== null;
+        const entities = (hasTarget ? maybeEntity : targetOrEntity);
+        const target = hasTarget ? targetOrEntity : undefined;
+        const list = Array.isArray(entities) ? entities : [entities];
+        if (list.length === 0)
+            return Array.isArray(entities) ? [] : undefined;
+        const groups = new Map();
+        for (const e of list) {
+            const ctor = (target ?? e?.constructor);
+            if (!ctor || ctor === Object) {
+                throw new Error('[json-storage] manager.save 无法识别实体构造器，请使用 save(Entity, row) 形式');
+            }
+            const bucket = groups.get(ctor) ?? [];
+            bucket.push(e);
+            groups.set(ctor, bucket);
+        }
+        const out = [];
+        for (const [ctor, rows] of groups) {
+            const repo = this.getRepository(ctor);
+            const saved = await repo.save(rows);
+            out.push(...(Array.isArray(saved) ? saved : [saved]));
+        }
+        return Array.isArray(entities) ? out : out[0];
+    }
+    async transaction(fn) {
+        return this.manager.transaction(fn);
+    }
+    /** DS 级 QueryBuilder：无表（insert().into(Entity) 后置）或带别名 */
+    createQueryBuilder(alias) {
+        return new json_query_builder_ts_1.JsonQueryBuilder(undefined, alias ?? '', exports.sqlTableFor);
+    }
+    /**
+     * DDL 探测 no-op（JSON 存储无 schema；hasTable 恒 true 跳过建表）。
+     * 注意：transaction 系列方法均为 no-op，不提供跨表/跨语句原子性与回滚——
+     * 仅用于 schema 探测路径，勿在依赖事务语义的代码中使用（JSON 模式仅保证单行文件级原子写）。
+     */
+    createQueryRunner() {
+        return {
+            connect: async () => undefined,
+            release: async () => undefined,
+            startTransaction: async () => undefined,
+            commitTransaction: async () => undefined,
+            rollbackTransaction: async () => undefined,
+            hasTable: async () => true,
+            createTable: async () => undefined,
+            query: async (sql, params) => this.query(sql, params),
+        };
+    }
+}
+exports.JsonDataSource = JsonDataSource;
+let facade = null;
+/** 进程级单例（'default' 数据源） */
+function getJsonDataSource() {
+    if (!facade)
+        facade = new JsonDataSource();
+    return facade;
+}
+/** 测试隔离：重置单例（配合集合 clear() 清空数据） */
+function resetJsonDataSourceForTest() {
+    facade = null;
+}
+//# sourceMappingURL=json-datasource.js.map

package/dist/cjs/json-datasource.js.map

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

package/dist/cjs/json-entity-meta.d.ts

@@ -0,0 +1,42 @@
+export interface JsonEntityColumn {
+    propertyName: string;
+    columnName: string;
+    mode: string;
+    type: string;
+}
+export interface JsonEntityMeta {
+    target: Function;
+    tableName: string;
+    columns: JsonEntityColumn[];
+    /** 数据库列名 → 属性名 */
+    columnByDbName: Map<string, string>;
+    /** 属性名 → 数据库列名 */
+    columnByProperty: Map<string, string>;
+    primaryProperty?: string;
+    /** 主键是否自增（`@PrimaryGeneratedColumn`） */
+    primaryGenerated: boolean;
+    /** `@CreateDateColumn` 属性（如 createTime） */
+    createdAtProperty?: string;
+    /** `@UpdateDateColumn` 属性（如 modifyTime） */
+    updatedAtProperty?: string;
+    /** datetime/timestamp/date 类型列（读取时还原为 Date） */
+    datetimeProperties: Set<string>;
+    /** 唯一索引（属性名组），供 ON DUPLICATE KEY UPDATE 冲突检测 */
+    uniqueIndexes: string[][];
+}
+/**
+ * 解析实体元数据。入参可为实体类或表名（如 `getRepository('t_ai_obs_trace')`）。
+ * 未知表返回 null（调用方按"非实体表"处理）。
+ */
+export declare function resolveEntityMeta(targetOrTable: Function | string): JsonEntityMeta | null;
+/** 按表名解析元数据；未知表返回 null */
+export declare function resolveEntityMetaByTable(tableName: string): JsonEntityMeta | null;
+/** 非实体表的主键列（无注册时返回 undefined） */
+export declare function getNonEntityPrimaryColumn(tableName: string): string | undefined;
+/** 非实体表的唯一列组（原始列名） */
+export declare function getNonEntityUniqueColumns(tableName: string): string[][];
+/** 是否为已知非实体表（仅经原始 SQL 访问） */
+export declare function isNonEntityTable(tableName: string): boolean;
+/** 全部非实体表名（information_schema 合成用） */
+export declare function listNonEntityTables(): string[];
+//# sourceMappingURL=json-entity-meta.d.ts.map

package/dist/cjs/json-entity-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-entity-meta.d.ts","sourceRoot":"","sources":["../../src/json-entity-meta.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kBAAkB;IAClB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,kBAAkB;IAClB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,gDAAgD;IAChD,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC;CAC3B;AAeD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,QAAQ,GAAG,MAAM,GAAG,cAAc,GAAG,IAAI,CA8EzF;AAED,0BAA0B;AAC1B,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEjF;AAED,iCAAiC;AACjC,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED,sBAAsB;AACtB,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAEvE;AAED,6BAA6B;AAC7B,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/cjs/json-entity-meta.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveEntityMeta = resolveEntityMeta;
+exports.resolveEntityMetaByTable = resolveEntityMetaByTable;
+exports.getNonEntityPrimaryColumn = getNonEntityPrimaryColumn;
+exports.getNonEntityUniqueColumns = getNonEntityUniqueColumns;
+exports.isNonEntityTable = isNonEntityTable;
+exports.listNonEntityTables = listNonEntityTables;
+/**
+ * JSON 回退存储：实体元数据解析（json-fallback-storage 规格）
+ *
+ * 复用 TypeORM 装饰器注册的元数据（`getMetadataArgsStorage()`，随实体类 import
+ * 由 reflect-metadata 自动填充），推导：
+ *   - 表名（`@Entity('t_xxx')`）
+ *   - 列名 → 属性名映射（`@Column({ name: 'Fxxx' })`，含基类 BaseEntity 继承列）
+ *   - 主键属性（`@PrimaryColumn` / `@PrimaryGeneratedColumn`）
+ *   - 自动时间列（`@CreateDateColumn` → createTime / `@UpdateDateColumn` → modifyTime）
+ *
+ * JSON 行以**属性名**为键落盘；原始 SQL / QueryBuilder 字符串里的数据库列名
+ * （`Fxxx`、`lock_name` 等）经本模块映射回属性键。
+ */
+const typeorm_1 = require("typeorm");
+const json_config_ts_1 = require("./json-config.js");
+const metaCache = new Map();
+/** 实体原型链上的全部构造函数（含自身，用于收集基类 BaseEntity 的列） */
+function ancestorChain(target) {
+    const chain = new Set();
+    let cur = target;
+    while (cur && cur !== Object && cur !== Function) {
+        chain.add(cur);
+        cur = Object.getPrototypeOf(cur);
+    }
+    return chain;
+}
+/**
+ * 解析实体元数据。入参可为实体类或表名（如 `getRepository('t_ai_obs_trace')`）。
+ * 未知表返回 null（调用方按"非实体表"处理）。
+ */
+function resolveEntityMeta(targetOrTable) {
+    const cacheKey = typeof targetOrTable === 'string' ? targetOrTable : targetOrTable.name;
+    if (metaCache.has(cacheKey))
+        return metaCache.get(cacheKey);
+    const storage = (0, typeorm_1.getMetadataArgsStorage)();
+    let tableArg;
+    if (typeof targetOrTable === 'string') {
+        tableArg = storage.tables.find(t => t.name === targetOrTable);
+    }
+    else {
+        tableArg = storage.tables.find(t => t.target === targetOrTable);
+    }
+    if (!tableArg) {
+        metaCache.set(cacheKey, null);
+        return null;
+    }
+    const chain = ancestorChain(tableArg.target);
+    const columnArgs = storage.columns.filter(c => chain.has(c.target));
+    const columns = columnArgs.map(c => ({
+        propertyName: c.propertyName,
+        columnName: c.options?.name || c.propertyName,
+        mode: c.mode || 'regular',
+        type: typeof c.options?.type === 'string' ? c.options.type : typeof c.options?.type === 'function' ? '' : String(c.options?.type ?? ''),
+    }));
+    const meta = {
+        target: tableArg.target,
+        tableName: tableArg.name ?? '',
+        columns,
+        columnByDbName: new Map(columns.map(c => [c.columnName, c.propertyName])),
+        columnByProperty: new Map(columns.map(c => [c.propertyName, c.columnName])),
+        primaryGenerated: false,
+        datetimeProperties: new Set(columns
+            .filter(c => ['datetime', 'timestamp', 'date'].includes(c.type) ||
+            // @CreateDateColumn/@UpdateDateColumn 装饰器不补默认 type，
+            // 但 TypeORM 语义上即 datetime 列
+            c.mode === 'createDate' ||
+            c.mode === 'updateDate')
+            .map(c => c.propertyName)),
+        uniqueIndexes: [],
+    };
+    // TypeORM 装饰器注册形态：@PrimaryColumn/@PrimaryGeneratedColumn 均为
+    // mode 'regular' + options.primary = true；自增策略在 generations 数组
+    const primaryIdx = columnArgs.findIndex(c => c.options?.primary === true);
+    if (primaryIdx >= 0) {
+        const primary = columns[primaryIdx];
+        meta.primaryProperty = primary.propertyName;
+        // @PrimaryGeneratedColumn 会向 generations 注册策略（increment/uuid/...）；@PrimaryColumn 不会
+        meta.primaryGenerated = storage.generations.some(g => chain.has(g.target) && g.propertyName === primary.propertyName);
+    }
+    const created = columns.find(c => c.mode === 'createDate');
+    if (created)
+        meta.createdAtProperty = created.propertyName;
+    const updated = columns.find(c => c.mode === 'updateDate');
+    if (updated)
+        meta.updatedAtProperty = updated.propertyName;
+    // 唯一索引（@Index(..., { unique: true })，含基类；columns 为属性名）
+    for (const idx of storage.indices) {
+        if (!idx.unique)
+            continue;
+        if (!chain.has(idx.target))
+            continue;
+        const props = idx.columns.map(col => typeof col === 'function' ? '' : String(col));
+        if (props.length > 0 && props.every(p => meta.columnByProperty.has(p))) {
+            meta.uniqueIndexes.push(props);
+        }
+    }
+    metaCache.set(cacheKey, meta);
+    return meta;
+}
+/** 按表名解析元数据；未知表返回 null */
+function resolveEntityMetaByTable(tableName) {
+    return resolveEntityMeta(tableName);
+}
+/** 非实体表的主键列（无注册时返回 undefined） */
+function getNonEntityPrimaryColumn(tableName) {
+    return (0, json_config_ts_1.getNonEntityTables)()[tableName]?.primaryColumn;
+}
+/** 非实体表的唯一列组（原始列名） */
+function getNonEntityUniqueColumns(tableName) {
+    return (0, json_config_ts_1.getNonEntityTables)()[tableName]?.uniqueColumns ?? [];
+}
+/** 是否为已知非实体表（仅经原始 SQL 访问） */
+function isNonEntityTable(tableName) {
+    return !!(0, json_config_ts_1.getNonEntityTables)()[tableName];
+}
+/** 全部非实体表名（information_schema 合成用） */
+function listNonEntityTables() {
+    return Object.keys((0, json_config_ts_1.getNonEntityTables)());
+}
+//# sourceMappingURL=json-entity-meta.js.map

package/dist/cjs/json-entity-meta.js.map

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

package/dist/cjs/json-query-builder.d.ts

@@ -0,0 +1,83 @@
+import type { GetSqlTable } from './json-sql-shared.js';
+import type { JsonRow } from './json-collection.js';
+export declare class JsonQueryBuilder {
+    private getSqlTable;
+    private mode;
+    private table?;
+    private meta;
+    private alias;
+    private selects;
+    private distinctFlag;
+    private conds;
+    private orders;
+    private groups;
+    private joinsDef;
+    private skipCount?;
+    private takeCount?;
+    private limitCount?;
+    private offsetCount?;
+    private named;
+    private updateSet?;
+    private insertRows;
+    private findOptionsWhere?;
+    private findOptionsOrder?;
+    private findOptionsSelect?;
+    private paramSeed;
+    constructor(table: string | undefined, alias: string, getSqlTable: GetSqlTable);
+    private setTable;
+    private entityTable;
+    select(selection: string | string[], selectionAlias?: string): this;
+    addSelect(selection: string | string[], selectionAlias?: string): this;
+    private composeSelect;
+    distinct(flag?: boolean): this;
+    from(entity: Function, alias: string): this;
+    leftJoin(entity: Function, alias: string, on: string): this;
+    innerJoin(entity: Function, alias: string, on: string): this;
+    where(where: string | Record<string, unknown>, params?: Record<string, unknown>): this;
+    andWhere(where: string | Record<string, unknown>, params?: Record<string, unknown>): this;
+    orWhere(where: string | Record<string, unknown>, params?: Record<string, unknown>): this;
+    private pushCond;
+    setFindOptions(options: {
+        where?: Record<string, unknown> | Array<Record<string, unknown>>;
+        order?: Record<string, 'ASC' | 'DESC'>;
+        skip?: number;
+        take?: number;
+        select?: string[];
+    }): this;
+    orderBy(sort: string, order?: 'ASC' | 'DESC'): this;
+    addOrderBy(sort: string, order?: 'ASC' | 'DESC'): this;
+    groupBy(groupBy: string): this;
+    addGroupBy(groupBy: string): this;
+    skip(skip: number): this;
+    take(take: number): this;
+    limit(limit: number): this;
+    offset(offset: number): this;
+    setParameter(key: string, value: unknown): this;
+    setParameters(parameters: Record<string, unknown>): this;
+    update(entity?: Function): this;
+    delete(): this;
+    insert(): this;
+    set(values: Record<string, unknown>): this;
+    into(entity: Function): this;
+    values(values: JsonRow | JsonRow[]): this;
+    private buildWhereClause;
+    private condToSql;
+    /** FindOptionsWhere 对象 → SQL（属性名 → `alias.列`，FindOperator 展开） */
+    private objectWhereToSql;
+    private predicateToSql;
+    private findOperatorToSql;
+    private nextParam;
+    /** 属性名或 DB 列名 → `alias.引用`（列名原样保留，由求值器经元数据映射） */
+    private columnRef;
+    private buildSelectSql;
+    getRawMany(): Promise<any[]>;
+    getRawOne(): Promise<any>;
+    getMany(): Promise<any[]>;
+    getOne(): Promise<any | null>;
+    getCount(): Promise<number>;
+    getManyAndCount(): Promise<[any[], number]>;
+    execute(): Promise<any>;
+    /** DB 列名键 → 实体属性名键（getMany 结果形态） */
+    private mapColumnsToProperties;
+}
+//# sourceMappingURL=json-query-builder.d.ts.map

package/dist/cjs/json-query-builder.d.ts.map

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