Referral Loop — referralEvents + referral/complete

Sovereign Engineering · Part 7

await db.collection('referralEvents').add({
  action,
  referralCode: String(referralCode).slice(0, 64),
  source: source || 'unknown',
  ...(campaignStr ? { campaign: campaignStr } : {}),
  timestamp: Timestamp.now(),
});

/api/referral/complete: Bearer token, isValidReferralCode, referralIndex, new-account window, idempotent (campaign, referee) claims. Campaign default: VIRAL_REFERRAL_CAMPAIGN_DEFAULT — align with viral_moment_v1 in admin.

---

Read the Sovereign Intelligence book or try Pocket Portfolio.