@woltz/rich-domain-drizzle 0.1.0

package/dist/cjs/batch-executor.d.ts

@@ -0,0 +1,30 @@
+import { AggregateChanges, EntitySchemaRegistry } from "@woltz/rich-domain";
+import { DrizzleClient } from "./unit-of-work";
+export interface DrizzleBatchExecutorConfig {
+    registry: EntitySchemaRegistry;
+    db: DrizzleClient;
+    tableMap: Map<string, any>;
+}
+export declare class DrizzleBatchExecutor {
+    private readonly config;
+    constructor(config: DrizzleBatchExecutorConfig);
+    /**
+     * Execute all batch operations in order:
+     * 1. Deletes (leaf → root, sorted by depth DESC)
+     * 2. Creates (root → leaf, sorted by depth ASC)
+     * 3. Updates (any order)
+     */
+    execute(changes: AggregateChanges): Promise<void>;
+    private executeDeletes;
+    private executeDeleteOwned;
+    private executeJunctionDelete;
+    private executeCreates;
+    private executeCreateOwned;
+    private executeJunctionCreate;
+    private executeUpdates;
+    private getTable;
+    private getJunctionTable;
+    private extractId;
+}
+export declare function executeBatch(db: DrizzleClient, changes: AggregateChanges, config: Omit<DrizzleBatchExecutorConfig, "db">): Promise<void>;
+//# sourceMappingURL=batch-executor.d.ts.map

