Affiliates

npm install @86d-store/affiliates

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

export default defineStore({
  modules: [
    affiliates({
      defaultCommissionRate: "10",
      minimumPayout: "50",
      cookieDurationDays: "30",
    }),
  ],
});

{
  "name": "Editorial partner",
  "email": "partner_contact_here",
  "website": "https://partner.example"
}

type AffiliateStatus = "pending" | "approved" | "suspended" | "rejected";
type ConversionStatus = "pending" | "approved" | "rejected";
type PayoutStatus = "pending" | "processing" | "completed" | "failed";
type PayoutMethod = "bank_transfer" | "paypal" | "store_credit" | "check";

interface Affiliate {
  id: string;
  name: string;
  email: string;
  website?: string;
  code: string;           // Unique 8-character tracking code
  commissionRate: number;
  status: AffiliateStatus;
  totalClicks: number;
  totalConversions: number;
  totalRevenue: number;
  totalCommission: number;
  totalPaid: number;
}

interface AffiliateLink {
  id: string;
  affiliateId: string;
  targetUrl: string;
  slug: string;           // Unique 10-character URL slug
  clicks: number;
  conversions: number;
  revenue: number;
  active: boolean;
}

interface AffiliateConversion {
  id: string;
  affiliateId: string;
  linkId: string;
  orderId: string;
  orderAmount: number;
  commissionRate: number;
  commissionAmount: number;
  status: ConversionStatus;
}

interface AffiliatePayout {
  id: string;
  affiliateId: string;
  amount: number;
  method: PayoutMethod;
  reference?: string;
  status: PayoutStatus;
  paidAt?: Date;
}

interface AffiliateStats {
  totalAffiliates: number;
  activeAffiliates: number;
  totalClicks: number;
  totalConversions: number;
  totalRevenue: number;
  totalCommissionPaid: number;
}