@unifiedcommerce/plugin-marketplace 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+export type SubOrderStatus = "pending" | "confirmed" | "processing" | "shipped" | "delivered" | "cancelled";
+export declare const SUB_ORDER_TRANSITIONS: Record<SubOrderStatus, SubOrderStatus[]>;
+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";
+export type CommissionRuleType = "category" | "volume_tier" | "vendor_tier" | "promotional";
+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";
+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";
+export type BalanceEntryType = "sale" | "commission" | "refund_deduction" | "adjustment" | "payout";
+export type DocumentType = "business_license" | "tax_form" | "bank_proof" | "identity" | "other";
+export type DocumentStatus = "pending" | "approved" | "rejected";
+export type ReviewStatus = "pending" | "published" | "hidden" | "flagged";
+export type RFQStatus = "open" | "closed" | "awarded" | "cancelled";
+export type RFQResponseStatus = "submitted" | "shortlisted" | "accepted" | "rejected" | "withdrawn";
+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;
+    };
+}
+/**
+ * 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";
+/** 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;
+}
+export declare function errorMessage(err: unknown): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+// ─── Sub-Order Status ────────────────────────────────────────────────────────
+export const SUB_ORDER_TRANSITIONS = {
+    pending: ["confirmed", "cancelled"],
+    confirmed: ["processing", "cancelled"],
+    processing: ["shipped", "cancelled"],
+    shipped: ["delivered"],
+    delivered: [],
+    cancelled: [],
+};
+// ─── Error helper ────────────────────────────────────────────────────────────
+export function errorMessage(err) {
+    return err instanceof Error ? err.message : "Internal server error";
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@unifiedcommerce/plugin-marketplace",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "default": "./dist/schema.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 1000",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@hono/zod-openapi": "^1.2.2",
+    "@unifiedcommerce/core": "*",
+    "drizzle-orm": "^0.45.1",
+    "hono": "^4.12.5"
+  },
+  "devDependencies": {
+    "@repo/eslint-config": "*",
+    "@repo/typescript-config": "*",
+    "@types/node": "^24.5.2",
+    "eslint": "^9.39.1",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ]
+}

package/src/analytics-models.ts

@@ -0,0 +1,75 @@
+import type { AnalyticsModel } from "@unifiedcommerce/core";
+
+/**
+ * Marketplace analytics models — SQL-based definitions for vendor-scoped analytics.
+ *
+ * These models describe the marketplace tables (marketplace_vendor_sub_orders,
+ * marketplace_vendor_balances, marketplace_vendor_reviews) and are registered
+ * on the DrizzleAnalyticsAdapter via the plugin's analyticsModels manifest slot.
+ */
+
+export const VENDOR_ORDERS_MODEL: AnalyticsModel = {
+  name: "VendorOrders",
+  table: "marketplace_vendor_sub_orders",
+  scopeRules: [
+    { role: "vendor", filter: "vendor_id = :vendorId" },
+  ],
+  measures: {
+    count:          { type: "count" },
+    revenue:        { sql: "subtotal", type: "sum" },
+    commissionPaid: { sql: "commission_amount", type: "sum" },
+    netPayout:      { sql: "payout_amount", type: "sum" },
+  },
+  dimensions: {
+    id:        { sql: "id", type: "string" },
+    vendorId:  { sql: "vendor_id", type: "string" },
+    orderId:   { sql: "order_id", type: "string" },
+    status:    { sql: "status", type: "string" },
+    createdAt: { sql: "created_at", type: "time" },
+  },
+};
+
+export const VENDOR_BALANCE_MODEL: AnalyticsModel = {
+  name: "VendorBalance",
+  table: "marketplace_vendor_balances",
+  scopeRules: [
+    { role: "vendor", filter: "vendor_id = :vendorId" },
+  ],
+  measures: {
+    totalCredits:  { sql: "CASE WHEN amount_cents > 0 THEN amount_cents ELSE 0 END", type: "sum" },
+    totalDebits:   { sql: "CASE WHEN amount_cents < 0 THEN ABS(amount_cents) ELSE 0 END", type: "sum" },
+    netBalance:    { sql: "amount_cents", type: "sum" },
+    entryCount:    { type: "count" },
+  },
+  dimensions: {
+    id:        { sql: "id", type: "string" },
+    vendorId:  { sql: "vendor_id", type: "string" },
+    type:      { sql: "type", type: "string" },
+    createdAt: { sql: "created_at", type: "time" },
+  },
+};
+
+export const VENDOR_REVIEWS_MODEL: AnalyticsModel = {
+  name: "VendorReviews",
+  table: "marketplace_vendor_reviews",
+  scopeRules: [
+    { role: "vendor", filter: "vendor_id = :vendorId" },
+  ],
+  measures: {
+    count:         { type: "count" },
+    averageRating: { sql: "rating", type: "avg" },
+  },
+  dimensions: {
+    id:        { sql: "id", type: "string" },
+    vendorId:  { sql: "vendor_id", type: "string" },
+    rating:    { sql: "rating", type: "number" },
+    status:    { sql: "status", type: "string" },
+    createdAt: { sql: "created_at", type: "time" },
+  },
+};
+
+export const MARKETPLACE_ANALYTICS_MODELS: AnalyticsModel[] = [
+  VENDOR_ORDERS_MODEL,
+  VENDOR_BALANCE_MODEL,
+  VENDOR_REVIEWS_MODEL,
+];

