@cyberskill/shared 1.216.0 → 2.0.0

package/dist/node/package/package.type.d.ts

@@ -1,4 +1,4 @@
-export interface T_PackageJson {
+export interface I_PackageJson {
     name?: string;
     version?: string;
     dependencies?: Record<string, string>;
@@ -15,7 +15,7 @@ export interface I_PackageInfo {
     isDependency: boolean;
     isDevDependency: boolean;
     installedPath: string;
-    file: T_PackageJson;
+    file: I_PackageJson;
 }
 export declare enum E_PackageType {
     DEPENDENCY = "dependencies",

package/dist/node/package/package.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("node-fetch"),f=require("./package.type.cjs"),u=require("../fs/fs.util.cjs"),a=require("../path/path.constant.cjs"),J=require("../path/path.util.cjs"),d=require("../log/log.util.cjs"),C=require("../command/command.util.cjs"),j=require("../../config/env/env.util.cjs");var p=(e,t,r)=>new Promise((n,i)=>{var c=s=>{try{l(r.next(s))}catch(o){i(o)}},m=s=>{try{l(r.throw(s))}catch(o){i(o)}},l=s=>s.done?n(s.value):Promise.resolve(s.value).then(c,m);l((r=r.apply(e,t)).next())});const O=j.getEnv();function T(e){return p(this,null,function*(){try{const t=yield N(`https://registry.npmjs.org/${e}/latest`);if(!t.ok)throw new Error(`Failed to fetch latest version: ${t.status} ${t.statusText}`);const{version:r}=yield t.json();return{success:!0,result:r}}catch(t){return d.catchError(t)}})}function V(e){return p(this,null,function*(){var t,r;try{if(!e){if(u.pathExistsSync(a.PATH.PACKAGE_JSON)){const _=u.readJsonSync(a.PATH.PACKAGE_JSON),{name:S="",version:A=""}=_;return{success:!0,result:{name:S,currentVersion:A,latestVersion:A,isCurrentProject:!0,isInstalled:!0,isUpToDate:!0,isDependency:!1,isDevDependency:!1,installedPath:a.PATH.PACKAGE_JSON,file:_}}}return{success:!0,result:{name:"",currentVersion:"",latestVersion:"",isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:!1,isDevDependency:!1,installedPath:"",file:{}}}}if(!u.pathExistsSync(a.PATH.PACKAGE_JSON))return{success:!0,result:{name:e.name,currentVersion:"",latestVersion:"",isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:e.type===f.E_PackageType.DEPENDENCY,isDevDependency:e.type===f.E_PackageType.DEV_DEPENDENCY,installedPath:"",file:{}}};const n=u.readJsonSync(a.PATH.PACKAGE_JSON),{name:i,version:c="",dependencies:m={},devDependencies:l={}}=n;if(e.name===i)return{success:!0,result:{name:i,currentVersion:c,latestVersion:c,isCurrentProject:!0,isInstalled:!0,isUpToDate:!0,isDependency:e.type===f.E_PackageType.DEPENDENCY,isDevDependency:e.type===f.E_PackageType.DEV_DEPENDENCY,installedPath:a.PATH.PACKAGE_JSON,file:n}};const s=e.name in m,o=e.name in l,y=yield T(e.name);if(!y.success)return{success:!0,result:{name:e.name,currentVersion:"",latestVersion:"",isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:s,isDevDependency:o,installedPath:"",file:{}}};if(!s&&!o)return{success:!0,result:{name:e.name,currentVersion:"",latestVersion:y.result,isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:e.type===f.E_PackageType.DEPENDENCY,isDevDependency:e.type===f.E_PackageType.DEV_DEPENDENCY,installedPath:"",file:{}}};const D=(r=(t=m[e.name])!=null?t:l[e.name])!=null?r:"",E=J.join(O.CWD,a.NODE_MODULES,e.name,a.PACKAGE_JSON);if(!u.pathExistsSync(E))return{success:!0,result:{name:e.name,currentVersion:"",latestVersion:y.result,isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:s,isDevDependency:o,installedPath:"",file:{}}};const h=u.readJsonSync(E),{version:v=""}=h;return D!==v?{success:!0,result:{name:e.name,currentVersion:v||D,latestVersion:y.result,isCurrentProject:!1,isInstalled:!0,isUpToDate:!1,isDependency:s,isDevDependency:o,installedPath:E,file:h}}:{success:!0,result:{name:e.name,currentVersion:D,latestVersion:y.result,isCurrentProject:!1,isInstalled:!0,isUpToDate:D===y.result,isDependency:s,isDevDependency:o,installedPath:E,file:h}}}catch(n){return d.catchError(n)}})}function P(e){return p(this,null,function*(){var t,r;try{const n=u.readJsonSync(a.PATH.PACKAGE_JSON),i=(t=n.dependencies)!=null?t:{},c=(r=n.devDependencies)!=null?r:{};e.isDependency?i[e.name]=e.latestVersion:e.isDevDependency&&(c[e.name]=e.latestVersion),u.writeFileSync(a.PATH.PACKAGE_JSON,JSON.stringify(n,null,4)),d.log.info(`Updated "${e.name}" to version ${e.latestVersion}`)}catch(n){d.catchError(n)}})}function g(){return p(this,null,function*(){try{const e=[{command:()=>a.command.pnpmInstallStandard(),message:"Installing dependencies (standard)"},{command:()=>a.command.pnpmInstallLegacy(),message:"Retrying with legacy peer dependencies"},{command:()=>a.command.pnpmInstallForce(),message:"Retrying with force install"}];for(const{command:t,message:r}of e)try{const n=yield t();yield C.runCommand(`${r} using: ${n}`,n);return}catch(n){d.catchError(n)}}catch(e){d.catchError(e)}})}function U(e,t){return p(this,null,function*(){var r;try{if(!u.pathExistsSync(a.PATH.PACKAGE_JSON)){d.log.error("package.json not found. Aborting setup.");return}const i=(yield Promise.all(e.map(V))).filter(s=>s.success&&!!s.result&&!s.result.isCurrentProject).map(s=>s.result),c=i.filter(s=>!s.isInstalled),m=i.filter(s=>!s.isUpToDate),l=[];t!=null&&t.install&&c.length>0&&l.push(...c.map(P)),t!=null&&t.update&&m.length>0&&l.push(...m.map(P)),l.length>0&&(yield Promise.all(l),yield g(),yield C.runCommand("Running ESLint with auto-fix",yield a.command.eslintFix()));for(const s of(r=t==null?void 0:t.callbacks)!=null?r:[])yield s()}catch(n){d.catchError(n)}})}exports.getLatestPackageVersion=T;exports.getPackage=V;exports.installDependencies=g;exports.setupPackages=U;exports.updatePackage=P;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("node-fetch"),m=require("./package.type.cjs"),d=require("../fs/fs.util.cjs"),l=require("../path/path.constant.cjs"),J=require("../path/path.util.cjs"),c=require("../log/log.util.cjs"),h=require("../command/command.util.cjs"),j=require("../../config/env/env.util.cjs");var p=(e,t,n)=>new Promise((r,i)=>{var o=s=>{try{a(n.next(s))}catch(u){i(u)}},y=s=>{try{a(n.throw(s))}catch(u){i(u)}},a=s=>s.done?r(s.value):Promise.resolve(s.value).then(o,y);a((n=n.apply(e,t)).next())});const O=j.getEnv();function T(e){return p(this,null,function*(){try{const t=yield g(`https://registry.npmjs.org/${e}/latest`);if(!t.ok)throw new Error(`Failed to fetch latest version: ${t.status} ${t.statusText}`);const{version:n}=yield t.json();return{success:!0,result:n}}catch(t){return c.catchError(t)}})}function V(e){return p(this,null,function*(){var t,n;try{if(!e){if(d.pathExistsSync(l.PATH.PACKAGE_JSON)){const C=d.readJsonSync(l.PATH.PACKAGE_JSON),{name:N="",version:A=""}=C;return{success:!0,result:{name:N,currentVersion:A,latestVersion:A,isCurrentProject:!0,isInstalled:!0,isUpToDate:!0,isDependency:!1,isDevDependency:!1,installedPath:l.PATH.PACKAGE_JSON,file:C}}}return{success:!0,result:{name:"",currentVersion:"",latestVersion:"",isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:!1,isDevDependency:!1,installedPath:"",file:{}}}}if(!d.pathExistsSync(l.PATH.PACKAGE_JSON))return{success:!0,result:{name:e.name,currentVersion:"",latestVersion:"",isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:e.type===m.E_PackageType.DEPENDENCY,isDevDependency:e.type===m.E_PackageType.DEV_DEPENDENCY,installedPath:"",file:{}}};const r=d.readJsonSync(l.PATH.PACKAGE_JSON),{name:i,version:o="",dependencies:y={},devDependencies:a={}}=r;if(e.name===i)return{success:!0,result:{name:i,currentVersion:o,latestVersion:o,isCurrentProject:!0,isInstalled:!0,isUpToDate:!0,isDependency:e.type===m.E_PackageType.DEPENDENCY,isDevDependency:e.type===m.E_PackageType.DEV_DEPENDENCY,installedPath:l.PATH.PACKAGE_JSON,file:r}};const s=e.name in y,u=e.name in a,f=yield T(e.name);if(!f.success)return{success:!0,result:{name:e.name,currentVersion:"",latestVersion:"",isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:s,isDevDependency:u,installedPath:"",file:{}}};if(!s&&!u)return{success:!0,result:{name:e.name,currentVersion:"",latestVersion:f.result,isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:e.type===m.E_PackageType.DEPENDENCY,isDevDependency:e.type===m.E_PackageType.DEV_DEPENDENCY,installedPath:"",file:{}}};const D=(n=(t=y[e.name])!=null?t:a[e.name])!=null?n:"",E=J.join(O.CWD,l.NODE_MODULES,e.name,l.PACKAGE_JSON);if(!d.pathExistsSync(E))return{success:!0,result:{name:e.name,currentVersion:"",latestVersion:f.result,isCurrentProject:!1,isInstalled:!1,isUpToDate:!1,isDependency:s,isDevDependency:u,installedPath:"",file:{}}};const P=d.readJsonSync(E),{version:_=""}=P;return D!==_?{success:!0,result:{name:e.name,currentVersion:_||D,latestVersion:f.result,isCurrentProject:!1,isInstalled:!0,isUpToDate:!1,isDependency:s,isDevDependency:u,installedPath:E,file:P}}:{success:!0,result:{name:e.name,currentVersion:D,latestVersion:f.result,isCurrentProject:!1,isInstalled:!0,isUpToDate:D===f.result,isDependency:s,isDevDependency:u,installedPath:E,file:P}}}catch(r){return c.catchError(r)}})}function v(e){return p(this,null,function*(){var t,n;try{const r=d.readJsonSync(l.PATH.PACKAGE_JSON),i=(t=r.dependencies)!=null?t:{},o=(n=r.devDependencies)!=null?n:{};e.isDependency?i[e.name]=e.latestVersion:e.isDevDependency&&(o[e.name]=e.latestVersion),d.writeFileSync(l.PATH.PACKAGE_JSON,JSON.stringify(r,null,4)),c.log.info(`Updated "${e.name}" to version ${e.latestVersion}`)}catch(r){c.catchError(r)}})}function S(){return p(this,null,function*(){try{try{const e=yield l.command.pnpmInstallStandard();yield h.runCommand(`Installing dependencies (standard) using: ${e}`,e);return}catch(e){c.catchError(e)}try{const e=yield l.command.pnpmInstallLegacy();yield h.runCommand(`Retrying with legacy peer dependencies using: ${e}`,e);return}catch(e){c.catchError(e)}try{const e=yield l.command.pnpmInstallForce();yield h.runCommand(`Retrying with force install using: ${e}`,e)}catch(e){c.catchError(e)}}catch(e){c.catchError(e)}})}function U(e,t){return p(this,null,function*(){var n;try{if(!d.pathExistsSync(l.PATH.PACKAGE_JSON)){c.log.error("package.json not found. Aborting setup.");return}const i=(yield Promise.all(e.map(V))).filter(s=>s.success&&!!s.result&&!s.result.isCurrentProject).map(s=>s.result),o=i.filter(s=>!s.isInstalled),y=i.filter(s=>!s.isUpToDate),a=[];t!=null&&t.install&&o.length>0&&a.push(...o.map(v)),t!=null&&t.update&&y.length>0&&a.push(...y.map(v)),a.length>0&&(yield Promise.all(a),yield S(),yield h.runCommand("Running ESLint with auto-fix",yield l.command.eslintFix())),yield(n=t==null?void 0:t.callback)==null?void 0:n.call(t)}catch(r){c.catchError(r)}})}exports.getLatestPackageVersion=T;exports.getPackage=V;exports.installDependencies=S;exports.setupPackages=U;exports.updatePackage=v;

package/dist/node/package/package.util.d.ts

@@ -1,11 +1,62 @@
 import { I_Return } from '../../typescript/index.js';
 import { I_PackageInfo, I_PackageInput } from './package.type.js';
+/**
+ * Fetches the latest version of a package from the npm registry.
+ * This function makes an HTTP request to the npm registry to get the latest version
+ * information for a specified package.
+ *
+ * @param packageName - The name of the package to fetch the latest version for.
+ * @returns A promise that resolves to a standardized response with the latest version string.
+ */
 export declare function getLatestPackageVersion(packageName: string): Promise<I_Return<string>>;
+/**
+ * Retrieves comprehensive information about a package.
+ * This function analyzes package information including:
+ * - Current and latest versions
+ * - Installation status and location
+ * - Dependency type (regular, dev, peer, etc.)
+ * - Whether it's the current project or an external dependency
+ *
+ * @param inputPackage - Optional package input configuration. If not provided, returns current project info.
+ * @returns A promise that resolves to a standardized response with detailed package information.
+ */
 export declare function getPackage(inputPackage?: I_PackageInput): Promise<I_Return<I_PackageInfo>>;
+/**
+ * Updates a package to its latest version in package.json.
+ * This function modifies the package.json file to update the specified package
+ * to its latest version and logs the update action.
+ *
+ * @param packageInfo - The package information containing the latest version to update to.
+ * @returns A promise that resolves when the update is complete.
+ */
 export declare function updatePackage(packageInfo: I_PackageInfo): Promise<void>;
+/**
+ * Installs project dependencies using pnpm with fallback strategies.
+ * This function attempts to install dependencies using different pnpm strategies:
+ * 1. Standard installation
+ * 2. Legacy peer dependencies mode
+ * 3. Force installation mode
+ *
+ * @returns A promise that resolves when the installation is complete.
+ */
 export declare function installDependencies(): Promise<void>;
+/**
+ * Sets up multiple packages with optional installation and update operations.
+ * This function provides a comprehensive package management workflow that can:
+ * - Install missing packages
+ * - Update outdated packages
+ * - Execute custom callbacks after package operations
+ * - Run ESLint fixes after package changes
+ *
+ * @param packages - An array of package inputs to set up.
+ * @param options - Optional configuration for installation, updates, and callbacks.
+ * @param options.install - Whether to install missing packages (default: false).
+ * @param options.update - Whether to update outdated packages (default: false).
+ * @param options.callback - Optional callback function to execute after package operations.
+ * @returns A promise that resolves when all package operations are complete.
+ */
 export declare function setupPackages(packages: I_PackageInput[], options?: {
     install?: boolean;
     update?: boolean;
-    callbacks?: (() => Promise<void>)[];
+    callback?: () => Promise<void>;
 }): Promise<void>;

package/dist/node/package/package.util.js

@@ -1,64 +1,64 @@
 import T from "node-fetch";
 import { E_PackageType as m } from "./package.type.js";
 import { pathExistsSync as h, readJsonSync as E, writeFileSync as j } from "../fs/fs.util.js";
-import { PATH as c, command as v, PACKAGE_JSON as O, NODE_MODULES as U } from "../path/path.constant.js";
+import { PATH as o, command as v, PACKAGE_JSON as O, NODE_MODULES as U } from "../path/path.constant.js";
 import { join as G } from "../path/path.util.js";
-import { catchError as f, log as _ } from "../log/log.util.js";
-import { runCommand as J } from "../command/command.util.js";
+import { catchError as u, log as J } from "../log/log.util.js";
+import { runCommand as P } from "../command/command.util.js";
 import { getEnv as K } from "../../config/env/env.util.js";
-var D = (e, t, r) => new Promise((n, i) => {
+var y = (e, t, n) => new Promise((r, i) => {
   var a = (s) => {
     try {
-      l(r.next(s));
-    } catch (o) {
-      i(o);
+      l(n.next(s));
+    } catch (c) {
+      i(c);
     }
-  }, u = (s) => {
+  }, d = (s) => {
     try {
-      l(r.throw(s));
-    } catch (o) {
-      i(o);
+      l(n.throw(s));
+    } catch (c) {
+      i(c);
     }
-  }, l = (s) => s.done ? n(s.value) : Promise.resolve(s.value).then(a, u);
-  l((r = r.apply(e, t)).next());
+  }, l = (s) => s.done ? r(s.value) : Promise.resolve(s.value).then(a, d);
+  l((n = n.apply(e, t)).next());
 });
-const g = K();
-function w(e) {
-  return D(this, null, function* () {
+const w = K();
+function I(e) {
+  return y(this, null, function* () {
     try {
       const t = yield T(`https://registry.npmjs.org/${e}/latest`);
       if (!t.ok)
         throw new Error(`Failed to fetch latest version: ${t.status} ${t.statusText}`);
-      const { version: r } = yield t.json();
+      const { version: n } = yield t.json();
       return {
         success: !0,
-        result: r
+        result: n
       };
     } catch (t) {
-      return f(t);
+      return u(t);
     }
   });
 }
-function I(e) {
-  return D(this, null, function* () {
-    var t, r;
+function $(e) {
+  return y(this, null, function* () {
+    var t, n;
     try {
       if (!e) {
-        if (h(c.PACKAGE_JSON)) {
-          const V = E(c.PACKAGE_JSON), { name: S = "", version: N = "" } = V;
+        if (h(o.PACKAGE_JSON)) {
+          const N = E(o.PACKAGE_JSON), { name: S = "", version: A = "" } = N;
           return {
             success: !0,
             result: {
               name: S,
-              currentVersion: N,
-              latestVersion: N,
+              currentVersion: A,
+              latestVersion: A,
               isCurrentProject: !0,
               isInstalled: !0,
               isUpToDate: !0,
               isDependency: !1,
               isDevDependency: !1,
-              installedPath: c.PACKAGE_JSON,
-              file: V
+              installedPath: o.PACKAGE_JSON,
+              file: N
             }
           };
         }
@@ -78,7 +78,7 @@ function I(e) {
           }
         };
       }
-      if (!h(c.PACKAGE_JSON))
+      if (!h(o.PACKAGE_JSON))
         return {
           success: !0,
           result: {
@@ -94,7 +94,7 @@ function I(e) {
             file: {}
           }
         };
-      const n = E(c.PACKAGE_JSON), { name: i, version: a = "", dependencies: u = {}, devDependencies: l = {} } = n;
+      const r = E(o.PACKAGE_JSON), { name: i, version: a = "", dependencies: d = {}, devDependencies: l = {} } = r;
       if (e.name === i)
         return {
           success: !0,
@@ -107,12 +107,12 @@ function I(e) {
             isUpToDate: !0,
             isDependency: e.type === m.DEPENDENCY,
             isDevDependency: e.type === m.DEV_DEPENDENCY,
-            installedPath: c.PACKAGE_JSON,
-            file: n
+            installedPath: o.PACKAGE_JSON,
+            file: r
           }
         };
-      const s = e.name in u, o = e.name in l, d = yield w(e.name);
-      if (!d.success)
+      const s = e.name in d, c = e.name in l, f = yield I(e.name);
+      if (!f.success)
         return {
           success: !0,
           result: {
@@ -123,18 +123,18 @@ function I(e) {
             isInstalled: !1,
             isUpToDate: !1,
             isDependency: s,
-            isDevDependency: o,
+            isDevDependency: c,
             installedPath: "",
             file: {}
           }
         };
-      if (!s && !o)
+      if (!s && !c)
         return {
           success: !0,
           result: {
             name: e.name,
             currentVersion: "",
-            latestVersion: d.result,
+            latestVersion: f.result,
             isCurrentProject: !1,
             isInstalled: !1,
             isUpToDate: !1,
@@ -144,111 +144,116 @@ function I(e) {
             file: {}
           }
         };
-      const y = (r = (t = u[e.name]) != null ? t : l[e.name]) != null ? r : "", p = G(g.CWD, U, e.name, O);
+      const D = (n = (t = d[e.name]) != null ? t : l[e.name]) != null ? n : "", p = G(w.CWD, U, e.name, O);
       if (!h(p))
         return {
           success: !0,
           result: {
             name: e.name,
             currentVersion: "",
-            latestVersion: d.result,
+            latestVersion: f.result,
             isCurrentProject: !1,
             isInstalled: !1,
             isUpToDate: !1,
             isDependency: s,
-            isDevDependency: o,
+            isDevDependency: c,
             installedPath: "",
             file: {}
           }
         };
-      const P = E(p), { version: C = "" } = P;
-      return y !== C ? {
+      const C = E(p), { version: V = "" } = C;
+      return D !== V ? {
         success: !0,
         result: {
           name: e.name,
-          currentVersion: C || y,
-          latestVersion: d.result,
+          currentVersion: V || D,
+          latestVersion: f.result,
           isCurrentProject: !1,
           isInstalled: !0,
           isUpToDate: !1,
           isDependency: s,
-          isDevDependency: o,
+          isDevDependency: c,
           installedPath: p,
-          file: P
+          file: C
         }
       } : {
         success: !0,
         result: {
           name: e.name,
-          currentVersion: y,
-          latestVersion: d.result,
+          currentVersion: D,
+          latestVersion: f.result,
           isCurrentProject: !1,
           isInstalled: !0,
-          isUpToDate: y === d.result,
+          isUpToDate: D === f.result,
           isDependency: s,
-          isDevDependency: o,
+          isDevDependency: c,
           installedPath: p,
-          file: P
+          file: C
         }
       };
-    } catch (n) {
-      return f(n);
+    } catch (r) {
+      return u(r);
     }
   });
 }
-function A(e) {
-  return D(this, null, function* () {
-    var t, r;
+function _(e) {
+  return y(this, null, function* () {
+    var t, n;
     try {
-      const n = E(c.PACKAGE_JSON), i = (t = n.dependencies) != null ? t : {}, a = (r = n.devDependencies) != null ? r : {};
-      e.isDependency ? i[e.name] = e.latestVersion : e.isDevDependency && (a[e.name] = e.latestVersion), j(c.PACKAGE_JSON, JSON.stringify(n, null, 4)), _.info(`Updated "${e.name}" to version ${e.latestVersion}`);
-    } catch (n) {
-      f(n);
+      const r = E(o.PACKAGE_JSON), i = (t = r.dependencies) != null ? t : {}, a = (n = r.devDependencies) != null ? n : {};
+      e.isDependency ? i[e.name] = e.latestVersion : e.isDevDependency && (a[e.name] = e.latestVersion), j(o.PACKAGE_JSON, JSON.stringify(r, null, 4)), J.info(`Updated "${e.name}" to version ${e.latestVersion}`);
+    } catch (r) {
+      u(r);
     }
   });
 }
-function $() {
-  return D(this, null, function* () {
+function g() {
+  return y(this, null, function* () {
     try {
-      const e = [
-        { command: () => v.pnpmInstallStandard(), message: "Installing dependencies (standard)" },
-        { command: () => v.pnpmInstallLegacy(), message: "Retrying with legacy peer dependencies" },
-        { command: () => v.pnpmInstallForce(), message: "Retrying with force install" }
-      ];
-      for (const { command: t, message: r } of e)
-        try {
-          const n = yield t();
-          yield J(`${r} using: ${n}`, n);
-          return;
-        } catch (n) {
-          f(n);
-        }
+      try {
+        const e = yield v.pnpmInstallStandard();
+        yield P(`Installing dependencies (standard) using: ${e}`, e);
+        return;
+      } catch (e) {
+        u(e);
+      }
+      try {
+        const e = yield v.pnpmInstallLegacy();
+        yield P(`Retrying with legacy peer dependencies using: ${e}`, e);
+        return;
+      } catch (e) {
+        u(e);
+      }
+      try {
+        const e = yield v.pnpmInstallForce();
+        yield P(`Retrying with force install using: ${e}`, e);
+      } catch (e) {
+        u(e);
+      }
     } catch (e) {
-      f(e);
+      u(e);
     }
   });
 }
-function W(e, t) {
-  return D(this, null, function* () {
-    var r;
+function M(e, t) {
+  return y(this, null, function* () {
+    var n;
     try {
-      if (!h(c.PACKAGE_JSON)) {
-        _.error("package.json not found. Aborting setup.");
+      if (!h(o.PACKAGE_JSON)) {
+        J.error("package.json not found. Aborting setup.");
         return;
       }
-      const i = (yield Promise.all(e.map(I))).filter((s) => s.success && !!s.result && !s.result.isCurrentProject).map((s) => s.result), a = i.filter((s) => !s.isInstalled), u = i.filter((s) => !s.isUpToDate), l = [];
-      t != null && t.install && a.length > 0 && l.push(...a.map(A)), t != null && t.update && u.length > 0 && l.push(...u.map(A)), l.length > 0 && (yield Promise.all(l), yield $(), yield J("Running ESLint with auto-fix", yield v.eslintFix()));
-      for (const s of (r = t == null ? void 0 : t.callbacks) != null ? r : [])
-        yield s();
-    } catch (n) {
-      f(n);
+      const i = (yield Promise.all(e.map($))).filter((s) => s.success && !!s.result && !s.result.isCurrentProject).map((s) => s.result), a = i.filter((s) => !s.isInstalled), d = i.filter((s) => !s.isUpToDate), l = [];
+      t != null && t.install && a.length > 0 && l.push(...a.map(_)), t != null && t.update && d.length > 0 && l.push(...d.map(_)), l.length > 0 && (yield Promise.all(l), yield g(), yield P("Running ESLint with auto-fix", yield v.eslintFix())), yield (n = t == null ? void 0 : t.callback) == null ? void 0 : n.call(t);
+    } catch (r) {
+      u(r);
     }
   });
 }
 export {
-  w as getLatestPackageVersion,
-  I as getPackage,
-  $ as installDependencies,
-  W as setupPackages,
-  A as updatePackage
+  I as getLatestPackageVersion,
+  $ as getPackage,
+  g as installDependencies,
+  M as setupPackages,
+  _ as updatePackage
 };

package/dist/node/path/path.constant.d.ts

@@ -58,6 +58,15 @@ export declare const PATH: {
     VITEST_UNIT_CONFIG: string;
     VITEST_E2E_CONFIG: string;
 };
+/**
+ * Creates Git hooks configuration based on whether this is the current project.
+ * This function generates a configuration object for Git hooks that includes
+ * pre-commit and commit-msg hooks, with an optional pre-push hook for the current project.
+ *
+ * @param context - Context object containing project information.
+ * @param context.isCurrentProject - Whether this is the current project being worked on.
+ * @returns A Git hooks configuration object with appropriate commands for each hook.
+ */
 export declare function createGitHooksConfig({ isCurrentProject }: Partial<I_CommandContext>): {
     'pre-push'?: {
         raw: boolean;

package/dist/node/path/path.util.d.ts

@@ -1,6 +1,30 @@
 import { default as pathNode } from 'node:path';
 export declare const path: pathNode.PlatformPath;
 export declare const dirname: (path: string) => string;
+/**
+ * Resolves a path relative to the current working directory.
+ * This function creates an absolute path by combining the current working directory
+ * with the provided path segments, ensuring consistent path resolution across the application.
+ *
+ * @param urls - Path segments to resolve relative to the current working directory.
+ * @returns An absolute path string resolved from the current working directory.
+ */
 export declare function resolveWorkingPath(...urls: string[]): string;
+/**
+ * Resolves an absolute path from the provided path segments.
+ * This function creates an absolute path by combining the provided path segments,
+ * similar to Node.js path.resolve but without using the current working directory as base.
+ *
+ * @param urls - Path segments to resolve into an absolute path.
+ * @returns An absolute path string resolved from the provided segments.
+ */
 export declare function resolve(...urls: string[]): string;
+/**
+ * Joins path segments into a single path string.
+ * This function combines multiple path segments using the appropriate path separator
+ * for the current operating system, similar to Node.js path.join.
+ *
+ * @param urls - Path segments to join together.
+ * @returns A joined path string with appropriate separators.
+ */
 export declare function join(...urls: string[]): string;

package/dist/node/storage/storage.util.d.ts

@@ -1,7 +1,51 @@
+/**
+ * Persistent storage utility object for data persistence across application sessions.
+ * This object provides methods for storing, retrieving, and managing data using node-persist,
+ * with automatic initialization and error handling.
+ */
 export declare const storage: {
+    /**
+     * Retrieves a value from persistent storage by key.
+     * This method fetches data that was previously stored using the set method.
+     * Returns null if the key doesn't exist or if an error occurs.
+     *
+     * @param key - The unique identifier for the stored value.
+     * @returns A promise that resolves to the stored value or null if not found.
+     */
     get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * Stores a value in persistent storage with a unique key.
+     * This method saves data that can be retrieved later using the get method.
+     * The data is automatically serialized and stored in the configured storage directory.
+     *
+     * @param key - The unique identifier for the value to store.
+     * @param value - The data to store (will be automatically serialized).
+     * @returns A promise that resolves when the storage operation is complete.
+     */
     set<T = unknown>(key: string, value: T): Promise<void>;
+    /**
+     * Removes a value from persistent storage by key.
+     * This method permanently deletes the stored data associated with the specified key.
+     *
+     * @param key - The unique identifier of the value to remove.
+     * @returns A promise that resolves when the removal operation is complete.
+     */
     remove(key: string): Promise<void>;
+    /**
+     * Retrieves all storage keys.
+     * This method returns an array of all keys that currently have stored values.
+     * Returns an empty array if no keys exist or if an error occurs.
+     *
+     * @returns A promise that resolves to an array of storage keys.
+     */
     keys(): Promise<string[]>;
+    /**
+     * Gets a human-readable log link for a storage key.
+     * This method provides a formatted string that shows the storage directory path
+     * and the key name for debugging and manual inspection purposes.
+     *
+     * @param key - The storage key to generate a log link for.
+     * @returns A promise that resolves to a formatted log link string or null if an error occurs.
+     */
     getLogLink(key: string): Promise<string | null>;
 };

package/dist/node/storage/storage.util.js

@@ -26,6 +26,14 @@ function o() {
   });
 }
 const R = {
+  /**
+   * Retrieves a value from persistent storage by key.
+   * This method fetches data that was previously stored using the set method.
+   * Returns null if the key doesn't exist or if an error occurs.
+   *
+   * @param key - The unique identifier for the stored value.
+   * @returns A promise that resolves to the stored value or null if not found.
+   */
   get(r) {
     return l(this, null, function* () {
       try {
@@ -37,6 +45,15 @@ const R = {
       }
     });
   },
+  /**
+   * Stores a value in persistent storage with a unique key.
+   * This method saves data that can be retrieved later using the get method.
+   * The data is automatically serialized and stored in the configured storage directory.
+   *
+   * @param key - The unique identifier for the value to store.
+   * @param value - The data to store (will be automatically serialized).
+   * @returns A promise that resolves when the storage operation is complete.
+   */
   set(r, e) {
     return l(this, null, function* () {
       try {
@@ -46,6 +63,13 @@ const R = {
       }
     });
   },
+  /**
+   * Removes a value from persistent storage by key.
+   * This method permanently deletes the stored data associated with the specified key.
+   *
+   * @param key - The unique identifier of the value to remove.
+   * @returns A promise that resolves when the removal operation is complete.
+   */
   remove(r) {
     return l(this, null, function* () {
       try {
@@ -55,6 +79,13 @@ const R = {
       }
     });
   },
+  /**
+   * Retrieves all storage keys.
+   * This method returns an array of all keys that currently have stored values.
+   * Returns an empty array if no keys exist or if an error occurs.
+   *
+   * @returns A promise that resolves to an array of storage keys.
+   */
   keys() {
     return l(this, null, function* () {
       try {
@@ -66,6 +97,14 @@ const R = {
       }
     });
   },
+  /**
+   * Gets a human-readable log link for a storage key.
+   * This method provides a formatted string that shows the storage directory path
+   * and the key name for debugging and manual inspection purposes.
+   *
+   * @param key - The storage key to generate a log link for.
+   * @returns A promise that resolves to a formatted log link string or null if an error occurs.
+   */
   getLogLink(r) {
     return l(this, null, function* () {
       try {

package/dist/node/upload/upload.util.d.ts

@@ -1,3 +1,24 @@
 import { I_UploadConfig, I_UploadOptions, I_UploadResult } from './upload.type.js';
+/**
+ * Creates a default upload configuration with predefined settings for different file types.
+ * This function provides sensible defaults for image, video, document, and other file types,
+ * including allowed extensions and size limits. The configuration can be customized with overrides.
+ *
+ * @param overrides - Optional configuration overrides to merge with the default configuration.
+ * @returns A complete upload configuration object with defaults and any provided overrides.
+ */
 export declare function createUploadConfig(overrides?: Partial<I_UploadConfig>): I_UploadConfig;
+/**
+ * Uploads a file with comprehensive validation and error handling.
+ * This function processes file uploads with the following features:
+ * - Input validation for path and file parameters
+ * - Configuration validation for all upload types
+ * - File size and extension validation
+ * - Automatic directory creation
+ * - Stream-based file writing
+ * - Comprehensive error handling and reporting
+ *
+ * @param options - Upload configuration including file, path, type, and optional validation config.
+ * @returns A promise that resolves to an upload result with success status, message, and file path.
+ */
 export declare function upload(options: I_UploadOptions): Promise<I_UploadResult>;

package/dist/node/ws/ts.util.d.ts

@@ -1,4 +1,20 @@
 import { WebSocketServer } from 'ws';
 import { I_GraphqlWSOptions, I_WSOptions } from './ws.type.js';
+/**
+ * Creates a WebSocket server with the specified configuration.
+ * This function creates a WebSocket server instance that can be attached to an HTTP server
+ * and configured with a specific path for WebSocket connections.
+ *
+ * @param options - Configuration options including the HTTP server instance and WebSocket path.
+ * @returns A configured WebSocket server instance ready to handle connections.
+ */
 export declare function createWSServer(options: I_WSOptions): WebSocketServer;
+/**
+ * Initializes GraphQL WebSocket server with schema and WebSocket server.
+ * This function sets up GraphQL subscriptions over WebSocket by creating a GraphQL WebSocket server
+ * that can handle GraphQL operations including queries, mutations, and subscriptions.
+ *
+ * @param options - Configuration options including the GraphQL schema and WebSocket server instance.
+ * @returns A configured GraphQL WebSocket server ready to handle GraphQL operations over WebSocket.
+ */
 export declare function initGraphQLWS(options: I_GraphqlWSOptions): import('graphql-ws').Disposable;