@tencent-rtc/mcp 1.0.0

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

@@ -0,0 +1,282 @@
+"use strict";
+var _a, _b, _c;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkeletonClass = exports.kGlobal = exports.kMaybeAlreadyDisposed = exports.kDisposed = exports.emitMaxInstancesExceededWarning = exports.isStatReporterPlugin = exports.ResultType = exports.kAPIReport = exports.kAPICollector = exports.kCollector = exports.kLogger = void 0;
+const errors_1 = require("./errors");
+const global_1 = require("./global");
+const logging_1 = require("./logging");
+const plugins_1 = require("./plugins");
+const utils_1 = require("./utils");
+exports.kLogger = Symbol("kLogger");
+const kInitializePlugin = Symbol("kInitializePlugin");
+// #region collector
+exports.kCollector = Symbol("kCollector");
+exports.kAPICollector = Symbol("kAPICollector");
+exports.kAPIReport = Symbol("kAPIReport");
+const kReportTimer = Symbol("kReportTimer");
+const kNeedAPICollector = Symbol("kNeedAPICollector");
+var ResultType;
+(function (ResultType) {
+    /** 未知 */
+    ResultType[ResultType["Unknown"] = 0] = "Unknown";
+    /** 用户调用成功 */
+    ResultType[ResultType["Success"] = 1] = "Success";
+    /** 由于用户的原因，如参数错误导致的调用错误 */
+    ResultType[ResultType["UserFail"] = 2] = "UserFail";
+    /** 由于系统原因（SDK 或者 Server）导致用户调用失败 */
+    ResultType[ResultType["SystemFail"] = 3] = "SystemFail";
+})(ResultType = exports.ResultType || (exports.ResultType = {}));
+const kSep = "|";
+const classifyCost = (cost) => {
+    if (cost < 50) {
+        return "[0ms,50ms)";
+    }
+    if (cost >= 50 && cost < 100) {
+        return "[50ms,100ms)";
+    }
+    if (cost >= 100 && cost < 150) {
+        return "[100ms,150ms)";
+    }
+    if (cost >= 150 && cost < 200) {
+        return "[150ms,200ms)";
+    }
+    return "[200ms,)";
+};
+// #endregion
+// #region config
+const pickConfig = (plugins, result = Object.create(null)) => {
+    Object.values(plugins).forEach((plugin) => {
+        var _d;
+        if (plugin === undefined) {
+            if (plugin === plugins[plugins_1.PluginType.CircuitBreaker]) {
+                return;
+            }
+            (0, utils_1.UNREACHABLE)();
+        }
+        if (Array.isArray(plugin)) {
+            return pickConfig(plugin, result);
+        }
+        const config = (_d = plugin.getConfig) === null || _d === void 0 ? void 0 : _d.call(plugin);
+        if (config !== undefined) {
+            result[plugin.name] = config;
+        }
+    });
+    return result;
+};
+// #endregion
+exports.isStatReporterPlugin = ((plugin) => (plugin.type & plugins_1.PluginType.StatReporter) !== 0);
+const emitMaxInstancesExceededWarning = (type, count) => {
+    /**
+     * 由于 `process.emitWarning` 实现中判断了传入的 `err instanceof Error`，
+     * 而在某些场景下（如 Mock 时） `Error` 对象会被用户代码修改（替换），
+     * 而 Node.js 所判断的对象（表达式右值）为原始 `Error` 对象（不受用户代码影响），
+     * 导致调用时抛出 [ERR_INVALID_ARG_TYPE] 异常，
+     * 故在这里使用 `PrimordialsError`，也就是 Node.js 原始 `Error` 对象。
+     */
+    const warning = new errors_1.PrimordialsError("Possible multiple useless instantiations detected. "
+        + `Current ${type} is instantiated ${count} times. `
+        + "Call setMaxInstances(n) to increase limit, "
+        + "or explicit call dispose() to release instance.");
+    warning.name = "MaxInstancesExceededWarning";
+    warning.type = type;
+    warning.count = count;
+    process.emitWarning(warning);
+};
+exports.emitMaxInstancesExceededWarning = emitMaxInstancesExceededWarning;
+const isUserFail = (code) => code === errors_1.ErrorCodes.InvalidArgument
+    || code === errors_1.ErrorCodes.InvalidConfig
+    || code === errors_1.ErrorCodes.ServiceNotFound
+    || code === errors_1.ErrorCodes.StateError
+    || code === errors_1.ErrorCodes.ServerError /** 非 `ServerException` 均属于用户异常 */;
+// #region dispose
+exports.kDisposed = Symbol("kDisposed");
+exports.kMaybeAlreadyDisposed = Symbol("kMaybeAlreadyDisposed");
+const performDispose = (plugin) => {
+    if (!plugin.isDisposed) {
+        plugin.dispose();
+    }
+};
+const disposePlugin = (plugin, sync) => {
+    if (typeof plugin.dispose === "function") {
+        if (sync) {
+            performDispose(plugin);
+        }
+        else {
+            process.nextTick(performDispose, plugin);
+        }
+    }
+};
+// #endregion
+exports.kGlobal = Symbol("kGlobal");
+/**
+ * API 骨架类，用于 `Consumer` | `Provider` | `Limiter`
+ */
+class SkeletonClass {
+    constructor(plugins, options, logger) {
+        this[_a] = false;
+        this[_b] = Object.create(null);
+        this[_c] = false;
+        this.plugins = plugins;
+        this[exports.kLogger] = logger !== null && logger !== void 0 ? logger : new logging_1.DefaultLogger(this.plugins[plugins_1.PluginType.TraceLogging], options);
+        this[exports.kGlobal] = (0, global_1.createGlobalOptions)(options);
+        this[kInitializePlugin]();
+        let config;
+        this.plugins[plugins_1.PluginType.StatReporter].forEach((reporter) => {
+            var _d;
+            (_d = reporter.systemConfig) === null || _d === void 0 ? void 0 : _d.call(reporter, config !== null && config !== void 0 ? config : (config = {
+                system: options,
+                plugins: pickConfig(Object.values(this.plugins))
+            })).catch(err => this[exports.kDisposed] || this[exports.kLogger].error(`[${reporter.name}] [systemConfig]`, err));
+            this[kNeedAPICollector] || (this[kNeedAPICollector] = typeof reporter.apiStatistics === "function");
+        });
+    }
+    // #region dispose
+    [(_a = exports.kDisposed, _b = exports.kCollector, _c = kNeedAPICollector, exports.kMaybeAlreadyDisposed)]() {
+        if (this[exports.kDisposed]) {
+            throw new errors_1.StateError("Already disposed");
+        }
+    }
+    /**
+     * @description
+     * dispose order:
+     *  ... [plugins] ... -> TraceLogging
+     *
+     * @param sync 是否同步释放
+     */
+    dispose(sync) {
+        if (this[exports.kDisposed]) {
+            return;
+        }
+        this[exports.kDisposed] = true;
+        const logging = this.plugins[plugins_1.PluginType.TraceLogging];
+        const plugins = Object.values(this.plugins);
+        const { length } = plugins;
+        for (let i = 0; i <= length; i += 1) {
+            const val = i === length ? logging : plugins[i];
+            if (i !== length && val === logging) {
+                continue;
+            }
+            if (Array.isArray(val)) {
+                val.forEach((plugin) => disposePlugin(plugin, sync));
+            }
+            else {
+                disposePlugin(val, sync);
+            }
+        }
+    }
+    // #endregion
+    // #region logger & trace
+    setVerbosity(verbosity) {
+        this[exports.kLogger].setVerbosity(verbosity);
+    }
+    enableTracing() {
+        this[exports.kLogger].enableTracing();
+    }
+    disableTracing() {
+        this[exports.kLogger].disableTracing();
+    }
+    // #endregion
+    [kInitializePlugin]() {
+        const { globalVariables, enableReporter } = this[exports.kGlobal];
+        if (!enableReporter) {
+            const pluginSet = new Set();
+            Object.entries(this.plugins).forEach(([key, val]) => {
+                if (key !== `${plugins_1.PluginType.StatReporter}`) {
+                    if (Array.isArray(val)) {
+                        val.forEach(plugin => pluginSet.add(plugin));
+                    }
+                    else {
+                        pluginSet.add(val);
+                    }
+                }
+            });
+            this.plugins[plugins_1.PluginType.StatReporter].forEach(
+            /**
+             * 由于 `StatReporter` 插件可能与其它插件（如：`NamingService`）实现在一个对象内，
+             * 故需要判断对象的全局唯一性，再调用 dispose 方法
+             */
+            plugin => !pluginSet.has(plugin) && disposePlugin(plugin, false));
+            this.plugins[plugins_1.PluginType.StatReporter] = [];
+        }
+        const logging = this.plugins[plugins_1.PluginType.TraceLogging];
+        const logger = this[exports.kLogger];
+        Object.values(this.plugins).forEach((val) => {
+            var _d, _e;
+            // fix TypeScript 4.3.2 bug
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            if (val) {
+                if (Array.isArray(val)) {
+                    if (val !== logging) {
+                        val.forEach((plugin) => {
+                            var _d, _e;
+                            (_d = plugin.setLogger) === null || _d === void 0 ? void 0 : _d.call(plugin, logger);
+                            (_e = plugin.setVariables) === null || _e === void 0 ? void 0 : _e.call(plugin, globalVariables);
+                        });
+                    }
+                }
+                else {
+                    (_d = val.setLogger) === null || _d === void 0 ? void 0 : _d.call(val, logger);
+                    (_e = val.setVariables) === null || _e === void 0 ? void 0 : _e.call(val, globalVariables);
+                }
+            }
+        });
+    }
+    // #region API
+    [exports.kAPICollector](api, cost, err) {
+        if (!this[kNeedAPICollector]) {
+            return;
+        }
+        let code = "0";
+        if (typeof err !== "undefined") {
+            if ((0, errors_1.isPolarisError)(err)) {
+                code = err[errors_1.kErrorCode];
+            }
+            else {
+                code = errors_1.ErrorCodes.InternalError;
+            }
+        }
+        const key = api + kSep + classifyCost(cost) + kSep + code;
+        const collector = this[exports.kCollector];
+        if (collector[key] === undefined) {
+            collector[key] = 1;
+        }
+        else {
+            collector[key] += 1;
+        }
+        if (this[kReportTimer] === undefined) {
+            this[kReportTimer] = setTimeout(() => {
+                this[exports.kAPIReport]();
+                this[kReportTimer] = undefined;
+            }, 1 * utils_1.kMinutes).unref(); /** 上报的指标值单位为每分钟 */
+        }
+    }
+    [exports.kAPIReport]() {
+        const collector = this[exports.kCollector];
+        this[exports.kCollector] = Object.create(null);
+        Object.keys(collector).forEach((key) => {
+            const [api, delay, code] = key.split(kSep);
+            const statKey = {
+                api,
+                delay,
+                code,
+                result: ResultType.Unknown
+            };
+            if (code === "0") {
+                statKey.result = ResultType.Success;
+            }
+            else if (isUserFail(code)) {
+                statKey.result = ResultType.UserFail;
+            }
+            else {
+                statKey.result = ResultType.SystemFail;
+            }
+            const statValue = collector[key];
+            this.plugins[plugins_1.PluginType.StatReporter].forEach((reporter) => {
+                var _d;
+                (_d = reporter.apiStatistics) === null || _d === void 0 ? void 0 : _d.call(reporter, statKey, statValue).catch(err => this[exports.kDisposed] || this[exports.kLogger].error(`[${reporter.name}] [apiStatistics]`, err));
+            });
+        });
+    }
+}
+exports.SkeletonClass = SkeletonClass;
+//# sourceMappingURL=skeleton.js.map

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

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

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

