update docs

apps/docs/api-reference/endpoint/bulk-create-links.mdx

@@ -1,5 +1,6 @@
 ---
 openapi: post /links/bulk
+description: Bulk create up to 100 links for the authenticated project.
 ---
 
 <Note>

apps/docs/api-reference/endpoint/create-a-new-link.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: post /links
+description: Create a new link for the authenticated project.
 ---

apps/docs/api-reference/endpoint/create-a-new-tag.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: post /projects/{projectSlug}/tags
+description: Create a new tag for the authenticated project.
 ---

apps/docs/api-reference/endpoint/delete-a-link.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: delete /links/{linkId}
+description: Delete a link for the authenticated project.
 ---

apps/docs/api-reference/endpoint/edit-a-link.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: put /links/{linkId}
+description: Edit a link for the authenticated project.
 ---

apps/docs/api-reference/endpoint/retrieve-a-link.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: get /links/info
+description: Retrieve the info for a link from their domain and key.
 ---

apps/docs/api-reference/endpoint/retrieve-a-list-of-links.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: get /links
+description: Retrieve a list of links for the authenticated project. The list will be paginated and the provided query parameters allow filtering the returned links.
 ---

apps/docs/api-reference/endpoint/retrieve-a-list-of-projects.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: get /projects
+description: Retrieve a list of projects for the authenticated user.
 ---

apps/docs/api-reference/endpoint/retrieve-a-list-of-tags.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: get /projects/{projectSlug}/tags
+description: Retrieve a list of tags for the authenticated project.
 ---

apps/docs/api-reference/endpoint/retrieve-a-project.mdx

@@ -1,3 +1,4 @@
 ---
 openapi: get /projects/{projectSlug}
+description: Retrieve a project for the authenticated user.
 ---

apps/web/app/api/route.ts

@@ -263,7 +263,7 @@ export function GET(): NextResponse<OpenAPIV3.Document> {
       },
       "/links/{linkId}": {
         put: {
-          description: "Edit link for the authenticated project.",
+          description: "Edit a link for the authenticated project.",
           operationId: "editLink",
           security: [
             {

apps/web/scripts/download-links.ts

@@ -2,6 +2,7 @@ import "dotenv-flow/config";
 import prisma from "@/lib/prisma";
 import * as Papa from "papaparse";
 import * as fs from "fs";
+import { linkConstructor } from "./utils";
 
 const projectId = "xxx";
 
@@ -15,14 +16,21 @@ async function main() {
       domain: true,
       url: true,
     },
+    orderBy: {
+      createdAt: "asc",
+    },
+    skip: 99999,
   });
 
   const processedLinks = links.map(({ key, domain, url }) => ({
-    link: `${domain}:${key}`,
+    link: linkConstructor({
+      domain,
+      key,
+    }),
     url,
   }));
 
-  fs.writeFileSync("links.csv", Papa.unparse(processedLinks));
+  fs.writeFileSync("xxx.csv", Papa.unparse(processedLinks));
 }
 
 main();

apps/web/scripts/download-top-links.ts

@@ -0,0 +1,26 @@
+import "dotenv-flow/config";
+import * as Papa from "papaparse";
+import * as fs from "fs";
+import { linkConstructor } from "./utils";
+import { getStats } from "@/lib/stats";
+
+const domain = "xxx";
+
+async function main() {
+  const topLinks = await getStats({
+    domain,
+    endpoint: "top_links",
+  });
+
+  const processedLinks = topLinks.map(({ domain, key, clicks }) => ({
+    link: linkConstructor({
+      domain,
+      key,
+    }),
+    clicks,
+  }));
+
+  fs.writeFileSync("xxx.csv", Papa.unparse(processedLinks));
+}
+
+main();