@adaas/a-server 0.0.15 → 0.0.17

package/index.ts

@@ -1,22 +1,51 @@
 
 
-// ================================================================
-//  Containers Export
+// ============================================================================
+// ADAAS A-Server SDK - Complete Export Manifest
+// ============================================================================
+
+// ============================================================================
+// Channels Export
+// ============================================================================
+export { A_HTTPChannel } from './src/channels/A-Http/A-Http.channel';
+export { A_HTTPChannelError } from './src/channels/A-Http/A-Http.channel.error';
+
+
+// ============================================================================
+// Constants Export
+// ============================================================================
+export * from './src/constants/env.constants';
+
+
+// ============================================================================
+// Containers Export
+// ============================================================================
 export { A_Service } from './src/containers/A-Service/A-Service.container';
 
-//  Contexts Export
+
+// ============================================================================
+// Contexts Export
+// ============================================================================
 export { A_Server } from './src/context/A-Server/A_Server.context';
-export { A_ProxyConfig } from './src/context/A_ProxyConfig/A_ProxyConfig.context';
+export { A_ProxyConfig } from './src/context/A-ProxyConfig/A_ProxyConfig.context';
 export { A_StaticConfig } from './src/context/A-StaticConfig/A-StaticConfig.context';
-export { A_ListQueryFilter } from './src/context/A_ListQueryFilter/A_ListQueryFilter.context';
+export { A_ListQueryFilter } from './src/context/A-ListQueryFilter/A_ListQueryFilter.context';
+export { A_EntityFactory } from './src/context/A-EntityFactory/A-EntityFactory.context';
+export { A_HTTPChannel_RequestContext } from './src/context/A-HttpChannel/A-HttpChannel.context';
 
-//  Entities Export
+
+// ============================================================================
+// Entities Export
+// ============================================================================
 export { A_Request } from './src/entities/A-Request/A-Request.entity';
 export { A_Response } from './src/entities/A-Response/A-Response.entity';
 export { A_Route } from './src/entities/A-Route/A-Route.entity';
 export { A_EntityList } from './src/entities/A_EntityList/A_EntityList.entity';
 
-//  Components Export
+
+// ============================================================================
+// Components Export
+// ============================================================================
 export { A_ServerLogger } from './src/components/A-ServerLogger/A_ServerLogger.component';
 export { A_EntityController } from './src/components/A-EntityController/A-EntityController.component';
 export { A_Router } from './src/components/A-Router/A-Router.component';
@@ -26,20 +55,21 @@ export { A_ServerCORS } from './src/components/A-ServerCORS/A_ServerCORS.compone
 export { A_StaticLoader } from './src/components/A-StaticLoader/A-StaticLoader.component';
 export { A_Controller } from './src/components/A-Controller/A-Controller.component';
 export { A_ListingController } from './src/components/A-ListingController/A-ListingController.component';
+export { A_CommandController } from './src/components/A-CommandController/A-CommandController.component';
+export { A_EntityRepository } from './src/components/A-EntityRepository/A-EntityRepository.component';
+export { A_ServerError } from './src/components/A-ServerError/A-ServerError.class';
 
-//  Types Export
-export * from './src/containers/A-Service/A-Service.container.types';
+
+// ============================================================================
+// Types Export
+// ============================================================================
 export * from './src/containers/A-Service/A-Service.container.types';
-export * from './src/context/A_ProxyConfig/A_ProxyConfig.types';
+export * from './src/context/A-ProxyConfig/A_ProxyConfig.types';
+export * from './src/context/A-EntityFactory/A-EntityFactory.context.types';
 export * from './src/entities/A-Request/A-Request.entity.types';
 export * from './src/entities/A-Response/A-Response.entity.types';
 export * from './src/components/A-ServerCORS/A_ServerCORS.component.types';
