@tencent-rtc/mcp 1.0.6 → 1.0.7

package/libs/@tencent/polaris/dist/polaris.d.ts

@@ -0,0 +1,33 @@
+export * as plugins from "./plugins";
+export * from "./plugins/breaker/polaris";
+export { StatelessLoadBalancerOptions } from "./plugins/lb/base";
+export * from "./plugins/lb/wrr";
+export * from "./plugins/lb/wr";
+export * from "./plugins/lb/edf";
+export * from "./plugins/lb/swrr";
+export * from "./plugins/lb/hashring";
+export * from "./plugins/lb/sticky";
+export * from "./plugins/naming/polaris-server";
+export * from "./plugins/naming/local-server";
+export * from "./plugins/registry/memory";
+export * from "./plugins/router/polaris/rule";
+export * from "./plugins/router/polaris/nearby";
+export * from "./plugins/router/trpc/env";
+export * from "./plugins/router/trpc/set";
+export * from "./plugins/router/trpc/canary";
+export * from "./plugins/weight/polaris";
+export * from "./plugins/shaping/unirate";
+export * from "./plugins/shaping/warmup";
+export * from "./instance";
+export * from "./rules";
+export * from "./metadata";
+export * from "./service";
+export * from "./location";
+export { CacheStat, RevisionLog } from "./registry";
+export { LogVerbosity, TraceCategory, LoggingFunc } from "./logging";
+export type { Logger } from "./logging";
+export { ApiStatKey, ApiStatValue } from "./skeleton";
+export * from "./errors";
+export { InternalConsumer, Consumer, ConsumerOptions, OptionalConsumerPluginList, CallArgsType, SelectResponse, StatusChangelog, StatusChangeRequest, ComputedStat, ComputeStatKey, StatProp } from "./consumer";
+export { Provider, ProviderOptions, OptionalProviderPluginList } from "./provider";
+export { Limiter, LimiterOptions, OptionalLimiterPluginList } from "./limiter";

package/libs/@tencent/polaris/dist/polaris.js

@@ -0,0 +1,59 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Limiter = exports.Provider = exports.SelectResponse = exports.Consumer = exports.InternalConsumer = exports.LogVerbosity = exports.plugins = void 0;
+// #region 插件
+exports.plugins = require("./plugins");
+__exportStar(require("./plugins/breaker/polaris"), exports);
+__exportStar(require("./plugins/lb/wrr"), exports);
+__exportStar(require("./plugins/lb/wr"), exports);
+__exportStar(require("./plugins/lb/edf"), exports);
+__exportStar(require("./plugins/lb/swrr"), exports);
+__exportStar(require("./plugins/lb/hashring"), exports);
+__exportStar(require("./plugins/lb/sticky"), exports);
+__exportStar(require("./plugins/naming/polaris-server"), exports);
+__exportStar(require("./plugins/naming/local-server"), exports);
+__exportStar(require("./plugins/registry/memory"), exports);
+__exportStar(require("./plugins/router/polaris/rule"), exports);
+__exportStar(require("./plugins/router/polaris/nearby"), exports);
+__exportStar(require("./plugins/router/trpc/env"), exports);
+__exportStar(require("./plugins/router/trpc/set"), exports);
+__exportStar(require("./plugins/router/trpc/canary"), exports);
+__exportStar(require("./plugins/weight/polaris"), exports);
+__exportStar(require("./plugins/shaping/unirate"), exports);
+__exportStar(require("./plugins/shaping/warmup"), exports);
+// #endregion
+// #region 基础结构
+__exportStar(require("./instance"), exports);
+__exportStar(require("./rules"), exports);
+__exportStar(require("./metadata"), exports);
+__exportStar(require("./service"), exports);
+__exportStar(require("./location"), exports);
+var logging_1 = require("./logging");
+Object.defineProperty(exports, "LogVerbosity", { enumerable: true, get: function () { return logging_1.LogVerbosity; } });
+__exportStar(require("./errors"), exports);
+// #endregion
+// #region API
+var consumer_1 = require("./consumer");
+Object.defineProperty(exports, "InternalConsumer", { enumerable: true, get: function () { return consumer_1.InternalConsumer; } });
+Object.defineProperty(exports, "Consumer", { enumerable: true, get: function () { return consumer_1.Consumer; } });
+Object.defineProperty(exports, "SelectResponse", { enumerable: true, get: function () { return consumer_1.SelectResponse; } });
+var provider_1 = require("./provider");
+Object.defineProperty(exports, "Provider", { enumerable: true, get: function () { return provider_1.Provider; } });
+var limiter_1 = require("./limiter");
+Object.defineProperty(exports, "Limiter", { enumerable: true, get: function () { return limiter_1.Limiter; } });
+// #endregion
+//# sourceMappingURL=polaris.js.map