@@ -0,0 +1,36 @@
+export declare const kModuleVersion: string;
+export declare const kModuleName: string;
+export declare const kNanos = 1000;
+export declare const kMillisecond = 1;
+export declare const kSeconds: number;
+export declare const kMinutes: number;
+export declare const kHours: number;
+export declare const kDays: number;
+/**
+ * 求最大公约数
+ * @param values 数值
+ */
+export declare function GreatestCommonDivisor(...values: number[]): number;
+/**
+ * 判断开关是否开启
+ * @param it 开关字符串
+ */
+export declare function on(it?: string): boolean;
+/**
+ * UNREACHABLE CODE
+ */
+export declare function UNREACHABLE(): never;
+/**
+ * UNIMPLEMENTED
+ */
+export declare function UNIMPLEMENTED(): never;
+export declare type PartialSubset<T, U extends keyof T = never> = {
+    [P in keyof T]: P extends U ? Partial<T[P]> : T[P];
+};
+export declare type RequireKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+export declare type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+export declare type RemoveNever<T> = Pick<T, {
+    [K in keyof T]: T[K] extends never ? never : K;
+}[keyof T]>;
+export declare type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+export declare type PromiseConstructorParameters = Parameters<ConstructorParameters<typeof Promise>[0]>;

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

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNIMPLEMENTED = exports.UNREACHABLE = exports.on = exports.GreatestCommonDivisor = exports.kDays = exports.kHours = exports.kMinutes = exports.kSeconds = exports.kMillisecond = exports.kNanos = exports.kModuleName = exports.kModuleVersion = void 0;
+const errors_1 = require("./errors");
+// #region Module Info
+/* eslint-disable @typescript-eslint/naming-convention */
+/*
+ * note:
+ *  由于这里引用了 `src` 外文件，导致在构建时输出目录不正确
+ *  所以这里使用 require(...) 来代替 import ...
+ */
+const pkg = require("../package.json"); // eslint-disable-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+exports.kModuleVersion = pkg.version;
+exports.kModuleName = pkg.name;
+/* eslint-enable @typescript-eslint/naming-convention */
+// #endregion
+// #region Time Constant
+/* eslint-disable @typescript-eslint/naming-convention */
+exports.kNanos = 1000;
+exports.kMillisecond = 1;
+exports.kSeconds = 1000 * exports.kMillisecond;
+exports.kMinutes = 60 * exports.kSeconds;
+exports.kHours = 60 * exports.kMinutes;
+exports.kDays = 24 * exports.kHours;
+/* eslint-enable @typescript-eslint/naming-convention */
+// #endregion
+// #region Functions
+/**
+ * 求最大公约数
+ * @param values 数值
+ */
+function GreatestCommonDivisor(...values) {
+    const len = values.length;
+    while (values.some(value => value !== values[0])) {
+        values.sort((a, b) => b - a);
+        for (let i = 0; i < len - 1; i++) {
+            const remains = values[i] % values[i + 1];
+            if (remains === 0) {
+                values[i] = values[i + 1];
+            }
+            else {
+                values[i] = remains;
+            }
+        }
+    }
+    return values[0] || NaN;
+}
+exports.GreatestCommonDivisor = GreatestCommonDivisor;
+/**
+ * 判断开关是否开启
+ * @param it 开关字符串
+ */
+function on(it) {
+    return !!it && it !== "0" && it !== "false" && it !== "off";
+}
+exports.on = on;
+// #endregion
+// #region Assert Method
+/**
+ * UNREACHABLE CODE
+ */
+function UNREACHABLE() {
+    throw new errors_1.FatalError("UNREACHABLE CODE", UNREACHABLE);
+}
+exports.UNREACHABLE = UNREACHABLE;
+/**
+ * UNIMPLEMENTED
+ */
+function UNIMPLEMENTED() {
+    throw new errors_1.FatalError("UNIMPLEMENTED", UNIMPLEMENTED);
+}
+exports.UNIMPLEMENTED = UNIMPLEMENTED;
+// #endregion
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAAA,qCAAsC;AAEtC,sBAAsB;AACtB,yDAAyD;AACzD;;;;GAIG;AACH,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAA4B,CAAC,CAAC,gGAAgG;AAEtJ,QAAA,cAAc,GAAG,GAAG,CAAC,OAAiB,CAAC;AACvC,QAAA,WAAW,GAAG,GAAG,CAAC,IAAc,CAAC;AAC9C,wDAAwD;AACxD,aAAa;AAEb,wBAAwB;AACxB,yDAAyD;AAC5C,QAAA,MAAM,GAAG,IAAK,CAAC;AACf,QAAA,YAAY,GAAG,CAAC,CAAC;AACjB,QAAA,QAAQ,GAAG,IAAK,GAAG,oBAAY,CAAC;AAChC,QAAA,QAAQ,GAAG,EAAE,GAAG,gBAAQ,CAAC;AACzB,QAAA,MAAM,GAAG,EAAE,GAAG,gBAAQ,CAAC;AACvB,QAAA,KAAK,GAAG,EAAE,GAAG,cAAM,CAAC;AACjC,wDAAwD;AACxD,aAAa;AAEb,oBAAoB;AACpB;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAAG,MAAgB;IACvD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;QAChD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;YAChC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,IAAI,OAAO,KAAK,CAAC,EAAE;gBACjB,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;aAC3B;iBAAM;gBACL,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;aACrB;SACF;KACF;IAED,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAC1B,CAAC;AAfD,sDAeC;AAED;;;GAGG;AACH,SAAgB,EAAE,CAAC,EAAW;IAC5B,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,OAAO,IAAI,EAAE,KAAK,KAAK,CAAC;AAC9D,CAAC;AAFD,gBAEC;AACD,aAAa;AAEb,wBAAwB;AACxB;;GAEG;AACH,SAAgB,WAAW;IACzB,MAAM,IAAI,mBAAU,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC;AAFD,kCAEC;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,MAAM,IAAI,mBAAU,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;AACvD,CAAC;AAFD,sCAEC;AAkBD,aAAa"}

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

