@zhin.js/plugin-bilibili 0.0.0-stage → 0.1.1

package/lib/api.js

@@ -0,0 +1,298 @@
+/**
+ * Minimal Bilibili web API client.
+ *
+ * Only public, key-less endpoints are used. Every response is validated
+ * defensively: when Bilibili changes a payload we raise a `BiliApiError` with
+ * kind `shape` instead of crashing the poller, and risk-control responses
+ * (-352 / -412 / -799 / HTTP 412) are reported as kind `risk` so callers can
+ * back off.
+ */
+import { mixinKey, signWbi, wbiKeyFromUrl } from './wbi.js';
+export const DEFAULT_USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36';
+export class BiliApiError extends Error {
+    kind;
+    code;
+    constructor(kind, message, code) {
+        super(message);
+        this.name = 'BiliApiError';
+        this.kind = kind;
+        this.code = code;
+    }
+}
+const RISK_CODES = new Set([-352, -412, -509, -799, -401]);
+const NOT_FOUND_CODES = new Set([-404, -626, 4100000, 60004, 1]);
+const WBI_TTL_MS = 6 * 60 * 60 * 1000;
+/**
+ * Browser fingerprint hints the web client sends with the space feed. Without
+ * them anonymous requests are answered with -352 far more often.
+ */
+const DM_PARAMS = Object.freeze({
+    dm_img_list: '[]',
+    dm_img_str: Buffer.from('WebGL 1.0 (OpenGL ES 2.0 Chromium)').toString('base64').replace(/=+$/u, ''),
+    dm_cover_img_str: Buffer.from('ANGLE (Apple, ANGLE Metal Renderer: Apple M1, Unspecified Version)Google Inc. (Apple)')
+        .toString('base64')
+        .replace(/=+$/u, ''),
+});
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function str(value) {
+    return typeof value === 'string' ? value : typeof value === 'number' && Number.isFinite(value) ? String(value) : '';
+}
+function int(value) {
+    const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : Number.NaN;
+    return Number.isFinite(parsed) ? Math.trunc(parsed) : 0;
+}
+function clip(text, max = 120) {
+    const flat = text.replace(/\s+/gu, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max)}…` : flat;
+}
+function absoluteUrl(url) {
+    if (url.startsWith('//'))
+        return `https:${url}`;
+    return url;
+}
+export class BiliClient {
+    #timeout;
+    #userCookie;
+    #fetch;
+    #now;
+    #buvid;
+    #wbi;
+    constructor(options = {}) {
+        this.#timeout = options.timeout ?? 10_000;
+        this.#userCookie = options.cookie?.trim() ?? '';
+        this.#fetch = options.fetch ?? ((input, init) => fetch(input, init));
+        this.#now = options.now ?? Date.now;
+    }
+    /** Forget cached device id and WBI key, e.g. after a risk-control response. */
+    resetSession() {
+        this.#buvid = undefined;
+        this.#wbi = undefined;
+    }
+    async #request(url, init = {}) {
+        const headers = {
+            'user-agent': DEFAULT_USER_AGENT,
+            accept: 'application/json, text/plain, */*',
+            referer: init.referer ?? 'https://www.bilibili.com/',
+            ...init.headers,
+        };
+        if (init.cookie !== false) {
+            const cookie = await this.#cookie();
+            if (cookie)
+                headers.cookie = cookie;
+        }
+        let response;
+        try {
+            response = await this.#fetch(url, {
+                method: init.method ?? 'GET',
+                headers,
+                ...(init.body === undefined ? {} : { body: init.body }),
+                signal: AbortSignal.timeout(this.#timeout),
+            });
+        }
+        catch (error) {
+            const cause = error;
+            throw new BiliApiError('network', cause.name === 'TimeoutError' ? `请求超时（${this.#timeout}ms）` : `请求失败: ${cause.message}`);
+        }
+        if (response.status === 412)
+            throw new BiliApiError('risk', 'B 站风控拦截（HTTP 412）', 412);
+        if (!response.ok)
+            throw new BiliApiError('http', `HTTP ${response.status}`, response.status);
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch {
+            throw new BiliApiError('shape', '接口返回的不是 JSON');
+        }
+        if (!isRecord(body))
+            throw new BiliApiError('shape', '接口返回格式异常');
+        const code = int(body.code);
+        if (code !== 0 && !init.acceptCodes?.includes(code)) {
+            const message = str(body.message) || str(body.msg) || `错误码 ${code}`;
+            if (RISK_CODES.has(code)) {
+                this.resetSession();
+                throw new BiliApiError('risk', `B 站风控拦截（${code}: ${message}）`, code);
+            }
+            if (NOT_FOUND_CODES.has(code))
+                throw new BiliApiError('not_found', message, code);
+            throw new BiliApiError('http', message, code);
+        }
+        return body.data;
+    }
+    async #cookie() {
+        if (this.#userCookie)
+            return this.#userCookie;
+        if (this.#buvid !== undefined)
+            return this.#buvid;
+        try {
+            const data = await this.#request('https://api.bilibili.com/x/frontend/finger/spi', { cookie: false });
+            const b3 = isRecord(data) ? str(data.b_3) : '';
+            const b4 = isRecord(data) ? str(data.b_4) : '';
+            this.#buvid = b3 ? `buvid3=${b3}${b4 ? `; buvid4=${encodeURIComponent(b4)}` : ''}` : '';
+        }
+        catch {
+            // Device id is best effort; most endpoints still answer without it.
+            this.#buvid = '';
+        }
+        return this.#buvid;
+    }
+    async #wbiKey() {
+        if (this.#wbi && this.#now() - this.#wbi.at < WBI_TTL_MS)
+            return this.#wbi.key;
+        // `nav` answers -101 (not logged in) for guests but still carries wbi_img.
+        const data = await this.#request('https://api.bilibili.com/x/web-interface/nav', { acceptCodes: [-101] });
+        const img = isRecord(data) && isRecord(data.wbi_img) ? data.wbi_img : undefined;
+        const imgUrl = img ? str(img.img_url) : '';
+        const subUrl = img ? str(img.sub_url) : '';
+        if (!imgUrl || !subUrl)
+            throw new BiliApiError('shape', '无法获取 WBI 密钥');
+        const key = mixinKey(wbiKeyFromUrl(imgUrl), wbiKeyFromUrl(subUrl));
+        this.#wbi = { key, at: this.#now() };
+        return key;
+    }
+    /** Batch live status by UP uid (no auth). */
+    async getLiveStatus(uids) {
+        const result = new Map();
+        for (let index = 0; index < uids.length; index += 50) {
+            const chunk = uids.slice(index, index + 50).map(Number);
+            const data = await this.#request('https://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids', {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({ uids: chunk }),
+                referer: 'https://live.bilibili.com/',
+            });
+            // An empty result is serialised as [] instead of {}.
+            if (Array.isArray(data))
+                continue;
+            if (!isRecord(data))
+                throw new BiliApiError('shape', '开播状态接口格式异常');
+            for (const [key, value] of Object.entries(data)) {
+                if (!isRecord(value))
+                    continue;
+                const uid = str(value.uid) || key;
+                const roomId = str(value.room_id);
+                result.set(uid, {
+                    uid,
+                    uname: str(value.uname),
+                    roomId,
+                    title: str(value.title),
+                    liveStatus: int(value.live_status),
+                    liveTime: int(value.live_time),
+                    cover: str(value.cover_from_user) || str(value.keyframe),
+                    area: str(value.area_v2_name) || str(value.area_name),
+                    url: roomId ? `https://live.bilibili.com/${roomId}` : '',
+                });
+            }
+        }
+        return result;
+    }
+    async getRoomInfo(roomId) {
+        const data = await this.#request(`https://api.live.bilibili.com/room/v1/Room/get_info?room_id=${encodeURIComponent(roomId)}`, { referer: 'https://live.bilibili.com/' });
+        if (!isRecord(data) || !str(data.room_id))
+            throw new BiliApiError('shape', '直播间接口格式异常');
+        const realId = str(data.room_id);
+        return {
+            uid: str(data.uid),
+            roomId: realId,
+            title: str(data.title),
+            liveStatus: int(data.live_status),
+            area: str(data.area_name),
+            online: int(data.online),
+            url: `https://live.bilibili.com/${realId}`,
+        };
+    }
+    async getUserCard(uid) {
+        const data = await this.#request(`https://api.bilibili.com/x/web-interface/card?mid=${encodeURIComponent(uid)}`);
+        const card = isRecord(data) && isRecord(data.card) ? data.card : undefined;
+        if (!card)
+            throw new BiliApiError('shape', '用户信息接口格式异常');
+        return { uid: str(card.mid) || uid, name: str(card.name) };
+    }
+    /** Latest space dynamics of one UP (WBI signed). Newest first, as returned. */
+    async getDynamics(uid) {
+        const key = await this.#wbiKey();
+        const query = signWbi({ host_mid: uid, features: 'itemOpusStyle', ...DM_PARAMS }, key, Math.floor(this.#now() / 1000));
+        const data = await this.#request(`https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/space?${query}`, {
+            referer: `https://space.bilibili.com/${uid}/dynamic`,
+            headers: { origin: 'https://space.bilibili.com' },
+        });
+        if (!isRecord(data) || !Array.isArray(data.items))
+            throw new BiliApiError('shape', '动态接口格式异常');
+        const items = [];
+        for (const raw of data.items) {
+            const item = parseDynamic(raw);
+            if (item)
+                items.push(item);
+        }
+        return items;
+    }
+}
+/** Turn one raw feed item into a compact, push-ready record (undefined = skip). */
+export function parseDynamic(raw) {
+    if (!isRecord(raw))
+        return undefined;
+    const id = str(raw.id_str);
+    if (!id)
+        return undefined;
+    const type = str(raw.type);
+    // Live rooms are pushed by the live watcher, not as dynamics.
+    if (type === 'DYNAMIC_TYPE_LIVE_RCMD' || type === 'DYNAMIC_TYPE_LIVE')
+        return undefined;
+    const modules = isRecord(raw.modules) ? raw.modules : {};
+    const author = isRecord(modules.module_author) ? modules.module_author : {};
+    const dynamic = isRecord(modules.module_dynamic) ? modules.module_dynamic : {};
+    const tag = isRecord(modules.module_tag) ? modules.module_tag : {};
+    const major = isRecord(dynamic.major) ? dynamic.major : {};
+    const desc = isRecord(dynamic.desc) ? str(dynamic.desc.text) : '';
+    const archive = isRecord(major.archive) ? major.archive : undefined;
+    const opus = isRecord(major.opus) ? major.opus : undefined;
+    const article = isRecord(major.article) ? major.article : undefined;
+    const opusText = opus && isRecord(opus.summary) ? str(opus.summary.text) : '';
+    const opusTitle = opus ? str(opus.title) : '';
+    let summary;
+    let url = `https://t.bilibili.com/${id}`;
+    switch (type) {
+        case 'DYNAMIC_TYPE_AV':
+            summary = `投稿了视频：${archive ? str(archive.title) : desc}`;
+            if (archive && str(archive.jump_url))
+                url = absoluteUrl(str(archive.jump_url));
+            break;
+        case 'DYNAMIC_TYPE_ARTICLE':
+            summary = `发布了专栏：${opusTitle || (article ? str(article.title) : '') || clip(opusText)}`;
+            break;
+        case 'DYNAMIC_TYPE_FORWARD':
+            summary = `转发了动态：${clip(desc) || '(无附言)'}`;
+            break;
+        default:
+            summary = clip(opusText || desc || opusTitle) || '发布了新动态';
+    }
+    return {
+        id,
+        author: str(author.name),
+        pubTs: int(author.pub_ts),
+        type,
+        pinned: str(tag.text) === '置顶',
+        summary,
+        url,
+    };
+}
+/** Accepts `123`, `UID:123`, `https://space.bilibili.com/123/...`. */
+export function parseUid(input) {
+    const text = input.trim();
+    const fromUrl = /space\.bilibili\.com\/(\d{1,20})/u.exec(text);
+    if (fromUrl)
+        return fromUrl[1];
+    const plain = /^(?:uid[:：]?)?(\d{1,20})$/iu.exec(text);
+    return plain?.[1];
+}
+/** Accepts `21452505` or `https://live.bilibili.com/21452505`. */
+export function parseRoomId(input) {
+    const text = input.trim();
+    const fromUrl = /live\.bilibili\.com\/(?:h5\/)?(\d{1,20})/u.exec(text);
+    if (fromUrl)
+        return fromUrl[1];
+    return /^\d{1,20}$/u.test(text) ? text : undefined;
+}
+//# sourceMappingURL=api.js.map

