@mahameru/diatrema 0.0.0

package/module-error.d.cts

@@ -0,0 +1,12 @@
+declare class ModuleError extends Error {
+    readonly detail?: {
+        path: string;
+        moduleName: string;
+    };
+    constructor(message: string, detail?: {
+        path: string;
+        moduleName: string;
+    });
+}
+
+export { ModuleError };

package/module-error.d.ts

@@ -0,0 +1,12 @@
+declare class ModuleError extends Error {
+    readonly detail?: {
+        path: string;
+        moduleName: string;
+    };
+    constructor(message: string, detail?: {
+        path: string;
+        moduleName: string;
+    });
+}
+
+export { ModuleError };

package/module-error.js

@@ -0,0 +1,23 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class ModuleError extends Error {
+  static {
+    __name(this, "ModuleError");
+  }
+  detail;
+  constructor(message, detail) {
+    super(message);
+    if (detail) {
+      this.detail = {
+        path: detail.path,
+        moduleName: detail.moduleName || "UNKNOWN"
+      };
+    }
+    Object.setPrototypeOf(this, ModuleError.prototype);
+    delete this.stack;
+  }
+}
+export {
+  ModuleError
+};
+//# sourceMappingURL=module-error.js.map

package/module-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/module-error.ts"],"sourcesContent":["export class ModuleError extends Error {\r\n    public readonly detail?: {\r\n        path: string;\r\n        moduleName: string;\r\n    };\r\n\r\n    constructor(message: string, detail?: { path: string; moduleName: string }) {\r\n        super(message);\r\n\r\n        if (detail) {\r\n            this.detail = {\r\n                path: detail.path,\r\n                moduleName: detail.moduleName || 'UNKNOWN'\r\n            };\r\n        }\r\n\r\n        Object.setPrototypeOf(this, ModuleError.prototype);\r\n\r\n        delete this.stack;\r\n    }\r\n}\r\n"],"mappings":";;AAAO,MAAM,oBAAoB,MAAM;AAAA,EAAvC,OAAuC;AAAA;AAAA;AAAA,EACnB;AAAA,EAKhB,YAAY,SAAiB,QAA+C;AACxE,UAAM,OAAO;AAEb,QAAI,QAAQ;AACR,WAAK,SAAS;AAAA,QACV,MAAM,OAAO;AAAA,QACb,YAAY,OAAO,cAAc;AAAA,MACrC;AAAA,IACJ;AAEA,WAAO,eAAe,MAAM,YAAY,SAAS;AAEjD,WAAO,KAAK;AAAA,EAChB;AACJ;","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@mahameru/diatrema",
+  "version": "0.0.0",
+  "description": "The core engine of MahameruJS. Just like a volcanic diatreme, it serves as the essential conduit that powers and drives the entire framework ecosystem.",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.cjs"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit --project tsconfig.json",
+    "build": "tsup --config tsup.config.ts && node ./scripts/post-build.js",
+    "dev": "cross-env NODE_ENV=development tsup --config tsup.config.ts && node ./scripts/post-build.js"
+  },
+  "keywords": [
+    "node",
+    "framework",
+    "mahameru",
+    "mahamerujs",
+    "core",
+    "diatrema",
+    "core-engine"
+  ],
+  "author": "Bintan <hello@bintvn.co>",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "cross-env": "^10.1.0",
+    "esbuild-fix-imports-plugin": "^1.0.23",
+    "tsup": "^8.5.1",
+    "type-fest": "^5.8.0",
+    "typescript": "^6.0.3"
+  }
+}

package/route.cjs