@@ -0,0 +1,11 @@
+export interface WeakReference<T> {
+    equal(value: T): boolean;
+    find(values: T[]): T | undefined;
+    reset(target: T): WeakReference<T>;
+}
+declare type WeakReferenceConstructor = new <T extends object>(target: T) => WeakReference<T>;
+/**
+ * `WeakReference` 提供 Weak 类型容器，用于兼容不支持 `WeakRef` 环境
+ */
+export declare const WeakReference: WeakReferenceConstructor;
+export {};

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

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WeakReference = void 0;
+/**
+ * `WeakReference` 提供 Weak 类型容器，用于兼容不支持 `WeakRef` 环境
+ */
+exports.WeakReference = (typeof WeakRef === "function")
+    ? class {
+        constructor(target) {
+            this.ref = new WeakRef(target);
+        }
+        reset(target) {
+            this.ref = new WeakRef(target);
+            return this;
+        }
+        equal(value) {
+            return this.ref.deref() === value;
+        }
+        find(values) {
+            const target = this.ref.deref();
+            if (target === undefined) {
+                return undefined;
+            }
+            return values.includes(target) ? target : undefined;
+        }
+    }
+    : class {
+        constructor(target) {
+            this.ref = new WeakSet();
+            this.ref.add(target);
+        }
+        reset(target) {
+            this.ref.add(target);
+            return this;
+        }
+        equal(value) {
+            return this.ref.has(value);
+        }
+        find(values) {
+            return values.find(value => this.ref.has(value));
+        }
+    };
+// #endregion
+//# sourceMappingURL=weak.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"weak.js","sourceRoot":"","sources":["../src/weak.ts"],"names":[],"mappings":";;;AAmBA;;GAEG;AACU,QAAA,aAAa,GAA6B,CAAC,OAAO,OAAO,KAAK,UAAU,CAAC;IACpF,CAAC,CAAC;QAGA,YAAY,MAAS;YACnB,IAAI,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,MAAS;YACb,IAAI,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,KAAQ;YACZ,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,MAAW;YACd,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,MAAM,KAAK,SAAS,EAAE;gBACxB,OAAO,SAAS,CAAC;aAClB;YACD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACtD,CAAC;KACF;IACD,CAAC,CAAC;QAGA,YAAY,MAAS;YAFJ,QAAG,GAAe,IAAI,OAAO,EAAE,CAAC;YAG/C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,MAAS;YACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,KAAQ;YACZ,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,MAAW;YACd,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,aAAa"}

