@xfilecom/core-sdk 1.3.23

package/dist/utils/logger.helpers.d.ts

@@ -0,0 +1,71 @@
+import { LoggerService } from '@nestjs/common';
+export interface LogContext {
+    userId?: number | string;
+    requestId?: string;
+    ipAddress?: string;
+    userAgent?: string;
+    method?: string;
+    url?: string;
+    [key: string]: any;
+}
+export declare enum LogLevel {
+    ERROR = "error",
+    WARN = "warn",
+    LOG = "log",
+    DEBUG = "debug",
+    VERBOSE = "verbose"
+}
+export declare const LOG_LEVEL_ORDER: Record<string, number>;
+export type LogLevelName = keyof typeof LOG_LEVEL_ORDER;
+export declare function isLevelEnabled(messageLevel: LogLevelName | string, minLevel: LogLevelName | string): boolean;
+export interface ILogWriter {
+    write(level: 'log' | 'warn' | 'error' | 'debug' | 'verbose', message: string, context?: string): void;
+}
+export declare class ConsoleLogWriter implements ILogWriter {
+    private logger;
+    constructor(context?: string);
+    write(level: 'log' | 'warn' | 'error' | 'debug' | 'verbose', message: string, context?: string): void;
+    setContext(context: string): void;
+}
+export interface FileLogWriterOptions {
+    logDir?: string;
+    fileLogLevel?: 'log' | 'warn' | 'error';
+}
+export declare class FileLogWriter implements ILogWriter {
+    private logDir;
+    private fileLogLevel;
+    constructor(options?: FileLogWriterOptions);
+    private ensureLogDirectory;
+    private getLogFilePath;
+    write(level: 'log' | 'warn' | 'error' | 'debug' | 'verbose', message: string, context?: string): void;
+}
+export interface LoggerOptions {
+    logLevel?: LogLevelName;
+    enableFileLogging?: boolean;
+    logDir?: string;
+    fileLogLevel?: 'log' | 'warn' | 'error';
+    enableConsoleLogging?: boolean;
+}
+export declare class LoggerHelpers implements LoggerService {
+    private contextName;
+    private consoleWriter?;
+    private fileWriter?;
+    private minLevel;
+    constructor(context?: string, consoleWriter?: ILogWriter, fileWriter?: ILogWriter, options?: LoggerOptions);
+    isLevelEnabled(level: LogLevelName): boolean;
+    setContext(context: string): void;
+    log(message: string, context?: LogContext): void;
+    error(message: string, trace?: string | Error, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    debug(message: string, context?: LogContext): void;
+    verbose(message: string, context?: LogContext): void;
+    logRequest(method: string, url: string, context?: LogContext): void;
+    logResponse(method: string, url: string, statusCode: number, duration?: number, context?: LogContext): void;
+    logQuery(query: string, params?: any[], context?: LogContext): void;
+    logBusiness(action: string, details?: any, context?: LogContext): void;
+    logSecurity(event: string, details?: any, context?: LogContext): void;
+    logPerformance(operation: string, duration: number, context?: LogContext): void;
+    private formatMessage;
+    logStructured(level: LogLevel, message: string, data?: any, context?: LogContext): void;
+}
+export declare function createLogger(context: string, options?: LoggerOptions): LoggerHelpers;

package/dist/utils/logger.helpers.js

@@ -0,0 +1,293 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var LoggerHelpers_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerHelpers = exports.FileLogWriter = exports.ConsoleLogWriter = exports.LOG_LEVEL_ORDER = exports.LogLevel = void 0;
+exports.isLevelEnabled = isLevelEnabled;
+exports.createLogger = createLogger;
+const common_1 = require("@nestjs/common");
+const fs = require("fs");
+const path = require("path");
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["ERROR"] = "error";
+    LogLevel["WARN"] = "warn";
+    LogLevel["LOG"] = "log";
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["VERBOSE"] = "verbose";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+exports.LOG_LEVEL_ORDER = {
+    error: 0,
+    warn: 1,
+    log: 2,
+    debug: 3,
+    verbose: 4,
+};
+function isLevelEnabled(messageLevel, minLevel) {
+    const a = exports.LOG_LEVEL_ORDER[String(messageLevel).toLowerCase()] ?? 999;
+    const b = exports.LOG_LEVEL_ORDER[String(minLevel).toLowerCase()] ?? 0;
+    return a <= b;
+}
+let ConsoleLogWriter = class ConsoleLogWriter {
+    constructor(context) {
+        this.logger = new common_1.Logger(context || 'App');
+    }
+    write(level, message, context) {
+        const logMessage = context ? `[${context}] ${message}` : message;
+        switch (level) {
+            case 'error':
+                this.logger.error(logMessage);
+                break;
+            case 'warn':
+                this.logger.warn(logMessage);
+                break;
+            case 'debug':
+                this.logger.debug(logMessage);
+                break;
+            case 'verbose':
+                this.logger.verbose(logMessage);
+                break;
+            default:
+                this.logger.log(logMessage);
+        }
+    }
+    setContext(context) {
+        this.logger = new common_1.Logger(context);
+    }
+};
+exports.ConsoleLogWriter = ConsoleLogWriter;
+exports.ConsoleLogWriter = ConsoleLogWriter = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [String])
+], ConsoleLogWriter);
+let FileLogWriter = class FileLogWriter {
+    constructor(options) {
+        this.logDir = path.resolve(options?.logDir ?? './logs');
+        this.fileLogLevel = options?.fileLogLevel ?? 'log';
+        this.ensureLogDirectory();
+    }
+    ensureLogDirectory() {
+        try {
+            if (!fs.existsSync(this.logDir)) {
+                fs.mkdirSync(this.logDir, { recursive: true });
+            }
+        }
+        catch (error) {
+            console.error(`Failed to create log directory: ${this.logDir}`, error);
+        }
+    }
+    getLogFilePath(level) {
+        const today = new Date().toISOString().split('T')[0];
+        const filename = `${today}-${level}.log`;
+        return path.join(this.logDir, filename);
+    }
+    write(level, message, context) {
+        if (level === 'debug' || level === 'verbose') {
+            return;
+        }
+        const shouldLog = (this.fileLogLevel === 'log') ||
+            (this.fileLogLevel === 'warn' && (level === 'warn' || level === 'error')) ||
+            (this.fileLogLevel === 'error' && level === 'error');
+        if (!shouldLog) {
+            return;
+        }
+        try {
+            const filePath = this.getLogFilePath(level);
+            const timestamp = new Date().toISOString();
+            const logEntry = `[${timestamp}] ${context ? `[${context}] ` : ''}[${level.toUpperCase()}] ${message}\n`;
+            fs.appendFileSync(filePath, logEntry, { encoding: 'utf8' });
+        }
+        catch (error) {
+            console.error(`Failed to write log to file: ${error}`);
+        }
+    }
+};
+exports.FileLogWriter = FileLogWriter;
+exports.FileLogWriter = FileLogWriter = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Object])
+], FileLogWriter);
+let LoggerHelpers = LoggerHelpers_1 = class LoggerHelpers {
+    constructor(context, consoleWriter, fileWriter, options) {
+        this.contextName = context || LoggerHelpers_1.name;
+        this.minLevel = options?.logLevel ?? 'log';
+        if (consoleWriter) {
+            this.consoleWriter = consoleWriter;
+        }
+        else if (options?.enableConsoleLogging !== false) {
+            this.consoleWriter = new ConsoleLogWriter(this.contextName);
+        }
+        if (fileWriter) {
+            this.fileWriter = fileWriter;
+        }
+        else if (options?.enableFileLogging !== false) {
+            this.fileWriter = new FileLogWriter({
+                logDir: options?.logDir,
+                fileLogLevel: options?.fileLogLevel,
+            });
+        }
+    }
+    isLevelEnabled(level) {
+        return isLevelEnabled(level, this.minLevel);
+    }
+    setContext(context) {
+        this.contextName = context;
+        if (this.consoleWriter instanceof ConsoleLogWriter) {
+            this.consoleWriter.setContext(context);
+        }
+    }
+    log(message, context) {
+        if (!isLevelEnabled('log', this.minLevel))
+            return;
+        const logMessage = this.formatMessage(message, context);
+        this.consoleWriter?.write('log', logMessage, this.contextName);
+        this.fileWriter?.write('log', logMessage, this.contextName);
+    }
+    error(message, trace, context) {
+        if (!isLevelEnabled('error', this.minLevel))
+            return;
+        const logMessage = this.formatMessage(message, context);
+        const errorTrace = trace instanceof Error ? trace.stack : trace;
+        const fullMessage = errorTrace ? `${logMessage}\n${errorTrace}` : logMessage;
+        this.consoleWriter?.write('error', fullMessage, this.contextName);
+        this.fileWriter?.write('error', fullMessage, this.contextName);
+    }
+    warn(message, context) {
+        if (!isLevelEnabled('warn', this.minLevel))
+            return;
+        const logMessage = this.formatMessage(message, context);
+        this.consoleWriter?.write('warn', logMessage, this.contextName);
+        this.fileWriter?.write('warn', logMessage, this.contextName);
+    }
+    debug(message, context) {
+        if (!isLevelEnabled('debug', this.minLevel))
+            return;
+        const logMessage = this.formatMessage(message, context);
+        this.consoleWriter?.write('debug', logMessage, this.contextName);
+    }
+    verbose(message, context) {
+        if (!isLevelEnabled('verbose', this.minLevel))
+            return;
+        const logMessage = this.formatMessage(message, context);
+        this.consoleWriter?.write('verbose', logMessage, this.contextName);
+    }
+    logRequest(method, url, context) {
+        this.log(`[${method}] ${url}`, {
+            ...context,
+            method,
+            url,
+        });
+    }
+    logResponse(method, url, statusCode, duration, context) {
+        const durationStr = duration ? `${duration}ms` : '';
+        this.log(`[${method}] ${url} - ${statusCode} ${durationStr}`, {
+            ...context,
+            method,
+            url,
+            statusCode,
+            duration,
+        });
+    }
+    logQuery(query, params, context) {
+        this.debug(`Query: ${query}`, {
+            ...context,
+            query,
+            params,
+        });
+    }
+    logBusiness(action, details, context) {
+        this.log(`[Business] ${action}`, {
+            ...context,
+            action,
+            details,
+        });
+    }
+    logSecurity(event, details, context) {
+        this.warn(`[Security] ${event}`, {
+            ...context,
+            event,
+            details,
+        });
+    }
+    logPerformance(operation, duration, context) {
+        const level = duration > 1000 ? 'warn' : 'log';
+        const message = `[Performance] ${operation} took ${duration}ms`;
+        if (level === 'warn') {
+            this.warn(message, {
+                ...context,
+                operation,
+                duration,
+            });
+        }
+        else {
+            this.log(message, {
+                ...context,
+                operation,
+                duration,
+            });
+        }
+    }
+    formatMessage(message, context) {
+        if (!context || Object.keys(context).length === 0) {
+            return message;
+        }
+        const contextStr = Object.entries(context)
+            .filter(([_, value]) => value !== undefined && value !== null)
+            .map(([key, value]) => {
+            if (typeof value === 'object') {
+                return `${key}=${JSON.stringify(value)}`;
+            }
+            return `${key}=${value}`;
+        })
+            .join(' ');
+        return contextStr ? `${message} | ${contextStr}` : message;
+    }
+    logStructured(level, message, data, context) {
+        const logData = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            ...context,
+            ...(data && { data }),
+        };
+        const logMessage = JSON.stringify(logData);
+        switch (level) {
+            case LogLevel.ERROR:
+                this.error(logMessage);
+                break;
+            case LogLevel.WARN:
+                this.warn(logMessage);
+                break;
+            case LogLevel.DEBUG:
+                this.debug(logMessage);
+                break;
+            case LogLevel.VERBOSE:
+                this.verbose(logMessage);
+                break;
+            default:
+                this.log(logMessage);
+        }
+    }
+};
+exports.LoggerHelpers = LoggerHelpers;
+exports.LoggerHelpers = LoggerHelpers = LoggerHelpers_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [String, Object, Object, Object])
+], LoggerHelpers);
+function createLogger(context, options) {
+    return new LoggerHelpers(context, undefined, undefined, options);
+}
+//# sourceMappingURL=logger.helpers.js.map

