@tencent-rtc/mcp 1.0.0

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

@@ -0,0 +1,145 @@
+"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.Consumer = exports.PolarisServerClient = exports.PolarisGRPCClient = exports.PolarisHTTPClient = exports.getEmbeddedDiscoverHosts = void 0;
+const polaris_1 = require("./polaris");
+__exportStar(require("./polaris"), exports);
+// #region Embedded Host
+var DiscoverBackend;
+(function (DiscoverBackend) {
+    /** 正式环境 */
+    DiscoverBackend[DiscoverBackend["Formal"] = 0] = "Formal";
+    /** 测试环境 */
+    DiscoverBackend[DiscoverBackend["Debug"] = 1] = "Debug";
+})(DiscoverBackend || (DiscoverBackend = {}));
+const kDiscoverHosts = {
+    [DiscoverBackend.Debug]: [
+        "9.205.2.29",
+        "9.205.2.123"
+    ],
+    [DiscoverBackend.Formal]: [
+        "9.141.66.244",
+        "9.146.202.27",
+        "9.146.200.81",
+        "9.146.202.35",
+        "9.146.205.191",
+        "9.146.200.61",
+        "9.141.66.219",
+        "9.141.65.110",
+        "9.141.65.29",
+        "9.141.121.7"
+    ]
+};
+const getEmbeddedDiscoverHosts = (port) => {
+    const hosts = kDiscoverHosts[process.env.POLARIS_NAMING_DISCOVER_DEBUG ? DiscoverBackend.Debug : DiscoverBackend.Formal];
+    return port ? hosts.map(host => `${host}:${port}`) : hosts;
+};
+exports.getEmbeddedDiscoverHosts = getEmbeddedDiscoverHosts;
+// #endregion
+// #region AOP
+// #region plugins.naming.PolarisServerClient
+class PolarisHTTPClient extends polaris_1.PolarisHTTPClient {
+    constructor(remotes = (0, exports.getEmbeddedDiscoverHosts)(polaris_1.PolarisHTTPClient.port), options) {
+        super(remotes, options);
+    }
+    // #region Mock monitor
+    /**
+     * HTTP 后端默认没有部署上报模块，故移除相关实现
+     * @returns always `false`
+     */
+    async serviceStatistics() {
+        return false;
+    }
+    /**
+     * HTTP 后端默认没有部署上报模块，故移除相关实现
+     * @returns always `false`
+     */
+    async registryCache() {
+        return false;
+    }
+    /**
+     * HTTP 后端默认没有部署上报模块，故移除相关实现
+     * @returns always `false`
+     */
+    async apiStatistics() {
+        return false;
+    }
+    /**
+     * HTTP 后端默认没有部署上报模块，故移除相关实现
+     * @returns always `false`
+     */
+    async systemConfig() {
+        return false;
+    }
+    /**
+     * HTTP 后端默认没有部署上报模块，故移除相关实现
+     * @returns always `false`
+     */
+    async statusChangelog() {
+        return false;
+    }
+}
+exports.PolarisHTTPClient = PolarisHTTPClient;
+class PolarisGRPCClient extends polaris_1.PolarisGRPCClient {
+    constructor(remotes = (0, exports.getEmbeddedDiscoverHosts)(polaris_1.PolarisGRPCClient.port), options) {
+        super(remotes, options);
+    }
+}
+exports.PolarisGRPCClient = PolarisGRPCClient;
+exports.PolarisServerClient = [PolarisGRPCClient].find(client => client.isSupported()) || PolarisHTTPClient;
+// #endregion
+// #region API
+const { NamingService: NamingServiceType } = polaris_1.plugins.PluginType;
+class Consumer extends polaris_1.Consumer {
+    /**
+     * Create Consumer
+     * @param plugins 插件（可选）
+     * @param options 配置参数（可选）
+     */
+    constructor(plugins = {}, options = {}) {
+        super(plugins[NamingServiceType]
+            ? plugins : Object.assign(Object.assign({}, plugins), { [NamingServiceType]: new exports.PolarisServerClient() }), options);
+    }
+}
+exports.Consumer = Consumer;
+class Provider extends polaris_1.Provider {
+    /**
+     * Create Provider
+     * @param plugins 插件（可选）
+     * @param options 配置参数（可选）
+     */
+    constructor(plugins = {}, options = {}) {
+        super(plugins[NamingServiceType]
+            ? plugins : Object.assign(Object.assign({}, plugins), { [NamingServiceType]: new exports.PolarisServerClient() }), options);
+    }
+}
+exports.Provider = Provider;
+class Limiter extends polaris_1.Limiter {
+    /**
+     * Create Limiter
+     * @param plugins 插件（可选）
+     * @param options 配置参数（可选）
+     */
+    constructor(plugins = {}, options = {}) {
+        super(plugins[NamingServiceType]
+            ? plugins : Object.assign(Object.assign({}, plugins), { [NamingServiceType]: new exports.PolarisServerClient() }), options);
+    }
+}
+exports.Limiter = Limiter;
+// #endregion
+// #endregion
+// #endregion
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,109 @@
+import { Location } from "./location";
+import { Metadata } from "./metadata";
+/**
+ * 实例状态
+ *
+ * ```
+ *     STD:
+ *      +---------------------------------------(`CircuitBreaker`)-----------------------------------------------+
+ *      |                                                                                                        |
+ *      v                                                                                                        +
+ *    Fused +---(`OutlierDetector`)---> HalfOpen +---(`LoadBalancer`)---> HalfClose +---(`CircuitBreaker`)---> Normal
+ *      ^                                                                     +
+ *      |                                                                     |
+ *      +------------------------(`CircuitBreaker`)---------------------------+
+ * ```
+ */
+export declare const enum InstanceStatus {
+    /**
+     * 正常
+     */
+    Normal = 0,
+    /**
+     * 半打开
+     *
+     * 各周期只选出极少次，负责探活
+     */
+    HalfOpen = 1,
+    /**
+     * 半关闭
+     *
+     * 不在任何模块中被选出，但计算调用结果
+     */
+    HalfClose = 2,
+    /**
+     * 熔断
+     *
+     * 不在任何模块中被选出
+     */
+    Fused = 3
+}
+/**
+ * 实例
+ */
+export interface Instance {
+    /**
+     * 唯一 ID
+     */
+    readonly id: string;
+    /**
+     * vpc_id
+     */
+    vpcId: string;
+    /**
+     * IP 或 域名
+     */
+    host: string;
+    /**
+     * 端口号
+     */
+    port: number;
+    /**
+     * 协议信息
+     */
+    protocol: string;
+    /**
+     * 静态权重值, 0-1000
+     */
+    staticWeight: number;
+    /**
+     * 动态权重值
+     */
+    dynamicWeight: number;
+    /**
+     * 当前状态
+     */
+    status: InstanceStatus;
+    /**
+     * 元数据信息
+     */
+    metadata: Metadata;
+    /**
+     * 优先级
+     */
+    priority: number;
+    /**
+     * 版本号
+     */
+    version: string;
+    /**
+     * 逻辑区域
+     */
+    logicSet: string;
+    /**
+     * 地理位置
+     */
+    location: Location;
+}
+/**
+ * 实例静态拷贝
+ * @param from 源实例
+ * @param to 目标实例
+ */
+export declare const instanceCopy: (from: Instance, to: Instance) => void;
+/**
+ * 判断实例是否可被选取
+ * @param instance 实例
+ * @returns 是否可选取
+ */
+export declare const isChoosableInstance: (instance: Instance) => boolean;

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isChoosableInstance = exports.instanceCopy = void 0;
+/**
+ * 所需拷贝的静态属性值
+ * note：这里不拷贝 `status` 与 `dynamicWeight`，以 `id` 进行关联
+ */
+const kStaticProps = [
+    "vpcId",
+    "host",
+    "port",
+    "metadata",
+    "protocol",
+    "staticWeight",
+    "priority",
+    "version",
+    "logicSet",
+    "location"
+];
+/**
+ * 实例静态拷贝
+ * @param from 源实例
+ * @param to 目标实例
+ */
+const instanceCopy = (from, to) => {
+    kStaticProps.forEach((key) => {
+        to[key] = from[key];
+    });
+};
+exports.instanceCopy = instanceCopy;
+/**
+ * 判断实例是否可被选取
+ * @param instance 实例
+ * @returns 是否可选取
+ */
+const isChoosableInstance = (instance) => (instance.status === 1 /* HalfOpen */ || instance.status === 0 /* Normal */);
+exports.isChoosableInstance = isChoosableInstance;
+//# sourceMappingURL=instance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":";;;AAmHA;;;GAGG;AACH,MAAM,YAAY,GAAoC;IACpD,OAAO;IACP,MAAM;IACN,MAAM;IACN,UAAU;IACV,UAAU;IACV,cAAc;IACd,UAAU;IACV,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAC;AACF;;;;GAIG;AACI,MAAM,YAAY,GAAG,CAAC,IAAc,EAAE,EAAY,EAAQ,EAAE;IACjE,YAAY,CAAC,OAAO,CAAC,CAA2B,GAAM,EAAE,EAAE;QACxD,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAJW,QAAA,YAAY,gBAIvB;AAEF;;;;GAIG;AACI,MAAM,mBAAmB,GAAG,CAAC,QAAkB,EAAW,EAAE,CAAC,CAClE,QAAQ,CAAC,MAAM,qBAA4B,IAAI,QAAQ,CAAC,MAAM,mBAA0B,CACzF,CAAC;AAFW,QAAA,mBAAmB,uBAE9B"}

