oox 0.2.0 → 0.3.0-beta10

package/types/modules/socketio/index.d.ts

@@ -0,0 +1,37 @@
+import SocketIOClient from './client';
+import * as oox from '../../index';
+import { RPCKeepAliveConnectionData, RPCConnectionAdapter } from '../../index';
+import { Socket, sockets, ServerSocket, ClientSocket } from './socket';
+export { Socket, sockets };
+export default class SocketIOModule extends SocketIOClient implements RPCConnectionAdapter {
+    sockets: Map<string, Socket>;
+    serve(): Promise<void>;
+    onSyncConnection(socket: Socket): oox.RPCKeepAliveConnectionData[];
+    serverOnDisconnect(socket: ServerSocket, reason: string): void;
+    clientOnDisconnect(socket: ClientSocket, reason: any): void;
+    /**
+     *
+     * @param socket 是由哪个通道发送过来的
+     * @param connectionDatas
+     */
+    clientOnSyncConnection(socket: Socket, connectionDatas: RPCKeepAliveConnectionData[]): void;
+    onFetchActions(socket: Socket, search: string): string[];
+    fetchActions(url: string, search?: string): Promise<RPCKeepAliveConnectionData[]>;
+    fetchActions(name: string, search?: string): Promise<RPCKeepAliveConnectionData[]>;
+    onConnection(socket: Socket): void;
+    /**
+     *
+     * @param {Socket} socket
+     */
+    serverOnConnection(socket: ServerSocket): void;
+    call(action: string, params: any[], context: oox.Context, callback?: (returns: any) => void): Promise<oox.ReturnsBody>;
+    clientOnConnection(socket: ClientSocket): void;
+    /**
+     * socketio emit
+     */
+    emit(url: string, action: string, params: any[]): Promise<unknown>;
+    /**
+     * RPC
+     */
+    rpc(url: string, action: string, params: [], context?: oox.Context): Promise<any>;
+}

package/types/modules/socketio/server.d.ts

@@ -0,0 +1,35 @@
+/// <reference types="node" />
+import * as http from 'node:http';
+import { Server, ServerOptions } from 'socket.io';
+import { Module, ModuleConfig } from '../../index';
+import { ServerSocket as Socket } from './socket';
+export declare class SocketIOConfig extends ModuleConfig {
+    port: number;
+    path: string;
+    origin: string;
+}
+export default class SocketIOServer extends Module {
+    #private;
+    name: string;
+    config: SocketIOConfig;
+    server: http.Server;
+    socketServer: Server;
+    setConfig(config: SocketIOConfig): void;
+    getConfig(): SocketIOConfig;
+    serve(): Promise<void>;
+    stop(): Promise<void>;
+    genSocketIOServerOptions(): Partial<ServerOptions>;
+    createSocketIOServer(): void;
+    /**
+     * 服务端Socket连接事件
+     */
+    serverOnSocketConnection(socket: Socket): void;
+    serverOnConnection(socket: Socket): void;
+    /**
+     * 服务端Socket断开事件
+     * @param {Socket} socket
+     * @param {Error} reason
+     */
+    serverOnSocketDisconnect(socket: Socket, reason: string): void;
+    serverOnDisconnect(socket: Socket, reason: string): void;
+}

package/types/modules/socketio/socket.d.ts

@@ -0,0 +1,11 @@
+import { Socket as _ServerSocket } from 'socket.io';
+import { Socket as _ClientSocket } from 'socket.io-client';
+import { RPCKeepAliveConnectionData } from '../../index';
+export interface ServerSocket extends _ServerSocket {
+    data: RPCKeepAliveConnectionData;
+}
+export interface ClientSocket extends _ClientSocket {
+    data: RPCKeepAliveConnectionData;
+}
+export declare type Socket = ServerSocket | ClientSocket;
+export declare const sockets: Map<string, Socket>;

package/types/utils.d.ts

@@ -0,0 +1,6 @@
+export declare function getIPAddress(version?: number): string[];
+export declare function getAllCallablePropertyNames(obj: any): string[];
+export declare function genKVMethods(methods: any, kvMethods?: Map<string, Function>, sourceKVMethods?: Map<string, Function>, nameStack?: string[]): {
+    kvMethods: Map<string, Function>;
+    sourceKVMethods: Map<string, Function>;
+};

