overtime-live-trading-utils 2.1.17 → 2.1.18

package/.circleci/config.yml

@@ -1,32 +1,32 @@
-orbs: # declare what orbs we are going to use
-    node: circleci/node@5.0.3 # the node orb provides common node-related configuration
-    codecov: codecov/codecov@3.2.3
-
-version: 2.1 # using 2.1 provides access to orbs and other features
-
-executors:
-    node-executor:
-        docker:
-            - image: circleci/node:17.0.1 # Specify the Node.js version you need
-
-jobs:
-    test:
-        executor: node-executor
-        steps:
-            - checkout # Check out the code from your repository
-
-            - run:
-                  name: Install dependencies
-                  command: npm install
-
-            - run:
-                  name: Run tests
-                  command: npm test -- --coverage
-
-            - codecov/upload
-
-workflows:
-    version: 2
-    test:
-        jobs:
-            - test
+orbs: # declare what orbs we are going to use
+    node: circleci/node@5.0.3 # the node orb provides common node-related configuration
+    codecov: codecov/codecov@3.2.3
+
+version: 2.1 # using 2.1 provides access to orbs and other features
+
+executors:
+    node-executor:
+        docker:
+            - image: circleci/node:17.0.1 # Specify the Node.js version you need
+
+jobs:
+    test:
+        executor: node-executor
+        steps:
+            - checkout # Check out the code from your repository
+
+            - run:
+                  name: Install dependencies
+                  command: npm install
+
+            - run:
+                  name: Run tests
+                  command: npm test -- --coverage
+
+            - codecov/upload
+
+workflows:
+    version: 2
+    test:
+        jobs:
+            - test

package/.prettierrc

@@ -1,9 +1,9 @@
-{
-    "singleQuote": true,
-    "printWidth": 120,
-    "tabWidth": 4,
-    "useTabs": false,
-    "trailingComma": "es5",
-    "semi": true,
-    "endOfLine": "auto"
-}
+{
+    "singleQuote": true,
+    "printWidth": 120,
+    "tabWidth": 4,
+    "useTabs": false,
+    "trailingComma": "es5",
+    "semi": true,
+    "endOfLine": "auto"
+}

package/CLAUDE.md

@@ -0,0 +1,77 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a TypeScript utility library for live sports betting/trading. It processes odds data from multiple bookmakers, applies spreads, validates odds consistency, and generates child markets for various bet types (moneyline, spreads, totals). The library is designed to work with the Overtime sports betting platform.
+
+## Commands
+
+### Build & Compile
+- `npm run compile` - Compile TypeScript to JavaScript
+- `npm run pack` - Build production bundle with webpack
+
+### Testing
+- `npm test` - Run all Jest tests
+- `npm test -- --coverage` - Run tests with coverage report
+- `npm test -- src/tests/unit/odds.test.ts` - Run a specific test file
+
+### Development
+The library is published to npm. Run `npm run prepublish` to pack before publishing (runs automatically on npm publish).
+
+## Architecture
+
+### Core Processing Flow
+
+The main processing pipeline:
+1. **Bookmaker Selection** (`src/utils/bookmakers.ts`) - Selects primary/secondary/tertiary bookmakers for a sport, validates odds consistency across providers
+2. **Odds Processing** (`src/utils/odds.ts`) - Converts odds formats (decimal ↔ implied probability), filters by market type and bookmaker, creates parent moneyline odds
+3. **Spread Adjustment** (`src/utils/spread.ts`) - Applies spread data to odds, handles Asian handicap, game/point/goal spreads, run/puck lines
+4. **Market Generation** (`src/utils/markets.ts`) - Main `processMarket()` function orchestrates the pipeline: gets moneyline odds → applies spread → creates child markets
+5. **Child Markets** (`src/utils/odds.ts`) - Generates derivative markets (spreads, totals, double chance, correct score) from parent moneyline odds
+
+### Key Concepts
+
+**League Configuration**: Each league (sport) has a configuration defining enabled bet types, min/max odds, and added spreads. The `LeagueConfigInfo` type stores this data, typically loaded from CSV files like `live-markets-map.csv`.
+
+**Two vs Three-Positional Sports**: The library distinguishes between sports with 2 positions (tennis, esports - no draw) and 3 positions (soccer, hockey - draw possible). This affects odds validation and market generation.
+
+**Odds Validation**: The `checkOddsFromBookmakers()` function compares odds from multiple bookmakers using implied probability differences to detect discrepancies that might indicate stale or incorrect data.
+
+**OpticOdds Integration**: `src/utils/opticOdds.ts` provides utilities for working with the OpticOdds API format, including filtering odds by market name/bookmaker and handling team name matching.
+
+### Type System
+
+Key types in `src/types/`:
+- `OddsObject` - Complete game data with odds array from API
+- `Odds` - Array of individual odds entries with bookmaker, price, market name
+- `LeagueConfigInfo` - League/market configuration (enabled status, min/max odds, spread)
+- `ChildMarket` - Generated derivative market with line and odds
+- `Fixture` & `ScoresObject` - Game metadata and live scores
+
+### Sports-Specific Logic
+
+`src/constants/sports.ts` defines leagues without formal home/away designation (esports, tennis). `src/enums/sports.ts` defines comprehensive tennis subleague mappings and market type enums (`MoneylineTypes`, `SpreadTypes`, `TotalTypes`).
+
+### Error Handling
+
+Error messages in `src/constants/errors.ts`:
+- `NO_MATCHING_BOOKMAKERS_MESSAGE` - None of the specified bookmakers have odds
+- `DIFF_BETWEEN_BOOKMAKERS_MESSAGE` - Bookmaker odds diverge beyond threshold
+- `ZERO_ODDS_MESSAGE` - Zero odds detected (invalid)
+- `ZERO_ODDS_AFTER_SPREAD_ADJUSTMENT` - Spread adjustment resulted in zero odds
+
+## Testing Notes
+
+Tests use mock data from `src/tests/mock/`:
+- `MockLeagueMap.ts` - League configuration fixtures
+- `MockOpticSoccer.ts` - Sample OpticOdds API responses
+- `MockSoccerRedis.ts` - Redis-cached odds data
+
+Test files are organized by utility module: `odds.test.ts`, `sports.test.ts`, `spread.test.ts`, `markets.test.ts`, `bookmakers.test.ts`.
+
+## Dependencies
+
+- `oddslib` - Odds format conversion (decimal, moneyline, implied probability)
+- `overtime-utils` - Shared types and enums for the Overtime platform (League enum, MarketType)

