@exodus/analytics-validation 2.77.1 → 2.78.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.78.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/analytics-validation@2.77.1...@exodus/analytics-validation@2.78.0) (2026-06-02)
+
+### Features
+
+- **analytics-validation:** add Predictions event schemas ([#16521](https://github.com/ExodusMovement/exodus-hydra/issues/16521)) ([9cb302b](https://github.com/ExodusMovement/exodus-hydra/commit/9cb302becb668e279837e01acc087d04474d2f84)), closes [ExodusMovement/exodus-mobile#39181](https://github.com/ExodusMovement/exodus-mobile/issues/39181)
+
 ## [2.77.1](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/analytics-validation@2.77.0...@exodus/analytics-validation@2.77.1) (2026-05-26)
 
 **Note:** Version bump only for package @exodus/analytics-validation

package/lib/common-properties.schemasafe.json

@@ -15,6 +15,40 @@
         }
       },
       "$comment": "It explicitly omits the 'unevaluatedProperties' keyword to make it usable with 'allOf' syntax."
+    },
+    "predictionsProperties": {
+      "description": "Global properties shared by every Predictions (PayPredictions*) event.",
+      "type": "object",
+      "required": [],
+      "properties": {
+        "funded_state": {
+          "enum": ["funded", "non_funded"]
+        },
+        "entry_source": {
+          "enum": ["tab_nav", "deeplink", "p2p_share", "rewards_card", "home_recommendation"]
+        },
+        "user_type": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "prediction_account_activated": {
+          "type": "boolean"
+        },
+        "view_mode": {
+          "enum": ["card", "list"]
+        },
+        "provider": {
+          "enum": ["polymarket", "kalshi"]
+        },
+        "market_type": {
+          "enum": ["binary", "multi"]
+        },
+        "balance_usd_at_event": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "$comment": "It explicitly omits the 'unevaluatedProperties' keyword to make it usable with 'allOf' syntax."
     }
   },
   "properties": {

package/lib/events.d.ts

@@ -83,6 +83,17 @@ export type AnalyticsCommonProperties = {
   payHasSavedDepositMethod?: boolean
 }
 
+export type PredictionsProperties = {
+  fundedState?: "funded" | "non_funded"
+  entrySource?: "tab_nav" | "deeplink" | "p2p_share" | "rewards_card" | "home_recommendation"
+  userType?: string
+  predictionAccountActivated?: boolean
+  viewMode?: "card" | "list"
+  provider?: "polymarket" | "kalshi"
+  marketType?: "binary" | "multi"
+  balanceUsdAtEvent?: number
+}
+
 export type Web3Properties = {
   dappDomain?: string
 }
@@ -879,6 +890,169 @@ export interface AnalyticsEventMap {
   "PayPayQRScan": {}
   "PayPayQRScannerView": {}
   "PayPayView": {}
+  "PayPredictionsAccountActivate": {} & PredictionsProperties
+  "PayPredictionsBuyAbandonDuringProcessing": {
+    marketId?: string
+    optionId?: string
+    amountUsd?: number
+    msInPendingState?: number
+  } & PredictionsProperties
+  "PayPredictionsBuyConfirm": {
+    marketId?: string
+    optionId?: string
+    amountUsd?: number
+    feeUsd?: number
+    rewardPct?: number
+    expectedPayoutUsd?: number
+  } & PredictionsProperties
+  "PayPredictionsBuyFail": {
+    marketId?: string
+    optionId?: string
+    amountUsd?: number
+    failureReason?: "provider_error" | "network" | "market_closed" | "price_changed" | "other"
+    errorCode?: string
+  } & PredictionsProperties
+  "PayPredictionsBuyFundTrigger": {
+    marketId?: string
+    amountAttemptedUsd?: number
+  } & PredictionsProperties
+  "PayPredictionsBuyInsufficientFunds": {
+    marketId?: string
+    amountAttemptedUsd?: number
+    balanceUsd?: number
+    shortfallUsd?: number
+  } & PredictionsProperties
+  "PayPredictionsBuyOptionChange": {
+    marketId?: string
+    fromOptionId?: string
+    toOptionId?: string
+    fromOptionPrice?: number
+    toOptionPrice?: number
+    amountEnteredUsd?: number
+  } & PredictionsProperties
+  "PayPredictionsBuyStart": {
+    marketId?: string
+    optionSelected?: string
+    optionId?: string
+    optionPrice?: number
+    rewardPct?: number
+    availableBalanceUsd?: number
+    isPositionExisting?: boolean
+  } & PredictionsProperties
+  "PayPredictionsBuySuccess": {
+    marketId?: string
+    optionId?: string
+    positionId?: string
+    amountUsd?: number
+    feeUsd?: number
+    rewardPct?: number
+    expectedPayoutUsd?: number
+    isFirstBuy?: boolean
+    latencyMs?: number
+  } & PredictionsProperties
+  "PayPredictionsFundEntry": {
+    source?: "empty_state" | "insufficient_funds" | "proactive_top_up"
+    marketId?: string
+    amountPrefilledUsd?: number
+  } & PredictionsProperties
+  "PayPredictionsHistoryItemTap": {
+    positionId?: string
+    marketId?: string
+    positionStatus?: "active" | "won" | "lost" | "void"
+  } & PredictionsProperties
+  "PayPredictionsHistoryView": {
+    positionsCount?: number
+    activeCount?: number
+    resolvedCount?: number
+  } & PredictionsProperties
+  "PayPredictionsMarketDetailOpen": {
+    marketId?: string
+    sourceSurface?: string
+  } & PredictionsProperties
+  "PayPredictionsMarketResolve": {
+    positionId?: string
+    marketId?: string
+    outcome?: "won" | "lost" | "void"
+    payoutUsd?: number
+    costBasisUsd?: number
+    realizedPnlUsd?: number
+    source?: "client"
+  } & PredictionsProperties
+  "PayPredictionsMarketSwipe": {
+    marketId?: string
+    direction?: "left" | "right" | "up" | "down"
+    viewDurationMs?: number
+  } & PredictionsProperties
+  "PayPredictionsMarketView": {
+    marketId?: string
+    marketCategory?: string
+    marketQuestion?: string
+    optionsCount?: number
+    timeRemainingSeconds?: number
+    marketVolumeUsd?: number
+    surface?: "feed" | "detail" | "history" | "search_results"
+    position?: number
+  } & PredictionsProperties
+  "PayPredictionsOpen": {
+    isFirstOpen?: boolean
+  } & PredictionsProperties
+  "PayPredictionsPositionsSeeAll": {
+    activePositionsCount?: number
+  } & PredictionsProperties
+  "PayPredictionsPositionTap": {
+    positionId?: string
+    marketId?: string
+    unrealizedPnlPct?: number
+  } & PredictionsProperties
+  "PayPredictionsPositionView": {
+    positionId?: string
+    marketId?: string
+    currentValueUsd?: number
+    costBasisUsd?: number
+    unrealizedPnlUsd?: number
+    unrealizedPnlPct?: number
+    timeToResolutionSeconds?: number
+  } & PredictionsProperties
+  "PayPredictionsSearch": {
+    queryLength?: number
+    resultsCount?: number
+  } & PredictionsProperties
+  "PayPredictionsSellFail": {
+    positionId?: string
+    marketId?: string
+    sellAmountUsd?: number
+    failureReason?: "provider_error" | "network" | "market_closed" | "price_changed" | "other"
+    errorCode?: string
+  } & PredictionsProperties
+  "PayPredictionsSellStart": {
+    positionId?: string
+    marketId?: string
+    currentPositionValueUsd?: number
+    costBasisUsd?: number
+    unrealizedPnlUsd?: number
+  } & PredictionsProperties
+  "PayPredictionsSellSuccess": {
+    positionId?: string
+    marketId?: string
+    sellAmountUsd?: number
+    realizedPnlUsd?: number
+    isFirstSell?: boolean
+  } & PredictionsProperties
+  "PayPredictionsTabSelect": {
+    tabName?: string
+    tabPosition?: number
+  } & PredictionsProperties
+  "PayPredictionsViewModeChange": {
+    fromMode?: "card" | "list"
+    toMode?: "card" | "list"
+  } & PredictionsProperties
+  "PayPredictionsWinningsClaim": {
+    positionId?: string
+    marketId?: string
+    payoutUsd?: number
+    claimMethod?: "auto" | "manual"
+    isFirstClaim?: boolean
+  } & PredictionsProperties
   "PayProfileDirectDepositShareTap": {}
   "PayProfileDirectDepositView": {}
   "PayProfilePaymentMethodsAdd": {

package/lib/index.js

@@ -1,2 +1,7 @@
-import validateEvent from './main.schemasafe.json';
-export default validateEvent;
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const main_schemasafe_json_1 = __importDefault(require("./main.schemasafe.json"));
+exports.default = main_schemasafe_json_1.default;

package/lib/main.schemasafe.json

@@ -656,6 +656,87 @@
                 {
                     "$ref": "performance-view-render#"
                 },
+                {
+                    "$ref": "pay-predictions-account-activate#"
+                },
+                {
+                    "$ref": "pay-predictions-buy-abandon-during-processing#"
+                },
+                {
+                    "$ref": "pay-predictions-buy-confirm#"
+                },
+                {
+                    "$ref": "pay-predictions-buy-fail#"
+                },
+                {
+                    "$ref": "pay-predictions-buy-fund-trigger#"
+                },
+                {
+                    "$ref": "pay-predictions-buy-insufficient-funds#"
+                },
+                {
+                    "$ref": "pay-predictions-buy-option-change#"
+                },
+                {
+                    "$ref": "pay-predictions-buy-start#"
+                },
+                {
+                    "$ref": "pay-predictions-buy-success#"
+                },
+                {
+                    "$ref": "pay-predictions-fund-entry#"
+                },
+                {
+                    "$ref": "pay-predictions-history-item-tap#"
+                },
+                {
+                    "$ref": "pay-predictions-history-view#"
+                },
+                {
+                    "$ref": "pay-predictions-market-detail-open#"
+                },
+                {
+                    "$ref": "pay-predictions-market-resolve#"
+                },
+                {
+                    "$ref": "pay-predictions-market-swipe#"
+                },
+                {
+                    "$ref": "pay-predictions-market-view#"
+                },
+                {
+                    "$ref": "pay-predictions-open#"
+                },
+                {
+                    "$ref": "pay-predictions-position-tap#"
+                },
+                {
+                    "$ref": "pay-predictions-position-view#"
+                },
+                {
+                    "$ref": "pay-predictions-positions-see-all#"
+                },
+                {
+                    "$ref": "pay-predictions-search#"
+                },
+                {
+                    "$ref": "pay-predictions-sell-fail#"
+                },
+                {
+                    "$ref": "pay-predictions-sell-start#"
+                },
+                {
+                    "$ref": "pay-predictions-sell-success#"
+                },
+                {
+                    "$ref": "pay-predictions-tab-select#"
+                },
+                {
+                    "$ref": "pay-predictions-view-mode-change#"
+                },
+                {
+                    "$ref": "pay-predictions-winnings-claim#"
+                },
                 {
                     "$ref": "profile-features-order-change#"
                 },

package/lib/predictions/pay-predictions-account-activate.schemasafe.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "event": {
+      "const": "PayPredictionsAccountActivate"
+    },
+    "properties": {
+      "allOf": [
+        {
+          "$ref": "common-properties#"
+        },
+        {
+          "$ref": "common-properties#/definitions/predictionsProperties"
+        }
+      ],
+      "type": "object",
+      "required": [],
+      "properties": {},
+      "unevaluatedProperties": false
+    }
+  },
+  "unevaluatedProperties": false,
+  "required": ["event", "properties"]
+}

package/lib/predictions/pay-predictions-buy-abandon-during-processing.schemasafe.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "event": {
+      "const": "PayPredictionsBuyAbandonDuringProcessing"
+    },
+    "properties": {
+      "allOf": [
+        {
+          "$ref": "common-properties#"
+        },
+        {
+          "$ref": "common-properties#/definitions/predictionsProperties"
+        }
+      ],
+      "type": "object",
+      "required": [],
+      "properties": {
+        "market_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "option_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "amount_usd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "ms_in_pending_state": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "unevaluatedProperties": false
+    }
+  },
+  "unevaluatedProperties": false,
+  "required": ["event", "properties"]
+}

