wyrm-mcp 3.2.0

package/dist/license.js

@@ -0,0 +1,405 @@
+/**
+ * Wyrm License System
+ * ED25519 license key generation, signing, and offline verification
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary - See LICENSE file for details.
+ * @module license
+ * @version 3.2.0
+ */
+import { createPrivateKey, createPublicKey, sign, verify, generateKeyPairSync, randomBytes, } from 'crypto';
+import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+// ==================== CONSTANTS ====================
+/** Base32 alphabet without visually-ambiguous characters (no I, L, O, 1) */
+const BASE32_ALPHABET = 'ABCDEFGHJKMNPQRSTUVWXYZ234567890';
+/** License key prefix */
+const KEY_PREFIX = 'WRM';
+/** Bytes of entropy per key segment (4 chars each) */
+const KEY_SEGMENT_COUNT = 4;
+const KEY_SEGMENT_LENGTH = 4;
+/** License file location */
+const WYRM_DIR = join(homedir(), '.wyrm');
+const LICENSE_PATH = join(WYRM_DIR, 'license.json');
+/**
+ * Feature gates per tier.
+ * Each tier inherits all features from lower tiers plus its own additions.
+ */
+export const TIER_FEATURES = {
+    free: ['local_storage', 'all_tools', 'fts_search', 'unlimited_projects'],
+    pro: ['cloud_backup', 'encryption', 'analytics', 'priority_support'],
+    team: ['shared_memory', 'workspaces', 'admin_dashboard', 'slack_integration'],
+    enterprise: ['unlimited_seats', 'sso_saml', 'custom_sla', 'on_premise'],
+};
+/** Ordered tiers for cumulative feature resolution */
+const TIER_ORDER = ['free', 'pro', 'team', 'enterprise'];
+/** Default device limits per tier */
+export const TIER_DEVICE_LIMITS = {
+    free: 1,
+    pro: 1,
+    team: 25,
+    enterprise: -1,
+};
+/**
+ * Embedded public key for offline verification.
+ * Replace this PEM after running `generateKeyPair()` for the first time.
+ */
+const WYRM_PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
+MCowBQYDK2VwAyEAVALIDKEYWILLBEPLACEDHEREAFTERGEN00000000000=
+-----END PUBLIC KEY-----`;
+// ==================== SINGLETON STATE ====================
+let currentLicense = null;
+let currentTier = 'free';
+let currentFeatures = new Set(TIER_FEATURES.free);
+// ==================== HELPERS ====================
+/**
+ * Resolve the cumulative feature set for a given tier.
+ * E.g. `team` gets free + pro + team features.
+ */
+export function resolveFeaturesForTier(tier) {
+    const idx = TIER_ORDER.indexOf(tier);
+    const features = [];
+    for (let i = 0; i <= idx; i++) {
+        features.push(...TIER_FEATURES[TIER_ORDER[i]]);
+    }
+    return [...new Set(features)];
+}
+/**
+ * Build the canonical string representation of a license for signing/verification.
+ * Field order is fixed so both signer and verifier produce identical payloads.
+ */
+function buildCanonicalPayload(license) {
+    return [
+        license.key,
+        license.product,
+        license.tier,
+        license.issued_to,
+        license.issued_at,
+        license.expires_at ?? 'perpetual',
+        String(license.max_devices),
+        license.features.sort().join(','),
+        license.hardware_id ?? '',
+    ].join('|');
+}
+/**
+ * Encode random bytes into a Base32 string of the given length
+ * using our custom visually-unambiguous alphabet.
+ */
+function randomBase32(length) {
+    const bytes = randomBytes(length);
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += BASE32_ALPHABET[bytes[i] % BASE32_ALPHABET.length];
+    }
+    return result;
+}
+// ==================== KEY GENERATION (SERVER-SIDE) ====================
+/**
+ * Generate an Ed25519 key pair for license signing.
+ *
+ * **Server-side only** — the private key must never be shipped in the client.
+ *
+ * @returns PEM-encoded public and private keys
+ */
+export function generateKeyPair() {
+    const { publicKey, privateKey } = generateKeyPairSync('ed25519', {
+        publicKeyEncoding: { type: 'spki', format: 'pem' },
+        privateKeyEncoding: { type: 'pkcs8', format: 'pem' },
+    });
+    return { publicKey, privateKey };
+}
+/**
+ * Generate a license key in `WRM-XXXX-XXXX-XXXX-XXXX` format.
+ *
+ * Uses `crypto.randomBytes` mapped onto a Base32 alphabet that excludes
+ * visually-ambiguous characters (I, L, O, 1).
+ *
+ * **Server-side only.**
+ */
+export function generateLicenseKey() {
+    const segments = [];
+    for (let i = 0; i < KEY_SEGMENT_COUNT; i++) {
+        segments.push(randomBase32(KEY_SEGMENT_LENGTH));
+    }
+    return `${KEY_PREFIX}-${segments.join('-')}`;
+}
+/**
+ * Create a new {@link WyrmLicense} with sane defaults for the given tier.
+ *
+ * **Server-side only.**
+ *
+ * @param email - Licensee email
+ * @param tier - Desired tier
+ * @param options - Optional overrides (expiry, hardware binding, extra features)
+ */
+export function createLicense(email, tier, options = {}) {
+    const features = resolveFeaturesForTier(tier);
+    if (options.extraFeatures) {
+        for (const f of options.extraFeatures) {
+            if (!features.includes(f))
+                features.push(f);
+        }
+    }
+    return {
+        key: generateLicenseKey(),
+        product: 'wyrm',
+        tier,
+        issued_to: email,
+        issued_at: new Date().toISOString(),
+        expires_at: options.expiresAt ?? null,
+        max_devices: options.maxDevices ?? TIER_DEVICE_LIMITS[tier],
+        features,
+        hardware_id: options.hardwareId,
+    };
+}
+/**
+ * Sign a {@link WyrmLicense} with an Ed25519 private key.
+ *
+ * **Server-side only.**
+ *
+ * @param license - The license data to sign
+ * @param privateKeyPem - PEM-encoded Ed25519 private key
+ * @returns The license bundled with its base64 signature
+ */
+export function signLicense(license, privateKeyPem) {
+    const payload = buildCanonicalPayload(license);
+    const key = createPrivateKey(privateKeyPem);
+    const sig = sign(null, Buffer.from(payload, 'utf-8'), key);
+    return {
+        license,
+        signature: sig.toString('base64'),
+    };
+}
+// ==================== VERIFICATION (CLIENT-SIDE / OFFLINE) ====================
+/**
+ * Verify a {@link SignedLicense} against an Ed25519 public key.
+ *
+ * Performs three checks:
+ * 1. Signature validity (Ed25519)
+ * 2. Product field matches "wyrm"
+ * 3. Expiry date (if present)
+ *
+ * Works fully offline with zero external dependencies.
+ *
+ * @param signed - The signed license bundle
+ * @param publicKeyPem - Optional PEM override; defaults to the embedded key
+ */
+export function verifyLicense(signed, publicKeyPem) {
+    const freeFallback = {
+        valid: false,
+        tier: 'free',
+        features: [...TIER_FEATURES.free],
+        expiresAt: null,
+    };
+    try {
+        const { license, signature } = signed;
+        // Product check
+        if (license.product !== 'wyrm') {
+            return { ...freeFallback, error: 'Invalid product identifier' };
+        }
+        // Tier validity
+        if (!TIER_ORDER.includes(license.tier)) {
+            return { ...freeFallback, error: `Unknown tier: ${license.tier}` };
+        }
+        // Signature verification
+        const payload = buildCanonicalPayload(license);
+        const pem = publicKeyPem ?? WYRM_PUBLIC_KEY;
+        let key;
+        try {
+            key = createPublicKey(pem);
+        }
+        catch {
+            return { ...freeFallback, error: 'Invalid public key' };
+        }
+        const isValid = verify(null, Buffer.from(payload, 'utf-8'), key, Buffer.from(signature, 'base64'));
+        if (!isValid) {
+            return { ...freeFallback, error: 'Invalid signature — license may be tampered' };
+        }
+        // Expiry check
+        if (license.expires_at !== null) {
+            const expiry = new Date(license.expires_at);
+            if (isNaN(expiry.getTime())) {
+                return { ...freeFallback, error: 'Malformed expiry date' };
+            }
+            if (expiry.getTime() < Date.now()) {
+                return {
+                    valid: false,
+                    tier: license.tier,
+                    features: [...TIER_FEATURES.free],
+                    expiresAt: license.expires_at,
+                    error: `License expired on ${license.expires_at}`,
+                };
+            }
+        }
+        return {
+            valid: true,
+            tier: license.tier,
+            features: [...license.features],
+            expiresAt: license.expires_at,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ...freeFallback, error: `Verification failed: ${message}` };
+    }
+}
+// ==================== FEATURE GATES ====================
+/**
+ * Check whether a specific feature is available in the current license.
+ *
+ * @param feature - Feature flag name (e.g. `"encryption"`, `"sso_saml"`)
+ */
+export function hasFeature(feature) {
+    return currentFeatures.has(feature);
+}
+/**
+ * Get the current active license tier.
+ * Defaults to `"free"` when no valid license is loaded.
+ */
+export function getTier() {
+    return currentTier;
+}
+/**
+ * Return a summary of the currently-loaded license state.
+ */
+export function getLicenseInfo() {
+    if (!currentLicense) {
+        return {
+            tier: 'free',
+            features: [...TIER_FEATURES.free],
+            expiresAt: null,
+            valid: false,
+            issuedTo: null,
+            key: null,
+        };
+    }
+    const validation = verifyLicense(currentLicense);
+    return {
+        tier: validation.tier,
+        features: validation.features,
+        expiresAt: validation.expiresAt,
+        valid: validation.valid,
+        issuedTo: currentLicense.license.issued_to,
+        key: currentLicense.license.key,
+    };
+}
+// ==================== PERSISTENCE ====================
+/**
+ * Load a signed license from `~/.wyrm/license.json`.
+ *
+ * @returns The parsed {@link SignedLicense} or `null` if not found / unparseable
+ */
+export function loadLicense() {
+    try {
+        if (!existsSync(LICENSE_PATH))
+            return null;
+        const raw = readFileSync(LICENSE_PATH, 'utf-8');
+        const parsed = JSON.parse(raw);
+        // Basic shape check
+        if (!parsed.license || !parsed.signature)
+            return null;
+        if (!parsed.license.key || !parsed.license.tier)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Persist a signed license to `~/.wyrm/license.json`.
+ * File permissions are set to `0o600` (owner read/write only).
+ *
+ * @param signed - The signed license to save
+ */
+export function saveLicense(signed) {
+    if (!existsSync(WYRM_DIR)) {
+        mkdirSync(WYRM_DIR, { recursive: true });
+    }
+    const json = JSON.stringify(signed, null, 2);
+    writeFileSync(LICENSE_PATH, json, { encoding: 'utf-8', mode: 0o600 });
+    // Ensure permissions even if file existed previously
+    chmodSync(LICENSE_PATH, 0o600);
+}
+/**
+ * Activate a license from a JSON string (e.g. pasted by the user).
+ *
+ * Parses, verifies, and — if valid — persists the license and updates
+ * the in-memory singleton state.
+ *
+ * @param licenseString - JSON-encoded {@link SignedLicense}
+ * @returns Validation result
+ */
+export function activateLicense(licenseString) {
+    let signed;
+    try {
+        signed = JSON.parse(licenseString);
+    }
+    catch {
+        return {
+            valid: false,
+            tier: 'free',
+            features: [...TIER_FEATURES.free],
+            expiresAt: null,
+            error: 'Invalid license format — expected JSON',
+        };
+    }
+    if (!signed.license || !signed.signature) {
+        return {
+            valid: false,
+            tier: 'free',
+            features: [...TIER_FEATURES.free],
+            expiresAt: null,
+            error: 'Malformed license — missing license data or signature',
+        };
+    }
+    const validation = verifyLicense(signed);
+    if (validation.valid) {
+        saveLicense(signed);
+        currentLicense = signed;
+        currentTier = validation.tier;
+        currentFeatures = new Set(validation.features);
+    }
+    return validation;
+}
+// ==================== INITIALIZATION ====================
+/**
+ * Initialize the license subsystem on startup.
+ *
+ * Attempts to load and verify `~/.wyrm/license.json`.
+ * Falls back to the free tier on any failure.
+ *
+ * Call this once during MCP server boot.
+ */
+export function initializeLicense() {
+    const signed = loadLicense();
+    if (!signed) {
+        currentLicense = null;
+        currentTier = 'free';
+        currentFeatures = new Set(TIER_FEATURES.free);
+        return;
+    }
+    const validation = verifyLicense(signed);
+    if (validation.valid) {
+        currentLicense = signed;
+        currentTier = validation.tier;
+        currentFeatures = new Set(validation.features);
+    }
+    else {
+        // Invalid / expired — degrade gracefully
+        currentLicense = null;
+        currentTier = 'free';
+        currentFeatures = new Set(TIER_FEATURES.free);
+    }
+}
+/**
+ * Reset the singleton state to free tier.
+ * Useful for testing or license deactivation.
+ */
+export function resetLicense() {
+    currentLicense = null;
+    currentTier = 'free';
+    currentFeatures = new Set(TIER_FEATURES.free);
+}
+//# sourceMappingURL=license.js.map

package/dist/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Wyrm Logger - Structured logging with log levels
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary - See LICENSE file for details.
+ * @module logger
+ * @version 3.0.0
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    context?: Record<string, unknown>;
+    correlationId?: string;
+}
+export interface LoggerConfig {
+    level: LogLevel;
+    file?: string;
+    console?: boolean;
+    json?: boolean;
+}
+/**
+ * Wyrm Logger - Structured logging for the memory system
+ */
+export declare class WyrmLogger {
+    private config;
+    private correlationId?;
+    private logDir;
+    constructor(config?: Partial<LoggerConfig>);
+    /**
+     * Set correlation ID for request tracing
+     */
+    setCorrelationId(id: string): void;
+    /**
+     * Generate a new correlation ID
+     */
+    generateCorrelationId(): string;
+    /**
+     * Check if a log level should be logged
+     */
+    private shouldLog;
+    /**
+     * Format log entry
+     */
+    private format;
+    /**
+     * Write log entry
+     */
+    private log;
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log with timing measurement
+     */
+    time<T>(label: string, fn: () => T): T;
+    /**
+     * Async timing
+     */
+    timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Create a child logger with additional context
+     */
+    child(context: Record<string, unknown>): WyrmLogger;
+}
+export declare function getLogger(): WyrmLogger;
+export declare function createLogger(config: Partial<LoggerConfig>): WyrmLogger;
+export declare const logger: {
+    debug: (msg: string, ctx?: Record<string, unknown>) => void;
+    info: (msg: string, ctx?: Record<string, unknown>) => void;
+    warn: (msg: string, ctx?: Record<string, unknown>) => void;
+    error: (msg: string, ctx?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAoBD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAc1C;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAK/B;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,MAAM;IAsBd;;OAEG;IACH,OAAO,CAAC,GAAG;IA6BX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IActC;;OAEG;IACG,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAcnE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;CASpD;AAKD,wBAAgB,SAAS,IAAI,UAAU,CAUtC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,UAAU,CAEtE;AAGD,eAAO,MAAM,MAAM;iBACJ,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACtC,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACrC,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iBACpC,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CACnD,CAAC"}

package/dist/logger.js

@@ -0,0 +1,195 @@
+/**
+ * Wyrm Logger - Structured logging with log levels
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd. All Rights Reserved.
+ * @license Proprietary - See LICENSE file for details.
+ * @module logger
+ * @version 3.0.0
+ */
+import { appendFileSync, existsSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const LOG_COLORS = {
+    debug: '\x1b[36m', // Cyan
+    info: '\x1b[32m', // Green
+    warn: '\x1b[33m', // Yellow
+    error: '\x1b[31m', // Red
+};
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+/**
+ * Wyrm Logger - Structured logging for the memory system
+ */
+export class WyrmLogger {
+    config;
+    correlationId;
+    logDir;
+    constructor(config) {
+        this.config = {
+            level: config?.level ?? 'info',
+            console: config?.console ?? true,
+            json: config?.json ?? false,
+            file: config?.file,
+        };
+        this.logDir = join(homedir(), '.wyrm', 'logs');
+        if (!existsSync(this.logDir)) {
+            mkdirSync(this.logDir, { recursive: true });
+        }
+    }
+    /**
+     * Set correlation ID for request tracing
+     */
+    setCorrelationId(id) {
+        this.correlationId = id;
+    }
+    /**
+     * Generate a new correlation ID
+     */
+    generateCorrelationId() {
+        this.correlationId = `wyrm-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        return this.correlationId;
+    }
+    /**
+     * Check if a log level should be logged
+     */
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];
+    }
+    /**
+     * Format log entry
+     */
+    format(entry) {
+        if (this.config.json) {
+            return JSON.stringify(entry);
+        }
+        const color = LOG_COLORS[entry.level];
+        const levelStr = entry.level.toUpperCase().padEnd(5);
+        const time = entry.timestamp.split('T')[1]?.split('.')[0] || entry.timestamp;
+        let msg = `${DIM}${time}${RESET} ${color}${BOLD}${levelStr}${RESET} ${entry.message}`;
+        if (entry.context && Object.keys(entry.context).length > 0) {
+            msg += ` ${DIM}${JSON.stringify(entry.context)}${RESET}`;
+        }
+        if (entry.correlationId) {
+            msg += ` ${DIM}[${entry.correlationId}]${RESET}`;
+        }
+        return msg;
+    }
+    /**
+     * Write log entry
+     */
+    log(level, message, context) {
+        if (!this.shouldLog(level))
+            return;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            context,
+            correlationId: this.correlationId,
+        };
+        const formatted = this.format(entry);
+        if (this.config.console) {
+            const stream = level === 'error' ? console.error : console.log;
+            stream(formatted);
+        }
+        if (this.config.file) {
+            try {
+                const logPath = join(this.logDir, this.config.file);
+                appendFileSync(logPath, (this.config.json ? formatted : JSON.stringify(entry)) + '\n');
+            }
+            catch {
+                // Silent fail for file writes
+            }
+        }
+    }
+    // Log level methods
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    warn(message, context) {
+        this.log('warn', message, context);
+    }
+    error(message, context) {
+        this.log('error', message, context);
+    }
+    /**
+     * Log with timing measurement
+     */
+    time(label, fn) {
+        const start = performance.now();
+        try {
+            const result = fn();
+            const duration = performance.now() - start;
+            this.debug(`${label} completed`, { duration: `${duration.toFixed(2)}ms` });
+            return result;
+        }
+        catch (error) {
+            const duration = performance.now() - start;
+            this.error(`${label} failed`, { duration: `${duration.toFixed(2)}ms`, error: String(error) });
+            throw error;
+        }
+    }
+    /**
+     * Async timing
+     */
+    async timeAsync(label, fn) {
+        const start = performance.now();
+        try {
+            const result = await fn();
+            const duration = performance.now() - start;
+            this.debug(`${label} completed`, { duration: `${duration.toFixed(2)}ms` });
+            return result;
+        }
+        catch (error) {
+            const duration = performance.now() - start;
+            this.error(`${label} failed`, { duration: `${duration.toFixed(2)}ms`, error: String(error) });
+            throw error;
+        }
+    }
+    /**
+     * Create a child logger with additional context
+     */
+    child(context) {
+        const child = new WyrmLogger(this.config);
+        child.correlationId = this.correlationId;
+        const originalLog = child.log.bind(child);
+        child.log = (level, message, ctx) => {
+            originalLog(level, message, { ...context, ...ctx });
+        };
+        return child;
+    }
+}
+// Default logger instance
+let defaultLogger = null;
+export function getLogger() {
+    if (!defaultLogger) {
+        defaultLogger = new WyrmLogger({
+            level: process.env.WYRM_LOG_LEVEL || 'info',
+            console: process.env.WYRM_LOG_CONSOLE !== 'false',
+            json: process.env.WYRM_LOG_JSON === 'true',
+            file: 'wyrm.log',
+        });
+    }
+    return defaultLogger;
+}
+export function createLogger(config) {
+    return new WyrmLogger(config);
+}
+// Convenience exports
+export const logger = {
+    debug: (msg, ctx) => getLogger().debug(msg, ctx),
+    info: (msg, ctx) => getLogger().info(msg, ctx),
+    warn: (msg, ctx) => getLogger().warn(msg, ctx),
+    error: (msg, ctx) => getLogger().error(msg, ctx),
+};
+//# sourceMappingURL=logger.js.map