first commit 🎉

2025-10-08 11:37:54 +07:00
commit 4ec61fa51e
61 changed files with 4558 additions and 0 deletions
@@ -0,0 +1,53 @@
+import { openapi } from '@elysiajs/openapi'
+import { OpenAPIV3 } from 'openapi-types'
+import { PORT } from '~/config'
+
+interface OpenApiDocWithTagGroups { 'x-tagGroups': { name: string, tags: string[] } }
+type OpenApiDocumentation = Omit<Partial<OpenAPIV3.Document<OpenApiDocWithTagGroups>>, 'x-express-openapi-additional-middleware' | 'x-express-openapi-validation-strict'>
+
+export const swaggerPlugin = openapi({
+  path: '/swagger',
+  provider: 'scalar',
+  documentation: {
+    'info': {
+      title: 'Backend node Skyrain API Documentation',
+      version: 'v1.0.0',
+    },
+    'tags': [
+      { name: 'Authentication', description: 'Authentication API' },
+      { name: 'Users', description: 'User API' },
+    ],
+    'servers': [
+      {
+        url: 'https://skyrainstudio.com',
+        description: 'production domain',
+      },
+      {
+        url: `http://localhost:${PORT}`,
+        description: 'localhost',
+      },
+      {
+        url: `https://skyrainstudio.com`,
+        description: 'Dev server',
+      },
+    ],
+    // --- Grouping di atas tag ---
+    'x-tagGroups': [
+      { name: 'Auth & IAM', tags: ['Authentication', 'Users'] },
+    ],
+    'components': {
+      securitySchemes: {
+        basicAuth: {
+          type: 'http',
+          scheme: 'basic',
+        },
+        bearerAuth: {
+          type: 'http',
+          scheme: 'bearer',
+          bearerFormat: 'JWT',
+        },
+      },
+    },
+    'security': [{ bearerAuth: [] }],
+  } as OpenApiDocumentation,
+})