-export * from "./src/components/A-Router/A-Router.component.types";
-
-
-// export * from './src/entities/A-Route/A-Route.entity.types';
-// export * from './src/components/A-ServerLogger/A_ServerLogger.component.types';
-// export * from './src/components/A-EntityController/A-EntityController.component.types';
-// export * from './src/components/A-Router/A-Router.component.types';
-// export * from './src/components/A-ServerHealthMonitor/A-ServerHealthMonitor.component.types';
-// export * from './src/components/A-ServerProxy/A-ServerProxy.component.types';
+export * from './src/components/A-Router/A-Router.component.types';
+export * from './src/components/A-ServerError/A-ServerError.types';
+export * from './src/channels/A-Http/A-Http.channel.types';
+export * from './src/channels/A-Http/A-Http.channel.constants';

package/jest.config.ts

@@ -18,6 +18,7 @@ const config: Config.InitialOptions = {
         "@adaas/a-server/components/(.*)": ["<rootDir>/src/components/$1"],
         "@adaas/a-server/containers/(.*)": ["<rootDir>/src/containers/$1"],
         "@adaas/a-server/entities/(.*)": ["<rootDir>/src/entities/$1"],
+        "@adaas/a-server/channels/(.*)": ["<rootDir>/src/channels/$1"],
     }
 
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-server",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "SDK to create a server with ease. Build your backend server with modular structure and use it within or outside the ADAAS ecosystem.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -47,14 +47,14 @@
   },
   "homepage": "https://github.com/ADAAS-org/adaas-a-server#readme",
   "dependencies": {
-    "@adaas/a-concept": "^0.0.62",
-    "@adaas/a-utils": "^0.0.8",
-    "@types/node": "^20.10.0"
+    "@adaas/a-concept": "^0.1.24",
+    "@adaas/a-utils": "^0.1.10"
   },
   "devDependencies": {
     "@types/chai": "^4.3.14",
     "@types/jest": "^29.5.12",
     "@types/mocha": "^10.0.6",
+    "@types/node": "^24.9.1",
     "axios": "^1.7.2",
     "chai": "^5.1.0",
     "dotenv": "^16.4.5",

package/src/channels/A-Http/A-Http.channel.constants.ts

@@ -0,0 +1,8 @@
+
+
+
+export enum A_SERVER_CONSTANTS__A_HttpChannel_Lifecycle {
+    onAfterRequest = 'onAfterHttpChannelRequest',
+    onError = 'onHttpChannelError',
+    onBeforeRequest = 'onBeforeHttpChannelRequest',
+}

package/src/channels/A-Http/A-Http.channel.error.ts

@@ -0,0 +1,8 @@
+import { A_Error } from "@adaas/a-concept";
+
+
+export class A_HTTPChannelError extends A_Error {
+
+    static readonly HttpRequestError = 'HTTP Channel Request Error';
+
+}

package/src/channels/A-Http/A-Http.channel.ts

@@ -0,0 +1,188 @@
+import { A_Context, A_Scope } from "@adaas/a-concept";
+import { A_SERVER_TYPES__ServerMethod } from "../../containers/A-Service/A-Service.container.types";
+import { A_HTTPChannel_RequestContext } from "../../context/A-HttpChannel/A-HttpChannel.context";
+import { A_SERVER_CONSTANTS__A_HttpChannel_Lifecycle } from "./A-Http.channel.constants";
+import { A_ServerError } from "@adaas/a-server/components/A-ServerError/A-ServerError.class";
+import { A_Channel } from "@adaas/a-utils";
+import { A_HTTPChannelError } from "./A-Http.channel.error";
+import { A_SERVER_TYPES__HttpChannelRequestConfig, A_SERVER_TYPES__HttpChannelRequestParams, A_SERVER_TYPES__HttpChannelSendParams } from "./A-Http.channel.types";
+
+
+
+export class A_HTTPChannel extends A_Channel {
+
+    protected baseUrl?: string;
+
+    /**
+     * Allows to send an HTTP request without expecting a response
+     * 
+     * @param params 
+     */
+    async send(params: A_SERVER_TYPES__HttpChannelSendParams): Promise<void> {
+        this.request(params);
+    }
+
+    /**
+     * Makes an HTTP request
+     * 
+     * @param params 
+     * @returns 
+     */
+    async request<T = any, M extends Record<string, any> = any>(
+        /**
+         * Provide request parameters
+         */
+        params: A_SERVER_TYPES__HttpChannelRequestParams<M>
+    ): Promise<A_HTTPChannel_RequestContext<T>> {
+        const { method, url, data, config } = params;
+
+        await this.initialize;
+
+        this._processing = true;
+
+        const fullUrl = this.buildURL(url, config?.params);
+
+        const requestScope = new A_Scope({ name: `a-http-channel-request-scope-${method}-${url}-${Date.now()}` });
+        const context = new A_HTTPChannel_RequestContext({
+            method,
+            url,
+            data,
+            config
+        });
+
+        requestScope.inherit(A_Context.scope(this));
+        requestScope.register(context);
+
+        try {
+            await this.call(A_SERVER_CONSTANTS__A_HttpChannel_Lifecycle.onBeforeRequest, requestScope);
+
+            const headers: Record<string, string> = {
+                "Content-Type": "application/json",
+                ...config?.headers,
+            };
+
+            const options: RequestInit = {
+                method,
+                headers,
+            };
+
+            if (data && method !== A_SERVER_TYPES__ServerMethod.GET) {
+                options.body = JSON.stringify(data);
+            }
+
+            const response = await fetch(fullUrl, options);
+
+            if (!response.ok) {
+                throw new A_ServerError({
+                    status: response.status,
+                    title: response.statusText,
+                    description: `HTTP request to ${fullUrl} failed with status ${response.status}`,
+                });
+            }
+
+            context.result =
+                config?.params?.responseType === "text"
+                    ? await response.text()
+                    : config?.params?.responseType === "blob"
+                        ? await response.blob()
+                        : await response.json();
+
+            await this.call(A_SERVER_CONSTANTS__A_HttpChannel_Lifecycle.onAfterRequest, requestScope);
+
+            this._processing = false;
+
+            return context as A_HTTPChannel_RequestContext<T>;
+
+        } catch (error) {
+
+            this._processing = false;
+
+            context.error = error;
+
+            await this.call(A_SERVER_CONSTANTS__A_HttpChannel_Lifecycle.onError, requestScope);
+
+            if (config?.throwOnError === false)
+                return context as A_HTTPChannel_RequestContext<T>;
+            else
+                throw error;
+        }
+    }
+
+    async post<T, M extends Record<string, any> = any>(
+        url: string,
+        body?: any,
+        config?: Partial<A_SERVER_TYPES__HttpChannelRequestConfig>,
+    ): Promise<A_HTTPChannel_RequestContext<T>> {
+        return this.request<T, M>(
+            {
+                method: A_SERVER_TYPES__ServerMethod.POST,
+                url,
+                data: body,
+                config,
+            }
+        );
+    }
+
+    async get<T, M extends Record<string, any> = any>(
+        url: string,
+        params?: any,
+        config?: Partial<A_SERVER_TYPES__HttpChannelRequestConfig>,
+    ): Promise<A_HTTPChannel_RequestContext<T>> {
+        return this.request<T, M>(
+            {
+                method: A_SERVER_TYPES__ServerMethod.GET,
+                url,
+                config: {
+                    ...config,
+                    params,
+                }
+            }
+        );
+    }
+
+    async put<T, M extends Record<string, any> = any>(
+        url: string,
+        body?: any,
+        config?: Partial<A_SERVER_TYPES__HttpChannelRequestConfig>,
+    ): Promise<A_HTTPChannel_RequestContext<T>> {
+        return this.request<T, M>({
+            method: A_SERVER_TYPES__ServerMethod.PUT,
+            url,
+            data: body,
+            config,
+        });
+    }
+
+    async delete<T, M extends Record<string, any> = any>(
+        url: string,
+        params?: any,
+        config?: Partial<A_SERVER_TYPES__HttpChannelRequestConfig>,
+    ): Promise<A_HTTPChannel_RequestContext<T>> {
+        return this.request<T, M>({
+            method: A_SERVER_TYPES__ServerMethod.DELETE,
+            url,
+            data: params,
+            config,
+        });
+    }
+
+
+    protected buildURL(path: string = '', params: Record<string, any> = {}): string {
+
+        if (!this.baseUrl)
+            throw new A_HTTPChannelError(
+                A_HTTPChannelError.HttpRequestError,
+                "Base URL is not set for HTTP Channel"
+            );
+
+        const url = new URL(`${this.baseUrl}${path.startsWith('/') ? path : `/${path}`}`);
+
+        Object.keys(params).forEach(key => {
+            if (params[key] !== undefined && params[key] !== null) {
+                url.searchParams.append(key, params[key]);
+            }
+        });
+
+        return url.toString()
+    }
+}

package/src/channels/A-Http/A-Http.channel.types.ts

@@ -0,0 +1,66 @@
+import { A_SERVER_TYPES__ServerMethod } from "@adaas/a-server/containers/A-Service/A-Service.container.types";
+
+export type A_SERVER_TYPES__HttpChannelSendParams<M extends Record<string, any> = any> = {
+    /**
+     * HTTP Method
+     */
+    method: A_SERVER_TYPES__ServerMethod,
+    /**
+     * Request URL
+     */
+    url: string,
+    /**
+     * Request Body or Query Parameters
+     */
+    data?: any,
+    /**
+     * Request Configuration
+     */
+    config?: Partial<A_SERVER_TYPES__HttpChannelRequestConfig<M>>,
+}
+
+
+export type A_SERVER_TYPES__HttpChannelRequestParams<M extends Record<string, any> = any> = {
+    /**
+     * HTTP Method
+     */
+    method: A_SERVER_TYPES__ServerMethod,
+    /**
+     * Request URL
+     */
+    url: string,
+    /**
+     * Request Body or Query Parameters
+     */
+    data?: any,
+    /**
+     * Request Configuration
+     */
+    config?: Partial<A_SERVER_TYPES__HttpChannelRequestConfig<M>>,
+}
+
+
+export type A_SERVER_TYPES__HttpChannelRequestConfig<M extends Record<string, any> = any> = {
+    /**
+     * Response Type
+     */
+    responseType: "json" | "text" | "blob";
+    /**
+     * Request Headers
+     */
+    headers: Record<string, string>;
+    /**
+     * Query Parameters
+     */
+    params: Record<string, any>;
+    /**
+     * Metadata
+     */
+    meta: M;
+    /**
+     * Throw on Error
+     */
+    throwOnError: boolean;
+};
+
+

package/src/components/A-CommandController/A-CommandController.component.ts

@@ -1,7 +1,8 @@
-import { A_Command, A_Component, A_Inject, A_Scope } from "@adaas/a-concept";
+import { A_Component, A_Container, A_Inject, A_Scope } from "@adaas/a-concept";
 import { A_Router } from "../A-Router/A-Router.component";
 import { A_Request } from "@adaas/a-server/entities/A-Request/A-Request.entity";
 import { A_Response } from "@adaas/a-server/entities/A-Response/A-Response.entity";
+import { A_Command } from "@adaas/a-utils";
 
 
 export class A_CommandController extends A_Component {
@@ -15,10 +16,10 @@ export class A_CommandController extends A_Component {
         @A_Inject(A_Request) req: A_Request<any, any, { command: string }>,
         @A_Inject(A_Response) res: A_Response,
         @A_Inject(A_Scope) scope: A_Scope,
+        @A_Inject(A_Container) container: A_Container,
     ): Promise<void> {
 
         const commandName = req.params.command;
-        
 
         const CommandConstructor = scope.resolveConstructor<A_Command>(commandName);
 
@@ -30,6 +31,10 @@ export class A_CommandController extends A_Component {
 
         const command = new CommandConstructor(req.body);
 
+        container.scope.register(command);
+
+        console.log(`1) Executing command: ${commandName}`);
+
         await command.execute();
 
         const serialized = command.toJSON();

package/src/components/A-Controller/A-Controller.component.ts

@@ -8,10 +8,6 @@ import { A_Request } from "@adaas/a-server/entities/A-Request/A-Request.entity";
 export class A_Controller extends A_Component {
 
 
-    @A_Feature.Define({
-        name: 'callEntityMethod',
-        invoke: false,
-    })
     @A_Router.Post({
         path: '/:component/:operation',
         version: 'v1',

package/src/components/A-EntityController/A-EntityController.component.ts

@@ -1,9 +1,10 @@
-import { A_Component, A_Context, A_Feature, A_Inject, A_Scope } from "@adaas/a-concept";
+import { A_Component, A_Context, A_Feature, A_Inject, A_Scope, A_TYPES__Entity_Constructor, ASEID } from "@adaas/a-concept";
 import { A_Request } from "@adaas/a-server/entities/A-Request/A-Request.entity";
 import { A_Router } from "../A-Router/A-Router.component";
 import { A_EntityFactory } from "@adaas/a-server/context/A-EntityFactory/A-EntityFactory.context";
 import { A_Response } from "@adaas/a-server/entities/A-Response/A-Response.entity";
-import { ASEID } from "@adaas/a-utils";
+import { A_ServerError } from "../A-ServerError/A-ServerError.class";
+import { A_Manifest } from "@adaas/a-utils";
 
 
 
@@ -24,15 +25,27 @@ export class A_EntityController extends A_Component {
     async load(
         @A_Inject(A_Request) request: A_Request<any, any, { aseid: string }>,
         @A_Inject(A_Response) response: A_Response,
-        @A_Inject(A_EntityFactory) factory: A_EntityFactory,
         @A_Inject(A_Scope) scope: A_Scope
     ) {
+        // Check if the scope has a manifest and if the entity is allowed to save
+        // if (
+        //     scope.has(A_Manifest) && !scope.resolve(A_Manifest)
+        //         .isAllowed(entity.constructor, 'save')
+        //         .for(entity.constructor as A_TYPES__Entity_Constructor)
+        // )
+        //     return;
+
+
         if (!ASEID.isASEID(request.params.aseid)) {
             response.add('A_EntityController.load', 'Invalid ASEID');
             return;
         }
 
-        const constructor = factory.resolve(request.params.aseid);
+
+        const aseid = new ASEID(request.params.aseid);
+
+        const constructor = scope.resolveConstructor(aseid.entity);
+
 
         if (constructor) {
             const entity = new constructor(request.params.aseid);
@@ -44,7 +57,11 @@ export class A_EntityController extends A_Component {
             return response.status(200).json(entity.toJSON());
         }
         else
-            throw new Error('Entity is not available or invalid');
+            throw new A_ServerError({
+                title: 'Entity Not Found',
+                description: `Entity constructor for ASEID ${request.params.aseid} not found`,
+                status: 404,
+            });
     }
 
 
@@ -130,10 +147,10 @@ export class A_EntityController extends A_Component {
 
 
 
-    @A_Feature.Define({
-        name: 'callEntity',
-        invoke: false
-    })
+    // @A_Feature.Define({
+    //     name: 'callEntity',
+    //     invoke: false
+    // })
     @A_Router.Post({
         path: '/:aseid/:action',
         version: 'v1',
@@ -176,6 +193,6 @@ export class A_EntityController extends A_Component {
 
         response.add('result', scope.toJSON());
         response.add('entity', entity);
-        response.add('type', entity.entity);
+        response.add('type', entity.aseid.entity);
     }
 }

package/src/components/A-EntityRepository/A-EntityRepository.component.ts

@@ -0,0 +1,88 @@
+import { A_Caller, A_Component, A_Entity, A_Feature, A_Inject, A_Scope, A_TYPES__Entity_Constructor } from "@adaas/a-concept";
+import { A_TYPES__EntityFeatures } from "@adaas/a-concept/dist/src/global/A-Entity/A-Entity.constants";
+import { A_HTTPChannel } from "@adaas/a-server/channels/A-Http/A-Http.channel";
+import { A_EntityList } from "@adaas/a-server/entities/A_EntityList/A_EntityList.entity";
+import { A_Channel, A_Manifest } from "@adaas/a-utils";
+
+
+
+
+export class A_EntityRepository extends A_Component {
+
+
+    @A_Feature.Extend({
+        name: A_TYPES__EntityFeatures.LOAD,
+        scope: {
+            exclude: [A_EntityList]
+        }
+    })
+    async load(
+        @A_Inject(A_HTTPChannel) channel: A_HTTPChannel,
+        @A_Inject(A_Caller) entity: A_Entity,
+        @A_Inject(A_Scope) scope: A_Scope,
+    ) {
+        // Check if the scope has a manifest and if the entity is allowed to load
+        if (
+            scope.has(A_Manifest) && !scope.resolve(A_Manifest)
+                .isAllowed(entity.constructor, 'load')
+                .for(entity.constructor as A_TYPES__Entity_Constructor)
+        )
+            return;
+
+        const response = await channel.get(`/a-entity/${entity.aseid.toString()}`);
+
+        entity.fromJSON(response.data);
+    }
+
+
+    @A_Feature.Extend({
+        name: A_TYPES__EntityFeatures.SAVE,
+        scope: {
+            exclude: [A_EntityList]
+        }
+    })
+    async save(
+        @A_Inject(A_HTTPChannel) channel: A_HTTPChannel,
+        @A_Inject(A_Caller) entity: A_Entity,
+        @A_Inject(A_Scope) scope: A_Scope,
+    ) {
+        // Check if the scope has a manifest and if the entity is allowed to save
+        if (
+            scope.has(A_Manifest) && !scope.resolve(A_Manifest)
+                .isAllowed(entity.constructor, 'save')
+                .for(entity.constructor as A_TYPES__Entity_Constructor)
+        )
+            return;
+
+        const response = await channel.post(`/a-entity/${entity.aseid.toString()}`, entity.toJSON());
+
+        entity.fromJSON(response.data);
+    }
+
+
+    @A_Feature.Extend({
+        name: A_TYPES__EntityFeatures.DESTROY,
+        scope: {
+            exclude: [A_EntityList]
+        }
+    })
+    async destroy(
+        @A_Inject(A_HTTPChannel) channel: A_HTTPChannel,
+        @A_Inject(A_Caller) entity: A_Entity,
+        @A_Inject(A_Scope) scope: A_Scope,
+    ) {
+        // Check if the scope has a manifest and if the entity is allowed to destroy
+        if (
+            scope.has(A_Manifest) && !scope.resolve(A_Manifest)
+                .isAllowed(entity.constructor, 'destroy')
+                .for(entity.constructor as A_TYPES__Entity_Constructor)
+        )
+            return;
+
+        const response = await channel.delete(`/a-entity/${entity.aseid.toString()}`);
+
+        entity.fromJSON(response.data);
+    }
+
+
+}

package/src/components/A-ListingController/A-ListingController.component.ts

@@ -1,19 +1,20 @@
-import { A_Component, A_Config, A_Feature, A_Inject, A_Scope } from "@adaas/a-concept"
+import { A_Component,  A_Feature, A_Inject, A_Scope } from "@adaas/a-concept"
 import { A_EntityFactory } from "@adaas/a-server/context/A-EntityFactory/A-EntityFactory.context";
 import { A_Request } from "@adaas/a-server/entities/A-Request/A-Request.entity";
 import { A_Response } from "@adaas/a-server/entities/A-Response/A-Response.entity";
 import { A_Router } from "../A-Router/A-Router.component";
 import { A_EntityList } from "@adaas/a-server/entities/A_EntityList/A_EntityList.entity";
-import { A_ListQueryFilter } from "@adaas/a-server/context/A_ListQueryFilter/A_ListQueryFilter.context";
+import { A_ListQueryFilter } from "@adaas/a-server/context/A-ListQueryFilter/A_ListQueryFilter.context";
+import { A_Config } from "@adaas/a-utils";
 
 
 
 export class A_ListingController extends A_Component {
 
-    @A_Feature.Define({
-        name: 'listEntities',
-        invoke: false
-    })
+    // @A_Feature.Define({
+    //     name: 'listEntities',
+    //     invoke: false
+    // })
     @A_Router.Get({
         path: '/:type',
         version: 'v1',