create-fluxstack 1.10.1 → 1.12.0

package/core/utils/index.ts

@@ -1,18 +1,18 @@
-/**
- * FluxStack Utilities
- * Main exports for utility functions and classes
- */
-
-// Logger utilities
-export { logger, log } from "./logger"
-export type { Logger } from "./logger/index"
-
-// Error handling
-export * from "./errors"
-
-// Monitoring
-export { MetricsCollector } from "./monitoring"
-export type * from "./monitoring"
-
-// General helpers
+/**
+ * FluxStack Utilities
+ * Main exports for utility functions and classes
+ */
+
+// Logger utilities
+export { logger, log } from "./logger"
+export type { Logger } from "./logger/index"
+
+// Error handling
+export * from "./errors"
+
+// Monitoring
+export { MetricsCollector } from "./monitoring"
+export type * from "./monitoring"
+
+// General helpers
 export * from "./helpers"

package/core/utils/logger/colors.ts

@@ -1,114 +1,114 @@
-/**
- * FluxStack Logger - Color Management
- * Generates unique colors for each module
- */
-
-import chalk, { type ChalkInstance } from 'chalk'
-
-// Cache for module colors  
-const moduleColors = new Map<string, ChalkInstance>()
-
-/**
- * Pre-defined colors for common modules
- */
-const COMMON_MODULE_COLORS: Record<string, string> = {
-  api: '#4CAF50',      // Green
-  db: '#2196F3',       // Blue
-  auth: '#FF9800',     // Orange
-  user: '#9C27B0',     // Purple
-  config: '#00BCD4',   // Cyan
-  utils: '#607D8B',    // Blue Gray
-  routes: '#E91E63',   // Pink
-  controllers: '#3F51B5', // Indigo
-  models: '#009688',   // Teal
-  services: '#FF5722', // Deep Orange
-  plugins: '#673AB7',  // Deep Purple
-  middleware: '#795548', // Brown
-  live: '#00E676',     // Green Accent
-  websocket: '#00B0FF', // Light Blue Accent
-  build: '#FFC107',    // Amber
-  cli: '#CDDC39'       // Lime
-}
-
-/**
- * Symbols for different log levels
- */
-export const LOG_SYMBOLS = {
-  error: chalk.red('✖'),
-  warn: chalk.yellow('⚠'),
-  info: chalk.blue('ℹ'),
-  debug: chalk.magenta('⬤'),
-  default: chalk.gray('•')
-} as const
-
-/**
- * Colors for different log levels
- */
-export const LEVEL_COLORS = {
-  error: chalk.bold.red,
-  warn: chalk.bold.yellow,
-  info: chalk.bold.blue,
-  debug: chalk.bold.magenta,
-  default: chalk.bold.gray
-} as const
-
-/**
- * Generate a unique color for a module based on its name
- */
-export function getColorForModule(moduleName: string): ChalkInstance {
-  // Check cache first
-  if (moduleColors.has(moduleName)) {
-    return moduleColors.get(moduleName)!
-  }
-
-  // Check if module name contains a common module keyword
-  for (const [key, hexColor] of Object.entries(COMMON_MODULE_COLORS)) {
-    if (moduleName.toLowerCase().includes(key)) {
-      const color = chalk.hex(hexColor)
-      moduleColors.set(moduleName, color)
-      return color
-    }
-  }
-
-  // Generate color from module name hash
-  let hash = 0
-  for (let i = 0; i < moduleName.length; i++) {
-    hash = moduleName.charCodeAt(i) + ((hash << 5) - hash)
-  }
-
-  // Generate pleasant color using HSL
-  const h = Math.abs(hash) % 360
-  const s = 65 + (Math.abs(hash) % 20) // Saturation 65-85%
-  const l = 45 + (Math.abs(hash) % 15) // Lightness 45-60%
-
-  const hexColor = hslToHex(h, s, l)
-  const color = chalk.hex(hexColor)
-
-  moduleColors.set(moduleName, color)
-  return color
-}
-
-/**
- * Convert HSL to Hex color
- */
-function hslToHex(h: number, s: number, l: number): string {
-  s /= 100
-  l /= 100
-
-  const k = (n: number) => (n + h / 30) % 12
-  const a = s * Math.min(l, 1 - l)
-  const f = (n: number) => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)))
-
-  const r = Math.round(255 * f(0))
-  const g = Math.round(255 * f(8))
-  const b = Math.round(255 * f(4))
-
-  return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`
-}
-
-/**
- * Clear color cache (useful for testing)
- */
-export function clearColorCache(): void {
-  moduleColors.clear()
-}
+/**
+ * FluxStack Logger - Color Management
+ * Generates unique colors for each module
+ */
+
+import chalk, { type ChalkInstance } from 'chalk'
+
+// Cache for module colors  
+const moduleColors = new Map<string, ChalkInstance>()
+
+/**
+ * Pre-defined colors for common modules
+ */
+const COMMON_MODULE_COLORS: Record<string, string> = {
+  api: '#4CAF50',      // Green
+  db: '#2196F3',       // Blue
+  auth: '#FF9800',     // Orange
+  user: '#9C27B0',     // Purple
+  config: '#00BCD4',   // Cyan
+  utils: '#607D8B',    // Blue Gray
+  routes: '#E91E63',   // Pink
+  controllers: '#3F51B5', // Indigo
+  models: '#009688',   // Teal
+  services: '#FF5722', // Deep Orange
+  plugins: '#673AB7',  // Deep Purple
+  middleware: '#795548', // Brown
+  live: '#00E676',     // Green Accent
+  websocket: '#00B0FF', // Light Blue Accent
+  build: '#FFC107',    // Amber
+  cli: '#CDDC39'       // Lime
+}
+
+/**
+ * Symbols for different log levels
+ */
+export const LOG_SYMBOLS = {
+  error: chalk.red('✖'),
+  warn: chalk.yellow('⚠'),
+  info: chalk.blue('ℹ'),
+  debug: chalk.magenta('⬤'),
+  default: chalk.gray('•')
+} as const
+
+/**
+ * Colors for different log levels
+ */
+export const LEVEL_COLORS = {
+  error: chalk.bold.red,
+  warn: chalk.bold.yellow,
+  info: chalk.bold.blue,
+  debug: chalk.bold.magenta,
+  default: chalk.bold.gray
+} as const
+
+/**
+ * Generate a unique color for a module based on its name
+ */
+export function getColorForModule(moduleName: string): ChalkInstance {
+  // Check cache first
+  if (moduleColors.has(moduleName)) {
+    return moduleColors.get(moduleName)!
+  }
+
+  // Check if module name contains a common module keyword
+  for (const [key, hexColor] of Object.entries(COMMON_MODULE_COLORS)) {
+    if (moduleName.toLowerCase().includes(key)) {
+      const color = chalk.hex(hexColor)
+      moduleColors.set(moduleName, color)
+      return color
+    }
+  }
+
+  // Generate color from module name hash
+  let hash = 0
+  for (let i = 0; i < moduleName.length; i++) {
+    hash = moduleName.charCodeAt(i) + ((hash << 5) - hash)
+  }
+
+  // Generate pleasant color using HSL
+  const h = Math.abs(hash) % 360
+  const s = 65 + (Math.abs(hash) % 20) // Saturation 65-85%
+  const l = 45 + (Math.abs(hash) % 15) // Lightness 45-60%
+
+  const hexColor = hslToHex(h, s, l)
+  const color = chalk.hex(hexColor)
+
+  moduleColors.set(moduleName, color)
+  return color
+}
+
+/**
+ * Convert HSL to Hex color
+ */
+function hslToHex(h: number, s: number, l: number): string {
+  s /= 100
+  l /= 100
+
+  const k = (n: number) => (n + h / 30) % 12
+  const a = s * Math.min(l, 1 - l)
+  const f = (n: number) => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)))
+
+  const r = Math.round(255 * f(0))
+  const g = Math.round(255 * f(8))
+  const b = Math.round(255 * f(4))
+
+  return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`
+}
+
+/**
+ * Clear color cache (useful for testing)
+ */
+export function clearColorCache(): void {
+  moduleColors.clear()
+}

