exisjs 0.7.8 → 0.7.9

package/dist/decorators/security.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AllowAnonymous = exports.IsPublic = void 0;
+exports.Permissions = Permissions;
+exports.Roles = Roles;
+exports.Public = Public;
+const constants_1 = require("./constants");
+const metadata_1 = require("./core/metadata");
+/**
+ * Declares required permission keys for a Controller class or route method.
+ *
+ * @example
+ * ```ts
+ * @Controller('/roles')
+ * export class RolesController {
+ *   @Post('/')
+ *   @Permissions('role:create', 'role:manage')
+ *   async createRole() {}
+ * }
+ * ```
+ */
+function Permissions(...permissions) {
+    return function (target, contextOrPropertyKey, descriptor) {
+        const isStandard = typeof contextOrPropertyKey === 'object' && contextOrPropertyKey !== null;
+        const kind = isStandard ? contextOrPropertyKey.kind : undefined;
+        if (kind === 'class' ||
+            (!isStandard && typeof target === 'function' && !contextOrPropertyKey)) {
+            const proto = target.prototype || target;
+            metadata_1.MetadataEngine.set(proto, constants_1.PERMISSIONS_METADATA, permissions);
+        }
+        else {
+            const fn = isStandard
+                ? target
+                : descriptor
+                    ? descriptor.value
+                    : target[contextOrPropertyKey];
+            metadata_1.MetadataEngine.set(fn, constants_1.PERMISSIONS_METADATA, permissions);
+            const routeMeta = metadata_1.MetadataEngine.init(fn, constants_1.ROUTE_METADATA_PROP, {});
+            routeMeta.permissions = [...(routeMeta.permissions || []), ...permissions];
+        }
+    };
+}
+/**
+ * Declares required roles for a Controller class or route method.
+ *
+ * @example
+ * ```ts
+ * @Controller('/admin')
+ * @Roles('admin', 'superadmin')
+ * export class AdminController {}
+ * ```
+ */
+function Roles(...roles) {
+    return function (target, contextOrPropertyKey, descriptor) {
+        const isStandard = typeof contextOrPropertyKey === 'object' && contextOrPropertyKey !== null;
+        const kind = isStandard ? contextOrPropertyKey.kind : undefined;
+        if (kind === 'class' ||
+            (!isStandard && typeof target === 'function' && !contextOrPropertyKey)) {
+            const proto = target.prototype || target;
+            metadata_1.MetadataEngine.set(proto, constants_1.ROLES_METADATA, roles);
+        }
+        else {
+            const fn = isStandard
+                ? target
+                : descriptor
+                    ? descriptor.value
+                    : target[contextOrPropertyKey];
+            metadata_1.MetadataEngine.set(fn, constants_1.ROLES_METADATA, roles);
+            const routeMeta = metadata_1.MetadataEngine.init(fn, constants_1.ROUTE_METADATA_PROP, {});
+            routeMeta.roles = [...(routeMeta.roles || []), ...roles];
+        }
+    };
+}
+/**
+ * Marks a Controller class or route method as public, bypassing global authentication guards.
+ *
+ * @example
+ * ```ts
+ * @Controller('/auth')
+ * export class AuthController {
+ *   @Post('/login')
+ *   @Public()
+ *   async login() {}
+ * }
+ * ```
+ */
+function Public() {
+    return function (target, contextOrPropertyKey, descriptor) {
+        const isStandard = typeof contextOrPropertyKey === 'object' && contextOrPropertyKey !== null;
+        const kind = isStandard ? contextOrPropertyKey.kind : undefined;
+        if (kind === 'class' ||
+            (!isStandard && typeof target === 'function' && !contextOrPropertyKey)) {
+            const proto = target.prototype || target;
+            metadata_1.MetadataEngine.set(proto, constants_1.IS_PUBLIC_METADATA, true);
+        }
+        else {
+            const fn = isStandard
+                ? target
+                : descriptor
+                    ? descriptor.value
+                    : target[contextOrPropertyKey];
+            metadata_1.MetadataEngine.set(fn, constants_1.IS_PUBLIC_METADATA, true);
+            const routeMeta = metadata_1.MetadataEngine.init(fn, constants_1.ROUTE_METADATA_PROP, {});
+            routeMeta.isPublic = true;
+        }
+    };
+}
+exports.IsPublic = Public;
+exports.AllowAnonymous = Public;
+//# sourceMappingURL=security.js.map

