@zenofolio/hyper-decor 1.0.76 → 1.0.81

package/dist/__internals/decorator-base.js

@@ -1,122 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractDecorData = exports.hasDecorData = exports.getDecorData = exports.defineDecorData = void 0;
-exports.DecoratorHelper = DecoratorHelper;
-require("reflect-metadata");
-const tsyringe_1 = require("tsyringe");
-const object_util_1 = require("./utils/object.util");
-function DecoratorHelper({ key, type, options, targetResolver, onDefineData }, ...transformers) {
-    return (target, propertyKey, descriptor) => {
-        const isProperty = !!propertyKey;
-        const isMethod = !!descriptor;
-        let _options = options;
-        const Target = targetResolver
-            ? targetResolver(target, propertyKey, descriptor)
-            : target;
-        if (options instanceof Function) {
-            const data = (0, exports.getDecorData)(key, Target);
-            const optionsResolver = options;
-            const value = optionsResolver(data, Target, propertyKey, descriptor);
-            if (value)
-                _options = Object.assign(Object.assign({}, _options), value);
-        }
-        if (onDefineData) {
-            onDefineData({
-                key,
-                options: Object.assign({ type }, _options),
-                target: Target,
-                property: propertyKey,
-                descriptor,
-            }, (data) => {
-                (0, exports.defineDecorData)(key, Object.assign({ type }, data), Target);
-            });
-        }
-        else {
-            (0, exports.defineDecorData)(key, Object.assign({ type }, _options), Target);
-        }
-        let value = Target;
-        if (transformers.length) {
-            const transforms = transformers.map((fn) => fn.bind(Target, _options));
-            if (isProperty) {
-                (0, exports.defineDecorData)(key, Object.assign({ type }, options), Target, propertyKey);
-                value = Reflect.decorate(transforms, Target, propertyKey);
-            }
-            else if (isMethod) {
-                (0, exports.defineDecorData)(key, Object.assign({ type }, options), Target);
-                value = Reflect.decorate(transforms, Target, propertyKey, descriptor);
-            }
-            else {
-                (0, exports.defineDecorData)(key, Object.assign({ type }, options), Target);
-                value = Reflect.decorate(transforms, Target);
-                // If the class was wrapped/replaced, apply metadata to the new class too
-                if (value && value !== Target) {
-                    (0, exports.defineDecorData)(key, Object.assign({ type }, options), value);
-                }
-            }
-        }
-        (0, tsyringe_1.injectable)()((0, object_util_1.$constructor)(target));
-        return value;
-    };
-}
-const METADATA_CACHE = new WeakMap();
-const defineDecorData = (key, options, target, property, descriptor) => {
-    let value = options;
-    if (typeof options === "function" && !(options.prototype && options.prototype.constructor === options)) {
-        const old = (0, exports.getDecorData)(key, target, property);
-        value = Object.assign(Object.assign({}, old), options(old, target, property, descriptor));
-    }
-    if (property) {
-        Reflect.defineMetadata(key, value, target, property);
-    }
-    else {
-        Reflect.defineMetadata(key, value, target);
-    }
-    // Update Cache
-    let targetCache = METADATA_CACHE.get(target);
-    if (!targetCache) {
-        targetCache = new Map();
-        METADATA_CACHE.set(target, targetCache);
-    }
-    targetCache.set(property ? `${key}:${property}` : key, value);
-};
-exports.defineDecorData = defineDecorData;
-const getDecorData = (key, target, property) => {
-    const cacheKey = property ? `${key}:${property}` : key;
-    const targetCache = METADATA_CACHE.get(target);
-    if (targetCache && targetCache.has(cacheKey)) {
-        return targetCache.get(cacheKey);
-    }
-    const value = property
-        ? Reflect.getMetadata(key, target, property)
-        : Reflect.getMetadata(key, target);
-    if (value !== undefined) {
-        let tc = METADATA_CACHE.get(target);
-        if (!tc) {
-            tc = new Map();
-            METADATA_CACHE.set(target, tc);
-        }
-        tc.set(cacheKey, value);
-    }
-    return value;
-};
-exports.getDecorData = getDecorData;
-const hasDecorData = (key, target, property) => {
-    const cacheKey = property ? `${key}:${property}` : key;
-    const targetCache = METADATA_CACHE.get(target);
-    if (targetCache && targetCache.has(cacheKey))
-        return true;
-    return property
-        ? Reflect.hasMetadata(key, target, property)
-        : Reflect.hasMetadata(key, target);
-};
-exports.hasDecorData = hasDecorData;
-const extractDecorData = (target) => {
-    const keys = Reflect.getMetadataKeys(target);
-    const result = {};
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        result[key] = (0, exports.getDecorData)(key, target);
-    }
-    return result;
-};
-exports.extractDecorData = extractDecorData;

