@cntwg/xml-lib-js 0.0.32 → 0.0.33

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+#### *v0.0.33*
+
+Pre-release version.
+
+> - update dependency on `@ygracs/bsfoc-lib-js` module to v0.2.3;
+> - update dependency on `@ygracs/xobj-lib-js` module to v0.2.2;
+> - update dependency on `@ygracs/xml-js6` module to v0.0.5-b;
+> - add dependency on `@cntwg/file-helper` module;
+> - remove `file-helper.js` module;
+> - some other fixes.
+
 #### *v0.0.32*
 
 Pre-release version.

package/lib/xmldoc-lib.js

@@ -1,4 +1,4 @@
-// [v0.2.107-20250208]
+// [v0.2.111-20250415]
 
 // === module init block ===
 
@@ -12,12 +12,15 @@ const {
 } = require('@ygracs/bsfoc-lib-js');
 
 const {
-  loadFileSync, loadFile,
+  loadFromFileSync, loadFromFile,
   saveToFileSync, saveToFile,
-} = require('./file-helper.js');
+} = require('@cntwg/file-helper');
 
 const xObj = require('@ygracs/xobj-lib-js');
 const {
+  evalXObjEName,
+  getXObjElement, addXObjElement, insertXObjElement,
+  readXObjParam, writeXObjParam,
   TXmlContentParseOptions,
   DEF_XML_PARSE_OPTIONS: XML_DEF_PARSE_OPTIONS,
 } = xObj;
