@soulbatical/tetra-core 0.1.7 → 0.1.9

package/dist/shared/affiliate/routes.js

@@ -0,0 +1,404 @@
+import { AffiliateClickService } from './AffiliateClickService.js';
+import { createLogger } from '../../utils/logger.js';
+import { addQueryRoutes } from '../factories/QueryRouteFactory.js';
+const logger = createLogger('http:routes:affiliates');
+/**
+ * Add public affiliate routes (no auth required).
+ *
+ * Routes:
+ * - POST /click — Register affiliate click
+ * - POST /apply — Submit affiliate application
+ */
+export function addAffiliatePublicRoutes(router, options) {
+    const affiliateConfig = {
+        defaultCommissionPercentage: 30,
+        cookieDurationDays: 90,
+        tiers: [
+            { name: 'starter', minSales: 0, commissionPercentage: 30 },
+            { name: 'active', minSales: 10, commissionPercentage: 35 },
+        ],
+        ...options.config,
+    };
+    // POST /click — Register affiliate click
+    router.post('/click', async (req, res, next) => {
+        try {
+            const { affiliate_ref: affiliateRef, affiliate_source: affiliateSource, landing_page: landingPage, referrer } = req.body;
+            if (!affiliateRef || !affiliateSource) {
+                res.status(400).json({
+                    error: 'Missing required fields',
+                    required: ['affiliate_ref', 'affiliate_source'],
+                });
+                return;
+            }
+            if (affiliateSource !== 'internal') {
+                res.status(400).json({
+                    error: 'Invalid affiliate_source',
+                    valid: ['internal'],
+                });
+                return;
+            }
+            const supabase = options.getSystemDB();
+            const clickService = new AffiliateClickService(supabase);
+            // Resolve affiliate by referral code
+            let affiliateId = null;
+            let organizationId = null;
+            const { data: affiliate } = await supabase
+                .from('affiliates')
+                .select('id, organization_id')
+                .eq('referral_code', affiliateRef)
+                .eq('status', 'active')
+                .single();
+            if (affiliate) {
+                affiliateId = affiliate.id;
+                organizationId = affiliate.organization_id;
+            }
+            const clickId = await clickService.registerClick({
+                affiliate_id: affiliateId,
+                organization_id: organizationId,
+                affiliate_source: affiliateSource,
+                visitor_ip: req.ip || null,
+                user_agent: req.headers['user-agent'] || null,
+                referrer_url: referrer || null,
+                landing_page: landingPage || null,
+            });
+            // Increment click count
+            if (affiliateId) {
+                await clickService.incrementClickCount(affiliateId);
+            }
+            res.status(201).json({
+                success: true,
+                click_id: clickId,
+                message: 'Click registered successfully',
+            });
+        }
+        catch (error) {
+            logger.error('Error registering click', error);
+            next(error);
+        }
+    });
+    // POST /apply — Submit affiliate application
+    router.post('/apply', async (req, res, next) => {
+        try {
+            const { contact_name: contactName, email, phone, company_name: companyName, website, address, postal_code: postalCode, city, country, vat_number: vatNumber, kvk_number: kvkNumber, motivation, audience_size: audienceSize, preferred_code: preferredCode, } = req.body;
+            if (!contactName || !email) {
+                res.status(400).json({
+                    error: 'Missing required fields',
+                    required: ['contact_name', 'email'],
+                });
+                return;
+            }
+            const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+            if (!emailRegex.test(email)) {
+                res.status(400).json({ error: 'Invalid email format' });
+                return;
+            }
+            const supabase = options.getSystemDB();
+            // Check if email already exists
+            const { data: existing } = await supabase
+                .from('affiliates')
+                .select('id, status')
+                .eq('email', email)
+                .maybeSingle();
+            if (existing) {
+                const message = existing.status === 'pending'
+                    ? 'Application already submitted and pending review'
+                    : 'An affiliate account with this email already exists';
+                res.status(409).json({ error: 'Email already registered', message, status: existing.status });
+                return;
+            }
+            // Generate referral code
+            let referralCode = preferredCode?.toLowerCase().replace(/[^a-z0-9]/g, '');
+            if (!referralCode || referralCode.length < 3) {
+                referralCode = contactName.toLowerCase().replace(/[^a-z0-9]/g, '').substring(0, 10);
+            }
+            // Ensure uniqueness
+            let finalReferralCode = referralCode;
+            let counter = 1;
+            let isUnique = false;
+            while (!isUnique && counter < 100) {
+                const { data: existingCode } = await supabase
+                    .from('affiliates')
+                    .select('id')
+                    .eq('referral_code', finalReferralCode)
+                    .maybeSingle();
+                if (!existingCode) {
+                    isUnique = true;
+                }
+                else {
+                    finalReferralCode = `${referralCode}${counter}`;
+                    counter++;
+                }
+            }
+            if (!isUnique) {
+                res.status(500).json({ error: 'Could not generate unique referral code' });
+                return;
+            }
+            // Resolve organization ID
+            let organizationId = null;
+            if (options.resolveOrganizationId) {
+                organizationId = await options.resolveOrganizationId(req);
+            }
+            else {
+                // Fallback: first organization in database
+                const { data: org } = await supabase
+                    .from('organizations')
+                    .select('id')
+                    .limit(1)
+                    .maybeSingle();
+                organizationId = org?.id || null;
+            }
+            if (!organizationId) {
+                res.status(500).json({ error: 'Could not resolve organization' });
+                return;
+            }
+            // Create affiliate application
+            const { data: affiliate, error: insertError } = await supabase
+                .from('affiliates')
+                .insert({
+                organization_id: organizationId,
+                email,
+                contact_name: contactName,
+                phone: phone || null,
+                company_name: companyName || null,
+                website: website || null,
+                address: address || null,
+                postal_code: postalCode || null,
+                city: city || null,
+                country: country || 'NL',
+                vat_number: vatNumber || null,
+                kvk_number: kvkNumber || null,
+                referral_code: finalReferralCode,
+                status: 'pending',
+                tier: affiliateConfig.tiers[0]?.name || 'starter',
+                commission_percentage: affiliateConfig.defaultCommissionPercentage,
+                cookie_duration_days: affiliateConfig.cookieDurationDays,
+                notes: motivation ? `Motivation: ${motivation}\nAudience size: ${audienceSize || 'Not specified'}` : null,
+            })
+                .select()
+                .single();
+            if (insertError) {
+                logger.error('Failed to create affiliate application', { error: insertError });
+                throw insertError;
+            }
+            res.status(201).json({
+                success: true,
+                message: 'Application submitted successfully',
+                data: {
+                    id: affiliate.id,
+                    referral_code: finalReferralCode,
+                    status: 'pending',
+                    message: 'Your application is pending review. You will receive an email once approved.',
+                },
+            });
+        }
+        catch (error) {
+            logger.error('Error processing affiliate application', error);
+            next(error);
+        }
+    });
+}
+/**
+ * Add user affiliate routes (authenticated user).
+ *
+ * Routes:
+ * - GET /dashboard — Dashboard stats
+ * - GET /profile — Affiliate profile
+ * - GET /commissions — Commission history
+ */
+export function addAffiliateUserRoutes(router, options) {
+    const tiers = options.tiers || [
+        { name: 'starter', minSales: 0, commissionPercentage: 30 },
+        { name: 'active', minSales: 10, commissionPercentage: 35 },
+    ];
+    // GET /dashboard
+    router.get('/dashboard', async (req, res, next) => {
+        try {
+            if (!req.user) {
+                res.status(401).json({ error: 'Authentication required' });
+                return;
+            }
+            const userId = req.user.id;
+            const supabase = await options.getUserDB(req);
+            const { data: affiliate, error: affiliateError } = await supabase
+                .from('affiliates')
+                .select('*')
+                .eq('user_id', userId)
+                .eq('status', 'active')
+                .single();
+            if (affiliateError || !affiliate) {
+                res.status(404).json({
+                    error: 'Affiliate account not found or not active',
+                    message: 'Please apply to become an affiliate first',
+                });
+                return;
+            }
+            const conversionRate = affiliate.total_clicks > 0
+                ? ((affiliate.total_sales / affiliate.total_clicks) * 100)
+                : 0;
+            const averageOrderValue = affiliate.total_sales > 0
+                ? (affiliate.total_revenue / affiliate.total_sales)
+                : 0;
+            const pendingCommission = affiliate.total_commission_earned - affiliate.total_commission_paid;
+            const tierProgress = calculateTierProgress(tiers, affiliate.tier, affiliate.total_sales);
+            const { data: recentCommissions } = await supabase
+                .from('affiliate_commissions')
+                .select('id, order_id, product_name, order_amount_excl_vat, commission_amount, commission_percentage, status, created_at')
+                .eq('affiliate_id', affiliate.id)
+                .order('created_at', { ascending: false })
+                .limit(10);
+            res.json({
+                success: true,
+                data: {
+                    affiliate: {
+                        id: affiliate.id,
+                        referral_code: affiliate.referral_code,
+                        tier: affiliate.tier,
+                        commission_percentage: affiliate.commission_percentage,
+                        status: affiliate.status,
+                        active_since: affiliate.active_since,
+                        contact_name: affiliate.contact_name,
+                        email: affiliate.email,
+                    },
+                    stats: {
+                        total_clicks: affiliate.total_clicks,
+                        total_sales: affiliate.total_sales,
+                        total_revenue: parseFloat(affiliate.total_revenue),
+                        conversion_rate: parseFloat(conversionRate.toFixed(2)),
+                        average_order_value: parseFloat(averageOrderValue.toFixed(2)),
+                    },
+                    commission: {
+                        total_earned: parseFloat(affiliate.total_commission_earned),
+                        total_paid: parseFloat(affiliate.total_commission_paid),
+                        pending: parseFloat(pendingCommission.toFixed(2)),
+                    },
+                    tier_progress: tierProgress,
+                    recent_commissions: recentCommissions || [],
+                },
+            });
+        }
+        catch (error) {
+            logger.error('Error fetching dashboard', error);
+            next(error);
+        }
+    });
+    // GET /profile
+    router.get('/profile', async (req, res, next) => {
+        try {
+            if (!req.user) {
+                res.status(401).json({ error: 'Authentication required' });
+                return;
+            }
+            const supabase = await options.getUserDB(req);
+            const { data: affiliate, error } = await supabase
+                .from('affiliates')
+                .select('*')
+                .eq('user_id', req.user.id)
+                .single();
+            if (error || !affiliate) {
+                res.status(404).json({ error: 'Affiliate account not found' });
+                return;
+            }
+            res.json({ success: true, data: affiliate });
+        }
+        catch (error) {
+            logger.error('Error fetching profile', error);
+            next(error);
+        }
+    });
+    // GET /commissions
+    router.get('/commissions', async (req, res, next) => {
+        try {
+            if (!req.user) {
+                res.status(401).json({ error: 'Authentication required' });
+                return;
+            }
+            const supabase = await options.getUserDB(req);
+            const { data: affiliate, error: affiliateError } = await supabase
+                .from('affiliates')
+                .select('id')
+                .eq('user_id', req.user.id)
+                .single();
+            if (affiliateError || !affiliate) {
+                res.status(404).json({ error: 'Affiliate account not found' });
+                return;
+            }
+            const { data: commissions, error } = await supabase
+                .from('affiliate_commissions')
+                .select('*')
+                .eq('affiliate_id', affiliate.id)
+                .order('created_at', { ascending: false });
+            if (error)
+                throw error;
+            res.json({ success: true, data: commissions || [] });
+        }
+        catch (error) {
+            logger.error('Error fetching commissions', error);
+            next(error);
+        }
+    });
+}
+/**
+ * Add admin affiliate routes (requires admin auth).
+ *
+ * Routes:
+ * - POST / — Create affiliate
+ * - PUT /:id — Update affiliate
+ * - DELETE /:id — Delete affiliate
+ * - GET /filters — Filter configurations
+ * - GET /by-ids — Get by IDs
+ * - GET /counts — Get counts
+ * - GET / — List affiliates
+ * - GET /:id — Get single affiliate
+ */
+export function addAffiliateAdminRoutes(router, options) {
+    // CRUD routes first (must be before query routes to avoid /:id collision)
+    const crud = options.crudController;
+    router.post('/', (req, res) => crud.create(req, res));
+    router.put('/:id', (req, res) => crud.update(req, res));
+    router.delete('/:id', (req, res) => crud.delete(req, res));
+    // Standard query routes
+    addQueryRoutes(router, {
+        featureConfig: options.featureConfig,
+        controller: options.queryController,
+        filterController: options.filterController,
+        maxLimit: 1000,
+        defaultLimit: 20,
+        allowSearch: true,
+        allowedFields: [
+            'id', 'email', 'contact_name', 'company_name', 'referral_code',
+            'status', 'tier', 'commission_percentage', 'total_sales', 'total_revenue',
+            'total_commission_earned', 'created_at', 'organization_id',
+        ],
+    });
+}
+// ─── Tier Progress Helper ─────────────────────────────────────
+function calculateTierProgress(tiers, currentTier, totalSales) {
+    const sortedTiers = [...tiers].sort((a, b) => a.minSales - b.minSales);
+    const currentTierInfo = sortedTiers.find(t => t.name === currentTier) || sortedTiers[0];
+    const currentIndex = sortedTiers.indexOf(currentTierInfo);
+    const nextTierInfo = currentIndex < sortedTiers.length - 1 ? sortedTiers[currentIndex + 1] : null;
+    if (!nextTierInfo) {
+        return {
+            current_tier: currentTier,
+            current_commission: currentTierInfo.commissionPercentage,
+            current_sales: totalSales,
+            is_max_tier: true,
+        };
+    }
+    const salesInCurrentTier = totalSales - currentTierInfo.minSales;
+    const salesNeededForNextTier = nextTierInfo.minSales - currentTierInfo.minSales;
+    const progressPercentage = (salesInCurrentTier / salesNeededForNextTier) * 100;
+    const salesUntilNext = nextTierInfo.minSales - totalSales;
+    return {
+        current_tier: currentTier,
+        current_commission: currentTierInfo.commissionPercentage,
+        current_sales: totalSales,
+        next_tier: nextTierInfo.name,
+        next_commission: nextTierInfo.commissionPercentage,
+        sales_needed_for_next: salesNeededForNextTier,
+        sales_until_next: Math.max(0, salesUntilNext),
+        progress_percentage: parseFloat(Math.min(100, progressPercentage).toFixed(1)),
+        is_max_tier: false,
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/shared/affiliate/routes.js.map

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

package/dist/shared/affiliate/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Affiliate Module — Types & Interfaces
+ *
+ * Generic affiliate types for internal referral systems.
+ * No external platform types (ShareASale, TradeTracker, Impact) —
+ * those are project-specific extensions.
+ *
+ * @module @soulbatical/tetra-core/affiliate
+ */
+export interface AffiliateConfig {
+    /** Default commission percentage for new affiliates (e.g., 30) */
+    defaultCommissionPercentage: number;
+    /** Cookie duration in days (e.g., 90) */
+    cookieDurationDays: number;
+    /** Tier configuration for auto-upgrades */
+    tiers: AffiliateTierConfig[];
+    /** Custom referral code generator (default: firstname-XXXX) */
+    referralCodeGenerator?: (name: string) => string;
+}
+export interface AffiliateTierConfig {
+    /** Tier name (e.g., 'starter', 'active') */
+    name: string;
+    /** Minimum total sales to qualify for this tier */
+    minSales: number;
+    /** Commission percentage for this tier */
+    commissionPercentage: number;
+}
+export interface AffiliateAttribution {
+    affiliate_id: string | null;
+    source: 'internal';
+    attribution_type: 'voucher' | 'url' | 'cookie';
+    reference: string;
+}
+export interface AffiliateOrder {
+    id: string;
+    organization_id: string;
+    user_id?: string;
+    total: number;
+    total_excl_vat: number;
+    voucher_code?: string;
+    created_at: string;
+}
+export interface Affiliate {
+    id: string;
+    organization_id: string;
+    user_id?: string | null;
+    email: string;
+    contact_name: string;
+    company_name?: string | null;
+    phone?: string | null;
+    address?: string | null;
+    postal_code?: string | null;
+    city?: string | null;
+    country?: string | null;
+    vat_number?: string | null;
+    kvk_number?: string | null;
+    website?: string | null;
+    status: 'pending' | 'active' | 'inactive' | 'rejected';
+    referral_code: string;
+    tier: string;
+    commission_percentage: number;
+    cookie_duration_days: number;
+    total_clicks: number;
+    total_sales: number;
+    total_revenue: number;
+    total_commission_earned: number;
+    total_commission_paid: number;
+    active_since?: string | null;
+    last_sale_at?: string | null;
+    notes?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface AffiliateCommission {
+    id: string;
+    organization_id: string;
+    affiliate_id: string;
+    order_id: string;
+    affiliate_source: string;
+    external_click_ref?: string | null;
+    product_name: string;
+    order_amount_excl_vat: number;
+    commission_percentage: number;
+    commission_amount: number;
+    status: 'pending' | 'approved' | 'paid' | 'cancelled' | 'refunded';
+    approved_at?: string | null;
+    approved_by?: string | null;
+    paid_at?: string | null;
+    payment_id?: string | null;
+    notes?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface AffiliateClick {
+    id: string;
+    organization_id?: string | null;
+    affiliate_id?: string | null;
+    visitor_ip?: string | null;
+    visitor_country?: string | null;
+    user_agent?: string | null;
+    referrer_url?: string | null;
+    landing_page?: string | null;
+    affiliate_source: string;
+    external_click_ref?: string | null;
+    converted: boolean;
+    order_id?: string | null;
+    conversion_time_hours?: number | null;
+    clicked_at: string;
+}
+export interface AffiliatePayment {
+    id: string;
+    organization_id: string;
+    affiliate_id: string;
+    payment_amount: number;
+    payment_date: string;
+    payment_method?: string | null;
+    payment_reference?: string | null;
+    commission_ids: string[];
+    notes?: string | null;
+    created_at: string;
+}
+export interface AffiliateTierHistory {
+    id: string;
+    affiliate_id: string;
+    old_tier: string;
+    new_tier: string;
+    old_commission_percentage: number;
+    new_commission_percentage: number;
+    reason?: string | null;
+    triggered_by_sale_count?: number | null;
+    changed_at: string;
+}
+export interface AffiliateFilters {
+    status?: string;
+    tier?: string;
+    search?: string;
+    has_user?: string;
+    time_period?: string;
+}
+export interface AffiliateDashboardStats {
+    total_clicks: number;
+    total_sales: number;
+    total_revenue: number;
+    conversion_rate: number;
+    average_order_value: number;
+}
+export interface AffiliateDashboardCommission {
+    total_earned: number;
+    total_paid: number;
+    pending: number;
+}
+export interface AffiliateTierProgress {
+    current_tier: string;
+    current_commission: number;
+    current_sales: number;
+    next_tier?: string;
+    next_commission?: number;
+    sales_needed_for_next?: number;
+    sales_until_next?: number;
+    progress_percentage?: number;
+    is_max_tier: boolean;
+}
+export interface AffiliateDashboard {
+    affiliate: Pick<Affiliate, 'id' | 'referral_code' | 'tier' | 'commission_percentage' | 'status' | 'active_since' | 'contact_name' | 'email'>;
+    stats: AffiliateDashboardStats;
+    commission: AffiliateDashboardCommission;
+    tier_progress: AffiliateTierProgress;
+    recent_commissions: AffiliateCommission[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/affiliate/types.d.ts.map

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

package/dist/shared/affiliate/types.js

@@ -0,0 +1,11 @@
+/**
+ * Affiliate Module — Types & Interfaces
+ *
+ * Generic affiliate types for internal referral systems.
+ * No external platform types (ShareASale, TradeTracker, Impact) —
+ * those are project-specific extensions.
+ *
+ * @module @soulbatical/tetra-core/affiliate
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/affiliate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/affiliate/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulbatical/tetra-core",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "publishConfig": {
     "access": "restricted"
   },