@khapu2906/treasure-chest 1.0.4 → 1.3.0

package/package.json

@@ -1,22 +1,66 @@
 {
   "name": "@khapu2906/treasure-chest",
-  "version": "1.0.4",
-  "description": "A container package for system utilities",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "1.3.0",
+  "description": "A lightweight TypeScript dependency injection container for managing service dependencies",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
-    "build": "tsc",
-    "test": "vitest",
+    "build": "npm run clean && npm run build:cjs && npm run build:esm && npm run build:types",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "test:ui": "vitest --ui",
-    "prepublishOnly": "npm run build && npm test"
+    "test:coverage": "vitest run --coverage",
+    "bench": "tsx benchmarks/performance.ts",
+    "example": "tsx",
+    "example:01": "tsx examples/01-basic-usage.ts",
+    "example:02": "tsx examples/02-dependency-injection.ts",
+    "example:03": "tsx examples/03-conditional-binding.ts",
+    "example:04": "tsx examples/04-contextual-binding.ts",
+    "example:05": "tsx examples/05-alias.ts",
+    "example:06": "tsx examples/06-scoped-lifecycle.ts",
+    "example:07": "tsx examples/07-lazy-loading.ts",
+    "example:08": "tsx examples/08-child-containers.ts",
+    "example:09": "tsx examples/09-circular-dependency.ts",
+    "example:10": "tsx examples/10-middleware.ts",
+    "example:11": "tsx examples/11-composition.ts",
+    "example:12": "tsx examples/12-singleton-vs-composition.ts",
+    "example:13": "tsx examples/13-hybrid-architecture.ts",
+    "example:14": "tsx examples/14-explain-composition.ts",
+    "examples": "npm run example:01 && npm run example:02 && npm run example:03 && npm run example:04 && npm run example:05 && npm run example:06 && npm run example:07 && npm run example:08 && npm run example:09 && npm run example:10 && npm run example:11 && npm run example:12 && npm run example:13 && npm run example:14",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "format": "prettier --write \"**/*.{ts,json,md}\"",
+    "format:check": "prettier --check \"**/*.{ts,json,md}\"",
+    "prepublishOnly": "npm run lint && npm run format:check && npm run build && npm test"
   },
   "keywords": [
     "container",
-    "system",
-    "utilities"
+    "dependency-injection",
+    "di",
+    "ioc",
+    "inversion-of-control",
+    "service-container",
+    "typescript",
+    "singleton",
+    "transient",
+    "contextual-binding"
   ],
   "author": "Kent Phung",
   "license": "DIB",
@@ -30,10 +74,13 @@
   "homepage": "https://github.com/khapu2906/treasure-chest#readme",
   "devDependencies": {
     "@types/node": "^24.10.0",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "vitest": "^4.0.7",
-    "vittest": "^1.0.2"
+    "@typescript-eslint/eslint-plugin": "^8.20.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "@vitest/coverage-v8": "^4.0.7",
+    "eslint": "^9.17.0",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.7"
   }
-}
+}

package/dist/index.d.ts

@@ -1,53 +0,0 @@
-/**
- * Treasure Chest Service Container in TypeScript
- * Supports:
- *  - bind / singleton
- *  - conditional binding
- *  - contextual binding
- *  - alias
- *  - resolve
- */
-type FactoryFn<T> = (c: Container) => T;
-type ConditionFn = (c: Container) => boolean;
-export declare class Container {
-    private bindings;
-    private instances;
-    private aliases;
-    private currentContext?;
-    /**
-     * Bind a dependency (default: transient)
-     */
-    bind<T>(key: string, factory: FactoryFn<T>, condition?: ConditionFn): void;
-    /**
-     * Bind a dependency as singleton (only one instance created)
-     */
-    singleton<T>(key: string, factory: FactoryFn<T>, condition?: ConditionFn): void;
-    /**
-     * Add an alias for an existing key
-     */
-    alias(aliasKey: string, originalKey: string): void;
-    /**
-     * Internal: find correct binding based on key + condition + context
-     */
-    private findBinding;
-    /**
-     * Resolve an instance from the container
-     */
-    resolve<T>(key: string, context?: string): T;
-    /**
-     * Contextual binding:
-     * Example:
-     *   container.when('UserService').needs('UserRepo').give(...)
-     */
-    when(context: string): {
-        needs: (depKey: string) => {
-            give: (factory: FactoryFn<any>) => void;
-        };
-    };
-    /**
-     * Clear all bindings and instances (useful for testing)
-     */
-    reset(): void;
-}
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,KAAK,CAAC,CAAC;AACxC,KAAK,WAAW,GAAG,CAAC,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC;AAU7C,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,cAAc,CAAC,CAAS;IAEhC;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW;IAInE;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW;IAIxE;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAI3C;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC;IA8B5C;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM;wBAEA,MAAM;4BACJ,SAAS,CAAC,GAAG,CAAC;;;IAYpC;;OAEG;IACH,KAAK;CAMN"}

