V12

.eslintrc.js

@@ -4,25 +4,52 @@ module.exports = {
     project: 'tsconfig.json',
     tsconfigRootDir: __dirname,
     sourceType: 'module',
+    ecmaVersion: 2020,
   },
   plugins: ['@typescript-eslint/eslint-plugin', 'prettier'],
   extends: [
+    'eslint:recommended',
     'plugin:@typescript-eslint/recommended',
+    'plugin:@typescript-eslint/recommended-requiring-type-checking',
     'prettier',
   ],
   root: true,
   env: {
     node: true,
     jest: true,
+    es2020: true,
   },
-  ignorePatterns: ['.eslintrc.js', 'dist', 'node_modules', 'jest.config.js', 'tsup.config.ts'],
+  ignorePatterns: ['.eslintrc.js', 'dist', 'node_modules', 'jest.config.js', 'tsup.config.ts', 'organize-tests.js'],
   rules: {
+    // TypeScript specific rules
     '@typescript-eslint/interface-name-prefix': 'off',
-    '@typescript-eslint/explicit-function-return-type': 'warn',
-    '@typescript-eslint/explicit-module-boundary-types': 'warn',
-    '@typescript-eslint/no-explicit-any': 'warn',
-    '@typescript-eslint/no-unused-vars': 'warn',
-    '@typescript-eslint/ban-ts-comment': 'warn',
-    'prettier/prettier': 'warn'
+    '@typescript-eslint/explicit-function-return-type': 'error',
+    '@typescript-eslint/explicit-module-boundary-types': 'error',
+    '@typescript-eslint/no-explicit-any': 'error',
+    '@typescript-eslint/no-unused-vars': 'error',
+    '@typescript-eslint/ban-ts-comment': 'error',
+    '@typescript-eslint/prefer-const': 'error',
+    '@typescript-eslint/no-inferrable-types': 'off',
+    '@typescript-eslint/no-empty-function': 'warn',
+
+    // General ESLint rules
+    'prefer-const': 'error',
+    'no-var': 'error',
+    'no-console': 'warn',
+    'eqeqeq': 'error',
+    'curly': 'error',
+
+    // Prettier
+    'prettier/prettier': 'warn',
   },
+  overrides: [
+    {
+      files: ['tests/**/*.ts', '**/*.spec.ts', '**/*.bench.ts', '**/*.int-spec.ts'],
+      rules: {
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/ban-ts-comment': 'off',
+        'no-console': 'off',
+      },
+    },
+  ],
 };

.github/pull_request_template.md

@@ -1,45 +1,2 @@
-# Pull Request
 
-## Type of Change
-<!-- Please check the one that applies to this PR using "x". -->
 
