@shellicar/winston-azure-application-insights 6.0.0-preview.1 → 6.0.0-preview.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Stephen Hellicar
+Copyright (c) 2025 Stephen Hellicar
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -1,31 +1,15 @@
 # @shellicar/winston-azure-application-insights
 
-> An [Azure Application Insights](https://azure.microsoft.com/en-us/services/application-insights/) transport for [Winston](https://github.com/winstonjs/winston) logging library.
-
-[![npm package](https://img.shields.io/npm/v/@shellicar/winston-azure-application-insights.svg)](https://npmjs.com/package/@shellicar/winston-azure-application-insights)
-[![build status](https://github.com/shellicar/winston-azure-application-insights/actions/workflows/node.js.yml/badge.svg)](https://github.com/shellicar/winston-azure-application-insights/actions/workflows/node.js.yml)
-[![AI Assisted](https://img.shields.io/badge/AI--Assisted-GitHub_Copilot-412991?logo=github)][copilot]
-
-*Tests and documentation developed with assistance from [GitHub Copilot][copilot].*
-
-> **Upgrading from v5.x?** See the [Migration Guide](#migration) for step-by-step upgrade instructions.
-
-## Features
-
-- 🔄 **Dual SDK Support** - Works with both Application Insights v2 and v3 SDKs
-- 🚀 **Simple Factory Functions** - Easy setup with `createApplicationInsightsTransport()` and `createWinstonLogger()`  
-- 🔍 **Automatic Error Detection** - Extracts Error objects from logs and sends them as Application Insights exceptions
-- 📊 **Trace + Exception Logging** - Sends logs as traces while also tracking errors as detailed exceptions
-- 🎯 **Flexible Filtering** - Optional trace and exception filters for fine-grained control
-- 🔧 **Custom Severity Mapping** - Map Winston levels to Application Insights severity levels
-- 🏠 **Local Development** - Log to console locally while sending to Application Insights in production
+An [Azure Application Insights](https://azure.microsoft.com/en-us/services/application-insights/) transport for [Winston](https://github.com/winstonjs/winston) logging library
 
 ## Installation & Quick Start
 
 ```sh
-pnpm add @shellicar/winston-azure-application-insights
+npm install @shellicar/winston-azure-application-insights
 ```
 
+## Quick Example
+
 ```typescript
 import { createWinstonLogger, ApplicationInsightsVersion } from '@shellicar/winston-azure-application-insights';
 import applicationinsights from 'applicationinsights';
@@ -38,246 +22,11 @@ const logger = createWinstonLogger({
     client: applicationinsights.defaultClient
   },
 });
-logger.info('Hello World');
-```
-
-For more advanced usage and configuration, see the [examples](./examples) directory.
-
-## Motivation
-
-When logging directly to Application Insights using the telemetry client, it makes debugging locally more difficult. Logging to console pollutes logs in Azure, so this provides a compromise.
-
-I forked the original library to add support for Application Insights v3, which is relatively recent. I have also refactored it to handle certain error logging scenarios that weren't working as expected.
-
-## Feature Examples
-
-- **Factory Functions** - Simple setup with clean API.
-
-```typescript
-import applicationinsights from 'applicationinsights';
-import { createApplicationInsightsTransport, ApplicationInsightsVersion } from '@shellicar/winston-azure-application-insights';
-
-applicationinsights.setup().start();
-
-const transport = createApplicationInsightsTransport({
-  version: ApplicationInsightsVersion.V3,
-  client: applicationinsights.defaultClient,
-});
-```
-
-- **Complete Logger Setup** - Create a Winston logger with both console and Application Insights.
-
-```typescript
-import { createWinstonLogger, ApplicationInsightsVersion } from '@shellicar/winston-azure-application-insights';
-import applicationinsights from 'applicationinsights';
-
-const logger = createWinstonLogger({
-  winston: {
-    console: {
-      enabled: true,
-      format: {
-        output: 'json',
-        timestamp: true,
-        errors: true,
-        colorize: true,
-      },
-    },
-    defaults: {
-      level: 'info',
-    },
-  },
-  insights: {
-    version: ApplicationInsightsVersion.V3,
-    client: applicationinsights.defaultClient,
-  },
-});
-
-logger.info('Application started');
-```
-
-- **Error Extraction** - Automatically detects Error objects and sends them as exceptions.
-
-```typescript
-// Creates trace only
-logger.error('Something went wrong');
-
-// Creates EXCEPTION ONLY (no trace) - when first parameter is Error
-logger.error(new Error('Database error'));
-
-// Creates trace + exception (Error extracted from additional parameters)
-logger.error('Operation failed', new Error('Timeout'));
-
-// Creates trace + two exceptions (multiple Error objects)
-logger.error('Multiple failures', new Error('DB error'), new Error('Cache error'));
-```
-
-**Key Behaviour:** When you log an Error as the first parameter (`logger.error(new Error())`), it sends **only the exception** to Application Insights, not a trace. This avoids duplicate telemetry.
-
-- **Properties Extraction** - Winston splat parameters become telemetry properties.
-
-```typescript
-// Simple properties
-logger.info('User logged in', { userId: 123, action: 'login' });
-
-// Mixed types - Error objects are extracted, others become properties
-logger.error('Complex operation failed', { userId: 123, operation: 'checkout' }, new Error('Payment failed'));
-```
-
-- **Severity Mapping** - Winston levels map to Application Insights severity with priority fallback.
-
-```typescript
-logger.error('Critical issue');   // → Error
-logger.warn('Warning message');   // → Warning
-logger.info('Info message');      // → Information
-logger.verbose('Debug info');     // → Verbose
-
-// Custom levels fall back to next available mapping
-logger.log('audit', 'Audit event'); // → Falls back based on level priority
-```
-
-- **Custom Severity Mapping** - Override default level mappings.
-
-```typescript
-const transport = createApplicationInsightsTransport({
-  version: ApplicationInsightsVersion.V3,
-  client: defaultClient,
-  severityMapping: {
-    error: TelemetrySeverity.Error,
-    warn: TelemetrySeverity.Warning,
-    info: TelemetrySeverity.Information,
-    debug: TelemetrySeverity.Verbose,
-    // Custom levels
-    audit: TelemetrySeverity.Critical,
-    security: TelemetrySeverity.Error,
-  },
-});
-```
-
-- **Dual SDK Support** - Works with both Application Insights v2 and v3.
-
-```typescript
-// Application Insights v2
-import applicationinsights from 'applicationinsights'; // v2
-const transport = createApplicationInsightsTransport({
-  version: ApplicationInsightsVersion.V2,
-  client: applicationinsights.defaultClient,
-});
-
-// Application Insights v3
-import applicationinsights from 'applicationinsights'; // v3
-const transport = createApplicationInsightsTransport({
-  version: ApplicationInsightsVersion.V3,
-  client: applicationinsights.defaultClient,
-});
-```
-
-- **Filtering** - Optional filters for traces and exceptions.
-
-```typescript
-const transport = createApplicationInsightsTransport({
-  version: ApplicationInsightsVersion.V3,
-  client: defaultClient,
-  traceFilter: (trace) => trace.severity !== KnownSeverityLevel.Verbose,
-  exceptionFilter: (exception) => !exception.exception.message.includes('ignore'),
-});
-```
-
-- **Disable Exception Tracking** - Customise error detection logic.
-
-```typescript
-const transport = createApplicationInsightsTransport({
-  version: 3,
-  client: defaultClient,
-  // Custom function to determine what counts as an error
-  isError: (obj) => obj instanceof CustomError,
-});
-```
-
-<!-- BEGIN_ECOSYSTEM -->
-
-## @shellicar TypeScript Ecosystem
-
-### Core Libraries
-
-- [`@shellicar/core-config`](https://github.com/shellicar/core-config) - A library for securely handling sensitive configuration values like connection strings, URLs, and secrets.
-- [`@shellicar/core-di`](https://github.com/shellicar/core-di) - A basic dependency injection library.
-
-### Reference Architectures
-
-- [`@shellicar/reference-foundation`](https://github.com/shellicar/reference-foundation) - A comprehensive starter repository. Illustrates individual concepts.
-- [`@shellicar/reference-enterprise`](https://github.com/shellicar/reference-enterprise) - A comprehensive starter repository. Can be used as the basis for creating a new Azure application workload.
-
-### Build Tools
-
-- [`@shellicar/build-version`](https://github.com/shellicar/build-version) - Build plugin that calculates and exposes version information through a virtual module import.
-- [`@shellicar/build-graphql`](https://github.com/shellicar/build-graphql) - Build plugin that loads GraphQL files and makes them available through a virtual module import.
-
-### Framework Adapters
 
-- [`@shellicar/svelte-adapter-azure-functions`](https://github.com/shellicar/svelte-adapter-azure-functions) - A [SvelteKit adapter](https://kit.svelte.dev/docs/adapters) that builds your app into an Azure Function.
-
-### Logging & Monitoring
-
-- [`@shellicar/winston-azure-application-insights`](https://github.com/shellicar/winston-azure-application-insights) - An [Azure Application Insights](https://azure.microsoft.com/en-us/services/application-insights/) transport for [Winston](https://github.com/winstonjs/winston) logging library.
-- [`@shellicar/pino-applicationinsights-transport`](https://github.com/shellicar/pino-applicationinsights-transport) - [Azure Application Insights](https://azure.microsoft.com/en-us/services/application-insights) transport for [pino](https://github.com/pinojs/pino)
-
-<!-- END_ECOSYSTEM -->
-
-## Configuration Options
-
-- **version**: `ApplicationInsightsVersion.V2` or `ApplicationInsightsVersion.V3` - Application Insights SDK version (required)
-- **client**: Application Insights client instance (required)
-- **telemetryHandler**: Custom telemetry handler function (instead of version and client)
-- **isError**: Custom function to determine what counts as an error (default: detects Error instances)
-- **severityMapping**: Custom Winston level to Application Insights severity mapping
-- **traceFilter**: Optional function to filter traces before sending
-- **exceptionFilter**: Optional function to filter exceptions before sending
-
-### Troubleshooting
-
-#### Missing Connection String
-
-```txt
-No instrumentation key or connection string was provided
-```
-
-Set the connection string via environment variable or setup parameter. See the [Application Insights setup guide](https://github.com/microsoft/ApplicationInsights-node.js?tab=readme-ov-file#get-started) for detailed instructions.
-
-#### Duplicate API Registration
-
-```txt
-Attempted duplicate registration of API: context
-```
-
-Your environment already loaded Application Insights. Use the existing client without calling setup():
-
-```typescript
-import applicationinsights from 'applicationinsights';
-const transport = createApplicationInsightsTransport({
-  version: ApplicationInsightsVersion.V3,
-  client: applicationinsights.defaultClient,
-});
-```
-
-#### Multiple/Duplicate Traces
-
-Application Insights auto-collects from console and Winston. Disable auto-collection:
-
-```typescript
-setup().setAutoCollectConsole(false).start();
+logger.info('Hello World');
+logger.error('Something went wrong', new Error('Database connection failed'));
 ```
 
-## Migration
-
-### Upgrading from v5.x to v6.x
-
-v6.x includes significant improvements to error handling, type safety, and configuration structure. See the complete [Migration Guide](./MIGRATION.md) for detailed upgrade instructions.
-
-## Credits & Inspiration
-
-- [willmorgan/winston-azure-application-insights](https://github.com/willmorgan/winston-azure-application-insights) - Forked from willmorgan's version
-- [bragma/winston-azure-application-insights](https://github.com/bragma/winston-azure-application-insights) - Original library by bragma
-- [Winston](https://github.com/winstonjs/winston) - Universal logging library for Node.js
-- [Azure Application Insights](https://azure.microsoft.com/en-us/services/application-insights/) - Application Performance Management service
+## Documentation
 
-[copilot]: https://github.com/features/copilot
+For full documentation, visit the [GitHub repository](https://github.com/shellicar/winston-azure-application-insights).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shellicar/winston-azure-application-insights",
-  "version": "6.0.0-preview.1",
+  "version": "6.0.0-preview.2",
   "private": false,
   "description": "Azure Application Insights transport for Winston",
   "type": "module",
@@ -30,35 +30,25 @@
     "insights",
     "logging"
   ],
-  "author": "Marco Braga (Bragma)",
+  "author": "Stephen Hellicar",
   "contributors": [
-    {
-      "name": "Will Morgan",
-      "email": "jobs+npm@willmorgan.co.uk",
-      "url": "http://willmorgan.co.uk"
-    },
     {
       "name": "Stephen Hellicar",
-      "email": "shellicar@gmail.com"
+      "email": "shellicar@gmail.com",
+      "url": "https://stephen-hellicar.com.au/"
     }
   ],
   "license": "MIT",
   "devDependencies": {
-    "@biomejs/biome": "^2.2.0",
     "@types/node": "^24.3.0",
     "@types/triple-beam": "^1.3.5",
     "@vitest/coverage-v8": "^3.2.4",
-    "lefthook": "^1.12.3",
     "logform": "^2.7.0",
-    "npm-check-updates": "^18.0.2",
-    "npm-run-all2": "^8.0.4",
-    "syncpack": "^13.0.4",
     "terser": "^5.43.1",
     "testdouble": "^3.20.2",
     "triple-beam": "^1.4.1",
     "tsup": "^8.5.0",
-    "tsx": "^4.20.4",
-    "turbo": "^2.5.6",
+    "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
     "winston": "^3.17.0",
@@ -82,21 +72,9 @@
     "demo": "tsx demo.ts",
     "build": "tsup-node",
     "watch": "tsup-node --watch",
-    "lint": "biome lint",
-    "format": "biome format",
-    "check": "biome check",
     "type-check": "tsc -p tsconfig.check.json",
-    "ci": "run-s ci:biome ci:type-check",
-    "ci:biome": "biome ci --diagnostic-level=error",
-    "ci:type-check": "turbo run type-check",
-    "ci:fix": "biome check --diagnostic-level=error --fix",
     "test": "vitest run",
     "coverage": "vitest run --coverage",
-    "test:coverage": "vitest run --coverage",
-    "list-mismatches": "syncpack list-mismatches",
-    "fix-mismatches": "syncpack fix-mismatches",
-    "updates": "npm-check-updates --workspaces",
-    "postinstall": "lefthook install",
-    "verify-version": "./scripts/verify-version.sh"
+    "test:coverage": "vitest run --coverage"
   }
 }