package/lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Minimal Bilibili web API client.\n *\n * Only public, key-less endpoints are used. Every response is validated\n * defensively: when Bilibili changes a payload we raise a `BiliApiError` with\n * kind `shape` instead of crashing the poller, and risk-control responses\n * (-352 / -412 / -799 / HTTP 412) are reported as kind `risk` so callers can\n * back off.\n */\nimport { mixinKey, signWbi, wbiKeyFromUrl } from './wbi.js';\n\nexport const DEFAULT_USER_AGENT =\n  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0 Safari/537.36';\n\nexport type BiliErrorKind = 'risk' | 'not_found' | 'http' | 'shape' | 'network';\n\nexport class BiliApiError extends Error {\n  readonly kind: BiliErrorKind;\n  readonly code: number | undefined;\n  constructor(kind: BiliErrorKind, message: string, code?: number) {\n    super(message);\n    this.name = 'BiliApiError';\n    this.kind = kind;\n    this.code = code;\n  }\n}\n\nconst RISK_CODES = new Set([-352, -412, -509, -799, -401]);\nconst NOT_FOUND_CODES = new Set([-404, -626, 4100000, 60004, 1]);\nconst WBI_TTL_MS = 6 * 60 * 60 * 1000;\n\n/**\n * Browser fingerprint hints the web client sends with the space feed. Without\n * them anonymous requests are answered with -352 far more often.\n */\nconst DM_PARAMS: Readonly<Record<string, string>> = Object.freeze({\n  dm_img_list: '[]',\n  dm_img_str: Buffer.from('WebGL 1.0 (OpenGL ES 2.0 Chromium)').toString('base64').replace(/=+$/u, ''),\n  dm_cover_img_str: Buffer.from('ANGLE (Apple, ANGLE Metal Renderer: Apple M1, Unspecified Version)Google Inc. (Apple)')\n    .toString('base64')\n    .replace(/=+$/u, ''),\n});\n\nexport interface LiveInfo {\n  readonly uid: string;\n  readonly uname: string;\n  readonly roomId: string;\n  readonly title: string;\n  /** 0 = offline, 1 = live, 2 = replay carousel. */\n  readonly liveStatus: number;\n  /** Unix seconds of the current live start, 0 when unknown. */\n  readonly liveTime: number;\n  readonly cover: string;\n  readonly area: string;\n  readonly url: string;\n}\n\nexport interface RoomInfo {\n  readonly uid: string;\n  readonly roomId: string;\n  readonly title: string;\n  readonly liveStatus: number;\n  readonly area: string;\n  readonly online: number;\n  readonly url: string;\n}\n\nexport interface DynamicItem {\n  readonly id: string;\n  readonly author: string;\n  /** Unix seconds. */\n  readonly pubTs: number;\n  readonly type: string;\n  readonly pinned: boolean;\n  readonly summary: string;\n  readonly url: string;\n}\n\nexport interface UserCard {\n  readonly uid: string;\n  readonly name: string;\n}\n\nexport type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;\n\nexport interface BiliClientOptions {\n  readonly timeout?: number;\n  readonly cookie?: string;\n  readonly fetch?: FetchLike;\n  readonly now?: () => number;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction str(value: unknown): string {\n  return typeof value === 'string' ? value : typeof value === 'number' && Number.isFinite(value) ? String(value) : '';\n}\n\nfunction int(value: unknown): number {\n  const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : Number.NaN;\n  return Number.isFinite(parsed) ? Math.trunc(parsed) : 0;\n}\n\nfunction clip(text: string, max = 120): string {\n  const flat = text.replace(/\\s+/gu, ' ').trim();\n  return flat.length > max ? `${flat.slice(0, max)}…` : flat;\n}\n\nfunction absoluteUrl(url: string): string {\n  if (url.startsWith('//')) return `https:${url}`;\n  return url;\n}\n\nexport class BiliClient {\n  readonly #timeout: number;\n  readonly #userCookie: string;\n  readonly #fetch: FetchLike;\n  readonly #now: () => number;\n  #buvid: string | undefined;\n  #wbi: { key: string; at: number } | undefined;\n\n  constructor(options: BiliClientOptions = {}) {\n    this.#timeout = options.timeout ?? 10_000;\n    this.#userCookie = options.cookie?.trim() ?? '';\n    this.#fetch = options.fetch ?? ((input, init) => fetch(input, init));\n    this.#now = options.now ?? Date.now;\n  }\n\n  /** Forget cached device id and WBI key, e.g. after a risk-control response. */\n  resetSession(): void {\n    this.#buvid = undefined;\n    this.#wbi = undefined;\n  }\n\n  async #request(url: string, init: RequestInit & { cookie?: boolean; referer?: string; acceptCodes?: readonly number[] } = {}): Promise<unknown> {\n    const headers: Record<string, string> = {\n      'user-agent': DEFAULT_USER_AGENT,\n      accept: 'application/json, text/plain, */*',\n      referer: init.referer ?? 'https://www.bilibili.com/',\n      ...(init.headers as Record<string, string> | undefined),\n    };\n    if (init.cookie !== false) {\n      const cookie = await this.#cookie();\n      if (cookie) headers.cookie = cookie;\n    }\n    let response: Response;\n    try {\n      response = await this.#fetch(url, {\n        method: init.method ?? 'GET',\n        headers,\n        ...(init.body === undefined ? {} : { body: init.body }),\n        signal: AbortSignal.timeout(this.#timeout),\n      });\n    } catch (error) {\n      const cause = error as Error;\n      throw new BiliApiError('network', cause.name === 'TimeoutError' ? `请求超时（${this.#timeout}ms）` : `请求失败: ${cause.message}`);\n    }\n    if (response.status === 412) throw new BiliApiError('risk', 'B 站风控拦截（HTTP 412）', 412);\n    if (!response.ok) throw new BiliApiError('http', `HTTP ${response.status}`, response.status);\n    let body: unknown;\n    try {\n      body = await response.json();\n    } catch {\n      throw new BiliApiError('shape', '接口返回的不是 JSON');\n    }\n    if (!isRecord(body)) throw new BiliApiError('shape', '接口返回格式异常');\n    const code = int(body.code);\n    if (code !== 0 && !init.acceptCodes?.includes(code)) {\n      const message = str(body.message) || str(body.msg) || `错误码 ${code}`;\n      if (RISK_CODES.has(code)) {\n        this.resetSession();\n        throw new BiliApiError('risk', `B 站风控拦截（${code}: ${message}）`, code);\n      }\n      if (NOT_FOUND_CODES.has(code)) throw new BiliApiError('not_found', message, code);\n      throw new BiliApiError('http', message, code);\n    }\n    return body.data;\n  }\n\n  async #cookie(): Promise<string> {\n    if (this.#userCookie) return this.#userCookie;\n    if (this.#buvid !== undefined) return this.#buvid;\n    try {\n      const data = await this.#request('https://api.bilibili.com/x/frontend/finger/spi', { cookie: false });\n      const b3 = isRecord(data) ? str(data.b_3) : '';\n      const b4 = isRecord(data) ? str(data.b_4) : '';\n      this.#buvid = b3 ? `buvid3=${b3}${b4 ? `; buvid4=${encodeURIComponent(b4)}` : ''}` : '';\n    } catch {\n      // Device id is best effort; most endpoints still answer without it.\n      this.#buvid = '';\n    }\n    return this.#buvid;\n  }\n\n  async #wbiKey(): Promise<string> {\n    if (this.#wbi && this.#now() - this.#wbi.at < WBI_TTL_MS) return this.#wbi.key;\n    // `nav` answers -101 (not logged in) for guests but still carries wbi_img.\n    const data = await this.#request('https://api.bilibili.com/x/web-interface/nav', { acceptCodes: [-101] });\n    const img = isRecord(data) && isRecord(data.wbi_img) ? data.wbi_img : undefined;\n    const imgUrl = img ? str(img.img_url) : '';\n    const subUrl = img ? str(img.sub_url) : '';\n    if (!imgUrl || !subUrl) throw new BiliApiError('shape', '无法获取 WBI 密钥');\n    const key = mixinKey(wbiKeyFromUrl(imgUrl), wbiKeyFromUrl(subUrl));\n    this.#wbi = { key, at: this.#now() };\n    return key;\n  }\n\n  /** Batch live status by UP uid (no auth). */\n  async getLiveStatus(uids: readonly string[]): Promise<Map<string, LiveInfo>> {\n    const result = new Map<string, LiveInfo>();\n    for (let index = 0; index < uids.length; index += 50) {\n      const chunk = uids.slice(index, index + 50).map(Number);\n      const data = await this.#request('https://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids', {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify({ uids: chunk }),\n        referer: 'https://live.bilibili.com/',\n      });\n      // An empty result is serialised as [] instead of {}.\n      if (Array.isArray(data)) continue;\n      if (!isRecord(data)) throw new BiliApiError('shape', '开播状态接口格式异常');\n      for (const [key, value] of Object.entries(data)) {\n        if (!isRecord(value)) continue;\n        const uid = str(value.uid) || key;\n        const roomId = str(value.room_id);\n        result.set(uid, {\n          uid,\n          uname: str(value.uname),\n          roomId,\n          title: str(value.title),\n          liveStatus: int(value.live_status),\n          liveTime: int(value.live_time),\n          cover: str(value.cover_from_user) || str(value.keyframe),\n          area: str(value.area_v2_name) || str(value.area_name),\n          url: roomId ? `https://live.bilibili.com/${roomId}` : '',\n        });\n      }\n    }\n    return result;\n  }\n\n  async getRoomInfo(roomId: string): Promise<RoomInfo> {\n    const data = await this.#request(\n      `https://api.live.bilibili.com/room/v1/Room/get_info?room_id=${encodeURIComponent(roomId)}`,\n      { referer: 'https://live.bilibili.com/' },\n    );\n    if (!isRecord(data) || !str(data.room_id)) throw new BiliApiError('shape', '直播间接口格式异常');\n    const realId = str(data.room_id);\n    return {\n      uid: str(data.uid),\n      roomId: realId,\n      title: str(data.title),\n      liveStatus: int(data.live_status),\n      area: str(data.area_name),\n      online: int(data.online),\n      url: `https://live.bilibili.com/${realId}`,\n    };\n  }\n\n  async getUserCard(uid: string): Promise<UserCard> {\n    const data = await this.#request(`https://api.bilibili.com/x/web-interface/card?mid=${encodeURIComponent(uid)}`);\n    const card = isRecord(data) && isRecord(data.card) ? data.card : undefined;\n    if (!card) throw new BiliApiError('shape', '用户信息接口格式异常');\n    return { uid: str(card.mid) || uid, name: str(card.name) };\n  }\n\n  /** Latest space dynamics of one UP (WBI signed). Newest first, as returned. */\n  async getDynamics(uid: string): Promise<DynamicItem[]> {\n    const key = await this.#wbiKey();\n    const query = signWbi({ host_mid: uid, features: 'itemOpusStyle', ...DM_PARAMS }, key, Math.floor(this.#now() / 1000));\n    const data = await this.#request(`https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/space?${query}`, {\n      referer: `https://space.bilibili.com/${uid}/dynamic`,\n      headers: { origin: 'https://space.bilibili.com' },\n    });\n    if (!isRecord(data) || !Array.isArray(data.items)) throw new BiliApiError('shape', '动态接口格式异常');\n    const items: DynamicItem[] = [];\n    for (const raw of data.items) {\n      const item = parseDynamic(raw);\n      if (item) items.push(item);\n    }\n    return items;\n  }\n}\n\n/** Turn one raw feed item into a compact, push-ready record (undefined = skip). */\nexport function parseDynamic(raw: unknown): DynamicItem | undefined {\n  if (!isRecord(raw)) return undefined;\n  const id = str(raw.id_str);\n  if (!id) return undefined;\n  const type = str(raw.type);\n  // Live rooms are pushed by the live watcher, not as dynamics.\n  if (type === 'DYNAMIC_TYPE_LIVE_RCMD' || type === 'DYNAMIC_TYPE_LIVE') return undefined;\n  const modules = isRecord(raw.modules) ? raw.modules : {};\n  const author = isRecord(modules.module_author) ? modules.module_author : {};\n  const dynamic = isRecord(modules.module_dynamic) ? modules.module_dynamic : {};\n  const tag = isRecord(modules.module_tag) ? modules.module_tag : {};\n  const major = isRecord(dynamic.major) ? dynamic.major : {};\n  const desc = isRecord(dynamic.desc) ? str(dynamic.desc.text) : '';\n  const archive = isRecord(major.archive) ? major.archive : undefined;\n  const opus = isRecord(major.opus) ? major.opus : undefined;\n  const article = isRecord(major.article) ? major.article : undefined;\n  const opusText = opus && isRecord(opus.summary) ? str(opus.summary.text) : '';\n  const opusTitle = opus ? str(opus.title) : '';\n\n  let summary: string;\n  let url = `https://t.bilibili.com/${id}`;\n  switch (type) {\n    case 'DYNAMIC_TYPE_AV':\n      summary = `投稿了视频：${archive ? str(archive.title) : desc}`;\n      if (archive && str(archive.jump_url)) url = absoluteUrl(str(archive.jump_url));\n      break;\n    case 'DYNAMIC_TYPE_ARTICLE':\n      summary = `发布了专栏：${opusTitle || (article ? str(article.title) : '') || clip(opusText)}`;\n      break;\n    case 'DYNAMIC_TYPE_FORWARD':\n      summary = `转发了动态：${clip(desc) || '(无附言)'}`;\n      break;\n    default:\n      summary = clip(opusText || desc || opusTitle) || '发布了新动态';\n  }\n  return {\n    id,\n    author: str(author.name),\n    pubTs: int(author.pub_ts),\n    type,\n    pinned: str(tag.text) === '置顶',\n    summary,\n    url,\n  };\n}\n\n/** Accepts `123`, `UID:123`, `https://space.bilibili.com/123/...`. */\nexport function parseUid(input: string): string | undefined {\n  const text = input.trim();\n  const fromUrl = /space\\.bilibili\\.com\\/(\\d{1,20})/u.exec(text);\n  if (fromUrl) return fromUrl[1];\n  const plain = /^(?:uid[:：]?)?(\\d{1,20})$/iu.exec(text);\n  return plain?.[1];\n}\n\n/** Accepts `21452505` or `https://live.bilibili.com/21452505`. */\nexport function parseRoomId(input: string): string | undefined {\n  const text = input.trim();\n  const fromUrl = /live\\.bilibili\\.com\\/(?:h5\\/)?(\\d{1,20})/u.exec(text);\n  if (fromUrl) return fromUrl[1];\n  return /^\\d{1,20}$/u.test(text) ? text : undefined;\n}\n"]}

