Orders

npm install @86d-store/orders

import orders from "@86d-store/orders";
import { createModuleClient } from "@86d-store/core";

const client = createModuleClient([
  orders({
    currency: "USD",
  }),
]);

Order status:
  pending → processing → on_hold → completed
                                  ↘ cancelled
                                  ↘ refunded

Payment status:
  unpaid → paid → partially_paid → refunded
                ↘ voided

Return status:
  requested → approved → shipped_back → received → refunded → completed
            → rejected

Fulfillment status:
  unfulfilled | partially_fulfilled | fulfilled

<OrderHistory />

<OrderDetail orderId="ord_abc123" onBack={() => setView("history")} />

<OrderReturns
  orderId="ord_abc123"
  items={orderItems}
  orderStatus="completed"
/>

<OrderTracker />

type OrderStatus =
  | "pending" | "processing" | "on_hold"
  | "completed" | "cancelled" | "refunded";

type PaymentStatus =
  | "unpaid" | "paid" | "partially_paid" | "refunded" | "voided";

type ReturnStatus =
  | "requested" | "approved" | "rejected"
  | "shipped_back" | "received" | "refunded" | "completed";

type ReturnType = "refund" | "exchange" | "store_credit";

type OrderFulfillmentStatus =
  | "unfulfilled" | "partially_fulfilled" | "fulfilled";

interface Order {
  id: string;
  orderNumber: string;        // e.g. "ORD-lq3k7a-x9p"
  customerId?: string;
  guestEmail?: string;
  status: OrderStatus;
  paymentStatus: PaymentStatus;
  subtotal: number;           // in cents
  taxAmount: number;
  shippingAmount: number;
  discountAmount: number;
  total: number;
  currency: string;
  notes?: string;
  metadata: Record<string, unknown>;
  createdAt: Date;
  updatedAt: Date;
}

interface OrderItem {
  id: string;
  orderId: string;
  productId: string;
  variantId?: string;
  name: string;       // snapshotted at order creation
  sku?: string;
  price: number;      // snapshotted at order creation, in cents
  quantity: number;
  subtotal: number;
  metadata: Record<string, unknown>;
}

interface Fulfillment {
  id: string;
  orderId: string;
  status: OrderFulfillmentStatus;
  trackingNumber?: string;
  trackingUrl?: string;       // auto-generated for UPS, USPS, FedEx, DHL
  carrier?: string;
  notes?: string;
  shippedAt?: Date;
  deliveredAt?: Date;
  createdAt: Date;
  updatedAt: Date;
}

interface ReturnRequest {
  id: string;
  orderId: string;
  status: ReturnStatus;
  type: ReturnType;
  reason: string;
  customerNotes?: string;
  adminNotes?: string;
  refundAmount?: number;
  trackingNumber?: string;
  trackingUrl?: string;
  carrier?: string;
  createdAt: Date;
  updatedAt: Date;
}