package/@tencent/polaris/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@tencent/polaris",
+  "version": "0.4.5",
+  "description": "Polaris（北极星）名字服务 SDK",
+  "author": "superzheng <superzheng@tencent.com>",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "http://git.woa.com/polaris/polaris-nodejs.git"
+  },
+  "funding": "wxwork://message?username=superzheng",
+  "bugs": "https://git.woa.com/polaris/polaris-nodejs/issues",
+  "homepage": "https://git.woa.com/polaris/polaris-nodejs",
+  "keywords": [
+    "polaris"
+  ],
+  "scripts": {
+    "build": "npm run lint && npm run clean && npm run build:src && npm run build:scripts && npm run pb:ts && npm run pb:dist:base && npm run pb:dist:grpc",
+    "build:src": "tsc -p tsconfig.json",
+    "build:scripts": "tsc -p tsconfig.scripts.json",
+    "coverage": "cross-env NODE_ENV=test nyc ava",
+    "clean": "shx rm -rf .nyc-output coverage dist",
+    "lint": "eslint --max-warnings=0 \"@(src|test|tools)/**/*.@(js|ts)\"",
+    "check": "npm run build",
+    "test": "cross-env NODE_ENV=test ava",
+    "pb:ts": "ts-node ./tools/pb2ts.ts src/plugins/naming/polaris-server/discover-pb src/plugins/naming/polaris-server/monitor-pb src/plugins/naming/polaris-server/ratelimit-pb",
+    "pb:dist:base": "shx cp -r src/plugins/naming/polaris-server/discover-pb src/plugins/naming/polaris-server/monitor-pb src/plugins/naming/polaris-server/ratelimit-pb dist/plugins/naming/polaris-server/",
+    "pb:dist:grpc": "shx cp -r src/plugins/naming/polaris-server/connector/grpc/pb dist/plugins/naming/polaris-server/connector/grpc/pb",
+    "lines": "bash -c \"find . -name \\*.ts | grep -v -E tools\\|test\\|node_modules\\|.d.ts | xargs cat | wc -l\"",
+    "postinstall": "node -e \"try{require('./dist/scripts/postinstall')}catch(e){}\""
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^16.1.0",
+    "@commitlint/config-conventional": "^16.0.0",
+    "@hjkcai/eslint-config-halo": "^8.6.3",
+    "@types/debug": "^4.1.5",
+    "@types/node": "^17.0.10",
+    "@types/semver": "^7.3.9",
+    "@types/sinon": "^10.0.6",
+    "@types/uuid": "^8.3.4",
+    "ava": "^4.0.1",
+    "cross-env": "^7.0.3",
+    "eslint": "^8.7.0",
+    "husky": "^7.0.4",
+    "nyc": "^15.1.0",
+    "shx": "^0.3.4",
+    "sinon": "^12.0.1",
+    "tmp-promise": "^3.0.3",
+    "ts-node": "^10.4.0",
+    "typescript": "^4.4.5"
+  },
+  "husky": {
+    "hooks": {
+      "commit-msg": "commitlint -e .git/COMMIT_EDITMSG",
+      "pre-push": "npm run check"
+    }
+  },
+  "nyc": {
+    "extension": [
+      ".ts"
+    ],
+    "include": [
+      "src/**/*.ts"
+    ],
+    "exclude": [
+      "**/*.d.ts"
+    ],
+    "reporter": [
+      "lcov",
+      "text",
+      "text-summary"
+    ]
+  },
+  "ava": {
+    "extensions": [
+      "ts"
+    ],
+    "require": [
+      "ts-node/register"
+    ],
+    "files": [
+      "test/**/*.test.ts"
+    ],
+    "ignoredByWatcher": [
+      "!src/**/*.ts"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ],
+    "rules": {
+      "subject-case": [
+        0
+      ]
+    }
+  },
+  "dependencies": {
+    "@grpc/grpc-js": "^1.5.1",
+    "@grpc/proto-loader": "^0.6.6",
+    "@types/hashring": "^3.2.1",
+    "axios": "^0.25.0",
+    "debug": "^4.3.1",
+    "hashring": "^3.2.0",
+    "protobufjs": "^6.11.2",
+    "semver": "^7.3.5",
+    "uuid": "^8.3.2"
+  }
+}

