@venizia/ignis-inversion 0.0.1-2 → 0.0.1-3

package/LICENSE.md

@@ -0,0 +1,102 @@
+# Ignis Framework License
+
+Ignis is a TypeScript Server Infrastructure framework built on [Hono](https://hono.dev/).
+
+## MIT License
+
+Copyright (c) 2025 VENIZIA Ltd. Co.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Packages
+
+This monorepo contains the following packages, all licensed under MIT:
+
+| Package | Description |
+|---------|-------------|
+| `@venizia/ignis` | Core framework - controllers, services, decorators |
+| `@venizia/ignis-helpers` | Utility helpers - logging, cron, Redis, queues, storage |
+| `@venizia/ignis-inversion` | Dependency Injection & IoC container |
+| `@venizia/dev-configs` | Shared ESLint, Prettier, TypeScript configurations |
+| `@venizia/ignis-docs` | Documentation and MCP Server |
+
+---
+
+## Third-Party Dependencies
+
+Ignis uses the following open-source libraries. We are grateful to the authors and contributors of these projects.
+
+### Core Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Hono](https://github.com/honojs/hono) | MIT | Ultrafast web framework |
+| [Zod](https://github.com/colinhacks/zod) | MIT | TypeScript-first schema validation |
+| [Drizzle ORM](https://github.com/drizzle-team/drizzle-orm) | Apache-2.0 | TypeScript ORM |
+| [Jose](https://github.com/panva/jose) | MIT | JavaScript Object Signing and Encryption |
+
+### Helpers Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Winston](https://github.com/winstonjs/winston) | MIT | Universal logging library |
+| [BullMQ](https://github.com/taskforcesh/bullmq) | MIT | Message queue and job scheduling |
+| [IORedis](https://github.com/redis/ioredis) | MIT | Redis client for Node.js |
+| [MinIO](https://github.com/minio/minio-js) | Apache-2.0 | S3-compatible object storage client |
+| [Axios](https://github.com/axios/axios) | MIT | HTTP client |
+| [Day.js](https://github.com/iamkun/dayjs) | MIT | Date manipulation library |
+| [Cron](https://github.com/kelektiv/node-cron) | MIT | Cron job scheduler |
+| [Socket.IO](https://github.com/socketio/socket.io) | MIT | Real-time bidirectional communication |
+| [MQTT.js](https://github.com/mqttjs/MQTT.js) | MIT | MQTT client |
+
+### Utility Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Lodash](https://github.com/lodash/lodash) | MIT | Utility library |
+| [reflect-metadata](https://github.com/rbuckton/reflect-metadata) | Apache-2.0 | Metadata reflection API |
+
+### Documentation Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [VitePress](https://github.com/vuejs/vitepress) | MIT | Static site generator |
+| [Fuse.js](https://github.com/krisk/fuse) | Apache-2.0 | Fuzzy search library |
+| [gray-matter](https://github.com/jonschlinkert/gray-matter) | MIT | Front-matter parser |
+
+---
+
+## Acknowledgments
+
+Ignis Framework is inspired by and built upon the work of many open-source projects:
+
+- **[Hono](https://hono.dev/)** by Yusuke Wada - The ultrafast web framework that powers Ignis
+- **[LoopBack 4](https://loopback.io/)** by IBM/StrongLoop - Inspiration for the enterprise architecture patterns
+- **[NestJS](https://nestjs.com/)** by Kamil Mysliwiec - Inspiration for decorator-based controllers
+- **[InversifyJS](https://inversify.io/)** - Inspiration for the IoC container design
+
+We thank all the maintainers and contributors of these projects for their excellent work.
+
+---
+
+## Contributing
+
+By contributing to Ignis, you agree that your contributions will be licensed under the MIT License.

package/README.md

@@ -0,0 +1,57 @@
+# @venizia/ignis-inversion
+
+[![npm version](https://img.shields.io/npm/v/@venizia/ignis-inversion.svg)](https://www.npmjs.com/package/@venizia/ignis-inversion)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A standalone **Dependency Injection & Inversion of Control (IoC)** container for the **Ignis Framework**.
+
+## Installation
+
+```bash
+bun add @venizia/ignis-inversion
+# or
+npm install @venizia/ignis-inversion
+```
+
+## Quick Example
+
+```typescript
+import { Container, injectable, inject } from "@venizia/ignis-inversion";
+
+@injectable()
+class UserService {
+  getUser(id: string) {
+    return { id, name: "John" };
+  }
+}
+
+@injectable()
+class UserController {
+  constructor(@inject("UserService") private userService: UserService) {}
+
+  findUser(id: string) {
+    return this.userService.getUser(id);
+  }
+}
+
+// Register and resolve
+const container = new Container();
+container.bind("UserService").toClass(UserService);
+container.bind("UserController").toClass(UserController);
+
+const controller = container.resolve<UserController>("UserController");
+```
+
+## About Ignis
+
+Ignis brings together the structured, enterprise development experience of **LoopBack 4** with the blazing speed and simplicity of **Hono** - giving you the best of both worlds.
+
+## Documentation
+
+- [Ignis Repository](https://github.com/venizia-ai/ignis)
+- [Getting Started](https://github.com/venizia-ai/ignis/blob/main/packages/docs/wiki/get-started/index.md)
+- [Dependency Injection](https://github.com/venizia-ai/ignis/blob/main/packages/docs/wiki/get-started/core-concepts/dependency-injection.md)
+
+## License
+
+MIT

package/dist/common/app-error.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from 'zod';
 export declare const ErrorSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     statusCode: z.ZodOptional<z.ZodNumber>;

package/dist/common/base-helper.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseHelper = void 0;
 class BaseHelper {
     constructor(opts) {
-        this.scope = opts.scope ?? "";
-        this.identifier = opts.identifier ?? "";
+        this.scope = opts.scope ?? '';
+        this.identifier = opts.identifier ?? '';
     }
 }
 exports.BaseHelper = BaseHelper;

package/dist/common/index.d.ts

@@ -1,6 +1,6 @@
-export * from "./app-error";
-export * from "./base-helper";
-export * from "./keys";
-export * from "./logger";
-export * from "./types";
+export * from './app-error';
+export * from './base-helper';
+export * from './keys';
+export * from './logger';
+export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/common/keys.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetadataKeys = void 0;
 exports.MetadataKeys = {
     // Property metadata
-    PROPERTIES: Symbol.for("ignis:properties"),
+    PROPERTIES: Symbol.for('ignis:properties'),
     // Injection metadata
-    INJECT: Symbol.for("ignis:inject"),
+    INJECT: Symbol.for('ignis:inject'),
 };
 //# sourceMappingURL=keys.js.map

package/dist/common/types.d.ts

@@ -1,4 +1,4 @@
-import { Container } from "./../container";
+import { Container } from './../container';
 export type TNullable<T> = T | undefined | null;
 export type ValueOrPromise<T> = T | Promise<T>;
 export type ValueOf<T> = T[keyof T];

package/dist/common/types.js

@@ -7,24 +7,24 @@ exports.BindingKeys = exports.BindingValueTypes = exports.BindingScopes = export
 const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
 const app_error_1 = require("./app-error");
 const isClass = (target) => {
-    return typeof target === "function" && target.prototype !== undefined;
+    return typeof target === 'function' && target.prototype !== undefined;
 };
 exports.isClass = isClass;
 const isClassProvider = (target) => {
-    return (typeof target === "function" && target.prototype && typeof target.prototype.value === "function");
+    return (typeof target === 'function' && target.prototype && typeof target.prototype.value === 'function');
 };
 exports.isClassProvider = isClassProvider;
 // -----------------------------------------------------------------------
 class BindingScopes {
-    static { this.SINGLETON = "singleton"; }
-    static { this.TRANSIENT = "transient"; }
+    static { this.SINGLETON = 'singleton'; }
+    static { this.TRANSIENT = 'transient'; }
 }
 exports.BindingScopes = BindingScopes;
 // -----------------------------------------------------------------------
 class BindingValueTypes {
-    static { this.CLASS = "class"; }
-    static { this.VALUE = "value"; }
-    static { this.PROVIDER = "provider"; }
+    static { this.CLASS = 'class'; }
+    static { this.VALUE = 'value'; }
+    static { this.PROVIDER = 'provider'; }
 }
 exports.BindingValueTypes = BindingValueTypes;
 // -----------------------------------------------------------------------
@@ -41,7 +41,7 @@ class BindingKeys {
             });
         }
         keyParts.push(key);
-        return keyParts.join(".");
+        return keyParts.join('.');
     }
 }
 exports.BindingKeys = BindingKeys;

package/dist/container.d.ts

@@ -1,5 +1,5 @@
-import { BaseHelper } from "./common/base-helper";
-import { BindingValueTypes, IProvider, TBindingScope, TClass, TConstValue, TNullable } from "./common/types";
+import { BaseHelper } from './common/base-helper';
+import { BindingValueTypes, IProvider, TBindingScope, TClass, TConstValue, TNullable } from './common/types';
 export declare class Binding<T = any> extends BaseHelper {
     key: string;
     private bindScope;

package/dist/container.js

@@ -13,7 +13,7 @@ class Binding extends base_helper_1.BaseHelper {
         this.bindScope = types_1.BindingScopes.TRANSIENT;
         this.tags = new Set([]);
         this.key = opts.key;
-        const keyParts = this.key.split(".");
+        const keyParts = this.key.split('.');
         if (keyParts.length > 1) {
             const [namespace] = keyParts;
             this.setTags(namespace);
@@ -139,15 +139,15 @@ class Container extends base_helper_1.BaseHelper {
     getBinding(opts) {
         let key = null;
         switch (typeof opts.key) {
-            case "string": {
+            case 'string': {
                 key = opts.key;
                 break;
             }
-            case "symbol": {
+            case 'symbol': {
                 key = opts.key.toString();
                 break;
             }
-            case "object": {
+            case 'object': {
                 key = types_1.BindingKeys.build(opts.key);
                 break;
             }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import "reflect-metadata";
-export * from "./common";
-export * from "./container";
-export * from "./registry";
+import 'reflect-metadata';
+export * from './common';
+export * from './container';
+export * from './registry';
 //# sourceMappingURL=index.d.ts.map

package/dist/registry.d.ts

@@ -1,5 +1,5 @@
-import { BaseHelper } from "./common/base-helper";
-import { IInjectMetadata, IPropertyMetadata, TClass } from "./common/types";
+import { BaseHelper } from './common/base-helper';
+import { IInjectMetadata, IPropertyMetadata, TClass } from './common/types';
 /**
  * Central metadata registry for storing and retrieving decorator metadata
  */

package/dist/registry.js

@@ -15,7 +15,7 @@ class MetadataRegistry extends base_helper_1.BaseHelper {
     // -----------------------------------------------------------------
     define(opts) {
         const { target, key, value } = opts;
-        logger_1.Logger.debug("[define] Set metadata | target: %s | key: %s | value: %j", target.constructor.name, key.toString(), value);
+        logger_1.Logger.debug('[define] Set metadata | target: %s | key: %s | value: %j', target.constructor.name, key.toString(), value);
         Reflect.defineMetadata(key, value, target);
     }
     // -----------------------------------------------------------------
@@ -37,14 +37,14 @@ class MetadataRegistry extends base_helper_1.BaseHelper {
     getKeys(opts) {
         const { target } = opts;
         return (Reflect.getMetadataKeys(target)?.filter(key => {
-            return typeof key === "symbol" || typeof key === "string";
+            return typeof key === 'symbol' || typeof key === 'string';
         }) ?? []);
     }
     // -----------------------------------------------------------------
     getMethodNames(opts) {
         const { target } = opts;
         const prototype = target.prototype;
-        const methods = Object.getOwnPropertyNames(prototype).filter(name => name !== "constructor" && typeof prototype[name] === "function");
+        const methods = Object.getOwnPropertyNames(prototype).filter(name => name !== 'constructor' && typeof prototype[name] === 'function');
         return methods;
     }
     // -----------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-inversion",
-  "version": "0.0.1-2",
+  "version": "0.0.1-3",
   "description": "Dependency Injection & Inversion of Control Container",
   "keywords": [
     "dependency injection",
@@ -23,7 +23,7 @@
   },
   "files": [
     "README.md",
-    "LICENSE",
+    "LICENSE.md",
     "dist",
     "!/**/tests",
     "!/**/dist/tests",
@@ -44,17 +44,12 @@
     "prettier:cli": "prettier \"**/*.{js,ts}\" -l",
     "prettier:fix": "bun run prettier:cli --write",
     "rebuild": "sh ./scripts/rebuild.sh no-version",
-    "rebuild:major": "sh ./scripts/rebuild.sh major",
-    "rebuild:minor": "sh ./scripts/rebuild.sh minor",
-    "rebuild:patch": "sh ./scripts/rebuild.sh patch",
-    "rebuild:premajor": "sh ./scripts/rebuild.sh premajor",
-    "rebuild:preminor": "sh ./scripts/rebuild.sh preminor",
-    "rebuild:prepatch": "sh ./scripts/rebuild.sh prepatch",
-    "rebuild:prerelease": "sh ./scripts/rebuild.sh prerelease"
+    "prepublishOnly": "bun run rebuild"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/VENIZIA-AI/ignis.git"
+    "url": "git+https://github.com/VENIZIA-AI/ignis.git",
+    "directory": "packages/inversion"
   },
   "author": {
     "name": "VENIZIA AI Developer",