evaengine 1.0.14 → 2.0.0

package/dist/middlewares/debug.js

@@ -0,0 +1,50 @@
+import morgan from 'morgan';
+import os from 'os';
+import constitute from 'constitute';
+import Logger from "../services/logger.js";
+/**
+ Log format:
+ NCSA Combined Log Format + extended fields
+
+ Nginx config as below
+
+ log_format upstream '$http_x_forwarded_for - $remote_user [$time_local] '
+ '"$request" $status $body_bytes_sent '
+ '"$http_referer" "$http_user_agent" '
+ '"$remote_addr" $host $request_time $upstream_response_time $scheme $server_port '
+ '$hostname $upstream_addr $http_x_device_id $sent_http_x_uid $sent_http_x_token '
+ '$sent_http_x_service_name $sent_http_x_b3_spanid $sent_http_x_b3_traceid '
+ '$sent_http_x_b3_parentspanid $sent_http_x_b3_sampled';
+ */
+morgan.token('host', req => req.headers.host);
+morgan.token('real-ip', req => req.headers['x-real-ip'] ||
+    req.headers['x-forwarded-for'] ||
+    req.ip ||
+    (req.connection && req.connection.remoteAddress));
+morgan.token('port', req => ((req.headers.host && req.headers.host.split(':')[1]) || -1));
+const hostname = os.hostname();
+morgan.token('hostname', () => hostname);
+morgan.token('tokens', (req, res) => [
+    res.getHeader('X-Uid') || '-',
+    res.getHeader('X-Token') || '-'
+].join(' '));
+morgan.token('tracer', (req, res) => [
+    res.getHeader('X-Service-Name') || '-',
+    res.getHeader('X-B3-SpanId') || '-',
+    res.getHeader('X-B3-TraceId') || '-',
+    res.getHeader('X-B3-ParentSpanId') || '-',
+    res.getHeader('X-B3-Sampled') || '-'
+].join(' '));
+function DebugMiddleware(logger) {
+    return () => morgan(':real-ip - :remote-user [:date[clf]] ":method :url HTTP/:http-version" :status :res[content-length] ":referrer" ":user-agent" ' +
+        '":remote-addr" :host :response-time - :http-version :port :hostname - :tokens :tracer %s', {
+        stream: {
+            write: (message) => {
+                logger.info(message);
+            }
+        }
+    });
+}
+constitute.Dependencies(Logger)(DebugMiddleware);
+export default DebugMiddleware;
+//# sourceMappingURL=debug.js.map

package/dist/middlewares/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/middlewares/debug.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,MAAM,MAAM,uBAAuB,CAAC;AAG3C;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,KAAK,CACV,MAAM,EACN,GAAG,CAAC,EAAE,CACJ,GAAG,CAAC,OAAO,CAAC,IAAI,CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,CACV,SAAS,EACT,GAAG,CAAC,EAAE,CACJ,GAAG,CAAC,OAAO,CAAC,WAAW,CAAW;IAClC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAW;IACxC,GAAG,CAAC,EAAE;IACN,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CACnD,CAAC;AAEF,MAAM,CAAC,KAAK,CACV,MAAM,EACN,GAAG,CAAC,EAAE,CACJ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,CACzE,CAAC;AAEF,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AAC/B,MAAM,CAAC,KAAK,CAAoB,UAAU,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;AAE5D,MAAM,CAAC,KAAK,CACV,QAAQ,EACR,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CACX;IACE,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,GAAG;IAC7B,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,GAAG;CAChC,CAAC,IAAI,CAAC,GAAG,CAAC,CACd,CAAC;AAEF,MAAM,CAAC,KAAK,CACV,QAAQ,EACR,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CACX;IACE,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,GAAG;IACtC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,GAAG;IACnC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,GAAG;IACpC,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,GAAG;IACzC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,GAAG;CACrC,CAAC,IAAI,CAAC,GAAG,CAAC,CACd,CAAC;AAGF,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,GAAG,EAAE,CACV,MAAM,CACJ,gIAAgI;QAChI,0FAA0F,EAC1F;QACE,MAAM,EAAE;YACN,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;gBACjB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;SACF;KACF,CACF,CAAC;AACN,CAAC;AAED,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;AACjD,eAAe,eAAe,CAAC"}