package/codecov.yml

@@ -1,20 +1,20 @@
-# codecov.yml
-
-# Specify the coverage rules
-coverage:
-    precision: 2 # Number of decimal places for coverage percentages
-    round: down # Round coverage percentages down
-    range: '70...100' # Expected range of coverage (useful for enforcing quality gates)
-
-# Adjust how Codecov processes reports
-comment:
-    layout: 'reach, diff, flags' # Format of the PR comments
-    behavior: default # Default behavior for comments
-    require_changes: false # Only comment if changes occur in coverage
-    branches:
-        - main # Restrict comments to specific branches
-
-# Custom CI configuration (if needed)
-ci:
-    - circleci # Specify CircleCI as the CI provider
-
+# codecov.yml
+
+# Specify the coverage rules
+coverage:
+    precision: 2 # Number of decimal places for coverage percentages
+    round: down # Round coverage percentages down
+    range: '70...100' # Expected range of coverage (useful for enforcing quality gates)
+
+# Adjust how Codecov processes reports
+comment:
+    layout: 'reach, diff, flags' # Format of the PR comments
+    behavior: default # Default behavior for comments
+    require_changes: false # Only comment if changes occur in coverage
+    branches:
+        - main # Restrict comments to specific branches
+
+# Custom CI configuration (if needed)
+ci:
+    - circleci # Specify CircleCI as the CI provider
+

package/index.ts

@@ -1,16 +1,26 @@
-//utils
-export * from './src/utils/bookmakers';
-export * from './src/utils/constraints';
-export * from './src/utils/gameMatching';
-export * from './src/utils/markets';
-export * from './src/utils/odds';
-export * from './src/utils/opticOdds';
-export * from './src/utils/sports';
-export * from './src/utils/spread';
-
-// constants
-export * from './src/constants/common';
-export * from './src/constants/errors';
-export * from './src/constants/sports';
-
-export * from './src/enums/sports';
+//utils
+export * from './src/utils/bookmakers';
+export * from './src/utils/constraints';
+export * from './src/utils/gameMatching';
+export * from './src/utils/markets';
+export * from './src/utils/odds';
+export * from './src/utils/opticOdds';
+export * from './src/utils/resolution';
+export * from './src/utils/sports';
+export * from './src/utils/spread';
+
+// constants
+export * from './src/constants/common';
+export * from './src/constants/errors';
+export * from './src/constants/sports';
+
+export * from './src/enums/sports';
+
+// types
+export * from './src/types/resolution';
+export {
+    HALVES_PERIOD_TYPE_ID_MAPPING,
+    QUARTERS_PERIOD_TYPE_ID_MAPPING,
+    INNINGS_PERIOD_TYPE_ID_MAPPING,
+    FULL_GAME_TYPE_IDS,
+} from './src/types/resolution';

package/jest.config.ts

@@ -1,16 +1,16 @@
-import { JestConfigWithTsJest } from 'ts-jest';
-
-const config: JestConfigWithTsJest = {
-    preset: 'ts-jest',
-    testEnvironment: 'node',
-    transform: {
-        '^.+\\.tsx?$': 'ts-jest',
-    },
-    globals: {
-        'ts-jest': {
-            useESM: true, // Optional if you are using ES modules
-        },
-    },
-};
-
-export default config;
+import { JestConfigWithTsJest } from 'ts-jest';
+
+const config: JestConfigWithTsJest = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
+    transform: {
+        '^.+\\.tsx?$': 'ts-jest',
+    },
+    globals: {
+        'ts-jest': {
+            useESM: true, // Optional if you are using ES modules
+        },
+    },
+};
+
+export default config;