docs: refactor types and add documentation

app/api/openai/raw.ts

@@ -1,4 +1,3 @@
-import { OpenAiRawRequestParams } from "@/misc/apiRoutes";
 import { NextApiRequest, NextApiResponse } from "next";
 import OpenAI from "openai";
 const openai = new OpenAI();
@@ -18,3 +17,11 @@ const _handler = async (req: NextApiRequest, res: NextApiResponse) => {
 
     res.status(200).json({ data: completion.choices[0].message });
 };
+
+export interface OpenAiRawRequestParams {
+    prompt: string;
+}
+
+export interface OpenAiRawResponseParams {
+    data: string;
+}

docs/openai/raw.md

@@ -0,0 +1,10 @@
+# POST `/openai/raw`
+```ts
+export interface OpenAiRawRequestParams {
+    prompt: string;
+}
+
+export interface OpenAiRawResponseParams {
+    data: string;
+}
+```

misc/apiRoutes.ts

@@ -1,15 +1,12 @@
+import { OpenAiRawRequestParams, OpenAiRawResponseParams } from '@/app/api/openai/raw';
 import axios from 'axios';
 
 const api = axios.create();
 
 export const endpoints = {
     openAi: {
-        getRawResponse: async (params: OpenAiRawRequestParams) => {
+        getRawResponse: async (params: OpenAiRawRequestParams): Promise<OpenAiRawResponseParams> => {
             return api.post('/openai/raw', params);
         },
     }
-};
-
-export interface OpenAiRawRequestParams {
-    prompt: string;
-}
+};