@baasix/baasix 0.1.0

package/dist/services/SettingsService.js

@@ -0,0 +1,474 @@
+import env from "../utils/env.js";
+import { APIError } from "../utils/errorHandler.js";
+import ItemsService from "./ItemsService.js";
+import { getCache } from "../utils/cache.js";
+class SettingsService {
+    globalSettings = null;
+    constructor() {
+        console.info("SettingsService instance created");
+    }
+    /**
+     * Get cache instance
+     */
+    getCache() {
+        return getCache();
+    }
+    async loadGlobalSettings() {
+        try {
+            const itemsService = new ItemsService("baasix_Settings", {
+                accountability: undefined,
+            });
+            const settings = await itemsService.readByQuery({
+                filter: { tenant_Id: { isNull: true } }, // Global settings have null tenant_Id
+                limit: 1,
+                fields: [
+                    "*",
+                    "project_logo_light.*",
+                    "project_logo_dark.*",
+                    "project_logo_full.*",
+                    "project_logo_transparent.*",
+                    "project_favicon.*",
+                    "project_icon.*",
+                    "email_icon.*",
+                ],
+            });
+            if (!settings.data[0]) {
+                // Create default global settings if none exist
+                const defaultSettings = await this.createDefaultGlobalSettings(itemsService);
+                this.globalSettings = defaultSettings;
+            }
+            else {
+                this.globalSettings = settings.data[0];
+            }
+            console.info("Global settings loaded successfully");
+        }
+        catch (error) {
+            console.error("Error loading global settings:", error);
+            throw error;
+        }
+    }
+    // Legacy method for backward compatibility
+    async loadSettings() {
+        return this.loadGlobalSettings();
+    }
+    async createDefaultGlobalSettings(itemsService) {
+        try {
+            const defaultData = {
+                tenant_Id: null, // Global settings
+                project_name: "Baasix Project",
+                title: "Baasix Project",
+                project_url: null,
+                app_url: null,
+                project_color: "#663399",
+                secondary_color: "#f0f0f0",
+                description: "Powered by Baasix",
+                keywords: "cms, headless, api",
+                from_email_name: "Baasix",
+                smtp_enabled: false,
+                smtp_port: 587,
+                smtp_secure: false,
+                timezone: "UTC",
+                language: "en",
+                date_format: "YYYY-MM-DD",
+                currency: "USD",
+                metadata: {},
+                modules: {},
+            };
+            const settingId = await itemsService.createOne(defaultData);
+            return await itemsService.readOne(settingId);
+        }
+        catch (error) {
+            console.error("Error creating default global settings:", error);
+            throw new APIError("Error creating default global settings", 500, error.message);
+        }
+    }
+    // Legacy method for backward compatibility
+    async createDefaultSettings(itemsService) {
+        return this.createDefaultGlobalSettings(itemsService);
+    }
+    getGlobalSettings() {
+        if (!this.globalSettings) {
+            throw new APIError("Global settings not loaded", 500);
+        }
+        return this.globalSettings;
+    }
+    // Legacy method for backward compatibility
+    getSettings() {
+        return this.getGlobalSettings();
+    }
+    /**
+     * Get tenant-specific settings: global base + tenant overrides
+     */
+    async getTenantSettings(tenantId) {
+        if (!tenantId) {
+            return this.getGlobalSettings();
+        }
+        const cache = this.getCache();
+        const cacheKey = `settings:tenant:${tenantId}`;
+        // Check cache first
+        const cachedSettings = await cache.get(cacheKey);
+        if (cachedSettings) {
+            return cachedSettings;
+        }
+        try {
+            // Always start with global settings as the base
+            const globalSettings = this.getGlobalSettings();
+            const mergedSettings = { ...globalSettings };
+            const itemsService = new ItemsService("baasix_Settings", {
+                accountability: undefined,
+            });
+            const tenantSettings = await itemsService.readByQuery({
+                filter: { tenant_Id: tenantId },
+                limit: 1,
+                fields: [
+                    "*",
+                    "project_logo_light.*",
+                    "project_logo_dark.*",
+                    "project_logo_full.*",
+                    "project_logo_transparent.*",
+                    "project_favicon.*",
+                    "project_icon.*",
+                    "email_icon.*",
+                ],
+            });
+            if (tenantSettings.data[0]) {
+                // Merge tenant-specific overrides on top of global settings
+                const tenantOverrides = tenantSettings.data[0];
+                // Only override with non-null values from tenant settings
+                Object.keys(tenantOverrides).forEach((key) => {
+                    if (tenantOverrides[key] !== null && tenantOverrides[key] !== undefined && key !== "tenant_Id") {
+                        mergedSettings[key] = tenantOverrides[key];
+                    }
+                });
+            }
+            // Cache the merged settings with infinite TTL
+            await cache.set(cacheKey, mergedSettings, -1);
+            return mergedSettings;
+        }
+        catch (error) {
+            console.error(`Error loading tenant settings for ${tenantId}:`, error);
+            // Fall back to global settings on error
+            return this.getGlobalSettings();
+        }
+    }
+    async updateGlobalSettings(data, accountability) {
+        try {
+            const itemsService = new ItemsService("baasix_Settings", {
+                accountability,
+            });
+            // Find global settings record
+            const globalSettings = await itemsService.readByQuery({
+                filter: { tenant_Id: { isNull: true } },
+                limit: 1,
+            });
+            if (globalSettings.data[0]) {
+                await itemsService.updateOne(globalSettings.data[0].id, data);
+            }
+            else {
+                // Create global settings if they don't exist
+                await itemsService.createOne({ ...data, tenant_Id: null });
+            }
+            // Reload global settings and clear all caches
+            await this.loadGlobalSettings();
+            await this.invalidateAllCaches();
+            return this.globalSettings;
+        }
+        catch (error) {
+            console.error("Error updating global settings:", error);
+            if (error instanceof APIError) {
+                throw error;
+            }
+            throw new APIError("Error updating global settings", 500, error.message);
+        }
+    }
+    // Legacy method for backward compatibility
+    async updateSettings(data, accountability) {
+        return this.updateGlobalSettings(data, accountability);
+    }
+    async updateTenantSettings(tenantId, data, accountability) {
+        if (!tenantId) {
+            throw new APIError("Tenant ID is required for tenant settings", 400);
+        }
+        try {
+            const itemsService = new ItemsService("baasix_Settings", {
+                accountability,
+            });
+            // Find existing tenant settings
+            const existingSettings = await itemsService.readByQuery({
+                filter: { tenant_Id: tenantId },
+                limit: 1,
+            });
+            if (existingSettings.data[0]) {
+                // Update existing tenant settings
+                await itemsService.updateOne(existingSettings.data[0].id, data);
+            }
+            else {
+                // Create new tenant settings
+                await itemsService.createOne({ ...data, tenant_Id: tenantId });
+            }
+            // Invalidate cache for this tenant
+            await this.invalidateTenantCache(tenantId);
+            return await this.getTenantSettings(tenantId);
+        }
+        catch (error) {
+            console.error(`Error updating tenant settings for ${tenantId}:`, error);
+            if (error instanceof APIError) {
+                throw error;
+            }
+            throw new APIError("Error updating tenant settings", 500, error.message);
+        }
+    }
+    async deleteTenantSettings(tenantId, accountability) {
+        if (!tenantId) {
+            throw new APIError("Tenant ID is required", 400);
+        }
+        try {
+            const itemsService = new ItemsService("baasix_Settings", {
+                accountability,
+            });
+            const existingSettings = await itemsService.readByQuery({
+                filter: { tenant_Id: tenantId },
+                limit: 1,
+            });
+            if (existingSettings.data[0]) {
+                await itemsService.deleteOne(existingSettings.data[0].id);
+                await this.invalidateTenantCache(tenantId);
+            }
+        }
+        catch (error) {
+            console.error(`Error deleting tenant settings for ${tenantId}:`, error);
+            throw new APIError("Error deleting tenant settings", 500, error.message);
+        }
+    }
+    /**
+     * Get SMTP configuration for tenant with fallback hierarchy
+     */
+    async getTenantSMTPConfig(tenantId) {
+        const settings = await this.getTenantSettings(tenantId);
+        if (!settings.smtp_enabled || !settings.smtp_host || !settings.smtp_user || !settings.smtp_pass) {
+            return null;
+        }
+        return {
+            host: settings.smtp_host,
+            port: settings.smtp_port,
+            secure: settings.smtp_secure,
+            auth: {
+                user: settings.smtp_user,
+                pass: settings.smtp_pass,
+            },
+            from: settings.smtp_from_address || settings.smtp_user,
+            fromName: settings.from_email_name || settings.project_name,
+        };
+    }
+    /**
+     * Get email branding for tenant
+     */
+    async getTenantEmailBranding(tenantId) {
+        const settings = await this.getTenantSettings(tenantId);
+        return {
+            project_name: settings.project_name,
+            title: settings.title,
+            project_url: settings.project_url,
+            app_url: settings.app_url,
+            logo_url: settings.email_icon ? `${settings.project_url}/assets/${settings.email_icon.id}` : null,
+            project_color: settings.project_color,
+            email_signature: settings.email_signature,
+            from_email_name: settings.from_email_name,
+        };
+    }
+    /**
+     * Get tenant branding configuration
+     */
+    async getTenantBranding(tenantId) {
+        const settings = await this.getTenantSettings(tenantId);
+        return {
+            project_name: settings.project_name,
+            title: settings.title,
+            project_url: settings.project_url,
+            app_url: settings.app_url,
+            description: settings.description,
+            keywords: settings.keywords,
+            logo_url: settings.email_icon ? `${settings.project_url}/assets/${settings.email_icon.id}` : null,
+            project_color: settings.project_color,
+            secondary_color: settings.secondary_color,
+            timezone: settings.timezone,
+            language: settings.language,
+            date_format: settings.date_format,
+            currency: settings.currency,
+        };
+    }
+    /**
+     * Sanitize settings by removing sensitive SMTP credentials
+     */
+    sanitizeSettings(settings) {
+        if (!settings) {
+            return settings;
+        }
+        // Create a copy to avoid mutating the original
+        const sanitized = { ...settings };
+        // Remove sensitive SMTP fields
+        const sensitiveFields = [
+            "smtp_user",
+            "smtp_pass",
+            "smtp_host",
+            "smtp_port",
+            "smtp_secure",
+            "smtp_from_address",
+        ];
+        sensitiveFields.forEach((field) => {
+            delete sanitized[field];
+        });
+        return sanitized;
+    }
+    /**
+     * Cache management
+     */
+    async invalidateTenantCache(tenantId) {
+        const cache = this.getCache();
+        const cacheKey = `settings:tenant:${tenantId}`;
+        await cache.delete(cacheKey);
+        console.info(`Tenant settings cache invalidated for: ${tenantId}`);
+    }
+    async invalidateAllCaches() {
+        const cache = this.getCache();
+        await cache.invalidateModel("settings:tenant");
+        console.info("All tenant settings cache cleared");
+    }
+    async getProjectInfo(tenantId = null) {
+        try {
+            const settings = tenantId ? await this.getTenantSettings(tenantId) : this.getGlobalSettings();
+            return {
+                project: {
+                    name: settings.project_name,
+                    title: settings.title,
+                    url: settings.project_url,
+                    app_url: settings.app_url,
+                    color: settings.project_color,
+                    secondary_color: settings.secondary_color,
+                    description: settings.description,
+                    keywords: settings.keywords,
+                    branding: {
+                        "logo-light": settings.project_logo_light?.id || null,
+                        "logo-dark": settings.project_logo_dark?.id || null,
+                        "logo-full": settings.project_logo_full?.id || null,
+                        "logo-transparent": settings.project_logo_transparent?.id || null,
+                        favicon: settings.project_favicon?.id || null,
+                        icon: settings.project_icon?.id || null,
+                        "email-icon": settings.email_icon?.id || null,
+                    },
+                    localization: {
+                        timezone: settings.timezone,
+                        language: settings.language,
+                        date_format: settings.date_format,
+                        currency: settings.currency,
+                    },
+                    smtp_enabled: settings.smtp_enabled,
+                    multitenant: env.get("MULTI_TENANT") || false,
+                    metadata: settings.metadata || {},
+                    modules: settings.modules || {},
+                },
+                version: env.get("npm_package_version") || "0.0.1",
+            };
+        }
+        catch (error) {
+            console.error("Error getting project info:", error);
+            throw new APIError("Error getting project info", 500, error.message);
+        }
+    }
+    /**
+     * Get settings by matching app_url
+     */
+    async getSettingsByAppUrl(appUrl) {
+        if (!appUrl) {
+            throw new APIError("app_url is required", 400);
+        }
+        try {
+            // First check global settings
+            const globalSettings = this.getGlobalSettings();
+            if (globalSettings.app_url === appUrl) {
+                return globalSettings;
+            }
+            // Query database for tenant settings
+            const itemsService = new ItemsService("baasix_Settings", {
+                accountability: undefined,
+            });
+            const tenantSettings = await itemsService.readByQuery({
+                filter: { app_url: { iLike: appUrl } },
+                limit: 1,
+                fields: ["tenant_Id"],
+            });
+            if (tenantSettings.data[0]) {
+                // Use getTenantSettings to get cached/merged settings
+                const tenantId = tenantSettings.data[0].tenant_Id;
+                return await this.getTenantSettings(tenantId);
+            }
+            throw new APIError("No settings found with the provided app_url", 404);
+        }
+        catch (error) {
+            if (error instanceof APIError) {
+                throw error;
+            }
+            console.error(`Error getting settings by app_url ${appUrl}:`, error);
+            throw new APIError("Error retrieving settings by app_url", 500, error.message);
+        }
+    }
+    /**
+     * Get all unique URLs from global and tenant settings for CORS/auth whitelist
+     */
+    async getAllSettingsUrls() {
+        try {
+            const urls = new Set();
+            // Get global settings URLs
+            const globalSettings = this.getGlobalSettings();
+            if (globalSettings.project_url) {
+                urls.add(globalSettings.project_url.trim());
+            }
+            if (globalSettings.app_url) {
+                urls.add(globalSettings.app_url.trim());
+            }
+            // Get all tenant settings from database
+            const itemsService = new ItemsService("baasix_Settings", {
+                accountability: undefined,
+            });
+            const allSettings = await itemsService.readByQuery({
+                filter: { tenant_Id: { isNotNull: true } }, // Get only tenant settings
+                fields: ["tenant_Id", "project_url", "app_url"],
+                limit: -1, // Get all
+            });
+            // Add tenant URLs
+            allSettings.data.forEach((setting) => {
+                if (setting.project_url) {
+                    urls.add(setting.project_url.trim());
+                }
+                if (setting.app_url) {
+                    urls.add(setting.app_url.trim());
+                }
+            });
+            // Filter out empty strings and invalid URLs
+            const validUrls = Array.from(urls).filter((url) => {
+                if (!url)
+                    return false;
+                try {
+                    new URL(url);
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            });
+            console.info(`Found ${validUrls.length} unique URLs from settings`);
+            return validUrls;
+        }
+        catch (error) {
+            console.error("Error getting settings URLs:", error);
+            return []; // Return empty array on error, don't break CORS
+        }
+    }
+}
+// Create singleton instance only if it doesn't exist
+if (!globalThis.__baasix_settingsService) {
+    globalThis.__baasix_settingsService = new SettingsService();
+}
+const settingsService = globalThis.__baasix_settingsService;
+export default settingsService;
+//# sourceMappingURL=SettingsService.js.map

package/dist/services/SettingsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsService.js","sourceRoot":"","sources":["../../baasix/services/SettingsService.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,MAAM,eAAe;IACX,cAAc,GAA0B,IAAI,CAAC;IAErD;QACE,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,QAAQ,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE;gBACvD,cAAc,EAAE,SAAS;aAC1B,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;gBAC9C,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,sCAAsC;gBAC/E,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE;oBACN,GAAG;oBACH,sBAAsB;oBACtB,qBAAqB;oBACrB,qBAAqB;oBACrB,4BAA4B;oBAC5B,mBAAmB;oBACnB,gBAAgB;oBAChB,cAAc;iBACf;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtB,+CAA+C;gBAC/C,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;gBAC7E,IAAI,CAAC,cAAc,GAAG,eAAe,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,2BAA2B,CAAC,YAA0B;QAC1D,IAAI,CAAC;YACH,MAAM,WAAW,GAAmB;gBAClC,SAAS,EAAE,IAAI,EAAE,kBAAkB;gBACnC,YAAY,EAAE,gBAAgB;gBAC9B,KAAK,EAAE,gBAAgB;gBACvB,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,SAAS;gBACxB,eAAe,EAAE,SAAS;gBAC1B,WAAW,EAAE,mBAAmB;gBAChC,QAAQ,EAAE,oBAAoB;gBAC9B,eAAe,EAAE,QAAQ;gBACzB,YAAY,EAAE,KAAK;gBACnB,SAAS,EAAE,GAAG;gBACd,WAAW,EAAE,KAAK;gBAClB,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,YAAY;gBACzB,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,EAAE;gBACZ,OAAO,EAAE,EAAE;aACZ,CAAC;YAEF,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC5D,OAAO,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YAChE,MAAM,IAAI,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,qBAAqB,CAAC,YAA0B;QACpD,OAAO,IAAI,CAAC,2BAA2B,CAAC,YAAY,CAAC,CAAC;IACxD,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,QAAQ,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,2CAA2C;IAC3C,WAAW;QACT,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAyB;QAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,mBAAmB,QAAQ,EAAE,CAAC;QAE/C,oBAAoB;QACpB,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,IAAI,CAAC;YACH,gDAAgD;YAChD,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAChD,MAAM,cAAc,GAAmB,EAAE,GAAG,cAAc,EAAE,CAAC;YAE7D,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE;gBACvD,cAAc,EAAE,SAAS;aAC1B,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;gBACpD,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;gBAC/B,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE;oBACN,GAAG;oBACH,sBAAsB;oBACtB,qBAAqB;oBACrB,qBAAqB;oBACrB,4BAA4B;oBAC5B,mBAAmB;oBACnB,gBAAgB;oBAChB,cAAc;iBACf;aACF,CAAC,CAAC;YAEH,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,4DAA4D;gBAC5D,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAE/C,0DAA0D;gBAC1D,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;oBAC3C,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;wBAC/F,cAAc,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;oBAC7C,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAED,8CAA8C;YAC9C,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,OAAO,cAAc,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YACvE,wCAAwC;YACxC,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,IAA6B,EAAE,cAAoB;QAC5E,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE;gBACvD,cAAc;aACf,CAAC,CAAC;YAEH,8BAA8B;YAC9B,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;gBACpD,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;gBACvC,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YAEH,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,MAAM,YAAY,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,6CAA6C;gBAC7C,MAAM,YAAY,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,CAAC;YAED,8CAA8C;YAC9C,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAEjC,OAAO,IAAI,CAAC,cAAe,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;YACxD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,cAAc,CAAC,IAA6B,EAAE,cAAoB;QACtE,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,QAAyB,EACzB,IAA6B,EAC7B,cAAoB;QAEpB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,QAAQ,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE;gBACvD,cAAc;aACf,CAAC,CAAC;YAEH,gCAAgC;YAChC,MAAM,gBAAgB,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;gBACtD,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;gBAC/B,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YAEH,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,kCAAkC;gBAClC,MAAM,YAAY,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,6BAA6B;gBAC7B,MAAM,YAAY,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,mCAAmC;YACnC,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAE3C,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,sCAAsC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YACxE,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,QAAyB,EAAE,cAAoB;QACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,QAAQ,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE;gBACvD,cAAc;aACf,CAAC,CAAC;YAEH,MAAM,gBAAgB,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;gBACtD,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;gBAC/B,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YAEH,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,MAAM,YAAY,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1D,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,sCAAsC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YACxE,MAAM,IAAI,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,QAAyB;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAExD,IAAI,CAAC,QAAQ,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAChG,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,SAAS;YACxB,IAAI,EAAE,QAAQ,CAAC,SAAS;YACxB,MAAM,EAAE,QAAQ,CAAC,WAAW;YAC5B,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ,CAAC,SAAS;gBACxB,IAAI,EAAE,QAAQ,CAAC,SAAS;aACzB;YACD,IAAI,EAAE,QAAQ,CAAC,iBAAiB,IAAI,QAAQ,CAAC,SAAS;YACtD,QAAQ,EAAE,QAAQ,CAAC,eAAe,IAAI,QAAQ,CAAC,YAAY;SAC5D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAAC,QAAyB;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAExD,OAAO;YACL,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,WAAW,WAAW,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;YACjG,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,eAAe,EAAE,QAAQ,CAAC,eAAe;SAC1C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAyB;QAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAExD,OAAO;YACL,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,WAAW,WAAW,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;YACjG,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAA+B;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,+CAA+C;QAC/C,MAAM,SAAS,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAElC,+BAA+B;QAC/B,MAAM,eAAe,GAAG;YACtB,WAAW;YACX,WAAW;YACX,WAAW;YACX,WAAW;YACX,aAAa;YACb,mBAAmB;SACpB,CAAC;QAEF,eAAe,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAChC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,QAAyB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,mBAAmB,QAAQ,EAAE,CAAC;QAC/C,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,0CAA0C,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,WAAmC,IAAI;QAC1D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAE9F,OAAO;gBACL,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ,CAAC,YAAY;oBAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,GAAG,EAAE,QAAQ,CAAC,WAAW;oBACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,KAAK,EAAE,QAAQ,CAAC,aAAa;oBAC7B,eAAe,EAAE,QAAQ,CAAC,eAAe;oBACzC,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,QAAQ,EAAE;wBACR,YAAY,EAAE,QAAQ,CAAC,kBAAkB,EAAE,EAAE,IAAI,IAAI;wBACrD,WAAW,EAAE,QAAQ,CAAC,iBAAiB,EAAE,EAAE,IAAI,IAAI;wBACnD,WAAW,EAAE,QAAQ,CAAC,iBAAiB,EAAE,EAAE,IAAI,IAAI;wBACnD,kBAAkB,EAAE,QAAQ,CAAC,wBAAwB,EAAE,EAAE,IAAI,IAAI;wBACjE,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI;wBAC7C,IAAI,EAAE,QAAQ,CAAC,YAAY,EAAE,EAAE,IAAI,IAAI;wBACvC,YAAY,EAAE,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,IAAI;qBAC9C;oBACD,YAAY,EAAE;wBACZ,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wBAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;wBACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;qBAC5B;oBACD,YAAY,EAAE,QAAQ,CAAC,YAAY;oBACnC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,KAAK;oBAC7C,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE;oBACjC,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;iBAChC;gBACD,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,OAAO;aACnD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YACpD,MAAM,IAAI,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,MAAc;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC;YACH,8BAA8B;YAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAChD,IAAI,cAAc,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;gBACtC,OAAO,cAAc,CAAC;YACxB,CAAC;YAED,qCAAqC;YACrC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE;gBACvD,cAAc,EAAE,SAAS;aAC1B,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;gBACpD,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACtC,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,CAAC,WAAW,CAAC;aACtB,CAAC,CAAC;YAEH,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,sDAAsD;gBACtD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAClD,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAChD,CAAC;YAED,MAAM,IAAI,QAAQ,CAAC,6CAA6C,EAAE,GAAG,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,qCAAqC,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC;YACrE,MAAM,IAAI,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAE/B,2BAA2B;YAC3B,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAChD,IAAI,cAAc,CAAC,WAAW,EAAE,CAAC;gBAC/B,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1C,CAAC;YAED,wCAAwC;YACxC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE;gBACvD,cAAc,EAAE,SAAS;aAC1B,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;gBACjD,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,2BAA2B;gBACvE,MAAM,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC;gBAC/C,KAAK,EAAE,CAAC,CAAC,EAAE,UAAU;aACtB,CAAC,CAAC;YAEH,kBAAkB;YAClB,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAY,EAAE,EAAE;gBACxC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBACxB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvC,CAAC;gBACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,4CAA4C;YAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;gBAChD,IAAI,CAAC,GAAG;oBAAE,OAAO,KAAK,CAAC;gBACvB,IAAI,CAAC;oBACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;oBACb,OAAO,IAAI,CAAC;gBACd,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,4BAA4B,CAAC,CAAC;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACrD,OAAO,EAAE,CAAC,CAAC,gDAAgD;QAC7D,CAAC;IACH,CAAC;CACF;AAOD,qDAAqD;AACrD,IAAI,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC;IACzC,UAAU,CAAC,wBAAwB,GAAG,IAAI,eAAe,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,eAAe,GAAG,UAAU,CAAC,wBAAwB,CAAC;AAC5D,eAAe,eAAe,CAAC"}

package/dist/services/SocketService.d.ts

@@ -0,0 +1,129 @@
+import type { Server as HTTPServer } from "http";
+import type { UserInfo, SocketWithAuth } from '../types/index.js';
+export type CustomMessageHandler = (socket: SocketWithAuth, data: any, callback?: (response: any) => void) => void | Promise<void>;
+export type RoomValidator = (socket: SocketWithAuth, roomName: string) => boolean | Promise<boolean>;
+declare class SocketService {
+    private io;
+    private userSockets;
+    private initialized;
+    private redisPublisher;
+    private redisSubscriber;
+    private customRooms;
+    private customMessageHandlers;
+    private roomValidators;
+    constructor();
+    initialize(server: HTTPServer): Promise<void>;
+    initializeRedisAdapter(): Promise<void>;
+    cleanup(): Promise<void>;
+    authMiddleware(socket: SocketWithAuth, next: (err?: Error) => void): Promise<void>;
+    authenticateUser(decoded: any): Promise<UserInfo>;
+    handleConnection(socket: SocketWithAuth): Promise<void>;
+    handleSubscribe(socket: SocketWithAuth, { collection }: {
+        collection: string;
+    }): Promise<void>;
+    handleUnsubscribe(socket: SocketWithAuth, { collection }: {
+        collection: string;
+    }): void;
+    handleDisconnect(socket: SocketWithAuth): void;
+    /**
+     * Handle a user joining a custom room
+     */
+    handleRoomJoin(socket: SocketWithAuth, roomName: string): Promise<void>;
+    /**
+     * Handle a user leaving a custom room
+     */
+    handleRoomLeave(socket: SocketWithAuth, roomName: string): void;
+    /**
+     * Handle a message sent to a custom room
+     */
+    handleRoomMessage(socket: SocketWithAuth, roomName: string, event: string, payload: any): Promise<void>;
+    /**
+     * Handle custom events with registered handlers
+     */
+    handleCustomEvent(socket: SocketWithAuth, event: string, payload: any, callback?: (response: any) => void): Promise<void>;
+    /**
+     * Register a custom message handler for a specific event
+     * Can be used by extensions to handle custom socket events
+     *
+     * @example
+     * socketService.registerMessageHandler("game:move", async (socket, data, callback) => {
+     *   // Handle game move logic
+     *   callback?.({ status: "success", result: { ... } });
+     * });
+     */
+    registerMessageHandler(event: string, handler: CustomMessageHandler): void;
+    /**
+     * Unregister a custom message handler
+     */
+    unregisterMessageHandler(event: string): void;
+    /**
+     * Register a validator for room join requests
+     * Validator is called when a user tries to join a room matching the pattern
+     *
+     * @example
+     * socketService.registerRoomValidator("game:", async (socket, roomName) => {
+     *   // Only allow admins to join game rooms
+     *   return socket.userRole.name === "administrator";
+     * });
+     */
+    registerRoomValidator(roomPattern: string, validator: RoomValidator): void;
+    /**
+     * Unregister a room validator
+     */
+    unregisterRoomValidator(roomPattern: string): void;
+    /**
+     * Broadcast a message to a custom room from server side
+     *
+     * @example
+     * socketService.broadcastToRoom("game:123", "game:state", { players: [...] });
+     */
+    broadcastToRoom(roomName: string, event: string, payload: any): void;
+    /**
+     * Broadcast a message to all connected users
+     *
+     * @example
+     * socketService.broadcastToAll("system:announcement", { message: "Server maintenance in 5 minutes" });
+     */
+    broadcastToAll(event: string, payload: any): void;
+    /**
+     * Send a message to a specific user (all their connected sockets)
+     *
+     * @example
+     * socketService.sendToUser(userId, "private:message", { from: "admin", text: "Hello!" });
+     */
+    sendToUser(userId: string | number, event: string, payload: any): void;
+    /**
+     * Get list of users in a custom room
+     */
+    getRoomMembers(roomName: string): string[];
+    /**
+     * Get count of users in a custom room
+     */
+    getRoomMemberCount(roomName: string): number;
+    /**
+     * Check if a room exists
+     */
+    roomExists(roomName: string): boolean;
+    /**
+     * Get all custom rooms
+     */
+    getCustomRooms(): Map<string, number>;
+    checkCollectionAccess(socket: SocketWithAuth, collection: string): Promise<boolean>;
+    getCollectionRoom(collection: string, tenantId?: string | number): string;
+    broadcastChange(collection: string, action: string, data: any, accountability?: any): void;
+    /**
+     * Emit workflow execution updates to connected clients
+     */
+    emitWorkflowExecutionUpdate(executionId: string | number, data: any): void;
+    /**
+     * Emit workflow execution completion
+     */
+    emitWorkflowExecutionComplete(executionId: string | number, data: any): void;
+    getStats(): any;
+}
+declare global {
+    var __baasix_socketService: SocketService | undefined;
+}
+declare const socketService: SocketService;
+export default socketService;
+//# sourceMappingURL=SocketService.d.ts.map

package/dist/services/SocketService.d.ts.map

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