ee-core 4.1.5 → 5.0.0-beta.5

package/core/loader/file_loader.d.ts

@@ -1,66 +0,0 @@
-/**
- * Load files from directory to target object.
- */
-export declare class FileLoader {
-    /**
-     * @class
-     * @param {Object} options - options
-     * @param {String|Array} options.directory - directories to be loaded
-     * @param {Object} options.target - attach the target object from loaded files
-     * @param {String} options.match - match the files when load, support glob, default to all js files
-     * @param {Function} options.initializer - custom file exports, receive two parameters, first is the inject object(if not js file, will be content buffer), second is an `options` object that contain `path`
-     * @param {Boolean} options.call - determine whether invoke when exports is function
-     * @param {Object} options.inject - an object that be the argument when invoke the function
-     * @param {String|Function} options.caseStyle - set property's case when converting a filepath to property list.
-     */
-    constructor(options: {
-        directory: string | any[];
-        target: any;
-        match: string;
-        initializer: Function;
-        call: boolean;
-        inject: any;
-        caseStyle: string | Function;
-    });
-    options: {
-        directory: any;
-        target: any;
-        match: any;
-        caseStyle: string;
-        initializer: any;
-        call: boolean;
-        inject: any;
-    } & {
-        directory: string | any[];
-        target: any;
-        match: string;
-        initializer: Function;
-        call: boolean;
-        inject: any;
-        caseStyle: string | Function;
-    };
-    /**
-     * attach items to target object. Mapping the directory to properties.
-     * `xxx/group/repository.js` => `target.group.repository`
-     * @return {Object} target
-     */
-    load(): any;
-    /**
-     * Parse files from given directories, then return an items list, each item contains properties and exports.
-     * For example, parse `controller/group/repository.js`
-     * It returns a item
-     * ```
-     * {
-     *   fullpath: '',
-     *   properties: [ 'group', 'repository' ],
-     *   exports: { ... },
-     * }
-     * ```
-     * `Properties` is an array that contains the directory of a filepath.
-     * `Exports` depends on type, if exports is a function, it will be called. if initializer is specified, it will be called with exports for customizing.
-     * @return {Array} items
-     */
-    parse(): any[];
-}
-export declare const EXPORTS: unique symbol;
-export declare const FULLPATH: unique symbol;

package/core/loader/file_loader.js

