@onlyne/im-qq 3.1.0 → 3.2.0

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,303 @@
+/**
+ * The QQ official Bot OpenAPI v2 connector. Inbound events arrive either on the platform's
+ * WebSocket gateway (the default, owned by `gateway.ts`) or on the signed HTTP callback the host
+ * hands to `handleWebhook`; every outbound platform call goes through the injected port either way.
+ */
+import { readFile as nodeReadFile } from 'node:fs/promises';
+import { OnlyneError } from '@onlyne/lib';
+import { resolveCredential } from '@onlyne/im-core';
+import { createQqPort, messagePath } from './port.js';
+import { normalizeEvent } from './normalize.js';
+import { createSendState, outcomeOf, parseConversation, sendMessage } from './send.js';
+import { challenge, verifyHex } from './webhook.js';
+import { createQqGateway } from './gateway.js';
+export { createQqPort, messagePath, QqPortError, } from './port.js';
+export { normalizeEvent } from './normalize.js';
+export { challenge, deriveEd25519, signHex, verifyHex } from './webhook.js';
+export { createSendState, parseConversation, sendMessage } from './send.js';
+export { createQqGateway, QQ_INTENTS, } from './gateway.js';
+export const QQ_CREDENTIAL_VARIABLES = ['QQ_BOT_APP_ID', 'QQ_BOT_APP_SECRET'];
+/** Platform operations the connector implements beyond `send`; a resource lists them. */
+export const QQ_OPERATIONS = ['recall', 'typing'];
+/** QQ signs every dispatch over its timestamp; a callback older than this is a replay. */
+const SIGNATURE_WINDOW_MS = 5 * 60 * 1000;
+/** What QQ's `input_notify` shows the user; the platform caps the hint at 60 seconds. */
+const TYPING_SECONDS = 60;
+function recordOf(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+export function createQqConnector(options = {}) {
+    const now = options.now ?? Date.now;
+    const log = options.log ?? (() => { });
+    const transport = options.transport ?? 'websocket';
+    const listeners = [];
+    /** One chain per conversation: the endpoint's `receive` calls land in arrival order. */
+    const queues = new Map();
+    const sendState = createSendState();
+    let port;
+    let gateway;
+    let lifecycle = 'onboarding';
+    let onboarding;
+    let failure;
+    let lastEventAt;
+    let appId;
+    let appSecret;
+    /** The credential resolved and the token was proven: outbound calls can go. */
+    let ready = false;
+    function emit(event) {
+        const previous = queues.get(event.conversation) ?? Promise.resolve();
+        const run = previous.then(async () => {
+            for (const listener of listeners)
+                await listener(event);
+        });
+        // The chain survives a failing listener so the next event in this conversation still runs;
+        // the caller keeps the rejection and answers the platform with a retryable status.
+        const settled = run.catch(() => { });
+        queues.set(event.conversation, settled);
+        void settled.then(() => {
+            if (queues.get(event.conversation) === settled)
+                queues.delete(event.conversation);
+        });
+        return run;
+    }
+    function refuse(code, message, status) {
+        return Response.json({ error: { code, message } }, { status });
+    }
+    function credentialFields(problem) {
+        const env = options.env ?? process.env;
+        // A configured file that could not be read: the resolve problem is the real fix, not the pair.
+        if (options.credentialFile !== undefined)
+            return [problem ?? `Provide ${QQ_CREDENTIAL_VARIABLES.join(' + ')}.`];
+        const missing = QQ_CREDENTIAL_VARIABLES.filter(name => (env[name] ?? '').length === 0);
+        return missing.length > 0 ? missing : [problem ?? `Provide ${QQ_CREDENTIAL_VARIABLES.join(' + ')}.`];
+    }
+    return {
+        platform: 'qq',
+        operations: QQ_OPERATIONS,
+        async start() {
+            lifecycle = 'connecting';
+            const credential = await resolveCredential({ value: options.credential, file: options.credentialFile, variables: [...QQ_CREDENTIAL_VARIABLES] }, options.readFile ?? (path => nodeReadFile(path, 'utf8')), options.env ?? process.env);
+            if (credential.value === undefined) {
+                // A missing credential is a state, not a failure: the host renders the fields to provide.
+                lifecycle = 'onboarding';
+                onboarding = credentialFields(credential.problem);
+                failure = undefined;
+                log('qq connector is onboarding', { onboarding });
+                return;
+            }
+            const separator = credential.value.indexOf(':');
+            if (separator <= 0 || separator === credential.value.length - 1) {
+                lifecycle = 'error';
+                failure = 'The QQ credential is appId:appSecret.';
+                onboarding = [...QQ_CREDENTIAL_VARIABLES];
+                log('qq connector rejected the credential shape', { error: failure });
+                return;
+            }
+            appId = credential.value.slice(0, separator);
+            appSecret = credential.value.slice(separator + 1);
+            port = options.port ?? createQqPort({
+                appId,
+                appSecret,
+                ...(options.now === undefined ? {} : { now: options.now }),
+            });
+            try {
+                await port.start();
+                // Fetching the token proves the pair: QQ answers a bad secret here and nowhere earlier.
+                await port.token();
+                ready = true;
+                onboarding = undefined;
+                failure = undefined;
+                if (transport === 'webhook') {
+                    lifecycle = 'connected';
+                    log('qq connector is connected', {
+                        app_id: appId,
+                        transport,
+                        webhook_path: options.webhookPath ?? 'unset',
+                    });
+                    return;
+                }
+                gateway = createQqGateway({
+                    port,
+                    log,
+                    now,
+                    ...(options.onState === undefined ? {} : { onState: options.onState }),
+                    ...(options.gateway ?? {}),
+                });
+                // Not awaited to a socket: a gateway that cannot reach QQ stays a retrying state, and
+                // the host's status panel shows it, instead of a failed start.
+                await gateway.start({
+                    dispatch: async (payload) => {
+                        const event = normalizeEvent(payload, now);
+                        if (event === undefined)
+                            return;
+                        // A rejection leaves the sequence number where it was: the platform replays the event.
+                        await emit(event);
+                        log('qq.dispatch', {
+                            conversation: event.conversation, source_id: event.source_id, kind: event.kind,
+                            ...(typeof payload.t === 'string' ? { type: payload.t } : {}),
+                            ...(typeof payload.s === 'number' ? { seq: payload.s } : {}),
+                        });
+                        lastEventAt = event.at;
+                    },
+                });
+                lifecycle = 'connecting';
+                log('qq connector is dialing the gateway', { app_id: appId, transport });
+            }
+            catch (error) {
+                ready = false;
+                lifecycle = 'error';
+                failure = error instanceof Error ? error.message : String(error);
+                log('qq connector could not authenticate', { error: failure });
+            }
+        },
+        onEvent(listener) {
+            listeners.push(listener);
+        },
+        async send(request) {
+            if (port === undefined || !ready) {
+                const hint = onboarding === undefined ? '' : `; provide ${onboarding.join(', ')}`;
+                return { state: 'unknown', error: `The QQ connector is not connected${hint}.` };
+            }
+            return sendMessage(port, request, sendState);
+        },
+        validate(operation, data) {
+            if (!QQ_OPERATIONS.includes(operation)) {
+                throw new OnlyneError('invalid_request', `The QQ connector does not implement ${operation}.`);
+            }
+            const raw = recordOf(data) ?? {};
+            if (operation === 'recall' && (typeof raw.message_id !== 'string' || raw.message_id.length === 0)) {
+                throw new OnlyneError('invalid_request', 'recall names message_id.');
+            }
+            if (typeof raw.conversation !== 'string' || raw.conversation.length === 0) {
+                throw new OnlyneError('invalid_request', `${operation} names conversation.`);
+            }
+        },
+        async operate(operation, data) {
+            if (port === undefined || !ready) {
+                return { state: 'unknown', error: 'The QQ connector is not connected.' };
+            }
+            const raw = recordOf(data) ?? {};
+            const conversation = typeof raw.conversation === 'string' ? raw.conversation : '';
+            const target = parseConversation(conversation);
+            if (target === undefined) {
+                return {
+                    state: 'unknown',
+                    error: `The QQ connector addresses c2c:<openid> or group:<openid>, not ${conversation}.`,
+                };
+            }
+            try {
+                if (operation === 'recall') {
+                    await port.request('DELETE', messagePath(target, String(raw.message_id)));
+                    return { state: 'committed' };
+                }
+                if (operation === 'typing') {
+                    if (target.kind === 'group')
+                        return { state: 'unknown', error: 'QQ typing is c2c only.' };
+                    const body = { msg_type: 6, input_notify: { input_type: 1, input_second: TYPING_SECONDS } };
+                    await port.send(target, body);
+                    return { state: 'committed' };
+                }
+                return { state: 'unknown', error: `The QQ connector does not implement ${operation}.` };
+            }
+            catch (error) {
+                return outcomeOf(error, 'operation');
+            }
+        },
+        async handleWebhook(request) {
+            if (request.method !== 'POST') {
+                return refuse('method_not_allowed', 'The QQ webhook accepts POST only.', 405);
+            }
+            const rawBody = await request.text();
+            let payload;
+            try {
+                payload = JSON.parse(rawBody);
+            }
+            catch {
+                return refuse('invalid_request', 'The QQ webhook body is not JSON.', 400);
+            }
+            const envelope = recordOf(payload);
+            if (envelope === undefined) {
+                return refuse('invalid_request', 'The QQ webhook body is not an object.', 400);
+            }
+            if (appSecret === undefined) {
+                return refuse('unavailable', 'The QQ connector has no credential, so a callback cannot be validated.', 503);
+            }
+            if (envelope.op === 13) {
+                const claimed = request.headers.get('x-bot-appid');
+                if (claimed !== null && appId !== undefined && claimed !== appId) {
+                    return refuse('unauthenticated', 'X-Bot-Appid does not match the configured app id.', 401);
+                }
+                const answer = challenge(appSecret, rawBody);
+                if (answer === undefined) {
+                    return refuse('invalid_request', 'The validation callback names plain_token and event_ts.', 400);
+                }
+                return Response.json(answer);
+            }
+            if (envelope.op === 0) {
+                const timestamp = request.headers.get('x-signature-timestamp');
+                const signature = request.headers.get('x-signature-ed25519');
+                if (timestamp === null || signature === null) {
+                    return refuse('unauthenticated', 'The QQ dispatch carries no signature headers.', 401);
+                }
+                const stamp = Number(timestamp);
+                if (!Number.isFinite(stamp) || Math.abs(now() - stamp * 1000) > SIGNATURE_WINDOW_MS) {
+                    return refuse('unauthenticated', 'The QQ dispatch timestamp is outside the five-minute window.', 401);
+                }
+                if (!verifyHex(appSecret, `${timestamp}${rawBody}`, signature)) {
+                    return refuse('unauthenticated', 'The QQ dispatch signature does not verify.', 401);
+                }
+                const event = normalizeEvent(payload, now);
+                if (event !== undefined) {
+                    try {
+                        await emit(event);
+                    }
+                    catch (error) {
+                        const detail = error instanceof Error ? error.message : String(error);
+                        // Never ack a batch whose durable receive failed: QQ retries a non-2xx answer.
+                        log('qq inbound listener failed', { source_id: event.source_id, error: detail });
+                        return refuse('unavailable', `The inbound event was not stored: ${detail}`, 500);
+                    }
+                    log('qq.dispatch', {
+                        conversation: event.conversation, source_id: event.source_id, kind: event.kind,
+                        ...(typeof envelope.t === 'string' ? { type: envelope.t } : {}),
+                    });
+                    lastEventAt = event.at;
+                }
+                return Response.json({ op: 12 });
+            }
+            // Heartbeats and anything newer than this connector knows: acknowledged, not translated.
+            return Response.json({ op: 12 });
+        },
+        status() {
+            const observed = gateway?.status();
+            return {
+                state: observed?.state ?? lifecycle,
+                connected: observed === undefined ? lifecycle === 'connected' : observed.state === 'online',
+                reconnects: observed?.reconnects ?? 0,
+                rate_limits: port?.status().rate_limits ?? 0,
+                transport,
+                ...(lastEventAt === undefined ? {} : { last_event_at: lastEventAt }),
+                ...(onboarding === undefined || onboarding.length === 0 ? {} : { onboarding }),
+                ...(failure === undefined ? {} : { error: failure }),
+                ...(observed === undefined ? {} : {
+                    heartbeat_timeouts: observed.heartbeat_timeouts,
+                    resumes: observed.resumes,
+                    resume_failures: observed.resume_failures,
+                    shards: observed.shards,
+                }),
+            };
+        },
+        async stop() {
+            listeners.length = 0;
+            queues.clear();
+            await gateway?.stop();
+            gateway = undefined;
+            await port?.stop();
+            ready = false;
+            lifecycle = 'stopped';
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/normalize.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The QQ event envelope, translated into one `ImEvent`. Pure: no clock beyond the injected one,
+ * no network, no state — the same payload always normalizes the same way.
+ *
+ * Envelope: `{id, op, d, s, t}`. `op 0` is a dispatch and `t` names the event; anything else
+ * (heartbeat, callback validation) is not an inbound event.
+ */
+import type { ImEvent } from '@onlyne/im-core';
+/** One `op 0` dispatch; `undefined` for an event this connector does not translate. */
+export declare function normalizeEvent(payload: unknown, now?: () => number): ImEvent | undefined;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAgB,OAAO,EAAW,MAAM,iBAAiB,CAAC;AA2LtE,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,OAAO,GAAG,SAAS,CAUlG"}

package/dist/normalize.js

@@ -0,0 +1,211 @@
+/**
+ * The QQ event envelope, translated into one `ImEvent`. Pure: no clock beyond the injected one,
+ * no network, no state — the same payload always normalizes the same way.
+ *
+ * Envelope: `{id, op, d, s, t}`. `op 0` is a dispatch and `t` names the event; anything else
+ * (heartbeat, callback validation) is not an inbound event.
+ */
+const PLATFORM = 'qq';
+const MESSAGE_EVENTS = {
+    C2C_MESSAGE_CREATE: true,
+    GROUP_AT_MESSAGE_CREATE: true,
+};
+const LIFECYCLE_EVENTS = {
+    GROUP_ADD_ROBOT: true,
+    GROUP_DEL_ROBOT: true,
+    FRIEND_ADD: true,
+    FRIEND_DEL: true,
+    C2C_MSG_RECEIVE: true,
+    C2C_MSG_REJECT: true,
+    GROUP_MSG_RECEIVE: true,
+    GROUP_MSG_REJECT: true,
+};
+function recordOf(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function textOf(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function senderOf(d) {
+    const author = recordOf(d.author);
+    return textOf(author?.user_openid) ?? textOf(author?.id)
+        ?? textOf(d.openid) ?? textOf(d.op_member_openid) ?? textOf(d.user_openid);
+}
+/**
+ * `group:<group_openid>` when the event names a group, else `c2c:<openid>`. A c2c message keeps
+ * its openid under `author`, not at the top level.
+ */
+function conversationOf(d) {
+    const group = textOf(d.group_openid);
+    if (group !== undefined)
+        return `group:${group}`;
+    const user = senderOf(d);
+    return user === undefined ? undefined : `c2c:${user}`;
+}
+/** `message_scene.ext` carries `msg_idx=REFIDX_…` for this message and `ref_msg_idx=…` for the quote. */
+function sceneIndexes(d) {
+    const ext = recordOf(d.message_scene)?.ext;
+    const indexes = {};
+    if (!Array.isArray(ext))
+        return indexes;
+    for (const entry of ext) {
+        if (typeof entry !== 'string')
+            continue;
+        const separator = entry.indexOf('=');
+        if (separator <= 0)
+            continue;
+        const name = entry.slice(0, separator);
+        const value = entry.slice(separator + 1);
+        if (value.length === 0)
+            continue;
+        if (name === 'msg_idx')
+            indexes.self = value;
+        else if (name === 'ref_msg_idx')
+            indexes.quoted = value;
+    }
+    return indexes;
+}
+function attachmentsOf(d) {
+    if (!Array.isArray(d.attachments))
+        return [];
+    const attachments = [];
+    for (const entry of d.attachments) {
+        const item = recordOf(entry);
+        if (item === undefined)
+            continue;
+        const contentType = (textOf(item.content_type) ?? '').toLowerCase();
+        const kind = contentType.startsWith('image/')
+            ? 'image'
+            : contentType === 'voice' || contentType.startsWith('audio/')
+                ? 'audio'
+                : contentType.startsWith('video/')
+                    ? 'video'
+                    : 'file';
+        const url = textOf(item.url);
+        // A voice attachment arrives as SILK; the WAV url is the one a player can open.
+        const handle = kind === 'audio' ? textOf(item.voice_wav_url) ?? url : url ?? textOf(item.voice_wav_url);
+        if (handle === undefined)
+            continue;
+        const filename = textOf(item.filename);
+        attachments.push({ kind, platform_handle: handle, ...(filename === undefined ? {} : { alt: filename }) });
+    }
+    return attachments;
+}
+/** The first voice attachment's server-side transcript, when the platform produced one. */
+function transcriptOf(d) {
+    if (!Array.isArray(d.attachments))
+        return undefined;
+    for (const entry of d.attachments) {
+        const item = recordOf(entry);
+        if (item === undefined)
+            continue;
+        const contentType = (textOf(item.content_type) ?? '').toLowerCase();
+        if (contentType !== 'voice' && !contentType.startsWith('audio/'))
+            continue;
+        const transcript = textOf(item.asr_refer_text);
+        if (transcript !== undefined)
+            return transcript;
+    }
+    return undefined;
+}
+/** `msg_elements[0].content` of a quote reply: the platform inlines the quoted body there. */
+function quotedTextOf(d) {
+    if (!Array.isArray(d.msg_elements))
+        return undefined;
+    const first = recordOf(d.msg_elements[0]);
+    return textOf(first?.content);
+}
+function messageEvent(d, envelope, now) {
+    const conversation = conversationOf(d);
+    const messageId = textOf(d.id);
+    if (conversation === undefined || messageId === undefined)
+        return undefined;
+    const messageType = typeof d.message_type === 'number' ? d.message_type : undefined;
+    const indexes = sceneIndexes(d);
+    const quotedText = messageType === 103 ? quotedTextOf(d) : undefined;
+    const attachments = attachmentsOf(d);
+    const content = textOf(d.content);
+    const arkPrompt = textOf(recordOf(d.ark_data)?.prompt);
+    const text = content
+        ?? (quotedText ?? arkPrompt)
+        ?? transcriptOf(d)
+        ?? '';
+    const replyParts = {};
+    if (indexes.quoted !== undefined)
+        replyParts.parent = indexes.quoted;
+    if (quotedText !== undefined)
+        replyParts.quoted_text = quotedText;
+    const sender = senderOf(d);
+    return {
+        platform: PLATFORM,
+        source_id: messageId,
+        conversation,
+        kind: 'message',
+        ...(sender === undefined ? {} : { from: sender }),
+        text,
+        attachments,
+        ...(Object.keys(replyParts).length === 0 ? {} : { reply: replyParts }),
+        message_handle: messageId,
+        // The passive reply id and the quote index are two ids for one message; the bridge hands the
+        // composite back as `reply_to` and `send` splits it again.
+        ref_handle: indexes.self === undefined ? messageId : `${messageId}|${indexes.self}`,
+        at: textOf(d.timestamp) ?? new Date(now()).toISOString(),
+        raw: envelope,
+    };
+}
+function interactionEvent(d, envelope, now) {
+    const id = textOf(d.id);
+    const conversation = conversationOf(d);
+    if (id === undefined || conversation === undefined)
+        return undefined;
+    const sender = senderOf(d);
+    return {
+        platform: PLATFORM,
+        source_id: id,
+        conversation,
+        kind: 'action',
+        ...(sender === undefined ? {} : { from: sender }),
+        text: '',
+        attachments: [],
+        action: { id, ...(d.data === undefined ? {} : { value: d.data }) },
+        at: textOf(d.timestamp) ?? new Date(now()).toISOString(),
+        raw: envelope,
+    };
+}
+function lifecycleEvent(type, d, envelope, now) {
+    const sourceId = textOf(envelope.id) ?? textOf(d.id);
+    const conversation = conversationOf(d);
+    if (sourceId === undefined || conversation === undefined)
+        return undefined;
+    const sender = senderOf(d);
+    return {
+        platform: PLATFORM,
+        source_id: sourceId,
+        conversation,
+        kind: 'event',
+        ...(sender === undefined ? {} : { from: sender }),
+        text: '',
+        attachments: [],
+        event: { type },
+        at: textOf(d.timestamp) ?? new Date(now()).toISOString(),
+        raw: envelope,
+    };
+}
+/** One `op 0` dispatch; `undefined` for an event this connector does not translate. */
+export function normalizeEvent(payload, now = Date.now) {
+    const envelope = recordOf(payload);
+    if (envelope === undefined || envelope.op !== 0)
+        return undefined;
+    const type = textOf(envelope.t);
+    const d = recordOf(envelope.d);
+    if (type === undefined || d === undefined)
+        return undefined;
+    if (MESSAGE_EVENTS[type] === true)
+        return messageEvent(d, envelope, now);
+    if (type === 'INTERACTION_CREATE')
+        return interactionEvent(d, envelope, now);
+    if (LIFECYCLE_EVENTS[type] === true)
+        return lifecycleEvent(type, d, envelope, now);
+    return undefined;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/port.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The HTTP boundary: every platform call the connector makes goes through this port, so the
+ * translation logic runs against a fake in tests and the real QQ OpenAPI in production. The only
+ * injected seams are `fetch` and `now`.
+ */
+export declare const QQ_API_BASE = "https://api.bot.qq.com";
+export interface QqHttpRequest {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}
+export interface QqHttpResponse {
+    readonly status: number;
+    text(): Promise<string>;
+}
+export type QqFetch = (url: string, init: QqHttpRequest) => Promise<QqHttpResponse>;
+export interface QqPortErrorInit {
+    /** The HTTP status; `0` when the request never reached the platform. */
+    status: number;
+    /** The platform's own error code, when its body carried one. */
+    code?: string | number;
+    /** The platform's own error text, verbatim. */
+    detail?: string;
+}
+/** A platform refusal or a transport failure, with what the platform said kept apart from the summary. */
+export declare class QqPortError extends Error {
+    readonly status: number;
+    readonly code?: string | number;
+    readonly detail?: string;
+    constructor(message: string, init: QqPortErrorInit);
+}
+/** A QQ conversation coordinate as the platform addresses it. */
+export interface QqSendTarget {
+    kind: 'c2c' | 'group';
+    openid: string;
+}
+/** The message body QQ v2 accepts; the connector fills only what it sends. */
+export interface QqMessageBody {
+    msg_type: number;
+    content?: string;
+    markdown?: {
+        content: string;
+    };
+    /** The passive reply id from the inbound event. */
+    msg_id?: string;
+    msg_seq?: number;
+    message_reference?: {
+        message_id: string;
+    };
+    input_notify?: {
+        input_type: 1;
+        input_second: number;
+    };
+}
+export interface QqSendResult {
+    id?: string;
+    timestamp?: string;
+    ext_info?: {
+        ref_idx?: string;
+    };
+}
+export interface QqPortStatus {
+    state: string;
+    connected: boolean;
+    rate_limits: number;
+}
+export interface QqPort {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** The access token, fetched on demand and cached until shortly before it expires. */
+    token(): Promise<string>;
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    send(target: QqSendTarget, body: QqMessageBody): Promise<QqSendResult>;
+    status(): QqPortStatus;
+}
+export interface QqPortOptions {
+    appId: string;
+    appSecret: string;
+    baseUrl?: string;
+    fetch?: QqFetch;
+    now?: () => number;
+}
+/** The message endpoint for one conversation; `messageId` narrows it to that message (retract). */
+export declare function messagePath(target: QqSendTarget, messageId?: string): string;
+export declare function createQqPort(options: QqPortOptions): QqPort;
+//# sourceMappingURL=port.d.ts.map