@laplace.live/internal 1.2.20 → 1.2.21

package/index.d.ts

@@ -769,7 +769,7 @@ export declare namespace LaplaceInternal {
         periodLength?: number
         /** Optional: Update user's preferred cycle length (15-60) */
         cycleLength?: number
-        /** Optional: URL or description of the evidence source */
+        /** Optional: Evidence URL (must be a valid URL, max 256 chars) */
         source?: string
       }
 
@@ -783,6 +783,87 @@ export declare namespace LaplaceInternal {
         /** ISO timestamp string */
         lastPeriodStart: string
       }
+
+      // ============================================
+      // Fertility Contribution Types (Anonymous Submissions)
+      // ============================================
+
+      /**
+       * Status of a fertility contribution
+       */
+      export type ContributionStatus = 'pending' | 'approved' | 'rejected'
+
+      /**
+       * Request body for POST /laplace/fertility-contribute
+       * Anonymous users submit period data with Turnstile verification
+       */
+      export interface FertilityContributeRequest {
+        /** 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: Evidence URL (must be a valid URL, max 500 chars) */
+        source?: string
+        /** Cloudflare Turnstile token for bot verification */
+        turnstileToken: string
+      }
+
+      /**
+       * A fertility contribution record
+       * Returned by GET /laplace/fertility-contributions
+       */
+      export interface FertilityContribution {
+        id: number
+        uid: number
+        periodStart: number
+        periodLength?: number
+        cycleLength?: number
+        source?: string
+        status: ContributionStatus
+        contributorIp?: string
+        /** ISO timestamp string */
+        createdAt: string
+        /** ISO timestamp string */
+        reviewedAt?: string
+        rejectReason?: string
+      }
+
+      /**
+       * Response for GET /laplace/fertility-contributions
+       */
+      export interface FertilityContributionsListResponse {
+        data: FertilityContribution[]
+        total: number
+      }
+
+      /**
+       * Success response for POST /laplace/fertility-contribute
+       */
+      export interface FertilityContributeResponse {
+        success: true
+        id: number
+        message: string
+      }
+
+      /**
+       * Request body for POST /laplace/fertility-contribution-reject/:id
+       */
+      export interface FertilityContributionRejectRequest {
+        reason?: string
+      }
+
+      /**
+       * Response for approve/reject endpoints
+       */
+      export interface FertilityContributionActionResponse {
+        success: true
+        id: number
+        status: ContributionStatus
+      }
     }
 
     /** Migrated from experiments.sparanoid.net */

package/package.json

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