package/{src/middlewares/index.js → dist/middlewares/index.d.ts}

@@ -5,14 +5,4 @@ import SessionMiddleware from './session.js';
 import TraceMiddleware from './trace.js';
 import ViewCacheMiddleware from './view_cache.js';
 import ValidatorMiddleware from './validator.js';
-
-export {
-  AuthMiddleware,
-  AuthKongMiddleware,
-  DebugMiddleware,
-  SessionMiddleware,
-  TraceMiddleware,
-  ViewCacheMiddleware,
-  ValidatorMiddleware
-};
-
+export { AuthMiddleware, AuthKongMiddleware, DebugMiddleware, SessionMiddleware, TraceMiddleware, ViewCacheMiddleware, ValidatorMiddleware };

package/dist/middlewares/index.js

@@ -0,0 +1,9 @@
+import AuthMiddleware from "./auth.js";
+import AuthKongMiddleware from "./auth_kong.js";
+import DebugMiddleware from "./debug.js";
+import SessionMiddleware from "./session.js";
+import TraceMiddleware from "./trace.js";
+import ViewCacheMiddleware from "./view_cache.js";
+import ValidatorMiddleware from "./validator.js";
+export { AuthMiddleware, AuthKongMiddleware, DebugMiddleware, SessionMiddleware, TraceMiddleware, ViewCacheMiddleware, ValidatorMiddleware };
+//# sourceMappingURL=index.js.map

package/dist/middlewares/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middlewares/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,WAAW,CAAC;AACvC,OAAO,kBAAkB,MAAM,gBAAgB,CAAC;AAChD,OAAO,eAAe,MAAM,YAAY,CAAC;AACzC,OAAO,iBAAiB,MAAM,cAAc,CAAC;AAC7C,OAAO,eAAe,MAAM,YAAY,CAAC;AACzC,OAAO,mBAAmB,MAAM,iBAAiB,CAAC;AAClD,OAAO,mBAAmB,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACpB,CAAC"}

package/dist/middlewares/providers.d.ts

@@ -0,0 +1,25 @@
+import { ServiceProvider } from '../services/providers.js';
+export declare class SessionMiddlewareProvider extends ServiceProvider {
+    get name(): string;
+    register(): void;
+}
+export declare class AuthMiddlewareProvider extends ServiceProvider {
+    get name(): string;
+    register(): void;
+}
+export declare class DebugMiddlewareProvider extends ServiceProvider {
+    get name(): string;
+    register(): void;
+}
+export declare class ViewCacheMiddlewareProvider extends ServiceProvider {
+    get name(): string;
+    register(): void;
+}
+export declare class TraceMiddlewareProvider extends ServiceProvider {
+    get name(): string;
+    register(): void;
+}
+export declare class ValidatorMiddlewareProvider extends ServiceProvider {
+    get name(): string;
+    register(): void;
+}

package/dist/middlewares/providers.js

