kastrick 1.0.0

package/lib/server/expressServer.d.ts

@@ -0,0 +1,28 @@
+import express from "express";
+import { ApiFile } from "../core/scanner";
+/**
+ * Express Server - Dev server for local API testing
+ */
+export declare class ExpressServer {
+    private app;
+    private port;
+    private router;
+    private loadedModules;
+    constructor(port?: number);
+    private setupMiddleware;
+    /**
+     * Register routes from API files
+     */
+    registerRoutes(files: ApiFile[]): void;
+    private createHandler;
+    private parseHandler;
+    /**
+     * Start the dev server
+     */
+    start(): void;
+    /**
+     * Get Express app instance
+     */
+    getApp(): express.Application;
+}
+//# sourceMappingURL=expressServer.d.ts.map

package/lib/server/expressServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressServer.d.ts","sourceRoot":"","sources":["../../src/server/expressServer.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAA+B;gBAExC,IAAI,GAAE,MAAa;IAO/B,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IActC,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,WAAW;CAG9B"}

package/lib/server/expressServer.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressServer = void 0;
+const express_1 = __importDefault(require("express"));
+const router_1 = require("../core/router");
+/**
+ * Express Server - Dev server for local API testing
+ */
+class ExpressServer {
+    constructor(port = 3000) {
+        this.loadedModules = new Map();
+        this.app = (0, express_1.default)();
+        this.port = port;
+        this.router = new router_1.Router();
+        this.setupMiddleware();
+    }
+    setupMiddleware() {
+        this.app.use(express_1.default.json());
+        this.app.use(express_1.default.urlencoded({ extended: true }));
+        // Simple logging middleware
+        this.app.use((req, res, next) => {
+            console.log(`📡 ${req.method} ${req.path}`);
+            next();
+        });
+    }
+    /**
+     * Register routes from API files
+     */
+    registerRoutes(files) {
+        const routes = this.router.generateRoutes(files);
+        for (const route of routes) {
+            const method = route.method.toLowerCase();
+            const filePath = route.file;
+            const content = files.find((f) => f.relativePath === filePath)?.content || "";
+            this.app[method](route.path, this.createHandler(filePath, route.method, content));
+        }
+        console.log(`📡 Registered ${routes.length} routes`);
+    }
+    createHandler(filePath, method, content) {
+        return async (req, res) => {
+            try {
+                // Parse and execute handler
+                const fn = this.parseHandler(content, method);
+                if (!fn) {
+                    return res.status(404).json({ error: `${method} handler not found` });
+                }
+                const result = await fn(req, { params: req.params });
+                res.status(result.status || 200).json(result.body !== undefined ? result.body : result);
+            }
+            catch (err) {
+                console.error(`❌ Handler error in ${filePath}:`, err.message);
+                res.status(500).json({ error: err.message || "Internal server error" });
+            }
+        };
+    }
+    parseHandler(content, method) {
+        try {
+            // Extract the function from the file content
+            const moduleExports = {};
+            // Create a minimal module context
+            const module = { exports: moduleExports };
+            const exportFn = (key, fn) => {
+                moduleExports[key] = fn;
+            };
+            // Execute the file content in a controlled context
+            const code = `(function(exports, require, module, __filename, __dirname) { ${content} return module.exports; })`;
+            const fn = eval(code);
+            const result = fn(moduleExports, require, module, "", "");
+            return result[method];
+        }
+        catch (err) {
+            console.error("Error parsing handler:", err);
+            return null;
+        }
+    }
+    /**
+     * Start the dev server
+     */
+    start() {
+        this.app.listen(this.port, () => {
+            console.log(`\n🚀 Kastrick dev server running on http://localhost:${this.port}\n`);
+            console.log(`👀 Watching for changes in /api folder...\n`);
+        });
+    }
+    /**
+     * Get Express app instance
+     */
+    getApp() {
+        return this.app;
+    }
+}
+exports.ExpressServer = ExpressServer;
+//# sourceMappingURL=expressServer.js.map

package/lib/server/expressServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressServer.js","sourceRoot":"","sources":["../../src/server/expressServer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "kastrick",
+  "version": "1.0.0",
+  "description": "a Easy Tool for Kastrick Services and Devoloper Experience",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "bin": {
+    "kastrick": "lib/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "api",
+    "kastrick",
+    "framework",
+    "routing",
+    "backend"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "express": "^4.18.0",
+    "chokidar": "^3.5.0",
+    "typescript": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/express": "^4.17.0"
+  }
+}

package/src/cli/compile.ts

