// Match ratio configuration
type MatchRatio = 0.5 | 1 | 2 | 3;

// Example: 2:1 matching on a £50 donation
const donation = {
  amount: 50,
  matchRatio: 2,
  matched: 100,       // Company matches £100
  totalImpact: 150,   // Employee + Company = £150 total
};

// API endpoint
POST /api/donations/bulk-match
{
  "donationIds": ["d1", "d2", "d3"],
  "matchRatio": 2
}

import {
  createDonation,
  processMatch,
  generateReceipt
} from "@repo/donation";

// Log a donation
const donation = await createDonation({
  userId: session.user.id,
  organizationId: session.organizationId,
  amount: 100,
  currency: "GBP",
  source: "payroll",
  charityId: "charity_123",
  giftAidEligible: true,
});

// Process company match (admin)
await processMatch({
  donationId: donation.id,
  matchRatio: 2,
  approvedBy: adminUserId,
});

// Generate tax receipt PDF
const pdfUrl = await generateReceipt({
  donationId: donation.id,
});
// Returns: /api/donations/{id}/receipt

GET /api/donations/{id}/receipt
Content-Type: application/pdf