@venizia/ignis-docs 0.0.8 → 0.2.0

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

@@ -1,14 +1,14 @@
 # Environment Variables Reference
 
-Complete reference of all environment variables used by Ignis framework.
+Complete reference of all environment variables used by IGNIS framework.
 
 
 ## Overview
 
-Ignis uses the `APP_ENV_` prefix for all framework-specific environment variables. This prevents conflicts with system variables like `PATH`, `HOME`, etc.
+IGNIS uses the `APP_ENV_` prefix for all framework-specific environment variables. This prevents conflicts with system variables like `PATH`, `HOME`, etc.
 
 ```bash
-# ✅ Ignis variables
+# ✅ IGNIS variables
 APP_ENV_POSTGRES_HOST=localhost
 
 # ❌ Might conflict with system
@@ -96,9 +96,9 @@ APP_ENV_APPLICATION_ROLES=api,worker
 |----------|----------|---------|-------------|
 | `APP_ENV_SERVER_HOST` | No | `localhost` | Server bind address |
 | `APP_ENV_SERVER_PORT` | No | `3000` | Server port |
-| `APP_ENV_SERVER_BASE_PATH` | No | `/` | Base path for all routes |
-| `HOST` | No | - | Alternative to `APP_ENV_SERVER_HOST` |
-| `PORT` | No | - | Alternative to `APP_ENV_SERVER_PORT` |
+| `APP_ENV_SERVER_BASE_PATH` | No | - | Base path convention (`EnvironmentKeys` constant; not read by the framework itself) |
+| `HOST` | No | - | Alternative to `APP_ENV_SERVER_HOST` (takes precedence) |
+| `PORT` | No | - | Alternative to `APP_ENV_SERVER_PORT` (takes precedence) |
 
 ### Example
 
@@ -116,11 +116,11 @@ APP_ENV_SERVER_BASE_PATH=/v1/api
 
 ### Priority Order
 
-The server configuration uses this priority:
-1. Explicit config in `appConfigs`
-2. `APP_ENV_SERVER_*` variables
-3. `HOST`/`PORT` variables (for cloud platforms)
-4. Default values
+The server host/port resolution uses this priority (`packages/core/src/base/applications/abstract.ts`):
+1. Explicit config passed to the application constructor
+2. `HOST`/`PORT` variables (for cloud platforms)
+3. `APP_ENV_SERVER_HOST`/`APP_ENV_SERVER_PORT` variables
+4. Default values (`localhost`/`3000`)
 
 
 ## Database Variables (PostgreSQL)
@@ -157,7 +157,9 @@ APP_ENV_POSTGRES_DATABASE=my_app_prod
 ### DataSource Configuration
 
 ```typescript
