@laplace.live/internal 1.2.18 → 1.2.20

package/index.d.ts

@@ -658,6 +658,131 @@ export declare namespace LaplaceInternal {
         uid?: number
         details?: string
       }
+
+      // ============================================
+      // Fertility Cycle Types
+      // ============================================
+
+      /**
+       * Fertility status enum values
+       *
+       * @since Jan 29, 2026
+       * @example GET /bilibili/fertility/:uid
+       * @example GET /bilibili/fertilities
+       */
+      export type FertilityStatus = 'menstruating' | 'fertile' | 'ovulating' | 'normal'
+
+      /**
+       * A single cycle history entry - tracks each period event
+       * Stored in the `cycleHistory` JSONB column
+       */
+      export interface CycleHistoryItem {
+        /** Unix timestamp (ms) - when this period started */
+        periodStart: number
+        /** Optional: days this period lasted (user may not track) */
+        periodLength?: number
+        /** Unix timestamp (ms) - when this entry was recorded */
+        submittedAt: number
+        /** Optional: URL or description of the evidence source (e.g., livestream clip, tweet) */
+        source?: string
+      }
+
+      /**
+       * Result of fertility status calculation
+       * Returned by calculateFertilityStatus utility
+       */
+      export interface CycleCalculationResult {
+        status: FertilityStatus
+        /** Current day in the menstrual cycle (1-indexed) */
+        dayInCycle: number
+        /** Calculated from history or user-stated preference */
+        effectiveCycleLength: number
+        /** Calculated from history or user-stated preference */
+        effectivePeriodLength: number
+        /** Calculated ovulation day (cycleLength - 14) */
+        ovulationDay: number
+        /** Predicted next period start date */
+        nextPeriod: Date
+        /** How many history entries used for calculation */
+        dataPoints: number
+      }
+
+      /**
+       * Response for GET /bilibili/fertility/:uid
+       */
+      export interface FertilityUserResponse {
+        uid: number
+        user: {
+          username: string
+          avatar: string | null
+          room: number | null
+        } | null
+        status: FertilityStatus
+        dayInCycle: number
+        ovulationDay: number
+        /** ISO date string (YYYY-MM-DD) */
+        nextPeriod: string
+        effectiveCycleLength: number
+        effectivePeriodLength: number
+        dataPoints: number
+        userPreferences: {
+          cycleLength: number
+          periodLength: number
+        }
+        history: CycleHistoryItem[]
+      }
+
+      /**
+       * Single user item in list response
+       * @example GET /bilibili/fertilities
+       */
+      export interface FertilityListItem {
+        uid: number
+        user: {
+          username: string
+          avatar: string | null
+          room: number | null
+        } | null
+        status: FertilityStatus
+        dayInCycle: number
+        /** ISO date string (YYYY-MM-DD) */
+        nextPeriod: string
+      }
+
+      /**
+       * Response for GET /bilibili/fertilities
+       */
+      export interface FertilityListResponse {
+        data: FertilityListItem[]
+        total: number
+      }
+
+      /**
+       * Request body for POST /bilibili/fertility-submit
+       */
+      export interface FertilitySubmitRequest {
+        /** Bilibili user ID */
+        uid: number
+        /** Unix timestamp (ms) when period started */
+        periodStart: number
+        /** Optional: How many days this period lasted (1-15) */
+        periodLength?: number
+        /** Optional: Update user's preferred cycle length (15-60) */
+        cycleLength?: number
+        /** Optional: URL or description of the evidence source */
+        source?: string
+      }
+
+      /**
+       * Success response for POST /bilibili/fertility-submit
+       */
+      export interface FertilitySubmitResponse {
+        success: true
+        uid: number
+        historyCount: number
+        /** ISO timestamp string */
+        lastPeriodStart: string
+      }
     }
 
     /** Migrated from experiments.sparanoid.net */

package/package.json

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