package/libs/@tencent/polaris/dist/polaris.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polaris.js","sourceRoot":"","sources":["../src/polaris.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,aAAa;AACb,uCAAqC;AACrC,4DAA0C;AAE1C,mDAAiC;AACjC,kDAAgC;AAChC,mDAAiC;AACjC,oDAAkC;AAClC,wDAAsC;AACtC,sDAAoC;AACpC,kEAAgD;AAChD,gEAA8C;AAC9C,4DAA0C;AAC1C,gEAA8C;AAC9C,kEAAgD;AAChD,4DAA0C;AAC1C,4DAA0C;AAC1C,+DAA6C;AAC7C,2DAAyC;AACzC,4DAA0C;AAC1C,2DAAyC;AACzC,aAAa;AAEb,eAAe;AACf,6CAA2B;AAC3B,0CAAwB;AACxB,6CAA2B;AAC3B,4CAA0B;AAC1B,6CAA2B;AAK3B,qCAAqE;AAA5D,uGAAA,YAAY,OAAA;AAGrB,2CAAyB;AACzB,aAAa;AAEb,cAAc;AACd,uCAAiN;AAAxM,4GAAA,gBAAgB,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAA6D,0GAAA,cAAc,OAAA;AAC9G,uCAAmF;AAA1E,oGAAA,QAAQ,OAAA;AACjB,qCAA+E;AAAtE,kGAAA,OAAO,OAAA;AAChB,aAAa"}

package/libs/@tencent/polaris/dist/provider/index.d.ts

@@ -0,0 +1,102 @@
+import { GlobalOptions } from "../global";
+import { LoggerOptions } from "../logging";
+import { PluginList, PluginType, RegisterOptions, RegistrationInstance } from "../plugins";
+import { SkeletonClass } from "../skeleton";
+import { RequireKeys } from "../utils";
+declare const kProvider: unique symbol;
+declare const kServiceToken: unique symbol;
+declare class RegisterResponse {
+    readonly id: string;
+    private readonly [kProvider];
+    private readonly [kServiceToken];
+    constructor(id: string, token: string, provider: Provider);
+    /**
+     * 服务注销
+     * @returns 是否注销成功
+     */
+    unregister(): Promise<boolean>;
+    /**
+     * 服务心跳上报
+     * @returns 是否上报成功
+     */
+    heartbeat(): Promise<boolean>;
+}
+export declare type ProviderOptions = GlobalOptions & LoggerOptions;
+declare type ProviderPluginList = Pick<PluginList, PluginType.NamingService | PluginType.TraceLogging | PluginType.StatReporter>;
+export declare type OptionalProviderPluginList = RequireKeys<Partial<ProviderPluginList>, PluginType.NamingService>;
+declare const kCurrentInstances: unique symbol;
+declare const KMaxInstances: unique symbol;
+export declare class Provider extends SkeletonClass<ProviderPluginList> {
+    /**
+     * note:
+     * 由于类包含专用标识符时，`super` 调用必须是构造函数中的第一个语句。
+     * 所以这里采用 `Symbol` 来实现 __私有静态属性__
+     */
+    private static [kCurrentInstances];
+    private static [KMaxInstances];
+    /**
+     * 当前可实例化的最大次数
+     */
+    static get maxInstances(): number;
+    /**
+     * 设置可实例化的最大次数
+     * @param n 最大次数
+     */
+    static setMaxInstances(n: number): void;
+    /**
+     * Create Provider
+     * @param plugins 插件
+     * @param options 配置参数（可选）
+     */
+    constructor(plugins: OptionalProviderPluginList, options?: Partial<ProviderOptions>);
+    /**
+     * 销毁（释放）所占资源
+     * @param sync 是否同步释放（可选）
+     */
+    dispose(sync?: boolean): void;
+    /**
+     * 服务注册
+     * @param namespace 命名空间
+     * @param service 服务名
+     * @param token 服务 Token 用来鉴权
+     * @param instance 待注册的实例
+     * @param options 注册选项
+     * @returns 可操作的实例对象（包含注册的实例 `id`）
+     */
+    register(namespace: string, service: string, token: string, instance: RegistrationInstance, options?: RegisterOptions): Promise<RegisterResponse>;
+    /**
+     * 服务注销
+     * @param id 实例 ID
+     * @param token 服务 Token 用来鉴权
+     * @returns 是否注销成功
+     */
+    unregister(id: string, token: string): Promise<boolean>;
+    /**
+     * 服务注销
+     * @param namespace 命名空间
+     * @param service 服务名
+     * @param host 节点 IP 或者域名
+     * @param port 节点端口号
+     * @param token 服务 Token 用来鉴权
+     * @returns 是否注销成功
+     */
+    unregister(namespace: string, service: string, host: string, port: number, token: string): Promise<boolean>;
+    /**
+     * 服务心跳上报
+     * @param id 实例唯一 ID
+     * @param token 服务 Token 用来鉴权
+     * @returns 是否发送成功
+     */
+    heartbeat(id: string, token: string): Promise<boolean>;
+    /**
+     * 服务心跳上报
+     * @param namespace 命名空间
+     * @param service 服务名
+     * @param host 节点 IP 或者域名
+     * @param port 节点端口号
+     * @param token 服务 Token 用来鉴权
+     * @returns 是否发送成功
+     */
+    heartbeat(namespace: string, service: string, host: string, port: number, token: string): Promise<boolean>;
+}
+export {};

