@adaas/a-server 0.0.22 → 0.0.23

package/dist/node/lib/A-ServerRouter/A-ServerRouter.types.d.mts

@@ -0,0 +1,24 @@
+import { A_Component, A_TYPES__ComponentMeta } from '@adaas/a-concept';
+import { A_ServerRoute } from '../A-ServerRoute/A-ServerRoute.entity.mjs';
+import { A_ServerRouterMetaKeys } from './A-ServerRouter.constants.mjs';
+import '@adaas/a-utils/a-route';
+import '../A-ServerRoute/A-ServerRoute.types.mjs';
+import '../A-ServerRoute/A-ServerRoute.constants.mjs';
+
+type A_ServerRouterRouteDefinition = {
+    component: A_Component;
+    handler: string;
+    route: A_ServerRoute;
+};
+type A_ServerRouterMetaStructure = {
+    [A_ServerRouterMetaKeys.ROUTES]: Map<string, A_ServerRouterRouteDefinition>;
+    [A_ServerRouterMetaKeys.ROUTES_CONFIGS]: Array<A_ServerRoute>;
+} & A_TYPES__ComponentMeta;
+type A_ServerRouterMetaKeyNames = typeof A_ServerRouterMetaKeys[keyof typeof A_ServerRouterMetaKeys];
+type A_ServerRouterRouteConfig = {
+    path: string | RegExp;
+    version: string;
+    prefix: string;
+};
+
+export type { A_ServerRouterMetaKeyNames, A_ServerRouterMetaStructure, A_ServerRouterRouteConfig, A_ServerRouterRouteDefinition };

package/dist/node/lib/A-ServerRouter/A-ServerRouter.types.d.ts

@@ -0,0 +1,24 @@
+import { A_Component, A_TYPES__ComponentMeta } from '@adaas/a-concept';
+import { A_ServerRoute } from '../A-ServerRoute/A-ServerRoute.entity.js';
+import { A_ServerRouterMetaKeys } from './A-ServerRouter.constants.js';
+import '@adaas/a-utils/a-route';
+import '../A-ServerRoute/A-ServerRoute.types.js';
+import '../A-ServerRoute/A-ServerRoute.constants.js';
+
+type A_ServerRouterRouteDefinition = {
+    component: A_Component;
+    handler: string;
+    route: A_ServerRoute;
+};
+type A_ServerRouterMetaStructure = {
+    [A_ServerRouterMetaKeys.ROUTES]: Map<string, A_ServerRouterRouteDefinition>;
+    [A_ServerRouterMetaKeys.ROUTES_CONFIGS]: Array<A_ServerRoute>;
+} & A_TYPES__ComponentMeta;
+type A_ServerRouterMetaKeyNames = typeof A_ServerRouterMetaKeys[keyof typeof A_ServerRouterMetaKeys];
+type A_ServerRouterRouteConfig = {
+    path: string | RegExp;
+    version: string;
+    prefix: string;
+};
+
+export type { A_ServerRouterMetaKeyNames, A_ServerRouterMetaStructure, A_ServerRouterRouteConfig, A_ServerRouterRouteDefinition };

package/dist/node/lib/A-ServerRouter/A-ServerRouter.types.js

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

package/dist/node/lib/A-ServerRouter/A-ServerRouter.types.js.map

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

package/dist/node/lib/A-ServerRouter/A-ServerRouter.types.mjs

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

package/dist/node/lib/A-ServerRouter/A-ServerRouter.types.mjs.map

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

package/dist/node/lib/A-ServerRouter/A-ServerRouterDefine.decorator.d.mts

@@ -0,0 +1,16 @@
+import { A_TYPES__MetaLinkedComponentConstructors, A_Component } from '@adaas/a-concept';
+import { A_ServerRoute } from '../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';
+
+/**
+ *
+ * This decorator should allow to set a default meta type for the class, this helps to avoid
+ * the need to create custom meta classes for each class.
+ *
+ * @returns
+ */
+declare function A_ServerRouterDefineDecorator(route: A_ServerRoute): <TTarget extends A_TYPES__MetaLinkedComponentConstructors>(target: A_Component, propertyKey: string, descriptor: PropertyDescriptor) => any;
+
+export { A_ServerRouterDefineDecorator };

package/dist/node/lib/A-ServerRouter/A-ServerRouterDefine.decorator.d.ts

@@ -0,0 +1,16 @@
+import { A_TYPES__MetaLinkedComponentConstructors, A_Component } from '@adaas/a-concept';
+import { A_ServerRoute } from '../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';
+
+/**
+ *
+ * This decorator should allow to set a default meta type for the class, this helps to avoid
+ * the need to create custom meta classes for each class.
+ *
+ * @returns
+ */
+declare function A_ServerRouterDefineDecorator(route: A_ServerRoute): <TTarget extends A_TYPES__MetaLinkedComponentConstructors>(target: A_Component, propertyKey: string, descriptor: PropertyDescriptor) => any;
+
+export { A_ServerRouterDefineDecorator };

package/dist/node/lib/A-ServerRouter/A-ServerRouterDefine.decorator.js