package/@tencent/polaris/dist/limiter/bucket.d.ts

@@ -0,0 +1,51 @@
+export interface InternalBucketOptions {
+    /**
+     * 令牌桶空闲回收，判定周期数
+     */
+    idlePeriod: number;
+}
+/**
+ * 基础令牌桶
+ * 桶内剩余可用令牌，不会增加
+ */
+export declare class BasicBucket {
+    protected total: number;
+    protected partition: number;
+    private overflow;
+    protected remains: number;
+    protected capacity: number;
+    constructor(total: number, partition: number, overflow?: boolean);
+    get partitionTokens(): number;
+    get remainingTokens(): number;
+    setPartition(partition: number): void;
+    consume(tokens: number, preroll: boolean): boolean;
+    drain(): number;
+    private recalculate;
+}
+/**
+ * 内部令牌桶
+ * 桶内剩余可用令牌，由内部新增
+ */
+export declare class InternalBucket extends BasicBucket {
+    private duration;
+    private options;
+    private isAccessed;
+    private idlePeriods;
+    private period;
+    private timer;
+    private sleepTime?;
+    constructor(total: number, partition: number, overflow: boolean | undefined, duration: number, options: InternalBucketOptions);
+    get currentPeriod(): number;
+    consume(tokens: number, preroll: boolean): boolean;
+    private onWakUp;
+    private wake;
+    private sleep;
+    private onTimeout;
+}
+/**
+ * 外部令牌桶
+ * 桶内剩余可用令牌，由外部调整
+ */
+export declare class ExternalBucket extends BasicBucket {
+    update(value: number): void;
+}

