@carlonicora/nestjs-neo4jsonapi 0.0.1

package/dist/core/tracing/tracing.setup.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tracingSetup = exports.TracingSetup = void 0;
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const instrumentation_http_1 = require("@opentelemetry/instrumentation-http");
+const instrumentation_nestjs_core_1 = require("@opentelemetry/instrumentation-nestjs-core");
+const resources_1 = require("@opentelemetry/resources");
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const base_config_1 = require("../../config/base.config");
+class TracingSetup {
+    constructor() {
+        this.isInitialized = false;
+    }
+    static getInstance() {
+        if (!TracingSetup.instance) {
+            TracingSetup.instance = new TracingSetup();
+        }
+        return TracingSetup.instance;
+    }
+    /**
+     * Initialize OpenTelemetry tracing.
+     * If no config is provided, uses baseConfig.tempo from environment variables.
+     */
+    initialize(config) {
+        if (this.isInitialized) {
+            return;
+        }
+        // Use provided config or fall back to baseConfig.tempo
+        const tempoConfig = config ?? base_config_1.baseConfig.tempo;
+        if (!tempoConfig?.enabled) {
+            return;
+        }
+        try {
+            const traceExporter = new exporter_trace_otlp_http_1.OTLPTraceExporter({
+                url: tempoConfig.endpoint,
+            });
+            const sdk = new sdk_node_1.NodeSDK({
+                resource: (0, resources_1.resourceFromAttributes)({
+                    [semantic_conventions_1.ATTR_SERVICE_NAME]: tempoConfig.serviceName,
+                    [semantic_conventions_1.ATTR_SERVICE_VERSION]: tempoConfig.serviceVersion,
+                }),
+                traceExporter,
+                instrumentations: [
+                    new instrumentation_http_1.HttpInstrumentation({
+                        requestHook: (span, request) => {
+                            // Add custom attributes to HTTP spans
+                            if (request && request.headers) {
+                                span.setAttributes({
+                                    "http.user_agent": request.headers["user-agent"] || "",
+                                    "http.forwarded_for": request.headers["x-forwarded-for"] || "",
+                                });
+                            }
+                        },
+                    }),
+                    new instrumentation_nestjs_core_1.NestInstrumentation(),
+                ],
+            });
+            sdk.start();
+            this.sdk = sdk;
+            this.isInitialized = true;
+            // Handle graceful shutdown
+            process.on("SIGTERM", () => {
+                this.shutdown();
+            });
+            process.on("SIGINT", () => {
+                this.shutdown();
+            });
+        }
+        catch (error) {
+            console.error("Failed to initialize tracing:", error);
+            throw error;
+        }
+    }
+    shutdown() {
+        if (this.sdk && this.isInitialized) {
+            this.sdk
+                .shutdown()
+                .then(() => {
+                this.isInitialized = false;
+            })
+                .catch((error) => {
+                console.error("Error shutting down tracing:", error);
+            });
+        }
+    }
+    isTracingInitialized() {
+        return this.isInitialized;
+    }
+}
+exports.TracingSetup = TracingSetup;
+// Export singleton instance
+exports.tracingSetup = TracingSetup.getInstance();
+//# sourceMappingURL=tracing.setup.js.map

package/dist/core/tracing/tracing.setup.js.map

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

package/dist/core/version/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./version.module";
+export * from "./services/version.service";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/version/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/version/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC"}

