@exulu/backend 1.25.2 → 1.25.4

package/CHANGELOG.md

@@ -1,6 +1,6 @@
-## [1.25.2](https://github.com/Qventu/exulu-backend/compare/v1.25.1...v1.25.2) (2025-10-07)
+## [1.25.4](https://github.com/Qventu/exulu-backend/compare/v1.25.3...v1.25.4) (2025-10-08)
 
 
 ### Bug Fixes
 
-* add token validation error logging ([4b65dd6](https://github.com/Qventu/exulu-backend/commit/4b65dd6df04e35c6c1ff441290b69f34f09fd81f))
+* seperate exulu init from server init and add option to provide custom winston transports ([f4a1595](https://github.com/Qventu/exulu-backend/commit/f4a15951df7501e866b7148a1ff8e22bd5bbe956))

package/dist/index.cjs

@@ -58,7 +58,8 @@ var import_redis = require("redis");
 // src/bullmq/server.ts
 var redisServer = {
   host: `${process.env.REDIS_HOST}`,
-  port: process.env.REDIS_PORT
+  port: process.env.REDIS_PORT,
+  password: process.env.REDIS_PASSWORD || void 0
 };
 
 // src/redis/client.ts
@@ -5170,7 +5171,7 @@ var createRecurringJobs = async () => {
   );
   return queue;
 };
-var createExpressRoutes = async (app, logger, agents, tools, contexts, config, tracer, filesContext2) => {
+var createExpressRoutes = async (app, agents, tools, contexts, config, tracer, filesContext2) => {
   var corsOptions = {
     origin: "*",
     exposedHeaders: "*",
@@ -5223,8 +5224,8 @@ var createExpressRoutes = async (app, logger, agents, tools, contexts, config, t
     import_express4.default.json({ limit: REQUEST_SIZE_LIMIT }),
     (0, import_express5.expressMiddleware)(server, {
       context: async ({ req }) => {
-        logger.info("================");
-        logger.info({
+        console.info("================");
+        console.info({
           message: "Incoming Request",
           method: req.method,
           path: req.path,
@@ -5233,7 +5234,7 @@ var createExpressRoutes = async (app, logger, agents, tools, contexts, config, t
           userAgent: req.get("User-Agent"),
           headers: req.headers
         });
-        logger.info("================");
+        console.info("================");
         const authenticationResult = await requestValidators.authenticate(req);
         if (!authenticationResult.user?.id) {
           throw new Error(authenticationResult.message);
@@ -5500,10 +5501,10 @@ Mood: friendly and intelligent.
       },
       proxyReqPathResolver: (req) => {
         const prefix = `/gateway/anthropic/${req.params.id}`;
-        let path2 = req.url.startsWith(prefix) ? req.url.slice(prefix.length) : req.url;
-        if (!path2.startsWith("/")) path2 = "/" + path2;
-        console.log("[EXULU] Provider path:", path2);
-        return path2;
+        let path = req.url.startsWith(prefix) ? req.url.slice(prefix.length) : req.url;
+        if (!path.startsWith("/")) path = "/" + path;
+        console.log("[EXULU] Provider path:", path);
+        return path;
       },
       proxyReqOptDecorator: function(proxyReqOpts, srcReq) {
         return new Promise(async (resolve, reject) => {
@@ -5675,12 +5676,9 @@ var createCustomAnthropicStreamingMessage = (message) => {
 // src/registry/workers.ts
 var import_ioredis = __toESM(require("ioredis"), 1);
 var import_bullmq5 = require("bullmq");
-var fs2 = __toESM(require("fs"), 1);
-var import_path = __toESM(require("path"), 1);
 var import_api2 = require("@opentelemetry/api");
-var defaultLogsDir = import_path.default.join(process.cwd(), "logs");
 var redisConnection;
-var createWorkers = async (queues2, logger, contexts, _logsDir, tracer) => {
+var createWorkers = async (queues2, contexts, tracer) => {
   if (!redisServer.host || !redisServer.port) {
     console.error("[EXULU] you are trying to start worker, but no redis server is configured in the environment.");
     throw new Error("No redis server configured in the environment, so cannot start worker.");
@@ -5691,7 +5689,6 @@ var createWorkers = async (queues2, logger, contexts, _logsDir, tracer) => {
       maxRetriesPerRequest: null
     });
   }
-  const logsDir = _logsDir || defaultLogsDir;
   const workers = queues2.map((queue) => {
     console.log(`[EXULU] creating worker for queue ${queue}.`);
     const worker = new import_bullmq5.Worker(
@@ -5744,41 +5741,8 @@ var createWorkers = async (queues2, logger, contexts, _logsDir, tracer) => {
     });
     return worker;
   });
-  const logsCleaner = createLogsCleanerWorker(logsDir);
-  workers.push(logsCleaner);
   return workers;
 };
-var createLogsCleanerWorker = (logsDir) => {
-  const logsCleaner = new import_bullmq5.Worker(
-    global_queues.logs_cleaner,
-    async (job) => {
-      console.log(`[EXULU] recurring job ${job.id}.`);
-      const folder = fs2.readdirSync(logsDir);
-      const files = folder.filter((file) => file.endsWith(".log"));
-      const now = /* @__PURE__ */ new Date();
-      const daysToKeep = job.data.ttld;
-      const dateToKeep = new Date(now.getTime() - daysToKeep * 24 * 60 * 60 * 1e3);
-      files.forEach((file) => {
-        const filePath = import_path.default.join(logsDir, file);
-        const fileStats = fs2.statSync(filePath);
-        if (fileStats.mtime < dateToKeep) {
-          fs2.unlinkSync(filePath);
-        }
-      });
-    },
-    { connection: redisConnection }
-  );
-  logsCleaner.on("completed", (job, returnvalue) => {
-    console.log(`[EXULU] completed logs cleaner ${job.id}.`, returnvalue);
-  });
-  logsCleaner.on("failed", (job, error, prev) => {
-    if (job?.id) {
-      console.error(`[EXULU] failed logs cleaner ${job.id}.`);
-    }
-    console.error(`[EXULU] job error logs cleaner.`, error);
-  });
-  return logsCleaner;
-};
 
 // src/mcp/index.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
@@ -5795,7 +5759,7 @@ var ExuluMCP = class {
   express;
   constructor() {
   }
-  create = async ({ express: express3, contexts, agents, config, tools, tracer, logger }) => {
+  create = async ({ express: express3, contexts, agents, config, tools, tracer }) => {
     this.express = express3;
     if (!this.server) {
       console.log("[EXULU] Creating MCP server.");
@@ -6052,7 +6016,8 @@ var import_api4 = require("@opentelemetry/api");
 var import_winston_transport = require("@opentelemetry/winston-transport");
 var import_winston = __toESM(require("winston"), 1);
 var createLogger = ({
-  enableOtel
+  enableOtel,
+  transports
 }) => {
   const logger = import_winston.default.createLogger({
     level: "debug",
@@ -6069,7 +6034,7 @@ var createLogger = ({
       environment: process.env.NODE_ENV || "development"
     },
     transports: [
-      new import_winston.default.transports.Console(),
+      ...transports,
       ...enableOtel ? [new import_winston_transport.OpenTelemetryTransportV3()] : []
     ]
   });
@@ -6148,6 +6113,7 @@ var filesContext = new ExuluContext({
 });
 
 // src/registry/index.ts
+var import_winston2 = __toESM(require("winston"), 1);
 var isValidPostgresName = (id) => {
   const regex = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
   const isValid = regex.test(id);
@@ -6215,12 +6181,18 @@ var ExuluApp = class {
       ...contextsArray?.length ? contextsArray.map((context) => context.embedder?.queue?.name || null) : []
     ];
     this._queues = [...new Set(queues2.filter((o) => !!o))];
-    if (!this._expressApp) {
-      this._expressApp = (0, import_express8.default)();
-      await this.server.express.init();
-      console.log("[EXULU] Express app initialized.");
+    console.log("[EXULU] App initialized.");
+    return this;
+  };
+  express = {
+    init: async () => {
+      if (!this._expressApp) {
+        this._expressApp = (0, import_express8.default)();
+        await this.server.express.init();
+        console.log("[EXULU] Express app initialized.");
+      }
+      return this._expressApp;
     }
-    return this._expressApp;
   };
   get expressApp() {
     if (!this._expressApp) {
@@ -6281,14 +6253,19 @@ var ExuluApp = class {
         if (this._config?.telemetry?.enabled) {
           tracer = import_api4.trace.getTracer("exulu", "1.0.0");
         }
+        const transports = this._config?.workers?.logger?.winston?.transports ?? this._config?.logger?.winston?.transports ?? [new import_winston2.default.transports.Console()];
         const logger = logger_default({
-          enableOtel: this._config?.workers?.telemetry?.enabled ?? false
+          enableOtel: this._config?.workers?.telemetry?.enabled ?? false,
+          transports
         });
+        console.log = (...args) => logger.info(args.map(String).join(" "));
+        console.info = (...args) => logger.info(args.map(String).join(" "));
+        console.warn = (...args) => logger.warn(args.map(String).join(" "));
+        console.error = (...args) => logger.error(args.map(String).join(" "));
+        console.debug = (...args) => logger.debug(args.map(String).join(" "));
         return await createWorkers(
           this._queues,
-          logger,
           Object.values(this._contexts ?? {}),
-          this._config?.workers?.logsDir,
           tracer
         );
       }
@@ -6306,11 +6283,16 @@ var ExuluApp = class {
           tracer = import_api4.trace.getTracer("exulu", "1.0.0");
         }
         const logger = logger_default({
-          enableOtel: this._config?.telemetry?.enabled ?? false
+          enableOtel: this._config?.telemetry?.enabled ?? false,
+          transports: this._config?.logger?.winston?.transports ?? [new import_winston2.default.transports.Console()]
         });
+        console.log = (...args) => logger.info(args.map(String).join(" "));
+        console.info = (...args) => logger.info(args.map(String).join(" "));
+        console.warn = (...args) => logger.warn(args.map(String).join(" "));
+        console.error = (...args) => logger.error(args.map(String).join(" "));
+        console.debug = (...args) => logger.debug(args.map(String).join(" "));
         await createExpressRoutes(
           app,
-          logger,
           this._agents,
           this._tools,
           Object.values(this._contexts ?? {}),
@@ -6326,8 +6308,7 @@ var ExuluApp = class {
             agents: this._agents,
             config: this._config,
             tools: this._tools,
-            tracer,
-            logger
+            tracer
           });
           await mcp.connect();
         }
@@ -6596,7 +6577,7 @@ var RecursiveRules = class _RecursiveRules {
    * @param {string} path - The path to the recipe.
    * @returns {Promise<RecursiveRules>} The RecursiveRules object.
    */
-  static async fromRecipe(name = "default", lang = "en", path2) {
+  static async fromRecipe(name = "default", lang = "en", path) {
     throw new Error("Not implemented");
   }
 };

package/dist/index.d.cts

@@ -5,6 +5,7 @@ import { RedisClientType } from 'redis';
 import { z } from 'zod';
 import { Tool, LanguageModel, UIMessage } from 'ai';
 import { Express, Response, Request } from 'express';
+import { transport } from 'winston';
 import { Knex } from 'knex';
 import { Tiktoken } from 'tiktoken/lite';
 import models from 'tiktoken/model_to_encoding.json';
@@ -54,9 +55,18 @@ type ExuluConfig = {
     telemetry?: {
         enabled: boolean;
     };
+    logger?: {
+        winston: {
+            transports: transport[];
+        };
+    };
     workers: {
         enabled: boolean;
-        logsDir?: string;
+        logger?: {
+            winston: {
+                transports: transport[];
+            };
+        };
         telemetry?: {
             enabled: boolean;
         };
@@ -85,7 +95,10 @@ declare class ExuluApp {
         config: ExuluConfig;
         agents?: ExuluAgent[];
         tools?: ExuluTool[];
-    }) => Promise<Express>;
+    }) => Promise<ExuluApp>;
+    express: {
+        init: () => Promise<Express>;
+    };
     get expressApp(): Express;
     tool(id: string): ExuluTool | undefined;
     tools(): ExuluTool[];

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { RedisClientType } from 'redis';
 import { z } from 'zod';
 import { Tool, LanguageModel, UIMessage } from 'ai';
 import { Express, Response, Request } from 'express';
+import { transport } from 'winston';
 import { Knex } from 'knex';
 import { Tiktoken } from 'tiktoken/lite';
 import models from 'tiktoken/model_to_encoding.json';
@@ -54,9 +55,18 @@ type ExuluConfig = {
     telemetry?: {
         enabled: boolean;
     };
+    logger?: {
+        winston: {
+            transports: transport[];
+        };
+    };
     workers: {
         enabled: boolean;
-        logsDir?: string;
+        logger?: {
+            winston: {
+                transports: transport[];
+            };
+        };
         telemetry?: {
             enabled: boolean;
         };
@@ -85,7 +95,10 @@ declare class ExuluApp {
         config: ExuluConfig;
         agents?: ExuluAgent[];
         tools?: ExuluTool[];
-    }) => Promise<Express>;
+    }) => Promise<ExuluApp>;
+    express: {
+        init: () => Promise<Express>;
+    };
     get expressApp(): Express;
     tool(id: string): ExuluTool | undefined;
     tools(): ExuluTool[];

package/dist/index.js

@@ -7,7 +7,8 @@ import { createClient } from "redis";
 // src/bullmq/server.ts
 var redisServer = {
   host: `${process.env.REDIS_HOST}`,
-  port: process.env.REDIS_PORT
+  port: process.env.REDIS_PORT,
+  password: process.env.REDIS_PASSWORD || void 0
 };
 
 // src/redis/client.ts
@@ -5136,7 +5137,7 @@ var createRecurringJobs = async () => {
   );
   return queue;
 };
-var createExpressRoutes = async (app, logger, agents, tools, contexts, config, tracer, filesContext2) => {
+var createExpressRoutes = async (app, agents, tools, contexts, config, tracer, filesContext2) => {
   var corsOptions = {
     origin: "*",
     exposedHeaders: "*",
@@ -5189,8 +5190,8 @@ var createExpressRoutes = async (app, logger, agents, tools, contexts, config, t
     express.json({ limit: REQUEST_SIZE_LIMIT }),
     expressMiddleware(server, {
       context: async ({ req }) => {
-        logger.info("================");
-        logger.info({
+        console.info("================");
+        console.info({
           message: "Incoming Request",
           method: req.method,
           path: req.path,
@@ -5199,7 +5200,7 @@ var createExpressRoutes = async (app, logger, agents, tools, contexts, config, t
           userAgent: req.get("User-Agent"),
           headers: req.headers
         });
-        logger.info("================");
+        console.info("================");
         const authenticationResult = await requestValidators.authenticate(req);
         if (!authenticationResult.user?.id) {
           throw new Error(authenticationResult.message);
@@ -5466,10 +5467,10 @@ Mood: friendly and intelligent.
       },
       proxyReqPathResolver: (req) => {
         const prefix = `/gateway/anthropic/${req.params.id}`;
-        let path2 = req.url.startsWith(prefix) ? req.url.slice(prefix.length) : req.url;
-        if (!path2.startsWith("/")) path2 = "/" + path2;
-        console.log("[EXULU] Provider path:", path2);
-        return path2;
+        let path = req.url.startsWith(prefix) ? req.url.slice(prefix.length) : req.url;
+        if (!path.startsWith("/")) path = "/" + path;
+        console.log("[EXULU] Provider path:", path);
+        return path;
       },
       proxyReqOptDecorator: function(proxyReqOpts, srcReq) {
         return new Promise(async (resolve, reject) => {
@@ -5641,12 +5642,9 @@ var createCustomAnthropicStreamingMessage = (message) => {
 // src/registry/workers.ts
 import IORedis from "ioredis";
 import { Worker } from "bullmq";
-import * as fs2 from "fs";
-import path from "path";
 import "@opentelemetry/api";
-var defaultLogsDir = path.join(process.cwd(), "logs");
 var redisConnection;
-var createWorkers = async (queues2, logger, contexts, _logsDir, tracer) => {
+var createWorkers = async (queues2, contexts, tracer) => {
   if (!redisServer.host || !redisServer.port) {
     console.error("[EXULU] you are trying to start worker, but no redis server is configured in the environment.");
     throw new Error("No redis server configured in the environment, so cannot start worker.");
@@ -5657,7 +5655,6 @@ var createWorkers = async (queues2, logger, contexts, _logsDir, tracer) => {
       maxRetriesPerRequest: null
     });
   }
-  const logsDir = _logsDir || defaultLogsDir;
   const workers = queues2.map((queue) => {
     console.log(`[EXULU] creating worker for queue ${queue}.`);
     const worker = new Worker(
@@ -5710,41 +5707,8 @@ var createWorkers = async (queues2, logger, contexts, _logsDir, tracer) => {
     });
     return worker;
   });
-  const logsCleaner = createLogsCleanerWorker(logsDir);
-  workers.push(logsCleaner);
   return workers;
 };
-var createLogsCleanerWorker = (logsDir) => {
-  const logsCleaner = new Worker(
-    global_queues.logs_cleaner,
-    async (job) => {
-      console.log(`[EXULU] recurring job ${job.id}.`);
-      const folder = fs2.readdirSync(logsDir);
-      const files = folder.filter((file) => file.endsWith(".log"));
-      const now = /* @__PURE__ */ new Date();
-      const daysToKeep = job.data.ttld;
-      const dateToKeep = new Date(now.getTime() - daysToKeep * 24 * 60 * 60 * 1e3);
-      files.forEach((file) => {
-        const filePath = path.join(logsDir, file);
-        const fileStats = fs2.statSync(filePath);
-        if (fileStats.mtime < dateToKeep) {
-          fs2.unlinkSync(filePath);
-        }
-      });
-    },
-    { connection: redisConnection }
-  );
-  logsCleaner.on("completed", (job, returnvalue) => {
-    console.log(`[EXULU] completed logs cleaner ${job.id}.`, returnvalue);
-  });
-  logsCleaner.on("failed", (job, error, prev) => {
-    if (job?.id) {
-      console.error(`[EXULU] failed logs cleaner ${job.id}.`);
-    }
-    console.error(`[EXULU] job error logs cleaner.`, error);
-  });
-  return logsCleaner;
-};
 
 // src/mcp/index.ts
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -5761,7 +5725,7 @@ var ExuluMCP = class {
   express;
   constructor() {
   }
-  create = async ({ express: express3, contexts, agents, config, tools, tracer, logger }) => {
+  create = async ({ express: express3, contexts, agents, config, tools, tracer }) => {
     this.express = express3;
     if (!this.server) {
       console.log("[EXULU] Creating MCP server.");
@@ -6018,7 +5982,8 @@ import { trace } from "@opentelemetry/api";
 import { OpenTelemetryTransportV3 } from "@opentelemetry/winston-transport";
 import winston from "winston";
 var createLogger = ({
-  enableOtel
+  enableOtel,
+  transports
 }) => {
   const logger = winston.createLogger({
     level: "debug",
@@ -6035,7 +6000,7 @@ var createLogger = ({
       environment: process.env.NODE_ENV || "development"
     },
     transports: [
-      new winston.transports.Console(),
+      ...transports,
       ...enableOtel ? [new OpenTelemetryTransportV3()] : []
     ]
   });
@@ -6114,6 +6079,7 @@ var filesContext = new ExuluContext({
 });
 
 // src/registry/index.ts
+import winston2 from "winston";
 var isValidPostgresName = (id) => {
   const regex = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
   const isValid = regex.test(id);
@@ -6181,12 +6147,18 @@ var ExuluApp = class {
       ...contextsArray?.length ? contextsArray.map((context) => context.embedder?.queue?.name || null) : []
     ];
     this._queues = [...new Set(queues2.filter((o) => !!o))];
-    if (!this._expressApp) {
-      this._expressApp = express2();
-      await this.server.express.init();
-      console.log("[EXULU] Express app initialized.");
+    console.log("[EXULU] App initialized.");
+    return this;
+  };
+  express = {
+    init: async () => {
+      if (!this._expressApp) {
+        this._expressApp = express2();
+        await this.server.express.init();
+        console.log("[EXULU] Express app initialized.");
+      }
+      return this._expressApp;
     }
-    return this._expressApp;
   };
   get expressApp() {
     if (!this._expressApp) {
@@ -6247,14 +6219,19 @@ var ExuluApp = class {
         if (this._config?.telemetry?.enabled) {
           tracer = trace.getTracer("exulu", "1.0.0");
         }
+        const transports = this._config?.workers?.logger?.winston?.transports ?? this._config?.logger?.winston?.transports ?? [new winston2.transports.Console()];
         const logger = logger_default({
-          enableOtel: this._config?.workers?.telemetry?.enabled ?? false
+          enableOtel: this._config?.workers?.telemetry?.enabled ?? false,
+          transports
         });
+        console.log = (...args) => logger.info(args.map(String).join(" "));
+        console.info = (...args) => logger.info(args.map(String).join(" "));
+        console.warn = (...args) => logger.warn(args.map(String).join(" "));
+        console.error = (...args) => logger.error(args.map(String).join(" "));
+        console.debug = (...args) => logger.debug(args.map(String).join(" "));
         return await createWorkers(
           this._queues,
-          logger,
           Object.values(this._contexts ?? {}),
-          this._config?.workers?.logsDir,
           tracer
         );
       }
@@ -6272,11 +6249,16 @@ var ExuluApp = class {
           tracer = trace.getTracer("exulu", "1.0.0");
         }
         const logger = logger_default({
-          enableOtel: this._config?.telemetry?.enabled ?? false
+          enableOtel: this._config?.telemetry?.enabled ?? false,
+          transports: this._config?.logger?.winston?.transports ?? [new winston2.transports.Console()]
         });
+        console.log = (...args) => logger.info(args.map(String).join(" "));
+        console.info = (...args) => logger.info(args.map(String).join(" "));
+        console.warn = (...args) => logger.warn(args.map(String).join(" "));
+        console.error = (...args) => logger.error(args.map(String).join(" "));
+        console.debug = (...args) => logger.debug(args.map(String).join(" "));
         await createExpressRoutes(
           app,
-          logger,
           this._agents,
           this._tools,
           Object.values(this._contexts ?? {}),
@@ -6292,8 +6274,7 @@ var ExuluApp = class {
             agents: this._agents,
             config: this._config,
             tools: this._tools,
-            tracer,
-            logger
+            tracer
           });
           await mcp.connect();
         }
@@ -6562,7 +6543,7 @@ var RecursiveRules = class _RecursiveRules {
    * @param {string} path - The path to the recipe.
    * @returns {Promise<RecursiveRules>} The RecursiveRules object.
    */
-  static async fromRecipe(name = "default", lang = "en", path2) {
+  static async fromRecipe(name = "default", lang = "en", path) {
     throw new Error("Not implemented");
   }
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@exulu/backend",
   "author": "Qventu Bv.",
-  "version": "1.25.2",
+  "version": "1.25.4",
   "main": "./dist/index.js",
   "private": false,
   "publishConfig": {