feat: add openapi and swagger support

server/api/routers/admin.ts

@@ -27,13 +27,15 @@ import { createAppAuth } from "@octokit/auth-app";
 import { haveGithubRequirements } from "@/server/utils/providers/github";
 
 export const adminRouter = createTRPCRouter({
-	one: adminProcedure.query(async () => {
-		const { sshPrivateKey, ...rest } = await findAdmin();
-		return {
-			haveSSH: !!sshPrivateKey,
-			...rest,
-		};
-	}),
+	one: adminProcedure
+		.meta({ openapi: { method: "GET", path: "/say-hello" } })
+		.query(async () => {
+			const { sshPrivateKey, ...rest } = await findAdmin();
+			return {
+				haveSSH: !!sshPrivateKey,
+				...rest,
+			};
+		}),
 	createUserInvitation: adminProcedure
 		.input(apiCreateUserInvitation)
 		.mutation(async ({ input }) => {

server/api/routers/project.ts

@@ -59,29 +59,6 @@ export const projectRouter = createTRPCRouter({
 			}
 		}),
 
-	createCLI: protectedProcedure
-		.input(apiCreateProject)
-		.mutation(async ({ ctx, input }) => {
-			try {
-				console.log(ctx);
-				if (ctx.user.rol === "user") {
-					await checkProjectAccess(ctx.user.authId, "create");
-				}
-				const project = await createProject(input);
-				if (ctx.user.rol === "user") {
-					await addNewProject(ctx.user.authId, project.projectId);
-				}
-
-				return project;
-			} catch (error) {
-				console.log(error);
-				throw new TRPCError({
-					code: "BAD_REQUEST",
-					message: "Error to create the project",
-					cause: error,
-				});
-			}
-		}),
 	one: protectedProcedure
 		.input(apiFindOneProject)
 		.query(async ({ input, ctx }) => {

server/api/routers/settings.ts

@@ -41,6 +41,7 @@ import {
 } from "../services/settings";
 import { canAccessToTraefikFiles } from "../services/user";
 import { recreateDirectory } from "@/server/utils/filesystem/directory";
+import { doc } from "../root";
 
 export const settingsRouter = createTRPCRouter({
 	reloadServer: adminProcedure.mutation(async () => {
@@ -242,5 +243,22 @@ export const settingsRouter = createTRPCRouter({
 			}
 			return readConfigInPath(input.path);
 		}),
+
+	getOpenApiDocument: protectedProcedure.query((): unknown => {
+		doc.components = {
+			securitySchemes: {
+				bearerAuth: {
+					type: "http",
+					scheme: "bearer",
+					bearerFormat: "JWT",
+				},
+			},
+		};
+		doc.info = {
+			title: "Dokploy API",
+			description: "Endpoints for dokploy",
+			version: getDokployVersion(),
+		};
+		return doc;
+	}),
 });
-// apt-get install apache2-utils