@@ -0,0 +1,25 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var AServerRouter_component = require('./A-ServerRouter.component');
+
+function A_ServerRouterDefineDecorator(route) {
+  return function(target, propertyKey, descriptor) {
+    const meta = aConcept.A_Context.meta(AServerRouter_component.A_ServerRouter);
+    const searchKey = route.toAFeatureExtension(["A_ServerRouter", "A_Service"]);
+    meta.addRoute(searchKey, {
+      component: target,
+      handler: propertyKey,
+      route
+    });
+    aConcept.A_Feature_Define({
+      name: searchKey.source,
+      invoke: false
+    })(target, propertyKey, descriptor);
+    return aConcept.A_Feature_Extend(searchKey)(target, propertyKey, descriptor);
+  };
+}
+
+exports.A_ServerRouterDefineDecorator = A_ServerRouterDefineDecorator;
+//# sourceMappingURL=A-ServerRouterDefine.decorator.js.map
+//# sourceMappingURL=A-ServerRouterDefine.decorator.js.map

package/dist/node/lib/A-ServerRouter/A-ServerRouterDefine.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-ServerRouter/A-ServerRouterDefine.decorator.ts"],"names":["A_Context","A_ServerRouter","A_Feature_Define","A_Feature_Extend"],"mappings":";;;;;AAYO,SAAS,8BAA8B,KAAA,EAAsB;AAChE,EAAA,OAAO,SACH,MAAA,EACA,WAAA,EACA,UAAA,EACF;AAEE,IAAA,MAAM,IAAA,GAA2BA,kBAAA,CAAU,IAAA,CAAyBC,sCAAc,CAAA;AAElF,IAAA,MAAM,YAAY,KAAA,CAAM,mBAAA,CAAoB,CAAC,gBAAA,EAAkB,WAAW,CAAC,CAAA;AAE3E,IAAA,IAAA,CAAK,SAAS,SAAA,EAAW;AAAA,MACrB,SAAA,EAAW,MAAA;AAAA,MACX,OAAA,EAAS,WAAA;AAAA,MACT;AAAA,KACH,CAAA;AAED,IAAAC,yBAAA,CAAiB;AAAA,MACb,MAAM,SAAA,CAAU,MAAA;AAAA,MAChB,MAAA,EAAQ;AAAA,KACX,CAAA,CAAE,MAAA,EAAQ,WAAA,EAAa,UAAU,CAAA;AAElC,IAAA,OAAOC,yBAAA,CAAiB,SAAS,CAAA,CAAE,MAAA,EAAQ,aAAa,UAAU,CAAA;AAAA,EACtE,CAAA;AACJ","file":"A-ServerRouterDefine.decorator.js","sourcesContent":["import { A_Component, A_Context, A_Feature_Define, A_Feature_Extend, A_TYPES__MetaLinkedComponentConstructors } from \"@adaas/a-concept\";\nimport { A_ServerRouterMeta } from \"./A-ServerRouter.meta\";\nimport { A_ServerRoute } from \"../A-ServerRoute/A-ServerRoute.entity\";\nimport { A_ServerRouter } from \"./A-ServerRouter.component\";\n\n/**\n * \n * This decorator should allow to set a default meta type for the class, this helps to avoid\n * the need to create custom meta classes for each class.\n * \n * @returns \n */\nexport function A_ServerRouterDefineDecorator(route: A_ServerRoute) {\n    return function <TTarget extends A_TYPES__MetaLinkedComponentConstructors>(\n        target: A_Component,\n        propertyKey: string,\n        descriptor: PropertyDescriptor\n    ) {\n\n        const meta: A_ServerRouterMeta = A_Context.meta<A_ServerRouterMeta>(A_ServerRouter);\n\n        const searchKey = route.toAFeatureExtension(['A_ServerRouter', 'A_Service']);\n\n        meta.addRoute(searchKey, {\n            component: target,\n            handler: propertyKey,\n            route\n        });\n\n        A_Feature_Define({\n            name: searchKey.source,\n            invoke: false\n        })(target, propertyKey, descriptor)\n\n        return A_Feature_Extend(searchKey)(target, propertyKey, descriptor);\n    }\n}"]}

package/dist/node/lib/A-ServerRouter/A-ServerRouterDefine.decorator.mjs

@@ -0,0 +1,24 @@
+import '../../chunk-EQQGB2QZ.mjs';
+import { A_Context, A_Feature_Define, A_Feature_Extend } from '@adaas/a-concept';
+import { A_ServerRouter } from './A-ServerRouter.component';
+
+function A_ServerRouterDefineDecorator(route) {
+  return function(target, propertyKey, descriptor) {
+    const meta = A_Context.meta(A_ServerRouter);
+    const searchKey = route.toAFeatureExtension(["A_ServerRouter", "A_Service"]);
+    meta.addRoute(searchKey, {
+      component: target,
+      handler: propertyKey,
+      route
+    });
+    A_Feature_Define({
+      name: searchKey.source,
+      invoke: false
+    })(target, propertyKey, descriptor);
+    return A_Feature_Extend(searchKey)(target, propertyKey, descriptor);
+  };
+}
+
+export { A_ServerRouterDefineDecorator };
+//# sourceMappingURL=A-ServerRouterDefine.decorator.mjs.map
+//# sourceMappingURL=A-ServerRouterDefine.decorator.mjs.map

