@qvaroo/configs 1.0.0

package/eslint/node.js

@@ -0,0 +1,126 @@
+/**
+ * @qvaroo/configs - Node.js ESLint Configuration
+ * 
+ * Extended configuration for Node.js/Express/NestJS backend projects.
+ * Includes all base rules plus Node-specific best practices.
+ */
+
+const baseConfig = require('./index');
+
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+    ...baseConfig,
+
+    env: {
+        node: true,
+        es2022: true,
+    },
+
+    plugins: [
+        ...baseConfig.plugins,
+        'n', // eslint-plugin-n (Node.js)
+        'security',
+    ],
+
+    extends: [
+        ...baseConfig.extends.filter(ext => ext !== 'prettier'),
+        'plugin:n/recommended',
+        'plugin:security/recommended',
+        'prettier',
+    ],
+
+    rules: {
+        ...baseConfig.rules,
+
+        // ═══════════════════════════════════════════════════════════════════════
+        // NODE.JS SPECIFIC RULES
+        // ═══════════════════════════════════════════════════════════════════════
+
+        // Allow console in Node.js (for logging)
+        'no-console': 'off',
+
+        // Node.js best practices
+        'n/no-missing-import': 'error',
+        'n/no-missing-require': 'error',
+        'n/no-unpublished-import': 'off', // Dev dependencies in configs
+        'n/no-unpublished-require': 'off',
+        'n/no-unsupported-features/es-syntax': [
+            'error',
+            { ignores: ['modules'] },
+        ],
+        'n/no-extraneous-import': 'error',
+        'n/no-deprecated-api': 'error',
+        'n/prefer-global/buffer': ['error', 'always'],
+        'n/prefer-global/console': ['error', 'always'],
+        'n/prefer-global/process': ['error', 'always'],
+        'n/prefer-promises/dns': 'error',
+        'n/prefer-promises/fs': 'error',
+
+        // ═══════════════════════════════════════════════════════════════════════
+        // SECURITY RULES - Prevent common vulnerabilities
+        // ═══════════════════════════════════════════════════════════════════════
+
+        'security/detect-buffer-noassert': 'error',
+        'security/detect-child-process': 'warn',
+        'security/detect-disable-mustache-escape': 'error',
+        'security/detect-eval-with-expression': 'error',
+        'security/detect-new-buffer': 'error',
+        'security/detect-no-csrf-before-method-override': 'error',
+        'security/detect-non-literal-fs-filename': 'warn',
+        'security/detect-non-literal-regexp': 'warn',
+        'security/detect-non-literal-require': 'warn',
+        'security/detect-object-injection': 'warn',
+        'security/detect-possible-timing-attacks': 'warn',
+        'security/detect-pseudoRandomBytes': 'error',
+        'security/detect-unsafe-regex': 'error',
+
+        // ═══════════════════════════════════════════════════════════════════════
+        // ASYNC/AWAIT - Strict handling for backend
+        // ═══════════════════════════════════════════════════════════════════════
+
+        '@typescript-eslint/no-floating-promises': 'error',
+        '@typescript-eslint/promise-function-async': 'error',
+        'require-atomic-updates': 'error',
+
+        // ═══════════════════════════════════════════════════════════════════════
+        // ERROR HANDLING - Backend specific
+        // ═══════════════════════════════════════════════════════════════════════
+
+        'no-throw-literal': 'error',
+        'prefer-promise-reject-errors': 'error',
+
+        // ═══════════════════════════════════════════════════════════════════════
+        // IMPORT/EXPORT - CommonJS & ESM support
+        // ═══════════════════════════════════════════════════════════════════════
+
+        'unicorn/prefer-module': 'off', // Allow CommonJS in Node
+        '@typescript-eslint/no-require-imports': 'off', // Allow require()
+    },
+
+    overrides: [
+        ...baseConfig.overrides,
+        // Controller files - allow larger methods for route handlers
+        {
+            files: ['**/*.controller.ts', '**/controllers/**/*.ts'],
+            rules: {
+                'max-lines-per-function': ['error', { max: 60 }],
+            },
+        },
+        // Migration files
+        {
+            files: ['**/migrations/**/*.ts'],
+            rules: {
+                '@typescript-eslint/naming-convention': 'off',
+                'max-lines-per-function': 'off',
+            },
+        },
+        // Seed files
+        {
+            files: ['**/seeds/**/*.ts', '**/seeders/**/*.ts'],
+            rules: {
+                'sonarjs/no-duplicate-string': 'off',
+                'no-magic-numbers': 'off',
+            },
+        },
+    ],
+};

package/eslint/react.js