package/dist/decorators/security.js.map

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

package/dist/decorators/transaction.d.ts

@@ -0,0 +1,29 @@
+export interface TransactionalOptions {
+    /** Optional named database connection */
+    connection?: string;
+    /** Whether the transaction is read-only */
+    readOnly?: boolean;
+}
+/**
+ * Automatically wraps a service method inside a database transaction.
+ * Commits automatically on success, and rolls back if an unhandled exception is thrown.
+ *
+ * Compatible with ExisJS built-in Database client, Prisma, Drizzle, TypeORM, Knex, and raw SQL pools.
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * export class OrderService {
+ *   constructor(private db: DatabaseService) {}
+ *
+ *   @Transactional()
+ *   async placeOrder(userId: string, items: CartItem[]) {
+ *     const order = await this.db.orders.create({ userId })
+ *     await this.db.inventory.decrement(items)
+ *     return order
+ *   }
+ * }
+ * ```
+ */
+export declare function Transactional(_options?: TransactionalOptions): MethodDecorator;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/decorators/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/decorators/transaction.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,GAAE,oBAAyB,GAClC,eAAe,CAmEjB"}

package/dist/decorators/transaction.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transactional = Transactional;
+/**
+ * Automatically wraps a service method inside a database transaction.
+ * Commits automatically on success, and rolls back if an unhandled exception is thrown.
+ *
+ * Compatible with ExisJS built-in Database client, Prisma, Drizzle, TypeORM, Knex, and raw SQL pools.
+ *
+ * @example
+ * ```ts
+ * @Injectable()
+ * export class OrderService {
+ *   constructor(private db: DatabaseService) {}
+ *
+ *   @Transactional()
+ *   async placeOrder(userId: string, items: CartItem[]) {
+ *     const order = await this.db.orders.create({ userId })
+ *     await this.db.inventory.decrement(items)
+ *     return order
+ *   }
+ * }
+ * ```
+ */
+function Transactional(_options = {}) {
+    return function (_target, _propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const self = this;
+            const db = self.db ||
+                self.database ||
+                self.prisma ||
+                self.dataSource ||
+                self.connection ||
+                globalThis.__EXIS_DB__;
+            if (db) {
+                // 1. Functional transaction wrapper: db.transaction((tx) => ...)
+                if (typeof db.transaction === 'function') {
+                    return db.transaction(async (tx) => {
+                        const originalDb = self.db;
+                        try {
+                            self.db = tx;
+                            return await originalMethod.apply(self, args);
+                        }
+                        finally {
+                            self.db = originalDb;
+                        }
+                    });
+                }
+                // 2. Prisma-style $transaction: db.$transaction(async (tx) => ...)
+                if (typeof db.$transaction === 'function') {
+                    return db.$transaction(async (tx) => {
+                        const originalPrisma = self.prisma || self.db;
+                        try {
+                            if (self.prisma)
+                                self.prisma = tx;
+                            if (self.db)
+                                self.db = tx;
+                            return await originalMethod.apply(self, args);
+                        }
+                        finally {
+                            if (self.prisma)
+                                self.prisma = originalPrisma;
+                            if (self.db)
+                                self.db = originalPrisma;
+                        }
+                    });
+                }
+                // 3. Imperative beginTransaction / commit / rollback
+                if (typeof db.beginTransaction === 'function') {
+                    await db.beginTransaction();
+                    try {
+                        const result = await originalMethod.apply(self, args);
+                        if (typeof db.commit === 'function')
+                            await db.commit();
+                        return result;
+                    }
+                    catch (error) {
+                        if (typeof db.rollback === 'function')
+                            await db.rollback();
+                        throw error;
+                    }
+                }
+            }
+            // Default pass-through if no transaction provider is attached
+            return originalMethod.apply(self, args);
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=transaction.js.map

package/dist/decorators/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/decorators/transaction.ts"],"names":[],"mappings":";;AA4BA,sCAqEC;AA1FD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,aAAa,CAC3B,WAAiC,EAAE;IAEnC,OAAO,UACL,OAAY,EACZ,YAA6B,EAC7B,UAA8B;QAE9B,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAA;QAEvC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAW;YAC/C,MAAM,IAAI,GAAG,IAAW,CAAA;YACxB,MAAM,EAAE,GACN,IAAI,CAAC,EAAE;gBACP,IAAI,CAAC,QAAQ;gBACb,IAAI,CAAC,MAAM;gBACX,IAAI,CAAC,UAAU;gBACf,IAAI,CAAC,UAAU;gBACd,UAAkB,CAAC,WAAW,CAAA;YAEjC,IAAI,EAAE,EAAE,CAAC;gBACP,iEAAiE;gBACjE,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;oBACzC,OAAO,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAO,EAAE,EAAE;wBACtC,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAA;wBAC1B,IAAI,CAAC;4BACH,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;4BACZ,OAAO,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;wBAC/C,CAAC;gCAAS,CAAC;4BACT,IAAI,CAAC,EAAE,GAAG,UAAU,CAAA;wBACtB,CAAC;oBACH,CAAC,CAAC,CAAA;gBACJ,CAAC;gBAED,mEAAmE;gBACnE,IAAI,OAAO,EAAE,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;oBAC1C,OAAO,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,EAAO,EAAE,EAAE;wBACvC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAA;wBAC7C,IAAI,CAAC;4BACH,IAAI,IAAI,CAAC,MAAM;gCAAE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;4BACjC,IAAI,IAAI,CAAC,EAAE;gCAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;4BACzB,OAAO,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;wBAC/C,CAAC;gCAAS,CAAC;4BACT,IAAI,IAAI,CAAC,MAAM;gCAAE,IAAI,CAAC,MAAM,GAAG,cAAc,CAAA;4BAC7C,IAAI,IAAI,CAAC,EAAE;gCAAE,IAAI,CAAC,EAAE,GAAG,cAAc,CAAA;wBACvC,CAAC;oBACH,CAAC,CAAC,CAAA;gBACJ,CAAC;gBAED,qDAAqD;gBACrD,IAAI,OAAO,EAAE,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;oBAC9C,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAA;oBAC3B,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;wBACrD,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,UAAU;4BAAE,MAAM,EAAE,CAAC,MAAM,EAAE,CAAA;wBACtD,OAAO,MAAM,CAAA;oBACf,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,IAAI,OAAO,EAAE,CAAC,QAAQ,KAAK,UAAU;4BAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAA;wBAC1D,MAAM,KAAK,CAAA;oBACb,CAAC;gBACH,CAAC;YACH,CAAC;YAED,8DAA8D;YAC9D,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC,CAAA;QAED,OAAO,UAAU,CAAA;IACnB,CAAC,CAAA;AACH,CAAC"}

package/dist/di/container.d.ts

@@ -22,5 +22,7 @@ export declare class Container {
     clearCache(): void;
     instantiateClass<T>(TargetClass: new (...args: any[]) => T, requestCache?: Map<ProviderToken, any>): T;
     resolve<T>(token: ProviderToken<T>, requestCache?: Map<ProviderToken, any>): T;
+    initLifecycle(): Promise<void>;
+    destroyLifecycle(signal?: string): Promise<void>;
 }
 //# sourceMappingURL=container.d.ts.map

package/dist/di/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/di/container.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,GAAG,IAC/B,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,CAAA;CAC9C;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,YAAY;IACpD,QAAQ,EAAE,CAAC,CAAA;CACZ;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,YAAY;IACtD,UAAU,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,YAAY;IACpD,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;CACpC;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC9B,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAE9D,eAAO,MAAM,eAAe,eAAqC,CAAA;AACjE,eAAO,MAAM,iBAAiB,eAAuC,CAAA;AACrE,eAAO,MAAM,cAAc,eAA6B,CAAA;AAExD,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,cAAc,CAAgC;IAEtD,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1E,UAAU,IAAI,IAAI;IAIlB,gBAAgB,CAAC,CAAC,EAChB,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EACtC,YAAY,CAAC,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,GACrC,CAAC;IAmDJ,OAAO,CAAC,CAAC,EACP,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,YAAY,CAAC,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,GACrC,CAAC;CAkGL"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/di/container.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,GAAG,IAC/B,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,CAAA;CAC9C;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,YAAY;IACpD,QAAQ,EAAE,CAAC,CAAA;CACZ;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,YAAY;IACtD,UAAU,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,YAAY;IACpD,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;CACpC;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC9B,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAE9D,eAAO,MAAM,eAAe,eAAqC,CAAA;AACjE,eAAO,MAAM,iBAAiB,eAAuC,CAAA;AACrE,eAAO,MAAM,cAAc,eAA6B,CAAA;AAExD,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,cAAc,CAAgC;IAEtD,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1E,UAAU,IAAI,IAAI;IAIlB,gBAAgB,CAAC,CAAC,EAChB,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EACtC,YAAY,CAAC,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,GACrC,CAAC;IAmDJ,OAAO,CAAC,CAAC,EACP,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,YAAY,CAAC,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,GACrC,CAAC;IAmGS,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAe9D"}

package/dist/di/container.js

@@ -135,6 +135,36 @@ class Container {
         }
         return resolvedValue;
     }
