@volcanicminds/backend 2.2.21 → 2.3.1

package/lib/hooks/onRequest.ts

@@ -23,6 +23,63 @@ const normalizeRoles = (rolesArray: any[] | undefined): string[] => {
 export default async (req, reply) => {
   if (log.i) req.startedAt = new Date()
 
+  const { multi_tenant } = global.config?.options || {}
+
+  if (multi_tenant?.enabled) {
+    let tenantSlug: string | undefined
+
+    if (multi_tenant.resolver === 'subdomain') {
+      const host = req.headers.host || ''
+      const parts = host.split('.')
+      if (parts.length >= 2) {
+        // FIXME: Improve subdomain extraction strategy. Currently assumes [slug].[domain].[tld] or [slug].localhost
+        if (parts[0] !== 'www') {
+          tenantSlug = parts[0]
+        }
+      }
+    } else if (multi_tenant.resolver === 'header') {
+      tenantSlug = req.headers[multi_tenant?.header_key || 'x-tenant-id'] as string
+    } else if (multi_tenant.resolver === 'query') {
+      tenantSlug = (req.query as any)[multi_tenant?.query_key || 'tid']
+    }
+
+    if (!tenantSlug) {
+      return reply.code(400).send({ statusCode: 400, error: 'Tenant ID missing', message: 'Tenant ID is required' })
+    }
+
+    if (!global.repository?.tenants) {
+      log.error('Multi-tenant enabled but global.repository.tenants not found')
+      return reply.code(500).send({ statusCode: 500, error: 'Internal Server Error' })
+    }
+
+    const tenant = await global.repository.tenants.findOneBy({ slug: tenantSlug })
+
+    if (!tenant) {
+      return reply
+        .code(404)
+        .send({ statusCode: 404, error: 'Tenant Not Found', message: `Tenant '${tenantSlug}' not found` })
+    }
+
+    if (tenant.status !== 'active') {
+      return reply.code(403).send({ statusCode: 403, error: 'Tenant Inactive', message: 'Tenant is not active' })
+    }
+
+    // Tenant Context Setup
+    const runner = global.connection.createQueryRunner()
+    await runner.connect()
+
+    // Validate schema name safety
+    if (!/^[a-z0-9_]+$/i.test(tenant.schema)) {
+      await runner.release()
+      return reply.code(400).send({ statusCode: 400, error: 'Invalid Schema Name' })
+    }
+
+    await runner.query(`SET search_path TO "${tenant.schema}", "public"`)
+
+    req.runner = runner
+    req.tenant = tenant
+  }
+
   req.data = () => getData(req)
   req.parameters = () => getParams(req)
 
@@ -55,9 +112,7 @@ export default async (req, reply) => {
     let bearerToken: string | undefined
 
     if (AUTH_MODE === 'COOKIE') {
-      // COOKIE MODE: ONLY Check Cookie
       const cookieToken = req.cookies['auth_token']
-      // If cookie is signed:
       if (cookieToken) {
         const unsigned = req.unsignCookie(cookieToken)
         if (unsigned.valid && unsigned.value) {
@@ -65,7 +120,6 @@ export default async (req, reply) => {
         }
       }
     } else {
-      // BEARER MODE: ONLY Check Header
       const auth = req.headers?.authorization || ''
       const [prefix, token] = auth.split(' ')
       if (prefix === 'Bearer' && token != null) {
@@ -77,7 +131,19 @@ export default async (req, reply) => {
       try {
         const tokenData = reply.server.jwt.verify(bearerToken)
 
-        // --- MFA GATEKEEPER ---
+        // Validate Tenant Access
+        const { multi_tenant } = global.config?.options || {}
+        if (multi_tenant?.enabled && req.tenant && tokenData.tid) {
+          if (tokenData.tid !== req.tenant.id) {
+            return reply.status(403).send({
+              statusCode: 403,
+              code: 'TENANT_MISMATCH',
+              message: 'Token does not belong to this tenant'
+            })
+          }
+        }
+
+        // MFA Gatekeeper Check
         if (tokenData.role === 'pre-auth-mfa') {
           const currentUrl = req.routeOptions.url || req.raw.url
           const isAllowed = MFA_SETUP_WHITELIST.some((url) => currentUrl.endsWith(url))
@@ -143,9 +209,6 @@ export default async (req, reply) => {
           })
         }
       }
-    } else {
-      // No token found, but maybe route is public?
-      // If route requires roles and no token, it will be caught by permissions check below (bearerToken is null)
     }
 
     if (cfg.requiredRoles?.length > 0) {
@@ -160,3 +223,5 @@ export default async (req, reply) => {
     }
   }
 }
+
+

package/lib/hooks/onResponse.ts

@@ -1,4 +1,10 @@
 export default async (req, reply) => {
+  if (req.runner) {
+    if (!req.runner.isReleased) {
+      await req.runner.release()
+    }
+  }
+
   let extraMessage = ''
   if (log.i && req.startedAt) {
     const elapsed: number = new Date().getTime() - req.startedAt.getTime()

package/lib/loader/general.ts

@@ -8,11 +8,16 @@ export async function load() {
     options: {
       allow_multiple_admin: false,
       admin_can_change_passwords: false,
+      allow_admin_change_password_users: false,
       reset_external_id_on_login: false,
       scheduler: false,
       embedded_auth: true,
       mfa_admin_forced_reset_email: undefined,
-      mfa_admin_forced_reset_until: undefined
+      mfa_admin_forced_reset_until: undefined,
+      multi_tenant: {
+        enabled: false,
+        query_key: 'tid'
+      }
     }
   }
 

package/lib/loader/tenant.ts

@@ -0,0 +1,79 @@
+import { FastifyInstance } from 'fastify'
+import { TenantManagement } from '../../types/global.js'
+
+export async function apply(server: FastifyInstance) {
+  const { multi_tenant } = global.config.options || {}
+
+  // Se multi-tenant non è abilitato, usciamo subito
+  if (!multi_tenant?.enabled) {
+    if (log.d) log.debug('Multi-Tenant: Disabled by configuration')
+    return
+  }
+
+  if (log.i) log.info('Multi-Tenant: 🟢 Enabled')
+
+  // Hook globale per la risoluzione del tenant
+  // Deve essere eseguito all'inizio della richiesta
+  server.addHook('onRequest', async (req, reply) => {
+    // Recuperiamo il gestore tenant iniettato o di default
+    const tm = server['tenantManager'] as TenantManagement
+
+    // Controllo critico: se è abilitato il MT, DEVE esserci un manager implementato
+    if (!tm || !tm.isImplemented()) {
+      const errorMsg = 'Multi-Tenant enabled but no TenantManager provided/implemented!'
+      if (log.f) log.fatal(errorMsg)
+      throw new Error(errorMsg) 
+    }
+
+    try {
+      // 1. Risoluzione Tenant
+      const tenant = await tm.resolveTenant(req)
+      
+      if (!tenant) {
+        if (log.w) log.warn(`Multi-Tenant: Tenant resolution failed for request ${req.id}`)
+        return reply.code(404).send({ 
+          statusCode: 404, 
+          error: 'Not Found', 
+          message: 'Tenant not found or resolution failed' 
+        })
+      }
+
+      // 2. Setup Contesto
+      req.tenant = tenant
+      if (log.t) log.trace(`Multi-Tenant: Context switched to ${tenant.slug || tenant.id}`)
+
+      // 3. Creazione QueryRunner (Context-Chain Root)
+      // Questo è il cuore della "Golden Solution": ogni richiesta ha il suo QueryRunner isolato
+      const dataSource = global.connection
+      if (dataSource) {
+        const qr = dataSource.createQueryRunner()
+        await qr.connect()
+        
+        // Assegnamo il manager del QueryRunner alla richiesta
+        req.db = qr.manager
+
+        // 4. Switch Schema su QUESTO QueryRunner
+        // Passiamo il manager affinché il TenantManager possa eseguire "SET search_path" su questa connessione specifica
+        await tm.switchContext(tenant, qr.manager)
+
+        // 5. Cleanup: Rilascio del QueryRunner alla fine della richiesta
+        reply.raw.on('finish', async () => {
+          if (!qr.isReleased) {
+            await qr.release()
+          }
+        })
+      } else {
+        if (log.w) log.warn('Multi-Tenant: Global connection not found! Skipping DB context creation.')
+      }
+
+    } catch (err: unknown) {
+      const message = err instanceof Error ? err.message : String(err)
+      if (log.e) log.error(`Multi-Tenant Error: ${message}`)
+      return reply.code(500).send({ 
+        statusCode: 500, 
+        error: 'Internal Server Error', 
+        message: 'Tenant Context Switch Failed' 
+      })
+    }
+  })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volcanicminds/backend",
-  "version": "2.2.21",
+  "version": "2.3.1",
   "type": "module",
   "codename": "rome",
   "license": "MIT",