@finndean/linktrace-node
v0.1.2
Published
Official Node.js SDK for LinkTrace server-side conversion tracking.
Readme
@finndean/linktrace-node
Official Node.js SDK for LinkTrace server-side conversion tracking.
Install
npm install @finndean/linktrace-nodeBasic usage
import { LinkTrace, fromExpressRequest, withFormAttribution } from "@finndean/linktrace-node"
const linktrace = new LinkTrace({
apiKey: process.env.LINKTRACE_API_KEY!,
})
await linktrace.trackLead(
withFormAttribution(
fromExpressRequest(req),
req.body,
{
eventName: "signup",
email: "[email protected]",
customerId: "user_123",
},
),
)Auth helpers
The SDK includes auth-provider helpers for common signup and login flows:
trackSupabaseSignuptrackSupabaseLogintrackClerkSignuptrackClerkLogintrackNextAuthSignuptrackNextAuthLogin
Payment helpers
The SDK includes checkout attribution and webhook normalization helpers for:
- Stripe
- Polar
- Lemon Squeezy
Examples:
withStripeCheckoutAttributiontrackStripeCheckoutCompletedwithPolarCheckoutAttributiontrackPolarOrderPaidwithLemonSqueezyCheckoutAttributiontrackLemonSqueezyOrderPaid
Browser attribution
Use the LinkTrace browser script on landing and form pages:
<script async src="https://api.linktrace.cc/api/v1/track/client.js"></script>
<form data-linktrace-track method="post" action="/signup">
...
</form>That script persists lt_click_id and injects it into marked forms so your backend can forward attribution through the SDK. For form posts, prefer withFormAttribution(fromExpressRequest(req), req.body, payload) so cookies still recover attribution if the hidden field is missing.