package/lib/predictions/pay-predictions-buy-confirm.schemasafe.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "event": {
+      "const": "PayPredictionsBuyConfirm"
+    },
+    "properties": {
+      "allOf": [
+        {
+          "$ref": "common-properties#"
+        },
+        {
+          "$ref": "common-properties#/definitions/predictionsProperties"
+        }
+      ],
+      "type": "object",
+      "required": [],
+      "properties": {
+        "market_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "option_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "amount_usd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "fee_usd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "reward_pct": {
+          "type": "number",
+          "minimum": 0
+        },
+        "expected_payout_usd": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "unevaluatedProperties": false
+    }
+  },
+  "unevaluatedProperties": false,
+  "required": ["event", "properties"]
+}

package/lib/predictions/pay-predictions-buy-fail.schemasafe.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "event": {
+      "const": "PayPredictionsBuyFail"
+    },
+    "properties": {
+      "allOf": [
+        {
+          "$ref": "common-properties#"
+        },
+        {
+          "$ref": "common-properties#/definitions/predictionsProperties"
+        }
+      ],
+      "type": "object",
+      "required": [],
+      "properties": {
+        "market_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "option_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "amount_usd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "failure_reason": {
+          "enum": ["provider_error", "network", "market_closed", "price_changed", "other"]
+        },
+        "error_code": {
+          "type": "string",
+          "format": "any-string"
+        }
+      },
+      "unevaluatedProperties": false
+    }
+  },
+  "unevaluatedProperties": false,
+  "required": ["event", "properties"]
+}

