@expressots/core 1.3.0 → 1.4.0

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="https://expresso-ts.com/" target="blank"><img src="https://github.com/expressots/expressots/blob/main/media/alogo.png" width="120" alt="Expresso TS Logo" /></a>
+  <a href="https://expresso-ts.com/" target="blank"><img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" width="120" alt="Expresso TS Logo" /></a>
 </p>
 
 # Expresso TS
@@ -46,7 +46,7 @@ ExpressoTS is an MIT-licensed open source project. It's an independent project w
 - [Daniel Boll](https://github.com/daniel-boll)
 - [Felipe Fontana](https://github.com/f0ntana)
 - [Juliano Soares](https://github.com/juliano-soares)
-- [Vitor Caminha](https://github.com/VitorCaminha) 
+- [Vitor Caminha](https://github.com/VitorCaminha)
 - [Ariel Betti](https://github.com/ArielBetti)
 - [Rodrigo da Hora](https://github.com/dahorarodrigo)
 
@@ -62,4 +62,4 @@ ExpressoTS is an MIT-licensed open source project. It's an independent project w
 
 ## License
 
-ExpressoTS is **[MIT licensed](LICENSE.md)**
+ExpressoTS is **[MIT licensed](LICENSE.md)**

package/lib/CHANGELOG.md

@@ -1,18 +1,28 @@
 
 
-## [1.3.0](https://github.com/expressots/expressots/compare/v1.2.1...v1.3.0) (2023-04-21)
-
-
-### Features
-
-* add user repository as singleton provider in opinionated template ([#24](https://github.com/expressots/expressots/issues/24)) ([3b5bded](https://github.com/expressots/expressots/commit/3b5bded07769d51f69b481e4b5e9b45c27d13a69))
-
-
-### Bug Fixes
-
-* add gitignore on opinionated template ([315d355](https://github.com/expressots/expressots/commit/315d355ed87eb6be85daddc250289d5e0d41cd21))
-* findall use case query db in memory ([ff8feea](https://github.com/expressots/expressots/commit/ff8feeaf36d0b74eebd9ab4e22f1910cff0a4df8))
-* the number of constructor arguments ([ccf2a48](https://github.com/expressots/expressots/commit/ccf2a4878e795e0182608546eae8cd83e3bea775))
+## [1.4.0](https://github.com/expressots/expressots/compare/v1.3.0...v1.4.0) (2023-05-14)
+
+* add DI (dependency injection) singleton, transient, scope to container, providers, entities, etc
+
+### Bug Fixes
+
+* update sponsor link on package
+* add example with controller only ([11b4ce3](https://github.com/expressots/expressots/commit/11b4ce3124482122a4f47fb27b7a1b1e02731621))
+* opinionated template ientity id ([dd50ca0](https://github.com/expressots/expressots/commit/dd50ca0926c98890cbe1342f804ca34152c4a9f9))
+
+## [1.3.0](https://github.com/expressots/expressots/compare/v1.2.1...v1.3.0) (2023-04-21)
+
+
+### Features
+
+* add user repository as singleton provider in opinionated template ([#24](https://github.com/expressots/expressots/issues/24)) ([3b5bded](https://github.com/expressots/expressots/commit/3b5bded07769d51f69b481e4b5e9b45c27d13a69))
+
+
+### Bug Fixes
+
+* add gitignore on opinionated template ([315d355](https://github.com/expressots/expressots/commit/315d355ed87eb6be85daddc250289d5e0d41cd21))
+* findall use case query db in memory ([ff8feea](https://github.com/expressots/expressots/commit/ff8feeaf36d0b74eebd9ab4e22f1910cff0a4df8))
+* the number of constructor arguments ([ccf2a48](https://github.com/expressots/expressots/commit/ccf2a4878e795e0182608546eae8cd83e3bea775))
 * update core pkg templates to always download latest ([ca443eb](https://github.com/expressots/expressots/commit/ca443eb6be103725c73442f49e2fec14d797bba1))
 
 ## [1.2.1](https://github.com/expressots/expressots/compare/v1.2.0...v1.2.1) (2023-04-18)

package/lib/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="https://expresso-ts.com/" target="blank"><img src="https://github.com/expressots/expressots/blob/main/media/alogo.png" width="120" alt="Expresso TS Logo" /></a>
+  <a href="https://expresso-ts.com/" target="blank"><img src="https://github.com/expressots/expressots/blob/main/media/expressots.png" width="120" alt="Expresso TS Logo" /></a>
 </p>
 
 # Expresso TS
@@ -46,7 +46,7 @@ ExpressoTS is an MIT-licensed open source project. It's an independent project w
 - [Daniel Boll](https://github.com/daniel-boll)
 - [Felipe Fontana](https://github.com/f0ntana)
 - [Juliano Soares](https://github.com/juliano-soares)
-- [Vitor Caminha](https://github.com/VitorCaminha) 
+- [Vitor Caminha](https://github.com/VitorCaminha)
 - [Ariel Betti](https://github.com/ArielBetti)
 - [Rodrigo da Hora](https://github.com/dahorarodrigo)
 
@@ -62,4 +62,4 @@ ExpressoTS is an MIT-licensed open source project. It's an independent project w
 
 ## License
 
-ExpressoTS is **[MIT licensed](LICENSE.md)**
+ExpressoTS is **[MIT licensed](LICENSE.md)**

package/lib/cjs/application/app-container.js

@@ -5,9 +5,6 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 var AppContainer_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppContainer = void 0;
@@ -18,23 +15,43 @@ const inversify_binding_decorators_1 = require("inversify-binding-decorators");
  * @provide AppContainer
  */
 let AppContainer = AppContainer_1 = class AppContainer {
-    /**
-     * Constructs a new instance of the AppContainer class.
-     */
-    constructor() { }
     /**
      * Creates and configures a new dependency injection container.
      * @param modules - An array of ContainerModule instances to load into the container.
+     * @param defaultScope - The default scope to use for bindings. Scoped (Request) by default, but offers Singleton and Transient as well.
      * @returns The configured dependency injection container.
      */
-    create(modules) {
-        this.container = new inversify_1.Container();
+    create(modules, defaultScope = inversify_1.BindingScopeEnum.Request) {
+        this.container = new inversify_1.Container({
+            autoBindInjectable: true,
+            defaultScope,
+        });
         this.container.load((0, inversify_binding_decorators_1.buildProviderModule)(), ...modules);
         return this.container;
     }
+    /**
+     * Retrieves the binding dictionary of the container.
+     * @returns The binding dictionary of the container.
+     */
+    getBindingDictionary() {
+        return this.container["_bindingDictionary"]._map;
+    }
+    /**
+     * Retrieves the container options.
+     * @returns The container options.
+     */
+    getContainerOptions() {
+        return this.container["options"];
+    }
+    /**
+     * Retrieves the container.
+     * @returns The container.
+     */
+    get Container() {
+        return this.container;
+    }
 };
 AppContainer = AppContainer_1 = __decorate([
-    (0, inversify_binding_decorators_1.provide)(AppContainer_1),
-    __metadata("design:paramtypes", [])
+    (0, inversify_binding_decorators_1.provide)(AppContainer_1)
 ], AppContainer);
 exports.AppContainer = AppContainer;

package/lib/cjs/container-module/container-module.js

@@ -5,20 +5,45 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 var BaseModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateModule = void 0;
+exports.scope = exports.CreateModule = void 0;
 const inversify_1 = require("inversify");
 const inversify_binding_decorators_1 = require("inversify-binding-decorators");
+const decorator_1 = require("../decorator");
+/**
+ * Key to be used for storing and retrieving binding type metadata.
+ */
+const BINDING_TYPE_METADATA_KEY = "binding-type";
+/**
+ * The scope decorator is a higher order function that can be used to decorate a class with a binding type.
+ * @param binding An instance of interfaces.BindingScope which represents the binding type.
+ * @returns A decorator function that can be used to decorate a class with a binding type.
+ */
+const scope = (binding) => {
+    return function (target) {
+        if (!Reflect.hasMetadata(BINDING_TYPE_METADATA_KEY, target)) {
+            Reflect.defineMetadata(BINDING_TYPE_METADATA_KEY, binding, target);
+            switch (binding) {
+                case inversify_1.BindingScopeEnum.Singleton:
+                    (0, decorator_1.provideSingleton)(target);
+                    break;
+                case inversify_1.BindingScopeEnum.Transient:
+                    (0, decorator_1.provideTransient)(target);
+                    break;
+                default:
+                    (0, inversify_binding_decorators_1.provide)(target);
+                    break;
+            }
+        }
+    };
+};
+exports.scope = scope;
 /**
  * The BaseModule class provides methods for creating InversifyJS container modules.
  * @provide BaseModule
  */
 let BaseModule = BaseModule_1 = class BaseModule {
-    constructor() { }
     /**
      * Create a map of symbols for the provided controllers.
      * @param controllers - An array of controller classes.
@@ -34,23 +59,51 @@ let BaseModule = BaseModule_1 = class BaseModule {
         return symbols;
     }
     /**
-    * Create an InversifyJS ContainerModule for the provided controllers.
-    * @param controllers - An array of controller classes.
-    * @returns A ContainerModule with the controller bindings.
-    */
-    static createContainerModule(controllers) {
+     * Create an InversifyJS ContainerModule for the provided controllers.
+     * @param controllers - An array of controller classes.
+     * @param scope - An optional binding scope to be used for all controllers.
+     * @returns A ContainerModule with the controller bindings.
+     */
+    static createContainerModule(controllers, scope) {
         const symbols = BaseModule_1.createSymbols(controllers);
-        return new inversify_1.ContainerModule(bind => {
-            for (const symbol of symbols) {
-                const target = symbol.valueOf();
-                bind(target[0]).to(target[1]);
+        return new inversify_1.ContainerModule((bind) => {
+            for (const [symbol, target] of symbols) {
+                if (scope) {
+                    switch (scope) {
+                        case inversify_1.BindingScopeEnum.Singleton:
+                            bind(symbol).to(target).inSingletonScope();
+                            break;
+                        case inversify_1.BindingScopeEnum.Transient:
+                            bind(symbol).to(target).inTransientScope();
+                            break;
+                        case inversify_1.BindingScopeEnum.Request:
+                            bind(symbol).to(target).inRequestScope();
+                            break;
+                    }
+                }
+                else {
+                    const bindingType = Reflect.getMetadata(BINDING_TYPE_METADATA_KEY, target);
+                    switch (bindingType) {
+                        case inversify_1.BindingScopeEnum.Singleton:
+                            bind(symbol).to(target).inSingletonScope();
+                            break;
+                        case inversify_1.BindingScopeEnum.Transient:
+                            bind(symbol).to(target).inTransientScope();
+                            break;
+                        case inversify_1.BindingScopeEnum.Request:
+                            bind(symbol).to(target).inRequestScope();
+                            break;
+                        default:
+                            bind(symbol).to(target).inRequestScope();
+                            break;
+                    }
+                }
             }
         });
     }
 };
 BaseModule = BaseModule_1 = __decorate([
-    (0, inversify_binding_decorators_1.provide)(BaseModule_1),
-    __metadata("design:paramtypes", [])
+    (0, inversify_binding_decorators_1.provide)(BaseModule_1)
 ], BaseModule);
 const CreateModule = BaseModule.createContainerModule;
 exports.CreateModule = CreateModule;

package/lib/cjs/container-module/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateModule = void 0;
+exports.scope = exports.CreateModule = void 0;
 var container_module_1 = require("./container-module");
 Object.defineProperty(exports, "CreateModule", { enumerable: true, get: function () { return container_module_1.CreateModule; } });
+Object.defineProperty(exports, "scope", { enumerable: true, get: function () { return container_module_1.scope; } });

package/lib/cjs/decorator/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./scope-binding"), exports);

package/lib/cjs/decorator/scope-binding.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.provideTransient = exports.provideSingleton = void 0;
+const inversify_binding_decorators_1 = require("inversify-binding-decorators");
+const provideSingleton = (identifier) => {
+    return (0, inversify_binding_decorators_1.fluentProvide)(identifier).inSingletonScope().done();
+};
+exports.provideSingleton = provideSingleton;
+const provideTransient = (identifier) => {
+    return (0, inversify_binding_decorators_1.fluentProvide)(identifier).inTransientScope().done();
+};
+exports.provideTransient = provideTransient;

package/lib/cjs/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./common"), exports);
 __exportStar(require("./console"), exports);
 __exportStar(require("./container-module"), exports);
 __exportStar(require("./controller"), exports);
+__exportStar(require("./decorator"), exports);
 __exportStar(require("./environment"), exports);
 __exportStar(require("./error"), exports);
 __exportStar(require("./logger"), exports);

package/lib/cjs/types/application/app-container.d.ts

@@ -1,20 +1,32 @@
-import { Container, ContainerModule } from "inversify";
+import { Container, ContainerModule, interfaces } from "inversify";
 /**
  * The AppContainer class provides a container for managing dependency injection.
  * @provide AppContainer
  */
 declare class AppContainer {
     private container;
-    /**
-     * Constructs a new instance of the AppContainer class.
-     */
-    constructor();
     /**
      * Creates and configures a new dependency injection container.
      * @param modules - An array of ContainerModule instances to load into the container.
+     * @param defaultScope - The default scope to use for bindings. Scoped (Request) by default, but offers Singleton and Transient as well.
      * @returns The configured dependency injection container.
      */
-    create(modules: ContainerModule[]): Container;
+    create(modules: ContainerModule[], defaultScope?: interfaces.BindingScope): Container;
+    /**
+     * Retrieves the binding dictionary of the container.
+     * @returns The binding dictionary of the container.
+     */
+    getBindingDictionary(): Map<any, any>;
+    /**
+     * Retrieves the container options.
+     * @returns The container options.
+     */
+    getContainerOptions(): interfaces.ContainerOptions;
+    /**
+     * Retrieves the container.
+     * @returns The container.
+     */
+    get Container(): Container;
 }
 export { AppContainer };
 //# sourceMappingURL=app-container.d.ts.map

package/lib/cjs/types/application/app-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-container.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/application/app-container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGvD;;;GAGG;AACH,cACM,YAAY;IAEd,OAAO,CAAC,SAAS,CAAY;IAE7B;;OAEG;;IAGH;;;;OAIG;IACI,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS;CAKvD;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"app-container.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/application/app-container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGrF;;;GAGG;AACH,cACM,YAAY;IAEd,OAAO,CAAC,SAAS,CAAa;IAC9B;;;;;OAKG;IACI,MAAM,CACT,OAAO,EAAE,eAAe,EAAE,EAC1B,YAAY,GAAE,UAAU,CAAC,YAAuC,GACjE,SAAS;IAWZ;;;OAGG;IACI,oBAAoB,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC;IAI5C;;;OAGG;IACI,mBAAmB,IAAI,UAAU,CAAC,gBAAgB;IAIzD;;;OAGG;IACH,IAAW,SAAS,IAAI,SAAS,CAEhC;CACJ;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/lib/cjs/types/container-module/container-module.d.ts

@@ -1,10 +1,15 @@
-import { ContainerModule } from "inversify";
+import { ContainerModule, interfaces } from "inversify";
+/**
+ * The scope decorator is a higher order function that can be used to decorate a class with a binding type.
+ * @param binding An instance of interfaces.BindingScope which represents the binding type.
+ * @returns A decorator function that can be used to decorate a class with a binding type.
+ */
+declare const scope: (binding: interfaces.BindingScope) => (target: any) => void;
 /**
  * The BaseModule class provides methods for creating InversifyJS container modules.
  * @provide BaseModule
  */
 declare class BaseModule {
-    constructor();
     /**
      * Create a map of symbols for the provided controllers.
      * @param controllers - An array of controller classes.
@@ -12,12 +17,13 @@ declare class BaseModule {
      */
     private static createSymbols;
     /**
-    * Create an InversifyJS ContainerModule for the provided controllers.
-    * @param controllers - An array of controller classes.
-    * @returns A ContainerModule with the controller bindings.
-    */
-    static createContainerModule(controllers: any[]): ContainerModule;
+     * Create an InversifyJS ContainerModule for the provided controllers.
+     * @param controllers - An array of controller classes.
+     * @param scope - An optional binding scope to be used for all controllers.
+     * @returns A ContainerModule with the controller bindings.
+     */
+    static createContainerModule(controllers: any[], scope?: interfaces.BindingScope): ContainerModule;
 }
 declare const CreateModule: typeof BaseModule.createContainerModule;
-export { CreateModule };
+export { CreateModule, scope };
 //# sourceMappingURL=container-module.d.ts.map

package/lib/cjs/types/container-module/container-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-module.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/container-module/container-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAQ5C;;;GAGG;AACH,cACM,UAAU;;IAIZ;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAa3B;;;;MAIE;WACW,qBAAqB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,eAAe;CAY3E;AAED,QAAA,MAAM,YAAY,yCAAmC,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"container-module.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/container-module/container-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAS1E;;;;GAIG;AACH,QAAA,MAAM,KAAK,YAAa,WAAW,YAAY,cAClB,GAAG,SAiB/B,CAAC;AAOF;;;GAGG;AACH,cACM,UAAU;IACZ;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B;;;;;OAKG;WACW,qBAAqB,CAC/B,WAAW,EAAE,GAAG,EAAE,EAClB,KAAK,CAAC,EAAE,UAAU,CAAC,YAAY,GAChC,eAAe;CAyCrB;AAED,QAAA,MAAM,YAAY,yCAAmC,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC"}

package/lib/cjs/types/container-module/index.d.ts

@@ -1,2 +1,2 @@
-export { CreateModule } from "./container-module";
+export { CreateModule, scope } from "./container-module";
 //# sourceMappingURL=index.d.ts.map

package/lib/cjs/types/container-module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/container-module/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/container-module/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA"}

package/lib/cjs/types/decorator/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./scope-binding";
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/types/decorator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/decorator/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/lib/cjs/types/decorator/scope-binding.d.ts

@@ -0,0 +1,4 @@
+declare const provideSingleton: (identifier: any) => (target: any) => any;
+declare const provideTransient: (identifier: any) => (target: any) => any;
+export { provideSingleton, provideTransient };
+//# sourceMappingURL=scope-binding.d.ts.map

package/lib/cjs/types/decorator/scope-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-binding.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/decorator/scope-binding.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,gBAAgB,eAAgB,GAAG,yBAExC,CAAC;AAEF,QAAA,MAAM,gBAAgB,eAAgB,GAAG,yBAExC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/lib/cjs/types/index.d.ts

@@ -3,6 +3,7 @@ export * from "./common";
 export * from "./console";
 export * from "./container-module";
 export * from "./controller";
+export * from "./decorator";
 export * from "./environment";
 export * from "./error";
 export * from "./logger";

package/lib/cjs/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/lib/esm/application/app-container.js

@@ -4,11 +4,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 var AppContainer_1;
-import { Container } from "inversify";
+import { BindingScopeEnum, Container } from "inversify";
 import { buildProviderModule, provide } from "inversify-binding-decorators";
 /**
  * The AppContainer class provides a container for managing dependency injection.
@@ -16,23 +13,43 @@ import { buildProviderModule, provide } from "inversify-binding-decorators";
  */
 let AppContainer = AppContainer_1 = class AppContainer {
     container;
-    /**
-     * Constructs a new instance of the AppContainer class.
-     */
-    constructor() { }
     /**
      * Creates and configures a new dependency injection container.
      * @param modules - An array of ContainerModule instances to load into the container.
+     * @param defaultScope - The default scope to use for bindings. Scoped (Request) by default, but offers Singleton and Transient as well.
      * @returns The configured dependency injection container.
      */
-    create(modules) {
-        this.container = new Container();
+    create(modules, defaultScope = BindingScopeEnum.Request) {
+        this.container = new Container({
+            autoBindInjectable: true,
+            defaultScope,
+        });
         this.container.load(buildProviderModule(), ...modules);
         return this.container;
     }
+    /**
+     * Retrieves the binding dictionary of the container.
+     * @returns The binding dictionary of the container.
+     */
+    getBindingDictionary() {
+        return this.container["_bindingDictionary"]._map;
+    }
+    /**
+     * Retrieves the container options.
+     * @returns The container options.
+     */
+    getContainerOptions() {
+        return this.container["options"];
+    }
+    /**
+     * Retrieves the container.
+     * @returns The container.
+     */
+    get Container() {
+        return this.container;
+    }
 };
 AppContainer = AppContainer_1 = __decorate([
-    provide(AppContainer_1),
-    __metadata("design:paramtypes", [])
+    provide(AppContainer_1)
 ], AppContainer);
 export { AppContainer };

package/lib/esm/container-module/container-module.js

@@ -4,18 +4,42 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 var BaseModule_1;
-import { ContainerModule } from "inversify";
+import { BindingScopeEnum, ContainerModule } from "inversify";
 import { provide } from "inversify-binding-decorators";
+import { provideSingleton, provideTransient } from "../decorator";
+/**
+ * Key to be used for storing and retrieving binding type metadata.
+ */
+const BINDING_TYPE_METADATA_KEY = "binding-type";
+/**
+ * The scope decorator is a higher order function that can be used to decorate a class with a binding type.
+ * @param binding An instance of interfaces.BindingScope which represents the binding type.
+ * @returns A decorator function that can be used to decorate a class with a binding type.
+ */
+const scope = (binding) => {
+    return function (target) {
+        if (!Reflect.hasMetadata(BINDING_TYPE_METADATA_KEY, target)) {
+            Reflect.defineMetadata(BINDING_TYPE_METADATA_KEY, binding, target);
+            switch (binding) {
+                case BindingScopeEnum.Singleton:
+                    provideSingleton(target);
+                    break;
+                case BindingScopeEnum.Transient:
+                    provideTransient(target);
+                    break;
+                default:
+                    provide(target);
+                    break;
+            }
+        }
+    };
+};
 /**
  * The BaseModule class provides methods for creating InversifyJS container modules.
  * @provide BaseModule
  */
 let BaseModule = BaseModule_1 = class BaseModule {
-    constructor() { }
     /**
      * Create a map of symbols for the provided controllers.
      * @param controllers - An array of controller classes.
@@ -31,23 +55,51 @@ let BaseModule = BaseModule_1 = class BaseModule {
         return symbols;
     }
     /**
-    * Create an InversifyJS ContainerModule for the provided controllers.
-    * @param controllers - An array of controller classes.
-    * @returns A ContainerModule with the controller bindings.
-    */
-    static createContainerModule(controllers) {
+     * Create an InversifyJS ContainerModule for the provided controllers.
+     * @param controllers - An array of controller classes.
+     * @param scope - An optional binding scope to be used for all controllers.
+     * @returns A ContainerModule with the controller bindings.
+     */
+    static createContainerModule(controllers, scope) {
         const symbols = BaseModule_1.createSymbols(controllers);
-        return new ContainerModule(bind => {
-            for (const symbol of symbols) {
-                const target = symbol.valueOf();
-                bind(target[0]).to(target[1]);
+        return new ContainerModule((bind) => {
+            for (const [symbol, target] of symbols) {
+                if (scope) {
+                    switch (scope) {
+                        case BindingScopeEnum.Singleton:
+                            bind(symbol).to(target).inSingletonScope();
+                            break;
+                        case BindingScopeEnum.Transient:
+                            bind(symbol).to(target).inTransientScope();
+                            break;
+                        case BindingScopeEnum.Request:
+                            bind(symbol).to(target).inRequestScope();
+                            break;
+                    }
+                }
+                else {
+                    const bindingType = Reflect.getMetadata(BINDING_TYPE_METADATA_KEY, target);
+                    switch (bindingType) {
+                        case BindingScopeEnum.Singleton:
+                            bind(symbol).to(target).inSingletonScope();
+                            break;
+                        case BindingScopeEnum.Transient:
+                            bind(symbol).to(target).inTransientScope();
+                            break;
+                        case BindingScopeEnum.Request:
+                            bind(symbol).to(target).inRequestScope();
+                            break;
+                        default:
+                            bind(symbol).to(target).inRequestScope();
+                            break;
+                    }
+                }
             }
         });
     }
 };
 BaseModule = BaseModule_1 = __decorate([
-    provide(BaseModule_1),
-    __metadata("design:paramtypes", [])
+    provide(BaseModule_1)
 ], BaseModule);
 const CreateModule = BaseModule.createContainerModule;
-export { CreateModule };
+export { CreateModule, scope };

package/lib/esm/container-module/index.js

@@ -1 +1 @@
-export { CreateModule } from "./container-module";
+export { CreateModule, scope } from "./container-module";

package/lib/esm/decorator/index.js

@@ -0,0 +1 @@
+export * from "./scope-binding";

package/lib/esm/decorator/scope-binding.js

@@ -0,0 +1,8 @@
+import { fluentProvide } from "inversify-binding-decorators";
+const provideSingleton = (identifier) => {
+    return fluentProvide(identifier).inSingletonScope().done();
+};
+const provideTransient = (identifier) => {
+    return fluentProvide(identifier).inTransientScope().done();
+};
+export { provideSingleton, provideTransient };

package/lib/esm/index.mjs

@@ -3,6 +3,7 @@ export * from "./common";
 export * from "./console";
 export * from "./container-module";
 export * from "./controller";
+export * from "./decorator";
 export * from "./environment";
 export * from "./error";
 export * from "./logger";

package/lib/esm/types/application/app-container.d.ts

@@ -1,20 +1,32 @@
-import { Container, ContainerModule } from "inversify";
+import { Container, ContainerModule, interfaces } from "inversify";
 /**
  * The AppContainer class provides a container for managing dependency injection.
  * @provide AppContainer
  */
 declare class AppContainer {
     private container;
-    /**
-     * Constructs a new instance of the AppContainer class.
-     */
-    constructor();
     /**
      * Creates and configures a new dependency injection container.
      * @param modules - An array of ContainerModule instances to load into the container.
+     * @param defaultScope - The default scope to use for bindings. Scoped (Request) by default, but offers Singleton and Transient as well.
      * @returns The configured dependency injection container.
      */
-    create(modules: ContainerModule[]): Container;
+    create(modules: ContainerModule[], defaultScope?: interfaces.BindingScope): Container;
+    /**
+     * Retrieves the binding dictionary of the container.
+     * @returns The binding dictionary of the container.
+     */
+    getBindingDictionary(): Map<any, any>;
+    /**
+     * Retrieves the container options.
+     * @returns The container options.
+     */
+    getContainerOptions(): interfaces.ContainerOptions;
+    /**
+     * Retrieves the container.
+     * @returns The container.
+     */
+    get Container(): Container;
 }
 export { AppContainer };
 //# sourceMappingURL=app-container.d.ts.map

package/lib/esm/types/application/app-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-container.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/application/app-container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGvD;;;GAGG;AACH,cACM,YAAY;IAEd,OAAO,CAAC,SAAS,CAAY;IAE7B;;OAEG;;IAGH;;;;OAIG;IACI,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS;CAKvD;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"app-container.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/application/app-container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGrF;;;GAGG;AACH,cACM,YAAY;IAEd,OAAO,CAAC,SAAS,CAAa;IAC9B;;;;;OAKG;IACI,MAAM,CACT,OAAO,EAAE,eAAe,EAAE,EAC1B,YAAY,GAAE,UAAU,CAAC,YAAuC,GACjE,SAAS;IAWZ;;;OAGG;IACI,oBAAoB,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC;IAI5C;;;OAGG;IACI,mBAAmB,IAAI,UAAU,CAAC,gBAAgB;IAIzD;;;OAGG;IACH,IAAW,SAAS,IAAI,SAAS,CAEhC;CACJ;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/lib/esm/types/container-module/container-module.d.ts

@@ -1,10 +1,15 @@
-import { ContainerModule } from "inversify";
+import { ContainerModule, interfaces } from "inversify";
+/**
+ * The scope decorator is a higher order function that can be used to decorate a class with a binding type.
+ * @param binding An instance of interfaces.BindingScope which represents the binding type.
+ * @returns A decorator function that can be used to decorate a class with a binding type.
+ */
+declare const scope: (binding: interfaces.BindingScope) => (target: any) => void;
 /**
  * The BaseModule class provides methods for creating InversifyJS container modules.
  * @provide BaseModule
  */
 declare class BaseModule {
-    constructor();
     /**
      * Create a map of symbols for the provided controllers.
      * @param controllers - An array of controller classes.
@@ -12,12 +17,13 @@ declare class BaseModule {
      */
     private static createSymbols;
     /**
-    * Create an InversifyJS ContainerModule for the provided controllers.
-    * @param controllers - An array of controller classes.
-    * @returns A ContainerModule with the controller bindings.
-    */
-    static createContainerModule(controllers: any[]): ContainerModule;
+     * Create an InversifyJS ContainerModule for the provided controllers.
+     * @param controllers - An array of controller classes.
+     * @param scope - An optional binding scope to be used for all controllers.
+     * @returns A ContainerModule with the controller bindings.
+     */
+    static createContainerModule(controllers: any[], scope?: interfaces.BindingScope): ContainerModule;
 }
 declare const CreateModule: typeof BaseModule.createContainerModule;
-export { CreateModule };
+export { CreateModule, scope };
 //# sourceMappingURL=container-module.d.ts.map

package/lib/esm/types/container-module/container-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-module.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/container-module/container-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAQ5C;;;GAGG;AACH,cACM,UAAU;;IAIZ;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAa3B;;;;MAIE;WACW,qBAAqB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,eAAe;CAY3E;AAED,QAAA,MAAM,YAAY,yCAAmC,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"container-module.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/container-module/container-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAS1E;;;;GAIG;AACH,QAAA,MAAM,KAAK,YAAa,WAAW,YAAY,cAClB,GAAG,SAiB/B,CAAC;AAOF;;;GAGG;AACH,cACM,UAAU;IACZ;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B;;;;;OAKG;WACW,qBAAqB,CAC/B,WAAW,EAAE,GAAG,EAAE,EAClB,KAAK,CAAC,EAAE,UAAU,CAAC,YAAY,GAChC,eAAe;CAyCrB;AAED,QAAA,MAAM,YAAY,yCAAmC,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC"}

package/lib/esm/types/container-module/index.d.ts

@@ -1,2 +1,2 @@
-export { CreateModule } from "./container-module";
+export { CreateModule, scope } from "./container-module";
 //# sourceMappingURL=index.d.ts.map

package/lib/esm/types/container-module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/container-module/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/container-module/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA"}

package/lib/esm/types/decorator/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./scope-binding";
+//# sourceMappingURL=index.d.ts.map

package/lib/esm/types/decorator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/decorator/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/lib/esm/types/decorator/scope-binding.d.ts

@@ -0,0 +1,4 @@
+declare const provideSingleton: (identifier: any) => (target: any) => any;
+declare const provideTransient: (identifier: any) => (target: any) => any;
+export { provideSingleton, provideTransient };
+//# sourceMappingURL=scope-binding.d.ts.map

package/lib/esm/types/decorator/scope-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-binding.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/decorator/scope-binding.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,gBAAgB,eAAgB,GAAG,yBAExC,CAAC;AAEF,QAAA,MAAM,gBAAgB,eAAgB,GAAG,yBAExC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/lib/esm/types/index.d.ts

@@ -3,6 +3,7 @@ export * from "./common";
 export * from "./console";
 export * from "./container-module";
 export * from "./controller";
+export * from "./decorator";
 export * from "./environment";
 export * from "./error";
 export * from "./logger";

package/lib/esm/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/lib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/core",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@core)",
   "author": "Richard Zampieri",
   "main": "./lib/cjs/index.js",
@@ -23,8 +23,8 @@
   "license": "MIT",
   "homepage": "https://expresso-ts.com",
   "funding": {
-    "type": "",
-    "url": ""
+    "type": "github",
+    "url": "https://github.com/sponsors/expressots"
   },
   "repository": {
     "type": "git",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/core",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@core)",
   "author": "Richard Zampieri",
   "main": "./lib/cjs/index.js",
@@ -23,8 +23,8 @@
   "license": "MIT",
   "homepage": "https://expresso-ts.com",
   "funding": {
-    "type": "",
-    "url": ""
+    "type": "github",
+    "url": "https://github.com/sponsors/expressots"
   },
   "repository": {
     "type": "git",