Architecture

┌───────────────────────────────────────────────────────────────────┐
│                     AxilJS Cloud Platform                         │
├───────────────────────────────────────────────────────────────────┤
│                                                                   │
│  Tenancy & Access             Governance                          │
│  ─────────────────            ─────────────                       │
│  multi-tenancy                audit                               │
│  rate-limiter                 quota                               │
│  correlation                  feature-flags                       │
│                                                                   │
│  Data & Secrets               Deployment & Ops                    │
│  ─────────────────            ─────────────────                   │
│  cache                        deployment                          │
│  secrets                      dashboard                           │
│                               health-aggregator                   │
│                                                                   │
└───────────────────────────────────────────────────────────────────┘

                    ┌──────────────┐
                    │  @axiljs/    │
                    │  common      │
                    └──────┬───────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
       ┌──────▼──────┐┌────▼──────┐┌────▼──────┐
       │  @axiljs/   ││ @axiljs/  ││ @axiljs/  │
       │  events     ││ observab. ││ security  │
       └──────┬──────┘└────┬──────┘└────┬──────┘
              │            │            │
              └────────────┼────────────┘
                           │
                    ┌──────▼───────┐
                    │  @axiljs/    │
                    │  cloud       │
                    └──────────────┘

┌───────────────────────────────────────────────────────────────┐
│                     INCOMING HTTP REQUEST                     │
└───────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────────┐
│  correlationId()                                              │
│  → Generate req_xxx and corr_yyy                              │
│  → Attach to req.locals                                       │
│  → Echo in response headers                                   │
└───────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────────┐
│  multiTenancy()                                               │
│  → Extract tenant ID from header/subdomain/JWT                │
│  → Validate format                                            │
│  → Load tenant from database                                  │
│  → Reject if suspended/archived                               │
│  → Attach to req.locals.tenant                                │
└───────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────────┐
│  tenantRateLimiter()                                          │
│  → Look up tenant-specific rule                               │
│  → Increment sliding window counter                           │
│  → Set X-RateLimit-* headers                                  │
│  → Return 429 if exceeded                                     │
└───────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────────┐
│  auditMiddleware()                                            │
│  → Register response 'finish' and 'close' handlers            │
│  → On completion: emit 'audit.log' event                      │
└───────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────────┐
│                   YOUR BUSINESS LOGIC                         │
│                                                               │
│  • Use getTenant(req) for tenant context                      │
│  • Use featureFlags.isEnabled() for A/B testing               │
│  • Use quotas.increment() to track resource usage             │
│  • Use cache.get()/set() for performance                      │
│  • Use secrets.get() for credentials                          │
└───────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────────┐
│                    RESPONSE SENT TO CLIENT                    │
│                                                               │
│  Audit event automatically emitted on 'finish'                │
└───────────────────────────────────────────────────────────────┘

import { Application } from '@axiljs/core'
import { loadEnv, defineConfig } from '@axiljs/config'
import { helmet, cors } from '@axiljs/security'
import { JWT, authenticate } from '@axiljs/auth'
import { MetricsRegistry, HealthChecker, observabilityMiddleware } from '@axiljs/observability'
import {
  correlationId,
  multiTenancy,
  tenantRateLimiter,
  auditMiddleware,
  createDashboard,
} from '@axiljs/cloud'
 
loadEnv()
const config = defineConfig({ /* ... */ })
const jwt = new JWT(config.JWT_SECRET)
const metrics = new MetricsRegistry()
const health = new HealthChecker()
 
const app = new Application()
 
app.use(helmet())
app.use(cors({ origin: '*' }))
app.use(observabilityMiddleware({ metrics }))
app.use(correlationId())
app.use(authenticate(jwt, { required: false }))
app.use(multiTenancy({ strategy: 'jwt' }))
app.use(tenantRateLimiter({ defaultRule: { max: 100, windowMs: 60_000 } }))
app.use(auditMiddleware())
 
app.get('/dashboard', createDashboard({ title: 'Admin' }))
app.get('/health', health.handler())
 
app.listen(3000)