@cyberskill/shared 2.19.1 → 2.21.0

package/dist/config/storybook/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./storybook.main.cjs"),e=require("./storybook.preview.cjs");exports.storybookMain=o.storybookMain;exports.storybookPreview=e.storybookPreview;

package/dist/config/storybook/index.d.ts

@@ -0,0 +1,2 @@
+export * from './storybook.main.js';
+export * from './storybook.preview.js';

package/dist/config/storybook/index.js

@@ -0,0 +1,6 @@
+import { storybookMain as e } from "./storybook.main.js";
+import { storybookPreview as b } from "./storybook.preview.js";
+export {
+  e as storybookMain,
+  b as storybookPreview
+};

package/dist/config/storybook/storybook.main.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("../../util/object/object.util.cjs");function e(o){const t={stories:["../src/**/*.stories.@(js|jsx|mjs|ts|tsx|mdx)"],addons:["@storybook/addon-essentials","@storybook/addon-interactions","@storybook/addon-links"],framework:{name:"@storybook/react-vite",options:{}}};return s.deepMerge(t,o)}exports.storybookMain=e;

package/dist/config/storybook/storybook.main.d.ts

@@ -0,0 +1,17 @@
+import { StorybookConfig } from '@storybook/react-vite';
+/**
+ * Creates a Storybook main configuration for React projects using Vite.
+ * This function generates a Storybook configuration specifically designed for React applications
+ * with Vite as the build tool. It includes essential addons and framework settings.
+ *
+ * The configuration includes:
+ * - React Vite framework integration
+ * - Essential Storybook addons (docs, controls, actions, viewport, backgrounds)
+ * - Story file pattern matching
+ * - Vite configuration support
+ * - Configurable options merging
+ *
+ * @param options - Additional Storybook configuration options to merge with the base config.
+ * @returns A Storybook configuration object optimized for React with Vite.
+ */
+export declare function storybookMain(options?: Partial<StorybookConfig>): StorybookConfig;

package/dist/config/storybook/storybook.main.js

@@ -0,0 +1,18 @@
+import { deepMerge as s } from "../../util/object/object.util.js";
+function n(o) {
+  return s({
+    stories: ["../src/**/*.stories.@(js|jsx|mjs|ts|tsx|mdx)"],
+    addons: [
+      "@storybook/addon-essentials",
+      "@storybook/addon-interactions",
+      "@storybook/addon-links"
+    ],
+    framework: {
+      name: "@storybook/react-vite",
+      options: {}
+    }
+  }, o);
+}
+export {
+  n as storybookMain
+};