package/utils.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genKVMethods = exports.getAllCallablePropertyNames = exports.getIPAddress = void 0;
+const os_1 = require("os");
+function getIPAddress(version = 4) {
+    const interfaces = (0, os_1.networkInterfaces)();
+    const ip = [];
+    for (const name of Object.keys(interfaces))
+        for (const intf of interfaces[name])
+            if (intf.mac !== '00:00:00:00:00:00')
+                if ((version !== 4 && version !== 6) || 'IPv' + version === intf.family)
+                    ip.push(intf.address);
+    if (!ip.length) {
+        if (version !== 6)
+            ip.push('127.0.0.1');
+        if (version !== 4)
+            ip.push('::1');
+    }
+    return ip;
+}
+exports.getIPAddress = getIPAddress;
+function getAllCallablePropertyNames(obj) {
+    if (!obj)
+        return [];
+    let props = [], tmpProps = [], index = 0, size = 0, tmpProp = '';
+    const bans = ["constructor", "__defineGetter__", "__defineSetter__",
+        "hasOwnProperty", "__lookupGetter__", "__lookupSetter__",
+        "isPrototypeOf", "propertyIsEnumerable", "toString",
+        "valueOf", "__proto__", "toLocaleString"];
+    do {
+        tmpProps = Object.getOwnPropertyNames(obj);
+        index = -1, size = tmpProps.length;
+        while (++index < size) {
+            tmpProp = tmpProps[index];
+            if (!props.includes(tmpProp) && !bans.includes(tmpProp)) {
+                props.push(tmpProp);
+            }
+        }
+    } while (obj = Object.getPrototypeOf(obj));
+    return props;
+}
+exports.getAllCallablePropertyNames = getAllCallablePropertyNames;
+function genKVMethods(methods, kvMethods = new Map(), sourceKVMethods = new Map(), nameStack = []) {
+    let keys = getAllCallablePropertyNames(methods);
+    for (const key of keys) {
+        /**
+         * @type {Function}
+         */
+        let val = methods[key];
+        if ('function' === typeof val) {
+            const action = nameStack.concat(key).join('.');
+            // 原函数绑定
+            sourceKVMethods.set(action, val);
+            // 壳函数绑定
+            kvMethods.set(action, val.bind(methods));
+        }
+        else {
+            genKVMethods(val, kvMethods, sourceKVMethods, nameStack.concat(key));
+        }
+    }
+    return { kvMethods, sourceKVMethods };
+}
+exports.genKVMethods = genKVMethods;

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/global.js

@@ -1,118 +0,0 @@
-
-if ( Error.stackTraceLimit < 20 ) Error.stackTraceLimit = 20
-
-const { AsyncLocalStorage } = require ( 'async_hooks' )
-
-const Context = require ( './rpc/context.class' )
-
-const RPC = require ( './rpc/rpc.interface.class' )
-
-const Socket = require ( './socketio/socket.class' )
-
-const SetMap = require ( './setMap.class' )
-
-const Middleware = require ( './middleware' )
-
-
-
-const Global = {
-
-
-
-    asyncStore: new AsyncLocalStorage ( ),
-
-
-
-    md: Middleware.handler,
-
-
-
-    /**
-     * @type {[RPC]}
-     */
-    instances: [ ],
-
-
-
-    /**
-     * @type {Map<String,Socket>}
-     */
-    sockets: new Map ( ),
-
-
-
-    /**
-     * @type {SocketIOServer[]}
-     */
-    socketIOServers: [ ],
-
-
-
-    /**
-     * @type {Map<String,Set<Socket>>}
-     */
-    socketIORegistry: new SetMap,
-
-
-
-    /**
-     * 生成随机不重复id
-     * @returns {String}
-     */
-    genTraceId ( ) {
-
-        const uid = [ 
-            Math.floor ( Date.now ( ) / 1000 ).toString ( 16 ),
-            Math.floor ( Math.random ( ) * 0xffffffff ).toString ( 16 ).padStart ( 8, '0' )
-        ]
-
-        return uid.join ( '' )
-    },
-
-
-
-    /**
-     * 获取链路跟踪上下文
-     * @param {Context} param0 
-     * @returns {Context}
-     */
-    genContext ( { caller, callerId, traceId, ip, sourceIP } = { } ) {
-
-        const context = new Context ( )
-
-        if ( caller ) {
-
-            context.caller = caller
-        } else {
-
-            const primaryService = this.instances [ 0 ]
-
-            if ( primaryService ) context.caller = primaryService.name
-        }
-
-        context.traceId = traceId || this.genTraceId ( )
-        context.ip = ip
-        context.sourceIP = sourceIP || ip
-        context.callerId = callerId
-
-        return context
-    },
-
-
-
-    /**
-     * 
-     * @returns {Context}
-     */
-    getContext ( ) {
-
-        const context = this.asyncStore.getStore ( )
-
-        return context || this.genContext ( )
-    },
-}
-
-/**
- * @type {Global}
- */
-global.oox = module.exports = global.oox || Global

package/middleware.js

