katax-cli 0.1.0 → 1.0.0

package/dist/commands/init.js

@@ -371,8 +371,8 @@ async function createProjectStructure(projectPath, config, generateJwtSecrets) {
     if (config.database !== 'none') {
         dirs.push('src/database');
     }
-    // Add default hola endpoint
-    dirs.push('src/api/hola');
+    // Add default hello endpoint
+    dirs.push('src/api/hello');
     for (const dir of dirs) {
         await ensureDir(path.join(projectPath, dir));
     }
@@ -427,20 +427,24 @@ async function createProjectStructure(projectPath, config, generateJwtSecrets) {
         }
     };
     await writeFile(path.join(projectPath, 'package.json'), JSON.stringify(packageJson, null, 2));
-    // Create tsconfig.json
+    // Create tsconfig.json - ESM optimized for Linux/Ubuntu deployment
     const tsConfig = {
         compilerOptions: {
-            target: 'es2016',
-            module: 'commonjs',
+            target: 'ES2022',
+            module: 'ES2022',
+            lib: ['ES2022'],
+            moduleResolution: 'node',
             sourceMap: true,
             outDir: './dist',
-            mapRoot: 'src',
+            rootDir: './src',
             esModuleInterop: true,
             forceConsistentCasingInFileNames: true,
             strict: true,
-            skipLibCheck: true
+            skipLibCheck: true,
+            resolveJsonModule: true,
+            declaration: true
         },
-        include: ['src'],
+        include: ['src/**/*'],
         exclude: ['node_modules', 'dist']
     };
     await writeFile(path.join(projectPath, 'tsconfig.json'), JSON.stringify(tsConfig, null, 2));
@@ -527,6 +531,27 @@ coverage/
 .vscode/
 `;
     await writeFile(path.join(projectPath, '.gitignore'), gitignoreContent);
+    // Create .gitattributes for consistent line endings across Windows/Linux
+    const gitattributesContent = `# Auto normalize line endings to LF on checkout (critical for Ubuntu deployment)
+* text=auto eol=lf
+
+# Explicit file types
+*.ts text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+
+# Binaries
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.pdf binary
+`;
+    await writeFile(path.join(projectPath, '.gitattributes'), gitattributesContent);
     // Create index.ts
     const indexContent = `import app from './app.js';
 import dotenv from 'dotenv';
@@ -583,7 +608,7 @@ export default app;
     await writeFile(path.join(projectPath, 'src/app.ts'), appContent);
     // Create routes.ts
     const routesContent = `import { Router } from 'express';
-import holaRouter from './hola/hola.routes.js';
+import helloRouter from './hello/hello.routes.js';
 import { healthCheckHandler } from './health/health.handler.js';
 
 const router = Router();
@@ -592,7 +617,7 @@ const router = Router();
 router.get('/health', healthCheckHandler);
 
 // Example endpoint
-router.use('/hola', holaRouter);
+router.use('/hello', helloRouter);
 
 export default router;
 `;