package/dist/index.js

@@ -1,110 +0,0 @@
-"use strict";
-/**
- * Treasure Chest Service Container in TypeScript
- * Supports:
- *  - bind / singleton
- *  - conditional binding
- *  - contextual binding
- *  - alias
- *  - resolve
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Container = void 0;
-class Container {
-    constructor() {
-        this.bindings = [];
-        this.instances = {};
-        this.aliases = {};
-    }
-    /**
-     * Bind a dependency (default: transient)
-     */
-    bind(key, factory, condition) {
-        this.bindings.push({ key, factory, singleton: false, condition });
-    }
-    /**
-     * Bind a dependency as singleton (only one instance created)
-     */
-    singleton(key, factory, condition) {
-        this.bindings.push({ key, factory, singleton: true, condition });
-    }
-    /**
-     * Add an alias for an existing key
-     */
-    alias(aliasKey, originalKey) {
-        this.aliases[aliasKey] = originalKey;
-    }
-    /**
-     * Internal: find correct binding based on key + condition + context
-     */
-    findBinding(key, context) {
-        const realKey = this.aliases[key] || key;
-        const bindings = this.bindings.filter((b) => b.key === realKey);
-        if (bindings.length === 0) {
-            throw new Error(`No binding found for key: ${realKey}`);
-        }
-        // Priority:
-        // 1. Binding with context and condition true
-        // 2. Binding without context but condition true
-        // 3. Binding default first
-        const match = bindings.find((b) => b.context === context && (!b.condition || b.condition(this))) ||
-            bindings.find((b) => !b.context && (!b.condition || b.condition(this))) ||
-            bindings[0];
-        return match;
-    }
-    /**
-     * Resolve an instance from the container
-     */
-    resolve(key, context) {
-        const prevContext = this.currentContext;
-        this.currentContext = context || key;
-        // Get real key (resolve alias)
-        const realKey = this.aliases[key] || key;
-        const binding = this.findBinding(key, this.currentContext);
-        // Create unique cache key for contextual singletons
-        const cacheKey = binding.context
-            ? `${realKey}::${binding.context}`
-            : realKey;
-        // Return existing singleton instance
-        if (binding.singleton && this.instances[cacheKey]) {
-            this.currentContext = prevContext;
-            return this.instances[cacheKey];
-        }
-        const instance = binding.factory(this);
-        if (binding.singleton) {
-            this.instances[cacheKey] = instance;
-        }
-        this.currentContext = prevContext;
-        return instance;
-    }
-    /**
-     * Contextual binding:
-     * Example:
-     *   container.when('UserService').needs('UserRepo').give(...)
-     */
-    when(context) {
-        return {
-            needs: (depKey) => ({
-                give: (factory) => {
-                    this.bindings.push({
-                        key: depKey,
-                        factory,
-                        singleton: false,
-                        context,
-                    });
-                },
-            }),
-        };
-    }
-    /**
-     * Clear all bindings and instances (useful for testing)
-     */
-    reset() {
-        this.bindings = [];
-        this.instances = {};
-        this.aliases = {};
-        this.currentContext = undefined;
-    }
-}
-exports.Container = Container;
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

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