@ygracs/xepg-lib-js 0.0.21 → 0.0.22

package/lib/xepgdoc-lib.js

@@ -1,4 +1,4 @@
-// [v0.1.081-20250227]
+// [v0.2.098-20250306]
 
 // === module init block ===
 
@@ -13,6 +13,7 @@ const {
 
 const {
   convValueToTZString, convTZStringToValue,
+  tryDTValue,
 } = require('@ygracs/dtf-lib-js');
 
 const {
@@ -28,8 +29,10 @@ const {
 const xObj = require('@ygracs/xobj-lib-js');
 
 const TXmlContentParseOptions = xObj.TXmlContentParseOptions;
-const insertXObjElement = xObj.insertXObjElement;
-const getXObjElement = xObj.getXObjElement;
+const {
+  getXObjElement,
+  insertXObjElement,
+} = xObj;
 
 // === module extra block (helper functions) ===
 
@@ -55,12 +58,30 @@ function writeXObjAttr(obj, name, value) {
  * === xObj-function wrappers (end) ===
  */
 
-function _getXmlChildElementParam(obj, elem){
+/**
+ * @param {object} obj
+ * @param {string} elem
+ * @returns {string}
+ * @inner
+ */
+function _getXmlChildElementParam(obj, elem) {
   const child = obj ? getXObjElement(obj, elem) : null;
   return child ? readXObjParam(child) : '';
 };
 
-function writeXEpgDocDeclSection(obj, opt){
+/**
+ * @param {object} obj
+ * @returns {number}
+ * @inner
+ */
+function _getDTSTypeValueForXObj(obj) {
+  const result = valueToIndex(
+    _getXmlChildElementParam(obj, 'value')
+  );
+  return chkDTSysID(result) ? result : 0; //-1; // // TODO: [?]
+};
+
+function writeXEpgDocDeclSection(obj, opt) {
   let xml_ver = XEPG_XML_DOC_VERSION;
   let doc_def_enc = XEPG_DEF_ENCODING_VALUE;
   let key_name = defParseOptions.settings.declarationKey;
@@ -81,6 +102,11 @@ function writeXEpgDocDeclSection(obj, opt){
  * (* constant definitions *)
  */
 
+/**
+ * A list of a document schema version supported by a library
+ */
+const ALLOWED_XEPG_DOCUMENT_SCHEMA = [ '0.2' ];
+
 const XEPG_ROOT_ETAG_NAME = 'epgdoc';
 const XEPG_DEF_NS_NAME = 'tvp';
 const XEPG_DEF_NS_PATH = 'urn:e-doc:epg-doc:xepg';
@@ -106,9 +132,9 @@ const XEPG_SCHEDDESC_ETAG_NAME = `${XEPG_DEF_NS_NAME}:desc`;
 const XEPG_XML_DOC_VERSION = '1.0';
 const XEPG_DEF_ENCODING_VALUE = 'UTF-8';
 const XEPG_DEF_DOCUMENT_TYPE = 'xepg';
-const XEPG_DEF_DOCUMENT_SCHEMA = '0.2';
+const XEPG_DEF_DOCUMENT_SCHEMA = ALLOWED_XEPG_DOCUMENT_SCHEMA[0];
 const XEPG_DEF_PROVIDER_NAME = 'xepg-lib-js';
-const XEPG_DEF_PROVIDER_VER = '0.0.15';
+const XEPG_DEF_PROVIDER_VER = '0.0.21';
 
 const defXEpgDocOptions = {
   xmlns_xepg_pref: XEPG_DEF_NS_NAME,
@@ -149,6 +175,250 @@ const defParseOptions = new TXmlContentParseOptions();
  * @description A schedule info descriptor
  */
 
+/**
+ * @classdesc This class implements an interface of a EPG-schedule element
+ */
+class TXEpgScheduleItem {
+  /** @property {object} */
+  #_host;// = null;
+  /** @property {object} */
+  #_options;// = null;
+  /** @property {TXmlContentParseOptions} */
+  #_parseOptions;// = null;
+  /** @property {?object} */
+  #_dts_src = null;
+  /** @property {?object} */
+  #_tz_src = null;
+
+  /**
+   * @param {object} obj - host object
+   * @param {object} [opt] - options
+   * @param {object} [opt.parseOptions]
+   * @param {?object} [opt.dts_src]
+   * @param {?object} [opt.tz_src]
+   * @description Creates an instance of the EPG-schedule element
+   */
+  constructor(obj, opt) {
+    // load content
+    const _host = isPlainObject(obj) ? obj : {};
+    // load options
+    const _options = isPlainObject(opt) ? opt : {};
+    let {
+      parseOptions,
+      dts_src, tz_src,
+    } = _options;
+    if (!(parseOptions instanceof TXmlContentParseOptions)) {
+      parseOptions = new TXmlContentParseOptions(parseOptions);
+      _options.parseOptions = parseOptions;
+    };
+    if (!isPlainObject(dts_src)) dts_src = null;
+    if (!isPlainObject(tz_src)) tz_src = null;
+    // save content source
+    this.#_host = _host;
+    // save options
+    this.#_options = _options;
+    // save parser options
+    this.#_parseOptions = parseOptions;
+    // save refs to a time source priveders
+    this.#_dts_src = dts_src;
+    this.#_tz_src = tz_src;
+  }
+
+  /**
+   * Contains a dtstype ID
+   * @property {number}
+   * @readonly
+   */
+  get dtstype() {
+    return _getDTSTypeValueForXObj(this.#_dts_src);
+  }
+
+  /**
+   * Contains a TZ-offset
+   * @property {number}
+   * @readonly
+   */
+  get curDocTZ() {
+    return (
+      this.#_tz_src
+      ? convTZStringToValue(readXObjParam(this.#_tz_src).trim())
+      : 0
+    );
+  }
+
+  /**
+   * Contains a schedule start time as a timestamp
+   * @property {number}
+   * @readonly
+   */
+  get time() {
+    return convStringToDTValue(
+      _getXmlChildElementParam(this.#_host, XEPG_SCHEDTIME_ETAG_NAME).trim(),
+      this.dtstype, this.curDocTZ
+    );
+  }
+
+  /**
+   * Contains a schedule title
+   * @property {string}
+   * @readonly
+   */
+  get title() {
+    return _getXmlChildElementParam(this.#_host, XEPG_SCHEDTITL_ETAG_NAME).trim();
+  }
+
+  /**
+   * Contains a schedule category
+   * @property {string}
+   * @readonly
+   */
+  get category() {
+    return _getXmlChildElementParam(this.#_host, XEPG_SCHEDCAT_ETAG_NAME).trim();
+  }
+
+  /**
+   * Contains a schedule rating value (aka pcmark)
+   * @property {number}
+   * @readonly
+   */
+  get rating() {
+    return readAsNumberEx(
+      _getXmlChildElementParam(this.#_host, XEPG_SCHEDPMARK_ETAG_NAME), 0
+    );
+  }
+
+  /**
+   * Contains a schedule description
+   * @property {string}
+   * @readonly
+   */
+  get descr() {
+    return _getXmlChildElementParam(this.#_host, XEPG_SCHEDDESC_ETAG_NAME);
+  }
+
+  /**
+   * @returns {xepgShedInfoDesc}
+   * @description Returns a schedule info item descriptor
+   */
+  getInfo() {
+    const {
+      time,
+      title,
+      category: cat,
+      rating: pcmark,
+      descr,
+    } = this;
+    return {
+      time,
+      title,
+      cat,
+      pcmark,
+      descr,
+    };
+  }
+
+  /**
+   * @param {(number|string|Date)} value - some time value
+   * @returns {boolean}
+   * @description Sets a schedule start time.
+   */
+  setTime(value) {
+    let { isSucceed, value: dtValue } = tryDTValue(value);
+    let result = false;
+    if (isSucceed) {
+      dtValue = convDTValueToString(dtValue, this.dtstype, this.curDocTZ);
+      if (dtValue !== '') {
+        const opt = { force: true };
+        const item = insertXObjElement(this.#_host, XEPG_SCHEDTIME_ETAG_NAME, opt);
+        if (item) result = writeXObjParam(item, dtValue);
+      };
+    };
+    return result;
+  }
+
+  /**
+   * @param {string} value - some title
+   * @returns {boolean}
+   * @description Sets a schedule title.
+   */
+  setTitle(value) {
+    let result = false;
+    if (typeof value === 'string') {
+      const opt = { force: true };
+      const item = insertXObjElement(this.#_host, XEPG_SCHEDTITL_ETAG_NAME, opt);
+      if (item) result = writeXObjParam(item, value.trim());
+    };
+    return result;
+  }
+
+  /**
+   * @param {string} value - some title
+   * @returns {boolean}
+   * @description Sets a schedule title.
+   */
+  setCategory(value) {
+    let result = false;
+    if (typeof value === 'string') {
+      const opt = { force: true };
+      const item = insertXObjElement(this.#_host, XEPG_SCHEDCAT_ETAG_NAME, opt);
+      if (item) result = writeXObjParam(item, value.trim());
+    };
+    return result;
+  }
+
+  /**
+   * @param {(number|string)} value - some value
+   * @returns {boolean}
+   * @description Sets a schedule rating value.
+   */
+  setRating(value) {
+    const _value = valueToIndex(value);
+    let result = false;
+    if (_value !== -1) {
+      const opt = { force: true };
+      const item = insertXObjElement(this.#_host, XEPG_SCHEDPMARK_ETAG_NAME, opt);
+      if (item) result = writeXObjParam(item, _value);
+    };
+    return result;
+  }
+
+  /**
+   * @param {string} value - some text
+   * @returns {boolean}
+   * @description Sets a schedule description.
+   */
+  setDescr(value) {
+    let result = false;
+    if (typeof value === 'string') {
+      const opt = { force: true };
+      const item = insertXObjElement(this.#_host, XEPG_SCHEDDESC_ETAG_NAME, opt);
+      if (item) result = writeXObjParam(item, value.trim());
+    };
+    return result;
+  }
+
+  /**
+   * @returns {string}
+   * @description Returns an instance content as a string in an XML-format.
+   */
+  saveToXMLString() {
+    const options = this.#_parseOptions.js2xml;
+    options.ignoreDocType = true;
+    options.ignoreDeclaration = true;
+    const content = { [`${XEPG_SCHED_ETAG_NAME}`]: this.#_host };
+    let result = '';
+    try {
+      result = xmlParser.js2xml(content, options);
+    } catch (err) {
+      //console.log('CHECK: TXEpgHeaderContainer.saveToXMLString() => Error => '+err);
+      result = '';
+      //throw err;
+    };
+    return result;
+  }
+
+};
+
 /**
  * @classdesc This class implements an interface of a EPG-schedules list
  */
@@ -205,19 +475,13 @@ class TXEpgSchedulesList {
     return this.#_content.length;
   }
 
-  // will deprecate
-  //get SchedulesQty(){ return this.#_content.length; }
-
   /**
    * Contains a dtstype ID
    * @property {number}
    * @readonly
    */
   get dtstype() {
-    let result = valueToIndex(
-      _getXmlChildElementParam(this.#_dts_src, 'value')
-    );
-    return chkDTSysID(result) ? result : 0; //-1; // // TODO: [?]
+    return _getDTSTypeValueForXObj(this.#_dts_src);
   }
 
   /**
@@ -255,6 +519,8 @@ class TXEpgSchedulesList {
    * @deprecated
    * @description Checks whether a given value is a valid index
    *              and it fits the index range of an instance
+   * @done [since v0.0.20] deprecated
+   * @todo [from v0.0.23] will be removed
    */
   chkScheduleIndex(value) {
     return this.chkIndex(value);
@@ -263,7 +529,7 @@ class TXEpgSchedulesList {
   /**
    * @param {(number|string)} value - index of some element
    * @returns {boolean}
-   * @since 0.0.18
+   * @since 0.0.20
    * @description Checks whether a given value is a valid index
    *              and it fits the index range of an instance
    */
@@ -274,36 +540,31 @@ class TXEpgSchedulesList {
 
   /**
    * @param {(number|string)} index - index of some element
-   * @returns {xepgShedInfoDesc}
+   * @returns {?TXEpgScheduleItem}
+   * @since 0.0.22
+   * @description Returns a schedule element addressed by a given index
+   */
+  schedule(index) {
+    const curObj = this.#_getItem(index);
+    let item = null;
+    if (isPlainObject(curObj)) {
+      item = new TXEpgScheduleItem(curObj, {
+        dts_src: this.#_dts_src,
+        tz_src: this.#_tz_src,
+      });
+    };
+    return item;
+  }
+
+  /**
+   * @param {(number|string)} index - index of some element
+   * @returns {?xepgShedInfoDesc}
    * @description Returns a schedule info item for instance element
    *              addressed by a given index
    */
   getScheduleInfo(index) {
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => was called...');
-    const curObj = this.#_getItem(index);
-    let tmpObj = {};
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+']');
-    //console.log('TXEpgSchedulesList => getScheduleInfo('+index+') => '+JSON.stringify(curObj, null, 2));
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [time]');
-    tmpObj.time = convStringToDTValue(
-      _getXmlChildElementParam(curObj, XEPG_SCHEDTIME_ETAG_NAME).trim(),
-      this.dtstype, this.curDocTZ
-    );
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [title]');
-    tmpObj.title = _getXmlChildElementParam(curObj, XEPG_SCHEDTITL_ETAG_NAME).trim();
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [category]');
-    tmpObj.cat = _getXmlChildElementParam(curObj, XEPG_SCHEDCAT_ETAG_NAME).trim();
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [pcmark]');
-    tmpObj.pcmark = readAsNumberEx(
-      _getXmlChildElementParam(curObj, XEPG_SCHEDPMARK_ETAG_NAME), 0
-    );
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [description]');
-    tmpObj.descr = _getXmlChildElementParam(curObj, XEPG_SCHEDDESC_ETAG_NAME);
-    //console.log('TXEpgSchedulesList => getScheduleInfo('+index+') => '+JSON.stringify(curObj, null, 2));
-    //console.log('TXEpgSchedulesList => getScheduleInfo('+index+') => '+JSON.stringify(tmpObj, null, 2));
-    // TODO: wrap tmpObj into container object
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => was left...');
-    return tmpObj;
+    const obj = this.schedule(index);
+    return obj ? obj.getInfo() : null;
   }
 
   /**
@@ -350,7 +611,7 @@ class TXEpgProviderContainer {
   /** @property {?TXEpgDTSProvider} */
 
   /**
-   * @param {object} obj
+   * @param {object} obj - host object
    * @param {object} [opt] - options
    * @param {object} [opt.parseOptions]
    * @description Creates an instance of the EPG-provider element
@@ -565,7 +826,214 @@ class TXEpgProviderContainer {
 };
 
 /**
- * @classdesc This class implements an instance of a DTS-provider element
+ * @typedef {Object} xepgChnInfoDesc
+ * @property {string} chnid - channel ID
+ * @property {string} chname - channel name
+ * @property {string} [chngid] - channel 'Group ID'
+ * @property {string} [srcurl] - EPG-source URL
+ * @description A channel info descriptor
+ */
+
+/**
+ * @classdesc This class implements an interface of a channel element
+ */
+class TXEpgChannelContainer {
+  /** @property {object} */
+  #_host;// = null;
+  /** @property {object} */
+  #_options;// = null;
+  /** @property {TXmlContentParseOptions} */
+  #_parseOptions;// = null;
+  /** @property {string} */
+  #_xepgSchema;// = null;
+
+  /**
+   * @param {object} obj - host object
+   * @param {object} [opt] - options
+   * @param {object} [opt.parseOptions]
+   * @description Creates an instance of the channel element
+   */
+  constructor(obj, opt) {
+    // load content
+    const _host = isPlainObject(obj) ? obj : {};
+    // load options
+    const _options = isPlainObject(opt) ? opt : {};
+    let {
+      parseOptions,
+    } = _options;
+    if (!(parseOptions instanceof TXmlContentParseOptions)) {
+      parseOptions = new TXmlContentParseOptions(parseOptions);
+      _options.parseOptions = parseOptions;
+    };
+    // set document schema version
+    this.#_xepgSchema = XEPG_DEF_DOCUMENT_SCHEMA;
+    // save options
+    this.#_options = _options;
+    // save parser options
+    this.#_parseOptions = parseOptions;
+    // save content source
+    this.#_host = _host;
+  }
+
+  /**
+   * Contains a channel ID
+   * @returns {string}
+   * @readonly
+   */
+  get id() {
+    return _getXmlChildElementParam(this.#_host, XEPG_CHNID_ETAG_NAME).trim();
+  }
+
+  /**
+   * Contains a channel name
+   * @returns {string}
+   */
+  get name() {
+    return _getXmlChildElementParam(this.#_host, XEPG_CHNNAME_ETAG_NAME).trim();
+  }
+
+  set name(value) {
+    if (typeof value === 'string' && this.id !== '') {
+      const item = insertXObjElement(
+        this.#_host,
+        XEPG_CHNNAME_ETAG_NAME,
+        { force: true },
+      );
+      if (item) writeXObjParam(item, value.trim());
+    };
+  }
+
+  /**
+   * Contains a channel Group ID
+   * @returns {string}
+   */
+  get gid() {
+    return _getXmlChildElementParam(this.#_host, XEPG_CHNGID_ETAG_NAME).trim();
+  }
+
+  set gid(value) {
+    if (typeof value === 'string' && this.id !== '') {
+      const item = insertXObjElement(
+        this.#_host,
+        XEPG_CHNGID_ETAG_NAME,
+        { force: true },
+      );
+      if (item) writeXObjParam(item, value.trim());
+    };
+  }
+
+  /**
+   * Contains a channel source URL
+   * @returns {string}
+   */
+  get url() {
+    return _getXmlChildElementParam(this.#_host, XEPG_CHNURL_ETAG_NAME).trim();
+  }
+
+  set url(value) {
+    if (typeof value === 'string' && this.id !== '') {
+      const item = insertXObjElement(
+        this.#_host,
+        XEPG_CHNURL_ETAG_NAME,
+        { force: true },
+      );
+      if (item) writeXObjParam(item, value.trim());
+    };
+  }
+
+  /**
+   * @param {string} value - channel ID
+   * @returns {boolean}
+   * @description Tries to set a channel ID
+   */
+  setID(value) {
+    let isSucceed = false;
+    if (typeof value === 'string') {
+      const chnid = value.trim();
+      const item = insertXObjElement(
+        this.#_host,
+        XEPG_CHNID_ETAG_NAME,
+        { force: true },
+      );
+      if (item) {
+        isSucceed = writeXObjParam(item, chnid);
+      };
+    };
+    return isSucceed;
+  }
+
+  /**
+   * @returns {xepgChnInfoDesc}
+   * @description Returns a channel info
+   */
+  getInfo() {
+    const {
+      id: chnid,
+      name: chname,
+      gid: chngid,
+      url: srcurl,
+    } = this;
+    /** @type {xepgChnInfoDesc} */
+    return {
+      chnid,
+      chname,
+      chngid,
+      srcurl,
+    };
+  }
+
+  /**
+   * @param {(string|xepgChnInfoDesc)} obj - channel info descriptor
+   * @returns {void}
+   * @description Sets a channel info
+   */
+  setInfo(obj) {
+    let chnid = '';
+    let chname = '';
+    let chngid = '';
+    let srcurl = '';
+    if (isObject(obj)) {
+      ({ chnid } = obj);
+      if (typeof chnid === 'string') {
+        ({ chname, chngid, srcurl } = obj);
+      } else {
+        // // TODO: [?] deprecate
+        chnid = _getXmlChildElementParam(obj, XEPG_CHNID_ETAG_NAME).trim();
+        chname = _getXmlChildElementParam(obj, XEPG_CHNNAME_ETAG_NAME).trim();
+        chngid = _getXmlChildElementParam(obj, XEPG_CHNGID_ETAG_NAME).trim();
+        srcurl = _getXmlChildElementParam(obj, XEPG_CHNURL_ETAG_NAME).trim();
+      };
+    } else if (typeof obj === 'string') {
+      chnid = obj;
+    } else {
+      return;
+    };
+    chnid = typeof chnid === 'string' ? chnid.trim() : '';
+    if (chnid === '') {
+      chname = '';
+      chngid = '';
+      srcurl = '';
+    } else {
+      chname = typeof chname === 'string' ? chname.trim() : '';
+      chngid = typeof chngid === 'string' ? chngid.trim() : '';
+      srcurl = typeof srcurl === 'string' ? srcurl.trim() : '';
+    };
+    let item = null;
+    const _host = this.#_host;
+    item = insertXObjElement(_host, XEPG_CHNID_ETAG_NAME, { force: true });
+    if (item) writeXObjParam(item, chnid);
+    item = insertXObjElement(_host, XEPG_CHNNAME_ETAG_NAME, { force: true });
+    if (item) writeXObjParam(item, chname);
+    item = insertXObjElement(_host, XEPG_CHNGID_ETAG_NAME, { force: true });
+    if (item) writeXObjParam(item, chngid);
+    item = insertXObjElement(_host, XEPG_CHNURL_ETAG_NAME, { force: true });
+    if (item) writeXObjParam(item, srcurl);
+  }
+
+}
+
+/**
+ * @classdesc This class implements an interface of a DTS-provider element
  */
 class TXEpgDTSProvider {
   /** @property {object} */
@@ -574,7 +1042,7 @@ class TXEpgDTSProvider {
   #_options;// = null;
 
   /**
-   * @param {object} obj
+   * @param {object} obj - host object
    * @param {object} [opt] - options
    * @param {object} [opt.parseOptions]
    * @description Creates an instance of the DTS-provider element
@@ -614,32 +1082,12 @@ class TXEpgDTSProvider {
   get dtstype() {
     const item = getXObjElement(this.#_content, XEPG_DTSINFO_ETAG_NAME);
     let result = 0; //-1; // // TODO: [?]
-    if (isPlainObject(item)) {
-      result = valueToIndex(_getXmlChildElementParam(item, 'value'));
-      if (!chkDTSysID(result)) result = 0; //-1; // // TODO: [?]
-    };
+    if (isPlainObject(item)) result = _getDTSTypeValueForXObj(item);
     return result;
   }
 
   set dtstype(value) {
-    let { index, name } = getDTSysDescr(value);
-    if (index !== -1) {
-      const item = insertXObjElement(
-        this.#_content,
-        XEPG_DTSINFO_ETAG_NAME,
-        { force: true },
-      );
-      if (item) {
-        let curItem = insertXObjElement(item, 'value', { force: true });
-        if (
-          curItem
-          && writeXObjParam(curItem, index)
-          && (curItem = insertXObjElement(item, 'name', { force: true }))
-        ) {
-          writeXObjParam(curItem, name);
-        };
-      };
-    };
+    return this.setType(value);
   }
 
   /**
@@ -665,19 +1113,39 @@ class TXEpgDTSProvider {
     };
   }
 
-};
+  /**
+   * @since 0.0.22
+   * @property {(number|string)} value - dtstype ID
+   * @returns {boolean}
+   * @description Tries to set a `DTS`-type
+   */
+  setType(value) {
+    let { index, name } = getDTSysDescr(value);
+    let isSucceed = false;
+    if (index !== -1) {
+      const item = insertXObjElement(
+        this.#_content,
+        XEPG_DTSINFO_ETAG_NAME,
+        { force: true },
+      );
+      if (item) {
+        let curItem = insertXObjElement(item, 'value', { force: true });
+        if (
+          curItem
+          && writeXObjParam(curItem, index)
+          && (curItem = insertXObjElement(item, 'name', { force: true }))
+        ) {
+          isSucceed = writeXObjParam(curItem, name);
+        };
+      };
+    };
+    return isSucceed;
+  }
 
-/**
- * @typedef {Object} xepgChnInfoDesc
- * @property {string} chnid - channel ID
- * @property {string} chname - channel name
- * @property {string} [chngid] - channel 'Group ID'
- * @property {string} [srcurl] - EPG-source URL
- * @description A channel info descriptor
- */
+};
 
 /**
- * @classdesc This class implements an instance of a EPG-header element
+ * @classdesc This class implements an interface of a EPG-header element
  */
 class TXEpgHeaderContainer {
   /** @property {Object} */
@@ -775,11 +1243,22 @@ class TXEpgHeaderContainer {
   }
 
   /**
+   * Returns a `TXEpgProviderContainer` instance
    * @property {?TXEpgProviderContainer}
    * @readonly
-   * @description Returns a `TXEpgProviderContainer` instance
+   * @deprecated
    */
   get Provider() {
+    return this.provider;
+  }
+
+  /**
+   * Returns a `TXEpgProviderContainer` instance
+   * @since 0.0.22
+   * @property {?TXEpgProviderContainer}
+   * @readonly
+   */
+  get provider() {
     const docProv = this.#_getProv();
     return (
       docProv
@@ -788,6 +1267,16 @@ class TXEpgHeaderContainer {
     );
   }
 
+  /**
+   * Returns a `TXEpgChannelContainer` instance
+   * @since 0.0.22
+   * @property {?TXEpgChannelContainer}
+   * @readonly
+   */
+  get channel() {
+    return new TXEpgChannelContainer(this.#_host, this.#_options);
+  }
+
   /**
    * @returns {number}
    * @description Returns a document creation date as a timestamp
@@ -849,67 +1338,25 @@ class TXEpgHeaderContainer {
    * @description Returns a channel info
    */
   getChannelInfo() {
-    const _host = this.#_host;
-    /** @type {xepgChnInfoDesc} */
-    let item = {
-      chnid: _getXmlChildElementParam(_host, XEPG_CHNID_ETAG_NAME).trim(),
-      chname: _getXmlChildElementParam(_host, XEPG_CHNNAME_ETAG_NAME).trim(),
-      chngid: _getXmlChildElementParam(_host, XEPG_CHNGID_ETAG_NAME).trim(),
-      srcurl: _getXmlChildElementParam(_host, XEPG_CHNURL_ETAG_NAME).trim(),
-    };
-    return item;
+    return this.channel.getInfo();
   }
 
   /**
    * @param {xepgChnInfoDesc} obj - channel info descriptor
    * @returns {void}
    * @description Sets a channel info
+   * @deprecated
    * @todo [since v0.0.21] deprecate use of `obj`-param as array
+   * @todo [since v0.0.22] deprecated
    */
   setChannelInfo(obj) {
-    let chnid = '';
-    let chname = '';
-    let chngid = '';
-    let srcurl = '';
+    let _obj = obj;
     if (isArray(obj)) {
       // // TODO: [!] deprecate
-      [ chnid, chname, chngid, srcurl ] = obj;
-    } else if (isObject(obj)) {
-      ({ chnid } = obj);
-      if (typeof chnid === 'string') {
-        ({ chname, chngid, srcurl } = obj);
-      } else {
-        // // TODO: [?] deprecate
-        chnid = _getXmlChildElementParam(obj, XEPG_CHNID_ETAG_NAME).trim();
-        chname = _getXmlChildElementParam(obj, XEPG_CHNNAME_ETAG_NAME).trim();
-        chngid = _getXmlChildElementParam(obj, XEPG_CHNGID_ETAG_NAME).trim();
-        srcurl = _getXmlChildElementParam(obj, XEPG_CHNURL_ETAG_NAME).trim();
-      };
-    } else if (typeof obj === 'string') {
-      chnid = obj;
-    } else {
-      return;
+      const [ chnid, chname, chngid, srcurl ] = _obj;
+      _obj = { chnid, chname, chngid, srcurl };
     };
-    chnid = typeof chnid === 'string' ? chnid.trim() : '';
-    if (chnid === '') {
-      chname = '';
-      chngid = '';
-      srcurl = '';
-    } else {
-      chname = typeof chname === 'string' ? chname.trim() : '';
-      chngid = typeof chngid === 'string' ? chngid.trim() : '';
-      srcurl = typeof srcurl === 'string' ? srcurl.trim() : '';
-    };
-    let item = null;
-    const _host = this.#_host;
-    item = insertXObjElement(_host, XEPG_CHNID_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chnid);
-    item = insertXObjElement(_host, XEPG_CHNNAME_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chname);
-    item = insertXObjElement(_host, XEPG_CHNGID_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chngid);
-    item = insertXObjElement(_host, XEPG_CHNURL_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, srcurl);
+    return this.channel.setInfo(_obj);
   }
 
   /**
@@ -917,7 +1364,7 @@ class TXEpgHeaderContainer {
    * @description Returns a provider info
    */
   getProviderInfo(){
-    const docProv = this.Provider;
+    const docProv = this.provider;
     return docProv ? docProv.getInfo() : null;
   }
 
@@ -928,10 +1375,10 @@ class TXEpgHeaderContainer {
    */
   setProviderInfo(obj){
     if (isArray(obj) || isObject(obj)) {
-      let docProv = this.Provider;
+      let docProv = this.provider;
       if (!docProv) {
         docProv = this.#_initProv();
-        if (docProv) docProv = this.Provider;
+        if (docProv) docProv = this.provider;
       };
       if (docProv) docProv.setInfo(obj);
     };
@@ -1098,6 +1545,7 @@ class TXEpgContentProvider {
    * Returns a `TXEpgHeaderContainer` instance
    * @property {?TXEpgHeaderContainer}
    * @readonly
+   * @deprecated
    */
   get Header() {
     const docHdr = this.#_getHdr();
@@ -1108,14 +1556,41 @@ class TXEpgContentProvider {
     );
   }
 
+  /**
+   * Returns a `TXEpgHeaderContainer` instance
+   * @since 0.0.22
+   * @property {?TXEpgHeaderContainer}
+   * @readonly
+   */
+  get header() {
+    const docHdr = this.#_getHdr();
+    return (
+      docHdr
+      ? new TXEpgHeaderContainer(docHdr, this.#_options)
+      : null
+    );
+  }
+
   /**
    * Returns a `TXEpgProviderContainer` instance
    * @property {?TXEpgProviderContainer}
    * @readonly
+   * @deprecated
    */
   get Provider() {
-    const docHdr = this.Header;
-    return docHdr ? docHdr.Provider : null;
+    const docHdr = this.header;
+    return docHdr ? docHdr.provider : null;
+  }
+
+  /**
+   * Returns a `TXEpgProviderContainer` instance
+   * @since 0.0.22
+   * @property {?TXEpgProviderContainer}
+   * @readonly
+   */
+  get provider() {
+    const docHdr = this.header;
+    return docHdr ? docHdr.provider : null;
   }
 
   /**
@@ -1124,7 +1599,7 @@ class TXEpgContentProvider {
    * @readonly
    */
   get dts() {
-    const docHdr = this.Header;
+    const docHdr = this.header;
     return docHdr ? docHdr.dts : null;
   }
 
@@ -1181,7 +1656,7 @@ class TXEpgContentProvider {
         docHdr,
         XEPG_PRVINFO_ETAG_NAME,
       );
-      if (docProv) this.Provider.init();
+      if (docProv) this.provider.init();
       // initiate document body element
       let docBody = this.#_getBody();
       if (!docBody) docBody = this.#_initBody();
@@ -1393,16 +1868,18 @@ class TXEpgContentProvider {
 
 // === module exports block ===
 
-exports.TXEpgDTSProvider = TXEpgDTSProvider;
-exports.TXEpgSchedulesList = TXEpgSchedulesList;
-exports.TXEpgProviderContainer = TXEpgProviderContainer;
-exports.TXEpgHeaderContainer = TXEpgHeaderContainer;
-exports.TXEpgContentProvider = TXEpgContentProvider;
+module.exports.TXEpgDTSProvider = TXEpgDTSProvider;
+module.exports.TXEpgScheduleItem = TXEpgScheduleItem;
+module.exports.TXEpgSchedulesList = TXEpgSchedulesList;
+module.exports.TXEpgProviderContainer = TXEpgProviderContainer;
+module.exports.TXEpgChannelContainer = TXEpgChannelContainer;
+module.exports.TXEpgHeaderContainer = TXEpgHeaderContainer;
+module.exports.TXEpgContentProvider = TXEpgContentProvider;
 
-exports.XEPG_DEF_PROVIDER_NAME = XEPG_DEF_PROVIDER_NAME;
-exports.XEPG_DEF_PROVIDER_VER = XEPG_DEF_PROVIDER_VER;
-exports.XEPG_DEF_DOCUMENT_TYPE = XEPG_DEF_DOCUMENT_TYPE;
-exports.XEPG_DEF_DOCUMENT_SCHEMA = XEPG_DEF_DOCUMENT_SCHEMA;
+module.exports.XEPG_DEF_PROVIDER_NAME = XEPG_DEF_PROVIDER_NAME;
+module.exports.XEPG_DEF_PROVIDER_VER = XEPG_DEF_PROVIDER_VER;
+module.exports.XEPG_DEF_DOCUMENT_TYPE = XEPG_DEF_DOCUMENT_TYPE;
+module.exports.XEPG_DEF_DOCUMENT_SCHEMA = XEPG_DEF_DOCUMENT_SCHEMA;
 
 /** @deprecated */
-exports.TXepgDTSProvider = TXEpgDTSProvider;
+module.exports.TXepgDTSProvider = TXEpgDTSProvider;