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

package/wiki/references/components/authorization/usage.md

@@ -689,6 +689,68 @@ const customRole = AuthorizationRole.build({ name: 'editor', priority: 100, deli
 customRole.identifier;  // '100-editor'
 ```
 
+## Model-Based Resource References
+
+Instead of hardcoding resource strings, use `AUTHORIZATION_SUBJECT` from your model classes. When a model declares `authorize.principal` in `@model` settings, the decorator auto-populates `AUTHORIZATION_SUBJECT`:
+
+```typescript
+import { BaseEntity, model, generateIdColumnDefs } 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(),
+  });
+}
+
+// Article.AUTHORIZATION_SUBJECT === 'article'
+```
+
+Use it in route configs for type-safe, refactor-friendly resource references:
+
+```typescript
+import { AuthorizationActions } from '@venizia/ignis';
+import { Article } from '../models/entities/article.model';
+
+// Instead of: resource: 'article'
+authorize: {
+  action: AuthorizationActions.READ,
+  resource: Article.AUTHORIZATION_SUBJECT,
+}
+```
+
+### Querying All Principals
+
+Use `MetadataRegistry` to retrieve all registered authorization principals at runtime:
+
+```typescript
+import { MetadataRegistry } from '@venizia/ignis';
+
+const registry = MetadataRegistry.getInstance();
+
+// Flat array of principal names — ideal for Casbin policy setup
+const principals = registry.getAuthorizeModelPrincipals({ format: 'array' });
+// ['article', 'user', 'configuration']
+
+// Record of model name → principal
+const principalMap = registry.getAuthorizeModelPrincipals({ format: 'record' });
+// { Article: 'article', User: 'user', Configuration: 'configuration' }
+
+// Full settings with model registry entries (framework-level)
+const settings = registry.getAuthorizeModelSettings({ format: 'array' });
+// [{ name: 'Article', authorize: { principal: 'article' }, entry: IModelRegistryEntry }]
+```
+
+> [!TIP]
+> Defining `authorize.principal` on the model makes the model the single source of truth for its authorization subject. This eliminates string duplication across route configs and policy setup.
+
 ## See Also
 
 - [Setup & Configuration](./) -- Binding keys, options interfaces, and initial setup

package/wiki/references/components/health-check.md

@@ -214,8 +214,9 @@ The controller uses `this.definitions = RouteConfigs` to store route configurati
 ```typescript
 import {
   BaseController, IControllerOptions, TRouteContext,
-  api, jsonContent, jsonResponse, HTTP, z,
+  api, jsonContent, jsonResponse, z,
 } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 const RouteConfigs = {
   ROOT: {

package/wiki/references/components/socket-io/index.md

@@ -18,9 +18,12 @@
 import {
   SocketIOComponent,
   SocketIOBindingKeys,
+} from '@venizia/ignis';
+
+import {
   SocketIOServerHelper,
   RedisHelper,
-} from '@venizia/ignis';
+} from '@venizia/ignis-helpers';
 
 import {
   SocketIOClientHelper,
@@ -70,11 +73,13 @@ import {
   BaseApplication,
   SocketIOComponent,
   SocketIOBindingKeys,
-  RedisHelper,
+  ValueOrPromise,
+} from '@venizia/ignis';
+import { RedisHelper } from '@venizia/ignis-helpers';
+import type {
   TSocketIOAuthenticateFn,
   TSocketIOValidateRoomFn,
   TSocketIOClientConnectedFn,
-  ValueOrPromise,
 } from '@venizia/ignis';
 
 export class Application extends BaseApplication {
@@ -146,7 +151,7 @@ The `RedisHelper` is created with `autoConnect: false` because the server helper
 You can use either `RedisHelper` (single Redis instance) or `RedisClusterHelper` (Redis Cluster mode). Both extend `DefaultRedisHelper`, which is the type the component validates against:
 
 ```typescript
-import { RedisClusterHelper } from '@venizia/ignis';
+import { RedisClusterHelper } from '@venizia/ignis-helpers';
 
 // For Redis Cluster deployments
 const redisHelper = new RedisClusterHelper({

package/wiki/references/components/socket-io/usage.md

@@ -13,10 +13,10 @@ import {
   BaseService,
   inject,
   SocketIOBindingKeys,
-  SocketIOServerHelper,
   CoreBindings,
   BaseApplication,
 } from '@venizia/ignis';
+import { SocketIOServerHelper } from '@venizia/ignis-helpers';
 
 export class NotificationService extends BaseService {
   // Lazy getter pattern -- helper is bound AFTER server starts

package/wiki/references/components/static-asset/index.md

@@ -17,9 +17,8 @@ import {
   StaticAssetComponent,
   StaticAssetComponentBindingKeys,
   StaticAssetStorageTypes,
-  DiskHelper,
-  MinioHelper,
 } from '@venizia/ignis';
+import { DiskHelper, MinioHelper } from '@venizia/ignis-helpers';
 import type {
   TStaticAssetsComponentOptions,
   TMetaLinkConfig,
@@ -46,12 +45,11 @@ import type {
 ```typescript
 import {
   BaseApplication,
-  DiskHelper,
-  MinioHelper,
   StaticAssetComponentBindingKeys,
   StaticAssetStorageTypes,
-  TStaticAssetsComponentOptions,
 } from '@venizia/ignis';
+import { DiskHelper, MinioHelper } from '@venizia/ignis-helpers';
+import type { TStaticAssetsComponentOptions } from '@venizia/ignis';
 
 export class Application extends BaseApplication {
   preConfigure() {

package/wiki/references/components/swagger.md

@@ -67,7 +67,8 @@ To get the most out of the documentation, define your routes with `zod` schemas:
 ```typescript
 // src/controllers/hello.controller.ts
 import { z } from '@hono/zod-openapi';
-import { BaseController, controller, HTTP, jsonContent, ValueOrPromise } from '@venizia/ignis';
+import { BaseController, controller, jsonContent, ValueOrPromise } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 @controller({ path: '/hello' })
 export class HelloController extends BaseController {

package/wiki/references/configuration/environment-variables.md

@@ -22,7 +22,8 @@ POSTGRES_HOST=localhost
 const host = process.env.APP_ENV_POSTGRES_HOST;
 
 // Using applicationEnvironment helper (recommended)
-import { applicationEnvironment, EnvironmentKeys } from '@venizia/ignis';
+import { applicationEnvironment } from '@venizia/ignis-helpers';
+import { EnvironmentKeys } from '@venizia/ignis';
 const host = applicationEnvironment.get<string>(EnvironmentKeys.APP_ENV_POSTGRES_HOST);
 ```
 

package/wiki/references/configuration/index.md

@@ -52,7 +52,8 @@ APP_ENV_POSTGRES_DATABASE=my_database
 const host = process.env.APP_ENV_POSTGRES_HOST;
 
 // 2. Using helper (recommended)
-import { applicationEnvironment, EnvironmentKeys } from '@venizia/ignis';
+import { applicationEnvironment } from '@venizia/ignis-helpers';
+import { EnvironmentKeys } from '@venizia/ignis';
 const host = applicationEnvironment.get<string>(EnvironmentKeys.APP_ENV_POSTGRES_HOST);
 ```
 
@@ -71,3 +72,41 @@ project/
 Ignis validates required variables on startup. Missing values cause clear error messages.
 
 > **Related:** [Environment Variables Reference](./environment-variables.md) | [DataSources Guide](../../guides/core-concepts/persistent/datasources)
+
+## EnvironmentKeys Class
+
+```typescript
+import { EnvironmentKeys } from '@venizia/ignis';
+```
+
+| Constant | Description |
+|----------|-------------|
+| `APP_ENV_APPLICATION_NAME` | Application display name |
+| `APP_ENV_APPLICATION_TIMEZONE` | Application timezone (e.g., 'Asia/Ho_Chi_Minh') |
+| `APP_ENV_APPLICATION_SECRET` | Application-wide secret key |
+| `APP_ENV_JWT_SECRET` | JWT signing secret |
+| `APP_ENV_JWT_EXPIRES_IN` | JWT token expiration |
+| `APP_ENV_LOGGER_FOLDER_PATH` | Log file output directory |
+| `APP_ENV_APPLICATION_ROLES` | Application role definitions |
+| `APP_ENV_APPLICATION_DS_MIGRATION` | DataSource name for migrations |
+| `APP_ENV_APPLICATION_DS_AUTHORIZE` | DataSource name for authorization |
+| `APP_ENV_APPLICATION_DS_OAUTH2` | DataSource name for OAuth2 |
+| `APP_ENV_OAUTH2_VIEW_FOLDER` | OAuth2 view templates folder |
+| `APP_ENV_SERVER_HOST` | HTTP server host (e.g., '0.0.0.0') |
+| `APP_ENV_SERVER_PORT` | HTTP server port (e.g., 3000) |
+| `APP_ENV_SERVER_BASE_PATH` | Base URL path prefix |
+| `APP_ENV_DATASOURCE_NAME` | Default datasource name |
+| `APP_ENV_POSTGRES_HOST` | PostgreSQL host |
+| `APP_ENV_POSTGRES_PORT` | PostgreSQL port |
+| `APP_ENV_POSTGRES_USERNAME` | PostgreSQL username |
+| `APP_ENV_POSTGRES_PASSWORD` | PostgreSQL password |
+| `APP_ENV_POSTGRES_DATABASE` | PostgreSQL database name |
+
+Usage:
+
+```typescript
+import { applicationEnvironment } from '@venizia/ignis-helpers';
+import { EnvironmentKeys } from '@venizia/ignis';
+
+const dbHost = applicationEnvironment.get<string>(EnvironmentKeys.APP_ENV_POSTGRES_HOST);
+```

package/wiki/references/helpers/error/index.md

@@ -20,7 +20,7 @@ import type { TError } from '@venizia/ignis-helpers';
 ```
 
 > [!NOTE]
-> `ApplicationError`, `getError`, `ErrorSchema`, and `TError` are also available from `@venizia/ignis-inversion` and re-exported through `@venizia/ignis`.
+> `ApplicationError`, `getError`, `ErrorSchema`, and `TError` are also available from `@venizia/ignis-inversion`. Their types are re-exported through `@venizia/ignis` (via `export type *`), but for runtime usage, import directly from `@venizia/ignis-helpers` or `@venizia/ignis-inversion`.
 
 ## Creating an Instance
 

package/wiki/references/helpers/inversion/index.md

@@ -50,7 +50,7 @@ import type {
 ```
 
 > [!NOTE]
-> The framework package `@venizia/ignis` re-exports everything from `@venizia/ignis-inversion` and adds higher-level helpers (`app.controller()`, `app.service()`, etc.).
+> The framework package `@venizia/ignis` re-exports DI-specific symbols (`Binding`, `BindingKeys`, `BindingScopes`, `BindingValueTypes`, `IProvider`, `isClass`, `isClassProvider`, `isClassConstructor`, `TBindingScope`, `TBindingValueType`, `IBindingTag`) from `@venizia/ignis-inversion` and adds higher-level helpers (`app.controller()`, `app.service()`, etc.). All types from inversion are also available via type-only re-exports.
 
 ## Creating an Instance
 

package/wiki/references/helpers/redis/index.md

@@ -20,21 +20,14 @@ import {
   RedisClusterHelper,
 } from '@venizia/ignis-helpers';
 
-// Or from the core package (re-exports everything)
-import {
-  DefaultRedisHelper,
-  RedisHelper,
-  RedisClusterHelper,
-} from '@venizia/ignis';
-
-// Types
+// Types are also available from the core package (via type-only re-export)
 import type {
   IRedisHelperOptions,
   IRedisClusterHelperOptions,
   IRedisHelperCallbacks,
   IRedisHelperProps,
   IRedisClusterHelperProps,
-} from '@venizia/ignis-helpers';
+} from '@venizia/ignis-helpers'; // or from '@venizia/ignis'
 ```
 
 ## Creating an Instance

package/wiki/references/quick-reference.md

@@ -118,6 +118,7 @@ class User extends BaseEntity {
 **Key Properties:**
 - `static tableName` - Database table name
 - `static schema` - Drizzle schema definition
+- `static AUTHORIZATION_SUBJECT` - Authorization principal (auto-set from `@model` settings `authorize.principal`)
 
 
 ## Route Decorators
@@ -396,11 +397,8 @@ import { MinIOHelper } from '@venizia/ignis-helpers/minio';
 ### Dependency Injection
 
 ```typescript
-import {
-  Container,
-  BindingKeys,
-  BindingNamespaces,
-} from '@venizia/ignis-inversion';
+import { Container, BindingKeys } from '@venizia/ignis-inversion';
+import { BindingNamespaces } from '@venizia/ignis';
 ```
 
 

package/wiki/references/utilities/crypto.md

@@ -19,7 +19,7 @@ The `hash` function allows you to create a hash of a string using either `SHA256
 **MD5 Hash**
 
 ```typescript
-import { hash } from '@venizia/ignis';
+import { hash } from '@venizia/ignis-helpers';
 
 const md5Hash = hash('some text', { algorithm: 'MD5', outputType: 'hex' });
 // => '552e21cd4cd99186789c2370c7482837'
@@ -28,7 +28,7 @@ const md5Hash = hash('some text', { algorithm: 'MD5', outputType: 'hex' });
 **SHA256 HMAC**
 
 ```typescript
-import { hash } from '@venizia/ignis';
+import { hash } from '@venizia/ignis-helpers';
 
 const sha256Hash = hash('some text', {
   algorithm: 'SHA256',

package/wiki/references/utilities/date.md

@@ -7,7 +7,7 @@ The Date utility provides a set of functions for date and time manipulation, bui
 The `dayjs` object is re-exported, so you can use it directly for any date and time operations. It is pre-configured with the following plugins: `CustomParseFormat`, `UTC`, `Timezone`, `Weekday`, and `IsoWeek`.
 
 ```typescript
-import { dayjs } from '@venizia/ignis';
+import { dayjs } from '@venizia/ignis-helpers';
 
 // Get the current date and time
 const now = dayjs();
@@ -21,7 +21,7 @@ const formatted = now.format('YYYY-MM-DD HH:mm:ss');
 The `sleep` function pauses execution for a specified number of milliseconds.
 
 ```typescript
-import { sleep } from '@venizia/ignis';
+import { sleep } from '@venizia/ignis-helpers';
 
 async function myAsyncFunction() {
   console.log('Start');
@@ -37,7 +37,7 @@ async function myAsyncFunction() {
 -   **`getNextWeekday(opts)`**: Returns the next weekday from a given date.
 
 ```typescript
-import { isWeekday, getPreviousWeekday } from '@venizia/ignis';
+import { isWeekday, getPreviousWeekday } from '@venizia/ignis-helpers';
 
 const isTodayWeekday = isWeekday(new Date());
 
@@ -49,7 +49,7 @@ const lastBusinessDay = getPreviousWeekday();
 The `getDateTz` function allows you to get a `dayjs` object in a specific timezone, with an optional offset.
 
 ```typescript
-import { getDateTz } from '@venizia/ignis';
+import { getDateTz } from '@venizia/ignis-helpers';
 
 const tokyoTime = getDateTz({
   date: '2023-10-27T10:00:00Z',
@@ -62,7 +62,7 @@ const tokyoTime = getDateTz({
 The `hrTime` function returns a high-resolution time measurement in seconds, useful for performance benchmarking.
 
 ```typescript
-import { hrTime } from '@venizia/ignis';
+import { hrTime } from '@venizia/ignis-helpers';
 
 const start = hrTime();
 // ... some long-running operation

package/wiki/references/utilities/index.md

@@ -43,19 +43,11 @@ Pure, standalone functions providing common, reusable logic for the Ignis framew
 
 ## Usage Pattern
 
-All utilities are imported from `@venizia/ignis`:
+Utilities are imported from `@venizia/ignis` (schema, JSX, and status helpers) or `@venizia/ignis-helpers` (runtime utilities):
 
 ```typescript
-import {
-  hash,
-  compare,
-  formatDate,
-  toBoolean,
-  jsonContent,
-  jsonResponse,
-  htmlResponse,
-  Statuses,
-} from '@venizia/ignis';
+import { jsonContent, jsonResponse, htmlResponse, Statuses } from '@venizia/ignis';
+import { hash, compare, formatDate, toBoolean } from '@venizia/ignis-helpers';
 
 // Crypto
 const hashed = await hash({ value: 'password123' });

package/wiki/references/utilities/jsx.md

@@ -184,7 +184,8 @@ export class PageController extends BaseController {
 ### HTML Email Preview
 
 ```typescript
-import { BaseController, get, htmlResponse, TRouteContext, HTTP, z } from '@venizia/ignis';
+import { BaseController, get, htmlResponse, TRouteContext, z } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 const EmailRoutes = {
   PREVIEW: {
@@ -222,7 +223,8 @@ export class EmailController extends BaseController {
 ### Documentation Page
 
 ```typescript
-import { BaseController, get, htmlResponse, TRouteContext, HTTP, z } from '@venizia/ignis';
+import { BaseController, get, htmlResponse, TRouteContext, z } from '@venizia/ignis';
+import { HTTP } from '@venizia/ignis-helpers';
 
 const DocsRoutes = {
   GET_SECTION: {

package/wiki/references/utilities/module.md

@@ -17,7 +17,7 @@ The `validateModule` function checks if a list of modules can be resolved. If a
 The `SwaggerComponent` uses `validateModule` to ensure that `@hono/swagger-ui` is installed before attempting to use it.
 
 ```typescript
-import { validateModule } from '@venizia/ignis';
+import { validateModule } from '@venizia/ignis-helpers';
 
 export class SwaggerComponent extends BaseComponent {
   // ...

package/wiki/references/utilities/parse.md

@@ -15,7 +15,7 @@ The Parse utility provides a collection of functions for data type checking, con
 -   **`toStringDecimal(input, digit = 2)`**: Formats a number to a string with a specified number of decimal places, using locale-specific formatting.
 
 ```typescript
-import { int, float, toBoolean } from '@venizia/ignis';
+import { int, float, toBoolean } from '@venizia/ignis-helpers';
 
 const myInt = int('1,000'); // => 1000
 const myFloat = float('1,234.567', 2); // => 1234.57
@@ -28,7 +28,7 @@ const myBool = toBoolean('true'); // => true
 -   **`keysToCamel(object)`**: Recursively converts all keys in an object (and nested objects) to camelCase.
 
 ```typescript
-import { toCamel, keysToCamel } from '@venizia/ignis';
+import { toCamel, keysToCamel } from '@venizia/ignis-helpers';
 
 const camelString = toCamel('my-snake_case-string');
 // => 'mySnakeCaseString'
@@ -37,13 +37,33 @@ const camelObject = keysToCamel({ 'first-name': 'John', 'last_name': 'Doe' });
 // => { firstName: 'John', lastName: 'Doe' }
 ```
 
+## Number Parsing
+
+-   **`getNumberValue(input, opts?)`**: Parses a string to a number with locale support (US or EU format).
+
+```typescript
+import { getNumberValue } from '@venizia/ignis-helpers';
+
+// US format (default) — comma is thousands separator
+getNumberValue('1,234.56', { method: 'float' }); // => 1234.56
+getNumberValue('1,234', { method: 'int' });       // => 1234
+
+// EU format — dot is thousands separator, comma is decimal
+getNumberValue('1.234,56', { method: 'float', locale: 'eu' }); // => 1234.56
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `method` | `'int' \| 'float'` | `'int'` | Parse as integer or float |
+| `locale` | `'us' \| 'eu'` | `'us'` | Number format locale |
+
 ## Array Transformation
 
 -   **`parseArrayToRecordWithKey(opts)`**: Transforms an array of objects into a record (plain object), using a specified property of the objects as keys.
 -   **`parseArrayToMapWithKey(arr, keyMap)`**: Transforms an array of objects into a `Map`, using a specified property of the objects as keys. This is useful for efficient lookups.
 
 ```typescript
-import { parseArrayToMapWithKey } from '@venizia/ignis';
+import { parseArrayToMapWithKey } from '@venizia/ignis-helpers';
 
 const users = [
   { id: 1, name: 'Alice' },
@@ -62,7 +82,7 @@ const user = usersMap.get(1);
 -   **`getUID()`**: Generates a simple, short unique ID string.
 
 ```typescript
-import { getUID } from '@venizia/ignis';
+import { getUID } from '@venizia/ignis-helpers';
 
 const uniqueId = getUID(); // => e.g., 'A1B2C3D4'
 ```

package/wiki/references/utilities/performance.md

@@ -20,7 +20,7 @@ The `BaseApplication` uses this utility to measure the time taken to register co
 
 ```typescript
 // Inside BaseApplication class
-import { executeWithPerformanceMeasure } from '@venizia/ignis';
+import { executeWithPerformanceMeasure } from '@venizia/ignis-helpers';
 
 // ...
 
@@ -53,7 +53,7 @@ For more granular measurements, you can use the lower-level functions:
 ### Example
 
 ```typescript
-import { getPerformanceCheckpoint, getExecutedPerformance } from '@venizia/ignis';
+import { getPerformanceCheckpoint, getExecutedPerformance } from '@venizia/ignis-helpers';
 
 const start = getPerformanceCheckpoint();
 

package/wiki/references/utilities/promise.md

@@ -16,7 +16,7 @@ This function executes an array of asynchronous tasks concurrently, but with a s
 ### Example
 
 ```typescript
-import { executePromiseWithLimit, sleep } from '@venizia/ignis';
+import { executePromiseWithLimit, sleep } from '@venizia/ignis-helpers';
 
 const tasks = [
   () => sleep(1000).then(() => 'Task 1 done'),
@@ -43,7 +43,7 @@ console.log('All tasks finished:', results);
 A type guard function to check if a given value is a Promise-like object (i.e., it has a `then` method).
 
 ```typescript
-import { isPromiseLike } from '@venizia/ignis';
+import { isPromiseLike } from '@venizia/ignis-helpers';
 
 const a = Promise.resolve(1);
 const b = 2;
@@ -62,7 +62,7 @@ if (isPromiseLike(b)) {
 This function applies a transformation function to a value that might be a direct value or a Promise.
 
 ```typescript
-import { transformValueOrPromise, isPromiseLike } from '@venizia/ignis';
+import { transformValueOrPromise, isPromiseLike } from '@venizia/ignis-helpers';
 
 const double = (n: number) => n * 2;
 
@@ -75,7 +75,7 @@ const result2 = await transformValueOrPromise(Promise.resolve(5), double); // =>
 Safely retrieves a deeply nested property from an object using a dot-separated path string. It throws an error if any part of the path is null or undefined.
 
 ```typescript
-import { getDeepProperty } from '@venizia/ignis';
+import { getDeepProperty } from '@venizia/ignis-helpers';
 
 const obj = { a: { b: { c: 'hello' } } };
 

package/wiki/references/utilities/request.md

@@ -31,8 +31,8 @@ The function returns a `Promise` that resolves to an array of `IParsedFile` obje
 Here is an example of how to use `parseMultipartBody` in a controller to handle a file upload.
 
 ```typescript
-import { BaseController, controller, HTTP } from '@venizia/ignis';
-import { parseMultipartBody } from '@venizia/ignis';
+import { BaseController, controller } from '@venizia/ignis';
+import { parseMultipartBody, HTTP } from '@venizia/ignis-helpers';
 
 @controller({ path: '/files' })
 export class FileController extends BaseController {

package/wiki/references/utilities/schema.md

@@ -60,28 +60,37 @@ const schema = z.object({
 
 ## Predefined Schemas
 
-The utility also provides several predefined schemas for common use cases.
-
 -   **`AnyObjectSchema`**: A flexible schema for any object (`z.object().catchall(z.any())`).
--   **`IdParamsSchema`**: A schema for a numeric path parameter named `id`.
--   **`UUIDParamsSchema`**: A schema for a UUID path parameter named `id`.
 
-### Example
+### Type Utilities
+
+```typescript
+import { TAnyObjectSchema, TInferSchema } from '@venizia/ignis';
+
+// TAnyObjectSchema = z.ZodObject<z.ZodRawShape>
+// TInferSchema<T> = z.infer<T> — infer TypeScript type from a Zod schema
+
+type UserType = TInferSchema<typeof UserSchema>;
+```
+
+### Custom ID Params
+
+Use the `idParamsSchema()` helper (from controller utilities) to generate path parameter schemas:
 
 ```typescript
-import { IdParamsSchema } from '@venizia/ignis';
+import { idParamsSchema } from '@venizia/ignis';
 
 this.defineRoute({
   configs: {
     path: '/{id}',
     method: 'get',
     request: {
-      params: IdParamsSchema,
+      params: idParamsSchema({ idType: 'number' }),
     },
     // ...
   },
   handler: (c) => {
-    const { id } = c.req.valid('param'); // id is a number
+    const { id } = c.req.valid('param');
     // ...
   },
 });