ESM + CommonJS build 🎉

barrels.json

@@ -0,0 +1,5 @@
+{
+  "directory": "./dist/",
+  "name": "index.dto.d",
+  "noHeader": true
+}

package.json

@@ -2,18 +2,19 @@
   "name": "node-csfd-api",
   "version": "2.14.1",
   "description": "ČSFD API in JavaScript. Amazing NPM library for scrapping csfd.cz :)",
-  "main": "index.js",
   "author": "BART! <bart@bartweb.cz>",
   "scripts": {
     "start": "tsc -w",
     "prebuild": "rimraf dist",
-    "build": "tsc",
-    "postbuild": "npm-prepare-dist -s postinstall -s prepare",
+    "build": "tsc && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && yarn barrels",
+    "barrels": "barrelsby --delete -c barrels.json",
+    "postbuild": "npm-prepare-dist -s postinstall -s prepare && yarn fix-paths",
     "tsc": "tsc",
     "demo": "tsx demo",
     "lint": "eslint ./src/**/**/* --fix",
     "test": "vitest",
     "test:coverage": "yarn test run --coverage",
+    "fix-paths": "yarn json -I -f ./dist/package.json -e \"this.module='./esm/index.js';this.main='./cjs/index.js';this.types='./index.dto.d.ts'\"",
     "publish:next": "yarn && yarn build && yarn test:coverage && cd dist && npm publish --tag next",
     "postversion": "git push && git push --follow-tags",
     "release:beta": "npm version preminor --preid=beta -m \"chore(update): prelease %s β\"",
@@ -34,22 +35,24 @@
   "devDependencies": {
     "@babel/preset-typescript": "^7.27.1",
     "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.35.0",
+    "@eslint/js": "^9.36.0",
     "@types/express": "^5.0.3",
-    "@types/node": "^24.3.1",
-    "@typescript-eslint/eslint-plugin": "^8.43.0",
-    "@typescript-eslint/parser": "^8.43.0",
+    "@types/node": "^24.5.2",
+    "@typescript-eslint/eslint-plugin": "^8.44.1",
+    "@typescript-eslint/parser": "^8.44.1",
     "@vitest/coverage-istanbul": "^3.2.4",
     "@vitest/ui": "3.2.4",
+    "barrelsby": "^2.8.1",
     "dotenv": "^17.2.2",
-    "eslint": "^9.35.0",
+    "eslint": "^9.36.0",
     "eslint-config-google": "^0.14.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "express": "^5.1.0",
     "globals": "^16.4.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.1.6",
+    "json": "^11.0.0",
+    "lint-staged": "^16.2.0",
     "npm-prepare-dist": "^0.5.0",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
@@ -84,5 +87,20 @@
   "license": "MIT",
   "lint-staged": {
     "*.ts": "eslint --cache --fix"
+  },
+  "main": "./cjs/index.js",
+  "module": "./esm/index.js",
+  "types": "./index.dto.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./index.dto.d.ts",
+        "default": "./esm/index.js"
+      },
+      "require": {
+        "types": "./index.dto.d.ts",
+        "default": "./cjs/index.js"
+      }
+    }
   }
 }

server.ts

@@ -3,7 +3,7 @@ import 'dotenv/config';
 import express, { NextFunction, Request, Response } from 'express';
 import packageJson from './package.json';
 import { csfd } from './src';
-import { CSFDFilmTypes } from './src/interfaces/global';
+import { CSFDFilmTypes } from './src/dto/global';
 
 type Severity = 'info' | 'warn' | 'error' | 'success';
 

src/interfaces/cinema.interface.ts → src/dto/cinema.ts