@@ -0,0 +1,27 @@
+import { Scanner } from "../core/scanner";
+import { Compiler } from "../core/compiler";
+
+/**
+ * Compile command - builds the /output folder
+ */
+export async function compile(rootDir: string = process.cwd()): Promise<void> {
+  console.log("🔨 Compiling kastrick project...\n");
+
+  const scanner = new Scanner(rootDir);
+  const compiler = new Compiler(rootDir);
+
+  // Scan API folder
+  const files = scanner.scanApiFolder();
+
+  if (files.length === 0) {
+    console.log("⚠️  No API files found. Create files in /api folder first.");
+    return;
+  }
+
+  console.log(`📁 Found ${files.length} API files`);
+  files.forEach((f) => console.log(`   - ${f.relativePath}`));
+  console.log();
+
+  // Compile
+  compiler.compile(files);
+}

package/src/cli/dev.ts

@@ -0,0 +1,49 @@
+import { Scanner } from "../core/scanner";
+import { ExpressServer } from "../server/expressServer";
+import * as chokidar from "chokidar";
+import * as path from "path";
+
+/**
+ * Dev command - starts dev server with hot reload
+ */
+export async function dev(port: number = 3000, rootDir: string = process.cwd()): Promise<void> {
+  console.log("🚀 Starting kastrick dev server...\n");
+
+  const scanner = new Scanner(rootDir);
+  const server = new ExpressServer(port);
+
+  // Initial register
+  const files = scanner.scanApiFolder();
+  if (files.length > 0) {
+    server.registerRoutes(files);
+  } else {
+    console.log("⚠️  No API files found. Create files in /api folder.\n");
+  }
+
+  server.start();
+
+  // Watch for changes
+  const apiPath = path.join(rootDir, "api");
+  const watcher = chokidar.watch(apiPath, {
+    ignored: /(^|[\/\\])\.|node_modules/,
+    persistent: true,
+  });
+
+  watcher.on("change", () => {
+    console.log("\n♻️  Files changed, reloading routes...\n");
+    const updatedFiles = scanner.scanApiFolder();
+    server.registerRoutes(updatedFiles);
+  });
+
+  watcher.on("add", () => {
+    console.log("\n♻️  Files added, reloading routes...\n");
+    const updatedFiles = scanner.scanApiFolder();
+    server.registerRoutes(updatedFiles);
+  });
+
+  watcher.on("unlink", () => {
+    console.log("\n♻️  Files removed, reloading routes...\n");
+    const updatedFiles = scanner.scanApiFolder();
+    server.registerRoutes(updatedFiles);
+  });
+}

package/src/cli/index.ts

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+import { compile } from "./compile";
+import { dev } from "./dev";
+import { serve } from "./serve";
+
+const command = process.argv[2];
+const port = process.argv[3] ? parseInt(process.argv[3]) : undefined;
+
+async function main() {
+  try {
+    switch (command) {
+      case "compile":
+        await compile();
+        break;
+      case "dev":
+        await dev(port);
+        break;
+      case "serve":
+        await serve(port);
+        break;
+      case "--version":
+      case "-v":
+        console.log("kastrick v1.0.0");
+        break;
+      case "--help":
+      case "-h":
+        showHelp();
+        break;
+      default:
+        console.log("❌ Unknown command:", command);
+        showHelp();
+        process.exit(1);
+    }
+  } catch (err: any) {
+    console.error("❌ Error:", err.message);
+    process.exit(1);
+  }
+}
+
+function showHelp() {
+  console.log(`
+kastrick - API Framework and Compiler
+
+USAGE:
+  npx kastrick <command> [port]
+
+COMMANDS:
+  dev <port>         Start dev server with hot reload (default: 3000)
+  compile            Compile API files to /output folder
+  serve <port>       Run compiled Express server (default: 3000)
+  --help, -h         Show this help message
+  --version, -v      Show version
+
+EXAMPLES:
+  npx kastrick dev                    # Start dev server on port 3000
+  npx kastrick dev 5000               # Start dev server on port 5000
+  npx kastrick compile                # Compile to /output
+  npx kastrick serve                  # Run compiled app on port 3000
+  npx kastrick serve 8080             # Run compiled app on port 8080
+  `);
+}
+
+main();

package/src/cli/serve.ts