package/lib/predictions/pay-predictions-buy-fund-trigger.schemasafe.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "event": {
+      "const": "PayPredictionsBuyFundTrigger"
+    },
+    "properties": {
+      "allOf": [
+        {
+          "$ref": "common-properties#"
+        },
+        {
+          "$ref": "common-properties#/definitions/predictionsProperties"
+        }
+      ],
+      "type": "object",
+      "required": [],
+      "properties": {
+        "market_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "amount_attempted_usd": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "unevaluatedProperties": false
+    }
+  },
+  "unevaluatedProperties": false,
+  "required": ["event", "properties"]
+}

package/lib/predictions/pay-predictions-buy-insufficient-funds.schemasafe.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "event": {
+      "const": "PayPredictionsBuyInsufficientFunds"
+    },
+    "properties": {
+      "allOf": [
+        {
+          "$ref": "common-properties#"
+        },
+        {
+          "$ref": "common-properties#/definitions/predictionsProperties"
+        }
+      ],
+      "type": "object",
+      "required": [],
+      "properties": {
+        "market_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "amount_attempted_usd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "balance_usd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "shortfall_usd": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "unevaluatedProperties": false
+    }
+  },
+  "unevaluatedProperties": false,
+  "required": ["event", "properties"]
+}

package/lib/predictions/pay-predictions-buy-option-change.schemasafe.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "event": {
+      "const": "PayPredictionsBuyOptionChange"
+    },
+    "properties": {
+      "allOf": [
+        {
+          "$ref": "common-properties#"
+        },
+        {
+          "$ref": "common-properties#/definitions/predictionsProperties"
+        }
+      ],
+      "type": "object",
+      "required": [],
+      "properties": {
+        "market_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "from_option_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "to_option_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "from_option_price": {
+          "type": "number"
+        },
+        "to_option_price": {
+          "type": "number"
+        },
+        "amount_entered_usd": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "unevaluatedProperties": false
+    }
+  },
+  "unevaluatedProperties": false,
+  "required": ["event", "properties"]
+}

package/lib/predictions/pay-predictions-buy-start.schemasafe.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "event": {
+      "const": "PayPredictionsBuyStart"
+    },
+    "properties": {
+      "allOf": [
+        {
+          "$ref": "common-properties#"
+        },
+        {
+          "$ref": "common-properties#/definitions/predictionsProperties"
+        }
+      ],
+      "type": "object",
+      "required": [],
+      "properties": {
+        "market_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "option_selected": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "option_id": {
+          "type": "string",
+          "format": "any-string"
+        },
+        "option_price": {
+          "type": "number"
+        },
+        "reward_pct": {
+          "type": "number",
+          "minimum": 0
+        },
+        "available_balance_usd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "is_position_existing": {
+          "type": "boolean"
+        }
+      },
+      "unevaluatedProperties": false
+    }
+  },
+  "unevaluatedProperties": false,
+  "required": ["event", "properties"]
+}