kastrick 1.0.0 → 1.0.1

package/lib/core/backendAPI.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Backend API Helper - Cleaner API handler definition
+ * Provides a simple interface for defining API endpoints
+ */
+export interface ApiContext {
+    params?: Record<string, any>;
+    query?: Record<string, any>;
+    body?: any;
+}
+export interface ApiHandlerResponse {
+    status?: number;
+    body?: any;
+    headers?: Record<string, string>;
+}
+export type RequestHandler = (req: any, context?: ApiContext) => ApiHandlerResponse | Promise<ApiHandlerResponse>;
+export interface BackendAPIConfig {
+    GET?: RequestHandler;
+    POST?: RequestHandler;
+    PUT?: RequestHandler;
+    DELETE?: RequestHandler;
+    PATCH?: RequestHandler;
+    HEAD?: RequestHandler;
+    OPTIONS?: RequestHandler;
+}
+/**
+ * Create a backend API handler with cleaner syntax
+ *
+ * @example
+ * export const API = backendAPI({
+ *   GET: (req, ctx) => ({
+ *     status: 200,
+ *     body: { message: "Hello World" }
+ *   }),
+ *   POST: (req, ctx) => ({
+ *     status: 201,
+ *     body: { created: true }
+ *   })
+ * });
+ */
+export declare function backendAPI(config: BackendAPIConfig): BackendAPIConfig;
+/**
+ * Export handlers individually (for direct function export pattern)
+ */
+export declare function createHandlers(config: BackendAPIConfig): any;
+/**
+ * Validate and normalize API response
+ */
+export declare function normalizeResponse(response: any): ApiHandlerResponse;
+/**
+ * Create context from Express request
+ */
+export declare function createContext(req: any, params?: any): ApiContext;
+export default backendAPI;
+//# sourceMappingURL=backendAPI.d.ts.map

package/lib/core/backendAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendAPI.d.ts","sourceRoot":"","sources":["../../src/core/backendAPI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,UAAU,KACjB,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAErE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,OAUtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,GAAG,GACZ,kBAAkB,CAiBpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,UAAU,CAMhE;AAED,eAAe,UAAU,CAAC"}

package/lib/core/backendAPI.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Backend API Helper - Cleaner API handler definition
+ * Provides a simple interface for defining API endpoints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backendAPI = backendAPI;
+exports.createHandlers = createHandlers;
+exports.normalizeResponse = normalizeResponse;
+exports.createContext = createContext;
+/**
+ * Create a backend API handler with cleaner syntax
+ *
+ * @example
+ * export const API = backendAPI({
+ *   GET: (req, ctx) => ({
+ *     status: 200,
+ *     body: { message: "Hello World" }
+ *   }),
+ *   POST: (req, ctx) => ({
+ *     status: 201,
+ *     body: { created: true }
+ *   })
+ * });
+ */
+function backendAPI(config) {
+    return config;
+}
+/**
+ * Export handlers individually (for direct function export pattern)
+ */
+function createHandlers(config) {
+    const handlers = {};
+    for (const [method, handler] of Object.entries(config)) {
+        if (handler) {
+            handlers[method] = handler;
+        }
+    }
+    return handlers;
+}
+/**
+ * Validate and normalize API response
+ */
+function normalizeResponse(response) {
+    if (!response) {
+        return { status: 200, body: {} };
+    }
+    if (typeof response === "object" && "status" in response) {
+        return {
+            status: response.status || 200,
+            body: response.body !== undefined ? response.body : response,
+            headers: response.headers,
+        };
+    }
+    return {
+        status: 200,
+        body: response,
+    };
+}
+/**
+ * Create context from Express request
+ */
+function createContext(req, params) {
+    return {
+        params: params || req.params || {},
+        query: req.query || {},
+        body: req.body,
+    };
+}
+exports.default = backendAPI;
+//# sourceMappingURL=backendAPI.js.map

