@ooneex/cli 1.38.2 → 1.40.1

package/dist/index.js

@@ -6042,18 +6042,18 @@ var askName = async (config) => {
 
 // src/templates/app/app-database.txt
 var app_database_default = `import { SharedModule } from "@module/shared/SharedModule";
-import { AppEnv } from "@ooneex/app-env";
-import { inject } from "@ooneex/container";
 import { DatabaseException, decorator, TypeormDatabase } from "@ooneex/database";
+import { inject } from "@ooneex/container";
+import { AppEnv } from "@ooneex/app-env";
 import { DataSource } from "typeorm";
 
 @decorator.database()
 export class SharedDatabase extends TypeormDatabase {
-  constructor(@inject(AppEnv) private readonly env: AppEnv) {
+  public constructor(@inject(AppEnv) private readonly env: AppEnv) {
     super();
   }
 
-  public getSource(): DataSource {
+  public getSource(_database?: string): DataSource {
     if (this.source) {
       return this.source;
     }
@@ -6210,6 +6210,27 @@ const app = new App({
 await app.run();
 `;
 
+// src/templates/app/package.json.txt
+var package_json_default = `{
+  "name": "{{NAME}}",
+  "scripts": {
+    "fmt": "bunx biome check --write",
+    "lint": "bunx nx run-many -t lint --output-style=stream --verbose",
+    "test": "bunx nx run-many -t test --output-style=stream --verbose",
+    "check": "bun install && bun run build && bun run lint && bun run test",
+    "commit": "bunx commit"
+  },
+  "workspaces": [
+    "modules/*"
+  ],
+  "lint-staged": {
+    "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+      "biome check --files-ignore-unknown=true"
+    ]
+  }
+}
+`;
+
 // src/templates/bitbucket/pipelines.yml.txt
 var pipelines_yml_default = `# Bitbucket Pipelines
 # Place at bitbucket-pipelines.yml in the repository root.
@@ -10341,26 +10362,6 @@ var nx_json_default = `{
 }
 `;
 
-// src/templates/app/package.json.txt
-var package_json_default = `{
-  "name": "{{NAME}}",
-  "scripts": {
-    "fmt": "bunx biome check --write",
-    "lint": "bunx nx run-many -t lint --output-style=stream --verbose",
-    "test": "bunx nx run-many -t test --output-style=stream --verbose",
-    "commit": "bunx commit"
-  },
-  "workspaces": [
-    "modules/*"
-  ],
-  "lint-staged": {
-    "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
-      "biome check --files-ignore-unknown=true"
-    ]
-  }
-}
-`;
-
 // src/templates/app/README.md.txt
 var README_md_default = "# {{NAME}}\n\nA modular, enterprise-grade backend framework built with TypeScript and Bun, powered by the **@ooneex** ecosystem.\n\n## Prerequisites\n\n- [Bun](https://bun.sh) (latest)\n- [Docker](https://www.docker.com/) & Docker Compose\n\n## Getting Started\n\n### Install Dependencies\n\n```bash\nbun install\n```\n\n### Environment Configuration\n\nThe environment file is created automatically at `modules/app/.env.yml`. Edit it to fill in the required values:\n\n| Variable | Description | Required |\n|---|---|---|\n| `app.env` | Application environment (`local`, `development`, `staging`, `testing`, `production`, \u2026) | Yes |\n| `app.port` | Server port number (default: `3000`) | Yes |\n| `app.host` | Server hostname (default: `0.0.0.0`) | Yes |\n| `logs.database_url` | Database URL for storing application logs | No |\n| `logs.betterstack.source_token` | Logtail source token for Better Stack logging | No |\n| `logs.betterstack.ingesting_host` | Better Stack log ingestion host URL | No |\n| `exception.betterstack.application_token` | Better Stack token for exception tracking | No |\n| `exception.betterstack.ingesting_host` | Better Stack exception ingestion host URL | No |\n| `analytics.posthog.project_token` | PostHog project token for event tracking | No |\n| `analytics.posthog.host` | PostHog ingest host (default: `https://eu.i.posthog.com`) | No |\n| `cache.redis.url` | Redis connection URL for caching | No |\n| `cache.upstash.rest_url` | Upstash Redis REST URL for serverless caching | No |\n| `cache.upstash.rest_token` | Upstash Redis REST token for serverless caching | No |\n| `pubsub.redis.url` | Redis connection URL for pub/sub messaging | No |\n| `rate_limit.redis.url` | Redis connection URL for rate limiting | No |\n| `rate_limit.upstash.url` | Upstash Redis URL for serverless rate limiting | No |\n| `rate_limit.upstash.token` | Upstash Redis token for serverless rate limiting | No |\n| `cors.origins` | Comma-separated allowed origins or `*` (default: `*`) | No |\n| `cors.methods` | Comma-separated HTTP methods | No |\n| `cors.headers` | Comma-separated allowed request headers | No |\n| `cors.exposed_headers` | Comma-separated headers exposed to the browser | No |\n| `cors.credentials` | Allow credentials: `true` or `false` | No |\n| `cors.max_age` | Preflight response cache duration in seconds | No |\n| `database.url` | PostgreSQL connection URL | No |\n| `database.redis.url` | Redis connection URL for Redis-based database operations | No |\n| `database.sqlite.path` | SQLite database file path | No |\n| `storage.cloudflare.access_key` | Cloudflare R2 access key ID | No |\n| `storage.cloudflare.secret_key` | Cloudflare R2 secret access key | No |\n| `storage.cloudflare.endpoint` | Cloudflare R2 endpoint URL | No |\n| `storage.cloudflare.region` | Cloudflare R2 region (default: `EEUR`) | No |\n| `storage.bunny.access_key` | BunnyCDN access key | No |\n| `storage.bunny.storage_zone` | BunnyCDN storage zone name | No |\n| `storage.bunny.region` | BunnyCDN region (default: `de`) | No |\n| `storage.filesystem.path` | Base directory path for local file storage | No |\n| `mailer.sender.name` | Display name for email sender | No |\n| `mailer.sender.address` | Email address for sender | No |\n| `mailer.resend.api_key` | Resend email service API key | No |\n| `jwt.secret` | Secret key for HS256 JWT signing and verification | No |\n| `ai.openrouter.api_key` | OpenRouter API key for accessing 300+ AI models | No |\n| `ai.openai.api_key` | OpenAI API key | No |\n| `ai.anthropic.api_key` | Anthropic API key for Claude models | No |\n| `ai.gemini.api_key` | Google Gemini API key | No |\n| `ai.groq.api_key` | Groq API key for LLM inference | No |\n| `ai.ollama.host` | Ollama host URL for local LLM inference | No |\n| `payment.polar.access_token` | Polar payment platform access token | No |\n| `payment.polar.environment` | Polar environment (`sandbox` or `production`) | No |\n| `authentication.auth_token` | Shared secret token for service-to-service authentication | No |\n| `authentication.clerk.secret_key` | Clerk authentication secret key | No |\n| `linear.api_key` | Linear API key for issue sync (`issue:pull`, `issue:push`) | No |\n| `linear.team_id` | Linear team ID \u2014 skips team selection prompt in `issue:push` | No |\n| `allowed_users.development` | Comma-separated emails allowed in the `development` environment | No |\n| `allowed_users.staging` | Comma-separated emails allowed in the `staging` environment | No |\n| `allowed_users.testing` | Comma-separated emails allowed in the `testing` environment | No |\n| `allowed_users.test` | Comma-separated emails allowed in the `test` environment | No |\n| `allowed_users.qa` | Comma-separated emails allowed in the `qa` environment | No |\n| `allowed_users.uat` | Comma-separated emails allowed in the `uat` environment | No |\n| `allowed_users.integration` | Comma-separated emails allowed in the `integration` environment | No |\n| `allowed_users.preview` | Comma-separated emails allowed in the `preview` environment | No |\n| `allowed_users.demo` | Comma-separated emails allowed in the `demo` environment | No |\n| `allowed_users.sandbox` | Comma-separated emails allowed in the `sandbox` environment | No |\n| `allowed_users.beta` | Comma-separated emails allowed in the `beta` environment | No |\n| `allowed_users.canary` | Comma-separated emails allowed in the `canary` environment | No |\n| `allowed_users.hotfix` | Comma-separated emails allowed in the `hotfix` environment | No |\n| `allowed_users.system` | Comma-separated system user emails | No |\n| `allowed_users.super_admin` | Comma-separated super-admin user emails | No |\n| `allowed_users.admin` | Comma-separated admin user emails | No |\n\n### Start the App\n\nStarts Docker services (if a `docker-compose.yml` is present) and launches the application with hot reload:\n\n```bash\noo app:start\n```\n\n### Stop the App\n\nStops all Docker services:\n\n```bash\noo app:stop\n```\n\n### Build the App\n\nCompiles the application for production. Output is written to the `dist` directory:\n\n```bash\noo app:build\n```\n\n---\n\n## Modules\n\nModules are the core organizational unit. Each module lives under `modules/<name>/` and contains its own controllers, services, repositories, entities, migrations, and seeds.\n\n### Why Modules?\n\nA flat codebase quickly becomes hard to navigate and reason about as an application grows. Modules address this by enforcing **vertical slicing**: all code related to a single business domain (e.g. `user`, `order`, `billing`) lives together rather than being scattered across generic `controllers/`, `services/`, and `repositories/` folders.\n\n**Benefits:**\n\n- **Domain isolation** \u2014 changes to one feature cannot accidentally break another; each module is a self-contained unit with explicit boundaries.\n- **Parallel development** \u2014 teams can work on separate modules without stepping on each other's code or creating merge conflicts in shared directories.\n- **Independent deployment** \u2014 a module can be extracted into a standalone service later with minimal refactoring because its code is already co-located.\n- **Simpler onboarding** \u2014 a new developer understands the scope of a feature by exploring a single directory instead of tracing imports across the whole project.\n- **Scoped migrations & seeds** \u2014 database changes stay close to the entities they affect, making rollbacks and reviews straightforward.\n\n**Good practices:**\n\n- Name modules after business domains (`user`, `product`, `payment`), not technical layers (`controllers`, `helpers`).\n- Keep modules small and focused. If a module grows beyond ~10 controllers or services, consider splitting it by sub-domain.\n- Never import from another module's internal files directly \u2014 expose only what is needed through the module's public index.\n- Register all entities in `SharedModule` (done automatically by `oo make:entity`) so the ORM has a single source of truth.\n- Run `oo module:lock` after every migration or seed change to protect file integrity in CI.\n- Prefix route names with the module name (e.g. `api.user.create`) to avoid collisions across modules.\n\n### Create a Module\n\nScaffolds a new module with all required structure, registers it in `AppModule`, adds its entities to `SharedModule`, and updates `tsconfig.json` path aliases and commitlint config:\n\n```bash\noo module:create\noo module:create --name user\n```\n\n### Lock a Module\n\nHashes migration and seed files into a module manifest (`.yml`) for integrity verification. Run this after adding or modifying migrations/seeds:\n\n```bash\noo module:lock --module user\noo module:lock --module user --override   # force update existing hashes\n```\n\n### Delete a Module\n\nRemoves a module and cleans up all references from `AppModule`, `SharedModule`, `tsconfig.json`, and commitlint config. The `app` and `shared` core modules cannot be removed:\n\n```bash\noo module:remove\noo module:remove --name user\noo module:remove --name user --silent    # skip confirmation prompt\n```\n\n---\n\n## Migrations\n\nMigrations are versioned, incremental SQL scripts that evolve your database schema over time. Each migration lives in `modules/<name>/src/migrations/` and is executed in order, making every schema change reproducible, reviewable, and reversible.\n\n### Why Migrations?\n\nManually altering a database in production is error-prone and leaves no audit trail. Migrations solve this by treating schema changes as code: they are committed to git, reviewed in pull requests, and applied the same way in every environment \u2014 local, staging, and production.\n\n**Benefits:**\n\n- **Reproducibility** \u2014 any developer can recreate the exact database state by running `oo migration:up` from scratch.\n- **History & auditability** \u2014 every schema change is tied to a commit, a date, and an author, making it easy to understand when and why a column or table was added.\n- **Safe deployments** \u2014 CI runs migrations before the application boots, catching schema errors before they reach production.\n- **Rollback capability** \u2014 because changes are incremental and versioned, you can reason about what to undo if a deployment goes wrong.\n- **Team coordination** \u2014 concurrent feature branches each generate their own migration file; the timestamp ordering ensures they are applied in the correct sequence when merged.\n\n**Good practices:**\n\n- One migration per logical change (e.g. add a table, add a column, add an index). Avoid bundling unrelated schema changes in a single file.\n- Never edit a migration that has already been applied in any shared environment \u2014 create a new migration to amend it instead.\n- Always write both `up` and `down` logic so migrations can be rolled back cleanly.\n- Keep migrations idempotent where possible (e.g. `CREATE TABLE IF NOT EXISTS`) to prevent failures on re-runs.\n- Run `oo module:lock` after every new migration to hash the file into the module manifest and enable integrity checks in CI.\n- Test migrations against a real database in CI \u2014 schema errors are invisible to TypeScript's type checker.\n- Avoid putting business logic or data transformations in migrations; keep them strictly structural (DDL) or use a dedicated seed for data.\n\n### Create a Migration\n\nGenerates a timestamped migration file in `modules/<name>/src/migrations/` along with a test file and a `bin/migration/up.ts` runner (if not already present):\n\n```bash\noo migration:create --module user\n```\n\n### Run Migrations\n\nExecutes migrations across all modules sequentially:\n\n```bash\noo migration:up\noo migration:up --drop   # drop database before migrating\n```\n\n---\n\n## Seeds\n\nSeeds populate your database with initial or reference data \u2014 default roles, configuration values, demo content, or test fixtures. Each seed lives in `modules/<name>/src/seeds/` as a YAML file and is executed in order via the seed runner.\n\n### Why Seeds?\n\nHardcoding initial data in migration files mixes structural changes with data concerns, making both harder to maintain. Seeds keep data separate from schema, so they can be re-run independently, updated without touching migrations, and disabled in environments where they are not needed.\n\n**Benefits:**\n\n- **Consistent starting state** \u2014 every developer and every environment boots with the same baseline data, eliminating \"works on my machine\" data discrepancies.\n- **Readable data definitions** \u2014 YAML files are easy to read, diff, and review in pull requests without understanding SQL or TypeScript.\n- **Repeatable setup** \u2014 onboarding a new developer or spinning up a fresh staging environment requires only `oo seed:run` instead of manual database operations.\n- **Separation of concerns** \u2014 schema structure (migrations) and data content (seeds) evolve independently, reducing noise in both histories.\n- **Safe resets** \u2014 `oo seed:run --drop` wipes and repopulates data without touching the schema, useful for resetting demo or test environments.\n\n**Good practices:**\n\n- Use seeds for **reference data** (roles, permissions, countries, currencies) and **development fixtures** (demo users, sample products). Avoid using them for production user data.\n- Keep each seed file focused on a single entity or dataset \u2014 one file per table is a reasonable default.\n- Write seeds so they are idempotent: inserting with `ON CONFLICT DO NOTHING` or checking for existence before inserting prevents errors on re-runs.\n- Never depend on data inserted by another module's seed unless you control the execution order explicitly.\n- Run `oo module:lock` after adding or modifying a seed to update the module manifest and protect file integrity in CI.\n- Mirror your migration order: seed data for a table only after the migration that creates it has been applied.\n- Avoid generating seeds with random or time-dependent values \u2014 deterministic data makes debugging and comparison across environments reliable.\n\n### Create a Seed\n\nGenerates a YAML seed file in `modules/<name>/src/seeds/` along with a test file and a `bin/seed/run.ts` runner (if not already present):\n\n```bash\noo seed:create --module user\noo seed:create --name initial-roles --module user\n```\n\n### Run Seeds\n\nExecutes seeds across all modules sequentially:\n\n```bash\noo seed:run\noo seed:run --drop   # drop data before seeding\n```\n\n---\n\n## Issues\n\nIssues bridge your Linear project management board and your local codebase. Each issue is represented as a YAML file under `modules/<name>/issues/` and serves as the single source of truth for what is being built, why, and what \"done\" looks like.\n\n**Requirements:** `linear.api_key` must be set in the environment for commands that talk to Linear (`issue:pull`, `issue:push`). Add it to `modules/app/.env.yml`:\n\n```yaml\nlinear:\n  api_key: lin_api_xxxxxxxxxx\n  team_id: your_team_id       # optional \u2014 skips the team selection prompt in issue:push\n```\n\n### Issue YAML format\n\nEvery issue file follows a consistent schema:\n\n```yaml\nid: \"OON-123\"\ntitle: \"Add password reset flow\"\nstate: \"In Progress\"\npriority: \"High\"\ndescription: |\n  **Context**: Users currently have no way to recover a forgotten password.\n\n  **Goal**: Implement a secure email-based password reset flow.\n\n  **Acceptance Criteria**:\n  - [ ] User can request a reset link via their email address\n  - [ ] Link expires after 1 hour\n  - [ ] Used links are invalidated immediately\n\n  **Technical Notes**: Use JWT with short TTL; store a one-time token hash in the database.\nlabels:\n  - \"authentication\"\n  - \"security\"\ncomments:\n  - author: \"Alice\"\n    message: \"Make sure the token is hashed before storage, not stored in plain text.\"\n```\n\n---\n\n### Create an Issue\n\n`issue:create` scaffolds a new issue YAML locally with a generated `[A-F]{3}-[0-9]{6}` placeholder identifier. No Linear connection is required \u2014 use this when you want to define and refine an issue offline before pushing it to Linear.\n\nBy default all fields are empty; pass `--interactive` to be prompted for each one:\n\n```bash\noo issue:create                                                  # Empty skeleton in shared module\noo issue:create --title \"Add password reset\" --module user       # Pre-fill title, save to user module\noo issue:create --interactive                                    # Prompt for title, state, priority, labels, description\noo issue:create --interactive --module user                      # Interactive + save into modules/user/issues/\n```\n\nAfter writing the file the command optionally **improves the description with Claude** \u2014 rewrites a raw description into the structured *Context / Goal / Acceptance Criteria / Technical Notes* format and suggests labels derived from the description.\n\n---\n\n### Pull an Issue\n\n`issue:pull` fetches an existing Linear issue by its identifier and saves it as `modules/<name>/issues/<identifier>.yml`. Use this to sync a ticket into your local workspace before starting implementation.\n\n```bash\noo issue:pull                               # Prompt for issue ID\noo issue:pull --id OON-123                  # Pull a specific issue\noo issue:pull --id OON-123 --module user    # Save into modules/user/issues/\n```\n\nAfter saving the file the command optionally improves the description with Claude, the same as `issue:create`.\n\n---\n\n### Improve an Issue\n\n`/issue:improve` rewrites the description of an existing issue YAML into the structured *Context / Goal / Acceptance Criteria / Technical Notes* format, suggests labels, and optionally splits the issue into smaller focused sub-issues.\n\n```\n/issue:improve --id OON-123 --module user\n```\n\n---\n\n### Push an Issue\n\n`issue:push` reads a local YAML file and syncs it back to Linear. It detects whether the issue already exists and either **updates** it (title, description, state, priority, labels, new comments) or **creates** it from scratch in a team you select interactively.\n\n```bash\noo issue:push                               # Prompt for issue ID\noo issue:push --id OON-123                  # Push modules/shared/issues/OON-123.yml\noo issue:push --id OON-123 --module user    # Push modules/user/issues/OON-123.yml\n```\n\nWhen creating a new issue (no matching Linear issue found), the command:\n- Prompts you to select a target team\n- Resolves or creates states and labels as needed\n- Renames the local file to match the real Linear identifier once the issue is created\n\n---\n\n### Recommended Workflow\n\nThere are two natural entry points depending on whether the ticket originates in Linear or locally.\n\n#### Linear-first (existing ticket)\n\nUse this when a ticket is already created in Linear (e.g. by a product manager) and you are picking it up for implementation:\n\n```\n1. oo issue:pull --id OON-123 --module user\n   \u2192 Downloads the issue YAML into modules/user/issues/OON-123.yml\n   \u2192 Optionally improves the description with Claude\n\n2. oo issue:push --id OON-123 --module user\n   \u2192 Pushes any local edits (description improvements, label changes, comments) back to Linear\n   \u2192 Updates the state to reflect current progress (e.g. \"In Progress\" \u2192 \"In Review\")\n```\n\n#### Offline-first (new idea or local spike)\n\nUse this when you are defining a new feature locally before it exists in Linear:\n\n```\n1. oo issue:create --interactive --module user\n   \u2192 Creates a YAML skeleton with a placeholder ID (e.g. ABD-042381)\n   \u2192 Optionally improves the description with Claude and suggests labels\n\n2. Refine the YAML: adjust title, state, priority, description, labels.\n\n3. oo issue:push --id ABD-042381 --module user\n   \u2192 Creates the issue in Linear under the team you select\n   \u2192 Renames the local file to the real Linear identifier (e.g. OON-124.yml)\n```\n\n#### Day-to-day tips\n\n- **Commit issue YAMLs alongside implementation commits** \u2014 the file is the authoritative record of what was planned and why. Future reviewers and `git blame` will thank you.\n- **Use the description improvement step** \u2014 a well-structured description (Context / Goal / Acceptance Criteria) makes the issue easier to implement and review.\n- **Keep state in sync** \u2014 before marking a PR ready for review, run `issue:push` to move the Linear ticket to \"In Review\" so the board reflects reality.\n- **Never commit `linear.api_key`** \u2014 keep it in `modules/app/.env.yml` and ensure `.env.yml` is in `.gitignore`.\n\n---\n\n## Generators\n\n### AI\n\nGenerates an AI integration class in `modules/<name>/src/ai/<Name>Ai.ts`. Automatically installs `@ooneex/ai`:\n\n```bash\noo make:ai --name Chat --module user\n```\n\n**Why:** Calling LLM APIs directly from controllers or services mixes infrastructure concerns with business logic and makes it hard to swap providers. A dedicated AI class encapsulates the model, prompt strategy, and configuration in one place.\n\n**Benefits:** Provider-agnostic abstraction, centralised prompt management, easy to mock in tests, swap or upgrade models without touching business logic.\n\n**Good practices:**\n- One class per distinct AI capability (e.g. `ChatAi`, `SummarizeAi`, `ModerationAi`) \u2014 avoid a single god class.\n- Keep system prompts and model configuration inside the class, not scattered across callers.\n- Always handle rate-limit and timeout errors gracefully; never let an AI failure crash the request.\n- Log both the prompt and the response at `debug` level to simplify troubleshooting.\n\n---\n\n### Analytics\n\nGenerates an analytics handler class in `modules/<name>/src/analytics/<Name>Analytics.ts`. Automatically installs `@ooneex/analytics`:\n\n```bash\noo make:analytics --name User --module user\n```\n\n**Why:** Sprinkling raw analytics calls (PostHog, Segment, etc.) throughout controllers couples business logic to a third-party SDK. A dedicated analytics class centralises event definitions and makes it trivial to change or disable the provider.\n\n**Benefits:** Single source of truth for event names and properties, easy to stub in tests, provider can be swapped without touching controllers, events are discoverable by name.\n\n**Good practices:**\n- Name events after business actions, not UI interactions (e.g. `user.subscribed`, not `button.clicked`).\n- Define event property shapes as TypeScript types inside the class.\n- Always fire analytics asynchronously \u2014 never `await` a tracking call on the critical path.\n- Keep one analytics class per domain concept so event ownership is clear.\n\n---\n\n### Cache\n\nGenerates a cache handler class in `modules/<name>/src/cache/<Name>Cache.ts`. Automatically installs `@ooneex/cache`:\n\n```bash\noo make:cache --name User --module user\n```\n\n**Why:** Inline cache calls scattered through services create duplicated TTL values, inconsistent key formats, and make it hard to invalidate related entries. A dedicated cache class owns the key scheme and TTL policy for a given domain object.\n\n**Benefits:** Consistent key naming, single place to update TTLs, easy to add cache warming or invalidation logic, simple to disable caching during tests.\n\n**Good practices:**\n- Prefix keys with the module and entity name to avoid collisions (e.g. `user:profile:{id}`).\n- Define TTLs as named constants, not magic numbers.\n- Always invalidate or update the cache when the underlying data changes \u2014 stale reads are harder to debug than cache misses.\n- Use the cache for reads only; never store the primary copy of data in a cache.\n\n---\n\n### Controller\n\nGenerates an HTTP or WebSocket controller registered in the target module. Prompts for route name, path, and HTTP method if not provided. Automatically installs `@ooneex/controller`:\n\n```bash\noo make:controller --name UserCreate --module user\noo make:controller --name UserCreate --module user --route.name api.user.create --route.path /api/users --route.method POST\noo make:controller --name UserSocket --module user --isSocket\n```\n\n**Why:** Controllers are the entry point for all HTTP and WebSocket interactions. Generating them with a consistent structure ensures route registration, validation, and error handling are set up correctly from the start.\n\n**Benefits:** Automatic route registration in the module, consistent request/response patterns, clear separation between routing and business logic, WebSocket support out of the box.\n\n**Good practices:**\n- One controller per HTTP action (e.g. `UserCreateController`, `UserListController`) \u2014 avoid multi-action controllers.\n- Controllers should be thin: validate input, call a service, return a response. No business logic inside.\n- Prefix route names with the module (e.g. `api.user.create`) to avoid cross-module collisions.\n- Use the generated route name constant everywhere instead of hardcoding URL strings.\n\n---\n\n### Cron\n\nGenerates a cron job class in `modules/<name>/src/crons/<Name>Cron.ts` and registers it in the module. Automatically installs `@ooneex/cron`:\n\n```bash\noo make:cron --name Cleanup --module user\n```\n\n**Why:** Ad-hoc scheduled scripts outside the application are fragile, hard to monitor, and disconnected from the codebase. Cron classes live inside the module that owns the task, are registered with the DI container, and benefit from the same logging and error handling as the rest of the application.\n\n**Benefits:** Centralised schedule management, full access to injected services and repositories, observable via the application logger, easy to disable per environment.\n\n**Good practices:**\n- Name cron classes after the task, not the schedule (e.g. `ExpiredTokenCleanupCron`, not `DailyCron`).\n- Keep the cron class small \u2014 delegate actual work to a service method so the logic is testable independently.\n- Always log the start, end, and outcome of each run.\n- Make cron jobs idempotent: running the same job twice should not corrupt data.\n- Disable background jobs in the `testing` environment to keep tests fast and deterministic.\n\n---\n\n### Database\n\nGenerates a database adapter class in `modules/<name>/src/databases/<Name>Database.ts`. Automatically installs `@ooneex/database`:\n\n```bash\noo make:database --name User --module user\n```\n\n**Why:** Direct use of the ORM or raw query builder in services tightly couples business logic to the database layer. A database adapter wraps the connection and query interface, making it straightforward to configure per-module connections, switch drivers, or mock the database in tests.\n\n**Benefits:** Consistent connection configuration per module, single place to add query logging or instrumentation, easier to test services in isolation by injecting a mock adapter.\n\n**Good practices:**\n- Use the database adapter for raw queries or bulk operations that fall outside the repository pattern.\n- Never expose the raw ORM connection object outside the adapter class.\n- Configure connection pool sizes and timeouts in one place inside the adapter.\n- Prefer the repository pattern for standard CRUD; reach for the database adapter only when you need full query control.\n\n---\n\n### Docker\n\nAdds a Docker service to `modules/app/docker-compose.yml`. Creates the file if it does not exist. Available services: `postgres`, `mysql`, `mongodb`, `redis`, `rabbitmq`, `nats`, `elasticsearch`, `clickhouse`, `minio`, `memcached`, `prometheus`, `grafana`, `jaeger`, `keycloak`, `vault`, `temporal`, `libretranslate`, `maildev`:\n\n```bash\noo make:docker\noo make:docker --name postgres\noo make:docker --name redis\n```\n\n**Why:** Manually writing Docker Compose service definitions is repetitive, error-prone, and inconsistent across projects. The generator adds a pre-configured, production-ready service block so local infrastructure matches what the application expects.\n\n**Benefits:** Consistent port mappings and environment variables across the team, generated health-check and volume definitions, no need to memorise image names or versions.\n\n**Good practices:**\n- Commit `docker-compose.yml` to source control so every developer uses identical service versions.\n- Use named volumes for persistent data (databases) and anonymous volumes for ephemeral services (caches).\n- Never use Docker Compose in production \u2014 it is a local development tool only.\n- Pin image versions (e.g. `postgres:16`) rather than using `latest` to keep environments stable.\n- Add service dependencies (`depends_on`) so the application container only starts after its databases are healthy.\n\n---\n\n### Entity\n\nGenerates a TypeORM entity class in `modules/<name>/src/entities/<Name>Entity.ts` and registers it in `SharedModule`. Automatically installs `@ooneex/entity`:\n\n```bash\noo make:entity --name User --module user\noo make:entity --name User --module user --tableName users\n```\n\n**Why:** Entities are the single source of truth for your database schema. Generating them with consistent decorators and base class inheritance ensures that timestamps, soft deletes, and other cross-cutting concerns are applied uniformly across every table.\n\n**Benefits:** Automatic registration in `SharedModule`, consistent column conventions (snake_case table names, `created_at`/`updated_at` timestamps), TypeScript types aligned with the database schema.\n\n**Good practices:**\n- Always specify the table name explicitly to avoid surprises from TypeORM's pluralisation logic.\n- Keep entities as pure data structures \u2014 no business logic, no service calls inside entity methods.\n- Add database indexes to columns used in frequent `WHERE` or `ORDER BY` clauses.\n- Use enums for columns with a fixed set of values to enforce data integrity at the database level.\n- Create a migration immediately after adding or modifying an entity so schema and code stay in sync.\n\n---\n\n### Logger\n\nGenerates a logger class in `modules/<name>/src/loggers/<Name>Logger.ts`. Automatically installs `@ooneex/logger`:\n\n```bash\noo make:logger --name Audit --module user\n```\n\n**Why:** Using a global logger everywhere produces undifferentiated log output that is hard to filter by feature or severity. A dedicated logger class per domain adds a consistent context (module name, logger name) to every log entry, making logs actionable in production.\n\n**Benefits:** Structured log entries with automatic context tags, easy to route specific loggers to different backends (file, Better Stack, etc.), no need to repeat context strings across every log call.\n\n**Good practices:**\n- Use the `Audit` logger for security-sensitive actions (login, permission changes) and the default app logger for operational events.\n- Always log at the correct level: `debug` for internal state, `info` for significant business events, `warn` for recoverable problems, `error` for failures that need attention.\n- Include relevant IDs (user ID, request ID) in every log entry to enable correlation across services.\n- Never log sensitive data such as passwords, tokens, or payment details.\n\n---\n\n### Mailer\n\nGenerates a mailer class (`<Name>Mailer.ts`) and its JSX template (`<Name>MailerTemplate.tsx`) in `modules/<name>/src/mailers/`. Automatically installs `@ooneex/mailer`:\n\n```bash\noo make:mailer --name Welcome --module user\n```\n\n**Why:** Composing email HTML inline or with raw string templates is brittle and hard to preview. The generator creates a typed mailer class paired with a JSX template, keeping email logic and presentation cleanly separated and type-safe.\n\n**Benefits:** JSX template enables component reuse and design-system consistency across emails, typed mailer class prevents missing required variables, easy to test rendering without sending real emails.\n\n**Good practices:**\n- One mailer per transactional email type (e.g. `WelcomeMailer`, `PasswordResetMailer`).\n- Never send emails synchronously on the request path \u2014 enqueue them via a job or pub/sub event.\n- Always provide a plain-text fallback alongside the HTML template for clients that block images.\n- Test email rendering in multiple clients (Gmail, Outlook, Apple Mail) before deploying \u2014 CSS support varies widely.\n- Use the `testing` environment mailer backend to capture sent emails without delivering them.\n\n---\n\n### Middleware\n\nGenerates an HTTP or WebSocket middleware class registered in the target module. Automatically installs `@ooneex/middleware`:\n\n```bash\noo make:middleware --name Auth --module user\noo make:middleware --name Auth --module user --isSocket\n```\n\n**Why:** Cross-cutting concerns like authentication, CORS, request logging, and input sanitisation should not live inside controllers. Middleware classes intercept requests before they reach a controller, keeping that logic reusable and independently testable.\n\n**Benefits:** Reusable across multiple controllers within the module, auto-registered in the middleware pipeline, full access to injected services via DI, works identically for HTTP and WebSocket routes.\n\n**Good practices:**\n- Keep middleware single-purpose (e.g. `AuthMiddleware` only handles authentication, not rate limiting).\n- Always call `next()` explicitly or return a response \u2014 never leave the pipeline hanging.\n- Order matters: authentication middleware must run before authorisation middleware.\n- Avoid heavy computation in middleware; defer expensive work to the service layer.\n- Write unit tests that verify the middleware passes, blocks, and modifies requests as expected.\n\n---\n\n### Permission\n\nGenerates a permission class in `modules/<name>/src/permissions/<Name>Permission.ts`. Automatically installs `@ooneex/permission`:\n\n```bash\noo make:permission --name User --module user\n```\n\n**Why:** Scattering permission checks across controllers and services leads to inconsistency and makes auditing access control difficult. A dedicated permission class per domain centralises all access rules for that domain in one reviewable place.\n\n**Benefits:** All permissions for a domain are discoverable in a single file, easy to audit who can do what, permissions can be reused across multiple controllers without duplication, changes to access rules require touching only one class.\n\n**Good practices:**\n- Name permissions after the action and resource (e.g. `UserPermission` checks `canCreate`, `canUpdate`, `canDelete`).\n- Always check permissions in middleware or the service layer \u2014 never in the entity or repository.\n- Combine with roles (RBAC) for coarse-grained access and permissions for fine-grained control.\n- Write tests that assert both allowed and denied cases for every permission rule.\n- Never hardcode user IDs or emails inside permission logic; use roles and attributes instead.\n\n---\n\n### PubSub\n\nGenerates a pub/sub event class in `modules/<name>/src/events/<Name>Event.ts` and registers it in the module. Automatically installs `@ooneex/pub-sub`:\n\n```bash\noo make:pubsub --name UserCreated --module user\noo make:pubsub --name UserCreated --module user --channel user-created\n```\n\n**Why:** Direct calls between modules create tight coupling that makes the codebase fragile and hard to extend. Pub/sub events decouple the publisher from the subscriber: the `user` module emits `UserCreated` without knowing or caring which other modules react to it.\n\n**Benefits:** Loose coupling between modules, multiple subscribers can react to the same event independently, easy to add new reactions without modifying the publisher, events are named and typed so their contracts are explicit.\n\n**Good practices:**\n- Name events in the past tense (e.g. `UserCreated`, `OrderShipped`) to make clear they describe something that already happened.\n- Keep event payloads small and serialisable \u2014 include IDs rather than full entity objects where possible.\n- Subscribe in the module that owns the reaction, not in the module that owns the event.\n- Make event handlers idempotent: the same event may be delivered more than once in failure scenarios.\n- Log every event published and consumed to simplify debugging distributed flows.\n\n---\n\n### Repository\n\nGenerates a repository class for data access in `modules/<name>/src/repositories/<Name>Repository.ts`. Automatically installs `@ooneex/repository`:\n\n```bash\noo make:repository --name User --module user\n```\n\n**Why:** Putting database queries directly in services mixes business logic with persistence concerns and makes services impossible to test without a database. The repository pattern isolates all data-access code behind a typed interface that can be mocked in tests.\n\n**Benefits:** Services remain database-agnostic, all queries for an entity are discoverable in one class, easy to swap the underlying ORM or database without touching business logic, clean boundary for unit testing.\n\n**Good practices:**\n- One repository per entity (e.g. `UserRepository` owns all queries against the `users` table).\n- Repositories should only contain query logic \u2014 no business rules, no validation, no event publishing.\n- Use descriptive method names that reflect intent (e.g. `findActiveByEmail`, `findExpiredTokens`) rather than generic `find` with complex filter objects.\n- Return domain objects or plain data \u2014 never expose raw ORM query builders to callers.\n- Add pagination to any method that can return an unbounded number of rows.\n\n---\n\n### Service\n\nGenerates a service class in `modules/<name>/src/services/<Name>Service.ts`. Automatically installs `@ooneex/service`:\n\n```bash\noo make:service --name User --module user\n```\n\n**Why:** Business logic scattered across controllers is impossible to test, reuse, or reason about. Services are the home of all business rules, orchestrating repositories, events, and other services in a single, testable unit.\n\n**Benefits:** Business logic is testable without HTTP, reusable across multiple controllers or cron jobs, dependencies are explicit via constructor injection, easy to mock at the service boundary in integration tests.\n\n**Good practices:**\n- One service per aggregate or major business capability (e.g. `UserService` for user lifecycle, `BillingService` for payment flows).\n- Services should call repositories for data, never query the database directly.\n- Keep services stateless \u2014 all required data should come from method arguments or injected dependencies.\n- Raise typed exceptions (e.g. `UserNotFoundException`) rather than returning `null` or error codes.\n- A service method should do one thing; if a method grows beyond ~20 lines, consider extracting a helper or sub-service.\n\n---\n\n### Storage\n\nGenerates a file storage class in `modules/<name>/src/storage/<Name>Storage.ts`. Automatically installs `@ooneex/storage`:\n\n```bash\noo make:storage --name Avatar --module user\n```\n\n**Why:** Coupling file upload logic directly to a specific provider (S3, Cloudflare R2, local filesystem) makes it painful to change backends and duplicates configuration across the codebase. A storage class abstracts the provider behind a consistent interface scoped to a specific asset type.\n\n**Benefits:** Provider-agnostic uploads and reads, all storage configuration for an asset type in one class, easy to switch between local filesystem (development) and cloud storage (production) via environment variables, consistent file-naming and path conventions.\n\n**Good practices:**\n- Name storage classes after the asset they manage (e.g. `AvatarStorage`, `InvoiceStorage`).\n- Always validate file type and size before passing to the storage class \u2014 never trust client-supplied content types.\n- Generate deterministic, collision-resistant file names (e.g. `{userId}/{uuid}.{ext}`) rather than using the original filename.\n- Never store the full URL in the database \u2014 store only the path or key and derive the URL at read time so it works across environments.\n- Delete orphaned files when the associated entity is deleted to avoid unbounded storage growth.\n\n---\n\n### Vector Database\n\nGenerates a vector database class in `modules/<name>/src/databases/<Name>VectorDatabase.ts`. Automatically installs `@ooneex/rag`:\n\n```bash\noo make:vector-database --name Knowledge --module user\n```\n\n**Why:** Semantic search and Retrieval-Augmented Generation (RAG) require storing and querying high-dimensional embeddings, which relational databases are not designed for. A dedicated vector database class encapsulates the embedding model, index configuration, and similarity-search logic in one place.\n\n**Benefits:** Centralised embedding and retrieval strategy per knowledge domain, easy to swap vector backends (pgvector, Qdrant, etc.), consistent chunking and metadata conventions, decoupled from the LLM layer so both can evolve independently.\n\n**Good practices:**\n- One vector database class per knowledge domain (e.g. `KnowledgeVectorDatabase`, `ProductCatalogVectorDatabase`).\n- Always store the source document ID alongside each embedding so retrieved chunks can be traced back to their origin.\n- Use a consistent chunking strategy (fixed-size or sentence-boundary) within a class \u2014 mixing strategies pollutes the index.\n- Re-index when the embedding model changes; embeddings from different models are not comparable.\n- Cache frequently retrieved embeddings to avoid redundant model calls on hot queries.\n\n---\n\n## Claude\n\nThis project ships with a set of **Claude Code skills** \u2014 pre-built instruction sets that tell Claude exactly how to scaffold, implement, and test each type of artefact in this codebase. Skills eliminate the gap between \"generate the files\" and \"ship working code\": each skill runs the CLI generator, reads the output, completes the implementation, writes tests, and lints \u2014 all in one `/command`.\n\n### Why Skills?\n\nRunning `oo make:service` creates a skeleton. A Claude skill does that *and* completes the business logic, writes a meaningful test suite, applies coding conventions, and formats the result \u2014 turning a 10-step workflow into a single prompt.\n\n**Benefits:**\n- Consistent code quality across every artefact, regardless of who wrote it\n- Conventions (visibility modifiers, naming suffixes, DI patterns) are enforced automatically\n- Tests are generated alongside implementation, not as an afterthought\n- Skills chain together \u2014 `make:controller` automatically triggers `make:service` and `make:pubsub`\n\n### Setup\n\nBefore using skills, generate the `.claude/` directory with all skill files and the project `CLAUDE.md`:\n\n```bash\noo claude:skill:create\n```\n\nThis writes `.claude/CLAUDE.md` and one `SKILL.md` per skill under `.claude/skills/<skill-name>/`. Re-run any time you upgrade the CLI to pick up new or updated skills. Commit the generated files so every team member gets the same skill definitions without running the command themselves.\n\n### How to Use\n\nOpen Claude Code in the project root and type `/skill-name`. Claude will execute the full workflow described in the skill. You can pass arguments inline:\n\n```\n/make:service --name=UserCreate --module=user\n/make:controller --name=UserCreate --module=user --route.path=/users --route.method=POST\n/commit\n```\n\nIf you omit arguments, Claude will prompt you for the required values.\n\n> **Important:** Always run skills from the project root, not from inside a module directory.\n\n### Available Skills\n\n#### Code Quality\n\n| Skill | Description |\n|---|---|\n| `/optimize` | Enforce naming conventions, remove duplication, improve performance, and restructure tests across a module |\n| `/commit` | Analyze staged changes, group them by module, and create properly scoped conventional commits |\n\n#### Generators\n\n| Skill | Description |\n|---|---|\n| `/make:ai` | Generate an AI integration class with `run` and `runStream` methods, wired to `@ooneex/ai` |\n| `/make:analytics` | Generate an analytics handler class for tracking domain events via `@ooneex/analytics` |\n| `/make:cache` | Generate a cache handler class with key and TTL management via `@ooneex/cache` |\n| `/make:command` | Generate a CLI command class implementing `ICommand` via `@ooneex/cli` |\n| `/make:controller` | Generate an HTTP or WebSocket controller with route type, validation, roles, service, and pub/sub event |\n| `/make:cron` | Generate a cron job class registered in its module via `@ooneex/cron` |\n| `/make:database` | Generate a database adapter class for raw queries via `@ooneex/database` |\n| `/make:entity` | Generate a TypeORM entity class registered in `SharedModule` via `@ooneex/entity` |\n| `/make:logger` | Generate a structured logger class with domain context via `@ooneex/logger` |\n| `/make:mailer` | Generate a mailer class and its JSX email template via `@ooneex/mailer` |\n| `/make:middleware` | Generate an HTTP or WebSocket middleware class registered in the module via `@ooneex/middleware` |\n| `/make:permission` | Generate a permission class centralising access rules for a domain via `@ooneex/permission` |\n| `/make:pubsub` | Generate a pub/sub event class registered in the module via `@ooneex/pub-sub` |\n| `/make:repository` | Generate a repository class for typed data access via `@ooneex/repository` |\n| `/make:service` | Generate a service class implementing `IService` with business logic and tests |\n| `/make:storage` | Generate a file storage class for asset management via `@ooneex/storage` |\n| `/make:vector-database` | Generate a vector database class for semantic search and RAG via `@ooneex/rag` |\n\n#### Database\n\n| Skill | Description |\n|---|---|\n| `/migration:create` | Generate a migration file with `up`/`down` methods, index guidance, and structural tests |\n| `/seed:create` | Generate a seed class and its YAML data file with idempotent insertion logic |\n\n### Coding Conventions Enforced by Skills\n\nAll generator skills automatically apply the conventions defined in `/optimize`:\n\n- **Visibility modifiers** \u2014 every class method and property has explicit `public`, `private`, or `protected`\n- **Naming suffixes** \u2014 types end with `Type`, interfaces start with `I`\n- **Arrow functions** \u2014 used everywhere except class methods\n- **No non-null assertions** \u2014 use default values or optional types instead\n- **Dependency injection** \u2014 constructor injection via `@inject()` from `@ooneex/container`\n- **Code hygiene** \u2014 no unused imports, no dead code, no bare `TODO` comments\n\n---\n\n## Release\n\n```bash\noo make:release\n```\n\nScans every `packages/` and `modules/` directory for unreleased conventional commits and, for each one that has them, performs a full release cycle automatically:\n\n1. **Detects unreleased work** \u2014 finds the last git tag matching `<package-name>@*` and lists all conventional commits that have landed since then in that directory. Packages with no new commits are skipped.\n2. **Bumps the version** in `package.json`:\n   - `minor` (e.g. `1.2.0 \u2192 1.3.0`) when any commit is of type `feat`\n   - `patch` (e.g. `1.2.0 \u2192 1.2.1`) for all other types (`fix`, `refactor`, `perf`, `docs`, `chore`, \u2026)\n3. **Updates `CHANGELOG.md`** with a dated version section. Commits are grouped into standard Keep-a-Changelog categories and linked to their SHA on the remote:\n\n   | Commit type | Changelog category |\n   |---|---|\n   | `feat` | Added |\n   | `fix` | Fixed |\n   | `refactor`, `perf`, `style`, `docs`, `build`, `ci`, `chore` | Changed |\n   | `revert` | Removed |\n\n4. **Creates a release commit** \u2014 stages `package.json` and `CHANGELOG.md` then commits with the message `chore(release): <name>@<version>`.\n5. **Creates an annotated git tag** \u2014 `<name>@<version>` (e.g. `@acme/user@1.3.0`).\n6. **Prompts to push** \u2014 after all packages are processed, asks whether to push commits and tags to the remote. If confirmed, it also runs `bun install`, commits the updated `bun.lock`, and pushes everything.\n\n> **Note:** This command requires conventional commits (`type(scope): Subject`). Non-conventional commits are silently ignored when building the changelog.\n\n---\n\n## Scripts\n\n| Command | Description |\n|---|---|\n| `bun run fmt` | Format all source files with Biome |\n| `bun run lint` | Lint all modules with Biome and TypeScript |\n| `bun run test` | Run tests across all modules |\n| `bun run commit` | Interactive conventional commit prompt |\n";
 
