vestig 0.2.0 → 0.3.1

package/README.md

@@ -0,0 +1,321 @@
+<div align="center">
+
+# 👣 Vestig
+
+**Leave a trace.**
+
+A modern, runtime-agnostic structured logging library with automatic PII sanitization and context propagation.
+
+[![CI](https://github.com/Arakiss/vestig/actions/workflows/ci.yml/badge.svg)](https://github.com/Arakiss/vestig/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/vestig.svg)](https://www.npmjs.com/package/vestig)
+[![Tests](https://img.shields.io/badge/tests-286%20passing-brightgreen.svg)](https://github.com/Arakiss/vestig)
+[![Coverage](https://img.shields.io/badge/coverage-81%25-brightgreen.svg)](https://github.com/Arakiss/vestig)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Arakiss/vestig/blob/main/CONTRIBUTING.md)
+
+</div>
+
+---
+
+## Why Vestig?
+
+*Vestig* — from Latin *vestigium* (trace, footprint). Leave a trace of what happened.
+
+| Feature | Vestig | Pino | Winston |
+|---------|:-----:|:----:|:-------:|
+| Runtime Agnostic | ✅ | ❌ | ❌ |
+| Auto PII Sanitization | ✅ | ❌ | ❌ |
+| GDPR/HIPAA/PCI-DSS Presets | ✅ | ❌ | ❌ |
+| Zero Config | ✅ | ✅ | ❌ |
+| TypeScript First | ✅ | ✅ | ⚠️ |
+| Edge Runtime Support | ✅ | ❌ | ❌ |
+| Browser Support | ✅ | ❌ | ⚠️ |
+| Context Propagation | ✅ | ❌ | ❌ |
+| Multiple Transports | ✅ | ✅ | ✅ |
+| Zero Dependencies | ✅ | ❌ | ❌ |
+
+**Vestig is the only logging library that:**
+- Works everywhere (Node.js, Bun, Deno, Edge, Browser)
+- Automatically sanitizes PII with compliance presets
+- Propagates context through async operations
+- Has zero runtime dependencies
+
+## Installation
+
+```bash
+# bun
+bun add vestig
+
+# npm
+npm install vestig
+
+# pnpm
+pnpm add vestig
+```
+
+## Quick Start
+
+```typescript
+import { log } from 'vestig'
+
+// Simple logging
+log.info('Hello world')
+log.error('Something failed', { userId: 123 })
+
+// Sensitive data is automatically redacted
+log.info('User login', {
+  email: 'user@example.com',     // → us***@example.com
+  password: 'secret123',          // → [REDACTED]
+  creditCard: '4111111111111111', // → ****1111
+})
+```
+
+## Features
+
+### Multi-Transport Support
+
+Send logs to multiple destinations simultaneously:
+
+```typescript
+import { createLogger, ConsoleTransport, HTTPTransport, DatadogTransport } from 'vestig'
+
+const log = createLogger()
+
+// Add HTTP transport for centralized logging
+log.addTransport(new HTTPTransport({
+  name: 'api-logs',
+  url: 'https://logs.example.com/ingest',
+  headers: { 'Authorization': 'Bearer token' },
+}))
+
+// Add Datadog for observability
+log.addTransport(new DatadogTransport({
+  name: 'datadog',
+  apiKey: process.env.DD_API_KEY,
+  service: 'my-app',
+  tags: ['env:production'],
+}))
+
+// Initialize transports (starts flush timers)
+await log.init()
+
+// All logs go to console, HTTP endpoint, and Datadog
+log.info('Server started', { port: 3000 })
+```
+
+### Available Transports
+
+| Transport | Description | Use Case |
+|-----------|-------------|----------|
+| `ConsoleTransport` | Console output with colors | Development, debugging |
+| `HTTPTransport` | Send to any HTTP endpoint | Custom log aggregation |
+| `FileTransport` | Write to files with rotation | Server-side logging |
+| `DatadogTransport` | Datadog Log Management | Production observability |
+
+### PII Sanitization with Presets
+
+Choose from compliance-focused presets:
+
+```typescript
+import { Sanitizer } from 'vestig'
+
+// GDPR compliance (EU data protection)
+const gdprSanitizer = Sanitizer.fromPreset('gdpr')
+
+// HIPAA compliance (healthcare)
+const hipaaSanitizer = Sanitizer.fromPreset('hipaa')
+
+// PCI-DSS compliance (payment cards)
+const pciSanitizer = Sanitizer.fromPreset('pci-dss')
+
+// Apply to logger
+const log = createLogger({
+  sanitize: 'gdpr', // Use preset name directly
+})
+```
+
+| Preset | Fields Protected | Patterns Applied |
+|--------|-----------------|------------------|
+| `none` | None | None |
+| `minimal` | password, secret, token, key | None |
+| `default` | 26 common fields | Email, Credit Card, JWT |
+| `gdpr` | + name, address, phone, IP | + IP addresses, phone |
+| `hipaa` | + patient, medical, SSN | + SSN pattern |
+| `pci-dss` | + card, CVV, PIN | Full card detection |
+
+### Custom Sanitization
+
+```typescript
+import { Sanitizer } from 'vestig'
+
+const sanitizer = new Sanitizer({
+  fields: [
+    'customSecret',
+    { type: 'prefix', value: 'private_' },
+    { type: 'contains', value: 'token' },
+  ],
+  patterns: [{
+    name: 'internal-id',
+    pattern: /ID-[A-Z0-9]+/g,
+    replacement: '[ID_REDACTED]',
+  }],
+})
+
+const safe = sanitizer.sanitize({
+  private_key: 'abc123',     // → [REDACTED]
+  auth_token: 'xyz789',      // → [REDACTED]
+  internalId: 'ID-ABC123',   // → [ID_REDACTED]
+})
+```
+
+### Child Loggers
+
+```typescript
+const log = createLogger({ namespace: 'app' })
+const dbLog = log.child('database')
+const cacheLog = log.child('cache')
+
+dbLog.info('Query executed')  // [app:database] Query executed
+cacheLog.info('Cache hit')    // [app:cache] Cache hit
+```
+
+### Context & Correlation IDs
+
+```typescript
+import { withContext, createCorrelationContext } from 'vestig'
+
+// Next.js API Route
+export async function GET(req: Request) {
+  const context = createCorrelationContext({
+    requestId: req.headers.get('x-request-id') ?? undefined
+  })
+
+  return withContext(context, async () => {
+    log.info('Request started')
+    // All logs include: requestId, traceId, spanId
+
+    const result = await fetchData()
+    log.info('Request completed')
+
+    return Response.json(result)
+  })
+}
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+VESTIG_LEVEL=debug        # trace | debug | info | warn | error
+VESTIG_ENABLED=true       # Enable/disable logging
+VESTIG_STRUCTURED=true    # JSON output (auto-enabled in production)
+VESTIG_SANITIZE=true      # PII sanitization (default: true)
+
+# Add to context
+VESTIG_CONTEXT_SERVICE=api
+VESTIG_CONTEXT_VERSION=1.0.0
+```
+
+### Programmatic
+
+```typescript
+const log = createLogger({
+  level: 'debug',
+  enabled: true,
+  structured: false,
+  sanitize: 'gdpr',  // or true, false, or SanitizeConfig
+  context: { environment: 'development' }
+})
+```
+
+## Log Levels
+
+| Level | Description |
+|-------|-------------|
+| `trace` | Very detailed debugging information |
+| `debug` | Development debugging |
+| `info` | General information |
+| `warn` | Warning messages |
+| `error` | Error messages (includes stack traces) |
+
+## Runtime Detection
+
+Vestig automatically detects and adapts to:
+
+- **Node.js** - Full features with AsyncLocalStorage
+- **Bun** - Full features with AsyncLocalStorage
+- **Deno** - Full features with AsyncLocalStorage
+- **Edge Runtime** - Vercel Edge, Cloudflare Workers
+- **Browser** - Client-side logging with sanitization
+
+```typescript
+import { RUNTIME, IS_SERVER, IS_EDGE } from 'vestig'
+
+console.log(RUNTIME) // 'node' | 'bun' | 'deno' | 'edge' | 'browser'
+```
+
+## Auto-Production Mode
+
+In production (`NODE_ENV=production`), Vestig automatically:
+
+- Sets log level to `warn`
+- Enables structured (JSON) output
+- Keeps sanitization enabled
+
+## API Reference
+
+### `createLogger(config?)`
+
+Create a new logger instance.
+
+### `log.trace/debug/info/warn/error(message, metadata?)`
+
+Log at the specified level.
+
+### `log.child(namespace, config?)`
+
+Create a namespaced child logger.
+
+### `log.addTransport(transport)`
+
+Add a transport to the logger.
+
+### `log.removeTransport(name)`
+
+Remove a transport by name.
+
+### `log.flush()`
+
+Flush all buffered logs.
+
+### `log.destroy()`
+
+Cleanup all transports (call on shutdown).
+
+### `withContext(context, fn)`
+
+Run a function with the given context.
+
+### `createCorrelationContext(existing?)`
+
+Generate correlation IDs (requestId, traceId, spanId).
+
+### `Sanitizer.fromPreset(preset)`
+
+Create a sanitizer from a preset name.
+
+## Contributing
+
+We love contributions! Please read our [Contributing Guide](https://github.com/Arakiss/vestig/blob/main/CONTRIBUTING.md) to get started.
+
+- 🐛 [Report bugs](https://github.com/Arakiss/vestig/issues/new?template=bug_report.md)
+- 💡 [Request features](https://github.com/Arakiss/vestig/issues/new?template=feature_request.md)
+- 📖 [Improve documentation](https://github.com/Arakiss/vestig/pulls)
+
+## License
+
+MIT © [Arakiss](https://github.com/Arakiss)
+
+See [LICENSE](https://github.com/Arakiss/vestig/blob/main/LICENSE) for more details.

package/dist/context/index.d.ts

@@ -15,6 +15,9 @@ export declare function withContext<T>(context: LogContext, fn: () => T): T;
 export declare function withContextAsync<T>(context: LogContext, fn: () => Promise<T>): Promise<T>;
 /**
  * Create a new context with correlation IDs
+ *
+ * Note: We explicitly generate IDs for undefined values and don't spread
+ * the original object to avoid overwriting generated values with undefined.
  */
 export declare function createCorrelationContext(existing?: Partial<LogContext>): LogContext;
 //# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAsHnE;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,GAAG,SAAS,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEzF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAOnF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAsHnE;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,GAAG,SAAS,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAmBnF"}

package/dist/context/index.js

@@ -110,13 +110,26 @@ export function withContextAsync(context, fn) {
 }
 /**
  * Create a new context with correlation IDs
+ *
+ * Note: We explicitly generate IDs for undefined values and don't spread
+ * the original object to avoid overwriting generated values with undefined.
  */
 export function createCorrelationContext(existing) {
-    return {
-        requestId: existing?.requestId ?? generateRequestId(),
-        traceId: existing?.traceId ?? generateTraceId(),
-        spanId: existing?.spanId ?? generateSpanId(),
-        ...existing,
-    };
+    // Extract known correlation fields, generating if not provided
+    const requestId = existing?.requestId ?? generateRequestId();
+    const traceId = existing?.traceId ?? generateTraceId();
+    const spanId = existing?.spanId ?? generateSpanId();
+    // Build context with only defined extra properties
+    const context = { requestId, traceId, spanId };
+    // Add any extra properties from existing, but filter out undefined values
+    if (existing) {
+        for (const [key, value] of Object.entries(existing)) {
+            if (value !== undefined && !(key in context)) {
+                ;
+                context[key] = value;
+            }
+        }
+    }
+    return context;
 }
 //# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEpD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAElF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAWnE;;GAEG;AACH,MAAM,oBAAoB;IACjB,MAAM,CAAC,QAAQ,CAAsB;IACrC,cAAc,CAAwB;IACtC,YAAY,GAAiB,EAAE,CAAA;IAEvC,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QACjB,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC;YACpC,oBAAoB,CAAC,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAA;QAC3D,CAAC;QACD,OAAO,oBAAoB,CAAC,QAAQ,CAAA;IACrC,CAAC;IAED,GAAG;QACF,OAAO,IAAI,CAAC,cAAc,CAAA;IAC3B,CAAC;IAED,GAAG,CAAI,OAAmB,EAAE,EAAW;QACtC,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAA;QAC3C,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAA;QACxD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC3C,IAAI,CAAC;YACJ,OAAO,EAAE,EAAE,CAAA;QACZ,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAA;YACvB,IAAI,CAAC,cAAc,GAAG,eAAe,CAAA;QACtC,CAAC;IACF,CAAC;IAED,QAAQ,CAAI,OAAmB,EAAE,EAAoB;QACpD,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAA;QAC3C,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAA;QACxD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC3C,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACxB,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAA;YACvB,IAAI,CAAC,cAAc,GAAG,eAAe,CAAA;QACtC,CAAC,CAAC,CAAA;IACH,CAAC;CACD;AAED;;GAEG;AACH,MAAM,+BAA+B;IAC5B,OAAO,GAGJ,IAAI,CAAA;IAEf;QACC,0DAA0D;QAC1D,IAAI,SAAS,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;YACpD,IAAI,CAAC;gBACJ,iEAAiE;gBACjE,MAAM,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAK5C,CAAA;gBACD,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,iBAAiB,EAAc,CAAA;YAC9D,CAAC;YAAC,MAAM,CAAC;gBACR,4BAA4B;YAC7B,CAAC;QACF,CAAC;IACF,CAAC;IAED,GAAG;QACF,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAA;IAChC,CAAC;IAED,GAAG,CAAI,OAAmB,EAAE,EAAW;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,oBAAoB,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAC3D,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,QAAQ,CAAI,OAAmB,EAAE,EAAoB;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,oBAAoB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;IACxD,CAAC;CACD;AAED;;GAEG;AACH,SAAS,oBAAoB;IAC5B,IAAI,SAAS,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;QACpD,OAAO,IAAI,+BAA+B,EAAE,CAAA;IAC7C,CAAC;IACD,OAAO,oBAAoB,CAAC,WAAW,EAAE,CAAA;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAA;AAE7C;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,OAAO,cAAc,CAAC,GAAG,EAAE,CAAA;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAI,OAAmB,EAAE,EAAW;IAC9D,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAI,OAAmB,EAAE,EAAoB;IAC5E,OAAO,cAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA8B;IACtE,+DAA+D;IAC/D,MAAM,SAAS,GAAG,QAAQ,EAAE,SAAS,IAAI,iBAAiB,EAAE,CAAA;IAC5D,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,eAAe,EAAE,CAAA;IACtD,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,IAAI,cAAc,EAAE,CAAA;IAEnD,mDAAmD;IACnD,MAAM,OAAO,GAAe,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IAE1D,0EAA0E;IAC1E,IAAI,QAAQ,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC;gBAC9C,CAAC;gBAAC,OAAmC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YACnD,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC"}

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,oBAAoB,EAAE,OAAO,CAAA;IAC7B,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;CAClB;AAoED;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,OAAyB,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,mBAA0C,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,OAAO,SAAqB,CAAA;AACzC,eAAO,MAAM,MAAM,SAAoB,CAAA;AACvC,eAAO,MAAM,OAAO,SAAqB,CAAA;AACzC,eAAO,MAAM,UAAU,SAAwB,CAAA;AAC/C,eAAO,MAAM,SAAS,SAAuB,CAAA;AAC7C,eAAO,MAAM,SAAS,SAA+B,CAAA"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,oBAAoB,EAAE,OAAO,CAAA;IAC7B,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;CAClB;AAsFD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,OAAyB,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,mBAA0C,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,OAAO,SAAqB,CAAA;AACzC,eAAO,MAAM,MAAM,SAAoB,CAAA;AACvC,eAAO,MAAM,OAAO,SAAqB,CAAA;AACzC,eAAO,MAAM,UAAU,SAAwB,CAAA;AAC/C,eAAO,MAAM,SAAS,SAAuB,CAAA;AAC7C,eAAO,MAAM,SAAS,SAA+B,CAAA"}

package/dist/runtime.js

@@ -1,3 +1,16 @@
+/**
+ * Safe check for Node.js version (Edge-compatible)
+ */
+function hasNodeVersion() {
+    try {
+        // Use dynamic access to avoid static analysis
+        const p = globalThis.process;
+        return Boolean(p?.versions?.node);
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Detect the current runtime environment
  */
@@ -12,21 +25,27 @@ function detectRuntime() {
         if ('EdgeRuntime' in globalThis) {
             return 'edge';
         }
-        // Next.js Edge
-        if (typeof process !== 'undefined' && process.env?.NEXT_RUNTIME === 'edge') {
-            return 'edge';
+        // Next.js Edge - check environment variable safely
+        try {
+            const p = globalThis.process;
+            if (p?.env?.NEXT_RUNTIME === 'edge') {
+                return 'edge';
+            }
+        }
+        catch {
+            // process not available, continue checking
         }
         // Cloudflare Workers (has caches but no window/process.versions)
         if ('caches' in globalThis &&
             typeof globalThis.Request === 'function' &&
             typeof globalThis.Response === 'function' &&
             typeof window === 'undefined' &&
-            (typeof process === 'undefined' || !process.versions?.node)) {
+            !hasNodeVersion()) {
             return 'edge';
         }
     }
     // Node.js detection
-    if (typeof process !== 'undefined' && process.versions?.node && typeof window === 'undefined') {
+    if (hasNodeVersion() && typeof window === 'undefined') {
         return 'node';
     }
     // Browser detection
@@ -44,9 +63,10 @@ function detectRuntime() {
  * Detect runtime capabilities
  */
 function detectCapabilities() {
+    const hasProc = typeof globalThis.process !== 'undefined';
     return {
-        hasAsyncLocalStorage: typeof process !== 'undefined' && (RUNTIME === 'node' || RUNTIME === 'bun'),
-        hasProcess: typeof process !== 'undefined',
+        hasAsyncLocalStorage: hasProc && (RUNTIME === 'node' || RUNTIME === 'bun'),
+        hasProcess: hasProc,
         hasPerformance: typeof performance !== 'undefined',
         hasConsole: typeof console !== 'undefined',
         hasCrypto: typeof crypto !== 'undefined',

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,SAAS,aAAa;IACrB,mCAAmC;IACnC,IAAI,OAAO,UAAU,KAAK,WAAW,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAA;IACb,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE,CAAC;QACvC,sBAAsB;QACtB,IAAI,aAAa,IAAI,UAAU,EAAE,CAAC;YACjC,OAAO,MAAM,CAAA;QACd,CAAC;QACD,eAAe;QACf,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,EAAE,CAAC;YAC5E,OAAO,MAAM,CAAA;QACd,CAAC;QACD,iEAAiE;QACjE,IACC,QAAQ,IAAI,UAAU;YACtB,OAAQ,UAAsC,CAAC,OAAO,KAAK,UAAU;YACrE,OAAQ,UAAsC,CAAC,QAAQ,KAAK,UAAU;YACtE,OAAO,MAAM,KAAK,WAAW;YAC7B,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,EAC1D,CAAC;YACF,OAAO,MAAM,CAAA;QACd,CAAC;IACF,CAAC;IAED,oBAAoB;IACpB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAC/F,OAAO,MAAM,CAAA;IACd,CAAC;IAED,oBAAoB;IACpB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACtE,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,uBAAuB;IACvB,IACC,OAAO,IAAI,KAAK,WAAW;QAC3B,OAAQ,IAA2C,CAAC,aAAa,KAAK,UAAU,EAC/E,CAAC;QACF,OAAO,QAAQ,CAAA;IAChB,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB;IAC1B,OAAO;QACN,oBAAoB,EACnB,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,KAAK,CAAC;QAC5E,UAAU,EAAE,OAAO,OAAO,KAAK,WAAW;QAC1C,cAAc,EAAE,OAAO,WAAW,KAAK,WAAW;QAClD,UAAU,EAAE,OAAO,OAAO,KAAK,WAAW;QAC1C,SAAS,EAAE,OAAO,MAAM,KAAK,WAAW;KACxC,CAAA;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAY,aAAa,EAAE,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAwB,kBAAkB,EAAE,CAAA;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,KAAK,MAAM,CAAA;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,CAAA;AACvC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,KAAK,MAAM,CAAA;AACzC,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,CAAA;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,KAAK,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,IAAI,MAAM,IAAI,OAAO,CAAA"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vestig",
-	"version": "0.2.0",
+	"version": "0.3.1",
 	"description": "Leave a trace. A modern, runtime-agnostic structured logging library with automatic PII sanitization and context propagation.",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -56,13 +56,13 @@
 	"license": "MIT",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/Arakiss/sigil.git",
+		"url": "git+https://github.com/Arakiss/vestig.git",
 		"directory": "packages/vestig"
 	},
 	"bugs": {
-		"url": "https://github.com/Arakiss/sigil/issues"
+		"url": "https://github.com/Arakiss/vestig/issues"
 	},
-	"homepage": "https://github.com/Arakiss/sigil#readme",
+	"homepage": "https://github.com/Arakiss/vestig#readme",
 	"devDependencies": {
 		"typescript": "catalog:",
 		"@types/node": "catalog:"