@@ -0,0 +1,63 @@
+import SessionMiddleware from "../middlewares/session.js";
+import AuthMiddleware from "../middlewares/auth.js";
+import AuthKongMiddleware from "../middlewares/auth_kong.js";
+import DebugMiddleware from "../middlewares/debug.js";
+import TraceMiddleware from "../middlewares/trace.js";
+import ViewCacheMiddleware from "../middlewares/view_cache.js";
+import ValidatorMiddleware from "../middlewares/validator.js";
+import DI from "../di.js";
+import { ServiceProvider } from "../services/providers.js";
+export class SessionMiddlewareProvider extends ServiceProvider {
+    get name() {
+        return 'session';
+    }
+    register() {
+        DI.bindMethod(this.name, SessionMiddleware);
+    }
+}
+export class AuthMiddlewareProvider extends ServiceProvider {
+    get name() {
+        return 'auth';
+    }
+    register() {
+        if (DI.get('config').get('token.provider') === 'kong') {
+            DI.bindMethod(this.name, AuthKongMiddleware);
+        }
+        else {
+            DI.bindMethod(this.name, AuthMiddleware);
+        }
+    }
+}
+export class DebugMiddlewareProvider extends ServiceProvider {
+    get name() {
+        return 'debug';
+    }
+    register() {
+        DI.bindMethod(this.name, DebugMiddleware);
+    }
+}
+export class ViewCacheMiddlewareProvider extends ServiceProvider {
+    get name() {
+        return 'view_cache';
+    }
+    register() {
+        DI.bindMethod(this.name, ViewCacheMiddleware);
+    }
+}
+export class TraceMiddlewareProvider extends ServiceProvider {
+    get name() {
+        return 'trace';
+    }
+    register() {
+        DI.bindMethod(this.name, TraceMiddleware);
+    }
+}
+export class ValidatorMiddlewareProvider extends ServiceProvider {
+    get name() {
+        return 'validator';
+    }
+    register() {
+        DI.bindMethod(this.name, ValidatorMiddleware);
+    }
+}
+//# sourceMappingURL=providers.js.map

package/dist/middlewares/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/middlewares/providers.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,2BAA2B,CAAC;AAC1D,OAAO,cAAc,MAAM,wBAAwB,CAAC;AACpD,OAAO,kBAAkB,MAAM,6BAA6B,CAAC;AAC7D,OAAO,eAAe,MAAM,yBAAyB,CAAC;AACtD,OAAO,eAAe,MAAM,yBAAyB,CAAC;AACtD,OAAO,mBAAmB,MAAM,8BAA8B,CAAC;AAC/D,OAAO,mBAAmB,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IAC5D,IAAa,IAAI;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAEQ,QAAQ;QACf,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,eAAe;IACzD,IAAa,IAAI;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IAEQ,QAAQ;QACf,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,MAAM,EAAE,CAAC;YACtD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,IAAa,IAAI;QACf,OAAO,OAAO,CAAC;IACjB,CAAC;IAEQ,QAAQ;QACf,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,eAAe;IAC9D,IAAa,IAAI;QACf,OAAO,YAAY,CAAC;IACtB,CAAC;IAEQ,QAAQ;QACf,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,IAAa,IAAI;QACf,OAAO,OAAO,CAAC;IACjB,CAAC;IAEQ,QAAQ;QACf,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,eAAe;IAC9D,IAAa,IAAI;QACf,OAAO,WAAW,CAAC;IACrB,CAAC;IAEQ,QAAQ;QACf,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/middlewares/session.d.ts

@@ -0,0 +1,6 @@
+import Config from '../services/config.js';
+import Redis from '../services/redis.js';
+import Namespace from '../services/namespace.js';
+import type { RequestHandler } from 'express';
+declare function SessionMiddleware(_config: Config, redis: Redis, namespace: Namespace): () => RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>;
+export default SessionMiddleware;

package/dist/middlewares/session.js

