@grandlinex/kernel 0.32.10 → 1.0.0

package/CHANGELOG.md

@@ -1,57 +1,69 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
-## [v0.32.10] - 2023-10-06
+## [1.0.0] - 2024-07-30
+### Added
+- Add EntitySchemaExtender
+- Add BaseUserAgent
+### Changed
+- Update Deps
+
+## [0.32.11] - 2024-07-13
+### Changed
+- Update Deps
+- Error Handling for BaseApiAction
+
+## [0.32.10] - 2023-10-06
 ### Changed
 - Breaking Change: BaseApiAction now use XActionEvent
 
-## [v0.31.1] - 2023-07-07
+## [0.31.1] - 2023-07-07
 ### Added
 - @/token pass the token body to jwt generator function
 ### Fixed
 - Deal with code smells 
 
-## [v0.31.0] - 2023-07-06
+## [0.31.0] - 2023-07-06
 ### Added
 - JTW Token now can be extended with custom payload
 - Update to core 0.31.0
 - Add forceDebug flag for BaseAction to force Server-Timing in production mode
 
-## [v0.30.0] - 2023-04-03
+## [0.30.0] - 2023-04-03
 ### Added
 - Switch to ESM
 - Update to core 0.30.0
 
-## [v0.27.1] - 2023-01-26
+## [0.27.1] - 2023-01-26
 ### Added
 - Add raw body field for express calls 
 - change BaseEndpoint variables from private to protected
 
-## [v0.25.2] - 2022-08-07
+## [0.25.2] - 2022-08-07
 ### Added
 - Add express timing api in dev mode
 
-## [v0.25.0] - 2022-07-23
+## [0.25.0] - 2022-07-23
 ### Changed
 - Update to core 0.25.0
 
 
-## [v0.18.0] - 2022-01-10
+## [0.18.0] - 2022-01-10
 ### Changed
 - Update to core 0.18.0 
 
-## [v0.17.0] - 2022-01-03
+## [0.17.0] - 2022-01-03
 ### Changed
 - Update to core 0.17.1
 - Using db prefab for kernel db 
 
-## [v0.16.2] - 2021-12-17
+## [0.16.2] - 2021-12-17
 
 ### Changed
 - Update Db Bundles with search bug
 
 
-## [v0.16.1] - 2021-12-07
+## [0.16.1] - 2021-12-07
 
 ### Changed
 - Update to core 0.16.2

package/dist/cjs/KernelModule.js

@@ -18,7 +18,7 @@ class KernelModule extends BaseKernelModule_js_1.default {
         this.addService(new core_1.OfflineService(this));
         const endpoint = new KernelEndpoint_js_1.default('api', this, this.getKernel().getAppServerPort());
         this.setPresenter(endpoint);
-        await this.getKernel().triggerFunction('load');
+        await this.getKernel().triggerEvent('load');
     }
 }
 exports.default = KernelModule;

package/dist/cjs/classes/BaseAction.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActionMode = void 0;
 const core_1 = require("@grandlinex/core");
 const index_js_1 = require("./timing/index.js");
