Products

{
  "modules": ["@86d-store/products"],
  "advanced": {
    "version": 1,
    "allowExperimentalModules": true
  }
}

import products from "@86d-store/products";

const module = products({
  defaultPageSize: 20,
  maxPageSize: 100,
  trackInventory: true,
});

<ProductCard product={product} />

<ProductCard product={product} showAddToCart={false} />

<FeaturedProducts />

<FeaturedProducts limit={4} title="Staff Picks" />

<ProductListing />

<ProductListing initialCategory="shoes" pageSize={12} />

<RelatedProducts productId={product.id} />

<RelatedProducts productId={product.id} limit={4} title="You may also like" />

<CollectionCard collection={collection} />

<CollectionGrid />

<CollectionGrid title="Shop by Category" featured={true} />

<StarDisplay rating={4.5} />

<StarDisplay rating={product.averageRating} size="sm" />

<StarPicker value={rating} onChange={setRating} />

<StockBadge inventory={product.inventory} />

<ProductReviewsSection productId={product.id} />

interface Product {
  id: string;
  name: string;
  slug: string;
  description?: string;
  shortDescription?: string;
  price: number;               // in cents
  compareAtPrice?: number;     // in cents
  costPrice?: number;          // in cents
  sku?: string;
  barcode?: string;
  inventory: number;
  trackInventory: boolean;
  allowBackorder: boolean;
  status: "draft" | "active" | "archived";
  categoryId?: string;
  images: string[];
  tags: string[];
  isFeatured: boolean;
  weight?: number;
  weightUnit?: "kg" | "lb" | "oz" | "g";
  metadata?: Record<string, unknown>;
  createdAt: Date;
  updatedAt: Date;
}

interface ProductVariant {
  id: string;
  productId: string;
  name: string;
  sku?: string;
  price: number;               // in cents
  compareAtPrice?: number;     // in cents
  costPrice?: number;          // in cents
  inventory: number;
  options: Record<string, string>; // e.g. { size: "M", color: "Blue" }
  images: string[];
  position: number;
  weight?: number;
  weightUnit?: "kg" | "lb" | "oz" | "g";
  createdAt: Date;
  updatedAt: Date;
}

interface Category {
  id: string;
  name: string;
  slug: string;
  description?: string;
  parentId?: string;           // Self-referential for nested categories
  image?: string;
  position: number;
  isVisible: boolean;
  metadata?: Record<string, unknown>;
  createdAt: Date;
  updatedAt: Date;
}

interface ProductWithVariants extends Product {
  variants: ProductVariant[];
  category?: Category;
}