package/lib/channel.d.ts

@@ -0,0 +1,15 @@
+/** A subscription destination uses public Message fields, never CapabilityId internals. */
+export interface ChannelInfo {
+    adapterName: string;
+    endpointKey: string;
+    channelType: 'private' | 'group' | 'channel';
+    channelId: string;
+    senderId: string;
+}
+export declare const CHANNEL_REQUIRED_MESSAGE = "\u8BF7\u5728\u673A\u5668\u4EBA\u79C1\u804A\u3001\u7FA4\u804A\u6216\u9891\u9053\u5185\u6267\u884C\u6B64\u547D\u4EE4\uFF1B\u5F53\u524D\u8C03\u7528\u6CA1\u6709\u6709\u6548\u7684\u8BA2\u9605\u4F1A\u8BDD";
+export declare const UNSUPPORTED_ADDRESS_MESSAGE = "\u6682\u4E0D\u652F\u6301\u7EBF\u7A0B\uFF0F\u7236\u9891\u9053\u5BFB\u5740\u7684\u8BA2\u9605\uFF0C\u8BF7\u5728\u65E0\u9700\u7EBF\u7A0B\u6216\u7236\u9891\u9053\u4FE1\u606F\u7684\u4F1A\u8BDD\u5185\u6267\u884C";
+export declare function channelSourceError(input: unknown): string;
+/** No IM source means no destination; callers must not invent a global subscription. */
+export declare function extractChannelInfo(input: unknown): ChannelInfo | null;
+/** Full subscription scope, including the bot endpoint for multi-account adapters. */
+export declare function subscriptionScope(channel: ChannelInfo): Record<string, string>;

