@teqfw/di 0.31.0 → 0.33.0

package/RELEASE.md

@@ -1,5 +1,19 @@
 # @teqfw/di releases
 
+## 0.33.0 – Cleanup and Enhancements
+
+- Removed deprecated documentation.
+- Updated ESLint rules for consistency with current platform practices.
+- Introduced `#` as a separator (in addition to `.`) between namespace and export names.
+
+## 0.32.0 - added support for the `node:` prefix
+
+- **Added ability** to manually register objects in the container (`register`).
+- **Optimized dependency parsing**, added support for the `node:` prefix.
+- **Updated singleton handling**, fixed issues with `Defs.LS`.
+- **Added protection against object modification**, freezing objects when possible (`Object.freeze`).
+- **Updated dependencies** (Mocha, Rollup, Rollup plugins).
+
 ## 0.31.0
 
 * Added optional `stack` parameter to the `get` method for improved dependency tracking and debugging.

package/bin/release/clean.sh

@@ -9,5 +9,6 @@ rm -fr "${DIR_ROOT}/doc/"
 rm -fr "${DIR_ROOT}/docs/"
 rm -fr "${DIR_ROOT}/example/"
 rm -fr "${DIR_ROOT}/node_modules/"
+rm -fr "${DIR_ROOT}/package-lock.json"
 rm -fr "${DIR_ROOT}/test/"
 rm -fr "${DIR_ROOT}/tmp/"

package/dist/esm.js

