@kabran-tecnologia/kabran-config 1.12.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kabran-tecnologia/kabran-config",
-  "version": "1.12.0",
+  "version": "2.0.0",
   "description": "Shared quality configurations, enforcement scripts, and CI/CD tooling for Kabran projects",
   "author": "Kabran",
   "license": "MIT",

package/src/cli/commands/test.mjs

@@ -81,6 +81,9 @@ export async function runTest(level, config, args) {
 
   console.log('\n' + '='.repeat(50));
   console.log(`Running L${levelNumber(level)} tests: ${level}`);
+  if (testConfig.doppler) {
+    console.log('[Doppler] Secrets injection enabled');
+  }
   console.log('='.repeat(50));
 
   // Setup phase (if defined)

package/src/core/config-loader.mjs

@@ -4,13 +4,19 @@
  * Loads project configuration from kabran.config.mjs/js/json with fallback to defaults.
  * Enables projects to customize validator behavior without modifying kabran-config.
  *
+ * Features:
+ * - Smart detection of tools (ESLint, TypeScript, Prettier, Vitest, Playwright)
+ * - Automatic Doppler integration for secrets injection in tests
+ * - Convention over configuration - works out of the box
+ *
  * @module config-loader
  */
 
-import {existsSync} from 'node:fs';
+import {existsSync, readFileSync} from 'node:fs';
 import {readFile} from 'node:fs/promises';
 import {join} from 'node:path';
 import {pathToFileURL} from 'node:url';
+import {execSync} from 'node:child_process';
 
 /**
  * Default configuration values.
@@ -30,6 +36,140 @@ export const DEFAULTS = {
   },
 };
 
+/**
+ * Config file patterns for each tool.
+ */
+const TOOL_CONFIGS = {
+  eslint: ['eslint.config.mjs', 'eslint.config.js', 'eslint.config.cjs', '.eslintrc.js', '.eslintrc.json', '.eslintrc.cjs'],
+  typescript: ['tsconfig.json'],
+  prettier: ['prettier.config.mjs', 'prettier.config.js', '.prettierrc', '.prettierrc.json', '.prettierrc.js'],
+  vitest: ['vitest.config.ts', 'vitest.config.mts', 'vitest.config.js', 'vitest.config.mjs'],
+  playwright: ['playwright.config.ts', 'playwright.config.js'],
+};
+
+/**
+ * Check if any of the config files exist for a tool.
+ * @param {string} cwd - Working directory
+ * @param {string[]} configFiles - List of possible config file names
+ * @returns {boolean} True if any config file exists
+ */
+function hasToolConfig(cwd, configFiles) {
+  return configFiles.some(file => existsSync(join(cwd, file)));
+}
+
+/**
+ * Check if Doppler is configured for the current directory.
+ * @param {string} cwd - Working directory
+ * @returns {boolean} True if Doppler token is configured
+ */
+function hasDopplerConfigured(cwd) {
+  try {
+    const result = execSync('doppler configure get token', {
+      cwd,
+      stdio: 'pipe',
+      encoding: 'utf-8',
+      timeout: 5000,
+    });
+    return result.trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Wrap command with Doppler if configured.
+ * @param {string} cmd - Command to wrap
+ * @param {boolean} useDoppler - Whether to use Doppler
+ * @returns {string} Wrapped command
+ */
+export function wrapWithDoppler(cmd, useDoppler) {
+  return useDoppler ? `doppler run -- ${cmd}` : cmd;
+}
+
+/**
+ * Detect available tools and generate smart defaults.
+ * Only configures commands for tools that are actually set up in the project.
+ * @param {string} cwd - Working directory
+ * @returns {object} Detected defaults for CLI commands
+ */
+export function detectToolDefaults(cwd) {
+  const defaults = {
+    check: {},
+    test: {},
+    build: {},
+    ci: { steps: [] },
+  };
+
+  const hasDoppler = hasDopplerConfigured(cwd);
+
+  // L1: Static Analysis
+  if (hasToolConfig(cwd, TOOL_CONFIGS.eslint)) {
+    defaults.check.lint = 'npx eslint .';
+  }
+
+  if (hasToolConfig(cwd, TOOL_CONFIGS.typescript)) {
+    defaults.check.types = 'npx tsc --noEmit';
+  }
+
+  if (hasToolConfig(cwd, TOOL_CONFIGS.prettier)) {
+    defaults.check.format = 'npx prettier --check .';
+  }
+
+  // L2: Unit Tests (with Doppler support)
+  if (hasToolConfig(cwd, TOOL_CONFIGS.vitest)) {
+    const cmd = 'npx vitest run';
+    defaults.test.unit = {
+      command: wrapWithDoppler(cmd, hasDoppler),
+      doppler: hasDoppler,
+    };
+  }
+
+  // L3: Integration Tests (with Doppler support)
+  const integrationConfig = join(cwd, 'vitest.integration.config.ts');
+  if (existsSync(integrationConfig)) {
+    const cmd = 'npx vitest run --config vitest.integration.config.ts';
+    defaults.test.integration = {
+      command: wrapWithDoppler(cmd, hasDoppler),
+      doppler: hasDoppler,
+    };
+  }
+
+  // L4: E2E Tests (with Doppler support)
+  if (hasToolConfig(cwd, TOOL_CONFIGS.playwright)) {
+    const cmd = 'npx playwright test';
+    defaults.test.e2e = {
+      command: wrapWithDoppler(cmd, hasDoppler),
+      doppler: hasDoppler,
+    };
+  }
+
+  // Build - check if npm run build exists in package.json
+  const packageJsonPath = join(cwd, 'package.json');
+  if (existsSync(packageJsonPath)) {
+    try {
+      const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+      if (packageJson.scripts?.build) {
+        defaults.build.command = 'npm run build';
+      }
+    } catch {
+      // Ignore parse errors
+    }
+  }
+
+  // CI steps - add detected tools
+  if (Object.keys(defaults.check).length > 0) {
+    defaults.ci.steps.push('check');
+  }
+  if (defaults.test.unit) {
+    defaults.ci.steps.push('test:unit');
+  }
+  if (defaults.build.command) {
+    defaults.ci.steps.push('build');
+  }
+
+  return defaults;
+}
+
 /**
  * Configuration file names to search for, in priority order.
  */
@@ -91,27 +231,38 @@ async function loadJsConfig(configPath) {
 /**
  * Load project configuration with fallback to defaults.
  *
- * Searches for configuration files in order:
- * 1. kabran.config.mjs
- * 2. kabran.config.js
- * 3. kabran.config.json
+ * Configuration priority (highest to lowest):
+ * 1. Project config (kabran.config.mjs/js/json)
+ * 2. Detected tool defaults (based on existing config files)
+ * 3. Static defaults (validators)
  *
- * If no config file is found, returns DEFAULTS.
+ * Features:
+ * - Smart detection of ESLint, TypeScript, Prettier, Vitest, Playwright
+ * - Automatic Doppler integration for secrets in tests
+ * - Project-specific overrides take precedence
  *
  * @param {string} [cwd=process.cwd()] - Directory to search for config
  * @returns {Promise<object>} Merged configuration
  *
  * @example
+ * // Zero-config: auto-detects tools in project
  * const config = await loadConfig();
- * console.log(config.readme.required); // ['Installation', 'Usage', 'License']
+ * // If project has vitest.config.ts, config.test.unit.command is set
  *
  * @example
- * // With custom config in kabran.config.mjs:
- * // export default { readme: { required: ['Setup', 'API'] } }
+ * // With custom config in kabran.config.mjs (overrides detected defaults):
+ * // export default { test: { unit: { command: 'npm test' } } }
  * const config = await loadConfig('/path/to/project');
- * console.log(config.readme.required); // ['Setup', 'API']
  */
 export async function loadConfig(cwd = process.cwd()) {
+  // 1. Start with static defaults (validators)
+  let config = {...DEFAULTS};
+
+  // 2. Merge detected tool defaults (CLI commands)
+  const toolDefaults = detectToolDefaults(cwd);
+  config = deepMerge(config, toolDefaults);
+
+  // 3. Merge project-specific configuration (highest priority)
   for (const fileName of CONFIG_FILES) {
     const configPath = join(cwd, fileName);
 
@@ -125,15 +276,15 @@ export async function loadConfig(cwd = process.cwd()) {
           projectConfig = await loadJsConfig(configPath);
         }
 
-        return deepMerge(DEFAULTS, projectConfig);
+        return deepMerge(config, projectConfig);
       } catch (error) {
-        // Log warning but continue with defaults
+        // Log warning but continue with detected defaults
         console.warn(`Warning: Failed to load ${fileName}: ${error.message}`);
       }
     }
   }
 
-  return DEFAULTS;
+  return config;
 }
 
 /**

package/src/scripts/setup.mjs

@@ -427,6 +427,7 @@ export function setupConfigs(projectDir, templatesDir, options) {
   // Other configs (same for all types)
   const otherConfigs = [
     {name: 'prettier.config.mjs', src: 'prettier.config.mjs'},
+    {name: '.prettierignore', src: '.prettierignore'},
     {name: 'commitlint.config.mjs', src: 'commitlint.config.mjs'},
     {name: 'lint-staged.config.mjs', src: 'lint-staged.config.mjs'},
   ];

package/templates/config/.prettierignore

@@ -0,0 +1,35 @@
+# Dependencies
+node_modules
+
+# Build outputs
+dist
+build
+out
+.next
+.nuxt
+
+# Cache directories
+.cache
+.vite
+.turbo
+.parcel-cache
+
+# Test coverage
+coverage
+
+# Package manager locks (optional - some prefer to format these)
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Auto-generated files
+*.min.js
+*.min.css
+
+# IDE and editor
+.idea
+.vscode
+
+# OS files
+.DS_Store
+Thumbs.db