package/lib/channel.js

@@ -0,0 +1,47 @@
+/** A subscription destination uses public Message fields, never CapabilityId internals. */
+export const CHANNEL_REQUIRED_MESSAGE = '请在机器人私聊、群聊或频道内执行此命令；当前调用没有有效的订阅会话';
+export const UNSUPPORTED_ADDRESS_MESSAGE = '暂不支持线程／父频道寻址的订阅，请在无需线程或父频道信息的会话内执行';
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isIdentifier(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function hasUnsupportedAddress(input) {
+    return isRecord(input) && isRecord(input.conversation)
+        && (input.conversation.parent !== undefined || input.conversation.threadId !== undefined);
+}
+export function channelSourceError(input) {
+    return hasUnsupportedAddress(input) ? UNSUPPORTED_ADDRESS_MESSAGE : CHANNEL_REQUIRED_MESSAGE;
+}
+/** No IM source means no destination; callers must not invent a global subscription. */
+export function extractChannelInfo(input) {
+    if (!isRecord(input) || !isRecord(input.conversation))
+        return null;
+    if (hasUnsupportedAddress(input))
+        return null;
+    const conversation = input.conversation;
+    const kind = conversation.kind;
+    if (kind !== 'private' && kind !== 'group' && kind !== 'channel')
+        return null;
+    if (!isIdentifier(input.clientAdapter) || !isIdentifier(input.endpointId) || !isIdentifier(conversation.id))
+        return null;
+    const sender = input.sender;
+    return {
+        adapterName: input.clientAdapter,
+        endpointKey: input.endpointId,
+        channelType: kind,
+        channelId: conversation.id,
+        senderId: isRecord(sender) && isIdentifier(sender.id) ? sender.id : '',
+    };
+}
+/** Full subscription scope, including the bot endpoint for multi-account adapters. */
+export function subscriptionScope(channel) {
+    return {
+        adapter_name: channel.adapterName,
+        endpoint_id: channel.endpointKey,
+        channel_type: channel.channelType,
+        channel_id: channel.channelId,
+    };
+}
+//# sourceMappingURL=channel.js.map

package/lib/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAU3F,MAAM,CAAC,MAAM,wBAAwB,GAAG,mCAAmC,CAAC;AAC5E,MAAM,CAAC,MAAM,2BAA2B,GAAG,oCAAoC,CAAC;AAEhF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;WACjD,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,wBAAwB,CAAC;AAC/F,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACnE,IAAI,qBAAqB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9E,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACzH,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,aAAa;QAChC,WAAW,EAAE,KAAK,CAAC,UAAU;QAC7B,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,YAAY,CAAC,EAAE;QAC1B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;KACvE,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,OAAoB;IACpD,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,WAAW;QACjC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,OAAO,CAAC,WAAW;QACjC,UAAU,EAAE,OAAO,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC","sourcesContent":["/** A subscription destination uses public Message fields, never CapabilityId internals. */\n\nexport interface ChannelInfo {\n  adapterName: string;\n  endpointKey: string;\n  channelType: 'private' | 'group' | 'channel';\n  channelId: string;\n  senderId: string;\n}\n\nexport const CHANNEL_REQUIRED_MESSAGE = '请在机器人私聊、群聊或频道内执行此命令；当前调用没有有效的订阅会话';\nexport const UNSUPPORTED_ADDRESS_MESSAGE = '暂不支持线程／父频道寻址的订阅，请在无需线程或父频道信息的会话内执行';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isIdentifier(value: unknown): value is string {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\nfunction hasUnsupportedAddress(input: unknown): boolean {\n  return isRecord(input) && isRecord(input.conversation)\n    && (input.conversation.parent !== undefined || input.conversation.threadId !== undefined);\n}\n\nexport function channelSourceError(input: unknown): string {\n  return hasUnsupportedAddress(input) ? UNSUPPORTED_ADDRESS_MESSAGE : CHANNEL_REQUIRED_MESSAGE;\n}\n\n/** No IM source means no destination; callers must not invent a global subscription. */\nexport function extractChannelInfo(input: unknown): ChannelInfo | null {\n  if (!isRecord(input) || !isRecord(input.conversation)) return null;\n  if (hasUnsupportedAddress(input)) return null;\n  const conversation = input.conversation;\n  const kind = conversation.kind;\n  if (kind !== 'private' && kind !== 'group' && kind !== 'channel') return null;\n  if (!isIdentifier(input.clientAdapter) || !isIdentifier(input.endpointId) || !isIdentifier(conversation.id)) return null;\n  const sender = input.sender;\n  return {\n    adapterName: input.clientAdapter,\n    endpointKey: input.endpointId,\n    channelType: kind,\n    channelId: conversation.id,\n    senderId: isRecord(sender) && isIdentifier(sender.id) ? sender.id : '',\n  };\n}\n\n/** Full subscription scope, including the bot endpoint for multi-account adapters. */\nexport function subscriptionScope(channel: ChannelInfo): Record<string, string> {\n  return {\n    adapter_name: channel.adapterName,\n    endpoint_id: channel.endpointKey,\n    channel_type: channel.channelType,\n    channel_id: channel.channelId,\n  };\n}\n"]}

package/lib/config.d.ts

@@ -0,0 +1,15 @@
+/** Plugin configuration; defaults mirror schema.json. */
+export interface BilibiliConfig {
+    readonly pollCron?: string;
+    readonly jitterMs?: number;
+    readonly requestGapMs?: number;
+    readonly maxBackoffMinutes?: number;
+    readonly maxPerChannel?: number;
+    readonly timeout?: number;
+    readonly live?: boolean;
+    readonly dynamic?: boolean;
+    readonly cookie?: string;
+}
+export type ResolvedBilibiliConfig = Required<BilibiliConfig>;
+export declare const DEFAULT_BILIBILI_CONFIG: ResolvedBilibiliConfig;
+export declare function resolveBilibiliConfig(raw: unknown): ResolvedBilibiliConfig;

package/lib/config.js

@@ -0,0 +1,35 @@
+export const DEFAULT_BILIBILI_CONFIG = Object.freeze({
+    pollCron: '0 * * * * *',
+    jitterMs: 15_000,
+    requestGapMs: 1_500,
+    maxBackoffMinutes: 30,
+    maxPerChannel: 20,
+    timeout: 10_000,
+    live: true,
+    dynamic: true,
+    cookie: '',
+});
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function num(value, fallback, min, max) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    return Math.min(max, Math.max(min, value));
+}
+export function resolveBilibiliConfig(raw) {
+    const input = isRecord(raw) ? raw : {};
+    const d = DEFAULT_BILIBILI_CONFIG;
+    return {
+        pollCron: typeof input.pollCron === 'string' && input.pollCron.trim() ? input.pollCron.trim() : d.pollCron,
+        jitterMs: num(input.jitterMs, d.jitterMs, 0, 120_000),
+        requestGapMs: num(input.requestGapMs, d.requestGapMs, 0, 30_000),
+        maxBackoffMinutes: num(input.maxBackoffMinutes, d.maxBackoffMinutes, 1, 720),
+        maxPerChannel: Math.floor(num(input.maxPerChannel, d.maxPerChannel, 1, 200)),
+        timeout: num(input.timeout, d.timeout, 1_000, 60_000),
+        live: typeof input.live === 'boolean' ? input.live : d.live,
+        dynamic: typeof input.dynamic === 'boolean' ? input.dynamic : d.dynamic,
+        cookie: typeof input.cookie === 'string' ? input.cookie.trim() : d.cookie,
+    };
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,uBAAuB,GAA2B,MAAM,CAAC,MAAM,CAAC;IAC3E,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,MAAM;IAChB,YAAY,EAAE,KAAK;IACnB,iBAAiB,EAAE,EAAE;IACrB,aAAa,EAAE,EAAE;IACjB,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,EAAE;CACX,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,GAAG,CAAC,KAAc,EAAE,QAAgB,EAAE,GAAW,EAAE,GAAW;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,MAAM,CAAC,GAAG,uBAAuB,CAAC;IAClC,OAAO;QACL,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;QAC1G,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC;QACrD,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,EAAE,MAAM,CAAC;QAChE,iBAAiB,EAAE,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,EAAE,GAAG,CAAC;QAC5E,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5E,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC;QACrD,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3D,OAAO,EAAE,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;QACvE,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM;KAC1E,CAAC;AACJ,CAAC","sourcesContent":["/** Plugin configuration; defaults mirror schema.json. */\nexport interface BilibiliConfig {\n  readonly pollCron?: string;\n  readonly jitterMs?: number;\n  readonly requestGapMs?: number;\n  readonly maxBackoffMinutes?: number;\n  readonly maxPerChannel?: number;\n  readonly timeout?: number;\n  readonly live?: boolean;\n  readonly dynamic?: boolean;\n  readonly cookie?: string;\n}\n\nexport type ResolvedBilibiliConfig = Required<BilibiliConfig>;\n\nexport const DEFAULT_BILIBILI_CONFIG: ResolvedBilibiliConfig = Object.freeze({\n  pollCron: '0 * * * * *',\n  jitterMs: 15_000,\n  requestGapMs: 1_500,\n  maxBackoffMinutes: 30,\n  maxPerChannel: 20,\n  timeout: 10_000,\n  live: true,\n  dynamic: true,\n  cookie: '',\n});\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction num(value: unknown, fallback: number, min: number, max: number): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) return fallback;\n  return Math.min(max, Math.max(min, value));\n}\n\nexport function resolveBilibiliConfig(raw: unknown): ResolvedBilibiliConfig {\n  const input = isRecord(raw) ? raw : {};\n  const d = DEFAULT_BILIBILI_CONFIG;\n  return {\n    pollCron: typeof input.pollCron === 'string' && input.pollCron.trim() ? input.pollCron.trim() : d.pollCron,\n    jitterMs: num(input.jitterMs, d.jitterMs, 0, 120_000),\n    requestGapMs: num(input.requestGapMs, d.requestGapMs, 0, 30_000),\n    maxBackoffMinutes: num(input.maxBackoffMinutes, d.maxBackoffMinutes, 1, 720),\n    maxPerChannel: Math.floor(num(input.maxPerChannel, d.maxPerChannel, 1, 200)),\n    timeout: num(input.timeout, d.timeout, 1_000, 60_000),\n    live: typeof input.live === 'boolean' ? input.live : d.live,\n    dynamic: typeof input.dynamic === 'boolean' ? input.dynamic : d.dynamic,\n    cookie: typeof input.cookie === 'string' ? input.cookie.trim() : d.cookie,\n  };\n}\n"]}

