exisjs 0.7.7 → 0.7.9

package/dist/docs/content/swagger.mdx

@@ -5,7 +5,7 @@ nextTitle: "Swagger API Reference"
 
 # Swagger & OpenAPI 3.1 Documentation
 
-ExisJS comes with a native, zero-bloat **Swagger & OpenAPI 3.1** documentation engine. It automatically discovers all registered routes, introspects **Tex** and **Zod** validation schemas, and serves interactive API documentation at `/docs`.
+ExisJS comes with a native, built-in **Swagger & OpenAPI 3.1** documentation engine. It automatically discovers all registered routes, introspects **Tex** and **Zod** validation schemas, and serves interactive API documentation at `/docs`.
 
 ---
 
@@ -44,6 +44,8 @@ The industry-standard interactive Swagger explorer featuring **Try it out**, liv
 A modern, high-performance, dark-mode-first API reference documentation viewer with integrated code snippets and fast search.
 
 ```typescript filename="exis.config.ts"
+import { defineConfig } from 'exisjs/config'
+
 export default defineConfig({
   docs: {
     enabled: true,
@@ -56,14 +58,14 @@ export default defineConfig({
 
 ## Documenting Functional Routes
 
-When writing functional route controllers (`export default controller({ ... })`), add metadata directly to the route definition:
+In ExisJS folder-based routing, each endpoint folder contains a `route.ts` file that exports a default `controller({ ... })`. You can add OpenAPI metadata directly to each route definition:
 
 ```typescript filename="src/http/users/route.ts"
 import { controller, route } from 'exisjs/router'
 import { tex, getPaginationSkip } from 'exisjs/validator'
 
 export default controller({
-  listUsers: route.get('/', {
+  list: route.get('/', {
     summary: 'List active users',
     description: 'Returns a paginated list of all active users in the system.',
     tags: ['Users'],
@@ -80,11 +82,19 @@ export default controller({
     },
     async handle({ query }) {
       const { skip, limit } = getPaginationSkip(query)
-      return UserService.find(skip, limit)
+      return {
+        data: [
+          { id: '550e8400-e29b-41d4-a716-446655440000', name: 'Alice' },
+          { id: '550e8400-e29b-41d4-a716-446655440001', name: 'Bob' },
+        ],
+        total: 2,
+        skip,
+        limit,
+      }
     },
   }),
 
-  createUser: route.post('/', {
+  create: route.post('/', {
     summary: 'Create a new user',
     tags: ['Users'],
     body: tex.object({
@@ -96,11 +106,11 @@ export default controller({
       400: { description: 'Validation error' },
     },
     async handle({ body }) {
-      return UserService.create(body)
+      return { id: '550e8400-e29b-41d4-a716-446655440002', ...body }
     },
   }),
 
-  getUser: route.get('/:id', {
+  getById: route.get('/:id', {
     summary: 'Get user by UUID',
     tags: ['Users'],
     params: tex.object({ id: tex.uuid() }),
@@ -109,7 +119,7 @@ export default controller({
       404: { description: 'User not found' },
     },
     async handle({ params }) {
-      return UserService.findById(params.id)
+      return { id: params.id, name: 'Alice' }
     },
   }),
 })
@@ -119,9 +129,9 @@ export default controller({
 
 ## Documenting Class-Based Controllers (OOP)
 
-For class-based controllers, use decorators from `exisjs/swagger` or `exisjs/decorators`:
+For class-based controllers in `route.ts`, use OpenAPI decorators from `exisjs/swagger` alongside standard routing decorators:
 
-```typescript filename="src/http/products/controller.ts"
+```typescript filename="src/http/products/route.ts"
 import { Controller, Get, Post, Body, Param, Query } from 'exisjs/decorators'
 import {
   ApiTags,
@@ -130,32 +140,42 @@ import {
   ApiBearerAuth,
   ApiExclude,
 } from 'exisjs/swagger'
-import { tex } from 'exisjs/validator'
 
 @ApiTags('Products')
 @ApiBearerAuth()
-@Controller('/products')
-export class ProductController {
+@Controller()
+export default class ProductsController {
   @Get('/')
   @ApiOperation({
     summary: 'List products',
     description: 'Fetches paginated list of catalog products',
   })
   @ApiResponse({ status: 200, description: 'List of products' })
-  async list(@Query('page') page: number) {
-    return ProductService.findAll(page)
+  async list(@Query('page') page: number = 1) {
+    return [
+      { id: 1, name: 'Mechanical Keyboard', price: 99 },
+      { id: 2, name: 'Ergonomic Mouse', price: 49 },
+    ]
   }
 
   @Post('/')
   @ApiOperation({ summary: 'Create new product' })
   @ApiResponse({ status: 201, description: 'Product created' })
-  async create(@Body() dto: any) {
-    return ProductService.create(dto)
+  async create(@Body() dto: { name: string; price: number }) {
+    return { id: 3, ...dto }
+  }
+
+  @Get('/:id')
+  @ApiOperation({ summary: 'Get product by ID' })
+  @ApiResponse({ status: 200, description: 'Product found' })
+  @ApiResponse({ status: 404, description: 'Product not found' })
+  async getById(@Param('id') id: string) {
+    return { id, name: 'Mechanical Keyboard', price: 99 }
   }
 
-  @Get('/internal-stats')
+  @Get('/internal/metrics')
   @ApiExclude() // Excluded from Swagger documentation
-  async stats() {
+  async metrics() {
     return { uptime: process.uptime() }
   }
 }
@@ -165,7 +185,7 @@ export class ProductController {
 
 ## Cascading Boundary Metadata
 
-Cascading boundaries (`boundary.ts`) can assign shared tags, descriptions, or security requirements to all nested routes:
+Cascading boundaries (`boundary.ts`) can assign shared tags, descriptions, or security requirements to all nested routes in the directory:
 
 ```typescript filename="src/http/admin/boundary.ts"
 import { defineBoundary } from 'exisjs/router'
@@ -183,6 +203,8 @@ export const config = defineBoundary({
 Define reusable security schemes (such as Bearer JWT, API Keys, or OAuth2) in `exis.config.ts`:
 
 ```typescript filename="exis.config.ts"
+import { defineConfig } from 'exisjs/config'
+
 export default defineConfig({
   docs: {
     enabled: true,
@@ -208,21 +230,60 @@ export default defineConfig({
 
 ---
 
-## Programmatic / Custom Setup
+## Advanced Configuration (`exis.config.ts`)
 
-You can also mount Swagger programmatically on any `App` instance:
+For advanced customization, such as modifying the generated OpenAPI spec before serving or injecting custom styling:
 
-```typescript filename="src/index.ts"
-import { App } from 'exisjs'
-import { swagger } from 'exisjs/swagger'
+```typescript filename="exis.config.ts"
+import { defineConfig } from 'exisjs/config'
 
-const app = new App()
+export default defineConfig({
+  docs: {
+    enabled: true,
+    title: 'Enterprise API Gateway',
+    version: '2.0.0',
+    description: 'Internal and external microservices API reference',
+    ui: 'scalar', // 'swagger-ui' | 'scalar'
+    servers: [
+      { url: 'https://api.example.com', description: 'Production Server' },
+      { url: 'http://localhost:3000', description: 'Local Development' },
+    ],
+    transformSpec(spec) {
+      // Programmatically mutate or enrich OpenAPI specification
+      spec.info.contact = { name: 'API Support', email: 'support@example.com' }
+      return spec
+    },
+  },
+})
+```
+
+---
+
+## Server Lifecycle Hook (`server.ts`)
+
+You can also interact with the Swagger subsystem or application instance during server boot in `src/http/server.ts`:
+
+### Functional Paradigm
+```typescript filename="src/http/server.ts"
+import { exis } from 'exisjs'
+
+export default exis({
+  onStart(app) {
+    console.log('[API] Swagger documentation ready at /docs')
+  },
+})
+```
+
+### Class-Based (OOP) Paradigm
+```typescript filename="src/http/server.ts"
+import { Server } from 'exisjs/decorators'
+import type { App } from 'exisjs'
 
-// Mount custom swagger documentation
-swagger({
-  title: 'Custom API',
-  version: '2.0.0',
-  path: '/api/docs',
-  specPath: '/api/docs/spec.json',
-})(app)
+@Server()
+export default class RootServer {
+  async onStart(app: App) {
+    console.log('[API] Swagger documentation ready at /docs')
+  }
+}
 ```
+

package/dist/docs/reference/decorators.mdx

@@ -86,6 +86,10 @@ Parameter decorators automatically extract data from the incoming request and in
 ## 3. Middleware & Pipeline Decorators
 
 - `@Use(...middlewaresOrGuardsOrInterceptorsOrFilters)`: Unified decorator that binds middlewares, guards (`canActivate`), interceptors (`intercept`), or exception filters (`catch`) to a controller class or method.
+- `@UseGuards(...guards)`: Dedicated decorator to apply guards to a class or method.
+- `@UseInterceptors(...interceptors)`: Dedicated decorator to apply interceptors to a class or method.
+- `@UseFilters(...filters)`: Dedicated decorator to apply exception filters to a class or method.
+- `@Catch(...exceptions)`: Class decorator for `ExceptionFilter` implementations declaring handled exception types.
 - `@Upload(fieldName, options?)` / `@UseUpload(...)`: Configures multipart file upload handling for a method, populating `@UploadedFile()` or `@UploadedFiles()`.
 - `@Timeout(ms: number | TimeoutOptions)`: Overrides the request timeout for a class or method (e.g. `@Timeout(120000)`). Passing `0` disables timeouts for long-running streaming or exports.
 - `@Idempotent(options?)`: Caches responses based on the `Idempotency-Key` header using native in-memory off-heap storage. Works at class and method level.
@@ -98,13 +102,32 @@ Parameter decorators automatically extract data from the incoming request and in
 
 ---
 
-## 4. Response & Metadata Modifiers
+## 4. Security & Access Control Decorators
+
+- `@Permissions(...permissions: string[])`: Sets required permission keys for a controller or route method (automatically bypassed if `req.user.isSuperAdmin` is true).
+- `@Roles(...roles: string[])`: Sets required role names for a controller or route method.
+- `@Public()` / `@IsPublic()` / `@AllowAnonymous()`: Marks a controller or route as public, instructing global authentication guards to bypass credential checks.
+
+---
+
+## 5. Service Enhancements: Caching, Transactions & Profiling
+
+- `@Cacheable({ ttl?: number, key?: string | ((...args) => string) })`: Caches method return values in ExisJS's off-heap native memory LRU cache.
+- `@CacheEvict({ key: string | ((...args) => string) })`: Evicts cached entries matching the key when the method completes.
+- `@Transactional(options?)`: Automatically wraps service operations in an atomic database transaction.
+- `@Profile({ thresholdMs?: number, warnSlow?: boolean, log?: Function })`: Profiles method execution time with sub-millisecond precision.
+- `OnInit` (`onInit()`): Invoked when the application or service boots up.
+- `OnDestroy` (`onDestroy()`): Invoked when the application gracefully terminates.
+- `OnModuleInit`, `OnModuleDestroy`, `OnApplicationBootstrap`: Modular lifecycle hooks.
+
+---
+
+## 6. Response & Metadata Modifiers
 
 - `@HttpCode(code: number)`: Enforces a custom HTTP status code on success.
 - `@Header(name: string, value: string)`: Appends an HTTP header to the response.
 - `@Returns(schema)`: Attaches response schema for OpenAPI documentation.
 - `@Redirect(url: string, statusCode?: number)`: Redirects request to target URL.
-- `@Permissions(...permissions: string[])`: Sets required permissions on the route.
 - `@Hosts(...hosts: string[])`: Restricts routes to specific Host headers.
 - `@SetMetadata(key, value)`: Attaches arbitrary custom metadata to a class or handler method, retrievable via `Reflector`.
 - `Reflector`: Utility class to inspect metadata attached by `@SetMetadata`:
@@ -114,7 +137,7 @@ Parameter decorators automatically extract data from the incoming request and in
 
 ---
 
-## 5. Dependency Injection & Modules
+## 7. Dependency Injection & Modules
 
 - `@Module({ imports?, controllers?, providers?, exports? })`: OOP class decorator equivalent to `defineModule()` for structuring application modules.
 - `@Injectable(options?)`: Marks a service class as an IoC provider managed by the container. Supports `{ scope: 'singleton' | 'request' | 'transient' }`.
@@ -125,7 +148,7 @@ Parameter decorators automatically extract data from the incoming request and in
 
 ---
 
-## 6. Cron & Task Scheduling
+## 8. Cron & Task Scheduling
 
 - `@Cron(schedule: string, options?: CronJobOptions)`: Schedules a class method as a recurring cron job on any `@Injectable()` service.
 - `@Interval(ms: number, options?: IntervalOptions)`: Schedules a class method to execute repeatedly every `ms` milliseconds.

package/dist/docs/reference/di.mdx

@@ -145,3 +145,29 @@ export default class UserController {
 }
 ```
 
+---
+
+## Lifecycle Hooks (`OnInit`, `OnDestroy`)
+
+Providers can implement lifecycle interfaces. When the application container initializes or gracefully closes, ExisJS automatically triggers these hooks:
+
+- **`OnInit` (`onInit()` / `onModuleInit()`)**: Executed when the container initializes during `app.create()` or `app.listen()`.
+- **`OnDestroy` (`onDestroy()` / `onModuleDestroy()`)**: Executed when the application receives a termination signal or `app.close()` is called.
+- **`OnApplicationBootstrap` (`onApplicationBootstrap()`)**: Executed after all modules are initialized and before the server begins listening for incoming requests.
+
+```typescript filename="src/http/database/service.ts"
+import { Injectable, type OnInit, type OnDestroy } from 'exisjs/decorators'
+
+@Injectable()
+export class DatabaseService implements OnInit, OnDestroy {
+  async onInit(): Promise<void> {
+    await this.pool.connect()
+  }
+
+  async onDestroy(): Promise<void> {
+    await this.pool.end()
+  }
+}
+```
+
+

package/dist/docs/reference/swagger.mdx

@@ -53,91 +53,174 @@ import {
 Assigns one or more tags to a controller class or method handler.
 *(Alias: `@Tags()`)*
 
-```typescript
+```typescript filename="src/http/users/route.ts"
+import { Controller, Get } from 'exisjs/decorators'
+import { ApiTags } from 'exisjs/swagger'
+
 @ApiTags('Users', 'Authentication')
-@Controller('/users')
-export class UserController {}
+@Controller()
+export default class UserController {
+  @Get('/')
+  findAll() {
+    return []
+  }
+}
 ```
 
 ### `@ApiOperation(options)`
 Attaches summary, description, operationId, and deprecated status to a route method.
 *(Alias: `@Operation()`)*
 
-```typescript
-@Get('/:id')
-@ApiOperation({
-  summary: 'Get user by UUID',
-  description: 'Fetches user details from database',
-  deprecated: false,
-})
-getUser() {}
+```typescript filename="src/http/users/route.ts"
+import { Controller, Get, Param } from 'exisjs/decorators'
+import { ApiOperation } from 'exisjs/swagger'
+
+@Controller()
+export default class UserController {
+  @Get('/:id')
+  @ApiOperation({
+    summary: 'Get user by UUID',
+    description: 'Fetches user details from database',
+    deprecated: false,
+  })
+  getUser(@Param('id') id: string) {
+    return { id, name: 'Alice' }
+  }
+}
 ```
 
 ### `@ApiResponse(options)`
 Defines an expected HTTP response status code and optional schema.
 
-```typescript
-@ApiResponse({
-  status: 200,
-  description: 'User details found',
-  schema: UserResponseSchema,
+```typescript filename="src/http/users/route.ts"
+import { Controller, Get, Param } from 'exisjs/decorators'
+import { ApiOperation, ApiResponse } from 'exisjs/swagger'
+import { tex } from 'exisjs/validator'
+
+const UserSchema = tex.object({
+  id: tex.uuid(),
+  name: tex.string(),
 })
-@ApiResponse({ status: 404, description: 'User not found' })
-getUser() {}
+
+@Controller()
+export default class UserController {
+  @Get('/:id')
+  @ApiResponse({
+    status: 200,
+    description: 'User details found',
+    schema: UserSchema,
+  })
+  @ApiResponse({ status: 404, description: 'User not found' })
+  getUser(@Param('id') id: string) {
+    return { id, name: 'Alice' }
+  }
+}
 ```
 
 ### `@ApiBearerAuth(name?: string)`
 Requires Bearer JWT authentication for this endpoint or controller.
 *(Alias: `@BearerAuth()`)*
 
-```typescript
+```typescript filename="src/http/users/route.ts"
+import { Controller, Get } from 'exisjs/decorators'
+import { ApiBearerAuth } from 'exisjs/swagger'
+
 @ApiBearerAuth()
-@Get('/me')
-getMe() {}
+@Controller()
+export default class UserController {
+  @Get('/me')
+  getMe() {
+    return { id: 'user-123', role: 'admin' }
+  }
+}
 ```
 
 ### `@ApiSecurity(name: string, scopes?: string[])`
 Requires custom security scheme authentication for this endpoint or controller.
 
-```typescript
-@ApiSecurity('apiKeyAuth')
-@Get('/metrics')
-getMetrics() {}
+```typescript filename="src/http/metrics/route.ts"
+import { Controller, Get } from 'exisjs/decorators'
+import { ApiSecurity } from 'exisjs/swagger'
+
+@Controller()
+export default class MetricsController {
+  @Get('/')
+  @ApiSecurity('apiKeyAuth')
+  getMetrics() {
+    return { uptime: process.uptime() }
+  }
+}
 ```
 
 ### `@ApiExclude()`
 Excludes an endpoint or controller class from OpenAPI and Swagger generation.
 
-```typescript
-@Get('/internal')
-@ApiExclude()
-getInternal() {}
+```typescript filename="src/http/internal/route.ts"
+import { Controller, Get } from 'exisjs/decorators'
+import { ApiExclude } from 'exisjs/swagger'
+
+@Controller()
+export default class InternalController {
+  @Get('/health')
+  @ApiExclude()
+  getHealth() {
+    return { status: 'healthy' }
+  }
+}
 ```
 
 ### `@ApiProperty(options?: { description?: string; example?: any; required?: boolean })`
 Annotates a class property with metadata for OpenAPI schema models.
 
+```typescript filename="src/http/users/dto.ts"
+import { ApiProperty } from 'exisjs/swagger'
+
+export class CreateUserDto {
+  @ApiProperty({ description: 'Full name of the user', example: 'Alice Johnson', required: true })
+  name!: string
+
+  @ApiProperty({ description: 'Work email address', example: 'alice@example.com', required: true })
+  email!: string
+}
+```
+
 ---
 
 ## Functions
 
 ### `swagger(config?: SwaggerConfig)`
-Convenience helper to mount Swagger/OpenAPI documentation on an ExisJS App instance.
+Convenience helper to mount Swagger/OpenAPI documentation on an ExisJS App instance (typically inside `onStart` or custom server setups).
 
-```typescript
-import { App } from 'exisjs'
+```typescript filename="src/http/server.ts"
+import { exis } from 'exisjs'
 import { swagger } from 'exisjs/swagger'
 
-const app = new App()
-swagger({ title: 'My API', path: '/docs' })(app)
+export default exis({
+  onStart(app) {
+    swagger({ title: 'My API', path: '/docs' })(app)
+  },
+})
 ```
 
 ### `generateOpenApiSpec(routesOrApp, config)`
-Pure generator function that introspects routes, parameters, Tex/Zod schemas, and returns an `OpenApiSpec` object.
+Pure generator function that introspects routes, parameters, and `TexEngine`/Zod schemas and returns a complete `OpenApiSpec` object.
 
 ```typescript
+import { generateOpenApiSpec } from 'exisjs/swagger'
+
 const spec = generateOpenApiSpec(app, { title: 'My API', version: '1.0.0' })
 ```
 
 ### `renderDocumentationHtml(config)`
 Renders standalone HTML markup for Swagger UI or Scalar API reference.
+
+```typescript
+import { renderDocumentationHtml } from 'exisjs/swagger'
+
+const html = renderDocumentationHtml({
+  title: 'My API',
+  specPath: '/docs/json',
+  ui: 'scalar',
+})
+```
+

package/dist/docs/reference/validator.mdx

@@ -234,7 +234,7 @@ type Profile = ResolveSchema<typeof ProfileSchema>
 
 ## OpenAPI Generation
 
-The `TexEngine` automatically converts validation schemas into strictly compliant OpenAPI/Swagger JSON schemas when attached to routes. This powers zero-config Swagger documentation once `@exisjs/swagger` is added.
+The `TexEngine` automatically converts validation schemas into strictly compliant OpenAPI/Swagger JSON schemas when attached to routes. This powers zero-config Swagger documentation in `exisjs/swagger`.
 
 ---
 

package/dist/error/errors.d.ts

@@ -51,18 +51,30 @@ export declare class ServiceUnavailableError extends HttpError {
 export declare class GatewayTimeoutError extends HttpError {
     constructor(message?: string);
 }
-export declare const HttpException: typeof HttpError;
-export declare const BadRequestException: typeof BadRequestError;
-export declare const UnauthorizedException: typeof UnauthorizedError;
-export declare const ForbiddenException: typeof ForbiddenError;
-export declare const NotFoundException: typeof NotFoundError;
-export declare const ConflictException: typeof ConflictError;
-export declare const PayloadTooLargeException: typeof PayloadTooLargeError;
-export declare const UnprocessableException: typeof UnprocessableError;
-export declare const RateLimitException: typeof RateLimitError;
-export declare const InternalException: typeof InternalError;
-export declare const ServiceUnavailableException: typeof ServiceUnavailableError;
-export declare const GatewayTimeoutException: typeof GatewayTimeoutError;
+export declare class HttpException extends HttpError {
+}
+export declare class BadRequestException extends BadRequestError {
+}
+export declare class UnauthorizedException extends UnauthorizedError {
+}
+export declare class ForbiddenException extends ForbiddenError {
+}
+export declare class NotFoundException extends NotFoundError {
+}
+export declare class ConflictException extends ConflictError {
+}
+export declare class PayloadTooLargeException extends PayloadTooLargeError {
+}
+export declare class UnprocessableException extends UnprocessableError {
+}
+export declare class RateLimitException extends RateLimitError {
+}
+export declare class InternalException extends InternalError {
+}
+export declare class ServiceUnavailableException extends ServiceUnavailableError {
+}
+export declare class GatewayTimeoutException extends GatewayTimeoutError {
+}
 export declare function renderValidationTable(rows: {
     field: string;
     received: string;

package/dist/error/errors.d.ts.map

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

package/dist/error/errors.js

@@ -145,18 +145,42 @@ class GatewayTimeoutError extends HttpError {
 }
 exports.GatewayTimeoutError = GatewayTimeoutError;
 // ─── Exception Aliases ────────────────────────────────────────────────────────
-exports.HttpException = HttpError;
-exports.BadRequestException = BadRequestError;
-exports.UnauthorizedException = UnauthorizedError;
-exports.ForbiddenException = ForbiddenError;
-exports.NotFoundException = NotFoundError;
-exports.ConflictException = ConflictError;
-exports.PayloadTooLargeException = PayloadTooLargeError;
-exports.UnprocessableException = UnprocessableError;
-exports.RateLimitException = RateLimitError;
-exports.InternalException = InternalError;
-exports.ServiceUnavailableException = ServiceUnavailableError;
-exports.GatewayTimeoutException = GatewayTimeoutError;
+class HttpException extends HttpError {
+}
+exports.HttpException = HttpException;
+class BadRequestException extends BadRequestError {
+}
+exports.BadRequestException = BadRequestException;
+class UnauthorizedException extends UnauthorizedError {
+}
+exports.UnauthorizedException = UnauthorizedException;
+class ForbiddenException extends ForbiddenError {
+}
+exports.ForbiddenException = ForbiddenException;
+class NotFoundException extends NotFoundError {
+}
+exports.NotFoundException = NotFoundException;
+class ConflictException extends ConflictError {
+}
+exports.ConflictException = ConflictException;
+class PayloadTooLargeException extends PayloadTooLargeError {
+}
+exports.PayloadTooLargeException = PayloadTooLargeException;
+class UnprocessableException extends UnprocessableError {
+}
+exports.UnprocessableException = UnprocessableException;
+class RateLimitException extends RateLimitError {
+}
+exports.RateLimitException = RateLimitException;
+class InternalException extends InternalError {
+}
+exports.InternalException = InternalException;
+class ServiceUnavailableException extends ServiceUnavailableError {
+}
+exports.ServiceUnavailableException = ServiceUnavailableException;
+class GatewayTimeoutException extends GatewayTimeoutError {
+}
+exports.GatewayTimeoutException = GatewayTimeoutException;
 // ─── Global Error Handler ─────────────────────────────────────────────────────
 function escapeHtml(str) {
     if (typeof str !== 'string')