package/dist/core/version/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./version.module"), exports);
+__exportStar(require("./services/version.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/version/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/version/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,6DAA2C"}

package/dist/core/version/services/version.service.d.ts

@@ -0,0 +1,6 @@
+export declare class VersionService {
+    private readonly apiConfig;
+    getVersion(): string;
+    getApiUrl(): string;
+}
+//# sourceMappingURL=version.service.d.ts.map

package/dist/core/version/services/version.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.service.d.ts","sourceRoot":"","sources":["../../../../src/core/version/services/version.service.ts"],"names":[],"mappings":"AAGA,qBACa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C,UAAU,IAAI,MAAM;IAIpB,SAAS,IAAI,MAAM;CAGpB"}

package/dist/core/version/services/version.service.js

@@ -0,0 +1,27 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionService = void 0;
+const common_1 = require("@nestjs/common");
+const base_config_1 = require("../../../config/base.config");
+let VersionService = class VersionService {
+    constructor() {
+        this.apiConfig = base_config_1.baseConfig.api;
+    }
+    getVersion() {
+        return process.env.npm_package_version || "1.0.0";
+    }
+    getApiUrl() {
+        return this.apiConfig?.url || "http://localhost:3000";
+    }
+};
+exports.VersionService = VersionService;
+exports.VersionService = VersionService = __decorate([
+    (0, common_1.Injectable)()
+], VersionService);
+//# sourceMappingURL=version.service.js.map

package/dist/core/version/services/version.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.service.js","sourceRoot":"","sources":["../../../../src/core/version/services/version.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAC5C,6DAAyD;AAGlD,IAAM,cAAc,GAApB,MAAM,cAAc;IAApB;QACY,cAAS,GAAG,wBAAU,CAAC,GAAG,CAAC;IAS9C,CAAC;IAPC,UAAU;QACR,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;IACpD,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,uBAAuB,CAAC;IACxD,CAAC;CACF,CAAA;AAVY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;GACA,cAAc,CAU1B"}

package/dist/core/version/version.module.d.ts

@@ -0,0 +1,5 @@
+import { DynamicModule } from "@nestjs/common";
+export declare class VersionModule {
+    static forRoot(): DynamicModule;
+}
+//# sourceMappingURL=version.module.d.ts.map

package/dist/core/version/version.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.module.d.ts","sourceRoot":"","sources":["../../../src/core/version/version.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAGvD,qBACa,aAAa;IACxB,MAAM,CAAC,OAAO,IAAI,aAAa;CAQhC"}

package/dist/core/version/version.module.js

@@ -0,0 +1,27 @@
+"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 VersionModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionModule = void 0;
+const common_1 = require("@nestjs/common");
+const version_service_1 = require("./services/version.service");
+let VersionModule = VersionModule_1 = class VersionModule {
+    static forRoot() {
+        return {
+            module: VersionModule_1,
+            providers: [version_service_1.VersionService],
+            exports: [version_service_1.VersionService],
+            global: true,
+        };
+    }
+};
+exports.VersionModule = VersionModule;
+exports.VersionModule = VersionModule = VersionModule_1 = __decorate([
+    (0, common_1.Module)({})
+], VersionModule);
+//# sourceMappingURL=version.module.js.map

package/dist/core/version/version.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.module.js","sourceRoot":"","sources":["../../../src/core/version/version.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,gEAA4D;AAGrD,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACxB,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,SAAS,EAAE,CAAC,gCAAc,CAAC;YAC3B,OAAO,EAAE,CAAC,gCAAc,CAAC;YACzB,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AATY,sCAAa;wBAAb,aAAa;IADzB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,aAAa,CASzB"}

package/dist/core/websocket/gateways/event.gateway.d.ts

@@ -0,0 +1,41 @@
+import { OnModuleDestroy } from "@nestjs/common";
+import { EventEmitter2 } from "@nestjs/event-emitter";
+import { JwtService } from "@nestjs/jwt";
+import { OnGatewayConnection, OnGatewayDisconnect, OnGatewayInit } from "@nestjs/websockets";
+import { ClsService } from "nestjs-cls";
+import { Server, Socket } from "socket.io";
+import { AppLoggingService } from "../../logging/services/logging.service";
+import { Neo4jService } from "../../neo4j/services/neo4j.service";
+import { PresenceService } from "../services/presence.service";
+import { WebSocketService } from "../services/websocket.service";
+export declare class EventsGateway implements OnGatewayInit, OnGatewayConnection, OnGatewayDisconnect, OnModuleDestroy {
+    private readonly webSocketService;
+    private readonly jwtService;
+    private readonly cls;
+    private readonly neo4j;
+    private readonly logger;
+    private readonly presenceService;
+    private readonly eventEmitter;
+    server: Server;
+    private isShuttingDown;
+    constructor(webSocketService: WebSocketService, jwtService: JwtService, cls: ClsService, neo4j: Neo4jService, logger: AppLoggingService, presenceService: PresenceService, eventEmitter: EventEmitter2);
+    afterInit(): void;
+    handleConnection(client: Socket): Promise<void>;
+    handleDisconnect(client: Socket): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    handleHeartbeat(client: Socket): Promise<{
+        event: string;
+        data: {
+            status: string;
+        };
+    }>;
+    handleMessage(data: {
+        type: string;
+        message: any;
+    }, client: Socket): {
+        event: string;
+        data: any;
+    };
+    private extractTokenFromHandshake;
+}
+//# sourceMappingURL=event.gateway.d.ts.map

package/dist/core/websocket/gateways/event.gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.gateway.d.ts","sourceRoot":"","sources":["../../../../src/core/websocket/gateways/event.gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAmB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAGL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBASa,aAAc,YAAW,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe;IAO1G,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAX/B,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,cAAc,CAAS;gBAGZ,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,aAAa;IAG9C,SAAS;IAKH,gBAAgB,CAAC,MAAM,EAAE,MAAM;IA6B/B,gBAAgB,CAAC,MAAM,EAAE,MAAM;IA8B/B,eAAe;IAKf,eAAe,CAAoB,MAAM,EAAE,MAAM;;;;;;IASvD,aAAa,CACI,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,EAChC,MAAM,EAAE,MAAM,GAChC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE;IAQ/B,OAAO,CAAC,yBAAyB;CAelC"}

package/dist/core/websocket/gateways/event.gateway.js

@@ -0,0 +1,164 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsGateway = void 0;
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const jwt_1 = require("@nestjs/jwt");
+const websockets_1 = require("@nestjs/websockets");
+const nestjs_cls_1 = require("nestjs-cls");
+const socket_io_1 = require("socket.io");
+const logging_service_1 = require("../../logging/services/logging.service");
+const neo4j_service_1 = require("../../neo4j/services/neo4j.service");
+const presence_service_1 = require("../services/presence.service");
+const websocket_service_1 = require("../services/websocket.service");
+let EventsGateway = class EventsGateway {
+    constructor(webSocketService, jwtService, cls, neo4j, logger, presenceService, eventEmitter) {
+        this.webSocketService = webSocketService;
+        this.jwtService = jwtService;
+        this.cls = cls;
+        this.neo4j = neo4j;
+        this.logger = logger;
+        this.presenceService = presenceService;
+        this.eventEmitter = eventEmitter;
+        this.isShuttingDown = false;
+    }
+    afterInit() {
+        this.webSocketService.setServer(this.server);
+        this.logger.log("WebSocket server initialized");
+    }
+    async handleConnection(client) {
+        const token = this.extractTokenFromHandshake(client);
+        if (!token) {
+            client.data.user = { userId: null };
+            return;
+        }
+        else {
+            try {
+                const payload = this.jwtService.verify(token);
+                client.data.user = payload;
+                this.webSocketService.addClient(payload.userId, client);
+                // Set user as online
+                await this.presenceService.setUserOnline(payload.userId, payload.userName || payload.name, client.id);
+                // Broadcast presence change
+                const broadcastPayload = {
+                    userId: payload.userId,
+                    status: "online",
+                };
+                await this.webSocketService.broadcast("user:presence", broadcastPayload);
+            }
+            catch (err) {
+                this.logger.error(`[PRESENCE] JWT verification failed for client: ${client.id}, error: ${err.message}`);
+                client.data.user = { userId: null };
+            }
+        }
+    }
+    async handleDisconnect(client) {
+        // Skip Redis operations if shutting down
+        if (this.isShuttingDown) {
+            return;
+        }
+        const user = client.data.user;
+        if (user && user.userId) {
+            this.webSocketService.removeClient(user.userId, client);
+            // Set user offline and broadcast
+            try {
+                await this.presenceService.setUserOffline(user.userId, client.id);
+                const status = await this.presenceService.getUserStatus(user.userId);
+                if (status.status === "offline") {
+                    const broadcastPayload = {
+                        userId: user.userId,
+                        status: "offline",
+                        lastSeen: status.lastActivity,
+                    };
+                    await this.webSocketService.broadcast("user:presence", broadcastPayload);
+                }
+            }
+            catch (error) {
+                // Redis might be disconnected during shutdown
+                this.logger.error(`[PRESENCE] Error setting user offline: ${error.message}`);
+            }
+        }
+    }
+    async onModuleDestroy() {
+        this.isShuttingDown = true;
+    }
+    async handleHeartbeat(client) {
+        const user = client.data.user;
+        if (user && user.userId) {
+            await this.presenceService.updateActivity(user.userId);
+        }
+        return { event: "heartbeat", data: { status: "ok" } };
+    }
+    handleMessage(data, client) {
+        const user = client.data.user;
+        if (user && user.userId && user.companyId) {
+            this.webSocketService.handleIncomingMessage(user.companyId, user.userId, data);
+        }
+        return { event: "message", data: { status: "received" } };
+    }
+    extractTokenFromHandshake(client) {
+        const token = client.handshake.auth?.token;
+        if (token)
+            return token;
+        const queryToken = client.handshake.query.token;
+        const authHeader = client.handshake.headers.authorization;
+        if (queryToken) {
+            return queryToken;
+        }
+        else if (authHeader && authHeader.startsWith("Bearer ")) {
+            return authHeader.slice(7);
+        }
+        return null;
+    }
+};
+exports.EventsGateway = EventsGateway;
+__decorate([
+    (0, websockets_1.WebSocketServer)(),
+    __metadata("design:type", socket_io_1.Server)
+], EventsGateway.prototype, "server", void 0);
+__decorate([
+    (0, websockets_1.SubscribeMessage)("heartbeat"),
+    __param(0, (0, websockets_1.ConnectedSocket)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [socket_io_1.Socket]),
+    __metadata("design:returntype", Promise)
+], EventsGateway.prototype, "handleHeartbeat", null);
+__decorate([
+    (0, websockets_1.SubscribeMessage)("message"),
+    __param(0, (0, websockets_1.MessageBody)()),
+    __param(1, (0, websockets_1.ConnectedSocket)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, socket_io_1.Socket]),
+    __metadata("design:returntype", Object)
+], EventsGateway.prototype, "handleMessage", null);
+exports.EventsGateway = EventsGateway = __decorate([
+    (0, websockets_1.WebSocketGateway)({
+        path: "/socket.io",
+        cors: {
+            origin: "*",
+            credentials: true,
+        },
+        transports: ["websocket"],
+    }),
+    (0, common_1.UseInterceptors)(nestjs_cls_1.ClsInterceptor),
+    __metadata("design:paramtypes", [websocket_service_1.WebSocketService,
+        jwt_1.JwtService,
+        nestjs_cls_1.ClsService,
+        neo4j_service_1.Neo4jService,
+        logging_service_1.AppLoggingService,
+        presence_service_1.PresenceService,
+        event_emitter_1.EventEmitter2])
+], EventsGateway);
+//# sourceMappingURL=event.gateway.js.map

