@yumerijs/core 3.0.0 → 3.0.2

package/dist/context.d.ts

@@ -4,6 +4,7 @@ import { HookHandler } from './hook.js';
 import { Middleware } from './middleware.js';
 import { IRenderer } from '@yumerijs/types';
 import { SessionStorageProcessor, Storage, SessionStorageSnapshot } from './storage.js';
+import { Service } from './service.js';
 export interface Components {
     [key: string]: any;
 }
@@ -21,6 +22,8 @@ export declare class Context {
     private childContexts;
     private childPlugins;
     private i18ns;
+    private affects;
+    private services;
     component: Components;
     renderer?: IRenderer;
     module: any;
@@ -39,6 +42,11 @@ export declare class Context {
      * @param value 依赖值
      */
     inject(name: string, value: any): void;
+    /**
+     * 注册 Context 销毁时执行的回调
+     * @param callback 销毁回调
+     */
+    affect(callback: () => void | Promise<void>): void;
     /**
      * 注册路由
      * @param path 路由路径
@@ -94,6 +102,12 @@ export declare class Context {
      * @param component 组件实例
      */
     registerComponent(name: string, component: any): void;
+    /**
+     * 注册服务
+     * @param name 服务名称
+     * @param service Service 派生类
+     */
+    registerService(name: string, service: new (context: Context) => Service): void;
     /**
      * 注册子 Context
      * @param name 子 Context 名称

package/dist/context.js

@@ -14,6 +14,8 @@ export class Context {
     childContexts = [];
     childPlugins = new Map();
     i18ns = [];
+    affects = [];
+    services = [];
     component;
     renderer;
     module;
@@ -40,13 +42,26 @@ export class Context {
     inject(name, value) {
         this.component[name] = value;
     }
+    /**
+     * 注册 Context 销毁时执行的回调
+     * @param callback 销毁回调
+     */
+    affect(callback) {
+        if (!callback)
+            return;
+        this.affects.push(callback);
+    }
     /**
      * 注册路由
      * @param path 路由路径
      * @returns Route 实例
      */
     route(routepath) {
-        const realpath = path.join(this.childpath, routepath);
+        // `root` is a special fallback route name, not a filesystem path.
+        // URL paths must use POSIX separators even when Yumeri runs on Windows.
+        const realpath = routepath === 'root'
+            ? 'root'
+            : path.posix.join(this.childpath, routepath);
         if (this.core.routes[realpath]) {
             this.core.logger.warn(`Plugin "${this.pluginname}" attempt to register route "${path}", but it has already been registered.`);
             return new Route(realpath, this);
@@ -139,6 +154,19 @@ export class Context {
         this.core.components[name] = component;
         this.components.push(name);
     }
+    /**
+     * 注册服务
+     * @param name 服务名称
+     * @param service Service 派生类
+     */
+    registerService(name, service) {
+        if (this.core.services[name]) {
+            this.core.logger.warn(`Plugin "${this.pluginname}" attempt to register service "${name}", but it has already been registered.`);
+            return;
+        }
+        this.core.services[name] = service;
+        this.services.push(name);
+    }
     /**
      * 注册子 Context
      * @param name 子 Context 名称
@@ -212,6 +240,8 @@ export class Context {
     async dispose() {
         // 删除组件
         this.components.forEach((name) => delete this.core.components[name]);
+        // 删除服务
+        this.services.forEach((name) => delete this.core.services[name]);
         // 删除路由
         this.routes.forEach((route) => delete this.core.routes[route]);
         // 删除中间件
@@ -244,6 +274,10 @@ export class Context {
             }
             this.i18ns.length = 0;
         }
+        // 执行 Context 销毁回调
+        for (const callback of this.affects) {
+            await callback();
+        }
         // 清空内部记录
         this.components = [];
         this.routes = [];
@@ -251,5 +285,7 @@ export class Context {
         this.eventlisteners = [];
         this.hooks = {};
         this.childContexts = [];
+        this.affects = [];
+        this.services = [];
     }
 }

package/dist/core.d.ts

@@ -10,6 +10,7 @@ import { Server as CoreServer } from './server.js';
 import { I18n } from './i18n.js';
 import { IRenderer } from '@yumerijs/types';
 import { SessionStorageProcessor, Storage, SessionStorageSnapshot } from './storage.js';
+import { Service } from './service.js';
 export interface Plugin {
     apply?: (ctx: Context, config: Config) => Promise<void> | void;
     disable?: (ctx: Context) => Promise<void> | void;
@@ -48,6 +49,9 @@ export declare class Core {
     components: {
         [name: string]: any;
     };
+    services: {
+        [name: string]: new (context: Context) => Service;
+    };
     routes: Record<string, Route>;
     logger: Logger;
     globalMiddlewares: Record<string, Middleware>;
@@ -71,6 +75,9 @@ export declare class Core {
     registerComponent(name: string, component: any): void;
     getComponent(name: string): any;
     unregisterComponent(name: string): void;
+    registerService(name: string, service: new (context: Context) => Service): void;
+    getService(name: string, context: Context): Service | undefined;
+    unregisterService(name: string): void;
     on(event: string, listener: (...args: any[]) => Promise<void>): void;
     emit(event: string, ...payload: any): void;
     off(event: string, listener: (...args: any[]) => Promise<void>): void;

package/dist/core.js

@@ -61,6 +61,7 @@ export const coreConfigSchema = Schema.object({
 export class Core {
     emitter = new EventEmitter();
     components = {};
+    services = {};
     routes = {};
     logger = new Logger('core');
     globalMiddlewares = {};
@@ -150,6 +151,10 @@ export class Core {
             if (component) {
                 context.inject(name, component);
             }
+            const service = this.getService(name, context);
+            if (service) {
+                context.inject(name, service);
+            }
         }
         this.logger.info(`apply plugin ${shortName}`);
         if (plugin.apply) {
@@ -165,6 +170,16 @@ export class Core {
     unregisterComponent(name) {
         delete this.components[name];
     }
+    registerService(name, service) {
+        this.services[name] = service;
+    }
+    getService(name, context) {
+        const service = this.services[name];
+        return service ? new service(context) : undefined;
+    }
+    unregisterService(name) {
+        delete this.services[name];
+    }
     on(event, listener) {
         this.emitter.on(event, (...args) => {
             // 包一层保证 async 可以被捕获

package/dist/index.d.ts

@@ -13,3 +13,4 @@ export * from './hook.js';
 export * from './middleware.js';
 export * from './i18n.js';
 export * from './storage.js';
+export * from './service.js';

package/dist/index.js

@@ -13,3 +13,4 @@ export * from './hook.js';
 export * from './middleware.js';
 export * from './i18n.js';
 export * from './storage.js';
+export * from './service.js';

package/dist/service.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from './context.js';
+export declare class Service {
+    constructor(_context: Context);
+}

package/dist/service.js

@@ -0,0 +1,3 @@
+export class Service {
+    constructor(_context) { }
+}

package/package.json

@@ -1,48 +1,48 @@
-{
-  "name": "@yumerijs/core",
-  "version": "3.0.0",
-  "description": "Core module for yumeri",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "yarn build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/yumerijs/yumeri.git"
-  },
-  "keywords": [
-    "yumeri",
-    "API"
-  ],
-  "author": "WindyPear-Team,FireGuo",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/yumerijs/yumeri/issues"
-  },
-  "homepage": "https://github.com/yumerijs/yumeri#readme",
-  "devDependencies": {
-    "@types/formidable": "^3",
-    "@types/js-yaml": "^4.0.9",
-    "@types/mime-types": "^3",
-    "@types/node": "^22.13.10",
-    "@types/semver": "^7",
-    "@types/ws": "^8",
-    "typescript": "^6.0.3"
-  },
-  "dependencies": {
-    "chokidar": "^4.0.3",
-    "formidable": "^3.5.4",
-    "js-yaml": "^4.1.0",
-    "mime-types": "^3.0.1",
-    "picocolors": "^1.1.1",
-    "semver": "^7.8.4",
-    "ws": "^8.18.3"
-  },
-  "packageManager": "yarn@4.9.1"
-}
+{
+  "name": "@yumerijs/core",
+  "version": "3.0.2",
+  "description": "Core module for yumeri",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "yarn build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yumerijs/yumeri.git"
+  },
+  "keywords": [
+    "yumeri",
+    "API"
+  ],
+  "author": "WindyPear-Team,FireGuo",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/yumerijs/yumeri/issues"
+  },
+  "homepage": "https://github.com/yumerijs/yumeri#readme",
+  "devDependencies": {
+    "@types/formidable": "^3",
+    "@types/js-yaml": "^4.0.9",
+    "@types/mime-types": "^3",
+    "@types/node": "^22.13.10",
+    "@types/semver": "^7",
+    "@types/ws": "^8",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "chokidar": "^4.0.3",
+    "formidable": "^3.5.4",
+    "js-yaml": "^4.1.0",
+    "mime-types": "^3.0.1",
+    "picocolors": "^1.1.1",
+    "semver": "^7.8.4",
+    "ws": "^8.18.3"
+  },
+  "packageManager": "yarn@4.9.1"
+}