Skip to content

docs: send the buyer's email on every lead - #290

Merged
sonpiaz merged 1 commit into
mainfrom
docs/lead-email-fallback
Nov 16, 2026
Merged

sonpiaz merged 1 commit into
mainfrom
docs/lead-email-fallback

Conversation

@sonpiaz

@sonpiaz sonpiaz commented Nov 16, 2026

Copy link
Copy Markdown
Member

What changed

  • Track Lead (api-reference/track-lead): the email field now says to send the buyer's email on every lead, what Affitor keeps (a one-way hash and a masked form, only when the customer has none yet), and why: a Stripe Checkout payment without a click id is matched to the customer by its checkout email. A provisional browser lead does not save it.
  • skill.md §2 (identifier contract): one paragraph, send the email on every lead (signup(customerKey, email), trackLead({ email }), email on the wire), with the same reason.

No new endpoint, field or behaviour: the email field already exists. The server-to-server sale endpoint is not changed here.

Sources (read at the current release)

  • Lead hashing and write-once save: CMS src/api/affiliate-lead-event/services/affiliate-lead-event.ts:189-200 (hash + mask, saved only when the customer has none); provisional browser lead stores only the lead event hash, no customer write (:105-127).
  • Hash and mask format: CMS src/utils/privacy-helpers.ts:16-44 (sha256 of the lowercased, trimmed address; j***@example.com).
  • Stripe email match when no click id is present: CMS src/api/webhook-distributor/services/client-reference.ts:47-54 (account customer by email hash first), chain step 2 webhook-distributor.ts:1311-1351.
  • SDK: published @affitor/sdk 2.1.4, dist/server.d.ts:45 (trackLead email?), dist/index.d.ts:22 (signup(customerKey, email)).

Checks

  • tracking-contract check passes on this head (48 statements, 27 pins).
  • Build and agent-surface checks: CI on this PR.
  • No media needed.

… sale with the right partner

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
affitor-docs Ready Ready Preview Nov 16, 2026 10:31pm UTC

Request Review

@sonpiaz
sonpiaz merged commit c89b1a3 into main Nov 16, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 8bf4295c Deployed Nov 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant