@xeno-js/cli 0.1.0

package/dist/shared/utils/guards.utils.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Guards = void 0;
+const OBJECT_TAG = '[object Object]';
+const DATE_TAG = '[object Date]';
+/**
+ * @description Centralized type guards and runtime predicates.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+exports.Guards = Object.freeze({
+    /**
+     * @description Checks value is neither null nor undefined.
+     * @param value Candidate value.
+     * @returns True when value is defined.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isDefined(value) {
+        return value !== null && value !== undefined && value !== '' && !Number.isNaN(value);
+    },
+    /**
+     * @description Checks value is null, undefined, empty string, or false.
+     * @param value Candidate value.
+     * @returns True when value is null, undefined, empty string, or false.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isNullOrEmpty(value) {
+        return (!exports.Guards.isDefined(value) ||
+            (exports.Guards.isString(value) && value.trim() === '') ||
+            (exports.Guards.isArray(value) && value.length === 0));
+    },
+    /**
+     * @description Throws an error if the value is null, undefined, empty string, or false.
+     * @param value Candidate value.
+     * @param errorMessage Error message to throw if the check fails.
+     * @throws Error with the provided message if the value is null, undefined, empty string, or false.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    throwIfNullOrEmpty(value, errorMessage) {
+        if (exports.Guards.isNullOrEmpty(value)) {
+            throw new Error(errorMessage);
+        }
+    },
+    /**
+     * @description Throws an error if the value is not a positive integer.
+     * @param value Candidate value.
+     * @param errorMessage Error message to throw if the check fails.
+     * @throws Error with the provided message if the value is not a positive integer.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    throwIfNegative(value, errorMessage) {
+        if (exports.Guards.isInteger(value) && value < 0) {
+            throw new Error(errorMessage);
+        }
+    },
+    /**
+     * @description Throws an error if the value is not an integer.
+     * @param value Candidate value.
+     * @param errorMessage Error message to throw if the check fails.
+     * @throws Error with the provided message if the value is not an integer.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    throwIfNotInteger(value, errorMessage) {
+        if (!exports.Guards.isInteger(value)) {
+            throw new Error(errorMessage);
+        }
+    },
+    /**
+     * @description Checks if an object has a method with the given name.
+     * @param obj Object to check.
+     * @param methodName Name of the method to look for.
+     * @returns True when obj has a function property named methodName.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    hasMethod(obj, methodName) {
+        if (!this.isDefined(obj))
+            return false;
+        // Essendo all'interno del namespace di utilità, l'uso di typeof qui è consentito
+        return exports.Guards.isFunction(obj[methodName]);
+    },
+    /**
+     * @description Checks value is a string.
+     * @param value Candidate value.
+     * @returns True when value is string.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isString(value) {
+        return typeof value === 'string';
+    },
+    /**
+     * @description Checks value is a finite number.
+     * @param value Candidate value.
+     * @returns True when value is finite number.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isNumber(value) {
+        return typeof value === 'number' && Number.isFinite(value);
+    },
+    /**
+     * @description Checks value is an integer number.
+     * @param value Candidate value.
+     * @returns True when value is integer number.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isInteger(value) {
+        return exports.Guards.isNumber(value) && Number.isInteger(value);
+    },
+    /**
+     * @description Checks value is boolean.
+     * @param value Candidate value.
+     * @returns True when value is boolean.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isBoolean(value) {
+        return typeof value === 'boolean';
+    },
+    /**
+     * @description Checks value is bigint.
+     * @param value Candidate value.
+     * @returns True when value is bigint.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isBigInt(value) {
+        return typeof value === 'bigint';
+    },
+    /**
+     * @description Checks value is symbol.
+     * @param value Candidate value.
+     * @returns True when value is symbol.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isSymbol(value) {
+        return typeof value === 'symbol';
+    },
+    /**
+     * @description Checks value is a function.
+     * @param value Candidate value.
+     * @returns True when value is function.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isFunction(value) {
+        return typeof value === 'function';
+    },
+    /**
+     * @description Checks value is an array.
+     * @param value Candidate value.
+     * @returns True when value is array.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isArray(value) {
+        return Array.isArray(value);
+    },
+    /**
+     * @description Checks value is a Date instance with valid timestamp.
+     * @param value Candidate value.
+     * @returns True when value is valid Date.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isDate(value) {
+        if (Object.prototype.toString.call(value) !== DATE_TAG) {
+            return false;
+        }
+        return Number.isFinite(value.getTime());
+    },
+    /**
+     * @description Checks value is an Error instance.
+     * @param value Candidate value.
+     * @returns True when value is Error.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isError(value) {
+        return value instanceof Error;
+    },
+    /**
+     * @description Checks value is a plain object record.
+     * @param value Candidate value.
+     * @returns True when value is object record.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isObjectRecord(value) {
+        if (!exports.Guards.isDefined(value)) {
+            return false;
+        }
+        return Object.prototype.toString.call(value) === OBJECT_TAG;
+    },
+    /**
+     * @description Checks value is an object (not null).
+     * @param value Candidate value.
+     * @returns True when value is object.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isObject(value) {
+        return typeof value === 'object' && exports.Guards.isDefined(value);
+    },
+    /**
+     * @description Checks value is PromiseLike.
+     * @param value Candidate value.
+     * @returns True when value has then function.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isPromiseLike(value) {
+        if (!exports.Guards.isDefined(value)) {
+            return false;
+        }
+        if (!exports.Guards.isObject(value) && !exports.Guards.isFunction(value)) {
+            return false;
+        }
+        const thenMember = value['then'];
+        return exports.Guards.isFunction(thenMember);
+    },
+});

package/dist/shared/utils/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./guards.utils"), exports);
+__exportStar(require("./string.utils"), exports);

package/dist/shared/utils/string.utils.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringUtils = void 0;
+const guards_utils_1 = require("./guards.utils");
+exports.StringUtils = Object.freeze({
+    /**
+     * @description Inserisce un underscore (_) tra la fine di una parola e l'inizio della successiva in formato camelCase o PascalCase.
+     * @param input Stringa in input (es. "CreateUser").
+     * @returns Stringa separata da underscore (es. "Create_User").
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2026-09-18
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    splitCamelCaseWithUnderscore(input) {
+        if (!guards_utils_1.Guards.isString(input) || guards_utils_1.Guards.isNullOrEmpty(input))
+            return input;
+        return input.replace(/([a-z])([A-Z])/g, '$1_$2');
+    },
+    /**
+     * @description Converts a string to camelCase.
+     * @param input Input string (supports snake_case, kebab-case, or space-separated).
+     * @returns camelCase string.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    camelCase(input) {
+        const segments = input.split(/[-_\s]+/);
+        const [first, ...rest] = segments;
+        const head = guards_utils_1.Guards.isDefined(first) ? first.toLowerCase() : '';
+        return head + rest.map((seg) => seg.charAt(0).toUpperCase() + seg.slice(1)).join('');
+    },
+    /**
+     * @description Converts a string to PascalCase.
+     * @param input Input string (supports snake_case, kebab-case, space-separated, or camelCase).
+     * @returns PascalCase string.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2026-09-18
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    pascalCase(input) {
+        if (!guards_utils_1.Guards.isString(input) || guards_utils_1.Guards.isNullOrEmpty(input))
+            return '';
+        const segments = input.split(/[-_\s]+/);
+        return segments
+            .filter((seg) => seg.length > 0)
+            .map((seg) => {
+            // Se il segmento è tutto maiuscolo (es. CREATE), lo normalizziamo in minuscolo per evitare cREATE.
+            // Altrimenti, preserviamo il casing interno originale (es. UserService resta UserService).
+            const normalized = seg === seg.toUpperCase() ? seg.toLowerCase() : seg;
+            return normalized.charAt(0).toUpperCase() + normalized.slice(1);
+        })
+            .join('');
+    },
+});

package/eslint.config.mjs

@@ -0,0 +1,305 @@
+import eslint from '@eslint/js'
+import eslintConfigPrettier from 'eslint-config-prettier'
+import simpleImportSort from 'eslint-plugin-simple-import-sort'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+  // ── Global ignores ───────────────────────────────────────────────────────
+  {
+    ignores: [
+      '**/node_modules/**',
+      '**/dist/**',
+      '**/coverage/**',
+      '.husky/**',
+      'eslint.config.mjs',
+      'lint-staged.config.mjs',
+      'commitlint.config.cjs',
+      'vitest.config.ts',
+      'demo/**',
+      'packages/**',
+    ],
+  },
+
+  // ── Base configs ─────────────────────────────────────────────────────────
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  ...tseslint.configs.stylisticTypeChecked,
+
+  // ── Type-aware parser (project-wide) ─────────────────────────────────────
+  {
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.json', './tsconfig.test.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+
+  // ── Source + test rules ──────────────────────────────────────────────────
+  {
+    files: ['src/**/*.ts', 'tests/**/*.ts'],
+    plugins: {
+      'simple-import-sort': simpleImportSort,
+    },
+    rules: {
+      // ── Core JS ──────────────────────────────────────────────────────────
+      'curly': ['error', 'all'],
+      'eqeqeq': ['error', 'always', { null: 'ignore' }],
+      'no-console': ['error', { allow: ['warn', 'error', 'info', 'debug'] }],
+      // Disabled: the core rule does not understand TypeScript's `import type`
+      // and flags intentional type/value split imports from the same module.
+      // `@typescript-eslint/consistent-type-imports` already enforces correct usage.
+      'no-duplicate-imports': 'off',
+      'no-var': 'error',
+      'object-shorthand': ['error', 'always'],
+      'prefer-const': 'error',
+      'prefer-template': 'error',
+
+      // ── Import order ──────────────────────────────────────────────────────
+      'simple-import-sort/imports': 'error',
+      'simple-import-sort/exports': 'error',
+
+      // ── TypeScript: type-safe guarantees ──────────────────────────────────
+      '@typescript-eslint/consistent-type-exports': 'error',
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
+      ],
+      '@typescript-eslint/explicit-module-boundary-types': 'error',
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        { checksVoidReturn: { attributes: false } },
+      ],
+      '@typescript-eslint/only-throw-error': 'error',
+      // '@typescript-eslint/return-await': ['error', 'in-try-catch'],
+      '@typescript-eslint/strict-boolean-expressions': [
+        'error',
+        {
+          allowString: false,
+          allowNumber: false,
+          allowNullableObject: false,
+          allowNullableBoolean: false,
+          allowNullableString: false,
+          allowNullableNumber: false,
+          allowAny: false,
+        },
+      ],
+      '@typescript-eslint/unbound-method': 'error',
+      '@typescript-eslint/no-unsafe-assignment': 'error',
+      '@typescript-eslint/no-unsafe-call': 'error',
+      '@typescript-eslint/no-unsafe-member-access': 'error',
+      '@typescript-eslint/no-unsafe-return': 'error',
+      '@typescript-eslint/no-unsafe-argument': 'error',
+      '@typescript-eslint/restrict-template-expressions': 'error',
+      '@typescript-eslint/restrict-plus-operands': 'error',
+      '@typescript-eslint/no-unsafe-enum-comparison': 'error',
+      '@typescript-eslint/require-await': 'off',
+      // ── TypeScript: code quality ──────────────────────────────────────────
+      '@typescript-eslint/no-shadow': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          ignoreRestSiblings: true,
+        },
+      ],
+
+      // ── TypeScript: naming conventions ────────────────────────────────────
+      '@typescript-eslint/naming-convention': [
+        'error',
+        // Type constructs → PascalCase
+        { selector: 'typeLike', format: ['PascalCase'] },
+        // Enum members → UPPER_CASE (PascalCase tolerated for legacy)
+        { selector: 'enumMember', format: ['UPPER_CASE', 'PascalCase'] },
+        // Default catch-all → camelCase (leading _ allowed for intentionally unused)
+        {
+          selector: 'default',
+          format: ['camelCase'],
+          leadingUnderscore: 'allow',
+          trailingUnderscore: 'forbid',
+        },
+        // Variables: also allow UPPER_CASE for module-level constants, PascalCase for imported classes
+        {
+          selector: 'variable',
+          format: ['camelCase', 'UPPER_CASE', 'PascalCase'],
+          leadingUnderscore: 'allow',
+        },
+        // Imports: PascalCase (classes/namespaces) and camelCase (functions/values)
+        { selector: 'import', format: ['camelCase', 'PascalCase'] },
+        // Object literal properties: no restriction (external API / DB column mapping)
+        { selector: 'objectLiteralProperty', format: null },
+        // Destructured variables: no restriction (external sources)
+        { selector: 'variable', modifiers: ['destructured'], format: null },
+      ],
+
+      // ── Disabled / adjusted ───────────────────────────────────────────────
+      'dot-notation': 'off',
+      '@typescript-eslint/dot-notation': 'off',
+    },
+  },
+
+  // ── Test files: relax rules that conflict with test patterns ────────────
+  {
+    files: ['tests/**/*.ts'],
+    rules: {
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-non-null-assertion': 'off',
+    },
+  },
+
+  // ── Layered architecture boundaries (DDD / Clean Architecture) ─────────
+  {
+    files: ['src/shared/**/*.ts'],
+    rules: {
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: [
+                '@/domain',
+                '@/domain/**',
+                '@/application',
+                '@/application/**',
+                '@/infrastructure',
+                '@/infrastructure/**',
+                '@/presentation',
+                '@/presentation/**',
+              ],
+              message: 'shared can only import from shared and external libraries.',
+            },
+            {
+              group: [
+                '../**/domain',
+                '../**/domain/**',
+                '../**/application',
+                '../**/application/**',
+                '../**/infrastructure',
+                '../**/infrastructure/**',
+                '../**/presentation',
+                '../**/presentation/**',
+              ],
+              message: 'shared can only import from shared and external libraries.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: ['src/domain/**/*.ts'],
+    rules: {
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: [
+                '@/application',
+                '@/application/**',
+                '@/infrastructure',
+                '@/infrastructure/**',
+                '@/presentation',
+                '@/presentation/**',
+              ],
+              message: 'domain can only import from domain, shared, and external libraries.',
+            },
+            {
+              group: [
+                '../**/application',
+                '../**/application/**',
+                '../**/infrastructure',
+                '../**/infrastructure/**',
+                '../**/presentation',
+                '../**/presentation/**',
+              ],
+              message: 'domain can only import from domain, shared, and external libraries.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: ['src/application/**/*.ts'],
+    rules: {
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: [
+                '@/infrastructure',
+                '@/infrastructure/**',
+                '@/presentation',
+                '@/presentation/**',
+              ],
+              message:
+                'application can only import from application, domain, shared, and external libraries.',
+            },
+            {
+              group: [
+                '../**/infrastructure',
+                '../**/infrastructure/**',
+                '../**/presentation',
+                '../**/presentation/**',
+              ],
+              message:
+                'application can only import from application, domain, shared, and external libraries.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: ['src/infrastructure/**/*.ts'],
+    rules: {
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: ['@/presentation', '@/presentation/**'],
+              message:
+                'infrastructure can only import from infrastructure, domain, application, shared, and external libraries.',
+            },
+            {
+              group: ['../**/presentation', '../**/presentation/**'],
+              message:
+                'infrastructure can only import from infrastructure, domain, application, shared, and external libraries.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: ['src/presentation/**/*.ts'],
+    rules: {
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: ['@/infrastructure', '@/infrastructure/**'],
+              message:
+                'presentation can only import from presentation, domain, application, shared, and external libraries.',
+            },
+            {
+              group: ['../**/infrastructure', '../**/infrastructure/**'],
+              message:
+                'presentation can only import from presentation, domain, application, shared, and external libraries.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+
+  // ── Prettier (must be last) ───────────────────────────────────────────────
+  eslintConfigPrettier,
+)