@zhin.js/adapter-qq 5.0.2 → 6.0.0

package/agent/tools/channel_info.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getQqAgentDeps } from '../../src/qq-agent-deps.js';
 
-export default defineTool<{ endpoint_id: string; channel_id: string }>({
+export default defineAgentTool<{ endpoint_id: string; channel_id: string }>({
   description: '获取 QQ 频道中指定子频道的详细信息',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/create_role.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getQqAgentDeps } from '../../src/qq-agent-deps.js';
 
-export default defineTool<{ endpoint_id: string; guild_id: string; name: string; color?: number }>({
+export default defineAgentTool<{ endpoint_id: string; guild_id: string; name: string; color?: number }>({
   description: '创建 QQ 频道角色',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/list_channels.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getQqAgentDeps } from '../../src/qq-agent-deps.js';
 
-export default defineTool<{ endpoint_id: string; guild_id: string }>({
+export default defineAgentTool<{ endpoint_id: string; guild_id: string }>({
   description: '获取 QQ 频道下的子频道列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/list_guilds.ts

@@ -1,8 +1,8 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getQqAgentDeps } from '../../src/qq-agent-deps.js';
 
-export default defineTool<{ endpoint_id: string }>({
+export default defineAgentTool<{ endpoint_id: string }>({
   description: '获取 QQ 频道列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/list_roles.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getQqAgentDeps } from '../../src/qq-agent-deps.js';
 
-export default defineTool<{ endpoint_id: string; guild_id: string }>({
+export default defineAgentTool<{ endpoint_id: string; guild_id: string }>({
   description: '获取 QQ 频道角色列表',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/member_detail.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getQqAgentDeps } from '../../src/qq-agent-deps.js';
 
-export default defineTool<{ endpoint_id: string; guild_id: string; user_id: string }>({
+export default defineAgentTool<{ endpoint_id: string; guild_id: string; user_id: string }>({
   description: '获取 QQ 频道中指定成员的详细信息',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/agent/tools/remove_role.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getQqAgentDeps } from '../../src/qq-agent-deps.js';
 
-export default defineTool<{ endpoint_id: string; guild_id: string; channel_id: string; user_id: string; role_id: string }>({
+export default defineAgentTool<{ endpoint_id: string; guild_id: string; channel_id: string; user_id: string; role_id: string }>({
   description: '移除成员的 QQ 频道角色',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/commands/endpoint/add/[name:string=].ts

@@ -0,0 +1,21 @@
+import { defineCommand } from '@zhin.js/command';
+import {
+  extractQqCommandReply,
+  isQqEndpointOperator,
+  QQ_ENDPOINT_FORBIDDEN,
+  runQqEndpointAdd,
+} from '../../../src/qq-endpoint-commands.js';
+import { qqRuntimeStateToken } from '../../../src/qq-runtime-state.js';
+
+export default defineCommand({
+  description: '手机 QQ 扫码绑定机器人，凭据写入 .env 并追加到 zhin.config.yml（重启生效）',
+  execute({ config, input, params, use }) {
+    if (!isQqEndpointOperator(config, input)) return QQ_ENDPOINT_FORBIDDEN;
+    const name = typeof params.name === 'string' && params.name.trim() ? params.name.trim() : undefined;
+    return runQqEndpointAdd(
+      use(qqRuntimeStateToken),
+      name,
+      extractQqCommandReply(input),
+    );
+  },
+});

package/commands/endpoint/cancel.ts

@@ -0,0 +1,15 @@
+import { defineCommand } from '@zhin.js/command';
+import {
+  isQqEndpointOperator,
+  QQ_ENDPOINT_FORBIDDEN,
+  runQqEndpointCancel,
+} from '../../src/qq-endpoint-commands.js';
+import { qqRuntimeStateToken } from '../../src/qq-runtime-state.js';
+
+export default defineCommand({
+  description: '取消进行中的 QQ 扫码绑定流程',
+  execute({ config, input, use }) {
+    if (!isQqEndpointOperator(config, input)) return QQ_ENDPOINT_FORBIDDEN;
+    return runQqEndpointCancel(use(qqRuntimeStateToken));
+  },
+});

package/commands/endpoint/list.ts

@@ -0,0 +1,10 @@
+import { defineCommand } from '@zhin.js/command';
+import { runQqEndpointList } from '../../src/qq-endpoint-commands.js';
+import { qqRuntimeStateToken } from '../../src/qq-runtime-state.js';
+
+export default defineCommand({
+  description: '列出 QQ endpoints（运行中 + zhin.config.yml 配置）',
+  execute({ use }) {
+    return runQqEndpointList(use(qqRuntimeStateToken));
+  },
+});

package/commands/endpoint/remove/[name:string].ts

@@ -0,0 +1,15 @@
+import { defineCommand } from '@zhin.js/command';
+import {
+  isQqEndpointOperator,
+  QQ_ENDPOINT_FORBIDDEN,
+  runQqEndpointRemove,
+} from '../../../src/qq-endpoint-commands.js';
+import { qqRuntimeStateToken } from '../../../src/qq-runtime-state.js';
+
+export default defineCommand({
+  description: '从 zhin.config.yml 的 plugins.qq.endpoints 移除指定 endpoint（重启生效）',
+  execute({ config, input, params, use }) {
+    if (!isQqEndpointOperator(config, input)) return QQ_ENDPOINT_FORBIDDEN;
+    return runQqEndpointRemove(use(qqRuntimeStateToken), String(params.name ?? ''));
+  },
+});

package/lib/endpoint.d.ts

@@ -0,0 +1,75 @@
+/**
+ * QQ endpoints — lifecycle, outbound, admit, agent tool surface.
+ */
+import type { EndpointInstance, EndpointManagement } from '@zhin.js/adapter';
+import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from '@zhin.js/plugin-runtime';
+import { type QqInboundMessage, type ResolvedQqHttpConfig, type ResolvedQqWebsocketConfig } from './protocol.js';
+import { type CreateQqHttpBot } from './webhook.js';
+import { type CreateQqBot } from './ws.js';
+export type { CreateQqBot, QqBotTransport } from './ws.js';
+export type { CreateQqHttpBot, QqHttpBotTransport } from './webhook.js';
+export interface QqEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly config: ResolvedQqWebsocketConfig;
+    readonly createBot?: CreateQqBot;
+}
+export declare class QqWebsocketEndpoint implements EndpointInstance {
+    #private;
+    readonly management: EndpointManagement;
+    constructor(options: QqEndpointOptions);
+    /** Live endpoint 名（Console/AdapterIndex 展示用，如 bot appid 别名）。 */
+    get name(): string;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
+    /** Test / internal: admit a message when open. */
+    admit(msg: QqInboundMessage): void;
+    getGuilds(): Promise<unknown[]>;
+    getChannels(guildId: string): Promise<unknown[]>;
+    getChannelInfo(channelId: string): Promise<unknown>;
+    getGuildMember(guildId: string, userId: string): Promise<unknown>;
+    getGuildRoles(guildId: string): Promise<unknown[]>;
+    createGuildRole(guildId: string, name: string, color?: number): Promise<unknown>;
+    addMemberRole(guildId: string, channelId: string, userId: string, roleId: string): Promise<boolean>;
+    removeMemberRole(guildId: string, channelId: string, userId: string, roleId: string): Promise<boolean>;
+}
+export interface QqHttpEndpointOptions {
+    readonly id: CapabilityId;
+    readonly gateway: MessageGateway;
+    readonly http: HttpHost;
+    readonly config: ResolvedQqHttpConfig;
+    readonly createBot?: CreateQqHttpBot;
+}
+/** Webhook / middleware inbound via httpHostToken POST (qq-official-bot Middleware receiver). */
+export declare class QqHttpEndpoint implements EndpointInstance {
+    #private;
+    readonly management: EndpointManagement;
+    constructor(options: QqHttpEndpointOptions);
+    /** Live endpoint 名（Console/AdapterIndex 展示用）。 */
+    get name(): string;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ target, payload }: {
+        readonly target: string;
+        readonly payload: unknown;
+    }): Promise<string>;
+    admit(msg: QqInboundMessage): void;
+    getGuilds(): Promise<unknown[]>;
+    getChannels(guildId: string): Promise<unknown[]>;
+    getChannelInfo(channelId: string): Promise<unknown>;
+    getGuildMember(guildId: string, userId: string): Promise<unknown>;
+    getGuildRoles(guildId: string): Promise<unknown[]>;
+    createGuildRole(guildId: string, name: string, color?: number): Promise<unknown>;
+    addMemberRole(guildId: string, channelId: string, userId: string, roleId: string): Promise<boolean>;
+    removeMemberRole(guildId: string, channelId: string, userId: string, roleId: string): Promise<boolean>;
+}

package/lib/endpoint.js

@@ -0,0 +1,358 @@
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import { registerQqAgentEndpoint } from './qq-agent-deps.js';
+import { formatInboundContent, formatInboundTarget, formatOutboundText, parseSendTarget, resolveOutboundMessageId, senderDisplayName, } from './protocol.js';
+import { defaultCreateHttpBot, registerQqWebhookRoutes, } from './webhook.js';
+import { bindQqBotInboundEvents, defaultCreateBot, normalizeQqMessage, } from './ws.js';
+const logger = getLogger('qq');
+export class QqWebsocketEndpoint {
+    #options;
+    #createBot;
+    #bot = null;
+    #open = false;
+    #started = false;
+    #unregisterAgent;
+    management = createQqEndpointManagement(this);
+    constructor(options) {
+        this.#options = options;
+        this.#createBot = options.createBot ?? defaultCreateBot;
+    }
+    /** Live endpoint 名（Console/AdapterIndex 展示用，如 bot appid 别名）。 */
+    get name() {
+        return this.#options.config.name;
+    }
+    async start() {
+        if (this.#started)
+            return;
+        this.#started = true;
+        try {
+            this.#unregisterAgent = registerQqAgentEndpoint(this.#options.config.name, this);
+            this.#bot = this.#createBot(this.#options.config);
+            this.#bindBot(this.#bot);
+            await this.#bot.start();
+            logger.info(formatCompact({
+                op: 'connect',
+                endpoint: this.#options.config.name,
+                mode: 'websocket',
+                appid: this.#options.config.appid,
+            }));
+        }
+        catch (error) {
+            await this.stop();
+            logger.error('Failed to connect QQ websocket:', error);
+            throw error;
+        }
+    }
+    open() {
+        this.#open = true;
+    }
+    close() {
+        this.#open = false;
+    }
+    async stop() {
+        this.#open = false;
+        this.#unregisterAgent?.();
+        this.#unregisterAgent = undefined;
+        if (this.#bot) {
+            try {
+                this.#bot.removeAllListeners();
+                await this.#bot.stop();
+            }
+            catch {
+                /* ignore */
+            }
+            this.#bot = null;
+        }
+        this.#started = false;
+        logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+    }
+    async send({ target, payload }) {
+        const body = formatOutboundText(payload);
+        const parsed = parseSendTarget(target);
+        const bot = this.#requireBot();
+        let result;
+        switch (parsed.kind) {
+            case 'private':
+                result = await bot.sendPrivateMessage(parsed.id, body);
+                break;
+            case 'group':
+                result = await bot.sendGroupMessage(parsed.id, body);
+                break;
+            case 'channel':
+                result = await bot.sendGuildMessage(parsed.id, body);
+                break;
+            case 'direct':
+                if (!bot.sendDirectMessage)
+                    throw new Error('QQ direct message not supported by transport');
+                result = await bot.sendDirectMessage(parsed.id, body);
+                break;
+            default:
+                throw new Error(`unsupported QQ target kind: ${String(parsed.kind)}`);
+        }
+        const messageId = `${parsed.kind}-${parsed.id}:${resolveOutboundMessageId(result)}`;
+        logger.debug(formatCompact({
+            op: 'qq_send',
+            endpoint: this.#options.config.name,
+            target,
+            messageId,
+        }));
+        return messageId;
+    }
+    /** Test / internal: admit a message when open. */
+    admit(msg) {
+        if (!this.#open)
+            return;
+        const target = formatInboundTarget(msg);
+        void this.#options.gateway.receive({
+            adapter: this.#options.id,
+            target,
+            content: formatInboundContent(msg),
+            sender: senderDisplayName(msg),
+            id: msg.id,
+            metadata: Object.freeze({
+                endpoint: this.#options.config.name,
+                channelKind: msg.channelKind,
+                userId: msg.authorId,
+                guildId: msg.guildId,
+                roles: msg.authorRoles,
+                // AT 事件本身即 @ 机器人；新 Runtime 纯文本 content 需经 metadata 传递
+                ...(msg.mentioned ? { mentioned: true } : {}),
+            }),
+        }).catch((err) => {
+            logger.warn(formatCompact({
+                op: 'qq_gateway_receive_failed',
+                target,
+                error: err instanceof Error ? err.message : String(err),
+            }));
+        });
+    }
+    getGuilds() {
+        return this.#requireBot().getGuilds();
+    }
+    getChannels(guildId) {
+        return this.#requireBot().getChannels(guildId);
+    }
+    getChannelInfo(channelId) {
+        return this.#requireBot().getChannelInfo(channelId);
+    }
+    getGuildMember(guildId, userId) {
+        return this.#requireBot().getGuildMember(guildId, userId);
+    }
+    getGuildRoles(guildId) {
+        return this.#requireBot().getGuildRoles(guildId);
+    }
+    createGuildRole(guildId, name, color) {
+        return this.#requireBot().createGuildRole(guildId, name, color);
+    }
+    addMemberRole(guildId, channelId, userId, roleId) {
+        return this.#requireBot().addMemberRole(guildId, channelId, userId, roleId);
+    }
+    removeMemberRole(guildId, channelId, userId, roleId) {
+        return this.#requireBot().removeMemberRole(guildId, channelId, userId, roleId);
+    }
+    #bindBot(bot) {
+        bindQqBotInboundEvents(bot, (raw) => {
+            const msg = normalizeQqMessage(raw);
+            if (msg)
+                this.admit(msg);
+        });
+    }
+    #requireBot() {
+        if (!this.#bot)
+            throw new Error('QQ bot not connected');
+        return this.#bot;
+    }
+}
+/** Webhook / middleware inbound via httpHostToken POST (qq-official-bot Middleware receiver). */
+export class QqHttpEndpoint {
+    #options;
+    #createBot;
+    #bot = null;
+    #routeReleases = [];
+    #open = false;
+    #started = false;
+    #unregisterAgent;
+    management = createQqEndpointManagement(this);
+    constructor(options) {
+        this.#options = options;
+        this.#createBot = options.createBot ?? defaultCreateHttpBot;
+    }
+    /** Live endpoint 名（Console/AdapterIndex 展示用）。 */
+    get name() {
+        return this.#options.config.name;
+    }
+    async start() {
+        if (this.#started)
+            return;
+        this.#started = true;
+        try {
+            this.#unregisterAgent = registerQqAgentEndpoint(this.#options.config.name, this);
+            this.#setupRoutes();
+            this.#bot = this.#createBot(this.#options.config);
+            this.#bindBot(this.#bot);
+            await this.#bot.start();
+            logger.info(formatCompact({
+                op: 'connect',
+                endpoint: this.#options.config.name,
+                mode: this.#options.config.mode,
+                path: this.#options.config.webhookPath,
+            }));
+        }
+        catch (error) {
+            await this.stop();
+            logger.error('Failed to connect QQ HTTP receiver:', error);
+            throw error;
+        }
+    }
+    open() {
+        this.#open = true;
+    }
+    close() {
+        this.#open = false;
+    }
+    async stop() {
+        this.#open = false;
+        for (const release of this.#routeReleases.splice(0))
+            release();
+        this.#unregisterAgent?.();
+        this.#unregisterAgent = undefined;
+        if (this.#bot) {
+            try {
+                this.#bot.removeAllListeners();
+                await this.#bot.stop();
+            }
+            catch {
+                /* ignore */
+            }
+            this.#bot = null;
+        }
+        this.#started = false;
+        logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+    }
+    async send({ target, payload }) {
+        const body = formatOutboundText(payload);
+        const parsed = parseSendTarget(target);
+        const bot = this.#requireBot();
+        let result;
+        switch (parsed.kind) {
+            case 'private':
+                result = await bot.sendPrivateMessage(parsed.id, body);
+                break;
+            case 'group':
+                result = await bot.sendGroupMessage(parsed.id, body);
+                break;
+            case 'channel':
+                result = await bot.sendGuildMessage(parsed.id, body);
+                break;
+            case 'direct':
+                if (!bot.sendDirectMessage)
+                    throw new Error('QQ direct message not supported by transport');
+                result = await bot.sendDirectMessage(parsed.id, body);
+                break;
+            default:
+                throw new Error(`unsupported QQ target kind: ${String(parsed.kind)}`);
+        }
+        return `${parsed.kind}-${parsed.id}:${resolveOutboundMessageId(result)}`;
+    }
+    admit(msg) {
+        if (!this.#open)
+            return;
+        const target = formatInboundTarget(msg);
+        void this.#options.gateway.receive({
+            adapter: this.#options.id,
+            target,
+            content: formatInboundContent(msg),
+            sender: senderDisplayName(msg),
+            id: msg.id,
+            metadata: Object.freeze({
+                endpoint: this.#options.config.name,
+                channelKind: msg.channelKind,
+                userId: msg.authorId,
+                guildId: msg.guildId,
+                roles: msg.authorRoles,
+                // AT 事件本身即 @ 机器人；新 Runtime 纯文本 content 需经 metadata 传递
+                ...(msg.mentioned ? { mentioned: true } : {}),
+            }),
+        }).catch((err) => {
+            logger.warn(formatCompact({
+                op: 'qq_gateway_receive_failed',
+                target,
+                error: err instanceof Error ? err.message : String(err),
+            }));
+        });
+    }
+    getGuilds() {
+        return this.#requireBot().getGuilds();
+    }
+    getChannels(guildId) {
+        return this.#requireBot().getChannels(guildId);
+    }
+    getChannelInfo(channelId) {
+        return this.#requireBot().getChannelInfo(channelId);
+    }
+    getGuildMember(guildId, userId) {
+        return this.#requireBot().getGuildMember(guildId, userId);
+    }
+    getGuildRoles(guildId) {
+        return this.#requireBot().getGuildRoles(guildId);
+    }
+    createGuildRole(guildId, name, color) {
+        return this.#requireBot().createGuildRole(guildId, name, color);
+    }
+    addMemberRole(guildId, channelId, userId, roleId) {
+        return this.#requireBot().addMemberRole(guildId, channelId, userId, roleId);
+    }
+    removeMemberRole(guildId, channelId, userId, roleId) {
+        return this.#requireBot().removeMemberRole(guildId, channelId, userId, roleId);
+    }
+    #setupRoutes() {
+        this.#routeReleases.push(...registerQqWebhookRoutes(this.#options.http, {
+            config: this.#options.config,
+            getBot: () => this.#bot,
+        }));
+    }
+    #bindBot(bot) {
+        bindQqBotInboundEvents(bot, (raw) => {
+            const msg = normalizeQqMessage(raw);
+            if (msg)
+                this.admit(msg);
+        });
+    }
+    #requireBot() {
+        if (!this.#bot)
+            throw new Error('QQ bot not connected');
+        return this.#bot;
+    }
+}
+function createQqEndpointManagement(endpoint) {
+    return Object.freeze({
+        async listChannels() {
+            const channels = [];
+            const guilds = await endpoint.getGuilds();
+            for (const guildValue of Array.isArray(guilds) ? guilds : []) {
+                const guild = asRecord(guildValue);
+                const guildId = String(guild.id ?? guild.guild_id ?? guildValue ?? '');
+                if (!guildId)
+                    continue;
+                const guildName = String(guild.name ?? guild.guild_name ?? guildId);
+                const rows = await endpoint.getChannels(guildId);
+                for (const channelValue of Array.isArray(rows) ? rows : []) {
+                    const channel = asRecord(channelValue);
+                    const id = String(channel.id ?? channel.channel_id ?? channelValue ?? '');
+                    if (!id)
+                        continue;
+                    channels.push({
+                        id,
+                        name: String(channel.name ?? channel.channel_name ?? id),
+                        parent: { type: 'guild', id: guildId, name: guildName },
+                    });
+                }
+            }
+            return channels;
+        },
+    });
+}
+function asRecord(value) {
+    return value !== null && typeof value === 'object'
+        ? value
+        : {};
+}

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+export { formatInboundContent, formatInboundTarget, formatOutboundText, parseSendTarget, resolveOutboundMessageId, resolveQqConfig, senderDisplayName, type ParsedSendTarget, type QqAdapterConfig, type QqChannelKind, type QqInboundMessage, type QqWireSegment, type ResolvedQqConfig, type ResolvedQqHttpConfig, type ResolvedQqWebsocketConfig, } from './protocol.js';
+export { QqHttpEndpoint, QqWebsocketEndpoint, type CreateQqBot, type CreateQqHttpBot, type QqBotTransport, type QqEndpointOptions, type QqHttpBotTransport, type QqHttpEndpointOptions, } from './endpoint.js';
+export { registerQqWebhookRoutes, handleQqWebhookRequest, readRequestBodyText, defaultCreateHttpBot, type QqWebhookHandler, } from './webhook.js';
+export { bindQqBotInboundEvents, defaultCreateBot, normalizeQqMessage, } from './ws.js';
+export { getQqAgentDeps, registerQqAgentEndpoint, setQqAgentDeps, type QqAgentDeps, type QqAgentEndpoint, } from './qq-agent-deps.js';
+export { checkQqPlatformPermit, normalizeQqGuildSenderForPermit, platformPermit, qqGuildPermitResolver, registerQqPlatformPermitChecker, } from './platform-permit.js';

package/lib/index.js

@@ -0,0 +1,6 @@
+export { formatInboundContent, formatInboundTarget, formatOutboundText, parseSendTarget, resolveOutboundMessageId, resolveQqConfig, senderDisplayName, } from './protocol.js';
+export { QqHttpEndpoint, QqWebsocketEndpoint, } from './endpoint.js';
+export { registerQqWebhookRoutes, handleQqWebhookRequest, readRequestBodyText, defaultCreateHttpBot, } from './webhook.js';
+export { bindQqBotInboundEvents, defaultCreateBot, normalizeQqMessage, } from './ws.js';
+export { getQqAgentDeps, registerQqAgentEndpoint, setQqAgentDeps, } from './qq-agent-deps.js';
+export { checkQqPlatformPermit, normalizeQqGuildSenderForPermit, platformPermit, qqGuildPermitResolver, registerQqPlatformPermitChecker, } from './platform-permit.js';

package/lib/platform-permit.d.ts

@@ -0,0 +1,16 @@
+/**
+ * QQ 官方频道 platform permit（guild/channel，非 QQ 群 group_*）
+ */
+import { type Message } from '@zhin.js/core';
+export declare function platformPermit(perm: string): string;
+export declare function qqGuildPermitResolver(logicalPerm: string): string;
+export declare function normalizeQqGuildSenderForPermit(input: {
+    roles?: string[];
+    isOwner?: boolean;
+    isAdmin?: boolean;
+}): {
+    role?: string;
+    permissions?: string[];
+};
+export declare function checkQqPlatformPermit(perm: string, message: Message<any>): boolean;
+export declare function registerQqPlatformPermitChecker(): () => void;

package/lib/{src/platform-permit.js → platform-permit.js}

@@ -1,7 +1,7 @@
 /**
  * QQ 官方频道 platform permit（guild/channel，非 QQ 群 group_*）
  */
-import { registerPlatformPermitChecker } from 'zhin.js';
+import { registerPlatformPermitChecker } from '@zhin.js/core';
 const ADAPTER = 'qq';
 export function platformPermit(perm) {
     return `platform(${ADAPTER},${perm})`;
@@ -47,4 +47,3 @@ export function checkQqPlatformPermit(perm, message) {
 export function registerQqPlatformPermitChecker() {
     return registerPlatformPermitChecker(ADAPTER, checkQqPlatformPermit);
 }
-//# sourceMappingURL=platform-permit.js.map