@de-otio/trellis 0.4.0

package/dist/lib/logger.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Centralized Logger with Log Level Controls
+ *
+ * Implements security-aware logging that prevents sensitive data exposure in production.
+ *
+ * Log Levels:
+ * - ERROR: Critical errors only (always logged)
+ * - WARN: Warnings and errors (default for production)
+ * - INFO: General information, warnings, and errors
+ * - DEBUG: Detailed debugging information (development only)
+ *
+ * Environment Variables:
+ * - LOG_LEVEL: Sets the minimum log level (ERROR, WARN, INFO, DEBUG)
+ * - NODE_ENV: Automatically adjusts log level (production defaults to WARN)
+ */
+export type LogLevel = "ERROR" | "WARN" | "INFO" | "DEBUG" | "TRACE";
+export interface LoggerEnv {
+    LOG_LEVEL?: string;
+    NODE_ENV?: string;
+}
+/**
+ * Logger class with environment-aware log level control
+ */
+export declare class Logger {
+    private static instance;
+    private logLevel;
+    private requestId?;
+    private constructor();
+    /**
+     * Get or create logger instance
+     */
+    static getInstance(env?: LoggerEnv | {
+        LOG_LEVEL?: string;
+        NODE_ENV?: string;
+    } | any): Logger;
+    /**
+     * Create a logger with a request ID for correlation
+     */
+    withRequestId(requestId: string): Logger;
+    /**
+     * Get log level priority for comparison
+     */
+    private getLogLevelPriority;
+    /**
+     * Check if a log level should be output
+     */
+    private shouldLog;
+    /**
+     * Format log message with log level and optional request ID
+     */
+    private formatMessage;
+    /**
+     * Log error message (always logged)
+     */
+    error(message: string, data?: any): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * Log info message
+     */
+    info(message: string, data?: any): void;
+    /**
+     * Log debug message (only in DEBUG mode)
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * Log trace message (only in TRACE mode)
+     */
+    trace(message: string, data?: any): void;
+    /**
+     * Sanitize sensitive data for logging
+     * Masks authorization codes, tokens, and other sensitive fields
+     */
+    sanitize(data: any): any;
+    /**
+     * Get current log level
+     */
+    getLogLevel(): LogLevel;
+    /**
+     * Set log level (for testing purposes)
+     */
+    setLogLevel(level: LogLevel): void;
+}
+/**
+ * Create a logger instance for a specific context
+ * @param env - Environment variables containing LOG_LEVEL
+ * @param context - Context name (e.g., 'SSOAuthHandler', 'SessionManager')
+ * @returns Logger instance with context prefix
+ */
+export declare function createLogger(env?: LoggerEnv | {
+    LOG_LEVEL?: string;
+    NODE_ENV?: string;
+} | any, context?: string): Logger;
+/**
+ * Generate a unique request ID for log correlation
+ */
+export declare function generateRequestId(): string;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAE3B,OAAO;IAoBP;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,GAAG,CAAC,EAAE,SAAS,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,GAAG,GAChE,MAAM;IAOT;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAOxC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IASxC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IASvC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IASvC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IASxC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IASxC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG;IAyCxB;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAGnC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,CAAC,EAAE,SAAS,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,EACjE,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/lib/logger.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * Centralized Logger with Log Level Controls
+ *
+ * Implements security-aware logging that prevents sensitive data exposure in production.
+ *
+ * Log Levels:
+ * - ERROR: Critical errors only (always logged)
+ * - WARN: Warnings and errors (default for production)
+ * - INFO: General information, warnings, and errors
+ * - DEBUG: Detailed debugging information (development only)
+ *
+ * Environment Variables:
+ * - LOG_LEVEL: Sets the minimum log level (ERROR, WARN, INFO, DEBUG)
+ * - NODE_ENV: Automatically adjusts log level (production defaults to WARN)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+exports.createLogger = createLogger;
+exports.generateRequestId = generateRequestId;
+/**
+ * Logger class with environment-aware log level control
+ */
+class Logger {
+    static instance;
+    logLevel;
+    requestId;
+    constructor(env) {
+        // Determine log level from environment
+        const envLogLevel = env?.LOG_LEVEL?.toUpperCase();
+        const nodeEnv = env?.NODE_ENV?.toLowerCase();
+        // Default to WARN in production, INFO in development
+        if (envLogLevel &&
+            ["ERROR", "WARN", "INFO", "DEBUG", "TRACE"].includes(envLogLevel)) {
+            this.logLevel = envLogLevel;
+        }
+        else if (nodeEnv === "production") {
+            this.logLevel = "WARN";
+        }
+        else {
+            this.logLevel = "INFO";
+        }
+    }
+    /**
+     * Get or create logger instance
+     */
+    static getInstance(env) {
+        if (!Logger.instance) {
+            Logger.instance = new Logger(env);
+        }
+        return Logger.instance;
+    }
+    /**
+     * Create a logger with a request ID for correlation
+     */
+    withRequestId(requestId) {
+        const logger = new Logger();
+        logger.logLevel = this.logLevel;
+        logger.requestId = requestId;
+        return logger;
+    }
+    /**
+     * Get log level priority for comparison
+     */
+    getLogLevelPriority(level) {
+        const priorities = {
+            ERROR: 0,
+            WARN: 1,
+            INFO: 2,
+            DEBUG: 3,
+            TRACE: 4,
+        };
+        return priorities[level];
+    }
+    /**
+     * Check if a log level should be output
+     */
+    shouldLog(level) {
+        return (this.getLogLevelPriority(level) <= this.getLogLevelPriority(this.logLevel));
+    }
+    /**
+     * Format log message with log level and optional request ID
+     */
+    formatMessage(level, message) {
+        const levelPrefix = `[${level}]`;
+        if (this.requestId) {
+            return `[${this.requestId}] ${levelPrefix} ${message}`;
+        }
+        return `${levelPrefix} ${message}`;
+    }
+    /**
+     * Log error message (always logged)
+     */
+    error(message, data) {
+        if (this.shouldLog("ERROR")) {
+            console.error(this.formatMessage("ERROR", message), data !== undefined ? data : "");
+        }
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, data) {
+        if (this.shouldLog("WARN")) {
+            console.warn(this.formatMessage("WARN", message), data !== undefined ? data : "");
+        }
+    }
+    /**
+     * Log info message
+     */
+    info(message, data) {
+        if (this.shouldLog("INFO")) {
+            console.log(this.formatMessage("INFO", message), data !== undefined ? data : "");
+        }
+    }
+    /**
+     * Log debug message (only in DEBUG mode)
+     */
+    debug(message, data) {
+        if (this.shouldLog("DEBUG")) {
+            console.log(this.formatMessage("DEBUG", message), data !== undefined ? data : "");
+        }
+    }
+    /**
+     * Log trace message (only in TRACE mode)
+     */
+    trace(message, data) {
+        if (this.shouldLog("TRACE")) {
+            console.log(this.formatMessage("TRACE", message), data !== undefined ? data : "");
+        }
+    }
+    /**
+     * Sanitize sensitive data for logging
+     * Masks authorization codes, tokens, and other sensitive fields
+     */
+    sanitize(data) {
+        if (typeof data !== "object" || data === null) {
+            return data;
+        }
+        const sensitiveFields = [
+            "code",
+            "access_token",
+            "refresh_token",
+            "provider_token",
+            "provider_refresh_token",
+            "token",
+            "password",
+            "secret",
+            "authorization",
+        ];
+        const sanitized = Array.isArray(data) ? [] : {};
+        for (const [key, value] of Object.entries(data)) {
+            const lowerKey = key.toLowerCase();
+            // Check if this is a sensitive field
+            const isSensitive = sensitiveFields.some((field) => lowerKey.includes(field));
+            if (isSensitive && typeof value === "string" && value.length > 0) {
+                // Mask sensitive data (show only presence)
+                sanitized[key] = "[REDACTED]";
+            }
+            else if (typeof value === "object" && value !== null) {
+                // Recursively sanitize nested objects
+                sanitized[key] = this.sanitize(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Get current log level
+     */
+    getLogLevel() {
+        return this.logLevel;
+    }
+    /**
+     * Set log level (for testing purposes)
+     */
+    setLogLevel(level) {
+        this.logLevel = level;
+    }
+}
+exports.Logger = Logger;
+/**
+ * Create a logger instance for a specific context
+ * @param env - Environment variables containing LOG_LEVEL
+ * @param context - Context name (e.g., 'SSOAuthHandler', 'SessionManager')
+ * @returns Logger instance with context prefix
+ */
+function createLogger(env, context) {
+    const logger = Logger.getInstance(env);
+    // If context is provided, we could extend this to add context prefixes
+    // For now, return the base logger
+    return logger;
+}
+/**
+ * Generate a unique request ID for log correlation
+ */
+function generateRequestId() {
+    return crypto.randomUUID();
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

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

package/dist/lib/media-cleanup-handler.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Media Cleanup Handler
+ *
+ * Handles cleanup of soft-deleted media files from R2 storage.
+ *
+ * This runs as a scheduled job to:
+ * 1. Find media files marked as deleted (deletedAt is set)
+ * 2. Wait for a grace period (default: 7 days) before actual deletion
+ * 3. Delete R2 objects (original, thumbnail, optimized)
+ * 4. Retry failed deletions with exponential backoff
+ * 5. Log all operations for monitoring
+ */
+import type { R2Bucket } from "../types/cloudflare-compat";
+import { type LoggerEnv } from "./logger";
+export interface Env extends LoggerEnv {
+    MEDIA_BUCKET_R2?: R2Bucket;
+    R2_BUCKET?: R2Bucket;
+    DEFAULT_REGION?: string;
+    MEDIA_CLEANUP_GRACE_PERIOD_DAYS?: string;
+}
+interface CleanupResult {
+    processed: number;
+    deleted: number;
+    errors: number;
+    skipped: number;
+}
+export declare class MediaCleanupHandler {
+    private logger;
+    private gracePeriodDays;
+    constructor(env: Env);
+    /**
+     * Run cleanup job for all regions
+     */
+    runCleanup(env: Env): Promise<CleanupResult>;
+    /**
+     * Cleanup media for a specific region
+     */
+    private cleanupRegion;
+    /**
+     * Delete R2 objects for a media file
+     * Returns number of objects deleted
+     */
+    private deleteR2Objects;
+}
+export {};
+//# sourceMappingURL=media-cleanup-handler.d.ts.map

package/dist/lib/media-cleanup-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-cleanup-handler.d.ts","sourceRoot":"","sources":["../../src/lib/media-cleanup-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AASlD,MAAM,WAAW,GAAI,SAAQ,SAAS;IACpC,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,UAAU,aAAa;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAS;gBAEpB,GAAG,EAAE,GAAG;IAQpB;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC;IA0ClD;;OAEG;YACW,aAAa;IA2F3B;;;OAGG;YACW,eAAe;CA+C9B"}

package/dist/lib/media-cleanup-handler.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Media Cleanup Handler
+ *
+ * Handles cleanup of soft-deleted media files from R2 storage.
+ *
+ * This runs as a scheduled job to:
+ * 1. Find media files marked as deleted (deletedAt is set)
+ * 2. Wait for a grace period (default: 7 days) before actual deletion
+ * 3. Delete R2 objects (original, thumbnail, optimized)
+ * 4. Retry failed deletions with exponential backoff
+ * 5. Log all operations for monitoring
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MediaCleanupHandler = void 0;
+const logger_1 = require("./logger");
+const database_connection_manager_1 = require("./database-connection-manager");
+const db_query_helper_1 = require("./db-query-helper");
+class MediaCleanupHandler {
+    logger;
+    gracePeriodDays;
+    constructor(env) {
+        this.logger = logger_1.Logger.getInstance(env);
+        this.gracePeriodDays = parseInt(env.MEDIA_CLEANUP_GRACE_PERIOD_DAYS || "7", 10);
+    }
+    /**
+     * Run cleanup job for all regions
+     */
+    async runCleanup(env) {
+        this.logger.info("[MediaCleanup] Starting media cleanup job", {
+            gracePeriodDays: this.gracePeriodDays,
+        });
+        const regions = ["US", "EU", "CN"];
+        let totalProcessed = 0;
+        let totalDeleted = 0;
+        let totalErrors = 0;
+        let totalSkipped = 0;
+        for (const region of regions) {
+            try {
+                const result = await this.cleanupRegion(region, env);
+                totalProcessed += result.processed;
+                totalDeleted += result.deleted;
+                totalErrors += result.errors;
+                totalSkipped += result.skipped;
+            }
+            catch (error) {
+                this.logger.error(`[MediaCleanup] Error cleaning up region ${region}`, {
+                    error: error.message,
+                    region,
+                });
+                totalErrors++;
+            }
+        }
+        this.logger.info("[MediaCleanup] Cleanup job completed", {
+            processed: totalProcessed,
+            deleted: totalDeleted,
+            errors: totalErrors,
+            skipped: totalSkipped,
+        });
+        return {
+            processed: totalProcessed,
+            deleted: totalDeleted,
+            errors: totalErrors,
+            skipped: totalSkipped,
+        };
+    }
+    /**
+     * Cleanup media for a specific region
+     */
+    async cleanupRegion(region, env) {
+        const r2Bucket = env.MEDIA_BUCKET_R2 || env.R2_BUCKET;
+        if (!r2Bucket) {
+            this.logger.warn("[MediaCleanup] R2 bucket not configured, skipping cleanup");
+            return { processed: 0, deleted: 0, errors: 0, skipped: 0 };
+        }
+        // Calculate cutoff date (grace period)
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - this.gracePeriodDays);
+        // Find all deleted media files older than grace period
+        const deletedMedia = await (0, db_query_helper_1.withQueryTimeoutAndRetry)(database_connection_manager_1.sharedDatabaseConnectionManager, region, env, async (db) => {
+            const dbAny = db;
+            return await dbAny.mediaFile.findMany({
+                where: {
+                    deletedAt: {
+                        not: null,
+                        lte: cutoffDate, // Deleted before cutoff date
+                    },
+                },
+                select: {
+                    id: true,
+                    contentHash: true,
+                    originalKey: true,
+                    thumbnailKey: true,
+                    optimizedKey: true,
+                    deletedAt: true,
+                },
+                take: 100, // Process in batches
+            });
+        }, {
+            ...db_query_helper_1.QueryTimeoutPresets.BACKGROUND,
+            maxRetries: 3,
+            baseDelayMs: 100,
+            context: {
+                operation: "mediaCleanup_findDeleted",
+                region,
+            },
+        });
+        let deleted = 0;
+        let errors = 0;
+        let skipped = 0;
+        for (const media of deletedMedia) {
+            try {
+                // Delete R2 objects
+                const deletedObjects = await this.deleteR2Objects(media, r2Bucket);
+                if (deletedObjects > 0) {
+                    deleted++;
+                    this.logger.info("[MediaCleanup] Deleted media objects", {
+                        mediaId: media.id,
+                        contentHash: media.contentHash,
+                        deletedObjects,
+                        region,
+                    });
+                }
+                else {
+                    skipped++;
+                }
+            }
+            catch (error) {
+                errors++;
+                this.logger.error("[MediaCleanup] Error deleting media", {
+                    mediaId: media.id,
+                    contentHash: media.contentHash,
+                    error: error.message,
+                    region,
+                });
+            }
+        }
+        return {
+            processed: deletedMedia.length,
+            deleted,
+            errors,
+            skipped,
+        };
+    }
+    /**
+     * Delete R2 objects for a media file
+     * Returns number of objects deleted
+     */
+    async deleteR2Objects(media, r2Bucket) {
+        let deletedCount = 0;
+        // Delete original
+        try {
+            await r2Bucket.delete(media.originalKey);
+            deletedCount++;
+        }
+        catch (error) {
+            // Object might not exist, that's okay
+            if (!error.message?.includes("No such key")) {
+                throw error;
+            }
+        }
+        // Delete thumbnail if exists
+        if (media.thumbnailKey) {
+            try {
+                await r2Bucket.delete(media.thumbnailKey);
+                deletedCount++;
+            }
+            catch (error) {
+                if (!error.message?.includes("No such key")) {
+                    throw error;
+                }
+            }
+        }
+        // Delete optimized if exists
+        if (media.optimizedKey) {
+            try {
+                await r2Bucket.delete(media.optimizedKey);
+                deletedCount++;
+            }
+            catch (error) {
+                if (!error.message?.includes("No such key")) {
+                    throw error;
+                }
+            }
+        }
+        return deletedCount;
+    }
+}
+exports.MediaCleanupHandler = MediaCleanupHandler;
+//# sourceMappingURL=media-cleanup-handler.js.map

package/dist/lib/media-cleanup-handler.js.map

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