nural 0.3.8 → 0.3.10

package/README.md

@@ -1,446 +0,0 @@
-<p align="center">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark-mode.png">
-    <source media="(prefers-color-scheme: light)" srcset="assets/logo-light-mode.png">
-    <img alt="Nural Logo" src="assets/logo-light-mode.png" width="300">
-  </picture>
-</p>
-
-# Nural
-
-<p align="center">
-  <strong>The intelligent, schema-first REST framework for Node.js</strong>
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/ "><img src="https://img.shields.io/npm/v/nural.svg" alt="npm version"></a>
-  <a href="https://github.com/ErrorX407/nural/actions/workflows/ci.yml"><img src="https://github.com/ErrorX407/nural/actions/workflows/ci.yml/badge.svg" alt="Build Status"></a>
-  <img src="https://img.shields.io/npm/l/nural.svg" alt="license">
-  <a href="https://www.npmjs.com/package/nural"><img src="https://img.shields.io/npm/dm/nural.svg" alt="Downloads"></a>
-</p>
-
----
-
-## Features
-
-- ⚡ **Type-Safe** – End-to-end TypeScript inference
-- 📝 **Auto Documentation** – OpenAPI spec & Scalar UI out-of-the-box
-- 🛡️ **Validation** – Zod-powered input/output validation
-- 🔄 **Response Mapping** – Auto-strip unlisted fields (no data leaks!)
-- 🔌 **Multi-Framework** – Works with Express & Fastify
-- 🎯 **Middleware Context** – Type-safe context injection
-- 🔒 **Built-in Security** – CORS & Helmet with zero dependencies
-
----
-
-## Installation
-
-```bash
-npm install nural express
-# or
-npm install nural fastify
-```
-
----
-
-## 🛠️ CLI
-
-Nural comes with a built-in CLI to help you scaffold projects and generate resources.
-
-```bash
-# Create a new project
-npx nural new my-api
-
-# Generate resources
-npx nural generate route users
-npx nural generate middleware auth
-npx nural generate service user
-```
-
----
-
-## Quick Start
-
-```typescript
-import { Nural, createRoute, z } from "nural";
-
-// Create app
-const app = new Nural({ framework: "express", docs: true });
-
-// Define a route
-const helloRoute = createRoute({
-  method: "GET",
-  path: "/hello",
-  summary: "Health check",
-  responses: {
-    200: z.object({ message: z.string() }),
-  },
-  handler: async () => {
-    return { message: "Hello from Nural!", secret: "HIDDEN" };
-    // ↑ 'secret' is auto-stripped from response!
-  },
-});
-
-// Register and start
-app.register([helloRoute]);
-app.start(3000);
-// 🚀 Server: http://localhost:3000
-// 📚 Docs:   http://localhost:3000/docs
-```
-
----
-
-## Validation
-
-```typescript
-const userRoute = createRoute({
-  method: "POST",
-  path: "/users",
-  request: {
-    body: z.object({
-      name: z.string().min(2),
-      email: z.string().email(),
-    }),
-  },
-  responses: {
-    201: z.object({ id: z.string(), name: z.string() }),
-  },
-  handler: async ({ body }) => {
-    // body is typed as { name: string, email: string }
-    return { id: "uuid", name: body.name };
-  },
-});
-```
-
----
-
-## Middleware
-
-```typescript
-import { defineMiddleware } from "nural";
-
-const authMiddleware = defineMiddleware(async (req) => {
-  const token = req.headers.authorization;
-  if (!token) throw new Error("Unauthorized");
-  return { user: { id: "123", role: "admin" } };
-});
-
-const meRoute = createRoute({
-  method: "GET",
-  path: "/me",
-  middleware: [authMiddleware],
-  responses: { 200: z.object({ id: z.string(), role: z.string() }) },
-  handler: async ({ user }) => {
-    // ↑ 'user' is inferred from middleware!
-    return user;
-  },
-});
-```
-
----
-
-## CORS & Helmet (Built-in Security)
-
-```typescript
-// Enable with defaults
-const app = new Nural({
-  cors: true,
-  helmet: true,
-});
-
-// Or with full configuration
-const app = new Nural({
-  cors: {
-    origin: "https://example.com",
-    methods: ["GET", "POST"],
-    credentials: true,
-  },
-  helmet: {
-    contentSecurityPolicy: false,
-    hsts: { maxAge: 31536000, includeSubDomains: true },
-  },
-});
-  },
-});
-```
-
----
-
-## Unified Exception System
-
-Throw standard exceptions anywhere in your code, and Nural automatically formats them into standard JSON error responses.
-
-```typescript
-import { NotFoundException, UnauthorizedException } from "nural";
-
-// In your service or handler
-if (!user) {
-  throw new NotFoundException("User not found");
-}
-
-if (!token) {
-  throw new UnauthorizedException("Missing token");
-}
-```
-
-**Result:**
-
-```json
-{
-  "statusCode": 404,
-  "message": "User not found",
-  "error": "Not Found",
-  "timestamp": "2026-02-08T12:00:00.000Z"
-}
-```
-
----
-
-## Global Error Handler
-
-```typescript
-// Enable with defaults (smart error mapping)
-const app = new Nural({ errorHandler: true });
-
-// Custom error handler (e.g., Sentry integration)
-const app = new Nural({
-  errorHandler: (ctx) => {
-    Sentry.captureException(ctx.error);
-    return {
-      status: 500,
-      body: { error: "Something went wrong" },
-    };
-  },
-});
-
-// Full configuration
-const app = new Nural({
-  errorHandler: {
-    handler: customHandler,
-    includeStack: process.env.NODE_ENV !== "production",
-    logErrors: true,
-    logger: (err, ctx) => winston.error(err.message, { path: ctx.path }),
-  },
-});
-```
-
-**Smart defaults:** Automatically maps `"unauthorized"` → 401, `"not found"` → 404, Zod errors → 400.
-
-### Available Exceptions
-
-| Exception                       | Status Code |
-| :------------------------------ | :---------- |
-| `BadRequestException`           | 400         |
-| `UnauthorizedException`         | 401         |
-| `ForbiddenException`            | 403         |
-| `NotFoundException`             | 404         |
-| `ConflictException`             | 409         |
-| `GoneException`                 | 410         |
-| `PayloadTooLargeException`      | 413         |
-| `UnsupportedMediaTypeException` | 415         |
-| `UnprocessableEntityException`  | 422         |
-| `InternalServerErrorException`  | 500         |
-| `NotImplementedException`       | 501         |
-| `BadGatewayException`           | 502         |
-| `ServiceUnavailableException`   | 503         |
-| `GatewayTimeoutException`       | 504         |
-
----
-
-## Logger
-
-Nural comes with a built-in, zero-dependency logger that is lightweight and colorful.
-
-```typescript
-import { Logger } from "nural";
-
-const logger = new Logger("MyService");
-
-logger.log("This is a log message");
-logger.warn("Be careful!");
-logger.error("Something went wrong");
-// Output: [Nural] 1234 - 2026-02-08... [MyService] This is a log message
-```
-
-### HTTP Logger
-
-The HTTP logger middleware is enabled by default and logs all incoming requests with their status and duration.
-
-```typescript
-const app = new Nural({
-  logger: {
-    enabled: true,
-    showUserAgent: true, // Log User-Agent header
-    showTime: true, // Log request duration (default: true)
-  },
-});
-```
-
----
-
-## Configuration
-
-```typescript
-const app = new Nural({
-  framework: "fastify", // or 'express'
-  cors: true, // Enable CORS with defaults
-  helmet: true, // Enable security headers with defaults
-
-  // Documentation
-  docs: {
-    enabled: true,
-    path: "/api-docs",
-    ui: "scalar", // 'scalar' (default) or 'swagger'
-
-    // Full OpenAPI Customization
-    openApi: {
-      info: {
-        title: "My API",
-        version: "2.0.0",
-        description: "My awesome API",
-      },
-      servers: [{ url: "https://api.example.com" }],
-      // Add Security Schemes (e.g., API Key, Bearer Token)
-      components: {
-        securitySchemes: {
-          bearerAuth: {
-            type: "http",
-            scheme: "bearer",
-            bearerFormat: "JWT",
-          },
-        },
-      },
-      // Apply Global Security
-      security: [{ bearerAuth: [] }],
-    },
-
-    // Scalar UI Options (fully typed)
-    scalar: {
-      theme: "moon", // 'alternate', 'default', 'moon', 'purple', 'solarized', etc.
-      layout: "modern",
-      showSidebar: true,
-      hideModels: true,
-      darkMode: true,
-      // Custom Metadata
-      metaData: { title: "API Docs" },
-      // Authentication Pre-fill
-      authentication: {
-        preferredSecurityScheme: "bearerAuth",
-        securitySchemes: {
-          bearerAuth: { token: "EXAMPLE_TOKEN" },
-        },
-      },
-    },
-
-    // Swagger UI Options (fully typed)
-    swagger: {
-      theme: "outline", // 'outline', 'classic', or 'no-theme'
-      options: {
-        persistAuthorization: true,
-        docExpansion: "list",
-        defaultModelsExpandDepth: -1,
-        filter: true,
-        syntaxHighlight: { theme: "monokai" },
-      },
-    },
-  },
-
-  // Logger
-  logger: {
-    enabled: true,
-    showUserAgent: false,
-    showTime: true,
-  },
-
-  // Error Handling
-  errorHandler: {
-    handler: customHandler, // Optional custom handler
-    includeStack: false, // Hide stack traces in production
-    logErrors: true, // Log errors to console
-  },
-});
-```
-
----
-
-## API Reference
-
-### `createRoute(config)`
-
-| Property         | Type                        | Description                                    |
-| ---------------- | --------------------------- | ---------------------------------------------- |
-| `method`         | `HttpMethod`                | GET, POST, PUT, PATCH, DELETE                  |
-| `path`           | `string`                    | Route path (supports `:param`)                 |
-| `summary`        | `string?`                   | Short description for docs                     |
-| `description`    | `string?`                   | Detailed description                           |
-| `tags`           | `string[]?`                 | Grouping for docs                              |
-| `middleware`     | `array?`                    | Middleware functions                           |
-| `request.params` | `ZodSchema?`                | Path params validation                         |
-| `request.query`  | `ZodSchema?`                | Query params validation                        |
-| `request.body`   | `ZodSchema?`                | Body validation                                |
-| `responses`      | `Record<number, ZodSchema>` | Response schemas                               |
-| `security`       | `array?`                    | OpenAPI security (e.g. `[{ bearerAuth: [] }]`) |
-| `openapi`        | `object?`                   | OpenAPI operation overrides                    |
-| `handler`        | `function`                  | Route handler                                  |
-
-### Per-Route Configuration (Security & Headers)
-
-You can define security requirements or override OpenAPI properties directly on the route:
-
-```typescript
-const protectedRoute = createRoute({
-  method: "GET",
-  path: "/protected",
-  // Define security requirements
-  security: [{ bearerAuth: [] }],
-  // Override OpenAPI operation (e.g., custom headers)
-  openapi: {
-    parameters: [
-      {
-        in: "header",
-        name: "X-Custom-Header",
-        schema: { type: "string" },
-        required: true,
-      },
-    ],
-  },
-  handler: async () => {
-    return { secret: "data" };
-  },
-});
-```
-
-### Route Context (`ctx`)
-
-The `handler` receives a `ctx` object containing:
-
-```typescript
-{
-  params: { id: "123" },      // Validated path params
-  query: { page: 1 },         // Validated query params
-  body: { name: "John" },     // Validated body
-  req: Request,               // Native request object
-  res: Response,              // Native response object
-  ...middlewareProps          // Properties injected by middleware
-}
-```
-
-### `defineMiddleware(fn)`
-
-Creates a type-safe middleware that injects context into handlers.
-
-### `new Nural(config)`
-
-| Property       | Type                           | Default     | Description              |
-| -------------- | ------------------------------ | ----------- | ------------------------ |
-| `framework`    | `'express' \| 'fastify'`       | `'express'` | Server framework         |
-| `docs`         | `boolean \| DocsConfig`        | `true`      | Documentation settings   |
-| `cors`         | `boolean \| CorsConfig`        | `false`     | CORS middleware settings |
-| `helmet`       | `boolean \| HelmetConfig`      | `false`     | Security headers         |
-| `errorHandler` | `boolean \| fn \| ErrorConfig` | `true`      | Global error handling    |
-
----
-
-## License
-
-MIT © [Chetan Joshi](https://github.com/ErrorX407)

package/dist/cli/index.cjs

@@ -1,221 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-var commander = require('commander');
-var inquirer = require('inquirer');
-var chalk = require('chalk');
-var fs = require('fs-extra');
-var path = require('path');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var inquirer__default = /*#__PURE__*/_interopDefault(inquirer);
-var chalk__default = /*#__PURE__*/_interopDefault(chalk);
-var fs__default = /*#__PURE__*/_interopDefault(fs);
-var path__default = /*#__PURE__*/_interopDefault(path);
-
-var program = new commander.Command();
-program.name("nural").description("Nural Framework CLI").version("0.3.8");
-program.command("new <project-name>").description("Create a new Nural project").action(async (projectName) => {
-  const projectPath = path__default.default.join(process.cwd(), projectName);
-  if (fs__default.default.existsSync(projectPath)) {
-    console.error(
-      chalk__default.default.red(`Error: Directory ${projectName} already exists.`)
-    );
-    process.exit(1);
-  }
-  const { framework } = await inquirer__default.default.prompt([
-    {
-      type: "list",
-      name: "framework",
-      message: "Select a framework (express/fastify):",
-      choices: [
-        {
-          name: "express",
-          value: "express",
-          description: "Fast, unopinionated, minimalist web framework"
-        },
-        {
-          name: "fastify",
-          value: "fastify",
-          description: "Fast and low overhead web framework"
-        }
-      ],
-      default: "express"
-    }
-  ]);
-  console.log(
-    chalk__default.default.blue(`
-Initializing new Nural project in ${projectName}...`)
-  );
-  fs__default.default.ensureDirSync(path__default.default.join(projectPath, "src/config"));
-  fs__default.default.ensureDirSync(path__default.default.join(projectPath, "src/routes"));
-  fs__default.default.ensureDirSync(path__default.default.join(projectPath, "src/middleware"));
-  fs__default.default.ensureDirSync(path__default.default.join(projectPath, "src/services"));
-  const packageJson = {
-    name: projectName,
-    version: "1.0.0",
-    main: "dist/index.js",
-    scripts: {
-      dev: "nodemon --exec tsx src/index.ts",
-      build: "tsup src/index.ts --format cjs,esm --dts",
-      start: "node dist/index.js"
-    },
-    dependencies: {
-      nural: "^0.3.8",
-      [framework]: framework === "express" ? "^5.0.0" : "^5.0.0",
-      // Using explicit versions for peer deps
-      zod: "^3.22.4"
-    },
-    devDependencies: {
-      tsx: "^4.7.1",
-      tsup: "^8.0.2",
-      typescript: "^5.3.3",
-      nodemon: "^3.1.11",
-      "@types/node": "^20.11.24",
-      ...framework === "express" ? { "@types/express": "^5.0.0" } : {}
-    }
-  };
-  fs__default.default.writeJsonSync(path__default.default.join(projectPath, "package.json"), packageJson, {
-    spaces: 2
-  });
-  const tsconfig = {
-    compilerOptions: {
-      target: "ES2020",
-      module: "CommonJS",
-      moduleResolution: "node",
-      strict: true,
-      esModuleInterop: true,
-      skipLibCheck: true,
-      forceConsistentCasingInFileNames: true,
-      outDir: "./dist"
-    },
-    include: ["src/**/*"],
-    exclude: ["node_modules"]
-  };
-  fs__default.default.writeJsonSync(path__default.default.join(projectPath, "tsconfig.json"), tsconfig, {
-    spaces: 2
-  });
-  const indexContent = `import { Nural } from "nural";
-import { appConfig } from "./config/app.config";
-
-const app = new Nural(appConfig);
-
-app.start(3000)
-`;
-  fs__default.default.writeFileSync(path__default.default.join(projectPath, "src/index.ts"), indexContent);
-  const configContent = `import { NuralConfig } from "nural";
-
-export const appConfig: NuralConfig = {
-  framework: "${framework}",
-  docs: true,
-  logger: {
-    enabled: true,
-  },
-};
-`;
-  fs__default.default.writeFileSync(
-    path__default.default.join(projectPath, "src/config/app.config.ts"),
-    configContent
-  );
-  console.log(
-    chalk__default.default.green(`
-\u2714 Project ${projectName} created successfully!`)
-  );
-  console.log(chalk__default.default.white(`
-Next steps:`));
-  console.log(chalk__default.default.cyan(`  cd ${projectName}`));
-  console.log(chalk__default.default.cyan(`  npm install`));
-  console.log(chalk__default.default.cyan(`  npm run dev`));
-});
-program.command("generate <type> <name>").alias("g").description("Generate a resource (route, middleware, service)").action((typeArg, nameArg) => {
-  const type = typeArg.toLowerCase();
-  const name = nameArg.toLowerCase();
-  const srcDir = path__default.default.join(process.cwd(), "src");
-  if (!fs__default.default.existsSync(srcDir)) {
-    console.error(
-      chalk__default.default.red(
-        "Error: src directory not found. Are you in a Nural project root?"
-      )
-    );
-    process.exit(1);
-  }
-  const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
-  switch (type) {
-    case "route": {
-      const routeContent = `import { createRoute, z } from "nural";
-
-export const ${name}Route = createRoute({
-  method: "GET",
-  path: "/${name}",
-  summary: "${capitalize(name)} route",
-  responses: {
-    200: z.object({ message: z.string() }),
-  },
-  handler: async () => {
-    return { message: "Hello from ${name}" };
-  },
-
-  export const ${name}Routes = [${name}Route]
-});
-`;
-      const routesDir = path__default.default.join(srcDir, "routes");
-      fs__default.default.ensureDirSync(routesDir);
-      fs__default.default.writeFileSync(
-        path__default.default.join(routesDir, `${name}.routes.ts`),
-        routeContent
-      );
-      console.log(chalk__default.default.green(`Created src/routes/${name}.routes.ts`));
-      break;
-    }
-    case "middleware": {
-      const middlewareContent = `import { defineMiddleware } from "nural";
-
-export const ${name}Middleware = defineMiddleware(async (req, res) => {
-  // TODO: Implement middleware logic
-  return { ${name}: true };
-});
-`;
-      const middlewareDir = path__default.default.join(srcDir, "middleware");
-      fs__default.default.ensureDirSync(middlewareDir);
-      fs__default.default.writeFileSync(
-        path__default.default.join(middlewareDir, `${name}.middleware.ts`),
-        middlewareContent
-      );
-      console.log(
-        chalk__default.default.green(`Created src/middleware/${name}.middleware.ts`)
-      );
-      break;
-    }
-    case "service": {
-      const serviceContent = `export class ${capitalize(name)}Service {
-  constructor() {}
-
-  async findAll() {
-    return [];
-  }
-}
-
-export const ${name}Service = new ${capitalize(name)}Service();
-`;
-      const servicesDir = path__default.default.join(srcDir, "services");
-      fs__default.default.ensureDirSync(servicesDir);
-      fs__default.default.writeFileSync(
-        path__default.default.join(servicesDir, `${name}.service.ts`),
-        serviceContent
-      );
-      console.log(chalk__default.default.green(`Created src/services/${name}.service.ts`));
-      break;
-    }
-    default:
-      console.error(
-        chalk__default.default.red(
-          `Unknown type: ${type}. Supported: route, middleware, service`
-        )
-      );
-      process.exit(1);
-  }
-});
-program.parse(process.argv);
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/cli/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/cli/index.ts"],"names":["Command","path","fs","chalk","inquirer"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Command } from \"commander\";\nimport inquirer from \"inquirer\";\nimport chalk from \"chalk\";\nimport fs from \"fs-extra\";\nimport path from \"path\";\n\nconst program = new Command();\n\nprogram.name(\"nural\").description(\"Nural Framework CLI\").version(\"0.3.8\");\n\nprogram\n  .command(\"new <project-name>\")\n  .description(\"Create a new Nural project\")\n  .action(async (projectName) => {\n    const projectPath = path.join(process.cwd(), projectName);\n\n    if (fs.existsSync(projectPath)) {\n      console.error(\n        chalk.red(`Error: Directory ${projectName} already exists.`),\n      );\n      process.exit(1);\n    }\n\n    const { framework } = await inquirer.prompt([\n      {\n        type: \"list\",\n        name: \"framework\",\n        message: \"Select a framework (express/fastify):\",\n        choices: [\n          {\n            name: \"express\",\n            value: \"express\",\n            description: \"Fast, unopinionated, minimalist web framework\",\n          },\n          {\n            name: \"fastify\",\n            value: \"fastify\",\n            description: \"Fast and low overhead web framework\",\n          },\n        ],\n        default: \"express\",\n      },\n    ]);\n\n    console.log(\n      chalk.blue(`\\nInitializing new Nural project in ${projectName}...`),\n    );\n\n    // Create directories\n    fs.ensureDirSync(path.join(projectPath, \"src/config\"));\n    fs.ensureDirSync(path.join(projectPath, \"src/routes\"));\n    fs.ensureDirSync(path.join(projectPath, \"src/middleware\"));\n    fs.ensureDirSync(path.join(projectPath, \"src/services\"));\n\n    // Create package.json\n    const packageJson = {\n      name: projectName,\n      version: \"1.0.0\",\n      main: \"dist/index.js\",\n      scripts: {\n        dev: \"nodemon --exec tsx src/index.ts\",\n        build: \"tsup src/index.ts --format cjs,esm --dts\",\n        start: \"node dist/index.js\",\n      },\n      dependencies: {\n        nural: \"^0.3.8\",\n        [framework]: framework === \"express\" ? \"^5.0.0\" : \"^5.0.0\", // Using explicit versions for peer deps\n        zod: \"^3.22.4\",\n      },\n      devDependencies: {\n        tsx: \"^4.7.1\",\n        tsup: \"^8.0.2\",\n        typescript: \"^5.3.3\",\n        nodemon: \"^3.1.11\",\n        \"@types/node\": \"^20.11.24\",\n        ...(framework === \"express\" ? { \"@types/express\": \"^5.0.0\" } : {}),\n      },\n    };\n\n    fs.writeJsonSync(path.join(projectPath, \"package.json\"), packageJson, {\n      spaces: 2,\n    });\n\n    // Create tsconfig.json\n    const tsconfig = {\n      compilerOptions: {\n        target: \"ES2020\",\n        module: \"CommonJS\",\n        moduleResolution: \"node\",\n        strict: true,\n        esModuleInterop: true,\n        skipLibCheck: true,\n        forceConsistentCasingInFileNames: true,\n        outDir: \"./dist\",\n      },\n      include: [\"src/**/*\"],\n      exclude: [\"node_modules\"],\n    };\n\n    fs.writeJsonSync(path.join(projectPath, \"tsconfig.json\"), tsconfig, {\n      spaces: 2,\n    });\n\n    // Create src/index.ts\n    const indexContent = `import { Nural } from \"nural\";\nimport { appConfig } from \"./config/app.config\";\n\nconst app = new Nural(appConfig);\n\napp.start(3000)\n`;\n    fs.writeFileSync(path.join(projectPath, \"src/index.ts\"), indexContent);\n\n    // Create src/config/app.config.ts\n    const configContent = `import { NuralConfig } from \"nural\";\n\nexport const appConfig: NuralConfig = {\n  framework: \"${framework}\",\n  docs: true,\n  logger: {\n    enabled: true,\n  },\n};\n`;\n    fs.writeFileSync(\n      path.join(projectPath, \"src/config/app.config.ts\"),\n      configContent,\n    );\n\n    console.log(\n      chalk.green(`\\n✔ Project ${projectName} created successfully!`),\n    );\n    console.log(chalk.white(`\\nNext steps:`));\n    console.log(chalk.cyan(`  cd ${projectName}`));\n    console.log(chalk.cyan(`  npm install`));\n    console.log(chalk.cyan(`  npm run dev`));\n  });\n\nprogram\n  .command(\"generate <type> <name>\")\n  .alias(\"g\")\n  .description(\"Generate a resource (route, middleware, service)\")\n  .action((typeArg, nameArg) => {\n    const type = typeArg.toLowerCase();\n    const name = nameArg.toLowerCase();\n    const srcDir = path.join(process.cwd(), \"src\");\n\n    if (!fs.existsSync(srcDir)) {\n      console.error(\n        chalk.red(\n          \"Error: src directory not found. Are you in a Nural project root?\",\n        ),\n      );\n      process.exit(1);\n    }\n\n    const capitalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1);\n\n    switch (type) {\n      case \"route\": {\n        const routeContent = `import { createRoute, z } from \"nural\";\n\nexport const ${name}Route = createRoute({\n  method: \"GET\",\n  path: \"/${name}\",\n  summary: \"${capitalize(name)} route\",\n  responses: {\n    200: z.object({ message: z.string() }),\n  },\n  handler: async () => {\n    return { message: \"Hello from ${name}\" };\n  },\n\n  export const ${name}Routes = [${name}Route]\n});\n`;\n        const routesDir = path.join(srcDir, \"routes\");\n        fs.ensureDirSync(routesDir);\n        fs.writeFileSync(\n          path.join(routesDir, `${name}.routes.ts`),\n          routeContent,\n        );\n        console.log(chalk.green(`Created src/routes/${name}.routes.ts`));\n        break;\n      }\n      case \"middleware\": {\n        const middlewareContent = `import { defineMiddleware } from \"nural\";\n\nexport const ${name}Middleware = defineMiddleware(async (req, res) => {\n  // TODO: Implement middleware logic\n  return { ${name}: true };\n});\n`;\n        const middlewareDir = path.join(srcDir, \"middleware\");\n        fs.ensureDirSync(middlewareDir);\n        fs.writeFileSync(\n          path.join(middlewareDir, `${name}.middleware.ts`),\n          middlewareContent,\n        );\n        console.log(\n          chalk.green(`Created src/middleware/${name}.middleware.ts`),\n        );\n        break;\n      }\n      case \"service\": {\n        const serviceContent = `export class ${capitalize(name)}Service {\n  constructor() {}\n\n  async findAll() {\n    return [];\n  }\n}\n\nexport const ${name}Service = new ${capitalize(name)}Service();\n`;\n        const servicesDir = path.join(srcDir, \"services\");\n        fs.ensureDirSync(servicesDir);\n        fs.writeFileSync(\n          path.join(servicesDir, `${name}.service.ts`),\n          serviceContent,\n        );\n        console.log(chalk.green(`Created src/services/${name}.service.ts`));\n        break;\n      }\n      default:\n        console.error(\n          chalk.red(\n            `Unknown type: ${type}. Supported: route, middleware, service`,\n          ),\n        );\n        process.exit(1);\n    }\n  });\n\nprogram.parse(process.argv);\n"]}

package/dist/cli/index.d.cts

@@ -1,2 +0,0 @@
-
-export {  }

package/dist/cli/index.d.ts

@@ -1,2 +0,0 @@
-
-export {  }