@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/requests/service/serverless-services-handler.backend.service.d.ts

@@ -0,0 +1,9 @@
+import { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+export declare class ServerlessServicesHandlerBackendService {
+    private readonly logger;
+    private readonly errorBuilder;
+    private readonly logDebug;
+    constructor(logger: LoggerService, errorBuilder: ErrorBuilderBackendService);
+}
+//# sourceMappingURL=serverless-services-handler.backend.service.d.ts.map

package/dist/esm/requests/service/serverless-services-handler.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverless-services-handler.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/requests/service/serverless-services-handler.backend.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAE9G,qBACa,uCAAuC;IAIb,OAAO,CAAC,QAAQ,CAAC,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ/E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+D;gBAGlC,MAAM,EAAE,aAAa,EACR,YAAY,EAAE,0BAA0B;CAK5G"}

package/dist/esm/requests/service/serverless-services-handler.backend.service.js

@@ -0,0 +1,36 @@
+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); }
+};
+import { injectable, inject } from 'inversify';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+let ServerlessServicesHandlerBackendService = class ServerlessServicesHandlerBackendService {
+    logger;
+    errorBuilder;
+    logDebug;
+    constructor(logger, errorBuilder) {
+        this.logger = logger;
+        this.errorBuilder = errorBuilder;
+        this.logDebug = this.logger.debugByType('ServerlessServicesHandler');
+        this.logger.setDebugTypeLogging('ServerlessServicesHandler', false);
+    }
+};
+ServerlessServicesHandlerBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.ErrorBuilderService)),
+    __metadata("design:paramtypes", [LoggerService,
+        ErrorBuilderBackendService])
+], ServerlessServicesHandlerBackendService);
+export { ServerlessServicesHandlerBackendService };
+//# sourceMappingURL=serverless-services-handler.backend.service.js.map

package/dist/esm/requests/service/serverless-services-handler.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverless-services-handler.backend.service.js","sourceRoot":"","sources":["../../../../src/requests/service/serverless-services-handler.backend.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAGvG,IAAM,uCAAuC,GAA7C,MAAM,uCAAuC;IAII;IACa;IAJlD,QAAQ,CAA+D;IAExF,YACsD,MAAqB,EACR,YAAwC;QADrD,WAAM,GAAN,MAAM,CAAe;QACR,iBAAY,GAAZ,YAAY,CAA4B;QAEzG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;CACF,CAAA;AAVY,uCAAuC;IADnD,UAAU,EAAE;IAKR,WAAA,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACjC,WAAA,MAAM,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAA;qCADa,aAAa;QACM,0BAA0B;GALhG,uCAAuC,CAUnD"}

package/dist/esm/requests/service/websocket.service.d.ts