@@ -0,0 +1,51 @@
+import session from 'express-session';
+import { RedisStore } from 'connect-redis';
+import constitute from 'constitute';
+import DI from "../di.js";
+import Config from "../services/config.js";
+import Redis from "../services/redis.js";
+import Namespace from "../services/namespace.js";
+let middleware = null;
+//Fix issue https://github.com/othiym23/node-continuation-local-storage/issues/29
+const clsifyMiddleware = (fn, ns) => (req, res, next) => fn.call(this, req, res, ns.bind(next));
+function SessionMiddleware(_config, redis, namespace) {
+    return () => {
+        if (middleware) {
+            return middleware;
+        }
+        const Store = RedisStore;
+        let store = null;
+        const config = _config.get().session;
+        if (config.store) {
+            const RedisClient = new Store(Object.assign({}, config.store, {
+                client: config.store.client || redis.getInstance()
+            }));
+            RedisClient.client.on('error', (err) => {
+                try {
+                    DI.get('logger').error('Session Redis store error:', err);
+                }
+                catch {
+                    console.error('Session Redis store error:', err);
+                }
+            });
+            store = RedisClient;
+        }
+        else {
+            store = new Store(Object.assign({}, { client: redis.getInstance() }));
+        }
+        middleware = session({
+            store,
+            cookie: Object.assign({}, _config.get().cookie),
+            secret: config.secret,
+            resave: config.resave,
+            saveUninitialized: config.saveUninitialized
+        });
+        return namespace.isEnabled() ?
+            //Store 基类 getContext() 类型为 unknown，运行时由 NsStore 返回 CLS namespace
+            clsifyMiddleware(middleware, namespace.use().getContext()) :
+            middleware;
+    };
+}
+constitute.Dependencies(Config, Redis, Namespace)(SessionMiddleware);
+export default SessionMiddleware;
+//# sourceMappingURL=session.js.map

package/dist/middlewares/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/middlewares/session.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,MAAM,MAAM,uBAAuB,CAAC;AAC3C,OAAO,KAAK,MAAM,sBAAsB,CAAC;AACzC,OAAO,SAAS,MAAM,0BAA0B,CAAC;AAIjD,IAAI,UAAU,GAA0B,IAAI,CAAC;AAE7C,iFAAiF;AACjF,MAAM,gBAAgB,GAAG,CAAC,EAAkB,EAAE,EAAgB,EAAkB,EAAE,CAChF,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CACjB,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAS3C,SAAS,iBAAiB,CAAC,OAAe,EAAE,KAAY,EAAE,SAAoB;IAC5E,OAAO,GAAG,EAAE;QACV,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC;QACzB,IAAI,KAAK,GAA2C,IAAI,CAAC;QACzD,MAAM,MAAM,GAAI,OAAO,CAAC,GAAG,EAAiC,CAAC,OAAO,CAAC;QAErE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE;gBAC5D,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE;aACnD,CAAC,CAAC,CAAC;YACJ,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACrC,IAAI,CAAC;oBACH,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;gBAC5D,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC,CAAC,CAAC;YACH,KAAK,GAAG,WAAW,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;QACxE,CAAC;QAED,UAAU,GAAG,OAAO,CAAC;YACnB,KAAK;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAG,OAAO,CAAC,GAAG,EAA0B,CAAC,MAAM,CAAC;YACxE,MAAM,EAAE,MAAM,CAAC,MAAgB;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;SAC5C,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;YAC5B,iEAAiE;YACjE,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC,UAAU,EAAkB,CAAC,CAAC,CAAC;YAC5E,UAAU,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AACD,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAErE,eAAe,iBAAiB,CAAC"}

package/dist/middlewares/trace.d.ts

@@ -0,0 +1,52 @@
+import Namespace from '../services/namespace.js';
+import Config from '../services/config.js';
+import Logger from '../services/logger.js';
+import HttpClient from '../services/http_client.js';
+import type { Request, Response, NextFunction } from 'express';
+interface ZipkinEndpoint {
+    serviceName: unknown;
+    ipv4: string;
+    port: unknown;
+}
+interface ZipkinAnnotation {
+    endpoint: ZipkinEndpoint;
+    timestamp: number;
+    value: string;
+}
+interface ZipkinBinaryAnnotation {
+    key: string;
+    value: unknown;
+}
+interface ZipkinSpan {
+    id: string;
+    traceId: string;
+    name: string;
+    timestamp: number;
+    duration: number;
+    annotations: ZipkinAnnotation[];
+    binaryAnnotations: ZipkinBinaryAnnotation[];
+    parentId?: string;
+}
+interface TracerQuery {
+    query: unknown;
+    cost: number;
+    finishedAt: number;
+}
+interface Tracer {
+    serviceName: unknown;
+    method: string;
+    url: string;
+    port: string | number;
+    spanId: string;
+    traceId: string;
+    parentId: string;
+    sampled: number;
+    timestamp: number;
+    duration: number;
+    statusCode: number;
+    queries: TracerQuery[];
+    debug: Record<string, unknown>;
+}
+export declare const tracerToZipkins: (tracer: Tracer | null | undefined) => false | ZipkinSpan[];
+declare function TraceMiddleware(ns: Namespace, config: Config, logger: Logger, client: HttpClient): (name?: string) => (req: Request, res: Response, next: NextFunction) => void;
+export default TraceMiddleware;

