@quiltdata/benchling-webhook 0.5.4-20251102T020826Z → 0.5.4-20251103T180145Z

package/dist/lib/config-logger.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Configuration Diagnostic Logging
+ *
+ * Provides comprehensive logging for configuration operations:
+ * - Configuration sources tracking
+ * - Operation audit trail
+ * - Troubleshooting insights
+ * - Performance metrics
+ *
+ * @module lib/config-logger
+ */
+/**
+ * Log level enumeration
+ */
+export declare enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARN = "WARN",
+    ERROR = "ERROR"
+}
+/**
+ * Log entry structure
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    operation: string;
+    message: string;
+    data?: Record<string, unknown>;
+    source?: string;
+    profileName?: string;
+    duration?: number;
+}
+/**
+ * Configuration operation types
+ */
+export declare enum ConfigOperation {
+    READ = "read",
+    WRITE = "write",
+    VALIDATE = "validate",
+    MERGE = "merge",
+    SYNC_SECRETS = "sync-secrets",
+    INFER_CONFIG = "infer-config",
+    CREATE_PROFILE = "create-profile",
+    DELETE_PROFILE = "delete-profile"
+}
+/**
+ * Configuration logger for diagnostic and audit purposes
+ */
+export declare class ConfigLogger {
+    private logFile;
+    private enableConsole;
+    private minLogLevel;
+    /**
+     * Creates a new configuration logger
+     *
+     * @param options - Logger configuration options
+     */
+    constructor(options?: {
+        logFile?: string;
+        enableConsole?: boolean;
+        minLogLevel?: LogLevel;
+    });
+    /**
+     * Gets log level priority for comparison
+     *
+     * @param level - Log level
+     * @returns Priority number (higher = more severe)
+     */
+    private getLogLevelPriority;
+    /**
+     * Checks if log level should be output
+     *
+     * @param level - Log level to check
+     * @returns True if should log
+     */
+    private shouldLog;
+    /**
+     * Formats log entry for output
+     *
+     * @param entry - Log entry
+     * @returns Formatted log string
+     */
+    private formatLogEntry;
+    /**
+     * Writes log entry to file and console
+     *
+     * @param entry - Log entry to write
+     */
+    private writeLog;
+    /**
+     * Logs a debug message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    debug(operation: ConfigOperation | string, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs an info message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    info(operation: ConfigOperation | string, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs a warning message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    warn(operation: ConfigOperation | string, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs an error message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    error(operation: ConfigOperation | string, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Logs configuration operation with timing
+     *
+     * @param operation - Configuration operation
+     * @param profileName - Profile name
+     * @param source - Configuration source
+     * @param fn - Function to execute and time
+     * @returns Result of the function
+     */
+    logOperation<T>(operation: ConfigOperation, profileName: string, source: string, fn: () => Promise<T> | T): Promise<T>;
+    /**
+     * Logs configuration read operation
+     *
+     * @param profileName - Profile name
+     * @param configType - Configuration type
+     * @param success - Whether read was successful
+     * @param source - Configuration source
+     */
+    logRead(profileName: string, configType: string, success: boolean, source?: string): void;
+    /**
+     * Logs configuration write operation
+     *
+     * @param profileName - Profile name
+     * @param configType - Configuration type
+     * @param success - Whether write was successful
+     * @param source - Configuration source
+     */
+    logWrite(profileName: string, configType: string, success: boolean, source?: string): void;
+    /**
+     * Logs configuration validation
+     *
+     * @param profileName - Profile name
+     * @param isValid - Whether configuration is valid
+     * @param errors - Validation errors
+     */
+    logValidation(profileName: string, isValid: boolean, errors?: string[]): void;
+    /**
+     * Logs secrets sync operation
+     *
+     * @param profileName - Profile name
+     * @param secretArn - Secret ARN
+     * @param action - Action performed (created/updated/skipped)
+     */
+    logSecretsSync(profileName: string, secretArn: string, action: string): void;
+    /**
+     * Gets the log file path
+     *
+     * @returns Log file path
+     */
+    getLogFile(): string;
+}
+/**
+ * Gets or creates the global configuration logger
+ *
+ * @param options - Logger options (only used on first call)
+ * @returns Configuration logger instance
+ */
+export declare function getConfigLogger(options?: {
+    logFile?: string;
+    enableConsole?: boolean;
+    minLogLevel?: LogLevel;
+}): ConfigLogger;
+/**
+ * Sets the global configuration logger
+ *
+ * @param logger - Logger instance
+ */
+export declare function setConfigLogger(logger: ConfigLogger): void;
+//# sourceMappingURL=config-logger.d.ts.map