@@ -0,0 +1,128 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var route_exports = {};
+__export(route_exports, {
+  Route: () => Route
+});
+module.exports = __toCommonJS(route_exports);
+var import_node_path = require("node:path");
+class Route {
+  static {
+    __name(this, "Route");
+  }
+  options = {
+    dev: false,
+    routesPath: (0, import_node_path.join)(process.cwd(), ".mahameru", "routes")
+  };
+  dependencies;
+  constructor(arg1, arg2) {
+    if (typeof arg2 !== "undefined")
+      this.options = { ...this.options, ...arg1 };
+    if (typeof arg2 !== "undefined") {
+      this.dependencies = arg2;
+    } else {
+      this.dependencies = arg1;
+    }
+  }
+  normalizePathForMatching(path) {
+    if (path.length > 1 && path.endsWith("/")) {
+      return path.slice(0, -1);
+    }
+    return path;
+  }
+  findMatchedRoute(matchUrl) {
+    let matchedRoute = null;
+    let matchResult = null;
+    for (const route of this.dependencies.container.getRouteItems()) {
+      const result = route.regex.exec(matchUrl);
+      if (result) {
+        matchedRoute = route;
+        matchResult = result;
+        break;
+      }
+    }
+    return { matchedRoute, matchResult };
+  }
+  async runNotFoundHandler(request, method) {
+    if (!this.dependencies.container.notFoundHandler)
+      return void 0;
+    const handler = this.dependencies.container.notFoundHandler[method];
+    if (typeof handler !== "function") {
+      return void 0;
+    }
+    const response = await handler(request, this.dependencies.container, { params: {} });
+    return this.normalizeMahameruResponse(
+      response,
+      `Not found handler for method '${method}' must return a MahameruResponse instance.`
+    );
+  }
+  async resolveRoute(request) {
+    const rawReqPath = request.url.split("?")[0] || "/";
+    const rawReqUrl = rawReqPath.replace(/\/+/g, "/");
+    const matchUrl = this.normalizePathForMatching(rawReqUrl);
+    let { matchedRoute, matchResult } = this.findMatchedRoute(matchUrl);
+    if (!matchedRoute || !matchResult)
+      return {
+        matchedRoute: null,
+        matchResult: null,
+        notFoundResponse: await this.runNotFoundHandler(request, request.method) || this.dependencies.MahameruResponse.json(
+          { error: "Not Found" },
+          { status: 404 }
+        )
+      };
+    return { matchedRoute, matchResult };
+  }
+  isMahameruResponseLike(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    if (!("status" in value) || typeof value.status !== "number") {
+      return false;
+    }
+    if (!("body" in value)) {
+      return false;
+    }
+    if (!("headers" in value) || value.headers === void 0) {
+      return true;
+    }
+    if (value.headers instanceof Headers) {
+      return true;
+    }
+    return typeof value.headers === "object" && value.headers !== null && !Array.isArray(value.headers);
+  }
+  normalizeMahameruResponse(value, errorMessage) {
+    if (value instanceof this.dependencies.MahameruResponse) {
+      return value;
+    }
+    if (!this.isMahameruResponseLike(value)) {
+      throw new this.dependencies.HttpServerError(errorMessage);
+    }
+    const normalizedHeaders = value.headers instanceof Headers ? Object.fromEntries(value.headers.entries()) : value.headers;
+    return new this.dependencies.MahameruResponse(value.body, {
+      status: value.status,
+      headers: normalizedHeaders
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Route
+});
+//# sourceMappingURL=route.cjs.map

package/route.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/route.ts"],"sourcesContent":["import { join } from 'node:path';\n\nimport type { MahameruRequest } from './mahameru-request';\nimport type { MahameruResponse } from './mahameru-response';\nimport type { Container } from './container';\nimport type { HttpServerError } from './http-server-error';\nimport type { HTTPMethod, RouteHandlerContext, RouteItem } from './types';\n\nexport type RouteOptions = {\n    dev: boolean;\n    routesPath: string;\n};\n\nexport type RouteDependencies = {\n    container: Container;\n    HttpServerError: typeof HttpServerError;\n    MahameruResponse: typeof MahameruResponse;\n};\n\nexport class Route {\n    public readonly options: RouteOptions = {\n        dev: false,\n        routesPath: join(process.cwd(), '.mahameru', 'routes')\n    }\n    protected dependencies: RouteDependencies;\n\n    constructor(\n        dependencies: RouteDependencies\n    )\n    constructor(\n        options: Partial<RouteOptions>,\n        dependencies: RouteDependencies\n    )\n    constructor(\n        arg1: Partial<RouteOptions> | RouteDependencies,\n        arg2?: RouteDependencies\n    ) {\n        if (typeof arg2 !== 'undefined')\n            this.options = { ...this.options, ...arg1 as Partial<RouteOptions> };\n\n        if (typeof arg2 !== 'undefined') {\n            this.dependencies = arg2;\n        } else {\n            this.dependencies = arg1 as RouteDependencies;\n        }\n    }\n\n    normalizePathForMatching(path: string): string {\n        if (path.length > 1 && path.endsWith('/')) {\n            return path.slice(0, -1);\n        }\n\n        return path;\n    }\n\n    findMatchedRoute(matchUrl: string) {\n        let matchedRoute: RouteItem | null = null;\n        let matchResult: RegExpExecArray | null = null;\n\n        for (const route of this.dependencies.container.getRouteItems()) {\n            const result = route.regex.exec(matchUrl);\n\n            if (result) {\n                matchedRoute = route;\n                matchResult = result;\n\n                break;\n            }\n        }\n\n        return { matchedRoute, matchResult };\n    }\n\n    async runNotFoundHandler(request: MahameruRequest, method: HTTPMethod): Promise<MahameruResponse | undefined> {\n        if (!this.dependencies.container.notFoundHandler)\n            return undefined;\n\n        const handler = this.dependencies.container.notFoundHandler[method];\n\n        if (typeof handler !== 'function') {\n            return undefined;\n        }\n\n        const response = await handler(request, this.dependencies.container, { params: {} } satisfies RouteHandlerContext);\n\n        return this.normalizeMahameruResponse(\n            response,\n            `Not found handler for method '${method}' must return a MahameruResponse instance.`\n        );\n    }\n\n    async resolveRoute(request: MahameruRequest) {\n        const rawReqPath = request.url.split('?')[0] || '/';\n        const rawReqUrl = rawReqPath.replace(/\\/+/g, '/');\n        const matchUrl = this.normalizePathForMatching(rawReqUrl);\n\n        let { matchedRoute, matchResult } = this.findMatchedRoute(matchUrl);\n\n        if (!matchedRoute || !matchResult)\n            return {\n                matchedRoute: null,\n                matchResult: null,\n                notFoundResponse: await this.runNotFoundHandler(request, request.method) || this.dependencies.MahameruResponse.json(\n                    { error: 'Not Found' },\n                    { status: 404 }\n                )\n            };\n\n        return { matchedRoute, matchResult };\n    }\n\n    protected isMahameruResponseLike(value: unknown): value is { body: unknown; status: number; headers?: Headers | Record<string, string> } {\n        if (!value || typeof value !== 'object') {\n            return false;\n        }\n\n        if (!('status' in value) || typeof value.status !== 'number') {\n            return false;\n        }\n\n        if (!('body' in value)) {\n            return false;\n        }\n\n        if (!('headers' in value) || value.headers === undefined) {\n            return true;\n        }\n\n        if (value.headers instanceof Headers) {\n            return true;\n        }\n\n        return typeof value.headers === 'object' && value.headers !== null && !Array.isArray(value.headers);\n    }\n\n    protected normalizeMahameruResponse(value: unknown, errorMessage: string): MahameruResponse {\n        if (value instanceof this.dependencies.MahameruResponse) {\n            return value;\n        }\n\n        if (!this.isMahameruResponseLike(value)) {\n            throw new this.dependencies.HttpServerError(errorMessage);\n        }\n\n        const normalizedHeaders = value.headers instanceof Headers\n            ? Object.fromEntries(value.headers.entries())\n            : value.headers;\n\n        return new this.dependencies.MahameruResponse(value.body, {\n            status: value.status,\n            headers: normalizedHeaders\n        });\n    }\n}\n"],"mappings":"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","names":[]}

package/route.d.cts

@@ -0,0 +1,46 @@
+import { p as RouteItem, j as MahameruRequest, H as HTTPMethod } from './types-CipcRmc9.cjs';
+import { MahameruResponse } from './mahameru-response.cjs';
+import { Container } from './container.cjs';
+import { HttpServerError } from './http-server-error.cjs';
+import 'node:http';
+import './container-error.cjs';
+import './module-error.cjs';
+
+type RouteOptions = {
+    dev: boolean;
+    routesPath: string;
+};
+type RouteDependencies = {
+    container: Container;
+    HttpServerError: typeof HttpServerError;
+    MahameruResponse: typeof MahameruResponse;
+};
+declare class Route {
+    readonly options: RouteOptions;
+    protected dependencies: RouteDependencies;
+    constructor(dependencies: RouteDependencies);
+    constructor(options: Partial<RouteOptions>, dependencies: RouteDependencies);
+    normalizePathForMatching(path: string): string;
+    findMatchedRoute(matchUrl: string): {
+        matchedRoute: RouteItem | null;
+        matchResult: RegExpExecArray | null;
+    };
+    runNotFoundHandler(request: MahameruRequest, method: HTTPMethod): Promise<MahameruResponse | undefined>;
+    resolveRoute(request: MahameruRequest): Promise<{
+        matchedRoute: null;
+        matchResult: null;
+        notFoundResponse: MahameruResponse;
+    } | {
+        matchedRoute: RouteItem;
+        matchResult: RegExpExecArray;
+        notFoundResponse?: undefined;
+    }>;
+    protected isMahameruResponseLike(value: unknown): value is {
+        body: unknown;
+        status: number;
+        headers?: Headers | Record<string, string>;
+    };
+    protected normalizeMahameruResponse(value: unknown, errorMessage: string): MahameruResponse;
+}
+
+export { Route, type RouteDependencies, type RouteOptions };

package/route.d.ts

@@ -0,0 +1,46 @@
+import { p as RouteItem, j as MahameruRequest, H as HTTPMethod } from './types-BRwWYiUN.js';
+import { MahameruResponse } from './mahameru-response.js';
+import { Container } from './container.js';
+import { HttpServerError } from './http-server-error.js';
+import 'node:http';
+import './container-error.js';
+import './module-error.js';
+
+type RouteOptions = {
+    dev: boolean;
+    routesPath: string;
+};
+type RouteDependencies = {
+    container: Container;
+    HttpServerError: typeof HttpServerError;
+    MahameruResponse: typeof MahameruResponse;
+};
+declare class Route {
+    readonly options: RouteOptions;
+    protected dependencies: RouteDependencies;
+    constructor(dependencies: RouteDependencies);
+    constructor(options: Partial<RouteOptions>, dependencies: RouteDependencies);
+    normalizePathForMatching(path: string): string;
+    findMatchedRoute(matchUrl: string): {
+        matchedRoute: RouteItem | null;
+        matchResult: RegExpExecArray | null;
+    };
+    runNotFoundHandler(request: MahameruRequest, method: HTTPMethod): Promise<MahameruResponse | undefined>;
+    resolveRoute(request: MahameruRequest): Promise<{
+        matchedRoute: null;
+        matchResult: null;
+        notFoundResponse: MahameruResponse;
+    } | {
+        matchedRoute: RouteItem;
+        matchResult: RegExpExecArray;
+        notFoundResponse?: undefined;
+    }>;
+    protected isMahameruResponseLike(value: unknown): value is {
+        body: unknown;
+        status: number;
+        headers?: Headers | Record<string, string>;
+    };
+    protected normalizeMahameruResponse(value: unknown, errorMessage: string): MahameruResponse;
+}
+
+export { Route, type RouteDependencies, type RouteOptions };

package/route.js

@@ -0,0 +1,105 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { join } from "node:path";
+class Route {
+  static {
+    __name(this, "Route");
+  }
+  options = {
+    dev: false,
+    routesPath: join(process.cwd(), ".mahameru", "routes")
+  };
+  dependencies;
+  constructor(arg1, arg2) {
+    if (typeof arg2 !== "undefined")
+      this.options = { ...this.options, ...arg1 };
+    if (typeof arg2 !== "undefined") {
+      this.dependencies = arg2;
+    } else {
+      this.dependencies = arg1;
+    }
+  }
+  normalizePathForMatching(path) {
+    if (path.length > 1 && path.endsWith("/")) {
+      return path.slice(0, -1);
+    }
+    return path;
+  }
+  findMatchedRoute(matchUrl) {
+    let matchedRoute = null;
+    let matchResult = null;
+    for (const route of this.dependencies.container.getRouteItems()) {
+      const result = route.regex.exec(matchUrl);
+      if (result) {
+        matchedRoute = route;
+        matchResult = result;
+        break;
+      }
+    }
+    return { matchedRoute, matchResult };
+  }
+  async runNotFoundHandler(request, method) {
+    if (!this.dependencies.container.notFoundHandler)
+      return void 0;
+    const handler = this.dependencies.container.notFoundHandler[method];
+    if (typeof handler !== "function") {
+      return void 0;
+    }
+    const response = await handler(request, this.dependencies.container, { params: {} });
+    return this.normalizeMahameruResponse(
+      response,
+      `Not found handler for method '${method}' must return a MahameruResponse instance.`
+    );
+  }
+  async resolveRoute(request) {
+    const rawReqPath = request.url.split("?")[0] || "/";
+    const rawReqUrl = rawReqPath.replace(/\/+/g, "/");
+    const matchUrl = this.normalizePathForMatching(rawReqUrl);
+    let { matchedRoute, matchResult } = this.findMatchedRoute(matchUrl);
+    if (!matchedRoute || !matchResult)
+      return {
+        matchedRoute: null,
+        matchResult: null,
+        notFoundResponse: await this.runNotFoundHandler(request, request.method) || this.dependencies.MahameruResponse.json(
+          { error: "Not Found" },
+          { status: 404 }
+        )
+      };
+    return { matchedRoute, matchResult };
+  }
+  isMahameruResponseLike(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    if (!("status" in value) || typeof value.status !== "number") {
+      return false;
+    }
+    if (!("body" in value)) {
+      return false;
+    }
+    if (!("headers" in value) || value.headers === void 0) {
+      return true;
+    }
+    if (value.headers instanceof Headers) {
+      return true;
+    }
+    return typeof value.headers === "object" && value.headers !== null && !Array.isArray(value.headers);
+  }
+  normalizeMahameruResponse(value, errorMessage) {
+    if (value instanceof this.dependencies.MahameruResponse) {
+      return value;
+    }
+    if (!this.isMahameruResponseLike(value)) {
+      throw new this.dependencies.HttpServerError(errorMessage);
+    }
+    const normalizedHeaders = value.headers instanceof Headers ? Object.fromEntries(value.headers.entries()) : value.headers;
+    return new this.dependencies.MahameruResponse(value.body, {
+      status: value.status,
+      headers: normalizedHeaders
+    });
+  }
+}
+export {
+  Route
+};
+//# sourceMappingURL=route.js.map

package/route.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/route.ts"],"sourcesContent":["import { join } from 'node:path';\n\nimport type { MahameruRequest } from './mahameru-request';\nimport type { MahameruResponse } from './mahameru-response';\nimport type { Container } from './container';\nimport type { HttpServerError } from './http-server-error';\nimport type { HTTPMethod, RouteHandlerContext, RouteItem } from './types';\n\nexport type RouteOptions = {\n    dev: boolean;\n    routesPath: string;\n};\n\nexport type RouteDependencies = {\n    container: Container;\n    HttpServerError: typeof HttpServerError;\n    MahameruResponse: typeof MahameruResponse;\n};\n\nexport class Route {\n    public readonly options: RouteOptions = {\n        dev: false,\n        routesPath: join(process.cwd(), '.mahameru', 'routes')\n    }\n    protected dependencies: RouteDependencies;\n\n    constructor(\n        dependencies: RouteDependencies\n    )\n    constructor(\n        options: Partial<RouteOptions>,\n        dependencies: RouteDependencies\n    )\n    constructor(\n        arg1: Partial<RouteOptions> | RouteDependencies,\n        arg2?: RouteDependencies\n    ) {\n        if (typeof arg2 !== 'undefined')\n            this.options = { ...this.options, ...arg1 as Partial<RouteOptions> };\n\n        if (typeof arg2 !== 'undefined') {\n            this.dependencies = arg2;\n        } else {\n            this.dependencies = arg1 as RouteDependencies;\n        }\n    }\n\n    normalizePathForMatching(path: string): string {\n        if (path.length > 1 && path.endsWith('/')) {\n            return path.slice(0, -1);\n        }\n\n        return path;\n    }\n\n    findMatchedRoute(matchUrl: string) {\n        let matchedRoute: RouteItem | null = null;\n        let matchResult: RegExpExecArray | null = null;\n\n        for (const route of this.dependencies.container.getRouteItems()) {\n            const result = route.regex.exec(matchUrl);\n\n            if (result) {\n                matchedRoute = route;\n                matchResult = result;\n\n                break;\n            }\n        }\n\n        return { matchedRoute, matchResult };\n    }\n\n    async runNotFoundHandler(request: MahameruRequest, method: HTTPMethod): Promise<MahameruResponse | undefined> {\n        if (!this.dependencies.container.notFoundHandler)\n            return undefined;\n\n        const handler = this.dependencies.container.notFoundHandler[method];\n\n        if (typeof handler !== 'function') {\n            return undefined;\n        }\n\n        const response = await handler(request, this.dependencies.container, { params: {} } satisfies RouteHandlerContext);\n\n        return this.normalizeMahameruResponse(\n            response,\n            `Not found handler for method '${method}' must return a MahameruResponse instance.`\n        );\n    }\n\n    async resolveRoute(request: MahameruRequest) {\n        const rawReqPath = request.url.split('?')[0] || '/';\n        const rawReqUrl = rawReqPath.replace(/\\/+/g, '/');\n        const matchUrl = this.normalizePathForMatching(rawReqUrl);\n\n        let { matchedRoute, matchResult } = this.findMatchedRoute(matchUrl);\n\n        if (!matchedRoute || !matchResult)\n            return {\n                matchedRoute: null,\n                matchResult: null,\n                notFoundResponse: await this.runNotFoundHandler(request, request.method) || this.dependencies.MahameruResponse.json(\n                    { error: 'Not Found' },\n                    { status: 404 }\n                )\n            };\n\n        return { matchedRoute, matchResult };\n    }\n\n    protected isMahameruResponseLike(value: unknown): value is { body: unknown; status: number; headers?: Headers | Record<string, string> } {\n        if (!value || typeof value !== 'object') {\n            return false;\n        }\n\n        if (!('status' in value) || typeof value.status !== 'number') {\n            return false;\n        }\n\n        if (!('body' in value)) {\n            return false;\n        }\n\n        if (!('headers' in value) || value.headers === undefined) {\n            return true;\n        }\n\n        if (value.headers instanceof Headers) {\n            return true;\n        }\n\n        return typeof value.headers === 'object' && value.headers !== null && !Array.isArray(value.headers);\n    }\n\n    protected normalizeMahameruResponse(value: unknown, errorMessage: string): MahameruResponse {\n        if (value instanceof this.dependencies.MahameruResponse) {\n            return value;\n        }\n\n        if (!this.isMahameruResponseLike(value)) {\n            throw new this.dependencies.HttpServerError(errorMessage);\n        }\n\n        const normalizedHeaders = value.headers instanceof Headers\n            ? Object.fromEntries(value.headers.entries())\n            : value.headers;\n\n        return new this.dependencies.MahameruResponse(value.body, {\n            status: value.status,\n            headers: normalizedHeaders\n        });\n    }\n}\n"],"mappings":"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","names":[]}

package/scripts/preinstall.js

@@ -0,0 +1,9 @@
+if (process.env.npm_config_global === 'true' || process.env.npm_config_global === '1') {
+    console.error('\x1b[31m%s\x1b[0m', '==================================================================');
+    console.error('\x1b[31m%s\x1b[0m', ' Error: The "@mahameru/core" package cannot be installed globally!');
+    console.error('\x1b[31m%s\x1b[0m', ' Please install it locally within your project using:');
+    console.error('\x1b[33m%s\x1b[0m', ' npm install @mahameru/core');
+    console.error('\x1b[31m%s\x1b[0m', '==================================================================');
+
+    process.exit(1);
+}

package/types-BRwWYiUN.d.ts

@@ -0,0 +1,108 @@
+import { IncomingHttpHeaders, IncomingMessage } from 'node:http';
+import { MahameruResponse } from './mahameru-response.js';
+
+declare class MahameruRequest {
+    method: HTTPMethod;
+    url: string;
+    headers: IncomingHttpHeaders;
+    query: URLSearchParams;
+    path: string;
+    ipAddress?: string;
+    /**
+     * Parsed Authorization Bearer header
+     * @returns {string | undefined}
+     */
+    authorization?: string;
+    protected rawRequest: IncomingMessage;
+    constructor(request: IncomingMessage);
+    json(): Promise<any>;
+}
+
+declare enum HTTPMethodEnum {
+    GET = "GET",
+    HEAD = "HEAD",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE",
+    CONNECT = "CONNECT",
+    OPTIONS = "OPTIONS",
+    TRACE = "TRACE",
+    PATCH = "PATCH"
+}
+type HTTPMethod = `${HTTPMethodEnum}`;
+type RouteObject<T extends string = string> = {
+    path: T;
+    methods: HTTPMethod[];
+};
+interface RegisterRoutes {
+}
+type ProtectedRoute = RegisterRoutes extends {
+    routes: infer R;
+} ? R[] : (string | RouteObject<string>)[];
+type RequestParams = {
+    [key: string]: string;
+};
+type RouteHandlerContext = {
+    params: RequestParams;
+};
+type RouteHandler = (request: MahameruRequest, container: MahameruContainer, context: RouteHandlerContext) => Promise<MahameruResponse> | MahameruResponse;
+interface RouteItem {
+    path: string;
+    regex: RegExp;
+    paramNames: (keyof RequestParams)[];
+    routeHandlers: RouteHandlers;
+    pathFS: string;
+}
+type RouteHandlers = Record<HTTPMethod, RouteHandler>;
+type MahameruNext = () => Promise<MahameruResponse>;
+interface MahameruMiddlewareContext {
+    request: MahameruRequest;
+    container: MahameruContainer;
+    params: Record<string, string>;
+    path: string;
+    method: HTTPMethod;
+    status: number;
+}
+type MahameruMiddleware = (context: MahameruMiddlewareContext, isProtectedRoute: boolean, next: MahameruNext) => Promise<MahameruResponse> | MahameruResponse;
+type ErrorHandlerContext = MahameruMiddlewareContext & {
+    error: unknown;
+};
+type ErrorHandler = (context: ErrorHandlerContext, next: MahameruNext) => Promise<MahameruResponse> | MahameruResponse;
+interface Modules {
+}
+interface Instances {
+}
+interface MahameruContainer extends Modules, Instances {
+}
+type ClassConstructor<T = unknown> = new (mahameruContainer: MahameruContainer) => T;
+type ContainerItemID = string;
+type ContainerItem = {
+    name: string;
+    path: string;
+    type: 'module-service';
+    item: unknown;
+} | {
+    name: string;
+    path: string;
+    type: 'module-controller';
+    item: unknown;
+} | {
+    name: string;
+    path: string;
+    type: 'route';
+    item: RouteItem;
+} | {
+    name: string;
+    path: string;
+    type: 'instance';
+    item: Instances;
+} | {
+    name: string;
+    path: string;
+    type: 'middleware';
+    item: MahameruMiddleware;
+};
+type ContainerRegistry = Map<ContainerItemID, ContainerItem>;
+type InitiatorHandler = () => Promise<Instances>;
+
+export { type ClassConstructor as C, type ErrorHandler as E, type HTTPMethod as H, type InitiatorHandler as I, type MahameruContainer as M, type ProtectedRoute as P, type RegisterRoutes as R, type ContainerItem as a, type ContainerItemID as b, type ContainerRegistry as c, type ErrorHandlerContext as d, HTTPMethodEnum as e, type Instances as f, type MahameruMiddleware as g, type MahameruMiddlewareContext as h, type MahameruNext as i, MahameruRequest as j, type Modules as k, type RequestParams as l, type RouteHandler as m, type RouteHandlerContext as n, type RouteHandlers as o, type RouteItem as p, type RouteObject as q };