package/dist/middlewares/trace.js

@@ -0,0 +1,225 @@
+import constitute from 'constitute';
+import { randomString, getHostFullUrl, getHostPort, getHostIp, getMicroTimestamp } from "../utils/index.js";
+import Namespace from "../services/namespace.js";
+import Config from "../services/config.js";
+import Logger from "../services/logger.js";
+import HttpClient from "../services/http_client.js";
+const hostIp = getHostIp();
+/**
+ * Execute a listener when a response is about to write headers.
+ * Inlined from the on-headers package (MIT), limited to the behavior trace middleware needs.
+ */
+const onHeaders = (res, listener) => {
+    if (!res) {
+        throw new TypeError('argument res is required');
+    }
+    if (typeof listener !== 'function') {
+        throw new TypeError('argument listener must be a function');
+    }
+    //writeHead 在 ServerResponse 上是重载签名，补丁替换按可变参数收敛为 unknown，运行时仍透传全部实参
+    const prevWriteHead = res.writeHead;
+    let fired = false;
+    res.writeHead = function writeHead(...args) {
+        if (!fired) {
+            fired = true;
+            listener.call(this);
+        }
+        return prevWriteHead.apply(this, args);
+    };
+};
+export const tracerToZipkins = (tracer) => {
+    if (!tracer) {
+        return false;
+    }
+    const { url, method, serviceName, spanId: id, traceId, parentId, timestamp, duration, statusCode, port, queries } = tracer;
+    const name = `${statusCode} ${method} ${url}`;
+    const endpoint = {
+        serviceName,
+        ipv4: hostIp,
+        port
+    };
+    const zipkin = {
+        id,
+        traceId,
+        name,
+        timestamp,
+        duration,
+        annotations: [
+            {
+                endpoint,
+                timestamp,
+                value: 'sr'
+            },
+            {
+                endpoint,
+                timestamp: timestamp + duration,
+                value: 'ss'
+            }
+        ],
+        binaryAnnotations: [
+            {
+                key: 'traceId',
+                value: traceId
+            },
+            {
+                key: 'spanId',
+                value: id
+            },
+            {
+                key: 'method',
+                value: method
+            },
+            {
+                key: 'url',
+                value: url
+            },
+            {
+                key: 'port',
+                value: port.toString()
+            },
+            {
+                key: 'statusCode',
+                value: statusCode.toString()
+            }
+        ]
+    };
+    if (parentId) {
+        zipkin.parentId = parentId;
+    }
+    const zipkins = [zipkin];
+    if (queries && queries.length > 0) {
+        queries.forEach((element) => {
+            const { query, cost, finishedAt } = element;
+            zipkins.push({
+                id: randomString(),
+                parentId: id,
+                traceId,
+                name: 'sequelize',
+                timestamp: finishedAt - cost,
+                duration: cost,
+                annotations: [
+                    {
+                        endpoint,
+                        timestamp: finishedAt - cost,
+                        value: 'cs'
+                    },
+                    {
+                        endpoint,
+                        timestamp: finishedAt,
+                        value: 'cr'
+                    }
+                ],
+                binaryAnnotations: [{
+                        key: 'query',
+                        value: query
+                    }]
+            });
+        });
+    }
+    return zipkins;
+};
+function TraceMiddleware(ns, config, logger, client) {
+    const enabled = config.get('trace.enable');
+    return (name) => (req, res, next) => {
+        const spanId = randomString();
+        const traceId = req.get('X-B3-TraceId') || spanId;
+        const parentId = req.get('X-B3-SpanId') || '';
+        const startedAt = process.hrtime();
+        const timestamp = getMicroTimestamp();
+        const serviceName = name || config.get('app.name');
+        //目前默认全部采样
+        let sampled = enabled ? 1 : 0;
+        //只有service为第二级, 且通过参数关闭时才禁止采样
+        if (sampled && parseInt(req.get('X-B3-Sampled'), 10) < 1 && parentId > 0) {
+            sampled = 0;
+        }
+        const tracer = {
+            serviceName,
+            method: req.method,
+            url: getHostFullUrl(req),
+            port: getHostPort(req),
+            spanId,
+            traceId,
+            parentId,
+            sampled,
+            timestamp,
+            //初始为 null，响应头写出后由下方 onHeaders 回填，类型按回填后的形态声明
+            duration: null,
+            statusCode: null,
+            queries: [],
+            debug: {}
+        };
+        res.set({
+            'X-Service-Name': serviceName,
+            'X-Requested-At': timestamp,
+            'X-B3-SpanId': spanId,
+            'X-B3-TraceId': traceId,
+            'X-B3-ParentSpanId': parentId,
+            'X-B3-Sampled': sampled
+        });
+        if (sampled < 1) {
+            onHeaders(res, () => {
+                const [seconds, nanoseconds] = process.hrtime(startedAt);
+                const duration = ((seconds * 1e3) + (nanoseconds * 1e-6));
+                //express 的 set 类型仅声明 string，运行时 Node 接受数字并自动强转
+                res.set('X-Response-Milliseconds', parseInt(duration, 10));
+            });
+            next();
+            return;
+        }
+        onHeaders(res, () => {
+            const [seconds, nanoseconds] = process.hrtime(startedAt);
+            const duration = ((seconds * 1e3) + (nanoseconds * 1e-6)) * 1000;
+            tracer.duration = parseInt(duration, 10);
+            tracer.statusCode = res.statusCode;
+            res.set('X-Response-Milliseconds', (tracer.duration / 1000));
+            const useHeader = config.get('trace.header');
+            if (!useHeader) {
+                return;
+            }
+            const zipkins = tracerToZipkins(tracer);
+            if (!zipkins) {
+                logger.warn('Tracer not send by no data for request %s', spanId);
+            }
+            else {
+                res.set(`X-Debug-${spanId}`, JSON.stringify(zipkins));
+            }
+            if (Object.keys(tracer.debug).length > 0) {
+                Object.entries(tracer.debug).forEach(([key, value]) => {
+                    res.set(key.replace('x-debug', 'X-Debug'), value);
+                });
+            }
+        });
+        const recordZipkin = () => {
+            const api = config.get('trace.api');
+            if (!api) {
+                return;
+            }
+            logger.debug('Tracer prepare to send for request %s', spanId);
+            const zipkins = tracerToZipkins(ns.get('tracer'));
+            if (!zipkins) {
+                logger.warn('Tracer not send by no data for request %s', spanId);
+                return;
+            }
+            client.request({
+                url: api,
+                method: 'POST',
+                json: zipkins
+            }).catch((e) => {
+                logger.error('Error happened on sending tracing data: %o', e);
+            });
+        };
+        res.on('finish', recordZipkin);
+        res.on('error', recordZipkin);
+        ns.bindEmitter(req);
+        ns.bindEmitter(res);
+        ns.run(() => {
+            // logger.debug('Tracer settled for request %s, tracer: %j', spanId, tracer);
+            ns.set('tracer', tracer);
+            next();
+        });
+    };
+}
+constitute.Dependencies(Namespace, Config, Logger, HttpClient)(TraceMiddleware);
+export default TraceMiddleware;
+//# sourceMappingURL=trace.js.map