+const BaseUserAgent_js_1 = require("./BaseUserAgent.js");
 var ActionMode;
 (function (ActionMode) {
     ActionMode[ActionMode["DEFAULT"] = 0] = "DEFAULT";
@@ -32,34 +33,64 @@ class BaseAction extends core_1.CoreAction {
         }
         if (this.mode === ActionMode.DMZ) {
             auth.stop();
-            await this.handler({
-                res,
-                req,
-                next,
-                data: null,
-                extension,
-            });
+            try {
+                await this.handler({
+                    res,
+                    req,
+                    next,
+                    data: null,
+                    extension,
+                    agent: new BaseUserAgent_js_1.BaseUserAgent(req),
+                });
+            }
+            catch (e) {
+                this.error(e);
+                this.error(e?.message);
+                if (!res.headersSent) {
+                    res.sendStatus(500);
+                }
+            }
             return;
         }
         const dat = await cc.bearerTokenValidation(req);
         auth.stop();
         if (dat && typeof dat !== 'number') {
-            await this.handler({
-                res,
-                req,
-                next,
-                data: dat,
-                extension,
-            });
+            try {
+                await this.handler({
+                    res,
+                    req,
+                    next,
+                    data: dat,
+                    extension,
+                    agent: new BaseUserAgent_js_1.BaseUserAgent(req),
+                });
+            }
+            catch (e) {
+                this.error(e);
+                this.error(e?.message);
+                if (!res.headersSent) {
+                    res.sendStatus(500);
+                }
+            }
         }
         else if (this.mode === ActionMode.DMZ_WITH_USER) {
-            await this.handler({
-                res,
-                req,
-                next,
-                data: null,
-                extension,
-            });
+            try {
+                await this.handler({
+                    res,
+                    req,
+                    next,
+                    data: null,
+                    extension,
+                    agent: new BaseUserAgent_js_1.BaseUserAgent(req),
+                });
+            }
+            catch (e) {
+                this.error(e);
+                this.error(e?.message);
+                if (!res.headersSent) {
+                    res.sendStatus(500);
+                }
+            }
         }
         else if (dat) {
             res.sendStatus(dat);

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

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import express, { Express } from 'express';
 import http from 'http';
 import { CorePresenter, IDataBase } from '@grandlinex/core';
@@ -11,6 +9,7 @@ export default abstract class BaseEndpoint<K extends IKernel = IKernel, T extend
     protected httpServer: http.Server;
     protected port: number;
     constructor(chanel: string, module: IBaseKernelModule<any, any, any, any>, port: number);
+    private setAppHeader;
     appServerOverride(app: Express): void;
     start(): Promise<boolean>;
     stop(): Promise<boolean>;

package/dist/cjs/classes/BaseEndpoint.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.keepRawBody = void 0;
+exports.keepRawBody = keepRawBody;
 const express_1 = __importDefault(require("express"));
 const http_1 = __importDefault(require("http"));
 const body_parser_1 = __importDefault(require("body-parser"));
@@ -20,7 +20,6 @@ function keepRawBody(req, res, buf, encoding) {
         }
     }
 }
-exports.keepRawBody = keepRawBody;
 class BaseEndpoint extends core_1.CorePresenter {
     constructor(chanel, module, port) {
         super(`endpoint-${chanel}`, module);
@@ -28,10 +27,18 @@ class BaseEndpoint extends core_1.CorePresenter {
         this.appServer = (0, express_1.default)();
         this.appServer.use(body_parser_1.default.json({ verify: keepRawBody }));
         this.httpServer = http_1.default.createServer(this.appServer);
+        this.setAppHeader();
+    }
+    setAppHeader() {
+        this.appServer.use((req, res, next) => {
+            res.setHeader('X-Powered-By', 'GrandLineX');
+            next();
+        });
     }
     appServerOverride(app) {
         this.appServer = app;
         this.httpServer = http_1.default.createServer(this.appServer);
+        this.setAppHeader();
     }
     start() {
         return new Promise((resolve) => {

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

@@ -0,0 +1,30 @@
+import { XRequest } from '../lib/express.js';
+export declare enum BrowserENUM {
+    Edge = "edg",
+    Opera = "opr",
+    Chrome = "chrome",
+    Firefox = "firefox",
+    Safari = "safari",
+    Mozilla = "mozilla",
+    Gecko = "gecko",
+    OculusBrowser = "oculusbrowser"
+}
+/**
+ * UserAgent
+ */
+export declare class BaseUserAgent {
+    private readonly raw;
+    private readonly version;
+    constructor(req: XRequest);
+    getBrowser(): "Opera" | "Edge" | "Firefox" | "OculusBrowser" | "Chrome" | "Safari" | "Mozilla" | "Gecko" | "Unknown";
+    getChromeVersion(): number;
+    getEdgeVersion(): number;
+    getFirefoxVersion(): number;
+    getGeckoVersion(): number;
+    getMozillaVersion(): number;
+    getOculusVersion(): number;
+    getOperaVersion(): number;
+    getSafariVersion(): number;
+    getXVersion(x: string): number;
+    getRaw(): string;
+}

package/dist/cjs/classes/BaseUserAgent.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseUserAgent = exports.BrowserENUM = void 0;
+var BrowserENUM;
+(function (BrowserENUM) {
+    BrowserENUM["Edge"] = "edg";
+    BrowserENUM["Opera"] = "opr";
+    BrowserENUM["Chrome"] = "chrome";
+    BrowserENUM["Firefox"] = "firefox";
+    BrowserENUM["Safari"] = "safari";
+    BrowserENUM["Mozilla"] = "mozilla";
+    BrowserENUM["Gecko"] = "gecko";
+    BrowserENUM["OculusBrowser"] = "oculusbrowser";
+})(BrowserENUM || (exports.BrowserENUM = BrowserENUM = {}));
+/**
+ * UserAgent
+ */
+class BaseUserAgent {
+    constructor(req) {
+        this.raw = req.headers['user-agent'] || '';
+        this.version = new Map();
+        const parts = this.raw.matchAll(/[A-Za-z]*\/[0-9.]*/gm);
+        for (const part of parts) {
+            const [name, version] = part[0].split('/');
+            const [release] = version.split('.');
+            this.version.set(name.toLowerCase(), parseInt(release, 10));
+        }
+    }
+    getBrowser() {
+        if (this.version.has(BrowserENUM.Opera)) {
+            return 'Opera';
+        }
+        if (this.version.has(BrowserENUM.Edge)) {
+            return 'Edge';
+        }
+        if (this.version.has(BrowserENUM.Firefox)) {
+            return 'Firefox';
+        }
+        if (this.version.has(BrowserENUM.OculusBrowser)) {
+            return 'OculusBrowser';
+        }
+        if (this.version.has(BrowserENUM.Chrome)) {
+            return 'Chrome';
+        }
+        if (this.version.has(BrowserENUM.Safari)) {
+            return 'Safari';
+        }
+        if (this.version.has(BrowserENUM.Mozilla)) {
+            return 'Mozilla';
+        }
+        if (this.version.has(BrowserENUM.Gecko)) {
+            return 'Gecko';
+        }
+        return 'Unknown';
+    }
+    getChromeVersion() {
+        return this.version.get(BrowserENUM.Chrome) || 0;
+    }
+    getEdgeVersion() {
+        return this.version.get(BrowserENUM.Edge) || 0;
+    }
+    getFirefoxVersion() {
+        return this.version.get(BrowserENUM.Firefox) || 0;
+    }
+    getGeckoVersion() {
+        return this.version.get(BrowserENUM.Gecko) || 0;
+    }
+    getMozillaVersion() {
+        return this.version.get(BrowserENUM.Mozilla) || 0;
+    }
+    getOculusVersion() {
+        return this.version.get(BrowserENUM.OculusBrowser) || 0;
+    }
+    getOperaVersion() {
+        return this.version.get(BrowserENUM.Opera) || 0;
+    }
+    getSafariVersion() {
+        return this.version.get(BrowserENUM.Safari) || 0;
+    }
+    getXVersion(x) {
+        return this.version.get(x) || 0;
+    }
+    getRaw() {
+        return this.raw;
+    }
+}
+exports.BaseUserAgent = BaseUserAgent;

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

@@ -5,6 +5,7 @@ import BaseKernelModule from './BaseKernelModule.js';
 import BaseApiAction from './BaseApiAction.js';
 import BaseAuthProvider from './BaseAuthProvider.js';
 export * from './BaseAction.js';
+export * from './BaseUserAgent.js';
 export * from './BaseAuthProvider.js';
 export * from './timing/index.js';
 export { BaseLoopService, BaseAuthProvider, BaseKernelModule, BaseService, BaseApiAction, BaseEndpoint, BaseElement, BaseCache, BaseAction, BaseClient, BaseBridge, keepRawBody, ActionMode, };

package/dist/cjs/classes/index.js

@@ -50,5 +50,6 @@ exports.BaseApiAction = BaseApiAction_js_1.default;
 const BaseAuthProvider_js_1 = __importDefault(require("./BaseAuthProvider.js"));
 exports.BaseAuthProvider = BaseAuthProvider_js_1.default;
 __exportStar(require("./BaseAction.js"), exports);
+__exportStar(require("./BaseUserAgent.js"), exports);
 __exportStar(require("./BaseAuthProvider.js"), exports);
 __exportStar(require("./timing/index.js"), exports);

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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,50 @@
+"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/cjs/lib/express.d.ts

@@ -1,5 +1,5 @@
 import express from 'express';
-import { IExtensionInterface, JwtToken } from '../classes/index.js';
+import { BaseUserAgent, IExtensionInterface, JwtToken } from '../classes/index.js';
 export type XRequest = express.Request & {
     rawBody?: string | null;
 };
@@ -11,4 +11,5 @@ export type XActionEvent<G = JwtToken | null> = {
     next: XNextFc;
     data: G;
     extension: IExtensionInterface;
+    agent: BaseUserAgent;
 };

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

@@ -2,7 +2,9 @@ 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 };
 export type ActionTypes = 'POST' | 'GET' | 'USE' | 'PATCH' | 'DELETE';
 export interface ICClient<T extends JwtExtend = JwtExtend> extends ICoreCClient {
     setAuthProvider(provider: IAuthProvider<T>): boolean;

package/dist/cjs/lib/index.js

@@ -1,2 +1,8 @@
 "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/mjs/KernelModule.js

@@ -13,6 +13,6 @@ export default class KernelModule extends BaseKernelModule {
         this.addService(new OfflineService(this));
         const endpoint = new KernelEndpoint('api', this, this.getKernel().getAppServerPort());
         this.setPresenter(endpoint);
-        await this.getKernel().triggerFunction('load');
+        await this.getKernel().triggerEvent('load');
     }
 }

package/dist/mjs/classes/BaseAction.js

@@ -1,5 +1,6 @@
 import { CoreAction } from '@grandlinex/core';
 import { ExpressServerTiming } from './timing/index.js';
+import { BaseUserAgent } from './BaseUserAgent.js';
 export var ActionMode;
 (function (ActionMode) {
     ActionMode[ActionMode["DEFAULT"] = 0] = "DEFAULT";
@@ -29,34 +30,64 @@ export default class BaseAction extends CoreAction {
         }
         if (this.mode === ActionMode.DMZ) {
             auth.stop();
-            await this.handler({
-                res,
-                req,
-                next,
-                data: null,
-                extension,
-            });
+            try {
+                await this.handler({
+                    res,
+                    req,
+                    next,
+                    data: null,
+                    extension,
+                    agent: new BaseUserAgent(req),
+                });
+            }
+            catch (e) {
+                this.error(e);
+                this.error(e?.message);
+                if (!res.headersSent) {
+                    res.sendStatus(500);
+                }
+            }
             return;
         }
         const dat = await cc.bearerTokenValidation(req);
         auth.stop();
         if (dat && typeof dat !== 'number') {
-            await this.handler({
-                res,
-                req,
-                next,
-                data: dat,
-                extension,
-            });
+            try {
+                await this.handler({
+                    res,
+                    req,
+                    next,
+                    data: dat,
+                    extension,
+                    agent: new BaseUserAgent(req),
+                });
+            }
+            catch (e) {
+                this.error(e);
+                this.error(e?.message);
+                if (!res.headersSent) {
+                    res.sendStatus(500);
+                }
+            }
         }
         else if (this.mode === ActionMode.DMZ_WITH_USER) {
-            await this.handler({
-                res,
-                req,
-                next,
-                data: null,
-                extension,
-            });
+            try {
+                await this.handler({
+                    res,
+                    req,
+                    next,
+                    data: null,
+                    extension,
+                    agent: new BaseUserAgent(req),
+                });
+            }
+            catch (e) {
+                this.error(e);
+                this.error(e?.message);
+                if (!res.headersSent) {
+                    res.sendStatus(500);
+                }
+            }
         }
         else if (dat) {
             res.sendStatus(dat);

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

@@ -1,5 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import express, { Express } from 'express';
 import http from 'http';
 import { CorePresenter, IDataBase } from '@grandlinex/core';
@@ -11,6 +9,7 @@ export default abstract class BaseEndpoint<K extends IKernel = IKernel, T extend
     protected httpServer: http.Server;
     protected port: number;
     constructor(chanel: string, module: IBaseKernelModule<any, any, any, any>, port: number);
+    private setAppHeader;
     appServerOverride(app: Express): void;
     start(): Promise<boolean>;
     stop(): Promise<boolean>;

package/dist/mjs/classes/BaseEndpoint.js

@@ -21,10 +21,18 @@ export default class BaseEndpoint extends CorePresenter {
         this.appServer = express();
         this.appServer.use(parser.json({ verify: keepRawBody }));
         this.httpServer = http.createServer(this.appServer);
+        this.setAppHeader();
+    }
+    setAppHeader() {
+        this.appServer.use((req, res, next) => {
+            res.setHeader('X-Powered-By', 'GrandLineX');
+            next();
+        });
     }
     appServerOverride(app) {
         this.appServer = app;
         this.httpServer = http.createServer(this.appServer);
+        this.setAppHeader();
     }
     start() {
         return new Promise((resolve) => {

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

@@ -0,0 +1,30 @@
+import { XRequest } from '../lib/express.js';
+export declare enum BrowserENUM {
+    Edge = "edg",
+    Opera = "opr",
+    Chrome = "chrome",
+    Firefox = "firefox",
+    Safari = "safari",
+    Mozilla = "mozilla",
+    Gecko = "gecko",
+    OculusBrowser = "oculusbrowser"
+}
+/**
+ * UserAgent
+ */
+export declare class BaseUserAgent {
+    private readonly raw;
+    private readonly version;
+    constructor(req: XRequest);
+    getBrowser(): "Opera" | "Edge" | "Firefox" | "OculusBrowser" | "Chrome" | "Safari" | "Mozilla" | "Gecko" | "Unknown";
+    getChromeVersion(): number;
+    getEdgeVersion(): number;
+    getFirefoxVersion(): number;
+    getGeckoVersion(): number;
+    getMozillaVersion(): number;
+    getOculusVersion(): number;
+    getOperaVersion(): number;
+    getSafariVersion(): number;
+    getXVersion(x: string): number;
+    getRaw(): string;
+}

package/dist/mjs/classes/BaseUserAgent.js

@@ -0,0 +1,83 @@
+export var BrowserENUM;
+(function (BrowserENUM) {
+    BrowserENUM["Edge"] = "edg";
+    BrowserENUM["Opera"] = "opr";
+    BrowserENUM["Chrome"] = "chrome";
+    BrowserENUM["Firefox"] = "firefox";
+    BrowserENUM["Safari"] = "safari";
+    BrowserENUM["Mozilla"] = "mozilla";
+    BrowserENUM["Gecko"] = "gecko";
+    BrowserENUM["OculusBrowser"] = "oculusbrowser";
+})(BrowserENUM || (BrowserENUM = {}));
+/**
+ * UserAgent
+ */
+export class BaseUserAgent {
+    constructor(req) {
+        this.raw = req.headers['user-agent'] || '';
+        this.version = new Map();
+        const parts = this.raw.matchAll(/[A-Za-z]*\/[0-9.]*/gm);
+        for (const part of parts) {
+            const [name, version] = part[0].split('/');
+            const [release] = version.split('.');
+            this.version.set(name.toLowerCase(), parseInt(release, 10));
+        }
+    }
+    getBrowser() {
+        if (this.version.has(BrowserENUM.Opera)) {
+            return 'Opera';
+        }
+        if (this.version.has(BrowserENUM.Edge)) {
+            return 'Edge';
+        }
+        if (this.version.has(BrowserENUM.Firefox)) {
+            return 'Firefox';
+        }
+        if (this.version.has(BrowserENUM.OculusBrowser)) {
+            return 'OculusBrowser';
+        }
+        if (this.version.has(BrowserENUM.Chrome)) {
+            return 'Chrome';
+        }
+        if (this.version.has(BrowserENUM.Safari)) {
+            return 'Safari';
+        }
+        if (this.version.has(BrowserENUM.Mozilla)) {
+            return 'Mozilla';
+        }
+        if (this.version.has(BrowserENUM.Gecko)) {
+            return 'Gecko';
+        }
+        return 'Unknown';
+    }
+    getChromeVersion() {
+        return this.version.get(BrowserENUM.Chrome) || 0;
+    }
+    getEdgeVersion() {
+        return this.version.get(BrowserENUM.Edge) || 0;
+    }
+    getFirefoxVersion() {
+        return this.version.get(BrowserENUM.Firefox) || 0;
+    }
+    getGeckoVersion() {
+        return this.version.get(BrowserENUM.Gecko) || 0;
+    }
+    getMozillaVersion() {
+        return this.version.get(BrowserENUM.Mozilla) || 0;
+    }
+    getOculusVersion() {
+        return this.version.get(BrowserENUM.OculusBrowser) || 0;
+    }
+    getOperaVersion() {
+        return this.version.get(BrowserENUM.Opera) || 0;
+    }
+    getSafariVersion() {
+        return this.version.get(BrowserENUM.Safari) || 0;
+    }
+    getXVersion(x) {
+        return this.version.get(x) || 0;
+    }
+    getRaw() {
+        return this.raw;
+    }
+}

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

@@ -5,6 +5,7 @@ import BaseKernelModule from './BaseKernelModule.js';
 import BaseApiAction from './BaseApiAction.js';
 import BaseAuthProvider from './BaseAuthProvider.js';
 export * from './BaseAction.js';
+export * from './BaseUserAgent.js';
 export * from './BaseAuthProvider.js';
 export * from './timing/index.js';
 export { BaseLoopService, BaseAuthProvider, BaseKernelModule, BaseService, BaseApiAction, BaseEndpoint, BaseElement, BaseCache, BaseAction, BaseClient, BaseBridge, keepRawBody, ActionMode, };

package/dist/mjs/classes/index.js

@@ -5,6 +5,7 @@ import BaseKernelModule from './BaseKernelModule.js';
 import BaseApiAction from './BaseApiAction.js';
 import BaseAuthProvider from './BaseAuthProvider.js';
 export * from './BaseAction.js';
+export * from './BaseUserAgent.js';
 export * from './BaseAuthProvider.js';
 export * from './timing/index.js';
 export { BaseLoopService, BaseAuthProvider, BaseKernelModule, BaseService, BaseApiAction, BaseEndpoint, BaseElement, BaseCache, BaseAction, BaseClient, BaseBridge, keepRawBody, ActionMode, };

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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,47 @@
+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 {};
+    }
+}

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

@@ -1,5 +1,5 @@
 import express from 'express';
-import { IExtensionInterface, JwtToken } from '../classes/index.js';
+import { BaseUserAgent, IExtensionInterface, JwtToken } from '../classes/index.js';
 export type XRequest = express.Request & {
     rawBody?: string | null;
 };
@@ -11,4 +11,5 @@ export type XActionEvent<G = JwtToken | null> = {
     next: XNextFc;
     data: G;
     extension: IExtensionInterface;
+    agent: BaseUserAgent;
 };

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

@@ -2,7 +2,9 @@ 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 };
 export type ActionTypes = 'POST' | 'GET' | 'USE' | 'PATCH' | 'DELETE';
 export interface ICClient<T extends JwtExtend = JwtExtend> extends ICoreCClient {
     setAuthProvider(provider: IAuthProvider<T>): boolean;

package/dist/mjs/lib/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grandlinex/kernel",
-  "version": "0.32.10",
+  "version": "1.0.0",
   "description": "GrandLineX is an out-of-the-box server framework on top of ExpressJs.",
   "type": "module",
   "exports": {
@@ -25,7 +25,7 @@
     "build-fix": "node ./node_modules/@grandlinex/core/fix.js",
     "lint": "eslint src",
     "test": "jest --runInBand ",
-    "run": "ts-node tests/run.ts",
+    "run": "node --no-warnings=ExperimentalWarning --loader ts-node/esm src/tests/run.ts",
     "pack-dev": "npm version -no-git-tag-version prerelease && npm run buildprep && npm pack",
     "test-converage": "jest --runInBand --ci --collectCoverage   --coverageDirectory=\"./coverage\"  --reporters=default --reporters=jest-junit",
     "doc-converage": "jest --runInBand --ci --collectCoverage   --coverageDirectory=\"./docs/coverage\"  --reporters=default --reporters=jest-junit",
@@ -46,37 +46,37 @@
   },
   "license": "BSD-3-Clause",
   "dependencies": {
-    "@grandlinex/core": "0.32.0",
-    "@grandlinex/swagger-mate": "0.32.1",
-    "axios": "1.5.1",
+    "@grandlinex/core": "1.0.0",
+    "@grandlinex/swagger-mate": "1.0.0",
+    "axios": "1.7.2",
     "body-parser": "1.20.2",
-    "express": "4.18.2",
+    "express": "4.19.2",
     "jsonwebtoken": "9.0.2",
-    "@types/express": "^4.17.18",
-    "@types/jsonwebtoken": "^9.0.3"
+    "@types/express": "4.17.21",
+    "@types/jsonwebtoken": "9.0.6"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.5",
-    "@types/node": "^20.8.2",
-    "@typescript-eslint/eslint-plugin": "^6.7.4",
-    "@typescript-eslint/parser": "^6.7.4",
-    "cross-env": "^7.0.3",
-    "eslint": "^8.50.0",
-    "eslint-config-airbnb": "^19.0.4",
-    "eslint-config-airbnb-typescript": "^17.1.0",
-    "eslint-config-prettier": "^9.0.0",
-    "eslint-plugin-import": "^2.28.1",
-    "eslint-plugin-jest": "^27.4.2",
-    "eslint-plugin-jsx-a11y": "^6.7.1",
-    "eslint-plugin-prettier": "^5.0.0",
-    "jest": "^29.7.0",
-    "jest-junit": "^16.0.0",
-    "prettier": "3.0.3",
-    "ts-jest": "^29.1.1",
-    "ts-loader": "^9.4.4",
-    "ts-node": "^10.9.1",
-    "typedoc": "^0.25.1",
-    "typescript": "^5.2.2"
+    "@types/jest": "29.5.12",
+    "@types/node": "22.0.0",
+    "@typescript-eslint/eslint-plugin": "7.18.0",
+    "@typescript-eslint/parser": "7.18.0",
+    "cross-env": "7.0.3",
+    "eslint": "8.57.0",
+    "eslint-config-airbnb": "19.0.4",
+    "eslint-config-airbnb-typescript": "18.0.0",
+    "eslint-config-prettier": "9.1.0",
+    "eslint-plugin-import": "2.29.1",
+    "eslint-plugin-jest": "28.6.0",
+    "eslint-plugin-jsx-a11y": "6.9.0",
+    "eslint-plugin-prettier": "5.2.1",
+    "jest": "29.7.0",
+    "jest-junit": "16.0.0",
+    "prettier": "3.3.3",
+    "ts-jest": "29.1.5",
+    "ts-loader": "9.5.1",
+    "ts-node": "10.9.2",
+    "typedoc": "0.26.5",
+    "typescript": "5.5.4"
   },
   "repository": {
     "type": "git",