The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.
TypeScript clickhousemysqlnextjsopen-sourceplanetscaleprismatailwindcsstinybirdtypescriptupstashvercel
Use HttpBaseClient for Lemon Squeezy and harden importer flows
Kiran Kc444b3fa2dd6
diff --git a/apps/web/lib/actions/partners/set-lemonsqueezy-token.ts b/apps/web/lib/actions/partners/set-lemonsqueezy-token.tsindex 3ba722e44f..5156abb347 100644--- a/apps/web/lib/actions/partners/set-lemonsqueezy-token.ts+++ b/apps/web/lib/actions/partners/set-lemonsqueezy-token.ts@@ -1,6 +1,6 @@"use server";-import { LemonSqueezyApi } from "@/lib/lemonsqueezy/api";+import { LemonSqueezyClient } from "@/lib/lemonsqueezy/client";import { lemonSqueezyImporter } from "@/lib/lemonsqueezy/importer";import { LemonSqueezyStore } from "@/lib/lemonsqueezy/types";import * as z from "zod/v4";@@ -23,7 +23,7 @@ export const setLemonSqueezyTokenAction = authActionClientrequiredRoles: ["owner", "member"],});- const lemonSqueezyApi = new LemonSqueezyApi({+ const lemonSqueezyApi = new LemonSqueezyClient({apiKey,});diff --git a/apps/web/lib/actions/partners/start-lemonsqueezy-import.ts b/apps/web/lib/actions/partners/start-lemonsqueezy-import.tsindex 6c727303a2..4f186acd17 100644--- a/apps/web/lib/actions/partners/start-lemonsqueezy-import.ts+++ b/apps/web/lib/actions/partners/start-lemonsqueezy-import.ts@@ -2,7 +2,7 @@import { createId } from "@/lib/api/create-id";import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";-import { LemonSqueezyApi } from "@/lib/lemonsqueezy/api";+import { LemonSqueezyClient } from "@/lib/lemonsqueezy/client";import { lemonSqueezyImporter } from "@/lib/lemonsqueezy/importer";import * as z from "zod/v4";import { getProgramOrThrow } from "../../api/programs/get-program-or-throw";@@ -42,7 +42,7 @@ export const startLemonSqueezyImportAction = authActionClientconst credentials = await lemonSqueezyImporter.getCredentials(workspace.id);- const lemonSqueezyApi = new LemonSqueezyApi({+ const lemonSqueezyApi = new LemonSqueezyClient({apiKey: credentials.apiKey,});diff --git a/apps/web/lib/lemonsqueezy/api.ts b/apps/web/lib/lemonsqueezy/client.tssimilarity index 56%rename from apps/web/lib/lemonsqueezy/api.tsrename to apps/web/lib/lemonsqueezy/client.tsindex b61bd37ad7..b2b8607561 100644--- a/apps/web/lib/lemonsqueezy/api.ts+++ b/apps/web/lib/lemonsqueezy/client.ts@@ -1,8 +1,10 @@+import { HttpBaseClient } from "@/lib/http/base-client";import * as z from "zod/v4";import {lemonSqueezyAffiliateSchema,lemonSqueezyCustomerSchema,lemonSqueezyJsonApiListSchema,+ lemonSqueezyListResourcesInputSchema,lemonSqueezyOrderSchema,lemonSqueezyStoreSchema,lemonSqueezySubscriptionInvoiceSchema,@@ -10,6 +12,7 @@ import {import {LemonSqueezyAffiliate,LemonSqueezyCustomer,+ LemonSqueezyJsonApiResource,LemonSqueezyOrder,LemonSqueezyStore,LemonSqueezySubscriptionInvoice,@@ -17,15 +20,8 @@ import {const LEMONSQUEEZY_PAGE_SIZE = 100;-type JsonApiResource = {- type: string;- id: string;- attributes: Record<string, unknown>;- relationships?: Record<string, unknown>;-};-function flattenResource<T extends z.ZodType>(- resource: JsonApiResource,+ resource: LemonSqueezyJsonApiResource,schema: T,extra?: Record<string, unknown>,): z.infer<T> {@@ -37,7 +33,7 @@ function flattenResource<T extends z.ZodType>(}function getRelationshipIds(- resource: JsonApiResource,+ resource: LemonSqueezyJsonApiResource,relationshipName: string,): string[] {const relationship = resource.relationships?.[relationshipName] as@@ -60,62 +56,23 @@ function getRelationshipIds(return [relationship.data.id];}-export class LemonSqueezyApi {- private readonly baseUrl = "https://api.lemonsqueezy.com/v1";+export class LemonSqueezyClient extends HttpBaseClient {+ protected readonly vendor = "Lemon Squeezy";+ protected readonly baseUrl = "https://api.lemonsqueezy.com/v1";+private readonly apiKey: string;constructor({ apiKey }: { apiKey: string }) {+ super();this.apiKey = apiKey;}- private async fetch<T>(- path: string,- searchParams?: URLSearchParams,- ): Promise<T> {- const url = new URL(`${this.baseUrl}${path}`);- if (searchParams) {- searchParams.forEach((value, key) => {- url.searchParams.set(key, value);- });- }-- const controller = new AbortController();- const timeout = setTimeout(() => controller.abort(), 15000);-- let response: Response;-- try {- response = await fetch(url.toString(), {- headers: {- Accept: "application/vnd.api+json",- "Content-Type": "application/vnd.api+json",- Authorization: `Bearer ${this.apiKey}`,- },- signal: controller.signal,- });- } finally {- clearTimeout(timeout);- }-- if (!response.ok) {- const error = await response.text();- console.error("Lemon Squeezy API Error:", error);-- const retryAfter = response.headers.get("Retry-After");- const rateLimitMessage =- response.status === 429- ? ` Rate limited.${retryAfter ? ` Retry after ${retryAfter}s.` : ""}`- : "";-- throw new Error(- `[Lemon Squeezy API] ${- error ||- `Request to ${path} failed with status ${response.status}.${rateLimitMessage}`- }`,- );- }-- return (await response.json()) as T;+ protected buildAuthHeaders() {+ return {+ Accept: "application/vnd.api+json",+ "Content-Type": "application/vnd.api+json",+ Authorization: `Bearer ${this.apiKey}`,+ };}private async listResources({@@ -129,21 +86,16 @@ export class LemonSqueezyApi {page?: number;include?: string;}) {- const searchParams = new URLSearchParams({- "page[number]": page.toString(),- "page[size]": LEMONSQUEEZY_PAGE_SIZE.toString(),+ return await this.get(path, {+ input: {+ "page[number]": page,+ "page[size]": LEMONSQUEEZY_PAGE_SIZE,+ ...(storeId ? { "filter[store_id]": storeId } : {}),+ ...(include ? { include } : {}),+ },+ inputSchema: lemonSqueezyListResourcesInputSchema,+ outputSchema: lemonSqueezyJsonApiListSchema,});-- if (storeId) {- searchParams.set("filter[store_id]", storeId);- }-- if (include) {- searchParams.set("include", include);- }-- const payload = await this.fetch<unknown>(path, searchParams);- return lemonSqueezyJsonApiListSchema.parse(payload);}async listStores(): Promise<LemonSqueezyStore[]> {@@ -197,40 +149,21 @@ export class LemonSqueezyApi {);}- async listCustomerAffiliates({- customerId,- }: {- customerId: string;- }): Promise<LemonSqueezyAffiliate[]> {- const { data } = await this.listResources({- path: `/customers/${customerId}/affiliates`,- });-- return data.map((resource) =>- flattenResource(resource, lemonSqueezyAffiliateSchema),- );- }-async listOrders({storeId,page = 1,- include,}: {storeId: string;page?: number;- include?: string;}): Promise<LemonSqueezyOrder[]> {const { data } = await this.listResources({path: "/orders",storeId,page,- include,});return data.map((resource) =>- flattenResource(resource, lemonSqueezyOrderSchema, {- subscription_ids: getRelationshipIds(resource, "subscriptions"),- }),+ flattenResource(resource, lemonSqueezyOrderSchema),);}diff --git a/apps/web/lib/lemonsqueezy/import-commissions.ts b/apps/web/lib/lemonsqueezy/import-commissions.tsindex 29aa8c70f5..821405a9af 100644--- a/apps/web/lib/lemonsqueezy/import-commissions.ts+++ b/apps/web/lib/lemonsqueezy/import-commissions.ts@@ -15,7 +15,7 @@ import { recordSaleWithTimestamp } from "../tinybird/record-sale";import { LeadEventTB } from "../types";import { redis } from "../upstash";import { clickEventSchemaTB } from "../zod/schemas/clicks";-import { LemonSqueezyApi } from "./api";+import { LemonSqueezyClient } from "./client";import { LEMONSQUEEZY_MAX_BATCHES, lemonSqueezyImporter } from "./importer";import {LemonSqueezyImportPayload,@@ -37,61 +37,10 @@ type SaleEvent = {metadata: Record<string, unknown>;};-function resolveAmountUsd({- amount,- amountUsd,- currency,- fxRates,-}: {- amount: number;- amountUsd: number | null | undefined;- currency: string;- fxRates: Record<string, string> | null;-}): number | null {- if (amountUsd != null) {- return amountUsd;- }-- if (currency.toUpperCase() === "USD") {- return amount;- }-- if (!fxRates) {- return null;- }-- const converted = convertCurrencyWithFxRates({- currency,- amount,- fxRates,- });-- return converted.currency.toUpperCase() === "USD" ? converted.amount : null;-}-// Initial referral is on the Order; renewals/updates are on Invoices.// Skip billing_reason: initial (no referral) and missing/unknown reasons.const IMPORTABLE_INVOICE_REASONS = new Set(["renewal", "updated"]);-const toDubStatus = (status: string): CommissionStatus => {- switch (status) {- case "paid":- return "paid";- case "pending":- return "pending";- case "refunded":- case "partial_refund":- return "refunded";- case "fraudulent":- return "fraud";- case "void":- case "failed":- return "canceled";- default:- return "pending";- }-};-export async function importCommissions(payload: LemonSqueezyImportPayload) {const {importId,@@ -106,6 +55,12 @@ export async function importCommissions(payload: LemonSqueezyImportPayload) {where: {id: programId,},+ select: {+ id: true,+ name: true,+ workspaceId: true,+ domain: true,+ },});if (!program) {@@ -121,7 +76,7 @@ export async function importCommissions(payload: LemonSqueezyImportPayload) {const { apiKey } = await lemonSqueezyImporter.getCredentials(program.workspaceId,);- const lemonSqueezyApi = new LemonSqueezyApi({ apiKey });+ const lemonSqueezyApi = new LemonSqueezyClient({ apiKey });const fxRates = await redis.hgetall<Record<string, string>>("fxRates:usd");@@ -218,18 +173,20 @@ async function listOrderSaleEvents({storeId,page,}: {- lemonSqueezyApi: LemonSqueezyApi;+ lemonSqueezyApi: LemonSqueezyClient;storeId: string;page: number;}): Promise<{ saleEvents: SaleEvent[]; pageEmpty: boolean }> {const orders = await lemonSqueezyApi.listOrders({storeId,page,- include: "subscriptions",});if (orders.length === 0) {- return { saleEvents: [], pageEmpty: true };+ return {+ saleEvents: [],+ pageEmpty: true,+ };}// All attributed Orders: subscription first period + one-time (LS payouts use Order)@@ -256,7 +213,10 @@ async function listOrderSaleEvents({metadata: order as unknown as Record<string, unknown>,}));- return { saleEvents, pageEmpty: false };+ return {+ saleEvents,+ pageEmpty: false,+ };}async function listInvoiceSaleEvents({@@ -264,7 +224,7 @@ async function listInvoiceSaleEvents({storeId,page,}: {- lemonSqueezyApi: LemonSqueezyApi;+ lemonSqueezyApi: LemonSqueezyClient;storeId: string;page: number;}): Promise<{ saleEvents: SaleEvent[]; pageEmpty: boolean }> {@@ -274,7 +234,10 @@ async function listInvoiceSaleEvents({});if (invoices.length === 0) {- return { saleEvents: [], pageEmpty: true };+ return {+ saleEvents: [],+ pageEmpty: true,+ };}const saleEvents = invoices@@ -305,7 +268,10 @@ async function listInvoiceSaleEvents({metadata: invoice as unknown as Record<string, unknown>,}));- return { saleEvents, pageEmpty: false };+ return {+ saleEvents,+ pageEmpty: false,+ };}async function processSaleEvents({@@ -338,6 +304,7 @@ async function processSaleEvents({},},}),+prisma.customer.findMany({where: {projectId: program.workspaceId,@@ -363,7 +330,7 @@ async function processSaleEvents({const saleChunks = chunk(saleEvents, 10);for (const saleChunk of saleChunks) {- await Promise.allSettled(+ const results = await Promise.allSettled(saleChunk.map((saleEvent) =>createCommission({program,@@ -376,6 +343,28 @@ async function processSaleEvents({}),),);++ const failures = results.flatMap((result, index) =>+ result.status === "rejected"+ ? [{ saleEvent: saleChunk[index], reason: result.reason }]+ : [],+ );++ if (failures.length > 0) {+ await logImportError(+ failures.map(({ saleEvent, reason }) => ({+ workspace_id: program.workspaceId,+ import_id: importId,+ source: "lemonsqueezy" as const,+ entity: "commission" as const,+ entity_id: saleEvent.invoiceId,+ code: "TRANSACTION_NOT_FOUND" as const,+ message: `Failed to import commission ${saleEvent.invoiceId}: ${+ reason instanceof Error ? reason.message : String(reason)+ }`,+ })),+ );+ }}}@@ -405,9 +394,6 @@ async function createCommission({};const status = toDubStatus(saleEvent.status);- if (!status) {- return;- }const existingCommission = await prisma.commission.findUnique({where: {@@ -614,3 +600,54 @@ async function createCommission({programId: program.id,});}++function resolveAmountUsd({+ amount,+ amountUsd,+ currency,+ fxRates,+}: {+ amount: number;+ amountUsd: number | null | undefined;+ currency: string;+ fxRates: Record<string, string> | null;+}): number | null {+ if (amountUsd != null) {+ return amountUsd;+ }++ if (currency.toUpperCase() === "USD") {+ return amount;+ }++ if (!fxRates) {+ return null;+ }++ const converted = convertCurrencyWithFxRates({+ currency,+ amount,+ fxRates,+ });++ return converted.currency.toUpperCase() === "USD" ? converted.amount : null;+}++function toDubStatus(status: string): CommissionStatus {+ switch (status) {+ case "paid":+ return CommissionStatus.paid;+ case "pending":+ return CommissionStatus.pending;+ case "refunded":+ case "partial_refund":+ return CommissionStatus.refunded;+ case "fraudulent":+ return CommissionStatus.fraud;+ case "void":+ case "failed":+ return CommissionStatus.canceled;+ default:+ return CommissionStatus.pending;+ }+}diff --git a/apps/web/lib/lemonsqueezy/import-customers.ts b/apps/web/lib/lemonsqueezy/import-customers.tsindex 68f074cc65..25a6c6dbd0 100644--- a/apps/web/lib/lemonsqueezy/import-customers.ts+++ b/apps/web/lib/lemonsqueezy/import-customers.ts@@ -4,10 +4,10 @@ import { Customer, Link, Project } from "@prisma/client";import { createId } from "../api/create-id";import { updateLinkStatsForImporter } from "../api/links/update-link-stats-for-importer";import { syncPartnerLinksStats } from "../api/partners/sync-partner-links-stats";-import { recordClick, recordLeadWithTimestamp } from "../tinybird";+import { recordLeadWithTimestamp } from "../tinybird";import { logImportError } from "../tinybird/log-import-error";-import { clickEventSchemaTB } from "../zod/schemas/clicks";-import { LemonSqueezyApi } from "./api";+import { recordFakeClick } from "../tinybird/record-fake-click";+import { LemonSqueezyClient } from "./client";import { LEMONSQUEEZY_MAX_BATCHES, lemonSqueezyImporter } from "./importer";import { LemonSqueezyCustomer, LemonSqueezyImportPayload } from "./types";@@ -18,7 +18,11 @@ export async function importCustomers(payload: LemonSqueezyImportPayload) {where: {id: programId,},- include: {+ select: {+ id: true,+ name: true,+ domain: true,+ url: true,workspace: {select: {id: true,@@ -41,7 +45,7 @@ export async function importCustomers(payload: LemonSqueezyImportPayload) {const { workspace } = program;const { apiKey } = await lemonSqueezyImporter.getCredentials(workspace.id);- const lemonSqueezyApi = new LemonSqueezyApi({ apiKey });+ const lemonSqueezyApi = new LemonSqueezyClient({ apiKey });let currentPage = page;let hasMore = true;@@ -84,6 +88,7 @@ export async function importCustomers(payload: LemonSqueezyImportPayload) {key: true,domain: true,url: true,+ projectId: true,partnerId: true,programId: true,lastLeadAt: true,@@ -164,7 +169,14 @@ async function createCustomer({customer: LemonSqueezyCustomer;link?: Pick<Link,- "id" | "key" | "domain" | "url" | "partnerId" | "programId" | "lastLeadAt"+ | "id"+ | "key"+ | "domain"+ | "url"+ | "projectId"+ | "partnerId"+ | "programId"+ | "lastLeadAt">;importId: string;}) {@@ -200,29 +212,17 @@ async function createCustomer({const clickedAt = new Date(customer.created_at || Date.now());- const dummyRequest = new Request(link.url, {- headers: new Headers({- "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",- "x-forwarded-for": "127.0.0.1",- "x-vercel-ip-country": customer.country || "US",- "x-vercel-ip-country-region": "CA",- "x-vercel-ip-continent": "NA",- }),- });+ let clickEvent: Awaited<ReturnType<typeof recordFakeClick>>;- const clickData = await recordClick({- req: dummyRequest,- clickId: nanoid(16),- workspaceId: workspace.id,- linkId: link.id,- domain: link.domain,- key: link.key,- url: link.url,- skipRatelimit: true,- timestamp: clickedAt.toISOString(),- });-- if (!clickData) {+ try {+ clickEvent = await recordFakeClick({+ link,+ customer: {+ country: customer.country,+ },+ timestamp: clickedAt.toISOString(),+ });+ } catch {await logImportError({...commonImportLogInputs,code: "CLICK_NOT_FOUND",@@ -232,12 +232,6 @@ async function createCustomer({return;}- const clickEvent = clickEventSchemaTB.parse({- ...clickData,- bot: 0,- qr: 0,- });-let createdCustomer: Customer | null = null;try {diff --git a/apps/web/lib/lemonsqueezy/import-partners.ts b/apps/web/lib/lemonsqueezy/import-partners.tsindex 0f9fa032fe..37583853aa 100644--- a/apps/web/lib/lemonsqueezy/import-partners.ts+++ b/apps/web/lib/lemonsqueezy/import-partners.ts@@ -6,7 +6,7 @@ import { generatePartnerLink } from "../api/partners/generate-partner-link";import { logImportError } from "../tinybird/log-import-error";import { WorkspaceProps } from "../types";import { DEFAULT_PARTNER_GROUP } from "../zod/schemas/groups";-import { LemonSqueezyApi } from "./api";+import { LemonSqueezyClient } from "./client";import { LEMONSQUEEZY_MAX_BATCHES, lemonSqueezyImporter } from "./importer";import { LemonSqueezyAffiliate, LemonSqueezyImportPayload } from "./types";@@ -17,7 +17,13 @@ export async function importPartners(payload: LemonSqueezyImportPayload) {where: {id: programId,},- include: {+ select: {+ id: true,+ name: true,+ domain: true,+ url: true,+ workspaceId: true,+ defaultFolderId: true,groups: {select: {id: true,@@ -60,7 +66,7 @@ export async function importPartners(payload: LemonSqueezyImportPayload) {const workspace = program.workspace as WorkspaceProps;const { apiKey } = await lemonSqueezyImporter.getCredentials(workspace.id);- const lemonSqueezyApi = new LemonSqueezyApi({ apiKey });+ const lemonSqueezyApi = new LemonSqueezyClient({ apiKey });let currentPage = page;let hasMore = true;diff --git a/apps/web/lib/lemonsqueezy/schemas.ts b/apps/web/lib/lemonsqueezy/schemas.tsindex 57a304ddba..422662eb64 100644--- a/apps/web/lib/lemonsqueezy/schemas.ts+++ b/apps/web/lib/lemonsqueezy/schemas.ts@@ -17,7 +17,7 @@ export const lemonSqueezyImportPayloadSchema = z.object({resource: z.enum(["orders", "subscription-invoices"]).optional(),});-const jsonApiResourceSchema = z.object({+export const lemonSqueezyJsonApiResourceSchema = z.object({type: z.string(),id: z.string(),attributes: z.record(z.string(), z.unknown()),@@ -25,8 +25,8 @@ const jsonApiResourceSchema = z.object({});export const lemonSqueezyJsonApiListSchema = z.object({- data: z.array(jsonApiResourceSchema),- included: z.array(jsonApiResourceSchema).optional(),+ data: z.array(lemonSqueezyJsonApiResourceSchema),+ included: z.array(lemonSqueezyJsonApiResourceSchema).optional(),meta: z.object({page: z@@ -51,6 +51,14 @@ export const lemonSqueezyJsonApiListSchema = z.object({.optional(),});+// GET list endpoints — JSON:API pagination / filter / include query params+export const lemonSqueezyListResourcesInputSchema = z.object({+ "page[number]": z.number(),+ "page[size]": z.number(),+ "filter[store_id]": z.string().optional(),+ include: z.string().optional(),+});+export const lemonSqueezyStoreSchema = z.object({id: z.string(),name: z.string(),@@ -126,8 +134,6 @@ export const lemonSqueezyOrderSchema = z.object({price: z.number().nullish(),}).nullish(),- // Populated when listing with include=subscriptions- subscription_ids: z.array(z.string()).default([]),status: z.string(),refunded: z.boolean().nullish(),refunded_at: z.string().nullish(),diff --git a/apps/web/lib/lemonsqueezy/types.ts b/apps/web/lib/lemonsqueezy/types.tsindex 3706b240f2..712c261ba8 100644--- a/apps/web/lib/lemonsqueezy/types.ts+++ b/apps/web/lib/lemonsqueezy/types.ts@@ -3,6 +3,7 @@ import {lemonSqueezyAffiliateSchema,lemonSqueezyCustomerSchema,lemonSqueezyImportPayloadSchema,+ lemonSqueezyJsonApiResourceSchema,lemonSqueezyOrderSchema,lemonSqueezyStoreSchema,lemonSqueezySubscriptionInvoiceSchema,@@ -16,6 +17,10 @@ export type LemonSqueezyImportPayload = z.infer<typeof lemonSqueezyImportPayloadSchema>;+export type LemonSqueezyJsonApiResource = z.infer<+ typeof lemonSqueezyJsonApiResourceSchema+>;+export type LemonSqueezyStore = z.infer<typeof lemonSqueezyStoreSchema>;export type LemonSqueezyAffiliate = z.infer<typeof lemonSqueezyAffiliateSchema>;