@creact-labs/creact 0.1.0

package/dist/utils/Logger.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+
+ * Licensed under the Apache License, Version 2.0 (the "License");
+
+ * you may not use this file except in compliance with the License.
+
+ * You may obtain a copy of the License at
+
+ *
+
+ *     http://www.apache.org/licenses/LICENSE-2.0
+
+ *
+
+ * Unless required by applicable law or agreed to in writing, software
+
+ * distributed under the License is distributed on an "AS IS" BASIS,
+
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+
+ * See the License for the specific language governing permissions and
+
+ * limitations under the License.
+
+ *
+
+ * Copyright 2025 Daniel Coutinho Ribeiro
+
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerFactory = exports.Logger = void 0;
+/**
+ * Log level priorities for filtering
+ */
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Scoped logger with level filtering
+ */
+class Logger {
+    constructor(scope, config, context = {}) {
+        this.scope = scope;
+        this.config = config;
+        this.context = context;
+        // Check if this scope is enabled
+        this.enabled = config.scopes.includes('*') || config.scopes.includes(scope);
+    }
+    /**
+     * Log a debug message
+     */
+    debug(message, ...args) {
+        this.log('debug', message, ...args);
+    }
+    /**
+     * Log an info message
+     */
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, ...args) {
+        this.log('warn', message, ...args);
+    }
+    /**
+     * Log an error message
+     */
+    error(message, ...args) {
+        this.log('error', message, ...args);
+    }
+    /**
+     * Create a child logger with additional context
+     */
+    child(additionalContext) {
+        return new Logger(this.scope, this.config, {
+            ...this.context,
+            ...additionalContext,
+        });
+    }
+    /**
+     * Internal log method with filtering
+     */
+    log(level, message, ...args) {
+        // Zero overhead when scope is disabled
+        if (!this.enabled) {
+            return;
+        }
+        // Filter by log level
+        if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.config.level]) {
+            return;
+        }
+        // Format: [timestamp] [scope] [level] message
+        const timestamp = new Date().toISOString();
+        const contextStr = Object.keys(this.context).length ? ` ${JSON.stringify(this.context)}` : '';
+        const formattedMessage = `[${timestamp}] [${this.scope}] [${level.toUpperCase()}]${contextStr} ${message}`;
+        // Output to stderr (not stdout) for all log levels
+        // This ensures user-facing output (stdout) is separate from debug logs (stderr)
+        switch (level) {
+            case 'debug':
+            case 'info':
+                console.error(formattedMessage, ...args);
+                break;
+            case 'warn':
+                console.warn(formattedMessage, ...args);
+                break;
+            case 'error':
+                console.error(formattedMessage, ...args);
+                break;
+        }
+    }
+}
+exports.Logger = Logger;
+/**
+ * Logger factory for creating scoped loggers
+ */
+class LoggerFactory {
+    /**
+     * Configure the logger factory
+     */
+    static configure(config) {
+        this.config = {
+            scopes: config.scopes ?? this.config.scopes,
+            level: config.level ?? this.config.level,
+        };
+    }
+    /**
+     * Get a logger for a specific scope
+     */
+    static getLogger(scope) {
+        return new Logger(scope, this.config);
+    }
+    /**
+     * Parse configuration from environment variables
+     * Supports CREACT_LOG=scope1,scope2 or CREACT_LOG=*
+     * Supports CREACT_LOG_LEVEL=debug|info|warn|error
+     */
+    static configureFromEnv() {
+        const scopesEnv = process.env.CREACT_LOG;
+        const levelEnv = process.env.CREACT_LOG_LEVEL;
+        const config = {};
+        if (scopesEnv) {
+            config.scopes = scopesEnv.split(',').map((s) => s.trim());
+        }
+        if (levelEnv && this.isValidLogLevel(levelEnv)) {
+            config.level = levelEnv;
+        }
+        if (Object.keys(config).length > 0) {
+            this.configure(config);
+        }
+    }
+    /**
+     * Parse configuration from CLI flags
+     * Supports --log=scope1,scope2 or --log=*
+     * Supports --log-level=debug|info|warn|error
+     */
+    static configureFromCLI(args) {
+        const config = {};
+        if (args.log) {
+            config.scopes = args.log.split(',').map((s) => s.trim());
+        }
+        if (args.logLevel && this.isValidLogLevel(args.logLevel)) {
+            config.level = args.logLevel;
+        }
+        if (Object.keys(config).length > 0) {
+            this.configure(config);
+        }
+    }
+    /**
+     * Parse configuration from config file
+     */
+    static configureFromFile(fileConfig) {
+        if (!fileConfig.log) {
+            return;
+        }
+        const config = {};
+        if (fileConfig.log.scopes) {
+            config.scopes = fileConfig.log.scopes;
+        }
+        if (fileConfig.log.level && this.isValidLogLevel(fileConfig.log.level)) {
+            config.level = fileConfig.log.level;
+        }
+        if (Object.keys(config).length > 0) {
+            this.configure(config);
+        }
+    }
+    /**
+     * Get current configuration
+     */
+    static getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Reset configuration to defaults
+     */
+    static reset() {
+        this.config = {
+            scopes: [],
+            level: 'info',
+        };
+    }
+    /**
+     * Check if a string is a valid log level
+     */
+    static isValidLogLevel(level) {
+        return ['debug', 'info', 'warn', 'error'].includes(level);
+    }
+}
+exports.LoggerFactory = LoggerFactory;
+LoggerFactory.config = {
+    scopes: [],
+    level: 'info',
+};
+// Auto-configure from environment variables on module load
+LoggerFactory.configureFromEnv();

