timbot 2026.2.3

package/README.md

@@ -0,0 +1,123 @@
+# Tencent Cloud IM Channel Plugin for Clawdbot
+
+Maintainer: longyuqi@tencent.com
+
+Status: Tencent Cloud IM intelligent bot via webhooks + REST API.
+
+## Install
+
+### Option A: Install from npm
+```bash
+clawdbot plugins install @clawdbot/timbot
+clawdbot plugins enable timbot
+clawdbot gateway restart
+```
+
+### Option B: Local development (link)
+```bash
+clawdbot plugins install --link extensions/timbot
+clawdbot plugins enable timbot
+clawdbot gateway restart
+```
+
+## Configure
+
+```json5
+{
+  channels: {
+    timbot: {
+      enabled: true,
+      webhookPath: "/timbot",
+      sdkAppId: "YOUR_SDK_APP_ID",
+      secretKey: "YOUR_SECRET_KEY",
+      botAccount: "YOUR_BOT_ACCOUNT",
+      apiDomain: "https://console.tim.qq.com",
+      token: "YOUR_CALLBACK_TOKEN",
+      welcomeText: "Hello!",
+      dm: { policy: "open" }
+    }
+  }
+}
+```
+
+### Configuration Options
+
+| Option | Description |
+|--------|-------------|
+| `webhookPath` | Webhook endpoint path |
+| `sdkAppId` | Tencent Cloud IM SDK App ID |
+| `secretKey` | Secret key for generating UserSig (obtained from IM Console) |
+| `botAccount` | Bot account ID |
+| `apiDomain` | Tencent IM API domain |
+| `token` | Callback token for signature verification |
+| `welcomeText` | Welcome message for new conversations |
+| `dm.policy` | DM policy: `pairing`, `allowlist`, `open`, or `disabled` |
+
+## Notes
+
+- Webhooks require public HTTPS. For security, only expose the webhook path to the internet.
+- Obtain `sdkAppId` and `secretKey` from the [Tencent Cloud IM Console](https://console.cloud.tencent.com/im). The `secretKey` is used to dynamically generate UserSig.
+- Supports multiple accounts via the `accounts` configuration.
+
+---
+
+# Clawdbot 腾讯云 IM Channel 插件
+
+维护者：longyuqi@tencent.com
+
+状态：支持腾讯云即时通信 IM 智能机器人，通过 Webhook 回调 + REST API 实现。
+
+## 安装
+
+### 方式 A：从 npm 安装
+```bash
+clawdbot plugins install @clawdbot/timbot
+clawdbot plugins enable timbot
+clawdbot gateway restart
+```
+
+### 方式 B：本地开发（link）
+```bash
+clawdbot plugins install --link extensions/timbot
+clawdbot plugins enable timbot
+clawdbot gateway restart
+```
+
+## 配置
+
+```json5
+{
+  channels: {
+    timbot: {
+      enabled: true,
+      webhookPath: "/timbot",
+      sdkAppId: "YOUR_SDK_APP_ID",
+      secretKey: "YOUR_SECRET_KEY",
+      botAccount: "YOUR_BOT_ACCOUNT",
+      apiDomain: "https://console.tim.qq.com",
+      token: "YOUR_CALLBACK_TOKEN",
+      welcomeText: "你好！",
+      dm: { policy: "open" }
+    }
+  }
+}
+```
+
+### 配置项说明
+
+| 配置项 | 说明 |
+|--------|------|
+| `webhookPath` | Webhook 回调路径 |
+| `sdkAppId` | 腾讯云 IM SDK 应用 ID |
+| `secretKey` | 密钥，用于动态生成 UserSig（从 IM 控制台获取） |
+| `botAccount` | 机器人账号 ID |
+| `apiDomain` | 腾讯 IM API 域名 |
+| `token` | 回调签名验证 Token |
+| `welcomeText` | 新会话欢迎语 |
+| `dm.policy` | 私聊策略：`pairing`、`allowlist`、`open` 或 `disabled` |
+
+## 说明
+
+- Webhook 必须是公网 HTTPS。出于安全考虑，建议只对外暴露 webhook 路径。
+- `sdkAppId` 和 `secretKey` 需从[腾讯云 IM 控制台](https://console.cloud.tencent.com/im)获取。`secretKey` 用于动态生成 UserSig。
+- 支持通过 `accounts` 配置多账号。

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Author: YanHaidao
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: any;
+    register(api: OpenClawPluginApi): void;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAO7D,QAAA,MAAM,MAAM;;;;;kBAKI,iBAAiB,GAAG,IAAI;CAKvC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { handleTimbotWebhookRequest } from "./src/monitor.js";
+import { setTimbotRuntime } from "./src/runtime.js";
+import { timbotPlugin } from "./src/channel.js";
+const plugin = {
+    id: "timbot",
+    name: "Tencent IM",
+    description: "Tencent Cloud IM intelligent bot channel via webhooks + REST API",
+    configSchema: emptyPluginConfigSchema(),
+    register(api) {
+        setTimbotRuntime(api.runtime);
+        api.registerChannel({ plugin: timbotPlugin });
+        api.registerHttpHandler(handleTimbotWebhookRequest);
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,kEAAkE;IAC/E,YAAY,EAAE,uBAAuB,EAAE;IACvC,QAAQ,CAAC,GAAsB;QAC7B,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9B,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9C,GAAG,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC;IACtD,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/src/accounts.d.ts

@@ -0,0 +1,10 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import type { ResolvedTimbotAccount } from "./types.js";
+export declare function listTimbotAccountIds(cfg: OpenClawConfig): string[];
+export declare function resolveDefaultTimbotAccountId(cfg: OpenClawConfig): string;
+export declare function resolveTimbotAccount(params: {
+    cfg: OpenClawConfig;
+    accountId?: string | null;
+}): ResolvedTimbotAccount;
+export declare function listEnabledTimbotAccounts(cfg: OpenClawConfig): ResolvedTimbotAccount[];
+//# sourceMappingURL=accounts.d.ts.map

package/dist/src/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,qBAAqB,EAAqC,MAAM,YAAY,CAAC;AAW3F,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAIlE;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAMzE;AAoBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,qBAAqB,CAyCxB;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,GAAG,qBAAqB,EAAE,CAItF"}

package/dist/src/accounts.js

@@ -0,0 +1,83 @@
+import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk";
+import { logSimple } from "./logger.js";
+const DEFAULT_API_DOMAIN = "console.tim.qq.com";
+function listConfiguredAccountIds(cfg) {
+    const accounts = cfg.channels?.timbot?.accounts;
+    if (!accounts || typeof accounts !== "object")
+        return [];
+    return Object.keys(accounts).filter(Boolean);
+}
+export function listTimbotAccountIds(cfg) {
+    const ids = listConfiguredAccountIds(cfg);
+    if (ids.length === 0)
+        return [DEFAULT_ACCOUNT_ID];
+    return ids.sort((a, b) => a.localeCompare(b));
+}
+export function resolveDefaultTimbotAccountId(cfg) {
+    const timbotConfig = cfg.channels?.timbot;
+    if (timbotConfig?.defaultAccount?.trim())
+        return timbotConfig.defaultAccount.trim();
+    const ids = listTimbotAccountIds(cfg);
+    if (ids.includes(DEFAULT_ACCOUNT_ID))
+        return DEFAULT_ACCOUNT_ID;
+    return ids[0] ?? DEFAULT_ACCOUNT_ID;
+}
+function resolveAccountConfig(cfg, accountId) {
+    const accounts = cfg.channels?.timbot?.accounts;
+    if (!accounts || typeof accounts !== "object")
+        return undefined;
+    return accounts[accountId];
+}
+function mergeTimbotAccountConfig(cfg, accountId) {
+    const raw = (cfg.channels?.timbot ?? {});
+    const { accounts: _ignored, defaultAccount: _ignored2, ...base } = raw;
+    const account = resolveAccountConfig(cfg, accountId) ?? {};
+    const merged = { ...base, ...account };
+    return merged;
+}
+export function resolveTimbotAccount(params) {
+    const accountId = normalizeAccountId(params.accountId);
+    const timbotConfig = params.cfg.channels?.timbot;
+    const baseEnabled = timbotConfig?.enabled !== false;
+    const merged = mergeTimbotAccountConfig(params.cfg, accountId);
+    const enabled = baseEnabled && merged.enabled !== false;
+    // 从合并后的配置中提取字段
+    const sdkAppId = merged.sdkAppId?.trim() || undefined;
+    const identifier = merged.identifier?.trim() || undefined;
+    const secretKey = merged.secretKey?.trim() || undefined;
+    const botAccount = merged.botAccount?.trim() || undefined;
+    const apiDomain = merged.apiDomain?.trim() || DEFAULT_API_DOMAIN;
+    const token = merged.token?.trim() || undefined;
+    // 配置完整需要 sdkAppId + secretKey（identifier 可选，默认使用 administrator）
+    const configured = Boolean(sdkAppId && secretKey);
+    // 配置不完整时输出警告
+    if (!configured && Boolean(timbotConfig)) {
+        const missing = [];
+        if (!sdkAppId)
+            missing.push("sdkAppId");
+        if (!secretKey)
+            missing.push("secretKey");
+        if (missing.length > 0) {
+            logSimple("warn", `配置不完整，缺少: ${missing.join(", ")}`);
+        }
+    }
+    return {
+        accountId,
+        name: merged.name?.trim() || undefined,
+        enabled,
+        configured,
+        sdkAppId,
+        identifier,
+        secretKey,
+        botAccount,
+        apiDomain,
+        token,
+        config: merged,
+    };
+}
+export function listEnabledTimbotAccounts(cfg) {
+    return listTimbotAccountIds(cfg)
+        .map((accountId) => resolveTimbotAccount({ cfg, accountId }))
+        .filter((account) => account.enabled);
+}
+//# sourceMappingURL=accounts.js.map

package/dist/src/accounts.js.map

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

package/dist/src/channel.d.ts

@@ -0,0 +1,4 @@
+import type { ChannelPlugin } from "openclaw/plugin-sdk";
+import type { ResolvedTimbotAccount } from "./types.js";
+export declare const timbotPlugin: ChannelPlugin<ResolvedTimbotAccount>;
+//# sourceMappingURL=channel.d.ts.map

package/dist/src/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EAEd,MAAM,qBAAqB,CAAC;AAU7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAsBxD,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,qBAAqB,CAyL7D,CAAC"}

package/dist/src/channel.js

@@ -0,0 +1,203 @@
+import { DEFAULT_ACCOUNT_ID, deleteAccountFromConfigSection, formatPairingApproveHint, setAccountEnabledInConfigSection, } from "openclaw/plugin-sdk";
+import { listTimbotAccountIds, resolveDefaultTimbotAccountId, resolveTimbotAccount } from "./accounts.js";
+import { timbotConfigSchema } from "./config-schema.js";
+import { registerTimbotWebhookTarget, sendTimbotMessage } from "./monitor.js";
+const meta = {
+    id: "timbot",
+    label: "Tencent IM",
+    selectionLabel: "Tencent IM (plugin)",
+    detailLabel: "Tencent Cloud IM Bot",
+    docsPath: "/channels/timbot",
+    docsLabel: "timbot",
+    blurb: "Tencent Cloud IM bot via webhooks + REST API.",
+    aliases: ["tencentim", "腾讯im", "即时通信"],
+    order: 85,
+    quickstartAllowFrom: true,
+};
+function normalizeTimbotMessagingTarget(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.replace(/^(timbot|tencentim):/i, "").trim() || undefined;
+}
+export const timbotPlugin = {
+    id: "timbot",
+    meta,
+    capabilities: {
+        chatTypes: ["direct"],
+        media: false,
+        reactions: false,
+        threads: false,
+        polls: false,
+        nativeCommands: false,
+        blockStreaming: false,
+    },
+    reload: { configPrefixes: ["channels.timbot"] },
+    configSchema: timbotConfigSchema,
+    config: {
+        listAccountIds: (cfg) => listTimbotAccountIds(cfg),
+        resolveAccount: (cfg, accountId) => resolveTimbotAccount({ cfg: cfg, accountId }),
+        defaultAccountId: (cfg) => resolveDefaultTimbotAccountId(cfg),
+        setAccountEnabled: ({ cfg, accountId, enabled }) => setAccountEnabledInConfigSection({
+            cfg: cfg,
+            sectionKey: "timbot",
+            accountId,
+            enabled,
+            allowTopLevel: true,
+        }),
+        deleteAccount: ({ cfg, accountId }) => deleteAccountFromConfigSection({
+            cfg: cfg,
+            sectionKey: "timbot",
+            clearBaseFields: ["name", "webhookPath", "sdkAppId", "identifier", "secretKey", "botAccount", "apiDomain", "welcomeText"],
+            accountId,
+        }),
+        isConfigured: (account) => account.configured,
+        describeAccount: (account) => ({
+            accountId: account.accountId,
+            name: account.name,
+            enabled: account.enabled,
+            configured: account.configured,
+            webhookPath: account.config.webhookPath ?? "/timbot",
+        }),
+        resolveAllowFrom: ({ cfg, accountId }) => {
+            const account = resolveTimbotAccount({ cfg: cfg, accountId });
+            return (account.config.dm?.allowFrom ?? []).map((entry) => String(entry));
+        },
+        formatAllowFrom: ({ allowFrom }) => allowFrom
+            .map((entry) => String(entry).trim())
+            .filter(Boolean)
+            .map((entry) => entry.toLowerCase()),
+    },
+    security: {
+        resolveDmPolicy: ({ cfg, accountId, account }) => {
+            const resolvedAccountId = accountId ?? account.accountId ?? DEFAULT_ACCOUNT_ID;
+            const useAccountPath = Boolean(cfg.channels?.timbot?.accounts?.[resolvedAccountId]);
+            const basePath = useAccountPath ? `channels.timbot.accounts.${resolvedAccountId}.` : "channels.timbot.";
+            return {
+                policy: account.config.dm?.policy ?? "open",
+                allowFrom: (account.config.dm?.allowFrom ?? []).map((entry) => String(entry)),
+                policyPath: `${basePath}dm.policy`,
+                allowFromPath: `${basePath}dm.allowFrom`,
+                approveHint: formatPairingApproveHint("timbot"),
+                normalizeEntry: (raw) => raw.trim().toLowerCase(),
+            };
+        },
+    },
+    groups: {
+        resolveRequireMention: () => true,
+    },
+    threading: {
+        resolveReplyToMode: () => "off",
+    },
+    messaging: {
+        normalizeTarget: normalizeTimbotMessagingTarget,
+        targetResolver: {
+            looksLikeId: (raw) => Boolean(raw.trim()),
+            hint: "<userid>",
+        },
+    },
+    outbound: {
+        deliveryMode: "direct",
+        chunkerMode: "text",
+        textChunkLimit: 10000,
+        sendText: async ({ account, target, text }) => {
+            const result = await sendTimbotMessage({
+                account,
+                toAccount: target,
+                text,
+                fromAccount: account.botAccount,
+            });
+            return {
+                channel: "timbot",
+                ok: result.ok,
+                messageId: result.messageId ?? "",
+                error: result.error ? new Error(result.error) : undefined,
+            };
+        },
+    },
+    status: {
+        defaultRuntime: {
+            accountId: DEFAULT_ACCOUNT_ID,
+            running: false,
+            lastStartAt: null,
+            lastStopAt: null,
+            lastError: null,
+        },
+        buildChannelSummary: ({ snapshot }) => ({
+            configured: snapshot.configured ?? false,
+            running: snapshot.running ?? false,
+            webhookPath: snapshot.webhookPath ?? null,
+            lastStartAt: snapshot.lastStartAt ?? null,
+            lastStopAt: snapshot.lastStopAt ?? null,
+            lastError: snapshot.lastError ?? null,
+            lastInboundAt: snapshot.lastInboundAt ?? null,
+            lastOutboundAt: snapshot.lastOutboundAt ?? null,
+            probe: snapshot.probe,
+            lastProbeAt: snapshot.lastProbeAt ?? null,
+        }),
+        probeAccount: async () => ({ ok: true }),
+        buildAccountSnapshot: ({ account, runtime }) => ({
+            accountId: account.accountId,
+            name: account.name,
+            enabled: account.enabled,
+            configured: account.configured,
+            webhookPath: account.config.webhookPath ?? "/timbot",
+            running: runtime?.running ?? false,
+            lastStartAt: runtime?.lastStartAt ?? null,
+            lastStopAt: runtime?.lastStopAt ?? null,
+            lastError: runtime?.lastError ?? null,
+            lastInboundAt: runtime?.lastInboundAt ?? null,
+            lastOutboundAt: runtime?.lastOutboundAt ?? null,
+            dmPolicy: account.config.dm?.policy ?? "open",
+        }),
+    },
+    gateway: {
+        startAccount: async (ctx) => {
+            const account = ctx.account;
+            // verbose 级别打印配置信息
+            ctx.log?.debug(`启动账号: ${account.accountId}, configured=${account.configured}, enabled=${account.enabled}`);
+            ctx.log?.debug(`sdkAppId=${account.sdkAppId ?? "[未设置]"}, secretKey=${account.secretKey ? "[已配置]" : "[未设置]"}`);
+            if (!account.configured) {
+                ctx.log?.warn(`[${account.accountId}] timbot not configured; skipping webhook registration`);
+                ctx.setStatus({ accountId: account.accountId, running: false, configured: false });
+                return { stop: () => { } };
+            }
+            const path = (account.config.webhookPath ?? "/timbot").trim();
+            const unregister = registerTimbotWebhookTarget({
+                account,
+                config: ctx.cfg,
+                runtime: ctx.runtime,
+                core: {},
+                path,
+                statusSink: (patch) => ctx.setStatus({ accountId: ctx.accountId, ...patch }),
+            });
+            ctx.log?.info(`[${account.accountId}] timbot webhook registered at ${path}`);
+            ctx.setStatus({
+                accountId: account.accountId,
+                running: true,
+                configured: true,
+                webhookPath: path,
+                lastStartAt: Date.now(),
+            });
+            return {
+                stop: () => {
+                    unregister();
+                    ctx.log?.info(`[${account.accountId}] timbot webhook unregistered`);
+                    ctx.setStatus({
+                        accountId: account.accountId,
+                        running: false,
+                        lastStopAt: Date.now(),
+                    });
+                },
+            };
+        },
+        stopAccount: async (ctx) => {
+            ctx.setStatus({
+                accountId: ctx.account.accountId,
+                running: false,
+                lastStopAt: Date.now(),
+            });
+        },
+    },
+};
+//# sourceMappingURL=channel.js.map

package/dist/src/channel.js.map

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

package/dist/src/config-schema.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelConfigSchema } from "openclaw/plugin-sdk";
+export declare const timbotConfigSchema: ChannelConfigSchema;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/src/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAiC/D,eAAO,MAAM,kBAAkB,EAAE,mBAwBhC,CAAC"}

package/dist/src/config-schema.js

@@ -0,0 +1,55 @@
+const dmSchema = {
+    type: "object",
+    properties: {
+        enabled: { type: "boolean" },
+        policy: { type: "string", enum: ["pairing", "allowlist", "open", "disabled"] },
+        allowFrom: {
+            type: "array",
+            items: { oneOf: [{ type: "string" }, { type: "number" }] },
+        },
+    },
+    additionalProperties: false,
+};
+const accountSchema = {
+    type: "object",
+    properties: {
+        name: { type: "string" },
+        enabled: { type: "boolean" },
+        webhookPath: { type: "string" },
+        sdkAppId: { type: "string" },
+        identifier: { type: "string" },
+        secretKey: { type: "string" },
+        botAccount: { type: "string" },
+        apiDomain: { type: "string" },
+        token: { type: "string" },
+        welcomeText: { type: "string" },
+        dm: dmSchema,
+    },
+    additionalProperties: false,
+};
+export const timbotConfigSchema = {
+    schema: {
+        $schema: "http://json-schema.org/draft-07/schema#",
+        type: "object",
+        properties: {
+            name: { type: "string" },
+            enabled: { type: "boolean" },
+            webhookPath: { type: "string" },
+            sdkAppId: { type: "string" },
+            identifier: { type: "string" },
+            secretKey: { type: "string" },
+            botAccount: { type: "string" },
+            apiDomain: { type: "string" },
+            token: { type: "string" },
+            welcomeText: { type: "string" },
+            dm: dmSchema,
+            defaultAccount: { type: "string" },
+            accounts: {
+                type: "object",
+                additionalProperties: accountSchema,
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=config-schema.js.map

package/dist/src/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/config-schema.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;QAC9E,SAAS,EAAE;YACT,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;SAC3D;KACF;IACD,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,EAAE,EAAE,QAAQ;KACb;IACD,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,MAAM,EAAE;QACN,OAAO,EAAE,yCAAyC;QAClD,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC5B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,EAAE,EAAE,QAAQ;YACZ,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAClC,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,aAAa;aACpC;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

package/dist/src/debug/GenerateTestUserSig-es.js

@@ -0,0 +1,99 @@
+/* eslint-disable */
+import LibGenerateTestUserSig from './lib-generate-test-usersig-es.min.js';
+
+/**
+ * 腾讯云 SDKAppId，需要替换为您自己账号下的 SDKAppId。
+ *
+ * 进入腾讯云实时音视频[控制台](https://console.cloud.tencent.com/rav ) 创建应用，即可看到 SDKAppId，
+ * 它是腾讯云用于区分客户的唯一标识。
+ */
+const SDKAPPID = 0;
+
+
+/**
+ * 签名过期时间，建议不要设置的过短
+ * <p>
+ * 时间单位：秒
+ * 默认时间：7 x 24 x 60 x 60 = 604800 = 7 天
+ */
+const EXPIRETIME = 604800;
+
+
+/**
+ * 计算签名用的加密密钥，获取步骤如下：
+ *
+ * step1. 进入腾讯云实时音视频[控制台](https://console.cloud.tencent.com/rav )，如果还没有应用就创建一个，
+ * step2. 单击“应用配置”进入基础配置页面，并进一步找到“帐号体系集成”部分。
+ * step3. 点击“查看密钥”按钮，就可以看到计算 UserSig 使用的加密的密钥了，请将其拷贝并复制到如下的变量中
+ *
+ * 注意：该方案仅适用于调试Demo，正式上线前请将 UserSig 计算代码和密钥迁移到您的后台服务器上，以避免加密密钥泄露导致的流量盗用。
+ * 文档：https://cloud.tencent.com/document/product/647/17275#Server
+ */
+const SECRETKEY = '';
+
+/*
+ * Module:   GenerateTestUserSig
+ *
+ * Function: 用于生成测试用的 UserSig，UserSig 是腾讯云为其云服务设计的一种安全保护签名。
+ *           其计算方法是对 SDKAppID、UserID 和 EXPIRETIME 进行加密，加密算法为 HMAC-SHA256。
+ *
+ * Attention: 请不要将如下代码发布到您的线上正式版本的 App 中，原因如下：
+ *
+ *            本文件中的代码虽然能够正确计算出 UserSig，但仅适合快速调通 SDK 的基本功能，不适合线上产品，
+ *            这是因为客户端代码中的 SECRETKEY 很容易被反编译逆向破解，尤其是 Web 端的代码被破解的难度几乎为零。
+ *            一旦您的密钥泄露，攻击者就可以计算出正确的 UserSig 来盗用您的腾讯云流量。
+ *
+ *            正确的做法是将 UserSig 的计算代码和加密密钥放在您的业务服务器上，然后由 App 按需向您的服务器获取实时算出的 UserSig。
+ *            由于破解服务器的成本要高于破解客户端 App，所以服务器计算的方案能够更好地保护您的加密密钥。
+ *
+ * Reference：https://cloud.tencent.com/document/product/647/17275#Server
+ */
+
+/**
+ * 生成临时 UserSig，请不要将如下代码发布或者提交到您的代码仓库中。
+ *
+ * @param {{userID: string, SDKAppID: number, SecretKey: string, ExpireTime?: number}} options
+ * @param {string} options.userID - 用户名
+ * @param {string} options.SDKAppID：开发者在控制台注册的应用的 SDKAppID
+ * @param {string} options.SecretKey：开发者在控制台注册的应用的 SecretKey
+ * @param {number=} options.ExpireTime：签名过期时间，建议不要设置的过短，时间单位：秒，默认时间：7 x 24 x 60 x 60 = 604800 = 7 天
+ * 
+ * @returns {{userSig: string, SDKAppID: number}} result
+ * @returns {string} result.userSig：用户签名
+ * @returns {number} result.SDKAppID：SDKAppID
+ * 
+ * @example
+ * const { userSig } = genTestUserSig({ 
+ *  userID: "Alice", 
+ *  SDKAppID: 0, 
+ *  SecretKey: "YOUR_SECRETKEY" 
+ * });
+ */
+function genTestUserSig({ userID, SDKAppID, SecretKey, ExpireTime }) {
+  if (!userID) {
+    console.error("userID 参数缺失");
+    return;
+  }
+  if (!SDKAppID) {
+    console.error("SDKAppID 参数缺失");
+    return;
+  }
+  if (!SecretKey) {
+    console.error("SecretKey 参数缺失");
+    return;
+  }
+
+  const sdkAppID = SDKAppID || SDKAPPID;
+  const secretKey = SecretKey || SECRETKEY;
+  const expireTime = ExpireTime || EXPIRETIME;
+
+  const generator = new LibGenerateTestUserSig(sdkAppID, secretKey, expireTime);
+  const userSig = generator.genTestUserSig(userID);
+
+  return {
+    userSig,
+    SDKAppID: sdkAppID
+  };
+}
+
+export { genTestUserSig };