Files
SnowLuma/packages/onebot/tests/flash-file-segment.test.ts
T
DrSmoothl 770b224d58 feat(onebot): decode incoming 闪传 flash-file messages (#199/#200)
Older QQ clients (≤9.9.30) deliver a 闪传 (flash transfer) file as a richui
markdown commonElem (svc=45, busId=FlashTransfer); SnowLuma had no decoder for
it, so the message decoded to 0 elements and was reported empty. (Newer
clients ≥9.9.31 send a plain text+link message that already decodes fine.)

Decode svc=45 markdown → parse the FlashTransfer card JSON → emit a flash_file
element, surfaced as the segment the issue asked for:
  { type: "flash_file", data: { title, file_set_id, scene_type } }

- Field names (fileSetId / sceneType / title) confirmed against QQ NT's
  flash-transfer manager in wrapper.node.i64. The card is built by the
  sender's client so the exact JSON nesting is unknown — values are pulled by
  a bounded recursive search rather than a pinned path (handles either shape).
- Non-FlashTransfer markdown is ignored; missing fields default (never empty).
- Manifest: D/S = yes, P/W = by-design-no (receive-only; sending is the
  existing send_flash_msg action). Log preview shows [闪传文件:title].
- Tests: card decode (nested + alias + defaults + non-flash) and the
  element→segment mapping.

Note: not end-to-end verified on a live message — the svc=45 format only comes
from ≤9.9.30 senders and no such client was available (every test sender here
is ≥9.9.31 → text format). Logic + field names are unit-tested / IDA-confirmed.

typecheck 12 包; protocol 596 / onebot 529 green.
2026-07-04 19:02:47 +08:00

23 lines
1.2 KiB
TypeScript

import { describe, expect, it } from 'vitest';
import { ELEMENT_CODECS } from '../src/event-converter/element-codecs';
import type { MessageElement } from '@snowluma/protocol/events';
// The receive-side flash_file codec (#199/#200). Sending is a separate action
// (send_flash_msg), so there is no fromSegment.
describe('flash_file element → OneBot segment (#199/#200)', () => {
it('maps filesetId/fileName/sceneType → file_set_id/title/scene_type', async () => {
const el: MessageElement = { type: 'flash_file', filesetId: 'fs-1', fileName: 'a.pdf', sceneType: 2 };
const seg = await ELEMENT_CODECS.flash_file!.toSegment!(el, {} as never);
expect(seg).toEqual({ type: 'flash_file', data: { title: 'a.pdf', file_set_id: 'fs-1', scene_type: 2 } });
});
it('defaults missing fields to empty / 0', async () => {
const seg = await ELEMENT_CODECS.flash_file!.toSegment!({ type: 'flash_file' } as MessageElement, {} as never);
expect(seg).toEqual({ type: 'flash_file', data: { title: '', file_set_id: '', scene_type: 0 } });
});
it('is receive-only (no fromSegment)', () => {
expect(ELEMENT_CODECS.flash_file!.fromSegment).toBeUndefined();
});
});