package/libs/@tencent/polaris/dist/provider/index.js

@@ -0,0 +1,168 @@
+"use strict";
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Provider = void 0;
+const process_1 = require("process");
+const errors_1 = require("../errors");
+const plugins_1 = require("../plugins");
+const console_1 = require("../plugins/logging/console");
+const skeleton_1 = require("../skeleton");
+const utils_1 = require("../utils");
+const kProvider = Symbol("kProvider");
+const kServiceToken = Symbol("kServiceToken");
+class RegisterResponse {
+    constructor(id, token, provider) {
+        this.id = id;
+        this[kServiceToken] = token;
+        this[kProvider] = provider;
+    }
+    /**
+     * 服务注销
+     * @returns 是否注销成功
+     */
+    async unregister() {
+        return this[kProvider].unregister(this.id, this[kServiceToken]);
+    }
+    /**
+     * 服务心跳上报
+     * @returns 是否上报成功
+     */
+    async heartbeat() {
+        return this[kProvider].heartbeat(this.id, this[kServiceToken]);
+    }
+}
+const kCurrentInstances = Symbol("kCurrentInstances");
+const KMaxInstances = Symbol("KMaxInstances");
+class Provider extends skeleton_1.SkeletonClass {
+    /**
+     * Create Provider
+     * @param plugins 插件
+     * @param options 配置参数（可选）
+     */
+    constructor(plugins, options = {}) {
+        Provider[kCurrentInstances] += 1;
+        if (Provider[kCurrentInstances] >= Provider[KMaxInstances]) {
+            (0, skeleton_1.emitMaxInstancesExceededWarning)("Consumer", Provider[KMaxInstances]);
+        }
+        // #region plugin
+        const pluginList = {
+            [plugins_1.PluginType.NamingService]: plugins[plugins_1.PluginType.NamingService],
+            [plugins_1.PluginType.TraceLogging]: plugins[plugins_1.PluginType.TraceLogging] || [new console_1.ConsoleTraceLogging()],
+            [plugins_1.PluginType.StatReporter]: plugins[plugins_1.PluginType.StatReporter] || []
+        };
+        const naming = pluginList[plugins_1.PluginType.NamingService];
+        /**
+         * 在某些特殊场景下，为了避免死循环与内存开销，
+         * `NamingService` 与 `StatReporter` 插件实现在一个对象内
+         */
+        if ((0, skeleton_1.isStatReporterPlugin)(naming)) {
+            pluginList[plugins_1.PluginType.StatReporter].push(naming);
+        }
+        super(pluginList, options);
+        // #endregion
+    }
+    /**
+     * 当前可实例化的最大次数
+     */
+    static get maxInstances() {
+        return Provider[KMaxInstances];
+    }
+    /**
+     * 设置可实例化的最大次数
+     * @param n 最大次数
+     */
+    static setMaxInstances(n) {
+        if (typeof n !== "number" || n < 0 || Number.isNaN(n)) {
+            throw new errors_1.ArgumentError("|n| must be a non-negative number");
+        }
+        Provider[KMaxInstances] = n;
+    }
+    /**
+     * 销毁（释放）所占资源
+     * @param sync 是否同步释放（可选）
+     */
+    dispose(sync = false) {
+        if (this[skeleton_1.kDisposed]) {
+            return;
+        }
+        super.dispose(sync);
+        Provider[kCurrentInstances] -= 1;
+        if (Provider[kCurrentInstances] < 0) {
+            (0, utils_1.UNREACHABLE)();
+        }
+    }
+    /**
+     * 服务注册
+     * @param namespace 命名空间
+     * @param service 服务名
+     * @param token 服务 Token 用来鉴权
+     * @param instance 待注册的实例
+     * @param options 注册选项
+     * @returns 可操作的实例对象（包含注册的实例 `id`）
+     */
+    async register(namespace, service, token, instance, options) {
+        const startTime = (0, process_1.uptime)();
+        let id = "";
+        let err;
+        try {
+            this[skeleton_1.kMaybeAlreadyDisposed]();
+            id = await this.plugins[plugins_1.PluginType.NamingService].register(namespace, service, token, instance, options);
+        }
+        catch (e) {
+            err = e;
+        }
+        this[skeleton_1.kAPICollector]("Provider.register", ((0, process_1.uptime)() - startTime) * utils_1.kSeconds, err);
+        if (err) {
+            throw err;
+        }
+        return new RegisterResponse(id, token, this);
+    }
+    async unregister(...args) {
+        const startTime = (0, process_1.uptime)();
+        let err;
+        try {
+            this[skeleton_1.kMaybeAlreadyDisposed]();
+            return await this.plugins[plugins_1.PluginType.NamingService].unregister(...args);
+        }
+        catch (e) {
+            err = e;
+        }
+        finally {
+            this[skeleton_1.kAPICollector]("Provider.unregister", ((0, process_1.uptime)() - startTime) * utils_1.kSeconds, err);
+        }
+        throw err;
+    }
+    async heartbeat(...args) {
+        const startTime = (0, process_1.uptime)();
+        let err;
+        try {
+            this[skeleton_1.kMaybeAlreadyDisposed]();
+            return await this.plugins[plugins_1.PluginType.NamingService].heartbeat(...args);
+        }
+        catch (e) {
+            err = e;
+        }
+        finally {
+            this[skeleton_1.kAPICollector]("Provider.heartbeat", ((0, process_1.uptime)() - startTime) * utils_1.kSeconds, err);
+        }
+        throw err;
+    }
+}
+exports.Provider = Provider;
+_a = Provider, _b = kCurrentInstances;
+/**
+ * note:
+ * 由于类包含专用标识符时，`super` 调用必须是构造函数中的第一个语句。
+ * 所以这里采用 `Symbol` 来实现 __私有静态属性__
+ */
+Provider[_b] = 0;
+(() => {
+    let maxInstances = 3;
+    const { POLARIS_PROVIDER_INSTANCE_LIMIT } = process.env;
+    if (POLARIS_PROVIDER_INSTANCE_LIMIT !== undefined) {
+        maxInstances = parseInt(POLARIS_PROVIDER_INSTANCE_LIMIT, 10);
+        maxInstances = (maxInstances === 0 /** Unlimited */ ? Infinity : maxInstances);
+    }
+    _a.setMaxInstances(maxInstances);
+})();
+//# sourceMappingURL=index.js.map