package/dist/lib/config-logger.d.ts.map

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

package/dist/lib/config-logger.js

@@ -0,0 +1,372 @@
+"use strict";
+/**
+ * Configuration Diagnostic Logging
+ *
+ * Provides comprehensive logging for configuration operations:
+ * - Configuration sources tracking
+ * - Operation audit trail
+ * - Troubleshooting insights
+ * - Performance metrics
+ *
+ * @module lib/config-logger
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigLogger = exports.ConfigOperation = exports.LogLevel = void 0;
+exports.getConfigLogger = getConfigLogger;
+exports.setConfigLogger = setConfigLogger;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+/**
+ * Log level enumeration
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["WARN"] = "WARN";
+    LogLevel["ERROR"] = "ERROR";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Configuration operation types
+ */
+var ConfigOperation;
+(function (ConfigOperation) {
+    ConfigOperation["READ"] = "read";
+    ConfigOperation["WRITE"] = "write";
+    ConfigOperation["VALIDATE"] = "validate";
+    ConfigOperation["MERGE"] = "merge";
+    ConfigOperation["SYNC_SECRETS"] = "sync-secrets";
+    ConfigOperation["INFER_CONFIG"] = "infer-config";
+    ConfigOperation["CREATE_PROFILE"] = "create-profile";
+    ConfigOperation["DELETE_PROFILE"] = "delete-profile";
+})(ConfigOperation || (exports.ConfigOperation = ConfigOperation = {}));
+/**
+ * Configuration logger for diagnostic and audit purposes
+ */
+class ConfigLogger {
+    /**
+     * Creates a new configuration logger
+     *
+     * @param options - Logger configuration options
+     */
+    constructor(options) {
+        const { logFile, enableConsole = true, minLogLevel = LogLevel.INFO } = options || {};
+        // Default log file location
+        const logDir = (0, path_1.resolve)((0, os_1.homedir)(), ".config", "benchling-webhook", "logs");
+        if (!(0, fs_1.existsSync)(logDir)) {
+            (0, fs_1.mkdirSync)(logDir, { recursive: true });
+        }
+        this.logFile = logFile || (0, path_1.resolve)(logDir, "config.log");
+        this.enableConsole = enableConsole;
+        this.minLogLevel = minLogLevel;
+    }
+    /**
+     * Gets log level priority for comparison
+     *
+     * @param level - Log level
+     * @returns Priority number (higher = more severe)
+     */
+    getLogLevelPriority(level) {
+        switch (level) {
+            case LogLevel.DEBUG:
+                return 0;
+            case LogLevel.INFO:
+                return 1;
+            case LogLevel.WARN:
+                return 2;
+            case LogLevel.ERROR:
+                return 3;
+            default:
+                return 1;
+        }
+    }
+    /**
+     * Checks if log level should be output
+     *
+     * @param level - Log level to check
+     * @returns True if should log
+     */
+    shouldLog(level) {
+        return this.getLogLevelPriority(level) >= this.getLogLevelPriority(this.minLogLevel);
+    }
+    /**
+     * Formats log entry for output
+     *
+     * @param entry - Log entry
+     * @returns Formatted log string
+     */
+    formatLogEntry(entry) {
+        const parts = [
+            entry.timestamp,
+            `[${entry.level}]`,
+            `[${entry.operation}]`,
+            entry.message,
+        ];
+        if (entry.source) {
+            parts.push(`source=${entry.source}`);
+        }
+        if (entry.profileName) {
+            parts.push(`profile=${entry.profileName}`);
+        }
+        if (entry.duration !== undefined) {
+            parts.push(`duration=${entry.duration}ms`);
+        }
+        if (entry.data) {
+            parts.push(`data=${JSON.stringify(entry.data)}`);
+        }
+        return parts.join(" ");
+    }
+    /**
+     * Writes log entry to file and console
+     *
+     * @param entry - Log entry to write
+     */
+    writeLog(entry) {
+        if (!this.shouldLog(entry.level)) {
+            return;
+        }
+        const formattedLog = this.formatLogEntry(entry);
+        // Write to file
+        try {
+            (0, fs_1.appendFileSync)(this.logFile, formattedLog + "\n", "utf-8");
+        }
+        catch (error) {
+            console.error(`Failed to write log: ${error.message}`);
+        }
+        // Write to console
+        if (this.enableConsole) {
+            switch (entry.level) {
+                case LogLevel.DEBUG:
+                    console.debug(formattedLog);
+                    break;
+                case LogLevel.INFO:
+                    console.log(formattedLog);
+                    break;
+                case LogLevel.WARN:
+                    console.warn(formattedLog);
+                    break;
+                case LogLevel.ERROR:
+                    console.error(formattedLog);
+                    break;
+            }
+        }
+    }
+    /**
+     * Logs a debug message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    debug(operation, message, data) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.DEBUG,
+            operation,
+            message,
+            data,
+        });
+    }
+    /**
+     * Logs an info message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    info(operation, message, data) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            operation,
+            message,
+            data,
+        });
+    }
+    /**
+     * Logs a warning message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    warn(operation, message, data) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.WARN,
+            operation,
+            message,
+            data,
+        });
+    }
+    /**
+     * Logs an error message
+     *
+     * @param operation - Configuration operation
+     * @param message - Log message
+     * @param data - Additional data
+     */
+    error(operation, message, data) {
+        this.writeLog({
+            timestamp: new Date().toISOString(),
+            level: LogLevel.ERROR,
+            operation,
+            message,
+            data,
+        });
+    }
+    /**
+     * Logs configuration operation with timing
+     *
+     * @param operation - Configuration operation
+     * @param profileName - Profile name
+     * @param source - Configuration source
+     * @param fn - Function to execute and time
+     * @returns Result of the function
+     */
+    async logOperation(operation, profileName, source, fn) {
+        const startTime = Date.now();
+        this.info(operation, "Starting operation", {
+            profileName,
+            source,
+        });
+        try {
+            const result = await fn();
+            const duration = Date.now() - startTime;
+            this.info(operation, "Operation completed successfully", {
+                profileName,
+                source,
+                duration,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.error(operation, `Operation failed: ${error.message}`, {
+                profileName,
+                source,
+                duration,
+                error: error.stack,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Logs configuration read operation
+     *
+     * @param profileName - Profile name
+     * @param configType - Configuration type
+     * @param success - Whether read was successful
+     * @param source - Configuration source
+     */
+    logRead(profileName, configType, success, source) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: success ? LogLevel.INFO : LogLevel.ERROR,
+            operation: ConfigOperation.READ,
+            message: `Configuration read ${success ? "successful" : "failed"}`,
+            profileName,
+            source,
+            data: {
+                configType,
+            },
+        };
+        this.writeLog(entry);
+    }
+    /**
+     * Logs configuration write operation
+     *
+     * @param profileName - Profile name
+     * @param configType - Configuration type
+     * @param success - Whether write was successful
+     * @param source - Configuration source
+     */
+    logWrite(profileName, configType, success, source) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: success ? LogLevel.INFO : LogLevel.ERROR,
+            operation: ConfigOperation.WRITE,
+            message: `Configuration write ${success ? "successful" : "failed"}`,
+            profileName,
+            source,
+            data: {
+                configType,
+            },
+        };
+        this.writeLog(entry);
+    }
+    /**
+     * Logs configuration validation
+     *
+     * @param profileName - Profile name
+     * @param isValid - Whether configuration is valid
+     * @param errors - Validation errors
+     */
+    logValidation(profileName, isValid, errors) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: isValid ? LogLevel.INFO : LogLevel.WARN,
+            operation: ConfigOperation.VALIDATE,
+            message: `Configuration validation ${isValid ? "passed" : "failed"}`,
+            profileName,
+            data: errors ? { errors } : undefined,
+        };
+        this.writeLog(entry);
+    }
+    /**
+     * Logs secrets sync operation
+     *
+     * @param profileName - Profile name
+     * @param secretArn - Secret ARN
+     * @param action - Action performed (created/updated/skipped)
+     */
+    logSecretsSync(profileName, secretArn, action) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: LogLevel.INFO,
+            operation: ConfigOperation.SYNC_SECRETS,
+            message: `Secrets ${action}`,
+            profileName,
+            data: {
+                secretArn,
+                action,
+            },
+        };
+        this.writeLog(entry);
+    }
+    /**
+     * Gets the log file path
+     *
+     * @returns Log file path
+     */
+    getLogFile() {
+        return this.logFile;
+    }
+}
+exports.ConfigLogger = ConfigLogger;
+/**
+ * Global configuration logger instance
+ */
+let globalLogger = null;
+/**
+ * Gets or creates the global configuration logger
+ *
+ * @param options - Logger options (only used on first call)
+ * @returns Configuration logger instance
+ */
+function getConfigLogger(options) {
+    if (!globalLogger) {
+        globalLogger = new ConfigLogger(options);
+    }
+    return globalLogger;
+}
+/**
+ * Sets the global configuration logger
+ *
+ * @param logger - Logger instance
+ */
+function setConfigLogger(logger) {
+    globalLogger = logger;
+}
+//# sourceMappingURL=config-logger.js.map

