@private.me/xbind 3.0.0 → 3.0.2

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

@@ -1 +1,534 @@
-"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={did:e.did,identityMode:e.identityMode??"persistent",registered:e.registered??!1,registryUrl:e.registry?.url,nonceStoreType:e.nonceStore?.constructor?.name??"unknown",nonceCount:e.nonceStore?.size??0,transportType:e.transport?.constructor?.name??"unknown",securityPolicy:{level:e.securityPolicy?.level??"unknown",replayWindow:e.securityPolicy?.replayWindow??0,timestampTolerance:e.securityPolicy?.timestampTolerance??0},postQuantum:e.postQuantum??!1,memoryUsage:"undefined"!=typeof process&&process.memoryUsage?process.memoryUsage().heapUsed:void 0,timestamp:Date.now()};globalDebugState.enabled&&globalDebugState.options.traceState&&globalDebugState.stateSnapshots.push(t);return createDebugLogger("state").trace("[STATE] Agent snapshot",t),t}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]}`}
+"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]}`;
+}

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

@@ -1 +1,101 @@
-"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})):[]}
+"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,
+    }));
+}