tsch-ej-numbers/README.md

A powerful TypeScript API for analyzing EuroJackpot draws. Perfect for developers who want to evaluate historical data, generate statistics, or build lottery-related applications.

# 🎯 tsch-ej-numbers

A powerful TypeScript API for analyzing EuroJackpot draws.  
Perfect for developers who want to evaluate historical data, generate statistics, or build lottery-related applications.

> 📅 **Latest draw:** 08.08.2025
>
> 🔗 [Wikipedia: EuroJackpot](https://en.wikipedia.org/wiki/Eurojackpot)

---

## 📦 Installation

```bash
npm install --save tsch-ej-numbers
```

⚠️ **Disclaimer**:
This library is based on publicly available data.
No guarantee is given for the accuracy of the data or the results of the API functions.
Outcomes depend entirely on the underlying dataset.

## 📱Demo App (Next.js Prototype)

A mobile prototype that uses this NPM module:
<br/>
<br/>
https://tsdev-ej.vercel.app/

<img src="https://tsdev-ej.vercel.app/qrcode_app.png" alt="QR-Code" width="200" />

## 🧾 Data Type: TRecord

```bash
export type TRecord = {
  date: string;
  wn1: number;
  wn2: number;
  wn3: number;
  wn4: number;
  wn5: number;
  en1: number;
  en2: number;
  stake: number;
  countCl1: number;
  quotaCl1: number;
  countCl2: number;
  quotaCl2: number;
  countCl3: number;
  quotaCl3: number;
  countCl4: number;
  quotaCl4: number;
  countCl5: number;
  quotaCl5: number;
  countCl6: number;
  quotaCl6: number;
  countCl7: number;
  quotaCl7: number;
  countCl8: number;
  quotaCl8: number;
  countCl9: number;
  quotaCl9: number;
  countCl10: number;
  quotaCl10: number;
  countCl11: number;
  quotaCl11: number;
  countCl12: number;
  quotaCl12: number;
  day: string;
};
```

## 🧩 API Overview

| Function                          | Version |
| --------------------------------- | ------- |
| getRecords                        | 1.0.x   |
| getLastDraw                       | 1.0.x   |
| getFirstDraw                      | 1.0.x   |
| getClassOneDraws                  | 1.0.x   |
| getMaxJackpotDraws                | 1.0.x   |
| getWinningNumbersCount            | 1.0.x   |
| getEuroNumbersCount               | 1.0.x   |
| getDecadesCount                   | 1.0.x   |
| getLowHighCount                   | 1.0.x   |
| getMinMaxQuotaCount               | 1.1.x   |
| getTopNumbers                     | 1.1.x   |
| getFlopNumbers                    | 1.1.x   |
| getRecordByDate                   | 1.2.x   |
| getTuesdayFridayCount             | 1.3.x   |
| getCountries                      | 1.4.x   |
| getEvaluationPerYear              | 1.5.x   |
| getWinningNumberFrequency         | 1.6.x   |
| getEuroNumberFrequency            | 1.6.x   |
| getAverages                       | 1.7.x   |
| getLastDrawOfWinningNumber        | 1.8.x   |
| getLastDrawOfEuroNumber           | 1.8.x   |
| getWinningNumbersOverdue          | 1.9.x   |
| getCountWinningNumberCombinations | 1.10.x  |
| getCountEuroNumberCombinations    | 1.10.x  |

<hr/>

## 📘 API Reference

### getRecords(limit?: number): TRecord[]

```bash
import { getRecords } from "tsch-ej-numbers";

getRecords();     // All draws
getRecords(10);   // Last 10 draws
```

### getLastDraw(): TRecord

```bash
import { getLastDraw } from "tsch-ej-numbers";

getLastDraw();
```

### getFirstDraw(): TRecord

```bash
import { getFirstDraw } from "tsch-ej-numbers";

getFirstDraw();
```

### getClassOneDraws(limit?: number): TRecord[]

```bash
import { getClassOneDraws } from "tsch-ej-numbers";

getClassOneDraws();
getClassOneDraws(50);
```

### getMaxJackpotDraws(limit?: number): TRecord[]

```bash
import { getMaxJackpotDraws } from "tsch-ej-numbers";

getMaxJackpotDraws();
```

### getWinningNumbersCount(limit?: number): TWinningNumbersKeyValue[]

```bash
import { getWinningNumbersCount } from "tsch-ej-numbers";

getWinningNumbersCount();
```

### getEuroNumbersCount(limit?: number): TEuroNumbersKeyValue[]

```bash
import { getEuroNumbersCount } from "tsch-ej-numbers";

getEuroNumbersCount();
```

### getDecadesCount(): { [key: string]: number }

```bash
import { getDecadesCount } from "tsch-ej-numbers";

getDecadesCount();
```

### getLowHighCount(): { countLow: number; countHigh: number }

```bash
import { getLowHighCount } from "tsch-ej-numbers";

getLowHighCount();
```

### getMinMaxQuotaCount(): { ... }

```bash
import { getMinMaxQuotaCount } from "tsch-ej-numbers";

getMinMaxQuotaCount();
```

### getTopNumbers(): { wn: {...}; en: {...} }

```bash
import { getTopNumbers } from "tsch-ej-numbers";

getTopNumbers();
```

### getFlopNumbers(): { wn: {...}; en: {...} }

```bash
import { getFlopNumbers } from "tsch-ej-numbers";

getFlopNumbers();
```

### getRecordByDate(date: string): TRecord | undefined

```bash
import { getRecordByDate } from "tsch-ej-numbers";

getRecordByDate("01.01.2020");
```

### getTuesdayFridayCount(): { countTuesday: number; countFriday: number }

```bash
import { getTuesdayFridayCount } from "tsch-ej-numbers";

getTuesdayFridayCount();
```

### getCountries(): { name: string; alpha2Code: string; ... }[]

```bash
import { getCountries } from "tsch-ej-numbers";

getCountries();
```

### getEvaluationPerYear(): { ... }

```bash
import { getEvaluationPerYear } from "tsch-ej-numbers";

getEvaluationPerYear();
```

### getWinningNumberFrequency(winningNumber: number): string[]

```bash
import { getWinningNumberFrequency } from "tsch-ej-numbers";

getWinningNumberFrequency(1);
getWinningNumberFrequency(50);
```

### getEuroNumberFrequency(winningNumber: number): string[]

```bash
import { getEuroNumberFrequency } from "tsch-ej-numbers";

getEuroNumberFrequency(1);
getEuroNumberFrequency(12);
```

### getAverages(): { key: string; drawingAvg: number; drawingTotal: number; }[]

```bash
import { getAverages } from "tsch-ej-numbers";

getAverages();
```

### getLastDrawOfWinningNumber(winningNumber: number): { key: string; beforeDrawings: number }

```bash
import { getLastDrawOfWinningNumber } from "tsch-ej-numbers";

getLastDrawOfWinningNumber(5);
```

### getLastDrawOfEuroNumber(euroNumber: number): { key: string; beforeDrawings: number }

```bash
import { getLastDrawOfEuroNumber } from "tsch-ej-numbers";

getLastDrawOfEuroNumber(3);
```

### getWinningNumbersOverdue(): { key: string; overdue: boolean }[]

```bash
import { getWinningNumbersOverdue } from "tsch-ej-numbers";

getWinningNumbersOverdue();
```

### getEuroNumbersOverdue(): { key: string; overdue: boolean }[]

```bash
import { getEuroNumbersOverdue } from "tsch-ej-numbers";

getEuroNumbersOverdue();
```

### getCountWinningNumberCombinations(sorted?: boolean): { key: string; value: number }[]

```bash
import { getCountWinningNumberCombinations } from "tsch-ej-numbers";

getCountWinningNumberCombinations();
getCountWinningNumberCombinations(true);
```

### getCountEuroNumberCombinations(sorted?: boolean): { key: string; value: number }[]

```bash
import { getCountEuroNumberCombinations } from "tsch-ej-numbers";

getCountEuroNumberCombinations();
getCountEuroNumberCombinations(true);
```