-@datasource({ driver: 'node-postgres' })
+import { NodePostgresDriver } from '@venizia/ignis/postgres/node-postgres';
+
+@datasource({ driver: NodePostgresDriver })
 export class PostgresDataSource extends BaseDataSource {
   constructor() {
     super({
@@ -179,13 +181,15 @@ export class PostgresDataSource extends BaseDataSource {
 
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
-| `APP_ENV_APPLICATION_SECRET` | **Yes** | - | Secret for encrypting JWT payload |
-| `APP_ENV_JWT_SECRET` | **Yes** | - | Secret for signing JWT tokens |
-| `APP_ENV_JWT_EXPIRES_IN` | No | `86400` | Token expiration in seconds (24h default) |
+| `APP_ENV_APPLICATION_SECRET` | Yes* | - | Secret for encrypting JWT payload |
+| `APP_ENV_JWT_SECRET` | Yes* | - | Secret for signing JWT tokens |
+| `APP_ENV_JWT_EXPIRES_IN` | No | - | Token expiration in seconds (e.g., `86400` = 24h) |
+
+*Required by convention when using the authentication component - see below.
 
 ### Security Requirements
 
-Both `APP_ENV_APPLICATION_SECRET` and `APP_ENV_JWT_SECRET` are **mandatory** when using the authentication component. The application will fail to start if these are missing or empty.
+The `AuthenticateComponent` receives its secrets programmatically via the `jwtOptions` binding (`jwtSecret`, `getTokenExpiresFn`), not by reading these environment variables directly. These `EnvironmentKeys` constants are the conventional way for your application to supply those values. The component throws at startup if `jwtSecret` is missing or left at the placeholder value - so wiring it from an unset environment variable will fail the boot.
 
 ### Generate Strong Secrets
 
@@ -218,6 +222,12 @@ APP_ENV_JWT_EXPIRES_IN=86400
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
 | `APP_ENV_LOGGER_FOLDER_PATH` | No | `./` | Directory for log files |
+| `APP_ENV_LOGGER_FORMAT` | No | `text` | Log output format |
+| `APP_ENV_LOGGER_INSPECT_DEPTH` | No | `5` | How deep a `%s` argument is inspected. Node hard-codes depth `0` for `%s`, which prints `[Object]` one level in; IGNIS widens it. Non-negative integers only - an absent, invalid or negative value falls back to `5` |
+| `APP_ENV_LOGGER_FILE_FREQUENCY` | No | `1h` | Log file rotation frequency |
+| `APP_ENV_LOGGER_FILE_MAX_SIZE` | No | `100m` | Max size per log file |
+| `APP_ENV_LOGGER_FILE_MAX_FILES` | No | `5d` | Log file retention |
+| `APP_ENV_LOGGER_FILE_DATE_PATTERN` | No | `YYYYMMDD_HH` | Rotated file date pattern |
 | `APP_ENV_LOGGER_DGRAM_HOST` | No | - | UDP log transport host |
 | `APP_ENV_LOGGER_DGRAM_PORT` | No | - | UDP log transport port |
 | `APP_ENV_LOGGER_DGRAM_LABEL` | No | - | Label for UDP logs |
@@ -240,6 +250,9 @@ APP_ENV_LOGGER_DGRAM_LEVELS=error,warn,info
 
 ## Storage Variables (MinIO/S3)
 
+> [!NOTE]
+> These are application-level conventions (used by the `vert` reference application), not variables read by the framework. `MinioHelper` and the StaticAsset component receive their configuration programmatically - your application wires these values in.
+
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
 | `APP_ENV_MINIO_HOST` | Yes* | - | MinIO/S3 endpoint |
@@ -248,7 +261,7 @@ APP_ENV_LOGGER_DGRAM_LEVELS=error,warn,info
 | `APP_ENV_MINIO_SECRET_KEY` | Yes* | - | Secret key |
 | `APP_ENV_MINIO_USE_SSL` | No | `false` | Enable SSL |
 
-*Required when using StaticAsset component.
+*Required (by application convention) when wiring MinIO-backed storage.
 
 ### Example
 
@@ -271,17 +284,20 @@ APP_ENV_MINIO_USE_SSL=true
 
 ## Mail Variables
 
+> [!NOTE]
+> These are application-level conventions, not variables read by the framework. The Mail component's transporter receives its SMTP/OAuth2 configuration programmatically - your application wires these values in.
+
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
-| `APP_ENV_MAIL_HOST` | Yes* | `smtp.gmail.com` | SMTP host |
-| `APP_ENV_MAIL_PORT` | No | `465` | SMTP port |
-| `APP_ENV_MAIL_SECURE` | No | `true` | Use TLS |
+| `APP_ENV_MAIL_HOST` | Yes* | - | SMTP host (e.g., `smtp.gmail.com`) |
+| `APP_ENV_MAIL_PORT` | No | - | SMTP port (e.g., `465`) |
+| `APP_ENV_MAIL_SECURE` | No | - | Use TLS |
 | `APP_ENV_MAIL_USER` | Yes* | - | SMTP username/email |
 | `APP_ENV_MAIL_CLIENT_ID` | Yes* | - | OAuth2 client ID |
 | `APP_ENV_MAIL_CLIENT_SECRET` | Yes* | - | OAuth2 client secret |
 | `APP_ENV_MAIL_REFRESH_TOKEN` | Yes* | - | OAuth2 refresh token |
 
-*Required when using Mail component with OAuth2.
+*Required (by application convention) when wiring the Mail component with OAuth2.
 
 ### Example (Gmail with OAuth2)
 
@@ -310,14 +326,16 @@ APP_ENV_MAIL_REFRESH_TOKEN=your-oauth2-refresh-token
 | Variable | Required | Default | Description |
 |----------|----------|---------|-------------|
 | `DEBUG` | No | - | Enable debug mode |
-| `NODE_ENV` | No | `development` | Environment mode |
+| `NODE_ENV` | No | `development` | Environment mode. One of `local`, `debug`, `development`, `dev`, `sit`, `uat`, `alpha`, `beta`, `staging`, `production` |
 | `ALLOW_EMPTY_ENV_VALUE` | No | `false` | Allow empty env values |
 
+The gate is fail-closed: an environment IGNIS does not recognise is treated as production, so error responses are sanitized. `local`, `debug`, `development`, `dev` and `sit` are the development environments - only they expose internal error detail. `alpha`, `beta`, `staging` and `production` stay sanitized.
+
 ### Example
 
 ```bash
-# Development
-NODE_ENV=development
+# Development - `dev` is an alias of `development`, and gets the same error detail
+NODE_ENV=dev
 DEBUG=true
 
 # Production
@@ -347,20 +365,20 @@ project/
 
 ## Custom Environment Prefix
 
-You can customize the prefix from `APP_ENV_` to something else:
+You can customize the prefix from `APP_ENV` to something else via the `APPLICATION_ENV_PREFIX` variable. It is read once when `@venizia/ignis-helpers` loads, so set it in the shell (or before any framework import):
 
-```typescript
-// Set custom prefix
-process.env.APPLICATION_ENV_PREFIX = 'MY_APP';
+```bash
+# Set custom prefix
+APPLICATION_ENV_PREFIX=MY_APP
 
-// Now use MY_APP_ prefix
-// MY_APP_POSTGRES_HOST=localhost
+# Now use MY_APP_ prefix
+MY_APP_POSTGRES_HOST=localhost
 ```
 
 
 ## Validation
 
-Ignis validates `APP_ENV_*` variables on startup. Missing required variables will cause the application to fail with a clear error message.
+On startup, IGNIS iterates every `APP_ENV_*` (prefixed) variable that is set and throws if any has an empty value (`validateEnvs` in `packages/core/src/base/applications/abstract.ts`). It does not check for variables that are absent entirely - component-level validation (e.g., the authentication component's `jwtSecret` check) covers required values.
 
 ### Disable Validation
 

package/content/references/configuration/index.md

@@ -1,6 +1,6 @@
 # Configuration Reference
 
-Configuration options and environment variables for Ignis applications.
+Configuration options and environment variables for IGNIS applications.
 
 ## Quick Reference
 
@@ -11,15 +11,15 @@ Configuration options and environment variables for Ignis applications.
 | Database | PostgreSQL connection | `APP_ENV_POSTGRES_HOST`, `APP_ENV_POSTGRES_DATABASE` |
 | Authentication | JWT tokens and secrets | `APP_ENV_JWT_SECRET`, `APP_ENV_APPLICATION_SECRET` |
 | Logging | Log file paths and transports | `APP_ENV_LOGGER_FOLDER_PATH` |
-| Storage | MinIO/S3 file storage | `APP_ENV_MINIO_HOST`, `APP_ENV_MINIO_ACCESS_KEY` |
-| Mail | SMTP email sending | `APP_ENV_MAIL_HOST`, `APP_ENV_MAIL_USER` |
+| Storage | MinIO/S3 file storage (application-level convention) | `APP_ENV_MINIO_HOST`, `APP_ENV_MINIO_ACCESS_KEY` |
+| Mail | SMTP email sending (application-level convention) | `APP_ENV_MAIL_HOST`, `APP_ENV_MAIL_USER` |
 
 ## Environment Variable Prefix
 
-Ignis uses the `APP_ENV_` prefix to avoid conflicts with system variables:
+IGNIS uses the `APP_ENV_` prefix to avoid conflicts with system variables:
 
 ```bash
-# ✅ Ignis variables
+# ✅ IGNIS variables
 APP_ENV_POSTGRES_HOST=localhost
 
 # ❌ Might conflict with system
@@ -69,7 +69,7 @@ project/
 
 ### 3. Validation on Startup
 
-Ignis validates required variables on startup. Missing values cause clear error messages.
+IGNIS validates every set `APP_ENV_*` variable on startup and fails with a clear error if any is empty (bypass with `ALLOW_EMPTY_ENV_VALUE=true`). Absent variables are not flagged - components validate their own required inputs.
 
 > **Related:** [Environment Variables Reference](./environment-variables.md) | [DataSources Guide](../../guides/core-concepts/persistent/datasources)
 

package/content/references/index.md

@@ -1,6 +1,6 @@
 # API Reference
 
-Complete reference documentation for the Ignis framework. Find detailed API docs, type definitions, and usage examples for every class, component, and utility in the framework.
+Complete reference documentation for the IGNIS framework. Find detailed API docs, type definitions, and usage examples for every class, component, and utility in the framework.
 
 <div class="guide-cards">
 
@@ -63,7 +63,7 @@ Complete reference documentation for the Ignis framework. Find detailed API docs
 <span class="stage-num">3</span>
 <h4>Adding Features</h4>
 </div>
-<p><a href="/ignis/extensions/components/authentication/">Auth</a> → <a href="/ignis/extensions/components/socket-io/">Real-time</a> → <a href="/ignis/extensions/components/mail/">Email</a> → <a href="/ignis/extensions/components/swagger">API Docs</a></p>
+<p><a href="/ignis/extensions/components/authentication/">Auth</a> → <a href="/ignis/extensions/components/socket-io/">Real-time</a> → <a href="/ignis/extensions/components/mail/">Email</a> → <a href="/ignis/extensions/components/api-reference">API Docs</a></p>
 <span class="stage-desc">Pre-built components for common features</span>
 </div>
 
@@ -99,7 +99,7 @@ Complete reference documentation for the Ignis framework. Find detailed API docs
 <span class="stage-num">7</span>
 <h4>Testing & Quality</h4>
 </div>
-<p><a href="/ignis/extensions/helpers/testing/">Unit Testing</a> → <a href="./base/repositories/advanced">Mocking & Stubs</a> → <a href="./quick-reference">Best Practices</a></p>
+<p><a href="./base/repositories/advanced">Mocking & Stubs</a> → <a href="./quick-reference">Best Practices</a></p>
 <span class="stage-desc">Testing strategies, quality assurance, and code review</span>
 </div>
 
@@ -123,18 +123,23 @@ class UserController extends BaseRestController {
 
 **Query with Repository:**
 ```typescript
-const users = await userRepo.find({
-  where: { isActive: true },
-  orderBy: { createdAt: 'desc' },
-  limit: 10,
+const users = await userRepository.find({
+  filter: {
+    where: { isActive: true },
+    order: ['createdAt DESC'],
+    limit: 10,
+  },
 });
 ```
 
 **Schedule a Job:**
 ```typescript
-CronHelper.schedule('0 * * * *', async () => {
-  await cleanupExpiredSessions();
-});
+CronHelper.newInstance({
+  cronTime: '0 * * * *',
+  onTick: async () => {
+    await cleanupExpiredSessions();
+  },
+}).start();
 ```
 
 ## Common Imports
@@ -156,7 +161,7 @@ import {
 // Helpers
 import {
   LoggerFactory,
-  RedisHelper,
+  RedisSingleHelper,
   QueueHelper,
 } from '@venizia/ignis-helpers';
 
@@ -166,7 +171,7 @@ import { Container } from '@venizia/ignis-inversion';
 
 ## See Also
 
-- [Getting Started](/guides/) - New to Ignis? Start here
+- [Getting Started](/guides/) - New to IGNIS? Start here
 - [Core Concepts](/guides/core-concepts/application/) - Deep dive into architecture
 - [Best Practices](/best-practices/) - Production patterns
 - [Changelogs](/changelogs/) - Version history

package/content/references/quick-reference.md

@@ -30,8 +30,6 @@ await app.start();
 - `initialize()` - Bootstrap the application
 - `start()` - Start HTTP server
 - `stop()` - Stop server gracefully
-- `get<T>(key)` - Resolve from DI container
-- `mountControllers()` - Register controllers
 
 ### BaseRestController
 
@@ -85,7 +83,7 @@ class GreeterController extends BaseGrpcController {
 ```typescript
 import { BaseService, injectable } from '@venizia/ignis';
 
-@injectable()
+@injectable({})
 class UserService extends BaseService {
   constructor() {
     super({ scope: UserService.name });
@@ -93,7 +91,7 @@ class UserService extends BaseService {
 
   async getUser(id: string) {
     this.logger.info('Getting user', id);
-    return this.userRepo.findById(id);
+    return this.userRepository.findById({ id });
   }
 }
 ```
@@ -104,27 +102,25 @@ class UserService extends BaseService {
 ### DefaultCRUDRepository
 
 ```typescript
-import { DefaultCRUDRepository } from '@venizia/ignis';
+import { DefaultCRUDRepository, repository } from '@venizia/ignis';
 import { User } from '../models';
+import { PostgresDataSource } from '../datasources';
 
-class UserRepository extends DefaultCRUDRepository<User> {
-  constructor() {
-    super(User);
-  }
+@repository({ model: User, dataSource: PostgresDataSource })
+class UserRepository extends DefaultCRUDRepository<typeof User.schema> {
+  // No constructor needed - dataSource auto-injected from @repository decorator
 }
 ```
 
 **Key Methods:**
-- `create(data)` - Create single entity
-- `createMany(data[])` - Create multiple entities
-- `find(filter?)` - Find many with filter
-- `findById(id)` - Find by ID
-- `findOne(filter)` - Find single entity
-- `count(filter?)` - Count entities
-- `update(id, data)` - Update by ID
-- `updateMany(filter, data)` - Update multiple
-- `delete(id)` - Delete by ID (soft/hard based on config)
-- `deleteMany(filter)` - Delete multiple
+- `find({ filter })` - Find many with filter, returns `T[]`
+- `findById({ id })` - Find by ID
+- `findOne({ filter })` - Find single entity
+- `count({ where? })` - Count entities
+- `create({ data })` - Create single entity, returns `{ count, data }`
+- `createAll({ data: [] })` - Create multiple entities, returns `{ count, data[] }`
+- `updateById({ id, data })` - Update by ID
+- `deleteById({ id })` - Delete by ID
 
 ### BaseEntity
 
@@ -132,10 +128,10 @@ class UserRepository extends DefaultCRUDRepository<User> {
 import { BaseEntity, model } from '@venizia/ignis';
 import { integer, text, pgTable } from 'drizzle-orm/pg-core';
 
-@model()
+@model({ type: 'entity' })
 class User extends BaseEntity {
-  static readonly tableName = 'users';
-  static readonly schema = pgTable(User.tableName, {
+  static readonly TABLE_NAME = 'users';
+  static readonly schema = pgTable(User.TABLE_NAME, {
     id: integer('id').primaryKey(),
     name: text('name').notNull(),
     email: text('email').notNull().unique(),
@@ -144,7 +140,7 @@ class User extends BaseEntity {
 ```
 
 **Key Properties:**
-- `static tableName` - Database table name
+- `static TABLE_NAME` - Database table name
 - `static schema` - Drizzle schema definition
 - `static AUTHORIZATION_SUBJECT` - Authorization principal (auto-set from `@model` settings `authorize.principal`)
 
@@ -226,7 +222,7 @@ class UserController extends BaseRestController {
 | Operator | SQL | Example |
 |----------|-----|---------|
 | `in` | `IN` | `{ status: { in: ['active', 'pending'] } }` |
-| `notIn` | `NOT IN` | `{ status: { notIn: ['deleted'] } }` |
+| `nin` | `NOT IN` | `{ status: { nin: ['deleted'] } }` |
 
 ### Pattern Matching
 
@@ -234,17 +230,8 @@ class UserController extends BaseRestController {
 |----------|-----|---------|
 | `like` | `LIKE` | `{ name: { like: '%john%' } }` |
 | `ilike` | `ILIKE` | `{ email: { ilike: '%@gmail.com' } }` |
-| `notLike` | `NOT LIKE` | `{ name: { notLike: '%test%' } }` |
-| `notILike` | `NOT ILIKE` | `{ email: { notILike: '%spam%' } }` |
-| `startsWith` | `LIKE 'value%'` | `{ name: { startsWith: 'John' } }` |
-| `endsWith` | `LIKE '%value'` | `{ email: { endsWith: '@example.com' } }` |
-
-### Null Operators
-
-| Operator | SQL | Example |
-|----------|-----|---------|
-| `isNull` | `IS NULL` | `{ deletedAt: { isNull: true } }` |
-| `isNotNull` | `IS NOT NULL` | `{ email: { isNotNull: true } }` |
+| `nlike` | `NOT LIKE` | `{ name: { nlike: '%test%' } }` |
+| `nilike` | `NOT ILIKE` | `{ email: { nilike: '%spam%' } }` |
 
 ### Logical Operators
 
@@ -262,61 +249,59 @@ class UserController extends BaseRestController {
 | `containedBy` | `<@` | `{ tags: { containedBy: ['ts', 'js', 'go'] } }` |
 | `overlaps` | `&&` | `{ tags: { overlaps: ['react', 'vue'] } }` |
 
-### JSON Operators (PostgreSQL)
-
-| Operator | Description | Example |
-|----------|-------------|---------|
-| `jsonPath` | Query JSON field | `{ metadata: { jsonPath: '$.user.name', eq: 'John' } }` |
-
-
 ## Common Filters
 
 ### Basic Find
 
 ```typescript
-const users = await userRepo.find({
-  where: { isActive: true },
-  orderBy: { createdAt: 'desc' },
-  limit: 10,
-  offset: 0,
+const users = await userRepository.find({
+  filter: {
+    where: { isActive: true },
+    order: ['createdAt DESC'],
+    limit: 10,
+    offset: 0,
+  },
 });
 ```
 
 ### With Multiple Conditions
 
 ```typescript
-const users = await userRepo.find({
-  where: {
-    and: [
-      { age: { gte: 18 } },
-      { status: { in: ['active', 'pending'] } },
-      { email: { endsWith: '@company.com' } }
-    ]
-  }
+const users = await userRepository.find({
+  filter: {
+    where: {
+      and: [
+        { age: { gte: 18 } },
+        { status: { in: ['active', 'pending'] } },
+        { email: { ilike: '%@company.com' } },
+      ],
+    },
+  },
 });
 ```
 
 ### With Relations
 
 ```typescript
-const posts = await postRepo.find({
-  where: { published: true },
-  include: {
-    author: true,
-    comments: {
-      where: { approved: true },
-      limit: 5
-    }
-  }
+const posts = await postRepository.find({
+  filter: {
+    where: { published: true },
+    include: [
+      { relation: 'author' },
+      { relation: 'comments', scope: { where: { approved: true }, limit: 5 } },
+    ],
+  },
 });
 ```
 
 ### Selecting Fields
 
 ```typescript
-const users = await userRepo.find({
-  where: { isActive: true },
-  fields: ['id', 'name', 'email'], // Only these fields
+const users = await userRepository.find({
+  filter: {
+    where: { isActive: true },
+    fields: ['id', 'name', 'email'],
+  },
 });
 ```
 
@@ -328,7 +313,7 @@ const users = await userRepo.find({
 ```typescript
 import { injectable } from '@venizia/ignis';
 
-@injectable()
+@injectable({})
 class MyService extends BaseService {
   // ...
 }
@@ -348,13 +333,6 @@ class UserController extends BaseRestController {
   }
 ```
 
-### Manual Resolution
-
-```typescript
-const userService = app.get<UserService>('services.UserService');
-```
-
-
 ## Common Imports
 
 ### Core Framework
@@ -408,21 +386,20 @@ import {
   ApplicationLogger,
 
   // Caching
-  RedisHelper,
+  RedisSingleHelper,
 
   // Queues
   QueueHelper,
 
   // Crypto
   hash,
-  compare,
 
   // HTTP
   HTTP,
 } from '@venizia/ignis-helpers';
 import { BullMQHelper } from '@venizia/ignis-helpers/bullmq';
 import { CronHelper } from '@venizia/ignis-helpers/cron';
-import { MinIOHelper } from '@venizia/ignis-helpers/minio';
+import { MinioHelper } from '@venizia/ignis-helpers/minio';
 ```
 
 ### Dependency Injection
@@ -487,14 +464,17 @@ getDashboard(c: Context) {
 import { Statuses } from '@venizia/ignis';
 
 // Create with status
-const order = await orderRepo.create({
-  items: [...],
-  status: Statuses.PENDING,
+const { data: order } = await orderRepository.create({
+  data: {
+    items: [...],
+    status: Statuses.PENDING,
+  },
 });
 
 // Update status
-await orderRepo.update(orderId, {
-  status: Statuses.COMPLETED,
+await orderRepository.updateById({
+  id: orderId,
+  data: { status: Statuses.COMPLETED },
 });
 
 // Check status
@@ -556,27 +536,6 @@ app.notFound(notFoundHandler({ logger: app.logger }));
 ```
 
 
-## Environment Variables
-
-### Loading Environment
-
-```typescript
-import { EnvHelper } from '@venizia/ignis-helpers';
-
-// Load from .env file
-EnvHelper.load();
-
-// Get variable
-const dbUrl = EnvHelper.get('DATABASE_URL');
-
-// Get with default
-const port = EnvHelper.get('PORT', '3000');
-
-// Get required (throws if missing)
-const apiKey = EnvHelper.getRequired('API_KEY');
-```
-
-
 ## Common Patterns
 
 ### Controller → Service → Repository
@@ -605,7 +564,7 @@ class UserController extends BaseRestController {
 class UserService extends BaseService {
   constructor(
     @inject({ key: 'repositories.UserRepository' })
-    private userRepo: UserRepository,
+    private userRepository: UserRepository,
   ) {
     super({ scope: UserService.name });
   }
@@ -614,7 +573,7 @@ class UserService extends BaseService {
     // Business logic
     const hashedPassword = await hash({ value: data.password });
 
-    return this.userRepo.create({
+    return this.userRepository.create({
       data: {
         ...data,
         password: hashedPassword,