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

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/index.md

@@ -7,6 +7,7 @@ Reusable, pluggable modules that group together related features. A component ca
 | Component | Purpose | Key Features |
 |-----------|---------|--------------|
 | [Authentication](./authentication/) | JWT/Basic auth | Token generation, protected routes, multi-strategy |
+| [Authorization](./authorization/) <Badge type="warning" text="Experimental" /> | Enforcer-based authz | RBAC, ABAC, voters, Casbin integration, role shortcuts |
 | [Health Check](./health-check) | Monitoring endpoint | `/health` endpoint, ping/pong functionality |
 | [Mail](./mail/) | Email sending system | Multiple transports, templating, queue-based processing |
 | [Request Tracker](./request-tracker) | Request logging | Request ID generation, timing, structured logging |
@@ -72,6 +73,7 @@ Using components is a great way to organize your application's features into mod
 
 - **Built-in Components:**
   - [Authentication](./authentication/) - JWT/Basic authentication
+  - [Authorization](./authorization/) - Enforcer-based authorization
   - [Health Check](./health-check) - Health check endpoints
   - [Mail](./mail/) - Email functionality
   - [Request Tracker](./request-tracker) - Request tracking

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);
 ```
 

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/index.md

@@ -14,6 +14,7 @@ Reusable classes and functions providing common functionality - designed for eas
 | [Inversion](./inversion/) | Dependency injection | DI container implementation |
 | [Logger](./logger/) | Logging | Winston-based, multiple transports, scopes |
 | [Network](./network/) | Network requests | HTTP, TCP, UDP helpers |
+| Kafka <Badge type="warning" text="Experimental" /> | Event streaming | Apache Kafka producer/consumer |
 | [Queue](./queue/) | Message queues | BullMQ, MQTT support |
 | [Redis](./redis/) | Redis operations | Single/cluster, key-value, hashes, JSON, pub/sub |
 | [Socket.IO](./socket-io/) | Real-time communication | Socket.IO client/server helpers |

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/kafka/index.md

@@ -0,0 +1,305 @@
+# Kafka <Badge type="warning" text="Experimental" />
+
+Apache Kafka event streaming with producer, consumer, and admin helpers. Built on [`@platformatic/kafka`](https://github.com/platformatic/kafka).
+
+> [!WARNING]
+> This helper is **experimental**. The API may change in future releases.
+
+## Quick Reference
+
+| Class | Extends | Peer Dependency | Use Case |
+|-------|---------|-----------------|----------|
+| **KafkaProducerHelper** | `BaseHelper` | `@platformatic/kafka` | Publish messages to Kafka topics |
+| **KafkaConsumerHelper** | `BaseHelper` | `@platformatic/kafka` | Consume messages from Kafka topics with consumer groups |
+| **KafkaAdminHelper** | `BaseHelper` | `@platformatic/kafka` | Manage topics, partitions, consumer groups, and configs |
+
+### Import Path
+
+```typescript
+import {
+  KafkaProducerHelper,
+  KafkaConsumerHelper,
+  KafkaAdminHelper,
+  KafkaDefaults,
+  KafkaAcks,
+  KafkaConfigResourceTypes,
+} from '@venizia/ignis-helpers/kafka';
+
+import type {
+  IKafkaConnectionOptions,
+  IKafkaProducerOptions,
+  IKafkaConsumerOptions,
+  IKafkaAdminOptions,
+  IKafkaProduceMessage,
+  IKafkaSendOptions,
+  IKafkaConsumedMessage,
+  IKafkaCommitOptions,
+} from '@venizia/ignis-helpers/kafka';
+```
+
+## Installation
+
+```bash
+bun add @platformatic/kafka
+```
+
+## Producer
+
+The `KafkaProducerHelper` wraps `@platformatic/kafka`'s `Producer` for publishing messages to Kafka topics.
+
+```typescript
+import { KafkaProducerHelper, KafkaAcks } from '@venizia/ignis-helpers/kafka';
+
+const producer = new KafkaProducerHelper({
+  identifier: 'order-producer',
+  bootstrapBrokers: ['localhost:9092'],
+  acks: KafkaAcks.ALL,
+  autocreateTopics: true,
+  onConnected: () => console.log('Producer connected'),
+  onError: ({ error }) => console.error('Producer error:', error),
+});
+
+// Send messages
+await producer.send({
+  messages: [
+    { topic: 'orders', key: 'order-123', value: JSON.stringify({ status: 'created' }) },
+  ],
+});
+
+// Send batch across multiple topics
+await producer.sendBatch({
+  topicMessages: [
+    { topic: 'orders', messages: [{ key: 'o1', value: '...' }] },
+    { topic: 'notifications', messages: [{ key: 'n1', value: '...' }] },
+  ],
+});
+
+// Graceful shutdown
+await producer.close();
+```
+
+### IKafkaProducerOptions
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `bootstrapBrokers` | `string[]` | -- | Kafka broker addresses (required) |
+| `identifier` | `string` | -- | Scoped logging identifier |
+| `clientId` | `string` | `'ignis-kafka'` | Kafka client ID |
+| `acks` | `number` | -- | Acknowledgment level (`KafkaAcks.NONE`, `LEADER`, `ALL`) |
+| `autocreateTopics` | `boolean` | -- | Auto-create topics on first produce |
+| `timeout` | `number` | -- | Connection timeout in ms |
+| `retries` | `number \| boolean` | -- | Retry configuration |
+| `retryDelay` | `number` | -- | Delay between retries in ms |
+| `serializers` | `Partial<Serializers>` | -- | Custom key/value/header serializers |
+| `onConnected` | `() => void` | -- | Broker connect callback |
+| `onDisconnected` | `() => void` | -- | Broker disconnect callback |
+| `onError` | `(opts: { error: Error }) => void` | -- | Error callback |
+
+### Producer API
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `send(opts)` | `Promise<void>` | Send messages. `opts: { messages: IKafkaProduceMessage[]; acks? }` |
+| `sendBatch(opts)` | `Promise<void>` | Send to multiple topics. `opts: { topicMessages: Array<{ topic; messages }> }` |
+| `getProducer()` | `Producer` | Access the underlying `@platformatic/kafka` Producer |
+| `close()` | `Promise<void>` | Gracefully close the producer connection |
+| `static newInstance(opts)` | `KafkaProducerHelper` | Factory method |
+
+## Consumer
+
+The `KafkaConsumerHelper` provides a stream-based consumer with consumer group support, pause/resume, manual commit, and lag monitoring.
+
+```typescript
+import { KafkaConsumerHelper } from '@venizia/ignis-helpers/kafka';
+
+const consumer = new KafkaConsumerHelper({
+  identifier: 'order-consumer',
+  bootstrapBrokers: ['localhost:9092'],
+  groupId: 'order-processing-group',
+  topics: ['orders'],
+  mode: 'latest',
+  autocommit: true,
+  onMessage: async ({ message }) => {
+    console.log(`Topic: ${message.topic}, Partition: ${message.partition}`);
+    console.log(`Key: ${message.key}, Value: ${message.value}`);
+  },
+  onConnected: () => console.log('Consumer connected'),
+  onGroupJoin: ({ groupId, memberId }) => {
+    console.log(`Joined group ${groupId} as ${memberId}`);
+  },
+  onError: ({ error }) => console.error('Consumer error:', error),
+});
+
+// Start consuming
+await consumer.start();
+
+// Pause/resume
+consumer.pause();
+consumer.resume();
+
+// Graceful shutdown
+await consumer.close();
+```
+
+### IKafkaConsumerOptions
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `bootstrapBrokers` | `string[]` | -- | Kafka broker addresses (required) |
+| `groupId` | `string` | -- | Consumer group ID (required) |
+| `topics` | `string[]` | -- | Topics to consume (required) |
+| `identifier` | `string` | -- | Scoped logging identifier |
+| `clientId` | `string` | `'ignis-kafka'` | Kafka client ID |
+| `mode` | `'latest' \| 'earliest' \| 'committed'` | `'latest'` | Offset reset strategy |
+| `autocommit` | `boolean \| number` | `true` | Auto-commit offsets (or interval in ms) |
+| `sessionTimeout` | `number` | `30000` | Session timeout in ms |
+| `heartbeatInterval` | `number` | `3000` | Heartbeat interval in ms |
+| `highWaterMark` | `number` | `1024` | Stream high water mark |
+| `maxWaitTime` | `number` | `5000` | Max wait time for fetch in ms |
+| `deserializers` | `Partial<Deserializers>` | -- | Custom key/value/header deserializers |
+| `onMessage` | `(opts: { message }) => ValueOrPromise<void>` | -- | Message handler |
+| `onConnected` | `() => void` | -- | Broker connect callback |
+| `onDisconnected` | `() => void` | -- | Broker disconnect callback |
+| `onGroupJoin` | `(opts: { groupId; memberId }) => void` | -- | Consumer group join callback |
+| `onGroupLeave` | `() => void` | -- | Consumer group leave callback |
+| `onRebalance` | `() => void` | -- | Group rebalance callback |
+| `onLag` | `(opts: { offsets }) => void` | -- | Consumer lag callback |
+| `onError` | `(opts: { error: Error }) => void` | -- | Error callback |
+
+### Consumer API
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `start()` | `Promise<void>` | Start consuming messages (fires async consume loop) |
+| `pause()` | `void` | Pause the message stream |
+| `resume()` | `void` | Resume the message stream |
+| `isPaused()` | `boolean` | Check if the stream is paused |
+| `isConsuming()` | `boolean` | Check if the consumer is running |
+| `commit(opts)` | `Promise<void>` | Manually commit offsets |
+| `startLagMonitoring(opts)` | `void` | Start lag monitoring. `opts: { interval: number }` |
+| `stopLagMonitoring()` | `void` | Stop lag monitoring |
+| `getConsumer()` | `Consumer` | Access the underlying `@platformatic/kafka` Consumer |
+| `close()` | `Promise<void>` | Abort consume loop, close stream and consumer |
+| `static newInstance(opts)` | `KafkaConsumerHelper` | Factory method |
+
+### Manual Commit
+
+When `autocommit` is `false`, commit offsets explicitly:
+
+```typescript
+const consumer = new KafkaConsumerHelper({
+  // ...
+  autocommit: false,
+  onMessage: async ({ message }) => {
+    await processMessage(message);
+    // Commit after successful processing
+    await consumer.commit({
+      offsets: [{
+        topic: message.topic,
+        partition: message.partition,
+        offset: message.offset,
+        leaderEpoch: 0,
+      }],
+    });
+  },
+});
+```
+
+## Admin
+
+The `KafkaAdminHelper` provides topic, partition, consumer group, and config management.
+
+```typescript
+import { KafkaAdminHelper, KafkaConfigResourceTypes } from '@venizia/ignis-helpers/kafka';
+
+const admin = new KafkaAdminHelper({
+  identifier: 'kafka-admin',
+  bootstrapBrokers: ['localhost:9092'],
+});
+
+// Topic management
+await admin.createTopics({ topics: ['orders', 'notifications'], partitions: 3, replicas: 1 });
+const topics = await admin.listTopics();
+await admin.deleteTopics({ topics: ['old-topic'] });
+
+// Partition management
+await admin.createPartitions({ topics: [{ name: 'orders', count: 6 }] });
+
+// Consumer group management
+const groups = await admin.listGroups();
+const groupDetails = await admin.describeGroups({ groups: ['order-processing-group'] });
+await admin.deleteGroups({ groups: ['stale-group'] });
+
+// Config management
+const configs = await admin.describeConfigs({
+  resources: [{
+    resourceType: KafkaConfigResourceTypes.TOPIC,
+    resourceName: 'orders',
+  }],
+});
+
+// Metadata
+const meta = await admin.metadata({ topics: ['orders'] });
+
+// Cleanup
+await admin.close();
+```
+
+### Admin API
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `createTopics(opts)` | `Promise<any>` | Create topics with partitions and replicas |
+| `deleteTopics(opts)` | `Promise<void>` | Delete topics |
+| `listTopics(opts?)` | `Promise<string[]>` | List topics (optionally include internals) |
+| `metadata(opts?)` | `Promise<any>` | Fetch cluster/topic metadata |
+| `listGroups(opts?)` | `Promise<any>` | List consumer groups (filter by state) |
+| `describeGroups(opts)` | `Promise<any>` | Describe consumer groups |
+| `deleteGroups(opts)` | `Promise<void>` | Delete consumer groups |
+| `listConsumerGroupOffsets(opts)` | `Promise<any>` | List offsets for consumer groups |
+| `alterConsumerGroupOffsets(opts)` | `Promise<void>` | Alter consumer group offsets |
+| `createPartitions(opts)` | `Promise<void>` | Create partitions for topics |
+| `describeConfigs(opts)` | `Promise<any>` | Describe resource configs |
+| `alterConfigs(opts)` | `Promise<void>` | Alter resource configs |
+| `getAdmin()` | `Admin` | Access the underlying `@platformatic/kafka` Admin |
+| `close()` | `Promise<void>` | Close the admin connection |
+| `static newInstance(opts)` | `KafkaAdminHelper` | Factory method |
+
+## Constants
+
+### KafkaDefaults
+
+| Constant | Value | Description |
+|----------|-------|-------------|
+| `CLIENT_ID` | `'ignis-kafka'` | Default Kafka client ID |
+| `SESSION_TIMEOUT` | `30000` | Session timeout (ms) |
+| `HEARTBEAT_INTERVAL` | `3000` | Heartbeat interval (ms) |
+| `MAX_WAIT_TIME` | `5000` | Max fetch wait time (ms) |
+| `HIGH_WATER_MARK` | `1024` | Stream high water mark |
+| `AUTOCOMMIT_INTERVAL` | `100` | Auto-commit interval (ms) |
+
+### KafkaAcks
+
+| Constant | Value | Description |
+|----------|-------|-------------|
+| `NONE` | `0` | No acknowledgment |
+| `LEADER` | `1` | Leader acknowledgment only |
+| `ALL` | `-1` | All replicas must acknowledge |
+
+### KafkaConfigResourceTypes
+
+| Constant | Value | Description |
+|----------|-------|-------------|
+| `UNKNOWN` | `0` | Unknown resource type |
+| `TOPIC` | `2` | Topic resource |
+| `BROKER` | `4` | Broker resource |
+| `BROKER_LOGGER` | `8` | Broker logger resource |
+
+## See Also
+
+- **Other Helpers:**
+  - [Queue Helper](../queue/) -- BullMQ, MQTT, and in-memory queues
+  - [Redis Helper](../redis/) -- Redis connection management
+
+- **External Resources:**
+  - [@platformatic/kafka](https://github.com/platformatic/kafka) -- Underlying Kafka client library

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 {
   // ...