@@ -26,9 +29,9 @@ const {
 
 /**
  * @typedef {Object} OPT_xmlelemsett
- * @property {object} [parseOptions] - parser options
- * @property {boolean} [opt.proxyModeEnable=false]
- * @property {boolean} [opt.isNullItemsAllowed=false] - <reserved>
+ * @property {TXmlContentParseOptions} [parseOptions] - parser options
+ * @property {boolean} [proxyModeEnable=false] - mode flag
+ * @property {boolean} [isNullItemsAllowed=false] - <reserved>
  * @description An XML-element controller settings.
  */
 
@@ -40,6 +43,7 @@ const {
  * @description Evaluates an XML-element settings
  */
 function __evalXMLElementSettings(value) {
+  /** @type {OPT_xmlelemsett} */
   const settings = isPlainObject(value) ? value : {};
   let {
     proxyModeEnable,
@@ -56,10 +60,13 @@ function __evalXMLElementSettings(value) {
 
 /**
  * @typedef {Object} OPT_xmlcontsett
- * @augments OPT_xmlelemsett
- * @property {string} [rootETagName]
- * @property {boolean} [autoBindRoot=true]
+ * @property {TXmlContentParseOptions} [parseOptions] - parser options
+ * @property {boolean} [proxyModeEnable=false] - mode flag
+ * @property {boolean} [isNullItemsAllowed=false] - <reserved>
+ * @property {string} [rootETagName] - tag name of the root element
+ * @property {boolean} [autoBindRoot=true] - mode flag
  * @description An XML-content container settings.
+ * @see OPT_xmlelemsett
  */
 
 /**
@@ -70,6 +77,7 @@ function __evalXMLElementSettings(value) {
  * @description Evaluates an XML-container settings
  */
 function __evalXMLContainerSettings(value) {
+  /** @type {OPT_xmlcontsett} */
   const settings = __evalXMLElementSettings(value);
   let { rootETagName, autoBindRoot } = settings;
   if (
@@ -178,9 +186,9 @@ function valueToElementID(value) {
  * @classdesc This class implements an attributes mapper instance
  */
 class TXmlAttributesMapper {
-  /** @property {?object} */
+  /** @type {object} */
   #_host;
-  /** @property {OPT_xmlelemsett} */
+  /** @type {OPT_xmlelemsett} */
   #_options;
 
   /**
@@ -211,7 +219,7 @@ class TXmlAttributesMapper {
 
   /**
    * Contains a list of all instance attributes as a `<name>-<value>` pairs
-   * @property {any[]}
+   * @type {string[][]}
    * @readonly
    */
   get entries() {
@@ -338,7 +346,7 @@ class TXmlAttributesMapper {
    * @description Deletes all attributes.
    */
   clear() {
-    xObj.insertXObjElement(
+    insertXObjElement(
       this.#_host,
       this.#_options.settings.attributesKey,
       {
@@ -354,13 +362,13 @@ class TXmlAttributesMapper {
  * @classdesc This class implements an instance of an element controller
  */
 class TXmlElementController {
-  /** @property {?object} */
+  /** @type {object} */
   #_host;
-  /** @property {OPT_xmlelemsett} */
+  /** @type {OPT_xmlelemsett} */
   #_options;
-  /** @property {?object} */
+  /** @type {object} */
   #_parseOptions;
-  /** @property {?TXmlAttributesMapper} */
+  /** @type {TXmlAttributesMapper} */
   #_attributes;
   #_name = null;
 
@@ -399,7 +407,7 @@ class TXmlElementController {
 
   /**
    * Contains an element attribute mapper instance
-   * @property {TXmlAttributesMapper}
+   * @type {TXmlAttributesMapper}
    * @readonly
    */
   get attributes() {
@@ -407,14 +415,14 @@ class TXmlElementController {
   }
 
   /**
-   * @property {string}
+   * @type {string}
    * @readonly
    * @experimental
    */
   get name() {
     let result = '';
     if (this.#_parseOptions.settings.compact) {
-      result = xObj.readXObjParam(
+      result = readXObjParam(
         this.#_host,
         this.#_parseOptions.settings.nameKey
       );
@@ -426,14 +434,14 @@ class TXmlElementController {
 
   /**
    * Contains an element text value
-   * @property {string}
+   * @type {string}
    */
   get textValue() {
-    return xObj.readXObjParam(this.#_host, this.#_parseOptions.settings.textKey);
+    return readXObjParam(this.#_host, this.#_parseOptions.settings.textKey);
   }
 
   set textValue(value) {
-    xObj.writeXObjParam(this.#_host, value, this.#_parseOptions.settings.textKey);
+    writeXObjParam(this.#_host, value, this.#_parseOptions.settings.textKey);
   }
 
   /**
@@ -509,7 +517,7 @@ class TXmlElementController {
     const _value = valueToEntry(value);
     if (_value !== null) {
       const [ lang, param ] = _value;
-      if (xObj.writeXObjParam(
+      if (writeXObjParam(
         this.#_host,
         param,
         this.#_parseOptions.settings.textKey,
@@ -535,11 +543,11 @@ class TXmlElementController {
    * @description Checks whether an element has a child element.
    */
   hasChild(name) {
-    const _name = xObj.evalXObjEName(name);
+    const _name = evalXObjEName(name);
     if (_name === null) return false;
     let result = false;
     try {
-      result = isObject(xObj.getXObjElement(this.#_host, _name));
+      result = isObject(getXObjElement(this.#_host, _name));
     } catch (err) {
       // // TODO: [?] verify what error is thrown
       //throw err;
@@ -554,11 +562,11 @@ class TXmlElementController {
    * @description Returns a child element.
    */
   getChild(name) {
-    const _name = xObj.evalXObjEName(name);
+    const _name = evalXObjEName(name);
     let result = null;
     if (_name !== null) {
       try {
-        const item = xObj.getXObjElement(this.#_host, _name);
+        const item = getXObjElement(this.#_host, _name);
         result = TXmlElementController.create(item, this.#_options);
       } catch (err) {
         // // TODO: [?] verify what error is thrown
@@ -614,11 +622,11 @@ class TXmlElementController {
    * @description Adds a new child element.
    */
   addChild(name) {
-    const _name = xObj.evalXObjEName(name);
+    const _name = evalXObjEName(name);
     if (_name === null) return null;
     let result = null;
     try {
-      const { item } = xObj.addXObjElement(this.#_host, _name);
+      const { item } = addXObjElement(this.#_host, _name);
       if (item) result = new TXmlElementController(item, this.#_options)
     } catch (err) {
       // // TODO: [?] verify what error is thrown
@@ -634,11 +642,11 @@ class TXmlElementController {
    * @description Deletes a child element.
    */
   delChild(name) {
-    const _name = xObj.evalXObjEName(name);
+    const _name = evalXObjEName(name);
     if (_name === null) return false;
     let isSucceed = false;
     try {
-      const item = xObj.getXObjElement(this.#_host, _name);
+      const item = getXObjElement(this.#_host, _name);
       let isACCEPTED = false;
       if (isArray(item)) {
         //console.log('CHECK: TXmlElementController.delChild() => item.typeof() => [object Array]');
@@ -744,7 +752,7 @@ class TXmlElementController {
     if (node instanceof TXmlElementController) {
       try {
         const obj = node.#_host;
-        item = xObj.getXObjElement(obj, name);
+        item = getXObjElement(obj, name);
         if (item === undefined) item = null;
       } catch (err) {
         // // TODO: [?] check what kind of error thrown
@@ -772,7 +780,7 @@ class TXmlElementController {
     ) {
       try {
         const obj = node.#_host;
-        ({ item } = xObj.addXObjElement(obj, childName));
+        ({ item } = addXObjElement(obj, childName));
       } catch (err) {
         // // TODO: [?] check what kind of error thrown
         item = null;
@@ -851,9 +859,9 @@ class TXmlElementController {
  * @classdesc This class implements an instance of a list controller
  */
 class TXmlElementsListController {
-  /** @property {?object[]} */
+  /** @type {object[]} */
   #_host;
-  /** @property {OPT_xmlelemsett} */
+  /** @type {OPT_xmlelemsett} */
   #_options;
   #_count = null;
 
@@ -888,7 +896,7 @@ class TXmlElementsListController {
 
   /**
    * Contains a quantity of an elements
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get count() {
@@ -897,7 +905,7 @@ class TXmlElementsListController {
 
   /**
    * Contains a quantity of an elements
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get size() {
@@ -906,7 +914,7 @@ class TXmlElementsListController {
 
   /**
    * Contains a maximum possible element index in the list
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get maxIndex() {
@@ -915,7 +923,7 @@ class TXmlElementsListController {
 
   /**
    * Indicates whether a `null`-element is allowed
-   * @property {boolean}
+   * @type {boolean}
    * @readonly
    */
   get isNullItemsAllowed() {
@@ -1146,11 +1154,11 @@ class TXmlElementsListController {
  *            that managea content of a document declaration
  */
 class TXmlContentDeclaration {
-  /** @property {?object} */
+  /** @type {object} */
   #_host;
-  /** @property {OPT_xmlcontsett} */
+  /** @type {OPT_xmlcontsett} */
   #_options;
-  /** @property {?TXmlElementController} */
+  /** @type {TXmlElementController} */
   #_ctrls;
 
   /**
@@ -1188,7 +1196,7 @@ class TXmlContentDeclaration {
 
   /**
    * Contains a version of an XML
-   * @property {string}
+   * @type {string}
    */
   get version() {
     return this.#_ctrls.getAttribute('version');
@@ -1200,7 +1208,7 @@ class TXmlContentDeclaration {
 
   /**
    * Contains a document character set
-   * @property {string}
+   * @type {string}
    */
   get encoding() {
     return this.#_ctrls.getAttribute('encoding');
@@ -1217,7 +1225,7 @@ class TXmlContentDeclaration {
   init() {
     const _options = this.#_options;
     this.#_ctrls = new TXmlElementController(
-      xObj.insertXObjElement(
+      insertXObjElement(
         this.#_host,
         _options.parseOptions.settings.declarationKey,
       ),
@@ -1235,9 +1243,9 @@ class TXmlContentDeclaration {
  * @description This class implements an instance of a root element
  */
 class TXmlContentRootElement extends TXmlElementController {
-  /** @property {?object} */
+  /** @type {?object} */
   #_content;
-  /** @property {OPT_xmlcontsett} */
+  /** @type {OPT_xmlcontsett} */
   #_options;
 
   /**
@@ -1259,7 +1267,7 @@ class TXmlContentRootElement extends TXmlElementController {
       const entries = Object.keys(obj);
       const len = entries.length;
       if (len === 0) {
-        rootItem = xObj.insertXObjElement(obj, rootETagName);
+        rootItem = insertXObjElement(obj, rootETagName);
       } else {
         const {
           declarationKey,
@@ -1291,13 +1299,13 @@ class TXmlContentRootElement extends TXmlElementController {
           };
         };
         if (targetKey === '') {
-          rootItem = xObj.insertXObjElement(obj, rootETagName);
+          rootItem = insertXObjElement(obj, rootETagName);
         } else {
           if (autoBindRoot) {
             rootItem = obj[targetKey];
             rootETagName = targetKey;
             if (!isPlainObject(rootItem)) {
-              rootItem = xObj.insertXObjElement(obj, rootETagName);
+              rootItem = insertXObjElement(obj, rootETagName);
             };
           } else {
             throw new TypeError(`TXmlContentRootElement : ${XML_TE_NROOT_EMSG}`);
@@ -1305,7 +1313,7 @@ class TXmlContentRootElement extends TXmlElementController {
         };
       };
     } else if (!isPlainObject(rootItem)) {
-      rootItem = xObj.insertXObjElement(obj, rootETagName);
+      rootItem = insertXObjElement(obj, rootETagName);
     };
     // init parent class instance
     super(rootItem, _options);
@@ -1317,7 +1325,7 @@ class TXmlContentRootElement extends TXmlElementController {
   }
 
   /**
-   * @property {string}
+   * @type {string}
    */
   get tagName() {
     return this.#_options.rootETagName;
@@ -1354,9 +1362,9 @@ class TXmlContentRootElement extends TXmlElementController {
  * @property {boolean} isERR - flag
  * @property {number} [errCode] - error code
  * @property {string} errEvent - event ID
- * @property {string} errMsg - event message
- * @property {string} source - path to file
- * @property {any} content - file content
+ * @property {string} [errMsg] - event message
+ * @property {string} [source] - path to file
+ * @property {any} [content] - file content
  * @description A fs ops description.
  */
 
@@ -1365,15 +1373,15 @@ class TXmlContentRootElement extends TXmlElementController {
  *            that managea content of a document
  */
 class TXmlContentContainer {
-  /** @property {?object} */
+  /** @type {?object} */
   #_content;
-  /** @property {OPT_xmlcontsett} */
+  /** @type {OPT_xmlcontsett} */
   #_options;
-  /** @property {?object} */
+  /** @type {?object} */
   #_parseOptions;
-  /** @property {?TXmlContentDeclaration} */
+  /** @type {TXmlContentDeclaration} */
   #_docDecl;
-  /** @property {?TXmlContentRootElement} */
+  /** @type {TXmlContentRootElement} */
   #_docRoot;
 
   /**
@@ -1397,7 +1405,8 @@ class TXmlContentContainer {
   }
 
   /**
-   * @property {TXmlContentRootElement}
+   * Returns a root element
+   * @type {TXmlContentRootElement}
    * @readonly
    */
   get rootElement() {
@@ -1450,6 +1459,7 @@ class TXmlContentContainer {
 
   /**
    * @returns {string}
+   * @throws {Error}
    * @description Returns a document content as a string in an XML-format.
    */
   saveToXMLString() {
@@ -1505,7 +1515,7 @@ class TXmlContentContainer {
   }
 
   /**
-   * @param {string} source source - path to a file
+   * @param {string} source - path to a file
    * @returns {fsoDescr}
    * @description Saves a document content to a file.
    */
@@ -1534,7 +1544,7 @@ class TXmlContentContainer {
   }
 
   /**
-   * @param {string} loadFromXMLString
+   * @param {string} xmlString - some content
    * @returns {boolean}
    * @throws {Error}
    * @description Loads a document content from a string.
@@ -1567,7 +1577,7 @@ class TXmlContentContainer {
   loadFromFile(source) {
     /**/// main part that return promise as a result
     return new Promise((resolve, reject) => {
-      loadFile(source).then(data => {
+      loadFromFile(source).then(data => {
         if (!data.isERR) {
           if (data.content !== '') {
             if (this.loadFromXMLString(data.content)) {
@@ -1599,7 +1609,7 @@ class TXmlContentContainer {
    * @description Loads a document content from a file.
    */
   loadFromFileSync(source) {
-    const data = loadFileSync(source);
+    const data = loadFromFileSync(source);
     if (!data.isERR) {
       if (data.content !== '') {
         if (this.loadFromXMLString(data.content)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cntwg/xml-lib-js",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "description": "A library for handling an XML-documents",
   "author": "ygracs <cs70th-om@rambler.ru>",
   "license": "MIT",
@@ -16,7 +16,6 @@
     "doc/xmldoc-lib.md",
     "lib/xmldoc-lib.js",
     "lib/xml-helper.js",
-    "lib/file-helper.js",
     "index.js",
     "CHANGELOG.md"
   ],
@@ -37,9 +36,10 @@
     "#test-dir/*": "./__test__/*"
   },
   "dependencies": {
-    "@ygracs/bsfoc-lib-js": "^0.2.2",
-    "@ygracs/xml-js6": "^0.0.4-b",
-    "@ygracs/xobj-lib-js": "^0.2.1"
+    "@cntwg/file-helper": "^0.0.1",
+    "@ygracs/bsfoc-lib-js": "^0.2.3",
+    "@ygracs/xml-js6": "^0.0.5-b",
+    "@ygracs/xobj-lib-js": "^0.2.2"
   },
   "devDependencies": {
     "jest": "^29.7.0",

package/lib/file-helper.js

@@ -1,278 +0,0 @@
-// [v0.1.030-20241029]
-
-// === module init block ===
-
-const fs = require('fs');
-const fse = require('fs').promises;
-
-const {
-  isPlainObject,
-} = require('@ygracs/bsfoc-lib-js');
-
-// === module extra block (helper functions) ===
-
-/**
- * @typedef {Object} fsoDescr
- * @property {boolean} isERR - flag
- * @property {number|undefined} errCode - error code
- * @property {string} errEvent - event ID
- * @property {string} errMsg - event message
- * @property {string} source - path to file
- * @property {any} content - file content
- * @description A fs ops description.
- */
-
-/**
- * @typedef {Object} VCOR_evalerrfs
- * @property {boolean} isSucceed - ops flag
- * @property {fsoDescr} descr - description
- * @description A result of an error check ops.
- */
-
-/**
- * @function checkFsError
- * @param {fsoDescr} descr
- * @param {Error} err
- * @returns {VCOR_evalerrfs}
- * @inner
- * @description Checks an error code of a fs ops and sets descr info if succeed
- */
-function checkFsError(descr, err) {
-  let isSucceed = false;
-  if (isPlainObject(err) && isPlainObject(descr)) {
-    switch (err.code) {
-      case 'ENOENT':
-      case 'EISDIR':
-      case 'ENOTDIR':
-      case 'EPERM': {
-        descr.errCode = err.errno;
-        descr.errEvent = err.code;
-        descr.errMsg = `ERR_FILE_${err.code}`;
-        isSucceed = true;
-        break;
-      }
-      default: {}
-    };
-    if (isSucceed) descr.isERR = true;
-  };
-  return { isSucceed, descr };
-};
-
-// === module main block ===
-
-/***
- * (* constant definitions *)
- */
-
-/***
- * (* function definitions *)
- */
-
-/**
- * @function loadFileSync
- * @param {string} src - a path to some file
- * @returns {fsoDescr}
- * @inner
- * @description Loads file by a given path
- */
-function loadFileSync(src) {
-  /** @type {fsoDescr} */
-  const data = {
-    isERR: false,
-    errCode: 0,
-    errEvent: '',
-    errMsg: '',
-    source: '',
-    content: '',
-  };
-  if (typeof src !== 'string') {
-    if (src !== undefined) {
-      data.isERR = true;
-      data.errEvent = 'ERR_INVARG';
-      data.errMsg = 'The "source" argument must be a string';
-    };
-  } else {
-    const srcPath = src.trim();
-    if (srcPath !== '') {
-      data.source = srcPath;
-      try {
-        data.content = fs.readFileSync(srcPath, 'utf8');
-      } catch (err) {
-        const { isSucceed } = checkFsError(data, err);
-        if (!isSucceed) {
-          // // TODO: [?] consider check others
-          //console.log(`TEST_ERR-MSG:loadFileSync: ${err}`);
-          //throw err;
-        };
-      };
-    };
-  };
-  return data;
-};
-
-/**
- * @function loadFile
- * @param {string} src - a path to some file
- * @returns {Promise<fsoDescr, Error>}
- * @async
- * @inner
- * @description Loads file by a given path
- */
-function loadFile(src) {
-  /**/// main part that return promise as a result
-  return new Promise((resolve, reject) => {
-    /** @type {fsoDescr} */
-    const data = {
-      isERR: false,
-      errCode: 0,
-      errEvent: '',
-      errMsg: '',
-      source: '',
-      content: '',
-    };
-    if (typeof src !== 'string') {
-      if (src !== undefined) {
-        data.isERR = true;
-        data.errEvent = 'ERR_INVARG';
-        data.errMsg = 'The "source" argument must be a string';
-      };
-      resolve(data);
-    } else {
-      const srcPath = src.trim();
-      if (srcPath === '') resolve(data);
-      data.source = srcPath;
-      fse.readFile(srcPath, 'utf8').then(result => {
-        data.content = result;
-        resolve(data);
-      }).catch(err => {
-        let { isSucceed } = checkFsError(data, err);
-        if (isSucceed) {
-          data.content = '';
-          resolve(data);
-        } else {
-          //console.log('CHECK: loadFile() => Error => '+err);
-          //console.log('CHECK: loadFile() => Error => '+err.code);
-          reject(err);
-        };
-      });
-    };
-  });
-};
-
-/**
- * @function saveToFileSync
- * @param {string} src - a path to some file
- * @param {string} content - some file content
- * @param {any} [opt] - <reserved>
- * @returns {fsoDescr}
- * @inner
- * @description Saves a content to a file
- */
-function saveToFileSync(src, content = '', opt) {
-  /** @type {fsoDescr} */
-  const data = {
-    isERR: false,
-    errCode: 0,
-    errEvent: '',
-    errMsg: '',
-    source: '',
-    content: '',
-  };
-  if (typeof src !== 'string') {
-    data.isERR = true;
-    data.errEvent = src === undefined ? 'ERR_NOSRC' : 'ERR_INVARG';
-    data.errMsg = 'The "source" argument must be a string';
-  } else if (typeof content === 'string') {
-    const srcPath = src.trim();
-    if (srcPath === '') {
-      data.isERR = true;
-      data.errEvent = 'ERR_NOSRC';
-      data.errMsg = 'No "source" path given';
-    } else {
-      data.source = srcPath;
-      try {
-        fs.writeFileSync(srcPath, content, 'utf8');
-      } catch (err) {
-        const { isSucceed } = checkFsError(data, err);
-        if (!isSucceed) {
-          // // TODO: [?] consider check others
-          //console.log(`TEST_ERR-MSG:saveToFileSync: ${err}`);
-          //throw err;
-        };
-      };
-    };
-  } else {
-    data.isERR = true;
-    data.errEvent = 'ERR_INVARG';
-    data.errMsg = 'The "content" argument must be a string';
-  };
-  return data;
-};
-
-/**
- * @function saveToFile
- * @param {string} src - a path to some file
- * @param {string} content - some file content
- * @param {any} [opt] - <reserved>
- * @returns {Promise<fsoDescr, Error>}
- * @async
- * @inner
- * @description Saves a content to a file
- */
-function saveToFile(src, content = '', opt) {
-  /**/// main part that return promise as a result
-  return new Promise((resolve, reject) => {
-    /** @type {fsoDescr} */
-    const data = {
-      isERR: false,
-      errCode: 0,
-      errEvent: '',
-      errMsg: '',
-      source: '',
-      content: '',
-    };
-    if (typeof src !== 'string') {
-      data.isERR = true;
-      data.errEvent = src === undefined ? 'ERR_NOSRC' : 'ERR_INVARG';
-      data.errMsg = 'The "source" argument must be a string';
-      resolve(data);
-    }  else if (typeof content === 'string') {
-      const srcPath = src.trim();
-      if (srcPath === '') {
-        data.isERR = true;
-        data.errEvent = 'ERR_NOSRC';
-        data.errMsg = 'No "source" path given';
-        resolve(data);
-      } else {
-        data.source = srcPath;
-        fse.writeFile(srcPath, content, 'utf8').then(result => {
-          resolve(data);
-        }).catch(err => {
-          const { isSucceed } = checkFsError(data, err);
-          if (isSucceed) resolve(data);
-          // // TODO: [?] consider check others
-          //console.log('CHECK: TXEpgContentProvider.saveToFile() => Error => '+err);
-          //console.log('CHECK: TXEpgContentProvider.saveToFile() => Error => '+err.code);
-          reject(err);
-        });
-      };
-    } else {
-      data.isERR = true;
-      data.errEvent = 'ERR_INVARG';
-      data.errMsg = 'The "content" argument must be a string';
-      resolve(data);
-    };
-  });
-};
-
-/***
- * (* class definitions *)
- */
-
-// === module exports block ===
-
-module.exports.checkFsError = checkFsError;
-module.exports.loadFile = loadFile;
-module.exports.loadFileSync = loadFileSync;
-module.exports.saveToFile = saveToFile;
-module.exports.saveToFileSync = saveToFileSync;