@venizia/ignis-docs 0.0.6-3 → 0.0.7-1

package/dist/mcp-server/tools/github/view-source-file.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-source-file.tool.js","sourceRoot":"","sources":["../../../../mcp-server/tools/github/view-source-file.tool.ts"],"names":[],"mappings":";;;AAAA,8CAAgD;AAChD,6BAAwB;AACxB,4CAAwC;AACxC,kDAAoD;AAEpD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;CAY7B,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACpF,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;CACjF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,kBAAmB,SAAQ,oBAAiD;IAAzF;;QACW,OAAE,GAAG,gBAAgB,CAAC;QACtB,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IA2BvC,CAAC;IAzBC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,MAAM,GAAG,MAAM,sBAAY,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE9E,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,IAAA,kBAAU,EAAC;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;CACF;AA/BD,gDA+BC"}
+{"version":3,"file":"view-source-file.tool.js","sourceRoot":"","sources":["../../../../mcp-server/tools/github/view-source-file.tool.ts"],"names":[],"mappings":";;;AAAA,8CAAgD;AAChD,6BAAwB;AACxB,4CAAwC;AACxC,kDAAoD;AAEpD,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;CAY7B,CAAC;AAEF,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACpF,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;CACjF,CAAC,CAAC;AAEH,MAAa,kBAAmB,SAAQ,oBAAiD;IAAzF;;QACW,OAAE,GAAG,gBAAgB,CAAC;QACtB,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IA2BvC,CAAC;IAzBC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,MAAM,GAAG,MAAM,sBAAY,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE9E,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,IAAA,kBAAU,EAAC;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;CACF;AA/BD,gDA+BC"}

package/dist/mcp-server/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../mcp-server/tools/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../mcp-server/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/mcp-server/tools/index.js

@@ -14,9 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-// Base class
 __exportStar(require("./base.tool"), exports);
-// Tool classes
 __exportStar(require("./docs"), exports);
 __exportStar(require("./github"), exports);
 //# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../mcp-server/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,aAAa;AACb,8CAA4B;AAE5B,eAAe;AACf,yCAAuB;AACvB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../mcp-server/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,yCAAuB;AACvB,2CAAyB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-docs",