package/lib/format.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicItem, LiveInfo, RoomInfo } from './api.js';
+export declare function liveStatusText(status: number): string;
+export declare function formatLiveStart(info: LiveInfo): string;
+export declare function formatDynamic(uname: string, item: DynamicItem): string;
+export declare function formatRoom(room: RoomInfo, uname: string, liveTime: number, nowMs?: number): string;

package/lib/format.js

@@ -0,0 +1,42 @@
+const LIVE_STATUS_TEXT = { 0: '未开播', 1: '直播中', 2: '轮播中' };
+export function liveStatusText(status) {
+    return LIVE_STATUS_TEXT[status] ?? `未知状态 (${status})`;
+}
+function since(liveTime, nowMs) {
+    if (liveTime <= 0)
+        return '';
+    const minutes = Math.max(0, Math.floor((nowMs / 1000 - liveTime) / 60));
+    if (minutes < 60)
+        return `已开播 ${minutes} 分钟`;
+    return `已开播 ${Math.floor(minutes / 60)} 小时 ${minutes % 60} 分钟`;
+}
+export function formatLiveStart(info) {
+    const lines = [`【开播】${info.uname || info.uid} 开播啦！`];
+    if (info.title)
+        lines.push(`标题：${info.title}`);
+    if (info.area)
+        lines.push(`分区：${info.area}`);
+    if (info.url)
+        lines.push(info.url);
+    return lines.join('\n');
+}
+export function formatDynamic(uname, item) {
+    return `【动态】${item.author || uname} ${item.summary}\n${item.url}`;
+}
+export function formatRoom(room, uname, liveTime, nowMs = Date.now()) {
+    const lines = [`${uname ? `${uname} 的直播间` : '直播间'} ${room.roomId}：${liveStatusText(room.liveStatus)}`];
+    if (room.title)
+        lines.push(`标题：${room.title}`);
+    if (room.area)
+        lines.push(`分区：${room.area}`);
+    if (room.liveStatus === 1) {
+        const elapsed = since(liveTime, nowMs);
+        if (elapsed)
+            lines.push(elapsed);
+        if (room.online > 0)
+            lines.push(`人气：${room.online}`);
+    }
+    lines.push(room.url);
+    return lines.join('\n');
+}
+//# sourceMappingURL=format.js.map