package/dist/config/storybook/storybook.preview.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var l=Object.defineProperty,n=Object.defineProperties,p=Object.getOwnPropertyDescriptors,o=Object.getOwnPropertySymbols,c=Object.prototype.hasOwnProperty,f=Object.prototype.propertyIsEnumerable,s=(e,r,t)=>r in e?l(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t,a=(e,r)=>{for(var t in r||(r={}))c.call(r,t)&&s(e,t,r[t]);if(o)for(var t of o(r))f.call(r,t)&&s(e,t,r[t]);return e},i=(e,r)=>n(e,p(r));function u(e){const r={parameters:{controls:{matchers:{color:/(background|color)$/i,date:/Date$/i}},backgrounds:{default:"light",values:[{name:"light",value:"#ffffff"},{name:"dark",value:"#333333"}]}}};return i(a(a({},r),e),{parameters:a(a({},r.parameters),e==null?void 0:e.parameters)})}exports.storybookPreview=u;

package/dist/config/storybook/storybook.preview.d.ts

@@ -0,0 +1,18 @@
+import { Preview } from '@storybook/react';
+/**
+ * Creates a Storybook preview configuration for React projects.
+ * This function generates a preview configuration that provides default parameters
+ * and decorators for Storybook stories. It sets up common controls, backgrounds,
+ * and viewport settings for consistent story rendering.
+ *
+ * The configuration includes:
+ * - Default control parameters for common props
+ * - Background color options
+ * - Viewport presets for responsive testing
+ * - Actions configuration for event handlers
+ * - Configurable options merging
+ *
+ * @param options - Additional preview configuration options to merge with the base config.
+ * @returns A Storybook preview configuration object.
+ */
+export declare function storybookPreview(options?: Partial<Preview>): Preview;

package/dist/config/storybook/storybook.preview.js

@@ -0,0 +1,39 @@
+var s = Object.defineProperty, n = Object.defineProperties, l = Object.getOwnPropertyDescriptors, o = Object.getOwnPropertySymbols, f = Object.prototype.hasOwnProperty, c = Object.prototype.propertyIsEnumerable, p = (e, r, a) => r in e ? s(e, r, { enumerable: !0, configurable: !0, writable: !0, value: a }) : e[r] = a, t = (e, r) => {
+  for (var a in r || (r = {}))
+    f.call(r, a) && p(e, a, r[a]);
+  if (o)
+    for (var a of o(r))
+      c.call(r, a) && p(e, a, r[a]);
+  return e;
+}, _ = (e, r) => n(e, l(r));
+function i(e) {
+  const r = {
+    parameters: {
+      controls: {
+        matchers: {
+          color: /(background|color)$/i,
+          date: /Date$/i
+        }
+      },
+      backgrounds: {
+        default: "light",
+        values: [
+          {
+            name: "light",
+            value: "#ffffff"
+          },
+          {
+            name: "dark",
+            value: "#333333"
+          }
+        ]
+      }
+    }
+  };
+  return _(t(t({}, r), e), {
+    parameters: t(t({}, r.parameters), e == null ? void 0 : e.parameters)
+  });
+}
+export {
+  i as storybookPreview
+};

package/dist/config/vitest/vitest.e2e.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@vitejs/plugin-react-swc"),i=require("lodash-es"),o=require("../../node_modules/.pnpm/vitest@4.0.9_@types_debug@4.1.12_@types_node@24.10.1_jiti@2.6.1_jsdom@27.2.0_sass@1.94.0_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.cjs");function s(e){const r={plugins:[t()],test:{include:["**/*.test.e2e.?(c|m)[jt]s?(x)"],browser:{enabled:!0,provider:"playwright",instances:[{browser:"chromium"},{browser:"firefox"},{browser:"webkit"}]}}};return o.defineConfig(i.merge(r,e))}exports.vitestE2E=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@vitejs/plugin-react-swc"),i=require("../../node_modules/.pnpm/vitest@4.0.16_@types_node@25.0.3_jiti@2.6.1_jsdom@27.3.0_sass@1.97.0_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.cjs"),o=require("../../util/object/object.util.cjs");function n(e){const r={plugins:[t()],test:{include:["**/*.test.e2e.?(c|m)[jt]s?(x)"],browser:{enabled:!0,provider:"playwright",instances:[{browser:"chromium"},{browser:"firefox"},{browser:"webkit"}]}}};return i.defineConfig(o.deepMerge(r,e))}exports.vitestE2E=n;

package/dist/config/vitest/vitest.e2e.js

@@ -1,8 +1,8 @@
 import t from "@vitejs/plugin-react-swc";
-import { merge as o } from "lodash-es";
-import { defineConfig as i } from "../../node_modules/.pnpm/vitest@4.0.9_@types_debug@4.1.12_@types_node@24.10.1_jiti@2.6.1_jsdom@27.2.0_sass@1.94.0_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.js";
-function f(r) {
-  const e = {
+import { defineConfig as o } from "../../node_modules/.pnpm/vitest@4.0.16_@types_node@25.0.3_jiti@2.6.1_jsdom@27.3.0_sass@1.97.0_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.js";
+import { deepMerge as i } from "../../util/object/object.util.js";
+function m(e) {
+  const r = {
     plugins: [t()],
     test: {
       include: ["**/*.test.e2e.?(c|m)[jt]s?(x)"],
@@ -17,8 +17,8 @@ function f(r) {
       }
     }
   };
-  return i(o(e, r));
+  return o(i(r, e));
 }
 export {
-  f as vitestE2E
+  m as vitestE2E
 };

package/dist/config/vitest/vitest.unit.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@vitejs/plugin-react-swc"),n=require("lodash-es"),s=require("../../node_modules/.pnpm/vitest@4.0.9_@types_debug@4.1.12_@types_node@24.10.1_jiti@2.6.1_jsdom@27.2.0_sass@1.94.0_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.cjs");function r(e){const t={plugins:[i()],test:{globals:!0,environment:"jsdom",pool:"vmThreads",include:["**/*.test.unit.?(c|m)[jt]s?(x)"],setupFiles:["./vitest.unit.setup.ts"]}};return s.defineConfig(n.merge(t,e))}exports.vitestUnit=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@vitejs/plugin-react-swc"),n=require("../../node_modules/.pnpm/vitest@4.0.16_@types_node@25.0.3_jiti@2.6.1_jsdom@27.3.0_sass@1.97.0_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.cjs"),s=require("../../util/object/object.util.cjs");function r(e){const t={plugins:[i()],test:{globals:!0,environment:"jsdom",pool:"vmThreads",include:["**/*.test.unit.?(c|m)[jt]s?(x)"],setupFiles:["./vitest.unit.setup.ts"]}};return n.defineConfig(s.deepMerge(t,e))}exports.vitestUnit=r;

package/dist/config/vitest/vitest.unit.js

@@ -1,7 +1,7 @@
 import i from "@vitejs/plugin-react-swc";
-import { merge as o } from "lodash-es";
-import { defineConfig as n } from "../../node_modules/.pnpm/vitest@4.0.9_@types_debug@4.1.12_@types_node@24.10.1_jiti@2.6.1_jsdom@27.2.0_sass@1.94.0_tsx@4.20.6_yaml@2.8.1/node_modules/vitest/dist/config.js";
-function u(t) {
+import { defineConfig as o } from "../../node_modules/.pnpm/vitest@4.0.16_@types_node@25.0.3_jiti@2.6.1_jsdom@27.3.0_sass@1.97.0_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.js";
+import { deepMerge as n } from "../../util/object/object.util.js";
+function p(t) {
   const e = {
     plugins: [i()],
     test: {
@@ -12,8 +12,8 @@ function u(t) {
       setupFiles: ["./vitest.unit.setup.ts"]
     }
   };
-  return n(o(e, t));
+  return o(n(e, t));
 }
 export {
-  u as vitestUnit
+  p as vitestUnit
 };

package/dist/node/cli/index.cjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-"use strict";const g=require("node:process"),k=require("yargs/helpers"),L=require("yargs/yargs"),i=require("../command/command.util.cjs"),p=require("../package/package.util.cjs"),l=require("../fs/fs.util.cjs"),P=require("../path/path.util.cjs"),n=require("../path/path.constant.cjs"),s=require("../log/log.util.cjs"),f=require("../log/log.type.cjs");var t=(e,o,r)=>new Promise((c,y)=>{var _=a=>{try{m(r.next(a))}catch(d){y(d)}},I=a=>{try{m(r.throw(a))}catch(d){y(d)}},m=a=>a.done?c(a.value):Promise.resolve(a.value).then(_,I);m((r=r.apply(e,o)).next())});function T(){try{return JSON.parse(l.readFileSync(P.resolve(__dirname,"../../../package.json"),"utf-8")).version}catch(e){return"1.0.0"}}function C(){return t(this,null,function*(){l.pathExistsSync(n.PATH.TS_CONFIG)?yield i.runCommand("Performing TypeScript validation",yield n.command.typescriptCheck()):s.log.warn("No TypeScript configuration found. Skipping type check.")})}function E(e=!1){return t(this,null,function*(){e?yield i.runCommand("Running ESLint with auto-fix",yield n.command.eslintFix()):yield i.runCommand("Running ESLint check",yield n.command.eslintCheck())})}function h(e,o){if(!o.length)return;const r=e==="Errors"?"red":"yellow";s.log.printBoxedLog(e==="Errors"?"✖ Errors":"⚠ Warnings",o,r)}function u(){return t(this,null,function*(){setTimeout(()=>t(null,null,function*(){const e=yield i.getStoredErrorLists(),o=e.filter(c=>c.type===f.E_IssueType.Error),r=e.filter(c=>c.type===f.E_IssueType.Warning);!o.length&&!r.length?s.log.printBoxedLog("✔ NO ISSUES FOUND",[],"green"):(h("Warnings",r),h("Errors",o),o.length>0&&g.exit(1))}),0)})}function A(){return t(this,null,function*(){yield i.clearAllErrorLists();const e=yield p.getPackage({name:n.CYBERSKILL_PACKAGE_NAME});if(!e.success){s.log.error("Failed to retrieve package information. Aborting lint-staged.");return}e.result.isCurrentProject&&(yield i.runCommand(`Building package: ${n.CYBERSKILL_PACKAGE_NAME}`,yield n.command.build())),yield i.runCommand("Executing lint-staged",yield n.command.lintStaged()),u()})}function M(){return t(this,null,function*(){yield i.runCommand("Inspecting ESLint configuration",yield n.command.eslintInspect())})}function O(){return t(this,null,function*(){yield i.clearAllErrorLists(),yield Promise.all([C(),E()]),u()})}function v(){return t(this,null,function*(){yield i.clearAllErrorLists(),yield Promise.all([C(),E(!0)]),u()})}function G(){return t(this,null,function*(){yield i.clearAllErrorLists(),yield i.runCommand("Validating commit message",yield n.command.commitLint()),u()})}function S(){return t(this,null,function*(){yield i.runCommand("Configuring Git hooks",yield n.command.configureGitHook()),l.removeSync(n.PATH.GIT_HOOK);const e=yield i.resolveCommands(n.createGitHooksConfig);l.writeFileSync(n.PATH.SIMPLE_GIT_HOOKS_JSON,JSON.stringify(e,null,4));const o=`
+"use strict";const g=require("node:process"),I=require("yargs/helpers"),v=require("yargs/yargs"),i=require("../command/command.util.cjs"),y=require("../package/package.util.cjs"),l=require("../fs/fs.util.cjs"),L=require("../path/path.util.cjs"),n=require("../path/path.constant.cjs"),s=require("../log/log.util.cjs"),f=require("../log/log.type.cjs");var t=(e,o,r)=>new Promise((c,p)=>{var k=a=>{try{m(r.next(a))}catch(d){p(d)}},_=a=>{try{m(r.throw(a))}catch(d){p(d)}},m=a=>a.done?c(a.value):Promise.resolve(a.value).then(k,_);m((r=r.apply(e,o)).next())});function P(){try{return JSON.parse(l.readFileSync(L.resolve(__dirname,"../../../package.json"),"utf-8")).version}catch(e){return"1.0.0"}}function C(){return t(this,null,function*(){l.pathExistsSync(n.PATH.TS_CONFIG)?yield i.runCommand("Performing TypeScript validation",yield n.command.typescriptCheck()):s.log.warn("No TypeScript configuration found. Skipping type check.")})}function S(e=!1){return t(this,null,function*(){e?yield i.runCommand("Running ESLint with auto-fix",yield n.command.eslintFix()):yield i.runCommand("Running ESLint check",yield n.command.eslintCheck())})}function h(e,o){if(!o.length)return;const r=e==="Errors"?"red":"yellow";s.log.printBoxedLog(e==="Errors"?"✖ Errors":"⚠ Warnings",o,r)}function u(){return t(this,null,function*(){setTimeout(()=>t(null,null,function*(){const e=yield i.getStoredErrorLists(),o=e.filter(c=>c.type===f.E_IssueType.Error),r=e.filter(c=>c.type===f.E_IssueType.Warning);!o.length&&!r.length?s.log.printBoxedLog("✔ NO ISSUES FOUND",[],"green"):(h("Warnings",r),h("Errors",o),o.length>0&&g.exit(1))}),0)})}function T(){return t(this,null,function*(){yield i.clearAllErrorLists();const e=yield y.getPackage({name:n.CYBERSKILL_PACKAGE_NAME});if(!e.success){s.log.error("Failed to retrieve package information. Aborting lint-staged.");return}e.result.isCurrentProject&&(yield i.runCommand(`Building package: ${n.CYBERSKILL_PACKAGE_NAME}`,yield n.command.build())),yield i.runCommand("Executing lint-staged",yield n.command.lintStaged()),u()})}function A(){return t(this,null,function*(){yield i.runCommand("Inspecting ESLint configuration",yield n.command.eslintInspect())})}function M(){return t(this,null,function*(){yield i.clearAllErrorLists(),yield Promise.all([C(),S()]),u()})}function O(){return t(this,null,function*(){yield i.clearAllErrorLists(),yield Promise.all([C(),S(!0)]),u()})}function G(){return t(this,null,function*(){yield i.clearAllErrorLists(),yield i.runCommand("Validating commit message",yield n.command.commitLint()),u()})}function E(){return t(this,null,function*(){yield i.runCommand("Configuring Git hooks",yield n.command.configureGitHook()),l.removeSync(n.PATH.GIT_HOOK);const e=yield i.resolveCommands(n.createGitHooksConfig);l.writeFileSync(n.PATH.SIMPLE_GIT_HOOKS_JSON,JSON.stringify(e,null,4));const o=`
 ${n.SIMPLE_GIT_HOOK_JSON}
 `;l.pathExistsSync(n.PATH.GIT_IGNORE)?l.readFileSync(n.PATH.GIT_IGNORE,"utf-8").split(`
-`).includes(n.SIMPLE_GIT_HOOK_JSON)||l.appendFileSync(n.PATH.GIT_IGNORE,o):l.writeFileSync(n.PATH.GIT_IGNORE,o),yield i.runCommand("Setting up simple-git-hooks",yield n.command.simpleGitHooks())})}function R(){return t(this,null,function*(){yield p.installDependencies(),yield S()})}function N(){return t(this,null,function*(){l.removeSync(n.PATH.NODE_MODULES,n.PATH.PNPM_LOCK_YAML),yield i.runCommand("Pruning pnpm store",yield n.command.pnpmPruneStore()),yield i.runCommand("Clearing pnpm cache",yield n.command.pnpmCleanCache()),yield p.installDependencies(),yield S()})}function H(){return t(this,null,function*(){yield i.runCommand("Inspecting project dependencies",yield n.command.nodeModulesInspect())})}function w(){return t(this,null,function*(){yield i.runCommand("Running unit tests",yield n.command.testUnit())})}function D(){return t(this,null,function*(){yield i.runCommand("Running end-to-end tests",yield n.command.testE2e())})}function B(e){return t(this,null,function*(){yield i.runCommand("Creating MongoDB migration",yield n.command.mongoMigrateCreate(e))})}function x(){return t(this,null,function*(){yield i.runCommand("Running MongoDB migrations",yield n.command.mongoMigrateUp())})}function q(){return t(this,null,function*(){yield i.runCommand("Rolling back MongoDB migration",yield n.command.mongoMigrateDown())})}t(null,null,function*(){try{yield L(k.hideBin(g.argv)).scriptName(n.CYBERSKILL_CLI).usage("$0 <command> [options]").command("lint","Check code for linting issues",O).command("lint:fix","Fix linting issues automatically",v).command("lint:inspect","View active ESLint configuration",M).command("lint-staged","Run lint checks on staged files",A).command("commitlint","Validate commit message format",G).command("ready","Initialize project and dependencies",R).command("reset","Reset the project and reinstall dependencies",N).command("inspect","Analyze installed project dependencies",H).command("test:unit","Run unit test suite",w).command("test:e2e","Run end-to-end test suite",D).command("mongo:migrate:create <name>","Create a MongoDB migration",e=>e.positional("name",{describe:"Migration name",type:"string"}),e=>t(null,null,function*(){if(!e.name){s.log.error("Migration name is required.");return}yield B(e.name)})).command("mongo:migrate:up","Apply all MongoDB migrations",x).command("mongo:migrate:down","Rollback last MongoDB migration",q).demandCommand(1,"Please specify a valid command.").strict().help().alias("h","help").alias("v","version").version(T()).epilog(`💡 Tip: Use "--help" with any command to see options
+`).includes(n.SIMPLE_GIT_HOOK_JSON)||l.appendFileSync(n.PATH.GIT_IGNORE,o):l.writeFileSync(n.PATH.GIT_IGNORE,o),yield i.runCommand("Setting up simple-git-hooks",yield n.command.simpleGitHooks())})}function R(){return t(this,null,function*(){yield y.installDependencies(),yield E()})}function N(){return t(this,null,function*(){l.removeSync(n.PATH.NODE_MODULES,n.PATH.PNPM_LOCK_YAML),yield i.runCommand("Pruning pnpm store",yield n.command.pnpmPruneStore()),yield i.runCommand("Clearing pnpm cache",yield n.command.pnpmCleanCache()),yield y.installDependencies(),yield E()})}function b(){return t(this,null,function*(){yield i.runCommand("Inspecting project dependencies",yield n.command.nodeModulesInspect())})}function B(){return t(this,null,function*(){yield i.runCommand("Running unit tests",yield n.command.testUnit())})}function H(){return t(this,null,function*(){yield i.runCommand("Running end-to-end tests",yield n.command.testE2e())})}function D(e){return t(this,null,function*(){yield i.runCommand("Creating MongoDB migration",yield n.command.mongoMigrateCreate(e))})}function w(){return t(this,null,function*(){yield i.runCommand("Running MongoDB migrations",yield n.command.mongoMigrateUp())})}function x(){return t(this,null,function*(){yield i.runCommand("Rolling back MongoDB migration",yield n.command.mongoMigrateDown())})}function q(){return t(this,null,function*(){yield i.runCommand("Starting Storybook development server",yield n.command.storybookDev())})}function F(){return t(this,null,function*(){yield i.runCommand("Building Storybook",yield n.command.storybookBuild())})}t(null,null,function*(){try{yield v(I.hideBin(g.argv)).scriptName(n.CYBERSKILL_CLI).usage("$0 <command> [options]").command("lint","Check code for linting issues",M).command("lint:fix","Fix linting issues automatically",O).command("lint:inspect","View active ESLint configuration",A).command("lint-staged","Run lint checks on staged files",T).command("commitlint","Validate commit message format",G).command("ready","Initialize project and dependencies",R).command("reset","Reset the project and reinstall dependencies",N).command("inspect","Analyze installed project dependencies",b).command("test:unit","Run unit test suite",B).command("test:e2e","Run end-to-end test suite",H).command("mongo:migrate:create <name>","Create a MongoDB migration",e=>e.positional("name",{describe:"Migration name",type:"string"}),e=>t(null,null,function*(){if(!e.name){s.log.error("Migration name is required.");return}yield D(e.name)})).command("mongo:migrate:up","Apply all MongoDB migrations",w).command("mongo:migrate:down","Rollback last MongoDB migration",x).command("storybook:dev","Start Storybook development server",q).command("storybook:build","Build Storybook for production",F).demandCommand(1,"Please specify a valid command.").strict().help().alias("h","help").alias("v","version").version(P()).epilog(`💡 Tip: Use "--help" with any command to see options
 `).parse()}catch(e){s.catchError(e),g.exit(1)}});

package/dist/node/cli/index.js

@@ -1,114 +1,114 @@
 #!/usr/bin/env node
-import p from "node:process";
-import { hideBin as N } from "yargs/helpers";
-import P from "yargs/yargs";
-import { clearAllErrorLists as u, runCommand as i, getStoredErrorLists as T, resolveCommands as w } from "../command/command.util.js";
-import { getPackage as D, installDependencies as I } from "../package/package.util.js";
-import { removeSync as C, readFileSync as _, pathExistsSync as L, writeFileSync as y, appendFileSync as B } from "../fs/fs.util.js";
-import { resolve as x } from "../path/path.util.js";
-import { CYBERSKILL_CLI as A, command as t, CYBERSKILL_PACKAGE_NAME as h, PATH as l, SIMPLE_GIT_HOOK_JSON as E, createGitHooksConfig as F } from "../path/path.constant.js";
-import { log as a, catchError as H } from "../log/log.util.js";
+import y from "node:process";
+import { hideBin as b } from "yargs/helpers";
+import B from "yargs/yargs";
+import { clearAllErrorLists as a, runCommand as i, getStoredErrorLists as N, resolveCommands as P } from "../command/command.util.js";
+import { getPackage as D, installDependencies as v } from "../package/package.util.js";
+import { removeSync as I, readFileSync as C, pathExistsSync as _, writeFileSync as f, appendFileSync as T } from "../fs/fs.util.js";
+import { resolve as w } from "../path/path.util.js";
+import { CYBERSKILL_CLI as x, command as t, CYBERSKILL_PACKAGE_NAME as h, PATH as l, SIMPLE_GIT_HOOK_JSON as k, createGitHooksConfig as A } from "../path/path.constant.js";
+import { log as u, catchError as F } from "../log/log.util.js";
 import { E_IssueType as S } from "../log/log.type.js";
-var e = (n, o, r) => new Promise((c, f) => {
+var e = (n, o, r) => new Promise((c, p) => {
   var R = (s) => {
     try {
       m(r.next(s));
     } catch (g) {
-      f(g);
+      p(g);
     }
   }, G = (s) => {
     try {
       m(r.throw(s));
     } catch (g) {
-      f(g);
+      p(g);
     }
   }, m = (s) => s.done ? c(s.value) : Promise.resolve(s.value).then(R, G);
   m((r = r.apply(n, o)).next());
 });
-function U() {
+function H() {
   try {
     return JSON.parse(
-      _(x(__dirname, "../../../package.json"), "utf-8")
+      C(w(__dirname, "../../../package.json"), "utf-8")
     ).version;
   } catch (n) {
     return "1.0.0";
   }
 }
-function M() {
+function L() {
   return e(this, null, function* () {
-    L(l.TS_CONFIG) ? yield i("Performing TypeScript validation", yield t.typescriptCheck()) : a.warn("No TypeScript configuration found. Skipping type check.");
+    _(l.TS_CONFIG) ? yield i("Performing TypeScript validation", yield t.typescriptCheck()) : u.warn("No TypeScript configuration found. Skipping type check.");
   });
 }
-function O(n = !1) {
+function M(n = !1) {
   return e(this, null, function* () {
     n ? yield i("Running ESLint with auto-fix", yield t.eslintFix()) : yield i("Running ESLint check", yield t.eslintCheck());
   });
 }
-function k(n, o) {
+function E(n, o) {
   if (!o.length)
     return;
   const r = n === "Errors" ? "red" : "yellow";
-  a.printBoxedLog(n === "Errors" ? "✖ Errors" : "⚠ Warnings", o, r);
+  u.printBoxedLog(n === "Errors" ? "✖ Errors" : "⚠ Warnings", o, r);
 }
 function d() {
   return e(this, null, function* () {
     setTimeout(() => e(null, null, function* () {
-      const n = yield T(), o = n.filter((c) => c.type === S.Error), r = n.filter((c) => c.type === S.Warning);
-      !o.length && !r.length ? a.printBoxedLog("✔ NO ISSUES FOUND", [], "green") : (k("Warnings", r), k("Errors", o), o.length > 0 && p.exit(1));
+      const n = yield N(), o = n.filter((c) => c.type === S.Error), r = n.filter((c) => c.type === S.Warning);
+      !o.length && !r.length ? u.printBoxedLog("✔ NO ISSUES FOUND", [], "green") : (E("Warnings", r), E("Errors", o), o.length > 0 && y.exit(1));
     }), 0);
   });
 }
-function K() {
+function U() {
   return e(this, null, function* () {
-    yield u();
+    yield a();
     const n = yield D({ name: h });
     if (!n.success) {
-      a.error("Failed to retrieve package information. Aborting lint-staged.");
+      u.error("Failed to retrieve package information. Aborting lint-staged.");
       return;
     }
     n.result.isCurrentProject && (yield i(`Building package: ${h}`, yield t.build())), yield i("Executing lint-staged", yield t.lintStaged()), d();
   });
 }
-function b() {
+function K() {
   return e(this, null, function* () {
     yield i("Inspecting ESLint configuration", yield t.eslintInspect());
   });
 }
 function j() {
   return e(this, null, function* () {
-    yield u(), yield Promise.all([M(), O()]), d();
+    yield a(), yield Promise.all([L(), M()]), d();
   });
 }
 function J() {
   return e(this, null, function* () {
-    yield u(), yield Promise.all([M(), O(!0)]), d();
+    yield a(), yield Promise.all([L(), M(!0)]), d();
   });
 }
 function V() {
   return e(this, null, function* () {
-    yield u(), yield i("Validating commit message", yield t.commitLint()), d();
+    yield a(), yield i("Validating commit message", yield t.commitLint()), d();
   });
 }
-function v() {
+function O() {
   return e(this, null, function* () {
-    yield i("Configuring Git hooks", yield t.configureGitHook()), C(l.GIT_HOOK);
-    const n = yield w(F);
-    y(l.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(n, null, 4));
+    yield i("Configuring Git hooks", yield t.configureGitHook()), I(l.GIT_HOOK);
+    const n = yield P(A);
+    f(l.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(n, null, 4));
     const o = `
-${E}
+${k}
 `;
-    L(l.GIT_IGNORE) ? _(l.GIT_IGNORE, "utf-8").split(`
-`).includes(E) || B(l.GIT_IGNORE, o) : y(l.GIT_IGNORE, o), yield i("Setting up simple-git-hooks", yield t.simpleGitHooks());
+    _(l.GIT_IGNORE) ? C(l.GIT_IGNORE, "utf-8").split(`
+`).includes(k) || T(l.GIT_IGNORE, o) : f(l.GIT_IGNORE, o), yield i("Setting up simple-git-hooks", yield t.simpleGitHooks());
   });
 }
 function W() {
   return e(this, null, function* () {
-    yield I(), yield v();
+    yield v(), yield O();
   });
 }
 function Y() {
   return e(this, null, function* () {
-    C(l.NODE_MODULES, l.PNPM_LOCK_YAML), yield i("Pruning pnpm store", yield t.pnpmPruneStore()), yield i("Clearing pnpm cache", yield t.pnpmCleanCache()), yield I(), yield v();
+    I(l.NODE_MODULES, l.PNPM_LOCK_YAML), yield i("Pruning pnpm store", yield t.pnpmPruneStore()), yield i("Clearing pnpm cache", yield t.pnpmCleanCache()), yield v(), yield O();
   });
 }
 function $() {
@@ -141,20 +141,30 @@ function Z() {
     yield i("Rolling back MongoDB migration", yield t.mongoMigrateDown());
   });
 }
+function nn() {
+  return e(this, null, function* () {
+    yield i("Starting Storybook development server", yield t.storybookDev());
+  });
+}
+function en() {
+  return e(this, null, function* () {
+    yield i("Building Storybook", yield t.storybookBuild());
+  });
+}
 e(null, null, function* () {
   try {
-    yield P(N(p.argv)).scriptName(A).usage("$0 <command> [options]").command("lint", "Check code for linting issues", j).command("lint:fix", "Fix linting issues automatically", J).command("lint:inspect", "View active ESLint configuration", b).command("lint-staged", "Run lint checks on staged files", K).command("commitlint", "Validate commit message format", V).command("ready", "Initialize project and dependencies", W).command("reset", "Reset the project and reinstall dependencies", Y).command("inspect", "Analyze installed project dependencies", $).command("test:unit", "Run unit test suite", z).command("test:e2e", "Run end-to-end test suite", q).command("mongo:migrate:create <name>", "Create a MongoDB migration", (n) => n.positional("name", {
+    yield B(b(y.argv)).scriptName(x).usage("$0 <command> [options]").command("lint", "Check code for linting issues", j).command("lint:fix", "Fix linting issues automatically", J).command("lint:inspect", "View active ESLint configuration", K).command("lint-staged", "Run lint checks on staged files", U).command("commitlint", "Validate commit message format", V).command("ready", "Initialize project and dependencies", W).command("reset", "Reset the project and reinstall dependencies", Y).command("inspect", "Analyze installed project dependencies", $).command("test:unit", "Run unit test suite", z).command("test:e2e", "Run end-to-end test suite", q).command("mongo:migrate:create <name>", "Create a MongoDB migration", (n) => n.positional("name", {
       describe: "Migration name",
       type: "string"
     }), (n) => e(null, null, function* () {
       if (!n.name) {
-        a.error("Migration name is required.");
+        u.error("Migration name is required.");
         return;
       }
       yield Q(n.name);
-    })).command("mongo:migrate:up", "Apply all MongoDB migrations", X).command("mongo:migrate:down", "Rollback last MongoDB migration", Z).demandCommand(1, "Please specify a valid command.").strict().help().alias("h", "help").alias("v", "version").version(U()).epilog(`💡 Tip: Use "--help" with any command to see options
+    })).command("mongo:migrate:up", "Apply all MongoDB migrations", X).command("mongo:migrate:down", "Rollback last MongoDB migration", Z).command("storybook:dev", "Start Storybook development server", nn).command("storybook:build", "Build Storybook for production", en).demandCommand(1, "Please specify a valid command.").strict().help().alias("h", "help").alias("v", "version").version(H()).epilog(`💡 Tip: Use "--help" with any command to see options
 `).parse();
   } catch (n) {
-    H(n), p.exit(1);
+    F(n), y.exit(1);
   }
 });

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("@nestjs/core"),P=require("compression"),h=require("cookie-parser"),m=require("cors"),c=require("express"),q=require("express-session"),x=require("express-useragent"),b=require("graphql-upload/graphqlUploadExpress.mjs");var g=Object.defineProperty,l=Object.getOwnPropertySymbols,v=Object.prototype.hasOwnProperty,d=Object.prototype.propertyIsEnumerable,p=(e,r,t)=>r in e?g(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t,S=(e,r)=>{for(var t in r||(r={}))v.call(r,t)&&p(e,t,r[t]);if(l)for(var t of l(r))d.call(r,t)&&p(e,t,r[t]);return e},E=(e,r)=>{var t={};for(var s in e)v.call(e,s)&&r.indexOf(s)<0&&(t[s]=e[s]);if(e!=null&&l)for(var s of l(e))r.indexOf(s)<0&&d.call(e,s)&&(t[s]=e[s]);return t},C=(e,r,t)=>new Promise((s,a)=>{var i=n=>{try{o(t.next(n))}catch(f){a(f)}},u=n=>{try{o(t.throw(n))}catch(f){a(f)}},o=n=>n.done?s(n.value):Promise.resolve(n.value).then(i,u);o((t=t.apply(e,r)).next())});function y(e){var r=e,{isDev:t,whiteList:s}=r,a=E(r,["isDev","whiteList"]);return S({origin:(i,u)=>{t||!i||s!=null&&s.includes(i!=null?i:"")?u(null,!0):u(new Error("Not allowed by CORS"),!1)},credentials:!0},a)}function N(e){return m(y(e))}function j(e){return q(e)}function _(e){e.set("trust proxy",1),e.use(h()),e.use(c.urlencoded({extended:!0})),e.use(P()),e.use(x.express())}function O(e,r){r&&(Array.isArray(r)?r:[r]).forEach(s=>{e.use(`/${s}`,c.static(s))})}function A(e){const r=c();return _(r),O(r,e==null?void 0:e.static),r.use(b()),r}function I(e){return C(this,null,function*(){const r=yield w.NestFactory.create(e.module);return _(r.getHttpAdapter().getInstance()),O(r.getHttpAdapter().getInstance(),e.static),e.filters&&r.useGlobalFilters(...e.filters),e.pipes&&r.useGlobalPipes(...e.pipes),r})}exports.express=c;exports.createCors=N;exports.createCorsOptions=y;exports.createExpress=A;exports.createNest=I;exports.createSession=j;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("@nestjs/core"),P=require("compression"),h=require("cookie-parser"),m=require("cors"),c=require("express"),x=require("express-session"),q=require("express-useragent"),b=require("graphql-upload/graphqlUploadExpress.mjs");var g=Object.defineProperty,l=Object.getOwnPropertySymbols,v=Object.prototype.hasOwnProperty,d=Object.prototype.propertyIsEnumerable,p=(e,r,t)=>r in e?g(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t,S=(e,r)=>{for(var t in r||(r={}))v.call(r,t)&&p(e,t,r[t]);if(l)for(var t of l(r))d.call(r,t)&&p(e,t,r[t]);return e},E=(e,r)=>{var t={};for(var s in e)v.call(e,s)&&r.indexOf(s)<0&&(t[s]=e[s]);if(e!=null&&l)for(var s of l(e))r.indexOf(s)<0&&d.call(e,s)&&(t[s]=e[s]);return t},C=(e,r,t)=>new Promise((s,a)=>{var i=n=>{try{o(t.next(n))}catch(f){a(f)}},u=n=>{try{o(t.throw(n))}catch(f){a(f)}},o=n=>n.done?s(n.value):Promise.resolve(n.value).then(i,u);o((t=t.apply(e,r)).next())});function y(e){var r=e,{isDev:t,whiteList:s}=r,a=E(r,["isDev","whiteList"]);return S({origin:(i,u)=>{t||!i||s!=null&&s.includes(i!=null?i:"")?u(null,!0):u(new Error("Not allowed by CORS"),!1)},credentials:!0},a)}function N(e){return m(y(e))}function j(e){return x(e)}function _(e){e.set("trust proxy",1),e.use(h()),e.use(c.urlencoded({extended:!0})),e.use(P()),e.use(q.express())}function O(e,r){r&&(Array.isArray(r)?r:[r]).forEach(s=>{e.use(`/${s}`,c.static(s))})}function A(e){const r=c();return _(r),O(r,e==null?void 0:e.static),r.use(b()),r}function I(e){return C(this,null,function*(){const r=yield w.NestFactory.create(e.module);return _(r.getHttpAdapter().getInstance()),O(r.getHttpAdapter().getInstance(),e.static),e.filters&&r.useGlobalFilters(...e.filters),e.pipes&&r.useGlobalPipes(...e.pipes),r})}exports.express=c;exports.createCors=N;exports.createCorsOptions=y;exports.createExpress=A;exports.createNest=I;exports.createSession=j;

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

@@ -4,10 +4,10 @@ import O from "cookie-parser";
 import h from "cors";
 import c from "express";
 import { default as B } from "express";
-import P from "express-session";
-import x from "express-useragent";
+import x from "express-session";
+import { express as P } from "express-useragent";
 import b from "graphql-upload/graphqlUploadExpress.mjs";
-var g = Object.defineProperty, l = Object.getOwnPropertySymbols, m = Object.prototype.hasOwnProperty, v = Object.prototype.propertyIsEnumerable, p = (e, r, t) => r in e ? g(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t, E = (e, r) => {
+var E = Object.defineProperty, l = Object.getOwnPropertySymbols, m = Object.prototype.hasOwnProperty, v = Object.prototype.propertyIsEnumerable, p = (e, r, t) => r in e ? E(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t, g = (e, r) => {
   for (var t in r || (r = {}))
     m.call(r, t) && p(e, t, r[t]);
   if (l)
@@ -23,59 +23,59 @@ var g = Object.defineProperty, l = Object.getOwnPropertySymbols, m = Object.prot
       r.indexOf(s) < 0 && v.call(e, s) && (t[s] = e[s]);
   return t;
 }, A = (e, r, t) => new Promise((s, a) => {
-  var i = (n) => {
+  var n = (i) => {
     try {
-      f(t.next(n));
+      f(t.next(i));
     } catch (u) {
       a(u);
     }
-  }, o = (n) => {
+  }, o = (i) => {
     try {
-      f(t.throw(n));
+      f(t.throw(i));
     } catch (u) {
       a(u);
     }
-  }, f = (n) => n.done ? s(n.value) : Promise.resolve(n.value).then(i, o);
+  }, f = (i) => i.done ? s(i.value) : Promise.resolve(i.value).then(n, o);
   f((t = t.apply(e, r)).next());
 });
 function I(e) {
   var r = e, { isDev: t, whiteList: s } = r, a = S(r, ["isDev", "whiteList"]);
-  return E({
-    origin: (i, o) => {
-      t || !i || s != null && s.includes(i != null ? i : "") ? o(null, !0) : o(new Error("Not allowed by CORS"), !1);
+  return g({
+    origin: (n, o) => {
+      t || !n || s != null && s.includes(n != null ? n : "") ? o(null, !0) : o(new Error("Not allowed by CORS"), !1);
     },
     credentials: !0
   }, a);
 }
-function q(e) {
+function $(e) {
   return h(I(e));
 }
-function M(e) {
-  return P(e);
+function q(e) {
+  return x(e);
 }
 function d(e) {
-  e.set("trust proxy", 1), e.use(O()), e.use(c.urlencoded({ extended: !0 })), e.use(w()), e.use(x.express());
+  e.set("trust proxy", 1), e.use(O()), e.use(c.urlencoded({ extended: !0 })), e.use(w()), e.use(P());
 }
 function _(e, r) {
   r && (Array.isArray(r) ? r : [r]).forEach((s) => {
     e.use(`/${s}`, c.static(s));
   });
 }
-function U(e) {
+function M(e) {
   const r = c();
   return d(r), _(r, e == null ? void 0 : e.static), r.use(b()), r;
 }
-function V(e) {
+function U(e) {
   return A(this, null, function* () {
     const r = yield y.create(e.module);
     return d(r.getHttpAdapter().getInstance()), _(r.getHttpAdapter().getInstance(), e.static), e.filters && r.useGlobalFilters(...e.filters), e.pipes && r.useGlobalPipes(...e.pipes), r;
   });
 }
 export {
-  q as createCors,
+  $ as createCors,
   I as createCorsOptions,
-  U as createExpress,
-  V as createNest,
-  M as createSession,
+  M as createExpress,
+  U as createNest,
+  q as createSession,
   B as express
 };

package/dist/node/mongo/mongo-controller.test.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/node/mongo/mongo.test.unit.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,5 +1,5 @@
 import { DeleteResult, Filter, InsertManyResult, InsertOneResult, OptionalUnlessRequiredId, UpdateResult, WithId, Collection, Db } from 'mongodb';
-import { AggregatePaginateModel, AggregatePaginateResult, ClientSession, ErrorHandlingMiddlewareFunction, ErrorHandlingMiddlewareWithOption, FilterQuery, InsertManyOptions, PaginateModel, PaginateOptions, PaginateResult, PipelineStage, PopulateOption, PopulateOptions, PostMiddlewareFunction, PreMiddlewareFunction, PreSaveMiddlewareFunction, ProjectionType, QueryOptions, QueryWithHelpers, Schema, SchemaDefinition, UpdateQuery, UpdateWriteOpResult, default as mongoose, Document, Model } from 'mongoose';
+import { AggregatePaginateModel, AggregatePaginateResult, ClientSession, ErrorHandlingMiddlewareFunction, ErrorHandlingMiddlewareWithOption, InsertManyOptions, PaginateModel, PaginateOptions, PaginateResult, PipelineStage, PopulateOption, PopulateOptions, PostMiddlewareFunction, PreMiddlewareFunction, PreSaveMiddlewareFunction, ProjectionType, QueryFilter, QueryOptions, QueryWithHelpers, Schema, SchemaDefinition, UpdateQuery, UpdateWriteOpResult, default as mongoose, Document, Model } from 'mongoose';
 export declare class C_Db extends Db {
 }
 export type T_Filter<T> = Filter<T>;
@@ -17,7 +17,7 @@ export declare class C_Collection<T extends Partial<C_Document>> extends Collect
 }
 export interface I_ExtendedModel<T extends Partial<C_Document>> extends Model<T>, PaginateModel<T>, AggregatePaginateModel<T> {
 }
-export type T_FilterQuery<T> = FilterQuery<T>;
+export type T_FilterQuery<T> = QueryFilter<T>;
 export type T_ProjectionType<T> = ProjectionType<T>;
 export type T_QueryOptions<T> = QueryOptions<T>;
 export type T_PaginateOptions = PaginateOptions;