kastrick 1.0.0

package/README.md

@@ -0,0 +1,38 @@
+# Kastrick
+
+A simple API logic package for handling API requests and responses.
+
+## Installation
+
+```bash
+npm install kastrick
+```
+
+## Usage
+
+```typescript
+import ApiHandler from 'kastrick';
+
+const api = new ApiHandler('https://api.example.com');
+const response = await api.request('/users', { method: 'GET' });
+
+if (response.success) {
+  console.log(response.data);
+} else {
+  console.error(response.error);
+}
+```
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+```
+
+## License
+
+ISC

package/examples/01-hello-world/api/hello.ts

@@ -0,0 +1,19 @@
+export function GET(req: any) {
+  return {
+    status: 200,
+    body: {
+      message: "Hello World!",
+      timestamp: new Date().toISOString()
+    }
+  };
+}
+
+export function POST(req: any) {
+  return {
+    status: 201,
+    body: {
+      message: "Hello from POST",
+      received: req.body
+    }
+  };
+}

package/examples/02-users-api/README.md

@@ -0,0 +1,39 @@
+# Users Example
+
+This example shows how to create dynamic routes with parameters.
+
+## Routes Created
+
+- `GET /users` — List all users
+- `POST /users` — Create a user
+- `GET /users/:id` — Get specific user
+- `PUT /users/:id` — Update a user
+- `DELETE /users/:id` — Delete a user
+
+## File Structure
+
+```
+api/
+  users/
+    index.ts    → /users
+    [id].ts     → /users/:id
+```
+
+## Usage
+
+```bash
+# GET all users
+curl http://localhost:3000/users
+
+# Create user
+curl -X POST http://localhost:3000/users -d '{"name":"Kate"}' -H "Content-Type: application/json"
+
+# Get user by ID
+curl http://localhost:3000/users/1
+
+# Update user
+curl -X PUT http://localhost:3000/users/1 -d '{"name":"Updated"}' -H "Content-Type: application/json"
+
+# Delete user
+curl -X DELETE http://localhost:3000/users/1
+```

package/examples/02-users-api/api/users/[id].ts

@@ -0,0 +1,80 @@
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+// Mock database (shared with index.ts in real scenario)
+let users: User[] = [
+  { id: 1, name: "Kate", email: "kate@example.com" },
+  { id: 2, name: "Dev", email: "dev@example.com" }
+];
+
+export function GET(req: any, context: any) {
+  const { id } = context.params;
+  const user = users.find(u => u.id === parseInt(id));
+
+  if (!user) {
+    return {
+      status: 404,
+      body: {
+        error: "User not found"
+      }
+    };
+  }
+
+  return {
+    status: 200,
+    body: user
+  };
+}
+
+export function PUT(req: any, context: any) {
+  const { id } = context.params;
+  const { name, email } = req.body;
+  const user = users.find(u => u.id === parseInt(id));
+
+  if (!user) {
+    return {
+      status: 404,
+      body: {
+        error: "User not found"
+      }
+    };
+  }
+
+  if (name) user.name = name;
+  if (email) user.email = email;
+
+  return {
+    status: 200,
+    body: {
+      message: "User updated",
+      user
+    }
+  };
+}
+
+export function DELETE(req: any, context: any) {
+  const { id } = context.params;
+  const index = users.findIndex(u => u.id === parseInt(id));
+
+  if (index === -1) {
+    return {
+      status: 404,
+      body: {
+        error: "User not found"
+      }
+    };
+  }
+
+  const [deletedUser] = users.splice(index, 1);
+
+  return {
+    status: 200,
+    body: {
+      message: "User deleted",
+      user: deletedUser
+    }
+  };
+}

package/examples/02-users-api/api/users/index.ts

@@ -0,0 +1,50 @@
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+// Mock database
+let users: User[] = [
+  { id: 1, name: "Kate", email: "kate@example.com" },
+  { id: 2, name: "Dev", email: "dev@example.com" }
+];
+
+export function GET(req: any) {
+  return {
+    status: 200,
+    body: {
+      users,
+      total: users.length
+    }
+  };
+}
+
+export function POST(req: any) {
+  const { name, email } = req.body;
+  
+  if (!name || !email) {
+    return {
+      status: 400,
+      body: {
+        error: "name and email required"
+      }
+    };
+  }
+
+  const newUser: User = {
+    id: Math.max(...users.map(u => u.id), 0) + 1,
+    name,
+    email
+  };
+
+  users.push(newUser);
+
+  return {
+    status: 201,
+    body: {
+      message: "User created",
+      user: newUser
+    }
+  };
+}

package/examples/03-configuration/README.md

@@ -0,0 +1,39 @@
+# Configuration Example
+
+Shows how to configure a kastrick API project.
+
+## kastrick.config.json
+
+Main config file for your API project with options for:
+
+- **apiDir** — Where API files are located (default: `./api`)
+- **outputDir** — Compiled output directory (default: `./output`)
+- **devPort** — Port for dev server (default: `3000`)
+- **environment** — `development` or `production`
+- **middleware** — Enable/configure Express middleware
+- **headers** — Custom headers to add to all responses
+- **logging** — Logging configuration
+
+## tsconfig.json
+
+Custom TypeScript configuration. Kastrick provides defaults but you can override:
+
+- **target** — JavaScript target version
+- **strict** — Enable strict type checking
+- **rootDir** — API source directory
+- **outDir** — Compiled output directory
+
+## Usage
+
+```bash
+# Dev mode with custom config
+npx kastrick dev
+
+# Compile with custom config
+npx kastrick compile
+
+# Serve with custom config
+npx kastrick serve 3000
+```
+
+Kastrick automatically reads both config files if present!

package/examples/03-configuration/kastrick.config.json

@@ -0,0 +1,22 @@
+{
+  "name": "my-api",
+  "version": "1.0.0",
+  "apiDir": "./api",
+  "outputDir": "./output",
+  "devPort": 3000,
+  "environment": "development",
+  "middleware": {
+    "cors": true,
+    "bodyParser": {
+      "limit": "10mb"
+    }
+  },
+  "headers": {
+    "X-API-Version": "1.0.0",
+    "X-Powered-By": "kastrick"
+  },
+  "logging": {
+    "enabled": true,
+    "level": "info"
+  }
+}

package/examples/03-configuration/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "rootDir": "./api",
+    "outDir": "./output",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node"
+  },
+  "include": ["api/**/*"],
+  "exclude": ["node_modules", "output"]
+}

package/examples/README.md

@@ -0,0 +1,48 @@
+# Kastrick Examples
+
+Clean examples of how developers use kastrick to build APIs.
+
+## Setup
+
+```bash
+mkdir my-api
+cd my-api
+npm init -y
+npm install kastrick
+npx kastrick --version
+```
+
+## Project Structure
+
+```
+my-api/
+  api/
+    hello.ts
+    users/
+      index.ts
+      [id].ts
+  kastrick.config.json
+  tsconfig.json (optional - kastrick provides defaults)
+  package.json
+```
+
+## Running
+
+```bash
+# Dev mode (auto-compile + hot reload)
+npx kastrick dev
+
+# Compile only
+npx kastrick compile
+
+# Serve compiled output
+npx kastrick serve 3000
+```
+
+## Examples Included
+
+- **Basic Route** — `hello.ts` - Simple GET endpoint
+- **Users API** — Dynamic routes with parameters
+- **Configuration** — Setting up your API with config file
+
+See each folder for complete examples!

package/lib/cli/compile.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compile command - builds the /output folder
+ */
+export declare function compile(rootDir?: string): Promise<void>;
+//# sourceMappingURL=compile.d.ts.map

package/lib/cli/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/cli/compile.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB5E"}

package/lib/cli/compile.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compile = compile;
+const scanner_1 = require("../core/scanner");
+const compiler_1 = require("../core/compiler");
+/**
+ * Compile command - builds the /output folder
+ */
+async function compile(rootDir = process.cwd()) {
+    console.log("🔨 Compiling kastrick project...\n");
+    const scanner = new scanner_1.Scanner(rootDir);
+    const compiler = new compiler_1.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);
+}
+//# sourceMappingURL=compile.js.map

package/lib/cli/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/cli/compile.ts"],"names":[],"mappings":";;AAMA,0BAoBC;AA1BD,6CAA0C;AAC1C,+CAA4C;AAE5C;;GAEG;AACI,KAAK,UAAU,OAAO,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IAC3D,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,OAAO,CAAC,CAAC;IAEvC,kBAAkB;IAClB,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAEtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC;IAClD,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,UAAU;IACV,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC"}

package/lib/cli/dev.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Dev command - starts dev server with hot reload
+ */
+export declare function dev(port?: number, rootDir?: string): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/lib/cli/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAa,EAAE,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC7F"}

package/lib/cli/dev.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dev = dev;
+const scanner_1 = require("../core/scanner");
+const expressServer_1 = require("../server/expressServer");
+const chokidar = __importStar(require("chokidar"));
+const path = __importStar(require("path"));
+/**
+ * Dev command - starts dev server with hot reload
+ */
+async function dev(port = 3000, rootDir = process.cwd()) {
+    console.log("🚀 Starting kastrick dev server...\n");
+    const scanner = new scanner_1.Scanner(rootDir);
+    const server = new expressServer_1.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);
+    });
+}
+//# sourceMappingURL=dev.js.map

package/lib/cli/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,kBAwCC;AAhDD,6CAA0C;AAC1C,2DAAwD;AACxD,mDAAqC;AACrC,2CAA6B;AAE7B;;GAEG;AACI,KAAK,UAAU,GAAG,CAAC,OAAe,IAAI,EAAE,UAAkB,OAAO,CAAC,GAAG,EAAE;IAC5E,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,6BAAa,CAAC,IAAI,CAAC,CAAC;IAEvC,mBAAmB;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,CAAC;IAEf,oBAAoB;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE;QACtC,OAAO,EAAE,2BAA2B;QACpC,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;QACrB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/lib/cli/index.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const compile_1 = require("./compile");
+const dev_1 = require("./dev");
+const serve_1 = require("./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 (0, compile_1.compile)();
+                break;
+            case "dev":
+                await (0, dev_1.dev)(port);
+                break;
+            case "serve":
+                await (0, serve_1.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) {
+        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();
+//# sourceMappingURL=index.js.map

package/lib/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AAEA,uCAAoC;AACpC,+BAA4B;AAC5B,mCAAgC;AAEhC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAErE,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,SAAS;gBACZ,MAAM,IAAA,iBAAO,GAAE,CAAC;gBAChB,MAAM;YACR,KAAK,KAAK;gBACR,MAAM,IAAA,SAAG,EAAC,IAAI,CAAC,CAAC;gBAChB,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,IAAA,aAAK,EAAC,IAAI,CAAC,CAAC;gBAClB,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,QAAQ,EAAE,CAAC;gBACX,MAAM;YACR;gBACE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;gBAC3C,QAAQ,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;GAmBX,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC"}

package/lib/cli/serve.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Serve command - runs compiled Express app from /output folder
+ */
+export declare function serve(port?: number, rootDir?: string): Promise<void>;
+//# sourceMappingURL=serve.d.ts.map

package/lib/cli/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/cli/serve.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAsB,KAAK,CAAC,IAAI,GAAE,MAAa,EAAE,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE/F"}