@stone-js/service-container 0.0.42 → 0.0.44

package/README.md

@@ -3,7 +3,7 @@
 [![npm](https://img.shields.io/npm/l/@stone-js/service-container)](https://opensource.org/licenses/Apache-2.0)
 [![npm](https://img.shields.io/npm/v/@stone-js/service-container)](https://www.npmjs.com/package/@stone-js/service-container)
 [![npm](https://img.shields.io/npm/dm/@stone-js/service-container)](https://www.npmjs.com/package/@stone-js/service-container)
-![Maintenance](https://img.shields.io/maintenance/yes/2024)
+![Maintenance](https://img.shields.io/maintenance/yes/2025)
 [![Publish Package to npmjs](https://github.com/stonemjs/service-container/actions/workflows/release.yml/badge.svg)](https://github.com/stonemjs/service-container/actions/workflows/release.yml)
 [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)
 
@@ -23,9 +23,7 @@ With the **Service Container**, you can easily register, resolve, and manage dep
 
 ## Installation
 
-To install the `Service container` utility, you need to add it to your project. Assuming it’s part of a package you manage.
-
-NPM:
+The `Service Container` library is available from the [`npm registry`](https://www.npmjs.com/) and can be installed as follows:
 
 ```bash
 npm i @stone-js/service-container
@@ -43,7 +41,13 @@ PNPM:
 pnpm add @stone-js/service-container
 ```
 
-The `Container` module can only be imported via ESM import syntax:
+> [!NOTE]
+> This package is Pure ESM. If you are unfamiliar with what that means or how to handle it in your project, 
+> please refer to [`this guide on Pure ESM packages`](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
+
+Make sure your project setup is compatible with ESM. This might involve updating your `package.json` or using certain bundler configurations.
+
+The `Service Container` module can only be imported via ESM import syntax:
 
 ```typescript
 import { Container } from '@stone-js/service-container';

package/dist/index.d.ts

@@ -113,12 +113,18 @@ declare class Container extends Proxiable {
     private readonly aliases;
     private readonly resolvingKeys;
     private readonly bindings;
+    /**
+     * Create a Container.
+     *
+     * @returns A new Container instance.
+     */
+    static create(): Container;
     /**
      * Create a container.
      *
      * Initializes the container with empty alias and binding maps.
      */
-    constructor();
+    protected constructor();
     /**
      * Retrieve the value of the bindings property.
      *
@@ -155,15 +161,6 @@ declare class Container extends Proxiable {
      * @returns The binding key associated with the alias, or undefined if not found.
      */
     getAliasKey(alias: BindingKey): BindingKey | undefined;
-    /**
-     * Set class name as camelCase alias.
-     *
-     * Automatically assigns a camelCase alias to a given class based on its name or metadata.
-     *
-     * @param Class - The class to alias.
-     * @returns The container instance.
-     */
-    asAlias(Class: Function): this;
     /**
      * Bind a single instance or value into the container under the provided key.
      *
@@ -221,7 +218,7 @@ declare class Container extends Proxiable {
      * @returns The resolved value.
      * @throws ContainerError if the key cannot be resolved.
      */
-    make<V extends BindingValue>(key: BindingKey): V | undefined;
+    make<V extends BindingValue>(key: BindingKey): V;
     /**
      * Resolve a value from the container by its key, binding it if necessary.
      *
@@ -229,14 +226,14 @@ declare class Container extends Proxiable {
      * @param singleton - Whether to bind as a singleton if not already bound.
      * @returns The resolved value.
      */
-    resolve<V extends BindingValue>(key: BindingKey, singleton?: boolean): V | undefined;
+    resolve<V extends BindingValue>(key: BindingKey, singleton?: boolean): V;
     /**
      * Resolve a value from the container by its key and return it in a factory function.
      *
      * @param key - The key to resolve.
      * @returns A factory function that returns the resolved value.
      */
-    factory<V extends BindingValue>(key: BindingKey): () => V | undefined;
+    factory<V extends BindingValue>(key: BindingKey): () => V;
     /**
      * Check if a value is already bound in the container by its key.
      *
@@ -257,13 +254,6 @@ declare class Container extends Proxiable {
      * @returns The container instance.
      */
     clear(): this;
-    /**
-     * Register services with zero configuration.
-     *
-     * @param classes - Classes representing the services to be registered in the container.
-     * @returns The container instance.
-     */
-    register(classes: Function | Function[]): this;
     /**
      * AutoBind value to the service container.
      *

package/dist/index.js

@@ -1,5 +1,3 @@
-import { lowerFirst } from 'lodash-es';
-
 /**
  * Class representing a Proxiable.
  *
@@ -286,6 +284,14 @@ class Container extends Proxiable {
     aliases;
     resolvingKeys = new Set();
     bindings;
+    /**
+     * Create a Container.
+     *
+     * @returns A new Container instance.
+     */
+    static create() {
+        return new this();
+    }
     /**
      * Create a container.
      *
@@ -360,20 +366,6 @@ class Container extends Proxiable {
     getAliasKey(alias) {
         return this.aliases.get(alias);
     }
-    /**
-     * Set class name as camelCase alias.
-     *
-     * Automatically assigns a camelCase alias to a given class based on its name or metadata.
-     *
-     * @param Class - The class to alias.
-     * @returns The container instance.
-     */
-    asAlias(Class) {
-        if (typeof Class !== 'function' || !Object.prototype.hasOwnProperty.call(Class, 'prototype')) {
-            return this;
-        }
-        return this.alias(Class, lowerFirst(Class.$$metadata$$?.name ?? Class.name));
-    }
     /**
      * Bind a single instance or value into the container under the provided key.
      *
@@ -462,8 +454,9 @@ class Container extends Proxiable {
         }
         this.resolvingKeys.add(key);
         try {
-            if (this.bindings.has(key)) {
-                return this.bindings.get(key)?.resolve(this);
+            const binding = this.bindings.get(key);
+            if (binding !== undefined) {
+                return binding.resolve(this);
             }
         }
         finally {
@@ -523,24 +516,6 @@ class Container extends Proxiable {
         this.bindings.clear();
         return this;
     }
-    /**
-     * Register services with zero configuration.
-     *
-     * @param classes - Classes representing the services to be registered in the container.
-     * @returns The container instance.
-     */
-    register(classes) {
-        for (const Class of [].concat(classes)) {
-            if (Class.$$metadata$$?.service !== undefined) {
-                const { singleton = true, alias } = Class.$$metadata$$.service;
-                this.autoBinding(Class, Class, singleton, alias ?? []);
-            }
-            else {
-                throw new ContainerError(ContainerError.NOT_A_SERVICE_TYPE, Class);
-            }
-        }
-        return this;
-    }
     /**
      * AutoBind value to the service container.
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stone-js/service-container",
-  "version": "0.0.42",
-  "description": "Vanilla Javascript IoC Service Container with proposal decorator, proxy resolver and destructuring injection",
+  "version": "0.0.44",
+  "description": "Javascript/Typescript IoC Service Container with proxy resolver and destructuring injection",
   "author": "Mr. Stone <evensstone@gmail.com>",
   "license": "Apache-2.0",
   "repository": {
@@ -52,9 +52,6 @@
     "test:clover": "npm run test:cvg -- --coverage.reporter=clover",
     "prepare": "husky"
   },
-  "dependencies": {
-    "lodash-es": "^4.17.21"
-  },
   "devDependencies": {
     "@commitlint/cli": "^19.5.0",
     "@commitlint/config-conventional": "^19.5.0",
@@ -62,7 +59,6 @@
     "@rollup/plugin-multi-entry": "^6.0.1",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-typescript": "^12.1.1",
-    "@types/lodash-es": "^4.17.12",
     "@types/node": "^22.9.0",
     "@vitest/coverage-v8": "^2.1.4",
     "husky": "^9.1.6",