package/dist/utils/logger.helpers.js.map

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

package/dist/utils/logging.config.d.ts

@@ -0,0 +1,6 @@
+import { LoggingInterceptorOptions } from '../interceptors/logging.interceptor';
+import { LoggerOptions } from './logger.helpers';
+export declare function getLoggingConfigFromEnv(): {
+    loggerOptions: LoggerOptions;
+    interceptorOptions: LoggingInterceptorOptions;
+};

package/dist/utils/logging.config.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLoggingConfigFromEnv = getLoggingConfigFromEnv;
+const path = require("path");
+function getLoggingConfigFromEnv() {
+    const logDir = process.env.LOG_DIR
+        ? path.resolve(process.env.LOG_DIR)
+        : './logs';
+    const enableFileLogging = process.env.ENABLE_FILE_LOGGING !== 'false';
+    const fileLogLevel = process.env.FILE_LOG_LEVEL || 'log';
+    const logLevel = process.env.LOG_LEVEL?.toLowerCase() || 'log';
+    const loggerOptions = {
+        logLevel,
+        enableFileLogging,
+        logDir,
+        fileLogLevel,
+        enableConsoleLogging: true,
+    };
+    const interceptorLogLevel = process.env.INTERCEPTOR_LOG_LEVEL?.toLowerCase();
+    const logRequestBody = process.env.LOG_REQUEST_BODY === 'true';
+    const logResponseBody = process.env.LOG_RESPONSE_BODY === 'true';
+    const excludeFieldsStr = process.env.LOG_EXCLUDE_FIELDS || 'password,token,secret,privateKey,private_key';
+    const excludeFields = excludeFieldsStr
+        .split(',')
+        .map(f => f.trim())
+        .filter(f => f.length > 0);
+    const maxBodyLength = parseInt(process.env.LOG_MAX_BODY_LENGTH || '2000', 10);
+    const interceptorOptions = {
+        logLevel: interceptorLogLevel === 'none'
+            ? 'none'
+            : interceptorLogLevel || 'log',
+        logRequestBody,
+        logResponseBody,
+        excludeFields,
+        maxBodyLength,
+    };
+    return {
+        loggerOptions,
+        interceptorOptions,
+    };
+}
+//# sourceMappingURL=logging.config.js.map