-- [ ] 🚀 feat: A new feature
-- [ ] 🐛 fix: A bug fix
-- [ ] 📚 docs: Documentation only changes
-- [ ] 💎 style: Changes that do not affect the meaning of the code (white-space, formatting, etc)
-- [ ] ♻️ refactor: A code change that neither fixes a bug nor adds a feature
-- [ ] ⚡ perf: A code change that improves performance
-- [ ] ✅ test: Adding missing tests or correcting existing tests
-- [ ] 🔧 build: Changes that affect the build system or external dependencies
-- [ ] 👷 ci: Changes to our CI configuration files and scripts
-- [ ] 🔄 chore: Other changes that don't modify src or test files
-
-## Description
-<!-- Please include a summary of the change and which issue is fixed. -->
-<!-- Please also include relevant motivation and context. -->
-
-Fixes # (issue)
-
-## Semantic Version Impact
-<!-- Which semantic version component would this PR increment? -->
-<!-- See https://semver.org/ for more information -->
-
-- [ ] Major (Breaking changes - not backward compatible)
-- [ ] Minor (New features - backward compatible)
-- [ ] Patch (Bug fixes - backward compatible)
-- [ ] None (Documentation, chore, etc - no release needed)
-
-## Checklist
-
-- [ ] My code follows the style guidelines of this project
-- [ ] I have performed a self-review of my own code
-- [ ] I have commented my code, particularly in hard-to-understand areas
-- [ ] I have made corresponding changes to the documentation
-- [ ] My changes generate no new warnings
-- [ ] I have added tests that prove my fix is effective or that my feature works
-- [ ] New and existing unit tests pass locally with my changes
-- [ ] My commit messages follow the [Conventional Commits](https://www.conventionalcommits.org/) standard
-- [ ] I have updated the CHANGELOG.md (if applicable)
-
-## Additional Information
-<!-- Any additional information or context that would be helpful for reviewers -->

.github/workflows/ci.yml

@@ -0,0 +1,142 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  quality:
+    name: Code Quality
+    runs-on: ubuntu-latest
+    # Only run for development PRs, not release PRs
+    if: |
+      github.event_name == 'push' || 
+      (github.event_name == 'pull_request' && 
+       !startsWith(github.head_ref, 'v') && 
+       !startsWith(github.head_ref, 'release/') && 
+       !startsWith(github.head_ref, 'feature/') && 
+       !startsWith(github.head_ref, 'feat/') && 
+       !startsWith(github.head_ref, 'hotfix/'))
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Type checking
+        run: npm run type-check
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Format check
+        run: npm run format:check
+
+  test:
+    name: Test Suite
+    runs-on: ubuntu-latest
+    needs: quality
+
+    strategy:
+      matrix:
+        node-version: [20, 22, 24]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Run tests
+        run: npm run test:ci
+
+      - name: Upload coverage to Codecov
+        if: matrix.node-version == 20
+        uses: codecov/codecov-action@v3
+        with:
+          file: ./coverage/lcov.info
+          flags: unittests
+          name: codecov-umbrella
+
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    needs: [quality, test]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build package
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v3
+        with:
+          name: dist
+          path: dist/
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    needs: [quality, test, build]
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install pnpm
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build package
+        run: npm run build
+
+      - name: Semantic Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release

.github/workflows/feature.yml

@@ -0,0 +1,94 @@
+name: Git Flow - Feature Branch
+
+on:
+  push:
+    branches:
+      - 'feature/**'
+      - 'feat/**'
+  pull_request:
+    branches:
+      - v12
+    types: [opened, synchronize, reopened]
+
+jobs:
+  validate:
+    name: Validate Feature Branch
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Type checking
+        run: npm run type-check
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Format check
+        run: npm run format:check
+
+      - name: Run tests
+        run: npm run test:ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Validate branch naming
+        run: |
+          branch_name="${{ github.head_ref || github.ref_name }}"
+          if [[ ! "$branch_name" =~ ^(feature|feat)/.+ ]]; then
+            echo "❌ Branch name '$branch_name' does not follow convention: feature/your-feature-name"
+            exit 1
+          fi
+          echo "✅ Branch name '$branch_name' follows convention"
+
+      - name: Check commit messages
+        run: |
+          # Check if commits follow conventional commit format
+          commits=$(git log --pretty=format:"%s" origin/v12..HEAD)
+          while IFS= read -r commit; do
+            if [[ ! "$commit" =~ ^(feat|fix|chore|docs|style|refactor|test|perf|ci|build)(\([^)]*\))?\!?:\ .+ ]]; then
+              echo "❌ Commit message does not follow conventional format: $commit"
+              echo "Expected format: type(scope): description"
+              echo "Types: feat, fix, chore, docs, style, refactor, test, perf, ci, build"
+              exit 1
+            fi
+          done <<< "$commits"
+          echo "✅ All commit messages follow conventional format"
+
+  auto-assign-reviewers:
+    name: Auto Assign Reviewers
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+
+    steps:
+      - name: Auto assign reviewers
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { owner, repo, number } = context.issue;
+
+            // Add reviewers (customize based on your team)
+            await github.rest.pulls.requestReviewers({
+              owner,
+              repo,
+              pull_number: number,
+              reviewers: ['brmorillo'], // Add team members here
+            });
+
+            // Add labels
+            await github.rest.issues.addLabels({
+              owner,
+              repo,
+              issue_number: number,
+              labels: ['feature', 'review-needed']
+            });