@hlw-zbzs/gift 1.0.1

package/index.ts

@@ -0,0 +1,7 @@
+/**
+ * @file @hlw-zbzs/gift - 多平台直播礼物数据与查询工具包
+ */
+
+export type * from './types'
+export * from './src/platforms'
+export * from './src/core'

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@hlw-zbzs/gift",
+  "version": "1.0.1",
+  "description": "Multi-Platform Live Stream Gift Data and Utilities (Douyin, Kuaishou, WeChat Channels, Bilibili, TikTok)",
+  "main": "index.ts",
+  "types": "index.ts",
+  "exports": {
+    ".": {
+      "types": "./index.ts",
+      "import": "./index.ts",
+      "require": "./index.ts",
+      "default": "./index.ts"
+    },
+    "./dy": {
+      "types": "./src/platforms/dy.ts",
+      "import": "./src/platforms/dy.ts",
+      "require": "./src/platforms/dy.ts",
+      "default": "./src/platforms/dy.ts"
+    },
+    "./ks": {
+      "types": "./src/platforms/ks.ts",
+      "import": "./src/platforms/ks.ts",
+      "require": "./src/platforms/ks.ts",
+      "default": "./src/platforms/ks.ts"
+    },
+    "./sph": {
+      "types": "./src/platforms/sph.ts",
+      "import": "./src/platforms/sph.ts",
+      "require": "./src/platforms/sph.ts",
+      "default": "./src/platforms/sph.ts"
+    },
+    "./bili": {
+      "types": "./src/platforms/bili.ts",
+      "import": "./src/platforms/bili.ts",
+      "require": "./src/platforms/bili.ts",
+      "default": "./src/platforms/bili.ts"
+    },
+    "./tk": {
+      "types": "./src/platforms/tk.ts",
+      "import": "./src/platforms/tk.ts",
+      "require": "./src/platforms/tk.ts",
+      "default": "./src/platforms/tk.ts"
+    },
+    "./*": {
+      "types": "./src/*.ts",
+      "import": "./src/*.ts",
+      "require": "./src/*.ts",
+      "default": "./src/*.ts"
+    }
+  },
+  "files": [
+    "index.ts",
+    "src/"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.14.1",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}

package/src/core.ts

@@ -0,0 +1,93 @@
+/**
+ * @file 礼物数据管理与查询工具模块
+ */
+
+import type { PlatformType, GiftItem } from './types'
+import { PLATFORM_GIFTS } from './platforms'
+
+const giftMap = new Map<PlatformType, Map<string | number, GiftItem>>()
+const nameMap = new Map<PlatformType, Map<string, GiftItem>>()
+
+function initStore() {
+	for (const [platform, gifts] of Object.entries(PLATFORM_GIFTS)) {
+		const pKey = platform as PlatformType
+		const idLookup = new Map<string | number, GiftItem>()
+		const nameLookup = new Map<string, GiftItem>()
+
+		for (const gift of gifts) {
+			idLookup.set(gift.id, gift)
+			idLookup.set(String(gift.id), gift)
+			nameLookup.set(gift.name, gift)
+		}
+
+		giftMap.set(pKey, idLookup)
+		nameMap.set(pKey, nameLookup)
+	}
+}
+
+initStore()
+
+/**
+ * 获取指定平台的礼物列表
+ */
+export function getGifts(platform: PlatformType = 'dy'): GiftItem[] {
+	return PLATFORM_GIFTS[platform] || []
+}
+
+/**
+ * 根据 ID 查询礼物
+ */
+export function getById(id: number | string, platform: PlatformType = 'dy'): GiftItem | undefined {
+	const map = giftMap.get(platform)
+	return map?.get(id) || map?.get(String(id))
+}
+
+/**
+ * 根据礼物名称查询礼物
+ */
+export function getByName(name: string, platform: PlatformType = 'dy'): GiftItem | undefined {
+	const map = nameMap.get(platform)
+	return map?.get(name)
+}
+
+/**
+ * 智能查找礼物 (优先ID，其次名称)
+ */
+export function findGift(query: number | string, platform: PlatformType = 'dy'): GiftItem | undefined {
+	if (query === undefined || query === null || query === '') return undefined
+	const map = giftMap.get(platform)
+	const byId = map?.get(query) || map?.get(String(query))
+	if (byId) return byId
+	if (typeof query === 'string') {
+		return nameMap.get(platform)?.get(query)
+	}
+	return undefined
+}
+
+/**
+ * 关键字搜索礼物列表
+ */
+export function searchGifts(keyword: string, platform: PlatformType = 'dy'): GiftItem[] {
+	if (!keyword) return getGifts(platform)
+	const kw = keyword.toLowerCase().trim()
+	const gifts = getGifts(platform)
+	return gifts.filter((item) => item.name.toLowerCase().includes(kw))
+}
+
+/**
+ * 动态注册或覆盖平台礼物数据
+ */
+export function setGifts(platform: PlatformType, gifts: GiftItem[]): void {
+	PLATFORM_GIFTS[platform] = gifts
+	const idLookup = new Map<string | number, GiftItem>()
+	const nameLookup = new Map<string, GiftItem>()
+
+	for (const gift of gifts) {
+		idLookup.set(gift.id, gift)
+		idLookup.set(String(gift.id), gift)
+		nameLookup.set(gift.name, gift)
+	}
+
+	giftMap.set(platform, idLookup)
+	nameMap.set(platform, nameLookup)
+}

package/src/data/bili.json

@@ -0,0 +1,62 @@
+[
+  {
+    "id": 31036,
+    "name": "小花花",
+    "price": 1,
+    "image": "https://s1.hdslb.com/bfs/live/8b40d0470890e7d573995383af8a8ae074d485d9.png"
+  },
+  {
+    "id": 31164,
+    "name": "粉丝团灯牌",
+    "price": 1,
+    "image": "https://s1.hdslb.com/bfs/live/e051dfd4557678f8edcac4993ed00a0935cbd9cc.png"
+  },
+  {
+    "id": 1,
+    "name": "辣条",
+    "price": 1,
+    "image": "https://s1.hdslb.com/bfs/live/8b40d0470890e7d573995383af8a8ae074d485d9.png"
+  },
+  {
+    "id": 34315,
+    "name": "喜欢你",
+    "price": 99,
+    "image": "https://s1.hdslb.com/bfs/live/5d940270c22a17fa2ff17a0713b4383b6febd945.png"
+  },
+  {
+    "id": 31122,
+    "name": "星愿水晶球",
+    "price": 1000,
+    "image": "https://s1.hdslb.com/bfs/live/288536798081e855e8f645bed6a2d2d27f411ee5.png"
+  },
+  {
+    "id": 10003,
+    "name": "舰长",
+    "price": 1980,
+    "image": "https://i0.hdslb.com/bfs/activity-plat/static/20220125/7f8dc1e417a6c1d6a509a66770dc060e/ohMHzbhJdN.png"
+  },
+  {
+    "id": 35566,
+    "name": "落日飞车",
+    "price": 2000,
+    "image": "https://s1.hdslb.com/bfs/live/93939d794de3e967b8564dc46487097124a192a0.png"
+  },
+  {
+    "id": 34998,
+    "name": "小电视飞船",
+    "price": 29990,
+    "image": "https://s1.hdslb.com/bfs/live/48884b1b1d3bf9df185f43ff6651748040faf5de.png"
+  },
+  {
+    "id": 10002,
+    "name": "提督",
+    "price": 19980,
+    "image": "https://i0.hdslb.com/bfs/activity-plat/static/20220125/7f8dc1e417a6c1d6a509a66770dc060e/ohMHzbhJdN.png"
+  },
+  {
+    "id": 10001,
+    "name": "总督",
+    "price": 199980,
+    "image": "https://i0.hdslb.com/bfs/activity-plat/static/20220125/7f8dc1e417a6c1d6a509a66770dc060e/ohMHzbhJdN.png"
+  }
+]