package/libs/@tencent/polaris/dist/provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider/index.ts"],"names":[],"mappings":";;;;AAAA,qCAAiC;AAEjC,sCAA0C;AAG1C,wCAA2F;AAC3F,wDAAiE;AACjE,0CAAoJ;AACpJ,oCAA8D;AAE9D,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AACtC,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAC9C,MAAM,gBAAgB;IAIpB,YAA4B,EAAU,EAAE,KAAa,EAAE,QAAkB;QAA7C,OAAE,GAAF,EAAE,CAAQ;QACpC,IAAI,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACjE,CAAC;CACF;AAQD,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AACtD,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAE9C,MAAa,QAAS,SAAQ,wBAAiC;IA2B7D;;;;OAIG;IACH,YAAY,OAAmC,EAAE,UAAoC,EAAE;QACrF,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,QAAQ,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE;YAC1D,IAAA,0CAA+B,EAAC,UAAU,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;SACtE;QAED,iBAAiB;QACjB,MAAM,UAAU,GAAG;YACjB,CAAC,oBAAU,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,oBAAU,CAAC,aAAa,CAAC;YAC7D,CAAC,oBAAU,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,6BAAmB,EAAE,CAAC;YAC1F,CAAC,oBAAU,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAU,CAAC,YAAY,CAAC,IAAI,EAAE;SAClE,CAAC;QAEF,MAAM,MAAM,GAAG,UAAU,CAAC,oBAAU,CAAC,aAAa,CAAC,CAAC;QAEpD;;;WAGG;QACH,IAAI,IAAA,+BAAoB,EAAC,MAAM,CAAC,EAAE;YAChC,UAAU,CAAC,oBAAU,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAClD;QAED,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC3B,aAAa;IACf,CAAC;IAhDD;;OAEG;IACH,MAAM,KAAK,YAAY;QACrB,OAAO,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,CAAS;QAC9B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACrD,MAAM,IAAI,sBAAa,CAAC,mCAAmC,CAAC,CAAC;SAC9D;QACD,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAkCD;;;OAGG;IACM,OAAO,CAAC,IAAI,GAAG,KAAK;QAC3B,IAAI,IAAI,CAAC,oBAAS,CAAC,EAAE;YACnB,OAAO;SACR;QAED,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEpB,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE;YACnC,IAAA,mBAAW,GAAE,CAAC;SACf;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CACZ,SAAiB,EACjB,OAAe,EACf,KAAa,EACb,QAA8B,EAC9B,OAAyB;QAEzB,MAAM,SAAS,GAAG,IAAA,gBAAM,GAAE,CAAC;QAC3B,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,IAAI,GAAsB,CAAC;QAC3B,IAAI;YACF,IAAI,CAAC,gCAAqB,CAAC,EAAE,CAAC;YAC9B,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAU,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;SAC1G;QAAC,OAAO,CAAC,EAAE;YACV,GAAG,GAAG,CAAU,CAAC;SAClB;QACD,IAAI,CAAC,wBAAa,CAAC,CAAC,mBAAmB,EAAE,CAAC,IAAA,gBAAM,GAAE,GAAG,SAAS,CAAC,GAAG,gBAAQ,EAAE,GAAG,CAAC,CAAC;QAEjF,IAAI,GAAG,EAAE;YACP,MAAM,GAAG,CAAC;SACX;QAED,OAAO,IAAI,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAqBD,KAAK,CAAC,UAAU,CAAC,GAAG,IAAW;QAC7B,MAAM,SAAS,GAAG,IAAA,gBAAM,GAAE,CAAC;QAE3B,IAAI,GAAsB,CAAC;QAC3B,IAAI;YACF,IAAI,CAAC,gCAAqB,CAAC,EAAE,CAAC;YAC9B,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAU,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,GAAG,IAAwB,CAAC,CAAC;SAC7F;QAAC,OAAO,CAAC,EAAE;YACV,GAAG,GAAG,CAAU,CAAC;SAClB;gBAAS;YACR,IAAI,CAAC,wBAAa,CAAC,CAAC,qBAAqB,EAAE,CAAC,IAAA,gBAAM,GAAE,GAAG,SAAS,CAAC,GAAG,gBAAQ,EAAE,GAAG,CAAC,CAAC;SACpF;QAED,MAAM,GAAG,CAAC;IACZ,CAAC;IAqBD,KAAK,CAAC,SAAS,CAAC,GAAG,IAAW;QAC5B,MAAM,SAAS,GAAG,IAAA,gBAAM,GAAE,CAAC;QAE3B,IAAI,GAAsB,CAAC;QAC3B,IAAI;YACF,IAAI,CAAC,gCAAqB,CAAC,EAAE,CAAC;YAC9B,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAU,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAwB,CAAC,CAAC;SAC5F;QAAC,OAAO,CAAC,EAAE;YACV,GAAG,GAAG,CAAU,CAAC;SAClB;gBAAS;YACR,IAAI,CAAC,wBAAa,CAAC,CAAC,oBAAoB,EAAE,CAAC,IAAA,gBAAM,GAAE,GAAG,SAAS,CAAC,GAAG,gBAAQ,EAAE,GAAG,CAAC,CAAC;SACnF;QAED,MAAM,GAAG,CAAC;IACZ,CAAC;;AAlLH,4BA6LC;oBAvLiB,iBAAiB;AALjC;;;;GAIG;AACY,YAAmB,GAAG,CAAE,CAAA;AA8KvC;IACE,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,EAAE,+BAA+B,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IACxD,IAAI,+BAA+B,KAAK,SAAS,EAAE;QACjD,YAAY,GAAG,QAAQ,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;QAC7D,YAAY,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;KAChF;IACD,EAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;AACrC,CAAC,GAAA,CAAA"}

