oox 0.3.4 → 0.3.6

package/types/context.d.ts

@@ -0,0 +1,30 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { KeepAliveConnection, KeepAliveNativeConnection } from './keepalive-connection.js';
+export declare const asyncStore: AsyncLocalStorage<AppContext>;
+export declare class AppContext {
+    [x: string]: any;
+    traceId?: string | undefined;
+}
+export interface KeepAliveRPCContext {
+    traceId?: string;
+    sourceIP?: string;
+}
+export declare class Context extends AppContext {
+    sourceIP: string;
+    ip: string;
+    caller: string;
+    callerId: string;
+    connection?: KeepAliveConnection<KeepAliveNativeConnection>;
+    constructor(context?: Partial<Context>);
+    toJSON?(): {} & this;
+}
+export declare function setGenTraceIdFunction(fn: () => string): void;
+/**
+ * 生成随机不重复id
+ */
+export declare function genTraceId(): string;
+/**
+ * 获取链路跟踪上下文
+ */
+export declare function genContext(context?: Context): Context;
+export declare function getContext(): Context;

package/types/index.d.ts

@@ -1,56 +1,13 @@
-import * as app from './app.js';
-import * as registry from './registry.js';
-import Module, { ModuleConfig } from './modules/module.js';
-import { KeepAliveConnectionReadyParams, KeepAliveConnectionAdapter, KeepAliveConnection, KeepAliveConnectionData, keepAliveConnectionAdapters, keepAliveConnections, enabledKeepAliveConnections } from './keepalive-connection.js';
-export declare class Context extends app.Context {
-    sourceIP: string;
-    ip: string;
-    caller: string;
-    callerId: string;
-    connection?: KeepAliveConnection<any>;
-    toJSON?(): {} & this;
-}
-export declare class Config {
-    [x: string]: any;
-    id: `${string}-${string}-${string}-${string}-${string}`;
-    name: string;
-    group: string;
-    ignore: string[];
-    entryInfo: {
-        path: string;
-        group: string;
-    };
-    host: string;
-    port: number;
-    origin: string | string[];
-    errorStack: boolean;
-    isRegistry: boolean;
-    registry: string[];
-    registryAdapter: string;
-}
-export declare const config: Config;
-export declare function setGenTraceIdFunction(fn: () => string): void;
-/**
- * 生成随机不重复id
- */
-export declare function genTraceId(): string;
-/**
- * 获取链路跟踪上下文
- */
-export declare function genContext(context?: Context): Context;
-export declare function getContext(): Context;
 export declare function serve(): Promise<void>;
 export declare function stop(): Promise<void>;
-export declare function addKeepAliveConnection(connection: KeepAliveConnection<any>): void;
-export declare function removeKeepAliveConnection(connection: KeepAliveConnection<any>): void;
-export declare function removeKeepAliveConnection(name: string, id: string): void;
-export declare function setLoadBalancePolicy(policy: (name: string) => KeepAliveConnection<any>): void;
-export declare function rpc(appName: string, action: string, params: any[], context?: Context): Promise<any>;
-export declare function rpc(connection: KeepAliveConnection<any>, action: string, params: any[], context?: Context): Promise<any>;
-export { KeepAliveConnectionReadyParams, KeepAliveConnectionAdapter, KeepAliveConnection, KeepAliveConnectionData, keepAliveConnectionAdapters, keepAliveConnections, enabledKeepAliveConnections };
-export { ReturnsBody } from './app.js';
-export { Module, ModuleConfig };
+export * from './app.js';
+export * from './config.js';
+export * from './context.js';
+export * from './keepalive-connection.js';
+export * from './modules/module.js';
+export * as logger from './logger.js';
+export * from './proxy.js';
+import * as registry from './registry.js';
 export { registry };
-export declare const asyncStore: import("async_hooks").AsyncLocalStorage<app.Context>, setMethods: typeof app.setMethods, getMethods: typeof app.getMethods, kvMethods: Map<string, Function>, sourceKVMethods: Map<string, Function>, call: typeof app.call, execute: typeof app.execute, logger: typeof app.logger, on: typeof app.on, once: typeof app.once, off: typeof app.off, emit: typeof app.emit;
-import Modules from './modules/index.js';
-export declare const modules: Modules;
+import * as modules from './modules/index.js';
+export { modules };

package/types/keepalive-connection.d.ts

@@ -1,14 +1,33 @@
 import EventEmitter from 'node:events';
