@adaas/a-server 0.0.22 → 0.0.24

package/dist/node/lib/A-Server/A-HttpServer.container.mjs

@@ -0,0 +1,184 @@
+import { __decorateClass, __decorateParam } from '../../chunk-EQQGB2QZ.mjs';
+import { A_HttpServerFeatures } from './A-HttpServer.constants';
+import { A_Request } from '@adaas/a-server/request/A-Request.entity';
+import { A_Response } from '@adaas/a-server/response/A-Response.entity';
+import { A_Feature, A_IdentityHelper, A_Scope, A_Error, A_Dependency, A_Inject } from '@adaas/a-concept';
+import { A_ServerRoute } from '@adaas/a-server/route/A-ServerRoute.entity';
+import { A_HttpServerError } from './A-HttpServer.error';
+import { A_RequestFeatures } from '@adaas/a-server/request/A-Request.constants';
+import { A_HttpServerRequestContext } from '@adaas/a-server/request/A-HttpServerRequest.context';
+import { A_ServerLogger } from '@adaas/a-server/logger/A-ServerLogger.component';
+import { A_Service, A_ServiceFeatures } from '@adaas/a-utils/a-service';
+import { A_Polyfill } from '@adaas/a-utils/a-polyfill';
+import { A_Config } from '@adaas/a-utils/a-config';
+
+var _a, _b, _c, _d, _e;
+class A_HttpServer extends A_Service {
+  static get onBeforeRequest() {
+    return (target, propertyKey, descriptor) => {
+      return A_Feature.Extend({
+        name: A_HttpServerFeatures.onBeforeRequest,
+        scope: [target.constructor]
+      })(target, propertyKey, descriptor);
+    };
+  }
+  static get onRequest() {
+    return (target, propertyKey, descriptor) => {
+      return A_Feature.Extend({
+        name: A_HttpServerFeatures.onRequest,
+        scope: [target.constructor]
+      })(target, propertyKey, descriptor);
+    };
+  }
+  static get onAfterRequest() {
+    return (target, propertyKey, descriptor) => {
+      return A_Feature.Extend({
+        name: A_HttpServerFeatures.onAfterRequest,
+        scope: [target.constructor]
+      })(target, propertyKey, descriptor);
+    };
+  }
+  async [_e = A_ServiceFeatures.onStart](polyfill, config) {
+    const http = await polyfill.http();
+    this.server = http.createServer(this.handleRequest.bind(this));
+    await this.listen(config.get("A_SERVER_PORT"));
+  }
+  async [_d = A_ServiceFeatures.onAfterStart](config, logger) {
+    logger.serverReady({
+      port: config.get("A_SERVER_PORT"),
+      app: {
+        name: this.scope.name
+      }
+    });
+  }
+  async [A_ServiceFeatures.onStop](...args) {
+    await this.close();
+  }
+  close() {
+    return new Promise((resolve, reject) => {
+      this.server.close(() => {
+        resolve();
+      });
+    });
+  }
+  listen(port) {
+    return new Promise((resolve, reject) => {
+      this.server.listen(port, () => {
+        resolve();
+      });
+    });
+  }
+  async [_c = A_HttpServerFeatures.onBeforeRequest](...args) {
+  }
+  async [_b = A_HttpServerFeatures.onRequest](...args) {
+  }
+  async [_a = A_HttpServerFeatures.onAfterRequest](...args) {
+  }
+  // ======================================================================================
+  // ============================= A_HttpServer Methods =================================
+  // ======================================================================================
+  async handleRequest(request, response) {
+    const route = new A_ServerRoute(
+      request.url || "",
+      request.method
+    );
+    const id = A_IdentityHelper.generateTimeId();
+    const shard = `${request.method}-${route.path.replace("/", "-")}`;
+    const req = new A_Request({ id, shard, request, scope: this.scope.name });
+    const res = new A_Response({ id, shard, response, scope: this.scope.name });
+    const context = new A_HttpServerRequestContext(request, response);
+    const scope = new A_Scope({
+      name: id,
+      entities: [req, res],
+      fragments: [route, context]
+    }).inherit(this.scope);
+    try {
+      const onBeforeRequestFeature = new A_Feature({
+        name: A_HttpServerFeatures.onBeforeRequest,
+        component: this
+      });
+      const onRequestFeature = new A_Feature({
+        name: A_HttpServerFeatures.onRequest,
+        component: this
+      });
+      const onAfterRequestFeature = new A_Feature({
+        name: A_HttpServerFeatures.onAfterRequest,
+        component: this
+      });
+      await new Promise(async (resolve, reject) => {
+        const cleanup = () => {
+          onBeforeRequestFeature.interrupt();
+          onRequestFeature.interrupt();
+          onAfterRequestFeature.interrupt();
+          req.off(A_RequestFeatures.onError, cleanup);
+          req.off(A_RequestFeatures.onClose, cleanup);
+          req.off(A_RequestFeatures.onTimeout, cleanup);
+          reject(scope.resolve(A_Error));
+        };
+        req.on(A_RequestFeatures.onError, cleanup.bind(this));
+        req.on(A_RequestFeatures.onClose, cleanup.bind(this));
+        try {
+          await req.load();
+          await res.load();
+          await onBeforeRequestFeature.process(scope);
+          await onRequestFeature.process(scope);
+          await onAfterRequestFeature.process(scope);
+          req.clearTimeout();
+          if (!res.isStreaming) {
+            await res.status(200).send();
+          }
+          resolve();
+        } catch (error) {
+          req.clearTimeout();
+          reject(error);
+        }
+      });
+    } catch (error) {
+      let wrappedError;
+      switch (true) {
+        case error instanceof A_HttpServerError:
+          wrappedError = error;
+          break;
+        case (error instanceof A_Error && error.originalError instanceof A_HttpServerError):
+          wrappedError = error.originalError;
+          break;
+        default:
+          wrappedError = new A_HttpServerError({
+            status: 500,
+            description: "An error occurred while processing the request.",
+            originalError: error
+          });
+          break;
+      }
+      scope.register(wrappedError);
+      await res.fail(wrappedError);
+      await this.call(A_ServiceFeatures.onError, scope);
+    }
+    scope.destroy();
+  }
+}
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Dependency.Required()),
+  __decorateParam(0, A_Inject(A_Polyfill)),
+  __decorateParam(1, A_Dependency.Required()),
+  __decorateParam(1, A_Inject(A_Config))
+], A_HttpServer.prototype, _e, 1);
+__decorateClass([
+  A_Feature.Extend(),
+  __decorateParam(0, A_Inject(A_Config)),
+  __decorateParam(1, A_Inject(A_ServerLogger))
+], A_HttpServer.prototype, _d, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_HttpServer.prototype, _c, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_HttpServer.prototype, _b, 1);
+__decorateClass([
+  A_Feature.Extend()
+], A_HttpServer.prototype, _a, 1);
+
+export { A_HttpServer };
+//# sourceMappingURL=A-HttpServer.container.mjs.map
+//# sourceMappingURL=A-HttpServer.container.mjs.map

