@kvishal04/library-core 1.0.0

package/dist/system/config-manager/handlers/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../../core/system/config-manager/handlers/tree.ts"],"names":[],"mappings":"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"}

package/dist/system/config-manager/helpers.d.ts

@@ -0,0 +1,20 @@
+export declare const CONFIG_ROOT: string;
+export declare function resolveConfigPath(relativePath: string): string;
+export declare function ensurePathInsideRoot(resolvedPath: string): void;
+export declare function ensureFolder(folderPath: string): Promise<void>;
+export declare function normalizeToConfigFile(relativePath: string, allowDirectory?: boolean): string;
+/**
+ * Writes the status value into the file's `<file>:status` alternate data stream.
+ */
+export declare function writeFileStatus(filePath: string, status: 'active' | 'inactive'): Promise<void>;
+/**
+ * Reads the status value from the file's `<file>:status` alternate data stream.
+ * Returns null if the stream does not exist yet.
+ */
+export declare function readFileStatus(filePath: string): Promise<'active' | 'inactive' | null>;
+export declare function buildTree(dirPath: string, relativeBase?: string): Promise<any[]>;
+export declare function countTreeItems(nodes: any[]): {
+    files: number;
+    directories: number;
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/system/config-manager/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../core/system/config-manager/helpers.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,EAAyC,MAAM,CAAC;AAIxE,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,MAAM,CAU1F;AAUD;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAC5B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC,CASvC;AAID,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAuBlF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAgBnF"}

package/dist/system/config-manager/helpers.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_ROOT = void 0;
+exports.resolveConfigPath = resolveConfigPath;
+exports.ensurePathInsideRoot = ensurePathInsideRoot;
+exports.ensureFolder = ensureFolder;
+exports.normalizeToConfigFile = normalizeToConfigFile;
+exports.writeFileStatus = writeFileStatus;
+exports.readFileStatus = readFileStatus;
+exports.buildTree = buildTree;
+exports.countTreeItems = countTreeItems;
+const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("fs/promises"));
+const appConfig_1 = __importDefault(require("../../appConfig"));
+exports.CONFIG_ROOT = appConfig_1.default.get('APP_CONFIG_ROOT');
+// ─── Path Utilities ───────────────────────────────────────────────────────────
+function resolveConfigPath(relativePath) {
+    if (!relativePath || typeof relativePath !== 'string') {
+        throw new Error('Path is required');
+    }
+    const normalized = path_1.default.normalize(relativePath);
+    if (normalized.startsWith('..') || path_1.default.isAbsolute(normalized)) {
+        throw new Error('Invalid path');
+    }
+    return path_1.default.resolve(exports.CONFIG_ROOT, normalized);
+}
+function ensurePathInsideRoot(resolvedPath) {
+    if (!resolvedPath.startsWith(path_1.default.resolve(exports.CONFIG_ROOT))) {
+        throw new Error('Path outside config root is not allowed');
+    }
+}
+async function ensureFolder(folderPath) {
+    await promises_1.default.mkdir(folderPath, { recursive: true, mode: 0o755 });
+}
+function normalizeToConfigFile(relativePath, allowDirectory = false) {
+    if (!relativePath || typeof relativePath !== 'string') {
+        throw new Error('Path is required');
+    }
+    if (allowDirectory && relativePath.endsWith('/'))
+        return relativePath;
+    const ext = path_1.default.extname(relativePath);
+    if (!ext)
+        return `${relativePath}.config`;
+    if (ext !== '.config')
+        throw new Error('Only .config files are allowed');
+    return relativePath;
+}
+// ─── File Attribute Utilities (NTFS Alternate Data Streams) ─────────────────
+//
+// Status is stored as a named stream on the file: `file.config:status`
+// The main file content is never modified. ADS is invisible to normal reads
+// and travels with the file on NTFS volumes.
+const STATUS_STREAM = ':status';
+/**
+ * Writes the status value into the file's `<file>:status` alternate data stream.
+ */
+async function writeFileStatus(filePath, status) {
+    await promises_1.default.writeFile(`${filePath}${STATUS_STREAM}`, status, 'utf8');
+}
+/**
+ * Reads the status value from the file's `<file>:status` alternate data stream.
+ * Returns null if the stream does not exist yet.
+ */
+async function readFileStatus(filePath) {
+    try {
+        const raw = await promises_1.default.readFile(`${filePath}${STATUS_STREAM}`, 'utf8');
+        const val = raw.trim().toLowerCase();
+        if (val === 'active' || val === 'inactive')
+            return val;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Tree Builder ─────────────────────────────────────────────────────────────
+async function buildTree(dirPath, relativeBase = '') {
+    const entries = await promises_1.default.readdir(dirPath, { withFileTypes: true });
+    const items = [];
+    for (const entry of entries) {
+        const entryFull = path_1.default.join(dirPath, entry.name);
+        const entryRel = path_1.default.join(relativeBase || '', entry.name).replace(/\\/g, '/');
+        const stat = await promises_1.default.stat(entryFull).catch(() => null);
+        if (entry.isDirectory()) {
+            const children = await buildTree(entryFull, entryRel);
+            items.push({ name: entry.name, type: 'directory', path: entryRel + '/', children });
+        }
+        else {
+            const fileStatus = await readFileStatus(entryFull);
+            items.push({
+                name: entry.name,
+                type: 'file',
+                path: entryRel,
+                size: stat?.size ?? 0,
+                modifiedAt: stat?.mtime ?? null,
+                configStatus: fileStatus ?? 'active',
+            });
+        }
+    }
+    return items;
+}
+function countTreeItems(nodes) {
+    let files = 0;
+    let directories = 0;
+    for (const node of nodes) {
+        if (node.type === 'directory') {
+            directories++;
+            if (node.children?.length) {
+                const child = countTreeItems(node.children);
+                files += child.files;
+                directories += child.directories;
+            }
+        }
+        else {
+            files++;
+        }
+    }
+    return { files, directories };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/system/config-manager/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../core/system/config-manager/helpers.ts"],"names":[],"mappings":"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"}

package/dist/system/config-manager/index.d.ts

@@ -0,0 +1,3 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;
+//# sourceMappingURL=index.d.ts.map

package/dist/system/config-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/system/config-manager/index.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,MAAM,4CAAmB,CAAC;AAWhC,eAAe,MAAM,CAAC"}

package/dist/system/config-manager/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const tree_1 = require("./handlers/tree");
+const file_1 = require("./handlers/file");
+const status_1 = require("./handlers/status");
+const rename_1 = require("./handlers/rename");
+const reload_configs_1 = require("./handlers/reload-configs");
+const router = express_1.default.Router();
+router.post('/config-manager/tree', tree_1.treeHandler);
+router.post('/config-manager/reload', tree_1.reloadHandler);
+router.post('/config-manager/file', file_1.fileHandler);
+router.post('/config-manager/save', express_1.default.text({ type: '*/*', limit: '10mb' }), file_1.saveHandler);
+router.post('/config-manager/status', status_1.statusHandler);
+router.post('/config-manager/rename', rename_1.renameHandler);
+router.post('/config-manager/reload-configs', reload_configs_1.reloadConfigsHandler);
+router.post('/config-manager/get-config', reload_configs_1.getConfigHandler);
+exports.default = router;
+//# sourceMappingURL=index.js.map

package/dist/system/config-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/system/config-manager/index.ts"],"names":[],"mappings":";;;;;AAAA,sDAA8B;AAC9B,0CAA6D;AAC7D,0CAA2D;AAC3D,8CAAkD;AAClD,8CAAkD;AAClD,8DAGmC;AAEnC,MAAM,MAAM,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;AAEhC,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAY,kBAAW,CAAC,CAAC;AAC3D,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAU,oBAAa,CAAC,CAAC;AAC7D,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAY,kBAAW,CAAC,CAAC;AAC3D,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAY,iBAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAW,CAAC,CAAC;AACzG,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAU,sBAAa,CAAC,CAAC;AAC7D,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAU,sBAAa,CAAC,CAAC;AAC7D,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,qCAAoB,CAAC,CAAC;AACpE,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAM,iCAAgB,CAAC,CAAC;AAEhE,kBAAe,MAAM,CAAC"}

package/dist/system.applications/configure-app-cors.d.ts

@@ -0,0 +1,3 @@
+import { ApplicationConfig } from '../interfaces/application.interfaces';
+export declare function configureAppCors(config: ApplicationConfig): any;
+//# sourceMappingURL=configure-app-cors.d.ts.map

package/dist/system.applications/configure-app-cors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-app-cors.d.ts","sourceRoot":"","sources":["../../core/system.applications/configure-app-cors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAGzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,OAgCzD"}

package/dist/system.applications/configure-app-cors.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureAppCors = configureAppCors;
+const cors_1 = __importDefault(require("cors"));
+const application_config_1 = require("../defaults/application.config");
+function configureAppCors(config) {
+    const corsConfig = {
+        ...application_config_1.APP_DEFAULT_CONFIG.cors,
+        ...config.cors,
+    };
+    const allowedMethods = config.allowedMethods ?? application_config_1.APP_DEFAULT_CONFIG.allowedMethods ?? ['POST', 'OPTIONS'];
+    const allowedHeaders = config.allowedHeaders ?? application_config_1.APP_DEFAULT_CONFIG.allowedHeaders ?? [];
+    const options = {
+        origin: (origin, callback) => {
+            const allowed = corsConfig.allowedOrigins;
+            if (allowed.includes('*')) {
+                return callback(null, true);
+            }
+            if (!origin || allowed.includes(origin)) {
+                return callback(null, true);
+            }
+            return callback(new Error('CORS origin denied'), false);
+        },
+        credentials: corsConfig.allowCredentials,
+        maxAge: corsConfig.maxAge,
+        exposedHeaders: corsConfig.exposedHeaders,
+        methods: allowedMethods,
+        allowedHeaders: allowedHeaders,
+    };
+    return (0, cors_1.default)(options);
+}
+//# sourceMappingURL=configure-app-cors.js.map

package/dist/system.applications/configure-app-cors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-app-cors.js","sourceRoot":"","sources":["../../core/system.applications/configure-app-cors.ts"],"names":[],"mappings":";;;;;AAIA,4CAgCC;AApCD,gDAAyC;AAEzC,uEAAoE;AAEpE,SAAgB,gBAAgB,CAAC,MAAyB;IACxD,MAAM,UAAU,GAAG;QACjB,GAAG,uCAAkB,CAAC,IAAI;QAC1B,GAAG,MAAM,CAAC,IAAI;KACf,CAAC;IAEF,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,uCAAkB,CAAC,cAAc,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzG,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,uCAAkB,CAAC,cAAc,IAAI,EAAE,CAAC;IAExF,MAAM,OAAO,GAAgB;QAC3B,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC;YAE1C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9B,CAAC;YAED,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxC,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9B,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;QAED,WAAW,EAAE,UAAU,CAAC,gBAAgB;QACxC,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,OAAO,EAAE,cAAc;QACvB,cAAc,EAAE,cAAc;KAC/B,CAAC;IAEF,OAAO,IAAA,cAAI,EAAC,OAAO,CAAC,CAAC;AACvB,CAAC"}

package/dist/system.applications/controller.d.ts

@@ -0,0 +1,48 @@
+import { Response } from 'express';
+import { ServiceResponse } from './response.types';
+import { ApplicationConfig, RouteDefinition } from '../interfaces/application.interfaces';
+export declare class ApiController {
+    private readonly config;
+    constructor(config: ApplicationConfig);
+    parseAction(action: string): {
+        method: string;
+        slug: string;
+    };
+    /**
+     * Resolve stage by group name
+     */
+    resolveStage(group: string): RouteDefinition;
+    /**
+     * Resolve action slug → service method
+     */
+    resolveAction(stage: RouteDefinition, slug: string): {
+        method: string;
+        slug: string;
+    };
+    /**
+     * Validate developer key
+     */
+    validateDevKey(): Promise<void>;
+    validateBodyForSpecialCharacter(body: any): Promise<void>;
+    /**
+     * Validate stage access (auth / session / RBAC)
+     */
+    validateStage(stage: any): Promise<void>;
+    /**
+     * Unified error handler
+     */
+    static handleError(res: Response, err: any): void;
+    /**
+     * Typed error factory
+     */
+    static error(status: number, message: string, debug?: unknown): {
+        status: number;
+        message: string;
+        debug: unknown;
+    };
+    /**
+     * Unified response sender
+     */
+    static sendResponse(res: Response, result: ServiceResponse): void;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/system.applications/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../core/system.applications/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE1F,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IACtD,WAAW,CAAC,MAAM,EAAE,MAAM;;;;IAO1B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAQ5C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM;;;;IAalD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,+BAA+B,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IAUjD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;;;;;IAI7D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;CAsElE"}

package/dist/system.applications/controller.js

@@ -0,0 +1,165 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiController = void 0;
+const handlebars_1 = __importDefault(require("handlebars"));
+class ApiController {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    parseAction(action) {
+        const [method, slug] = action.split('|');
+        return {
+            method,
+            slug: slug || method,
+        };
+    }
+    /**
+     * Resolve stage by group name
+     */
+    resolveStage(group) {
+        const stage = this.config.routes.find((s) => s.name === group);
+        if (!stage) {
+            throw ApiController.error(404, `Invalid API group: ${group}`);
+        }
+        return stage;
+    }
+    /**
+     * Resolve action slug → service method
+     */
+    resolveAction(stage, slug) {
+        const match = stage.actions.find((a) => {
+            const { slug: actionSlug } = this.parseAction(a);
+            return actionSlug === slug;
+        });
+        if (!match) {
+            throw ApiController.error(404, `Action '${slug}' not allowed for group '${stage.name}'`);
+        }
+        return this.parseAction(match);
+    }
+    /**
+     * Validate developer key
+     */
+    async validateDevKey() {
+        console.log('Validating dev key...');
+        if (!this.config.validateDevKey)
+            return;
+        const ok = await this.config.validateDevKey();
+        if (!ok) {
+            throw ApiController.error(401, 'Invalid developer key');
+        }
+    }
+    async validateBodyForSpecialCharacter(body) {
+        console.log('Validating body for special characters...');
+        if (!this.config.validateBodyForSpecialCharacter)
+            return;
+        const ok = await this.config.validateBodyForSpecialCharacter(body);
+        if (!ok) {
+            throw ApiController.error(400, 'Body contains invalid characters');
+        }
+    }
+    /**
+     * Validate stage access (auth / session / RBAC)
+     */
+    async validateStage(stage) {
+        if (!this.config.stageValidation)
+            return;
+        const ok = await this.config.stageValidation(stage);
+        var stageErrorMessage = '';
+        if (!ok) {
+            // check for custom error message
+            if (this.config.stageErrorMessage) {
+                const stageError = this.config.stageErrorMessage.filter((s) => s.stage === stage)[0];
+                if (stageError) {
+                    stageErrorMessage = stageError.message;
+                }
+            }
+            throw ApiController.error(403, stageErrorMessage || 'Stage access denied');
+        }
+    }
+    /**
+     * Unified error handler
+     */
+    static handleError(res, err) {
+        const status = err.status || 500;
+        res.status(status).json({
+            status: false,
+            message: err.message || 'Internal Server Error',
+            ...(err.debug && { debug: err.debug }),
+        });
+    }
+    /**
+     * Typed error factory
+     */
+    static error(status, message, debug) {
+        return { status, message, debug };
+    }
+    /**
+     * Unified response sender
+     */
+    static sendResponse(res, result) {
+        switch (result.kind) {
+            case 'json':
+                res.status(result.statusCode ?? 200).json({
+                    status: result.payload && 'status' in result.payload ? result.payload.status : true,
+                    statusCode: result.statusCode ?? 200,
+                    // success: result.success ?? (result.statusCode ? result.statusCode >= 200 && result.statusCode < 300 : true),
+                    message: result.payload && 'message' in result.payload
+                        ? result.payload.message
+                        : 'Success',
+                    output: result.payload && 'output' in result.payload
+                        ? result.payload.output
+                        : undefined,
+                    error: result.payload && 'error' in result.payload ? result.payload.error : undefined,
+                    ...(result.payload.translationId && { translationId: result.payload.translationId }),
+                    //payload: result.payload,
+                });
+                break;
+            case 'buffer':
+                if (result.contentType) {
+                    res.setHeader('Content-Type', result.contentType);
+                }
+                res.status(result.statusCode ?? 200).send(result.buffer);
+                break;
+            case 'render':
+                const { view, data, statusCode } = result;
+                // Heuristic: inline template vs file
+                const isInlineTemplate = view.includes('{{') || view.includes('<');
+                if (isInlineTemplate) {
+                    const template = handlebars_1.default.compile(view);
+                    const html = template(data || {});
+                    res.status(statusCode ?? 200).send(html);
+                    return;
+                }
+                // File-based render (Handlebars engine)
+                res.status(statusCode ?? 200).render(view, data);
+                break;
+            case 'file':
+                if (result.mimeType) {
+                    res.setHeader('Content-Type', result.mimeType);
+                }
+                res.setHeader('Content-Disposition', `attachment; filename="${result.fileName}"`);
+                res.download(result.filePath, result.fileName, (err) => {
+                    if (err && !res.headersSent) {
+                        console.error('Error downloading file:', err);
+                        res.status(500).json({
+                            status: false,
+                            message: 'Failed to download file',
+                            error: err.message,
+                        });
+                    }
+                });
+                break;
+            default:
+                res.status(500).json({
+                    status: false,
+                    message: 'Invalid response type',
+                });
+        }
+    }
+}
+exports.ApiController = ApiController;
+//# sourceMappingURL=controller.js.map

package/dist/system.applications/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../core/system.applications/controller.ts"],"names":[],"mappings":"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"}

package/dist/system.applications/requestContext.d.ts

@@ -0,0 +1,41 @@
+/**
+ * RequestContext
+ *
+ * - Request-scoped storage
+ * - Safe for concurrent users
+ * - Automatically cleared after request lifecycle
+ */
+export declare class RequestContext {
+    private static storage;
+    /**
+     * Initialize a new request context.
+     * Must be called once per request (middleware).
+     */
+    static run<T>(callback: () => T): T;
+    /**
+     * Set a value in the current request context
+     */
+    static set<T = unknown>(key: string, value: T): void;
+    /**
+     * Get all value from the current request context
+     */
+    static getAll(): Record<string, unknown>;
+    /**
+     * Get a value from the current request context
+     */
+    static get<T = unknown>(key: string, defaultValue?: T): T | undefined;
+    /**
+     * Check if a key exists in context
+     */
+    static has(key: string): boolean;
+    /**
+     * Remove a key from context
+     */
+    static delete(key: string): void;
+    /**
+     * Clear the entire context (optional)
+     * Usually not needed — context is auto-cleared after request
+     */
+    static clear(): void;
+}
+//# sourceMappingURL=requestContext.d.ts.map

package/dist/system.applications/requestContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestContext.d.ts","sourceRoot":"","sources":["../../core/system.applications/requestContext.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAyC;IAE/D;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAInC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAUpD;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWxC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAMrE;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKhC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;CAIrB"}

package/dist/system.applications/requestContext.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContext = void 0;
+const async_hooks_1 = require("async_hooks");
+/**
+ * RequestContext
+ *
+ * - Request-scoped storage
+ * - Safe for concurrent users
+ * - Automatically cleared after request lifecycle
+ */
+class RequestContext {
+    static storage = new async_hooks_1.AsyncLocalStorage();
+    /**
+     * Initialize a new request context.
+     * Must be called once per request (middleware).
+     */
+    static run(callback) {
+        return this.storage.run(new Map(), callback);
+    }
+    /**
+     * Set a value in the current request context
+     */
+    static set(key, value) {
+        const store = this.storage.getStore();
+        if (!store) {
+            throw new Error('RequestContext not initialized. Did you forget to call RequestContext.run()?');
+        }
+        store.set(key, value);
+    }
+    /**
+     * Get all value from the current request context
+     */
+    static getAll() {
+        const store = this.storage.getStore();
+        if (!store) {
+            return {};
+        }
+        const result = {};
+        for (const [key, value] of store.entries()) {
+            result[key] = value;
+        }
+        return result;
+    }
+    /**
+     * Get a value from the current request context
+     */
+    static get(key, defaultValue) {
+        const store = this.storage.getStore();
+        if (!store)
+            return defaultValue;
+        return store.get(key) ?? defaultValue;
+    }
+    /**
+     * Check if a key exists in context
+     */
+    static has(key) {
+        const store = this.storage.getStore();
+        return store ? store.has(key) : false;
+    }
+    /**
+     * Remove a key from context
+     */
+    static delete(key) {
+        const store = this.storage.getStore();
+        store?.delete(key);
+    }
+    /**
+     * Clear the entire context (optional)
+     * Usually not needed — context is auto-cleared after request
+     */
+    static clear() {
+        const store = this.storage.getStore();
+        store?.clear();
+    }
+}
+exports.RequestContext = RequestContext;
+//# sourceMappingURL=requestContext.js.map

package/dist/system.applications/requestContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestContext.js","sourceRoot":"","sources":["../../core/system.applications/requestContext.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAOhD;;;;;;GAMG;AACH,MAAa,cAAc;IACjB,MAAM,CAAC,OAAO,GAAG,IAAI,+BAAiB,EAAgB,CAAC;IAE/D;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAI,QAAiB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAc,GAAW,EAAE,KAAQ;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD;;OAEG;IACH,MAAM,CAAC,GAAG,CAAc,GAAW,EAAE,YAAgB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO,YAAY,CAAC;QAChC,OAAQ,KAAK,CAAC,GAAG,CAAC,GAAG,CAAO,IAAI,YAAY,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAW;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,EAAE,KAAK,EAAE,CAAC;IACjB,CAAC;;AAtEH,wCAuEC"}

package/dist/system.applications/response.helpers.d.ts

@@ -0,0 +1,22 @@
+import { JsonResponse, BufferResponse, RenderResponse } from './response.types';
+declare function JSON<T>(payload: T, statusCode?: number): JsonResponse<T>;
+declare function BUFFER(buffer: Buffer, contentType?: string, statusCode?: number): BufferResponse;
+declare function RENDER(view: string, data?: Record<string, any>, statusCode?: number): RenderResponse;
+declare function TPL(location: string, data?: Record<string, any>, statusCode?: number): RenderResponse;
+declare function FILE(filePath: string, fileName: string, mimeType?: string): {
+    kind: "file";
+    filePath: string;
+    fileName: string;
+    mimeType: string;
+    statusCode: number;
+};
+declare class ResponseHelper {
+    JSON: typeof JSON;
+    BUFFER: typeof BUFFER;
+    RENDER: typeof RENDER;
+    TPL: typeof TPL;
+    FILE: typeof FILE;
+}
+declare const Response: ResponseHelper;
+export default Response;
+//# sourceMappingURL=response.helpers.d.ts.map

package/dist/system.applications/response.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.helpers.d.ts","sourceRoot":"","sources":["../../core/system.applications/response.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEhF,iBAAS,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,SAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAO9D;AAED,iBAAS,MAAM,CACb,MAAM,EAAE,MAAM,EACd,WAAW,SAA6B,EACxC,UAAU,SAAM,GACf,cAAc,CAOhB;AAED,iBAAS,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAAE,UAAU,SAAM,GAAG,cAAc,CAO9F;AACD,iBAAS,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAAE,UAAU,SAAM,GAAG,cAAc,CAO/F;AAED,iBAAS,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;;;;;;EAQlE;AAED,cAAM,cAAc;IAClB,IAAI,cAAQ;IACZ,MAAM,gBAAU;IAChB,MAAM,gBAAU;IAChB,GAAG,aAAO;IACV,IAAI,cAAQ;CACb;AAED,QAAA,MAAM,QAAQ,gBAAuB,CAAC;AACtC,eAAe,QAAQ,CAAC"}