Skip to content

📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

Websocket based heartbeats

Blue Mouseaf55d01283e0
diff --git a/backend/apps/cloud/src/analytics/analytics.module.ts b/backend/apps/cloud/src/analytics/analytics.module.ts
index 910baf7e4..cc8e53eb6 100644
--- a/backend/apps/cloud/src/analytics/analytics.module.ts
+++ b/backend/apps/cloud/src/analytics/analytics.module.ts
@@ -3,6 +3,7 @@ import { TypeOrmModule } from '@nestjs/typeorm'
import { AnalyticsService } from './analytics.service'
import { AnalyticsController } from './analytics.controller'
+import { HeartbeatGateway } from './heartbeat.gateway'
import { SaltService } from './salt.service'
import { Salt } from './entities/salt.entity'
import { UserModule } from '../user/user.module'
@@ -16,7 +17,7 @@ import { ProjectModule } from '../project/project.module'
AppLoggerModule,
ProjectModule,
],
- providers: [AnalyticsService, SaltService],
+ providers: [AnalyticsService, SaltService, HeartbeatGateway],
exports: [AnalyticsService, SaltService],
controllers: [AnalyticsController],
})
diff --git a/backend/apps/cloud/src/analytics/heartbeat.gateway.ts b/backend/apps/cloud/src/analytics/heartbeat.gateway.ts
new file mode 100644
index 000000000..8e5f8ecbb
--- /dev/null
+++ b/backend/apps/cloud/src/analytics/heartbeat.gateway.ts
@@ -0,0 +1,196 @@
+import {
+ WebSocketGateway,
+ WebSocketServer,
+ OnGatewayConnection,
+ OnGatewayDisconnect,
+} from '@nestjs/websockets'
+import { Server, Socket } from 'socket.io'
+import _split from 'lodash/split'
+
+import { AnalyticsService } from './analytics.service'
+import { AppLoggerService } from '../logger/logger.service'
+import { isProxiedByCloudflare } from '../common/constants'
+
+// Heartbeat interval: update session every 60 seconds
+const HEARTBEAT_INTERVAL_MS = 60_000
+
+interface WsSession {
+ pid: string
+ psid: string
+ profileId: string
+ intervalRef: ReturnType<typeof setInterval>
+}
+
+@WebSocketGateway({
+ namespace: '/hb',
+ cors: {
+ origin: '*',
+ },
+})
+export class HeartbeatGateway
+ implements OnGatewayConnection, OnGatewayDisconnect
+{
+ @WebSocketServer()
+ server: Server
+
+ private sessions = new Map<string, WsSession>()
+
+ constructor(
+ private readonly analyticsService: AnalyticsService,
+ private readonly logger: AppLoggerService,
+ ) {}
+
+ async handleConnection(client: Socket) {
+ try {
+ const { pid, profileId: clientProfileId } = client.handshake.query as {
+ pid?: string
+ profileId?: string
+ }
+ const userAgent = client.handshake.headers['user-agent'] || ''
+ const origin = client.handshake.headers['origin'] as string
+
+ // Extract IP from handshake
+ const ip = this.getIPFromSocket(client)
+
+ if (!pid) {
+ this.logger.warn(
+ `[WS HB] Connection rejected: missing pid`,
+ 'HeartbeatGateway',
+ )
+ client.disconnect()
+ return
+ }
+
+ // Check if bot
+ const isBot = await this.analyticsService.isBot(pid, userAgent)
+ if (isBot) {
+ client.disconnect()
+ return
+ }
+
+ // Validate the heartbeat request (checks project active, origin, IP blacklist, account suspension)
+ try {
+ await this.analyticsService.validateHeartbeat({ pid }, origin, ip)
+ } catch (error) {
+ this.logger.warn(
+ `[WS HB] Connection rejected for pid ${pid}: ${error.message}`,
+ 'HeartbeatGateway',
+ )
+ client.disconnect()
+ return
+ }
+
+ // Get or validate existing session
+ const { exists, psid } = await this.analyticsService.getSessionId(
+ pid,
+ userAgent,
+ ip,
+ )
+
+ if (!exists) {
+ this.logger.warn(
+ `[WS HB] Connection rejected: no session exists for pid ${pid}`,
+ 'HeartbeatGateway',
+ )
+ client.emit('error', {
+ message:
+ 'No session exists. Please send a pageview or custom event first.',
+ })
+ client.disconnect()
+ return
+ }
+
+ // Generate profile ID
+ const profileId = await this.analyticsService.generateProfileId(
+ pid,
+ userAgent,
+ ip,
+ clientProfileId,
+ )
+
+ // Initial heartbeat
+ await this.analyticsService.extendSessionTTL(psid)
+ await this.analyticsService.recordSessionActivity(psid, pid, profileId)
+
+ // Set up interval for periodic heartbeat
+ const intervalRef = setInterval(async () => {
+ try {
+ await this.analyticsService.extendSessionTTL(psid)
+ await this.analyticsService.recordSessionActivity(
+ psid,
+ pid,
+ profileId,
+ )
+ } catch (error) {
+ this.logger.error(
+ `[WS HB] Heartbeat interval error for pid ${pid}: ${error.message}`,
+ error.stack,
+ 'HeartbeatGateway',
+ )
+ }
+ }, HEARTBEAT_INTERVAL_MS)
+
+ // Store session data
+ this.sessions.set(client.id, {
+ pid,
+ psid,
+ profileId,
+ intervalRef,
+ })
+
+ client.emit('connected', { message: 'Heartbeat session established' })
+ } catch (error) {
+ this.logger.error(
+ `[WS HB] Connection error: ${error.message}`,
+ error.stack,
+ 'HeartbeatGateway',
+ )
+ client.disconnect()
+ }
+ }
+
+ async handleDisconnect(client: Socket) {
+ const session = this.sessions.get(client.id)
+
+ if (session) {
+ // Clear the interval
+ clearInterval(session.intervalRef)
+
+ // Final session activity update
+ try {
+ await this.analyticsService.recordSessionActivity(
+ session.psid,
+ session.pid,
+ session.profileId,
+ )
+ } catch (error) {
+ this.logger.error(
+ `[WS HB] Disconnect error for pid ${session.pid}: ${error.message}`,
+ error.stack,
+ 'HeartbeatGateway',
+ )
+ }
+
+ // Remove from sessions map
+ this.sessions.delete(client.id)
+ }
+ }
+
+ private getIPFromSocket(client: Socket): string {
+ const headers = client.handshake.headers
+
+ if (isProxiedByCloudflare && headers['cf-connecting-ip']) {
+ const cfIP = headers['cf-connecting-ip']
+ return Array.isArray(cfIP) ? cfIP[0] : cfIP
+ }
+
+ const ip = headers['x-forwarded-for'] || null
+
+ if (!ip) {
+ return client.handshake.address || ''
+ }
+
+ const ipStr = Array.isArray(ip) ? ip[0] : ip
+ return _split(ipStr, ',')[0]
+ }
+}
diff --git a/backend/apps/community/src/analytics/analytics.module.ts b/backend/apps/community/src/analytics/analytics.module.ts
index f0dffb899..f9de1a0ff 100644
--- a/backend/apps/community/src/analytics/analytics.module.ts
+++ b/backend/apps/community/src/analytics/analytics.module.ts
@@ -3,6 +3,7 @@ import { TypeOrmModule } from '@nestjs/typeorm'
import { AnalyticsService } from './analytics.service'
import { AnalyticsController } from './analytics.controller'
+import { HeartbeatGateway } from './heartbeat.gateway'
import { SaltService } from './salt.service'
import { Salt } from './entities/salt.entity'
import { AppLoggerModule } from '../logger/logger.module'
@@ -10,7 +11,7 @@ import { ProjectModule } from '../project/project.module'
@Module({
imports: [TypeOrmModule.forFeature([Salt]), AppLoggerModule, ProjectModule],
- providers: [AnalyticsService, SaltService],
+ providers: [AnalyticsService, SaltService, HeartbeatGateway],
exports: [AnalyticsService, SaltService],
controllers: [AnalyticsController],
})
diff --git a/backend/apps/community/src/analytics/heartbeat.gateway.ts b/backend/apps/community/src/analytics/heartbeat.gateway.ts
new file mode 100644
index 000000000..775e67876
--- /dev/null
+++ b/backend/apps/community/src/analytics/heartbeat.gateway.ts
@@ -0,0 +1,203 @@
+import {
+ WebSocketGateway,
+ WebSocketServer,
+ OnGatewayConnection,
+ OnGatewayDisconnect,
+} from '@nestjs/websockets'
+import { Server, Socket } from 'socket.io'
+import _split from 'lodash/split'
+
+import { AnalyticsService } from './analytics.service'
+import { AppLoggerService } from '../logger/logger.service'
+import { isProxiedByCloudflare } from '../common/constants'
+
+// Heartbeat interval: update session every 60 seconds
+const HEARTBEAT_INTERVAL_MS = 60_000
+
+interface WsSession {
+ pid: string
+ psid: string
+ profileId: string
+ intervalRef: ReturnType<typeof setInterval>
+}
+
+@WebSocketGateway({
+ namespace: '/hb',
+ cors: {
+ origin: '*',
+ },
+})
+export class HeartbeatGateway
+ implements OnGatewayConnection, OnGatewayDisconnect
+{
+ @WebSocketServer()
+ server: Server
+
+ private sessions = new Map<string, WsSession>()
+
+ constructor(
+ private readonly analyticsService: AnalyticsService,
+ private readonly logger: AppLoggerService,
+ ) {}
+
+ async handleConnection(client: Socket) {
+ try {
+ const { pid, profileId: clientProfileId } = client.handshake.query as {
+ pid?: string
+ profileId?: string
+ }
+ const userAgent = client.handshake.headers['user-agent'] || ''
+ const origin = client.handshake.headers['origin'] as string
+
+ // Extract IP from handshake
+ const ip = this.getIPFromSocket(client)
+
+ if (!pid) {
+ this.logger.warn(
+ `[WS HB] Connection rejected: missing pid`,
+ 'HeartbeatGateway',
+ )
+ client.disconnect()
+ return
+ }
+
+ // Check if bot
+ const isBot = await this.analyticsService.isBot(pid, userAgent)
+ if (isBot) {
+ client.disconnect()
+ return
+ }
+
+ // Validate the heartbeat request (checks project active, origin, IP blacklist)
+ try {
+ await this.analyticsService.validateHeartbeat({ pid }, origin, ip)
+ } catch (error) {
+ this.logger.warn(
+ `[WS HB] Connection rejected for pid ${pid}: ${error.message}`,
+ 'HeartbeatGateway',
+ )
+ client.disconnect()
+ return
+ }
+
+ // Get or validate existing session
+ const { exists, psid } = await this.analyticsService.getSessionId(
+ pid,
+ userAgent,
+ ip,
+ )
+
+ if (!exists) {
+ this.logger.warn(
+ `[WS HB] Connection rejected: no session exists for pid ${pid}`,
+ 'HeartbeatGateway',
+ )
+ client.emit('error', {
+ message:
+ 'No session exists. Please send a pageview or custom event first.',
+ })
+ client.disconnect()
+ return
+ }
+
+ // Generate profile ID
+ const profileId = await this.analyticsService.generateProfileId(
+ pid,
+ userAgent,
+ ip,
+ clientProfileId,
+ )
+
+ // Initial heartbeat
+ await this.analyticsService.extendSessionTTL(psid)
+ await this.analyticsService.recordSessionActivity(psid, pid, profileId)
+
+ // Set up interval for periodic heartbeat
+ const intervalRef = setInterval(async () => {
+ try {
+ await this.analyticsService.extendSessionTTL(psid)
+ await this.analyticsService.recordSessionActivity(
+ psid,
+ pid,
+ profileId,
+ )
+ } catch (error) {
+ this.logger.error(
+ `[WS HB] Heartbeat interval error for pid ${pid}: ${error.message}`,
+ error.stack,
+ 'HeartbeatGateway',
+ )
+ }
+ }, HEARTBEAT_INTERVAL_MS)
+
+ // Store session data
+ this.sessions.set(client.id, {
+ pid,
+ psid,
+ profileId,
+ intervalRef,
+ })
+
+ client.emit('connected', { message: 'Heartbeat session established' })
+ } catch (error) {
+ this.logger.error(
+ `[WS HB] Connection error: ${error.message}`,
+ error.stack,
+ 'HeartbeatGateway',
+ )
+ client.disconnect()
+ }
+ }
+
+ async handleDisconnect(client: Socket) {
+ const session = this.sessions.get(client.id)
+
+ if (session) {
+ // Clear the interval
+ clearInterval(session.intervalRef)
+
+ // Final session activity update
+ try {
+ await this.analyticsService.recordSessionActivity(
+ session.psid,
+ session.pid,
+ session.profileId,
+ )
+ } catch (error) {
+ this.logger.error(
+ `[WS HB] Disconnect error for pid ${session.pid}: ${error.message}`,
+ error.stack,
+ 'HeartbeatGateway',
+ )
+ }
+
+ // Remove from sessions map
+ this.sessions.delete(client.id)
+ }
+ }
+
+ private getIPFromSocket(client: Socket): string {
+ const headers = client.handshake.headers
+
+ if (isProxiedByCloudflare && headers['cf-connecting-ip']) {
+ const cfIP = headers['cf-connecting-ip']
+ return Array.isArray(cfIP) ? cfIP[0] : cfIP
+ }
+
+ // Get IP based on the NGINX configuration
+ let ip = headers['x-real-ip']
+
+ if (ip) {
+ return Array.isArray(ip) ? ip[0] : ip
+ }
+
+ ip = headers['x-forwarded-for'] || null
+
+ if (!ip) {
+ return client.handshake.address || ''
+ }
+
+ const ipStr = Array.isArray(ip) ? ip[0] : ip
+ return _split(ipStr, ',')[0]
+ }
+}
diff --git a/backend/package-lock.json b/backend/package-lock.json
index 51aa7e8b0..f43cb4b74 100644
--- a/backend/package-lock.json
+++ b/backend/package-lock.json
@@ -19,10 +19,12 @@
"@nestjs/microservices": "^11.1.9",
"@nestjs/passport": "^11.0.5",
"@nestjs/platform-express": "^11.1.9",
+ "@nestjs/platform-socket.io": "^11.1.9",
"@nestjs/schedule": "^6.0.1",
"@nestjs/swagger": "^11.2.3",
"@nestjs/terminus": "^11.0.0",
"@nestjs/typeorm": "^11.0.0",
+ "@nestjs/websockets": "^11.1.9",
"@paypal/payouts-sdk": "^1.1.1",
"@sentry/cli": "^2.58.2",
"@sentry/nestjs": "^10.27.0",
@@ -2601,6 +2603,25 @@
"@nestjs/core": "^11.0.0"
}
},
+ "node_modules/@nestjs/platform-socket.io": {
+ "version": "11.1.9",
+ "resolved": "https://registry.npmjs.org/@nestjs/platform-socket.io/-/platform-socket.io-11.1.9.tgz",
+ "integrity": "sha512-OaAW+voXo5BXbFKd9Ot3SL05tEucRMhZRdw5wdWZf/RpIl9hB6G6OHr8DDxNbUGvuQWzNnZHCDHx3EQJzjcIyA==",
+ "license": "MIT",
+ "dependencies": {
+ "socket.io": "4.8.1",
+ "tslib": "2.8.1"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/nest"
+ },
+ "peerDependencies": {
+ "@nestjs/common": "^11.0.0",
+ "@nestjs/websockets": "^11.0.0",
+ "rxjs": "^7.1.0"
+ }
+ },
"node_modules/@nestjs/schedule": {
"version": "6.0.1",
"resolved": "https://registry.npmjs.org/@nestjs/schedule/-/schedule-6.0.1.tgz",
@@ -2747,6 +2768,29 @@
"typeorm": "^0.3.0"
}
},
+ "node_modules/@nestjs/websockets": {
+ "version": "11.1.9",
+ "resolved": "https://registry.npmjs.org/@nestjs/websockets/-/websockets-11.1.9.tgz",
+ "integrity": "sha512-kkkdeTVcc3X7ZzvVqUVpOAJoh49kTRUjWNUXo5jmG+27OvZoHfs/vuSiqxidrrbIgydSqN15HUsf1wZwQUrxCQ==",
+ "license": "MIT",
+ "dependencies": {
+ "iterare": "1.2.1",
+ "object-hash": "3.0.0",
+ "tslib": "2.8.1"
+ },
+ "peerDependencies": {
+ "@nestjs/common": "^11.0.0",
+ "@nestjs/core": "^11.0.0",
+ "@nestjs/platform-socket.io": "^11.0.0",
+ "reflect-metadata": "^0.1.12 || ^0.2.0",
+ "rxjs": "^7.1.0"
+ },
+ "peerDependenciesMeta": {
+ "@nestjs/platform-socket.io": {
+ "optional": true
+ }
+ }
+ },
"node_modules/@nodelib/fs.scandir": {
"version": "2.1.5",
"resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
@@ -4683,6 +4727,12 @@
"node": ">=18.0.0"
}
},
+ "node_modules/@socket.io/component-emitter": {
+ "version": "3.1.2",
+ "resolved": "https://registry.npmjs.org/@socket.io/component-emitter/-/component-emitter-3.1.2.tgz",
+ "integrity": "sha512-9BCxFwvbGg/RsZK9tjXd8s4UcwR0MWeFQ1XEKIQVVvAGJyINdrqKMcTRyLoK8Rse1GjzLV9cwjWV1olXRWEXVA==",
+ "license": "MIT"
+ },
"node_modules/@sqltools/formatter": {
"version": "1.2.5",
"resolved": "https://registry.npmjs.org/@sqltools/formatter/-/formatter-1.2.5.tgz",
@@ -4825,6 +4875,15 @@
"@types/express": "*"
}
},
+ "node_modules/@types/cors": {
+ "version": "2.8.19",
+ "resolved": "https://registry.npmjs.org/@types/cors/-/cors-2.8.19.tgz",
+ "integrity": "sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/node": "*"
+ }
+ },
"node_modules/@types/diff-match-patch": {
"version": "1.0.36",
"resolved": "https://registry.npmjs.org/@types/diff-match-patch/-/diff-match-patch-1.0.36.tgz",
@@ -6157,6 +6216,15 @@
],
"license": "MIT"
},
+ "node_modules/base64id": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/base64id/-/base64id-2.0.0.tgz",
+ "integrity": "sha512-lGe34o6EHj9y3Kts9R4ZYs/Gr+6N7MCaMlIFA3F1R2O5/m7K06AxfSeO5530PEERE6/WyEg3lsuyw4GHlPZHog==",
+ "license": "MIT",
+ "engines": {
+ "node": "^4.5.0 || >= 5.9"
+ }
+ },
"node_modules/baseline-browser-mapping": {
"version": "2.8.32",
"resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.32.tgz",
@@ -7641,6 +7709,95 @@
"once": "^1.4.0"
}
},
+ "node_modules/engine.io": {
+ "version": "6.6.4",
+ "resolved": "https://registry.npmjs.org/engine.io/-/engine.io-6.6.4.tgz",
+ "integrity": "sha512-ZCkIjSYNDyGn0R6ewHDtXgns/Zre/NT6Agvq1/WobF7JXgFff4SeDroKiCO3fNJreU9YG429Sc81o4w5ok/W5g==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/cors": "^2.8.12",
+ "@types/node": ">=10.0.0",
+ "accepts": "~1.3.4",
+ "base64id": "2.0.0",
+ "cookie": "~0.7.2",
+ "cors": "~2.8.5",
+ "debug": "~4.3.1",
+ "engine.io-parser": "~5.2.1",
+ "ws": "~8.17.1"
+ },
+ "engines": {
+ "node": ">=10.2.0"
+ }
+ },
+ "node_modules/engine.io-parser": {
+ "version": "5.2.3",
+ "resolved": "https://registry.npmjs.org/engine.io-parser/-/engine.io-parser-5.2.3.tgz",
+ "integrity": "sha512-HqD3yTBfnBxIrbnM1DoD6Pcq8NECnh8d4As1Qgh0z5Gg3jRRIqijury0CL3ghu/edArpUYiYqQiDUQBIs4np3Q==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=10.0.0"
+ }
+ },
+ "node_modules/engine.io/node_modules/accepts": {
+ "version": "1.3.8",
+ "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
+ "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
+ "license": "MIT",
+ "dependencies": {
+ "mime-types": "~2.1.34",
+ "negotiator": "0.6.3"
+ },
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/engine.io/node_modules/debug": {
+ "version": "4.3.7",
+ "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.7.tgz",
+ "integrity": "sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ==",
+ "license": "MIT",
+ "dependencies": {
+ "ms": "^2.1.3"
+ },
+ "engines": {
+ "node": ">=6.0"
+ },
+ "peerDependenciesMeta": {
+ "supports-color": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/engine.io/node_modules/negotiator": {
+ "version": "0.6.3",
+ "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
+ "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/engine.io/node_modules/ws": {
+ "version": "8.17.1",
+ "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
+ "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=10.0.0"
+ },
+ "peerDependencies": {
+ "bufferutil": "^4.0.1",
+ "utf-8-validate": ">=5.0.2"
+ },
+ "peerDependenciesMeta": {
+ "bufferutil": {
+ "optional": true
+ },
+ "utf-8-validate": {
+ "optional": true
+ }
+ }
+ },
"node_modules/enhanced-resolve": {
"version": "5.18.1",
"resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.1.tgz",
@@ -12156,6 +12313,15 @@
"node": ">=0.10.0"
}
},
+ "node_modules/object-hash": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz",
+ "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 6"
+ }
+ },
"node_modules/object-inspect": {
"version": "1.13.4",
"resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
@@ -14122,6 +14288,141 @@
"lru-cache": "^7.14.1"
}
},
+ "node_modules/socket.io": {
+ "version": "4.8.1",
+ "resolved": "https://registry.npmjs.org/socket.io/-/socket.io-4.8.1.tgz",
+ "integrity": "sha512-oZ7iUCxph8WYRHHcjBEc9unw3adt5CmSNlppj/5Q4k2RIrhl8Z5yY2Xr4j9zj0+wzVZ0bxmYoGSzKJnRl6A4yg==",
+ "license": "MIT",
+ "dependencies": {
+ "accepts": "~1.3.4",
+ "base64id": "~2.0.0",
+ "cors": "~2.8.5",
+ "debug": "~4.3.2",
+ "engine.io": "~6.6.0",
+ "socket.io-adapter": "~2.5.2",
+ "socket.io-parser": "~4.2.4"
+ },
+ "engines": {
+ "node": ">=10.2.0"
+ }
+ },
+ "node_modules/socket.io-adapter": {
+ "version": "2.5.5",
+ "resolved": "https://registry.npmjs.org/socket.io-adapter/-/socket.io-adapter-2.5.5.tgz",
+ "integrity": "sha512-eLDQas5dzPgOWCk9GuuJC2lBqItuhKI4uxGgo9aIV7MYbk2h9Q6uULEh8WBzThoI7l+qU9Ast9fVUmkqPP9wYg==",
+ "license": "MIT",
+ "dependencies": {
+ "debug": "~4.3.4",
+ "ws": "~8.17.1"
+ }
+ },
+ "node_modules/socket.io-adapter/node_modules/debug": {
+ "version": "4.3.7",
+ "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.7.tgz",
+ "integrity": "sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ==",
+ "license": "MIT",
+ "dependencies": {
+ "ms": "^2.1.3"
+ },
+ "engines": {
+ "node": ">=6.0"
+ },
+ "peerDependenciesMeta": {
+ "supports-color": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/socket.io-adapter/node_modules/ws": {
+ "version": "8.17.1",
+ "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
+ "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=10.0.0"
+ },
+ "peerDependencies": {
+ "bufferutil": "^4.0.1",
+ "utf-8-validate": ">=5.0.2"
+ },
+ "peerDependenciesMeta": {
+ "bufferutil": {
+ "optional": true
+ },
+ "utf-8-validate": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/socket.io-parser": {
+ "version": "4.2.4",
+ "resolved": "https://registry.npmjs.org/socket.io-parser/-/socket.io-parser-4.2.4.tgz",
+ "integrity": "sha512-/GbIKmo8ioc+NIWIhwdecY0ge+qVBSMdgxGygevmdHj24bsfgtCmcUUcQ5ZzcylGFHsN3k4HB4Cgkl96KVnuew==",
+ "license": "MIT",
+ "dependencies": {
+ "@socket.io/component-emitter": "~3.1.0",
+ "debug": "~4.3.1"
+ },
+ "engines": {
+ "node": ">=10.0.0"
+ }
+ },
+ "node_modules/socket.io-parser/node_modules/debug": {
+ "version": "4.3.7",
+ "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.7.tgz",
+ "integrity": "sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ==",
+ "license": "MIT",
+ "dependencies": {
+ "ms": "^2.1.3"
+ },
+ "engines": {
+ "node": ">=6.0"
+ },
+ "peerDependenciesMeta": {
+ "supports-color": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/socket.io/node_modules/accepts": {
+ "version": "1.3.8",
+ "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
+ "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
+ "license": "MIT",
+ "dependencies": {
+ "mime-types": "~2.1.34",
+ "negotiator": "0.6.3"
+ },
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/socket.io/node_modules/debug": {
+ "version": "4.3.7",
+ "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.7.tgz",
+ "integrity": "sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ==",
+ "license": "MIT",
+ "dependencies": {
+ "ms": "^2.1.3"
+ },
+ "engines": {
+ "node": ">=6.0"
+ },
+ "peerDependenciesMeta": {
+ "supports-color": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/socket.io/node_modules/negotiator": {
+ "version": "0.6.3",
+ "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
+ "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
"node_modules/socks": {
"version": "2.8.7",
"resolved": "https://registry.npmjs.org/socks/-/socks-2.8.7.tgz",
diff --git a/backend/package.json b/backend/package.json
index 26a1dfc2b..4b1f14019 100644
--- a/backend/package.json
+++ b/backend/package.json
@@ -39,10 +39,12 @@
"@nestjs/microservices": "^11.1.9",
"@nestjs/passport": "^11.0.5",
"@nestjs/platform-express": "^11.1.9",
+ "@nestjs/platform-socket.io": "^11.1.9",
"@nestjs/schedule": "^6.0.1",
"@nestjs/swagger": "^11.2.3",
"@nestjs/terminus": "^11.0.0",
"@nestjs/typeorm": "^11.0.0",
+ "@nestjs/websockets": "^11.1.9",
"@paypal/payouts-sdk": "^1.1.1",
"@sentry/cli": "^2.58.2",
"@sentry/nestjs": "^10.27.0",