package/dist/node/lib/A-ServerRouter/A-ServerRouterDefine.decorator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-ServerRouter/A-ServerRouterDefine.decorator.ts"],"names":[],"mappings":";;;;AAYO,SAAS,8BAA8B,KAAA,EAAsB;AAChE,EAAA,OAAO,SACH,MAAA,EACA,WAAA,EACA,UAAA,EACF;AAEE,IAAA,MAAM,IAAA,GAA2B,SAAA,CAAU,IAAA,CAAyB,cAAc,CAAA;AAElF,IAAA,MAAM,YAAY,KAAA,CAAM,mBAAA,CAAoB,CAAC,gBAAA,EAAkB,WAAW,CAAC,CAAA;AAE3E,IAAA,IAAA,CAAK,SAAS,SAAA,EAAW;AAAA,MACrB,SAAA,EAAW,MAAA;AAAA,MACX,OAAA,EAAS,WAAA;AAAA,MACT;AAAA,KACH,CAAA;AAED,IAAA,gBAAA,CAAiB;AAAA,MACb,MAAM,SAAA,CAAU,MAAA;AAAA,MAChB,MAAA,EAAQ;AAAA,KACX,CAAA,CAAE,MAAA,EAAQ,WAAA,EAAa,UAAU,CAAA;AAElC,IAAA,OAAO,gBAAA,CAAiB,SAAS,CAAA,CAAE,MAAA,EAAQ,aAAa,UAAU,CAAA;AAAA,EACtE,CAAA;AACJ","file":"A-ServerRouterDefine.decorator.mjs","sourcesContent":["import { A_Component, A_Context, A_Feature_Define, A_Feature_Extend, A_TYPES__MetaLinkedComponentConstructors } from \"@adaas/a-concept\";\nimport { A_ServerRouterMeta } from \"./A-ServerRouter.meta\";\nimport { A_ServerRoute } from \"../A-ServerRoute/A-ServerRoute.entity\";\nimport { A_ServerRouter } from \"./A-ServerRouter.component\";\n\n/**\n * \n * This decorator should allow to set a default meta type for the class, this helps to avoid\n * the need to create custom meta classes for each class.\n * \n * @returns \n */\nexport function A_ServerRouterDefineDecorator(route: A_ServerRoute) {\n    return function <TTarget extends A_TYPES__MetaLinkedComponentConstructors>(\n        target: A_Component,\n        propertyKey: string,\n        descriptor: PropertyDescriptor\n    ) {\n\n        const meta: A_ServerRouterMeta = A_Context.meta<A_ServerRouterMeta>(A_ServerRouter);\n\n        const searchKey = route.toAFeatureExtension(['A_ServerRouter', 'A_Service']);\n\n        meta.addRoute(searchKey, {\n            component: target,\n            handler: propertyKey,\n            route\n        });\n\n        A_Feature_Define({\n            name: searchKey.source,\n            invoke: false\n        })(target, propertyKey, descriptor)\n\n        return A_Feature_Extend(searchKey)(target, propertyKey, descriptor);\n    }\n}"]}

package/dist/node/lib/A-ServerStatic/A-ServerStatic.component.d.mts

@@ -0,0 +1,65 @@
+import { A_Component } from '@adaas/a-concept';
+import { A as A_Request } from '../../A-Request.entity-r905O60G.mjs';
+import { A as A_Response } from '../../A-Response.entity-BVYAc6-8.mjs';
+import { A_StaticConfig, A_StaticAlias } from './A-ServerStatic.context.mjs';
+import { A_HttpServerFeatures } from '../A-Server/A-HttpServer.constants.mjs';
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { A_Polyfill } from '@adaas/a-utils/a-polyfill';
+import 'http';
+import '../A-Server/A-HttpServer.error.mjs';
+import '../A-Server/A-HttpServer.types.mjs';
+import '../A-Request/A-Request.constants.mjs';
+import '../A-Request/A-Request.env.mjs';
+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 '@adaas/a-utils/a-config';
+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 'stream';
+import '../A-Response/A-Response.constants.mjs';
+
+declare class A_StaticLoader extends A_Component {
+    private _fsPolyfill;
+    private _pathPolyfill;
+    load(logger: A_Logger, config: A_StaticConfig, polyfill: A_Polyfill): Promise<void>;
+    [A_HttpServerFeatures.onRequest](req: A_Request, res: A_Response, logger: A_Logger, config: A_StaticConfig, polyfill: A_Polyfill): Promise<void>;
+    /**
+     * Add a custom static file alias through the config
+     * @param alias - The URL path alias (e.g., '/assets')
+     * @param directory - The local directory path
+     * @param path - Optional custom path (defaults to alias)
+     * @param config - Static config instance
+     * @param logger - Logger instance for logging
+     */
+    addAlias(alias: string, directory: string, config: A_StaticConfig, logger?: A_Logger, path?: string): void;
+    /**
+     * Remove a static file alias through the config
+     * @param aliasPath - The path of the alias to remove
+     * @param config - Static config instance
+     * @param logger - Logger instance for logging
+     */
+    removeAlias(aliasPath: string, config: A_StaticConfig, logger?: A_Logger): boolean;
+    /**
+     * Get all configured aliases from config
+     * @param config - Static config instance
+     */
+    getAliases(config: A_StaticConfig): A_StaticAlias[];
+    /**
+     * Enable or disable an alias
+     * @param aliasPath - The path of the alias
+     * @param enabled - Whether to enable or disable
+     * @param config - Static config instance
+     * @param logger - Logger instance for logging
+     */
+    setAliasEnabled(aliasPath: string, enabled: boolean, config: A_StaticConfig, logger?: A_Logger): boolean;
+    protected getMimeType(ext: string): string;
+    protected safeFilePath(staticDir: string, reqUrl: string, host: string | undefined, pathPolyfill: any, fsPolyfill: any): string;
+    protected serveFile(filePath: string, res: A_Response, logger: A_Logger, fsPolyfill: any, pathPolyfill: any): Promise<void>;
+    protected getCacheControl(ext: string): string;
+}
+
+export { A_StaticLoader };

