@cieloazul310/jclub-financial-statistics 0.0.1-alpha.7 → 0.0.1-alpha.8

package/dist/index.cjs

@@ -1,6 +1,6 @@
-const require_type = require('./type.cjs');
 let fs_promises = require("fs/promises");
 let path = require("path");
+let _cieloazul310_jclub_financial_utils = require("@cieloazul310/jclub-financial-utils");
 
 //#region src/index.ts
 async function findDatasetDir() {
@@ -68,7 +68,7 @@ async function getStatistics(year, category, key) {
 		stddev: entry.stats?.deviation ?? null
 	};
 }
-const DEFAULT_YEARS = Array.from({ length: 20 }, (_, i) => 2005 + i);
+const DEFAULT_YEARS = (0, _cieloazul310_jclub_financial_utils.getAllYears)().map(({ year }) => year);
 /**
 * Returns an array of statistics for a single category across multiple years.
 * Example: getCategoryYearSeries("J2", key) -> [Stats|null for 2005, 2006, ...]
@@ -81,19 +81,33 @@ async function getCategoryYearSeries(category, key) {
 	}
 	return result;
 }
-/**
-* Returns statistics for a single year as an object keyed by category.
-* If a category has no data, its value will be null.
-*/
-async function getStatsByYear(year, key) {
+async function getStatsByYear(year, keys) {
+	const categories = (0, _cieloazul310_jclub_financial_utils.getAllYears)().find((yearInfo) => yearInfo.year === year)?.categories;
+	if (!categories) return null;
+	if (typeof keys === "string") {
+		const out$1 = {
+			J1: null,
+			J2: null,
+			J3: null
+		};
+		for (const cat of categories) {
+			const stats = await getStatistics(year, cat, keys);
+			out$1[cat] = stats.totalCount === 0 ? null : stats;
+		}
+		return out$1;
+	}
 	const out = {
 		J1: null,
 		J2: null,
 		J3: null
 	};
-	for (const cat of require_type.CATEGORIES) {
-		const stats = await getStatistics(year, cat, key);
-		out[cat] = stats.totalCount === 0 ? null : stats;
+	for (const cat of categories) {
+		const statsByCategory = {};
+		for (const key of keys) {
+			const stats = await getStatistics(year, cat, key);
+			statsByCategory[key] = stats.totalCount === 0 ? null : stats;
+		}
+		out[cat] = statsByCategory;
 	}
 	return out;
 }

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { Category, Fields, ValueItem } from "./type.cjs";
+import { Fields, StatsCategory, ValueItem } from "./type.cjs";
 
 //#region src/index.d.ts
 type StatsResult = {
   year: number;
-  category: Category;
+  category: StatsCategory;
   key: Fields;
   totalCount: number;
   values: ValueItem[];
@@ -14,18 +14,19 @@ type StatsResult = {
   variance: number | null;
   stddev: number | null;
 };
-declare function getStatistics(year: number, category: Category, key: Fields): Promise<StatsResult>;
+declare function getStatistics(year: number, category: StatsCategory, key: Fields): Promise<StatsResult>;
 type Year = number;
 /**
  * Returns an array of statistics for a single category across multiple years.
  * Example: getCategoryYearSeries("J2", key) -> [Stats|null for 2005, 2006, ...]
  */
-declare function getCategoryYearSeries(category: Category, key: Fields): Promise<(StatsResult | null)[]>;
+declare function getCategoryYearSeries(category: StatsCategory, key: Fields): Promise<(StatsResult | null)[]>;
 /**
  * Returns statistics for a single year as an object keyed by category.
  * If a category has no data, its value will be null.
  */
-declare function getStatsByYear(year: Year, key: Fields): Promise<Record<Category, StatsResult | null>>;
+declare function getStatsByYear(year: Year, keys: Fields): Promise<Record<StatsCategory, StatsResult | null> | null>;
+declare function getStatsByYear(year: Year, keys: Fields[]): Promise<Record<StatsCategory, Record<Fields, StatsResult | null>> | null>;
 //#endregion
 export { StatsResult, Year, getCategoryYearSeries, getStatistics, getStatsByYear };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;KAIY,WAAA;;EAAA,QAAA,EAEA,QAFW;EAEX,GAAA,EACL,MADK;EACL,UAAA,EAAA,MAAA;EAEG,MAAA,EAAA,SAAA,EAAA;EAAS,GAAA,EAAA,MAAA;EAsCG,OAAA,EAAA,MAAA,GAAa,IAAA;EAEvB,GAAA,EAAA,MAAA,GAAA,IAAA;EACL,GAAA,EAAA,MAAA,GAAA,IAAA;EACI,QAAA,EAAA,MAAA,GAAA,IAAA;EAAR,MAAA,EAAA,MAAA,GAAA,IAAA;CAAO;AA2DE,iBA/DU,aAAA,CA+DN,IAAA,EAAA,MAAA,EAAA,QAAA,EA7DJ,QA6DI,EAAA,GAAA,EA5DT,MA4DS,CAAA,EA3Db,OA2Da,CA3DL,WA2DK,CAAA;AAQM,KARV,IAAA,GAQU,MAAA;;;;;AAGZ,iBAHY,qBAAA,CAGZ,QAAA,EAFE,QAEF,EAAA,GAAA,EADH,MACG,CAAA,EAAP,OAAO,CAAA,CAAE,WAAF,GAAA,IAAA,CAAA,EAAA,CAAA;AAaV;;;;AAG4B,iBAHN,cAAA,CAGM,IAAA,EAFpB,IAEoB,EAAA,GAAA,EADrB,MACqB,CAAA,EAAzB,OAAyB,CAAjB,MAAiB,CAAV,QAAU,EAAA,WAAA,GAAA,IAAA,CAAA,CAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;KAKY,WAAA;;EAAA,QAAA,EAEA,aAFW;EAEX,GAAA,EACL,MADK;EACL,UAAA,EAAA,MAAA;EAEG,MAAA,EAAA,SAAA,EAAA;EAAS,GAAA,EAAA,MAAA;EAsCG,OAAA,EAAA,MAAA,GAAa,IAAA;EAEvB,GAAA,EAAA,MAAA,GAAA,IAAA;EACL,GAAA,EAAA,MAAA,GAAA,IAAA;EACI,QAAA,EAAA,MAAA,GAAA,IAAA;EAAR,MAAA,EAAA,MAAA,GAAA,IAAA;CAAO;AA2DE,iBA/DU,aAAA,CA+DN,IAAA,EAAA,MAAA,EAAA,QAAA,EA7DJ,aA6DI,EAAA,GAAA,EA5DT,MA4DS,CAAA,EA3Db,OA2Da,CA3DL,WA2DK,CAAA;AAQM,KARV,IAAA,GAQU,MAAA;;;;;AAGZ,iBAHY,qBAAA,CAGZ,QAAA,EAFE,aAEF,EAAA,GAAA,EADH,MACG,CAAA,EAAP,OAAO,CAAA,CAAE,WAAF,GAAA,IAAA,CAAA,EAAA,CAAA;AAaV;;;;AAGiC,iBAHjB,cAAA,CAGiB,IAAA,EAFzB,IAEyB,EAAA,IAAA,EADzB,MACyB,CAAA,EAA9B,OAA8B,CAAtB,MAAsB,CAAf,aAAe,EAAA,WAAA,GAAA,IAAA,CAAA,GAAA,IAAA,CAAA;AAAtB,iBAEK,cAAA,CAFL,IAAA,EAGH,IAHG,EAAA,IAAA,EAIH,MAJG,EAAA,CAAA,EAKR,OALQ,CAKA,MALA,CAKO,aALP,EAKsB,MALtB,CAK6B,MAL7B,EAKqC,WALrC,GAAA,IAAA,CAAA,CAAA,GAAA,IAAA,CAAA"}

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-import { Category, Fields, ValueItem } from "./type.mjs";
+import { Fields, StatsCategory, ValueItem } from "./type.mjs";
 
 //#region src/index.d.ts
 type StatsResult = {
   year: number;
-  category: Category;
+  category: StatsCategory;
   key: Fields;
   totalCount: number;
   values: ValueItem[];
@@ -14,18 +14,19 @@ type StatsResult = {
   variance: number | null;
   stddev: number | null;
 };
-declare function getStatistics(year: number, category: Category, key: Fields): Promise<StatsResult>;
+declare function getStatistics(year: number, category: StatsCategory, key: Fields): Promise<StatsResult>;
 type Year = number;
 /**
  * Returns an array of statistics for a single category across multiple years.
  * Example: getCategoryYearSeries("J2", key) -> [Stats|null for 2005, 2006, ...]
  */
-declare function getCategoryYearSeries(category: Category, key: Fields): Promise<(StatsResult | null)[]>;
+declare function getCategoryYearSeries(category: StatsCategory, key: Fields): Promise<(StatsResult | null)[]>;
 /**
  * Returns statistics for a single year as an object keyed by category.
  * If a category has no data, its value will be null.
  */
-declare function getStatsByYear(year: Year, key: Fields): Promise<Record<Category, StatsResult | null>>;
+declare function getStatsByYear(year: Year, keys: Fields): Promise<Record<StatsCategory, StatsResult | null> | null>;
+declare function getStatsByYear(year: Year, keys: Fields[]): Promise<Record<StatsCategory, Record<Fields, StatsResult | null>> | null>;
 //#endregion
 export { StatsResult, Year, getCategoryYearSeries, getStatistics, getStatsByYear };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;KAIY,WAAA;;EAAA,QAAA,EAEA,QAFW;EAEX,GAAA,EACL,MADK;EACL,UAAA,EAAA,MAAA;EAEG,MAAA,EAAA,SAAA,EAAA;EAAS,GAAA,EAAA,MAAA;EAsCG,OAAA,EAAA,MAAA,GAAa,IAAA;EAEvB,GAAA,EAAA,MAAA,GAAA,IAAA;EACL,GAAA,EAAA,MAAA,GAAA,IAAA;EACI,QAAA,EAAA,MAAA,GAAA,IAAA;EAAR,MAAA,EAAA,MAAA,GAAA,IAAA;CAAO;AA2DE,iBA/DU,aAAA,CA+DN,IAAA,EAAA,MAAA,EAAA,QAAA,EA7DJ,QA6DI,EAAA,GAAA,EA5DT,MA4DS,CAAA,EA3Db,OA2Da,CA3DL,WA2DK,CAAA;AAQM,KARV,IAAA,GAQU,MAAA;;;;;AAGZ,iBAHY,qBAAA,CAGZ,QAAA,EAFE,QAEF,EAAA,GAAA,EADH,MACG,CAAA,EAAP,OAAO,CAAA,CAAE,WAAF,GAAA,IAAA,CAAA,EAAA,CAAA;AAaV;;;;AAG4B,iBAHN,cAAA,CAGM,IAAA,EAFpB,IAEoB,EAAA,GAAA,EADrB,MACqB,CAAA,EAAzB,OAAyB,CAAjB,MAAiB,CAAV,QAAU,EAAA,WAAA,GAAA,IAAA,CAAA,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;KAKY,WAAA;;EAAA,QAAA,EAEA,aAFW;EAEX,GAAA,EACL,MADK;EACL,UAAA,EAAA,MAAA;EAEG,MAAA,EAAA,SAAA,EAAA;EAAS,GAAA,EAAA,MAAA;EAsCG,OAAA,EAAA,MAAA,GAAa,IAAA;EAEvB,GAAA,EAAA,MAAA,GAAA,IAAA;EACL,GAAA,EAAA,MAAA,GAAA,IAAA;EACI,QAAA,EAAA,MAAA,GAAA,IAAA;EAAR,MAAA,EAAA,MAAA,GAAA,IAAA;CAAO;AA2DE,iBA/DU,aAAA,CA+DN,IAAA,EAAA,MAAA,EAAA,QAAA,EA7DJ,aA6DI,EAAA,GAAA,EA5DT,MA4DS,CAAA,EA3Db,OA2Da,CA3DL,WA2DK,CAAA;AAQM,KARV,IAAA,GAQU,MAAA;;;;;AAGZ,iBAHY,qBAAA,CAGZ,QAAA,EAFE,aAEF,EAAA,GAAA,EADH,MACG,CAAA,EAAP,OAAO,CAAA,CAAE,WAAF,GAAA,IAAA,CAAA,EAAA,CAAA;AAaV;;;;AAGiC,iBAHjB,cAAA,CAGiB,IAAA,EAFzB,IAEyB,EAAA,IAAA,EADzB,MACyB,CAAA,EAA9B,OAA8B,CAAtB,MAAsB,CAAf,aAAe,EAAA,WAAA,GAAA,IAAA,CAAA,GAAA,IAAA,CAAA;AAAtB,iBAEK,cAAA,CAFL,IAAA,EAGH,IAHG,EAAA,IAAA,EAIH,MAJG,EAAA,CAAA,EAKR,OALQ,CAKA,MALA,CAKO,aALP,EAKsB,MALtB,CAK6B,MAL7B,EAKqC,WALrC,GAAA,IAAA,CAAA,CAAA,GAAA,IAAA,CAAA"}

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { CATEGORIES } from "./type.mjs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { readFile, stat } from "fs/promises";
 import { join, resolve } from "path";
+import { getAllYears } from "@cieloazul310/jclub-financial-utils";
 
 //#region ../../node_modules/tsdown/esm-shims.js
 const getFilename = () => fileURLToPath(import.meta.url);
@@ -76,7 +76,7 @@ async function getStatistics(year, category, key) {
 		stddev: entry.stats?.deviation ?? null
 	};
 }
-const DEFAULT_YEARS = Array.from({ length: 20 }, (_, i) => 2005 + i);
+const DEFAULT_YEARS = getAllYears().map(({ year }) => year);
 /**
 * Returns an array of statistics for a single category across multiple years.
 * Example: getCategoryYearSeries("J2", key) -> [Stats|null for 2005, 2006, ...]
@@ -89,19 +89,33 @@ async function getCategoryYearSeries(category, key) {
 	}
 	return result;
 }
-/**
-* Returns statistics for a single year as an object keyed by category.
-* If a category has no data, its value will be null.
-*/
-async function getStatsByYear(year, key) {
+async function getStatsByYear(year, keys) {
+	const categories = getAllYears().find((yearInfo) => yearInfo.year === year)?.categories;
+	if (!categories) return null;
+	if (typeof keys === "string") {
+		const out$1 = {
+			J1: null,
+			J2: null,
+			J3: null
+		};
+		for (const cat of categories) {
+			const stats = await getStatistics(year, cat, keys);
+			out$1[cat] = stats.totalCount === 0 ? null : stats;
+		}
+		return out$1;
+	}
 	const out = {
 		J1: null,
 		J2: null,
 		J3: null
 	};
-	for (const cat of CATEGORIES) {
-		const stats = await getStatistics(year, cat, key);
-		out[cat] = stats.totalCount === 0 ? null : stats;
+	for (const cat of categories) {
+		const statsByCategory = {};
+		for (const key of keys) {
+			const stats = await getStatistics(year, cat, key);
+			statsByCategory[key] = stats.totalCount === 0 ? null : stats;
+		}
+		out[cat] = statsByCategory;
 	}
 	return out;
 }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["values: ValueItem[]","DEFAULT_YEARS: Year[]","result: (StatsResult | null)[]","out: Record<Category, StatsResult | null>"],"sources":["../../../node_modules/tsdown/esm-shims.js","../src/index.ts"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n","import { stat, readFile } from \"fs/promises\";\nimport { resolve, join } from \"path\";\nimport { CATEGORIES, type Category, type Fields, type ValueItem } from \"./type\";\n\nexport type StatsResult = {\n  year: number;\n  category: Category;\n  key: Fields;\n  totalCount: number;\n  values: ValueItem[];\n  sum: number;\n  average: number | null;\n  min: number | null;\n  max: number | null;\n  variance: number | null;\n  stddev: number | null;\n};\n\nasync function findDatasetDir(): Promise<string> {\n  const candidates = [\n    resolve(__dirname, \"dataset\"), // when running from dist\n    resolve(__dirname, \"../dist/dataset\"), // when running from src\n    resolve(process.cwd(), \"packages/statistics/dist/dataset\"),\n    resolve(process.cwd(), \"dist/dataset\"),\n  ];\n  for (const c of candidates) {\n    try {\n      const s = await stat(c);\n      if (s.isDirectory()) return c;\n    } catch (err) {\n      // ignore\n    }\n  }\n  throw new Error(\"dataset directory not found (looked in candidates)\");\n}\n\nasync function loadStatsFile(year: number, category: string) {\n  const dir = await findDatasetDir();\n  const filename = join(dir, `${year}-${category}.json`);\n  try {\n    const raw = await readFile(filename, \"utf8\");\n    return JSON.parse(raw) as any;\n  } catch (err) {\n    return null;\n  }\n}\n\nexport async function getStatistics(\n  year: number,\n  category: Category,\n  key: Fields,\n): Promise<StatsResult> {\n  const file = await loadStatsFile(year, category);\n  if (!file) {\n    return {\n      year,\n      category,\n      key,\n      totalCount: 0,\n      values: [],\n      sum: 0,\n      average: null,\n      min: null,\n      max: null,\n      variance: null,\n      stddev: null,\n    };\n  }\n\n  const entry = file.stats?.[key as string];\n  if (!entry) {\n    return {\n      year,\n      category,\n      key,\n      totalCount: 0,\n      values: [],\n      sum: 0,\n      average: null,\n      min: null,\n      max: null,\n      variance: null,\n      stddev: null,\n    };\n  }\n\n  const values: ValueItem[] = entry.values ?? [];\n  const totalCount: number = entry.totalCount ?? values.length;\n  const sum: number = entry.stats?.sum ?? 0;\n  const average: number | null = entry.stats?.average ?? null;\n  const min: number | null = entry.stats?.min ?? null;\n  const max: number | null = entry.stats?.max ?? null;\n  const variance: number | null = entry.stats?.variance ?? null;\n  const stddev: number | null = entry.stats?.deviation ?? null;\n\n  return {\n    year,\n    category,\n    key,\n    totalCount,\n    values,\n    sum,\n    average,\n    min,\n    max,\n    variance,\n    stddev,\n  };\n}\n\nexport type Year = number;\n\nconst DEFAULT_YEARS: Year[] = Array.from({ length: 20 }, (_, i) => 2005 + i);\n\n/**\n * Returns an array of statistics for a single category across multiple years.\n * Example: getCategoryYearSeries(\"J2\", key) -> [Stats|null for 2005, 2006, ...]\n */\nexport async function getCategoryYearSeries(\n  category: Category,\n  key: Fields,\n): Promise<(StatsResult | null)[]> {\n  const result: (StatsResult | null)[] = [];\n  for (const year of DEFAULT_YEARS) {\n    const stats = await getStatistics(year, category, key);\n    result.push(stats.totalCount === 0 ? null : stats);\n  }\n  return result;\n}\n\n/**\n * Returns statistics for a single year as an object keyed by category.\n * If a category has no data, its value will be null.\n */\nexport async function getStatsByYear(\n  year: Year,\n  key: Fields,\n): Promise<Record<Category, StatsResult | null>> {\n  const out: Record<Category, StatsResult | null> = {\n    J1: null,\n    J2: null,\n    J3: null,\n  } as any;\n  for (const cat of CATEGORIES) {\n    const stats = await getStatistics(year, cat as Category, key);\n    out[cat] = stats.totalCount === 0 ? null : stats;\n  }\n  return out;\n}\n"],"x_google_ignoreList":[0],"mappings":";;;;;;;AAIA,MAAM,oBAAoB,cAAc,OAAO,KAAK,IAAI;AACxD,MAAM,mBAAmB,KAAK,QAAQ,aAAa,CAAC;AAEpD,MAAa,YAA4B,4BAAY;;;;ACWrD,eAAe,iBAAkC;CAC/C,MAAM,aAAa;EACjB,QAAQ,WAAW,UAAU;EAC7B,QAAQ,WAAW,kBAAkB;EACrC,QAAQ,QAAQ,KAAK,EAAE,mCAAmC;EAC1D,QAAQ,QAAQ,KAAK,EAAE,eAAe;EACvC;AACD,MAAK,MAAM,KAAK,WACd,KAAI;AAEF,OADU,MAAM,KAAK,EAAE,EACjB,aAAa,CAAE,QAAO;UACrB,KAAK;AAIhB,OAAM,IAAI,MAAM,qDAAqD;;AAGvE,eAAe,cAAc,MAAc,UAAkB;CAE3D,MAAM,WAAW,KADL,MAAM,gBAAgB,EACP,GAAG,KAAK,GAAG,SAAS,OAAO;AACtD,KAAI;EACF,MAAM,MAAM,MAAM,SAAS,UAAU,OAAO;AAC5C,SAAO,KAAK,MAAM,IAAI;UACf,KAAK;AACZ,SAAO;;;AAIX,eAAsB,cACpB,MACA,UACA,KACsB;CACtB,MAAM,OAAO,MAAM,cAAc,MAAM,SAAS;AAChD,KAAI,CAAC,KACH,QAAO;EACL;EACA;EACA;EACA,YAAY;EACZ,QAAQ,EAAE;EACV,KAAK;EACL,SAAS;EACT,KAAK;EACL,KAAK;EACL,UAAU;EACV,QAAQ;EACT;CAGH,MAAM,QAAQ,KAAK,QAAQ;AAC3B,KAAI,CAAC,MACH,QAAO;EACL;EACA;EACA;EACA,YAAY;EACZ,QAAQ,EAAE;EACV,KAAK;EACL,SAAS;EACT,KAAK;EACL,KAAK;EACL,UAAU;EACV,QAAQ;EACT;CAGH,MAAMA,SAAsB,MAAM,UAAU,EAAE;AAS9C,QAAO;EACL;EACA;EACA;EACA,YAZyB,MAAM,cAAc,OAAO;EAapD;EACA,KAbkB,MAAM,OAAO,OAAO;EActC,SAb6B,MAAM,OAAO,WAAW;EAcrD,KAbyB,MAAM,OAAO,OAAO;EAc7C,KAbyB,MAAM,OAAO,OAAO;EAc7C,UAb8B,MAAM,OAAO,YAAY;EAcvD,QAb4B,MAAM,OAAO,aAAa;EAcvD;;AAKH,MAAMC,gBAAwB,MAAM,KAAK,EAAE,QAAQ,IAAI,GAAG,GAAG,MAAM,OAAO,EAAE;;;;;AAM5E,eAAsB,sBACpB,UACA,KACiC;CACjC,MAAMC,SAAiC,EAAE;AACzC,MAAK,MAAM,QAAQ,eAAe;EAChC,MAAM,QAAQ,MAAM,cAAc,MAAM,UAAU,IAAI;AACtD,SAAO,KAAK,MAAM,eAAe,IAAI,OAAO,MAAM;;AAEpD,QAAO;;;;;;AAOT,eAAsB,eACpB,MACA,KAC+C;CAC/C,MAAMC,MAA4C;EAChD,IAAI;EACJ,IAAI;EACJ,IAAI;EACL;AACD,MAAK,MAAM,OAAO,YAAY;EAC5B,MAAM,QAAQ,MAAM,cAAc,MAAM,KAAiB,IAAI;AAC7D,MAAI,OAAO,MAAM,eAAe,IAAI,OAAO;;AAE7C,QAAO"}
+{"version":3,"file":"index.mjs","names":["values: ValueItem[]","DEFAULT_YEARS: Year[]","result: (StatsResult | null)[]","out: Record<StatsCategory, StatsResult | null>","out","out: Record<StatsCategory, Record<Fields, StatsResult | null>>","statsByCategory: Record<Fields, StatsResult | null>"],"sources":["../../../node_modules/tsdown/esm-shims.js","../src/index.ts"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n","import { stat, readFile } from \"fs/promises\";\nimport { resolve, join } from \"path\";\nimport { getAllYears } from \"@cieloazul310/jclub-financial-utils\";\nimport type { StatsCategory, Fields, ValueItem } from \"./type\";\n\nexport type StatsResult = {\n  year: number;\n  category: StatsCategory;\n  key: Fields;\n  totalCount: number;\n  values: ValueItem[];\n  sum: number;\n  average: number | null;\n  min: number | null;\n  max: number | null;\n  variance: number | null;\n  stddev: number | null;\n};\n\nasync function findDatasetDir(): Promise<string> {\n  const candidates = [\n    resolve(__dirname, \"dataset\"), // when running from dist\n    resolve(__dirname, \"../dist/dataset\"), // when running from src\n    resolve(process.cwd(), \"packages/statistics/dist/dataset\"),\n    resolve(process.cwd(), \"dist/dataset\"),\n  ];\n  for (const c of candidates) {\n    try {\n      const s = await stat(c);\n      if (s.isDirectory()) return c;\n    } catch (err) {\n      // ignore\n    }\n  }\n  throw new Error(\"dataset directory not found (looked in candidates)\");\n}\n\nasync function loadStatsFile(year: number, category: string) {\n  const dir = await findDatasetDir();\n  const filename = join(dir, `${year}-${category}.json`);\n  try {\n    const raw = await readFile(filename, \"utf8\");\n    return JSON.parse(raw) as any;\n  } catch (err) {\n    return null;\n  }\n}\n\nexport async function getStatistics(\n  year: number,\n  category: StatsCategory,\n  key: Fields,\n): Promise<StatsResult> {\n  const file = await loadStatsFile(year, category);\n  if (!file) {\n    return {\n      year,\n      category,\n      key,\n      totalCount: 0,\n      values: [],\n      sum: 0,\n      average: null,\n      min: null,\n      max: null,\n      variance: null,\n      stddev: null,\n    };\n  }\n\n  const entry = file.stats?.[key as string];\n  if (!entry) {\n    return {\n      year,\n      category,\n      key,\n      totalCount: 0,\n      values: [],\n      sum: 0,\n      average: null,\n      min: null,\n      max: null,\n      variance: null,\n      stddev: null,\n    };\n  }\n\n  const values: ValueItem[] = entry.values ?? [];\n  const totalCount: number = entry.totalCount ?? values.length;\n  const sum: number = entry.stats?.sum ?? 0;\n  const average: number | null = entry.stats?.average ?? null;\n  const min: number | null = entry.stats?.min ?? null;\n  const max: number | null = entry.stats?.max ?? null;\n  const variance: number | null = entry.stats?.variance ?? null;\n  const stddev: number | null = entry.stats?.deviation ?? null;\n\n  return {\n    year,\n    category,\n    key,\n    totalCount,\n    values,\n    sum,\n    average,\n    min,\n    max,\n    variance,\n    stddev,\n  };\n}\n\nexport type Year = number;\n\nconst DEFAULT_YEARS: Year[] = getAllYears().map(({ year }) => year);\n\n/**\n * Returns an array of statistics for a single category across multiple years.\n * Example: getCategoryYearSeries(\"J2\", key) -> [Stats|null for 2005, 2006, ...]\n */\nexport async function getCategoryYearSeries(\n  category: StatsCategory,\n  key: Fields,\n): Promise<(StatsResult | null)[]> {\n  const result: (StatsResult | null)[] = [];\n  for (const year of DEFAULT_YEARS) {\n    const stats = await getStatistics(year, category, key);\n    result.push(stats.totalCount === 0 ? null : stats);\n  }\n  return result;\n}\n\n/**\n * Returns statistics for a single year as an object keyed by category.\n * If a category has no data, its value will be null.\n */\nexport function getStatsByYear(\n  year: Year,\n  keys: Fields,\n): Promise<Record<StatsCategory, StatsResult | null> | null>;\n\nexport function getStatsByYear(\n  year: Year,\n  keys: Fields[],\n): Promise<Record<StatsCategory, Record<Fields, StatsResult | null>> | null>;\n\nexport async function getStatsByYear(year: Year, keys: Fields | Fields[]) {\n  const allYears = getAllYears();\n  const categories = allYears.find(\n    (yearInfo) => yearInfo.year === year,\n  )?.categories;\n  if (!categories) return null;\n\n  if (typeof keys === \"string\") {\n    const out: Record<StatsCategory, StatsResult | null> = {\n      J1: null,\n      J2: null,\n      J3: null,\n    } as any;\n\n    for (const cat of categories) {\n      const stats = await getStatistics(year, cat as StatsCategory, keys);\n      out[cat] = stats.totalCount === 0 ? null : stats;\n    }\n    return out;\n  }\n\n  const out: Record<StatsCategory, Record<Fields, StatsResult | null>> = {\n    J1: null,\n    J2: null,\n    J3: null,\n  } as any;\n\n  for (const cat of categories) {\n    const statsByCategory: Record<Fields, StatsResult | null> = {} as any;\n\n    for (const key of keys) {\n      const stats = await getStatistics(year, cat as StatsCategory, key);\n      statsByCategory[key] = stats.totalCount === 0 ? null : stats;\n    }\n    out[cat] = statsByCategory;\n  }\n  return out;\n}\n"],"x_google_ignoreList":[0],"mappings":";;;;;;;AAIA,MAAM,oBAAoB,cAAc,OAAO,KAAK,IAAI;AACxD,MAAM,mBAAmB,KAAK,QAAQ,aAAa,CAAC;AAEpD,MAAa,YAA4B,4BAAY;;;;ACYrD,eAAe,iBAAkC;CAC/C,MAAM,aAAa;EACjB,QAAQ,WAAW,UAAU;EAC7B,QAAQ,WAAW,kBAAkB;EACrC,QAAQ,QAAQ,KAAK,EAAE,mCAAmC;EAC1D,QAAQ,QAAQ,KAAK,EAAE,eAAe;EACvC;AACD,MAAK,MAAM,KAAK,WACd,KAAI;AAEF,OADU,MAAM,KAAK,EAAE,EACjB,aAAa,CAAE,QAAO;UACrB,KAAK;AAIhB,OAAM,IAAI,MAAM,qDAAqD;;AAGvE,eAAe,cAAc,MAAc,UAAkB;CAE3D,MAAM,WAAW,KADL,MAAM,gBAAgB,EACP,GAAG,KAAK,GAAG,SAAS,OAAO;AACtD,KAAI;EACF,MAAM,MAAM,MAAM,SAAS,UAAU,OAAO;AAC5C,SAAO,KAAK,MAAM,IAAI;UACf,KAAK;AACZ,SAAO;;;AAIX,eAAsB,cACpB,MACA,UACA,KACsB;CACtB,MAAM,OAAO,MAAM,cAAc,MAAM,SAAS;AAChD,KAAI,CAAC,KACH,QAAO;EACL;EACA;EACA;EACA,YAAY;EACZ,QAAQ,EAAE;EACV,KAAK;EACL,SAAS;EACT,KAAK;EACL,KAAK;EACL,UAAU;EACV,QAAQ;EACT;CAGH,MAAM,QAAQ,KAAK,QAAQ;AAC3B,KAAI,CAAC,MACH,QAAO;EACL;EACA;EACA;EACA,YAAY;EACZ,QAAQ,EAAE;EACV,KAAK;EACL,SAAS;EACT,KAAK;EACL,KAAK;EACL,UAAU;EACV,QAAQ;EACT;CAGH,MAAMA,SAAsB,MAAM,UAAU,EAAE;AAS9C,QAAO;EACL;EACA;EACA;EACA,YAZyB,MAAM,cAAc,OAAO;EAapD;EACA,KAbkB,MAAM,OAAO,OAAO;EActC,SAb6B,MAAM,OAAO,WAAW;EAcrD,KAbyB,MAAM,OAAO,OAAO;EAc7C,KAbyB,MAAM,OAAO,OAAO;EAc7C,UAb8B,MAAM,OAAO,YAAY;EAcvD,QAb4B,MAAM,OAAO,aAAa;EAcvD;;AAKH,MAAMC,gBAAwB,aAAa,CAAC,KAAK,EAAE,WAAW,KAAK;;;;;AAMnE,eAAsB,sBACpB,UACA,KACiC;CACjC,MAAMC,SAAiC,EAAE;AACzC,MAAK,MAAM,QAAQ,eAAe;EAChC,MAAM,QAAQ,MAAM,cAAc,MAAM,UAAU,IAAI;AACtD,SAAO,KAAK,MAAM,eAAe,IAAI,OAAO,MAAM;;AAEpD,QAAO;;AAiBT,eAAsB,eAAe,MAAY,MAAyB;CAExE,MAAM,aADW,aAAa,CACF,MACzB,aAAa,SAAS,SAAS,KACjC,EAAE;AACH,KAAI,CAAC,WAAY,QAAO;AAExB,KAAI,OAAO,SAAS,UAAU;EAC5B,MAAMC,QAAiD;GACrD,IAAI;GACJ,IAAI;GACJ,IAAI;GACL;AAED,OAAK,MAAM,OAAO,YAAY;GAC5B,MAAM,QAAQ,MAAM,cAAc,MAAM,KAAsB,KAAK;AACnE,SAAI,OAAO,MAAM,eAAe,IAAI,OAAO;;AAE7C,SAAOC;;CAGT,MAAMC,MAAiE;EACrE,IAAI;EACJ,IAAI;EACJ,IAAI;EACL;AAED,MAAK,MAAM,OAAO,YAAY;EAC5B,MAAMC,kBAAsD,EAAE;AAE9D,OAAK,MAAM,OAAO,MAAM;GACtB,MAAM,QAAQ,MAAM,cAAc,MAAM,KAAsB,IAAI;AAClE,mBAAgB,OAAO,MAAM,eAAe,IAAI,OAAO;;AAEzD,MAAI,OAAO;;AAEb,QAAO"}

package/dist/type.d.cts

@@ -1,6 +1,6 @@
 //#region src/type.d.ts
 declare const CATEGORIES: readonly ["J1", "J2", "J3"];
-type Category = (typeof CATEGORIES)[number];
+type StatsCategory = (typeof CATEGORIES)[number];
 declare const Fields: readonly ["revenue", "expense", "net_worth", "sponsor", "ticket", "broadcast", "salary", "average_attd", "unit_price"];
 type Fields = (typeof Fields)[number];
 type ValueItem = {
@@ -23,9 +23,9 @@ type CreateStatsResult = {
 };
 type DatasetFile = {
   year: number;
-  category: Category;
+  category: StatsCategory;
   stats: Record<string, CreateStatsResult>;
 };
 //#endregion
-export { CATEGORIES, Category, CreateStatsResult, DatasetFile, Fields, StatsSummary, ValueItem };
+export { CATEGORIES, CreateStatsResult, DatasetFile, Fields, StatsCategory, StatsSummary, ValueItem };
 //# sourceMappingURL=type.d.cts.map

package/dist/type.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.cts","names":[],"sources":["../src/type.ts"],"sourcesContent":[],"mappings":";cAAa;AAAA,KACD,QAAA,GADyC,CAAA,OACtB,UADsB,CAAA,CAAA,MAAA,CAAA;AACzC,cAEC,MAFkB,EAAA,SAAU,CAAA,SAAA,EAAA,SAAA,EAAA,WAAA,EAAA,SAAA,EAAA,QAAA,EAAA,WAAA,EAAA,QAAA,EAAA,cAAA,EAAA,YAAA,CAAA;AAE5B,KAWD,MAAA,GADF,CAAA,OACmB,MADnB,CAAA,CAAA,MAAA,CAAA;AACE,KAEA,SAAA,GAFiB;EAEjB,IAAA,EAAA,MAAS;EAET,KAAA,EAAA,MAAA;AAUZ,CAAA;AAMY,KAhBA,YAAA,GAgBW;EAEX,GAAA,EAAA,MAAA;EACY,OAAA,EAAA,MAAA,GAAA,IAAA;EAAf,GAAA,EAAA,MAAA,GAAA,IAAA;EAAM,GAAA,EAAA,MAAA,GAAA,IAAA;;;;;KATH,iBAAA;UACF;;SAED;;KAGG,WAAA;;YAEA;SACH,eAAe"}
+{"version":3,"file":"type.d.cts","names":[],"sources":["../src/type.ts"],"sourcesContent":[],"mappings":";cAAa;AAAA,KACD,aAAA,GADyC,CAAA,OACjB,UADiB,CAAA,CAAA,MAAA,CAAA;AACzC,cAEC,MAFY,EAAA,SAAW,CAAA,SAAU,EAAA,SAAA,EAAA,WAAA,EAAA,SAAA,EAAA,QAAA,EAAA,WAAA,EAAA,QAAA,EAAA,cAAA,EAAA,YAAA,CAAA;AAEjC,KAWD,MAAA,GADF,CAAA,OACmB,MADnB,CAAA,CAAA,MAAA,CAAA;AACE,KAEA,SAAA,GAFiB;EAEjB,IAAA,EAAA,MAAS;EAET,KAAA,EAAA,MAAA;AAUZ,CAAA;AAMY,KAhBA,YAAA,GAgBW;EAEX,GAAA,EAAA,MAAA;EACY,OAAA,EAAA,MAAA,GAAA,IAAA;EAAf,GAAA,EAAA,MAAA,GAAA,IAAA;EAAM,GAAA,EAAA,MAAA,GAAA,IAAA;;;;;KATH,iBAAA;UACF;;SAED;;KAGG,WAAA;;YAEA;SACH,eAAe"}

package/dist/type.d.mts

@@ -1,6 +1,6 @@
 //#region src/type.d.ts
 declare const CATEGORIES: readonly ["J1", "J2", "J3"];
-type Category = (typeof CATEGORIES)[number];
+type StatsCategory = (typeof CATEGORIES)[number];
 declare const Fields: readonly ["revenue", "expense", "net_worth", "sponsor", "ticket", "broadcast", "salary", "average_attd", "unit_price"];
 type Fields = (typeof Fields)[number];
 type ValueItem = {
@@ -23,9 +23,9 @@ type CreateStatsResult = {
 };
 type DatasetFile = {
   year: number;
-  category: Category;
+  category: StatsCategory;
   stats: Record<string, CreateStatsResult>;
 };
 //#endregion
-export { CATEGORIES, Category, CreateStatsResult, DatasetFile, Fields, StatsSummary, ValueItem };
+export { CATEGORIES, CreateStatsResult, DatasetFile, Fields, StatsCategory, StatsSummary, ValueItem };
 //# sourceMappingURL=type.d.mts.map

package/dist/type.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.mts","names":[],"sources":["../src/type.ts"],"sourcesContent":[],"mappings":";cAAa;AAAA,KACD,QAAA,GADyC,CAAA,OACtB,UADsB,CAAA,CAAA,MAAA,CAAA;AACzC,cAEC,MAFkB,EAAA,SAAU,CAAA,SAAA,EAAA,SAAA,EAAA,WAAA,EAAA,SAAA,EAAA,QAAA,EAAA,WAAA,EAAA,QAAA,EAAA,cAAA,EAAA,YAAA,CAAA;AAE5B,KAWD,MAAA,GADF,CAAA,OACmB,MADnB,CAAA,CAAA,MAAA,CAAA;AACE,KAEA,SAAA,GAFiB;EAEjB,IAAA,EAAA,MAAS;EAET,KAAA,EAAA,MAAA;AAUZ,CAAA;AAMY,KAhBA,YAAA,GAgBW;EAEX,GAAA,EAAA,MAAA;EACY,OAAA,EAAA,MAAA,GAAA,IAAA;EAAf,GAAA,EAAA,MAAA,GAAA,IAAA;EAAM,GAAA,EAAA,MAAA,GAAA,IAAA;;;;;KATH,iBAAA;UACF;;SAED;;KAGG,WAAA;;YAEA;SACH,eAAe"}
+{"version":3,"file":"type.d.mts","names":[],"sources":["../src/type.ts"],"sourcesContent":[],"mappings":";cAAa;AAAA,KACD,aAAA,GADyC,CAAA,OACjB,UADiB,CAAA,CAAA,MAAA,CAAA;AACzC,cAEC,MAFY,EAAA,SAAW,CAAA,SAAU,EAAA,SAAA,EAAA,WAAA,EAAA,SAAA,EAAA,QAAA,EAAA,WAAA,EAAA,QAAA,EAAA,cAAA,EAAA,YAAA,CAAA;AAEjC,KAWD,MAAA,GADF,CAAA,OACmB,MADnB,CAAA,CAAA,MAAA,CAAA;AACE,KAEA,SAAA,GAFiB;EAEjB,IAAA,EAAA,MAAS;EAET,KAAA,EAAA,MAAA;AAUZ,CAAA;AAMY,KAhBA,YAAA,GAgBW;EAEX,GAAA,EAAA,MAAA;EACY,OAAA,EAAA,MAAA,GAAA,IAAA;EAAf,GAAA,EAAA,MAAA,GAAA,IAAA;EAAM,GAAA,EAAA,MAAA,GAAA,IAAA;;;;;KATH,iBAAA;UACF;;SAED;;KAGG,WAAA;;YAEA;SACH,eAAe"}

package/dist/type.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type.mjs","names":[],"sources":["../src/type.ts"],"sourcesContent":["export const CATEGORIES = [\"J1\", \"J2\", \"J3\"] as const;\nexport type Category = (typeof CATEGORIES)[number];\n\nexport const Fields = [\n  \"revenue\",\n  \"expense\",\n  \"net_worth\",\n  \"sponsor\",\n  \"ticket\",\n  \"broadcast\",\n  \"salary\",\n  \"average_attd\",\n  \"unit_price\",\n] as const;\nexport type Fields = (typeof Fields)[number];\n\nexport type ValueItem = { name: string; value: number };\n\nexport type StatsSummary = {\n  sum: number;\n  average: number | null;\n  min: number | null;\n  max: number | null;\n  median?: number | null;\n  deviation?: number | null;\n  variance?: number | null;\n};\n\nexport type CreateStatsResult = {\n  values: ValueItem[];\n  totalCount: number;\n  stats: StatsSummary;\n};\n\nexport type DatasetFile = {\n  year: number;\n  category: Category;\n  stats: Record<string, CreateStatsResult>;\n};\n"],"mappings":";AAAA,MAAa,aAAa;CAAC;CAAM;CAAM;CAAK;AAG5C,MAAa,SAAS;CACpB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"type.mjs","names":[],"sources":["../src/type.ts"],"sourcesContent":["export const CATEGORIES = [\"J1\", \"J2\", \"J3\"] as const;\nexport type StatsCategory = (typeof CATEGORIES)[number];\n\nexport const Fields = [\n  \"revenue\",\n  \"expense\",\n  \"net_worth\",\n  \"sponsor\",\n  \"ticket\",\n  \"broadcast\",\n  \"salary\",\n  \"average_attd\",\n  \"unit_price\",\n] as const;\nexport type Fields = (typeof Fields)[number];\n\nexport type ValueItem = { name: string; value: number };\n\nexport type StatsSummary = {\n  sum: number;\n  average: number | null;\n  min: number | null;\n  max: number | null;\n  median?: number | null;\n  deviation?: number | null;\n  variance?: number | null;\n};\n\nexport type CreateStatsResult = {\n  values: ValueItem[];\n  totalCount: number;\n  stats: StatsSummary;\n};\n\nexport type DatasetFile = {\n  year: number;\n  category: StatsCategory;\n  stats: Record<string, CreateStatsResult>;\n};\n"],"mappings":";AAAA,MAAa,aAAa;CAAC;CAAM;CAAM;CAAK;AAG5C,MAAa,SAAS;CACpB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cieloazul310/jclub-financial-statistics",
-  "version": "0.0.1-alpha.7",
+  "version": "0.0.1-alpha.8",
   "license": "MIT",
   "homepage": "https://github.com/cieloazul310/jclub-financial-table",
   "author": {
@@ -42,9 +42,10 @@
     "build:template": "tsdown"
   },
   "devDependencies": {
-    "@cieloazul310/jclub-financial-data": "^0.0.1-alpha.7",
-    "@repo/eslint-config": "^0.0.1-alpha.7",
-    "@repo/typescript-config": "^0.0.1-alpha.7",
+    "@cieloazul310/jclub-financial-data": "^0.0.1-alpha.8",
+    "@cieloazul310/jclub-financial-utils": "^0.0.1-alpha.8",
+    "@repo/eslint-config": "^0.0.1-alpha.8",
+    "@repo/typescript-config": "^0.0.1-alpha.8",
     "@types/node": "^25.0.3",
     "eslint": "^9.39.2",
     "tsdown": "^0.18.2",
@@ -52,7 +53,8 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@cieloazul310/jclub-financial-data": "^0.0.1-alpha.7"
+    "@cieloazul310/jclub-financial-data": "^0.0.1-alpha.8",
+    "@cieloazul310/jclub-financial-utils": "^0.0.1-alpha.8"
   },
   "lint-staged": {
     "**/*.{js,mjs,cjs,ts,tsx}": [