@unifiedcommerce/core 0.4.2 → 0.4.4

package/dist/modules/inventory/repository/index.js

@@ -1,310 +0,0 @@
-import { eq, and, inArray, isNull } from "drizzle-orm";
-import { warehouses, inventoryLevels, inventoryMovements } from "../schema.js";
-/**
- * InventoryRepository provides type-safe database operations for inventory entities.
- *
- * This repository manages warehouses, inventory levels, and inventory movements.
- * All methods support an optional TxContext parameter for transaction participation.
- */
-export class InventoryRepository {
-    db;
-    constructor(db) {
-        this.db = db;
-    }
-    getDb(ctx) {
-        return ctx?.tx ?? this.db;
-    }
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Warehouses
-    // ─────────────────────────────────────────────────────────────────────────────
-    async findWarehouseById(id, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db
-            .select()
-            .from(warehouses)
-            .where(eq(warehouses.id, id));
-        return rows[0];
-    }
-    async findWarehouseByCode(orgId, code, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db
-            .select()
-            .from(warehouses)
-            .where(and(eq(warehouses.organizationId, orgId), eq(warehouses.code, code)));
-        return rows[0];
-    }
-    async findAllWarehouses(orgId, ctx) {
-        const db = this.getDb(ctx);
-        return db
-            .select()
-            .from(warehouses)
-            .where(eq(warehouses.organizationId, orgId));
-    }
-    async findActiveWarehouses(orgId, ctx) {
-        const db = this.getDb(ctx);
-        return db
-            .select()
-            .from(warehouses)
-            .where(and(eq(warehouses.organizationId, orgId), eq(warehouses.isActive, true)));
-    }
-    async createWarehouse(data, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db.insert(warehouses).values(data).returning();
-        return rows[0];
-    }
-    async updateWarehouse(id, data, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db
-            .update(warehouses)
-            .set(data)
-            .where(eq(warehouses.id, id))
-            .returning();
-        return rows[0];
-    }
-    async deleteWarehouse(id, ctx) {
-        const db = this.getDb(ctx);
-        const result = await db
-            .delete(warehouses)
-            .where(eq(warehouses.id, id))
-            .returning();
-        return result.length > 0;
-    }
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Inventory Levels
-    // ─────────────────────────────────────────────────────────────────────────────
-    async findAllLevels(ctx) {
-        const db = this.getDb(ctx);
-        return db.select().from(inventoryLevels);
-    }
-    async findLevelById(id, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db
-            .select()
-            .from(inventoryLevels)
-            .where(eq(inventoryLevels.id, id));
-        return rows[0];
-    }
-    async findLevelByKey(entityId, warehouseId, variantId, ctx) {
-        const db = this.getDb(ctx);
-        const conditions = [
-            eq(inventoryLevels.entityId, entityId),
-            eq(inventoryLevels.warehouseId, warehouseId),
-        ];
-        // Only add variantId condition when it's a real string value — never pass null to eq()
-        if (variantId != null) {
-            conditions.push(eq(inventoryLevels.variantId, variantId));
-        }
-        const rows = await db
-            .select()
-            .from(inventoryLevels)
-            .where(and(...conditions));
-        // Post-filter for exact variantId match (handles SQL NULL correctly)
-        return rows.find((r) => r.variantId === (variantId ?? null));
-    }
-    async findLevelsByEntityId(entityId, ctx) {
-        const db = this.getDb(ctx);
-        return db
-            .select()
-            .from(inventoryLevels)
-            .where(eq(inventoryLevels.entityId, entityId));
-    }
-    async findLevelsByEntityAndVariant(entityId, variantId, ctx) {
-        const db = this.getDb(ctx);
-        const conditions = [eq(inventoryLevels.entityId, entityId)];
-        // Only add variantId condition when it's a real string value — never pass null to eq()
-        if (variantId != null) {
-            conditions.push(eq(inventoryLevels.variantId, variantId));
-        }
-        const rows = await db
-            .select()
-            .from(inventoryLevels)
-            .where(and(...conditions));
-        // Post-filter for exact variantId match (handles SQL NULL correctly in JS)
-        return rows.filter((r) => variantId == null ? r.variantId === null : r.variantId === variantId);
-    }
-    async findLevelsByWarehouseId(warehouseId, ctx) {
-        const db = this.getDb(ctx);
-        return db
-            .select()
-            .from(inventoryLevels)
-            .where(eq(inventoryLevels.warehouseId, warehouseId));
-    }
-    async createLevel(data, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db.insert(inventoryLevels).values(data).returning();
-        return rows[0];
-    }
-    async updateLevel(id, data, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db
-            .update(inventoryLevels)
-            .set({ ...data, updatedAt: new Date() })
-            .where(eq(inventoryLevels.id, id))
-            .returning();
-        return rows[0];
-    }
-    async upsertLevel(entityId, warehouseId, variantId, data, ctx) {
-        const existing = await this.findLevelByKey(entityId, warehouseId, variantId, ctx);
-        if (existing) {
-            const updated = await this.updateLevel(existing.id, data, ctx);
-            return updated;
-        }
-        return this.createLevel({
-            ...data,
-            entityId,
-            warehouseId,
-            ...(variantId !== undefined ? { variantId } : {}),
-        }, ctx);
-    }
-    async deleteLevel(id, ctx) {
-        const db = this.getDb(ctx);
-        const result = await db
-            .delete(inventoryLevels)
-            .where(eq(inventoryLevels.id, id))
-            .returning();
-        return result.length > 0;
-    }
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Inventory Movements
-    // ─────────────────────────────────────────────────────────────────────────────
-    async findMovementById(id, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db
-            .select()
-            .from(inventoryMovements)
-            .where(eq(inventoryMovements.id, id));
-        return rows[0];
-    }
-    async findMovementsByEntityId(entityId, ctx) {
-        const db = this.getDb(ctx);
-        return db
-            .select()
-            .from(inventoryMovements)
-            .where(eq(inventoryMovements.entityId, entityId));
-    }
-    async findMovementsByReference(referenceType, referenceId, ctx) {
-        const db = this.getDb(ctx);
-        return db
-            .select()
-            .from(inventoryMovements)
-            .where(and(eq(inventoryMovements.referenceType, referenceType), eq(inventoryMovements.referenceId, referenceId)));
-    }
-    async createMovement(data, ctx) {
-        const db = this.getDb(ctx);
-        const rows = await db.insert(inventoryMovements).values(data).returning();
-        return rows[0];
-    }
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Concurrency-Safe Operations (SELECT FOR UPDATE)
-    // ─────────────────────────────────────────────────────────────────────────────
-    /**
-     * Issues SELECT ... FOR UPDATE on the inventory_levels row matching
-     * the given entity, variant, and warehouse within the provided transaction.
-     *
-     * MUST be called inside an active transaction (ctx.tx must be set).
-     * Calling outside a transaction provides no locking guarantee.
-     *
-     * Uses isNull() for null variantId instead of eq() to generate correct
-     * SQL (IS NULL instead of = NULL).
-     */
-    async findLevelForUpdate(entityId, variantId, warehouseId, ctx) {
-        const db = this.getDb(ctx);
-        const conditions = [
-            eq(inventoryLevels.entityId, entityId),
-            eq(inventoryLevels.warehouseId, warehouseId),
-            variantId != null
-                ? eq(inventoryLevels.variantId, variantId)
-                : isNull(inventoryLevels.variantId),
-        ];
-        // Use raw SQL for FOR UPDATE since Drizzle's .for() may not be available
-        // on all query builder paths. This is the most portable approach.
-        const rows = await db
-            .select()
-            .from(inventoryLevels)
-            .where(and(...conditions))
-            .for("update");
-        return rows[0];
-    }
-    /**
-     * Performs a read-modify-write under a row-level lock.
-     * This is the ONLY correct method for modifying quantityReserved
-     * in a concurrent environment. Must be called inside a transaction.
-     *
-     * The lock is held for the duration of the enclosing transaction,
-     * which is typically just the checkout reservation — microsecond-level.
-     */
-    async reserveWithLock(entityId, variantId, warehouseId, quantity, ctx) {
-        const level = await this.findLevelForUpdate(entityId, variantId, warehouseId, ctx);
-        if (!level) {
-            return {
-                ok: false,
-                reason: "No inventory record found for this entity.",
-            };
-        }
-        const available = level.quantityOnHand - level.quantityReserved;
-        if (available < quantity) {
-            return {
-                ok: false,
-                reason: `Insufficient stock. Available: ${available}, requested: ${quantity}.`,
-            };
-        }
-        const updated = await this.getDb(ctx)
-            .update(inventoryLevels)
-            .set({
-            quantityReserved: level.quantityReserved + quantity,
-            updatedAt: new Date(),
-            version: level.version + 1,
-        })
-            .where(eq(inventoryLevels.id, level.id))
-            .returning();
-        return { ok: true, level: updated[0] };
-    }
-    /**
-     * Performs a release under a row-level lock, mirroring reserveWithLock.
-     * Used by compensation chains to undo a reservation.
-     */
-    async releaseWithLock(entityId, variantId, warehouseId, quantity, ctx) {
-        const level = await this.findLevelForUpdate(entityId, variantId, warehouseId, ctx);
-        if (!level) {
-            return {
-                ok: false,
-                reason: "No inventory record found for this entity.",
-            };
-        }
-        const updated = await this.getDb(ctx)
-            .update(inventoryLevels)
-            .set({
-            quantityReserved: Math.max(0, level.quantityReserved - quantity),
-            updatedAt: new Date(),
-            version: level.version + 1,
-        })
-            .where(eq(inventoryLevels.id, level.id))
-            .returning();
-        return { ok: true, level: updated[0] };
-    }
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Aggregate Queries
-    // ─────────────────────────────────────────────────────────────────────────────
-    async getAvailableQuantity(entityId, variantId, ctx) {
-        const levels = await this.findLevelsByEntityAndVariant(entityId, variantId, ctx);
-        return levels.reduce((sum, level) => sum + (level.quantityOnHand - level.quantityReserved), 0);
-    }
-    async getAvailableQuantities(entityIds, ctx) {
-        if (entityIds.length === 0)
-            return {};
-        const db = this.getDb(ctx);
-        const rows = await db
-            .select()
-            .from(inventoryLevels)
-            .where(inArray(inventoryLevels.entityId, entityIds));
-        const result = {};
-        for (const id of entityIds) {
-            result[id] = 0;
-        }
-        for (const row of rows) {
-            const available = row.quantityOnHand - row.quantityReserved;
-            result[row.entityId] = (result[row.entityId] ?? 0) + available;
-        }
-        return result;
-    }
-}