evaengine 1.0.14 → 3.0.0

package/dist/services/http_client.d.ts

@@ -0,0 +1,67 @@
+import Config from './config.js';
+import Logger from './logger.js';
+import { createRequestClient } from '../utils/request_client.js';
+import ServiceInterface from './interface.js';
+interface RequestParams {
+    url?: string;
+    uri?: string;
+    headers?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface RequestDump {
+    method: string;
+    uri?: {
+        protocol: string;
+        href: string;
+    } | null;
+    headers: Record<string, unknown>;
+    req?: object;
+    _json?: boolean;
+    formData?: Record<string, unknown> | null;
+    body?: unknown;
+    form?: (data: unknown) => {
+        body: unknown;
+    };
+}
+interface ResponseDump {
+    statusCode: number;
+    statusMessage: string;
+    headers: Record<string, unknown>;
+    body: unknown;
+}
+declare class HttpClient extends ServiceInterface {
+    config: object;
+    client: ReturnType<typeof createRequestClient>;
+    static dependencies: (typeof Config | typeof Logger)[];
+    constructor(config: Config, logger: Logger);
+    getProto(): (params?: {
+        url?: string;
+        method?: string;
+        headers?: Record<string, unknown>;
+        body?: unknown;
+        json?: unknown;
+        qs?: Record<string, unknown> | string;
+        form?: Record<string, unknown>;
+        formData?: Record<string, unknown>;
+        simple?: boolean;
+        resolveWithFullResponse?: boolean;
+        timeout?: number;
+    }) => Promise<unknown>;
+    getInstance(): (params?: {
+        url?: string;
+        method?: string;
+        headers?: Record<string, unknown>;
+        body?: unknown;
+        json?: unknown;
+        qs?: Record<string, unknown> | string;
+        form?: Record<string, unknown>;
+        formData?: Record<string, unknown>;
+        simple?: boolean;
+        resolveWithFullResponse?: boolean;
+        timeout?: number;
+    }) => Promise<unknown>;
+    request(params: RequestParams): Promise<unknown>;
+    dumpRequest(req: RequestDump, asString?: boolean): object | string;
+    dumpResponse(res: ResponseDump, asString?: boolean): object | string;
+}
+export default HttpClient;

package/dist/services/http_client.js

@@ -0,0 +1,61 @@
+import Config from "./config.js";
+import Logger from "./logger.js";
+import { createRequestClient } from "../utils/request_client.js";
+import { HttpRequestLogicException, HttpRequestIOException } from "../exceptions/index.js";
+import ServiceInterface from "./interface.js";
+class HttpClient extends ServiceInterface {
+    config;
+    client;
+    static dependencies = [Config, Logger];
+    constructor(config, logger) {
+        super();
+        this.config = config.get();
+        this.client = createRequestClient(logger);
+    }
+    getProto() {
+        return this.client;
+    }
+    getInstance() {
+        return this.client;
+    }
+    async request(params) {
+        try {
+            return await this.client(params);
+        }
+        catch (e) {
+            const { statusCode } = e;
+            if (statusCode && statusCode >= 400 && statusCode < 500) {
+                throw new HttpRequestLogicException(e);
+            }
+            throw new HttpRequestIOException(e);
+        }
+    }
+    dumpRequest(req, asString = false) {
+        const getBody = (r) => {
+            if (r._json) {
+                return r.body;
+            }
+            return r.form(r.formData).body;
+        };
+        const dump = {
+            method: req.method,
+            protocol: req.uri && req.uri.protocol === 'https:' ? 'https' : 'http',
+            url: req.uri ? req.uri.href : null,
+            headers: req.headers,
+            body: req.req && (req._json || req.formData)
+                ? getBody(req) : null
+        };
+        return asString === true ? JSON.stringify(dump) : dump;
+    }
+    dumpResponse(res, asString = false) {
+        const dump = {
+            statusCode: res.statusCode,
+            statusMessage: res.statusMessage,
+            headers: res.headers,
+            body: res.body
+        };
+        return asString === true ? JSON.stringify(dump) : dump;
+    }
+}
+export default HttpClient;
+//# sourceMappingURL=http_client.js.map

package/dist/services/http_client.js.map

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

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

@@ -10,18 +10,4 @@ import Namespace from './namespace.js';
 import Now from './now.js';
 import ValidatorBase from './joi.js';
 import EventManager from './event_manager.js';
-
-export {
-  Cache,
-  Config,
-  Env,
-  HttpClient,
-  JsonWebToken,
-  Logger,
-  Redis,
-  RestClient,
-  Namespace,
-  Now,
-  ValidatorBase,
-  EventManager
-};
+export { Cache, Config, Env, HttpClient, JsonWebToken, Logger, Redis, RestClient, Namespace, Now, ValidatorBase, EventManager };

package/dist/services/index.js

@@ -0,0 +1,14 @@
+import Cache from "./cache.js";
+import Config from "./config.js";
+import Env from "./env.js";
+import HttpClient from "./http_client.js";
+import JsonWebToken from "./jwt_token.js";
+import Logger from "./logger.js";
+import Redis from "./redis.js";
+import RestClient from "./rest_client.js";
+import Namespace from "./namespace.js";
+import Now from "./now.js";
+import ValidatorBase from "./joi.js";
+import EventManager from "./event_manager.js";
+export { Cache, Config, Env, HttpClient, JsonWebToken, Logger, Redis, RestClient, Namespace, Now, ValidatorBase, EventManager };
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,aAAa,MAAM,UAAU,CAAC;AACrC,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EACL,KAAK,EACL,MAAM,EACN,GAAG,EACH,UAAU,EACV,YAAY,EACZ,MAAM,EACN,KAAK,EACL,UAAU,EACV,SAAS,EACT,GAAG,EACH,aAAa,EACb,YAAY,EACb,CAAC"}

package/{src/services/interface.js → dist/services/interface.d.ts}

@@ -1,5 +1,3 @@
 export default class ServiceInterface {
-  getProto() {
-    return {};
-  }
+    getProto(): unknown;
 }

package/dist/services/interface.js

@@ -0,0 +1,6 @@
+export default class ServiceInterface {
+    getProto() {
+        return {};
+    }
+}
+//# sourceMappingURL=interface.js.map

package/dist/services/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/services/interface.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,QAAQ;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/{src/services/joi.js → dist/services/joi.d.ts}

@@ -1,13 +1,6 @@
 import Joi from 'joi';
 import ServiceInterface from './interface.js';
-
 export default class ValidatorBase extends ServiceInterface {
-  getProto() {
-    return Joi;
-  }
-
-  getJoi() {
-    return Joi;
-  }
+    getProto(): typeof Joi;
+    getJoi(): typeof Joi;
 }
-

package/dist/services/joi.js

@@ -0,0 +1,11 @@
+import Joi from 'joi';
+import ServiceInterface from "./interface.js";
+export default class ValidatorBase extends ServiceInterface {
+    getProto() {
+        return Joi;
+    }
+    getJoi() {
+        return Joi;
+    }
+}
+//# sourceMappingURL=joi.js.map

package/dist/services/joi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"joi.js","sourceRoot":"","sources":["../../src/services/joi.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,gBAAgB,MAAM,gBAAgB,CAAC;AAE9C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,gBAAgB;IAChD,QAAQ;QACf,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM;QACJ,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/services/jwt_token.d.ts

@@ -0,0 +1,25 @@
+import * as jwt from '../utils/jwt.js';
+import Config from './config.js';
+import Redis from './redis.js';
+import ServiceInterface from './interface.js';
+import type { Redis as RedisClient } from 'ioredis';
+interface TokenConfig {
+    prefix: string;
+    secret: string;
+}
+declare class JsonWebToken extends ServiceInterface {
+    redis: RedisClient;
+    config: TokenConfig;
+    static dependencies: (typeof Config | typeof Redis)[];
+    constructor(config: Config, redis: Redis);
+    getProto(): typeof jwt;
+    getRedis(): RedisClient;
+    getPrefix(): string;
+    save(uid: string | number, item: object): Promise<string>;
+    find(tokenString: string): Promise<unknown>;
+    clear(tokenString: string): boolean | Promise<number>;
+    getRedisKey(tokenString: string, groupOnly?: boolean): string;
+    encode(item: object, secret?: string): string;
+    decode(str: string, secret?: string): object;
+}
+export default JsonWebToken;

package/dist/services/jwt_token.js

@@ -0,0 +1,76 @@
+import * as jwt from "../utils/jwt.js";
+import Config from "./config.js";
+import Redis from "./redis.js";
+import ServiceInterface from "./interface.js";
+class JsonWebToken extends ServiceInterface {
+    redis;
+    config;
+    static dependencies = [Config, Redis];
+    constructor(config, redis) {
+        super();
+        this.redis = redis.getInstance();
+        this.config = config.get('token');
+    }
+    getProto() {
+        return jwt;
+    }
+    getRedis() {
+        return this.redis;
+    }
+    getPrefix() {
+        return this.config.prefix;
+    }
+    async save(uid, item) {
+        const toSaveItem = Object.assign({ uid }, item);
+        const tokenString = this.encode(toSaveItem);
+        const key = [this.getPrefix(), uid, tokenString.split('.').pop()].join(':');
+        //TODO 过期时间
+        await this.getRedis().set(key, JSON.stringify(toSaveItem));
+        return tokenString;
+    }
+    async find(tokenString) {
+        if (!tokenString) {
+            return { uid: null, expiredAt: 0 };
+        }
+        const parsedToken = this.decode(tokenString);
+        if (!parsedToken || !{}.hasOwnProperty.call(parsedToken, 'uid')) {
+            return { uid: null, expiredAt: 0 };
+        }
+        const key = [this.getPrefix(), parsedToken.uid, tokenString.split('.').pop()].join(':');
+        const storedToken = await this.redis.get(key);
+        if (!storedToken) {
+            return {
+                uid: parsedToken.uid,
+                expiredAt: 0
+            };
+        }
+        return JSON.parse(storedToken);
+    }
+    clear(tokenString) {
+        if (!tokenString) {
+            return true;
+        }
+        const key = this.getRedisKey(tokenString);
+        if (!key) {
+            return true;
+        }
+        return this.redis.del(key);
+    }
+    getRedisKey(tokenString, groupOnly = false) {
+        const parsedToken = this.decode(tokenString);
+        if (!parsedToken || !{}.hasOwnProperty.call(parsedToken, 'uid')) {
+            return '';
+        }
+        return groupOnly === true ?
+            [this.getPrefix(), parsedToken.uid].join(':') :
+            [this.getPrefix(), parsedToken.uid, tokenString.split('.').pop()].join(':');
+    }
+    encode(item, secret = this.config.secret) {
+        return jwt.encode(item, secret);
+    }
+    decode(str, secret = this.config.secret) {
+        return jwt.decode(str, secret);
+    }
+}
+export default JsonWebToken;
+//# sourceMappingURL=jwt_token.js.map

package/dist/services/jwt_token.js.map

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

package/dist/services/jwt_token_kong.d.ts

@@ -0,0 +1,26 @@
+import * as jwt from '../utils/jwt.js';
+import Config from './config.js';
+import RestClient from '../services/rest_client.js';
+import ServiceInterface from './interface.js';
+interface KongTokenConfig {
+    secret: string;
+    kong: {
+        endpoint: string;
+    };
+}
+declare class KongJsonWebToken extends ServiceInterface {
+    restClient: RestClient;
+    config: KongTokenConfig;
+    static dependencies: (typeof Config | typeof RestClient)[];
+    constructor(config: Config, restClient: RestClient);
+    getProto(): typeof jwt;
+    save(uid: string | number, item: {
+        username?: string;
+        expiredAt?: number;
+    }): Promise<string>;
+    find(tokenString: string): Promise<unknown>;
+    clear(tokenString: string): boolean | Promise<unknown>;
+    encode(item: object, secret?: string): string;
+    decode(str: string, secret?: string): object;
+}
+export default KongJsonWebToken;

package/dist/services/jwt_token_kong.js

@@ -0,0 +1,64 @@
+import * as jwt from "../utils/jwt.js";
+import get from 'lodash/get.js';
+import { RuntimeException } from "../exceptions/index.js";
+import Config from "./config.js";
+import RestClient from "../services/rest_client.js";
+import ServiceInterface from "./interface.js";
+class KongJsonWebToken extends ServiceInterface {
+    restClient;
+    config;
+    static dependencies = [Config, RestClient];
+    constructor(config, restClient) {
+        super();
+        this.restClient = restClient;
+        this.config = config.get('token');
+        if (!get(this.config, 'kong.endpoint')) {
+            throw new RuntimeException('config item `token.kong.endpoint` can not be null');
+        }
+    }
+    getProto() {
+        return jwt;
+    }
+    async save(uid, item) {
+        const toSaveItem = Object.assign({ uid }, item);
+        const tokenString = this.encode(toSaveItem);
+        await this.restClient.request({
+            url: `${this.config.kong.endpoint}/rbac/credentials`,
+            method: 'post',
+            body: {
+                custom_id: uid.toString(),
+                username: item.username || null,
+                key: tokenString,
+                expired_at: item.expiredAt ? item.expiredAt * 1000 : null
+            }
+        });
+        return tokenString;
+    }
+    async find(tokenString) {
+        if (!tokenString) {
+            return { uid: null, expiredAt: 0 };
+        }
+        const parsedToken = this.decode(tokenString);
+        if (!parsedToken || !{}.hasOwnProperty.call(parsedToken, 'uid')) {
+            return { uid: null, expiredAt: 0 };
+        }
+        return parsedToken;
+    }
+    clear(tokenString) {
+        if (!tokenString) {
+            return true;
+        }
+        return this.restClient.request({
+            url: `${this.config.kong.endpoint}/rbac/credentials/${tokenString}`,
+            method: 'delete'
+        });
+    }
+    encode(item, secret = this.config.secret) {
+        return jwt.encode(item, secret);
+    }
+    decode(str, secret = this.config.secret) {
+        return jwt.decode(str, secret);
+    }
+}
+export default KongJsonWebToken;
+//# sourceMappingURL=jwt_token_kong.js.map

package/dist/services/jwt_token_kong.js.map

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

package/dist/services/logger.d.ts

@@ -0,0 +1,31 @@
+import winston from 'winston';
+import Env from './env.js';
+import Config from './config.js';
+import Namespace from './namespace.js';
+import ServiceInterface from './interface.js';
+declare class Logger extends ServiceInterface {
+    env: Env;
+    config: Config;
+    namespace: Namespace;
+    level: string;
+    instance: winston.Logger | null;
+    label: string | null;
+    logfile: string | null;
+    static dependencies: (typeof Env | typeof Config | typeof Namespace)[];
+    constructor(env: Env, config: Config, namespace: Namespace);
+    getProto(): typeof winston;
+    getWinston(): typeof winston;
+    setLogFile(logfile: string): this;
+    setLabel(label: string): this;
+    setLevel(level: string): this;
+    getInstance(): winston.Logger;
+    factory(logPath: string | false, key?: string, level?: string): winston.Logger;
+    populateTraceId(args: unknown[]): [string, ...unknown[]];
+    debug(...args: unknown[]): winston.Logger;
+    verbose(...args: unknown[]): winston.Logger;
+    info(...args: unknown[]): winston.Logger;
+    warn(...args: unknown[]): winston.Logger;
+    error(...args: unknown[]): winston.Logger;
+    dump(obj: unknown): winston.Logger;
+}
+export default Logger;

package/dist/services/logger.js

@@ -0,0 +1,125 @@
+import moment from 'moment-timezone';
+import winston from 'winston';
+import { inspect } from 'util';
+import Env from "./env.js";
+import Config from "./config.js";
+import Namespace from "./namespace.js";
+import ServiceInterface from "./interface.js";
+class Logger extends ServiceInterface {
+    env;
+    config;
+    namespace;
+    level;
+    instance;
+    label;
+    logfile;
+    static dependencies = [Env, Config, Namespace];
+    constructor(env, config, namespace) {
+        super();
+        this.env = env;
+        this.config = config;
+        this.namespace = namespace;
+        let level = env.isProduction() ? 'info' : 'debug';
+        if (process.env.LOG_LEVEL) {
+            level = process.env.LOG_LEVEL;
+        }
+        this.level = level;
+        winston.level = level;
+        this.instance = null;
+        this.label = null;
+        this.logfile = null;
+    }
+    getProto() {
+        return winston;
+    }
+    getWinston() {
+        return winston;
+    }
+    setLogFile(logfile) {
+        this.logfile = logfile;
+        return this;
+    }
+    setLabel(label) {
+        this.label = label;
+        return this;
+    }
+    setLevel(level) {
+        this.level = level;
+        return this;
+    }
+    getInstance() {
+        if (this.instance) {
+            return this.instance;
+        }
+        const logPath = this.logfile || this.config.get('logger.file');
+        this.instance = this.factory(logPath);
+        return this.instance;
+    }
+    factory(logPath, key = 'global', level = this.level) {
+        const timestamp = () => moment().format();
+        return logPath ? winston.createLogger({
+            format: winston.format.combine(winston.format.splat(), winston.format.json()),
+            transports: [
+                new (winston.transports.Console)({
+                    name: `${key}-console`,
+                    timestamp,
+                    level,
+                    label: this.label
+                }),
+                new (winston.transports.File)({
+                    name: `${key}-file`,
+                    timestamp,
+                    json: false,
+                    level,
+                    label: this.label,
+                    filename: logPath
+                })
+            ]
+        }) : winston.createLogger({
+            format: winston.format.combine(winston.format.splat(), winston.format.json()),
+            transports: [
+                new (winston.transports.Console)({
+                    name: `${key}-console`,
+                    timestamp,
+                    level,
+                    label: this.label,
+                    colorize: !this.env.isProduction(),
+                    prettyPrint: !this.env.isProduction()
+                })
+            ]
+        });
+    }
+    populateTraceId(args) {
+        if (!this.namespace.get('tracer')) {
+            return args;
+        }
+        const { spanId, traceId } = (this.namespace.get('tracer') || {});
+        if (spanId) {
+            args.push(spanId);
+        }
+        if (spanId !== traceId) {
+            args.push(traceId);
+        }
+        return args;
+    }
+    debug(...args) {
+        return this.getInstance().debug(...this.populateTraceId(args));
+    }
+    verbose(...args) {
+        return this.getInstance().verbose(...this.populateTraceId(args));
+    }
+    info(...args) {
+        return this.getInstance().info(...this.populateTraceId(args));
+    }
+    warn(...args) {
+        return this.getInstance().warn(...this.populateTraceId(args));
+    }
+    error(...args) {
+        return this.getInstance().error(...this.populateTraceId(args));
+    }
+    dump(obj) {
+        return this.debug(inspect(obj, { depth: null, colors: true }));
+    }
+}
+export default Logger;
+//# sourceMappingURL=logger.js.map

package/dist/services/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/services/logger.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,gBAAgB,MAAM,gBAAgB,CAAC;AAG9C,MAAM,MAAO,SAAQ,gBAAgB;IACnC,GAAG,CAAM;IACT,MAAM,CAAS;IACf,SAAS,CAAY;IACrB,KAAK,CAAS;IACd,QAAQ,CAAwB;IAChC,KAAK,CAAgB;IACrB,OAAO,CAAgB;IAEvB,MAAM,CAAC,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAE/C,YAAY,GAAQ,EAAE,MAAc,EAAE,SAAoB;QACxD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,KAAK,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAClD,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YAC1B,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAEQ,QAAQ;QACf,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU;QACR,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW;QACT,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAmB,CAAC;QACjF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,OAAuB,EAAE,GAAG,GAAG,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC,KAAK;QACjE,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;YACpC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC7E,UAAU,EAAE;gBACV,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;oBAC/B,IAAI,EAAE,GAAG,GAAG,UAAU;oBACtB,SAAS;oBACT,KAAK;oBACL,KAAK,EAAE,IAAI,CAAC,KAAK;iBAC4B,CAAC;gBAChD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;oBAC5B,IAAI,EAAE,GAAG,GAAG,OAAO;oBACnB,SAAS;oBACT,IAAI,EAAE,KAAK;oBACX,KAAK;oBACL,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ,EAAE,OAAO;iBACyB,CAAC;aAC9C;SACF,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC7E,UAAU,EAAE;gBACV,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;oBAC/B,IAAI,EAAE,GAAG,GAAG,UAAU;oBACtB,SAAS;oBACT,KAAK;oBACL,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE;oBAClC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE;iBACQ,CAAC;aACjD;SACF,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,IAAe;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,OAAO,IAA8B,CAAC;QACxC,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAA4C,CAAC;QAC5G,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,IAA8B,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,GAAG,IAAe;QACxB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,GAAY;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;;AAGH,eAAe,MAAM,CAAC"}

package/dist/services/namespace.d.ts

@@ -0,0 +1,62 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import Config from './config.js';
+import ServiceInterface from './interface.js';
+/**
+ * CLS 语义的上下文是键值集合；AsyncLocalStorage 的 context 是单个值，
+ * 因此用 Map 承载，保持 get(key)/set(key, value) 的消费方式不变。
+ */
+type ClsContext = Map<string, unknown>;
+export declare class Store {
+    get(...args: unknown[]): unknown;
+    set(...args: unknown[]): this;
+    bind(...args: unknown[]): unknown;
+    reset(): this;
+    active(): unknown;
+    run(callback: (context?: unknown, ...args: unknown[]) => unknown, ...args: unknown[]): unknown;
+    bindEmitter(...args: unknown[]): unknown;
+    getContext(): unknown;
+    createContext(): unknown;
+}
+export declare class NullStore extends Store {
+    constructor(...args: unknown[]);
+}
+export declare class NsStore extends Store {
+    name: string;
+    storage: AsyncLocalStorage<ClsContext>;
+    constructor(name: string);
+    get(key: string): unknown;
+    set(key: string, value: unknown): this;
+    bind<T extends (...args: never[]) => unknown>(fn: T): (...args: never[]) => unknown;
+    active(): ClsContext | undefined;
+    run(callback: (context: ClsContext, ...args: unknown[]) => unknown, ...args: unknown[]): unknown;
+    bindEmitter(emitter: unknown): unknown;
+    getContext(): NsStore;
+    createContext(): ClsContext;
+    reset(): this;
+}
+interface NamespaceConfig {
+    enable?: boolean;
+}
+declare class Namespace extends ServiceInterface {
+    config: NamespaceConfig;
+    defaultName: string;
+    store: Store | null;
+    name: string | null;
+    static dependencies: (typeof Config)[];
+    constructor(config: Config);
+    isEnabled(): boolean | undefined;
+    getDefaultName(): string;
+    setDefaultName(name: string): this;
+    getName(): string | null;
+    getStore(): Store;
+    destroy(name: string): this;
+    use(ns?: string | null): Store;
+    get(key: string): unknown;
+    set(key: string, value: unknown): unknown;
+    bind(...args: unknown[]): unknown;
+    active(): unknown;
+    run(...args: unknown[]): unknown;
+    bindEmitter(...args: unknown[]): unknown;
+    createContext(): unknown;
+}
+export default Namespace;