@unifiedcommerce/plugin-marketplace 0.0.1

package/dist/services/sub-order.d.ts

@@ -0,0 +1,336 @@
+import type { Db, SubOrderStatus } from "../types";
+export interface SubOrderCancelCallback {
+    (subOrder: {
+        id: string;
+        orderId: string;
+        vendorId: string;
+        payoutAmount: number;
+        lineItems: unknown;
+    }): Promise<void>;
+}
+export declare class SubOrderService {
+    private db;
+    private onCancel?;
+    constructor(db: Db, onCancel?: SubOrderCancelCallback);
+    getById(id: string): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    listByOrder(orderId: string): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[]>;
+    listByVendor(vendorId: string, filters?: {
+        status?: string;
+    }): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[]>;
+    list(filters?: {
+        orderId?: string;
+        vendorId?: string;
+        status?: string;
+    }): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[]>;
+    private assertTransition;
+    confirm(id: string): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | undefined>;
+    process(id: string): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | undefined>;
+    ship(id: string, data: {
+        trackingNumber: string;
+        carrier: string;
+    }): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | undefined>;
+    deliver(id: string): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | undefined>;
+    cancel(id: string, reason?: string): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | undefined>;
+    forceStatus(id: string, status: SubOrderStatus): Promise<{
+        id: string;
+        orderId: string;
+        vendorId: string;
+        status: string;
+        subtotal: number;
+        commissionAmount: number;
+        payoutAmount: number;
+        notified: boolean;
+        lineItems: {
+            entityId: string;
+            quantity: number;
+            totalPrice: number;
+        }[] | null;
+        trackingNumber: string | null;
+        trackingUrl: string | null;
+        carrier: string | null;
+        fulfillmentStatus: string;
+        confirmedAt: Date | null;
+        shippedAt: Date | null;
+        deliveredAt: Date | null;
+        cancelledAt: Date | null;
+        cancellationReason: string | null;
+        vendorNotes: string | null;
+        externalOrderId: string | null;
+        externalOrderUrl: string | null;
+        externalSyncStatus: string | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+}
+//# sourceMappingURL=sub-order.d.ts.map

package/dist/services/sub-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-order.d.ts","sourceRoot":"","sources":["../../src/services/sub-order.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGnD,MAAM,WAAW,sBAAsB;IACrC,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxH;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,EAAE;IAFtB,OAAO,CAAC,QAAQ,CAAC,CAAqC;gBAElC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,sBAAsB;IAIvD,OAAO,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKlB,WAAW,CAAC,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAM3B,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAS5D,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAY7E,OAAO,CAAC,gBAAgB;IAOlB,OAAO,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAalB,OAAO,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYlB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAelE,OAAO,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAalB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoBlC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOrD"}

package/dist/services/sub-order.js

@@ -0,0 +1,121 @@
+import { eq, and, desc } from "drizzle-orm";
+import { vendorSubOrders } from "../schema";
+import { SUB_ORDER_TRANSITIONS } from "../types";
+export class SubOrderService {
+    db;
+    onCancel;
+    constructor(db, onCancel) {
+        this.db = db;
+        this.onCancel = onCancel;
+    }
+    async getById(id) {
+        const [sub] = await this.db.select().from(vendorSubOrders).where(eq(vendorSubOrders.id, id));
+        return sub ?? null;
+    }
+    async listByOrder(orderId) {
+        return this.db.select().from(vendorSubOrders)
+            .where(eq(vendorSubOrders.orderId, orderId))
+            .orderBy(desc(vendorSubOrders.createdAt));
+    }
+    async listByVendor(vendorId, filters) {
+        const conditions = [eq(vendorSubOrders.vendorId, vendorId)];
+        if (filters?.status)
+            conditions.push(eq(vendorSubOrders.status, filters.status));
+        return this.db.select().from(vendorSubOrders)
+            .where(conditions.length === 1 ? conditions[0] : and(...conditions))
+            .orderBy(desc(vendorSubOrders.createdAt));
+    }
+    async list(filters) {
+        let query = this.db.select().from(vendorSubOrders).$dynamic();
+        const conditions = [];
+        if (filters?.orderId)
+            conditions.push(eq(vendorSubOrders.orderId, filters.orderId));
+        if (filters?.vendorId)
+            conditions.push(eq(vendorSubOrders.vendorId, filters.vendorId));
+        if (filters?.status)
+            conditions.push(eq(vendorSubOrders.status, filters.status));
+        if (conditions.length > 0) {
+            query = query.where(conditions.length === 1 ? conditions[0] : and(...conditions));
+        }
+        return query.orderBy(desc(vendorSubOrders.createdAt));
+    }
+    assertTransition(current, next) {
+        const allowed = SUB_ORDER_TRANSITIONS[current];
+        if (!allowed?.includes(next)) {
+            throw new Error(`Cannot transition sub-order from "${current}" to "${next}".`);
+        }
+    }
+    async confirm(id) {
+        const sub = await this.getById(id);
+        if (!sub)
+            throw new Error("Sub-order not found.");
+        this.assertTransition(sub.status, "confirmed");
+        const [updated] = await this.db.update(vendorSubOrders).set({
+            status: "confirmed",
+            confirmedAt: new Date(),
+            updatedAt: new Date(),
+        }).where(eq(vendorSubOrders.id, id)).returning();
+        return updated;
+    }
+    async process(id) {
+        const sub = await this.getById(id);
+        if (!sub)
+            throw new Error("Sub-order not found.");
+        this.assertTransition(sub.status, "processing");
+        const [updated] = await this.db.update(vendorSubOrders).set({
+            status: "processing",
+            updatedAt: new Date(),
+        }).where(eq(vendorSubOrders.id, id)).returning();
+        return updated;
+    }
+    async ship(id, data) {
+        const sub = await this.getById(id);
+        if (!sub)
+            throw new Error("Sub-order not found.");
+        this.assertTransition(sub.status, "shipped");
+        const [updated] = await this.db.update(vendorSubOrders).set({
+            status: "shipped",
+            trackingNumber: data.trackingNumber,
+            carrier: data.carrier,
+            shippedAt: new Date(),
+            updatedAt: new Date(),
+        }).where(eq(vendorSubOrders.id, id)).returning();
+        return updated;
+    }
+    async deliver(id) {
+        const sub = await this.getById(id);
+        if (!sub)
+            throw new Error("Sub-order not found.");
+        this.assertTransition(sub.status, "delivered");
+        const [updated] = await this.db.update(vendorSubOrders).set({
+            status: "delivered",
+            deliveredAt: new Date(),
+            updatedAt: new Date(),
+        }).where(eq(vendorSubOrders.id, id)).returning();
+        return updated;
+    }
+    async cancel(id, reason) {
+        const sub = await this.getById(id);
+        if (!sub)
+            throw new Error("Sub-order not found.");
+        this.assertTransition(sub.status, "cancelled");
+        const [updated] = await this.db.update(vendorSubOrders).set({
+            status: "cancelled",
+            cancelledAt: new Date(),
+            cancellationReason: reason,
+            updatedAt: new Date(),
+        }).where(eq(vendorSubOrders.id, id)).returning();
+        // Trigger side effects: release inventory + reverse ledger
+        if (this.onCancel && sub) {
+            await this.onCancel(sub);
+        }
+        return updated;
+    }
+    async forceStatus(id, status) {
+        const [updated] = await this.db.update(vendorSubOrders).set({
+            status,
+            updatedAt: new Date(),
+        }).where(eq(vendorSubOrders.id, id)).returning();
+        return updated ?? null;
+    }
+}