@dawudesign/node-hexa-cli 0.1.3 → 0.1.5

package/LICENSE

@@ -0,0 +1,45 @@
+Proprietary License
+
+Copyright (c) 2026 Dawudesign. All rights reserved.
+
+TERMS AND CONDITIONS
+
+1. GRANT OF USE
+   A valid license purchased from the copyright holder grants the end user
+   the right to install and use this software solely for their own internal
+   purposes. No other rights are granted.
+
+2. RESTRICTIONS
+   You may NOT, without prior written permission from the copyright holder:
+   a. Copy, reproduce, or duplicate this software or any part thereof;
+   b. Distribute, publish, transmit, or otherwise make this software
+      available to any third party, whether for free or for a fee;
+   c. Sublicense, sell, resell, rent, lease, or lend this software;
+   d. Modify, adapt, translate, reverse-engineer, decompile, or create
+      derivative works based on this software;
+   e. Remove or alter any copyright notices or license terms contained
+      in this software.
+
+3. OWNERSHIP
+   This software and all copies thereof are proprietary to Dawud and
+   title thereto remains in Dawud. All rights reserved. Dawud is the
+   sole authorized distributor and seller of this software.
+
+4. NO WARRANTY
+   THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
+   NON-INFRINGEMENT.
+
+5. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL DAWUD BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE,
+   ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+   OR OTHER DEALINGS IN THE SOFTWARE.
+
+6. TERMINATION
+   Any breach of these terms automatically terminates your right to use
+   this software. Upon termination, you must destroy all copies in your
+   possession.
+
+For licensing inquiries, contact the copyright holder.

package/README.md

@@ -0,0 +1,287 @@
+# @dawudesign/node-hexa-cli
+
+> Scaffold and enforce **NestJS Hexagonal DDD** architecture from the command line.
+
+**node-hexa** automates the repetitive parts of clean architecture in NestJS:
+
+- **Scaffold** — generates a full bounded context with dependency injection pre-wired, in one command
+- **Enforce** — statically analyzes your TypeScript source and reports architecture violations
+- **Document** — exports a Mermaid diagram and architecture report as Markdown or SVG
+
+---
+
+## Requirements
+
+- **Node.js ≥ 20**
+
+---
+
+## Installation
+
+```bash
+npm install -g @dawudesign/node-hexa-cli
+```
+
+Verify:
+
+```bash
+node-hexa --version
+node-hexa --help
+```
+
+---
+
+## Quickstart
+
+```bash
+# 1. Create a new NestJS Hexagonal DDD project
+node-hexa init my-app
+cd my-app
+
+# 2. Start the server
+pnpm start:dev
+
+# 3. Verify architecture is clean
+node-hexa check .
+# ✓ Architecture check passed
+```
+
+---
+
+## Commands
+
+### `init`
+
+Creates a new NestJS project with the complete Hexagonal DDD structure.
+
+```bash
+node-hexa init <name>
+```
+
+```bash
+node-hexa init my-app
+```
+
+Generates:
+
+```text
+my-app/
+├── src/
+│   ├── main.ts
+│   ├── app.module.ts
+│   └── contexts/
+│       └── iam/
+│           ├── iam.module.ts
+│           ├── domain/
+│           │   ├── entities/user.entity.ts
+│           │   └── ports/user.repository.port.ts
+│           ├── application/
+│           │   └── use-cases/create-user.usecase.ts
+│           └── infrastructure/
+│               ├── http/user.controller.ts
+│               └── persistence/in-memory-user.repository.ts
+└── node-hexa.config.json
+```
+
+---
+
+### `generate context`
+
+Generates a complete bounded context inside an existing NestJS project.
+
+```bash
+node-hexa generate context <name>
+```
+
+```bash
+cd my-app
+node-hexa generate context orders
+# ✓ Context 'orders' generated at src/contexts/orders/
+# → Import OrdersModule in your AppModule to activate it.
+```
+
+---
+
+### `generate usecase`
+
+Generates a use case with its DTO and Vitest spec inside an existing bounded context.
+
+```bash
+node-hexa generate usecase <name> <context>
+```
+
+```bash
+node-hexa generate usecase delete-user iam
+# ✓ Use case 'delete-user' generated in context 'iam'
+```
+
+Generated files:
+
+```text
+src/contexts/iam/application/use-cases/
+├── delete-user.usecase.ts
+├── delete-user.dto.ts
+└── delete-user.usecase.spec.ts
+```
+
+---
+
+### `generate aggregate`
+
+Generates a full DDD aggregate (entity, value object, port, use case, in-memory repository, HTTP controller, NestJS module).
+
+```bash
+node-hexa generate aggregate <name> <context>
+```
+
+```bash
+node-hexa generate aggregate product catalog
+# ✓ Aggregate 'product' generated in context 'catalog'
+```
+
+---
+
+### `check`
+
+Checks architecture rules — exits `0` if clean, `1` if violations found. Designed for CI/CD.
+
+```bash
+node-hexa check <path> [--watch]
+```
+
+```bash
+# One-shot (CI)
+node-hexa check .
+
+# Watch mode (development)
+node-hexa check . --watch
+```
+
+Output:
+
+```text
+✓ Architecture check passed
+```
+
+or:
+
+```text
+✗ Architecture violations detected
+
+  [CRITICAL] Domain must not depend on infrastructure → UserEntity
+  [HIGH] Application must not depend on infrastructure → CreateUserUseCase
+```
+
+---
+
+### `analyze`
+
+Full analysis: layers, violations, bounded contexts, Mermaid diagram, and score.
+
+```bash
+node-hexa analyze <path>
+```
+
+```bash
+node-hexa analyze .
+```
+
+---
+
+### `list`
+
+Lists all bounded contexts and their components.
+
+```bash
+node-hexa list <path>
+```
+
+```bash
+node-hexa list .
+```
+
+Output:
+
+```text
+Bounded Contexts (2)
+
+  IAM
+    Entities      : user.entity
+    Ports         : user.repository.port
+    Use Cases     : create-user.usecase
+
+  CATALOG
+    Entities      : product.entity
+    Ports         : product.repository.port
+    Use Cases     : create-product.usecase
+```
+
+---
+
+### `docs`
+
+Generates an `architecture.md` at the project root with the Mermaid diagram, violations, and score.
+
+```bash
+node-hexa docs <path>
+```
+
+```bash
+node-hexa docs .
+# Architecture documentation generated: ./architecture.md
+```
+
+---
+
+### `graph`
+
+Generates an `architecture.svg` dependency graph (requires `@mermaid-js/mermaid-cli`).
+
+```bash
+npm install -g @mermaid-js/mermaid-cli
+node-hexa graph .
+# Architecture graph generated: ./architecture.svg
+```
+
+---
+
+## Configuration
+
+`node-hexa.config.json` at the project root (created by `init`, all keys optional):
+
+```json
+{
+  "architecture": "hexagonal-ddd",
+  "strict": true,
+  "contextsDir": "src/contexts"
+}
+```
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `architecture` | `string` | required | Architecture type — `hexagonal-ddd` |
+| `strict` | `boolean` | `true` | `false` silences `MEDIUM` violations |
+| `contextsDir` | `string` | `"src/contexts"` | Path to bounded contexts directory |
+
+---
+
+## Violation rules
+
+| Violation | Severity | Score penalty |
+| --- | --- | --- |
+| Domain imports from infrastructure / adapter | `CRITICAL` | −25 pts |
+| Domain imports from application | `CRITICAL` | −25 pts |
+| Application imports from infrastructure / adapter | `HIGH` | −15 pts |
+| Domain imports a framework (`@nestjs/*`, `prisma`, etc.) | `CRITICAL` | −25 pts |
+
+Score = `100 − sum of penalties`, minimum 0.
+
+---
+
+## License
+
+`activate` command required for production use:
+
+```bash
+node-hexa activate <your-license-key>
+```

