@onlyne/im-qq 3.1.0 → 3.2.0

package/dist/gateway.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The QQ Bot gateway: QQ's own receive path, one WebSocket per shard. Events arrive as `op 0`
+ * dispatches; the access token, `/gateway/bot` and every outbound call stay on the HTTP port.
+ *
+ * The sequence number advances only after the listener accepted an event, so a delivery that
+ * failed is replayed by the platform on the next resume instead of being skipped.
+ */
+import type { QqPort } from './port.js';
+/** `idle` before `start`, `connecting` while a socket is being established. */
+export type QqGatewayState = 'idle' | 'connecting' | 'online' | 'resuming' | 'paused' | 'stopped';
+/** Group and c2c messages (bit 25) plus interaction callbacks (bit 26): what this connector translates. */
+export declare const QQ_INTENTS: number;
+/** QQ's `session_start_limit`: how many sessions may be opened, and how fast. */
+export interface QqSessionStartLimit {
+    /** Sessions that may be started at the same time. */
+    max_concurrency: number;
+    /** Sessions left in the current window. */
+    remaining: number;
+    /** Milliseconds until `remaining` resets. */
+    reset_after: number;
+    /** Sessions a full window allows. */
+    total: number;
+}
+export interface QqGatewayStatus {
+    state: QqGatewayState;
+    /** Connections opened after the first one. */
+    reconnects: number;
+    /** Heartbeats that went unanswered; each one closed its socket. */
+    heartbeat_timeouts: number;
+    /** Sessions continued by `op 6` after a drop. */
+    resumes: number;
+    /** Resume attempts the platform rejected, each followed by a fresh Identify. */
+    resume_failures: number;
+    shards: number;
+}
+export interface QqGatewayHandlers {
+    /**
+     * One `op 0` dispatch. The sequence number advances only after this resolves, so a rejection
+     * is redelivered after the next resume.
+     */
+    dispatch(payload: Record<string, unknown>): void | Promise<void>;
+}
+export interface QqGatewayOptions {
+    /** The HTTP boundary: the access token and `/gateway/bot`. */
+    port: QqPort;
+    /** The intents bitmask; defaults to `QQ_INTENTS`. */
+    intents?: number;
+    log?: (message: string, fields?: Record<string, unknown>) => void;
+    /**
+     * One call per state transition, with the shard, session and attempt the transition knew.
+     * A gateway whose host owns the log reports here instead of writing its own line.
+     */
+    onState?: (to: QqGatewayState, fields: Record<string, unknown>) => void;
+    now?: () => number;
+    /** First reconnect waits this long before the exponential starts; 0 reconnects at once. */
+    reconnectBaseMs?: number;
+    /** The backoff ceiling. */
+    reconnectCapMs?: number;
+}
+export interface QqGateway {
+    start(handlers: QqGatewayHandlers): Promise<void>;
+    stop(): Promise<void>;
+    status(): QqGatewayStatus;
+}
+export declare function createQqGateway(options: QqGatewayOptions): QqGateway;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElG,2GAA2G;AAC3G,eAAO,MAAM,UAAU,QAAwB,CAAC;AAEhD,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClE;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACxE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,IAAI,eAAe,CAAC;CAC3B;AAyCD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAibpE"}

package/dist/gateway.js