@@ -1186,86 +1211,86 @@ katax generate crud products
 MIT
 `;
     await writeFile(path.join(projectPath, 'README.md'), readmeContent);
-    // Create default hola endpoint
-    await createHolaEndpoint(projectPath, config);
+    // Create default hello endpoint
+    await createHelloEndpoint(projectPath, config);
 }
-async function createHolaEndpoint(projectPath, config) {
-    const holaPath = path.join(projectPath, 'src/api/hola');
-    // hola.controller.ts
+async function createHelloEndpoint(projectPath, config) {
+    const helloPath = path.join(projectPath, 'src/api/hello');
+    // hello.controller.ts
     const controllerContent = [
         "import { ControllerResult, createSuccessResult, createErrorResult } from '../../shared/api.utils.js';",
-        "import { HolaQuery } from './hola.validator.js';",
+        "import { HelloQuery } from './hello.validator.js';",
         "import { logger } from '../../shared/logger.utils.js';",
         "",
         "/**",
-        " * Get hola message",
+        " * Get hello message",
         " */",
-        "export async function getHola(queryData: HolaQuery): Promise<ControllerResult<{ message: string; timestamp: string }>> {",
+        "export async function getHello(queryData: HelloQuery): Promise<ControllerResult<{ message: string; timestamp: string }>> {",
         "  try {",
         "    const name = queryData.name || 'World';",
-        "    logger.debug({ name }, 'Processing hola request');",
+        "    logger.debug({ name }, 'Processing hello request');",
         "    ",
         "    return createSuccessResult(",
-        "      'Hola endpoint working!',",
+        "      'Hello endpoint working!',",
         "      {",
-        "        message: `Hola ${name}! Welcome to your API 🚀`,",
+        "        message: `Hello ${name}! Welcome to your API 🚀`,",
         "        timestamp: new Date().toISOString()",
         "      }",
         "    );",
         "  } catch (error) {",
-        "    logger.error({ err: error }, 'Error in getHola controller');",
+        "    logger.error({ err: error }, 'Error in getHello controller');",
         "    return createErrorResult(",
-        "      'Failed to get hola message',",
+        "      'Failed to get hello message',",
         "      error instanceof Error ? error.message : 'Unknown error',",
         "      500",
         "    );",
         "  }",
         "}"
     ].join('\n');
-    await writeFile(path.join(holaPath, 'hola.controller.ts'), controllerContent);
-    // hola.handler.ts
+    await writeFile(path.join(helloPath, 'hello.controller.ts'), controllerContent);
+    // hello.handler.ts
     const handlerContent = [
         "import { Request, Response } from 'express';",
-        "import { getHola } from './hola.controller.js';",
-        "import { validateHolaQuery } from './hola.validator.js';",
+        "import { getHello } from './hello.controller.js';",
+        "import { validateHelloQuery } from './hello.validator.js';",
         "import { sendResponse } from '../../shared/api.utils.js';",
         "",
         "// ==================== HANDLERS ====================",
         "",
         "/**",
-        " * Handler for GET /api/hola",
+        " * Handler for GET /api/hello",
         " * Uses sendResponse utility for automatic validation and response handling",
         " */",
-        "export async function getHolaHandler(req: Request, res: Response): Promise<void> {",
+        "export async function getHelloHandler(req: Request, res: Response): Promise<void> {",
         "  await sendResponse(",
         "    req,",
         "    res,",
-        "    // Validator returns Promise<ValidationResult<HolaQuery>>",
-        "    () => validateHolaQuery(req.query),",
-        "    // validData is automatically: HolaQuery (not any)",
-        "    (validData) => getHola(validData)",
+        "    // Validator returns Promise<ValidationResult<HelloQuery>>",
+        "    () => validateHelloQuery(req.query),",
+        "    // validData is automatically: HelloQuery (not any)",
+        "    (validData) => getHello(validData)",
         "  );",
         "}"
     ].join('\n');
-    await writeFile(path.join(holaPath, 'hola.handler.ts'), handlerContent);
-    // hola.routes.ts
+    await writeFile(path.join(helloPath, 'hello.handler.ts'), handlerContent);
+    // hello.routes.ts
     const routesContent = [
         "import { Router } from 'express';",
-        "import { getHolaHandler } from './hola.handler.js';",
+        "import { getHelloHandler } from './hello.handler.js';",
         "",
         "const router = Router();",
         "",
         "// ==================== ROUTES ====================",
         "",
         "/**",
-        " * @route GET /api/hola",
+        " * @route GET /api/hello",
         " * @desc Example endpoint - returns a greeting message",
         " */",
-        "router.get('/', getHolaHandler);",
+        "router.get('/', getHelloHandler);",
         "",
         "export default router;"
     ].join('\n');
-    await writeFile(path.join(holaPath, 'hola.routes.ts'), routesContent);
+    await writeFile(path.join(helloPath, 'hello.routes.ts'), routesContent);
     // Only create validator if katax-core is enabled
     if (config.validation === 'katax-core') {
         const validatorContent = [
@@ -1275,22 +1300,22 @@ async function createHolaEndpoint(projectPath, config) {
             "// ==================== SCHEMAS ====================",
             "",
             "/**",
-            " * Schema for hola query params",
+            " * Schema for hello query params",
             " */",
-            "export const holaQuerySchema = k.object({",
+            "export const helloQuerySchema = k.object({",
             "  name: k.string().minLength(2).optional()",
             "});",
             "",
             "/**",
             " * Inferred TypeScript type from schema",
             " */",
-            "export type HolaQuery = kataxInfer<typeof holaQuerySchema>;",
+            "export type HelloQuery = kataxInfer<typeof helloQuerySchema>;",
             "",
             "/**",
-            " * Validate hola query params",
+            " * Validate hello query params",
             " */",
-            "export async function validateHolaQuery(data: unknown): Promise<ValidationResult<HolaQuery>> {",
-            "  const result = holaQuerySchema.safeParse(data);",
+            "export async function validateHelloQuery(data: unknown): Promise<ValidationResult<HelloQuery>> {",
+            "  const result = helloQuerySchema.safeParse(data);",
             "",
             "  if (!result.success) {",
             "    const errors = result.issues.map(issue => ({",
@@ -1310,6 +1335,6 @@ async function createHolaEndpoint(projectPath, config) {
             "  };",
             "}"
         ].join('\n');
-        await writeFile(path.join(holaPath, 'hola.validator.ts'), validatorContent);
+        await writeFile(path.join(helloPath, 'hello.validator.ts'), validatorContent);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "katax-cli",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "CLI tool to generate Express APIs with TypeScript and katax-core validation",
   "type": "module",
   "main": "dist/index.js",