@unifiedcommerce/core 0.0.1

package/dist/modules/inventory/repository/in-memory.js

@@ -0,0 +1,281 @@
+function makeId() {
+    return crypto.randomUUID();
+}
+/**
+ * In-memory implementation of InventoryRepository for testing.
+ * Provides the same interface as the Drizzle-based repository but stores data in memory.
+ */
+export class InMemoryInventoryRepository {
+    warehouses = new Map();
+    levels = new Map();
+    movements = [];
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Warehouses
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findWarehouseById(id, _ctx) {
+        return this.warehouses.get(id);
+    }
+    async findWarehouseByCode(code, _ctx) {
+        return [...this.warehouses.values()].find((w) => w.code === code);
+    }
+    async findAllWarehouses(_ctx) {
+        return [...this.warehouses.values()];
+    }
+    async findActiveWarehouses(_ctx) {
+        return [...this.warehouses.values()].filter((w) => w.isActive);
+    }
+    async createWarehouse(data, _ctx) {
+        // Enforce unique code constraint (mirrors the DB unique index)
+        const duplicate = [...this.warehouses.values()].find((w) => w.code === data.code);
+        if (duplicate) {
+            throw new Error(`Warehouse with code "${data.code}" already exists.`);
+        }
+        const warehouse = {
+            id: data.id ?? makeId(),
+            name: data.name,
+            code: data.code,
+            address: data.address ?? null,
+            isActive: data.isActive ?? true,
+            priority: data.priority ?? 0,
+            metadata: data.metadata ?? null,
+        };
+        this.warehouses.set(warehouse.id, warehouse);
+        return warehouse;
+    }
+    async updateWarehouse(id, data, _ctx) {
+        const existing = this.warehouses.get(id);
+        if (!existing)
+            return undefined;
+        if (data.code != null && data.code !== existing.code) {
+            const duplicate = [...this.warehouses.values()].find((w) => w.id !== id && w.code === data.code);
+            if (duplicate) {
+                throw new Error(`Warehouse with code "${data.code}" already exists.`);
+            }
+        }
+        const updated = {
+            id: existing.id,
+            name: data.name ?? existing.name,
+            code: data.code ?? existing.code,
+            address: data.address !== undefined ? (data.address ?? null) : existing.address,
+            isActive: data.isActive ?? existing.isActive,
+            priority: data.priority ?? existing.priority,
+            metadata: data.metadata !== undefined
+                ? (data.metadata ?? null)
+                : existing.metadata,
+        };
+        this.warehouses.set(id, updated);
+        return updated;
+    }
+    async deleteWarehouse(id, _ctx) {
+        return this.warehouses.delete(id);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Inventory Levels
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findAllLevels(_ctx) {
+        return [...this.levels.values()];
+    }
+    async findLevelById(id, _ctx) {
+        return this.levels.get(id);
+    }
+    async findLevelByKey(entityId, warehouseId, variantId, _ctx) {
+        return [...this.levels.values()].find((level) => level.entityId === entityId &&
+            level.warehouseId === warehouseId &&
+            level.variantId === (variantId ?? null));
+    }
+    async findLevelsByEntityId(entityId, _ctx) {
+        return [...this.levels.values()].filter((level) => level.entityId === entityId);
+    }
+    async findLevelsByEntityAndVariant(entityId, variantId, _ctx) {
+        return [...this.levels.values()].filter((level) => level.entityId === entityId && level.variantId === (variantId ?? null));
+    }
+    async findLevelsByWarehouseId(warehouseId, _ctx) {
+        return [...this.levels.values()].filter((level) => level.warehouseId === warehouseId);
+    }
+    async createLevel(data, _ctx) {
+        const now = new Date();
+        const level = {
+            id: data.id ?? makeId(),
+            entityId: data.entityId,
+            warehouseId: data.warehouseId,
+            variantId: data.variantId ?? null,
+            quantityOnHand: data.quantityOnHand ?? 0,
+            quantityReserved: data.quantityReserved ?? 0,
+            quantityIncoming: data.quantityIncoming ?? 0,
+            unitCost: data.unitCost ?? null,
+            reorderThreshold: data.reorderThreshold ?? null,
+            reorderQuantity: data.reorderQuantity ?? null,
+            version: data.version ?? 0,
+            lastRestockedAt: data.lastRestockedAt ?? null,
+            updatedAt: data.updatedAt ?? now,
+        };
+        this.levels.set(level.id, level);
+        return level;
+    }
+    async updateLevel(id, data, _ctx) {
+        const existing = this.levels.get(id);
+        if (!existing)
+            return undefined;
+        const updated = {
+            id: existing.id,
+            entityId: existing.entityId,
+            warehouseId: existing.warehouseId,
+            variantId: existing.variantId,
+            quantityOnHand: data.quantityOnHand ?? existing.quantityOnHand,
+            quantityReserved: data.quantityReserved ?? existing.quantityReserved,
+            quantityIncoming: data.quantityIncoming ?? existing.quantityIncoming,
+            unitCost: data.unitCost !== undefined
+                ? (data.unitCost ?? null)
+                : existing.unitCost,
+            reorderThreshold: data.reorderThreshold !== undefined
+                ? (data.reorderThreshold ?? null)
+                : existing.reorderThreshold,
+            reorderQuantity: data.reorderQuantity !== undefined
+                ? (data.reorderQuantity ?? null)
+                : existing.reorderQuantity,
+            version: data.version ?? existing.version,
+            lastRestockedAt: data.lastRestockedAt !== undefined
+                ? (data.lastRestockedAt ?? null)
+                : existing.lastRestockedAt,
+            updatedAt: new Date(),
+        };
+        this.levels.set(id, updated);
+        return updated;
+    }
+    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) {
+        return this.levels.delete(id);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Inventory Movements
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findMovementById(id, _ctx) {
+        return this.movements.find((m) => m.id === id);
+    }
+    async findMovementsByEntityId(entityId, _ctx) {
+        return this.movements.filter((m) => m.entityId === entityId);
+    }
+    async findMovementsByReference(referenceType, referenceId, _ctx) {
+        return this.movements.filter((m) => m.referenceType === referenceType && m.referenceId === referenceId);
+    }
+    async createMovement(data, _ctx) {
+        const movement = {
+            id: data.id ?? makeId(),
+            entityId: data.entityId,
+            warehouseId: data.warehouseId,
+            variantId: data.variantId ?? null,
+            type: data.type,
+            quantity: data.quantity,
+            reason: data.reason ?? null,
+            performedBy: data.performedBy,
+            performedAt: data.performedAt ?? new Date(),
+            referenceType: data.referenceType ?? null,
+            referenceId: data.referenceId ?? null,
+        };
+        this.movements.push(movement);
+        return movement;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Concurrency-Safe Operations (in-memory equivalent)
+    // In-memory repos don't need real locking, but we mirror the interface.
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findLevelForUpdate(entityId, variantId, warehouseId, _ctx) {
+        // In-memory has no concurrent access, so this is just a lookup
+        return [...this.levels.values()].find((level) => level.entityId === entityId &&
+            level.warehouseId === warehouseId &&
+            level.variantId === (variantId ?? null));
+    }
+    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 = {
+            ...level,
+            quantityReserved: level.quantityReserved + quantity,
+            version: level.version + 1,
+            updatedAt: new Date(),
+        };
+        this.levels.set(level.id, updated);
+        return { ok: true, level: updated };
+    }
+    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 = {
+            ...level,
+            quantityReserved: Math.max(0, level.quantityReserved - quantity),
+            version: level.version + 1,
+            updatedAt: new Date(),
+        };
+        this.levels.set(level.id, updated);
+        return { ok: true, level: updated };
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // 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 result = {};
+        for (const id of entityIds) {
+            result[id] = 0;
+        }
+        for (const level of this.levels.values()) {
+            if (entityIds.includes(level.entityId)) {
+                const available = level.quantityOnHand - level.quantityReserved;
+                result[level.entityId] = (result[level.entityId] ?? 0) + available;
+            }
+        }
+        return result;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Helper: Get or create default warehouse
+    // ─────────────────────────────────────────────────────────────────────────────
+    async getOrCreateDefaultWarehouse(_ctx) {
+        // Find by priority (lowest first)
+        const sorted = [...this.warehouses.values()].sort((a, b) => a.priority - b.priority);
+        if (sorted.length > 0) {
+            return sorted[0];
+        }
+        // Create default warehouse
+        return this.createWarehouse({
+            name: "Default Warehouse",
+            code: "DEFAULT",
+            isActive: true,
+            priority: 0,
+            metadata: {},
+        }, _ctx);
+    }
+}

package/dist/modules/inventory/repository/index.d.ts

@@ -0,0 +1,81 @@
+import type { TxContext } from "../../../kernel/database/tx-context";
+import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db";
+import { warehouses, inventoryLevels, inventoryMovements } from "../schema";
+export type Warehouse = typeof warehouses.$inferSelect;
+export type WarehouseInsert = typeof warehouses.$inferInsert;
+export type InventoryLevel = typeof inventoryLevels.$inferSelect;
+export type InventoryLevelInsert = typeof inventoryLevels.$inferInsert;
+export type InventoryMovement = typeof inventoryMovements.$inferSelect;
+export type InventoryMovementInsert = typeof inventoryMovements.$inferInsert;
+/**
+ * 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 declare class InventoryRepository {
+    private readonly db;
+    constructor(db: DrizzleDatabase);
+    private getDb;
+    findWarehouseById(id: string, ctx?: TxContext): Promise<Warehouse | undefined>;
+    findWarehouseByCode(orgId: string, code: string, ctx?: TxContext): Promise<Warehouse | undefined>;
+    findAllWarehouses(orgId: string, ctx?: TxContext): Promise<Warehouse[]>;
+    findActiveWarehouses(orgId: string, ctx?: TxContext): Promise<Warehouse[]>;
+    createWarehouse(data: WarehouseInsert, ctx?: TxContext): Promise<Warehouse>;
+    updateWarehouse(id: string, data: Partial<Omit<WarehouseInsert, "id">>, ctx?: TxContext): Promise<Warehouse | undefined>;
+    deleteWarehouse(id: string, ctx?: TxContext): Promise<boolean>;
+    findAllLevels(ctx?: TxContext): Promise<InventoryLevel[]>;
+    findLevelById(id: string, ctx?: TxContext): Promise<InventoryLevel | undefined>;
+    findLevelByKey(entityId: string, warehouseId: string, variantId?: string | null, ctx?: TxContext): Promise<InventoryLevel | undefined>;
+    findLevelsByEntityId(entityId: string, ctx?: TxContext): Promise<InventoryLevel[]>;
+    findLevelsByEntityAndVariant(entityId: string, variantId?: string | null, ctx?: TxContext): Promise<InventoryLevel[]>;
+    findLevelsByWarehouseId(warehouseId: string, ctx?: TxContext): Promise<InventoryLevel[]>;
+    createLevel(data: InventoryLevelInsert, ctx?: TxContext): Promise<InventoryLevel>;
+    updateLevel(id: string, data: Partial<Omit<InventoryLevelInsert, "id">>, ctx?: TxContext): Promise<InventoryLevel | undefined>;
+    upsertLevel(entityId: string, warehouseId: string, variantId: string | undefined, data: Omit<InventoryLevelInsert, "id" | "entityId" | "warehouseId" | "variantId">, ctx?: TxContext): Promise<InventoryLevel>;
+    deleteLevel(id: string, ctx?: TxContext): Promise<boolean>;
+    findMovementById(id: string, ctx?: TxContext): Promise<InventoryMovement | undefined>;
+    findMovementsByEntityId(entityId: string, ctx?: TxContext): Promise<InventoryMovement[]>;
+    findMovementsByReference(referenceType: string, referenceId: string, ctx?: TxContext): Promise<InventoryMovement[]>;
+    createMovement(data: InventoryMovementInsert, ctx?: TxContext): Promise<InventoryMovement>;
+    /**
+     * 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).
+     */
+    findLevelForUpdate(entityId: string, variantId: string | null, warehouseId: string, ctx: TxContext): Promise<InventoryLevel | undefined>;
+    /**
+     * 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.
+     */
+    reserveWithLock(entityId: string, variantId: string | null, warehouseId: string, quantity: number, ctx: TxContext): Promise<{
+        ok: true;
+        level: InventoryLevel;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    /**
+     * Performs a release under a row-level lock, mirroring reserveWithLock.
+     * Used by compensation chains to undo a reservation.
+     */
+    releaseWithLock(entityId: string, variantId: string | null, warehouseId: string, quantity: number, ctx: TxContext): Promise<{
+        ok: true;
+        level: InventoryLevel;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    getAvailableQuantity(entityId: string, variantId?: string | null, ctx?: TxContext): Promise<number>;
+    getAvailableQuantities(entityIds: string[], ctx?: TxContext): Promise<Record<string, number>>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/inventory/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/inventory/repository/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG5E,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC;AAC7D,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC;AACjE,MAAM,MAAM,oBAAoB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,CAAC,YAAY,CAAC;AACvE,MAAM,MAAM,uBAAuB,GAAG,OAAO,kBAAkB,CAAC,YAAY,CAAC;AAE7E;;;;;GAKG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,eAAe;IAEhD,OAAO,CAAC,KAAK;IAQP,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAS3B,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAc3B,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,SAAS,EAAE,CAAC;IAQjB,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,SAAS,EAAE,CAAC;IAajB,eAAe,CACnB,IAAI,EAAE,eAAe,EACrB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,SAAS,CAAC;IAMf,eAAe,CACnB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,EAC1C,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAU3B,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9D,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAKzD,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAShC,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAqBhC,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,EAAE,CAAC;IAQtB,4BAA4B,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,EAAE,CAAC;IAoBtB,uBAAuB,CAC3B,WAAW,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,EAAE,CAAC;IAQtB,WAAW,CACf,IAAI,EAAE,oBAAoB,EAC1B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,CAAC;IAMpB,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC,EAC/C,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAUhC,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,IAAI,CACR,oBAAoB,EACpB,IAAI,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,CAChD,EACD,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,cAAc,CAAC;IAsBpB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1D,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IASnC,uBAAuB,CAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAQzB,wBAAwB,CAC5B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAazB,cAAc,CAClB,IAAI,EAAE,uBAAuB,EAC7B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,iBAAiB,CAAC;IAU7B;;;;;;;;;OASG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,SAAS,GACb,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAsBtC;;;;;;;OAOG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,SAAS,GACb,OAAO,CACR;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CACpE;IAoCD;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,SAAS,GACb,OAAO,CACR;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CACpE;IAgCK,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;IAYZ,sBAAsB,CAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAqBnC"}

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

@@ -0,0 +1,310 @@
+import { eq, and, inArray, isNull } from "drizzle-orm";
+import { warehouses, inventoryLevels, inventoryMovements } from "../schema";
+/**
+ * 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;
+    }
+}