package/dist/cjs/batch-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-executor.d.ts","sourceRoot":"","sources":["../../src/batch-executor.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EAKrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAO/C,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,EAAE,EAAE,aAAa,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,0BAA0B;IAE/D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAUzC,cAAc;YAgCd,kBAAkB;YAoBlB,qBAAqB;YAsCrB,cAAc;YA2Bd,kBAAkB;YA6BlB,qBAAqB;YA0DrB,cAAc;IA+B5B,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,SAAS;CASlB;AAED,wBAAsB,YAAY,CAChC,EAAE,EAAE,aAAa,EACjB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/cjs/batch-executor.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrizzleBatchExecutor = void 0;
+exports.executeBatch = executeBatch;
+const drizzle_orm_1 = require("drizzle-orm");
+const errors_1 = require("./errors");
+class DrizzleBatchExecutor {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Execute all batch operations in order:
+     * 1. Deletes (leaf → root, sorted by depth DESC)
+     * 2. Creates (root → leaf, sorted by depth ASC)
+     * 3. Updates (any order)
+     */
+    async execute(changes) {
+        if (changes.isEmpty())
+            return;
+        const batch = changes.toBatchOperations();
+        await this.executeDeletes(batch.deletes);
+        await this.executeCreates(batch.creates);
+        await this.executeUpdates(batch.updates);
+    }
+    async executeDeletes(deletes) {
+        const sorted = [...deletes].sort((a, b) => b.depth - a.depth);
+        for (const del of sorted) {
+            const { entity, ids, relationField, parentEntity, parentId } = del;
+            if (relationField && parentEntity) {
+                this.config.registry.validateRelationField(parentEntity, relationField);
+                if (this.config.registry.isReferenceCollection(parentEntity, relationField)) {
+                    await this.executeJunctionDelete(parentEntity, relationField, parentId, ids);
+                }
+                else {
+                    await this.executeDeleteOwned(entity, ids);
+                }
+            }
+            else {
+                await this.executeDeleteOwned(entity, ids);
+            }
+        }
+    }
+    async executeDeleteOwned(entity, ids) {
+        if (ids.length === 0)
+            return;
+        const table = this.getTable(entity);
+        try {
+            await this.config.db.delete(table).where((0, drizzle_orm_1.inArray)(table.id, ids));
+        }
+        catch (error) {
+            throw new errors_1.BatchOperationError("delete", entity, error.message || "Unknown error during deletion", error);
+        }
+    }
+    async executeJunctionDelete(parentEntity, relationField, parentId, ids) {
+        if (ids.length === 0 || !parentId)
+            return;
+        const junction = this.config.registry.getJunctionConfig(parentEntity, relationField);
+        if (!junction) {
+            throw new errors_1.MissingJunctionConfigError(parentEntity, relationField);
+        }
+        const junctionTable = this.getJunctionTable(junction.table);
+        try {
+            await this.config.db
+                .delete(junctionTable)
+                .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(junctionTable[junction.sourceKey], parentId), (0, drizzle_orm_1.inArray)(junctionTable[junction.targetKey], ids)));
+        }
+        catch (error) {
+            throw new errors_1.BatchOperationError("disconnect", junction.table, error.message || "Failed to delete from junction table", error);
+        }
+    }
+    async executeCreates(creates) {
+        const sorted = [...creates].sort((a, b) => a.depth - b.depth);
+        for (const create of sorted) {
+            const { entity, items, relationField, parentEntity } = create;
+            if (relationField && parentEntity) {
+                this.config.registry.validateRelationField(parentEntity, relationField);
+                if (this.config.registry.isReferenceCollection(parentEntity, relationField)) {
+                    await this.executeJunctionCreate(parentEntity, relationField, items);
+                }
+                else {
+                    await this.executeCreateOwned(entity, items);
+                }
+            }
+            else {
+                await this.executeCreateOwned(entity, items);
+            }
+        }
+    }
+    async executeCreateOwned(entity, items) {
+        if (items.length === 0)
+            return;
+        const table = this.getTable(entity);
+        const records = items.map((item) => {
+            const entityData = this.config.registry.mapEntity(entity, item.data);
+            const fk = item.parentId
+                ? this.config.registry.getParentFk(entity, item.parentId)
+                : null;
+            return { ...entityData, ...fk };
+        });
+        try {
+            await this.config.db.insert(table).values(records);
+        }
+        catch (error) {
+            throw new errors_1.BatchOperationError("create", entity, error.message || "Unknown error during creation", error);
+        }
+    }
+    async executeJunctionCreate(parentEntity, relationField, items) {
+        if (items.length === 0)
+            return;
+        const junction = this.config.registry.getJunctionConfig(parentEntity, relationField);
+        if (!junction) {
+            throw new errors_1.MissingJunctionConfigError(parentEntity, relationField);
+        }
+        const junctionTable = this.getJunctionTable(junction.table);
+        const grouped = new Map();
+        for (const item of items) {
+            const parentId = item.parentId;
+            if (!parentId)
+                continue;
+            const entityId = this.extractId(item.data);
+            if (!entityId)
+                continue;
+            if (!grouped.has(parentId)) {
+                grouped.set(parentId, []);
+            }
+            grouped.get(parentId).push(entityId);
+        }
+        const records = [];
+        for (const [parentId, targetIds] of grouped) {
+            for (const targetId of targetIds) {
+                records.push({
+                    [junction.sourceKey]: parentId,
+                    [junction.targetKey]: targetId,
+                });
+            }
+        }
+        if (records.length === 0)
+            return;
+        try {
+            await this.config.db
+                .insert(junctionTable)
+                .values(records)
+                .onConflictDoNothing();
+        }
+        catch (error) {
+            throw new errors_1.BatchOperationError("connect", junction.table, error.message || "Failed to insert into junction table", error);
+        }
+    }
+    async executeUpdates(updates) {
+        for (const upd of updates) {
+            const table = this.getTable(upd.entity);
+            for (const item of upd.items) {
+                const mappedFields = this.config.registry.mapFields(upd.entity, item.changedFields);
+                if (Object.keys(mappedFields).length > 0) {
+                    try {
+                        await this.config.db
+                            .update(table)
+                            .set(mappedFields)
+                            .where((0, drizzle_orm_1.eq)(table.id, item.id));
+                    }
+                    catch (error) {
+                        throw new errors_1.BatchOperationError("update", upd.entity, error.message || "Failed to update entity", error);
+                    }
+                }
+            }
+        }
+    }
+    getTable(entityName) {
+        const table = this.config.tableMap.get(entityName);
+        if (!table) {
+            throw new errors_1.TableNotFoundError(entityName, Array.from(this.config.tableMap.keys()));
+        }
+        return table;
+    }
+    getJunctionTable(tableName) {
+        const table = this.config.tableMap.get(tableName);
+        if (!table) {
+            throw new errors_1.TableNotFoundError(tableName, Array.from(this.config.tableMap.keys()));
+        }
+        return table;
+    }
+    extractId(data) {
+        if (!data)
+            return undefined;
+        if (data.id?.value !== undefined && data.id?.value !== null) {
+            return String(data.id.value);
+        }
+        if (typeof data.id === "string")
+            return data.id;
+        if (typeof data.id === "number")
+            return String(data.id);
+        return undefined;
+    }
+}
+exports.DrizzleBatchExecutor = DrizzleBatchExecutor;
+async function executeBatch(db, changes, config) {
+    const executor = new DrizzleBatchExecutor({ ...config, db });
+    await executor.execute(changes);
+}
+//# sourceMappingURL=batch-executor.js.map