package/dist/node/lib/A-ServerStatic/A-ServerStatic.component.d.ts

@@ -0,0 +1,65 @@
+import { A_Component } from '@adaas/a-concept';
+import { A as A_Request } from '../../A-Request.entity-8_9MCXT2.js';
+import { A as A_Response } from '../../A-Response.entity-CRc-t-vr.js';
+import { A_StaticConfig, A_StaticAlias } from './A-ServerStatic.context.js';
+import { A_HttpServerFeatures } from '../A-Server/A-HttpServer.constants.js';
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { A_Polyfill } from '@adaas/a-utils/a-polyfill';
+import 'http';
+import '../A-Server/A-HttpServer.error.js';
+import '../A-Server/A-HttpServer.types.js';
+import '../A-Request/A-Request.constants.js';
+import '../A-Request/A-Request.env.js';
+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 '@adaas/a-utils/a-config';
+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 'stream';
+import '../A-Response/A-Response.constants.js';
+
+declare class A_StaticLoader extends A_Component {
+    private _fsPolyfill;
+    private _pathPolyfill;
+    load(logger: A_Logger, config: A_StaticConfig, polyfill: A_Polyfill): Promise<void>;
+    [A_HttpServerFeatures.onRequest](req: A_Request, res: A_Response, logger: A_Logger, config: A_StaticConfig, polyfill: A_Polyfill): Promise<void>;
+    /**
+     * Add a custom static file alias through the config
+     * @param alias - The URL path alias (e.g., '/assets')
+     * @param directory - The local directory path
+     * @param path - Optional custom path (defaults to alias)
+     * @param config - Static config instance
+     * @param logger - Logger instance for logging
+     */
+    addAlias(alias: string, directory: string, config: A_StaticConfig, logger?: A_Logger, path?: string): void;
+    /**
+     * Remove a static file alias through the config
+     * @param aliasPath - The path of the alias to remove
+     * @param config - Static config instance
+     * @param logger - Logger instance for logging
+     */
+    removeAlias(aliasPath: string, config: A_StaticConfig, logger?: A_Logger): boolean;
+    /**
+     * Get all configured aliases from config
+     * @param config - Static config instance
+     */
+    getAliases(config: A_StaticConfig): A_StaticAlias[];
+    /**
+     * Enable or disable an alias
+     * @param aliasPath - The path of the alias
+     * @param enabled - Whether to enable or disable
+     * @param config - Static config instance
+     * @param logger - Logger instance for logging
+     */
+    setAliasEnabled(aliasPath: string, enabled: boolean, config: A_StaticConfig, logger?: A_Logger): boolean;
+    protected getMimeType(ext: string): string;
+    protected safeFilePath(staticDir: string, reqUrl: string, host: string | undefined, pathPolyfill: any, fsPolyfill: any): string;
+    protected serveFile(filePath: string, res: A_Response, logger: A_Logger, fsPolyfill: any, pathPolyfill: any): Promise<void>;
+    protected getCacheControl(ext: string): string;
+}
+
+export { A_StaticLoader };

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