package/dist/node/lib/A-Server/A-HttpServer.container.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Server/A-HttpServer.container.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AAwBO,MAAM,qBAAqB,SAAA,CAAU;AAAA,EAKxC,WAAW,eAAA,GAAkB;AACzB,IAAA,OAAO,CAAC,MAAA,EAAa,WAAA,EAAqB,UAAA,KAAmC;AACzE,MAAA,OAAO,UAAU,MAAA,CAAO;AAAA,QACpB,MAAM,oBAAA,CAAqB,eAAA;AAAA,QAC3B,KAAA,EAAO,CAAC,MAAA,CAAO,WAAW;AAAA,OAC7B,CAAA,CAAE,MAAA,EAAQ,WAAA,EAAa,UAAU,CAAA;AAAA,IACtC,CAAA;AAAA,EACJ;AAAA,EAEA,WAAW,SAAA,GAAY;AACnB,IAAA,OAAO,CAAC,MAAA,EAAa,WAAA,EAAqB,UAAA,KAAmC;AACzE,MAAA,OAAO,UAAU,MAAA,CAAO;AAAA,QACpB,MAAM,oBAAA,CAAqB,SAAA;AAAA,QAC3B,KAAA,EAAO,CAAC,MAAA,CAAO,WAAW;AAAA,OAC7B,CAAA,CAAE,MAAA,EAAQ,WAAA,EAAa,UAAU,CAAA;AAAA,IACtC,CAAA;AAAA,EACJ;AAAA,EAEA,WAAW,cAAA,GAAiB;AACxB,IAAA,OAAO,CAAC,MAAA,EAAa,WAAA,EAAqB,UAAA,KAAmC;AACzE,MAAA,OAAO,UAAU,MAAA,CAAO;AAAA,QACpB,MAAM,oBAAA,CAAqB,cAAA;AAAA,QAC3B,KAAA,EAAO,CAAC,MAAA,CAAO,WAAW;AAAA,OAC7B,CAAA,CAAE,MAAA,EAAQ,WAAA,EAAa,UAAU,CAAA;AAAA,IACtC,CAAA;AAAA,EACJ;AAAA,EAKA,OAAiB,EAAA,GAAA,iBAAA,CAAkB,OAAO,CAAA,CAGhB,UAGF,MAAA,EAEP;AACb,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAGjC,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,YAAA,CAAa,KAAK,aAAA,CAAc,IAAA,CAAK,IAAI,CAAC,CAAA;AAG7D,IAAA,MAAM,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,eAAe,CAAC,CAAA;AAAA,EACjD;AAAA,EAGA,OAAiB,EAAA,GAAA,iBAAA,CAAkB,YAAY,CAAA,CACvB,QACM,MAAA,EACb;AACb,IAAA,MAAA,CAAO,WAAA,CAAY;AAAA,MACf,IAAA,EAAM,MAAA,CAAO,GAAA,CAAI,eAAe,CAAA;AAAA,MAChC,GAAA,EAAK;AAAA,QACD,IAAA,EAAM,KAAK,KAAA,CAAM;AAAA;AACrB,KACH,CAAA;AAAA,EACL;AAAA,EAEA,OAAiB,iBAAA,CAAkB,MAAM,CAAA,CAAA,GAAK,IAAA,EAA4B;AACtE,IAAA,MAAM,KAAK,KAAA,EAAM;AAAA,EACrB;AAAA,EAEA,KAAA,GAAQ;AACJ,IAAA,OAAO,IAAI,OAAA,CAAc,CAAC,OAAA,EAAS,MAAA,KAAW;AAC1C,MAAA,IAAA,CAAK,MAAA,CAAO,MAAM,MAAM;AACpB,QAAA,OAAA,EAAQ;AAAA,MACZ,CAAC,CAAA;AAAA,IACL,CAAC,CAAA;AAAA,EACL;AAAA,EAEA,OAAO,IAAA,EAAc;AACjB,IAAA,OAAO,IAAI,OAAA,CAAc,CAAC,OAAA,EAAS,MAAA,KAAW;AAC1C,MAAA,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,IAAA,EAAM,MAAM;AAC3B,QAAA,OAAA,EAAQ;AAAA,MACZ,CAAC,CAAA;AAAA,IACL,CAAC,CAAA;AAAA,EACL;AAAA,EAQA,OAAiB,EAAA,GAAA,oBAAA,CAAqB,eAAe,CAAA,CAAA,GAAK,IAAA,EAAa;AAAA,EAAE;AAAA,EAGzE,OAAiB,EAAA,GAAA,oBAAA,CAAqB,SAAS,CAAA,CAAA,GAAK,IAAA,EAAa;AAAA,EAAE;AAAA,EAGnE,OAAiB,EAAA,GAAA,oBAAA,CAAqB,cAAc,CAAA,CAAA,GAAK,IAAA,EAAa;AAAA,EAAE;AAAA;AAAA;AAAA;AAAA,EAOxE,MAAM,aAAA,CACF,OAAA,EACA,QAAA,EACF;AACE,IAAA,MAAM,QAAQ,IAAI,aAAA;AAAA,MACd,QAAQ,GAAA,IAAO,EAAA;AAAA,MACf,OAAA,CAAQ;AAAA,KACZ;AAEA,IAAA,MAAM,EAAA,GAAK,iBAAiB,cAAA,EAAe;AAC3C,IAAA,MAAM,KAAA,GAAQ,CAAA,EAAG,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK,GAAG,CAAC,CAAA,CAAA;AAE/D,IAAA,MAAM,GAAA,GAAM,IAAI,SAAA,CAAU,EAAE,EAAA,EAAI,KAAA,EAAO,OAAA,EAAS,KAAA,EAAO,IAAA,CAAK,KAAA,CAAM,IAAA,EAAM,CAAA;AACxE,IAAA,MAAM,GAAA,GAAM,IAAI,UAAA,CAAW,EAAE,EAAA,EAAI,KAAA,EAAO,QAAA,EAAU,KAAA,EAAO,IAAA,CAAK,KAAA,CAAM,IAAA,EAAM,CAAA;AAC1E,IAAA,MAAM,OAAA,GAAU,IAAI,0BAAA,CAA2B,OAAA,EAAS,QAAQ,CAAA;AAEhE,IAAA,MAAM,KAAA,GAAQ,IAAI,OAAA,CAAQ;AAAA,MACtB,IAAA,EAAM,EAAA;AAAA,MACN,QAAA,EAAU,CAAC,GAAA,EAAK,GAAG,CAAA;AAAA,MACnB,SAAA,EAAW,CAAC,KAAA,EAAO,OAAO;AAAA,KAC7B,CAAA,CAAE,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAA;AAErB,IAAA,IAAI;AACA,MAAA,MAAM,sBAAA,GAAyB,IAAI,SAAA,CAAU;AAAA,QACzC,MAAM,oBAAA,CAAqB,eAAA;AAAA,QAC3B,SAAA,EAAW;AAAA,OACd,CAAA;AAED,MAAA,MAAM,gBAAA,GAAmB,IAAI,SAAA,CAAU;AAAA,QACnC,MAAM,oBAAA,CAAqB,SAAA;AAAA,QAC3B,SAAA,EAAW;AAAA,OACd,CAAA;AAED,MAAA,MAAM,qBAAA,GAAwB,IAAI,SAAA,CAAU;AAAA,QACxC,MAAM,oBAAA,CAAqB,cAAA;AAAA,QAC3B,SAAA,EAAW;AAAA,OACd,CAAA;AAED,MAAA,MAAM,IAAI,OAAA,CAAc,OAAO,OAAA,EAAS,MAAA,KAAW;AAE/C,QAAA,MAAM,UAAU,MAAM;AAClB,UAAA,sBAAA,CAAuB,SAAA,EAAU;AACjC,UAAA,gBAAA,CAAiB,SAAA,EAAU;AAC3B,UAAA,qBAAA,CAAsB,SAAA,EAAU;AAEhC,UAAA,GAAA,CAAI,GAAA,CAAI,iBAAA,CAAkB,OAAA,EAAS,OAAO,CAAA;AAC1C,UAAA,GAAA,CAAI,GAAA,CAAI,iBAAA,CAAkB,OAAA,EAAS,OAAO,CAAA;AAC1C,UAAA,GAAA,CAAI,GAAA,CAAI,iBAAA,CAAkB,SAAA,EAAW,OAAO,CAAA;AAG5C,UAAA,MAAA,CAAO,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAE,CAAA;AAAA,QAClC,CAAA;AAGA,QAAA,GAAA,CAAI,GAAG,iBAAA,CAAkB,OAAA,EAAS,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAC,CAAA;AACpD,QAAA,GAAA,CAAI,GAAG,iBAAA,CAAkB,OAAA,EAAS,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAC,CAAA;AAEpD,QAAA,IAAI;AACA,UAAA,MAAM,IAAI,IAAA,EAAK;AACf,UAAA,MAAM,IAAI,IAAA,EAAK;AAGf,UAAA,MAAM,sBAAA,CAAuB,QAAQ,KAAK,CAAA;AAE1C,UAAA,MAAM,gBAAA,CAAiB,QAAQ,KAAK,CAAA;AAEpC,UAAA,MAAM,qBAAA,CAAsB,QAAQ,KAAK,CAAA;AAGzC,UAAA,GAAA,CAAI,YAAA,EAAa;AAIjB,UAAA,IAAI,CAAC,IAAI,WAAA,EAAa;AAClB,YAAA,MAAM,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,EAAK;AAAA,UAC/B;AAEA,UAAA,OAAA,EAAQ;AAAA,QACZ,SAAS,KAAA,EAAO;AAEZ,UAAA,GAAA,CAAI,YAAA,EAAa;AACjB,UAAA,MAAA,CAAO,KAAK,CAAA;AAAA,QAChB;AAAA,MACJ,CAAC,CAAA;AAAA,IAEL,SAAS,KAAA,EAAO;AAEZ,MAAA,IAAI,YAAA;AAEJ,MAAA,QAAQ,IAAA;AAAM,QACV,KAAK,KAAA,YAAiB,iBAAA;AAClB,UAAA,YAAA,GAAe,KAAA;AACf,UAAA;AAAA,QAEJ,MAAK,KAAA,YAAiB,OAAA,IAAW,KAAA,CAAM,aAAA,YAAyB,iBAAA;AAC5D,UAAA,YAAA,GAAe,KAAA,CAAM,aAAA;AACrB,UAAA;AAAA,QAEJ;AACI,UAAA,YAAA,GAAe,IAAI,iBAAA,CAAkB;AAAA,YACjC,MAAA,EAAQ,GAAA;AAAA,YACR,WAAA,EAAa,iDAAA;AAAA,YACb,aAAA,EAAe;AAAA,WAClB,CAAA;AACD,UAAA;AAAA;AAIR,MAAA,KAAA,CAAM,SAAS,YAAY,CAAA;AAE3B,MAAA,MAAM,GAAA,CAAI,KAAK,YAAY,CAAA;AAE3B,MAAA,MAAM,IAAA,CAAK,IAAA,CAAK,iBAAA,CAAkB,OAAA,EAAS,KAAK,CAAA;AAAA,IACpD;AAEA,IAAA,KAAA,CAAM,OAAA,EAAQ;AAAA,EAClB;AAEJ;AA5LqB,eAAA,CAAA;AAAA,EADhB,UAAU,MAAA,EAAO;AAAA,EAGb,gCAAa,QAAA,EAAS,CAAA;AAAA,EACtB,4BAAS,UAAU,CAAA,CAAA;AAAA,EAEnB,gCAAa,QAAA,EAAS,CAAA;AAAA,EACtB,4BAAS,QAAQ,CAAA;AAAA,CAAA,EAzCb,YAAA,CAmCQ,SAAA,EAAA,EAAA,EAAA,CAAA,CAAA;AAmBA,eAAA,CAAA;AAAA,EADhB,UAAU,MAAA,EAAO;AAAA,EAEb,4BAAS,QAAQ,CAAA,CAAA;AAAA,EACjB,4BAAS,cAAc,CAAA;AAAA,CAAA,EAxDnB,YAAA,CAsDQ,SAAA,EAAA,EAAA,EAAA,CAAA,CAAA;AAsCA,eAAA,CAAA;AAAA,EADhB,UAAU,MAAA;AAAO,CAAA,EA3FT,YAAA,CA4FQ,SAAA,EAAA,EAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EADhB,UAAU,MAAA;AAAO,CAAA,EA9FT,YAAA,CA+FQ,SAAA,EAAA,EAAA,EAAA,CAAA,CAAA;AAGA,eAAA,CAAA;AAAA,EADhB,UAAU,MAAA;AAAO,CAAA,EAjGT,YAAA,CAkGQ,SAAA,EAAA,EAAA,EAAA,CAAA,CAAA","file":"A-HttpServer.container.mjs","sourcesContent":["import type { IncomingMessage, Server, ServerResponse } from \"http\";\nimport { A_HttpServerFeatures } from \"./A-HttpServer.constants\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_TYPES__ServerENVVariables } from \"@adaas/a-server/constants/env.constants\";\nimport { A_Dependency, A_Error, A_Feature, A_IdentityHelper, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_ServerRoute } from \"@adaas/a-server/route/A-ServerRoute.entity\";\nimport { A_HttpServerRequestMethod } from \"./A-HttpServer.types\";\nimport { A_HttpServerError } from \"./A-HttpServer.error\";\nimport { A_RequestFeatures } from \"@adaas/a-server/request/A-Request.constants\";\nimport { A_HttpServerRequestContext } from \"@adaas/a-server/request/A-HttpServerRequest.context\";\nimport { A_ServerLogger } from \"@adaas/a-server/logger/A-ServerLogger.component\";\nimport { A_Service, A_ServiceFeatures } from \"@adaas/a-utils/a-service\";\nimport { A_Polyfill } from \"@adaas/a-utils/a-polyfill\";\nimport { A_Config } from \"@adaas/a-utils/a-config\";\n\n\n\n\n/**\n * A-Service is a container that can run different types of services, such as HTTP servers, workers, etc.\n * Depending on the provided config and configuration, it will load the necessary components and start the service.\n * \n */\nexport class A_HttpServer extends A_Service {\n\n    protected server!: Server;\n\n\n    static get onBeforeRequest() {\n        return (target: any, propertyKey: string, descriptor: PropertyDescriptor) => {\n            return A_Feature.Extend({\n                name: A_HttpServerFeatures.onBeforeRequest,\n                scope: [target.constructor],\n            })(target, propertyKey, descriptor);\n        }\n    }\n\n    static get onRequest() {\n        return (target: any, propertyKey: string, descriptor: PropertyDescriptor) => {\n            return A_Feature.Extend({\n                name: A_HttpServerFeatures.onRequest,\n                scope: [target.constructor],\n            })(target, propertyKey, descriptor);\n        }\n    }\n\n    static get onAfterRequest() {\n        return (target: any, propertyKey: string, descriptor: PropertyDescriptor) => {\n            return A_Feature.Extend({\n                name: A_HttpServerFeatures.onAfterRequest,\n                scope: [target.constructor],\n            })(target, propertyKey, descriptor);\n        }\n    }\n\n\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onStart](\n\n        @A_Dependency.Required()\n        @A_Inject(A_Polyfill) polyfill: A_Polyfill,\n\n        @A_Dependency.Required()\n        @A_Inject(A_Config) config: A_Config<A_TYPES__ServerENVVariables>,\n\n    ): Promise<void> {\n        const http = await polyfill.http();\n\n        // Create the HTTP server\n        this.server = http.createServer(this.handleRequest.bind(this));\n\n        // Start listening on the specified port\n        await this.listen(config.get('A_SERVER_PORT'));\n    }\n\n    @A_Feature.Extend()\n    protected async [A_ServiceFeatures.onAfterStart](\n        @A_Inject(A_Config) config: A_Config<A_TYPES__ServerENVVariables>,\n        @A_Inject(A_ServerLogger) logger: A_ServerLogger,\n    ): Promise<void> {\n        logger.serverReady({\n            port: config.get('A_SERVER_PORT'),\n            app: {\n                name: this.scope.name,\n            }\n        });\n    }\n\n    protected async [A_ServiceFeatures.onStop](...args: any[]): Promise<void> {\n        await this.close();\n    }\n\n    close() {\n        return new Promise<void>((resolve, reject) => {\n            this.server.close(() => {\n                resolve();\n            });\n        });\n    }\n\n    listen(port: number) {\n        return new Promise<void>((resolve, reject) => {\n            this.server.listen(port, () => {\n                resolve();\n            });\n        });\n    }\n\n\n    // ======================================================================================\n    // ============================= A_HttpServer Lifecycle =================================\n    // ======================================================================================\n\n    @A_Feature.Extend()\n    protected async [A_HttpServerFeatures.onBeforeRequest](...args: any[]) { }\n\n    @A_Feature.Extend()\n    protected async [A_HttpServerFeatures.onRequest](...args: any[]) { }\n\n    @A_Feature.Extend()\n    protected async [A_HttpServerFeatures.onAfterRequest](...args: any[]) { }\n\n\n    // ======================================================================================\n    // ============================= A_HttpServer Methods =================================\n    // ======================================================================================\n\n    async handleRequest(\n        request: IncomingMessage,\n        response: ServerResponse\n    ) {\n        const route = new A_ServerRoute(\n            request.url || '',\n            request.method as A_HttpServerRequestMethod\n        );\n\n        const id = A_IdentityHelper.generateTimeId();\n        const shard = `${request.method}-${route.path.replace('/', '-')}`;\n\n        const req = new A_Request({ id, shard, request, scope: this.scope.name });\n        const res = new A_Response({ id, shard, response, scope: this.scope.name });\n        const context = new A_HttpServerRequestContext(request, response);\n\n        const scope = new A_Scope({\n            name: id,\n            entities: [req, res],\n            fragments: [route, context]\n        }).inherit(this.scope);\n\n        try {\n            const onBeforeRequestFeature = new A_Feature({\n                name: A_HttpServerFeatures.onBeforeRequest,\n                component: this\n            });\n\n            const onRequestFeature = new A_Feature({\n                name: A_HttpServerFeatures.onRequest,\n                component: this\n            });\n\n            const onAfterRequestFeature = new A_Feature({\n                name: A_HttpServerFeatures.onAfterRequest,\n                component: this\n            });\n\n            await new Promise<void>(async (resolve, reject) => {\n\n                const cleanup = () => {\n                    onBeforeRequestFeature.interrupt();\n                    onRequestFeature.interrupt();\n                    onAfterRequestFeature.interrupt();\n\n                    req.off(A_RequestFeatures.onError, cleanup);\n                    req.off(A_RequestFeatures.onClose, cleanup);\n                    req.off(A_RequestFeatures.onTimeout, cleanup);\n\n\n                    reject(scope.resolve(A_Error)!);\n                }\n\n\n                req.on(A_RequestFeatures.onError, cleanup.bind(this));\n                req.on(A_RequestFeatures.onClose, cleanup.bind(this));\n\n                try {\n                    await req.load();\n                    await res.load();\n\n\n                    await onBeforeRequestFeature.process(scope);\n\n                    await onRequestFeature.process(scope);\n\n                    await onAfterRequestFeature.process(scope);\n\n\n                    req.clearTimeout();\n\n                    // For SSE streams the controller calls response.sseOpen() which keeps\n                    // the socket alive; skip the auto-send so we don't close it here.\n                    if (!res.isStreaming) {\n                        await res.status(200).send();\n                    }\n\n                    resolve();\n                } catch (error) {\n\n                    req.clearTimeout();\n                    reject(error);\n                }\n            });\n\n        } catch (error) {\n\n            let wrappedError;\n\n            switch (true) {\n                case error instanceof A_HttpServerError:\n                    wrappedError = error;\n                    break;\n\n                case error instanceof A_Error && error.originalError instanceof A_HttpServerError:\n                    wrappedError = error.originalError;\n                    break;\n\n                default:\n                    wrappedError = new A_HttpServerError({\n                        status: 500,\n                        description: 'An error occurred while processing the request.',\n                        originalError: error\n                    })\n                    break;\n            }\n\n\n            scope.register(wrappedError);\n\n            await res.fail(wrappedError);\n\n            await this.call(A_ServiceFeatures.onError, scope);\n        }\n\n        scope.destroy();\n    }\n\n}\n\n\n\n\n\n\n\n\n"]}