package/dist/middlewares/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/middlewares/trace.ts"],"names":[],"mappings":"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"}

package/dist/middlewares/validator.d.ts

@@ -0,0 +1,10 @@
+import Joi from 'joi';
+import ValidatorBase from '../services/joi.js';
+import type { Schema, AsyncValidationOptions } from 'joi';
+type ValidatorSchemas = {
+    query?: Schema;
+    body?: Schema;
+    path?: Schema;
+};
+declare function ValidatorMiddleware(validatorBase: ValidatorBase): (getSchema: (joi: typeof Joi) => ValidatorSchemas, options?: AsyncValidationOptions, validator?: typeof Joi) => import("express").RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>;
+export default ValidatorMiddleware;

package/dist/middlewares/validator.js

@@ -0,0 +1,43 @@
+import Joi from 'joi';
+import constitute from 'constitute';
+import wrapper from "../utils/wrapper.js";
+import { FormInvalidateException } from "../exceptions/index.js";
+import ValidatorBase from "../services/joi.js";
+const validate = (data, schema, options) => {
+    const validationOptions = Object.assign({ abortEarly: false, allowUnknown: true }, options);
+    if (schema && typeof schema.validateAsync === 'function') {
+        return schema.validateAsync(data, validationOptions);
+    }
+    //joi 18 已移除 legacy Joi.validate API，该分支仅在 schema 无 validateAsync 时可达，保留原调用形态
+    return new Promise((resolve, reject) => {
+        Joi.validate(data, schema, validationOptions, (err, value) => {
+            if (err)
+                reject(err);
+            else
+                resolve(value);
+        });
+    });
+};
+function ValidatorMiddleware(validatorBase) {
+    return (getSchema, options, validator) => wrapper(async (req, res, next) => {
+        const { query, body, path } = getSchema(validator || validatorBase.getJoi());
+        try {
+            if (query) {
+                await validate(req.query, query, options);
+            }
+            if (body) {
+                await validate(req.body, body, options);
+            }
+            if (path) {
+                await validate(req.params, path, options);
+            }
+            return next();
+        }
+        catch (e) {
+            throw new FormInvalidateException(e);
+        }
+    });
+}
+constitute.Dependencies(ValidatorBase)(ValidatorMiddleware);
+export default ValidatorMiddleware;
+//# sourceMappingURL=validator.js.map

