@venizia/ignis-docs 0.0.6-0 → 0.0.6-2

package/wiki/references/src-details/helpers.md

@@ -1,211 +0,0 @@
-# Package: `@venizia/ignis-helpers`
-
-## Helpers Package Directory: Detailed Breakdown
-
-The `@venizia/ignis-helpers` package consolidates a wide array of reusable helper classes and utility functions designed to support various cross-cutting concerns within the Ignis framework. This package promotes modularity by extracting common functionalities into a standalone, easily consumable library.
-
-## Project Structure Overview
-
-Here's the top-level breakdown of the `src` directory within `@packages/helpers/`:
-
-| Folder          | Purpose                                                                                                      |
-| :-------------- | :----------------------------------------------------------------------------------------------------------- |
-| **`__tests__`** | Contains unit and integration tests for the helper utilities.                                                |
-| **`base`**      | Provides foundational helper classes, such as `BaseHelper`.                                                  |
-| **`common`**    | Stores shared constants and types used across the helpers.                                                   |
-| **`helpers`**   | A collection of specialized helper modules for various functionalities (e.g., cron, crypto, network, queue). |
-| **`utilities`** | Contains pure, standalone utility functions for common tasks (e.g., parsing, date manipulation).             |
-
----
-
-## Detailed Sections
-
-### `__tests__`
-
-This directory is dedicated to the test suite for the `@venizia/ignis-helpers` package.
-
-| File/Folder             | Purpose/Key Details                                                        |
-| :---------------------- | :------------------------------------------------------------------------- |
-| `index.ts`              | Entry point for running tests within the helpers package.                  |
-| `jwt/`                  | Contains test cases specifically for JWT-related helper functions, if any. |
-| `jwt/test-cases/jwt.ts` | Example: defines `TestCase001` to check JWT creation in a helper context.  |
-
-### `base`
-
-This foundational layer provides base classes that other helpers extend.
-
-#### `base/helpers`
-
-| File/Folder | Purpose/Key Details                                                                                                                      |
-| :---------- | :--------------------------------------------------------------------------------------------------------------------------------------- |
-| `base.ts`   | Defines `BaseHelper`, a generic base class providing common utilities like a logger instance and scope management for all other helpers. |
-
-### `common`
-
-This directory holds various shared definitions and constants used throughout the helpers package.
-
-| File/Folder  | Purpose/Key Details                                                                                                                         |
-| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------ |
-| `constants/` | Contains application-wide constants such as `HTTP` methods and status codes, `MimeTypes`, `RuntimeModules` (Bun, Node.js), and `DataTypes`. |
-| `types.ts`   | Contains general TypeScript utility types like `ValueOrPromise`, `AnyObject`, `IClass`, `TMixinTarget`, and `IProvider`.                    |
-
-### `helpers`
-
-This directory groups specialized helper modules by their functionality.
-
-#### `helpers/cron/`
-
-| File/Folder      | Purpose/Key Details                                                          |
-| :--------------- | :--------------------------------------------------------------------------- |
-| `cron.helper.ts` | `CronHelper` for scheduling and managing cron jobs using the `cron` library. |
-
-#### `helpers/crypto/`
-
-Cryptographic utilities.
-
-| File/Folder   | Purpose/Key Details                               |
-| :------------ | :------------------------------------------------ |
-| `algorithms/` | AES and RSA encryption/decryption algorithms.     |
-| `common/`     | Common types and constants for crypto operations. |
-
-#### `helpers/env/`
-
-| File/Folder  | Purpose/Key Details                                                      |
-| :----------- | :----------------------------------------------------------------------- |
-| `app-env.ts` | `ApplicationEnvironment` for structured access to environment variables. |
-
-#### `helpers/error/`
-
-| File/Folder    | Purpose/Key Details                                       |
-| :------------- | :-------------------------------------------------------- |
-| `app-error.ts` | `ApplicationError` class for standardized error handling. |
-
-#### `helpers/inversion/`
-
-Application-enhanced Dependency Injection (DI) module that extends `@venizia/ignis-inversion`.
-
-> **Note:** The core DI functionality (Container, Binding, MetadataRegistry base classes) has been extracted to the standalone `@venizia/ignis-inversion` package. This module extends and re-exports that functionality with application-specific enhancements.
-
-| File/Folder    | Purpose/Key Details                                                                                           |
-| :------------- | :------------------------------------------------------------------------------------------------------------ |
-| `container.ts` | Extended `Container` class with `ApplicationLogger` integration.                                              |
-| `registry.ts`  | Extended `MetadataRegistry` with framework-specific metadata (controllers, models, repositories, datasources).|
-| `common/keys.ts`| Framework-specific `MetadataKeys` (CONTROLLER, MODEL, REPOSITORY, etc.) merged with base keys.               |
-| `common/types.ts`| Framework-specific interfaces (`IControllerMetadata`, `IModelMetadata`, `IRepositoryMetadata`, etc.).        |
-| `index.ts`     | Re-exports core classes from `@venizia/ignis-inversion` plus application extensions.                              |
-
-**Re-exported from `@venizia/ignis-inversion`:**
-- `Binding`, `BindingKeys`, `BindingScopes`, `BindingValueTypes`
-
-**Application-specific additions:**
-- `Container` with `ApplicationLogger` integration
-- `MetadataRegistry` with `setControllerMetadata`, `setModelMetadata`, `setRepositoryMetadata`, etc.
-- Framework metadata interfaces for controllers, models, repositories, and data sources
-
-For standalone DI usage without framework features, import directly from `@venizia/ignis-inversion`.
-
-#### `helpers/logger/`
-
-Logging solution built on Winston.
-
-| File/Folder                     | Purpose/Key Details                                                    |
-| :------------------------------ | :--------------------------------------------------------------------- |
-| `application-logger.ts`         | `ApplicationLogger` for structured logging with scopes.                |
-| `default-logger.ts`             | Default Winston logger configuration with console and file transports. |
-| `factory.ts`                    | `LoggerFactory` for obtaining logger instances.                        |
-| `transports/dgram.transport.ts` | UDP transport for log aggregation.                                     |
-| `types.ts`                      | Log level definitions.                                                 |
-
-#### `helpers/network/`
-
-Utilities for network communication.
-
-| File/Folder     | Purpose/Key Details                                                             |
-| :-------------- | :------------------------------------------------------------------------------ |
-| `http-request/` | HTTP client implementations (`AxiosNetworkRequest`, `NodeFetchNetworkRequest`). |
-| `tcp-socket/`   | TCP and TLS socket client/server helpers.                                       |
-| `udp-socket/`   | UDP client helper.                                                              |
-
-#### `helpers/queue/`
-
-Message queuing solutions.
-
-| File/Folder | Purpose/Key Details                             |
-| :---------- | :---------------------------------------------- |
-| `bullmq/`   | `BullMQHelper` for Redis-backed message queues. |
-| `mqtt/`     | `MQTTClientHelper` for MQTT broker interaction. |
-| `internal/` | `QueueHelper` for simple in-memory queues.      |
-| `common/`   | Common types for queue operations.              |
-
-#### `helpers/redis/`
-
-Redis client helpers.
-
-| File/Folder         | Purpose/Key Details                                                |
-| :------------------ | :----------------------------------------------------------------- |
-| `cluster.helper.ts` | `RedisClusterHelper` for Redis cluster connections.                |
-| `default.helper.ts` | `DefaultRedisHelper` providing a unified API for Redis operations. |
-| `single.helper.ts`  | `RedisHelper` for single Redis instance connections.               |
-| `types.ts`          | Interfaces and types for Redis helpers.                            |
-
-#### `helpers/socket-io/`
-
-Socket.IO client and server helpers.
-
-| File/Folder | Purpose/Key Details                                           |
-| :---------- | :------------------------------------------------------------ |
-| `client/`   | `SocketIOClientHelper` for client-side Socket.IO connections. |
-| `server/`   | `SocketIOServerHelper` for server-side Socket.IO management.  |
-| `common/`   | Common types and constants for Socket.IO.                     |
-
-#### `helpers/storage/`
-
-Storage utilities.
-
-| File/Folder  | Purpose/Key Details                                    |
-| :----------- | :----------------------------------------------------- |
-| `in-memory/` | `MemoryStorageHelper` for in-memory key-value storage. |
-| `minio/`     | `MinioHelper` for S3-compatible object storage.        |
-
-#### `helpers/testing/`
-
-Framework for writing and executing tests using `node:test`.
-
-| File/Folder         | Purpose/Key Details                                         |
-| :------------------ | :---------------------------------------------------------- |
-| `base-test-plan.ts` | Abstract base for test plans.                               |
-| `common/`           | Common types and constants for testing utilities.           |
-| `describe.ts`       | `TestDescribe` integrates with `node:test` lifecycle hooks. |
-| `test-case.ts`      | Defines individual test cases.                              |
-| `test-handler.ts`   | Base class for test case handlers.                          |
-| `test-plan.ts`      | `TestPlan` for organizing test suites.                      |
-
-#### `helpers/worker-thread/`
-
-Utilities for Node.js worker threads.
-
-| File/Folder      | Purpose/Key Details                                         |
-| :--------------- | :---------------------------------------------------------- |
-| `base.ts`        | Base classes for workers and worker threads.                |
-| `types.ts`       | Interfaces and types for worker threads.                    |
-| `worker-bus.ts`  | Helpers for inter-thread communication using `MessagePort`. |
-| `worker-pool.ts` | `WorkerPoolHelper` for managing a pool of worker threads.   |
-
-### `utilities`
-
-This directory contains pure, standalone utility functions that perform common, stateless operations.
-
-| File/Folder              | Purpose/Key Details                                                                                                                                                                                                                                                     |
-| :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `crypto.utility.ts`      | Provides a `hash()` function for cryptographic hashing (SHA256, MD5).                                                                                                                                                                                                   |
-| `date.utility.ts`        | Date and time manipulation functions (`dayjs` integration, `sleep`, `isWeekday`, `getDateTz`, `hrTime`).                                                                                                                                                                |
-| `module.utility.ts`      | `validateModule()` to check for module existence at runtime.                                                                                                                                                                                                            |
-| `parse.utility.ts`       | Functions for type checking (`isInt`, `isFloat`), type conversion (`int`, `float`, `toBoolean`), string/object transformation (`toCamel`, `keysToCamel`), array transformations (`parseArrayToRecordWithKey`, `parseArrayToMapWithKey`), and `getUID()` for unique IDs. |
-| `performance.utility.ts` | Utilities for measuring code execution time (`executeWithPerformanceMeasure`, `getPerformanceCheckpoint`, `getExecutedPerformance`).                                                                                                                                    |
-| `promise.utility.ts`     | Helper functions for Promises (`executePromiseWithLimit`, `isPromiseLike`, `transformValueOrPromise`, `getDeepProperty`).                                                                                                                                               |
-| `request.utility.ts`     | Utilities for handling HTTP request data, such as `parseMultipartBody` for multipart form data.                                                                                                                                                                         |
-| `schema.utility.ts`      | Helper functions and predefined schemas for `zod` and `@hono/zod-openapi` (`jsonContent`, `jsonResponse`, `requiredString`, `AnyObjectSchema`, `IdParamsSchema`, `UUIDParamsSchema`).                                                                                   |
-
----
-
-This detailed breakdown illustrates the modular and layered design of the Ignis framework, emphasizing its extensibility and adherence to robust architectural patterns.

