@venizia/ignis-docs 0.0.7 → 0.0.8-0

package/wiki/{references → extensions}/helpers/storage/index.md

@@ -7,6 +7,7 @@ Unified file storage abstraction with interchangeable backends for S3-compatible
 | Class | Extends | Backend | Implements |
 |-------|---------|---------|------------|
 | **MinioHelper** | `BaseStorageHelper` | S3-compatible (MinIO) | `IStorageHelper` |
+| **BunS3Helper** | `BaseStorageHelper` | S3-compatible (Bun-native) | `IStorageHelper` |
 | **DiskHelper** | `BaseStorageHelper` | Local filesystem | `IStorageHelper` |
 | **MemoryStorageHelper** | `BaseHelper` | In-memory key-value | -- |
 
@@ -19,6 +20,9 @@ import { DiskHelper, MemoryStorageHelper } from '@venizia/ignis-helpers';
 // MinIO storage (separate export path)
 import { MinioHelper } from '@venizia/ignis-helpers/minio';
 
+// Bun S3 storage (separate export path, Bun runtime only)
+import { BunS3Helper } from '@venizia/ignis-helpers/bun-s3';
+
 // Types
 import type {
   IStorageHelper,
@@ -32,6 +36,7 @@ import type {
   IListObjectsOptions,
 } from '@venizia/ignis-helpers';
 import type { IMinioHelperOptions } from '@venizia/ignis-helpers/minio';
+import type { IBunS3HelperOptions } from '@venizia/ignis-helpers/bun-s3';
 ```
 
 ## Creating an Instance
@@ -70,8 +75,38 @@ interface IMinioHelperOptions extends IStorageHelperOptions, ClientOptions {}
 | `scope` | `string` | `'MinioHelper'` | Logger scope name. |
 | `identifier` | `string` | `'MinioHelper'` | Helper identifier. |
 
-> [!TIP]
-> The underlying `minio.Client` is exposed as `storage.client` for direct access to any minio SDK method not covered by the `IStorageHelper` interface.
+> [!NOTE]
+> The underlying `minio.Client` is stored as a private property. Use the `IStorageHelper` methods for all operations. If you need direct minio SDK access, extend `MinioHelper` in a subclass.
+
+### Bun S3 Storage
+
+`BunS3Helper` provides S3-compatible storage using Bun's native `S3Client` for high-performance object operations. Bucket management operations (list, create, delete) use AWS Signature V4 signed requests, while object operations use Bun's native S3 API.
+
+> [!IMPORTANT]
+> `BunS3Helper` requires the **Bun runtime**. It uses Bun's built-in `S3Client` class which is not available in Node.js.
+
+```typescript
+import { BunS3Helper } from '@venizia/ignis-helpers/bun-s3';
+
+const storage = new BunS3Helper({
+  accessKey: 'minioadmin',
+  secretKey: 'minioadmin',
+  endpoint: 'http://localhost:9000',
+  region: 'us-east-1',
+});
+```
+
+#### IBunS3HelperOptions
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `accessKey` | `string` | -- | S3 access key credential. |
+| `secretKey` | `string` | -- | S3 secret key credential. |
+| `endpoint` | `string` | -- | S3-compatible endpoint URL (e.g., `'http://localhost:9000'`). |
+| `region` | `string` | `'us-east-1'` | AWS region for signing. |
+| `sessionToken` | `string` | -- | Optional session token for temporary credentials. |
+| `scope` | `string` | `'BunS3Helper'` | Logger scope name. |
+| `identifier` | `string` | `'BunS3Helper'` | Helper identifier. |
 
 ### Disk Storage
 
@@ -130,7 +165,7 @@ const cache = MemoryStorageHelper.newInstance<{ counter: number; name: string }>
 
 ## Usage
 
-`DiskHelper` and `MinioHelper` implement the same `IStorageHelper` interface, making them interchangeable. All examples below apply to both unless noted otherwise.
+`DiskHelper`, `MinioHelper`, and `BunS3Helper` implement the same `IStorageHelper` interface, making them interchangeable. All examples below apply to all three unless noted otherwise.
 
 ### Uploading Files
 
@@ -156,7 +191,7 @@ console.log(results);
 
 #### Custom Name and Link Normalization
 
-By default, file names are lowercased with spaces replaced by underscores. The default link prefix differs by backend: MinioHelper uses `/static-assets/{bucket}/{name}`, DiskHelper uses `/static-resources/{bucket}/{name}`. Override either with custom functions:
+By default, file names are lowercased with spaces replaced by underscores. The default link prefix differs by backend: MinioHelper and BunS3Helper use `/static-assets/{bucket}/{name}`, DiskHelper uses `/static-resources/{bucket}/{name}`. Override either with custom functions:
 
 ```typescript
 const results = await storage.upload({
@@ -195,7 +230,7 @@ const results = await storage.upload({
 ```
 
 > [!WARNING]
-> DiskHelper uses `/static-resources/` as the default link prefix, while MinioHelper uses `/static-assets/`. Provide a `normalizeLinkFn` if you need consistent links across storage backends.
+> DiskHelper uses `/static-resources/` as the default link prefix, while MinioHelper and BunS3Helper use `/static-assets/`. Provide a `normalizeLinkFn` if you need consistent links across storage backends.
 
 ### Downloading Files
 
@@ -252,7 +287,7 @@ console.log(stat);
 ```
 
 > [!NOTE]
-> DiskHelper populates `metadata.mimetype` using the `getMimeType()` extension-based lookup. It does not return `etag` or `versionId`. MinioHelper returns full metadata from the MinIO server including the original upload metadata, `etag`, and `versionId`.
+> DiskHelper populates `metadata.mimetype` using the `getMimeType()` extension-based lookup. It does not return `etag` or `versionId`. MinioHelper returns full metadata from the MinIO server including the original upload metadata, `etag`, and `versionId`. BunS3Helper returns `metadata` with `contentType` and `mimetype` from the S3 stat response, plus `etag` and `lastModified`.
 
 ### Listing Files
 
@@ -299,7 +334,7 @@ await storage.removeObjects({
 ```
 
 > [!NOTE]
-> DiskHelper's `removeObject()` throws if the file does not exist. DiskHelper's `removeObjects()` processes deletions sequentially. MinioHelper's `removeObjects()` delegates to the minio SDK's batch removal.
+> DiskHelper's `removeObject()` throws if the file does not exist. DiskHelper's `removeObjects()` processes deletions sequentially. MinioHelper's `removeObjects()` delegates to the minio SDK's batch removal. BunS3Helper's `removeObjects()` deletes in parallel via `Promise.all()`.
 
 ### Bucket Operations
 
@@ -408,6 +443,7 @@ class FileService {
 // Swap backends without changing service code
 const devService = new FileService(new DiskHelper({ basePath: './files' }));
 const prodService = new FileService(new MinioHelper({ /* ... */ }));
+const bunService = new FileService(new BunS3Helper({ /* ... */ }));
 ```
 
 #### Environment-Based Selection
@@ -574,7 +610,7 @@ try {
   - [Queue Helper](../queue/) -- Message queue processing
 
 - **References:**
-  - [Static Asset Component](/references/components/static-asset/) -- Serving stored files via HTTP
+  - [Static Asset Component](/extensions/components/static-asset/) -- Serving stored files via HTTP
   - [Request Utilities](/references/utilities/request) -- `parseMultipartBody` for file uploads
   - [API Reference](./api) -- Full method signatures and types
 

package/wiki/{references → extensions}/helpers/template/index.md

@@ -54,7 +54,7 @@ Use **GitHub-style only**:
 |----------|---------|
 | [Single Page](./single-page) | Tier 1 template -- one file per helper |
 
-Tier 2 follows the same two-page pattern as [Component Tier 2](../components/template/).
+Tier 2 follows the same two-page pattern as [Component Tier 2](../../components/template/).
 
 ## Source Paths
 

package/wiki/{references → extensions}/helpers/testing/index.md

@@ -270,14 +270,14 @@ The `_execute()` method on `TestCaseHandler` calls `assert.equal(validateRs, Tes
 
 ```
 BaseTestCaseHandler (abstract)
-  └── TestCaseHandler (abstract) -- execute(), getValidator(), validate()
-                                       └── Your concrete handler
+  +-- TestCaseHandler (abstract) -- execute(), getValidator(), validate()
+                                       +-- Your concrete handler
 
 BaseTestPlan (abstract)
-  └── TestPlan -- newInstance()
+  +-- TestPlan -- newInstance()
 
 TestDescribe -- withTestPlan(), run()
-  └── AppTestDescribe
+  +-- AppTestDescribe
 ```
 
 ### ITestPlanOptions

package/wiki/{references → extensions}/helpers/types/index.md

@@ -43,17 +43,16 @@ import type {
   TObjectFromFieldMappings,
   TInjectionGetter,
   IConfigurable,
-  TPermissionEffect,
 } from '@venizia/ignis-helpers';
 
 // Resolver functions
 import { resolveValue, resolveValueAsync, resolveClass } from '@venizia/ignis-helpers';
 
 // Constants
-import { Defaults, RuntimeModules, DataTypes, HTTP, MimeTypes } from '@venizia/ignis-helpers';
+import { Defaults, RuntimeModules, DataTypes, HTTP, GRPC, MimeTypes } from '@venizia/ignis-helpers';
 
 // Derived constant types
-import type { TRuntimeModule, TMimeTypes, THttpMethod, THttpResultCode } from '@venizia/ignis-helpers';
+import type { TRuntimeModule, TMimeTypes, THttpMethod, THttpResultCode, TGrpcMethod, TGrpcResultCode } from '@venizia/ignis-helpers';
 
 // JSX types (re-exported from hono/jsx)
 import type { Child, FC, PropsWithChildren } from '@venizia/ignis-helpers';
@@ -306,14 +305,6 @@ interface IConfigurable<Options extends object = any, Result = any> {
 
 Interface for components that require explicit initialization. Used by helpers and components that expose a `configure()` lifecycle method.
 
-### Domain Types
-
-```typescript
-type TPermissionEffect = 'allow' | 'deny';
-```
-
-Permission effect for authorization rules.
-
 ### JSX Types
 
 Re-exported from `hono/jsx` for convenience when building JSX-based views:
@@ -355,7 +346,7 @@ class RuntimeModules {
 type TRuntimeModule = TConstValue<typeof RuntimeModules>; // 'node' | 'bun'
 ```
 
-Runtime detection utility. `detect()` returns `'bun'` if running in Bun, `'node'` otherwise. `isBun()` and `isNode()` are convenience methods that call `detect()` internally.
+Runtime detection utility. `detect()` returns `'bun'` if `typeof Bun !== 'undefined'`, `'node'` otherwise. `isBun()` and `isNode()` are convenience methods that call `detect()` internally.
 
 #### DataTypes
 
@@ -404,7 +395,7 @@ The `HTTP` class groups all HTTP-related constants into nested objects.
 |----------|-------|
 | `HTTP.HeaderValues.APPLICATION_JSON` | `'application/json'` |
 | `HTTP.HeaderValues.APPLICATION_FORM_URLENCODED` | `'application/x-www-form-urlencoded'` |
-| `HTTP.HeaderValues.APPPLICATION_OCTET_STREAM` | `'application/octet-stream'` |
+| `HTTP.HeaderValues.APPLICATION_OCTET_STREAM` | `'application/octet-stream'` |
 | `HTTP.HeaderValues.MULTIPART_FORM_DATA` | `'multipart/form-data'` |
 | `HTTP.HeaderValues.TEXT_PLAIN` | `'text/plain'` |
 
@@ -483,6 +474,65 @@ type THttpMethod = ValueOf<typeof HTTP.Methods>;       // 'get' | 'post' | 'put'
 type THttpResultCode = ValueOf<typeof HTTP.ResultCodes>; // 0 | 1 | -199 | { Ok: 200, ... } | ...
 ```
 
+#### GRPC
+
+gRPC protocol constants for headers, methods, content types, and status codes.
+
+```typescript
+import { GRPC } from '@venizia/ignis-helpers';
+```
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `GRPC.Methods.UNARY` | `'unary'` | Single request, single response |
+| `GRPC.Methods.SERVER_STREAMING` | `'server_streaming'` | Single request, stream of responses |
+| `GRPC.Methods.CLIENT_STREAMING` | `'client_streaming'` | Stream of requests, single response |
+| `GRPC.Methods.BIDI_STREAMING` | `'bidi_streaming'` | Bidirectional streaming |
+| `GRPC.Headers.CONTENT_TYPE` | `'content-type'` | HTTP content type header |
+| `GRPC.Headers.TE` | `'te'` | Transfer encoding header |
+| `GRPC.Headers.USER_AGENT` | `'user-agent'` | User agent header |
+| `GRPC.Headers.GRPC_TIMEOUT` | `'grpc-timeout'` | gRPC timeout header |
+| `GRPC.Headers.GRPC_ENCODING` | `'grpc-encoding'` | gRPC encoding header |
+| `GRPC.Headers.GRPC_ACCEPT_ENCODING` | `'grpc-accept-encoding'` | gRPC accepted encodings header |
+| `GRPC.Headers.GRPC_MESSAGE_TYPE` | `'grpc-message-type'` | gRPC message type header |
+| `GRPC.Headers.GRPC_STATUS` | `'grpc-status'` | gRPC status code header |
+| `GRPC.Headers.GRPC_MESSAGE` | `'grpc-message'` | gRPC error message header |
+| `GRPC.Headers.GRPC_STATUS_DETAILS_BIN` | `'grpc-status-details-bin'` | gRPC binary status details header |
+| `GRPC.Headers.GRPC_PREVIOUS_RPC_ATTEMPTS` | `'grpc-previous-rpc-attempts'` | gRPC previous RPC attempts header |
+| `GRPC.Headers.GRPC_RETRY_PUSHBACK_MS` | `'grpc-retry-pushback-ms'` | gRPC retry pushback milliseconds header |
+| `GRPC.Headers.GRPC_TRACE_BIN` | `'grpc-trace-bin'` | gRPC binary trace context header |
+| `GRPC.Headers.GRPC_TAGS_BIN` | `'grpc-tags-bin'` | gRPC binary tags header |
+| `GRPC.HeaderValues.GRPC` | `'application/grpc'` | Standard gRPC content type |
+| `GRPC.HeaderValues.GRPC_PROTO` | `'application/grpc+proto'` | gRPC Protobuf content type |
+| `GRPC.HeaderValues.GRPC_JSON` | `'application/grpc+json'` | gRPC JSON content type |
+| `GRPC.HeaderValues.GRPC_WEB` | `'application/grpc-web'` | gRPC-Web content type |
+| `GRPC.HeaderValues.GRPC_WEB_PROTO` | `'application/grpc-web+proto'` | gRPC-Web Protobuf content type |
+| `GRPC.HeaderValues.GRPC_WEB_JSON` | `'application/grpc-web+json'` | gRPC-Web JSON content type |
+| `GRPC.HeaderValues.GRPC_WEB_TEXT` | `'application/grpc-web-text'` | gRPC-Web text content type |
+| `GRPC.ResultCodes.OK` | `0` | Success |
+| `GRPC.ResultCodes.CANCELLED` | `1` | Operation cancelled |
+| `GRPC.ResultCodes.UNKNOWN` | `2` | Unknown error |
+| `GRPC.ResultCodes.INVALID_ARGUMENT` | `3` | Invalid argument |
+| `GRPC.ResultCodes.DEADLINE_EXCEEDED` | `4` | Deadline exceeded |
+| `GRPC.ResultCodes.NOT_FOUND` | `5` | Not found |
+| `GRPC.ResultCodes.ALREADY_EXISTS` | `6` | Already exists |
+| `GRPC.ResultCodes.PERMISSION_DENIED` | `7` | Permission denied |
+| `GRPC.ResultCodes.RESOURCE_EXHAUSTED` | `8` | Resource exhausted |
+| `GRPC.ResultCodes.FAILED_PRECONDITION` | `9` | Failed precondition |
+| `GRPC.ResultCodes.ABORTED` | `10` | Operation aborted |
+| `GRPC.ResultCodes.OUT_OF_RANGE` | `11` | Out of range |
+| `GRPC.ResultCodes.UNIMPLEMENTED` | `12` | Unimplemented |
+| `GRPC.ResultCodes.INTERNAL` | `13` | Internal server error |
+| `GRPC.ResultCodes.UNAVAILABLE` | `14` | Service unavailable |
+| `GRPC.ResultCodes.DATA_LOSS` | `15` | Unrecoverable data loss |
+| `GRPC.ResultCodes.UNAUTHENTICATED` | `16` | Unauthenticated |
+
+```typescript
+// Derived types
+type TGrpcMethod = ValueOf<typeof GRPC.Methods>;
+type TGrpcResultCode = ValueOf<typeof GRPC.ResultCodes>;
+```
+
 #### MimeTypes
 
 ```typescript
@@ -507,6 +557,3 @@ Content type classification constants.
 - **References:**
   - [Repository Mixins](/references/base/repositories/mixins) - Uses mixin types
   - [Utilities Index](/references/utilities/index) - Type utilities
-
-- **Best Practices:**
-  - [Architectural Patterns](/best-practices/architectural-patterns) - TypeScript patterns

package/wiki/{references → extensions}/helpers/websocket/index.md

@@ -571,4 +571,4 @@ Thrown during `configure()` when a Redis client fails to reach `ready` status. C
 - [Socket.IO Helper](../socket-io/) -- Socket.IO-based alternative with Node.js support
 - [Redis Helper](../redis/) -- `RedisHelper` used for cross-instance messaging
 - [Crypto Helper](../crypto/) -- ECDH key exchange for WebSocket encryption
-- [WebSocket Component](/references/components/websocket/) -- Component-level lifecycle integration
+- [WebSocket Component](/extensions/components/websocket/) -- Component-level lifecycle integration

package/wiki/extensions/index.md

@@ -0,0 +1,48 @@
+# Extensions
+
+Extensions are optional packages and built-in modules that add functionality on top of the Ignis core framework. They are organized into two categories:
+
+## Components
+
+Components are self-contained feature modules that plug into your application via the `this.component()` registration method. Each component encapsulates its own bindings, controllers, and configuration.
+
+| Component | Description | Key Features |
+| :--- | :--- | :--- |
+| [Authentication](./components/authentication/) | Identity verification | JWT, Basic, JWKS strategies |
+| [Authorization](./components/authorization/) | Access control | Casbin-based RBAC, per-route policies |
+| [Health Check](./components/health-check) | Liveness & readiness | `/health`, `/health/live`, `/health/ready` |
+| [Mail](./components/mail/) | Email delivery | Nodemailer, Mailgun, queue support |
+| [Request Tracker](./components/request-tracker) | Request tracing | `x-request-id` header, body parsing |
+| [Socket.IO](./components/socket-io/) | Real-time (Socket.IO) | Redis adapter, room-based messaging |
+| [Static Asset](./components/static-asset/) | File management | Upload/download, MinIO, Disk, BunS3 |
+| [Swagger](./components/swagger) | API docs | OpenAPI UI, Swagger UI, Scalar UI |
+| [WebSocket](./components/websocket/) | Real-time (native) | Bun native WebSocket, encryption |
+
+## Helpers
+
+Helpers are standalone utility classes for infrastructure concerns. They extend `BaseHelper` for scoped logging and are typically used via dependency injection.
+
+| Helper | Description | Peer Dependencies |
+| :--- | :--- | :--- |
+| [Cron](./helpers/cron/) | Scheduled tasks | `cron` |
+| [Crypto](./helpers/crypto/) | Encryption/signing | Built-in |
+| [Environment](./helpers/env/) | Env var management | Built-in |
+| [Error](./helpers/error/) | Error utilities | Built-in |
+| [Inversion](./helpers/inversion/) | DI container | Built-in |
+| [Logger](./helpers/logger/) | Logging | `winston` |
+| [Network](./helpers/network/) | HTTP/TCP/UDP clients | `axios` (optional) |
+| [Kafka](./helpers/kafka/) | Kafka messaging | `@platformatic/kafka` |
+| [Queue](./helpers/queue/) | Job queues | `bullmq`, `mqtt` (optional) |
+| [Redis](./helpers/redis/) | Redis client | `ioredis` |
+| [Socket.IO](./helpers/socket-io/) | Socket.IO server | `socket.io` |
+| [Storage](./helpers/storage/) | File storage | `minio` (optional) |
+| [Testing](./helpers/testing/) | Test utilities | Built-in |
+| [Types](./helpers/types/) | Shared types | Built-in |
+| [UID](./helpers/uid/) | Snowflake IDs | Built-in |
+| [WebSocket](./helpers/websocket/) | WebSocket server | Built-in |
+| [Worker Thread](./helpers/worker-thread/) | Worker pools | Built-in |
+
+## See Also
+
+- [Core API](/references/) -- Base framework abstractions
+- [Guides](/guides/) -- Getting started and tutorials

package/wiki/guides/core-concepts/application/bootstrapping.md

@@ -12,24 +12,22 @@ Bootstrapping is the process of automatically discovering and loading applicatio
 
 ```typescript
 export class Application extends BaseApplication {
-  constructor() {
-    super(configs);
-    
+  preConfigure() {
     // Manual registration - tedious and error-prone
     this.dataSource(PostgresDataSource);
     this.dataSource(MongoDataSource);
-    
+
     this.repository(UserRepository);
     this.repository(ProductRepository);
     this.repository(OrderRepository);
     this.repository(CustomerRepository);
     // ... 50+ more repositories
-    
+
     this.service(AuthService);
     this.service(UserService);
     this.service(ProductService);
     // ... 50+ more services
-    
+
     this.controller(AuthController);
     this.controller(UserController);
     this.controller(ProductController);
@@ -48,7 +46,8 @@ export class Application extends BaseApplication {
 
 ```typescript
 export const appConfigs: IApplicationConfigs = {
-  name: 'MyApp',
+  // ... other config
+  path: { base: '/', isStrict: true },
   bootOptions: {
     datasources: { dirs: ['datasources'] },
     repositories: { dirs: ['repositories'] },
@@ -58,8 +57,7 @@ export const appConfigs: IApplicationConfigs = {
 };
 
 export class Application extends BaseApplication {
-  constructor() {
-    super(appConfigs);
+  preConfigure() {
     // That's it! Everything auto-discovered and registered
   }
 }
@@ -97,6 +95,8 @@ protected override getDefaultExtensions(): string[] {
 }
 ```
 
+The `configure()` method merges user-provided options with defaults: `dirs`, `extensions`, `isNested` (defaults to `true`), and optional `glob` override.
+
 #### Phase 2: Discover
 
 Booters scan the filesystem for matching files:
@@ -206,7 +206,7 @@ const bootOptions: IBootOptions = {
 
 ## Built-in Booters
 
-The framework provides four built-in booters:
+The framework provides four built-in booters. They are registered automatically by `BaseApplication.registerBooters()`:
 
 ### DatasourceBooter
 
@@ -215,6 +215,7 @@ The framework provides four built-in booters:
 | Directories | `['datasources']` |
 | Extensions | `['.datasource.js']` |
 | Binding Key | `datasources.{ClassName}` |
+| Binding Scope | **Singleton** |
 
 **Discovers:**
 - `datasources/postgres.datasource.js` → `PostgresDataSource`
@@ -227,6 +228,7 @@ The framework provides four built-in booters:
 | Directories | `['repositories']` |
 | Extensions | `['.repository.js']` |
 | Binding Key | `repositories.{ClassName}` |
+| Binding Scope | Transient |
 
 **Discovers:**
 - `repositories/user.repository.js` → `UserRepository`
@@ -239,6 +241,7 @@ The framework provides four built-in booters:
 | Directories | `['services']` |
 | Extensions | `['.service.js']` |
 | Binding Key | `services.{ClassName}` |
+| Binding Scope | Transient |
 
 **Discovers:**
 - `services/auth.service.js` → `AuthService`
@@ -251,6 +254,7 @@ The framework provides four built-in booters:
 | Directories | `['controllers']` |
 | Extensions | `['.controller.js']` |
 | Binding Key | `controllers.{ClassName}` |
+| Binding Scope | Transient |
 
 **Discovers:**
 - `controllers/auth.controller.js` → `AuthController`
@@ -258,7 +262,15 @@ The framework provides four built-in booters:
 
 ## Execution Order
 
-Boot system respects dependency order:
+The `Bootstrapper` orchestrates all booters. It discovers booters via `findByTag({ tag: 'booter' })` and runs each phase sequentially across all booters:
+
+```
+Phase: CONFIGURE  → DatasourceBooter → RepositoryBooter → ServiceBooter → ControllerBooter
+Phase: DISCOVER   → DatasourceBooter → RepositoryBooter → ServiceBooter → ControllerBooter
+Phase: LOAD       → DatasourceBooter → RepositoryBooter → ServiceBooter → ControllerBooter
+```
+
+The default registration order in `BaseApplication.registerBooters()` ensures dependency order:
 
 ```
 1. DatasourceBooter   → Datasources must be available first
@@ -271,37 +283,44 @@ This ensures dependencies are available when artifacts are constructed.
 
 ## When Boot Runs
 
-### Automatic Boot
+### Integrated Boot
 
-Boot runs automatically during `initialize()` if `bootOptions` is configured:
+Boot runs as part of `BaseApplication` when `bootOptions` is configured. `BaseApplication.registerBooters()` is called during `initialize()`:
 
 ```typescript
 const app = new Application();
-await app.start();  // initialize() → boot() → start()
+await app.start();  // initialize() → registerBooters() + boot() → start HTTP server
 ```
 
 ### Manual Boot
 
-Explicitly control boot execution:
+Explicitly call `boot()` on the application:
 
 ```typescript
 const app = new Application();
-await app.boot({
-  phases: ['configure', 'discover', 'load'],
-  booters: ['ControllerBooter', 'ServiceBooter']  // only these booters
-});
+const report = await app.boot();
 ```
 
-### Partial Boot
+### Using BootMixin (Alternative)
 
-Run only specific phases:
+For custom container classes that are not `BaseApplication`, use the `BootMixin`:
 
 ```typescript
-await app.boot({
-  phases: ['discover']  // only discover, don't load
-});
+import { BootMixin } from '@venizia/ignis-boot';
+import { Container } from '@venizia/ignis-inversion';
+
+class MyApp extends BootMixin(Container) {
+  bootOptions = {
+    controllers: { dirs: ['controllers'] },
+  };
+}
+
+const app = new MyApp();
+await app.boot();
 ```
 
+The `BootMixin` auto-registers all four default booters and the `Bootstrapper` in its constructor.
+
 ## File Naming Conventions
 
 Follow these conventions for auto-discovery:
@@ -434,8 +453,8 @@ bootOptions: {
 Create custom booters for new artifact types:
 
 ```typescript
-import { BaseArtifactBooter, IBooterOptions } from '@venizia/ignis-boot';
-import { inject } from '@venizia/ignis-inversion';
+import { BaseArtifactBooter, IApplication, IBootOptions } from '@venizia/ignis-boot';
+import { BindingKeys, inject } from '@venizia/ignis-inversion';
 
 export class MiddlewareBooter extends BaseArtifactBooter {
   constructor(
@@ -443,10 +462,10 @@ export class MiddlewareBooter extends BaseArtifactBooter {
     @inject({ key: '@app/instance' }) private app: IApplication,
     @inject({ key: '@app/boot-options' }) bootOptions: IBootOptions,
   ) {
-    super({ 
-      scope: MiddlewareBooter.name, 
-      root, 
-      artifactOptions: bootOptions.middlewares ?? {} 
+    super({
+      scope: MiddlewareBooter.name,
+      root,
+      artifactOptions: bootOptions.middlewares ?? {}
     });
   }
 
@@ -460,7 +479,8 @@ export class MiddlewareBooter extends BaseArtifactBooter {
 
   protected async bind(): Promise<void> {
     for (const cls of this.loadedClasses) {
-      this.app.bind({ key: `middlewares.${cls.name}` }).toClass(cls);
+      const key = BindingKeys.build({ namespace: 'middlewares', key: cls.name });
+      this.app.bind({ key }).toClass(cls).setTags('middlewares');
     }
   }
 }
@@ -470,11 +490,9 @@ export class MiddlewareBooter extends BaseArtifactBooter {
 
 ```typescript
 export class Application extends BaseApplication {
-  override async initialize() {
-    // Register custom booter
+  override preConfigure() {
+    // Register custom booter before boot runs
     this.booter(MiddlewareBooter);
-    
-    await super.initialize();
   }
 }
 ```
@@ -537,7 +555,7 @@ this.booter(CustomRepositoryBooter);  // after datasource
 
 ```bash
 # From project root
-npx glob "your-pattern/**/*.controller.js"
+bunx glob "your-pattern/**/*.controller.js"
 ```
 
 ## Best Practices
@@ -562,7 +580,7 @@ npx glob "your-pattern/**/*.controller.js"
 
 - **Related Concepts:**
   - [Application Overview](./index) - Main application class
-  - [Controllers](/guides/core-concepts/controllers) - Auto-discovered controllers
+  - [Controllers](/guides/core-concepts/rest-controllers) - Auto-discovered controllers
   - [Services](/guides/core-concepts/services) - Auto-discovered services
   - [Repositories](/guides/core-concepts/persistent/repositories) - Auto-discovered repositories