expresso-macchiato 0.3.6 → 0.3.8-dev

package/dist/index.d.mts

@@ -1,8 +1,20 @@
 import { Request, Response as Response$1, RequestHandler, Router, Express } from 'express';
 import { BaseEntity, MixedList, EntitySchema } from 'typeorm';
+import { Socket, Namespace, Server as Server$1, ServerOptions } from 'socket.io';
 import http from 'http';
 import { Logger } from 'utils-logger-av';
 
+type BackgroundServiceConstructor = {
+    name: string;
+    main: () => Promise<void>;
+};
+
+declare class BackgroundService {
+    readonly name: string;
+    readonly main: () => Promise<void>;
+    constructor(data: BackgroundServiceConstructor);
+}
+
 type ErrorsMapping = Record<string, {
     status?: number;
     responseMessage?: string;
@@ -440,6 +452,46 @@ declare class RouterWrapper {
     createExpressRouter: () => Router;
 }
 
+type ConnectedSocketClient<Metadata = any> = {
+    socket: Socket;
+    connectedAt: Date;
+    metadata?: Metadata;
+};
+type SocketConnectionNok = {
+    ok: false;
+    message: string;
+};
+type SocketConnectionOk<Metadata = any> = {
+    ok: true;
+    newMetadata?: Metadata;
+};
+type SocketConnectionMiddleware<Metadata extends Record<string, any> = any> = (self: SocketWrapper, client: Socket, commId?: string, metadata?: Metadata) => Promise<SocketConnectionOk<Metadata> | SocketConnectionNok>;
+type SocketWrapperConstructor<Metadata extends Record<string, any> = any> = {
+    socket_namespace: string;
+    clientConnectionKey?: string;
+    connectionMiddleware?: SocketConnectionMiddleware<Metadata>;
+    afterClientConnect?: (self: SocketWrapper, client: Socket, metadata?: Metadata) => Promise<void>;
+    onClientDisconnect?: (...params: any[]) => Promise<void>;
+    listeners?: Record<string, (self: SocketWrapper, client: Socket, metadata: any, ...params: any[]) => Promise<void>>;
+};
+
+declare class SocketWrapper<Metadata extends Record<string, any> = any> {
+    protected connectedClients: Map<string, ConnectedSocketClient>;
+    readonly socket_namespace: string;
+    protected readonly data: SocketWrapperConstructor<Metadata>;
+    protected namespace?: Namespace;
+    constructor(data: SocketWrapperConstructor<Metadata>);
+    setupConnection: (io: Server$1) => void;
+    protected handleDisconnection: (client: Socket) => void;
+    broadcast: (eventName: string, data: any) => void;
+    broadcastExceptClient: (clientId: string, eventName: string, data: any) => void;
+    sendToClient: (clientId: string, eventName: string, data: any) => void;
+    sendToRoom: (room: string, eventName: string, data: any) => void;
+    getConnectedSockets: () => ConnectedSocketClient[];
+    getClientById: (clientId: string) => ConnectedSocketClient | undefined;
+    getClientByMetadataKey: (key: keyof Metadata, value: any) => ConnectedSocketClient | undefined;
+}
+
 declare class Token<Payload extends Record<string, any> = DefaultTokenPayload> {
     private SECRET_KEY;
     private ExpTime;
@@ -448,7 +500,7 @@ declare class Token<Payload extends Record<string, any> = DefaultTokenPayload> {
     private keyStore;
     constructor(tokenPayload: TokenConstructor);
     private getKey;
-    authorize: (req: Request) => Promise<Payload>;
+    authorize: (req: Request | string) => Promise<Payload>;
     private deriveEncryptionKey;
     generateJWE(payload: Payload): Promise<string>;
     verifyJWE(token: string): Promise<Payload>;
@@ -460,8 +512,11 @@ type StarterOptions = {
     clientPath?: string;
     swagger?: boolean;
     projectConfig: ProjectConfigs;
-    beforeStartListening?: (app: Express, server?: http.Server) => void;
-    socket?: boolean;
+    beforeStartListening?: (app: Express, httpServer?: http.Server, socketIoServerInstance?: Server$1) => void;
+    sockets?: {
+        wrappers: Array<SocketWrapper>;
+        options?: ServerOptions;
+    };
     tokenOptions?: {
         tokenInstance: Token;
         api?: TokenApiOptions;
@@ -472,12 +527,7 @@ type StarterOptions = {
         sync?: boolean;
         afterDbConnection?: () => Promise<void>;
     };
-};
-type SocketWrapperConstructor = {
-    name: string;
-    beforeConnection?: () => Promise<void>;
-    onDisconnect?: (...params: any[]) => Promise<void>;
-    listeners?: Record<string, (...params: any[]) => Promise<void>>;
+    backgroundServices?: Array<BackgroundService>;
 };
 
 declare class Starter {
@@ -591,14 +641,16 @@ type DynamicDbRouterOptions<T extends typeof BaseEntity> = {
 declare class MyLogger extends Logger {
     setFilePath: (filePath?: string) => void;
     fullLogOk: (service: string, message: string) => void;
-    fullLogNok: (service: string, error: any, ...args: any[]) => void;
+    fullLogNok: (service: string, ...args: any[]) => void;
 }
 declare const log: MyLogger;
 declare const fullLogOk: (service: string, message: string) => void;
-declare const fullLogNok: (service: string, error: any, ...args: any[]) => void;
+declare const fullLogNok: (service: string, ...args: any[]) => void;
 declare const apiOk: (res: any, status?: number, contentType?: string) => ExpressReturn;
 declare const apiNok: (err: any, status?: number) => ExpressReturn;
 declare const errorCatcher: (res: Response$1, err: unknown, errorsList?: ErrorsMapping, errorString?: string) => void;
+declare const socketOk: <T extends Record<string, any> = any>(newMetadata?: T) => SocketConnectionOk;
+declare const socketNok: (message: string) => SocketConnectionNok;
 declare const getCompiledPath: (__filename: string, __dirname: string, pathsWithoutExtension: string[]) => string[];
 
-export { type ApiKeySecurity, type BaseFormatContrainedParameter, type BaseOAuthSecurity, type BaseParameter, type BaseSchema, type BaseSecurity, type BasicAuthenticationSecurity, type BodyParameter, type Components, type Contact, type DefaultTokenPayload, type DynamicDbRouterOptions, type DynamicSwaggerOperation, type DynamicSwaggerOperationBody, type DynamicSwaggerPath, type DynamicSwaggerRequestBodyOperation, type ErrorsMapping, type ExpressReturn, type ExternalDocs, type FormDataParameter, type GenericFormat, type Header, type HeaderParameter, type Info, type IntegerFormat, type License, type ListOptions, type MethodPathHandling, type Methods, type NumberFormat, type OAuth2AccessCodeSecurity, type OAuth2ApplicationSecurity, type OAuth2ImplicitSecurity, type OAuth2PasswordSecurity, type OAuthScope, type Operation, type Parameter, type ParameterCollectionFormat, type ParameterType, type Path, type PathParameter, type ProjectConfigs, type QueryParameter, type Reference, type RequestBodyOperation, type Response, RouterWrapper, type RouterWrapperInterface, type Schema, type SchemaFormatConstraints, type SchemaV3, type SearchQuery, type SecureTokenConfig, type Security, type Server, type SocketWrapperConstructor, type Spec, Starter, type StarterOptions, type StringFormat, Swagger, type SwaggerMetadataInterface, type Tag, Token, type TokenApiOptions, type TokenConstructor, type XML, apiNok, apiOk, errorCatcher, fullLogNok, fullLogOk, getCompiledPath, log };
+export { type ApiKeySecurity, BackgroundService, type BaseFormatContrainedParameter, type BaseOAuthSecurity, type BaseParameter, type BaseSchema, type BaseSecurity, type BasicAuthenticationSecurity, type BodyParameter, type Components, type ConnectedSocketClient, type Contact, type DefaultTokenPayload, type DynamicDbRouterOptions, type DynamicSwaggerOperation, type DynamicSwaggerOperationBody, type DynamicSwaggerPath, type DynamicSwaggerRequestBodyOperation, type ErrorsMapping, type ExpressReturn, type ExternalDocs, type FormDataParameter, type GenericFormat, type Header, type HeaderParameter, type Info, type IntegerFormat, type License, type ListOptions, type MethodPathHandling, type Methods, type NumberFormat, type OAuth2AccessCodeSecurity, type OAuth2ApplicationSecurity, type OAuth2ImplicitSecurity, type OAuth2PasswordSecurity, type OAuthScope, type Operation, type Parameter, type ParameterCollectionFormat, type ParameterType, type Path, type PathParameter, type ProjectConfigs, type QueryParameter, type Reference, type RequestBodyOperation, type Response, RouterWrapper, type RouterWrapperInterface, type Schema, type SchemaFormatConstraints, type SchemaV3, type SearchQuery, type SecureTokenConfig, type Security, type Server, type SocketConnectionMiddleware, type SocketConnectionNok, type SocketConnectionOk, SocketWrapper, type SocketWrapperConstructor, type Spec, Starter, type StarterOptions, type StringFormat, Swagger, type SwaggerMetadataInterface, type Tag, Token, type TokenApiOptions, type TokenConstructor, type XML, apiNok, apiOk, errorCatcher, fullLogNok, fullLogOk, getCompiledPath, log, socketNok, socketOk };

package/dist/index.d.ts

@@ -1,8 +1,20 @@
 import { Request, Response as Response$1, RequestHandler, Router, Express } from 'express';
 import { BaseEntity, MixedList, EntitySchema } from 'typeorm';
+import { Socket, Namespace, Server as Server$1, ServerOptions } from 'socket.io';
 import http from 'http';
 import { Logger } from 'utils-logger-av';
 
+type BackgroundServiceConstructor = {
+    name: string;
+    main: () => Promise<void>;
+};
+
+declare class BackgroundService {
+    readonly name: string;
+    readonly main: () => Promise<void>;
+    constructor(data: BackgroundServiceConstructor);
+}
+
 type ErrorsMapping = Record<string, {
     status?: number;
     responseMessage?: string;
@@ -440,6 +452,46 @@ declare class RouterWrapper {
     createExpressRouter: () => Router;
 }
 
+type ConnectedSocketClient<Metadata = any> = {
+    socket: Socket;
+    connectedAt: Date;
+    metadata?: Metadata;
+};
+type SocketConnectionNok = {
+    ok: false;
+    message: string;
+};
+type SocketConnectionOk<Metadata = any> = {
+    ok: true;
+    newMetadata?: Metadata;
+};
+type SocketConnectionMiddleware<Metadata extends Record<string, any> = any> = (self: SocketWrapper, client: Socket, commId?: string, metadata?: Metadata) => Promise<SocketConnectionOk<Metadata> | SocketConnectionNok>;
+type SocketWrapperConstructor<Metadata extends Record<string, any> = any> = {
+    socket_namespace: string;
+    clientConnectionKey?: string;
+    connectionMiddleware?: SocketConnectionMiddleware<Metadata>;
+    afterClientConnect?: (self: SocketWrapper, client: Socket, metadata?: Metadata) => Promise<void>;
+    onClientDisconnect?: (...params: any[]) => Promise<void>;
+    listeners?: Record<string, (self: SocketWrapper, client: Socket, metadata: any, ...params: any[]) => Promise<void>>;
+};
+
+declare class SocketWrapper<Metadata extends Record<string, any> = any> {
+    protected connectedClients: Map<string, ConnectedSocketClient>;
+    readonly socket_namespace: string;
+    protected readonly data: SocketWrapperConstructor<Metadata>;
+    protected namespace?: Namespace;
+    constructor(data: SocketWrapperConstructor<Metadata>);
+    setupConnection: (io: Server$1) => void;
+    protected handleDisconnection: (client: Socket) => void;
+    broadcast: (eventName: string, data: any) => void;
+    broadcastExceptClient: (clientId: string, eventName: string, data: any) => void;
+    sendToClient: (clientId: string, eventName: string, data: any) => void;
+    sendToRoom: (room: string, eventName: string, data: any) => void;
+    getConnectedSockets: () => ConnectedSocketClient[];
+    getClientById: (clientId: string) => ConnectedSocketClient | undefined;
+    getClientByMetadataKey: (key: keyof Metadata, value: any) => ConnectedSocketClient | undefined;
+}
+
 declare class Token<Payload extends Record<string, any> = DefaultTokenPayload> {
     private SECRET_KEY;
     private ExpTime;
@@ -448,7 +500,7 @@ declare class Token<Payload extends Record<string, any> = DefaultTokenPayload> {
     private keyStore;
     constructor(tokenPayload: TokenConstructor);
     private getKey;
-    authorize: (req: Request) => Promise<Payload>;
+    authorize: (req: Request | string) => Promise<Payload>;
     private deriveEncryptionKey;
     generateJWE(payload: Payload): Promise<string>;
     verifyJWE(token: string): Promise<Payload>;
@@ -460,8 +512,11 @@ type StarterOptions = {
     clientPath?: string;
     swagger?: boolean;
     projectConfig: ProjectConfigs;
-    beforeStartListening?: (app: Express, server?: http.Server) => void;
-    socket?: boolean;
+    beforeStartListening?: (app: Express, httpServer?: http.Server, socketIoServerInstance?: Server$1) => void;
+    sockets?: {
+        wrappers: Array<SocketWrapper>;
+        options?: ServerOptions;
+    };
     tokenOptions?: {
         tokenInstance: Token;
         api?: TokenApiOptions;
@@ -472,12 +527,7 @@ type StarterOptions = {
         sync?: boolean;
         afterDbConnection?: () => Promise<void>;
     };
-};
-type SocketWrapperConstructor = {
-    name: string;
-    beforeConnection?: () => Promise<void>;
-    onDisconnect?: (...params: any[]) => Promise<void>;
-    listeners?: Record<string, (...params: any[]) => Promise<void>>;
+    backgroundServices?: Array<BackgroundService>;
 };
 
 declare class Starter {
@@ -591,14 +641,16 @@ type DynamicDbRouterOptions<T extends typeof BaseEntity> = {
 declare class MyLogger extends Logger {
     setFilePath: (filePath?: string) => void;
     fullLogOk: (service: string, message: string) => void;
-    fullLogNok: (service: string, error: any, ...args: any[]) => void;
+    fullLogNok: (service: string, ...args: any[]) => void;
 }
 declare const log: MyLogger;
 declare const fullLogOk: (service: string, message: string) => void;
-declare const fullLogNok: (service: string, error: any, ...args: any[]) => void;
+declare const fullLogNok: (service: string, ...args: any[]) => void;
 declare const apiOk: (res: any, status?: number, contentType?: string) => ExpressReturn;
 declare const apiNok: (err: any, status?: number) => ExpressReturn;
 declare const errorCatcher: (res: Response$1, err: unknown, errorsList?: ErrorsMapping, errorString?: string) => void;
+declare const socketOk: <T extends Record<string, any> = any>(newMetadata?: T) => SocketConnectionOk;
+declare const socketNok: (message: string) => SocketConnectionNok;
 declare const getCompiledPath: (__filename: string, __dirname: string, pathsWithoutExtension: string[]) => string[];
 
-export { type ApiKeySecurity, type BaseFormatContrainedParameter, type BaseOAuthSecurity, type BaseParameter, type BaseSchema, type BaseSecurity, type BasicAuthenticationSecurity, type BodyParameter, type Components, type Contact, type DefaultTokenPayload, type DynamicDbRouterOptions, type DynamicSwaggerOperation, type DynamicSwaggerOperationBody, type DynamicSwaggerPath, type DynamicSwaggerRequestBodyOperation, type ErrorsMapping, type ExpressReturn, type ExternalDocs, type FormDataParameter, type GenericFormat, type Header, type HeaderParameter, type Info, type IntegerFormat, type License, type ListOptions, type MethodPathHandling, type Methods, type NumberFormat, type OAuth2AccessCodeSecurity, type OAuth2ApplicationSecurity, type OAuth2ImplicitSecurity, type OAuth2PasswordSecurity, type OAuthScope, type Operation, type Parameter, type ParameterCollectionFormat, type ParameterType, type Path, type PathParameter, type ProjectConfigs, type QueryParameter, type Reference, type RequestBodyOperation, type Response, RouterWrapper, type RouterWrapperInterface, type Schema, type SchemaFormatConstraints, type SchemaV3, type SearchQuery, type SecureTokenConfig, type Security, type Server, type SocketWrapperConstructor, type Spec, Starter, type StarterOptions, type StringFormat, Swagger, type SwaggerMetadataInterface, type Tag, Token, type TokenApiOptions, type TokenConstructor, type XML, apiNok, apiOk, errorCatcher, fullLogNok, fullLogOk, getCompiledPath, log };
+export { type ApiKeySecurity, BackgroundService, type BaseFormatContrainedParameter, type BaseOAuthSecurity, type BaseParameter, type BaseSchema, type BaseSecurity, type BasicAuthenticationSecurity, type BodyParameter, type Components, type ConnectedSocketClient, type Contact, type DefaultTokenPayload, type DynamicDbRouterOptions, type DynamicSwaggerOperation, type DynamicSwaggerOperationBody, type DynamicSwaggerPath, type DynamicSwaggerRequestBodyOperation, type ErrorsMapping, type ExpressReturn, type ExternalDocs, type FormDataParameter, type GenericFormat, type Header, type HeaderParameter, type Info, type IntegerFormat, type License, type ListOptions, type MethodPathHandling, type Methods, type NumberFormat, type OAuth2AccessCodeSecurity, type OAuth2ApplicationSecurity, type OAuth2ImplicitSecurity, type OAuth2PasswordSecurity, type OAuthScope, type Operation, type Parameter, type ParameterCollectionFormat, type ParameterType, type Path, type PathParameter, type ProjectConfigs, type QueryParameter, type Reference, type RequestBodyOperation, type Response, RouterWrapper, type RouterWrapperInterface, type Schema, type SchemaFormatConstraints, type SchemaV3, type SearchQuery, type SecureTokenConfig, type Security, type Server, type SocketConnectionMiddleware, type SocketConnectionNok, type SocketConnectionOk, SocketWrapper, type SocketWrapperConstructor, type Spec, Starter, type StarterOptions, type StringFormat, Swagger, type SwaggerMetadataInterface, type Tag, Token, type TokenApiOptions, type TokenConstructor, type XML, apiNok, apiOk, errorCatcher, fullLogNok, fullLogOk, getCompiledPath, log, socketNok, socketOk };

package/dist/index.js

@@ -1,7 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/RouterWrapper.ts
-var _express = require('express'); var _express2 = _interopRequireDefault(_express);
-
-// src/_utils.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/_utils.ts
 var _path2 = require('path'); var _path3 = _interopRequireDefault(_path2);
 var _utilsloggerav = require('utils-logger-av');
 var MyLogger = class extends _utilsloggerav.Logger {
@@ -14,10 +11,12 @@ var MyLogger = class extends _utilsloggerav.Logger {
       this.ok(`[${service.toUpperCase()}]: ${message}`);
       this.file(`[${service.toUpperCase()}]: ${message}`);
     };
-    this.fullLogNok = (service, error, ...args) => {
-      const errMessage = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _2 => _2.message]), () => ( error));
-      this.nok(`[${service.toUpperCase()}]: ${errMessage}`);
-      this.file(`[${service.toUpperCase()}]: ${errMessage}, ${args.join(",")}`, "error");
+    this.fullLogNok = (service, ...args) => {
+      let finalString = `[${service.toUpperCase()}]: `;
+      for (let i = 0; i < args.length; i++) if (i === args.length - 1) finalString += _nullishCoalesce(_optionalChain([args, 'access', _2 => _2[i], 'optionalAccess', _3 => _3.message]), () => ( args[i]));
+      else finalString += args[i] + " ";
+      this.nok(`[${service.toUpperCase()}]: ${finalString}`);
+      this.file(`[${service.toUpperCase()}]: ${finalString}`, "error");
     };
   }
 };
@@ -35,11 +34,30 @@ var errorCatcher = (res, err, errorsList, errorString) => {
   if (!error) res.status(500).send({ message: err.message });
   else res.status(_nullishCoalesce(error.status, () => ( 500))).send({ message: _nullishCoalesce(error.responseMessage, () => ( err.message)) });
 };
+var socketOk = (newMetadata) => ({ ok: true, newMetadata });
+var socketNok = (message) => ({ ok: false, message });
 var getCompiledPath = (__filename, __dirname, pathsWithoutExtension) => {
   const isCompiled = __filename.endsWith(".js");
   return pathsWithoutExtension.map((p) => _path3.default.join(__dirname, p + (isCompiled ? ".js" : ".ts")).replaceAll("\\", "/"));
 };
 
+// src/BackgroundService.ts
+var BackgroundService = class {
+  constructor(data) {
+    this.name = data.name;
+    this.main = async () => {
+      try {
+        await data.main();
+      } catch (error) {
+        fullLogNok("BACKGROUND-SERVICE", `${this.name.toUpperCase()}`, error);
+      }
+    };
+  }
+};
+
+// src/RouterWrapper.ts
+var _express = require('express'); var _express2 = _interopRequireDefault(_express);
+
 // src/DynamicDbRouter.ts
 var _typeorm = require('typeorm');
 
@@ -50,7 +68,7 @@ var _DbConnector = class _DbConnector {
   constructor(projectConfig) {
     this.connect = async (entities, migrations, sync) => {
       try {
-        if (!this.projectConfig.DB_DIALECT || !this.projectConfig.DB_NAME) throw new Error("[DB-CONNECTOR]	Missing configs =>DB_DIALECT || DB_NAME");
+        if (!this.projectConfig.DB_DIALECT || !this.projectConfig.DB_NAME) throw new Error("[DB-CONNECTOR] Missing configs => DB_DIALECT || DB_NAME");
         const AppDataSource = new (0, _typeorm.DataSource)({
           type: this.projectConfig.DB_DIALECT,
           host: this.projectConfig.DB_HOST,
@@ -83,7 +101,7 @@ var _DbConnector = class _DbConnector {
         _DbConnector.DataSource = AppDataSource;
         log.magenta(`[DB-CONNECTOR] ORM CONNECTED`);
       } catch (err) {
-        log.logError(err);
+        fullLogNok("DB-CONNECTOR", err);
       }
     };
     this.projectConfig = projectConfig;
@@ -223,7 +241,7 @@ _Swagger._addApiPath = (tag, basePath, options) => {
   const finalSchemas = {};
   for (const _path in options) {
     const path3 = `${basePath}${_path}`;
-    if (_optionalChain([options, 'access', _3 => _3[_path], 'access', _4 => _4.get, 'optionalAccess', _5 => _5.tags])) options[_path].get.tags = [tag];
+    if (_optionalChain([options, 'access', _4 => _4[_path], 'access', _5 => _5.get, 'optionalAccess', _6 => _6.tags])) options[_path].get.tags = [tag];
     finalPaths[path3] = {
       get: options[_path].get,
       $ref: options[_path].$ref,
@@ -321,10 +339,10 @@ _Swagger.getIdParam = (pkLabel = "id") => ({ name: pkLabel, in: "path", required
  */
 _Swagger.getPaginationParams = (options) => {
   const listOptions = {
-    page: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _6 => _6.page]), () => ( 0)),
-    pageSize: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _7 => _7.pageSize]), () => ( 10)),
-    order: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _8 => _8.order]), () => ( "ASC")),
-    orderBy: _optionalChain([options, 'optionalAccess', _9 => _9.orderBy])
+    page: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _7 => _7.page]), () => ( 0)),
+    pageSize: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _8 => _8.pageSize]), () => ( 10)),
+    order: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _9 => _9.order]), () => ( "ASC")),
+    orderBy: _optionalChain([options, 'optionalAccess', _10 => _10.orderBy])
   };
   return Object.entries(listOptions).map(([key, val]) => ({ name: key, in: "query", default: val, required: false }));
 };
@@ -420,7 +438,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       });
       res.send(entities);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[GET]	${options.basePath}/ => ${_nullishCoalesce(err.message, () => ( err))}`);
+      errorCatcher(res, err, void 0, `[GET] ${options.basePath}/ => ${_nullishCoalesce(err.message, () => ( err))}`);
     }
   });
   if (!avoidList.includes("GET")) options.router.get("/:id", async (req, res) => {
@@ -438,7 +456,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       });
       res.send(singleEntity);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[GET]	${options.basePath}/:id => ${_nullishCoalesce(err.message, () => ( err))}`);