@@ -1,212 +0,0 @@
-'use strict';
-
-const debug = require('debug')('ee-core:core:loader:file_loader');
-const assert = require('assert');
-const fs = require('fs');
-const path = require('path');
-const globby = require('globby');
-const is = require('is-type-of');
-const { isBytecodeClass, loadFile, filePatterns } = require('../utils');
-const FULLPATH = Symbol('LOADER_ITEM_FULLPATH');
-const EXPORTS = Symbol('LOADER_ITEM_EXPORTS');
-
-const defaults = {
-  directory: null,
-  target: null,
-  match: undefined,
-  caseStyle: 'camel',
-  initializer: null,
-  call: true,
-  inject: undefined,
-};
-
-/**
- * Load files from directory to target object.
- */
-class FileLoader {
-
-  /**
-   * @class
-   * @param {Object} options - options
-   * @param {String|Array} options.directory - directories to be loaded
-   * @param {Object} options.target - attach the target object from loaded files
-   * @param {String} options.match - match the files when load, support glob, default to all js files
-   * @param {Function} options.initializer - custom file exports, receive two parameters, first is the inject object(if not js file, will be content buffer), second is an `options` object that contain `path`
-   * @param {Boolean} options.call - determine whether invoke when exports is function
-   * @param {Object} options.inject - an object that be the argument when invoke the function
-   * @param {String|Function} options.caseStyle - set property's case when converting a filepath to property list.
-   */
-  constructor(options) {
-    assert(options.directory, 'options.directory is required');
-    this.options = Object.assign({}, defaults, options);
-    debug("[constructor] options: %o", this.options);
-  }
-
-  /**
-   * attach items to target object. Mapping the directory to properties.
-   * `xxx/group/repository.js` => `target.group.repository`
-   * @return {Object} target
-   */
-  load() {
-    const items = this.parse();
-    const target = {};
-    for (const item of items) {
-      // item { fullpath, properties: [ 'a', 'b', 'c'], exports }
-      item.properties.reduce((target, property, index) => {
-        let obj;
-        // properties is a path slice, only the last value is the file name
-        if (index === item.properties.length - 1) {
-          obj = item.exports;
-          if (obj && !is.primitive(obj)) {
-            obj[FULLPATH] = item.fullpath;
-            obj[EXPORTS] = true;
-          }
-        } else {
-          obj = target[property] || {};
-        }
-        
-        target[property] = obj;
-        // const properties = item.properties.slice(0, index + 1).join('.');
-        // debug('[load] properties: %s', properties);
-        return obj;
-      }, target);
-    }
-    //debug('[load] target: %O', target);
-    return target;
-  }
-
-  /**
-   * Parse files from given directories, then return an items list, each item contains properties and exports.
-   * For example, parse `controller/group/repository.js`
-   * It returns a item
-   * ```
-   * {
-   *   fullpath: '',
-   *   properties: [ 'group', 'repository' ],
-   *   exports: { ... },
-   * }
-   * ```
-   * `Properties` is an array that contains the directory of a filepath.
-   * `Exports` depends on type, if exports is a function, it will be called. if initializer is specified, it will be called with exports for customizing.
-   * @return {Array} items
-   */
-  parse() {
-    let files = this.options.match;
-    if (!files) {
-      files = filePatterns();
-    } else {
-      files = Array.isArray(files) ? files : [ files ];
-    }
-
-    let directories = this.options.directory;
-    if (!Array.isArray(directories)) {
-      directories = [ directories ];
-    }
-
-    const items = [];
-    debug('[parse] directories %o', directories);
-    
-    for (const directory of directories) {
-      const filepaths = globby.sync(files, { cwd: directory });
-      debug('[parse] filepaths %o', filepaths);
-      for (const filepath of filepaths) {
-        const fullpath = path.join(directory, filepath);
-        if (!fs.statSync(fullpath).isFile()) continue;
-        // get properties
-        // controller/foo/bar.js => [ 'foo', 'bar' ]
-        const properties = getProperties(filepath, this.options);
-        // debug('[parse] properties %o', properties);
-        // controller/foo/bar.js => controller.foo.bar
-        const pathName = directory.split(/[/\\]/).slice(-1) + '.' + properties.join('.');
-        // debug('[parse] pathName %s', pathName);
-        // get exports from the file
-        let exports = getExports(fullpath, this.options, pathName);
-        // ignore exports when it's null or false returned by filter function
-        if (exports == null) continue;
-
-        // set properties of class
-        if (is.class(exports) || isBytecodeClass(exports)) {
-          exports.prototype.pathName = pathName;
-          exports.prototype.fullPath = fullpath;
-        }
-        items.push({ fullpath, properties, exports });
-        //debug('[parse] fullpath %s, properties %o, export %o', fullpath, properties, exports);
-      }
-    }
-    //debug('[parse] items %O', items);
-    return items;
-  }
-}
-
-// convert file path to an array of properties
-// a/b/c.js => ['a', 'b', 'c']
-function getProperties(filepath, { caseStyle }) {
-  // if caseStyle is function, return the result of function
-  if (is.function(caseStyle)) {
-    const result = caseStyle(filepath);
-    assert(is.array(result), `caseStyle expect an array, but got ${result}`);
-    return result;
-  }
-  // use default camelize
-  return defaultCamelize(filepath, caseStyle);
-}
-
-// Get exports from filepath
-// If exports is null/undefined, it will be ignored
-function getExports(fullpath, { initializer, call, inject }, pathName) {
-  let exports = loadFile(fullpath);
-  //debug('[getExports] exports %o', exports);
-  if (initializer) {
-    // exports type is Class or Object
-    exports = initializer(exports, { path: fullpath, pathName });
-  }
-
-  if (is.class(exports) || is.generatorFunction(exports) || is.asyncFunction(exports) || isBytecodeClass(exports)) {
-    return exports;
-  }
-
-  // whether to execute the function
-  if (call && is.function(exports)) {
-    exports = exports(inject);
-    if (exports != null) {
-      return exports;
-    }
-  }
-
-  return exports;
-}
-
-function defaultCamelize(filepath, caseStyle) {
-  const properties = filepath.substring(0, filepath.lastIndexOf('.')).split('/');
-  return properties.map(property => {
-    if (!/^[a-z][a-z0-9_-]*$/i.test(property)) {
-      throw new Error(`${property} is not match 'a-z0-9_-' in ${filepath}`);
-    }
-
-    // use default camelize, will capitalize the first letter
-    // foo_bar.js > FooBar
-    // fooBar.js  > FooBar
-    // FooBar.js  > FooBar
-    // FooBar.js  > FooBar
-    // FooBar.js  > fooBar
-    property = property.replace(/[_-][a-z]/ig, s => s.substring(1).toUpperCase());
-    let first = property[0];
-    switch (caseStyle) {
-      case 'lower':
-        first = first.toLowerCase();
-        break;
-      case 'upper':
-        first = first.toUpperCase();
-        break;
-      case 'camel':
-      default:
-    }
-    return first + property.substring(1);
-  });
-}
-
-module.exports = {
-  FileLoader,
-  EXPORTS,
-  FULLPATH,
-};

