@laplace.live/internal 1.2.45 → 1.2.47

package/index.d.ts

@@ -540,6 +540,62 @@ export declare namespace LaplaceInternal {
         tags?: LaplaceInternal.HTTPS.Workers.TagWithCount[]
       }
 
+      /**
+       * 列表哔哩哔哩用户（分页）
+       * @link /laplace/bilibili-users
+       *
+       * Query params:
+       * - `?page=1` — page number (min 1, default 1)
+       * - `?pageSize=100` — items per page (1–500, default 100)
+       * - `?all=true` — return all rows without pagination
+       * - `?tags=1,2,3` — filter to users who have all listed tag IDs (AND)
+       */
+      export interface ListBilibiliUsers {
+        data: ListBilibiliUsersItem[]
+        total: number
+      }
+
+      /**
+       * Single user item returned by the list endpoint.
+       *
+       * Differs from {@link BilibiliUser} (single-user endpoint) because the list
+       * query returns raw DB rows without relation joins or sanitization:
+       * - `guild` is a raw numeric FK (not a resolved name string)
+       * - `tags` is a raw `int[]` (not resolved {@link TagWithCount} objects)
+       * - `mcnInfo.history` entries include `mcnId` (stripped in single-user endpoint)
+       * - No `guildDetails` relation (only present when joined via single-user query)
+       */
+      export interface ListBilibiliUsersItem {
+        id: number
+        room: number | null
+        username: string
+        liveFansCount: number | null
+        liveFansMedal: string | null
+        liveStatus: number | null
+        /** @deprecated use `guildInfo` instead */
+        guild: number | null
+        avatar: string | null
+        guildInfo: {
+          history: {
+            name: string
+            /** Unix timestamp */
+            updatedAt: number
+          }[]
+        } | null
+        mcnInfo: {
+          history: {
+            mcnId: number
+            mcnName: string
+            /** Unix timestamp */
+            updatedAt: number
+          }[]
+        } | null
+        /** Raw integer tag IDs assigned to this user */
+        tags: number[] | null
+        /** ISO 8601 timestamp */
+        updatedAt: string
+      }
+
       // ============================================
       // Tag Types
       // ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/internal",
-  "version": "1.2.45",
+  "version": "1.2.47",
   "module": "index.d.ts",
   "devDependencies": {
     "@types/bun": "latest"