Modular Imports 📦

AzuraJS supports modular imports for better tree-shaking and smaller bundle sizes. Import only what you need!

JavaScript Note: All imports work the same in JavaScript! Just remove type imports and TypeScript-specific syntax.

Main Package

Import everything from the main package:

import { AzuraClient, applyDecorators } from "azurajs";

Decorators

Import decorators separately:

import { Controller, Get, Post, Put, Delete, Patch } from "azurajs/decorators";
import { Body, Param, Query, Headers, Req, Res } from "azurajs/decorators";

Middleware

Import middleware utilities:

import { createLoggingMiddleware } from "azurajs/middleware";

Types

Import TypeScript types:

import type { RequestServer, ResponseServer } from "azurajs";
// Or use modular import
import type { ConfigTypes } from "azurajs/config";

Plugins

Import plugins separately:

// CORS Plugin
import { cors } from "azurajs/cors";

// Rate Limiting
import { rateLimit } from "azurajs/rate-limit";

Utilities

Import utilities as needed:

// Logger
import { logger } from "azurajs/logger";

// HTTP Error
import { HttpError } from "azurajs/http-error";

// Validators
import { validateDto, validateSchema } from "azurajs/validators";

// Cookies
import { parseCookiesHeader, serializeCookie } from "azurajs/cookies";

Router

Import router separately:

import { Router } from "azurajs/router";

Complete Example

TypeScript

// Main imports
import { AzuraClient, applyDecorators } from "azurajs";

// Decorators
import { Controller, Get, Post, Body, Param, Res } from "azurajs/decorators";

// Middleware
import { createLoggingMiddleware } from "azurajs/middleware";

// Utilities
import { HttpError } from "azurajs/http-error";

// Types
import type { ResponseServer } from "azurajs";
import type { ConfigTypes } from "azurajs/config";

@Controller("/users")
class UserController {
  @Get("/")
  getAll(@Res() res: ResponseServer) {
    res.json({ users: [] });
  }

  @Get("/:id")
  getOne(@Param("id") id: string, @Res() res: ResponseServer) {
    if (id === "0") {
      throw new HttpError(404, "User not found");
    }
    res.json({ id, name: "User" });
  }

  @Post("/")
  create(@Body() body: any, @Res() res: ResponseServer) {
    res.status(201).json({ id: Date.now(), ...body });
  }
}

const app = new AzuraClient();
app.use(createLoggingMiddleware(app.getConfig()));
applyDecorators(app, [UserController]);

await app.listen(3000);

JavaScript

// Main imports
const { AzuraClient } = require("azurajs");

// Middleware
const { createLoggingMiddleware } = require("azurajs/middleware");

// Utilities
const { HttpError } = require("azurajs/http-error");

const app = new AzuraClient();
app.use(createLoggingMiddleware(app.getConfig()));

// Routes
app.get("/users", (req, res) => {
  res.json({ users: [] });
});

app.get("/users/:id", (req, res) => {
  const { id } = req.params;
  if (id === "0") {
    throw new HttpError(404, "User not found");
  }
  res.json({ id, name: "User" });
});

app.post("/users", (req, res) => {
  res.status(201).json({ id: Date.now(), ...req.body });
});

app.listen(3000);

✅ Smaller bundles - Only import what you use
✅ Faster builds - Less code to process
✅ Better organization - Clear module boundaries
✅ Tree-shaking - Dead code elimination
✅ Type safety - Full TypeScript support

Import Comparison

Before (Bundle everything)

import {
  AzuraClient,
  Controller,
  Get,
  Post,
  Body,
  HttpError,
  logger,
  cors,
  rateLimit
} from "azurajs";

Bundle size: ~50KB (everything included)

After (Modular imports)

import { AzuraClient } from "azurajs";
import { Controller, Get, Post, Body } from "azurajs/decorators";
import { HttpError } from "azurajs/http-error";

Bundle size: ~15KB (only what you need)

Migration Guide

If you're using older imports, here's how to migrate:

// Old way
import { validateDto } from "azurajs";

// New way (recommended)
import { validateDto } from "azurajs/validators";

// Old way
import { HttpError } from "azurajs";

// New way (recommended)
import { HttpError } from "azurajs/http-error";

// Old way
import { cors } from "azurajs";

// New way (recommended)
import { cors } from "azurajs/cors";

Both ways work! The main package re-exports everything for convenience, but modular imports are recommended for production builds.

Available Modules

Module	Import Path	Description
Main	`azurajs`	Complete package
Decorators	`azurajs/decorators`	All decorators
Middleware	`azurajs/middleware`	Middleware utilities
Router	`azurajs/router`	Router system
Config	`azurajs/config`	Configuration types
CORS	`azurajs/cors`	CORS plugin
Rate Limit	`azurajs/rate-limit`	Rate limiting
Cookies	`azurajs/cookies`	Cookie utilities
Validators	`azurajs/validators`	Validation functions
Logger	`azurajs/logger`	Logging utility
HTTP Error	`azurajs/http-error`	Error class
Types	`azurajs/types`	Common types

Modular Imports

Modular Imports 📦

Main Package

Decorators

Middleware

Types

Plugins

Utilities

Router

Complete Example

TypeScript

JavaScript

Benefits

Import Comparison

Before (Bundle everything)

After (Modular imports)

Migration Guide

Available Modules

Next Steps 📖

Configuration

Performance

TypeScript

On this page