@@ -0,0 +1,81 @@
+import express from "express";
+import * as path from "path";
+import * as fs from "fs";
+
+/**
+ * Serve command - runs compiled Express app from /output folder
+ */
+export async function serve(port: number = 3000, rootDir: string = process.cwd()): Promise<void> {
+  const outputDir = path.join(rootDir, "output");
+  const manifestPath = path.join(outputDir, "manifest.json");
+
+  // Check if compiled output exists
+  if (!fs.existsSync(outputDir)) {
+    console.log("❌ /output folder not found. Run 'npx kastrick compile' first.\n");
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(manifestPath)) {
+    console.log("❌ manifest.json not found. Run 'npx kastrick compile' first.\n");
+    process.exit(1);
+  }
+
+  console.log("🚀 Starting compiled kastrick server...\n");
+
+  const app = express();
+  app.use(express.json());
+  app.use(express.urlencoded({ extended: true }));
+
+  // Logging middleware
+  app.use((req: express.Request, res: express.Response, next: express.NextFunction) => {
+    console.log(`📡 ${req.method} ${req.path}`);
+    next();
+  });
+
+  // Load manifest
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+
+  // Register routes from manifest
+  let routeCount = 0;
+  for (const route of manifest.routes || []) {
+    const handlerPath = path.join(outputDir, "handlers", route.file);
+
+    if (!fs.existsSync(handlerPath)) {
+      console.warn(`⚠️  Handler not found: ${handlerPath}`);
+      continue;
+    }
+
+    const method = route.method.toLowerCase() as keyof express.Application;
+    const routePath = route.path;
+
+    app[method](routePath, async (req: express.Request, res: express.Response) => {
+      try {
+        // Dynamically require the handler
+        const modulePath = path.resolve(handlerPath);
+        delete require.cache[modulePath];
+        const handler = require(modulePath);
+
+        // Call the appropriate method
+        const handlerFn = handler[route.method];
+        if (!handlerFn) {
+          return res.status(404).json({ error: `${route.method} handler not found` });
+        }
+
+        const result = await handlerFn(req, { params: req.params });
+        res.status(result.status || 200).json(result.body !== undefined ? result.body : result);
+      } catch (err: any) {
+        console.error(`❌ Handler error in ${route.file}:`, err.message);
+        res.status(500).json({ error: err.message || "Internal server error" });
+      }
+    });
+
+    routeCount++;
+  }
+
+  console.log(`📡 Registered ${routeCount} routes from manifest\n`);
+
+  // Start server
+  app.listen(port, () => {
+    console.log(`🚀 Compiled server running on http://localhost:${port}\n`);
+  });
+}

package/src/core/compiler.ts

@@ -0,0 +1,147 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as ts from "typescript";
+import { ApiFile } from "./scanner";
+import { ApiRoute, Router } from "./router";
+
+export interface ManifestRoute {
+  method: string;
+  path: string;
+  file: string;
+}
+
+export interface Manifest {
+  routes: ManifestRoute[];
+  version: string;
+  timestamp: string;
+}
+
+/**
+ * Compiler - generates the /output folder with compiled handlers
+ */
+export class Compiler {
+  private outputDir: string;
+  private handlersDir: string;
+  private router: Router;
+
+  constructor(rootDir: string = process.cwd()) {
+    this.outputDir = path.join(rootDir, "output");
+    this.handlersDir = path.join(this.outputDir, "handlers");
+    this.router = new Router();
+  }
+
+  /**
+   * Compile API files to output folder
+   */
+  compile(files: ApiFile[]): boolean {
+    try {
+      // Create output directory structure
+      this.ensureDirectories();
+
+      // Generate routes
+      const routes = this.router.generateRoutes(files);
+
+      // Copy handler files
+      this.copyHandlers(files);
+
+      // Generate manifest
+      this.generateManifest(routes);
+
+      // Generate app.js (Express app)
+      this.generateAppJs(routes);
+
+      console.log(`✅ Compilation successful! Output: ${this.outputDir}`);
+      console.log(`📝 Routes registered: ${routes.length}`);
+      return true;
+    } catch (error) {
+      console.error(`❌ Compilation failed:`, error);
+      return false;
+    }
+  }
+
+  private ensureDirectories(): void {
+    if (!fs.existsSync(this.outputDir)) {
+      fs.mkdirSync(this.outputDir, { recursive: true });
+    }
+    if (!fs.existsSync(this.handlersDir)) {
+      fs.mkdirSync(this.handlersDir, { recursive: true });
+    }
+  }
+
+  private copyHandlers(files: ApiFile[]): void {
+    for (const file of files) {
+      // Change .ts to .js in output
+      let targetPath = path.join(this.handlersDir, file.relativePath);
+      if (targetPath.endsWith(".ts")) {
+        targetPath = targetPath.slice(0, -3) + ".js";
+      }
+
+      const targetDir = path.dirname(targetPath);
+
+      if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+      }
+
+      // Transpile TypeScript to JavaScript
+      if (file.relativePath.endsWith(".ts")) {
+        const transpiled = ts.transpileModule(file.content || "", {
+          compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 },
+        });
+        fs.writeFileSync(targetPath, transpiled.outputText, "utf-8");
+      } else {
+        // Plain JavaScript files - copy as-is
+        fs.writeFileSync(targetPath, file.content || "", "utf-8");
+      }
+    }
+  }
+
+  private generateManifest(routes: ApiRoute[]): void {
+    const manifest: Manifest = {
+      version: "1.0.0",
+      timestamp: new Date().toISOString(),
+      routes: routes.map((route) => ({
+        method: route.method,
+        path: route.path,
+        file: route.file,
+      })),
+    };
+
+    const manifestPath = path.join(this.outputDir, "manifest.json");
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
+  }
+
+  private generateAppJs(routes: ApiRoute[]): void {
+    const routeCode = routes
+      .map((route) => {
+        const methodLower = route.method.toLowerCase();
+        const importPath = `./${path.join("handlers", route.file).replace(/\\/g, "/")}`;
+        return `app.${methodLower}('${route.path}', async (req, res) => {
+  try {
+    const handler = require('${importPath}');
+    const fn = handler.${route.method};
+    if (!fn) return res.status(404).json({ error: 'Handler not found' });
+    
+    const result = await fn(req, { params: req.params });
+    res.status(result.status || 200).json(result.body || result);
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});`;
+      })
+      .join("\n\n");
+
+    const appCode = `const express = require('express');
+const app = express();
+
+app.use(express.json());
+
+// Routes from manifest
+${routeCode}
+
+module.exports = app;
+`;
+
+    const appPath = path.join(this.outputDir, "app.js");
+    fs.writeFileSync(appPath, appCode, "utf-8");
+  }
+}

