@laplace.live/internal 1.2.37 → 1.2.39

package/index.d.ts

@@ -524,6 +524,18 @@ export declare namespace LaplaceInternal {
             updatedAt: number
           }[]
         } | null
+        /** MCN 机构详细信息 (mcnId is internal-only, not exposed in public API) */
+        mcnInfo: {
+          history: {
+            /** MCN agency name */
+            mcnName: string
+            /** Unix timestamp
+             *
+             * @example 1758039520166
+             */
+            updatedAt: number
+          }[]
+        } | null
       }
 
       /**
@@ -1010,6 +1022,23 @@ export declare namespace LaplaceInternal {
         updatedAt: number
       }
 
+      // ============================================
+      // MCN History Types
+      // ============================================
+
+      /**
+       * A single MCN agency history entry - tracks each MCN membership change
+       * Stored in the `mcnInfo.history` JSONB column on bilibili_users table
+       */
+      export interface McnHistoryItem {
+        /** MCN agency ID */
+        mcnId: number
+        /** MCN agency name */
+        mcnName: string
+        /** Unix timestamp (ms) - when this MCN membership was recorded */
+        updatedAt: number
+      }
+
       /**
        * Response for GET /laplace/guild-entry/:uid
        * Returns guild history for a specific user
@@ -1068,6 +1097,48 @@ export declare namespace LaplaceInternal {
         uid: number
         historyCount: number
       }
+
+      // ============================================
+      // MCN Batch Update Types
+      // ============================================
+
+      /**
+       * A single entry in the MCN batch update request
+       * Maps to the raw export format from the MCN agency data (laplace-scripts)
+       */
+      export interface McnBatchUpdateEntry {
+        /** User's Bilibili UID (maps to bilibili_users.id) */
+        upper_mid: number
+        /** MCN agency ID */
+        mcn_id: number
+        /** MCN agency company name */
+        mcn_company_name: string
+      }
+
+      /**
+       * Request body for POST /laplace/mcn-update
+       * Batch updates MCN info for multiple users (max 10,000 entries)
+       */
+      export interface McnBatchUpdateRequest {
+        entries: McnBatchUpdateEntry[]
+      }
+
+      /**
+       * Response for POST /laplace/mcn-update
+       */
+      export interface McnBatchUpdateResponse {
+        success: true
+        /** Total entries received */
+        total: number
+        /** Users whose mcnInfo was changed (new MCN or MCN change) */
+        updated: number
+        /** Users whose MCN matched the latest history entry (no-op) */
+        unchanged: number
+        /** UIDs not found in bilibili_users */
+        skipped: number
+        /** List of missing UIDs */
+        skippedUids: number[]
+      }
     }
 
     /** Migrated from experiments.sparanoid.net */

package/package.json

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