-import { Context } from './index.js';
+import { Context } from './context.js';
 type MakeOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-export interface KeepAliveConnectionAdapter<T> {
+export declare class KeepAliveConnectionError extends Error {
+    connection: KeepAliveConnection<KeepAliveNativeConnection>;
+    constructor(message: string, connection: KeepAliveConnection<KeepAliveNativeConnection>);
+}
+export interface KeepAliveNativeConnection {
+    disconnect(): void;
+}
+export interface KeepAliveSyncConnectionsQuery {
+    [x: string]: any;
+    name?: string | string[];
+}
+export interface KeepAliveConnectionAdapter<T extends KeepAliveNativeConnection> {
     /**
      * 连接适配器名称
      */
     name: string;
-    open(url: string | URL): Promise<KeepAliveConnection<T>>;
+    open(identify: string | URL | KeepAliveConnectionData): Promise<KeepAliveConnection<T>>;
     close(connection: KeepAliveConnection<T>): Promise<void>;
     rpc(connection: KeepAliveConnection<T>, action: string, params: any[], context: Context): Promise<any>;
+    /**
+     * 通知连接列表
+     */
+    ['registry:notify'](connection: KeepAliveConnection<T>, datas: KeepAliveConnectionData[]): void;
+    /**
+     * 订阅连接列表
+     */
+    ['registry:subscribe'](connection: KeepAliveConnection<T>, query: KeepAliveSyncConnectionsQuery): void;
 }
 export interface KeepAliveConnectionData {
     /**
@@ -18,7 +37,7 @@ export interface KeepAliveConnectionData {
     /**
      * 连接主机地址
      */
-    host: string;
+    ip: string;
     /**
      * 连接服务名称
      */
@@ -31,21 +50,26 @@ export interface KeepAliveConnectionData {
      * 目标服务网络唯一ID
      */
     id: string;
+    /**
+     * 验证令牌
+     */
+    token: string;
 }
 export interface KeepAliveConnectionReadyParams {
     [x: string]: any;
     id: KeepAliveConnectionData['id'];
     name: KeepAliveConnectionData['name'];
 }
-export type KeepAliveConnectionEventMap = Record<keyof {
-    "enabled": any;
-    "disabled": any;
-    "connect": any;
-    "disconnect": any;
-    'error': any;
-}, any[]>;
-export declare class KeepAliveConnection<T> extends EventEmitter<KeepAliveConnectionEventMap> {
+interface KeepAliveConnectionEventMap<T> {
+    "enabled": [];
+    "disabled": [];
+    "connect": [];
+    "disconnect": [];
+    'error': [KeepAliveConnectionError];
+}
+export declare class KeepAliveConnection<T extends KeepAliveNativeConnection> extends EventEmitter<KeepAliveConnectionEventMap<KeepAliveConnection<T>>> {
     #private;
+    isRegistry: boolean;
     data: KeepAliveConnectionData;
     nativeConnection: T;
     adapter: KeepAliveConnectionAdapter<T>;
@@ -62,8 +86,9 @@ export declare class KeepAliveConnection<T> extends EventEmitter<KeepAliveConnec
      * @returns
      */
     ready(params: KeepAliveConnectionReadyParams): void;
+    disconnect(): void;
 }
-export declare class KeepAliveConnectionStore<T> {
+export declare class KeepAliveConnectionStore<T extends KeepAliveNativeConnection> {
     #private;
     entries(): MapIterator<[string, Map<string, KeepAliveConnection<T>>]>;
     getConnectionsOfService(name: string): Map<string, KeepAliveConnection<T>>;
@@ -73,7 +98,18 @@ export declare class KeepAliveConnectionStore<T> {
     remove(connection: KeepAliveConnection<T>): void;
     remove(name: string, id: string): void;
 }
-export declare const keepAliveConnectionAdapters: Map<string, KeepAliveConnectionAdapter<any>>;
-export declare const keepAliveConnections: KeepAliveConnectionStore<any>;
-export declare const enabledKeepAliveConnections: KeepAliveConnectionStore<any>;
+/**
+ * 添加长连接
+ * @throws {KeepAliveConnectionError} 连接已存在
+ * @param connection
+ */
+export declare function addKeepAliveConnection(connection: KeepAliveConnection<KeepAliveNativeConnection>): void;
+export declare function removeKeepAliveConnection(connection: KeepAliveConnection<KeepAliveNativeConnection>): void;
+export declare function removeKeepAliveConnection(name: string, id: string): void;
+export declare function setLoadBalancePolicy(policy: (name: string) => KeepAliveConnection<KeepAliveNativeConnection>): void;
+export declare function rpc(appName: string, action: string, params: any[], context?: Context): Promise<any>;
+export declare function rpc(connection: KeepAliveConnection<KeepAliveNativeConnection>, action: string, params: any[], context?: Context): Promise<any>;
+export declare const keepAliveConnectionAdapters: Map<string, KeepAliveConnectionAdapter<KeepAliveNativeConnection>>;
+export declare const keepAliveConnections: KeepAliveConnectionStore<KeepAliveNativeConnection>;
+export declare const enabledKeepAliveConnections: KeepAliveConnectionStore<KeepAliveNativeConnection>;
 export {};

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

@@ -1,8 +1,9 @@
 import * as http from 'node:http';
+import * as https from 'node:https';
 import Router, { Middleware } from './router.js';
-import * as oox from '../../index.js';
-import Module, { ModuleConfig } from '../module.js';
-export declare class HTTPConfig extends ModuleConfig {
+import { Module, ModuleConfig } from '../module.js';
+export declare class HTTPConfig implements ModuleConfig {
+    enabled: boolean;
     port: number;
     path: string;
     origin: string | string[];
@@ -16,7 +17,7 @@ export declare class HTTPConfig extends ModuleConfig {
 export default class HTTPModule extends Module {
     name: string;
     config: HTTPConfig;
-    server: http.Server;
+    server: http.Server | https.Server | null;
     router: Router;
     getURL(): URL;
     get(path: string, ...args: any[]): this;
@@ -58,8 +59,4 @@ export default class HTTPModule extends Module {
             stack?: any;
         };
     }): void;
-    /**
-     * HTTP RPC
-     */
-    rpc(url: string | URL, action: string, params: Array<any>, context?: oox.Context): Promise<any>;
 }

package/types/modules/index.d.ts

@@ -1,24 +1,39 @@
-import Module from './module.js';
+import { Module } from './module.js';
 import HTTP from './http/index.js';
 import SocketIO from './socketio/index.js';
-export default class Modules extends Module {
-    #private;
-    /**
-     * the module unique name
-     */
-    name: string;
-    /**
-     * all builtin modules
-     */
-    builtins: {
-        http: HTTP;
-        socketio: SocketIO;
-    };
-    constructor();
-    add(module: Module): this;
-    get(name: string): Module;
-    remove(name: string): Promise<void>;
-    setConfig(config: any): void;
-    serve(): Promise<void>;
-    stop(): Promise<void>;
-}
+/**
+ * FIFO queue for modules starting
+ */
+export declare const queue: Module[];
+/**
+ * all modules map
+ */
+export declare const map: Map<string, Module>;
+/**
+ * add module to modules queue
+ */
+export declare function add(module: Module): void;
+/**
+ * get module by name
+ */
+export declare function get(name: string): Module | null;
+export declare function remove(name: string): Promise<void>;
+/**
+ * set modules config
+ */
+export declare function setConfig(config: any): void;
+/**
+ * serve modules
+ */
+export declare function serve(): Promise<void>;
+/**
+ * stop all modules
+ */
+export declare function stop(): Promise<void>;
+/**
+ * all builtin modules
+ */
+export declare const builtins: {
+    http: HTTP;
+    socketio: SocketIO;
+};

package/types/modules/module.d.ts

@@ -1,11 +1,11 @@
-export declare class ModuleConfig {
-    enabled: boolean;
+export interface ModuleConfig {
+    enabled?: boolean;
 }
-export default class Module {
-    config: ModuleConfig;
-    name: string;
-    setConfig(config: any): void;
-    getConfig(): ModuleConfig;
-    serve(): Promise<void>;
-    stop(): Promise<void>;
+export declare abstract class Module {
+    abstract config: ModuleConfig;
+    abstract name: string;
+    abstract setConfig(config: any): void;
+    abstract getConfig(): ModuleConfig;
+    abstract serve(): Promise<void>;
+    abstract stop(): Promise<void>;
 }

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

@@ -1,14 +1,19 @@
 import * as oox from '../../index.js';
 import { Socket } from './socket.js';
-import { OOXEvent } from './utils.js';
 import { SampleKeepAliveConnectionAdapter } from '../../samples/index.js';
 export default class SocketIOAdapter extends SampleKeepAliveConnectionAdapter<Socket> {
     name: string;
-    OOXEvent: typeof OOXEvent;
-    nativeEvent: {
+    OOXEvent: {
         CONNECT: string;
         DISCONNECT: string;
         ERROR: string;
+        CALL: string;
+        READY: string;
+        ENABLED: string;
+        DISABLED: string;
+        REGISTRY_SYNC_CONNECTIONS: string;
+        REGISTRY_SUBSCRIBE: string;
+        REGISTRY_NOTIFY: string;
     };
-    newConnection(url: string | URL): oox.KeepAliveConnection<Socket>;
+    newConnection(identify: string | URL | oox.KeepAliveConnectionData): oox.KeepAliveConnection<Socket>;
 }

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

@@ -2,10 +2,11 @@ import * as http from 'node:http';
 import * as https from 'node:https';
 import { Server, ServerOptions } from 'socket.io';
 import * as oox from '../../index.js';
-import { Module, ModuleConfig } from '../../index.js';
+import { Module, ModuleConfig } from '../module.js';
 import { Socket } from './socket.js';
 import SocketIOAdapter from './adapter.js';
-export declare class SocketIOConfig extends ModuleConfig {
+export declare class SocketIOConfig implements ModuleConfig {
+    enabled: boolean;
     port: number;
     path: string;
     origin: string | string[];
@@ -20,9 +21,10 @@ export default class SocketIOServer extends Module {
     #private;
     name: string;
     config: SocketIOConfig;
-    server: http.Server | https.Server;
-    socketServer: Server;
+    server: http.Server | https.Server | null;
+    socketServer: Server | null;
     adapter: SocketIOAdapter;
+    constructor();
     getURL(): URL;
     setConfig(config: SocketIOConfig): void;
     getConfig(): SocketIOConfig;

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

@@ -1,8 +1,14 @@
-export declare enum OOXEvent {
-    READY = "oox:ready",
-    ENABLED = "oox:enabled",
-    DISABLED = "oox:disabled",
-    SYNC_CONNECTIONS = "oox:sync_connections"
-}
+export declare const OOXEvent: {
+    CONNECT: string;
+    DISCONNECT: string;
+    ERROR: string;
+    CALL: string;
+    READY: string;
+    ENABLED: string;
+    DISABLED: string;
+    REGISTRY_SYNC_CONNECTIONS: string;
+    REGISTRY_SUBSCRIBE: string;
+    REGISTRY_NOTIFY: string;
+};
 export declare function isWebSocketURL(url: string | URL): boolean;
 export declare function genWebSocketURL(url: string): URL;

package/types/proxy.d.ts

@@ -0,0 +1 @@
+export declare function proxy(name: string, action?: string): () => void;

package/types/registry.d.ts

@@ -1,16 +1,41 @@
-import { KeepAliveConnection, KeepAliveConnectionData } from './keepalive-connection.js';
+import { ReturnsBody } from './app.js';
+import { KeepAliveConnection, KeepAliveConnectionData, KeepAliveNativeConnection } from './keepalive-connection.js';
 export interface SyncConnectionsQuery {
     name?: string | string[];
 }
+/**
+ * 取消订阅连接列表
+ * @param connection
+ */
+export declare function unsubscribe(connection: KeepAliveConnection<KeepAliveNativeConnection>): void;
+/**
+ * 订阅连接列表
+ * @param connection
+ * @param query
+ * @returns
+ */
+export declare function subscribe(connection: KeepAliveConnection<KeepAliveNativeConnection>, query: SyncConnectionsQuery): void;
+/**
+ * 停止广播连接列表
+ */
+export declare function stopBroadcastTimer(): void;
+/**
+ * 开始广播连接列表
+ */
+export declare function startBroadcastTimer(): void;
+/**
+ * 广播连接列表
+ */
+export declare function broadcast(): void;
 /**
  * 服务器发送连接列表
  * @param connection
  * @param query
  * @param callback
  */
-export declare function onSyncConnections(connection: KeepAliveConnection<any>, query: SyncConnectionsQuery, callback: (datas: KeepAliveConnectionData[]) => void): void;
+export declare function onSyncConnections(connection: KeepAliveConnection<KeepAliveNativeConnection>, query: SyncConnectionsQuery, callback: (returns: ReturnsBody<KeepAliveConnectionData[]>) => void): void;
 /**
  * 同步连接列表
  * @param datas 连接参数列表
  */
-export declare function syncConnections(datas: KeepAliveConnectionData[]): void;
+export declare function syncConnections(returns: ReturnsBody<KeepAliveConnectionData[]>): void;

package/types/samples/index.d.ts

@@ -1 +1 @@
-export { SampleKeepAliveConnectionAdapter, SampleKeepAliveNativeConnection } from './keepalive-connection-sample.js';
+export * from './keepalive-connection-sample.js';

package/types/samples/keepalive-connection-sample.d.ts

@@ -1,31 +1,41 @@
-import * as oox from '../index.js';
-export interface SampleKeepAliveNativeConnection {
+import { Context, KeepAliveRPCContext } from '../context.js';
+import { KeepAliveConnection, KeepAliveConnectionData, KeepAliveNativeConnection, KeepAliveConnectionAdapter, KeepAliveSyncConnectionsQuery } from '../keepalive-connection.js';
+import { ReturnsBody } from '../app.js';
+export interface SampleKeepAliveNativeConnection extends KeepAliveNativeConnection {
     connected: boolean;
     connect?(): void;
-    disconnect(): void;
-    on(event: string | symbol, listener: (...args: any[]) => void): any;
-    once(event: string | symbol, listener: (...args: any[]) => void): any;
-    off(event: string | symbol, listener?: (...args: any[]) => void): any;
-    emit(event: string | symbol, ...args: any[]): any;
-    removeAllListeners(event?: string | symbol): any;
+    on(event: string, listener: (...args: any[]) => any): any;
+    once(event: string, listener: (...args: any[]) => any): any;
+    off(event: string, listener?: (...args: any[]) => any): any;
+    emit(event: string, ...args: any[]): any;
+    removeAllListeners(event?: string): any;
 }
-export declare abstract class SampleKeepAliveConnectionAdapter<NativeConnection extends SampleKeepAliveNativeConnection> implements oox.KeepAliveConnectionAdapter<NativeConnection> {
-    name: string;
+export declare abstract class SampleKeepAliveConnectionAdapter<NativeConnection extends SampleKeepAliveNativeConnection> implements KeepAliveConnectionAdapter<NativeConnection> {
+    abstract name: string;
     OOXEvent: {
-        READY: string;
-        ENABLED: string;
-        DISABLED: string;
-        SYNC_CONNECTIONS: string;
-    };
-    nativeEvent: {
         CONNECT: string;
         DISCONNECT: string;
         ERROR: string;
+        CALL: string;
+        READY: string;
+        ENABLED: string;
+        DISABLED: string;
+        REGISTRY_SYNC_CONNECTIONS: string;
+        REGISTRY_SUBSCRIBE: string;
+        REGISTRY_NOTIFY: string;
     };
-    abstract newConnection(url: string | URL): oox.KeepAliveConnection<NativeConnection>;
-    bindConnectionEvents(connection: oox.KeepAliveConnection<NativeConnection>): void;
-    open(url: string | URL): Promise<oox.KeepAliveConnection<NativeConnection>>;
-    close(connection: oox.KeepAliveConnection<NativeConnection>): Promise<void>;
+    abstract newConnection(identify: string | URL | KeepAliveConnectionData): KeepAliveConnection<NativeConnection>;
+    /**
+     * 通知连接列表
+     */
+    ['registry:notify'](connection: KeepAliveConnection<NativeConnection>, datas: KeepAliveConnectionData[]): void;
+    /**
+     * 订阅连接列表
+     */
+    ['registry:subscribe'](connection: KeepAliveConnection<NativeConnection>, query: KeepAliveSyncConnectionsQuery): void;
+    bindConnectionEvents(connection: KeepAliveConnection<NativeConnection>): void;
+    open(identify: string | URL | KeepAliveConnectionData): Promise<KeepAliveConnection<NativeConnection>>;
+    close(connection: KeepAliveConnection<NativeConnection>): Promise<void>;
     /**
      * 发送事件
      * @param socket
@@ -36,11 +46,11 @@ export declare abstract class SampleKeepAliveConnectionAdapter<NativeConnection
     /**
      * RPC
      */
-    rpc(connection: oox.KeepAliveConnection<NativeConnection>, action: string, params: [], context?: oox.Context): Promise<any>;
+    rpc(connection: KeepAliveConnection<NativeConnection>, action: string, params: any[], context?: KeepAliveRPCContext): Promise<any>;
     /**
      * 绑定 call 事件
      * @param connection
      */
-    bindCall(connection: oox.KeepAliveConnection<NativeConnection>): void;
-    call(action: string, params: any[], context: oox.Context, callback?: (returns: any) => void): Promise<oox.ReturnsBody>;
+    bindCall(connection: KeepAliveConnection<NativeConnection>): void;
+    call(action: string, params: any[], context: Context, callback?: (returns: any) => void): Promise<ReturnsBody<any>>;
 }

package/utils.js

@@ -1,9 +1,9 @@
-import { networkInterfaces } from 'os';
+import { networkInterfaces } from 'node:os';
 export function getIPAddress(version = 4) {
     const interfaces = networkInterfaces();
     const ip = [];
     for (const name of Object.keys(interfaces))
-        for (const intf of interfaces[name])
+        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);