@@ -10761,6 +10762,10 @@ chore(common): Update bun.lock dependencies
 
 Use the \`/commit\` skill to automate this workflow.
 
+### Commit Trailers
+
+Do not add any \`Co-Authored-By\` trailer to commits.
+
 ## Naming Conventions
 
 **Strictly enforced** by DI decorators \u2014 violations throw at startup:
@@ -10871,6 +10876,10 @@ git commit -m "chore(common): Update dependencies and cache package"
 - **Deleted files only**: use \`refactor\` (e.g., \`refactor(user): Remove deprecated UserAdapter\`)
 - **Renamed/moved files**: use \`refactor\` (e.g., \`refactor(product): Reorganize service file structure\`)
 
+## Commit Trailers
+
+Do not add any \`Co-Authored-By\` trailer to commits.
+
 ## Coding Conventions
 
 Apply all coding conventions from the \`optimize\` skill.
@@ -10988,7 +10997,7 @@ Only if \`resources.repository\` is present.
 /make:repository --name=<resources.repository> --module=<module>
 \`\`\`
 
-Retain only the CRUD methods that are needed by this issue (e.g. \`.create\` needs \`save\`; \`.read\` needs \`findById\`; \`.list\` needs \`find\`; \`.delete\` needs \`delete\`).
+Retain only the CRUD methods that are needed by this issue (e.g. \`.create\` needs \`save\`; \`.read\` needs \`findById\`; \`.list\` needs \`find\`; \`.delete\` needs \`delete\`). For each repository, remove any methods that are not called by a service or other consumer \u2014 do not keep unused methods.
 
 ### 6. Create or update the service
 
@@ -13620,6 +13629,8 @@ Read \`modules/<module>/src/storage/<Name>Storage.ts\`, then implement:
 
 \`\`\`typescript
 import { Storage, decorator, StorageException } from "@ooneex/storage";
+import { inject } from "@ooneex/container";
+import { AppEnv } from "@ooneex/app-env";
 import type { S3Options } from "bun";
 
 @decorator.storage()
@@ -13630,24 +13641,27 @@ export class <Name>Storage extends Storage {
   private readonly endpoint: string;
   private readonly region: string;
 
-  constructor(options?: {
-    accessKey?: string;
-    secretKey?: string;
-    endpoint?: string;
-    region?: string;
-  }) {
+  public constructor(
+    @inject(AppEnv) private readonly env: AppEnv,
+    options?: {
+      accessKey?: string;
+      secretKey?: string;
+      endpoint?: string;
+      region?: string;
+    },
+  ) {
     super();
 
-    const accessKey = options?.accessKey || Bun.env.STORAGE_<NAME_UPPER>_ACCESS_KEY;
-    const secretKey = options?.secretKey || Bun.env.STORAGE_<NAME_UPPER>_SECRET_KEY;
-    const endpoint = options?.endpoint || Bun.env.STORAGE_<NAME_UPPER>_ENDPOINT;
+    const accessKey = options?.accessKey || this.env.STORAGE_<NAME_UPPER>_ACCESS_KEY;
+    const secretKey = options?.secretKey || this.env.STORAGE_<NAME_UPPER>_SECRET_KEY;
+    const endpoint = options?.endpoint || this.env.STORAGE_<NAME_UPPER>_ENDPOINT;
 
     // ... validation throws StorageException if missing ...
 
     this.accessKey = accessKey;
     this.secretKey = secretKey;
     this.endpoint = endpoint;
-    this.region = options?.region || Bun.env.STORAGE_<NAME_UPPER>_REGION || "auto";
+    this.region = options?.region || this.env.STORAGE_<NAME_UPPER>_REGION || "auto";
   }
 
   public getOptions(): S3Options {
@@ -14401,13 +14415,12 @@ class ClaudeSkillCreateCommand {
   }
   async run() {
     const claudeLocalDir = ".claude";
-    const claudeDir = join4(process.cwd(), claudeLocalDir);
     const skillsLocalDir = join4(claudeLocalDir, "skills");
     const skillsDir = join4(process.cwd(), skillsLocalDir);
     const logger = new TerminalLogger3;
-    const claudeMdPath = join4(claudeDir, "CLAUDE.md");
+    const claudeMdPath = join4(process.cwd(), "CLAUDE.md");
     await Bun.write(claudeMdPath, CLAUDE_md_default);
-    logger.success(`${join4(claudeLocalDir, "CLAUDE.md")} created successfully`, undefined, {
+    logger.success("CLAUDE.md created successfully", undefined, {
       showTimestamp: false,
       showArrow: false,
       useSymbol: true
@@ -14560,6 +14573,8 @@ class AppCreateCommand {
     const dockerfileContent = Dockerfile_default.replace(/{{NAME}}/g, snakeName);
     await Bun.write(join6(destination, "modules", "app", "Dockerfile"), dockerfileContent);
     await Bun.write(join6(destination, "modules", "app", "var", ".gitkeep"), "");
+    const appInitCommand = new AppInitCommand;
+    await appInitCommand.run({ name, destination, silent: true, appType: "api" });
     const addDeps = Bun.spawn([
       "bun",
       "add",
@@ -14590,7 +14605,7 @@ class AppCreateCommand {
       "react-dom",
       "apache-arrow",
       "reflect-metadata",
-      "typeorm"
+      "typeorm@^1.0.0"
     ], { cwd: destination, stdout: "ignore", stderr: "inherit" });
     await addDeps.exited;
     const addDevDeps = Bun.spawn(["bun", "add", "-D", "@ooneex/command", "@ooneex/migrations", "@ooneex/seeds"], {
@@ -14599,8 +14614,14 @@ class AppCreateCommand {
       stderr: "inherit"
     });
     await addDevDeps.exited;
-    const appInitCommand = new AppInitCommand;
-    await appInitCommand.run({ name, destination, silent: true, appType: "api" });
+    const rootPackagePath = join6(destination, "package.json");
+    const rootPackage = await Bun.file(rootPackagePath).json();
+    const templatePackage = JSON.parse(package_json_default.replace(/{{NAME}}/g, kebabName));
+    rootPackage.scripts ??= templatePackage.scripts;
+    rootPackage.workspaces ??= templatePackage.workspaces;
+    rootPackage["lint-staged"] ??= templatePackage["lint-staged"];
+    await Bun.write(rootPackagePath, `${JSON.stringify(rootPackage, null, 2)}
+`);
     const logger = new TerminalLogger5;
     logger.success(`${kebabName} created successfully at ${destination}`, undefined, {
       showTimestamp: false,
@@ -14872,7 +14893,7 @@ class CommandRunCommand {
       const proc = Bun.spawn(["bun", "run", commandRunPath, commandName, ...extraArgs], {
         cwd: process.cwd(),
         stdout: "inherit",
-        stderr: "inherit"
+        stderr: "pipe"
       });
       const exitCode = await proc.exited;
       if (exitCode === 0) {
@@ -14883,7 +14904,9 @@ class CommandRunCommand {
         });
         return;
       }
-      logger.warn(`Command "${commandName}" not found in ${name}`, undefined, {
+      const errorOutput = await new Response(proc.stderr).text();
+      const trimmed = errorOutput.trim();
+      logger.warn(`Command "${commandName}" not found in ${name}`, trimmed ? { message: trimmed } : undefined, {
         showTimestamp: false,
         showArrow: false,
         useSymbol: false
@@ -96567,41 +96590,51 @@ import { decorator as decorator20 } from "@ooneex/command";
 import { TerminalLogger as TerminalLogger19 } from "@ooneex/logger";
 import { toPascalCase as toPascalCase7 } from "@ooneex/utils";
 
-// src/templates/database.test.txt
-var database_test_default = `import { describe, expect, test } from "bun:test";
-import { {{NAME}}Database } from "@module/{{MODULE}}/databases/{{NAME}}Database";
-
-describe("{{NAME}}Database", () => {
-  test("should have class name ending with 'Database'", () => {
-    expect({{NAME}}Database.name.endsWith("Database")).toBe(true);
-  });
-
-  test("should have 'getSource' method", () => {
-    expect({{NAME}}Database.prototype.getSource).toBeDefined();
-    expect(typeof {{NAME}}Database.prototype.getSource).toBe("function");
+// src/prompts/askDatabaseType.ts
+var import_enquirer11 = __toESM(require_enquirer(), 1);
+var askDatabaseType = async (config) => {
+  const response = await import_enquirer11.prompt({
+    type: "select",
+    name: "type",
+    message: config.message,
+    choices: ["postgres", "sqlite"]
   });
-});
-`;
+  return response.type;
+};
 
-// src/templates/database.txt
-var database_default = `import { DataSource } from "typeorm";
+// src/templates/database.pg.txt
+var database_pg_default = `import { DataSource } from "typeorm";
 import { TypeormDatabase, DatabaseException, decorator } from "@ooneex/database";
+import { inject } from "@ooneex/container";
+import { AppEnv } from "@ooneex/app-env";
 
 @decorator.database()
 export class {{NAME}}Database extends TypeormDatabase {
-  public getSource(database?: string): DataSource {
-    database = database || "var/db";
+  public constructor(@inject(AppEnv) private readonly env: AppEnv) {
+    super();
+  }
+
+  public getSource(_database?: string): DataSource {
+    const url = this.env.DATABASE_URL ?? "";
+
+    if (!url) {
+      throw new DatabaseException(
+        "Database URL is required. Please provide a URL either through the constructor options or set the DATABASE_URL environment variable.",
+        "CONNECTION_FAILED",
+      );
+    }
 
     this.source = new DataSource({
       synchronize: false,
       entities: [
         // TODO: Load your entities here
       ],
-      enableWAL: true,
-      busyErrorRetry: 2000,
-      busyTimeout: 30_000,
-      database,
-      type: "sqlite",
+      extra: {
+        max: 10,
+        // idleTimeoutMillis: 30000,
+      },
+      url,
+      type: "postgres",
     });
 
     return this.source;
@@ -96609,6 +96642,62 @@ export class {{NAME}}Database extends TypeormDatabase {
 }
 `;
 
+// src/templates/database.sqlite.txt
+var database_sqlite_default = `import { DataSource } from "typeorm";
+import { TypeormDatabase, DatabaseException, decorator } from "@ooneex/database";
+import { inject } from "@ooneex/container";
+import { AppEnv } from "@ooneex/app-env";
+
+@decorator.database()
+export class {{NAME}}Database extends TypeormDatabase {
+  public constructor(@inject(AppEnv) private readonly env: AppEnv) {
+    super();
+  }
+
+  public getSource(database?: string): DataSource {
+    database = database || this.env.SQLITE_DATABASE_PATH || "var/db";
+
+    if (!database) {
+      throw new DatabaseException(
+        "SQLite database path is required. Please provide a database path either through the constructor options or set the SQLITE_DATABASE_PATH environment variable.",
+        "CONNECTION_FAILED",
+      );
+    }
+
+    if (!this.source) {
+      this.source = new DataSource({
+        synchronize: false,
+        entities: [
+          // TODO: Load your entities here
+        ],
+        enableWAL: true,
+        timeout: 30_000,
+        database,
+        type: "better-sqlite3",
+      });
+    }
+
+    return this.source;
+  }
+}
+`;
+
+// src/templates/database.test.txt
+var database_test_default = `import { describe, expect, test } from "bun:test";
+import { {{NAME}}Database } from "@module/{{MODULE}}/databases/{{NAME}}Database";
+
+describe("{{NAME}}Database", () => {
+  test("should have class name ending with 'Database'", () => {
+    expect({{NAME}}Database.name.endsWith("Database")).toBe(true);
+  });
+
+  test("should have 'getSource' method", () => {
+    expect({{NAME}}Database.prototype.getSource).toBeDefined();
+    expect(typeof {{NAME}}Database.prototype.getSource).toBe("function");
+  });
+});
+`;
+
 // src/commands/MakeDatabaseCommand.ts
 class MakeDatabaseCommand {
   getName() {
@@ -96623,7 +96712,9 @@ class MakeDatabaseCommand {
       name = await askName({ message: "Enter database name" });
     }
     name = toPascalCase7(name).replace(/DatabaseAdapter$/, "").replace(/Database$/, "");
-    const content = database_default.replace(/{{NAME}}/g, name);
+    const dbType = await askDatabaseType({ message: "Select database type" });
+    const template = dbType === "postgres" ? database_pg_default : database_sqlite_default;
+    const content = template.replace(/{{NAME}}/g, name);
     await ensureModule(module);
     const base = join20("modules", module);
     const databaseLocalDir = join20(base, "src", "databases");
@@ -96670,7 +96761,7 @@ import { TerminalLogger as TerminalLogger20 } from "@ooneex/logger";
 var {YAML } = globalThis.Bun;
 
 // src/prompts/askDockerService.ts
-var import_enquirer11 = __toESM(require_enquirer(), 1);
+var import_enquirer12 = __toESM(require_enquirer(), 1);
 var DOCKER_SERVICES = [
   "clickhouse",
   "elasticsearch",
@@ -96692,7 +96783,7 @@ var DOCKER_SERVICES = [
   "vault"
 ];
 var askDockerService = async (config) => {
-  const response = await import_enquirer11.prompt({
+  const response = await import_enquirer12.prompt({
     type: "autocomplete",
     name: "service",
     message: config.message,
@@ -98676,759 +98767,10 @@ class MakeRepositoryCommand {
 MakeRepositoryCommand = __legacyDecorateClassTS([
   decorator29.command()
 ], MakeRepositoryCommand);
-// src/commands/MakeResourceBookCommand.ts
-import { join as join32 } from "path";
-import { decorator as decorator32 } from "@ooneex/command";
-var {Glob } = globalThis.Bun;
-
-// src/templates/resources/book/BookEntity.txt
-var BookEntity_default = `import type { LocaleType } from "@ooneex/translation";
-import { random } from "@ooneex/utils";
-import {
-  Column,
-  CreateDateColumn,
-  Entity,
-  PrimaryColumn,
-  UpdateDateColumn,
-} from "typeorm";
-
-@Entity({
-  name: "books",
-})
-export class BookEntity {
-  @PrimaryColumn({ name: "id", type: "varchar", length: 25, nullable: false })
-  id: string = random.id();
-
-  @Column({ name: "title", type: "varchar", length: 255, nullable: false })
-  title: string;
-
-  @Column({ name: "color", type: "varchar", length: 50, nullable: true })
-  color?: string | null;
-
-  @Column({ name: "description", type: "text", nullable: true })
-  description?: string | null;
-
-  @Column({ name: "summarize", type: "text", nullable: true })
-  summarize?: string | null;
-
-  @Column({ name: "page_count", type: "int", nullable: true })
-  pageCount?: number | null;
-
-  @Column({ name: "src", type: "varchar", length: 255, nullable: false })
-  src: string;
-
-  @Column({ name: "cover_image", type: "varchar", length: 255, nullable: true })
-  coverImage?: string | null;
-
-  @Column({ name: "tags", type: "text", array: true, nullable: true })
-  tags?: string[] | null;
-
-  @Column({ name: "topics", type: "text", array: true, nullable: true })
-  topics?: string[] | null;
-
-  @Column({ name: "categories", type: "text", array: true, nullable: true })
-  categories?: string[] | null;
-
-  @Column({ name: "lang", type: "varchar", length: 10, nullable: true })
-  lang?: LocaleType | null;
-
-  @Column({ name: "status", type: "varchar", length: 50, nullable: true })
-  status?: string | null;
-
-  @CreateDateColumn({ name: "created_at", nullable: true })
-  createdAt?: Date | null;
-
-  @UpdateDateColumn({ name: "updated_at", nullable: true })
-  updatedAt?: Date | null;
-}
-`;
-
-// src/templates/resources/book/BookMigration.txt
-var BookMigration_default = `import { decorator, type IMigration, type MigrationClassType } from '@ooneex/migrations';
-import type { TransactionSQL } from 'bun';
-
-@decorator.migration()
-export class {{ name }} implements IMigration {
-  public async up(tx: TransactionSQL): Promise<void> {
-    await tx\`
-      CREATE TABLE IF NOT EXISTS books (
-        id VARCHAR(25) PRIMARY KEY,
-        title VARCHAR(255) NOT NULL,
-        color VARCHAR(50),
-        description TEXT,
-        summarize TEXT,
-        page_count INT,
-        src VARCHAR(255) NOT NULL,
-        cover_image VARCHAR(255),
-        tags TEXT[],
-        topics TEXT[],
-        categories TEXT[],
-        lang VARCHAR(10),
-        status VARCHAR(50),
-        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-        updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
-      )
-    \`;
-
-    await tx\`
-      CREATE INDEX IF NOT EXISTS idx_books_title ON books (title)
-    \`;
-  }
-
-  public async down(tx: TransactionSQL): Promise<void> {
-    await tx\`DROP TABLE IF EXISTS books\`;
-  }
-
-  public getVersion(): string {
-    return '{{ version }}';
-  }
-
-  public getDependencies(): MigrationClassType[] {
-    return [];
-  }
-}
-`;
-
-// src/templates/resources/book/BookRepository.txt
-var BookRepository_default = `import { inject } from "@ooneex/container";
-import type { ITypeormDatabase } from "@ooneex/database";
-import { decorator } from "@ooneex/repository";
-import type { FilterResultType } from "@ooneex/types";
-import type { FindManyOptions, FindOptionsWhere, Repository, SaveOptions, UpdateResult } from "typeorm";
-import { ILike } from "typeorm";
-import { BookEntity } from "../entities/BookEntity";
-
-@decorator.repository()
-export class BookRepository {
-  constructor(
-    @inject("database")
-    private readonly database: ITypeormDatabase,
-  ) {}
-
-  public async open(): Promise<Repository<BookEntity>> {
-    return await this.database.open(BookEntity);
-  }
-
-  public async close(): Promise<void> {
-    await this.database.close();
-  }
-
-  public async find(
-    criteria: FindManyOptions<BookEntity> & { page?: number; limit?: number; order?: "ASC" | "DESC"; orderBy?: string; q?: string },
-  ): Promise<FilterResultType<BookEntity>> {
-    const repository = await this.open();
-
-    const { page = 1, limit = 100, order, orderBy, q, ...rest } = criteria;
-
-    let skip: number | undefined;
-    const take = limit === 0 ? 100 : limit;
-
-    if (page && page > 0 && limit && limit > 0) {
-      skip = (page - 1) * take;
-    }
-
-    let findOptions = {
-      ...rest,
-      take,
-      ...(skip !== undefined && { skip }),
-      ...(orderBy && { order: { [orderBy]: order ?? "ASC" } }),
-    };
-    if (q) {
-      findOptions = {
-        ...findOptions,
-        where: {
-          ...rest.where,
-          title: ILike(\`%\${q}%\`),
-        },
-      };
-    }
-
-    const result = await repository.find(findOptions);
-
-    let countWhere = rest.where;
-    if (q) {
-      countWhere = {
-        ...rest.where,
-        title: ILike(\`%\${q}%\`),
-      };
-    }
-
-    const total = await this.count(countWhere);
-    const totalPages = Math.ceil(total / limit);
-
-    return {
-      resources: result,
-      total,
-      totalPages,
-      page,
-      limit,
-    };
-  }
-
-  public async findOne(id: string): Promise<BookEntity | null> {
-    const repository = await this.open();
-
-    return await repository.findOne({
-      where: { id },
-    });
-  }
-
-  public async findOneBy(criteria: FindOptionsWhere<BookEntity>): Promise<BookEntity | null> {
-    const repository = await this.open();
-
-    return await repository.findOne({
-      where: criteria,
-    });
-  }
-
-  public async create(entity: BookEntity, options?: SaveOptions): Promise<BookEntity> {
-    const repository = await this.open();
-
-    return await repository.save(entity, options);
-  }
-
-  public async createMany(entities: BookEntity[], options?: SaveOptions): Promise<BookEntity[]> {
-    const repository = await this.open();
-
-    return await repository.save(entities, options);
-  }
-
-  public async update(entity: Partial<BookEntity> & { id: string }): Promise<UpdateResult> {
-    const repository = await this.open();
-
-    return await repository.update(entity.id, entity);
-  }
-
-  public async updateMany(entities: (Partial<BookEntity> & { id: string })[]): Promise<UpdateResult[]> {
-    const repository = await this.open();
-
-    return await Promise.all(entities.map((entity) => repository.update(entity.id, entity)));
-  }
-
-  public async delete(
-    criteria: FindOptionsWhere<BookEntity> | FindOptionsWhere<BookEntity>[],
-  ): Promise<UpdateResult> {
-    const repository = await this.open();
-
-    return await repository.softDelete(criteria);
-  }
-
-  public async count(criteria?: FindOptionsWhere<BookEntity> | FindOptionsWhere<BookEntity>[]): Promise<number> {
-    const repository = await this.open();
-
-    return await repository.count(criteria ? { where: criteria } : {});
-  }
-}
-`;
-
-// src/templates/resources/book/controllers/CreateBookController.txt
-var CreateBookController_default = `import type { ContextType } from "@ooneex/controller";
-import { inject } from "@ooneex/container";
-import { ERole } from "@ooneex/role";
-import { Route } from "@ooneex/routing";
-import type { LocaleType } from "@ooneex/translation";
-import { Assert } from "@ooneex/validation";
-import type { BookEntity } from "../entities/BookEntity";
-import { CreateBookService } from "../services/CreateBookService";
-
-type CreateBookRouteType = {
-  payload: {
-    title: string;
-    color?: string;
-    description?: string;
-    summarize?: string;
-    pageCount?: number;
-    src: string;
-    coverImage?: string;
-    tags?: string[];
-    topics?: string[];
-    categories?: string[];
-    lang?: LocaleType;
-    status?: string;
-  };
-  response: BookEntity | Record<string, never>;
-};
-
-@Route.post("/books", {
-  name: "book.create",
-  version: 1,
-  description: "Create a new book",
-  payload: Assert({
-    title: "string",
-    color: "string?",
-    description: "string?",
-    summarize: "string?",
-    pageCount: "number?",
-    src: "string",
-    coverImage: "string?",
-    tags: "string[]?",
-    topics: "string[]?",
-    categories: "string[]?",
-    lang: "string?",
-    status: "string?",
-  }),
-  response: Assert({
-    id: "string",
-    title: "string",
-    color: "string?",
-    description: "string?",
-    summarize: "string?",
-    pageCount: "number?",
-    src: "string",
-    coverImage: "string?",
-    tags: "string[]?",
-    topics: "string[]?",
-    categories: "string[]?",
-    lang: "string?",
-    status: "string?",
-  }),
-  roles: ["ROLE_USER"],
-})
-export class CreateBookController {
-  constructor(
-    @inject(CreateBookService) private readonly service: CreateBookService,
-  ) {}
-
-  public async index(context: ContextType<CreateBookRouteType>) {
-    const { title, color, description, summarize, pageCount, src, coverImage, tags, topics, categories, lang, status } = context.payload;
-
-    const book = await this.service.execute({ title, color, description, summarize, pageCount, src, coverImage, tags, topics, categories, lang, status });
-
-    return context.response.json(book || {});
-  }
-}
-`;
-
-// src/templates/resources/book/controllers/DeleteBookController.txt
-var DeleteBookController_default = `import type { ContextType } from "@ooneex/controller";
-import { inject } from "@ooneex/container";
-import { ERole } from "@ooneex/role";
-import { Route } from "@ooneex/routing";
-import { Assert } from "@ooneex/validation";
-import { DeleteBookService } from "../services/DeleteBookService";
-
-type DeleteBookRouteType = {
-  params: { id: string };
-  response: { id: string };
-};
-
-@Route.delete("/books/:id", {
-  name: "book.delete",
-  version: 1,
-  description: "Delete a book",
-  params: {
-    id: Assert("string"),
-  },
-  response: Assert({
-    id: "string",
-  }),
-  roles: ["ROLE_USER"],
-})
-export class DeleteBookController {
-  constructor(
-    @inject(DeleteBookService) private readonly service: DeleteBookService,
-  ) {}
-
-  public async index(context: ContextType<DeleteBookRouteType>) {
-    const { id } = context.params;
-
-    await this.service.execute({ id });
-
-    return context.response.json({ id });
-  }
-}
-`;
-
-// src/templates/resources/book/controllers/GetBookController.txt
-var GetBookController_default = `import type { ContextType } from "@ooneex/controller";
-import { inject } from "@ooneex/container";
-import { ERole } from "@ooneex/role";
-import { Route } from "@ooneex/routing";
-import { Assert } from "@ooneex/validation";
-import type { BookEntity } from "../entities/BookEntity";
-import { GetBookService } from "../services/GetBookService";
-
-type GetBookRouteType = {
-  params: { id: string };
-  response: BookEntity | Record<string, never>;
-};
-
-@Route.get("/books/:id", {
-  name: "book.get",
-  version: 1,
-  description: "Get a book by id",
-  params: {
-    id: Assert("string"),
-  },
-  roles: ["ROLE_USER"],
-})
-export class GetBookController {
-  constructor(
-    @inject(GetBookService) private readonly service: GetBookService,
-  ) {}
-
-  public async index(context: ContextType<GetBookRouteType>) {
-    const { id } = context.params;
-
-    const book = await this.service.execute({ id });
-
-    return context.response.json(book || {});
-  }
-}
-`;
-
-// src/templates/resources/book/controllers/ListBooksController.txt
-var ListBooksController_default = `import type { ContextType } from "@ooneex/controller";
-import { inject } from "@ooneex/container";
-import { ERole } from "@ooneex/role";
-import { Route } from "@ooneex/routing";
-import type { FilterResultType } from "@ooneex/types";
-import { Assert } from "@ooneex/validation";
-import type { BookEntity } from "../entities/BookEntity";
-import { ListBooksService } from "../services/ListBooksService";
-
-type ListBooksRouteType = {
-  queries: { page?: number; limit?: number; q?: string };
-  response: FilterResultType<BookEntity>;
-};
-
-@Route.get("/books", {
-  name: "book.list",
-  version: 1,
-  description: "List all books",
-  queries: Assert({
-    page: "number?",
-    limit: "number?",
-    q: "string?",
-  }),
-  roles: ["ROLE_USER"],
-})
-export class ListBooksController {
-  constructor(
-    @inject(ListBooksService) private readonly service: ListBooksService,
-  ) {}
-
-  public async index(context: ContextType<ListBooksRouteType>) {
-    const { page, limit, q } = context.queries;
-
-    const result = await this.service.execute({ page, limit, q });
-
-    return context.response.json(result);
-  }
-}
-`;
-
-// src/templates/resources/book/controllers/UpdateBookController.txt
-var UpdateBookController_default = `import type { ContextType } from "@ooneex/controller";
-import { inject } from "@ooneex/container";
-import { ERole } from "@ooneex/role";
-import { Route } from "@ooneex/routing";
-import type { LocaleType } from "@ooneex/translation";
-import { Assert } from "@ooneex/validation";
-import type { BookEntity } from "../entities/BookEntity";
-import { UpdateBookService } from "../services/UpdateBookService";
-
-type UpdateBookRouteType = {
-  params: { id: string };
-  payload: {
-    title?: string;
-    color?: string;
-    description?: string;
-    summarize?: string;
-    pageCount?: number;
-    src?: string;
-    coverImage?: string;
-    tags?: string[];
-    topics?: string[];
-    categories?: string[];
-    lang?: LocaleType;
-    status?: string;
-  };
-  response: BookEntity | Record<string, never>;
-};
-
-@Route.patch("/books/:id", {
-  name: "book.update",
-  version: 1,
-  description: "Update a book",
-  params: {
-    id: Assert("string"),
-  },
-  payload: Assert({
-    title: "string?",
-    color: "string?",
-    description: "string?",
-    summarize: "string?",
-    pageCount: "number?",
-    src: "string?",
-    coverImage: "string?",
-    tags: "string[]?",
-    topics: "string[]?",
-    categories: "string[]?",
-    lang: "string?",
-    status: "string?",
-  }),
-  response: Assert({
-    id: "string",
-    title: "string",
-    color: "string?",
-    description: "string?",
-    summarize: "string?",
-    pageCount: "number?",
-    src: "string",
-    coverImage: "string?",
-    tags: "string[]?",
-    topics: "string[]?",
-    categories: "string[]?",
-    lang: "string?",
-    status: "string?",
-  }),
-  roles: ["ROLE_USER"],
-})
-export class UpdateBookController {
-  constructor(
-    @inject(UpdateBookService) private readonly service: UpdateBookService,
-  ) {}
-
-  public async index(context: ContextType<UpdateBookRouteType>) {
-    const { id } = context.params;
-    const { title, color, description, summarize, pageCount, src, coverImage, tags, topics, categories, lang, status } = context.payload;
-
-    const book = await this.service.execute({ id, title, color, description, summarize, pageCount, src, coverImage, tags, topics, categories, lang, status });
-
-    return context.response.json(book || {});
-  }
-}
-`;
-
-// src/templates/resources/book/services/CreateBookService.txt
-var CreateBookService_default = `import { inject } from "@ooneex/container";
-import { decorator } from "@ooneex/service";
-import type { IService } from "@ooneex/service";
-import type { LocaleType } from "@ooneex/translation";
-import { BookEntity } from "../entities/BookEntity";
-import { BookRepository } from "../repositories/BookRepository";
-
-type ServiceDataType = {
-  title: string;
-  color?: string;
-  description?: string;
-  summarize?: string;
-  pageCount?: number;
-  src: string;
-  coverImage?: string;
-  tags?: string[];
-  topics?: string[];
-  categories?: string[];
-  lang?: LocaleType;
-  status?: string;
-};
-
-@decorator.service()
-export class CreateBookService implements IService {
-  constructor(
-    @inject(BookRepository) private readonly repository: BookRepository,
-  ) {}
-
-  public async execute(data?: ServiceDataType): Promise<BookEntity | null> {
-    if (!data) return null;
-
-    const book = new BookEntity();
-    book.title = data.title;
-    book.color = data.color;
-    book.description = data.description;
-    book.summarize = data.summarize;
-    book.pageCount = data.pageCount;
-    book.src = data.src;
-    book.coverImage = data.coverImage;
-    book.tags = data.tags;
-    book.topics = data.topics;
-    book.categories = data.categories;
-    book.lang = data.lang;
-    book.status = data.status;
-
-    return await this.repository.create(book);
-  }
-}
-`;
-
-// src/templates/resources/book/services/DeleteBookService.txt
-var DeleteBookService_default = `import { inject } from "@ooneex/container";
-import { decorator } from "@ooneex/service";
-import type { IService } from "@ooneex/service";
-import { BookRepository } from "../repositories/BookRepository";
-
-type ServiceDataType = {
-  id: string;
-};
-
-@decorator.service()
-export class DeleteBookService implements IService {
-  constructor(
-    @inject(BookRepository) private readonly repository: BookRepository,
-  ) {}
-
-  public async execute(data?: ServiceDataType): Promise<void> {
-    if (!data) return;
-
-    await this.repository.delete({ id: data.id });
-  }
-}
-`;
-
-// src/templates/resources/book/services/GetBookService.txt
-var GetBookService_default = `import { inject } from "@ooneex/container";
-import { decorator } from "@ooneex/service";
-import type { IService } from "@ooneex/service";
-import { BookEntity } from "../entities/BookEntity";
-import { BookRepository } from "../repositories/BookRepository";
-
-type ServiceDataType = {
-  id: string;
-};
-
-@decorator.service()
-export class GetBookService implements IService {
-  constructor(
-    @inject(BookRepository) private readonly repository: BookRepository,
-  ) {}
-
-  public async execute(data?: ServiceDataType): Promise<BookEntity | null> {
-    if (!data) return null;
-
-    return await this.repository.findOne(data.id);
-  }
-}
-`;
-
-// src/templates/resources/book/services/ListBooksService.txt
-var ListBooksService_default = `import { inject } from "@ooneex/container";
-import { decorator } from "@ooneex/service";
-import type { IService } from "@ooneex/service";
-import type { FilterResultType } from "@ooneex/types";
-import { BookEntity } from "../entities/BookEntity";
-import { BookRepository } from "../repositories/BookRepository";
-
-type ServiceDataType = {
-  page?: number;
-  limit?: number;
-  q?: string;
-};
-
-@decorator.service()
-export class ListBooksService implements IService {
-  constructor(
-    @inject(BookRepository) private readonly repository: BookRepository,
-  ) {}
-
-  public async execute(data?: ServiceDataType): Promise<FilterResultType<BookEntity>> {
-    return await this.repository.find({
-      page: data?.page,
-      limit: data?.limit,
-      q: data?.q,
-    });
-  }
-}
-`;
-
-// src/templates/resources/book/services/UpdateBookService.txt
-var UpdateBookService_default = `import { inject } from "@ooneex/container";
-import { decorator } from "@ooneex/service";
-import type { IService } from "@ooneex/service";
-import type { LocaleType } from "@ooneex/translation";
-import { BookEntity } from "../entities/BookEntity";
-import { BookRepository } from "../repositories/BookRepository";
-
-type ServiceDataType = {
-  id: string;
-  title?: string;
-  color?: string;
-  description?: string;
-  summarize?: string;
-  pageCount?: number;
-  src?: string;
-  coverImage?: string;
-  tags?: string[];
-  topics?: string[];
-  categories?: string[];
-  lang?: LocaleType;
-  status?: string;
-};
-
-@decorator.service()
-export class UpdateBookService implements IService {
-  constructor(
-    @inject(BookRepository) private readonly repository: BookRepository,
-  ) {}
-
-  public async execute(data?: ServiceDataType): Promise<BookEntity | null> {
-    if (!data) return null;
-
-    const { id, ...fields } = data;
-
-    await this.repository.update({ id, ...fields });
-
-    return await this.repository.findOne(id);
-  }
-}
-`;
-
-// src/commands/MigrationCreateCommand.ts
+// src/commands/MakeServiceCommand.ts
 import { join as join30 } from "path";
 import { decorator as decorator30 } from "@ooneex/command";
 import { TerminalLogger as TerminalLogger29 } from "@ooneex/logger";
-import { migrationCreate } from "@ooneex/migrations";
-
-// src/templates/module/migration.up.txt
-var migration_up_default = `#!/usr/bin/env bun
-
-import { up } from "@ooneex/migrations";
-import "@module/{{name}}/migrations/migrations";
-
-await up({
-  databaseUrl: Bun.env.DATABASE_URL,
-  tableName: "migrations",
-});
-`;
-
-// src/commands/MigrationCreateCommand.ts
-class MigrationCreateCommand {
-  getName() {
-    return "migration:create";
-  }
-  getDescription() {
-    return "Generate a new migration file";
-  }
-  async run(options) {
-    const { module = "shared" } = options;
-    await ensureModule(module);
-    const base = join30("modules", module);
-    const { migrationPath: filePath } = await migrationCreate({
-      migrationsDir: join30(base, "src", "migrations"),
-      testsDir: join30(base, "tests", "migrations"),
-      module
-    });
-    const binMigrationUpPath = join30(process.cwd(), base, "bin", "migration", "up.ts");
-    const binMigrationUpFile = Bun.file(binMigrationUpPath);
-    if (!await binMigrationUpFile.exists()) {
-      await Bun.write(binMigrationUpPath, migration_up_default.replace(/{{name}}/g, module));
-    }
-    const logger = new TerminalLogger29;
-    logger.success(`${filePath} created successfully`, undefined, {
-      showTimestamp: false,
-      showArrow: false,
-      useSymbol: true
-    });
-  }
-}
-MigrationCreateCommand = __legacyDecorateClassTS([
-  decorator30.command()
-], MigrationCreateCommand);
-
-// src/commands/MakeServiceCommand.ts
-import { join as join31 } from "path";
-import { decorator as decorator31 } from "@ooneex/command";
-import { TerminalLogger as TerminalLogger30 } from "@ooneex/logger";
 import { toPascalCase as toPascalCase15 } from "@ooneex/utils";
 
 // src/templates/service.test.txt
@@ -99478,28 +98820,28 @@ class MakeServiceCommand {
     name = toPascalCase15(name).replace(/Service$/, "");
     const content = service_default.replace(/{{NAME}}/g, name);
     await ensureModule(module);
-    const base = join31("modules", module);
-    const serviceLocalDir = join31(base, "src", "services");
-    const serviceDir = join31(process.cwd(), serviceLocalDir);
-    const filePath = join31(serviceDir, `${name}Service.ts`);
+    const base = join30("modules", module);
+    const serviceLocalDir = join30(base, "src", "services");
+    const serviceDir = join30(process.cwd(), serviceLocalDir);
+    const filePath = join30(serviceDir, `${name}Service.ts`);
     await Bun.write(filePath, content);
     const testContent = service_test_default.replace(/{{NAME}}/g, name).replace(/{{MODULE}}/g, module);
-    const testsLocalDir = join31(base, "tests", "services");
-    const testsDir = join31(process.cwd(), testsLocalDir);
-    const testFilePath = join31(testsDir, `${name}Service.spec.ts`);
+    const testsLocalDir = join30(base, "tests", "services");
+    const testsDir = join30(process.cwd(), testsLocalDir);
+    const testFilePath = join30(testsDir, `${name}Service.spec.ts`);
     await Bun.write(testFilePath, testContent);
-    const logger = new TerminalLogger30;
-    logger.success(`${join31(serviceLocalDir, name)}Service.ts created successfully`, undefined, {
+    const logger = new TerminalLogger29;
+    logger.success(`${join30(serviceLocalDir, name)}Service.ts created successfully`, undefined, {
       showTimestamp: false,
       showArrow: false,
       useSymbol: true
     });
-    logger.success(`${join31(testsLocalDir, name)}Service.spec.ts created successfully`, undefined, {
+    logger.success(`${join30(testsLocalDir, name)}Service.spec.ts created successfully`, undefined, {
       showTimestamp: false,
       showArrow: false,
       useSymbol: true
     });
-    const packageJsonPath = join31(process.cwd(), "package.json");
+    const packageJsonPath = join30(process.cwd(), "package.json");
     const packageJson = await Bun.file(packageJsonPath).json();
     const deps = packageJson.dependencies ?? {};
     const devDeps = packageJson.devDependencies ?? {};
@@ -99514,79 +98856,12 @@ class MakeServiceCommand {
   }
 }
 MakeServiceCommand = __legacyDecorateClassTS([
-  decorator31.command()
+  decorator30.command()
 ], MakeServiceCommand);
-
-// src/commands/MakeResourceBookCommand.ts
-class MakeResourceBookCommand {
-  getName() {
-    return "make:resource:book";
-  }
-  getDescription() {
-    return "Generate book resource (entity, migration, repository)";
-  }
-  async run() {
-    const module = "book";
-    const base = join32("modules", module);
-    const makeModuleCommand = new ModuleCreateCommand;
-    await makeModuleCommand.run({ name: module, silent: true });
-    const makeEntityCommand = new MakeEntityCommand;
-    await makeEntityCommand.run({ name: "Book", module, tableName: "books" });
-    const makeMigrationCommand = new MigrationCreateCommand;
-    await makeMigrationCommand.run({ module });
-    const makeRepositoryCommand = new MakeRepositoryCommand;
-    await makeRepositoryCommand.run({ name: "Book", module });
-    const makeControllerCommand = new MakeControllerCommand;
-    const controllers = [
-      { name: "CreateBook", route: { name: "book.create", path: "/books", method: "POST" } },
-      { name: "GetBook", route: { name: "book.get", path: "/books/:id", method: "GET" } },
-      { name: "ListBooks", route: { name: "book.list", path: "/books", method: "GET" } },
-      { name: "UpdateBook", route: { name: "book.update", path: "/books/:id", method: "PATCH" } },
-      { name: "DeleteBook", route: { name: "book.delete", path: "/books/:id", method: "DELETE" } }
-    ];
-    for (const controller of controllers) {
-      await makeControllerCommand.run({ ...controller, module, isSocket: false });
-    }
-    const controllersDir = join32(process.cwd(), base, "src", "controllers");
-    await Bun.write(join32(controllersDir, "CreateBookController.ts"), CreateBookController_default);
-    await Bun.write(join32(controllersDir, "GetBookController.ts"), GetBookController_default);
-    await Bun.write(join32(controllersDir, "ListBooksController.ts"), ListBooksController_default);
-    await Bun.write(join32(controllersDir, "UpdateBookController.ts"), UpdateBookController_default);
-    await Bun.write(join32(controllersDir, "DeleteBookController.ts"), DeleteBookController_default);
-    const makeServiceCommand = new MakeServiceCommand;
-    const services = ["CreateBook", "GetBook", "ListBooks", "UpdateBook", "DeleteBook"];
-    for (const name of services) {
-      await makeServiceCommand.run({ name, module });
-    }
-    const servicesDir = join32(process.cwd(), base, "src", "services");
-    await Bun.write(join32(servicesDir, "CreateBookService.ts"), CreateBookService_default);
-    await Bun.write(join32(servicesDir, "GetBookService.ts"), GetBookService_default);
-    await Bun.write(join32(servicesDir, "ListBooksService.ts"), ListBooksService_default);
-    await Bun.write(join32(servicesDir, "UpdateBookService.ts"), UpdateBookService_default);
-    await Bun.write(join32(servicesDir, "DeleteBookService.ts"), DeleteBookService_default);
-    const entityPath = join32(process.cwd(), base, "src", "entities", "BookEntity.ts");
-    await Bun.write(entityPath, BookEntity_default);
-    const migrationsDir = join32(process.cwd(), base, "src", "migrations");
-    const glob = new Glob("Migration*.ts");
-    for await (const file of glob.scan(migrationsDir)) {
-      if (file === "migrations.ts")
-        continue;
-      const name = file.replace(/\.ts$/, "");
-      const version = name.replace("Migration", "");
-      const content = BookMigration_default.replaceAll("{{ name }}", name).replaceAll("{{ version }}", version);
-      await Bun.write(join32(migrationsDir, file), content);
-    }
-    const repositoryPath = join32(process.cwd(), base, "src", "repositories", "BookRepository.ts");
-    await Bun.write(repositoryPath, BookRepository_default);
-  }
-}
-MakeResourceBookCommand = __legacyDecorateClassTS([
-  decorator32.command()
-], MakeResourceBookCommand);
 // src/commands/MakeStorageCommand.ts
-import { join as join33 } from "path";
-import { decorator as decorator33 } from "@ooneex/command";
-import { TerminalLogger as TerminalLogger31 } from "@ooneex/logger";
+import { join as join31 } from "path";
+import { decorator as decorator31 } from "@ooneex/command";
+import { TerminalLogger as TerminalLogger30 } from "@ooneex/logger";
 import { toPascalCase as toPascalCase16, toSnakeCase as toSnakeCase3 } from "@ooneex/utils";
 
 // src/templates/storage.test.txt
@@ -99611,6 +98886,8 @@ describe("{{NAME}}StorageAdapter", () => {
 
 // src/templates/storage.txt
 var storage_default = `import { Storage, decorator, StorageException } from "@ooneex/storage";
+import { inject } from "@ooneex/container";
+import { AppEnv } from "@ooneex/app-env";
 import type { S3Options } from "bun";
 
 @decorator.storage()
@@ -99621,17 +98898,20 @@ export class {{NAME}}Storage extends Storage {
   private readonly endpoint: string;
   private readonly region: string;
 
-  constructor(options?: {
-    accessKey?: string;
-    secretKey?: string;
-    endpoint?: string;
-    region?: string;
-  }) {
+  public constructor(
+    @inject(AppEnv) private readonly env: AppEnv,
+    options?: {
+      accessKey?: string;
+      secretKey?: string;
+      endpoint?: string;
+      region?: string;
+    },
+  ) {
     super();
 
-    const accessKey = options?.accessKey || Bun.env.STORAGE_{{NAME_UPPER}}_ACCESS_KEY;
-    const secretKey = options?.secretKey || Bun.env.STORAGE_{{NAME_UPPER}}_SECRET_KEY;
-    const endpoint = options?.endpoint || Bun.env.STORAGE_{{NAME_UPPER}}_ENDPOINT;
+    const accessKey = options?.accessKey || this.env.STORAGE_{{NAME_UPPER}}_ACCESS_KEY;
+    const secretKey = options?.secretKey || this.env.STORAGE_{{NAME_UPPER}}_SECRET_KEY;
+    const endpoint = options?.endpoint || this.env.STORAGE_{{NAME_UPPER}}_ENDPOINT;
 
     if (!accessKey) {
       throw new StorageException(
@@ -99652,7 +98932,7 @@ export class {{NAME}}Storage extends Storage {
     this.accessKey = accessKey;
     this.secretKey = secretKey;
     this.endpoint = endpoint;
-    this.region = options?.region || Bun.env.STORAGE_{{NAME_UPPER}}_REGION || "auto";
+    this.region = options?.region || this.env.STORAGE_{{NAME_UPPER}}_REGION || "auto";
   }
 
   public getOptions(): S3Options {
@@ -99684,28 +98964,28 @@ class MakeStorageCommand {
     const nameUpper = toSnakeCase3(name).toUpperCase();
     const content = storage_default.replace(/{{NAME}}/g, name).replace(/{{NAME_UPPER}}/g, nameUpper);
     await ensureModule(module);
-    const base = join33("modules", module);
-    const storageLocalDir = join33(base, "src", "storage");
-    const storageDir = join33(process.cwd(), storageLocalDir);
-    const filePath = join33(storageDir, `${name}Storage.ts`);
+    const base = join31("modules", module);
+    const storageLocalDir = join31(base, "src", "storage");
+    const storageDir = join31(process.cwd(), storageLocalDir);
+    const filePath = join31(storageDir, `${name}Storage.ts`);
     await Bun.write(filePath, content);
     const testContent = storage_test_default.replace(/{{NAME}}/g, name).replace(/{{MODULE}}/g, module);
-    const testsLocalDir = join33(base, "tests", "storage");
-    const testsDir = join33(process.cwd(), testsLocalDir);
-    const testFilePath = join33(testsDir, `${name}Storage.spec.ts`);
+    const testsLocalDir = join31(base, "tests", "storage");
+    const testsDir = join31(process.cwd(), testsLocalDir);
+    const testFilePath = join31(testsDir, `${name}Storage.spec.ts`);
     await Bun.write(testFilePath, testContent);
-    const logger = new TerminalLogger31;
-    logger.success(`${join33(storageLocalDir, name)}Storage.ts created successfully`, undefined, {
+    const logger = new TerminalLogger30;
+    logger.success(`${join31(storageLocalDir, name)}Storage.ts created successfully`, undefined, {
       showTimestamp: false,
       showArrow: false,
       useSymbol: true
     });
-    logger.success(`${join33(testsLocalDir, name)}Storage.spec.ts created successfully`, undefined, {
+    logger.success(`${join31(testsLocalDir, name)}Storage.spec.ts created successfully`, undefined, {
       showTimestamp: false,
       showArrow: false,
       useSymbol: true
     });
-    const packageJsonPath = join33(process.cwd(), "package.json");
+    const packageJsonPath = join31(process.cwd(), "package.json");
     const packageJson = await Bun.file(packageJsonPath).json();
     const deps = packageJson.dependencies ?? {};
     const devDeps = packageJson.devDependencies ?? {};
@@ -99720,12 +99000,12 @@ class MakeStorageCommand {
   }
 }
 MakeStorageCommand = __legacyDecorateClassTS([
-  decorator33.command()
+  decorator31.command()
 ], MakeStorageCommand);
 // src/commands/MakeVectorDatabaseCommand.ts
-import { join as join34 } from "path";
-import { decorator as decorator34 } from "@ooneex/command";
-import { TerminalLogger as TerminalLogger32 } from "@ooneex/logger";
+import { join as join32 } from "path";
+import { decorator as decorator32 } from "@ooneex/command";
+import { TerminalLogger as TerminalLogger31 } from "@ooneex/logger";
 import { toPascalCase as toPascalCase17 } from "@ooneex/utils";
 
 // src/templates/vector-database.test.txt
@@ -99797,28 +99077,28 @@ class MakeVectorDatabaseCommand {
     name = toPascalCase17(name).replace(/VectorDatabase$/, "").replace(/Database$/, "");
     const content = vector_database_default.replace(/{{NAME}}/g, name);
     await ensureModule(module);
-    const base = join34("modules", module);
-    const vectorDatabaseLocalDir = join34(base, "src", "databases");
-    const vectorDatabaseDir = join34(process.cwd(), vectorDatabaseLocalDir);
-    const filePath = join34(vectorDatabaseDir, `${name}VectorDatabase.ts`);
+    const base = join32("modules", module);
+    const vectorDatabaseLocalDir = join32(base, "src", "databases");
+    const vectorDatabaseDir = join32(process.cwd(), vectorDatabaseLocalDir);
+    const filePath = join32(vectorDatabaseDir, `${name}VectorDatabase.ts`);
     await Bun.write(filePath, content);
     const testContent = vector_database_test_default.replace(/{{NAME}}/g, name).replace(/{{MODULE}}/g, module);
-    const testsLocalDir = join34(base, "tests", "databases");
-    const testsDir = join34(process.cwd(), testsLocalDir);
-    const testFilePath = join34(testsDir, `${name}VectorDatabase.spec.ts`);
+    const testsLocalDir = join32(base, "tests", "databases");
+    const testsDir = join32(process.cwd(), testsLocalDir);
+    const testFilePath = join32(testsDir, `${name}VectorDatabase.spec.ts`);
     await Bun.write(testFilePath, testContent);
-    const logger = new TerminalLogger32;
-    logger.success(`${join34(vectorDatabaseLocalDir, name)}VectorDatabase.ts created successfully`, undefined, {
+    const logger = new TerminalLogger31;
+    logger.success(`${join32(vectorDatabaseLocalDir, name)}VectorDatabase.ts created successfully`, undefined, {
       showTimestamp: false,
       showArrow: false,
       useSymbol: true
     });
-    logger.success(`${join34(testsLocalDir, name)}VectorDatabase.spec.ts created successfully`, undefined, {
+    logger.success(`${join32(testsLocalDir, name)}VectorDatabase.spec.ts created successfully`, undefined, {
       showTimestamp: false,
       showArrow: false,
       useSymbol: true
     });
-    const packageJsonPath = join34(process.cwd(), "package.json");
+    const packageJsonPath = join32(process.cwd(), "package.json");
     const packageJson = await Bun.file(packageJsonPath).json();
     const deps = packageJson.dependencies ?? {};
     const devDeps = packageJson.devDependencies ?? {};
@@ -99833,12 +99113,66 @@ class MakeVectorDatabaseCommand {
   }
 }
 MakeVectorDatabaseCommand = __legacyDecorateClassTS([
-  decorator34.command()
+  decorator32.command()
 ], MakeVectorDatabaseCommand);
+// src/commands/MigrationCreateCommand.ts
+import { join as join33 } from "path";
+import { decorator as decorator33 } from "@ooneex/command";
+import { TerminalLogger as TerminalLogger32 } from "@ooneex/logger";
+import { migrationCreate } from "@ooneex/migrations";
+
+// src/templates/module/migration.up.txt
+var migration_up_default = `#!/usr/bin/env bun
+
+import { up } from "@ooneex/migrations";
+import { AppEnv } from "@ooneex/app-env";
+import "@module/{{name}}/migrations/migrations";
+
+const env = new AppEnv();
+
+await up({
+  databaseUrl: env.DATABASE_URL,
+  tableName: "migrations",
+});
+`;
+
+// src/commands/MigrationCreateCommand.ts
+class MigrationCreateCommand {
+  getName() {
+    return "migration:create";
+  }
+  getDescription() {
+    return "Generate a new migration file";
+  }
+  async run(options) {
+    const { module = "shared" } = options;
+    await ensureModule(module);
+    const base = join33("modules", module);
+    const { migrationPath: filePath } = await migrationCreate({
+      migrationsDir: join33(base, "src", "migrations"),
+      testsDir: join33(base, "tests", "migrations"),
+      module
+    });
+    const binMigrationUpPath = join33(process.cwd(), base, "bin", "migration", "up.ts");
+    const binMigrationUpFile = Bun.file(binMigrationUpPath);
+    if (!await binMigrationUpFile.exists()) {
+      await Bun.write(binMigrationUpPath, migration_up_default.replace(/{{name}}/g, module));
+    }
+    const logger = new TerminalLogger32;
+    logger.success(`${filePath} created successfully`, undefined, {
+      showTimestamp: false,
+      showArrow: false,
+      useSymbol: true
+    });
+  }
+}
+MigrationCreateCommand = __legacyDecorateClassTS([
+  decorator33.command()
+], MigrationCreateCommand);
 // src/commands/MigrationUpCommand.ts
 import { existsSync as existsSync2 } from "fs";
-import { join as join35 } from "path";
-import { decorator as decorator35 } from "@ooneex/command";
+import { join as join34 } from "path";
+import { decorator as decorator34 } from "@ooneex/command";
 import { TerminalLogger as TerminalLogger33 } from "@ooneex/logger";
 class MigrationUpCommand {
   getName() {
@@ -99849,7 +99183,7 @@ class MigrationUpCommand {
   }
   async run(options) {
     const logger = new TerminalLogger33;
-    const modulesDir = join35(process.cwd(), "modules");
+    const modulesDir = join34(process.cwd(), "modules");
     if (!existsSync2(modulesDir)) {
       logger.warn("No modules with migrations found", undefined, {
         showTimestamp: false,
@@ -99862,10 +99196,10 @@ class MigrationUpCommand {
     const modules = [];
     for await (const match of glob.scan({ cwd: modulesDir, onlyFiles: true })) {
       const entry = match.replace("/package.json", "");
-      const moduleDir = join35(modulesDir, entry);
-      const migrationUpFile = Bun.file(join35(moduleDir, "bin", "migration", "up.ts"));
+      const moduleDir = join34(modulesDir, entry);
+      const migrationUpFile = Bun.file(join34(moduleDir, "bin", "migration", "up.ts"));
       if (await migrationUpFile.exists()) {
-        const packageJson = await Bun.file(join35(modulesDir, match)).json();
+        const packageJson = await Bun.file(join34(modulesDir, match)).json();
         modules.push({ name: packageJson.name ?? entry, dir: moduleDir });
       }
     }
@@ -99878,7 +99212,7 @@ class MigrationUpCommand {
       return;
     }
     for (const { name, dir } of modules) {
-      const migrationUpPath = join35(dir, "bin", "migration", "up.ts");
+      const migrationUpPath = join34(dir, "bin", "migration", "up.ts");
       logger.info(`Running migrations for ${name}...`, undefined, {
         showTimestamp: false,
         showArrow: false,
@@ -99891,7 +99225,7 @@ class MigrationUpCommand {
       const proc = Bun.spawn(args, {
         cwd: dir,
         stdout: "inherit",
-        stderr: "inherit"
+        stderr: "pipe"
       });
       const exitCode = await proc.exited;
       if (exitCode === 0) {
@@ -99901,7 +99235,9 @@ class MigrationUpCommand {
           useSymbol: true
         });
       } else {
-        logger.error(`Migrations failed for ${name} (exit code: ${exitCode})`, undefined, {
+        const errorOutput = await new Response(proc.stderr).text();
+        const trimmed = errorOutput.trim();
+        logger.error(`Migrations failed for ${name} (exit code: ${exitCode})`, trimmed ? { message: trimmed } : undefined, {
           showTimestamp: false,
           showArrow: false,
           useSymbol: true
@@ -99911,11 +99247,11 @@ class MigrationUpCommand {
   }
 }
 MigrationUpCommand = __legacyDecorateClassTS([
-  decorator35.command()
+  decorator34.command()
 ], MigrationUpCommand);
 // src/commands/ModuleLockCommand.ts
-import { join as join36, relative } from "path";
-import { decorator as decorator36 } from "@ooneex/command";
+import { join as join35, relative } from "path";
+import { decorator as decorator35 } from "@ooneex/command";
 import { TerminalLogger as TerminalLogger34 } from "@ooneex/logger";
 import { migrationTestCreate } from "@ooneex/migrations";
 import { seedTestCreate } from "@ooneex/seeds";
@@ -99931,16 +99267,16 @@ class ModuleLockCommand {
     const { module = "shared", override } = options;
     const logger = new TerminalLogger34;
     await ensureModule(module);
-    const base = join36("modules", module);
+    const base = join35("modules", module);
     const moduleName = module;
-    const ymlPath = join36(process.cwd(), base, `${moduleName}.yml`);
+    const ymlPath = join35(process.cwd(), base, `${moduleName}.yml`);
     if (!await Bun.file(ymlPath).exists()) {
       await Bun.write(ymlPath, yml_default.replace(/{{name}}/g, moduleName));
     }
     const { migrations: registeredMigrations, seeds: registeredSeeds } = await this.parseYml(ymlPath);
     let added = 0;
     let skipped = 0;
-    const migrationsDir = join36(process.cwd(), base, "src", "migrations");
+    const migrationsDir = join35(process.cwd(), base, "src", "migrations");
     const migrationFiles = [];
     try {
       const glob = new Bun.Glob("Migration*.ts");
@@ -99950,17 +99286,17 @@ class ModuleLockCommand {
     } catch {}
     for (const file of migrationFiles.sort()) {
       const name = file.replace(/\.ts$/, "");
-      const testsDir = join36(base, "tests", "migrations");
+      const testsDir = join35(base, "tests", "migrations");
       await migrationTestCreate({ name, testsDir, ...module && { module } });
       if (registeredMigrations[name] && !override) {
         skipped++;
         continue;
       }
-      const content = await Bun.file(join36(migrationsDir, file)).text();
+      const content = await Bun.file(join35(migrationsDir, file)).text();
       registeredMigrations[name] = new Bun.CryptoHasher("sha256").update(content).digest("hex");
       added++;
     }
-    const seedsDir = join36(process.cwd(), base, "src", "seeds");
+    const seedsDir = join35(process.cwd(), base, "src", "seeds");
     const seedFiles = [];
     try {
       const glob = new Bun.Glob("*-seed.yml");
@@ -99970,13 +99306,13 @@ class ModuleLockCommand {
     } catch {}
     for (const file of seedFiles.sort()) {
       const name = file.replace(/\.yml$/, "");
-      const testsDir = join36(base, "tests", "seeds");
+      const testsDir = join35(base, "tests", "seeds");
       await seedTestCreate({ name: toPascalCase18(name), testsDir, ...module && { module } });
       if (registeredSeeds[name] && !override) {
         skipped++;
         continue;
       }
-      const content = await Bun.file(join36(seedsDir, file)).text();
+      const content = await Bun.file(join35(seedsDir, file)).text();
       registeredSeeds[name] = new Bun.CryptoHasher("sha256").update(content).digest("hex");
       added++;
     }
@@ -100043,12 +99379,12 @@ class ModuleLockCommand {
   }
 }
 ModuleLockCommand = __legacyDecorateClassTS([
-  decorator36.command()
+  decorator35.command()
 ], ModuleLockCommand);
 // src/commands/ModuleRemoveCommand.ts
 import { rmdir } from "fs/promises";
-import { join as join37 } from "path";
-import { decorator as decorator37 } from "@ooneex/command";
+import { join as join36 } from "path";
+import { decorator as decorator36 } from "@ooneex/command";
 import { TerminalLogger as TerminalLogger35 } from "@ooneex/logger";
 import { toKebabCase as toKebabCase6, toPascalCase as toPascalCase19 } from "@ooneex/utils";
 class ModuleRemoveCommand {
@@ -100129,8 +99465,8 @@ class ModuleRemoveCommand {
       }
       return;
     }
-    const moduleDir = join37(cwd, "modules", kebabName);
-    const moduleDirExists = await Bun.file(join37(moduleDir, "package.json")).exists();
+    const moduleDir = join36(cwd, "modules", kebabName);
+    const moduleDirExists = await Bun.file(join36(moduleDir, "package.json")).exists();
     if (!moduleDirExists) {
       if (!silent) {
         const logger = new TerminalLogger35;
@@ -100150,13 +99486,13 @@ class ModuleRemoveCommand {
       if (!confirmed)
         return;
     }
-    const appModulePath = join37(cwd, "modules", "app", "src", "AppModule.ts");
+    const appModulePath = join36(cwd, "modules", "app", "src", "AppModule.ts");
     await this.removeFromAppModule(appModulePath, pascalName, kebabName);
-    const sharedModulePath = join37(cwd, "modules", "shared", "src", "SharedModule.ts");
+    const sharedModulePath = join36(cwd, "modules", "shared", "src", "SharedModule.ts");
     await this.removeFromSharedModule(sharedModulePath, pascalName, kebabName);
-    const appTsconfigPath = join37(cwd, "tsconfig.json");
+    const appTsconfigPath = join36(cwd, "tsconfig.json");
     await this.removePathAlias(appTsconfigPath, kebabName);
-    const commitlintPath = join37(cwd, ".commitlintrc.ts");
+    const commitlintPath = join36(cwd, ".commitlintrc.ts");
     await this.removeModuleScope(commitlintPath, kebabName);
     await rmdir(moduleDir, { recursive: true });
     if (!silent) {
@@ -100170,11 +99506,11 @@ class ModuleRemoveCommand {
   }
 }
 ModuleRemoveCommand = __legacyDecorateClassTS([
-  decorator37.command()
+  decorator36.command()
 ], ModuleRemoveCommand);
 // src/commands/SeedCreateCommand.ts
-import { join as join38 } from "path";
-import { decorator as decorator38 } from "@ooneex/command";
+import { join as join37 } from "path";
+import { decorator as decorator37 } from "@ooneex/command";
 import { TerminalLogger as TerminalLogger36 } from "@ooneex/logger";
 import { seedCreate } from "@ooneex/seeds";
 
@@ -100212,18 +99548,18 @@ class SeedCreateCommand {
       name = await askName({ message: "Enter seed name" });
     }
     await ensureModule(module);
-    const base = join38("modules", module);
+    const base = join37("modules", module);
     const {
       seedPath: filePath,
       dataPath,
       testPath
     } = await seedCreate({
       name,
-      seedsDir: join38(base, "src", "seeds"),
-      testsDir: join38(base, "tests", "seeds"),
+      seedsDir: join37(base, "src", "seeds"),
+      testsDir: join37(base, "tests", "seeds"),
       module
     });
-    const binSeedRunPath = join38(process.cwd(), base, "bin", "seed", "run.ts");
+    const binSeedRunPath = join37(process.cwd(), base, "bin", "seed", "run.ts");
     const binSeedRunFile = Bun.file(binSeedRunPath);
     if (!await binSeedRunFile.exists()) {
       await Bun.write(binSeedRunPath, seed_run_default.replace(/{{name}}/g, module));
@@ -100247,12 +99583,12 @@ class SeedCreateCommand {
   }
 }
 SeedCreateCommand = __legacyDecorateClassTS([
-  decorator38.command()
+  decorator37.command()
 ], SeedCreateCommand);
 // src/commands/SeedRunCommand.ts
 import { existsSync as existsSync3 } from "fs";
-import { join as join39 } from "path";
-import { decorator as decorator39 } from "@ooneex/command";
+import { join as join38 } from "path";
+import { decorator as decorator38 } from "@ooneex/command";
 import { TerminalLogger as TerminalLogger37 } from "@ooneex/logger";
 class SeedRunCommand {
   getName() {
@@ -100263,7 +99599,7 @@ class SeedRunCommand {
   }
   async run(options) {
     const logger = new TerminalLogger37;
-    const modulesDir = join39(process.cwd(), "modules");
+    const modulesDir = join38(process.cwd(), "modules");
     if (!existsSync3(modulesDir)) {
       logger.warn("No modules with seeds found", undefined, {
         showTimestamp: false,
@@ -100276,10 +99612,10 @@ class SeedRunCommand {
     const modules = [];
     for await (const match of glob.scan({ cwd: modulesDir, onlyFiles: true })) {
       const entry = match.replace("/package.json", "");
-      const moduleDir = join39(modulesDir, entry);
-      const seedRunFile = Bun.file(join39(moduleDir, "bin", "seed", "run.ts"));
+      const moduleDir = join38(modulesDir, entry);
+      const seedRunFile = Bun.file(join38(moduleDir, "bin", "seed", "run.ts"));
       if (await seedRunFile.exists()) {
-        const packageJson = await Bun.file(join39(modulesDir, match)).json();
+        const packageJson = await Bun.file(join38(modulesDir, match)).json();
         modules.push({ name: packageJson.name ?? entry, dir: moduleDir });
       }
     }
@@ -100292,7 +99628,7 @@ class SeedRunCommand {
       return;
     }
     for (const { name, dir } of modules) {
-      const seedRunPath = join39(dir, "bin", "seed", "run.ts");
+      const seedRunPath = join38(dir, "bin", "seed", "run.ts");
       logger.info(`Running seeds for ${name}...`, undefined, {
         showTimestamp: false,
         showArrow: false,
@@ -100306,7 +99642,7 @@ class SeedRunCommand {
       const proc = Bun.spawn(args, {
         cwd: dir,
         stdout: "inherit",
-        stderr: "inherit",
+        stderr: "pipe",
         env
       });
       const exitCode = await proc.exited;
@@ -100317,7 +99653,9 @@ class SeedRunCommand {
           useSymbol: true
         });
       } else {
-        logger.error(`Seeds failed for ${name} (exit code: ${exitCode})`, undefined, {
+        const errorOutput = await new Response(proc.stderr).text();
+        const trimmed = errorOutput.trim();
+        logger.error(`Seeds failed for ${name} (exit code: ${exitCode})`, trimmed ? { message: trimmed } : undefined, {
           showTimestamp: false,
           showArrow: false,
           useSymbol: true
@@ -100327,9 +99665,9 @@ class SeedRunCommand {
   }
 }
 SeedRunCommand = __legacyDecorateClassTS([
-  decorator39.command()
+  decorator38.command()
 ], SeedRunCommand);
 // src/index.ts
 await run();
 
-//# debugId=62106AD907A8879564756E2164756E21
+//# debugId=61AFC67C24C1FDDE64756E2164756E21