package/dist/node/lib/A-Server/A-HttpServer.error.d.mts

@@ -0,0 +1,54 @@
+import { A_Error } from '@adaas/a-concept';
+import { A_HttpServerError_Init, A_HttpServerError_Serialized } from './A-HttpServer.types.mjs';
+import './A-HttpServer.constants.mjs';
+
+declare class A_HttpServerError extends A_Error<A_HttpServerError_Init, A_HttpServerError_Serialized> {
+    static readonly NotFoundErrorStatus: number;
+    static readonly NotFoundError = "Resource Not Found";
+    static readonly InternalServerErrorStatus: number;
+    static readonly InternalServerError = "Internal Server Error";
+    /**
+     * HTTP status code to title mapping
+     */
+    private static readonly HTTP_STATUS_TITLES;
+    status: number;
+    /**
+     * Gets the appropriate title for a given HTTP status code
+     */
+    private static getHttpStatusTitle;
+    constructor(
+    /**
+     * A_Error Constructor params with required title
+     */
+    params: A_HttpServerError_Init);
+    constructor(
+    /**
+     * Simplified params with optional title - will auto-generate from status
+     */
+    params: {
+        status?: number;
+        description?: string;
+        code?: string;
+        scope?: string;
+        link?: string;
+        originalError?: Error | unknown;
+    });
+    constructor(
+    /**
+     * HTTP Status Code of the error
+     */
+    status: number, 
+    /**
+     * Error description
+     */
+    description: string);
+    constructor(
+    /**
+     * Original JS Error
+     */
+    error: Error);
+    protected fromConstructor(params: A_HttpServerError_Init): void;
+    toJSON(): A_HttpServerError_Serialized;
+}
+
+export { A_HttpServerError };

