@unifiedcommerce/core 0.0.1

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

@@ -0,0 +1,268 @@
+import { eq, desc, and, sql } from "drizzle-orm";
+import { fulfillmentRecords, fulfillmentLineItems, fulfillmentEvents, } from "../schema";
+/**
+ * FulfillmentRepository provides type-safe database operations for fulfillments.
+ *
+ * This repository manages fulfillment records, line item associations, and events.
+ * Supports physical shipments, digital deliveries, and access grants.
+ * All methods support an optional TxContext parameter for transaction participation.
+ */
+export class FulfillmentRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getDb(ctx) {
+        return ctx?.tx ?? this.db;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Fulfillment Records
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findById(id, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .select()
+            .from(fulfillmentRecords)
+            .where(eq(fulfillmentRecords.id, id));
+        return rows[0];
+    }
+    async findByOrderId(orderId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentRecords)
+            .where(eq(fulfillmentRecords.orderId, orderId))
+            .orderBy(desc(fulfillmentRecords.createdAt));
+    }
+    async findByCustomerId(customerId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentRecords)
+            .where(eq(fulfillmentRecords.customerId, customerId))
+            .orderBy(desc(fulfillmentRecords.createdAt));
+    }
+    async findByStatus(status, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentRecords)
+            .where(eq(fulfillmentRecords.status, status))
+            .orderBy(desc(fulfillmentRecords.createdAt));
+    }
+    async findByType(type, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentRecords)
+            .where(eq(fulfillmentRecords.type, type))
+            .orderBy(desc(fulfillmentRecords.createdAt));
+    }
+    async findByOrderIdAndStatus(orderId, status, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentRecords)
+            .where(and(eq(fulfillmentRecords.orderId, orderId), eq(fulfillmentRecords.status, status)))
+            .orderBy(desc(fulfillmentRecords.createdAt));
+    }
+    async findActiveAccessGrants(customerId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentRecords)
+            .where(and(eq(fulfillmentRecords.customerId, customerId), eq(fulfillmentRecords.type, "access_grant"), eq(fulfillmentRecords.isActive, true)))
+            .orderBy(desc(fulfillmentRecords.grantedAt));
+    }
+    async findAll(options, ctx) {
+        const db = this.getDb(ctx);
+        let query = db
+            .select()
+            .from(fulfillmentRecords)
+            .orderBy(desc(fulfillmentRecords.createdAt))
+            .$dynamic();
+        if (options?.limit !== undefined) {
+            query = query.limit(options.limit);
+        }
+        if (options?.offset !== undefined) {
+            query = query.offset(options.offset);
+        }
+        return query;
+    }
+    async create(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(fulfillmentRecords).values(data).returning();
+        return rows[0];
+    }
+    async update(id, data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .update(fulfillmentRecords)
+            .set({ ...data, updatedAt: new Date() })
+            .where(eq(fulfillmentRecords.id, id))
+            .returning();
+        return rows[0];
+    }
+    async updateStatus(id, status, ctx) {
+        const data = { status };
+        // Set timestamps based on status
+        if (status === "shipped") {
+            data.shippedAt = new Date();
+        }
+        else if (status === "delivered") {
+            data.deliveredAt = new Date();
+        }
+        return this.update(id, data, ctx);
+    }
+    async delete(id, ctx) {
+        const db = this.getDb(ctx);
+        const result = await db
+            .delete(fulfillmentRecords)
+            .where(eq(fulfillmentRecords.id, id))
+            .returning();
+        return result.length > 0;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Digital Delivery Operations
+    // ─────────────────────────────────────────────────────────────────────────────
+    async incrementDownloadCount(id, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .update(fulfillmentRecords)
+            .set({
+            downloadCount: sql `${fulfillmentRecords.downloadCount} + 1`,
+            updatedAt: new Date(),
+        })
+            .where(eq(fulfillmentRecords.id, id))
+            .returning();
+        return rows[0];
+    }
+    async isDownloadAllowed(id, ctx) {
+        const fulfillment = await this.findById(id, ctx);
+        if (!fulfillment || fulfillment.type !== "digital")
+            return false;
+        // Check expiration
+        if (fulfillment.downloadExpiresAt &&
+            new Date() > fulfillment.downloadExpiresAt) {
+            return false;
+        }
+        // Check download limit
+        if (fulfillment.maxDownloads !== null &&
+            fulfillment.downloadCount >= fulfillment.maxDownloads) {
+            return false;
+        }
+        return true;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Access Grant Operations
+    // ─────────────────────────────────────────────────────────────────────────────
+    async deactivateAccessGrant(id, ctx) {
+        return this.update(id, { isActive: false }, ctx);
+    }
+    async activateAccessGrant(id, ctx) {
+        return this.update(id, { isActive: true, grantedAt: new Date() }, ctx);
+    }
+    async isAccessGrantActive(id, ctx) {
+        const fulfillment = await this.findById(id, ctx);
+        if (!fulfillment || fulfillment.type !== "access_grant")
+            return false;
+        if (!fulfillment.isActive)
+            return false;
+        // Check expiration
+        if (fulfillment.expiresAt && new Date() > fulfillment.expiresAt) {
+            return false;
+        }
+        return true;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Fulfillment Line Items
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findLineItemsByFulfillmentId(fulfillmentId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentLineItems)
+            .where(eq(fulfillmentLineItems.fulfillmentId, fulfillmentId));
+    }
+    async findLineItemsByOrderLineItemId(orderLineItemId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentLineItems)
+            .where(eq(fulfillmentLineItems.orderLineItemId, orderLineItemId));
+    }
+    async createLineItem(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(fulfillmentLineItems).values(data).returning();
+        return rows[0];
+    }
+    async createLineItems(data, ctx) {
+        if (data.length === 0)
+            return [];
+        const db = this.getDb(ctx);
+        return db.insert(fulfillmentLineItems).values(data).returning();
+    }
+    async deleteLineItemsByFulfillmentId(fulfillmentId, ctx) {
+        const db = this.getDb(ctx);
+        await db
+            .delete(fulfillmentLineItems)
+            .where(eq(fulfillmentLineItems.fulfillmentId, fulfillmentId));
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Fulfillment Events
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findEventsByFulfillmentId(fulfillmentId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(fulfillmentEvents)
+            .where(eq(fulfillmentEvents.fulfillmentId, fulfillmentId))
+            .orderBy(desc(fulfillmentEvents.occurredAt));
+    }
+    async createEvent(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(fulfillmentEvents).values(data).returning();
+        return rows[0];
+    }
+    async recordStatusChange(fulfillmentId, fromStatus, toStatus, actorId, description, ctx) {
+        return this.createEvent({
+            fulfillmentId,
+            eventType: "status_change",
+            fromStatus,
+            toStatus,
+            actorId,
+            description,
+        }, ctx);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Aggregate Operations
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findWithLineItems(id, ctx) {
+        const fulfillment = await this.findById(id, ctx);
+        if (!fulfillment)
+            return undefined;
+        const lineItems = await this.findLineItemsByFulfillmentId(id, ctx);
+        return { fulfillment, lineItems };
+    }
+    async findWithEvents(id, ctx) {
+        const fulfillment = await this.findById(id, ctx);
+        if (!fulfillment)
+            return undefined;
+        const events = await this.findEventsByFulfillmentId(id, ctx);
+        return { fulfillment, events };
+    }
+    /**
+     * Get fulfilled quantity for an order line item.
+     * Sums all fulfillment line items linked to the order line item.
+     */
+    async getFulfilledQuantity(orderLineItemId, ctx) {
+        const db = this.getDb(ctx);
+        const result = await db
+            .select({
+            total: sql `COALESCE(SUM(${fulfillmentLineItems.quantity}), 0)::int`,
+        })
+            .from(fulfillmentLineItems)
+            .where(eq(fulfillmentLineItems.orderLineItemId, orderLineItemId));
+        return result[0]?.total ?? 0;
+    }
+}