@unifiedcommerce/plugin-marketplace 0.0.1

package/src/services/sub-order.ts

@@ -0,0 +1,136 @@
+import { eq, and, desc } from "drizzle-orm";
+import { vendorSubOrders } from "../schema";
+import type { Db, SubOrderStatus } from "../types";
+import { SUB_ORDER_TRANSITIONS } from "../types";
+
+export interface SubOrderCancelCallback {
+  (subOrder: { id: string; orderId: string; vendorId: string; payoutAmount: number; lineItems: unknown }): Promise<void>;
+}
+
+export class SubOrderService {
+  private onCancel?: SubOrderCancelCallback | undefined;
+
+  constructor(private db: Db, onCancel?: SubOrderCancelCallback) {
+    this.onCancel = onCancel;
+  }
+
+  async getById(id: string) {
+    const [sub] = await this.db.select().from(vendorSubOrders).where(eq(vendorSubOrders.id, id));
+    return sub ?? null;
+  }
+
+  async listByOrder(orderId: string) {
+    return this.db.select().from(vendorSubOrders)
+      .where(eq(vendorSubOrders.orderId, orderId))
+      .orderBy(desc(vendorSubOrders.createdAt));
+  }
+
+  async listByVendor(vendorId: string, filters?: { status?: string }) {
+    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?: { orderId?: string; vendorId?: string; status?: string }) {
+    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));
+  }
+
+  private assertTransition(current: SubOrderStatus, next: SubOrderStatus) {
+    const allowed = SUB_ORDER_TRANSITIONS[current];
+    if (!allowed?.includes(next)) {
+      throw new Error(`Cannot transition sub-order from "${current}" to "${next}".`);
+    }
+  }
+
+  async confirm(id: string) {
+    const sub = await this.getById(id);
+    if (!sub) throw new Error("Sub-order not found.");
+    this.assertTransition(sub.status as SubOrderStatus, "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: string) {
+    const sub = await this.getById(id);
+    if (!sub) throw new Error("Sub-order not found.");
+    this.assertTransition(sub.status as SubOrderStatus, "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: string, data: { trackingNumber: string; carrier: string }) {
+    const sub = await this.getById(id);
+    if (!sub) throw new Error("Sub-order not found.");
+    this.assertTransition(sub.status as SubOrderStatus, "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: string) {
+    const sub = await this.getById(id);
+    if (!sub) throw new Error("Sub-order not found.");
+    this.assertTransition(sub.status as SubOrderStatus, "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: string, reason?: string) {
+    const sub = await this.getById(id);
+    if (!sub) throw new Error("Sub-order not found.");
+    this.assertTransition(sub.status as SubOrderStatus, "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: string, status: SubOrderStatus) {
+    const [updated] = await this.db.update(vendorSubOrders).set({
+      status,
+      updatedAt: new Date(),
+    }).where(eq(vendorSubOrders.id, id)).returning();
+    return updated ?? null;
+  }
+}

package/src/services/vendor.ts

@@ -0,0 +1,151 @@
+import { eq, and, or, ilike, desc } from "drizzle-orm";
+import { vendors, vendorDocuments } from "../schema";
+import type { Db, VendorStatus, VerificationStatus, DocumentStatus } from "../types";
+
+export class VendorService {
+  constructor(private db: Db) {}
+
+  async create(orgId: string, data: {
+    name: string;
+    slug?: string;
+    email?: string;
+    description?: string;
+    commissionRateBps?: number;
+    metadata?: Record<string, unknown>;
+  }) {
+    const [vendor] = await this.db.insert(vendors).values({
+      organizationId: orgId,
+      name: data.name,
+      slug: data.slug ?? data.name.toLowerCase().replace(/[^a-z0-9]+/g, "-"),
+      email: data.email,
+      description: data.description,
+      commissionRateBps: data.commissionRateBps,
+      metadata: data.metadata ?? {},
+    }).returning();
+    return vendor;
+  }
+
+  async getById(id: string) {
+    const [vendor] = await this.db.select().from(vendors).where(eq(vendors.id, id));
+    return vendor ?? null;
+  }
+
+  async getBySlug(slug: string) {
+    const [vendor] = await this.db.select().from(vendors).where(eq(vendors.slug, slug));
+    return vendor ?? null;
+  }
+
+  async list(filters?: { status?: string; tier?: string; search?: string }) {
+    let query = this.db.select().from(vendors).$dynamic();
+    const conditions = [];
+
+    if (filters?.status) conditions.push(eq(vendors.status, filters.status));
+    if (filters?.tier) conditions.push(eq(vendors.tier, filters.tier));
+    if (filters?.search) {
+      conditions.push(
+        or(ilike(vendors.name, `%${filters.search}%`), ilike(vendors.email, `%${filters.search}%`)),
+      );
+    }
+
+    if (conditions.length > 0) {
+      query = query.where(conditions.length === 1 ? conditions[0]! : and(...conditions));
+    }
+
+    return query.orderBy(desc(vendors.createdAt));
+  }
+
+  async update(id: string, data: Partial<{
+    name: string; slug: string; email: string; description: string;
+    logoUrl: string; bannerUrl: string; contactPhone: string;
+    businessAddress: Record<string, unknown>; bankAccount: Record<string, unknown>;
+    taxId: string; commissionRateBps: number; payoutSchedule: string;
+    payoutMinimumCents: number; holdbackDays: number; metadata: Record<string, unknown>;
+    approvedCategories: string[] | null; tier: string;
+  }>) {
+    const [updated] = await this.db.update(vendors).set({
+      ...data,
+      updatedAt: new Date(),
+    }).where(eq(vendors.id, id)).returning();
+    return updated ?? null;
+  }
+
+  async approve(id: string) {
+    const [updated] = await this.db.update(vendors).set({
+      status: "approved",
+      updatedAt: new Date(),
+    }).where(eq(vendors.id, id)).returning();
+    return updated ?? null;
+  }
+
+  async reject(id: string, reason: string) {
+    const [updated] = await this.db.update(vendors).set({
+      status: "pending" as VendorStatus,
+      verificationStatus: "rejected" as VerificationStatus,
+      rejectionReason: reason,
+      updatedAt: new Date(),
+    }).where(eq(vendors.id, id)).returning();
+    return updated ?? null;
+  }
+
+  async suspend(id: string, reason: string) {
+    const [updated] = await this.db.update(vendors).set({
+      status: "suspended" as VendorStatus,
+      suspensionReason: reason,
+      suspendedAt: new Date(),
+      updatedAt: new Date(),
+    }).where(eq(vendors.id, id)).returning();
+    return updated ?? null;
+  }
+
+  async reinstate(id: string) {
+    const [updated] = await this.db.update(vendors).set({
+      status: "approved" as VendorStatus,
+      suspensionReason: null,
+      suspendedAt: null,
+      updatedAt: new Date(),
+    }).where(eq(vendors.id, id)).returning();
+    return updated ?? null;
+  }
+
+  // ─── Documents ───────────────────────────────────────────────────────────
+
+  async uploadDocument(vendorId: string, data: { type: string; fileUrl: string }) {
+    const [doc] = await this.db.insert(vendorDocuments).values({
+      vendorId,
+      type: data.type,
+      fileUrl: data.fileUrl,
+    }).returning();
+
+    // Update vendor verification status
+    await this.db.update(vendors).set({
+      verificationStatus: "documents_submitted" as VerificationStatus,
+      updatedAt: new Date(),
+    }).where(eq(vendors.id, vendorId));
+
+    return doc;
+  }
+
+  async listDocuments(vendorId: string) {
+    return this.db.select().from(vendorDocuments)
+      .where(eq(vendorDocuments.vendorId, vendorId))
+      .orderBy(desc(vendorDocuments.uploadedAt));
+  }
+
+  async approveDocument(docId: string, notes?: string) {
+    const [updated] = await this.db.update(vendorDocuments).set({
+      status: "approved" as DocumentStatus,
+      reviewerNotes: notes,
+      reviewedAt: new Date(),
+    }).where(eq(vendorDocuments.id, docId)).returning();
+    return updated ?? null;
+  }
+
+  async rejectDocument(docId: string, notes?: string) {
+    const [updated] = await this.db.update(vendorDocuments).set({
+      status: "rejected" as DocumentStatus,
+      reviewerNotes: notes,
+      reviewedAt: new Date(),
+    }).where(eq(vendorDocuments.id, docId)).returning();
+    return updated ?? null;
+  }
+}

package/src/types.ts

@@ -0,0 +1,164 @@
+// ─── Sub-Order Status ────────────────────────────────────────────────────────
+
+export type SubOrderStatus =
+  | "pending"
+  | "confirmed"
+  | "processing"
+  | "shipped"
+  | "delivered"
+  | "cancelled";
+
+export const SUB_ORDER_TRANSITIONS: Record<SubOrderStatus, SubOrderStatus[]> = {
+  pending: ["confirmed", "cancelled"],
+  confirmed: ["processing", "cancelled"],
+  processing: ["shipped", "cancelled"],
+  shipped: ["delivered"],
+  delivered: [],
+  cancelled: [],
+};
+
+// ─── Vendor ──────────────────────────────────────────────────────────────────
+
+export type VendorStatus = "pending" | "approved" | "suspended";
+export type VerificationStatus = "unverified" | "documents_submitted" | "verified" | "rejected";
+export type VendorTier = "standard" | "silver" | "gold" | "platinum";
+export type PayoutSchedule = "daily" | "weekly" | "biweekly" | "monthly" | "manual";
+export type VendorApprovalMode = "manual" | "auto" | "invitation";
+
+// ─── Commission ──────────────────────────────────────────────────────────────
+
+export type CommissionRuleType = "category" | "volume_tier" | "vendor_tier" | "promotional";
+
+// ─── Disputes ────────────────────────────────────────────────────────────────
+
+export type DisputeStatus =
+  | "open"
+  | "vendor_response_pending"
+  | "platform_review"
+  | "resolved"
+  | "escalated"
+  | "closed";
+
+export type DisputeReason =
+  | "item_not_received"
+  | "item_not_as_described"
+  | "defective"
+  | "wrong_item"
+  | "other";
+
+export type DisputeResolution =
+  | "refund_full"
+  | "refund_partial"
+  | "replacement"
+  | "rejected"
+  | "vendor_favor"
+  | "buyer_favor";
+
+// ─── Returns ─────────────────────────────────────────────────────────────────
+
+export type ReturnStatus =
+  | "requested"
+  | "vendor_approved"
+  | "vendor_rejected"
+  | "shipped_back"
+  | "received"
+  | "refunded"
+  | "closed";
+
+export type ReturnReason =
+  | "defective"
+  | "wrong_item"
+  | "not_as_described"
+  | "changed_mind"
+  | "other";
+
+// ─── Balance Ledger ──────────────────────────────────────────────────────────
+
+export type BalanceEntryType =
+  | "sale"
+  | "commission"
+  | "refund_deduction"
+  | "adjustment"
+  | "payout";
+
+// ─── Document ────────────────────────────────────────────────────────────────
+
+export type DocumentType = "business_license" | "tax_form" | "bank_proof" | "identity" | "other";
+export type DocumentStatus = "pending" | "approved" | "rejected";
+
+// ─── Review ──────────────────────────────────────────────────────────────────
+
+export type ReviewStatus = "pending" | "published" | "hidden" | "flagged";
+
+// ─── RFQ ─────────────────────────────────────────────────────────────────────
+
+export type RFQStatus = "open" | "closed" | "awarded" | "cancelled";
+export type RFQResponseStatus = "submitted" | "shortlisted" | "accepted" | "rejected" | "withdrawn";
+
+// ─── Plugin Options ──────────────────────────────────────────────────────────
+
+export interface MarketplacePluginOptions {
+  defaultCommissionRateBps?: number;
+
+  vendorApprovalMode?: VendorApprovalMode;
+  requiredDocuments?: DocumentType[];
+
+  defaultPayoutSchedule?: PayoutSchedule;
+  defaultPayoutMinimumCents?: number;
+  defaultHoldbackDays?: number;
+
+  vendorResponseDeadlineDays?: number;
+  autoEscalateOnMissedDeadline?: boolean;
+
+  returnWindowDays?: number;
+  autoApproveReturnsOnVendorTimeout?: boolean;
+  vendorReturnResponseDays?: number;
+
+  requireVerifiedPurchase?: boolean;
+  reviewModerationEnabled?: boolean;
+
+  b2b?: {
+    rfq?: boolean;
+    contractPricing?: boolean;
+  };
+
+  performanceThresholds?: {
+    minRating?: number;
+    maxDefectRatePercent?: number;
+    maxLateShipmentRatePercent?: number;
+    maxCancellationRatePercent?: number;
+  };
+}
+
+// ─── Db type ─────────────────────────────────────────────────────────────────
+
+/**
+ * Driver-agnostic Drizzle PostgreSQL database type.
+ *
+ * `PgDatabase` from `drizzle-orm/pg-core` is the base class that all PG drivers
+ * extend (postgres-js, pglite, node-postgres). Using it with
+ * `Record<string, unknown>` as the schema generic means:
+ * - Row types are fully inferred from `pgTable` schema objects (`.from(vendors)`)
+ * - No coupling to any specific driver package
+ * - Works identically with PGlite in tests and postgres-js in production
+ */
+export type { PluginDb as Db } from "@unifiedcommerce/core";
+
+// ─── Route Context ───────────────────────────────────────────────────────────
+
+/** Minimal Hono-compatible context for route handlers */
+export interface RouteContext {
+  req: {
+    json(): Promise<Record<string, unknown>>;
+    param(name: string): string;
+    query(name: string): string | undefined;
+  };
+  json(data: unknown, status?: number): Response;
+  get(key: string): unknown;
+}
+
+// ─── Error helper ────────────────────────────────────────────────────────────
+
+export function errorMessage(err: unknown): string {
+  return err instanceof Error ? err.message : "Internal server error";
+}