package/dist/utils/logging.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.config.js","sourceRoot":"","sources":["../../src/utils/logging.config.ts"],"names":[],"mappings":";;AAOA,0DAgDC;AAvDD,6BAA6B;AAO7B,SAAgB,uBAAuB;IAKrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO;QAChC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QACnC,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,OAAO,CAAC;IACtE,MAAM,YAAY,GAAI,OAAO,CAAC,GAAG,CAAC,cAA2C,IAAI,KAAK,CAAC;IACvF,MAAM,QAAQ,GAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAmB,IAAI,KAAK,CAAC;IAEjF,MAAM,aAAa,GAAkB;QACnC,QAAQ;QACR,iBAAiB;QACjB,MAAM;QACN,YAAY;QACZ,oBAAoB,EAAE,IAAI;KAC3B,CAAC;IAGF,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,WAAW,EAAE,CAAC;IAC7E,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,MAAM,CAAC;IAC/D,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,CAAC;IAEjE,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,8CAA8C,CAAC;IAC1G,MAAM,aAAa,GAAG,gBAAgB;SACnC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE7B,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAE9E,MAAM,kBAAkB,GAA8B;QACpD,QAAQ,EAAE,mBAAmB,KAAK,MAAM;YACtC,CAAC,CAAC,MAAM;YACR,CAAC,CAAE,mBAAoC,IAAI,KAAK;QAClD,cAAc;QACd,eAAe;QACf,aAAa;QACb,aAAa;KACd,CAAC;IAEF,OAAO;QACL,aAAa;QACb,kBAAkB;KACnB,CAAC;AACJ,CAAC"}

