@private.me/xbind 3.0.2 → 3.0.4

package/dist-standalone/cjs/debug-mode.js

@@ -1,534 +1 @@
-"use strict";
-/**
- * @module debug-mode
- * Debug mode for enhanced developer experience with verbose logging and state inspection
- *
- * Provides comprehensive debugging capabilities including:
- * - Verbose logging of all operations
- * - Internal state dumping and inspection
- * - Network request/response logging
- * - Crypto operation tracing
- * - Performance profiling and timing
- * - Memory usage tracking
- *
- * Usage:
- * ```typescript
- * import { enableDebugMode, dumpState, createDebugLogger } from '@private.me/xbind/debug-mode';
- *
- * // Enable debug mode globally
- * enableDebugMode({ verbose: true, traceNetwork: true });
- *
- * // Create debug logger for component
- * const debug = createDebugLogger('agent');
- * debug.trace('Operation starting', { did: 'did:key:...' });
- *
- * // Dump internal state
- * const state = dumpState(agent);
- * console.log(state);
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.enableDebugMode = enableDebugMode;
-exports.disableDebugMode = disableDebugMode;
-exports.isDebugEnabled = isDebugEnabled;
-exports.getDebugOptions = getDebugOptions;
-exports.createDebugLogger = createDebugLogger;
-exports.startProfiling = startProfiling;
-exports.endProfiling = endProfiling;
-exports.getPerformanceMeasurements = getPerformanceMeasurements;
-exports.clearPerformanceMeasurements = clearPerformanceMeasurements;
-exports.traceNetworkRequest = traceNetworkRequest;
-exports.traceNetworkResponse = traceNetworkResponse;
-exports.getNetworkTraces = getNetworkTraces;
-exports.clearNetworkTraces = clearNetworkTraces;
-exports.traceCryptoOperation = traceCryptoOperation;
-exports.getCryptoTraces = getCryptoTraces;
-exports.clearCryptoTraces = clearCryptoTraces;
-exports.dumpState = dumpState;
-exports.getStateSnapshots = getStateSnapshots;
-exports.clearStateSnapshots = clearStateSnapshots;
-exports.exportDebugData = exportDebugData;
-exports.clearAllDebugData = clearAllDebugData;
-exports.generateDebugReport = generateDebugReport;
-const logger_js_1 = require("./logger.js");
-/**
- * Global debug mode state
- */
-class DebugModeState {
-    enabled = false;
-    options = {};
-    measurements = [];
-    networkTraces = [];
-    cryptoTraces = [];
-    stateSnapshots = [];
-    activeTimers = new Map();
-}
-const globalDebugState = new DebugModeState();
-/**
- * Enable debug mode with optional configuration
- *
- * @param options - Debug mode options
- */
-function enableDebugMode(options = {}) {
-    globalDebugState.enabled = true;
-    globalDebugState.options = {
-        verbose: options.verbose ?? false,
-        traceNetwork: options.traceNetwork ?? false,
-        traceCrypto: options.traceCrypto ?? false,
-        profile: options.profile ?? false,
-        trackMemory: options.trackMemory ?? false,
-        traceState: options.traceState ?? false,
-        output: options.output ?? console.log,
-        filters: options.filters,
-    };
-    const logger = (0, logger_js_1.createLogger)('debug-mode');
-    logger.setLevel(logger_js_1.LogLevel.DEBUG);
-    logger.info('Debug mode enabled', { options: globalDebugState.options });
-}
-/**
- * Disable debug mode and clear collected data
- */
-function disableDebugMode() {
-    globalDebugState.enabled = false;
-    globalDebugState.measurements = [];
-    globalDebugState.networkTraces = [];
-    globalDebugState.cryptoTraces = [];
-    globalDebugState.stateSnapshots = [];
-    globalDebugState.activeTimers.clear();
-    const logger = (0, logger_js_1.createLogger)('debug-mode');
-    logger.info('Debug mode disabled');
-}
-/**
- * Check if debug mode is enabled
- */
-function isDebugEnabled() {
-    return globalDebugState.enabled;
-}
-/**
- * Get current debug mode options
- */
-function getDebugOptions() {
-    return { ...globalDebugState.options };
-}
-/**
- * Create a debug logger for a specific component
- *
- * @param component - Component name
- * @returns Logger instance with debug capabilities
- */
-function createDebugLogger(component) {
-    const logger = (0, logger_js_1.createLogger)(component);
-    if (globalDebugState.enabled && globalDebugState.options.verbose) {
-        logger.setLevel(logger_js_1.LogLevel.DEBUG);
-    }
-    return {
-        ...logger,
-        trace(message, context) {
-            if (!globalDebugState.enabled || !globalDebugState.options.verbose) {
-                return;
-            }
-            // Apply filters if configured
-            if (globalDebugState.options.filters) {
-                const { include, exclude } = globalDebugState.options.filters;
-                if (include && !include.some((pattern) => pattern.test(message))) {
-                    return;
-                }
-                if (exclude && exclude.some((pattern) => pattern.test(message))) {
-                    return;
-                }
-            }
-            logger.debug(message, context);
-        },
-    };
-}
-/**
- * Start performance measurement for an operation
- *
- * @param operation - Operation name
- * @param context - Optional context
- */
-function startProfiling(operation, context) {
-    if (!globalDebugState.enabled || !globalDebugState.options.profile) {
-        return;
-    }
-    const startTime = performance.now();
-    globalDebugState.activeTimers.set(operation, { startTime, context });
-    const logger = createDebugLogger('profiler');
-    logger.trace(`[PROFILE] Starting: ${operation}`, context);
-}
-/**
- * End performance measurement and record result
- *
- * @param operation - Operation name
- * @param context - Optional context (overrides context from startProfiling if provided)
- */
-function endProfiling(operation, context) {
-    if (!globalDebugState.enabled || !globalDebugState.options.profile) {
-        return;
-    }
-    const timerData = globalDebugState.activeTimers.get(operation);
-    if (!timerData) {
-        const logger = createDebugLogger('profiler');
-        logger.warn(`[PROFILE] No start time found for: ${operation}`);
-        return;
-    }
-    const endTime = performance.now();
-    const duration = endTime - timerData.startTime;
-    // Use context from endProfiling if provided, otherwise use context from startProfiling
-    const finalContext = context ?? timerData.context;
-    let memoryBefore;
-    let memoryAfter;
-    let memoryDelta;
-    if (globalDebugState.options.trackMemory && typeof process !== 'undefined' && process.memoryUsage) {
-        const mem = process.memoryUsage();
-        memoryAfter = mem.heapUsed;
-        // Estimate (not precise without tracking before)
-        memoryBefore = memoryAfter;
-        memoryDelta = 0;
-    }
-    const measurement = {
-        operation,
-        startTime: timerData.startTime,
-        endTime,
-        duration,
-        memoryBefore,
-        memoryAfter,
-        memoryDelta,
-        context: finalContext,
-    };
-    globalDebugState.measurements.push(measurement);
-    globalDebugState.activeTimers.delete(operation);
-    const logger = createDebugLogger('profiler');
-    logger.trace(`[PROFILE] Completed: ${operation} (${duration.toFixed(2)}ms)`, {
-        duration,
-        memoryDelta,
-        ...context,
-    });
-}
-/**
- * Get all performance measurements
- */
-function getPerformanceMeasurements() {
-    return [...globalDebugState.measurements];
-}
-/**
- * Clear performance measurements
- */
-function clearPerformanceMeasurements() {
-    globalDebugState.measurements = [];
-    globalDebugState.activeTimers.clear();
-}
-/**
- * Log network request start
- *
- * @param id - Request ID
- * @param method - HTTP method
- * @param url - URL
- * @param headers - Request headers
- * @param body - Request body
- */
-function traceNetworkRequest(id, method, url, headers, body) {
-    if (!globalDebugState.enabled || !globalDebugState.options.traceNetwork) {
-        return;
-    }
-    const trace = {
-        id,
-        method,
-        url,
-        requestHeaders: redactHeaders(headers),
-        requestBody: truncateBody(body),
-        startTime: performance.now(),
-    };
-    globalDebugState.networkTraces.push(trace);
-    const logger = createDebugLogger('network');
-    logger.trace(`[NETWORK] ${method} ${url}`, {
-        requestId: id,
-        headers: trace.requestHeaders,
-        bodyLength: body?.length ?? 0,
-    });
-}
-/**
- * Log network response
- *
- * @param id - Request ID
- * @param status - HTTP status code
- * @param headers - Response headers
- * @param body - Response body
- * @param error - Error (if failed)
- */
-function traceNetworkResponse(id, status, headers, body, error) {
-    if (!globalDebugState.enabled || !globalDebugState.options.traceNetwork) {
-        return;
-    }
-    const trace = globalDebugState.networkTraces.find((t) => t.id === id);
-    if (!trace) {
-        return;
-    }
-    trace.endTime = performance.now();
-    trace.duration = trace.endTime - trace.startTime;
-    trace.status = status;
-    trace.responseHeaders = headers ? redactHeaders(headers) : undefined;
-    trace.responseBody = truncateBody(body);
-    trace.error = error;
-    const logger = createDebugLogger('network');
-    logger.trace(`[NETWORK] Response ${status ?? 'ERROR'} (${trace.duration.toFixed(2)}ms)`, {
-        requestId: id,
-        status,
-        duration: trace.duration,
-        error,
-    });
-}
-/**
- * Get all network traces
- */
-function getNetworkTraces() {
-    return [...globalDebugState.networkTraces];
-}
-/**
- * Clear network traces
- */
-function clearNetworkTraces() {
-    globalDebugState.networkTraces = [];
-}
-/**
- * Log crypto operation
- *
- * @param operation - Operation type
- * @param algorithm - Algorithm name
- * @param inputSize - Input size (bytes)
- * @param outputSize - Output size (bytes)
- * @param duration - Duration (ms)
- * @param success - Success flag
- * @param error - Error message (if failed)
- */
-function traceCryptoOperation(operation, algorithm, inputSize, outputSize, duration, success, error) {
-    if (!globalDebugState.enabled || !globalDebugState.options.traceCrypto) {
-        return;
-    }
-    const trace = {
-        operation,
-        algorithm,
-        inputSize,
-        outputSize,
-        duration: duration ?? 0,
-        success: success ?? true,
-        error,
-        timestamp: Date.now(),
-    };
-    globalDebugState.cryptoTraces.push(trace);
-    const logger = createDebugLogger('crypto');
-    logger.trace(`[CRYPTO] ${operation} (${algorithm})`, {
-        inputSize,
-        outputSize,
-        duration,
-        success,
-        error,
-    });
-}
-/**
- * Get all crypto traces
- */
-function getCryptoTraces() {
-    return [...globalDebugState.cryptoTraces];
-}
-/**
- * Clear crypto traces
- */
-function clearCryptoTraces() {
-    globalDebugState.cryptoTraces = [];
-}
-/**
- * Dump internal state of an agent
- *
- * @param agent - Agent instance
- * @returns State snapshot
- */
-function dumpState(agent) {
-    const snapshot = {
-        did: agent.did,
-        identityMode: agent.identityMode ?? 'persistent',
-        registered: agent.registered ?? false,
-        registryUrl: agent.registry?.url,
-        nonceStoreType: agent.nonceStore?.constructor?.name ?? 'unknown',
-        nonceCount: agent.nonceStore?.size ?? 0,
-        transportType: agent.transport?.constructor?.name ?? 'unknown',
-        securityPolicy: {
-            level: agent.securityPolicy?.level ?? 'unknown',
-            replayWindow: agent.securityPolicy?.replayWindow ?? 0,
-            timestampTolerance: agent.securityPolicy?.timestampTolerance ?? 0,
-        },
-        postQuantum: agent.postQuantum ?? false,
-        memoryUsage: typeof process !== 'undefined' && process.memoryUsage
-            ? process.memoryUsage().heapUsed
-            : undefined,
-        timestamp: Date.now(),
-    };
-    if (globalDebugState.enabled && globalDebugState.options.traceState) {
-        globalDebugState.stateSnapshots.push(snapshot);
-    }
-    const logger = createDebugLogger('state');
-    logger.trace('[STATE] Agent snapshot', snapshot);
-    return snapshot;
-}
-/**
- * Get all state snapshots
- */
-function getStateSnapshots() {
-    return [...globalDebugState.stateSnapshots];
-}
-/**
- * Clear state snapshots
- */
-function clearStateSnapshots() {
-    globalDebugState.stateSnapshots = [];
-}
-/**
- * Export all debug data as JSON
- *
- * @returns JSON string with all debug data
- */
-function exportDebugData() {
-    const data = {
-        enabled: globalDebugState.enabled,
-        options: globalDebugState.options,
-        measurements: globalDebugState.measurements,
-        networkTraces: globalDebugState.networkTraces,
-        cryptoTraces: globalDebugState.cryptoTraces,
-        stateSnapshots: globalDebugState.stateSnapshots,
-        exportedAt: new Date().toISOString(),
-    };
-    return JSON.stringify(data, null, 2);
-}
-/**
- * Clear all debug data
- */
-function clearAllDebugData() {
-    clearPerformanceMeasurements();
-    clearNetworkTraces();
-    clearCryptoTraces();
-    clearStateSnapshots();
-}
-/**
- * Redact sensitive headers
- */
-function redactHeaders(headers) {
-    const redacted = {};
-    const sensitiveHeaders = new Set([
-        'authorization',
-        'cookie',
-        'set-cookie',
-        'x-api-key',
-        'x-auth-token',
-    ]);
-    for (const [key, value] of Object.entries(headers)) {
-        const lowerKey = key.toLowerCase();
-        if (sensitiveHeaders.has(lowerKey)) {
-            redacted[key] = '[REDACTED]';
-        }
-        else {
-            redacted[key] = value;
-        }
-    }
-    return redacted;
-}
-/**
- * Truncate body to reasonable size for logging
- */
-function truncateBody(body) {
-    if (!body)
-        return undefined;
-    const maxLength = 1000;
-    if (body.length <= maxLength) {
-        return body;
-    }
-    return body.substring(0, maxLength) + `... (${body.length - maxLength} more bytes)`;
-}
-/**
- * Generate debug report
- *
- * @returns Human-readable debug report
- */
-function generateDebugReport() {
-    const lines = [];
-    lines.push('='.repeat(80));
-    lines.push('xBind Debug Report');
-    lines.push('='.repeat(80));
-    lines.push('');
-    lines.push(`Generated: ${new Date().toISOString()}`);
-    lines.push(`Debug Mode: ${globalDebugState.enabled ? 'ENABLED' : 'DISABLED'}`);
-    lines.push('');
-    if (globalDebugState.measurements.length > 0) {
-        lines.push('Performance Measurements:');
-        lines.push('-'.repeat(80));
-        for (const m of globalDebugState.measurements) {
-            lines.push(`  ${m.operation}: ${m.duration.toFixed(2)}ms`);
-            if (m.memoryDelta !== undefined) {
-                lines.push(`    Memory: ${formatBytes(m.memoryDelta)}`);
-            }
-        }
-        lines.push('');
-    }
-    if (globalDebugState.networkTraces.length > 0) {
-        lines.push('Network Traces:');
-        lines.push('-'.repeat(80));
-        for (const n of globalDebugState.networkTraces) {
-            lines.push(`  ${n.method} ${n.url}`);
-            if (n.status) {
-                lines.push(`    Status: ${n.status}`);
-            }
-            if (n.duration) {
-                lines.push(`    Duration: ${n.duration.toFixed(2)}ms`);
-            }
-            if (n.error) {
-                lines.push(`    Error: ${n.error}`);
-            }
-        }
-        lines.push('');
-    }
-    if (globalDebugState.cryptoTraces.length > 0) {
-        lines.push('Crypto Operations:');
-        lines.push('-'.repeat(80));
-        for (const c of globalDebugState.cryptoTraces) {
-            lines.push(`  ${c.operation} (${c.algorithm})`);
-            lines.push(`    Input: ${formatBytes(c.inputSize)}`);
-            if (c.outputSize) {
-                lines.push(`    Output: ${formatBytes(c.outputSize)}`);
-            }
-            lines.push(`    Duration: ${c.duration.toFixed(2)}ms`);
-            lines.push(`    Success: ${c.success}`);
-            if (c.error) {
-                lines.push(`    Error: ${c.error}`);
-            }
-        }
-        lines.push('');
-    }
-    if (globalDebugState.stateSnapshots.length > 0) {
-        lines.push('State Snapshots:');
-        lines.push('-'.repeat(80));
-        const latest = globalDebugState.stateSnapshots[globalDebugState.stateSnapshots.length - 1];
-        if (latest) {
-            lines.push(`  DID: ${latest.did}`);
-            lines.push(`  Mode: ${latest.identityMode}`);
-            lines.push(`  Registered: ${latest.registered}`);
-            lines.push(`  Post-Quantum: ${latest.postQuantum}`);
-            lines.push(`  Nonce Count: ${latest.nonceCount}`);
-            if (latest.memoryUsage) {
-                lines.push(`  Memory Usage: ${formatBytes(latest.memoryUsage)}`);
-            }
-        }
-        lines.push('');
-    }
-    lines.push('='.repeat(80));
-    return lines.join('\n');
-}
-/**
- * Format bytes as human-readable string
- */
-function formatBytes(bytes) {
-    if (bytes === 0)
-        return '0 B';
-    const units = ['B', 'KB', 'MB', 'GB'];
-    const i = Math.floor(Math.log(Math.abs(bytes)) / Math.log(1024));
-    const value = bytes / Math.pow(1024, i);
-    return `${value.toFixed(2)} ${units[i]}`;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.enableDebugMode=enableDebugMode,exports.disableDebugMode=disableDebugMode,exports.isDebugEnabled=isDebugEnabled,exports.getDebugOptions=getDebugOptions,exports.createDebugLogger=createDebugLogger,exports.startProfiling=startProfiling,exports.endProfiling=endProfiling,exports.getPerformanceMeasurements=getPerformanceMeasurements,exports.clearPerformanceMeasurements=clearPerformanceMeasurements,exports.traceNetworkRequest=traceNetworkRequest,exports.traceNetworkResponse=traceNetworkResponse,exports.getNetworkTraces=getNetworkTraces,exports.clearNetworkTraces=clearNetworkTraces,exports.traceCryptoOperation=traceCryptoOperation,exports.getCryptoTraces=getCryptoTraces,exports.clearCryptoTraces=clearCryptoTraces,exports.dumpState=dumpState,exports.getStateSnapshots=getStateSnapshots,exports.clearStateSnapshots=clearStateSnapshots,exports.exportDebugData=exportDebugData,exports.clearAllDebugData=clearAllDebugData,exports.generateDebugReport=generateDebugReport;const logger_js_1=require("./logger.js");class DebugModeState{enabled=!1;options={};measurements=[];networkTraces=[];cryptoTraces=[];stateSnapshots=[];activeTimers=new Map}const globalDebugState=new DebugModeState;function enableDebugMode(e={}){globalDebugState.enabled=!0,globalDebugState.options={verbose:e.verbose??!1,traceNetwork:e.traceNetwork??!1,traceCrypto:e.traceCrypto??!1,profile:e.profile??!1,trackMemory:e.trackMemory??!1,traceState:e.traceState??!1,output:e.output??console.log,filters:e.filters};const t=(0,logger_js_1.createLogger)("debug-mode");t.setLevel(logger_js_1.LogLevel.DEBUG),t.info("Debug mode enabled",{options:globalDebugState.options})}function disableDebugMode(){globalDebugState.enabled=!1,globalDebugState.measurements=[],globalDebugState.networkTraces=[],globalDebugState.cryptoTraces=[],globalDebugState.stateSnapshots=[],globalDebugState.activeTimers.clear();(0,logger_js_1.createLogger)("debug-mode").info("Debug mode disabled")}function isDebugEnabled(){return globalDebugState.enabled}function getDebugOptions(){return{...globalDebugState.options}}function createDebugLogger(e){const t=(0,logger_js_1.createLogger)(e);return globalDebugState.enabled&&globalDebugState.options.verbose&&t.setLevel(logger_js_1.LogLevel.DEBUG),{...t,trace(e,o){if(globalDebugState.enabled&&globalDebugState.options.verbose){if(globalDebugState.options.filters){const{include:t,exclude:o}=globalDebugState.options.filters;if(t&&!t.some(t=>t.test(e)))return;if(o&&o.some(t=>t.test(e)))return}t.debug(e,o)}}}}function startProfiling(e,t){if(!globalDebugState.enabled||!globalDebugState.options.profile)return;const o=performance.now();globalDebugState.activeTimers.set(e,{startTime:o,context:t});createDebugLogger("profiler").trace(`[PROFILE] Starting: ${e}`,t)}function endProfiling(e,t){if(!globalDebugState.enabled||!globalDebugState.options.profile)return;const o=globalDebugState.activeTimers.get(e);if(!o){return void createDebugLogger("profiler").warn(`[PROFILE] No start time found for: ${e}`)}const r=performance.now(),a=r-o.startTime,s=t??o.context;let n,u,g;if(globalDebugState.options.trackMemory&&"undefined"!=typeof process&&process.memoryUsage){u=process.memoryUsage().heapUsed,n=u,g=0}const l={operation:e,startTime:o.startTime,endTime:r,duration:a,memoryBefore:n,memoryAfter:u,memoryDelta:g,context:s};globalDebugState.measurements.push(l),globalDebugState.activeTimers.delete(e);createDebugLogger("profiler").trace(`[PROFILE] Completed: ${e} (${a.toFixed(2)}ms)`,{duration:a,memoryDelta:g,...t})}function getPerformanceMeasurements(){return[...globalDebugState.measurements]}function clearPerformanceMeasurements(){globalDebugState.measurements=[],globalDebugState.activeTimers.clear()}function traceNetworkRequest(e,t,o,r,a){if(!globalDebugState.enabled||!globalDebugState.options.traceNetwork)return;const s={id:e,method:t,url:o,requestHeaders:redactHeaders(r),requestBody:truncateBody(a),startTime:performance.now()};globalDebugState.networkTraces.push(s);createDebugLogger("network").trace(`[NETWORK] ${t} ${o}`,{requestId:e,headers:s.requestHeaders,bodyLength:a?.length??0})}function traceNetworkResponse(e,t,o,r,a){if(!globalDebugState.enabled||!globalDebugState.options.traceNetwork)return;const s=globalDebugState.networkTraces.find(t=>t.id===e);if(!s)return;s.endTime=performance.now(),s.duration=s.endTime-s.startTime,s.status=t,s.responseHeaders=o?redactHeaders(o):void 0,s.responseBody=truncateBody(r),s.error=a;createDebugLogger("network").trace(`[NETWORK] Response ${t??"ERROR"} (${s.duration.toFixed(2)}ms)`,{requestId:e,status:t,duration:s.duration,error:a})}function getNetworkTraces(){return[...globalDebugState.networkTraces]}function clearNetworkTraces(){globalDebugState.networkTraces=[]}function traceCryptoOperation(e,t,o,r,a,s,n){if(!globalDebugState.enabled||!globalDebugState.options.traceCrypto)return;const u={operation:e,algorithm:t,inputSize:o,outputSize:r,duration:a??0,success:s??!0,error:n,timestamp:Date.now()};globalDebugState.cryptoTraces.push(u);createDebugLogger("crypto").trace(`[CRYPTO] ${e} (${t})`,{inputSize:o,outputSize:r,duration:a,success:s,error:n})}function getCryptoTraces(){return[...globalDebugState.cryptoTraces]}function clearCryptoTraces(){globalDebugState.cryptoTraces=[]}function dumpState(e){const t=e,o={did:e.did,identityMode:t.identityMode??"persistent",registered:t.registered??!1,registryUrl:t.registry?.url,nonceStoreType:t.nonceStore?.constructor?.name??"unknown",nonceCount:t.nonceStore?.size??0,transportType:t.transport?.constructor?.name??"unknown",securityPolicy:{level:t.securityPolicy?.level??"unknown",replayWindow:t.securityPolicy?.replayWindow??0,timestampTolerance:t.securityPolicy?.timestampTolerance??0},postQuantum:t.postQuantum??!1,memoryUsage:"undefined"!=typeof process&&process.memoryUsage?process.memoryUsage().heapUsed:void 0,timestamp:Date.now()};globalDebugState.enabled&&globalDebugState.options.traceState&&globalDebugState.stateSnapshots.push(o);return createDebugLogger("state").trace("[STATE] Agent snapshot",o),o}function getStateSnapshots(){return[...globalDebugState.stateSnapshots]}function clearStateSnapshots(){globalDebugState.stateSnapshots=[]}function exportDebugData(){const e={enabled:globalDebugState.enabled,options:globalDebugState.options,measurements:globalDebugState.measurements,networkTraces:globalDebugState.networkTraces,cryptoTraces:globalDebugState.cryptoTraces,stateSnapshots:globalDebugState.stateSnapshots,exportedAt:(new Date).toISOString()};return JSON.stringify(e,null,2)}function clearAllDebugData(){clearPerformanceMeasurements(),clearNetworkTraces(),clearCryptoTraces(),clearStateSnapshots()}function redactHeaders(e){const t={},o=new Set(["authorization","cookie","set-cookie","x-api-key","x-auth-token"]);for(const[r,a]of Object.entries(e)){const e=r.toLowerCase();o.has(e)?t[r]="[REDACTED]":t[r]=a}return t}function truncateBody(e){if(!e)return;const t=1e3;return e.length<=t?e:e.substring(0,t)+`... (${e.length-t} more bytes)`}function generateDebugReport(){const e=[];if(e.push("=".repeat(80)),e.push("xBind Debug Report"),e.push("=".repeat(80)),e.push(""),e.push(`Generated: ${(new Date).toISOString()}`),e.push("Debug Mode: "+(globalDebugState.enabled?"ENABLED":"DISABLED")),e.push(""),globalDebugState.measurements.length>0){e.push("Performance Measurements:"),e.push("-".repeat(80));for(const t of globalDebugState.measurements)e.push(`  ${t.operation}: ${t.duration.toFixed(2)}ms`),void 0!==t.memoryDelta&&e.push(`    Memory: ${formatBytes(t.memoryDelta)}`);e.push("")}if(globalDebugState.networkTraces.length>0){e.push("Network Traces:"),e.push("-".repeat(80));for(const t of globalDebugState.networkTraces)e.push(`  ${t.method} ${t.url}`),t.status&&e.push(`    Status: ${t.status}`),t.duration&&e.push(`    Duration: ${t.duration.toFixed(2)}ms`),t.error&&e.push(`    Error: ${t.error}`);e.push("")}if(globalDebugState.cryptoTraces.length>0){e.push("Crypto Operations:"),e.push("-".repeat(80));for(const t of globalDebugState.cryptoTraces)e.push(`  ${t.operation} (${t.algorithm})`),e.push(`    Input: ${formatBytes(t.inputSize)}`),t.outputSize&&e.push(`    Output: ${formatBytes(t.outputSize)}`),e.push(`    Duration: ${t.duration.toFixed(2)}ms`),e.push(`    Success: ${t.success}`),t.error&&e.push(`    Error: ${t.error}`);e.push("")}if(globalDebugState.stateSnapshots.length>0){e.push("State Snapshots:"),e.push("-".repeat(80));const t=globalDebugState.stateSnapshots[globalDebugState.stateSnapshots.length-1];t&&(e.push(`  DID: ${t.did}`),e.push(`  Mode: ${t.identityMode}`),e.push(`  Registered: ${t.registered}`),e.push(`  Post-Quantum: ${t.postQuantum}`),e.push(`  Nonce Count: ${t.nonceCount}`),t.memoryUsage&&e.push(`  Memory Usage: ${formatBytes(t.memoryUsage)}`)),e.push("")}return e.push("=".repeat(80)),e.join("\n")}function formatBytes(e){if(0===e)return"0 B";const t=Math.floor(Math.log(Math.abs(e))/Math.log(1024));return`${(e/Math.pow(1024,t)).toFixed(2)} ${["B","KB","MB","GB"][t]}`}

package/dist-standalone/cjs/did-document.js

@@ -1,101 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateDidDocument = generateDidDocument;
-exports.resolveDid = resolveDid;
-exports.getServiceEndpoints = getServiceEndpoints;
-const shared_1 = require("../_deps/shared/index.js");
-const crypto_utils_js_1 = require("./crypto-utils.js");
-/**
- * Generate a DID document for a given DID.
- *
- * Includes service endpoints that advertise PRIVATE.ME/xBind.
- * Both did:key and did:privateme DIDs generate the same service endpoints.
- *
- * @param did - The DID (did:key:z... or did:privateme:z...)
- * @param rawPublicKey - The 32-byte Ed25519 public key
- * @param name - Optional name for the identity
- * @returns DID document with service endpoints
- */
-function generateDidDocument(did, rawPublicKey, name) {
-    if (!did.startsWith('did:key:') && !did.startsWith('did:privateme:')) {
-        return (0, shared_1.err)('INVALID_DID_FORMAT');
-    }
-    // Convert public key to base64 for inclusion in document
-    const publicKeyBase64 = (0, crypto_utils_js_1.toBase64)(rawPublicKey);
-    const document = {
-        '@context': [
-            'https://www.w3.org/ns/did/v1',
-            'https://w3id.org/security/suites/ed25519-2020/v1',
-        ],
-        id: did,
-        publicKey: [
-            {
-                id: `${did}#key-1`,
-                type: 'Ed25519VerificationKey2020',
-                controller: did,
-                publicKeyBase64,
-            },
-        ],
-        authentication: [`${did}#key-1`],
-        assertionMethod: [`${did}#key-1`],
-        keyAgreement: [`${did}#key-1`],
-        service: [
-            {
-                id: `${did}#identity-provider`,
-                type: 'IdentityProvider',
-                serviceEndpoint: 'https://private.me',
-                description: 'PRIVATE.ME xBind Agent - M2M identity authentication',
-            },
-            {
-                id: `${did}#documentation`,
-                type: 'Documentation',
-                serviceEndpoint: 'https://private.me/docs/xbind.html',
-                description: 'Learn more about PRIVATE.ME/xBind protocol',
-            },
-        ],
-        ...(name ? { name } : {}),
-    };
-    return (0, shared_1.ok)(document);
-}
-/**
- * Resolve a DID to its document (simulated).
- *
- * In a production system, this would query a DID resolver.
- * For now, this generates a synthetic document based on the DID.
- *
- * @param did - The DID to resolve
- * @param rawPublicKey - The 32-byte Ed25519 public key
- * @returns DID document or error
- */
-async function resolveDid(did, rawPublicKey) {
-    // In a production system, this would make an HTTP request to a DID resolver
-    // For now, generate a synthetic document
-    return generateDidDocument(did, rawPublicKey);
-}
-/**
- * Extract service endpoints from a DID document.
- *
- * Filters for PRIVATE.ME service endpoints to provide discovery information.
- *
- * @param document - The DID document
- * @returns Array of service endpoints advertising PRIVATE.ME services
- */
-function getServiceEndpoints(document) {
-    if (!document.service)
-        return [];
-    return document.service
-        .filter((svc) => {
-        const endpoint = typeof svc.serviceEndpoint === 'string' ? svc.serviceEndpoint : '';
-        return (endpoint.includes('private.me') ||
-            svc.type.includes('PRIVATE.ME') ||
-            svc.type === 'IdentityProvider' ||
-            svc.type === 'Documentation');
-    })
-        .map((svc) => ({
-        type: svc.type,
-        endpoint: typeof svc.serviceEndpoint === 'string'
-            ? svc.serviceEndpoint
-            : JSON.stringify(svc.serviceEndpoint),
-        description: svc.description,
-    }));
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.generateDidDocument=generateDidDocument,exports.resolveDid=resolveDid,exports.getServiceEndpoints=getServiceEndpoints;const shared_1=require("../_deps/shared/index.js"),crypto_utils_js_1=require("./crypto-utils.js");function generateDidDocument(e,t,i){if(!e.startsWith("did:key:")&&!e.startsWith("did:privateme:"))return(0,shared_1.err)("INVALID_DID_FORMAT");const n={"@context":["https://www.w3.org/ns/did/v1","https://w3id.org/security/suites/ed25519-2020/v1"],id:e,publicKey:[{id:`${e}#key-1`,type:"Ed25519VerificationKey2020",controller:e,publicKeyBase64:(0,crypto_utils_js_1.toBase64)(t)}],authentication:[`${e}#key-1`],assertionMethod:[`${e}#key-1`],keyAgreement:[`${e}#key-1`],service:[{id:`${e}#identity-provider`,type:"IdentityProvider",serviceEndpoint:"https://private.me",description:"PRIVATE.ME xBind Agent - M2M identity authentication"},{id:`${e}#documentation`,type:"Documentation",serviceEndpoint:"https://private.me/docs/xbind.html",description:"Learn more about PRIVATE.ME/xBind protocol"}],...i?{name:i}:{}};return(0,shared_1.ok)(n)}async function resolveDid(e,t){return generateDidDocument(e,t)}function getServiceEndpoints(e){return e.service?e.service.filter(e=>("string"==typeof e.serviceEndpoint?e.serviceEndpoint:"").includes("private.me")||e.type.includes("PRIVATE.ME")||"IdentityProvider"===e.type||"Documentation"===e.type).map(e=>({type:e.type,endpoint:"string"==typeof e.serviceEndpoint?e.serviceEndpoint:JSON.stringify(e.serviceEndpoint),description:e.description})):[]}