vome-core 0.3.47 → 0.3.49

package/dist/orm/import-excel.d.ts

@@ -10,13 +10,12 @@ type ImportRowResult = {
     }>;
 };
 /**
- * 按唯一键 upsert 导入行（含软删恢复，走 Repository.upsert）：
- * 1. 有 id 且存在 → 更新（软删先 restore）
- * 2. 否则按 unique 索引匹配 → 更新（软删先 restore）
- * 3. 否则新增（唯一键撞软删亦 restore）
+ * 清洗后整批 `svc.add`（与声明式 CRUD add 同源）：
+ * - 开 softDelete：`Repository.upsert`（有 id / 唯一键撞软删恢复 / 撞活行覆盖 / 纯新增）
+ * - 否则按 `vome.crud.upsert`：`save` 有 id 则更新否则插；`insert` 只插
+ * `uniqueKeys`（Controller `importUniqueKeys`）在 softDelete→upsert 时覆盖表 unique。
  */
-export declare function importEntityRows(svc: BaseService, table: PgTable, rows: Record<string, unknown>[], options?: {
-    /** 覆盖表唯一索引；不传则读表 unique */
+export declare function importEntityRows(svc: BaseService, _table: PgTable, rows: Record<string, unknown>[], options?: {
     uniqueKeys?: string[];
     ignoreProperty?: string[];
 }): Promise<ImportRowResult>;

package/dist/orm/index.d.ts

@@ -14,7 +14,7 @@ export { readCrudConfig, resolveSoftDelete, resolveUpsert, } from './crud-config
 export { Repository, getRepository, InjectRepository, } from './repository';
 export { registerOnForceDelete, clearForceDeleteHooks, runOnForceDelete, } from './force-delete-hooks';
 export type { ForceDeleteHook, ForceDeleteHookEvent, } from './force-delete-hooks';
-export { listUniqueKeySets, buildUniqueWhere } from './unique-keys';
+export { listUniqueKeySets, buildUniqueWhere, buildUniqueWhereForRows, uniqueFingerprint, } from './unique-keys';
 export { BaseService } from './service';
 export { q, compactWhere, needsAdvancedQuery, buildQueryOp } from './query-op';
 export { queryWithOp } from './query-builder';

package/dist/orm/repository.d.ts

@@ -41,23 +41,57 @@ export declare class Repository<T extends PgTable> {
     private findSoftDeletedByUnique;
     /** 按唯一键找行（含软删）；`uniqueKeys` 覆盖表上 unique 索引 */
     private findByUniqueIncludingTrashed;
+    /**
+     * 批量按唯一键组查询；返回每组 fingerprint → 行。
+     * `onlyTrashed` 时只查软删行（create 撞软删恢复用）。
+     */
+    private lookupUniqueMaps;
+    private matchUniqueMaps;
     private rowId;
     private rowDeleteTime;
     private restoreThenUpdate;
+    /** 批量恢复软删 id（一次 UPDATE） */
+    private restoreSoftIds;
+    /** 纯批量 INSERT（不再走 softDelete 逐条逻辑） */
+    private insertManyRaw;
+    /** 行在各唯一键组上的指纹（`setIdx:fp`）；无完整键则空 */
+    private uniqueFpKeys;
+    /**
+     * 同批待插入行按唯一键折叠：先到者 insert，后者挂到同一 root 插入行，插完再 update（对齐逐条 upsert）。
+     */
+    private foldInsertsByUnique;
+    /**
+     * 批量：restore → update → insert → 同批折叠的 deferred update。
+     * 返回与入参等长、按下标对齐；缺结果则抛错。
+     */
+    private applyBatchWrite;
     private createOne;
+    /**
+     * softDelete 下 create(数组)：批量查软删唯一键 → 恢复更新 / 纯插入。
+     * 同批重复唯一键折叠（先插后更）；撞活行唯一仍由 DB 报错。
+     */
+    private createManySoft;
     /**
      * 插入；若唯一键命中软删行则 restore + update（不再抛唯一冲突）。
-     * 数组：开启软删时逐条处理（可能混插/恢复）；否则仍一条批量 INSERT。
+     * 数组：
+     * - 开 softDelete：批量查软删唯一 → 批量恢复更新 / 批量插入
+     * - 否则：一条批量 INSERT，`ON CONFLICT DO NOTHING`
      */
     create(data: readonly unknown[]): Promise<InferSelectModel<T>[]>;
     create(data: unknown): Promise<InferSelectModel<T>>;
     /**
      * 按 id 或唯一键写入：命中则 update（软删先 restore；活行则覆盖），未命中则 create。
+     * 数组：先批量查 id / 唯一键，再批量更新 + 批量新增。
      * `options.uniqueKeys` 覆盖表 unique（如 Excel importUniqueKeys）。
      */
+    upsert(data: readonly unknown[], options?: {
+        uniqueKeys?: string[];
+    }): Promise<InferSelectModel<T>[]>;
     upsert(data: unknown, options?: {
         uniqueKeys?: string[];
     }): Promise<InferSelectModel<T>>;
+    /** 批量 upsert：查 id → 查唯一键 → 分类 → 批量 restore/update/insert */
+    private upsertMany;
     /**
      * 有 id 且存在（含软删）则更新（软删先 restore），否则插入。
      * 对象 / 数组均可；数组时一次查出已存在 id，再批量 update + insert。

package/dist/orm/service.d.ts

@@ -34,9 +34,10 @@ export declare abstract class BaseService {
     modifyAfter(_data: any, _type: CrudModifyType): Promise<void>;
     /**
      * 新增（单条 / 数组）。
-     * - 表支持软删且 `vome.crud.softDelete`：统一 `Repository.upsert`
+     * - 表支持软删且 `vome.crud.softDelete`：统一 `Repository.upsert`（单条 / 数组均批量分类写入）
      *   （有 id / 唯一键撞软删恢复 / 撞活行覆盖 / 纯新增；与配置 save|insert 无关）
      * - 否则：按 `vome.crud.upsert` → `save`（有 id 则更新）或 `create`（只插）
+     * - `options.uniqueKeys`：仅 softDelete→upsert 时覆盖表 unique（Excel import 用）
      */
     add(data: unknown, options?: CrudWriteOptions): Promise<unknown>;
     /**

package/dist/orm/unique-keys.d.ts

@@ -2,5 +2,12 @@ import { type SQL } from 'drizzle-orm';
 import { type PgTable } from 'drizzle-orm/pg-core';
 /** 从表唯一索引 / unique 约束提取键集合 */
 export declare function listUniqueKeySets(table: PgTable): string[][];
+/** 唯一键指纹；任一键为空则 undefined */
+export declare function uniqueFingerprint(keys: string[], row: Record<string, unknown>): string | undefined;
 /** 按唯一键拼 where；任一键为空则返回 undefined */
 export declare function buildUniqueWhere(table: PgTable, keys: string[], row: Record<string, unknown>): SQL | undefined;
+/**
+ * 多行同一唯一键组：单列用 inArray，多列用 OR(AND…)。
+ * 无有效行时返回 undefined。
+ */
+export declare function buildUniqueWhereForRows(table: PgTable, keys: string[], rows: Record<string, unknown>[]): SQL | undefined;