@nindroidsystems/pluginator 2.3.0

package/dist/infrastructure/http.d.ts

@@ -0,0 +1,152 @@
+/**
+ * HTTP Client
+ *
+ * Provides HTTP request utilities with progress tracking,
+ * retries, and error handling using Bun's native fetch
+ */
+import { NetworkError } from '../core/errors/index.js';
+/**
+ * HTTP request options
+ */
+export interface HttpRequestOptions {
+    timeout?: number;
+    headers?: Record<string, string>;
+    retries?: number;
+    retryDelay?: number;
+    userAgent?: string;
+}
+/**
+ * Download options with progress callback
+ */
+export interface DownloadOptions extends HttpRequestOptions {
+    onProgress?: (percent: number, bytesDownloaded: number, totalBytes: number) => void;
+    expectedSize?: number;
+}
+/**
+ * HTTP response wrapper
+ */
+export interface HttpResponse<T> {
+    data: T;
+    status: number;
+    headers: Headers;
+    url: string;
+}
+/**
+ * HTTP error with additional context
+ * @deprecated Use NetworkError from core/errors instead
+ */
+export declare class HttpError extends NetworkError {
+    readonly status?: number | undefined;
+    readonly url?: string | undefined;
+    readonly name: string;
+    constructor(message: string, status?: number | undefined, url?: string | undefined, retryable?: boolean);
+}
+/**
+ * Error thrown when attempting network operations while offline
+ * @deprecated Use NetworkError with OFFLINE code from core/errors instead
+ */
+export declare class OfflineError extends NetworkError {
+    readonly name: string;
+    constructor(operation: string);
+}
+/**
+ * Circuit breaker options
+ */
+export interface CircuitBreakerOptions {
+    /** Number of failures before opening circuit (default: 5) */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit (default: 30000) */
+    resetTimeout?: number;
+    /** Number of successful requests to fully close circuit (default: 2) */
+    successThreshold?: number;
+}
+/**
+ * Circuit breaker pattern to prevent cascading failures
+ *
+ * States:
+ * - closed: Normal operation, requests pass through
+ * - open: Failures exceeded threshold, requests are blocked
+ * - half-open: Testing if service has recovered
+ *
+ * @since v1.40.0
+ */
+export declare class CircuitBreaker {
+    private states;
+    private readonly failureThreshold;
+    private readonly resetTimeout;
+    private readonly successThreshold;
+    constructor(options?: CircuitBreakerOptions);
+    /**
+     * Extract hostname from URL
+     */
+    private getHostname;
+    /**
+     * Check if a request can proceed for the given URL
+     */
+    canRequest(url: string): boolean;
+    /**
+     * Get the current state for a URL
+     */
+    getState(url: string): 'closed' | 'open' | 'half-open';
+    /**
+     * Record a successful request
+     */
+    recordSuccess(url: string): void;
+    /**
+     * Record a failed request
+     */
+    recordFailure(url: string): void;
+    /**
+     * Reset the circuit breaker for a URL
+     */
+    reset(url: string): void;
+    /**
+     * Reset all circuit breakers
+     */
+    resetAll(): void;
+    /**
+     * Get statistics for all hosts
+     */
+    getStats(): Map<string, {
+        state: string;
+        failures: number;
+        lastFailure: Date | null;
+    }>;
+}
+/**
+ * Get the global circuit breaker instance
+ */
+export declare function getCircuitBreaker(): CircuitBreaker;
+/**
+ * Make an HTTP GET request and return JSON
+ */
+export declare function httpGet<T>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Make an HTTP POST request with retry logic
+ */
+export declare function httpPost<T, B = unknown>(url: string, body: B, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Download result with metadata
+ */
+export interface DownloadResult {
+    bytesDownloaded: number;
+    url: string;
+    suggestedFilename?: string;
+}
+/**
+ * Download a file to disk with progress tracking
+ */
+export declare function downloadFile(url: string, outputPath: string, options?: DownloadOptions): Promise<DownloadResult>;
+/**
+ * Download a file to disk using streams (for large files)
+ */
+export declare function downloadFileStream(url: string, outputPath: string, options?: DownloadOptions): Promise<DownloadResult>;
+/**
+ * Check if a URL is reachable
+ */
+export declare function isUrlReachable(url: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Get the final URL after following redirects
+ */
+export declare function getRedirectUrl(url: string): Promise<string>;
+//# sourceMappingURL=http.d.ts.map

package/dist/infrastructure/http.d.ts.map

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

package/dist/infrastructure/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Infrastructure module exports
+ */
+export { httpGet, httpPost, downloadFile, downloadFileStream, isUrlReachable, getRedirectUrl, HttpError, OfflineError, type HttpRequestOptions, type DownloadOptions, type HttpResponse, } from './http.js';
+export { NetworkError, isNetworkError, type NetworkErrorCode } from '../core/errors/index.js';
+export { isOnline, invalidateNetworkCache, getCachedNetworkStatus } from './network-status.js';
+export { hashBuffer, hashString, hashFile, hashFileStream, hashFileMultiple, verifyChecksum, verifyChecksums, detectAlgorithm, isValidHashFormat, formatHash, type HashAlgorithm, type HashResult, type VerifyResult, } from './checksum.js';
+export { createBackup, createSimpleBackup, restoreBackup, listBackupContents, backupFile, rotateBackups, getBackupInfo, generateBackupFilename, type BackupMetadata, type BackupOptions, type BackupResult, type RestoreOptions, } from './backup.js';
+export { safePath, safeJoin, isWithinDirectory, expandHome, normalizePath, getUniqueFilename, ensureDirectory, ensureDirectorySync, pathExists, isDirectory, isFile, isReadable, isWritable, listDirectory, findFiles, getRelativePath, getTempDir, sanitizeFilename, isValidFilename, extractPluginName, type PathValidationResult, type DirectoryEntry, } from './path.js';
+export { Logger, OperationLogger, getLogger, configureLogger, createLogger, log, serializeError, parseCategoryFilter, categoryMatches, type LogLevel, type LoggerOptions, type LogEntry, type LogContext, type SerializedError, } from './logger.js';
+export { formatBytes, formatBytesAuto, formatDownloadProgress, formatPercent, type FormatBytesOptions, } from './format.js';
+export { encrypt, decrypt, deriveKey, type EncryptedData } from './crypto.js';
+export { secureZeroBuffer, createSessionHmac, verifySessionIntegrity } from './crypto-security.js';
+export { getMachineIdentifier } from './machine-id.js';
+export { getSleepPrevention, createSleepPrevention, resetSleepPrevention, withSleepPrevention, type Platform as SleepPlatform, type SleepPreventionService, } from './sleep-prevention.js';
+export { LOG_CATEGORIES, LOG_CAT_CORE, LOG_CAT_SCANNER, LOG_CAT_SOURCES, LOG_CAT_SOURCES_SPIGOT, LOG_CAT_SOURCES_MODRINTH, LOG_CAT_SOURCES_GITHUB, LOG_CAT_SOURCES_CURSEFORGE, LOG_CAT_SOURCES_HANGAR, LOG_CAT_SOURCES_MANIFEST, LOG_CAT_SYNC, LOG_CAT_BACKUP, LOG_CAT_DOWNLOAD, LOG_CAT_UPDATE_CHECK, LOG_CAT_NETWORK, LOG_CAT_CONFIG, LOG_CAT_UI, LOG_CAT_CLI, LOG_CAT_PLUGIN_MANAGER, LOG_CAT_SERVER, RECOMMENDED_CATEGORY_LEVELS, type LogCategory, } from './log-categories.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,SAAS,EACT,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG9F,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG/F,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,MAAM,EACN,UAAU,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,MAAM,EACN,eAAe,EACf,SAAS,EACT,eAAe,EACf,YAAY,EACZ,GAAG,EACH,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAG9E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAGnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,QAAQ,IAAI,aAAa,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,2BAA2B,EAC3B,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/infrastructure/log-categories.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Log Categories
+ *
+ * Standardized category constants for consistent logging across the application.
+ * Use these constants when creating child loggers or filtering logs.
+ */
+/**
+ * Core application lifecycle and startup
+ */
+export declare const LOG_CAT_CORE = "core";
+/**
+ * Plugin JAR scanning operations
+ */
+export declare const LOG_CAT_SCANNER = "scanner";
+/**
+ * Plugin source interactions (base category)
+ */
+export declare const LOG_CAT_SOURCES = "sources";
+/**
+ * Spigot plugin source
+ */
+export declare const LOG_CAT_SOURCES_SPIGOT = "sources:spigot";
+/**
+ * Modrinth plugin source
+ */
+export declare const LOG_CAT_SOURCES_MODRINTH = "sources:modrinth";
+/**
+ * GitHub plugin source
+ */
+export declare const LOG_CAT_SOURCES_GITHUB = "sources:github";
+/**
+ * CurseForge plugin source
+ */
+export declare const LOG_CAT_SOURCES_CURSEFORGE = "sources:curseforge";
+/**
+ * Hangar plugin source
+ */
+export declare const LOG_CAT_SOURCES_HANGAR = "sources:hangar";
+/**
+ * Web manifest plugin source
+ */
+export declare const LOG_CAT_SOURCES_MANIFEST = "sources:manifest";
+/**
+ * Sync workflow operations
+ */
+export declare const LOG_CAT_SYNC = "sync";
+/**
+ * Backup operations
+ */
+export declare const LOG_CAT_BACKUP = "backup";
+/**
+ * Download operations
+ */
+export declare const LOG_CAT_DOWNLOAD = "download";
+/**
+ * Update checking workflow
+ */
+export declare const LOG_CAT_UPDATE_CHECK = "update-check";
+/**
+ * Network/HTTP operations
+ */
+export declare const LOG_CAT_NETWORK = "network";
+/**
+ * Configuration loading/saving
+ */
+export declare const LOG_CAT_CONFIG = "config";
+/**
+ * Terminal UI operations
+ */
+export declare const LOG_CAT_UI = "ui";
+/**
+ * CLI command handling
+ */
+export declare const LOG_CAT_CLI = "cli";
+/**
+ * Plugin manager operations
+ */
+export declare const LOG_CAT_PLUGIN_MANAGER = "plugin-manager";
+/**
+ * Server management operations
+ */
+export declare const LOG_CAT_SERVER = "server";
+/**
+ * Authentication operations
+ * @since v1.36.0
+ */
+export declare const LOG_CAT_AUTH = "auth";
+/**
+ * Rollback operations
+ * @since v1.36.0
+ */
+export declare const LOG_CAT_ROLLBACK = "rollback";
+/**
+ * Migration operations
+ * @since v1.36.0
+ */
+export declare const LOG_CAT_MIGRATION = "migration";
+/**
+ * React hook lifecycle (debug)
+ * @since v1.36.0
+ */
+export declare const LOG_CAT_HOOK = "hook";
+/**
+ * Jenkins plugin source
+ * @since v1.36.0
+ */
+export declare const LOG_CAT_SOURCES_JENKINS = "sources:jenkins";
+/**
+ * Plugin registry operations
+ * @since v1.52.4
+ */
+export declare const LOG_CAT_REGISTRY = "registry";
+/**
+ * All available log categories
+ */
+export declare const LOG_CATEGORIES: {
+    readonly CORE: "core";
+    readonly SCANNER: "scanner";
+    readonly SOURCES: "sources";
+    readonly SOURCES_SPIGOT: "sources:spigot";
+    readonly SOURCES_MODRINTH: "sources:modrinth";
+    readonly SOURCES_GITHUB: "sources:github";
+    readonly SOURCES_CURSEFORGE: "sources:curseforge";
+    readonly SOURCES_HANGAR: "sources:hangar";
+    readonly SOURCES_MANIFEST: "sources:manifest";
+    readonly SOURCES_JENKINS: "sources:jenkins";
+    readonly SYNC: "sync";
+    readonly BACKUP: "backup";
+    readonly DOWNLOAD: "download";
+    readonly UPDATE_CHECK: "update-check";
+    readonly NETWORK: "network";
+    readonly CONFIG: "config";
+    readonly UI: "ui";
+    readonly CLI: "cli";
+    readonly PLUGIN_MANAGER: "plugin-manager";
+    readonly SERVER: "server";
+    readonly AUTH: "auth";
+    readonly ROLLBACK: "rollback";
+    readonly MIGRATION: "migration";
+    readonly HOOK: "hook";
+    readonly REGISTRY: "registry";
+};
+/**
+ * Type for log category values
+ */
+export type LogCategory = (typeof LOG_CATEGORIES)[keyof typeof LOG_CATEGORIES];
+/**
+ * Recommended default log levels per category
+ * Used when LOG_LEVEL is not set to provide sensible defaults
+ */
+export declare const RECOMMENDED_CATEGORY_LEVELS: Record<string, 'debug' | 'info' | 'warn' | 'error'>;
+//# sourceMappingURL=log-categories.d.ts.map

package/dist/infrastructure/log-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-categories.d.ts","sourceRoot":"","sources":["../../src/infrastructure/log-categories.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,eAAe,YAAY,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,eAAe,YAAY,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,eAAe,YAAY,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAoB3F,CAAC"}

package/dist/infrastructure/logger.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Logger
+ *
+ * Provides structured logging with levels, formatting, file rotation,
+ * operation tracing, and performance timing.
+ */
+/**
+ * Log levels in order of severity
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Structured context data for log entries
+ */
+export interface LogContext {
+    [key: string]: unknown;
+}
+/**
+ * Serialized error structure for logging
+ */
+export interface SerializedError {
+    name: string;
+    message: string;
+    code?: string;
+    plgCode?: string;
+    stack?: string[];
+    cause?: SerializedError;
+}
+/**
+ * Log entry structure (enhanced)
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    category?: string;
+    duration?: number;
+    operationId?: string;
+    context?: LogContext;
+    error?: SerializedError;
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerOptions {
+    level?: LogLevel;
+    console?: boolean;
+    stderr?: boolean;
+    colorize?: boolean;
+    filePath?: string;
+    /** Path for human-readable log file (separate from JSONL) */
+    humanReadablePath?: string;
+    maxFileSize?: number;
+    maxFiles?: number;
+    timestamps?: boolean;
+    name?: string;
+    /** Category filter patterns (e.g., ['sources:*', '-sources:github']) */
+    categoryFilter?: string[];
+    /** Per-category log levels */
+    categoryLevels?: Record<string, LogLevel>;
+    /** Duration threshold for warning (ms) */
+    warnThreshold?: number;
+    /** Duration threshold for slow indicator (ms) */
+    slowThreshold?: number;
+    /** Make log files read-only after writing */
+    readOnlyFiles?: boolean;
+}
+/**
+ * Serialize an error for structured logging
+ */
+export declare function serializeError(error: Error): SerializedError;
+/**
+ * Parse category filter patterns from environment or config
+ */
+export declare function parseCategoryFilter(patterns: string | string[]): string[];
+/**
+ * Check if a category matches the filter patterns
+ */
+export declare function categoryMatches(category: string, patterns: string[]): boolean;
+/**
+ * Logger class with multiple outputs, rotation, and structured logging
+ */
+export declare class Logger {
+    protected options: Required<LoggerOptions>;
+    protected operationId?: string;
+    constructor(options?: LoggerOptions);
+    /**
+     * Check if a log level should be output
+     */
+    private shouldLog;
+    /**
+     * Format a log entry for human-readable console output
+     */
+    private formatForConsole;
+    /**
+     * Format context data for console output
+     */
+    private formatContextForConsole;
+    /**
+     * Format a log entry as JSONL for file output
+     */
+    private formatAsJsonl;
+    /**
+     * Rotate log files if needed
+     * @param targetPath Optional specific file path to rotate (defaults to JSONL file)
+     */
+    private rotateIfNeeded;
+    /**
+     * Get the effective file path (inherit from global logger if not set locally)
+     */
+    private getEffectiveFilePath;
+    /**
+     * Get the effective human-readable file path (inherit from global logger if not set locally)
+     */
+    private getEffectiveHumanReadablePath;
+    /**
+     * Get the effective log level (inherit from global logger if not set locally)
+     */
+    private getEffectiveLevel;
+    /**
+     * Write a log entry
+     */
+    private write;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, context?: LogContext): void;
+    /**
+     * Log an error with full serialization
+     */
+    logError(error: Error, context?: LogContext): void;
+    /**
+     * Start timing an operation
+     * Returns an end function that logs the duration
+     */
+    time(label: string): () => void;
+    /**
+     * Log a message with duration
+     */
+    logWithDuration(level: LogLevel, message: string, duration: number, context?: LogContext): void;
+    /**
+     * Start a traced operation
+     * Returns an OperationLogger that includes the operation ID in all logs
+     */
+    startOperation(name: string): OperationLogger;
+    /**
+     * Create a child logger with a specific name
+     */
+    child(name: string): Logger;
+    /**
+     * Create a child logger with a specific operation ID (used internally)
+     */
+    protected createChildWithOperationId(name: string, opId?: string): Logger;
+    /**
+     * Set the log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get the current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Get the logger name/category
+     */
+    getName(): string;
+}
+/**
+ * Logger for traced operations with automatic timing and operation ID
+ */
+export declare class OperationLogger extends Logger {
+    private readonly opId;
+    private operationName;
+    private startTime;
+    constructor(options: LoggerOptions, operationName: string, operationId: string);
+    /**
+     * Get the operation ID
+     */
+    getOperationId(): string;
+    /**
+     * End the operation and log completion
+     */
+    end(result?: 'success' | 'failure', context?: LogContext): void;
+    /**
+     * Create a child logger that preserves the operation ID
+     */
+    child(name: string): Logger;
+}
+/**
+ * Get or create the global logger
+ */
+export declare function getLogger(): Logger;
+/**
+ * Configure the global logger
+ */
+export declare function configureLogger(options: LoggerOptions): Logger;
+/**
+ * Create a named logger (child of global)
+ */
+export declare function createLogger(name: string, options?: LoggerOptions): Logger;
+/**
+ * Convenience exports for global logger
+ */
+export declare const log: {
+    debug: (message: string, context?: LogContext) => void;
+    info: (message: string, context?: LogContext) => void;
+    warn: (message: string, context?: LogContext) => void;
+    error: (message: string, context?: LogContext) => void;
+    logError: (error: Error, context?: LogContext) => void;
+    time: (label: string) => () => void;
+    startOperation: (name: string) => OperationLogger;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/infrastructure/logger.d.ts.map

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

package/dist/infrastructure/machine-id.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Machine ID Utilities
+ *
+ * Generates a machine-specific identifier for encryption key derivation.
+ * The identifier is deterministic for a given machine but differs across machines.
+ */
+/**
+ * Get a deterministic machine identifier
+ *
+ * Combines several machine-specific values and hashes them to produce
+ * a consistent identifier. This is used for key derivation so that
+ * encrypted tokens can only be decrypted on the same machine.
+ *
+ * Components:
+ * - hostname: Machine name
+ * - homedir: User's home directory path
+ * - username: Current username
+ * - arch: CPU architecture (x64, arm64, etc.)
+ *
+ * @returns SHA-256 hash of combined machine identifiers (64 hex chars)
+ */
+export declare function getMachineIdentifier(): string;
+//# sourceMappingURL=machine-id.d.ts.map

package/dist/infrastructure/machine-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-id.d.ts","sourceRoot":"","sources":["../../src/infrastructure/machine-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C"}

package/dist/infrastructure/network-status.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Network Status Utility
+ *
+ * Provides connectivity detection with caching to avoid
+ * excessive network checks while still detecting offline state.
+ */
+/**
+ * Check if we have internet connectivity.
+ * Uses cached result if checked recently to avoid hammering the network.
+ */
+export declare function isOnline(): Promise<boolean>;
+/**
+ * Force refresh the network status cache.
+ * Call this after a known network change.
+ */
+export declare function invalidateNetworkCache(): void;
+/**
+ * Get the cached network status without making a request.
+ * Returns null if cache is expired or never checked.
+ */
+export declare function getCachedNetworkStatus(): boolean | null;
+//# sourceMappingURL=network-status.d.ts.map

package/dist/infrastructure/network-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-status.d.ts","sourceRoot":"","sources":["../../src/infrastructure/network-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAgDjD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,GAAG,IAAI,CAKvD"}