package/src/hooks.ts

@@ -0,0 +1,215 @@
+import { eq } from "drizzle-orm";
+import type { PluginHookRegistration } from "@unifiedcommerce/core";
+import { vendors, vendorEntities, vendorSubOrders, vendorPayouts } from "./schema";
+import { CommissionService } from "./services/commission";
+import { PayoutService } from "./services/payout";
+import type { Db, MarketplacePluginOptions } from "./types";
+
+function getDbFromHookArgs(args: unknown): Db {
+  const a = args as { context: { services: { database: { db: unknown } } } };
+  return a.context.services.database.db as Db;
+}
+
+export function buildHooks(options: MarketplacePluginOptions): PluginHookRegistration[] {
+  return [
+    // ─── catalog.beforeCreate ──────────────────────────────────────────────
+    {
+      key: "catalog.beforeCreate",
+      async handler(args: unknown) {
+        const { data } = args as { data: Record<string, unknown> };
+        const metadata = data?.metadata as Record<string, unknown> | undefined;
+        const vendorId = metadata?.vendorId;
+        if (!vendorId) return data;
+
+        const db = getDbFromHookArgs(args);
+        const [vendor] = await db.select().from(vendors).where(eq(vendors.id, String(vendorId)));
+
+        if (!vendor) throw new Error("Vendor not found.");
+        if (vendor.status === "suspended") throw new Error("Vendor is suspended and cannot create listings.");
+        if (vendor.status !== "approved") throw new Error("Vendor must be approved before creating marketplace listings.");
+
+        // Check approved categories if set
+        const approvedCats = vendor.approvedCategories as string[] | null;
+        if (approvedCats && Array.isArray(approvedCats)) {
+          const entityType = data.type as string | undefined;
+          // approvedCategories holds category slugs; entityType may match
+          // This is a basic check; real implementations would check category assignment
+        }
+
+        return data;
+      },
+    },
+
+    // ─── catalog.afterCreate ───────────────────────────────────────────────
+    {
+      key: "catalog.afterCreate",
+      async handler(args: unknown) {
+        const { result } = args as { result: { id: string; metadata?: Record<string, unknown> | null } };
+        const vendorId = result?.metadata?.vendorId;
+        if (!vendorId) return;
+
+        const db = getDbFromHookArgs(args);
+        await db.insert(vendorEntities).values({
+          vendorId: String(vendorId),
+          entityId: result.id,
+        });
+      },
+    },
+
+    // ─── catalog.beforeList ────────────────────────────────────────────────
+    {
+      key: "catalog.beforeList",
+      async handler(args: unknown) {
+        const { data, context: hookContext } = args as {
+          data: unknown;
+          context: { context: Record<string, unknown>; actor?: { vendorId?: string | null } };
+        };
+        hookContext.context.marketplaceVendorScope = hookContext.actor?.vendorId ?? null;
+        return data;
+      },
+    },
+
+    // ─── catalog.afterList ─────────────────────────────────────────────────
+    {
+      key: "catalog.afterList",
+      async handler(args: unknown) {
+        const { result, context: hookContext } = args as {
+          result: { items?: Array<{ id: string }> };
+          context: { context: Record<string, unknown> };
+        };
+        const vendorScope = hookContext.context.marketplaceVendorScope as string | null;
+        if (!vendorScope || !Array.isArray(result?.items)) return;
+
+        const db = getDbFromHookArgs(args);
+        const links = await db.select().from(vendorEntities).where(eq(vendorEntities.vendorId, vendorScope));
+        const linkedEntityIds = new Set(links.map((l: { entityId: string }) => l.entityId));
+        result.items = result.items.filter((item) => linkedEntityIds.has(item.id));
+      },
+    },
+
+    // ─── catalog.afterRead ─────────────────────────────────────────────────
+    {
+      key: "catalog.afterRead",
+      async handler(args: unknown) {
+        const { result } = args as { result: Record<string, unknown> & { id: string } };
+        const db = getDbFromHookArgs(args);
+        const [link] = await db.select().from(vendorEntities).where(eq(vendorEntities.entityId, result.id));
+        if (!link) return;
+
+        const [vendor] = await db.select().from(vendors).where(eq(vendors.id, link.vendorId));
+        if (!vendor) return;
+
+        result.marketplace = {
+          vendor: {
+            id: vendor.id,
+            name: vendor.name,
+            slug: vendor.slug,
+            status: vendor.status,
+            tier: vendor.tier,
+            logoUrl: vendor.logoUrl,
+          },
+        };
+      },
+    },
+
+    // ─── orders.afterCreate ────────────────────────────────────────────────
+    {
+      key: "orders.afterCreate",
+      async handler(args: unknown) {
+        const { result, context: hookContext } = args as {
+          result: { id: string; lineItems?: Array<{ entityId: string; quantity: number; totalPrice: number }> };
+          context: { logger: { info(msg: string, data?: unknown): void } };
+        };
+        const db = getDbFromHookArgs(args);
+        const commissionService = new CommissionService(db, options);
+        const payoutService = new PayoutService(db, options);
+
+        const grouped = new Map<string, Array<{ entityId: string; quantity: number; totalPrice: number }>>();
+
+        for (const lineItem of result.lineItems ?? []) {
+          const [link] = await db.select().from(vendorEntities).where(eq(vendorEntities.entityId, lineItem.entityId));
+          if (!link) continue;
+          const [vendor] = await db.select().from(vendors).where(eq(vendors.id, link.vendorId));
+          if (!vendor) continue;
+
+          const existing = grouped.get(vendor.id) ?? [];
+          existing.push({
+            entityId: lineItem.entityId,
+            quantity: lineItem.quantity,
+            totalPrice: lineItem.totalPrice,
+          });
+          grouped.set(vendor.id, existing);
+        }
+
+        for (const [vendorId, lineItems] of grouped.entries()) {
+          const subtotal = lineItems.reduce((sum, item) => sum + item.totalPrice, 0);
+
+          // Resolve commission via rules engine
+          const commissionRateBps = await commissionService.resolveRate(vendorId);
+          const commissionAmount = Math.round((subtotal * commissionRateBps) / 10000);
+          const payoutAmount = subtotal - commissionAmount;
+
+          const [subOrder] = await db.insert(vendorSubOrders).values({
+            orderId: result.id,
+            vendorId,
+            status: "pending",
+            subtotal,
+            commissionAmount,
+            payoutAmount,
+            notified: true,
+            lineItems,
+            metadata: {},
+          }).returning();
+
+          if (!subOrder) continue;
+
+          // Credit vendor balance with full subtotal
+          await payoutService.addLedgerEntry({
+            vendorId,
+            type: "sale",
+            amountCents: subtotal,
+            referenceType: "sub_order",
+            referenceId: subOrder.id,
+            description: `Sale from order ${result.id.slice(0, 8)}`,
+          });
+
+          // Record commission as separate entry
+          await payoutService.addLedgerEntry({
+            vendorId,
+            type: "commission",
+            amountCents: -commissionAmount,
+            referenceType: "sub_order",
+            referenceId: subOrder.id,
+            description: `Commission (${commissionRateBps}bps) on order ${result.id.slice(0, 8)}`,
+          });
+
+          hookContext.logger.info("marketplace_sub_order_created", {
+            orderId: result.id,
+            subOrderId: subOrder.id,
+            vendorId,
+            commissionRateBps,
+          });
+        }
+      },
+    },
+
+    // ─── orders.beforeStatusChange ─────────────────────────────────────────
+    {
+      key: "orders.beforeStatusChange",
+      async handler(args: unknown) {
+        const { data } = args as { data: { orderId: string; newStatus: string } };
+        if (data.newStatus !== "fulfilled") return data;
+
+        const db = getDbFromHookArgs(args);
+        const related = await db.select().from(vendorSubOrders).where(eq(vendorSubOrders.orderId, data.orderId));
+        const allDelivered = related.every((subOrder: { status: string }) => subOrder.status === "delivered");
+
+        if (!allDelivered) {
+          throw new Error("Cannot fulfill parent order until all marketplace sub-orders are delivered.");
+        }
+
+        return data;
+      },
+    },
+  ];
+}