package/core/utils/index.d.ts

@@ -1,12 +0,0 @@
-export declare const extensions: any;
-export declare function loadFile(filepath: any): any;
-export declare function callFn(fn: any, args: any, ctx: any): Promise<any>;
-export declare function getResolvedFilename(filepath: any, baseDir: any): any;
-/**
- * 字节码类
- */
-export declare function isBytecodeClass(exports: any): boolean;
-/**
- * 文件类型
- */
-export declare function filePatterns(): string[];

package/core/utils/index.js

@@ -1,83 +0,0 @@
-'use strict';
-
-require('bytenode');
-const is = require('is-type-of');
-const path = require('path');
-const fs = require('fs');
-const BuiltinModule = require('module');
-
-// Guard against poorly mocked module constructors.
-const Module = module.constructor.length > 1
-  ? module.constructor
-  /* istanbul ignore next */
-  : BuiltinModule;
-
-// Module._extensions:
-// '.js': [Function (anonymous)],
-// '.json': [Function (anonymous)],
-// '.node': [Function: func],
-// '.jsc': [Function (anonymous)]
-
-const extensions = Module._extensions;
-
-function loadFile(filepath) {
-  try {
-    // if not js module, just return content buffer
-    const extname = path.extname(filepath);
-    if (extname && !Module._extensions[extname]) {
-      return fs.readFileSync(filepath);
-    }
-
-    // require js module
-    const obj = require(filepath);
-    if (!obj) return obj;
-    // it's es module
-    if (obj.__esModule) return 'default' in obj ? obj.default : obj;
-    return obj;
-  } catch (err) {
-    err.message = `[ee-core] load file: ${filepath}, error: ${err.message}`;
-    throw err;
-  }
-}
-
-async function callFn(fn, args, ctx) {
-  args = args || [];
-  if (!is.function(fn)) return;
-  return ctx ? fn.call(ctx, ...args) : fn(...args);
-}
-
-function getResolvedFilename(filepath, baseDir) {
-  const reg = /[/\\]/g;
-  return filepath.replace(baseDir + path.sep, '').replace(reg, '/');
-}
-
-/**
- * 字节码类
- */
-function isBytecodeClass(exports) {
-  let isClass = false;
-
-  // 标识
-  if (exports.toString().indexOf('[class') != -1) {
-    isClass = true;
-  }
-  
-  return isClass;
-}
-
-/**
- * 文件类型
- */
-function filePatterns() {
-  const files = [ '**/*.js','**/*.jsc' ];
-  return files;
-}
-
-module.exports = {
-  extensions,
-  loadFile,
-  callFn,
-  getResolvedFilename,
-  isBytecodeClass,
-  filePatterns,
-};

package/core/utils/timing.d.ts

