appId: string;

clientSecret: string;

}

// Re-export getNextMsgSeq for consumers that import from messages.ts.

export { getNextMsgSeq } from "./routes.js";

}

/** Business error codes that trigger persistent part-finish retry. */

export const PART_FINISH_RETRYABLE_CODES: Set<number> = new Set([40093001]);

const PART_FINISH_RETRYABLE_CODES: Set<number> = new Set([40093001]);

/** upload_prepare error code indicating daily limit exceeded. */

export const UPLOAD_PREPARE_FALLBACK_CODE = 40093002;

// ---- Exported types ----

/** Maximum text length for a single QQ Bot message. */

export const TEXT_CHUNK_LIMIT = 5000;

const TEXT_CHUNK_LIMIT = 5000;

export interface DeliverEventContext {

type: "c2c" | "guild" | "dm" | "group";

}

/** Check whether a target type supports rich media (C2C and Group only). */

export function supportsRichMedia(targetType: string): boolean {

function supportsRichMedia(targetType: string): boolean {

return targetType === "c2c" || targetType === "group";

}

}

/** 统一的媒体标签正则 — 匹配标准化后的 6 种标签 */

export const MEDIA_TAG_REGEX =

const MEDIA_TAG_REGEX =

/<(qqimg|qqvoice|qqvideo|qqfile|qqmedia|img)>([^<>]+)<\/(?:qqimg|qqvoice|qqvideo|qqfile|qqmedia|img)>/gi;

/** 创建一个新的全局标签正则实例（每次调用 reset lastIndex） */

export function createMediaTagRegex(): RegExp {

function createMediaTagRegex(): RegExp {

return new RegExp(MEDIA_TAG_REGEX.source, MEDIA_TAG_REGEX.flags);

}

* 此方法在 gateway.ts deliver 回调、outbound.ts sendText、

* streaming.ts sendMediaQueue 中共用。

*/

export function fixPathEncoding(

function fixPathEncoding(

mediaPath: string,

log?: { debug?: (msg: string) => void; error?: (msg: string) => void },

): string {

* @param position 要检测的位置（字符索引）

* @returns 如果 position 在围栏代码块内返回 true

*/

export function isInsideCodeBlock(text: string, position: number): boolean {

function isInsideCodeBlock(text: string, position: number): boolean {

const fenceRegex = /^(`{3,})[^\n]*$/gm;

let fenceMatch: RegExpExecArray | null;

let openFence: { pos: number; ticks: number } | null = null;

* Build the full API URL from base + path + query params.

* 拼接 API 基地址 + 路径 + 查询参数。

*/

export function buildUrl(path: string, query?: Record<string, string>): string {

function buildUrl(path: string, query?: Record<string, string>): string {

let url = `${API_BASE}${path}`;

if (query && Object.keys(query).length > 0) {

const params = new URLSearchParams();

* Validate API path format; returns an error string or null if valid.

* 校验 API 路径格式，返回错误描述或 null（合法）。

*/

export function validatePath(path: string): string | null {

function validatePath(path: string): string | null {

if (!path.startsWith("/")) {

return "path must start with /";

}