@@ -1,4 +1,4 @@
-import { CSFDMovieListItem } from './movie.interface';
+import { CSFDMovieListItem } from './movie';
 
 export interface CSFDCinema {
   id: number;

src/interfaces/movie.interface.ts → src/dto/movie.ts

@@ -46,24 +46,24 @@ export interface CSFDVod {
 }
 
 export interface CSFDCreators {
-  directors: CSFDCreator[];
-  writers: CSFDCreator[];
-  cinematography: CSFDCreator[];
-  music: CSFDCreator[];
-  actors: CSFDCreator[];
-  basedOn: CSFDCreator[];
-  producers: CSFDCreator[];
-  filmEditing: CSFDCreator[];
-  costumeDesign: CSFDCreator[];
-  productionDesign: CSFDCreator[];
+  directors: CSFDMovieCreator[];
+  writers: CSFDMovieCreator[];
+  cinematography: CSFDMovieCreator[];
+  music: CSFDMovieCreator[];
+  actors: CSFDMovieCreator[];
+  basedOn: CSFDMovieCreator[];
+  producers: CSFDMovieCreator[];
+  filmEditing: CSFDMovieCreator[];
+  costumeDesign: CSFDMovieCreator[];
+  productionDesign: CSFDMovieCreator[];
 }
 
 export interface CSFDTitlesOther {
   country: string;
   title: string;
 }
 
-export interface CSFDCreator {
+export interface CSFDMovieCreator {
   /**
    * CSFD person ID.
    *

src/interfaces/search.interface.ts → src/dto/search.ts

@@ -1,5 +1,5 @@
 import { CSFDScreening } from './global';
-import { CSFDCreator } from './movie.interface';
+import { CSFDMovieCreator } from './movie';
 
 export interface CSFDSearch {
   movies: CSFDSearchMovie[];
@@ -22,11 +22,11 @@ export interface CSFDSearchUser {
   url: string;
 }
 
-export interface CSFDSearchCreator extends CSFDCreator {
+export interface CSFDSearchCreator extends CSFDMovieCreator {
   image: string;
 }
 
 export interface CSFDSearchCreators {
-  directors: CSFDCreator[];
-  actors: CSFDCreator[];
+  directors: CSFDMovieCreator[];
+  actors: CSFDMovieCreator[];
 }

src/helpers/cinema.helper.ts

@@ -1,30 +1,30 @@
 import { HTMLElement } from 'node-html-parser';
-import { CSFDColorRating } from '../interfaces/global';
-import { Colors } from '../interfaces/user-ratings.interface';
 import {
   CSFDCinemaGroupedFilmsByDate,
   CSFDCinemaMeta,
   CSFDCinemaMovie
-} from './../interfaces/cinema.interface';
+} from '../dto/cinema';
+import { CSFDColorRating } from '../dto/global';
+import { Colors } from '../dto/user-ratings';
 import { parseColor, parseIdFromUrl } from './global.helper';
 
-export const getColorRating = (el: HTMLElement): CSFDColorRating => {
-  return parseColor(el?.classNames.split(' ').pop() as Colors);
+export const getCinemaColorRating = (el: HTMLElement | null): CSFDColorRating => {
+  const classes: string[] = el?.classNames.split(' ') ?? [];
+  const last = classes.length ? classes[classes.length - 1] : undefined;
+  return last ? parseColor(last as Colors) : 'unknown';
 };
 
 export const getCinemaId = (el: HTMLElement | null): number => {
   const id = el?.id?.split('-')[1];
   return +id;
 };
 
-export const getId = (url: string): number | null => {
-  if (url) {
-    return parseIdFromUrl(url);
-  }
-  return null;
+export const getCinemaUrlId = (url: string | null | undefined): number | null => {
+  if (!url) return null;
+  return parseIdFromUrl(url);
 };
 
-export const getCoords = (el: HTMLElement | null): { lat: number; lng: number } | null => {
+export const getCinemaCoords = (el: HTMLElement | null): { lat: number; lng: number } | null => {
 
   if (!el) return null;
   const linkMapsEl = el.querySelector('a[href*="q="]');
@@ -63,20 +63,20 @@ export const getGroupedFilmsByDate = (el: HTMLElement | null): CSFDCinemaGrouped
     .map((index) => {
       const [date, films] = divs.slice(index, index + 2);
       const dateText = date?.firstChild?.textContent?.trim() ?? null;
-      return { date: dateText, films: getFilms('', films) };
+      return { date: dateText, films: getCinemaFilms('', films) };
     });
 
   return getDatesAndFilms;
 };
 
-export const getFilms = (date: string, el: HTMLElement | null): CSFDCinemaMovie[] => {
+export const getCinemaFilms = (date: string, el: HTMLElement | null): CSFDCinemaMovie[] => {
   const filmNodes = el.querySelectorAll('.cinema-table tr');
 
   const films = filmNodes.map((filmNode) => {
     const url = filmNode.querySelector('td.name h3 a')?.attributes.href;
-    const id = getId(url);
+    const id = url ? getCinemaUrlId(url) : null;
     const title = filmNode.querySelector('.name h3')?.text.trim();
-    const colorRating = getColorRating(filmNode.querySelector('.name .icon'));
+    const colorRating = getCinemaColorRating(filmNode.querySelector('.name .icon'));
     const showTimes = filmNode.querySelectorAll('.td-time')?.map((x) => x.textContent.trim());
     const meta = filmNode.querySelectorAll('.td-title span')?.map((x) => x.text.trim());
 

src/helpers/creator.helper.ts

@@ -1,25 +1,25 @@
 import { HTMLElement } from 'node-html-parser';
-import { CSFDCreatorScreening } from '../interfaces/creator.interface';
-import { CSFDColorRating } from '../interfaces/global';
-import { Colors } from '../interfaces/user-ratings.interface';
+import { CSFDCreatorScreening } from '../dto/creator';
+import { CSFDColorRating } from '../dto/global';
+import { Colors } from '../dto/user-ratings';
 import { addProtocol, parseColor, parseIdFromUrl } from './global.helper';
 
-export const getColorRating = (el: HTMLElement): CSFDColorRating => {
-  return parseColor(el?.classNames.split(' ').pop() as Colors);
+const getCreatorColorRating = (el: HTMLElement | null): CSFDColorRating => {
+  const classes: string[] = el?.classNames.split(' ') ?? [];
+  const last = classes[classes.length - 1] as Colors | undefined;
+  return parseColor(last);
 };
 
-export const getId = (url: string): number => {
-  if (url) {
-    return parseIdFromUrl(url);
-  }
-  return null;
+export const getCreatorId = (url: string | null | undefined): number | null => {
+  return url ? parseIdFromUrl(url) : null;
 };
 
-export const getName = (el: HTMLElement | null): string => {
-  return el.querySelector('h1').innerText.trim();
+export const getCreatorName = (el: HTMLElement | null): string | null => {
+  const h1 = el?.querySelector('h1');
+  return h1?.innerText?.trim() ?? null;
 };
 
-export const getBirthdayInfo = (
+export const getCreatorBirthdayInfo = (
   el: HTMLElement | null
 ): { birthday: string; age: number; birthPlace: string } => {
   const infoBlock = el.querySelector('h1 + p');
@@ -42,54 +42,50 @@ export const getBirthdayInfo = (
   return { birthday, age, birthPlace };
 };
 
-export const getBio = (el: HTMLElement | null): string => {
-  return el.querySelector('.article-content p')?.text.trim().split('\n')[0].trim() || null;
+export const getCreatorBio = (el: HTMLElement | null): string | null => {
+  const p = el?.querySelector('.article-content p');
+  const first = p?.text?.trim().split('\n')[0]?.trim();
+  return first || null;
 };
 
-export const getPhoto = (el: HTMLElement | null): string => {
-  const image = el.querySelector('img').attributes.src;
-  return addProtocol(image);
+export const getCreatorPhoto = (el: HTMLElement | null): string | null => {
+  const src = el?.querySelector('img')?.getAttribute('src');
+  return src ? addProtocol(src) : null;
 };
 
-export const parseBirthday = (text: string): any => {
-  return text.replace(/nar./g, '').trim();
-};
+const parseBirthday = (text: string): string => text.replace(/nar\./g, '').trim();
 
-export const parseAge = (text: string): any => {
-  return text.trim().replace(/\(/g, '').replace(/let\)/g, '').trim();
+const parseAge = (text: string): number | null => {
+  const digits = text.replace(/[^\d]/g, '');
+  return digits ? Number(digits) : null;
 };
 
-export const parseBirthPlace = (text: string): any => {
-  return text.trim().replace(/<br>/g, '').trim();
-};
+const parseBirthPlace = (text: string): string =>
+  text.trim().replace(/<br>/g, '').trim();
+
 
-export const getFilms = (el: HTMLElement | null): CSFDCreatorScreening[] => {
-  const filmNodes = el.querySelectorAll('.box')[0]?.querySelectorAll('table tr');
-  let yearCache: number;
+export const getCreatorFilms = (el: HTMLElement | null): CSFDCreatorScreening[] => {
+  const filmNodes = el?.querySelectorAll('.box')?.[0]?.querySelectorAll('table tr') ?? [];
+  let yearCache: number | null = null;
   const films = filmNodes.map((filmNode) => {
-    const id = getId(filmNode.querySelector('td.name .film-title-name')?.attributes.href);
-    const title = filmNode.querySelector('.name')?.text.trim();
-    const year = +filmNode.querySelector('.year')?.text.trim();
-    const colorRating = getColorRating(filmNode.querySelector('.name .icon'));
+    const id = getCreatorId(filmNode.querySelector('td.name .film-title-name')?.attributes?.href);
+    const title = filmNode.querySelector('.name')?.text?.trim();
+    const yearText = filmNode.querySelector('.year')?.text?.trim();
+    const year = yearText ? +yearText : null;
+    const colorRating = getCreatorColorRating(filmNode.querySelector('.name .icon'));
 
     // Cache year from previous film because there is a gap between movies with same year
-    if (year) {
+    if (typeof year === 'number' && !isNaN(year)) {
       yearCache = +year;
     }
 
-    if (id && title) {
-      return {
-        id,
-        title,
-        year: year || yearCache,
-        colorRating
-      };
+    const finalYear = year ?? yearCache;
+    if (id != null && title && finalYear != null) {
+      return { id, title, year: finalYear, colorRating };
     }
-    return {};
+    return null;
   });
   // Remove empty objects
-  const filmsUnique = films.filter(
-    (value) => Object.keys(value).length !== 0
-  ) as CSFDCreatorScreening[];
+  const filmsUnique = films.filter(Boolean) as CSFDCreatorScreening[];
   return filmsUnique;
 };

src/helpers/global.helper.ts

@@ -1,5 +1,5 @@
-import { CSFDColorRating } from '../interfaces/global';
-import { Colors } from '../interfaces/user-ratings.interface';
+import { CSFDColorRating } from '../dto/global';
+import { Colors } from '../dto/user-ratings';
 
 export const parseIdFromUrl = (url: string): number => {
   if (url) {