SnowLuma v2.4.2 source snapshot

packages/protocol/tests/oidb-services/interaction/send-like.test.ts

@@ -0,0 +1,65 @@
+import { describe, expect, it, vi } from 'vitest';
+import { protobuf_decode } from '@snowluma/proton';
+import type { OidbBase } from '@snowluma/proto-defs/oidb';
+import type { OidbLike } from '@snowluma/proto-defs/oidb-actions/base';
+import type { SendPacketResult } from '@snowluma/common/packet-sender';
+
+import { SendLike } from '../../../src/oidb-services/interaction/send-like';
+
+function makeDeps(uid = 'target-uid-xyz') {
+    const r: SendPacketResult = {
+        success: true,
+        gotResponse: true,
+        errorCode: 0,
+        errorMessage: '',
+        responseData: Buffer.alloc(0),
+    };
+    return {
+        sendRawPacket: vi.fn(async () => r),
+        resolveUserUid: vi.fn(async () => uid),
+    };
+}
+
+describe('SendLike namespace', () => {
+    it('declares 0x7E5_104', () => {
+        expect(SendLike.command).toBe(0x7e5);
+        expect(SendLike.subCommand).toBe(104);
+    });
+
+    describe('serialize', () => {
+        it('resolves uid via ctx and emits {targetUid, sourceId=71, count}', async () => {
+            const deps = makeDeps('UID-AAA');
+            const body = await SendLike.serialize(deps, { userId: 10001, count: 3 });
+            expect(deps.resolveUserUid).toHaveBeenCalledWith(10001);
+            expect(body).toEqual({ targetUid: 'UID-AAA', sourceId: 71, count: 3 });
+        });
+
+        it('throws when ctx returns an empty uid', async () => {
+            const deps = makeDeps('');
+            await expect(SendLike.serialize(deps, { userId: 10001, count: 1 })).rejects.toThrow(
+                /failed to resolve uid/,
+            );
+        });
+    });
+
+    describe('invoke (e2e)', () => {
+        it('routes to OidbSvcTrpcTcp.0x7e5_104', async () => {
+            const deps = makeDeps();
+            await SendLike.invoke(deps, { userId: 10001, count: 3 });
+            expect(deps.sendRawPacket.mock.calls[0]![0]).toBe('OidbSvcTrpcTcp.0x7e5_104');
+        });
+
+        it('encodes targetUid (field 11) + sourceId=71 (field 12) + count (field 13)', async () => {
+            const deps = makeDeps('UID-BBB');
+            await SendLike.invoke(deps, { userId: 10001, count: 5 });
+            const [, bytes] = deps.sendRawPacket.mock.calls[0]!;
+            const env = protobuf_decode<OidbBase<OidbLike>>(bytes);
+            expect(env.command).toBe(0x7e5);
+            expect(env.subCommand).toBe(104);
+            expect(env.body).toMatchObject({ targetUid: 'UID-BBB', sourceId: 71, count: 5 });
+            // Defensive: the obsolete uin-form field must not appear (server
+            // rejects uin-form payloads with "被点赞 QQ 号非法").
+            expect((env.body as any).targetUin).toBeUndefined();
+        });
+    });
+});

packages/protocol/tests/oidb-services/interaction/send-poke.test.ts

@@ -0,0 +1,98 @@
+import { describe, expect, it, vi } from 'vitest';
+import { protobuf_decode } from '@snowluma/proton';
+import type { OidbBase } from '@snowluma/proto-defs/oidb';
+import type { OidbPoke } from '@snowluma/proto-defs/oidb-actions/base';
+import type { SendPacketResult } from '@snowluma/common/packet-sender';
+
+import { SendPoke } from '../../../src/oidb-services/interaction/send-poke';
+
+function makeSender() {
+    const r: SendPacketResult = {
+        success: true,
+        gotResponse: true,
+        errorCode: 0,
+        errorMessage: '',
+        responseData: Buffer.alloc(0),
+    };
+    return { sendRawPacket: vi.fn(async () => r) };
+}
+
+describe('SendPoke namespace', () => {
+    it('declares 0xED3_1', () => {
+        expect(SendPoke.command).toBe(0xed3);
+        expect(SendPoke.subCommand).toBe(1);
+    });
+
+    describe('serialize', () => {
+        it('group poke: groupUin = peer, friendUin = 0, uin = targetUin', () => {
+            expect(
+                SendPoke.serialize({} as any, { isGroup: true, peerUin: 12345, targetUin: 67890 }),
+            ).toEqual({
+                uin: 67890,
+                groupUin: 12345,
+                friendUin: 0,
+                ext: 0,
+            });
+        });
+
+        it('group poke without targetUin: uin defaults to peer', () => {
+            expect(SendPoke.serialize({} as any, { isGroup: true, peerUin: 12345 })).toEqual({
+                uin: 12345,
+                groupUin: 12345,
+                friendUin: 0,
+                ext: 0,
+            });
+        });
+
+        it('friend poke: friendUin = peer, groupUin = 0, uin = targetUin', () => {
+            expect(
+                SendPoke.serialize({} as any, { isGroup: false, peerUin: 67890, targetUin: 11111 }),
+            ).toEqual({
+                uin: 11111,
+                groupUin: 0,
+                friendUin: 67890,
+                ext: 0,
+            });
+        });
+
+        it('friend poke without targetUin: uin defaults to peer', () => {
+            expect(SendPoke.serialize({} as any, { isGroup: false, peerUin: 67890 })).toEqual({
+                uin: 67890,
+                groupUin: 0,
+                friendUin: 67890,
+                ext: 0,
+            });
+        });
+
+        it('always sets ext = 0', () => {
+            expect(SendPoke.serialize({} as any, { isGroup: true, peerUin: 1 }).ext).toBe(0);
+            expect(SendPoke.serialize({} as any, { isGroup: false, peerUin: 1 }).ext).toBe(0);
+        });
+    });
+
+    describe('invoke (e2e)', () => {
+        it('routes to OidbSvcTrpcTcp.0xed3_1', async () => {
+            const sender = makeSender();
+            await SendPoke.invoke(sender, { isGroup: true, peerUin: 1 });
+            expect(sender.sendRawPacket.mock.calls[0]![0]).toBe('OidbSvcTrpcTcp.0xed3_1');
+        });
+
+        it('encodes serialize() output into envelope body', async () => {
+            const sender = makeSender();
+            await SendPoke.invoke(sender, { isGroup: true, peerUin: 12345, targetUin: 67890 });
+            const [, bytes] = sender.sendRawPacket.mock.calls[0]!;
+            const env = protobuf_decode<OidbBase<OidbPoke>>(bytes);
+            expect(env.command).toBe(0xed3);
+            expect(env.subCommand).toBe(1);
+            expect(env.body).toMatchObject({ uin: 67890, groupUin: 12345 });
+            // proto3 default 0 for friendUin/ext is omitted on the wire.
+            expect(env.body?.friendUin ?? 0).toBe(0);
+        });
+
+        it('resolves to undefined', async () => {
+            const sender = makeSender();
+            const result = await SendPoke.invoke(sender, { isGroup: false, peerUin: 1 });
+            expect(result).toBeUndefined();
+        });
+    });
+});