package/dist/utils/service.helpers.d.ts

@@ -0,0 +1,22 @@
+import { DatabaseService } from '../database/database.service';
+export interface PaginationResult<T> {
+    data: T[];
+    pagination: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+export declare class ServiceHelpers {
+    private readonly databaseService?;
+    private readonly logger;
+    constructor(databaseService?: DatabaseService);
+    ensureDatabase(): DatabaseService;
+    getDb(): any;
+    isDatabaseAvailable(): boolean;
+    createPaginationResult<T>(data: T[], total: number, page: number, limit: number): PaginationResult<T>;
+    withTransaction<T>(callback: (db: any) => Promise<T>): Promise<T>;
+}

package/dist/utils/service.helpers.js

@@ -0,0 +1,73 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ServiceHelpers_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceHelpers = void 0;
+const common_1 = require("@nestjs/common");
+const database_service_1 = require("../database/database.service");
+let ServiceHelpers = ServiceHelpers_1 = class ServiceHelpers {
+    constructor(databaseService) {
+        this.databaseService = databaseService;
+        this.logger = new common_1.Logger(ServiceHelpers_1.name);
+    }
+    ensureDatabase() {
+        if (!this.databaseService) {
+            throw new Error('Database service is not available. Please configure database in CoreModule.');
+        }
+        if (!this.databaseService.isConnected()) {
+            throw new Error('Database service is not connected. Please check your database configuration.');
+        }
+        return this.databaseService;
+    }
+    getDb() {
+        const db = this.ensureDatabase();
+        return db.db;
+    }
+    isDatabaseAvailable() {
+        return this.databaseService?.isConnected() ?? false;
+    }
+    createPaginationResult(data, total, page, limit) {
+        return {
+            data,
+            pagination: {
+                total,
+                page,
+                limit,
+                totalPages: Math.ceil(total / limit),
+                hasNext: page * limit < total,
+                hasPrev: page > 1,
+            },
+        };
+    }
+    async withTransaction(callback) {
+        const dbService = this.ensureDatabase();
+        const db = dbService.db;
+        return db.transaction(async (tx) => {
+            try {
+                return await callback(tx);
+            }
+            catch (error) {
+                this.logger.error('Transaction failed, rolling back', error);
+                throw error;
+            }
+        });
+    }
+};
+exports.ServiceHelpers = ServiceHelpers;
+exports.ServiceHelpers = ServiceHelpers = ServiceHelpers_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [database_service_1.DatabaseService])
+], ServiceHelpers);
+//# sourceMappingURL=service.helpers.js.map