@@ -0,0 +1,159 @@
+/**
+ * @qvaroo/configs - React ESLint Configuration
+ * 
+ * Extended configuration for React/Next.js projects.
+ * Includes all base rules plus React-specific best practices.
+ */
+
+const baseConfig = require('./index');
+
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+    ...baseConfig,
+
+    parserOptions: {
+        ...baseConfig.parserOptions,
+        ecmaFeatures: {
+            jsx: true,
+        },
+    },
+
+    plugins: [
+        ...baseConfig.plugins,
+        'react',
+        'react-hooks',
+        'jsx-a11y',
+    ],
+
+    extends: [
+        ...baseConfig.extends.filter(ext => ext !== 'prettier'),
+        'plugin:react/recommended',
+        'plugin:react/jsx-runtime',
+        'plugin:react-hooks/recommended',
+        'plugin:jsx-a11y/strict',
+        'prettier',
+    ],
+
+    settings: {
+        ...baseConfig.settings,
+        react: {
+            version: 'detect',
+        },
+    },
+
+    rules: {
+        ...baseConfig.rules,
+
+        // ═══════════════════════════════════════════════════════════════════════
+        // REACT SPECIFIC RULES
+        // ═══════════════════════════════════════════════════════════════════════
+
+        // Component naming - PascalCase enforced
+        'react/jsx-pascal-case': ['error', { allowAllCaps: false }],
+
+        // Hooks rules - strict enforcement
+        'react-hooks/rules-of-hooks': 'error',
+        'react-hooks/exhaustive-deps': 'error',
+
+        // JSX best practices
+        'react/jsx-no-useless-fragment': 'error',
+        'react/jsx-curly-brace-presence': ['error', { props: 'never', children: 'never' }],
+        'react/jsx-boolean-value': ['error', 'never'],
+        'react/self-closing-comp': 'error',
+        'react/no-array-index-key': 'error',
+        'react/no-danger': 'error',
+        'react/no-deprecated': 'error',
+        'react/no-direct-mutation-state': 'error',
+        'react/no-find-dom-node': 'error',
+        'react/no-is-mounted': 'error',
+        'react/no-string-refs': 'error',
+        'react/no-unescaped-entities': 'error',
+        'react/no-unknown-property': 'error',
+
+        // Props and state
+        'react/prop-types': 'off', // Using TypeScript
+        'react/require-default-props': 'off', // Using TypeScript
+        'react/jsx-props-no-spreading': [
+            'error',
+            {
+                html: 'enforce',
+                custom: 'ignore',
+                explicitSpread: 'ignore',
+            },
+        ],
+
+        // Performance
+        'react/jsx-no-bind': [
+            'error',
+            {
+                ignoreDOMComponents: false,
+                ignoreRefs: true,
+                allowArrowFunctions: true,
+                allowFunctions: false,
+                allowBind: false,
+            },
+        ],
+
+        // Accessibility
+        'jsx-a11y/alt-text': 'error',
+        'jsx-a11y/anchor-has-content': 'error',
+        'jsx-a11y/anchor-is-valid': 'error',
+        'jsx-a11y/aria-props': 'error',
+        'jsx-a11y/aria-role': 'error',
+        'jsx-a11y/aria-unsupported-elements': 'error',
+        'jsx-a11y/click-events-have-key-events': 'error',
+        'jsx-a11y/heading-has-content': 'error',
+        'jsx-a11y/html-has-lang': 'error',
+        'jsx-a11y/iframe-has-title': 'error',
+        'jsx-a11y/img-redundant-alt': 'error',
+        'jsx-a11y/interactive-supports-focus': 'error',
+        'jsx-a11y/label-has-associated-control': 'error',
+        'jsx-a11y/lang': 'error',
+        'jsx-a11y/media-has-caption': 'error',
+        'jsx-a11y/mouse-events-have-key-events': 'error',
+        'jsx-a11y/no-access-key': 'error',
+        'jsx-a11y/no-autofocus': 'error',
+        'jsx-a11y/no-distracting-elements': 'error',
+        'jsx-a11y/no-interactive-element-to-noninteractive-role': 'error',
+        'jsx-a11y/no-noninteractive-element-interactions': 'error',
+        'jsx-a11y/no-noninteractive-element-to-interactive-role': 'error',
+        'jsx-a11y/no-redundant-roles': 'error',
+        'jsx-a11y/no-static-element-interactions': 'error',
+        'jsx-a11y/role-has-required-aria-props': 'error',
+        'jsx-a11y/role-supports-aria-props': 'error',
+        'jsx-a11y/scope': 'error',
+        'jsx-a11y/tabindex-no-positive': 'error',
+
+        // Allow relaxed naming for React components
+        '@typescript-eslint/naming-convention': [
+            'error',
+            // Keep all base rules
+            ...require('./rules/naming-conventions')['@typescript-eslint/naming-convention'].slice(1),
+
+            // Add exception for React functional components
+            {
+                selector: 'variable',
+                modifiers: ['const', 'exported'],
+                format: ['camelCase', 'UPPER_CASE', 'PascalCase'],
+            },
+        ],
+    },
+
+    overrides: [
+        ...baseConfig.overrides,
+        // Next.js pages/app router files
+        {
+            files: ['**/pages/**/*.tsx', '**/app/**/*.tsx'],
+            rules: {
+                'import/no-default-export': 'off',
+            },
+        },
+        // Component files
+        {
+            files: ['**/*.tsx'],
+            rules: {
+                'max-lines-per-function': ['error', { max: 80 }], // Allow larger components
+            },
+        },
+    ],
+};