package/dist/middlewares/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/middlewares/validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAS/C,MAAM,QAAQ,GAAG,CAAC,IAAa,EAAE,MAAc,EAAE,OAAgC,EAAoB,EAAE;IACrG,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CACrC,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EACzC,OAAO,CACR,CAAC;IACF,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QACzD,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACvD,CAAC;IACD,6EAA6E;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpC,GAEC,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC1D,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,mBAAmB,CAAC,aAA4B;IACvD,OAAO,CAAC,SAAgD,EAAE,OAAgC,EAAE,SAAsB,EAAE,EAAE,CACpH,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,SAAS,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,uBAAuB,CAAC,CAAU,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAE5D,eAAe,mBAAmB,CAAC"}

package/dist/middlewares/view_cache.d.ts

@@ -0,0 +1,14 @@
+import Logger from '../services/logger.js';
+import Cache from '../services/cache.js';
+import type { Request, Response } from 'express';
+export declare const defaultHashStrategy: <T>(obj: T) => T;
+export declare const defaultHeadersFilter: (res: Response) => Array<[string, string]>;
+export declare const requestToCacheKey: (req: Request, hashStrategy?: unknown) => string;
+interface ViewCacheOptions {
+    ttl?: number | string | null;
+    headersFilter?: (res: Response) => Array<[string, string]>;
+    hashStrategy?: unknown;
+    namespace?: string;
+}
+declare function ViewCacheMiddleware(cache: Cache, logger: Logger): (options?: ViewCacheOptions | number | string | null) => import("express").RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>;
+export default ViewCacheMiddleware;