@cyberskill/shared 3.12.0 → 3.14.0

package/dist/config/graphql-codegen/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './graphql-codegen.type.js';
+export * from './graphql-codegen.util.js';

package/dist/config/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './config.type.js';
+export * from './config.util.js';

package/dist/config/lint-staged/index.d.ts

@@ -1 +1,5 @@
-export {}
+declare const _default: {
+    '*.ts': () => string;
+    '*': string[];
+};
+export default _default;

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

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

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

@@ -1 +1,3 @@
-export {}
+export * from './vitest.e2e.js';
+export * from './vitest.unit.js';
+export * from './vitest.unit.setup.js';

package/dist/config/vitest/vitest.e2e.d.ts

@@ -1 +1,20 @@
-export {}
+import { UserConfig } from 'vite';
+/**
+ * Creates a Vitest configuration for end-to-end testing with browser automation.
+ * This function generates a Vitest configuration specifically designed for E2E testing
+ * using Playwright with multiple browser instances. It includes React support and
+ * browser automation capabilities for comprehensive end-to-end testing.
+ *
+ * The configuration includes:
+ * - React SWC plugin for fast React compilation
+ * - Browser automation with Playwright provider
+ * - Multiple browser instances (Chromium, Firefox, WebKit)
+ * - E2E test file pattern matching
+ * - Configurable options merging
+ *
+ * @param options - Additional Vite configuration options to merge with the E2E config.
+ * @returns A Vitest configuration object optimized for end-to-end testing with browser automation.
+ */
+export declare function vitestE2E(options: UserConfig): UserConfig;
+declare const _default: UserConfig;
+export default _default;

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

@@ -1,10 +1,10 @@
 import { deepMerge as e } from "../../util/object/object.util.js";