package/src/core/router.ts

@@ -0,0 +1,88 @@
+import * as path from "path";
+import { ApiFile } from "./scanner";
+
+export interface ApiRoute {
+  method: string;
+  path: string;
+  file: string;
+  handlerName: string;
+}
+
+/**
+ * Router - converts file structure to API routes
+ * Maps:
+ *  - api/hello.js -> /hello (GET)
+ *  - api/users/index.js -> /users (GET)
+ *  - api/users/[id].js -> /users/:id (GET)
+ */
+export class Router {
+  /**
+   * Convert file path to route path
+   * Handles dynamic segments [id] -> :id
+   */
+  filePathToRoute(relativePath: string): string {
+    // Remove extension
+    const withoutExt = relativePath.replace(/\.(js|ts)$/, "");
+
+    // Split into parts
+    let parts = withoutExt.split(path.sep);
+
+    // Remove 'index' filename, keep directory
+    if (parts[parts.length - 1] === "index") {
+      parts = parts.slice(0, -1);
+    }
+
+    // Convert [id] to :id (dynamic segments)
+    parts = parts.map((part) => {
+      if (part.startsWith("[") && part.endsWith("]")) {
+        return `:${part.slice(1, -1)}`;
+      }
+      return part;
+    });
+
+    // Build route path
+    const route = "/" + parts.join("/");
+    return route === "/" ? "/" : route;
+  }
+
+  /**
+   * Extract HTTP methods from file content
+   * Looks for exports: GET, POST, PUT, DELETE, etc.
+   */
+  extractMethods(content: string): string[] {
+    const methods = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+    const foundMethods: string[] = [];
+
+    for (const method of methods) {
+      if (new RegExp(`export\\s+function\\s+${method}\\s*\\(|export\\s+const\\s+${method}\\s*=`).test(content)) {
+        foundMethods.push(method);
+      }
+    }
+
+    // Default to GET if no methods found
+    return foundMethods.length > 0 ? foundMethods : ["GET"];
+  }
+
+  /**
+   * Generate routes from API files
+   */
+  generateRoutes(files: ApiFile[]): ApiRoute[] {
+    const routes: ApiRoute[] = [];
+
+    for (const file of files) {
+      const routePath = this.filePathToRoute(file.relativePath);
+      const methods = this.extractMethods(file.content || "");
+
+      for (const method of methods) {
+        routes.push({
+          method,
+          path: routePath,
+          file: file.relativePath,
+          handlerName: method,
+        });
+      }
+    }
+
+    return routes;
+  }
+}