inversify 7.0.0-alpha.1 → 7.0.0-alpha.3

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project from 5.0.0 forward will be documented in thi
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [7.0.0-alpha.3]
+
+### Changed
+- Updated `BindToFluentSyntax` with `.toResolvedValue`.
+
+## [7.0.0-alpha.2]
+
+### Changed
+- Updated `Container` with a plan cache. `Container.get`, `Container.getAll`, `Container.getAllAsync` and `Container.getAsync` performance has been improved.
+
 ## [7.0.0-alpha.1]
 
 ### Changed

package/README.md

@@ -40,7 +40,7 @@ InversifyJS has been developed with 4 main goals:
 
 3. Add as little runtime overhead as possible.
 
-4. Provide a [state of the art development experience](https://github.com/inversify/InversifyJS/blob/master/wiki/ecosystem.md).
+4. Provide a state of the art development experience.
 
 ## Testimonies
 
@@ -56,235 +56,8 @@ InversifyJS has been developed with 4 main goals:
 
 [<img src="https://avatars0.githubusercontent.com/u/6154722?s=200&v=4" width="100" />](https://opensource.microsoft.com/)[<img src="https://avatars2.githubusercontent.com/u/69631?s=200&v=4" width="100" />](https://code.facebook.com/projects/1021334114569758/nuclide/)[<img src="https://avatars0.githubusercontent.com/u/2232217?s=200&v=4" width="100" />](https://aws.github.io/aws-amplify/)[<img src="https://avatars0.githubusercontent.com/u/1520648?s=200&v=4" width="100" />](https://www.plainconcepts.com/)[<img src="https://avatars3.githubusercontent.com/u/6962987?s=200&v=4" width="100" />](https://api.slack.com/)[<img src="https://pbs.twimg.com/profile_images/827249559046909954/SyaBPcH8_400x400.jpg" width="100" />](http://acia.aon.com/index.php/home/) [<img src="https://avatars3.githubusercontent.com/u/114767?s=200&v=4" width="100" />](https://www.lonelyplanet.com/) [<img src="https://avatars0.githubusercontent.com/u/25283328?s=200&v=4" width="100" />](https://jincor.com/) [<img src="https://avatars1.githubusercontent.com/u/1957282?s=200&v=4" width="100" />](https://www.web-computing.de/) [<img src="https://avatars1.githubusercontent.com/u/17648048?s=200&v=4" width="100" />](https://dcos.io/) [<img src="https://avatars0.githubusercontent.com/u/16970371?s=200&v=4" width="100" />](https://typefox.io/) [<img src="https://avatars0.githubusercontent.com/u/18010308?s=200&v=4" width="100" />](https://code4.ro/) [<img src="https://user-images.githubusercontent.com/10656223/33888109-fae0852e-df43-11e7-97f6-9db543da0bde.png" width="100">](http://www.baidu.com/) [<img src="https://avatars2.githubusercontent.com/u/8085382?s=200&v=4" width="100" />](https://www.imdada.cn/) [<img src="https://avatars2.githubusercontent.com/u/17041151?s=200&v=4" width="100" />](https://www.ato.gov.au/) [<img src="https://avatars1.githubusercontent.com/u/14963540?s=200&v=4" width="100" />](https://www.kaneoh.com/) [<img src="https://avatars0.githubusercontent.com/u/26021686?s=200&v=4" width="100" />](https://particl.io/) [<img src="https://avatars2.githubusercontent.com/u/24523195?s=200&v=4" width="100" />](https://slackmap.com/) [<img src="https://avatars3.githubusercontent.com/u/16556899?s=200&v=4" width="100" />](https://www.go1.com/) [<img src="https://avatars3.githubusercontent.com/u/23475730?s=200&v=4" width="100" />](http://www.stellwagengroup.com/stellwagen-technology/) [<img src="https://avatars1.githubusercontent.com/u/15262567?s=200&v=4" width="100" />](https://www.edrlab.org/) [<img src="https://avatars1.githubusercontent.com/u/10072104?s=200&v=4" width="100" />](https://www.goodgamestudios.com/) [<img src="https://avatars2.githubusercontent.com/u/13613760?s=200&v=4" width="100" />](https://freshfox.at/) [<img src="https://avatars1.githubusercontent.com/u/864482?s=200&v=4" width="100" />](https://schubergphilis.com/)
 
-## 📦 Installation
-
-You can get the latest release and the type definitions using your preferred package manager:
-
-```sh
-> npm install inversify reflect-metadata --save
-> yarn add inversify reflect-metadata
-> pnpm add inversify reflect-metadata
-```
-
-`reflect-metadata` will be automatically imported by inversify.
-
-The InversifyJS type definitions are included in the inversify npm package.
-
-> :warning: **Important!** InversifyJS requires TypeScript >= 4.4 and the `experimentalDecorators`, `emitDecoratorMetadata`, compilation options in your `tsconfig.json` file.
-
-```json
-{
-  "compilerOptions": {
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true
-  }
-}
-```
-
-InversifyJS requires a modern JavaScript engine with support for:
-
-- [Reflect metadata](https://rbuckton.github.io/reflect-metadata/)
-- [Map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map)
-- [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) (Only required if using [provider injection](https://github.com/inversify/InversifyJS/blob/master/wiki/provider_injection.md))
-- [Proxy](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy) (Only required if using [activation handlers](https://github.com/inversify/InversifyJS/blob/master/wiki/activation_handler.md))
-
-If your environment doesn't support one of these you will need to import a shim or polyfill.
-
-Check out the [Environment support and polyfills](https://github.com/inversify/InversifyJS/blob/master/wiki/environment.md)
-page in the wiki and the [Basic example](https://github.com/inversify/inversify-basic-example) to learn more.
-
-## The Basics
-Let’s take a look at the basic usage and APIs of InversifyJS with TypeScript:
-
-### Step 1: Declare your interfaces and types
-
-Our goal is to write code that adheres to the [dependency inversion principle](https://en.wikipedia.org/wiki/Dependency_inversion_principle).
-This means that we should "depend upon Abstractions and do not depend upon concretions".
-Let's start by declaring some interfaces (abstractions).
-
-```ts
-// file interfaces.ts
-
-export interface Warrior {
-    fight(): string;
-    sneak(): string;
-}
-
-export interface Weapon {
-    hit(): string;
-}
-
-export interface ThrowableWeapon {
-    throw(): string;
-}
-```
-
-InversifyJS needs to use the type as identifiers at runtime. We use symbols as identifiers but you can also use classes and or string literals.
-
-PLEASE MAKE SURE TO PLACE THIS TYPES DECLARATION IN A SEPARATE FILE. (see bug #1455)
-
-```ts
-// file types.ts
-
-const TYPES = {
-    Warrior: Symbol.for("Warrior"),
-    Weapon: Symbol.for("Weapon"),
-    ThrowableWeapon: Symbol.for("ThrowableWeapon")
-};
-
-export { TYPES };
-
-```
-
-> **Note**: It is recommended to use Symbols but InversifyJS also support the usage of Classes and string literals (please refer to the features section to learn more).
-
-### Step 2: Declare dependencies using the `@injectable` & `@inject` decorators
-Let's continue by declaring some classes (concretions). The classes are implementations of the interfaces that we just declared. We will annotate them with the `@injectable` decorator.
-
-When a class has a dependency on an interface we also need to use the `@inject` decorator to define an identifier for the interface that will be available at runtime. In this case we will use the Symbols `Symbol.for("Weapon")` and `Symbol.for("ThrowableWeapon")` as runtime identifiers.
-
-```ts
-// file entities.ts
-
-import { injectable, inject } from "inversify";
-import { Weapon, ThrowableWeapon, Warrior } from "./interfaces";
-import { TYPES } from "./types";
-
-@injectable()
-class Katana implements Weapon {
-    public hit() {
-        return "cut!";
-    }
-}
-
-@injectable()
-class Shuriken implements ThrowableWeapon {
-    public throw() {
-        return "hit!";
-    }
-}
-
-@injectable()
-class Ninja implements Warrior {
-
-    private _katana: Weapon;
-    private _shuriken: ThrowableWeapon;
-
-    constructor(
-        @inject(TYPES.Weapon) katana: Weapon,
-        @inject(TYPES.ThrowableWeapon) shuriken: ThrowableWeapon
-    ) {
-        this._katana = katana;
-        this._shuriken = shuriken;
-    }
-
-    public fight() { return this._katana.hit(); }
-    public sneak() { return this._shuriken.throw(); }
-
-}
-
-export { Ninja, Katana, Shuriken };
-```
-
-If you prefer it you can use property injection instead of constructor injection so you don't have to declare the class constructor:
-
-```ts
-@injectable()
-class Ninja implements Warrior {
-    @inject(TYPES.Weapon) private _katana: Weapon;
-    @inject(TYPES.ThrowableWeapon) private _shuriken: ThrowableWeapon;
-    public fight() { return this._katana.hit(); }
-    public sneak() { return this._shuriken.throw(); }
-}
-```
-
-### Step 3: Create and configure a Container
-We recommend to do this in a file named `inversify.config.ts`. This is the only place in which there is some coupling.
-In the rest of your application your classes should be free of references to other classes.
-```ts
-// file inversify.config.ts
-
-import { Container } from "inversify";
-import { TYPES } from "./types";
-import { Warrior, Weapon, ThrowableWeapon } from "./interfaces";
-import { Ninja, Katana, Shuriken } from "./entities";
-
-const myContainer = new Container();
-myContainer.bind<Warrior>(TYPES.Warrior).to(Ninja);
-myContainer.bind<Weapon>(TYPES.Weapon).to(Katana);
-myContainer.bind<ThrowableWeapon>(TYPES.ThrowableWeapon).to(Shuriken);
-
-export { myContainer };
-```
-
-### Step 4: Resolve dependencies
-You can use the method `get<T>` from the `Container` class to resolve a dependency.
-Remember that you should do this only in your [composition root](http://blog.ploeh.dk/2011/07/28/CompositionRoot/)
-to avoid the [service locator anti-pattern](http://blog.ploeh.dk/2010/02/03/ServiceLocatorisanAnti-Pattern/).
-
-```ts
-import { myContainer } from "./inversify.config";
-import { TYPES } from "./types";
-import { Warrior } from "./interfaces";
-
-const ninja = myContainer.get<Warrior>(TYPES.Warrior);
-
-expect(ninja.fight()).eql("cut!"); // true
-expect(ninja.sneak()).eql("hit!"); // true
-```
-
-As we can see the `Katana` and `Shuriken` were successfully resolved and injected into `Ninja`.
-
-InversifyJS supports ES5 and ES6 and can work without TypeScript.
-Head to the [**JavaScript example**](https://github.com/inversify/InversifyJS/blob/master/wiki/basic_js_example.md) to learn more!
-
-## 🚀 The InversifyJS Features and API
-Let's take a look to the InversifyJS features!
-
-- [Support for classes](https://github.com/inversify/InversifyJS/blob/master/wiki/classes_as_id.md)
-- [Support for Symbols](https://github.com/inversify/InversifyJS/blob/master/wiki/symbols_as_id.md)
-- [Container API](https://github.com/inversify/InversifyJS/blob/master/wiki/container_api.md)
-- [Declaring container modules](https://github.com/inversify/InversifyJS/blob/master/wiki/container_modules.md)
-- [Container snapshots](https://github.com/inversify/InversifyJS/blob/master/wiki/container_snapshots.md)
-- [Controlling the scope of the dependencies](https://github.com/inversify/InversifyJS/blob/master/wiki/scope.md)
-- [Declaring optional dependencies](https://github.com/inversify/InversifyJS/blob/master/wiki/optional_dependencies.md)
-- [Injecting a constant or dynamic value](https://github.com/inversify/InversifyJS/blob/master/wiki/value_injection.md)
-- [Injecting a class constructor](https://github.com/inversify/InversifyJS/blob/master/wiki/constructor_injection.md)
-- [Injecting a Factory](https://github.com/inversify/InversifyJS/blob/master/wiki/factory_injection.md)
-- [Auto factory](https://github.com/inversify/InversifyJS/blob/master/wiki/auto_factory.md)
-- [Auto named factory](https://github.com/inversify/InversifyJS/blob/master/wiki/auto_named_factory.md)
-- [Injecting a Provider (asynchronous Factory)](https://github.com/inversify/InversifyJS/blob/master/wiki/provider_injection.md)
-- [Activation handler](https://github.com/inversify/InversifyJS/blob/master/wiki/activation_handler.md)
-- [Deactivation handler](https://github.com/inversify/InversifyJS/blob/master/wiki/deactivation_handler.md)
-- [Post Construct decorator](https://github.com/inversify/InversifyJS/blob/master/wiki/post_construct.md)
-- [Middleware](https://github.com/inversify/InversifyJS/blob/master/wiki/middleware.md)
-- [Multi-injection](https://github.com/inversify/InversifyJS/blob/master/wiki/multi_injection.md)
-- [Tagged bindings](https://github.com/inversify/InversifyJS/blob/master/wiki/tagged_bindings.md)
-- [Create your own tag decorators](https://github.com/inversify/InversifyJS/blob/master/wiki/custom_tag_decorators.md)
-- [Named bindings](https://github.com/inversify/InversifyJS/blob/master/wiki/named_bindings.md)
-- [Default target](https://github.com/inversify/InversifyJS/blob/master/wiki/default_targets.md)
-- [Support for hierarchical DI systems](https://github.com/inversify/InversifyJS/blob/master/wiki/hierarchical_di.md)
-- [Contextual bindings & @targetName](https://github.com/inversify/InversifyJS/blob/master/wiki/contextual_bindings.md)
-- [Property injection](https://github.com/inversify/InversifyJS/blob/master/wiki/property_injection.md)
-- [Circular dependencies](https://github.com/inversify/InversifyJS/blob/master/wiki/circular_dependencies.md)
-- [Inheritance](https://github.com/inversify/InversifyJS/blob/master/wiki/inheritance.md)
-
-Please refer to the [wiki](https://github.com/inversify/InversifyJS/blob/master/wiki/readme.md) for additional details.
-
-## 🧩 Ecosystem
-In order to provide a state of the art development experience we are also working on:
-
-- [Middleware extensions](https://github.com/inversify/InversifyJS/blob/master/wiki/ecosystem.md#extensions).
-- [Development tools](https://github.com/inversify/InversifyJS/blob/master/wiki/ecosystem.md#development-tools).
-- [Examples](https://github.com/inversify/InversifyJS/blob/master/wiki/ecosystem.md#examples).
-
-Please refer to the [ecosystem wiki page](https://github.com/inversify/InversifyJS/blob/master/wiki/ecosystem.md) to learn more.
-
-## Support
-If you are experience any kind of issues we will be happy to help. You can report an issue using the [issues page](https://github.com/inversify/InversifyJS/issues) or the [chat](https://gitter.im/inversify/InversifyJS). You can also ask questions at [Stack overflow](http://stackoverflow.com/tags/inversifyjs) using the `inversifyjs` tag.
-
-If you want to share your thoughts with the development team or join us you will be able to do so using the [official the mailing list](https://groups.google.com/forum/#!forum/inversifyjs). You can check out the
-[wiki](https://github.com/inversify/InversifyJS/blob/master/wiki/readme.md) to learn more about InversifyJS internals.
+## 📕 Documentation
+Documentation is available at https://inversify.io
 
 ## Acknowledgements
 

package/package.json

@@ -6,24 +6,24 @@
   "description": "A powerful and lightweight inversion of control container for JavaScript and Node.js apps powered by TypeScript.",
   "dependencies": {
     "@inversifyjs/common": "1.5.0",
-    "@inversifyjs/container": "1.4.0",
-    "@inversifyjs/core": "3.3.0"
+    "@inversifyjs/container": "1.5.0",
+    "@inversifyjs/core": "3.5.0"
   },
   "devDependencies": {
-    "@eslint/js": "9.18.0",
+    "@eslint/js": "9.19.0",
     "@rollup/plugin-terser": "0.4.4",
     "@rollup/plugin-typescript": "12.1.2",
     "@types/chai": "4.3.20",
     "@types/mocha": "10.0.10",
     "@types/sinon": "17.0.3",
-    "@typescript-eslint/eslint-plugin": "8.21.0",
-    "@typescript-eslint/parser": "8.21.0",
+    "@typescript-eslint/eslint-plugin": "8.22.0",
+    "@typescript-eslint/parser": "8.22.0",
     "chai": "4.5.0",
-    "eslint": "9.18.0",
+    "eslint": "9.19.0",
     "eslint-config-prettier": "10.0.1",
     "eslint-plugin-prettier": "5.2.3",
     "eslint-plugin-simple-import-sort": "12.1.1",
-    "mocha": "11.0.1",
+    "mocha": "11.1.0",
     "nyc": "17.1.0",
     "prettier": "3.4.2",
     "rimraf": "6.0.1",
@@ -32,7 +32,7 @@
     "ts-loader": "9.5.2",
     "ts-node": "10.9.2",
     "typescript": "5.7.3",
-    "typescript-eslint": "8.21.0"
+    "typescript-eslint": "8.22.0"
   },
   "peerDependencies": {
     "reflect-metadata": "~0.2.2"
@@ -73,9 +73,9 @@
     "lint": "eslint ./src",
     "prebuild": "npm run build:clean",
     "prepublish": "npm run build",
-    "test": "nyc --reporter=lcov --require ts-node/register mocha src/test/*.test.ts src/test/**/*.test.ts --reporter spec --require 'node_modules/reflect-metadata/Reflect.js' --exit",
-    "test:cjs": "nyc --reporter=lcov mocha lib/cjs/test/*.test.js lib/cjs/test/**/*.test.js --reporter spec --require 'node_modules/reflect-metadata/Reflect.js'"
+    "test": "nyc --reporter=lcov --require ts-node/register mocha src/test/*.test.ts src/test/**/*.test.ts --reporter spec --exit",
+    "test:cjs": "nyc --reporter=lcov mocha lib/cjs/test/*.test.js lib/cjs/test/**/*.test.js --reporter spec"
   },
   "sideEffects": false,
-  "version": "7.0.0-alpha.1"
+  "version": "7.0.0-alpha.3"
 }