package/eslint/rules/architecture.js

@@ -0,0 +1,152 @@
+/**
+ * Architecture Rules
+ * 
+ * Enforces folder structure and separation of concerns:
+ * - /api, /components, /services, /events, /animations, /styles
+ * - Presentation-only views: No business logic or API calls
+ * - Boundary enforcement between layers
+ */
+
+module.exports = {
+    // ═══════════════════════════════════════════════════════════════════════
+    // BOUNDARY RULES - Folder separation enforcement
+    // ═══════════════════════════════════════════════════════════════════════
+
+    'boundaries/element-types': [
+        'error',
+        {
+            default: 'disallow',
+            rules: [
+                // Components can import from: styles, types, utils, hooks, components, animations
+                {
+                    from: 'components',
+                    allow: ['components', 'styles', 'types', 'utils', 'hooks', 'animations', 'constants'],
+                },
+
+                // Views can import from: components, styles, types, hooks (NO services, NO api)
+                {
+                    from: 'views',
+                    allow: ['components', 'styles', 'types', 'hooks', 'animations', 'constants'],
+                    disallow: ['api', 'services'], // Presentation-only views
+                },
+
+                // Services can import from: api, types, utils, constants
+                {
+                    from: 'services',
+                    allow: ['api', 'types', 'utils', 'constants', 'services'],
+                },
+
+                // API layer can only import from: types, utils, constants
+                {
+                    from: 'api',
+                    allow: ['types', 'utils', 'constants'],
+                },
+
+                // Hooks can import from: services, api, types, utils
+                {
+                    from: 'hooks',
+                    allow: ['services', 'api', 'types', 'utils', 'constants', 'hooks'],
+                },
+
+                // Events can import from: types, utils
+                {
+                    from: 'events',
+                    allow: ['types', 'utils', 'constants'],
+                },
+
+                // Animations can import from: types, utils, styles
+                {
+                    from: 'animations',
+                    allow: ['types', 'utils', 'styles', 'constants'],
+                },
+
+                // Styles: standalone, no business imports
+                {
+                    from: 'styles',
+                    allow: ['styles', 'constants'],
+                },
+
+                // Utils: standalone, no circular dependencies
+                {
+                    from: 'utils',
+                    allow: ['types', 'constants'],
+                },
+
+                // Types: standalone
+                {
+                    from: 'types',
+                    allow: ['types'],
+                },
+
+                // Constants: standalone
+                {
+                    from: 'constants',
+                    allow: ['types'],
+                },
+            ],
+        },
+    ],
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // IMPORT BOUNDARIES - Prevent circular dependencies
+    // ═══════════════════════════════════════════════════════════════════════
+
+    'import/no-cycle': ['error', { maxDepth: 3 }],
+
+    'import/no-restricted-paths': [
+        'error',
+        {
+            zones: [
+                // Views cannot import directly from API
+                {
+                    target: './src/views',
+                    from: './src/api',
+                    message: 'Views must not import from API directly. Use hooks or services instead.',
+                },
+                // Views cannot import directly from Services
+                {
+                    target: './src/views',
+                    from: './src/services',
+                    message: 'Views must not import from services directly. Use hooks instead.',
+                },
+                // Components cannot import from views (prevent circular)
+                {
+                    target: './src/components',
+                    from: './src/views',
+                    message: 'Components cannot import from views. This creates circular dependencies.',
+                },
+                // Styles cannot import business logic
+                {
+                    target: './src/styles',
+                    from: './src/api',
+                    message: 'Styles must not contain business logic or API dependencies.',
+                },
+                {
+                    target: './src/styles',
+                    from: './src/services',
+                    message: 'Styles must not contain business logic or service dependencies.',
+                },
+            ],
+        },
+    ],
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // FILE NAMING PATTERNS
+    // ═══════════════════════════════════════════════════════════════════════
+
+    // Enforce consistent file naming
+    'unicorn/filename-case': [
+        'error',
+        {
+            cases: {
+                kebabCase: true,    // Regular files: my-component.ts
+                pascalCase: true,   // React components: MyComponent.tsx
+            },
+            ignore: [
+                '^README\\.md$',
+                '^CHANGELOG\\.md$',
+                '^LICENSE$',
+            ],
+        },
+    ],
+};