package/README.md

@@ -0,0 +1,61 @@
+## Tencent SDK Model Context Protocol (MCP) Server for Cursor IDE
+
+This repository provides a CLI-based Model Context Protocol (MCP) server that exposes Tencent SDK documentation and Tencent API resources to LLM-powered tools.
+This improves the LLM AI Agent's ability to understand and interact with Tencent's SDKs and APIs.
+
+
+## Features
+
+- MCP server exposing tools for interacting with Tencent via JSON-RPC over STDIN/STDOUT.
+- MCP server supports SSE Mode by supplying `HTTP_PORT` environment variable.
+- Retrieve official Tencent SDK documentation (HTML → Markdown) for:
+  - Languages: JavaScript, Java, Swift, Objective-C, Kotlin.
+  - API reference sections: configuration, calls function.
+- Retrieve official Tencent TUICallKit SDK documentation (HTML → Markdown) for:
+  - TUICallKit SDK languages: JavaScript, Kotlin, Swift.
+  - TUICallKit SDK topics: configuration, calls function.
+- Converts remote HTML articles to Markdown using `jsdom` and `turndown` for consistent documentation formatting.
+- Input validation via Zod schemas for all tool parameters, ensuring robust error handling.
+- Extensible tool definitions leveraging the Model Context Protocol SDK (`@modelcontextprotocol/sdk`) with `McpServer` and `StdioServerTransport`.
+
+
+## Prerequisites
+- Node.js (>= 18) and npm
+- Cursor IDE with MCP support
+
+
+## How To Use
+To set up the @tencentcloud/sdk-mcp MCP Server, follow these steps:
+
+- Step1: Installation.
+
+```
+npx -y @tencentcloud/sdk-mcp
+```
+
+
+- Step2: In your Cursor project, create or open the `.cursor/mcp.json` or `~/.cursor/mcp.json` files and add your config.
+
+```javascript
+{
+  "mcpServers": {
+    "tencentcloud-sdk-mcp": {
+      "command": "npx",
+      "args": ["-y", "@tencentcloud/sdk-mcp"]
+    }
+  }
+}
+```
+When you save the file, a notification is displayed. In the prompt, click **Enable**.
+
+![mcp-server-prompt](./mcp-server-prompt.png)
+
+- Step3: Navigate to **Cursor Settings** (the gear icon in top right corner) -> **MCP**, and check if tencentcloud-sdk-mcp server is enabled.
+
+![cursor-setting](cursor-setting.png)
+
+
+Step4: Ask the AI agent to build your Tencentcloud sdk app for you by describing the functionality yourself or by using a sample prompt.
+
+> [!WARNING]
+Make sure to use the Agent mode. Depending on your Cursor rules, you may also need to explicitly ask the AI agent to use the Tencentcloud sdk-mcp server.

package/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_js_1 = require("./server.js");
+async function main() {
+    const server = (0, server_js_1.createServer)();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.debug("Tencent RTC MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map