package/dist/core/websocket/gateways/event.gateway.js.map

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

package/dist/core/websocket/guards/ws.jwt.auth.guard.d.ts

@@ -0,0 +1,13 @@
+import { CanActivate, ExecutionContext } from "@nestjs/common";
+import { JwtService } from "@nestjs/jwt";
+import { ClsService } from "nestjs-cls";
+import { Neo4jService } from "../../neo4j/services/neo4j.service";
+export declare class WsJwtGuard implements CanActivate {
+    private readonly jwtService;
+    private readonly cls;
+    private readonly neo4j;
+    constructor(jwtService: JwtService, cls: ClsService, neo4j: Neo4jService);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+    private extractTokenFromHandshake;
+}
+//# sourceMappingURL=ws.jwt.auth.guard.d.ts.map

package/dist/core/websocket/guards/ws.jwt.auth.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.jwt.auth.guard.d.ts","sourceRoot":"","sources":["../../../../src/core/websocket/guards/ws.jwt.auth.guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAc,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,qBACa,UAAW,YAAW,WAAW;IAE1C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,YAAY;IAGhC,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9D,OAAO,CAAC,yBAAyB;CAiBlC"}

package/dist/core/websocket/guards/ws.jwt.auth.guard.js

@@ -0,0 +1,62 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WsJwtGuard = void 0;
+const common_1 = require("@nestjs/common");
+const jwt_1 = require("@nestjs/jwt");
+const nestjs_cls_1 = require("nestjs-cls");
+const neo4j_service_1 = require("../../neo4j/services/neo4j.service");
+let WsJwtGuard = class WsJwtGuard {
+    constructor(jwtService, cls, neo4j) {
+        this.jwtService = jwtService;
+        this.cls = cls;
+        this.neo4j = neo4j;
+    }
+    async canActivate(context) {
+        const client = context.switchToWs().getClient();
+        const token = this.extractTokenFromHandshake(client);
+        if (!token) {
+            return false;
+        }
+        try {
+            const payload = this.jwtService.verify(token);
+            client.data.user = payload;
+            return true;
+        }
+        catch (err) {
+            console.error(err);
+            return false;
+        }
+    }
+    extractTokenFromHandshake(client) {
+        const token = client.handshake.auth?.token;
+        if (token) {
+            return token;
+        }
+        const { token: queryToken } = client.handshake.query;
+        const authHeader = client.handshake.headers.authorization;
+        if (queryToken) {
+            return queryToken;
+        }
+        else if (authHeader && authHeader.startsWith("Bearer ")) {
+            return authHeader.slice(7);
+        }
+        return null;
+    }
+};
+exports.WsJwtGuard = WsJwtGuard;
+exports.WsJwtGuard = WsJwtGuard = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jwt_1.JwtService,
+        nestjs_cls_1.ClsService,
+        neo4j_service_1.Neo4jService])
+], WsJwtGuard);
+//# sourceMappingURL=ws.jwt.auth.guard.js.map