package/dist/cjs/batch-executor.js.map

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

package/dist/cjs/errors.d.ts

@@ -0,0 +1,31 @@
+export declare class DrizzleAdapterError extends Error {
+    constructor(message: string);
+}
+export declare class TableNotFoundError extends DrizzleAdapterError {
+    readonly entityName: string;
+    readonly availableTables: string[];
+    constructor(entityName: string, availableTables: string[]);
+}
+export declare class NoRecordsAffectedError extends DrizzleAdapterError {
+    readonly operation: string;
+    readonly entity: string;
+    readonly id: string;
+    readonly cause?: Error | undefined;
+    constructor(operation: string, entity: string, id: string, cause?: Error | undefined);
+}
+export declare class BatchOperationError extends DrizzleAdapterError {
+    readonly operation: string;
+    readonly entity: string;
+    readonly cause?: Error | undefined;
+    constructor(operation: string, entity: string, message: string, cause?: Error | undefined);
+}
+export declare class DrizzleRepositoryError extends DrizzleAdapterError {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+export declare class MissingJunctionConfigError extends DrizzleAdapterError {
+    readonly parentEntity: string;
+    readonly collectionField: string;
+    constructor(parentEntity: string, collectionField: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,mBAAmB;aAEvC,UAAU,EAAE,MAAM;aAClB,eAAe,EAAE,MAAM,EAAE;gBADzB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EAAE;CAQ5C;AAED,qBAAa,sBAAuB,SAAQ,mBAAmB;aAE3C,SAAS,EAAE,MAAM;aACjB,MAAM,EAAE,MAAM;aACd,EAAE,EAAE,MAAM;aACV,KAAK,CAAC,EAAE,KAAK;gBAHb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,qBAAa,mBAAoB,SAAQ,mBAAmB;aAExC,SAAS,EAAE,MAAM;aACjB,MAAM,EAAE,MAAM;aAEd,KAAK,CAAC,EAAE,KAAK;gBAHb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,qBAAa,sBAAuB,SAAQ,mBAAmB;aAG3C,KAAK,CAAC,EAAE,KAAK;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,qBAAa,0BAA2B,SAAQ,mBAAmB;aAE/C,YAAY,EAAE,MAAM;aACpB,eAAe,EAAE,MAAM;gBADvB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM;CAoB1C"}

package/dist/cjs/errors.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingJunctionConfigError = exports.DrizzleRepositoryError = exports.BatchOperationError = exports.NoRecordsAffectedError = exports.TableNotFoundError = exports.DrizzleAdapterError = void 0;
+class DrizzleAdapterError extends Error {
+    constructor(message) {
+        super(`[DrizzleAdapter] ${message}`);
+        this.name = "DrizzleAdapterError";
+    }
+}
+exports.DrizzleAdapterError = DrizzleAdapterError;
+class TableNotFoundError extends DrizzleAdapterError {
+    entityName;
+    availableTables;
+    constructor(entityName, availableTables) {
+        super(`Table for entity "${entityName}" not found in tableMap. ` +
+            `Available: ${availableTables.join(", ")}`);
+        this.entityName = entityName;
+        this.availableTables = availableTables;
+        this.name = "TableNotFoundError";
+    }
+}
+exports.TableNotFoundError = TableNotFoundError;
+class NoRecordsAffectedError extends DrizzleAdapterError {
+    operation;
+    entity;
+    id;
+    cause;
+    constructor(operation, entity, id, cause) {
+        super(`${operation} on ${entity} (id: ${id}) affected 0 records`);
+        this.operation = operation;
+        this.entity = entity;
+        this.id = id;
+        this.cause = cause;
+        this.name = "NoRecordsAffectedError";
+    }
+}
+exports.NoRecordsAffectedError = NoRecordsAffectedError;
+class BatchOperationError extends DrizzleAdapterError {
+    operation;
+    entity;
+    cause;
+    constructor(operation, entity, message, cause) {
+        super(`Batch ${operation} on ${entity} failed: ${message}`);
+        this.operation = operation;
+        this.entity = entity;
+        this.cause = cause;
+        this.name = "BatchOperationError";
+    }
+}
+exports.BatchOperationError = BatchOperationError;
+class DrizzleRepositoryError extends DrizzleAdapterError {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = "DrizzleRepositoryError";
+    }
+}
+exports.DrizzleRepositoryError = DrizzleRepositoryError;
+class MissingJunctionConfigError extends DrizzleAdapterError {
+    parentEntity;
+    collectionField;
+    constructor(parentEntity, collectionField) {
+        super(`Collection "${collectionField}" on entity "${parentEntity}" is of type "reference" but has no junction configured. ` +
+            `Drizzle does not manage junction tables automatically — you must provide the junction config. ` +
+            `Example:\n` +
+            `  collections: {\n` +
+            `    ${collectionField}: {\n` +
+            `      type: "reference",\n` +
+            `      entity: "TargetEntity",\n` +
+            `      junction: {\n` +
+            `        table: "${parentEntity.toLowerCase()}_${collectionField}",\n` +
+            `        sourceKey: "${parentEntity.toLowerCase()}Id",\n` +
+            `        targetKey: "targetEntityId",\n` +
+            `      },\n` +
+            `    },\n` +
+            `  }`);
+        this.parentEntity = parentEntity;
+        this.collectionField = collectionField;
+        this.name = "MissingJunctionConfigError";
+    }
+}
+exports.MissingJunctionConfigError = MissingJunctionConfigError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,MAAa,kBAAmB,SAAQ,mBAAmB;IAEvC;IACA;IAFlB,YACkB,UAAkB,EAClB,eAAyB;QAEzC,KAAK,CACH,qBAAqB,UAAU,2BAA2B;YACxD,cAAc,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7C,CAAC;QANc,eAAU,GAAV,UAAU,CAAQ;QAClB,oBAAe,GAAf,eAAe,CAAU;QAMzC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAXD,gDAWC;AAED,MAAa,sBAAuB,SAAQ,mBAAmB;IAE3C;IACA;IACA;IACA;IAJlB,YACkB,SAAiB,EACjB,MAAc,EACd,EAAU,EACV,KAAa;QAE7B,KAAK,CAAC,GAAG,SAAS,OAAO,MAAM,SAAS,EAAE,sBAAsB,CAAC,CAAC;QALlD,cAAS,GAAT,SAAS,CAAQ;QACjB,WAAM,GAAN,MAAM,CAAQ;QACd,OAAE,GAAF,EAAE,CAAQ;QACV,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAVD,wDAUC;AAED,MAAa,mBAAoB,SAAQ,mBAAmB;IAExC;IACA;IAEA;IAJlB,YACkB,SAAiB,EACjB,MAAc,EAC9B,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,SAAS,SAAS,OAAO,MAAM,YAAY,OAAO,EAAE,CAAC,CAAC;QAL5C,cAAS,GAAT,SAAS,CAAQ;QACjB,WAAM,GAAN,MAAM,CAAQ;QAEd,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAVD,kDAUC;AAED,MAAa,sBAAuB,SAAQ,mBAAmB;IAG3C;IAFlB,YACE,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AARD,wDAQC;AAED,MAAa,0BAA2B,SAAQ,mBAAmB;IAE/C;IACA;IAFlB,YACkB,YAAoB,EACpB,eAAuB;QAEvC,KAAK,CACH,eAAe,eAAe,gBAAgB,YAAY,2DAA2D;YACnH,gGAAgG;YAChG,YAAY;YACZ,oBAAoB;YACpB,OAAO,eAAe,OAAO;YAC7B,4BAA4B;YAC5B,iCAAiC;YACjC,qBAAqB;YACrB,mBAAmB,YAAY,CAAC,WAAW,EAAE,IAAI,eAAe,MAAM;YACtE,uBAAuB,YAAY,CAAC,WAAW,EAAE,QAAQ;YACzD,wCAAwC;YACxC,YAAY;YACZ,UAAU;YACV,KAAK,CACR,CAAC;QAlBc,iBAAY,GAAZ,YAAY,CAAQ;QACpB,oBAAe,GAAf,eAAe,CAAQ;QAkBvC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAvBD,gEAuBC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,8 @@
+export { DrizzleUnitOfWork, DrizzleTransactionContext, UOWStorage, Transactional, getCurrentDrizzleContext, type DrizzleClient, type DrizzleTransactionClient, } from "./unit-of-work";
+export { DrizzleRepository, type DrizzleRepositoryConfig } from "./repository";
+export { DrizzleToPersistence } from "./mappers/to-persistence";
+export { DrizzleToDomain } from "./mappers/to-domain";
+export { DrizzleBatchExecutor, executeBatch, type DrizzleBatchExecutorConfig, } from "./batch-executor";
+export { DrizzleQueryBuilder, type SearchableField } from "./query-builder";
+export { DrizzleAdapterError, TableNotFoundError, NoRecordsAffectedError, BatchOperationError, DrizzleRepositoryError, MissingJunctionConfigError, } from "./errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,KAAK,aAAa,EAClB,KAAK,wBAAwB,GAC9B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,KAAK,0BAA0B,GAChC,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG5E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,UAAU,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingJunctionConfigError = exports.DrizzleRepositoryError = exports.BatchOperationError = exports.NoRecordsAffectedError = exports.TableNotFoundError = exports.DrizzleAdapterError = exports.DrizzleQueryBuilder = exports.executeBatch = exports.DrizzleBatchExecutor = exports.DrizzleToDomain = exports.DrizzleToPersistence = exports.DrizzleRepository = exports.getCurrentDrizzleContext = exports.Transactional = exports.UOWStorage = exports.DrizzleTransactionContext = exports.DrizzleUnitOfWork = void 0;
+// Unit of Work
+var unit_of_work_1 = require("./unit-of-work");
+Object.defineProperty(exports, "DrizzleUnitOfWork", { enumerable: true, get: function () { return unit_of_work_1.DrizzleUnitOfWork; } });
+Object.defineProperty(exports, "DrizzleTransactionContext", { enumerable: true, get: function () { return unit_of_work_1.DrizzleTransactionContext; } });
+Object.defineProperty(exports, "UOWStorage", { enumerable: true, get: function () { return unit_of_work_1.UOWStorage; } });
+Object.defineProperty(exports, "Transactional", { enumerable: true, get: function () { return unit_of_work_1.Transactional; } });
+Object.defineProperty(exports, "getCurrentDrizzleContext", { enumerable: true, get: function () { return unit_of_work_1.getCurrentDrizzleContext; } });
+// Repository
+var repository_1 = require("./repository");
+Object.defineProperty(exports, "DrizzleRepository", { enumerable: true, get: function () { return repository_1.DrizzleRepository; } });
+// Mappers
+var to_persistence_1 = require("./mappers/to-persistence");
+Object.defineProperty(exports, "DrizzleToPersistence", { enumerable: true, get: function () { return to_persistence_1.DrizzleToPersistence; } });
+var to_domain_1 = require("./mappers/to-domain");
+Object.defineProperty(exports, "DrizzleToDomain", { enumerable: true, get: function () { return to_domain_1.DrizzleToDomain; } });
+// Batch Executor
+var batch_executor_1 = require("./batch-executor");
+Object.defineProperty(exports, "DrizzleBatchExecutor", { enumerable: true, get: function () { return batch_executor_1.DrizzleBatchExecutor; } });
+Object.defineProperty(exports, "executeBatch", { enumerable: true, get: function () { return batch_executor_1.executeBatch; } });
+// Query Builder
+var query_builder_1 = require("./query-builder");
+Object.defineProperty(exports, "DrizzleQueryBuilder", { enumerable: true, get: function () { return query_builder_1.DrizzleQueryBuilder; } });
+// Errors
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "DrizzleAdapterError", { enumerable: true, get: function () { return errors_1.DrizzleAdapterError; } });
+Object.defineProperty(exports, "TableNotFoundError", { enumerable: true, get: function () { return errors_1.TableNotFoundError; } });
+Object.defineProperty(exports, "NoRecordsAffectedError", { enumerable: true, get: function () { return errors_1.NoRecordsAffectedError; } });
+Object.defineProperty(exports, "BatchOperationError", { enumerable: true, get: function () { return errors_1.BatchOperationError; } });
+Object.defineProperty(exports, "DrizzleRepositoryError", { enumerable: true, get: function () { return errors_1.DrizzleRepositoryError; } });
+Object.defineProperty(exports, "MissingJunctionConfigError", { enumerable: true, get: function () { return errors_1.MissingJunctionConfigError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,eAAe;AACf,+CAQwB;AAPtB,iHAAA,iBAAiB,OAAA;AACjB,yHAAA,yBAAyB,OAAA;AACzB,0GAAA,UAAU,OAAA;AACV,6GAAA,aAAa,OAAA;AACb,wHAAA,wBAAwB,OAAA;AAK1B,aAAa;AACb,2CAA+E;AAAtE,+GAAA,iBAAiB,OAAA;AAE1B,UAAU;AACV,2DAAgE;AAAvD,sHAAA,oBAAoB,OAAA;AAC7B,iDAAsD;AAA7C,4GAAA,eAAe,OAAA;AAExB,iBAAiB;AACjB,mDAI0B;AAHxB,sHAAA,oBAAoB,OAAA;AACpB,8GAAA,YAAY,OAAA;AAId,gBAAgB;AAChB,iDAA4E;AAAnE,oHAAA,mBAAmB,OAAA;AAE5B,SAAS;AACT,mCAOkB;AANhB,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAClB,gHAAA,sBAAsB,OAAA;AACtB,6GAAA,mBAAmB,OAAA;AACnB,gHAAA,sBAAsB,OAAA;AACtB,oHAAA,0BAA0B,OAAA"}

package/dist/cjs/mappers/to-domain.d.ts

@@ -0,0 +1,11 @@
+import { Mapper } from "@woltz/rich-domain";
+/**
+ * Base class for mapping Drizzle query results to domain entities.
+ * Subclass and implement build() to transform DB records to domain aggregates.
+ *
+ * This is identical to a plain Mapper<TPersistence, TDomain>.
+ * Provided for naming consistency with the adapter pattern.
+ */
+export declare abstract class DrizzleToDomain<TPersistence, TDomain> extends Mapper<TPersistence, TDomain> {
+}
+//# sourceMappingURL=to-domain.d.ts.map

package/dist/cjs/mappers/to-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-domain.d.ts","sourceRoot":"","sources":["../../../src/mappers/to-domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;GAMG;AACH,8BAAsB,eAAe,CAAC,YAAY,EAAE,OAAO,CAAE,SAAQ,MAAM,CACzE,YAAY,EACZ,OAAO,CACR;CAAG"}

package/dist/cjs/mappers/to-domain.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrizzleToDomain = void 0;
+const rich_domain_1 = require("@woltz/rich-domain");
+/**
+ * Base class for mapping Drizzle query results to domain entities.
+ * Subclass and implement build() to transform DB records to domain aggregates.
+ *
+ * This is identical to a plain Mapper<TPersistence, TDomain>.
+ * Provided for naming consistency with the adapter pattern.
+ */
+class DrizzleToDomain extends rich_domain_1.Mapper {
+}
+exports.DrizzleToDomain = DrizzleToDomain;
+//# sourceMappingURL=to-domain.js.map

package/dist/cjs/mappers/to-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-domain.js","sourceRoot":"","sources":["../../../src/mappers/to-domain.ts"],"names":[],"mappings":";;;AAAA,oDAA4C;AAE5C;;;;;;GAMG;AACH,MAAsB,eAAuC,SAAQ,oBAGpE;CAAG;AAHJ,0CAGI"}

package/dist/cjs/mappers/to-persistence.d.ts

@@ -0,0 +1,47 @@
+import { Mapper, AggregateChanges, EntitySchemaRegistry } from "@woltz/rich-domain";
+import { DrizzleClient, DrizzleUnitOfWork } from "../unit-of-work";
+export declare abstract class DrizzleToPersistence<TDomain> extends Mapper<TDomain, void> {
+    protected readonly uow: DrizzleUnitOfWork;
+    constructor(uow: DrizzleUnitOfWork);
+    /**
+     * Schema registry for field mapping (entity → table, field → column).
+     */
+    protected abstract readonly registry: EntitySchemaRegistry;
+    /**
+     * Map of entity names to Drizzle table objects.
+     *
+     * @example
+     * ```typescript
+     * protected readonly tableMap = new Map([
+     *   ["User", usersTable],
+     *   ["Post", postsTable],
+     * ]);
+     * ```
+     */
+    protected abstract readonly tableMap: Map<string, any>;
+    /**
+     * Get the raw db instance.
+     */
+    protected abstract getDb(): DrizzleClient;
+    /**
+     * Get current context (transaction client or raw db).
+     */
+    protected get context(): DrizzleClient;
+    /**
+     * Build persistence operations.
+     */
+    build(entity: TDomain): Promise<void>;
+    /**
+     * Handle new aggregate creation.
+     * Must be implemented by subclass.
+     */
+    protected abstract onCreate(aggregate: TDomain): Promise<void>;
+    /**
+     * Handle aggregate update with changes.
+     * Default implementation uses DrizzleBatchExecutor.
+     * Subclass can override for custom logic.
+     */
+    protected onUpdate(changes: AggregateChanges, _aggregate: TDomain): Promise<void>;
+    private handleUpdate;
+}
+//# sourceMappingURL=to-persistence.d.ts.map

package/dist/cjs/mappers/to-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-persistence.d.ts","sourceRoot":"","sources":["../../../src/mappers/to-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,iBAAiB,EAGlB,MAAM,iBAAiB,CAAC;AAGzB,8BAAsB,oBAAoB,CAAC,OAAO,CAAE,SAAQ,MAAM,CAChE,OAAO,EACP,IAAI,CACL;IACa,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,iBAAiB;gBAAtB,GAAG,EAAE,iBAAiB;IAIrD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IAE3D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,aAAa;IAEzC;;OAEG;IACH,SAAS,KAAK,OAAO,IAAI,aAAa,CAGrC;IAED;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9D;;;;OAIG;cACa,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC;YAUF,YAAY;CAW3B"}

package/dist/cjs/mappers/to-persistence.js

@@ -0,0 +1,69 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrizzleToPersistence = void 0;
+const rich_domain_1 = require("@woltz/rich-domain");
+const unit_of_work_1 = require("../unit-of-work");
+const batch_executor_1 = require("../batch-executor");
+class DrizzleToPersistence extends rich_domain_1.Mapper {
+    uow;
+    constructor(uow) {
+        super();
+        this.uow = uow;
+    }
+    /**
+     * Get current context (transaction client or raw db).
+     */
+    get context() {
+        const ctx = unit_of_work_1.UOWStorage.getStore()?.ctx;
+        return ctx?.client ?? this.getDb();
+    }
+    /**
+     * Build persistence operations.
+     */
+    async build(entity) {
+        const isNew = entity.isNew?.() ?? false;
+        if (isNew) {
+            await this.onCreate(entity);
+        }
+        else {
+            await this.handleUpdate(entity);
+        }
+    }
+    /**
+     * Handle aggregate update with changes.
+     * Default implementation uses DrizzleBatchExecutor.
+     * Subclass can override for custom logic.
+     */
+    async onUpdate(changes, _aggregate) {
+        const executor = new batch_executor_1.DrizzleBatchExecutor({
+            registry: this.registry,
+            db: this.context,
+            tableMap: this.tableMap,
+        });
+        await executor.execute(changes);
+    }
+    async handleUpdate(entity) {
+        const changes = entity.getChanges?.();
+        if (!changes || changes.isEmpty()) {
+            return;
+        }
+        await this.onUpdate(changes, entity);
+    }
+}
+exports.DrizzleToPersistence = DrizzleToPersistence;
+__decorate([
+    (0, unit_of_work_1.Transactional)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DrizzleToPersistence.prototype, "handleUpdate", null);
+//# sourceMappingURL=to-persistence.js.map

package/dist/cjs/mappers/to-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-persistence.js","sourceRoot":"","sources":["../../../src/mappers/to-persistence.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,oDAI4B;AAC5B,kDAKyB;AACzB,sDAAyD;AAEzD,MAAsB,oBAA8B,SAAQ,oBAG3D;IACgC;IAA/B,YAA+B,GAAsB;QACnD,KAAK,EAAE,CAAC;QADqB,QAAG,GAAH,GAAG,CAAmB;IAErD,CAAC;IAyBD;;OAEG;IACH,IAAc,OAAO;QACnB,MAAM,GAAG,GAAG,yBAAU,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC;QACvC,OAAO,GAAG,EAAE,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,MAAe;QACzB,MAAM,KAAK,GAAI,MAAc,CAAC,KAAK,EAAE,EAAE,IAAI,KAAK,CAAC;QAEjD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAQD;;;;OAIG;IACO,KAAK,CAAC,QAAQ,CACtB,OAAyB,EACzB,UAAmB;QAEnB,MAAM,QAAQ,GAAG,IAAI,qCAAoB,CAAC;YACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,EAAE,EAAE,IAAI,CAAC,OAAO;YAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAGa,AAAN,KAAK,CAAC,YAAY,CAAC,MAAe;QACxC,MAAM,OAAO,GAAI,MAAc,CAAC,UAAU,EAAE,EAE/B,CAAC;QAEd,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;CACF;AAvFD,oDAuFC;AAXe;IADb,IAAA,4BAAa,GAAE;;;;wDAWf"}

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

@@ -0,0 +1,24 @@
+import { SQL } from "drizzle-orm";
+import { Criteria } from "@woltz/rich-domain";
+export type SearchableField<T> = keyof T | {
+    field: string;
+    caseSensitive?: boolean;
+};
+export declare class DrizzleQueryBuilder {
+    /**
+     * Apply Criteria to a Drizzle select query.
+     *
+     * @param criteria - The Criteria instance with filters, orders, pagination, search
+     * @param table - The Drizzle table object (e.g., usersTable)
+     * @param searchableFields - Fields to search when criteria.hasSearch()
+     * @returns Object with { where, orderBy, limit, offset } ready for Drizzle query
+     */
+    static apply<T>(criteria: Criteria<T>, table: any, searchableFields?: SearchableField<any>[]): {
+        where?: SQL;
+        orderBy?: SQL[];
+        limit?: number;
+        offset?: number;
+    };
+    static resolveColumn(table: any, fieldPath: string): any;
+}
+//# sourceMappingURL=query-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../src/query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAkBL,GAAG,EACJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB,MAAM,CAAC,GACP;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAqB/C,qBAAa,mBAAmB;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EACZ,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,KAAK,EAAE,GAAG,EACV,gBAAgB,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,GACxC;QACD,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAqJD,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG;CAGzD"}