Merge pull request #9 from dev-five-git/impl-middleware

Impl middleware

Author: owjs3901

.changepacks/changepack_log_VE4jXJ9vrl89A6FV122nZ.json

@@ -0,0 +1 @@
+{"changes":{"packages/utils/package.json":"Patch","packages/core/package.json":"Patch","packages/vite-plugin/package.json":"Patch","packages/generator/package.json":"Patch","packages/fetch/package.json":"Patch","packages/next-plugin/package.json":"Patch","packages/rsbuild-plugin/package.json":"Patch","packages/webpack-plugin/package.json":"Patch"},"note":"Implement middleware","date":"2025-12-01T11:37:14.879632Z"}

examples/next/app/page.tsx

@@ -19,6 +19,9 @@ export default function Home() {
     api
       .get('getUserById', {
         params: { id: 1 },
+        query: {
+          name: 'John Doe',
+        },
       })
       .then((res) => {
         console.log(res)

examples/next/openapi.json

@@ -65,6 +65,14 @@
             "schema": {
               "type": "integer"
             }
+          },
+          {
+            "name": "name",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
           }
         ],
         "responses": {

packages/core/src/additional.ts

@@ -1,3 +1,5 @@
+import type { Middleware } from './middleware'
+
 export type Additional<
   T extends string,
   Target extends object,
@@ -9,6 +11,8 @@ export type RequiredOptions<T extends object> = keyof T extends undefined
 export type DevupApiRequestInit = Omit<RequestInit, 'body'> & {
   body?: object | RequestInit['body']
   params?: Record<string, string | number | boolean | null | undefined>
+  query?: Record<string, string | number | boolean | null | undefined>
+  middleware?: Middleware[]
 }
 
 // biome-ignore lint/suspicious/noExplicitAny: any is used to allow for flexibility in the type

packages/core/src/index.ts

@@ -1,5 +1,6 @@
 export * from './additional'
 export * from './api-struct'
+export * from './middleware'
 export * from './options'
 export * from './url-map'
 export * from './utils'

packages/core/src/middleware.ts

@@ -0,0 +1,38 @@
+import type { DevupApiRequestInit } from './additional'
+import type { PromiseOr } from './utils'
+
+export interface MiddlewareCallbackParams {
+  request: Request
+  schemaPath: string
+  params?: Record<string, unknown>
+  query?: Record<string, unknown>
+  headers?: DevupApiRequestInit['headers']
+  body?: DevupApiRequestInit['body']
+}
+
+type MiddlewareOnRequest = (
+  params: MiddlewareCallbackParams,
+) => PromiseOr<undefined | Request | Response>
+type MiddlewareOnResponse = (
+  params: MiddlewareCallbackParams & { response: Response },
+) => PromiseOr<undefined | Error | Response>
+type MiddlewareOnError = (
+  params: MiddlewareCallbackParams & { error: unknown },
+) => PromiseOr<undefined | Error | Response>
+
+export type Middleware =
+  | {
+      onRequest: MiddlewareOnRequest
+      onResponse?: MiddlewareOnResponse
+      onError?: MiddlewareOnError
+    }
+  | {
+      onRequest?: MiddlewareOnRequest
+      onResponse: MiddlewareOnResponse
+      onError?: MiddlewareOnError
+    }
+  | {
+      onRequest?: MiddlewareOnRequest
+      onResponse?: MiddlewareOnResponse
+      onError: MiddlewareOnError
+    }

packages/core/src/utils.ts

@@ -4,3 +4,5 @@ export type ConditionalKeys<T, F = string> = keyof T extends undefined
 export type ConditionalScope<T, K extends string> = K extends keyof T
   ? T[K]
   : object
+
+export type PromiseOr<T> = Promise<T> | T