+      errorCatcher(res, err, void 0, `[GET] ${options.basePath}/:id => ${_nullishCoalesce(err.message, () => ( err))}`);
     }
   });
   if (!avoidList.includes("POST")) options.router.post("/", async (req, res) => {
@@ -452,7 +470,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       const finalBody = {};
       const body = req.body;
       for (const key in body) {
-        if (key !== options.primaryKey && (!options.bodyParameters || _optionalChain([options, 'access', _10 => _10.bodyParameters, 'access', _11 => _11.properties, 'optionalAccess', _12 => _12[key]]))) {
+        if (key !== options.primaryKey && (!options.bodyParameters || _optionalChain([options, 'access', _11 => _11.bodyParameters, 'access', _12 => _12.properties, 'optionalAccess', _13 => _13[key]]))) {
           finalBody[key] = body[key];
         }
       }
@@ -466,7 +484,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       }
       res.send(result);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[POST]	${options.basePath}/ => ${_nullishCoalesce(err.message, () => ( err))}`);
+      errorCatcher(res, err, void 0, `[POST] ${options.basePath}/ => ${_nullishCoalesce(err.message, () => ( err))}`);
     }
   });
   if (!avoidList.includes("PUT")) options.router.put("/:id", async (req, res) => {
@@ -483,7 +501,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       if (singleEntity === null) throw new Error("Entity not found");
       for (const key in body) {
         if (key !== options.primaryKey && key in singleEntity) {
-          if (!options.bodyParameters || _optionalChain([options, 'access', _13 => _13.bodyParameters, 'access', _14 => _14.properties, 'optionalAccess', _15 => _15[key]])) {
+          if (!options.bodyParameters || _optionalChain([options, 'access', _14 => _14.bodyParameters, 'access', _15 => _15.properties, 'optionalAccess', _16 => _16[key]])) {
             singleEntity[key] = body[key];
           }
         }
@@ -498,7 +516,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       }
       res.send(result);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[PUT]	${options.basePath}/:id => ${_nullishCoalesce(err.message, () => ( err))}`);
+      errorCatcher(res, err, void 0, `[PUT] ${options.basePath}/:id => ${_nullishCoalesce(err.message, () => ( err))}`);
     }
   });
   if (!avoidList.includes("DELETE")) options.router.delete("/:id", async (req, res) => {
@@ -519,7 +537,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       }
       res.send(singleEntity);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[DELETE]	${options.basePath}/:id => ${_nullishCoalesce(err.message, () => ( err))}`);
+      errorCatcher(res, err, void 0, `[DELETE] ${options.basePath}/:id => ${_nullishCoalesce(err.message, () => ( err))}`);
     }
   });
   return options.router;
@@ -552,7 +570,7 @@ _DynamicDbRouter.addDbRouterSwagger = (options) => {
     }
   } catch (err) {
     if (err instanceof _typeorm.EntityMetadataNotFoundError)
-      log.error(`[${options.entity.name}]	Metadata required for db routing but not connected on the database`);
+      fullLogNok("DYNAMIC-DB-ROUTING", `[${options.entity.name}] Metadata required for db routing but not connected on the database`);
   }
   if (!avoidList.includes("LIST")) {
     const listOptions = { page: 0, pageSize: 10, order: "ASC", orderBy: options.primaryKey };
@@ -608,11 +626,11 @@ var RouterWrapper = class {
       const newRouter = _express.Router.call(void 0, );
       if (this.data.dbRouting) {
         const avoidOptionsForDefinedApis = [];
-        if (_optionalChain([this, 'access', _16 => _16.data, 'access', _17 => _17.apis, 'optionalAccess', _18 => _18["/"], 'optionalAccess', _19 => _19.GET])) avoidOptionsForDefinedApis.push("LIST");
-        if (_optionalChain([this, 'access', _20 => _20.data, 'access', _21 => _21.apis, 'optionalAccess', _22 => _22["/:id"], 'optionalAccess', _23 => _23.GET])) avoidOptionsForDefinedApis.push("GET");
-        if (_optionalChain([this, 'access', _24 => _24.data, 'access', _25 => _25.apis, 'optionalAccess', _26 => _26["/"], 'optionalAccess', _27 => _27.POST])) avoidOptionsForDefinedApis.push("POST");
-        if (_optionalChain([this, 'access', _28 => _28.data, 'access', _29 => _29.apis, 'optionalAccess', _30 => _30["/:id"], 'optionalAccess', _31 => _31.PUT])) avoidOptionsForDefinedApis.push("PUT");
-        if (_optionalChain([this, 'access', _32 => _32.data, 'access', _33 => _33.apis, 'optionalAccess', _34 => _34["/:id"], 'optionalAccess', _35 => _35.DELETE])) avoidOptionsForDefinedApis.push("DELETE");
+        if (_optionalChain([this, 'access', _17 => _17.data, 'access', _18 => _18.apis, 'optionalAccess', _19 => _19["/"], 'optionalAccess', _20 => _20.GET])) avoidOptionsForDefinedApis.push("LIST");
+        if (_optionalChain([this, 'access', _21 => _21.data, 'access', _22 => _22.apis, 'optionalAccess', _23 => _23["/:id"], 'optionalAccess', _24 => _24.GET])) avoidOptionsForDefinedApis.push("GET");
+        if (_optionalChain([this, 'access', _25 => _25.data, 'access', _26 => _26.apis, 'optionalAccess', _27 => _27["/"], 'optionalAccess', _28 => _28.POST])) avoidOptionsForDefinedApis.push("POST");
+        if (_optionalChain([this, 'access', _29 => _29.data, 'access', _30 => _30.apis, 'optionalAccess', _31 => _31["/:id"], 'optionalAccess', _32 => _32.PUT])) avoidOptionsForDefinedApis.push("PUT");
+        if (_optionalChain([this, 'access', _33 => _33.data, 'access', _34 => _34.apis, 'optionalAccess', _35 => _35["/:id"], 'optionalAccess', _36 => _36.DELETE])) avoidOptionsForDefinedApis.push("DELETE");
         for (const avoid of _nullishCoalesce(this.data.dbRouting.avoid, () => ( []))) {
           if (!avoidOptionsForDefinedApis.includes(avoid)) avoidOptionsForDefinedApis.push(avoid);
         }
@@ -637,7 +655,7 @@ var RouterWrapper = class {
         const path3 = _path.startsWith("/") ? _path : `/${_path}`;
         if (!this.data.apis || !this.data.apis[path3]) continue;
         for (const method in this.data.apis[path3]) {
-          if ((_nullishCoalesce(_optionalChain([this, 'access', _36 => _36.data, 'access', _37 => _37.apis, 'optionalAccess', _38 => _38[path3], 'optionalAccess', _39 => _39[method]]), () => ( void 0))) === void 0) continue;
+          if ((_nullishCoalesce(_optionalChain([this, 'access', _37 => _37.data, 'access', _38 => _38.apis, 'optionalAccess', _39 => _39[path3], 'optionalAccess', _40 => _40[method]]), () => ( void 0))) === void 0) continue;
           const currentMethod = this.data.apis[path3][method];
           const middlewares = _nullishCoalesce(currentMethod.middlewares, () => ( []));
           const callBackFunction = async (req, res) => {
@@ -649,8 +667,8 @@ var RouterWrapper = class {
               } else if (typeof handlerRes.result === "object") res.status(handlerRes.status).json(handlerRes.result);
               else res.status(handlerRes.status).send(handlerRes.result);
             } catch (err) {
-              fullLogNok("api", `[${method}]	${this.data.basePath}${path3} => ${_nullishCoalesce(err.message, () => ( err))}`);
-              res.status(500).send(_nullishCoalesce(_optionalChain([err, 'optionalAccess', _40 => _40.message]), () => ( err)));
+              fullLogNok("api", `[${method}] ${this.data.basePath}${path3} => ${_nullishCoalesce(err.message, () => ( err))}`);
+              res.status(500).send(_nullishCoalesce(_optionalChain([err, 'optionalAccess', _41 => _41.message]), () => ( err)));
             }
           };
           if (method === "GET") newRouter.get(path3, middlewares, callBackFunction);
@@ -679,7 +697,7 @@ var RouterWrapper = class {
           basePath: this.data.basePath,
           tag: this.data.tag,
           avoid: this.data.dbRouting.avoid,
-          secure: _optionalChain([this, 'access', _41 => _41.data, 'access', _42 => _42.dbRouting, 'optionalAccess', _43 => _43.secure])
+          secure: _optionalChain([this, 'access', _42 => _42.data, 'access', _43 => _43.dbRouting, 'optionalAccess', _44 => _44.secure])
         });
       }
       return newRouter;
@@ -689,10 +707,112 @@ var RouterWrapper = class {
   }
 };
 
+// src/SocketWrapper.ts
+var SocketWrapper = class {
+  constructor(data) {
+    this.connectedClients = /* @__PURE__ */ new Map();
+    this.setupConnection = (io) => {
+      try {
+        if (!this.data.listeners) throw new Error("No listeners provided");
+        this.namespace = io.of(`/${this.socket_namespace}`);
+        if (this.data.connectionMiddleware) {
+          io.use(async (client, next) => {
+            const commId = client.handshake.query.commId;
+            const metadata = client.handshake.query.metadata;
+            const beforeResult = await this.data.connectionMiddleware(this, client, commId, metadata);
+            if (!beforeResult.ok) {
+              const err = new Error(beforeResult.message);
+              return next(err);
+            }
+            if (beforeResult.newMetadata) client.handshake.query.metadata = beforeResult.newMetadata;
+            next();
+          });
+        }
+        io.on("connection", (client) => {
+          try {
+            if (!this.namespace) throw new Error("Socket.IO not initialized");
+            const metadata = client.handshake.query.metadata;
+            const finalClientId = this.data.clientConnectionKey ? _nullishCoalesce(_optionalChain([metadata, 'optionalAccess', _45 => _45[this.data.clientConnectionKey]]), () => ( client.id)) : client.id;
+            this.connectedClients.set(finalClientId, { socket: client, connectedAt: /* @__PURE__ */ new Date(), metadata });
+            log.cyan(`[SOCKETWRAPPER] [${this.socket_namespace.toUpperCase()}] Client ${client.id} connected`);
+            if (this.data.afterClientConnect) this.data.afterClientConnect(this, client, metadata);
+            for (const eventName in this.data.listeners) client.on(eventName, (...params) => _optionalChain([this, 'access', _46 => _46.data, 'access', _47 => _47.listeners, 'optionalAccess', _48 => _48[eventName], 'call', _49 => _49(this, client, metadata, ...params)]));
+            client.on("disconnect", () => this.handleDisconnection(client));
+          } catch (err) {
+            fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+          }
+        });
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    this.handleDisconnection = (client) => {
+      try {
+        if (!this.namespace) throw new Error("Socket.IO not initialized");
+        this.connectedClients.delete(client.id);
+        log.cyan(`[SOCKETWRAPPER] [${this.socket_namespace.toUpperCase()}] Client ${client.id} disconnected`);
+        if (this.data.onClientDisconnect) this.data.onClientDisconnect(client);
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    // --- SEND METHODS
+    this.broadcast = (eventName, data) => {
+      try {
+        if (!this.namespace) throw new Error("Socket.IO not initialized");
+        this.namespace.emit(eventName, data);
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    this.broadcastExceptClient = (clientId, eventName, data) => {
+      try {
+        for (const [id, client] of this.connectedClients.entries()) {
+          if (id !== clientId) client.socket.emit(eventName, data);
+        }
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    this.sendToClient = (clientId, eventName, data) => {
+      try {
+        const connectedClient = this.connectedClients.get(clientId);
+        if (!connectedClient) throw new Error(`Client ${clientId} not found`);
+        connectedClient.socket.emit(eventName, data);
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    this.sendToRoom = (room, eventName, data) => {
+      try {
+        if (!this.namespace) throw new Error("Socket.IO not initialized");
+        this.namespace.to(room).emit(eventName, data);
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    // --- GETTERS
+    this.getConnectedSockets = () => Array.from(this.connectedClients.values());
+    this.getClientById = (clientId) => this.connectedClients.get(clientId);
+    this.getClientByMetadataKey = (key, value) => {
+      for (const client of this.connectedClients.values()) {
+        if (client.metadata && client.metadata[key] === value) return client;
+      }
+      return void 0;
+    };
+    this.socket_namespace = data.socket_namespace;
+    this.data = data;
+    Object.keys(_nullishCoalesce(data.listeners, () => ( {}))).forEach((key) => {
+      this[key] = _optionalChain([data, 'access', _50 => _50.listeners, 'optionalAccess', _51 => _51[key], 'access', _52 => _52.bind, 'call', _53 => _53(this)]);
+    });
+  }
+};
+
 // src/Starter.ts
 
 var _http = require('http'); var _http2 = _interopRequireDefault(_http);
 
+var _socketio = require('socket.io');
 var _swaggeruiexpress = require('swagger-ui-express'); var _swaggeruiexpress2 = _interopRequireDefault(_swaggeruiexpress);
 var Starter = class {
   constructor(options) {
@@ -721,19 +841,22 @@ var Starter = class {
         const clientPath = _path3.default.resolve(process.cwd(), "client");
         app.use(_express2.default.static(clientPath));
         app.get("/apiUrl", (_, res) => res.send(options.projectConfig.API_URL));
-        if (_optionalChain([options, 'access', _44 => _44.tokenOptions, 'optionalAccess', _45 => _45.api])) {
+        if (_optionalChain([options, 'access', _54 => _54.tokenOptions, 'optionalAccess', _55 => _55.api])) {
           app.get(_nullishCoalesce(options.tokenOptions.api.path, () => ( "/api/auth")), options.tokenOptions.api.callback);
         }
         app.get("*", (_, res) => {
           res.sendFile(_path3.default.join(clientPath, "index.html"));
         });
       }
-      if (options.socket === void 0 || options.socket === false) {
+      for (const service of _nullishCoalesce(options.backgroundServices, () => ( []))) service.main();
+      if (options.sockets === void 0) {
         if (options.beforeStartListening) options.beforeStartListening(app);
         app.listen(options.projectConfig.SERVER_PORT, () => log.base("Server started.", `Listening on port ${options.projectConfig.SERVER_PORT}`));
-      } else if (options.socket === true) {
+      } else {
         const server = _http2.default.createServer(app);
-        if (options.beforeStartListening) options.beforeStartListening(app, server);
+        const socketIoServerInstance = new (0, _socketio.Server)(server, options.sockets.options);
+        for (const socket of options.sockets.wrappers) socket.setupConnection(socketIoServerInstance);
+        if (options.beforeStartListening) options.beforeStartListening(app, server, socketIoServerInstance);
         server.listen(options.projectConfig.SERVER_PORT, () => log.base("Server started.", `Listening on port ${options.projectConfig.SERVER_PORT}`));
       }
     };
@@ -745,7 +868,7 @@ var Starter = class {
       log.setFilePath(options.projectConfig.ERROR_FILE_PATH);
       this.init(options);
     } catch (err) {
-      log.error(err);
+      fullLogNok("starter", err);
     }
   }
 };
@@ -758,7 +881,11 @@ var Token = class {
     this.keyStore = null;
     // Metodo per autorizzare una richiesta
     this.authorize = async (req) => {
-      const token = _nullishCoalesce(_optionalChain([req, 'access', _46 => _46.headers, 'access', _47 => _47.authorization, 'optionalAccess', _48 => _48.split, 'call', _49 => _49("Bearer "), 'optionalAccess', _50 => _50[1]]), () => ( null));
+      if (typeof req === "string") {
+        const payload2 = await this.verifyJWE(req);
+        return payload2;
+      }
+      const token = _nullishCoalesce(_optionalChain([req, 'access', _56 => _56.headers, 'access', _57 => _57.authorization, 'optionalAccess', _58 => _58.split, 'call', _59 => _59("Bearer "), 'optionalAccess', _60 => _60[1]]), () => ( null));
       if (token === null) throw new Error("UNAUTH");
       const payload = await this.verifyJWE(token);
       return payload;
@@ -828,4 +955,8 @@ var Token = class {
 
 
 
-exports.RouterWrapper = RouterWrapper; exports.Starter = Starter; exports.Swagger = Swagger; exports.Token = Token; exports.apiNok = apiNok; exports.apiOk = apiOk; exports.errorCatcher = errorCatcher; exports.fullLogNok = fullLogNok; exports.fullLogOk = fullLogOk; exports.getCompiledPath = getCompiledPath; exports.log = log;
+
+
+
+
+exports.BackgroundService = BackgroundService; exports.RouterWrapper = RouterWrapper; exports.SocketWrapper = SocketWrapper; exports.Starter = Starter; exports.Swagger = Swagger; exports.Token = Token; exports.apiNok = apiNok; exports.apiOk = apiOk; exports.errorCatcher = errorCatcher; exports.fullLogNok = fullLogNok; exports.fullLogOk = fullLogOk; exports.getCompiledPath = getCompiledPath; exports.log = log; exports.socketNok = socketNok; exports.socketOk = socketOk;

package/dist/index.mjs

@@ -1,6 +1,3 @@
-// src/RouterWrapper.ts
-import { Router } from "express";
-
 // src/_utils.ts
 import path from "path";
 import { Logger } from "utils-logger-av";
@@ -14,10 +11,12 @@ var MyLogger = class extends Logger {
       this.ok(`[${service.toUpperCase()}]: ${message}`);
       this.file(`[${service.toUpperCase()}]: ${message}`);
     };
-    this.fullLogNok = (service, error, ...args) => {
-      const errMessage = error?.message ?? error;
-      this.nok(`[${service.toUpperCase()}]: ${errMessage}`);
-      this.file(`[${service.toUpperCase()}]: ${errMessage}, ${args.join(",")}`, "error");
+    this.fullLogNok = (service, ...args) => {
+      let finalString = `[${service.toUpperCase()}]: `;
+      for (let i = 0; i < args.length; i++) if (i === args.length - 1) finalString += args[i]?.message ?? args[i];
+      else finalString += args[i] + " ";
+      this.nok(`[${service.toUpperCase()}]: ${finalString}`);
+      this.file(`[${service.toUpperCase()}]: ${finalString}`, "error");
     };
   }
 };
@@ -35,11 +34,30 @@ var errorCatcher = (res, err, errorsList, errorString) => {
   if (!error) res.status(500).send({ message: err.message });
   else res.status(error.status ?? 500).send({ message: error.responseMessage ?? err.message });
 };
+var socketOk = (newMetadata) => ({ ok: true, newMetadata });
+var socketNok = (message) => ({ ok: false, message });
 var getCompiledPath = (__filename2, __dirname2, pathsWithoutExtension) => {
   const isCompiled = __filename2.endsWith(".js");
   return pathsWithoutExtension.map((p) => path.join(__dirname2, p + (isCompiled ? ".js" : ".ts")).replaceAll("\\", "/"));
 };
 
+// src/BackgroundService.ts
+var BackgroundService = class {
+  constructor(data) {
+    this.name = data.name;
+    this.main = async () => {
+      try {
+        await data.main();
+      } catch (error) {
+        fullLogNok("BACKGROUND-SERVICE", `${this.name.toUpperCase()}`, error);
+      }
+    };
+  }
+};
+
+// src/RouterWrapper.ts
+import { Router } from "express";
+
 // src/DynamicDbRouter.ts
 import { EntityMetadataNotFoundError, Equal, Like } from "typeorm";
 
@@ -50,7 +68,7 @@ var _DbConnector = class _DbConnector {
   constructor(projectConfig) {
     this.connect = async (entities, migrations, sync) => {
       try {
-        if (!this.projectConfig.DB_DIALECT || !this.projectConfig.DB_NAME) throw new Error("[DB-CONNECTOR]	Missing configs =>DB_DIALECT || DB_NAME");
+        if (!this.projectConfig.DB_DIALECT || !this.projectConfig.DB_NAME) throw new Error("[DB-CONNECTOR] Missing configs => DB_DIALECT || DB_NAME");
         const AppDataSource = new DataSource({
           type: this.projectConfig.DB_DIALECT,
           host: this.projectConfig.DB_HOST,
@@ -83,7 +101,7 @@ var _DbConnector = class _DbConnector {
         _DbConnector.DataSource = AppDataSource;
         log.magenta(`[DB-CONNECTOR] ORM CONNECTED`);
       } catch (err) {
-        log.logError(err);
+        fullLogNok("DB-CONNECTOR", err);
       }
     };
     this.projectConfig = projectConfig;
@@ -420,7 +438,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       });
       res.send(entities);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[GET]	${options.basePath}/ => ${err.message ?? err}`);