package/dist/node/lib/A-Server/A-HttpServer.error.d.ts

@@ -0,0 +1,54 @@
+import { A_Error } from '@adaas/a-concept';
+import { A_HttpServerError_Init, A_HttpServerError_Serialized } from './A-HttpServer.types.js';
+import './A-HttpServer.constants.js';
+
+declare class A_HttpServerError extends A_Error<A_HttpServerError_Init, A_HttpServerError_Serialized> {
+    static readonly NotFoundErrorStatus: number;
+    static readonly NotFoundError = "Resource Not Found";
+    static readonly InternalServerErrorStatus: number;
+    static readonly InternalServerError = "Internal Server Error";
+    /**
+     * HTTP status code to title mapping
+     */
+    private static readonly HTTP_STATUS_TITLES;
+    status: number;
+    /**
+     * Gets the appropriate title for a given HTTP status code
+     */
+    private static getHttpStatusTitle;
+    constructor(
+    /**
+     * A_Error Constructor params with required title
+     */
+    params: A_HttpServerError_Init);
+    constructor(
+    /**
+     * Simplified params with optional title - will auto-generate from status
+     */
+    params: {
+        status?: number;
+        description?: string;
+        code?: string;
+        scope?: string;
+        link?: string;
+        originalError?: Error | unknown;
+    });
+    constructor(
+    /**
+     * HTTP Status Code of the error
+     */
+    status: number, 
+    /**
+     * Error description
+     */
+    description: string);
+    constructor(
+    /**
+     * Original JS Error
+     */
+    error: Error);
+    protected fromConstructor(params: A_HttpServerError_Init): void;
+    toJSON(): A_HttpServerError_Serialized;
+}
+
+export { A_HttpServerError };

