The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.
TypeScript clickhousemysqlnextjsopen-sourceplanetscaleprismatailwindcsstinybirdtypescriptupstashvercel
import { qstash } from "@/lib/cron";
import { prisma } from "@/lib/prisma";
import { isNotHostedImage, storage } from "@/lib/storage";
import { recordLink } from "@/lib/tinybird";
import { ProcessedLinkProps } from "@/lib/types";
import { publishWorkspaceLinksUsageEvent } from "@/lib/upstash/redis-streams/workspace-links-usage";
import {
APP_DOMAIN_WITH_NGROK,
getParamsFromURL,
R2_URL,
truncate,
} from "@dub/utils";
import { linkConstructorSimple } from "@dub/utils/src/functions/link-constructor";
import { Prisma } from "@prisma/client";
import { waitUntil } from "@vercel/functions";
import { createId } from "../create-id";
import { combineTagIds } from "../tags/combine-tag-ids";
import { withPrismaRetry } from "../utils/with-prisma-retry";
import { scheduleABTestCompletion } from "./ab-test-scheduler";
import { linkCache } from "./cache";
import { encodeKeyIfCaseSensitive } from "./case-sensitivity";
import { includeTags } from "./include-tags";
import { transformLink } from "./utils";
export async function createLink(link: ProcessedLinkProps) {
let {
key,
url,
expiresAt,
title,
description,
image,
proxy,
geo,
publicStats,
testVariants,
testStartedAt,
testCompletedAt,
} = link;
const combinedTagIds = combineTagIds(link);
const { utm_source, utm_medium, utm_campaign, utm_term, utm_content } =
getParamsFromURL(url);
const { tagId, tagIds, tagNames, webhookIds, ...rest } = link;
key = encodeKeyIfCaseSensitive({
domain: link.domain,
key,
});
const response = await withPrismaRetry(() =>
prisma.link.create({
data: {
...rest,
id: createId({ prefix: "link_" }),
key,
shortLink: linkConstructorSimple({ domain: link.domain, key }),
title: truncate(title, 120),
description: truncate(description, 240),
// if it's an uploaded image, make this null first because we'll update it later
image: proxy && image && isNotHostedImage(image) ? null : image,
utm_source,
utm_medium,
utm_campaign,
utm_term,
utm_content,
expiresAt: expiresAt ? new Date(expiresAt) : null,
geo: geo || Prisma.DbNull,
testVariants: testVariants || Prisma.DbNull,
testCompletedAt: testCompletedAt ? new Date(testCompletedAt) : null,
testStartedAt: testStartedAt ? new Date(testStartedAt) : null,
// Associate tags by tagNames
...(tagNames?.length &&
link.projectId && {
tags: {
create: tagNames.map((tagName, idx) => ({
tag: {
connect: {
name_projectId: {
name: tagName,
projectId: link.projectId as string,
},
},
},
createdAt: new Date(new Date().getTime() + idx * 100), // increment by 100ms for correct order
})),
},
}),
// Associate tags by IDs (takes priority over tagNames)
...(combinedTagIds &&
combinedTagIds.length > 0 && {
tags: {
createMany: {
data: combinedTagIds.map((tagId, idx) => ({
tagId,
createdAt: new Date(new Date().getTime() + idx * 100), // increment by 100ms for correct order
})),
},
},
}),
// Webhooks
...(webhookIds &&
webhookIds.length > 0 && {
webhooks: {
createMany: {
data: webhookIds.map((webhookId) => ({
webhookId,
})),
},
},
}),
// Shared dashboard
...(publicStats && {
dashboard: {
create: {
id: createId({ prefix: "dash_" }),
projectId: link.projectId,
userId: link.userId,
},
},
}),
},
include: {
...includeTags,
webhooks: webhookIds ? true : false,
},
}),
);
const uploadedImageUrl = `${R2_URL}/images/${response.id}`;
waitUntil(
(async () => {
await Promise.allSettled([
// Cache link in Redis
linkCache.set(response),
// Record link in Tinybird
recordLink(response),
// Upload image to R2 and update the link with the uploaded image URL when
// proxy is enabled and image is set and is not a hosted image URL
...(proxy && image && isNotHostedImage(image)
? [
// upload image to R2
storage.upload({
key: `images/${response.id}`,
body: image,
opts: {
width: 1200,
height: 630,
},
}),
// update the null image we set earlier to the uploaded image URL
prisma.link.update({
where: {
id: response.id,
},
data: {
image: uploadedImageUrl,
},
}),
]
: []),
// Delete public links after 30 mins
!response.userId &&
qstash.publishJSON({
url: `${APP_DOMAIN_WITH_NGROK}/api/cron/links/delete`,
// delete after 30 mins
delay: 30 * 60,
body: {
linkId: response.id,
},
}),
// Update links usage for workspace
link.projectId &&
publishWorkspaceLinksUsageEvent({
workspaceId: link.projectId,
linksCount: 1,
timestamp: new Date().toISOString(),
}),
// Schedule AB test completion
testVariants && testCompletedAt && scheduleABTestCompletion(response),
]);
})(),
);
return {
...transformLink(response),
// optimistically set the image URL to the uploaded image URL
image:
proxy && image && isNotHostedImage(image)
? uploadedImageUrl
: response.image,
};
}