@laplace.live/internal 1.2.32 → 1.2.33

package/index.d.ts

@@ -970,6 +970,80 @@ export declare namespace LaplaceInternal {
         rejected: number
         total: number
       }
+
+      // ============================================
+      // Guild History Types
+      // ============================================
+
+      /**
+       * A single guild history entry - tracks each guild membership change
+       * Stored in the `guildInfo.history` JSONB column on bilibili_users table
+       */
+      export interface GuildHistoryItem {
+        /** Guild name */
+        name: string
+        /** Unix timestamp (ms) - when this guild membership was recorded */
+        updatedAt: number
+      }
+
+      /**
+       * Response for GET /laplace/guild-entry/:uid
+       * Returns guild history for a specific user
+       */
+      export interface GuildHistoryResponse {
+        success: true
+        uid: number
+        user: {
+          id: number
+          username: string
+          avatar: string | null
+          room: number | null
+        }
+        history: GuildHistoryItem[]
+        historyCount: number
+      }
+
+      /**
+       * Request body for POST /laplace/guild-entry/:uid
+       * Adds a new guild history entry
+       */
+      export interface GuildEntryAddRequest {
+        /** Guild name (max 100 chars, no special characters) */
+        name: string
+        /** Optional: Unix timestamp (ms) - defaults to current time */
+        updatedAt?: number
+      }
+
+      /**
+       * Request body for PATCH /laplace/guild-entry/:uid
+       * Updates a specific guild history entry identified by originalUpdatedAt
+       */
+      export interface GuildEntryUpdateRequest {
+        /** Required: updatedAt of the entry to update (identifier) */
+        originalUpdatedAt: number
+        /** Optional: New guild name */
+        name?: string
+        /** Optional: New timestamp (Unix timestamp ms) */
+        updatedAt?: number
+      }
+
+      /**
+       * Request body for DELETE /laplace/guild-entry/:uid
+       * Deletes a specific guild history entry identified by updatedAt
+       */
+      export interface GuildEntryDeleteRequest {
+        /** Required: updatedAt of the entry to delete */
+        updatedAt: number
+      }
+
+      /**
+       * Response for POST/PATCH/DELETE /laplace/guild-entry/:uid
+       */
+      export interface GuildEntryActionResponse {
+        success: true
+        uid: number
+        historyCount: number
+      }
     }
 
     /** Migrated from experiments.sparanoid.net */

package/package.json

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