package/dist/lib/config-logger.js.map

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

package/dist/lib/configuration-saver.d.ts

@@ -0,0 +1,75 @@
+import { XDGConfig } from "./xdg-config";
+/**
+ * Configuration metadata
+ */
+export interface ConfigMetadata {
+    savedAt: string;
+    source: string;
+    version?: string;
+    inferredAt?: string;
+}
+/**
+ * Save options for configuration persistence
+ */
+export interface SaveOptions {
+    xdgConfig?: XDGConfig;
+    source?: string;
+    skipValidation?: boolean;
+    merge?: boolean;
+}
+/**
+ * Configuration saver for persisting configuration to XDG files
+ */
+export declare class ConfigurationSaver {
+    /**
+     * Default XDG config instance
+     */
+    private static defaultXDGConfig;
+    /**
+     * Get or create default XDG config instance
+     */
+    private static getDefaultXDGConfig;
+    /**
+     * Save configuration to user config file
+     *
+     * @param config - Configuration to save
+     * @param options - Save options
+     * @returns Saved configuration with metadata
+     */
+    static save(config: Record<string, string | number | boolean>, options?: SaveOptions): Promise<Record<string, string | number | boolean>>;
+    /**
+     * Save inferred configuration to derived config file
+     *
+     * @param config - Inferred configuration
+     * @param options - Save options
+     */
+    static saveToDerived(config: Record<string, string | number | boolean>, options?: SaveOptions): Promise<void>;
+    /**
+     * Save deployment outputs to deployment config file
+     *
+     * @param config - Deployment configuration
+     * @param options - Save options
+     */
+    static saveToDeployment(config: Record<string, string | number | boolean>, options?: SaveOptions): Promise<void>;
+    /**
+     * Create metadata for configuration
+     *
+     * @param options - Metadata options
+     * @returns Configuration metadata
+     */
+    static getMetadata(options?: Partial<ConfigMetadata>): ConfigMetadata;
+    /**
+     * Get the current version
+     *
+     * @returns Version string
+     */
+    private static getVersion;
+    /**
+     * Validate configuration before saving
+     *
+     * @param config - Configuration to validate
+     * @throws {Error} If configuration is invalid
+     */
+    private static validateConfig;
+}
+//# sourceMappingURL=configuration-saver.d.ts.map

package/dist/lib/configuration-saver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-saver.d.ts","sourceRoot":"","sources":["../../lib/configuration-saver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA0B;IAEzD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAQlC;;;;;;OAMG;WACiB,IAAI,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IA8CrD;;;;;OAKG;WACiB,aAAa,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAqBhB;;;;;OAKG;WACiB,gBAAgB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EACjD,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;OAKG;WACW,WAAW,CAAC,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc;IAShF;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAMzB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CAQhC"}