1.1.0-alpha.0

Author: Elschnagoo

CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [1.1.0] - 2025-08-20
+### Added
+- Executable class
+- CoreKernel Extension
+### Changed
+- Update Dependencies
+- Update Logger level implementation
+- Update Database search interface for more complex queries
 ## [1.0.1] - 2024-07-30
 ### Fixed
 - Bulk operation without cache return zero elements

LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2022, GrandlineX
+Copyright (c) 2025, GrandlineX
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grandlinex/core",
-  "version": "1.0.1",
+  "version": "1.1.0-alpha.0",
   "description": "Core module",
   "type": "module",
   "exports": {
@@ -25,7 +25,7 @@
     "build-fix": "node fix.js",
     "lint": "eslint src",
     "test": "jest --runInBand",
-    "run": "ts-node-esm src/run.ts",
+    "run": "node --no-warnings=ExperimentalWarning --loader ts-node/esm src/dev/run.ts",
     "pack": "eslint && 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,11 +46,11 @@
     "reflect-metadata": "0.2.2"
   },
   "devDependencies": {
-    "@types/jest": "29.5.12",
-    "@types/node": "20.14.13",
+    "@types/jest": "29.5.14",
+    "@types/node": "22.15.20",
     "@typescript-eslint/eslint-plugin": "7.18.0",
     "@typescript-eslint/parser": "7.18.0",
-    "eslint": "8.57.0",
+    "eslint": "8.57.1",
     "eslint-config-airbnb": "19.0.4",
     "eslint-config-airbnb-typescript": "18.0.0",
     "eslint-config-prettier": "9.1.0",
@@ -60,19 +60,19 @@
     "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",
+    "prettier": "3.5.3",
+    "ts-jest": "29.3.4",
+    "ts-loader": "9.5.2",
     "ts-node": "10.9.2",
-    "typedoc": "0.26.5",
-    "typescript": "5.5.4"
+    "typedoc": "0.28.10",
+    "typescript": "5.9.2"
   },
   "homepage": "https://www.grandlinex.com/",
   "repository": {
     "type": "git",
     "url": "https://github.com/GrandlineX/core.git"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=20.0.0"
   }
 }

src/CoreKernel.ts

@@ -24,6 +24,7 @@ import {
 } from './modules/index.js';
 import CoreModule from './CoreModule.js';
 import { XUtil } from './utils/index.js';
+import CoreKernelExtension from './classes/CoreKernelExtension.js';
 
 /**
  *  Core Kernel class
@@ -79,6 +80,8 @@ export default abstract class CoreKernel<
 
   protected eventMap: Map<string, (kernel: CoreKernel<X>) => Promise<unknown>>;
 
+  protected extension: Map<string, CoreKernelExtension>;
+
   protected globalLogger: CoreLogger;
 
   /**
@@ -101,6 +104,7 @@ export default abstract class CoreKernel<
     this.updateSkip = false;
     this.appVersion = 'noVersion';
     this.triggerEvent = this.triggerEvent.bind(this);
+    this.extension = new Map<string, CoreKernelExtension>();
     this.eventMap = new Map<
       string,
       (kernel: CoreKernel<X>) => Promise<unknown>
@@ -296,8 +300,6 @@ export default abstract class CoreKernel<
 
   /**
    * register new module
-   * > In general there are two places to add Modules correctly: In the Kernel constructor or in the pre-trigger-function
-   *
    * @see CoreKernelModule
    * @param module
    * @typeParam X Type of Crypto client.
@@ -306,6 +308,23 @@ export default abstract class CoreKernel<
     this.moduleList.push(...module);
   }
 
+  /**
+   * @see CoreKernelExtension
+   * @param name Name of the extension
+   * @param ext Extension to add
+   */
+  addExtension(name: string, ext: CoreKernelExtension): void {
+    this.extension.set(name, ext);
+  }
+
+  /**
+   * @see CoreKernelExtension
+   * @param name Name of the extension
+   */
+  getExtension<A extends CoreKernelExtension>(name: string): A | undefined {
+    return this.extension.get(name) as A | undefined;
+  }
+
   setBaseModule(module: Y): void {
     this.kernelModule = module;
   }

src/CoreModule.ts

@@ -1,6 +1,6 @@
 import { CoreDBCon, CoreKernelModule } from './classes/index.js';
 import { InMemCache } from './modules/index.js';
-import { OfflineService } from './services/index.js';
+import { BackgroundService } from './services/index.js';
 import { ICoreKernel, ICoreModule } from './lib/index.js';
 import CoreDb from './database/CoreDb.js';
 
@@ -19,7 +19,7 @@ export default class CoreModule
     dbFunc: (mod: CoreModule) => CoreDBCon<any, any>,
   ) {
     super('core', kernel);
-    this.addService(new OfflineService(this));
+    this.addService(new BackgroundService(this));
     this.cdb = dbFunc(this);
   }
 

src/classes/CoreDBCon.ts

@@ -7,6 +7,7 @@ import {
   ICoreKernelModule,
   ICorePresenter,
   IDataBase,
+  QInterfaceSearch,
   QueryInterface,
   RawQuery,
 } from '../lib/index.js';
@@ -277,9 +278,7 @@ export default abstract class CoreDBCon<
    */
   abstract findEntity<E extends CoreEntity>(
     config: EntityConfig<E>,
-    search: {
-      [B in keyof E]?: E[B];
-    },
+    search: QInterfaceSearch<E>,
   ): Promise<E | null>;
 
   /**

src/classes/CoreEntityWrapper.ts

@@ -1,5 +1,10 @@
 import CoreEntity from './CoreEntity.js';
-import { ICoreCache, ICoreEntityHandler, QInterface } from '../lib/index.js';
+import {
+  ICoreCache,
+  ICoreEntityHandler,
+  QInterface,
+  QInterfaceSearch,
+} from '../lib/index.js';
 import {
   ColumnPropMap,
   ColumnProps,
@@ -150,9 +155,7 @@ export default class CoreEntityWrapper<E extends CoreEntity> {
     });
   }
 
-  async findObj(search: {
-    [P in keyof E]?: E[P];
-  }): Promise<E | null> {
+  async findObj(search: QInterfaceSearch<E>): Promise<E | null> {
     return this.e_con.findEntity<E>(
       {
         className: this.className,

src/classes/CoreKernelExtension.ts

@@ -0,0 +1,25 @@
+import {
+  ICoreCache,
+  ICoreClient,
+  ICoreElement,
+  ICoreKernel,
+  ICoreKernelModule,
+  ICorePresenter,
+  IDataBase,
+} from '../lib/index.js';
+import CoreElement from './CoreElement.js';
+
+export default abstract class CoreKernelExtension<
+    K extends ICoreKernel<any> = ICoreKernel<any>,
+    T extends IDataBase<any, any> | null = any,
+    P extends ICoreClient | null = any,
+    C extends ICoreCache | null = any,
+    E extends ICorePresenter<any> | null = any,
+  >
+  extends CoreElement<K, T, P, C, E>
+  implements ICoreElement<K, T, P, C, E>
+{
+  constructor(channel: string, module: ICoreKernelModule<K, T, P, C, E>) {
+    super(`ex-${channel}`, module);
+  }
+}