package/dist/utils/Output.d.ts

@@ -0,0 +1,161 @@
+/**
+
+ * Licensed under the Apache License, Version 2.0 (the "License");
+
+ * you may not use this file except in compliance with the License.
+
+ * You may obtain a copy of the License at
+
+ *
+
+ *     http://www.apache.org/licenses/LICENSE-2.0
+
+ *
+
+ * Unless required by applicable law or agreed to in writing, software
+
+ * distributed under the License is distributed on an "AS IS" BASIS,
+
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+
+ * See the License for the specific language governing permissions and
+
+ * limitations under the License.
+
+ *
+
+ * Copyright 2025 Daniel Coutinho Ribeiro
+
+ */
+import type { ChangeSet } from '../core/types';
+/**
+ * Output mode configuration
+ */
+export type OutputMode = 'normal' | 'json' | 'quiet';
+/**
+ * Output Manager configuration options
+ */
+export interface OutputOptions {
+    /** Output mode (normal, json, quiet) */
+    mode: OutputMode;
+    /** Enable colors (default: true for normal mode, false for json/quiet) */
+    colors?: boolean;
+    /** Enable verbose error output with stack traces */
+    verbose?: boolean;
+}
+/**
+ * Error context for detailed error reporting
+ */
+export interface ErrorContext {
+    /** Resource ID where error occurred */
+    resourceId?: string;
+    /** Root cause of the error */
+    cause?: string;
+    /** Stack trace (shown only in verbose mode) */
+    stackTrace?: string;
+}
+/**
+ * Deployment result summary
+ */
+export interface DeployResult {
+    /** Total number of resources processed */
+    resourceCount: number;
+    /** Total deployment duration in seconds */
+    duration: number;
+    /** Number of resources created */
+    creates: number;
+    /** Number of resources updated */
+    updates: number;
+    /** Number of resources deleted */
+    deletes: number;
+    /** Errors encountered during deployment */
+    errors?: Array<{
+        resourceId: string;
+        message: string;
+    }>;
+}
+/**
+ * Output Manager - Handles all user-facing CLI output
+ */
+export declare class OutputManager {
+    private readonly mode;
+    private readonly colors;
+    private readonly verbose;
+    constructor(options: OutputOptions);
+    /**
+     * Show success message
+     */
+    showSuccess(message: string): void;
+    /**
+     * Show info message
+     */
+    showInfo(message: string): void;
+    /**
+     * Show warning message
+     */
+    showWarning(message: string): void;
+    /**
+     * Show error message with optional context
+     */
+    showError(message: string, context?: ErrorContext): void;
+    /**
+     * Show plan header with stack name
+     */
+    showPlanHeader(stackName: string): void;
+    /**
+     * Show planned changes with diff visualization
+     */
+    showPlanChanges(changeSet: ChangeSet): void;
+    /**
+     * Show plan summary with change counts
+     */
+    showPlanSummary(changeSet: ChangeSet): void;
+    /**
+     * Show deployment header
+     */
+    showDeployHeader(): void;
+    /**
+     * Show resource deployment progress
+     */
+    showResourceProgress(id: string, action: string): void;
+    /**
+     * Show resource deployment completion
+     */
+    showResourceComplete(id: string, action: string, duration: number): void;
+    /**
+     * Show deployment summary
+     */
+    showDeploySummary(result: DeployResult): void;
+    /**
+     * Show reactive changes detected notification
+     */
+    showReactiveChangesDetected(): void;
+    /**
+     * Show file changed notification
+     */
+    showFileChanged(filename: string): void;
+    /**
+     * Show hot reload start notification
+     */
+    showHotReloadStart(): void;
+    /**
+     * Output JSON to stdout
+     */
+    private outputJson;
+    /**
+     * Format node ID for display
+     */
+    private formatNodeId;
+    /**
+     * Convert CloudDOM node to JSON representation
+     */
+    private nodeToJson;
+}
+/**
+ * Create an Output Manager from CLI flags
+ */
+export declare function createOutputManager(flags: {
+    json?: boolean;
+    quiet?: boolean;
+    verbose?: boolean;
+}): OutputManager;