) {\r\n const startTime = performance.now();\r\n \r\n return operation()\r\n .then(result => {\r\n const duration = performance.now() - startTime;\r\n logger.info(`Operation completed: ${name}`, { duration, success: true });\r\n return result;\r\n })\r\n .catch(error => {\r\n const duration = performance.now() - startTime;\r\n logger.error(`Operation failed: ${name}`, { duration, error: error.message });\r\n throw error;\r\n });\r\n}\r\n```\r\n\r\n## โ๏ธ Configuration\r\n\r\n### Environment-Based Configuration\r\n\r\n```typescript\r\nimport { getLogger, LogLevel } from '@atlantis-gr/svelte-logging-abstractions';\r\n\r\n// Configure based on environment\r\nconst isDevelopment = import.meta.env.DEV;\r\nconst rootLogger = getLogger();\r\n\r\nif (isDevelopment) {\r\n rootLogger.setLevel(LogLevel.DEBUG);\r\n} else {\r\n rootLogger.setLevel(LogLevel.WARN);\r\n}\r\n```\r\n\r\n### Custom Log Formatters\r\n\r\n```typescript\r\nimport { getLogger } from '@atlantis-gr/svelte-logging-abstractions';\r\n\r\nconst logger = getLogger();\r\n\r\n// Custom formatter (if supported by implementation)\r\nlogger.setFormatter((level, scope, message, meta) => {\r\n const timestamp = new Date().toISOString();\r\n const metaStr = meta ? ` ${JSON.stringify(meta)}` : '';\r\n return `${timestamp} [${level}] ${scope}: ${message}${metaStr}`;\r\n});\r\n```\r\n\r\n## ๐ Advanced Usage\r\n\r\n### Conditional Logging\r\n\r\n```typescript\r\nconst logger = createScopedLogger('ConditionalLogger');\r\n\r\n// Only log in development\r\nif (import.meta.env.DEV) {\r\n logger.debug('Debug information');\r\n}\r\n\r\n// Log with conditions\r\nfunction logUserAction(action: string, user: User) {\r\n if (user.isAdmin) {\r\n logger.warn(`Admin action performed: ${action}`, { userId: user.id });\r\n } else {\r\n logger.info(`User action: ${action}`, { userId: user.id });\r\n }\r\n}\r\n```\r\n\r\n### Error Boundary Logging\r\n\r\n```svelte\r\n\r\n\r\n{#if errorState}\r\n \r\n Something went wrong. Please try again.\r\n
\r\n{/if}\r\n```\r\n\r\n### Integration with Error Tracking\r\n\r\n```typescript\r\nimport { createScopedLogger } from '@atlantis-gr/svelte-logging-abstractions';\r\n\r\nconst logger = createScopedLogger('ErrorTracking');\r\n\r\n// Custom error handler that logs and reports\r\nfunction handleApplicationError(error: Error, context?: Record) {\r\n // Log locally\r\n logger.error('Application error', {\r\n message: error.message,\r\n stack: error.stack,\r\n ...context\r\n });\r\n \r\n // Report to external service (Sentry, etc.)\r\n if (typeof window !== 'undefined' && window.Sentry) {\r\n window.Sentry.captureException(error, { extra: context });\r\n }\r\n}\r\n```\r\n\r\n## ๐งช Testing\r\n\r\n### Testing with Loggers\r\n\r\n```typescript\r\nimport { createScopedLogger } from '@atlantis-gr/svelte-logging-abstractions';\r\nimport { vi } from 'vitest';\r\n\r\ndescribe('UserService', () => {\r\n let logger: Logger;\r\n \r\n beforeEach(() => {\r\n logger = createScopedLogger('UserService');\r\n // Mock console methods if needed\r\n vi.spyOn(console, 'log');\r\n vi.spyOn(console, 'warn');\r\n vi.spyOn(console, 'error');\r\n });\r\n \r\n afterEach(() => {\r\n vi.restoreAllMocks();\r\n });\r\n \r\n test('logs user creation', () => {\r\n const userService = new UserService(logger);\r\n userService.createUser({ name: 'John' });\r\n \r\n expect(console.log).toHaveBeenCalledWith(\r\n expect.stringContaining('User created')\r\n );\r\n });\r\n});\r\n```\r\n\r\n### Development vs Production\r\n\r\n```typescript\r\n// development.ts\r\nimport { getLogger, LogLevel } from '@atlantis-gr/svelte-logging-abstractions';\r\n\r\nexport function setupDevelopmentLogging() {\r\n const logger = getLogger();\r\n logger.setLevel(LogLevel.DEBUG);\r\n \r\n // Enhanced logging for development\r\n const originalError = console.error;\r\n console.error = (...args) => {\r\n logger.error('Console error', { args });\r\n originalError.apply(console, args);\r\n };\r\n}\r\n\r\n// production.ts\r\nexport function setupProductionLogging() {\r\n const logger = getLogger();\r\n logger.setLevel(LogLevel.ERROR);\r\n \r\n // Send errors to monitoring service\r\n logger.setErrorHandler((message, meta) => {\r\n // Send to monitoring service\r\n fetch('/api/logs', {\r\n method: 'POST',\r\n body: JSON.stringify({ message, meta, timestamp: new Date() })\r\n });\r\n });\r\n}\r\n```\r\n\r\n## ๐ Performance Considerations\r\n\r\n### Lazy Logging\r\n\r\n```typescript\r\nconst logger = createScopedLogger('Performance');\r\n\r\n// Expensive computation for debug info\r\nlogger.debug(() => {\r\n const expensiveData = computeExpensiveDebugInfo();\r\n return `Debug info: ${JSON.stringify(expensiveData)}`;\r\n});\r\n\r\n// Only computed if debug level is enabled\r\n```\r\n\r\n### Batched Logging\r\n\r\n```typescript\r\nclass BatchedLogger {\r\n private batch: LogEntry[] = [];\r\n private logger = createScopedLogger('BatchedLogger');\r\n \r\n constructor(private batchSize = 10, private flushInterval = 5000) {\r\n setInterval(() => this.flush(), flushInterval);\r\n }\r\n \r\n log(level: string, message: string, meta?: any) {\r\n this.batch.push({ level, message, meta, timestamp: Date.now() });\r\n \r\n if (this.batch.length >= this.batchSize) {\r\n this.flush();\r\n }\r\n }\r\n \r\n flush() {\r\n if (this.batch.length > 0) {\r\n this.logger.info('Batch log entries', { entries: this.batch });\r\n this.batch = [];\r\n }\r\n }\r\n}\r\n```\r\n\r\n## ๐ค Contributing\r\n\r\nSee [CONTRIBUTING.md](../CONTRIBUTING.md) for development setup and guidelines.\r\n\r\n## ๐ License\r\n\r\nMIT License - see [LICENSE](../LICENSE) for details.\r\n\r\n## ๐ Support\r\n\r\n- ๐ [Documentation](../README.md)\r\n- ๐ [Issue Tracker](https://github.com/your-org/svelte-components/issues)\r\n- ๐ฌ [Discussions](https://github.com/your-org/svelte-components/discussions)","readmeFilename":"README.md","_rev":"1-877cff8b5abbe74ac9bf7301bc9264b0"}