package/@tencent/polaris/dist/limiter/bucket.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalBucket = exports.InternalBucket = exports.BasicBucket = void 0;
+const process_1 = require("process");
+const utils_1 = require("../utils");
+/**
+ * 基础令牌桶
+ * 桶内剩余可用令牌，不会增加
+ */
+class BasicBucket {
+    constructor(total, partition, overflow = false) {
+        this.total = total;
+        this.partition = partition;
+        this.overflow = overflow;
+        this.capacity = ~~(this.total / this.partition);
+        this.remains = this.capacity;
+    }
+    get partitionTokens() {
+        return this.capacity;
+    }
+    get remainingTokens() {
+        return this.remains;
+    }
+    setPartition(partition) {
+        this.recalculate(partition);
+        this.partition = partition;
+        this.capacity = ~~(this.total / this.partition);
+    }
+    consume(tokens, preroll) {
+        if (!(this.remains >= tokens)) {
+            return false;
+        }
+        if (!preroll) {
+            this.remains -= tokens;
+            /*
+             * note:
+             *  由于 `tokens` 可能为负值，
+             *  导致计算出的 `remains` 超过总值 `capacity`
+             */
+            if (!this.overflow && this.remains > this.capacity) {
+                this.remains = this.capacity;
+            }
+        }
+        return true;
+    }
+    drain() {
+        const { remains } = this;
+        this.remains = 0;
+        return remains;
+    }
+    recalculate(partition) {
+        let remains = ~~(this.total / partition) - (this.capacity - this.remains);
+        if (remains < 0) {
+            remains = 0;
+        }
+        this.remains = remains;
+    }
+}
+exports.BasicBucket = BasicBucket;
+/**
+ * 内部令牌桶
+ * 桶内剩余可用令牌，由内部新增
+ */
+class InternalBucket extends BasicBucket {
+    constructor(total, partition, overflow = false, duration, options) {
+        super(total, partition, overflow);
+        this.duration = duration;
+        this.options = options;
+        this.isAccessed = false;
+        this.idlePeriods = 0;
+        this.period = 0;
+        this.onWakUp(false);
+    }
+    get currentPeriod() {
+        return this.period;
+    }
+    consume(tokens, preroll) {
+        this.isAccessed = true;
+        this.wake();
+        return super.consume(tokens, preroll);
+    }
+    // #region Wake-sleep
+    onWakUp(immediate) {
+        if (immediate) {
+            this.onTimeout();
+        }
+        this.timer = setInterval(() => this.onTimeout.bind(this), this.duration).unref();
+    }
+    wake() {
+        if (this.timer === undefined) {
+            if (this.sleepTime === undefined) {
+                (0, utils_1.UNREACHABLE)();
+            }
+            const elapsedTime = Math.floor(((0, process_1.uptime)() - this.sleepTime) * utils_1.kSeconds);
+            this.period += Math.floor(elapsedTime / this.duration);
+            const interval = elapsedTime % this.duration;
+            if (interval === 0) {
+                this.onWakUp(false);
+            }
+            else {
+                this.timer = setTimeout(this.onWakUp.bind(this, true), interval).unref();
+            }
+        }
+    }
+    sleep() {
+        if (this.timer !== undefined) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        this.sleepTime = (0, process_1.uptime)();
+        this.idlePeriods = 0;
+        this.isAccessed = false;
+    }
+    // #endregion
+    onTimeout() {
+        this.period += 1;
+        this.remains = this.capacity;
+        if (this.isAccessed) {
+            this.idlePeriods = 0;
+        }
+        else {
+            this.idlePeriods += 1;
+        }
+        this.isAccessed = false;
+        /*
+         * 为了降低消耗，当超过 `this.options.idlePeriod` 周期没有访问时，
+         * 自动进入休眠状态（停止一切定时器）
+         *
+         * note:
+         *  如外部不再强引用（WeakMap 为弱引用）当前对象，当进入休眠状态后，当前对象会被自动回收
+         */
+        if (this.idlePeriods > this.options.idlePeriod) {
+            this.sleep();
+        }
+    }
+}
+exports.InternalBucket = InternalBucket;
+/**
+ * 外部令牌桶
+ * 桶内剩余可用令牌，由外部调整
+ */
+class ExternalBucket extends BasicBucket {
+    update(value) {
+        let remains = ~~((this.total - value) / this.partition);
+        if (remains < 0) {
+            remains = 0;
+        }
+        this.remains = remains;
+    }
+}
+exports.ExternalBucket = ExternalBucket;
+//# sourceMappingURL=bucket.js.map

