og-statistics 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# og-statistics
+
+> Descripción del paquete
+
+## Instalación
+
+```bash
+npm install og-statistics
+```
+
+## Uso
+
+```js
+const { hello } = require('og-statistics');
+
+hello('world'); // "Hello, world!"
+```
+
+## API
+
+### `hello(name)`
+
+Descripción de la función.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "og-statistics",
+  "version": "1.0.0",
+  "description": "",
+  "main": "./src/index.js",
+  "scripts": {
+    "test": "node test/index.test.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "src/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,183 @@
+'use strict';
+
+/* 
+filterStats se utiliza para clasificar elementos descritos en 'keys'
+responde la siguiente estructua json
+  fouls: { local: 12, away: 19 },
+  cornerKicks: { local: 5, away: 8 },
+  totalShotsOnGoal: { local: 9, away: 13 },
+  shotsOnGoal: { local: 2, away: 3 },
+  hitWoodwork: { local: 0, away: 1 },
+  shotsOffGoal: { local: 4, away: 6 },
+  blockedScoringAttempt: { local: 3, away: 4 },
+  errorLeadToGoal: { local: 0, away: 0 }
+*/
+
+/* 
+          Match overview:
+          - ballPossession
+          - expectedGoals
+          - cornerKicks
+          - passes
+
+          Shots:
+          - totalShotsOnGoal (total de tiros)
+          - shotsOnGoal (tiros a portería)
+          - hitWoodwork (tiros a poste)
+          - shotsOffGoal (tiros fuera)
+          - totalShotsInsideBox (tiros en el area)
+          - totalShotsOutsideBox (tiros fuera del area)
+
+          Attack:
+          - bigChanceScored (oportunidades anotadas)
+          - bigChanceMissed (oportunidades perdidas)
+          - offsides (fuera de lugar)
+
+          Passes:
+          - accuratePasses (Pases acertados)
+          - throwIns (Saque de banda)
+          - finalThirdPhaseStatistic (entradas ultimo tercio)
+
+
+          */
+
+let def = [
+  "ballPossession",
+  "expectedGoals",
+  "cornerKicks",
+  "passes",
+  "totalShotsOnGoal",
+  "shotsOnGoal",
+  "hitWoodwork",
+  "shotsOffGoal",
+  "totalShotsInsideBox",
+  "totalShotsOutsideBox",
+  "bigChanceScored",
+  "bigChanceMissed",
+  "offsides",
+  "accuratePasses",
+  "throwIns",
+  "finalThirdEntries",
+  "errorsLeadToShot",
+  "errorsLeadToGoal"
+];
+
+function filterStats(statsBase, keys = def, fallback = 0) {
+  try {
+    // Definición interna de los periodos
+    if (!statsBase || !keys || statsBase.toString().trim() === "" || keys.toString().trim() === "") {
+      return { ok: false, error: { code: "missing_context", message: "Error en los periodos" } };
+    }
+    const periods = { all: 0, ft: 1, st: 2 };
+    const result = {};
+
+    for (const [label, idx] of Object.entries(periods)) {
+      const groups = statsBase?.statistics?.[idx]?.groups ?? [];
+      const items = groups.flatMap(g => g.statisticsItems);
+
+      // índice: se queda con el primero encontrado por key
+      const firstByKey = {};
+      for (const it of items) {
+        if (firstByKey[it.key] === undefined) firstByKey[it.key] = it;
+      }
+
+      const bucket = {};
+      for (const k of keys) {
+        const it = firstByKey[k];
+        bucket[k] = {
+          home: it?.homeValue ?? fallback,
+          away: it?.awayValue ?? fallback,
+        };
+      }
+
+      result[label] = bucket;
+    }
+
+    return result;
+  } catch (error) {
+    return { ok: false, error: { code: "filterStats", message: error.message, stack: error.stack } };
+  }
+}
+/*
+card
+*/
+
+function filterIncidents(incidents) {
+  try {
+    //Cards, goals, substitutions
+
+    const homeCards = filterCards(incidents.incidents, true);
+    const awayCards = filterCards(incidents.incidents, false);
+
+    const homeGoals = filterGoals(incidents.incidents, true);
+    const awayGoals = filterGoals(incidents.incidents, false);
+
+    const homeSubs = filterSubs(incidents.incidents, true);
+    const awaySubs = filterSubs(incidents.incidents, false);
+
+    return {
+      home: { cards: homeCards, goals: homeGoals, subs: homeSubs },
+      away: { cards: awayCards, goals: awayGoals, subs: awaySubs },
+
+
+    }
+
+  } catch (error) {
+    return { ok: false, error: { code: error.message, message: error.stack } }
+  }
+}
+
+
+const CARD_CLASSES = ['red', 'yellow', 'yellowRed'];
+
+const filterCards = (incidents, isHome) => {
+  const teamIncidents = incidents.filter(s => s.isHome === isHome);
+
+  const cards = CARD_CLASSES.reduce((acc, cardClass) => {
+    const all = teamIncidents.filter(s => s.incidentType === 'card' && s.incidentClass === cardClass);
+    const ft = all.filter(s => s.time <= 45);
+    const st = all.filter(s => s.time > 45);
+
+    acc[cardClass] = {
+      all: all,
+      ft: ft,
+      st: st,
+    };
+
+    return acc;
+  }, {});
+
+  cards.fulltime = teamIncidents;
+
+  return cards;
+};
+
+const GOAL_CLASSES = ['regular', 'penalty', 'ownGoal'];
+
+const filterGoals = (incidents, isHome) => {
+  const teamIncidents = incidents.filter(s => s.isHome === isHome && s.incidentType === 'goal');
+
+  const goles = GOAL_CLASSES.reduce((acc, cls) => {
+    const all = teamIncidents.filter(s => s.incidentClass === cls);
+
+    acc[cls] = all;
+
+    return acc
+  }, {});
+
+  goles.full = teamIncidents;
+  return goles;
+};
+
+function filterSubs(incidents, isHome) {
+  const teamIncidents = incidents.filter(s => s.isHome === isHome && s.incidentType === 'substitution');
+  const teamInjured = incidents.filter(s => s.isHome === isHome && s.incidentType === 'substitution' && s.injury === true);
+
+  return {
+    subs: teamIncidents,
+    injured: teamInjured
+  }
+}
+
+
+module.exports = { filterStats, filterIncidents };