-import { defineConfig as t } from "../../node_modules/.pnpm/vitest@4.1.2_@types_node@25.5.0_jsdom@29.0.1_@noble_hashes@1.8.0__vite@8.0.3_@types_nod_0827261ede788764a5d99ac6bdf44bde/node_modules/vitest/dist/config.js";
-import n from "@vitejs/plugin-react";
+import t from "@vitejs/plugin-react";
+import { defineConfig as n } from "vitest/config";
 //#region src/config/vitest/vitest.e2e.ts
 function r(r) {
-	return t(e({
-		plugins: [n()],
+	return n(e({
+		plugins: [t()],
 		test: { include: ["**/*.test.e2e.?(c|m)[jt]s?(x)"] }
 	}, r));
 }

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

@@ -1 +1 @@
-{"version":3,"file":"vitest.e2e.js","names":[],"sources":["../../../src/config/vitest/vitest.e2e.ts"],"sourcesContent":["import type { UserConfig } from 'vite';\n\nimport react from '@vitejs/plugin-react';\nimport { defineConfig } from 'vitest/config';\n\nimport { deepMerge } from '../../util/object/index.js';\n\n/**\n * Creates a Vitest configuration for end-to-end testing with browser automation.\n * This function generates a Vitest configuration specifically designed for E2E testing\n * using Playwright with multiple browser instances. It includes React support and\n * browser automation capabilities for comprehensive end-to-end testing.\n *\n * The configuration includes:\n * - React SWC plugin for fast React compilation\n * - Browser automation with Playwright provider\n * - Multiple browser instances (Chromium, Firefox, WebKit)\n * - E2E test file pattern matching\n * - Configurable options merging\n *\n * @param options - Additional Vite configuration options to merge with the E2E config.\n * @returns A Vitest configuration object optimized for end-to-end testing with browser automation.\n */\nexport function vitestE2E(options: UserConfig) {\n    const config = {\n        plugins: [react()],\n        test: {\n            include: ['**/*.test.e2e.?(c|m)[jt]s?(x)'],\n        },\n    };\n\n    return defineConfig(deepMerge(config as any, options as any) as UserConfig);\n}\n\nexport default vitestE2E({});\n"],"mappings":";;;;AAuBA,SAAgB,EAAU,GAAqB;AAQ3C,QAAO,EAAa,EAPL;EACX,SAAS,CAAC,GAAO,CAAC;EAClB,MAAM,EACF,SAAS,CAAC,gCAAgC,EAC7C;EACJ,EAE4C,EAAe,CAAe;;AAG/E,IAAA,IAAe,EAAU,EAAE,CAAC"}
+{"version":3,"file":"vitest.e2e.js","names":[],"sources":["../../../src/config/vitest/vitest.e2e.ts"],"sourcesContent":["import type { UserConfig } from 'vite';\n\nimport react from '@vitejs/plugin-react';\nimport { defineConfig } from 'vitest/config';\n\nimport { deepMerge } from '../../util/object/index.js';\n\n/**\n * Creates a Vitest configuration for end-to-end testing with browser automation.\n * This function generates a Vitest configuration specifically designed for E2E testing\n * using Playwright with multiple browser instances. It includes React support and\n * browser automation capabilities for comprehensive end-to-end testing.\n *\n * The configuration includes:\n * - React SWC plugin for fast React compilation\n * - Browser automation with Playwright provider\n * - Multiple browser instances (Chromium, Firefox, WebKit)\n * - E2E test file pattern matching\n * - Configurable options merging\n *\n * @param options - Additional Vite configuration options to merge with the E2E config.\n * @returns A Vitest configuration object optimized for end-to-end testing with browser automation.\n */\nexport function vitestE2E(options: UserConfig) {\n    const config = {\n        plugins: [react()],\n        test: {\n            include: ['**/*.test.e2e.?(c|m)[jt]s?(x)'],\n        },\n    };\n\n    return defineConfig(deepMerge<UserConfig>(config, options));\n}\n\nexport default vitestE2E({});\n"],"mappings":";;;;AAuBA,SAAgB,EAAU,GAAqB;AAQ3C,QAAO,EAAa,EAPL;EACX,SAAS,CAAC,GAAO,CAAC;EAClB,MAAM,EACF,SAAS,CAAC,gCAAgC,EAC7C;EACJ,EAEiD,EAAQ,CAAC;;AAG/D,IAAA,IAAe,EAAU,EAAE,CAAC"}

package/dist/config/vitest/vitest.unit.d.ts

@@ -1 +1,22 @@
-export {}
+import { UserConfig } from 'vite';
+/**
+ * Creates a Vitest configuration for unit testing with React support.
+ * This function generates a Vitest configuration specifically designed for unit testing
+ * React components and JavaScript/TypeScript modules. It includes JSDOM environment
+ * for DOM simulation and comprehensive testing setup.
+ *
+ * The configuration includes:
+ * - React SWC plugin for fast React compilation
+ * - JSDOM environment for DOM simulation
+ * - Global test functions availability
+ * - VM threads pool for parallel test execution
+ * - Unit test file pattern matching
+ * - Setup files for testing library configuration
+ * - Configurable options merging
+ *
+ * @param options - Additional Vite configuration options to merge with the unit test config.
+ * @returns A Vitest configuration object optimized for unit testing with React and DOM support.
+ */
+export declare function vitestUnit(options: UserConfig): UserConfig;
+declare const _default: UserConfig;
+export default _default;

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

@@ -1,16 +1,16 @@
 import { deepMerge as e } from "../../util/object/object.util.js";
-import { defineConfig as t } from "../../node_modules/.pnpm/vitest@4.1.2_@types_node@25.5.0_jsdom@29.0.1_@noble_hashes@1.8.0__vite@8.0.3_@types_nod_0827261ede788764a5d99ac6bdf44bde/node_modules/vitest/dist/config.js";
-import n from "@vitejs/plugin-react";
+import t from "@vitejs/plugin-react";
+import { defineConfig as n } from "vitest/config";
 //#region src/config/vitest/vitest.unit.ts
 function r(r) {
-	return t(e({
-		plugins: [n()],
+	return n(e({
+		plugins: [t()],
 		test: {
 			globals: !0,
 			environment: "jsdom",
 			pool: "vmThreads",
 			include: ["**/*.test.unit.?(c|m)[jt]s?(x)"],
-			setupFiles: ["./vitest.unit.setup.ts"],
+			setupFiles: [`${import.meta.dirname}/vitest.unit.setup.js`],
 			coverage: {
 				provider: "istanbul",
 				reporter: ["text", "lcov"],

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

@@ -1 +1 @@
-{"version":3,"file":"vitest.unit.js","names":[],"sources":["../../../src/config/vitest/vitest.unit.ts"],"sourcesContent":["import type { UserConfig } from 'vite';\n\nimport react from '@vitejs/plugin-react';\nimport { defineConfig } from 'vitest/config';\n\nimport { deepMerge } from '#util/object/index.js';\n\n/**\n * Creates a Vitest configuration for unit testing with React support.\n * This function generates a Vitest configuration specifically designed for unit testing\n * React components and JavaScript/TypeScript modules. It includes JSDOM environment\n * for DOM simulation and comprehensive testing setup.\n *\n * The configuration includes:\n * - React SWC plugin for fast React compilation\n * - JSDOM environment for DOM simulation\n * - Global test functions availability\n * - VM threads pool for parallel test execution\n * - Unit test file pattern matching\n * - Setup files for testing library configuration\n * - Configurable options merging\n *\n * @param options - Additional Vite configuration options to merge with the unit test config.\n * @returns A Vitest configuration object optimized for unit testing with React and DOM support.\n */\nexport function vitestUnit(options: UserConfig) {\n    const config = {\n        plugins: [react()],\n        test: {\n            globals: true,\n            environment: 'jsdom',\n            pool: 'vmThreads',\n            include: ['**/*.test.unit.?(c|m)[jt]s?(x)'],\n            setupFiles: ['./vitest.unit.setup.ts'],\n            coverage: {\n                provider: 'istanbul',\n                reporter: ['text', 'lcov'],\n                reportsDirectory: './coverage',\n                thresholds: {\n                    statements: 80,\n                    branches: 80,\n                    functions: 80,\n                    lines: 80,\n                },\n            },\n        },\n    };\n\n    return defineConfig(deepMerge(config as any, options as any) as UserConfig);\n}\n\nexport default vitestUnit({});\n"],"mappings":";;;;AAyBA,SAAgB,EAAW,GAAqB;AAuB5C,QAAO,EAAa,EAtBL;EACX,SAAS,CAAC,GAAO,CAAC;EAClB,MAAM;GACF,SAAS;GACT,aAAa;GACb,MAAM;GACN,SAAS,CAAC,iCAAiC;GAC3C,YAAY,CAAC,yBAAyB;GACtC,UAAU;IACN,UAAU;IACV,UAAU,CAAC,QAAQ,OAAO;IAC1B,kBAAkB;IAClB,YAAY;KACR,YAAY;KACZ,UAAU;KACV,WAAW;KACX,OAAO;KACV;IACJ;GACJ;EACJ,EAE4C,EAAe,CAAe;;AAG/E,IAAA,IAAe,EAAW,EAAE,CAAC"}
+{"version":3,"file":"vitest.unit.js","names":[],"sources":["../../../src/config/vitest/vitest.unit.ts"],"sourcesContent":["import type { UserConfig } from 'vite';\n\nimport react from '@vitejs/plugin-react';\nimport { defineConfig } from 'vitest/config';\n\nimport { deepMerge } from '#util/object/index.js';\n\n/**\n * Creates a Vitest configuration for unit testing with React support.\n * This function generates a Vitest configuration specifically designed for unit testing\n * React components and JavaScript/TypeScript modules. It includes JSDOM environment\n * for DOM simulation and comprehensive testing setup.\n *\n * The configuration includes:\n * - React SWC plugin for fast React compilation\n * - JSDOM environment for DOM simulation\n * - Global test functions availability\n * - VM threads pool for parallel test execution\n * - Unit test file pattern matching\n * - Setup files for testing library configuration\n * - Configurable options merging\n *\n * @param options - Additional Vite configuration options to merge with the unit test config.\n * @returns A Vitest configuration object optimized for unit testing with React and DOM support.\n */\nexport function vitestUnit(options: UserConfig) {\n    const config = {\n        plugins: [react()],\n        test: {\n            globals: true,\n            environment: 'jsdom',\n            pool: 'vmThreads',\n            include: ['**/*.test.unit.?(c|m)[jt]s?(x)'],\n            setupFiles: [`${import.meta.dirname}/vitest.unit.setup.js`],\n            coverage: {\n                provider: 'istanbul',\n                reporter: ['text', 'lcov'],\n                reportsDirectory: './coverage',\n                thresholds: {\n                    statements: 80,\n                    branches: 80,\n                    functions: 80,\n                    lines: 80,\n                },\n            },\n        },\n    };\n\n    return defineConfig(deepMerge<UserConfig>(config, options));\n}\n\nexport default vitestUnit({});\n"],"mappings":";;;;AAyBA,SAAgB,EAAW,GAAqB;AAuB5C,QAAO,EAAa,EAtBL;EACX,SAAS,CAAC,GAAO,CAAC;EAClB,MAAM;GACF,SAAS;GACT,aAAa;GACb,MAAM;GACN,SAAS,CAAC,iCAAiC;GAC3C,YAAY,CAAC,GAAG,OAAO,KAAK,QAAQ,uBAAuB;GAC3D,UAAU;IACN,UAAU;IACV,UAAU,CAAC,QAAQ,OAAO;IAC1B,kBAAkB;IAClB,YAAY;KACR,YAAY;KACZ,UAAU;KACV,WAAW;KACX,OAAO;KACV;IACJ;GACJ;EACJ,EAEiD,EAAQ,CAAC;;AAG/D,IAAA,IAAe,EAAW,EAAE,CAAC"}

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

@@ -0,0 +1,10 @@
+import "@testing-library/jest-dom/vitest";
+import { cleanup as e } from "@testing-library/react";
+import { afterEach as t } from "vitest";
+//#region src/config/vitest/vitest.unit.setup.ts
+t(() => {
+	e();
+});
+//#endregion
+
+//# sourceMappingURL=vitest.unit.setup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.unit.setup.js","names":[],"sources":["../../../src/config/vitest/vitest.unit.setup.ts"],"sourcesContent":["import '@testing-library/jest-dom/vitest';\nimport { cleanup } from '@testing-library/react';\nimport { afterEach } from 'vitest';\n\nafterEach(() => {\n    cleanup();\n});\n"],"mappings":";;;;AAIA,QAAgB;AACZ,IAAS;EACX"}

package/dist/constant/index.d.ts

@@ -1 +1,5 @@
-export {}
+/**
+ * Re-exports all common constants for shared usage across the codebase.
+ */
+export * from './common.js';
+export * from './response-status.js';

package/dist/node/apollo-server/apollo-server.type.d.ts

@@ -0,0 +1,20 @@
+import { GraphQLSchema, ValidationRule } from 'graphql';
+import { Server } from 'node:http';
+export interface I_ApolloServerOptions {
+    server: Server;
+    schema: GraphQLSchema;
+    isDev?: boolean;
+    drainServer?: () => Promise<void>;
+    /**
+     * Maximum allowed depth for GraphQL queries.
+     * Limits deeply nested queries to prevent abuse and denial-of-service.
+     * Set to `0` or `false` to disable depth limiting entirely.
+     * @default 10
+     */
+    maxQueryDepth?: number | false;
+    /**
+     * Additional GraphQL validation rules applied to every incoming operation.
+     * These are appended after the built-in depth-limit rule (if enabled).
+     */
+    validationRules?: ValidationRule[];
+}

package/dist/{src/node → node}/apollo-server/apollo-server.util.d.ts

@@ -11,6 +11,7 @@ import { I_ApolloServerOptions } from './apollo-server.type.js';
  * - HTTP server draining plugin for graceful shutdowns
  * - Optional custom drain server hook for additional cleanup
  * - Development-specific settings (introspection and stack traces) when isDev is true
+ * - Query depth limiting (default: 10) to prevent deeply nested query abuse
  *
  * @param options - Configuration options for the Apollo Server including server instance, schema, and environment settings.
  * @returns A configured Apollo Server instance ready to be started.

package/dist/node/apollo-server/apollo-server.util.js

@@ -1,30 +1,54 @@
-import { log as e } from "../log/log.util.js";
-import t from "node:process";
-import { ApolloServer as n } from "@apollo/server";
-import { ApolloServerPluginDrainHttpServer as r } from "@apollo/server/plugin/drainHttpServer";
-import { ApolloServerPluginLandingPageLocalDefault as i, ApolloServerPluginLandingPageProductionDefault as a } from "@apollo/server/plugin/landingPage/default";
-import { expressMiddleware as o } from "@as-integrations/express5";
+import { E_Environment as e } from "../../typescript/common.type.js";
+import { log as t } from "../log/log.util.js";
+import { GraphQLError as n, Kind as r } from "graphql";
+import i from "node:process";
+import { ApolloServer as a } from "@apollo/server";
+import { ApolloServerPluginDrainHttpServer as o } from "@apollo/server/plugin/drainHttpServer";
+import { ApolloServerPluginLandingPageLocalDefault as s, ApolloServerPluginLandingPageProductionDefault as c } from "@apollo/server/plugin/landingPage/default";
+import { expressMiddleware as l } from "@as-integrations/express5";
 //#region src/node/apollo-server/apollo-server.util.ts
-function s(o) {
-	let s = o.isDev && t.env.NODE_ENV !== "production";
-	return new n({
-		schema: o.schema,
+var u = 10;
+function d(e) {
+	return function(t) {
+		return { Document: { enter(n) {
+			for (let i of n.definitions) (i.kind === r.OPERATION_DEFINITION || i.kind === r.FRAGMENT_DEFINITION) && f(i.selectionSet, 0, e, t);
+		} } };
+	};
+}
+function f(e, t, i, a) {
+	if (e) for (let o of e.selections) if (o.kind === r.FIELD) {
+		if (t >= i) {
+			a.reportError(new n(`Query depth of ${t + 1} exceeds the maximum allowed depth of ${i}.`));
+			return;
+		}
+		o.selectionSet && f(o.selectionSet, t + 1, i, a);
+	} else (o.kind === r.INLINE_FRAGMENT || o.kind === r.FRAGMENT_SPREAD) && f(o.selectionSet, t, i, a);
+}
+function p(n) {
+	let r = n.isDev && i.env.NODE_ENV !== e.PRODUCTION, l = m(n);
+	return new a({
+		schema: n.schema,
 		plugins: [
-			s ? i() : a(),
-			r({ httpServer: o.server }),
-			...o.drainServer ? [{ async serverWillStart() {
+			r ? s() : c(),
+			o({ httpServer: n.server }),
+			...n.drainServer ? [{ async serverWillStart() {
 				return { async drainServer() {
-					o.drainServer?.(), e.info("Apollo Server drainServer hook called");
+					n.drainServer?.(), t.info("Apollo Server drainServer hook called");
 				} };
 			} }] : []
 		],
-		...s && {
+		...l.length > 0 && { validationRules: l },
+		...r && {
 			introspection: !0,
 			includeStacktraceInErrorResponses: !0
 		}
 	});
 }
+function m(e) {
+	let t = [], n = e.maxQueryDepth;
+	return n !== !1 && n !== 0 && t.push(d(typeof n == "number" ? n : u)), e.validationRules && t.push(...e.validationRules), t;
+}
 //#endregion
-export { s as createApolloServer, o as expressMiddleware };
+export { p as createApolloServer, l as expressMiddleware };
 
 //# sourceMappingURL=apollo-server.util.js.map

package/dist/node/apollo-server/apollo-server.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"apollo-server.util.js","names":[],"sources":["../../../src/node/apollo-server/apollo-server.util.ts"],"sourcesContent":["import { ApolloServer } from '@apollo/server';\nimport { ApolloServerPluginDrainHttpServer } from '@apollo/server/plugin/drainHttpServer';\nimport {\n    ApolloServerPluginLandingPageLocalDefault,\n    ApolloServerPluginLandingPageProductionDefault,\n} from '@apollo/server/plugin/landingPage/default';\nimport { expressMiddleware } from '@as-integrations/express5';\nimport process from 'node:process';\n\nimport type { I_ApolloServerOptions } from './apollo-server.type.js';\n\nimport { log } from '../log/index.js';\n\n/**\n * Creates and configures an Apollo Server instance with appropriate plugins and settings.\n * This function sets up an Apollo Server with development or production landing pages,\n * HTTP server draining capabilities, and optional custom drain server hooks.\n *\n * The server is configured with:\n * - Development or production landing page based on the isDev flag\n * - HTTP server draining plugin for graceful shutdowns\n * - Optional custom drain server hook for additional cleanup\n * - Development-specific settings (introspection and stack traces) when isDev is true\n *\n * @param options - Configuration options for the Apollo Server including server instance, schema, and environment settings.\n * @returns A configured Apollo Server instance ready to be started.\n */\nexport function createApolloServer(options: I_ApolloServerOptions): ApolloServer {\n    // Defense-in-depth: never enable dev features when NODE_ENV is 'production'\n    const safeIsDev = options.isDev && process.env['NODE_ENV'] !== 'production';\n\n    return new ApolloServer({\n        schema: options.schema,\n        plugins: [\n            safeIsDev\n                ? ApolloServerPluginLandingPageLocalDefault()\n                : ApolloServerPluginLandingPageProductionDefault(),\n            ApolloServerPluginDrainHttpServer({ httpServer: options.server }),\n            ...(options.drainServer\n                ? [{\n                        async serverWillStart() {\n                            return {\n                                async drainServer() {\n                                    options.drainServer?.();\n                                    log.info('Apollo Server drainServer hook called');\n                                },\n                            };\n                        },\n                    }]\n                : []),\n        ],\n        ...(safeIsDev && {\n            introspection: true,\n            includeStacktraceInErrorResponses: true,\n        }),\n    });\n}\n\nexport { expressMiddleware };\n"],"mappings":";;;;;;;AA2BA,SAAgB,EAAmB,GAA8C;CAE7E,IAAM,IAAY,EAAQ,SAAS,EAAQ,IAAI,aAAgB;AAE/D,QAAO,IAAI,EAAa;EACpB,QAAQ,EAAQ;EAChB,SAAS;GACL,IACM,GAA2C,GAC3C,GAAgD;GACtD,EAAkC,EAAE,YAAY,EAAQ,QAAQ,CAAC;GACjE,GAAI,EAAQ,cACN,CAAC,EACK,MAAM,kBAAkB;AACpB,WAAO,EACH,MAAM,cAAc;AAEhB,KADA,EAAQ,eAAe,EACvB,EAAI,KAAK,wCAAwC;OAExD;MAER,CAAC,GACJ,EAAE;GACX;EACD,GAAI,KAAa;GACb,eAAe;GACf,mCAAmC;GACtC;EACJ,CAAC"}
+{"version":3,"file":"apollo-server.util.js","names":[],"sources":["../../../src/node/apollo-server/apollo-server.util.ts"],"sourcesContent":["import type { ASTVisitor, ValidationContext } from 'graphql';\n\nimport { ApolloServer } from '@apollo/server';\nimport { ApolloServerPluginDrainHttpServer } from '@apollo/server/plugin/drainHttpServer';\nimport {\n    ApolloServerPluginLandingPageLocalDefault,\n    ApolloServerPluginLandingPageProductionDefault,\n} from '@apollo/server/plugin/landingPage/default';\nimport { expressMiddleware } from '@as-integrations/express5';\nimport { GraphQLError, Kind } from 'graphql';\nimport process from 'node:process';\n\nimport { E_Environment } from '#typescript/index.js';\n\nimport type { I_ApolloServerOptions } from './apollo-server.type.js';\n\nimport { log } from '../log/index.js';\n\nconst DEFAULT_MAX_QUERY_DEPTH = 10;\n\n/**\n * Creates a GraphQL validation rule that rejects operations exceeding the\n * specified nesting depth. This prevents deeply nested queries from consuming\n * excessive server resources (query-depth DoS).\n *\n * @param maxDepth - Maximum allowed selection-set nesting depth.\n * @returns A GraphQL validation rule function.\n */\nfunction createDepthLimitRule(maxDepth: number) {\n    return function depthLimit(context: ValidationContext): ASTVisitor {\n        return {\n            Document: {\n                enter(node) {\n                    for (const definition of node.definitions) {\n                        if (definition.kind === Kind.OPERATION_DEFINITION || definition.kind === Kind.FRAGMENT_DEFINITION) {\n                            measureDepth(definition.selectionSet, 0, maxDepth, context);\n                        }\n                    }\n                },\n            },\n        };\n    };\n}\n\n/**\n * Recursively measures selection-set depth and reports an error when exceeded.\n */\nfunction measureDepth(\n    selectionSet: { selections: readonly { kind: string; selectionSet?: { selections: readonly unknown[] } }[] } | undefined,\n    currentDepth: number,\n    maxDepth: number,\n    context: ValidationContext,\n) {\n    if (!selectionSet) {\n        return;\n    }\n\n    for (const selection of selectionSet.selections) {\n        if (selection.kind === Kind.FIELD) {\n            if (currentDepth >= maxDepth) {\n                context.reportError(\n                    new GraphQLError(`Query depth of ${currentDepth + 1} exceeds the maximum allowed depth of ${maxDepth}.`),\n                );\n                return;\n            }\n\n            if (selection.selectionSet) {\n                measureDepth(\n                    selection.selectionSet as Parameters<typeof measureDepth>[0],\n                    currentDepth + 1,\n                    maxDepth,\n                    context,\n                );\n            }\n        }\n        else if (selection.kind === Kind.INLINE_FRAGMENT || selection.kind === Kind.FRAGMENT_SPREAD) {\n            measureDepth(\n                (selection as { selectionSet?: Parameters<typeof measureDepth>[0] }).selectionSet,\n                currentDepth,\n                maxDepth,\n                context,\n            );\n        }\n    }\n}\n\n/**\n * Creates and configures an Apollo Server instance with appropriate plugins and settings.\n * This function sets up an Apollo Server with development or production landing pages,\n * HTTP server draining capabilities, and optional custom drain server hooks.\n *\n * The server is configured with:\n * - Development or production landing page based on the isDev flag\n * - HTTP server draining plugin for graceful shutdowns\n * - Optional custom drain server hook for additional cleanup\n * - Development-specific settings (introspection and stack traces) when isDev is true\n * - Query depth limiting (default: 10) to prevent deeply nested query abuse\n *\n * @param options - Configuration options for the Apollo Server including server instance, schema, and environment settings.\n * @returns A configured Apollo Server instance ready to be started.\n */\nexport function createApolloServer(options: I_ApolloServerOptions): ApolloServer {\n    // Defense-in-depth: never enable dev features when NODE_ENV is 'production'\n    const safeIsDev = options.isDev && process.env['NODE_ENV'] !== E_Environment.PRODUCTION;\n\n    // Build validation rules: depth limit + user-provided rules\n    const validationRules = buildValidationRules(options);\n\n    return new ApolloServer({\n        schema: options.schema,\n        plugins: [\n            safeIsDev\n                ? ApolloServerPluginLandingPageLocalDefault()\n                : ApolloServerPluginLandingPageProductionDefault(),\n            ApolloServerPluginDrainHttpServer({ httpServer: options.server }),\n            ...(options.drainServer\n                ? [{\n                        async serverWillStart() {\n                            return {\n                                async drainServer() {\n                                    options.drainServer?.();\n                                    log.info('Apollo Server drainServer hook called');\n                                },\n                            };\n                        },\n                    }]\n                : []),\n        ],\n        ...(validationRules.length > 0 && { validationRules }),\n        ...(safeIsDev && {\n            introspection: true,\n            includeStacktraceInErrorResponses: true,\n        }),\n    });\n}\n\n/**\n * Assembles the final list of GraphQL validation rules, prepending the\n * built-in depth-limit rule (unless explicitly disabled) before any\n * consumer-supplied rules.\n */\nfunction buildValidationRules(options: I_ApolloServerOptions) {\n    const rules = [];\n    const maxDepth = options.maxQueryDepth;\n\n    if (maxDepth !== false && maxDepth !== 0) {\n        const depth = typeof maxDepth === 'number' ? maxDepth : DEFAULT_MAX_QUERY_DEPTH;\n        rules.push(createDepthLimitRule(depth));\n    }\n\n    if (options.validationRules) {\n        rules.push(...options.validationRules);\n    }\n\n    return rules;\n}\n\nexport { expressMiddleware };\n"],"mappings":";;;;;;;;;AAkBA,IAAM,IAA0B;AAUhC,SAAS,EAAqB,GAAkB;AAC5C,QAAO,SAAoB,GAAwC;AAC/D,SAAO,EACH,UAAU,EACN,MAAM,GAAM;AACR,QAAK,IAAM,KAAc,EAAK,YAC1B,EAAI,EAAW,SAAS,EAAK,wBAAwB,EAAW,SAAS,EAAK,wBAC1E,EAAa,EAAW,cAAc,GAAG,GAAU,EAAQ;KAI1E,EACJ;;;AAOT,SAAS,EACL,GACA,GACA,GACA,GACF;AACO,OAIL,MAAK,IAAM,KAAa,EAAa,WACjC,KAAI,EAAU,SAAS,EAAK,OAAO;AAC/B,MAAI,KAAgB,GAAU;AAC1B,KAAQ,YACJ,IAAI,EAAa,kBAAkB,IAAe,EAAE,wCAAwC,EAAS,GAAG,CAC3G;AACD;;AAGJ,EAAI,EAAU,gBACV,EACI,EAAU,cACV,IAAe,GACf,GACA,EACH;SAGA,EAAU,SAAS,EAAK,mBAAmB,EAAU,SAAS,EAAK,oBACxE,EACK,EAAoE,cACrE,GACA,GACA,EACH;;AAoBb,SAAgB,EAAmB,GAA8C;CAE7E,IAAM,IAAY,EAAQ,SAAS,EAAQ,IAAI,aAAgB,EAAc,YAGvE,IAAkB,EAAqB,EAAQ;AAErD,QAAO,IAAI,EAAa;EACpB,QAAQ,EAAQ;EAChB,SAAS;GACL,IACM,GAA2C,GAC3C,GAAgD;GACtD,EAAkC,EAAE,YAAY,EAAQ,QAAQ,CAAC;GACjE,GAAI,EAAQ,cACN,CAAC,EACK,MAAM,kBAAkB;AACpB,WAAO,EACH,MAAM,cAAc;AAEhB,KADA,EAAQ,eAAe,EACvB,EAAI,KAAK,wCAAwC;OAExD;MAER,CAAC,GACJ,EAAE;GACX;EACD,GAAI,EAAgB,SAAS,KAAK,EAAE,oBAAiB;EACrD,GAAI,KAAa;GACb,eAAe;GACf,mCAAmC;GACtC;EACJ,CAAC;;AAQN,SAAS,EAAqB,GAAgC;CAC1D,IAAM,IAAQ,EAAE,EACV,IAAW,EAAQ;AAWzB,QATI,MAAa,MAAS,MAAa,KAEnC,EAAM,KAAK,EADG,OAAO,KAAa,WAAW,IAAW,EAClB,CAAC,EAGvC,EAAQ,mBACR,EAAM,KAAK,GAAG,EAAQ,gBAAgB,EAGnC"}

package/dist/node/apollo-server/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './apollo-server.type.js';
+export * from './apollo-server.util.js';

package/dist/node/cli/index.d.ts

@@ -1 +1,2 @@
-export {}
+#!/usr/bin/env node
+export {};

package/dist/node/cli/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { addGitIgnoreEntry as e, pathExistsSync as t, readFileSync as n, removeSync as r, writeFileSync as i } from "../fs/fs.util.js";
-import { E_IssueType as a } from "../log/log.type.js";
-import { catchError as o, log as s } from "../log/log.util.js";
+import { E_IssueType as e } from "../log/log.type.js";
+import { catchError as t, log as n } from "../log/log.util.js";
+import { addGitIgnoreEntry as r, pathExistsSync as i, readFileSync as a, removeSync as o, writeFileSync as s } from "../fs/fs.util.js";
 import { getPackage as c, installDependencies as l } from "../package/package.util.js";
 import { clearAllErrorLists as u, getStoredErrorLists as d, resolveCommands as f, runCommand as p } from "../command/command.util.js";
 import { resolve as m } from "../path/path.util.js";
@@ -12,43 +12,43 @@ import T from "yargs/yargs";
 //#region src/node/cli/index.ts
 function E() {
 	try {
-		return JSON.parse(n(m(import.meta.dirname, "../../../package.json"), "utf-8")).version;
+		return JSON.parse(a(m(import.meta.dirname, "../../../package.json"), "utf-8")).version;
 	} catch {
 		return "1.0.0";
 	}
 }
 async function D() {
-	if (!t(y.TS_CONFIG)) {
-		s.warn("No TypeScript configuration found. Skipping type check.");
+	if (!i(y.TS_CONFIG)) {
+		n.warn("No TypeScript configuration found. Skipping type check.");
 		return;
 	}
 	await p("Performing TypeScript validation", await x.typescriptCheck());
 }
 async function O(e = !1) {
-	let t = e ? await x.eslintFix() : await x.eslintCheck(), n = e ? "Running ESLint with auto-fix" : "Running ESLint check";
+	let r = e ? await x.eslintFix() : await x.eslintCheck(), i = e ? "Running ESLint with auto-fix" : "Running ESLint check";
 	try {
-		await p(n, t, {
+		await p(i, r, {
 			timeout: 6e4,
 			throwOnError: !0
 		});
 	} catch (e) {
-		let r = e;
-		r.code === "ETIMEDOUT" || r.killed || r.signal === "SIGTERM" ? (s.warn("Lint check timed out. Retrying with debug mode enabled..."), C.env.DEBUG = "true", await p(`${n} (Debug Mode)`, t)) : o(e);
+		let a = e;
+		a.code === "ETIMEDOUT" || a.killed || a.signal === "SIGTERM" ? (n.warn("Lint check timed out. Retrying with debug mode enabled..."), C.env.DEBUG = "true", await p(`${i} (Debug Mode)`, r)) : t(e);
 	}
 }
 function k(e, t) {
-	t.length && s.printBoxedLog(e === "Errors" ? "✖ Errors" : "⚠ Warnings", t, e === "Errors" ? "red" : "yellow");
+	t.length && n.printBoxedLog(e === "Errors" ? "✖ Errors" : "⚠ Warnings", t, e === "Errors" ? "red" : "yellow");
 }
 async function A() {
 	await new Promise((e) => setImmediate(e));
-	let e = await d() || [], t = e.filter((e) => e.type === a.Error), n = e.filter((e) => e.type === a.Warning);
-	!t.length && !n.length ? s.printBoxedLog("✔ NO ISSUES FOUND", [], "green") : (k("Warnings", n), k("Errors", t), t.length > 0 && C.exit(1));
+	let t = await d() || [], r = t.filter((t) => t.type === e.Error), i = t.filter((t) => t.type === e.Warning);
+	!r.length && !i.length ? n.printBoxedLog("✔ NO ISSUES FOUND", [], "green") : (k("Warnings", i), k("Errors", r), r.length > 0 && C.exit(1));
 }
 async function j() {
 	await u();
 	let e = await c({ name: _ });
 	if (!e.success) {
-		s.error("Failed to retrieve package information. Aborting lint-staged.");
+		n.error("Failed to retrieve package information. Aborting lint-staged.");
 		return;
 	}
 	e.result.isCurrentProject && await p(`Building package: ${_}`, await x.build()), await p("Executing lint-staged", await x.lintStaged()), await A();
@@ -66,9 +66,9 @@ async function F() {
 	await u(), await p("Validating commit message", await x.commitLint()), await A();
 }
 async function I() {
-	await p("Configuring Git hooks", await x.configureGitHook()), r(y.GIT_HOOK);
-	let t = await f(S);
-	i(y.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(t, null, 4)), e(y.GIT_IGNORE, b), await p("Setting up simple-git-hooks", await x.simpleGitHooks());
+	await p("Configuring Git hooks", await x.configureGitHook()), o(y.GIT_HOOK);
+	let e = await f(S);
+	s(y.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(e, null, 4)), r(y.GIT_IGNORE, b), await p("Setting up simple-git-hooks", await x.simpleGitHooks());
 }
 async function L() {
 	try {
@@ -76,31 +76,29 @@ async function L() {
 	} catch {
 		await p(`Installing ${h} globally`, `pnpm i -g ${h}`);
 	}
-	t(y.DOT_AGENT) ? await p("Updating AI agent", "echo y | ag-kit update") : await p("Initializing AI agent", "ag-kit init"), e(y.GIT_EXCLUDE, v);
+	i(y.DOT_AGENT) ? await p("Updating AI agent", "echo y | ag-kit update") : await p("Initializing AI agent", "ag-kit init"), r(y.GIT_EXCLUDE, v);
 }
 async function R() {
 	await l(), await I();
 }
 async function z() {
-	r(y.NODE_MODULES, y.PNPM_LOCK_YAML, y.SIMPLE_GIT_HOOKS_JSON), await p("Pruning pnpm store", await x.pnpmPruneStore()), await p("Clearing pnpm cache", await x.pnpmCleanCache()), await l(), await I();
+	o(y.NODE_MODULES, y.PNPM_LOCK_YAML, y.SIMPLE_GIT_HOOKS_JSON), await p("Pruning pnpm store", await x.pnpmPruneStore()), await p("Clearing pnpm cache", await x.pnpmCleanCache()), await l(), await I();
 }
 async function B() {
 	await p("Inspecting project dependencies", await x.nodeModulesInspect());
 }
 async function V() {
 	try {
-		let e = await c({ name: _ });
-		await p("Running unit tests", e.success && e.result.isCurrentProject ? "pnpm exec vitest run" : await x.testUnit(), { throwOnError: !0 });
+		await p("Running unit tests", await x.testUnit(), { throwOnError: !0 });
 	} catch (e) {
-		s.error(e), C.exit(1);
+		n.error(e), C.exit(1);
 	}
 }
 async function H() {
 	try {
-		let e = await c({ name: _ });
-		await p("Running end-to-end tests", e.success && e.result.isCurrentProject ? "pnpm exec vitest run --passWithNoTests --config src/config/vitest/vitest.e2e.ts" : await x.testE2e(), { throwOnError: !0 });
+		await p("Running end-to-end tests", await x.testE2e(), { throwOnError: !0 });
 	} catch (e) {
-		s.error(e), C.exit(1);
+		n.error(e), C.exit(1);
 	}
 }
 async function U(e) {
@@ -125,13 +123,13 @@ async function q() {
 			type: "string"
 		}), async (e) => {
 			if (!e.name) {
-				s.error("Migration name is required.");
+				n.error("Migration name is required.");
 				return;
 			}
 			await U(e.name);
-		}).command("mongo:migrate:up", "Apply all MongoDB migrations", W).command("mongo:migrate:down", "Rollback last MongoDB migration", G).command("storybook:dev", "Start Storybook development server", K).command("storybook:build", "Build Storybook for production", q).demandCommand(1, "Please specify a valid command.").strict().help().alias("h", "help").alias("v", "version").version(E()).epilog("💡 Tip: Use \"--help\" with any command to see options\n").parse();
+		}).command("mongo:migrate:up", "Apply all MongoDB migrations", W).command("mongo:migrate:down", "Rollback last MongoDB migration", G).command("storybook:dev", "Start Storybook development server", K).command("storybook:build", "Build Storybook for production", q).example("$0 lint:fix", "Automatically block and fix linter errors").example("$0 test:unit", "Run the unit test suite").example("$0 mongo:migrate:create init_db", "Create a new migration file named \"init_db\"").demandCommand(1, "Please specify a valid command.").strict().help().alias("h", "help").alias("v", "version").version(E()).epilog("💡 Tip: Use \"--help\" with any command to see options\n").parse();
 	} catch (e) {
-		o(e), C.exit(1);
+		t(e), C.exit(1);
 	}
 })();
 //#endregion

package/dist/node/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/node/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport process from 'node:process';\nimport { hideBin } from 'yargs/helpers';\nimport yargs from 'yargs/yargs';\n\nimport type { I_IssueEntry } from '../log/index.js';\n\nimport { clearAllErrorLists, getStoredErrorLists, resolveCommands, runCommand } from '../command/index.js';\nimport { addGitIgnoreEntry, pathExistsSync, readFileSync, removeSync, writeFileSync } from '../fs/index.js';\nimport { catchError, E_IssueType, log } from '../log/index.js';\nimport { getPackage, installDependencies } from '../package/index.js';\nimport { AG_KIT_PACKAGE_NAME, command, createGitHooksConfig, CYBERSKILL_CLI, CYBERSKILL_PACKAGE_NAME, DOT_AGENT, PATH, resolve, SIMPLE_GIT_HOOK_JSON } from '../path/index.js';\n\n/**\n * Retrieves the version from the package.json file.\n * This function reads the package.json file and extracts the version number.\n * If the file cannot be read or parsed, it returns a default version of '1.0.0'.\n *\n * @returns The version string from package.json or '1.0.0' as fallback.\n */\nfunction getVersion(): string {\n    try {\n        const pkg = JSON.parse(\n            readFileSync(resolve(import.meta.dirname, '../../../package.json'), 'utf-8'),\n        );\n        return pkg.version;\n    }\n    catch {\n        return '1.0.0';\n    }\n}\n\n/**\n * Performs TypeScript validation if a TypeScript configuration file exists.\n * Uses `--incremental` mode to cache results — the first run may be slow\n * (especially with large generated files), but subsequent runs are near-instant.\n *\n * @returns A promise that resolves when the TypeScript validation is complete.\n */\nasync function checkTypescript() {\n    if (!pathExistsSync(PATH.TS_CONFIG)) {\n        log.warn('No TypeScript configuration found. Skipping type check.');\n        return;\n    }\n\n    await runCommand('Performing TypeScript validation', await command.typescriptCheck());\n}\n\n/**\n * Performs ESLint checking with optional auto-fix functionality.\n * This function runs ESLint checks on the codebase and optionally applies\n * automatic fixes to resolve linting issues.\n *\n * @param fix - Whether to apply automatic fixes to linting issues (default: false).\n * @returns A promise that resolves when the ESLint check is complete.\n */\nasync function checkEslint(fix = false) {\n    const commandToRun = fix ? await command.eslintFix() : await command.eslintCheck();\n    const label = fix ? 'Running ESLint with auto-fix' : 'Running ESLint check';\n\n    try {\n        await runCommand(label, commandToRun, { timeout: 60000, throwOnError: true });\n    }\n    catch (error: unknown) {\n        const errObj = error as { code?: string; killed?: boolean; signal?: string };\n        if (errObj.code === 'ETIMEDOUT' || errObj.killed || errObj.signal === 'SIGTERM') {\n            log.warn('Lint check timed out. Retrying with debug mode enabled...');\n            process.env['DEBUG'] = 'true';\n            await runCommand(`${label} (Debug Mode)`, commandToRun);\n        }\n        else {\n            catchError(error);\n        }\n    }\n}\n\n/**\n * Prints a formatted list of issues (errors or warnings) to the console.\n * This function displays issues in a boxed format with appropriate color coding\n * based on the issue type. It only displays issues if the list is not empty.\n *\n * @param type - The type of issues to display ('Errors' or 'Warnings').\n * @param list - An array of issue entries to display.\n */\nfunction printIssues(type: 'Errors' | 'Warnings', list: I_IssueEntry[]) {\n    if (!list.length) {\n        return;\n    }\n\n    const color = type === 'Errors' ? 'red' : 'yellow';\n    log.printBoxedLog(type === 'Errors' ? '✖ Errors' : '⚠ Warnings', list, color);\n}\n\n/**\n * Displays the final check results after all validation processes.\n * This function retrieves stored error lists and displays them in a formatted manner.\n * If no errors or warnings are found, it displays a success message. If errors are found,\n * it exits the process with code 1 to indicate failure.\n *\n * @returns A promise that resolves when the results are displayed.\n */\nasync function showCheckResult() {\n    // Allow pending I/O (runCommand writes) to flush before reading results\n    await new Promise(resolve => setImmediate(resolve));\n\n    const allResults = (await getStoredErrorLists()) || [];\n    const errors = allResults.filter(e => e.type === E_IssueType.Error);\n    const warnings = allResults.filter(e => e.type === E_IssueType.Warning);\n\n    if (!errors.length && !warnings.length) {\n        log.printBoxedLog('✔ NO ISSUES FOUND', [], 'green');\n    }\n    else {\n        printIssues('Warnings', warnings);\n        printIssues('Errors', errors);\n\n        if (errors.length > 0) {\n            process.exit(1);\n        }\n    }\n}\n\n/**\n * Executes lint-staged to check only staged files.\n * This function runs lint-staged which executes linting tools only on files\n * that are staged for commit. It includes building the package if it's the current project\n * and displays the results after completion.\n *\n * @returns A promise that resolves when lint-staged execution is complete.\n */\nasync function lintStaged() {\n    await clearAllErrorLists();\n    const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n\n    if (!packageData.success) {\n        log.error('Failed to retrieve package information. Aborting lint-staged.');\n        return;\n    }\n\n    if (packageData.result.isCurrentProject) {\n        await runCommand(`Building package: ${CYBERSKILL_PACKAGE_NAME}`, await command.build());\n    }\n\n    await runCommand('Executing lint-staged', await command.lintStaged());\n    await showCheckResult();\n}\n\n/**\n * Inspects the ESLint configuration to show active rules and settings.\n * This function runs ESLint inspection to display the current configuration,\n * including which rules are active and their settings.\n *\n * @returns A promise that resolves when the ESLint inspection is complete.\n */\nasync function inspectLint() {\n    await runCommand('Inspecting ESLint configuration', await command.eslintInspect());\n}\n\n/**\n * Performs comprehensive linting checks including TypeScript and ESLint.\n * This function runs both TypeScript validation and ESLint checks in parallel,\n * then displays the combined results.\n *\n * @returns A promise that resolves when all linting checks are complete.\n */\nasync function lintCheck() {\n    await clearAllErrorLists();\n    await checkTypescript();\n    await checkEslint();\n    await showCheckResult();\n}\n\n/**\n * Performs comprehensive linting checks with automatic fixes.\n * This function runs both TypeScript validation and ESLint checks with auto-fix\n * in parallel, then displays the combined results.\n *\n * @returns A promise that resolves when all linting checks with fixes are complete.\n */\nasync function lintFix() {\n    await clearAllErrorLists();\n    await checkTypescript();\n    await checkEslint(true);\n    await showCheckResult();\n}\n\n/**\n * Validates commit message format using commitlint.\n * This function runs commitlint to check if the current commit message\n * follows the conventional commit format and displays the results.\n *\n * @returns A promise that resolves when commit message validation is complete.\n */\nasync function commitLint() {\n    await clearAllErrorLists();\n    await runCommand('Validating commit message', await command.commitLint());\n    await showCheckResult();\n}\n\n/**\n * Sets up Git hooks for automated code quality checks.\n * This function configures Git hooks using simple-git-hooks, creates the necessary\n * configuration files, and updates .gitignore to exclude hook configuration files.\n * It also sets up the hooks to run linting and commit validation automatically.\n *\n * @returns A promise that resolves when Git hook setup is complete.\n */\nasync function gitHookSetup() {\n    await runCommand('Configuring Git hooks', await command.configureGitHook());\n\n    removeSync(PATH.GIT_HOOK);\n\n    const hooks = await resolveCommands(createGitHooksConfig);\n\n    writeFileSync(PATH.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(hooks, null, 4));\n\n    addGitIgnoreEntry(PATH.GIT_IGNORE, SIMPLE_GIT_HOOK_JSON);\n\n    await runCommand('Setting up simple-git-hooks', await command.simpleGitHooks());\n}\n\n/**\n * Sets up the AI agent environment.\n * This function ensures the ag-kit package is installed globally, initializes\n * or updates the AI agent configuration, and adds the agent directory\n * to .gitignore to exclude it from version control.\n *\n * @returns A promise that resolves when the AI agent setup is complete.\n */\nasync function aiSetup() {\n    try {\n        await runCommand(`Checking for ${AG_KIT_PACKAGE_NAME}`, `pnpm list -g ${AG_KIT_PACKAGE_NAME}`);\n    }\n    catch {\n        await runCommand(`Installing ${AG_KIT_PACKAGE_NAME} globally`, `pnpm i -g ${AG_KIT_PACKAGE_NAME}`);\n    }\n\n    if (pathExistsSync(PATH.DOT_AGENT)) {\n        await runCommand('Updating AI agent', 'echo y | ag-kit update');\n    }\n    else {\n        await runCommand('Initializing AI agent', 'ag-kit init');\n    }\n\n    addGitIgnoreEntry(PATH.GIT_EXCLUDE, DOT_AGENT);\n}\n\n/**\n * Initializes the project with dependencies and Git hooks.\n * This function installs project dependencies and sets up Git hooks for\n * automated code quality checks. It's typically run when setting up a new project.\n *\n * @returns A promise that resolves when project initialization is complete.\n */\nasync function ready() {\n    await installDependencies();\n    await gitHookSetup();\n}\n\n/**\n * Resets the project by removing dependencies and reinstalling them.\n * This function removes node_modules and lock files, cleans the package manager cache,\n * reinstalls dependencies, and sets up Git hooks. It's useful for resolving\n * dependency-related issues.\n *\n * @returns A promise that resolves when project reset is complete.\n */\nasync function reset() {\n    removeSync(PATH.NODE_MODULES, PATH.PNPM_LOCK_YAML, PATH.SIMPLE_GIT_HOOKS_JSON);\n    await runCommand('Pruning pnpm store', await command.pnpmPruneStore());\n    await runCommand('Clearing pnpm cache', await command.pnpmCleanCache());\n    await installDependencies();\n    await gitHookSetup();\n    // await aiSetup();\n}\n\n/**\n * Inspects project dependencies to analyze their status.\n * This function runs dependency inspection to check for outdated packages,\n * security vulnerabilities, and other dependency-related issues.\n *\n * @returns A promise that resolves when dependency inspection is complete.\n */\nasync function inspect() {\n    await runCommand('Inspecting project dependencies', await command.nodeModulesInspect());\n}\n\n/**\n * Runs the unit test suite.\n * This function executes unit tests using the configured test runner\n * and displays the test results.\n *\n * @returns A promise that resolves when unit tests are complete.\n */\nasync function testUnit() {\n    try {\n        const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n        const cmd = packageData.success && packageData.result.isCurrentProject\n            ? `pnpm exec vitest run`\n            : await command.testUnit();\n\n        await runCommand('Running unit tests', cmd, { throwOnError: true });\n    }\n    catch (error) {\n        log.error(error);\n        process.exit(1);\n    }\n}\n\n/**\n * Runs the end-to-end test suite.\n * This function executes end-to-end tests using the configured test runner\n * and displays the test results.\n *\n * @returns A promise that resolves when end-to-end tests are complete.\n */\nasync function testE2E() {\n    try {\n        const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n        const cmd = packageData.success && packageData.result.isCurrentProject\n            ? `pnpm exec vitest run --passWithNoTests --config src/config/vitest/vitest.e2e.ts`\n            : await command.testE2e();\n\n        await runCommand('Running end-to-end tests', cmd, { throwOnError: true });\n    }\n    catch (error) {\n        log.error(error);\n        process.exit(1);\n    }\n}\n\n/**\n * Creates a new MongoDB migration file.\n * This function creates a new migration file with the specified name\n * for database schema changes.\n *\n * @param migrationName - The name for the new migration file.\n * @returns A promise that resolves when the migration file is created.\n */\nasync function mongoMigrateCreate(migrationName: string) {\n    await runCommand('Creating MongoDB migration', await command.mongoMigrateCreate(migrationName));\n}\n\n/**\n * Applies all pending MongoDB migrations.\n * This function runs all pending database migrations to update the database schema\n * to the latest version.\n *\n * @returns A promise that resolves when all migrations are applied.\n */\nasync function mongoMigrateUp() {\n    await runCommand('Running MongoDB migrations', await command.mongoMigrateUp());\n}\n\n/**\n * Rolls back the last applied MongoDB migration.\n * This function reverts the most recent database migration, undoing\n * the last schema change.\n *\n * @returns A promise that resolves when the migration is rolled back.\n */\nasync function mongoMigrateDown() {\n    await runCommand('Rolling back MongoDB migration', await command.mongoMigrateDown());\n}\n\n/**\n * Starts the Storybook development server.\n * This function runs Storybook in development mode, allowing you to\n * view and interact with your component stories in a browser.\n *\n * @returns A promise that resolves when the Storybook dev server is started.\n */\nasync function storybookDev() {\n    await runCommand('Starting Storybook development server', await command.storybookDev());\n}\n\n/**\n * Builds Storybook for production deployment.\n * This function creates a static build of Storybook that can be\n * deployed to a web server or hosting service.\n *\n * @returns A promise that resolves when the Storybook build is complete.\n */\nasync function storybookBuild() {\n    await runCommand('Building Storybook', await command.storybookBuild());\n}\n\n(async () => {\n    try {\n        await yargs(hideBin(process.argv))\n            .scriptName(CYBERSKILL_CLI)\n            .usage('$0 <command> [options]')\n            .command('ai:setup', 'Setup AI agent environment', aiSetup)\n            .command('lint', 'Check code for linting issues', lintCheck)\n            .command('lint:fix', 'Fix linting issues automatically', lintFix)\n            .command('lint:inspect', 'View active ESLint configuration', inspectLint)\n            .command('lint-staged', 'Run lint checks on staged files', lintStaged)\n            .command('commitlint', 'Validate commit message format', commitLint)\n            .command('ready', 'Initialize project and dependencies', ready)\n            .command('reset', 'Reset the project and reinstall dependencies', reset)\n            .command('inspect', 'Analyze installed project dependencies', inspect)\n            .command('test:unit', 'Run unit test suite', testUnit)\n            .command('test:e2e', 'Run end-to-end test suite', testE2E)\n            .command('mongo:migrate:create <name>', 'Create a MongoDB migration', y =>\n                y.positional('name', {\n                    describe: 'Migration name',\n                    type: 'string',\n                }), async (argv) => {\n                if (!argv.name) {\n                    log.error('Migration name is required.');\n\n                    return;\n                }\n\n                await mongoMigrateCreate(argv.name);\n            })\n            .command('mongo:migrate:up', 'Apply all MongoDB migrations', mongoMigrateUp)\n            .command('mongo:migrate:down', 'Rollback last MongoDB migration', mongoMigrateDown)\n            .command('storybook:dev', 'Start Storybook development server', storybookDev)\n            .command('storybook:build', 'Build Storybook for production', storybookBuild)\n            .demandCommand(1, 'Please specify a valid command.')\n            .strict()\n            .help()\n            .alias('h', 'help')\n            .alias('v', 'version')\n            .version(getVersion())\n            .epilog('💡 Tip: Use \"--help\" with any command to see options\\n')\n            .parse();\n    }\n    catch (error) {\n        catchError(error);\n        process.exit(1);\n    }\n})();\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/node/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport process from 'node:process';\nimport { hideBin } from 'yargs/helpers';\nimport yargs from 'yargs/yargs';\n\nimport type { I_IssueEntry } from '../log/index.js';\n\nimport { clearAllErrorLists, getStoredErrorLists, resolveCommands, runCommand } from '../command/index.js';\nimport { addGitIgnoreEntry, pathExistsSync, readFileSync, removeSync, writeFileSync } from '../fs/index.js';\nimport { catchError, E_IssueType, log } from '../log/index.js';\nimport { getPackage, installDependencies } from '../package/index.js';\nimport { AG_KIT_PACKAGE_NAME, command, createGitHooksConfig, CYBERSKILL_CLI, CYBERSKILL_PACKAGE_NAME, DOT_AGENT, PATH, resolve, SIMPLE_GIT_HOOK_JSON } from '../path/index.js';\n\n/**\n * Retrieves the version from the package.json file.\n * This function reads the package.json file and extracts the version number.\n * If the file cannot be read or parsed, it returns a default version of '1.0.0'.\n *\n * @returns The version string from package.json or '1.0.0' as fallback.\n */\nfunction getVersion(): string {\n    try {\n        const pkg = JSON.parse(\n            readFileSync(resolve(import.meta.dirname, '../../../package.json'), 'utf-8'),\n        );\n        return pkg.version;\n    }\n    catch {\n        /* Intentionally empty — fallback to default version when package.json is unreadable */\n        return '1.0.0';\n    }\n}\n\n/**\n * Performs TypeScript validation if a TypeScript configuration file exists.\n * Uses `--incremental` mode to cache results — the first run may be slow\n * (especially with large generated files), but subsequent runs are near-instant.\n *\n * @returns A promise that resolves when the TypeScript validation is complete.\n */\nasync function checkTypescript() {\n    if (!pathExistsSync(PATH.TS_CONFIG)) {\n        log.warn('No TypeScript configuration found. Skipping type check.');\n        return;\n    }\n\n    await runCommand('Performing TypeScript validation', await command.typescriptCheck());\n}\n\n/**\n * Performs ESLint checking with optional auto-fix functionality.\n * This function runs ESLint checks on the codebase and optionally applies\n * automatic fixes to resolve linting issues.\n *\n * @param fix - Whether to apply automatic fixes to linting issues (default: false).\n * @returns A promise that resolves when the ESLint check is complete.\n */\nasync function checkEslint(fix = false) {\n    const commandToRun = fix ? await command.eslintFix() : await command.eslintCheck();\n    const label = fix ? 'Running ESLint with auto-fix' : 'Running ESLint check';\n\n    try {\n        await runCommand(label, commandToRun, { timeout: 60000, throwOnError: true });\n    }\n    catch (error: unknown) {\n        const errObj = error as { code?: string; killed?: boolean; signal?: string };\n        if (errObj.code === 'ETIMEDOUT' || errObj.killed || errObj.signal === 'SIGTERM') {\n            log.warn('Lint check timed out. Retrying with debug mode enabled...');\n            process.env['DEBUG'] = 'true';\n            await runCommand(`${label} (Debug Mode)`, commandToRun);\n        }\n        else {\n            catchError(error);\n        }\n    }\n}\n\n/**\n * Prints a formatted list of issues (errors or warnings) to the console.\n * This function displays issues in a boxed format with appropriate color coding\n * based on the issue type. It only displays issues if the list is not empty.\n *\n * @param type - The type of issues to display ('Errors' or 'Warnings').\n * @param list - An array of issue entries to display.\n */\nfunction printIssues(type: 'Errors' | 'Warnings', list: I_IssueEntry[]) {\n    if (!list.length) {\n        return;\n    }\n\n    const color = type === 'Errors' ? 'red' : 'yellow';\n    log.printBoxedLog(type === 'Errors' ? '✖ Errors' : '⚠ Warnings', list, color);\n}\n\n/**\n * Displays the final check results after all validation processes.\n * This function retrieves stored error lists and displays them in a formatted manner.\n * If no errors or warnings are found, it displays a success message. If errors are found,\n * it exits the process with code 1 to indicate failure.\n *\n * @returns A promise that resolves when the results are displayed.\n */\nasync function showCheckResult() {\n    // Allow pending I/O (runCommand writes) to flush before reading results\n    await new Promise(resolve => setImmediate(resolve));\n\n    const allResults = (await getStoredErrorLists()) || [];\n    const errors = allResults.filter(e => e.type === E_IssueType.Error);\n    const warnings = allResults.filter(e => e.type === E_IssueType.Warning);\n\n    if (!errors.length && !warnings.length) {\n        log.printBoxedLog('✔ NO ISSUES FOUND', [], 'green');\n    }\n    else {\n        printIssues('Warnings', warnings);\n        printIssues('Errors', errors);\n\n        if (errors.length > 0) {\n            process.exit(1);\n        }\n    }\n}\n\n/**\n * Executes lint-staged to check only staged files.\n * This function runs lint-staged which executes linting tools only on files\n * that are staged for commit. It includes building the package if it's the current project\n * and displays the results after completion.\n *\n * @returns A promise that resolves when lint-staged execution is complete.\n */\nasync function lintStaged() {\n    await clearAllErrorLists();\n    const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n\n    if (!packageData.success) {\n        log.error('Failed to retrieve package information. Aborting lint-staged.');\n        return;\n    }\n\n    if (packageData.result.isCurrentProject) {\n        await runCommand(`Building package: ${CYBERSKILL_PACKAGE_NAME}`, await command.build());\n    }\n\n    await runCommand('Executing lint-staged', await command.lintStaged());\n    await showCheckResult();\n}\n\n/**\n * Inspects the ESLint configuration to show active rules and settings.\n * This function runs ESLint inspection to display the current configuration,\n * including which rules are active and their settings.\n *\n * @returns A promise that resolves when the ESLint inspection is complete.\n */\nasync function inspectLint() {\n    await runCommand('Inspecting ESLint configuration', await command.eslintInspect());\n}\n\n/**\n * Performs comprehensive linting checks including TypeScript and ESLint.\n * This function runs both TypeScript validation and ESLint checks in parallel,\n * then displays the combined results.\n *\n * @returns A promise that resolves when all linting checks are complete.\n */\nasync function lintCheck() {\n    await clearAllErrorLists();\n    await checkTypescript();\n    await checkEslint();\n    await showCheckResult();\n}\n\n/**\n * Performs comprehensive linting checks with automatic fixes.\n * This function runs both TypeScript validation and ESLint checks with auto-fix\n * in parallel, then displays the combined results.\n *\n * @returns A promise that resolves when all linting checks with fixes are complete.\n */\nasync function lintFix() {\n    await clearAllErrorLists();\n    await checkTypescript();\n    await checkEslint(true);\n    await showCheckResult();\n}\n\n/**\n * Validates commit message format using commitlint.\n * This function runs commitlint to check if the current commit message\n * follows the conventional commit format and displays the results.\n *\n * @returns A promise that resolves when commit message validation is complete.\n */\nasync function commitLint() {\n    await clearAllErrorLists();\n    await runCommand('Validating commit message', await command.commitLint());\n    await showCheckResult();\n}\n\n/**\n * Sets up Git hooks for automated code quality checks.\n * This function configures Git hooks using simple-git-hooks, creates the necessary\n * configuration files, and updates .gitignore to exclude hook configuration files.\n * It also sets up the hooks to run linting and commit validation automatically.\n *\n * @returns A promise that resolves when Git hook setup is complete.\n */\nasync function gitHookSetup() {\n    await runCommand('Configuring Git hooks', await command.configureGitHook());\n\n    removeSync(PATH.GIT_HOOK);\n\n    const hooks = await resolveCommands(createGitHooksConfig);\n\n    writeFileSync(PATH.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(hooks, null, 4));\n\n    addGitIgnoreEntry(PATH.GIT_IGNORE, SIMPLE_GIT_HOOK_JSON);\n\n    await runCommand('Setting up simple-git-hooks', await command.simpleGitHooks());\n}\n\n/**\n * Sets up the AI agent environment.\n * This function ensures the ag-kit package is installed globally, initializes\n * or updates the AI agent configuration, and adds the agent directory\n * to .gitignore to exclude it from version control.\n *\n * @returns A promise that resolves when the AI agent setup is complete.\n */\nasync function aiSetup() {\n    try {\n        await runCommand(`Checking for ${AG_KIT_PACKAGE_NAME}`, `pnpm list -g ${AG_KIT_PACKAGE_NAME}`);\n    }\n    catch {\n        /* Package not found globally — install it */\n        await runCommand(`Installing ${AG_KIT_PACKAGE_NAME} globally`, `pnpm i -g ${AG_KIT_PACKAGE_NAME}`);\n    }\n\n    if (pathExistsSync(PATH.DOT_AGENT)) {\n        await runCommand('Updating AI agent', 'echo y | ag-kit update');\n    }\n    else {\n        await runCommand('Initializing AI agent', 'ag-kit init');\n    }\n\n    addGitIgnoreEntry(PATH.GIT_EXCLUDE, DOT_AGENT);\n}\n\n/**\n * Initializes the project with dependencies and Git hooks.\n * This function installs project dependencies and sets up Git hooks for\n * automated code quality checks. It's typically run when setting up a new project.\n *\n * @returns A promise that resolves when project initialization is complete.\n */\nasync function ready() {\n    await installDependencies();\n    await gitHookSetup();\n}\n\n/**\n * Resets the project by removing dependencies and reinstalling them.\n * This function removes node_modules and lock files, cleans the package manager cache,\n * reinstalls dependencies, and sets up Git hooks. It's useful for resolving\n * dependency-related issues.\n *\n * @returns A promise that resolves when project reset is complete.\n */\nasync function reset() {\n    removeSync(PATH.NODE_MODULES, PATH.PNPM_LOCK_YAML, PATH.SIMPLE_GIT_HOOKS_JSON);\n    await runCommand('Pruning pnpm store', await command.pnpmPruneStore());\n    await runCommand('Clearing pnpm cache', await command.pnpmCleanCache());\n    await installDependencies();\n    await gitHookSetup();\n    // await aiSetup();\n}\n\n/**\n * Inspects project dependencies to analyze their status.\n * This function runs dependency inspection to check for outdated packages,\n * security vulnerabilities, and other dependency-related issues.\n *\n * @returns A promise that resolves when dependency inspection is complete.\n */\nasync function inspect() {\n    await runCommand('Inspecting project dependencies', await command.nodeModulesInspect());\n}\n\n/**\n * Runs the unit test suite.\n * This function executes unit tests using the configured test runner\n * and displays the test results.\n *\n * @returns A promise that resolves when unit tests are complete.\n */\nasync function testUnit() {\n    try {\n        const cmd = await command.testUnit();\n\n        await runCommand('Running unit tests', cmd, { throwOnError: true });\n    }\n    catch (error) {\n        log.error(error);\n        process.exit(1);\n    }\n}\n\n/**\n * Runs the end-to-end test suite.\n * This function executes end-to-end tests using the configured test runner\n * and displays the test results.\n *\n * @returns A promise that resolves when end-to-end tests are complete.\n */\nasync function testE2E() {\n    try {\n        const cmd = await command.testE2e();\n\n        await runCommand('Running end-to-end tests', cmd, { throwOnError: true });\n    }\n    catch (error) {\n        log.error(error);\n        process.exit(1);\n    }\n}\n\n/**\n * Creates a new MongoDB migration file.\n * This function creates a new migration file with the specified name\n * for database schema changes.\n *\n * @param migrationName - The name for the new migration file.\n * @returns A promise that resolves when the migration file is created.\n */\nasync function mongoMigrateCreate(migrationName: string) {\n    await runCommand('Creating MongoDB migration', await command.mongoMigrateCreate(migrationName));\n}\n\n/**\n * Applies all pending MongoDB migrations.\n * This function runs all pending database migrations to update the database schema\n * to the latest version.\n *\n * @returns A promise that resolves when all migrations are applied.\n */\nasync function mongoMigrateUp() {\n    await runCommand('Running MongoDB migrations', await command.mongoMigrateUp());\n}\n\n/**\n * Rolls back the last applied MongoDB migration.\n * This function reverts the most recent database migration, undoing\n * the last schema change.\n *\n * @returns A promise that resolves when the migration is rolled back.\n */\nasync function mongoMigrateDown() {\n    await runCommand('Rolling back MongoDB migration', await command.mongoMigrateDown());\n}\n\n/**\n * Starts the Storybook development server.\n * This function runs Storybook in development mode, allowing you to\n * view and interact with your component stories in a browser.\n *\n * @returns A promise that resolves when the Storybook dev server is started.\n */\nasync function storybookDev() {\n    await runCommand('Starting Storybook development server', await command.storybookDev());\n}\n\n/**\n * Builds Storybook for production deployment.\n * This function creates a static build of Storybook that can be\n * deployed to a web server or hosting service.\n *\n * @returns A promise that resolves when the Storybook build is complete.\n */\nasync function storybookBuild() {\n    await runCommand('Building Storybook', await command.storybookBuild());\n}\n\n(async () => {\n    try {\n        await yargs(hideBin(process.argv))\n            .scriptName(CYBERSKILL_CLI)\n            .usage('$0 <command> [options]')\n            .command('ai:setup', 'Setup AI agent environment', aiSetup)\n            .command('lint', 'Check code for linting issues', lintCheck)\n            .command('lint:fix', 'Fix linting issues automatically', lintFix)\n            .command('lint:inspect', 'View active ESLint configuration', inspectLint)\n            .command('lint-staged', 'Run lint checks on staged files', lintStaged)\n            .command('commitlint', 'Validate commit message format', commitLint)\n            .command('ready', 'Initialize project and dependencies', ready)\n            .command('reset', 'Reset the project and reinstall dependencies', reset)\n            .command('inspect', 'Analyze installed project dependencies', inspect)\n            .command('test:unit', 'Run unit test suite', testUnit)\n            .command('test:e2e', 'Run end-to-end test suite', testE2E)\n            .command('mongo:migrate:create <name>', 'Create a MongoDB migration', y =>\n                y.positional('name', {\n                    describe: 'Migration name',\n                    type: 'string',\n                }), async (argv) => {\n                if (!argv.name) {\n                    log.error('Migration name is required.');\n\n                    return;\n                }\n\n                await mongoMigrateCreate(argv.name);\n            })\n            .command('mongo:migrate:up', 'Apply all MongoDB migrations', mongoMigrateUp)\n            .command('mongo:migrate:down', 'Rollback last MongoDB migration', mongoMigrateDown)\n            .command('storybook:dev', 'Start Storybook development server', storybookDev)\n            .command('storybook:build', 'Build Storybook for production', storybookBuild)\n            .example('$0 lint:fix', 'Automatically block and fix linter errors')\n            .example('$0 test:unit', 'Run the unit test suite')\n            .example('$0 mongo:migrate:create init_db', 'Create a new migration file named \"init_db\"')\n            .demandCommand(1, 'Please specify a valid command.')\n            .strict()\n            .help()\n            .alias('h', 'help')\n            .alias('v', 'version')\n            .version(getVersion())\n            .epilog('💡 Tip: Use \"--help\" with any command to see options\\n')\n            .parse();\n    }\n    catch (error) {\n        catchError(error);\n        process.exit(1);\n    }\n})();\n"],"mappings":"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"}

package/dist/{src/node → node}/command/command.util.d.ts

@@ -1,5 +1,10 @@
 import { I_IssueEntry } from '../log/index.js';
 import { I_CommandContext, T_Command, T_CommandMapInput } from './command.type.js';
+/**
+ * Resets the cached package name. For testing only.
+ * Call this to force `getPackageName()` to re-read the package.json on the next invocation.
+ */
+export declare function resetCommandCacheForTesting(): void;
 /**
  * Retrieves all stored error lists from persistent storage.
  * This function fetches error entries that were previously saved using the package name as the key.