package/dist/__internals/helpers/imports.helper.d.ts

@@ -1,8 +0,0 @@
-import { IHyperHooks, ImportType } from "../../decorators/types";
-/**
- * Prepare imports for the target class.
- *
- * @param target
- * @param imports
- */
-export declare function prepareImports(_target: any, imports: ImportType[], hooks?: IHyperHooks, context?: any): Promise<void>;

package/dist/__internals/helpers/imports.helper.js

@@ -1,92 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.prepareImports = prepareImports;
-const tsyringe_1 = require("tsyringe");
-const lifecycle_helper_1 = require("./lifecycle.helper");
-const decorator_base_1 = require("../decorator-base");
-const constants_1 = require("../constants");
-const message_bus_1 = require("../../common/message-bus");
-/**
- * Prepare imports for the target class.
- *
- * @param target
- * @param imports
- */
-function prepareImports(_target, imports, hooks, context) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const bus = tsyringe_1.container.resolve(message_bus_1.MessageBus);
-        yield Promise.all(imports.map((item) => __awaiter(this, void 0, void 0, function* () {
-            let token;
-            if (typeof item === "function" || typeof item === "string" || typeof item === "symbol") {
-                token = item;
-            }
-            else if (item && typeof item === "object" && "token" in item) {
-                token = item.token;
-                if (item.useClass) {
-                    tsyringe_1.container.register(token, { useClass: item.useClass }, item.options);
-                }
-                else if ("useValue" in item) {
-                    tsyringe_1.container.registerInstance(token, item.useValue);
-                    return;
-                }
-                else if (item.useFactory) {
-                    tsyringe_1.container.register(token, { useFactory: item.useFactory }, item.options);
-                    return;
-                }
-                else if (item.useToken) {
-                    tsyringe_1.container.register(token, { useToken: item.useToken }, item.options);
-                    return;
-                }
-            }
-            if (!token)
-                return;
-            try {
-                const instance = tsyringe_1.container.resolve(token);
-                if (!instance)
-                    return;
-                // Skip if already initialized to avoid double work/double subscription
-                const alreadyDone = (0, lifecycle_helper_1.isInitialized)(instance);
-                if (!alreadyDone) {
-                    if (hooks === null || hooks === void 0 ? void 0 : hooks.onBeforeInit) {
-                        yield hooks.onBeforeInit(instance, token, context);
-                    }
-                }
-                yield (0, lifecycle_helper_1.initializeInstance)(instance);
-                if (!alreadyDone) {
-                    if (hooks === null || hooks === void 0 ? void 0 : hooks.onAfterInit) {
-                        yield hooks.onAfterInit(instance, token, context);
-                    }
-                    // Handle singleton registration if it's a constructor and not registered
-                    if (typeof token === "function" && !tsyringe_1.container.isRegistered(token)) {
-                        const isSingleton = typeof instance.isSingleton === "function" ? instance.isSingleton() : true;
-                        if (isSingleton) {
-                            tsyringe_1.container.registerInstance(token, instance);
-                        }
-                    }
-                    // Discovery: Messaging (only on first init)
-                    const messaging = (0, decorator_base_1.getDecorData)(constants_1.METADATA_KEYS.ON_MESSAGE, typeof token === "function" ? token : instance.constructor);
-                    if (messaging === null || messaging === void 0 ? void 0 : messaging.length) {
-                        messaging.forEach((msg) => {
-                            bus.listen(msg.topic, instance[msg.propertyKey].bind(instance));
-                        });
-                    }
-                }
-            }
-            catch (e) {
-                // Skip dependencies that cannot be resolved automatically
-                // Log a warning to prevent silent failures in production
-                const name = typeof token === "function" ? token.name : String(token);
-                console.warn(`[HyperDecor] Warn: Could not resolve dependency for token "${name}". It might be missing injectable() or not exported correctly.`);
-            }
-        })));
-    });
-}