-  "version": "0.0.6-3",
+  "version": "0.0.7-1",
   "description": "Interactive documentation site and MCP (Model Context Protocol) server for the Ignis Framework. Includes a VitePress-powered documentation site with guides, API references, and best practices. Ships an MCP server (CLI: ignis-docs-mcp) with 11 tools for AI assistants to search docs, browse source code, verify dependencies, and access real-time framework knowledge. Built with Mastra MCP SDK and Fuse.js fuzzy search.",
   "keywords": [
     "ai",

package/wiki/best-practices/api-usage-examples.md

@@ -11,7 +11,8 @@ Use `@get`, `@post` decorators with `as const` route configs for full type safet
 **`src/controllers/test/definitions.ts`**
 ```typescript
 import { z } from '@hono/zod-openapi';
-import { Authentication, HTTP, jsonContent, jsonResponse } from '@venizia/ignis';
+import { Authentication, jsonContent, jsonResponse } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 // Define route configs as const for type inference
 export const RouteConfigs = {
@@ -52,8 +53,8 @@ import {
   get,
   post,
   TRouteContext,
-  HTTP,
 } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { RouteConfigs } from './definitions';
 
 @controller({ path: '/test' })
@@ -90,7 +91,8 @@ You can also define routes manually within the controller's `binding()` method u
 
 **`src/controllers/test/controller.ts`**
 ```typescript
-import { BaseController, controller, HTTP, ValueOrPromise } from '@venizia/ignis';
+import { BaseController, controller, ValueOrPromise } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { RouteConfigs } from './definitions';
 
 @controller({ path: '/test' })
@@ -301,7 +303,7 @@ server.use('/api/*', rateLimiter({ maxRequests: 100 }));
 ### Middleware with Logging
 
 ```typescript
-import { BaseHelper } from '@venizia/ignis';
+import { BaseHelper } from '@venizia/ignis-helpers';
 import { createMiddleware } from 'hono/factory';
 
 export const requestLogger = (): MiddlewareHandler => {
@@ -496,7 +498,7 @@ Use `getError()` to throw structured errors that are automatically formatted by
 ### Throwing Errors
 
 ```typescript
-import { getError, HTTP } from '@venizia/ignis';
+import { getError, HTTP } from '@venizia/ignis-helpers';
 
 // Basic error
 throw getError({ message: 'Something went wrong' });

package/wiki/best-practices/code-style-standards/advanced-patterns.md

@@ -7,7 +7,7 @@ Advanced TypeScript patterns used throughout the Ignis framework.
 Create reusable class extensions without deep inheritance:
 
 ```typescript
-import { TMixinTarget } from '@venizia/ignis';
+import { TMixinTarget } from '@venizia/ignis-helpers';
 
 export const LoggableMixin = <BaseClass extends TMixinTarget<Base>>(
   baseClass: BaseClass,

package/wiki/best-practices/code-style-standards/constants-configuration.md

@@ -210,7 +210,7 @@ export class EnvironmentKeys {
 
 **Usage:**
 ```typescript
-import { applicationEnvironment } from '@venizia/ignis';
+import { applicationEnvironment } from '@venizia/ignis-helpers';
 import { EnvironmentKeys } from '@/common/environments';
 
 // Correct usage

package/wiki/best-practices/code-style-standards/control-flow.md

@@ -123,7 +123,7 @@ Use the `getError` helper and `HTTP` constants to throw consistent, formatted ex
 ### Basic Error
 
 ```typescript
-import { getError, HTTP } from '@venizia/ignis';
+import { getError, HTTP } from '@venizia/ignis-helpers';
 
 if (!record) {
   throw getError({

package/wiki/best-practices/code-style-standards/function-patterns.md

@@ -125,7 +125,7 @@ async syncData() {
 **With the helper utility:**
 
 ```typescript
-import { executeWithPerformanceMeasure } from '@venizia/ignis';
+import { executeWithPerformanceMeasure } from '@venizia/ignis-helpers';
 
 await executeWithPerformanceMeasure({
   logger: this.logger.for('syncData'),

package/wiki/best-practices/common-pitfalls.md

@@ -66,7 +66,7 @@ export class Application extends BaseApplication {
 
 -   **Bad:**
     ```typescript
-    import { ApplicationError, getError } from '@venizia/ignis';
+    import { ApplicationError, getError } from '@venizia/ignis-helpers';
 
     // In a Controller
     async createUser(c: Context) {

package/wiki/best-practices/data-modeling.md

@@ -375,7 +375,39 @@ export class User extends BaseEntity<typeof User.schema> {
 
 > **Reference:** See [Hidden Properties](../references/base/models.md#hidden-properties) for complete documentation.
 
-## 6. Database Migrations
+## 6. Authorization Settings
+
+Declare your model's authorization principal in `@model` settings to make the model the single source of truth for permission subjects:
+
+```typescript
+@model({
+  type: 'entity',
+  settings: {
+    authorize: { principal: 'user' },
+    hiddenProperties: ['password'],
+  },
+})
+export class User extends BaseEntity<typeof User.schema> {
+  static override schema = pgTable('User', {
+    ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+    email: text('email').notNull(),
+    password: text('password'),
+  });
+}
+
+// User.AUTHORIZATION_SUBJECT === 'user' (auto-populated)
+```
+
+**Key points:**
+
+- `AUTHORIZATION_SUBJECT` is auto-set from `authorize.principal` by the `@model` decorator
+- Use `Model.AUTHORIZATION_SUBJECT` in route configs instead of hardcoded strings
+- Explicit `static AUTHORIZATION_SUBJECT = '...'` on the class takes precedence
+- The `authorize` settings are extensible via index signature for custom metadata
+
+> **Reference:** See [Model-Based Resource References](../references/components/authorization/usage#model-based-resource-references) for full authorization integration.
+
+## 7. Database Migrations
 
 Drizzle Kit handles schema migrations. Follow these best practices for safe migrations.
 

package/wiki/best-practices/error-handling.md

@@ -16,7 +16,7 @@ Comprehensive guide to handling errors gracefully in Ignis applications.
 Ignis provides `getError` for creating consistent, structured errors.
 
 ```typescript
-import { getError, HTTP } from '@venizia/ignis';
+import { getError, HTTP } from '@venizia/ignis-helpers';
 
 // Basic error
 throw getError({
@@ -68,7 +68,8 @@ Database constraint violations (unique, foreign key, not null, check) are automa
 ### Service Layer Errors
 
 ```typescript
-import { BaseService, getError, HTTP } from '@venizia/ignis';
+import { BaseService } from '@venizia/ignis';
+import { getError, HTTP } from '@venizia/ignis-helpers';
 
 export class UserService extends BaseService {
   async createUser(data: TCreateUserRequest): Promise<TUser> {
@@ -160,7 +161,8 @@ Database constraint violations (unique, foreign key, not null, check) are **auto
 You don't need to wrap repository calls in try-catch for constraint errors. If you need custom error messages, you can still handle them explicitly:
 
 ```typescript
-import { BaseRepository, getError, HTTP } from '@venizia/ignis';
+import { BaseRepository } from '@venizia/ignis';
+import { getError, HTTP } from '@venizia/ignis-helpers';
 
 export class UserRepository extends BaseRepository<typeof User.schema> {
   async createWithCustomError(data: TCreateUser): Promise<TCreateResult<TUser>> {
@@ -185,7 +187,8 @@ export class UserRepository extends BaseRepository<typeof User.schema> {
 Ignis includes a built-in error handler. Customize behavior in your application:
 
 ```typescript
-import { BaseApplication, ApplicationError } from '@venizia/ignis';
+import { BaseApplication } from '@venizia/ignis';
+import { ApplicationError } from '@venizia/ignis-helpers';
 
 export class Application extends BaseApplication {
   override setupMiddlewares(): void {

package/wiki/best-practices/performance-optimization.md

@@ -7,7 +7,7 @@ Optimize your Ignis application for speed and scalability.
 Identify bottlenecks before optimizing:
 
 ```typescript
-import { executeWithPerformanceMeasure } from '@venizia/ignis';
+import { executeWithPerformanceMeasure } from '@venizia/ignis-helpers';
 
 await executeWithPerformanceMeasure({
   logger: this.logger,

package/wiki/best-practices/security-guidelines.md

@@ -72,7 +72,8 @@ const SecureRoute = {
 
 **Access user in protected routes:**
 ```typescript
-import { Authentication, IJWTTokenPayload, ApplicationError, getError } from '@venizia/ignis';
+import { Authentication, IJWTTokenPayload } from '@venizia/ignis';
+import { ApplicationError, getError } from '@venizia/ignis-helpers';
 
 const user = c.get(Authentication.CURRENT_USER) as IJWTTokenPayload;
 if (!user.roles.includes('admin')) {
@@ -132,7 +133,7 @@ When handling file uploads, prevent **path traversal attacks** and ensure safe f
 **Solution:** Use `sanitizeFilename()` to strip dangerous patterns:
 
 ```typescript
-import { sanitizeFilename } from '@venizia/ignis';
+import { sanitizeFilename } from '@venizia/ignis-helpers';
 
 // ❌ DANGEROUS - User-controlled filename
 const unsafeFilename = req.body.filename; // Could be "../../../etc/passwd"
@@ -154,7 +155,7 @@ fs.writeFileSync(`./uploads/${safeFilename}`, data);
 Use `createContentDispositionHeader()` for secure download responses:
 
 ```typescript
-import { createContentDispositionHeader, sanitizeFilename } from '@venizia/ignis';
+import { createContentDispositionHeader, sanitizeFilename } from '@venizia/ignis-helpers';
 
 async downloadFile(c: Context) {
   const filename = sanitizeFilename(c.req.param('filename'));
@@ -177,7 +178,7 @@ async downloadFile(c: Context) {
 Use `parseMultipartBody()` for safe file uploads with automatic sanitization:
 
 ```typescript
-import { parseMultipartBody } from '@venizia/ignis';
+import { parseMultipartBody } from '@venizia/ignis-helpers';
 
 async uploadFile(c: Context) {
   const files = await parseMultipartBody({

package/wiki/guides/core-concepts/components-guide.md

@@ -133,11 +133,11 @@ import {
   controller,
   post,
   inject,
-  HTTP,
   jsonContent,
   jsonResponse,
   TRouteContext,
 } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { z } from '@hono/zod-openapi';
 import { NotificationService } from '../services';
 

package/wiki/guides/core-concepts/controllers.md

@@ -9,7 +9,8 @@ Controllers handle HTTP requests and return responses - they're your API endpoin
 Extend `BaseController` and use decorators to define routes:
 
 ```typescript
-import { BaseController, controller, get, jsonResponse, z, HTTP } from '@venizia/ignis';
+import { BaseController, controller, get, jsonResponse, z } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { Context } from 'hono';
 
 @controller({ path: '/users' })
@@ -70,7 +71,8 @@ The `opts` object contains a `configs` property that defines the route's path, r
 For optimal organization and type safety, define your route configurations in a constant with `as const`. This allows TypeScript to precisely infer the types for your request data and expected responses within your handler methods.
 
 ```typescript
-import { BaseController, controller, get, post, HTTP, jsonContent, jsonResponse, TRouteContext } from '@venizia/ignis';
+import { BaseController, controller, get, post, jsonContent, jsonResponse, TRouteContext } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { z } from '@hono/zod-openapi';
 
 // Define route configs as const for type inference
@@ -161,7 +163,8 @@ When using this method, you will override the `binding()` method in your control
 Use this method for defining a single API endpoint with all its configurations and handler. It also benefits from type inference when used with `TRouteContext`.
 
 ```typescript
-import { Authentication, HTTP, jsonResponse, z, TRouteContext } from '@venizia/ignis';
+import { Authentication, jsonResponse, z, TRouteContext } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 // ... inside the binding() method
 
@@ -188,7 +191,8 @@ this.defineRoute({
 This method offers a fluent API for defining routes, similar to `defineRoute`, but structured for chaining. It also benefits from `TRouteContext` for type safety.
 
 ```typescript
-import { jsonResponse, z, TRouteContext, HTTP } from '@venizia/ignis';
+import { jsonResponse, z, TRouteContext } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 // ... inside the binding() method
 
@@ -309,7 +313,7 @@ this.defineJSXRoute({
 
 ```typescript
 // src/views/pages/home.page.tsx
-import type { FC } from '@venizia/ignis';
+import type { FC } from '@venizia/ignis-helpers';
 import { MainLayout } from '../layouts/main.layout';
 
 interface HomePageProps {
@@ -330,7 +334,7 @@ export const HomePage: FC<HomePageProps> = ({ user }) => {
 
 ```typescript
 // src/views/layouts/main.layout.tsx
-import type { FC, PropsWithChildren } from '@venizia/ignis';
+import type { FC, PropsWithChildren } from '@venizia/ignis-helpers';
 
 interface MainLayoutProps {
   title: string;
@@ -369,7 +373,8 @@ When you define Zod schemas in your route's `request` configuration (whether wit
 
 ```typescript
 import { z } from '@hono/zod-openapi';
-import { jsonContent, put, HTTP } from '@venizia/ignis';
+import { jsonContent, put } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 // ... inside a controller class
 
@@ -406,7 +411,8 @@ Using `c.req.valid()` is the recommended way to access request data as it ensure
 
 ```typescript
 import { z } from '@hono/zod-openapi';
-import { jsonContent, put, TRouteContext, HTTP } from '@venizia/ignis';
+import { jsonContent, put, TRouteContext } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 // ... inside a controller class
 

package/wiki/guides/core-concepts/persistent/models.md

@@ -208,6 +208,38 @@ const [fullUser] = await connector
 For complete hidden properties documentation, see the [Models Reference](../../../references/base/models.md#hidden-properties).
 :::
 
+## Authorization Settings
+
+Declare your model's authorization principal directly in `@model` settings. The decorator auto-populates `AUTHORIZATION_SUBJECT` for type-safe references in route configs:
+
+```typescript
+import { BaseEntity, generateIdColumnDefs, model, AuthorizationActions } from '@venizia/ignis';
+import { pgTable, text } from 'drizzle-orm/pg-core';
+
+@model({
+  type: 'entity',
+  settings: {
+    authorize: { principal: 'article' },
+  },
+})
+export class Article extends BaseEntity<typeof Article.schema> {
+  static override schema = pgTable('Article', {
+    ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+    title: text('title').notNull(),
+  });
+}
+
+// Use in route configs — no hardcoded strings
+authorize: {
+  action: AuthorizationActions.READ,
+  resource: Article.AUTHORIZATION_SUBJECT, // 'article'
+}
+```
+
+:::tip
+For full authorization integration details, see the [Authorization Usage Reference](../../../references/components/authorization/usage#model-based-resource-references).
+:::
+
 ## Model Template
 
 ```typescript

package/wiki/guides/core-concepts/services.md

@@ -18,7 +18,8 @@ Services contain the core business logic of your application. They orchestrate t
 To create a service, you extend the `BaseService` class and inject the repositories or other services it depends on.
 
 ```typescript
-import { BaseService, inject, getError } from '@venizia/ignis';
+import { BaseService, inject } from '@venizia/ignis';
+import { getError } from '@venizia/ignis-helpers';
 import { ConfigurationRepository } from '../repositories';
 import { UserRepository } from '../repositories';
 import { LoggingService } from './logging.service'; // Example of another service

package/wiki/guides/get-started/5-minute-quickstart.md

@@ -84,11 +84,11 @@ import {
   BaseController,
   controller,
   get,
-  HTTP,
   IApplicationInfo,
   jsonContent,
   SwaggerComponent,
 } from "@venizia/ignis";
+import { HTTP } from "@venizia/ignis-helpers";
 import { Context } from "hono";
 import appInfo from "./../package.json";
 

package/wiki/guides/tutorials/building-a-crud-api.md

@@ -647,7 +647,8 @@ For complex validation or business rules, create a Service layer:
 
 ```typescript
 // src/services/todo.service.ts
-import { BaseService, inject, getError } from '@venizia/ignis';
+import { BaseService, inject } from '@venizia/ignis';
+import { getError } from '@venizia/ignis-helpers';
 import { TodoRepository } from '@/repositories/todo.repository';
 
 export class TodoService extends BaseService {

package/wiki/guides/tutorials/complete-installation.md

@@ -259,9 +259,9 @@ import {
   BaseController,
   controller,
   api,
-  HTTP,
   jsonContent,
 } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { z } from '@hono/zod-openapi';
 import { Context } from 'hono';
 
@@ -326,7 +326,7 @@ Create `src/index.ts` - this starts your application:
 
 ```typescript
 import { Application, appConfigs } from './application';
-import { LoggerFactory } from '@venizia/ignis';
+import { LoggerFactory } from '@venizia/ignis-helpers';
 
 const logger = LoggerFactory.getLogger(['main']);
 

package/wiki/guides/tutorials/ecommerce-api.md

@@ -922,10 +922,10 @@ import {
   controller,
   get,
   inject,
-  HTTP,
   jsonContent,
   TRouteContext,
 } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { ProductService } from '../services/product.service';
 
 // Define route configs with PascalCase type and SCREAMING_SNAKE_CASE keys
@@ -1013,10 +1013,10 @@ import {
   put,
   del,
   inject,
-  HTTP,
   jsonContent,
   TRouteContext,
 } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { CartService } from '../services/cart.service';
 
 const CartRoutes = {
@@ -1150,10 +1150,10 @@ import {
   get,
   post,
   inject,
-  HTTP,
   jsonContent,
   TRouteContext,
 } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { OrderService } from '../services/order.service';
 
 const OrderRoutes = {

package/wiki/guides/tutorials/realtime-chat.md

@@ -448,11 +448,10 @@ import {
   CoreBindings,
   inject,
   SocketIOBindingKeys,
-  SocketIOServerHelper,
   BindingKeys,
   BindingNamespaces,
 } from '@venizia/ignis';
-import { ISocketIOClient, getError } from '@venizia/ignis-helpers';
+import { ISocketIOClient, getError, SocketIOServerHelper } from '@venizia/ignis-helpers';
 import { Socket } from 'socket.io';
 import { MessageRepository } from '../repositories/message.repository';
 import { RoomRepository } from '../repositories/room.repository';
@@ -938,19 +937,21 @@ The application binds Redis, authentication, and the client connected handler vi
 ```typescript
 // src/application.ts
 import {
-  applicationEnvironment,
   BaseApplication,
   BindingKeys,
   BindingNamespaces,
   IApplicationConfigs,
   IApplicationInfo,
-  ISocketIOServerBaseOptions,
-  RedisHelper,
   SocketIOBindingKeys,
   SocketIOComponent,
-  SocketIOServerHelper,
   ValueOrPromise,
 } from '@venizia/ignis';
+import {
+  applicationEnvironment,
+  type ISocketIOServerBaseOptions,
+  RedisHelper,
+  SocketIOServerHelper,
+} from '@venizia/ignis-helpers';
 import { ChatService } from './services/chat.service';
 import { ChatController } from './controllers/chat.controller';
 import { UserRepository } from './repositories/user.repository';

package/wiki/index.md

@@ -64,7 +64,8 @@ bun add -d typescript @types/bun
 ```
 
 ```typescript
-import { BaseApplication, BaseController, controller, get, HTTP, jsonContent, SwaggerComponent } from '@venizia/ignis';
+import { BaseApplication, BaseController, controller, get, jsonContent, SwaggerComponent } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 import { z } from '@hono/zod-openapi';
 
 // 1. Define your controller

package/wiki/references/base/application.md

@@ -49,6 +49,34 @@ Extends `AbstractApplication` with concrete lifecycle implementations and resour
 | `repository(MyRepository, opts?)`| `repositories.MyRepository` (default) or custom key via `opts.binding` |
 | `dataSource(MyDataSource, opts?)`| `datasources.MyDataSource` (default) or custom key via `opts.binding` |
 
+> [!TIP]
+> All registration methods accept an optional `opts.binding` parameter to override the default namespace-based key:
+> ```typescript
+> this.controller(UserController, {
+>   binding: { namespace: 'controllers', key: 'CustomUserController' },
+> });
+> ```
+
+### registerDynamicBindings
+
+Protected method for handling late-registration and circular dependency patterns. Iterates bindings in a namespace, configuring each instance and re-fetching to pick up dynamically added bindings.
+
+```typescript
+protected async registerDynamicBindings<T extends IConfigurable>(opts: {
+  namespace: TBindingNamespace;
+  onBeforeConfigure?: (opts: { binding: Binding<T> }) => Promise<void>;
+  onAfterConfigure?: (opts: { binding: Binding<T>; instance: T }) => Promise<void>;
+}): Promise<void>
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `namespace` | `TBindingNamespace` | Binding namespace to scan (e.g., `'components'`, `'controllers'`) |
+| `onBeforeConfigure` | callback | Called before each binding's `configure()` — use for validation |
+| `onAfterConfigure` | callback | Called after `configure()` — use for route mounting, post-setup |
+
+The method tracks already-configured bindings to prevent duplicates and re-fetches after each configuration to handle bindings registered during the configure phase.
+
 ### `initialize()` Method Flow
 
 Startup sequence executed by the `initialize()` method:

package/wiki/references/base/components.md

@@ -306,7 +306,8 @@ export class HealthCheckComponent extends BaseComponent {
 
 ```typescript
 // src/components/auth/authenticate/component.ts
-import { BaseApplication, BaseComponent, inject, CoreBindings, Binding, ValueOrPromise, getError } from '@venizia/ignis';
+import { BaseApplication, BaseComponent, inject, CoreBindings, Binding, ValueOrPromise } from '@venizia/ignis';
+import { getError } from '@venizia/ignis-helpers';
 import { AuthenticateBindingKeys, IAuthenticateOptions, IBasicTokenServiceOptions, IJWTTokenServiceOptions } from './common';
 import { BasicTokenService, JWTTokenService } from './services';
 import { defineAuthController } from './controllers';