@@ -1 +1 @@
-var e={COMP_A:"A",COMP_F:"F",ID:"container",ID_FQN:"TeqFw_Di_Container$",LIFE_I:"I",LIFE_S:"S",isClass(e){const t=Object.getOwnPropertyDescriptor(e,"prototype");return t&&!t.writable}};const t=/(function)*\s*\w*\s*\(\s*\{([^\}]*)\}/s,o=/constructor\s*\(\s*\{([^\}]*)\}/s;function s(e){const t=[];try{const o=new Function(`{${e}}`,"return");o(new Proxy({},{get:(e,o)=>t.push(o)}))}catch(t){throw new Error(`Cannot analyze the deps specification:${e}\n\nPlease, be sure that spec does not contain extra ')' in a comments.\n\nError: ${t}`)}return t}function n(n){return"function"==typeof n?e.isClass(n)?function(e){const t=[],n=e.toString(),r=o.exec(n);return r&&t.push(...s(r[1])),t}(n):function(e){const o=[],n=e.toString(),r=t.exec(n);return r&&o.push(...s(r[2])),o}(n):[]}class r{constructor(){let t=!1;this.create=async function(o,s,r,i){if(r.includes(o.value))throw new Error(`Circular dependency for '${o.value}'. Parents are: ${JSON.stringify(r)}`);if(o.exportName){const a=[...r,o.value],{[o.exportName]:u}=s;if(o.composition===e.COMP_F){if("function"==typeof u){const s=n(u);s.length&&(c=`Deps for object '${o.value}' are: ${JSON.stringify(s)}`,t&&console.log(c));const r={};for(const e of s)r[e]=await i.compose(e,a);const l=e.isClass(u)?new u(r):u(r);return l instanceof Promise?await l:l}return Object.assign({},u)}return u}return s;var c},this.setDebug=function(e){t=e}}}class i{exportName;composition;life;moduleName;value;wrappers=[]}const c=/^((([A-Z])[A-Za-z0-9_]*)((\.)?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?)$/;class a{canParse(e){return!0}parse(t){const o=new i;o.value=t;const s=c.exec(t);if(s&&(o.moduleName=s[2],"."===s[5]?"$"===s[7]||"$$"===s[7]?(o.composition=e.COMP_F,o.exportName=s[6],o.life="$"===s[7]?e.LIFE_S:e.LIFE_I):(o.composition=e.COMP_A,o.life=e.LIFE_S,o.exportName=""!==s[6]?s[6]:"default"):"$"===s[7]||"$$"===s[7]?(o.composition=e.COMP_F,o.exportName="default",o.life="$"===s[7]?e.LIFE_S:e.LIFE_I):(o.composition=void 0,o.exportName=void 0,o.life=void 0),s[11]&&(o.wrappers=s[11].split(","))),o.composition===e.COMP_A&&o.life===e.LIFE_I)throw new Error(`Export is not a function and should be used as a singleton only: '${o.value}'.`);return o}}class u{constructor(){let e=new a;const t=[];this.addChunk=function(e){t.push(e)},this.parse=function(o){let s;for(const e of t)if(e.canParse(o)){s=e.parse(o);break}return s||(s=e?.parse(o)),s},this.setDefaultChunk=function(t){e=t}}}class l{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=function(t,o){let s=t;for(const n of e)s=n.modify(s,t,o);return s}}}class f{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=async function(t,o,s){let n=t;for(const t of e)n=t.modify(n,o,s),n instanceof Promise&&(n=await n);return n}}}const p="root";class m{constructor(){const e={};let t=!1,o=[],s="/";this.addNamespaceRoot=function(s,n,r){const i=(t?n.replace(/^\\/,""):n).replace(/\\/g,"/"),c=t?`file://${i}`:i;e[s]={ext:r??"js",ns:s,[p]:c},o=Object.keys(e).sort(((e,t)=>t.localeCompare(e)))},this.resolve=function(t){let n,r,i;for(i of o)if(t.startsWith(i)){n=e[i][p],r=e[i].ext;break}if(n&&r){let e=t.replace(i,"");0===e.indexOf("_")&&(e=e.replace("_",""));const o=e.replaceAll("_",s);return`${n}${s}${o}.${r}`}return t},this.setWindowsEnv=function(e=!0){t=e,s=e?"\\":"/"}}}function d(e){return`${e.moduleName}#${e.exportName}`}class h{constructor(){let t=new r,o=!1,s=new u,n=new l,i=new f;const c={},a={};let p=new m;function h(){o&&console.log(...arguments)}this.get=async function(e,t=[]){return this.compose(e,t)},this.compose=async function(o,r=[]){if(h(`Object '${o}' is requested.`),o===e.ID||o===e.ID_FQN)return h("Container itself is returned."),a[e.ID];const u=s.parse(o),l=n.modify(u,r);if(l.life===e.LIFE_S){const e=d(l);if(a[e])return h(`Existing singleton '${e}' is returned.`),a[e]}let f;c[l.moduleName]||(h(`ES6 module '${l.moduleName}' is not resolved yet`),c[l.moduleName]=p.resolve(l.moduleName));const m=c[l.moduleName];try{f=await import(m),h(`ES6 module '${l.moduleName}' is loaded from '${m}'.`)}catch(e){throw console.error(e?.message,`Object key: "${o}".`,`Path: "${m}".`,`Stack: ${JSON.stringify(r)}`),e}let $=await t.create(l,f,r,this);if($=await i.modify($,l,r),h(`Object '${o}' is created.`),l.life===e.LIFE_S){const e=d(l);a[e]=$,h(`Object '${o}' is saved as singleton.`)}return $},this.getParser=()=>s,this.getPreProcessor=()=>n,this.getPostProcessor=()=>i,this.getResolver=()=>p,this.setDebug=function(e){o=e,t.setDebug(e)},this.setParser=e=>s=e,this.setPreProcessor=e=>n=e,this.setPostProcessor=e=>i=e,this.setResolver=e=>p=e,a[e.ID]=this}}export{h as default};
+var e={CA:"A",CF:"F",ID:"container",ID_FQN:"TeqFw_Di_Container$",LI:"I",LS:"S",isClass(e){const t=Object.getOwnPropertyDescriptor(e,"prototype");return t&&!t.writable}};const t=/(function)*\s*\w*\s*\(\s*\{([^}]*)}/s,o=/constructor\s*\(\s*\{([^}]*)}/s;function n(e){const t=[];try{const o=new Function(`{${e}}`,"return");o(new Proxy({},{get:(e,o)=>t.push(o)}))}catch(t){throw new Error(`Cannot analyze the deps specification:${e}\n\nPlease, be sure that spec does not contain extra ')' in a comments.\n\nError: ${t}`)}return t}function s(s){return"function"==typeof s?e.isClass(s)?function(e){const t=[],s=e.toString(),r=o.exec(s);return r&&t.push(...n(r[1])),t}(s):function(e){const o=[],s=e.toString(),r=t.exec(s);return r&&o.push(...n(r[2])),o}(s):[]}class r{constructor(){let t=!1;this.create=async function(o,n,r,i){if(r.includes(o.origin))throw new Error(`Circular dependency for '${o.origin}'. Parents are: ${JSON.stringify(r)}`);if(o.exportName){const a=[...r,o.origin],{[o.exportName]:u}=n;if(o.composition===e.CF){if("function"==typeof u){const n=s(u);n.length&&(c=`Deps for object '${o.origin}' are: ${JSON.stringify(n)}`,t&&console.log(c));const r={};for(const e of n)r[e]=await i.compose(e,a);const l=e.isClass(u)?new u(r):u(r);return l instanceof Promise?await l:l}return Object.assign({},u)}return u}return n;var c},this.setDebug=function(e){t=e}}}class i{exportName;composition;life;moduleName;origin;wrappers=[]}const c=/^(node:)?(@?[A-Za-z0-9_-]+\/?[A-Za-z0-9_-]*)(([.#])?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?$/;class a{canParse(){return!0}parse(t){const o=new i;o.origin=t;const n=c.exec(t);if(n&&(o.isNodeModule=Boolean(n[1]),o.moduleName=n[2].replace(/^node:/,""),"."===n[4]||"#"===n[4]?"$"===n[6]||"$$"===n[6]?(o.composition=e.CF,o.exportName=n[5],o.life="$"===n[6]?e.LS:e.LI):(o.composition=e.CA,o.life=e.LS,o.exportName=""!==n[5]?n[5]:"default"):"$"===n[6]||"$$"===n[6]?(o.composition=e.CF,o.exportName="default",o.life="$"===n[6]?e.LS:e.LI):(o.composition=void 0,o.exportName=void 0,o.life=void 0),n[10]&&(o.wrappers=n[10].split(","))),o.composition===e.CA&&o.life===e.LI)throw new Error(`Export is not a function and should be used as a singleton only: '${o.origin}'.`);return o}}class u{constructor(){let e=new a;const t=[];this.addChunk=function(e){t.push(e)},this.parse=function(o){let n;for(const e of t)if(e.canParse(o)){n=e.parse(o);break}return n||(n=e?.parse(o)),n},this.setDefaultChunk=function(t){e=t}}}class l{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=function(t,o){let n=t;for(const s of e)n=s.modify(n,t,o);return n}}}class f{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=async function(t,o,n){let s=t;for(const t of e)s=t.modify(s,o,n),s instanceof Promise&&(s=await s);return s}}}const p="root";class d{constructor(){const e={};let t=!1,o=[],n="/";this.addNamespaceRoot=function(n,s,r){const i=(t?s.replace(/^\\/,""):s).replace(/\\/g,"/"),c=t?`file://${i}`:i;e[n]={ext:r??"js",ns:n,[p]:c},o=Object.keys(e).sort(((e,t)=>t.localeCompare(e)))},this.resolve=function(t){let s,r,i;for(i of o)if(t.startsWith(i)){s=e[i][p],r=e[i].ext;break}if(s&&r){let e=t.replace(i,"");0===e.indexOf("_")&&(e=e.replace("_",""));const o=e.replaceAll("_",n);return`${s}${n}${o}.${r}`}return t},this.setWindowsEnv=function(e=!0){t=e,n=e?"\\":"/"}}}function m(e){return`${e.moduleName}#${e.exportName}`}class h{constructor(){let t=new r,o=!1,n=new u,s=new l,i=new f;const c={},a={};let p=new d;function h(){o&&console.log(...arguments)}this.get=async function(e,t=[]){return this.compose(e,t)},this.compose=async function(o,r=[]){if(h(`Object '${o}' is requested.`),o===e.ID||o===e.ID_FQN)return h("Container itself is returned."),a[e.ID];const u=n.parse(o),l=s.modify(u,r);if(l.life===e.LS){const e=m(l);if(a[e])return h(`Existing singleton '${e}' is returned.`),a[e]}let f;c[l.moduleName]||(h(`ES6 module '${l.moduleName}' is not resolved yet`),c[l.moduleName]=p.resolve(l.moduleName));const d=c[l.moduleName];try{f=await import(d),h(`ES6 module '${l.moduleName}' is loaded from '${d}'.`)}catch(e){throw console.error(e?.message,`Object key: "${o}".`,`Path: "${d}".`,`Stack: ${JSON.stringify(r)}`),e}let $=await t.create(l,f,r,this);var g;if(null===(g=$)||"object"!=typeof g&&"function"!=typeof g||"[object Module]"===Object.prototype.toString.call(g)||Object.isFrozen(g)||Object.freeze($),$=await i.modify($,l,r),h(`Object '${o}' is created.`),l.life===e.LS){const e=m(l);a[e]=$,h(`Object '${o}' is saved as singleton.`)}return $},this.getParser=()=>n,this.getPreProcessor=()=>s,this.getPostProcessor=()=>i,this.getResolver=()=>p,this.register=function(t,o){if(!t||!o)throw new Error("depId and object are required");const s=n.parse(t);if(s.life!==e.LS)throw new Error(`Only singletons can be registered manually. Given: ${t}`);{const e=m(s);a[e]=o,h(`Object '${t}' is registered manually as singleton.`)}},this.setDebug=function(e){o=e,t.setDebug(e)},this.setParser=e=>n=e,this.setPreProcessor=e=>s=e,this.setPostProcessor=e=>i=e,this.setResolver=e=>p=e,a[e.ID]=this}}export{h as default};

package/dist/umd.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).TeqFw_Di_Container=t()}(this,(function(){"use strict";var e={COMP_A:"A",COMP_F:"F",ID:"container",ID_FQN:"TeqFw_Di_Container$",LIFE_I:"I",LIFE_S:"S",isClass(e){const t=Object.getOwnPropertyDescriptor(e,"prototype");return t&&!t.writable}};const t=/(function)*\s*\w*\s*\(\s*\{([^\}]*)\}/s,o=/constructor\s*\(\s*\{([^\}]*)\}/s;function n(e){const t=[];try{const o=new Function(`{${e}}`,"return");o(new Proxy({},{get:(e,o)=>t.push(o)}))}catch(t){throw new Error(`Cannot analyze the deps specification:${e}\n\nPlease, be sure that spec does not contain extra ')' in a comments.\n\nError: ${t}`)}return t}function s(s){return"function"==typeof s?e.isClass(s)?function(e){const t=[],s=e.toString(),r=o.exec(s);return r&&t.push(...n(r[1])),t}(s):function(e){const o=[],s=e.toString(),r=t.exec(s);return r&&o.push(...n(r[2])),o}(s):[]}class r{constructor(){let t=!1;this.create=async function(o,n,r,i){if(r.includes(o.value))throw new Error(`Circular dependency for '${o.value}'. Parents are: ${JSON.stringify(r)}`);if(o.exportName){const a=[...r,o.value],{[o.exportName]:u}=n;if(o.composition===e.COMP_F){if("function"==typeof u){const n=s(u);n.length&&(c=`Deps for object '${o.value}' are: ${JSON.stringify(n)}`,t&&console.log(c));const r={};for(const e of n)r[e]=await i.compose(e,a);const l=e.isClass(u)?new u(r):u(r);return l instanceof Promise?await l:l}return Object.assign({},u)}return u}return n;var c},this.setDebug=function(e){t=e}}}class i{exportName;composition;life;moduleName;value;wrappers=[]}const c=/^((([A-Z])[A-Za-z0-9_]*)((\.)?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?)$/;class a{canParse(e){return!0}parse(t){const o=new i;o.value=t;const n=c.exec(t);if(n&&(o.moduleName=n[2],"."===n[5]?"$"===n[7]||"$$"===n[7]?(o.composition=e.COMP_F,o.exportName=n[6],o.life="$"===n[7]?e.LIFE_S:e.LIFE_I):(o.composition=e.COMP_A,o.life=e.LIFE_S,o.exportName=""!==n[6]?n[6]:"default"):"$"===n[7]||"$$"===n[7]?(o.composition=e.COMP_F,o.exportName="default",o.life="$"===n[7]?e.LIFE_S:e.LIFE_I):(o.composition=void 0,o.exportName=void 0,o.life=void 0),n[11]&&(o.wrappers=n[11].split(","))),o.composition===e.COMP_A&&o.life===e.LIFE_I)throw new Error(`Export is not a function and should be used as a singleton only: '${o.value}'.`);return o}}class u{constructor(){let e=new a;const t=[];this.addChunk=function(e){t.push(e)},this.parse=function(o){let n;for(const e of t)if(e.canParse(o)){n=e.parse(o);break}return n||(n=e?.parse(o)),n},this.setDefaultChunk=function(t){e=t}}}class l{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=function(t,o){let n=t;for(const s of e)n=s.modify(n,t,o);return n}}}class f{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=async function(t,o,n){let s=t;for(const t of e)s=t.modify(s,o,n),s instanceof Promise&&(s=await s);return s}}}const p="root";class d{constructor(){const e={};let t=!1,o=[],n="/";this.addNamespaceRoot=function(n,s,r){const i=(t?s.replace(/^\\/,""):s).replace(/\\/g,"/"),c=t?`file://${i}`:i;e[n]={ext:r??"js",ns:n,[p]:c},o=Object.keys(e).sort(((e,t)=>t.localeCompare(e)))},this.resolve=function(t){let s,r,i;for(i of o)if(t.startsWith(i)){s=e[i][p],r=e[i].ext;break}if(s&&r){let e=t.replace(i,"");0===e.indexOf("_")&&(e=e.replace("_",""));const o=e.replaceAll("_",n);return`${s}${n}${o}.${r}`}return t},this.setWindowsEnv=function(e=!0){t=e,n=e?"\\":"/"}}}function m(e){return`${e.moduleName}#${e.exportName}`}return class{constructor(){let t=new r,o=!1,n=new u,s=new l,i=new f;const c={},a={};let p=new d;function h(){o&&console.log(...arguments)}this.get=async function(e,t=[]){return this.compose(e,t)},this.compose=async function(o,r=[]){if(h(`Object '${o}' is requested.`),o===e.ID||o===e.ID_FQN)return h("Container itself is returned."),a[e.ID];const u=n.parse(o),l=s.modify(u,r);if(l.life===e.LIFE_S){const e=m(l);if(a[e])return h(`Existing singleton '${e}' is returned.`),a[e]}let f;c[l.moduleName]||(h(`ES6 module '${l.moduleName}' is not resolved yet`),c[l.moduleName]=p.resolve(l.moduleName));const d=c[l.moduleName];try{f=await import(d),h(`ES6 module '${l.moduleName}' is loaded from '${d}'.`)}catch(e){throw console.error(e?.message,`Object key: "${o}".`,`Path: "${d}".`,`Stack: ${JSON.stringify(r)}`),e}let $=await t.create(l,f,r,this);if($=await i.modify($,l,r),h(`Object '${o}' is created.`),l.life===e.LIFE_S){const e=m(l);a[e]=$,h(`Object '${o}' is saved as singleton.`)}return $},this.getParser=()=>n,this.getPreProcessor=()=>s,this.getPostProcessor=()=>i,this.getResolver=()=>p,this.setDebug=function(e){o=e,t.setDebug(e)},this.setParser=e=>n=e,this.setPreProcessor=e=>s=e,this.setPostProcessor=e=>i=e,this.setResolver=e=>p=e,a[e.ID]=this}}}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):(e="undefined"!=typeof globalThis?globalThis:e||self).TeqFw_Di_Container=t()}(this,(function(){"use strict";var e={CA:"A",CF:"F",ID:"container",ID_FQN:"TeqFw_Di_Container$",LI:"I",LS:"S",isClass(e){const t=Object.getOwnPropertyDescriptor(e,"prototype");return t&&!t.writable}};const t=/(function)*\s*\w*\s*\(\s*\{([^}]*)}/s,o=/constructor\s*\(\s*\{([^}]*)}/s;function n(e){const t=[];try{const o=new Function(`{${e}}`,"return");o(new Proxy({},{get:(e,o)=>t.push(o)}))}catch(t){throw new Error(`Cannot analyze the deps specification:${e}\n\nPlease, be sure that spec does not contain extra ')' in a comments.\n\nError: ${t}`)}return t}function s(s){return"function"==typeof s?e.isClass(s)?function(e){const t=[],s=e.toString(),r=o.exec(s);return r&&t.push(...n(r[1])),t}(s):function(e){const o=[],s=e.toString(),r=t.exec(s);return r&&o.push(...n(r[2])),o}(s):[]}class r{constructor(){let t=!1;this.create=async function(o,n,r,i){if(r.includes(o.origin))throw new Error(`Circular dependency for '${o.origin}'. Parents are: ${JSON.stringify(r)}`);if(o.exportName){const a=[...r,o.origin],{[o.exportName]:u}=n;if(o.composition===e.CF){if("function"==typeof u){const n=s(u);n.length&&(c=`Deps for object '${o.origin}' are: ${JSON.stringify(n)}`,t&&console.log(c));const r={};for(const e of n)r[e]=await i.compose(e,a);const l=e.isClass(u)?new u(r):u(r);return l instanceof Promise?await l:l}return Object.assign({},u)}return u}return n;var c},this.setDebug=function(e){t=e}}}class i{exportName;composition;life;moduleName;origin;wrappers=[]}const c=/^(node:)?(@?[A-Za-z0-9_-]+\/?[A-Za-z0-9_-]*)(([.#])?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?$/;class a{canParse(){return!0}parse(t){const o=new i;o.origin=t;const n=c.exec(t);if(n&&(o.isNodeModule=Boolean(n[1]),o.moduleName=n[2].replace(/^node:/,""),"."===n[4]||"#"===n[4]?"$"===n[6]||"$$"===n[6]?(o.composition=e.CF,o.exportName=n[5],o.life="$"===n[6]?e.LS:e.LI):(o.composition=e.CA,o.life=e.LS,o.exportName=""!==n[5]?n[5]:"default"):"$"===n[6]||"$$"===n[6]?(o.composition=e.CF,o.exportName="default",o.life="$"===n[6]?e.LS:e.LI):(o.composition=void 0,o.exportName=void 0,o.life=void 0),n[10]&&(o.wrappers=n[10].split(","))),o.composition===e.CA&&o.life===e.LI)throw new Error(`Export is not a function and should be used as a singleton only: '${o.origin}'.`);return o}}class u{constructor(){let e=new a;const t=[];this.addChunk=function(e){t.push(e)},this.parse=function(o){let n;for(const e of t)if(e.canParse(o)){n=e.parse(o);break}return n||(n=e?.parse(o)),n},this.setDefaultChunk=function(t){e=t}}}class l{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=function(t,o){let n=t;for(const s of e)n=s.modify(n,t,o);return n}}}class f{constructor(){const e=[];this.addChunk=function(t){e.push(t)},this.modify=async function(t,o,n){let s=t;for(const t of e)s=t.modify(s,o,n),s instanceof Promise&&(s=await s);return s}}}const d="root";class p{constructor(){const e={};let t=!1,o=[],n="/";this.addNamespaceRoot=function(n,s,r){const i=(t?s.replace(/^\\/,""):s).replace(/\\/g,"/"),c=t?`file://${i}`:i;e[n]={ext:r??"js",ns:n,[d]:c},o=Object.keys(e).sort(((e,t)=>t.localeCompare(e)))},this.resolve=function(t){let s,r,i;for(i of o)if(t.startsWith(i)){s=e[i][d],r=e[i].ext;break}if(s&&r){let e=t.replace(i,"");0===e.indexOf("_")&&(e=e.replace("_",""));const o=e.replaceAll("_",n);return`${s}${n}${o}.${r}`}return t},this.setWindowsEnv=function(e=!0){t=e,n=e?"\\":"/"}}}function m(e){return`${e.moduleName}#${e.exportName}`}return class{constructor(){let t=new r,o=!1,n=new u,s=new l,i=new f;const c={},a={};let d=new p;function h(){o&&console.log(...arguments)}this.get=async function(e,t=[]){return this.compose(e,t)},this.compose=async function(o,r=[]){if(h(`Object '${o}' is requested.`),o===e.ID||o===e.ID_FQN)return h("Container itself is returned."),a[e.ID];const u=n.parse(o),l=s.modify(u,r);if(l.life===e.LS){const e=m(l);if(a[e])return h(`Existing singleton '${e}' is returned.`),a[e]}let f;c[l.moduleName]||(h(`ES6 module '${l.moduleName}' is not resolved yet`),c[l.moduleName]=d.resolve(l.moduleName));const p=c[l.moduleName];try{f=await import(p),h(`ES6 module '${l.moduleName}' is loaded from '${p}'.`)}catch(e){throw console.error(e?.message,`Object key: "${o}".`,`Path: "${p}".`,`Stack: ${JSON.stringify(r)}`),e}let g=await t.create(l,f,r,this);var $;if(null===($=g)||"object"!=typeof $&&"function"!=typeof $||"[object Module]"===Object.prototype.toString.call($)||Object.isFrozen($)||Object.freeze(g),g=await i.modify(g,l,r),h(`Object '${o}' is created.`),l.life===e.LS){const e=m(l);a[e]=g,h(`Object '${o}' is saved as singleton.`)}return g},this.getParser=()=>n,this.getPreProcessor=()=>s,this.getPostProcessor=()=>i,this.getResolver=()=>d,this.register=function(t,o){if(!t||!o)throw new Error("depId and object are required");const s=n.parse(t);if(s.life!==e.LS)throw new Error(`Only singletons can be registered manually. Given: ${t}`);{const e=m(s);a[e]=o,h(`Object '${t}' is registered manually as singleton.`)}},this.setDebug=function(e){o=e,t.setDebug(e)},this.setParser=e=>n=e,this.setPreProcessor=e=>s=e,this.setPostProcessor=e=>i=e,this.setResolver=e=>d=e,a[e.ID]=this}}}));

package/eslint.config.js

@@ -0,0 +1,37 @@
+// eslint.config.js
+import js from '@eslint/js';
+
+/** @type {import('eslint').Linter.FlatConfig[]} */
+export default [
+    js.configs.recommended,
+    {
+        languageOptions: {
+            ecmaVersion: 2022, // required for public class fields
+            sourceType: 'module',
+            globals: {
+                console: 'readonly',
+            },
+        },
+        rules: {
+            'camelcase': [
+                'warn',
+                {
+                    properties: 'never',
+                    ignoreDestructuring: true,
+                    allow: ['^([A-Z][a-zA-Z0-9]*_)+[A-Z][a-zA-Z0-9]*$'],
+                },
+            ],
+            'indent': ['error', 4],
+            'linebreak-style': ['error', 'unix'],
+            'quotes': ['error', 'single'],
+            'semi': ['error', 'always'],
+        },
+    },
+    // Special rule override for interface declarations
+    {
+        files: ['./src/Api/**/*.js'],
+        rules: {
+            'no-unused-vars': 'off',
+        },
+    },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teqfw/di",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "description": "Dependency Injection container for ES6 modules that works in both browser and Node.js apps.",
   "keywords": [
     "dependency injection",
@@ -28,13 +28,16 @@
   },
   "scripts": {
     "rollup": "rollup -c",
+    "eslint": "eslint './src/**/*.js'",
     "test": "mocha --recursive './test/**/*.test.mjs'"
   },
   "devDependencies": {
-    "@rollup/plugin-node-resolve": "^15.2.3",
-    "mocha": "^10.7.0",
-    "rollup": "^2.79.1",
-    "rollup-plugin-terser": "^7.0.2"
+    "@eslint/js": "^9.25.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "eslint": "^9.25.0",
+    "mocha": "^11.1.0",
+    "rollup": "^4.36.0"
   },
   "mocha": {
     "spec": "./test/**/*.test.mjs",

package/rollup.config.js

@@ -1,5 +1,5 @@
 import resolve from '@rollup/plugin-node-resolve';
-import {terser} from 'rollup-plugin-terser';
+import terser from '@rollup/plugin-terser';
 
 export default {
     input: 'src/Container.js',

package/src/Api/Container.js

@@ -34,6 +34,13 @@ export default class TeqFw_Di_Api_Container {
      */
     getResolver() {};
 
+    /**
+     * Registers an object (module, singleton, factory, or prototype) by dependency ID.
+     * @param {string} depId
+     * @param {Object} obj
+     */
+    register(depId, obj) {};
+
     /**
      * Enable disable debug output for the object composition process.
      * @param {boolean} data

package/src/Container/A/Composer/A/SpecParser.js

@@ -8,8 +8,8 @@
 import Defs from '../../../../Defs.js';
 
 // VARS
-const FUNC = /(function)*\s*\w*\s*\(\s*\{([^\}]*)\}/s;
-const CLASS = /constructor\s*\(\s*\{([^\}]*)\}/s;
+const FUNC = /(function)*\s*\w*\s*\(\s*\{([^}]*)}/s;
+const CLASS = /constructor\s*\(\s*\{([^}]*)}/s;
 
 // FUNCS
 
@@ -32,7 +32,7 @@ function _analyze(params) {
         fn(spec);
     } catch (e) {
         const msg = `Cannot analyze the deps specification:${params}\n`
-            + `\nPlease, be sure that spec does not contain extra ')' in a comments.`
+            + '\nPlease, be sure that spec does not contain extra \')\' in a comments.'
             + `\n\nError: ${e}`;
         throw new Error(msg);
     }

package/src/Container/A/Composer.js

@@ -29,17 +29,17 @@ export default class TeqFw_Di_Container_A_Composer {
          * @returns {Promise<*>}
          */
         this.create = async function (depId, module, stack, container) {
-            if (stack.includes(depId.value))
-                throw new Error(`Circular dependency for '${depId.value}'. Parents are: ${JSON.stringify(stack)}`);
+            if (stack.includes(depId.origin))
+                throw new Error(`Circular dependency for '${depId.origin}'. Parents are: ${JSON.stringify(stack)}`);
             if (depId.exportName) {
                 // use export from the es6-module
-                const stackNew = [...stack, depId.value];
+                const stackNew = [...stack, depId.origin];
                 const {[depId.exportName]: exp} = module;
-                if (depId.composition === Defs.COMP_F) {
+                if (depId.composition === Defs.CF) {
                     if (typeof exp === 'function') {
                         // create deps for factory function
                         const deps = specParser(exp);
-                        if (deps.length) log(`Deps for object '${depId.value}' are: ${JSON.stringify(deps)}`);
+                        if (deps.length) log(`Deps for object '${depId.origin}' are: ${JSON.stringify(deps)}`);
                         const spec = {};
                         for (const dep of deps)
                             spec[dep] = await container.compose(dep, stackNew);

package/src/Container/A/Parser/Chunk/Def.js

@@ -1,6 +1,8 @@
 /**
  * Default parser for object keys in format:
  *   - Ns_Module.export$$(post)
+ *   - node:package.export$$(post)
+ *   - node:@scope/package.export$$(post)
  *
  * @namespace TeqFw_Di_Container_A_Parser_Chunk_Def
  */
@@ -8,58 +10,60 @@ import Dto from '../../../../DepId.js';
 import Defs from '../../../../Defs.js';
 
 // VARS
-/** @type {RegExp} expression for default object key (Ns_Module.export$$(post)) */
-const REGEXP = /^((([A-Z])[A-Za-z0-9_]*)((\.)?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?)$/;
+/** @type {RegExp} expression for a default object key */
+const REGEXP = /^(node:)?(@?[A-Za-z0-9_-]+\/?[A-Za-z0-9_-]*)(([.#])?([A-Za-z0-9_]*)((\$)?(\$)?)?)?(\(([A-Za-z0-9_,]*)\))?$/;
 
 /**
  * @implements TeqFw_Di_Api_Container_Parser_Chunk
  */
 export default class TeqFw_Di_Container_A_Parser_Chunk_Def {
 
-    canParse(depId) {
-        // default parser always trys to parse the depId
+    canParse() {
+        // the default parser always tries to parse the depId
         return true;
     }
 
     parse(objectKey) {
         const res = new Dto();
-        res.value = objectKey;
+        res.origin = objectKey;
         const parts = REGEXP.exec(objectKey);
         if (parts) {
-            res.moduleName = parts[2];
-            if (parts[5] === '.') {
-                // Ns_Module.export...
-                if ((parts[7] === '$') || (parts[7] === '$$')) {
-                    // Ns_Module.export$...
-                    res.composition = Defs.COMP_F;
-                    res.exportName = parts[6];
-                    res.life = (parts[7] === '$') ? Defs.LIFE_S : Defs.LIFE_I;
+            res.isNodeModule = Boolean(parts[1]); // Detect 'node:' prefix
+            res.moduleName = parts[2].replace(/^node:/, ''); // Remove 'node:' prefix
+
+            if ((parts[4] === '.') || (parts[4] === '#')) {
+                // Ns_Module.export or node:package.export
+                if ((parts[6] === '$') || (parts[6] === '$$')) {
+                    res.composition = Defs.CF;
+                    res.exportName = parts[5];
+                    res.life = (parts[6] === '$') ? Defs.LS : Defs.LI;
                 } else {
-                    res.composition = Defs.COMP_A;
-                    res.life = Defs.LIFE_S;
-                    // res.exportName = (parts[6]) ? parts[6] : 'default';
-                    res.exportName = (parts[6] !== '') ? parts[6] : 'default';
+                    res.composition = Defs.CA;
+                    res.life = Defs.LS;
+                    res.exportName = (parts[5] !== '') ? parts[5] : 'default';
                 }
-            } else if ((parts[7] === '$') || parts[7] === '$$') {
-                // Ns_Module$$
-                res.composition = Defs.COMP_F;
+            } else if ((parts[6] === '$') || parts[6] === '$$') {
+                // Ns_Module$$ or node:package$$
+                res.composition = Defs.CF;
                 res.exportName = 'default';
-                res.life = (parts[7] === '$') ? Defs.LIFE_S : Defs.LIFE_I;
+                res.life = (parts[6] === '$') ? Defs.LS : Defs.LI;
             } else {
-                // Ns_Module (es6 module)
+                // Ns_Module or node:package (ES6 module)
                 res.composition = undefined;
                 res.exportName = undefined;
                 res.life = undefined;
             }
-            // wrappers
-            if (parts[11]) {
-                res.wrappers = parts[11].split(',');
+
+            // Wrappers handling
+            if (parts[10]) {
+                res.wrappers = parts[10].split(',');
             }
         }
 
-        // we should always use singletons for as-is exports
-        if ((res.composition === Defs.COMP_A) && (res.life === Defs.LIFE_I))
-            throw new Error(`Export is not a function and should be used as a singleton only: '${res.value}'.`);
+        // Ensure singletons for non-factory exports
+        if ((res.composition === Defs.CA) && (res.life === Defs.LI))
+            throw new Error(`Export is not a function and should be used as a singleton only: '${res.origin}'.`);
+
         return res;
     }
-}
+}

package/src/Container/A/Parser/Chunk/V02X.js

@@ -1,6 +1,7 @@
 /**
  * Default parser for object keys in format:
  *   - Ns_Module[.|#]export$[F|A][S|I]
+ *   - node:package[.|#]export$[F|A][S|I]
  *
  * @namespace TeqFw_Di_Container_A_Parser_Chunk_V02X
  */
@@ -8,63 +9,58 @@ import Dto from '../../../../DepId.js';
 import Defs from '../../../../Defs.js';
 
 // VARS
-/** @type {RegExp} expression for default object key (Ns_Module[.|#]export$[F|A][S|I]) */
-const REGEXP = /^((([A-Z])[A-Za-z0-9_]*)((#|\.)?([A-Za-z0-9_]*)((\$)([F|A])?([S|I])?)?)?)$/;
+/** @type {RegExp} expression for a default object key */
+const REGEXP = /^(node:)?(([A-Z])[A-Za-z0-9_]*|[a-z][a-z0-9-]*)(([#.])?([A-Za-z0-9_]*)((\$)([F|A])?([S|I])?)?)?$/;
 
 /**
  * @implements TeqFw_Di_Api_Container_Parser_Chunk
  */
 export default class TeqFw_Di_Container_A_Parser_Chunk_V02X {
 
-    canParse(depId) {
-        // default parser always trys to parse the depId
+    canParse() {
+        // the default parser always tries to parse the depId
         return true;
     }
 
     parse(objectKey) {
         const res = new Dto();
-        res.value = objectKey;
+        res.origin = objectKey;
         const parts = REGEXP.exec(objectKey);
         if (parts) {
-            res.moduleName = parts[2];
+            res.isNodeModule = Boolean(parts[1]); // Check if it starts with 'node:'
+            res.moduleName = parts[2].replace(/^node:/, ''); // Remove 'node:' if present
+
             if (parts[5] === '.') {
-                // App_Service.export...
+                // App_Service.export or node:package.export
                 if (parts[8] === '$') {
-                    // App_Service.export$...
-                    res.composition = Defs.COMP_F;
+                    // App_Service.export$ or node:package.export$
+                    res.composition = Defs.CF;
                     res.exportName = parts[6];
-                    res.life = (parts[10] === Defs.LIFE_I)
-                        ? Defs.LIFE_I : Defs.LIFE_S;
+                    res.life = (parts[10] === Defs.LI) ? Defs.LI : Defs.LS;
                 } else {
-                    res.composition = ((parts[8] === undefined) || (parts[8] === Defs.COMP_A))
-                        ? Defs.COMP_A : Defs.COMP_F;
+                    res.composition = (!parts[8] || parts[8] === Defs.CA) ? Defs.CA : Defs.CF;
                     res.exportName = parts[6];
-                    res.life = ((parts[8] === undefined) || (parts[10] === Defs.LIFE_S))
-                        ? Defs.LIFE_S : Defs.LIFE_I;
+                    res.life = (!parts[8] || parts[10] === Defs.LS) ? Defs.LS : Defs.LI;
                 }
-
-
             } else if (parts[8] === '$') {
-                // App_Logger$FS
-                res.composition = ((parts[9] === undefined) || (parts[9] === Defs.COMP_F))
-                    ? Defs.COMP_F : Defs.COMP_A;
+                // App_Logger$FS or node:package$
+                res.composition = (!parts[9] || parts[9] === Defs.CF) ? Defs.CF : Defs.CA;
                 res.exportName = 'default';
-                if (parts[10]) {
-                    res.life = (parts[10] === Defs.LIFE_S) ? Defs.LIFE_S : Defs.LIFE_I;
-                } else {
-                    res.life = (res.composition === Defs.COMP_F) ? Defs.LIFE_S : Defs.LIFE_I;
-                }
+                res.life = parts[10] ? (parts[10] === Defs.LS ? Defs.LS : Defs.LI) : (res.composition === Defs.CF ? Defs.LS : Defs.LI);
             } else {
-                // App_Service (es6 module)
+                // App_Service or node:package (ES6 module)
                 res.composition = undefined;
                 res.exportName = undefined;
                 res.life = undefined;
             }
+
+        }
+
+        // Enforce singleton for non-factory exports
+        if (res.composition === Defs.CA && res.life === Defs.LI) {
+            throw new Error(`Export is not a function and should be used as a singleton only: '${res.origin}'.`);
         }
 
-        // we should always use singletons for as-is exports
-        if ((res.composition === Defs.COMP_A) && (res.life === Defs.LIFE_I))
-            throw new Error(`Export is not a function and should be used as a singleton only: '${res.value}'.`);
         return res;
     }
-}
+}

package/src/Container.js

@@ -19,6 +19,21 @@ function getSingletonId(key) {
     return `${key.moduleName}#${key.exportName}`;
 }
 
+/**
+ * Determines if an object, function, or primitive can be safely frozen.
+ * @param {*} value - The value to check.
+ * @returns {boolean} - Returns true if the value can be safely frozen.
+ */
+function canBeFrozen(value) {
+    // Primitives (except objects and functions) cannot be frozen
+    if (value === null || typeof value !== 'object' && typeof value !== 'function') return false;
+    // // ES modules cannot be frozen
+    if (Object.prototype.toString.call(value) === '[object Module]') return false;
+    // check is Object is already frozen
+    return !Object.isFrozen(value);
+}
+
+
 // MAIN
 /**
  * @implements TeqFw_Di_Api_Container
@@ -72,7 +87,7 @@ export default class TeqFw_Di_Container {
                 (depId === Defs.ID) ||
                 (depId === Defs.ID_FQN)
             ) {
-                log(`Container itself is returned.`);
+                log('Container itself is returned.');
                 return _regSingles[Defs.ID];
             }
             // parse the `objectKey` and get the structured DTO
@@ -80,7 +95,7 @@ export default class TeqFw_Di_Container {
             // modify original key according to some rules (replacements, etc.)
             const key = _preProcessor.modify(parsed, stack);
             // return existing singleton
-            if (key.life === Defs.LIFE_S) {
+            if (key.life === Defs.LS) {
                 const singleId = getSingletonId(key);
                 if (_regSingles[singleId]) {
                     log(`Existing singleton '${singleId}' is returned.`);
@@ -111,11 +126,13 @@ export default class TeqFw_Di_Container {
             }
             // create object using the composer then modify it in post-processor
             let res = await _composer.create(key, module, stack, this);
+            // freeze the result to prevent modifications (TODO: should we have configuration for the feature?)
+            if (canBeFrozen(res)) Object.freeze(res);
             res = await _postProcessor.modify(res, key, stack);
             log(`Object '${depId}' is created.`);
 
             // save singletons
-            if (key.life === Defs.LIFE_S) {
+            if (key.life === Defs.LS) {
                 const singleId = getSingletonId(key);
                 _regSingles[singleId] = res;
                 log(`Object '${depId}' is saved as singleton.`);
@@ -128,8 +145,27 @@ export default class TeqFw_Di_Container {
         this.getPreProcessor = () => _preProcessor;
 
         this.getPostProcessor = () => _postProcessor;
+
         this.getResolver = () => _resolver;
 
+        /**
+         * Register new object in the Container.
+         * @param {string} depId
+         * @param {Object} obj
+         */
+        this.register = function (depId, obj) {
+            if (!depId || !obj) throw new Error('depId and object are required');
+            const key = _parser.parse(depId);
+            if (key.life === Defs.LS) {
+                const singleId = getSingletonId(key);
+                _regSingles[singleId] = obj;
+                log(`Object '${depId}' is registered manually as singleton.`);
+            } else {
+                // TODO: factory function also should be added manually
+                throw new Error(`Only singletons can be registered manually. Given: ${depId}`);
+            }
+        };
+
         this.setDebug = function (data) {
             _debug = data;
             _composer.setDebug(data);

package/src/Defs.js

@@ -3,12 +3,13 @@
  * @namespace TeqFw_Di_Defs
  */
 export default {
-    COMP_A: 'A', // composition: as-is
-    COMP_F: 'F', // composition: factory
+    CA: 'A', // composition: as-is
+    CF: 'F', // composition: factory
+    // TODO: we don't need an access to the container itself.
     ID: 'container', // default ID for container itself
     ID_FQN: 'TeqFw_Di_Container$', // default Full Qualified Name for container itself
-    LIFE_I: 'I', // lifestyle: instance
-    LIFE_S: 'S', // lifestyle: singleton
+    LI: 'I', // lifestyle: instance
+    LS: 'S', // lifestyle: singleton
 
     /**
      * Return 'true' if function is a class definition.

package/src/DepId.js

@@ -1,33 +1,44 @@
 /**
- * This is a DTO that represents the structure of an ID for a runtime dependency.
+ *  DTO representing a dependency identifier in the container.
  * @namespace TeqFw_Di_DepId
  */
 export default class TeqFw_Di_DepId {
     /**
-     * The name of an export of the module.
+     * The name of an export from the module.
+     * Example: 'default', 'logger', 'DbClient'.
      * @type {string}
      */
     exportName;
     /**
-     * Composition type (see Defs.COMPOSE_): use the export as Factory (F) or return as-is (A).
+     * Defines how the export should be used:
+     * - 'F' (Factory): The export is a factory function, call it to get an instance.
+     * - 'A' (As-Is): The export is returned as-is, without calling.
+     * Example: 'F', 'A'.
      * @type {string}
      */
     composition;
     /**
-     * Lifestyle type (see Defs.LIFE_): singleton (S) or instance (I).
+     * Defines the lifecycle of the resolved dependency:
+     * - 'S' (Singleton): A single instance is created and reused.
+     * - 'I' (Instance): A new instance is created on each request.
+     * Example: 'S', 'I'.
      * @type {string}
      */
     life;
     /**
-     * The code for ES6 module that can be converted to the path to this es6 module.
+     * ES6 module identifier, which can be transformed into a file path.
+     * This value is processed by the Resolver to determine the module's location.
+     * Example: 'TeqFw_Core_Shared_Api_Logger'.
      * @type {string}
      */
     moduleName;
     /**
-     * Object key value.
+     * The original identifier string provided to the container.
+     * This is the unprocessed dependency key.
+     * Example: 'TeqFw_Core_Shared_Api_Logger$$'.
      * @type {string}
      */
-    value;
+    origin;
     /**
      * List of wrappers to decorate the result.
      * @type {string[]}