package/dist/__internals/helpers/tree.helper.d.ts

@@ -1,36 +0,0 @@
-import { HyperAppMetadata, HyperModuleMetadata, HyperControllerMetadata, RouteMetadata } from "../../decorators/types";
-export interface AppTree {
-    app: HyperAppMetadata & {
-        target: any;
-        fullPath: string;
-    };
-    modules: Record<string, ModuleNode>;
-    paths: Record<string, RouteNode[]>;
-    openapi?: any;
-}
-export interface ModuleNode {
-    metadata: HyperModuleMetadata;
-    target: any;
-    fullPath: string;
-    modules: Record<string, ModuleNode>;
-    controllers: Record<string, ControllerNode>;
-    services: any[];
-    openapi?: any;
-}
-export interface ControllerNode {
-    metadata: HyperControllerMetadata;
-    target: any;
-    fullPath: string;
-    routes: RouteNode[];
-    services: any[];
-    openapi?: any;
-}
-export interface RouteNode extends RouteMetadata {
-    fullPath: string;
-    params: any[];
-    openapi?: any;
-}
-/**
- * Extracts the complete application metadata tree.
- */
-export declare function getAppTree(Target: any): AppTree;

package/dist/__internals/helpers/tree.helper.js

@@ -1,81 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAppTree = getAppTree;
-const decorator_base_1 = require("../decorator-base");
-const constants_1 = require("../constants");
-const path_util_1 = require("../utils/path.util");
-const class_collector_1 = require("../../lib/openapi/collectors/class.collector");
-const metadata_registry_1 = require("../../lib/openapi/metadata.registry");
-/**
- * Extracts the complete application metadata tree.
- */
-function getAppTree(Target) {
-    const appMetadata = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_APP, Target);
-    const prefix = (appMetadata === null || appMetadata === void 0 ? void 0 : appMetadata.prefix) || "/";
-    const tree = {
-        app: Object.assign(Object.assign({}, appMetadata), { target: Target, fullPath: prefix }),
-        modules: {},
-        paths: {}
-    };
-    ((appMetadata === null || appMetadata === void 0 ? void 0 : appMetadata.modules) || []).forEach(m => {
-        const node = getModuleNode(m, prefix, tree.paths);
-        tree.modules[m.name] = node;
-    });
-    // Apply tree processors
-    metadata_registry_1.openApiRegistry.getProcessors().forEach(processor => processor(tree));
-    return tree;
-}
-function getModuleNode(Target, parentPath = "", globalPaths = {}) {
-    const metadata = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_MODULE, Target);
-    const currentPath = (0, path_util_1.join)(parentPath, (metadata === null || metadata === void 0 ? void 0 : metadata.path) || "");
-    const openapi = (0, class_collector_1.collectClassMetadata)(Target);
-    const node = {
-        metadata,
-        target: Target,
-        fullPath: currentPath,
-        modules: {},
-        controllers: {},
-        services: ((metadata === null || metadata === void 0 ? void 0 : metadata.imports) || []),
-        openapi
-    };
-    ((metadata === null || metadata === void 0 ? void 0 : metadata.modules) || []).forEach(m => {
-        node.modules[m.name] = getModuleNode(m, currentPath, globalPaths);
-    });
-    ((metadata === null || metadata === void 0 ? void 0 : metadata.controllers) || []).forEach(c => {
-        node.controllers[c.name] = getControllerNode(c, currentPath, globalPaths);
-    });
-    return node;
-}
-function getControllerNode(Target, parentPath = "", globalPaths = {}) {
-    var _a;
-    const metadata = (0, decorator_base_1.getDecorData)(constants_1.KEY_TYPE_CONTROLLER, Target);
-    const routeList = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_ROUTE, Target);
-    // Param metadata can be on the constructor or the prototype
-    const paramMetadata = (_a = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_PARAM, Target)) !== null && _a !== void 0 ? _a : (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_PARAM, Target.prototype);
-    const currentPath = (0, path_util_1.join)(parentPath, (metadata === null || metadata === void 0 ? void 0 : metadata.path) || "");
-    const openapi = (0, class_collector_1.collectClassMetadata)(Target);
-    const routes = Array.from((routeList === null || routeList === void 0 ? void 0 : routeList.routes) || []).map((route) => {
-        var _a, _b, _c, _d, _e, _f;
-        // Also try to get params from the handler itself if not in aggregated metadata
-        const params = (_e = (_b = (_a = paramMetadata === null || paramMetadata === void 0 ? void 0 : paramMetadata.params) === null || _a === void 0 ? void 0 : _a[route.propertyKey]) !== null && _b !== void 0 ? _b : (_d = (_c = (0, decorator_base_1.getDecorData)(constants_1.KEY_PARAMS_PARAM, route.handler)) === null || _c === void 0 ? void 0 : _c.params) === null || _d === void 0 ? void 0 : _d[route.propertyKey]) !== null && _e !== void 0 ? _e : [];
-        const fullPath = (0, path_util_1.join)(currentPath, route.path);
-        // Get OpenAPI metadata for the method
-        const methodOpenApi = ((_f = openapi.methods) === null || _f === void 0 ? void 0 : _f[route.propertyKey]) || {};
-        const routeNode = Object.assign(Object.assign({}, route), { fullPath,
-            params, openapi: methodOpenApi });
-        // Add to global paths map
-        if (!globalPaths[fullPath]) {
-            globalPaths[fullPath] = [];
-        }
-        globalPaths[fullPath].push(routeNode);
-        return routeNode;
-    });
-    return {
-        metadata,
-        target: Target,
-        fullPath: currentPath,
-        routes,
-        services: (metadata === null || metadata === void 0 ? void 0 : metadata.imports) || [],
-        openapi
-    };
-}

