@laplace.live/internal 1.2.31 → 1.2.33

package/index.d.ts

@@ -814,6 +814,45 @@ export declare namespace LaplaceInternal {
         lastPeriodStart: string
       }
 
+      // ============================================
+      // Fertility Cycle Entry Management (Admin)
+      // ============================================
+
+      /**
+       * Request body for PATCH /laplace/fertility-entry/:uid
+       * Updates a specific history entry identified by originalPeriodStart
+       */
+      export interface FertilityEntryUpdateRequest {
+        /** Required: periodStart of the entry to update (identifier) */
+        originalPeriodStart: number
+        /** Optional: New periodStart value (Unix timestamp ms) */
+        periodStart?: number
+        /** Optional: Period length (1-15 days), or null to clear */
+        periodLength?: number | null
+        /** Optional: Evidence URL, or null to clear */
+        source?: string | null
+      }
+
+      /**
+       * Request body for DELETE /laplace/fertility-entry/:uid
+       * Deletes a specific history entry identified by periodStart
+       */
+      export interface FertilityEntryDeleteRequest {
+        /** Required: periodStart of the entry to delete */
+        periodStart: number
+      }
+
+      /**
+       * Response for PATCH/DELETE /laplace/fertility-entry/:uid
+       */
+      export interface FertilityEntryActionResponse {
+        success: true
+        uid: number
+        historyCount: number
+        /** ISO timestamp string */
+        lastPeriodStart: string
+      }
+
       // ============================================
       // Fertility Contribution Types (Anonymous Submissions)
       // ============================================
@@ -931,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.31",
+  "version": "1.2.33",
   "module": "index.d.ts",
   "devDependencies": {
     "@types/bun": "latest"