package/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAA2B,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;AAElF,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,SAAS,MAAM,GAAG,CAAC;AACxD,CAAC;AAED,SAAS,KAAK,CAAC,QAAgB,EAAE,KAAa;IAC5C,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxE,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,OAAO,OAAO,KAAK,CAAC;IAC7C,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,OAAO,GAAG,EAAE,KAAK,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,MAAM,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAiB;IAC5D,OAAO,OAAO,IAAI,CAAC,MAAM,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAc,EAAE,KAAa,EAAE,QAAgB,EAAE,QAAgB,IAAI,CAAC,GAAG,EAAE;IACpG,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACvG,IAAI,IAAI,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import type { DynamicItem, LiveInfo, RoomInfo } from './api.js';\n\nconst LIVE_STATUS_TEXT: Record<number, string> = { 0: '未开播', 1: '直播中', 2: '轮播中' };\n\nexport function liveStatusText(status: number): string {\n  return LIVE_STATUS_TEXT[status] ?? `未知状态 (${status})`;\n}\n\nfunction since(liveTime: number, nowMs: number): string {\n  if (liveTime <= 0) return '';\n  const minutes = Math.max(0, Math.floor((nowMs / 1000 - liveTime) / 60));\n  if (minutes < 60) return `已开播 ${minutes} 分钟`;\n  return `已开播 ${Math.floor(minutes / 60)} 小时 ${minutes % 60} 分钟`;\n}\n\nexport function formatLiveStart(info: LiveInfo): string {\n  const lines = [`【开播】${info.uname || info.uid} 开播啦！`];\n  if (info.title) lines.push(`标题：${info.title}`);\n  if (info.area) lines.push(`分区：${info.area}`);\n  if (info.url) lines.push(info.url);\n  return lines.join('\\n');\n}\n\nexport function formatDynamic(uname: string, item: DynamicItem): string {\n  return `【动态】${item.author || uname} ${item.summary}\\n${item.url}`;\n}\n\nexport function formatRoom(room: RoomInfo, uname: string, liveTime: number, nowMs: number = Date.now()): string {\n  const lines = [`${uname ? `${uname} 的直播间` : '直播间'} ${room.roomId}：${liveStatusText(room.liveStatus)}`];\n  if (room.title) lines.push(`标题：${room.title}`);\n  if (room.area) lines.push(`分区：${room.area}`);\n  if (room.liveStatus === 1) {\n    const elapsed = since(liveTime, nowMs);\n    if (elapsed) lines.push(elapsed);\n    if (room.online > 0) lines.push(`人气：${room.online}`);\n  }\n  lines.push(room.url);\n  return lines.join('\\n');\n}\n"]}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+export { BiliApiError, BiliClient, parseDynamic, parseRoomId, parseUid } from './api.js';
+export type { BiliClientOptions, DynamicItem, FetchLike, LiveInfo, RoomInfo, UserCard } from './api.js';
+export { DEFAULT_BILIBILI_CONFIG, resolveBilibiliConfig } from './config.js';
+export type { BilibiliConfig, ResolvedBilibiliConfig } from './config.js';
+export { mixinKey, signWbi, wbiKeyFromUrl } from './wbi.js';
+export { BILI_STATE_TABLE, BILI_SUBS_TABLE, createInMemoryBiliDb, defineBiliTables, getBiliState, getBiliSubs, } from './store.js';
+export { BilibiliWatcher, selectFreshDynamics, shouldPushLive } from './poll.js';
+export type { TickResult } from './poll.js';
+export { bilibiliRuntimeToken } from './runtime.js';
+export type { BilibiliRuntime, BiliOutboundPush } from './runtime.js';