packages/protocol/tests/oidb-services/interaction/set-essence.test.ts

@@ -0,0 +1,93 @@
+import { describe, expect, it, vi } from 'vitest';
+import { protobuf_decode } from '@snowluma/proton';
+import type { OidbBase } from '@snowluma/proto-defs/oidb';
+import type { OidbEssence } from '@snowluma/proto-defs/oidb-actions/base';
+import type { SendPacketResult } from '@snowluma/common/packet-sender';
+
+import { SetEssence } from '../../../src/oidb-services/interaction/set-essence';
+
+function makeSender() {
+    const r: SendPacketResult = {
+        success: true,
+        gotResponse: true,
+        errorCode: 0,
+        errorMessage: '',
+        responseData: Buffer.alloc(0),
+    };
+    return { sendRawPacket: vi.fn(async () => r) };
+}
+
+describe('SetEssence namespace', () => {
+    it('declares 0xEAC', () => {
+        expect(SetEssence.command).toBe(0xeac);
+    });
+
+    describe('resolveSubCommand', () => {
+        it('returns 1 when enable=true', () => {
+            expect(
+                SetEssence.resolveSubCommand({ groupId: 1, sequence: 1, random: 1, enable: true }),
+            ).toBe(1);
+        });
+        it('returns 2 when enable=false', () => {
+            expect(
+                SetEssence.resolveSubCommand({ groupId: 1, sequence: 1, random: 1, enable: false }),
+            ).toBe(2);
+        });
+    });
+
+    describe('serialize', () => {
+        it('passes groupId / sequence / random through verbatim', () => {
+            expect(
+                SetEssence.serialize({} as any, {
+                    groupId: 12345,
+                    sequence: 99,
+                    random: 0xcafebabe,
+                    enable: true,
+                }),
+            ).toEqual({
+                groupUin: 12345,
+                sequence: 99,
+                random: 0xcafebabe,
+            });
+        });
+    });
+
+    describe('invoke (e2e)', () => {
+        it('routes to OidbSvcTrpcTcp.0xeac_1 when enabling', async () => {
+            const sender = makeSender();
+            await SetEssence.invoke(sender, {
+                groupId: 12345,
+                sequence: 99,
+                random: 0,
+                enable: true,
+            });
+            expect(sender.sendRawPacket.mock.calls[0]![0]).toBe('OidbSvcTrpcTcp.0xeac_1');
+        });
+
+        it('routes to OidbSvcTrpcTcp.0xeac_2 when disabling', async () => {
+            const sender = makeSender();
+            await SetEssence.invoke(sender, {
+                groupId: 12345,
+                sequence: 99,
+                random: 0,
+                enable: false,
+            });
+            expect(sender.sendRawPacket.mock.calls[0]![0]).toBe('OidbSvcTrpcTcp.0xeac_2');
+        });
+
+        it('encodes envelope body with the right shape', async () => {
+            const sender = makeSender();
+            await SetEssence.invoke(sender, {
+                groupId: 12345,
+                sequence: 99,
+                random: 7,
+                enable: true,
+            });
+            const [, bytes] = sender.sendRawPacket.mock.calls[0]!;
+            const env = protobuf_decode<OidbBase<OidbEssence>>(bytes);
+            expect(env.command).toBe(0xeac);
+            expect(env.subCommand).toBe(1);
+            expect(env.body).toMatchObject({ groupUin: 12345, sequence: 99, random: 7 });
+        });
+    });
+});