package/dist/node/lib/A-Server/A-HttpServer.error.js

@@ -0,0 +1,118 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+
+const _A_HttpServerError = class _A_HttpServerError extends aConcept.A_Error {
+  /**
+   * Gets the appropriate title for a given HTTP status code
+   */
+  static getHttpStatusTitle(status) {
+    return this.HTTP_STATUS_TITLES[status] || "Unknown Error";
+  }
+  constructor(param1, param2) {
+    switch (true) {
+      // Pattern: new A_HttpServerError(404, 'The requested resource was not found')
+      case (typeof param1 === "number" && typeof param2 === "string"):
+        super({
+          title: _A_HttpServerError.getHttpStatusTitle(param1),
+          description: param2
+        });
+        this.status = param1;
+        break;
+      // Pattern: new A_HttpServerError(someErrorObject)
+      case param1 instanceof Error:
+        super(param1);
+        this.status = 500;
+        break;
+      // Pattern: new A_HttpServerError({ status: 500, description: '...', originalError: ... })
+      case (typeof param1 === "object" && param1 !== null && !(param1 instanceof Error)):
+        const params = param1;
+        if ("title" in params && params.title) {
+          super(params);
+          this.status = params.status || 500;
+        } else {
+          const title = params.status ? _A_HttpServerError.getHttpStatusTitle(params.status) : "Internal Server Error";
+          super({
+            title,
+            description: params.description,
+            code: params.code,
+            scope: params.scope,
+            link: params.link,
+            originalError: params.originalError
+          });
+          this.status = params.status || 500;
+        }
+        break;
+      default:
+        throw new Error("Invalid parameters provided to A_HttpServerError constructor");
+    }
+  }
+  fromConstructor(params) {
+    super.fromConstructor(params);
+    if (params.status) {
+      this.status = params.status;
+    }
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      status: this.status
+    };
+  }
+};
+_A_HttpServerError.NotFoundErrorStatus = 404;
+_A_HttpServerError.NotFoundError = "Resource Not Found";
+_A_HttpServerError.InternalServerErrorStatus = 500;
+_A_HttpServerError.InternalServerError = "Internal Server Error";
+/**
+ * HTTP status code to title mapping
+ */
+_A_HttpServerError.HTTP_STATUS_TITLES = {
+  // 4xx Client Errors
+  400: "Bad Request",
+  401: "Unauthorized",
+  402: "Payment Required",
+  403: "Forbidden",
+  404: "Not Found",
+  405: "Method Not Allowed",
+  406: "Not Acceptable",
+  407: "Proxy Authentication Required",
+  408: "Request Timeout",
+  409: "Conflict",
+  410: "Gone",
+  411: "Length Required",
+  412: "Precondition Failed",
+  413: "Payload Too Large",
+  414: "URI Too Long",
+  415: "Unsupported Media Type",
+  416: "Range Not Satisfiable",
+  417: "Expectation Failed",
+  418: "I'm a teapot",
+  421: "Misdirected Request",
+  422: "Unprocessable Entity",
+  423: "Locked",
+  424: "Failed Dependency",
+  425: "Too Early",
+  426: "Upgrade Required",
+  428: "Precondition Required",
+  429: "Too Many Requests",
+  431: "Request Header Fields Too Large",
+  451: "Unavailable For Legal Reasons",
+  // 5xx Server Errors
+  500: "Internal Server Error",
+  501: "Not Implemented",
+  502: "Bad Gateway",
+  503: "Service Unavailable",
+  504: "Gateway Timeout",
+  505: "HTTP Version Not Supported",
+  506: "Variant Also Negotiates",
+  507: "Insufficient Storage",
+  508: "Loop Detected",
+  510: "Not Extended",
+  511: "Network Authentication Required"
+};
+let A_HttpServerError = _A_HttpServerError;
+
+exports.A_HttpServerError = A_HttpServerError;
+//# sourceMappingURL=A-HttpServer.error.js.map
+//# sourceMappingURL=A-HttpServer.error.js.map

