@yumerijs/core 3.0.0-alpha.6 → 3.0.1

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,6 +42,15 @@ export class Context {
     inject(name, value) {
         this.component[name] = value;
     }
+    /**
+     * 注册 Context 销毁时执行的回调
+     * @param callback 销毁回调
+     */
+    affect(callback) {
+        if (!callback)
+            return;
+        this.affects.push(callback);
+    }
     /**
      * 注册路由
      * @param path 路由路径
@@ -139,6 +150,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 +236,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 +270,10 @@ export class Context {
             }
             this.i18ns.length = 0;
         }
+        // 执行 Context 销毁回调
+        for (const callback of this.affects) {
+            await callback();
+        }
         // 清空内部记录
         this.components = [];
         this.routes = [];
@@ -251,5 +281,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,6 +1,6 @@
 {
   "name": "@yumerijs/core",
-  "version": "3.0.0-alpha.6",
+  "version": "3.0.1",
   "description": "Core module for yumeri",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",