package/dist/core/websocket/guards/ws.jwt.auth.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.jwt.auth.guard.js","sourceRoot":"","sources":["../../../../src/core/websocket/guards/ws.jwt.auth.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA2E;AAC3E,qCAAyC;AACzC,2CAAwC;AAExC,sEAAkE;AAG3D,IAAM,UAAU,GAAhB,MAAM,UAAU;IACrB,YACmB,UAAsB,EACtB,GAAe,EACf,KAAmB;QAFnB,eAAU,GAAV,UAAU,CAAY;QACtB,QAAG,GAAH,GAAG,CAAY;QACf,UAAK,GAAL,KAAK,CAAc;IACnC,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,OAAyB;QACzC,MAAM,MAAM,GAAW,OAAO,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAErD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;YAE3B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,yBAAyB,CAAC,MAAc;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC;QAE3C,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAe,CAAC;QACzB,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QACrD,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC;QAE1D,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,UAAoB,CAAC;QAC9B,CAAC;aAAM,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1D,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA3CY,gCAAU;qBAAV,UAAU;IADtB,IAAA,mBAAU,GAAE;qCAGoB,gBAAU;QACjB,uBAAU;QACR,4BAAY;GAJ3B,UAAU,CA2CtB"}

package/dist/core/websocket/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./websocket.module";
+export * from "./services/websocket.service";
+export * from "./services/presence.service";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/websocket/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC"}