@@ -0,0 +1,260 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var ARequest_entity = require('@adaas/a-server/request/A-Request.entity');
+var AResponse_entity = require('@adaas/a-server/response/A-Response.entity');
+var AServerStatic_context = require('./A-ServerStatic.context');
+var AHttpServer_constants = require('@adaas/a-server/server/A-HttpServer.constants');
+var AHttpServer_error = require('@adaas/a-server/server/A-HttpServer.error');
+var aLogger = require('@adaas/a-utils/a-logger');
+var aPolyfill = require('@adaas/a-utils/a-polyfill');
+var AServerRoute_entity = require('@adaas/a-server/route/A-ServerRoute.entity');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = __getOwnPropDesc(target, key) ;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(target, key, result) ) || result;
+  if (result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+var _a;
+class A_StaticLoader extends aConcept.A_Component {
+  async load(logger, config, polyfill) {
+    this._fsPolyfill = await polyfill.fs();
+    this._pathPolyfill = await polyfill.path();
+    const aliases = config.getEnabledAliases();
+    logger.info(
+      "cyan",
+      `Static aliases configured:`,
+      ...aliases.map((alias) => `${alias.alias} -> ${alias.directory}`)
+    );
+  }
+  async [_a = AHttpServer_constants.A_HttpServerFeatures.onRequest](req, res, logger, config, polyfill) {
+    if (req.method !== "GET" && req.method !== "HEAD") {
+      return;
+    }
+    const { method, url } = req;
+    const route = new AServerRoute_entity.A_ServerRoute(url, method);
+    const alias = config.findMatchingAlias(route.path);
+    if (!alias) {
+      return;
+    }
+    try {
+      const fs = this._fsPolyfill || await polyfill.fs();
+      const path = this._pathPolyfill || await polyfill.path();
+      const staticDir = path.resolve(process.cwd(), alias.directory);
+      if (!fs.existsSync(staticDir)) {
+        logger.log("red", `Static directory ${staticDir} does not exist.`);
+        return;
+      }
+      const relativePath = route.path.replace(alias.path, "");
+      const safePath = this.safeFilePath(staticDir, relativePath, req.headers?.host, path, fs);
+      await this.serveFile(safePath, res, logger, fs, path);
+      logger.log("green", `Successfully served: ${safePath}`);
+    } catch (error) {
+      throw new AHttpServer_error.A_HttpServerError({
+        status: 500,
+        title: "Static File Serving Error",
+        description: `Error serving static file for ${route.path}: ${error.message}`,
+        originalError: error
+      });
+    }
+  }
+  /**
+   * Add a custom static file alias through the config
+   * @param alias - The URL path alias (e.g., '/assets')
+   * @param directory - The local directory path
+   * @param path - Optional custom path (defaults to alias)
+   * @param config - Static config instance
+   * @param logger - Logger instance for logging
+   */
+  addAlias(alias, directory, config, logger, path) {
+    config.addAlias(alias, directory, path);
+    if (logger) {
+      logger.log("cyan", `Static alias added: ${alias} -> ${directory}`);
+    }
+  }
+  /**
+   * Remove a static file alias through the config
+   * @param aliasPath - The path of the alias to remove
+   * @param config - Static config instance
+   * @param logger - Logger instance for logging
+   */
+  removeAlias(aliasPath, config, logger) {
+    const removed = config.removeAlias(aliasPath);
+    if (removed && logger) {
+      logger.log("yellow", `Static alias removed: ${aliasPath}`);
+    }
+    return removed;
+  }
+  /**
+   * Get all configured aliases from config
+   * @param config - Static config instance
+   */
+  getAliases(config) {
+    return config.getAliases();
+  }
+  /**
+   * Enable or disable an alias
+   * @param aliasPath - The path of the alias
+   * @param enabled - Whether to enable or disable
+   * @param config - Static config instance
+   * @param logger - Logger instance for logging
+   */
+  setAliasEnabled(aliasPath, enabled, config, logger) {
+    const result = config.setAliasEnabled(aliasPath, enabled);
+    if (result && logger) {
+      logger.log("blue", `Static alias ${enabled ? "enabled" : "disabled"}: ${aliasPath}`);
+    }
+    return result;
+  }
+  getMimeType(ext) {
+    const mimeTypes = {
+      // Text
+      ".html": "text/html",
+      ".htm": "text/html",
+      ".css": "text/css",
+      ".txt": "text/plain",
+      ".md": "text/markdown",
+      ".xml": "application/xml",
+      // JavaScript
+      ".js": "application/javascript",
+      ".mjs": "application/javascript",
+      ".jsx": "application/javascript",
+      ".ts": "application/typescript",
+      ".tsx": "application/typescript",
+      // JSON
+      ".json": "application/json",
+      ".jsonld": "application/ld+json",
+      // Images
+      ".png": "image/png",
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".gif": "image/gif",
+      ".svg": "image/svg+xml",
+      ".ico": "image/x-icon",
+      ".webp": "image/webp",
+      ".bmp": "image/bmp",
+      ".tiff": "image/tiff",
+      // Fonts
+      ".woff": "font/woff",
+      ".woff2": "font/woff2",
+      ".ttf": "font/ttf",
+      ".otf": "font/otf",
+      ".eot": "application/vnd.ms-fontobject",
+      // Audio/Video
+      ".mp3": "audio/mpeg",
+      ".wav": "audio/wav",
+      ".mp4": "video/mp4",
+      ".webm": "video/webm",
+      ".ogg": "application/ogg",
+      // Archives
+      ".zip": "application/zip",
+      ".tar": "application/x-tar",
+      ".gz": "application/gzip",
+      // Documents
+      ".pdf": "application/pdf",
+      ".doc": "application/msword",
+      ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+      ".xls": "application/vnd.ms-excel",
+      ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+    };
+    return mimeTypes[ext.toLowerCase()] || "application/octet-stream";
+  }
+  safeFilePath(staticDir, reqUrl, host = "localhost", pathPolyfill, fsPolyfill) {
+    const parsedUrl = new URL(reqUrl || "/", `http://${host}`);
+    let pathname = decodeURIComponent(parsedUrl.pathname);
+    pathname = pathname.replace(/\.\.[\/\\]/g, "");
+    let filePath = pathPolyfill.join(staticDir, pathname);
+    if (!fsPolyfill.existsSync(filePath)) {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    return filePath;
+  }
+  serveFile(filePath, res, logger, fsPolyfill, pathPolyfill) {
+    return new Promise((resolve, reject) => {
+      try {
+        if (fsPolyfill.existsSync(filePath)) {
+          const ext = pathPolyfill.extname(filePath);
+          const contentType = this.getMimeType(ext);
+          const headers = {
+            "Content-Type": contentType,
+            "Cache-Control": this.getCacheControl(ext),
+            "X-Content-Type-Options": "nosniff"
+          };
+          res.writeHead(200, headers);
+          const stream = fsPolyfill.createReadStream(filePath);
+          if (stream && res.original) {
+            stream.pipe(res.original);
+            stream.on("end", () => {
+              resolve();
+            });
+            stream.on("error", (err) => {
+              reject(new AHttpServer_error.A_HttpServerError({
+                status: 500,
+                title: "File Stream Error",
+                description: `Error reading file stream for ${filePath}: ${err.message}`,
+                originalError: err
+              }));
+            });
+          } else {
+            reject(new AHttpServer_error.A_HttpServerError({
+              status: 500,
+              title: "Response Stream Error",
+              description: `Unable to pipe file stream for ${filePath}`
+            }));
+          }
+        } else {
+          reject(new AHttpServer_error.A_HttpServerError({
+            status: 404,
+            title: "File Not Found",
+            description: `File not found: ${filePath}`
+          }));
+        }
+      } catch (error) {
+        logger.error(`Error serving file: ${error.message}`);
+        reject(new AHttpServer_error.A_HttpServerError({
+          status: 500,
+          title: "Internal Server Error",
+          description: `Error serving file: ${error.message}`,
+          originalError: error
+        }));
+      }
+    });
+  }
+  getCacheControl(ext) {
+    const staticAssets = [".css", ".js", ".png", ".jpg", ".jpeg", ".gif", ".svg", ".ico", ".woff", ".woff2", ".ttf", ".otf"];
+    const dynamicContent = [".html", ".htm"];
+    if (staticAssets.includes(ext.toLowerCase())) {
+      return "public, max-age=31536000";
+    } else if (dynamicContent.includes(ext.toLowerCase())) {
+      return "public, max-age=3600";
+    } else {
+      return "public, max-age=86400";
+    }
+  }
+}
+__decorateClass([
+  aConcept.A_Concept.Load(),
+  __decorateParam(0, aConcept.A_Inject(aLogger.A_Logger)),
+  __decorateParam(1, aConcept.A_Inject(AServerStatic_context.A_StaticConfig)),
+  __decorateParam(2, aConcept.A_Inject(aPolyfill.A_Polyfill))
+], A_StaticLoader.prototype, "load");
+__decorateClass([
+  aConcept.A_Feature.Extend({
+    before: /.*/
+  }),
+  __decorateParam(0, aConcept.A_Inject(ARequest_entity.A_Request)),
+  __decorateParam(1, aConcept.A_Inject(AResponse_entity.A_Response)),
+  __decorateParam(2, aConcept.A_Inject(aLogger.A_Logger)),
+  __decorateParam(3, aConcept.A_Inject(AServerStatic_context.A_StaticConfig)),
+  __decorateParam(4, aConcept.A_Inject(aPolyfill.A_Polyfill))
+], A_StaticLoader.prototype, _a);
+
+exports.A_StaticLoader = A_StaticLoader;
+//# sourceMappingURL=A-ServerStatic.component.js.map
+//# sourceMappingURL=A-ServerStatic.component.js.map

package/dist/node/lib/A-ServerStatic/A-ServerStatic.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/A-ServerStatic/A-ServerStatic.component.ts"],"names":["A_Component","A_ServerRoute","A_HttpServerError","A_Concept","A_Logger","A_StaticConfig","A_Polyfill","A_Feature","A_Request","A_Response"],"mappings":"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","file":"A-ServerStatic.component.js","sourcesContent":["import { A_Component, A_Concept, A_Feature, A_Inject } from \"@adaas/a-concept\"\nimport { A_Request } from \"@adaas/a-server/request/A-Request.entity\";\nimport { A_Response } from \"@adaas/a-server/response/A-Response.entity\";\nimport { A_StaticConfig, A_StaticAlias } from \"./A-ServerStatic.context\";\nimport { A_HttpServerFeatures } from \"@adaas/a-server/server/A-HttpServer.constants\";\nimport { A_HttpServerError } from \"@adaas/a-server/server/A-HttpServer.error\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { A_Polyfill } from \"@adaas/a-utils/a-polyfill\";\nimport { A_ServerRoute } from \"@adaas/a-server/route/A-ServerRoute.entity\";\n\nexport class A_StaticLoader extends A_Component {\n\n    private _fsPolyfill: any;\n    private _pathPolyfill: any;\n\n    @A_Concept.Load()\n    async load(\n        @A_Inject(A_Logger) logger: A_Logger,\n        @A_Inject(A_StaticConfig) config: A_StaticConfig,\n        @A_Inject(A_Polyfill) polyfill: A_Polyfill\n    ) {\n        // Initialize polyfills\n        this._fsPolyfill = await polyfill.fs();\n        this._pathPolyfill = await polyfill.path();\n\n        // Log configured aliases\n        const aliases = config.getEnabledAliases();\n        logger.info('cyan',\n\n            `Static aliases configured:`,\n            ...aliases.map(alias => `${alias.alias} -> ${alias.directory}`)\n        );\n    }\n\n\n    // =======================================================\n    // ================ Method Definition=====================\n    // =======================================================\n\n    @A_Feature.Extend({\n        before: /.*/\n    })\n    async [A_HttpServerFeatures.onRequest](\n        @A_Inject(A_Request) req: A_Request,\n        @A_Inject(A_Response) res: A_Response,\n        @A_Inject(A_Logger) logger: A_Logger,\n        @A_Inject(A_StaticConfig) config: A_StaticConfig,\n        @A_Inject(A_Polyfill) polyfill: A_Polyfill\n    ) {\n\n        if (req.method !== 'GET' && req.method !== 'HEAD') {\n            return; // Only handle GET and HEAD requests\n        }\n\n        const { method, url } = req;\n        const route = new A_ServerRoute(url, method);\n\n        // Check if this request matches any of our configured aliases\n        const alias = config.findMatchingAlias(route.path);\n        if (!alias) {\n            return; // No static config for this path\n        }\n\n        try {\n            // Ensure polyfills are available\n            const fs = this._fsPolyfill || await polyfill.fs();\n            const path = this._pathPolyfill || await polyfill.path();\n\n            const staticDir = path.resolve(process.cwd(), alias.directory);\n\n            // Validate static directory exists\n            if (!fs.existsSync(staticDir)) {\n                logger.log(\"red\", `Static directory ${staticDir} does not exist.`);\n                return;\n            }\n\n            // Get the file path relative to the alias\n            const relativePath = route.path.replace(alias.path, '');\n            const safePath = this.safeFilePath(staticDir, relativePath, req.headers?.host, path, fs);\n\n            await this.serveFile(safePath, res, logger, fs, path);\n\n            logger.log('green', `Successfully served: ${safePath}`);\n\n        } catch (error: any) {\n            throw new A_HttpServerError({\n                status: 500,\n                title: 'Static File Serving Error',\n                description: `Error serving static file for ${route.path}: ${error.message}`,\n                originalError: error\n            });\n        }\n    }\n\n    /**\n     * Add a custom static file alias through the config\n     * @param alias - The URL path alias (e.g., '/assets')\n     * @param directory - The local directory path\n     * @param path - Optional custom path (defaults to alias)\n     * @param config - Static config instance\n     * @param logger - Logger instance for logging\n     */\n    public addAlias(\n        alias: string,\n        directory: string,\n        config: A_StaticConfig,\n        logger?: A_Logger,\n        path?: string\n    ): void {\n        config.addAlias(alias, directory, path);\n\n        if (logger) {\n            logger.log('cyan', `Static alias added: ${alias} -> ${directory}`);\n        }\n    }\n\n    /**\n     * Remove a static file alias through the config\n     * @param aliasPath - The path of the alias to remove\n     * @param config - Static config instance\n     * @param logger - Logger instance for logging\n     */\n    public removeAlias(aliasPath: string, config: A_StaticConfig, logger?: A_Logger): boolean {\n        const removed = config.removeAlias(aliasPath);\n\n        if (removed && logger) {\n            logger.log('yellow', `Static alias removed: ${aliasPath}`);\n        }\n\n        return removed;\n    }\n\n    /**\n     * Get all configured aliases from config\n     * @param config - Static config instance\n     */\n    public getAliases(config: A_StaticConfig): A_StaticAlias[] {\n        return config.getAliases();\n    }\n\n    /**\n     * Enable or disable an alias\n     * @param aliasPath - The path of the alias\n     * @param enabled - Whether to enable or disable\n     * @param config - Static config instance\n     * @param logger - Logger instance for logging\n     */\n    public setAliasEnabled(\n        aliasPath: string,\n        enabled: boolean,\n        config: A_StaticConfig,\n        logger?: A_Logger\n    ): boolean {\n        const result = config.setAliasEnabled(aliasPath, enabled);\n\n        if (result && logger) {\n            logger.log('blue', `Static alias ${enabled ? 'enabled' : 'disabled'}: ${aliasPath}`);\n        }\n\n        return result;\n    }\n\n    protected getMimeType(ext: string): string {\n        const mimeTypes: Record<string, string> = {\n            // Text\n            \".html\": \"text/html\",\n            \".htm\": \"text/html\",\n            \".css\": \"text/css\",\n            \".txt\": \"text/plain\",\n            \".md\": \"text/markdown\",\n            \".xml\": \"application/xml\",\n\n            // JavaScript\n            \".js\": \"application/javascript\",\n            \".mjs\": \"application/javascript\",\n            \".jsx\": \"application/javascript\",\n            \".ts\": \"application/typescript\",\n            \".tsx\": \"application/typescript\",\n\n            // JSON\n            \".json\": \"application/json\",\n            \".jsonld\": \"application/ld+json\",\n\n            // Images\n            \".png\": \"image/png\",\n            \".jpg\": \"image/jpeg\",\n            \".jpeg\": \"image/jpeg\",\n            \".gif\": \"image/gif\",\n            \".svg\": \"image/svg+xml\",\n            \".ico\": \"image/x-icon\",\n            \".webp\": \"image/webp\",\n            \".bmp\": \"image/bmp\",\n            \".tiff\": \"image/tiff\",\n\n            // Fonts\n            \".woff\": \"font/woff\",\n            \".woff2\": \"font/woff2\",\n            \".ttf\": \"font/ttf\",\n            \".otf\": \"font/otf\",\n            \".eot\": \"application/vnd.ms-fontobject\",\n\n            // Audio/Video\n            \".mp3\": \"audio/mpeg\",\n            \".wav\": \"audio/wav\",\n            \".mp4\": \"video/mp4\",\n            \".webm\": \"video/webm\",\n            \".ogg\": \"application/ogg\",\n\n            // Archives\n            \".zip\": \"application/zip\",\n            \".tar\": \"application/x-tar\",\n            \".gz\": \"application/gzip\",\n\n            // Documents\n            \".pdf\": \"application/pdf\",\n            \".doc\": \"application/msword\",\n            \".docx\": \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n            \".xls\": \"application/vnd.ms-excel\",\n            \".xlsx\": \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n        };\n\n        return mimeTypes[ext.toLowerCase()] || \"application/octet-stream\";\n    }\n\n\n    protected safeFilePath(staticDir: string, reqUrl: string, host: string = 'localhost', pathPolyfill: any, fsPolyfill: any): string {\n        const parsedUrl = new URL(reqUrl || \"/\", `http://${host}`);\n        let pathname = decodeURIComponent(parsedUrl.pathname);\n\n        // Prevent path traversal attacks\n        pathname = pathname.replace(/\\.\\.[\\/\\\\]/g, \"\");\n\n        let filePath = pathPolyfill.join(staticDir, pathname);\n\n        if (!fsPolyfill.existsSync(filePath)) {\n            throw new Error(`File not found: ${filePath}`);\n        }\n\n        return filePath;\n    }\n\n    protected serveFile(\n        filePath: string,\n        res: A_Response,\n        logger: A_Logger,\n        fsPolyfill: any,\n        pathPolyfill: any\n    ): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            try {\n                if (fsPolyfill.existsSync(filePath)) {\n                    const ext = pathPolyfill.extname(filePath);\n                    const contentType = this.getMimeType(ext);\n\n                    // Set appropriate headers\n                    const headers: Record<string, string> = {\n                        \"Content-Type\": contentType,\n                        \"Cache-Control\": this.getCacheControl(ext),\n                        \"X-Content-Type-Options\": \"nosniff\"\n                    };\n\n                    res.writeHead(200, headers);\n\n                    const stream = fsPolyfill.createReadStream(filePath);\n\n                    if (stream && res.original) {\n                        stream.pipe(res.original);\n\n                        stream.on('end', () => {\n                            resolve();\n                        });\n\n                        stream.on(\"error\", (err: any) => {\n                            reject(new A_HttpServerError({\n                                status: 500,\n                                title: 'File Stream Error',\n                                description: `Error reading file stream for ${filePath}: ${err.message}`,\n                                originalError: err\n                            }));\n                        });\n                    } else {\n                        reject(new A_HttpServerError({\n                            status: 500,\n                            title: 'Response Stream Error',\n                            description: `Unable to pipe file stream for ${filePath}`,\n                        }));\n                    }\n                } else {\n                    reject(new A_HttpServerError({\n                        status: 404,\n                        title: 'File Not Found',\n                        description: `File not found: ${filePath}`,\n                    }));\n                }\n            } catch (error: any) {\n                logger.error(`Error serving file: ${error.message}`);\n                reject(new A_HttpServerError({\n                    status: 500,\n                    title: 'Internal Server Error',\n                    description: `Error serving file: ${error.message}`,\n                    originalError: error\n                }));\n            }\n        });\n    }\n\n    protected getCacheControl(ext: string): string {\n        // Different cache strategies for different file types\n        const staticAssets = ['.css', '.js', '.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico', '.woff', '.woff2', '.ttf', '.otf'];\n        const dynamicContent = ['.html', '.htm'];\n\n        if (staticAssets.includes(ext.toLowerCase())) {\n            return \"public, max-age=31536000\"; // 1 year for static assets\n        } else if (dynamicContent.includes(ext.toLowerCase())) {\n            return \"public, max-age=3600\"; // 1 hour for HTML\n        } else {\n            return \"public, max-age=86400\"; // 1 day for other files\n        }\n    }\n\n}\n\n\n"]}