exisjs 0.7.0 → 0.7.1

package/dist/di/container.d.ts

@@ -1,6 +1,6 @@
 export type ProviderToken<T = any> = string | symbol | (new (...args: any[]) => T);
 export interface BaseProvider {
-    scope?: 'singleton' | 'request';
+    scope?: 'singleton' | 'request' | 'transient';
 }
 export interface ValueProvider<T> extends BaseProvider {
     useValue: T;
@@ -12,11 +12,15 @@ export interface ClassProvider<T> extends BaseProvider {
     useClass: new (...args: any[]) => T;
 }
 export type ProviderDefinition<T> = ValueProvider<T> | FactoryProvider<T> | ClassProvider<T> | T;
+export declare const INJECT_METADATA: unique symbol;
+export declare const OPTIONAL_METADATA: unique symbol;
+export declare const SCOPE_METADATA: unique symbol;
 export declare class Container {
     private providers;
     private singletonCache;
     provide<T>(token: ProviderToken<T>, provider: ProviderDefinition<T>): void;
     clearCache(): void;
+    instantiateClass<T>(TargetClass: new (...args: any[]) => T, requestCache?: Map<ProviderToken, any>): T;
     resolve<T>(token: ProviderToken<T>, requestCache?: Map<ProviderToken, any>): T;
 }
 //# 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,CAAA;CAChC;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,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,OAAO,CAAC,CAAC,EACP,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,YAAY,CAAC,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,GACrC,CAAC;CAgFL"}
+{"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;CA6FL"}

package/dist/di/container.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Container = void 0;
+exports.Container = exports.SCOPE_METADATA = exports.OPTIONAL_METADATA = exports.INJECT_METADATA = void 0;
+exports.INJECT_METADATA = Symbol.for('exisjs:inject_tokens');
+exports.OPTIONAL_METADATA = Symbol.for('exisjs:optional_tokens');
+exports.SCOPE_METADATA = Symbol.for('exisjs:scope');
 class Container {
     constructor() {
         this.providers = new Map();
@@ -13,6 +16,46 @@ class Container {
     clearCache() {
         this.singletonCache.clear();
     }
+    instantiateClass(TargetClass, requestCache) {
+        const injectTokens = TargetClass[exports.INJECT_METADATA] ||
+            (TargetClass.prototype &&
+                TargetClass.prototype[exports.INJECT_METADATA]) ||
+            {};
+        const optionalParams = TargetClass[exports.OPTIONAL_METADATA] ||
+            (TargetClass.prototype &&
+                TargetClass.prototype[exports.OPTIONAL_METADATA]) ||
+            new Set();
+        const maxIndex = Object.keys(injectTokens).reduce((max, curr) => Math.max(max, Number(curr)), -1);
+        if (maxIndex === -1 && optionalParams.size === 0) {
+            return new TargetClass();
+        }
+        const args = [];
+        const totalParams = Math.max(maxIndex + 1, ...Array.from(optionalParams).map((idx) => idx + 1));
+        for (let i = 0; i < totalParams; i++) {
+            const token = injectTokens[i];
+            const isOptional = optionalParams.has(i);
+            if (token !== undefined) {
+                try {
+                    args.push(this.resolve(token, requestCache));
+                }
+                catch (err) {
+                    if (isOptional) {
+                        args.push(undefined);
+                    }
+                    else {
+                        throw err;
+                    }
+                }
+            }
+            else if (isOptional) {
+                args.push(undefined);
+            }
+            else {
+                args.push(undefined);
+            }
+        }
+        return new TargetClass(...args);
+    }
     resolve(token, requestCache) {
         // 1. Check singleton cache
         if (this.singletonCache.has(token)) {
@@ -26,9 +69,11 @@ class Container {
         if (provider === undefined) {
             if (typeof token === 'function') {
                 try {
-                    const SCOPE_METADATA = Symbol.for('exisjs:scope');
-                    const scope = token.prototype[SCOPE_METADATA] || 'singleton';
-                    const instance = new token();
+                    const scope = token.prototype?.[exports.SCOPE_METADATA] || 'singleton';
+                    const instance = this.instantiateClass(token, requestCache);
+                    if (scope === 'transient') {
+                        return instance;
+                    }
                     if (scope === 'request') {
                         if (!requestCache) {
                             throw new Error(`Cannot resolve request-scoped provider '${String(token)}' outside of a request context. This usually happens if you try to resolve a request-scoped dependency during app startup, inside a background job, or without passing the request context cache.`);
@@ -52,8 +97,8 @@ class Container {
         let resolvedValue;
         let scope = 'singleton';
         if (provider && typeof provider === 'object') {
-            if ('scope' in provider && provider.scope === 'request') {
-                scope = 'request';
+            if ('scope' in provider && provider.scope) {
+                scope = provider.scope;
             }
             if ('useValue' in provider) {
                 resolvedValue = provider.useValue;
@@ -62,15 +107,18 @@ class Container {
                 resolvedValue = provider.useFactory();
             }
             else if ('useClass' in provider) {
-                resolvedValue = new provider.useClass();
+                resolvedValue = this.instantiateClass(provider.useClass, requestCache);
             }
             else {
-                resolvedValue = provider; // For T that happens to be an object without these keys
+                resolvedValue = provider;
             }
         }
         else {
             resolvedValue = provider;
         }
+        if (scope === 'transient') {
+            return resolvedValue;
+        }
         if (scope === 'request') {
             if (!requestCache) {
                 throw new Error(`Cannot resolve request-scoped provider '${String(token)}' outside of a request context. This usually happens if you try to resolve a request-scoped dependency during app startup, inside a background job, or without passing the request context cache.`);

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/di/decorators.d.ts

@@ -0,0 +1,30 @@
+import { ProviderToken } from './container';
+/**
+ * Parameter decorator that specifies a dependency token to inject into a class constructor.
+ *
+ * Example:
+ * ```ts
+ * class UserService {
+ *   constructor(
+ *     @Inject('DATABASE_URL') private dbUrl: string,
+ *     @Inject(LoggerService) private logger: LoggerService
+ *   ) {}
+ * }
+ * ```
+ */
+export declare function Inject(token: ProviderToken): ParameterDecorator;
+/**
+ * Parameter decorator that marks a dependency as optional.
+ * If the dependency cannot be resolved, `undefined` is injected instead of throwing an error.
+ *
+ * Example:
+ * ```ts
+ * class NotificationService {
+ *   constructor(
+ *     @Inject('SLACK_WEBHOOK') @Optional() private webhook?: string
+ *   ) {}
+ * }
+ * ```
+ */
+export declare function Optional(): ParameterDecorator;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/di/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,aAAa,EAAE,MAAM,aAAa,CAAA;AAE/E;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,kBAAkB,CAmB/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,IAAI,kBAAkB,CAkB7C"}

package/dist/di/decorators.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Inject = Inject;
+exports.Optional = Optional;
+const container_1 = require("./container");
+/**
+ * Parameter decorator that specifies a dependency token to inject into a class constructor.
+ *
+ * Example:
+ * ```ts
+ * class UserService {
+ *   constructor(
+ *     @Inject('DATABASE_URL') private dbUrl: string,
+ *     @Inject(LoggerService) private logger: LoggerService
+ *   ) {}
+ * }
+ * ```
+ */
+function Inject(token) {
+    return function (target, propertyKey, parameterIndex) {
+        // For constructor parameters, propertyKey is undefined and target is the constructor function
+        const targetObj = propertyKey !== undefined ? target : target;
+        const currentTokens = (targetObj[container_1.INJECT_METADATA] =
+            targetObj[container_1.INJECT_METADATA] || {});
+        currentTokens[parameterIndex] = token;
+        // Also attach to prototype just in case target varies across transpiler settings
+        if (targetObj.prototype) {
+            const protoTokens = (targetObj.prototype[container_1.INJECT_METADATA] =
+                targetObj.prototype[container_1.INJECT_METADATA] || {});
+            protoTokens[parameterIndex] = token;
+        }
+    };
+}
+/**
+ * Parameter decorator that marks a dependency as optional.
+ * If the dependency cannot be resolved, `undefined` is injected instead of throwing an error.
+ *
+ * Example:
+ * ```ts
+ * class NotificationService {
+ *   constructor(
+ *     @Inject('SLACK_WEBHOOK') @Optional() private webhook?: string
+ *   ) {}
+ * }
+ * ```
+ */
+function Optional() {
+    return function (target, propertyKey, parameterIndex) {
+        const targetObj = propertyKey !== undefined ? target : target;
+        const currentOptional = (targetObj[container_1.OPTIONAL_METADATA] =
+            targetObj[container_1.OPTIONAL_METADATA] || new Set());
+        currentOptional.add(parameterIndex);
+        if (targetObj.prototype) {
+            const protoOptional = (targetObj.prototype[container_1.OPTIONAL_METADATA] = targetObj.prototype[container_1.OPTIONAL_METADATA] || new Set());
+            protoOptional.add(parameterIndex);
+        }
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/di/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/di/decorators.ts"],"names":[],"mappings":";;AAeA,wBAmBC;AAeD,4BAkBC;AAnED,2CAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,SAAgB,MAAM,CAAC,KAAoB;IACzC,OAAO,UACL,MAAW,EACX,WAAwC,EACxC,cAAsB;QAEtB,8FAA8F;QAC9F,MAAM,SAAS,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;QAC7D,MAAM,aAAa,GAAG,CAAC,SAAS,CAAC,2BAAe,CAAC;YAC/C,SAAS,CAAC,2BAAe,CAAC,IAAI,EAAE,CAAC,CAAA;QACnC,aAAa,CAAC,cAAc,CAAC,GAAG,KAAK,CAAA;QAErC,iFAAiF;QACjF,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACxB,MAAM,WAAW,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,2BAAe,CAAC;gBACvD,SAAS,CAAC,SAAS,CAAC,2BAAe,CAAC,IAAI,EAAE,CAAC,CAAA;YAC7C,WAAW,CAAC,cAAc,CAAC,GAAG,KAAK,CAAA;QACrC,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,QAAQ;IACtB,OAAO,UACL,MAAW,EACX,WAAwC,EACxC,cAAsB;QAEtB,MAAM,SAAS,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;QAC7D,MAAM,eAAe,GAAgB,CAAC,SAAS,CAAC,6BAAiB,CAAC;YAChE,SAAS,CAAC,6BAAiB,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC,CAAA;QACpD,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAEnC,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACxB,MAAM,aAAa,GAAgB,CAAC,SAAS,CAAC,SAAS,CACrD,6BAAiB,CAClB,GAAG,SAAS,CAAC,SAAS,CAAC,6BAAiB,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC,CAAA;YAChE,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QACnC,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/di/index.d.ts

@@ -1,4 +1,5 @@
 export { inject } from './inject';
 export { Container } from './container';
+export { Inject, Optional } from './decorators';
 export type { ProviderToken, ProviderDefinition, ValueProvider, FactoryProvider, ClassProvider, } from './container';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/di/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/di/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC/C,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAA"}

package/dist/di/index.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Container = exports.inject = void 0;
+exports.Optional = exports.Inject = exports.Container = exports.inject = void 0;
 var inject_1 = require("./inject");
 Object.defineProperty(exports, "inject", { enumerable: true, get: function () { return inject_1.inject; } });
 var container_1 = require("./container");
 Object.defineProperty(exports, "Container", { enumerable: true, get: function () { return container_1.Container; } });
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "Inject", { enumerable: true, get: function () { return decorators_1.Inject; } });
+Object.defineProperty(exports, "Optional", { enumerable: true, get: function () { return decorators_1.Optional; } });
 //# sourceMappingURL=index.js.map

package/dist/di/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/di/index.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AAAxB,gGAAA,MAAM,OAAA;AACf,yCAAuC;AAA9B,sGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/di/index.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AAAxB,gGAAA,MAAM,OAAA;AACf,yCAAuC;AAA9B,sGAAA,SAAS,OAAA;AAClB,2CAA+C;AAAtC,oGAAA,MAAM,OAAA;AAAE,sGAAA,QAAQ,OAAA"}

package/dist/di/inject.d.ts

@@ -1,3 +1,4 @@
+import type { ProviderToken } from './container';
 /**
  * Injects a dependency from the Exis Application container.
  * Must be called inside an active route or middleware context.
@@ -15,5 +16,5 @@
  * @return {T} The resolved dependency
  * @public
  */
-export declare function inject<T>(token: (new (...args: any[]) => T) | string): T;
+export declare function inject<T>(token: ProviderToken<T>): T;
 //# sourceMappingURL=inject.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/di/inject.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAQxE"}
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/di/inject.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAQpD"}

package/dist/di/inject.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../src/di/inject.ts"],"names":[],"mappings":";;AAmBA,wBAQC;AA3BD,+CAAoD;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,MAAM,CAAI,KAA2C;IACnE,MAAM,KAAK,GAAG,0BAAgB,CAAC,QAAQ,EAAE,CAAA;IACzC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;AAChD,CAAC"}
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../src/di/inject.ts"],"names":[],"mappings":";;AAoBA,wBAQC;AA5BD,+CAAoD;AAGpD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,MAAM,CAAI,KAAuB;IAC/C,MAAM,KAAK,GAAG,0BAAgB,CAAC,QAAQ,EAAE,CAAA;IACzC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;AAChD,CAAC"}

package/dist/docs/content/decorators.mdx

@@ -132,18 +132,25 @@ export default class UsersController {
 ### Available Parameter Decorators
 - `@Body(nameOrPipe?)` — Extracts `req.body` or runs through a validation schema/pipe.
 - `@Param(nameOrPipe?)` — Extracts a route path param (e.g. `:id`).
+- `@QueryParam(nameOrPipe?)` / `@Query(nameOrPipe?)` — Extracts a query parameter from the URL query string.
 - `@Headers(nameOrPipe?)` — Extracts a request header by name.
 - `@HostParam(nameOrPipe?)` — Extracts a host subdomain parameter.
 - `@Req()` — Injects the raw request object.
 - `@Res(options?)` — Injects the response object (e.g. `{ passthrough: true }`).
 - `@Ip()` — Injects the client IP address.
 - `@Next()` — Injects the `next` function.
+- `createParamDecorator(factory)` — Creates custom reusable route parameter decorators:
+  ```typescript
+  export const CurrentUser = createParamDecorator((data: string | undefined, ctx) => {
+    return data ? ctx.req.user?.[data] : ctx.req.user
+  })
+  ```
 
 ---
 
 ## 4. Middleware & Pipeline Decorators
 
-You can bind middleware, rate limiting, and idempotency to controllers or route methods using `@Use()` and utility decorators:
+You can bind middlewares, guards, interceptors, and exception filters to controllers or route methods using the unified `@Use()` decorator:
 
 ```typescript filename="src/http/checkout/route.ts"
 import { Controller, Post, Use, Idempotent } from 'exisjs/decorators'
@@ -161,23 +168,25 @@ export default class CheckoutController {
 ```
 
 ### Available Lifecycle & Middleware Decorators
-- `@Use(...middlewares)` — Attaches middleware functions to a class or method.
+- `@Use(...items)` — Unified decorator that attaches middlewares, guards (`canActivate`), interceptors (`intercept`), or exception filters (`catch`) to a class or method.
 - `@Idempotent(options?)` — Caches responses based on the `Idempotency-Key` header using off-heap native memory.
 
 ---
 
-## 5. Response Modifiers
+## 5. Response & Metadata Modifiers
 
 Modify HTTP response status codes, redirect clients, or set headers declaratively:
 
 ```typescript filename="src/http/api/route.ts"
-import { Controller, Post, Get, HttpCode, Header, Redirect } from 'exisjs/decorators'
+import { Controller, Post, Get, HttpCode, Header, Redirect, SetMetadata, Reflector } from 'exisjs/decorators'
 
 @Controller('/api')
+@SetMetadata('roles', ['admin'])
 export default class ApiController {
   @Post('/create')
   @HttpCode(201) // Forces 201 Created
   @Header('X-Custom-Version', '2.0')
+  @SetMetadata('permissions', ['write:api'])
   async create() {
     return { success: true }
   }
@@ -195,17 +204,19 @@ export default class ApiController {
 - `@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`).
 
 ---
 
-## 6. Dependency Injection
+## 6. Dependency Injection & Modules
 
-To mark a service class as an injectable provider for the IoC container, use the `@Injectable()` decorator:
+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:
 
 ```typescript filename="src/http/users/service.ts"
 import { Injectable } from 'exisjs/decorators'
 
-@Injectable({ scope: 'singleton' })
+@Injectable({ scope: 'transient' })
 export class UserService {
   async fetchUser(id: string) {
     return { id, name: 'Alice' }
@@ -213,15 +224,21 @@ export class UserService {
 }
 ```
 
-Inside your route classes or controllers, inject services via constructor injection:
+### Constructor Parameter Injection (`@Inject` & `@Optional`)
+
+You can inject dependencies using tokens or classes, and mark optional dependencies with `@Optional()`:
 
 ```typescript filename="src/http/users/route.ts"
-import { Controller, Get, Param } from 'exisjs/decorators'
+import { Controller, Get, Param, Inject, Optional } from 'exisjs/decorators'
 import { UserService } from './service'
 
 @Controller('/users')
 export default class UsersController {
-  constructor(private userService: UserService) {}
+  constructor(
+    private userService: UserService,
+    @Inject('DATABASE_URL') private dbUrl: string,
+    @Optional() @Inject('ANALYTICS_SERVICE') private analytics?: any
+  ) {}
 
   @Get('/:id')
   async getUser(@Param('id') id: string) {
@@ -229,3 +246,20 @@ export default class UsersController {
   }
 }
 ```
+
+### Application Modules (`@Module`)
+
+You can group controllers, providers, and imports into high-level OOP modules using `@Module`:
+
+```typescript filename="src/http/users/users.module.ts"
+import { Module } from 'exisjs/module' // or 'exisjs/decorators'
+import UsersController from './route'
+import { UserService } from './service'
+
+@Module({
+  controllers: [UsersController],
+  providers: [UserService],
+  exports: [UserService]
+})
+export class UsersModule {}
+```

package/dist/docs/content/modules.mdx

@@ -74,7 +74,28 @@ export default exis({
 })
 ```
 
-#### Class-Based (OOP) Paradigm
+```
+
+#### Class-Based (OOP) Paradigm (`@Module`)
+
+For applications following the OOP paradigm, you can define modules using the `@Module` class decorator:
+
+```typescript filename="src/modules/auth.module.ts"
+import { Module } from 'exisjs/module'
+import { AuthService } from './auth.service'
+import { AuthController } from './auth.controller'
+import { DatabaseModule } from './database.module'
+
+@Module({
+  imports: [DatabaseModule],
+  controllers: [AuthController],
+  providers: [AuthService],
+  exports: [AuthService]
+})
+export class AuthModule {}
+```
+
+You can then register it into your server:
 
 ```typescript filename="src/http/server.ts"
 import { Server } from 'exisjs/decorators'

package/dist/docs/content/providers.mdx

@@ -134,14 +134,46 @@ import { UsersService } from './users/service'
 export default class RootServer {}
 ```
 
+### Constructor Injection (`@Inject` and `@Optional`)
+
+In addition to property-level `inject()`, ExisJS provides full OOP constructor parameter injection with `@Inject(token)` and `@Optional()`:
+
+```typescript filename="src/http/users/route.ts"
+import { Controller, Get, Param, Inject, Optional } from 'exisjs/decorators'
+import { UsersService } from './service'
+
+@Controller('/users')
+export default class UsersController {
+  constructor(
+    private usersService: UsersService,
+    @Inject('DATABASE_URL') private dbUrl: string,
+    @Optional() @Inject('METRICS') private metrics?: any
+  ) {}
+
+  @Get('/:id')
+  async getUser(@Param('id') id: string) {
+    return this.usersService.findAll()
+  }
+}
+```
+
 ## Injection Scopes
 
 For people coming from different programming language backgrounds, it might be unexpected to learn that in ExisJS, almost everything is shared across incoming requests. We have a connection pool to the database, singleton services with global state, etc. This is because Node.js doesn't follow the request/response Multi-Threaded Stateless Model.
 
-However, there are edge-cases when request-based lifetime may be the desired behavior (e.g., per-request caching in GraphQL, request tracking, multi-tenancy). ExisJS supports scopes directly in the `@Injectable()` decorator:
+However, there are use-cases when request-based or transient lifetime is desired. ExisJS supports three provider scopes in the `@Injectable()` decorator and `app.provide()`:
 
 - **Singleton (Default)**: A single instance of the provider is shared across the entire application.
 - **Request**: A new instance of the provider is created exclusively for each incoming request, and garbage collected afterward.
+- **Transient**: A brand-new instance is created every single time the dependency is requested/injected.
+
+```typescript
+@Injectable({ scope: 'transient' })
+export class OperationContext {
+  public readonly id = crypto.randomUUID()
+}
+```
 
 > [!WARNING]
 > **Request Scope Constraints**: A provider marked as `scope: 'request'` **must** be resolved within the lifecycle of an active HTTP request. If you try to `inject()` or resolve a request-scoped provider during application startup, inside a background queue worker, or from a cron job, the container will throw a runtime error.
+

package/dist/docs/reference/decorators.mdx

@@ -67,17 +67,19 @@ Parameter decorators automatically extract data from the incoming request and in
 - `@Body(nameOrPipe?)`: Parses and injects the JSON request body (or passes it through a validator/pipe).
 - `@Param(nameOrPipe?)`: Injects a URL path parameter (e.g., `id` from `/:id`).
 - `@Headers(nameOrPipe?)`: Injects an HTTP header by name.
+- `@QueryParam(nameOrPipe?)` / `@Query(nameOrPipe?)`: Injects a URL query parameter (e.g., `?search=term`).
 - `@HostParam(nameOrPipe?)`: Injects a subdomain parameter.
 - `@Req()`: Injects the raw ExisJS Request object.
 - `@Res(options?)`: Injects the raw ExisJS Response object (`{ passthrough: true }`).
 - `@Ip()`: Injects the client's IP address.
 - `@Next()`: Injects the Next function.
+- `createParamDecorator(factory)`: Exports a factory to create custom parameter decorators (e.g. `@CurrentUser()`).
 
 ---
 
 ## 3. Middleware & Pipeline Decorators
 
-- `@Use(...middlewares)`: Binds standard Express-style or ExisJS middleware to a controller class or method.
+- `@Use(...middlewaresOrGuardsOrInterceptorsOrFilters)`: Unified decorator that binds middlewares, guards (`canActivate`), interceptors (`intercept`), or exception filters (`catch`) to a controller class or method.
 - `@Idempotent(options?)`: Caches responses based on the `Idempotency-Key` header using native in-memory off-heap storage.
 
 ---
@@ -90,11 +92,20 @@ Parameter decorators automatically extract data from the incoming request and in
 - `@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`:
+  - `Reflector.get(key, target)`: Retrieves metadata for a specific target.
+  - `Reflector.getAllAndOverride(key, targets)`: Retrieves metadata, overriding higher-level targets with lower-level targets.
+  - `Reflector.getAllAndMerge(key, targets)`: Merges array/object metadata across multiple targets.
 
 ---
 
-## 5. Dependency Injection
+## 5. Dependency Injection & Modules
 
-- `@Injectable(options?)`: Marks a service class as an IoC provider managed by the container.
+- `@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' }`.
+- `@Inject(token)`: Constructor parameter decorator for injecting dependencies by class, string, or symbol token.
+- `@Optional()`: Constructor parameter decorator resolving missing dependencies to `undefined` without throwing.
 - `@Boundary(config)`: Marks a class as a folder-scoped Boundary configuring CORS, headers, exclusions, and pipeline steps.
 - `@Server(config)`: Marks a class as a root server definition.
+