+    async initLifecycle() {
+        for (const [, instance] of this.singletonCache) {
+            if (instance && typeof instance === 'object') {
+                if (typeof instance.onInit === 'function') {
+                    await instance.onInit();
+                }
+                if (typeof instance.onModuleInit === 'function') {
+                    await instance.onModuleInit();
+                }
+                if (typeof instance.onApplicationBootstrap === 'function') {
+                    await instance.onApplicationBootstrap();
+                }
+            }
+        }
+    }
+    async destroyLifecycle(signal) {
+        for (const [, instance] of this.singletonCache) {
+            if (instance && typeof instance === 'object') {
+                if (typeof instance.onDestroy === 'function') {
+                    await instance.onDestroy();
+                }
+                if (typeof instance.onModuleDestroy === 'function') {
+                    await instance.onModuleDestroy();
+                }
+                if (typeof instance.onApplicationShutdown === 'function') {
+                    await instance.onApplicationShutdown(signal);
+                }
+            }
+        }
+    }
 }
 exports.Container = Container;
 //# sourceMappingURL=container.js.map

package/dist/di/container.js.map

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

package/dist/docs/content/decorators.mdx

@@ -178,6 +178,10 @@ export default class CheckoutController {
 
 ### Available Lifecycle & Middleware Decorators
 - `@Use(...items)` — Unified decorator that attaches middlewares, guards (`canActivate`), interceptors (`intercept`), or exception filters (`catch`) to a class or method.
+- `@UseGuards(...guards)` — Explicit alias for `@Use` dedicated to route guards.
+- `@UseInterceptors(...interceptors)` — Explicit alias for `@Use` dedicated to interceptors.
+- `@UseFilters(...filters)` — Explicit alias for `@Use` dedicated to exception filters.
+- `@Catch(...exceptions)` — Declares exception classes handled by an Exception Filter.
 - `@Timeout(ms: number | TimeoutOptions)` — Overrides the request timeout for a class or method.
 - `@Idempotent(options?)` — Caches responses based on the `Idempotency-Key` header using native in-memory off-heap storage.
 - `@RateLimit(options?)` — Enforces request rate limits on a controller class or route method.
@@ -190,7 +194,88 @@ export default class CheckoutController {
 
 ---
 
-## 5. Response & Metadata Modifiers
+## 5. Security & Authorization Decorators
+
+Declare access control rules directly on controller classes and route methods:
+
+```typescript filename="src/http/roles/route.ts"
+import { Controller, Get, Post, Body, Use, Permissions, Roles, Public } from 'exisjs/decorators'
+import { AuthGuard } from '@/common/guards/auth.guard'
+
+@Controller('/roles')
+@Use(AuthGuard) // Enforced on all routes in this controller
+export default class RolesController {
+  @Get('/public')
+  @Public() // Bypasses auth guard for public inspection
+  async getPublicInfo() {
+    return { status: 'public' }
+  }
+
+  @Get('/')
+  @Roles('admin', 'manager') // Requires user to have admin or manager role
+  async getRoles() {
+    return { roles: [] }
+  }
+
+  @Post('/')
+  @Permissions('role:create', 'role:manage') // Granular permission check
+  async createRole(@Body() body: any) {
+    return { success: true }
+  }
+}
+```
+
+### Available Security Decorators
+- `@Permissions(...permissions: string[])` — Declares required permissions (auto-bypassed when `req.user.isSuperAdmin` is true).
+- `@Roles(...roles: string[])` — Declares required role names.
+- `@Public()` / `@IsPublic()` / `@AllowAnonymous()` — Marks an endpoint or controller as public, instructing global auth guards to skip credential verification.
+
+---
+
+## 6. Service Enhancements: Caching, Transactions & Profiling
+
+ExisJS provides high-performance method decorators for `@Injectable()` services:
+
+```typescript filename="src/http/orders/service.ts"
+import { Injectable, Cacheable, CacheEvict, Transactional, Profile, type OnInit, type OnDestroy } from 'exisjs/decorators'
+
+@Injectable()
+export class OrderService implements OnInit, OnDestroy {
+  async onInit() {
+    console.log('OrderService initialized')
+  }
+
+  async onDestroy() {
+    console.log('OrderService destroyed')
+  }
+
+  // Caches result in off-heap Rust cache for 300 seconds
+  @Cacheable({ ttl: 300, key: (id: string) => `order:${id}` })
+  @Profile({ thresholdMs: 50, warnSlow: true })
+  async getOrder(id: string) {
+    return this.db.query('SELECT * FROM orders WHERE id = $1', [id])
+  }
+
+  // Automatically runs in a database transaction and evicts cached entries
+  @Transactional()
+  @CacheEvict({ key: (id: string) => `order:${id}` })
+  async updateOrder(id: string, data: any) {
+    return this.db.update('orders', id, data)
+  }
+}
+```
+
+### Available Service Decorators & Lifecycle Interfaces
+- `@Cacheable({ ttl?: number, key?: string | ((...args) => string) })` — Caches method return values in off-heap memory.
+- `@CacheEvict({ key: string | ((...args) => string) })` — Evicts cached keys on mutation.
+- `@Transactional(options?)` — Wraps service operations in an atomic database transaction.
+- `@Profile({ thresholdMs?: number, warnSlow?: boolean, log?: Function })` — Measures method execution time with sub-millisecond precision.
+- `OnInit` (`onInit()`) & `OnDestroy` (`onDestroy()`) — Service startup and shutdown lifecycle hooks.
+- `OnModuleInit`, `OnModuleDestroy`, `OnApplicationBootstrap` — Module lifecycle hooks.
+
+---
+
+## 7. Response & Metadata Modifiers
 
 Modify HTTP response status codes, redirect clients, or set headers declaratively:
 
@@ -219,14 +304,13 @@ export default class ApiController {
 - `@Header(name: string, value: string)` — Injects a response header.
 - `@Returns(schema)` — Attaches response schema for OpenAPI/Swagger generation.
 - `@Redirect(url: string, statusCode?: number)` — Redirects the client.
-- `@Permissions(...permissions: string[])` — Attaches route permissions metadata.
 - `@Hosts(...hosts: string[])` — Restricts route/controller to specific Host headers.
 - `@SetMetadata(key, value)` — Attaches custom metadata to a class or method.
-- `Reflector` — Static utility to inspect metadata attached via `@SetMetadata` across classes and methods (`Reflector.get`, `Reflector.getAllAndOverride`, `Reflector.getAllAndMerge`).
+- `Reflector` — Static utility to inspect metadata attached via `@SetMetadata` across classes and methods.
 
 ---
 
-## 6. Dependency Injection & Modules
+## 8. Dependency Injection & Modules
 
 To mark a service class as an injectable provider for the IoC container, use the `@Injectable()` decorator. ExisJS supports `singleton` (default), `request`, and `transient` scopes:
 
@@ -281,3 +365,4 @@ import { UserService } from './service'
 })
 export class UsersModule {}
 ```
+

package/dist/docs/content/errors.mdx

@@ -335,26 +335,42 @@ export default controller({
 
 ### Class-Based (OOP) Paradigm
 
-```typescript filename="src/http/users/route.ts"
-import { Controller, Get, UseFilters } from 'exisjs/decorators'
-import type { Request, Response } from 'exisjs/router'
-
-function localErrorHandler(err: any, req: Request, res: Response, next: any) {
-  console.log('Users Controller Error Handler Caught:', err.message)
-  res.status(400).json({ success: false, localError: err.message })
+You can use function handlers or structured class-based `ExceptionFilter` implementations with `@Catch()`:
+
+```typescript filename="src/http/filters/not-found.filter.ts"
+import { Catch, type ExceptionFilter, type ArgumentsHost } from 'exisjs/decorators'
+import { NotFoundException } from 'exisjs/error'
+
+@Catch(NotFoundException)
+export class NotFoundExceptionFilter implements ExceptionFilter<NotFoundException> {
+  catch(exception: NotFoundException, host: ArgumentsHost) {
+    const { res } = host
+    res.status(404).json({
+      statusCode: 404,
+      error: 'Not Found',
+      message: exception.message,
+      timestamp: new Date().toISOString(),
+    })
+  }
 }
+```
 
-@Controller()
-@UseFilters(localErrorHandler)
+```typescript filename="src/http/users/route.ts"
+import { Controller, Get, UseFilters, Use } from 'exisjs/decorators'
+import { NotFoundException } from 'exisjs/error'
+import { NotFoundExceptionFilter } from '../filters/not-found.filter'
+
+@Controller('/users')
+@Use(NotFoundExceptionFilter) // or @UseFilters(NotFoundExceptionFilter)
 export default class UsersController {
-  @Get('/crash')
-  async crash() {
-    throw new Error("Something went wrong in the users module")
+  @Get('/:id')
+  async getUser() {
+    throw new NotFoundException('User')
   }
 }
 ```
 
-By combining Exception Filters and Local Error Hooks, ExisJS gives you control over your error boundaries.
+By combining Exception Filters and Local Error Hooks, ExisJS gives you complete control over your error boundaries.
 
 ## Observability (BYOM/BYOT)
 

package/dist/docs/content/providers.mdx

@@ -78,6 +78,54 @@ const app = getActiveApp()
 const usersService = app.container.resolve(UsersService)
 ```
 
+## Service Lifecycle Hooks
+
+ExisJS `@Injectable()` services can implement lifecycle interfaces. When the application starts up or shuts down gracefully, ExisJS automatically triggers these hooks on all managed singletons:
+
+```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> {
+    // Invoked automatically during app startup (app.create / app.listen)
+    await this.connectPool()
+  }
+
+  async onDestroy(): Promise<void> {
+    // Invoked automatically during graceful termination (app.close / SIGINT / SIGTERM)
+    await this.drainPool()
+  }
+}
+```
+
+## Service Method Enhancements
+
+You can supercharge service methods with off-heap caching, automated transaction wrapping, and SLA performance profiling:
+
+```typescript filename="src/http/users/service.ts"
+import { Injectable, Cacheable, CacheEvict, Transactional, Profile } from 'exisjs/decorators'
+
+@Injectable()
+export class UsersService {
+  constructor(private db: DatabaseService) {}
+
+  // Caches return values off-heap in Rust LRU cache
+  @Cacheable({ ttl: 300, key: (id: string) => `user:${id}` })
+  @Profile({ thresholdMs: 100, warnSlow: true })
+  async findById(id: string) {
+    return this.db.query('SELECT * FROM users WHERE id = $1', [id])
+  }
+
+  // Runs in an atomic transaction; automatically rolls back on error
+  @Transactional()
+  @CacheEvict({ key: (id: string) => `user:${id}` })
+  async updateUser(id: string, data: any) {
+    return this.db.update('users', id, data)
+  }
+}
+```
+
 ## Custom Providers
 
 ExisJS's DI container is flexible. By default, when you register a class, ExisJS instantiates it for you. However, you often need more control. You can register standard classes, raw values, factories, or aliased classes natively using `app.provide()`.

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.