package/lib/core/backendAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendAPI.js","sourceRoot":"","sources":["../../src/core/backendAPI.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA4CH,gCAEC;AAKD,wCAUC;AAKD,8CAmBC;AAKD,sCAMC;AAnED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,UAAU,CAAC,MAAwB;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAwB;IACrD,MAAM,QAAQ,GAAQ,EAAE,CAAC;IAEzB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,QAAa;IAEb,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;QACzD,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,GAAG;YAC9B,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;YAC5D,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,QAAQ;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,GAAQ,EAAE,MAAY;IAClD,OAAO;QACL,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE;QAClC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC;AACJ,CAAC;AAED,kBAAe,UAAU,CAAC"}

package/lib/index.d.ts

@@ -8,5 +8,10 @@ export declare class ApiHandler {
     constructor(baseUrl: string);
     request<T>(endpoint: string, options?: RequestInit): Promise<ApiResponse<T>>;
 }
+export { backendAPI, createHandlers, normalizeResponse, createContext, type RequestHandler, type ApiContext, type ApiHandlerResponse, type BackendAPIConfig, } from './core/backendAPI';
+export { Compiler, type Manifest, type ManifestRoute } from './core/compiler';
+export { ExpressServer } from './server/expressServer';
+export { Router } from './core/router';
+export { Scanner, type ApiFile } from './core/scanner';
 export default ApiHandler;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE7B,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAuBnF;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE7B,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAuBnF;AAGD,OAAO,EACL,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEvD,eAAe,UAAU,CAAC"}

package/lib/index.js

@@ -2,7 +2,7 @@
 // Kastrick API Logic Package
 // Main entry point
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiHandler = void 0;
+exports.Scanner = exports.Router = exports.ExpressServer = exports.Compiler = exports.createContext = exports.normalizeResponse = exports.createHandlers = exports.backendAPI = exports.ApiHandler = void 0;
 class ApiHandler {
     constructor(baseUrl) {
         this.baseUrl = baseUrl;
@@ -31,5 +31,20 @@ class ApiHandler {
     }
 }
 exports.ApiHandler = ApiHandler;
+// Export backend API helpers
+var backendAPI_1 = require("./core/backendAPI");
+Object.defineProperty(exports, "backendAPI", { enumerable: true, get: function () { return backendAPI_1.backendAPI; } });
+Object.defineProperty(exports, "createHandlers", { enumerable: true, get: function () { return backendAPI_1.createHandlers; } });
+Object.defineProperty(exports, "normalizeResponse", { enumerable: true, get: function () { return backendAPI_1.normalizeResponse; } });
+Object.defineProperty(exports, "createContext", { enumerable: true, get: function () { return backendAPI_1.createContext; } });
+// Export server and compiler classes
+var compiler_1 = require("./core/compiler");
+Object.defineProperty(exports, "Compiler", { enumerable: true, get: function () { return compiler_1.Compiler; } });
+var expressServer_1 = require("./server/expressServer");
+Object.defineProperty(exports, "ExpressServer", { enumerable: true, get: function () { return expressServer_1.ExpressServer; } });
+var router_1 = require("./core/router");
+Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return router_1.Router; } });
+var scanner_1 = require("./core/scanner");
+Object.defineProperty(exports, "Scanner", { enumerable: true, get: function () { return scanner_1.Scanner; } });
 exports.default = ApiHandler;
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,mBAAmB;;;AAQnB,MAAa,UAAU;IACrB,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEvC,KAAK,CAAC,OAAO,CAAI,QAAgB,EAAE,OAAqB;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;YACpE,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAExC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,gBAAgB,CAAW;iBACnD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAS;aAChB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA1BD,gCA0BC;AAED,kBAAe,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,mBAAmB;;;AAQnB,MAAa,UAAU;IACrB,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEvC,KAAK,CAAC,OAAO,CAAI,QAAgB,EAAE,OAAqB;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;YACpE,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAExC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,gBAAgB,CAAW;iBACnD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAS;aAChB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA1BD,gCA0BC;AAED,6BAA6B;AAC7B,gDAS2B;AARzB,wGAAA,UAAU,OAAA;AACV,4GAAA,cAAc,OAAA;AACd,+GAAA,iBAAiB,OAAA;AACjB,2GAAA,aAAa,OAAA;AAOf,qCAAqC;AACrC,4CAA8E;AAArE,oGAAA,QAAQ,OAAA;AACjB,wDAAuD;AAA9C,8GAAA,aAAa,OAAA;AACtB,wCAAuC;AAA9B,gGAAA,MAAM,OAAA;AACf,0CAAuD;AAA9C,kGAAA,OAAO,OAAA;AAEhB,kBAAe,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kastrick",
-  "version": "1.0.0",
+  "version": "1.0.001",
   "description": "a Easy Tool for Kastrick Services and Devoloper Experience",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/core/backendAPI.ts