@@ -0,0 +1,484 @@
+/**
+ * The QQ Bot gateway: QQ's own receive path, one WebSocket per shard. Events arrive as `op 0`
+ * dispatches; the access token, `/gateway/bot` and every outbound call stay on the HTTP port.
+ *
+ * The sequence number advances only after the listener accepted an event, so a delivery that
+ * failed is replayed by the platform on the next resume instead of being skipped.
+ */
+/** Group and c2c messages (bit 25) plus interaction callbacks (bit 26): what this connector translates. */
+export const QQ_INTENTS = (1 << 25) | (1 << 26);
+const DEFAULT_RECONNECT_BASE_MS = 1_000;
+const DEFAULT_RECONNECT_CAP_MS = 30_000;
+/** A socket that has not opened by then is dead; QQ's own clients give up at a similar point. */
+const CONNECT_TIMEOUT_MS = 15_000;
+/** How often a paused session start re-checks its budget. */
+const PAUSED_POLL_MS = 250;
+/** The Hello interval when the platform omits it; QQ documents 41 250 ms. */
+const DEFAULT_HEARTBEAT_MS = 41_250;
+/** `session_start_limit.reset_after` of 0 would pause forever, so a missing window is a second. */
+const DEFAULT_LIMIT_WINDOW_MS = 1_000;
+function recordOf(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function numberOr(value, fallback) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+function detailOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function createQqGateway(options) {
+    const port = options.port;
+    const log = options.log ?? (() => { });
+    const onState = options.onState;
+    const now = options.now ?? Date.now;
+    const intents = options.intents ?? QQ_INTENTS;
+    const baseMs = options.reconnectBaseMs ?? DEFAULT_RECONNECT_BASE_MS;
+    const capMs = options.reconnectCapMs ?? DEFAULT_RECONNECT_CAP_MS;
+    let state = 'idle';
+    let stopping = false;
+    let handlers;
+    let shardCount = 1;
+    let reconnects = 0;
+    let heartbeatTimeouts = 0;
+    let resumes = 0;
+    let resumeFailures = 0;
+    const loops = [];
+    const sockets = new Set();
+    const sleepers = new Set();
+    // `/gateway/bot` is fetched once and reused: QQ rate-limits it, and a reconnect storm must not
+    // turn into a discovery storm.
+    let discovered;
+    let discovering;
+    let limit = { max_concurrency: 1, remaining: 1, reset_after: 0, total: 1 };
+    let windowEndsAt = 0;
+    let starting = 0;
+    function transition(next, fields = {}) {
+        if (state === next)
+            return;
+        const from = state;
+        state = next;
+        if (onState !== undefined)
+            onState(next, fields);
+        else
+            log('connector.state', { platform: 'qq', from, to: next, ...fields });
+    }
+    /** Sleeps, but a stop wakes it: `stop` must not wait out a 30 s backoff. */
+    function pause(ms) {
+        if (stopping || ms <= 0)
+            return Promise.resolve();
+        const { promise, resolve } = Promise.withResolvers();
+        const wake = () => {
+            clearTimeout(timer);
+            sleepers.delete(wake);
+            resolve();
+        };
+        const timer = setTimeout(wake, ms);
+        sleepers.add(wake);
+        return promise;
+    }
+    /** The first reconnect is immediate, then doubling with ±20% jitter so shards do not sync up. */
+    function backoff(attempt) {
+        if (attempt <= 0)
+            return 0;
+        const exponential = Math.min(capMs, baseMs * 2 ** (attempt - 1));
+        return Math.round(exponential * (0.8 + Math.random() * 0.4));
+    }
+    async function fetchInfo() {
+        const body = recordOf(await port.request('GET', '/gateway/bot'));
+        const url = typeof body?.url === 'string' && body.url.length > 0 ? body.url : undefined;
+        if (url === undefined)
+            throw new Error('The QQ /gateway/bot answer carries no url.');
+        const raw = recordOf(body?.session_start_limit) ?? {};
+        return {
+            url,
+            shards: Math.max(1, Math.floor(numberOr(body?.shards, 1))),
+            limit: {
+                max_concurrency: Math.max(1, Math.floor(numberOr(raw.max_concurrency, 1))),
+                remaining: Math.max(0, Math.floor(numberOr(raw.remaining, 1))),
+                reset_after: Math.max(0, numberOr(raw.reset_after, 0)),
+                total: Math.max(1, Math.floor(numberOr(raw.total, 1))),
+            },
+        };
+    }
+    async function info(refresh) {
+        if (discovered !== undefined && !refresh)
+            return discovered;
+        if (discovering !== undefined)
+            return discovering;
+        const pending = fetchInfo();
+        discovering = pending;
+        try {
+            const next = await pending;
+            discovered = next;
+            observeLimit(next.limit);
+            return next;
+        }
+        finally {
+            if (discovering === pending)
+                discovering = undefined;
+        }
+    }
+    function observeLimit(next) {
+        limit = next;
+        windowEndsAt = next.remaining > 0 ? 0 : now() + Math.max(DEFAULT_LIMIT_WINDOW_MS, next.reset_after);
+    }
+    /** One session start, or `undefined` when a stop interrupted the wait. */
+    async function acquire(shard) {
+        let paused = false;
+        while (!stopping) {
+            if (windowEndsAt !== 0 && now() >= windowEndsAt) {
+                limit = { ...limit, remaining: limit.total };
+                windowEndsAt = 0;
+            }
+            if (limit.remaining > 0 && starting < limit.max_concurrency) {
+                limit = { ...limit, remaining: limit.remaining - 1 };
+                // The last session of the window starts the wait, not the next call: without this the
+                // pause would have no end to look forward to.
+                if (limit.remaining === 0)
+                    windowEndsAt = now() + Math.max(DEFAULT_LIMIT_WINDOW_MS, limit.reset_after);
+                starting += 1;
+                let released = false;
+                return () => {
+                    if (released)
+                        return;
+                    released = true;
+                    starting = Math.max(0, starting - 1);
+                };
+            }
+            if (!paused) {
+                paused = true;
+                log('qq gateway session start deferred', {
+                    shard, remaining: limit.remaining, reset_after: limit.reset_after, concurrency: starting,
+                });
+                transition('paused', { shard, remaining: limit.remaining });
+            }
+            await pause(PAUSED_POLL_MS);
+        }
+        return undefined;
+    }
+    /**
+     * One socket, from Hello to close. Resolves `true` when the session reached READY or RESUMED,
+     * so the caller knows whether the next attempt is a resume or a fresh handshake.
+     */
+    function connect(shard, url, total, release) {
+        const { promise, resolve } = Promise.withResolvers();
+        const run = () => {
+            let socket;
+            let heartbeat;
+            let ack;
+            let connectTimer;
+            let interval = DEFAULT_HEARTBEAT_MS;
+            let online = false;
+            let started = false;
+            let failed = false;
+            let settled = false;
+            /** Serialized per connection: one event at a time, in sequence order. */
+            let chain = Promise.resolve();
+            const send = (payload) => {
+                if (socket?.readyState !== 1)
+                    return;
+                try {
+                    socket.send(JSON.stringify(payload));
+                }
+                catch (error) {
+                    log('qq gateway send failed', { shard: shard.index, op: payload.op, error: detailOf(error) });
+                }
+            };
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(heartbeat);
+                clearTimeout(ack);
+                clearTimeout(connectTimer);
+                release();
+                if (socket !== undefined) {
+                    sockets.delete(socket);
+                    try {
+                        socket.close();
+                    }
+                    catch {
+                        // Already closing: the close event may have been what brought us here.
+                    }
+                }
+                resolve(online);
+            };
+            const beat = () => {
+                if (settled)
+                    return;
+                send({ op: 1, d: shard.seq });
+                // A missed ACK is a dead connection: QQ answers every op 1 with op 11.
+                ack = setTimeout(() => {
+                    heartbeatTimeouts += 1;
+                    log('qq gateway heartbeat unanswered', { shard: shard.index, seq: shard.seq, interval });
+                    transition('connecting', { shard: shard.index, reason: 'heartbeat_timeout' });
+                    finish();
+                }, interval);
+                heartbeat = setTimeout(beat, interval);
+            };
+            const begin = async () => {
+                if (started)
+                    return;
+                started = true;
+                let token;
+                try {
+                    token = await port.token();
+                }
+                catch (error) {
+                    log('qq gateway token unavailable', { shard: shard.index, error: detailOf(error) });
+                    finish();
+                    return;
+                }
+                if (settled)
+                    return;
+                if (shard.sessionId !== undefined) {
+                    transition('resuming', { shard: shard.index, session_id: shard.sessionId, seq: shard.seq });
+                    send({ op: 6, d: { token: `QQBot ${token}`, session_id: shard.sessionId, seq: shard.seq } });
+                    return;
+                }
+                send({
+                    op: 2,
+                    d: {
+                        token: `QQBot ${token}`,
+                        intents,
+                        shard: [shard.index, total],
+                        properties: { $os: 'linux', $browser: 'onlyne', $device: 'onlyne' },
+                    },
+                });
+            };
+            const dispatch = (payload) => {
+                const type = typeof payload.t === 'string' ? payload.t : undefined;
+                const seq = typeof payload.s === 'number' ? payload.s : undefined;
+                if (type === 'READY') {
+                    const sessionId = recordOf(payload.d)?.session_id;
+                    if (typeof sessionId === 'string' && sessionId.length > 0)
+                        shard.sessionId = sessionId;
+                    if (seq !== undefined && seq > shard.seq)
+                        shard.seq = seq;
+                    online = true;
+                    release();
+                    transition('online', { shard: shard.index, session_id: shard.sessionId });
+                    return;
+                }
+                if (type === 'RESUMED') {
+                    resumes += 1;
+                    if (seq !== undefined && seq > shard.seq)
+                        shard.seq = seq;
+                    online = true;
+                    release();
+                    transition('online', { shard: shard.index, seq: shard.seq });
+                    return;
+                }
+                if (seq === undefined)
+                    return;
+                chain = chain.then(async () => {
+                    if (failed || settled)
+                        return;
+                    const listener = handlers;
+                    try {
+                        if (listener !== undefined)
+                            await listener.dispatch(payload);
+                        if (seq > shard.seq)
+                            shard.seq = seq;
+                    }
+                    catch (error) {
+                        // Stop advancing: the resume replays from `shard.seq`, so this event comes back.
+                        failed = true;
+                        log('qq gateway dispatch failed', {
+                            shard: shard.index, seq, type,
+                            source: recordOf(payload.d)?.id ?? payload.id, error: detailOf(error),
+                        });
+                        finish();
+                    }
+                });
+            };
+            const onMessage = (event) => {
+                let payload;
+                try {
+                    payload = recordOf(JSON.parse(String(event.data)));
+                }
+                catch {
+                    payload = undefined;
+                }
+                if (payload === undefined)
+                    return;
+                const op = payload.op;
+                if (op === 10) {
+                    const heartbeatInterval = numberOr(recordOf(payload.d)?.heartbeat_interval, 0);
+                    if (heartbeatInterval > 0)
+                        interval = heartbeatInterval;
+                    heartbeat = setTimeout(beat, interval);
+                    void begin();
+                    return;
+                }
+                if (op === 11) {
+                    if (ack !== undefined) {
+                        clearTimeout(ack);
+                        ack = undefined;
+                    }
+                    return;
+                }
+                if (op === 1) {
+                    send({ op: 1, d: shard.seq });
+                    return;
+                }
+                if (op === 7) {
+                    log('qq gateway asked for a reconnect', { shard: shard.index, seq: shard.seq });
+                    finish();
+                    return;
+                }
+                if (op === 9) {
+                    const resumable = payload.d === true;
+                    if (shard.sessionId !== undefined)
+                        resumeFailures += 1;
+                    log('qq gateway rejected the session', {
+                        shard: shard.index, resumable, session_id: shard.sessionId, seq: shard.seq,
+                    });
+                    if (!resumable) {
+                        shard.sessionId = undefined;
+                        shard.seq = 0;
+                    }
+                    transition('connecting', { shard: shard.index, reason: 'invalid_session' });
+                    finish();
+                    return;
+                }
+                if (op === 0)
+                    dispatch(payload);
+            };
+            try {
+                socket = new WebSocket(url);
+            }
+            catch (error) {
+                log('qq gateway socket could not open', { shard: shard.index, url, error: detailOf(error) });
+                finish();
+                return;
+            }
+            sockets.add(socket);
+            if (stopping) {
+                // A stop landed between the session start and the dial: close what was just opened.
+                finish();
+                return;
+            }
+            connectTimer = setTimeout(() => {
+                log('qq gateway socket did not open in time', { shard: shard.index, url, timeout_ms: CONNECT_TIMEOUT_MS });
+                finish();
+            }, CONNECT_TIMEOUT_MS);
+            socket.addEventListener('open', () => {
+                if (connectTimer !== undefined) {
+                    clearTimeout(connectTimer);
+                    connectTimer = undefined;
+                }
+            });
+            socket.addEventListener('message', onMessage);
+            socket.addEventListener('error', error => {
+                log('qq gateway socket error', { shard: shard.index, error: detailOf(error) });
+                finish();
+            });
+            socket.addEventListener('close', event => {
+                if (!settled)
+                    log('qq gateway socket closed', { shard: shard.index, code: event.code, seq: shard.seq });
+                finish();
+            });
+        };
+        run();
+        return promise;
+    }
+    /** One shard's whole life: discover, start a session, and reconnect until a stop. */
+    async function session(index, total) {
+        const shard = { index, seq: 0 };
+        let attempt = 0;
+        let refresh = false;
+        while (!stopping) {
+            let target;
+            try {
+                target = await info(refresh);
+            }
+            catch (error) {
+                log('qq gateway discovery failed', { shard: index, error: detailOf(error), attempt });
+                transition('connecting', { shard: index, attempt, error: detailOf(error) });
+                await pause(backoff(attempt));
+                attempt += 1;
+                continue;
+            }
+            const release = await acquire(index);
+            if (release === undefined)
+                return;
+            transition(shard.sessionId === undefined ? 'connecting' : 'resuming', {
+                shard: index, seq: shard.seq, attempt, ...(shard.sessionId === undefined ? {} : { session_id: shard.sessionId }),
+            });
+            const online = await connect(shard, target.url, Math.max(1, target.shards), release);
+            if (stopping)
+                return;
+            reconnects += 1;
+            // A session that never came online means the url or the budget is stale: rediscover.
+            refresh = !online;
+            attempt = online ? 0 : attempt + 1;
+            log('qq gateway connection ended', {
+                shard: index, reconnects, online, session_id: shard.sessionId, seq: shard.seq, attempt,
+            });
+            await pause(backoff(online ? 0 : attempt));
+        }
+    }
+    async function control() {
+        let attempt = 0;
+        while (!stopping) {
+            try {
+                const first = await info(true);
+                const count = Math.max(1, first.shards);
+                shardCount = count;
+                log('qq gateway discovered', {
+                    url: first.url, shards: count, remaining: first.limit.remaining, reset_after: first.limit.reset_after,
+                });
+                await Promise.all(Array.from({ length: count }, (_, index) => session(index, count)));
+                return;
+            }
+            catch (error) {
+                log('qq gateway discovery failed', { error: detailOf(error), attempt });
+                transition('connecting', { attempt, error: detailOf(error) });
+                await pause(backoff(attempt));
+                attempt += 1;
+            }
+        }
+    }
+    return {
+        async start(next) {
+            if (loops.length > 0)
+                return;
+            handlers = next;
+            stopping = false;
+            transition('connecting');
+            // Not awaited: a network outage is a state the operator watches, not a failed start.
+            loops.push(control());
+        },
+        async stop() {
+            stopping = true;
+            for (const wake of [...sleepers])
+                wake();
+            for (const socket of [...sockets]) {
+                try {
+                    socket.close();
+                }
+                catch {
+                    // Already closing.
+                }
+            }
+            await Promise.all(loops);
+            loops.length = 0;
+            discovered = undefined;
+            transition('stopped');
+        },
+        status() {
+            return {
+                state,
+                reconnects,
+                heartbeat_timeouts: heartbeatTimeouts,
+                resumes,
+                resume_failures: resumeFailures,
+                shards: shardCount,
+            };
+        },
+    };
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 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 type { Json } from '@onlyne/lib';
+import { type Connector, type SendOutcome } from '@onlyne/im-core';
+import { type QqPort } from './port.js';
+import { type QqGatewayOptions, type QqGatewayState } from './gateway.js';
+export { createQqPort, messagePath, QqPortError, type QqFetch, type QqHttpRequest, type QqHttpResponse, type QqMessageBody, type QqPort, type QqPortOptions, type QqPortStatus, type QqSendResult, type QqSendTarget, } from './port.js';
+export { normalizeEvent } from './normalize.js';
+export { challenge, deriveEd25519, signHex, verifyHex, type QqEd25519Keys } from './webhook.js';
+export { createSendState, parseConversation, sendMessage, type QqMessagePort, type SendState } from './send.js';
+export { createQqGateway, QQ_INTENTS, type QqGateway, type QqGatewayHandlers, type QqGatewayOptions, type QqGatewayState, type QqGatewayStatus, type QqSessionStartLimit, } from './gateway.js';
+export declare const QQ_CREDENTIAL_VARIABLES: readonly ["QQ_BOT_APP_ID", "QQ_BOT_APP_SECRET"];
+/** Platform operations the connector implements beyond `send`; a resource lists them. */
+export declare const QQ_OPERATIONS: readonly ["recall", "typing"];
+/** Where inbound events come from: the platform's gateway socket, or its signed HTTP callback. */
+export type QqTransport = 'websocket' | 'webhook';
+export type QqConnectionState = 'onboarding'
+/** The webhook transport is authenticated and ready; the platform calls in. */
+ | 'connected' | QqGatewayState | 'error';
+/** The optional platform-status surface the gateway duck-types; not part of `Connector`. */
+export interface QqStatus {
+    state: string;
+    connected: boolean;
+    reconnects: number;
+    rate_limits: number;
+    last_event_at?: string;
+    onboarding?: string[];
+    error?: string;
+    /** The inbound transport in force. */
+    transport: QqTransport;
+    /** WebSocket gateway counters; present once the gateway transport has started. */
+    heartbeat_timeouts?: number;
+    resumes?: number;
+    resume_failures?: number;
+    shards?: number;
+}
+/** The gateway transport's knobs; the connector supplies the port, the log and the clock. */
+export type QqGatewayTuning = Omit<QqGatewayOptions, 'port' | 'log' | 'onState' | 'now'>;
+export interface QqConnectorOptions {
+    /** Explicit `appId:appSecret`; wins over the file and the environment pair. */
+    credential?: string;
+    /** Path to a credential file; `$VAR` references resolve from the environment. */
+    credentialFile?: string;
+    env?: Record<string, string | undefined>;
+    readFile?: (path: string) => Promise<string>;
+    /** The HTTP boundary; production leaves it unset and one is built from the credential. */
+    port?: QqPort;
+    log?: (message: string, fields?: Record<string, unknown>) => void;
+    /**
+     * One call per connection state transition, with the shard and session the transition knew;
+     * the host that owns the log renders it as `connector.state`.
+     */
+    onState?: (to: string, fields?: Record<string, unknown>) => void;
+    /**
+     * Inbound transport. The gateway socket is QQ's own receive path and needs no public endpoint;
+     * `webhook` serves the signed HTTP callback instead. Default `websocket`.
+     */
+    transport?: QqTransport;
+    /** Gateway transport tuning: the reconnect backoff, and the intents bitmask. */
+    gateway?: QqGatewayTuning;
+    /** The inbound path the operator registers with QQ; reported once at start. */
+    webhookPath?: string;
+    now?: () => number;
+}
+export interface QqConnector extends Connector {
+    readonly operations: readonly string[];
+    validate(operation: string, data: Json): void;
+    operate(operation: string, data: Json): Promise<SendOutcome>;
+    status(): QqStatus;
+    /** The platform's callback: op 13 validation and signed op 0 dispatches. */
+    handleWebhook(request: Request): Promise<Response>;
+}
+export declare function createQqConnector(options?: QqConnectorOptions): QqConnector;
+//# sourceMappingURL=index.d.ts.map