package/dist/node/lib/A-Server/A-HttpServer.error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Server/A-HttpServer.error.ts"],"names":["A_Error"],"mappings":"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","file":"A-HttpServer.error.js","sourcesContent":["import { A_Error } from '@adaas/a-concept';\nimport { A_HttpServerError_Init, A_HttpServerError_Serialized } from './A-HttpServer.types';\n\n\nexport class A_HttpServerError extends A_Error<A_HttpServerError_Init, A_HttpServerError_Serialized> {\n\n    static readonly NotFoundErrorStatus: number = 404;\n    static readonly NotFoundError = 'Resource Not Found';\n\n    static readonly InternalServerErrorStatus: number = 500;\n    static readonly InternalServerError = 'Internal Server Error';\n\n    /**\n     * HTTP status code to title mapping\n     */\n    private static readonly HTTP_STATUS_TITLES: Record<number, string> = {\n        // 4xx Client Errors\n        400: 'Bad Request',\n        401: 'Unauthorized',\n        402: 'Payment Required',\n        403: 'Forbidden',\n        404: 'Not Found',\n        405: 'Method Not Allowed',\n        406: 'Not Acceptable',\n        407: 'Proxy Authentication Required',\n        408: 'Request Timeout',\n        409: 'Conflict',\n        410: 'Gone',\n        411: 'Length Required',\n        412: 'Precondition Failed',\n        413: 'Payload Too Large',\n        414: 'URI Too Long',\n        415: 'Unsupported Media Type',\n        416: 'Range Not Satisfiable',\n        417: 'Expectation Failed',\n        418: 'I\\'m a teapot',\n        421: 'Misdirected Request',\n        422: 'Unprocessable Entity',\n        423: 'Locked',\n        424: 'Failed Dependency',\n        425: 'Too Early',\n        426: 'Upgrade Required',\n        428: 'Precondition Required',\n        429: 'Too Many Requests',\n        431: 'Request Header Fields Too Large',\n        451: 'Unavailable For Legal Reasons',\n\n        // 5xx Server Errors\n        500: 'Internal Server Error',\n        501: 'Not Implemented',\n        502: 'Bad Gateway',\n        503: 'Service Unavailable',\n        504: 'Gateway Timeout',\n        505: 'HTTP Version Not Supported',\n        506: 'Variant Also Negotiates',\n        507: 'Insufficient Storage',\n        508: 'Loop Detected',\n        510: 'Not Extended',\n        511: 'Network Authentication Required'\n    };\n\n    status!: number;\n\n    /**\n     * Gets the appropriate title for a given HTTP status code\n     */\n    private static getHttpStatusTitle(status: number): string {\n        return this.HTTP_STATUS_TITLES[status] || 'Unknown Error';\n    }\n\n    constructor(\n        /**\n         * A_Error Constructor params with required title\n         */\n        params: A_HttpServerError_Init\n    )\n    constructor(\n        /**\n         * Simplified params with optional title - will auto-generate from status\n         */\n        params: { status?: number; description?: string; code?: string; scope?: string; link?: string; originalError?: Error | unknown }\n    )\n    constructor(\n        /**\n         * HTTP Status Code of the error\n         */\n        status: number,\n        /**\n         * Error description\n         */\n        description: string\n    )\n    constructor(\n        /**\n         * Original JS Error\n         */\n        error: Error\n    )\n    constructor(\n        param1: A_HttpServerError_Init | { status?: number; description?: string; code?: string; scope?: string; link?: string; originalError?: Error | unknown } | Error | number,\n        param2?: string\n    ) {\n        // Handle the different constructor overloads\n        switch (true) {\n            // Pattern: new A_HttpServerError(404, 'The requested resource was not found')\n            case typeof param1 === 'number' && typeof param2 === 'string':\n                super({\n                    title: A_HttpServerError.getHttpStatusTitle(param1),\n                    description: param2\n                });\n                this.status = param1;\n                break;\n\n            // Pattern: new A_HttpServerError(someErrorObject)\n            case param1 instanceof Error:\n                super(param1);\n                this.status = 500; // Default status for Error objects\n                break;\n\n            // Pattern: new A_HttpServerError({ status: 500, description: '...', originalError: ... })\n            case typeof param1 === 'object' && param1 !== null && !(param1 instanceof Error):\n                const params = param1 as any;\n                \n                // If title is provided, use the full A_Error init\n                if ('title' in params && params.title) {\n                    super(params as A_HttpServerError_Init);\n                    this.status = params.status || 500;\n                } else {\n                    // Auto-generate title from status\n                    const title = params.status ? A_HttpServerError.getHttpStatusTitle(params.status) : 'Internal Server Error';\n                    super({\n                        title: title,\n                        description: params.description,\n                        code: params.code,\n                        scope: params.scope,\n                        link: params.link,\n                        originalError: params.originalError\n                    });\n                    this.status = params.status || 500;\n                }\n                break;\n\n            default:\n                // Fallback for any other case\n                throw new Error('Invalid parameters provided to A_HttpServerError constructor');\n        }\n    }\n\n\n    protected fromConstructor(params: A_HttpServerError_Init): void {\n        super.fromConstructor(params);\n        if (params.status) {\n            this.status = params.status;\n        }\n    }\n\n\n    toJSON(): A_HttpServerError_Serialized {\n        return {\n            ...super.toJSON(),\n            status: this.status\n        }\n    }\n}\n\n"]}

package/dist/node/lib/A-Server/A-HttpServer.error.mjs

@@ -0,0 +1,117 @@
+import '../../chunk-EQQGB2QZ.mjs';
+import { A_Error } from '@adaas/a-concept';
+
+const _A_HttpServerError = class _A_HttpServerError extends A_Error {
+  /**
+   * Gets the appropriate title for a given HTTP status code
+   */
+  static getHttpStatusTitle(status) {
+    return this.HTTP_STATUS_TITLES[status] || "Unknown Error";
+  }
+  constructor(param1, param2) {
+    switch (true) {
+      // Pattern: new A_HttpServerError(404, 'The requested resource was not found')
+      case (typeof param1 === "number" && typeof param2 === "string"):
+        super({
+          title: _A_HttpServerError.getHttpStatusTitle(param1),
+          description: param2
+        });
+        this.status = param1;
+        break;
+      // Pattern: new A_HttpServerError(someErrorObject)
+      case param1 instanceof Error:
+        super(param1);
+        this.status = 500;
+        break;
+      // Pattern: new A_HttpServerError({ status: 500, description: '...', originalError: ... })
+      case (typeof param1 === "object" && param1 !== null && !(param1 instanceof Error)):
+        const params = param1;
+        if ("title" in params && params.title) {
+          super(params);
+          this.status = params.status || 500;
+        } else {
+          const title = params.status ? _A_HttpServerError.getHttpStatusTitle(params.status) : "Internal Server Error";
+          super({
+            title,
+            description: params.description,
+            code: params.code,
+            scope: params.scope,
+            link: params.link,
+            originalError: params.originalError
+          });
+          this.status = params.status || 500;
+        }
+        break;
+      default:
+        throw new Error("Invalid parameters provided to A_HttpServerError constructor");
+    }
+  }
+  fromConstructor(params) {
+    super.fromConstructor(params);
+    if (params.status) {
+      this.status = params.status;
+    }
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      status: this.status
+    };
+  }
+};
+_A_HttpServerError.NotFoundErrorStatus = 404;
+_A_HttpServerError.NotFoundError = "Resource Not Found";
+_A_HttpServerError.InternalServerErrorStatus = 500;
+_A_HttpServerError.InternalServerError = "Internal Server Error";
+/**
+ * HTTP status code to title mapping
+ */
+_A_HttpServerError.HTTP_STATUS_TITLES = {
+  // 4xx Client Errors
+  400: "Bad Request",
+  401: "Unauthorized",
+  402: "Payment Required",
+  403: "Forbidden",
+  404: "Not Found",
+  405: "Method Not Allowed",
+  406: "Not Acceptable",
+  407: "Proxy Authentication Required",
+  408: "Request Timeout",
+  409: "Conflict",
+  410: "Gone",
+  411: "Length Required",
+  412: "Precondition Failed",
+  413: "Payload Too Large",
+  414: "URI Too Long",
+  415: "Unsupported Media Type",
+  416: "Range Not Satisfiable",
+  417: "Expectation Failed",
+  418: "I'm a teapot",
+  421: "Misdirected Request",
+  422: "Unprocessable Entity",
+  423: "Locked",
+  424: "Failed Dependency",
+  425: "Too Early",
+  426: "Upgrade Required",
+  428: "Precondition Required",
+  429: "Too Many Requests",
+  431: "Request Header Fields Too Large",
+  451: "Unavailable For Legal Reasons",
+  // 5xx Server Errors
+  500: "Internal Server Error",
+  501: "Not Implemented",
+  502: "Bad Gateway",
+  503: "Service Unavailable",
+  504: "Gateway Timeout",
+  505: "HTTP Version Not Supported",
+  506: "Variant Also Negotiates",
+  507: "Insufficient Storage",
+  508: "Loop Detected",
+  510: "Not Extended",
+  511: "Network Authentication Required"
+};
+let A_HttpServerError = _A_HttpServerError;
+
+export { A_HttpServerError };
+//# sourceMappingURL=A-HttpServer.error.mjs.map
+//# sourceMappingURL=A-HttpServer.error.mjs.map

package/dist/node/lib/A-Server/A-HttpServer.error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-Server/A-HttpServer.error.ts"],"names":[],"mappings":"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","file":"A-HttpServer.error.mjs","sourcesContent":["import { A_Error } from '@adaas/a-concept';\nimport { A_HttpServerError_Init, A_HttpServerError_Serialized } from './A-HttpServer.types';\n\n\nexport class A_HttpServerError extends A_Error<A_HttpServerError_Init, A_HttpServerError_Serialized> {\n\n    static readonly NotFoundErrorStatus: number = 404;\n    static readonly NotFoundError = 'Resource Not Found';\n\n    static readonly InternalServerErrorStatus: number = 500;\n    static readonly InternalServerError = 'Internal Server Error';\n\n    /**\n     * HTTP status code to title mapping\n     */\n    private static readonly HTTP_STATUS_TITLES: Record<number, string> = {\n        // 4xx Client Errors\n        400: 'Bad Request',\n        401: 'Unauthorized',\n        402: 'Payment Required',\n        403: 'Forbidden',\n        404: 'Not Found',\n        405: 'Method Not Allowed',\n        406: 'Not Acceptable',\n        407: 'Proxy Authentication Required',\n        408: 'Request Timeout',\n        409: 'Conflict',\n        410: 'Gone',\n        411: 'Length Required',\n        412: 'Precondition Failed',\n        413: 'Payload Too Large',\n        414: 'URI Too Long',\n        415: 'Unsupported Media Type',\n        416: 'Range Not Satisfiable',\n        417: 'Expectation Failed',\n        418: 'I\\'m a teapot',\n        421: 'Misdirected Request',\n        422: 'Unprocessable Entity',\n        423: 'Locked',\n        424: 'Failed Dependency',\n        425: 'Too Early',\n        426: 'Upgrade Required',\n        428: 'Precondition Required',\n        429: 'Too Many Requests',\n        431: 'Request Header Fields Too Large',\n        451: 'Unavailable For Legal Reasons',\n\n        // 5xx Server Errors\n        500: 'Internal Server Error',\n        501: 'Not Implemented',\n        502: 'Bad Gateway',\n        503: 'Service Unavailable',\n        504: 'Gateway Timeout',\n        505: 'HTTP Version Not Supported',\n        506: 'Variant Also Negotiates',\n        507: 'Insufficient Storage',\n        508: 'Loop Detected',\n        510: 'Not Extended',\n        511: 'Network Authentication Required'\n    };\n\n    status!: number;\n\n    /**\n     * Gets the appropriate title for a given HTTP status code\n     */\n    private static getHttpStatusTitle(status: number): string {\n        return this.HTTP_STATUS_TITLES[status] || 'Unknown Error';\n    }\n\n    constructor(\n        /**\n         * A_Error Constructor params with required title\n         */\n        params: A_HttpServerError_Init\n    )\n    constructor(\n        /**\n         * Simplified params with optional title - will auto-generate from status\n         */\n        params: { status?: number; description?: string; code?: string; scope?: string; link?: string; originalError?: Error | unknown }\n    )\n    constructor(\n        /**\n         * HTTP Status Code of the error\n         */\n        status: number,\n        /**\n         * Error description\n         */\n        description: string\n    )\n    constructor(\n        /**\n         * Original JS Error\n         */\n        error: Error\n    )\n    constructor(\n        param1: A_HttpServerError_Init | { status?: number; description?: string; code?: string; scope?: string; link?: string; originalError?: Error | unknown } | Error | number,\n        param2?: string\n    ) {\n        // Handle the different constructor overloads\n        switch (true) {\n            // Pattern: new A_HttpServerError(404, 'The requested resource was not found')\n            case typeof param1 === 'number' && typeof param2 === 'string':\n                super({\n                    title: A_HttpServerError.getHttpStatusTitle(param1),\n                    description: param2\n                });\n                this.status = param1;\n                break;\n\n            // Pattern: new A_HttpServerError(someErrorObject)\n            case param1 instanceof Error:\n                super(param1);\n                this.status = 500; // Default status for Error objects\n                break;\n\n            // Pattern: new A_HttpServerError({ status: 500, description: '...', originalError: ... })\n            case typeof param1 === 'object' && param1 !== null && !(param1 instanceof Error):\n                const params = param1 as any;\n                \n                // If title is provided, use the full A_Error init\n                if ('title' in params && params.title) {\n                    super(params as A_HttpServerError_Init);\n                    this.status = params.status || 500;\n                } else {\n                    // Auto-generate title from status\n                    const title = params.status ? A_HttpServerError.getHttpStatusTitle(params.status) : 'Internal Server Error';\n                    super({\n                        title: title,\n                        description: params.description,\n                        code: params.code,\n                        scope: params.scope,\n                        link: params.link,\n                        originalError: params.originalError\n                    });\n                    this.status = params.status || 500;\n                }\n                break;\n\n            default:\n                // Fallback for any other case\n                throw new Error('Invalid parameters provided to A_HttpServerError constructor');\n        }\n    }\n\n\n    protected fromConstructor(params: A_HttpServerError_Init): void {\n        super.fromConstructor(params);\n        if (params.status) {\n            this.status = params.status;\n        }\n    }\n\n\n    toJSON(): A_HttpServerError_Serialized {\n        return {\n            ...super.toJSON(),\n            status: this.status\n        }\n    }\n}\n\n"]}

package/dist/node/lib/A-Server/A-HttpServer.types.d.mts

@@ -0,0 +1,19 @@
+import { A_TYPES__Error_Init, A_TYPES__Error_Serialized } from '@adaas/a-concept';
+import { A_HttpServerFeatures } from './A-HttpServer.constants.mjs';
+
+type A_HttpServerRequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD' | 'CONNECT' | 'TRACE' | 'DEFAULT';
+type A_HttpServerFeatureNames = typeof A_HttpServerFeatures[keyof typeof A_HttpServerFeatures];
+type A_HttpServerError_Init = {
+    /**
+     * HTTP Status Code of the error
+     */
+    status?: number;
+} & A_TYPES__Error_Init;
+type A_HttpServerError_Serialized = {
+    /**
+     * HTTP Status Code of the error
+     */
+    status: number;
+} & A_TYPES__Error_Serialized;
+
+export type { A_HttpServerError_Init, A_HttpServerError_Serialized, A_HttpServerFeatureNames, A_HttpServerRequestMethod };

package/dist/node/lib/A-Server/A-HttpServer.types.d.ts

@@ -0,0 +1,19 @@
+import { A_TYPES__Error_Init, A_TYPES__Error_Serialized } from '@adaas/a-concept';
+import { A_HttpServerFeatures } from './A-HttpServer.constants.js';
+
+type A_HttpServerRequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD' | 'CONNECT' | 'TRACE' | 'DEFAULT';
+type A_HttpServerFeatureNames = typeof A_HttpServerFeatures[keyof typeof A_HttpServerFeatures];
+type A_HttpServerError_Init = {
+    /**
+     * HTTP Status Code of the error
+     */
+    status?: number;
+} & A_TYPES__Error_Init;
+type A_HttpServerError_Serialized = {
+    /**
+     * HTTP Status Code of the error
+     */
+    status: number;
+} & A_TYPES__Error_Serialized;
+
+export type { A_HttpServerError_Init, A_HttpServerError_Serialized, A_HttpServerFeatureNames, A_HttpServerRequestMethod };

package/dist/node/lib/A-Server/A-HttpServer.types.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=A-HttpServer.types.js.map
+//# sourceMappingURL=A-HttpServer.types.js.map

package/dist/node/lib/A-Server/A-HttpServer.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"A-HttpServer.types.js"}

package/dist/node/lib/A-Server/A-HttpServer.types.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=A-HttpServer.types.mjs.map
+//# sourceMappingURL=A-HttpServer.types.mjs.map

package/dist/node/lib/A-Server/A-HttpServer.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"A-HttpServer.types.mjs"}