vome-core 0.3.34 → 0.3.35

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

@@ -1,5 +1,6 @@
-import { type PgTable } from 'drizzle-orm/pg-core';
+import type { PgTable } from 'drizzle-orm/pg-core';
 import type { BaseService } from './service';
+export { listUniqueKeySets, buildUniqueWhere } from './unique-keys';
 export declare function buildEntityImportTemplate(table: PgTable, ignoreProperty?: string[]): Uint8Array;
 type ImportRowResult = {
     inserted: number;
@@ -10,12 +11,13 @@ type ImportRowResult = {
     }>;
 };
 /**
- * 按唯一键 upsert 导入行：
- * 1. 有 id 且存在 → 更新
- * 2. 否则按 unique 索引匹配 → 更新
- * 3. 否则新增
+ * 按唯一键 upsert 导入行（含软删恢复，走 Repository.upsert）：
+ * 1. 有 id 且存在 → 更新（软删先 restore）
+ * 2. 否则按 unique 索引匹配 → 更新（软删先 restore）
+ * 3. 否则新增（唯一键撞软删亦 restore）
  */
 export declare function importEntityRows(svc: BaseService, table: PgTable, rows: Record<string, unknown>[], options?: {
+    /** 覆盖表唯一索引；不传则读表 unique */
     uniqueKeys?: string[];
     ignoreProperty?: string[];
 }): Promise<ImportRowResult>;
@@ -24,4 +26,3 @@ export declare function importEntityExcel(svc: BaseService, table: PgTable, file
     uniqueKeys?: string[];
     ignoreProperty?: string[];
 }): Promise<ImportRowResult>;
-export {};

package/dist/orm/index.d.ts

@@ -14,6 +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 { BaseService } from './service';
 export { q, compactWhere, needsAdvancedQuery, buildQueryOp } from './query-op';
 export { queryWithOp } from './query-builder';

package/dist/orm/repository.d.ts

@@ -37,11 +37,26 @@ export declare class Repository<T extends PgTable> {
         orderBy?: SQL[];
     } & CrudTrashQueryOptions): Promise<PageResult<InferSelectModel<T>>>;
     private parseInsert;
-    /** 插入；对象 / 数组都直接交给 values()（Drizzle 两者都支持） */
+    /** 按唯一键找软删行（须开 softDelete 才能看到 deleteTime） */
+    private findSoftDeletedByUnique;
+    /** 按唯一键找行（含软删） */
+    private findByUniqueIncludingTrashed;
+    private rowId;
+    private rowDeleteTime;
+    private restoreThenUpdate;
+    private createOne;
+    /**
+     * 插入；若唯一键命中软删行则 restore + update（不再抛唯一冲突）。
+     * 数组：开启软删时逐条处理（可能混插/恢复）；否则仍一条批量 INSERT。
+     */
     create(data: readonly unknown[]): Promise<InferSelectModel<T>[]>;
     create(data: unknown): Promise<InferSelectModel<T>>;
     /**
-     * 有 id 且存在则更新，否则插入。
+     * 按 id 或唯一键写入：命中则 update（软删先 restore），未命中则 create。
+     */
+    upsert(data: unknown): Promise<InferSelectModel<T>>;
+    /**
+     * 有 id 且存在（含软删）则更新（软删先 restore），否则插入。
      * 对象 / 数组均可；数组时一次查出已存在 id，再批量 update + insert。
      */
     save(data: readonly unknown[]): Promise<InferSelectModel<T>[]>;

package/dist/orm/service.d.ts

@@ -32,7 +32,9 @@ export declare abstract class BaseService {
      * - delete：data 为 where 条件
      */
     modifyAfter(_data: any, _type: CrudModifyType): Promise<void>;
-    /** 新增；数组走 create/save 批量；受 vome.crud.upsert 控制 */
+    /** 新增；数组走 create/save 批量；受 vome.crud.upsert 控制。
+     * create：唯一键撞软删行会 restore + update。
+     */
     add(data: unknown, options?: CrudWriteOptions): Promise<{
         [x: string]: any;
     }>;

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

@@ -0,0 +1,6 @@
+import { type SQL } from 'drizzle-orm';
+import { type PgTable } from 'drizzle-orm/pg-core';
+/** 从表唯一索引 / unique 约束提取键集合 */
+export declare function listUniqueKeySets(table: PgTable): string[][];
+/** 按唯一键拼 where；任一键为空则返回 undefined */
+export declare function buildUniqueWhere(table: PgTable, keys: string[], row: Record<string, unknown>): SQL | undefined;