@@ -0,0 +1,507 @@
+import { Container } from 'inversify';
+import { Server as HttpServer } from 'http';
+import { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { AppConfigurationService } from '../../config/services/app-configuration.backend.service.js';
+import { RedisService } from '../../databases/services/redis.service.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import { DataMode } from '@wildo-ai/saas-models';
+import { ExecutionContextCreatorBackendService } from '../../runtime/services/execution-context-creator.backend.service.js';
+import { AuthorizationsBackendService } from '../../security/authorizations/services/authorizations.backend.service.js';
+import { ResourcesRegistryBackendService } from '../../resources/services/resources-registry.backend.service.js';
+import { WS_ResourceUpdatedPayload, WS_ResourceDeletedPayload, WS_ResourceRoomStatePayload, WS_ResourceUpdateNotificationPayload, NotificationLevel, NotificationDisplayTarget, ResourceAction } from '@wildo-ai/saas-models';
+export interface WebSocketConfig {
+    cors: {
+        origin: string | string[];
+        credentials: boolean;
+    };
+    transports: ('websocket' | 'polling')[];
+    pingTimeout: number;
+    pingInterval: number;
+    maxHttpBufferSize: number;
+    allowEIO3: boolean;
+}
+type WebSocketResourceRoomEmitPayload = WS_ResourceUpdatedPayload | WS_ResourceDeletedPayload | WS_ResourceRoomStatePayload;
+export interface WebSocketMessage {
+    type: string;
+    payload: any;
+    timestamp: Date;
+    userId?: string;
+    organizationId?: string;
+    targetUsers?: string[];
+    targetRoles?: string[];
+}
+export interface RoomInfo {
+    name: string;
+    organizationId: string;
+    type: 'organization' | 'user' | 'role' | 'custom' | 'resource';
+    members: Set<string>;
+    metadata?: Record<string, any>;
+}
+/**
+ * Rate limiting configuration (Redis-synchronized)
+ */
+export interface RateLimitConfig {
+    /** Maximum events per window */
+    maxEvents: number;
+    /** Window size in seconds */
+    windowSeconds: number;
+}
+/**
+ * WebSocket Service
+ *
+ * Provides real-time communication for SaaS applications:
+ * - Multi-tenant socket management with identity-based rooms
+ * - Resource-centric rooms for collaboration (editing, locking, custom events)
+ * - Role-based message broadcasting
+ * - Redis adapter for horizontal scaling
+ * - JWT authentication reusing ExecutionContextCreatorBackendService
+ * - Authorization reusing AuthorizationsBackendService
+ */
+export declare class WebSocketService {
+    private logger;
+    private configService;
+    private errorBuilder;
+    private redisService;
+    private executionContextCreator;
+    private authorizationsService;
+    private resourcesRegistry;
+    private container;
+    private io;
+    private userSockets;
+    private rooms;
+    private organizationSockets;
+    private authenticatedSockets;
+    private resourceEditingState;
+    private resourceSubscriptionsBySocket;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    constructor(logger: LoggerService, configService: AppConfigurationService, errorBuilder: ErrorBuilderBackendService, redisService: RedisService, executionContextCreator: ExecutionContextCreatorBackendService, authorizationsService: AuthorizationsBackendService, resourcesRegistry: ResourcesRegistryBackendService, container: Container);
+    /**
+     * Lazy getter for NotificationBadgeService to break circular dependency
+     * NotificationBadgeService depends on WebSocketService, so we resolve it lazily
+     */
+    private getBadgeService;
+    private getSocketAuth;
+    private hasOrganizationAccess;
+    private trackSocketResourceSubscription;
+    private untrackSocketResourceSubscription;
+    private revokeTrackedResourceSubscription;
+    private revalidateTrackedResourceSubscriptions;
+    /**
+     * Initialize WebSocket server
+     *
+     * For platform services that don't serve frontends (e.g., crontabs-batches-manager),
+     * WebSocket initialization is skipped since they only receive internal backend requests.
+     */
+    initialize(httpServer: HttpServer): Promise<void>;
+    /**
+     * Send message to specific user (with cross-pod support via Redis adapter)
+     */
+    sendToUser(userId: string, message: WebSocketMessage): Promise<boolean>;
+    /**
+     * Send a direct notification to a specific user.
+     *
+     * This is a convenience method for sending user notifications that are not
+     * tied to resource operations (e.g., "Your export is ready", "Payment received").
+     *
+     * @param userId - The user ID to notify
+     * @param notification - Notification configuration
+     * @param notification.type - Notification level (info, success, warning, error)
+     * @param notification.identifier - i18n identifier for message lookup
+     * @param notification.message - Direct message (fallback if identifier not found)
+     * @param notification.title - Optional notification title
+     * @param notification.data - Additional context data
+     * @param notification.displayTarget - Where to display (toast, center, or both)
+     * @param notification.organizationId - Organization context (optional)
+     *
+     * @example
+     * // Notify user about export completion
+     * await webSocketService.notifyUser(userId, {
+     *   type: NotificationLevel.SUCCESS,
+     *   identifier: 'export.completed',
+     *   data: { fileName: 'report.pdf', downloadUrl: '/files/123' },
+     * });
+     *
+     * @example
+     * // Notify user with direct message
+     * await webSocketService.notifyUser(userId, {
+     *   type: NotificationLevel.INFO,
+     *   message: 'Your session will expire in 5 minutes',
+     *   displayTarget: NotificationDisplayTarget.TOAST,
+     * });
+     */
+    notifyUser(userId: string, notification: {
+        type: NotificationLevel;
+        identifier?: string;
+        message?: string;
+        title?: string;
+        data?: Record<string, unknown>;
+        displayTarget?: NotificationDisplayTarget;
+        organizationId?: string;
+    }): Promise<boolean>;
+    /**
+     * Send a direct notification to all users in an organization.
+     *
+     * @param organizationId - The organization ID
+     * @param notification - Notification configuration (same as notifyUser)
+     * @param excludeUsers - Optional list of user IDs to exclude
+     */
+    notifyOrganization(organizationId: string, notification: {
+        type: NotificationLevel;
+        identifier?: string;
+        message?: string;
+        title?: string;
+        data?: Record<string, unknown>;
+        displayTarget?: NotificationDisplayTarget;
+    }, excludeUsers?: string[]): Promise<number>;
+    /**
+     * Send message to organization (with cross-pod support via Redis adapter)
+     */
+    sendToOrganization(organizationId: string, message: WebSocketMessage, excludeUsers?: string[]): Promise<number>;
+    /**
+     * Send message to users with specific role within an organization
+     */
+    sendToRole(organizationId: string, role: string, message: WebSocketMessage): Promise<number>;
+    /**
+     * Send message to users with application-level role (admin dashboard users).
+     *
+     * Application-level roles are not scoped to an organization - they are global
+     * admin roles like super admins, support staff, billing admins, etc.
+     *
+     * Users with app-level roles join app role rooms (via buildAppRoleRoomName) on connection.
+     *
+     * @param role - The application-level role (e.g., 'admin', 'super_admin', 'support')
+     * @param message - The WebSocket message to send
+     * @returns Number of sockets the message was sent to
+     *
+     * @example
+     * // Notify all application administrators
+     * await webSocketService.sendToAppRole(CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN, {
+     *   type: CoreWebSocketEvent.USER_NOTIFICATION,
+     *   payload: { notificationLevel: NotificationLevel.WARNING, message: 'New user signup requires review' },
+     *   timestamp: new Date(),
+     * });
+     */
+    sendToAppRole(role: string, message: WebSocketMessage): Promise<number>;
+    /**
+     * Send a direct notification to users with a specific application-level role.
+     *
+     * Convenience method for sending admin notifications.
+     *
+     * @param role - The application-level role
+     * @param notification - Notification configuration
+     *
+     * @example
+     * // Notify support staff about a new ticket
+     * await webSocketService.notifyAppRole(CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN, {
+     *   type: NotificationLevel.INFO,
+     *   identifier: 'support.new_ticket',
+     *   data: { ticketId: '123', subject: 'Help needed' },
+     * });
+     */
+    notifyAppRole(role: string, notification: {
+        type: NotificationLevel;
+        identifier?: string;
+        message?: string;
+        title?: string;
+        data?: Record<string, unknown>;
+        displayTarget?: NotificationDisplayTarget;
+    }): Promise<number>;
+    /**
+     * Broadcast message to all connected users
+     */
+    broadcast(message: WebSocketMessage): Promise<number>;
+    /**
+     * Extract DataMode from a websocket payload.
+     * Defaults to RAW for websocket messages when no explicit data mode is present.
+     */
+    private extractDataMode;
+    /**
+     * Select the appropriate response DTO based on DataMode.
+     * Similar to controller-resource.backend.service.ts
+     */
+    private selectResponseDto;
+    /**
+     * Validate and transform websocket resource data before sending it.
+     * Similar to controller-resource.backend.service.ts sendResponse() method.
+     *
+     * This method validates resource data against the appropriate DTO and transforms dates.
+     * It is used for sync-grade replay payloads and for custom websocket events that
+     * choose to carry resource-shaped data.
+     *
+     * @param resourceData - The resource data to validate (if present in payload)
+     * @param resourceType - Resource type
+     * @param operationIdentifier - Operation identifier (optional)
+     * @param dataMode - Data mode (defaults to RAW)
+     * @returns Validated and transformed resource data, or false when validation cannot proceed
+     */
+    private resolveOperationForWebSocketValidation;
+    private validateAndTransformResourceData;
+    private stripScopeNotificationReplayFields;
+    private validateAndTransformSyncReplayData;
+    /**
+     * Emit to a specific resource room (path-independent)
+     * Called by NotificationDispatcherService after CRUD operations
+     *
+     * Resource-room sync payloads now validate replay-grade resource data when it
+     * is present in the payload.
+     *
+     * @param resourceType - Resource type
+     * @param resourceId - Resource ID
+     * @param event - WebSocket event name
+     * @param payload - Resource-room payload. Sync-grade update payloads carry authoritative
+     * `version` + `resourceData`; delete/state payloads intentionally do not.
+     *
+     * @example
+     * // Send notification-grade metadata only
+     * websocketService.emitToResourceRoom('users', 'userId123', CoreWebSocketEvent.RESOURCE_UPDATED, {
+     *   resourceType: 'users',
+     *   resourceId: 'userId123',
+     *   contextResourceIdentifiers: {},
+     *   action: ResourceAction.UPDATED,
+     *   operationIdentifier: CoreResourceOperation.UPDATE
+     * });
+     *
+     * @example
+     * // Send synchronization-grade replay data for RESOURCE_ROOM_SYNC
+     * websocketService.emitToResourceRoom('users', 'userId123', CoreWebSocketEvent.RESOURCE_UPDATED, {
+     *   resourceType: 'users',
+     *   resourceId: 'userId123',
+     *   contextResourceIdentifiers: {},
+     *   action: ResourceAction.UPDATED,
+     *   operationIdentifier: CoreResourceOperation.UPDATE,
+     *   resourceData: updatedUserObject, // Full resource object
+     *   dataMode: DataMode.RAW // or DataMode.SUMMARY, DataMode.CONTEXT
+     * });
+     */
+    emitToResourceRoom(resourceType: string, resourceId: string, event: string, payload: WebSocketResourceRoomEmitPayload): boolean;
+    /**
+     * Helper method to send resource data via WebSocket with automatic validation.
+     *
+     * This is a convenience method that prepares a payload with resource data and sends it
+     * to a resource room. Use this when you want to send authoritative resource objects via
+     * WebSocket.
+     *
+     * @param resourceType - Resource type
+     * @param resourceId - Resource ID
+     * @param event - WebSocket event name (e.g., CoreWebSocketEvent.RESOURCE_UPDATED)
+     * @param action - Resource action (ResourceAction.CREATED, UPDATED, DELETED)
+     * @param resourceData - The resource data object to send (will be validated and transformed)
+     * @param options - Optional configuration
+     * @param options.operationIdentifier - Operation identifier (e.g., CoreResourceOperation.UPDATE)
+     * @param options.dataMode - Data mode (defaults to RAW)
+     * @param options.contextResourceIdentifiers - Context resource identifiers
+     * @param options.affectedIds - Array of affected resource IDs
+     * @param options.initiatorUserId - User ID of the initiator
+     *
+     * @example
+     * // Send updated user resource
+     * await websocketService.sendResourceData(
+     *   'users',
+     *   'userId123',
+     *   CoreWebSocketEvent.RESOURCE_UPDATED,
+     *   ResourceAction.UPDATED,
+     *   updatedUserObject,
+     *   {
+     *     operationIdentifier: CoreResourceOperation.UPDATE,
+     *     dataMode: DataMode.RAW,
+     *     contextResourceIdentifiers: {},
+     *     initiatorUserId: 'currentUserId'
+     *   }
+     * );
+     *
+     * @example
+     * // Send created resource with summary data
+     * await websocketService.sendResourceData(
+     *   'todos',
+     *   'todoId456',
+     *   CoreWebSocketEvent.RESOURCE_UPDATED,
+     *   ResourceAction.CREATED,
+     *   newTodoObject,
+     *   {
+     *     operationIdentifier: CoreResourceOperation.CREATE,
+     *     dataMode: DataMode.SUMMARY, // Use summary for list refreshes
+     *     contextResourceIdentifiers: { organizationId: 'org123' },
+     *     initiatorUserId: 'currentUserId'
+     *   }
+     * );
+     */
+    sendResourceData(resourceType: string, resourceId: string, event: string, action: ResourceAction, resourceData: any, options?: {
+        operationIdentifier?: string;
+        dataMode?: DataMode | string;
+        contextResourceIdentifiers?: Record<string, string>;
+        affectedIds?: string[];
+        initiatorUserId?: string;
+        version?: number;
+    }): void;
+    /**
+     * Emit to scope rooms (collections) for list refresh
+     * Called by NotificationDispatcherService after CRUD operations
+     *
+     * Scope-room payloads validate resource-shaped data when it is present in the
+     * payload, while still treating these emissions as notification-grade rather
+     * than replay-grade sync.
+     *
+     * @param resourceType - Resource type
+     * @param scopes - Array of scope rooms to emit to
+     * @param event - WebSocket event name
+     * @param payload - Payload with optional resourceData and dataMode
+     *
+     * @example
+     * // Send notification-grade metadata for list refresh
+     * websocketService.emitToScopeRooms('users', [{ scopeKey: 'organization', scopeId: 'org123' }],
+     *   CoreWebSocketEvent.RESOURCE_UPDATED, { ... });
+     *
+     * @example
+     * // Send optional summary data for list refresh
+     * websocketService.emitToScopeRooms('users', [{ scopeKey: 'organization', scopeId: 'org123' }],
+     *   CoreWebSocketEvent.RESOURCE_UPDATED, {
+     *     ...metadata,
+     *     resourceData: updatedUserObject,
+     *     dataMode: DataMode.SUMMARY // Use SUMMARY for list refreshes
+     *   });
+     */
+    emitToScopeRooms(resourceType: string, scopes: Array<{
+        scopeKey: string;
+        scopeId: string;
+    }>, event: string, payload: WS_ResourceUpdateNotificationPayload): void;
+    /**
+     * Get all users currently editing a resource
+     */
+    getResourceEditingUsers(resourceType: string, resourceId: string): Promise<string[]>;
+    /**
+     * Create custom room
+     */
+    createRoom(roomName: string, organizationId: string, type?: RoomInfo['type'], metadata?: Record<string, any>): Promise<void>;
+    /**
+     * Join user to room
+     */
+    joinRoom(userId: string, roomName: string): Promise<boolean>;
+    /**
+     * Remove user from room
+     */
+    leaveRoom(userId: string, roomName: string): Promise<boolean>;
+    getConnectedUsersCount(): number;
+    getOrganizationUsersCount(organizationId: string): number;
+    isUserConnected(userId: string): boolean;
+    getRoomInfo(roomName: string): RoomInfo | undefined;
+    /**
+     * Get CORS origins from app-config runtime endpoints
+     */
+    private getCorsOrigins;
+    /**
+     * Setup Redis adapter for horizontal scaling across Kubernetes pods
+     */
+    private setupRedisAdapter;
+    /**
+     * Setup authentication middleware
+     * FACTORIZED: Uses ExecutionContextCreatorBackendService for JWT validation
+     */
+    private setupAuthentication;
+    /**
+     * Setup rate limiting middleware
+     * Uses Redis for cross-pod synchronization of rate limit counters
+     */
+    private setupRateLimiting;
+    /**
+     * Check rate limit for an event using Redis
+     * Returns true if allowed, false if rate limited
+     *
+     * Uses sliding window algorithm with Redis INCR and EXPIRE
+     */
+    private checkRateLimit;
+    /**
+     * In-memory rate limiting fallback (single pod only)
+     */
+    private inMemoryRateLimits;
+    private checkRateLimitInMemory;
+    /**
+     * Setup connection handling
+     * Joins user to identity-based rooms based on their roles and IDs
+     * Sets up resource room handlers for collaboration
+     */
+    private setupConnectionHandling;
+    /**
+     * Setup handlers for resource-centric rooms (collaboration, editing locks, custom events)
+     * These rooms are path-independent - same resource = same room regardless of access path
+     */
+    private setupResourceRoomHandlers;
+    /**
+     * Setup system event handlers (auth refresh, organization switch)
+     */
+    private setupSystemEventHandlers;
+    /**
+     * Reassign identity-based rooms when auth is refreshed
+     * Handles role changes, organization membership changes, etc.
+     */
+    private reassignIdentityRooms;
+    /**
+     * Setup badge handlers (badge:get, badge:get-all)
+     * Enables frontend useBadge and useUserBadges hooks
+     */
+    private setupBadgeHandlers;
+    /**
+     * Verify user has access to a badge scope
+     */
+    private verifyBadgeScopeAccess;
+    /**
+     * Verify user has READ access to a specific resource
+     *
+     * REUSES: AuthorizationsBackendService.authorizeInController()
+     * This is the EXACT same method used by HTTP controllers
+     */
+    private verifyResourceAccess;
+    /**
+     * Verify user has WRITE access to edit a resource (for editing lock)
+     *
+     * REUSES: AuthorizationsBackendService.authorizeInController() with UPDATE operation
+     */
+    private verifyResourceAccessForEdit;
+    /**
+     * Verify user has access to a scope (for collection subscriptions)
+     *
+     * REUSES: Role-based check for organization scope, or AuthorizationsBackendService for parent resources
+     */
+    private verifyScopeAccess;
+    private getSocketAuthorizationCandidateOperations;
+    private authorizeSocketResourceAgainstAnyVariant;
+    /**
+     * Map scope key to parent resource type using the resources registry
+     *
+     * Scope keys follow the pattern: fieldIdentifier without 'Id' suffix
+     * E.g., 'todolist' → find resource with fieldIdentifier 'todolistId' → TODOLISTS
+     *
+     * Uses the registry's resource configurations to dynamically resolve
+     * without hardcoded mappings.
+     */
+    private mapScopeKeyToResourceType;
+    /**
+     * Track editing state in Redis for cross-pod synchronization
+     */
+    private trackEditingState;
+    /**
+     * Cleanup editing states when user disconnects
+     * Cleans both in-memory state AND Redis for immediate consistency across pods
+     *
+     * CROSS-POD SUPPORT: Uses Redis SCAN to find all editing keys across all pods
+     * where this user is editing, ensuring complete cleanup.
+     */
+    private cleanupEditingStatesForUser;
+    /**
+     * SCAN Redis for all editing:* keys and remove the user from each
+     * Also broadcasts editing:end to affected resource rooms
+     *
+     * Key format: {appPrefix}editing:{resourceType}:{resourceId}
+     * Example: "wildo-ai-app_local:editing:users:user456"
+     */
+    private cleanupUserEditingStatesFromRedis;
+    /**
+     * Handle socket disconnection - cleanup state and notify rooms
+     */
+    private handleSocketDisconnection;
+    /**
+     * Cleanup resources
+     */
+    cleanup(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=websocket.service.d.ts.map

package/dist/esm/requests/service/websocket.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.service.d.ts","sourceRoot":"","sources":["../../../../src/requests/service/websocket.service.ts"],"names":[],"mappings":"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"}