package/eslint/rules/code-quality.js

@@ -0,0 +1,142 @@
+/**
+ * Code Quality Rules
+ * 
+ * Enforces strict quality limits:
+ * - Method length: max 40 lines → error
+ * - Class length: max 300 lines → error
+ * - Max nested if statements: 2 → error
+ * - No magic strings / hard-coded values → error
+ * - No empty catch blocks → error
+ * - Guard clauses enforcement
+ */
+
+module.exports = {
+    // ═══════════════════════════════════════════════════════════════════════
+    // METHOD & CLASS LENGTH LIMITS
+    // ═══════════════════════════════════════════════════════════════════════
+
+    // Maximum 40 lines per function/method
+    'max-lines-per-function': [
+        'error',
+        {
+            max: 40,
+            skipBlankLines: true,
+            skipComments: true,
+            IIFEs: true,
+        },
+    ],
+
+    // Maximum 300 lines per file (proxy for class length)
+    'max-lines': [
+        'error',
+        {
+            max: 300,
+            skipBlankLines: true,
+            skipComments: true,
+        },
+    ],
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // NESTING DEPTH - Maximum 2 nested if statements
+    // ═══════════════════════════════════════════════════════════════════════
+
+    'max-depth': ['error', { max: 2 }],
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // COMPLEXITY LIMITS - Encourage simpler code
+    // ═══════════════════════════════════════════════════════════════════════
+
+    // Cyclomatic complexity limit
+    complexity: ['error', { max: 10 }],
+
+    // Maximum statements per function
+    'max-statements': ['error', { max: 20 }],
+
+    // Maximum parameters
+    'max-params': ['error', { max: 4 }],
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // MAGIC VALUES - No hard-coded strings/numbers
+    // ═══════════════════════════════════════════════════════════════════════
+
+    // No magic numbers (must use named constants)
+    'no-magic-numbers': [
+        'error',
+        {
+            ignore: [-1, 0, 1, 2, 100], // Common acceptable values
+            ignoreArrayIndexes: true,
+            ignoreDefaultValues: true,
+            enforceConst: true,
+            detectObjects: false,
+        },
+    ],
+
+    // SonarJS: Enforce no duplicate strings (magic strings)
+    'sonarjs/no-duplicate-string': [
+        'error',
+        {
+            threshold: 3,
+        },
+    ],
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // GUARD CLAUSES - Early returns encouraged
+    // ═══════════════════════════════════════════════════════════════════════
+
+    // Prefer early returns (guard clauses)
+    'no-else-return': [
+        'error',
+        {
+            allowElseIf: false,
+        },
+    ],
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // COGNITIVE COMPLEXITY - Readability enforcement
+    // ═══════════════════════════════════════════════════════════════════════
+
+    'sonarjs/cognitive-complexity': ['error', 15],
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // CODE DUPLICATION - DRY principle
+    // ═══════════════════════════════════════════════════════════════════════
+
+    'sonarjs/no-identical-functions': 'error',
+    'sonarjs/no-all-duplicated-branches': 'error',
+    'sonarjs/no-duplicated-branches': 'error',
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // ADDITIONAL QUALITY RULES
+    // ═══════════════════════════════════════════════════════════════════════
+
+    // No nested ternaries
+    'no-nested-ternary': 'error',
+
+    // Require default case in switch
+    'default-case': 'error',
+    'default-case-last': 'error',
+
+    // No fallthrough in switch (must be explicit)
+    'no-fallthrough': ['error', { commentPattern: 'falls?\\s?through' }],
+
+    // Enforce consistent return
+    'consistent-return': 'error',
+
+    // No unreachable code
+    'no-unreachable': 'error',
+    'no-unreachable-loop': 'error',
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // ERROR HANDLING - Strict enforcement
+    // ═══════════════════════════════════════════════════════════════════════
+
+    // No empty blocks (including catch)
+    'no-empty': ['error', { allowEmptyCatch: false }],
+
+    // Prefer throwing Error objects
+    '@typescript-eslint/only-throw-error': 'error',
+
+    // Require await in async functions
+    'require-await': 'off', // Handled by TypeScript
+    '@typescript-eslint/require-await': 'error',
+};