@@ -1,167 +0,0 @@
-
-
-
-/**
- * Map<中间件名字,中间件函数>
- * @type {Map<String,Function>}
- */
-exports.middlewares = new Map ( )
-
-
-
-/**
- * WeakMap<殼函數，原函數>
- * @type {Map<String,Function>}
- */
-exports.wrappedActions = new Map ( )
-
-
-
-/**
- * Map<中间件名字,Set<接口函数>>
- * @type {Map<String,Set<Function>>}
- */
-exports.middlewareActions = new Map ( )
-
-
-
-/**
- * WeakMap<接口函数,[中间件名字]>
- * @type {WeakMap<Function,[String]>}
- */
-exports.actionMiddlewares = new WeakMap ( )
-
-
-
-/**
- * @type {Map<String,Proxy>}
- */
-exports.middlewareProxys = new Map ( )
-
-
-
-/**
- * 
- * @param {String} key 
- * @param {Function} middleware 
- * @returns {(Function)=>{}}
- */
-exports.define = ( key, middleware ) => {
-
-    if ( middleware ) {
-
-        exports.middlewares.set ( key, middleware )
-
-        exports.middlewareActions.set ( key, new Set ( ) )
-
-        const proxy = new Proxy ( middleware, {
-
-            has ( target, action ) {
-
-                const sourceMethod = exports.wrappedActions.get ( action )
-
-                return exports.middlewareActions.get ( key ).has ( sourceMethod )
-            }
-        } )
-
-        // save proxy
-        exports.middlewareProxys.set ( key, proxy )
-    } else {
-
-        return arg => exports.define ( key, arg )
-    }
-}
-
-
-
-/**
- * 
- * @param {String} key 
- * @param {Function} action 
- * @param {'start'|'end'} place 
- */
-exports.use = ( key, action, place='end' ) => {
-
-    if ( !exports.middlewareActions.has ( key ) ) exports.middlewareActions.set ( key, new Set ( ) )
-
-    if ( !exports.actionMiddlewares.has ( action ) ) exports.actionMiddlewares.set ( action, [ ] )
-
-    // 双向绑定
-
-    exports.middlewareActions.get ( key ).add ( action )
-
-    if ( place === 'end' ) {
-
-        exports.actionMiddlewares.get ( action ).push ( key )
-    } else {
-
-        exports.actionMiddlewares.get ( action ).unshift ( key )
-    }
-}
-
-
-
-exports.delete = ( key ) => {
-
-    exports.middlewares.delete ( key )
-
-    if ( exports.middlewareActions.has ( key ) ) {
-
-        const actions = exports.middlewareActions.get ( key ).values ( )
-
-        // remove action bindings
-        for ( const action of actions ) {
-
-            const middlewareNames = exports.actionMiddlewares.get ( action ).filter ( value => value !== key )
-
-            exports.actionMiddlewares.set ( action, middlewareNames )
-        }
-    }
-
-    exports.middlewareActions.get ( key ).clear ( )
-
-    exports.middlewareActions.delete ( key )
-}
-
-
-
-exports.handler = new Proxy ( o=>o, {
-
-
-
-    get ( target, key ) {
-
-        return exports.middlewareProxys.get ( key )
-    },
-
-
-
-    set ( target, key, action ) {
-
-        if ( exports.middlewares.has ( key ) ) {
-
-            exports.use ( key, action, 'start' )
-        } else {
-
-            exports.define ( key, action )
-        }
-
-        return true
-    },
-
-
-
-    deleteProperty ( target, key ) {
-
-        exports.delete ( key )
-
-        return true
-    },
-
-
-
-    apply ( target, thisArg, args ) {
-
-        return exports.define.apply ( exports, args )
-    }
-} )

package/rpc/config.class.js

@@ -1,48 +0,0 @@
-
-module.exports = class Config {
-
-
-
-    /**
-     * 服务名称
-     */
-    name = ''
-
-
-
-    /**
-     * 主机地址列表
-     */
-    host = ''
-
-
-
-    /**
-     * 跨域处理
-     */
-    origin = null
-
-
-
-    /**
-     * 网关地址
-     */
-    gateway = {
-
-
-
-        /**
-         * http 网关地址
-         * @type {{port:Number,path:String}}
-         */
-        http: null,
-
-
-
-        /**
-         * socketio 网关地址
-         * @type {{port:Number,path:String}}
-         */
-        socketio: null
-    }
-}

package/rpc/context.class.js

@@ -1,15 +0,0 @@
-
-
-module.exports = class Context {
-
-    // 请求溯源IP
-    sourceIP = ''
-    // 请求者IP
-    ip = ''
-    // 请求溯源ID
-    traceId = ''
-    // 请求者名称
-    caller = ''
-    // 请求者ID (长连接专用)
-    callerId = ''
-}