package/src/index.ts

@@ -0,0 +1,124 @@
+import { defineCommercePlugin } from "@unifiedcommerce/core";
+import { MARKETPLACE_ANALYTICS_MODELS } from "./analytics-models";
+import {
+  vendors, vendorEntities, vendorSubOrders, vendorPayouts,
+  vendorDocuments, commissionRules, vendorBalances,
+  disputes, vendorReviews, returnRequests,
+  rfqs, rfqResponses, contractPrices,
+} from "./schema";
+import { VendorService } from "./services/vendor";
+import { SubOrderService } from "./services/sub-order";
+import { CommissionService } from "./services/commission";
+import { PayoutService } from "./services/payout";
+import { DisputeService } from "./services/dispute";
+import { ReturnService } from "./services/return";
+import { ReviewService } from "./services/review";
+import { RFQService } from "./services/rfq";
+import { ContractPriceService } from "./services/contract-price";
+import { buildHooks } from "./hooks";
+import { buildMCPTools } from "./mcp-tools";
+import { buildVendorRoutes } from "./routes/vendors";
+import { buildVendorPortalRoutes } from "./routes/vendor-portal";
+import { buildSubOrderRoutes } from "./routes/sub-orders";
+import { buildCommissionRoutes } from "./routes/commission";
+import { buildPayoutRoutes } from "./routes/payouts";
+import { buildDisputesReturnsReviewsRoutes } from "./routes/disputes-returns-reviews";
+import { buildB2BRoutes } from "./routes/b2b";
+import type { MarketplacePluginOptions, Db } from "./types";
+
+export type { MarketplacePluginOptions } from "./types";
+
+function createServices(db: Db, options: MarketplacePluginOptions, kernelServices?: Record<string, unknown>) {
+  const vendor = new VendorService(db);
+  const commission = new CommissionService(db, options);
+  const payout = new PayoutService(db, options);
+  const dispute = new DisputeService(db, options);
+  const returnSvc = new ReturnService(db);
+  const review = new ReviewService(db, options);
+  const rfq = options.b2b?.rfq ? new RFQService(db) : undefined;
+  const contractPrice = options.b2b?.contractPricing ? new ContractPriceService(db) : undefined;
+
+  // Cancel callback: release inventory on parent order + reverse balance
+  const subOrder = new SubOrderService(db, async (sub) => {
+    // Release inventory for cancelled vendor's line items
+    const inventory = kernelServices?.inventory as
+      { release(input: Record<string, unknown>): Promise<unknown> } | undefined;
+    if (inventory?.release && sub.lineItems) {
+      for (const item of sub.lineItems as Array<{ entityId: string; quantity: number }>) {
+        await inventory.release({
+          entityId: item.entityId,
+          quantity: item.quantity,
+          orderId: sub.orderId,
+          performedBy: "marketplace",
+        });
+      }
+    }
+
+    // Reverse balance: debit the sale credit
+    if (sub.payoutAmount > 0) {
+      await payout.addLedgerEntry({
+        vendorId: sub.vendorId,
+        type: "refund_deduction",
+        amountCents: -sub.payoutAmount,
+        referenceType: "sub_order",
+        referenceId: sub.id,
+        description: `Cancelled sub-order ${sub.id.slice(0, 8)}`,
+      });
+    }
+  });
+
+  return { vendor, subOrder, commission, payout, dispute, return: returnSvc, review, rfq, contractPrice };
+}
+
+export function marketplacePlugin(options: MarketplacePluginOptions = {}) {
+  return defineCommercePlugin({
+    id: "marketplace",
+    version: "2.0.0",
+
+    schema: () => ({
+      vendors,
+      vendorEntities,
+      vendorSubOrders,
+      vendorPayouts,
+      vendorDocuments,
+      commissionRules,
+      vendorBalances,
+      disputes,
+      vendorReviews,
+      returnRequests,
+      rfqs,
+      rfqResponses,
+      contractPrices,
+    }),
+
+    hooks: () => buildHooks(options),
+
+    routes: (ctx) => {
+      const db = ctx.database.db as unknown as Db;
+      const services = db ? createServices(db, options, ctx.services) : null;
+
+      if (!services) return [];
+
+      return [
+        ...buildVendorRoutes(services, options),
+        ...buildVendorPortalRoutes(services),
+        ...buildSubOrderRoutes(services),
+        ...buildCommissionRoutes(services),
+        ...buildPayoutRoutes(services),
+        ...buildDisputesReturnsReviewsRoutes(services),
+        ...(options.b2b?.rfq || options.b2b?.contractPricing
+          ? buildB2BRoutes(services, options)
+          : []),
+      ];
+    },
+
+    mcpTools: (ctx) => {
+      const db = ctx.database.db as unknown as Db;
+      if (!db) return [];
+      const services = createServices(db, options, ctx.services);
+      return buildMCPTools(services, options);
+    },
+
+    analyticsModels: () => MARKETPLACE_ANALYTICS_MODELS,
+  });
+}