@@ -0,0 +1,102 @@
+/**
+ * Backend API Helper - Cleaner API handler definition
+ * Provides a simple interface for defining API endpoints
+ */
+
+export interface ApiContext {
+  params?: Record<string, any>;
+  query?: Record<string, any>;
+  body?: any;
+}
+
+export interface ApiHandlerResponse {
+  status?: number;
+  body?: any;
+  headers?: Record<string, string>;
+}
+
+export type RequestHandler = (
+  req: any,
+  context?: ApiContext
+) => ApiHandlerResponse | Promise<ApiHandlerResponse>;
+
+export interface BackendAPIConfig {
+  GET?: RequestHandler;
+  POST?: RequestHandler;
+  PUT?: RequestHandler;
+  DELETE?: RequestHandler;
+  PATCH?: RequestHandler;
+  HEAD?: RequestHandler;
+  OPTIONS?: RequestHandler;
+}
+
+/**
+ * Create a backend API handler with cleaner syntax
+ * 
+ * @example
+ * export const API = backendAPI({
+ *   GET: (req, ctx) => ({
+ *     status: 200,
+ *     body: { message: "Hello World" }
+ *   }),
+ *   POST: (req, ctx) => ({
+ *     status: 201,
+ *     body: { created: true }
+ *   })
+ * });
+ */
+export function backendAPI(config: BackendAPIConfig): BackendAPIConfig {
+  return config;
+}
+
+/**
+ * Export handlers individually (for direct function export pattern)
+ */
+export function createHandlers(config: BackendAPIConfig) {
+  const handlers: any = {};
+
+  for (const [method, handler] of Object.entries(config)) {
+    if (handler) {
+      handlers[method] = handler;
+    }
+  }
+
+  return handlers;
+}
+
+/**
+ * Validate and normalize API response
+ */
+export function normalizeResponse(
+  response: any
+): ApiHandlerResponse {
+  if (!response) {
+    return { status: 200, body: {} };
+  }
+
+  if (typeof response === "object" && "status" in response) {
+    return {
+      status: response.status || 200,
+      body: response.body !== undefined ? response.body : response,
+      headers: response.headers,
+    };
+  }
+
+  return {
+    status: 200,
+    body: response,
+  };
+}
+
+/**
+ * Create context from Express request
+ */
+export function createContext(req: any, params?: any): ApiContext {
+  return {
+    params: params || req.params || {},
+    query: req.query || {},
+    body: req.body,
+  };
+}
+
+export default backendAPI;

package/src/index.ts

@@ -35,4 +35,22 @@ export class ApiHandler {
   }
 }
 
+// Export backend API helpers
+export {
+  backendAPI,
+  createHandlers,
+  normalizeResponse,
+  createContext,
+  type RequestHandler,
+  type ApiContext,
+  type ApiHandlerResponse,
+  type BackendAPIConfig,
+} from './core/backendAPI';
+
+// Export server and compiler classes
+export { Compiler, type Manifest, type ManifestRoute } from './core/compiler';
+export { ExpressServer } from './server/expressServer';
+export { Router } from './core/router';
+export { Scanner, type ApiFile } from './core/scanner';
+
 export default ApiHandler;