package/dist/__internals/stores/metadata.store.d.ts

@@ -1,15 +0,0 @@
-interface MetadataStoreOptions {
-    target: any;
-    propertyKey?: string | symbol;
-    descriptorOrIndex?: any;
-}
-declare class MetadatStore {
-    static define(key: string | symbol, value: any, { target, propertyKey }: MetadataStoreOptions): void;
-    static get<T>(key: string | symbol, { target, propertyKey }: MetadataStoreOptions, def: T): T;
-    static list<T extends any = any>(key: string | symbol, { target, propertyKey }: MetadataStoreOptions): {
-        has: () => boolean;
-        get: () => never[];
-        set: (...value: T[]) => void;
-    };
-}
-export default MetadatStore;

package/dist/__internals/stores/metadata.store.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const object_util_1 = require("../utils/object.util");
-class MetadatStore {
-    static define(key, value, { target, propertyKey }) {
-        if (target && typeof propertyKey === "string") {
-            Reflect.defineMetadata(key, value, Reflect.get(target, propertyKey));
-        }
-        else {
-            Reflect.defineMetadata(key, value, (0, object_util_1.$constructor)(target));
-        }
-    }
-    static get(key, { target, propertyKey }, def) {
-        if (target && typeof propertyKey === "string") {
-            return Reflect.getMetadata(key, Reflect.get(target, propertyKey)) || def;
-        }
-        else {
-            return Reflect.getMetadata(key, (0, object_util_1.$constructor)(target)) || def;
-        }
-    }
-    static list(key, { target, propertyKey }) {
-        return {
-            has: () => {
-                return this.get(key, { target, propertyKey }, []).length > 0;
-            },
-            get: () => {
-                return this.get(key, { target, propertyKey }, []);
-            },
-            set: (...value) => {
-                const list = this.get(key, { target, propertyKey }, []);
-                list.push(...value);
-                this.define(key, list, { target, propertyKey });
-            },
-        };
-    }
-}
-exports.default = MetadatStore;

package/dist/__internals/stores/service.store.d.ts

@@ -1 +0,0 @@
-export declare const serviceStore: Set<any>;

package/dist/__internals/stores/service.store.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serviceStore = void 0;
-exports.serviceStore = new Set();

package/dist/decorators/File.d.ts