package/@tencent/polaris/dist/limiter/bucket.js.map

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

package/@tencent/polaris/dist/limiter/index.d.ts

@@ -0,0 +1,73 @@
+import { GlobalOptions } from "../global";
+import { LoggerOptions } from "../logging";
+import { Metadata } from "../metadata";
+import { PluginList, PluginType } from "../plugins";
+import { LocalRegistryOptions } from "../registry";
+import { SkeletonClass } from "../skeleton";
+import { RequireKeys } from "../utils";
+import { Quota, RatelimitOptions } from "./ratelimit";
+declare type LimiterPluginList = Pick<PluginList, PluginType.LocalRegistry | PluginType.NamingService | PluginType.RatelimitService | PluginType.TrafficShaping | PluginType.TraceLogging | PluginType.StatReporter>;
+export declare type OptionalLimiterPluginList = RequireKeys<Partial<LimiterPluginList>, PluginType.NamingService>;
+export declare type LimiterOptions = GlobalOptions & RatelimitOptions & LoggerOptions & LocalRegistryOptions;
+export interface AcquireResponse {
+    /**
+     * 唯一 ID
+     * 用于优化下次查询性能
+     */
+    readonly id?: string;
+    /**
+     * 配额
+     */
+    readonly quotas: Quota[];
+}
+declare const kRatelimit: unique symbol;
+declare const kRegistry: unique symbol;
+declare const kCurrentInstances: unique symbol;
+declare const KMaxInstances: unique symbol;
+export declare class Limiter extends SkeletonClass<LimiterPluginList> {
+    /**
+     * note:
+     * 由于类包含专用标识符时，`super` 调用必须是构造函数中的第一个语句。
+     * 所以这里采用 `Symbol` 来实现 __私有静态属性__
+     */
+    private static [kCurrentInstances];
+    private static [KMaxInstances];
+    /**
+     * 当前可实例化的最大次数
+     */
+    static get maxInstances(): number;
+    /**
+     * 设置可实例化的最大次数
+     * @param n 最大次数
+     */
+    static setMaxInstances(n: number): void;
+    private readonly [kRatelimit];
+    private readonly [kRegistry];
+    /**
+     * Create Limiter
+     * @param plugins 插件
+     * @param options 配置参数（可选）
+     */
+    constructor(plugins: OptionalLimiterPluginList, options?: Partial<LimiterOptions>);
+    /**
+     * 销毁（释放）所占资源
+     *
+     * @description
+     * dispose order:
+     *  Ratelimit -> Registry -> [plguins]
+     *
+     * @param sync 是否同步释放（可选）
+     */
+    dispose(sync?: boolean): void;
+    /**
+     * 通过条件获取配额分配对象
+     * @param namespace 命名空间
+     * @param service 服务名
+     * @param amount 请求的配额数
+     * @param cluster 集群名（可选）
+     * @param labels 标签集合（可选）
+     * @param id 唯一 ID（可选）
+     */
+    acquire(namespace: string, service: string, amount: number, cluster?: string, labels?: Metadata, id?: string): Promise<AcquireResponse>;
+}
+export {};