+      errorCatcher(res, err, void 0, `[GET] ${options.basePath}/ => ${err.message ?? err}`);
     }
   });
   if (!avoidList.includes("GET")) options.router.get("/:id", async (req, res) => {
@@ -438,7 +456,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       });
       res.send(singleEntity);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[GET]	${options.basePath}/:id => ${err.message ?? err}`);
+      errorCatcher(res, err, void 0, `[GET] ${options.basePath}/:id => ${err.message ?? err}`);
     }
   });
   if (!avoidList.includes("POST")) options.router.post("/", async (req, res) => {
@@ -466,7 +484,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       }
       res.send(result);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[POST]	${options.basePath}/ => ${err.message ?? err}`);
+      errorCatcher(res, err, void 0, `[POST] ${options.basePath}/ => ${err.message ?? err}`);
     }
   });
   if (!avoidList.includes("PUT")) options.router.put("/:id", async (req, res) => {
@@ -498,7 +516,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       }
       res.send(result);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[PUT]	${options.basePath}/:id => ${err.message ?? err}`);
+      errorCatcher(res, err, void 0, `[PUT] ${options.basePath}/:id => ${err.message ?? err}`);
     }
   });
   if (!avoidList.includes("DELETE")) options.router.delete("/:id", async (req, res) => {
@@ -519,7 +537,7 @@ _DynamicDbRouter.createDbRouter = (options) => {
       }
       res.send(singleEntity);
     } catch (err) {
-      errorCatcher(res, err, void 0, `[DELETE]	${options.basePath}/:id => ${err.message ?? err}`);
+      errorCatcher(res, err, void 0, `[DELETE] ${options.basePath}/:id => ${err.message ?? err}`);
     }
   });
   return options.router;
@@ -552,7 +570,7 @@ _DynamicDbRouter.addDbRouterSwagger = (options) => {
     }
   } catch (err) {
     if (err instanceof EntityMetadataNotFoundError)
-      log.error(`[${options.entity.name}]	Metadata required for db routing but not connected on the database`);
+      fullLogNok("DYNAMIC-DB-ROUTING", `[${options.entity.name}] Metadata required for db routing but not connected on the database`);
   }
   if (!avoidList.includes("LIST")) {
     const listOptions = { page: 0, pageSize: 10, order: "ASC", orderBy: options.primaryKey };
@@ -649,7 +667,7 @@ var RouterWrapper = class {
               } else if (typeof handlerRes.result === "object") res.status(handlerRes.status).json(handlerRes.result);
               else res.status(handlerRes.status).send(handlerRes.result);
             } catch (err) {
-              fullLogNok("api", `[${method}]	${this.data.basePath}${path3} => ${err.message ?? err}`);
+              fullLogNok("api", `[${method}] ${this.data.basePath}${path3} => ${err.message ?? err}`);
               res.status(500).send(err?.message ?? err);
             }
           };
@@ -689,10 +707,112 @@ var RouterWrapper = class {
   }
 };
 
+// src/SocketWrapper.ts
+var SocketWrapper = class {
+  constructor(data) {
+    this.connectedClients = /* @__PURE__ */ new Map();
+    this.setupConnection = (io) => {
+      try {
+        if (!this.data.listeners) throw new Error("No listeners provided");
+        this.namespace = io.of(`/${this.socket_namespace}`);
+        if (this.data.connectionMiddleware) {
+          io.use(async (client, next) => {
+            const commId = client.handshake.query.commId;
+            const metadata = client.handshake.query.metadata;
+            const beforeResult = await this.data.connectionMiddleware(this, client, commId, metadata);
+            if (!beforeResult.ok) {
+              const err = new Error(beforeResult.message);
+              return next(err);
+            }
+            if (beforeResult.newMetadata) client.handshake.query.metadata = beforeResult.newMetadata;
+            next();
+          });
+        }
+        io.on("connection", (client) => {
+          try {
+            if (!this.namespace) throw new Error("Socket.IO not initialized");
+            const metadata = client.handshake.query.metadata;
+            const finalClientId = this.data.clientConnectionKey ? metadata?.[this.data.clientConnectionKey] ?? client.id : client.id;
+            this.connectedClients.set(finalClientId, { socket: client, connectedAt: /* @__PURE__ */ new Date(), metadata });
+            log.cyan(`[SOCKETWRAPPER] [${this.socket_namespace.toUpperCase()}] Client ${client.id} connected`);
+            if (this.data.afterClientConnect) this.data.afterClientConnect(this, client, metadata);
+            for (const eventName in this.data.listeners) client.on(eventName, (...params) => this.data.listeners?.[eventName](this, client, metadata, ...params));
+            client.on("disconnect", () => this.handleDisconnection(client));
+          } catch (err) {
+            fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+          }
+        });
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    this.handleDisconnection = (client) => {
+      try {
+        if (!this.namespace) throw new Error("Socket.IO not initialized");
+        this.connectedClients.delete(client.id);
+        log.cyan(`[SOCKETWRAPPER] [${this.socket_namespace.toUpperCase()}] Client ${client.id} disconnected`);
+        if (this.data.onClientDisconnect) this.data.onClientDisconnect(client);
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    // --- SEND METHODS
+    this.broadcast = (eventName, data) => {
+      try {
+        if (!this.namespace) throw new Error("Socket.IO not initialized");
+        this.namespace.emit(eventName, data);
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    this.broadcastExceptClient = (clientId, eventName, data) => {
+      try {
+        for (const [id, client] of this.connectedClients.entries()) {
+          if (id !== clientId) client.socket.emit(eventName, data);
+        }
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    this.sendToClient = (clientId, eventName, data) => {
+      try {
+        const connectedClient = this.connectedClients.get(clientId);
+        if (!connectedClient) throw new Error(`Client ${clientId} not found`);
+        connectedClient.socket.emit(eventName, data);
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    this.sendToRoom = (room, eventName, data) => {
+      try {
+        if (!this.namespace) throw new Error("Socket.IO not initialized");
+        this.namespace.to(room).emit(eventName, data);
+      } catch (err) {
+        fullLogNok(`SOCKETWRAPPER`, `[${this.socket_namespace.toUpperCase()}]`, err);
+      }
+    };
+    // --- GETTERS
+    this.getConnectedSockets = () => Array.from(this.connectedClients.values());
+    this.getClientById = (clientId) => this.connectedClients.get(clientId);
+    this.getClientByMetadataKey = (key, value) => {
+      for (const client of this.connectedClients.values()) {
+        if (client.metadata && client.metadata[key] === value) return client;
+      }
+      return void 0;
+    };
+    this.socket_namespace = data.socket_namespace;
+    this.data = data;
+    Object.keys(data.listeners ?? {}).forEach((key) => {
+      this[key] = data.listeners?.[key].bind(this);
+    });
+  }
+};
+
 // src/Starter.ts
 import express from "express";
 import http from "http";
 import path2 from "path";
+import { Server } from "socket.io";
 import swaggerUi from "swagger-ui-express";
 var Starter = class {
   constructor(options) {
@@ -728,12 +848,15 @@ var Starter = class {
           res.sendFile(path2.join(clientPath, "index.html"));
         });
       }
-      if (options.socket === void 0 || options.socket === false) {
+      for (const service of options.backgroundServices ?? []) service.main();
+      if (options.sockets === void 0) {
         if (options.beforeStartListening) options.beforeStartListening(app);
         app.listen(options.projectConfig.SERVER_PORT, () => log.base("Server started.", `Listening on port ${options.projectConfig.SERVER_PORT}`));
-      } else if (options.socket === true) {
+      } else {
         const server = http.createServer(app);
-        if (options.beforeStartListening) options.beforeStartListening(app, server);
+        const socketIoServerInstance = new Server(server, options.sockets.options);
+        for (const socket of options.sockets.wrappers) socket.setupConnection(socketIoServerInstance);
+        if (options.beforeStartListening) options.beforeStartListening(app, server, socketIoServerInstance);
         server.listen(options.projectConfig.SERVER_PORT, () => log.base("Server started.", `Listening on port ${options.projectConfig.SERVER_PORT}`));
       }
     };
@@ -745,7 +868,7 @@ var Starter = class {
       log.setFilePath(options.projectConfig.ERROR_FILE_PATH);
       this.init(options);
     } catch (err) {
-      log.error(err);
+      fullLogNok("starter", err);
     }
   }
 };
@@ -758,6 +881,10 @@ var Token = class {
     this.keyStore = null;
     // Metodo per autorizzare una richiesta
     this.authorize = async (req) => {
+      if (typeof req === "string") {
+        const payload2 = await this.verifyJWE(req);
+        return payload2;
+      }
       const token = req.headers.authorization?.split("Bearer ")?.[1] ?? null;
       if (token === null) throw new Error("UNAUTH");
       const payload = await this.verifyJWE(token);
@@ -817,7 +944,9 @@ var Token = class {
   }
 };
 export {
+  BackgroundService,
   RouterWrapper,
+  SocketWrapper,
   Starter,
   Swagger,
   Token,
@@ -827,5 +956,7 @@ export {
   fullLogNok,
   fullLogOk,
   getCompiledPath,
-  log
+  log,
+  socketNok,
+  socketOk
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expresso-macchiato",
-  "version": "0.3.6",
+  "version": "0.3.8-dev",
   "author": "Alessio Velluso",
   "license": "MIT",
   "description": "Description",
@@ -33,11 +33,12 @@
     "dotenv": "^16.3.1",
     "express": "^4.18.2",
     "jsonwebtoken": "^9.0.2",
-    "swagger-jsdoc": "^6.2.8",
-    "swagger-ui-express": "^5.0.1",
     "multer": "^1.4.5-lts.1",
     "node-jose": "^2.2.0",
     "reflect-metadata": "^0.2.2",
+    "socket.io": "^4.8.1",
+    "swagger-jsdoc": "^6.2.8",
+    "swagger-ui-express": "^5.0.1",
     "utils-logger-av": "^4.0.0",
     "utils-stuff": "^4.5.0"
   },

package/types/service.sptypes.ts

@@ -0,0 +1,4 @@
+export type BackgroundServiceConstructor = {
+    name:string;
+    main: () => Promise<void>
+}

package/types/socket.sptypes.ts

@@ -0,0 +1,23 @@
+import { Socket } from "socket.io";
+import { SocketWrapper } from "../src";
+
+export type ConnectedSocketClient<Metadata = any> = {
+    socket: Socket;
+    connectedAt: Date;
+    metadata?: Metadata;
+}
+
+export type SocketConnectionNok = { ok:false, message:string }
+export type SocketConnectionOk<Metadata = any> = { ok:true, newMetadata?: Metadata }
+
+
+export type SocketConnectionMiddleware<Metadata extends Record<string, any> = any> = (self:SocketWrapper, client:Socket, commId?:string, metadata?:Metadata) => Promise<SocketConnectionOk<Metadata> | SocketConnectionNok>
+export type SocketWrapperConstructor<Metadata extends Record<string, any> = any> =
+{
+    socketNamespace:string,
+    clientConnectionKey?:string,
+    connectionMiddleware?:SocketConnectionMiddleware<Metadata>
+    afterClientConnect?: (self:SocketWrapper, client:Socket, metadata?:Metadata) => Promise<void>
+    onClientDisconnect?:(...params:any[]) => Promise<void>
+    listeners?:Record<string, (self:SocketWrapper, client:Socket, metadata:any, ...params:any[]) => Promise<void>>
+}

package/types/starter.sptypes.ts

@@ -1,7 +1,10 @@
 import { Express } from "express"
 import http from "http"
+import { Server, ServerOptions } from "socket.io"
 import { EntitySchema, MixedList } from "typeorm"
+import { BackgroundService } from "../src/BackgroundService"
 import { RouterWrapper } from "../src/RouterWrapper"
+import { SocketWrapper } from "../src/SocketWrapper"
 import { Token } from "../src/Token"
 import { ProjectConfigs } from "./generic.sptypes"
 import { TokenApiOptions } from "./token.sptypes"
@@ -12,8 +15,11 @@ export type StarterOptions = {
     clientPath?:string,
     swagger?:boolean,
     projectConfig:ProjectConfigs,
-    beforeStartListening?:(app:Express, server?:http.Server) => void,
-    socket?:boolean,
+    beforeStartListening?:(app:Express, httpServer?:http.Server, socketIoServerInstance?:Server) => void,
+    sockets?: {
+        wrappers:Array<SocketWrapper>,
+        options?:ServerOptions
+    },
     tokenOptions?: {
         tokenInstance: Token,
         api?:TokenApiOptions
@@ -24,13 +30,5 @@ export type StarterOptions = {
         sync?:boolean,
         afterDbConnection?:() => Promise<void>
     },
-}
-
-
-
-export type SocketWrapperConstructor = {
-    name:string,
-    beforeConnection?:() => Promise<void>
-    onDisconnect?:(...params:any[]) => Promise<void>
-    listeners?:Record<string, (...params:any[]) => Promise<void>>
+    backgroundServices?:Array<BackgroundService>
 }