package/lib/index.js

@@ -0,0 +1,7 @@
+export { BiliApiError, BiliClient, parseDynamic, parseRoomId, parseUid } from './api.js';
+export { DEFAULT_BILIBILI_CONFIG, resolveBilibiliConfig } from './config.js';
+export { mixinKey, signWbi, wbiKeyFromUrl } from './wbi.js';
+export { BILI_STATE_TABLE, BILI_SUBS_TABLE, createInMemoryBiliDb, defineBiliTables, getBiliState, getBiliSubs, } from './store.js';
+export { BilibiliWatcher, selectFreshDynamics, shouldPushLive } from './poll.js';
+export { bilibiliRuntimeToken } from './runtime.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzF,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { BiliApiError, BiliClient, parseDynamic, parseRoomId, parseUid } from './api.js';\nexport type { BiliClientOptions, DynamicItem, FetchLike, LiveInfo, RoomInfo, UserCard } from './api.js';\nexport { DEFAULT_BILIBILI_CONFIG, resolveBilibiliConfig } from './config.js';\nexport type { BilibiliConfig, ResolvedBilibiliConfig } from './config.js';\nexport { mixinKey, signWbi, wbiKeyFromUrl } from './wbi.js';\nexport {\n  BILI_STATE_TABLE,\n  BILI_SUBS_TABLE,\n  createInMemoryBiliDb,\n  defineBiliTables,\n  getBiliState,\n  getBiliSubs,\n} from './store.js';\nexport { BilibiliWatcher, selectFreshDynamics, shouldPushLive } from './poll.js';\nexport type { TickResult } from './poll.js';\nexport { bilibiliRuntimeToken } from './runtime.js';\nexport type { BilibiliRuntime, BiliOutboundPush } from './runtime.js';\n"]}