package/dist/core/websocket/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./websocket.module"), exports);
+__exportStar(require("./services/websocket.service"), exports);
+__exportStar(require("./services/presence.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/websocket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/websocket/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,+DAA6C;AAC7C,8DAA4C"}

package/dist/core/websocket/services/presence.service.d.ts

@@ -0,0 +1,59 @@
+import { RedisClientStorageService } from "../../redis/services/redis.client.storage.service";
+export interface PresenceStatus {
+    status: "online" | "away" | "offline";
+    lastActivity: Date;
+    socketIds: string[];
+    userName: string;
+}
+/**
+ * Presence Service
+ *
+ * Tracks user online/offline/away status using Redis
+ *
+ * Features:
+ * - Real-time presence tracking
+ * - Multi-device support (tracks multiple socket connections)
+ * - Automatic status calculation (online/away/offline)
+ * - TTL-based expiration
+ * - Batch status queries
+ */
+export declare class PresenceService {
+    private readonly redisClientStorage?;
+    private readonly PRESENCE_KEY_PREFIX;
+    private readonly PRESENCE_TTL;
+    private readonly ONLINE_THRESHOLD;
+    private readonly AWAY_THRESHOLD;
+    constructor(redisClientStorage?: RedisClientStorageService);
+    /**
+     * Set user as online when they connect
+     */
+    setUserOnline(userId: string, userName: string, socketId: string): Promise<void>;
+    /**
+     * Set user as offline when they disconnect
+     * Only sets to offline if no other sockets are connected
+     */
+    setUserOffline(userId: string, socketId: string): Promise<void>;
+    /**
+     * Update user activity timestamp (called on heartbeat)
+     */
+    updateActivity(userId: string): Promise<void>;
+    /**
+     * Get user's current status
+     */
+    getUserStatus(userId: string): Promise<PresenceStatus>;
+    /**
+     * Get statuses for multiple users
+     */
+    getUsersStatuses(userIds: string[]): Promise<Map<string, PresenceStatus>>;
+    /**
+     * Mark idle users as "away"
+     * Called by cron job every 5 minutes
+     * Returns array of user IDs whose status changed
+     */
+    markIdleUsersAsAway(): Promise<string[]>;
+    /**
+     * Helper to construct Redis key
+     */
+    private getPresenceKey;
+}
+//# sourceMappingURL=presence.service.d.ts.map

package/dist/core/websocket/services/presence.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.service.d.ts","sourceRoot":"","sources":["../../../../src/core/websocket/services/presence.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mDAAmD,CAAC;AAE9F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,YAAY,EAAE,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,qBACa,eAAe;IAMF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAL5D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAe;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;gBAER,kBAAkB,CAAC,EAAE,yBAAyB;IAEvF;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BtF;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCrE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnD;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqD5D;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAa/E;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA+D9C;;OAEG;IACH,OAAO,CAAC,cAAc;CAGvB"}