package/core/utils/logger/config.ts

@@ -3,10 +3,11 @@
  * Re-export from declarative config
  */
 
-import { loggerConfig } from '@/config/logger.config'
+import { loggerConfig } from '@config'
 
 export interface LoggerConfig {
   level: 'debug' | 'info' | 'warn' | 'error'
+  format: 'pretty' | 'json'
   dateFormat: string
   logToFile: boolean
   maxSize: string
@@ -14,6 +15,7 @@ export interface LoggerConfig {
   objectDepth: number
   enableColors: boolean
   enableStackTrace: boolean
+  transports: string[]
 }
 
 /**
@@ -21,14 +23,16 @@ export interface LoggerConfig {
  */
 export function getLoggerConfig(): LoggerConfig {
   return {
-    level: loggerConfig.level,
-    dateFormat: loggerConfig.dateFormat,
-    logToFile: loggerConfig.logToFile,
-    maxSize: loggerConfig.maxSize,
-    maxFiles: loggerConfig.maxFiles,
-    objectDepth: loggerConfig.objectDepth,
-    enableColors: loggerConfig.enableColors,
-    enableStackTrace: loggerConfig.enableStackTrace
+    level: loggerConfig.level ?? 'info',
+    format: (loggerConfig as any).format ?? 'pretty',
+    dateFormat: loggerConfig.dateFormat ?? 'YYYY-MM-DD HH:mm:ss',
+    logToFile: loggerConfig.logToFile ?? false,
+    maxSize: loggerConfig.maxSize ?? '20m',
+    maxFiles: loggerConfig.maxFiles ?? '14d',
+    objectDepth: loggerConfig.objectDepth ?? 4,
+    enableColors: loggerConfig.enableColors ?? true,
+    enableStackTrace: loggerConfig.enableStackTrace ?? true,
+    transports: (loggerConfig as any).transports ?? ['console']
   }
 }
 

package/core/utils/logger/formatter.ts

@@ -1,82 +1,82 @@
-/**
- * FluxStack Logger - Message Formatter
- * Formats log messages with proper object inspection
- */
-
-import { inspect } from 'util'
-import { LOGGER_CONFIG } from './config'
-
-/**
- * Format a log message with proper object inspection
- */
-export function formatMessage(message: unknown, args: unknown[] = []): string {
-  const inspectOptions = {
-    depth: LOGGER_CONFIG.objectDepth,
-    colors: LOGGER_CONFIG.enableColors,
-    compact: false,
-    breakLength: 100
-  }
-
-  // Format the main message
-  let formattedMessage: string
-
-  if (typeof message === 'string') {
-    formattedMessage = message
-  } else if (message instanceof Error) {
-    // Special handling for Error objects
-    formattedMessage = `${message.name}: ${message.message}\n${message.stack || ''}`
-  } else if (typeof message === 'object' && message !== null) {
-    // Use util.inspect for better object formatting
-    formattedMessage = inspect(message, inspectOptions)
-  } else {
-    formattedMessage = String(message)
-  }
-
-  // Format additional arguments (skip undefined values)
-  if (args.length > 0) {
-    const formattedArgs = args
-      .filter(arg => arg !== undefined) // Skip undefined values
-      .map(arg => {
-        if (typeof arg === 'object' && arg !== null) {
-          return inspect(arg, inspectOptions)
-        }
-        return String(arg)
-      })
-      .join(' ')
-
-    // Only add formatted args if there are any after filtering
-    if (formattedArgs.length > 0) {
-      return `${formattedMessage} ${formattedArgs}`
-    }
-  }
-
-  return formattedMessage
-}
-
-/**
- * Format a section title
- */
-export function formatSection(title: string): string {
-  return `=== ${title.toUpperCase()} ===`
-}
-
-/**
- * Format an important message
- */
-export function formatImportant(title: string): string {
-  return `■ ${title.toUpperCase()} ■`
-}
-
-/**
- * Format operation start
- */
-export function formatOperationStart(operation: string): string {
-  return `▶ INICIANDO: ${operation}`
-}
-
-/**
- * Format operation success
- */
-export function formatOperationSuccess(operation: string): string {
-  return `✓ CONCLUÍDO: ${operation}`
-}
+/**
+ * FluxStack Logger - Message Formatter
+ * Formats log messages with proper object inspection
+ */
+
+import { inspect } from 'util'
+import { LOGGER_CONFIG } from './config'
+
+/**
+ * Format a log message with proper object inspection
+ */
+export function formatMessage(message: unknown, args: unknown[] = []): string {
+  const inspectOptions = {
+    depth: LOGGER_CONFIG.objectDepth,
+    colors: LOGGER_CONFIG.enableColors,
+    compact: false,
+    breakLength: 100
+  }
+
+  // Format the main message
+  let formattedMessage: string
+
+  if (typeof message === 'string') {
+    formattedMessage = message
+  } else if (message instanceof Error) {
+    // Special handling for Error objects
+    formattedMessage = `${message.name}: ${message.message}\n${message.stack || ''}`
+  } else if (typeof message === 'object' && message !== null) {
+    // Use util.inspect for better object formatting
+    formattedMessage = inspect(message, inspectOptions)
+  } else {
+    formattedMessage = String(message)
+  }
+
+  // Format additional arguments (skip undefined values)
+  if (args.length > 0) {
+    const formattedArgs = args
+      .filter(arg => arg !== undefined) // Skip undefined values
+      .map(arg => {
+        if (typeof arg === 'object' && arg !== null) {
+          return inspect(arg, inspectOptions)
+        }
+        return String(arg)
+      })
+      .join(' ')
+
+    // Only add formatted args if there are any after filtering
+    if (formattedArgs.length > 0) {
+      return `${formattedMessage} ${formattedArgs}`
+    }
+  }
+
+  return formattedMessage
+}
+
+/**
+ * Format a section title
+ */
+export function formatSection(title: string): string {
+  return `=== ${title.toUpperCase()} ===`
+}
+
+/**
+ * Format an important message
+ */
+export function formatImportant(title: string): string {
+  return `■ ${title.toUpperCase()} ■`
+}
+
+/**
+ * Format operation start
+ */
+export function formatOperationStart(operation: string): string {
+  return `▶ INICIANDO: ${operation}`
+}
+
+/**
+ * Format operation success
+ */
+export function formatOperationSuccess(operation: string): string {
+  return `✓ CONCLUÍDO: ${operation}`
+}

package/core/utils/logger/group-logger.ts

@@ -1,101 +1,101 @@
-/**
- * FluxStack Logger - Grouped/Collapsible Logs
- * Creates beautiful grouped console output
- */
-
-import chalk from 'chalk'
-
-export interface GroupOptions {
-  title: string
-  icon?: string
-  collapsed?: boolean
-  color?: 'cyan' | 'green' | 'yellow' | 'blue' | 'magenta' | 'gray'
-}
-
-/**
- * Start a log group (collapsible in browsers, indented in terminal)
- */
-export function startGroup(options: GroupOptions): void {
-  const { title, icon = '📦', collapsed = false, color = 'cyan' } = options
-
-  // Check if we're in a browser-like environment (has console.group)
-  if (typeof console.groupCollapsed === 'function' && typeof console.group === 'function') {
-    const coloredTitle = chalk[color].bold(`${icon} ${title}`)
-
-    if (collapsed) {
-      console.groupCollapsed(coloredTitle)
-    } else {
-      console.group(coloredTitle)
-    }
-  } else {
-    // Terminal fallback - use box drawing
-    const coloredTitle = chalk[color].bold(`${icon} ${title}`)
-    console.log('\n' + coloredTitle)
-    console.log(chalk.gray('─'.repeat(Math.min(title.length + 4, 60))))
-  }
-}
-
-/**
- * End a log group
- */
-export function endGroup(): void {
-  if (typeof console.groupEnd === 'function') {
-    console.groupEnd()
-  } else {
-    // Terminal fallback - just add spacing
-    console.log('')
-  }
-}
-
-/**
- * Log within a group
- */
-export function logInGroup(message: string, icon?: string): void {
-  const prefix = icon ? `${icon} ` : '  '
-  console.log(chalk.gray(prefix) + message)
-}
-
-/**
- * Helper: Auto-group function that handles start/end automatically
- */
-export async function withGroup<T>(
-  options: GroupOptions,
-  callback: () => T | Promise<T>
-): Promise<T> {
-  startGroup(options)
-  try {
-    const result = await callback()
-    return result
-  } finally {
-    endGroup()
-  }
-}
-
-/**
- * Helper: Create a summary line for groups
- */
-export function groupSummary(count: number, itemName: string, icon: string = '✓'): void {
-  // itemName should already include proper pluralization
-  const message = `${icon} ${count} ${itemName}`
-  console.log(chalk.green.bold(message))
-}
-
-/**
- * Create a boxed section for important info
- */
-export function logBox(title: string, content: string[], options: { color?: 'cyan' | 'green' | 'yellow' } = {}): void {
-  const { color = 'cyan' } = options
-  const maxWidth = Math.max(title.length, ...content.map(c => c.length)) + 4
-
-  console.log('')
-  console.log(chalk[color]('┌' + '─'.repeat(maxWidth) + '┐'))
-  console.log(chalk[color]('│ ') + chalk.bold(title.padEnd(maxWidth - 2)) + chalk[color](' │'))
-  console.log(chalk[color]('├' + '─'.repeat(maxWidth) + '┤'))
-
-  for (const line of content) {
-    console.log(chalk[color]('│ ') + line.padEnd(maxWidth - 2) + chalk[color](' │'))
-  }
-
-  console.log(chalk[color]('└' + '─'.repeat(maxWidth) + '┘'))
-  console.log('')
-}
+/**
+ * FluxStack Logger - Grouped/Collapsible Logs
+ * Creates beautiful grouped console output
+ */
+
+import chalk from 'chalk'
+
+export interface GroupOptions {
+  title: string
+  icon?: string
+  collapsed?: boolean
+  color?: 'cyan' | 'green' | 'yellow' | 'blue' | 'magenta' | 'gray'
+}
+
+/**
+ * Start a log group (collapsible in browsers, indented in terminal)
+ */
+export function startGroup(options: GroupOptions): void {
+  const { title, icon = '📦', collapsed = false, color = 'cyan' } = options
+
+  // Check if we're in a browser-like environment (has console.group)
+  if (typeof console.groupCollapsed === 'function' && typeof console.group === 'function') {
+    const coloredTitle = chalk[color].bold(`${icon} ${title}`)
+
+    if (collapsed) {
+      console.groupCollapsed(coloredTitle)
+    } else {
+      console.group(coloredTitle)
+    }
+  } else {
+    // Terminal fallback - use box drawing
+    const coloredTitle = chalk[color].bold(`${icon} ${title}`)
+    console.log('\n' + coloredTitle)
+    console.log(chalk.gray('─'.repeat(Math.min(title.length + 4, 60))))
+  }
+}
+
+/**
+ * End a log group
+ */
+export function endGroup(): void {
+  if (typeof console.groupEnd === 'function') {
+    console.groupEnd()
+  } else {
+    // Terminal fallback - just add spacing
+    console.log('')
+  }
+}
+
+/**
+ * Log within a group
+ */
+export function logInGroup(message: string, icon?: string): void {
+  const prefix = icon ? `${icon} ` : '  '
+  console.log(chalk.gray(prefix) + message)
+}
+
+/**
+ * Helper: Auto-group function that handles start/end automatically
+ */
+export async function withGroup<T>(
+  options: GroupOptions,
+  callback: () => T | Promise<T>
+): Promise<T> {
+  startGroup(options)
+  try {
+    const result = await callback()
+    return result
+  } finally {
+    endGroup()
+  }
+}
+
+/**
+ * Helper: Create a summary line for groups
+ */
+export function groupSummary(count: number, itemName: string, icon: string = '✓'): void {
+  // itemName should already include proper pluralization
+  const message = `${icon} ${count} ${itemName}`
+  console.log(chalk.green.bold(message))
+}
+
+/**
+ * Create a boxed section for important info
+ */
+export function logBox(title: string, content: string[], options: { color?: 'cyan' | 'green' | 'yellow' } = {}): void {
+  const { color = 'cyan' } = options
+  const maxWidth = Math.max(title.length, ...content.map(c => c.length)) + 4
+
+  console.log('')
+  console.log(chalk[color]('┌' + '─'.repeat(maxWidth) + '┐'))
+  console.log(chalk[color]('│ ') + chalk.bold(title.padEnd(maxWidth - 2)) + chalk[color](' │'))
+  console.log(chalk[color]('├' + '─'.repeat(maxWidth) + '┤'))
+
+  for (const line of content) {
+    console.log(chalk[color]('│ ') + line.padEnd(maxWidth - 2) + chalk[color](' │'))
+  }
+
+  console.log(chalk[color]('└' + '─'.repeat(maxWidth) + '┘'))
+  console.log('')
+}