@@ -1,37 +0,0 @@
-import { Request } from "hyper-express/types";
-/**
- * File upload restrictions
- */
-export interface FileUploadRestrictions {
-    allowedMimeTypes: string[];
-    maxFileSize: number;
-}
-/**
- * File restrictions resolver
- */
-export type FileRestrictions = FileUploadRestrictions | ((request: Request) => FileUploadRestrictions | Promise<FileUploadRestrictions>);
-/**
- * File decorator options
- */
-export interface FileOptions {
-    fieldName: string | string[];
-    restrictions?: FileRestrictions;
-    required?: boolean;
-}
-export interface UploadedFile {
-    field: string;
-    name: string;
-    filename: string;
-    mimeType: string;
-    size: number;
-    extension: string;
-    buffer: Buffer;
-}
-/**
- * Decorator to extract file from the request
- */
-export declare const File: {
-    (options: FileOptions | string): ParameterDecorator;
-    options(options: FileOptions, required?: boolean): (fieldName: string | string[]) => ParameterDecorator;
-    restrictions(restrictions: FileRestrictions): (fieldName: string | string[], required?: boolean) => ParameterDecorator;
-};

package/dist/decorators/File.js

@@ -1,167 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __asyncValues = (this && this.__asyncValues) || function (o) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var m = o[Symbol.asyncIterator], i;
-    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
-    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
-    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.File = void 0;
-const Http_1 = require("./Http");
-const HyperFileException_1 = __importDefault(require("../exeptions/HyperFileException"));
-/**
- * Decorator to extract file from the request
- */
-const File = (options) => {
-    const _options = typeof options === "string" ? { fieldName: options } : options;
-    return (0, Http_1.createCustomRequestDecorator)("File", (request) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a;
-        const { allowedMimeTypes, maxFileSize } = yield resolveRestrictions(request, _options.restrictions);
-        const passTypes = allowedMimeTypes.includes("*") || allowedMimeTypes.length === 0;
-        const passSize = maxFileSize === Infinity;
-        const contentType = (_a = request.headers) === null || _a === void 0 ? void 0 : _a["content-type"];
-        const isMultipart = contentType === null || contentType === void 0 ? void 0 : contentType.includes("multipart/form-data");
-        if (!isMultipart) {
-            throw new HyperFileException_1.default("Invalid request, expected multipart form data", {
-                fieldName: _options.fieldName,
-            });
-        }
-        const files = yield extractFiles(request, {
-            maxSize: passSize ? undefined : maxFileSize,
-            mimeTypes: passTypes ? undefined : allowedMimeTypes,
-            requires: _options.required
-                ? Array.isArray(_options.fieldName)
-                    ? _options.fieldName
-                    : [_options.fieldName]
-                : undefined,
-            requireName: true,
-        });
-        return Array.isArray(_options.fieldName)
-            ? files
-            : files[_options.fieldName];
-    }));
-};
-exports.File = File;
-exports.File.options = (options, required = false) => {
-    return (fieldName) => {
-        return (0, exports.File)(Object.assign(Object.assign({}, options), { required, fieldName }));
-    };
-};
-exports.File.restrictions = (restrictions) => {
-    return (fieldName, required = false) => {
-        return (0, exports.File)({ fieldName, restrictions, required });
-    };
-};
-const resolveRestrictions = (request, restrictions) => __awaiter(void 0, void 0, void 0, function* () {
-    if (typeof restrictions === "function") {
-        return yield restrictions(request);
-    }
-    return (restrictions !== null && restrictions !== void 0 ? restrictions : {
-        allowedMimeTypes: ["*"],
-        maxFileSize: Infinity,
-    });
-});
-/**
- * Extract files from a request with validation and secure streaming.
- */
-const extractFiles = (request, options) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a;
-    const filesMap = {};
-    // Track if we are already over total limit (Content-Length check as first line of defense)
-    const totalLength = Number((_a = request.headers) === null || _a === void 0 ? void 0 : _a["content-length"]);
-    if ((options === null || options === void 0 ? void 0 : options.maxSize) && !isNaN(totalLength) && totalLength > options.maxSize + 1024 * 10) { // Buffer for boundaries
-        // Content-Length is significantly larger than allowed file size
-        // We don't throw yet because multipart might have multiple files or large fields
-    }
-    yield request.multipart((field) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, e_1, _b, _c;
-        var _d, _e;
-        if (field.file && field.file.stream) {
-            const chunks = [];
-            let totalRead = 0;
-            try {
-                // Safe stream reading with early exit
-                for (var _f = true, _g = __asyncValues(field.file.stream), _h; _h = yield _g.next(), _a = _h.done, !_a; _f = true) {
-                    _c = _h.value;
-                    _f = false;
-                    const chunk = _c;
-                    totalRead += chunk.length;
-                    if ((options === null || options === void 0 ? void 0 : options.maxSize) && totalRead > options.maxSize) {
-                        throw new HyperFileException_1.default(`File '${field.name}' exceeds the maximum limit of ${options.maxSize} bytes`, { field: field.name, maxSize: options.maxSize });
-                    }
-                    chunks.push(chunk);
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (!_f && !_a && (_b = _g.return)) yield _b.call(_g);
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-            const bufferFile = Buffer.concat(chunks);
-            const { fileTypeFromBuffer } = yield import("file-type");
-            const type = yield fileTypeFromBuffer(bufferFile);
-            const mimeType = (type === null || type === void 0 ? void 0 : type.mime) || "unknown/unrecognized";
-            const extension = (type === null || type === void 0 ? void 0 : type.ext) || "bin";
-            // Validate MIME type early if unrecognized
-            if (!type && (options === null || options === void 0 ? void 0 : options.mimeTypes) && options.mimeTypes.length > 0) {
-                throw new HyperFileException_1.default(`Invalid file type for field '${field.name}'. Could not recognize file signature. Expected one of: ${options.mimeTypes.join(", ")}`, { field: field.name, allowedMimeTypes: options.mimeTypes });
-            }
-            // Validate MIME type if recognized
-            if ((options === null || options === void 0 ? void 0 : options.mimeTypes) && !options.mimeTypes.includes(mimeType)) {
-                throw new HyperFileException_1.default(`Invalid file type for field '${field.name}'. Expected: ${options.mimeTypes.join(", ")}, Received: ${mimeType}`, {
-                    field: field.name,
-                    allowedMimeTypes: options.mimeTypes,
-                    receivedMimeType: mimeType,
-                });
-            }
-            if ((options === null || options === void 0 ? void 0 : options.requireName) && !((_d = field.file) === null || _d === void 0 ? void 0 : _d.name)) {
-                throw new HyperFileException_1.default(`File name is required for field '${field.name}'`, {
-                    field: field.name,
-                });
-            }
-            // Secure filename resolution
-            const rawName = ((_e = field.file) === null || _e === void 0 ? void 0 : _e.name) || field.name;
-            // Sanitize: remove null bytes, path traversal sequences, and extract base name
-            const sanitizedBase = rawName.replace(/\0/g, "").split(/[\\/]/).pop() || "file";
-            const nameOnly = sanitizedBase.includes(".")
-                ? sanitizedBase.substring(0, sanitizedBase.lastIndexOf("."))
-                : sanitizedBase;
-            const filename = `${nameOnly}.${extension}`;
-            filesMap[field.name] = {
-                field: field.name,
-                name: nameOnly,
-                filename: filename,
-                extension: extension,
-                size: bufferFile.byteLength,
-                mimeType: mimeType,
-                buffer: bufferFile,
-            };
-        }
-    }));
-    // Check for required files
-    if (options === null || options === void 0 ? void 0 : options.requires) {
-        for (const required of options.requires) {
-            if (!filesMap[required]) {
-                throw new HyperFileException_1.default(`File "${required}" is required`, {
-                    required,
-                });
-            }
-        }
-    }
-    return filesMap;
-});

package/dist/decorators/Http.d.ts

@@ -1,22 +0,0 @@
-import { ParameterResolver } from "./types";
-/**
- * Get the value of a key from the request object
- *
- * @param key
- * @returns
- */
-/**
- * Get the value of a key from the request object or transform the entire query.
- *
- * @example
- * \@Query('id')
- * \@Query('id', IntSchema)
- * \@Query(UserQueryDto)
- */
-export declare function Query(keyOrSchema?: string | any, schemaOrTransform?: any): any;
-export declare function Body(keyOrSchema?: string | any, schemaOrTransform?: any): any;
-export declare function Param(keyOrSchema: string | any, schemaOrTransform?: any): any;
-export declare function Headers(keyOrSchema?: string | any, schemaOrTransform?: any): any;
-export declare const Req: () => ParameterDecorator;
-export declare const Res: () => ParameterDecorator;
-export declare const createCustomRequestDecorator: (decoratorName: string, resolver: ParameterResolver) => ParameterDecorator;