package/lib/permission.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Who may change a conversation's Bilibili subscriptions.
+ *
+ * - Private chat: the user manages their own conversation, no restriction.
+ * - Group or channel: only the group owner, group admins or the bot master.
+ *
+ * The rule itself lives in `canManageConversation` (`zhin.js/command`); adapters project
+ * the canonical `owner` / `admin` role names that it checks.
+ */
+export declare const SUBSCRIPTION_PERMISSION_DENIED_MESSAGE = "\u53EA\u6709\u7FA4\u4E3B\u3001\u7FA4\u7BA1\u7406\u5458\u6216\u673A\u5668\u4EBA\u4E3B\u4EBA\u53EF\u4EE5\u5728\u7FA4\u804A\u4E2D\u4FEE\u6539 B \u7AD9\u8BA2\u9605\uFF1B\u79C1\u804A\u4E2D\u53EF\u4EE5\u76F4\u63A5\u8BA2\u9605\u672C\u4F1A\u8BDD\u3002";

package/lib/permission.js

@@ -0,0 +1,11 @@
+/**
+ * Who may change a conversation's Bilibili subscriptions.
+ *
+ * - Private chat: the user manages their own conversation, no restriction.
+ * - Group or channel: only the group owner, group admins or the bot master.
+ *
+ * The rule itself lives in `canManageConversation` (`zhin.js/command`); adapters project
+ * the canonical `owner` / `admin` role names that it checks.
+ */
+export const SUBSCRIPTION_PERMISSION_DENIED_MESSAGE = '只有群主、群管理员或机器人主人可以在群聊中修改 B 站订阅；私聊中可以直接订阅本会话。';
+//# sourceMappingURL=permission.js.map

package/lib/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../src/permission.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sCAAsC,GACjD,6CAA6C,CAAC","sourcesContent":["/**\n * Who may change a conversation's Bilibili subscriptions.\n *\n * - Private chat: the user manages their own conversation, no restriction.\n * - Group or channel: only the group owner, group admins or the bot master.\n *\n * The rule itself lives in `canManageConversation` (`zhin.js/command`); adapters project\n * the canonical `owner` / `admin` role names that it checks.\n */\nexport const SUBSCRIPTION_PERMISSION_DENIED_MESSAGE =\n  '只有群主、群管理员或机器人主人可以在群聊中修改 B 站订阅；私聊中可以直接订阅本会话。';\n"]}