Repository navigation
(feat):welfie referral fork - #60
Open
Ramyabindu wants to merge 3 commits into
Open
Ramyabindu wants to merge 3 commits into
Ramyabindu wants to merge 3 commits into
Conversation
Add the two fork-owned capabilities (referee form + outbound webhook) plus supporting schema, single-use hand-off tokens, qualified-signup reconciliation (hand-off token or email within the attribution window), and abuse controls. - coredb: referral_lead, handoff_token, webhook_endpoint, webhook_delivery (migration 0003) + entity-id prefixes. - @refref/webhooks (new): HMAC signing w/ rotation-overlap verify, DB-backed queue, worker with exponential backoff + dead-letter + replay. - apps/refer: public /refer/invite/:code page + form, consent capture, honeypot, disposable-domain + self-referral checks, hand-off token, redirect to signup. - apps/api: internal /v1/handoff/exchange (single-use), /v1/track/signup emits referral.qualified, optional in-process webhook worker + standalone worker. - Tests: signing (8), abuse (9), plus a real-Postgres e2e script (38 checks). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0195CXEbCdxXHrUk27QYZQHP
…to share and refer
…djust related tests
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request implements the Welfie referral fork, adding major new capabilities to the
refrefhq/refrefcodebase. The key additions are support for referee capture via a public form, outbound webhook delivery, a secure hand-off token flow, email-based reconciliation for late signups, and comprehensive abuse controls. All changes are additive and maintain upstream compatibility. Below are the most important changes grouped by theme:Referral Lead Capture, Hand-off, and Reconciliation:
Outbound Webhook Infrastructure:
Schema and Configuration:
referral_lead,handoff_token,webhook_endpoint,webhook_delivery) and associated migration. Updated.env.exampleand documentation to cover new configuration options for the webhook worker and attribution window. [1] [2]Documentation and Testing:
WELFIE_FORK_IMPLEMENTATION.md, outlining the fork’s architecture, flows, and testing coverage. End-to-end and unit tests were added or extended to cover all major new flows and abuse scenarios.API and Integration:
referral.qualifiedwebhooks. Added a new/v1/handoff/exchangeendpoint for secure token exchange, intended for internal use only. [1] [2]These changes collectively enable robust, secure, and auditable referral flows with cross-device attribution and downstream integration for the Welfie product.