package/dist/utils/service.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.helpers.js","sourceRoot":"","sources":["../../src/utils/service.helpers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAsE;AACtE,mEAA+D;AAuBxD,IAAM,cAAc,sBAApB,MAAM,cAAc;IAGzB,YACc,eAAkD;QAAjC,oBAAe,GAAf,eAAe,CAAkB;QAH/C,WAAM,GAAG,IAAI,eAAM,CAAC,gBAAc,CAAC,IAAI,CAAC,CAAC;IAIvD,CAAC;IAMJ,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAMD,KAAK;QACH,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC,EAAE,CAAC;IACf,CAAC;IAKD,mBAAmB;QACjB,OAAO,IAAI,CAAC,eAAe,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IACtD,CAAC;IAKD,sBAAsB,CACpB,IAAS,EACT,KAAa,EACb,IAAY,EACZ,KAAa;QAEb,OAAO;YACL,IAAI;YACJ,UAAU,EAAE;gBACV,KAAK;gBACL,IAAI;gBACJ,KAAK;gBACL,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;gBACpC,OAAO,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK;gBAC7B,OAAO,EAAE,IAAI,GAAG,CAAC;aAClB;SACF,CAAC;IACJ,CAAC;IAkBD,KAAK,CAAC,eAAe,CACnB,QAAiC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;QAIxB,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;gBAC7D,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA5FY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,iBAAQ,GAAE,CAAA;qCAAoC,kCAAe;GAJrD,cAAc,CA4F1B"}

package/dist/utils/yaml-config.loader.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_CONFIG_FILENAMES: readonly ["application.yml", "application.yaml"];
+export declare const ENV_CONFIG_FILENAME_PATTERN: "application-{env}.yml";
+export type ConfigSource = 'yaml' | 'env' | 'yamlWithEnvOverrides';
+export declare const CONFIG_SOURCE_ENV_KEY = "CONFIG_SOURCE";
+export interface LoadApplicationYamlOptions {
+    rootDir?: string;
+    env?: string;
+    encoding?: BufferEncoding;
+    configSource?: ConfigSource;
+    syncEnvKeys?: Record<string, string>;
+}
+export declare function loadApplicationYaml(options?: LoadApplicationYamlOptions): Promise<Record<string, any>>;
+export declare function loadApplicationYamlSync(options?: Omit<LoadApplicationYamlOptions, 'encoding'> & {
+    encoding?: BufferEncoding;
+}): Record<string, any>;