@grandlinex/kernel 1.3.0 → 1.3.2

package/dist/cjs/classes/BaseAction.d.ts

@@ -1,14 +1,14 @@
-import { CoreAction, IDataBase } from '@grandlinex/core';
+import { CoreAction, CoreEntity, IDataBase } from '@grandlinex/core';
 import { ActionMode, ErrorType, SSchemaEl } from '@grandlinex/swagger-mate';
 import { IBaseAction, IBaseCache, IBaseClient, IBaseKernelModule, IBasePresenter, IKernel } from '../lib/index.js';
 import { XActionEvent, XRequest, XResponse } from '../lib/express.js';
 export default abstract class BaseAction<K extends IKernel = IKernel, T extends IDataBase<any, any> | null = any, P extends IBaseClient | null = any, C extends IBaseCache | null = any, E extends IBasePresenter | null = any> extends CoreAction<K, T, P, C, E> implements IBaseAction<K, T, P, C, E> {
     mode: ActionMode;
     forceDebug: boolean;
-    requestSchema: SSchemaEl | null;
+    requestSchema: SSchemaEl | CoreEntity | string | null;
     constructor(chanel: string, module: IBaseKernelModule<K, T, P, C, E>);
     abstract handler(event: XActionEvent): Promise<void>;
-    static validateSchema(error: ErrorType, schema: SSchemaEl, key: string, field: any, required?: boolean): void;
+    static validateSchema(error: ErrorType, inputSchema: SSchemaEl | CoreEntity | string, key: string, field: any, required?: boolean): void;
     bodyValidation<A>(req: XRequest): A | ErrorType | null;
     static sendError(res: XResponse, code: number, error: Partial<ErrorType>): void;
     secureHandler(req: XRequest, res: XResponse, next: () => void): Promise<void>;

package/dist/cjs/classes/BaseAction.js

@@ -12,11 +12,18 @@ class BaseAction extends core_1.CoreAction {
         this.forceDebug = false;
         this.requestSchema = null;
     }
-    static validateSchema(error, schema, key, field, required = true) {
-        if ((0, swagger_mate_1.isSwaggerRef)(schema)) {
+    static validateSchema(error, inputSchema, key, field, required = true) {
+        let schema;
+        if ((0, core_1.instanceOfEntity)(inputSchema)) {
+            schema = swagger_mate_1.SPathUtil.schemaFromEntity(inputSchema);
+        }
+        else {
+            schema = inputSchema;
+        }
+        if ((0, swagger_mate_1.isSwaggerRef)(schema) || typeof schema === 'string') {
             error.field?.push({
                 key,
-                message: `Ref schema body validation is not supported yet`,
+                message: `Ref or string schema body validation is not supported yet`,
             });
             return;
         }
@@ -132,6 +139,7 @@ class BaseAction extends core_1.CoreAction {
                     body = this.bodyValidation(req);
                 }
                 if ((0, swagger_mate_1.isErrorType)(body)) {
+                    this.debug(body);
                     res.status(400).send(body);
                     return;
                 }
@@ -168,6 +176,7 @@ class BaseAction extends core_1.CoreAction {
                     body = this.bodyValidation(req);
                 }
                 if ((0, swagger_mate_1.isErrorType)(body)) {
+                    this.debug(body);
                     res.status(400).send(body);
                     return;
                 }
@@ -201,6 +210,7 @@ class BaseAction extends core_1.CoreAction {
                     body = this.bodyValidation(req);
                 }
                 if ((0, swagger_mate_1.isErrorType)(body)) {
+                    this.debug(body);
                     res.status(400).send(body);
                     return;
                 }

package/dist/cjs/classes/BaseAuthProvider.d.ts

@@ -1,5 +1,6 @@
 import * as jwt from 'jsonwebtoken';
 import { XRequest } from '../lib/express.js';
+import { ValidationRequest } from '../lib/index.js';
 export type JwtExtend = {
     username: string;
     userid: string;
@@ -11,13 +12,13 @@ export type AuthResult = {
 };
 export interface IAuthProvider<T extends JwtExtend> {
     authorizeToken(userid: string, token: string, requestType: string): Promise<AuthResult>;
-    validateAccess(token: JwtToken<T>, requestType: string): Promise<boolean>;
+    validateAccess(request: ValidationRequest<T>): Promise<boolean>;
     bearerTokenValidation(req: XRequest): Promise<JwtToken<T> | number>;
     jwtAddData(token: JwtToken<T>, extend?: Record<string, any>): Promise<JwtToken<T>>;
 }
 export default abstract class BaseAuthProvider<T extends JwtExtend = JwtExtend> implements IAuthProvider<T> {
     abstract authorizeToken(username: string, token: string, requestType: string): Promise<AuthResult>;
-    abstract validateAccess(token: JwtToken<T>, requestType: string): Promise<boolean>;
+    abstract validateAccess(request: ValidationRequest<T>): Promise<boolean>;
     abstract bearerTokenValidation(req: XRequest): Promise<JwtToken<T> | number>;
     jwtAddData(token: JwtToken<T>, extend?: Record<string, any>): Promise<JwtToken<T>>;
 }

package/dist/cjs/classes/BaseEndpoint.d.ts

@@ -8,7 +8,7 @@ export default abstract class BaseEndpoint<K extends IKernel = IKernel, T extend
     protected appServer: express.Express;
     protected httpServer: http.Server;
     protected port: number;
-    constructor(chanel: string, module: IBaseKernelModule<any, any, any, any>, port: number);
+    constructor(chanel: string, module: IBaseKernelModule<any>, port: number);
     private setAppHeader;
     appServerOverride(app: Express): void;
     start(): Promise<boolean>;

package/dist/cjs/classes/BaseEndpoint.js

@@ -30,7 +30,7 @@ class BaseEndpoint extends core_1.CorePresenter {
         this.setAppHeader();
     }
     setAppHeader() {
-        this.appServer.use((req, res, next) => {
+        this.appServer.use((_, res, next) => {
             res.setHeader('X-Powered-By', 'GrandLineX');
             next();
         });

package/dist/cjs/lib/index.d.ts

@@ -2,19 +2,81 @@ import { ICoreAction, ICoreBridge, ICoreCache, ICoreCClient, ICoreClient, ICoreE
 import express from 'express';
 import * as jwt from 'jsonwebtoken';
 import { IAuthProvider, JwtExtend, JwtToken } from '../classes/index.js';
-import EntitySchemaExtender from './EntitySchemaExtender.js';
 import { XActionEvent, XRequest } from './express.js';
-export { EntitySchemaExtender };
+/**
+ * Represents a request for validating a JWT token with optional constraints.
+ *
+ * @template T - The shape of the JWT claims, extending {@link JwtExtend}.
+ *
+ * This type includes:
+ * - **token**: the JWT token to validate.
+ * - **requestType**: an array of request type identifiers that the token must satisfy.
+ * - **required** (optional): indicates whether the token is mandatory for the request; if omitted, the token is considered required.
+ */
+export type ValidationRequest<T extends JwtExtend = JwtExtend> = {
+    token: JwtToken<T>;
+    requestType: string[];
+    required?: boolean;
+};
 export interface ICClient<T extends JwtExtend = JwtExtend> extends ICoreCClient {
+    /**
+     * Assigns the authentication provider responsible for handling authentication operations.
+     *
+     * @param provider The authentication provider to use.
+     * @return True if the provider was set successfully; otherwise, false.
+     */
     setAuthProvider(provider: IAuthProvider<T>): boolean;
+    /**
+     * Verifies a JWT access token and returns the decoded payload or an error code.
+     *
+     * @param token - The JWT access token string to verify.
+     * @return A promise that resolves to the decoded token payload of type {@link JwtToken<T>} if verification succeeds, or a numeric error code if verification fails.
+     */
     jwtVerifyAccessToken(token: string): Promise<JwtToken<T> | number>;
+    /**
+     * Decodes a JWT access token and returns its payload.
+     *
+     * @param {string} token - The JWT access token to decode.
+     * @returns {jwt.JwtPayload | null} The decoded payload if the token is valid, otherwise null.
+     */
     jwtDecodeAccessToken(token: string): jwt.JwtPayload | null;
+    /**
+     * Generates a signed JWT access token.
+     *
+     * @param {JwtToken<T>} data - The payload data for the token.
+     * @param {Record<string, any>} [extend] - Optional additional fields to merge into the token payload.
+     * @param {string|number} [expire] - Optional expiration time for the token, expressed in seconds or as an ISO 8601 duration string.
+     * @return {Promise<string>} A promise that resolves to the generated JWT token string.
+     */
     jwtGenerateAccessToken(data: JwtToken<T>, extend?: Record<string, any>, expire?: string | number): Promise<string>;
+    /**
+     * Validates an API token for a specified user and request type.
+     *
+     * @param {string} username - The username associated with the token.
+     * @param {string} token - The API token to validate.
+     * @param {string} requestType - The type of request for which the token is being validated.
+     * @returns {Promise<{ valid: boolean; userId: string | null }>} A promise that resolves to an object containing a boolean indicating whether the token is valid and the user ID if validation succeeds; otherwise, `null` is returned for the user ID.
+     */
     apiTokenValidation(username: string, token: string, requestType: string): Promise<{
         valid: boolean;
         userId: string | null;
     }>;
-    permissionValidation(token: JwtToken<T>, requestType: string): Promise<boolean>;
+    /**
+     * Validates user permissions according to the supplied validation request.
+     *
+     * @param {ValidationRequest<T>} request - The request object containing the necessary
+     *   data for permission evaluation, such as user identity, requested action,
+     *   and contextual parameters.
+     *
+     * @return {Promise<boolean>} A promise that resolves to `true` if the permissions
+     *   are valid for the specified request, otherwise resolves to `false`.
+     */
+    permissionValidation(request: ValidationRequest<T>): Promise<boolean>;
+    /**
+     * Validates the bearer token present in the provided request.
+     * @param {XRequest} req - The HTTP request containing the Authorization header.
+     * @return {Promise<JwtToken<T> | number>} A promise that resolves to the decoded JWT payload if the token is valid, or a numeric status code (e.g., 401) if validation fails.
+     */
     bearerTokenValidation(req: XRequest): Promise<JwtToken<T> | number>;
 }
 export interface IKernel<T extends JwtExtend = JwtExtend> extends ICoreKernel<ICClient<T>> {

package/dist/cjs/lib/index.js

@@ -1,8 +1,2 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EntitySchemaExtender = void 0;
-const EntitySchemaExtender_js_1 = __importDefault(require("./EntitySchemaExtender.js"));
-exports.EntitySchemaExtender = EntitySchemaExtender_js_1.default;

package/dist/cjs/modules/crypto/CryptoClient.d.ts

@@ -1,6 +1,6 @@
 import { CoreCryptoClient } from '@grandlinex/core';
 import { type StringValue } from 'ms';
-import { ICClient, IKernel } from '../../lib/index.js';
+import { ICClient, IKernel, ValidationRequest } from '../../lib/index.js';
 import { IAuthProvider, JwtExtend, JwtToken } from '../../classes/index.js';
 import { XRequest } from '../../lib/express.js';
 export default class CryptoClient<T extends JwtExtend = JwtExtend> extends CoreCryptoClient implements ICClient<T> {
@@ -16,6 +16,6 @@ export default class CryptoClient<T extends JwtExtend = JwtExtend> extends CoreC
         valid: boolean;
         userId: string | null;
     }>;
-    permissionValidation(token: JwtToken<T>, requestType: string): Promise<boolean>;
+    permissionValidation(request: ValidationRequest<T>): Promise<boolean>;
     bearerTokenValidation(req: XRequest): Promise<JwtToken<T> | number>;
 }

package/dist/cjs/modules/crypto/CryptoClient.js

@@ -103,9 +103,9 @@ class CryptoClient extends core_1.CoreCryptoClient {
             userId: null,
         };
     }
-    async permissionValidation(token, requestType) {
+    async permissionValidation(request) {
         if (this.authProvider) {
-            return this.authProvider.validateAccess(token, requestType);
+            return this.authProvider.validateAccess(request);
         }
         return false;
     }

package/dist/mjs/classes/BaseAction.d.ts

@@ -1,14 +1,14 @@
-import { CoreAction, IDataBase } from '@grandlinex/core';
+import { CoreAction, CoreEntity, IDataBase } from '@grandlinex/core';
 import { ActionMode, ErrorType, SSchemaEl } from '@grandlinex/swagger-mate';
 import { IBaseAction, IBaseCache, IBaseClient, IBaseKernelModule, IBasePresenter, IKernel } from '../lib/index.js';
 import { XActionEvent, XRequest, XResponse } from '../lib/express.js';
 export default abstract class BaseAction<K extends IKernel = IKernel, T extends IDataBase<any, any> | null = any, P extends IBaseClient | null = any, C extends IBaseCache | null = any, E extends IBasePresenter | null = any> extends CoreAction<K, T, P, C, E> implements IBaseAction<K, T, P, C, E> {
     mode: ActionMode;
     forceDebug: boolean;
-    requestSchema: SSchemaEl | null;
+    requestSchema: SSchemaEl | CoreEntity | string | null;
     constructor(chanel: string, module: IBaseKernelModule<K, T, P, C, E>);
     abstract handler(event: XActionEvent): Promise<void>;
-    static validateSchema(error: ErrorType, schema: SSchemaEl, key: string, field: any, required?: boolean): void;
+    static validateSchema(error: ErrorType, inputSchema: SSchemaEl | CoreEntity | string, key: string, field: any, required?: boolean): void;
     bodyValidation<A>(req: XRequest): A | ErrorType | null;
     static sendError(res: XResponse, code: number, error: Partial<ErrorType>): void;
     secureHandler(req: XRequest, res: XResponse, next: () => void): Promise<void>;

package/dist/mjs/classes/BaseAction.js

@@ -1,5 +1,5 @@
-import { CoreAction } from '@grandlinex/core';
-import { ActionMode, isErrorType, isSwaggerRef, } from '@grandlinex/swagger-mate';
+import { CoreAction, instanceOfEntity, } from '@grandlinex/core';
+import { ActionMode, isErrorType, isSwaggerRef, SPathUtil, } from '@grandlinex/swagger-mate';
 import { ExpressServerTiming } from './timing/index.js';
 import { BaseUserAgent } from './BaseUserAgent.js';
 export default class BaseAction extends CoreAction {
@@ -10,11 +10,18 @@ export default class BaseAction extends CoreAction {
         this.forceDebug = false;
         this.requestSchema = null;
     }
-    static validateSchema(error, schema, key, field, required = true) {
-        if (isSwaggerRef(schema)) {
+    static validateSchema(error, inputSchema, key, field, required = true) {
+        let schema;
+        if (instanceOfEntity(inputSchema)) {
+            schema = SPathUtil.schemaFromEntity(inputSchema);
+        }
+        else {
+            schema = inputSchema;
+        }
+        if (isSwaggerRef(schema) || typeof schema === 'string') {
             error.field?.push({
                 key,
-                message: `Ref schema body validation is not supported yet`,
+                message: `Ref or string schema body validation is not supported yet`,
             });
             return;
         }
@@ -130,6 +137,7 @@ export default class BaseAction extends CoreAction {
                     body = this.bodyValidation(req);
                 }
                 if (isErrorType(body)) {
+                    this.debug(body);
                     res.status(400).send(body);
                     return;
                 }
@@ -166,6 +174,7 @@ export default class BaseAction extends CoreAction {
                     body = this.bodyValidation(req);
                 }
                 if (isErrorType(body)) {
+                    this.debug(body);
                     res.status(400).send(body);
                     return;
                 }
@@ -199,6 +208,7 @@ export default class BaseAction extends CoreAction {
                     body = this.bodyValidation(req);
                 }
                 if (isErrorType(body)) {
+                    this.debug(body);
                     res.status(400).send(body);
                     return;
                 }

package/dist/mjs/classes/BaseAuthProvider.d.ts

@@ -1,5 +1,6 @@
 import * as jwt from 'jsonwebtoken';
 import { XRequest } from '../lib/express.js';
+import { ValidationRequest } from '../lib/index.js';
 export type JwtExtend = {
     username: string;
     userid: string;
@@ -11,13 +12,13 @@ export type AuthResult = {
 };
 export interface IAuthProvider<T extends JwtExtend> {
     authorizeToken(userid: string, token: string, requestType: string): Promise<AuthResult>;
-    validateAccess(token: JwtToken<T>, requestType: string): Promise<boolean>;
+    validateAccess(request: ValidationRequest<T>): Promise<boolean>;
     bearerTokenValidation(req: XRequest): Promise<JwtToken<T> | number>;
     jwtAddData(token: JwtToken<T>, extend?: Record<string, any>): Promise<JwtToken<T>>;
 }
 export default abstract class BaseAuthProvider<T extends JwtExtend = JwtExtend> implements IAuthProvider<T> {
     abstract authorizeToken(username: string, token: string, requestType: string): Promise<AuthResult>;
-    abstract validateAccess(token: JwtToken<T>, requestType: string): Promise<boolean>;
+    abstract validateAccess(request: ValidationRequest<T>): Promise<boolean>;
     abstract bearerTokenValidation(req: XRequest): Promise<JwtToken<T> | number>;
     jwtAddData(token: JwtToken<T>, extend?: Record<string, any>): Promise<JwtToken<T>>;
 }

package/dist/mjs/classes/BaseEndpoint.d.ts

@@ -8,7 +8,7 @@ export default abstract class BaseEndpoint<K extends IKernel = IKernel, T extend
     protected appServer: express.Express;
     protected httpServer: http.Server;
     protected port: number;
-    constructor(chanel: string, module: IBaseKernelModule<any, any, any, any>, port: number);
+    constructor(chanel: string, module: IBaseKernelModule<any>, port: number);
     private setAppHeader;
     appServerOverride(app: Express): void;
     start(): Promise<boolean>;

package/dist/mjs/classes/BaseEndpoint.js

@@ -24,7 +24,7 @@ export default class BaseEndpoint extends CorePresenter {
         this.setAppHeader();
     }
     setAppHeader() {
-        this.appServer.use((req, res, next) => {
+        this.appServer.use((_, res, next) => {
             res.setHeader('X-Powered-By', 'GrandLineX');
             next();
         });

package/dist/mjs/lib/index.d.ts

@@ -2,19 +2,81 @@ import { ICoreAction, ICoreBridge, ICoreCache, ICoreCClient, ICoreClient, ICoreE
 import express from 'express';
 import * as jwt from 'jsonwebtoken';
 import { IAuthProvider, JwtExtend, JwtToken } from '../classes/index.js';
-import EntitySchemaExtender from './EntitySchemaExtender.js';
 import { XActionEvent, XRequest } from './express.js';
-export { EntitySchemaExtender };
+/**
+ * Represents a request for validating a JWT token with optional constraints.
+ *
+ * @template T - The shape of the JWT claims, extending {@link JwtExtend}.
+ *
+ * This type includes:
+ * - **token**: the JWT token to validate.
+ * - **requestType**: an array of request type identifiers that the token must satisfy.
+ * - **required** (optional): indicates whether the token is mandatory for the request; if omitted, the token is considered required.
+ */
+export type ValidationRequest<T extends JwtExtend = JwtExtend> = {
+    token: JwtToken<T>;
+    requestType: string[];
+    required?: boolean;
+};
 export interface ICClient<T extends JwtExtend = JwtExtend> extends ICoreCClient {
+    /**
+     * Assigns the authentication provider responsible for handling authentication operations.
+     *
+     * @param provider The authentication provider to use.
+     * @return True if the provider was set successfully; otherwise, false.
+     */
     setAuthProvider(provider: IAuthProvider<T>): boolean;
+    /**
+     * Verifies a JWT access token and returns the decoded payload or an error code.
+     *
+     * @param token - The JWT access token string to verify.
+     * @return A promise that resolves to the decoded token payload of type {@link JwtToken<T>} if verification succeeds, or a numeric error code if verification fails.
+     */
     jwtVerifyAccessToken(token: string): Promise<JwtToken<T> | number>;
+    /**
+     * Decodes a JWT access token and returns its payload.
+     *
+     * @param {string} token - The JWT access token to decode.
+     * @returns {jwt.JwtPayload | null} The decoded payload if the token is valid, otherwise null.
+     */
     jwtDecodeAccessToken(token: string): jwt.JwtPayload | null;
+    /**
+     * Generates a signed JWT access token.
+     *
+     * @param {JwtToken<T>} data - The payload data for the token.
+     * @param {Record<string, any>} [extend] - Optional additional fields to merge into the token payload.
+     * @param {string|number} [expire] - Optional expiration time for the token, expressed in seconds or as an ISO 8601 duration string.
+     * @return {Promise<string>} A promise that resolves to the generated JWT token string.
+     */
     jwtGenerateAccessToken(data: JwtToken<T>, extend?: Record<string, any>, expire?: string | number): Promise<string>;
+    /**
+     * Validates an API token for a specified user and request type.
+     *
+     * @param {string} username - The username associated with the token.
+     * @param {string} token - The API token to validate.
+     * @param {string} requestType - The type of request for which the token is being validated.
+     * @returns {Promise<{ valid: boolean; userId: string | null }>} A promise that resolves to an object containing a boolean indicating whether the token is valid and the user ID if validation succeeds; otherwise, `null` is returned for the user ID.
+     */
     apiTokenValidation(username: string, token: string, requestType: string): Promise<{
         valid: boolean;
         userId: string | null;
     }>;
-    permissionValidation(token: JwtToken<T>, requestType: string): Promise<boolean>;
+    /**
+     * Validates user permissions according to the supplied validation request.
+     *
+     * @param {ValidationRequest<T>} request - The request object containing the necessary
+     *   data for permission evaluation, such as user identity, requested action,
+     *   and contextual parameters.
+     *
+     * @return {Promise<boolean>} A promise that resolves to `true` if the permissions
+     *   are valid for the specified request, otherwise resolves to `false`.
+     */
+    permissionValidation(request: ValidationRequest<T>): Promise<boolean>;
+    /**
+     * Validates the bearer token present in the provided request.
+     * @param {XRequest} req - The HTTP request containing the Authorization header.
+     * @return {Promise<JwtToken<T> | number>} A promise that resolves to the decoded JWT payload if the token is valid, or a numeric status code (e.g., 401) if validation fails.
+     */
     bearerTokenValidation(req: XRequest): Promise<JwtToken<T> | number>;
 }
 export interface IKernel<T extends JwtExtend = JwtExtend> extends ICoreKernel<ICClient<T>> {

package/dist/mjs/lib/index.js

@@ -1,2 +1 @@
-import EntitySchemaExtender from './EntitySchemaExtender.js';
-export { EntitySchemaExtender };
+export {};

package/dist/mjs/modules/crypto/CryptoClient.d.ts

@@ -1,6 +1,6 @@
 import { CoreCryptoClient } from '@grandlinex/core';
 import { type StringValue } from 'ms';
-import { ICClient, IKernel } from '../../lib/index.js';
+import { ICClient, IKernel, ValidationRequest } from '../../lib/index.js';
 import { IAuthProvider, JwtExtend, JwtToken } from '../../classes/index.js';
 import { XRequest } from '../../lib/express.js';
 export default class CryptoClient<T extends JwtExtend = JwtExtend> extends CoreCryptoClient implements ICClient<T> {
@@ -16,6 +16,6 @@ export default class CryptoClient<T extends JwtExtend = JwtExtend> extends CoreC
         valid: boolean;
         userId: string | null;
     }>;
-    permissionValidation(token: JwtToken<T>, requestType: string): Promise<boolean>;
+    permissionValidation(request: ValidationRequest<T>): Promise<boolean>;
     bearerTokenValidation(req: XRequest): Promise<JwtToken<T> | number>;
 }

package/dist/mjs/modules/crypto/CryptoClient.js

@@ -68,9 +68,9 @@ export default class CryptoClient extends CoreCryptoClient {
             userId: null,
         };
     }
-    async permissionValidation(token, requestType) {
+    async permissionValidation(request) {
         if (this.authProvider) {
-            return this.authProvider.validateAccess(token, requestType);
+            return this.authProvider.validateAccess(request);
         }
         return false;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grandlinex/kernel",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "GrandLineX is an out-of-the-box server framework on top of ExpressJs.",
   "type": "module",
   "exports": {
@@ -47,7 +47,7 @@
   "license": "BSD-3-Clause",
   "dependencies": {
     "@grandlinex/core": "1.3.1",
-    "@grandlinex/swagger-mate": "1.3.1",
+    "@grandlinex/swagger-mate": "1.3.3",
     "@types/jsonwebtoken": "9.0.10",
     "@types/ms": "2.1.0",
     "body-parser": "2.2.1",
@@ -60,7 +60,7 @@
     "express": ">=5.2.1"
   },
   "devDependencies": {
-    "@types/jest": "29.5.14",
+    "@types/jest": "30.0.0",
     "@types/node": "22.15.20",
     "@typescript-eslint/eslint-plugin": "7.18.0",
     "@typescript-eslint/parser": "7.18.0",
@@ -72,10 +72,10 @@
     "eslint-plugin-jest": "28.6.0",
     "eslint-plugin-jsx-a11y": "6.9.0",
     "eslint-plugin-prettier": "5.2.1",
-    "jest": "29.7.0",
+    "jest": "30.2.0",
     "jest-junit": "16.0.0",
     "prettier": "3.5.3",
-    "ts-jest": "29.3.4",
+    "ts-jest": "29.4.6",
     "ts-loader": "9.5.2",
     "ts-node": "10.9.2",
     "typedoc": "0.28.15",

package/dist/cjs/lib/EntitySchemaExtender.d.ts

@@ -1,11 +0,0 @@
-import { CoreEntity } from '@grandlinex/core';
-import { SKey, SSchemaEl } from '@grandlinex/swagger-mate';
-export default class EntitySchemaExtender {
-    static extendEntitySchema(entity: CoreEntity, ...options: {
-        key: string;
-        list?: boolean;
-        entity?: CoreEntity;
-        schema?: SSchemaEl;
-        required?: boolean;
-    }[]): SKey<SSchemaEl>;
-}

package/dist/cjs/lib/EntitySchemaExtender.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@grandlinex/core");
-const swagger_mate_1 = require("@grandlinex/swagger-mate");
-class EntitySchemaExtender {
-    static extendEntitySchema(entity, ...options) {
-        const meta = (0, core_1.getEntityMeta)(entity);
-        if (meta) {
-            const schema = swagger_mate_1.SPathUtil.schemaEntryGen(entity)[meta.name];
-            if (schema && !(0, swagger_mate_1.isSwaggerRef)(schema) && schema.properties) {
-                for (const option of options) {
-                    if (option.schema) {
-                        if (option.list) {
-                            schema.properties[option.key] = {
-                                type: 'array',
-                                items: option.schema,
-                            };
-                        }
-                        else {
-                            schema.properties[option.key] = option.schema;
-                        }
-                    }
-                    else if (option.entity) {
-                        const eMeta = (0, core_1.getEntityMeta)(option.entity);
-                        if (eMeta) {
-                            const scheme = swagger_mate_1.SPathUtil.schemaEntryGen(option.entity)[eMeta.name];
-                            if (option.list) {
-                                schema.properties[option.key] = {
-                                    type: 'array',
-                                    items: scheme,
-                                };
-                            }
-                            else {
-                                schema.properties[option.key] = scheme;
-                            }
-                        }
-                    }
-                    if (option.required) {
-                        schema.required = [...(schema.required || []), option.key];
-                    }
-                }
-            }
-            return {
-                [meta.name]: schema,
-            };
-        }
-        return {};
-    }
-}
-exports.default = EntitySchemaExtender;

package/dist/mjs/lib/EntitySchemaExtender.d.ts

@@ -1,11 +0,0 @@
-import { CoreEntity } from '@grandlinex/core';
-import { SKey, SSchemaEl } from '@grandlinex/swagger-mate';
-export default class EntitySchemaExtender {
-    static extendEntitySchema(entity: CoreEntity, ...options: {
-        key: string;
-        list?: boolean;
-        entity?: CoreEntity;
-        schema?: SSchemaEl;
-        required?: boolean;
-    }[]): SKey<SSchemaEl>;
-}

package/dist/mjs/lib/EntitySchemaExtender.js

@@ -1,47 +0,0 @@
-import { getEntityMeta } from '@grandlinex/core';
-import { isSwaggerRef, SPathUtil, } from '@grandlinex/swagger-mate';
-export default class EntitySchemaExtender {
-    static extendEntitySchema(entity, ...options) {
-        const meta = getEntityMeta(entity);
-        if (meta) {
-            const schema = SPathUtil.schemaEntryGen(entity)[meta.name];
-            if (schema && !isSwaggerRef(schema) && schema.properties) {
-                for (const option of options) {
-                    if (option.schema) {
-                        if (option.list) {
-                            schema.properties[option.key] = {
-                                type: 'array',
-                                items: option.schema,
-                            };
-                        }
-                        else {
-                            schema.properties[option.key] = option.schema;
-                        }
-                    }
-                    else if (option.entity) {
-                        const eMeta = getEntityMeta(option.entity);
-                        if (eMeta) {
-                            const scheme = SPathUtil.schemaEntryGen(option.entity)[eMeta.name];
-                            if (option.list) {
-                                schema.properties[option.key] = {
-                                    type: 'array',
-                                    items: scheme,
-                                };
-                            }
-                            else {
-                                schema.properties[option.key] = scheme;
-                            }
-                        }
-                    }
-                    if (option.required) {
-                        schema.required = [...(schema.required || []), option.key];
-                    }
-                }
-            }
-            return {
-                [meta.name]: schema,
-            };
-        }
-        return {};
-    }
-}