package/libs/@tencent/polaris/dist/registry.d.ts

@@ -0,0 +1,174 @@
+/// <reference types="node" />
+import { EventEmitter } from "events";
+import { Instance } from "./instance";
+import { Location } from "./location";
+import { Logger } from "./logging";
+import { DataWithRevision, LocalRegistryPlugin, NamingServicePlugin, RatelimitServicePlugin, RegistryCategory, ServiceDataSet, ServiceRules, StatReporterPlugin } from "./plugins";
+import { RatelimitRule } from "./rules";
+import { PartialSubset } from "./utils";
+/**
+ * 事件类型
+ */
+export declare const enum RegistryEventType {
+    /** 同步实例状态事件 */
+    SyncInstanceStatus = "SyncInstanceStatus"
+}
+declare const kDefaultOptions: {
+    /**
+     * 过期时间
+     * 超过此时间，会 __异步__ 请求新数据
+     * _也就是说，返回值可能为旧数据_
+     */
+    expireTime: {
+        /** 实例过期时间 */
+        Instance: number;
+        /** 规则过期时间 */
+        Rule: number;
+        /** 限流规则过期时间 */
+        Ratelimit: number;
+    };
+    /**
+     * 刷新时间
+     * 达到此时间，会自动更新数据（如数据已过期）
+     * _数据刷新，并不影响资源回收策略_
+     */
+    refreshTime: {
+        /** 实例刷新时间 */
+        Instance: number;
+        /** 规则刷新时间 */
+        Rule: number;
+        /** 限流规则刷新时间 */
+        Ratelimit: number;
+    };
+    /**
+     * 脏数据时间
+     * 超过此时间，会 __同步__ 请求新数据
+     * _也就是说，返回值一定为新数据_
+     */
+    dirtyTime: {
+        /** 实例脏数据时间 */
+        Instance: number;
+        /** 规则脏数据时间 */
+        Rule: number;
+        /** 限流规则脏数据时间 */
+        Ratelimit: number;
+    };
+    /**
+     * 资源回收时间
+     * 回收条件为：_至少_经历指定的间隔都没被访问
+     * 小于或等于 0 则为不启用此特性
+     */
+    recycleTime: number;
+    /**
+     * 服务状态上报间隔
+     */
+    reportInterval: number;
+    /**
+     * 服务状态上报阈值
+     */
+    reportThreshold: number;
+    /**
+     * 请求池最大容量
+     * 超过此大小，且无请求时，将会进行回收
+     */
+    maxRequestsCapacity: number; /** v8 对于 FastProperties Slot 的上限为 18 */
+};
+declare type LocalRegistryAssembleOptions = typeof kDefaultOptions & {
+    /**
+     * 基础位置信息
+     * 如果 `Naming` 返回的位置信息为空，则使用此配置
+     */
+    baseLocation?: Location;
+};
+export declare type LocalRegistryOptions = PartialSubset<LocalRegistryAssembleOptions, "expireTime" | "refreshTime" | "dirtyTime">;
+/**
+ * 版本号变更记录
+ */
+export interface RevisionLog {
+    /**
+     * 变更时间 (ms)
+     */
+    time: number;
+    /**
+     * 变更后版本号
+     */
+    revision: string;
+}
+/** 服务变更历史 */
+export declare type ServiceChangelog = Record<RegistryCategory, RevisionLog[]>;
+/**
+ * 服务状态
+ */
+export declare type CacheStat = Record<RegistryCategory, {
+    /**
+     * 变更历史
+     */
+    history: RevisionLog[];
+    /**
+     * 当前是否已删除（包括过期淘汰与Server删除）
+     */
+    eliminated: boolean;
+}>;
+export declare class LocalRegistry extends EventEmitter {
+    private readonly logger;
+    private readonly naming;
+    private readonly registry;
+    private readonly reporters;
+    private readonly ratelimit?;
+    private entriesMeta;
+    private servicesMeta;
+    private activeRequestsPool;
+    private activeRequestsCapacity;
+    private activeRequestsCount;
+    private historyRecorder;
+    private historyRecorderCount;
+    private historyReporter;
+    private readonly needReport;
+    private readonly options;
+    private disposed;
+    constructor(logger: Logger, naming: NamingServicePlugin, registry: LocalRegistryPlugin, reporters: StatReporterPlugin[], ratelimit?: RatelimitServicePlugin | undefined, options?: Partial<LocalRegistryOptions>);
+    get location(): Location | undefined;
+    fetch(type: RegistryCategory.Instance, namespace: string, service: string): Promise<Instance[]>;
+    fetch(type: RegistryCategory.Rule, namespace: string, service: string): Promise<ServiceRules>;
+    fetch(type: RegistryCategory.Ratelimit, namespace: string, service: string): Promise<RatelimitRule[]>;
+    fetch(type: RegistryCategory, namespace: string, service: string): Promise<ServiceRules | Instance[] | RatelimitRule[]>;
+    local(type: RegistryCategory.Instance, namespace: string, service: string): DataWithRevision<Instance[]> | null;
+    local(type: RegistryCategory.Rule, namespace: string, service: string): DataWithRevision<ServiceRules> | null;
+    local(type: RegistryCategory.Ratelimit, namespace: string, service: string): DataWithRevision<RatelimitRule[]> | null;
+    local(type: RegistryCategory, namespace: string, service: string): DataWithRevision<Instance[] | ServiceRules | RatelimitRule[]> | null;
+    local(type: RegistryCategory.Instance): ServiceDataSet<DataWithRevision<Instance[]>>;
+    local(type: RegistryCategory.Rule): ServiceDataSet<DataWithRevision<ServiceRules>>;
+    local(type: RegistryCategory.Ratelimit): ServiceDataSet<DataWithRevision<RatelimitRule[]>>;
+    local(type: RegistryCategory): ServiceDataSet<DataWithRevision<Instance[]>> | ServiceDataSet<DataWithRevision<ServiceRules>> | ServiceDataSet<DataWithRevision<RatelimitRule[]>>;
+    dispose(): void;
+    get isDisposed(): boolean;
+    /** for external use only */
+    update(type: RegistryCategory, namespace: string, service: string): Promise<boolean>;
+    /** for internal use only */
+    private performUpdate;
+    private updateInstance;
+    private updateRule;
+    private updateRatelimit;
+    /**
+     * @note
+     *  将相同的查询请求做合并（以最早发出为准）
+     *  以减少本地名字服务无缓存情况下，对于 `Naming` 的调用压力。
+     */
+    private request;
+    private pull;
+    private report;
+    private changelog;
+    private cancelHistoryReporter;
+    private accessService;
+    private dropServiceMeta;
+    private createServiceMeta;
+    private dropService;
+    private attachRefresherToEntryMeta;
+    private attachUpdaterToEntryMeta;
+    private releaseEntryMeta;
+    private dropEntryMeta;
+    private createEntries;
+    private createEntryMeta;
+    private getEntryMeta;
+}
+export {};