package/dist/index.js

@@ -6,10 +6,10 @@ import { Command } from "commander";
 
 // src/license.ts
 import { createHmac, timingSafeEqual } from "crypto";
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { writeFileSync, mkdirSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
-var SIGNING_SECRET = "2dc6d0a8b5c755f95a2e9fbca8c8e6c45226763dc2040ae5335bc86f480337bb";
+var SIGNING_SECRET = process.env["NODEHEXA_LICENSE_SECRET"] ?? "";
 var CONFIG_DIR = join(homedir(), ".config", "node-hexa");
 var LICENSE_FILE = join(CONFIG_DIR, "license");
 function parseLicenseKey(key) {
@@ -47,30 +47,11 @@ function activateLicense(key) {
   }
   mkdirSync(CONFIG_DIR, { recursive: true });
   writeFileSync(LICENSE_FILE, key.trim(), "utf8");
-  console.log(`\u2713 License activated for ${parsed.email} (valid until: ${parsed.expiresAt})`);
+  console.log(
+    `\u2713 License activated for ${parsed.email} (valid until: ${parsed.expiresAt})`
+  );
 }
 function checkLicense() {
-  if (!existsSync(LICENSE_FILE)) {
-    console.error(
-      "\u2717 No license found. Purchase a license at https://your-website.com and run:\n  node-hexa activate <your-license-key>"
-    );
-    process.exit(1);
-  }
-  const key = readFileSync(LICENSE_FILE, "utf8").trim();
-  const parsed = parseLicenseKey(key);
-  if (!parsed) {
-    console.error(
-      "\u2717 License file is corrupted. Re-activate with:\n  node-hexa activate <your-license-key>"
-    );
-    process.exit(1);
-  }
-  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  if (parsed.expiresAt !== "lifetime" && parsed.expiresAt < today) {
-    console.error(
-      `\u2717 Your license expired on ${parsed.expiresAt}. Renew at https://your-website.com`
-    );
-    process.exit(1);
-  }
 }
 
 // ../../packages/parser/dist/index.js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dawudesign/node-hexa-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "CLI to scaffold and analyze NestJS Hexagonal DDD projects",
   "keywords": [
     "nestjs",
@@ -10,7 +10,7 @@
     "cli",
     "scaffold"
   ],
-  "license": "UNLICENSED",
+  "license": "MIT",
   "type": "module",
   "engines": {
     "node": ">=20"