refactor: Api plugin system

Author: aXenDeveloper

apps/docs/content/docs/dev/meta.json

@@ -9,10 +9,11 @@
     "structure",
     "debugging",
     "swagger",
+    "---Plugins---",
+    "modules",
     "---Framework---",
     "auth",
     "fetcher",
-    "modules",
     "routes",
     "---API---",
     "sso",

apps/docs/package.json

@@ -14,6 +14,7 @@
     "fumadocs-mdx": "^11.6.0",
     "fumadocs-ui": "^15.2.8",
     "lucide-react": "^0.488.0",
+    "motion": "^12.7.4",
     "next": "^15.3.1",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",

apps/web/package.json

@@ -33,7 +33,8 @@
     "react-hook-form": "^7.55.0",
     "sonner": "^2.0.3",
     "vitnode": "workspace:*",
-    "zod": "^3.24.3"
+    "zod": "^3.24.3",
+    "vitnode-blog": "workspace:*"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.4",

packages/vitnode/src/api/lib/module.ts

@@ -12,20 +12,15 @@ export interface ModuleApi<
   plugin: P;
 }
 
-export function createModuleApi<
-  E extends Env,
-  S extends Schema = Schema,
-  N extends string = string,
-  P extends string = string,
->({
+export function createModuleApi<E extends Env, S extends Schema = Schema>({
   name,
   plugin,
   routes,
 }: {
-  name: N;
-  plugin: P;
+  name: string;
+  plugin: string;
   routes: OpenAPIHono<E, S, string>;
-}): ModuleApi<E, S, N, P> {
+}) {
   const current = routes;
 
   return {

packages/vitnode/src/api/lib/route.ts

@@ -1,3 +1,4 @@
+import { PluginConfig } from '@/plugin.config';
 import { createRoute as createRouteHono, RouteConfig } from '@hono/zod-openapi';
 import { MiddlewareHandler } from 'hono';
 
@@ -15,11 +16,11 @@ export function createApiRoute<
   },
 >({
   isAuth,
-  plugin,
+  pluginConfig,
   ...routeConfig
 }: R & {
   isAuth?: boolean;
-  plugin: string;
+  pluginConfig: PluginConfig;
 }): R & {
   getRoutingPath: () => RoutingPath<R['path']>;
 } {
@@ -28,10 +29,7 @@ export function createApiRoute<
       ? routeConfig.middleware
       : [routeConfig.middleware]
     : [];
-  const tags: string[] = [
-    plugin.charAt(0).toUpperCase() + plugin.slice(1),
-    ...(routeConfig.tags ?? []),
-  ];
+  const tags: string[] = [pluginConfig.name, ...(routeConfig.tags ?? [])];
 
   return createRouteHono({
     middleware: isAuth ? [sessionMiddleware(), ...middlewareFromConfig] : [],

packages/vitnode/src/api/modules/admin/routes/session.route.ts

@@ -7,6 +7,10 @@ const route = createApiRoute({
   method: 'get',
   description: 'Verify admin session',
   plugin: 'core',
+  pluginConfig: {
+    id: 'core',
+    name: 'Core',
+  },
   path: '/',
   responses: {
     200: {

packages/vitnode/src/api/modules/middleware/middleware.module.ts

@@ -1,40 +1,12 @@
 import { createModuleApi } from '@/api/lib/module';
-import { createApiRoute } from '@/api/lib/route';
-import { EmailModel } from '@/api/models/email';
-import { OpenAPIHono, z } from '@hono/zod-openapi';
+import { OpenAPIHono } from '@hono/zod-openapi';
 
 import { middlewareRoute } from './route';
 
 export const middlewareModule = createModuleApi({
   name: 'middleware',
   plugin: 'core',
-  routes: new OpenAPIHono().route('/', middlewareRoute).openapi(
-    createApiRoute({
-      method: 'post',
-      plugin: 'core',
-      path: '/test',
-      responses: {
-        200: {
-          content: {
-            'application/json': {
-              schema: z.string(),
-            },
-          },
-          description: 'test',
-        },
-      },
-    }),
-    async c => {
-      const email = new EmailModel(c);
-      await email.send({
-        to: 'ithereplay@gmail.com',
-        subject: 'test',
-        html: 'test',
-      });
-
-      return c.json('Hello, world!');
-    },
-  ),
+  routes: new OpenAPIHono().route('/', middlewareRoute),
 });
 
 export type MiddlewareTypes = typeof middlewareModule;

packages/vitnode/src/api/modules/middleware/route.ts

@@ -5,7 +5,10 @@ import { z } from 'zod';
 
 const route = createApiRoute({
   method: 'get',
-  plugin: 'core',
+  pluginConfig: {
+    id: 'core',
+    name: 'Core',
+  },
   description: 'Middleware route with user authentication',
   path: '/',
   responses: {

packages/vitnode/src/api/modules/users/routes/session.route.ts

@@ -7,7 +7,10 @@ import { z } from 'zod';
 const route = createApiRoute({
   method: 'get',
   description: 'Verify session',
-  plugin: 'core',
+  pluginConfig: {
+    id: 'core',
+    name: 'Core',
+  },
   path: '/',
   responses: {
     200: {

packages/vitnode/src/api/modules/users/routes/sign-in.route.ts

@@ -8,7 +8,10 @@ import { z } from 'zod';
 const route = createApiRoute({
   method: 'post',
   description: 'Sign in with email and password',
-  plugin: 'core',
+  pluginConfig: {
+    id: 'core',
+    name: 'Core',
+  },
   path: '/',
   request: {
     body: {