package/wiki/references/src-details/index.md

@@ -1,86 +0,0 @@
-# Framework Internals
-
-Deep dive into Ignis package structure and source code organization.
-
-## Quick Reference
-
-| Package | npm | Purpose |
-|---------|-----|---------|
-| `@venizia/ignis` | Core | Main framework with controllers, repositories, components |
-| `@venizia/ignis-boot` | Boot | Auto-discovery and bootstrapping utilities |
-| `@venizia/ignis-helpers` | Helpers | Reusable utilities (logger, crypto, redis, etc.) |
-| `@venizia/ignis-inversion` | Inversion | Standalone dependency injection container |
-| `@venizia/dev-configs` | Dev Configs | TypeScript, ESLint, Prettier configurations |
-| `@venizia/ignis-docs` | Docs | Documentation site and MCP server |
-
-## Monorepo Structure
-
-```
-ignis/
-├── packages/
-│   ├── core/           → @venizia/ignis (main framework)
-│   ├── boot/           → @venizia/ignis-boot (auto-discovery)
-│   ├── helpers/        → @venizia/ignis-helpers (utilities)
-│   ├── inversion/      → @venizia/ignis-inversion (DI container)
-│   ├── dev-configs/    → @venizia/dev-configs (linting/formatting)
-│   └── docs/           → @venizia/ignis-docs (documentation)
-├── examples/           → Example applications
-└── scripts/            → Build and maintenance scripts
-```
-
-## Package Dependencies
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                    @venizia/ignis                        │
-│                   (Core Framework)                       │
-│                                                         │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
-│  │ base/        │  │ components/  │  │ utilities/   │  │
-│  │ (Controllers,│  │ (Auth, Swagger,│ │ (Crypto,     │  │
-│  │  Repos, etc.)│  │  HealthCheck) │ │  Date, etc.) │  │
-│  └──────────────┘  └──────────────┘  └──────────────┘  │
-└────────────────────────┬────────────────────────────────┘
-                         │ depends on
-         ┌───────────────┼───────────────┐
-         ▼               ▼               ▼
-┌────────────────┐ ┌────────────┐ ┌────────────────┐
-│ @vez/ignis-boot│ │@vez/ignis- │ │ @vez/ignis-    │
-│ (Auto-Discovery)│ │  helpers   │ │  inversion     │
-│                │ │ (Logger,   │ │ (DI Container) │
-│                │ │  Redis,etc)│ │                │
-└────────────────┘ └─────┬──────┘ └────────────────┘
-                         │ depends on
-                         ▼
-               ┌─────────────────────┐
-               │ @vez/ignis-inversion│
-               │   (Standalone DI)   │
-               └─────────────────────┘
-```
-
-## What's in This Section
-
-### Core Package
-- [Core (@venizia/ignis)](./core.md) - Main framework with base classes, components, and utilities
-
-### Supporting Packages
-- [Boot (@venizia/ignis-boot)](./boot.md) - Automatic artifact discovery and registration
-- [Helpers (@venizia/ignis-helpers)](./helpers.md) - Reusable helper classes (logger, crypto, redis, etc.)
-- [Inversion (@venizia/ignis-inversion)](./inversion.md) - Standalone dependency injection container
-
-### Development Tools
-- [Dev Configs (@venizia/dev-configs)](./dev-configs.md) - Shared TypeScript, ESLint, Prettier configs
-- [Documentation (@venizia/ignis-docs)](./docs.md) - VitePress site and wiki structure
-- [MCP Docs Server](./mcp-server.md) - Model Context Protocol server for AI-assisted development
-
-## Package Purposes
-
-| Package | When to Use |
-|---------|-------------|
-| **@venizia/ignis** | Building Ignis applications (always needed) |
-| **@venizia/ignis-boot** | Auto-discovery of controllers, services, repositories |
-| **@venizia/ignis-helpers** | Standalone utilities without full framework |
-| **@venizia/ignis-inversion** | DI container without framework dependencies |
-| **@venizia/dev-configs** | Consistent dev tooling across projects |
-
-> **Related:** [Core Concepts Guide](../../guides/core-concepts/application/) | [Base Abstractions Reference](../base/)

package/wiki/references/src-details/inversion.md

@@ -1,340 +0,0 @@
-# Package: `@venizia/ignis-inversion`
-
-## Overview
-
-The `@venizia/ignis-inversion` package provides a standalone, lightweight Dependency Injection (DI) and Inversion of Control (IoC) container. This package was extracted from `@venizia/ignis-helpers` to enable independent usage and better modularity.
-
-## Package Information
-
-| Property | Value |
-|----------|-------|
-| **Package Name** | `@venizia/ignis-inversion` |
-| **Location** | `packages/inversion/` |
-| **Purpose** | Standalone DI/IoC container |
-| **Dependencies** | `lodash`, `reflect-metadata`, `zod` |
-
-## Key Features
-
-- **Flexible Binding Strategies**: Class, Value, and Provider-based bindings
-- **Scope Management**: Singleton and Transient scopes
-- **Metadata-driven Injection**: Constructor and property injection via decorators
-- **Tag-based Discovery**: Find bindings by tag for modular composition
-- **Type-safe**: Full TypeScript support with generics
-
----
-
-## Core Components
-
-### Binding Class
-
-The `Binding<T>` class represents a single dependency registration in the container.
-
-#### Binding Methods
-
-| Method | Description | Returns |
-|--------|-------------|---------|
-| `toClass(cls)` | Bind to a class constructor | `this` |
-| `toValue(value)` | Bind to a static value | `this` |
-| `toProvider(fn)` | Bind to a provider function or class | `this` |
-| `setScope(scope)` | Set binding scope (SINGLETON/TRANSIENT) | `this` |
-| `setTags(...tags)` | Add tags for discovery | `this` |
-| `getValue(container)` | Resolve the bound value | `T` |
-| `clearCache()` | Clear singleton cache | `void` |
-
-#### Binding Example
-
-```typescript
-import { Binding, BindingScopes } from '@venizia/ignis-inversion';
-
-// Create a binding
-const binding = new Binding<MyService>({ key: 'services.MyService' })
-  .toClass(MyService)
-  .setScope(BindingScopes.SINGLETON)
-  .setTags('services', 'core');
-```
-
-### Container Class
-
-The `Container` class is the main DI container for managing bindings and resolving dependencies.
-
-#### Container Methods
-
-| Method | Description | Returns |
-|--------|-------------|---------|
-| `bind<T>({ key })` | Create a new binding | `Binding<T>` |
-| `isBound({ key })` | Check if binding exists | `boolean` |
-| `getBinding<T>({ key })` | Get a specific binding | `Binding<T> \| undefined` |
-| `unbind({ key })` | Remove a binding | `boolean` |
-| `get<T>({ key, isOptional? })` | Resolve a dependency | `T \| undefined` |
-| `resolve<T>(cls)` | Instantiate a class with injection | `T` |
-| `instantiate<T>(cls)` | Same as resolve | `T` |
-| `findByTag<T>({ tag })` | Find bindings by tag | `Binding<T>[]` |
-| `clear()` | Clear singleton caches | `void` |
-| `reset()` | Clear all bindings | `void` |
-
-#### Container Example
-
-```typescript
-import { Container, BindingScopes } from '@venizia/ignis-inversion';
-
-const container = new Container({ scope: 'MyApp' });
-
-// Bind a class
-container.bind<UserService>({ key: 'services.UserService' })
-  .toClass(UserService)
-  .setScope(BindingScopes.SINGLETON);
-
-// Bind a value
-container.bind<string>({ key: 'config.apiUrl' })
-  .toValue('https://api.example.com');
-
-// Bind a provider
-container.bind<DatabaseConnection>({ key: 'database' })
-  .toProvider((container) => {
-    const config = container.get<Config>({ key: 'config' });
-    return new DatabaseConnection(config.dbUrl);
-  });
-
-// Resolve dependencies
-const userService = container.get<UserService>({ key: 'services.UserService' });
-```
-
-### MetadataRegistry Class
-
-The `MetadataRegistry` stores and retrieves decorator metadata for DI.
-
-#### Registry Methods
-
-| Method | Description |
-|--------|-------------|
-| `define({ target, key, value })` | Define metadata on a target |
-| `get({ target, key })` | Get metadata from a target |
-| `has({ target, key })` | Check if metadata exists |
-| `delete({ target, key })` | Delete metadata |
-| `getKeys({ target })` | Get all metadata keys |
-| `setPropertyMetadata(...)` | Set property injection metadata |
-| `getPropertiesMetadata(...)` | Get all property metadata |
-| `setInjectMetadata(...)` | Set constructor injection metadata |
-| `getInjectMetadata(...)` | Get constructor injection metadata |
-
----
-
-## Types and Interfaces
-
-### Binding Scopes
-
-```typescript
-import { BindingScopes } from '@venizia/ignis-inversion';
-
-BindingScopes.SINGLETON  // Single instance, reused
-BindingScopes.TRANSIENT  // New instance each request (default)
-```
-
-### Binding Value Types
-
-```typescript
-import { BindingValueTypes } from '@venizia/ignis-inversion';
-
-BindingValueTypes.CLASS     // Bind to class constructor
-BindingValueTypes.VALUE     // Bind to static value
-BindingValueTypes.PROVIDER  // Bind to provider function/class
-```
-
-### Provider Interface
-
-```typescript
-interface IProvider<T> {
-  value(container: Container): T;
-}
-
-// Example provider class
-class DatabaseProvider implements IProvider<DatabaseConnection> {
-  value(container: Container): DatabaseConnection {
-    const config = container.get<Config>({ key: 'config' });
-    return new DatabaseConnection(config.dbUrl);
-  }
-}
-```
-
-### BindingKeys Helper
-
-```typescript
-import { BindingKeys } from '@venizia/ignis-inversion';
-
-const key = BindingKeys.build({ namespace: 'services', key: 'UserService' });
-// Result: 'services.UserService'
-```
-
-### Type Definitions
-
-| Type | Description |
-|------|-------------|
-| `TNullable<T>` | `T \| undefined \| null` |
-| `TClass<T>` | Class constructor type |
-| `TConstructor<T>` | Generic constructor |
-| `TBindingScope` | `'singleton' \| 'transient'` |
-| `IPropertyMetadata` | Property injection metadata |
-| `IInjectMetadata` | Constructor injection metadata |
-
-
-## Injection Metadata
-
-### Property Injection
-
-```typescript
-interface IPropertyMetadata {
-  bindingKey: string | symbol;
-  isOptional?: boolean;
-  [key: string]: any;
-}
-```
-
-### Constructor Injection
-
-```typescript
-interface IInjectMetadata {
-  key: string | symbol;
-  index: number;
-  isOptional?: boolean;
-}
-```
-
-
-## Project Structure
-
-```
-packages/inversion/
-├── package.json
-├── tsconfig.json
-├── src/
-│   ├── index.ts              # Main exports + reflect-metadata import
-│   ├── container.ts          # Container and Binding classes
-│   ├── registry.ts           # MetadataRegistry class
-│   └── common/
-│       ├── index.ts          # Common exports
-│       ├── types.ts          # Types, interfaces, BindingScopes, etc.
-│       ├── keys.ts           # MetadataKeys symbols
-│       ├── app-error.ts      # ApplicationError class
-│       ├── base-helper.ts    # BaseHelper base class
-│       └── logger.ts         # Simple Logger class
-├── scripts/
-│   ├── build.sh
-│   ├── clean.sh
-│   └── rebuild.sh
-└── dist/                     # Built output
-```
-
-
-## Usage Examples
-
-### Basic Container Usage
-
-```typescript
-import { Container, BindingScopes } from '@venizia/ignis-inversion';
-
-// Create container
-const container = new Container();
-
-// Register services
-container.bind({ key: 'logger' }).toValue(console);
-container.bind({ key: 'services.UserService' })
-  .toClass(UserService)
-  .setScope(BindingScopes.SINGLETON);
-
-// Resolve
-const logger = container.get({ key: 'logger' });
-const userService = container.get({ key: 'services.UserService' });
-```
-
-### Using Providers
-
-```typescript
-import { Container, IProvider } from '@venizia/ignis-inversion';
-
-// Function provider
-container.bind({ key: 'database' })
-  .toProvider((container) => {
-    return new Database(container.get({ key: 'config.dbUrl' }));
-  });
-
-// Class provider
-class ConfigProvider implements IProvider<Config> {
-  value(container: Container): Config {
-    return {
-      env: process.env.NODE_ENV,
-      port: parseInt(process.env.PORT || '3000'),
-    };
-  }
-}
-
-container.bind({ key: 'config' }).toProvider(ConfigProvider);
-```
-
-### Tag-based Discovery
-
-```typescript
-// Register with tags
-container.bind({ key: 'handlers.UserHandler' })
-  .toClass(UserHandler)
-  .setTags('handlers', 'user');
-
-container.bind({ key: 'handlers.OrderHandler' })
-  .toClass(OrderHandler)
-  .setTags('handlers', 'order');
-
-// Find all handlers
-const handlers = container.findByTag({ tag: 'handlers' });
-handlers.forEach(binding => {
-  const handler = binding.getValue(container);
-  // Use handler...
-});
-```
-
-### Optional Dependencies
-
-```typescript
-// Get optional dependency (returns undefined if not bound)
-const cache = container.get<CacheService>({
-  key: 'services.CacheService',
-  isOptional: true
-});
-
-if (cache) {
-  // Use cache service
-}
-```
-
-
-## Integration with Framework
-
-The core `@venizia/ignis` package extends this base inversion package with:
-
-- **ApplicationLogger integration**: Container with structured logging
-- **Framework-specific metadata**: Controllers, models, repositories, data sources
-- **Decorator implementations**: `@inject`, `@controller`, `@service`, etc.
-
-For framework usage, import from `@venizia/ignis`. For standalone DI container usage, import directly from `@venizia/ignis-inversion`.
-
-```typescript
-// Standalone usage
-import { Container, Binding } from '@venizia/ignis-inversion';
-
-// Framework usage (includes logging and framework metadata)
-import { Container, inject, service } from '@venizia/ignis';
-```
-
-
-## Building the Package
-
-```bash
-cd packages/inversion
-
-# Build
-bun run build
-
-# Clean
-bun run clean
-
-# Rebuild (clean + build)
-bun run rebuild
-```