@@ -1,22 +0,0 @@
-export declare class Timing {
-    _enable: boolean;
-    init(): void;
-    start(name: any, start: any): {
-        name: any;
-        start: any;
-        end: any;
-        duration: any;
-        pid: number;
-        index: number;
-    };
-    end(name: any): any;
-    enable(): void;
-    disable(): void;
-    clear(): void;
-    toJSON(): any[];
-    [MAP]: Map<any, any>;
-    [LIST]: any[];
-}
-declare const MAP: unique symbol;
-declare const LIST: unique symbol;
-export {};

package/core/utils/timing.js

@@ -1,78 +0,0 @@
-'use strict';
-
-const assert = require('assert');
-const MAP = Symbol('Timing#map');
-const LIST = Symbol('Timing#list');
-
-class Timing {
-
-  constructor() {
-    this._enable = true;
-    this[MAP] = new Map();
-    this[LIST] = [];
-
-    this.init();
-  }
-
-  init() {
-    // process start time
-    this.start('Process Start', Date.now() - Math.floor((process.uptime() * 1000)));
-    this.end('Process Start');
-
-    if (typeof process.scriptStartTime === 'number') {
-      // js script start execute time
-      this.start('Script Start', process.scriptStartTime);
-      this.end('Script Start');
-    }
-  }
-
-  start(name, start) {
-    if (!name || !this._enable) return;
-
-    if (this[MAP].has(name)) this.end(name);
-
-    start = start || Date.now();
-    const item = {
-      name,
-      start,
-      end: undefined,
-      duration: undefined,
-      pid: process.pid,
-      index: this[LIST].length,
-    };
-    this[MAP].set(name, item);
-    this[LIST].push(item);
-    return item;
-  }
-
-  end(name) {
-    if (!name || !this._enable) return;
-    assert(this[MAP].has(name), `should run timing.start('${name}') first`);
-
-    const item = this[MAP].get(name);
-    item.end = Date.now();
-    item.duration = item.end - item.start;
-    return item;
-  }
-
-  enable() {
-    this._enable = true;
-  }
-
-  disable() {
-    this._enable = false;
-  }
-
-  clear() {
-    this[MAP].clear();
-    this[LIST] = [];
-  }
-
-  toJSON() {
-    return this[LIST];
-  }
-}
-
-module.exports = {
-  Timing
-};

package/cross/cross.d.ts

@@ -1,19 +0,0 @@
-import { EventEmitter } from 'node:events';
-import { CrossProcess } from "./crossProcess";
-import internal = require("stream");
-export declare class Cross {
-    emitter: EventEmitter<[never]>;
-    children: {};
-    childrenMap: {};
-    create(): Promise<void>;
-    run(service: string, opt?: {}): Promise<CrossProcess>;
-    killAll(): void;
-    kill(pid: string|number): void;
-    killByName(name: string): void;
-    getUrl(name: string): string;
-    getProcByName(name: string): CrossProcess;
-    getProc(pid: string|number): CrossProcess;
-    getPids(): string[];
-    _initEventEmitter(): void;
-}
-export declare let cross: Cross;

package/cross/cross.js

