feat: add meta field to API schema interfaces for internal metadata

Author: NoOne7135

adminforth/servers/express.ts

@@ -458,6 +458,7 @@ class ExpressServer implements IExpressHttpServer {
           description: schema.description,
           request_schema: schema.request,
           response_schema: schema.response,
+          meta: schema.meta,
           handler: async () => null,
         });
       });

adminforth/servers/openapi.ts

@@ -58,6 +58,7 @@ class OpenApiRegistry implements IOpenApiRegistry {
       description: options.description,
       request_schema: options.request_schema,
       response_schema: responseSchema,
+      meta: options.meta,
     };
     const compiledRoute: CompiledApiSchema = {
       ...route,
@@ -131,4 +132,4 @@ class OpenApiRegistry implements IOpenApiRegistry {
   }
 }
 
-export default OpenApiRegistry;
+export default OpenApiRegistry;

adminforth/types/Back.ts

@@ -62,6 +62,7 @@ export interface IAdminForthEndpointOptions {
   request_schema?: AnySchemaObject,
   response_schema?: AnySchemaObject,
   responce_schema?: AnySchemaObject,
+  meta?: Record<string, unknown>,
   handler: (input: IAdminForthEndpointHandlerInput) => void | Promise<any>,
 }
 
@@ -82,12 +83,18 @@ export interface IAdminForthExpressRouteSchema {
    * JSON schema or Zod schema describing the JSON response body for a custom Express route.
    */
   response?: AdminForthExpressSchemaInput;
+
+  /**
+   * Internal metadata for AdminForth integrations. This is not rendered in the OpenAPI document.
+   */
+  meta?: Record<string, unknown>;
 }
 
 export interface IRegisteredApiSchema {
   method: string;
   path: string;
   description?: string;
+  meta?: Record<string, unknown>;
   request_schema?: AnySchemaObject;
   response_schema?: AnySchemaObject;
 }