@unifiedcommerce/core 0.4.4 → 0.5.0

package/dist/modules/customers/service.js

@@ -0,0 +1,106 @@
+import { resolveOrgId } from "../../auth/org.js";
+import { CommerceNotFoundError } from "../../kernel/errors.js";
+import { Err, Ok } from "../../kernel/result.js";
+export class CustomerService {
+    deps;
+    repo;
+    constructor(deps) {
+        this.deps = deps;
+        this.repo = deps.repository;
+    }
+    async getOrCreateByUserId(orgId, userId, ctx) {
+        const existing = await this.repo.findByUserId(orgId, userId, ctx);
+        if (existing) {
+            return existing;
+        }
+        const customer = await this.repo.create({
+            organizationId: orgId,
+            userId,
+            metadata: {},
+        }, ctx);
+        return customer;
+    }
+    async list(actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customers = await this.repo.findAll(orgId, ctx);
+        return Ok(customers);
+    }
+    async getById(id, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.repo.findById(orgId, id, ctx);
+        if (!customer)
+            return Err(new CommerceNotFoundError("Customer not found."));
+        return Ok(customer);
+    }
+    async getByUserId(userId, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        return Ok(customer);
+    }
+    async update(id, updates, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const existing = await this.repo.findById(orgId, id, ctx);
+        if (!existing)
+            return Err(new CommerceNotFoundError("Customer not found."));
+        const updated = await this.repo.update(id, updates, ctx);
+        if (!updated)
+            return Err(new CommerceNotFoundError("Customer not found."));
+        return Ok(updated);
+    }
+    async updateByUserId(userId, updates, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        const updated = await this.repo.update(customer.id, updates, ctx);
+        if (!updated) {
+            return Err(new CommerceNotFoundError("Customer not found."));
+        }
+        return Ok(updated);
+    }
+    async getAddresses(userId, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        const addresses = await this.repo.findAddressesByCustomerId(customer.id, ctx);
+        return Ok(addresses);
+    }
+    async addAddress(userId, input, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        // If new address is default, unset other defaults of same type
+        if (input.isDefault) {
+            const addresses = await this.repo.findAddressesByCustomerId(customer.id, ctx);
+            for (const addr of addresses) {
+                if (addr.type === input.type && addr.isDefault) {
+                    await this.repo.updateAddress(addr.id, { isDefault: false }, ctx);
+                }
+            }
+        }
+        const address = await this.repo.createAddress({
+            ...input,
+            customerId: customer.id,
+        }, ctx);
+        return Ok(address);
+    }
+    async deleteAddress(userId, addressId, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
+        const addresses = await this.repo.findAddressesByCustomerId(customer.id, ctx);
+        const addressExists = addresses.some((addr) => addr.id === addressId);
+        if (!addressExists) {
+            return Err(new CommerceNotFoundError("Address not found."));
+        }
+        await this.repo.deleteAddress(addressId, ctx);
+        return Ok(undefined);
+    }
+    async findPOSOperatorByPin(hashedPin, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const user = await this.repo.findByPosPin(orgId, hashedPin, ctx);
+        if (!user)
+            return null;
+        return {
+            id: user.userId,
+            name: [user.firstName, user.lastName].filter(Boolean).join(" ") ||
+                user.email ||
+                "POS Operator",
+        };
+    }
+}

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

@@ -0,0 +1,63 @@
+import type { TxContext } from "../../../kernel/database/tx-context.js";
+import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db.js";
+import { fulfillmentRecords, fulfillmentLineItems, fulfillmentEvents } from "../schema.js";
+export type FulfillmentRecord = typeof fulfillmentRecords.$inferSelect;
+export type FulfillmentRecordInsert = typeof fulfillmentRecords.$inferInsert;
+export type FulfillmentLineItem = typeof fulfillmentLineItems.$inferSelect;
+export type FulfillmentLineItemInsert = typeof fulfillmentLineItems.$inferInsert;
+export type FulfillmentEvent = typeof fulfillmentEvents.$inferSelect;
+export type FulfillmentEventInsert = typeof fulfillmentEvents.$inferInsert;
+/**
+ * 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 declare class FulfillmentRepository {
+    private readonly db;
+    constructor(db: DrizzleDatabase);
+    private getDb;
+    findById(id: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    findByOrderId(orderId: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByCustomerId(customerId: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByStatus(status: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByType(type: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findByOrderIdAndStatus(orderId: string, status: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findActiveAccessGrants(customerId: string, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    findAll(options?: {
+        limit?: number;
+        offset?: number;
+    }, ctx?: TxContext): Promise<FulfillmentRecord[]>;
+    create(data: FulfillmentRecordInsert, ctx?: TxContext): Promise<FulfillmentRecord>;
+    update(id: string, data: Partial<Omit<FulfillmentRecordInsert, "id">>, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    updateStatus(id: string, status: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    delete(id: string, ctx?: TxContext): Promise<boolean>;
+    incrementDownloadCount(id: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    isDownloadAllowed(id: string, ctx?: TxContext): Promise<boolean>;
+    deactivateAccessGrant(id: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    activateAccessGrant(id: string, ctx?: TxContext): Promise<FulfillmentRecord | undefined>;
+    isAccessGrantActive(id: string, ctx?: TxContext): Promise<boolean>;
+    findLineItemsByFulfillmentId(fulfillmentId: string, ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    findLineItemsByOrderLineItemId(orderLineItemId: string, ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    createLineItem(data: FulfillmentLineItemInsert, ctx?: TxContext): Promise<FulfillmentLineItem>;
+    createLineItems(data: FulfillmentLineItemInsert[], ctx?: TxContext): Promise<FulfillmentLineItem[]>;
+    deleteLineItemsByFulfillmentId(fulfillmentId: string, ctx?: TxContext): Promise<void>;
+    findEventsByFulfillmentId(fulfillmentId: string, ctx?: TxContext): Promise<FulfillmentEvent[]>;
+    createEvent(data: FulfillmentEventInsert, ctx?: TxContext): Promise<FulfillmentEvent>;
+    recordStatusChange(fulfillmentId: string, fromStatus: string, toStatus: string, actorId?: string, description?: string, ctx?: TxContext): Promise<FulfillmentEvent>;
+    findWithLineItems(id: string, ctx?: TxContext): Promise<{
+        fulfillment: FulfillmentRecord;
+        lineItems: FulfillmentLineItem[];
+    } | undefined>;
+    findWithEvents(id: string, ctx?: TxContext): Promise<{
+        fulfillment: FulfillmentRecord;
+        events: FulfillmentEvent[];
+    } | undefined>;
+    /**
+     * Get fulfilled quantity for an order line item.
+     * Sums all fulfillment line items linked to the order line item.
+     */
+    getFulfilledQuantity(orderLineItemId: string, ctx?: TxContext): Promise<number>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/fulfillment/repository/index.ts"],"names":[],"mappings":"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"}

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.js";
+/**
+ * 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;
+    }
+}