@@ -1,153 +0,0 @@
-'use strict';
-
-const EventEmitter = require('events');
-const { getConfig } = require('../config');
-const { sleep, getValueFromArgv, replaceArgsValue } = require('../utils/helper');
-const { CrossProcess } = require('./crossProcess');
-const { Events } = require('../const/channel');
-const { extend } = require('../utils/extend');
-const { getPort } = require('../utils/port');
-
-class Cross {
-  constructor() {
-    this.emitter = undefined;
-
-    // pid唯一
-    // {pid:{name,entity}, pid:{name,entity}, ...}
-    this.children = {};
-  
-    // name唯一
-    // {name:pid, name:pid, ...}
-    this.childrenMap = {};
-
-    // eventEmitter
-    this._initEventEmitter();
-  }
-
-  async create() {
-
-    // boot services
-    const crossCfg = getConfig().cross;
-    //await sleep(5 * 1000);
-
-    for (let key of Object.keys(crossCfg)) {
-      let val = crossCfg[key];
-      if (val.enable == true) {
-        this.run(key)
-      }
-    }
-  }
-
-  // run
-  async run(service, opt = {}) {
-    const crossConf = getConfig().cross;
-    const defaultOpt = crossConf[service] || {};
-    const targetConf = extend(true, {}, defaultOpt, opt);
-    if (Object.keys(targetConf).length == 0) {
-      throw new Error(`[ee-core] [cross] The service [${service}] config does not exit`);
-    }
-    
-    // format params
-    let tmpArgs = targetConf.args;
-    let confPort = parseInt(getValueFromArgv(tmpArgs, 'port'));
-    // 某些程序给它传入不存在的参数时会报错
-    if (isNaN(confPort) && targetConf.port > 0) {
-      confPort = targetConf.port;
-    }
-    if (confPort > 0) {
-      // 动态生成port，传入的端口必须为int
-      confPort = await getPort({ port: confPort });
-      // 替换port
-      targetConf.args = replaceArgsValue(tmpArgs, "port", String(confPort));
-    }
-
-    // 创建进程
-    const subProcess = new CrossProcess(this, { targetConf, port: confPort });
-    let uniqueName = targetConf.name;
-    if (this.childrenMap.hasOwnProperty(uniqueName)) {
-      uniqueName = uniqueName + "-" + String(subProcess.pid);
-    }
-    this.childrenMap[uniqueName] = subProcess.pid;
-    subProcess.name = uniqueName;
-    this.children[subProcess.pid] = {
-      name: uniqueName,
-      entity: subProcess
-    };
-
-    return subProcess;
-  }
-
-  killAll() {
-    Object.keys(this.children).forEach(pid => {
-      this.kill(pid)
-    });
-  }
-
-  kill(pid) {
-    const entity = this.getProc(pid);
-    if (entity) {
-      entity.kill();
-    }
-  }
-
-  killByName(name) {
-    const entity = this.getProcByName(name);
-    if (entity) {
-      entity.kill();
-    }
-  }
-
-  getUrl(name) {
-    const entity = this.getProcByName(name);
-    const url = entity.getUrl();
-
-    return url;
-  }
-
-  // 获取 proc
-  getProcByName(name) {
-    // [todo] 如果有名字一样的服务，需要加 pid
-    const pid = this.childrenMap[name];
-    if (!pid) {
-      throw new Error(`[ee-core] [cross] The process named [${name}] does not exit`);
-    }
-    const entity = this.getProc(pid);
-
-    return entity;
-  }
-
-  // 获取 proc
-  getProc(pid) {
-    const child = this.children[pid];
-    if (!pid) {
-      throw new Error(`[ee-core] [cross] The process pid [${pid}] does not exit`);
-    }
-
-    return child.entity;
-  } 
-
-  // 获取pids  
-  getPids() {
-    let pids = Object.keys(this.children);
-    return pids;
-  }
-
-  _initEventEmitter() {
-    this.emitter = new EventEmitter();  
-    this.emitter.on(Events.childProcessExit, (data) => {
-      const child = this.children[data.pid];
-      delete this.childrenMap[child.name];
-      delete this.children[data.pid];
-    });
-    this.emitter.on(Events.childProcessError, (data) => {
-      const child = this.children[data.pid];
-      delete this.childrenMap[child.name];
-      delete this.children[data.pid];
-    });
-  }
-}  
-
-module.exports = {
-  Cross,
-  cross: new Cross()
-};

package/cross/crossProcess.d.ts

@@ -1,29 +0,0 @@
-import EventEmitter = require("events");
-export declare class CrossProcess {
-    constructor(host: any, opt?: {});
-    emitter: EventEmitter<[never]>;
-    host: any;
-    child: any;
-    pid: number;
-    port: number;
-    name: string;
-    config: {};
-    /**
-     * 初始化子进程
-     */
-    _init(options?: {}): void;
-    /**
-     * kill
-     */
-    kill(timeout?: number): void;
-    getUrl(): string;
-    getArgsObj(): {
-        _: any[];
-    };
-    setPort(port: string|number): void;
-    _generateId(): string;
-    /**
-     * exit electron
-     */
-    _exitElectron(timeout?: number): void;
-}