@adaas/a-server 0.0.28 → 0.0.30

package/dist/node/controllers/A-ListingController/A-ListingController.component.js

@@ -7,6 +7,7 @@ var AResponse_entity = require('@adaas/a-server/response/A-Response.entity');
 var AServerRouter_component = require('@adaas/a-server/router/A-ServerRouter.component');
 var AEntityList_entity = require('@adaas/a-server/entity-list/A-EntityList.entity');
 var AServerListQueryFilter_context = require('@adaas/a-server/list-query/A-ServerListQueryFilter.context');
+var AHttpServer_error = require('../../lib/A-Server/A-HttpServer.error');
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -21,25 +22,26 @@ var __decorateClass = (decorators, target, key, kind) => {
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 class A_ListingController extends aConcept.A_Component {
   async list(request, response, scope, config) {
-    const constructor = scope.resolveConstructor(request.params.type);
-    if (constructor) {
-      const entityList = new AEntityList_entity.A_ServerEntityList({
-        name: request.params.type,
-        scope: scope.name,
-        constructor
+    const ctor = scope.resolveConstructor(request.params.type);
+    if (!ctor)
+      throw new AHttpServer_error.A_HttpServerError({
+        status: 404,
+        description: `Entity type "${request.params.type}" not registered`
       });
-      scope.register(entityList);
-      const queryFilter = new AServerListQueryFilter_context.A_ServerListQueryFilter(request.query, {
-        itemsPerPage: String(config.get("A_LIST_ITEMS_PER_PAGE") || "10"),
-        page: String(config.get("A_LIST_PAGE") || "1")
-      });
-      const queryScope = new aConcept.A_Scope({
-        fragments: [queryFilter]
-      }).inherit(scope);
-      await entityList.load(queryScope);
-      response.add("items", entityList.items);
-      response.add("pagination", entityList.pagination);
-    }
+    const entityList = new AEntityList_entity.A_ServerEntityList({
+      entity: ctor
+    });
+    scope.register(entityList);
+    const queryFilter = new AServerListQueryFilter_context.A_ServerListQueryFilter(request.query, {
+      itemsPerPage: String(config.get("A_LIST_ITEMS_PER_PAGE") || "10"),
+      page: String(config.get("A_LIST_PAGE") || "1")
+    });
+    const queryScope = new aConcept.A_Scope({
+      fragments: [queryFilter]
+    }).inherit(scope);
+    await entityList.load(queryScope);
+    response.add("items", entityList.items);
+    response.add("pagination", entityList.pagination);
   }
 }
 __decorateClass([

package/dist/node/controllers/A-ListingController/A-ListingController.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/controllers/A-ListingController/A-ListingController.component.ts"],"names":["A_Component","A_ServerEntityList","A_ServerListQueryFilter","A_Scope","A_ServerRouter","A_Request","A_Response","A_Config"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAUO,MAAM,4BAA4BA,oBAAA,CAAY;AAAA,EAWjD,MAAM,IAAA,CACmB,OAAA,EACC,QAAA,EACH,OACC,MAAA,EACtB;AAEE,IAAA,MAAM,WAAA,GAAc,KAAA,CAAM,kBAAA,CAAmB,OAAA,CAAQ,OAAO,IAAI,CAAA;AAEhE,IAAA,IAAI,WAAA,EAAa;AAEb,MAAA,MAAM,UAAA,GAAa,IAAIC,qCAAA,CAAmB;AAAA,QACtC,IAAA,EAAM,QAAQ,MAAA,CAAO,IAAA;AAAA,QACrB,OAAO,KAAA,CAAM,IAAA;AAAA,QACb;AAAA,OACH,CAAA;AAED,MAAA,KAAA,CAAM,SAAS,UAAU,CAAA;AAEzB,MAAA,MAAM,WAAA,GAAc,IAAIC,sDAAA,CAAwB,OAAA,CAAQ,KAAA,EAAO;AAAA,QAC3D,cAAc,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,uBAAuB,KAAK,IAAI,CAAA;AAAA,QAChE,MAAM,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,aAAa,KAAK,GAAG;AAAA,OAChD,CAAA;AAED,MAAA,MAAM,UAAA,GAAa,IAAIC,gBAAA,CAAQ;AAAA,QAC3B,SAAA,EAAW,CAAC,WAAW;AAAA,OAC1B,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAEhB,MAAA,MAAM,UAAA,CAAW,KAAK,UAAU,CAAA;AAEhC,MAAA,QAAA,CAAS,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,KAAK,CAAA;AACtC,MAAA,QAAA,CAAS,GAAA,CAAI,YAAA,EAAc,UAAA,CAAW,UAAU,CAAA;AAAA,IACpD;AAAA,EACJ;AACJ;AAlCU,eAAA,CAAA;AAAA,EALLC,uCAAe,GAAA,CAAI;AAAA,IAChB,IAAA,EAAM,QAAA;AAAA,IACN,OAAA,EAAS,IAAA;AAAA,IACT,MAAA,EAAQ;AAAA,GACX,CAAA;AAAA,EAEI,qCAASC,yBAAS,CAAA,CAAA;AAAA,EAClB,qCAASC,2BAAU,CAAA,CAAA;AAAA,EACnB,qCAASH,gBAAO,CAAA,CAAA;AAAA,EAChB,qCAASI,gBAAQ,CAAA;AAAA,CAAA,EAfb,mBAAA,CAWH,SAAA,EAAA,MAAA,CAAA","file":"A-ListingController.component.js","sourcesContent":["import { A_Component,  A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\"\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_ServerRouter } from \"@adaas/a-server/router/A-ServerRouter.component\";\nimport { A_ServerEntityList } from \"@adaas/a-server/entity-list/A-EntityList.entity\";\nimport { A_ServerListQueryFilter } from \"@adaas/a-server/list-query/A-ServerListQueryFilter.context\";\n\n\n\nexport class A_ListingController extends A_Component {\n\n    // @A_Feature.Define({\n    //     name: 'listEntities',\n    //     invoke: false\n    // })\n    @A_ServerRouter.Get({\n        path: '/:type',\n        version: 'v1',\n        prefix: 'a-list'\n    })\n    async list(\n        @A_Inject(A_Request) request: A_Request<any, any, { type: string }>,\n        @A_Inject(A_Response) response: A_Response,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(A_Config) config: A_Config<['A_LIST_ITEMS_PER_PAGE', 'A_LIST_PAGE']>\n    ) {\n\n        const constructor = scope.resolveConstructor(request.params.type);\n\n        if (constructor) {\n\n            const entityList = new A_ServerEntityList({\n                name: request.params.type,\n                scope: scope.name,\n                constructor\n            });\n\n            scope.register(entityList);\n\n            const queryFilter = new A_ServerListQueryFilter(request.query, {\n                itemsPerPage: String(config.get('A_LIST_ITEMS_PER_PAGE') || '10'),\n                page: String(config.get('A_LIST_PAGE') || '1')\n            });\n\n            const queryScope = new A_Scope({\n                fragments: [queryFilter]\n            }).inherit(scope);\n\n            await entityList.load(queryScope);\n\n            response.add('items', entityList.items);\n            response.add('pagination', entityList.pagination);\n        }\n    }\n}"]}
+{"version":3,"sources":["../../../../src/controllers/A-ListingController/A-ListingController.component.ts"],"names":["A_Component","A_HttpServerError","A_ServerEntityList","A_ServerListQueryFilter","A_Scope","A_ServerRouter","A_Request","A_Response","A_Config"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAWO,MAAM,4BAA4BA,oBAAA,CAAY;AAAA,EAWjD,MAAM,IAAA,CACmB,OAAA,EACC,QAAA,EACH,OACC,MAAA,EACtB;AAEE,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,kBAAA,CAAmB,OAAA,CAAQ,OAAO,IAAI,CAAA;AAEzD,IAAA,IAAI,CAAC,IAAA;AACD,MAAA,MAAM,IAAIC,mCAAA,CAAkB;AAAA,QACxB,MAAA,EAAQ,GAAA;AAAA,QACR,WAAA,EAAa,CAAA,aAAA,EAAgB,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAA,gBAAA;AAAA,OACnD,CAAA;AAEL,IAAA,MAAM,UAAA,GAAa,IAAIC,qCAAA,CAAmB;AAAA,MACtC,MAAA,EAAQ;AAAA,KACX,CAAA;AAED,IAAA,KAAA,CAAM,SAAS,UAAU,CAAA;AAEzB,IAAA,MAAM,WAAA,GAAc,IAAIC,sDAAA,CAAwB,OAAA,CAAQ,KAAA,EAAO;AAAA,MAC3D,cAAc,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,uBAAuB,KAAK,IAAI,CAAA;AAAA,MAChE,MAAM,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,aAAa,KAAK,GAAG;AAAA,KAChD,CAAA;AAED,IAAA,MAAM,UAAA,GAAa,IAAIC,gBAAA,CAAQ;AAAA,MAC3B,SAAA,EAAW,CAAC,WAAW;AAAA,KAC1B,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAEhB,IAAA,MAAM,UAAA,CAAW,KAAK,UAAU,CAAA;AAEhC,IAAA,QAAA,CAAS,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,KAAK,CAAA;AACtC,IAAA,QAAA,CAAS,GAAA,CAAI,YAAA,EAAc,UAAA,CAAW,UAAU,CAAA;AAAA,EACpD;AACJ;AAnCU,eAAA,CAAA;AAAA,EALLC,uCAAe,GAAA,CAAI;AAAA,IAChB,IAAA,EAAM,QAAA;AAAA,IACN,OAAA,EAAS,IAAA;AAAA,IACT,MAAA,EAAQ;AAAA,GACX,CAAA;AAAA,EAEI,qCAASC,yBAAS,CAAA,CAAA;AAAA,EAClB,qCAASC,2BAAU,CAAA,CAAA;AAAA,EACnB,qCAASH,gBAAO,CAAA,CAAA;AAAA,EAChB,qCAASI,gBAAQ,CAAA;AAAA,CAAA,EAfb,mBAAA,CAWH,SAAA,EAAA,MAAA,CAAA","file":"A-ListingController.component.js","sourcesContent":["import { A_Component, A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\"\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_ServerRouter } from \"@adaas/a-server/router/A-ServerRouter.component\";\nimport { A_ServerEntityList } from \"@adaas/a-server/entity-list/A-EntityList.entity\";\nimport { A_ServerListQueryFilter } from \"@adaas/a-server/list-query/A-ServerListQueryFilter.context\";\nimport { A_HttpServerError } from \"../../lib/A-Server/A-HttpServer.error\";\n\n\n\nexport class A_ListingController extends A_Component {\n\n    // @A_Feature.Define({\n    //     name: 'listEntities',\n    //     invoke: false\n    // })\n    @A_ServerRouter.Get({\n        path: '/:type',\n        version: 'v1',\n        prefix: 'a-list'\n    })\n    async list(\n        @A_Inject(A_Request) request: A_Request<any, any, { type: string }>,\n        @A_Inject(A_Response) response: A_Response,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(A_Config) config: A_Config<['A_LIST_ITEMS_PER_PAGE', 'A_LIST_PAGE']>\n    ) {\n\n        const ctor = scope.resolveConstructor(request.params.type);\n\n        if (!ctor)\n            throw new A_HttpServerError({\n                status: 404,\n                description: `Entity type \"${request.params.type}\" not registered`,\n            });\n\n        const entityList = new A_ServerEntityList({\n            entity: ctor,\n        });\n\n        scope.register(entityList);\n\n        const queryFilter = new A_ServerListQueryFilter(request.query, {\n            itemsPerPage: String(config.get('A_LIST_ITEMS_PER_PAGE') || '10'),\n            page: String(config.get('A_LIST_PAGE') || '1'),\n        });\n\n        const queryScope = new A_Scope({\n            fragments: [queryFilter],\n        }).inherit(scope);\n\n        await entityList.load(queryScope);\n\n        response.add('items', entityList.items);\n        response.add('pagination', entityList.pagination);\n    }\n}"]}

package/dist/node/controllers/A-ListingController/A-ListingController.component.mjs

@@ -6,28 +6,30 @@ import { A_Response } from '@adaas/a-server/response/A-Response.entity';
 import { A_ServerRouter } from '@adaas/a-server/router/A-ServerRouter.component';
 import { A_ServerEntityList } from '@adaas/a-server/entity-list/A-EntityList.entity';
 import { A_ServerListQueryFilter } from '@adaas/a-server/list-query/A-ServerListQueryFilter.context';
+import { A_HttpServerError } from '../../lib/A-Server/A-HttpServer.error';
 
 class A_ListingController extends A_Component {
   async list(request, response, scope, config) {
-    const constructor = scope.resolveConstructor(request.params.type);
-    if (constructor) {
-      const entityList = new A_ServerEntityList({
-        name: request.params.type,
-        scope: scope.name,
-        constructor
+    const ctor = scope.resolveConstructor(request.params.type);
+    if (!ctor)
+      throw new A_HttpServerError({
+        status: 404,
+        description: `Entity type "${request.params.type}" not registered`
       });
-      scope.register(entityList);
-      const queryFilter = new A_ServerListQueryFilter(request.query, {
-        itemsPerPage: String(config.get("A_LIST_ITEMS_PER_PAGE") || "10"),
-        page: String(config.get("A_LIST_PAGE") || "1")
-      });
-      const queryScope = new A_Scope({
-        fragments: [queryFilter]
-      }).inherit(scope);
-      await entityList.load(queryScope);
-      response.add("items", entityList.items);
-      response.add("pagination", entityList.pagination);
-    }
+    const entityList = new A_ServerEntityList({
+      entity: ctor
+    });
+    scope.register(entityList);
+    const queryFilter = new A_ServerListQueryFilter(request.query, {
+      itemsPerPage: String(config.get("A_LIST_ITEMS_PER_PAGE") || "10"),
+      page: String(config.get("A_LIST_PAGE") || "1")
+    });
+    const queryScope = new A_Scope({
+      fragments: [queryFilter]
+    }).inherit(scope);
+    await entityList.load(queryScope);
+    response.add("items", entityList.items);
+    response.add("pagination", entityList.pagination);
   }
 }
 __decorateClass([

package/dist/node/controllers/A-ListingController/A-ListingController.component.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/controllers/A-ListingController/A-ListingController.component.ts"],"names":[],"mappings":";;;;;;;;;AAUO,MAAM,4BAA4B,WAAA,CAAY;AAAA,EAWjD,MAAM,IAAA,CACmB,OAAA,EACC,QAAA,EACH,OACC,MAAA,EACtB;AAEE,IAAA,MAAM,WAAA,GAAc,KAAA,CAAM,kBAAA,CAAmB,OAAA,CAAQ,OAAO,IAAI,CAAA;AAEhE,IAAA,IAAI,WAAA,EAAa;AAEb,MAAA,MAAM,UAAA,GAAa,IAAI,kBAAA,CAAmB;AAAA,QACtC,IAAA,EAAM,QAAQ,MAAA,CAAO,IAAA;AAAA,QACrB,OAAO,KAAA,CAAM,IAAA;AAAA,QACb;AAAA,OACH,CAAA;AAED,MAAA,KAAA,CAAM,SAAS,UAAU,CAAA;AAEzB,MAAA,MAAM,WAAA,GAAc,IAAI,uBAAA,CAAwB,OAAA,CAAQ,KAAA,EAAO;AAAA,QAC3D,cAAc,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,uBAAuB,KAAK,IAAI,CAAA;AAAA,QAChE,MAAM,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,aAAa,KAAK,GAAG;AAAA,OAChD,CAAA;AAED,MAAA,MAAM,UAAA,GAAa,IAAI,OAAA,CAAQ;AAAA,QAC3B,SAAA,EAAW,CAAC,WAAW;AAAA,OAC1B,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAEhB,MAAA,MAAM,UAAA,CAAW,KAAK,UAAU,CAAA;AAEhC,MAAA,QAAA,CAAS,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,KAAK,CAAA;AACtC,MAAA,QAAA,CAAS,GAAA,CAAI,YAAA,EAAc,UAAA,CAAW,UAAU,CAAA;AAAA,IACpD;AAAA,EACJ;AACJ;AAlCU,eAAA,CAAA;AAAA,EALL,eAAe,GAAA,CAAI;AAAA,IAChB,IAAA,EAAM,QAAA;AAAA,IACN,OAAA,EAAS,IAAA;AAAA,IACT,MAAA,EAAQ;AAAA,GACX,CAAA;AAAA,EAEI,4BAAS,SAAS,CAAA,CAAA;AAAA,EAClB,4BAAS,UAAU,CAAA,CAAA;AAAA,EACnB,4BAAS,OAAO,CAAA,CAAA;AAAA,EAChB,4BAAS,QAAQ,CAAA;AAAA,CAAA,EAfb,mBAAA,CAWH,SAAA,EAAA,MAAA,EAAA,CAAA,CAAA","file":"A-ListingController.component.mjs","sourcesContent":["import { A_Component,  A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\"\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_ServerRouter } from \"@adaas/a-server/router/A-ServerRouter.component\";\nimport { A_ServerEntityList } from \"@adaas/a-server/entity-list/A-EntityList.entity\";\nimport { A_ServerListQueryFilter } from \"@adaas/a-server/list-query/A-ServerListQueryFilter.context\";\n\n\n\nexport class A_ListingController extends A_Component {\n\n    // @A_Feature.Define({\n    //     name: 'listEntities',\n    //     invoke: false\n    // })\n    @A_ServerRouter.Get({\n        path: '/:type',\n        version: 'v1',\n        prefix: 'a-list'\n    })\n    async list(\n        @A_Inject(A_Request) request: A_Request<any, any, { type: string }>,\n        @A_Inject(A_Response) response: A_Response,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(A_Config) config: A_Config<['A_LIST_ITEMS_PER_PAGE', 'A_LIST_PAGE']>\n    ) {\n\n        const constructor = scope.resolveConstructor(request.params.type);\n\n        if (constructor) {\n\n            const entityList = new A_ServerEntityList({\n                name: request.params.type,\n                scope: scope.name,\n                constructor\n            });\n\n            scope.register(entityList);\n\n            const queryFilter = new A_ServerListQueryFilter(request.query, {\n                itemsPerPage: String(config.get('A_LIST_ITEMS_PER_PAGE') || '10'),\n                page: String(config.get('A_LIST_PAGE') || '1')\n            });\n\n            const queryScope = new A_Scope({\n                fragments: [queryFilter]\n            }).inherit(scope);\n\n            await entityList.load(queryScope);\n\n            response.add('items', entityList.items);\n            response.add('pagination', entityList.pagination);\n        }\n    }\n}"]}
+{"version":3,"sources":["../../../../src/controllers/A-ListingController/A-ListingController.component.ts"],"names":[],"mappings":";;;;;;;;;;AAWO,MAAM,4BAA4B,WAAA,CAAY;AAAA,EAWjD,MAAM,IAAA,CACmB,OAAA,EACC,QAAA,EACH,OACC,MAAA,EACtB;AAEE,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,kBAAA,CAAmB,OAAA,CAAQ,OAAO,IAAI,CAAA;AAEzD,IAAA,IAAI,CAAC,IAAA;AACD,MAAA,MAAM,IAAI,iBAAA,CAAkB;AAAA,QACxB,MAAA,EAAQ,GAAA;AAAA,QACR,WAAA,EAAa,CAAA,aAAA,EAAgB,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAA,gBAAA;AAAA,OACnD,CAAA;AAEL,IAAA,MAAM,UAAA,GAAa,IAAI,kBAAA,CAAmB;AAAA,MACtC,MAAA,EAAQ;AAAA,KACX,CAAA;AAED,IAAA,KAAA,CAAM,SAAS,UAAU,CAAA;AAEzB,IAAA,MAAM,WAAA,GAAc,IAAI,uBAAA,CAAwB,OAAA,CAAQ,KAAA,EAAO;AAAA,MAC3D,cAAc,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,uBAAuB,KAAK,IAAI,CAAA;AAAA,MAChE,MAAM,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,aAAa,KAAK,GAAG;AAAA,KAChD,CAAA;AAED,IAAA,MAAM,UAAA,GAAa,IAAI,OAAA,CAAQ;AAAA,MAC3B,SAAA,EAAW,CAAC,WAAW;AAAA,KAC1B,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAEhB,IAAA,MAAM,UAAA,CAAW,KAAK,UAAU,CAAA;AAEhC,IAAA,QAAA,CAAS,GAAA,CAAI,OAAA,EAAS,UAAA,CAAW,KAAK,CAAA;AACtC,IAAA,QAAA,CAAS,GAAA,CAAI,YAAA,EAAc,UAAA,CAAW,UAAU,CAAA;AAAA,EACpD;AACJ;AAnCU,eAAA,CAAA;AAAA,EALL,eAAe,GAAA,CAAI;AAAA,IAChB,IAAA,EAAM,QAAA;AAAA,IACN,OAAA,EAAS,IAAA;AAAA,IACT,MAAA,EAAQ;AAAA,GACX,CAAA;AAAA,EAEI,4BAAS,SAAS,CAAA,CAAA;AAAA,EAClB,4BAAS,UAAU,CAAA,CAAA;AAAA,EACnB,4BAAS,OAAO,CAAA,CAAA;AAAA,EAChB,4BAAS,QAAQ,CAAA;AAAA,CAAA,EAfb,mBAAA,CAWH,SAAA,EAAA,MAAA,EAAA,CAAA,CAAA","file":"A-ListingController.component.mjs","sourcesContent":["import { A_Component, A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\"\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_ServerRouter } from \"@adaas/a-server/router/A-ServerRouter.component\";\nimport { A_ServerEntityList } from \"@adaas/a-server/entity-list/A-EntityList.entity\";\nimport { A_ServerListQueryFilter } from \"@adaas/a-server/list-query/A-ServerListQueryFilter.context\";\nimport { A_HttpServerError } from \"../../lib/A-Server/A-HttpServer.error\";\n\n\n\nexport class A_ListingController extends A_Component {\n\n    // @A_Feature.Define({\n    //     name: 'listEntities',\n    //     invoke: false\n    // })\n    @A_ServerRouter.Get({\n        path: '/:type',\n        version: 'v1',\n        prefix: 'a-list'\n    })\n    async list(\n        @A_Inject(A_Request) request: A_Request<any, any, { type: string }>,\n        @A_Inject(A_Response) response: A_Response,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(A_Config) config: A_Config<['A_LIST_ITEMS_PER_PAGE', 'A_LIST_PAGE']>\n    ) {\n\n        const ctor = scope.resolveConstructor(request.params.type);\n\n        if (!ctor)\n            throw new A_HttpServerError({\n                status: 404,\n                description: `Entity type \"${request.params.type}\" not registered`,\n            });\n\n        const entityList = new A_ServerEntityList({\n            entity: ctor,\n        });\n\n        scope.register(entityList);\n\n        const queryFilter = new A_ServerListQueryFilter(request.query, {\n            itemsPerPage: String(config.get('A_LIST_ITEMS_PER_PAGE') || '10'),\n            page: String(config.get('A_LIST_PAGE') || '1'),\n        });\n\n        const queryScope = new A_Scope({\n            fragments: [queryFilter],\n        }).inherit(scope);\n\n        await entityList.load(queryScope);\n\n        response.add('items', entityList.items);\n        response.add('pagination', entityList.pagination);\n    }\n}"]}

package/dist/node/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.d.mts

@@ -19,8 +19,6 @@ import '../../lib/A-ServerRoute/A-ServerRoute.types.mjs';
 import '../../lib/A-ServerRoute/A-ServerRoute.constants.mjs';
 import 'stream';
 import '../../lib/A-Response/A-Response.constants.mjs';
-import '../../lib/A-Server/A-Server.context.mjs';
-import '../../lib/A-Server/A-Server.types.mjs';
 import '@adaas/a-utils/a-logger';
 
 declare class A_ServerHealthMonitor extends A_Component {

package/dist/node/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.d.ts

@@ -19,8 +19,6 @@ import '../../lib/A-ServerRoute/A-ServerRoute.types.js';
 import '../../lib/A-ServerRoute/A-ServerRoute.constants.js';
 import 'stream';
 import '../../lib/A-Response/A-Response.constants.js';
-import '../../lib/A-Server/A-Server.context.js';
-import '../../lib/A-Server/A-Server.types.js';
 import '@adaas/a-utils/a-logger';
 
 declare class A_ServerHealthMonitor extends A_Component {

package/dist/node/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.js

@@ -6,6 +6,7 @@ var ARequest_entity = require('@adaas/a-server/request/A-Request.entity');
 var AResponse_entity = require('@adaas/a-server/response/A-Response.entity');
 var aConfig = require('@adaas/a-utils/a-config');
 var AServerLogger_component = require('@adaas/a-server/logger/A-ServerLogger.component');
+var AHttpServer_error = require('../../lib/A-Server/A-HttpServer.error');
 var fs = require('fs');
 var path = require('path');
 
@@ -29,7 +30,15 @@ class A_ServerHealthMonitor extends aConcept.A_Component {
   async get(config, request, response, logger) {
     const rootFolder = config.get("A_CONCEPT_ROOT_FOLDER") || aConcept.A_CONCEPT_ENV.A_CONCEPT_ROOT_FOLDER || process.cwd();
     const pkgPath = path__default.default.join(rootFolder, "package.json");
-    const packageJSON = JSON.parse(fs__default.default.readFileSync(pkgPath, "utf-8"));
+    let packageJSON;
+    try {
+      packageJSON = JSON.parse(fs__default.default.readFileSync(pkgPath, "utf-8"));
+    } catch {
+      throw new AHttpServer_error.A_HttpServerError({
+        status: 500,
+        description: `Could not read package.json at "${pkgPath}"`
+      });
+    }
     const exposedProperties = config.get("EXPOSED_PROPERTIES")?.split(",") || [
       "name",
       "version",

package/dist/node/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.ts"],"names":["A_Component","A_CONCEPT_ENV","path","fs","A_ServerRouter","A_Config","A_Request","A_Response","A_ServerLogger"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAWO,MAAM,8BAA8BA,oBAAA,CAAY;AAAA,EAYnD,MAAM,GAAA,CACkB,MAAA,EACC,OAAA,EACC,UACI,MAAA,EACd;AACZ,IAAA,MAAM,UAAA,GAAa,OAAO,GAAA,CAAI,uBAAuB,KAAKC,sBAAA,CAAc,qBAAA,IAAyB,QAAQ,GAAA,EAAI;AAC7G,IAAA,MAAM,OAAA,GAAUC,qBAAA,CAAK,IAAA,CAAK,UAAA,EAAY,cAAc,CAAA;AACpD,IAAA,MAAM,cAAc,IAAA,CAAK,KAAA,CAAMC,oBAAG,YAAA,CAAa,OAAA,EAAS,OAAO,CAAC,CAAA;AAGhE,IAAA,MAAM,oBAAmC,MAAA,CAAO,GAAA,CAAI,oBAAoB,CAAA,EAAG,KAAA,CAAM,GAAG,CAAA,IAAK;AAAA,MACrF,MAAA;AAAA,MACA,SAAA;AAAA,MACA;AAAA,KACJ;AAEA,IAAA,iBAAA,CAAkB,OAAA,CAAQ,UAAQ,QAAA,CAAS,GAAA,CAAI,MAAM,WAAA,CAAY,IAAI,CAAC,CAAC,CAAA;AAAA,EAC3E;AACJ;AAnBU,eAAA,CAAA;AAAA,EALLC,uCAAe,GAAA,CAAI;AAAA,IAChB,IAAA,EAAM,GAAA;AAAA,IACN,MAAA,EAAQ,QAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACZ,CAAA;AAAA,EAEI,qCAASC,gBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,yBAAS,CAAA,CAAA;AAAA,EAClB,qCAASC,2BAAU,CAAA,CAAA;AAAA,EACnB,qCAASC,sCAAc,CAAA;AAAA,CAAA,EAhBnB,qBAAA,CAYH,SAAA,EAAA,KAAA,CAAA","file":"A-ServerHealthMonitor.component.js","sourcesContent":["import { A_Component, A_CONCEPT_ENV, A_Inject } from \"@adaas/a-concept\";\nimport { A_ServerRouter } from \"@adaas/a-server/router/A-ServerRouter.component\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_ServerLogger } from \"@adaas/a-server/logger/A-ServerLogger.component\";\nimport fs from \"fs\";\nimport path from \"path\";\n\n\n\nexport class A_ServerHealthMonitor extends A_Component {\n\n\n    // =======================================================\n    // ================ Method Definition=====================\n    // =======================================================\n\n    @A_ServerRouter.Get({\n        path: '/',\n        prefix: 'health',\n        version: 'v1',\n    })\n    async get(\n        @A_Inject(A_Config) config: A_Config<['VERSION_PATH', 'EXPOSED_PROPERTIES']>,\n        @A_Inject(A_Request) request: A_Request,\n        @A_Inject(A_Response) response: A_Response,\n        @A_Inject(A_ServerLogger) logger: A_ServerLogger\n    ): Promise<any> {\n        const rootFolder = config.get('A_CONCEPT_ROOT_FOLDER') || A_CONCEPT_ENV.A_CONCEPT_ROOT_FOLDER || process.cwd();\n        const pkgPath = path.join(rootFolder, 'package.json');\n        const packageJSON = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n\n\n        const exposedProperties: Array<string> = config.get('EXPOSED_PROPERTIES')?.split(',') || [\n            'name',\n            'version',\n            'description',\n        ];\n\n        exposedProperties.forEach(prop => response.add(prop, packageJSON[prop]));\n    }\n}"]}
+{"version":3,"sources":["../../../../src/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.ts"],"names":["A_Component","A_CONCEPT_ENV","path","fs","A_HttpServerError","A_ServerRouter","A_Config","A_Request","A_Response","A_ServerLogger"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYO,MAAM,8BAA8BA,oBAAA,CAAY;AAAA,EAYnD,MAAM,GAAA,CACkB,MAAA,EACC,OAAA,EACC,UACI,MAAA,EACd;AACZ,IAAA,MAAM,UAAA,GAAa,OAAO,GAAA,CAAI,uBAAuB,KAAKC,sBAAA,CAAc,qBAAA,IAAyB,QAAQ,GAAA,EAAI;AAC7G,IAAA,MAAM,OAAA,GAAUC,qBAAA,CAAK,IAAA,CAAK,UAAA,EAAY,cAAc,CAAA;AAEpD,IAAA,IAAI,WAAA;AAEJ,IAAA,IAAI;AACA,MAAA,WAAA,GAAc,KAAK,KAAA,CAAMC,mBAAA,CAAG,YAAA,CAAa,OAAA,EAAS,OAAO,CAAC,CAAA;AAAA,IAC9D,CAAA,CAAA,MAAQ;AACJ,MAAA,MAAM,IAAIC,mCAAA,CAAkB;AAAA,QACxB,MAAA,EAAQ,GAAA;AAAA,QACR,WAAA,EAAa,mCAAmC,OAAO,CAAA,CAAA;AAAA,OAC1D,CAAA;AAAA,IACL;AAEA,IAAA,MAAM,oBAAmC,MAAA,CAAO,GAAA,CAAI,oBAAoB,CAAA,EAAG,KAAA,CAAM,GAAG,CAAA,IAAK;AAAA,MACrF,MAAA;AAAA,MACA,SAAA;AAAA,MACA;AAAA,KACJ;AAEA,IAAA,iBAAA,CAAkB,OAAA,CAAQ,UAAQ,QAAA,CAAS,GAAA,CAAI,MAAM,WAAA,CAAY,IAAI,CAAC,CAAC,CAAA;AAAA,EAC3E;AACJ;AA5BU,eAAA,CAAA;AAAA,EALLC,uCAAe,GAAA,CAAI;AAAA,IAChB,IAAA,EAAM,GAAA;AAAA,IACN,MAAA,EAAQ,QAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACZ,CAAA;AAAA,EAEI,qCAASC,gBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,yBAAS,CAAA,CAAA;AAAA,EAClB,qCAASC,2BAAU,CAAA,CAAA;AAAA,EACnB,qCAASC,sCAAc,CAAA;AAAA,CAAA,EAhBnB,qBAAA,CAYH,SAAA,EAAA,KAAA,CAAA","file":"A-ServerHealthMonitor.component.js","sourcesContent":["import { A_Component, A_CONCEPT_ENV, A_Inject } from \"@adaas/a-concept\";\nimport { A_ServerRouter } from \"@adaas/a-server/router/A-ServerRouter.component\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_ServerLogger } from \"@adaas/a-server/logger/A-ServerLogger.component\";\nimport { A_HttpServerError } from \"../../lib/A-Server/A-HttpServer.error\";\nimport fs from \"fs\";\nimport path from \"path\";\n\n\n\nexport class A_ServerHealthMonitor extends A_Component {\n\n\n    // =======================================================\n    // ================ Method Definition=====================\n    // =======================================================\n\n    @A_ServerRouter.Get({\n        path: '/',\n        prefix: 'health',\n        version: 'v1',\n    })\n    async get(\n        @A_Inject(A_Config) config: A_Config<['VERSION_PATH', 'EXPOSED_PROPERTIES']>,\n        @A_Inject(A_Request) request: A_Request,\n        @A_Inject(A_Response) response: A_Response,\n        @A_Inject(A_ServerLogger) logger: A_ServerLogger\n    ): Promise<any> {\n        const rootFolder = config.get('A_CONCEPT_ROOT_FOLDER') || A_CONCEPT_ENV.A_CONCEPT_ROOT_FOLDER || process.cwd();\n        const pkgPath = path.join(rootFolder, 'package.json');\n\n        let packageJSON: Record<string, unknown>;\n\n        try {\n            packageJSON = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n        } catch {\n            throw new A_HttpServerError({\n                status: 500,\n                description: `Could not read package.json at \"${pkgPath}\"`,\n            });\n        }\n\n        const exposedProperties: Array<string> = config.get('EXPOSED_PROPERTIES')?.split(',') || [\n            'name',\n            'version',\n            'description',\n        ];\n\n        exposedProperties.forEach(prop => response.add(prop, packageJSON[prop]));\n    }\n}"]}

package/dist/node/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.mjs

@@ -5,6 +5,7 @@ import { A_Request } from '@adaas/a-server/request/A-Request.entity';
 import { A_Response } from '@adaas/a-server/response/A-Response.entity';
 import { A_Config } from '@adaas/a-utils/a-config';
 import { A_ServerLogger } from '@adaas/a-server/logger/A-ServerLogger.component';
+import { A_HttpServerError } from '../../lib/A-Server/A-HttpServer.error';
 import fs from 'fs';
 import path from 'path';
 
@@ -12,7 +13,15 @@ class A_ServerHealthMonitor extends A_Component {
   async get(config, request, response, logger) {
     const rootFolder = config.get("A_CONCEPT_ROOT_FOLDER") || A_CONCEPT_ENV.A_CONCEPT_ROOT_FOLDER || process.cwd();
     const pkgPath = path.join(rootFolder, "package.json");
-    const packageJSON = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    let packageJSON;
+    try {
+      packageJSON = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    } catch {
+      throw new A_HttpServerError({
+        status: 500,
+        description: `Could not read package.json at "${pkgPath}"`
+      });
+    }
     const exposedProperties = config.get("EXPOSED_PROPERTIES")?.split(",") || [
       "name",
       "version",

package/dist/node/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.ts"],"names":[],"mappings":";;;;;;;;;;AAWO,MAAM,8BAA8B,WAAA,CAAY;AAAA,EAYnD,MAAM,GAAA,CACkB,MAAA,EACC,OAAA,EACC,UACI,MAAA,EACd;AACZ,IAAA,MAAM,UAAA,GAAa,OAAO,GAAA,CAAI,uBAAuB,KAAK,aAAA,CAAc,qBAAA,IAAyB,QAAQ,GAAA,EAAI;AAC7G,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,IAAA,CAAK,UAAA,EAAY,cAAc,CAAA;AACpD,IAAA,MAAM,cAAc,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,OAAA,EAAS,OAAO,CAAC,CAAA;AAGhE,IAAA,MAAM,oBAAmC,MAAA,CAAO,GAAA,CAAI,oBAAoB,CAAA,EAAG,KAAA,CAAM,GAAG,CAAA,IAAK;AAAA,MACrF,MAAA;AAAA,MACA,SAAA;AAAA,MACA;AAAA,KACJ;AAEA,IAAA,iBAAA,CAAkB,OAAA,CAAQ,UAAQ,QAAA,CAAS,GAAA,CAAI,MAAM,WAAA,CAAY,IAAI,CAAC,CAAC,CAAA;AAAA,EAC3E;AACJ;AAnBU,eAAA,CAAA;AAAA,EALL,eAAe,GAAA,CAAI;AAAA,IAChB,IAAA,EAAM,GAAA;AAAA,IACN,MAAA,EAAQ,QAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACZ,CAAA;AAAA,EAEI,4BAAS,QAAQ,CAAA,CAAA;AAAA,EACjB,4BAAS,SAAS,CAAA,CAAA;AAAA,EAClB,4BAAS,UAAU,CAAA,CAAA;AAAA,EACnB,4BAAS,cAAc,CAAA;AAAA,CAAA,EAhBnB,qBAAA,CAYH,SAAA,EAAA,KAAA,EAAA,CAAA,CAAA","file":"A-ServerHealthMonitor.component.mjs","sourcesContent":["import { A_Component, A_CONCEPT_ENV, A_Inject } from \"@adaas/a-concept\";\nimport { A_ServerRouter } from \"@adaas/a-server/router/A-ServerRouter.component\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_ServerLogger } from \"@adaas/a-server/logger/A-ServerLogger.component\";\nimport fs from \"fs\";\nimport path from \"path\";\n\n\n\nexport class A_ServerHealthMonitor extends A_Component {\n\n\n    // =======================================================\n    // ================ Method Definition=====================\n    // =======================================================\n\n    @A_ServerRouter.Get({\n        path: '/',\n        prefix: 'health',\n        version: 'v1',\n    })\n    async get(\n        @A_Inject(A_Config) config: A_Config<['VERSION_PATH', 'EXPOSED_PROPERTIES']>,\n        @A_Inject(A_Request) request: A_Request,\n        @A_Inject(A_Response) response: A_Response,\n        @A_Inject(A_ServerLogger) logger: A_ServerLogger\n    ): Promise<any> {\n        const rootFolder = config.get('A_CONCEPT_ROOT_FOLDER') || A_CONCEPT_ENV.A_CONCEPT_ROOT_FOLDER || process.cwd();\n        const pkgPath = path.join(rootFolder, 'package.json');\n        const packageJSON = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n\n\n        const exposedProperties: Array<string> = config.get('EXPOSED_PROPERTIES')?.split(',') || [\n            'name',\n            'version',\n            'description',\n        ];\n\n        exposedProperties.forEach(prop => response.add(prop, packageJSON[prop]));\n    }\n}"]}
+{"version":3,"sources":["../../../../src/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.ts"],"names":[],"mappings":";;;;;;;;;;;AAYO,MAAM,8BAA8B,WAAA,CAAY;AAAA,EAYnD,MAAM,GAAA,CACkB,MAAA,EACC,OAAA,EACC,UACI,MAAA,EACd;AACZ,IAAA,MAAM,UAAA,GAAa,OAAO,GAAA,CAAI,uBAAuB,KAAK,aAAA,CAAc,qBAAA,IAAyB,QAAQ,GAAA,EAAI;AAC7G,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,IAAA,CAAK,UAAA,EAAY,cAAc,CAAA;AAEpD,IAAA,IAAI,WAAA;AAEJ,IAAA,IAAI;AACA,MAAA,WAAA,GAAc,KAAK,KAAA,CAAM,EAAA,CAAG,YAAA,CAAa,OAAA,EAAS,OAAO,CAAC,CAAA;AAAA,IAC9D,CAAA,CAAA,MAAQ;AACJ,MAAA,MAAM,IAAI,iBAAA,CAAkB;AAAA,QACxB,MAAA,EAAQ,GAAA;AAAA,QACR,WAAA,EAAa,mCAAmC,OAAO,CAAA,CAAA;AAAA,OAC1D,CAAA;AAAA,IACL;AAEA,IAAA,MAAM,oBAAmC,MAAA,CAAO,GAAA,CAAI,oBAAoB,CAAA,EAAG,KAAA,CAAM,GAAG,CAAA,IAAK;AAAA,MACrF,MAAA;AAAA,MACA,SAAA;AAAA,MACA;AAAA,KACJ;AAEA,IAAA,iBAAA,CAAkB,OAAA,CAAQ,UAAQ,QAAA,CAAS,GAAA,CAAI,MAAM,WAAA,CAAY,IAAI,CAAC,CAAC,CAAA;AAAA,EAC3E;AACJ;AA5BU,eAAA,CAAA;AAAA,EALL,eAAe,GAAA,CAAI;AAAA,IAChB,IAAA,EAAM,GAAA;AAAA,IACN,MAAA,EAAQ,QAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACZ,CAAA;AAAA,EAEI,4BAAS,QAAQ,CAAA,CAAA;AAAA,EACjB,4BAAS,SAAS,CAAA,CAAA;AAAA,EAClB,4BAAS,UAAU,CAAA,CAAA;AAAA,EACnB,4BAAS,cAAc,CAAA;AAAA,CAAA,EAhBnB,qBAAA,CAYH,SAAA,EAAA,KAAA,EAAA,CAAA,CAAA","file":"A-ServerHealthMonitor.component.mjs","sourcesContent":["import { A_Component, A_CONCEPT_ENV, A_Inject } from \"@adaas/a-concept\";\nimport { A_ServerRouter } from \"@adaas/a-server/router/A-ServerRouter.component\";\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_Config } from \"@adaas/a-utils/a-config\";\nimport { A_ServerLogger } from \"@adaas/a-server/logger/A-ServerLogger.component\";\nimport { A_HttpServerError } from \"../../lib/A-Server/A-HttpServer.error\";\nimport fs from \"fs\";\nimport path from \"path\";\n\n\n\nexport class A_ServerHealthMonitor extends A_Component {\n\n\n    // =======================================================\n    // ================ Method Definition=====================\n    // =======================================================\n\n    @A_ServerRouter.Get({\n        path: '/',\n        prefix: 'health',\n        version: 'v1',\n    })\n    async get(\n        @A_Inject(A_Config) config: A_Config<['VERSION_PATH', 'EXPOSED_PROPERTIES']>,\n        @A_Inject(A_Request) request: A_Request,\n        @A_Inject(A_Response) response: A_Response,\n        @A_Inject(A_ServerLogger) logger: A_ServerLogger\n    ): Promise<any> {\n        const rootFolder = config.get('A_CONCEPT_ROOT_FOLDER') || A_CONCEPT_ENV.A_CONCEPT_ROOT_FOLDER || process.cwd();\n        const pkgPath = path.join(rootFolder, 'package.json');\n\n        let packageJSON: Record<string, unknown>;\n\n        try {\n            packageJSON = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n        } catch {\n            throw new A_HttpServerError({\n                status: 500,\n                description: `Could not read package.json at \"${pkgPath}\"`,\n            });\n        }\n\n        const exposedProperties: Array<string> = config.get('EXPOSED_PROPERTIES')?.split(',') || [\n            'name',\n            'version',\n            'description',\n        ];\n\n        exposedProperties.forEach(prop => response.add(prop, packageJSON[prop]));\n    }\n}"]}

package/dist/node/index.d.mts

@@ -17,7 +17,9 @@ export { A_ServerError } from './lib/A-Server/A-Server.error.mjs';
 export { A_SERVER_TYPES__ServerConstructor, A_SERVER_TYPES__ServerError_Init, A_SERVER_TYPES__ServerError_Serialized } from './lib/A-Server/A-Server.types.mjs';
 export { A_ServerController } from './lib/A-ServerController/A-ServerController.component.mjs';
 export { A_ServerEntityList } from './lib/A-ServerEntityList/A-EntityList.entity.mjs';
-export { A_SERVER_TYPES__A_EntityListConstructor, A_SERVER_TYPES__A_EntityListEvent, A_SERVER_TYPES__A_EntityListPagination, A_SERVER_TYPES__A_EntityListSerialized } from './lib/A-ServerEntityList/A-EntityList.types.mjs';
+export { A_SERVER_TYPES__A_EntityListCacheEntry, A_SERVER_TYPES__A_EntityListConstructor, A_SERVER_TYPES__A_EntityListEvent, A_SERVER_TYPES__A_EntityListPagination, A_SERVER_TYPES__A_EntityListSerialized } from './lib/A-ServerEntityList/A-EntityList.types.mjs';
+export { A_SERVER_TYPES__A_EntityListPaginationSerialized, A_ServerEntityListPagination } from './lib/A-ServerEntityList/A-EntityListPagination.context.mjs';
+export { A_ServerEntityListCacheState } from './lib/A-ServerEntityList/A-EntityListCacheState.context.mjs';
 export { A_ServerListQueryFilter } from './lib/A-ServerListQuery/A-ServerListQueryFilter.context.mjs';
 export { A_SERVER__A_SERVER_LOGGER_ENV_VARIABLES } from './lib/A-ServerLogger/A-ServerLogger.constants.mjs';
 export { A_ServerLogger } from './lib/A-ServerLogger/A-ServerLogger.component.mjs';

package/dist/node/index.d.ts

@@ -17,7 +17,9 @@ export { A_ServerError } from './lib/A-Server/A-Server.error.js';
 export { A_SERVER_TYPES__ServerConstructor, A_SERVER_TYPES__ServerError_Init, A_SERVER_TYPES__ServerError_Serialized } from './lib/A-Server/A-Server.types.js';
 export { A_ServerController } from './lib/A-ServerController/A-ServerController.component.js';
 export { A_ServerEntityList } from './lib/A-ServerEntityList/A-EntityList.entity.js';
-export { A_SERVER_TYPES__A_EntityListConstructor, A_SERVER_TYPES__A_EntityListEvent, A_SERVER_TYPES__A_EntityListPagination, A_SERVER_TYPES__A_EntityListSerialized } from './lib/A-ServerEntityList/A-EntityList.types.js';
+export { A_SERVER_TYPES__A_EntityListCacheEntry, A_SERVER_TYPES__A_EntityListConstructor, A_SERVER_TYPES__A_EntityListEvent, A_SERVER_TYPES__A_EntityListPagination, A_SERVER_TYPES__A_EntityListSerialized } from './lib/A-ServerEntityList/A-EntityList.types.js';
+export { A_SERVER_TYPES__A_EntityListPaginationSerialized, A_ServerEntityListPagination } from './lib/A-ServerEntityList/A-EntityListPagination.context.js';
+export { A_ServerEntityListCacheState } from './lib/A-ServerEntityList/A-EntityListCacheState.context.js';
 export { A_ServerListQueryFilter } from './lib/A-ServerListQuery/A-ServerListQueryFilter.context.js';
 export { A_SERVER__A_SERVER_LOGGER_ENV_VARIABLES } from './lib/A-ServerLogger/A-ServerLogger.constants.js';
 export { A_ServerLogger } from './lib/A-ServerLogger/A-ServerLogger.component.js';

package/dist/node/index.js

@@ -24,6 +24,8 @@ var AServerController_component = require('./lib/A-ServerController/A-ServerCont
 var AServerController_types = require('./lib/A-ServerController/A-ServerController.types');
 var AEntityList_entity = require('./lib/A-ServerEntityList/A-EntityList.entity');
 var AEntityList_types = require('./lib/A-ServerEntityList/A-EntityList.types');
+var AEntityListPagination_context = require('./lib/A-ServerEntityList/A-EntityListPagination.context');
+var AEntityListCacheState_context = require('./lib/A-ServerEntityList/A-EntityListCacheState.context');
 var AServerListQueryFilter_context = require('./lib/A-ServerListQuery/A-ServerListQueryFilter.context');
 var AServerLogger_constants = require('./lib/A-ServerLogger/A-ServerLogger.constants');
 var AServerLogger_component = require('./lib/A-ServerLogger/A-ServerLogger.component');
@@ -196,6 +198,18 @@ Object.keys(AEntityList_types).forEach(function (k) {
     get: function () { return AEntityList_types[k]; }
   });
 });
+Object.keys(AEntityListPagination_context).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return AEntityListPagination_context[k]; }
+  });
+});
+Object.keys(AEntityListCacheState_context).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return AEntityListCacheState_context[k]; }
+  });
+});
 Object.keys(AServerListQueryFilter_context).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,

package/dist/node/index.mjs

@@ -23,6 +23,8 @@ export * from './lib/A-ServerController/A-ServerController.component';
 export * from './lib/A-ServerController/A-ServerController.types';
 export * from './lib/A-ServerEntityList/A-EntityList.entity';
 export * from './lib/A-ServerEntityList/A-EntityList.types';
+export * from './lib/A-ServerEntityList/A-EntityListPagination.context';
+export * from './lib/A-ServerEntityList/A-EntityListCacheState.context';
 export * from './lib/A-ServerListQuery/A-ServerListQueryFilter.context';
 export * from './lib/A-ServerLogger/A-ServerLogger.constants';
 export * from './lib/A-ServerLogger/A-ServerLogger.component';

package/dist/node/lib/A-Request/A-Request.helper.js

@@ -73,7 +73,7 @@ class A_RequestHelper {
     let bodyType;
     switch (true) {
       case (!!context.contentType && context.contentType.includes("application/json")):
-        parsedBody = JSON.parse(context.data);
+        parsedBody = JSON.parse(context.data || "{}");
         bodyType = "json";
         break;
       case (!!context.contentType && context.contentType.includes("application/x-www-form-urlencoded")):

package/dist/node/lib/A-Request/A-Request.helper.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/A-Request/A-Request.helper.ts"],"names":["A_RequestError"],"mappings":"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","file":"A-Request.helper.js","sourcesContent":["import { A_HttpServerRequestContext } from \"./A-HttpServerRequest.context\";\nimport { A_RequestError } from \"./A-Request.error\";\nimport { A_Request_BodyType, A_Request_FileUpload } from \"./A-Request.types\";\n\n/**\n * A_RequestHelper - Stateless utility class for HTTP request processing\n * \n * This helper class provides static methods for parsing and processing HTTP request data:\n * - URL parameter extraction from route patterns\n * - Query string parsing\n * - Request body parsing (JSON, form-data, multipart, raw)\n * - URL-encoded form data parsing\n * - Multipart form data parsing (including file uploads)\n * \n * All methods are stateless and only depend on input parameters.\n * \n * @example\n * ```typescript\n * // Extract URL parameters\n * const params = A_RequestHelper.extractParams('/users/123', '/users/:id');\n * // { id: '123' }\n * \n * // Parse query string\n * const query = A_RequestHelper.extractQuery('/api/users?page=1&limit=10');\n * // { page: '1', limit: '10' }\n * \n * // Parse request body\n * const result = await A_RequestHelper.parseRequestBody(req, { maxBodySize: 1024 * 1024 });\n * // { data: {...}, type: 'json' }\n * ```\n */\nexport class A_RequestHelper {\n\n    /**\n     * Extract URL parameters from a URL using a route pattern\n     * @param url - The actual URL to extract parameters from\n     * @param routePattern - The route pattern with parameters (e.g., \"/users/:id/posts/:postId\")\n     * @returns Object containing extracted parameters\n     */\n    static extractParams(url: string, routePattern: string): Record<string, string> {\n        // Remove query string (anything after ?)\n        const cleanUrl = url.split('?')[0];\n        const cleanPattern = routePattern.split('?')[0];\n\n        const urlSegments = cleanUrl.split('/').filter(Boolean);\n        const patternSegments = cleanPattern.split('/').filter(Boolean);\n\n        const params: Record<string, string> = {};\n\n        for (let i = 0; i < patternSegments.length; i++) {\n            const patternSegment = patternSegments[i];\n            const urlSegment = urlSegments[i];\n\n            if (patternSegment.startsWith(':')) {\n                const paramName = patternSegment.slice(1); // Remove ':' from pattern\n                if (urlSegment) {\n                    params[paramName] = decodeURIComponent(urlSegment);\n                }\n            } else if (patternSegment !== urlSegment) {\n                // If static segments don't match → fail\n                return {};\n            }\n        }\n\n        return params;\n    }\n\n\n\n    /**\n     * Extract query parameters from URL\n     * @param url - The URL to extract query parameters from\n     * @returns Object containing query parameters\n     */\n    static extractQuery<T = Record<string, string>>(url: string): T {\n        const query: Record<string, string> = {};\n\n        // Take only the part after \"?\"\n        const queryString = url.split('?')[1];\n        if (!queryString) return query as T;\n\n        // Remove fragment (#...) if present\n        const cleanQuery = queryString.split('#')[0];\n\n        // Split into key=value pairs\n        for (const pair of cleanQuery.split('&')) {\n            if (!pair) continue;\n            const [key, value = ''] = pair.split('=');\n            query[decodeURIComponent(key)] = decodeURIComponent(value);\n        }\n\n        return query as T;\n    }\n\n\n    /**\n     * Parse cookies from Cookie header\n     */\n    static parseCookies(\n        cookieHeader?: string\n    ): Record<string, string> {\n        const cookies: Record<string, string> = {};\n\n        if (!cookieHeader) return {};\n\n        cookieHeader.split(';').forEach(cookie => {\n            const [name, ...rest] = cookie.trim().split('=');\n            const value = rest.join('=');\n            if (name && value) {\n                cookies[name] = decodeURIComponent(value);\n            }\n        });\n\n        return cookies;\n    }\n\n    /**\n     * Parse request body based on Content-Type\n     * \n     * \n     * @param context - The HTTP server request context\n     * @returns Parsed body data and detected body type\n     */\n    static parseRequestBody<T extends any = any>(\n        context: A_HttpServerRequestContext\n    ): {\n        data: T;\n        type: A_Request_BodyType;\n    } {\n        let parsedBody: any;\n        let bodyType: A_Request_BodyType;\n\n        switch (true) {\n            case !!context.contentType && context.contentType.includes('application/json'):\n                parsedBody = JSON.parse(context.data);\n                bodyType = 'json';\n                break;\n            case !!context.contentType && context.contentType.includes('application/x-www-form-urlencoded'):\n                parsedBody = A_RequestHelper.parseFormUrlEncoded(context.data) as T;\n                bodyType = 'form';\n                break;\n            case !!context.contentType && context.contentType.includes('multipart/form-data'):\n                const multipartResult = A_RequestHelper.parseMultipartData(Buffer.concat(context.buffers), context.contentType);\n                // Return the entire multipart result (fields + files) as T\n                parsedBody = {\n                    ...multipartResult.fields,\n                    _files: multipartResult.files\n                } as T;\n                bodyType = 'multipart';\n                break;\n            case !!context.contentType && context.contentType.includes('text/'):\n                parsedBody = context.data as T;\n                bodyType = 'text';\n                break;\n            default:\n                parsedBody = Buffer.concat(context.buffers) as T;\n                bodyType = 'raw';\n                break;\n        }\n\n\n        return {\n            data: parsedBody,\n            type: bodyType\n        };\n    }\n\n    /**\n     * Parse URL-encoded form data (application/x-www-form-urlencoded)\n     * @param body - The URL-encoded body string\n     * @returns Object containing form data\n     */\n    static parseFormUrlEncoded(\n        /**\n         * The URL-encoded body string\n         */\n        body: string\n    ): Record<string, string | string[]> {\n        const result: Record<string, string | string[]> = {};\n\n        if (!body) return result;\n\n        const pairs = body.split('&');\n\n        for (const pair of pairs) {\n            if (!pair) continue;\n\n            const [key, value = ''] = pair.split('=');\n            const decodedKey = decodeURIComponent(key.replace(/\\+/g, ' '));\n            const decodedValue = decodeURIComponent(value.replace(/\\+/g, ' '));\n\n            // Handle multiple values for the same key (arrays)\n            if (decodedKey in result) {\n                const existing = result[decodedKey];\n                if (Array.isArray(existing)) {\n                    existing.push(decodedValue);\n                } else {\n                    result[decodedKey] = [existing, decodedValue];\n                }\n            } else {\n                result[decodedKey] = decodedValue;\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Parse multipart form data (for file uploads and form data)\n     * @param buffer - The raw buffer containing multipart data\n     * @param contentType - The content type header\n     * @returns Object containing fields and files\n     */\n    static parseMultipartData(\n        /**\n         * The raw buffer containing multipart data\n         */\n        buffer: Buffer,\n        /**\n         * The content type header\n         */\n        contentType: string\n    ): {\n        fields: Record<string, string>;\n        files: A_Request_FileUpload[];\n    } {\n        // Extract boundary\n        const boundaryMatch = contentType.match(/boundary=(.+)/);\n        if (!boundaryMatch) {\n            throw new A_RequestError(\n                A_RequestError.RequestBodyParsingError,\n                'Missing boundary in multipart/form-data content type'\n            )\n        }\n\n        const boundary = '--' + boundaryMatch[1];\n        const textData = buffer.toString();\n        const parts = textData.split(boundary).filter(part => part.trim() && !part.includes('--'));\n\n        const fields: Record<string, string> = {};\n        const files: A_Request_FileUpload[] = [];\n\n        parts.forEach(part => {\n            const [headers, content] = part.split('\\r\\n\\r\\n');\n            if (!headers || content === undefined) return;\n\n            const nameMatch = headers.match(/name=\"([^\"]+)\"/);\n            const filenameMatch = headers.match(/filename=\"([^\"]+)\"/);\n            const contentTypeMatch = headers.match(/Content-Type: ([^\\r\\n]+)/);\n\n            if (nameMatch) {\n                const fieldName = nameMatch[1];\n                const cleanContent = content.replace(/\\r\\n$/, '');\n\n                if (filenameMatch) {\n                    // It's a file upload\n                    const file: A_Request_FileUpload = {\n                        fieldName,\n                        filename: filenameMatch[1],\n                        encoding: 'binary',\n                        mimetype: contentTypeMatch?.[1] || 'application/octet-stream',\n                        size: Buffer.byteLength(cleanContent),\n                        buffer: Buffer.from(cleanContent, 'binary')\n                    };\n                    files.push(file);\n                } else {\n                    // It's a regular field\n                    fields[fieldName] = cleanContent;\n                }\n            }\n        });\n\n        return { fields, files };\n    }\n\n}"]}
+{"version":3,"sources":["../../../../src/lib/A-Request/A-Request.helper.ts"],"names":["A_RequestError"],"mappings":"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","file":"A-Request.helper.js","sourcesContent":["import { A_HttpServerRequestContext } from \"./A-HttpServerRequest.context\";\nimport { A_RequestError } from \"./A-Request.error\";\nimport { A_Request_BodyType, A_Request_FileUpload } from \"./A-Request.types\";\n\n/**\n * A_RequestHelper - Stateless utility class for HTTP request processing\n * \n * This helper class provides static methods for parsing and processing HTTP request data:\n * - URL parameter extraction from route patterns\n * - Query string parsing\n * - Request body parsing (JSON, form-data, multipart, raw)\n * - URL-encoded form data parsing\n * - Multipart form data parsing (including file uploads)\n * \n * All methods are stateless and only depend on input parameters.\n * \n * @example\n * ```typescript\n * // Extract URL parameters\n * const params = A_RequestHelper.extractParams('/users/123', '/users/:id');\n * // { id: '123' }\n * \n * // Parse query string\n * const query = A_RequestHelper.extractQuery('/api/users?page=1&limit=10');\n * // { page: '1', limit: '10' }\n * \n * // Parse request body\n * const result = await A_RequestHelper.parseRequestBody(req, { maxBodySize: 1024 * 1024 });\n * // { data: {...}, type: 'json' }\n * ```\n */\nexport class A_RequestHelper {\n\n    /**\n     * Extract URL parameters from a URL using a route pattern\n     * @param url - The actual URL to extract parameters from\n     * @param routePattern - The route pattern with parameters (e.g., \"/users/:id/posts/:postId\")\n     * @returns Object containing extracted parameters\n     */\n    static extractParams(url: string, routePattern: string): Record<string, string> {\n        // Remove query string (anything after ?)\n        const cleanUrl = url.split('?')[0];\n        const cleanPattern = routePattern.split('?')[0];\n\n        const urlSegments = cleanUrl.split('/').filter(Boolean);\n        const patternSegments = cleanPattern.split('/').filter(Boolean);\n\n        const params: Record<string, string> = {};\n\n        for (let i = 0; i < patternSegments.length; i++) {\n            const patternSegment = patternSegments[i];\n            const urlSegment = urlSegments[i];\n\n            if (patternSegment.startsWith(':')) {\n                const paramName = patternSegment.slice(1); // Remove ':' from pattern\n                if (urlSegment) {\n                    params[paramName] = decodeURIComponent(urlSegment);\n                }\n            } else if (patternSegment !== urlSegment) {\n                // If static segments don't match → fail\n                return {};\n            }\n        }\n\n        return params;\n    }\n\n\n\n    /**\n     * Extract query parameters from URL\n     * @param url - The URL to extract query parameters from\n     * @returns Object containing query parameters\n     */\n    static extractQuery<T = Record<string, string>>(url: string): T {\n        const query: Record<string, string> = {};\n\n        // Take only the part after \"?\"\n        const queryString = url.split('?')[1];\n        if (!queryString) return query as T;\n\n        // Remove fragment (#...) if present\n        const cleanQuery = queryString.split('#')[0];\n\n        // Split into key=value pairs\n        for (const pair of cleanQuery.split('&')) {\n            if (!pair) continue;\n            const [key, value = ''] = pair.split('=');\n            query[decodeURIComponent(key)] = decodeURIComponent(value);\n        }\n\n        return query as T;\n    }\n\n\n    /**\n     * Parse cookies from Cookie header\n     */\n    static parseCookies(\n        cookieHeader?: string\n    ): Record<string, string> {\n        const cookies: Record<string, string> = {};\n\n        if (!cookieHeader) return {};\n\n        cookieHeader.split(';').forEach(cookie => {\n            const [name, ...rest] = cookie.trim().split('=');\n            const value = rest.join('=');\n            if (name && value) {\n                cookies[name] = decodeURIComponent(value);\n            }\n        });\n\n        return cookies;\n    }\n\n    /**\n     * Parse request body based on Content-Type\n     * \n     * \n     * @param context - The HTTP server request context\n     * @returns Parsed body data and detected body type\n     */\n    static parseRequestBody<T extends any = any>(\n        context: A_HttpServerRequestContext\n    ): {\n        data: T;\n        type: A_Request_BodyType;\n    } {\n        let parsedBody: any;\n        let bodyType: A_Request_BodyType;\n\n        switch (true) {\n            case !!context.contentType && context.contentType.includes('application/json'):\n                parsedBody = JSON.parse(context.data || '{}');\n                bodyType = 'json';\n                break;\n            case !!context.contentType && context.contentType.includes('application/x-www-form-urlencoded'):\n                parsedBody = A_RequestHelper.parseFormUrlEncoded(context.data) as T;\n                bodyType = 'form';\n                break;\n            case !!context.contentType && context.contentType.includes('multipart/form-data'):\n                const multipartResult = A_RequestHelper.parseMultipartData(Buffer.concat(context.buffers), context.contentType);\n                // Return the entire multipart result (fields + files) as T\n                parsedBody = {\n                    ...multipartResult.fields,\n                    _files: multipartResult.files\n                } as T;\n                bodyType = 'multipart';\n                break;\n            case !!context.contentType && context.contentType.includes('text/'):\n                parsedBody = context.data as T;\n                bodyType = 'text';\n                break;\n            default:\n                parsedBody = Buffer.concat(context.buffers) as T;\n                bodyType = 'raw';\n                break;\n        }\n\n\n        return {\n            data: parsedBody,\n            type: bodyType\n        };\n    }\n\n    /**\n     * Parse URL-encoded form data (application/x-www-form-urlencoded)\n     * @param body - The URL-encoded body string\n     * @returns Object containing form data\n     */\n    static parseFormUrlEncoded(\n        /**\n         * The URL-encoded body string\n         */\n        body: string\n    ): Record<string, string | string[]> {\n        const result: Record<string, string | string[]> = {};\n\n        if (!body) return result;\n\n        const pairs = body.split('&');\n\n        for (const pair of pairs) {\n            if (!pair) continue;\n\n            const [key, value = ''] = pair.split('=');\n            const decodedKey = decodeURIComponent(key.replace(/\\+/g, ' '));\n            const decodedValue = decodeURIComponent(value.replace(/\\+/g, ' '));\n\n            // Handle multiple values for the same key (arrays)\n            if (decodedKey in result) {\n                const existing = result[decodedKey];\n                if (Array.isArray(existing)) {\n                    existing.push(decodedValue);\n                } else {\n                    result[decodedKey] = [existing, decodedValue];\n                }\n            } else {\n                result[decodedKey] = decodedValue;\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Parse multipart form data (for file uploads and form data)\n     * @param buffer - The raw buffer containing multipart data\n     * @param contentType - The content type header\n     * @returns Object containing fields and files\n     */\n    static parseMultipartData(\n        /**\n         * The raw buffer containing multipart data\n         */\n        buffer: Buffer,\n        /**\n         * The content type header\n         */\n        contentType: string\n    ): {\n        fields: Record<string, string>;\n        files: A_Request_FileUpload[];\n    } {\n        // Extract boundary\n        const boundaryMatch = contentType.match(/boundary=(.+)/);\n        if (!boundaryMatch) {\n            throw new A_RequestError(\n                A_RequestError.RequestBodyParsingError,\n                'Missing boundary in multipart/form-data content type'\n            )\n        }\n\n        const boundary = '--' + boundaryMatch[1];\n        const textData = buffer.toString();\n        const parts = textData.split(boundary).filter(part => part.trim() && !part.includes('--'));\n\n        const fields: Record<string, string> = {};\n        const files: A_Request_FileUpload[] = [];\n\n        parts.forEach(part => {\n            const [headers, content] = part.split('\\r\\n\\r\\n');\n            if (!headers || content === undefined) return;\n\n            const nameMatch = headers.match(/name=\"([^\"]+)\"/);\n            const filenameMatch = headers.match(/filename=\"([^\"]+)\"/);\n            const contentTypeMatch = headers.match(/Content-Type: ([^\\r\\n]+)/);\n\n            if (nameMatch) {\n                const fieldName = nameMatch[1];\n                const cleanContent = content.replace(/\\r\\n$/, '');\n\n                if (filenameMatch) {\n                    // It's a file upload\n                    const file: A_Request_FileUpload = {\n                        fieldName,\n                        filename: filenameMatch[1],\n                        encoding: 'binary',\n                        mimetype: contentTypeMatch?.[1] || 'application/octet-stream',\n                        size: Buffer.byteLength(cleanContent),\n                        buffer: Buffer.from(cleanContent, 'binary')\n                    };\n                    files.push(file);\n                } else {\n                    // It's a regular field\n                    fields[fieldName] = cleanContent;\n                }\n            }\n        });\n\n        return { fields, files };\n    }\n\n}"]}

package/dist/node/lib/A-Request/A-Request.helper.mjs

@@ -72,7 +72,7 @@ class A_RequestHelper {
     let bodyType;
     switch (true) {
       case (!!context.contentType && context.contentType.includes("application/json")):
-        parsedBody = JSON.parse(context.data);
+        parsedBody = JSON.parse(context.data || "{}");
         bodyType = "json";
         break;
       case (!!context.contentType && context.contentType.includes("application/x-www-form-urlencoded")):

package/dist/node/lib/A-Request/A-Request.helper.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/A-Request/A-Request.helper.ts"],"names":[],"mappings":"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","file":"A-Request.helper.mjs","sourcesContent":["import { A_HttpServerRequestContext } from \"./A-HttpServerRequest.context\";\nimport { A_RequestError } from \"./A-Request.error\";\nimport { A_Request_BodyType, A_Request_FileUpload } from \"./A-Request.types\";\n\n/**\n * A_RequestHelper - Stateless utility class for HTTP request processing\n * \n * This helper class provides static methods for parsing and processing HTTP request data:\n * - URL parameter extraction from route patterns\n * - Query string parsing\n * - Request body parsing (JSON, form-data, multipart, raw)\n * - URL-encoded form data parsing\n * - Multipart form data parsing (including file uploads)\n * \n * All methods are stateless and only depend on input parameters.\n * \n * @example\n * ```typescript\n * // Extract URL parameters\n * const params = A_RequestHelper.extractParams('/users/123', '/users/:id');\n * // { id: '123' }\n * \n * // Parse query string\n * const query = A_RequestHelper.extractQuery('/api/users?page=1&limit=10');\n * // { page: '1', limit: '10' }\n * \n * // Parse request body\n * const result = await A_RequestHelper.parseRequestBody(req, { maxBodySize: 1024 * 1024 });\n * // { data: {...}, type: 'json' }\n * ```\n */\nexport class A_RequestHelper {\n\n    /**\n     * Extract URL parameters from a URL using a route pattern\n     * @param url - The actual URL to extract parameters from\n     * @param routePattern - The route pattern with parameters (e.g., \"/users/:id/posts/:postId\")\n     * @returns Object containing extracted parameters\n     */\n    static extractParams(url: string, routePattern: string): Record<string, string> {\n        // Remove query string (anything after ?)\n        const cleanUrl = url.split('?')[0];\n        const cleanPattern = routePattern.split('?')[0];\n\n        const urlSegments = cleanUrl.split('/').filter(Boolean);\n        const patternSegments = cleanPattern.split('/').filter(Boolean);\n\n        const params: Record<string, string> = {};\n\n        for (let i = 0; i < patternSegments.length; i++) {\n            const patternSegment = patternSegments[i];\n            const urlSegment = urlSegments[i];\n\n            if (patternSegment.startsWith(':')) {\n                const paramName = patternSegment.slice(1); // Remove ':' from pattern\n                if (urlSegment) {\n                    params[paramName] = decodeURIComponent(urlSegment);\n                }\n            } else if (patternSegment !== urlSegment) {\n                // If static segments don't match → fail\n                return {};\n            }\n        }\n\n        return params;\n    }\n\n\n\n    /**\n     * Extract query parameters from URL\n     * @param url - The URL to extract query parameters from\n     * @returns Object containing query parameters\n     */\n    static extractQuery<T = Record<string, string>>(url: string): T {\n        const query: Record<string, string> = {};\n\n        // Take only the part after \"?\"\n        const queryString = url.split('?')[1];\n        if (!queryString) return query as T;\n\n        // Remove fragment (#...) if present\n        const cleanQuery = queryString.split('#')[0];\n\n        // Split into key=value pairs\n        for (const pair of cleanQuery.split('&')) {\n            if (!pair) continue;\n            const [key, value = ''] = pair.split('=');\n            query[decodeURIComponent(key)] = decodeURIComponent(value);\n        }\n\n        return query as T;\n    }\n\n\n    /**\n     * Parse cookies from Cookie header\n     */\n    static parseCookies(\n        cookieHeader?: string\n    ): Record<string, string> {\n        const cookies: Record<string, string> = {};\n\n        if (!cookieHeader) return {};\n\n        cookieHeader.split(';').forEach(cookie => {\n            const [name, ...rest] = cookie.trim().split('=');\n            const value = rest.join('=');\n            if (name && value) {\n                cookies[name] = decodeURIComponent(value);\n            }\n        });\n\n        return cookies;\n    }\n\n    /**\n     * Parse request body based on Content-Type\n     * \n     * \n     * @param context - The HTTP server request context\n     * @returns Parsed body data and detected body type\n     */\n    static parseRequestBody<T extends any = any>(\n        context: A_HttpServerRequestContext\n    ): {\n        data: T;\n        type: A_Request_BodyType;\n    } {\n        let parsedBody: any;\n        let bodyType: A_Request_BodyType;\n\n        switch (true) {\n            case !!context.contentType && context.contentType.includes('application/json'):\n                parsedBody = JSON.parse(context.data);\n                bodyType = 'json';\n                break;\n            case !!context.contentType && context.contentType.includes('application/x-www-form-urlencoded'):\n                parsedBody = A_RequestHelper.parseFormUrlEncoded(context.data) as T;\n                bodyType = 'form';\n                break;\n            case !!context.contentType && context.contentType.includes('multipart/form-data'):\n                const multipartResult = A_RequestHelper.parseMultipartData(Buffer.concat(context.buffers), context.contentType);\n                // Return the entire multipart result (fields + files) as T\n                parsedBody = {\n                    ...multipartResult.fields,\n                    _files: multipartResult.files\n                } as T;\n                bodyType = 'multipart';\n                break;\n            case !!context.contentType && context.contentType.includes('text/'):\n                parsedBody = context.data as T;\n                bodyType = 'text';\n                break;\n            default:\n                parsedBody = Buffer.concat(context.buffers) as T;\n                bodyType = 'raw';\n                break;\n        }\n\n\n        return {\n            data: parsedBody,\n            type: bodyType\n        };\n    }\n\n    /**\n     * Parse URL-encoded form data (application/x-www-form-urlencoded)\n     * @param body - The URL-encoded body string\n     * @returns Object containing form data\n     */\n    static parseFormUrlEncoded(\n        /**\n         * The URL-encoded body string\n         */\n        body: string\n    ): Record<string, string | string[]> {\n        const result: Record<string, string | string[]> = {};\n\n        if (!body) return result;\n\n        const pairs = body.split('&');\n\n        for (const pair of pairs) {\n            if (!pair) continue;\n\n            const [key, value = ''] = pair.split('=');\n            const decodedKey = decodeURIComponent(key.replace(/\\+/g, ' '));\n            const decodedValue = decodeURIComponent(value.replace(/\\+/g, ' '));\n\n            // Handle multiple values for the same key (arrays)\n            if (decodedKey in result) {\n                const existing = result[decodedKey];\n                if (Array.isArray(existing)) {\n                    existing.push(decodedValue);\n                } else {\n                    result[decodedKey] = [existing, decodedValue];\n                }\n            } else {\n                result[decodedKey] = decodedValue;\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Parse multipart form data (for file uploads and form data)\n     * @param buffer - The raw buffer containing multipart data\n     * @param contentType - The content type header\n     * @returns Object containing fields and files\n     */\n    static parseMultipartData(\n        /**\n         * The raw buffer containing multipart data\n         */\n        buffer: Buffer,\n        /**\n         * The content type header\n         */\n        contentType: string\n    ): {\n        fields: Record<string, string>;\n        files: A_Request_FileUpload[];\n    } {\n        // Extract boundary\n        const boundaryMatch = contentType.match(/boundary=(.+)/);\n        if (!boundaryMatch) {\n            throw new A_RequestError(\n                A_RequestError.RequestBodyParsingError,\n                'Missing boundary in multipart/form-data content type'\n            )\n        }\n\n        const boundary = '--' + boundaryMatch[1];\n        const textData = buffer.toString();\n        const parts = textData.split(boundary).filter(part => part.trim() && !part.includes('--'));\n\n        const fields: Record<string, string> = {};\n        const files: A_Request_FileUpload[] = [];\n\n        parts.forEach(part => {\n            const [headers, content] = part.split('\\r\\n\\r\\n');\n            if (!headers || content === undefined) return;\n\n            const nameMatch = headers.match(/name=\"([^\"]+)\"/);\n            const filenameMatch = headers.match(/filename=\"([^\"]+)\"/);\n            const contentTypeMatch = headers.match(/Content-Type: ([^\\r\\n]+)/);\n\n            if (nameMatch) {\n                const fieldName = nameMatch[1];\n                const cleanContent = content.replace(/\\r\\n$/, '');\n\n                if (filenameMatch) {\n                    // It's a file upload\n                    const file: A_Request_FileUpload = {\n                        fieldName,\n                        filename: filenameMatch[1],\n                        encoding: 'binary',\n                        mimetype: contentTypeMatch?.[1] || 'application/octet-stream',\n                        size: Buffer.byteLength(cleanContent),\n                        buffer: Buffer.from(cleanContent, 'binary')\n                    };\n                    files.push(file);\n                } else {\n                    // It's a regular field\n                    fields[fieldName] = cleanContent;\n                }\n            }\n        });\n\n        return { fields, files };\n    }\n\n}"]}
+{"version":3,"sources":["../../../../src/lib/A-Request/A-Request.helper.ts"],"names":[],"mappings":"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","file":"A-Request.helper.mjs","sourcesContent":["import { A_HttpServerRequestContext } from \"./A-HttpServerRequest.context\";\nimport { A_RequestError } from \"./A-Request.error\";\nimport { A_Request_BodyType, A_Request_FileUpload } from \"./A-Request.types\";\n\n/**\n * A_RequestHelper - Stateless utility class for HTTP request processing\n * \n * This helper class provides static methods for parsing and processing HTTP request data:\n * - URL parameter extraction from route patterns\n * - Query string parsing\n * - Request body parsing (JSON, form-data, multipart, raw)\n * - URL-encoded form data parsing\n * - Multipart form data parsing (including file uploads)\n * \n * All methods are stateless and only depend on input parameters.\n * \n * @example\n * ```typescript\n * // Extract URL parameters\n * const params = A_RequestHelper.extractParams('/users/123', '/users/:id');\n * // { id: '123' }\n * \n * // Parse query string\n * const query = A_RequestHelper.extractQuery('/api/users?page=1&limit=10');\n * // { page: '1', limit: '10' }\n * \n * // Parse request body\n * const result = await A_RequestHelper.parseRequestBody(req, { maxBodySize: 1024 * 1024 });\n * // { data: {...}, type: 'json' }\n * ```\n */\nexport class A_RequestHelper {\n\n    /**\n     * Extract URL parameters from a URL using a route pattern\n     * @param url - The actual URL to extract parameters from\n     * @param routePattern - The route pattern with parameters (e.g., \"/users/:id/posts/:postId\")\n     * @returns Object containing extracted parameters\n     */\n    static extractParams(url: string, routePattern: string): Record<string, string> {\n        // Remove query string (anything after ?)\n        const cleanUrl = url.split('?')[0];\n        const cleanPattern = routePattern.split('?')[0];\n\n        const urlSegments = cleanUrl.split('/').filter(Boolean);\n        const patternSegments = cleanPattern.split('/').filter(Boolean);\n\n        const params: Record<string, string> = {};\n\n        for (let i = 0; i < patternSegments.length; i++) {\n            const patternSegment = patternSegments[i];\n            const urlSegment = urlSegments[i];\n\n            if (patternSegment.startsWith(':')) {\n                const paramName = patternSegment.slice(1); // Remove ':' from pattern\n                if (urlSegment) {\n                    params[paramName] = decodeURIComponent(urlSegment);\n                }\n            } else if (patternSegment !== urlSegment) {\n                // If static segments don't match → fail\n                return {};\n            }\n        }\n\n        return params;\n    }\n\n\n\n    /**\n     * Extract query parameters from URL\n     * @param url - The URL to extract query parameters from\n     * @returns Object containing query parameters\n     */\n    static extractQuery<T = Record<string, string>>(url: string): T {\n        const query: Record<string, string> = {};\n\n        // Take only the part after \"?\"\n        const queryString = url.split('?')[1];\n        if (!queryString) return query as T;\n\n        // Remove fragment (#...) if present\n        const cleanQuery = queryString.split('#')[0];\n\n        // Split into key=value pairs\n        for (const pair of cleanQuery.split('&')) {\n            if (!pair) continue;\n            const [key, value = ''] = pair.split('=');\n            query[decodeURIComponent(key)] = decodeURIComponent(value);\n        }\n\n        return query as T;\n    }\n\n\n    /**\n     * Parse cookies from Cookie header\n     */\n    static parseCookies(\n        cookieHeader?: string\n    ): Record<string, string> {\n        const cookies: Record<string, string> = {};\n\n        if (!cookieHeader) return {};\n\n        cookieHeader.split(';').forEach(cookie => {\n            const [name, ...rest] = cookie.trim().split('=');\n            const value = rest.join('=');\n            if (name && value) {\n                cookies[name] = decodeURIComponent(value);\n            }\n        });\n\n        return cookies;\n    }\n\n    /**\n     * Parse request body based on Content-Type\n     * \n     * \n     * @param context - The HTTP server request context\n     * @returns Parsed body data and detected body type\n     */\n    static parseRequestBody<T extends any = any>(\n        context: A_HttpServerRequestContext\n    ): {\n        data: T;\n        type: A_Request_BodyType;\n    } {\n        let parsedBody: any;\n        let bodyType: A_Request_BodyType;\n\n        switch (true) {\n            case !!context.contentType && context.contentType.includes('application/json'):\n                parsedBody = JSON.parse(context.data || '{}');\n                bodyType = 'json';\n                break;\n            case !!context.contentType && context.contentType.includes('application/x-www-form-urlencoded'):\n                parsedBody = A_RequestHelper.parseFormUrlEncoded(context.data) as T;\n                bodyType = 'form';\n                break;\n            case !!context.contentType && context.contentType.includes('multipart/form-data'):\n                const multipartResult = A_RequestHelper.parseMultipartData(Buffer.concat(context.buffers), context.contentType);\n                // Return the entire multipart result (fields + files) as T\n                parsedBody = {\n                    ...multipartResult.fields,\n                    _files: multipartResult.files\n                } as T;\n                bodyType = 'multipart';\n                break;\n            case !!context.contentType && context.contentType.includes('text/'):\n                parsedBody = context.data as T;\n                bodyType = 'text';\n                break;\n            default:\n                parsedBody = Buffer.concat(context.buffers) as T;\n                bodyType = 'raw';\n                break;\n        }\n\n\n        return {\n            data: parsedBody,\n            type: bodyType\n        };\n    }\n\n    /**\n     * Parse URL-encoded form data (application/x-www-form-urlencoded)\n     * @param body - The URL-encoded body string\n     * @returns Object containing form data\n     */\n    static parseFormUrlEncoded(\n        /**\n         * The URL-encoded body string\n         */\n        body: string\n    ): Record<string, string | string[]> {\n        const result: Record<string, string | string[]> = {};\n\n        if (!body) return result;\n\n        const pairs = body.split('&');\n\n        for (const pair of pairs) {\n            if (!pair) continue;\n\n            const [key, value = ''] = pair.split('=');\n            const decodedKey = decodeURIComponent(key.replace(/\\+/g, ' '));\n            const decodedValue = decodeURIComponent(value.replace(/\\+/g, ' '));\n\n            // Handle multiple values for the same key (arrays)\n            if (decodedKey in result) {\n                const existing = result[decodedKey];\n                if (Array.isArray(existing)) {\n                    existing.push(decodedValue);\n                } else {\n                    result[decodedKey] = [existing, decodedValue];\n                }\n            } else {\n                result[decodedKey] = decodedValue;\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Parse multipart form data (for file uploads and form data)\n     * @param buffer - The raw buffer containing multipart data\n     * @param contentType - The content type header\n     * @returns Object containing fields and files\n     */\n    static parseMultipartData(\n        /**\n         * The raw buffer containing multipart data\n         */\n        buffer: Buffer,\n        /**\n         * The content type header\n         */\n        contentType: string\n    ): {\n        fields: Record<string, string>;\n        files: A_Request_FileUpload[];\n    } {\n        // Extract boundary\n        const boundaryMatch = contentType.match(/boundary=(.+)/);\n        if (!boundaryMatch) {\n            throw new A_RequestError(\n                A_RequestError.RequestBodyParsingError,\n                'Missing boundary in multipart/form-data content type'\n            )\n        }\n\n        const boundary = '--' + boundaryMatch[1];\n        const textData = buffer.toString();\n        const parts = textData.split(boundary).filter(part => part.trim() && !part.includes('--'));\n\n        const fields: Record<string, string> = {};\n        const files: A_Request_FileUpload[] = [];\n\n        parts.forEach(part => {\n            const [headers, content] = part.split('\\r\\n\\r\\n');\n            if (!headers || content === undefined) return;\n\n            const nameMatch = headers.match(/name=\"([^\"]+)\"/);\n            const filenameMatch = headers.match(/filename=\"([^\"]+)\"/);\n            const contentTypeMatch = headers.match(/Content-Type: ([^\\r\\n]+)/);\n\n            if (nameMatch) {\n                const fieldName = nameMatch[1];\n                const cleanContent = content.replace(/\\r\\n$/, '');\n\n                if (filenameMatch) {\n                    // It's a file upload\n                    const file: A_Request_FileUpload = {\n                        fieldName,\n                        filename: filenameMatch[1],\n                        encoding: 'binary',\n                        mimetype: contentTypeMatch?.[1] || 'application/octet-stream',\n                        size: Buffer.byteLength(cleanContent),\n                        buffer: Buffer.from(cleanContent, 'binary')\n                    };\n                    files.push(file);\n                } else {\n                    // It's a regular field\n                    fields[fieldName] = cleanContent;\n                }\n            }\n        });\n\n        return { fields, files };\n    }\n\n}"]}

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

@@ -6,12 +6,6 @@ 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';
 import '@adaas/a-concept';
-import './A-Server.context.mjs';
-import './A-Server.types.mjs';
-import '../A-ServerRoute/A-ServerRoute.entity.mjs';
-import '@adaas/a-utils/a-route';
-import '../A-ServerRoute/A-ServerRoute.types.mjs';
-import '../A-ServerRoute/A-ServerRoute.constants.mjs';
 import '../../A-Request.entity-r905O60G.mjs';
 import './A-HttpServer.error.mjs';
 import './A-HttpServer.types.mjs';
@@ -21,6 +15,10 @@ import '../A-Request/A-HttpServerRequest.context.mjs';
 import '@adaas/a-utils/a-operation';
 import '../A-Request/A-HttpRequestData.context.mjs';
 import '@adaas/a-utils/a-execution';
+import '../A-ServerRoute/A-ServerRoute.entity.mjs';
+import '@adaas/a-utils/a-route';
+import '../A-ServerRoute/A-ServerRoute.types.mjs';
+import '../A-ServerRoute/A-ServerRoute.constants.mjs';
 import '../../A-Response.entity-6qhiV7BE.mjs';
 import 'stream';
 import '../A-Response/A-Response.constants.mjs';

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

@@ -6,12 +6,6 @@ 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';
 import '@adaas/a-concept';
-import './A-Server.context.js';
-import './A-Server.types.js';
-import '../A-ServerRoute/A-ServerRoute.entity.js';
-import '@adaas/a-utils/a-route';
-import '../A-ServerRoute/A-ServerRoute.types.js';
-import '../A-ServerRoute/A-ServerRoute.constants.js';
 import '../../A-Request.entity-8_9MCXT2.js';
 import './A-HttpServer.error.js';
 import './A-HttpServer.types.js';
@@ -21,6 +15,10 @@ import '../A-Request/A-HttpServerRequest.context.js';
 import '@adaas/a-utils/a-operation';
 import '../A-Request/A-HttpRequestData.context.js';
 import '@adaas/a-utils/a-execution';
+import '../A-ServerRoute/A-ServerRoute.entity.js';
+import '@adaas/a-utils/a-route';
+import '../A-ServerRoute/A-ServerRoute.types.js';
+import '../A-ServerRoute/A-ServerRoute.constants.js';
 import '../../A-Response.entity-bjh6bofZ.js';
 import 'stream';
 import '../A-Response/A-Response.constants.js';

package/dist/node/lib/A-ServerController/A-ServerController.component.js

@@ -4,6 +4,7 @@ var aConcept = require('@adaas/a-concept');
 var AServerRouter_component = require('@adaas/a-server/router/A-ServerRouter.component');
 var AResponse_entity = require('@adaas/a-server/response/A-Response.entity');
 var ARequest_entity = require('@adaas/a-server/request/A-Request.entity');
+var AHttpServer_error = require('../A-Server/A-HttpServer.error');
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -19,17 +20,29 @@ var __decorateParam = (index, decorator) => (target, key) => decorator(target, k
 class A_ServerController extends aConcept.A_Component {
   async callEntityMethod(request, response, scope) {
     if (!scope.has(request.params.component))
-      return;
+      throw new AHttpServer_error.A_HttpServerError({
+        status: 404,
+        description: `Component "${request.params.component}" not found`
+      });
     if (!request.params.operation || typeof request.params.operation !== "string")
-      return;
+      throw new AHttpServer_error.A_HttpServerError({
+        status: 400,
+        description: 'Missing or invalid "operation" parameter'
+      });
     const possibleComponent = scope.resolve(request.params.component);
     if (!possibleComponent || ![aConcept.A_Component, aConcept.A_Container].some((c) => possibleComponent instanceof c))
-      return;
+      throw new AHttpServer_error.A_HttpServerError({
+        status: 404,
+        description: `"${request.params.component}" is not a valid component`
+      });
     const component = possibleComponent;
     const meta = aConcept.A_Context.meta(component);
     const targetFeature = meta.features().find((f) => f.name === `${component.constructor.name}.${request.params.operation}`);
     if (!targetFeature)
-      return;
+      throw new AHttpServer_error.A_HttpServerError({
+        status: 404,
+        description: `Operation "${request.params.operation}" not found on component "${request.params.component}"`
+      });
     await component.call(request.params.operation, scope);
   }
 }